{
  "schemaVersion": 1,
  "generatedAt": "2026-08-12T23:36:26.328Z",
  "generationKey": "21cac0a767d5e83d1c16aef0a9e8c2a88437f9d55f6dd5e7545508d4812815d8",
  "metadataPayloadSha256": "acf07c18b76bb3f4cbb964a6afcedc9c8d94697acc0235bb9d70ee87174b06d0",
  "diagram": {
    "id": "agent-surface-detailed-system-view-a8f942f5",
    "title": "Agent surface — detailed system view",
    "description": "Maps local stdio and hosted HTTP MCP transports from external agents through authenticated tool handlers into workspace-scoped storage and AI services.",
    "status": "archived",
    "canonicalAppearanceKey": "md:docs/architecture/workspace/05-agent-surface.md#2"
  },
  "aliases": [],
  "concepts": [
    "Agent surface",
    "External agents"
  ],
  "keywords": [
    "HTTP transport",
    "HTTP / SSE + Bearer",
    "RLS insert / update",
    "list_artifacts, read_artifact, list_versions",
    "create / edit / rename / delete_artifact",
    "get_diff, restore_version",
    "add_comment, daily_note, apply_template",
    "memory_search, memory_get",
    "Bearer eli_pair_* or eli_pat_*",
    "Gemini CLI / OpenClaw",
    "/pair page",
    "stdin/stdout JSON-RPC",
    "Claude Code / Cursor / Codex CLI",
    "Next route (mcp-handler)",
    "authForMcp / authForLocal",
    "createMcpServer + registerTools",
    "search (fts / semantic / hybrid)",
    "LocalAdapter / SupabaseAdapter",
    "staticContext, agentName pinned",
    "mode-conditional withMcpAuth",
    "service-role prefix lookup",
    "parseBearer / verifyHash",
    "dual text + structured output",
    "MCP",
    "bin/eli-mcp.mjs",
    "MCP authentication",
    "stdio transport"
  ],
  "mermaid": {
    "type": "flowchart",
    "direction": "LR",
    "sourceSha256": "a8f942f5eaba069d20e2e0ee55af2cc68e7345b9ab232a6776eaf0ca479eef91"
  },
  "provenance": [
    {
      "appearanceKey": "md:docs/architecture/workspace/05-agent-surface.md#2",
      "surface": "markdown",
      "sourcePath": "docs/architecture/workspace/05-agent-surface.md",
      "line": 79,
      "heading": "System view — detailed"
    }
  ],
  "embeddedMetadata": [
    {
      "sourcePath": "docs/architecture/workspace/05-agent-surface.md",
      "heading": "System view — detailed"
    }
  ],
  "generation": {
    "application": {
      "name": "eli-ai",
      "version": "0.1.0"
    },
    "environment": {
      "node": "v26.3.1",
      "yarn": "4.17.1",
      "platform": "linux",
      "architecture": "x64",
      "containerImage": "playwright:v1.62.1-noble@sha256:c091b21d9fae78c76e85cd4356431e9b018402f172a214fc7d7a5e9a7e29d8ac+node:26.3.1-bookworm-slim@sha256:209558c3e5e40e8adff68959d3c2ba7cd73723e716d89196878a0c362fa1e109"
    },
    "packages": {
      "mermaid": "11.16.0",
      "mermaidCli": "11.16.0",
      "playwright": "1.62.1",
      "playwrightCore": "1.62.1",
      "puppeteer": "25.6.0",
      "puppeteerCore": "25.6.0"
    },
    "renderer": {
      "mermaidConfigSha256": "68c10966fe84406ee626034d58bfabd555df9f65f691204b7c46db24038da101",
      "themeCssSha256": "c80287a78d80ad63d27bd5ca348b2ef9a7e2f44da289e436be6484ea28a1b033",
      "browser": {
        "name": "chromium",
        "revision": "1234",
        "version": "151.0.7922.34",
        "executableSha256": "0b20b130e7edd9dd51873be867761295fe0cfad490c2b9a64f95bd3cfc08fa71"
      },
      "font": {
        "family": "Eli Diagram Inter Variable",
        "fileSha256": "3100e775e8616cd2611beecfa23a4263d7037586789b43f035236a2e6fbd4c62",
        "licenseSha256": "3b0a5fca3d17942cde889069889dedbbbd075e9b599968c82a95f4d944e9b345"
      }
    },
    "adapterVersions": {
      "diagramGenerator": "2",
      "drawioFlowchart": "1",
      "drawioSequence": "1",
      "drawioState": "1",
      "drawioGantt": "1"
    }
  },
  "artifacts": {
    "mmd": "/diagrams/agent-surface-detailed-system-view-a8f942f5/agent-surface-detailed-system-view-a8f942f5.mmd",
    "svg": "/diagrams/agent-surface-detailed-system-view-a8f942f5/agent-surface-detailed-system-view-a8f942f5.svg",
    "png": "/diagrams/agent-surface-detailed-system-view-a8f942f5/agent-surface-detailed-system-view-a8f942f5.png",
    "drawio": "/diagrams/agent-surface-detailed-system-view-a8f942f5/agent-surface-detailed-system-view-a8f942f5.drawio",
    "json": "/diagrams/agent-surface-detailed-system-view-a8f942f5/agent-surface-detailed-system-view-a8f942f5.json"
  },
  "artifactSha256": {
    "mmd": "3d2cf0d4f0086dc6b322391f41a73c5806ac9a25230d841963a346a1d7c4b0aa",
    "svg": "55072209cbf5a1287c99575ea726f7bd88983cee190341abd005cb45a54a13f1",
    "png": "ee7e9f286b7a1413dd00c3817131755118ad2b714a5c8d6a2126ef90c4ae8bc7",
    "drawio": "b921d1362ca93db0ae6a658a3eb74c0417950762a3746f0a4a1bbe3b366e8d2a"
  }
}