From 2830eafe89d2670c2e14739ba00a4759d789e07c Mon Sep 17 00:00:00 2001
From: WFH Brian <brian@plexm.com>
Date: Tue, 16 Apr 2024 15:27:42 -0400
Subject: [PATCH] docs: Update JSDocs in multiple files

---
 docs/AnthropicAdapter.html                    |    2 +-
 docs/CohereAdapter.html                       |    2 +-
 docs/Collection.html                          |    2 +-
 docs/CollectionItem.html                      | 1453 ++++++++++++++++-
 docs/GeminiAdapter.html                       |    2 +-
 docs/SmartChat.html                           |    2 +-
 docs/SmartChatModel.html                      |    2 +-
 docs/SmartMarkdown.html                       |    2 +-
 docs/SmartSocket.html                         |    2 +-
 docs/global.html                              |    2 +-
 docs/index.html                               |    2 +-
 ...mart-chat-model_adapters_anthropic.js.html |    2 +-
 docs/smart-chat-model_adapters_cohere.js.html |    2 +-
 ...rt-chat-model_adapters_cohere.test.js.html |    2 +-
 docs/smart-chat-model_adapters_gemini.js.html |    2 +-
 ...at-model_dist_smart_chat_model_web.js.html |    2 +-
 .../smart-chat-model_smart_chat_model.js.html |    2 +-
 docs/smart-chat-model_streamer.js.html        |    2 +-
 ...hat-model_utils_is_valid_tool_call.js.html |    2 +-
 docs/smart-chats_smart_chat.js.html           |    2 +-
 docs/smart-chats_smart_chat_md.js.html        |    2 +-
 docs/smart-chunks_SmartMarkdown.js.html       |    2 +-
 docs/smart-collections_Collection.js.html     |    2 +-
 docs/smart-collections_CollectionItem.js.html |  100 +-
 docs/smart-embed_SmartEmbed.js.html           |    2 +-
 docs/smart-embed_smart_socket.js.html         |    2 +-
 26 files changed, 1543 insertions(+), 58 deletions(-)

diff --git a/docs/AnthropicAdapter.html b/docs/AnthropicAdapter.html
index 6268bf59..ff0e3c0f 100644
--- a/docs/AnthropicAdapter.html
+++ b/docs/AnthropicAdapter.html
@@ -1453,7 +1453,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/CohereAdapter.html b/docs/CohereAdapter.html
index fc9d2425..9f1919ca 100644
--- a/docs/CohereAdapter.html
+++ b/docs/CohereAdapter.html
@@ -803,7 +803,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/Collection.html b/docs/Collection.html
index 80f937b3..d989fd82 100644
--- a/docs/Collection.html
+++ b/docs/Collection.html
@@ -3098,7 +3098,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/CollectionItem.html b/docs/CollectionItem.html
index 5a74d009..9964896f 100644
--- a/docs/CollectionItem.html
+++ b/docs/CollectionItem.html
@@ -28,9 +28,9 @@ <h1 class="page-title">Class: CollectionItem</h1>
 
 <header>
     
-        <h2><span class="attribs"><span class="type-signature"></span></span>CollectionItem<span class="signature">()</span><span class="type-signature"></span></h2>
+        <h2><span class="attribs"><span class="type-signature"></span></span>CollectionItem<span class="signature">(brain, data)</span><span class="type-signature"></span></h2>
         
-            <div class="class-description"><p>Represents an item within a collection.</p></div>
+            <div class="class-description"><p>Represents an item within a collection, providing methods for data manipulation, validation, and interaction with its collection.</p></div>
         
     
 </header>
@@ -45,13 +45,1184 @@ <h2>Constructor</h2>
     
 
     
