Deployed 5d70872 to edge with MkDocs 1.6.1 and mike 2.2.0

Author: lpb-docs

edge/index.html

@@ -881,56 +881,56 @@ <h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanen
 <p>When spawning subagents for browser testing, use the following pattern to ensure isolated sessions and structured JSON output.</p>
 <h2 id="steps">Steps<a class="headerlink" href="#steps" title="Permanent link">&para;</a></h2>
 <h3 id="1-generate-a-unique-session-id">1. Generate a Unique Session ID<a class="headerlink" href="#1-generate-a-unique-session-id" title="Permanent link">&para;</a></h3>
-<pre><code class="language-bash">SESSION_ID=$(npx tsx bin/session-uuid.ts &quot;${PI_WORKTREE_ID}-&lt;test-name&gt;&quot;)
-</code></pre>
+<div class="highlight"><pre><span></span><code><span class="nv">SESSION_ID</span><span class="o">=</span><span class="k">$(</span>npx<span class="w"> </span>tsx<span class="w"> </span>bin/session-uuid.ts<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">PI_WORKTREE_ID</span><span class="si">}</span><span class="s2">-&lt;test-name&gt;&quot;</span><span class="k">)</span>
+</code></pre></div>
 <p>Example output: <code>pi-main-abc123-login-flow-7f3a9b2c</code></p>
 <h3 id="2-load-the-system-prompt-template">2. Load the System Prompt Template<a class="headerlink" href="#2-load-the-system-prompt-template" title="Permanent link">&para;</a></h3>
-<pre><code class="language-bash">PROMPT=$(cat subagent-browser-prompt.txt)
-</code></pre>
+<div class="highlight"><pre><span></span><code><span class="nv">PROMPT</span><span class="o">=</span><span class="k">$(</span>cat<span class="w"> </span>subagent-browser-prompt.txt<span class="k">)</span>
+</code></pre></div>
 <p>The template at <code>subagent-browser-prompt.txt</code> includes:
 - The JSON schema the subagent must produce
 - Instructions for using agent-browser with bundled Chrome
 - Metrics collection steps (vitals, a11y, snapshot)</p>
 <h3 id="3-spawn-the-subagent">3. Spawn the Subagent<a class="headerlink" href="#3-spawn-the-subagent" title="Permanent link">&para;</a></h3>
-<pre><code class="language-javascript">// Via the subagent tool in Pi:
-subagent({
-  agent: &quot;researcher&quot;,
-  task: `Run browser test on https://example.com:
-    1. Navigate to the URL
-    2. Verify the page loads correctly
-    3. Check for accessibility issues
-    4. Measure performance metrics
-
-    Session ID: ${SESSION_ID}
-    Prompt: ${PROMPT}`,
-  outputSchema: JSON.parse(readFileSync(&quot;subagent-browser-schema.json&quot;)),
-});
-</code></pre>
+<div class="highlight"><pre><span></span><code><span class="c1">// Via the subagent tool in Pi:</span>
+<span class="nx">subagent</span><span class="p">({</span>
+<span class="w">  </span><span class="nx">agent</span><span class="o">:</span><span class="w"> </span><span class="s2">&quot;researcher&quot;</span><span class="p">,</span>
+<span class="w">  </span><span class="nx">task</span><span class="o">:</span><span class="w"> </span><span class="sb">`Run browser test on https://example.com:</span>
+<span class="sb">    1. Navigate to the URL</span>
+<span class="sb">    2. Verify the page loads correctly</span>
+<span class="sb">    3. Check for accessibility issues</span>
+<span class="sb">    4. Measure performance metrics</span>
+
+<span class="sb">    Session ID: </span><span class="si">${</span><span class="nx">SESSION_ID</span><span class="si">}</span>
+<span class="sb">    Prompt: </span><span class="si">${</span><span class="nx">PROMPT</span><span class="si">}</span><span class="sb">`</span><span class="p">,</span>
+<span class="w">  </span><span class="nx">outputSchema</span><span class="o">:</span><span class="w"> </span><span class="nb">JSON</span><span class="p">.</span><span class="nx">parse</span><span class="p">(</span><span class="nx">readFileSync</span><span class="p">(</span><span class="s2">&quot;subagent-browser-schema.json&quot;</span><span class="p">)),</span>
+<span class="p">});</span>
+</code></pre></div>
 <h3 id="4-collect-and-validate-the-result">4. Collect and Validate the Result<a class="headerlink" href="#4-collect-and-validate-the-result" title="Permanent link">&para;</a></h3>
-<pre><code class="language-bash"># Pipe subagent output to the validator
-echo &quot;${SUBAGENT_OUTPUT}&quot; | npx tsx bin/validate-subagent-output.ts
+<div class="highlight"><pre><span></span><code><span class="c1"># Pipe subagent output to the validator</span>
+<span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">SUBAGENT_OUTPUT</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>npx<span class="w"> </span>tsx<span class="w"> </span>bin/validate-subagent-output.ts
 
-# Close the browser session to prevent zombie processes
-agent-browser --session &quot;$SESSION_ID&quot; close
-</code></pre>
+<span class="c1"># Close the browser session to prevent zombie processes</span>
+agent-browser<span class="w"> </span>--session<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$SESSION_ID</span><span class="s2">&quot;</span><span class="w"> </span>close
+</code></pre></div>
 <h3 id="5-retry-on-failure-max-3-attempts">5. Retry on Failure (Max 3 Attempts)<a class="headerlink" href="#5-retry-on-failure-max-3-attempts" title="Permanent link">&para;</a></h3>
-<pre><code class="language-typescript">import { validate, buildRepairPrompt } from &quot;./bin/validate-subagent-output&quot;;
-
-let output = await spawnSubagent(task);
-let result = validate(output);
-let attempts = 1;
-
-while (!result.success &amp;&amp; attempts &lt; 3) {
-  const repairPrompt = buildRepairPrompt(result.error!, originalTask);
-  output = await spawnSubagent(repairPrompt);
-  result = validate(output);
-  attempts++;
-}
-
-if (!result.success) {
-  console.error(`Test failed after ${attempts} attempts: ${result.error}`);
-}
-</code></pre>
+<div class="highlight"><pre><span></span><code><span class="k">import</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">validate</span><span class="p">,</span><span class="w"> </span><span class="nx">buildRepairPrompt</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="kr">from</span><span class="w"> </span><span class="s2">&quot;./bin/validate-subagent-output&quot;</span><span class="p">;</span>
+
+<span class="kd">let</span><span class="w"> </span><span class="nx">output</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">await</span><span class="w"> </span><span class="nx">spawnSubagent</span><span class="p">(</span><span class="nx">task</span><span class="p">);</span>
+<span class="kd">let</span><span class="w"> </span><span class="nx">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">validate</span><span class="p">(</span><span class="nx">output</span><span class="p">);</span>
+<span class="kd">let</span><span class="w"> </span><span class="nx">attempts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1</span><span class="p">;</span>
+
+<span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="nx">result</span><span class="p">.</span><span class="nx">success</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nx">attempts</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mf">3</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kd">const</span><span class="w"> </span><span class="nx">repairPrompt</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">buildRepairPrompt</span><span class="p">(</span><span class="nx">result</span><span class="p">.</span><span class="nx">error</span><span class="o">!</span><span class="p">,</span><span class="w"> </span><span class="nx">originalTask</span><span class="p">);</span>
+<span class="w">  </span><span class="nx">output</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">await</span><span class="w"> </span><span class="nx">spawnSubagent</span><span class="p">(</span><span class="nx">repairPrompt</span><span class="p">);</span>
+<span class="w">  </span><span class="nx">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">validate</span><span class="p">(</span><span class="nx">output</span><span class="p">);</span>
+<span class="w">  </span><span class="nx">attempts</span><span class="o">++</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="nx">result</span><span class="p">.</span><span class="nx">success</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="nx">console</span><span class="p">.</span><span class="nx">error</span><span class="p">(</span><span class="sb">`Test failed after </span><span class="si">${</span><span class="nx">attempts</span><span class="si">}</span><span class="sb"> attempts: </span><span class="si">${</span><span class="nx">result</span><span class="p">.</span><span class="nx">error</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div>
 <h2 id="key-points">Key Points<a class="headerlink" href="#key-points" title="Permanent link">&para;</a></h2>
 <ul>
 <li><strong>Always use bundled Chrome</strong> (not CDP) for subagents</li>

edge/operations/subagent-spawning-pattern/index.html

@@ -1499,17 +1499,17 @@ <h2 id="subagents-fork-lpb-stackpi-subagents">Subagents Fork (<code>lpb-stack/pi
 2. <code>model</code> field in agent <code>.md</code> frontmatter
 3. <strong><code>globalDefaultModel</code></strong> from <code>pi-defaults.json</code> / <code>subagents.json</code> (centralized registry)
 4. Parent session model (inherit)</p>
-<p><strong>Configuration for local-first:</strong></p>
-<pre><code class="language-json">{
-  &quot;extensions&quot;: {
-    &quot;@tintinweb/pi-subagents&quot;: {
-      &quot;globalDefaultModel&quot;: null,
-      &quot;disableDefaultAgents&quot;: true
-    }
-  }
-}
-</code></pre>
-<p><code>globalDefaultModel: null</code> means subagents inherit whatever model the parent session uses — <strong>zero Anthropic dependency</strong>.</p>
+<p><strong>Configuration for local-first:</strong>
+<div class="highlight"><pre><span></span><code><span class="p">{</span>
+<span class="w">  </span><span class="nt">&quot;extensions&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="nt">&quot;@tintinweb/pi-subagents&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="nt">&quot;globalDefaultModel&quot;</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
+<span class="w">      </span><span class="nt">&quot;disableDefaultAgents&quot;</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+</code></pre></div>
+<code>globalDefaultModel: null</code> means subagents inherit whatever model the parent session uses — <strong>zero Anthropic dependency</strong>.</p>
 <p><strong>Verdict:</strong> This is the <strong>glue that makes the local-only stack work end-to-end</strong> — it ensures subagents (like <code>vision-analysis</code>, <code>researcher</code>, etc.) all use the session's local Qwen model instead of falling back to Anthropic.</p>
 <hr />
 <h2 id="lemonade-fork-lpb-stacklemonade-pi-plugin">Lemonade Fork (<code>lpb-stack/lemonade-pi-plugin</code>)<a class="headerlink" href="#lemonade-fork-lpb-stacklemonade-pi-plugin" title="Permanent link">&para;</a></h2>
@@ -1749,16 +1749,16 @@ <h3 id="9-documentation-version">9. Documentation &amp; Version<a class="headerl
 <h2 id="key-design-decisions">Key Design Decisions<a class="headerlink" href="#key-design-decisions" title="Permanent link">&para;</a></h2>
 <h3 id="patch-model">Patch Model<a class="headerlink" href="#patch-model" title="Permanent link">&para;</a></h3>
 <p>All LocalPibox changes are kept as a <strong>single squashed commit</strong> on top of upstream <code>main</code>. The delta is always one clean patch.</p>
-<pre><code>upstream main ──→ [latest] ──┐
+<div class="highlight"><pre><span></span><code>upstream main ──→ [latest] ──┐
                              │
 lpb-dev branch      ──→ [lpb patch]──┘
-</code></pre>
-<p>To update:</p>
-<pre><code class="language-bash">git fetch upstream main
-git checkout lpb-dev
-git rebase upstream/main
-git push --force-with-lease origin lpb-dev
-</code></pre>
+</code></pre></div>
+<p>To update:
+<div class="highlight"><pre><span></span><code>git<span class="w"> </span>fetch<span class="w"> </span>upstream<span class="w"> </span>main
+git<span class="w"> </span>checkout<span class="w"> </span>lpb-dev
+git<span class="w"> </span>rebase<span class="w"> </span>upstream/main
+git<span class="w"> </span>push<span class="w"> </span>--force-with-lease<span class="w"> </span>origin<span class="w"> </span>lpb-dev
+</code></pre></div></p>
 <h3 id="why-the-ratios-matter">Why the Ratios Matter<a class="headerlink" href="#why-the-ratios-matter" title="Permanent link">&para;</a></h3>
 <table>
 <thead>
@@ -1815,20 +1815,20 @@ <h3 id="custom-agent-vision-analysis">Custom Agent (<code>vision-analysis</code>
 2. <code>mcp</code> → <code>agent-browser_screenshot</code> — capture screenshot
 3. <code>read</code> — pass image to session model for vision analysis
 4. <code>mcp</code> → <code>agent-browser_close</code> — close browser</p>
-<p><strong>Usage:</strong></p>
-<pre><code class="language-bash">Agent(description: &quot;Vision analysis of &lt;url&gt;&quot;, subagent_type: &quot;vision-analysis&quot;, prompt: &quot;Analyze this page: &lt;url&gt;&quot;)
-</code></pre>
+<p><strong>Usage:</strong>
+<div class="highlight"><pre><span></span><code>Agent<span class="o">(</span>description:<span class="w"> </span><span class="s2">&quot;Vision analysis of &lt;url&gt;&quot;</span>,<span class="w"> </span>subagent_type:<span class="w"> </span><span class="s2">&quot;vision-analysis&quot;</span>,<span class="w"> </span>prompt:<span class="w"> </span><span class="s2">&quot;Analyze this page: &lt;url&gt;&quot;</span><span class="o">)</span>
+</code></pre></div></p>
 <p>Runs in background, uses session model by default (can override with <code>model:</code> parameter).</p>
 <h3 id="manual-alternative">Manual Alternative<a class="headerlink" href="#manual-alternative" title="Permanent link">&para;</a></h3>
-<pre><code class="language-bash"># Open browser
-mcp({ tool: &quot;agent-browser_open&quot;, args: { url: &quot;...&quot; } })
-# Take screenshot
-mcp({ tool: &quot;agent-browser_screenshot&quot;, args: {} })
-# Read image (passes to session model)
-read(path: &quot;/home/lpb/.agent-browser/tmp/screenshots/screenshot-xxx.png&quot;)
-# Close browser
-mcp({ tool: &quot;agent-browser_close&quot;, args: { all: false } })
-</code></pre>
+<div class="highlight"><pre><span></span><code><span class="c1"># Open browser</span>
+mcp<span class="o">({</span><span class="w"> </span>tool:<span class="w"> </span><span class="s2">&quot;agent-browser_open&quot;</span>,<span class="w"> </span>args:<span class="w"> </span><span class="o">{</span><span class="w"> </span>url:<span class="w"> </span><span class="s2">&quot;...&quot;</span><span class="w"> </span><span class="o">}</span><span class="w"> </span><span class="o">})</span>
+<span class="c1"># Take screenshot</span>
+mcp<span class="o">({</span><span class="w"> </span>tool:<span class="w"> </span><span class="s2">&quot;agent-browser_screenshot&quot;</span>,<span class="w"> </span>args:<span class="w"> </span><span class="o">{}</span><span class="w"> </span><span class="o">})</span>
+<span class="c1"># Read image (passes to session model)</span>
+read<span class="o">(</span>path:<span class="w"> </span><span class="s2">&quot;/home/lpb/.agent-browser/tmp/screenshots/screenshot-xxx.png&quot;</span><span class="o">)</span>
+<span class="c1"># Close browser</span>
+mcp<span class="o">({</span><span class="w"> </span>tool:<span class="w"> </span><span class="s2">&quot;agent-browser_close&quot;</span>,<span class="w"> </span>args:<span class="w"> </span><span class="o">{</span><span class="w"> </span>all:<span class="w"> </span><span class="nb">false</span><span class="w"> </span><span class="o">}</span><span class="w"> </span><span class="o">})</span>
+</code></pre></div>
 <hr />
 <h2 id="known-issues-mitigations">Known Issues &amp; Mitigations<a class="headerlink" href="#known-issues-mitigations" title="Permanent link">&para;</a></h2>
 <h3 id="qwen3-thinking-overflow-2026-08-02">Qwen3 Thinking Overflow (2026-08-02)<a class="headerlink" href="#qwen3-thinking-overflow-2026-08-02" title="Permanent link">&para;</a></h3>