@vertesia/appgen-docs 1.5.0-dev.20260807.073259Z → 1.5.0-dev.20260901.005903Z

package/lib/docs/vertesia-client.d.ts

@@ -180,6 +180,7 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
     get objects(): import("./index.js").ObjectsApi;
     get files(): import("./index.js").FilesApi;
     get processes(): import("./index.js").ProcessApi;
+    get processTestRuns(): import("./index.js").ProcessTestRunApi;
     get tasks(): import("./index.js").TaskApi;
     /**
      * Alias for store.types
@@ -234,14 +235,12 @@ export declare function decodeEndpoints(endpoints: string | Record<string, strin
 // @vertesia/client: AppsApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { AppApiKeyCollectionParams, AppBuildProgress, AppDeleteSummary, AppDevelopmentTaskDetails, AppDevelopmentTaskList, AppInspectionResult, AppInstallation, AppInstallationKind, AppInstallationListEntry, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData, AppPackage, AppPackageScope, AppRepoBranch, AppRepoCommits, AppRepoDocumentCommit, AppRepoRefs, AppRepoTree, AppScaffoldProgress, AppToolCollection, AppVersionListQuery, AppVersionRecord, CountResult, CreateAppRepoBranchRequest, DeleteAppVersionResponse, McpApiKeyStatus, ProjectRef, PromoteAppVersionResponse, RequireAtLeastOne, StartAppBuildRequest, StartAppBuildResponse, StartAppScaffoldRequest, StartAppScaffoldResponse, UpsertAppVersionRequest, ValidateUrlResponse } from '@vertesia/common';
-export interface OrphanedAppInstallation extends Omit<AppInstallation, 'manifest'> {
-    manifest: null;
-}
+import type { AgentRunResponse, AppApiKeyCollectionParams, AppBuildProgress, AppDeleteSummary, AppDevelopmentTaskDetails, AppDevelopmentTaskList, AppInspectionResult, AppInstallation, AppInstallationKind, AppInstallationListEntry, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData, AppPackage, AppPackageScope, AppRepoBranch, AppRepoCommits, AppRepoDocumentCommit, AppRepoRefs, AppRepoTree, AppScaffoldProgress, AppsQuery, AppToolCollection, AppVersionListQuery, AppVersionRecord, CountResult, CreateAppRepoBranchRequest, DeleteAppVersionResponse, McpApiKeyStatus, ProjectRef, PromoteAppVersionResponse, RequireAtLeastOne, StartAppBuildRequest, StartAppBuildResponse, StartAppDevelopmentTaskRequest, StartAppScaffoldRequest, StartAppScaffoldResponse, UpdateAppPayload, UpsertAppVersionRequest, ValidateUrlResponse } from '@vertesia/common';
+export type { OrphanedAppInstallation } from '@vertesia/common';
 export default class AppsApi extends ApiTopic {
     constructor(parent: ClientBase);
     create(manifest: AppManifestData): Promise<AppManifest>;
-    update(id: string, manifest: AppManifestData): Promise<AppManifest>;
+    update(id: string, manifest: UpdateAppPayload): Promise<AppManifest>;
     /**
      * Preview what the cascade delete would remove. Calls DELETE without confirm,
      * which the server treats as a dry-run and returns counts + paths.
@@ -334,8 +333,10 @@ export default class AppsApi extends ApiTopic {
     getRepoRefs(appIdOrName: string): Promise<AppRepoRefs>;
     /** List mutable development tasks represented by `agent/*` repository branches. */
     listDevelopmentTasks(appIdOrName: string): Promise<AppDevelopmentTaskList>;
-    /** Get a development task and its latest parent Studio Assistant run, when started. */
+    /** Get a development task and its latest App Builder parent run, when started. */
     getDevelopmentTask(appIdOrName: string, taskId: string): Promise<AppDevelopmentTaskDetails>;
+    /** Start the policy-controlled App Builder parent on an existing development-task branch. */
+    startDevelopmentTask(appIdOrName: string, taskId: string, payload: StartAppDevelopmentTaskRequest): Promise<AgentRunResponse>;
     /** Create a repository branch from an existing branch, tag, or commit. */
     createRepoBranch(appIdOrName: string, payload: CreateAppRepoBranchRequest): Promise<AppRepoBranch>;
     /**
@@ -355,10 +356,11 @@ export default class AppsApi extends ApiTopic {
      */
     getSystemToolsPackage(scope?: string): Promise<AppPackage>;
     /**
-     * @param ids - ids to filter by
+     * @param query - pass `{ scope: 'project' }` to list only the apps installed in, or built in,
+     * the current project. Defaults to every app visible to the account, including the public catalog.
      * @returns the app manifests but without the agent.tool property which can be big.
      */
-    list(): Promise<AppManifest[]>;
+    list(query?: AppsQuery): Promise<AppManifest[]>;
     /**
      * Install the app with the given id in the current project.
      * @param appId - the id of the app to install
@@ -746,36 +748,14 @@ export default class SkillsApi extends ApiTopic {
 // -----------------------------------------------------------------------------
 import type { ExecutionResponse } from '@llumiverse/common';
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { ComputeRunFacetPayload, ExecutionRun, ExecutionRunDocRef, ExecutionRunRef, FindPayload, PopulatedExecutionRun, RunClonePayload, RunCreatePayload, RunListingFilters, RunListingQueryOptions, RunSearchPayload, ToolResultsPayload, UserMessagePayload } from '@vertesia/common';
-import { type EnhancedExecutionRun } from './InteractionOutput.js';
+import type { ComputeRunFacetPayload, ComputeRunFacetsResponse, ExecutionRunDocRef, ExecutionRunRef, FindPayload, FindRunResult, PopulatedExecutionRun, RunClonePayload, RunCreatePayload, RunListingFilters, RunListingQueryOptions, RunSearchPayload, ToolResultsPayload, UserMessagePayload } from '@vertesia/common';
+import { type EnhancedExecutionRun, type EnhancedInteractionExecutionResult } from './InteractionOutput.js';
 export interface FilterOption {
     id: string;
     name: string;
     count: number;
 }
-export interface ComputeRunFacetsResponse {
-    environments?: {
-        _id: string;
-        count: number;
-    }[];
-    interactions?: {
-        _id: string;
-        count: number;
-    }[];
-    models?: {
-        _id: string;
-        count: number;
-    }[];
-    tags?: {
-        _id: string;
-        count: number;
-    }[];
-    status?: {
-        _id: string;
-        count: number;
-    }[];
-    total?: number;
-}
+export type { ComputeRunFacetsResponse } from '@vertesia/common';
 export declare class RunsApi extends ApiTopic {
     constructor(parent: ClientBase);
     /**
@@ -785,7 +765,7 @@ export declare class RunsApi extends ApiTopic {
      * @returns InteractionResult[]
      **/
     list({ limit, offset, filters }: RunListingQueryOptions): Promise<ExecutionRunRef[]>;
-    find(payload: FindPayload): Promise<ExecutionRun[]>;
+    find(payload: FindPayload): Promise<FindRunResult[]>;
     /**
      * Get a run by id
      *
@@ -802,7 +782,7 @@ export declare class RunsApi extends ApiTopic {
     create<ResultT = unknown, ParamsT = unknown>(payload: RunCreatePayload, options?: {
         timeoutMs?: number | false | null;
         signal?: AbortSignal;
-    }): Promise<EnhancedExecutionRun<ResultT, ParamsT>>;
+    }): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>>;
     /**
      * Send tool results and continues the conversation
      * @param payload
@@ -824,7 +804,7 @@ export declare class RunsApi extends ApiTopic {
     /**
      * Get the list of all runs facets
      * @param payload query payload to filter facet search
-     * @returns ComputeRunFacetsResponse[]
+     * @returns Facet buckets and the total number of matching runs
      **/
     computeFacets(query: ComputeRunFacetPayload): Promise<ComputeRunFacetsResponse>;
     search(payload: RunSearchPayload): Promise<ExecutionRunRef[]>;
@@ -848,11 +828,11 @@ import { EmailApi } from './EmailApi.js';
 import { EmbeddingsApi } from './EmbeddingsApi.js';
 import { EventsApi } from './EventsApi.js';
 import { FilesApi } from './FilesApi.js';
-import { HiveMemoryApi } from './HiveMemoryApi.js';
 import { IndexingApi } from './IndexingApi.js';
 import { ObjectsApi } from './ObjectsApi.js';
 import { PendingAsksApi } from './PendingAsksApi.js';
 import { ProcessApi } from './ProcessApi.js';
+import { ProcessTestRunApi } from './ProcessTestRunApi.js';
 import { QueryApi } from './QueryApi.js';
 import { RenderingApi } from './RenderingApi.js';
 import { SchedulesApi } from './SchedulesApi.js';
