@talonic/docs 0.6.2 → 0.8.0

package/dist/seo.js

@@ -57,6 +57,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" },
@@ -156,6 +227,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 = [
@@ -272,6 +350,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" } } }
     }
   }
 };
@@ -292,52 +629,147 @@ var PLATFORM_FAQ = [
 ];
 var LLMS_TXT = `# Talonic
 
-> Extract any document into schema-validated data with a single API call.
+> AI-powered document structuring platform that turns unstructured files into schema-validated, provenance-tracked structured data.
 
-Talonic is an AI-powered document structuring platform. It ingests unstructured documents (PDFs, scans, images, spreadsheets), discovers fields through semantic clustering, and produces structured datasets with per-cell provenance, confidence scores, and reasoning traces.
+Talonic ingests documents in 25+ formats (PDFs, scans, images, spreadsheets, emails, archives), discovers every data field through AI extraction and semantic clustering, and produces structured datasets with per-cell confidence scores, reasoning traces, and source provenance. It runs a single deployable stack with Postgres + pgvector, Anthropic Claude for extraction, and Mistral Document AI for OCR.
 
-## Documentation
+## How It Works
 
-- [API Documentation](https://talonic.com/docs): Complete REST API reference
-- [Platform Guide](https://talonic.com/docs/platform): Product documentation and feature guide
-- [OpenAPI Spec](https://talonic.com/docs/openapi.json): Machine-readable API specification
+1. **Upload** \u2014 Drag files/folders into Inputs or ingest via API. ZIP archives unpack automatically. Files are deduplicated via SHA-256 hashing.
+2. **Extract** \u2014 Each document goes through Document AI OCR (converts to Markdown), classification against a 529-type ontology, and AI field extraction (discovers every data point with confidence and source text).
+3. **Build Schema** \u2014 Extracted fields resolve into the Field Registry (canonical names, semantic clusters, master instructions). Define a user template selecting the fields you need.
+4. **Run Job** \u2014 A 4-phase pipeline fills every cell in a documents \xD7 fields grid. ~30% filled instantly from graph matches, ~70% from AI agents.
+5. **Deliver** \u2014 Push approved data to webhooks, REST APIs, SFTP, email, or S3/R2 cloud storage.
+
+## Sources & Documents
+
+Supported formats across three processing paths:
+- **Text fast-path** (direct read): TXT, MD, HTML, XML, JSON, EML, CSV
+- **AI Vision** (multimodal): PNG, JPG, JPEG, GIF, WEBP
+- **OCR** (Mistral Document AI \u2192 Markdown): PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, XLSM, MSG, BMP
+- **Archives**: ZIP (recursive unpack)
+
+Upload methods: drag-and-drop UI, folder upload (preserves file paths), API upload (single, batch up to 200 files, or archive up to 500 MB). Batch mode available at 50% cost with 48-hour delivery window.
+
+Every document is classified into a canonical type from the 529-type ontology (e.g., "Employment Contract", "Invoice", "Bill of Lading"). Classification is language-agnostic \u2014 a German Arbeitsvertrag maps to the same type as an English Employment Contract. Unresolvable documents get "Unclassified Document".
+
+Document detail tabs: Raw Extraction (every field with confidence), Resolved Data (mapped to registry), Processing Log (per-stage timing), Original File.
+
+## Field Registry
+
+The unified knowledge graph of all canonical fields, growing smarter with every document processed.
+
+- **Tier 1 (Core)**: Universal fields across many document types. Most reliable.
+- **Tier 2 (Established)**: Promoted from Tier 3 after frequency thresholds. Production-ready.
+- **Tier 3 (Emerging)**: Newly discovered from a few documents. May promote as more data arrives.
+
+Fields with similar meanings cluster automatically via AI embeddings (e.g., "Vendor Name", "Supplier Name", "Company Name" \u2192 same cluster). Master instructions are AI-synthesized extraction directives that improve accuracy over time.
+
+## Schemas
 
-## API Quick Start
+Two types: **Generated schemas** (auto-created per document type from Tier 1+2 fields) and **User templates** (user-defined output structures).
 
-Base URL: https://api.talonic.com
-Auth: Bearer token (tlnc_ prefix)
+Template workflow: name it \u2192 add fields (display name, data type, extraction instructions) \u2192 map to registry (exact/semantic/composite matching) \u2192 add reference tables \u2192 publish an immutable version.
 
-Extract a document:
-\`\`\`
-curl -X POST https://api.talonic.com/v1/extract \\
-  -H "Authorization: Bearer tlnc_sk_live_..." \\
-  -F "file=@document.pdf" \\
-  -F 'schema={"vendor_name":"string","total":"number"}'
-\`\`\`
+Field features: format constraints (regex validation with empty/flag/constant fallback), modifiers (date/number format, alias mapping, max_length), bypass strategies (constant, generator, reference lookup \u2014 skip LLM), capture submoves (match \u2192 compute \u2192 reason), output name remapping.
 
-## Key Endpoints
+Versioning: Live (published, read-only), Workshop (mutable draft), Version History (timeline with diff). Test extraction compares draft vs. live results before publishing.
 
-- POST /v1/extract \u2014 Extract structured data from a document
-- GET /v1/documents \u2014 List and manage documents
-- GET /v1/extractions \u2014 Query extraction results
-- POST /v1/schemas \u2014 Create reusable extraction schemas
-- GET /v1/jobs \u2014 Track async extraction jobs
-- POST /v1/sources \u2014 Manage document sources with API keys
+## Extraction Jobs (Runs)
 
-## Platform Features
+A job applies a schema to documents, producing a grid (rows = documents, columns = fields). Navigate to Structuring \u2192 Runs \u2192 New.
 
-- 25+ file format support (PDF, DOCX, images, spreadsheets, archives)
-- Field Registry: unified knowledge graph of canonical fields with tier system
-- 4-phase extraction pipeline: Resolve \u2192 Agent \u2192 Validate \u2192 Re-read
-- Document linking and case discovery through shared entities
-- Validation checks, golden samples, and approval gates
-- Export to webhooks, REST APIs, SFTP, email, cloud storage
-- HMAC-SHA256 signed webhooks with retry policy
+**4-phase pipeline:**
+1. **Resolve** \u2014 ~30% of cells in seconds. Graph matches, fuzzy name matching, concept-synonym expansion, 3-tier reference lookup (normalize \u2192 fuzzy \u2192 AI), description scan. No AI calls (except rare Haiku fallback). Values normalized: dates \u2192 YYYY/MM/DD, numbers \u2192 2 decimal places.
+2. **Agent** \u2014 AI reviews gap patterns and produces typed strategy per field: compute (formula from grid values), transfer (copy from equivalent field), extract (re-read document with instructions, 5 concurrent), skip (with reasoning). Fields with manual instructions are always extracted, never skipped.
+3. **Validation** \u2014 Cross-field sanity checks: date_sanity, amount_mismatch, lookup_failed, low_confidence_outlier, unexpected_empty. Flags are informational only \u2014 never block output.
+4. **Re-read** \u2014 Context-aware gap filling. For each empty/low-confidence cell, AI re-reads the original document with field instruction + full grid context. Respects the confidence gate: cells \u2265 0.7 confidence are permanently protected.
 
-## Optional
+Per-cell provenance: confidence (0.0\u20131.0), resolution_type (graph_match | agent_derived | source_reread | unresolved), phase (1\u20134), reasoning trace, source reference (document, page, field).
 
-- [API Documentation (Markdown)](https://talonic.com/docs/api.md)
-- [Platform Guide (Markdown)](https://talonic.com/docs/platform.md)
+## Cases & Document Linking
+
+Registry fields can be link keys: Identity (company/person names), Transaction (contract/PO/invoice numbers), Reference (project codes, cost centers). The linking pipeline normalizes values and builds a bipartite graph of documents \u2194 entities.
+
+A **case** = 2+ documents connected through transaction/reference entities. An **entity group** = 2+ documents connected through identity-only entities. High-frequency entities (>30% of documents) are auto-excluded from case formation.
+
+Case detail: documents, shared entities, evidence chain, timeline, AI-generated narration. Document Graph provides a D3-force visual layout. Case templates auto-discovered after 3+ cases form.
+
+## Smart Matching
+
+Upload CSV/Excel as reference datasets. Define field-to-field comparisons with weighted strategies: exact (case-insensitive), fuzzy (token-based with similarity threshold), date_range (configurable tolerance), numeric_range (percentage or absolute tolerance). AI can auto-suggest field mappings.
+
+Results: top 5 candidates per document with confidence scores and per-field evidence breakdown.
+
+## Validation & Quality
+
+- **Validation checks**: Schema-level rules (field format, value range, cross-field consistency, AI-proposed coherence). Run during Phase 3.
+- **Golden samples**: Manually-created reference datasets. Benchmark runs compare extraction vs. golden for per-field accuracy with AI judge verdicts.
+- **Approval gates**: Threshold-based auto-approve/flag (minimum confidence, validation pass rate, field coverage). Failed rows go to manual review queue.
+
+## Delivery
+
+Destinations: Webhook (HMAC-SHA256 signed), REST API (configurable headers), SFTP, Email (attachments), S3/R2 (cloud storage).
+
+Field mappings transform output fields to match destination format. Triggers: auto on approval (stage/push), scheduled (cron), or manual. Failed exports retry with exponential backoff.
+
+Dialects control serialization: date_format, number_locale, CSV delimiter, null representation, boolean format, encoding (UTF-8, UTF-8-BOM, ISO-8859-1).
+
+## Search & Navigation
+
+**Omnisearch** (Cmd+K / Ctrl+K): searches across documents, extracted values, field names, schema names, and sources simultaneously.
+
+Document filters: field-value conditions with autocomplete, comparison operators (eq, contains, gt, between, is_empty), combinable. URL-serializable and saveable as presets.
+
+Keyboard shortcuts: Cmd+K (search), Cmd+J (quick extract), Escape (close overlays).
+
+## Team & Settings
+
+4 roles: Viewer (read-only), Member (full CRUD), Admin (+ team management), Owner (+ billing, API keys, org settings). New members auto-match by email domain with pending approval.
+
+Usage & Registry: per-feature cost breakdown, daily cost chart, call log with model/tokens/cost. Admin master view for cross-tenant stats.
+
+## API
+
+Base URL: \`https://api.talonic.com\`. Auth: \`Authorization: Bearer tlnc_...\` (SHA-256 hashed, shown once at creation). Scopes: extract, read, write.
+
+Key endpoints:
+- POST /v1/extract \u2014 Synchronous/async document extraction (\`include_markdown=true\` returns OCR text, \`processing_mode=batch\` for 50% cost)
+- 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; 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.
+
+## Agent
+
+The embedded AI assistant accessible from any page. Two modes:
+- **Chat mode** \u2014 Ask questions about the platform, your documents, extraction results, schemas, or workflows. Grounded in platform documentation.
+- **Planning mode** \u2014 Request actions (create schemas, run jobs, configure exports). The agent builds a plan, confirms with you, then executes.
+
+Document upload flow: Cmd+J or the upload button opens quick extract. Drop a file, select a schema (or let AI discover fields), and get structured results.
+
+## Documentation
+
+- [API Documentation](https://talonic.com/docs): Complete REST API reference
+- [Platform Guide](https://talonic.com/docs/platform): Product documentation and feature guide
+- [OpenAPI Spec](https://talonic.com/docs/openapi.json): Machine-readable API specification
 `;
 var LLMS_FULL_TXT_HEADER = `# Talonic \u2014 Full Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talonic/docs",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "Talonic documentation components — API Reference & Platform Guide",
   "license": "UNLICENSED",
   "private": false,