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

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

@@ -10,8 +10,8 @@
 // -----------------------------------------------------------------------------
 // @vertesia/common: index.d.ts
 // -----------------------------------------------------------------------------
+export type { VertexAIGeminiOmniVideoOptions, VideoResult } from '@llumiverse/common';
 export * from './access-control.js';
-export * from './agent-request-template.js';
 export * from './analytics.js';
 /**
  * Schema-derived API types. MUST stay `export type` — tsc erases it, so `lib/index.js` never
@@ -25,15 +25,15 @@ export * from './apps.js';
 export * from './ask-user.js';
 export * from './audit-trail.js';
 export * from './browser-credentials.js';
-export * from './channels.js';
 export * from './common.js';
+export * from './content-query.js';
 export * from './cost-analytics.js';
 export * from './data-platform.js';
+export * from './email.js';
 export * from './embeddings.js';
 export * from './environment.js';
 export * from './facets.js';
 export * from './group.js';
-export * from './host-utils.js';
 export * from './integrations.js';
 export * from './interaction.js';
 export * from './json.js';
@@ -43,11 +43,9 @@ export * from './model_utility.js';
 export * from './oauth.js';
 export * from './oauth-scopes.js';
 export * from './oauth-server.js';
-export * from './Progress.js';
 export * from './payload.js';
 export * from './pending-asks.js';
 export * from './platform-event.js';
-export * from './platform-event-validation.js';
 export * from './principal-context.js';
 export * from './project.js';
 export * from './prompt.js';
@@ -73,20 +71,15 @@ export * from './utils/auth.js';
 export * from './utils/schemas.js';
 export type * from './utils/type-helpers.js';
 export * from './versions.js';
-export * from './view-configuration-validation.js';
-export * from './view-query-validation.js';
-export * from './view-validation-helpers.js';
 export * from './views.js';
-export * from './views-schema.js';
-export { type AppViewExperienceId, parseAppViewExperienceId, type ViewValidationIssue, validateViewExperienceId, } from './views-validation.js';
 export * from './workflow-analytics.js';
 
 // -----------------------------------------------------------------------------
 // @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';
@@ -121,29 +114,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
@@ -189,77 +168,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>;
@@ -281,41 +189,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>;
 /**
@@ -331,21 +210,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>;
 /**
@@ -372,11 +238,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. */
@@ -448,10 +309,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. */
@@ -479,10 +341,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.
@@ -602,8 +460,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.
  *
@@ -647,7 +503,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.
  */
@@ -878,7 +734,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 */
@@ -931,14 +787,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.
@@ -996,27 +844,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.
  */
@@ -1028,21 +855,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).
@@ -1060,18 +872,19 @@ 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 {};
 
 // -----------------------------------------------------------------------------
 // @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';
 /**
@@ -1080,7 +893,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
@@ -1114,102 +926,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
  */
@@ -1222,9 +941,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.
  *
@@ -1248,12 +964,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
@@ -1261,35 +971,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>;
@@ -1305,10 +987,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.
@@ -1407,15 +1085,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",
@@ -1456,6 +1131,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 */
@@ -1498,19 +1174,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>;
@@ -1556,79 +1220,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;
@@ -1649,9 +1251,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;
 }
@@ -1662,9 +1261,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",
@@ -1677,6 +1273,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>;
@@ -1691,6 +1289,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: project.d.ts
@@ -1699,8 +1298,8 @@ import type { z } from 'zod';
 import type { ProjectRefSchema } from './api-schemas/apikey.js';
 import type { EmbeddingsStatusResponseSchema, ProjectConfigurationEmbeddingEnablePayloadSchema } from './api-schemas/embeddings.js';
 import type { DriftAnalysisProgressSchema, DriftAnalysisResultSchema, DriftAnalysisStatusResponseSchema, IndexingStatusResponseSchema, ReindexAgentRunsPayloadSchema, ReindexAgentRunsResponseSchema, StartProjectReindexPayloadSchema } from './api-schemas/indexing.js';
