mixpeek 0.81.1

package/dist/models/stage-defs-aggregation-operation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { AggregationFunction } from './aggregation-function';
+/**
+ * Configuration for a single aggregation operation.  Defines what function to apply and on which field(s).  Examples:     Count documents:         ```json         {\"function\": \"count\", \"alias\": \"total\"}         ```      Sum a numeric field:         ```json         {\"function\": \"sum\", \"field\": \"metadata.views\", \"alias\": \"total_views\"}         ```      Count distinct values:         ```json         {\"function\": \"count_distinct\", \"field\": \"metadata.author\", \"alias\": \"unique_authors\"}         ```
+ * @export
+ * @interface StageDefsAggregationOperation
+ */
+export interface StageDefsAggregationOperation {
+    /**
+     * REQUIRED. Aggregation function to apply. count/count_distinct: Count documents or unique values. sum/avg/min/max: Numeric aggregations on a field. first/last: Get first or last value (by score order). collect/collect_distinct: Gather values into a list.
+     * @type {AggregationFunction}
+     * @memberof StageDefsAggregationOperation
+     */
+    'function': AggregationFunction;
+    /**
+     * OPTIONAL. Field path to aggregate (dot notation supported). Required for: sum, avg, min, max, count_distinct, first, last, collect, collect_distinct. Not needed for: count (counts documents). Examples: \'score\', \'metadata.views\', \'payload.price\'.
+     * @type {string}
+     * @memberof StageDefsAggregationOperation
+     */
+    'field'?: string;
+    /**
+     * REQUIRED. Name for this aggregation result in the output. Must be unique within the stage configuration. Used as the key in the aggregation results.
+     * @type {string}
+     * @memberof StageDefsAggregationOperation
+     */
+    'alias': string;
+}
+//# sourceMappingURL=stage-defs-aggregation-operation.d.ts.map

package/dist/models/stage-defs-aggregation-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-aggregation-operation.d.ts","sourceRoot":"","sources":["../../models/stage-defs-aggregation-operation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC1C;;;;OAIG;IACH,UAAU,EAAE,mBAAmB,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB"}

package/dist/models/stage-defs-auth-config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { AuthType } from './auth-type';
+/**
+ * Authentication configuration for API calls.  Defines how to authenticate with external APIs using credentials stored in the organization secrets vault. Credentials are NEVER stored in the stage configuration - only references to vault secrets.  **⚠️ CRITICAL SECURITY WARNINGS**: - NEVER store actual credentials in configuration - ALWAYS use secret_ref to reference vault secrets - Credentials are encrypted at rest in vault - Decrypted values never appear in logs or API responses  **How It Works**: 1. Store secret via: POST /v1/organizations/secrets 2. Reference secret via: auth.secret_ref in stage config 3. At runtime: Secret is retrieved, decrypted, and injected into request 4. Security: Original secret value never exposed or logged  **Requirements**: - type: REQUIRED, authentication method (none, api_key, bearer, basic, custom_header) - secret_ref: REQUIRED (except for type=none), name of secret in vault - key: REQUIRED (for api_key and custom_header types), header/query param name - location: OPTIONAL (for api_key type), \'header\' or \'query\' (default: header)  **Supported Authentication Types**: - Bearer tokens (OAuth 2.0, JWT): Most modern APIs - API keys: Weather APIs, Maps, etc. - Basic auth: Legacy systems - Custom headers: Non-standard auth schemes
+ * @export
+ * @interface StageDefsAuthConfig
+ */
+export interface StageDefsAuthConfig {
+    /**
+     * REQUIRED. Authentication method to use. Options: none (public API), api_key (API keys), bearer (OAuth/JWT), basic (HTTP Basic Auth), custom_header (non-standard headers). See AuthType enum for detailed description of each type.
+     * @type {AuthType}
+     * @memberof StageDefsAuthConfig
+     */
+    'type'?: AuthType;
+    /**
+     * REQUIRED (except for type=none). Name of secret in organization vault. The secret must be created first via POST /v1/organizations/secrets. Format: Use the exact secret_name from vault (e.g., \'stripe_api_key\'). At runtime, the secret value is securely retrieved and decrypted. The decrypted value is then injected into the request per auth type. SECURITY: NEVER store actual credentials here - only the reference name. Examples: \'stripe_api_key\', \'github_pat\', \'weather_api_key\'
+     * @type {string}
+     * @memberof StageDefsAuthConfig
+     */
+    'secret_ref'?: string;
+    /**
+     * OPTIONAL (for api_key type only). Where to inject the API key. Options: \'header\' (recommended, more secure) or \'query\' (less secure). Default: \'header\' if not specified. Query parameters appear in URLs and logs - use headers when possible. Ignored for other auth types (bearer, basic, custom_header).
+     * @type {string}
+     * @memberof StageDefsAuthConfig
+     */
+    'location'?: string;
+    /**
+     * REQUIRED (for api_key and custom_header types). Header name or query parameter name for authentication. For api_key with location=header: Header name like \'X-API-Key\', \'Authorization\'. For api_key with location=query: Query param like \'apikey\', \'api_key\', \'key\'. For custom_header: Any custom header name like \'X-Custom-Auth\', \'X-Token\'. Ignored for bearer and basic types (use standard headers). Common patterns: \'X-API-Key\', \'Authorization\', \'X-Auth-Token\'
+     * @type {string}
+     * @memberof StageDefsAuthConfig
+     */
+    'key'?: string;
+}
+//# sourceMappingURL=stage-defs-auth-config.d.ts.map

