graph TB
    subgraph "Layer 3: GraphToolkit Meta-Framework"
        WF[Workflow Engine]
        PS[Phase System]
        AN[Atomic Nodes]
        SM[State Manager]
    end
    
    subgraph "Layer 2: AgenToolkit Collections"
        AUTH[Auth Toolkit]
        STOR[Storage Toolkit]
        HTTP[HTTP Toolkit]
        CRYP[Crypto Toolkit]
        METR[Metrics Toolkit]
    end
    
    subgraph "Layer 1: AgenTool Framework"
        CORE[Core Engine]
        ROUT[Router]
        VAL[Validator]
        INJ[Injector]
    end
    
    subgraph "Foundation: pydantic-ai"
        PA[pydantic-ai Agent]
        PM[Pydantic Models]
    end
    
    WF --> PS --> AN --> SM
    PS --> AUTH & STOR & HTTP
    
    AUTH & STOR & HTTP & CRYP & METR --> CORE
    CORE --> ROUT & VAL & INJ
    ROUT --> PA
    VAL --> PM
    
    style WF fill:#e1f5fe
    style AUTH fill:#fff3e0
    style CORE fill:#e8f5e9
    style PA fill:#f3e5f5

graph TB
    JSON[JSON String Input]
    JSON --> PARSE[Parse JSON]
    PARSE --> VALID[Pydantic Validation]
    VALID --> SCHEMA[Input Schema Object]
    SCHEMA --> OP[Extract Operation Field]
    OP --> ROUTE[Check Routing Config]
    ROUTE --> MAP[Find in Operation Map]
    MAP --> TOOL[Select Tool Function]
    TOOL --> TRANS[Apply Parameter Transform]
    TRANS --> ARGS[Prepare Tool Arguments]
    ARGS --> EXEC[Execute Tool Function]
    EXEC --> RES[Get Tool Result]
    RES --> OUT[Format as JSON]
    OUT --> RESP[Return Response]
    
    style JSON fill:#e3f2fd
    style RESP fill:#c8e6c9
    style VALID fill:#fff3e0
    style ROUTE fill:#ffebee
    style EXEC fill:#f3e5f5

graph TB
    subgraph "Input Schema"
        INPUT["{<br/>'operation': 'add',<br/>'a': 10,<br/>'b': 5<br/>}"]
    end
    
    subgraph "Routing Config"
        RC["operation_map = {<br/>'add': ('add_tool', transform_fn),<br/>'subtract': ('sub_tool', transform_fn)<br/>}"]
    end
    
    subgraph "Transformation"
        INPUT --> EXTRACT["Extract: operation='add'"]
        EXTRACT --> LOOKUP["Lookup: 'add' → 'add_tool'"]
        LOOKUP --> TRANSFORM["Transform: {a: 10, b: 5}"]
    end
    
    subgraph "Tool Execution"
        TRANSFORM --> TOOL["add_tool(ctx, a=10, b=5)"]
        TOOL --> RESULT["{'result': 15}"]
    end
    
    style INPUT fill:#e3f2fd
    style RESULT fill:#c8e6c9

sequenceDiagram
    participant User
    participant AuthAgent
    participant SessionAgent
    participant StorageAgent
    participant CryptoAgent
    participant Injector
    
    User->>AuthAgent: login(username, password)
    AuthAgent->>Injector: get('crypto')
    Injector-->>AuthAgent: CryptoAgent
    AuthAgent->>CryptoAgent: hash_password(password)
    CryptoAgent-->>AuthAgent: hashed_pwd
    
    AuthAgent->>Injector: get('storage_kv')
    Injector-->>AuthAgent: StorageAgent
    AuthAgent->>StorageAgent: get(user:username)
    StorageAgent-->>AuthAgent: user_data
    
    AuthAgent->>SessionAgent: create_session(user_id)
    SessionAgent->>StorageAgent: set(session:id, data, ttl=3600)
    StorageAgent-->>SessionAgent: stored
    
    SessionAgent-->>AuthAgent: session_token
    AuthAgent-->>User: {token, user_data}
    
    Note over Injector: Manages all agent<br/>dependencies and<br/>enables composition

graph TB
    subgraph "Workflow State"
        STATE["{<br/>domain: 'smoke',<br/>current_phase: 'analyzer',<br/>phase_outputs: {},<br/>quality_scores: {}<br/>}"]
    end
    
    subgraph "Phase: Ingredient Analyzer"
        A1[DependencyCheck] --> A2[LoadDependencies]
        A2 --> A3[TemplateRender]
        A3 --> A4[LLMCall]
        A4 --> A5[SchemaValidation]
        A5 --> A6[SaveOutput]
        A6 --> A7[QualityGate]
    end
    
    subgraph "Phase: Recipe Designer"
        B1[DependencyCheck] --> B2[LoadDependencies]
        B2 --> B3[TemplateRender]
        B3 --> B4[LLMCall]
        B4 --> B5[SchemaValidation]
        B5 --> B6[SaveOutput]
        B6 --> B7[QualityGate]
    end
    
    STATE --> A1
    A7 -->|Pass| B1
    A7 -->|Fail| REF1[Refinement]
    REF1 --> A3
    
    B7 -->|Pass| NEXT[Next Phase...]
    B7 -->|Fail| REF2[Refinement]
    REF2 --> B3
    
    style STATE fill:#e3f2fd
    style A4 fill:#fff3e0
    style B4 fill:#fff3e0
    style A7 fill:#ffebee
    style B7 fill:#ffebee

stateDiagram-v2
    [*] --> GenericPhaseNode
    GenericPhaseNode --> DependencyCheck: Start Phase
    
    state AtomicExecution {
        DependencyCheck --> LoadDependencies: deps exist
        LoadDependencies --> TemplateRender: data loaded
        TemplateRender --> LLMCall: prompt ready
        LLMCall --> SchemaValidation: response received
        SchemaValidation --> SaveOutput: valid schema
        SaveOutput --> StateUpdate: saved
        StateUpdate --> QualityGate: state updated
    }
    
    QualityGate --> NextPhase: quality passed
    QualityGate --> Refinement: quality failed
    Refinement --> TemplateRender: with feedback
    
    NextPhase --> GenericPhaseNode: more phases
    NextPhase --> [*]: workflow complete
    
    note right of LLMCall: Expensive operation<br/>isolated for retry
    note right of SaveOutput: Storage separate<br/>from LLM calls