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

package/lib/api-schemas/document-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-processing.d.ts","sourceRoot":"","sources":["../../src/api-schemas/document-processing.ts"],"names":[],"mappings":"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"}

package/lib/api-schemas/document-processing.js

@@ -0,0 +1,312 @@
+import { z } from 'zod';
+import { MarkdownRenditionFormat } from '../store/store.js';
+import { WorkflowExecutionStatusValues } from '../store/workflow.js';
+import { InteractionExecutionConfigurationSchema } from './store.js';
+/** Zod's `.nullable()` emits `anyOf`; this annotation preserves the published type-array form. */
+const nullableStringSchema = z.any().meta({ type: ['string', 'null'] });
+export const WorkflowExecutionStatusSchema = z
+    .enum(WorkflowExecutionStatusValues)
+    .meta({ id: 'WorkflowExecutionStatus' });
+export const GroundedAssistantResponseSchema = z
+    .strictObject({
+    agent_run_id: z.string().meta({ description: 'The AgentRun id to stream/render the conversation.' }),
+    workflow_id: z.string().meta({ description: 'The conversation workflow id backing the run.' }),
+    object_id: z.string().meta({ description: 'The object the assistant is scoped to.' }),
+})
+    .meta({
+    id: 'GroundedAssistantResponse',
+    description: 'Response from starting the interactive grounded extraction assistant. The agent run + conversation workflow are launched server-side (recordRun -> stage the document into the agent space -> launch the interactive conversation); the client renders the conversation with `agent_run_id`.',
+});
+export const GroundedExtractionRequestSchema = z
+    .strictObject({
+    schema: z
+        .looseObject({})
+        .meta({ description: 'JSON schema describing the data to extract. Takes precedence over type_ref.' })
+        .optional(),
+    type_ref: z
+        .string()
+        .meta({ description: 'Content type id or catalog ref whose object_schema drives the extraction.' })
+        .optional(),
+    interaction_name: z
+        .string()
+        .meta({ description: 'Interaction to use. Defaults to sys:ExtractInformationGrounded.' })
+        .optional(),
+    max_pages: z.number().meta({ description: 'Maximum number of pages to process.' }).optional(),
+    force_ocr: z.boolean().meta({ description: 'Run OCR on every page even when a text layer exists.' }).optional(),
+    refresh_ocr: z
+        .boolean()
+        .meta({ description: 'Re-run OCR on pages that need it instead of restoring the stored OCR result.' })
+        .optional(),
+    use_vision: z
+        .boolean()
+        .meta({
+        description: 'Attach clean page images for layout/semantic context; direct-vision pages also receive checkerboards.',
+    })
+        .optional(),
+    grid_cell_pt: z
+        .number()
+        .meta({
+        description: 'A1 locate-grid cell size in PDF points for vision pages (drives both the drawn grid and cell→box resolution). Smaller = finer grid / more cells. Default: 14.',
+    })
+        .optional(),
+    raster_mode: z
+        .enum(['vision', 'ocr'])
+        .meta({
+        description: "How to read pages that have no digital text layer (scans / image-only pages). 'vision' (default): read them off the page image with the extraction model, skipping OCR entirely. 'ocr': legacy path — OCR those pages and block-ground on the (lossy) OCR text. Set to 'ocr' to revert to the pre-vision behavior.",
+    })
+        .optional(),
+    window_pages: z
+        .number()
+        .meta({
+        description: 'Maximum pages per extraction call; larger documents are split into sequential windows.',
+    })
+        .optional(),
+    agentic_extraction: z
+        .boolean()
+        .meta({
+        description: 'Extract with an autonomous agent (views the whole document at once) instead of the deterministic windowed pipeline. Sidesteps window-boundary splits on long documents. The workflow stages the artifacts into an agent space, runs a conversation agent that writes the extraction, then folds it back.',
+    })
+        .optional(),
+    extract_agent: z
+        .string()
+        .meta({ description: 'Agent interaction for agentic_extraction. Defaults to sys:GeneralAgent.' })
+        .optional(),
+    update_properties: z
+        .boolean()
+        .meta({ description: "Update the object's properties with the extracted data. Default: true." })
+        .optional(),
+    config: InteractionExecutionConfigurationSchema.meta({
+        description: 'LLM execution configuration (model, environment, ...) for the main pass.',
+    }).optional(),
+    hard_config: InteractionExecutionConfigurationSchema.meta({
+        description: 'Execution configuration used instead of `config` on hard content (scans, handwriting).',
+    }).optional(),
+    hardness_threshold: z
+        .number()
+        .meta({ description: 'Hardness score (0..1) at or above which `hard_config` is used. Default: 0.5.' })
+        .optional(),
+    review_config: InteractionExecutionConfigurationSchema.meta({
+        description: 'Execution configuration for the post-extraction review pass. No review runs when absent.',
+    }).optional(),
+    review_threshold: z
+        .number()
+        .meta({
+        description: 'Hardness score (0..1) at or above which the review runs. Defaults to hardness_threshold.',
+    })
+        .optional(),
+    coverage_review_threshold: z
+        .number()
+        .meta({
+        description: "Review triggers when any page's citation coverage falls below this floor. Default: 0.2.",
+    })
+        .optional(),
+    force_review: z
+        .boolean()
+        .meta({
+        description: 'Run the model review even when every citation was digitally verified. Requires review_config.',
+    })
+        .optional(),
+    operator_instructions: z
+        .string()
+        .meta({
+        description: 'Free-text operator guidance folded into the extraction prompt to steer a (re-)extraction, e.g. "part numbers are in the third column; some line items wrap onto the next row".',
+    })
+        .optional(),
+    user_prompt: z
+        .string()
+        .meta({
+        description: "Interactive assistant only: the operator's opening message for the assistant conversation.",
+    })
+        .optional(),
+})
+    .meta({
+    id: 'GroundedExtractionRequest',
+    description: "Request body to start a grounded extraction on a content object. All fields are optional: with none set, the object's own content-type schema drives the extraction with default models and settings.",
+});
+export const GroundedVerificationBreakdownSchema = z
+    .strictObject({
+    total: z.number().meta({ description: 'Total number of cited values.' }),
+    digitally_verified: z
+        .number()
+        .meta({ description: "Values matched verbatim against the document's text (digital layer or OCR)." }),
+    ai_verified: z.number().meta({ description: 'Values the reviewer model confirmed against the page image.' }),
+    unverified: z
+        .number()
+        .meta({ description: 'Values read from the image but neither text-matched nor reviewer-confirmed.' }),
+})
+    .meta({
+    id: 'GroundedVerificationBreakdown',
+    description: "How each extracted value was verified. Two kinds, both trustworthy: digitally verified (matched the document's text — digital layer or OCR) and AI verified (the reviewer confirmed it against the page image — the primary signal for scanned or handwritten content, which has no text layer to match).",
+});
+export const GroundedExtractionVerdictSchema = z.enum(['good_to_go', 'needs_review']).meta({
+    id: 'GroundedExtractionVerdict',
+    description: 'Document-level trust verdict for a grounded extraction. `good_to_go` means the extracted content (after any review corrections) can be used without a human check; `needs_review` means a human should verify it. This reflects content correctness, not how many citation boxes rendered.',
+});
+export const DocProcessorOutputFormatSchema = z
+    .literal('markdown')
+    .meta({ id: 'DocProcessorOutputFormat', description: 'Output format for document processing workflows' });
+export const DocAnalyzerProgressStatusSchema = z
+    .strictObject({
+    total: z.number(),
+    processed: z.number(),
+    success: z.number(),
+    failed: z.number(),
+})
+    .meta({ id: 'DocAnalyzerProgressStatus' });
+export const DocumentProcessingPhaseSchema = z
+    .enum(['markdown', 'grounded_extraction'])
+    .meta({ id: 'DocumentProcessingPhase' });
+export const DocumentPrepOptionsSchema = z
+    .object({
+    features: z.array(z.string()).optional(),
+    debug: z.boolean().optional(),
+    output_format: DocProcessorOutputFormatSchema.optional(),
+})
+    .catchall(z.unknown())
+    .meta({ id: 'DocumentPrepOptions' });
+export const GroundedExtractionResultResponseSchema = z
+    .strictObject({
+    object_id: z.string(),
+    data: z.looseObject({}).meta({ description: 'The extracted data, shaped by the requested schema.' }),
+    verdict: GroundedExtractionVerdictSchema.meta({ description: 'Document-level trust verdict.' }).optional(),
+    verdict_reason: z.string().meta({ description: 'One-sentence rationale for the verdict.' }).optional(),
+    confidence: z.number().meta({ description: 'Mean citation confidence in [0,1].' }).optional(),
+    verification: GroundedVerificationBreakdownSchema.meta({ description: 'Per-value verification breakdown.' }),
+    review: z
+        .strictObject({
+        assessment: z.enum(['complete', 'issues_found']),
+        summary: z.string().optional(),
+        corrections_applied: z.number().optional(),
+    })
+        .meta({ description: 'Review outcome, when a review pass ran.' })
+        .optional(),
+    result_url: nullableStringSchema
+        .meta({
+        description: 'Signed download URL for the full grounded-extraction.json (data + citations + boxes).',
+    })
+        .optional(),
+})
+    .meta({
+    id: 'GroundedExtractionResultResponse',
+    description: 'Completed grounded extraction result: the extracted data with its trust verdict and verification breakdown, plus a download URL for the full citations artifact.',
+});
+export const DocAnalyzerProgressSchema = z
+    .strictObject({
+    phase: DocumentProcessingPhaseSchema.optional(),
+    pages: DocAnalyzerProgressStatusSchema,
+    images: DocAnalyzerProgressStatusSchema,
+    tables: DocAnalyzerProgressStatusSchema,
+    visuals: DocAnalyzerProgressStatusSchema,
+    started_at: z.number().optional(),
+    percent: z.number(),
+    output_format: DocProcessorOutputFormatSchema.meta({
+        description: 'The output format being used for processing.',
+    }).optional(),
+})
+    .meta({ id: 'DocAnalyzerProgress' });
+export const DocAnalyzeRunStatusResponseSchema = z
+    .strictObject({
+    workflow_id: nullableStringSchema,
+    workflow_run_id: nullableStringSchema,
+    status: WorkflowExecutionStatusSchema,
+    phase: DocumentProcessingPhaseSchema.optional(),
+    progress: DocAnalyzerProgressSchema.optional(),
+    output_format: DocProcessorOutputFormatSchema.meta({
+        description: 'The output format being used for processing.',
+    }).optional(),
+})
+    .meta({ id: 'DocAnalyzeRunStatusResponse', description: 'Represents a document analysis run status' });
+export const MarkdownRenditionFormatSchema = z.enum(MarkdownRenditionFormat).meta({ id: 'MarkdownRenditionFormat' });
+export const PdfRenderingMetadataSchema = z
+    .strictObject({
+    document_id: z.string().meta({ description: 'Document ID to display in footer' }).optional(),
+    agent_name: z.string().meta({ description: 'Agent name that generated the document' }).optional(),
+    agent_run_id: z.string().meta({ description: 'Agent run ID to display in footer' }).optional(),
+    subtitle: z.string().meta({ description: 'Document subtitle' }).optional(),
+    author: z.array(z.string()).meta({ description: 'Document author(s)' }).optional(),
+    date: z
+        .string()
+        .meta({ description: 'Document date (displayed in header and title page; defaults to today if omitted)' })
+        .optional(),
+})
+    .meta({ id: 'PdfRenderingMetadata', description: 'Metadata for PDF rendering (displayed in header/footer)' });
+export const RenderMarkdownPayloadSchema = z
+    .strictObject({
+    format: MarkdownRenditionFormatSchema.meta({ description: 'Output format' }),
+    object_id: z.string().meta({ description: 'Object ID to render (mutually exclusive with content)' }).optional(),
+    content: z
+        .string()
+        .meta({ description: 'Inline markdown content to render (mutually exclusive with object_id)' })
+        .optional(),
+    title: z
+        .string()
+        .meta({ description: 'Document title (used for filename when using inline content)' })
+        .optional(),
+    template_url: z
+        .string()
+        .meta({ description: 'URL to a template file for pandoc (DOCX reference doc or LaTeX template)' })
+        .optional(),
+    template_logo_url: z
+        .string()
+        .meta({ description: 'Optional logo URL for template variable `logo-path` (studio-hosted URL)' })
+        .optional(),
+    template_path: z
+        .string()
+        .meta({ description: 'Template file via artifact:/store: protocol (takes precedence over template_url)' })
+        .optional(),
+    logo_path: z
+        .string()
+        .meta({ description: 'Logo file via artifact:/store: protocol (takes precedence over template_logo_url)' })
+        .optional(),
+    use_default_template: z
+        .boolean()
+        .meta({ description: 'Use Vertesia default template if no template_url provided (default: true for pdf)' })
+        .optional(),
+    pandoc_options: z.array(z.string()).meta({ description: 'Additional pandoc command-line options' }).optional(),
+    artifact_run_id: z.string().meta({ description: 'Run ID for resolving artifact: and image: URLs' }).optional(),
+    metadata: PdfRenderingMetadataSchema.meta({
+        description: 'Document metadata for PDF footer/header',
+    }).optional(),
+    template_data_source: z
+        .string()
+        .meta({
+        description: 'Source reference for auto-wired template data: `store:<objectId>` or `artifact:<path-to-json>`',
+    })
+        .optional(),
+    output_path: z.string().meta({ description: 'Custom upload path for the rendered output' }).optional(),
+})
+    .meta({
+    id: 'RenderMarkdownPayload',
+    description: 'Payload for rendering markdown to PDF or DOCX. Either object_id OR content must be provided.',
+});
+export const RenderMarkdownStartResponseSchema = z
+    .strictObject({
+    workflow_id: nullableStringSchema,
+    workflow_run_id: nullableStringSchema,
+    status: WorkflowExecutionStatusSchema,
+    format: MarkdownRenditionFormatSchema.meta({ description: 'Requested output format' }),
+})
+    .meta({
+    id: 'RenderMarkdownStartResponse',
+    description: 'Initial response when starting a markdown rendering workflow. Clients should poll status using workflow_id/workflow_run_id.',
+});
+export const RenderMarkdownStatusResponseSchema = z
+    .strictObject({
+    workflow_id: nullableStringSchema,
+    workflow_run_id: nullableStringSchema,
+    status: WorkflowExecutionStatusSchema,
+    format: MarkdownRenditionFormatSchema.meta({ description: 'Requested output format (if known)' }).optional(),
+    download_url: z.string().meta({ description: 'Download URL for completed output' }).optional(),
+    file_uri: z.string().meta({ description: 'File URI in storage for completed output' }).optional(),
+    error: z.string().meta({ description: 'Error details for failed/terminated runs' }).optional(),
+})
+    .meta({
+    id: 'RenderMarkdownStatusResponse',
+    description: 'Polled status response for markdown rendering workflow.',
+});
+/** Query components validate declared fields without rejecting unrelated query parameters. */
+export const RenderMarkdownStatusQuerySchema = z.looseObject({
+    workflow_id: z.string(),
+    workflow_run_id: z.string(),
+});
+//# sourceMappingURL=document-processing.js.map

