@mastra/s3vectors 1.1.4 → 1.1.5

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-s3vectors
 description: Documentation for @mastra/s3vectors. Use when working with @mastra/s3vectors APIs, configuration, or implementation.
 metadata:
   package: "@mastra/s3vectors"
-  version: "1.1.4"
+  version: "1.1.5"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.4",
+  "version": "1.1.5",
   "package": "@mastra/s3vectors",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-rag-retrieval.md

@@ -382,11 +382,12 @@ Vector store prompts define query patterns and filtering capabilities for each v
 
 ```ts
 import { MONGODB_PROMPT } from '@mastra/mongodb'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${MONGODB_PROMPT}
@@ -403,7 +404,7 @@ import { PGVECTOR_PROMPT } from '@mastra/pg'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PGVECTOR_PROMPT}
@@ -416,11 +417,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { PINECONE_PROMPT } from '@mastra/pinecone'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PINECONE_PROMPT}
@@ -433,11 +435,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { QDRANT_PROMPT } from '@mastra/qdrant'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${QDRANT_PROMPT}
@@ -450,11 +453,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { CHROMA_PROMPT } from '@mastra/chroma'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${CHROMA_PROMPT}
@@ -467,11 +471,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { ASTRA_PROMPT } from '@mastra/astra'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ASTRA_PROMPT}
@@ -484,11 +489,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { LIBSQL_PROMPT } from '@mastra/libsql'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${LIBSQL_PROMPT}
@@ -501,11 +507,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { UPSTASH_PROMPT } from '@mastra/upstash'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${UPSTASH_PROMPT}
@@ -518,11 +525,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { VECTORIZE_PROMPT } from '@mastra/vectorize'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${VECTORIZE_PROMPT}
@@ -535,11 +543,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { OPENSEARCH_PROMPT } from '@mastra/opensearch'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${OPENSEARCH_PROMPT}
@@ -552,11 +561,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { ORACLEDB_PROMPT } from '@mastra/oracledb'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ORACLEDB_PROMPT}
@@ -569,11 +579,12 @@ export const ragAgent = new Agent({
 
 ```ts
 import { S3VECTORS_PROMPT } from '@mastra/s3vectors'
