@xano-sdk/vector 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1189 @@
+import * as _xano_sdk from '@xano/sdk';
+import { TableDef, InferRow, FunctionDef, InputDescriptor, ToolDef, Xano } from '@xano/sdk';
+
+/**
+ * Configuration options and validator for `@xano-sdk/vector`.
+ */
+
+/** Supported text chunking strategies. */
+declare const CHUNK_STRATEGIES: readonly ["fixed", "paragraph", "sentence", "markdown", "custom"];
+type ChunkStrategy = (typeof CHUNK_STRATEGIES)[number];
+/** Document indexing lifecycle status. */
+declare const DOCUMENT_STATUSES: readonly ["pending", "indexing", "indexed", "failed"];
+type DocumentStatus = (typeof DOCUMENT_STATUSES)[number];
+/** Supported citation formatting styles for AI agents. */
+type CitationFormat = "markdown" | "numeric" | "none";
+/** Supported auth table references. */
+type VectorAuthTable = TableDef | string;
+/** Multimodal Google Gemini Embeddings 2 operates at 768 dimensions using MRL. */
+declare const GEMINI_EMBEDDING_DIMENSIONS = 768;
+/** Default embedding model for Gemini Embeddings 2. */
+declare const DEFAULT_GEMINI_MODEL = "gemini-embedding-2";
+/** Default environment variable name for the Google API key. */
+declare const DEFAULT_API_KEY_ENV = "GEMINI_API_KEY";
+/** Default chunking character size. */
+declare const DEFAULT_CHUNK_SIZE = 500;
+/** Default chunking character overlap. */
+declare const DEFAULT_CHUNK_OVERLAP = 50;
+/** Default top-k vector search limit. */
+declare const DEFAULT_SEARCH_LIMIT = 10;
+/** Default similarity threshold (0.0 to 1.0). */
+declare const DEFAULT_SEARCH_THRESHOLD = 0;
+/** Default chunking strategy. */
+declare const DEFAULT_STRATEGY: ChunkStrategy;
+/** Custom naming overrides for generated defs. */
+interface VectorNames {
+    document?: string;
+    chunk?: string;
+    embedFn?: string;
+    chunkFn?: string;
+    ingestFn?: string;
+    searchFn?: string;
+    searchTool?: string;
+    apiGroup?: string;
+}
+declare const DEFAULT_NAMES: Required<VectorNames>;
+/** User-facing configuration options for `createVector` and `registerVector`. */
+interface VectorOptions {
+    authTable?: TableDef | string;
+    authenticated?: boolean;
+    userIdType?: "int" | "uuid";
+    model?: string;
+    apiKeyEnv?: string;
+    defaultStrategy?: ChunkStrategy;
+    defaultChunkSize?: number;
+    defaultChunkOverlap?: number;
+    searchLimit?: number;
+    searchThreshold?: number;
+    taskTypeDocument?: string;
+    taskTypeQuery?: string;
+    citationFormat?: CitationFormat;
+    routePrefix?: string;
+    canonical?: string;
+    names?: VectorNames;
+    tags?: string[];
+}
+/** Fully resolved, validated options ready for internal consumption. */
+interface ResolvedOptions {
+    authTable: TableDef | string | undefined;
+    authenticated: boolean;
+    userIdType: "int" | "uuid";
+    model: string;
+    apiKeyEnv: string;
+    dimensions: number;
+    defaultStrategy: ChunkStrategy;
+    defaultChunkSize: number;
+    defaultChunkOverlap: number;
+    searchLimit: number;
+    searchThreshold: number;
+    taskTypeDocument: string;
+    taskTypeQuery: string;
+    citationFormat: CitationFormat;
+    routePrefix: string;
+    canonical: string | undefined;
+    names: Required<VectorNames>;
+    tags: string[];
+}
+/**
+ * Validates and resolves `VectorOptions` into a complete `ResolvedOptions`.
+ */
+declare function resolveOptions(opts?: VectorOptions): ResolvedOptions;
+
+/**
+ * The `document` table — stores uploaded documents, media assets, and indexing status.
+ */
+
+/** Build the `document` def for the given resolved options. */
+declare function documentTable(opts: ResolvedOptions): TableDef<string, {
+    [x: string]: unknown;
+}, never>;
+/** The `document` def type. */
+type DocumentTable = ReturnType<typeof documentTable>;
+/** A `document` row. */
+type DocumentRow = InferRow<ReturnType<typeof documentTable>>;
+/** Public fields returned for a document. */
+declare const PUBLIC_DOCUMENT_FIELDS: readonly ["id", "created_at", "title", "content", "media_data", "mime_type", "metadata", "status", "chunk_count", "strategy", "chunk_size", "chunk_overlap", "error_message"];
+interface PublicDocument {
+    id: number;
+    created_at: number;
+    title: string;
+    content: string;
+    media_data?: string;
+    mime_type: string;
+    metadata: Record<string, unknown>;
+    status: string;
+    chunk_count: number;
+    strategy: string;
+    chunk_size: number;
+    chunk_overlap: number;
+    error_message?: string;
+    user_id?: number | string;
+}
+
+/** Build the `document_chunk` def for the given resolved options and document table. */
+declare function chunkTable(opts: ResolvedOptions, document: DocumentTable): _xano_sdk.TableDef<_xano_sdk.SchemaCols<{
+    document_id: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<number, {
+        readonly required: true;
+        readonly description: "The document this chunk was generated from.";
+    }, "int">;
+    document_title: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<string, {
+        readonly required: false;
+        readonly description: "Title of the parent document.";
+    }, "text">;
+    chunk_index: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<number, {
+        readonly required: true;
+        readonly description: "0-based sequence index of the chunk within the document.";
+    }, "int">;
+    content: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<string, {
+        readonly required: false;
+        readonly description: "The text content or caption of this chunk.";
+    }, "text">;
+    mime_type: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<string, {
+        readonly default: "text/plain";
+        readonly description: "MIME type of the chunk content (e.g. text/plain, image/png, audio/mp3).";
+    }, "text">;
+    embedding: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<number[], {
+        readonly description: "Google Gemini 768-dimensional multimodal vector embedding.";
+    }, "vector">;
+    metadata: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<unknown, {
+        readonly description: "Metadata specific to this chunk (e.g. section title, timestamps, bounding box).";
+    }, "json">;
+    char_count: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<number, {
+        readonly default: 0;
+        readonly description: "Character length of the text content.";
+    }, "int">;
+}>, {
+    id: number;
+    created_at: number;
+    document_id: number;
+    document_title: string;
+    chunk_index: number;
+    content: string;
+    mime_type: string;
+    embedding: number[] | null;
+    metadata: unknown;
+    char_count: number;
+}, never>;
+/** The `document_chunk` def type. */
+type ChunkTable = ReturnType<typeof chunkTable>;
+/** A `document_chunk` row. */
+type ChunkRow = InferRow<ReturnType<typeof chunkTable>>;
+/** Public fields returned for a chunk. */
+declare const PUBLIC_CHUNK_FIELDS: readonly ["id", "created_at", "document_id", "document_title", "chunk_index", "content", "mime_type", "metadata", "char_count"];
+interface PublicChunk {
+    id: number;
+    created_at: number;
+    document_id: number;
+    document_title?: string;
+    chunk_index: number;
+    content: string;
+    mime_type: string;
+    metadata: Record<string, unknown>;
+    char_count: number;
+}
+
+/**
+ * `vector/generate_embedding` — calls Google Gemini Multimodal Embedding 2 API to generate a
+ * 768-dimensional multimodal vector embedding for text, image, audio, video, or interleaved inputs.
+ */
+
+/** Return type for generateEmbeddingFn. */
+type GenerateEmbeddingFn = FunctionDef<Record<string, InputDescriptor>, {
+    embedding: number[];
+    dimensions: number;
+}>;
+/** Build the `generateEmbedding` function definition for the given options. */
+declare function generateEmbeddingFn(opts: ResolvedOptions): GenerateEmbeddingFn;
+
+/** A single structured chunk item produced by chunking text. */
+interface ChunkItem {
+    index: number;
+    content: string;
+    char_count: number;
+    metadata: Record<string, unknown>;
+}
+/** Build the `chunkText` function definition for the given options. */
+declare function chunkTextFn(opts: ResolvedOptions): _xano_sdk.FunctionDef<{
+    readonly content: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+        readonly required: false;
+        readonly description: "The raw text content to segment into chunks.";
+    }, "text">;
+    readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+        readonly default: "fixed" | "paragraph" | "sentence" | "markdown" | "custom";
+        readonly description: "Chunking algorithm: fixed, paragraph, sentence, markdown, or custom.";
+    }, "enum">;
+    readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+        readonly default: number;
+        readonly description: "Target maximum character count per chunk.";
+    }, "int">;
+    readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+        readonly default: number;
+        readonly description: "Character overlap preserved between consecutive chunks.";
+    }, "int">;
+}, {
+    chunks: ChunkItem[];
+    count: number;
+}, _xano_sdk.ObjValue<{
+    chunks: _xano_sdk.RefValue<"chunks">;
+    count: _xano_sdk.TaggedValue & {
+        readonly __filtered: true;
+        readonly __base?: _xano_sdk.RefValue<"chunks"> | undefined;
+        readonly __chain?: [_xano_sdk.FilterXdo<"count">] | undefined;
+    };
+}>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"target_size", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"target_overlap", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"active_strategy", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"raw_text", unknown>, _xano_sdk.Statement]>;
+/** The `chunkText` function def type. */
+type ChunkTextFn = ReturnType<typeof chunkTextFn>;
+
+/**
+ * `vector/ingest_document` — orchestrates chunking, multimodal embedding generation,
+ * and bulk persistence into `document_chunk` and `document` tables.
+ */
+
+/** Return type for ingestDocumentFn. */
+type IngestDocumentFn = FunctionDef<Record<string, InputDescriptor>, {
+    document_id: number;
+    status: string;
+    chunk_count: number;
+}>;
+/** Build the `ingestDocument` function definition. */
+declare function ingestDocumentFn(opts: ResolvedOptions, document: DocumentTable, chunk: ChunkTable, embedFn: GenerateEmbeddingFn, chunkFn: ChunkTextFn): IngestDocumentFn;
+
+/**
+ * `vector/search_vectors` — performs cosine similarity vector search over the chunk table
+ * using pgvector and Gemini 768-dimensional multimodal embeddings.
+ */
+
+/** A single vector search hit item. */
+interface SearchHit {
+    id: number;
+    document_id: number;
+    document_title?: string;
+    chunk_index: number;
+    content: string;
+    mime_type: string;
+    metadata: Record<string, unknown>;
+    distance: number;
+}
+/** Return type for searchVectorsFn. */
+type SearchVectorsFn = FunctionDef<Record<string, InputDescriptor>, {
+    results: SearchHit[];
+    count: number;
+}>;
+/** Build the `searchVectors` function definition. */
+declare function searchVectorsFn(opts: ResolvedOptions, chunk: ChunkTable, embedFn: GenerateEmbeddingFn): SearchVectorsFn;
+
+/**
+ * `vector_search` — AI Agent Tool definition for semantic multimodal vector search.
+ */
+
+/** Return type for vectorSearchTool. */
+type VectorSearchTool = ToolDef<Record<string, InputDescriptor>, unknown>;
+/** Build the `vector_search` agent tool definition. */
+declare function vectorSearchTool(opts: ResolvedOptions, searchFn: SearchVectorsFn): VectorSearchTool;
+
+/** Build the API group for the vector endpoints. */
+declare function vectorGroup(opts: ResolvedOptions): _xano_sdk.ApiGroupDef;
+/** The `vectorGroup` def type. */
+type VectorGroup = ReturnType<typeof vectorGroup>;
+
+/**
+ * Request and response payload interfaces for the Vector API Group endpoints.
+ */
+
+interface CreateDocumentPayload {
+    title: string;
+    content?: string;
+    media_data?: string;
+    mime_type?: string;
+    metadata?: Record<string, unknown>;
+    strategy?: string;
+    chunk_size?: number;
+    chunk_overlap?: number;
+}
+interface CreateDocumentResult {
+    document: PublicDocument;
+    chunk_count: number;
+    status: string;
+}
+interface ListDocumentsPayload {
+    page?: number;
+    per_page?: number;
+    status?: string;
+}
+interface ListDocumentsResult {
+    items: PublicDocument[];
+    curPage: number;
+    perPage: number;
+    itemsReceived: number;
+    itemsTotal: number;
+    pageTotal: number;
+}
+interface GetDocumentResult {
+    document: PublicDocument;
+    chunks: PublicChunk[];
+}
+interface DeleteDocumentResult {
+    deleted: boolean;
+    id: number;
+}
+interface ReindexDocumentPayload {
+    strategy?: string;
+    chunk_size?: number;
+    chunk_overlap?: number;
+}
+interface ReindexDocumentResult {
+    document_id: number;
+    status: string;
+    chunk_count: number;
+}
+interface SearchPayload {
+    query?: string;
+    query_media_data?: string;
+    query_mime_type?: string;
+    query_embedding?: number[];
+    limit?: number;
+    threshold?: number;
+}
+interface SearchResult {
+    results: SearchHit[];
+    count: number;
+}
+interface EmbedPayload {
+    text?: string;
+    media_data?: string;
+    mime_type?: string;
+    model?: string;
+}
+interface EmbedResult {
+    embedding: number[];
+    dimensions: number;
+}
+
+declare function documentQueries(opts: ResolvedOptions, group: VectorGroup, document: DocumentTable, chunk: ChunkTable, ingestFn: IngestDocumentFn): {
+    create: _xano_sdk.QueryDef<{
+        readonly title: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: true;
+            readonly description: "Title or filename for the document.";
+        }, "text">;
+        readonly content: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Raw text content of the document.";
+        }, "text">;
+        readonly media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64-encoded media data (images, audio, video).";
+        }, "text">;
+        readonly mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type (e.g. text/markdown, image/png, audio/mp3).";
+        }, "text">;
+        readonly metadata: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<unknown, {
+            readonly required: false;
+            readonly description: "Arbitrary structured metadata.";
+        }, "json">;
+        readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+            readonly default: "fixed" | "paragraph" | "sentence" | "markdown" | "custom";
+            readonly description: "Chunking algorithm for text content.";
+        }, "enum">;
+        readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Target maximum chunk size in characters.";
+        }, "int">;
+        readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Chunk character overlap.";
+        }, "int">;
+    }, CreateDocumentResult, _xano_sdk.ObjValue<{
+        document: _xano_sdk.RefValue<"final_doc">;
+        chunk_count: _xano_sdk.RefValue<"ingest_res.chunk_count">;
+        status: _xano_sdk.RefValue<"ingest_res.status">;
+    }>, readonly [_xano_sdk.Statement, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"created_doc", {
+        [x: string]: unknown;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"ingest_res", {
+        document_id: number;
+        status: string;
+        chunk_count: number;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"final_doc", {
+        [x: string]: unknown;
+    } | null>], `${string}/documents/create`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    createDocument: _xano_sdk.QueryDef<{
+        readonly title: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: true;
+            readonly description: "Title or filename for the document.";
+        }, "text">;
+        readonly content: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Raw text content of the document.";
+        }, "text">;
+        readonly media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64-encoded media data (images, audio, video).";
+        }, "text">;
+        readonly mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type (e.g. text/markdown, image/png, audio/mp3).";
+        }, "text">;
+        readonly metadata: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<unknown, {
+            readonly required: false;
+            readonly description: "Arbitrary structured metadata.";
+        }, "json">;
+        readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+            readonly default: "fixed" | "paragraph" | "sentence" | "markdown" | "custom";
+            readonly description: "Chunking algorithm for text content.";
+        }, "enum">;
+        readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Target maximum chunk size in characters.";
+        }, "int">;
+        readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Chunk character overlap.";
+        }, "int">;
+    }, CreateDocumentResult, _xano_sdk.ObjValue<{
+        document: _xano_sdk.RefValue<"final_doc">;
+        chunk_count: _xano_sdk.RefValue<"ingest_res.chunk_count">;
+        status: _xano_sdk.RefValue<"ingest_res.status">;
+    }>, readonly [_xano_sdk.Statement, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"created_doc", {
+        [x: string]: unknown;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"ingest_res", {
+        document_id: number;
+        status: string;
+        chunk_count: number;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"final_doc", {
+        [x: string]: unknown;
+    } | null>], `${string}/documents/create`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    list: _xano_sdk.QueryDef<{
+        readonly page: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: 1;
+            readonly description: "Page number (1-based).";
+        }, "int">;
+        readonly per_page: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: 20;
+            readonly description: "Number of documents per page.";
+        }, "int">;
+    }, ListDocumentsResult, _xano_sdk.RefValue<"docs">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"docs", {
+        items: {
+            [x: string]: unknown;
+        }[];
+        itemsReceived: number;
+        curPage: number;
+        nextPage: number | null;
+        prevPage: number | null;
+        offset: number;
+        perPage: number;
+    }>], `${string}/documents`, "GET"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    listDocuments: _xano_sdk.QueryDef<{
+        readonly page: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: 1;
+            readonly description: "Page number (1-based).";
+        }, "int">;
+        readonly per_page: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: 20;
+            readonly description: "Number of documents per page.";
+        }, "int">;
+    }, ListDocumentsResult, _xano_sdk.RefValue<"docs">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"docs", {
+        items: {
+            [x: string]: unknown;
+        }[];
+        itemsReceived: number;
+        curPage: number;
+        nextPage: number | null;
+        prevPage: number | null;
+        offset: number;
+        perPage: number;
+    }>], `${string}/documents`, "GET"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    get: _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID.";
+        }, "int">;
+    }, GetDocumentResult, _xano_sdk.ObjValue<{
+        document: _xano_sdk.RefValue<"doc">;
+        chunks: _xano_sdk.RefValue<"chunks">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"chunks", {
+        id: number;
+        created_at: number;
+        document_id: number;
+        document_title: string;
+        chunk_index: number;
+        content: string;
+        mime_type: string;
+        embedding: number[] | null;
+        metadata: unknown;
+        char_count: number;
+    }[]>], `${string}/documents/{id}`, "GET"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    getDocument: _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID.";
+        }, "int">;
+    }, GetDocumentResult, _xano_sdk.ObjValue<{
+        document: _xano_sdk.RefValue<"doc">;
+        chunks: _xano_sdk.RefValue<"chunks">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"chunks", {
+        id: number;
+        created_at: number;
+        document_id: number;
+        document_title: string;
+        chunk_index: number;
+        content: string;
+        mime_type: string;
+        embedding: number[] | null;
+        metadata: unknown;
+        char_count: number;
+    }[]>], `${string}/documents/{id}`, "GET"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    delete: _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID to delete.";
+        }, "int">;
+    }, DeleteDocumentResult, _xano_sdk.ObjValue<{
+        deleted: _xano_sdk.ConstValue<true>;
+        id: _xano_sdk.RefValue<"doc.id">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<string, number>, _xano_sdk.Statement], `${string}/documents/{id}/delete`, "DELETE"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    deleteDocument: _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID to delete.";
+        }, "int">;
+    }, DeleteDocumentResult, _xano_sdk.ObjValue<{
+        deleted: _xano_sdk.ConstValue<true>;
+        id: _xano_sdk.RefValue<"doc.id">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<string, number>, _xano_sdk.Statement], `${string}/documents/{id}/delete`, "DELETE"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    reindex: _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID to reindex.";
+        }, "int">;
+        readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+            readonly required: false;
+            readonly description: "New chunking algorithm (fixed, paragraph, sentence, markdown, custom).";
+        }, "enum">;
+        readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: false;
+            readonly description: "Updated target chunk size.";
+        }, "int">;
+        readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: false;
+            readonly description: "Updated chunk overlap.";
+        }, "int">;
+    }, ReindexDocumentResult, _xano_sdk.RefValue<"ingest_res">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_strategy", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_size", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_overlap", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<string, {
+        [x: string]: unknown;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"ingest_res", {
+        document_id: number;
+        status: string;
+        chunk_count: number;
+    }>], `${string}/documents/{id}/reindex`, "POST"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    reindexDocument: _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID to reindex.";
+        }, "int">;
+        readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+            readonly required: false;
+            readonly description: "New chunking algorithm (fixed, paragraph, sentence, markdown, custom).";
+        }, "enum">;
+        readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: false;
+            readonly description: "Updated target chunk size.";
+        }, "int">;
+        readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: false;
+            readonly description: "Updated chunk overlap.";
+        }, "int">;
+    }, ReindexDocumentResult, _xano_sdk.RefValue<"ingest_res">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_strategy", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_size", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_overlap", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<string, {
+        [x: string]: unknown;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"ingest_res", {
+        document_id: number;
+        status: string;
+        chunk_count: number;
+    }>], `${string}/documents/{id}/reindex`, "POST"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    all: readonly [_xano_sdk.QueryDef<{
+        readonly title: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: true;
+            readonly description: "Title or filename for the document.";
+        }, "text">;
+        readonly content: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Raw text content of the document.";
+        }, "text">;
+        readonly media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64-encoded media data (images, audio, video).";
+        }, "text">;
+        readonly mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type (e.g. text/markdown, image/png, audio/mp3).";
+        }, "text">;
+        readonly metadata: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<unknown, {
+            readonly required: false;
+            readonly description: "Arbitrary structured metadata.";
+        }, "json">;
+        readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+            readonly default: "fixed" | "paragraph" | "sentence" | "markdown" | "custom";
+            readonly description: "Chunking algorithm for text content.";
+        }, "enum">;
+        readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Target maximum chunk size in characters.";
+        }, "int">;
+        readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Chunk character overlap.";
+        }, "int">;
+    }, CreateDocumentResult, _xano_sdk.ObjValue<{
+        document: _xano_sdk.RefValue<"final_doc">;
+        chunk_count: _xano_sdk.RefValue<"ingest_res.chunk_count">;
+        status: _xano_sdk.RefValue<"ingest_res.status">;
+    }>, readonly [_xano_sdk.Statement, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"created_doc", {
+        [x: string]: unknown;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"ingest_res", {
+        document_id: number;
+        status: string;
+        chunk_count: number;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"final_doc", {
+        [x: string]: unknown;
+    } | null>], `${string}/documents/create`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }, _xano_sdk.QueryDef<{
+        readonly page: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: 1;
+            readonly description: "Page number (1-based).";
+        }, "int">;
+        readonly per_page: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: 20;
+            readonly description: "Number of documents per page.";
+        }, "int">;
+    }, ListDocumentsResult, _xano_sdk.RefValue<"docs">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"docs", {
+        items: {
+            [x: string]: unknown;
+        }[];
+        itemsReceived: number;
+        curPage: number;
+        nextPage: number | null;
+        prevPage: number | null;
+        offset: number;
+        perPage: number;
+    }>], `${string}/documents`, "GET"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }, _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID.";
+        }, "int">;
+    }, GetDocumentResult, _xano_sdk.ObjValue<{
+        document: _xano_sdk.RefValue<"doc">;
+        chunks: _xano_sdk.RefValue<"chunks">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"chunks", {
+        id: number;
+        created_at: number;
+        document_id: number;
+        document_title: string;
+        chunk_index: number;
+        content: string;
+        mime_type: string;
+        embedding: number[] | null;
+        metadata: unknown;
+        char_count: number;
+    }[]>], `${string}/documents/{id}`, "GET"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }, _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID to delete.";
+        }, "int">;
+    }, DeleteDocumentResult, _xano_sdk.ObjValue<{
+        deleted: _xano_sdk.ConstValue<true>;
+        id: _xano_sdk.RefValue<"doc.id">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<string, number>, _xano_sdk.Statement], `${string}/documents/{id}/delete`, "DELETE"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }, _xano_sdk.QueryDef<{
+        readonly id: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: true;
+            readonly description: "Document ID to reindex.";
+        }, "int">;
+        readonly strategy: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<"fixed" | "paragraph" | "sentence" | "markdown" | "custom", {
+            readonly required: false;
+            readonly description: "New chunking algorithm (fixed, paragraph, sentence, markdown, custom).";
+        }, "enum">;
+        readonly chunk_size: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: false;
+            readonly description: "Updated target chunk size.";
+        }, "int">;
+        readonly chunk_overlap: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly required: false;
+            readonly description: "Updated chunk overlap.";
+        }, "int">;
+    }, ReindexDocumentResult, _xano_sdk.RefValue<"ingest_res">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"doc", {
+        [x: string]: unknown;
+    } | null>, _xano_sdk.Statement, ..._xano_sdk.Statement[], _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_strategy", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_size", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"new_overlap", unknown>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<string, {
+        [x: string]: unknown;
+    }>, _xano_sdk.Statement & _xano_sdk.AsShapeBrand<"ingest_res", {
+        document_id: number;
+        status: string;
+        chunk_count: number;
+    }>], `${string}/documents/{id}/reindex`, "POST"> & {
+        getPath: (opts: {
+            canonical?: string;
+            params: {
+                id: string | number;
+            };
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }];
+};
+
+declare function searchQueries(opts: ResolvedOptions, group: VectorGroup, searchFn: SearchVectorsFn, embedFn: GenerateEmbeddingFn): {
+    search: _xano_sdk.QueryDef<{
+        readonly query: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Natural language query string.";
+        }, "text">;
+        readonly query_media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64-encoded media data for visual/audio search queries.";
+        }, "text">;
+        readonly query_mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type for media data if provided.";
+        }, "text">;
+        readonly query_embedding: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<number[], {
+            readonly required: false;
+            readonly description: "Pre-computed 768-dimensional query vector.";
+        }, "vector">;
+        readonly limit: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Maximum number of search results to return.";
+        }, "int">;
+        readonly threshold: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Minimum similarity threshold (0.0 to 1.0).";
+        }, "decimal">;
+    }, SearchResult, _xano_sdk.ObjValue<{
+        results: _xano_sdk.RefValue<"search_res.results">;
+        count: _xano_sdk.RefValue<"search_res.count">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"search_res", {
+        results: SearchHit[];
+        count: number;
+    }>], `${string}/search`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    embed: _xano_sdk.QueryDef<{
+        readonly text: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Text content to generate an embedding vector for.";
+        }, "text">;
+        readonly media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64 media data (image, audio, video).";
+        }, "text">;
+        readonly mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type for media data if provided.";
+        }, "text">;
+        readonly model: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: string;
+            readonly description: "Google Gemini embedding model name.";
+        }, "text">;
+    }, EmbedResult, _xano_sdk.RefValue<"embed_res">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"embed_res", {
+        embedding: number[];
+        dimensions: number;
+    }>], `${string}/embed`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    };
+    all: readonly [_xano_sdk.QueryDef<{
+        readonly query: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Natural language query string.";
+        }, "text">;
+        readonly query_media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64-encoded media data for visual/audio search queries.";
+        }, "text">;
+        readonly query_mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type for media data if provided.";
+        }, "text">;
+        readonly query_embedding: _xano_sdk.FieldDescriptor & _xano_sdk.TypeBrand<number[], {
+            readonly required: false;
+            readonly description: "Pre-computed 768-dimensional query vector.";
+        }, "vector">;
+        readonly limit: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Maximum number of search results to return.";
+        }, "int">;
+        readonly threshold: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<number, {
+            readonly default: number;
+            readonly description: "Minimum similarity threshold (0.0 to 1.0).";
+        }, "decimal">;
+    }, SearchResult, _xano_sdk.ObjValue<{
+        results: _xano_sdk.RefValue<"search_res.results">;
+        count: _xano_sdk.RefValue<"search_res.count">;
+    }>, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"search_res", {
+        results: SearchHit[];
+        count: number;
+    }>], `${string}/search`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }, _xano_sdk.QueryDef<{
+        readonly text: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Text content to generate an embedding vector for.";
+        }, "text">;
+        readonly media_data: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly required: false;
+            readonly description: "Base64 media data (image, audio, video).";
+        }, "text">;
+        readonly mime_type: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: "text/plain";
+            readonly description: "MIME type for media data if provided.";
+        }, "text">;
+        readonly model: _xano_sdk.InputDescriptor & _xano_sdk.TypeBrand<string, {
+            readonly default: string;
+            readonly description: "Google Gemini embedding model name.";
+        }, "text">;
+    }, EmbedResult, _xano_sdk.RefValue<"embed_res">, readonly [_xano_sdk.Statement & _xano_sdk.AsShapeBrand<"embed_res", {
+        embedding: number[];
+        dimensions: number;
+    }>], `${string}/embed`, "POST"> & {
+        getPath: (opts?: {
+            canonical?: string;
+        }) => string;
+        toSearchParams: {
+            (input: Record<string, _xano_sdk.SearchParamValue>): _xano_sdk.SearchParams;
+            (input: Record<string, unknown>): _xano_sdk.SearchParams;
+        };
+    } & {
+        auth?: string | false | _xano_sdk.TableDef<string, unknown, string> | undefined;
+    }];
+};
+
+/**
+ * `createVector(opts)` — builds every def for one configuration.
+ * `registerVector(xano, opts)` — builds and registers all defs on a Xano instance.
+ */
+
+/** Document management endpoint family. */
+type DocumentFamily = ReturnType<typeof documentQueries>;
+/** Search & embedding endpoint family. */
+type SearchFamily = ReturnType<typeof searchQueries>;
+/** Everything one `createVector` call produces. */
+interface Vector {
+    options: ResolvedOptions;
+    document: ReturnType<typeof documentTable>;
+    chunk: ReturnType<typeof chunkTable>;
+    embedFn: ReturnType<typeof generateEmbeddingFn>;
+    chunkFn: ReturnType<typeof chunkTextFn>;
+    ingestFn: ReturnType<typeof ingestDocumentFn>;
+    searchFn: ReturnType<typeof searchVectorsFn>;
+    searchTool: ReturnType<typeof vectorSearchTool>;
+    group: ReturnType<typeof vectorGroup>;
+    documents: DocumentFamily;
+    search: SearchFamily;
+    queries: (DocumentFamily["all"][number] | SearchFamily["all"][number])[];
+}
+/**
+ * Build the full vector def set without registering anything.
+ *
+ * Use this to cherry-pick specific defs or wire custom combinations.
+ */
+declare function createVector(opts?: VectorOptions): Vector;
+/** What `registerVector` returns: the def set, plus the Xano instance. */
+interface RegisteredVector<X extends Xano> extends Vector {
+    xano: X;
+}
+/**
+ * Build and register the full vector embedding & search pipeline on the given instance.
+ *
+ * ```ts
+ * import { workspace } from "@xano/sdk";
+ * import { registerVector } from "@xano-sdk/vector";
+ *
+ * export const vector = registerVector(workspace("my-app"), {
+ *   apiKeyEnv: "GEMINI_API_KEY",
+ * });
+ *
+ * export default vector.xano;
+ * ```
+ */
+declare function registerVector<X extends Xano>(xano: X, opts?: VectorOptions): RegisteredVector<X>;
+
+/**
+ * Fully typed client-side interface describing the Vector API endpoints.
+ */
+
+type CreateDocumentBody = CreateDocumentPayload;
+type CreateDocumentInput = CreateDocumentPayload;
+type CreateDocumentResponse = CreateDocumentResult;
+type ListDocumentsQuery = ListDocumentsPayload;
+type ListDocumentsInput = ListDocumentsPayload;
+type ListDocumentsResponse = ListDocumentsResult;
+type GetDocumentParams = {
+    id: number;
+};
+type GetDocumentInput = {
+    id: number;
+};
+type GetDocumentResponse = GetDocumentResult;
+type DeleteDocumentParams = {
+    id: number;
+};
+type DeleteDocumentInput = {
+    id: number;
+};
+type DeleteDocumentResponse = DeleteDocumentResult;
+type ReindexDocumentParams = {
+    id: number;
+};
+type ReindexDocumentBody = ReindexDocumentPayload;
+type ReindexDocumentInput = {
+    id: number;
+} & ReindexDocumentPayload;
+type ReindexDocumentResponse = ReindexDocumentResult;
+type SearchBody = SearchPayload;
+type SearchInput = SearchPayload;
+type SearchResponse = SearchResult;
+type EmbedBody = EmbedPayload;
+type EmbedInput = EmbedPayload;
+type EmbedResponse = EmbedResult;
+interface VectorClientEndpoints {
+    "POST /documents/create": {
+        request: CreateDocumentPayload;
+        response: CreateDocumentResult;
+    };
+    "GET /documents": {
+        request: ListDocumentsPayload;
+        response: ListDocumentsResult;
+    };
+    "GET /documents/:id": {
+        request: {
+            id: number;
+        };
+        response: GetDocumentResult;
+    };
+    "DELETE /documents/:id/delete": {
+        request: {
+            id: number;
+        };
+        response: DeleteDocumentResult;
+    };
+    "POST /documents/:id/reindex": {
+        request: {
+            id: number;
+        } & ReindexDocumentPayload;
+        response: ReindexDocumentResult;
+    };
+    "POST /search": {
+        request: SearchPayload;
+        response: SearchResult;
+    };
+    "POST /embed": {
+        request: EmbedPayload;
+        response: EmbedResult;
+    };
+}
+type VectorEndpointName = keyof VectorClientEndpoints;
+type VectorEndpoints = VectorClientEndpoints;
+type VectorEndpoint<K extends VectorEndpointName> = VectorClientEndpoints[K];
+
+export { CHUNK_STRATEGIES, type ChunkItem, type ChunkRow, type ChunkStrategy, type ChunkTable, type ChunkTextFn, type CreateDocumentBody, type CreateDocumentInput, type CreateDocumentPayload, type CreateDocumentResponse, type CreateDocumentResult, DEFAULT_API_KEY_ENV, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_GEMINI_MODEL, DEFAULT_NAMES, DEFAULT_SEARCH_LIMIT, DEFAULT_SEARCH_THRESHOLD, DEFAULT_STRATEGY, DOCUMENT_STATUSES, type DeleteDocumentInput, type DeleteDocumentParams, type DeleteDocumentResponse, type DeleteDocumentResult, type DocumentFamily, type DocumentRow, type DocumentStatus, type DocumentTable, type EmbedBody, type EmbedInput, type EmbedPayload, type EmbedResponse, type EmbedResult, GEMINI_EMBEDDING_DIMENSIONS, type GenerateEmbeddingFn, type GetDocumentInput, type GetDocumentParams, type GetDocumentResponse, type GetDocumentResult, type IngestDocumentFn, type ListDocumentsInput, type ListDocumentsQuery, type ListDocumentsResponse, type ListDocumentsResult, PUBLIC_CHUNK_FIELDS, PUBLIC_DOCUMENT_FIELDS, type PublicChunk, type PublicDocument, type RegisteredVector, type ReindexDocumentBody, type ReindexDocumentInput, type ReindexDocumentParams, type ReindexDocumentPayload, type ReindexDocumentResponse, type ResolvedOptions, type SearchBody, type SearchFamily, type SearchHit, type SearchInput, type SearchPayload, type SearchResponse, type SearchResult, type SearchVectorsFn, type Vector, type VectorAuthTable, type VectorEndpoint, type VectorEndpointName, type VectorEndpoints, type VectorGroup, type VectorNames, type VectorOptions, type VectorSearchTool, chunkTable, chunkTextFn, createVector, documentQueries, documentTable, generateEmbeddingFn, ingestDocumentFn, registerVector, resolveOptions, searchQueries, searchVectorsFn, vectorGroup, vectorSearchTool };