-    <h4 class="name" id="CollectionItem"><span class="type-signature"></span>new CollectionItem<span class="signature">()</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="CollectionItem"><span class="type-signature"></span>new CollectionItem<span class="signature">(brain, data)</span><span class="type-signature"></span></h4>
     
 
     
 
 
 
+<div class="description">
+    <p>Creates an instance of CollectionItem.</p>
+</div>
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>brain</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+            
+            </td>
+
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>The central storage or context.</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>data</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+|
+
+<span class="param-type">null</span>
+
+
+            
+            </td>
+
+            
+
+            
+                <td class="default">
+                
+                    null
+                
+                </td>
+            
+
+            <td class="description last"><p>Initial data for the item.</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line11">line 11</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+    
+    </div>
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+        <h3 class="subsection-title">Members</h3>
+
+        
+            
+<h4 class="name" id="collection"><span class="type-signature"></span>collection<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Retrieves the collection this item belongs to.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line162">line 162</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+            
+<h4 class="name" id="collection_name"><span class="type-signature"></span>collection_name<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Retrieves the collection name for the instance, either from data or the class method.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line156">line 156</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+            
+<h4 class="name" id="key"><span class="type-signature"></span>key<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Retrieves or generates the key for this item.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line168">line 168</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+            
+<h4 class="name" id="ref"><span class="type-signature"></span>ref<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Provides a reference object for this item, containing the collection name and key.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line174">line 174</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+            
+<h4 class="name" id="seq_key"><span class="type-signature"></span>seq_key<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Retrieves the sequence key for this item, used for building sequence keys.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line180">line 180</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+            
+<h4 class="name" id=".collection_name"><span class="type-signature">(static) </span>collection_name<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Retrieves the collection name derived from the class name.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line150">line 150</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+            
+<h4 class="name" id=".defaults"><span class="type-signature">(static) </span>defaults<span class="type-signature"></span></h4>
+
+
+
+
+<div class="description">
+    <p>Default properties for an instance of CollectionItem.</p>
+</div>
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line16">line 16</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
+    
+
+    
+        <h3 class="subsection-title">Methods</h3>
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="delete"><span class="type-signature"></span>delete<span class="signature">()</span><span class="type-signature"></span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Deletes the item from its collection.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line115">line 115</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="filter"><span class="type-signature"></span>filter<span class="signature">(opts)</span><span class="type-signature"> &rarr; {boolean}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Filters items in the collection based on provided options.</p>
+</div>
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>opts</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>Filtering options.</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line123">line 123</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>True if the item passes the filter.</p>
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">boolean</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="get_key"><span class="type-signature"></span>get_key<span class="signature">()</span><span class="type-signature"> &rarr; {string}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Generates or retrieves a unique key for the item. Can be overridden in child classes.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line55">line 55</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>The unique key.</p>
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">string</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="init"><span class="type-signature"></span>init<span class="signature">()</span><span class="type-signature"></span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Initializes the item with input_data, potentially asynchronously.
+Handles interactions with other collection items.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line87">line 87</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="merge_defaults"><span class="type-signature"></span>merge_defaults<span class="signature">()</span><span class="type-signature"></span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Merges default properties from all classes in the inheritance chain.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line40">line 40</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="parse"><span class="type-signature"></span>parse<span class="signature">()</span><span class="type-signature"></span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Parses the item's data for any necessary processing or transformation. Placeholder for override in child classes.</p>
+</div>
+
 
 
 
@@ -93,7 +1264,7 @@ <h4 class="name" id="CollectionItem"><span class="type-signature"></span>new Col
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line10">line 10</a>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line144">line 144</a>
     </li></ul></dd>
     
 
@@ -122,9 +1293,37 @@ <h4 class="name" id="CollectionItem"><span class="type-signature"></span>new Col
 
 
 
+
+        
+            
+
+    
 
     
-    </div>
+    <h4 class="name" id="save"><span class="type-signature"></span>save<span class="signature">()</span><span class="type-signature"></span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Saves the current state of the item to its collection.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
 
     
 
@@ -141,7 +1340,47 @@ <h4 class="name" id="CollectionItem"><span class="type-signature"></span>new Col
     
 
     
-        <h3 class="subsection-title">Methods</h3>
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line92">line 92</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
         
             
@@ -149,7 +1388,7 @@ <h3 class="subsection-title">Methods</h3>
     
 
     
-    <h4 class="name" id="init"><span class="type-signature"></span>init<span class="signature">(input_data)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="update_data"><span class="type-signature"></span>update_data<span class="signature">(data)</span><span class="type-signature"> &rarr; {boolean}</span></h4>
     
 
     
@@ -157,8 +1396,7 @@ <h4 class="name" id="init"><span class="type-signature"></span>init<span class="
 
 
 <div class="description">
-    <p>Initializes the item with input_data, potentially asynchronously.
-Handles interactions with other collection items.</p>
+    <p>Updates the data of this item with new data.</p>
 </div>
 
 
@@ -194,7 +1432,7 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>input_data</code></td>
+                <td class="name"><code>data</code></td>
             
 
             <td class="type">
@@ -210,7 +1448,7 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>The initial data for the item.</p></td>
+            <td class="description last"><p>The new data for the item.</p></td>
         </tr>
 
     
@@ -251,7 +1489,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line62">line 62</a>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line65">line 65</a>
     </li></ul></dd>
     
 
@@ -276,6 +1514,28 @@ <h5>Parameters:</h5>
 
 
 
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>True if data was successfully updated.</p>
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">boolean</span>
+
+
+    </dd>
+</dl>
+
+    
 
 
 
