flock-core 0.1.2__py3-none-any.whl → 0.2.1__py3-none-any.whl

flock/app/components/charts/agent_workflow.py

@@ -1,14 +0,0 @@
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-
-def AgentWorkflowChart():
-    return Div(
-        Div(
-            style="max-width:100%;border:1px solid transparent;",
-            data_mxgraph='{"highlight":"#0000ff","nav":true,"resize":true,"page":1,"toolbar":"pages zoom layers tags lightbox","edit":"_blank","xml":"<mxfile><diagram id=\\"l7_B5a2V6sOU66k4eApJ\\" name=\\"Core Architecture\\"><mxGraphModel dx=\\"1139\\" dy=\\"934\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#FFFFFF\\" math=\\"0\\" shadow=\\"1\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"3\\" value=\\"graph TB&#10;    subgraph User Application&#10;        UA[User Code] --&gt; |Uses| SM[Flock Manager]&#10;    end&#10;&#10;    subgraph Flock Core&#10;        SM --&gt; |Manages| AR[Agent Registry]&#10;        SM --&gt; |Executes| WF[Workflow System]&#10;        &#10;        subgraph Agents&#10;            AR --&gt; |Registers| DA[Declarative Agent]&#10;            DA --&gt; |Uses| TS[Type System]&#10;            DA --&gt; |Uses| TM[Tool Manager]&#10;        end&#10;        &#10;        subgraph Workflow&#10;            WF --&gt; |Runs| AC[Activities]&#10;            WF --&gt; |Uses| TW[Temporal Worker]&#10;            AC --&gt; |Executes| DA&#10;        end&#10;    end&#10;&#10;    subgraph External Systems&#10;        TW --&gt; |Connects to| TS1[Temporal Server]&#10;        TM --&gt; |Integrates| T1[Web Search]&#10;        TM --&gt; |Integrates| T2[Code Eval]&#10;        TM --&gt; |Integrates| T3[Math Tools]&#10;        DA --&gt; |Uses| LLM[LLM Provider]&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef external fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef user fill:#bfb,stroke:#333,stroke-width:2px&#10;    &#10;    class SM,AR,DA,WF,AC,TM,TS core&#10;    class TS1,T1,T2,T3,LLM external&#10;    class UA user&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;rounded=1;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"200\\" y=\\"310\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"m33Os__FMXyp1zJ4IDTH\\" name=\\"Agent Workflow\\"><mxGraphModel dx=\\"1139\\" dy=\\"934\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"Yf0mmGmI6B4_u023lZ5C-1\\" value=\\"sequenceDiagram&#10;    participant User&#10;    participant Flock&#10;    participant Agent&#10;    participant Tools&#10;    participant LLM&#10;    participant Temporal&#10;&#10;    User-&gt;&gt;Flock: Create Agent&#10;    Flock-&gt;&gt;Agent: Initialize&#10;    User-&gt;&gt;Flock: activate(agent, input)&#10;    &#10;    alt Local Debug Mode&#10;        Flock-&gt;&gt;Agent: Execute Directly&#10;    else Production Mode&#10;        Flock-&gt;&gt;Temporal: Start Workflow&#10;        Temporal-&gt;&gt;Agent: Execute via Activity&#10;    end&#10;&#10;    loop Agent Execution&#10;        Agent-&gt;&gt;LLM: Process Input&#10;        opt Tool Usage&#10;            Agent-&gt;&gt;Tools: Execute Tool&#10;            Tools--&gt;&gt;Agent: Tool Result&#10;        end&#10;        Agent-&gt;&gt;LLM: Generate Output&#10;    end&#10;&#10;    alt Has Hand-off&#10;        Agent-&gt;&gt;Flock: Hand off to Next Agent&#10;        Flock-&gt;&gt;Agent: Start Next Agent&#10;    else No Hand-off&#10;        Agent--&gt;&gt;Flock: Return Result&#10;    end&#10;&#10;    Flock--&gt;&gt;User: Return Final Result\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"275\\" y=\\"114\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"zsmzvY-bLYlccnSXdfzv\\" name=\\"Temporal Workflow\\">\\n        <mxGraphModel dx=\\"205\\" dy=\\"165\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\">\\n            <root>\\n                <mxCell id=\\"0\\"/>\\n                <mxCell id=\\"1\\" parent=\\"0\\"/>\\n                <mxCell id=\\"LGo0nXY-PDX6Si-UCiUW-1\\" value=\\"graph TB&#10;    subgraph Temporal Integration&#10;        WF[Workflow System] --&gt; |Manages| TW[Temporal Worker]&#10;        TW --&gt; |Executes| AC[Activities]&#10;        TW --&gt; |Connects to| TS[Temporal Server]&#10;        &#10;        subgraph State Management&#10;            TS --&gt; |Manages| WS[Workflow State]&#10;            WS --&gt; |Tracks| AS[Agent State]&#10;            WS --&gt; |Tracks| TS1[Tool State]&#10;            WS --&gt; |Tracks| ES[Error State]&#10;        end&#10;&#10;        subgraph Reliability Features&#10;            TS --&gt; |Provides| R1[Automatic Retries]&#10;            TS --&gt; |Provides| R2[Error Recovery]&#10;            TS --&gt; |Provides| R3[State Persistence]&#10;            TS --&gt; |Provides| R4[Workflow History]&#10;        end&#10;&#10;        subgraph Monitoring&#10;            TS --&gt; |Enables| M1[Execution Metrics]&#10;            TS --&gt; |Enables| M2[Error Tracking]&#10;            TS --&gt; |Enables| M3[Performance Stats]&#10;            TS --&gt; |Enables| M4[Workflow Visualization]&#10;        end&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef state fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef feature fill:#bfb,stroke:#333,stroke-width:2px&#10;    classDef monitor fill:#fbb,stroke:#333,stroke-width:2px&#10;&#10;    class WF,TW,AC,TS core&#10;    class WS,AS,TS1,ES state&#10;    class R1,R2,R3,R4 feature&#10;    class M1,M2,M3,M4 monitor&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" vertex=\\"1\\" parent=\\"1\\">\\n                    <mxGeometry x=\\"242\\" y=\\"169\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/>\\n                </mxCell>\\n            </root>\\n        </mxGraphModel>\\n    </diagram><diagram id=\\"FU8wRJNSLGF58lYnAYQQ\\" name=\\"Tool System\\">\\n        <mxGraphModel dx=\\"307\\" dy=\\"248\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\">\\n            <root>\\n                <mxCell id=\\"0\\"/>\\n                <mxCell id=\\"1\\" parent=\\"0\\"/>\\n                <mxCell id=\\"T-pgXY2fyKOihok5m5tA-1\\" value=\\"graph TB&#10;    subgraph Tool Management&#10;        TM[Tool Manager] --&gt; |Manages| TR[Tool Registry]&#10;        TR --&gt; |Registers| T1[Web Search Tool]&#10;        TR --&gt; |Registers| T2[Code Eval Tool]&#10;        TR --&gt; |Registers| T3[Math Tool]&#10;        &#10;        TM --&gt; |Provides| TI[Tool Interface]&#10;        TI --&gt; |Used by| DA[Declarative Agent]&#10;    end&#10;&#10;    subgraph Tool Execution&#10;        T1 --&gt; |Uses| WS[Web Search API]&#10;        T2 --&gt; |Uses| CE[Code Executor]&#10;        T3 --&gt; |Uses| ME[Math Engine]&#10;        &#10;        WS --&gt; |Returns| R1[Search Results]&#10;        CE --&gt; |Returns| R2[Execution Results]&#10;        ME --&gt; |Returns| R3[Math Results]&#10;    end&#10;&#10;    subgraph Error Handling&#10;        TM --&gt; |Manages| EH[Error Handler]&#10;        EH --&gt; |Handles| E1[API Errors]&#10;        EH --&gt; |Handles| E2[Execution Errors]&#10;        EH --&gt; |Handles| E3[Validation Errors]&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef tool fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef handler fill:#bfb,stroke:#333,stroke-width:2px&#10;&#10;    class TM,TR,TI core&#10;    class T1,T2,T3,WS,CE,ME tool&#10;    class EH,E1,E2,E3 handler\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" vertex=\\"1\\" parent=\\"1\\">\\n                    <mxGeometry x=\\"240\\" y=\\"170\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/>\\n                </mxCell>\\n            </root>\\n        </mxGraphModel>\\n    </diagram><diagram id=\\"44PLLl0pgulDx2n2xTWC\\" name=\\"Type System\\">\\n        <mxGraphModel dx=\\"767\\" dy=\\"620\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\">\\n            <root>\\n                <mxCell id=\\"0\\"/>\\n                <mxCell id=\\"1\\" parent=\\"0\\"/>\\n                <mxCell id=\\"jTONh3Pudjw2xIwc2DDu-1\\" value=\\"classDiagram&#10;    class TypeSystem {&#10;        +register_type(name, validator, serializer)&#10;        +validate(value, type_def)&#10;        +parse_type_string(type_str)&#10;        -_validate_complex_type(value, type_def)&#10;    }&#10;&#10;    class TypeDefinition {&#10;        +name: str&#10;        +validators: List&#10;        +serializers: Optional&#10;        +validate(value)&#10;        +serialize(value)&#10;    }&#10;&#10;    class DeclarativeAgent {&#10;        +input: str&#10;        +output: str&#10;        +tools: List&#10;        +validate_input(value)&#10;        +validate_output(value)&#10;    }&#10;&#10;    class Validator {&#10;        +validate(value)&#10;        +coerce(value)&#10;    }&#10;&#10;    TypeSystem --&gt; TypeDefinition : manages&#10;    DeclarativeAgent --&gt; TypeSystem : uses&#10;    TypeDefinition --&gt; Validator : uses&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" vertex=\\"1\\" parent=\\"1\\">\\n                    <mxGeometry x=\\"242\\" y=\\"169\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/>\\n                </mxCell>\\n            </root>\\n        </mxGraphModel>\\n    </diagram></mxfile>"}',
-            cls="mxgraph",
-        ),
-        Script(type="text/javascript", src="https://viewer.diagrams.net/js/viewer-static.min.js"),
-    )

