@vertesia/common 1.5.0-dev.20260901.052906Z → 1.5.0-dev.20260910.051115Z

package/src/api-schemas/interaction.contract.test.ts

@@ -14,7 +14,9 @@ import {
     InteractionUpdatePayloadSchema,
     PromptSegmentDefSchema,
     ResolvedCatalogInteractionSchema,
+    RunClonePayloadSchema,
 } from './interaction.js';
+import { validateApiRequest } from './registry.js';
 
 describe('conversation state contract', () => {
     it('publishes the tool catalog storage scope used to resolve tool references', () => {
@@ -228,3 +230,55 @@ describe('interaction contracts', () => {
         ).toBe(true);
     });
 });
+
+describe('user message payload contract', () => {
+    const base = {
+        run: { id: 'run-1', account: 'acc-1', project: 'proj-1' },
+        environment: 'env-1',
+        options: { model: 'model-1' },
+        tools: [],
+        message: 'Search the other collection instead.',
+    };
+
+    it('accepts tool results owed to the model alongside the message', () => {
+        // A stop or an approval denial can leave results undelivered. They have to travel with
+        // the message that resumes the conversation: the payload is strict, so before `results`
+        // existed here the server rejected them and the work was silently dropped.
+        const result = validateApiRequest('UserMessagePayload', {
+            ...base,
+            results: [{ tool_use_id: 'search-1', content: 'found 3 docs', is_error: false }],
+        });
+
+        expect(result.valid).toBe(true);
+    });
+
+    it('still accepts a message with no owed results', () => {
+        expect(validateApiRequest('UserMessagePayload', base).valid).toBe(true);
+    });
+
+    it('stays closed to undeclared fields', () => {
+        expect(validateApiRequest('UserMessagePayload', { ...base, unsupported: true }).valid).toBe(false);
+    });
+});
+
+describe('inference workflow attribution', () => {
+    it('keeps required clone workflow identifiers free of execution deprecation metadata', () => {
+        const workflow = RunClonePayloadSchema.shape.workflow.shape;
+        expect(workflow.run_id.meta()?.deprecated).toBeUndefined();
+        expect(workflow.workflow_id.meta()?.deprecated).toBeUndefined();
+    });
+    it('accepts root agent attribution on execution and clone requests', () => {
+        const workflow = { run_id: 'child-run', workflow_id: 'workstream:parent:child', agent_run_id: 'root-agent' };
+        expect(validateApiRequest('ExecutionRunWorkflow', workflow).valid).toBe(true);
+        expect(validateApiRequest('RunClonePayload', { source_run_id: 'source', workflow }).valid).toBe(true);
+        expect(
+            validateApiRequest('ExecutionRunWorkflow', { run_id: 'legacy', workflow_id: 'AgentRun:legacy' }).valid,
+        ).toBe(true);
+    });
+});
+
+describe('background inference telemetry contract', () => {
+    it('accepts the background call type in the generated runtime contract', () => {
+        expect(validateApiRequest('LlmCallType', 'background').valid).toBe(true);
+    });
+});

package/src/api-schemas/interaction.ts

@@ -304,6 +304,9 @@ export const TemplateTypeSchema = z.enum(TemplateType).meta({ id: 'TemplateType'
 
 export const ExecutionRunWorkflowSchema = z
     .strictObject({
+        agent_run_id: z.string().optional().meta({
+            description: 'Root agent run owning this inference, including inference performed by child workstreams.',
+        }),
         rate_limit_id: z
             .string()
             .meta({
@@ -2453,7 +2456,23 @@ export const ToolResultsPayloadSchema = z
     .meta({ id: 'ToolResultsPayload' });
 
 export const UserMessagePayloadSchema = z
-    .strictObject({ ...resumeConversationFields, message: z.string() })
+    .strictObject({
+        ...resumeConversationFields,
+        message: z.string(),
+        /**
+         * Tool results still owed to the model when the user message is sent.
+         *
+         * A conversation can be interrupted — the user stops the run, or a tool approval is
+         * denied — while a tool batch has already produced results, or while `tool_use` blocks
+         * are outstanding. Providers require a `tool_result` for every `tool_use` before the
+         * next turn, so those results have to travel with the message that resumes the
+         * conversation rather than in a separate turn of their own.
+         */
+        results: z
+            .array(ToolResultSchema)
+            .optional()
+            .meta({ description: 'Tool results owed to the model, delivered with this message.' }),
+    })
     .meta({ id: 'UserMessagePayload' });
 
 export const ExecutionResponseSchema = z
@@ -2461,6 +2480,7 @@ export const ExecutionResponseSchema = z
         result: z.array(CompletionResultSchema),
         token_usage: ExecutionTokenUsageSchema.optional(),
         prompt_cache_diagnostic: PromptCacheDiagnosticSchema.optional(),
+        service_tier: z.string().meta({ description: 'Processing tier actually used by the provider' }).optional(),
         tool_use: z.array(ToolUseSchema).optional(),
         finish_reason: z.string().optional(),
         error: z
@@ -2527,6 +2547,10 @@ export const ComputeRunFacetsResponseSchema = z
 export const RunClonePayloadSchema = z
     .strictObject({
         source_run_id: z.string(),
-        workflow: z.strictObject({ run_id: z.string(), workflow_id: z.string() }),
+        workflow: z.strictObject({
+            run_id: z.string(),
+            workflow_id: z.string(),
+            agent_run_id: ExecutionRunWorkflowSchema.shape.agent_run_id,
+        }),
     })
     .meta({ id: 'RunClonePayload' });

package/src/api-schemas/llumiverse.contract.test.ts

@@ -111,6 +111,22 @@ describe('the ModelOptions closure is published whole and enforced closed', () =
         ).toBe(true);
         expect(validate({ _option_id: 'openai-text', extra_body: ['invalid'] })).toBe(false);
     });
+
+    it('accepts Gemini Omni task and resolution options through the run request contract', () => {
+        const result = validateApiRequest('RunCreatePayload', {
+            interaction: 'GenerateVideo',
+            config: {
+                model: 'locations/global/publishers/google/models/gemini-omni-1.1-flash-preview',
+                model_options: {
+                    _option_id: 'vertexai-gemini-omni-video',
+                    task: 'extend',
+                    resolution: '4k',
+                },
+            },
+        });
+
+        expect(result.valid ? [] : result.errors).toEqual([]);
+    });
 });
 
 describe('the JSONSchema closure is published open, because a JSON Schema is open', () => {

package/src/appgen.ts

@@ -0,0 +1,4 @@
+export const APPGEN_PACKAGE_SPEC_PATTERN_SOURCE =
+    '^(?:latest|dev|dev-[0-9]+\\.[0-9]+|snapshot-[0-9a-f]{7}|[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?)$';
+
+export const APPGEN_PACKAGE_SPEC_PATTERN = new RegExp(APPGEN_PACKAGE_SPEC_PATTERN_SOURCE);

package/src/index.ts

@@ -13,6 +13,7 @@ export type {
     UserRefArrayFromSchema,
 } from './api-schemas/user.js';
 export * from './apikey.js';
+export * from './appgen.js';
 export * from './apps.js';
 export * from './ask-user.js';
 export * from './audit-trail.js';

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

@@ -1592,7 +1592,7 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 },
                 task: {
                     type: 'string',
-                    enum: ['text_to_video', 'image_to_video', 'reference_to_video'],
+                    enum: ['text_to_video', 'image_to_video', 'reference_to_video', 'edit', 'extend'],
                 },
                 aspect_ratio: {
                     type: 'string',
@@ -1603,6 +1603,10 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     minimum: 3,
                     maximum: 10,
                 },
+                resolution: {
+                    type: 'string',
+                    enum: ['360p', '720p', '1080p', '4k'],
+                },
             },
             required: ['_option_id'],
             additionalProperties: false,

package/src/workflow-analytics.ts

@@ -32,6 +32,8 @@ export enum LlmCallType {
     Checkpoint = 'checkpoint',
     /** Nested interaction call from within tools */
     NestedInteraction = 'nested_interaction',
+    /** Background inference attributed to an agent, such as topic generation */
+    Background = 'background',
 }
 
 /**