Blinkin 2.0 — Architecture

graph TB
  subgraph INTERFACES["INTERFACES — 44,552 LOC"]
    direction LR
    subgraph Platform["Blinkin Platform"]
      AgentBuilder["Agent Builder"]
      ControlBoard["Control Plane\n(Kanban Board)"]
      ReviewInbox["Review Inbox"]
      ContextEditor["Context Editor"]
      MemoryPanel["Memory Panel"]
    end
    subgraph Apps["Business Applications"]
      RegWatch["RegWatch Monitor\n(Insurance)"]
      SpacesUI["Spaces Workspaces"]
      ExecEditor["Executive Editor"]
      AppLauncher["App Launcher"]
    end
    subgraph Companions["Companions (Houston)"]
      Chat["Chat / Voice"]
      Forms["Forms"]
      A2UIWidgets["A2UI Widgets"]
      PicassoRT["Picasso Runtime"]
    end
  end

  subgraph AGENTS["AGENTS — 4,698 LOC orchestrator"]
    direction LR
    subgraph YourAgents["Your Agents (Custom)"]
      CustomAgent["Custom Agent\n(AgentDefinition)"]
    end
    subgraph BlinkinAgents["Blinkin Agents"]
      ExecSummary["Executive Summary"]
      Research["Research"]
      Writer["Writer"]
      QA["Quality Review"]
      TTS["TTS"]
      FeedCurator["Feed Curator"]
    end
    subgraph PartnerAgents["Partner Agents"]
      A2AAgent["A2A Protocol\n(External)"]
    end
  end

  subgraph ORCHESTRATION["ORCHESTRATION · GOVERNANCE · EVAL"]
    direction LR
    Scheduler["Scheduler Daemon\n(reconcile → lease →\ndispatch → heartbeat)"]
    WorkItems["Work Items\n+ Dependency DAG\n(10 status columns)"]
    Policies["Policy Profiles\n(allow/deny/escalate/\nredact per tool)"]
    ReviewGate["Human Review Gate\n(Review Packages)"]
    RateLimiter["Rate Limiter\n(4 tiers, token-bucket)"]
    CronJobs["Cron Trigger\nEvaluator"]
  end

  subgraph COMPUTER["BLINKIN COMPUTER — 44,520 LOC worker"]
    direction LR
    AgentLoop["Agent Loop\n(Plan → Act → Observe\n→ Emit → Verify)"]
    ToolRouter["Tool Router\n(25+ tools)"]
    MemoryLayer["Memory Layer\n(8 tools + Claude\nnative bridge)"]
    StreamEmitter["SSE Emitter\n(9 event types)"]
    WebTools["Web Tools\n(scrape + search\n+ SSRF protection)"]
    Heartbeat["Heartbeat\nService"]
  end

  subgraph CONTEXT["BUSINESS CONTEXT — 7 types"]
    direction LR
    WritingRules["Writing Rules"]
    BrandGuidelines["Brand"]
    Personas["Personas"]
    Templates["Templates"]
    SOPs["SOPs"]
    DomainKnow["Domain Knowledge"]
    SkillPlaybooks["Skill Playbooks"]
    SignalBB["Signal Backbone"]
  end

  subgraph SOR["SYSTEMS OF RECORD — 62 stores"]
    direction LR
    SQLite["SQLite\n(per-org dev)"]
    Postgres["PostgreSQL\n(production)"]
    BlobStore["Blob Store\n(Local / R2 / S3)"]
    DocStore["Document Store\n(TipTap JSON)"]
    MemFileStore["Memory Files\n(scoped)"]
    SpaceStore["Space Store\n+ Knowledge"]
  end

  subgraph PLATFORM["PLATFORM SERVICES"]
    direction LR
    Auth["Auth\n(Actor Identity)"]
    Sharing["Share System\n(Public Locators)"]
    HostBridge["Host Bridge\n(PostMessage SDK)"]
    ChannelGW["Channel Gateway\n(Teams POC)"]
    SSEClient["SSE Client\n(Auto-Reconnect)"]
    CFInfra["Cloudflare\n(Workers + DO)"]
  end

  INTERFACES --> AGENTS
  AGENTS --> ORCHESTRATION
  ORCHESTRATION --> COMPUTER
  COMPUTER --> CONTEXT
  COMPUTER --> SOR
  SOR --> PLATFORM
  StreamEmitter -.->|SSE| INTERFACES
  HostBridge -.->|PostMessage| Companions

  style INTERFACES fill:#7c3aed,color:#fff
  style AGENTS fill:#6d28d9,color:#fff
  style ORCHESTRATION fill:#4c1d95,color:#fff
  style COMPUTER fill:#1e1e2e,color:#fff
  style CONTEXT fill:#1e293b,color:#fff
  style SOR fill:#0f172a,color:#fff
  style PLATFORM fill:#111827,color:#fff
      