flock/app/components/charts/core_architecture.py

@@ -1,14 +0,0 @@
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-
-def CoreArchitectureChart():
-    return Div(
-        Div(
-            style="max-width:100%;border:1px solid transparent;",
-            data_mxgraph='{"highlight":"#0000ff","nav":true,"resize":true,"page":0,"toolbar":"pages zoom layers tags lightbox","edit":"_blank","xml":"<mxfile><diagram id=\\"l7_B5a2V6sOU66k4eApJ\\" name=\\"Core Architecture\\"><mxGraphModel dx=\\"1139\\" dy=\\"934\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#FFFFFF\\" math=\\"0\\" shadow=\\"1\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"3\\" value=\\"graph TB&#10;    subgraph User Application&#10;        UA[User Code] --&gt; |Uses| SM[Flock Manager]&#10;    end&#10;&#10;    subgraph Flock Core&#10;        SM --&gt; |Manages| AR[Agent Registry]&#10;        SM --&gt; |Executes| WF[Workflow System]&#10;        &#10;        subgraph Agents&#10;            AR --&gt; |Registers| DA[Declarative Agent]&#10;            DA --&gt; |Uses| TS[Type System]&#10;            DA --&gt; |Uses| TM[Tool Manager]&#10;        end&#10;        &#10;        subgraph Workflow&#10;            WF --&gt; |Runs| AC[Activities]&#10;            WF --&gt; |Uses| TW[Temporal Worker]&#10;            AC --&gt; |Executes| DA&#10;        end&#10;    end&#10;&#10;    subgraph External Systems&#10;        TW --&gt; |Connects to| TS1[Temporal Server]&#10;        TM --&gt; |Integrates| T1[Web Search]&#10;        TM --&gt; |Integrates| T2[Code Eval]&#10;        TM --&gt; |Integrates| T3[Math Tools]&#10;        DA --&gt; |Uses| LLM[LLM Provider]&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef external fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef user fill:#bfb,stroke:#333,stroke-width:2px&#10;    &#10;    class SM,AR,DA,WF,AC,TM,TS core&#10;    class TS1,T1,T2,T3,LLM external&#10;    class UA user&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;rounded=1;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"200\\" y=\\"310\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"m33Os__FMXyp1zJ4IDTH\\" name=\\"Agent Workflow\\"><mxGraphModel dx=\\"1139\\" dy=\\"934\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"Yf0mmGmI6B4_u023lZ5C-1\\" value=\\"sequenceDiagram&#10;    participant User&#10;    participant Flock&#10;    participant Agent&#10;    participant Tools&#10;    participant LLM&#10;    participant Temporal&#10;&#10;    User-&gt;&gt;Flock: Create Agent&#10;    Flock-&gt;&gt;Agent: Initialize&#10;    User-&gt;&gt;Flock: activate(agent, input)&#10;    &#10;    alt Local Debug Mode&#10;        Flock-&gt;&gt;Agent: Execute Directly&#10;    else Production Mode&#10;        Flock-&gt;&gt;Temporal: Start Workflow&#10;        Temporal-&gt;&gt;Agent: Execute via Activity&#10;    end&#10;&#10;    loop Agent Execution&#10;        Agent-&gt;&gt;LLM: Process Input&#10;        opt Tool Usage&#10;            Agent-&gt;&gt;Tools: Execute Tool&#10;            Tools--&gt;&gt;Agent: Tool Result&#10;        end&#10;        Agent-&gt;&gt;LLM: Generate Output&#10;    end&#10;&#10;    alt Has Hand-off&#10;        Agent-&gt;&gt;Flock: Hand off to Next Agent&#10;        Flock-&gt;&gt;Agent: Start Next Agent&#10;    else No Hand-off&#10;        Agent--&gt;&gt;Flock: Return Result&#10;    end&#10;&#10;    Flock--&gt;&gt;User: Return Final Result\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"275\\" y=\\"114\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"zsmzvY-bLYlccnSXdfzv\\" name=\\"Temporal Workflow\\">\\n        <mxGraphModel dx=\\"205\\" dy=\\"165\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\">\\n            <root>\\n                <mxCell id=\\"0\\"/>\\n                <mxCell id=\\"1\\" parent=\\"0\\"/>\\n                <mxCell id=\\"LGo0nXY-PDX6Si-UCiUW-1\\" value=\\"graph TB&#10;    subgraph Temporal Integration&#10;        WF[Workflow System] --&gt; |Manages| TW[Temporal Worker]&#10;        TW --&gt; |Executes| AC[Activities]&#10;        TW --&gt; |Connects to| TS[Temporal Server]&#10;        &#10;        subgraph State Management&#10;            TS --&gt; |Manages| WS[Workflow State]&#10;            WS --&gt; |Tracks| AS[Agent State]&#10;            WS --&gt; |Tracks| TS1[Tool State]&#10;            WS --&gt; |Tracks| ES[Error State]&#10;        end&#10;&#10;        subgraph Reliability Features&#10;            TS --&gt; |Provides| R1[Automatic Retries]&#10;            TS --&gt; |Provides| R2[Error Recovery]&#10;            TS --&gt; |Provides| R3[State Persistence]&#10;            TS --&gt; |Provides| R4[Workflow History]&#10;        end&#10;&#10;        subgraph Monitoring&#10;            TS --&gt; |Enables| M1[Execution Metrics]&#10;            TS --&gt; |Enables| M2[Error Tracking]&#10;            TS --&gt; |Enables| M3[Performance Stats]&#10;            TS --&gt; |Enables| M4[Workflow Visualization]&#10;        end&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef state fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef feature fill:#bfb,stroke:#333,stroke-width:2px&#10;    classDef monitor fill:#fbb,stroke:#333,stroke-width:2px&#10;&#10;    class WF,TW,AC,TS core&#10;    class WS,AS,TS1,ES state&#10;    class R1,R2,R3,R4 feature&#10;    class M1,M2,M3,M4 monitor&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" vertex=\\"1\\" parent=\\"1\\">\\n                    <mxGeometry x=\\"242\\" y=\\"169\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/>\\n                </mxCell>\\n            </root>\\n        </mxGraphModel>\\n    </diagram><diagram id=\\"FU8wRJNSLGF58lYnAYQQ\\" name=\\"Tool System\\">\\n        <mxGraphModel dx=\\"307\\" dy=\\"248\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\">\\n            <root>\\n                <mxCell id=\\"0\\"/>\\n                <mxCell id=\\"1\\" parent=\\"0\\"/>\\n                <mxCell id=\\"T-pgXY2fyKOihok5m5tA-1\\" value=\\"graph TB&#10;    subgraph Tool Management&#10;        TM[Tool Manager] --&gt; |Manages| TR[Tool Registry]&#10;        TR --&gt; |Registers| T1[Web Search Tool]&#10;        TR --&gt; |Registers| T2[Code Eval Tool]&#10;        TR --&gt; |Registers| T3[Math Tool]&#10;        &#10;        TM --&gt; |Provides| TI[Tool Interface]&#10;        TI --&gt; |Used by| DA[Declarative Agent]&#10;    end&#10;&#10;    subgraph Tool Execution&#10;        T1 --&gt; |Uses| WS[Web Search API]&#10;        T2 --&gt; |Uses| CE[Code Executor]&#10;        T3 --&gt; |Uses| ME[Math Engine]&#10;        &#10;        WS --&gt; |Returns| R1[Search Results]&#10;        CE --&gt; |Returns| R2[Execution Results]&#10;        ME --&gt; |Returns| R3[Math Results]&#10;    end&#10;&#10;    subgraph Error Handling&#10;        TM --&gt; |Manages| EH[Error Handler]&#10;        EH --&gt; |Handles| E1[API Errors]&#10;        EH --&gt; |Handles| E2[Execution Errors]&#10;        EH --&gt; |Handles| E3[Validation Errors]&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef tool fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef handler fill:#bfb,stroke:#333,stroke-width:2px&#10;&#10;    class TM,TR,TI core&#10;    class T1,T2,T3,WS,CE,ME tool&#10;    class EH,E1,E2,E3 handler\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" vertex=\\"1\\" parent=\\"1\\">\\n                    <mxGeometry x=\\"240\\" y=\\"170\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/>\\n                </mxCell>\\n            </root>\\n        </mxGraphModel>\\n    </diagram><diagram id=\\"44PLLl0pgulDx2n2xTWC\\" name=\\"Type System\\">\\n        <mxGraphModel dx=\\"767\\" dy=\\"620\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\">\\n            <root>\\n                <mxCell id=\\"0\\"/>\\n                <mxCell id=\\"1\\" parent=\\"0\\"/>\\n                <mxCell id=\\"jTONh3Pudjw2xIwc2DDu-1\\" value=\\"classDiagram&#10;    class TypeSystem {&#10;        +register_type(name, validator, serializer)&#10;        +validate(value, type_def)&#10;        +parse_type_string(type_str)&#10;        -_validate_complex_type(value, type_def)&#10;    }&#10;&#10;    class TypeDefinition {&#10;        +name: str&#10;        +validators: List&#10;        +serializers: Optional&#10;        +validate(value)&#10;        +serialize(value)&#10;    }&#10;&#10;    class DeclarativeAgent {&#10;        +input: str&#10;        +output: str&#10;        +tools: List&#10;        +validate_input(value)&#10;        +validate_output(value)&#10;    }&#10;&#10;    class Validator {&#10;        +validate(value)&#10;        +coerce(value)&#10;    }&#10;&#10;    TypeSystem --&gt; TypeDefinition : manages&#10;    DeclarativeAgent --&gt; TypeSystem : uses&#10;    TypeDefinition --&gt; Validator : uses&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" vertex=\\"1\\" parent=\\"1\\">\\n                    <mxGeometry x=\\"242\\" y=\\"169\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/>\\n                </mxCell>\\n            </root>\\n        </mxGraphModel>\\n    </diagram></mxfile>"}',
-            cls="mxgraph",
-        ),
-        Script(type="text/javascript", src="https://viewer.diagrams.net/js/viewer-static.min.js"),
-    )