package/dist/models/stage-defs-auth-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-auth-config.d.ts","sourceRoot":"","sources":["../../models/stage-defs-auth-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/models/stage-defs-auth-type.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Authentication type for API calls.  Defines how credentials from the organization secrets vault should be injected into HTTP requests for authentication with external APIs.  Values:     NONE: No authentication (public APIs)      API_KEY: API key in header or query parameter         - Use for APIs that require API keys (Weather API, Maps, etc.)         - Header location recommended for security         - Requires: secret_ref, key, location         - Example: X-API-Key: abc123      BEARER: Bearer token authentication (OAuth 2.0, JWT)         - Use for APIs using Bearer tokens (GitHub, OpenAI, most modern APIs)         - Adds: Authorization: Bearer {secret_value}         - Requires: secret_ref         - Example: Authorization: Bearer ghp_abc123      BASIC: HTTP Basic authentication         - Use for APIs using Basic Auth (legacy systems)         - Secret format: \"username:password\"         - Adds: Authorization: Basic {base64(username:password)}         - Requires: secret_ref         - Example: Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=      CUSTOM_HEADER: Custom header with arbitrary name         - Use for APIs with non-standard auth headers         - Adds: {key}: {secret_value}         - Requires: secret_ref, key         - Example: X-Custom-Auth: token123  Examples:     - Bearer token for GitHub API: type=\"bearer\"     - API key for Weather API: type=\"api_key\", location=\"query\"     - Basic auth for legacy API: type=\"basic\"     - Custom header: type=\"custom_header\", key=\"X-Custom-Token\"
+ * @export
+ * @enum {string}
+ */
+export declare const StageDefsAuthType: {
+    readonly None: "none";
+    readonly ApiKey: "api_key";
+    readonly Bearer: "bearer";
+    readonly Basic: "basic";
+    readonly CustomHeader: "custom_header";
+};
+export type StageDefsAuthType = typeof StageDefsAuthType[keyof typeof StageDefsAuthType];
+//# sourceMappingURL=stage-defs-auth-type.d.ts.map

