mindroot 9.22.0__py3-none-any.whl → 10.14.0__py3-none-any.whl

mindroot/docs/_build/html/source/mindroot.coreplugins.startup.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.coreplugins.subscriptions.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.coreplugins.usage.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.coreplugins.user_service.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>
@@ -374,6 +375,7 @@
 <li class="toctree-l4"><a class="reference internal" href="mindroot.lib.html#mindroot.lib.chatlog.ChatLog.save_log"><code class="docutils literal notranslate"><span class="pre">ChatLog.save_log()</span></code></a></li>
 </ul>
 </li>
+<li class="toctree-l3"><a class="reference internal" href="mindroot.lib.html#mindroot.lib.chatlog.build_token_hierarchy"><code class="docutils literal notranslate"><span class="pre">build_token_hierarchy()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="mindroot.lib.html#mindroot.lib.chatlog.count_tokens_for_log_id"><code class="docutils literal notranslate"><span class="pre">count_tokens_for_log_id()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="mindroot.lib.html#mindroot.lib.chatlog.extract_delegate_task_log_ids"><code class="docutils literal notranslate"><span class="pre">extract_delegate_task_log_ids()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="mindroot.lib.html#mindroot.lib.chatlog.find_chatlog_file"><code class="docutils literal notranslate"><span class="pre">find_chatlog_file()</span></code></a></li>

mindroot/docs/_build/html/source/mindroot.lib.auth.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.lib.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>
@@ -849,16 +850,45 @@ Creates the directory if it doesn’t exist.</p>
 
 </dd></dl>
 
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.chatlog.build_token_hierarchy">
+<em class="property"><span class="k"><span class="pre">async</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">mindroot.lib.chatlog.</span></span><span class="sig-name descname"><span class="pre">build_token_hierarchy</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">log_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">visited</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">set</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Dict</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/chatlog.html#build_token_hierarchy"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.chatlog.build_token_hierarchy" title="Link to this definition">¶</a></dt>
+<dd><p>Build a hierarchical token count structure for a log and its children.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>log_id</strong> – The log ID to build hierarchy for</p></li>
+<li><p><strong>user</strong> – User for the log</p></li>
+<li><p><strong>visited</strong> – Set of already visited log IDs to prevent infinite recursion</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p><ul class="simple">
+<li><p>log_id: The log ID</p></li>
+<li><p>individual_counts: Token counts for this log only</p></li>
+<li><p>cumulative_counts: Token counts including all children</p></li>
+<li><p>children: List of child hierarchies</p></li>
+</ul>
+</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Dictionary with hierarchical structure containing</p>
+</dd>
+</dl>
+</dd></dl>
+
 <dl class="py function">
 <dt class="sig sig-object py" id="mindroot.lib.chatlog.count_tokens_for_log_id">
-<em class="property"><span class="k"><span class="pre">async</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">mindroot.lib.chatlog.</span></span><span class="sig-name descname"><span class="pre">count_tokens_for_log_id</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">log_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="pre">int</span><span class="p"><span class="pre">]</span></span></span></span><a class="reference internal" href="../_modules/mindroot/lib/chatlog.html#count_tokens_for_log_id"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.chatlog.count_tokens_for_log_id" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="k"><span class="pre">async</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">mindroot.lib.chatlog.</span></span><span class="sig-name descname"><span class="pre">count_tokens_for_log_id</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">log_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hierarchical</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Dict</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="pre">int</span><span class="p"><span class="pre">]</span></span></span></span><a class="reference internal" href="../_modules/mindroot/lib/chatlog.html#count_tokens_for_log_id"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.chatlog.count_tokens_for_log_id" title="Link to this definition">¶</a></dt>
 <dd><p>Count tokens for a chat log identified by log_id, including any delegated tasks.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>log_id</strong> – The log ID to count tokens for</p>
 </dd>
 <dt class="field-even">Returns<span class="colon">:</span></dt>
-<dd class="field-even"><p>Dictionary with token counts or None if log not found</p>
+<dd class="field-even"><p>Dictionary with token counts or None if log not found.
+If hierarchical=True, includes ‘hierarchy’ key with tree structure.
+If hierarchical=False (default), returns flat structure for backwards compatibility.</p>
 </dd>
 </dl>
 </dd></dl>