@@ -287,7 +1547,7 @@ <h5>Parameters:</h5>
     
 
     
-    <h4 class="name" id="update_data"><span class="type-signature"></span>update_data<span class="signature">(input_data)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="update_data_replacer"><span class="type-signature"></span>update_data_replacer<span class="signature">(key, value)</span><span class="type-signature"> &rarr; {any}</span></h4>
     
 
     
@@ -295,7 +1555,7 @@ <h4 class="name" id="update_data"><span class="type-signature"></span>update_dat
 
 
 <div class="description">
-    <p>Updates the data of this item.</p>
+    <p>Custom replacer function for JSON.stringify used in update_data to handle special object types.</p>
 </div>
 
 
@@ -331,13 +1591,13 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>input_data</code></td>
+                <td class="name"><code>key</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">string</span>
 
 
             
@@ -347,7 +1607,30 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>The new data for the item.</p></td>
+            <td class="description last"><p>The key of the property being stringified.</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>value</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">any</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>The value of the property being stringified.</p></td>
         </tr>
 
     
@@ -388,7 +1671,117 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line46">line 46</a>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line77">line 77</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>The value to be used in the JSON string.</p>
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">any</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="validate_save"><span class="type-signature"></span>validate_save<span class="signature">()</span><span class="type-signature"> &rarr; {boolean}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Validates the item's data before saving.</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="smart-collections_CollectionItem.js.html">smart-collections/CollectionItem.js</a>, <a href="smart-collections_CollectionItem.js.html#line105">line 105</a>
     </li></ul></dd>
     
 
@@ -413,6 +1806,28 @@ <h5>Parameters:</h5>
 
 
 
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>True if the data is valid for saving.</p>
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">boolean</span>
+
+
+    </dd>
+</dl>
+
+    
 
 
 