flock/app/components/charts/tool_system.py

@@ -1,14 +0,0 @@
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-
-def ToolSystemChart():
-    return Div(
-        Div(
-            style="max-width:100%;border:1px solid transparent;",
-            data_mxgraph='{"highlight":"#0000ff","nav":true,"resize":true,"page":3,"toolbar":"pages zoom layers tags lightbox","edit":"_blank","xml":"<mxfile><diagram id=\\"l7_B5a2V6sOU66k4eApJ\\" name=\\"Core Architecture\\"><mxGraphModel dx=\\"380\\" dy=\\"311\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#FFFFFF\\" math=\\"0\\" shadow=\\"0\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"3\\" value=\\"graph TB&#10;    subgraph User Application&#10;        UA[User Code] --&gt; |Uses| SM[Flock Manager]&#10;    end&#10;&#10;    subgraph Flock Core&#10;        SM --&gt; |Manages| AR[Agent Registry]&#10;        SM --&gt; |Executes| WF[Workflow System]&#10;        &#10;        subgraph Agents&#10;            AR --&gt; |Registers| DA[Declarative Agent]&#10;            DA --&gt; |Uses| TS[Type System]&#10;            DA --&gt; |Uses| TM[Tool Manager]&#10;        end&#10;        &#10;        subgraph Workflow&#10;            WF --&gt; |Runs| AC[Activities]&#10;            WF --&gt; |Uses| TW[Temporal Worker]&#10;            AC --&gt; |Executes| DA&#10;        end&#10;    end&#10;&#10;    subgraph External Systems&#10;        TW --&gt; |Connects to| TS1[Temporal Server]&#10;        TM --&gt; |Integrates| T1[Web Search]&#10;        TM --&gt; |Integrates| T2[Code Eval]&#10;        TM --&gt; |Integrates| T3[Math Tools]&#10;        DA --&gt; |Uses| LLM[LLM Provider]&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef external fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef user fill:#bfb,stroke:#333,stroke-width:2px&#10;    &#10;    class SM,AR,DA,WF,AC,TM,TS core&#10;    class TS1,T1,T2,T3,LLM external&#10;    class UA user&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;rounded=1;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"200\\" y=\\"310\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"m33Os__FMXyp1zJ4IDTH\\" name=\\"Agent Workflow\\"><mxGraphModel dx=\\"316\\" dy=\\"259\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"0\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"Yf0mmGmI6B4_u023lZ5C-1\\" value=\\"sequenceDiagram&#10;    participant User&#10;    participant Flock&#10;    participant Agent&#10;    participant Tools&#10;    participant LLM&#10;    participant Temporal&#10;&#10;    User-&gt;&gt;Flock: Create Agent&#10;    Flock-&gt;&gt;Agent: Initialize&#10;    User-&gt;&gt;Flock: activate(agent, input)&#10;    &#10;    alt Local Debug Mode&#10;        Flock-&gt;&gt;Agent: Execute Directly&#10;    else Production Mode&#10;        Flock-&gt;&gt;Temporal: Start Workflow&#10;        Temporal-&gt;&gt;Agent: Execute via Activity&#10;    end&#10;&#10;    loop Agent Execution&#10;        Agent-&gt;&gt;LLM: Process Input&#10;        opt Tool Usage&#10;            Agent-&gt;&gt;Tools: Execute Tool&#10;            Tools--&gt;&gt;Agent: Tool Result&#10;        end&#10;        Agent-&gt;&gt;LLM: Generate Output&#10;    end&#10;&#10;    alt Has Hand-off&#10;        Agent-&gt;&gt;Flock: Hand off to Next Agent&#10;        Flock-&gt;&gt;Agent: Start Next Agent&#10;    else No Hand-off&#10;        Agent--&gt;&gt;Flock: Return Result&#10;    end&#10;&#10;    Flock--&gt;&gt;User: Return Final Result\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"275\\" y=\\"114\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"zsmzvY-bLYlccnSXdfzv\\" name=\\"Temporal Workflow\\"><mxGraphModel dx=\\"1139\\" dy=\\"934\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"LGo0nXY-PDX6Si-UCiUW-1\\" value=\\"graph TB&#10;    subgraph Temporal Integration&#10;        WF[Workflow System] --&gt; |Manages| TW[Temporal Worker]&#10;        TW --&gt; |Executes| AC[Activities]&#10;        TW --&gt; |Connects to| TS[Temporal Server]&#10;        &#10;        subgraph State Management&#10;            TS --&gt; |Manages| WS[Workflow State]&#10;            WS --&gt; |Tracks| AS[Agent State]&#10;            WS --&gt; |Tracks| TS1[Tool State]&#10;            WS --&gt; |Tracks| ES[Error State]&#10;        end&#10;&#10;        subgraph Reliability Features&#10;            TS --&gt; |Provides| R1[Automatic Retries]&#10;            TS --&gt; |Provides| R2[Error Recovery]&#10;            TS --&gt; |Provides| R3[State Persistence]&#10;            TS --&gt; |Provides| R4[Workflow History]&#10;        end&#10;&#10;        subgraph Monitoring&#10;            TS --&gt; |Enables| M1[Execution Metrics]&#10;            TS --&gt; |Enables| M2[Error Tracking]&#10;            TS --&gt; |Enables| M3[Performance Stats]&#10;            TS --&gt; |Enables| M4[Workflow Visualization]&#10;        end&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef state fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef feature fill:#bfb,stroke:#333,stroke-width:2px&#10;    classDef monitor fill:#fbb,stroke:#333,stroke-width:2px&#10;&#10;    class WF,TW,AC,TS core&#10;    class WS,AS,TS1,ES state&#10;    class R1,R2,R3,R4 feature&#10;    class M1,M2,M3,M4 monitor&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"242\\" y=\\"169\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"FU8wRJNSLGF58lYnAYQQ\\" name=\\"Tool System\\"><mxGraphModel dx=\\"316\\" dy=\\"259\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"0\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"T-pgXY2fyKOihok5m5tA-1\\" value=\\"graph TB&#10;    subgraph Tool Management&#10;        TM[Tool Manager] --&gt; |Manages| TR[Tool Registry]&#10;        TR --&gt; |Registers| T1[Web Search Tool]&#10;        TR --&gt; |Registers| T2[Code Eval Tool]&#10;        TR --&gt; |Registers| T3[Math Tool]&#10;        &#10;        TM --&gt; |Provides| TI[Tool Interface]&#10;        TI --&gt; |Used by| DA[Declarative Agent]&#10;    end&#10;&#10;    subgraph Tool Execution&#10;        T1 --&gt; |Uses| WS[Web Search API]&#10;        T2 --&gt; |Uses| CE[Code Executor]&#10;        T3 --&gt; |Uses| ME[Math Engine]&#10;        &#10;        WS --&gt; |Returns| R1[Search Results]&#10;        CE --&gt; |Returns| R2[Execution Results]&#10;        ME --&gt; |Returns| R3[Math Results]&#10;    end&#10;&#10;    subgraph Error Handling&#10;        TM --&gt; |Manages| EH[Error Handler]&#10;        EH --&gt; |Handles| E1[API Errors]&#10;        EH --&gt; |Handles| E2[Execution Errors]&#10;        EH --&gt; |Handles| E3[Validation Errors]&#10;    end&#10;&#10;    classDef core fill:#f9f,stroke:#333,stroke-width:2px&#10;    classDef tool fill:#bbf,stroke:#333,stroke-width:2px&#10;    classDef handler fill:#bfb,stroke:#333,stroke-width:2px&#10;&#10;    class TM,TR,TI core&#10;    class T1,T2,T3,WS,CE,ME tool&#10;    class EH,E1,E2,E3 handler\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"224\\" y=\\"232\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram><diagram id=\\"44PLLl0pgulDx2n2xTWC\\" name=\\"Type System\\"><mxGraphModel dx=\\"380\\" dy=\\"311\\" grid=\\"0\\" gridSize=\\"10\\" guides=\\"1\\" tooltips=\\"1\\" connect=\\"1\\" arrows=\\"1\\" fold=\\"1\\" page=\\"1\\" pageScale=\\"1\\" pageWidth=\\"850\\" pageHeight=\\"1100\\" background=\\"#ffffff\\" math=\\"0\\" shadow=\\"1\\"><root><mxCell id=\\"0\\"/><mxCell id=\\"1\\" parent=\\"0\\"/><mxCell id=\\"jTONh3Pudjw2xIwc2DDu-1\\" value=\\"classDiagram&#10;    class TypeSystem {&#10;        +register_type(name, validator, serializer)&#10;        +validate(value, type_def)&#10;        +parse_type_string(type_str)&#10;        -_validate_complex_type(value, type_def)&#10;    }&#10;&#10;    class TypeDefinition {&#10;        +name: str&#10;        +validators: List&#10;        +serializers: Optional&#10;        +validate(value)&#10;        +serialize(value)&#10;    }&#10;&#10;    class DeclarativeAgent {&#10;        +input: str&#10;        +output: str&#10;        +tools: List&#10;        +validate_input(value)&#10;        +validate_output(value)&#10;    }&#10;&#10;    class Validator {&#10;        +validate(value)&#10;        +coerce(value)&#10;    }&#10;&#10;    TypeSystem --&gt; TypeDefinition : manages&#10;    DeclarativeAgent --&gt; TypeSystem : uses&#10;    TypeDefinition --&gt; Validator : uses&#10;&#10;\\" style=\\"shadow=0;dashed=0;align=left;strokeWidth=1;shape=mxgraph.mermaid.abstract.mermaid;labelBackgroundColor=#ffffff;noLabel=1;theme=default;\\" parent=\\"1\\" vertex=\\"1\\"><mxGeometry x=\\"242\\" y=\\"169\\" width=\\"300\\" height=\\"300\\" as=\\"geometry\\"/></mxCell></root></mxGraphModel></diagram></mxfile>"}',
-            cls="mxgraph",
-        ),
-        Script(type="text/javascript", src="https://viewer.diagrams.net/js/viewer-static.min.js"),
-    )