graph LR
  subgraph Frontend["apps/web (44,552 LOC)"]
    Pages["10 Pages"]
    Components["Chat · Boards · Spaces\nControl Plane · Review\nMemory · Insurance"]
  end

  subgraph Backend["apps/worker (44,520 LOC)"]
    Server["server.ts (7K LOC)"]
    Stores["62 Runtime Stores"]
    Routes["Routes\n(health · spaces · upload)"]
    SpacesPipeline["Spaces Pipeline\n(scrape · audio · process)"]
    Jobs["Jobs\n(audit retention)"]
  end

  subgraph Orch["packages/orchestrator (4,698 LOC)"]
    Loop["Agent Loop"]
    Providers["Provider Router\n(Claude · Gemini · OpenAI)"]
    Tools["Tool Router (25+)"]
    Memory["Memory\n(consolidation · native)"]
    Telemetry["Langfuse Telemetry"]
  end

  subgraph Contracts["packages/contracts (8,211 LOC)"]
    Types["30 Type Modules\n(zero-dep shared language)"]
  end

  subgraph StateStore["packages/state-store (2,173 LOC)"]
    CompState["Companion Store\nBoard Editor Store"]
  end

  subgraph Bridge["packages/* (SDKs)"]
    HB["host-bridge"]
    SSE["sse-client"]
    Adapt["adapters"]
    Embed["react-embed\nembed-widget"]
  end

  subgraph Gateway["apps/chat-gateway (672 LOC)"]
    Teams["Teams POC"]
  end

  Pages --> CompState
  Components --> SSE
  Components --> HB
  Server --> Orch
  Server --> Stores
  Loop --> Providers
  Loop --> Tools
  Loop --> Memory
  Stores --> Types
  CompState --> Types
  Loop --> Types
  Server --> Types
  Pages --> Types
  Gateway --> Server

  style Frontend fill:#7c3aed,color:#fff
  style Backend fill:#1e1e2e,color:#fff
  style Orch fill:#6d28d9,color:#fff
  style Contracts fill:#4f46e5,color:#fff
  style StateStore fill:#4338ca,color:#fff
  style Bridge fill:#3730a3,color:#fff
  style Gateway fill:#312e81,color:#fff
      

graph TB
  subgraph Creator["CREATOR (Platform / Blinkin Studio)"]
    KB["Kanban Board — All Agents · All Tasks\nFull Config · Audit Trail · Review Inbox\nPolicy Profiles · Memory Panel"]
  end

  subgraph EndUser["END USER (Companion / Business App)"]
    CU["Chat + Widgets + Documents\nNo Kanban visible · Only Results\nSignal Stream · Inbox · Briefings"]
  end

  subgraph SharedBackend["SAME BACKEND (44,520 LOC)"]
    Agents["Agents (orchestrator)"]
    Kanban["Kanban Pipeline\nbacklog → ready → leased →\nrunning → verifying →\nawaiting_review → done"]
    Computer["Blinkin Computer\n(62 stores · 25+ tools · memory)"]
  end

  Creator --> SharedBackend
  EndUser --> SharedBackend
  Agents --> Kanban
  Kanban --> Computer

  style Creator fill:#7c3aed,color:#fff
  style EndUser fill:#6d28d9,color:#fff
  style SharedBackend fill:#1e1e2e,color:#fff
      

graph LR
  subgraph Protocols["Blinkin 2.0 Protocols"]
    direction TB
    AgentAgent["Agent ↔ Agent\n**A2A** (Linux Foundation)"]
    AgentUI["Agent → UI\n**A2UI** (declarative)\n**AgUI** (events)\n**Generative** (preview)"]
    AgentTool["Agent → Tool\n**CLI/API first**\n25+ tools registered\nMCP optional"]
    AgentSkill["Agent Skills\n**agentskills.io**\nImport/Export"]
    UIAgent["UI → Agent\n**widget.action**\n**triggerAgent**\n**SSE stream**"]
    AgentLLM["Agent → LLM\n**Direct SDKs**\nClaude · Gemini · OpenAI\nNo LangChain"]
    AgentMemory["Agent ↔ Memory\n**8 tools**\nmodel-agnostic\n+ Claude native"]
    AgentKanban["Agent ↔ Kanban\n**7 board tools**\ncreate · update · comment\ncollect results"]
  end

  style Protocols fill:#1e1e2e,color:#fff