+import { Agent } from '@mastra/core/agent'
 
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${S3VECTORS_PROMPT}
@@ -605,7 +616,7 @@ const initialResults = await pgVector.query({
 // Create a relevance scorer
 const relevanceProvider = new MastraAgentRelevanceScorer(
   'relevance-scorer',
-  'openai/gpt-5.6-sol',
+  'openai/gpt-6.1-sol',
 )
 
 // Re-rank the results

package/dist/docs/references/reference-vectors-s3vectors.md

@@ -40,6 +40,7 @@ bun add @mastra/s3vectors@latest
 import { S3Vectors } from '@mastra/s3vectors'
 
 const store = new S3Vectors({
+  id: 's3-vectors',
   vectorBucketName: process.env.S3_VECTORS_BUCKET_NAME!, // e.g. "my-vector-bucket"
   clientConfig: {
     region: process.env.AWS_REGION!, // credentials use the default AWS provider chain
@@ -88,6 +89,8 @@ await store.disconnect()
 
 ## Constructor options
 
+**id** (`string`): Unique identifier for this vector store instance
+
 **vectorBucketName** (`string`): Target S3 Vectors vector bucket name.
 
 **clientConfig** (`S3VectorsClientConfig`): AWS SDK v3 client options (e.g., region, credentials).

package/dist/index.cjs

@@ -5,7 +5,7 @@ let _mastra_core_error = require("@mastra/core/error");
 let _mastra_core_storage = require("@mastra/core/storage");
 let _mastra_core_vector = require("@mastra/core/vector");
 let _mastra_core_vector_filter = require("@mastra/core/vector/filter");
-//#region src/vector/filter.ts
+// src/vector/filter.ts
 /**
 * Translates a high-level filter into the S3 Vectors filter shape.
 *
@@ -149,8 +149,7 @@ var S3VectorsFilterTranslator = class extends _mastra_core_vector_filter.BaseFil
 		return filter === void 0 || filter === null || typeof filter === "object" && Object.keys(filter).length === 0;
 	}
 };
-//#endregion
-//#region src/vector/index.ts
+// src/vector/index.ts
 /** Maximum number of keys accepted by a single S3 Vectors DeleteVectors request. */
 const DELETE_VECTORS_BATCH_SIZE = 500;
 /**
@@ -687,8 +686,7 @@ function normalizeIndexName(str) {
 	if (typeof str !== "string") throw new TypeError("Index name must be a string");
 	return str.replace(/_/g, "-").toLowerCase();
 }
-//#endregion
-//#region src/vector/prompt.ts
+// src/vector/prompt.ts
 /**
 * Vector store specific prompt that details supported operators and examples.
 * This prompt helps users construct valid filters for Amazon S3 Vectors.
@@ -770,7 +768,6 @@ Example Complex Query:
     ] }
   ]
 }`;
-//#endregion
 exports.S3VECTORS_PROMPT = S3VECTORS_PROMPT;
 exports.S3Vectors = S3Vectors;
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["BaseFilterTranslator","MastraVector","MastraError","createVectorErrorId","ErrorDomain","ErrorCategory","S3VectorsClient","CreateIndexCommand","uuidv4","PutVectorsCommand","QueryVectorsCommand","GetVectorsCommand","ListIndexesCommand","DeleteIndexCommand","DeleteVectorsCommand","GetIndexCommand","ListVectorsCommand"],"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n  VectorFilter,\n  LogicalOperatorValueMap,\n  OperatorSupport,\n  QueryOperator,\n  OperatorValueMap,\n  BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\n/**\n * S3 Vectors supports a strict subset of operators and value types.\n *\n * - logical: `$and`, `$or` (non-empty arrays)\n * - basic:   `$eq`, `$ne` (string | number | boolean)\n * - numeric: `$gt`, `$gte`, `$lt`, `$lte` (number)\n * - array:   `$in`, `$nin` (non-empty arrays of string | number | boolean)\n * - element: `$exists` (boolean)\n */\ntype S3VectorsOperatorValueMap = Pick<\n  OperatorValueMap,\n  '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin' | '$exists'\n>;\n\ntype S3VectorsLogicalOperatorValueMap = Pick<LogicalOperatorValueMap, '$and' | '$or'>;\n\ntype S3VectorsBlacklisted = BlacklistedRootOperators;\n\ntype S3VectorsFieldValue = string | number | boolean;\n\n/**\n * High-level filter type accepted by this translator.\n * @remarks\n * Field values are limited to string/number/boolean at equality positions.\n */\nexport type S3VectorsFilter = VectorFilter<\n  keyof S3VectorsOperatorValueMap,\n  S3VectorsOperatorValueMap,\n  S3VectorsLogicalOperatorValueMap,\n  S3VectorsBlacklisted,\n  S3VectorsFieldValue\n>;\n\n/**\n * Translates a high-level filter into the S3 Vectors filter shape.\n *\n * @remarks\n * - Canonicalizes **implicit AND** (e.g. `{a:1,b:2}`) into explicit `{$and:[{a:1},{b:2}]}` in any\n *   non-field context that lacks `$and/$or`.\n * - Normalizes `Date` values to epoch milliseconds where allowed (numeric comparisons and array elements).\n * - Disallows `Date` at equality positions (including implicit equality).\n * - Validates shapes using the base class after translation.\n */\nexport class S3VectorsFilterTranslator extends BaseFilterTranslator<S3VectorsFilter> {\n  /** @inheritdoc */\n  protected override getSupportedOperators(): OperatorSupport {\n    return {\n      logical: ['$and', '$or'],\n      basic: ['$eq', '$ne'],\n      numeric: ['$gt', '$gte', '$lt', '$lte'],\n      array: ['$in', '$nin'],\n      element: ['$exists'],\n    };\n  }\n\n  /**\n   * Translates and validates a filter.\n   * @param filter - Input filter; may be `undefined`, `null`, or `{}` (all treated as empty).\n   * @returns The translated filter (or the original value if empty).\n   */\n  translate(filter?: S3VectorsFilter): any {\n    if (this.isEmpty(filter)) return filter;\n    // Perform translation (including Date → number normalization) before base shape validation.\n    const translated = this.translateNode(filter as any, false);\n    this.validateFilter(translated as any);\n    return translated;\n  }\n\n  /**\n   * Recursively translates a node.\n   * @param node - Current node to translate.\n   * @param inFieldValue - When `true`, the node is the value of a field (i.e., equality context).\n   * @remarks\n   * - In a **field-value** context, only primitives or operator objects are allowed.\n   * - In a **non-field** context (root / logical branches), operator keys are processed;\n   *   plain keys become field equalities and are validated.\n   * - Implicit AND is canonicalized in non-field contexts when multiple non-logical keys exist.\n   */\n  private translateNode(node: any, inFieldValue = false): any {\n    // Primitive or Date (normalize when in a field-equality context)\n    if (this.isPrimitive(node) || node instanceof Date) {\n      return inFieldValue ? this.validateAndNormalizePrimitive(node) : node;\n    }\n\n    // Arrays are not allowed as direct equality values\n    if (Array.isArray(node)) {\n      if (inFieldValue) {\n        throw new Error('Array equality is not supported in S3 Vectors. Use $in / $nin operators.');\n      }\n      return node;\n    }\n\n    // Object\n    const entries = Object.entries(node as Record<string, any>);\n\n    if (inFieldValue) {\n      if (entries.length === 0) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const allOperatorKeys = entries.every(([k]) => this.isOperator(k));\n      if (!allOperatorKeys) {\n        // Disallow shapes like: { field: { a:1, b:2 } }\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const opEntries = entries.map(([key, value]) => [key, this.translateOperatorValue(key as QueryOperator, value)]);\n      return Object.fromEntries(opEntries);\n    }\n\n    // Root / filter context\n    const translatedEntries = entries.map(([key, value]) => {\n      if (this.isOperator(key)) {\n        return [key, this.translateOperatorValue(key as QueryOperator, value)];\n      }\n      return [key, this.translateNode(value, true)];\n    });\n    const obj = Object.fromEntries(translatedEntries);\n\n    // Canonicalize implicit AND → explicit $and (if no $and/$or present and multiple non-logical keys)\n    const keys = Object.keys(obj);\n    const hasLogical = keys.some(k => k === '$and' || k === '$or');\n    if (!hasLogical) {\n      const nonLogical = keys.filter(k => k !== '$and' && k !== '$or');\n      if (nonLogical.length > 1) {\n        return { $and: nonLogical.map(k => ({ [k]: obj[k] })) };\n      }\n    }\n\n    return obj;\n  }\n\n  /**\n   * Translates a single operator and validates its value.\n   * @param operator - One of the supported query operators.\n   * @param value - Operator value to normalize/validate.\n   */\n  private translateOperatorValue(operator: QueryOperator, value: any): any {\n    // Logical operators\n    if (operator === '$and' || operator === '$or') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for logical operator ${operator} must be a non-empty array`);\n      }\n      return value.map(item => this.translateNode(item));\n    }\n\n    // Equality / inequality (Date is not allowed)\n    if (operator === '$eq' || operator === '$ne') {\n      if (value instanceof Date) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      return this.toPrimitiveForS3(value, operator);\n    }\n\n    // Numeric comparisons: require number; allow Date by converting to epoch ms\n    if (operator === '$gt' || operator === '$gte' || operator === '$lt' || operator === '$lte') {\n      const n = this.toNumberForRange(value, operator);\n      return n;\n    }\n\n    // Array operators: non-empty arrays of primitives (Date converted to number)\n    if (operator === '$in' || operator === '$nin') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for array operator ${operator} must be a non-empty array`);\n      }\n      return value.map(v => this.toPrimitiveForS3(v, operator));\n    }\n\n    // Existence check\n    if (operator === '$exists') {\n      if (typeof value !== 'boolean') {\n        throw new Error(`Value for $exists operator must be a boolean`);\n      }\n      return value;\n    }\n\n    throw new Error(`Unsupported operator: ${operator}`);\n  }\n\n  /**\n   * Normalizes a value to an S3-accepted primitive.\n   * @param value - String | Number | Boolean | Date.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @returns The normalized primitive; `Date` becomes epoch milliseconds.\n   * @throws If the value is not a supported primitive or is null/undefined.\n   */\n  private toPrimitiveForS3(value: any, operatorForMessage: string): string | number | boolean {\n    if (value === null || value === undefined) {\n      // Error message for equality matches tests\n      if (operatorForMessage === 'equality') {\n        throw new Error('S3 Vectors does not support null/undefined for equality');\n      }\n      throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n    }\n    if (value instanceof Date) {\n      return value.getTime();\n    }\n    const t = typeof value;\n    if (t === 'string' || t === 'boolean') return value;\n    if (t === 'number') return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n  }\n\n  /**\n   * Ensures a numeric value for range operators; allows `Date` by converting to epoch ms.\n   * @param value - Candidate value.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @throws If the value is not a number (or a Date).\n   */\n  private toNumberForRange(value: any, operatorForMessage: string): number {\n    if (value instanceof Date) return value.getTime();\n    if (typeof value === 'number' && !Number.isNaN(value)) return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be a number`);\n  }\n\n  /**\n   * Validates and normalizes a primitive used in field equality (implicit `$eq`).\n   * @param value - Candidate equality value.\n   * @throws If the value is a `Date` or not a supported primitive.\n   */\n  private validateAndNormalizePrimitive(value: any): S3VectorsFieldValue {\n    if (value instanceof Date) {\n      throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n    }\n    return this.toPrimitiveForS3(value, 'equality') as S3VectorsFieldValue;\n  }\n\n  /**\n   * Determines whether a filter is considered empty.\n   * @param filter - Input filter.\n   */\n  protected override isEmpty(filter: any): boolean {\n    return filter === undefined || filter === null || (typeof filter === 'object' && Object.keys(filter).length === 0);\n  }\n}\n","import {\n  S3VectorsClient,\n  CreateIndexCommand,\n  DeleteIndexCommand,\n  ListIndexesCommand,\n  GetIndexCommand,\n  PutVectorsCommand,\n  QueryVectorsCommand,\n  GetVectorsCommand,\n  DeleteVectorsCommand,\n  ListVectorsCommand,\n} from '@aws-sdk/client-s3vectors';\nimport type { S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';\nimport { v4 as uuidv4 } from '@lukeed/uuid';\nimport { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { createVectorErrorId } from '@mastra/core/storage';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n  QueryResult,\n  IndexStats,\n  CreateIndexParams,\n  UpsertVectorParams,\n  DeleteVectorsParams,\n  QueryVectorParams,\n  DescribeIndexParams,\n  DeleteIndexParams,\n  DeleteVectorParams,\n  UpdateVectorParams,\n} from '@mastra/core/vector';\nimport { S3VectorsFilterTranslator } from './filter';\nimport type { S3VectorsFilter } from './filter';\n\n/**\n * Options for the S3Vectors store.\n * @property vectorBucketName - Target S3 Vectors bucket name.\n * @property clientConfig - AWS SDK client options (e.g., region/credentials).\n * @property nonFilterableMetadataKeys - Metadata keys that must not be filterable (forwarded to S3 Vectors).\n */\nexport interface S3VectorsOptions {\n  vectorBucketName: string;\n  clientConfig?: S3VectorsClientConfig;\n  nonFilterableMetadataKeys?: string[];\n}\n\ntype S3DistanceMetric = 'cosine' | 'euclidean';\ntype MastraMetric = NonNullable<CreateIndexParams['metric']>;\ntype SupportedMastraMetric = Exclude<MastraMetric, 'dotproduct'>;\n\n/** Maximum number of keys accepted by a single S3 Vectors DeleteVectors request. */\nconst DELETE_VECTORS_BATCH_SIZE = 500;\n\n/**\n * Vector store backed by Amazon S3 Vectors.\n *\n * @remarks\n * - Supports `cosine` and `euclidean` distance metrics.\n * - Filters must use explicit logical operators (`$and` / `$or`). The attached translator\n *   canonicalizes implicit AND (e.g., `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`) where permitted by spec.\n * - Methods wrap AWS errors in `MastraError` with domain/category metadata.\n */\nexport class S3Vectors extends MastraVector<S3VectorsFilter> {\n  private readonly client: S3VectorsClient;\n  private readonly vectorBucketName: string;\n  private readonly nonFilterableMetadataKeys?: string[];\n  private readonly filterTranslator = new S3VectorsFilterTranslator();\n\n  private static readonly METRIC_MAP: Record<SupportedMastraMetric, S3DistanceMetric> = {\n    cosine: 'cosine',\n    euclidean: 'euclidean',\n  } as const;\n\n  constructor(opts: S3VectorsOptions & { id: string }) {\n    super({ id: opts.id });\n    if (!opts?.vectorBucketName) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'INITIALIZATION', 'MISSING_BUCKET_NAME'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n        },\n        new Error('vectorBucketName is required'),\n      );\n    }\n    this.vectorBucketName = opts.vectorBucketName;\n    this.nonFilterableMetadataKeys = opts.nonFilterableMetadataKeys;\n    this.client = new S3VectorsClient({ ...(opts.clientConfig ?? {}) });\n  }\n\n  /**\n   * No-op to satisfy the base interface.\n   *\n   * @remarks The AWS SDK manages HTTP per request; no persistent connection is needed.\n   */\n  async connect(): Promise<void> {}\n\n  /**\n   * Closes the underlying AWS SDK HTTP handler to free sockets.\n   */\n  async disconnect(): Promise<void> {\n    try {\n      this.client.destroy();\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DISCONNECT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Creates an index or validates an existing one.\n   *\n   * @param params.indexName - Logical index name; normalized internally.\n   * @param params.dimension - Vector dimension (must be a positive integer).\n   * @param params.metric - Distance metric (`cosine` | `euclidean`). Defaults to `cosine`.\n   * @throws {MastraError} If arguments are invalid or AWS returns an error.\n   * @remarks\n   * On `ConflictException`, we verify the existing index schema via the parent implementation\n   * and return if it matches.\n   */\n  async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n\n    let s3Metric: S3DistanceMetric;\n    try {\n      assertPositiveInteger(dimension, 'dimension');\n      s3Metric = S3Vectors.toS3Metric(metric);\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'INVALID_ARGS'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n\n    try {\n      const input: any = {\n        ...this.bucketParams(),\n        indexName,\n        dataType: 'float32',\n        dimension,\n        distanceMetric: s3Metric,\n      };\n      if (this.nonFilterableMetadataKeys?.length) {\n        input.metadataConfiguration = { nonFilterableMetadataKeys: this.nonFilterableMetadataKeys };\n      }\n\n      await this.client.send(new CreateIndexCommand(input));\n    } catch (error: any) {\n      if (error?.name === 'ConflictException') {\n        await this.validateExistingIndex(indexName, dimension, metric);\n        return;\n      }\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Upserts vectors in bulk.\n   *\n   * @param params.indexName - Index to write to.\n   * @param params.vectors - Array of vectors; each must match the index dimension.\n   * @param params.metadata - Optional metadata per vector; `Date` values are normalized to epoch ms.\n   * @param params.ids - Optional explicit IDs; if omitted, UUIDs are generated.\n   * @returns Array of IDs used for the upsert (explicit or generated).\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   */\n  async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension } = await this.getIndexInfo(indexName);\n      validateVectorDimensions(vectors, dimension);\n\n      const generatedIds = ids ?? vectors.map(() => uuidv4());\n\n      const putInput = {\n        ...this.bucketParams(),\n        indexName,\n        vectors: vectors.map((vec, i) => ({\n          key: generatedIds[i],\n          data: { float32: vec },\n          metadata: normalizeMetadata(metadata?.[i]),\n        })),\n      };\n\n      await this.client.send(new PutVectorsCommand(putInput));\n      return generatedIds;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPSERT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Queries nearest neighbors.\n   *\n   * @param params.indexName - Target index.\n   * @param params.queryVector - Query vector (non-empty float32 array).\n   * @param params.topK - Number of neighbors to return (positive integer). Defaults to 10.\n   * @param params.filter - Metadata filter using explicit `$and`/`$or` (translator canonicalizes implicit AND).\n   * @param params.includeVector - If `true`, fetches missing vector data in a second call.\n   * @returns Results sorted by `score` descending.\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   * @remarks\n   * `score = 1/(1+distance)` (monotonic transform), so ranking matches the underlying distance.\n   */\n  async query({\n    indexName,\n    queryVector,\n    topK = 10,\n    filter,\n    includeVector = false,\n  }: QueryVectorParams<S3VectorsFilter>): Promise<QueryResult[]> {\n    indexName = normalizeIndexName(indexName);\n\n    if (!queryVector) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'QUERY', 'MISSING_VECTOR'),\n        text: 'queryVector is required for S3 Vectors queries. Metadata-only queries are not supported by this vector store.',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    try {\n      if (!Array.isArray(queryVector) || queryVector.length === 0) {\n        throw new Error('queryVector must be a non-empty float32 array');\n      }\n      assertPositiveInteger(topK, 'topK');\n\n      const translated = this.transformFilter(filter);\n\n      const out = await this.client.send(\n        new QueryVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          topK,\n          queryVector: { float32: queryVector },\n          filter: translated && Object.keys(translated).length > 0 ? (translated as any) : undefined,\n          returnMetadata: true,\n          returnDistance: true,\n        }),\n      );\n\n      const vectors = (out.vectors ?? []).filter(v => !!v?.key);\n\n      // Query results don't include vector data; fetch via GetVectors when requested.\n      let dataMap: Record<string, number[] | undefined> | undefined;\n      if (includeVector) {\n        const keys = vectors.filter(v => v.key).map(v => v.key!) as string[];\n\n        if (keys.length > 0) {\n          const got = await this.client.send(\n            new GetVectorsCommand({\n              ...this.bucketParams(),\n              indexName,\n              keys,\n              returnData: true,\n              returnMetadata: false,\n            }),\n          );\n          dataMap = {};\n          for (const g of got.vectors ?? []) {\n            if (g.key) dataMap[g.key] = g.data?.float32 as number[] | undefined;\n          }\n        }\n      }\n\n      return vectors.map(v => {\n        const id = v.key!;\n        const score = S3Vectors.distanceToScore(v.distance ?? 0);\n\n        const result: QueryResult = { id, score };\n\n        const md = v.metadata as Record<string, unknown> | undefined;\n        if (md !== undefined) result.metadata = md;\n\n        if (includeVector) {\n          const vec = dataMap?.[id];\n          if (vec !== undefined) result.vector = vec;\n        }\n\n        return result;\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'QUERY', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Lists indexes within the configured bucket.\n   *\n   * @returns Array of index names.\n   * @throws {MastraError} On AWS errors.\n   */\n  async listIndexes(): Promise<string[]> {\n    try {\n      const names: string[] = [];\n      let nextToken: string | undefined;\n\n      do {\n        const out = await this.client.send(\n          new ListIndexesCommand({\n            ...this.bucketParams(),\n            nextToken,\n          } as any),\n        );\n        for (const idx of out.indexes ?? []) {\n          if (idx.indexName) names.push(idx.indexName);\n        }\n        nextToken = out.nextToken;\n      } while (nextToken);\n\n      return names;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'LIST_INDEXES', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Returns index attributes.\n   *\n   * @param params.indexName - Index name.\n   * @returns Object containing `dimension`, `metric`, and `count`.\n   * @throws {MastraError} On AWS errors.\n   * @remarks\n   * `count` is computed via `ListVectors` pagination and may be costly (O(n)).\n   */\n  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension, metric } = await this.getIndexInfo(indexName);\n      const count = await this.countVectors(indexName);\n      return { dimension, metric, count };\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DESCRIBE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes an index.\n   *\n   * @param params.indexName - Index name.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(new DeleteIndexCommand({ ...this.bucketParams(), indexName } as any));\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Updates (replaces) a vector and/or its metadata by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID.\n   * @param params.update.vector - New vector; if omitted, the existing vector is reused.\n   * @param params.update.metadata - New metadata, merged with current metadata.\n   * @throws {MastraError} If the vector does not exist and `update.vector` is omitted, or on AWS error.\n   * @remarks\n   * S3 Vectors `PutVectors` is replace-all; we `Get` the current item, merge, then `Put`.\n   */\n  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n    if (!id) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'INVALID_ARGS'),\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        text: 'id is required for S3Vectors updateVector',\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      if (!update.vector && !update.metadata) {\n        throw new Error('No updates provided');\n      }\n\n      const got = await this.client.send(\n        new GetVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n          returnData: true,\n          returnMetadata: true,\n        }),\n      );\n      const current = (got.vectors ?? [])[0];\n\n      const newVector: number[] | undefined = update.vector ?? (current?.data?.float32 as number[] | undefined);\n      if (!newVector) {\n        throw new Error(`Vector \"${id}\" not found. Provide update.vector to create it.`);\n      }\n\n      const newMetadata =\n        update.metadata !== undefined\n          ? normalizeMetadata(update.metadata)\n          : ((current?.metadata as Record<string, any>) ?? {});\n\n      await this.client.send(\n        new PutVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          vectors: [{ key: id, data: { float32: newVector }, metadata: newMetadata }],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes a vector by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID to delete.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(\n        new DeleteVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  async deleteVectors({ indexName, filter, ids }: DeleteVectorsParams): Promise<void> {\n    if (ids && filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'MUTUALLY_EXCLUSIVE'),\n        text: 'Cannot specify both ids and filter - they are mutually exclusive',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'UNSUPPORTED_FILTER'),\n        text: 'Deleting by metadata filter is not supported for S3Vectors vector store - delete by ids instead',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.SYSTEM,\n        details: { indexName, filter: JSON.stringify(filter) },\n      });\n    }\n\n    if (!ids) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'NO_TARGET'),\n        text: 'Either filter or ids must be provided',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (ids.length === 0) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'EMPTY_IDS'),\n        text: 'Cannot delete with empty ids array',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      for (let i = 0; i < ids.length; i += DELETE_VECTORS_BATCH_SIZE) {\n        await this.client.send(\n          new DeleteVectorsCommand({\n            ...this.bucketParams(),\n            indexName,\n            keys: ids.slice(i, i + DELETE_VECTORS_BATCH_SIZE),\n          }),\n        );\n      }\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, idsCount: ids.length },\n        },\n        error,\n      );\n    }\n  }\n\n  // -------- internal helpers --------\n\n  /**\n   * Returns shared bucket parameters for AWS SDK calls.\n   * @internal\n   */\n  private bucketParams(): { vectorBucketName: string } {\n    return { vectorBucketName: this.vectorBucketName };\n  }\n\n  /**\n   * Retrieves index dimension/metric via `GetIndex`.\n   * @internal\n   * @throws {Error} If the index does not exist.\n   * @returns `{ dimension, metric }`, where `metric` includes `'dotproduct'` to satisfy Mastra types (S3 never returns it).\n   */\n  private async getIndexInfo(\n    indexName: string,\n  ): Promise<{ dimension: number; metric: 'cosine' | 'euclidean' | 'dotproduct' }> {\n    const out = await this.client.send(new GetIndexCommand({ ...this.bucketParams(), indexName } as any));\n    const idx = out.index;\n    if (!idx) throw new Error(`Index \"${indexName}\" not found`);\n    const metric = (idx.distanceMetric as S3DistanceMetric) ?? 'cosine';\n    return {\n      dimension: idx.dimension ?? 0,\n      metric,\n    };\n  }\n\n  /**\n   * Pages through `ListVectors` and counts total items.\n   * @internal\n   * @remarks O(n). Avoid calling on hot paths.\n   */\n  private async countVectors(indexName: string): Promise<number> {\n    let total = 0;\n    let nextToken: string | undefined;\n\n    do {\n      const out = await this.client.send(\n        new ListVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          maxResults: 1000,\n          nextToken,\n          returnData: false,\n          returnMetadata: false,\n        }),\n      );\n      total += (out.vectors ?? []).length;\n      nextToken = out.nextToken;\n    } while (nextToken);\n\n    return total;\n  }\n\n  /**\n   * Translates a high-level filter to the S3 Vectors filter shape.\n   * @internal\n   * @remarks Implicit AND is canonicalized by the translator where permitted by spec.\n   */\n  private transformFilter(filter?: S3VectorsFilter): any {\n    if (!filter) return undefined;\n    return this.filterTranslator.translate(filter);\n  }\n\n  /**\n   * Converts a Mastra metric to an S3 metric.\n   * @internal\n   * @throws {Error} If the metric is not supported by S3 Vectors.\n   */\n  private static toS3Metric(metric: MastraMetric): S3DistanceMetric {\n    const m = S3Vectors.METRIC_MAP[metric as SupportedMastraMetric];\n    if (!m) {\n      throw new Error(`Invalid metric: \"${metric}\". S3 Vectors supports only: cosine, euclidean`);\n    }\n    return m;\n  }\n\n  /**\n   * Monotonic transform from distance (smaller is better) to score (larger is better).\n   * @returns Number in (0, 1], preserving ranking.\n   */\n  private static distanceToScore(distance: number): number {\n    return 1 / (1 + distance);\n  }\n}\n\n// --- module-private utilities (not exported) ---\n\n/**\n * Ensures a value is a positive integer.\n * @throws {Error} If the value is not a positive integer.\n * @internal\n */\nfunction assertPositiveInteger(value: number, name: string): void {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new Error(`${name} must be a positive integer`);\n  }\n}\n\n/**\n * Validates that all vectors match the required dimension.\n * @throws {Error} If any vector length differs from `dimension`.\n * @internal\n */\nfunction validateVectorDimensions(vectors: number[][], dimension: number): void {\n  if (!Array.isArray(vectors) || vectors.length === 0) {\n    throw new Error('No vectors provided for validation');\n  }\n  for (let i = 0; i < vectors.length; i++) {\n    const len = vectors[i]?.length;\n    if (len !== dimension) {\n      throw new Error(`Vector at index ${i} has invalid dimension ${len}. Expected ${dimension} dimensions.`);\n    }\n  }\n}\n\n/**\n * Normalizes metadata values for S3 Vectors: `Date` → epoch ms.\n * @internal\n */\nfunction normalizeMetadata(meta: Record<string, any> | undefined): Record<string, any> {\n  if (!meta) return {};\n  const out: Record<string, any> = {};\n  for (const [k, v] of Object.entries(meta)) {\n    out[k] = v instanceof Date ? v.getTime() : v;\n  }\n  return out;\n}\n\n/**\n * Normalizes an index name to this store's canonical form (underscore → hyphen, lowercase).\n * @internal\n * @throws {TypeError} If the provided name is not a string.\n */\nfunction normalizeIndexName(str: string) {\n  if (typeof str !== 'string') {\n    throw new TypeError('Index name must be a string');\n  }\n  return str.replace(/_/g, '-').toLowerCase();\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Amazon S3 Vectors.\n */\nexport const S3VECTORS_PROMPT = `When querying Amazon S3 Vectors, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators (non-empty arrays of string | number | boolean):\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nUnsupported / Disallowed Operators (REJECT if present):\n- $not, $nor, $regex, $all, $elemMatch, $size, $text (and any operator not listed as supported)\n\nRestrictions:\n- Only logical operators ($and, $or) can be used at the top level\n- Empty arrays for $and / $or / $in / $nin are NOT allowed\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n- Equality values must be string, number, or boolean (arrays and objects are not allowed for equality)\n- Filters operate only on filterable metadata keys; using a non-filterable key will fail\n- Filterable metadata values are primitives (string/number/boolean) or arrays of primitives; large/long-text fields should be non-filterable and are not usable in filters\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ] }\n  ]\n}`;\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["BaseFilterTranslator","MastraVector","MastraError","createVectorErrorId","ErrorDomain","ErrorCategory","S3VectorsClient","CreateIndexCommand","uuidv4","PutVectorsCommand","QueryVectorsCommand","GetVectorsCommand","ListIndexesCommand","DeleteIndexCommand","DeleteVectorsCommand","GetIndexCommand","ListVectorsCommand"],"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n  VectorFilter,\n  LogicalOperatorValueMap,\n  OperatorSupport,\n  QueryOperator,\n  OperatorValueMap,\n  BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\n/**\n * S3 Vectors supports a strict subset of operators and value types.\n *\n * - logical: `$and`, `$or` (non-empty arrays)\n * - basic:   `$eq`, `$ne` (string | number | boolean)\n * - numeric: `$gt`, `$gte`, `$lt`, `$lte` (number)\n * - array:   `$in`, `$nin` (non-empty arrays of string | number | boolean)\n * - element: `$exists` (boolean)\n */\ntype S3VectorsOperatorValueMap = Pick<\n  OperatorValueMap,\n  '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin' | '$exists'\n>;\n\ntype S3VectorsLogicalOperatorValueMap = Pick<LogicalOperatorValueMap, '$and' | '$or'>;\n\ntype S3VectorsBlacklisted = BlacklistedRootOperators;\n\ntype S3VectorsFieldValue = string | number | boolean;\n\n/**\n * High-level filter type accepted by this translator.\n * @remarks\n * Field values are limited to string/number/boolean at equality positions.\n */\nexport type S3VectorsFilter = VectorFilter<\n  keyof S3VectorsOperatorValueMap,\n  S3VectorsOperatorValueMap,\n  S3VectorsLogicalOperatorValueMap,\n  S3VectorsBlacklisted,\n  S3VectorsFieldValue\n>;\n\n/**\n * Translates a high-level filter into the S3 Vectors filter shape.\n *\n * @remarks\n * - Canonicalizes **implicit AND** (e.g. `{a:1,b:2}`) into explicit `{$and:[{a:1},{b:2}]}` in any\n *   non-field context that lacks `$and/$or`.\n * - Normalizes `Date` values to epoch milliseconds where allowed (numeric comparisons and array elements).\n * - Disallows `Date` at equality positions (including implicit equality).\n * - Validates shapes using the base class after translation.\n */\nexport class S3VectorsFilterTranslator extends BaseFilterTranslator<S3VectorsFilter> {\n  /** @inheritdoc */\n  protected override getSupportedOperators(): OperatorSupport {\n    return {\n      logical: ['$and', '$or'],\n      basic: ['$eq', '$ne'],\n      numeric: ['$gt', '$gte', '$lt', '$lte'],\n      array: ['$in', '$nin'],\n      element: ['$exists'],\n    };\n  }\n\n  /**\n   * Translates and validates a filter.\n   * @param filter - Input filter; may be `undefined`, `null`, or `{}` (all treated as empty).\n   * @returns The translated filter (or the original value if empty).\n   */\n  translate(filter?: S3VectorsFilter): any {\n    if (this.isEmpty(filter)) return filter;\n    // Perform translation (including Date → number normalization) before base shape validation.\n    const translated = this.translateNode(filter as any, false);\n    this.validateFilter(translated as any);\n    return translated;\n  }\n\n  /**\n   * Recursively translates a node.\n   * @param node - Current node to translate.\n   * @param inFieldValue - When `true`, the node is the value of a field (i.e., equality context).\n   * @remarks\n   * - In a **field-value** context, only primitives or operator objects are allowed.\n   * - In a **non-field** context (root / logical branches), operator keys are processed;\n   *   plain keys become field equalities and are validated.\n   * - Implicit AND is canonicalized in non-field contexts when multiple non-logical keys exist.\n   */\n  private translateNode(node: any, inFieldValue = false): any {\n    // Primitive or Date (normalize when in a field-equality context)\n    if (this.isPrimitive(node) || node instanceof Date) {\n      return inFieldValue ? this.validateAndNormalizePrimitive(node) : node;\n    }\n\n    // Arrays are not allowed as direct equality values\n    if (Array.isArray(node)) {\n      if (inFieldValue) {\n        throw new Error('Array equality is not supported in S3 Vectors. Use $in / $nin operators.');\n      }\n      return node;\n    }\n\n    // Object\n    const entries = Object.entries(node as Record<string, any>);\n\n    if (inFieldValue) {\n      if (entries.length === 0) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const allOperatorKeys = entries.every(([k]) => this.isOperator(k));\n      if (!allOperatorKeys) {\n        // Disallow shapes like: { field: { a:1, b:2 } }\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const opEntries = entries.map(([key, value]) => [key, this.translateOperatorValue(key as QueryOperator, value)]);\n      return Object.fromEntries(opEntries);\n    }\n\n    // Root / filter context\n    const translatedEntries = entries.map(([key, value]) => {\n      if (this.isOperator(key)) {\n        return [key, this.translateOperatorValue(key as QueryOperator, value)];\n      }\n      return [key, this.translateNode(value, true)];\n    });\n    const obj = Object.fromEntries(translatedEntries);\n\n    // Canonicalize implicit AND → explicit $and (if no $and/$or present and multiple non-logical keys)\n    const keys = Object.keys(obj);\n    const hasLogical = keys.some(k => k === '$and' || k === '$or');\n    if (!hasLogical) {\n      const nonLogical = keys.filter(k => k !== '$and' && k !== '$or');\n      if (nonLogical.length > 1) {\n        return { $and: nonLogical.map(k => ({ [k]: obj[k] })) };\n      }\n    }\n\n    return obj;\n  }\n\n  /**\n   * Translates a single operator and validates its value.\n   * @param operator - One of the supported query operators.\n   * @param value - Operator value to normalize/validate.\n   */\n  private translateOperatorValue(operator: QueryOperator, value: any): any {\n    // Logical operators\n    if (operator === '$and' || operator === '$or') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for logical operator ${operator} must be a non-empty array`);\n      }\n      return value.map(item => this.translateNode(item));\n    }\n\n    // Equality / inequality (Date is not allowed)\n    if (operator === '$eq' || operator === '$ne') {\n      if (value instanceof Date) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      return this.toPrimitiveForS3(value, operator);\n    }\n\n    // Numeric comparisons: require number; allow Date by converting to epoch ms\n    if (operator === '$gt' || operator === '$gte' || operator === '$lt' || operator === '$lte') {\n      const n = this.toNumberForRange(value, operator);\n      return n;\n    }\n\n    // Array operators: non-empty arrays of primitives (Date converted to number)\n    if (operator === '$in' || operator === '$nin') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for array operator ${operator} must be a non-empty array`);\n      }\n      return value.map(v => this.toPrimitiveForS3(v, operator));\n    }\n\n    // Existence check\n    if (operator === '$exists') {\n      if (typeof value !== 'boolean') {\n        throw new Error(`Value for $exists operator must be a boolean`);\n      }\n      return value;\n    }\n\n    throw new Error(`Unsupported operator: ${operator}`);\n  }\n\n  /**\n   * Normalizes a value to an S3-accepted primitive.\n   * @param value - String | Number | Boolean | Date.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @returns The normalized primitive; `Date` becomes epoch milliseconds.\n   * @throws If the value is not a supported primitive or is null/undefined.\n   */\n  private toPrimitiveForS3(value: any, operatorForMessage: string): string | number | boolean {\n    if (value === null || value === undefined) {\n      // Error message for equality matches tests\n      if (operatorForMessage === 'equality') {\n        throw new Error('S3 Vectors does not support null/undefined for equality');\n      }\n      throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n    }\n    if (value instanceof Date) {\n      return value.getTime();\n    }\n    const t = typeof value;\n    if (t === 'string' || t === 'boolean') return value;\n    if (t === 'number') return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n  }\n\n  /**\n   * Ensures a numeric value for range operators; allows `Date` by converting to epoch ms.\n   * @param value - Candidate value.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @throws If the value is not a number (or a Date).\n   */\n  private toNumberForRange(value: any, operatorForMessage: string): number {\n    if (value instanceof Date) return value.getTime();\n    if (typeof value === 'number' && !Number.isNaN(value)) return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be a number`);\n  }\n\n  /**\n   * Validates and normalizes a primitive used in field equality (implicit `$eq`).\n   * @param value - Candidate equality value.\n   * @throws If the value is a `Date` or not a supported primitive.\n   */\n  private validateAndNormalizePrimitive(value: any): S3VectorsFieldValue {\n    if (value instanceof Date) {\n      throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n    }\n    return this.toPrimitiveForS3(value, 'equality') as S3VectorsFieldValue;\n  }\n\n  /**\n   * Determines whether a filter is considered empty.\n   * @param filter - Input filter.\n   */\n  protected override isEmpty(filter: any): boolean {\n    return filter === undefined || filter === null || (typeof filter === 'object' && Object.keys(filter).length === 0);\n  }\n}\n","import {\n  S3VectorsClient,\n  CreateIndexCommand,\n  DeleteIndexCommand,\n  ListIndexesCommand,\n  GetIndexCommand,\n  PutVectorsCommand,\n  QueryVectorsCommand,\n  GetVectorsCommand,\n  DeleteVectorsCommand,\n  ListVectorsCommand,\n} from '@aws-sdk/client-s3vectors';\nimport type { S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';\nimport { v4 as uuidv4 } from '@lukeed/uuid';\nimport { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { createVectorErrorId } from '@mastra/core/storage';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n  QueryResult,\n  IndexStats,\n  CreateIndexParams,\n  UpsertVectorParams,\n  DeleteVectorsParams,\n  QueryVectorParams,\n  DescribeIndexParams,\n  DeleteIndexParams,\n  DeleteVectorParams,\n  UpdateVectorParams,\n} from '@mastra/core/vector';\nimport { S3VectorsFilterTranslator } from './filter';\nimport type { S3VectorsFilter } from './filter';\n\n/**\n * Options for the S3Vectors store.\n * @property vectorBucketName - Target S3 Vectors bucket name.\n * @property clientConfig - AWS SDK client options (e.g., region/credentials).\n * @property nonFilterableMetadataKeys - Metadata keys that must not be filterable (forwarded to S3 Vectors).\n */\nexport interface S3VectorsOptions {\n  vectorBucketName: string;\n  clientConfig?: S3VectorsClientConfig;\n  nonFilterableMetadataKeys?: string[];\n}\n\ntype S3DistanceMetric = 'cosine' | 'euclidean';\ntype MastraMetric = NonNullable<CreateIndexParams['metric']>;\ntype SupportedMastraMetric = Exclude<MastraMetric, 'dotproduct'>;\n\n/** Maximum number of keys accepted by a single S3 Vectors DeleteVectors request. */\nconst DELETE_VECTORS_BATCH_SIZE = 500;\n\n/**\n * Vector store backed by Amazon S3 Vectors.\n *\n * @remarks\n * - Supports `cosine` and `euclidean` distance metrics.\n * - Filters must use explicit logical operators (`$and` / `$or`). The attached translator\n *   canonicalizes implicit AND (e.g., `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`) where permitted by spec.\n * - Methods wrap AWS errors in `MastraError` with domain/category metadata.\n */\nexport class S3Vectors extends MastraVector<S3VectorsFilter> {\n  private readonly client: S3VectorsClient;\n  private readonly vectorBucketName: string;\n  private readonly nonFilterableMetadataKeys?: string[];\n  private readonly filterTranslator = new S3VectorsFilterTranslator();\n\n  private static readonly METRIC_MAP: Record<SupportedMastraMetric, S3DistanceMetric> = {\n    cosine: 'cosine',\n    euclidean: 'euclidean',\n  } as const;\n\n  constructor(opts: S3VectorsOptions & { id: string }) {\n    super({ id: opts.id });\n    if (!opts?.vectorBucketName) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'INITIALIZATION', 'MISSING_BUCKET_NAME'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n        },\n        new Error('vectorBucketName is required'),\n      );\n    }\n    this.vectorBucketName = opts.vectorBucketName;\n    this.nonFilterableMetadataKeys = opts.nonFilterableMetadataKeys;\n    this.client = new S3VectorsClient({ ...(opts.clientConfig ?? {}) });\n  }\n\n  /**\n   * No-op to satisfy the base interface.\n   *\n   * @remarks The AWS SDK manages HTTP per request; no persistent connection is needed.\n   */\n  async connect(): Promise<void> {}\n\n  /**\n   * Closes the underlying AWS SDK HTTP handler to free sockets.\n   */\n  async disconnect(): Promise<void> {\n    try {\n      this.client.destroy();\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DISCONNECT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Creates an index or validates an existing one.\n   *\n   * @param params.indexName - Logical index name; normalized internally.\n   * @param params.dimension - Vector dimension (must be a positive integer).\n   * @param params.metric - Distance metric (`cosine` | `euclidean`). Defaults to `cosine`.\n   * @throws {MastraError} If arguments are invalid or AWS returns an error.\n   * @remarks\n   * On `ConflictException`, we verify the existing index schema via the parent implementation\n   * and return if it matches.\n   */\n  async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n\n    let s3Metric: S3DistanceMetric;\n    try {\n      assertPositiveInteger(dimension, 'dimension');\n      s3Metric = S3Vectors.toS3Metric(metric);\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'INVALID_ARGS'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n\n    try {\n      const input: any = {\n        ...this.bucketParams(),\n        indexName,\n        dataType: 'float32',\n        dimension,\n        distanceMetric: s3Metric,\n      };\n      if (this.nonFilterableMetadataKeys?.length) {\n        input.metadataConfiguration = { nonFilterableMetadataKeys: this.nonFilterableMetadataKeys };\n      }\n\n      await this.client.send(new CreateIndexCommand(input));\n    } catch (error: any) {\n      if (error?.name === 'ConflictException') {\n        await this.validateExistingIndex(indexName, dimension, metric);\n        return;\n      }\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Upserts vectors in bulk.\n   *\n   * @param params.indexName - Index to write to.\n   * @param params.vectors - Array of vectors; each must match the index dimension.\n   * @param params.metadata - Optional metadata per vector; `Date` values are normalized to epoch ms.\n   * @param params.ids - Optional explicit IDs; if omitted, UUIDs are generated.\n   * @returns Array of IDs used for the upsert (explicit or generated).\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   */\n  async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension } = await this.getIndexInfo(indexName);\n      validateVectorDimensions(vectors, dimension);\n\n      const generatedIds = ids ?? vectors.map(() => uuidv4());\n\n      const putInput = {\n        ...this.bucketParams(),\n        indexName,\n        vectors: vectors.map((vec, i) => ({\n          key: generatedIds[i],\n          data: { float32: vec },\n          metadata: normalizeMetadata(metadata?.[i]),\n        })),\n      };\n\n      await this.client.send(new PutVectorsCommand(putInput));\n      return generatedIds;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPSERT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Queries nearest neighbors.\n   *\n   * @param params.indexName - Target index.\n   * @param params.queryVector - Query vector (non-empty float32 array).\n   * @param params.topK - Number of neighbors to return (positive integer). Defaults to 10.\n   * @param params.filter - Metadata filter using explicit `$and`/`$or` (translator canonicalizes implicit AND).\n   * @param params.includeVector - If `true`, fetches missing vector data in a second call.\n   * @returns Results sorted by `score` descending.\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   * @remarks\n   * `score = 1/(1+distance)` (monotonic transform), so ranking matches the underlying distance.\n   */\n  async query({\n    indexName,\n    queryVector,\n    topK = 10,\n    filter,\n    includeVector = false,\n  }: QueryVectorParams<S3VectorsFilter>): Promise<QueryResult[]> {\n    indexName = normalizeIndexName(indexName);\n\n    if (!queryVector) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'QUERY', 'MISSING_VECTOR'),\n        text: 'queryVector is required for S3 Vectors queries. Metadata-only queries are not supported by this vector store.',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    try {\n      if (!Array.isArray(queryVector) || queryVector.length === 0) {\n        throw new Error('queryVector must be a non-empty float32 array');\n      }\n      assertPositiveInteger(topK, 'topK');\n\n      const translated = this.transformFilter(filter);\n\n      const out = await this.client.send(\n        new QueryVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          topK,\n          queryVector: { float32: queryVector },\n          filter: translated && Object.keys(translated).length > 0 ? (translated as any) : undefined,\n          returnMetadata: true,\n          returnDistance: true,\n        }),\n      );\n\n      const vectors = (out.vectors ?? []).filter(v => !!v?.key);\n\n      // Query results don't include vector data; fetch via GetVectors when requested.\n      let dataMap: Record<string, number[] | undefined> | undefined;\n      if (includeVector) {\n        const keys = vectors.filter(v => v.key).map(v => v.key!) as string[];\n\n        if (keys.length > 0) {\n          const got = await this.client.send(\n            new GetVectorsCommand({\n              ...this.bucketParams(),\n              indexName,\n              keys,\n              returnData: true,\n              returnMetadata: false,\n            }),\n          );\n          dataMap = {};\n          for (const g of got.vectors ?? []) {\n            if (g.key) dataMap[g.key] = g.data?.float32 as number[] | undefined;\n          }\n        }\n      }\n\n      return vectors.map(v => {\n        const id = v.key!;\n        const score = S3Vectors.distanceToScore(v.distance ?? 0);\n\n        const result: QueryResult = { id, score };\n\n        const md = v.metadata as Record<string, unknown> | undefined;\n        if (md !== undefined) result.metadata = md;\n\n        if (includeVector) {\n          const vec = dataMap?.[id];\n          if (vec !== undefined) result.vector = vec;\n        }\n\n        return result;\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'QUERY', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Lists indexes within the configured bucket.\n   *\n   * @returns Array of index names.\n   * @throws {MastraError} On AWS errors.\n   */\n  async listIndexes(): Promise<string[]> {\n    try {\n      const names: string[] = [];\n      let nextToken: string | undefined;\n\n      do {\n        const out = await this.client.send(\n          new ListIndexesCommand({\n            ...this.bucketParams(),\n            nextToken,\n          } as any),\n        );\n        for (const idx of out.indexes ?? []) {\n          if (idx.indexName) names.push(idx.indexName);\n        }\n        nextToken = out.nextToken;\n      } while (nextToken);\n\n      return names;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'LIST_INDEXES', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Returns index attributes.\n   *\n   * @param params.indexName - Index name.\n   * @returns Object containing `dimension`, `metric`, and `count`.\n   * @throws {MastraError} On AWS errors.\n   * @remarks\n   * `count` is computed via `ListVectors` pagination and may be costly (O(n)).\n   */\n  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension, metric } = await this.getIndexInfo(indexName);\n      const count = await this.countVectors(indexName);\n      return { dimension, metric, count };\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DESCRIBE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes an index.\n   *\n   * @param params.indexName - Index name.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(new DeleteIndexCommand({ ...this.bucketParams(), indexName } as any));\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Updates (replaces) a vector and/or its metadata by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID.\n   * @param params.update.vector - New vector; if omitted, the existing vector is reused.\n   * @param params.update.metadata - New metadata, merged with current metadata.\n   * @throws {MastraError} If the vector does not exist and `update.vector` is omitted, or on AWS error.\n   * @remarks\n   * S3 Vectors `PutVectors` is replace-all; we `Get` the current item, merge, then `Put`.\n   */\n  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n    if (!id) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'INVALID_ARGS'),\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        text: 'id is required for S3Vectors updateVector',\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      if (!update.vector && !update.metadata) {\n        throw new Error('No updates provided');\n      }\n\n      const got = await this.client.send(\n        new GetVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n          returnData: true,\n          returnMetadata: true,\n        }),\n      );\n      const current = (got.vectors ?? [])[0];\n\n      const newVector: number[] | undefined = update.vector ?? (current?.data?.float32 as number[] | undefined);\n      if (!newVector) {\n        throw new Error(`Vector \"${id}\" not found. Provide update.vector to create it.`);\n      }\n\n      const newMetadata =\n        update.metadata !== undefined\n          ? normalizeMetadata(update.metadata)\n          : ((current?.metadata as Record<string, any>) ?? {});\n\n      await this.client.send(\n        new PutVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          vectors: [{ key: id, data: { float32: newVector }, metadata: newMetadata }],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes a vector by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID to delete.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(\n        new DeleteVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  async deleteVectors({ indexName, filter, ids }: DeleteVectorsParams): Promise<void> {\n    if (ids && filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'MUTUALLY_EXCLUSIVE'),\n        text: 'Cannot specify both ids and filter - they are mutually exclusive',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'UNSUPPORTED_FILTER'),\n        text: 'Deleting by metadata filter is not supported for S3Vectors vector store - delete by ids instead',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.SYSTEM,\n        details: { indexName, filter: JSON.stringify(filter) },\n      });\n    }\n\n    if (!ids) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'NO_TARGET'),\n        text: 'Either filter or ids must be provided',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (ids.length === 0) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'EMPTY_IDS'),\n        text: 'Cannot delete with empty ids array',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      for (let i = 0; i < ids.length; i += DELETE_VECTORS_BATCH_SIZE) {\n        await this.client.send(\n          new DeleteVectorsCommand({\n            ...this.bucketParams(),\n            indexName,\n            keys: ids.slice(i, i + DELETE_VECTORS_BATCH_SIZE),\n          }),\n        );\n      }\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, idsCount: ids.length },\n        },\n        error,\n      );\n    }\n  }\n\n  // -------- internal helpers --------\n\n  /**\n   * Returns shared bucket parameters for AWS SDK calls.\n   * @internal\n   */\n  private bucketParams(): { vectorBucketName: string } {\n    return { vectorBucketName: this.vectorBucketName };\n  }\n\n  /**\n   * Retrieves index dimension/metric via `GetIndex`.\n   * @internal\n   * @throws {Error} If the index does not exist.\n   * @returns `{ dimension, metric }`, where `metric` includes `'dotproduct'` to satisfy Mastra types (S3 never returns it).\n   */\n  private async getIndexInfo(\n    indexName: string,\n  ): Promise<{ dimension: number; metric: 'cosine' | 'euclidean' | 'dotproduct' }> {\n    const out = await this.client.send(new GetIndexCommand({ ...this.bucketParams(), indexName } as any));\n    const idx = out.index;\n    if (!idx) throw new Error(`Index \"${indexName}\" not found`);\n    const metric = (idx.distanceMetric as S3DistanceMetric) ?? 'cosine';\n    return {\n      dimension: idx.dimension ?? 0,\n      metric,\n    };\n  }\n\n  /**\n   * Pages through `ListVectors` and counts total items.\n   * @internal\n   * @remarks O(n). Avoid calling on hot paths.\n   */\n  private async countVectors(indexName: string): Promise<number> {\n    let total = 0;\n    let nextToken: string | undefined;\n\n    do {\n      const out = await this.client.send(\n        new ListVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          maxResults: 1000,\n          nextToken,\n          returnData: false,\n          returnMetadata: false,\n        }),\n      );\n      total += (out.vectors ?? []).length;\n      nextToken = out.nextToken;\n    } while (nextToken);\n\n    return total;\n  }\n\n  /**\n   * Translates a high-level filter to the S3 Vectors filter shape.\n   * @internal\n   * @remarks Implicit AND is canonicalized by the translator where permitted by spec.\n   */\n  private transformFilter(filter?: S3VectorsFilter): any {\n    if (!filter) return undefined;\n    return this.filterTranslator.translate(filter);\n  }\n\n  /**\n   * Converts a Mastra metric to an S3 metric.\n   * @internal\n   * @throws {Error} If the metric is not supported by S3 Vectors.\n   */\n  private static toS3Metric(metric: MastraMetric): S3DistanceMetric {\n    const m = S3Vectors.METRIC_MAP[metric as SupportedMastraMetric];\n    if (!m) {\n      throw new Error(`Invalid metric: \"${metric}\". S3 Vectors supports only: cosine, euclidean`);\n    }\n    return m;\n  }\n\n  /**\n   * Monotonic transform from distance (smaller is better) to score (larger is better).\n   * @returns Number in (0, 1], preserving ranking.\n   */\n  private static distanceToScore(distance: number): number {\n    return 1 / (1 + distance);\n  }\n}\n\n// --- module-private utilities (not exported) ---\n\n/**\n * Ensures a value is a positive integer.\n * @throws {Error} If the value is not a positive integer.\n * @internal\n */\nfunction assertPositiveInteger(value: number, name: string): void {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new Error(`${name} must be a positive integer`);\n  }\n}\n\n/**\n * Validates that all vectors match the required dimension.\n * @throws {Error} If any vector length differs from `dimension`.\n * @internal\n */\nfunction validateVectorDimensions(vectors: number[][], dimension: number): void {\n  if (!Array.isArray(vectors) || vectors.length === 0) {\n    throw new Error('No vectors provided for validation');\n  }\n  for (let i = 0; i < vectors.length; i++) {\n    const len = vectors[i]?.length;\n    if (len !== dimension) {\n      throw new Error(`Vector at index ${i} has invalid dimension ${len}. Expected ${dimension} dimensions.`);\n    }\n  }\n}\n\n/**\n * Normalizes metadata values for S3 Vectors: `Date` → epoch ms.\n * @internal\n */\nfunction normalizeMetadata(meta: Record<string, any> | undefined): Record<string, any> {\n  if (!meta) return {};\n  const out: Record<string, any> = {};\n  for (const [k, v] of Object.entries(meta)) {\n    out[k] = v instanceof Date ? v.getTime() : v;\n  }\n  return out;\n}\n\n/**\n * Normalizes an index name to this store's canonical form (underscore → hyphen, lowercase).\n * @internal\n * @throws {TypeError} If the provided name is not a string.\n */\nfunction normalizeIndexName(str: string) {\n  if (typeof str !== 'string') {\n    throw new TypeError('Index name must be a string');\n  }\n  return str.replace(/_/g, '-').toLowerCase();\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Amazon S3 Vectors.\n */\nexport const S3VECTORS_PROMPT = `When querying Amazon S3 Vectors, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators (non-empty arrays of string | number | boolean):\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nUnsupported / Disallowed Operators (REJECT if present):\n- $not, $nor, $regex, $all, $elemMatch, $size, $text (and any operator not listed as supported)\n\nRestrictions:\n- Only logical operators ($and, $or) can be used at the top level\n- Empty arrays for $and / $or / $in / $nin are NOT allowed\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n- Equality values must be string, number, or boolean (arrays and objects are not allowed for equality)\n- Filters operate only on filterable metadata keys; using a non-filterable key will fail\n- Filterable metadata values are primitives (string/number/boolean) or arrays of primitives; large/long-text fields should be non-filterable and are not usable in filters\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ] }\n  ]\n}`;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqDA,IAAa,4BAAb,cAA+CA,2BAAAA,qBAAsC;;CAEnF,wBAA4D;EAC1D,OAAO;GACL,SAAS,CAAC,QAAQ,KAAK;GACvB,OAAO,CAAC,OAAO,KAAK;GACpB,SAAS;IAAC;IAAO;IAAQ;IAAO;GAAM;GACtC,OAAO,CAAC,OAAO,MAAM;GACrB,SAAS,CAAC,SAAS;EACrB;CACF;;;;;;CAOA,UAAU,QAA+B;EACvC,IAAI,KAAK,QAAQ,MAAM,GAAG,OAAO;EAEjC,MAAM,aAAa,KAAK,cAAc,QAAe,KAAK;EAC1D,KAAK,eAAe,UAAiB;EACrC,OAAO;CACT;;;;;;;;;;;CAYA,cAAsB,MAAW,eAAe,OAAY;EAE1D,IAAI,KAAK,YAAY,IAAI,KAAK,gBAAgB,MAC5C,OAAO,eAAe,KAAK,8BAA8B,IAAI,IAAI;EAInE,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,IAAI,cACF,MAAM,IAAI,MAAM,0EAA0E;GAE5F,OAAO;EACT;EAGA,MAAM,UAAU,OAAO,QAAQ,IAA2B;EAE1D,IAAI,cAAc;GAChB,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,qFAAqF;GAGvG,IAAI,CADoB,QAAQ,OAAO,CAAC,OAAO,KAAK,WAAW,CAAC,CAC7C,GAEjB,MAAM,IAAI,MAAM,qFAAqF;GAEvG,MAAM,YAAY,QAAQ,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,KAAK,uBAAuB,KAAsB,KAAK,CAAC,CAAC;GAC/G,OAAO,OAAO,YAAY,SAAS;EACrC;EAGA,MAAM,oBAAoB,QAAQ,KAAK,CAAC,KAAK,WAAW;GACtD,IAAI,KAAK,WAAW,GAAG,GACrB,OAAO,CAAC,KAAK,KAAK,uBAAuB,KAAsB,KAAK,CAAC;GAEvE,OAAO,CAAC,KAAK,KAAK,cAAc,OAAO,IAAI,CAAC;EAC9C,CAAC;EACD,MAAM,MAAM,OAAO,YAAY,iBAAiB;EAGhD,MAAM,OAAO,OAAO,KAAK,GAAG;EAE5B,IAAI,CADe,KAAK,MAAK,MAAK,MAAM,UAAU,MAAM,KAC1C,GAAG;GACf,MAAM,aAAa,KAAK,QAAO,MAAK,MAAM,UAAU,MAAM,KAAK;GAC/D,IAAI,WAAW,SAAS,GACtB,OAAO,EAAE,MAAM,WAAW,KAAI,OAAM,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE;EAE1D;EAEA,OAAO;CACT;;;;;;CAOA,uBAA+B,UAAyB,OAAiB;EAEvE,IAAI,aAAa,UAAU,aAAa,OAAO;GAC7C,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAC5C,MAAM,IAAI,MAAM,8BAA8B,SAAS,2BAA2B;GAEpF,OAAO,MAAM,KAAI,SAAQ,KAAK,cAAc,IAAI,CAAC;EACnD;EAGA,IAAI,aAAa,SAAS,aAAa,OAAO;GAC5C,IAAI,iBAAiB,MACnB,MAAM,IAAI,MAAM,qFAAqF;GAEvG,OAAO,KAAK,iBAAiB,OAAO,QAAQ;EAC9C;EAGA,IAAI,aAAa,SAAS,aAAa,UAAU,aAAa,SAAS,aAAa,QAElF,OADU,KAAK,iBAAiB,OAAO,QAChC;EAIT,IAAI,aAAa,SAAS,aAAa,QAAQ;GAC7C,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAC5C,MAAM,IAAI,MAAM,4BAA4B,SAAS,2BAA2B;GAElF,OAAO,MAAM,KAAI,MAAK,KAAK,iBAAiB,GAAG,QAAQ,CAAC;EAC1D;EAGA,IAAI,aAAa,WAAW;GAC1B,IAAI,OAAO,UAAU,WACnB,MAAM,IAAI,MAAM,8CAA8C;GAEhE,OAAO;EACT;EAEA,MAAM,IAAI,MAAM,yBAAyB,UAAU;CACrD;;;;;;;;CASA,iBAAyB,OAAY,oBAAuD;EAC1F,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW;GAEzC,IAAI,uBAAuB,YACzB,MAAM,IAAI,MAAM,yDAAyD;GAE3E,MAAM,IAAI,MAAM,aAAa,mBAAmB,oCAAoC;EACtF;EACA,IAAI,iBAAiB,MACnB,OAAO,MAAM,QAAQ;EAEvB,MAAM,IAAI,OAAO;EACjB,IAAI,MAAM,YAAY,MAAM,WAAW,OAAO;EAC9C,IAAI,MAAM,UAAU,OAAO,OAAO,GAAG,OAAO,EAAE,IAAI,IAAI;EACtD,MAAM,IAAI,MAAM,aAAa,mBAAmB,oCAAoC;CACtF;;;;;;;CAQA,iBAAyB,OAAY,oBAAoC;EACvE,IAAI,iBAAiB,MAAM,OAAO,MAAM,QAAQ;EAChD,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK,GAAG,OAAO,OAAO,GAAG,OAAO,EAAE,IAAI,IAAI;EACzF,MAAM,IAAI,MAAM,aAAa,mBAAmB,kBAAkB;CACpE;;;;;;CAOA,8BAAsC,OAAiC;EACrE,IAAI,iBAAiB,MACnB,MAAM,IAAI,MAAM,qFAAqF;EAEvG,OAAO,KAAK,iBAAiB,OAAO,UAAU;CAChD;;;;;CAMA,QAA2B,QAAsB;EAC/C,OAAO,WAAW,KAAA,KAAa,WAAW,QAAS,OAAO,WAAW,YAAY,OAAO,KAAK,MAAM,CAAC,CAAC,WAAW;CAClH;AACF;;;ACjMA,MAAM,4BAA4B;;;;;;;;;;AAWlC,IAAa,YAAb,MAAa,kBAAkBC,oBAAAA,aAA8B;CAC3D;CACA;CACA;CACA,mBAAoC,IAAI,0BAA0B;CAElE,OAAwB,aAA8D;EACpF,QAAQ;EACR,WAAW;CACb;CAEA,YAAY,MAAyC;EACnD,MAAM,EAAE,IAAI,KAAK,GAAG,CAAC;EACrB,IAAI,CAAC,MAAM,kBACT,MAAM,IAAIC,mBAAAA,YACR;GACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,qBAAqB;GAC5E,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;EAC1B,mBACA,IAAI,MAAM,8BAA8B,CAC1C;EAEF,KAAK,mBAAmB,KAAK;EAC7B,KAAK,4BAA4B,KAAK;EACtC,KAAK,SAAS,IAAIC,0BAAAA,gBAAgB,EAAE,GAAI,KAAK,gBAAgB,CAAC,EAAG,CAAC;CACpE;;;;;;CAOA,MAAM,UAAyB,CAAC;;;;CAKhC,MAAM,aAA4B;EAChC,IAAI;GACF,KAAK,OAAO,QAAQ;EACtB,SAAS,OAAO;GACd,MAAM,IAAIJ,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,cAAc,QAAQ;IAC3D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;GAC1B,GACA,KACF;EACF;CACF;;;;;;;;;;;;CAaA,MAAM,YAAY,EAAE,WAAW,WAAW,SAAS,YAA8C;EAC/F,YAAY,mBAAmB,SAAS;EAExC,IAAI;EACJ,IAAI;GACF,sBAAsB,WAAW,WAAW;GAC5C,WAAW,UAAU,WAAW,MAAM;EACxC,SAAS,OAAO;GACd,MAAM,IAAIH,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,gBAAgB,cAAc;IACnE,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS;KAAE;KAAW;KAAW;IAAO;GAC1C,GACA,KACF;EACF;EAEA,IAAI;GACF,MAAM,QAAa;IACjB,GAAG,KAAK,aAAa;IACrB;IACA,UAAU;IACV;IACA,gBAAgB;GAClB;GACA,IAAI,KAAK,2BAA2B,QAClC,MAAM,wBAAwB,EAAE,2BAA2B,KAAK,0BAA0B;GAG5F,MAAM,KAAK,OAAO,KAAK,IAAIE,0BAAAA,mBAAmB,KAAK,CAAC;EACtD,SAAS,OAAY;GACnB,IAAI,OAAO,SAAS,qBAAqB;IACvC,MAAM,KAAK,sBAAsB,WAAW,WAAW,MAAM;IAC7D;GACF;GACA,MAAM,IAAIL,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,gBAAgB,QAAQ;IAC7D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS;KAAE;KAAW;KAAW;IAAO;GAC1C,GACA,KACF;EACF;CACF;;;;;;;;;;;CAYA,MAAM,OAAO,EAAE,WAAW,SAAS,UAAU,OAA8C;EACzF,YAAY,mBAAmB,SAAS;EACxC,IAAI;GACF,MAAM,EAAE,cAAc,MAAM,KAAK,aAAa,SAAS;GACvD,yBAAyB,SAAS,SAAS;GAE3C,MAAM,eAAe,OAAO,QAAQ,WAAA,GAAUG,aAAAA,GAAAA,CAAO,CAAC;GAEtD,MAAM,WAAW;IACf,GAAG,KAAK,aAAa;IACrB;IACA,SAAS,QAAQ,KAAK,KAAK,OAAO;KAChC,KAAK,aAAa;KAClB,MAAM,EAAE,SAAS,IAAI;KACrB,UAAU,kBAAkB,WAAW,EAAE;IAC3C,EAAE;GACJ;GAEA,MAAM,KAAK,OAAO,KAAK,IAAIC,0BAAAA,kBAAkB,QAAQ,CAAC;GACtD,OAAO;EACT,SAAS,OAAO;GACd,MAAM,IAAIP,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,UAAU,QAAQ;IACvD,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS,EAAE,UAAU;GACvB,GACA,KACF;EACF;CACF;;;;;;;;;;;;;;CAeA,MAAM,MAAM,EACV,WACA,aACA,OAAO,IACP,QACA,gBAAgB,SAC6C;EAC7D,YAAY,mBAAmB,SAAS;EAExC,IAAI,CAAC,aACH,MAAM,IAAIH,mBAAAA,YAAY;GACpB,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,SAAS,gBAAgB;GAC9D,MAAM;GACN,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;GACxB,SAAS,EAAE,UAAU;EACvB,CAAC;EAGH,IAAI;GACF,IAAI,CAAC,MAAM,QAAQ,WAAW,KAAK,YAAY,WAAW,GACxD,MAAM,IAAI,MAAM,+CAA+C;GAEjE,sBAAsB,MAAM,MAAM;GAElC,MAAM,aAAa,KAAK,gBAAgB,MAAM;GAc9C,MAAM,YAAW,MAZC,KAAK,OAAO,KAC5B,IAAIK,0BAAAA,oBAAoB;IACtB,GAAG,KAAK,aAAa;IACrB;IACA;IACA,aAAa,EAAE,SAAS,YAAY;IACpC,QAAQ,cAAc,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,IAAK,aAAqB,KAAA;IACjF,gBAAgB;IAChB,gBAAgB;GAClB,CAAC,CACH,EAAA,CAEqB,WAAW,CAAC,EAAA,CAAG,QAAO,MAAK,CAAC,CAAC,GAAG,GAAG;GAGxD,IAAI;GACJ,IAAI,eAAe;IACjB,MAAM,OAAO,QAAQ,QAAO,MAAK,EAAE,GAAG,CAAC,CAAC,KAAI,MAAK,EAAE,GAAI;IAEvD,IAAI,KAAK,SAAS,GAAG;KACnB,MAAM,MAAM,MAAM,KAAK,OAAO,KAC5B,IAAIC,0BAAAA,kBAAkB;MACpB,GAAG,KAAK,aAAa;MACrB;MACA;MACA,YAAY;MACZ,gBAAgB;KAClB,CAAC,CACH;KACA,UAAU,CAAC;KACX,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAC9B,IAAI,EAAE,KAAK,QAAQ,EAAE,OAAO,EAAE,MAAM;IAExC;GACF;GAEA,OAAO,QAAQ,KAAI,MAAK;IACtB,MAAM,KAAK,EAAE;IAGb,MAAM,SAAsB;KAAE;KAAI,OAFpB,UAAU,gBAAgB,EAAE,YAAY,CAEhB;IAAE;IAExC,MAAM,KAAK,EAAE;IACb,IAAI,OAAO,KAAA,GAAW,OAAO,WAAW;IAExC,IAAI,eAAe;KACjB,MAAM,MAAM,UAAU;KACtB,IAAI,QAAQ,KAAA,GAAW,OAAO,SAAS;IACzC;IAEA,OAAO;GACT,CAAC;EACH,SAAS,OAAO;GACd,MAAM,IAAIT,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,SAAS,QAAQ;IACtD,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS,EAAE,UAAU;GACvB,GACA,KACF;EACF;CACF;;;;;;;CAQA,MAAM,cAAiC;EACrC,IAAI;GACF,MAAM,QAAkB,CAAC;GACzB,IAAI;GAEJ,GAAG;IACD,MAAM,MAAM,MAAM,KAAK,OAAO,KAC5B,IAAIO,0BAAAA,mBAAmB;KACrB,GAAG,KAAK,aAAa;KACrB;IACF,CAAQ,CACV;IACA,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,GAChC,IAAI,IAAI,WAAW,MAAM,KAAK,IAAI,SAAS;IAE7C,YAAY,IAAI;GAClB,SAAS;GAET,OAAO;EACT,SAAS,OAAO;GACd,MAAM,IAAIV,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,gBAAgB,QAAQ;IAC7D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;GAC1B,GACA,KACF;EACF;CACF;;;;;;;;;;CAWA,MAAM,cAAc,EAAE,aAAuD;EAC3E,YAAY,mBAAmB,SAAS;EACxC,IAAI;GACF,MAAM,EAAE,WAAW,WAAW,MAAM,KAAK,aAAa,SAAS;GAE/D,OAAO;IAAE;IAAW;IAAQ,OAAA,MADR,KAAK,aAAa,SAAS;GACb;EACpC,SAAS,OAAO;GACd,MAAM,IAAIH,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,QAAQ;IAC/D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS,EAAE,UAAU;GACvB,GACA,KACF;EACF;CACF;;;;;;;CAQA,MAAM,YAAY,EAAE,aAA+C;EACjE,YAAY,mBAAmB,SAAS;EACxC,IAAI;GACF,MAAM,KAAK,OAAO,KAAK,IAAIQ,0BAAAA,mBAAmB;IAAE,GAAG,KAAK,aAAa;IAAG;GAAU,CAAQ,CAAC;EAC7F,SAAS,OAAO;GACd,MAAM,IAAIX,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,gBAAgB,QAAQ;IAC7D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS,EAAE,UAAU;GACvB,GACA,KACF;EACF;CACF;;;;;;;;;;;;CAaA,MAAM,aAAa,EAAE,WAAW,IAAI,UAA6C;EAC/E,IAAI,CAAC,IACH,MAAM,IAAIH,mBAAAA,YAAY;GACpB,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,iBAAiB,cAAc;GACpE,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;GACxB,MAAM;GACN,SAAS,EAAE,UAAU;EACvB,CAAC;EAGH,YAAY,mBAAmB,SAAS;EACxC,IAAI;GACF,IAAI,CAAC,OAAO,UAAU,CAAC,OAAO,UAC5B,MAAM,IAAI,MAAM,qBAAqB;GAYvC,MAAM,YAAW,MATC,KAAK,OAAO,KAC5B,IAAIM,0BAAAA,kBAAkB;IACpB,GAAG,KAAK,aAAa;IACrB;IACA,MAAM,CAAC,EAAE;IACT,YAAY;IACZ,gBAAgB;GAClB,CAAC,CACH,EAAA,CACqB,WAAW,CAAC,EAAA,CAAG;GAEpC,MAAM,YAAkC,OAAO,UAAW,SAAS,MAAM;GACzE,IAAI,CAAC,WACH,MAAM,IAAI,MAAM,WAAW,GAAG,iDAAiD;GAGjF,MAAM,cACJ,OAAO,aAAa,KAAA,IAChB,kBAAkB,OAAO,QAAQ,IAC/B,SAAS,YAAoC,CAAC;GAEtD,MAAM,KAAK,OAAO,KAChB,IAAIF,0BAAAA,kBAAkB;IACpB,GAAG,KAAK,aAAa;IACrB;IACA,SAAS,CAAC;KAAE,KAAK;KAAI,MAAM,EAAE,SAAS,UAAU;KAAG,UAAU;IAAY,CAAC;GAC5E,CAAC,CACH;EACF,SAAS,OAAO;GACd,MAAM,IAAIP,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,iBAAiB,QAAQ;IAC9D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS;KACP;KACA,GAAI,MAAM,EAAE,GAAG;IACjB;GACF,GACA,KACF;EACF;CACF;;;;;;;;CASA,MAAM,aAAa,EAAE,WAAW,MAAyC;EACvE,YAAY,mBAAmB,SAAS;EACxC,IAAI;GACF,MAAM,KAAK,OAAO,KAChB,IAAIS,0BAAAA,qBAAqB;IACvB,GAAG,KAAK,aAAa;IACrB;IACA,MAAM,CAAC,EAAE;GACX,CAAC,CACH;EACF,SAAS,OAAO;GACd,MAAM,IAAIZ,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,iBAAiB,QAAQ;IAC9D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS;KACP;KACA,GAAI,MAAM,EAAE,GAAG;IACjB;GACF,GACA,KACF;EACF;CACF;CAEA,MAAM,cAAc,EAAE,WAAW,QAAQ,OAA2C;EAClF,IAAI,OAAO,QACT,MAAM,IAAIH,mBAAAA,YAAY;GACpB,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,oBAAoB;GAC3E,MAAM;GACN,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;GACxB,SAAS,EAAE,UAAU;EACvB,CAAC;EAGH,IAAI,QACF,MAAM,IAAIH,mBAAAA,YAAY;GACpB,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,oBAAoB;GAC3E,MAAM;GACN,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;GACxB,SAAS;IAAE;IAAW,QAAQ,KAAK,UAAU,MAAM;GAAE;EACvD,CAAC;EAGH,IAAI,CAAC,KACH,MAAM,IAAIH,mBAAAA,YAAY;GACpB,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,WAAW;GAClE,MAAM;GACN,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;GACxB,SAAS,EAAE,UAAU;EACvB,CAAC;EAGH,IAAI,IAAI,WAAW,GACjB,MAAM,IAAIH,mBAAAA,YAAY;GACpB,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,WAAW;GAClE,MAAM;GACN,QAAQC,mBAAAA,YAAY;GACpB,UAAUC,mBAAAA,cAAc;GACxB,SAAS,EAAE,UAAU;EACvB,CAAC;EAGH,YAAY,mBAAmB,SAAS;EACxC,IAAI;GACF,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK,2BACnC,MAAM,KAAK,OAAO,KAChB,IAAIS,0BAAAA,qBAAqB;IACvB,GAAG,KAAK,aAAa;IACrB;IACA,MAAM,IAAI,MAAM,GAAG,IAAI,yBAAyB;GAClD,CAAC,CACH;EAEJ,SAAS,OAAO;GACd,MAAM,IAAIZ,mBAAAA,YACR;IACE,KAAA,GAAIC,qBAAAA,oBAAAA,CAAoB,aAAa,kBAAkB,QAAQ;IAC/D,QAAQC,mBAAAA,YAAY;IACpB,UAAUC,mBAAAA,cAAc;IACxB,SAAS;KAAE;KAAW,UAAU,IAAI;IAAO;GAC7C,GACA,KACF;EACF;CACF;;;;;CAQA,eAAqD;EACnD,OAAO,EAAE,kBAAkB,KAAK,iBAAiB;CACnD;;;;;;;CAQA,MAAc,aACZ,WAC+E;EAE/E,MAAM,OAAM,MADM,KAAK,OAAO,KAAK,IAAIU,0BAAAA,gBAAgB;GAAE,GAAG,KAAK,aAAa;GAAG;EAAU,CAAQ,CAAC,EAAA,CACpF;EAChB,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,UAAU,UAAU,YAAY;EAC1D,MAAM,SAAU,IAAI,kBAAuC;EAC3D,OAAO;GACL,WAAW,IAAI,aAAa;GAC5B;EACF;CACF;;;;;;CAOA,MAAc,aAAa,WAAoC;EAC7D,IAAI,QAAQ;EACZ,IAAI;EAEJ,GAAG;GACD,MAAM,MAAM,MAAM,KAAK,OAAO,KAC5B,IAAIC,0BAAAA,mBAAmB;IACrB,GAAG,KAAK,aAAa;IACrB;IACA,YAAY;IACZ;IACA,YAAY;IACZ,gBAAgB;GAClB,CAAC,CACH;GACA,UAAU,IAAI,WAAW,CAAC,EAAA,CAAG;GAC7B,YAAY,IAAI;EAClB,SAAS;EAET,OAAO;CACT;;;;;;CAOA,gBAAwB,QAA+B;EACrD,IAAI,CAAC,QAAQ,OAAO,KAAA;EACpB,OAAO,KAAK,iBAAiB,UAAU,MAAM;CAC/C;;;;;;CAOA,OAAe,WAAW,QAAwC;EAChE,MAAM,IAAI,UAAU,WAAW;EAC/B,IAAI,CAAC,GACH,MAAM,IAAI,MAAM,oBAAoB,OAAO,+CAA+C;EAE5F,OAAO;CACT;;;;;CAMA,OAAe,gBAAgB,UAA0B;EACvD,OAAO,KAAK,IAAI;CAClB;AACF;;;;;;AASA,SAAS,sBAAsB,OAAe,MAAoB;CAChE,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,MAAM,GAAG,KAAK,4BAA4B;AAExD;;;;;;AAOA,SAAS,yBAAyB,SAAqB,WAAyB;CAC9E,IAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,GAChD,MAAM,IAAI,MAAM,oCAAoC;CAEtD,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACvC,MAAM,MAAM,QAAQ,EAAE,EAAE;EACxB,IAAI,QAAQ,WACV,MAAM,IAAI,MAAM,mBAAmB,EAAE,yBAAyB,IAAI,aAAa,UAAU,aAAa;CAE1G;AACF;;;;;AAMA,SAAS,kBAAkB,MAA4D;CACrF,IAAI,CAAC,MAAM,OAAO,CAAC;CACnB,MAAM,MAA2B,CAAC;CAClC,KAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,GACtC,IAAI,KAAK,aAAa,OAAO,EAAE,QAAQ,IAAI;CAE7C,OAAO;AACT;;;;;;AAOA,SAAS,mBAAmB,KAAa;CACvC,IAAI,OAAO,QAAQ,UACjB,MAAM,IAAI,UAAU,6BAA6B;CAEnD,OAAO,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,YAAY;AAC5C;;;;;;AC5sBA,MAAa,mBAAmB"}

package/dist/index.js

@@ -4,7 +4,7 @@ import { ErrorCategory, ErrorDomain, MastraError } from "@mastra/core/error";
 import { createVectorErrorId } from "@mastra/core/storage";
 import { MastraVector } from "@mastra/core/vector";
 import { BaseFilterTranslator } from "@mastra/core/vector/filter";
-//#region src/vector/filter.ts
+// src/vector/filter.ts
 /**
 * Translates a high-level filter into the S3 Vectors filter shape.
 *
@@ -148,8 +148,7 @@ var S3VectorsFilterTranslator = class extends BaseFilterTranslator {
 		return filter === void 0 || filter === null || typeof filter === "object" && Object.keys(filter).length === 0;
 	}
 };
-//#endregion
-//#region src/vector/index.ts
+// src/vector/index.ts
 /** Maximum number of keys accepted by a single S3 Vectors DeleteVectors request. */
 const DELETE_VECTORS_BATCH_SIZE = 500;
 /**
@@ -686,8 +685,7 @@ function normalizeIndexName(str) {
 	if (typeof str !== "string") throw new TypeError("Index name must be a string");
 	return str.replace(/_/g, "-").toLowerCase();
 }
-//#endregion
-//#region src/vector/prompt.ts
+// src/vector/prompt.ts
 /**
 * Vector store specific prompt that details supported operators and examples.
 * This prompt helps users construct valid filters for Amazon S3 Vectors.
@@ -769,7 +767,6 @@ Example Complex Query:
     ] }
   ]
 }`;
-//#endregion
 export { S3VECTORS_PROMPT, S3Vectors };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["uuidv4"],"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n  VectorFilter,\n  LogicalOperatorValueMap,\n  OperatorSupport,\n  QueryOperator,\n  OperatorValueMap,\n  BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\n/**\n * S3 Vectors supports a strict subset of operators and value types.\n *\n * - logical: `$and`, `$or` (non-empty arrays)\n * - basic:   `$eq`, `$ne` (string | number | boolean)\n * - numeric: `$gt`, `$gte`, `$lt`, `$lte` (number)\n * - array:   `$in`, `$nin` (non-empty arrays of string | number | boolean)\n * - element: `$exists` (boolean)\n */\ntype S3VectorsOperatorValueMap = Pick<\n  OperatorValueMap,\n  '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin' | '$exists'\n>;\n\ntype S3VectorsLogicalOperatorValueMap = Pick<LogicalOperatorValueMap, '$and' | '$or'>;\n\ntype S3VectorsBlacklisted = BlacklistedRootOperators;\n\ntype S3VectorsFieldValue = string | number | boolean;\n\n/**\n * High-level filter type accepted by this translator.\n * @remarks\n * Field values are limited to string/number/boolean at equality positions.\n */\nexport type S3VectorsFilter = VectorFilter<\n  keyof S3VectorsOperatorValueMap,\n  S3VectorsOperatorValueMap,\n  S3VectorsLogicalOperatorValueMap,\n  S3VectorsBlacklisted,\n  S3VectorsFieldValue\n>;\n\n/**\n * Translates a high-level filter into the S3 Vectors filter shape.\n *\n * @remarks\n * - Canonicalizes **implicit AND** (e.g. `{a:1,b:2}`) into explicit `{$and:[{a:1},{b:2}]}` in any\n *   non-field context that lacks `$and/$or`.\n * - Normalizes `Date` values to epoch milliseconds where allowed (numeric comparisons and array elements).\n * - Disallows `Date` at equality positions (including implicit equality).\n * - Validates shapes using the base class after translation.\n */\nexport class S3VectorsFilterTranslator extends BaseFilterTranslator<S3VectorsFilter> {\n  /** @inheritdoc */\n  protected override getSupportedOperators(): OperatorSupport {\n    return {\n      logical: ['$and', '$or'],\n      basic: ['$eq', '$ne'],\n      numeric: ['$gt', '$gte', '$lt', '$lte'],\n      array: ['$in', '$nin'],\n      element: ['$exists'],\n    };\n  }\n\n  /**\n   * Translates and validates a filter.\n   * @param filter - Input filter; may be `undefined`, `null`, or `{}` (all treated as empty).\n   * @returns The translated filter (or the original value if empty).\n   */\n  translate(filter?: S3VectorsFilter): any {\n    if (this.isEmpty(filter)) return filter;\n    // Perform translation (including Date → number normalization) before base shape validation.\n    const translated = this.translateNode(filter as any, false);\n    this.validateFilter(translated as any);\n    return translated;\n  }\n\n  /**\n   * Recursively translates a node.\n   * @param node - Current node to translate.\n   * @param inFieldValue - When `true`, the node is the value of a field (i.e., equality context).\n   * @remarks\n   * - In a **field-value** context, only primitives or operator objects are allowed.\n   * - In a **non-field** context (root / logical branches), operator keys are processed;\n   *   plain keys become field equalities and are validated.\n   * - Implicit AND is canonicalized in non-field contexts when multiple non-logical keys exist.\n   */\n  private translateNode(node: any, inFieldValue = false): any {\n    // Primitive or Date (normalize when in a field-equality context)\n    if (this.isPrimitive(node) || node instanceof Date) {\n      return inFieldValue ? this.validateAndNormalizePrimitive(node) : node;\n    }\n\n    // Arrays are not allowed as direct equality values\n    if (Array.isArray(node)) {\n      if (inFieldValue) {\n        throw new Error('Array equality is not supported in S3 Vectors. Use $in / $nin operators.');\n      }\n      return node;\n    }\n\n    // Object\n    const entries = Object.entries(node as Record<string, any>);\n\n    if (inFieldValue) {\n      if (entries.length === 0) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const allOperatorKeys = entries.every(([k]) => this.isOperator(k));\n      if (!allOperatorKeys) {\n        // Disallow shapes like: { field: { a:1, b:2 } }\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const opEntries = entries.map(([key, value]) => [key, this.translateOperatorValue(key as QueryOperator, value)]);\n      return Object.fromEntries(opEntries);\n    }\n\n    // Root / filter context\n    const translatedEntries = entries.map(([key, value]) => {\n      if (this.isOperator(key)) {\n        return [key, this.translateOperatorValue(key as QueryOperator, value)];\n      }\n      return [key, this.translateNode(value, true)];\n    });\n    const obj = Object.fromEntries(translatedEntries);\n\n    // Canonicalize implicit AND → explicit $and (if no $and/$or present and multiple non-logical keys)\n    const keys = Object.keys(obj);\n    const hasLogical = keys.some(k => k === '$and' || k === '$or');\n    if (!hasLogical) {\n      const nonLogical = keys.filter(k => k !== '$and' && k !== '$or');\n      if (nonLogical.length > 1) {\n        return { $and: nonLogical.map(k => ({ [k]: obj[k] })) };\n      }\n    }\n\n    return obj;\n  }\n\n  /**\n   * Translates a single operator and validates its value.\n   * @param operator - One of the supported query operators.\n   * @param value - Operator value to normalize/validate.\n   */\n  private translateOperatorValue(operator: QueryOperator, value: any): any {\n    // Logical operators\n    if (operator === '$and' || operator === '$or') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for logical operator ${operator} must be a non-empty array`);\n      }\n      return value.map(item => this.translateNode(item));\n    }\n\n    // Equality / inequality (Date is not allowed)\n    if (operator === '$eq' || operator === '$ne') {\n      if (value instanceof Date) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      return this.toPrimitiveForS3(value, operator);\n    }\n\n    // Numeric comparisons: require number; allow Date by converting to epoch ms\n    if (operator === '$gt' || operator === '$gte' || operator === '$lt' || operator === '$lte') {\n      const n = this.toNumberForRange(value, operator);\n      return n;\n    }\n\n    // Array operators: non-empty arrays of primitives (Date converted to number)\n    if (operator === '$in' || operator === '$nin') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for array operator ${operator} must be a non-empty array`);\n      }\n      return value.map(v => this.toPrimitiveForS3(v, operator));\n    }\n\n    // Existence check\n    if (operator === '$exists') {\n      if (typeof value !== 'boolean') {\n        throw new Error(`Value for $exists operator must be a boolean`);\n      }\n      return value;\n    }\n\n    throw new Error(`Unsupported operator: ${operator}`);\n  }\n\n  /**\n   * Normalizes a value to an S3-accepted primitive.\n   * @param value - String | Number | Boolean | Date.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @returns The normalized primitive; `Date` becomes epoch milliseconds.\n   * @throws If the value is not a supported primitive or is null/undefined.\n   */\n  private toPrimitiveForS3(value: any, operatorForMessage: string): string | number | boolean {\n    if (value === null || value === undefined) {\n      // Error message for equality matches tests\n      if (operatorForMessage === 'equality') {\n        throw new Error('S3 Vectors does not support null/undefined for equality');\n      }\n      throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n    }\n    if (value instanceof Date) {\n      return value.getTime();\n    }\n    const t = typeof value;\n    if (t === 'string' || t === 'boolean') return value;\n    if (t === 'number') return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n  }\n\n  /**\n   * Ensures a numeric value for range operators; allows `Date` by converting to epoch ms.\n   * @param value - Candidate value.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @throws If the value is not a number (or a Date).\n   */\n  private toNumberForRange(value: any, operatorForMessage: string): number {\n    if (value instanceof Date) return value.getTime();\n    if (typeof value === 'number' && !Number.isNaN(value)) return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be a number`);\n  }\n\n  /**\n   * Validates and normalizes a primitive used in field equality (implicit `$eq`).\n   * @param value - Candidate equality value.\n   * @throws If the value is a `Date` or not a supported primitive.\n   */\n  private validateAndNormalizePrimitive(value: any): S3VectorsFieldValue {\n    if (value instanceof Date) {\n      throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n    }\n    return this.toPrimitiveForS3(value, 'equality') as S3VectorsFieldValue;\n  }\n\n  /**\n   * Determines whether a filter is considered empty.\n   * @param filter - Input filter.\n   */\n  protected override isEmpty(filter: any): boolean {\n    return filter === undefined || filter === null || (typeof filter === 'object' && Object.keys(filter).length === 0);\n  }\n}\n","import {\n  S3VectorsClient,\n  CreateIndexCommand,\n  DeleteIndexCommand,\n  ListIndexesCommand,\n  GetIndexCommand,\n  PutVectorsCommand,\n  QueryVectorsCommand,\n  GetVectorsCommand,\n  DeleteVectorsCommand,\n  ListVectorsCommand,\n} from '@aws-sdk/client-s3vectors';\nimport type { S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';\nimport { v4 as uuidv4 } from '@lukeed/uuid';\nimport { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { createVectorErrorId } from '@mastra/core/storage';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n  QueryResult,\n  IndexStats,\n  CreateIndexParams,\n  UpsertVectorParams,\n  DeleteVectorsParams,\n  QueryVectorParams,\n  DescribeIndexParams,\n  DeleteIndexParams,\n  DeleteVectorParams,\n  UpdateVectorParams,\n} from '@mastra/core/vector';\nimport { S3VectorsFilterTranslator } from './filter';\nimport type { S3VectorsFilter } from './filter';\n\n/**\n * Options for the S3Vectors store.\n * @property vectorBucketName - Target S3 Vectors bucket name.\n * @property clientConfig - AWS SDK client options (e.g., region/credentials).\n * @property nonFilterableMetadataKeys - Metadata keys that must not be filterable (forwarded to S3 Vectors).\n */\nexport interface S3VectorsOptions {\n  vectorBucketName: string;\n  clientConfig?: S3VectorsClientConfig;\n  nonFilterableMetadataKeys?: string[];\n}\n\ntype S3DistanceMetric = 'cosine' | 'euclidean';\ntype MastraMetric = NonNullable<CreateIndexParams['metric']>;\ntype SupportedMastraMetric = Exclude<MastraMetric, 'dotproduct'>;\n\n/** Maximum number of keys accepted by a single S3 Vectors DeleteVectors request. */\nconst DELETE_VECTORS_BATCH_SIZE = 500;\n\n/**\n * Vector store backed by Amazon S3 Vectors.\n *\n * @remarks\n * - Supports `cosine` and `euclidean` distance metrics.\n * - Filters must use explicit logical operators (`$and` / `$or`). The attached translator\n *   canonicalizes implicit AND (e.g., `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`) where permitted by spec.\n * - Methods wrap AWS errors in `MastraError` with domain/category metadata.\n */\nexport class S3Vectors extends MastraVector<S3VectorsFilter> {\n  private readonly client: S3VectorsClient;\n  private readonly vectorBucketName: string;\n  private readonly nonFilterableMetadataKeys?: string[];\n  private readonly filterTranslator = new S3VectorsFilterTranslator();\n\n  private static readonly METRIC_MAP: Record<SupportedMastraMetric, S3DistanceMetric> = {\n    cosine: 'cosine',\n    euclidean: 'euclidean',\n  } as const;\n\n  constructor(opts: S3VectorsOptions & { id: string }) {\n    super({ id: opts.id });\n    if (!opts?.vectorBucketName) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'INITIALIZATION', 'MISSING_BUCKET_NAME'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n        },\n        new Error('vectorBucketName is required'),\n      );\n    }\n    this.vectorBucketName = opts.vectorBucketName;\n    this.nonFilterableMetadataKeys = opts.nonFilterableMetadataKeys;\n    this.client = new S3VectorsClient({ ...(opts.clientConfig ?? {}) });\n  }\n\n  /**\n   * No-op to satisfy the base interface.\n   *\n   * @remarks The AWS SDK manages HTTP per request; no persistent connection is needed.\n   */\n  async connect(): Promise<void> {}\n\n  /**\n   * Closes the underlying AWS SDK HTTP handler to free sockets.\n   */\n  async disconnect(): Promise<void> {\n    try {\n      this.client.destroy();\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DISCONNECT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Creates an index or validates an existing one.\n   *\n   * @param params.indexName - Logical index name; normalized internally.\n   * @param params.dimension - Vector dimension (must be a positive integer).\n   * @param params.metric - Distance metric (`cosine` | `euclidean`). Defaults to `cosine`.\n   * @throws {MastraError} If arguments are invalid or AWS returns an error.\n   * @remarks\n   * On `ConflictException`, we verify the existing index schema via the parent implementation\n   * and return if it matches.\n   */\n  async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n\n    let s3Metric: S3DistanceMetric;\n    try {\n      assertPositiveInteger(dimension, 'dimension');\n      s3Metric = S3Vectors.toS3Metric(metric);\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'INVALID_ARGS'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n\n    try {\n      const input: any = {\n        ...this.bucketParams(),\n        indexName,\n        dataType: 'float32',\n        dimension,\n        distanceMetric: s3Metric,\n      };\n      if (this.nonFilterableMetadataKeys?.length) {\n        input.metadataConfiguration = { nonFilterableMetadataKeys: this.nonFilterableMetadataKeys };\n      }\n\n      await this.client.send(new CreateIndexCommand(input));\n    } catch (error: any) {\n      if (error?.name === 'ConflictException') {\n        await this.validateExistingIndex(indexName, dimension, metric);\n        return;\n      }\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Upserts vectors in bulk.\n   *\n   * @param params.indexName - Index to write to.\n   * @param params.vectors - Array of vectors; each must match the index dimension.\n   * @param params.metadata - Optional metadata per vector; `Date` values are normalized to epoch ms.\n   * @param params.ids - Optional explicit IDs; if omitted, UUIDs are generated.\n   * @returns Array of IDs used for the upsert (explicit or generated).\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   */\n  async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension } = await this.getIndexInfo(indexName);\n      validateVectorDimensions(vectors, dimension);\n\n      const generatedIds = ids ?? vectors.map(() => uuidv4());\n\n      const putInput = {\n        ...this.bucketParams(),\n        indexName,\n        vectors: vectors.map((vec, i) => ({\n          key: generatedIds[i],\n          data: { float32: vec },\n          metadata: normalizeMetadata(metadata?.[i]),\n        })),\n      };\n\n      await this.client.send(new PutVectorsCommand(putInput));\n      return generatedIds;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPSERT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Queries nearest neighbors.\n   *\n   * @param params.indexName - Target index.\n   * @param params.queryVector - Query vector (non-empty float32 array).\n   * @param params.topK - Number of neighbors to return (positive integer). Defaults to 10.\n   * @param params.filter - Metadata filter using explicit `$and`/`$or` (translator canonicalizes implicit AND).\n   * @param params.includeVector - If `true`, fetches missing vector data in a second call.\n   * @returns Results sorted by `score` descending.\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   * @remarks\n   * `score = 1/(1+distance)` (monotonic transform), so ranking matches the underlying distance.\n   */\n  async query({\n    indexName,\n    queryVector,\n    topK = 10,\n    filter,\n    includeVector = false,\n  }: QueryVectorParams<S3VectorsFilter>): Promise<QueryResult[]> {\n    indexName = normalizeIndexName(indexName);\n\n    if (!queryVector) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'QUERY', 'MISSING_VECTOR'),\n        text: 'queryVector is required for S3 Vectors queries. Metadata-only queries are not supported by this vector store.',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    try {\n      if (!Array.isArray(queryVector) || queryVector.length === 0) {\n        throw new Error('queryVector must be a non-empty float32 array');\n      }\n      assertPositiveInteger(topK, 'topK');\n\n      const translated = this.transformFilter(filter);\n\n      const out = await this.client.send(\n        new QueryVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          topK,\n          queryVector: { float32: queryVector },\n          filter: translated && Object.keys(translated).length > 0 ? (translated as any) : undefined,\n          returnMetadata: true,\n          returnDistance: true,\n        }),\n      );\n\n      const vectors = (out.vectors ?? []).filter(v => !!v?.key);\n\n      // Query results don't include vector data; fetch via GetVectors when requested.\n      let dataMap: Record<string, number[] | undefined> | undefined;\n      if (includeVector) {\n        const keys = vectors.filter(v => v.key).map(v => v.key!) as string[];\n\n        if (keys.length > 0) {\n          const got = await this.client.send(\n            new GetVectorsCommand({\n              ...this.bucketParams(),\n              indexName,\n              keys,\n              returnData: true,\n              returnMetadata: false,\n            }),\n          );\n          dataMap = {};\n          for (const g of got.vectors ?? []) {\n            if (g.key) dataMap[g.key] = g.data?.float32 as number[] | undefined;\n          }\n        }\n      }\n\n      return vectors.map(v => {\n        const id = v.key!;\n        const score = S3Vectors.distanceToScore(v.distance ?? 0);\n\n        const result: QueryResult = { id, score };\n\n        const md = v.metadata as Record<string, unknown> | undefined;\n        if (md !== undefined) result.metadata = md;\n\n        if (includeVector) {\n          const vec = dataMap?.[id];\n          if (vec !== undefined) result.vector = vec;\n        }\n\n        return result;\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'QUERY', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Lists indexes within the configured bucket.\n   *\n   * @returns Array of index names.\n   * @throws {MastraError} On AWS errors.\n   */\n  async listIndexes(): Promise<string[]> {\n    try {\n      const names: string[] = [];\n      let nextToken: string | undefined;\n\n      do {\n        const out = await this.client.send(\n          new ListIndexesCommand({\n            ...this.bucketParams(),\n            nextToken,\n          } as any),\n        );\n        for (const idx of out.indexes ?? []) {\n          if (idx.indexName) names.push(idx.indexName);\n        }\n        nextToken = out.nextToken;\n      } while (nextToken);\n\n      return names;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'LIST_INDEXES', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Returns index attributes.\n   *\n   * @param params.indexName - Index name.\n   * @returns Object containing `dimension`, `metric`, and `count`.\n   * @throws {MastraError} On AWS errors.\n   * @remarks\n   * `count` is computed via `ListVectors` pagination and may be costly (O(n)).\n   */\n  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension, metric } = await this.getIndexInfo(indexName);\n      const count = await this.countVectors(indexName);\n      return { dimension, metric, count };\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DESCRIBE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes an index.\n   *\n   * @param params.indexName - Index name.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(new DeleteIndexCommand({ ...this.bucketParams(), indexName } as any));\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Updates (replaces) a vector and/or its metadata by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID.\n   * @param params.update.vector - New vector; if omitted, the existing vector is reused.\n   * @param params.update.metadata - New metadata, merged with current metadata.\n   * @throws {MastraError} If the vector does not exist and `update.vector` is omitted, or on AWS error.\n   * @remarks\n   * S3 Vectors `PutVectors` is replace-all; we `Get` the current item, merge, then `Put`.\n   */\n  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n    if (!id) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'INVALID_ARGS'),\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        text: 'id is required for S3Vectors updateVector',\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      if (!update.vector && !update.metadata) {\n        throw new Error('No updates provided');\n      }\n\n      const got = await this.client.send(\n        new GetVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n          returnData: true,\n          returnMetadata: true,\n        }),\n      );\n      const current = (got.vectors ?? [])[0];\n\n      const newVector: number[] | undefined = update.vector ?? (current?.data?.float32 as number[] | undefined);\n      if (!newVector) {\n        throw new Error(`Vector \"${id}\" not found. Provide update.vector to create it.`);\n      }\n\n      const newMetadata =\n        update.metadata !== undefined\n          ? normalizeMetadata(update.metadata)\n          : ((current?.metadata as Record<string, any>) ?? {});\n\n      await this.client.send(\n        new PutVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          vectors: [{ key: id, data: { float32: newVector }, metadata: newMetadata }],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes a vector by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID to delete.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(\n        new DeleteVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  async deleteVectors({ indexName, filter, ids }: DeleteVectorsParams): Promise<void> {\n    if (ids && filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'MUTUALLY_EXCLUSIVE'),\n        text: 'Cannot specify both ids and filter - they are mutually exclusive',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'UNSUPPORTED_FILTER'),\n        text: 'Deleting by metadata filter is not supported for S3Vectors vector store - delete by ids instead',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.SYSTEM,\n        details: { indexName, filter: JSON.stringify(filter) },\n      });\n    }\n\n    if (!ids) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'NO_TARGET'),\n        text: 'Either filter or ids must be provided',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (ids.length === 0) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'EMPTY_IDS'),\n        text: 'Cannot delete with empty ids array',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      for (let i = 0; i < ids.length; i += DELETE_VECTORS_BATCH_SIZE) {\n        await this.client.send(\n          new DeleteVectorsCommand({\n            ...this.bucketParams(),\n            indexName,\n            keys: ids.slice(i, i + DELETE_VECTORS_BATCH_SIZE),\n          }),\n        );\n      }\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, idsCount: ids.length },\n        },\n        error,\n      );\n    }\n  }\n\n  // -------- internal helpers --------\n\n  /**\n   * Returns shared bucket parameters for AWS SDK calls.\n   * @internal\n   */\n  private bucketParams(): { vectorBucketName: string } {\n    return { vectorBucketName: this.vectorBucketName };\n  }\n\n  /**\n   * Retrieves index dimension/metric via `GetIndex`.\n   * @internal\n   * @throws {Error} If the index does not exist.\n   * @returns `{ dimension, metric }`, where `metric` includes `'dotproduct'` to satisfy Mastra types (S3 never returns it).\n   */\n  private async getIndexInfo(\n    indexName: string,\n  ): Promise<{ dimension: number; metric: 'cosine' | 'euclidean' | 'dotproduct' }> {\n    const out = await this.client.send(new GetIndexCommand({ ...this.bucketParams(), indexName } as any));\n    const idx = out.index;\n    if (!idx) throw new Error(`Index \"${indexName}\" not found`);\n    const metric = (idx.distanceMetric as S3DistanceMetric) ?? 'cosine';\n    return {\n      dimension: idx.dimension ?? 0,\n      metric,\n    };\n  }\n\n  /**\n   * Pages through `ListVectors` and counts total items.\n   * @internal\n   * @remarks O(n). Avoid calling on hot paths.\n   */\n  private async countVectors(indexName: string): Promise<number> {\n    let total = 0;\n    let nextToken: string | undefined;\n\n    do {\n      const out = await this.client.send(\n        new ListVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          maxResults: 1000,\n          nextToken,\n          returnData: false,\n          returnMetadata: false,\n        }),\n      );\n      total += (out.vectors ?? []).length;\n      nextToken = out.nextToken;\n    } while (nextToken);\n\n    return total;\n  }\n\n  /**\n   * Translates a high-level filter to the S3 Vectors filter shape.\n   * @internal\n   * @remarks Implicit AND is canonicalized by the translator where permitted by spec.\n   */\n  private transformFilter(filter?: S3VectorsFilter): any {\n    if (!filter) return undefined;\n    return this.filterTranslator.translate(filter);\n  }\n\n  /**\n   * Converts a Mastra metric to an S3 metric.\n   * @internal\n   * @throws {Error} If the metric is not supported by S3 Vectors.\n   */\n  private static toS3Metric(metric: MastraMetric): S3DistanceMetric {\n    const m = S3Vectors.METRIC_MAP[metric as SupportedMastraMetric];\n    if (!m) {\n      throw new Error(`Invalid metric: \"${metric}\". S3 Vectors supports only: cosine, euclidean`);\n    }\n    return m;\n  }\n\n  /**\n   * Monotonic transform from distance (smaller is better) to score (larger is better).\n   * @returns Number in (0, 1], preserving ranking.\n   */\n  private static distanceToScore(distance: number): number {\n    return 1 / (1 + distance);\n  }\n}\n\n// --- module-private utilities (not exported) ---\n\n/**\n * Ensures a value is a positive integer.\n * @throws {Error} If the value is not a positive integer.\n * @internal\n */\nfunction assertPositiveInteger(value: number, name: string): void {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new Error(`${name} must be a positive integer`);\n  }\n}\n\n/**\n * Validates that all vectors match the required dimension.\n * @throws {Error} If any vector length differs from `dimension`.\n * @internal\n */\nfunction validateVectorDimensions(vectors: number[][], dimension: number): void {\n  if (!Array.isArray(vectors) || vectors.length === 0) {\n    throw new Error('No vectors provided for validation');\n  }\n  for (let i = 0; i < vectors.length; i++) {\n    const len = vectors[i]?.length;\n    if (len !== dimension) {\n      throw new Error(`Vector at index ${i} has invalid dimension ${len}. Expected ${dimension} dimensions.`);\n    }\n  }\n}\n\n/**\n * Normalizes metadata values for S3 Vectors: `Date` → epoch ms.\n * @internal\n */\nfunction normalizeMetadata(meta: Record<string, any> | undefined): Record<string, any> {\n  if (!meta) return {};\n  const out: Record<string, any> = {};\n  for (const [k, v] of Object.entries(meta)) {\n    out[k] = v instanceof Date ? v.getTime() : v;\n  }\n  return out;\n}\n\n/**\n * Normalizes an index name to this store's canonical form (underscore → hyphen, lowercase).\n * @internal\n * @throws {TypeError} If the provided name is not a string.\n */\nfunction normalizeIndexName(str: string) {\n  if (typeof str !== 'string') {\n    throw new TypeError('Index name must be a string');\n  }\n  return str.replace(/_/g, '-').toLowerCase();\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Amazon S3 Vectors.\n */\nexport const S3VECTORS_PROMPT = `When querying Amazon S3 Vectors, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators (non-empty arrays of string | number | boolean):\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nUnsupported / Disallowed Operators (REJECT if present):\n- $not, $nor, $regex, $all, $elemMatch, $size, $text (and any operator not listed as supported)\n\nRestrictions:\n- Only logical operators ($and, $or) can be used at the top level\n- Empty arrays for $and / $or / $in / $nin are NOT allowed\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n- Equality values must be string, number, or boolean (arrays and objects are not allowed for equality)\n- Filters operate only on filterable metadata keys; using a non-filterable key will fail\n- Filterable metadata values are primitives (string/number/boolean) or arrays of primitives; large/long-text fields should be non-filterable and are not usable in filters\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ] }\n  ]\n}`;\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["uuidv4"],"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n  VectorFilter,\n  LogicalOperatorValueMap,\n  OperatorSupport,\n  QueryOperator,\n  OperatorValueMap,\n  BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\n/**\n * S3 Vectors supports a strict subset of operators and value types.\n *\n * - logical: `$and`, `$or` (non-empty arrays)\n * - basic:   `$eq`, `$ne` (string | number | boolean)\n * - numeric: `$gt`, `$gte`, `$lt`, `$lte` (number)\n * - array:   `$in`, `$nin` (non-empty arrays of string | number | boolean)\n * - element: `$exists` (boolean)\n */\ntype S3VectorsOperatorValueMap = Pick<\n  OperatorValueMap,\n  '$eq' | '$ne' | '$gt' | '$gte' | '$lt' | '$lte' | '$in' | '$nin' | '$exists'\n>;\n\ntype S3VectorsLogicalOperatorValueMap = Pick<LogicalOperatorValueMap, '$and' | '$or'>;\n\ntype S3VectorsBlacklisted = BlacklistedRootOperators;\n\ntype S3VectorsFieldValue = string | number | boolean;\n\n/**\n * High-level filter type accepted by this translator.\n * @remarks\n * Field values are limited to string/number/boolean at equality positions.\n */\nexport type S3VectorsFilter = VectorFilter<\n  keyof S3VectorsOperatorValueMap,\n  S3VectorsOperatorValueMap,\n  S3VectorsLogicalOperatorValueMap,\n  S3VectorsBlacklisted,\n  S3VectorsFieldValue\n>;\n\n/**\n * Translates a high-level filter into the S3 Vectors filter shape.\n *\n * @remarks\n * - Canonicalizes **implicit AND** (e.g. `{a:1,b:2}`) into explicit `{$and:[{a:1},{b:2}]}` in any\n *   non-field context that lacks `$and/$or`.\n * - Normalizes `Date` values to epoch milliseconds where allowed (numeric comparisons and array elements).\n * - Disallows `Date` at equality positions (including implicit equality).\n * - Validates shapes using the base class after translation.\n */\nexport class S3VectorsFilterTranslator extends BaseFilterTranslator<S3VectorsFilter> {\n  /** @inheritdoc */\n  protected override getSupportedOperators(): OperatorSupport {\n    return {\n      logical: ['$and', '$or'],\n      basic: ['$eq', '$ne'],\n      numeric: ['$gt', '$gte', '$lt', '$lte'],\n      array: ['$in', '$nin'],\n      element: ['$exists'],\n    };\n  }\n\n  /**\n   * Translates and validates a filter.\n   * @param filter - Input filter; may be `undefined`, `null`, or `{}` (all treated as empty).\n   * @returns The translated filter (or the original value if empty).\n   */\n  translate(filter?: S3VectorsFilter): any {\n    if (this.isEmpty(filter)) return filter;\n    // Perform translation (including Date → number normalization) before base shape validation.\n    const translated = this.translateNode(filter as any, false);\n    this.validateFilter(translated as any);\n    return translated;\n  }\n\n  /**\n   * Recursively translates a node.\n   * @param node - Current node to translate.\n   * @param inFieldValue - When `true`, the node is the value of a field (i.e., equality context).\n   * @remarks\n   * - In a **field-value** context, only primitives or operator objects are allowed.\n   * - In a **non-field** context (root / logical branches), operator keys are processed;\n   *   plain keys become field equalities and are validated.\n   * - Implicit AND is canonicalized in non-field contexts when multiple non-logical keys exist.\n   */\n  private translateNode(node: any, inFieldValue = false): any {\n    // Primitive or Date (normalize when in a field-equality context)\n    if (this.isPrimitive(node) || node instanceof Date) {\n      return inFieldValue ? this.validateAndNormalizePrimitive(node) : node;\n    }\n\n    // Arrays are not allowed as direct equality values\n    if (Array.isArray(node)) {\n      if (inFieldValue) {\n        throw new Error('Array equality is not supported in S3 Vectors. Use $in / $nin operators.');\n      }\n      return node;\n    }\n\n    // Object\n    const entries = Object.entries(node as Record<string, any>);\n\n    if (inFieldValue) {\n      if (entries.length === 0) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const allOperatorKeys = entries.every(([k]) => this.isOperator(k));\n      if (!allOperatorKeys) {\n        // Disallow shapes like: { field: { a:1, b:2 } }\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      const opEntries = entries.map(([key, value]) => [key, this.translateOperatorValue(key as QueryOperator, value)]);\n      return Object.fromEntries(opEntries);\n    }\n\n    // Root / filter context\n    const translatedEntries = entries.map(([key, value]) => {\n      if (this.isOperator(key)) {\n        return [key, this.translateOperatorValue(key as QueryOperator, value)];\n      }\n      return [key, this.translateNode(value, true)];\n    });\n    const obj = Object.fromEntries(translatedEntries);\n\n    // Canonicalize implicit AND → explicit $and (if no $and/$or present and multiple non-logical keys)\n    const keys = Object.keys(obj);\n    const hasLogical = keys.some(k => k === '$and' || k === '$or');\n    if (!hasLogical) {\n      const nonLogical = keys.filter(k => k !== '$and' && k !== '$or');\n      if (nonLogical.length > 1) {\n        return { $and: nonLogical.map(k => ({ [k]: obj[k] })) };\n      }\n    }\n\n    return obj;\n  }\n\n  /**\n   * Translates a single operator and validates its value.\n   * @param operator - One of the supported query operators.\n   * @param value - Operator value to normalize/validate.\n   */\n  private translateOperatorValue(operator: QueryOperator, value: any): any {\n    // Logical operators\n    if (operator === '$and' || operator === '$or') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for logical operator ${operator} must be a non-empty array`);\n      }\n      return value.map(item => this.translateNode(item));\n    }\n\n    // Equality / inequality (Date is not allowed)\n    if (operator === '$eq' || operator === '$ne') {\n      if (value instanceof Date) {\n        throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n      }\n      return this.toPrimitiveForS3(value, operator);\n    }\n\n    // Numeric comparisons: require number; allow Date by converting to epoch ms\n    if (operator === '$gt' || operator === '$gte' || operator === '$lt' || operator === '$lte') {\n      const n = this.toNumberForRange(value, operator);\n      return n;\n    }\n\n    // Array operators: non-empty arrays of primitives (Date converted to number)\n    if (operator === '$in' || operator === '$nin') {\n      if (!Array.isArray(value) || value.length === 0) {\n        throw new Error(`Value for array operator ${operator} must be a non-empty array`);\n      }\n      return value.map(v => this.toPrimitiveForS3(v, operator));\n    }\n\n    // Existence check\n    if (operator === '$exists') {\n      if (typeof value !== 'boolean') {\n        throw new Error(`Value for $exists operator must be a boolean`);\n      }\n      return value;\n    }\n\n    throw new Error(`Unsupported operator: ${operator}`);\n  }\n\n  /**\n   * Normalizes a value to an S3-accepted primitive.\n   * @param value - String | Number | Boolean | Date.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @returns The normalized primitive; `Date` becomes epoch milliseconds.\n   * @throws If the value is not a supported primitive or is null/undefined.\n   */\n  private toPrimitiveForS3(value: any, operatorForMessage: string): string | number | boolean {\n    if (value === null || value === undefined) {\n      // Error message for equality matches tests\n      if (operatorForMessage === 'equality') {\n        throw new Error('S3 Vectors does not support null/undefined for equality');\n      }\n      throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n    }\n    if (value instanceof Date) {\n      return value.getTime();\n    }\n    const t = typeof value;\n    if (t === 'string' || t === 'boolean') return value;\n    if (t === 'number') return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be string, number, or boolean`);\n  }\n\n  /**\n   * Ensures a numeric value for range operators; allows `Date` by converting to epoch ms.\n   * @param value - Candidate value.\n   * @param operatorForMessage - Operator name used in error messages.\n   * @throws If the value is not a number (or a Date).\n   */\n  private toNumberForRange(value: any, operatorForMessage: string): number {\n    if (value instanceof Date) return value.getTime();\n    if (typeof value === 'number' && !Number.isNaN(value)) return Object.is(value, -0) ? 0 : value;\n    throw new Error(`Value for ${operatorForMessage} must be a number`);\n  }\n\n  /**\n   * Validates and normalizes a primitive used in field equality (implicit `$eq`).\n   * @param value - Candidate equality value.\n   * @throws If the value is a `Date` or not a supported primitive.\n   */\n  private validateAndNormalizePrimitive(value: any): S3VectorsFieldValue {\n    if (value instanceof Date) {\n      throw new Error('Invalid equality value. Only string, number, or boolean are supported by S3 Vectors');\n    }\n    return this.toPrimitiveForS3(value, 'equality') as S3VectorsFieldValue;\n  }\n\n  /**\n   * Determines whether a filter is considered empty.\n   * @param filter - Input filter.\n   */\n  protected override isEmpty(filter: any): boolean {\n    return filter === undefined || filter === null || (typeof filter === 'object' && Object.keys(filter).length === 0);\n  }\n}\n","import {\n  S3VectorsClient,\n  CreateIndexCommand,\n  DeleteIndexCommand,\n  ListIndexesCommand,\n  GetIndexCommand,\n  PutVectorsCommand,\n  QueryVectorsCommand,\n  GetVectorsCommand,\n  DeleteVectorsCommand,\n  ListVectorsCommand,\n} from '@aws-sdk/client-s3vectors';\nimport type { S3VectorsClientConfig } from '@aws-sdk/client-s3vectors';\nimport { v4 as uuidv4 } from '@lukeed/uuid';\nimport { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { createVectorErrorId } from '@mastra/core/storage';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n  QueryResult,\n  IndexStats,\n  CreateIndexParams,\n  UpsertVectorParams,\n  DeleteVectorsParams,\n  QueryVectorParams,\n  DescribeIndexParams,\n  DeleteIndexParams,\n  DeleteVectorParams,\n  UpdateVectorParams,\n} from '@mastra/core/vector';\nimport { S3VectorsFilterTranslator } from './filter';\nimport type { S3VectorsFilter } from './filter';\n\n/**\n * Options for the S3Vectors store.\n * @property vectorBucketName - Target S3 Vectors bucket name.\n * @property clientConfig - AWS SDK client options (e.g., region/credentials).\n * @property nonFilterableMetadataKeys - Metadata keys that must not be filterable (forwarded to S3 Vectors).\n */\nexport interface S3VectorsOptions {\n  vectorBucketName: string;\n  clientConfig?: S3VectorsClientConfig;\n  nonFilterableMetadataKeys?: string[];\n}\n\ntype S3DistanceMetric = 'cosine' | 'euclidean';\ntype MastraMetric = NonNullable<CreateIndexParams['metric']>;\ntype SupportedMastraMetric = Exclude<MastraMetric, 'dotproduct'>;\n\n/** Maximum number of keys accepted by a single S3 Vectors DeleteVectors request. */\nconst DELETE_VECTORS_BATCH_SIZE = 500;\n\n/**\n * Vector store backed by Amazon S3 Vectors.\n *\n * @remarks\n * - Supports `cosine` and `euclidean` distance metrics.\n * - Filters must use explicit logical operators (`$and` / `$or`). The attached translator\n *   canonicalizes implicit AND (e.g., `{a:1,b:2}` → `{ $and: [{a:1},{b:2}] }`) where permitted by spec.\n * - Methods wrap AWS errors in `MastraError` with domain/category metadata.\n */\nexport class S3Vectors extends MastraVector<S3VectorsFilter> {\n  private readonly client: S3VectorsClient;\n  private readonly vectorBucketName: string;\n  private readonly nonFilterableMetadataKeys?: string[];\n  private readonly filterTranslator = new S3VectorsFilterTranslator();\n\n  private static readonly METRIC_MAP: Record<SupportedMastraMetric, S3DistanceMetric> = {\n    cosine: 'cosine',\n    euclidean: 'euclidean',\n  } as const;\n\n  constructor(opts: S3VectorsOptions & { id: string }) {\n    super({ id: opts.id });\n    if (!opts?.vectorBucketName) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'INITIALIZATION', 'MISSING_BUCKET_NAME'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n        },\n        new Error('vectorBucketName is required'),\n      );\n    }\n    this.vectorBucketName = opts.vectorBucketName;\n    this.nonFilterableMetadataKeys = opts.nonFilterableMetadataKeys;\n    this.client = new S3VectorsClient({ ...(opts.clientConfig ?? {}) });\n  }\n\n  /**\n   * No-op to satisfy the base interface.\n   *\n   * @remarks The AWS SDK manages HTTP per request; no persistent connection is needed.\n   */\n  async connect(): Promise<void> {}\n\n  /**\n   * Closes the underlying AWS SDK HTTP handler to free sockets.\n   */\n  async disconnect(): Promise<void> {\n    try {\n      this.client.destroy();\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DISCONNECT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Creates an index or validates an existing one.\n   *\n   * @param params.indexName - Logical index name; normalized internally.\n   * @param params.dimension - Vector dimension (must be a positive integer).\n   * @param params.metric - Distance metric (`cosine` | `euclidean`). Defaults to `cosine`.\n   * @throws {MastraError} If arguments are invalid or AWS returns an error.\n   * @remarks\n   * On `ConflictException`, we verify the existing index schema via the parent implementation\n   * and return if it matches.\n   */\n  async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n\n    let s3Metric: S3DistanceMetric;\n    try {\n      assertPositiveInteger(dimension, 'dimension');\n      s3Metric = S3Vectors.toS3Metric(metric);\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'INVALID_ARGS'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.USER,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n\n    try {\n      const input: any = {\n        ...this.bucketParams(),\n        indexName,\n        dataType: 'float32',\n        dimension,\n        distanceMetric: s3Metric,\n      };\n      if (this.nonFilterableMetadataKeys?.length) {\n        input.metadataConfiguration = { nonFilterableMetadataKeys: this.nonFilterableMetadataKeys };\n      }\n\n      await this.client.send(new CreateIndexCommand(input));\n    } catch (error: any) {\n      if (error?.name === 'ConflictException') {\n        await this.validateExistingIndex(indexName, dimension, metric);\n        return;\n      }\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'CREATE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Upserts vectors in bulk.\n   *\n   * @param params.indexName - Index to write to.\n   * @param params.vectors - Array of vectors; each must match the index dimension.\n   * @param params.metadata - Optional metadata per vector; `Date` values are normalized to epoch ms.\n   * @param params.ids - Optional explicit IDs; if omitted, UUIDs are generated.\n   * @returns Array of IDs used for the upsert (explicit or generated).\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   */\n  async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension } = await this.getIndexInfo(indexName);\n      validateVectorDimensions(vectors, dimension);\n\n      const generatedIds = ids ?? vectors.map(() => uuidv4());\n\n      const putInput = {\n        ...this.bucketParams(),\n        indexName,\n        vectors: vectors.map((vec, i) => ({\n          key: generatedIds[i],\n          data: { float32: vec },\n          metadata: normalizeMetadata(metadata?.[i]),\n        })),\n      };\n\n      await this.client.send(new PutVectorsCommand(putInput));\n      return generatedIds;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPSERT', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Queries nearest neighbors.\n   *\n   * @param params.indexName - Target index.\n   * @param params.queryVector - Query vector (non-empty float32 array).\n   * @param params.topK - Number of neighbors to return (positive integer). Defaults to 10.\n   * @param params.filter - Metadata filter using explicit `$and`/`$or` (translator canonicalizes implicit AND).\n   * @param params.includeVector - If `true`, fetches missing vector data in a second call.\n   * @returns Results sorted by `score` descending.\n   * @throws {MastraError} If validation fails or AWS returns an error.\n   * @remarks\n   * `score = 1/(1+distance)` (monotonic transform), so ranking matches the underlying distance.\n   */\n  async query({\n    indexName,\n    queryVector,\n    topK = 10,\n    filter,\n    includeVector = false,\n  }: QueryVectorParams<S3VectorsFilter>): Promise<QueryResult[]> {\n    indexName = normalizeIndexName(indexName);\n\n    if (!queryVector) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'QUERY', 'MISSING_VECTOR'),\n        text: 'queryVector is required for S3 Vectors queries. Metadata-only queries are not supported by this vector store.',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    try {\n      if (!Array.isArray(queryVector) || queryVector.length === 0) {\n        throw new Error('queryVector must be a non-empty float32 array');\n      }\n      assertPositiveInteger(topK, 'topK');\n\n      const translated = this.transformFilter(filter);\n\n      const out = await this.client.send(\n        new QueryVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          topK,\n          queryVector: { float32: queryVector },\n          filter: translated && Object.keys(translated).length > 0 ? (translated as any) : undefined,\n          returnMetadata: true,\n          returnDistance: true,\n        }),\n      );\n\n      const vectors = (out.vectors ?? []).filter(v => !!v?.key);\n\n      // Query results don't include vector data; fetch via GetVectors when requested.\n      let dataMap: Record<string, number[] | undefined> | undefined;\n      if (includeVector) {\n        const keys = vectors.filter(v => v.key).map(v => v.key!) as string[];\n\n        if (keys.length > 0) {\n          const got = await this.client.send(\n            new GetVectorsCommand({\n              ...this.bucketParams(),\n              indexName,\n              keys,\n              returnData: true,\n              returnMetadata: false,\n            }),\n          );\n          dataMap = {};\n          for (const g of got.vectors ?? []) {\n            if (g.key) dataMap[g.key] = g.data?.float32 as number[] | undefined;\n          }\n        }\n      }\n\n      return vectors.map(v => {\n        const id = v.key!;\n        const score = S3Vectors.distanceToScore(v.distance ?? 0);\n\n        const result: QueryResult = { id, score };\n\n        const md = v.metadata as Record<string, unknown> | undefined;\n        if (md !== undefined) result.metadata = md;\n\n        if (includeVector) {\n          const vec = dataMap?.[id];\n          if (vec !== undefined) result.vector = vec;\n        }\n\n        return result;\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'QUERY', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Lists indexes within the configured bucket.\n   *\n   * @returns Array of index names.\n   * @throws {MastraError} On AWS errors.\n   */\n  async listIndexes(): Promise<string[]> {\n    try {\n      const names: string[] = [];\n      let nextToken: string | undefined;\n\n      do {\n        const out = await this.client.send(\n          new ListIndexesCommand({\n            ...this.bucketParams(),\n            nextToken,\n          } as any),\n        );\n        for (const idx of out.indexes ?? []) {\n          if (idx.indexName) names.push(idx.indexName);\n        }\n        nextToken = out.nextToken;\n      } while (nextToken);\n\n      return names;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'LIST_INDEXES', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Returns index attributes.\n   *\n   * @param params.indexName - Index name.\n   * @returns Object containing `dimension`, `metric`, and `count`.\n   * @throws {MastraError} On AWS errors.\n   * @remarks\n   * `count` is computed via `ListVectors` pagination and may be costly (O(n)).\n   */\n  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      const { dimension, metric } = await this.getIndexInfo(indexName);\n      const count = await this.countVectors(indexName);\n      return { dimension, metric, count };\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DESCRIBE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes an index.\n   *\n   * @param params.indexName - Index name.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(new DeleteIndexCommand({ ...this.bucketParams(), indexName } as any));\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_INDEX', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Updates (replaces) a vector and/or its metadata by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID.\n   * @param params.update.vector - New vector; if omitted, the existing vector is reused.\n   * @param params.update.metadata - New metadata, merged with current metadata.\n   * @throws {MastraError} If the vector does not exist and `update.vector` is omitted, or on AWS error.\n   * @remarks\n   * S3 Vectors `PutVectors` is replace-all; we `Get` the current item, merge, then `Put`.\n   */\n  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n    if (!id) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'INVALID_ARGS'),\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        text: 'id is required for S3Vectors updateVector',\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      if (!update.vector && !update.metadata) {\n        throw new Error('No updates provided');\n      }\n\n      const got = await this.client.send(\n        new GetVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n          returnData: true,\n          returnMetadata: true,\n        }),\n      );\n      const current = (got.vectors ?? [])[0];\n\n      const newVector: number[] | undefined = update.vector ?? (current?.data?.float32 as number[] | undefined);\n      if (!newVector) {\n        throw new Error(`Vector \"${id}\" not found. Provide update.vector to create it.`);\n      }\n\n      const newMetadata =\n        update.metadata !== undefined\n          ? normalizeMetadata(update.metadata)\n          : ((current?.metadata as Record<string, any>) ?? {});\n\n      await this.client.send(\n        new PutVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          vectors: [{ key: id, data: { float32: newVector }, metadata: newMetadata }],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'UPDATE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes a vector by ID.\n   *\n   * @param params.indexName - Target index.\n   * @param params.id - Vector ID to delete.\n   * @throws {MastraError} On AWS errors.\n   */\n  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n    indexName = normalizeIndexName(indexName);\n    try {\n      await this.client.send(\n        new DeleteVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          keys: [id],\n        }),\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTOR', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: {\n            indexName,\n            ...(id && { id }),\n          },\n        },\n        error,\n      );\n    }\n  }\n\n  async deleteVectors({ indexName, filter, ids }: DeleteVectorsParams): Promise<void> {\n    if (ids && filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'MUTUALLY_EXCLUSIVE'),\n        text: 'Cannot specify both ids and filter - they are mutually exclusive',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (filter) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'UNSUPPORTED_FILTER'),\n        text: 'Deleting by metadata filter is not supported for S3Vectors vector store - delete by ids instead',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.SYSTEM,\n        details: { indexName, filter: JSON.stringify(filter) },\n      });\n    }\n\n    if (!ids) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'NO_TARGET'),\n        text: 'Either filter or ids must be provided',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    if (ids.length === 0) {\n      throw new MastraError({\n        id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'EMPTY_IDS'),\n        text: 'Cannot delete with empty ids array',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        details: { indexName },\n      });\n    }\n\n    indexName = normalizeIndexName(indexName);\n    try {\n      for (let i = 0; i < ids.length; i += DELETE_VECTORS_BATCH_SIZE) {\n        await this.client.send(\n          new DeleteVectorsCommand({\n            ...this.bucketParams(),\n            indexName,\n            keys: ids.slice(i, i + DELETE_VECTORS_BATCH_SIZE),\n          }),\n        );\n      }\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: createVectorErrorId('S3VECTORS', 'DELETE_VECTORS', 'FAILED'),\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, idsCount: ids.length },\n        },\n        error,\n      );\n    }\n  }\n\n  // -------- internal helpers --------\n\n  /**\n   * Returns shared bucket parameters for AWS SDK calls.\n   * @internal\n   */\n  private bucketParams(): { vectorBucketName: string } {\n    return { vectorBucketName: this.vectorBucketName };\n  }\n\n  /**\n   * Retrieves index dimension/metric via `GetIndex`.\n   * @internal\n   * @throws {Error} If the index does not exist.\n   * @returns `{ dimension, metric }`, where `metric` includes `'dotproduct'` to satisfy Mastra types (S3 never returns it).\n   */\n  private async getIndexInfo(\n    indexName: string,\n  ): Promise<{ dimension: number; metric: 'cosine' | 'euclidean' | 'dotproduct' }> {\n    const out = await this.client.send(new GetIndexCommand({ ...this.bucketParams(), indexName } as any));\n    const idx = out.index;\n    if (!idx) throw new Error(`Index \"${indexName}\" not found`);\n    const metric = (idx.distanceMetric as S3DistanceMetric) ?? 'cosine';\n    return {\n      dimension: idx.dimension ?? 0,\n      metric,\n    };\n  }\n\n  /**\n   * Pages through `ListVectors` and counts total items.\n   * @internal\n   * @remarks O(n). Avoid calling on hot paths.\n   */\n  private async countVectors(indexName: string): Promise<number> {\n    let total = 0;\n    let nextToken: string | undefined;\n\n    do {\n      const out = await this.client.send(\n        new ListVectorsCommand({\n          ...this.bucketParams(),\n          indexName,\n          maxResults: 1000,\n          nextToken,\n          returnData: false,\n          returnMetadata: false,\n        }),\n      );\n      total += (out.vectors ?? []).length;\n      nextToken = out.nextToken;\n    } while (nextToken);\n\n    return total;\n  }\n\n  /**\n   * Translates a high-level filter to the S3 Vectors filter shape.\n   * @internal\n   * @remarks Implicit AND is canonicalized by the translator where permitted by spec.\n   */\n  private transformFilter(filter?: S3VectorsFilter): any {\n    if (!filter) return undefined;\n    return this.filterTranslator.translate(filter);\n  }\n\n  /**\n   * Converts a Mastra metric to an S3 metric.\n   * @internal\n   * @throws {Error} If the metric is not supported by S3 Vectors.\n   */\n  private static toS3Metric(metric: MastraMetric): S3DistanceMetric {\n    const m = S3Vectors.METRIC_MAP[metric as SupportedMastraMetric];\n    if (!m) {\n      throw new Error(`Invalid metric: \"${metric}\". S3 Vectors supports only: cosine, euclidean`);\n    }\n    return m;\n  }\n\n  /**\n   * Monotonic transform from distance (smaller is better) to score (larger is better).\n   * @returns Number in (0, 1], preserving ranking.\n   */\n  private static distanceToScore(distance: number): number {\n    return 1 / (1 + distance);\n  }\n}\n\n// --- module-private utilities (not exported) ---\n\n/**\n * Ensures a value is a positive integer.\n * @throws {Error} If the value is not a positive integer.\n * @internal\n */\nfunction assertPositiveInteger(value: number, name: string): void {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new Error(`${name} must be a positive integer`);\n  }\n}\n\n/**\n * Validates that all vectors match the required dimension.\n * @throws {Error} If any vector length differs from `dimension`.\n * @internal\n */\nfunction validateVectorDimensions(vectors: number[][], dimension: number): void {\n  if (!Array.isArray(vectors) || vectors.length === 0) {\n    throw new Error('No vectors provided for validation');\n  }\n  for (let i = 0; i < vectors.length; i++) {\n    const len = vectors[i]?.length;\n    if (len !== dimension) {\n      throw new Error(`Vector at index ${i} has invalid dimension ${len}. Expected ${dimension} dimensions.`);\n    }\n  }\n}\n\n/**\n * Normalizes metadata values for S3 Vectors: `Date` → epoch ms.\n * @internal\n */\nfunction normalizeMetadata(meta: Record<string, any> | undefined): Record<string, any> {\n  if (!meta) return {};\n  const out: Record<string, any> = {};\n  for (const [k, v] of Object.entries(meta)) {\n    out[k] = v instanceof Date ? v.getTime() : v;\n  }\n  return out;\n}\n\n/**\n * Normalizes an index name to this store's canonical form (underscore → hyphen, lowercase).\n * @internal\n * @throws {TypeError} If the provided name is not a string.\n */\nfunction normalizeIndexName(str: string) {\n  if (typeof str !== 'string') {\n    throw new TypeError('Index name must be a string');\n  }\n  return str.replace(/_/g, '-').toLowerCase();\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Amazon S3 Vectors.\n */\nexport const S3VECTORS_PROMPT = `When querying Amazon S3 Vectors, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators (non-empty arrays of string | number | boolean):\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nUnsupported / Disallowed Operators (REJECT if present):\n- $not, $nor, $regex, $all, $elemMatch, $size, $text (and any operator not listed as supported)\n\nRestrictions:\n- Only logical operators ($and, $or) can be used at the top level\n- Empty arrays for $and / $or / $in / $nin are NOT allowed\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n- Equality values must be string, number, or boolean (arrays and objects are not allowed for equality)\n- Filters operate only on filterable metadata keys; using a non-filterable key will fail\n- Filterable metadata values are primitives (string/number/boolean) or arrays of primitives; large/long-text fields should be non-filterable and are not usable in filters\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ] }\n  ]\n}`;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/s3vectors",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Amazon S3 Vectors store provider for Mastra",
   "type": "module",
   "files": [
@@ -23,22 +23,22 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@aws-sdk/client-s3vectors": "^3.1095.0",
+    "@aws-sdk/client-s3vectors": "^3.1156.0",
     "@lukeed/uuid": "^2.0.1"
   },
   "devDependencies": {
-    "@types/node": "22.20.1",
-    "@vitest/coverage-v8": "4.1.11",
-    "@vitest/ui": "4.1.11",
+    "@types/node": "22.19.15",
+    "@vitest/coverage-v8": "4.1.12",
+    "@vitest/ui": "4.1.12",
     "dotenv": "^17.4.2",
-    "tsdown": "0.22.9",
-    "tsx": "^4.23.1",
+    "tsdown": "0.23.1",
+    "tsx": "^4.23.15",
     "typescript": "^7.0.2",
-    "vitest": "4.1.11",
-    "@internal/lint": "0.0.145",
-    "@internal/storage-test-utils": "0.0.141",
-    "@internal/types-builder": "0.0.120",
-    "@mastra/core": "1.79.0"
+    "vitest": "4.1.12",
+    "@internal/lint": "0.0.146",
+    "@internal/storage-test-utils": "0.0.142",
+    "@internal/types-builder": "0.0.121",
+    "@mastra/core": "1.80.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"