@adoptai/genui-components 0.1.56 → 0.1.58

package/dist/shared/InteractionContext.d.ts

@@ -9,6 +9,16 @@ import React from "react";
 export interface GenUIInteraction {
     selectedStepId: string | null;
     onStepSelect?: (stepId: string | null) => void;
+    /** Decision-card resolutions, keyed by decision id, so a resolved card
+     * re-renders locked from host state (transcript replay). */
+    resolvedDecisions?: Record<string, string>;
+    /** Host callback when a decision-card option is chosen. */
+    onDecisionResolve?: (decisionId: string, option: string) => void;
+    /** Host callback when a decision-card "view source" link is activated. */
+    onDecisionSource?: (decisionId: string, source?: {
+        url?: string;
+        label?: string;
+    }) => void;
 }
 export declare const DEFAULT_INTERACTION: GenUIInteraction;
 export interface GenUIInteractionProviderProps {

package/dist/shared/InteractionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InteractionContext.d.ts","sourceRoot":"","sources":["../../src/shared/InteractionContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,mBAAmB,EAAE,gBAGjC,CAAC;AAIF,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,6BAA6B,2CAM1F;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD"}
+{"version":3,"file":"InteractionContext.d.ts","sourceRoot":"","sources":["../../src/shared/InteractionContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C;gEAC4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5F;AAED,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC;AAIF,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,6BAA6B,2CAM1F;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD"}

package/dist/tool-definitions.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.1.56",
-  "generated_at": "2026-06-18T18:59:47.732Z",
-  "schema_count": 57,
+  "version": "0.1.58",
+  "generated_at": "2026-06-24T15:47:16.404Z",
+  "schema_count": 59,
   "schemas": {
     "data-table": {
       "name": "render_data_table",
@@ -4736,6 +4736,362 @@
           "steps"
         ]
       }
+    },
+    "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).",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "decision-card"
+            ]
+          },
+          "id": {
+            "type": "string",
+            "description": "Stable id for update-in-place rendering"
+          },
+          "decision_type": {
+            "type": "string",
+            "description": "Short category shown in the eyebrow, e.g. 'Cross-check', 'Allocation', 'Reserve'"
+          },
+          "title": {
+            "type": "string",
+            "description": "The decision headline, e.g. 'AR reserve adequacy'"
+          },
+          "question": {
+            "type": "string",
+            "description": "The full question / context the user must judge"
+          },
+          "amount": {
+            "type": "number",
+            "description": "Dollar value at stake, e.g. 27100"
+          },
+          "currency": {
+            "type": "string",
+            "description": "ISO currency code; defaults to USD"
+          },
+          "amount_label": {
+            "type": "string",
+            "description": "Caption above the amount, e.g. 'At stake'"
+          },
+          "severity": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high"
+            ],
+            "description": "Severity of the decision; tints the accent rail"
+          },
+          "flags": {
+            "type": "array",
+            "maxItems": 6,
+            "description": "Optional data-quality flags surfaced on the card",
+            "items": {
+              "type": "object",
+              "properties": {
+                "field": {
+                  "type": "string"
+                },
+                "issue": {
+                  "type": "string"
+                },
+                "severity": {
+                  "type": "string",
+                  "enum": [
+                    "low",
+                    "medium",
+                    "high"
+                  ]
+                }
+              },
+              "required": [
+                "issue"
+              ]
+            }
+          },
+          "options": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 5,
+            "description": "Mutually-exclusive resolution choices; mark one `recommended` to make it primary",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "label": {
+                  "type": "string"
+                },
+                "recommended": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "label"
+              ]
+            }
+          },
+          "source": {
+            "type": "object",
+            "description": "Optional provenance link for the figure",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "url": {
+                "type": "string"
+              }
+            }
+          },
+          "resolved": {
+            "type": "object",
+            "description": "Pre-resolved state for transcript replay",
+            "properties": {
+              "option": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "option"
+            ]
+          }
+        },
+        "required": [
+          "type",
+          "title",
+          "question",
+          "options"
+        ]
+      }
     }
   }
 }

package/package.json

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