package/dist/models/stage-defs-auth-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-auth-type.d.ts","sourceRoot":"","sources":["../../models/stage-defs-auth-type.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/models/stage-defs-citation-config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Configuration for citation/source tracking in RAG output.  Citations help users trace information back to source documents and are essential for attribution in RAG applications.
+ * @export
+ * @interface StageDefsCitationConfig
+ */
+export interface StageDefsCitationConfig {
+    /**
+     * Citation style to use: - \'numbered\': [1], [2], [3] - \'bracketed\': [doc_id] - \'footnote\': Superscript numbers - \'none\': No citations
+     * @type {string}
+     * @memberof StageDefsCitationConfig
+     */
+    'style'?: StageDefsCitationConfigStyleEnum;
+    /**
+     * Include document title in citation metadata.
+     * @type {boolean}
+     * @memberof StageDefsCitationConfig
+     */
+    'include_title'?: boolean;
+    /**
+     * Include source URL in citation metadata if available.
+     * @type {boolean}
+     * @memberof StageDefsCitationConfig
+     */
+    'include_url'?: boolean;
+}
+export declare const StageDefsCitationConfigStyleEnum: {
+    readonly Numbered: "numbered";
+    readonly Bracketed: "bracketed";
+    readonly Footnote: "footnote";
+    readonly None: "none";
+};
+export type StageDefsCitationConfigStyleEnum = typeof StageDefsCitationConfigStyleEnum[keyof typeof StageDefsCitationConfigStyleEnum];
+//# sourceMappingURL=stage-defs-citation-config.d.ts.map

package/dist/models/stage-defs-citation-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-citation-config.d.ts","sourceRoot":"","sources":["../../models/stage-defs-citation-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,gCAAgC,CAAC;IAC3C;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,gCAAgC;;;;;CAKnC,CAAC;AAEX,MAAM,MAAM,gCAAgC,GAAG,OAAO,gCAAgC,CAAC,MAAM,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/models/stage-defs-content-input.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Generic content input for automatic content-type detection.  Used for URL or base64 inputs where the content type is not known upfront. The system will automatically detect the content type (image, video, text, etc.) and route to the appropriate feature extractor.  **IMPORTANT**: Exactly one of `url` or `base64` must be provided (mutually exclusive).  Use Cases:     - User provides a URL without specifying content type     - Client sends base64-encoded content     - Generic search where query can be any modality  Requirements:     - Provide exactly ONE: url OR base64 (mutually exclusive)     - System performs automatic content type detection     - Supported content types: images, videos, audio, documents  Examples:     URL input:         ```json         {\"url\": \"https://example.com/image.jpg\"}         ```      Base64 image input:         ```json         {\"base64\": \"data:image/jpeg;base64,/9j/4AAQSkZJRg...\"}         ```      Base64 video input:         ```json         {\"base64\": \"data:video/mp4;base64,AAAAIGZ0eXBpc2...\"}         ```
+ * @export
+ * @interface StageDefsContentInput
+ */
+export interface StageDefsContentInput {
+    /**
+     * OPTIONAL. URL to content for embedding generation. Mutually exclusive with base64 - provide exactly one. System will automatically detect content type (image, video, text, etc.) via HTTP HEAD request and/or file extension analysis. Supported protocols: HTTP, HTTPS, S3 (for Mixpeek-managed buckets). S3 URLs must point to the configured AWS_BUCKET. NOTE: For multimodal embeddings, URL-based inputs may fail if the upstream embedding provider cannot fetch the URL (e.g., geo-restrictions, rate limiting, redirects). Consider using the base64 field instead for more reliable results.
+     * @type {string}
+     * @memberof StageDefsContentInput
+     */
+    'url'?: string;
+    /**
+     * OPTIONAL. Base64-encoded content for embedding generation (RECOMMENDED for multimodal embeddings). Mutually exclusive with url - provide exactly one. Must include data URI scheme (data:mime/type;base64,...) for reliable MIME detection. System will automatically detect content type from data URI prefix. Supported types: images (image/jpeg, image/png), videos (video/mp4), audio, documents. Maximum size: Limited by your namespace configuration.
+     * @type {string}
+     * @memberof StageDefsContentInput
+     */
+    'base64'?: string;
+}
+//# sourceMappingURL=stage-defs-content-input.d.ts.map

