{
  "schemaVersion": 1,
  "generatedAt": "2026-08-12T23:38:09.191Z",
  "generationKey": "7b24909593c60b0ae92c532f634d5e4145f890dd5e4f23e63d96e262800e73fe",
  "metadataPayloadSha256": "c9037b45859a9159ab9f2e8e114fe8cc14e8f438f8c8acc960925db8592744d1",
  "diagram": {
    "id": "durable-agents-and-approvals-4842730b",
    "title": "Durable agents and approvals",
    "description": "A single-step generateText loop: RLS-scoped tool calls, HITL suspend/resume for approvals, budget-aware graceful stop, and a deterministic citation guardrail before persisting the trace.",
    "status": "current",
    "canonicalAppearanceKey": "tsx:src/app/(docs)/docs/architecture/page.tsx:AGENT_CHART#1"
  },
  "aliases": [],
  "concepts": [
    "Public overview diagrams",
    "Durable agents and approvals",
    "Agent"
  ],
  "keywords": [
    "persist queued run + pg-boss job",
    "execute under withWorkspace (RLS)",
    "human decides via UI / API",
    "worker pins agent_version + config snapshot",
    "kb_search / kb_graph_query / kb_doc_read",
    "SUSPEND → run_approvals (persisted)",
    "UI / REST / schedule",
    "tool call?",
    "step loop (single-step generateText)",
    "allow · deny · edit (SLA-tracked)",
    "atomic decision + queued continuation",
    "budget / wall-clock / cancel?",
    "graceful stop: partial answer",
    "deterministic citation guardrail",
    "persist run + steps + output + trace",
    "requiresApproval?",
    "mcp:server:tool",
    "yes",
    "no",
    "exceeded"
  ],
  "mermaid": {
    "type": "flowchart",
    "direction": "TD",
    "sourceSha256": "4842730b597d5f7c45229345261d6e4870836faf075d9b70110dfd957bade963"
  },
  "provenance": [
    {
      "appearanceKey": "md:docs/architecture/public-overview-diagrams.md#6",
      "surface": "markdown",
      "sourcePath": "docs/architecture/public-overview-diagrams.md",
      "line": 200,
      "heading": "Durable agents and approvals"
    },
    {
      "appearanceKey": "tsx:src/app/(docs)/docs/architecture/page.tsx:AGENT_CHART#1",
      "surface": "route",
      "sourcePath": "src/components/docs/diagrams.ts",
      "line": 62,
      "route": "/docs/architecture",
      "symbol": "AGENT_CHART",
      "caption": "A single-step generateText loop: RLS-scoped tool calls, HITL suspend/resume for approvals, budget-aware graceful stop, and a deterministic citation guardrail before persisting the trace."
    }
  ],
  "embeddedMetadata": [
    {
      "sourcePath": "docs/architecture/public-overview-diagrams.md",
      "heading": "Durable agents and approvals"
    },
    {
      "sourcePath": "src/components/docs/diagrams.ts",
      "caption": "A single-step generateText loop: RLS-scoped tool calls, HITL suspend/resume for approvals, budget-aware graceful stop, and a deterministic citation guardrail before persisting the trace."
    }
  ],
  "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/durable-agents-and-approvals-4842730b/durable-agents-and-approvals-4842730b.mmd",
    "svg": "/diagrams/durable-agents-and-approvals-4842730b/durable-agents-and-approvals-4842730b.svg",
    "png": "/diagrams/durable-agents-and-approvals-4842730b/durable-agents-and-approvals-4842730b.png",
    "drawio": "/diagrams/durable-agents-and-approvals-4842730b/durable-agents-and-approvals-4842730b.drawio",
    "json": "/diagrams/durable-agents-and-approvals-4842730b/durable-agents-and-approvals-4842730b.json"
  },
  "artifactSha256": {
    "mmd": "477cd64efe80e100e5674f471153610ddb96ccc1364193ec6a0ab03a83d0e5d2",
    "svg": "4727463882878607e4684a55f653c51762d7b15434f3b96ab8ea2e163bb79838",
    "png": "b4f03d008330718c9c3ceb302ecc24b72b6b7cdf4ebcd4699de36dcf43769ef5",
    "drawio": "8ecef23dbaca03d60a28556a8f6813c53865e496f98f2625895d6a1b66cb0e4f"
  }
}