@vertesia/common 1.5.0-dev.20260722.120446Z → 1.5.0-dev.20260804.124748Z

package/src/project.ts

@@ -1,34 +1,59 @@
-import type { JSONSchemaType } from 'ajv';
-import type { SupportedIntegrations } from './integrations.js';
-import type { ContentTypeIntakePolicy, IntakeVisionDetail, IntakeVisionProfileSettings } from './store/store.js';
-import type { WorkflowRunStatus } from './store/workflow.js';
+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 { AccountRef } from './user.js';
 import { ELASTICSEARCH_FIELD_PATH_PATTERN } from './view-validation-helpers.js';
 
-export interface ICreateProjectPayload {
-    name: string;
-    namespace: string;
-    description?: string;
-    auto_config?: boolean;
-}
-export enum SystemRoles {
-    owner = 'owner', // all permissions
-    admin = 'admin', // all permissions
-    manager = 'manager', // all permissions but manage_account, manage_billing
-    developer = 'developer', // all permissions but manage_account, manage_billing, manage_roles, delete
-    application = 'application', // executor + request_pk
-    automation = 'automation', // event-triggered automation runner
-    content_processor = 'content_processor', // trusted system content processing
-    consumer = 'consumer', // required permissions for users of micro apps
-    executor = 'executor', // can only read and execute interactions
-    reader = 'reader', // can only read (browse)
-    auditor = 'auditor', // can read all non-admin resources without mutation permissions
-    support = 'support', // Vertesia support read-only role
-    billing = 'billing', // can only manage billings
-    member = 'member', // can only access, but no specific permissions
-    app_member = 'app_member', // used to mark an user have access to an application. does not provide any permission on its own
-    content_superadmin = 'content_superadmin', // can see all content objects and collections
-}
+/**
+ * `SystemRoles` lives in `./project-values.js` so the API schemas can read it without importing this
+ * module back. Re-exported here so every existing import path keeps working.
+ */
+export * from './project-values.js';
+
+import { SystemRoles } from './project-values.js';
+
+export type ICreateProjectPayload = CreateProjectPayloadFromSchema;
 
 export function isRoleIncludedIn(role: string, includingRole: string) {
     switch (includingRole) {
@@ -50,54 +75,32 @@ export interface PopulatedProjectRef {
     name: string;
     account: AccountRef;
 }
-export interface ProjectRef {
-    id: string;
-    name: string;
-    account: string;
-    /**
-     * Only set when fetching the list of projects visible to an user which is an org admin or owner.
-     * If present and true, it means that the project is not accessible to the user.(even if it visible in listing)
-     * If not present or false then the project is accessible to the user.
-     */
-    restricted?: boolean;
-}
-
-export interface ProjectTagQuery {
-    tag?: string;
-}
-
-export interface ListProjectsQuery {
-    account?: string;
-}
-
-export enum ResourceVisibility {
-    public = 'public',
-    account = 'account',
-    project = 'project',
-}
+// The compact project reference, derived from the schema in `./api-schemas/apikey.js` — the object
+// OpenAPI publishes and AJV compiles, so there is one statement of the shape.
+//
+// It was the last hand-written twin in this package, and it stayed one for a concrete reason:
+// `Interaction`, `PromptTemplate` and `ExecutionRunRef` embed it and are still derived from
+// TypeScript, and the scanner used to resolve a `z.infer<>` alias to nothing — emptying six
+// components that had nothing to do with the batch that introduced the schema. The scanner now
+// short-circuits such an alias to the published component instead of trying to expand it, so a
+// derived component may reference an inferred type and the rule that blocked this is gone.
+//
+// The `restricted` flag's explanation lives in the schema's `.meta()`, which is what the published
+// component carries; it is no longer visible as TSDoc here, the same trade every other
+// schema-derived type in this package already makes.
+export type ProjectRef = z.infer<typeof ProjectRefSchema>;
+
+export type ProjectTagQuery = z.infer<typeof ProjectTagQuerySchema>;
+
+export type ListProjectsQuery = z.infer<typeof ListProjectsQuerySchema>;
 
 // ==========================================
 // Project Model Defaults Types
 // ==========================================
 
-/**
- * Environment and model pair for a default configuration.
- */
-export interface ModelDefault {
-    environment: string;
-    model: string;
-}
+export type ModelDefault = z.infer<typeof ModelDefaultSchema>;
 
-/**
- * Modality-specific default model overrides.
- * These override the base default when specific input modalities are detected.
- */
-export interface ModalityDefaults {
-    /** Override for inputs containing images */
-    image?: ModelDefault;
-    /** Override for inputs containing video (requires video-capable model) */
-    video?: ModelDefault;
-}
+export type ModalityDefaults = z.infer<typeof ModalityDefaultsSchema>;
 
 /**
  * System interaction category enum.
@@ -149,311 +152,50 @@ export function getSystemInteractionCategory(endpoint: string): SystemInteractio
     return category || undefined;
 }
 
-export type SystemDefaults = {
-    [K in SystemInteractionCategory]?: ModelDefault;
-};
-
 /**
- * Extensible project defaults using map/dictionary pattern.
+ * One optional default per {@link SystemInteractionCategory}.
+ *
+ * The schema writes the categories out rather than mapping over the enum, so `project.contract.test`
+ * asserts that its keys are exactly the category union — a new category has to be added in both
+ * places, and fails to compile until it is.
  */
-export interface ProjectModelDefaults {
-    /** Base default model - used when no other default applies */
-    base?: ModelDefault;
-    /** Modality-based overrides (image, video) - override base when specific input modalities detected */
-    modality?: ModalityDefaults;
-    /** System interaction category defaults */
-    system?: SystemDefaults;
-}
+export type SystemDefaults = z.infer<typeof SystemDefaultsSchema>;
 
-export type BrowserUseRiskPolicy = 'read_only' | 'low_write' | 'requires_approval' | 'unrestricted';
+export type ProjectModelDefaults = z.infer<typeof ProjectModelDefaultsSchema>;
 
-export type BrowserUseScreenshotCapture = 'off' | 'on_action' | 'each_turn';
+export type BrowserUseRiskPolicy = z.infer<typeof BrowserUseRiskPolicySchema>;
 
-export interface BrowserUseProjectConfiguration {
-    /**
-     * Enable the browser_use workflow-level tool for this project.
-     * Defaults to true when omitted.
-     */
-    enabled?: boolean;
-    /**
-     * Risk policy used when the tool call does not specify one.
-     * Defaults to low_write.
-     */
-    default_policy?: BrowserUseRiskPolicy;
-    /**
-     * Maximum policy a tool call may request. Requested policies above this
-     * are clamped down to the project maximum. Defaults to unrestricted.
-     */
-    max_policy?: BrowserUseRiskPolicy;
-    /**
-     * Optional project-wide host allowlist. When present, browser_use calls
-     * can only request hosts contained by this list.
-     */
-    allowed_hosts?: string[];
-    /**
-     * Allow saved Playwright scripts to hydrate artifacts/documents as files
-     * inside the browser sandbox for upload flows. Defaults to true.
-     */
-    allow_file_uploads?: boolean;
-    /**
-     * Allow the browser_playwright_script tool in browser workstreams.
-     * Defaults to true.
-     */
-    allow_playwright_scripts?: boolean;
-    /**
-     * Persist browser screenshots for UI progress. Defaults to on_action.
-     */
-    capture_screenshots?: BrowserUseScreenshotCapture;
-    /**
-     * Prefer unannotated screenshots in the browser-use UI widget when both
-     * raw and annotated captures are available. Defaults to true.
-     */
-    prefer_raw_screenshots?: boolean;
-}
+export type BrowserUseScreenshotCapture = z.infer<typeof BrowserUseScreenshotCaptureSchema>;
 
-export const BrowserUseProjectConfigurationSchema: JSONSchemaType<BrowserUseProjectConfiguration> = {
-    type: 'object',
-    properties: {
-        enabled: {
-            type: 'boolean',
-            nullable: true,
-            description: 'Enable the browser_use workflow-level tool for this project. Defaults to true.',
-        },
-        default_policy: {
-            type: 'string',
-            nullable: true,
-            enum: ['read_only', 'low_write', 'requires_approval', 'unrestricted'],
-            description: 'Risk policy used when a browser_use call does not specify one. Defaults to low_write.',
-        },
-        max_policy: {
-            type: 'string',
-            nullable: true,
-            enum: ['read_only', 'low_write', 'requires_approval', 'unrestricted'],
-            description: 'Maximum risk policy a browser_use call may request. Defaults to unrestricted.',
-        },
-        allowed_hosts: {
-            type: 'array',
-            nullable: true,
-            items: { type: 'string' },
-            description:
-                'Optional project-wide host allowlist. When present, browser_use calls can only request hosts contained by this list.',
-        },
-        allow_file_uploads: {
-            type: 'boolean',
-            nullable: true,
-            description:
-                'Allow replay scripts to hydrate artifacts/documents as files in the browser sandbox. Defaults to true.',
-        },
-        allow_playwright_scripts: {
-            type: 'boolean',
-            nullable: true,
-            description: 'Allow browser_playwright_script in browser workstreams. Defaults to true.',
-        },
-        capture_screenshots: {
-            type: 'string',
-            nullable: true,
-            enum: ['off', 'on_action', 'each_turn'],
-            description: 'Persist browser screenshots for UI progress. Defaults to on_action.',
-        },
-        prefer_raw_screenshots: {
-            type: 'boolean',
-            nullable: true,
-            description: 'Prefer unannotated screenshots in the browser-use UI widget. Defaults to true.',
-        },
-    },
-    required: [],
-    additionalProperties: false,
-};
+/**
+ * Project defaults and caps for `browser_use` agent workstreams.
+ *
+ * A hand-written `JSONSchemaType<BrowserUseProjectConfiguration>` used to sit here beside the
+ * interface. Nothing read it, and its descriptions had already drifted from the TSDoc the published
+ * component was derived from — the schema module is now the only statement of the shape.
+ */
+export type BrowserUseProjectConfiguration = z.infer<typeof BrowserUseProjectConfigurationSchema>;
 
 // ==========================================
 // Project Configuration
 // ==========================================
 
-export type ProjectSearchTier = 'standard' | 'performance';
-export type ElasticsearchBackend = 'serverless' | 'hosted';
-
-/**
- * Fast pre-conversion type identification (the "sniff") for untyped documents.
- * The sniff classifies a document from cheap local evidence (first/last page text,
- * a low-res first-page image, office docProps) BEFORE any conversion, so a
- * high-confidence match can apply the type's intake policy — including skipping
- * conversion — without paying for it first.
- */
-export interface ProjectIntakeSniffConfiguration {
-    /**
-     * Enable the pre-conversion sniff for untyped documents. Defaults to true.
-     * Can be overridden per run with the `sniffEnabled` workflow var.
-     */
-    enabled?: boolean;
-
-    /**
-     * Confidence at or above which the sniffed type is committed and its full policy applied
-     * (including conversion-skip). 0..1, defaults to 0.85.
-     */
-    high_confidence?: number;
-
-    /**
-     * Confidence at or above which the sniffed type is treated as provisional: the document
-     * still converts and the post-conversion selector confirms on neutral evidence.
-     * 0..1, defaults to 0.6. Below this the sniff result is advisory provenance only.
-     */
-    medium_confidence?: number;
-
-    /**
-     * Minimum page count for the sniff LLM call. Below this, conversion is cheap and full
-     * converted text is better selection evidence, so intake uses the standard
-     * convert-then-select path. Documents with unknown page counts are sniffed.
-     * Defaults to 5; 0 means always sniff.
-     */
-    min_pages?: number;
-}
+export type ProjectSearchTier = z.infer<typeof ProjectSearchTierSchema>;
+export type ElasticsearchBackend = z.infer<typeof ElasticsearchBackendSchema>;
 
-export interface ProjectIntakeConfiguration {
-    /**
-     * Master switch for the standard intake pipeline. When false, StandardIntake exits as a
-     * no-op WITHOUT touching object status (objects stay in `created`, identifiable as
-     * unprocessed). Defaults to true.
-     */
-    enabled?: boolean;
+export type ProjectIntakeSniffConfiguration = z.infer<typeof ProjectIntakeSniffConfigurationSchema>;
 
-    /**
-     * Fast pre-conversion type identification for untyped documents. Absent means enabled
-     * with platform default thresholds.
-     */
-    sniff?: ProjectIntakeSniffConfiguration;
-
-    /**
-     * Project-level intake policy defaults. Same shape as the per-content-type policy; a
-     * type's `intake` block wins field-by-field over these defaults, which in turn win over
-     * the legacy flat fields below. `identification` is type-specific and ignored here.
-     */
-    default_policy?: ContentTypeIntakePolicy;
-
-    /**
-     * Project overrides for the platform vision detail profiles used by intake visual
-     * extraction (`low`/`standard`/`high`). Partial: omitted profiles or fields inherit the
-     * platform defaults. Types reference detail NAMES only; the profile settings live here.
-     */
-    vision_profiles?: Partial<Record<IntakeVisionDetail, Partial<IntakeVisionProfileSettings>>>;
-
-    /**
-     * Generate table-of-content sections during standard document intake.
-     * Defaults to false.
-     */
-    generate_toc?: boolean;
-
-    /**
-     * Skip table-of-content generation when the document text exceeds this many characters.
-     * Avoids sending very large documents through the TOC interactions. Unset means no limit.
-     */
-    generate_toc_max_size?: number;
-
-    /**
-     * Select or assign a content type during standard intake.
-     * Defaults to true.
-     */
-    generate_content_type?: boolean;
-
-    /**
-     * Extract document properties after content type assignment.
-     * Defaults to true.
-     */
-    generate_properties?: boolean;
-
-    /**
-     * Default content type assigned during intake when type selection finds no matching type.
-     * A type id resolvable in this project (a stored `oid:` type, an `app:` type, or a `sys:` type).
-     * Defaults to the platform `sys:GenericDocument` when unset.
-     */
-    default_content_type?: string;
-}
+export type ProjectIntakeConfiguration = z.infer<typeof ProjectIntakeConfigurationSchema>;
 
-export interface ProjectConfiguration {
-    human_context?: string;
+export type ProjectConfiguration = z.infer<typeof ProjectConfigurationSchema>;
 
-    defaults?: ProjectModelDefaults;
+export type AgentProjectConfiguration = z.infer<typeof AgentProjectConfigurationSchema>;
 
-    default_visibility?: ResourceVisibility;
+export type AgentCheckpointConfiguration = z.infer<typeof AgentCheckpointConfigurationSchema>;
 
-    sync_content_properties?: boolean;
+export type ProjectSearchPropertyType = z.infer<typeof ProjectSearchPropertyTypeSchema>;
 
-    embeddings: {
-        text?: ProjectConfigurationEmbedding;
-        image?: ProjectConfigurationEmbedding;
-        properties?: ProjectConfigurationEmbedding;
-    };
-
-    datacenter?: string;
-    storage_bucket?: string;
-
-    /**
-     * Enable real-time streaming of agent LLM responses to clients.
-     * When enabled, LLM responses are streamed chunk-by-chunk via Redis pub/sub.
-     * Defaults to true if not specified.
-     */
-    agent_streaming_enabled?: boolean;
-
-    /**
-     * Indexing configuration for this project.
-     * Controls whether indexing and querying are enabled at the project level.
-     */
-    indexing?: ProjectIndexingConfiguration;
-
-    /**
-     * Standard content intake behavior.
-     */
-    intake?: ProjectIntakeConfiguration;
-
-    /**
-     * Primary language for full-text search analysis.
-     * ISO 639-1 code (e.g., 'en', 'fr', 'ja', 'de').
-     * Determines which Elasticsearch analyzer is used for the text field.
-     * Defaults to 'en' (English/standard analyzer).
-     *
-     * Changing this value requires a full reindex to take effect.
-     */
-    main_language?: string;
-
-    /**
-     * Project defaults and caps for browser_use agent workstreams.
-     */
-    browser_use?: BrowserUseProjectConfiguration;
-
-    /**
-     * Object ID of a content object containing a custom LaTeX template (.latex file)
-     * to use as the branded PDF template. When set, "Export as Branded PDF" uses this
-     * template instead of the built-in Vertesia default template.
-     */
-    pdf_template_object_id?: string;
-}
-
-/**
- * Elasticsearch field types that may be explicitly assigned to content-object
- * properties. Paths are relative to the object's `properties` field.
- */
-export type ProjectSearchPropertyType = 'keyword' | 'text' | 'boolean' | 'long' | 'double' | 'date';
-
-/**
- * Explicit search mapping for one content-object property.
- *
- * Changing a mapping requires a full reindex. Existing Elasticsearch fields
- * cannot change type in place.
- */
-export interface ProjectSearchPropertyMapping {
-    type: ProjectSearchPropertyType;
-
-    /** Elasticsearch date format. Valid only when type is `date`. */
-    format?: string;
-
-    /** Maximum indexed string length. Valid only when type is `keyword`. */
-    ignore_above?: number;
-
-    /**
-     * Skip malformed values instead of rejecting the whole document. Valid only
-     * for long, double, and date mappings.
-     */
-    ignore_malformed?: boolean;
-}
+export type ProjectSearchPropertyMapping = z.infer<typeof ProjectSearchPropertyMappingSchema>;
 
 export const PROJECT_SEARCH_PROPERTY_TYPES: readonly ProjectSearchPropertyType[] = [
     'keyword',
@@ -530,38 +272,7 @@ export function validateProjectSearchPropertyMappings(value: unknown): string[]
     return issues;
 }
 
-export interface ProjectIndexingConfiguration {
-    /**
-     * Enable indexing for content objects in this project.
-     * When enabled, content changes trigger indexing workflows.
-     * Defaults to true - indexing is always on when ES infrastructure is available.
-     */
-    enabled?: boolean;
-
-    /**
-     * Search tier for this project.
-     * standard uses the regional hosted Elasticsearch deployment.
-     * performance uses the regional serverless Elasticsearch project.
-     * Defaults to standard when omitted.
-     */
-    search_tier?: ProjectSearchTier;
-
-    /**
-     * Elasticsearch backend override for this project.
-     * Prefer search_tier for project configuration unless an explicit backend override is needed.
-     */
-    backend?: ElasticsearchBackend;
-
-    /**
-     * Explicit mappings for selected content-object property paths.
-     *
-     * Keys are dot-separated paths relative to `properties`, for example
-     * `order_total` or `customer.account_number`. Unlisted fields are mapped
-     * dynamically from their JSON values. Changing this value requires a full
-     * reindex.
-     */
-    property_mappings?: Record<string, ProjectSearchPropertyMapping>;
-}
+export type ProjectIndexingConfiguration = z.infer<typeof ProjectIndexingConfigurationSchema>;
 
 // export interface ProjectConfigurationEmbeddings {
 //     environment: string;
@@ -587,34 +298,13 @@ export const SearchTypes = {
     ...FullTextType,
 } as const;
 
-export interface ProjectConfigurationEmbedding {
-    environment?: string;
-    enabled: boolean;
-    dimensions?: number;
-    max_tokens?: number;
-    model?: string;
-}
+export type ProjectConfigurationEmbedding = z.infer<typeof ProjectConfigurationEmbeddingSchema>;
 
-export interface ProjectConfigurationEmbeddingEnablePayload {
-    environment: string;
-    max_tokens?: number;
-    model?: string;
-}
+export type ProjectConfigurationEmbeddingEnablePayload = z.infer<
+    typeof ProjectConfigurationEmbeddingEnablePayloadSchema
+>;
 
-export interface Project {
-    id: string;
-    name: string;
-    namespace: string;
-    description?: string;
-    account: string;
-    configuration: ProjectConfiguration;
-    integrations?: Map<string, unknown>;
-    plugins: string[];
-    created_by: string;
-    updated_by: string;
-    created_at: Date;
-    updated_at: Date;
-}
+export type Project = z.infer<typeof ProjectSchema>;
 
 export interface ProjectCreatePayload {
     name: string;
@@ -623,128 +313,18 @@ export interface ProjectCreatePayload {
 
 export interface ProjectUpdatePayload extends Partial<Project> {}
 
-export interface ProjectPluginsUpdatePayload {
-    plugins: string[];
-}
+export type ProjectPluginsUpdatePayload = z.infer<typeof ProjectPluginsUpdatePayloadSchema>;
 
 export const ProjectRefPopulate = 'id name account';
 
-export interface EmbeddingsStatusResponse {
-    status: string;
-    embeddingRunsInProgress?: number;
-    totalIndexableObjects?: number;
-    embeddingsModels?: string[];
-    objectsWithEmbeddings?: number;
-    vectorIndex: {
-        status: 'READY' | 'PENDING' | 'DELETING' | 'ABSENT';
-        name?: string;
-        type?: string;
-    };
-}
+export type EmbeddingsStatusResponse = z.infer<typeof EmbeddingsStatusResponseSchema>;
 
 /**
  * Response from indexing status endpoint
  */
-export interface IndexingStatusResponse {
-    /** Whether indexing infrastructure is available globally */
-    infrastructure_enabled: boolean;
-    /** Whether indexing is enabled for this project */
-    indexing_enabled: boolean;
-    /** @deprecated Now derived from indexing_enabled - queries automatically route to index when indexing is enabled */
-    query_enabled: boolean;
-    /** Resolved Elasticsearch backend serving this project */
-    backend: ElasticsearchBackend;
-    /** Resolved search tier for this project */
-    search_tier: ProjectSearchTier;
-    /** Index status */
-    index: {
-        /** Whether the index exists */
-        exists: boolean;
-        /** Alias name (used for queries) */
-        alias_name: string;
-        /** Actual index name (versioned) */
-        index_name: string;
-        /** Index version (timestamp when created) */
-        version: number;
-        /** When the current index was created */
-        created_at: string | null;
-        /** Number of documents in the index */
-        document_count: number;
-        /** Index size in bytes */
-        size_bytes: number;
-    };
-    /** MongoDB document count for comparison */
-    mongo_document_count: number;
-    /** Whether a reindex is currently in progress */
-    reindex_in_progress: boolean;
-    /** Reindex progress (if reindex is in progress) */
-    reindex_progress?: {
-        /** Total shards to process */
-        total_shards: number;
-        /** Shards completed so far */
-        completed_shards: number;
-        /** Shards that failed */
-        failed_shards: number;
-        /** Current status (e.g., "computing_shards", "indexing", "completed") */
-        status: string;
-        /** Documents scanned from source */
-        scanned: number;
-        /** Documents written to target index */
-        written: number;
-        /** Documents that failed to index */
-        errors: number;
-        /** Embedding vectors written to target index */
-        embeddings_written?: number;
-        /** Embedding vectors skipped because they were invalid or dimension-mismatched */
-        skipped_embeddings?: number;
-        /** Text embedding vectors written to target index */
-        embeddings_text_written?: number;
-        /** Image embedding vectors written to target index */
-        embeddings_image_written?: number;
-        /** Properties embedding vectors written to target index */
-        embeddings_properties_written?: number;
-        /** Text embedding vectors skipped because they were invalid or dimension-mismatched */
-        embeddings_text_skipped?: number;
-        /** Image embedding vectors skipped because they were invalid or dimension-mismatched */
-        embeddings_image_skipped?: number;
-        /** Properties embedding vectors skipped because they were invalid or dimension-mismatched */
-        embeddings_properties_skipped?: number;
-        /** Oversized property string values dropped during transform (size-based pruning) */
-        properties_values_trimmed?: number;
-        /** Total bytes dropped from oversized property values */
-        properties_bytes_dropped?: number;
-        /** Total batcher flushes across all completed shards (cumulative) */
-        batches_flushed?: number;
-        /** Total ES bulk requests sent across all completed shards (cumulative) */
-        bulk_chunks_written?: number;
-        /** Total per-document ES bulk-item failures across all shards (cumulative). Counts docs ES rejected — they aren't in the indexed set. */
-        bulk_errors?: number;
-        /** Average documents per batch flush (written / batches_flushed) — useful to spot under/over-batching */
-        avg_docs_per_batch?: number;
-        /** Average chunks per batch (>1 means bulk_size_bytes cap is splitting batches frequently) */
-        avg_chunks_per_batch?: number;
-        /** Documents processed per second */
-        docs_per_second: number;
-        /** Elapsed time in seconds */
-        elapsed_seconds: number;
-        /** Estimated seconds remaining (null if unknown) */
-        estimated_seconds_remaining: number | null;
-        /** Percentage complete (0-100) */
-        percent_complete: number;
-        /** Source alias */
-        alias: string;
-        /** Target index name */
-        target_index: string;
-    };
-}
+export type IndexingStatusResponse = z.infer<typeof IndexingStatusResponseSchema>;
 
-export interface StartProjectReindexPayload {
-    shard_size?: number;
-    parallel_shard_count?: number;
-    concurrency?: number;
-    bulk_size_bytes?: number;
-    bulk_concurrency?: number;
-}
+export type StartProjectReindexPayload = z.infer<typeof StartProjectReindexPayloadSchema>;
 
 /**
  * Auto-tunes shard sizing based on project doc count.
@@ -786,32 +366,9 @@ export function autoTuneReindexParams(docCount: number): {
     return { shard_size: 250_000, parallel_shard_count: 8, max_shards: 40 };
 }
 
-export interface ReindexAgentRunsPayload {
-    /**
-     * Drop any existing agent-runs index/alias family and recreate the stable concrete index before indexing.
-     * Defaults to true.
-     */
-    recreate_index?: boolean;
-    /** Number of MongoDB records to scan per batch. Defaults to 500. */
-    batch_size?: number;
-    /** Optional cap for partial/manual repair runs. Omit for all agent runs in the project. */
-    limit?: number;
-}
+export type ReindexAgentRunsPayload = z.infer<typeof ReindexAgentRunsPayloadSchema>;
 
-export interface ReindexAgentRunsResponse {
-    status: string;
-    backend: ElasticsearchBackend;
-    index_name: string;
-    recreated: boolean;
-    total: number;
-    scanned: number;
-    indexed: number;
-    failed: number;
-    errors?: Array<{
-        id: string;
-        message: string;
-    }>;
-}
+export type ReindexAgentRunsResponse = z.infer<typeof ReindexAgentRunsResponseSchema>;
 
 // ============================================================================
 // Internal indexing types (used by Temporal workflows)
@@ -1212,41 +769,12 @@ export interface AnalyzeDriftBatchResult {
     sample_stale_ids: string[];
 }
 
-export interface DriftAnalysisProgress {
-    total: number;
-    processed: number;
-    missing: number;
-    stale: number;
-    status: string;
-    current_batch: number;
-    total_batches: number;
-    percent_complete: number;
-    docs_per_second: number;
-    elapsed_seconds: number;
-    estimated_seconds_remaining: number | null;
-}
+export type DriftAnalysisProgress = z.infer<typeof DriftAnalysisProgressSchema>;
 
-export interface DriftAnalysisResult {
-    total: number;
-    processed: number;
-    missing: number;
-    stale: number;
-    sample_missing_ids: string[];
-    sample_stale_ids: string[];
-    completed_at: string;
-}
+export type DriftAnalysisResult = z.infer<typeof DriftAnalysisResultSchema>;
 
-export interface DriftAnalysisStatusResponse extends WorkflowRunStatus {
-    progress?: DriftAnalysisProgress;
-    result?: DriftAnalysisResult;
-    error?: string;
-}
+export type DriftAnalysisStatusResponse = z.infer<typeof DriftAnalysisStatusResponseSchema>;
 
-export interface ProjectIntegrationListEntry {
-    id: SupportedIntegrations;
-    enabled: boolean;
-}
+export type ProjectIntegrationListEntry = z.infer<typeof ProjectIntegrationListEntrySchema>;
 
-export interface ProjectIntegrationListResponse {
-    integrations: ProjectIntegrationListEntry[];
-}
+export type ProjectIntegrationListResponse = z.infer<typeof ProjectIntegrationListResponseSchema>;