@vertesia/common 1.6.0-dev.20260923.085325Z → 1.6.0-dev.20261004.085740Z

package/src/store/conversation-state.ts

@@ -1,15 +1,8 @@
 import type { CompletionResult, ExecutionTokenUsage, StatelessExecutionOptions, ToolUse } from '@llumiverse/common';
-import type { z } from 'zod';
-import type {
-    ExternalizedToolInputRefSchema,
-    ExternalizedToolInputRefsSchema,
-    PendingMcpConnectionSchema,
-    TextArtifactReferenceSchema,
-    ToolReferenceSchema,
-    UsedSkillSchema,
-} from '../api-schemas/interaction.js';
 import type { ConversationStripOptions, ResolvedInteractionExecutionInfo, UserChannel } from '../interaction.js';
+import type { AgentBudgetConfiguration } from '../project.js';
 import type { ExecutionRunDocRef } from '../runs.js';
+import type * as Wire from '../wire-types.generated.js';
 import type { AgentToolApprovalMode, PendingToolApprovalResults, ToolApprovalGrant } from './agent-approval.js';
 import type { Plan, WorkflowAncestor } from './workflow.js';
 
@@ -17,18 +10,18 @@ import type { Plan, WorkflowAncestor } from './workflow.js';
  * Lightweight tool reference for activity payloads.
  * References tools stored in GCP instead of embedding full tool definitions.
  */
-export type ToolReference = z.infer<typeof ToolReferenceSchema>;
+export type ToolReference = Wire.ToolReference;
 
 /** Reference to text content externalized to agent artifact storage. */
-export type TextArtifactReference = z.infer<typeof TextArtifactReferenceSchema>;
+export type TextArtifactReference = Wire.TextArtifactReference;
 
 /**
  * Sidecar metadata for generated tool input fields that were stored outside
  * model-visible tool_input. Keyed by tool_use.id on ConversationState.
  */
-export type ExternalizedToolInputRef = z.infer<typeof ExternalizedToolInputRefSchema>;
+export type ExternalizedToolInputRef = Wire.ExternalizedToolInputRef;
 
-export type ExternalizedToolInputRefs = z.infer<typeof ExternalizedToolInputRefsSchema>;
+export type ExternalizedToolInputRefs = Wire.ExternalizedToolInputRefs;
 
 /**
  * Conversation state passed between workflow activities: the activity-safe,
@@ -154,6 +147,13 @@ export interface ConversationState {
      */
     checkpoint_tokens?: number;
 
+    /**
+     * Project-configured agent token budget (cached from project.configuration.agent.budget at
+     * conversation start). The workflow resolves the effective budget field-wise from this, the
+     * interaction's agent_runner_options.budget, and the per-run budget override.
+     */
+    budget?: AgentBudgetConfiguration;
+
     /**
      * Active communication channels with their current state.
      * Channels can be updated as conversation progresses (e.g., email threading info).
@@ -300,7 +300,7 @@ export const CONVERSATION_CATALOG_ARTIFACT_KEY = 'catalog.json';
  * Built at tool-discovery time and stored on the conversation state so the agent can
  * discover it (by description) and ask the user to connect.
  */
