@vertesia/common 1.6.0-dev.20261008.064737Z → 1.6.0-dev.20261014.015055Z

package/src/api-schemas/process.ts

@@ -1187,11 +1187,29 @@ export const UpdateProcessTestSuitePayloadSchema = CreateProcessTestSuitePayload
     id: 'UpdateProcessTestSuitePayload',
 });
 
+/**
+ * Makes starting a test run safe to retry. Starting a run is otherwise not idempotent: a request the
+ * client gave up on can still complete server-side, and resending it would start a second run.
+ */
+const ProcessTestRunIdempotencyKeySchema = z
+    .string()
+    .min(1)
+    .max(256)
+    .meta({
+        description:
+            'Client-chosen key, unique per intended run, that makes this request safe to retry. A repeat of ' +
+            'the request with the same key and the same body returns the run the first request started ' +
+            'instead of starting another. Reusing a key with a different body is rejected with 409. Keys ' +
+            'are scoped to the project and stay bound to their run for as long as it exists; once the run ' +
+            'is deleted, the same key starts a new one.',
+    });
+
 export const StartProcessTestRunPayloadSchema = z
     .strictObject({
         suite_id: z.string(),
         process_revision_id: z.string(),
         scenario_ids: z.array(z.string()).optional(),
+        idempotency_key: ProcessTestRunIdempotencyKeySchema.optional(),
     })
     .meta({ id: 'StartProcessTestRunPayload' });
 
@@ -1265,6 +1283,7 @@ export const SubmitProcessTestRunPayloadSchema = z
     .strictObject({
         process: ProcessTestTargetSchema,
         scenarios: z.array(ProcessTestScenarioSchema).min(1),
+        idempotency_key: ProcessTestRunIdempotencyKeySchema.optional(),
     })
     .meta({ id: 'SubmitProcessTestRunPayload' });
 

package/src/api-schemas/registry.ts

@@ -32,44 +32,10 @@ import {
     VideoResultSchema,
 } from '@llumiverse/common/schemas';
 import type { z } from 'zod';
