@vertesia/common 1.5.0-dev.20260901.045442Z → 1.5.0-dev.20260905.011013Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/common",
-  "version": "1.5.0-dev.20260901.045442Z",
+  "version": "1.5.0-dev.20260905.011013Z",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./lib/index.js",
@@ -36,7 +36,7 @@
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "zod": "^4.4.3",
-    "@llumiverse/common": "1.5.0-dev.20260831.235912Z"
+    "@llumiverse/common": "1.5.0-dev.20260905.004250Z"
   },
   "repository": {
     "type": "git",
@@ -51,7 +51,7 @@
     "ai",
     "typescript"
   ],
-  "gitHead": "52481a0537557578febbaf2494b9af5c023ccc70",
+  "gitHead": "ea74a29f6885cec132eec4b6b319e40137df3b40",
   "scripts": {
     "lint": "biome lint src",
     "test": "vitest run",

package/src/api-contract/components.generated.json

@@ -2771,7 +2771,9 @@
         "enum": [
           "text_to_video",
           "image_to_video",
-          "reference_to_video"
+          "reference_to_video",
+          "edit",
+          "extend"
         ]
       },
       "aspect_ratio": {
@@ -2785,6 +2787,15 @@
         "type": "integer",
         "minimum": 3,
         "maximum": 10
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "360p",
+          "720p",
+          "1080p",
+          "4k"
+        ]
       }
     },
     "required": [
@@ -7342,6 +7353,14 @@
     ],
     "additionalProperties": false
   },
+  "SupportedEmbeddingTypes": {
+    "type": "string",
+    "enum": [
+      "text",
+      "image",
+      "properties"
+    ]
+  },
   "EmbeddingsApiInput": {
     "oneOf": [
       {
@@ -7381,8 +7400,13 @@
           "$ref": "#/components/schemas/EmbeddingsApiInput"
         }
       },
+      "embedding_type": {
+        "$ref": "#/components/schemas/SupportedEmbeddingTypes",
+        "description": "Logical project embedding type. This distinguishes properties embeddings from text inputs when the server resolves an omitted model from project settings."
+      },
       "model": {
-        "type": "string"
+        "type": "string",
+        "description": "Explicit model override intended for validating a configuration before it is saved. Normal callers should omit this field and provide embedding_type so the project model is resolved."
       },
       "task_type": {
         "$ref": "#/components/schemas/EmbeddingTaskType"
@@ -13463,6 +13487,13 @@
       },
       "message": {
         "type": "string"
+      },
+      "results": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/ToolResult"
+        },
+        "description": "Tool results owed to the model, delivered with this message."
       }
     },
     "required": [
@@ -17182,6 +17213,11 @@
           "$ref": "#/components/schemas/AppScaffoldModule"
         }
       },
+      "appgen_package_spec": {
+        "type": "string",
+        "pattern": "^(?: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.-]+)?)$",
+        "description": "Optional Vertesia SDK version or package track for this scaffold. Overrides the deployment default."
+      },
       "create_version": {
         "type": "boolean",
         "description": "Start an initial app version build after the source has been pushed. Defaults to true."
@@ -27592,14 +27628,6 @@
     ],
     "additionalProperties": false
   },
-  "SupportedEmbeddingTypes": {
-    "type": "string",
-    "enum": [
-      "text",
-      "image",
-      "properties"
-    ]
-  },
   "StartContentObjectExportRequest": {
     "type": "object",
     "properties": {

package/src/api-schemas/app-lifecycle.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { APPGEN_PACKAGE_SPEC_PATTERN } from '../appgen.js';
 import { AppAccessControlSchema, AppAvailableInSchema, MCPToolAnnotationsSchema } from './apps.js';
 import { EventCategorySchema } from './audit-trail.js';
 
@@ -404,6 +405,14 @@ export const StartAppScaffoldRequestSchema = z
         title: z.string().optional(),
         description: z.string().optional(),
         modules: z.array(AppScaffoldModuleSchema).optional(),
+        appgen_package_spec: z
+            .string()
+            .regex(APPGEN_PACKAGE_SPEC_PATTERN)
+            .meta({
+                description:
+                    'Optional Vertesia SDK version or package track for this scaffold. Overrides the deployment default.',
+            })
+            .optional(),
         create_version: z
             .boolean()
             .meta({

package/src/api-schemas/embeddings.ts

@@ -1,5 +1,6 @@
 import { EmbeddingTaskTypeSchema } from '@llumiverse/common/schemas';
 import { z } from 'zod';
+import { SupportedEmbeddingTypesSchema } from './content.js';
 
 /**
  * The request half of `POST /environments/:envId/embeddings`.
@@ -83,7 +84,19 @@ export const EmbeddingsApiInputSchema = z
 export const EmbeddingsApiRequestSchema = z
     .strictObject({
         inputs: z.array(EmbeddingsApiInputSchema),
-        model: z.string().optional(),
+        embedding_type: SupportedEmbeddingTypesSchema.meta({
+            description:
+                'Logical project embedding type. This distinguishes properties embeddings from text inputs when ' +
+                'the server resolves an omitted model from project settings.',
+        }).optional(),
+        model: z
+            .string()
+            .meta({
+                description:
+                    'Explicit model override intended for validating a configuration before it is saved. Normal ' +
+                    'callers should omit this field and provide embedding_type so the project model is resolved.',
+            })
+            .optional(),
         task_type: EmbeddingTaskTypeSchema.optional(),
         dimensions: z.number().optional(),
     })

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

@@ -165,6 +165,21 @@ describe('the embeddings request', () => {
         // adding the constraint would newly reject a request the document has always described.
         expect(validateApiRequest('EmbeddingsApiRequest', { inputs: [] }).valid).toBe(true);
     });
+
+    it('accepts the logical project embedding type and rejects unknown types', () => {
+        expect(
+            validateApiRequest('EmbeddingsApiRequest', {
+                embedding_type: 'properties',
+                inputs: [{ type: 'text', text: '{}' }],
+            }).valid,
+        ).toBe(true);
+        expect(
+            validateApiRequest('EmbeddingsApiRequest', {
+                embedding_type: 'audio',
+                inputs: [{ type: 'audio', source: { url: 'gs://b/o' } }],
+            }).valid,
+        ).toBe(false);
+    });
 });
 
 function enumOf(component: 'SupportedProviders'): string[] {

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

@@ -15,6 +15,7 @@ import {
     PromptSegmentDefSchema,
     ResolvedCatalogInteractionSchema,
 } 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 +229,33 @@ 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);
+    });
+});

package/src/api-schemas/interaction.ts

@@ -2453,7 +2453,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

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,