-import type { CreateProjectPayloadFromSchema, ListProjectsQuerySchema, ProjectIntegrationListEntrySchema, ProjectIntegrationListResponseSchema, ProjectPluginsUpdatePayloadSchema, ProjectSchema, ProjectTagQuerySchema } from './api-schemas/project.js';
-import type { AgentCheckpointConfigurationSchema, AgentProjectConfigurationSchema, BrowserUseProjectConfigurationSchema, BrowserUseRiskPolicySchema, BrowserUseScreenshotCaptureSchema, ElasticsearchBackendSchema, ModalityDefaultsSchema, ModelDefaultSchema, ProjectConfigurationEmbeddingSchema, ProjectConfigurationSchema, ProjectIndexingConfigurationSchema, ProjectIntakeConfigurationSchema, ProjectIntakeSniffConfigurationSchema, ProjectModelDefaultsSchema, ProjectSearchPropertyMappingSchema, ProjectSearchPropertyTypeSchema, ProjectSearchTierSchema, SystemDefaultsSchema } from './api-schemas/project-configuration.js';
+import type { CreateProjectPayloadFromSchema, ListProjectsQuerySchema, ProjectIntegrationListEntrySchema, ProjectIntegrationListResponseSchema, ProjectPluginsUpdatePayloadSchema, ProjectSchema, ProjectTagQuerySchema, UpdateProjectConfigurationPayloadSchema, UpdateProjectPayloadSchema } from './api-schemas/project.js';
+import type { AgentCheckpointConfigurationSchema, AgentProjectConfigurationSchema, BrowserUseProjectConfigurationSchema, BrowserUseRiskPolicySchema, BrowserUseScreenshotCaptureSchema, ElasticsearchBackendSchema, IntakeVisionProfileSettingsUpdateSchema, ModalityDefaultsSchema, ModelDefaultSchema, ProjectConfigurationEmbeddingSchema, ProjectConfigurationSchema, ProjectIndexingConfigurationSchema, ProjectIntakeConfigurationSchema, ProjectIntakeSniffConfigurationSchema, ProjectModelDefaultsSchema, ProjectSearchPropertyMappingSchema, ProjectSearchPropertyTypeSchema, ProjectSearchTierSchema, SystemDefaultsSchema } from './api-schemas/project-configuration.js';
 import type { AccountRef } from './user.js';
 /**
  * `SystemRoles` lives in `./project-values.js` so the API schemas can read it without importing this
@@ -1708,7 +1307,6 @@ import type { AccountRef } from './user.js';
  */
 export * from './project-values.js';
 export type ICreateProjectPayload = CreateProjectPayloadFromSchema;
