@adoptai/genui-components 0.1.57 → 0.1.58

package/dist/tool-definitions.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.1.57",
-  "generated_at": "2026-06-23T19:01:49.313Z",
-  "schema_count": 58,
+  "version": "0.1.58",
+  "generated_at": "2026-06-24T15:47:16.404Z",
+  "schema_count": 59,
   "schemas": {
     "data-table": {
       "name": "render_data_table",
@@ -4737,6 +4737,230 @@
         ]
       }
     },
+    "document-field-extraction": {
+      "name": "render_document_field_extraction",
+      "description": "Render extracted document fields as an interactive overlay on the page image(s) — colored bounding boxes per field plus a synced field-card list. Use after the extract_document tool returns; pass the returned payload_ref (the host expands it). For invoices, statements, tax forms, receipts, KYC/loan docs, POs where the user wants to SEE where each value sits on the page.",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "document-field-extraction"
+            ]
+          },
+          "doc_type": {
+            "type": "string"
+          },
+          "file_name": {
+            "type": "string",
+            "description": "Original uploaded filename; shown as the card title."
+          },
+          "payload_ref": {
+            "type": "string",
+            "description": "Durable store key returned by extract_document; the GenUI host expands it into pages/fields at render time. Pass this verbatim — do NOT hand-build pages/fields."
+          },
+          "store_id": {
+            "type": "string",
+            "description": "Docstore store id; present for persisted workstream docs. The host uses this to open the editable viewer."
+          },
+          "doc_id": {
+            "type": "string",
+            "description": "Docstore document id; present for persisted workstream docs. Required for the editable viewer."
+          },
+          "pages": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "page": {
+                  "type": "number",
+                  "description": "0-indexed page number"
+                },
+                "imageUrl": {
+                  "type": "string"
+                },
+                "width_pt": {
+                  "type": "number"
+                },
+                "height_pt": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "page",
+                "width_pt",
+                "height_pt"
+              ]
+            }
+          },
+          "fields": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "field_key": {
+                  "type": "string"
+                },
+                "label": {
+                  "type": "string"
+                },
+                "value": {
+                  "type": "string"
+                },
+                "page": {
+                  "type": "number",
+                  "description": "0-indexed page number"
+                },
+                "bbox": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "[x0,y0,x1,y1] PDF points, origin bottom-left; null if unlocated"
+                },
+                "confidence": {
+                  "type": "number"
+                },
+                "confidence_tier": {
+                  "type": "string",
+                  "enum": [
+                    "green",
+                    "amber",
+                    "red"
+                  ]
+                },
+                "badge": {
+                  "type": "string",
+                  "enum": [
+                    "SC",
+                    "CN",
+                    "AB",
+                    "SW"
+                  ]
+                },
+                "state": {
+                  "type": "string",
+                  "enum": [
+                    "ok",
+                    "corrected",
+                    "missing",
+                    "warn"
+                  ]
+                },
+                "entity_type": {
+                  "type": "string"
+                },
+                "is_primary": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "field_key",
+                "label",
+                "value",
+                "page"
+              ]
+            }
+          },
+          "page_count": {
+            "type": "number"
+          },
+          "pages_processed": {
+            "type": "number"
+          },
+          "summary": {
+            "type": "object",
+            "description": "Deterministic document summary for the Details tab (display_name, organization, domain, stats, facts, tags). Produced by the extractor — pass through verbatim.",
+            "properties": {
+              "display_name": {
+                "type": "string"
+              },
+              "short_name": {
+                "type": "string"
+              },
+              "organization": {
+                "type": "string"
+              },
+              "domain": {
+                "type": "string"
+              },
+              "domain_group": {
+                "type": "string"
+              },
+              "tax_year": {
+                "type": "string"
+              },
+              "crumbs": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "tags": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "stats": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "field_key": {
+                      "type": "string"
+                    },
+                    "label": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    },
+                    "caption": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "field_key",
+                    "label",
+                    "value"
+                  ]
+                }
+              },
+              "facts": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "field_key": {
+                      "type": "string"
+                    },
+                    "label": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": "string"
+                    },
+                    "badge": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "field_key",
+                    "label",
+                    "value"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "required": [
+          "type"
+        ]
+      }
+    },
     "decision-card": {
       "name": "render_decision_card",
       "description": "Render an inline human-in-the-loop (HITL) decision card — a single judgment the agent needs from the user, resolved in-thread. Shows a titled question with an optional dollar amount at stake, optional data-quality flags, and 2-5 mutually-exclusive resolution options (the first or `recommended` one renders as the primary action), plus an optional 'view source' link. Use for inline approve/choose decisions the user resolves directly in the conversation. NOT for handing off to an external review portal (use escalation-card) and NOT for collecting multiple typed fields (use render_builder).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adoptai/genui-components",
-  "version": "0.1.57",
+  "version": "0.1.58",
   "description": "Schema-driven generative UI components for Adopt agents",
   "private": false,
   "license": "UNLICENSED",