@@ -440,7 +1855,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/GeminiAdapter.html b/docs/GeminiAdapter.html
index 825596e7..8fe6bd0b 100644
--- a/docs/GeminiAdapter.html
+++ b/docs/GeminiAdapter.html
@@ -1796,7 +1796,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/SmartChat.html b/docs/SmartChat.html
index 6245023f..5c694695 100644
--- a/docs/SmartChat.html
+++ b/docs/SmartChat.html
@@ -259,7 +259,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/SmartChatModel.html b/docs/SmartChatModel.html
index 5d05dd38..7cdd72f0 100644
--- a/docs/SmartChatModel.html
+++ b/docs/SmartChatModel.html
@@ -1422,7 +1422,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/SmartMarkdown.html b/docs/SmartMarkdown.html
index a2a8fc9d..6cd56267 100644
--- a/docs/SmartMarkdown.html
+++ b/docs/SmartMarkdown.html
@@ -2144,7 +2144,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/SmartSocket.html b/docs/SmartSocket.html
index 04e005db..a1c78331 100644
--- a/docs/SmartSocket.html
+++ b/docs/SmartSocket.html
@@ -1585,7 +1585,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/global.html b/docs/global.html
index 88459a4a..f2fd6f42 100644
--- a/docs/global.html
+++ b/docs/global.html
@@ -1502,7 +1502,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/index.html b/docs/index.html
index a02d45b6..fd529734 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -56,7 +56,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_adapters_anthropic.js.html b/docs/smart-chat-model_adapters_anthropic.js.html
index f549f111..350b0d16 100644
--- a/docs/smart-chat-model_adapters_anthropic.js.html
+++ b/docs/smart-chat-model_adapters_anthropic.js.html
@@ -153,7 +153,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_adapters_cohere.js.html b/docs/smart-chat-model_adapters_cohere.js.html
index 2c4335d8..655b8288 100644
--- a/docs/smart-chat-model_adapters_cohere.js.html
+++ b/docs/smart-chat-model_adapters_cohere.js.html
@@ -131,7 +131,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_adapters_cohere.test.js.html b/docs/smart-chat-model_adapters_cohere.test.js.html
index c098444c..68d3d654 100644
--- a/docs/smart-chat-model_adapters_cohere.test.js.html
+++ b/docs/smart-chat-model_adapters_cohere.test.js.html
@@ -151,7 +151,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_adapters_gemini.js.html b/docs/smart-chat-model_adapters_gemini.js.html
index 826944da..9ccdf891 100644
--- a/docs/smart-chat-model_adapters_gemini.js.html
+++ b/docs/smart-chat-model_adapters_gemini.js.html
@@ -224,7 +224,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_dist_smart_chat_model_web.js.html b/docs/smart-chat-model_dist_smart_chat_model_web.js.html
index b803ab9c..e990be98 100644
--- a/docs/smart-chat-model_dist_smart_chat_model_web.js.html
+++ b/docs/smart-chat-model_dist_smart_chat_model_web.js.html
@@ -991,7 +991,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_smart_chat_model.js.html b/docs/smart-chat-model_smart_chat_model.js.html
index efe11233..dcc51c7b 100644
--- a/docs/smart-chat-model_smart_chat_model.js.html
+++ b/docs/smart-chat-model_smart_chat_model.js.html
@@ -387,7 +387,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_streamer.js.html b/docs/smart-chat-model_streamer.js.html
index addfe5a6..5b278aaa 100644
--- a/docs/smart-chat-model_streamer.js.html
+++ b/docs/smart-chat-model_streamer.js.html
@@ -223,7 +223,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chat-model_utils_is_valid_tool_call.js.html b/docs/smart-chat-model_utils_is_valid_tool_call.js.html
index 62c474e4..484cc52c 100644
--- a/docs/smart-chat-model_utils_is_valid_tool_call.js.html
+++ b/docs/smart-chat-model_utils_is_valid_tool_call.js.html
@@ -118,7 +118,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chats_smart_chat.js.html b/docs/smart-chats_smart_chat.js.html
index 501d133e..092e438f 100644
--- a/docs/smart-chats_smart_chat.js.html
+++ b/docs/smart-chats_smart_chat.js.html
@@ -132,7 +132,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chats_smart_chat_md.js.html b/docs/smart-chats_smart_chat_md.js.html
index 4a423852..b7d98d9a 100644
--- a/docs/smart-chats_smart_chat_md.js.html
+++ b/docs/smart-chats_smart_chat_md.js.html
@@ -202,7 +202,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-chunks_SmartMarkdown.js.html b/docs/smart-chunks_SmartMarkdown.js.html
index 831c9586..07251706 100644
--- a/docs/smart-chunks_SmartMarkdown.js.html
+++ b/docs/smart-chunks_SmartMarkdown.js.html
@@ -316,7 +316,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-collections_Collection.js.html b/docs/smart-collections_Collection.js.html
index 3b13805e..b2ee0aec 100644
--- a/docs/smart-collections_Collection.js.html
+++ b/docs/smart-collections_Collection.js.html
@@ -296,7 +296,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-collections_CollectionItem.js.html b/docs/smart-collections_CollectionItem.js.html
index b7730d54..eae6295f 100644
--- a/docs/smart-collections_CollectionItem.js.html
+++ b/docs/smart-collections_CollectionItem.js.html
@@ -32,10 +32,15 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
   deep_merge,
   collection_instance_name_from,
 } = helpers;
