%%{init: {'theme': 'dark', 'themeVariables': {'primaryColor': '#2a2a2a', 'primaryTextColor': '#e0e0e0', 'primaryBorderColor': '#555', 'lineColor': '#888', 'secondaryColor': '#1a1a1a', 'tertiaryColor': '#333', 'edgeLabelBackground': '#1a1a1a', 'clusterBkg': '#1e1e1e', 'clusterBorder': '#555'}}}%%

graph TB
    subgraph FE ["Frontend (React + Vite)"]
        direction LR
        subgraph ASSISTANT ["assistant-ui"]
            A1["🎤 Mic capture"]
            A2["📝 Transcript display"]
            A3["🔵 Agent status"]
        end
        subgraph TLDRAW ["tldraw Canvas"]
            T1["✏️ editor.createShapes()"]
            T2["📸 Canvas snapshots"]
            T3["🔲 Viewport awareness"]
        end
    end

    WS["WebSocket /ws/session\n↑ speech chunks + canvas state\n↓ agent actions + status"]

    subgraph BE ["Backend (FastAPI + Railtracks)"]
        direction TB
        subgraph ORCH_BOX [" "]
            ORCH["🟢 Orchestrator · @rt.agent_node\nWindow → Decision → Resolve\ndraw_artifact | annotate | wait | review"]
        end

        subgraph PIPELINE_BOX ["Transcript Pipeline"]
            direction LR
            INGEST["ChunkIngestor\ningest.py"]
            WINDOWER["WindowBuilder\nwindow=6, min_new=3"]
        end

        subgraph DECISION_BOX ["Decision Routing"]
            direction LR
            RESOLVER["ArtifactResolver\nquery → fixture → ops"]
            ANNOTATOR["Annotator\ncallouts + arrows"]
        end

        subgraph TOOLS_BOX ["Tools · @rt.function_node"]
            direction LR
            TOOL1["get_recent_transcript"]
            TOOL2["get_recent_decisions"]
            TOOL3["find_matching_artifact"]
        end

        subgraph LLM_BOX ["LLM Layer"]
            LLM["OpenAI gpt-5.4-mini\n(via LiteLLM)"]
        end

        PUB["EventPublisher\npub/sub broadcast"]
    end

    subgraph BB ["SessionState · Blackboard"]
        direction LR
        BB1["📒 transcript_chunks\nappend-only + cursor"]
        BB2["🖼️ drawn_artifacts\nfamilies on canvas"]
        BB3["🧠 recent_decisions\norchestrator history"]
        BB4["📚 recent_windows\nsliding windows"]
        BB5["📦 artifact_registry\npre-built tldraw shapes"]
    end

    FE --- WS

    WS -->|speech chunks| INGEST
    PUB -->|sends actions| WS

    INGEST --> WINDOWER
    WINDOWER -->|TranscriptWindow| ORCH

    ORCH -->|calls| LLM
    LLM -->|OrchestratorDecision| ORCH

    ORCH -->|calls| TOOL1
    ORCH -->|calls| TOOL2
    ORCH -->|calls| TOOL3

    ORCH -->|"draw_artifact"| RESOLVER
    ORCH -->|"annotate"| ANNOTATOR

    TOOL1 -->|reads| BB4
    TOOL2 -->|reads| BB3
    TOOL3 -->|reads| BB5
    RESOLVER -->|reads| BB5

    INGEST -->|writes| BB1
    RESOLVER -->|writes| BB2
    ANNOTATOR -->|writes| BB2
    ORCH -->|writes| BB3
    WINDOWER -->|writes| BB4

    ORCH --> PUB
    RESOLVER --> PUB
    ANNOTATOR --> PUB