@talonic/docs 0.6.1 → 0.7.1

package/dist/index.js

@@ -591,14 +591,21 @@ var NAV_SECTIONS = [
     ]
   },
   {
-    id: "exports",
-    label: "Exports",
+    id: "delivery",
+    label: "Delivery",
     children: [
+      { id: "delivery-overview", label: "Overview" },
       { id: "list-destinations", label: "List Destinations" },
       { id: "create-destination", label: "Create Destination" },
-      { id: "manage-destination", label: "Get / Delete Destination" },
-      { id: "list-triggers", label: "List Triggers" },
-      { id: "create-trigger", label: "Create Trigger" }
+      { id: "manage-destination", label: "Get / Update / Delete" },
+      { id: "test-destination", label: "Test Destination" },
+      { id: "list-bindings", label: "List Bindings" },
+      { id: "create-binding", label: "Create Binding" },
+      { id: "manage-binding", label: "Get / Update / Delete" },
+      { id: "delivery-items", label: "Items (History)" },
+      { id: "delivery-dlq", label: "Dead-Letter Queue" },
+      { id: "delivery-events", label: "Outbox Events" },
+      { id: "delivery-catalog", label: "Catalog" }
     ]
   },
   {
@@ -2283,7 +2290,7 @@ function ApiReference({ LinkComponent }) {
         }
       ) }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "routing", children: "Routing Rules" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Routing rules automatically direct documents to schemas, reviewers, or export destinations based on configurable conditions." }),
+      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Routing rules automatically direct documents to schemas, reviewers, or delivery destinations based on configurable conditions." }),
       /* @__PURE__ */ jsx5("div", { id: "list-routing-rules", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
@@ -2342,108 +2349,250 @@ function ApiReference({ LinkComponent }) {
           /* @__PURE__ */ jsx5(EndpointBlock, { method: "DELETE", path: "/v1/routing-rules/:id", summary: "Delete a routing rule." })
         ] })
       ] }),