-export declare function isRoleIncludedIn(role: string, includingRole: string): boolean;
 export interface PopulatedProjectRef {
     id: string;
     name: string;
@@ -1734,13 +1332,6 @@ export declare enum SystemInteractionCategory {
  * Map system interaction endpoints to categories.
  */
 export declare const SYSTEM_INTERACTION_CATEGORIES: Record<string, SystemInteractionCategory>;
-/**
- * Get category for a system interaction endpoint.
- * Returns undefined if category is non-applicable or endpoint is not recognized.
- * Note: Caller is responsible for determining if the interaction is a system interaction.
- * @param endpoint - The interaction endpoint name
- */
-export declare function getSystemInteractionCategory(endpoint: string): SystemInteractionCategory | undefined;
 /**
  * One optional default per {@link SystemInteractionCategory}.
  *
@@ -1769,21 +1360,13 @@ export type AgentProjectConfiguration = z.infer<typeof AgentProjectConfiguration
 export type AgentCheckpointConfiguration = z.infer<typeof AgentCheckpointConfigurationSchema>;
 export type ProjectSearchPropertyType = z.infer<typeof ProjectSearchPropertyTypeSchema>;
 export type ProjectSearchPropertyMapping = z.infer<typeof ProjectSearchPropertyMappingSchema>;
-export declare const PROJECT_SEARCH_PROPERTY_TYPES: readonly ProjectSearchPropertyType[];
-/**
- * Validate property mappings at API and index-creation boundaries.
- *
- * Returns user-facing issue strings instead of throwing so callers can map the
- * result to the error type appropriate for their boundary.
- */
-export declare function validateProjectSearchPropertyMappings(value: unknown): string[];
 export type ProjectIndexingConfiguration = z.infer<typeof ProjectIndexingConfigurationSchema>;
 export declare enum SupportedEmbeddingTypes {
     text = "text",
     image = "image",
     properties = "properties"
 }
-export declare enum FullTextType {
+declare enum FullTextType {
     full_text = "full_text"
 }
 export type SearchTypes = SupportedEmbeddingTypes | FullTextType;
@@ -1796,12 +1379,6 @@ export declare const SearchTypes: {
 export type ProjectConfigurationEmbedding = z.infer<typeof ProjectConfigurationEmbeddingSchema>;
 export type ProjectConfigurationEmbeddingEnablePayload = z.infer<typeof ProjectConfigurationEmbeddingEnablePayloadSchema>;
 export type Project = z.infer<typeof ProjectSchema>;
-export interface ProjectCreatePayload {
-    name: string;
-    description?: string;
-}
-export interface ProjectUpdatePayload extends Partial<Project> {
-}
 export type ProjectPluginsUpdatePayload = z.infer<typeof ProjectPluginsUpdatePayloadSchema>;
 export declare const ProjectRefPopulate = "id name account";
 export type EmbeddingsStatusResponse = z.infer<typeof EmbeddingsStatusResponseSchema>;
@@ -1810,26 +1387,6 @@ export type EmbeddingsStatusResponse = z.infer<typeof EmbeddingsStatusResponseSc
  */
 export type IndexingStatusResponse = z.infer<typeof IndexingStatusResponseSchema>;
 export type StartProjectReindexPayload = z.infer<typeof StartProjectReindexPayloadSchema>;
-/**
- * Auto-tunes shard sizing based on project doc count.
- *
- * Returns:
- * - shard_size: target docs per shard (workflow path uses this; zeno-bulk
- *   computes shard count from total/shard_size).
- * - parallel_shard_count: max in-flight shard activities (workflow path only).
- * - max_shards: hard cap on shard count for the direct path. Direct path
- *   passes this as `shards` to zeno-bulk so all shards run as cursors in
- *   ONE process; without this cap, an under-estimated shard_size (e.g.
- *   from stale estimatedDocumentCount) can spawn 10+ in-flight cursors
- *   and exceed Cloud Run memory.
- *
- * Explicit overrides should bypass this function and use user-provided values.
- */
-export declare function autoTuneReindexParams(docCount: number): {
-    shard_size: number;
-    parallel_shard_count: number;
-    max_shards: number;
-};
 export type ReindexAgentRunsPayload = z.infer<typeof ReindexAgentRunsPayloadSchema>;
 export type ReindexAgentRunsResponse = z.infer<typeof ReindexAgentRunsResponseSchema>;
 /**
@@ -2092,7 +1649,7 @@ export interface ElasticsearchIndexStats {
 /**
  * Embedding configuration for a single type
  */
-export interface EmbeddingTypeConfig {
+interface EmbeddingTypeConfig {
     environment?: string;
     dimensions?: number;
     model?: string;
@@ -2179,16 +1736,22 @@ export type DriftAnalysisResult = z.infer<typeof DriftAnalysisResultSchema>;
 export type DriftAnalysisStatusResponse = z.infer<typeof DriftAnalysisStatusResponseSchema>;
 export type ProjectIntegrationListEntry = z.infer<typeof ProjectIntegrationListEntrySchema>;
 export type ProjectIntegrationListResponse = z.infer<typeof ProjectIntegrationListResponseSchema>;
+export type UpdateProjectPayload = z.infer<typeof UpdateProjectPayloadSchema>;
+export type UpdateProjectConfigurationPayload = z.infer<typeof UpdateProjectConfigurationPayloadSchema>;
+export type IntakeVisionProfileSettingsUpdate = z.infer<typeof IntakeVisionProfileSettingsUpdateSchema>;
 
 // -----------------------------------------------------------------------------
 // @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
@@ -2210,6 +1773,7 @@ export interface RangeValue {
     lte?: number | string;
 }
 export type RunSearchMetaResponse = z.infer<typeof RunSearchMetaResponseSchema>;
+export type ComputeRunFacetsResponse = z.infer<typeof ComputeRunFacetsResponseSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: skill.d.ts
@@ -2279,29 +1843,16 @@ 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: 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';
@@ -2340,34 +1891,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'> {
@@ -2442,6 +1965,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;
@@ -2576,7 +2103,7 @@ export interface TypeDetectionMetadata {
     min_pages?: number;
     detected_at: string;
 }
-export interface TemporalMediaMetadata extends ContentMetadata {
+interface TemporalMediaMetadata extends ContentMetadata {
     duration?: number;
     transcript?: Transcript;
 }
@@ -2623,7 +2150,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;
@@ -2637,15 +2164,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>;
@@ -2716,14 +2234,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>;
@@ -2739,18 +2250,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>;
@@ -2763,12 +2262,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 {
@@ -2800,7 +2293,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.
  *
@@ -2814,37 +2307,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>;
@@ -2864,40 +2335,79 @@ export declare enum ContentObjectProcessingPriority {
     normal = "normal",
     low = "low"
 }
-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;
+/**
+ * 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 declare const DocumentPartSchema: JSONSchemaType<DocumentPartProperties>;
+/**
+ * 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 {};
 
 // -----------------------------------------------------------------------------
 // @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 {
@@ -2935,11 +2445,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;
 }
@@ -2960,16 +2465,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>;
@@ -3081,6 +2588,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;
@@ -3120,6 +2628,7 @@ export interface CreateProcessDefinitionPayload {
     definition: ProcessDefinitionBody;
 }
 export interface UpdateProcessDefinitionPayload {
+    expected_edit_revision?: number;
     name?: string;
     description?: string;
     /**
@@ -3135,570 +2644,45 @@ export interface UpdateProcessDefinitionPayload {
 }
 export type PublishProcessDefinitionPayload = z.infer<typeof PublishProcessDefinitionPayloadSchema>;
 export type RevertProcessDefinitionPayload = z.infer<typeof RevertProcessDefinitionPayloadSchema>;
-
-// -----------------------------------------------------------------------------
-// @vertesia/common: store/process-schema.d.ts
-// -----------------------------------------------------------------------------
-export declare const PROCESS_DEFINITION_JSON_SCHEMA_ID = "https://schemas.vertesia.com/process-definition.v1.schema.json";
-export declare const ProcessDefinitionBodyJsonSchema: {
-    $id: string;
-    type: string;
-    description: string;
-    properties: {
-        format_version: {
-            type: string;
-            const: number;
-            description: string;
-        };
-        process: {
-            type: string;
-            minLength: number;
-            description: string;
-        };
-        description: {
-            type: string;
-            nullable: true;
-            description: string;
-        };
-        initial: {
-            type: string;
-            minLength: number;
-            description: string;
-        };
-        model: {
-            type: string;
-            nullable: true;
-            description: string;
-        };
-        resources: {
-            $ref: string;
-        };
-        context: {
-            $ref: string;
-        };
-        nodes: {
-            type: string;
-            description: string;
-            minProperties: number;
-            required: never[];
-            additionalProperties: {
-                $ref: string;
-            };
-        };
-        metadata: {
-            $ref: string;
-        };
-    };
-    required: string[];
-    additionalProperties: false;
-    $defs: {
-        metadataDefinition: {
-            type: string;
-            nullable: true;
-            description: string;
-            required: never[];
-            additionalProperties: true;
-        };
-        processContextDefinition: {
-            type: string;
-            properties: {
-                schema: {
-                    description: string;
-                    anyOf: ({
-                        type: string;
-                        additionalProperties?: undefined;
-                    } | {
-                        type: string;
-                        additionalProperties: true;
-                    })[];
-                };
-                initial: {
-                    type: string;
-                    description: string;
-                    required: never[];
-                    additionalProperties: true;
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        nodeDefinition: {
-            type: string;
-            description: string;
-            properties: {
-                type: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                tool: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                script: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                timeout: {
-                    type: string;
-                    minimum: number;
-                    maximum: number;
-                    nullable: true;
-                    description: string;
-                };
-                interaction: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                process: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                process_definition: {
-                    $ref: string;
-                    description: string;
-                };
-                process_version: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                run_type: {
-                    type: string;
-                    enum: string[];
-                    nullable: true;
-                    description: string;
-                };
-                returns: {
-                    $ref: string;
-                };
-                result_schema: {
-                    $ref: string;
-                    description: string;
-                };
-                prompt: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                input: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    required: never[];
-                    additionalProperties: true;
-                };
-                config: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    required: never[];
-                    additionalProperties: true;
-                };
-                title: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                description: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                human_description: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                writes: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        type: string;
-                    };
-                };
-                skippable: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                max_retries: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                transitions: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        $ref: string;
-                    };
-                };
-                tools: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        type: string;
-                    };
-                };
-                model: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                task: {
-                    $ref: string;
-                };
-                foreach: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                as: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                item_id: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                node: {
-                    $ref: string;
-                    description: string;
-                };
-                max_concurrency: {
-                    type: string;
-                    minimum: number;
-                    nullable: true;
-                    description: string;
-                };
-                collect: {
-                    description: string;
-                    oneOf: ({
-                        type: string;
-                        minLength: number;
-                        $ref?: undefined;
-                    } | {
-                        type?: undefined;
-                        minLength?: undefined;
-                        $ref: string;
-                    })[];
-                };
-                failure_policy: {
-                    type: string;
-                    enum: string[];
-                    nullable: true;
-                    description: string;
-                };
-                join: {
-                    type: string;
-                    enum: string[];
-                    nullable: true;
-                    description: string;
-                };
-                branches: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        oneOf: {
-                            $ref: string;
-                        }[];
-                    };
-                };
-                metadata: {
-                    $ref: string;
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        transitionDefinition: {
-            type: string;
-            properties: {
-                to: {
-                    type: string;
-                    minLength: number;
-                    description: string;
-                };
-                guard: {
-                    $ref: string;
-                    description: string;
-                };
-                trigger: {
-                    type: string;
-                    enum: string[];
-                    nullable: true;
-                    description: string;
-                };
-                label: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                metadata: {
-                    $ref: string;
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        processResourcesDefinition: {
-            type: string;
-            nullable: true;
-            properties: {
-                scripts: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    required: never[];
-                    additionalProperties: {
-                        $ref: string;
-                    };
-                };
-            };
-            required: never[];
-            additionalProperties: false;
-        };
-        processScriptResource: {
-            type: string;
-            properties: {
-                language: {
-                    type: string;
-                    enum: string[];
-                };
-                entrypoint: {
-                    type: string;
-                    minLength: number;
-                };
-                source: {
-                    $ref: string;
-                };
-                packages: {
-                    type: string;
-                    nullable: true;
-                    items: {
-                        type: string;
-                    };
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        processScriptSource: {
-            $ref: string;
-        };
-        processScriptInlineSource: {
-            type: string;
-            properties: {
-                type: {
-                    type: string;
-                    const: string;
-                    description: string;
-                };
-                files: {
-                    type: string;
-                    minProperties: number;
-                    required: never[];
-                    additionalProperties: {
-                        type: string;
-                    };
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        branchDefinition: {
-            type: string;
-            properties: {
-                to: {
-                    type: string;
-                    minLength: number;
-                    description: string;
-                };
-                when: {
-                    $ref: string;
-                    description: string;
-                };
-                default: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                metadata: {
-                    $ref: string;
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        branchNodeBranchDefinition: {
-            type: string;
-            properties: {
-                id: {
-                    type: string;
-                    minLength: number;
-                    description: string;
-                };
-                title: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                description: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                node: {
-                    $ref: string;
-                    description: string;
-                };
-                metadata: {
-                    $ref: string;
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        humanTaskDefinition: {
-            type: string;
-            properties: {
-                title: {
-                    type: string;
-                    minLength: number;
-                    description: string;
-                };
-                description: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                assignee: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                fields: {
-                    type: string;
-                    description: string;
-                    items: {
-                        $ref: string;
-                    };
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        taskField: {
-            type: string;
-            properties: {
-                name: {
-                    type: string;
-                    minLength: number;
-                    description: string;
-                };
-                type: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                required: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                label: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                options: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        type: string;
-                    };
-                };
-                default: {
-                    description: string;
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        processNodeReturnsDefinition: {
-            type: string;
-            properties: {
-                from: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                };
-                context: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        type: string;
-                    };
-                };
-            };
-            required: never[];
-            additionalProperties: false;
-        };
-        parallelCollectDefinition: {
-            type: string;
-            properties: {
-                into: {
-                    type: string;
-                    minLength: number;
-                    description: string;
-                };
-                mode: {
-                    type: string;
-                    enum: string[];
-                    nullable: true;
-                    description: string;
-                };
-                include: {
-                    type: string;
-                    nullable: true;
-                    description: string;
-                    items: {
-                        type: string;
-                        enum: string[];
-                    };
-                };
-            };
-            required: string[];
-            additionalProperties: false;
-        };
-        jsonLogicRule: {
-            type: string;
-            description: string;
-            required: never[];
-            additionalProperties: true;
-        };
-        jsonSchemaDefinition: {
-            type: string;
-            nullable: true;
-            description: string;
-            required: never[];
-            additionalProperties: true;
-        };
-    };
+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
@@ -3872,7 +2856,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>;
@@ -3888,22 +2871,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;
@@ -3956,7 +2923,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';
@@ -3972,54 +2939,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
@@ -4044,7 +2968,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
  */
@@ -4133,12 +3057,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'.
@@ -4172,6 +3090,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.
  */
@@ -4179,41 +3123,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;
@@ -4315,7 +3247,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';
@@ -4369,6 +3301,7 @@ export interface ActiveWorkstreamsQueryResult {
     /** True when the workflow could not answer this optional query. */
     unavailable?: boolean;
 }
+export {};
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: tool-execution.d.ts