package/dist/models/stage-defs-content-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-content-input.d.ts","sourceRoot":"","sources":["../../models/stage-defs-content-input.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/models/stage-defs-content-query-input.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { ContentInput } from './content-input';
+import type { Value1 } from './value1';
+/**
+ * Content-based query input with automatic format detection.  System auto-detects content format: - data:mime/type;base64,... → decoded as base64 data URI (RECOMMENDED) - http://, https://, s3:// → fetched as URL - Otherwise → treated as raw base64 string  **IMPORTANT - Base64 Data URIs Are Recommended for Reliability:** When using multimodal embeddings (e.g., Vertex AI multimodal), base64 data URIs (``data:image/jpeg;base64,...``) are the most reliable input format. Direct HTTP URLs may fail if the upstream embedding provider cannot fetch them (e.g., due to geo-restrictions, rate limiting, authentication requirements, or redirects). For best results, fetch the image/video client-side and send a base64 data URI.  Use Cases:     - Visual search with image/video content     - Reverse image search     - Multimodal search with content     - Template-based content queries  Examples:     Base64 data URI (RECOMMENDED - most reliable):         ```json         {\"input_mode\": \"content\", \"value\": \"data:image/jpeg;base64,/9j/...\"}         ```      Image URL (may fail if provider cannot fetch the URL):         ```json         {\"input_mode\": \"content\", \"value\": \"https://example.com/image.jpg\"}         ```      Template-based:         ```json         {\"input_mode\": \"content\", \"value\": \"{{INPUT.image_url}}\"}         ```      Legacy syntax (backward compatible):         ```json         {\"input_mode\": \"content\", \"content\": {\"url\": \"https://...\"}}         ```
+ * @export
+ * @interface StageDefsContentQueryInput
+ */
+export interface StageDefsContentQueryInput {
+    /**
+     * Discriminator field. Always \'content\' for content-based queries.
+     * @type {string}
+     * @memberof StageDefsContentQueryInput
+     */
+    'input_mode'?: StageDefsContentQueryInputInputModeEnum;
+    /**
+     *
+     * @type {Value1}
+     * @memberof StageDefsContentQueryInput
+     */
+    'value'?: Value1;
+    /**
+     * Legacy content input (DEPRECATED - use \'value\' instead). Provide URL or base64 separately via ContentInput model.
+     * @type {ContentInput}
+     * @memberof StageDefsContentQueryInput
+     */
+    'content'?: ContentInput;
+}
+export declare const StageDefsContentQueryInputInputModeEnum: {
+    readonly Content: "content";
+};
+export type StageDefsContentQueryInputInputModeEnum = typeof StageDefsContentQueryInputInputModeEnum[keyof typeof StageDefsContentQueryInputInputModeEnum];
+//# sourceMappingURL=stage-defs-content-query-input.d.ts.map

package/dist/models/stage-defs-content-query-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-content-query-input.d.ts","sourceRoot":"","sources":["../../models/stage-defs-content-query-input.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,uCAAuC,CAAC;IACvD;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,uCAAuC;;CAE1C,CAAC;AAEX,MAAM,MAAM,uCAAuC,GAAG,OAAO,uCAAuC,CAAC,MAAM,OAAO,uCAAuC,CAAC,CAAC"}

package/dist/models/stage-defs-diversity-feature-config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Configuration for a single feature used in multi-feature diversity computation.  When using multi-feature diversity mode, you can specify multiple embedding spaces and weight their contribution to the overall diversity score.  Example:     Combine text and image embeddings with different weights:     ```python     features = [         DiversityFeatureConfig(             feature_uri=\"mixpeek://text_extractor@v1/multilingual_e5_large_instruct_v1\",             weight=0.6         ),         DiversityFeatureConfig(             feature_uri=\"mixpeek://clip@v1/image_embedding\",             weight=0.4         )     ]     ```
+ * @export
+ * @interface StageDefsDiversityFeatureConfig
+ */
+export interface StageDefsDiversityFeatureConfig {
+    /**
+     * REQUIRED. Feature URI specifying which embedding to use for diversity. Format: \'mixpeek://extractor@version/output\'. The embedding must exist on documents from the previous stage. Use state.context to find available embeddings from feature_search.
+     * @type {string}
+     * @memberof StageDefsDiversityFeatureConfig
+     */
+    'feature_uri': string;
+    /**
+     * OPTIONAL. Weight for this feature\'s contribution to diversity score. Weights across all features are normalized to sum to 1.0. Higher weight = more influence on diversity computation.
+     * @type {number}
+     * @memberof StageDefsDiversityFeatureConfig
+     */
+    'weight'?: number;
+}
+//# sourceMappingURL=stage-defs-diversity-feature-config.d.ts.map