-      /* @__PURE__ */ jsx5(SectionHeading, { id: "exports", children: "Exports" }),
-      /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "Configure export destinations (S3, webhook, SFTP) and triggers that automatically push structured data when conditions are met." }),
+      /* @__PURE__ */ jsx5(SectionHeading, { id: "delivery", children: "Delivery" }),
+      /* @__PURE__ */ jsxs5("div", { id: "delivery-overview", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: [
+          "Configure outbound delivery. Emit signals (",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "document.extracted" }),
+          ",",
+          " ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "run.dataspace.completed" }),
+          ", ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "result.approved" }),
+          ", \u2026) are routed through ",
+          /* @__PURE__ */ jsx5("strong", { children: "bindings" }),
+          " that join a signal filter to a",
+          " ",
+          /* @__PURE__ */ jsx5("strong", { children: "deliverable resolver" }),
+          ", a ",
+          /* @__PURE__ */ jsx5("strong", { children: "serializer" }),
+          ", and a",
+          " ",
+          /* @__PURE__ */ jsx5("strong", { children: "destination" }),
+          ". Slice-1 ships the ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "webhook" }),
+          " ",
+          "connector with HMAC-signed payloads, idempotency keys, SSRF guard, payload caps, and a fixed retry ladder; S3, SFTP, Sheets, Drive, and Email arrive in later slices."
+        ] }),
+        /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: [
+          "Every attempt is recorded in the history log (",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "/v1/delivery/items" }),
+          "). Terminal failures land in the dead-letter queue (",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "/v1/delivery/dlq" }),
+          ") and are replayable. The raw outbox is inspectable at",
+          " ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "/v1/delivery/events" }),
+          ". Use",
+          " ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "/v1/delivery/catalog/*" }),
+          " to discover available signals, deliverables, serializers, and connectors \u2014 the catalog drives the compatibility-triangle validator that runs on every binding create/update."
+        ] })
+      ] }),
       /* @__PURE__ */ jsx5("div", { id: "list-destinations", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
         EndpointBlock,
         {
           method: "GET",
-          path: "/v1/exports/destinations",
-          summary: "List all configured export destinations.",
-          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
-  "data": [
-    {
-      "id": "dest_9x2k4m",
-      "name": "Production S3",
-      "type": "s3",
-      "config": { "bucket": "my-exports", "prefix": "structured/" },
-      "created_at": "2024-09-01T00:00:00Z"
-    }
-  ]
-}` })
+          path: "/v1/delivery/destinations",
+          summary: "List delivery destinations.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `[
+  {
+    "id": "7f8a2b44-...",
+    "name": "Analytics webhook",
+    "type": "webhook",
+    "config": { "url": "https://example.com/hook", "headers": {} },
+    "signing_secret": "***",
+    "payload_cap_bytes": null,
+    "is_active": true,
+    "last_delivery_at": "2026-04-23T10:21:00Z",
+    "last_delivery_status": "succeeded",
+    "created_at": "2026-04-15T00:00:00Z",
+    "updated_at": "2026-04-23T10:21:00Z"
+  }
+]` })
         }
       ) }),
       /* @__PURE__ */ jsx5("div", { id: "create-destination", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "POST",
-          path: "/v1/exports/destinations",
-          summary: "Create a new export destination.",
+          path: "/v1/delivery/destinations",
+          summary: "Create a delivery destination.",
           children: [
             /* @__PURE__ */ jsx5(
               ParamTable,
               {
                 title: "Body parameters",
                 params: [
-                  { name: "name", type: "string", required: true, description: "Destination name." },
-                  { name: "type", type: "string", required: true, description: "Type: s3, webhook, sftp." },
-                  { name: "config", type: "object", required: true, description: "Type-specific configuration (bucket, url, host, etc.)." }
+                  { name: "name", type: "string", required: true, description: "Human-readable name." },
+                  { name: "type", type: "string", required: true, description: "Connector type. Slice-1 ships `webhook`." },
+                  { name: "config", type: "object", description: "Connector-specific configuration (e.g. `{ url, headers }`)." },
+                  { name: "auth_config", type: "object", description: "Connector-specific credentials. Never echoed back in full." },
+                  { name: "signing_secret", type: "string", description: "HMAC secret for connectors that sign outbound bodies." },
+                  { name: "payload_cap_bytes", type: "integer", description: "Per-destination TransportWrapper cap override." },
+                  { name: "is_active", type: "boolean", description: "Defaults to true." }
                 ]
               }
             ),
             /* @__PURE__ */ jsx5(CodeBlock, { title: "Response (201)", children: `{
-  "id": "dest_9x2k4m",
-  "name": "Production S3",
-  "type": "s3",
-  "config": { "bucket": "my-exports", "prefix": "structured/" }
+  "id": "7f8a2b44-...",
+  "name": "Analytics webhook",
+  "type": "webhook",
+  "config": { "url": "https://example.com/hook" },
+  "signing_secret": "***",
+  "is_active": true,
+  "created_at": "2026-04-23T10:21:00Z",
+  "updated_at": "2026-04-23T10:21:00Z"
 }` })
           ]
         }
       ) }),
       /* @__PURE__ */ jsxs5("div", { id: "manage-destination", className: "scroll-mt-6", children: [
-        /* @__PURE__ */ jsx5(SubHeading, { id: "manage-destination", children: "Get / Delete Destination" }),
+        /* @__PURE__ */ jsx5(SubHeading, { id: "manage-destination", children: "Get / Update / Delete Destination" }),
         /* @__PURE__ */ jsxs5("div", { className: "space-y-2 mb-6", children: [
-          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/exports/destinations/:id", summary: "Get destination details." }),
-          /* @__PURE__ */ jsx5(EndpointBlock, { method: "DELETE", path: "/v1/exports/destinations/:id", summary: "Delete a destination and its triggers." })
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/destinations/:id", summary: "Get destination detail." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "PUT", path: "/v1/delivery/destinations/:id", summary: "Partial update \u2014 only supplied fields are written." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "DELETE", path: "/v1/delivery/destinations/:id", summary: "Delete a destination. Cascading bindings are removed." })
         ] })
       ] }),
-      /* @__PURE__ */ jsx5("div", { id: "list-triggers", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx5("div", { id: "test-destination", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
-          method: "GET",
-          path: "/v1/exports/triggers",
-          summary: "List all export triggers.",
-          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
-  "data": [
-    {
-      "id": "trig_3n7k9m",
-      "name": "On extraction complete",
-      "destination_id": "dest_9x2k4m",
-      "event": "extraction.completed",
-      "conditions": { "schema_id": "schema_fin_001" }
-    }
-  ]
+          method: "POST",
+          path: "/v1/delivery/destinations/:id/test",
+          summary: "Live-ping a destination through the full transport envelope.",
+          children: [
+            /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: [
+              "Exercises the complete delivery envelope (SSRF guard, payload cap, rate limit \u2014 retry ladder is disabled, ",
+              /* @__PURE__ */ jsx5(InlineCode, { children: "max_attempts: 1" }),
+              ") with a tiny test payload."
+            ] }),
+            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `{
+  "success": true,
+  "httpStatus": 200,
+  "durationMs": 284,
+  "message": null
 }` })
+          ]
         }
       ) }),
-      /* @__PURE__ */ jsx5("div", { id: "create-trigger", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
+      /* @__PURE__ */ jsx5("div", { id: "list-bindings", className: "scroll-mt-6", children: /* @__PURE__ */ jsx5(
+        EndpointBlock,
+        {
+          method: "GET",
+          path: "/v1/delivery/bindings",
+          summary: "List delivery bindings.",
+          children: /* @__PURE__ */ jsx5(CodeBlock, { title: "Response", children: `[
+  {
+    "id": "4c2e1a39-...",
+    "name": "Extracted docs -> analytics",
+    "signal_filter": { "event_type": "document.extracted" },
+    "deliverable_type": "document_meta",
+    "destination_id": "7f8a2b44-...",
+    "serializer_format": "json",
+    "is_active": true
+  }
+]` })
+        }
+      ) }),
+      /* @__PURE__ */ jsx5("div", { id: "create-binding", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
         EndpointBlock,
         {
           method: "POST",
-          path: "/v1/exports/triggers",
-          summary: "Create a new export trigger.",
+          path: "/v1/delivery/bindings",
+          summary: "Create a delivery binding.",
           children: [
+            /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: [
+              "Runs the compatibility-triangle validator: the ",
+              /* @__PURE__ */ jsx5(InlineCode, { children: "signal_filter" }),
+              " must be well-formed, the ",
+              /* @__PURE__ */ jsx5(InlineCode, { children: "deliverable_type" }),
+              " must resolve to a registered resolver, the ",
+              /* @__PURE__ */ jsx5(InlineCode, { children: "serializer_format" }),
+              " must resolve to a registered serializer, and the serializer must support the resolver's shape."
+            ] }),
             /* @__PURE__ */ jsx5(
               ParamTable,
               {
                 title: "Body parameters",
                 params: [
-                  { name: "name", type: "string", required: true, description: "Trigger name." },
-                  { name: "destination_id", type: "string", required: true, description: "Target destination." },
-                  { name: "event", type: "string", required: true, description: "Event type: extraction.completed, job.completed." },
-                  { name: "conditions", type: "object", description: "Optional conditions to filter events." }
+                  { name: "name", type: "string", required: true, description: "Human-readable name." },
+                  { name: "signal_filter", type: "object", required: true, description: "Shape: `{ event_type, match? }`. Match is an equality filter on payload keys." },
+                  { name: "deliverable_type", type: "string", required: true, description: "Registered resolver (`/v1/delivery/catalog/deliverables`)." },
+                  { name: "destination_id", type: "uuid", required: true, description: "Destination to deliver to." },
+                  { name: "serializer_format", type: "string", required: true, description: "One of `json`, `ndjson`, `csv`, `csv_file`, `xlsx`, `rows`, `graph`, `raw`, `md`, `txt`." },
+                  { name: "serializer_config", type: "object", description: "Format-specific options (delimiter, include_header, etc.)." },
+                  { name: "field_map", type: "object", description: "Declarative projection: `{ rules, static, drop }`. Drop \u2192 rename \u2192 static in fixed order." },
+                  { name: "delivery_policy", type: "object", description: "Retry/timeout overrides. Defaults to 6 attempts, `[5s, 30s, 2min, 10min, 1h]`." },
+                  { name: "is_active", type: "boolean", description: "Defaults to true." }
                 ]
               }
-            ),
-            /* @__PURE__ */ jsx5(CodeBlock, { title: "Response (201)", children: `{
-  "id": "trig_3n7k9m",
-  "name": "On extraction complete",
-  "destination_id": "dest_9x2k4m",
-  "event": "extraction.completed"
-}` })
+            )
           ]
         }
       ) }),
+      /* @__PURE__ */ jsxs5("div", { id: "manage-binding", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsx5(SubHeading, { id: "manage-binding", children: "Get / Update / Delete Binding" }),
+        /* @__PURE__ */ jsxs5("div", { className: "space-y-2 mb-6", children: [
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/bindings/:id", summary: "Get binding detail." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "PUT", path: "/v1/delivery/bindings/:id", summary: "Partial update. Re-runs the compatibility-triangle validator on changed fields." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "DELETE", path: "/v1/delivery/bindings/:id", summary: "Delete a binding." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "POST", path: "/v1/delivery/bindings/:id/preview", summary: "Synthetic-signal dry run. Stubbed in slice 1." })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs5("div", { id: "delivery-items", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsx5(SubHeading, { id: "delivery-items", children: "Items (History)" }),
+        /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: [
+          "One row per delivery attempt. The processor writes ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "in_flight" }),
+          " at start, then updates to ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "succeeded" }),
+          " or ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "failed" }),
+          ". Replay generates a new attempt with a new idempotency key \u2014 history is append-only."
+        ] }),
+        /* @__PURE__ */ jsxs5("div", { className: "space-y-2 mb-6", children: [
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/items", summary: "List attempts. Filter by binding_id, destination_id, status. Paginated." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/items/:id", summary: "Attempt detail with request/response bodies." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "POST", path: "/v1/delivery/items/:id/replay", summary: "Re-enqueue. Returns `{ enqueued, idempotency_key }`." })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs5("div", { id: "delivery-dlq", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsx5(SubHeading, { id: "delivery-dlq", children: "Dead-Letter Queue" }),
+        /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: "Terminal failures after retry exhaustion (or permanent 4xx errors) land here. Replay enqueues a fresh attempt; dismiss removes the row from the queue without replaying." }),
+        /* @__PURE__ */ jsxs5("div", { className: "space-y-2 mb-6", children: [
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/dlq", summary: "List dead-letter rows. Filter by binding_id, error_code." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/dlq/:id", summary: "Dead-letter detail." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "POST", path: "/v1/delivery/dlq/:id/replay", summary: "Re-enqueue a dead-letter row. Row remains in queue for audit." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "DELETE", path: "/v1/delivery/dlq/:id", summary: "Dismiss the row." })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs5("div", { id: "delivery-events", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsx5(SubHeading, { id: "delivery-events", children: "Outbox Events" }),
+        /* @__PURE__ */ jsxs5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: [
+          "Raw outbox rows with their processing status (",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "enqueued" }),
+          ",",
+          " ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "no-subscribers" }),
+          ", ",
+          /* @__PURE__ */ jsx5(InlineCode, { children: "failed" }),
+          "). Useful for debugging binding matchers. Event IDs are BIGSERIAL (strings)."
+        ] }),
+        /* @__PURE__ */ jsxs5("div", { className: "space-y-2 mb-6", children: [
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/events", summary: "List outbox rows. Filter by event_type. Paginated." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "POST", path: "/v1/delivery/events/:id/replay", summary: "Clear processed_at/processing_status so the poller re-picks the row." })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs5("div", { id: "delivery-catalog", className: "scroll-mt-6", children: [
+        /* @__PURE__ */ jsx5(SubHeading, { id: "delivery-catalog", children: "Catalog" }),
+        /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-4", children: "Introspect the four registries that drive the binding compatibility-triangle. Populate your binding-editor dropdowns from these endpoints rather than hardcoding lists." }),
+        /* @__PURE__ */ jsxs5("div", { className: "space-y-2 mb-6", children: [
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/catalog/signals", summary: "All DeliveryEventType discriminants." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/catalog/deliverables", summary: "Registered resolvers with compatible_signals and shape." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/catalog/serializers", summary: "Registered serializers with supports_kinds (probed)." }),
+          /* @__PURE__ */ jsx5(EndpointBlock, { method: "GET", path: "/v1/delivery/catalog/connectors", summary: "Registered connectors with capabilities()." })
+        ] })
+      ] }),
       /* @__PURE__ */ jsx5(SectionHeading, { id: "review", children: "Review" }),
       /* @__PURE__ */ jsx5("p", { className: "text-[15px] text-void-text-secondary leading-relaxed mb-6", children: "The review queue surfaces extraction results that need human validation. Approve, reject, or batch-process items programmatically." }),
       /* @__PURE__ */ jsx5("div", { id: "list-review", className: "scroll-mt-6", children: /* @__PURE__ */ jsxs5(
@@ -3369,11 +3518,13 @@ var NAV_SECTIONS2 = [
   },
   {
     id: "delivery",
-    label: "Outputs",
+    label: "Delivery",
     children: [
+      { id: "delivery-pipeline", label: "How Delivery Works" },
       { id: "destinations", label: "Destinations" },
-      { id: "field-mappings", label: "Field Mappings" },
-      { id: "export-triggers", label: "Triggers" }
+      { id: "bindings", label: "Bindings" },
+      { id: "signals-catalog", label: "Signals & Catalog" },
+      { id: "delivery-history", label: "History & DLQ" }
     ]
   },
   {
@@ -4085,43 +4236,127 @@ function PlatformGuide({ LinkComponent }) {
       ] }),
       /* @__PURE__ */ jsx6(SubHeading, { id: "approval-gates", children: "Approval Gates" }),
       /* @__PURE__ */ jsx6(P, { children: "Threshold-based rules for auto-approving or flagging results. Configure per schema with criteria: minimum confidence, validation pass rate, field coverage. Results meeting all thresholds are auto-approved; others go to the manual review queue." }),
-      /* @__PURE__ */ jsx6(Callout, { children: "Approval gates integrate with exports \u2014 configure triggers to only push approved rows to your downstream systems." }),
-      /* @__PURE__ */ jsx6(SectionHeading, { id: "delivery", children: "Outputs" }),
-      /* @__PURE__ */ jsx6(P, { children: "Push reviewed and approved data to any downstream system." }),
-      /* @__PURE__ */ jsx6(SubHeading, { id: "destinations", children: "Destinations" }),
+      /* @__PURE__ */ jsxs6(Callout, { children: [
+        "Approval gates feed the delivery pipeline \u2014 bind a",
+        " ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "result.approved" }),
+        " signal to a destination to only ship approved rows to your downstream systems."
+      ] }),
+      /* @__PURE__ */ jsx6(SectionHeading, { id: "delivery", children: "Delivery" }),
+      /* @__PURE__ */ jsx6(P, { children: "Push extracted, resolved, and reviewed data to any downstream system. Delivery is a typed, at-least-once pipeline with idempotency keys on the wire, append-only history, and a dead-letter queue for terminal failures." }),
+      /* @__PURE__ */ jsx6(SubHeading, { id: "delivery-pipeline", children: "How Delivery Works" }),
+      /* @__PURE__ */ jsx6(P, { children: "Every delivery flows through a five-stage pipeline:" }),
       /* @__PURE__ */ jsx6(
         ParamTable,
         {
-          title: "Supported destination types",
+          title: "The delivery pipeline",
           params: [
-            { name: "Webhook", type: "HTTP POST", description: "HMAC-SHA256 signed payloads to your endpoint." },
-            { name: "REST API", type: "HTTP", description: "Push to any REST endpoint with configurable headers." },
-            { name: "SFTP", type: "file", description: "Upload files to SFTP servers." },
-            { name: "Email", type: "attachment", description: "Send structured data as email attachments." },
-            { name: "S3 / R2", type: "object storage", description: "Push to cloud object storage (AWS S3 or Cloudflare R2)." }
+            { name: "1. Signal", type: "event", description: "A producer emits a typed event (e.g. document.extracted, result.approved) into the outbox. Producers are stateless \u2014 they only publish." },
+            { name: "2. Binding", type: "match", description: "A poller drains the outbox and matches each event against active bindings. A binding joins a signal filter to a deliverable + destination + serializer." },
+            { name: "3. Resolver", type: "load", description: "The deliverable resolver loads the payload (document metadata, a record snapshot, an extraction run, \u2026) at delivery time using only entity IDs from the signal." },
+            { name: "4. Serializer", type: "encode", description: "The serializer encodes the payload into the wire format \u2014 json, ndjson, csv, csv_file, xlsx, rows, graph, raw, md, or txt \u2014 after an optional field_map projection." },
+            { name: "5. Connector", type: "transport", description: "The connector ships the encoded bytes through the TransportWrapper (SSRF guard, payload cap, rate limit, retry ladder). Slice-1 connector is webhook." }
           ]
         }
       ),
-      /* @__PURE__ */ jsx6(SubHeading, { id: "field-mappings", children: "Field Mappings" }),
       /* @__PURE__ */ jsxs6(P, { children: [
-        "Transform extraction output fields to match your destination's expected format. Configure source-to-destination field translation rules with value transformations. Manage from",
+        "Every attempt is logged in ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "delivery_items" }),
+        ". Terminal failures (retry exhausted or permanent 4xx) write a ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "delivery_dead_letter" }),
         " ",
-        /* @__PURE__ */ jsx6("strong", { children: "Outputs \u2192 Column Mappings" }),
+        "row, which is replayable. The outbox, history, DLQ, and catalog are all accessible via the",
+        " ",
+        /* @__PURE__ */ jsxs6(LinkComp, { href: "/docs", className: "text-void-accent hover:underline", children: [
+          /* @__PURE__ */ jsx6(InlineCode, { children: "/v1/delivery/*" }),
+          " API"
+        ] }),
         "."
       ] }),
-      /* @__PURE__ */ jsx6(SubHeading, { id: "export-triggers", children: "Triggers" }),
+      /* @__PURE__ */ jsx6(SubHeading, { id: "destinations", children: "Destinations" }),
+      /* @__PURE__ */ jsxs6(P, { children: [
+        "A destination is a connector + configuration + optional credentials. Slice-1 ships the webhook connector; S3, Google Sheets, Drive, SFTP, and Email arrive in later slices. Use ",
+        /* @__PURE__ */ jsx6("strong", { children: "Delivery \u2192 Destinations" }),
+        " to manage them from the dashboard, or",
+        " ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "POST /v1/delivery/destinations" }),
+        " via the API. Every destination supports a live-ping ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "POST /v1/delivery/destinations/:id/test" }),
+        " ",
+        "that exercises the full transport envelope with a tiny test payload."
+      ] }),
       /* @__PURE__ */ jsx6(
         ParamTable,
         {
-          title: "Trigger types",
+          title: "Supported connectors",
           params: [
-            { name: "Auto on approval", type: "event", description: "Export immediately when rows are approved (stage or push mode)." },
-            { name: "Scheduled", type: "cron", description: "Export on a recurring cron schedule." },
-            { name: "Manual", type: "button", description: "Export on demand via button click." }
+            { name: "webhook", type: "HTTP POST", description: "Slice 1. HMAC-SHA256 signed payloads with idempotency keys, 30s timeout, SSRF guard, 5 MiB payload cap (overridable per destination)." },
+            { name: "s3", type: "object storage", description: "Slice 2+. AWS S3 or Cloudflare R2 with per-destination prefix and partitioning." },
+            { name: "sheets", type: "api", description: "Slice 2+. Google Sheets append/upsert via connected accounts (OAuth)." },
+            { name: "drive", type: "api", description: "Slice 2+. Google Drive file upload via connected accounts." },
+            { name: "sftp", type: "file", description: "Slice 2+. SFTP file upload with key or password auth." },
+            { name: "email", type: "smtp", description: "Slice 2+. Structured data as email attachment." }
           ]
         }
       ),
-      /* @__PURE__ */ jsx6(P, { children: "Every export is logged as a record with delivery status and error details. Failed exports retry automatically with exponential backoff." }),
+      /* @__PURE__ */ jsx6(SubHeading, { id: "bindings", children: "Bindings" }),
+      /* @__PURE__ */ jsxs6(P, { children: [
+        "A binding is the routing rule: it joins a ",
+        /* @__PURE__ */ jsx6("strong", { children: "signal filter" }),
+        " (which events?) to a ",
+        /* @__PURE__ */ jsx6("strong", { children: "deliverable type" }),
+        " (what payload shape?) to a ",
+        /* @__PURE__ */ jsx6("strong", { children: "destination" }),
+        " ",
+        "(ship where?) via a ",
+        /* @__PURE__ */ jsx6("strong", { children: "serializer" }),
+        " (encoded how?). On create, the backend validates all four pieces form a compatible triangle \u2014 the serializer must support the resolver's shape, and the connector must support the serializer format."
+      ] }),
+      /* @__PURE__ */ jsxs6(P, { children: [
+        "Optional ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "field_map" }),
+        " (rename/drop/static rules) lets you reshape the payload without custom code. Optional ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "delivery_policy" }),
+        " ",
+        "overrides the default retry ladder (6 attempts at",
+        " ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "5s, 30s, 2min, 10min, 1h" }),
+        ") and timeout."
+      ] }),
+      /* @__PURE__ */ jsx6(SubHeading, { id: "signals-catalog", children: "Signals & Catalog" }),
+      /* @__PURE__ */ jsxs6(P, { children: [
+        "The catalog API (",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "/v1/delivery/catalog/*" }),
+        ") exposes the four registries that drive the binding picker. Use it to populate dropdowns rather than hardcoding lists \u2014 it always reflects the running registry contents."
+      ] }),
+      /* @__PURE__ */ jsx6(
+        ParamTable,
+        {
+          title: "Core signal types",
+          params: [
+            { name: "document.extracted", type: "signal", description: "Fired when a document completes extraction with structured fields." },
+            { name: "document.extraction_failed", type: "signal", description: "Fired when extraction fails terminally." },
+            { name: "run.dataspace.completed", type: "signal", description: "Fired when a dataspace job run completes." },
+            { name: "run.structuring.completed", type: "signal", description: "Fired when a structuring run completes." },
+            { name: "run.resolution.completed", type: "signal", description: "Fired when a resolution run (field normalization + transforms) completes." },
+            { name: "run.extraction.completed", type: "signal", description: "Fired when a multi-document extraction (batch-inference) run completes." },
+            { name: "result.approved", type: "signal", description: "Fired when a reviewer approves a record." },
+            { name: "result.rejected", type: "signal", description: "Fired when a reviewer rejects a record." },
+            { name: "result.flagged", type: "signal", description: "Fired when validation flags fire on a record." },
+            { name: "delivery.item.completed", type: "meta", description: "Fired after a successful delivery. Meta-signal \u2014 the poller prevents re-binding loops." },
+            { name: "delivery.item.failed", type: "meta", description: "Fired after a terminal delivery failure." }
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx6(SubHeading, { id: "delivery-history", children: "History & DLQ" }),
+      /* @__PURE__ */ jsxs6(P, { children: [
+        "Every delivery attempt writes a row to ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "/v1/delivery/items" }),
+        " with its status, HTTP code, error code, and request/response bodies. Terminal failures (retry ladder exhausted or permanent 4xx) escalate to",
+        " ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "/v1/delivery/dlq" }),
+        ". Both are fully replayable \u2014 replay enqueues a new attempt with a fresh idempotency key. Nothing in history is ever mutated; the log is strictly append-only."
+      ] }),
       /* @__PURE__ */ jsx6(SectionHeading, { id: "search-filtering", children: "Search & Filtering" }),
       /* @__PURE__ */ jsx6(SubHeading, { id: "omnisearch", children: "Omnisearch" }),
       /* @__PURE__ */ jsxs6(P, { children: [
@@ -4175,21 +4410,35 @@ function PlatformGuide({ LinkComponent }) {
             { 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/sources", type: "CRUD", description: "API source management and document ingest." },
-            { name: "/v1/webhooks", type: "CRUD", description: "Webhook endpoint configuration." }
+            { name: "/v1/delivery", type: "CRUD", description: "Outbound delivery: destinations, bindings, history, DLQ, outbox, catalog." }
           ]
         }
       ),
       /* @__PURE__ */ jsx6(SubHeading, { id: "webhooks", children: "Webhooks" }),
       /* @__PURE__ */ jsx6(P, { children: "Webhooks push real-time notifications when events occur. All payloads are HMAC-SHA256 signed. Failed deliveries retry with exponential backoff." }),
+      /* @__PURE__ */ jsxs6(P, { children: [
+        "The webhook connector is configured as a ",
+        /* @__PURE__ */ jsx6("strong", { children: "delivery destination" }),
+        ". Bind any of the signal types below to a webhook destination to receive real-time notifications. See ",
+        /* @__PURE__ */ jsx6(InlineCode, { children: "/v1/delivery/catalog/signals" }),
+        " for the exhaustive list."
+      ] }),
       /* @__PURE__ */ jsx6(
         ParamTable,
         {
-          title: "Webhook event types",
+          title: "Delivery signal types (webhook-compatible)",
           params: [
-            { name: "extraction.completed", type: "event", description: "A document extraction has finished." },
-            { name: "job.completed", type: "event", description: "An extraction job has completed all phases." },
-            { name: "export.completed", type: "event", description: "An export has been delivered." },
-            { name: "validation.completed", type: "event", description: "A validation run has finished." }
+            { name: "document.extracted", type: "event", description: "A document extraction has finished successfully." },
+            { name: "document.extraction_failed", type: "event", description: "A document extraction has failed terminally." },
+            { name: "run.dataspace.completed", type: "event", description: "A dataspace job run completed." },
+            { name: "run.structuring.completed", type: "event", description: "A structuring run completed." },
+            { name: "run.resolution.completed", type: "event", description: "A resolution run (field normalization + transforms) completed." },
+            { name: "run.extraction.completed", type: "event", description: "A multi-document extraction (batch-inference) run completed." },
+            { name: "result.approved", type: "event", description: "A reviewer approved a record." },
+            { name: "result.rejected", type: "event", description: "A reviewer rejected a record." },
+            { name: "result.flagged", type: "event", description: "Validation flags fired on a record." },
+            { name: "delivery.item.completed", type: "meta", description: "A delivery succeeded. Meta-signal \u2014 not re-delivered to avoid loops." },
+            { name: "delivery.item.failed", type: "meta", description: "A delivery failed terminally." }
           ]
         }
       ),
@@ -4698,52 +4947,134 @@ 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.
 
-## API Quick Start
+## Sources & Documents
 
-Base URL: https://api.talonic.com
-Auth: Bearer token (tlnc_ prefix)
+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)
 
-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"}'
-\`\`\`
+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
+
+Two types: **Generated schemas** (auto-created per document type from Tier 1+2 fields) and **User templates** (user-defined output structures).
+
+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.
 
-## Key Endpoints
+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.
 
-- 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
+Versioning: Live (published, read-only), Workshop (mutable draft), Version History (timeline with diff). Test extraction compares draft vs. live results before publishing.
 
-## Platform Features
+## Extraction Jobs (Runs)
 
-- 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
+A job applies a schema to documents, producing a grid (rows = documents, columns = fields). Navigate to Structuring \u2192 Runs \u2192 New.
 
-## Optional
+**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.
 
-- [API Documentation (Markdown)](https://talonic.com/docs/api.md)
-- [Platform Guide (Markdown)](https://talonic.com/docs/platform.md)
+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).
+
+## 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
+- POST /v1/sources \u2014 Manage API sources and document ingest
+- POST /v1/webhooks \u2014 Configure webhook endpoints
+
+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