From b4a0014dd22f2f694d0e002808d43a11f3f95166 Mon Sep 17 00:00:00 2001
From: Levi Neely <lneely@pascom.net>
Date: Wed, 22 Apr 2026 11:16:35 +0200
Subject: [PATCH] doc: hand-crafted architecture diagram

Replace Mermaid-generated SVG with hand-written SVG to avoid
font metric clipping. Shows core as foundation, olliesrv as
the 9P layer, and front-ends/scripts/pipelines as consumers.
---
 doc/ARCHITECTURE.md  |   2 +-
 doc/architecture.svg | 113 ++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 113 insertions(+), 2 deletions(-)

diff --git a/doc/ARCHITECTURE.md b/doc/ARCHITECTURE.md
index de6bd80..8304191 100644
--- a/doc/ARCHITECTURE.md
+++ b/doc/ARCHITECTURE.md
@@ -6,7 +6,7 @@ ollie is a small, extensible core library for building agentic systems. It has n
 
 ## Overview
 
-![ollie architecture](architecture.svg?v=2)
+![ollie architecture](architecture.svg?v=5)
 
 ## Package Layout
 
diff --git a/doc/architecture.svg b/doc/architecture.svg
index 8ec867f..9711768 100644
--- a/doc/architecture.svg
+++ b/doc/architecture.svg
@@ -1 +1,112 @@
-<svg id="my-svg" width="100%" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="flowchart" style="max-width: 666px; background-color: transparent;" viewBox="0 0 666 1272" role="graphics-document document" aria-roledescription="flowchart-v2"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#my-svg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#my-svg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#my-svg .cluster-label text{fill:#333;}#my-svg .cluster-label span{color:#333;}#my-svg .cluster-label span p{background-color:transparent;}#my-svg .label text,#my-svg span{fill:#333;color:#333;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#my-svg .rough-node .label text,#my-svg .node .label text,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .rough-node .label,#my-svg .node .label,#my-svg .image-shape .label,#my-svg .icon-shape .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#my-svg .arrowheadPath{fill:#333333;}#my-svg .edgePath .path{stroke:#333333;stroke-width:2.0px;}#my-svg .flowchart-link{stroke:#333333;fill:none;}#my-svg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#my-svg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#my-svg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#my-svg .cluster text{fill:#333;}#my-svg .cluster span{color:#333;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg rect.text{fill:none;stroke-width:0;}#my-svg .icon-shape,#my-svg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#my-svg .icon-shape p,#my-svg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#my-svg .icon-shape .label rect,#my-svg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#my-svg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#my-svg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}#my-svg .coreStyle&gt;*{fill:#2d3748!important;stroke:#4a5568!important;color:#e2e8f0!important;}#my-svg .coreStyle span{fill:#2d3748!important;stroke:#4a5568!important;color:#e2e8f0!important;}#my-svg .coreStyle tspan{fill:#e2e8f0!important;}#my-svg .ninepStyle&gt;*{fill:#1a365d!important;stroke:#2b6cb0!important;color:#e2e8f0!important;}#my-svg .ninepStyle span{fill:#1a365d!important;stroke:#2b6cb0!important;color:#e2e8f0!important;}#my-svg .ninepStyle tspan{fill:#e2e8f0!important;}#my-svg .feStyle&gt;*{fill:#2c5282!important;stroke:#3182ce!important;color:#e2e8f0!important;}#my-svg .feStyle span{fill:#2c5282!important;stroke:#3182ce!important;color:#e2e8f0!important;}#my-svg .feStyle tspan{fill:#e2e8f0!important;}#my-svg .extStyle&gt;*{fill:#553c9a!important;stroke:#6b46c1!important;color:#e2e8f0!important;}#my-svg .extStyle span{fill:#553c9a!important;stroke:#6b46c1!important;color:#e2e8f0!important;}#my-svg .extStyle tspan{fill:#e2e8f0!important;}</style><g><marker id="my-svg_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="my-svg_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"><g class="cluster" id="core" data-look="classic"><rect style="" x="8" y="800" width="457" height="336"/><g class="cluster-label" transform="translate(177, 800)"><foreignObject width="119" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5;"><span class="nodeLabel"><p>core — Go library</p></span></div></foreignObject></g></g><g class="cluster" id="ninep" data-look="classic"><rect style="" x="138.75" y="518" width="345" height="208"/><g class="cluster-label" transform="translate(246.25, 518)"><foreignObject width="130" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5;"><span class="nodeLabel"><p>olliesrv — 9P server</p></span></div></foreignObject></g></g></g><g class="edgePaths"><path d="M271.288,597L265.199,601.167C259.109,605.333,246.929,613.667,240.84,622C234.75,630.333,234.75,638.667,234.75,642.833L234.75,647" id="L_fs_stores_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_fs_stores_0" data-points="W3sieCI6MjcxLjI4ODQ2MTUzODQ2MTU1LCJ5Ijo1OTd9LHsieCI6MjM0Ljc1LCJ5Ijo2MjJ9LHsieCI6MjM0Ljc1LCJ5Ijo2NDd9XQ=="/><path d="M350.212,597L356.301,601.167C362.391,605.333,374.571,613.667,380.66,622C386.75,630.333,386.75,638.667,386.75,642.833L386.75,647" id="L_fs_scripts_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_fs_scripts_0" data-points="W3sieCI6MzUwLjIxMTUzODQ2MTUzODQ1LCJ5Ijo1OTd9LHsieCI6Mzg2Ljc1LCJ5Ijo2MjJ9LHsieCI6Mzg2Ljc1LCJ5Ijo2NDd9XQ=="/><path d="M178.024,879L169.27,883.167C160.516,887.333,143.008,895.667,134.254,903.333C125.5,911,125.5,918,125.5,921.5L125.5,925" id="L_agent_disp_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_agent_disp_0" data-points="W3sieCI6MTc4LjAyNDAzODQ2MTUzODQ1LCJ5Ijo4Nzl9LHsieCI6MTI1LjUsInkiOjkwNH0seyJ4IjoxMjUuNSwieSI6OTI5fV0=" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M125.5,983L125.5,989.167C125.5,995.333,125.5,1007.667,125.5,1019.333C125.5,1031,125.5,1042,125.5,1047.5L125.5,1053" id="L_disp_exec_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_disp_exec_0" data-points="W3sieCI6MTI1LjUsInkiOjk4M30seyJ4IjoxMjUuNSwieSI6MTAyMH0seyJ4IjoxMjUuNSwieSI6MTA1N31d" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M291.476,879L300.23,883.167C308.984,887.333,326.492,895.667,335.246,903.333C344,911,344,918,344,921.5L344,925" id="L_agent_be_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_agent_be_0" data-points="W3sieCI6MjkxLjQ3NTk2MTUzODQ2MTU1LCJ5Ijo4Nzl9LHsieCI6MzQ0LCJ5Ijo5MDR9LHsieCI6MzQ0LCJ5Ijo5Mjl9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M234.75,701L234.75,705.167C234.75,709.333,234.75,717.667,234.75,728C234.75,738.333,234.75,750.667,234.75,763C234.75,775.333,234.75,787.667,234.75,797.333C234.75,807,234.75,814,234.75,817.5L234.75,821" id="L_stores_agent_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_stores_agent_0" data-points="W3sieCI6MjM0Ljc1LCJ5Ijo3MDF9LHsieCI6MjM0Ljc1LCJ5Ijo3MjZ9LHsieCI6MjM0Ljc1LCJ5Ijo3NjN9LHsieCI6MjM0Ljc1LCJ5Ijo4MDB9LHsieCI6MjM0Ljc1LCJ5Ijo4MjV9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M125.5,1111L125.5,1115.167C125.5,1119.333,125.5,1127.667,125.5,1138C125.5,1148.333,125.5,1160.667,125.5,1172.333C125.5,1184,125.5,1195,125.5,1200.5L125.5,1206" id="L_exec_toolscripts_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_exec_toolscripts_0" data-points="W3sieCI6MTI1LjUsInkiOjExMTF9LHsieCI6MTI1LjUsInkiOjExMzZ9LHsieCI6MTI1LjUsInkiOjExNzN9LHsieCI6MTI1LjUsInkiOjEyMTB9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M344,983L344,989.167C344,995.333,344,1007.667,369.357,1020.739C394.714,1033.811,445.427,1047.623,470.784,1054.528L496.141,1061.434" id="L_be_llm_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_be_llm_0" data-points="W3sieCI6MzQ0LCJ5Ijo5ODN9LHsieCI6MzQ0LCJ5IjoxMDIwfSx7IngiOjUwMCwieSI6MTA2Mi40ODUxMDYzODI5Nzg4fV0=" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/><path d="M310.75,444L310.75,450.167C310.75,456.333,310.75,468.667,310.75,481C310.75,493.333,310.75,505.667,310.75,515.333C310.75,525,310.75,532,310.75,535.5L310.75,539" id="L_frontends_fs_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style=";" data-edge="true" data-et="edge" data-id="L_frontends_fs_0" data-points="W3sieCI6MzEwLjc1LCJ5Ijo0NDR9LHsieCI6MzEwLjc1LCJ5Ijo0ODF9LHsieCI6MzEwLjc1LCJ5Ijo1MTh9LHsieCI6MzEwLjc1LCJ5Ijo1NDN9XQ==" marker-end="url(#my-svg_flowchart-v2-pointEnd)"/></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" data-id="L_fs_stores_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_fs_scripts_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_agent_disp_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_disp_exec_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel"><g class="label" data-id="L_agent_be_0" transform="translate(0, 0)"><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(234.75, 763)"><g class="label" data-id="L_stores_agent_0" transform="translate(-24.5, -12)"><foreignObject width="49" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>imports</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(125.5, 1173)"><g class="label" data-id="L_exec_toolscripts_0" transform="translate(-24, -12)"><foreignObject width="48" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>invokes</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(344, 1020)"><g class="label" data-id="L_be_llm_0" transform="translate(-20, -12)"><foreignObject width="40" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>HTTP</p></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(310.75, 481)"><g class="label" data-id="L_frontends_fs_0" transform="translate(-22.5, -12)"><foreignObject width="45" height="24"><div xmlns="http://www.w3.org/1999/xhtml" class="labelBkg" style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;"><span class="edgeLabel"><p>file I/O</p></span></div></foreignObject></g></g></g><g class="nodes"><g class="root" transform="translate(210.75, 0)"><g class="clusters"><g class="cluster" id="frontends" data-look="classic"><rect style="" x="8" y="8" width="184" height="436"/><g class="cluster-label" transform="translate(65, 8)"><foreignObject width="70" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table-cell; white-space: nowrap; line-height: 1.5;"><span class="nodeLabel"><p>Front-ends</p></span></div></foreignObject></g></g></g><g class="edgePaths"/><g class="edgeLabels"/><g class="nodes"><g class="node default feStyle" id="flowchart-tui-0" transform="translate(100, 70)"><rect class="basic label-container" style="fill:#2c5282 !important;stroke:#3182ce !important" x="-54.5" y="-27" width="109" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-24.5, -12)"><rect/><foreignObject width="49" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>ollie-tui</p></span></div></foreignObject></g></g><g class="node default feStyle" id="flowchart-el-1" transform="translate(100, 174)"><rect class="basic label-container" style="fill:#2c5282 !important;stroke:#3182ce !important" x="-43" y="-27" width="86" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-13, -12)"><rect/><foreignObject width="26" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>ellie</p></span></div></foreignObject></g></g><g class="node default feStyle" id="flowchart-sh-2" transform="translate(100, 278)"><rect class="basic label-container" style="fill:#2c5282 !important;stroke:#3182ce !important" x="-42.5" y="-27" width="85" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-12.5, -12)"><rect/><foreignObject width="25" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>s/sh</p></span></div></foreignObject></g></g><g class="node default feStyle" id="flowchart-custom-3" transform="translate(100, 382)"><rect class="basic label-container" style="fill:#2c5282 !important;stroke:#3182ce !important" x="-53" y="-27" width="106" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-23, -12)"><rect/><foreignObject width="46" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>custom</p></span></div></foreignObject></g></g></g></g><g class="node default ninepStyle" id="flowchart-fs-4" transform="translate(310.75, 570)"><rect class="basic label-container" style="fill:#1a365d !important;stroke:#2b6cb0 !important" x="-72" y="-27" width="144" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-42, -12)"><rect/><foreignObject width="84" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>9P filesystem</p></span></div></foreignObject></g></g><g class="node default ninepStyle" id="flowchart-stores-5" transform="translate(234.75, 674)"><rect class="basic label-container" style="fill:#1a365d !important;stroke:#2b6cb0 !important" x="-50" y="-27" width="100" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-20, -12)"><rect/><foreignObject width="40" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>Stores</p></span></div></foreignObject></g></g><g class="node default ninepStyle" id="flowchart-scripts-6" transform="translate(386.75, 674)"><rect class="basic label-container" style="fill:#1a365d !important;stroke:#2b6cb0 !important" x="-52" y="-27" width="104" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-22, -12)"><rect/><foreignObject width="44" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>Scripts</p></span></div></foreignObject></g></g><g class="node default coreStyle" id="flowchart-agent-11" transform="translate(234.75, 852)"><rect class="basic label-container" style="fill:#2d3748 !important;stroke:#4a5568 !important" x="-65" y="-27" width="130" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-35, -12)"><rect/><foreignObject width="70" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>agent.Core</p></span></div></foreignObject></g></g><g class="node default coreStyle" id="flowchart-exec-12" transform="translate(125.5, 1084)"><rect class="basic label-container" style="fill:#2d3748 !important;stroke:#4a5568 !important" x="-73.5" y="-27" width="147" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-43.5, -12)"><rect/><foreignObject width="87" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>execute_code</p></span></div></foreignObject></g></g><g class="node default coreStyle" id="flowchart-be-13" transform="translate(344, 956)"><rect class="basic label-container" style="fill:#2d3748 !important;stroke:#4a5568 !important" x="-86" y="-27" width="172" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-56, -12)"><rect/><foreignObject width="112" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>backend.Backend</p></span></div></foreignObject></g></g><g class="node default coreStyle" id="flowchart-disp-14" transform="translate(125.5, 956)"><rect class="basic label-container" style="fill:#2d3748 !important;stroke:#4a5568 !important" x="-82.5" y="-27" width="165" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-52.5, -12)"><rect/><foreignObject width="105" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>tools.Dispatcher</p></span></div></foreignObject></g></g><g class="node default extStyle" id="flowchart-toolscripts-26" transform="translate(125.5, 1237)"><rect class="basic label-container" style="fill:#553c9a !important;stroke:#6b46c1 !important" x="-68" y="-27" width="136" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-38, -12)"><rect/><foreignObject width="76" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>Tool scripts</p></span></div></foreignObject></g></g><g class="node default extStyle" id="flowchart-llm-28" transform="translate(579, 1084)"><rect class="basic label-container" style="fill:#553c9a !important;stroke:#6b46c1 !important" x="-79" y="-27" width="158" height="54"/><g class="label" style="color:#e2e8f0 !important" transform="translate(-49, -12)"><rect/><foreignObject width="98" height="24"><div style="color: rgb(226, 232, 240) !important; display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span style="color:#e2e8f0 !important" class="nodeLabel"><p>LLM providers</p></span></div></foreignObject></g></g></g></g></g></svg>
\ No newline at end of file
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 620" font-family="system-ui,sans-serif" font-size="14">
+  <defs>
+    <marker id="arrow" viewBox="0 0 10 10" refX="10" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+      <path d="M0,0 L10,5 L0,10 z" fill="#666"/>
+    </marker>
+    <style>
+      .box { fill:#e8e8ff; stroke:#9370db; stroke-width:1.5; rx:5; }
+      .region { fill:none; stroke:#999; stroke-width:1.5; stroke-dasharray:6,3; rx:10; }
+      .region-core { fill:#f5f5ff; }
+      .region-9p { fill:#f0f4ff; }
+      .label { text-anchor:middle; fill:#333; }
+      .sub { font-size:12; fill:#666; }
+      .rlabel { font-size:13; fill:#777; font-weight:bold; }
+      .edge { stroke:#666; stroke-width:1.5; fill:none; marker-end:url(#arrow); }
+      .link { stroke:#999; stroke-width:1.5; fill:none; }
+      .elabel { font-size:12; fill:#666; text-anchor:middle; }
+    </style>
+  </defs>
+
+  <!-- ===== core region ===== -->
+  <rect class="region region-core" x="20" y="280" width="480" height="220"/>
+  <text class="rlabel" x="50" y="300">core (Go library)</text>
+
+  <rect class="box" x="100" y="310" width="170" height="36"/>
+  <text class="label" x="185" y="333">agent.Core</text>
+
+  <rect class="box" x="340" y="310" width="130" height="36"/>
+  <text class="label" x="405" y="333">Stores</text>
+
+  <rect class="box" x="40" y="390" width="170" height="36"/>
+  <text class="label" x="125" y="413">tools.Dispatcher</text>
+
+  <rect class="box" x="280" y="390" width="180" height="36"/>
+  <text class="label" x="370" y="413">backend.Backend</text>
+
+  <rect class="box" x="40" y="450" width="170" height="36"/>
+  <text class="label" x="125" y="473">execute_code</text>
+
+  <!-- core internal edges -->
+  <line class="edge" x1="145" y1="346" x2="125" y2="388"/>
+  <line class="edge" x1="230" y1="346" x2="330" y2="388"/>
+  <line class="edge" x1="125" y1="426" x2="125" y2="448"/>
+
+  <!-- ===== 9P region ===== -->
+  <rect class="region region-9p" x="110" y="145" width="220" height="75"/>
+  <text class="rlabel" x="130" y="162">olliesrv (9P server)</text>
+
+  <rect class="box" x="130" y="170" width="170" height="36"/>
+  <text class="label" x="215" y="193">9P filesystem</text>
+
+  <!-- 9P imports core -->
+  <line class="edge" x1="215" y1="220" x2="185" y2="308"/>
+  <text class="elabel" x="185" y="260">imports</text>
+
+  <!-- 9P consumes stores -->
+  <line class="edge" x1="300" y1="200" x2="405" y2="308"/>
+  <text class="elabel" x="375" y="245">consumes</text>
+
+  <!-- ===== External consumers ===== -->
+
+  <!-- Front-ends -->
+  <rect class="box" x="100" y="30" width="240" height="48"/>
+  <text class="label" x="220" y="50">Front-ends</text>
+  <text class="label sub" x="220" y="66">(ollie-tui, ellie, s/sh, custom)</text>
+
+  <!-- Front-ends -> 9P -->
+  <line class="edge" x1="220" y1="78" x2="215" y2="168"/>
+  <text class="elabel" x="240" y="125">file I/O</text>
+
+  <!-- Scripts (served by 9P) -->
+  <rect class="box" x="350" y="60" width="150" height="48"/>
+  <text class="label" x="425" y="80">Scripts</text>
+  <text class="label sub" x="425" y="96">(s/sh, b/sched, b/q)</text>
+
+  <!-- Pipelines -->
+  <rect class="box" x="350" y="145" width="150" height="36"/>
+  <text class="label" x="425" y="163">Pipelines</text>
+  <text class="label sub" x="425" y="175">b/q | b/q | ...</text>
+
+  <!-- Scripts -> Pipelines -->
+  <line class="edge" x1="425" y1="108" x2="425" y2="143"/>
+  <text class="elabel" x="450" y="128">compose</text>
+
+  <!-- Scripts link to 9P -->
+  <line class="edge" x1="370" y1="108" x2="300" y2="178"/>
+
+  <!-- Tool scripts -->
+  <rect class="box" x="10" y="540" width="210" height="48"/>
+  <text class="label" x="115" y="560">Tool scripts (t/)</text>
+  <text class="label sub" x="115" y="576">file_read, subagent_spawn, ...</text>
+
+  <!-- Inline code -->
+  <rect class="box" x="230" y="540" width="170" height="48"/>
+  <text class="label" x="315" y="560">Inline code</text>
+  <text class="label sub" x="315" y="576">bash, python3, perl, lua, ...</text>
+
+  <!-- execute_code -> tool scripts -->
+  <line class="edge" x1="100" y1="486" x2="100" y2="538"/>
+  <text class="elabel" x="78" y="517">runs</text>
+
+  <!-- execute_code -> inline code -->
+  <line class="edge" x1="160" y1="486" x2="290" y2="538"/>
+
+  <!-- LLM providers -->
+  <rect class="box" x="430" y="540" width="80" height="48"/>
+  <text class="label" x="470" y="558">LLM</text>
+  <text class="label sub" x="470" y="574">providers</text>
+
+  <!-- backend -> LLM -->
+  <line class="edge" x1="420" y1="426" x2="470" y2="538"/>
+  <text class="elabel" x="465" y="487">HTTP</text>
+</svg>