package/dist/models/stage-defs-diversity-feature-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-diversity-feature-config.d.ts","sourceRoot":"","sources":["../../models/stage-defs-diversity-feature-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC5C;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/models/stage-defs-document-query-input.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { DocumentReference } from './document-reference';
+/**
+ * Document reference query input for similarity search.  Use existing document\'s pre-computed features without re-processing. Perfect for \"find similar documents\" functionality. No inference is performed.  Use Cases:     - Find similar documents     - Reverse image search using indexed images     - Document-to-document similarity     - Multi-hop similarity chains  Examples:     Simple document reference:         ```json         {             \"input_mode\": \"document\",             \"document_ref\": {                 \"collection_id\": \"col_products\",                 \"document_id\": \"doc_item_123\"             }         }         ```
+ * @export
+ * @interface StageDefsDocumentQueryInput
+ */
+export interface StageDefsDocumentQueryInput {
+    /**
+     * Discriminator field. Always \'document\' for document reference queries.
+     * @type {string}
+     * @memberof StageDefsDocumentQueryInput
+     */
+    'input_mode'?: StageDefsDocumentQueryInputInputModeEnum;
+    /**
+     * Reference to existing document\'s pre-computed features. The system fetches the document\'s feature vectors for the specified feature_uri and uses them directly without re-processing. Document must exist and have features for the specified feature_uri.
+     * @type {DocumentReference}
+     * @memberof StageDefsDocumentQueryInput
+     */
+    'document_ref': DocumentReference;
+}
+export declare const StageDefsDocumentQueryInputInputModeEnum: {
+    readonly Document: "document";
+};
+export type StageDefsDocumentQueryInputInputModeEnum = typeof StageDefsDocumentQueryInputInputModeEnum[keyof typeof StageDefsDocumentQueryInputInputModeEnum];
+//# sourceMappingURL=stage-defs-document-query-input.d.ts.map

package/dist/models/stage-defs-document-query-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-document-query-input.d.ts","sourceRoot":"","sources":["../../models/stage-defs-document-query-input.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,wCAAwC,CAAC;IACxD;;;;OAIG;IACH,cAAc,EAAE,iBAAiB,CAAC;CACrC;AAED,eAAO,MAAM,wCAAwC;;CAE3C,CAAC;AAEX,MAAM,MAAM,wCAAwC,GAAG,OAAO,wCAAwC,CAAC,MAAM,OAAO,wCAAwC,CAAC,CAAC"}

package/dist/models/stage-defs-document-reference.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Reference to an existing document to use its pre-computed features.  Use this to perform similarity search using a document\'s existing embeddings without re-processing the document. The system will fetch the document\'s feature vectors and use them directly for the search.  Use Cases:     - \"Find documents similar to this one\"     - Reverse image search using indexed images     - Document-to-document similarity     - Multi-hop similarity chains  Examples:     Find similar documents:         ```json         {             \"collection_id\": \"col_abc123\",             \"document_id\": \"doc_xyz789\"         }         ```
+ * @export
+ * @interface StageDefsDocumentReference
+ */
+export interface StageDefsDocumentReference {
+    /**
+     * Collection ID containing the reference document. Can be the same or different from the target search collection. Must be accessible within the current namespace. None values are handled by on_empty behavior (skip/random/error).
+     * @type {string}
+     * @memberof StageDefsDocumentReference
+     */
+    'collection_id'?: string;
+    /**
+     * Document ID to use as similarity reference. The document must exist and have feature vectors for the specified feature_uri. If the document doesn\'t have the required feature, the search will fail. None values are handled by on_empty behavior (skip/random/error).
+     * @type {string}
+     * @memberof StageDefsDocumentReference
+     */
+    'document_id'?: string;
+}
+//# sourceMappingURL=stage-defs-document-reference.d.ts.map

