Blinkin 2.0 — Architecture

graph TB
  subgraph L1["LAYER 1 — INTERFACES"]
    direction LR
    Chat["Chat Panel\n+ Editor + Widgets"]
    ControlBoard["Control Plane\nBoard"]
    MemPanel["Memory\nPanel"]
    ReviewUI["Review\nInbox"]
    Companions["Companions\n(Houston)"]
    Boards["Boards\n(React Flow)"]
  end
  subgraph L2["LAYER 2 — AGENTS"]
    direction LR
    AgentLoop["Agent Loop\nPlan-Act-Observe\nEmit-Verify"]
    ExecAgent["Executive\nSummary"]
    JingleAgent["Jingle\nWriter"]
    TTSAgent["TTS\nAgent"]
    ResearchAgent["Research\nAgent"]
    ModelRouter["Model Router\nClaude Gemini\nGPT DeepSeek"]
  end
  subgraph L3["LAYER 3 — ORCHESTRATION"]
    direction LR
    Scheduler["Scheduler Daemon\nLease Drain\nReconcile"]
    WorkItems["Work Items\nDAG Dependencies"]
    ArtifactGraph["Artifact Graph\nProvenance"]
    PolicyGate["Policy Gate\nTool Audit"]
    HumanGate["Human Review\nGate"]
    Coordinator["Scheduler\nCoordinator"]
  end
  subgraph L4["LAYER 4 — BLINKIN COMPUTER"]
    direction LR
    SSE["SSE\nStreaming"]
    StateStore["State\nStore"]
    MemoryLayer["Memory\nLayer"]
    ToolRouter["Tool\nRouter"]
    BlobStore["Blob\nStore"]
    ContextEng["Context\nEngine"]
  end
  subgraph L5["LAYER 5 — BUSINESS CONTEXT"]
    direction LR
    WritingRules["Writing\nRules"]
    Brand["Brand\nGuidelines"]
    Personas["Personas"]
    Templates["Templates"]
    Playbooks["Skill\nPlaybooks"]
  end
  subgraph L6["LAYER 6 — SYSTEMS OF RECORD"]
    direction LR
    SQLite["SQLite\nper Org"]
    Postgres["PostgreSQL\nProduction"]
    DocStore["Document\nStore"]
    MemFiles["Memory\nFiles"]
    Spaces["Spaces\n(Google)"]
    StudioAPI["Studio API\nAdapter"]
  end
  subgraph L7["LAYER 7 — PLATFORM SERVICES"]
    direction LR
    Auth["Auth"]
    Tenant["Multi-Tenant\nManager"]
    RateLimiter["Rate\nLimiter"]
    HostBridge["Host\nBridge"]
    ReactEmbed["React\nEmbed"]
  end
  Chat -->|user input| AgentLoop
  Chat -->|shows| SSE
  ControlBoard -->|dispatch| Scheduler
  MemPanel -->|reads| MemoryLayer
  ReviewUI -->|approve| HumanGate
  AgentLoop -->|tool calls| ToolRouter
  AgentLoop -->|emits| SSE
  AgentLoop -->|reads/writes| MemoryLayer
  ModelRouter -.->|selects model| AgentLoop
  Scheduler -->|leases| WorkItems
  WorkItems -->|resolves DAG| ArtifactGraph
  PolicyGate -->|before tool call| ToolRouter
  HumanGate -->|blocks until approve| WorkItems
  Coordinator -.->|multi-worker| Scheduler
  SSE -->|streams to| Chat
  StateStore -->|unified state| Chat
  ToolRouter -->|search/create| DocStore
  ToolRouter -->|write/read| BlobStore
  MemoryLayer -->|persists| MemFiles
  ContextEng -->|loads| WritingRules
  ContextEng -->|loads| Brand
  SQLite -->|dev| StateStore
  Postgres -->|production| StateStore
  Spaces -.->|RAG API| ToolRouter
  Auth -->|validates| Chat
  Tenant -->|isolates| SQLite
  HostBridge -.->|embeds in| Companions

graph LR
  User["User types\nin chat"] -->|POST /api/agent-runs| Server["Server"] -->|creates| Run["Agent Run"] -->|starts| Loop["Agent Loop"]
  Loop -->|1. checks| Memory["Memory files"]
  Loop -->|2. loads| Context["Business context"]
  Loop -->|3. calls| LLM["LLM\n(Claude/Gemini/GPT)"]
  LLM -->|tool_use| Tools["Tool Router"]
  Tools -->|search| KB["Knowledge Base"]
  Tools -->|create_doc| Docs["Document Store"]
  Tools -->|write_blob| Blobs["Blob Store"]
  Tools -->|memory_write| MemStore["Memory Store"]
  Loop -->|emits SSE| Stream["Stream Emitter"]
  Stream -->|text.delta| ChatUI["Chat\n(live text)"]
  Stream -->|widget.spec| Widgets["Widgets\n(cards, tables)"]
  Stream -->|document.op| Editor["TipTap\nEditor"]
  Stream -->|run.completed| Done["Done"]

graph LR
  Create["User creates\nwork item"] -->|POST /api/work-items| Backlog["Backlog"] -->|dependencies met| Ready["Ready"] -->|scheduler leases| Leased["Leased"] -->|agent starts| Running["Running"]
  Running -->|agent done| Verify["Verifying"]
  Verify -->|policy check| Review["Awaiting\nReview"]
  Review -->|human approves| Approved["Approved"]
  Approved --> Done["Done"]
  Running -->|error| Failed["Failed"]
  Failed -->|retry| Ready
  Review -->|rejected| Ready

graph TB
  subgraph Agents["Different Models"]
    Claude["Claude\n(Opus/Sonnet)"]
    Gemini["Gemini\n(Research)"]
    GPT["GPT"]
  end
  subgraph MemTools["Memory Tools (all models)"]
    List["memory_list"]
    Read["memory_read"]
    Write["memory_write"]
    Update["memory_update"]
    Delete["memory_delete"]
  end
  subgraph ClaudeExtra["Claude Enhancement"]
    NativeMem["memory_20250818\n(Claude-native)"]
    CtxEdit["Context Editing\n(auto-clear)"]
  end
  subgraph Storage["Persistence"]
    BlobMem["Blob Store"]
    ArtifactMem["Artifact Store"]
  end
  subgraph Scopes["Scoping"]
    PerTask["Per Work Item"]
    PerChat["Per Chat Room"]
    PerOrg["Per Org"]
  end
  Claude -->|tool_use| MemTools
  Claude -->|native| ClaudeExtra
  Gemini -->|function_calling| MemTools
  GPT -->|function_calling| MemTools
  MemTools --> Storage
  ClaudeExtra --> Storage
  Storage --> Scopes
  Scopes -->|visible in| Panel["Memory Panel UI"]

graph TB
  subgraph Creator["CREATOR — Platform"]
    KB["Kanban Board\n+ Control Plane\nAll agents visible\nFull config\nAudit trail"]
  end
  subgraph EndUser["END USER — Companion"]
    CU["Chat + Widgets\nNo board visible\nResults only\nBranded"]
  end
  subgraph Backend["SAME BACKEND"]
    Agents["Agents"]
    Scheduler["Scheduler"]
    Memory["Memory"]
    Store["Storage"]
  end
  Creator --> Backend
  EndUser --> Backend