@antfly/sdk 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -26,6 +26,97 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/backup": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Backup all tables or selected tables
+         * @description Creates a backup of all tables or specified tables. Each table's backup includes:
+         *     - Table metadata (schema, indexes, shard configuration)
+         *     - All shard data (compressed with zstd)
+         *
+         *     The backup creates a cluster-level manifest that tracks all included tables
+         *     and their individual backup locations.
+         *
+         *     **Storage Locations:**
+         *     - Local filesystem: `file:///path/to/backup`
+         *     - Amazon S3: `s3://bucket-name/path/to/backup`
+         *
+         *     **Backup Structure:**
+         *     ```
+         *     {location}/
+         *     ├── {backup_id}-cluster-metadata.json   (cluster manifest)
+         *     ├── {table1}-{backup_id}-metadata.json  (table metadata)
+         *     ├── shard-1-{table1}-{backup_id}.tar.zst
+         *     ├── shard-2-{table1}-{backup_id}.tar.zst
+         *     ├── {table2}-{backup_id}-metadata.json
+         *     └── ...
+         *     ```
+         */
+        post: operations["backup"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/restore": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Restore multiple tables from a backup
+         * @description Restores tables from a cluster backup. Can restore all tables or a subset.
+         *
+         *     **Restore Modes:**
+         *     - `fail_if_exists`: Abort if any target table already exists (default)
+         *     - `skip_if_exists`: Skip existing tables and restore the rest
+         *     - `overwrite`: Drop existing tables and restore from backup
+         *
+         *     The restore is asynchronous - this endpoint triggers the restore process
+         *     and returns immediately. The actual data restoration happens via the
+         *     reconciliation loop as shards are started.
+         */
+        post: operations["restore"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/backups": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List available backups
+         * @description Lists all cluster-level backups available at the specified location.
+         *     Returns metadata about each backup including the tables included,
+         *     timestamp, and Antfly version.
+         */
+        get: operations["listBackups"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/query": {
         parameters: {
             query?: never;
@@ -435,7 +526,7 @@ interface paths {
         get?: never;
         put?: never;
         /** Perform batch inserts and deletes on a table */
-        post: operations["batch"];
+        post: operations["batchWrite"];
         delete?: never;
         options?: never;
         head?: never;
@@ -1208,6 +1299,14 @@ interface components$1 {
             transforms?: components$1["schemas"]["Transform"][];
             sync_level?: components$1["schemas"]["SyncLevel"];
         };
+        BatchResponse: {
+            /** @description Number of documents successfully inserted */
+            inserted?: number;
+            /** @description Number of documents successfully deleted */
+            deleted?: number;
+            /** @description Number of documents successfully transformed */
+            transformed?: number;
+        };
         BackupRequest: {
             /**
              * @description Unique identifier for this backup. Used to reference the backup for restore operations.
@@ -1226,6 +1325,151 @@ interface components$1 {
             location: string;
         };
         RestoreRequest: components$1["schemas"]["BackupRequest"];
+        ClusterBackupRequest: {
+            /**
+             * @description Unique identifier for this backup. Used to reference the backup for restore operations.
+             *     Choose a meaningful name that includes date/version information.
+             * @example cluster-backup-2025-01-15
+             */
+            backup_id: string;
+            /**
+             * @description Storage location for the backup. Supports multiple backends:
+             *     - Local filesystem: `file:///path/to/backup`
+             *     - Amazon S3: `s3://bucket-name/path/to/backup`
+             *
+             *     The backup includes all table data, indexes, and metadata.
+             * @example s3://mybucket/antfly-backups/cluster/2025-01-15
+             */
+            location: string;
+            /**
+             * @description Optional list of tables to backup. If omitted, all tables are backed up.
+             * @example [
+             *       "users",
+             *       "products"
+             *     ]
+             */
+            table_names?: string[];
+        };
+        ClusterBackupResponse: {
+            /**
+             * @description The backup identifier
+             * @example cluster-backup-2025-01-15
+             */
+            backup_id: string;
+            /** @description Status of each table backup */
+            tables: components$1["schemas"]["TableBackupStatus"][];
+            /**
+             * @description Overall backup status
+             * @example completed
+             * @enum {string}
+             */
+            status: "completed" | "partial" | "failed";
+        };
+        TableBackupStatus: {
+            /**
+             * @description Table name
+             * @example users
+             */
+            name: string;
+            /**
+             * @description Backup status for this table
+             * @example completed
+             * @enum {string}
+             */
+            status: "completed" | "failed" | "skipped";
+            /** @description Error message if backup failed */
+            error?: string;
+        };
+        ClusterRestoreRequest: {
+            /**
+             * @description Unique identifier of the backup to restore from.
+             * @example cluster-backup-2025-01-15
+             */
+            backup_id: string;
+            /**
+             * @description Storage location where the backup is stored.
+             * @example s3://mybucket/antfly-backups/cluster/2025-01-15
+             */
+            location: string;
+            /**
+             * @description Optional list of tables to restore. If omitted, all tables in the backup are restored.
+             * @example [
+             *       "users",
+             *       "products"
+             *     ]
+             */
+            table_names?: string[];
+            /**
+             * @description How to handle existing tables:
+             *     - `fail_if_exists`: Abort if any table already exists (default)
+             *     - `skip_if_exists`: Skip existing tables, restore others
+             *     - `overwrite`: Drop and recreate existing tables
+             * @default fail_if_exists
+             * @example skip_if_exists
+             * @enum {string}
+             */
+            restore_mode?: "fail_if_exists" | "skip_if_exists" | "overwrite";
+        };
+        ClusterRestoreResponse: {
+            /** @description Status of each table restore */
+            tables: components$1["schemas"]["TableRestoreStatus"][];
+            /**
+             * @description Overall restore status
+             * @example triggered
+             * @enum {string}
+             */
+            status: "triggered" | "partial" | "failed";
+        };
+        TableRestoreStatus: {
+            /**
+             * @description Table name
+             * @example users
+             */
+            name: string;
+            /**
+             * @description Restore status for this table
+             * @example triggered
+             * @enum {string}
+             */
+            status: "triggered" | "skipped" | "failed";
+            /** @description Error message if restore failed */
+            error?: string;
+        };
+        BackupInfo: {
+            /**
+             * @description The backup identifier
+             * @example cluster-backup-2025-01-15
+             */
+            backup_id: string;
+            /**
+             * Format: date-time
+             * @description When the backup was created
+             * @example 2025-01-15T10:30:00Z
+             */
+            timestamp: string;
+            /**
+             * @description Tables included in the backup
+             * @example [
+             *       "users",
+             *       "products"
+             *     ]
+             */
+            tables: string[];
+            /**
+             * @description Storage location of the backup
+             * @example s3://mybucket/antfly-backups/cluster/2025-01-15
+             */
+            location: string;
+            /**
+             * @description Antfly version that created the backup
+             * @example v1.0.0
+             */
+            antfly_version?: string;
+        };
+        BackupListResponse: {
+            /** @description List of available backups */
+            backups: components$1["schemas"]["BackupInfo"][];
+        };
         RAGRequest: {
             /**
              * @description Array of retrieval queries to execute. Each query must specify a table and can specify its own limit and document_renderer.
@@ -1290,11 +1534,11 @@ interface components$1 {
              */
             eval?: components$1["schemas"]["EvalConfig"];
         };
-        /** @description RAG result with individual query results and summary */
+        /** @description RAG result with individual query results and generation/evaluation outcome */
         RAGResult: {
             /** @description Results from each query. Check each result's status and error fields for failures. */
             query_results?: components$1["schemas"]["QueryResult"][];
-            summary_result?: components$1["schemas"]["SummarizeResult"];
+            generate_result?: components$1["schemas"]["GenerateResult"];
             /** @description Evaluation results when eval config was provided in the request */
             eval_result?: components$1["schemas"]["EvalResult"];
         };
@@ -1366,6 +1610,17 @@ interface components$1 {
              * @example What are the best gaming laptops under $2000?
              */
             query: string;
+            /**
+             * @description Background knowledge that guides the agent's understanding of the domain.
+             *     Similar to CLAUDE.md, this provides context that applies to all steps
+             *     (classification, retrieval, and answer generation).
+             *
+             *     Examples:
+             *     - "This data contains medical records. Use clinical terminology and be precise about diagnoses."
+             *     - "This is a software engineering knowledge base. Assume a technical audience."
+             *     - "This table stores legal documents. Reference laws and regulations accurately."
+             */
+            agent_knowledge?: string;
             /**
              * @description Default generator configuration used for all pipeline steps unless overridden in `steps`.
              *     This is the simple configuration - just set this and everything works with sensible defaults.
@@ -2916,6 +3171,68 @@ interface components$1 {
              */
             presence_penalty?: number;
         };
+        /**
+         * @description Configuration for the OpenRouter generative AI provider.
+         *
+         *     OpenRouter provides a unified API for multiple LLM providers with automatic fallback routing.
+         *     API key via `api_key` field or `OPENROUTER_API_KEY` environment variable.
+         *
+         *     **Model Selection:**
+         *     - Use `model` for a single model (e.g., "openai/gpt-4.1", "anthropic/claude-sonnet-4-5-20250929")
+         *     - Use `models` array for fallback routing - OpenRouter tries models in order until one succeeds
+         *
+         *     **Example Models:** openai/gpt-4.1, anthropic/claude-sonnet-4-5-20250929, google/gemini-2.5-flash,
+         *     meta-llama/llama-3.3-70b-instruct
+         *
+         *     **Docs:** https://openrouter.ai/docs/api/api-reference/chat/send-chat-completion-request
+         * @example {
+         *       "provider": "openrouter",
+         *       "model": "openai/gpt-4.1",
+         *       "temperature": 0.7,
+         *       "max_tokens": 4096
+         *     }
+         */
+        OpenRouterGeneratorConfig: {
+            /**
+             * @description Single model identifier (e.g., 'openai/gpt-4.1'). Either model or models must be provided.
+             * @example openai/gpt-4.1
+             */
+            model?: string;
+            /**
+             * @description Array of model identifiers for fallback routing. OpenRouter tries each model in order
+             *     until one succeeds. Either model or models must be provided.
+             * @example [
+             *       "openai/gpt-4.1",
+             *       "anthropic/claude-sonnet-4-5-20250929",
+             *       "google/gemini-2.5-flash"
+             *     ]
+             */
+            models?: string[];
+            /** @description The OpenRouter API key. Can also be set via OPENROUTER_API_KEY environment variable. */
+            api_key?: string;
+            /**
+             * Format: float
+             * @description Controls randomness in generation (0.0-2.0). Higher values make output more random.
+             */
+            temperature?: number;
+            /** @description Maximum number of tokens to generate in the response. */
+            max_tokens?: number;
+            /**
+             * Format: float
+             * @description Nucleus sampling parameter (0.0-1.0). Alternative to temperature.
+             */
+            top_p?: number;
+            /**
+             * Format: float
+             * @description Penalty for token frequency (-2.0 to 2.0).
+             */
+            frequency_penalty?: number;
+            /**
+             * Format: float
+             * @description Penalty for token presence (-2.0 to 2.0).
+             */
+            presence_penalty?: number;
+        };
         /**
          * @description Configuration for the AWS Bedrock generative AI provider.
          *
@@ -3045,7 +3362,7 @@ interface components$1 {
          * @description The generative AI provider to use.
          * @enum {string}
          */
-        GeneratorProvider: "gemini" | "vertex" | "ollama" | "openai" | "bedrock" | "anthropic" | "cohere" | "mock";
+        GeneratorProvider: "gemini" | "vertex" | "ollama" | "openai" | "openrouter" | "bedrock" | "anthropic" | "cohere" | "mock";
         /**
          * @description A unified configuration for a generative AI provider.
          *
@@ -3215,7 +3532,7 @@ interface components$1 {
          *       "max_tokens": 2048
          *     }
          */
-        GeneratorConfig: (components$1["schemas"]["GoogleGeneratorConfig"] | components$1["schemas"]["VertexGeneratorConfig"] | components$1["schemas"]["OllamaGeneratorConfig"] | components$1["schemas"]["OpenAIGeneratorConfig"] | components$1["schemas"]["BedrockGeneratorConfig"] | components$1["schemas"]["AnthropicGeneratorConfig"] | components$1["schemas"]["CohereGeneratorConfig"]) & {
+        GeneratorConfig: (components$1["schemas"]["GoogleGeneratorConfig"] | components$1["schemas"]["VertexGeneratorConfig"] | components$1["schemas"]["OllamaGeneratorConfig"] | components$1["schemas"]["OpenAIGeneratorConfig"] | components$1["schemas"]["OpenRouterGeneratorConfig"] | components$1["schemas"]["BedrockGeneratorConfig"] | components$1["schemas"]["AnthropicGeneratorConfig"] | components$1["schemas"]["CohereGeneratorConfig"]) & {
             provider: components$1["schemas"]["GeneratorProvider"];
         };
         /** @description Retry configuration for generator calls */
@@ -3328,10 +3645,10 @@ interface components$1 {
             /** @description Evaluation options (k, thresholds, etc.) */
             options?: components$1["schemas"]["EvalOptions"];
         };
-        /** @description Result of a summarization operation. The summary is formatted as markdown with inline resource references using [resource_id <id>] or [resource_id <id1>, <id2>] format. */
-        SummarizeResult: {
-            /** @description The generated summary text in markdown format with inline resource references like [resource_id res1] or [resource_id res1, res2] */
-            summary: string;
+        /** @description Result of a generate operation. Formatted as markdown by default with inline resource references using [resource_id <id>] or [resource_id <id1>, <id2>] format. */
+        GenerateResult: {
+            /** @description The generated text in markdown format with inline resource references like [resource_id res1] or [resource_id res1, res2] */
+            text: string;
         };
         /** @description Result from a single evaluator */
         EvaluatorScore: {
@@ -3837,6 +4154,33 @@ interface components$1 {
          * @enum {string}
          */
         WebSearchProvider: "google" | "bing" | "serper" | "tavily" | "brave" | "duckduckgo";
+        Credentials: {
+            /**
+             * @description S3-compatible endpoint (e.g., 's3.amazonaws.com' or 'localhost:9000' for MinIO)
+             * @example s3.amazonaws.com
+             */
+            endpoint?: string;
+            /**
+             * @description Enable SSL/TLS for S3 connections (default: true for AWS, false for local MinIO)
+             * @default true
+             */
+            use_ssl?: boolean;
+            /**
+             * @description AWS access key ID. Supports keystore syntax for secret lookup. Falls back to AWS_ACCESS_KEY_ID environment variable if not set.
+             * @example your-access-key-id
+             */
+            access_key_id?: string;
+            /**
+             * @description AWS secret access key. Supports keystore syntax for secret lookup. Falls back to AWS_SECRET_ACCESS_KEY environment variable if not set.
+             * @example your-secret-access-key
+             */
+            secret_access_key?: string;
+            /**
+             * @description Optional AWS session token for temporary credentials. Supports keystore syntax for secret lookup.
+             * @example your-session-token
+             */
+            session_token?: string;
+        };
         /**
          * @description Configuration for URL content fetching.
          *
@@ -3846,6 +4190,7 @@ interface components$1 {
          *     - PDF files (extracts text)
          *     - Images (returns as data URIs)
          *     - Plain text files
+         *     - S3 URLs (requires s3_credentials)
          *
          *     Security features (from lib/scraping.ContentSecurityConfig):
          *     - Allowed host whitelist
@@ -3854,6 +4199,8 @@ interface components$1 {
          *     - Timeout controls
          */
         FetchConfig: {
+            /** @description S3 credentials for fetching S3 URLs. If not set, uses package-level defaults. */
+            s3_credentials?: components$1["schemas"]["Credentials"];
             /**
              * @description Maximum content length in characters (truncated if exceeded)
              * @default 50000
@@ -4151,6 +4498,34 @@ interface components$1 {
             /** @description Output dimension for the embedding (uses MRL for dimension reduction). Recommended: 256, 512, 1024, 1536, or 3072. */
             dimensions?: number;
         };
+        /**
+         * @description Configuration for the OpenRouter embedding provider.
+         *
+         *     OpenRouter provides a unified API for multiple embedding models from different providers.
+         *     API key via `api_key` field or `OPENROUTER_API_KEY` environment variable.
+         *
+         *     **Example Models:** openai/text-embedding-3-small (default), openai/text-embedding-3-large,
+         *     google/gemini-embedding-001, qwen/qwen3-embedding-8b
+         *
+         *     **Docs:** https://openrouter.ai/docs/api/reference/embeddings
+         * @example {
+         *       "provider": "openrouter",
+         *       "model": "openai/text-embedding-3-small",
+         *       "api_key": "sk-or-..."
+         *     }
+         */
+        OpenRouterEmbedderConfig: {
+            /**
+             * @description The OpenRouter model identifier (e.g., 'openai/text-embedding-3-small', 'google/gemini-embedding-001').
+             * @default openai/text-embedding-3-small
+             * @example openai/text-embedding-3-small
+             */
+            model: string;
+            /** @description The OpenRouter API key. Can also be set via OPENROUTER_API_KEY environment variable. */
+            api_key?: string;
+            /** @description Output dimension for the embedding (if supported by the model). */
+            dimensions?: number;
+        };
         /**
          * @description Configuration for the AWS Bedrock embedding provider.
          *
@@ -4227,7 +4602,7 @@ interface components$1 {
          * @description The embedding provider to use.
          * @enum {string}
          */
-        EmbedderProvider: "gemini" | "vertex" | "ollama" | "openai" | "bedrock" | "cohere" | "mock";
+        EmbedderProvider: "gemini" | "vertex" | "ollama" | "openai" | "openrouter" | "bedrock" | "cohere" | "mock";
         /**
          * @description A unified configuration for an embedding provider.
          *
@@ -4401,9 +4776,25 @@ interface components$1 {
          *       "model": "text-embedding-3-small"
          *     }
          */
-        EmbedderConfig: (components$1["schemas"]["GoogleEmbedderConfig"] | components$1["schemas"]["VertexEmbedderConfig"] | components$1["schemas"]["OllamaEmbedderConfig"] | components$1["schemas"]["OpenAIEmbedderConfig"] | components$1["schemas"]["BedrockEmbedderConfig"] | components$1["schemas"]["CohereEmbedderConfig"]) & {
+        EmbedderConfig: (components$1["schemas"]["GoogleEmbedderConfig"] | components$1["schemas"]["VertexEmbedderConfig"] | components$1["schemas"]["OllamaEmbedderConfig"] | components$1["schemas"]["OpenAIEmbedderConfig"] | components$1["schemas"]["OpenRouterEmbedderConfig"] | components$1["schemas"]["BedrockEmbedderConfig"] | components$1["schemas"]["CohereEmbedderConfig"]) & {
             provider: components$1["schemas"]["EmbedderProvider"];
         };
+        /** @description Per-request configuration for chunking. All fields are optional - zero/omitted values use chunker defaults. */
+        ChunkOptions: {
+            /** @description Maximum number of chunks to generate per document. */
+            max_chunks?: number;
+            /** @description Number of tokens to overlap between consecutive chunks. Helps maintain context across chunk boundaries. Only used by fixed-size chunkers. */
+            overlap_tokens?: number;
+            /** @description Separator string for splitting (e.g., '\n\n' for paragraphs). Only used by fixed-size chunkers. */
+            separator?: string;
+            /**
+             * Format: float
+             * @description Minimum confidence threshold for separator detection (0.0-1.0). Only used by ONNX models.
+             */
+            threshold?: number;
+            /** @description Target number of tokens per chunk. */
+            target_tokens?: number;
+        };
         /**
          * @description Configuration for the Termite chunking provider.
          *
@@ -4429,7 +4820,7 @@ interface components$1 {
          *       "full_text": {}
          *     }
          */
-        TermiteChunkerConfig: {
+        TermiteChunkerConfig: components$1["schemas"]["ChunkOptions"] & {
             /**
              * Format: uri
              * @description The URL of the Termite API endpoint (e.g., 'http://localhost:8080'). Can also be set via ANTFLY_TERMITE_URL environment variable.
@@ -4442,32 +4833,6 @@ interface components$1 {
              * @example fixed
              */
             model: string;
-            /**
-             * @description Target number of tokens per chunk. Chunker will aim for chunks around this size.
-             * @default 500
-             */
-            target_tokens?: number;
-            /**
-             * @description Number of tokens to overlap between consecutive chunks. Helps maintain context across chunk boundaries.
-             * @default 50
-             */
-            overlap_tokens?: number;
-            /**
-             * @description Separator string for splitting (e.g., '\n\n' for paragraphs). Only used with fixed strategy.
-             * @default
-             */
-            separator?: string;
-            /**
-             * @description Maximum number of chunks to generate per document. Prevents excessive chunking of very large documents.
-             * @default 50
-             */
-            max_chunks?: number;
-            /**
-             * Format: float
-             * @description Minimum confidence threshold for separator detection. Only used with ONNX-based models.
-             * @default 0.5
-             */
-            threshold?: number;
             /**
              * @description Configuration for full-text indexing of chunks in Bleve.
              *     When present (even if empty), chunks will be stored with :cft: suffix and indexed in Bleve's _chunks field.
@@ -4503,27 +4868,7 @@ interface components$1 {
          *       "max_chunks": 50
          *     }
          */
-        AntflyChunkerConfig: {
-            /**
-             * @description Target number of tokens per chunk. Chunker will aim for chunks around this size.
-             * @default 500
-             */
-            target_tokens?: number;
-            /**
-             * @description Number of tokens to overlap between consecutive chunks. Helps maintain context across chunk boundaries.
-             * @default 50
-             */
-            overlap_tokens?: number;
-            /**
-             * @description Separator string for splitting (e.g., '\n\n' for paragraphs).
-             * @default
-             */
-            separator?: string;
-            /**
-             * @description Maximum number of chunks to generate per document. Prevents excessive chunking of very large documents.
-             * @default 50
-             */
-            max_chunks?: number;
+        AntflyChunkerConfig: components$1["schemas"]["ChunkOptions"] & {
             /**
              * @description Configuration for full-text indexing of chunks in Bleve.
              *     When present (even if empty), chunks will be stored with :cft: suffix and indexed in Bleve's _chunks field.
@@ -4840,6 +5185,88 @@ interface operations {
             500: components$1["responses"]["InternalServerError"];
         };
     };
+    backup: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components$1["schemas"]["ClusterBackupRequest"];
+            };
+        };
+        responses: {
+            /** @description Backup completed successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components$1["schemas"]["ClusterBackupResponse"];
+                };
+            };
+            400: components$1["responses"]["BadRequest"];
+            500: components$1["responses"]["InternalServerError"];
+        };
+    };
+    restore: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components$1["schemas"]["ClusterRestoreRequest"];
+            };
+        };
+        responses: {
+            /** @description Restore triggered successfully */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components$1["schemas"]["ClusterRestoreResponse"];
+                };
+            };
+            400: components$1["responses"]["BadRequest"];
+            500: components$1["responses"]["InternalServerError"];
+        };
+    };
+    listBackups: {
+        parameters: {
+            query: {
+                /**
+                 * @description Storage location to search for backups.
+                 *     - Local filesystem: `file:///path/to/backup`
+                 *     - Amazon S3: `s3://bucket-name/path/to/backup`
+                 * @example s3://mybucket/antfly-backups/
+                 */
+                location: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of available backups */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components$1["schemas"]["BackupListResponse"];
+                };
+            };
+            400: components$1["responses"]["BadRequest"];
+            500: components$1["responses"]["InternalServerError"];
+        };
+    };
     globalQuery: {
         parameters: {
             query?: never;
@@ -5291,7 +5718,7 @@ interface operations {
             };
         };
     };
-    batch: {
+    batchWrite: {
         parameters: {
             query?: never;
             header?: never;
@@ -5313,19 +5740,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        /** @description Number of documents successfully inserted */
-                        inserted?: number;
-                        /** @description Number of documents successfully deleted */
-                        deleted?: number;
-                        /** @description List of failed operations with error details */
-                        failed?: {
-                            /** @description The document ID that failed */
-                            id?: string;
-                            /** @description Error message for this failure */
-                            error?: string;
-                        }[];
-                    };
+                    "application/json": components$1["schemas"]["BatchResponse"];
                 };
             };
             400: components$1["responses"]["BadRequest"];
@@ -6325,6 +6740,10 @@ type ResourceType = components$1["schemas"]["ResourceType"];
 type PermissionType = components$1["schemas"]["PermissionType"];
 type BackupRequest = components$1["schemas"]["BackupRequest"];
 type RestoreRequest = components$1["schemas"]["RestoreRequest"];
+type ScanKeysRequest = Omit<components$1["schemas"]["ScanKeysRequest"], "filter_query"> & {
+    /** Full JSON Bleve filter query with proper type checking */
+    filter_query?: BleveQuery;
+};
 type DocumentSchema = components$1["schemas"]["DocumentSchema"];
 type FacetOption = components$1["schemas"]["FacetOption"];
 type FacetResult = components$1["schemas"]["FacetResult"];
@@ -6337,7 +6756,7 @@ type EmbedderProvider = components$1["schemas"]["EmbedderProvider"];
 declare const embedderProviders: components$1["schemas"]["EmbedderProvider"][];
 type GeneratorProvider = components$1["schemas"]["GeneratorProvider"];
 declare const generatorProviders: components$1["schemas"]["GeneratorProvider"][];
-type SummarizeResult = components$1["schemas"]["SummarizeResult"];
+type GenerateResult = components$1["schemas"]["GenerateResult"];
 type RAGResult = components$1["schemas"]["RAGResult"];
 type AnswerAgentRequest = components$1["schemas"]["AnswerAgentRequest"];
 type AnswerAgentResult = components$1["schemas"]["AnswerAgentResult"];
@@ -6623,10 +7042,7 @@ declare class AntflyClient {
         batch: (tableName: string, request: BatchRequest) => Promise<{
             inserted?: number;
             deleted?: number;
-            failed?: {
-                id?: string;
-                error?: string;
-            }[];
+            transformed?: number;
         }>;
         /**
          * Backup a table
@@ -6642,10 +7058,38 @@ declare class AntflyClient {
         }>;
         /**
          * Lookup a specific key in a table
+         * @param tableName - Name of the table
+         * @param key - Key of the record to lookup
+         * @param options - Optional parameters
+         * @param options.fields - Comma-separated list of fields to include (e.g., "title,author,metadata.tags")
+         */
+        lookup: (tableName: string, key: string, options?: {
+            fields?: string;
+        }) => Promise<{
+            [key: string]: unknown;
+        }>;
+        /**
+         * Scan keys in a table within a key range
+         * Returns documents as an async iterable, streaming results as NDJSON.
+         * @param tableName - Name of the table
+         * @param request - Scan request with optional key range, field projection, and filtering
+         * @returns AsyncGenerator yielding documents with their keys
          */
-        lookup: (tableName: string, key: string) => Promise<{
+        scan: (tableName: string, request?: ScanKeysRequest) => AsyncGenerator<{
+            _key: string;
             [key: string]: unknown;
         }>;
+        /**
+         * Scan keys in a table and collect all results into an array
+         * Convenience method that consumes the scan AsyncGenerator
+         * @param tableName - Name of the table
+         * @param request - Scan request with optional key range, field projection, and filtering
+         * @returns Promise with array of all matching documents
+         */
+        scanAll: (tableName: string, request?: ScanKeysRequest) => Promise<Array<{
+            _key: string;
+            [key: string]: unknown;
+        }>>;
         /**
          * RAG (Retrieval-Augmented Generation) query on a specific table with streaming or citations
          * @param tableName - Name of the table to query
@@ -6987,4 +7431,4 @@ declare function geoBoundingBox(field: string, bounds: {
  * ```
  */
 
-export { type AnswerAgentRequest, type AnswerAgentResult, type AnswerAgentStreamCallbacks, type AnswerConfidence, AntflyClient, type AntflyConfig, type AntflyError, type AntflyType, type BackupRequest, type BatchRequest, type ChatAgentRequest, type ChatAgentResult, type ChatAgentSteps, type ChatAgentStreamCallbacks, type ChatMessage, type ChatMessageRole, type ChatToolCall, type ChatToolName, type ChatToolResult, type ChatToolsConfig, type ClarificationRequest, type ClassificationTransformationResult, type CreateTableRequest, type CreateUserRequest, type DocumentSchema, type EmbedderConfig, type EmbedderProvider, type FacetOption, type FacetResult, type FetchConfig, type FilterSpec, type GeneratorConfig, type GeneratorProvider, type IndexConfig, type IndexStatus, type Permission, type PermissionType, type QueryBuilderRequest, type QueryBuilderResult, type QueryHit, type QueryOptions, type QueryRequest, type QueryResponses, type QueryResult, type QueryStrategy, type RAGRequest, type RAGResult, type RAGStreamCallbacks, type RerankerConfig, type ResourceType, type ResponseData, type RestoreRequest, type RouteType, type SemanticQueryMode, type SummarizeResult, type Table, type TableSchema, type TableStatus, type TermFacetResult, type UpdatePasswordRequest, type User, type WebSearchConfig, type WebSearchResultItem, type components as bleve_components, boolean, type components$1 as components, conjunction, dateRange, AntflyClient as default, disjunction, docIds, embedderProviders, fuzzy, generatorProviders, geoBoundingBox, geoDistance, match, matchAll, matchNone, matchPhrase, numericRange, type operations, type paths, prefix, queryString, term };
+export { type AnswerAgentRequest, type AnswerAgentResult, type AnswerAgentStreamCallbacks, type AnswerConfidence, AntflyClient, type AntflyConfig, type AntflyError, type AntflyType, type BackupRequest, type BatchRequest, type ChatAgentRequest, type ChatAgentResult, type ChatAgentSteps, type ChatAgentStreamCallbacks, type ChatMessage, type ChatMessageRole, type ChatToolCall, type ChatToolName, type ChatToolResult, type ChatToolsConfig, type ClarificationRequest, type ClassificationTransformationResult, type CreateTableRequest, type CreateUserRequest, type DocumentSchema, type EmbedderConfig, type EmbedderProvider, type FacetOption, type FacetResult, type FetchConfig, type FilterSpec, type GenerateResult, type GeneratorConfig, type GeneratorProvider, type IndexConfig, type IndexStatus, type Permission, type PermissionType, type QueryBuilderRequest, type QueryBuilderResult, type QueryHit, type QueryOptions, type QueryRequest, type QueryResponses, type QueryResult, type QueryStrategy, type RAGRequest, type RAGResult, type RAGStreamCallbacks, type RerankerConfig, type ResourceType, type ResponseData, type RestoreRequest, type RouteType, type SemanticQueryMode, type Table, type TableSchema, type TableStatus, type TermFacetResult, type UpdatePasswordRequest, type User, type WebSearchConfig, type WebSearchResultItem, type components as bleve_components, boolean, type components$1 as components, conjunction, dateRange, AntflyClient as default, disjunction, docIds, embedderProviders, fuzzy, generatorProviders, geoBoundingBox, geoDistance, match, matchAll, matchNone, matchPhrase, numericRange, type operations, type paths, prefix, queryString, term };