@@ -887,6 +867,7 @@ export declare class ZenoClient extends AbstractFetchClient<ZenoClient> {
     workflows: WorkflowsApi;
     schedules: SchedulesApi;
     processes: ProcessApi;
+    processTestRuns: ProcessTestRunApi;
     tasks: TaskApi;
     files: FilesApi;
     collections: CollectionsApi;
@@ -899,7 +880,6 @@ export declare class ZenoClient extends AbstractFetchClient<ZenoClient> {
     data: DataApi;
     indexing: IndexingApi;
     query: QueryApi;
-    hiveMemory: HiveMemoryApi;
     rendering: RenderingApi;
     views: StoreViewsApi;
 }
@@ -908,15 +888,26 @@ export declare class ZenoClient extends AbstractFetchClient<ZenoClient> {
 // @vertesia/client: store/ObjectsApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic } from '@vertesia/api-fetch-client';
-import { type BulkObjectCreateOptions, type BulkObjectCreateResult, type BulkObjectDeleteResult, type BulkObjectUpdateOptions, type BulkObjectUpdateResult, type Collection, type ComplexSearchPayload, type ComputedFacetResponse, type ComputeObjectFacetPayload, type ContentObject, type ContentObjectExportArtifactFile, type ContentObjectExportResult, type ContentObjectExportStatusResponse, type ContentObjectItem, type ContentObjectProcessingPriority, type ContentObjectTextResponse, type ContentSource, type CreateContentObjectPayload, canGenerateRendition, type DeleteContentObjectExportResponse, type DeleteContentObjectResult, type Embedding, type ExportPropertiesPayload, type ExportPropertiesResponse, type FindPayload, type GetFileUrlPayload, type GetFileUrlResponse, type GetRenditionParams, type GetRenditionResponse, type GetUploadUrlPayload, type ListContentObjectExportsResponse, type ListWorkflowRunsResponse, type ObjectSearchPayload, type ObjectSearchResponse, type SetObjectEmbeddingsResponse, type StartContentObjectExportRequest, type StartContentObjectExportResponse, type SupportedEmbeddingTypes, type ZenoBulkContentObjectExportComposeRequest, type ZenoBulkContentObjectExportPlanRequest, type ZenoBulkContentObjectExportPlanResponse, type ZenoBulkContentObjectExportRequest, type ZenoBulkContentObjectExportShardRequest, type ZenoBulkContentObjectExportShardResult, type ZenoBulkContentObjectExportSplitShardRequest, type ZenoBulkContentObjectExportSplitShardResponse } from '@vertesia/common';
+import { type BulkObjectCreateOptions, type BulkObjectCreateResult, type BulkObjectDeleteResult, type BulkObjectUpdateOptions, type BulkObjectUpdateResult, type Collection, type ComplexSearchPayload, type ComputedFacetResponse, type ComputeObjectFacetPayload, type ContentObject, type ContentObjectExportArtifactFile, type ContentObjectExportResult, type ContentObjectExportStatusResponse, type ContentObjectItem, type ContentObjectProcessingPriority, type ContentObjectTextResponse, type ContentSource, type CreateContentObjectPayload, canGenerateRendition, type DeleteContentObjectExportResponse, type DeleteContentObjectResult, type Embedding, type ExportPropertiesPayload, type ExportPropertiesResponse, type FindPayload, type FullObjectSearchResponse, type GetFileUrlPayload, type GetFileUrlResponse, type GetRenditionParams, type GetRenditionResponse, type GetUploadUrlPayload, type ListContentObjectExportsResponse, type ListWorkflowRunsResponse, type ObjectSearchPayload, type ObjectSearchResponse, type ProjectedContentObjectApiResponse, type SetObjectEmbeddingsResponse, type StartContentObjectExportRequest, type StartContentObjectExportResponse, type SupportedEmbeddingTypes, type UpdateContentObjectPayload, type ZenoBulkContentObjectExportComposeRequest, type ZenoBulkContentObjectExportPlanRequest, type ZenoBulkContentObjectExportPlanResponse, type ZenoBulkContentObjectExportRequest, type ZenoBulkContentObjectExportShardRequest, type ZenoBulkContentObjectExportShardResult, type ZenoBulkContentObjectExportSplitShardRequest, type ZenoBulkContentObjectExportSplitShardResponse } from '@vertesia/common';
 export { getSupportedRenditionFormats, supportsVisualRendition } from '@vertesia/common';
 export { canGenerateRendition };
 import { StreamSource } from '../StreamSource.js';
 import { AnalyzeDocApi } from './AnalyzeDocApi.js';
 import type { ZenoClient } from './client.js';
+/**
+ * The two write payloads, each widened at `content` so callers can hand us a browser `File` or a
+ * `StreamSource` and let the method upload it before sending the wire shape.
+ *
+ * They are separate on purpose: `POST /objects` and `PUT /objects/:id` publish distinct components,
+ * so deriving the update signature from the create payload would silently drift the day the two
+ * schemas diverge.
+ */
 type ContentObjectWritePayload = Omit<CreateContentObjectPayload, 'content'> & {
     content?: ContentSource | File | StreamSource;
 };
+type ContentObjectUpdateWritePayload = Omit<UpdateContentObjectPayload, 'content'> & {
+    content?: ContentSource | File | StreamSource;
+};
 export declare class ObjectsApi extends ApiTopic {
     client: ZenoClient;
     constructor(parent: ZenoClient);
@@ -957,14 +948,28 @@ export declare class ObjectsApi extends ApiTopic {
     private zenoBulkPost;
     listFolders(_path?: string): void;
     /** Find object based on query */
-    find(payload: FindPayload): Promise<ContentObject[]>;
+    find(payload: FindPayload & {
+        select?: undefined;
+    }): Promise<ContentObject[]>;
+    find(payload: FindPayload & {
+        select: `+${string}`;
+    }): Promise<ContentObject[]>;
+    find(payload: FindPayload & {
+        select: string;
+    }): Promise<ProjectedContentObjectApiResponse[]>;
+    find(payload: FindPayload): Promise<ContentObject[] | ProjectedContentObjectApiResponse[]>;
     /** Count number of objects matching this query */
     count(payload: FindPayload): Promise<{
         count: number;
     }>;
     /** Search object — different from find because allow full text search */
+    search(payload: ComplexSearchPayload & {
+        select?: undefined;
+    }): Promise<FullObjectSearchResponse>;
     search(payload: ComplexSearchPayload): Promise<ObjectSearchResponse>;
-    retrieve(id: string, select?: string): Promise<ContentObject>;
+    retrieve(id: string): Promise<ContentObject>;
+    retrieve(id: string, select: `+${string}` | undefined): Promise<ContentObject>;
+    retrieve(id: string, select: string): Promise<ProjectedContentObjectApiResponse>;
     getObjectText(id: string): Promise<ContentObjectTextResponse>;
     upload(source: StreamSource | File): Promise<{
         source: string;
@@ -1001,7 +1006,7 @@ export declare class ObjectsApi extends ApiTopic {
      * @param options.suppressWorkflows Deprecated. Events are always emitted; this suppresses the Temporal-backed delivery targets (workflow, agent, and process) — webhook deliveries still fire.
      * @returns The updated object or newly created revision
      */
-    update(id: string, payload: Partial<ContentObjectWritePayload>, options?: {
+    update(id: string, payload: ContentObjectUpdateWritePayload, options?: {
         createRevision?: boolean;
         revisionLabel?: string;
         processing_priority?: ContentObjectProcessingPriority;
@@ -1058,7 +1063,7 @@ export declare class ObjectsApi extends ApiTopic {
 // @vertesia/client: store/CollectionsApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { Collection, ComplexCollectionSearchQuery, ComplexSearchPayload, ComputeCollectionFacetPayload, ComputedFacetResponse, ComputeObjectFacetPayload, ContentObjectItem, ContentObjectStatus, CreateCollectionPayload, DynamicCollection, ObjectSearchResponse } from '@vertesia/common';
+import type { Collection, ComplexCollectionSearchQuery, ComplexSearchPayload, ComputeCollectionFacetPayload, ComputedFacetResponse, ComputeObjectFacetPayload, ContentObjectItem, ContentObjectStatus, CreateCollectionPayload, DynamicCollection, FullObjectSearchResponse, ObjectSearchResponse, UpdateCollectionPayload } from '@vertesia/common';
 export declare class CollectionsApi extends ApiTopic {
     constructor(parent: ClientBase);
     /**
@@ -1080,7 +1085,7 @@ export declare class CollectionsApi extends ApiTopic {
      */
     retrieve(collectionId: string): Promise<Collection | DynamicCollection>;
     create(payload: CreateCollectionPayload): Promise<Collection>;
-    update(collectionId: string, payload: Partial<CreateCollectionPayload>): Promise<{
+    update(collectionId: string, payload: UpdateCollectionPayload): Promise<{
         id: string;
     }>;
     addMembers(collectionId: string, members: string[]): Promise<{
@@ -1093,6 +1098,9 @@ export declare class CollectionsApi extends ApiTopic {
         type?: string;
     }): Promise<ContentObjectItem[]>;
     computeFacets(collectionId: string, query: ComputeObjectFacetPayload): Promise<ComputedFacetResponse>;
+    searchMembers(collectionId: string, payload: ComplexSearchPayload & {
+        select?: undefined;
+    }): Promise<FullObjectSearchResponse>;
     searchMembers(collectionId: string, payload: ComplexSearchPayload): Promise<ObjectSearchResponse>;
     deleteMembers(collectionId: string, members: string[]): Promise<{
         id: string;
@@ -1145,6 +1153,8 @@ export declare class CollectionsApi extends ApiTopic {
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import { type ActiveWorkstreamsQueryResult, type AgentArtifactContentResponse, type AgentArtifactUrlResponse, type AgentEvent, type AgentMessage, type AgentRun, type AgentRunDetailsStreamEvent, type AgentRunInternals, type AgentRunResponse, type BindRunWorkflowPayload, type CreateAgentRunPayload, type CreateProcessRunPayload, type ErrorAnalyticsResponse, type FirstResponseBehaviorAnalyticsResponse, type IngestAgentEventsResponse, type LatencyAnalyticsResponse, type ListAgentRunsQuery, type ListAgentRunsResponse, type ListWorkflowRunsResponse, type PostAgentRunUpdatePayload, type PostAgentRunUpdateResponse, type ProcessRun, type ProcessState, type PromptSizeAnalyticsResponse, type RecordAgentRunPayload, type RecordProcessRunPayload, type RunsByAgentAnalyticsResponse, type SearchAgentRunsQuery, type SearchAgentRunsResponse, type SignalAgentPayload, type SignalAgentResponse, type TerminateAgentRunResponse, type TimeToFirstResponseAnalyticsResponse, type TokenUsageAnalyticsResponse, type ToolAnalyticsResponse, type ToolParameterAnalyticsResponse, type TopPrincipalsAnalyticsResponse, type UpdateAgentArtifactContentPayload, type UpdateAgentArtifactContentResponse, type UpdateAgentRunStatusPayload, type WorkflowAnalyticsFilterOptionsResponse, type WorkflowAnalyticsSummaryQuery, type WorkflowAnalyticsSummaryResponse, type WorkflowAnalyticsTimeSeriesQuery, type WorkflowRunWithDetails, type WorkflowToolParametersQuery } from '@vertesia/common';
 export interface AgentRunStreamMessagesOptions {
+    /** Resolve the stream when the root conversation becomes idle. Headless followers should opt in. */
+    closeOnIdle?: boolean;
     onHistoryLoaded?: (messages: AgentMessage[]) => void;
     onHistoryError?: (error: unknown) => void;
 }
@@ -1238,7 +1248,8 @@ export declare class AgentsApi extends ApiTopic {
     bindWorkflowRun(id: string, payload: BindRunWorkflowPayload): Promise<AgentRun | ProcessRun>;
     /**
      * Send a signal to a running agent.
-     * Signals: "UserInput", "Stop", "FileUploaded", "FileRemoved"
+     * Signals include "UserInput", "Stop", "ModelConfigChanged", "FileUploaded", "FileRemoved", and
+     * "FileBatchClosed".
      */
     sendSignal(id: string, signalName: string, payload?: SignalAgentPayload): Promise<SignalAgentResponse>;
     /**
@@ -1441,7 +1452,7 @@ export declare class TypesApi extends ApiTopic {
 // @vertesia/client: store/FilesApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { BucketReadAccessStatusResponse, BulkUploadUrlsPayload, BulkUploadUrlsResponse, DeleteFileResult, EnsureBucketReadAccessResponse, FileBucketResponse, FileListResponse, FileMetadataResponse, FileMetadataUpdateResult, GetFileUrlPayload, GetFileUrlResponse, GetUploadUrlPayload } from '@vertesia/common';
+import type { BucketCreateAccessStatusResponse, BucketReadAccessStatusResponse, BulkUploadUrlsPayload, BulkUploadUrlsResponse, DeleteFileResult, EnsureBucketCreateAccessResponse, EnsureBucketReadAccessResponse, FileBucketResponse, FileListResponse, FileMetadataResponse, FileMetadataUpdateResult, GetFileUrlPayload, GetFileUrlResponse, GetUploadUrlPayload } from '@vertesia/common';
 import { StreamSource } from '../StreamSource.js';
 export declare const MEMORIES_PREFIX = "memories";
 export declare const ARTIFACTS_PREFIX = "agents";
@@ -1482,6 +1493,8 @@ export declare class FilesApi extends ApiTopic {
     getOrCreateBucket(): Promise<FileBucketResponse>;
     ensureBucketReadAccess(principal: string): Promise<EnsureBucketReadAccessResponse>;
     getBucketReadAccessStatus(principal: string): Promise<BucketReadAccessStatusResponse>;
+    ensureBucketCreateAccess(principal: string): Promise<EnsureBucketCreateAccessResponse>;
+    getBucketCreateAccessStatus(principal: string): Promise<BucketCreateAccessStatusResponse>;
     list(prefix: string): Promise<FileListResponse>;
     getUploadUrl(payload: GetUploadUrlPayload): Promise<GetFileUrlResponse>;
     getDownloadUrl(file: string, name?: string, disposition?: 'inline' | 'attachment'): Promise<GetFileUrlResponse>;
@@ -1952,53 +1965,11 @@ export declare class DataApi extends ApiTopic {
 // @vertesia/client: store/QueryApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-/**
- * Query payload for agent data access
- */
-export interface QueryPayload {
-    /** SQL query (uses ES SQL API) */
-    sql?: string;
-    /** ES|QL query (Elastic's piped query language) */
-    esql?: string;
-    /** Raw DSL query for full control */
-    dsl?: {
-        query?: Record<string, unknown>;
-        aggs?: Record<string, unknown>;
-        size?: number;
-        from?: number;
-        sort?: Array<Record<string, unknown>>;
-    };
-    /** Output format */
-    format?: 'json' | 'csv' | 'table';
-}
-/**
- * Query result
- */
-export interface QueryResult {
-    /** Result type */
-    type: 'sql' | 'esql' | 'dsl';
-    /** Column definitions */
-    columns?: Array<{
-        name: string;
-        type: string;
-    }>;
-    /** Rows for SQL/ES|QL */
-    rows?: unknown[][];
-    /** Hits for DSL */
-    hits?: Array<{
-        id: string;
-        score: number;
-        source: unknown;
-    }>;
-    /** Total count */
-    total?: number;
-    /** Aggregations for DSL */
-    aggregations?: Record<string, unknown>;
-    /** Cursor for pagination (SQL) */
-    cursor?: string;
-    /** Query execution time in ms */
-    took?: number;
-}
+import type { ContentQueryPayload, ContentQueryResult } from '@vertesia/common';
+/** @deprecated Use ContentQueryPayload from @vertesia/common. */
+export type QueryPayload = ContentQueryPayload;
+/** @deprecated Use ContentQueryResult from @vertesia/common. */
+export type QueryResult = ContentQueryResult;
 /**
  * API for querying documents using SQL, ES|QL, or raw Elasticsearch DSL.
  * All queries are automatically filtered based on the authenticated user's permissions.
@@ -2036,34 +2007,30 @@ export declare class QueryApi extends ApiTopic {
      * });
      * ```
      */
-    execute(payload: QueryPayload): Promise<QueryResult>;
+    execute(payload: ContentQueryPayload): Promise<ContentQueryResult>;
     /**
      * Execute a SQL query
      */
-    sql(query: string): Promise<QueryResult>;
+    sql(query: string): Promise<ContentQueryResult>;
     /**
      * Execute an ES|QL query
      */
-    esql(query: string): Promise<QueryResult>;
+    esql(query: string): Promise<ContentQueryResult>;
     /**
      * Execute a DSL query
      */
-    dsl(query: QueryPayload['dsl']): Promise<QueryResult>;
+    dsl(query: ContentQueryPayload['dsl']): Promise<ContentQueryResult>;
 }
 
 // -----------------------------------------------------------------------------
 // @vertesia/client: store/ProcessApi.d.ts
 // -----------------------------------------------------------------------------
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { CreateProcessDefinitionPayload, ProcessDefinition, PublishProcessDefinitionPayload, RevertProcessDefinitionPayload, UpdateProcessDefinitionPayload } from '@vertesia/common';
-export interface ListProcessDefinitionsQuery {
-    status?: string;
-    process?: string;
-    limit?: number;
-    offset?: number;
-    /** Include every revision/version instead of only the latest head revision. */
+import type { CreateProcessDefinitionPayload, CreateProcessTestSuitePayload, ListProcessDefinitionsQuery as ListProcessDefinitionsWireQuery, ListProcessTestRunsQuery, ProcessDefinition, ProcessTestRun, ProcessTestSuite, PublishProcessDefinitionPayload, RevertProcessDefinitionPayload, StartProcessTestRunPayload, UpdateProcessDefinitionPayload, UpdateProcessTestSuitePayload } from '@vertesia/common';
+export type ListProcessDefinitionsQuery = ListProcessDefinitionsWireQuery & {
+    /** @deprecated Use the wire-compatible `all_versions` property. */
     allVersions?: boolean;
-}
+};
 export declare class ProcessApi extends ApiTopic {
     constructor(parent: ClientBase);
     list(query?: ListProcessDefinitionsQuery): Promise<ProcessDefinition[]>;
@@ -2077,17 +2044,28 @@ export declare class ProcessApi extends ApiTopic {
         id: string;
         count: number;
     }>;
+    listTestSuites(processId: string): Promise<ProcessTestSuite[]>;
+    createTestSuite(processId: string, payload: CreateProcessTestSuitePayload): Promise<ProcessTestSuite>;
+    updateTestSuite(processId: string, suiteId: string, payload: UpdateProcessTestSuitePayload): Promise<ProcessTestSuite>;
+    deleteTestSuite(processId: string, suiteId: string): Promise<{
+        id: string;
+        count: number;
+    }>;
+    startTestRun(processId: string, payload: StartProcessTestRunPayload): Promise<ProcessTestRun>;
+    listTestRuns(processId: string, query?: ListProcessTestRunsQuery): Promise<ProcessTestRun[]>;
+    retrieveTestRun(processId: string, runId: string): Promise<ProcessTestRun>;
+    cancelTestRun(processId: string, runId: string): Promise<ProcessTestRun>;
 }
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: store/store.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { ContentObjectTypeRefSchema } from '../api-schemas/app-lifecycle.js';
-import type { ComplexSearchPayloadSchema, ContentObjectApiResponseSchema, ContentObjectApiRevisionSchema, ContentObjectApiTypeRefSchema, ContentObjectExportArtifactFileSchema, ContentObjectExportArtifactSchema, ContentObjectExportProgressSchema, ContentObjectExportResultSchema, ContentObjectExportStatusResponseSchema, ContentObjectItemApiResponseSchema, ContentObjectTextResponseSchema, ContentObjectUserPermissionsSchema, ContentSourceSchema, CreateContentObjectHeadersSchema, CreateContentObjectPayloadSchema, CreateContentObjectQuerySchema, DeleteContentObjectExportResponseSchema, DeleteContentObjectResultSchema, EmbeddingSchema, ExportContentObjectsFilterSchema, ExportContentObjectsIncludeOptionsSchema, GenerationRunMetadataSchema, GetObjectRenditionQuerySchema, GetRenditionResponseSchema, InheritedPropertyMetadataSchema, ListContentObjectExportsResponseSchema, ObjectSearchResponseSchema, RevisionInfoSchema, SetObjectEmbeddingsResponseSchema, StartContentObjectExportRequestSchema, StartContentObjectExportResponseSchema, TranscriptSchema, TranscriptSegmentSchema, UpdateContentObjectHeadersSchema, UpdateContentObjectQuerySchema } from '../api-schemas/content.js';
+import type { ContentObjectTypeRefSchema, InCodeTypeRefSchema, StoredTypeRefSchema } from '../api-schemas/app-lifecycle.js';
+import type { ComplexSearchPayloadSchema, ContentObjectApiResponseSchema, ContentObjectApiRevisionSchema, ContentObjectApiTypeRefSchema, ContentObjectExportArtifactFileSchema, ContentObjectExportArtifactSchema, ContentObjectExportProgressSchema, ContentObjectExportResultSchema, ContentObjectExportStatusResponseSchema, ContentObjectItemApiResponseSchema, ContentObjectTextResponseSchema, ContentObjectUserPermissionsSchema, ContentSourceSchema, CreateContentObjectHeadersSchema, CreateContentObjectPayloadSchema, CreateContentObjectQuerySchema, DeleteContentObjectExportResponseSchema, DeleteContentObjectResultSchema, EmbeddingSchema, ExportContentObjectsFilterSchema, ExportContentObjectsIncludeOptionsSchema, GenerationRunMetadataSchema, GetObjectRenditionQuerySchema, GetRenditionResponseSchema, InheritedPropertyMetadataSchema, ListContentObjectExportsResponseSchema, ObjectSearchResponseSchema, ProjectedContentObjectApiResponseSchema, RevisionInfoSchema, SetObjectEmbeddingsResponseSchema, StartContentObjectExportRequestSchema, StartContentObjectExportResponseSchema, TranscriptSchema, TranscriptSegmentSchema, UpdateContentObjectHeadersSchema, UpdateContentObjectPayloadSchema, UpdateContentObjectQuerySchema } from '../api-schemas/content.js';
 import type { MarkdownRenditionFormatSchema } from '../api-schemas/document-processing.js';
-import type { CreateWorkflowRulePayloadSchema, WorkflowRuleItemSchema, WorkflowRuleSchema } from '../api-schemas/events.js';
-import type { BucketReadAccessStatusResponseSchema, BulkUploadUrlsPayloadSchema, BulkUploadUrlsResponseSchema, CopyFilePayloadSchema, CopyFileResponseSchema, DeleteFileResultSchema, EnsureBucketReadAccessPayloadSchema, EnsureBucketReadAccessResponseSchema, FileBucketResponseSchema, FileDeleteQuerySchema, FileListQuerySchema, FileListResponseSchema, FileMetadataQuerySchema, FileMetadataResponseSchema, FileMetadataUpdateResultSchema, GetFileUrlPayloadSchema, GetFileUrlResponseSchema, GetUploadUrlPayloadSchema, SetFileMetadataPayloadSchema } from '../api-schemas/files.js';
+import type { CreateWorkflowRulePayloadSchema, UpdateWorkflowRulePayloadSchema, WorkflowRuleItemSchema, WorkflowRuleSchema } from '../api-schemas/events.js';
+import type { BucketCreateAccessStatusResponseSchema, BucketReadAccessStatusResponseSchema, BulkUploadUrlsPayloadSchema, BulkUploadUrlsResponseSchema, CopyFilePayloadSchema, CopyFileResponseSchema, DeleteFileResultSchema, EnsureBucketCreateAccessPayloadSchema, EnsureBucketCreateAccessResponseSchema, EnsureBucketReadAccessPayloadSchema, EnsureBucketReadAccessResponseSchema, FileBucketResponseSchema, FileDeleteQuerySchema, FileListQuerySchema, FileListResponseSchema, FileMetadataQuerySchema, FileMetadataResponseSchema, FileMetadataUpdateResultSchema, GetFileUrlPayloadSchema, GetFileUrlResponseSchema, GetUploadUrlPayloadSchema, SetFileMetadataPayloadSchema } from '../api-schemas/files.js';
 import type { ColumnLayoutSchema, ContentObjectTypeCatalogEntrySchema, ContentObjectTypeCatalogQuerySchema, ContentObjectTypeItemSchema, ContentObjectTypeListQuerySchema, ContentObjectTypeSchema, ContentObjectTypeStatusSchema, ContentTypeEditingPolicySchema, ContentTypeExtractionGroundingPolicySchema, ContentTypeExtractionGroundingReviewPolicySchema, ContentTypeIntakePolicySchema, CreateContentObjectTypePayloadSchema, InCodeTypeDefinitionSchema, IntakePageRangesSchema, IntakePageScopeSchema, IntakeVisionDetailSchema, UpdateContentObjectTypePayloadSchema } from '../api-schemas/store.js';
 import type { JSONObject } from '../json.js';
 import type { SupportedEmbeddingTypes } from '../project.js';
@@ -2126,34 +2104,6 @@ export declare enum ContentObjectStatus {
 export type Embedding = z.infer<typeof EmbeddingSchema>;
 export type ExportContentObjectsIncludeOptions = z.infer<typeof ExportContentObjectsIncludeOptionsSchema>;
 export type ExportContentObjectsFilter = z.infer<typeof ExportContentObjectsFilterSchema>;
-/**
- * Exported object identity and context for a single content object row.
- */
-export interface ExportedContentObjectRecord {
-    id: string;
-    name: string;
-    location: string;
-    external_id?: string;
-    type?: {
-        ref_type?: 'stored' | 'incode' | 'untyped';
-        id?: string;
-        code?: string;
-        name?: string;
-    };
-    status?: ContentObjectStatus;
-    content?: {
-        source?: string;
-        type?: string;
-        name?: string;
-        etag?: string;
-    };
-    created_at: string;
-    updated_at: string;
-    revision?: RevisionInfo;
-    properties?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    embeddings?: Partial<Record<SupportedEmbeddingTypes, Embedding>>;
-}
 export type StartContentObjectExportRequest = z.infer<typeof StartContentObjectExportRequestSchema>;
 export type StartContentObjectExportResponse = z.infer<typeof StartContentObjectExportResponseSchema>;
 export interface ZenoBulkContentObjectExportRequest extends Omit<StartContentObjectExportRequest, 'compression'> {
@@ -2228,6 +2178,10 @@ export type ContentObjectApiTypeRef = z.infer<typeof ContentObjectApiTypeRefSche
 export type ContentObjectApiRevision = z.infer<typeof ContentObjectApiRevisionSchema>;
 export type ContentObjectItemApiResponse = z.infer<typeof ContentObjectItemApiResponseSchema>;
 export type ContentObjectApiResponse = z.infer<typeof ContentObjectApiResponseSchema>;
+export type ProjectedContentObjectApiResponse = z.infer<typeof ProjectedContentObjectApiResponseSchema>;
+export type FullObjectSearchResponse = Omit<ObjectSearchResponse, 'results'> & {
+    results: ContentObjectItemApiResponse[];
+};
 export interface ContentObject<T = JSONObject> extends ContentObjectItem<T> {
     text?: string;
     text_etag?: string;
@@ -2362,7 +2316,7 @@ export interface TypeDetectionMetadata {
     min_pages?: number;
     detected_at: string;
 }
-export interface TemporalMediaMetadata extends ContentMetadata {
+interface TemporalMediaMetadata extends ContentMetadata {
     duration?: number;
     transcript?: Transcript;
 }
@@ -2409,7 +2363,7 @@ export interface DocumentMetadata extends ContentMetadata {
     sections?: TextSection[];
 }
 /** Grounded-extraction summary stored on document metadata. Additional keys allowed. */
-export interface GroundedMetadata {
+interface GroundedMetadata {
     verdict?: string;
     confidence?: number;
     citation_count?: number;
@@ -2423,15 +2377,6 @@ export interface GroundedMetadata {
     [key: string]: unknown;
 }
 export type Transcript = z.infer<typeof TranscriptSchema>;
-export declare const TextExtractionStatus: {
-    readonly success: 'success';
-};
-export interface TranscriptMediaResult {
-    hasText: boolean;
-    status: typeof TextExtractionStatus.success;
-    message?: string;
-    gladiaTranscriptionId?: string;
-}
 export type TranscriptSegment = z.infer<typeof TranscriptSegmentSchema>;
 export type ContentSource = z.infer<typeof ContentSourceSchema>;
 export type RevisionInfo = z.infer<typeof RevisionInfoSchema>;
@@ -2502,14 +2447,7 @@ export type CreateContentObjectPayload<T = JSONObject> = Omit<CreateContentObjec
     /** Known metadata interfaces remain assignable; the runtime contract deliberately accepts any object keys. */
     metadata?: ContentObjectItem['metadata'];
 };
-type LegacyContentObjectTypeRef = Partial<ContentObjectTypeRef> & {
-    ref_type?: 'stored' | 'incode';
-    id?: string;
-    code?: string;
-    name?: string;
-};
 export declare function getContentTypeRefId(type: ContentObjectTypeRef): string;
-export declare function withContentObjectTypeRefDiscriminator(type: ContentObjectTypeRef | LegacyContentObjectTypeRef): ContentObjectTypeRef;
 export type ContentObjectTypeRef = z.infer<typeof ContentObjectTypeRefSchema>;
 export type ComplexSearchPayload = z.infer<typeof ComplexSearchPayloadSchema>;
 export type ColumnLayout = z.infer<typeof ColumnLayoutSchema>;
@@ -2525,18 +2463,6 @@ export type IntakePageScope = z.infer<typeof IntakePageScopeSchema>;
  * enforced at runtime.
  */
 export type IntakePageRanges = z.infer<typeof IntakePageRangesSchema>;
-/** Rendering settings behind a vision detail name (platform defaults, project-overridable
- * via `configuration.intake.vision_profiles`). */
-export interface IntakeVisionProfileSettings {
-    /** Render resolution in dots per inch. */
-    dpi: number;
-    /** Maximum height/width of the rendered page image in pixels. */
-    max_hw: number;
-    /** JPEG quality (0-100). */
-    quality: number;
-    /** grayscale renders gray always; auto keeps color when the plan asks for it. */
-    color_mode: 'grayscale' | 'auto';
-}
 export type ContentTypeExtractionGroundingReviewPolicy = z.infer<typeof ContentTypeExtractionGroundingReviewPolicySchema>;
 export type ContentTypeExtractionGroundingPolicy = z.infer<typeof ContentTypeExtractionGroundingPolicySchema>;
 export type ContentTypeIntakePolicy = z.infer<typeof ContentTypeIntakePolicySchema>;
@@ -2549,12 +2475,6 @@ export type ContentObjectTypeCatalogEntry = z.infer<typeof ContentObjectTypeCata
  * The itnerface to be used whend efining types in a plugin app.
  */
 export type InCodeTypeSpec = Omit<InCodeTypeDefinition, 'id'>;
-/**
- * Returns true if the type id represents an in-code type (system or app-contributed).
- * In-code types use colon-separated ids like "sys:Invoice" or "app:myapp:Article".
- * These types are read-only and cannot be edited through the UI.
- */
-export declare function isInCodeType(typeId: string): boolean;
 export type CreateContentObjectTypePayload = z.infer<typeof CreateContentObjectTypePayloadSchema>;
 export type UpdateContentObjectTypePayload = z.infer<typeof UpdateContentObjectTypePayloadSchema>;
 export declare enum WorkflowRuleInputType {
@@ -2586,7 +2506,7 @@ export interface GetRenditionParams {
 }
 export type GetRenditionResponse = z.infer<typeof GetRenditionResponseSchema>;
 export type ObjectSearchResponse = z.infer<typeof ObjectSearchResponseSchema>;
-export type RenditionFormat = ImageRenditionFormat | MarkdownRenditionFormat;
+type RenditionFormat = ImageRenditionFormat | MarkdownRenditionFormat;
 /**
  * Check if a specific rendition format can be generated from a content type.
  *
@@ -2600,37 +2520,15 @@ export type RenditionFormat = ImageRenditionFormat | MarkdownRenditionFormat;
  * canGenerateRendition('text/markdown', MarkdownRenditionFormat.pdf) // true
  */
 export declare function canGenerateRendition(contentType: string | undefined, format: RenditionFormat | string): boolean;
-/**
- * Get the list of rendition formats supported for a given content type.
- *
- * @param contentType - The MIME type of the source content
- * @returns Array of supported rendition formats, or empty array if none
- *
- * @example
- * getSupportedRenditionFormats('image/png') // [jpeg, png, webp]
- * getSupportedRenditionFormats('text/markdown') // [pdf, docx]
- * getSupportedRenditionFormats('text/html') // []
- */
-export declare function getSupportedRenditionFormats(contentType: string | undefined): RenditionFormat[];
-/**
- * Check if a content type supports visual (image) renditions.
- * This is useful for determining if a document can have thumbnails/previews.
- *
- * @param contentType - The MIME type of the source content
- * @returns true if the content type can generate JPEG renditions
- *
- * @example
- * supportsVisualRendition('image/png') // true
- * supportsVisualRendition('application/pdf') // true
- * supportsVisualRendition('text/markdown') // false
- */
-export declare function supportsVisualRendition(contentType: string | undefined): boolean;
 export type GetUploadUrlPayload = z.infer<typeof GetUploadUrlPayloadSchema>;
 export type GetFileUrlPayload = z.infer<typeof GetFileUrlPayloadSchema>;
 export type GetFileUrlResponse = z.infer<typeof GetFileUrlResponseSchema>;
 export type EnsureBucketReadAccessPayload = z.infer<typeof EnsureBucketReadAccessPayloadSchema>;
 export type EnsureBucketReadAccessResponse = z.infer<typeof EnsureBucketReadAccessResponseSchema>;
 export type BucketReadAccessStatusResponse = z.infer<typeof BucketReadAccessStatusResponseSchema>;
+export type EnsureBucketCreateAccessPayload = z.infer<typeof EnsureBucketCreateAccessPayloadSchema>;
+export type EnsureBucketCreateAccessResponse = z.infer<typeof EnsureBucketCreateAccessResponseSchema>;
+export type BucketCreateAccessStatusResponse = z.infer<typeof BucketCreateAccessStatusResponseSchema>;
 export type FileMetadataResponse = z.infer<typeof FileMetadataResponseSchema>;
 export type SetFileMetadataPayload = z.infer<typeof SetFileMetadataPayloadSchema>;
 export type FileMetadataUpdateResult = z.infer<typeof FileMetadataUpdateResultSchema>;
@@ -2650,6 +2548,72 @@ export declare enum ContentObjectProcessingPriority {
     normal = "normal",
     low = "low"
 }
+/**
+ * Exported object identity and context for a single content object row.
+ */
+export interface ExportedContentObjectRecord {
+    id: string;
+    name: string;
+    location: string;
+    external_id?: string;
+    type?: {
+        ref_type?: 'stored' | 'incode' | 'untyped';
+        id?: string;
+        code?: string;
+        name?: string;
+    };
+    status?: ContentObjectStatus;
+    content?: {
+        source?: string;
+        type?: string;
+        name?: string;
+        etag?: string;
+    };
+    created_at: string;
+    updated_at: string;
+    revision?: RevisionInfo;
+    properties?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    embeddings?: Partial<Record<SupportedEmbeddingTypes, Embedding>>;
+}
+/**
+ * Get the list of rendition formats supported for a given content type.
+ *
+ * @param contentType - The MIME type of the source content
+ * @returns Array of supported rendition formats, or empty array if none
+ *
+ * @example
+ * getSupportedRenditionFormats('image/png') // [jpeg, png, webp]
+ * getSupportedRenditionFormats('text/markdown') // [pdf, docx]
+ * getSupportedRenditionFormats('text/html') // []
+ */
+export declare function getSupportedRenditionFormats(contentType: string | undefined): RenditionFormat[];
+/**
+ * Check if a content type supports visual (image) renditions.
+ * This is useful for determining if a document can have thumbnails/previews.
+ *
+ * @param contentType - The MIME type of the source content
+ * @returns true if the content type can generate JPEG renditions
+ *
+ * @example
+ * supportsVisualRendition('image/png') // true
+ * supportsVisualRendition('application/pdf') // true
+ * supportsVisualRendition('text/markdown') // false
+ */
+export declare function supportsVisualRendition(contentType: string | undefined): boolean;
+export type InCodeTypeRef = z.infer<typeof InCodeTypeRefSchema>;
+export type StoredTypeRef = z.infer<typeof StoredTypeRefSchema>;
+type UpdateContentObjectPayloadWire = z.infer<typeof UpdateContentObjectPayloadSchema>;
+/**
+ * Mirrors {@link CreateContentObjectPayload}: `properties` and `metadata` are reopened over the wire
+ * type so the known metadata interfaces stay assignable and callers can name their property shape.
+ * The runtime contract accepts any object keys for both.
+ */
+export type UpdateContentObjectPayload<T = JSONObject> = Omit<UpdateContentObjectPayloadWire, 'properties' | 'metadata'> & {
+    properties?: T;
+    metadata?: ContentObjectItem['metadata'];
+};
+export type UpdateWorkflowRulePayload = z.infer<typeof UpdateWorkflowRulePayloadSchema>;
 export {};
 
 // -----------------------------------------------------------------------------
@@ -2668,18 +2632,18 @@ export {};
  * Client code only ever uses `AgentRun.id` — all Temporal workflow details
  * (workflowId, runId) are internal server concerns.
  */
+import type { ReasoningEffort } from '@llumiverse/common';
 import type { z } from 'zod';
-import type { AgentArtifactContentResponseSchema, AgentArtifactUrlResponseSchema, AgentRunArchiveStateSchema, AgentRunArtifactQuerySchema, AgentRunArtifactsQuerySchema, AgentRunArtifactUploadHeadersSchema, AgentRunDetailsQuerySchema, AgentRunSchema, AgentRunUpdatesQuerySchema, AgentRunUpdatesResponseSchema, CreateAgentRunPayloadSchema, IngestAgentEventsPayloadSchema, IngestAgentEventsResponseSchema, ListAgentRunsQuerySchema, PostAgentRunUpdatePayloadSchema, PostAgentRunUpdateResponseSchema, SearchAgentRunsQuerySchema, SearchAgentRunsResponseSchema, SignalAgentResponseSchema, StreamAgentRunQuerySchema, TerminateAgentRunResponseSchema, UpdateAgentArtifactContentPayloadSchema, UpdateAgentArtifactContentResponseSchema } from '../api-schemas/agent-runs.js';
+import type { AgentArtifactContentResponseSchema, AgentArtifactUrlResponseSchema, AgentRunArchiveStateSchema, AgentRunArtifactQuerySchema, AgentRunArtifactsQuerySchema, AgentRunArtifactUploadHeadersSchema, AgentRunDetailsQuerySchema, AgentRunSchema, AgentRunUpdatesQuerySchema, AgentRunUpdatesResponseSchema, CreateAgentRunPayloadSchema, CreateProcessRunByIdPayloadSchema, CreateProcessRunWithDefinitionPayloadSchema, CreateRunPayloadSchema, IngestAgentEventsPayloadSchema, IngestAgentEventsResponseSchema, ListAgentRunsQuerySchema, PostAgentRunUpdatePayloadSchema, PostAgentRunUpdateResponseSchema, SearchAgentRunsQuerySchema, SearchAgentRunsResponseSchema, SignalAgentResponseSchema, StreamAgentRunQuerySchema, TerminateAgentRunResponseSchema, UpdateAgentArtifactContentPayloadSchema, UpdateAgentArtifactContentResponseSchema } from '../api-schemas/agent-runs.js';
 import type { AgentRunSearchHitSchema, AgentRunStatusSchema, AgentRunTypeSchema, RunKindSchema, 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 { ConversationActivityState, ConversationFileRef, ConversationFileRemovedRef, WorkflowRunEvent } from './workflow.js';
+import type { ModelConfigChangedSignal, StopSignal, UserInputSignal } from './signals.js';
+import type { ConversationActivityState, ConversationFileBatchRef, ConversationFileRef, ConversationFileRemovedRef, WorkflowRunEvent } from './workflow.js';
 export type AgentRunStatus = z.infer<typeof AgentRunStatusSchema>;
 export type AgentRunArchiveState = z.infer<typeof AgentRunArchiveStateSchema>;
 export type AgentRunType = z.infer<typeof AgentRunTypeSchema>;
@@ -2689,7 +2653,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;
     /** Internal discriminator key */
@@ -2741,60 +2705,6 @@ export interface RunBase {
     /** Timestamp when the document was last updated */
     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>;
 /**
  * The wire contract is schema-derived; the two generic data bags remain caller-specializable.
@@ -2814,7 +2724,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>;
 export type SupervisedRunResponse = ProcessRun & {
     run_type: 'supervised';
@@ -2831,7 +2740,7 @@ export type CreateAgentRunPayload<TData = Record<string, unknown>, TProperties =
     data?: TData;
     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;
@@ -2847,7 +2756,7 @@ export interface ProcessRunInputPayload<TData = Record<string, unknown>, TSource
 export interface CreateProcessRunPayload<TData = Record<string, unknown>, TSource = RunSource> extends ProcessRunInputPayload<TData, TSource> {
     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. */
@@ -2859,7 +2768,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;
@@ -2901,6 +2821,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;
@@ -2909,13 +2833,12 @@ export interface UpdateAgentRunStatusPayload {
     sequence?: number;
     process_state?: ProcessState;
 }
-export type SignalAgentPayload = UserInputSignal | StopSignal | ConversationFileRef | ConversationFileRemovedRef | Record<string, unknown>;
+export type SignalAgentPayload = UserInputSignal | StopSignal | ModelConfigChangedSignal | ConversationFileRef | ConversationFileRemovedRef | ConversationFileBatchRef | Record<string, unknown>;
 export type SignalAgentResponse = z.infer<typeof SignalAgentResponseSchema>;
 export type AgentRunUpdatesResponse = z.infer<typeof AgentRunUpdatesResponseSchema>;
 export type AgentRunUpdatesQuery = z.infer<typeof AgentRunUpdatesQuerySchema>;
 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>;
 export type AgentRunArtifactQuery = z.infer<typeof AgentRunArtifactQuerySchema>;
@@ -2936,14 +2859,14 @@ 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;
 }
 /**
  * Control payload emitted by the agent details SSE stream.
  */
-export type AgentRunDetailsControlStreamEvent = {
+type AgentRunDetailsControlStreamEvent = {
     type: 'continueAsNew';
     newRunId: string;
 } | {
@@ -2952,7 +2875,7 @@ export type AgentRunDetailsControlStreamEvent = {
 /**
  * Error payload emitted by the agent details SSE stream.
  */
-export interface AgentRunDetailsErrorStreamEvent {
+interface AgentRunDetailsErrorStreamEvent {
     type: 'error';
     message: string;
 }
@@ -3010,40 +2933,17 @@ 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>;
 export {};
 
-// -----------------------------------------------------------------------------
-// @vertesia/common: store/object-types.d.ts
-// -----------------------------------------------------------------------------
-import type { JSONSchemaType } from 'ajv';
-export interface RenditionProperties {
-    mime_type: string;
-    source_etag?: string;
-    height?: number;
-    width?: number;
-    multipart?: boolean;
-    total_parts?: number;
-}
-export declare const RenditionSchema: JSONSchemaType<RenditionProperties>;
-export interface DocumentPartProperties {
-    source_etag?: string;
-    part_number: number;
-    title?: string;
-    source_line_start?: number;
-    source_line_end?: number;
-    type?: 'text' | 'image' | 'table' | 'chart' | 'diagram' | 'code' | 'other';
-    page_number?: number;
-    description?: string;
-    height?: number;
-    width?: number;
-}
-export declare const DocumentPartSchema: JSONSchemaType<DocumentPartProperties>;
-
 // -----------------------------------------------------------------------------
 // @vertesia/common: store/collections.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { CollectionChildrenUpdatePayloadSchema, CollectionChildrenUpdateResultSchema, CollectionMembersQuerySchema, CollectionMembersUpdatePayloadSchema, CollectionMembersUpdateResultSchema, CollectionPropagationResponseSchema, CollectionSchema, CollectionSecuritySettingsResponseSchema, CreateCollectionPayloadSchema } from '../api-schemas/content.js';
+import type { CollectionChildrenUpdatePayloadSchema, CollectionChildrenUpdateResultSchema, CollectionMembersQuerySchema, CollectionMembersUpdatePayloadSchema, CollectionMembersUpdateResultSchema, CollectionPropagationResponseSchema, CollectionSchema, CollectionSecuritySettingsResponseSchema, CreateCollectionPayloadSchema, UpdateCollectionPayloadSchema } from '../api-schemas/content.js';
 import type { BaseObject } from './common.js';
 import type { ColumnLayout, ContentObjectTypeRef } from './store.js';
 export declare enum CollectionStatus {
@@ -3081,11 +2981,6 @@ export interface CollectionItem extends BaseObject {
     allowed_types?: string[];
 }
 export type Collection = z.infer<typeof CollectionSchema>;
-export interface StaticCollection extends Collection {
-    dynamic: false;
-    members: string[];
-    query: never;
-}
 export interface DynamicCollection extends Collection {
     dynamic: true;
 }
@@ -3106,16 +3001,18 @@ export type CollectionChildrenUpdateResult = z.infer<typeof CollectionChildrenUp
 export type CollectionMembersUpdatePayload = z.infer<typeof CollectionMembersUpdatePayloadSchema>;
 export type CollectionChildrenUpdatePayload = z.infer<typeof CollectionChildrenUpdatePayloadSchema>;
 export type CollectionMembersQuery = z.infer<typeof CollectionMembersQuerySchema>;
+export type UpdateCollectionPayload = z.infer<typeof UpdateCollectionPayloadSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: store/process.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { BranchDefinitionSchema, BranchJoinPolicySchema, HumanTaskDefinitionSchema, JsonLogicRuleSchema, ListProcessDefinitionsQuerySchema, NodeHistoryEntrySchema, ParallelCollectDefinitionSchema, ParallelCollectFieldSchema, ParallelCollectModeSchema, ParallelFailurePolicySchema, ProcessContextDefinitionSchema, ProcessDefinitionFormatVersionSchema, ProcessDefinitionMetadataSchema, ProcessDefinitionRevisionInfoSchema, ProcessDefinitionStatusSchema, ProcessHistoryRefSchema, ProcessNodeReturnsDefinitionSchema, ProcessNodeRunTypeSchema, ProcessNodeTypeSchema, ProcessResourcesDefinitionSchema, ProcessScriptInlineSourceSchema, ProcessScriptLanguageSchema, ProcessScriptResourceSchema, ProcessScriptSourceSchema, ProcessStateSchema, PublishProcessDefinitionPayloadSchema, RevertProcessDefinitionPayloadSchema, TransitionDefinitionSchema, TransitionTriggerSchema } from '../api-schemas/process.js';
+import type { AdvanceProcessPayloadSchema, AnswerProcessTaskPayloadSchema, BranchDefinitionSchema, BranchJoinPolicySchema, CreateProcessTestSuitePayloadSchema, HumanTaskDefinitionSchema, JsonLogicRuleSchema, ListProcessDefinitionsQuerySchema, ListProcessTestRunsQuerySchema, NodeHistoryEntrySchema, ParallelCollectDefinitionSchema, ParallelCollectFieldSchema, ParallelCollectModeSchema, ParallelFailurePolicySchema, ProcessContextDefinitionSchema, ProcessContextResponseSchema, ProcessDefinitionFormatVersionSchema, ProcessDefinitionMetadataSchema, ProcessDefinitionRevisionInfoSchema, ProcessDefinitionStatusSchema, ProcessHistoryRefSchema, ProcessHistoryResponseSchema, ProcessNodeReturnsDefinitionSchema, ProcessNodeRunTypeSchema, ProcessNodeTypeSchema, ProcessResourcesDefinitionSchema, ProcessScriptInlineSourceSchema, ProcessScriptLanguageSchema, ProcessScriptResourceSchema, ProcessScriptSourceSchema, ProcessStateSchema, ProcessTestActorDecisionSchema, ProcessTestAssertionResultSchema, ProcessTestAssertionsSchema, ProcessTestChildTraceSchema, ProcessTestCoverageSchema, ProcessTestFixtureErrorSchema, ProcessTestFixtureResponseSchema, ProcessTestFixtureResultSchema, ProcessTestHumanActionSchema, ProcessTestInlineSubjectSchema, ProcessTestNodeFixtureSchema, ProcessTestResolvedSubjectSchema, ProcessTestRunSchema, ProcessTestRunStatusSchema, ProcessTestScenarioResultSchema, ProcessTestScenarioSchema, ProcessTestStoredSubjectSchema, ProcessTestSubjectSchema, ProcessTestSuiteSchema, ProcessTestTargetByIdSchema, ProcessTestTargetWithDefinitionSchema, ProcessTestVirtualActorSchema, PublishProcessDefinitionPayloadSchema, RetryProcessNodePayloadSchema, RevertProcessDefinitionPayloadSchema, StartProcessTestRunPayloadSchema, SubmitProcessTestRunPayloadSchema, TransitionDefinitionSchema, TransitionTriggerSchema, UpdateProcessTestScenarioPayloadSchema, UpdateProcessTestSuitePayloadSchema } from '../api-schemas/process.js';
 import type { JSONSchema } from '../json-schema.js';
 export type JsonLogicRule = z.infer<typeof JsonLogicRuleSchema>;
 export type ProcessDefinitionStatus = z.infer<typeof ProcessDefinitionStatusSchema>;
 export type ListProcessDefinitionsQuery = z.infer<typeof ListProcessDefinitionsQuerySchema>;
+export type ListProcessTestRunsQuery = z.infer<typeof ListProcessTestRunsQuerySchema>;
 export declare const PROCESS_DEFINITION_FORMAT_VERSION: 1;
 export type ProcessDefinitionFormatVersion = z.infer<typeof ProcessDefinitionFormatVersionSchema>;
 export type ProcessNodeType = z.infer<typeof ProcessNodeTypeSchema>;
@@ -3227,6 +3124,7 @@ export interface InCodeProcessDefinition {
 export type ProcessDefinitionRevisionInfo = z.infer<typeof ProcessDefinitionRevisionInfoSchema>;
 export interface ProcessDefinition {
     id: string;
+    edit_revision: number;
     account: string;
     project: string;
     name: string;
@@ -3266,6 +3164,7 @@ export interface CreateProcessDefinitionPayload {
     definition: ProcessDefinitionBody;
 }
 export interface UpdateProcessDefinitionPayload {
+    expected_edit_revision?: number;
     name?: string;
     description?: string;
     /**
@@ -3281,6 +3180,45 @@ export interface UpdateProcessDefinitionPayload {
 }
 export type PublishProcessDefinitionPayload = z.infer<typeof PublishProcessDefinitionPayloadSchema>;
 export type RevertProcessDefinitionPayload = z.infer<typeof RevertProcessDefinitionPayloadSchema>;
+export type AdvanceProcessPayload = z.infer<typeof AdvanceProcessPayloadSchema>;
+export type AnswerProcessTaskPayload = z.infer<typeof AnswerProcessTaskPayloadSchema>;
+export type RetryProcessNodePayload = z.infer<typeof RetryProcessNodePayloadSchema>;
+export type ProcessContextResponse = z.infer<typeof ProcessContextResponseSchema>;
+export type ProcessHistoryResponse = z.infer<typeof ProcessHistoryResponseSchema>;
+export type ProcessTestRunStatus = z.infer<typeof ProcessTestRunStatusSchema>;
+export type ProcessTestVirtualActor = z.infer<typeof ProcessTestVirtualActorSchema>;
+export type ProcessTestFixtureResult = z.infer<typeof ProcessTestFixtureResultSchema>;
+export type ProcessTestFixtureError = z.infer<typeof ProcessTestFixtureErrorSchema>;
+export type ProcessTestFixtureResponse = z.infer<typeof ProcessTestFixtureResponseSchema>;
+export type ProcessTestNodeFixture = z.infer<typeof ProcessTestNodeFixtureSchema>;
+export type ProcessTestHumanAction = z.infer<typeof ProcessTestHumanActionSchema>;
+export type ProcessTestAssertions = z.infer<typeof ProcessTestAssertionsSchema>;
+export type ProcessTestScenario = z.infer<typeof ProcessTestScenarioSchema>;
+export type ProcessTestSuite = z.infer<typeof ProcessTestSuiteSchema>;
+export type CreateProcessTestSuitePayload = z.infer<typeof CreateProcessTestSuitePayloadSchema>;
+export type UpdateProcessTestSuitePayload = z.infer<typeof UpdateProcessTestSuitePayloadSchema>;
+export type StartProcessTestRunPayload = z.infer<typeof StartProcessTestRunPayloadSchema>;
+export type ProcessTestAssertionResult = z.infer<typeof ProcessTestAssertionResultSchema>;
+export type ProcessTestActorDecision = z.infer<typeof ProcessTestActorDecisionSchema>;
+export type ProcessTestCoverage = z.infer<typeof ProcessTestCoverageSchema>;
+export type ProcessTestChildTrace = z.infer<typeof ProcessTestChildTraceSchema>;
+export type ProcessTestScenarioResult = z.infer<typeof ProcessTestScenarioResultSchema>;
+export type ProcessTestRun = Omit<z.infer<typeof ProcessTestRunSchema>, 'process_definition_snapshot'> & {
+    process_definition_snapshot: ProcessDefinitionBody;
+};
+export type ProcessTestStoredSubject = z.infer<typeof ProcessTestStoredSubjectSchema>;
+export type ProcessTestResolvedSubject = z.infer<typeof ProcessTestResolvedSubjectSchema>;
+export type ProcessTestInlineSubject = z.infer<typeof ProcessTestInlineSubjectSchema>;
+export type ProcessTestSubject = z.infer<typeof ProcessTestSubjectSchema>;
+export type ProcessTestTargetById = z.infer<typeof ProcessTestTargetByIdSchema>;
+export type ProcessTestTargetWithDefinition = Omit<z.infer<typeof ProcessTestTargetWithDefinitionSchema>, 'definition'> & {
+    definition: ProcessDefinitionBody;
+};
+export type ProcessTestTarget = ProcessTestTargetById | ProcessTestTargetWithDefinition;
+export type SubmitProcessTestRunPayload = Omit<z.infer<typeof SubmitProcessTestRunPayloadSchema>, 'process'> & {
+    process: ProcessTestTarget;
+};
+export type UpdateProcessTestScenarioPayload = z.infer<typeof UpdateProcessTestScenarioPayloadSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: store/workflow.d.ts
@@ -3454,7 +3392,6 @@ export type SignalTask = z.infer<typeof SignalTaskSchema>;
 export type TimerTask = z.infer<typeof TimerTaskSchema>;
 export type WorkflowTask = z.infer<typeof WorkflowTaskSchema>;
 export type WorkflowHistory = z.infer<typeof WorkflowHistorySchema>;
-export type HistoryFormat = 'events' | 'tasks' | 'agent';
 export type AgentTask = z.infer<typeof AgentTaskSchema>;
 export type WorkflowRun = z.infer<typeof WorkflowRunSchema>;
 export type PendingActivity = z.infer<typeof PendingActivitySchema>;
@@ -3470,22 +3407,6 @@ export type WorkflowUpdatePublishResponse = z.infer<typeof WorkflowUpdatePublish
 export type WorkflowActionResponse = z.infer<typeof WorkflowActionResponseSchema>;
 export type WorkflowQueryResult = z.infer<typeof WorkflowQueryResultSchema>;
 export type WorkflowInteractionVars = z.infer<typeof WorkflowInteractionVarsSchema>;
-export interface MultiDocumentsInteractionParams extends Omit<WorkflowExecutionPayload, 'config'> {
-    config: {
-        interactionName: string;
-        action: DocumentActionConfig;
-        data: Record<string, unknown>;
-    };
-}
-export interface DocumentActionConfig {
-    contentTypeName?: string;
-    setAsProperties: boolean;
-    setAsText: string;
-    setNameFrom: string;
-    upsert: boolean;
-    documentId?: string;
-    parentId?: string;
-}
 export declare const WorkflowExecutionStatusValues: {
     readonly UNKNOWN: 0;
     readonly RUNNING: 1;
@@ -3538,7 +3459,7 @@ export type AgentMessageDetails = z.infer<typeof AgentMessageDetailsSchema>;
 /**
  * Details for THOUGHT messages representing tool calls (event_class: 'activity').
  */
-export interface ToolCallDetails {
+interface ToolCallDetails {
     event_class: 'activity';
     tool: string;
     tool_event?: 'started' | 'progress' | 'completed' | 'failed';
@@ -3554,54 +3475,11 @@ export interface ToolCallDetails {
     outputFiles?: string[];
     [key: string]: unknown;
 }
-/**
- * Details for UPDATE messages signaling document creation or update.
- */
-export interface DocumentEventDetails {
-    event_class: 'document_created' | 'document_updated';
-    document_id: string;
-    title?: string;
-    [key: string]: unknown;
-}
-/**
- * Details for REQUEST_INPUT messages with UX configuration.
- */
-export interface RequestInputDetails {
-    ux?: {
-        options?: Array<{
-            id: string;
-            label: string;
-        }>;
-        variant?: string;
-        multiSelect?: boolean;
-    };
-    [key: string]: unknown;
-}
-/**
- * Details for PLAN messages containing the plan structure.
- */
-export interface PlanMessageDetails {
-    plan: PlanTask[];
-    comment?: string;
-    [key: string]: unknown;
-}
 export declare function isToolCallMessage(msg: AgentMessage): msg is AgentMessage & {
     details: ToolCallDetails;
 };
 /** Extract the normalized resource references carried on a message's details, if any. */
 export declare function getResourcesFromMessage(msg: AgentMessage): AgentResourceReference[];
-export declare function isDocumentEventMessage(msg: AgentMessage): msg is AgentMessage & {
-    details: DocumentEventDetails;
-};
-export declare function isFileProcessingMessage(msg: AgentMessage): msg is AgentMessage & {
-    details: FileProcessingDetails;
-};
-export declare function isPlanMessage(msg: AgentMessage): msg is AgentMessage & {
-    details: PlanMessageDetails;
-};
-export declare function isRequestInputMessage(msg: AgentMessage): msg is AgentMessage & {
-    details: RequestInputDetails;
-};
 /**
  * Details for STREAMING_CHUNK messages used for real-time LLM response streaming
  * @deprecated Use CompactMessage with f field for streaming chunks
@@ -3626,7 +3504,7 @@ export type CompactMessage = z.infer<typeof CompactMessageSchema>;
  * Legacy message format for backward compatibility.
  * @deprecated Use CompactMessage instead
  */
-export type LegacyAgentMessage = AgentMessage;
+type LegacyAgentMessage = AgentMessage;
 /**
  * Check if a message is in compact format
  */
@@ -3715,12 +3593,6 @@ export declare enum FileProcessingStatus {
     ERROR = "error"
 }
 export type ConversationFile = z.infer<typeof ConversationFileSchema>;
-/**
- * A file is deliverable when it is ready and has not yet been delivered to the agent as part
- * of a user message. Deliverable files get attached to the next message; consumed ones stay
- * reachable to tools via artifact_path/md_path but are not re-attached.
- */
-export declare function isDeliverableFile(file: ConversationFile): boolean;
 /**
  * Details for file processing SYSTEM messages.
  * Used when type is AgentMessageType.SYSTEM with system_type: 'file_processing'.
@@ -3754,6 +3626,32 @@ export interface ConversationFileRef {
     /** Artifact path without prefix (e.g., "files/document.pdf") */
     artifact_path: string;
 }
+/**
+ * Manifest closing a staged-upload batch (the FileBatchClosed signal). Sent by clients that
+ * stage files before the run exists (the agent start screen) after every upload attempt has
+ * finished: those clients cannot wait for text extraction themselves, so the workflow owns the
+ * "[Files Ready]" user turn. The manifest is the batch's authoritative membership — the
+ * workflow delivers once, and only once, every listed file has settled, so a fast first file
+ * can never trigger delivery while later files are still uploading.
+ */
+export interface ConversationFileBatchRef {
+    /** Client-generated batch id. Stable across retries so redelivering the manifest is a no-op. */
+    batch_id: string;
+    /**
+     * Ids (ConversationFileRef.id) of the files successfully uploaded and signaled for this
+     * batch. Files whose upload failed client-side are listed in `failed_uploads` instead;
+     * empty when every upload failed.
+     */
+    file_ids: string[];
+    /**
+     * Files the client could not upload or signal. Without them a 1-of-2 batch would look
+     * complete to the workflow, so the agent would never learn a file is missing.
+     */
+    failed_uploads?: {
+        name: string;
+        error?: string;
+    }[];
+}
 /**
  * Reference to a file removed from the conversation attachment set.
  */
@@ -3761,41 +3659,29 @@ export interface ConversationFileRemovedRef {
     /** Client-generated unique ID */
     id: string;
 }
-/**
- * Get the Redis pub/sub channel name for workflow messages.
- * Used by both publishers (workflow activities, studio-server) and subscribers (zeno-server, clients).
- * @param workflowRunId - The Temporal workflow run ID (NOT the interaction execution run ID)
- */
-export declare function getWorkflowChannel(workflowRunId: string): string;
-/**
- * Get the Redis list key for storing workflow message history.
- * Messages are stored here for retrieval by reconnecting clients.
- * @param workflowRunId - The Temporal workflow run ID (NOT the interaction execution run ID)
- */
-export declare function getWorkflowUpdatesKey(workflowRunId: string): string;
 export type PlanTask = z.infer<typeof PlanTaskSchema>;
 export type Plan = z.infer<typeof PlanSchema>;
 export declare const LOW_PRIORITY_TASK_QUEUE = "low_priority";
 /**
  * WebSocket message types for bidirectional communication
  */
-export interface WebSocketSignalMessage {
+interface WebSocketSignalMessage {
     type: 'signal';
     signalName: string;
     data: unknown;
     requestId?: string | number;
 }
-export interface WebSocketPingMessage {
+interface WebSocketPingMessage {
     type: 'ping';
 }
-export interface WebSocketPongMessage {
+interface WebSocketPongMessage {
     type: 'pong';
 }
-export interface WebSocketAckMessage {
+interface WebSocketAckMessage {
     type: 'ack';
     requestId: string | number;
 }
-export interface WebSocketErrorMessage {
+interface WebSocketErrorMessage {
     type: 'error';
     requestId?: string | number;
     error: string;
@@ -3897,7 +3783,7 @@ export interface AgentIntakeWorkflowResult {
     generatedEmbeddings?: SupportedEmbeddingTypes[];
 }
 /** Progress reported by a child workstream */
-export interface WorkstreamProgressInfo {
+interface WorkstreamProgressInfo {
     launch_id: string;
     workstream_id: string;
     phase: 'planning' | 'executing_tool' | 'synthesizing' | 'blocked' | 'done';
@@ -3951,13 +3837,14 @@ export interface ActiveWorkstreamsQueryResult {
     /** True when the workflow could not answer this optional query. */
     unavailable?: boolean;
 }
+export {};
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: apps.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { AgentToolApprovalClassSchema, AgentToolDefinitionSchema, AppApiKeyCollectionParamsSchema, AppBuildProgressSchema, AppBuildProgressStatusSchema, AppBuildTriggerSchema, AppDeleteSummarySchema, AppDevelopmentTaskDetailsSchema, AppDevelopmentTaskListSchema, AppDevelopmentTaskSchema, AppInspectionCapabilityReportSchema, AppInspectionIssueSchema, AppInspectionResultSchema, AppInstallationKindSchema, AppInstallationOAuthBindingSchema, AppInstallationPayloadSchema, AppInstallationProjectsQuerySchema, AppInstallationProviderBindingSchema, AppInstallationsQuerySchema, AppOAuthCollectionParamsSchema, AppOAuthProviderParamsSchema, AppRepoBranchSchema, AppRepoCommitSchema, AppRepoCommitsSchema, AppRepoDocumentCommitSchema, AppRepoRefSchema, AppRepoRefsSchema, AppRepoTreeEntrySchema, AppRepoTreeSchema, AppScaffoldModuleSchema, AppScaffoldProgressSchema, AppScaffoldProgressStatusSchema, AppToolCollectionSchema, AppVersionGitRefTypeSchema, AppVersionGitSourceSchema, AppVersionKindSchema, AppVersionRecordSchema, AppVersionStateSchema, AppVersionStorageSchema, AppVersionTargetSchema, AppVersionUrlsSchema, DeleteAppVersionResponseSchema, McpApiKeyCredentialSchema, OAuthClientCredentialsSchema, StartAppBuildRequestSchema, StartAppBuildResponseSchema, StartAppScaffoldRequestSchema, StartAppScaffoldResponseSchema, UpdateAppInstallationToolAllowlistPayloadSchema, UpsertAppVersionRequestSchema, ValidateUrlRequestSchema, ValidateUrlResponseSchema } from './api-schemas/app-lifecycle.js';
-import type { AppEventHookDeliverySchema, AppEventHookPayloadSchema, AppEventSubscriptionDefinitionSchema, AppInstallationListEntrySchema, AppInstallationSchema, AppInstallationWithManifestSchema, AppManifestDataSchema, AppManifestSchema, AppPackageEventHookSchema, AppPackageHooksSchema, AppPackageSchema, AppWidgetInfoSchema, CompositeAppCardOverridesSchema, CompositeAppConfigPayloadSchema, CompositeAppConfigSchema, CompositeAppEntrySchema, CompositeAppHeaderItemKindSchema, CompositeAppHeaderItemSchema, CompositeAppHeaderItemTargetSchema, CompositeAppHeaderOverridesSchema, CompositeAppHomePluginSchema, CompositeAppLogoOverridesSchema, CompositeAppMenuSectionSchema, CompositeAppMessageOverridesSchema, CompositeAppMessageStyleSchema, CompositeAppNavItemPermissionsSchema, CompositeAppSidebarOverridesSchema, CompositeAppSwitchersOverridesSchema, CompositeAppThemeOverridesSchema, CompositeAppUserMenuOverridesSchema, PromoteAppVersionResponseSchema } from './api-schemas/app-runtime.js';
+import type { AgentToolApprovalClassSchema, AgentToolDefinitionSchema, AppApiKeyCollectionParamsSchema, AppBuildProgressSchema, AppBuildProgressStatusSchema, AppBuildTriggerSchema, AppDeleteSummarySchema, AppDevelopmentTaskDetailsSchema, AppDevelopmentTaskListSchema, AppDevelopmentTaskSchema, AppInspectionCapabilityReportSchema, AppInspectionIssueSchema, AppInspectionResultSchema, AppInstallationKindSchema, AppInstallationOAuthBindingSchema, AppInstallationPayloadSchema, AppInstallationProjectsQuerySchema, AppInstallationProviderBindingSchema, AppInstallationsQuerySchema, AppListScopeSchema, AppOAuthCollectionParamsSchema, AppOAuthProviderParamsSchema, AppRepoBranchSchema, AppRepoCommitSchema, AppRepoCommitsSchema, AppRepoDocumentCommitSchema, AppRepoRefSchema, AppRepoRefsSchema, AppRepoTreeEntrySchema, AppRepoTreeSchema, AppScaffoldModuleSchema, AppScaffoldProgressSchema, AppScaffoldProgressStatusSchema, AppsQuerySchema, AppToolCollectionSchema, AppVersionGitRefTypeSchema, AppVersionGitSourceSchema, AppVersionKindSchema, AppVersionRecordSchema, AppVersionStateSchema, AppVersionStorageSchema, AppVersionTargetSchema, AppVersionUrlsSchema, DeleteAppVersionResponseSchema, McpApiKeyCredentialSchema, OAuthClientCredentialsSchema, StartAppBuildRequestSchema, StartAppBuildResponseSchema, StartAppDevelopmentTaskRequestSchema, StartAppScaffoldRequestSchema, StartAppScaffoldResponseSchema, UpdateAppInstallationToolAllowlistPayloadSchema, UpsertAppVersionRequestSchema, ValidateUrlRequestSchema, ValidateUrlResponseSchema } from './api-schemas/app-lifecycle.js';
+import type { AppEventHookDeliverySchema, AppEventHookPayloadSchema, AppEventSubscriptionDefinitionSchema, AppInstallationListEntrySchema, AppInstallationSchema, AppInstallationWithManifestSchema, AppManifestDataSchema, AppManifestSchema, AppPackageEventHookSchema, AppPackageHooksSchema, AppPackageSchema, AppWidgetInfoSchema, CompositeAppCardOverridesSchema, CompositeAppConfigPayloadSchema, CompositeAppConfigSchema, CompositeAppEntrySchema, CompositeAppHeaderItemKindSchema, CompositeAppHeaderItemSchema, CompositeAppHeaderItemTargetSchema, CompositeAppHeaderOverridesSchema, CompositeAppHomePluginSchema, CompositeAppLogoOverridesSchema, CompositeAppMenuSectionSchema, CompositeAppMessageOverridesSchema, CompositeAppMessageStyleSchema, CompositeAppNavItemPermissionsSchema, CompositeAppSidebarOverridesSchema, CompositeAppSwitchersOverridesSchema, CompositeAppThemeOverridesSchema, CompositeAppUserMenuOverridesSchema, PromoteAppVersionResponseSchema, UpdateAppPayloadSchema } from './api-schemas/app-runtime.js';
 import type { AppAccessControlSchema, AppAvailableInSchema, AppCapabilitiesSchema, AppGitSourceConfigSchema, AppManifestSourceSchema, AppSourceConfigSchema, AppUIConfigSchema, MCPApiKeyConfigSchema, MCPOAuthConfigSchema, MCPToolAnnotationsSchema, MCPToolCollectionObjectSchema, McpApiKeyStatusSchema, McpOAuthConnectResponseSchema, McpOAuthDisconnectResponseSchema, McpOAuthTokenRequestSchema, McpOAuthTokenResponseSchema, OAuthAuthorizeResponseSchema, OAuthAuthStatusSchema, OAuthMetadataResponseSchema, SetMcpApiKeyRequestSchema, ToolCollectionAuthTypeSchema, ToolCollectionObjectSchema, VertesiaSDKToolCollectionObjectSchema } from './api-schemas/apps.js';
 import type { RemoteActivityDefinitionSchema } from './api-schemas/integrations.js';
 import type { ProjectToolInfoSchema, RenderingTemplateDefinitionRefSchema, RenderingTemplateDefinitionSchema } from './api-schemas/project.js';
@@ -3992,29 +3879,15 @@ export interface AppUINavItem {
 export type AppUIConfig = z.infer<typeof AppUIConfigSchema>;
 export type AppInstallationProjectsQuery = z.infer<typeof AppInstallationProjectsQuerySchema>;
 export type AppInstallationsQuery = z.infer<typeof AppInstallationsQuerySchema>;
+export type AppListScope = z.infer<typeof AppListScopeSchema>;
+export type AppsQuery = z.infer<typeof AppsQuerySchema>;
 export type ToolCollectionAuthType = z.infer<typeof ToolCollectionAuthTypeSchema>;
-/**
- * Tool collection type
- */
-export type ToolCollectionType = 'mcp' | 'vertesia_sdk';
 export type MCPOAuthConfig = z.infer<typeof MCPOAuthConfigSchema>;
 /** Install-time provisioning blueprint for an `auth: 'api_key'` MCP collection. Never holds the key. */
 export type MCPApiKeyConfig = z.infer<typeof MCPApiKeyConfigSchema>;
 export type MCPToolCollectionObject = z.infer<typeof MCPToolCollectionObjectSchema>;
 export type VertesiaSDKToolCollectionObject = z.infer<typeof VertesiaSDKToolCollectionObjectSchema>;
 export type ToolCollectionObject = z.infer<typeof ToolCollectionObjectSchema>;
-/**
- * Backward-compatible TypeScript alias. Public API payloads should reference
- * ToolCollectionObject directly so generated clients do not create a wrapper
- * model around the discriminated union.
- */
-export type ToolCollection = ToolCollectionObject;
-export declare const MCP_COLLECTION_ID_PATTERN: RegExp;
-export declare const MCP_COLLECTION_NAMESPACE_PATTERN: RegExp;
-export declare function isValidMCPCollectionId(id: string): boolean;
-export declare function isValidMCPCollectionNamespace(namespace: string): boolean;
-export declare function deriveMCPCollectionId(input: string): string;
-export declare function getDefaultOAuthAppNameForCollectionId(collectionId: string): string;
 /**
  * Normalizes a tool collection to the object format.
  * Applies optional `{{var}}` substitution to the URL so manifests can reference
@@ -4060,77 +3933,6 @@ export type AppCapabilities = z.infer<typeof AppCapabilitiesSchema>;
  * Resolution-time only; never persisted. Set by the generated app template via client.withAppVersion.
  */
 export declare const APP_VERSION_HEADER = "x-vertesia-app-version";
-/**
- * The platform-artifact types an app build can be required to create. A finer-grained
- * counterpart to {@link AppCapabilities}: a single `interactions` capability may comprise
- * several `interaction` artifacts plus `agent`, `activity`, and `tool` artifacts that
- * {@link AppCapabilities} folds together. Used by the App Solution Architect manifest and
- * the publish-time capability gate.
- */
-export declare const APP_ARTIFACT_TYPES: readonly ['interaction', 'agent', 'type', 'process', 'view', 'template', 'dashboard', 'activity', 'tool', 'hook', 'subscription'];
-export type AppArtifactType = (typeof APP_ARTIFACT_TYPES)[number];
-/**
- * A single platform artifact the App Solution Architect requires the build to create.
- * `id` is the app-owned in-code id the implementation must register and reference
- * (e.g. `app:<name>:main:extract-item` for interactions/agents, `app:<name>:<type>` for
- * types, `app:<name>:<process>` for processes, and `app:<name>:<local-id>` for hooks/subscriptions).
- */
-/**
- * Build progress for one artifact, maintained by the developer agent as a living checklist:
- *  - `pending` — defined by the architect, not yet built.
- *  - `built`   — registered in the package, not yet successfully exercised.
- *  - `done`    — built AND successfully exercised against real data.
- * This is the agent's self-reported claim for tracking/handoff; the capability gate verifies
- * the truth independently via package registration + run/data telemetry and does not trust it.
- */
-export type AppArtifactStatus = 'pending' | 'built' | 'done';
-export declare const APP_ARTIFACT_STATUSES: readonly AppArtifactStatus[];
-export interface AppPlannedArtifact {
-    /** App-owned in-code id the build must register and reference. */
-    id: string;
-    type: AppArtifactType;
-    /** Short human label. */
-    name?: string;
-    /** Why this artifact exists / what it does — carried into the build checklist. */
-    purpose?: string;
-    /**
-     * When false, the artifact is planned but optional: the capability gate warns rather
-     * than blocks if it is missing or never exercised. Defaults to required (true).
-     */
-    required?: boolean;
-    /** Build progress, updated by the developer agent. Defaults to `pending`. */
-    status?: AppArtifactStatus;
-}
-/**
- * Structured result the App Solution Architect emits alongside its prose artifacts — the
- * machine-readable contract for the build. The implementation MUST register every required artifact
- * before building a candidate, then successfully exercise it after that candidate is installed and
- * version-pinned. Persisted into the app repo as {@link APP_CAPABILITY_MANIFEST_PATH} so it survives
- * across runs and the package-registration gate can verify it deterministically. If the builder finds the plan
- * wrong or insufficient, the orchestrator relaunches the architect to revise the manifest;
- * the gate always checks against the latest committed copy.
- */
-export interface AppCapabilityManifest {
-    /** Artifact-storage ref to the prose architecture spec (e.g. the architecture `.md`). */
-    spec_artifact: string;
-    /** Platform artifacts the build must create. */
-    artifacts: AppPlannedArtifact[];
-    /**
-     * Monotonic revision, starting at 1, bumped each time the architect evolves the manifest for
-     * the SAME app on a later iteration (read the committed manifest, preserve untouched artifacts,
-     * add/modify/remove, then bump). Lets downstream agents tell which contract they are building to.
-     */
-    revision?: number;
-    /**
-     * Newest-first change notes, one entry per revision (what was added/modified/removed and why).
-     * How manifest changes are communicated to downstream agents across iterations.
-     */
-    changelog?: string[];
-    /** Optional free-form notes the architect wants the builder to honor. */
-    notes?: string;
-}
-/** Repo-relative path the capability manifest is committed to, read by version-build gates. */
-export declare const APP_CAPABILITY_MANIFEST_PATH = "docs/app-capability-manifest.json";
 export type AppAvailableIn = z.infer<typeof AppAvailableInSchema>;
 export type AppVersionKind = z.infer<typeof AppVersionKindSchema>;
 export type AppVersionState = z.infer<typeof AppVersionStateSchema>;
@@ -4152,41 +3954,12 @@ export interface AppVersionListQuery {
 export type PromoteAppVersionResponse = z.infer<typeof PromoteAppVersionResponseSchema>;
 export type StartAppBuildRequest = z.infer<typeof StartAppBuildRequestSchema>;
 export type StartAppBuildResponse = z.infer<typeof StartAppBuildResponseSchema>;
-export interface AppBuildWorkflowInput extends StartAppBuildRequest {
-    app_id: string;
-    app_record_id?: string;
-    /** Rebuild this persisted version record at its original commit and target. */
-    rebuild_version_record_id?: string;
-    app_title?: string;
-    app_description?: string;
-    source_git_url?: string;
-}
-export interface AppBuildWorkflowResult {
-    app_id: string;
-    version_id: string;
-    kind: Extract<AppVersionKind, 'version'>;
-    state: AppVersionState;
-    source_commit: string;
-    source_git?: AppVersionGitSource;
-    urls?: AppVersionUrls;
-    file_count?: number;
-}
 export type AppBuildProgressStatus = z.infer<typeof AppBuildProgressStatusSchema>;
 export type AppBuildProgress = z.infer<typeof AppBuildProgressSchema>;
 export type AppScaffoldModule = z.infer<typeof AppScaffoldModuleSchema>;
 export type StartAppScaffoldRequest = z.infer<typeof StartAppScaffoldRequestSchema>;
 export type StartAppScaffoldResponse = z.infer<typeof StartAppScaffoldResponseSchema>;
-export interface AppScaffoldWorkflowInput extends StartAppScaffoldRequest {
-}
-export interface AppScaffoldWorkflowResult {
-    app_id: string;
-    app_record_id?: string;
-    installation_id?: string;
-    git_url?: string;
-    source_git?: AppVersionGitSource;
-    files?: number;
-    initial_version_build?: StartAppBuildResponse;
-}
+export type StartAppDevelopmentTaskRequest = z.infer<typeof StartAppDevelopmentTaskRequestSchema>;
 export type AppScaffoldProgressStatus = z.infer<typeof AppScaffoldProgressStatusSchema>;
 export type AppScaffoldProgress = z.infer<typeof AppScaffoldProgressSchema>;
 /**
@@ -4202,21 +3975,8 @@ export type AppScaffoldProgress = z.infer<typeof AppScaffoldProgressSchema>;
  * Declared on the manifest as the app's default. May be overridden per-installation.
  */
 export type AppAccessControl = z.infer<typeof AppAccessControlSchema>;
-/**
- * Resolve the effective access_control policy for an installed app:
- * installation override wins, then manifest default, then `'all'`.
- *
- * Shared by the STS (JWT generation), the studio-server (validation), and the UI (badge display)
- * so the resolution rule lives in exactly one place. Named `effectiveAppAccessControl` (not just
- * `effectiveAccessControl`) because exports from `@vertesia/common` are flattened — the broader
- * name would risk colliding with other access-control families added later.
- */
-export declare function effectiveAppAccessControl(installation: {
-    access_control?: AppAccessControl;
-} | null | undefined, manifest: {
-    access_control?: AppAccessControl;
-} | null | undefined): AppAccessControl;
 export type AppManifestData = z.infer<typeof AppManifestDataSchema>;
+export type UpdateAppPayload = z.infer<typeof UpdateAppPayloadSchema>;
 export type AppGitSourceConfig = z.infer<typeof AppGitSourceConfigSchema>;
 export type AppSourceConfig = z.infer<typeof AppSourceConfigSchema>;
 /**
@@ -4243,11 +4003,6 @@ export interface Endpoints {
 export type AppRepoTreeEntry = z.infer<typeof AppRepoTreeEntrySchema>;
 /** A non-recursive listing of an app git repo directory at a given ref. */
 export type AppRepoTree = z.infer<typeof AppRepoTreeSchema>;
-/** Browser-side limits mirrored by the app Git service document endpoint. */
-export declare const APP_REPO_DOCUMENT_UPLOAD_MAX_FILE_BYTES: number;
-export declare const APP_REPO_DOCUMENT_UPLOAD_MAX_TOTAL_BYTES: number;
-export declare const APP_REPO_DOCUMENT_UPLOAD_MAX_FILES = 20;
-export declare const APP_REPO_DOCUMENT_UPLOAD_PREFIX = "docs/";
 /** Result of committing one or more uploaded documents to an app repository. */
 export type AppRepoDocumentCommit = z.infer<typeof AppRepoDocumentCommitSchema>;
 /** One commit that inserted or changed a file in an app git repository. */
@@ -4319,10 +4074,11 @@ export type AppInstallationOAuthBinding = z.infer<typeof AppInstallationOAuthBin
 export type AppInstallationProviderBinding = z.infer<typeof AppInstallationProviderBindingSchema>;
 export type AppInstallation = z.infer<typeof AppInstallationSchema>;
 export type AppInstallationWithManifest = z.infer<typeof AppInstallationWithManifestSchema>;
-export type AppInstallationListEntry = z.infer<typeof AppInstallationListEntrySchema>;
+/** An installation whose app manifest could not be resolved (the app was deleted or is unpublished). */
 export interface OrphanedAppInstallation extends Omit<AppInstallation, 'manifest'> {
     manifest: null;
 }
+export type AppInstallationListEntry = z.infer<typeof AppInstallationListEntrySchema>;
 export type OAuthClientCredentials = z.infer<typeof OAuthClientCredentialsSchema>;
 export type AppOAuthCollectionParams = z.infer<typeof AppOAuthCollectionParamsSchema>;
 /** One installer-supplied MCP API key. */
@@ -4350,10 +4106,6 @@ export type OAuthAuthStatus = z.infer<typeof OAuthAuthStatusSchema>;
  * Response from OAuth authorization endpoint
  */
 export type OAuthAuthorizeResponse = z.infer<typeof OAuthAuthorizeResponseSchema>;
-export interface McpOAuthCollectionRef {
-    app_install_id: string;
-    collection_id: string;
-}
 /**
  * Payload for storing the static bearer token of an `auth: 'api_key'` MCP collection.
  * The key is write-only — it is never echoed back by any endpoint.
@@ -4473,8 +4225,6 @@ export type CompositeAppHomePlugin = z.infer<typeof CompositeAppHomePluginSchema
 export type CompositeAppHeaderItemKind = z.infer<typeof CompositeAppHeaderItemKindSchema>;
 /** Where a header link opens. */
 export type CompositeAppHeaderItemTarget = z.infer<typeof CompositeAppHeaderItemTargetSchema>;
-/** Stable identifiers for the built-in header items. */
-export declare const COMPOSITE_APP_HEADER_BUILTIN_IDS: readonly ['app_portal', 'docs', 'help', 'user_menu'];
 /**
  * A single button in the CompositeApp header bar.
  *
@@ -4509,14 +4259,13 @@ export type AppDeleteSummary = z.infer<typeof AppDeleteSummarySchema>;
 // -----------------------------------------------------------------------------
 // @vertesia/common: interaction.d.ts
 // -----------------------------------------------------------------------------
-import type { CompletionResult, ExecutionTokenUsage, JSONObject, JSONSchema, Modalities, ModelOptions, StatelessExecutionOptions, ToolUse } from '@llumiverse/common';
+import type { CompletionResult, ExecutionTokenUsage, JSONSchema, Modalities, PromptCacheDiagnostic, StatelessExecutionOptions, ToolUse } from '@llumiverse/common';
 import type { z } from 'zod';
-import type { AgentResourceActionSchema, AgentResourceReferenceSchema, AgentResourceTypeSchema, AgentRunnerOptionsSchema, AsyncCompletionModeSchema, AsyncCompletionOptionsSchema, AsyncConversationExecutionPayloadSchema, AsyncExecutionPayloadSchema, AsyncExecutionResultSchema, AsyncInteractionExecutionPayloadSchema, CachePolicySchema, CatalogInteractionRefSchema, ConversationStripOptionsSchema, ConversationVisibilitySchema, ExecutionRunInteractionSchema, ExecutionRunRefSchema, ExecutionRunWorkflowSchema, GeneratedInteractionDefinitionSchema, GeneratedInteractionPromptSegmentSchema, GeneratedInteractionPromptTemplateSchema, GeneratedTestDataRecordSchema, GenerateInteractionPayloadSchema, GenerateTestDataPayloadSchema, ImprovePromptPayloadConfigSchema, ImprovePromptPayloadSchema, InCodePromptSchema, InitialToolCallSchema, InteractionCreatePayloadSchema, InteractionEndpointQuerySchema, InteractionEndpointSchema, InteractionExecutionErrorSchema, InteractionExecutionPayloadSchema, InteractionForkPayloadSchema, InteractionNameSchema, InteractionPublishPayloadSchema, InteractionRefSchema, InteractionRefWithSchemaSchema, InteractionSchema, InteractionsExportPayloadSchema, InteractionTagsSchema, InteractionUpdatePayloadSchema, InteractionVisibilitySchema, NamedInteractionExecutionPayloadSchema, PromptImprovementResponseSchema, PromptModalitiesSchema, RateLimitRequestPayloadSchema, RateLimitRequestResponseSchema, ResolvedEnvironmentInfoSchema, ResolvedInteractionExecutionInfoSchema, ResolvedRuntimeConfigSchema, ResultStorageOptionsSchema, RunSourceSchema, SchemaRefSchema, SkillContextTriggersSchema, StreamingOptionsSchema, StreamingTelemetryContextSchema, ToolResultMetaSchema, ToolResultSchema, ToolResultsPayloadSchema, UserMessagePayloadSchema } from './api-schemas/interaction.js';
+import type { AgentResourceActionSchema, AgentResourceReferenceSchema, AgentResourceTypeSchema, AgentRunnerOptionsSchema, AsyncCompletionModeSchema, AsyncCompletionOptionsSchema, AsyncConversationExecutionPayloadSchema, AsyncExecutionPayloadSchema, AsyncExecutionResultSchema, AsyncInteractionExecutionPayloadSchema, CachePolicySchema, CatalogInteractionRefSchema, ConversationStripOptionsSchema, ConversationVisibilitySchema, ExecutionRunInteractionSchema, ExecutionRunRefSchema, ExecutionRunWorkflowSchema, GeneratedInteractionDefinitionSchema, GeneratedInteractionPromptSegmentSchema, GeneratedInteractionPromptTemplateSchema, GeneratedTestDataRecordSchema, GenerateInteractionPayloadSchema, GenerateTestDataPayloadSchema, ImprovePromptPayloadConfigSchema, ImprovePromptPayloadSchema, InCodeInteractionSchema, InCodePromptSchema, InitialToolCallSchema, InteractionCreatePayloadSchema, InteractionEndpointQuerySchema, InteractionEndpointSchema, InteractionExecutionErrorSchema, InteractionExecutionPayloadSchema, InteractionForkPayloadSchema, InteractionNameSchema, InteractionPublishPayloadSchema, InteractionRefSchema, InteractionRefWithSchemaSchema, InteractionSchema, InteractionsExportPayloadSchema, InteractionTagsSchema, InteractionUpdatePayloadSchema, InteractionVisibilitySchema, NamedInteractionExecutionPayloadSchema, PromptImprovementResponseSchema, PromptModalitiesSchema, RateLimitRequestPayloadSchema, RateLimitRequestResponseSchema, ResolvedCatalogInteractionSchema, ResolvedEnvironmentInfoSchema, ResolvedInteractionExecutionInfoSchema, ResolvedRuntimeConfigSchema, ResultStorageOptionsSchema, RunSourceSchema, SchemaRefSchema, SkillContextTriggersSchema, StreamingOptionsSchema, StreamingTelemetryContextSchema, ToolResultMetaSchema, ToolResultSchema, ToolResultsPayloadSchema, UpdateExecutionRunPayloadSchema, UserMessagePayloadSchema } from './api-schemas/interaction.js';
 import type { InteractionExecutionConfigurationSchema } from './api-schemas/store.js';
-import type { MCPToolAnnotations } from './apps.js';
 import type { ExecutionEnvironmentRef } from './environment.js';
 import type { ProjectRef } from './project.js';
-import type { ExecutablePromptSegmentDef, PopulatedPromptSegmentDef } from './prompt.js';
+import type { PopulatedPromptSegmentDef } from './prompt.js';
 import type { TextArtifactReference } from './store/conversation-state.js';
 import type { AccountRef } from './user.js';
 /**
@@ -4525,7 +4274,6 @@ import type { AccountRef } from './user.js';
  * working.
  */
 export * from './interaction-values.js';
-import { ConfigModes, RunDataStorageLevel } from './interaction-values.js';
 export type InteractionExecutionError = z.infer<typeof InteractionExecutionErrorSchema>;
 /**
  * Configuration for stripping large data from conversation history
@@ -4559,102 +4307,9 @@ export interface ResolveInteractionQuery {
     hasVideo?: boolean;
 }
 export type InCodePrompt = z.infer<typeof InCodePromptSchema>;
-export interface InCodeInteraction {
-    /**
-     * The interaction type.
-     */
-    type: 'sys' | 'app' | 'stored' | 'draft';
-    /**
-     * The id of the interaction. Required.
-     * The id is a unique identifier for the interaction.
-     * It is recommended to use a URL safe string and not include spaces.
-     * The id is composed of some namespace or prefix and the interaction name.
-     * Example: sys:generic_question, app:review_contract, tmp:my_temp_interaction
-     */
-    id: string;
-    /**
-     * The interaction code name. Required.
-     * Should be a URL safe string and not include spaces. It is recommended to use kebab-case or camel-case.
-     * The endpoints must satisfy the following regexp: /^[a-zA-Z0-9-_]+$/. No whitespaces or special characters are allowed.
-     */
-    name: string;
-    /**
-     * Only applies for stored interactions. The version of the interaction.
-     * Undefined for non stored interactions
-     */
-    version?: number;
-    /**
-     * Only applies for stored interactions. Whether the interaction is published or not.
-     */
-    published?: boolean;
-    /**
-     * A title for the interaction. If not provided, the endpoint will be used.
-     */
-    title?: string;
-    /**
-     * An optional description of the interaction.
-     */
-    description?: string;
-    /**
-     * The JSON schema to be used for the result if any.
-     */
-    result_schema?: JSONSchema | SchemaRef;
-    /**
-     * The modality of the interaction output.
-     * If not specified Modalities.Text is assumed.
-     */
-    output_modality?: Modalities;
-    /**
-     * How to store the run data for executions of this interaction.
-     * Defaults to STANDARD.
-     */
-    storage?: RunDataStorageLevel;
-    /**
-     * Optional tags for the interaction.
-     */
-    tags?: string[];
-    /**
-     * Agent Runner configuration options.
-     */
-    agent_runner_options?: AgentRunnerOptions;
-    /**
-     * Default options for the model to be used when executing this interaction.
-     * (like temperature etc)
-     */
-    model_options?: ModelOptions;
-    /**
-     * The prompts composing the interaction. Required.
-     */
-    prompts: InCodePrompt[];
-    /**
-     * Optional reference to an external resource if any.
-     * Used internally by the system to synchronize stored interactions with in-code interactions.
-     */
-    externalId?: string;
-    /**
-     * Runtime configuration (system use only)
-     *
-     * This field is populated by the system when converting stored interactions
-     * and contains runtime-specific defaults like target model/environment IDs.
-     *
-     * DO NOT set this field manually when writing interaction definitions.
-     * These values are environment-specific and not portable.
-     *
-     * @internal
-     */
-    runtime?: {
-        /**
-         * Default target environment for the interaction execution
-         */
-        environment?: string;
-        /**
-         * Default (recommended) target model for the interaction execution
-         */
-        model?: string;
-    };
-}
-export interface InteractionSpec extends Omit<InCodeInteraction, 'id' | 'runtime' | 'type' | 'published' | 'version'> {
-}
+export type InCodeInteraction = z.infer<typeof InCodeInteractionSchema>;
+export type ResolvedCatalogInteraction = z.infer<typeof ResolvedCatalogInteractionSchema>;
+export type InteractionSpec = Omit<InCodeInteraction, 'id' | 'runtime' | 'type' | 'published' | 'version'>;
 /**
  * The payload to query the interaction endpoints
  */
@@ -4667,9 +4322,6 @@ export type InteractionTags = z.infer<typeof InteractionTagsSchema>;
 export type InteractionRef = z.infer<typeof InteractionRefSchema>;
 /** An interaction reduced to the fields a name picker needs. */
 export type InteractionName = z.infer<typeof InteractionNameSchema>;
-export declare const InteractionNamePopulate = "id name";
-export declare const InteractionRefPopulate = "id name endpoint parent description status version visibility tags agent_runner_options updated_at prompts";
-export declare const InteractionRefWithSchemaPopulate = "id name endpoint parent description status version visibility tags agent_runner_options updated_at prompts result_schema";
 /**
  * An interaction reference carrying the schemas an export needs to reconstruct it.
  *
@@ -4693,12 +4345,6 @@ export declare enum ExecutionRunStatus {
     completed = "completed",
     failed = "failed"
 }
-export declare enum RunDataStorageDescription {
-    STANDARD = "Run data is stored for both the model inputs and output.",
-    RESTRICTED = "No run data is stored for the model inputs \u2014 only the model output.",
-    DEBUG = "Run data is stored for the model inputs and output, schema, and final prompt."
-}
-export declare const RunDataStorageOptions: Record<RunDataStorageLevel, RunDataStorageDescription>;
 /**
  * Schema can be stored or specified as a reference to an external schema.
  * We only support "store:" references for now
@@ -4706,35 +4352,7 @@ export declare const RunDataStorageOptions: Record<RunDataStorageLevel, RunDataS
 export type SchemaRef = z.infer<typeof SchemaRefSchema>;
 export type CachePolicy = z.infer<typeof CachePolicySchema>;
 export type InteractionVisibility = z.infer<typeof InteractionVisibilitySchema>;
-export interface InteractionData {
-    readonly id: string;
-    name: string;
-    endpoint: string;
-    description?: string;
-    project: string | ProjectRef;
-    tags: string[];
-    agent_runner_options?: AgentRunnerOptions;
-    result_schema?: JSONSchema | SchemaRef;
-    environment?: string | ExecutionEnvironmentRef;
-    model?: string;
-    model_options?: ModelOptions;
-    restriction?: RunDataStorageLevel;
-    /**
-     * @deprecated This is deprecated. Use CompletionResult.type information instead.
-     */
-    output_modality?: Modalities;
-}
 export type Interaction = z.infer<typeof InteractionSchema>;
-export interface PopulatedInteraction extends Omit<Interaction, 'prompts'> {
-    prompts: PopulatedPromptSegmentDef[];
-}
-/**
- * Used to describe an interaction that can be executed. Contains only the interaction data useful
- * to execute the interaction plus the prompt templates
- */
-export interface ExecutableInteraction extends InteractionData {
-    prompts: ExecutablePromptSegmentDef[];
-}
 export type InteractionCreatePayload = z.infer<typeof InteractionCreatePayloadSchema>;
 export type InteractionUpdatePayload = z.infer<typeof InteractionUpdatePayloadSchema>;
 export type InteractionPublishPayload = z.infer<typeof InteractionPublishPayloadSchema>;
@@ -4750,10 +4368,6 @@ export interface InteractionDeletePayload {
 export type InteractionForkPayload = z.infer<typeof InteractionForkPayloadSchema>;
 export type InteractionExecutionPayload = z.infer<typeof InteractionExecutionPayloadSchema>;
 export type NamedInteractionExecutionPayload = z.infer<typeof NamedInteractionExecutionPayloadSchema>;
-export type ToolRef = string | {
-    name: string;
-    description: string;
-};
 export type ConversationVisibility = z.infer<typeof ConversationVisibilitySchema>;
 /**
  * Defines the scope for agent search operations.
@@ -4852,15 +4466,12 @@ export interface ToolResultContent {
  * rather than throwing, and an empty/absent label falls back to the id.
  */
 export declare function normalizeAgentResources(value: unknown): AgentResourceReference[];
-/** Extract the normalized resource references a tool declared in its result metadata. */
-export declare function getResourcesFromToolResult(result: Pick<ToolResultContent, 'meta'>): AgentResourceReference[];
 export type ToolResult = z.infer<typeof ToolResultSchema>;
 /**
  * The payload to sent the tool responses back to the target LLM
  */
 export type ToolResultsPayload = z.infer<typeof ToolResultsPayloadSchema>;
 export type UserMessagePayload = z.infer<typeof UserMessagePayloadSchema>;
-export type CheckpointConversationPayload = Omit<ToolResultsPayload, 'results' | 'tools'>;
 export declare enum RunSourceTypes {
     api = "api",
     cli = "cli",
@@ -4901,6 +4512,7 @@ export interface BaseExecutionRun<P = unknown> {
     finish_reason?: string;
     prompt?: unknown;
     token_use?: ExecutionTokenUsage;
+    prompt_cache_diagnostics?: PromptCacheDiagnostic[];
     chunks?: number;
     execution_time?: number;
     /** @format date-time */
@@ -4943,19 +4555,7 @@ export interface InteractionExecutionResult<P = unknown> extends Omit<ExecutionR
     conversation?: unknown;
     options?: StatelessExecutionOptions;
 }
-export interface LegacyInteractionExecutionResult<P = unknown> extends Omit<InteractionExecutionResult<P>, 'result' | 'account' | 'project'> {
-    account: string | AccountRef;
-    project: string | ProjectRef;
-    result?: JSONObject | string | null;
-}
 export type ExecutionRunRef = z.infer<typeof ExecutionRunRefSchema>;
-export declare const ExecutionRunRefSelect = "-result -parameters -result_schema -prompt";
-export declare enum ConfigModesDescription {
-    RUN_AND_INTERACTION_CONFIG = "This run configuration is used. Undefined options are filled with interaction configuration.",
-    RUN_CONFIG_ONLY = "Only this run configuration is used. Undefined options remain undefined.",
-    INTERACTION_CONFIG_ONLY = "Only interaction configuration is used."
-}
-export declare const ConfigModesOptions: Record<ConfigModes, ConfigModesDescription>;
 export type InteractionExecutionConfiguration = z.infer<typeof InteractionExecutionConfigurationSchema>;
 export type GenerateInteractionPayload = z.infer<typeof GenerateInteractionPayloadSchema>;
 export type GenerateTestDataPayload = z.infer<typeof GenerateTestDataPayloadSchema>;
@@ -5001,79 +4601,17 @@ export type ResolvedRuntimeConfig = z.infer<typeof ResolvedRuntimeConfigSchema>;
  * (environment, model) that would be used at execution time.
  */
 export type ResolvedInteractionExecutionInfo = z.infer<typeof ResolvedInteractionExecutionInfoSchema>;
-/**
- * A builtin tool definition from the tools catalog
- */
-export interface BuiltinToolDefinition {
-    /**
-     * The unique tool name
-     */
-    name: string;
-    /**
-     * One-line summary shown in the tool selector UI
-     */
-    summary?: string;
-    /**
-     * JSON schema for the tool's parameters
-     */
-    params: JSONSchema;
-    /**
-     * Whether this tool is active by default when no explicit tool list is provided.
-     * Tools with default: false are only activated by skills.
-     */
-    default: boolean;
-    /**
-     * Behavioral hints following the MCP ToolAnnotations spec.
-     * Used for display purposes only — not sent to LLMs.
-     */
-    annotations?: MCPToolAnnotations;
-}
-/**
- * A system skill entry in the tools catalog.
- * System skills are built into the platform and unlock hidden tools.
- */
-export interface SystemSkillCatalogEntry {
-    /** Skill name without the learn_ prefix, e.g. "document_search" */
-    name: string;
-    /** Tool name used in agent selection, i.e. "learn_document_search" */
-    tool_name: string;
-    /** Human-readable display title */
-    title: string;
-    /** Description of what the skill unlocks */
-    description: string;
-    /** Tool names this skill enables (unlocks) when called */
-    tools: string[];
-    /** Whether this skill is part of the default agent toolkit */
-    default?: boolean;
-}
-/**
- * Response from the builtin tools catalog endpoint
- */
-export interface BuiltinToolsCatalogResponse {
-    /**
-     * List of available builtin tools
-     */
-    tools: BuiltinToolDefinition[];
-    /**
-     * When the catalog was generated
-     */
-    generated_at: string;
-    /**
-     * Total number of tools in the catalog
-     */
-    total_tools: number;
-    /**
-     * System skills bundled in the platform, available without app installation
-     */
-    skills?: SystemSkillCatalogEntry[];
+export interface PopulatedInteraction extends Omit<Interaction, 'prompts'> {
+    prompts: PopulatedPromptSegmentDef[];
 }
+export type UpdateExecutionRunPayload = z.infer<typeof UpdateExecutionRunPayloadSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: prompt.d.ts
 // -----------------------------------------------------------------------------
 import type { JSONSchema, PromptRole } from '@llumiverse/common';
 import type { z } from 'zod';
-import type { PromptTemplateCreatePayloadSchema, PromptTemplateRefSchema, PromptTemplateSchema, PromptTemplateUpdatePayloadSchema } from './api-schemas/interaction.js';
+import type { ExportedPromptTemplateRefSchema, InteractionPromptSegmentInputSchema, InteractionPromptTemplateInputSchema, PromptTemplateCreatePayloadSchema, PromptTemplateRefSchema, PromptTemplateSchema, PromptTemplateUpdatePayloadSchema } from './api-schemas/interaction.js';
 import type { PromptTemplateForkPayloadSchema, PromptTemplateInteractionsResponseSchema, PromptTemplateInteractionUsageSchema, PromptTemplateInteractionVersionSchema, RenderPromptPayloadSchema, RenderPromptResponseSchema } from './api-schemas/prompt.js';
 export interface ChatPromptSchema {
     role: PromptRole.user | PromptRole.assistant;
@@ -5094,9 +4632,6 @@ export interface PromptSegmentDef<T = string | PromptTemplate | PromptTemplateRe
     template?: T;
     configuration?: unknown;
 }
-export interface PromptSegmentRef<T = string | PromptTemplate | PromptTemplateRef> extends PromptSegmentDef<T> {
-    id: string;
-}
 export interface PopulatedPromptSegmentDef extends Omit<PromptSegmentDef, 'template'> {
     template?: PromptTemplate;
 }
@@ -5107,9 +4642,6 @@ export interface ExecutablePromptSegmentDef extends Omit<PromptSegmentDef, 'temp
     template?: ExecutablePromptTemplate;
 }
 export type PromptTemplateRef = z.infer<typeof PromptTemplateRefSchema>;
-export interface PromptTemplateRefWithSchema extends PromptTemplateRef {
-    inputSchema?: JSONSchema;
-}
 export declare enum TemplateType {
     jst = "jst",
     handlebars = "handlebars",
@@ -5122,6 +4654,8 @@ export interface ExecutablePromptTemplate {
     inputSchema?: JSONSchema;
 }
 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>;
 export type PromptTemplateUpdatePayload = z.infer<typeof PromptTemplateUpdatePayloadSchema>;
@@ -5136,6 +4670,7 @@ 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>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: skill.d.ts
@@ -5205,29 +4740,19 @@ export interface InjectedSkill {
      */
     match_score?: number;
 }
-/**
- * Result from generateTools activity with skills
- */
-export interface ToolsWithSkills {
-    /**
-     * Array of tool definitions
-     */
-    tools: unknown[];
-    /**
-     * Skills injected based on context
-     */
-    injected_skills: InjectedSkill[];
-}
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: runs.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { ExecutionRunDocRefSchema, RunClonePayloadSchema, RunCreatePayloadSchema, RunSearchMetaResponseSchema } from './api-schemas/interaction.js';
+import type { ComputeRunFacetsResponseSchema, ExecutionRunDocRefSchema, FindRunResultArraySchema, FindRunResultSchema, PopulatedExecutionRunResultSchema, RunClonePayloadSchema, RunCreatePayloadSchema, RunSearchMetaResponseSchema } from './api-schemas/interaction.js';
 /**
  * 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
  * It uses interaction field (from NamedInteractionExecutionPayload) to pass the interaction ID to run
@@ -5249,6 +4774,7 @@ export interface RangeValue {
     lte?: number | string;
 }
 export type RunSearchMetaResponse = z.infer<typeof RunSearchMetaResponseSchema>;
+export type ComputeRunFacetsResponse = z.infer<typeof ComputeRunFacetsResponseSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: data-platform.d.ts
@@ -5262,7 +4788,7 @@ import type { AppDashboardDefinitionSchema } from './api-schemas/app-runtime.js'
  */
 import type { z } from 'zod';
 import type { CreateDashboardPayloadSchema, CreateDashboardSnapshotPayloadSchema, DashboardArchiveResultSchema, DashboardBulkArchiveResultSchema, DashboardBulkDeleteResultSchema, DashboardDataSourceSchema, DashboardElasticsearchDslSchema, DashboardElasticsearchResultMappingSchema, DashboardItemSchema, DashboardLayoutSchema, DashboardPanelPositionSchema, DashboardPanelSchema, DashboardQuerySchema, DashboardSchema, DashboardSqlDataSourceSchema, DashboardStatusSchema, DashboardStoreElasticsearchDataSourceSchema, DashboardVersionItemSchema, DashboardVersioningPayloadSchema, DashboardVersioningStatusResponseSchema, DashboardVersionSchema, PromoteDashboardVersionPayloadSchema, UpdateDashboardPayloadSchema } from './api-schemas/dashboard.js';
-import type { AlterTableOperationSchema, AlterTablePayloadSchema, BatchQueryPayloadSchema, BatchQueryResultItemSchema, BatchQueryResultSchema, CreateDataStorePayloadSchema, CreateSnapshotPayloadSchema, CreateTablePayloadSchema, CreateTablesPayloadSchema, DataColumnForAISchema, DataColumnSchema, DataColumnTypeSchema, DataForeignKeyForAISchema, DataForeignKeySchema, DataIndexSchema, DataRelationshipForAISchema, DataRelationshipSchema, DataRelationshipTypeSchema, DataSchemaForAISchema, DataSchemaSchema, DataStoreArchiveResultSchema, DataStoreDownloadInfoSchema, DataStoreFullSchemaResponseSchema, DataStoreItemSchema, DataStoreMutateRowsPayloadSchema, DataStoreMutateRowsResultSchema, DataStoreSchema, DataStoreSchemaResponseSchema, DataStoreStatusSchema, DataStoreTableDetailSchema, DataStoreTableDropResultSchema, DataStoreVersionSchema, DataStoreVersionTableStateSchema, DataTableForAISchema, DataTableSchema, DataTableSemanticTypeSchema, DataTableSummarySchema, GetDataStoreTableQuerySchema, ImportDataFormatSchema, ImportDataPayloadSchema, ImportDataSourceSchema, ImportJobSchema, ImportStatusSchema, ImportTableDataSchema, ListDataStoreVersionsQuerySchema, QueryPayloadSchema, QueryResultColumnSchema, QueryResultSchema, QueryValidationErrorSchema, QueryValidationPayloadSchema, QueryValidationResultSchema, SemanticColumnTypeSchema, UpdateSchemaPayloadSchema } from './api-schemas/data-store.js';
+import type { AlterTableOperationSchema, AlterTablePayloadSchema, BatchQueryPayloadSchema, BatchQueryResultItemSchema, BatchQueryResultSchema, CreateDataStorePayloadSchema, CreateSnapshotPayloadSchema, CreateTablePayloadSchema, CreateTablesPayloadSchema, DataColumnForAISchema, DataColumnSchema, DataColumnTypeSchema, DataColumnUpdateSchema, DataForeignKeyForAISchema, DataForeignKeySchema, DataIndexSchema, DataRelationshipForAISchema, DataRelationshipSchema, DataRelationshipTypeSchema, DataSchemaForAISchema, DataSchemaSchema, DataStoreArchiveResultSchema, DataStoreDownloadInfoSchema, DataStoreFullSchemaResponseSchema, DataStoreItemSchema, DataStoreMutateRowsPayloadSchema, DataStoreMutateRowsResultSchema, DataStoreSchema, DataStoreSchemaResponseSchema, DataStoreStatusSchema, DataStoreTableDetailSchema, DataStoreTableDropResultSchema, DataStoreVersionSchema, DataStoreVersionTableStateSchema, DataTableForAISchema, DataTableSchema, DataTableSemanticTypeSchema, DataTableSummarySchema, GetDataStoreTableQuerySchema, ImportDataFormatSchema, ImportDataPayloadSchema, ImportDataSourceSchema, ImportJobSchema, ImportStatusSchema, ImportTableDataSchema, ListDataStoreVersionsQuerySchema, QueryPayloadSchema, QueryResultColumnSchema, QueryResultSchema, QueryValidationErrorSchema, QueryValidationPayloadSchema, QueryValidationResultSchema, SemanticColumnTypeSchema, UpdateSchemaPayloadSchema } from './api-schemas/data-store.js';
 /**
  * Supported column data types for DuckDB tables.
  */
@@ -5493,7 +5019,7 @@ export type DataSchemaForAI = z.infer<typeof DataSchemaForAISchema>;
 /**
  * Version retention configuration.
  */
-export interface DataStoreRetentionConfig {
+interface DataStoreRetentionConfig {
     /** Keep versions for this many days */
     retention_days: number;
     /** Named snapshots are exempt from retention */
@@ -5546,14 +5072,6 @@ export type DashboardLayout = z.infer<typeof DashboardLayoutSchema>;
  * @deprecated Use combined Vega-Lite spec with vconcat/hconcat instead.
  */
 export declare const DEFAULT_DASHBOARD_LAYOUT: DashboardLayout;
-/**
- * SQL query parameters with default values.
- * Supports {{param_name}} placeholders in SQL that get substituted at runtime.
- */
-export interface DashboardQueryParameters {
-    /** Default values for SQL parameters. Keys are parameter names (without braces). */
-    defaults: Record<string, string>;
-}
 /**
  * Elasticsearch DSL supported by dashboard data sources.
  * Queries execute through Vertesia Store, so project/security filtering remains server-side.
@@ -5611,27 +5129,6 @@ export type CreateDashboardPayload = z.infer<typeof CreateDashboardPayloadSchema
  * Payload for updating a dashboard.
  */
 export type UpdateDashboardPayload = z.infer<typeof UpdateDashboardPayloadSchema>;
-/**
- * Payload for previewing a dashboard (render without saving).
- */
-export interface PreviewDashboardPayload {
-    /** Data source used to populate Vega `data.values`. */
-    dataSource?: DashboardDataSource;
-    /** SQL query that returns all data for the dashboard */
-    query?: string;
-    /** Maximum rows to return from the query (default: 10000) */
-    queryLimit?: number;
-    /** Default values for SQL parameters */
-    queryParameters?: Record<string, string>;
-    /** Complete Vega-Lite specification for the entire dashboard */
-    spec?: Record<string, unknown>;
-    /** @deprecated Use single `query` field instead */
-    queries?: DashboardQuery[];
-    /** @deprecated Use single `spec` field with vconcat/hconcat instead */
-    panels?: DashboardPanel[];
-    /** @deprecated Layout is now handled within the Vega-Lite spec */
-    layout?: Partial<DashboardLayout>;
-}
 /**
  * Options for rendering a dashboard.
  */
@@ -5643,21 +5140,6 @@ export interface RenderDashboardOptions {
     /** Background color (default: white) */
     backgroundColor?: string;
 }
-/**
- * Result of rendering a dashboard.
- */
-export interface RenderDashboardResult {
-    /** URL to the rendered PNG image */
-    url: string;
-    /** When the URL expires (seconds from now) */
-    expires_in: number;
-    /** When the dashboard was rendered */
-    rendered_at: string;
-    /** Image width in pixels */
-    width: number;
-    /** Image height in pixels */
-    height: number;
-}
 /**
  * A point-in-time version of a dashboard.
  * Stores full snapshot inline (no external storage needed for small JSON documents).
@@ -5675,4 +5157,6 @@ export type CreateDashboardSnapshotPayload = z.infer<typeof CreateDashboardSnaps
  * Payload for promoting a version to current.
  */
 export type PromoteDashboardVersionPayload = z.infer<typeof PromoteDashboardVersionPayloadSchema>;
+export type DataColumnUpdate = z.infer<typeof DataColumnUpdateSchema>;
+export {};