flock/app/components/history_grid.py

@@ -1,168 +0,0 @@
-"""Agent History Explorer built with MonsterUI"""
-
-import json
-from datetime import datetime
-
-from fasthtml.common import *
-from monsterui.all import *
-
-
-def load_history(page=1, per_page=10, search=None):
-    with open("data/history.json") as f:
-        data = json.load(f)
-
-    if search:
-        search = search.lower()
-        data = [
-            d
-            for d in data
-            if search in d["agent_name"].lower() or search in d["location"].lower() or search in d["date"].lower()
-        ]
-
-    total = len(data)
-    pages = (total + per_page - 1) // per_page
-    start = (page - 1) * per_page
-    return {"data": data[start : start + per_page], "total": total, "pages": pages, "page": page}
-
-
-def format_date(iso_date):
-    return datetime.fromisoformat(iso_date).strftime("%b %d, %Y %H:%M")
-
-
-def json_preview(value):
-    return Pre(json.dumps(value, indent=2), cls="text-xs p-2 bg-muted rounded-md max-h-40 overflow-auto")
-
-
-def header_render(col):
-    return Th(col, cls="p-2 text-left")
-
-
-def cell_render(col, val):
-    """Modified cell renderer that only uses column value"""
-    match col:
-        case "Agent":
-            return Td(cls="p-2 font-medium")(Div(val))
-        case "Date":
-            return Td(cls="p-2 text-sm")(format_date(val))
-        case "Location":
-            return Td(cls="p-2 capitalize")(val)  # val is already location string
-        case "Input" | "Output":
-            return Td(cls="p-2")(json_preview(val))
-        case "Details":
-            # val contains the full record here
-            return Td(cls="p-2")(Button("View", cls=ButtonT.primary, uk_toggle=f"target: #details-{val['agent_id']}"))
-
-
-def details_modal(record):
-    return Modal(
-        Div(cls="p-6 space-y-4")(
-            ModalTitle(f"{record['agent_name']} - {format_date(record['date'])}"),
-            Grid(
-                Div(cls="space-y-2")(H4("Input Details", cls="text-sm font-medium"), json_preview(record["input"])),
-                Div(cls="space-y-2")(H4("Output Details", cls="text-sm font-medium"), json_preview(record["output"])),
-            ),
-            DivRAligned(ModalCloseButton("Close", cls=ButtonT.ghost)),
-        ),
-        id=f"details-{record['agent_id']}",
-    )
-
-
-def get_history(page: int = 1, per_page: int = 5, search: str = None, reduced=False):
-    history = load_history(page, per_page, search)
-
-    controls = DivFullySpaced(cls="mt-8")(
-        Div(cls="flex gap-4 items-center")(
-            Input(
-                placeholder="Search agents...",
-                value=search,
-                name="search",
-                hx_get="/history",
-                hx_trigger="keyup changed delay:500ms",
-                hx_target="#history-content",
-                hx_include="[name='per_page']",
-                cls="w-64",
-            ),
-            Select(
-                Option("5", value="5"),
-                Option("10", value="10"),
-                Option("20", value="20"),
-                name="per_page",
-                value=str(per_page),
-                hx_get="/history",
-                hx_trigger="change",
-                hx_target="#history-content",
-                cls="w-24",
-            ),
-        )
-    )
-
-    if reduced:
-        header_data = ["Agent", "Date", "Details"]
-        bodydata = [
-            {
-                "Agent": d["agent_name"],
-                "Date": d["date"],
-                "Details": d,  # Store full record here
-            }
-            for d in history["data"]
-        ]
-    else:
-        header_data = ["Agent", "Date", "Input", "Output", "Details"]
-        bodydata = [
-            {
-                "Agent": d["agent_name"],
-                "Date": d["date"],
-                # "Location": d["input"]["location"],  # Pre-extract location
-                "Input": d["input"],
-                "Output": d["output"],
-                "Details": d,  # Store full record here
-            }
-            for d in history["data"]
-        ]
-
-    table = TableFromDicts(
-        header_data=header_data,
-        body_data=bodydata,
-        body_cell_render=cell_render,
-        header_cell_render=header_render,
-        cls=TableT.responsive,
-    )
-
-    footer = DivFullySpaced(cls="mt-4")(
-        Div(
-            f"Showing {min(history['total'], per_page)} of {history['total']} records",
-            cls="text-sm text-muted-foreground",
-        ),
-        Div(cls="flex items-center gap-4")(
-            Button(
-                "< Prev",
-                hx_get=f"/history?page={history['page'] - 1}",
-                hx_target="#history-content",
-                disabled=history["page"] == 1,
-                cls=ButtonT.primary,
-            ),
-            Span(f"Page {history['page']} of {history['pages']}"),
-            Button(
-                "Next >",
-                hx_get=f"/history?page={history['page'] + 1}",
-                hx_target="#history-content",
-                disabled=history["page"] == history["pages"],
-                cls=ButtonT.primary,
-            ),
-        ),
-    )
-
-    return Div(id="history-content")(controls, table, footer, *[details_modal(d) for d in history["data"]])
-
-
-def HistoryGrid(reduced=False):
-    if reduced:
-        return get_history(reduced)
-
-    return Div(cls="flex flex-col")(
-        Div(cls="px-4 py-2 ")(
-            H3("Agent History Explorer"),
-            P("Review historical agent executions and their outcomes", cls=TextFont.muted_sm),
-        ),
-        get_history(reduced),
-    )

