{
  "schemaVersion": 1,
  "generatedAt": "2026-08-17T18:31:55.945Z",
  "generationKey": "6bd3eae411bb715c356f6824a19f66cf40e6a009d4263654c395712c774086d0",
  "metadataPayloadSha256": "49266b5fc2d038160133de1a0ef2cb26bb5f9572414d492584a97be43d99afc3",
  "diagram": {
    "id": "conduit-primary-runtime-flow-34e5775d",
    "title": "Conduit — primary runtime flow",
    "description": "One runDataQuery execution. Catalog reads run in a short workspace transaction, the external call happens outside any transaction, and a data_calls row is appended on every outcome — the response's dataCallId is that row's id.",
    "status": "current",
    "canonicalAppearanceKey": "tsx:src/app/(docs)/docs/modules/conduit/page.tsx:primaryRuntimeFlowChart#1"
  },
  "aliases": [],
  "concepts": [
    "Primary runtime flow",
    "Modules",
    "Conduit"
  ],
  "keywords": [
    "API caller (data:run)",
    "POST {slug}/run (API)",
    "data_calls (store)",
    "data_queries + data_connectors (store)",
    "sql_template, params spec, maxRows, timeoutMs",
    "entitlement check when entitlement_param is set",
    "append blocked data_calls row",
    "one read-only statement",
    "rows + dataCallId",
    "Governed executor (service)",
    "Entitlement gate (service)",
    "Engine adapter (service)",
    "External database (external)",
    "runDataQuery — slug + typed params",
    "load query + connector (workspace txn)",
    "allow, inject grant, or deny",
    "coerceParams + assertReadOnlySql",
    "error envelope with status code",
    "execute with row + timeout caps",
    "columns, rows, truncated",
    "append ok row — snapshot + result hash",
    "/api/v1/data/queries",
    "executeNamedQuery",
    "rows"
  ],
  "mermaid": {
    "type": "sequence",
    "sourceSha256": "34e5775d30aa8c6e1465a4ae31a938432cde35e42a4a13df238bdd067d26d49d"
  },
  "provenance": [
    {
      "appearanceKey": "tsx:src/app/(docs)/docs/modules/conduit/page.tsx:primaryRuntimeFlowChart#1",
      "surface": "route",
      "sourcePath": "src/app/(docs)/docs/modules/conduit/page.tsx",
      "line": 107,
      "route": "/docs/modules/conduit",
      "symbol": "primaryRuntimeFlowChart",
      "caption": "One runDataQuery execution. Catalog reads run in a short workspace transaction, the external call happens outside any transaction, and a data_calls row is appended on every outcome — the response's dataCallId is that row's id."
    }
  ],
  "embeddedMetadata": [
    {
      "sourcePath": "src/app/(docs)/docs/modules/conduit/page.tsx",
      "caption": "One runDataQuery execution. Catalog reads run in a short workspace transaction, the external call happens outside any transaction, and a data_calls row is appended on every outcome — the response's dataCallId is that row's id."
    }
  ],
  "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/conduit-primary-runtime-flow-34e5775d/conduit-primary-runtime-flow-34e5775d.mmd",
    "svg": "/diagrams/conduit-primary-runtime-flow-34e5775d/conduit-primary-runtime-flow-34e5775d.svg",
    "png": "/diagrams/conduit-primary-runtime-flow-34e5775d/conduit-primary-runtime-flow-34e5775d.png",
    "drawio": "/diagrams/conduit-primary-runtime-flow-34e5775d/conduit-primary-runtime-flow-34e5775d.drawio",
    "json": "/diagrams/conduit-primary-runtime-flow-34e5775d/conduit-primary-runtime-flow-34e5775d.json"
  },
  "artifactSha256": {
    "mmd": "602513a06c9cfa53037bf47eeb21bcd2db270d15df7489762c6c5638c0adcbac",
    "svg": "66cd927303106b00cddd5e06b2d4b61b698c1edc989a0af044db445929c75615",
    "png": "ca38be2f4295b57753da8511a48c74758baa982fae9349bb6fec586191a82af5",
    "drawio": "6e93a5d599cb095c683c83892c7158344f23eabd5bc7a6e3cf53a969e947a3e9"
  }
}