-import type {
-    CreateEventSubscriptionPayload,
-    EventDeliveryTarget,
-    EventDeliveryTargetInput,
-    EventSubscription,
-    EventSubscriptionMutationResponse,
-    ProcessEventDeliveryTarget,
-    UpdateEventSubscriptionPayload,
-} from '../platform-event.js';
-import type {
-    AgentRunInternals,
-    AgentRunResponse,
-    BindRunWorkflowPayload,
-    ListAgentRunsResponse,
-    ProgrammaticRunResponse,
-    RecordRunPayload,
-    SupervisedRunResponse,
-    UpdateAgentRunStatusPayload,
-} from '../store/agent-run.js';
-import type * as DSLWorkflowTypes from '../store/dsl-workflow.js';
-import type {
-    DSLChildWorkflowStep,
-    DSLWorkflowDefinition,
-    DSLWorkflowDefinitionResponse,
-    DSLWorkflowSpec,
-    DSLWorkflowSpecWithSteps,
-    DSLWorkflowStep,
-} from '../store/dsl-workflow.js';
-import type {
-    BranchNodeBranchDefinition,
-    CreateProcessDefinitionPayload,
-    NodeDefinition,
-    ProcessDefinition,
-    ProcessDefinitionBody,
-    UpdateProcessDefinitionPayload,
-} from '../store/process.js';
-import type { ViewNavigationNode } from '../views.js';
-import type { ApiComponentTypes } from '../wire-types.generated.js';
+import type { ApiComponentType } from '../api-contract/types.js';
+
+export type { ApiComponentType } from '../api-contract/types.js';
+
 import {
     ACECreatePayloadSchema,
     ACEUpdatePayloadSchema,
@@ -1429,12 +1395,6 @@ const CONTENT_TYPE_CATALOG_SCHEMAS: {
     readonly ContentObjectTypeItemArray: typeof ContentObjectTypeItemArraySchema;
     readonly ContentObjectTypeCatalogEntry: typeof ContentObjectTypeCatalogEntrySchema;
     readonly ContentObjectTypeCatalogEntryArray: typeof ContentObjectTypeCatalogEntryArraySchema;
-    readonly InCodeTypeDefinition: typeof InCodeTypeDefinitionSchema;
-    readonly CreateContentObjectTypePayload: typeof CreateContentObjectTypePayloadSchema;
-    readonly UpdateContentObjectTypePayload: typeof UpdateContentObjectTypePayloadSchema;
-    readonly ContentObjectType: typeof ContentObjectTypeSchema;
-    readonly ContentObjectTypeCatalogQuery: typeof ContentObjectTypeCatalogQuerySchema;
-    readonly ContentObjectTypeListQuery: typeof ContentObjectTypeListQuerySchema;
 } = {
     ColumnLayout: ColumnLayoutSchema,
     ContentTypeEditingPolicy: ContentTypeEditingPolicySchema,
@@ -1443,6 +1403,9 @@ const CONTENT_TYPE_CATALOG_SCHEMAS: {
     ContentObjectTypeItemArray: ContentObjectTypeItemArraySchema,
     ContentObjectTypeCatalogEntry: ContentObjectTypeCatalogEntrySchema,
     ContentObjectTypeCatalogEntryArray: ContentObjectTypeCatalogEntryArraySchema,
+} as const satisfies Record<string, z.ZodType>;
+
+const CONTENT_TYPE_AUTHORING_SCHEMAS = {
     InCodeTypeDefinition: InCodeTypeDefinitionSchema,
     CreateContentObjectTypePayload: CreateContentObjectTypePayloadSchema,
     UpdateContentObjectTypePayload: UpdateContentObjectTypePayloadSchema,
@@ -1724,6 +1687,7 @@ const CONTENT_OBJECT_SCHEMAS = {
     TranscriptSegment: ContentSchemas.TranscriptSegmentSchema,
     ContentObjectTypeArray: ContentSchemas.ContentObjectTypeArraySchema,
     ContentObjectTextResponse: ContentSchemas.ContentObjectTextResponseSchema,
+    SetObjectTextPayload: ContentSchemas.SetObjectTextPayloadSchema,
     DeleteContentObjectResult: ContentSchemas.DeleteContentObjectResultSchema,
     Transcript: ContentSchemas.TranscriptSchema,
     CreateContentObjectPayload: ContentSchemas.CreateContentObjectPayloadSchema,
@@ -2482,6 +2446,7 @@ const API_SCHEMA_GROUPS = [
     FILE_STORAGE_SCHEMAS,
     DURABLE_TASK_SCHEMAS,
     CONTENT_TYPE_CATALOG_SCHEMAS,
+    CONTENT_TYPE_AUTHORING_SCHEMAS,
     MIGRATION_COMMAND_SCHEMAS,
     PROCESS_DSL_SCHEMAS,
     AGENT_MESSAGE_SCHEMAS,
@@ -2546,6 +2511,7 @@ type ApiSchemaMap = typeof RUN_BUDGET_SCHEMAS &
     typeof FILE_STORAGE_SCHEMAS &
     typeof DURABLE_TASK_SCHEMAS &
     typeof CONTENT_TYPE_CATALOG_SCHEMAS &
+    typeof CONTENT_TYPE_AUTHORING_SCHEMAS &
     typeof MIGRATION_COMMAND_SCHEMAS &
     typeof PROCESS_DSL_SCHEMAS &
     typeof AGENT_MESSAGE_SCHEMAS &
@@ -3126,6 +3092,7 @@ const STRICT_COMPONENTS: ReadonlySet<string> = new Set<string>([
     'ViewExecutionSearchConfiguration',
     'DSLRetryPolicy',
     'CreateContentObjectPayload',
+    'SetObjectTextPayload',
     'EventIngestChannelMutationResponse',
     'CreateEventIngestChannelPayload',
     'AgentRun',
@@ -3651,74 +3618,6 @@ export function buildApiSchemaComponents(): Readonly<Record<string, JsonObject>>
     return toOpenApiComponents(emitRawSchemas(), { strictComponents: STRICT_COMPONENTS });
 }
 
-/**
- * Explicit TypeScript recursion boundary for schemas whose runtime graph is lazy.
- *
- * Zod cannot infer a finite named type through a mutually-recursive graph. The schemas remain the
- * runtime and OpenAPI authority; these names preserve the recursive TypeScript declarations until
- * TypeScript can infer recursive aliases without collapsing them to `unknown`.
- */
-interface ZenoRecursiveComponentTypes {
-    ViewNavigationNode: ViewNavigationNode;
-    AgentRunResponse: AgentRunResponse;
-    AgentRunInternals: AgentRunInternals;
-    BindRunWorkflowPayload: BindRunWorkflowPayload;
-    BranchNodeBranchDefinition: BranchNodeBranchDefinition;
-    CreateEventSubscriptionPayload: CreateEventSubscriptionPayload;
-    CreateProcessDefinitionPayload: CreateProcessDefinitionPayload;
-    DSLChildWorkflowStep: DSLChildWorkflowStep;
-    DSLWorkflowDefinition: DSLWorkflowDefinition;
-    DSLWorkflowDefinitionResponse: DSLWorkflowDefinitionResponse;
-    DSLWorkflowSpec: DSLWorkflowSpec;
-    DSLWorkflowSpecWithActivities: DSLWorkflowTypes.DSLWorkflowSpecWithActivities;
-    DSLWorkflowSpecWithSteps: DSLWorkflowSpecWithSteps;
-    DSLWorkflowStep: DSLWorkflowStep;
-    EventDeliveryTarget: EventDeliveryTarget;
-    EventDeliveryTargetInput: EventDeliveryTargetInput;
-    EventSubscription: EventSubscription;
-    EventSubscriptionArray: EventSubscription[];
-    EventSubscriptionMutationResponse: EventSubscriptionMutationResponse;
-    ListAgentRunsResponse: ListAgentRunsResponse;
-    NodeDefinition: NodeDefinition;
-    NodeDefinitionMap: Record<string, NodeDefinition>;
-    ProcessDefinition: ProcessDefinition;
-    ProcessDefinitionArray: ProcessDefinition[];
-    ProcessDefinitionBody: ProcessDefinitionBody;
-    ProcessEventDeliveryTarget: ProcessEventDeliveryTarget;
-    ProgrammaticRunResponse: ProgrammaticRunResponse;
-    RecordRunPayload: RecordRunPayload;
-    SupervisedRunResponse: SupervisedRunResponse;
-    UpdateAgentRunStatusPayload: UpdateAgentRunStatusPayload;
-    UpdateEventSubscriptionPayload: UpdateEventSubscriptionPayload;
-    UpdateProcessDefinitionPayload: UpdateProcessDefinitionPayload;
-    WorkflowDefinitionPayload: DSLWorkflowTypes.WorkflowDefinitionPayload;
-    WorkflowDefinitionPayloadWithActivities: DSLWorkflowTypes.WorkflowDefinitionPayloadWithActivities;
-    WorkflowDefinitionPayloadWithSteps: DSLWorkflowTypes.WorkflowDefinitionPayloadWithSteps;
-}
-
-/**
- * The wire type a component publishes.
- *
- * `ApiComponentType<'Account'>` is the plain type `gen:schemas` writes for `AccountSchema` into
- * `ApiComponentTypes`, which `wire-types.generated.test.ts` proves identical to its `z.infer`. Indexing
- * that map rather than `z.infer<ApiSchemaMap[N]>` keeps Zod's inference out of every program that names
- * a component. A component the generator has not seen yet resolves to `never`, which
- * `registry-groups.test.ts` rejects.
- *
- * It is wrapped in `NoInfer` because `N` always comes from a component-name argument and can never be
- * recovered from the wire type. Without it, a call whose result has a contextual type — a destructuring
- * `const { file } = validatedQuery(ctx, 'FileMetadataQuery')`, an `await`, a typed `return` — makes the
- * checker infer `N` from that context while `N` is still unresolved, which evaluates `z.infer` across
- * every component in the registry: about 500k types, 1 GB and 2 s of `tsc` in each consuming program.
- */
-export type ApiComponentType<N extends ApiComponentName> = NoInfer<
-    N extends keyof ZenoRecursiveComponentTypes
-        ? ZenoRecursiveComponentTypes[N]
-        : N extends keyof ApiComponentTypes
-          ? ApiComponentTypes[N]
-          : never
->;
-
 /**
  * Names a published component from inside a handler signature:
  * `Promise<ApiSchemaOf<'Account'>>`.

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

@@ -509,6 +509,16 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                         type: 'string',
                     },
                 },
+                effort: {
+                    $ref: '#/$defs/ReasoningEffort',
+                },
+                reasoning_effort: {
+                    $ref: '#/$defs/ReasoningEffort',
+                },
+                verbosity: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high'],
+                },
                 include_thoughts: {
                     type: 'boolean',
                 },
@@ -731,6 +741,9 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                     type: 'string',
                     const: 'bedrock-nova',
                 },
+                effort: {
+                    $ref: '#/$defs/ReasoningEffort',
+                },
                 max_tokens: {
                     type: 'number',
                 },
@@ -1610,6 +1623,9 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
                 image_generation: {
                     $ref: '#/$defs/OpenAiImageGenerationOptions',
                 },
+                seed: {
+                    type: 'number',
+                },
                 max_tokens: {
                     type: 'number',
                 },
@@ -1732,6 +1748,9 @@ export const ContentTypeIntakePolicySchema: JSONObject = {
         OpenRouterTextOptions: {
             type: 'object',
             properties: {
+                seed: {
+                    type: 'number',
+                },
                 max_tokens: {
                     type: 'number',
                 },

package/src/store/store.ts

@@ -136,6 +136,8 @@ export type ContentObjectUserPermissions = Wire.ContentObjectUserPermissions;
 
 export type ContentObjectTextResponse = Wire.ContentObjectTextResponse;
 
+export type SetObjectTextPayload = Wire.SetObjectTextPayload;
+
 export type DeleteContentObjectResult = Wire.DeleteContentObjectResult;
 
 export type SetObjectEmbeddingsResponse = Wire.SetObjectEmbeddingsResponse;

package/src/wire-types.generated.ts

@@ -2542,6 +2542,14 @@ export type AlterTableOperation =
           op: 'modify_column';
           column: string;
           updates: DataColumnUpdate;
+      }
+    | {
+          op: 'add_foreign_key';
+          foreign_key: DataForeignKey;
+      }
+    | {
+          op: 'drop_foreign_key';
+          column: string;
       };
 /**
  * Payload for altering a table schema.
@@ -3514,6 +3522,7 @@ export type UserGroup = {
     clearance?: number | undefined;
     compartments?: string[] | undefined;
     allowed_projects?: string[] | undefined;
+    member_count?: number | undefined;
 };
 export type CreateUserGroupPayload = {
     name: string;
@@ -5794,6 +5803,7 @@ export type StartProjectReindexPayload = {
     concurrency?: number | undefined;
     bulk_size_bytes?: number | undefined;
     bulk_concurrency?: number | undefined;
+    modified_since?: string | undefined;
 };
 export type ReindexAgentRunsPayload = {
     recreate_index?: boolean | undefined;
@@ -7455,6 +7465,7 @@ export type StartProcessTestRunPayload = {
     suite_id: string;
     process_revision_id: string;
     scenario_ids?: string[] | undefined;
+    idempotency_key?: string | undefined;
 };
 export type ProcessTestAssertionResult = {
     assertion: string;
@@ -7720,6 +7731,10 @@ export type ContentObjectUserPermissions = {
 export type ContentObjectTextResponse = {
     text?: string | undefined;
 };
+export type SetObjectTextPayload = {
+    text: string;
+    etag?: string | undefined;
+};
 export type DeleteContentObjectResult = {
     id: string;
     count: number;
@@ -9828,6 +9843,7 @@ export type ProcessTestTargetWithDefinitionWire = {
 export type SubmitProcessTestRunPayloadWire = {
     process: ProcessTestTargetWire;
     scenarios: ProcessTestScenario[];
+    idempotency_key?: string | undefined;
 };
 export type CreateContentObjectPayloadWire = {
     text?: string | undefined;
@@ -10493,7 +10509,9 @@ export type TurnEvaluationFlagWire =
     | 'overhead'
     | 'followup_after_answer'
     | 'approval_denied'
-    | 'circuit_breaker';
+    | 'circuit_breaker'
+    | 'no_visible_answer'
+    | 'answer_in_tool_preamble';
 export type ToolErrorClassWire = 'schema' | 'platform' | 'config' | 'environment' | 'other';
 export type EvaluationGateReasonWire = 'signal' | 'sample' | 'opt_in' | 'always_on';
 export type EvaluationOutcomeWire = 'evaluated' | 'skipped_unarchived' | 'failed';
@@ -11286,6 +11304,7 @@ export interface ApiComponentTypes {
     TranscriptSegment: TranscriptSegment;
     ContentObjectTypeArray: ContentObjectTypeArray;
     ContentObjectTextResponse: ContentObjectTextResponse;
+    SetObjectTextPayload: SetObjectTextPayload;
     DeleteContentObjectResult: DeleteContentObjectResult;
     Transcript: Transcript;
     CreateContentObjectPayload: CreateContentObjectPayloadWire;

package/src/workflow-analytics.ts

@@ -84,7 +84,9 @@ export type TurnEvaluationFlag =
     | 'overhead'
     | 'followup_after_answer'
     | 'approval_denied'
-    | 'circuit_breaker';
+    | 'circuit_breaker'
+    | 'no_visible_answer'
+    | 'answer_in_tool_preamble';
 
 /** Coarse class of a tool error, derived from the error text. */
 export type ToolErrorClass = 'schema' | 'platform' | 'config' | 'environment' | 'other';
@@ -238,6 +240,14 @@ interface BaseLlmCallEvent extends BaseAgentEvent {
     streamingEnabled: boolean;
     /** Number of tool uses returned by the LLM */
     toolUseCount: number;
+    /** Provider stop reason, normalized by the driver (`stop`, `length`, `tool_use`, ...). Absent on failed calls. */
+    finishReason?: string;
+    /**
+     * Characters of visible output (text and JSON parts, trimmed; thoughts and media excluded).
+     * `0` with `toolUseCount: 0` and `finishReason: 'stop'` is a completion with nothing to show.
+     * Absent on failed calls and on events from producers that predate the field.
+     */
+    outputTextChars?: number;
     /** Type of call: 'start' for initial, 'resume_tools' for tool results, 'resume_user' for user message */
     callType: LlmCallType;
     /** Activity attempt number (for retries) */
@@ -415,6 +425,16 @@ export interface TurnEvaluationEvent extends BaseAgentEvent {
     stallCorrectives?: number;
     /** Stall circuit-breaker trips: the model ignored the corrective and the loop was stopped. Same caveat. */
     stallTrips?: number;
+    /**
+     * Characters of the answers posted in the turn. `0` with a `no_visible_answer` flag is a turn the
+     * user saw end without a reply. Absent on events from producers that predate the field.
+     */
+    answerChars?: number;
+    /**
+     * Characters of text the model sent alongside its last tool calls in the turn. Text sent with tool
+     * calls is shown as working prose, not as the answer. Same caveat.
+     */
+    finalToolCallTextChars?: number;
     /** An unprompted user message after an answer was followed by substantive tool work */
     followupAfterAnswer: boolean;
     severity: EvaluationSeverity;