@talonic/docs 0.7.1 → 0.8.0

package/dist/index.js

@@ -3512,7 +3512,7 @@ var NAV_SECTIONS2 = [
     label: "Validation & Quality",
     children: [
       { id: "validation-checks", label: "Validation Checks" },
-      { id: "golden-samples", label: "Golden Samples" },
+      { id: "ground-truth", label: "Golden Samples" },
       { id: "approval-gates", label: "Approval Gates" }
     ]
   },
@@ -3651,7 +3651,7 @@ function PlatformGuide({ LinkComponent }) {
         /* @__PURE__ */ jsx6(PipelineStage, { label: "Quality", state: "pending" })
       ] }) }),
       /* @__PURE__ */ jsx6("div", { className: "my-6 space-y-2", children: [
-        { n: "1", label: "Upload", desc: "Drag files or folders into Inputs. 25+ formats supported. ZIP archives are unpacked automatically." },
+        { n: "1", label: "Upload", desc: "Drag files or folders into Sources. 25+ formats supported. ZIP archives are unpacked automatically." },
         { n: "2", label: "Extract", desc: "Each document is processed through Document AI (OCR + annotation), classified against the document type ontology, and sent to AI for exhaustive field extraction." },
         { n: "3", label: "Graph builds", desc: "Extracted fields resolve into the Field Registry \u2014 canonical names, clusters, master instructions." },
         { n: "4", label: "Define schema", desc: "Create a template with the fields you need. Map to registry, add reference tables." },
@@ -3668,7 +3668,7 @@ function PlatformGuide({ LinkComponent }) {
       /* @__PURE__ */ jsx6(SubHeading, { id: "getting-started", children: "Getting Started" }),
       /* @__PURE__ */ jsxs6(P, { children: [
         "Navigate using the sidebar. The platform is organized into three primary sections:",
-        /* @__PURE__ */ jsx6("strong", { children: " Inputs" }),
+        /* @__PURE__ */ jsx6("strong", { children: " Sources" }),
         " (ingest), ",
         /* @__PURE__ */ jsx6("strong", { children: "Structuring" }),
         " (process & validate), and ",
@@ -3677,7 +3677,7 @@ function PlatformGuide({ LinkComponent }) {
       ] }),
       /* @__PURE__ */ jsx6(UiExcerpt, { title: "Sidebar Navigation", caption: "The sidebar provides access to all sections. Click the collapse button to save space. Press Cmd+K for global search.", children: /* @__PURE__ */ jsxs6("div", { className: "w-48 border border-void-border rounded-lg bg-void-bg p-3 space-y-0.5", children: [
         /* @__PURE__ */ jsx6(MockNavItem, { label: "Dashboard" }),
-        /* @__PURE__ */ jsx6(MockNavItem, { label: "Inputs", active: true }),
+        /* @__PURE__ */ jsx6(MockNavItem, { label: "Sources", active: true }),
         /* @__PURE__ */ jsx6(MockNavItem, { label: "Documents", indent: true }),
         /* @__PURE__ */ jsx6(MockNavItem, { label: "Field Library", indent: true }),
         /* @__PURE__ */ jsx6(MockNavItem, { label: "Structuring" }),
@@ -3689,21 +3689,21 @@ function PlatformGuide({ LinkComponent }) {
       ] }) }),
       /* @__PURE__ */ jsxs6(Callout, { children: [
         "The fastest path to results: upload documents in ",
-        /* @__PURE__ */ jsx6("strong", { children: "Inputs" }),
+        /* @__PURE__ */ jsx6("strong", { children: "Sources" }),
         ", then go to",
         " ",
         /* @__PURE__ */ jsx6("strong", { children: "Structuring \u2192 Runs \u2192 New" }),
         " to create your first extraction job."
       ] }),
       /* @__PURE__ */ jsx6(SectionHeading, { id: "sources-docs", children: "Inputs & Documents" }),
-      /* @__PURE__ */ jsx6(P, { children: "Inputs are the entry point for all data. Every document belongs to an input source \u2014 whether uploaded manually, synced from Google Drive, or ingested via API." }),
+      /* @__PURE__ */ jsx6(P, { children: "Sources are the entry point for all data. Every document belongs to a source \u2014 whether uploaded manually, synced from Google Drive, or ingested via API." }),
       /* @__PURE__ */ jsx6(SubHeading, { id: "uploading", children: "Uploading Documents" }),
       /* @__PURE__ */ jsxs6(P, { children: [
-        "The Inputs page provides a drag-and-drop upload interface. You can upload individual files, multiple files, or entire folders. ZIP archives are unpacked recursively. When uploading folders, the original file path is preserved as a data field (",
+        "The Sources page provides a drag-and-drop upload interface. You can upload individual files, multiple files, or entire folders. ZIP archives are unpacked recursively. When uploading folders, the original file path is preserved as a data field (",
         /* @__PURE__ */ jsx6("code", { children: "source_file_path" }),
         ") on each document \u2014 available for downstream processing and export."
       ] }),
-      /* @__PURE__ */ jsx6(UiExcerpt, { title: "Inputs \u2014 Upload Card", caption: "Drag files or folders onto the upload area. The progress indicator shows processing status in real-time.", children: /* @__PURE__ */ jsx6("div", { className: "max-w-sm", children: /* @__PURE__ */ jsxs6("div", { className: "border border-void-border rounded-lg p-4", children: [
+      /* @__PURE__ */ jsx6(UiExcerpt, { title: "Sources \u2014 Upload Card", caption: "Drag files or folders onto the upload area. The progress indicator shows processing status in real-time.", children: /* @__PURE__ */ jsx6("div", { className: "max-w-sm", children: /* @__PURE__ */ jsxs6("div", { className: "border border-void-border rounded-lg p-4", children: [
         /* @__PURE__ */ jsxs6("div", { className: "flex items-center gap-3 mb-3", children: [
           /* @__PURE__ */ jsx6("div", { className: "w-10 h-10 rounded-lg bg-void-accent/10 flex items-center justify-center", children: /* @__PURE__ */ jsxs6("svg", { width: "20", height: "20", viewBox: "0 0 24 24", fill: "none", stroke: "#673AB7", strokeWidth: "1.5", strokeLinecap: "round", children: [
             /* @__PURE__ */ jsx6("path", { d: "M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4" }),
@@ -3828,7 +3828,7 @@ function PlatformGuide({ LinkComponent }) {
       /* @__PURE__ */ jsx6(SubHeading, { id: "field-registry", children: "Field Registry" }),
       /* @__PURE__ */ jsxs6(P, { children: [
         "Navigate to ",
-        /* @__PURE__ */ jsx6("strong", { children: "Inputs \u2192 Field Library" }),
+        /* @__PURE__ */ jsx6("strong", { children: "Sources Inputs \u2192rarr; Field Library" }),
         " to explore the registry. Every canonical field is displayed with its tier, data type, occurrence count, and document types."
       ] }),
       /* @__PURE__ */ jsx6(UiExcerpt, { title: "Field Library \u2014 Registry Table", caption: "Fields are organized by tier with occurrence counts, data types, and master instruction status.", children: /* @__PURE__ */ jsx6("div", { className: "border border-void-border rounded-lg overflow-hidden", children: /* @__PURE__ */ jsxs6("table", { className: "w-full text-[12px]", children: [
@@ -4227,7 +4227,7 @@ function PlatformGuide({ LinkComponent }) {
       /* @__PURE__ */ jsx6(P, { children: "Multiple layers of quality assurance: automated validation checks, ground truth benchmarking, and configurable approval gates." }),
       /* @__PURE__ */ jsx6(SubHeading, { id: "validation-checks", children: "Validation Checks" }),
       /* @__PURE__ */ jsx6(P, { children: "Schema-level quality rules run during Phase 3 of every job. Rule types: field format, value range, cross-field consistency, and AI-proposed coherence rules. Rules can be AI-proposed after a job completes, then reviewed and approved before activation." }),
-      /* @__PURE__ */ jsx6(SubHeading, { id: "golden-samples", children: "Golden Samples" }),
+      /* @__PURE__ */ jsx6(SubHeading, { id: "ground-truth", children: "Golden Samples" }),
       /* @__PURE__ */ jsxs6(P, { children: [
         "Manually-created reference datasets with known-correct values. Create from",
         " ",
@@ -4408,9 +4408,22 @@ function PlatformGuide({ LinkComponent }) {
             { name: "/v1/documents", type: "CRUD", description: "Document listing, detail, and deletion with cursor pagination." },
             { name: "/v1/extractions", type: "CRUD", description: "Extraction results and field corrections." },
             { name: "/v1/schemas", type: "CRUD", description: "Schema management \u2014 create, update, delete." },
-            { name: "/v1/jobs", type: "CRUD", description: "Async job tracking and results." },
+            { name: "/v1/jobs", type: "CRUD", description: "Async job tracking, results, and N-Shot comparisons with override and judge decisions." },
             { name: "/v1/sources", type: "CRUD", description: "API source management and document ingest." },
-            { name: "/v1/delivery", type: "CRUD", description: "Outbound delivery: destinations, bindings, history, DLQ, outbox, catalog." }
+            { name: "/v1/delivery", type: "CRUD", description: "Outbound delivery: destinations, bindings, history, DLQ, outbox, catalog." },
+            { name: "/v1/resolutions", type: "CRUD", description: "Resolution runs \u2014 field normalization, transforms, and lookup cascades." },
+            { name: "/v1/linking", type: "mixed", description: "Document linking: link keys, document links, entity graph, classification, backfill, and document-case mapping." },
+            { name: "/v1/schema-graph", type: "mixed", description: "Schema class ontology: versioned classes, diffs with approval workflow, edges, aliases, and visualization." },
+            { name: "/v1/structuring", type: "CRUD", description: "Validation checks, approval gates with rules, result checks, pending approvals, and delivery triggers." },
+            { name: "/v1/telemetry", type: "GET", description: "Structuring metrics: per-schema and per-run summaries, trends, and field-level breakdowns." },
+            { name: "/v1/validation", type: "CRUD", description: "Golden samples and validation runs for measuring extraction accuracy against ground truth." },
+            { name: "/v1/credits", type: "GET", description: "Credit balance, transaction history, usage summaries, daily breakdown, and per-request usage log." },
+            { name: "/v1/cases", type: "CRUD", description: "Cases: status updates, edge confirmation/rejection, split/merge, completeness, document pinning." },
+            { name: "/v1/batches", type: "mixed", description: "Batch inference: listing, detail, provider sync, and cancellation." },
+            { name: "/v1/matching", type: "CRUD", description: "Smart matching: configurations, strategies, smart runs, AI resolution, results, progress, and review." },
+            { name: "/v1/review", type: "mixed", description: "Review queue: assignment, actions, batch operations, and statistics." },
+            { name: "/v1/quality", type: "CRUD", description: "Ground truth datasets with entries, benchmarks with results and comparison." },
+            { name: "/v1/reference-data", type: "CRUD", description: "Reference datasets: file and JSON upload, row browsing, and management." }
           ]
         }
       ),
@@ -4712,6 +4725,77 @@ var API_NAV_SECTIONS = [
     { id: "webhook-verification", label: "Signature Verification" },
     { id: "webhook-retries", label: "Retry Policy" }
   ] },
+  { id: "resolutions", label: "Resolutions", children: [
+    { id: "list-resolutions", label: "List Resolutions" },
+    { id: "create-resolution", label: "Create Resolution" },
+    { id: "get-resolution", label: "Get Resolution" },
+    { id: "get-resolution-results", label: "Get Results" },
+    { id: "execute-resolution", label: "Execute Resolution" },
+    { id: "delete-resolution", label: "Delete Resolution" }
+  ] },
+  { id: "linking", label: "Linking", children: [
+    { id: "list-link-keys", label: "Link Keys" },
+    { id: "get-document-links", label: "Document Links" },
+    { id: "get-linking-graph", label: "Full Graph" },
+    { id: "get-document-graph", label: "Document Graph" },
+    { id: "classify-link-keys", label: "Classify" },
+    { id: "backfill-linking", label: "Backfill" },
+    { id: "backfill-progress", label: "Backfill Progress" },
+    { id: "document-case-map", label: "Document-Case Map" }
+  ] },
+  { id: "nshot", label: "N-Shot", children: [
+    { id: "nshot-summary", label: "Summary" },
+    { id: "nshot-comparisons", label: "Comparisons" },
+    { id: "nshot-comparison", label: "Single Comparison" },
+    { id: "nshot-override", label: "Override" },
+    { id: "nshot-judge-decision", label: "Judge Decision" }
+  ] },
+  { id: "schema-graph", label: "Schema Graph", children: [
+    { id: "list-schema-graph-classes", label: "List Classes" },
+    { id: "get-schema-graph-class", label: "Get Class" },
+    { id: "list-class-versions", label: "List Versions" },
+    { id: "get-class-version", label: "Get Version" },
+    { id: "list-schema-graph-diffs", label: "List Diffs" },
+    { id: "approve-diff", label: "Approve Diff" },
+    { id: "reject-diff", label: "Reject Diff" },
+    { id: "list-schema-graph-edges", label: "Edges" },
+    { id: "list-schema-graph-aliases", label: "Aliases" },
+    { id: "visualize-schema-graph", label: "Visualize" }
+  ] },
+  { id: "structuring", label: "Structuring", children: [
+    { id: "list-structuring-checks", label: "List Checks" },
+    { id: "create-structuring-check", label: "Create Check" },
+    { id: "get-structuring-check", label: "Get / Update / Delete Check" },
+    { id: "list-structuring-gates", label: "List Gates" },
+    { id: "create-structuring-gate", label: "Create Gate" },
+    { id: "get-structuring-gate", label: "Get / Update / Delete Gate" },
+    { id: "gate-rules", label: "Gate Rules" },
+    { id: "result-checks", label: "Result Checks" },
+    { id: "pending-approvals", label: "Pending Approvals" },
+    { id: "approve-reject-result", label: "Approve / Reject Result" },
+    { id: "trigger-delivery", label: "Trigger Delivery" }
+  ] },
+  { id: "telemetry", label: "Telemetry", children: [
+    { id: "schema-telemetry-summary", label: "Schema Summary" },
+    { id: "schema-telemetry-trend", label: "Schema Trend" },
+    { id: "schema-telemetry-fields", label: "Schema Fields" },
+    { id: "run-telemetry-summary", label: "Run Summary" }
+  ] },
+  { id: "validation", label: "Validation", children: [
+    { id: "list-golden-samples", label: "List Golden Samples" },
+    { id: "get-golden-sample", label: "Get / Delete Golden Sample" },
+    { id: "list-validation-runs", label: "List Validation Runs" },
+    { id: "create-validation-run", label: "Create Validation Run" },
+    { id: "get-validation-run", label: "Get / Delete Validation Run" },
+    { id: "get-validation-results", label: "Validation Results" }
+  ] },
+  { id: "credits", label: "Credits", children: [
+    { id: "credits-balance", label: "Balance" },
+    { id: "credits-history", label: "History" },
+    { id: "credits-usage", label: "Usage Summary" },
+    { id: "credits-usage-daily", label: "Daily Usage" },
+    { id: "credits-usage-log", label: "Usage Log" }
+  ] },
   { id: "errors-rate-limits", label: "Errors & Rate Limits", children: [
     { id: "error-format", label: "Error Format" },
     { id: "error-codes", label: "Error Codes" },
@@ -4811,6 +4895,13 @@ var API_SECTION_META = [
   { id: "sources", title: "Inputs API", description: "Manage document sources for programmatic ingestion. Each source has its own API key and supports batch processing." },
   { id: "filter-search", title: "Filter & Search API", description: "Field autocomplete, document filtering with composable conditions, global omnisearch, and saved filter management." },
   { id: "webhooks", title: "Webhooks", description: "Real-time event notifications with HMAC-SHA256 signed payloads, delivery tracking, and exponential backoff retries." },
+  { id: "resolutions", title: "Resolutions API", description: "Resolution runs \u2014 apply field normalization, transforms, and lookup cascades to extracted data. List, create, execute, and delete resolution runs." },
+  { id: "linking", title: "Linking API", description: "Document linking graph \u2014 link keys, document links, entity graph, classification, backfill operations, and document-case mapping." },
+  { id: "nshot", title: "N-Shot API", description: "N-Shot comparison endpoints for job runs \u2014 summary, field comparisons, overrides, and AI/human judge decisions." },
+  { id: "schema-graph", title: "Schema Graph API", description: "Schema class ontology \u2014 versioned classes, diffs with approval/rejection workflow, inter-class edges, aliases, and D3-compatible visualization." },
+  { id: "structuring", title: "Structuring API", description: "Validation checks CRUD, approval gates with configurable rules, result check outcomes, pending approvals queue, and delivery triggers." },
+  { id: "validation", title: "Validation API", description: "Golden sample management and validation runs for measuring extraction accuracy against ground truth datasets." },
+  { id: "credits", title: "Credits API", description: "Credit balance, transaction history, aggregate usage summaries, daily usage breakdown, and per-request usage log." },
   { id: "errors-rate-limits", title: "Errors & Rate Limits", description: "Error response format, error codes, rate limit tiers by plan, and rate limit headers." }
 ];
 var PLATFORM_SECTION_META = [
@@ -4927,6 +5018,265 @@ var OPENAPI_SPEC = {
     "/v1/sources/{id}/documents": {
       get: { operationId: "listSourceDocuments", summary: "List documents in a source", tags: ["Sources"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Paginated documents" } } },
       post: { operationId: "ingestDocument", summary: "Ingest a document into a source", tags: ["Sources"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Ingested document" } } }
+    },
+    // Resolutions
+    "/v1/resolutions": {
+      get: { operationId: "listResolutions", summary: "List resolution runs", tags: ["Resolutions"], responses: { "200": { description: "Paginated list of resolution runs" } } },
+      post: { operationId: "createResolution", summary: "Create a resolution run", tags: ["Resolutions"], responses: { "201": { description: "Resolution run created" } } }
+    },
+    "/v1/resolutions/{id}": {
+      get: { operationId: "getResolution", summary: "Get a resolution run", tags: ["Resolutions"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Resolution run detail" } } },
+      delete: { operationId: "deleteResolution", summary: "Delete a resolution run", tags: ["Resolutions"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Resolution run deleted" } } }
+    },
+    "/v1/resolutions/{id}/results": {
+      get: { operationId: "getResolutionResults", summary: "Get resolution run results", tags: ["Resolutions"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Resolution results" } } }
+    },
+    "/v1/resolutions/{id}/execute": {
+      post: { operationId: "executeResolution", summary: "Execute a resolution run", tags: ["Resolutions"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Resolution execution started" } } }
+    },
+    // Linking
+    "/v1/linking/link-keys": {
+      get: { operationId: "listLinkKeys", summary: "List link keys", tags: ["Linking"], responses: { "200": { description: "List of link keys" } } }
+    },
+    "/v1/linking/documents/{id}/links": {
+      get: { operationId: "getDocumentLinks", summary: "Get links for a document", tags: ["Linking"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Document links" } } }
+    },
+    "/v1/linking/graph": {
+      get: { operationId: "getLinkingGraph", summary: "Get the full linking graph", tags: ["Linking"], responses: { "200": { description: "Full linking graph" } } }
+    },
+    "/v1/linking/graph/documents/{id}": {
+      get: { operationId: "getDocumentGraph", summary: "Get graph neighbourhood for a document", tags: ["Linking"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Document-centric subgraph" } } }
+    },
+    "/v1/linking/classify": {
+      post: { operationId: "classifyLinkKeys", summary: "Classify link keys", tags: ["Linking"], responses: { "200": { description: "Classification results" } } }
+    },
+    "/v1/linking/backfill": {
+      post: { operationId: "backfillLinking", summary: "Backfill linking data", tags: ["Linking"], responses: { "202": { description: "Backfill started" } } }
+    },
+    "/v1/linking/backfill/progress": {
+      get: { operationId: "getBackfillProgress", summary: "Get backfill progress", tags: ["Linking"], responses: { "200": { description: "Backfill progress" } } }
+    },
+    "/v1/linking/document-case-map": {
+      get: { operationId: "getDocumentCaseMap", summary: "Get document-to-case mapping", tags: ["Linking"], responses: { "200": { description: "Document-case mapping" } } }
+    },
+    // N-Shot
+    "/v1/jobs/runs/{runId}/nshot/summary": {
+      get: { operationId: "getNshotSummary", summary: "Get N-Shot summary for a run", tags: ["N-Shot"], parameters: [{ name: "runId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "N-Shot summary" } } }
+    },
+    "/v1/jobs/runs/{runId}/nshot/comparisons": {
+      get: { operationId: "listNshotComparisons", summary: "List N-Shot comparisons", tags: ["N-Shot"], parameters: [{ name: "runId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "List of comparisons" } } }
+    },
+    "/v1/jobs/runs/{runId}/nshot/comparison": {
+      get: { operationId: "getNshotComparison", summary: "Get a specific N-Shot comparison", tags: ["N-Shot"], parameters: [{ name: "runId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Single comparison result" } } }
+    },
+    "/v1/jobs/runs/{runId}/nshot/override": {
+      post: { operationId: "nshotOverride", summary: "Override an N-Shot value", tags: ["N-Shot"], parameters: [{ name: "runId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Override applied" } } }
+    },
+    "/v1/jobs/runs/{runId}/nshot/judge-decision": {
+      post: { operationId: "nshotJudgeDecision", summary: "Submit a judge decision for N-Shot", tags: ["N-Shot"], parameters: [{ name: "runId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Judge decision recorded" } } }
+    },
+    // Schema Graph
+    "/v1/schema-graph/classes": {
+      get: { operationId: "listSchemaGraphClasses", summary: "List schema graph classes", tags: ["Schema Graph"], responses: { "200": { description: "List of schema graph classes" } } }
+    },
+    "/v1/schema-graph/classes/{id}": {
+      get: { operationId: "getSchemaGraphClass", summary: "Get a schema graph class", tags: ["Schema Graph"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Schema graph class detail" } } }
+    },
+    "/v1/schema-graph/classes/{id}/versions": {
+      get: { operationId: "listSchemaGraphClassVersions", summary: "List versions of a schema graph class", tags: ["Schema Graph"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "List of class versions" } } }
+    },
+    "/v1/schema-graph/classes/{id}/versions/{version}": {
+      get: { operationId: "getSchemaGraphClassVersion", summary: "Get a specific class version", tags: ["Schema Graph"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }, { name: "version", in: "path", required: true, schema: { type: "integer" } }], responses: { "200": { description: "Class version detail" } } }
+    },
+    "/v1/schema-graph/diffs": {
+      get: { operationId: "listSchemaGraphDiffs", summary: "List schema graph diffs", tags: ["Schema Graph"], responses: { "200": { description: "List of diffs" } } }
+    },
+    "/v1/schema-graph/diffs/{id}/approve": {
+      post: { operationId: "approveSchemaGraphDiff", summary: "Approve a schema graph diff", tags: ["Schema Graph"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Diff approved" } } }
+    },
+    "/v1/schema-graph/diffs/{id}/reject": {
+      post: { operationId: "rejectSchemaGraphDiff", summary: "Reject a schema graph diff", tags: ["Schema Graph"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Diff rejected" } } }
+    },
+    "/v1/schema-graph/edges": {
+      get: { operationId: "listSchemaGraphEdges", summary: "List schema graph edges", tags: ["Schema Graph"], responses: { "200": { description: "List of edges" } } }
+    },
+    "/v1/schema-graph/aliases": {
+      get: { operationId: "listSchemaGraphAliases", summary: "List schema graph aliases", tags: ["Schema Graph"], responses: { "200": { description: "List of aliases" } } }
+    },
+    "/v1/schema-graph/visualize": {
+      get: { operationId: "visualizeSchemaGraph", summary: "Get schema graph visualization data", tags: ["Schema Graph"], responses: { "200": { description: "Visualization data" } } }
+    },
+    // Structuring
+    "/v1/structuring/checks": {
+      get: { operationId: "listStructuringChecks", summary: "List structuring checks", tags: ["Structuring"], responses: { "200": { description: "Paginated list of structuring checks" } } },
+      post: { operationId: "createStructuringCheck", summary: "Create a structuring check", tags: ["Structuring"], responses: { "201": { description: "Structuring check created" } } }
+    },
+    "/v1/structuring/checks/{id}": {
+      get: { operationId: "getStructuringCheck", summary: "Get a structuring check", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Structuring check detail" } } },
+      put: { operationId: "updateStructuringCheck", summary: "Update a structuring check", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Structuring check updated" } } },
+      delete: { operationId: "deleteStructuringCheck", summary: "Delete a structuring check", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Structuring check deleted" } } }
+    },
+    "/v1/structuring/gates": {
+      get: { operationId: "listStructuringGates", summary: "List approval gates", tags: ["Structuring"], responses: { "200": { description: "Paginated list of approval gates" } } },
+      post: { operationId: "createStructuringGate", summary: "Create an approval gate", tags: ["Structuring"], responses: { "201": { description: "Approval gate created" } } }
+    },
+    "/v1/structuring/gates/{id}": {
+      get: { operationId: "getStructuringGate", summary: "Get an approval gate", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Approval gate detail" } } },
+      put: { operationId: "updateStructuringGate", summary: "Update an approval gate", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Approval gate updated" } } },
+      delete: { operationId: "deleteStructuringGate", summary: "Delete an approval gate", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Approval gate deleted" } } }
+    },
+    "/v1/structuring/gates/{id}/rules": {
+      post: { operationId: "addStructuringGateRule", summary: "Add a rule to an approval gate", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "201": { description: "Rule added" } } },
+      delete: { operationId: "deleteStructuringGateRule", summary: "Remove a rule from an approval gate", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Rule removed" } } }
+    },
+    "/v1/structuring/results/{id}/checks": {
+      get: { operationId: "getStructuringResultChecks", summary: "Get check results for a structuring result", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Check results" } } }
+    },
+    "/v1/structuring/approvals/pending": {
+      get: { operationId: "listPendingApprovals", summary: "List pending approvals", tags: ["Structuring"], responses: { "200": { description: "Paginated list of pending approvals" } } }
+    },
+    "/v1/structuring/approvals/{id}/approve": {
+      post: { operationId: "approveStructuringResult", summary: "Approve a structuring result", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Result approved" } } }
+    },
+    "/v1/structuring/approvals/{id}/reject": {
+      post: { operationId: "rejectStructuringResult", summary: "Reject a structuring result", tags: ["Structuring"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Result rejected" } } }
+    },
+    "/v1/structuring/delivery/{runId}": {
+      post: { operationId: "triggerStructuringDelivery", summary: "Trigger delivery for a structuring run", tags: ["Structuring"], parameters: [{ name: "runId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Delivery triggered" } } }
+    },
+    // Telemetry
+    "/v1/telemetry/schemas/{id}/summary": {
+      get: { operationId: "getTelemetrySchemaSummary", summary: "Get telemetry summary for a schema", tags: ["Telemetry"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Schema telemetry summary" } } }
+    },
+    "/v1/telemetry/schemas/{id}/trend": {
+      get: { operationId: "getTelemetrySchemaTrend", summary: "Get telemetry trend for a schema", tags: ["Telemetry"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Schema telemetry trend" } } }
+    },
+    "/v1/telemetry/schemas/{id}/fields": {
+      get: { operationId: "getTelemetrySchemaFields", summary: "Get per-field telemetry for a schema", tags: ["Telemetry"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Per-field telemetry" } } }
+    },
+    "/v1/telemetry/runs/{id}/summary": {
+      get: { operationId: "getTelemetryRunSummary", summary: "Get telemetry summary for a run", tags: ["Telemetry"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Run telemetry summary" } } }
+    },
+    // Validation
+    "/v1/validation/golden-samples": {
+      get: { operationId: "listGoldenSamples", summary: "List golden samples", tags: ["Validation"], responses: { "200": { description: "Paginated list of golden samples" } } }
+    },
+    "/v1/validation/golden-samples/{id}": {
+      get: { operationId: "getGoldenSample", summary: "Get a golden sample", tags: ["Validation"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Golden sample detail" } } },
+      delete: { operationId: "deleteGoldenSample", summary: "Delete a golden sample", tags: ["Validation"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Golden sample deleted" } } }
+    },
+    "/v1/validation/runs": {
+      get: { operationId: "listValidationRuns", summary: "List validation runs", tags: ["Validation"], responses: { "200": { description: "Paginated list of validation runs" } } },
+      post: { operationId: "createValidationRun", summary: "Create a validation run", tags: ["Validation"], responses: { "201": { description: "Validation run created" } } }
+    },
+    "/v1/validation/runs/{id}": {
+      get: { operationId: "getValidationRun", summary: "Get a validation run", tags: ["Validation"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Validation run detail" } } },
+      delete: { operationId: "deleteValidationRun", summary: "Delete a validation run", tags: ["Validation"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Validation run deleted" } } }
+    },
+    "/v1/validation/runs/{id}/results": {
+      get: { operationId: "getValidationRunResults", summary: "Get validation run results", tags: ["Validation"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Validation run results" } } }
+    },
+    // Credits
+    "/v1/credits/balance": {
+      get: { operationId: "getCreditsBalance", summary: "Get credit balance", tags: ["Credits"], responses: { "200": { description: "Credit balance" } } }
+    },
+    "/v1/credits/history": {
+      get: { operationId: "getCreditsHistory", summary: "Get credit history", tags: ["Credits"], responses: { "200": { description: "Paginated credit history" } } }
+    },
+    "/v1/credits/usage": {
+      get: { operationId: "getCreditsUsage", summary: "Get credit usage summary", tags: ["Credits"], responses: { "200": { description: "Credit usage summary" } } }
+    },
+    "/v1/credits/usage/daily": {
+      get: { operationId: "getCreditsUsageDaily", summary: "Get daily credit usage", tags: ["Credits"], responses: { "200": { description: "Daily credit usage" } } }
+    },
+    "/v1/credits/usage/log": {
+      get: { operationId: "getCreditsUsageLog", summary: "Get credit usage log", tags: ["Credits"], responses: { "200": { description: "Paginated usage log" } } }
+    },
+    // Expanded: Cases
+    "/v1/cases/{key}/status": {
+      patch: { operationId: "updateCaseStatus", summary: "Update case status", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Case status updated" } } }
+    },
+    "/v1/cases/{key}/edges": {
+      get: { operationId: "getCaseEdges", summary: "Get case edges", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Case edges" } } }
+    },
+    "/v1/cases/edges/confirm": {
+      post: { operationId: "confirmCaseEdge", summary: "Confirm a case edge", tags: ["Cases"], responses: { "200": { description: "Edge confirmed" } } }
+    },
+    "/v1/cases/edges/reject": {
+      post: { operationId: "rejectCaseEdge", summary: "Reject a case edge", tags: ["Cases"], responses: { "200": { description: "Edge rejected" } } }
+    },
+    "/v1/cases/{key}/split": {
+      post: { operationId: "splitCase", summary: "Split a case", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Case split" } } }
+    },
+    "/v1/cases/{key}/merge": {
+      post: { operationId: "mergeCases", summary: "Merge cases", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Cases merged" } } }
+    },
+    "/v1/cases/{key}/completeness": {
+      get: { operationId: "getCaseCompleteness", summary: "Get case completeness", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Completeness assessment" } } }
+    },
+    "/v1/cases/{key}/pin": {
+      post: { operationId: "pinCaseDocuments", summary: "Pin documents to a case", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Documents pinned" } } }
+    },
+    "/v1/cases/{key}/documents": {
+      delete: { operationId: "removeCaseDocuments", summary: "Remove documents from a case", tags: ["Cases"], parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Documents removed" } } }
+    },
+    // Expanded: Batches
+    "/v1/batches/{id}/sync": {
+      post: { operationId: "syncBatch", summary: "Sync batch status with provider", tags: ["Batches"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Batch synced" } } }
+    },
+    "/v1/batches/{id}/cancel": {
+      post: { operationId: "cancelBatch", summary: "Cancel a batch inference run", tags: ["Batches"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Batch cancelled" } } }
+    },
+    // Expanded: Matching
+    "/v1/matching/smart-run": {
+      post: { operationId: "triggerSmartMatchingRun", summary: "Trigger a smart matching run", tags: ["Matching"], responses: { "201": { description: "Smart matching run queued" } } }
+    },
+    "/v1/matching/ai-resolve": {
+      post: { operationId: "aiResolveMatching", summary: "AI-resolve ambiguous matches", tags: ["Matching"], responses: { "200": { description: "AI resolution results" } } }
+    },
+    "/v1/matching/strategies": {
+      get: { operationId: "listMatchingStrategies", summary: "List matching strategies", tags: ["Matching"], responses: { "200": { description: "List of matching strategies" } } },
+      post: { operationId: "createMatchingStrategy", summary: "Create a matching strategy", tags: ["Matching"], responses: { "201": { description: "Matching strategy created" } } }
+    },
+    "/v1/matching/strategies/{id}": {
+      get: { operationId: "getMatchingStrategy", summary: "Get a matching strategy", tags: ["Matching"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Matching strategy detail" } } },
+      put: { operationId: "updateMatchingStrategy", summary: "Update a matching strategy", tags: ["Matching"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Matching strategy updated" } } },
+      delete: { operationId: "deleteMatchingStrategy", summary: "Delete a matching strategy", tags: ["Matching"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Matching strategy deleted" } } }
+    },
+    "/v1/matching/runs/{id}/results": {
+      get: { operationId: "getMatchingRunResults", summary: "Get matching run results", tags: ["Matching"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Matching run results" } } }
+    },
+    "/v1/matching/runs/{id}/progress": {
+      get: { operationId: "getMatchingRunProgress", summary: "Get matching run progress", tags: ["Matching"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Matching run progress" } } }
+    },
+    "/v1/matching/review": {
+      post: { operationId: "submitMatchingReview", summary: "Submit matching review decisions", tags: ["Matching"], responses: { "200": { description: "Review decisions applied" } } }
+    },
+    // Expanded: Review
+    "/v1/review/assign": {
+      post: { operationId: "assignReview", summary: "Assign review records", tags: ["Review"], responses: { "200": { description: "Records assigned" } } }
+    },
+    "/v1/review/stats": {
+      get: { operationId: "getReviewStats", summary: "Get review queue statistics", tags: ["Review"], responses: { "200": { description: "Review statistics" } } }
+    },
+    // Expanded: Quality
+    "/v1/quality/ground-truth/{id}/entries": {
+      get: { operationId: "listGroundTruthEntries", summary: "List ground truth entries", tags: ["Quality"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Paginated list of entries" } } },
+      post: { operationId: "createGroundTruthEntry", summary: "Add a ground truth entry", tags: ["Quality"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "201": { description: "Entry created" } } }
+    },
+    "/v1/quality/ground-truth/{id}/entries/{entryId}": {
+      put: { operationId: "updateGroundTruthEntry", summary: "Update a ground truth entry", tags: ["Quality"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }, { name: "entryId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Entry updated" } } },
+      delete: { operationId: "deleteGroundTruthEntry", summary: "Delete a ground truth entry", tags: ["Quality"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }, { name: "entryId", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Entry deleted" } } }
+    },
+    "/v1/quality/benchmarks/{id}/results": {
+      get: { operationId: "getBenchmarkResults", summary: "Get benchmark results", tags: ["Quality"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Benchmark results" } } }
+    },
+    "/v1/quality/benchmarks/{id}/compare": {
+      get: { operationId: "compareBenchmarks", summary: "Compare two benchmark runs", tags: ["Quality"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { "200": { description: "Benchmark comparison" } } }
+    },
+    // Expanded: Reference Data
+    "/v1/reference-data/create": {
+      post: { operationId: "createReferenceDataJson", summary: "Create reference data from JSON", tags: ["Reference Data"], responses: { "201": { description: "Reference dataset created" } } }
     }
   }
 };
@@ -5056,9 +5406,22 @@ Key endpoints:
 - GET /v1/documents \u2014 List with cursor pagination; GET /v1/documents/:id/markdown for OCR text
 - GET /v1/extractions \u2014 Query results and field corrections
 - POST /v1/schemas \u2014 Create/manage extraction schemas
-- GET /v1/jobs \u2014 Track async jobs and results
+- GET /v1/jobs \u2014 Track async jobs and results; N-Shot comparisons, overrides, judge decisions
 - POST /v1/sources \u2014 Manage API sources and document ingest
 - POST /v1/webhooks \u2014 Configure webhook endpoints
+- /v1/resolutions \u2014 Resolution runs: list, create, get, execute, delete, results
+- /v1/linking \u2014 Link keys, document links, entity graph, classify, backfill, document-case map
+- /v1/schema-graph \u2014 Schema classes, versions, diffs (approve/reject), edges, aliases, visualize
+- /v1/structuring \u2014 Validation checks CRUD, approval gates CRUD with rules, result checks, pending approvals, approve/reject, delivery trigger
+- /v1/telemetry \u2014 Per-schema and per-run summaries, trends, field-level breakdowns
+- /v1/validation \u2014 Golden samples (list, get, delete), validation runs (list, create, get, delete, results)
+- /v1/credits \u2014 Balance, history, usage summary, daily usage, per-request usage log
+- /v1/cases \u2014 Status updates, edges, edge confirm/reject, split/merge, completeness, pin/remove documents
+- /v1/batches \u2014 Sync with provider, cancel
+- /v1/matching \u2014 Smart run, AI resolve, strategies CRUD, run results/progress, review
+- /v1/review \u2014 Assign, stats
+- /v1/quality \u2014 Ground truth entries CRUD, benchmark results, benchmark comparison
+- /v1/reference-data \u2014 JSON upload (POST create)
 
 Webhook events: extraction.completed, job.completed, export.completed, validation.completed. All HMAC-SHA256 signed with retry on failure.