@vertesia/common 1.5.0-dev.20260725.083715Z → 1.5.0-dev.20260806.125520Z

package/lib/store/grounded-extraction.d.ts

@@ -1,4 +1,5 @@
-import type { InteractionExecutionConfiguration } from '../interaction.js';
+import type { z } from 'zod';
+import type { GroundedAssistantResponseSchema, GroundedExtractionRequestSchema, GroundedExtractionResultResponseSchema, GroundedExtractionVerdictSchema, GroundedVerificationBreakdownSchema } from '../api-schemas/document-processing.js';
 import type { WorkflowRunStatus } from './workflow.js';
 /**
  * Document-level trust verdict for a grounded extraction. `good_to_go` means the
@@ -6,7 +7,7 @@ import type { WorkflowRunStatus } from './workflow.js';
  * check; `needs_review` means a human should verify it. This reflects content
  * correctness, not how many citation boxes rendered.
  */
-export type GroundedExtractionVerdict = 'good_to_go' | 'needs_review';
+export type GroundedExtractionVerdict = z.infer<typeof GroundedExtractionVerdictSchema>;
 /**
  * Canonical workflow id for object-scoped grounded extraction. Every entry point
  * must use this id so Temporal prevents overlapping extraction runs per object.
@@ -17,83 +18,14 @@ export declare function getGroundedExtractionWorkflowId(accountId: string, objec
  * optional: with none set, the object's own content-type schema drives the
  * extraction with default models and settings.
  */
-export interface GroundedExtractionRequest {
-    /** JSON schema describing the data to extract. Takes precedence over type_ref. */
-    schema?: Record<string, unknown>;
-    /** Content type id or catalog ref whose object_schema drives the extraction. */
-    type_ref?: string;
-    /** Interaction to use. Defaults to sys:ExtractInformationGrounded. */
-    interaction_name?: string;
-    /** Maximum number of pages to process. */
-    max_pages?: number;
-    /** Run OCR on every page even when a text layer exists. */
-    force_ocr?: boolean;
-    /** Re-run OCR on pages that need it instead of restoring the stored OCR result. */
-    refresh_ocr?: boolean;
-    /** Attach clean page images for layout/semantic context; direct-vision pages also receive checkerboards. */
-    use_vision?: boolean;
-    /**
-     * A1 locate-grid cell size in PDF points for vision pages (drives both the drawn
-     * grid and cell→box resolution). Smaller = finer grid / more cells. Default: 14.
-     */
-    grid_cell_pt?: number;
-    /**
-     * How to read pages that have no digital text layer (scans / image-only pages).
-     * 'vision' (default): read them off the page image with the extraction model,
-     * skipping OCR entirely. 'ocr': legacy path — OCR those pages and block-ground on
-     * the (lossy) OCR text. Set to 'ocr' to revert to the pre-vision behavior.
-     */
-    raster_mode?: 'vision' | 'ocr';
-    /** Maximum pages per extraction call; larger documents are split into sequential windows. */
-    window_pages?: number;
-    /**
-     * Extract with an autonomous agent (views the whole document at once) instead of
-     * the deterministic windowed pipeline. Sidesteps window-boundary splits on long
-     * documents. The workflow stages the artifacts into an agent space, runs a
-     * conversation agent that writes the extraction, then folds it back.
-     */
-    agentic_extraction?: boolean;
-    /** Agent interaction for agentic_extraction. Defaults to sys:GeneralAgent. */
-    extract_agent?: string;
-    /** Update the object's properties with the extracted data. Default: true. */
-    update_properties?: boolean;
-    /** LLM execution configuration (model, environment, ...) for the main pass. */
-    config?: InteractionExecutionConfiguration;
-    /** Execution configuration used instead of `config` on hard content (scans, handwriting). */
-    hard_config?: InteractionExecutionConfiguration;
-    /** Hardness score (0..1) at or above which `hard_config` is used. Default: 0.5. */
-    hardness_threshold?: number;
-    /** Execution configuration for the post-extraction review pass. No review runs when absent. */
-    review_config?: InteractionExecutionConfiguration;
-    /** Hardness score (0..1) at or above which the review runs. Defaults to hardness_threshold. */
-    review_threshold?: number;
-    /** Review triggers when any page's citation coverage falls below this floor. Default: 0.2. */
-    coverage_review_threshold?: number;
-    /** Run the model review even when every citation was digitally verified. Requires review_config. */
-    force_review?: boolean;
-    /**
-     * Free-text operator guidance folded into the extraction prompt to steer a
-     * (re-)extraction, e.g. "part numbers are in the third column; some line items
-     * wrap onto the next row".
-     */
-    operator_instructions?: string;
-    /** Interactive assistant only: the operator's opening message for the assistant conversation. */
-    user_prompt?: string;
-}
+export type GroundedExtractionRequest = z.infer<typeof GroundedExtractionRequestSchema>;
 /**
  * Response from starting the interactive grounded extraction assistant. The agent
  * run + conversation workflow are launched server-side (recordRun -> stage the
  * document into the agent space -> launch the interactive conversation); the
  * client renders the conversation with `agent_run_id`.
  */
