PyPI - mindroot - Versions diffs - 9.11.0__py3-none-any.whl → 9.13.0__py3-none-any.whl - Mend - Supply Chain Defender

mindroot 9.11.0py3-none-any.whl → 9.13.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of mindroot might be problematic. Click here for more details.

Files changed (417) hide show

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

@@ -0,0 +1,1050 @@
+<!doctype html>
+<html class="no-js" lang="en" data-content_root="../">
+  <head><meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width,initial-scale=1"/>
+    <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
+<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" />
+    <!-- Generated with Sphinx 8.2.3 and Furo 2025.07.19 -->
+        <title>mindroot.lib.plugins package - MindRoot 9.10.0 documentation</title>
+      <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=d111a655" />
+    <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=25af2a20" />
+    <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=8dab3a3b" />
+    <link rel="stylesheet" type="text/css" href="../_static/custom.css?v=f4b9d74b" />
+<style>
+  body {
+    --color-code-background: #f2f2f2;
+  --color-code-foreground: #1e1e1e;
+  --color-brand-primary: #007acc;
+  --color-brand-content: #007acc;
+  }
+  @media not print {
+    body[data-theme="dark"] {
+      --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
+  --color-brand-primary: #ff7b72;
+  --color-brand-content: #ff7b72;
+    }
+    @media (prefers-color-scheme: dark) {
+      body:not([data-theme="light"]) {
+        --color-code-background: #2b2b2b;
+  --color-code-foreground: #f8f8f2;
+  --color-brand-primary: #ff7b72;
+  --color-brand-content: #ff7b72;
+      }
+    }
+  }
+</style></head>
+  <body>
+    <script>
+      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
+    </script>
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+  <symbol id="svg-toc" viewBox="0 0 24 24">
+    <title>Contents</title>
+    <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
+      <path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-menu" viewBox="0 0 24 24">
+    <title>Menu</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
+      <line x1="3" y1="12" x2="21" y2="12"></line>
+      <line x1="3" y1="6" x2="21" y2="6"></line>
+      <line x1="3" y1="18" x2="21" y2="18"></line>
+    </svg>
+  </symbol>
+  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
+    <title>Expand</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
+      <polyline points="9 18 15 12 9 6"></polyline>
+    </svg>
+  </symbol>
+  <symbol id="svg-sun" viewBox="0 0 24 24">
+    <title>Light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
+      <circle cx="12" cy="12" r="5"></circle>
+      <line x1="12" y1="1" x2="12" y2="3"></line>
+      <line x1="12" y1="21" x2="12" y2="23"></line>
+      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
+      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
+      <line x1="1" y1="12" x2="3" y2="12"></line>
+      <line x1="21" y1="12" x2="23" y2="12"></line>
+      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
+      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon" viewBox="0 0 24 24">
+    <title>Dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
+    </svg>
+  </symbol>
+  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
+    <title>Auto light/dark, in light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
+      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
+      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
+      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
+      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
+      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
+      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
+      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
+      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
+      <circle cx="14.5" cy="9.55" r="3.6"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
+    <title>Auto light/dark, in dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
+      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
+      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
+      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
+      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
+      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
+      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
+      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-pencil" viewBox="0 0 24 24">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-pencil-code">
+      <path d="M4 20h4l10.5 -10.5a2.828 2.828 0 1 0 -4 -4l-10.5 10.5v4" />
+      <path d="M13.5 6.5l4 4" />
+      <path d="M20 21l2 -2l-2 -2" />
+      <path d="M17 17l-2 2l2 2" />
+    </svg>
+  </symbol>
+  <symbol id="svg-eye" viewBox="0 0 24 24">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-eye-code">
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M10 12a2 2 0 1 0 4 0a2 2 0 0 0 -4 0" />
+      <path
+        d="M11.11 17.958c-3.209 -.307 -5.91 -2.293 -8.11 -5.958c2.4 -4 5.4 -6 9 -6c3.6 0 6.6 2 9 6c-.21 .352 -.427 .688 -.647 1.008" />
+      <path d="M20 21l2 -2l-2 -2" />
+      <path d="M17 17l-2 2l2 2" />
+    </svg>
+  </symbol>
+</svg>
+<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
+<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
+<label class="overlay sidebar-overlay" for="__navigation">
+  <div class="visually-hidden">Hide navigation sidebar</div>
+</label>
+<label class="overlay toc-overlay" for="__toc">
+  <div class="visually-hidden">Hide table of contents sidebar</div>
+</label>
+<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
+<div class="page">
+  <header class="mobile-header">
+    <div class="header-left">
+      <label class="nav-overlay-icon" for="__navigation">
+        <div class="visually-hidden">Toggle site navigation sidebar</div>
+        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
+      </label>
+    </div>
+    <div class="header-center">
+      <a href="../index.html"><div class="brand">MindRoot 9.10.0 documentation</div></a>
+    </div>
+    <div class="header-right">
+      <div class="theme-toggle-container theme-toggle-header">
+        <button class="theme-toggle">
+          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+        </button>
+      </div>
+      <label class="toc-overlay-icon toc-header-icon" for="__toc">
+        <div class="visually-hidden">Toggle table of contents sidebar</div>
+        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+      </label>
+    </div>
+  </header>
+  <aside class="sidebar-drawer">
+    <div class="sidebar-container">
+      <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
+</a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
+  <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
+  <input type="hidden" name="check_keywords" value="yes">
+  <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>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../getting_started.html">Getting Started</a></li>
+</ul>
+</div>
+</div>
+      </div>
+    </div>
+  </aside>
+  <div class="main">
+    <div class="content">
+      <div class="article-container">
+        <a href="#" class="back-to-top muted-link">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
+          </svg>
+          <span>Back to top</span>
+        </a>
+        <div class="content-icon-container">
+          <div class="view-this-page">
+  <a class="muted-link" href="../_sources/source/mindroot.lib.plugins.rst.txt" title="View this page">
+    <svg><use href="#svg-eye"></use></svg>
+    <span class="visually-hidden">View this page</span>
+  </a>
+</div>
+<div class="theme-toggle-container theme-toggle-content">
+            <button class="theme-toggle">
+              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+            </button>
+          </div>
+          <label class="toc-overlay-icon toc-content-icon" for="__toc">
+            <div class="visually-hidden">Toggle table of contents sidebar</div>
+            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+          </label>
+        </div>
+        <article role="main" id="furo-main-content">
+          <section id="mindroot-lib-plugins-package">
+<h1>mindroot.lib.plugins package<a class="headerlink" href="#mindroot-lib-plugins-package" title="Link to this heading">¶</a></h1>
+<section id="submodules">
+<h2>Submodules<a class="headerlink" href="#submodules" title="Link to this heading">¶</a></h2>
+</section>
+<section id="module-mindroot.lib.plugins.installation">
+<span id="mindroot-lib-plugins-installation-module"></span><h2>mindroot.lib.plugins.installation module<a class="headerlink" href="#module-mindroot.lib.plugins.installation" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.installation.check_plugin_dependencies">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.installation.</span></span><span class="sig-name descname"><span class="pre">check_plugin_dependencies</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#check_plugin_dependencies"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.installation.check_plugin_dependencies" title="Link to this definition">¶</a></dt>
+<dd><p>Check if all plugin dependencies are met.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_path</strong> (<em>str</em>) – Path to plugin directory</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if all dependencies are met</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.installation.download_github_files">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.installation.</span></span><span class="sig-name descname"><span class="pre">download_github_files</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">repo_path</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tag</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#download_github_files"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.installation.download_github_files" title="Link to this definition">¶</a></dt>
+<dd><p>Download GitHub repo files to temp directory.</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>repo_path</strong> (<em>str</em>) – GitHub repository path (user/repo)</p></li>
+<li><p><strong>tag</strong> (<em>str</em><em>, </em><em>optional</em>) – Specific tag to download</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>(plugin_dir, plugin_root, plugin_info)</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>tuple</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.installation.install_plugin_dependencies">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.installation.</span></span><span class="sig-name descname"><span class="pre">install_plugin_dependencies</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#install_plugin_dependencies"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.installation.install_plugin_dependencies" title="Link to this definition">¶</a></dt>
+<dd><p>Install plugin dependencies from requirements.txt.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_path</strong> (<em>str</em>) – Path to plugin directory</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if installation successful</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.installation.install_recommended_plugins">
+<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.plugins.installation.</span></span><span class="sig-name descname"><span class="pre">install_recommended_plugins</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">agent_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">context</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#install_recommended_plugins"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.installation.install_recommended_plugins" title="Link to this definition">¶</a></dt>
+<dd><p>Install plugins recommended for an agent based on its required_plugins list.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>agent_name</strong> (<em>str</em>) – Name of the agent</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>Results of plugin installation</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>dict</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.installation.plugin_install">
+<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.plugins.installation.</span></span><span class="sig-name descname"><span class="pre">plugin_install</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'pypi'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_path</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">remote_source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#plugin_install"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.installation.plugin_install" title="Link to this definition">¶</a></dt>
+<dd><p>Install a plugin from various sources.</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>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>source</strong> (<em>str</em>) – Installation source (‘pypi’, ‘local’, ‘github’)</p></li>
+<li><p><strong>source_path</strong> (<em>str</em><em>, </em><em>optional</em>) – Path or GitHub repo reference</p></li>
+<li><p><strong>remote_source</strong> (<em>str</em><em>, </em><em>optional</em>) – Remote source for the plugin (e.g., GitHub repo path)</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if installation successful</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.installation.plugin_update">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.installation.</span></span><span class="sig-name descname"><span class="pre">plugin_update</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#plugin_update"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.installation.plugin_update" title="Link to this definition">¶</a></dt>
+<dd><p>Update an installed plugin.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin to update</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if update successful</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins.l8n_static_handler">
+<span id="mindroot-lib-plugins-l8n-static-handler-module"></span><h2>mindroot.lib.plugins.l8n_static_handler module<a class="headerlink" href="#module-mindroot.lib.plugins.l8n_static_handler" title="Link to this heading">¶</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles">
+<em class="property"><span class="k"><span class="pre">class</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.l8n_static_handler.</span></span><span class="sig-name descname"><span class="pre">TranslatedStaticFiles</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em>, <em class="sig-param"><span class="n"><span class="pre">directory</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">plugin_name</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="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#TranslatedStaticFiles"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles" title="Link to this definition">¶</a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">StaticFiles</span></code></p>
+<p>Custom StaticFiles handler that applies l8n translations to JavaScript files.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.apply_translations_to_js">
+<span class="sig-name descname"><span class="pre">apply_translations_to_js</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">content</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">language</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">file_path</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">str</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#TranslatedStaticFiles.apply_translations_to_js"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.apply_translations_to_js" title="Link to this definition">¶</a></dt>
+<dd><p>Apply translations to JavaScript content.</p>
+<p>This looks for __TRANSLATE_key__ placeholders in JS files and replaces them
+with translated strings. If translations are missing, returns None to
+signal that the original file should be served instead.</p>
+</dd></dl>
+<dl class="py method">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.get_current_language">
+<span class="sig-name descname"><span class="pre">get_current_language</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Request</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">str</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#TranslatedStaticFiles.get_current_language"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.get_current_language" title="Link to this definition">¶</a></dt>
+<dd><p>Get the current language for the request.</p>
+</dd></dl>
+<dl class="py method">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.get_response">
+<em class="property"><span class="k"><span class="pre">async</span></span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">get_response</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">path</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">scope</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">MutableMapping</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">Any</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">Response</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#TranslatedStaticFiles.get_response"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.get_response" title="Link to this definition">¶</a></dt>
+<dd><p>Override to add translation support for JavaScript files.</p>
+</dd></dl>
+<dl class="py method">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.should_translate_file">
+<span class="sig-name descname"><span class="pre">should_translate_file</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">file_path</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</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">bool</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#TranslatedStaticFiles.should_translate_file"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.should_translate_file" title="Link to this definition">¶</a></dt>
+<dd><p>Check if a file should be translated.</p>
+</dd></dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.create_js_translation_object">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.l8n_static_handler.</span></span><span class="sig-name descname"><span class="pre">create_js_translation_object</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">translations</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">dict</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">str</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#create_js_translation_object"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.create_js_translation_object" title="Link to this definition">¶</a></dt>
+<dd><p>Create a JavaScript object containing translations.</p>
+<p>This can be injected into JS files to provide client-side translation support.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>translations</strong> – Dictionary of translation key-value pairs</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>JavaScript code defining a translation object</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.inject_translations_into_js">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.l8n_static_handler.</span></span><span class="sig-name descname"><span class="pre">inject_translations_into_js</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">content</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">translations</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">dict</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">str</span></span></span><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#inject_translations_into_js"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.inject_translations_into_js" title="Link to this definition">¶</a></dt>
+<dd><p>Inject translation object into JavaScript content.</p>
+<p>This prepends translation definitions to JS files.</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>content</strong> – Original JavaScript content</p></li>
+<li><p><strong>translations</strong> – Translation dictionary</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>JavaScript content with translations injected</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.l8n_static_handler.mount_translated_static_files">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.l8n_static_handler.</span></span><span class="sig-name descname"><span class="pre">mount_translated_static_files</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_name</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">category</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><a class="reference internal" href="../_modules/mindroot/lib/plugins/l8n_static_handler.html#mount_translated_static_files"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.l8n_static_handler.mount_translated_static_files" title="Link to this definition">¶</a></dt>
+<dd><p>Mount plugin static files with translation support.</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>app</strong> (<em>FastAPI</em>) – The FastAPI application instance</p></li>
+<li><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>category</strong> (<em>str</em>) – Plugin category (‘core’ or ‘installed’)</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins.loader">
+<span id="mindroot-lib-plugins-loader-module"></span><h2>mindroot.lib.plugins.loader module<a class="headerlink" href="#module-mindroot.lib.plugins.loader" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader.load">
+<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.plugins.loader.</span></span><span class="sig-name descname"><span class="pre">load</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader.html#load"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader.load" title="Link to this definition">¶</a></dt>
+<dd><p>Load all enabled plugins with l8n translation support.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>app</strong> (<em>FastAPI</em><em>, </em><em>optional</em>) – The FastAPI application instance</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>Exception</strong> – If no FastAPI instance is provided or found</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader.load_middleware">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.loader.</span></span><span class="sig-name descname"><span class="pre">load_middleware</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_path</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">category</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader.html#load_middleware"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader.load_middleware" title="Link to this definition">¶</a></dt>
+<dd><p>Load plugin middleware if it exists.</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>app</strong> (<em>FastAPI</em>) – The FastAPI application instance</p></li>
+<li><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>plugin_path</strong> (<em>str</em>) – Import path of the plugin</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader.mount_static_files">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.loader.</span></span><span class="sig-name descname"><span class="pre">mount_static_files</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">category</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader.html#mount_static_files"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader.mount_static_files" title="Link to this definition">¶</a></dt>
+<dd><p>Mount plugin static files with translation support if available.</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>app</strong> (<em>FastAPI</em>) – The FastAPI application instance</p></li>
+<li><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>category</strong> (<em>str</em>) – Plugin category (‘core’ or ‘installed’)</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader.pre_load">
+<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.plugins.loader.</span></span><span class="sig-name descname"><span class="pre">pre_load</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader.html#pre_load"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader.pre_load" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins.loader_with_l8n">
+<span id="mindroot-lib-plugins-loader-with-l8n-module"></span><h2>mindroot.lib.plugins.loader_with_l8n module<a class="headerlink" href="#module-mindroot.lib.plugins.loader_with_l8n" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader_with_l8n.load">
+<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.plugins.loader_with_l8n.</span></span><span class="sig-name descname"><span class="pre">load</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader_with_l8n.html#load"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader_with_l8n.load" title="Link to this definition">¶</a></dt>
+<dd><p>Load all enabled plugins with l8n translation support.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>app</strong> (<em>FastAPI</em><em>, </em><em>optional</em>) – The FastAPI application instance</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>Exception</strong> – If no FastAPI instance is provided or found</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader_with_l8n.load_middleware">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.loader_with_l8n.</span></span><span class="sig-name descname"><span class="pre">load_middleware</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_path</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">category</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader_with_l8n.html#load_middleware"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader_with_l8n.load_middleware" title="Link to this definition">¶</a></dt>
+<dd><p>Load plugin middleware if it exists.</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>app</strong> (<em>FastAPI</em>) – The FastAPI application instance</p></li>
+<li><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>plugin_path</strong> (<em>str</em>) – Import path of the plugin</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader_with_l8n.mount_static_files">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.loader_with_l8n.</span></span><span class="sig-name descname"><span class="pre">mount_static_files</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">category</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader_with_l8n.html#mount_static_files"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader_with_l8n.mount_static_files" title="Link to this definition">¶</a></dt>
+<dd><p>Mount plugin static files with translation support if available.</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>app</strong> (<em>FastAPI</em>) – The FastAPI application instance</p></li>
+<li><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>category</strong> (<em>str</em>) – Plugin category (‘core’ or ‘installed’)</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.loader_with_l8n.pre_load">
+<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.plugins.loader_with_l8n.</span></span><span class="sig-name descname"><span class="pre">pre_load</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader_with_l8n.html#pre_load"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.loader_with_l8n.pre_load" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins.manifest">
+<span id="mindroot-lib-plugins-manifest-module"></span><h2>mindroot.lib.plugins.manifest module<a class="headerlink" href="#module-mindroot.lib.plugins.manifest" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.manifest.create_default_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.manifest.</span></span><span class="sig-name descname"><span class="pre">create_default_plugin_manifest</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#create_default_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.manifest.create_default_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Create a new default manifest file.</p>
+<p>This function first attempts migration, then creates from default template if needed.</p>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.manifest.list_enabled">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.manifest.</span></span><span class="sig-name descname"><span class="pre">list_enabled</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">include_category</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#list_enabled"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.manifest.list_enabled" title="Link to this definition">¶</a></dt>
+<dd><p>List all enabled plugins.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>include_category</strong> (<em>bool</em>) – Whether to include the category in results</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>List of enabled plugins, optionally with categories</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>list</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.manifest.load_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.manifest.</span></span><span class="sig-name descname"><span class="pre">load_plugin_manifest</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#load_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.manifest.load_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Load the plugin manifest file.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>The manifest data structure</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>dict</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.manifest.save_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.manifest.</span></span><span class="sig-name descname"><span class="pre">save_plugin_manifest</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">manifest</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#save_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.manifest.save_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Save the plugin manifest file.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>manifest</strong> (<em>dict</em>) – The manifest data structure to save</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.manifest.toggle_plugin_state">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.manifest.</span></span><span class="sig-name descname"><span class="pre">toggle_plugin_state</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enabled</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#toggle_plugin_state"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.manifest.toggle_plugin_state" title="Link to this definition">¶</a></dt>
+<dd><p>Toggle a plugin’s enabled state.</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>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>enabled</strong> (<em>bool</em>) – New enabled state</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if successful, False if plugin not found</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.manifest.update_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.manifest.</span></span><span class="sig-name descname"><span class="pre">update_plugin_manifest</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_path</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">remote_source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'0.0.1'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">metadata</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#update_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.manifest.update_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Update or add a plugin entry in the manifest.</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>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>source</strong> (<em>str</em>) – Source type (‘core’, ‘local’, ‘github’)</p></li>
+<li><p><strong>source_path</strong> (<em>str</em>) – Path to the plugin</p></li>
+<li><p><strong>remote_source</strong> (<em>str</em><em>, </em><em>optional</em>) – GitHub repository reference</p></li>
+<li><p><strong>version</strong> (<em>str</em><em>, </em><em>optional</em>) – Plugin version</p></li>
+<li><p><strong>metadata</strong> (<em>dict</em><em>, </em><em>optional</em>) – Plugin metadata including commands and services</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins.mapping">
+<span id="mindroot-lib-plugins-mapping-module"></span><h2>mindroot.lib.plugins.mapping module<a class="headerlink" href="#module-mindroot.lib.plugins.mapping" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.mapping.get_command_plugin_mapping">
+<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.plugins.mapping.</span></span><span class="sig-name descname"><span class="pre">get_command_plugin_mapping</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">context</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/mapping.html#get_command_plugin_mapping"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.mapping.get_command_plugin_mapping" title="Link to this definition">¶</a></dt>
+<dd><p>Get a mapping of commands to the plugins that provide them.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Mapping of command names to lists of plugin names</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>dict</p>
+</dd>
+</dl>
+</dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins.paths">
+<span id="mindroot-lib-plugins-paths-module"></span><h2>mindroot.lib.plugins.paths module<a class="headerlink" href="#module-mindroot.lib.plugins.paths" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.paths.get_plugin_import_path">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.paths.</span></span><span class="sig-name descname"><span class="pre">get_plugin_import_path</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/paths.html#get_plugin_import_path"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.paths.get_plugin_import_path" title="Link to this definition">¶</a></dt>
+<dd><p>Get the Python import path for a plugin.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>Import path for the plugin or None if not found</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.paths.get_plugin_path">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.paths.</span></span><span class="sig-name descname"><span class="pre">get_plugin_path</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/paths.html#get_plugin_path"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.paths.get_plugin_path" title="Link to this definition">¶</a></dt>
+<dd><p>Get the filesystem path for a plugin.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>Absolute path to the plugin directory or None if not found</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+</section>
+<section id="module-mindroot.lib.plugins">
+<span id="module-contents"></span><h2>Module contents<a class="headerlink" href="#module-mindroot.lib.plugins" title="Link to this heading">¶</a></h2>
+<p>Plugin system for managing, installing, and loading plugins.</p>
+<p>This module provides the main interface for the plugin system, including:
+- Plugin installation and updates
+- Plugin loading and initialization
+- Manifest management
+- Path resolution</p>
+<dl>
+<dt>Typical usage:</dt><dd><p>from lib.plugins import load, plugin_install, toggle_plugin_state</p>
+<p># Install a plugin
+plugin_install(‘my-plugin’, source=’github’, source_path=’user/repo’)</p>
+<p># Load plugins in FastAPI app
+await load(app)</p>
+</dd>
+</dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.check_plugin_dependencies">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">check_plugin_dependencies</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#check_plugin_dependencies"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.check_plugin_dependencies" title="Link to this definition">¶</a></dt>
+<dd><p>Check if all plugin dependencies are met.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_path</strong> (<em>str</em>) – Path to plugin directory</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if all dependencies are met</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.get_plugin_import_path">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">get_plugin_import_path</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/paths.html#get_plugin_import_path"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.get_plugin_import_path" title="Link to this definition">¶</a></dt>
+<dd><p>Get the Python import path for a plugin.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>Import path for the plugin or None if not found</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.get_plugin_path">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">get_plugin_path</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/paths.html#get_plugin_path"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.get_plugin_path" title="Link to this definition">¶</a></dt>
+<dd><p>Get the filesystem path for a plugin.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>Absolute path to the plugin directory or None if not found</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>str</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.install_plugin_dependencies">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">install_plugin_dependencies</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#install_plugin_dependencies"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.install_plugin_dependencies" title="Link to this definition">¶</a></dt>
+<dd><p>Install plugin dependencies from requirements.txt.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_path</strong> (<em>str</em>) – Path to plugin directory</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if installation successful</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.list_enabled">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">list_enabled</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">include_category</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#list_enabled"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.list_enabled" title="Link to this definition">¶</a></dt>
+<dd><p>List all enabled plugins.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>include_category</strong> (<em>bool</em>) – Whether to include the category in results</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>List of enabled plugins, optionally with categories</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>list</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.load">
+<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.plugins.</span></span><span class="sig-name descname"><span class="pre">load</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader.html#load"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.load" title="Link to this definition">¶</a></dt>
+<dd><p>Load all enabled plugins with l8n translation support.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>app</strong> (<em>FastAPI</em><em>, </em><em>optional</em>) – The FastAPI application instance</p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><strong>Exception</strong> – If no FastAPI instance is provided or found</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.load_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">load_plugin_manifest</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#load_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.load_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Load the plugin manifest file.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>The manifest data structure</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p>dict</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.plugin_install">
+<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.plugins.</span></span><span class="sig-name descname"><span class="pre">plugin_install</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'pypi'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_path</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">remote_source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#plugin_install"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.plugin_install" title="Link to this definition">¶</a></dt>
+<dd><p>Install a plugin from various sources.</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>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>source</strong> (<em>str</em>) – Installation source (‘pypi’, ‘local’, ‘github’)</p></li>
+<li><p><strong>source_path</strong> (<em>str</em><em>, </em><em>optional</em>) – Path or GitHub repo reference</p></li>
+<li><p><strong>remote_source</strong> (<em>str</em><em>, </em><em>optional</em>) – Remote source for the plugin (e.g., GitHub repo path)</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if installation successful</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.plugin_update">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">plugin_update</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/installation.html#plugin_update"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.plugin_update" title="Link to this definition">¶</a></dt>
+<dd><p>Update an installed plugin.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>plugin_name</strong> (<em>str</em>) – Name of the plugin to update</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if update successful</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.pre_load">
+<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.plugins.</span></span><span class="sig-name descname"><span class="pre">pre_load</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">app</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/loader.html#pre_load"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.pre_load" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.save_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">save_plugin_manifest</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">manifest</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#save_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.save_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Save the plugin manifest file.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>manifest</strong> (<em>dict</em>) – The manifest data structure to save</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.toggle_plugin_state">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">toggle_plugin_state</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enabled</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#toggle_plugin_state"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.toggle_plugin_state" title="Link to this definition">¶</a></dt>
+<dd><p>Toggle a plugin’s enabled state.</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>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>enabled</strong> (<em>bool</em>) – New enabled state</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>True if successful, False if plugin not found</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>bool</p>
+</dd>
+</dl>
+</dd></dl>
+<dl class="py function">
+<dt class="sig sig-object py" id="mindroot.lib.plugins.update_plugin_manifest">
+<span class="sig-prename descclassname"><span class="pre">mindroot.lib.plugins.</span></span><span class="sig-name descname"><span class="pre">update_plugin_manifest</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">plugin_name</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source_path</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">remote_source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'0.0.1'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">metadata</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/mindroot/lib/plugins/manifest.html#update_plugin_manifest"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#mindroot.lib.plugins.update_plugin_manifest" title="Link to this definition">¶</a></dt>
+<dd><p>Update or add a plugin entry in the manifest.</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>plugin_name</strong> (<em>str</em>) – Name of the plugin</p></li>
+<li><p><strong>source</strong> (<em>str</em>) – Source type (‘core’, ‘local’, ‘github’)</p></li>
+<li><p><strong>source_path</strong> (<em>str</em>) – Path to the plugin</p></li>
+<li><p><strong>remote_source</strong> (<em>str</em><em>, </em><em>optional</em>) – GitHub repository reference</p></li>
+<li><p><strong>version</strong> (<em>str</em><em>, </em><em>optional</em>) – Plugin version</p></li>
+<li><p><strong>metadata</strong> (<em>dict</em><em>, </em><em>optional</em>) – Plugin metadata including commands and services</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+</section>
+</section>
+        </article>
+      </div>
+      <footer>
+        <div class="related-pages">
+        </div>
+        <div class="bottom-of-page">
+          <div class="left-details">
+            <div class="copyright">
+                Copyright &#169; 2025, Jason Livesay
+            </div>
+            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
+            <a href="https://github.com/pradyunsg/furo">Furo</a>
+          </div>
+          <div class="right-details">
+          </div>
+        </div>
+      </footer>
+    </div>
+    <aside class="toc-drawer">
+      <div class="toc-sticky toc-scroll">
+        <div class="toc-title-container">
+          <span class="toc-title">
+            On this page
+          </span>
+        </div>
+        <div class="toc-tree-container">
+          <div class="toc-tree">
+            <ul>
+<li><a class="reference internal" href="#">mindroot.lib.plugins package</a><ul>
+<li><a class="reference internal" href="#submodules">Submodules</a></li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.installation">mindroot.lib.plugins.installation module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.installation.check_plugin_dependencies"><code class="docutils literal notranslate"><span class="pre">check_plugin_dependencies()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.installation.download_github_files"><code class="docutils literal notranslate"><span class="pre">download_github_files()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.installation.install_plugin_dependencies"><code class="docutils literal notranslate"><span class="pre">install_plugin_dependencies()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.installation.install_recommended_plugins"><code class="docutils literal notranslate"><span class="pre">install_recommended_plugins()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.installation.plugin_install"><code class="docutils literal notranslate"><span class="pre">plugin_install()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.installation.plugin_update"><code class="docutils literal notranslate"><span class="pre">plugin_update()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.l8n_static_handler">mindroot.lib.plugins.l8n_static_handler module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles"><code class="docutils literal notranslate"><span class="pre">TranslatedStaticFiles</span></code></a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.apply_translations_to_js"><code class="docutils literal notranslate"><span class="pre">TranslatedStaticFiles.apply_translations_to_js()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.get_current_language"><code class="docutils literal notranslate"><span class="pre">TranslatedStaticFiles.get_current_language()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.get_response"><code class="docutils literal notranslate"><span class="pre">TranslatedStaticFiles.get_response()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.TranslatedStaticFiles.should_translate_file"><code class="docutils literal notranslate"><span class="pre">TranslatedStaticFiles.should_translate_file()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.create_js_translation_object"><code class="docutils literal notranslate"><span class="pre">create_js_translation_object()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.inject_translations_into_js"><code class="docutils literal notranslate"><span class="pre">inject_translations_into_js()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.l8n_static_handler.mount_translated_static_files"><code class="docutils literal notranslate"><span class="pre">mount_translated_static_files()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.loader">mindroot.lib.plugins.loader module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader.load"><code class="docutils literal notranslate"><span class="pre">load()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader.load_middleware"><code class="docutils literal notranslate"><span class="pre">load_middleware()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader.mount_static_files"><code class="docutils literal notranslate"><span class="pre">mount_static_files()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader.pre_load"><code class="docutils literal notranslate"><span class="pre">pre_load()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.loader_with_l8n">mindroot.lib.plugins.loader_with_l8n module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader_with_l8n.load"><code class="docutils literal notranslate"><span class="pre">load()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader_with_l8n.load_middleware"><code class="docutils literal notranslate"><span class="pre">load_middleware()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader_with_l8n.mount_static_files"><code class="docutils literal notranslate"><span class="pre">mount_static_files()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.loader_with_l8n.pre_load"><code class="docutils literal notranslate"><span class="pre">pre_load()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.manifest">mindroot.lib.plugins.manifest module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.manifest.create_default_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">create_default_plugin_manifest()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.manifest.list_enabled"><code class="docutils literal notranslate"><span class="pre">list_enabled()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.manifest.load_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">load_plugin_manifest()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.manifest.save_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">save_plugin_manifest()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.manifest.toggle_plugin_state"><code class="docutils literal notranslate"><span class="pre">toggle_plugin_state()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.manifest.update_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">update_plugin_manifest()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.mapping">mindroot.lib.plugins.mapping module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.mapping.get_command_plugin_mapping"><code class="docutils literal notranslate"><span class="pre">get_command_plugin_mapping()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins.paths">mindroot.lib.plugins.paths module</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.paths.get_plugin_import_path"><code class="docutils literal notranslate"><span class="pre">get_plugin_import_path()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.paths.get_plugin_path"><code class="docutils literal notranslate"><span class="pre">get_plugin_path()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#module-mindroot.lib.plugins">Module contents</a><ul>
+<li><a class="reference internal" href="#mindroot.lib.plugins.check_plugin_dependencies"><code class="docutils literal notranslate"><span class="pre">check_plugin_dependencies()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.get_plugin_import_path"><code class="docutils literal notranslate"><span class="pre">get_plugin_import_path()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.get_plugin_path"><code class="docutils literal notranslate"><span class="pre">get_plugin_path()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.install_plugin_dependencies"><code class="docutils literal notranslate"><span class="pre">install_plugin_dependencies()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.list_enabled"><code class="docutils literal notranslate"><span class="pre">list_enabled()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.load"><code class="docutils literal notranslate"><span class="pre">load()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.load_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">load_plugin_manifest()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.plugin_install"><code class="docutils literal notranslate"><span class="pre">plugin_install()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.plugin_update"><code class="docutils literal notranslate"><span class="pre">plugin_update()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.pre_load"><code class="docutils literal notranslate"><span class="pre">pre_load()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.save_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">save_plugin_manifest()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.toggle_plugin_state"><code class="docutils literal notranslate"><span class="pre">toggle_plugin_state()</span></code></a></li>
+<li><a class="reference internal" href="#mindroot.lib.plugins.update_plugin_manifest"><code class="docutils literal notranslate"><span class="pre">update_plugin_manifest()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+          </div>
+        </div>
+      </div>
+    </aside>
+  </div>
+</div><script src="../_static/documentation_options.js?v=3c16008f"></script>
+    <script src="../_static/doctools.js?v=9bcbadda"></script>
+    <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script src="../_static/scripts/furo.js?v=46bd48cc"></script>
+    </body>
+</html>