@vertesia/common 1.5.0-dev.20260807.073259Z → 1.5.0-dev.20260901.005903Z

package/src/project.ts

@@ -21,6 +21,8 @@ import type {
     ProjectPluginsUpdatePayloadSchema,
     ProjectSchema,
     ProjectTagQuerySchema,
+    UpdateProjectConfigurationPayloadSchema,
+    UpdateProjectPayloadSchema,
 } from './api-schemas/project.js';
 import type {
     AgentCheckpointConfigurationSchema,
@@ -29,6 +31,7 @@ import type {
     BrowserUseRiskPolicySchema,
     BrowserUseScreenshotCaptureSchema,
     ElasticsearchBackendSchema,
+    IntakeVisionProfileSettingsUpdateSchema,
     ModalityDefaultsSchema,
     ModelDefaultSchema,
     ProjectConfigurationEmbeddingSchema,
@@ -43,7 +46,6 @@ import type {
     SystemDefaultsSchema,
 } from './api-schemas/project-configuration.js';
 import type { AccountRef } from './user.js';
-import { ELASTICSEARCH_FIELD_PATH_PATTERN } from './view-validation-helpers.js';
 
 /**
  * `SystemRoles` lives in `./project-values.js` so the API schemas can read it without importing this
@@ -51,25 +53,8 @@ import { ELASTICSEARCH_FIELD_PATH_PATTERN } from './view-validation-helpers.js';
  */
 export * from './project-values.js';
 
-import { SystemRoles } from './project-values.js';
-
 export type ICreateProjectPayload = CreateProjectPayloadFromSchema;
 
-export function isRoleIncludedIn(role: string, includingRole: string) {
-    switch (includingRole) {
-        case SystemRoles.owner:
-            return true; // includes billing to?
-        case SystemRoles.admin:
-            return role !== SystemRoles.billing && role !== SystemRoles.owner;
-        case SystemRoles.developer:
-            return role === SystemRoles.developer;
-        case SystemRoles.billing:
-            return role === SystemRoles.billing;
-        default:
-            return false;
-    }
-}
-
 export interface PopulatedProjectRef {
     id: string;
     name: string;
@@ -131,27 +116,10 @@ export const SYSTEM_INTERACTION_CATEGORIES: Record<string, SystemInteractionCate
     AnalyzeConversation: SystemInteractionCategory.analysis,
     GetAgentConversationTopic: SystemInteractionCategory.analysis,
     ContentSearchAgent: SystemInteractionCategory.analysis,
+    ContentSearchReranker: SystemInteractionCategory.analysis,
     StudioAssistant: SystemInteractionCategory.agent,
 };
 
-/**
- * Get category for a system interaction endpoint.
- * Returns undefined if category is non-applicable or endpoint is not recognized.
- * Note: Caller is responsible for determining if the interaction is a system interaction.
- * @param endpoint - The interaction endpoint name
- */
-export function getSystemInteractionCategory(endpoint: string): SystemInteractionCategory | undefined {
-    if (endpoint.startsWith('sys:')) {
-        // Strip sys: prefix
-        endpoint = endpoint.substring(4);
-    }
-    const category = SYSTEM_INTERACTION_CATEGORIES[endpoint];
-    if (category === SystemInteractionCategory.non_applicable) {
-        return undefined;
-    }
-    return category || undefined;
-}
-
 /**
  * One optional default per {@link SystemInteractionCategory}.
  *
@@ -197,81 +165,6 @@ export type ProjectSearchPropertyType = z.infer<typeof ProjectSearchPropertyType
 
 export type ProjectSearchPropertyMapping = z.infer<typeof ProjectSearchPropertyMappingSchema>;
 
-export const PROJECT_SEARCH_PROPERTY_TYPES: readonly ProjectSearchPropertyType[] = [
-    'keyword',
-    'text',
-    'boolean',
-    'long',
-    'double',
-    'date',
-];
-
-const MAX_PROJECT_SEARCH_PROPERTY_MAPPINGS = 200;
-const MAX_KEYWORD_IGNORE_ABOVE = 8191;
-
-/**
- * Validate property mappings at API and index-creation boundaries.
- *
- * Returns user-facing issue strings instead of throwing so callers can map the
- * result to the error type appropriate for their boundary.
- */
-export function validateProjectSearchPropertyMappings(value: unknown): string[] {
-    if (value === undefined) return [];
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        return ['indexing.property_mappings must be an object keyed by property path'];
-    }
-
-    const entries = Object.entries(value as Record<string, unknown>);
-    const issues: string[] = [];
-    if (entries.length > MAX_PROJECT_SEARCH_PROPERTY_MAPPINGS) {
-        issues.push(`indexing.property_mappings must contain at most ${MAX_PROJECT_SEARCH_PROPERTY_MAPPINGS} fields`);
-    }
-
-    const supportedTypes = new Set<string>(PROJECT_SEARCH_PROPERTY_TYPES);
-    for (const [path, rawMapping] of entries) {
-        const field = `indexing.property_mappings.${path}`;
-        if (!ELASTICSEARCH_FIELD_PATH_PATTERN.test(path)) {
-            issues.push(`${field} must be a dot-separated path containing only letters, numbers, and underscores`);
-        }
-        if (!rawMapping || typeof rawMapping !== 'object' || Array.isArray(rawMapping)) {
-            issues.push(`${field} must be an object`);
-            continue;
-        }
-        const mapping = rawMapping as Record<string, unknown>;
-        const extraKeys = Object.keys(mapping).filter(
-            (key) => !['type', 'format', 'ignore_above', 'ignore_malformed'].includes(key),
-        );
-        if (extraKeys.length > 0) {
-            issues.push(`${field} contains unsupported option(s): ${extraKeys.join(', ')}`);
-        }
-        if (typeof mapping.type !== 'string' || !supportedTypes.has(mapping.type)) {
-            issues.push(`${field}.type must be one of: ${PROJECT_SEARCH_PROPERTY_TYPES.join(', ')}`);
-        }
-        if (mapping.format !== undefined && (mapping.type !== 'date' || typeof mapping.format !== 'string')) {
-            issues.push(`${field}.format is supported only for date mappings`);
-        }
-        if (
-            mapping.ignore_above !== undefined &&
-            (mapping.type !== 'keyword' ||
-                !Number.isInteger(mapping.ignore_above) ||
-                (mapping.ignore_above as number) < 1 ||
-                (mapping.ignore_above as number) > MAX_KEYWORD_IGNORE_ABOVE)
-        ) {
-            issues.push(
-                `${field}.ignore_above is supported only for keyword mappings and must be an integer from 1 to ${MAX_KEYWORD_IGNORE_ABOVE}`,
-            );
-        }
-        if (
-            mapping.ignore_malformed !== undefined &&
-            (!['long', 'double', 'date'].includes(String(mapping.type)) ||
-                typeof mapping.ignore_malformed !== 'boolean')
-        ) {
-            issues.push(`${field}.ignore_malformed is supported only for long, double, and date mappings`);
-        }
-    }
-    return issues;
-}
-
 export type ProjectIndexingConfiguration = z.infer<typeof ProjectIndexingConfigurationSchema>;
 
 // export interface ProjectConfigurationEmbeddings {
@@ -287,7 +180,7 @@ export enum SupportedEmbeddingTypes {
     properties = 'properties',
 }
 
-export enum FullTextType {
+enum FullTextType {
     full_text = 'full_text',
 }
 
@@ -306,13 +199,6 @@ export type ProjectConfigurationEmbeddingEnablePayload = z.infer<
 
 export type Project = z.infer<typeof ProjectSchema>;
 
-export interface ProjectCreatePayload {
-    name: string;
-    description?: string;
-}
-
-export interface ProjectUpdatePayload extends Partial<Project> {}
-
 export type ProjectPluginsUpdatePayload = z.infer<typeof ProjectPluginsUpdatePayloadSchema>;
 
 export const ProjectRefPopulate = 'id name account';
@@ -326,46 +212,6 @@ export type IndexingStatusResponse = z.infer<typeof IndexingStatusResponseSchema
 
 export type StartProjectReindexPayload = z.infer<typeof StartProjectReindexPayloadSchema>;
 
-/**
- * Auto-tunes shard sizing based on project doc count.
- *
- * Returns:
- * - shard_size: target docs per shard (workflow path uses this; zeno-bulk
- *   computes shard count from total/shard_size).
- * - parallel_shard_count: max in-flight shard activities (workflow path only).
- * - max_shards: hard cap on shard count for the direct path. Direct path
- *   passes this as `shards` to zeno-bulk so all shards run as cursors in
- *   ONE process; without this cap, an under-estimated shard_size (e.g.
- *   from stale estimatedDocumentCount) can spawn 10+ in-flight cursors
- *   and exceed Cloud Run memory.
- *
- * Explicit overrides should bypass this function and use user-provided values.
- */
-export function autoTuneReindexParams(docCount: number): {
-    shard_size: number;
-    parallel_shard_count: number;
-    max_shards: number;
-} {
-    if (docCount < 50_000) {
-        // Tiny/small project: aim for ~4 shards, with a 5k floor.
-        return {
-            shard_size: Math.max(Math.ceil(docCount / 4), 5_000),
-            parallel_shard_count: Math.min(4, Math.max(1, Math.ceil(docCount / 5_000))),
-            max_shards: 4,
-        };
-    }
-    if (docCount < 500_000) {
-        // Medium project: 50k shards → 1-10 shards
-        return { shard_size: 50_000, parallel_shard_count: 8, max_shards: 10 };
-    }
-    if (docCount < 2_000_000) {
-        // Large project: 100k shards → 5-20 shards
-        return { shard_size: 100_000, parallel_shard_count: 8, max_shards: 20 };
-    }
-    // Huge project: stick to 250k shards to keep coordination overhead bounded.
-    return { shard_size: 250_000, parallel_shard_count: 8, max_shards: 40 };
-}
-
 export type ReindexAgentRunsPayload = z.infer<typeof ReindexAgentRunsPayloadSchema>;
 
 export type ReindexAgentRunsResponse = z.infer<typeof ReindexAgentRunsResponseSchema>;
@@ -649,7 +495,7 @@ export interface ElasticsearchIndexStats {
 /**
  * Embedding configuration for a single type
  */
-export interface EmbeddingTypeConfig {
+interface EmbeddingTypeConfig {
     environment?: string;
     dimensions?: number;
     model?: string;
@@ -778,3 +624,9 @@ export type DriftAnalysisStatusResponse = z.infer<typeof DriftAnalysisStatusResp
 export type ProjectIntegrationListEntry = z.infer<typeof ProjectIntegrationListEntrySchema>;
 
 export type ProjectIntegrationListResponse = z.infer<typeof ProjectIntegrationListResponseSchema>;
+
+export type UpdateProjectPayload = z.infer<typeof UpdateProjectPayloadSchema>;
+
+export type UpdateProjectConfigurationPayload = z.infer<typeof UpdateProjectConfigurationPayloadSchema>;
+
+export type IntakeVisionProfileSettingsUpdate = z.infer<typeof IntakeVisionProfileSettingsUpdateSchema>;

package/src/prompt.ts

@@ -1,6 +1,9 @@
 import type { JSONSchema, PromptRole } from '@llumiverse/common';
 import type { z } from 'zod';
 import type {
+    ExportedPromptTemplateRefSchema,
+    InteractionPromptSegmentInputSchema,
+    InteractionPromptTemplateInputSchema,
     PromptTemplateCreatePayloadSchema,
     PromptTemplateRefSchema,
     PromptTemplateSchema,
@@ -38,10 +41,6 @@ export interface PromptSegmentDef<T = string | PromptTemplate | PromptTemplateRe
     configuration?: unknown; // the configuration if any in case of builtin prompts
 }
 
-export interface PromptSegmentRef<T = string | PromptTemplate | PromptTemplateRef> extends PromptSegmentDef<T> {
-    id: string;
-}
-
 export interface PopulatedPromptSegmentDef extends Omit<PromptSegmentDef, 'template'> {
     template?: PromptTemplate;
 }
@@ -54,10 +53,6 @@ export interface ExecutablePromptSegmentDef extends Omit<PromptSegmentDef, 'temp
 
 export type PromptTemplateRef = z.infer<typeof PromptTemplateRefSchema>;
 
-export interface PromptTemplateRefWithSchema extends PromptTemplateRef {
-    inputSchema?: JSONSchema;
-}
-
 export enum TemplateType {
     jst = 'jst',
     handlebars = 'handlebars',
@@ -71,6 +66,10 @@ export interface ExecutablePromptTemplate {
 }
 export type PromptTemplate = z.infer<typeof PromptTemplateSchema>;
 
+export type InteractionPromptTemplateInput = z.infer<typeof InteractionPromptTemplateInputSchema>;
+
+export type InteractionPromptSegmentInput = z.infer<typeof InteractionPromptSegmentInputSchema>;
+
 export type PromptTemplateForkPayload = z.infer<typeof PromptTemplateForkPayloadSchema>;
 
 export type PromptTemplateCreatePayload = z.infer<typeof PromptTemplateCreatePayloadSchema>;
@@ -92,3 +91,5 @@ export type RenderPromptPayload = z.infer<typeof RenderPromptPayloadSchema>;
  * been a name for it on either side of the wire.
  */
 export type RenderPromptResponse = z.infer<typeof RenderPromptResponseSchema>;
+
+export type ExportedPromptTemplateRef = z.infer<typeof ExportedPromptTemplateRefSchema>;

package/src/query.ts

@@ -81,15 +81,6 @@ export type InteractionSearchQuery = z.infer<typeof InteractionSearchQuerySchema
 
 export type RunSearchQuery = z.infer<typeof RunSearchQuerySchema>;
 
-export interface WorkflowExecutionSearchQuery extends SimpleSearchQuery {
-    documentId?: string;
-    eventName?: string;
-    ruleId?: string;
-    start?: string;
-    end?: string;
-    status?: string;
-}
-
 export type ComplexSearchQuery = z.infer<typeof ComplexSearchQuerySchema>;
 
 export type ComplexCollectionSearchQuery = z.infer<typeof ComplexCollectionSearchQuerySchema>;

package/src/rate-limiter.ts

@@ -12,20 +12,20 @@ import type {
     QuotaTierResponseSchema,
 } from './api-schemas/quota.js';
 
-export interface RateLimiterCapacity {
+interface RateLimiterCapacity {
     current: number;
     base: number;
     max: number;
 }
 
-export interface RateLimiterBreakerState {
+interface RateLimiterBreakerState {
     state: 'open' | 'closed';
     is_open: boolean;
     last_opened_at?: string;
     consecutive_failures?: number;
 }
 
-export interface RateLimiterModelStatus {
+interface RateLimiterModelStatus {
     model_id: string;
     admitted: number;
     delayed: number;

package/src/runs.ts

@@ -1,6 +1,10 @@
 import type { z } from 'zod';
 import type {
+    ComputeRunFacetsResponseSchema,
     ExecutionRunDocRefSchema,
+    FindRunResultArraySchema,
+    FindRunResultSchema,
+    PopulatedExecutionRunResultSchema,
     RunClonePayloadSchema,
     RunCreatePayloadSchema,
     RunSearchMetaResponseSchema,
@@ -10,6 +14,9 @@ import type {
  * The run ref is used to identify a run document in the storage
  */
 export type ExecutionRunDocRef = z.infer<typeof ExecutionRunDocRefSchema>;
+export type FindRunResult = z.infer<typeof FindRunResultSchema>;
+export type FindRunResultArray = z.infer<typeof FindRunResultArraySchema>;
+export type PopulatedExecutionRunResult = z.infer<typeof PopulatedExecutionRunResultSchema>;
 
 /**
  * Interaction execution payload for creating a new run
@@ -35,3 +42,4 @@ export interface RangeValue {
 }
 
 export type RunSearchMetaResponse = z.infer<typeof RunSearchMetaResponseSchema>;
+export type ComputeRunFacetsResponse = z.infer<typeof ComputeRunFacetsResponseSchema>;

package/src/schema-for-extraction.ts

@@ -7,7 +7,7 @@
  * only the filtered copy is used as result_schema for constrained decoding.
  */
 
-export const X_EXTRACT = 'x-extract';
+const X_EXTRACT = 'x-extract';
 
 function unescapeJsonPointerSegment(segment: string): string {
     return segment.replace(/~1/g, '/').replace(/~0/g, '~');

package/src/secrets.ts

@@ -1,6 +1,7 @@
 import type { z } from 'zod';
 import type {
     CreateSecretRequestSchema,
+    DeleteSecretResponseSchema,
     EventIngestSigningSecretRequestSchema,
     EventIngestSigningSecretResponseSchema,
     EventWebhookSigningSecretRequestSchema,
@@ -48,3 +49,5 @@ export type VerifyEventIngestSignatureRequest = z.infer<typeof VerifyEventIngest
 export type VerifyEventIngestSignatureResponse = z.infer<typeof VerifyEventIngestSignatureResponseSchema>;
 export type GithubInstallationTokenRequest = z.infer<typeof GithubInstallationTokenRequestSchema>;
 export type GithubInstallationTokenResponse = z.infer<typeof GithubInstallationTokenResponseSchema>;
+
+export type DeleteSecretResponse = z.infer<typeof DeleteSecretResponseSchema>;

package/src/skill.ts

@@ -73,18 +73,3 @@ export interface InjectedSkill {
      */
     match_score?: number;
 }
-
-/**
- * Result from generateTools activity with skills
- */
-export interface ToolsWithSkills {
-    /**
-     * Array of tool definitions
-     */
-    tools: unknown[]; // ToolDefinition[]
-
-    /**
-     * Skills injected based on context
-     */
-    injected_skills: InjectedSkill[];
-}

package/src/store/activity-catalog.ts

@@ -30,6 +30,9 @@ export interface ActivityTypeDefinition {
     enum?: string[] | number[] | undefined;
     // in case of unions
     union?: ActivityTypeDefinition[];
+    // in case of records
+    keyType?: ActivityTypeDefinition;
+    valueType?: ActivityTypeDefinition;
 }
 
 export interface ActivityPropertyDefinition {

package/src/store/agent-approval.ts

@@ -22,7 +22,3 @@ export function normalizeAgentToolApprovalMode(
     }
     return mode ?? 'full_control';
 }
-
-export function isAgentToolApprovalMode(value: unknown): value is AgentToolApprovalMode {
-    return typeof value === 'string' && (AgentToolApprovalModes as readonly string[]).includes(value);
-}

package/src/store/agent-run.ts

@@ -12,6 +12,7 @@
  * (workflowId, runId) are internal server concerns.
  */
 
+import type { ReasoningEffort } from '@llumiverse/common';
 import type { z } from 'zod';
 import type {
     AgentArtifactContentResponseSchema,
@@ -25,6 +26,9 @@ import type {
     AgentRunUpdatesQuerySchema,
     AgentRunUpdatesResponseSchema,
     CreateAgentRunPayloadSchema,
+    CreateProcessRunByIdPayloadSchema,
+    CreateProcessRunWithDefinitionPayloadSchema,
+    CreateRunPayloadSchema,
     IngestAgentEventsPayloadSchema,
     IngestAgentEventsResponseSchema,
     ListAgentRunsQuerySchema,
@@ -46,20 +50,15 @@ import type {
     RunTypeSchema,
 } from '../api-schemas/app-lifecycle.js';
 import type { ProcessRunConfigSchema, ProcessRunTypeSchema } from '../api-schemas/process.js';
-import type { BindRunWorkflowPayloadSchema } from '../api-schemas/workflow-runs.js';
-import type {
-    ConversationVisibility,
-    InitialToolCall,
-    InteractionExecutionConfiguration,
-    RunSource,
-} from '../interaction.js';
+import type { BindRunWorkflowPayloadSchema, RestartAgentRunPayloadSchema } from '../api-schemas/workflow-runs.js';
+import type { ConversationVisibility, InteractionExecutionConfiguration, RunSource } from '../interaction.js';
 import type { EventRef } from '../platform-event.js';
 import type { AgentToolApprovalMode } from './agent-approval.js';
 import type { ProcessDefinitionBody, ProcessState } from './process.js';
-import type { StopSignal, UserInputSignal } from './signals.js';
-import type { ContentObjectTypeRef } from './store.js';
+import type { ModelConfigChangedSignal, StopSignal, UserInputSignal } from './signals.js';
 import type {
     ConversationActivityState,
+    ConversationFileBatchRef,
     ConversationFileRef,
     ConversationFileRemovedRef,
     WorkflowRunEvent,
@@ -79,7 +78,7 @@ export type ProcessRunType = z.infer<typeof ProcessRunTypeSchema>;
 /**
  * Shared fields for all records stored in the agent_runs collection.
  */
-export interface RunBase {
+interface RunBase {
     /** The stable identifier used by all client code */
     id: string;
 
@@ -156,80 +155,6 @@ export interface RunBase {
     updated_at: string;
 }
 
-/**
- * Shared fields between CreateAgentRunPayload and AgentRun.
- *
- * @typeParam TData - The interaction's expected input data type.
- * @typeParam TProperties - The content type's property schema.
- */
-export interface AgentRunBase<TData = Record<string, unknown>, TProperties = Record<string, unknown>> {
-    /** Interaction ID or code (e.g. "sys:generic_question"). */
-    interaction: string;
-
-    /** Input parameters, typed per interaction */
-    data?: TData;
-
-    /** Execution configuration (environment, model, model_options, etc.) */
-    config?: InteractionExecutionConfiguration;
-
-    /** Whether the agent accepts user input */
-    interactive?: boolean;
-
-    /** How side-effecting tool actions are approved for interactive runs. */
-    tool_approval_mode?: AgentToolApprovalMode;
-
-    /** Tools configured for this run (+/- syntax supported) */
-    tool_names?: string[];
-
-    /** Builtin system skills activated before the first model turn. */
-    initial_skills?: string[];
-
-    /** Ordered, bounded hydration/read calls executed before the first model turn. */
-    initial_tool_calls?: InitialToolCall[];
-
-    /** Hard denylist of tool names: never exposed to the model, refused at execution time. */
-    excluded_tools?: string[];
-
-    /** Scoped collection (if any) */
-    collection_id?: string;
-
-    /**
-     * Denylist of MCP tool-collection ids deactivated for this run.
-     * `undefined`/empty means all installed/connected MCP collections are active (back-compat,
-     * and new servers stay active by default). Listed collections are excluded even if connected.
-     */
-    disabled_mcp_collections?: string[];
-
-    /** Content type linked to this run — defines the schema for `properties` */
-    content_type?: ContentObjectTypeRef;
-
-    /** Conversation visibility */
-    visibility?: ConversationVisibility;
-
-    /** User-defined or system tags for categorization */
-    tags?: string[];
-
-    /** Categories for organizing runs (e.g. "support", "analysis", "generation") */
-    categories?: string[];
-
-    /** Business metadata — typed by the linked content_type schema */
-    properties?: TProperties;
-
-    /** How the run was started */
-    source?: RunSource;
-
-    /** Schedule ID — set when this run was triggered by a Temporal schedule */
-    schedule_id?: string;
-
-    /** How the run was created */
-    source_type?: AgentRunType;
-
-    /**
-     * @deprecated Use source_type for creation source and run_type for runtime mode.
-     */
-    type?: AgentRunType;
-}
-
 type AgentRunWire = z.infer<typeof AgentRunSchema>;
 
 /**
@@ -255,8 +180,6 @@ export interface ProcessRun extends RunBase {
     process_state: ProcessState;
     config?: ProcessRunConfig;
 }
-
-export type AnyAgentRun = AgentRun | ProcessRun;
 export type AutonomousRunResponse<TData = Record<string, unknown>, TProperties = Record<string, unknown>> = AgentRun<
     TData,
     TProperties
@@ -280,7 +203,7 @@ export type CreateAgentRunPayload<TData = Record<string, unknown>, TProperties =
     properties?: TProperties;
 };
 
-export interface ProcessRunInputPayload<TData = Record<string, unknown>, TSource = RunSource> {
+interface ProcessRunInputPayload<TData = Record<string, unknown>, TSource = RunSource> {
     process_id?: string;
     /** Optional published process version to pin. Defaults to the latest/head revision. */
     process_version?: number;
@@ -299,7 +222,7 @@ export interface CreateProcessRunPayload<TData = Record<string, unknown>, TSourc
     run_type: ProcessRunType;
 }
 
-export interface RecordRunWorkflowPayload {
+interface RecordRunWorkflowPayload {
     /** Temporal workflow id. */
     workflow_id: string;
     /** First Temporal run id for this workflow. Required when the workflow has already started. */
@@ -312,7 +235,18 @@ export interface RecordRunWorkflowPayload {
  */
 export interface RecordAgentRunPayload<TData = Record<string, unknown>> extends RecordRunWorkflowPayload {
     run_kind?: 'agent';
+    /**
+     * Process run that owns this agent, when a process agent node recorded it. The run's
+     * conversation stays on the parent under {@link workstream_id} — see the note on RunBase.
+     */
+    parent_run_id?: string;
+    /** Workstream this run occupies inside its parent run (the process node id). */
+    workstream_id?: string;
     interaction: string;
+    title?: string;
+    topic?: string;
+    generate_topic?: boolean;
+    generate_lessons?: boolean;
     first_workflow_run_id: string;
     schedule_id?: string;
     visibility?: ConversationVisibility;
@@ -363,6 +297,10 @@ export interface UpdateAgentRunStatusPayload {
     disabled_mcp_collections?: string[];
     /** Tool approval mode persisted for interactive agent runs. */
     tool_approval_mode?: AgentToolApprovalMode;
+    /** Model selected for subsequent conversation turns. */
+    model?: string;
+    /** Reasoning effort selected for subsequent turns; null clears the explicit override. */
+    effort?: ReasoningEffort | null;
     /** Archive state fields (set by the archive workflow) */
     archive_state?: AgentRunArchiveState;
     archived_at?: string;
@@ -377,8 +315,10 @@ export interface UpdateAgentRunStatusPayload {
 export type SignalAgentPayload =
     | UserInputSignal
     | StopSignal
+    | ModelConfigChangedSignal
     | ConversationFileRef
     | ConversationFileRemovedRef
+    | ConversationFileBatchRef
     | Record<string, unknown>;
 
 export type SignalAgentResponse = z.infer<typeof SignalAgentResponseSchema>;
@@ -391,8 +331,6 @@ export type StreamAgentRunQuery = z.infer<typeof StreamAgentRunQuerySchema>;
 
 export type AgentRunDetailsQuery = z.infer<typeof AgentRunDetailsQuerySchema>;
 
-export type AgentArtifactVisibility = 'user' | 'internal' | 'all';
-
 export type AgentRunArtifactsQuery = z.infer<typeof AgentRunArtifactsQuerySchema>;
 
 export type AgentRunArtifactUploadHeaders = z.infer<typeof AgentRunArtifactUploadHeadersSchema>;
@@ -424,7 +362,7 @@ export type IngestAgentEventsResponse = z.infer<typeof IngestAgentEventsResponse
 /**
  * History event payload emitted by the agent details SSE stream.
  */
-export interface AgentRunDetailsHistoryStreamEvent {
+interface AgentRunDetailsHistoryStreamEvent {
     runId?: string;
     event: WorkflowRunEvent;
 }
@@ -432,12 +370,12 @@ export interface AgentRunDetailsHistoryStreamEvent {
 /**
  * Control payload emitted by the agent details SSE stream.
  */
-export type AgentRunDetailsControlStreamEvent = { type: 'continueAsNew'; newRunId: string } | { type: 'done' };
+type AgentRunDetailsControlStreamEvent = { type: 'continueAsNew'; newRunId: string } | { type: 'done' };
 
 /**
  * Error payload emitted by the agent details SSE stream.
  */
-export interface AgentRunDetailsErrorStreamEvent {
+interface AgentRunDetailsErrorStreamEvent {
     type: 'error';
     message: string;
 }
@@ -496,3 +434,11 @@ export interface AgentRunInternals {
     created_at: string;
     updated_at: string;
 }
+
+export type CreateProcessRunByIdPayload = z.infer<typeof CreateProcessRunByIdPayloadSchema>;
+
+export type CreateProcessRunWithDefinitionPayload = z.infer<typeof CreateProcessRunWithDefinitionPayloadSchema>;
+
+export type CreateRunPayload = z.infer<typeof CreateRunPayloadSchema>;
+
+export type RestartAgentRunPayload = z.infer<typeof RestartAgentRunPayloadSchema>;