@adoptai/genui-components 0.1.57 → 0.1.59

package/dist/schemas/index.js

@@ -3393,7 +3393,32 @@ var workflowStepperSchema = z.object({
       n: z.number().int().positive().optional(),
       title: z.string(),
       sub: z.string().optional(),
-      status: z.enum(["done", "active", "review", "pending", "blocked", "failed"]),
+      status: z.enum([
+        "done",
+        "active",
+        "running",
+        "review",
+        "pending",
+        "blocked",
+        "failed"
+      ]),
+      // Optional quality-gate verdict for a step run by an executor (e.g. a
+      // pipeline). Surfaces a subtle trust badge; flags hint at issues a human
+      // should review (the full list lives in the escalation dock).
+      eval: z.object({
+        score: z.number().min(0).max(1).nullable().optional(),
+        verdict: z.enum(["good", "bad"]).optional(),
+        reasoning: z.string().optional(),
+        judge_ok: z.boolean().optional(),
+        data_quality_flags: z.array(
+          z.object({
+            field: z.string().optional(),
+            issue: z.string().optional(),
+            severity: z.enum(["low", "medium", "high"]).optional(),
+            details: z.string().optional()
+          })
+        ).optional()
+      }).optional(),
       assignees: z.array(
         z.object({
           name: z.string(),
@@ -3429,7 +3454,32 @@ var workflowStepperTool = {
             n: { type: "number", description: "Step number; defaults to index + 1" },
             title: { type: "string" },
             sub: { type: "string", description: "Short status caption, e.g. '7 accounts \xB7 2 exceptions'" },
-            status: { type: "string", enum: ["done", "active", "review", "pending", "blocked", "failed"] },
+            status: {
+              type: "string",
+              enum: ["done", "active", "running", "review", "pending", "blocked", "failed"]
+            },
+            eval: {
+              type: "object",
+              description: "Optional quality-gate verdict for an executor-run step.",
+              properties: {
+                score: { type: "number" },
+                verdict: { type: "string", enum: ["good", "bad"] },
+                reasoning: { type: "string" },
+                judge_ok: { type: "boolean" },
+                data_quality_flags: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      field: { type: "string" },
+                      issue: { type: "string" },
+                      severity: { type: "string", enum: ["low", "medium", "high"] },
+                      details: { type: "string" }
+                    }
+                  }
+                }
+              }
+            },
             assignees: {
               type: "array",
               maxItems: 6,
@@ -3453,6 +3503,183 @@ var workflowStepperTool = {
     required: ["type", "title", "steps"]
   }
 };
+var bbox = z.tuple([z.number(), z.number(), z.number(), z.number()]);
+var fieldSchema = z.object({
+  field_key: z.string(),
+  label: z.string(),
+  value: z.string(),
+  page: z.number(),
+  // 0-indexed, matches PageDimension.page
+  bbox: bbox.nullable().optional(),
+  confidence: z.number().optional(),
+  confidence_tier: z.enum(["green", "amber", "red"]).optional(),
+  badge: z.enum(["SC", "CN", "AB", "SW"]).optional(),
+  state: z.enum(["ok", "corrected", "missing", "warn"]).optional(),
+  entity_type: z.string().optional(),
+  is_primary: z.boolean().optional(),
+  // Set after a human correction (extractor output, or an optimistic in-card
+  // edit) so the editable field card can show old → new and who changed it.
+  previous_value: z.string().nullable().optional(),
+  corrected_by: z.string().nullable().optional()
+});
+var pageSchema = z.object({
+  page: z.number(),
+  // 0-indexed
+  imageUrl: z.string().optional(),
+  // host-resolved from the durable image_ref
+  width_pt: z.number(),
+  height_pt: z.number()
+});
+var summaryStatSchema = z.object({
+  field_key: z.string(),
+  label: z.string(),
+  value: z.string(),
+  caption: z.string().nullable().optional()
+});
+var summaryFactSchema = z.object({
+  field_key: z.string(),
+  label: z.string(),
+  value: z.string(),
+  badge: z.string().nullable().optional()
+});
+var summarySchema = z.object({
+  display_name: z.string().nullable().optional(),
+  short_name: z.string().nullable().optional(),
+  organization: z.string().nullable().optional(),
+  domain: z.string().nullable().optional(),
+  domain_group: z.string().nullable().optional(),
+  tax_year: z.union([z.string(), z.number()]).nullable().optional(),
+  crumbs: z.array(z.string()).optional(),
+  tags: z.array(z.string()).optional(),
+  stats: z.array(summaryStatSchema).optional(),
+  facts: z.array(summaryFactSchema).optional()
+});
+var documentFieldExtractionSchema = z.object({
+  type: z.literal("document-field-extraction"),
+  doc_type: z.string().optional(),
+  // Original uploaded filename (e.g. "2024_gl.pdf"); preferred over doc_type for
+  // the card title since doc_type is often the "generic_fallback" schema name.
+  file_name: z.string().optional(),
+  // Server-side token; resolved by the host into pages/fields before render.
+  payload_ref: z.string().optional(),
+  // Present for persisted workstream docs; absent for pre-existing cards.
+  store_id: z.string().optional(),
+  doc_id: z.string().optional(),
+  pages: z.array(pageSchema).max(100).optional(),
+  fields: z.array(fieldSchema).max(1e3).optional(),
+  // Page-count metadata for the Details tab ("N of M pages extracted").
+  page_count: z.number().optional(),
+  pages_processed: z.number().optional(),
+  // Deterministic document summary for the Details tab.
+  summary: summarySchema.nullable().optional()
+});
+var documentFieldExtractionTool = {
+  name: "render_document_field_extraction",
+  description: "Render extracted document fields as an interactive overlay on the page image(s) \u2014 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 \u2014 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 \u2014 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"]
+  }
+};
 var decisionCardSchema = z.object({
   type: z.literal("decision-card"),
   id: z.string().optional(),
@@ -3556,6 +3783,36 @@ var decisionCardTool = {
     required: ["type", "title", "question", "options"]
   }
 };
+var tabbyAuthSchema = z.object({
+  type: z.literal("tabby-auth"),
+  app: z.string(),
+  url: z.string(),
+  workspace: z.string().optional(),
+  state: z.enum(["pending", "connected"]).optional(),
+  ctaLabel: z.string().optional(),
+  steps: z.array(z.string()).optional(),
+  description: z.string().optional(),
+  iconUrl: z.string().optional()
+});
+var tabbyAuthTool = {
+  name: "render_tabby_auth",
+  description: "Render a dedicated, trustworthy sign-in card when a harness skill needs the member to authenticate with a third-party app (e.g. Sage Intacct, Airbnb, an ERP) before a `call_web_api` request can proceed. Use this for the `login_required` path instead of a raw markdown link or a connect-integration card. `app` is the human display name (drives the title context, subtitle, and CTA). `url` is the login/short-link the prominent CTA opens in a new tab. `workspace` adds a subtitle suffix ('{app} \xB7 {workspace} workspace'). `state='pending'` (default) is the first-time connect; `state='connected'` is the verify/re-auth case (session already live) with a green badge and an Open deep-link. `steps` overrides the default numbered instructions; `description` is a one-line intro. The card title ('Authentication required') and the 'Credentials not stored by Adopt' trust footer are hardcoded brand constants \u2014 never supplied here.",
+  input_schema: {
+    type: "object",
+    properties: {
+      type: { type: "string", enum: ["tabby-auth"] },
+      app: { type: "string" },
+      url: { type: "string" },
+      workspace: { type: "string" },
+      state: { type: "string", enum: ["pending", "connected"] },
+      ctaLabel: { type: "string" },
+      steps: { type: "array", items: { type: "string" } },
+      description: { type: "string" },
+      iconUrl: { type: "string" }
+    },
+    required: ["type", "app", "url"]
+  }
+};
 
 // src/schemas/buildRenderUITool.ts
 function buildRenderUITool(selectedSchemas) {
@@ -3675,7 +3932,9 @@ var schemaRegistry = {
   "integrations-list": { schema: integrationsListSchema, tool: integrationsListTool },
   "pipeline-preview": { schema: pipelinePreviewSchema, tool: pipelinePreviewTool },
   "workflow-stepper": { schema: workflowStepperSchema, tool: workflowStepperTool },
-  "decision-card": { schema: decisionCardSchema, tool: decisionCardTool }
+  "document-field-extraction": { schema: documentFieldExtractionSchema, tool: documentFieldExtractionTool },
+  "decision-card": { schema: decisionCardSchema, tool: decisionCardTool },
+  "tabby-auth": { schema: tabbyAuthSchema, tool: tabbyAuthTool }
 };
 
 export { buildRenderUITool, schemaRegistry, validatePayload };