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

mindroot 9.11.0py3-none-any.whl → 9.12.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 (415) hide show

mindroot/docs/_build/html/_modules/mindroot/lib/providers/model_preferences_v2.html ADDED Viewed

@@ -0,0 +1,291 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" data-content_root="../../../../">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>mindroot.lib.providers.model_preferences_v2 &mdash; MindRoot 9.10.0 documentation</title>
+      <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=b86133f3" />
+      <link rel="stylesheet" type="text/css" href="../../../../_static/css/theme.css?v=e59714d7" />
+      <script src="../../../../_static/jquery.js?v=5d32c60e"></script>
+      <script src="../../../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
+      <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/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../../search.html" />
+</head>
+<body class="wy-body-for-nav">
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #343131" >
+          <a href="../../../../index.html" class="icon icon-home">
+            MindRoot
+          </a>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <!-- Local TOC -->
+              <div class="local-toc"></div>
+        </div>
+      </div>
+    </nav>
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #343131" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../../index.html">MindRoot</a>
+      </nav>
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../index.html">Module code</a></li>
+          <li class="breadcrumb-item"><a href="../providers.html">mindroot.lib.providers</a></li>
+      <li class="breadcrumb-item active">mindroot.lib.providers.model_preferences_v2</li>
+      <li class="wy-breadcrumbs-aside">
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+  <h1>Source code for mindroot.lib.providers.model_preferences_v2</h1><div class="highlight"><pre>
+<span></span><span class="kn">import</span><span class="w"> </span><span class="nn">json</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">shutil</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Dict</span><span class="p">,</span> <span class="n">List</span><span class="p">,</span> <span class="n">Tuple</span><span class="p">,</span> <span class="n">Optional</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">pathlib</span><span class="w"> </span><span class="kn">import</span> <span class="n">Path</span>
+<div class="viewcode-block" id="ModelPreferencesV2">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2">[docs]</a>
+<span class="k">class</span><span class="w"> </span><span class="nc">ModelPreferencesV2</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;New model preferences system supporting ordered provider/model pairs for fallback selection.&quot;&quot;&quot;</span>
+    <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="c1"># Use current working directory for data (supports multiple installations)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">data_dir</span> <span class="o">=</span> <span class="n">Path</span><span class="o">.</span><span class="n">cwd</span><span class="p">()</span> <span class="o">/</span> <span class="s1">&#39;data&#39;</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">preferences_file</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_dir</span> <span class="o">/</span> <span class="s1">&#39;preferred_models_v2.json&#39;</span>
+        <span class="c1"># Locate template file relative to this script&#39;s location</span>
+        <span class="n">script_dir</span> <span class="o">=</span> <span class="n">Path</span><span class="p">(</span><span class="vm">__file__</span><span class="p">)</span><span class="o">.</span><span class="n">parent</span><span class="o">.</span><span class="n">parent</span><span class="o">.</span><span class="n">parent</span> <span class="o">/</span> <span class="s1">&#39;coreplugins&#39;</span> <span class="o">/</span> <span class="s1">&#39;admin&#39;</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">template_file</span> <span class="o">=</span> <span class="n">script_dir</span> <span class="o">/</span> <span class="s1">&#39;default_preferred_models.json&#39;</span>
+<div class="viewcode-block" id="ModelPreferencesV2.ensure_preferences_exist">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.ensure_preferences_exist">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">ensure_preferences_exist</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Copy template preferences file to data directory if it doesn&#39;t exist.&quot;&quot;&quot;</span>
+        <span class="c1"># Ensure data directory exists</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">data_dir</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="c1"># If preferences file doesn&#39;t exist, copy from template</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">preferences_file</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
+            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">template_file</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
+                <span class="n">shutil</span><span class="o">.</span><span class="n">copy2</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">template_file</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">preferences_file</span><span class="p">)</span>
+            <span class="k">else</span><span class="p">:</span>
+                <span class="c1"># Create minimal default if template doesn&#39;t exist</span>
+                <span class="n">default_prefs</span> <span class="o">=</span> <span class="p">{</span>
+                    <span class="s2">&quot;stream_chat&quot;</span><span class="p">:</span> <span class="p">[</span>
+                        <span class="p">[</span><span class="s2">&quot;ah_anthropic&quot;</span><span class="p">,</span> <span class="s2">&quot;claude-3-5-sonnet-20240620&quot;</span><span class="p">],</span>
+                        <span class="p">[</span><span class="s2">&quot;ah_openai&quot;</span><span class="p">,</span> <span class="s2">&quot;gpt-4o&quot;</span><span class="p">]</span>
+                    <span class="p">],</span>
+                    <span class="s2">&quot;text_to_image&quot;</span><span class="p">:</span> <span class="p">[</span>
+                        <span class="p">[</span><span class="s2">&quot;ah_flux&quot;</span><span class="p">,</span> <span class="s2">&quot;flux-dev&quot;</span><span class="p">]</span>
+                    <span class="p">]</span>
+                <span class="p">}</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">save_preferences</span><span class="p">(</span><span class="n">default_prefs</span><span class="p">)</span></div>
+<div class="viewcode-block" id="ModelPreferencesV2.get_preferences">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.get_preferences">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">get_preferences</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Get preferences in new format: {service: [[provider, model], ...]}&quot;&quot;&quot;</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">ensure_preferences_exist</span><span class="p">()</span>
+        <span class="k">try</span><span class="p">:</span>
+            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">preferences_file</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
+        <span class="k">except</span> <span class="p">(</span><span class="ne">FileNotFoundError</span><span class="p">,</span> <span class="n">json</span><span class="o">.</span><span class="n">JSONDecodeError</span><span class="p">)</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Error reading preferences v2: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+            <span class="k">return</span> <span class="p">{}</span></div>
+<div class="viewcode-block" id="ModelPreferencesV2.save_preferences">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.save_preferences">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">save_preferences</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">preferences</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Save preferences in new format.&quot;&quot;&quot;</span>
+        <span class="c1"># Ensure data directory exists before saving</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">data_dir</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="k">try</span><span class="p">:</span>
+            <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">preferences_file</span><span class="p">,</span> <span class="s1">&#39;w&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+                <span class="n">json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">preferences</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">indent</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+        <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Error saving preferences v2: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+            <span class="k">raise</span></div>
+<div class="viewcode-block" id="ModelPreferencesV2.get_ordered_providers_for_service">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.get_ordered_providers_for_service">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">get_ordered_providers_for_service</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">service_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Get ordered list of (provider, model) pairs for a service.&quot;&quot;&quot;</span>
+        <span class="n">preferences</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_preferences</span><span class="p">()</span>
+        <span class="k">if</span> <span class="n">service_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">preferences</span><span class="p">:</span>
+            <span class="k">return</span> <span class="p">[]</span>
+        <span class="c1"># Convert list of lists to list of tuples</span>
+        <span class="k">return</span> <span class="p">[(</span><span class="n">provider</span><span class="p">,</span> <span class="n">model</span><span class="p">)</span> <span class="k">for</span> <span class="n">provider</span><span class="p">,</span> <span class="n">model</span> <span class="ow">in</span> <span class="n">preferences</span><span class="p">[</span><span class="n">service_name</span><span class="p">]]</span></div>
+<div class="viewcode-block" id="ModelPreferencesV2.migrate_from_old_format">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.migrate_from_old_format">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">migrate_from_old_format</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_preferences</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">Dict</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Convert old format preferences to new format.</span>
+<span class="sd">        </span>
+<span class="sd">        Old format: [{&quot;service_or_command_name&quot;: &quot;stream_chat&quot;, &quot;flag&quot;: &quot;default&quot;, &quot;model&quot;: &quot;claude-3&quot;}]</span>
+<span class="sd">        New format: {&quot;stream_chat&quot;: [[&quot;ah_anthropic&quot;, &quot;claude-3.5-sonnet&quot;]]}</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">new_preferences</span> <span class="o">=</span> <span class="p">{}</span>
+        <span class="k">for</span> <span class="n">old_pref</span> <span class="ow">in</span> <span class="n">old_preferences</span><span class="p">:</span>
+            <span class="n">service</span> <span class="o">=</span> <span class="n">old_pref</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;service_or_command_name&#39;</span><span class="p">)</span>
+            <span class="n">model</span> <span class="o">=</span> <span class="n">old_pref</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;model&#39;</span><span class="p">)</span>
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">service</span> <span class="ow">or</span> <span class="ow">not</span> <span class="n">model</span><span class="p">:</span>
+                <span class="k">continue</span>
+            <span class="c1"># For migration, we&#39;ll need to guess the provider based on model name</span>
+            <span class="c1"># This is a best-effort conversion</span>
+            <span class="n">provider</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_guess_provider_from_model</span><span class="p">(</span><span class="n">model</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">service</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">new_preferences</span><span class="p">:</span>
+                <span class="n">new_preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span>
+            <span class="c1"># Add if not already present</span>
+            <span class="n">provider_model_pair</span> <span class="o">=</span> <span class="p">[</span><span class="n">provider</span><span class="p">,</span> <span class="n">model</span><span class="p">]</span>
+            <span class="k">if</span> <span class="n">provider_model_pair</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">new_preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]:</span>
+                <span class="n">new_preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">provider_model_pair</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">new_preferences</span></div>
+    <span class="k">def</span><span class="w"> </span><span class="nf">_guess_provider_from_model</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">model_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Best-effort guess of provider based on model name.&quot;&quot;&quot;</span>
+        <span class="n">model_lower</span> <span class="o">=</span> <span class="n">model_name</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
+        <span class="c1"># Common model name patterns</span>
+        <span class="k">if</span> <span class="s1">&#39;claude&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s1">&#39;ah_anthropic&#39;</span>
+        <span class="k">elif</span> <span class="s1">&#39;gpt&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span> <span class="ow">or</span> <span class="s1">&#39;chatgpt&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s1">&#39;ah_openai&#39;</span>
+        <span class="k">elif</span> <span class="s1">&#39;gemini&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s1">&#39;mr_gemini&#39;</span>
+        <span class="k">elif</span> <span class="s1">&#39;llama&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s1">&#39;ah_together&#39;</span>  <span class="c1"># or another llama provider</span>
+        <span class="k">elif</span> <span class="s1">&#39;flux&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s1">&#39;ah_flux&#39;</span>
+        <span class="k">elif</span> <span class="s1">&#39;stable&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span> <span class="ow">or</span> <span class="s1">&#39;sd&#39;</span> <span class="ow">in</span> <span class="n">model_lower</span><span class="p">:</span>
+            <span class="k">return</span> <span class="s1">&#39;ah_stability&#39;</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="c1"># Default fallback</span>
+            <span class="k">return</span> <span class="s1">&#39;unknown_provider&#39;</span>
+<div class="viewcode-block" id="ModelPreferencesV2.add_preference">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.add_preference">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">add_preference</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">service</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">provider</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">position</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Add a provider/model preference for a service at specified position (or end).&quot;&quot;&quot;</span>
+        <span class="n">preferences</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_preferences</span><span class="p">()</span>
+        <span class="k">if</span> <span class="n">service</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">preferences</span><span class="p">:</span>
+            <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="n">provider_model_pair</span> <span class="o">=</span> <span class="p">[</span><span class="n">provider</span><span class="p">,</span> <span class="n">model</span><span class="p">]</span>
+        <span class="c1"># Remove if already exists</span>
+        <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">pm</span> <span class="k">for</span> <span class="n">pm</span> <span class="ow">in</span> <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span> <span class="k">if</span> <span class="n">pm</span> <span class="o">!=</span> <span class="n">provider_model_pair</span><span class="p">]</span>
+        <span class="c1"># Add at specified position or end</span>
+        <span class="k">if</span> <span class="n">position</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="mi">0</span> <span class="o">&lt;=</span> <span class="n">position</span> <span class="o">&lt;=</span> <span class="nb">len</span><span class="p">(</span><span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]):</span>
+            <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="n">position</span><span class="p">,</span> <span class="n">provider_model_pair</span><span class="p">)</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">provider_model_pair</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">save_preferences</span><span class="p">(</span><span class="n">preferences</span><span class="p">)</span></div>
+<div class="viewcode-block" id="ModelPreferencesV2.remove_preference">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.remove_preference">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">remove_preference</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">service</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">provider</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Remove a provider/model preference for a service. Returns True if removed.&quot;&quot;&quot;</span>
+        <span class="n">preferences</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_preferences</span><span class="p">()</span>
+        <span class="k">if</span> <span class="n">service</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">preferences</span><span class="p">:</span>
+            <span class="k">return</span> <span class="kc">False</span>
+        <span class="n">provider_model_pair</span> <span class="o">=</span> <span class="p">[</span><span class="n">provider</span><span class="p">,</span> <span class="n">model</span><span class="p">]</span>
+        <span class="k">if</span> <span class="n">provider_model_pair</span> <span class="ow">in</span> <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]:</span>
+            <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">provider_model_pair</span><span class="p">)</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">save_preferences</span><span class="p">(</span><span class="n">preferences</span><span class="p">)</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
+<div class="viewcode-block" id="ModelPreferencesV2.reorder_preferences">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.model_preferences_v2.ModelPreferencesV2.reorder_preferences">[docs]</a>
+    <span class="k">def</span><span class="w"> </span><span class="nf">reorder_preferences</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">service</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">ordered_pairs</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Set the complete ordered list of provider/model pairs for a service.&quot;&quot;&quot;</span>
+        <span class="n">preferences</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_preferences</span><span class="p">()</span>
+        <span class="n">preferences</span><span class="p">[</span><span class="n">service</span><span class="p">]</span> <span class="o">=</span> <span class="n">ordered_pairs</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">save_preferences</span><span class="p">(</span><span class="n">preferences</span><span class="p">)</span></div>
+</div>
+</pre></div>
+           </div>
+          </div>
+          <footer>
+  <hr/>
+  <div role="contentinfo">
+    <p>&#169; Copyright 2025, Jason Livesay.</p>
+  </div>
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+</body>
+</html>