-export type PendingMcpConnection = z.infer<typeof PendingMcpConnectionSchema>;
+export type PendingMcpConnection = Wire.PendingMcpConnection;
 
 /** Skill metadata collected at workflow start for upfront sandbox hydration */
 export interface AvailableSkill {
@@ -311,7 +311,7 @@ export interface AvailableSkill {
 }
 
 /** Skill metadata tracked when a skill is used */
-export type UsedSkill = z.infer<typeof UsedSkillSchema>;
+export type UsedSkill = Wire.UsedSkill;
 
 export interface ToolActivationMetadata {
     /** Turn when the tool became active in this conversation. */

package/src/store/doc-analyzer.ts

@@ -1,35 +1,27 @@
-import type { z } from 'zod';
-import type {
-    DocAnalyzeRunStatusResponseSchema,
-    DocAnalyzerProgressSchema,
-    DocAnalyzerProgressStatusSchema,
-    DocProcessorOutputFormatSchema,
-    DocumentPrepOptionsSchema,
-    DocumentProcessingPhaseSchema,
-} from '../api-schemas/document-processing.js';
+import type * as Wire from '../wire-types.generated.js';
 import type { WorkflowExecutionPayload } from './workflow.js';
 
-export type DocumentPrepOptions = z.infer<typeof DocumentPrepOptionsSchema>;
+export type DocumentPrepOptions = Wire.DocumentPrepOptions;
 
 export interface DocumentPrepWorkflowPayload extends Omit<WorkflowExecutionPayload, 'vars'> {
     vars: DocumentPrepOptions;
 }
 
-export type DocumentProcessingPhase = z.infer<typeof DocumentProcessingPhaseSchema>;
+export type DocumentProcessingPhase = Wire.DocumentProcessingPhase;
 
 /**
  * Output format for document processing workflows
  */
-export type DocProcessorOutputFormat = z.infer<typeof DocProcessorOutputFormatSchema>;
+export type DocProcessorOutputFormat = Wire.DocProcessorOutputFormat;
 
 /**
  * Represents a document analysis run status
  */
-export type DocAnalyzeRunStatusResponse = z.infer<typeof DocAnalyzeRunStatusResponseSchema>;
+export type DocAnalyzeRunStatusResponse = Wire.DocAnalyzeRunStatusResponse;
 
-export type DocAnalyzerProgress = z.infer<typeof DocAnalyzerProgressSchema>;
+export type DocAnalyzerProgress = Wire.DocAnalyzerProgress;
 
-export type DocAnalyzerProgressStatus = z.infer<typeof DocAnalyzerProgressStatusSchema>;
+export type DocAnalyzerProgressStatus = Wire.DocAnalyzerProgressStatus;
 
 /**
  * Adapt Tables Parameters, part of the request

package/src/store/dsl-workflow.ts

@@ -1,18 +1,5 @@
-import type { z } from 'zod';
-import type {
-    ActivityFetchSpecSchema,
-    DSLActivityOptionsSchema,
-    DSLActivitySpecSchema,
-    DSLActivityStepSchema,
-    DSLRetryPolicySchema,
-    DurationValueSchema,
-} from '../api-schemas/process.js';
-import type {
-    WorkflowDefinitionRefSchema,
-    WorkflowInputFileSchema,
-    WorkflowInputSchema,
-} from '../api-schemas/workflow-runs.js';
 import type { ToolExecutionMetadata } from '../tool-execution.js';
+import type * as Wire from '../wire-types.generated.js';
 import type { BaseObject } from './common.js';
 import type { WorkflowExecutionPayload } from './index.js';
 
@@ -23,16 +10,16 @@ import type { WorkflowExecutionPayload } from './index.js';
  */
 export type ParentClosePolicyType = 'TERMINATE' | 'ABANDON' | 'REQUEST_CANCEL' | undefined;
 
-export type DurationValue = z.infer<typeof DurationValueSchema>;
+export type DurationValue = Wire.DurationValue;
 
 /**
  * Discriminator for workflow input type - either object IDs or GCS file URIs
  */
 export type WorkflowInputType = 'objectIds' | 'files';
 
-export type WorkflowInputFile = z.infer<typeof WorkflowInputFileSchema>;
+export type WorkflowInputFile = Wire.WorkflowInputFile;
 
-export type WorkflowInput = z.infer<typeof WorkflowInputSchema>;
+export type WorkflowInput = Wire.WorkflowInput;
 
 /**
  * The payload sent when starting a workflow from the temporal client to the workflow instance.
@@ -45,9 +32,9 @@ export interface DSLWorkflowExecutionPayload extends WorkflowExecutionPayload<Re
     workflow: DSLWorkflowSpec;
 }
 
-export type DSLActivityOptions = z.infer<typeof DSLActivityOptionsSchema>;
+export type DSLActivityOptions = Wire.DSLActivityOptions;
 
-export type DSLRetryPolicy = z.infer<typeof DSLRetryPolicySchema>;
+export type DSLRetryPolicy = Wire.DSLRetryPolicy;
 
 // Temporal accepts Date values internally, while the HTTP schema documents their JSON string form.
 // Keep the execution type truthful at the Temporal boundary instead of pretending HTTP validation revives dates.
@@ -69,7 +56,7 @@ export interface DSLActivityExecutionPayload<ParamsT extends object> extends Wor
 // The published schema intentionally leaves array items open. This narrower authoring type is an
 // internal DSL convenience, not a claim made by the HTTP validator.
 export type ImportSpec = (string | Record<string, string>)[];
-export type ActivityFetchSpec = z.infer<typeof ActivityFetchSpecSchema>;
+export type ActivityFetchSpec = Wire.ActivityFetchSpec;
 
 interface DSLWorkflowStepBase {
     /**
@@ -79,7 +66,7 @@ interface DSLWorkflowStepBase {
     type: 'activity' | 'workflow';
 }
 
-type DSLActivitySpecWire = z.infer<typeof DSLActivitySpecSchema>;
+type DSLActivitySpecWire = Wire.DSLActivitySpecWire;
 
 /** The published activity shape with a caller-specializable parameter bag. */
 export type DSLActivitySpec<PARAMS extends object = Record<string, unknown>> = Omit<
@@ -90,7 +77,7 @@ export type DSLActivitySpec<PARAMS extends object = Record<string, unknown>> = O
     import?: ImportSpec;
 };
 
-type DSLActivityStepWire = z.infer<typeof DSLActivityStepSchema>;
+type DSLActivityStepWire = Wire.DSLActivityStepWire;
 
 /** The published activity-step shape with a caller-specializable parameter bag. */
 export type DSLActivityStep<PARAMS extends object = Record<string, unknown>> = Omit<
@@ -262,7 +249,7 @@ export interface DSLWorkflowDefinitionResponse extends DSLWorkflowDefinition {
     spec_format: 'steps' | 'activities';
 }
 
-export type WorkflowDefinitionRef = z.infer<typeof WorkflowDefinitionRefSchema>;
+export type WorkflowDefinitionRef = Wire.WorkflowDefinitionRef;
 
 export const WorkflowDefinitionRefPopulate = 'id name description tags created_at updated_at';
 

package/src/store/duration.ts

@@ -0,0 +1,45 @@
+/**
+ * The units `ms` accepts in a duration string, in any case (`'5s'`, `'2 Hours'`, `'1 min'`).
+ */
+type DurationUnit =
+    | 'Years'
+    | 'Year'
+    | 'Yrs'
+    | 'Yr'
+    | 'Y'
+    | 'Weeks'
+    | 'Week'
+    | 'W'
+    | 'Days'
+    | 'Day'
+    | 'D'
+    | 'Hours'
+    | 'Hour'
+    | 'Hrs'
+    | 'Hr'
+    | 'H'
+    | 'Minutes'
+    | 'Minute'
+    | 'Mins'
+    | 'Min'
+    | 'M'
+    | 'Seconds'
+    | 'Second'
+    | 'Secs'
+    | 'Sec'
+    | 's'
+    | 'Milliseconds'
+    | 'Millisecond'
+    | 'Msecs'
+    | 'Msec'
+    | 'Ms';
+
+/**
+ * A duration string as the `ms` package parses it: `'100'`, `'5s'`, `'1 hour'`. Declared here rather than
+ * imported from `ms`, which this package does not depend on, so the published types resolve without it.
+ * Identical to `ms`'s `StringValue`, so a value passes straight to `ms()`.
+ */
+export type DurationString =
+    | `${number}`
+    | `${number}${DurationUnit | Uppercase<DurationUnit> | Lowercase<DurationUnit>}`
+    | `${number} ${DurationUnit | Uppercase<DurationUnit> | Lowercase<DurationUnit>}`;

package/src/store/grounded-extraction.ts

@@ -1,11 +1,4 @@
-import type { z } from 'zod';
-import type {
-    GroundedAssistantResponseSchema,
-    GroundedExtractionRequestSchema,
-    GroundedExtractionResultResponseSchema,
-    GroundedExtractionVerdictSchema,
-    GroundedVerificationBreakdownSchema,
-} from '../api-schemas/document-processing.js';
+import type * as Wire from '../wire-types.generated.js';
 
 /**
  * Document-level trust verdict for a grounded extraction. `good_to_go` means the
@@ -13,14 +6,14 @@ import type {
  * check; `needs_review` means a human should verify it. This reflects content
  * correctness, not how many citation boxes rendered.
  */
-export type GroundedExtractionVerdict = z.infer<typeof GroundedExtractionVerdictSchema>;
+export type GroundedExtractionVerdict = Wire.GroundedExtractionVerdict;
 
 /**
  * Request body to start a grounded extraction on a content object. All fields are
  * optional: with none set, the object's own content-type schema drives the
  * extraction with default models and settings.
  */
-export type GroundedExtractionRequest = z.infer<typeof GroundedExtractionRequestSchema>;
+export type GroundedExtractionRequest = Wire.GroundedExtractionRequest;
 
 /**
  * Response from starting the interactive grounded extraction assistant. The agent
@@ -28,7 +21,7 @@ export type GroundedExtractionRequest = z.infer<typeof GroundedExtractionRequest
  * document into the agent space -> launch the interactive conversation); the
  * client renders the conversation with `agent_run_id`.
  */
-export type GroundedAssistantResponse = z.infer<typeof GroundedAssistantResponseSchema>;
+export type GroundedAssistantResponse = Wire.GroundedAssistantResponse;
 
 /**
  * How each extracted value was verified. Two kinds, both trustworthy:
@@ -36,10 +29,10 @@ export type GroundedAssistantResponse = z.infer<typeof GroundedAssistantResponse
  * 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 type GroundedVerificationBreakdown = z.infer<typeof GroundedVerificationBreakdownSchema>;
+export type GroundedVerificationBreakdown = Wire.GroundedVerificationBreakdown;
 
 /**
  * Completed grounded extraction result: the extracted data with its trust verdict
  * and verification breakdown, plus a download URL for the full citations artifact.
  */
-export type GroundedExtractionResultResponse = z.infer<typeof GroundedExtractionResultResponseSchema>;
+export type GroundedExtractionResultResponse = Wire.GroundedExtractionResultResponse;

package/src/store/intake-policy-schema.generated.ts

@@ -280,6 +280,12 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     enum: ['low', 'medium', 'high', 'xhigh', 'max'],
                 },