-export interface GroundedAssistantResponse {
-    /** The AgentRun id to stream/render the conversation. */
-    agent_run_id: string;
-    /** The conversation workflow id backing the run. */
-    workflow_id: string;
-    /** The object the assistant is scoped to. */
-    object_id: string;
-}
+export type GroundedAssistantResponse = z.infer<typeof GroundedAssistantResponseSchema>;
 /**
  * Status of a grounded extraction workflow. Carries the doc-level verdict once the
  * run has completed and written its result.
@@ -108,39 +40,10 @@ export interface GroundedExtractionRunStatusResponse extends WorkflowRunStatus {
  * AI verified (the reviewer confirmed it against the page image — the primary
  * signal for scanned or handwritten content, which has no text layer to match).
  */
-export interface GroundedVerificationBreakdown {
-    /** Total number of cited values. */
-    total: number;
-    /** Values matched verbatim against the document's text (digital layer or OCR). */
-    digitally_verified: number;
-    /** Values the reviewer model confirmed against the page image. */
-    ai_verified: number;
-    /** Values read from the image but neither text-matched nor reviewer-confirmed. */
-    unverified: number;
-}
+export type GroundedVerificationBreakdown = z.infer<typeof GroundedVerificationBreakdownSchema>;
 /**
  * Completed grounded extraction result: the extracted data with its trust verdict
  * and verification breakdown, plus a download URL for the full citations artifact.
  */
-export interface GroundedExtractionResultResponse {
-    object_id: string;
-    /** The extracted data, shaped by the requested schema. */
-    data: Record<string, unknown>;
-    /** Document-level trust verdict. */
-    verdict?: GroundedExtractionVerdict;
-    /** One-sentence rationale for the verdict. */
-    verdict_reason?: string;
-    /** Mean citation confidence in [0,1]. */
-    confidence?: number;
-    /** Per-value verification breakdown. */
-    verification: GroundedVerificationBreakdown;
-    /** Review outcome, when a review pass ran. */
-    review?: {
-        assessment: 'complete' | 'issues_found';
-        summary?: string;
-        corrections_applied?: number;
-    };
-    /** Signed download URL for the full grounded-extraction.json (data + citations + boxes). */
-    result_url?: string | null;
-}
+export type GroundedExtractionResultResponse = z.infer<typeof GroundedExtractionResultResponseSchema>;
 //# sourceMappingURL=grounded-extraction.d.ts.map

package/lib/store/grounded-extraction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grounded-extraction.d.ts","sourceRoot":"","sources":["../../src/store/grounded-extraction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"grounded-extraction.d.ts","sourceRoot":"","sources":["../../src/store/grounded-extraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACR,+BAA+B,EAC/B,+BAA+B,EAC/B,sCAAsC,EACtC,+BAA+B,EAC/B,mCAAmC,EACtC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;GAGG;AACH,MAAM,WAAW,mCAAoC,SAAQ,iBAAiB;IAC1E,6DAA6D;IAC7D,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC"}

package/lib/store/grounded-extraction.js.map

@@ -1 +1 @@
-{"version":3,"file":"grounded-extraction.js","sourceRoot":"","sources":["../../src/store/grounded-extraction.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAAiB,EAAE,QAAgB;IAC/E,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,+BAA+B,QAAQ,WAAW,CAAC;AACtF,CAAC"}
+{"version":3,"file":"grounded-extraction.js","sourceRoot":"","sources":["../../src/store/grounded-extraction.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAAiB,EAAE,QAAgB;IAC/E,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,+BAA+B,QAAQ,WAAW,CAAC;AACtF,CAAC"}

package/lib/store/index.d.ts

@@ -6,8 +6,10 @@ export * from './common.js';
 export * from './conversation-state.js';
 export * from './doc-analyzer.js';
 export * from './dsl-workflow.js';
+export * from './editing-policy-schema.generated.js';
 export * from './grounded-extraction.js';
 export * from './hive-memory.js';
+export * from './intake-policy-schema.generated.js';
 export * from './object-types.js';
 export * from './process.js';
 export * from './process-schema.js';

package/lib/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC,cAAc,sCAAsC,CAAC;AACrD,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qCAAqC,CAAC;AACpD,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/lib/store/index.js

@@ -6,8 +6,11 @@ export * from './common.js';
 export * from './conversation-state.js';
 export * from './doc-analyzer.js';
 export * from './dsl-workflow.js';
+// The compiled JSON Schema for ContentTypeIntakePolicy, under the name consumers import.
+export * from './editing-policy-schema.generated.js';
 export * from './grounded-extraction.js';
 export * from './hive-memory.js';
+export * from './intake-policy-schema.generated.js';
 export * from './object-types.js';
 export * from './process.js';
 export * from './process-schema.js';

package/lib/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,yFAAyF;AACzF,cAAc,sCAAsC,CAAC;AACrD,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qCAAqC,CAAC;AACpD,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/lib/store/intake-policy-schema.generated.d.ts

@@ -0,0 +1,3 @@
+import type { JSONObject } from '../json.js';
+export declare const ContentTypeIntakePolicySchema: JSONObject;
+//# sourceMappingURL=intake-policy-schema.generated.d.ts.map

package/lib/store/intake-policy-schema.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-policy-schema.generated.d.ts","sourceRoot":"","sources":["../../src/store/intake-policy-schema.generated.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,6BAA6B,EAAE,UA84C3C,CAAC"}