flock/app/components/history_grid_alt.py

@@ -1,189 +0,0 @@
-"""Agent History Explorer built with MonsterUI"""
-
-import json
-from datetime import datetime
-
-from fasthtml.common import *
-from monsterui.all import *
-
-
-def format_date(iso_date):
-    return datetime.fromisoformat(iso_date).strftime("%b %d, %Y %H:%M")
-
-
-def json_preview(value):
-    return Pre(json.dumps(value, indent=2), cls="text-xs p-2 bg-muted rounded-md max-h-40 overflow-auto")
-
-
-def header_render(col):
-    return Th(col, cls="p-2 text-left")
-
-
-def cell_render(col, val):
-    """Modified cell renderer that only uses column value"""
-    match col:
-        case "Agent":
-            return Td(cls="p-2 font-medium")(Div(val))
-        case "Date":
-            return Td(cls="p-2 text-sm")(format_date(val))
-        case "Location":
-            return Td(cls="p-2 capitalize")(val)  # val is already location string
-        case "Input" | "Output":
-            return Td(cls="p-2")(json_preview(val))
-        case "Details":
-            # val contains the full record here
-            return Td(cls="p-2")(Button("View", cls=ButtonT.primary, uk_toggle=f"target: #details-{val['agent_id']}"))
-
-
-def load_history(page=1, per_page=10, search=None):
-    with open("data/history.json") as f:
-        data = json.load(f)
-
-    # Full-text search across all fields
-    if search:
-        search = search.lower()
-        data = [
-            d
-            for d in data
-            if any(search in str(v).lower() for v in d.values())
-            or any(search in str(v).lower() for sub in [d["input"], d["output"]] for v in sub.values())
-        ]
-
-    total = len(data)
-    pages = (total + per_page - 1) // per_page
-    start = (page - 1) * per_page
-    return {"data": data[start : start + per_page], "total": total, "pages": pages, "page": page}
-
-
-def json_tree(value, depth=0):
-    if isinstance(value, dict):
-        return Div(cls=f"ml-{depth * 2} space-y-1")(
-            *[Details(Summary(k, cls="inline-flex items-center"), json_tree(v, depth + 1)) for k, v in value.items()]
-        )
-    elif isinstance(value, list):
-        return Div(cls=f"ml-{depth * 2} space-y-1")(
-            *[
-                Div(cls="flex items-center gap-2")(Span("•", cls="text-muted-foreground"), json_tree(item, depth + 1))
-                for item in value
-            ]
-        )
-    return Span(str(value), cls="text-muted-foreground")
-
-
-def render_cell(col, val):
-    match col:
-        case "date":
-            return datetime.fromisoformat(val).strftime("%b %d, %Y %H:%M")
-        case "input" | "output":
-            return Div(cls="max-w-[300px] overflow-auto p-2 bg-muted rounded-md")(json_tree(val))
-        case "_expand":
-            return Button("Expand", cls=ButtonT.primary, uk_toggle=f"target: #details-{val['agent_id']}")
-        case _:
-            return val if isinstance(val, str) else json.dumps(val, default=str)
-
-
-def details_modal(record):
-    return Modal(
-        Div(cls="p-6 space-y-4")(
-            ModalTitle(f"Agent Execution Details - {record['agent_id']}"),
-            Div(cls="space-y-4")(
-                Div(cls="grid grid-cols-2 gap-4")(
-                    Div(cls="space-y-2")(H4("Input", cls="text-sm font-medium"), json_tree(record["input"])),
-                    Div(cls="space-y-2")(H4("Output", cls="text-sm font-medium"), json_tree(record["output"])),
-                ),
-                Div(cls="space-y-2")(
-                    H4("Metadata", cls="text-sm font-medium"),
-                    json_tree({k: v for k, v in record.items() if k not in ["input", "output"]}),
-                ),
-            ),
-            DivRAligned(ModalCloseButton("Close", cls=ButtonT.ghost)),
-        ),
-        id=f"details-{record['agent_id']}",
-    )
-
-
-def Pagination(current_page, total_pages, hx_get, hx_target):
-    return Div(cls="flex items-center gap-2")(
-        Button(
-            "Previous",
-            disabled=current_page == 1,
-            hx_get=f"{hx_get}?page={current_page - 1}",
-            hx_target=hx_target,
-            cls=ButtonT.primary,
-        ),
-        Span(f"Page {current_page} of {total_pages}", cls="text-sm"),
-        Button(
-            "Next",
-            disabled=current_page >= total_pages,
-            hx_get=f"{hx_get}?page={current_page + 1}",
-            hx_target=hx_target,
-            cls=ButtonT.primary,
-        ),
-    )
-
-
-def get_history(page: int = 1, per_page: int = 10, search: str = None):
-    history = load_history(page, per_page, search)
-
-    # Dynamic columns from first record (if exists)
-    columns = []
-    if history["data"]:
-        sample = history["data"][0]
-        columns = [k for k in sample.keys() if k not in ["input", "output", "agent_id"]]
-        columns += ["input", "output", "_expand"]
-
-    controls = DivFullySpaced(cls="mt-8")(
-        Input(
-            placeholder="Search history...",
-            value=search,
-            name="search",
-            hx_get="/history",
-            hx_trigger="keyup changed delay:500ms",
-            hx_target="#history-content",
-            hx_include="[name='per_page']",
-            cls="w-64",
-        ),
-        Select(
-            *[Option(str(n), value=str(n)) for n in [5, 10, 20, 50]],
-            name="per_page",
-            value=str(per_page),
-            hx_get="/history",
-            hx_trigger="change",
-            hx_target="#history-content",
-            cls="w-24",
-        ),
-    )
-
-    table = TableFromDicts(
-        header_data=columns,
-        body_data=[{**d, "_expand": d} for d in history["data"]],
-        body_cell_render=lambda col, val: Td(render_cell(col, val)),
-        header_cell_render=lambda col: Th(col.replace("_", " ").title(), cls="p-2 text-left"),
-        cls=f"{TableT.responsive} {TableT.hover}",
-    )
-
-    footer = DivFullySpaced(cls="mt-4")(
-        Div(
-            f"Showing {(page - 1) * per_page + 1}-{min(page * per_page, history['total'])} of {history['total']} records",
-            cls="text-sm text-muted-foreground",
-        ),
-        Pagination(current_page=page, total_pages=history["pages"], hx_get="/history", hx_target="#history-content"),
-    )
-
-    return Div(id="history-content")(
-        controls,
-        table if history["data"] else P("No records found", cls=TextFont.muted),
-        footer,
-        *[details_modal(d) for d in history["data"]],
-    )
-
-
-def HistoryGrid(reduced=False):
-    return Container(
-        Div(cls="space-y-4")(
-            H1("Agent History Explorer"),
-            P("Inspect agent executions with dynamic JSON exploration", cls=TextFont.muted_sm),
-        ),
-        get_history(),
-        cls="p-8",
-    )