package/lib/api-schemas/document-processing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-processing.js","sourceRoot":"","sources":["../../src/api-schemas/document-processing.ts"],"names":[],"mappings":"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"}

package/lib/api-schemas/embeddings.d.ts

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+/**
+ * The request half of `POST /environments/:envId/embeddings`.
+ *
+ * The result half is llumiverse's — vectors and counts are already JSON, so `EmbeddingsResult` is
+ * the same object on both sides. The request is not: a driver consumes a `DataSource`, which is a
+ * stream, so the wire format carries a URL or base64 text instead and the server wraps it before
+ * handing the request on.
+ */
+export declare const EmbeddingsApiSourceSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    base64: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const EmbeddingsApiTextInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    task_type: z.ZodOptional<z.ZodEnum<{
+        query: "query";
+        document: "document";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const EmbeddingsApiImageInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const EmbeddingsApiVideoInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"video">;
+    source: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    start_sec: z.ZodOptional<z.ZodNumber>;
+    length_sec: z.ZodOptional<z.ZodNumber>;
+    interval_sec: z.ZodOptional<z.ZodNumber>;
+    use_fixed_length_sec: z.ZodOptional<z.ZodBoolean>;
+    min_clip_sec: z.ZodOptional<z.ZodNumber>;
+    embedding_option: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "visual-text": "visual-text";
+        "visual-image": "visual-image";
+        audio: "audio";
+    }>>>;
+}, z.core.$strict>;
+export declare const EmbeddingsApiAudioInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    source: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    start_sec: z.ZodOptional<z.ZodNumber>;
+    length_sec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const EmbeddingsApiInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    task_type: z.ZodOptional<z.ZodEnum<{
+        query: "query";
+        document: "document";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"video">;
+    source: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    start_sec: z.ZodOptional<z.ZodNumber>;
+    length_sec: z.ZodOptional<z.ZodNumber>;
+    interval_sec: z.ZodOptional<z.ZodNumber>;
+    use_fixed_length_sec: z.ZodOptional<z.ZodBoolean>;
+    min_clip_sec: z.ZodOptional<z.ZodNumber>;
+    embedding_option: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "visual-text": "visual-text";
+        "visual-image": "visual-image";
+        audio: "audio";
+    }>>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    source: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        base64: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    start_sec: z.ZodOptional<z.ZodNumber>;
+    length_sec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>], "type">;
+export declare const EmbeddingsApiRequestSchema: z.ZodObject<{
+    inputs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        task_type: z.ZodOptional<z.ZodEnum<{
+            query: "query";
+            document: "document";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        source: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            mime_type: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            base64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"video">;
+        source: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            mime_type: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            base64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        start_sec: z.ZodOptional<z.ZodNumber>;
+        length_sec: z.ZodOptional<z.ZodNumber>;
+        interval_sec: z.ZodOptional<z.ZodNumber>;
+        use_fixed_length_sec: z.ZodOptional<z.ZodBoolean>;
+        min_clip_sec: z.ZodOptional<z.ZodNumber>;
+        embedding_option: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "visual-text": "visual-text";
+            "visual-image": "visual-image";
+            audio: "audio";
+        }>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        source: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            mime_type: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            base64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        start_sec: z.ZodOptional<z.ZodNumber>;
+        length_sec: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>], "type">>;
+    model: z.ZodOptional<z.ZodString>;
+    task_type: z.ZodOptional<z.ZodEnum<{
+        query: "query";
+        document: "document";
+    }>>;
+    dimensions: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const EmbeddingsStatusResponseSchema: z.ZodObject<{
+    status: z.ZodString;
+    embeddingRunsInProgress: z.ZodOptional<z.ZodNumber>;
+    totalIndexableObjects: z.ZodOptional<z.ZodNumber>;
+    embeddingsModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    objectsWithEmbeddings: z.ZodOptional<z.ZodNumber>;
+    vectorIndex: z.ZodObject<{
+        status: z.ZodEnum<{
+            PENDING: "PENDING";
+            READY: "READY";
+            DELETING: "DELETING";
+            ABSENT: "ABSENT";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const ProjectConfigurationEmbeddingEnablePayloadSchema: z.ZodObject<{
+    environment: z.ZodString;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+//# sourceMappingURL=embeddings.d.ts.map

package/lib/api-schemas/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/api-schemas/embeddings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AAEH,eAAO,MAAM,yBAAyB;;;;;kBAcE,CAAC;AAEzC,eAAO,MAAM,4BAA4B;;;;;;;;kBAOE,CAAC;AAE5C,eAAO,MAAM,6BAA6B;;;;;;;;kBAKE,CAAC;AAE7C,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;kBAWE,CAAC;AAE7C,eAAO,MAAM,6BAA6B;;;;;;;;;;kBAOE,CAAC;AAE7C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAc/B,CAAC;AAEP,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOE,CAAC;AAE1C,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;kBAaE,CAAC;AAE9C,eAAO,MAAM,gDAAgD;;;;kBAME,CAAC"}

package/lib/api-schemas/embeddings.js

@@ -0,0 +1,102 @@
+import { EmbeddingTaskTypeSchema } from '@llumiverse/common/schemas';
+import { z } from 'zod';
+/**
+ * The request half of `POST /environments/:envId/embeddings`.
+ *
+ * The result half is llumiverse's — vectors and counts are already JSON, so `EmbeddingsResult` is
+ * the same object on both sides. The request is not: a driver consumes a `DataSource`, which is a
+ * stream, so the wire format carries a URL or base64 text instead and the server wraps it before
+ * handing the request on.
+ */
+export const EmbeddingsApiSourceSchema = z
+    .strictObject({
+    name: z.string().meta({ description: 'Display name for the source (defaults to "embedding-input").' }),
+    mime_type: z.string().meta({ description: 'MIME type of the binary content. Required for most providers.' }),
+    url: z.string().meta({
+        description: 'Provider-native URL the driver may pass through directly:\n' +
+            '- gs:// or https://storage.googleapis.com/ for Vertex AI\n' +
+            '- s3:// or https://*.amazonaws.com for Bedrock\n' +
+            '- https:// for fetch fallback Mutually exclusive with base64.',
+    }),
+    base64: z.string().meta({ description: 'Base64-encoded bytes. Mutually exclusive with url.' }),
+})
+    .partial()
+    .meta({ id: 'EmbeddingsApiSource' });
+export const EmbeddingsApiTextInputSchema = z
+    .strictObject({
+    type: z.literal('text'),
+    text: z.string(),
+    task_type: EmbeddingTaskTypeSchema.optional(),
+    title: z.string().optional(),
+})
+    .meta({ id: 'EmbeddingsApiTextInput' });
+export const EmbeddingsApiImageInputSchema = z
+    .strictObject({
+    type: z.literal('image'),
+    source: EmbeddingsApiSourceSchema,
+})
+    .meta({ id: 'EmbeddingsApiImageInput' });
+export const EmbeddingsApiVideoInputSchema = z
+    .strictObject({
+    type: z.literal('video'),
+    source: EmbeddingsApiSourceSchema,
+    start_sec: z.number().optional(),
+    length_sec: z.number().optional(),
+    interval_sec: z.number().optional(),
+    use_fixed_length_sec: z.boolean().optional(),
+    min_clip_sec: z.number().optional(),
+    embedding_option: z.array(z.enum(['visual-text', 'visual-image', 'audio'])).optional(),
+})
+    .meta({ id: 'EmbeddingsApiVideoInput' });
+export const EmbeddingsApiAudioInputSchema = z
+    .strictObject({
+    type: z.literal('audio'),
+    source: EmbeddingsApiSourceSchema,
+    start_sec: z.number().optional(),
+    length_sec: z.number().optional(),
+})
+    .meta({ id: 'EmbeddingsApiAudioInput' });
+export const EmbeddingsApiInputSchema = z
+    .discriminatedUnion('type', [
+    EmbeddingsApiTextInputSchema,
+    EmbeddingsApiImageInputSchema,
+    EmbeddingsApiVideoInputSchema,
+    EmbeddingsApiAudioInputSchema,
+])
+    .meta({
+    id: 'EmbeddingsApiInput',
+    description: 'Wire-format inputs accepted by the studio-server embeddings endpoint. Mirror of ' +
+        "@llumiverse/common's EmbeddingInput, but binary modalities carry a JSON-friendly source " +
+        '(URL or base64) instead of a DataSource. The server wraps each source in a ' +
+        'Base64DataSource or URLDataSource before passing the request to the llumiverse driver.',
+});
+export const EmbeddingsApiRequestSchema = z
+    .strictObject({
+    inputs: z.array(EmbeddingsApiInputSchema),
+    model: z.string().optional(),
+    task_type: EmbeddingTaskTypeSchema.optional(),
+    dimensions: z.number().optional(),
+})
+    .meta({ id: 'EmbeddingsApiRequest' });
+export const EmbeddingsStatusResponseSchema = z
+    .strictObject({
+    status: z.string(),
+    embeddingRunsInProgress: z.number().optional(),
+    totalIndexableObjects: z.number().optional(),
+    embeddingsModels: z.array(z.string()).optional(),
+    objectsWithEmbeddings: z.number().optional(),
+    vectorIndex: z.strictObject({
+        status: z.enum(['READY', 'PENDING', 'DELETING', 'ABSENT']),
+        name: z.string().optional(),
+        type: z.string().optional(),
+    }),
+})
+    .meta({ id: 'EmbeddingsStatusResponse' });
+export const ProjectConfigurationEmbeddingEnablePayloadSchema = z
+    .strictObject({
+    environment: z.string(),
+    max_tokens: z.number().optional(),
+    model: z.string().optional(),
+})
+    .meta({ id: 'ProjectConfigurationEmbeddingEnablePayload' });
+//# sourceMappingURL=embeddings.js.map

package/lib/api-schemas/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/api-schemas/embeddings.ts"],"names":[],"mappings":"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"}