@@ -866,7 +896,7 @@ Creates the directory if it doesn’t exist.</p>
 <dl class="py function">
 <dt class="sig sig-object py" id="mindroot.lib.chatlog.extract_delegate_task_log_ids">
 <span class="sig-prename descclassname"><span class="pre">mindroot.lib.chatlog.</span></span><span class="sig-name descname"><span class="pre">extract_delegate_task_log_ids</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">messages</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">Dict</span><span class="p"><span class="pre">]</span></span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span></span></span><a class="reference internal" href="../_modules/mindroot/lib/chatlog.html#extract_delegate_task_log_ids"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.chatlog.extract_delegate_task_log_ids" title="Link to this definition">¶</a></dt>
-<dd><p>Extract log IDs from delegate_task commands in messages.</p>
+<dd><p>Extract log IDs from delegate_task and delegate_subtask commands in messages.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>messages</strong> – List of chat messages</p>
@@ -1516,7 +1546,7 @@ await load(app)</p>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="mindroot.lib.templates.collect_content">
-<em class="property"><span class="k"><span class="pre">async</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">mindroot.lib.templates.</span></span><span class="sig-name descname"><span class="pre">collect_content</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">template</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">blocks</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">template_type</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/templates.html#collect_content"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.templates.collect_content" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="k"><span class="pre">async</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">mindroot.lib.templates.</span></span><span class="sig-name descname"><span class="pre">collect_content</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">template</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">blocks</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">template_type</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">assume_blank</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/templates.html#collect_content"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.templates.collect_content" title="Link to this definition">¶</a></dt>
 <dd><p>Collect content from child templates.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -1525,6 +1555,7 @@ await load(app)</p>
 <li><p><strong>blocks</strong> (<em>list</em>) – List of block names</p></li>
 <li><p><strong>template_type</strong> (<em>str</em>) – Type of template (‘inject’ or ‘override’)</p></li>
 <li><p><strong>data</strong> (<em>dict</em>) – Template context data</p></li>
+<li><p><strong>assume_blank</strong> (<em>bool</em>) – If True and type is ‘override’, unspecified blocks are blanked</p></li>
 </ul>
 </dd>
 <dt class="field-even">Returns<span class="colon">:</span></dt>
@@ -1897,6 +1928,7 @@ Creates the directory if it doesn’t exist.</p>
 <li><a class="reference internal" href="#mindroot.lib.chatlog.ChatLog.save_log"><code class="docutils literal notranslate"><span class="pre">ChatLog.save_log()</span></code></a></li>
 </ul>
 </li>
+<li><a class="reference internal" href="#mindroot.lib.chatlog.build_token_hierarchy"><code class="docutils literal notranslate"><span class="pre">build_token_hierarchy()</span></code></a></li>
 <li><a class="reference internal" href="#mindroot.lib.chatlog.count_tokens_for_log_id"><code class="docutils literal notranslate"><span class="pre">count_tokens_for_log_id()</span></code></a></li>
 <li><a class="reference internal" href="#mindroot.lib.chatlog.extract_delegate_task_log_ids"><code class="docutils literal notranslate"><span class="pre">extract_delegate_task_log_ids()</span></code></a></li>
 <li><a class="reference internal" href="#mindroot.lib.chatlog.find_chatlog_file"><code class="docutils literal notranslate"><span class="pre">find_chatlog_file()</span></code></a></li>

mindroot/docs/_build/html/source/mindroot.lib.json_str_block.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.lib.plugins.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mindroot.lib.providers.backup.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>

mindroot/docs/_build/html/source/mindroot.lib.providers.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>

mindroot/docs/_build/html/source/mindroot.registry.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/modules.html

@@ -203,9 +203,23 @@
   <input type="hidden" name="area" value="default">
 </form>
 <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+  <p class="caption" role="heading"><span class="caption-text">User Documentation:</span></p>
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+<li class="toctree-l1 has-children"><a class="reference internal" href="../user_documentation.html">User Documentation</a><input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of User Documentation</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul>
+<li class="toctree-l2"><a class="reference internal" href="../installation.html">Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../starting_mindroot.html">Starting MindRoot</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_plugin_installation.html">LLM Plugin Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../llm_api_key.html">LLM API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Developer Documentation:</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../developer_documentation.html">Developer Documentation</a></li>
 </ul>
 
 </div>

mindroot/docs/_build/html/source/mr_agent_expert_instr.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>

mindroot/docs/_build/html/starting_mindroot.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>

mindroot/docs/_build/html/user_documentation.html

@@ -213,6 +213,7 @@
 <li class="toctree-l2"><a class="reference internal" href="chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l2"><a class="reference internal" href="install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l2"><a class="reference internal" href="programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l2"><a class="reference internal" href="embed_chat.html">Embed Agent Chat on Your Website</a></li>
 </ul>
 </li>
 </ul>