flock/app/components/sidebar.py

@@ -1,19 +0,0 @@
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-
-def SidebarLi(icon, title=None, href=None):
-    if icon == "---":
-        return Li(Hr())
-    return Li(
-        AX(DivLAligned(Span(UkIcon(icon)), Span(title)), hx_get=href, hx_target="#main-grid", hx_swap="outerHTML")
-    )
-
-
-def Sidebar(sidebar):
-    return NavContainer(
-        NavHeaderLi(H1("Flock UI", cls="text-xxl font-semibold")),
-        *[SidebarLi(icon, title, href) for icon, title, href in sidebar],
-        cls="space-y-6 mt-3",
-    )

flock/app/components/theme.py

@@ -1,9 +0,0 @@
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-
-def ThemeDialog():
-    from fasthtml.components import Uk_theme_switcher
-
-    return Uk_theme_switcher()

flock/app/components/util.py

@@ -1,18 +0,0 @@
-from datetime import datetime
-
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-
-def format_date(date_str):
-    date_obj = datetime.fromisoformat(date_str)
-    return date_obj.strftime("%Y-%m-%d %I:%M %p")
-
-
-def IconNavItem(*d):
-    return [Li(A(UkIcon(o[0], uk_tooltip=o[1]))) for o in d]
-
-
-def IconNav(*c, cls=""):
-    return Ul(cls=f"uk-iconnav {cls}")(*c)

