@antfly/sdk 0.0.7 → 0.0.9

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"];
         };
@@ -2927,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.
          *
@@ -3056,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.
          *
@@ -3226,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 */
@@ -3339,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: {
@@ -3848,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.
          *
@@ -3857,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
@@ -3865,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
@@ -4162,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.
          *
@@ -4234,11 +4598,45 @@ interface components$1 {
              */
             truncate?: "NONE" | "START" | "END";
         };
+        /**
+         * @description Configuration for the Termite embedding provider.
+         *
+         *     Termite is Antfly's built-in ML service for local embeddings using ONNX models.
+         *     It provides embedding generation with multi-tier caching (memory + persistent).
+         *
+         *     **Features:**
+         *     - Local ONNX-based embedding generation
+         *     - L1 memory cache with configurable TTL
+         *     - L2 persistent Pebble database cache
+         *     - Singleflight deduplication for concurrent identical requests
+         *
+         *     **Example Models:** bge-base-en-v1.5 (768 dims), all-MiniLM-L6-v2 (384 dims)
+         *
+         *     Models are loaded from the `models/embedders/{name}/` directory.
+         * @example {
+         *       "provider": "termite",
+         *       "model": "bge-base-en-v1.5",
+         *       "api_url": "http://localhost:8082"
+         *     }
+         */
+        TermiteEmbedderConfig: {
+            /**
+             * @description The embedding model name (maps to models/embedders/{name}/ directory).
+             * @example bge-base-en-v1.5
+             */
+            model: string;
+            /**
+             * Format: uri
+             * @description The URL of the Termite API endpoint. Can also be set via ANTFLY_TERMITE_URL environment variable.
+             * @example http://localhost:8082
+             */
+            api_url?: string;
+        };
         /**
          * @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" | "termite";
         /**
          * @description A unified configuration for an embedding provider.
          *
@@ -4412,7 +4810,7 @@ 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"] | components$1["schemas"]["TermiteEmbedderConfig"]) & {
             provider: components$1["schemas"]["EmbedderProvider"];
         };
         /** @description Per-request configuration for chunking. All fields are optional - zero/omitted values use chunker defaults. */
@@ -4821,6 +5219,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;
@@ -5272,7 +5752,7 @@ interface operations {
             };
         };
     };
-    batch: {
+    batchWrite: {
         parameters: {
             query?: never;
             header?: never;
@@ -5294,19 +5774,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"];
@@ -6306,6 +6774,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"];
@@ -6318,7 +6790,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"];
@@ -6604,10 +7076,7 @@ declare class AntflyClient {
         batch: (tableName: string, request: BatchRequest) => Promise<{
             inserted?: number;
             deleted?: number;
-            failed?: {
-                id?: string;
-                error?: string;
-            }[];
+            transformed?: number;
         }>;
         /**
          * Backup a table
@@ -6623,10 +7092,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) => Promise<{
+        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
+         */
+        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
@@ -6968,4 +7465,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 };