+                thinking_mode: {
+                    type: 'string',
+                    enum: ['adaptive', 'between_tools'],
+                    description:
+                        'Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved.',
+                },
                 thinking_budget_tokens: {
                     type: 'number',
                 },
@@ -293,6 +299,10 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     enum: ['5m', '1h'],
                 },
+                speed: {
+                    type: 'string',
+                    enum: ['standard', 'fast'],
+                },
             },
             additionalProperties: false,
         },
@@ -402,6 +412,12 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 top_k: {
                     type: 'number',
                 },
+                thinking_mode: {
+                    type: 'string',
+                    enum: ['adaptive', 'between_tools'],
+                    description:
+                        'Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved.',
+                },
                 thinking_budget_tokens: {
                     type: 'number',
                 },
@@ -611,6 +627,12 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     enum: ['low', 'medium', 'high', 'xhigh', 'max'],
                 },
+                thinking_mode: {
+                    type: 'string',
+                    enum: ['adaptive', 'between_tools'],
+                    description:
+                        'Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved.',
+                },
                 thinking_budget_tokens: {
                     type: 'number',
                 },
@@ -1072,6 +1094,11 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 'CUSTOMIZATION_INSTRUCT',
             ],
         },
+        InferenceProfileId: {
+            type: 'string',
+            pattern: '^[a-fA-F0-9]{24}$',
+            description: 'MongoDB ObjectId of the inference profile.',
+        },
         IntakePageRanges: {
             type: 'array',
             items: {
@@ -1105,6 +1132,22 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 id: {
                     type: 'string',
                 },
+                inference_profile: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/InferenceProfileId',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    description: 'Select a project inference profile. Null bypasses profile defaults.',
+                },
+                inherit_model_config: {
+                    type: 'boolean',
+                    description:
+                        "Treat the supplied environment, model and inference_profile as the caller's settings, inherited as a fallback: the interaction's bound or attached profile, or its own model, replaces them.",
+                },
                 environment: {
                     type: 'string',
                 },
@@ -1427,11 +1470,16 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 },
                 size: {
                     type: 'string',
-                    enum: ['1024x1024', '1024x1536', '1536x1024', 'auto'],
+                },
+                width: {
+                    type: 'number',
+                },
+                height: {
+                    type: 'number',
                 },
                 image_quality: {
                     type: 'string',
-                    enum: ['low', 'medium', 'high', 'auto'],
+                    enum: ['low', 'medium', 'high', 'xhigh', 'max', 'auto'],
                 },
                 background: {
                     type: 'string',
@@ -1441,9 +1489,91 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     enum: ['png', 'webp', 'jpeg'],
                 },
