@talonic/docs 0.19.1 → 0.19.2

package/dist/content.js

@@ -1,23 +1,23 @@
 // src/content/helpers.ts
-function deriveBreadcrumbs(sections44, leafId, domain) {
+function deriveBreadcrumbs(sections45, leafId, domain) {
   const root = {
     label: domain === "api" ? "API Reference" : "Platform Guide",
     slug: domain
   };
-  for (const group of sections44) {
+  for (const group of sections45) {
     const child = group.children?.find((c) => c.id === leafId);
     if (child) {
       return [root, { label: group.label, slug: group.id }, { label: child.label, slug: child.id }];
     }
   }
-  const topLevel = sections44.find((s) => s.id === leafId);
+  const topLevel = sections45.find((s) => s.id === leafId);
   if (topLevel) {
     return [root, { label: topLevel.label, slug: topLevel.id }];
   }
   return [root];
 }
-function derivePrevNext(sections44, leafId) {
-  const flat = sections44.flatMap(
+function derivePrevNext(sections45, leafId) {
+  const flat = sections45.flatMap(
     (s) => s.children ?? [{ id: s.id, label: s.label }]
   );
   const idx = flat.findIndex((c) => c.id === leafId);
@@ -221,6 +221,9 @@ var API_NAV_SECTIONS = [
     { id: "manage-routing-rule", label: "Manage Rule" },
     { id: "reorder-routing-rules", label: "Reorder" }
   ] },
+  { id: "registry", label: "Registry", children: [
+    { id: "registry-query", label: "Query" }
+  ] },
   { id: "billing", label: "Billing", children: [
     { id: "billing-settings", label: "Settings" },
     { id: "billing-topup", label: "Auto Top-Up" },
@@ -10883,8 +10886,121 @@ X-Talonic-Cells-Resolved-AI: 1`
   }
 ];
 
-// src/content/api/errors-rate-limits.ts
+// src/content/api/registry.ts
 var sections43 = [
+  {
+    slug: "registry-query",
+    parentSlug: "registry",
+    title: "Query the Registry",
+    seoTitle: "Registry Query \u2014 Ingest Once, Query Forever \u2014 Talonic Docs",
+    description: "Query previously-extracted field values across all documents without re-extraction. Zero AI calls. Filter by field values and select which fields to return.",
+    content: [
+      {
+        type: "paragraph",
+        text: "The registry query endpoint searches across **all previously-extracted documents** by field values. No document upload, no re-extraction, no AI calls. Documents ingested days or months ago are queryable immediately."
+      },
+      {
+        type: "endpoint",
+        method: "POST",
+        path: "/v1/registry/query",
+        summary: "Query extracted field values across documents.",
+        description: "Requires read scope. Returns flat rows with one entry per matching document. All `where` conditions are ANDed.",
+        blocks: [
+          {
+            type: "param-table",
+            title: "Body parameters",
+            params: [
+              { name: "where", type: "object", required: true, description: "Field-value conditions. Keys are field names, values are the expected values. All conditions are ANDed." },
+              { name: "select", type: "string[]", description: "Field names to return in results. If omitted, returns all fields referenced in `where`." },
+              { name: "limit", type: "integer", description: "Maximum rows to return (default 100, max 500).", default: "100" }
+            ]
+          },
+          {
+            type: "code",
+            title: "Request",
+            language: "json",
+            code: `{
+  "where": {
+    "vendor_name": "Meridian Energy AG",
+    "contract_year": "2026"
+  },
+  "select": ["contract_value", "auto_renew", "notice_period_days"],
+  "limit": 50
+}`
+          },
+          {
+            type: "code",
+            title: "Response",
+            language: "json",
+            code: `{
+  "data": [
+    {
+      "document_id": "d7a1b2c3-...",
+      "filename": "meridian-framework-2026.pdf",
+      "document_type": "Framework Agreement",
+      "vendor_name": "Meridian Energy AG",
+      "contract_year": "2026",
+      "contract_value": "450000",
+      "auto_renew": "true",
+      "notice_period_days": "90"
+    },
+    {
+      "document_id": "e8f4a5b6-...",
+      "filename": "meridian-amendment-q2.pdf",
+      "document_type": "Contract Amendment",
+      "vendor_name": "Meridian Energy AG",
+      "contract_year": "2026",
+      "contract_value": "475000",
+      "auto_renew": "true",
+      "notice_period_days": "90"
+    }
+  ],
+  "total": 2
+}`
+          },
+          {
+            type: "callout",
+            text: "Field names in `where` and `select` are resolved against your workspace's field registry by canonical name (case-insensitive). Unknown field names return an error."
+          },
+          {
+            type: "paragraph",
+            text: "**How it works:** The query searches the `resolved_document_values` table \u2014 materialized field values produced by the extraction and jobs pipeline. Every field extracted from every document is queryable. No LLM calls are made."
+          }
+        ]
+      }
+    ],
+    related: [
+      { label: "Field Registry", slug: "field-registry" },
+      { label: "Filter Documents", slug: "filter-documents" },
+      { label: "POST /v1/extract", slug: "post-extract" }
+    ],
+    faq: [
+      {
+        question: "Does registry query re-extract documents?",
+        answer: "No. It searches previously-extracted field values with zero AI calls. Documents can have been ingested days or months ago."
+      },
+      {
+        question: "What field names can I use in where and select?",
+        answer: "Any canonical field name from your workspace's field registry. Names are resolved case-insensitively. Use GET /v1/fields to discover available field names."
+      },
+      {
+        question: "How is this different from POST /filter/documents?",
+        answer: "Registry query returns flat rows (field name \u2192 value), shaped for agents and programmatic consumption. Filter documents returns document objects with nested field_values, shaped for UI consumption."
+      }
+    ],
+    mentions: [
+      "registry query",
+      "ingest once",
+      "query forever",
+      "field values",
+      "zero re-extraction",
+      "resolved_document_values"
+    ]
+  }
+];
+
+// src/content/api/errors-rate-limits.ts
+var sections44 = [
   {
     slug: "error-format",
     parentSlug: "errors-rate-limits",
@@ -11037,7 +11153,8 @@ var ALL_API_RAW = [
   ...sections40,
   ...sections41,
   ...sections42,
-  ...sections43
+  ...sections43,
+  ...sections44
 ];
 function enrich(raw, navSections, domain) {
   return raw.map((r) => {

package/dist/index.js

@@ -6565,6 +6565,9 @@ var API_NAV_SECTIONS = [
     { id: "manage-routing-rule", label: "Manage Rule" },
     { id: "reorder-routing-rules", label: "Reorder" }
   ] },
+  { id: "registry", label: "Registry", children: [
+    { id: "registry-query", label: "Query" }
+  ] },
   { id: "billing", label: "Billing", children: [
     { id: "billing-settings", label: "Settings" },
     { id: "billing-topup", label: "Auto Top-Up" },
@@ -6715,6 +6718,7 @@ var API_SECTION_META = [
   { id: "review", title: "Review API", description: "Review queue for validation records \u2014 list items, stats, take action (approve/reject/flag), batch operations, and assignment." },
   { id: "quality", title: "Quality API", description: "Ground truth datasets, entries management with CSV import, benchmark runs, per-field accuracy results, and benchmark comparison." },
   { id: "routing-rules", title: "Routing Rules API", description: "Document routing rules \u2014 create, manage, and reorder priority-based rules for automatic document workflow assignment." },
+  { id: "registry", title: "Registry API", description: "Query previously-extracted field values across all documents \u2014 ingest once, query forever. Zero re-extraction, zero AI calls." },
   { id: "billing", title: "Billing API", description: "Billing settings, auto top-up for AI agents, and cost response headers on extraction requests." },
   { id: "errors-rate-limits", title: "Errors & Rate Limits", description: "Error response format, error codes, rate limit tiers by plan, and rate limit headers." }
 ];