package/dist/models/stage-defs-document-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-document-reference.d.ts","sourceRoot":"","sources":["../../models/stage-defs-document-reference.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/models/stage-defs-dynamic-value.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * A value that should be dynamically resolved from the query request.
+ * @export
+ * @interface StageDefsDynamicValue
+ */
+export interface StageDefsDynamicValue {
+    /**
+     *
+     * @type {string}
+     * @memberof StageDefsDynamicValue
+     */
+    'type'?: StageDefsDynamicValueTypeEnum;
+    /**
+     * The dot-notation path to the value in the runtime query request, e.g., \'inputs.user_id\'
+     * @type {string}
+     * @memberof StageDefsDynamicValue
+     */
+    'field': string;
+}
+export declare const StageDefsDynamicValueTypeEnum: {
+    readonly Dynamic: "dynamic";
+};
+export type StageDefsDynamicValueTypeEnum = typeof StageDefsDynamicValueTypeEnum[keyof typeof StageDefsDynamicValueTypeEnum];
+//# sourceMappingURL=stage-defs-dynamic-value.d.ts.map

package/dist/models/stage-defs-dynamic-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-dynamic-value.d.ts","sourceRoot":"","sources":["../../models/stage-defs-dynamic-value.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,6BAA6B;;CAEhC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,OAAO,6BAA6B,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/models/stage-defs-enrichment-field.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { EnrichmentMergeMode } from './enrichment-merge-mode';
+/**
+ * Field-level enrichment behaviour specification.  Defines how to copy fields from taxonomy source nodes to enriched documents. Supports field renaming via target_field parameter.  Examples:     - Copy field as-is: {\"field_path\": \"category\", \"merge_mode\": \"replace\"}     - Rename field: {\"field_path\": \"label\", \"target_field\": \"visual_style\", \"merge_mode\": \"replace\"}     - Append to array: {\"field_path\": \"tags\", \"merge_mode\": \"append\"}
+ * @export
+ * @interface StageDefsEnrichmentField
+ */
+export interface StageDefsEnrichmentField {
+    /**
+     * Dot-notation path of the field to copy from the taxonomy node.
+     * @type {string}
+     * @memberof StageDefsEnrichmentField
+     */
+    'field_path': string;
+    /**
+     * Optional target field name in the enriched document. If specified, the source field will be renamed to this name. If not specified, the field_path is used as the target name. Use this to rename fields during enrichment (e.g., label → visual_style).
+     * @type {string}
+     * @memberof StageDefsEnrichmentField
+     */
+    'target_field'?: string;
+    /**
+     * Whether to overwrite the target\'s value or append (for arrays).
+     * @type {EnrichmentMergeMode}
+     * @memberof StageDefsEnrichmentField
+     */
+    'merge_mode'?: EnrichmentMergeMode;
+}
+//# sourceMappingURL=stage-defs-enrichment-field.d.ts.map

package/dist/models/stage-defs-enrichment-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-enrichment-field.d.ts","sourceRoot":"","sources":["../../models/stage-defs-enrichment-field.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACtC"}

package/dist/models/stage-defs-enrichment-merge-mode.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * How a field from the taxonomy node should be merged into the target doc.
+ * @export
+ * @enum {string}
+ */
+export declare const StageDefsEnrichmentMergeMode: {
+    readonly Replace: "replace";
+    readonly Append: "append";
+};
+export type StageDefsEnrichmentMergeMode = typeof StageDefsEnrichmentMergeMode[keyof typeof StageDefsEnrichmentMergeMode];
+//# sourceMappingURL=stage-defs-enrichment-merge-mode.d.ts.map