+                n: {
+                    type: 'number',
+                },
+                output_compression: {
+                    type: 'integer',
+                    minimum: 0,
+                    maximum: 100,
+                },
+                moderation: {
+                    type: 'string',
+                    enum: ['auto', 'low'],
+                },
+                input_fidelity: {
+                    type: 'string',
+                    enum: ['low', 'high'],
+                },
+                partial_images: {
+                    type: 'number',
+                },
+            },
+            additionalProperties: false,
+        },
+        OpenAiImageGenerationMask: {
+            type: 'object',
+            properties: {
+                file_id: {
+                    type: 'string',
+                },
+                image_url: {
+                    type: 'string',
+                },
             },
             additionalProperties: false,
         },
+        OpenAiImageGenerationOptions: {
+            type: 'object',
+            properties: {
+                model: {
+                    type: 'string',
+                },
+                force: {
+                    type: 'boolean',
+                },
+                action: {
+                    type: 'string',
+                    enum: ['auto', 'generate', 'edit'],
+                },
+                size: {
+                    type: 'string',
+                },
+                quality: {
+                    type: 'string',
+                    enum: ['auto', 'low', 'medium', 'high', 'xhigh', 'max'],
+                },
+                background: {
+                    type: 'string',
+                    enum: ['auto', 'opaque', 'transparent'],
+                },
+                output_format: {
+                    type: 'string',
+                    enum: ['png', 'jpeg', 'webp'],
+                },
+                output_compression: {
+                    type: 'integer',
+                    minimum: 0,
+                    maximum: 100,
+                },
+                moderation: {
+                    type: 'string',
+                    enum: ['auto', 'low'],
+                },
+                input_fidelity: {
+                    type: 'string',
+                    enum: ['low', 'high'],
+                },
+                partial_images: {
+                    type: 'number',
+                },
+                input_image_mask: {
+                    $ref: '#/$defs/OpenAiImageGenerationMask',
+                },
+            },
+            required: ['model'],
+            additionalProperties: false,
+        },
         OpenAiSpeechOptions: {
             type: 'object',
             properties: {
@@ -1477,6 +1607,9 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     const: 'openai-text',
                 },
+                image_generation: {
+                    $ref: '#/$defs/OpenAiImageGenerationOptions',
+                },
                 max_tokens: {
                     type: 'number',
                 },
@@ -1536,6 +1669,9 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     const: 'openai-thinking',
                 },
+                image_generation: {
+                    $ref: '#/$defs/OpenAiImageGenerationOptions',
+                },
                 max_tokens: {
                     type: 'number',
                 },
@@ -1555,6 +1691,10 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 reasoning_effort: {
                     $ref: '#/$defs/ReasoningEffort',
                 },
+                reasoning_context: {
+                    type: 'string',
+                    enum: ['auto', 'current_turn', 'all_turns'],
+                },
                 image_detail: {
                     type: 'string',
                     enum: ['low', 'high', 'auto'],
@@ -1806,6 +1946,12 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     enum: ['low', 'medium', 'high', 'xhigh', 'max'],
                 },
+                thinking_mode: {
+                    type: 'string',
+                    enum: ['adaptive', 'between_tools'],
+                    description:
+                        'Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved.',
+                },
                 thinking_budget_tokens: {
                     type: 'number',
                 },