mindroot/docs/_build/html/_modules/mindroot/lib/providers/services.html ADDED Viewed

@@ -0,0 +1,122 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" data-content_root="../../../../">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>mindroot.lib.providers.services &mdash; MindRoot 9.10.0 documentation</title>
+      <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=b86133f3" />
+      <link rel="stylesheet" type="text/css" href="../../../../_static/css/theme.css?v=e59714d7" />
+      <script src="../../../../_static/jquery.js?v=5d32c60e"></script>
+      <script src="../../../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
+      <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/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../../search.html" />
+</head>
+<body class="wy-body-for-nav">
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #343131" >
+          <a href="../../../../index.html" class="icon icon-home">
+            MindRoot
+          </a>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <!-- Local TOC -->
+              <div class="local-toc"></div>
+        </div>
+      </div>
+    </nav>
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #343131" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../../index.html">MindRoot</a>
+      </nav>
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../index.html">Module code</a></li>
+          <li class="breadcrumb-item"><a href="../providers.html">mindroot.lib.providers</a></li>
+      <li class="breadcrumb-item active">mindroot.lib.providers.services</li>
+      <li class="wy-breadcrumbs-aside">
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+  <h1>Source code for mindroot.lib.providers.services</h1><div class="highlight"><pre>
+<span></span><span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">inspect</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">.</span><span class="w"> </span><span class="kn">import</span> <span class="n">ProviderManager</span>
+<span class="n">service_manager</span> <span class="o">=</span> <span class="n">ProviderManager</span><span class="p">()</span>
+<div class="viewcode-block" id="service">
+<a class="viewcode-back" href="../../../../source/mindroot.lib.providers.html#mindroot.lib.providers.services.service">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">service</span><span class="p">(</span><span class="o">*</span><span class="p">,</span> <span class="n">flags</span><span class="o">=</span><span class="p">[]):</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">decorator</span><span class="p">(</span><span class="n">func</span><span class="p">):</span>
+        <span class="n">docstring</span> <span class="o">=</span> <span class="n">func</span><span class="o">.</span><span class="vm">__doc__</span>
+        <span class="n">name</span> <span class="o">=</span> <span class="n">func</span><span class="o">.</span><span class="vm">__name__</span>
+        <span class="n">signature</span> <span class="o">=</span> <span class="n">inspect</span><span class="o">.</span><span class="n">signature</span><span class="p">(</span><span class="n">func</span><span class="p">)</span>
+        <span class="n">module</span> <span class="o">=</span> <span class="n">inspect</span><span class="o">.</span><span class="n">getmodule</span><span class="p">(</span><span class="n">func</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">module</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Cannot determine module of function&quot;</span><span class="p">)</span>
+        <span class="n">module_name</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">basename</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="n">module</span><span class="o">.</span><span class="vm">__file__</span><span class="p">))</span>
+        <span class="n">service_manager</span><span class="o">.</span><span class="n">register_function</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">module_name</span><span class="p">,</span> <span class="n">func</span><span class="p">,</span> <span class="n">signature</span><span class="p">,</span> <span class="n">docstring</span><span class="p">,</span> <span class="n">flags</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">func</span>
+    <span class="k">return</span> <span class="n">decorator</span></div>
+</pre></div>
+           </div>
+          </div>
+          <footer>
+  <hr/>
+  <div role="contentinfo">
+    <p>&#169; Copyright 2025, Jason Livesay.</p>
+  </div>
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+</body>
+</html>