@vertesia/common 1.5.0-dev.20260725.083715Z → 1.5.0-dev.20260806.125520Z

package/lib/store/store.d.ts

@@ -1,10 +1,12 @@
-import type { JSONSchemaType } from 'ajv';
-import type { ComputedFacetResponse } from '../facets.js';
-import type { InteractionExecutionConfiguration } from '../interaction.js';
+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 { 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 { 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 { SearchPayload } from '../payload.js';
 import type { SupportedEmbeddingTypes } from '../project.js';
-import type { ComplexSearchQuery } from '../query.js';
 import type { BaseObject } from './common.js';
 export declare enum ContentObjectApiHeaders {
     COLLECTION_ID = "x-collection-id",
@@ -16,35 +18,11 @@ export declare enum ContentObjectApiHeaders {
      */
     SUPPRESS_WORKFLOWS = "x-suppress-workflows"
 }
-export interface CreateContentObjectQuery {
-    collection_id?: string;
-    processing_priority?: ContentObjectProcessingPriority;
-}
-export interface CreateContentObjectHeaders {
-    'x-collection-id'?: string;
-    'x-processing-priority'?: ContentObjectProcessingPriority;
-}
-export interface UpdateContentObjectQuery {
-    create_revision?: boolean;
-    revision_label?: string;
-    processing_priority?: ContentObjectProcessingPriority;
-}
-export interface UpdateContentObjectHeaders {
-    'if-match'?: string;
-    'x-create-revision'?: boolean;
-    'x-revision-label'?: string;
-    'x-processing-priority'?: ContentObjectProcessingPriority;
-    /**
-     * @deprecated Events are now always emitted. This suppresses the Temporal-backed delivery targets (workflow, agent, and process) — webhook deliveries still fire.
-     */
-    'x-suppress-workflows'?: boolean;
-}
-export interface GetObjectRenditionQuery {
-    block_on_generation?: boolean;
-    generate_if_missing?: boolean;
-    max_hw?: number;
-    sign_url?: boolean;
-}
+export type CreateContentObjectQuery = z.infer<typeof CreateContentObjectQuerySchema>;
+export type CreateContentObjectHeaders = z.infer<typeof CreateContentObjectHeadersSchema>;
+export type UpdateContentObjectQuery = z.infer<typeof UpdateContentObjectQuerySchema>;
+export type UpdateContentObjectHeaders = z.infer<typeof UpdateContentObjectHeadersSchema>;
+export type GetObjectRenditionQuery = z.infer<typeof GetObjectRenditionQuerySchema>;
 /**
  * Headers for Data Store API calls.
  * Used for Cloud Run session affinity to route requests to the same instance.
@@ -61,50 +39,9 @@ export declare enum ContentObjectStatus {
     failed = "failed",
     archived = "archived"
 }
-export interface Embedding {
-    model: string;
-    values: number[];
-    etag?: string;
-}
-/**
- * Optional object context to include in content object export rows.
- */
-export interface ExportContentObjectsIncludeOptions {
-    /**
-     * Include stored embeddings. Disabled by default for generic object exports.
-     */
-    embeddings?: boolean;
-    /**
-     * Include content source metadata. Enabled by default.
-     */
-    content?: boolean;
-    /**
-     * Include object lifecycle status. Enabled by default.
-     */
-    status?: boolean;
-    /**
-     * Include object properties. Enabled by default.
-     */
-    properties?: boolean;
-    /**
-     * Include technical object metadata. Disabled by default because metadata may be large.
-     */
-    metadata?: boolean;
-    /**
-     * Include object revision details. Enabled by default.
-     */
-    revision?: boolean;
-}
-/**
- * Bounded filters supported by the bulk content object export API.
- */
-export interface ExportContentObjectsFilter {
-    types?: string[];
-    created_from?: string;
-    created_to?: string;
-    updated_from?: string;
-    updated_to?: string;
-}
+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.
  */
@@ -133,33 +70,8 @@ export interface ExportedContentObjectRecord {
     metadata?: Record<string, unknown>;
     embeddings?: Partial<Record<SupportedEmbeddingTypes, Embedding>>;
 }
-export interface StartContentObjectExportRequest {
-    /**
-     * Embedding types to export when include.embeddings is true. Defaults to all supported embedding types.
-     */
-    embedding_types?: SupportedEmbeddingTypes[];
-    /**
-     * Explicit export filters. This intentionally does not accept the search API's full Mongo/search DSL.
-     */
-    filter?: ExportContentObjectsFilter;
-    /**
-     * Include all revisions. Defaults to false, exporting only head revisions.
-     */
-    all_revisions?: boolean;
-    /**
-     * Optional object context selectors.
-     */
-    include?: ExportContentObjectsIncludeOptions;
-    /**
-     * Compress the export with gzip. Defaults to true.
-     */
-    compression?: boolean;
-}
-export interface StartContentObjectExportResponse {
-    workflow_id: string;
-    run_id: string;
-    export_id: string;
-}
+export type StartContentObjectExportRequest = z.infer<typeof StartContentObjectExportRequestSchema>;
+export type StartContentObjectExportResponse = z.infer<typeof StartContentObjectExportResponseSchema>;
 export interface ZenoBulkContentObjectExportRequest extends Omit<StartContentObjectExportRequest, 'compression'> {
     tenant_id: string;
     project_id: string;
@@ -216,131 +128,22 @@ export interface ZenoBulkContentObjectExportComposeRequest extends ZenoBulkConte
      */
     started_at?: string;
 }
-export interface ContentObjectExportResult {
-    status: 'completed';
-    path: string;
-    filename: string;
-    content_type: string;
-    manifest_path?: string;
-    manifest_filename?: string;
-    manifest_content_type?: string;
-    manifest_bytes?: number;
-    records: number;
-    bytes: number;
-    started_at: string;
-    completed_at: string;
-    duration_ms: number;
-}
-export interface ContentObjectExportProgress {
-    status: 'queued' | 'planning' | 'exporting' | 'composing' | 'completed' | 'failed';
-    records: number;
-    bytes: number;
-    path?: string;
-    filename?: string;
-    completed_shards?: number;
-    total_shards?: number;
-    started_at?: string;
-    completed_at?: string;
-    error?: string;
-}
-export interface ContentObjectExportStatusResponse {
-    workflow_id: string;
-    run_id: string;
-    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled' | 'terminated' | 'timed_out' | 'unknown';
-    done: boolean;
-    progress?: ContentObjectExportProgress;
-    result?: ContentObjectExportResult;
-    error?: string;
-}
-export interface ContentObjectExportArtifact {
-    export_id: string;
-    path: string;
-    filename: string;
-    content_type: string;
-    bytes: number;
-    created_at?: string;
-    files?: ContentObjectExportArtifactFile[];
-}
-export interface ContentObjectExportArtifactFile {
-    role: 'data' | 'manifest';
-    path: string;
-    filename: string;
-    content_type: string;
-    bytes: number;
-}
-export interface ListContentObjectExportsResponse {
-    items: ContentObjectExportArtifact[];
-    limit: number;
-}
-export interface DeleteContentObjectExportResponse {
-    success: boolean;
-    export_id: string;
-    path: string;
-}
-/**
- * Metadata about a single inherited property.
- */
-export interface InheritedPropertyMetadata {
-    /** The property name that was inherited */
-    name: string;
-    /** The collection ID that provided this property */
-    collection: string;
-}
-/**
- * Computed per-request permissions for the current user on a content object.
- * Not stored in the database — computed on the fly by the API from the object's security field.
- */
-export interface ContentObjectUserPermissions {
-    can_write: boolean;
-    can_delete: boolean;
-}
-export interface ContentObjectTextResponse {
-    text?: string;
-}
-export interface DeleteContentObjectResult {
-    id: string;
-    count: number;
-}
-export interface SetObjectEmbeddingsResponse {
-    type?: Embedding;
-}
-export type ContentObjectApiTypeRef = ContentObjectTypeRef;
-export interface ContentObjectApiRevision {
-    parent?: string;
-    root: string;
-    head: boolean;
-    label?: string;
-}
-export interface ContentObjectItemApiResponse extends BaseObject {
-    parent?: string;
-    location: string;
-    status: ContentObjectStatus;
-    type?: ContentObjectApiTypeRef;
-    content?: ContentSource;
-    external_id?: string;
-    properties: JSONObject;
-    metadata?: Record<string, unknown>;
-    tokens?: {
-        count?: number;
-        encoding?: string;
-        etag?: string;
-    };
-    revision: ContentObjectApiRevision;
-    is_deleted?: boolean;
-    is_locked?: boolean;
-    score?: number;
-    user_permissions?: ContentObjectUserPermissions;
-}
-export interface ContentObjectApiResponse extends ContentObjectItemApiResponse {
-    text?: string;
-    text_etag?: string;
-    embeddings?: Record<string, Embedding>;
-    parts?: string[];
-    parts_etag?: string;
-    transcript?: Record<string, unknown>;
-    security?: Record<string, string[]>;
-    inherited_properties?: InheritedPropertyMetadata[];
-}
+export type ContentObjectExportResult = z.infer<typeof ContentObjectExportResultSchema>;
+export type ContentObjectExportProgress = z.infer<typeof ContentObjectExportProgressSchema>;
+export type ContentObjectExportStatusResponse = z.infer<typeof ContentObjectExportStatusResponseSchema>;
+export type ContentObjectExportArtifact = z.infer<typeof ContentObjectExportArtifactSchema>;
+export type ContentObjectExportArtifactFile = z.infer<typeof ContentObjectExportArtifactFileSchema>;
+export type ListContentObjectExportsResponse = z.infer<typeof ListContentObjectExportsResponseSchema>;
+export type DeleteContentObjectExportResponse = z.infer<typeof DeleteContentObjectExportResponseSchema>;
+export type InheritedPropertyMetadata = z.infer<typeof InheritedPropertyMetadataSchema>;
+export type ContentObjectUserPermissions = z.infer<typeof ContentObjectUserPermissionsSchema>;
+export type ContentObjectTextResponse = z.infer<typeof ContentObjectTextResponseSchema>;
+export type DeleteContentObjectResult = z.infer<typeof DeleteContentObjectResultSchema>;
+export type SetObjectEmbeddingsResponse = z.infer<typeof SetObjectEmbeddingsResponseSchema>;
+export type ContentObjectApiTypeRef = z.infer<typeof ContentObjectApiTypeRefSchema>;
+export type ContentObjectApiRevision = z.infer<typeof ContentObjectApiRevisionSchema>;
+export type ContentObjectItemApiResponse = z.infer<typeof ContentObjectItemApiResponseSchema>;
+export type ContentObjectApiResponse = z.infer<typeof ContentObjectApiResponseSchema>;
 export interface ContentObject<T = JSONObject> extends ContentObjectItem<T> {
     text?: string;
     text_etag?: string;
@@ -375,18 +178,7 @@ export interface Location {
     latitude: number;
     longitude: number;
 }
-export interface GenerationRunMetadata {
-    id: string;
-    date: string;
-    model: string;
-    target?: string;
-    /**
-     * Fingerprint of the inputs used by property extraction (content etag, type + its object
-     * schema, source, instructions, interaction). Lets a later run skip re-extraction when
-     * nothing changed.
-     */
-    extraction_fingerprint?: string;
-}
+export type GenerationRunMetadata = z.infer<typeof GenerationRunMetadataSchema>;
 export interface Rendition {
     name: string;
     content: ContentSource;
@@ -546,13 +338,9 @@ export interface GroundedMetadata {
     source_text_etag?: string | null;
     [key: string]: unknown;
 }
-export interface Transcript {
-    text?: string;
-    segments?: TranscriptSegment[];
-    etag?: string;
-}
+export type Transcript = z.infer<typeof TranscriptSchema>;
 export declare const TextExtractionStatus: {
-    readonly success: "success";
+    readonly success: 'success';
 };
 export interface TranscriptMediaResult {
     hasText: boolean;
@@ -560,33 +348,9 @@ export interface TranscriptMediaResult {
     message?: string;
     gladiaTranscriptionId?: string;
 }
-export interface TranscriptSegment {
-    start: number;
-    text: string;
-    speaker?: number;
-    end?: number;
-    confidence?: number;
-    language?: string;
-}
-export interface ContentSource {
-    source?: string;
-    type?: string;
-    name?: string;
-    etag?: string;
-}
-/**
- *
- */
-export interface RevisionInfo {
-    /** Direct parent revision id (omit on the first revision) */
-    parent?: string;
-    /** The root revision id (omit on the first revision) */
-    root: string;
-    /** True if this revision is the head revision */
-    head: boolean;
-    /** Human‑friendly tag or state ("v1.2", "approved") */
-    label?: string;
-}
+export type TranscriptSegment = z.infer<typeof TranscriptSegmentSchema>;
+export type ContentSource = z.infer<typeof ContentSourceSchema>;
+export type RevisionInfo = z.infer<typeof RevisionInfoSchema>;
 /**
  * The content object item is a simplified version of the ContentObject that is returned by the store API when listing objects.
  */
@@ -648,14 +412,12 @@ export interface ContentObjectItem<T = JSONObject> extends BaseObject {
      */
     user_permissions?: ContentObjectUserPermissions;
 }
-/**
- * When creating from an uploaded file the content should be an URL to the uploaded file
- */
-export interface CreateContentObjectPayload<T = JSONObject> extends Partial<Omit<ContentObject<T>, 'id' | 'root' | 'created_at' | 'updated_at' | 'type' | 'owner'>> {
-    id?: string;
-    type?: string;
-    generation_run_info?: GenerationRunMetadata;
-}
+type CreateContentObjectPayloadWire = z.infer<typeof CreateContentObjectPayloadSchema>;
+export type CreateContentObjectPayload<T = JSONObject> = Omit<CreateContentObjectPayloadWire, 'properties' | 'metadata'> & {
+    properties?: T;
+    /** 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;
@@ -664,81 +426,21 @@ type LegacyContentObjectTypeRef = Partial<ContentObjectTypeRef> & {
 };
 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>;
+export type ContentObjectTypeStatus = z.infer<typeof ContentObjectTypeStatusSchema>;
+export type IntakeVisionDetail = z.infer<typeof IntakeVisionDetailSchema>;
+export type IntakePageScope = z.infer<typeof IntakePageScopeSchema>;
 /**
- * Reference to a content object type. `id` is the canonical identifier for both
- * stored and in-code types.
- */
-/**
- * @discriminator ref_type
- */
-export type ContentObjectTypeRef = StoredTypeRef | InCodeTypeRef;
-interface StoredTypeRef {
-    ref_type: 'stored';
-    /**
-     * MongoDB ObjectId string for stored types
-     */
-    id: string;
-    name: string;
-    /**
-     * Display hint from the type's intake policy (`intake.default_view`). Enriched by the
-     * API on single-object reads so clients can pick the initial view without fetching the
-     * type. Absent on list responses and older servers.
-     */
-    default_view?: ContentTypeIntakePolicy['default_view'];
-}
-interface InCodeTypeRef {
-    ref_type: 'incode';
-    /**
-     * Namespaced identifier for in-code types (e.g. "sys:Invoice", "app:myapp:Contract")
-     */
-    id: string;
-    name: string;
-    /**
-     * Display hint from the type's intake policy (`intake.default_view`). Enriched by the
-     * API on single-object reads so clients can pick the initial view without fetching the
-     * type. Absent on list responses and older servers.
-     */
-    default_view?: ContentTypeIntakePolicy['default_view'];
-}
-export interface ComplexSearchPayload extends Omit<SearchPayload, 'query'> {
-    query?: ComplexSearchQuery;
-}
-export interface ColumnLayout {
-    /**
-     * The path of the field to use (e.g. "properties.title")
-     */
-    field: string;
-    /**
-     * The name to display in the table column
-     */
-    name: string;
-    /**
-     * The type of the field specifies how the rendering will be done. If not specified the string type will be used.
-     * The type may contain additional parameters prepended using a web-like query string syntax: date?LLL
-     */
-    type?: string;
-    fallback?: string;
-    /**
-     * A default value to be used if the field is not present in the object
-     */
-    default?: unknown;
-}
-export type ContentObjectTypeStatus = 'active' | 'draft';
-/** Vision detail level names referenced by intake policies. The rendering profiles behind the
- * names (dpi, max size, quality, color mode) are PLATFORM-defined and project-overridable —
- * a type only ever references a detail name. */
-export type IntakeVisionDetail = 'low' | 'standard' | 'high';
-/**
- * Named page scope for intake conversion/extraction: everything or the locate-pass result.
- * Static page ranges live in the sibling `page_ranges` field (which wins when set) — kept as
- * a SEPARATE field because scalar-or-collection unions generate unstable API clients.
- */
-export type IntakePageScope = 'all' | 'located';
-/**
- * Static page ranges: inclusive [start, end] pairs; negative indexes count from the end of
- * the document ([[1, 2], [-1, -1]] = first two pages plus the last page).
+ * Inclusive `[start, end]` pairs.
+ *
+ * Inferred as `number[][]` rather than the `[number, number][]` this used to declare: the published
+ * component is a uniform-items array with `minItems`/`maxItems`, which is what the scanner made of the
+ * tuple, and reproducing it is what keeps the generated clients unchanged. The length is still
+ * enforced at runtime.
  */
-export type IntakePageRanges = [number, number][];
+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 {
@@ -751,195 +453,14 @@ export interface IntakeVisionProfileSettings {
     /** grayscale renders gray always; auto keeps color when the plan asks for it. */
     color_mode: 'grayscale' | 'auto';
 }
-export interface ContentTypeExtractionGroundingReviewPolicy {
-    /** Set false to disable an inherited grounding review pass for this type. */
-    enabled?: boolean;
-    /** Model execution configuration for the review interaction. */
-    config?: InteractionExecutionConfiguration;
-    /** Hardness score at or above which review runs. Defaults to hardness_threshold. */
-    threshold?: number;
-    /**
-     * Review also runs when any page's citation coverage falls below this
-     * floor (evidence of missed content). Default 0.2.
-     */
-    coverage_threshold?: number;
-    /** Run review regardless of hardness. */
-    force?: boolean;
-}
-export interface ContentTypeExtractionGroundingPolicy {
-    /** Enable PDF block-level citation grounding for property extraction. */
-    enabled?: boolean;
-    /** Grounded extraction interaction. Defaults to the system grounded extractor. */
-    interaction?: string;
-    /** Maximum pages to process. */
-    max_pages?: number;
-    /** Run OCR on every page even when a text layer exists. */
-    force_ocr?: boolean;
-    /** Attach instrumented page images to the grounded extraction prompt. */
-    use_vision?: boolean;
-    /**
-     * How to read pages with no digital text layer (scans / image-only pages).
-     * 'vision' (default): read them off the page image and skip OCR. 'ocr': legacy
-     * path — OCR those pages and block-ground on the (lossy) OCR text.
-     */
-    raster_mode?: 'vision' | 'ocr';
-    /**
-     * A1 locate-grid cell size in PDF points for vision pages. Smaller = finer grid
-     * (more cells, tighter boxes) but can trip weaker models into over-reading;
-     * tune per the model in `config`. Default 15.
-     */
-    grid_cell_pt?: number;
-    /**
-     * Drop block bounding boxes from the extraction prompt. Only sound with
-     * use_vision (layout comes from the image).
-     */
-    omit_block_boxes?: boolean;
-    /** Maximum pages per grounded extraction call before windowing. */
-    window_pages?: number;
-    /** Update object properties with grounded extraction data. Default true. */
-    update_properties?: boolean;
-    /** Model execution configuration for the main grounded extraction interaction. */
-    config?: InteractionExecutionConfiguration;
-    /** Model execution configuration used for hard-to-read content. */
-    hard_config?: InteractionExecutionConfiguration;
-    /** Hardness score at or above which hard_config is used. Default 0.5. */
-    hardness_threshold?: number;
-    /**
-     * Minimum citations-per-leaf-value ratio; completions below it retry with
-     * escalation. Default 0.3.
-     */
-    min_citation_density?: number;
-    /** Re-run OCR instead of restoring durable OCR artifacts (stale pipeline output). */
-    refresh_ocr?: boolean;
-    /** Optional post-extraction review pass. */
-    review?: ContentTypeExtractionGroundingReviewPolicy;
-}
-/**
- * Per-content-type policy for the standard intake workflows.
- */
-export interface ContentTypeIntakePolicy {
-    /** Intake orchestration mode for this type. */
-    mode?: 'programmatic' | 'agentic';
-    /** Guidance used when selecting or creating this content type. */
-    identification?: {
-        guidance?: string;
-        distinguish_from?: string;
-        examples?: string[];
-    };
-    /**
-     * Document-map ("locate") pass: page thumbnails tiled into labeled contact sheets, one
-     * vision call returns which pages matter for THIS type. The result can scope conversion
-     * and extraction, and doubles as the vision planner for visual extraction.
-     */
-    locate?: {
-        /** What to look for ("commercial terms, payment schedule, signature pages"). */
-        instructions: string;
-        /** Pages per contact sheet: 8 = bigger tiles (headings readable). Default 16. */
-        detail?: 8 | 16;
-        /** Only run when the page count is at least this. Default 8. */
-        min_pages?: number;
-    };
-    /** Controls source-to-text conversion before extraction and embedding. */
-    text_conversion?: {
-        enabled?: boolean;
-        method?: 'auto' | 'basic' | 'llm' | 'custom';
-        custom?: {
-            interaction?: string;
-            agent?: string;
-        };
-        instructions?: string;
-        output_format?: 'markdown' | 'text';
-        /** Which pages to convert: everything or the locate result. Default all. */
-        scope?: IntakePageScope;
-        /** Static page ranges to convert (wins over `scope` when set). */
-        page_ranges?: IntakePageRanges;
-    };
-    /** Controls schema-property extraction after type assignment. */
-    extraction?: {
-        enabled?: boolean;
-        source?: 'auto' | 'text' | 'vision' | 'mixed';
-        instructions?: string;
-        interaction?: string;
-        /** Which pages extraction sees: everything or the locate result. */
-        scope?: IntakePageScope;
-        /** Static page ranges extraction sees (wins over `scope` when set). */
-        page_ranges?: IntakePageRanges;
-        /** Cap on pages sent to extraction. Default 20. */
-        max_pages?: number;
-        /** Vision evidence budget for visual extraction. Detail names reference platform
-         * profiles; the type never defines dpi/quality/resolution. */
-        vision?: {
-            default_detail?: IntakeVisionDetail;
-            allowed_details?: IntakeVisionDetail[];
-            /** PRIMARY budget: estimated image tokens per extraction call. Default 16000. */
-            max_image_tokens?: number;
-            /** Transport guard in megabytes. Default 16. */
-            max_payload_mb?: number;
-            /** Cap on page images per extraction call. Default 8. */
-            max_pages_per_call?: number;
-        };
-        verification?: {
-            enabled?: boolean;
-            model?: string;
-            environment?: string;
-            materiality?: string;
-            threshold?: number;
-            max_retries?: number;
-            on_fail?: 'flag' | 'block';
-        };
-        /** Controls PDF block-level citation grounding with annotated proof output. */
-        grounding?: ContentTypeExtractionGroundingPolicy;
-    };
-    /** Handlebars template used to materialize extracted properties into object text. */
-    rendering_template?: string;
-    /** Per-type embedding switches. Unspecified values inherit the project policy. */
-    embeddings?: Partial<Record<SupportedEmbeddingTypes, boolean>>;
-    /** Whether intake should generate a table of contents for matching documents. */
-    generate_toc?: boolean;
-    /** Preferred first view for objects of this type. */
-    default_view?: 'auto' | 'text' | 'pdf' | 'image' | 'properties';
-}
-/** Per-content-type policy for collaborative document editing. */
-export interface ContentTypeEditingPolicy {
-    /** Agent interaction used for new document-editing sessions. Defaults to sys:GeneralAgent. */
-    interaction?: string;
-}
-export declare const ContentTypeEditingPolicySchema: JSONSchemaType<ContentTypeEditingPolicy>;
-/** JSON schema for validating ContentTypeIntakePolicy payloads at API/tool boundaries.
- * NOTE: typed via a cast because AJV's strict `JSONSchemaType` mapping cannot express the
- * `[number, number]` pair items of `page_ranges` as a uniform-items array. The runtime
- * schema is compiled (and thus validated) by every consumer and by the schema-acceptance
- * unit test in packages/workflows. */
-export declare const ContentTypeIntakePolicySchema: JSONSchemaType<ContentTypeIntakePolicy>;
-export interface ContentObjectType extends ContentObjectTypeItem {
-}
-export interface ContentObjectTypeItem extends BaseObject {
-    status?: ContentObjectTypeStatus;
-    is_chunkable?: boolean;
-    intake?: ContentTypeIntakePolicy;
-    editing?: ContentTypeEditingPolicy;
-    /**
-     * This is only included in ContentObjectTypeItem if explicitly requested
-     * It is always included in ContentObjectType
-     */
-    table_layout?: ColumnLayout[];
-    /**
-     * this is only included in ContentObjectTypeItem if explicitly requested
-     * It is always included in ContentObjectType
-     */
-    object_schema?: Record<string, unknown>;
-    /**
-     * Determines if the content will be validated against the object schema a generation time and save/update time.
-     */
-    strict_mode?: boolean;
-}
-export type InCodeTypeDefinition = Pick<ContentObjectTypeItem, 'id' | 'name' | 'description' | 'tags' | 'object_schema' | 'table_layout' | 'is_chunkable' | 'strict_mode' | 'status' | 'intake' | 'editing'>;
-export interface ContentObjectTypeCatalogEntry extends InCodeTypeDefinition {
-    updated_by?: string;
-    created_by?: string;
-    created_at?: string;
-    updated_at?: string;
-}
+export type ContentTypeExtractionGroundingReviewPolicy = z.infer<typeof ContentTypeExtractionGroundingReviewPolicySchema>;
+export type ContentTypeExtractionGroundingPolicy = z.infer<typeof ContentTypeExtractionGroundingPolicySchema>;
+export type ContentTypeIntakePolicy = z.infer<typeof ContentTypeIntakePolicySchema>;
+export type ContentTypeEditingPolicy = z.infer<typeof ContentTypeEditingPolicySchema>;
+export type ContentObjectType = z.infer<typeof ContentObjectTypeSchema>;
+export type ContentObjectTypeItem = z.infer<typeof ContentObjectTypeItemSchema>;
+export type InCodeTypeDefinition = z.infer<typeof InCodeTypeDefinitionSchema>;
+export type ContentObjectTypeCatalogEntry = z.infer<typeof ContentObjectTypeCatalogEntrySchema>;
 /**
  * The itnerface to be used whend efining types in a plugin app.
  */
@@ -950,50 +471,16 @@ export type InCodeTypeSpec = Omit<InCodeTypeDefinition, 'id'>;
  * These types are read-only and cannot be edited through the UI.
  */
 export declare function isInCodeType(typeId: string): boolean;
-export interface CreateContentObjectTypePayload extends Omit<ContentObjectType, 'id' | 'created_at' | 'updated_at' | 'created_by' | 'updated_by'> {
-}
+export type CreateContentObjectTypePayload = z.infer<typeof CreateContentObjectTypePayloadSchema>;
+export type UpdateContentObjectTypePayload = z.infer<typeof UpdateContentObjectTypePayloadSchema>;
 export declare enum WorkflowRuleInputType {
     single = "single",
     multiple = "multiple",
     none = "none"
 }
-export interface WorkflowRuleItem extends BaseObject {
-    endpoint: string;
-    input_type: WorkflowRuleInputType;
-}
-export interface WorkflowRule extends WorkflowRuleItem {
-    match?: Record<string, unknown>;
-    /**
-     * Activities configuration if any.
-     */
-    config?: Record<string, unknown>;
-    /**
-     * Debug mode for the rule
-     * @default false
-     */
-    debug?: boolean;
-    /**
-     * Customer override for the rule
-     * When set to true the rule will not be updated by the system
-     */
-    customer_override?: boolean;
-    /**
-     * Optional task queue name to use when starting workflows for this rule
-     */
-    task_queue?: string;
-    /**
-     * Event subscription migration status for legacy workflow-rule cutover.
-     */
-    event_subscription_migration_status?: 'migrated' | 'unsupported_match' | 'failed';
-    /**
-     * Migration failure or unsupported-match reason, when applicable.
-     */
-    event_subscription_migration_error?: string;
-}
-export interface CreateWorkflowRulePayload extends UploadWorkflowRulePayload {
-    name: string;
-    endpoint: string;
-}
+export type WorkflowRuleItem = z.infer<typeof WorkflowRuleItemSchema>;
+export type WorkflowRule = z.infer<typeof WorkflowRuleSchema>;
+export type CreateWorkflowRulePayload = z.infer<typeof CreateWorkflowRulePayloadSchema>;
 export interface UploadWorkflowRulePayload extends Partial<Omit<WorkflowRule, 'id' | 'created_at' | 'updated_at' | 'owner'>> {
 }
 export declare enum ImageRenditionFormat {
@@ -1001,10 +488,11 @@ export declare enum ImageRenditionFormat {
     png = "png",
     webp = "webp"
 }
-export declare enum MarkdownRenditionFormat {
-    docx = "docx",
-    pdf = "pdf"
-}
+export declare const MarkdownRenditionFormat: {
+    readonly docx: 'docx';
+    readonly pdf: 'pdf';
+};
+export type MarkdownRenditionFormat = z.infer<typeof MarkdownRenditionFormatSchema>;
 export interface GetRenditionParams {
     format: ImageRenditionFormat | MarkdownRenditionFormat;
     max_hw?: number;
@@ -1012,16 +500,8 @@ export interface GetRenditionParams {
     sign_url?: boolean;
     block_on_generation?: boolean;
 }
-export interface GetRenditionResponse {
-    status: 'found' | 'generating' | 'failed';
-    renditions?: string[];
-    workflow_run_id?: string;
-}
-export interface ObjectSearchResponse {
-    results: ContentObjectItemApiResponse[];
-    facets: ComputedFacetResponse;
-    aggregations?: Record<string, unknown>;
-}
+export type GetRenditionResponse = z.infer<typeof GetRenditionResponseSchema>;
+export type ObjectSearchResponse = z.infer<typeof ObjectSearchResponseSchema>;
 export type RenditionFormat = ImageRenditionFormat | MarkdownRenditionFormat;
 /**
  * Check if a specific rendition format can be generated from a content type.
@@ -1061,109 +541,27 @@ export declare function getSupportedRenditionFormats(contentType: string | undef
  * supportsVisualRendition('text/markdown') // false
  */
 export declare function supportsVisualRendition(contentType: string | undefined): boolean;
-export interface GetUploadUrlPayload {
-    name: string;
-    id?: string;
-    mime_type?: string;
-    ttl?: number;
-}
-export interface GetFileUrlPayload {
-    file: string;
-    name?: string;
-    disposition?: 'inline' | 'attachment';
-}
-export interface GetFileUrlResponse {
-    url: string;
-    id: string;
-    mime_type?: string;
-    path: string;
-}
-export interface EnsureBucketReadAccessPayload {
-    principal: string;
-}
-export interface EnsureBucketReadAccessResponse {
-    bucket: string;
-    principal: string;
-    granted: boolean;
-}
-export interface BucketReadAccessStatusResponse {
-    bucket: string;
-    principal: string;
-    hasAccess: boolean;
-}
-export interface FileMetadataResponse {
-    name: string;
-    size: number;
-    contentType: string;
-    contentDisposition?: string;
-    etag?: string;
-    customMetadata?: Record<string, string>;
-}
-export interface SetFileMetadataPayload {
-    /** The file path (relative to bucket) or full URI */
-    file: string;
-    /** Custom metadata key-value pairs to set on the file */
-    metadata: Record<string, string>;
-}
-export interface FileMetadataUpdateResult {
-    success: boolean;
-    file: string;
-}
-export interface BulkUploadUrlsPayload {
-    files: {
-        name: string;
-        mime_type?: string;
-        id?: string;
-    }[];
-}
-export interface BulkUploadUrlsResponse {
-    files: GetFileUrlResponse[];
-}
-export interface FileBucketResponse {
-    bucket: string;
-}
-export interface FileListResponse {
-    files: string[];
-}
-export interface FileMetadataQuery {
-    file: string;
-}
-export interface FileListQuery {
-    prefix: string;
-}
-export interface FileDeleteQuery {
-    prefix?: boolean;
-}
-export interface ContentObjectTypeCatalogQuery {
-    tag?: string;
-    layout?: boolean;
-    schema?: boolean;
-    limit?: number;
-    offset?: number;
-}
-export interface ContentObjectTypeListQuery {
-    name?: string;
-    chunkable?: boolean;
-    layout?: boolean;
-    schema?: boolean;
-    limit?: number;
-    offset?: number;
-}
-export interface CopyFilePayload {
-    source: string;
-    dest: string;
-}
-export interface CopyFileResponse {
-    success: boolean;
-    source: string;
-    dest: string;
-}
-export interface DeleteFileResult {
-    success: boolean;
-    count: number;
-    message?: string;
-    file?: string;
-}
+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 FileMetadataResponse = z.infer<typeof FileMetadataResponseSchema>;
+export type SetFileMetadataPayload = z.infer<typeof SetFileMetadataPayloadSchema>;
+export type FileMetadataUpdateResult = z.infer<typeof FileMetadataUpdateResultSchema>;
+export type BulkUploadUrlsPayload = z.infer<typeof BulkUploadUrlsPayloadSchema>;
+export type BulkUploadUrlsResponse = z.infer<typeof BulkUploadUrlsResponseSchema>;
+export type FileBucketResponse = z.infer<typeof FileBucketResponseSchema>;
+export type FileListResponse = z.infer<typeof FileListResponseSchema>;
+export type FileMetadataQuery = z.infer<typeof FileMetadataQuerySchema>;
+export type FileListQuery = z.infer<typeof FileListQuerySchema>;
+export type FileDeleteQuery = z.infer<typeof FileDeleteQuerySchema>;
+export type ContentObjectTypeCatalogQuery = z.infer<typeof ContentObjectTypeCatalogQuerySchema>;
+export type ContentObjectTypeListQuery = z.infer<typeof ContentObjectTypeListQuerySchema>;
+export type CopyFilePayload = z.infer<typeof CopyFilePayloadSchema>;
+export type CopyFileResponse = z.infer<typeof CopyFileResponseSchema>;
+export type DeleteFileResult = z.infer<typeof DeleteFileResultSchema>;
 export declare enum ContentObjectProcessingPriority {
     normal = "normal",
     low = "low"