flock/app/hive_app.py

@@ -1,118 +0,0 @@
-from fasthtml.common import *
-from fasthtml.svg import *
-from monsterui.all import *
-
-from flock.app.components import HistoryGrid, Sidebar
-from flock.app.modules import AgentContent, AgentDetailView, Playground, Settings, agent_data
-from flock.app.modules.about import AboutPage
-
-hdrs = Theme.blue.headers()
-
-app, rt = fast_app(hdrs=hdrs, live=True)
-
-##############################
-# Sidebar
-##############################
-
-sidebar = (
-    ("layout-dashboard", "Dashboard", "/"),
-    ("---", "", ""),
-    ("bot", "Agents", "/agents"),
-    ("server", "Agent Systems", "/systems"),
-    ("scroll", "History", "/history"),
-    ("---", "", ""),
-    ("wrench", "Tools", "/tools"),
-    ("test-tube", "Playground", "/playground"),
-    ("---", "", ""),
-    ("settings", "Settings", "/settings"),
-    ("info", "About", "/about"),
-)
-
-
-##############################
-# MAIN
-##############################
-
-
-@rt
-def index():
-    return (
-        Title("Flock UI"),
-        Container(
-            Grid(
-                Div(Sidebar(sidebar), cls="col-span-1 w-48 flex"),
-                Grid(
-                    Div(AgentContent(), cls="col-span-2"),
-                    Div(AgentDetailView(agent_data[0]), cls="col-span-3"),
-                    cols=5,
-                    cls="col-span-5",
-                    id="main-grid",
-                ),
-                cols_sm=2,
-                cols_md=2,
-                cols_lg=6,
-                cols_xl=6,
-                gap=5,
-                cls="flex-1",
-            ),
-            cls=("flex", ContainerT.xl),
-        ),
-    )
-
-
-@rt("/history")
-def get():
-    return Grid(
-        Div(HistoryGrid(), cls="col-span-5"),
-        cols=5,
-        cls="col-span-5",
-        id="main-grid",
-    )
-
-
-@rt("/playground")
-def get():
-    return Grid(
-        Div(Playground(), cls="col-span-5"),  # noqa: F405
-        cols=5,
-        cls="col-span-5",
-        id="main-grid",
-    )
-
-
-@rt("/settings")
-def get():
-    return Grid(
-        Div(Settings(), cls="col-span-5"),
-        cols=5,
-        cls="col-span-5",
-        id="main-grid",
-    )
-
-
-@rt("/agents")
-def get():
-    return Grid(
-        Div(AgentContent(), cls="col-span-2"),
-        Div(AgentDetailView(agent=agent_data[0]), cls="col-span-3"),
-        cols=5,
-        cls="col-span-5",
-        id="main-grid",
-    )
-
-
-@rt("/about")
-def get():
-    return Grid(
-        Div(AboutPage(), cls="col-span-5"),
-        cols=5,
-        cls="col-span-5",
-        id="main-grid",
-    )
-
-
-serve()
-
-
-def main():
-    serve()