package/dist/models/stage-defs-enrichment-merge-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-enrichment-merge-mode.d.ts","sourceRoot":"","sources":["../../models/stage-defs-enrichment-merge-mode.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AAEH,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC;AAEX,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/models/stage-defs-error-handling.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Error handling strategy for web scrape failures.  SKIP: Skip documents that fail to fetch, continue with others.     - Failed documents are passed through unchanged     - Best for optional enrichment where failures are acceptable     - Example: Adding extra context that isn\'t critical  REMOVE: Remove documents that fail to fetch from results.     - Failed documents are filtered out completely     - Best when enriched content is required     - Example: Must have full content to proceed  RAISE: Raise exception on first failure, halt pipeline.     - Pipeline stops immediately on any failure     - Best for critical enrichment where failures indicate problems     - Example: Required content for compliance/audit
+ * @export
+ * @enum {string}
+ */
+export declare const StageDefsErrorHandling: {
+    readonly Skip: "skip";
+    readonly Remove: "remove";
+    readonly Raise: "raise";
+};
+export type StageDefsErrorHandling = typeof StageDefsErrorHandling[keyof typeof StageDefsErrorHandling];
+//# sourceMappingURL=stage-defs-error-handling.d.ts.map

package/dist/models/stage-defs-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-error-handling.d.ts","sourceRoot":"","sources":["../../models/stage-defs-error-handling.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AAEH,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/models/stage-defs-facet-field-config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Configuration for a single facet field.  Faceting counts unique values for a field, enabling faceted search interfaces (e.g., \"Show 45 results in \'Sports\', 23 in \'Music\'\").  ┌─────────────────────────────────────────────────────────────────────────────┐ │ IMPORTANT: INDEX REQUIREMENT                                                │ │                                                                             │ │ The field MUST have a keyword index in Qdrant for faceting to work.         │ │ Fields are automatically indexed during collection creation for common      │ │ metadata fields. For custom fields, ensure indexing is configured.          │ │                                                                             │ │ Without an index, faceting will fail with an error.                         │ └─────────────────────────────────────────────────────────────────────────────┘  Example:     ```json     {         \"key\": \"metadata.category\",         \"limit\": 10,         \"exact\": false     }     ```
+ * @export
+ * @interface StageDefsFacetFieldConfig
+ */
+export interface StageDefsFacetFieldConfig {
+    /**
+     * REQUIRED. Field path to facet on (e.g., \'metadata.category\', \'status\'). Supports nested fields using dot notation. The field MUST have a keyword index in Qdrant - faceting will fail without it. Common indexed fields: metadata.*, status, collection_id, source_object_id.
+     * @type {string}
+     * @memberof StageDefsFacetFieldConfig
+     */
+    'key': string;
+    /**
+     * OPTIONAL. Maximum number of unique values to return (default: 10). Results are sorted by count descending, then by value ascending. Higher limits increase response size but provide more comprehensive facets. Common values: 5 (compact), 10 (standard), 20-50 (detailed).
+     * @type {number}
+     * @memberof StageDefsFacetFieldConfig
+     */
+    'limit'?: number;
+    /**
+     * OPTIONAL. Use exact counts instead of approximate (default: False). - False (default): Fast approximate counts, suitable for most UIs.   Approximate counts are accurate enough for display purposes. - True: Slower but precise counts, useful for debugging or analytics.   Use when exact numbers matter (e.g., reports, dashboards).
+     * @type {boolean}
+     * @memberof StageDefsFacetFieldConfig
+     */
+    'exact'?: boolean;
+}
+//# sourceMappingURL=stage-defs-facet-field-config.d.ts.map

package/dist/models/stage-defs-facet-field-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-defs-facet-field-config.d.ts","sourceRoot":"","sources":["../../models/stage-defs-facet-field-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACtC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB"}