@@ -262,6 +263,7 @@
           <section id="user-documentation">
 <h1>User Documentation<a class="headerlink" href="#user-documentation" title="Link to this heading">¶</a></h1>
 <p>This section covers everything you need to get started with MindRoot as a user.</p>
+<p>Test</p>
 <div class="toctree-wrapper compound">
 <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
 <ul>
@@ -272,6 +274,13 @@
 <li class="toctree-l1"><a class="reference internal" href="chat_with_assistant.html">Chat with Assistant</a></li>
 <li class="toctree-l1"><a class="reference internal" href="install_plugins_with_tools.html">Install Plugins with Tools</a></li>
 <li class="toctree-l1"><a class="reference internal" href="programming_task.html">Give Assistant a Programming Task</a></li>
+<li class="toctree-l1"><a class="reference internal" href="embed_chat.html">Embed Agent Chat on Your Website</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="embed_chat.html#create-an-api-key">Create an API Key</a></li>
+<li class="toctree-l2"><a class="reference internal" href="embed_chat.html#disable-chat-avatar-on-left">Disable Chat Avatar on Left</a></li>
+<li class="toctree-l2"><a class="reference internal" href="embed_chat.html#get-chat-widget-embed-code">Get Chat Widget Embed Code</a></li>
+<li class="toctree-l2"><a class="reference internal" href="embed_chat.html#insert-into-html">Insert into HTML</a></li>
+</ul>
+</li>
 </ul>
 </div>
 </section>

mindroot/docs/developer_documentation.rst

@@ -5,6 +5,26 @@ This section contains documentation for developers working with MindRoot.
 
 .. todo:: Add developer documentation content here
 
+Plugin Examples
+---------------
+
+.. list-table:: Example Plugins
+   :header-rows: 1
+   :widths: 25 40 35
+
+   * - Name
+     - Description
+     - Source
+   * - Override Home Page example
+     - Demonstrates how to override the default home page template.
+     - `home.jinja2 <https://github.com/runvnc/mindroot/blob/main/src/mindroot/docs/example_plugins/override_home/src/override_home/override/home.jinja2>`_
+   * - Run Task example
+     - Shows how to submit a task to an agent, wait for completion, and display the result.
+     - `home.jinja2 <https://github.com/runvnc/mindroot/blob/main/src/mindroot/docs/example_plugins/run_task/src/run_task/override/home.jinja2>`_
+
+Note the specific directory structure, and the `{# assume-blank #}` comment at the top.
+
+
 API Reference
 -------------
 
@@ -23,4 +43,4 @@ Contributing
 Architecture
 ------------
 
-.. todo:: Add system architecture overview
+.. todo:: Add system architecture overview

mindroot/docs/embed_chat.rst

@@ -0,0 +1,54 @@
+Embed Agent Chat on Your Website
+=================================
+
+
+Create an API Key
+-----------------
+
+- Go to /admin | Advanced | API Keys
+
+- Enter a username and click Create New API Key
+
+- Note that the user must exist. 'admin' is OK for testing.
+
+.. image:: apikey.png
+
+Disable Chat Avatar on Left
+---------------------------
+
+- Go to /admin | Advanced | Plugins
+
+- Click on Core Plugins
+
+- Click the Disable button next to `chat_avatar`
+
+.. image:: disablechatavatar.png
+
+Get Chat Widget Embed Code
+--------------------------
+
+- Go to /admin | Advanced | Secure Chat Widget
+
+- Cick Create New Widget Token
+
+.. image:: widgetform.png
+
+- Select the agent, API key, and enter the URL of the MindRoot instance.
+
+- Click Create New Widget Token
+
+- Click on the Copy Embed Code button to copy the code to your clipboard.
+
+.. image:: chatwidgetx.png 
+
+
+Insert into HTML
+----------------
+
+Paste the `<script>` tag into your HTML page before the ending `</body>` tag.
+When you load the page, you should see the chat widget in the lower right corner.
+
+.. image:: widgetonpage.png
+
+
+

mindroot/docs/user_documentation.rst

@@ -3,6 +3,8 @@ User Documentation
 
 This section covers everything you need to get started with MindRoot as a user.
 
+Test
+
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
@@ -13,4 +15,7 @@ This section covers everything you need to get started with MindRoot as a user.
    llm_api_key
    chat_with_assistant
    install_plugins_with_tools
-   programming_task
+   programming_task
+   embed_chat 
+
+