+
 /**
- * Represents an item within a collection.
+ * Represents an item within a collection, providing methods for data manipulation, validation, and interaction with its collection.
  */
 class CollectionItem {
+  /**
+   * Default properties for an instance of CollectionItem.
+   * @returns {Object} Default data configuration.
+   */
   static get defaults() {
     return {
       data: {
@@ -43,6 +48,12 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
       },
     };
   }
+
+  /**
+   * Creates an instance of CollectionItem.
+   * @param {Object} brain - The central storage or context.
+   * @param {Object|null} data - Initial data for the item.
+   */
   constructor(brain, data = null) {
     this.brain = brain;
     this.config = this.brain?.config;
@@ -50,7 +61,10 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
     if (data) this.data = data;
     this.data.class_name = this.constructor.name;
   }
-  // Merge defaults from all classes in the inheritance chain (from top to bottom, so child classes override parent classes)
+
+  /**
+   * Merges default properties from all classes in the inheritance chain.
+   */
   merge_defaults() {
     let current_class = this.constructor;
     while (current_class) { // deep merge defaults
@@ -61,21 +75,33 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
       current_class = Object.getPrototypeOf(current_class);
     }
   }
-  // OVERRIDE IN CHILD CLASSES to customize key
+
+  /**
+   * Generates or retrieves a unique key for the item. Can be overridden in child classes.
+   * @returns {string} The unique key.
+   */
   get_key() {
     console.log("called default get_key");
     return create_uid(this.data);
   }
   // update_data - for data in this.data
   /**
-   * Updates the data of this item.
-   * @param {Object} input_data - The new data for the item.
+   * Updates the data of this item with new data.
+   * @param {Object} data - The new data for the item.
+   * @returns {boolean} True if data was successfully updated.
    */
   update_data(data) {
     data = JSON.parse(JSON.stringify(data, this.update_data_replacer));
     deep_merge(this.data, data); // deep merge data
     return true; // return true if data changed (default true)
   }
+
+  /**
+   * Custom replacer function for JSON.stringify used in update_data to handle special object types.
+   * @param {string} key - The key of the property being stringified.
+   * @param {any} value - The value of the property being stringified.
+   * @returns {any} The value to be used in the JSON string.
+   */
   update_data_replacer(key, value) {
     if (value instanceof CollectionItem) return value.ref;
     if (Array.isArray(value)) return value.map((val) => (val instanceof CollectionItem) ? val.ref : val);
@@ -85,9 +111,12 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
   /**
    * Initializes the item with input_data, potentially asynchronously.
    * Handles interactions with other collection items.
-   * @param {Object} input_data - The initial data for the item.
    */
   init() { this.save(); } // should always call this.save() in child class init() overrides
+
+  /**
+   * Saves the current state of the item to its collection.
+   */
   save() {
     if (!this.validate_save()) {
       if (this.key) this.collection.delete(this.key);
@@ -96,14 +125,29 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
     this.collection.set(this); // set entity in collection
     this.collection.save(); // save collection
   }
+
+  /**
+   * Validates the item's data before saving.
+   * @returns {boolean} True if the data is valid for saving.
+   */
   validate_save() {
     if(!this.key) return false;
     if(this.key === '') return false;
     if(this.key === 'undefined') return false;
     return true;
   }
+
+  /**
+   * Deletes the item from its collection.
+   */
   delete() { this.collection.delete(this.key); }
+
   // functional filter (returns true or false) for filtering items in collection; called by collection class
+  /**
+   * Filters items in the collection based on provided options.
+   * @param {Object} opts - Filtering options.
+   * @returns {boolean} True if the item passes the filter.
+   */
   filter(opts = {}) {
     const {
       exclude_key,
@@ -121,20 +165,46 @@ <h1 class="page-title">Source: smart-collections/CollectionItem.js</h1>
     // OVERRIDE FILTER LOGIC here: pattern: if(opts.pattern &amp;&amp; !this.data[opts.pattern.matcher]) return false;
     return true;
   }
+
+  /**
+   * Parses the item's data for any necessary processing or transformation. Placeholder for override in child classes.
+   */
   parse() { }
-  // HELPER FUNCTIONS
-  // CONVENIENCE METHODS (namespace getters)
+
+  /**
+   * Retrieves the collection name derived from the class name.
+   * @returns {string} The collection name.
+   */
   static get collection_name() { return collection_instance_name_from(this.name); }
-  // static get collection_name() { return this.name
-  //   .replace(/([a-z])([A-Z])/g, '$1_$2') // convert camelCase to snake_case
-  //   .toLowerCase() // convert to lowercase
-  //   .replace(/y$/, 'ie') // ex. summaries
-  //   + 's';
-  // }
+
+  /**
+   * Retrieves the collection name for the instance, either from data or the class method.
+   * @returns {string} The collection name.
+   */
   get collection_name() { return this.data.collection_name ? this.data.collection_name : this.constructor.collection_name; }
+
+  /**
+   * Retrieves the collection this item belongs to.
+   * @returns {Object} The collection object.
+   */
   get collection() { return this.brain[this.collection_name]; }
+
+  /**
+   * Retrieves or generates the key for this item.
+   * @returns {string} The item's key.
+   */
   get key() { return this.data.key = this.data.key || this.get_key(); }
+
+  /**
+   * Provides a reference object for this item, containing the collection name and key.
+   * @returns {Object} The reference object.
+   */
   get ref() { return { collection_name: this.collection_name, key: this.key }; }
+
+  /**
+   * Retrieves the sequence key for this item, used for building sequence keys.
+   * @returns {string} The sequence key.
+   */
   get seq_key() { return this.key; } // used for building sequence keys
 }
 exports.CollectionItem = CollectionItem;</code></pre>
@@ -153,7 +223,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-embed_SmartEmbed.js.html b/docs/smart-embed_SmartEmbed.js.html
index 3800fd8e..b97b847a 100644
--- a/docs/smart-embed_SmartEmbed.js.html
+++ b/docs/smart-embed_SmartEmbed.js.html
@@ -83,7 +83,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs/smart-embed_smart_socket.js.html b/docs/smart-embed_smart_socket.js.html
index 04ca6444..5e6d3a3b 100644
--- a/docs/smart-embed_smart_socket.js.html
+++ b/docs/smart-embed_smart_socket.js.html
@@ -237,7 +237,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Anthropic
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:19:42 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Tue Apr 16 2024 15:27:32 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>