@mastra/astra 1.1.0 → 1.1.1-alpha.0

package/dist/index.js

@@ -1,369 +1,325 @@
-import { DataAPIClient, UUID } from '@datastax/astra-db-ts';
-import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
-import { createVectorErrorId } from '@mastra/core/storage';
-import { MastraVector } from '@mastra/core/vector';
-import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-
-// src/vector/index.ts
+import { DataAPIClient, UUID } from "@datastax/astra-db-ts";
+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
+/**
+* Translator for Astra DB filter queries.
+* Maintains MongoDB-compatible syntax while ensuring proper validation
+* and normalization of values.
+*/
 var AstraFilterTranslator = class extends BaseFilterTranslator {
-  getSupportedOperators() {
-    return {
-      ...BaseFilterTranslator.DEFAULT_OPERATORS,
-      array: ["$all", "$in", "$nin"],
-      logical: ["$and", "$or", "$not"],
-      regex: [],
-      custom: ["$size"]
-    };
-  }
-  translate(filter) {
-    if (this.isEmpty(filter)) return filter;
-    this.validateFilter(filter);
-    return this.translateNode(filter);
-  }
-  translateNode(node) {
-    if (this.isRegex(node)) {
-      throw new Error("Regex is not supported in Astra DB");
-    }
-    if (this.isPrimitive(node) || Array.isArray(node)) {
-      return node;
-    }
-    const entries = Object.entries(node);
-    const translatedEntries = entries.map(([key, value]) => {
-      if (this.isOperator(key)) {
-        return [key, this.translateOperatorValue(key, value)];
-      }
-      return [key, this.translateNode(value)];
-    });
-    return Object.fromEntries(translatedEntries);
-  }
-  translateOperatorValue(operator, value) {
-    if (this.isBasicOperator(operator) || this.isNumericOperator(operator)) {
-      return this.normalizeComparisonValue(value);
-    }
-    if (this.isArrayOperator(operator) && Array.isArray(value)) {
-      return this.normalizeArrayValues(value);
-    }
-    return this.translateNode(value);
-  }
+	getSupportedOperators() {
+		return {
+			...BaseFilterTranslator.DEFAULT_OPERATORS,
+			array: [
+				"$all",
+				"$in",
+				"$nin"
+			],
+			logical: [
+				"$and",
+				"$or",
+				"$not"
+			],
+			regex: [],
+			custom: ["$size"]
+		};
+	}
+	translate(filter) {
+		if (this.isEmpty(filter)) return filter;
+		this.validateFilter(filter);
+		return this.translateNode(filter);
+	}
+	translateNode(node) {
+		if (this.isRegex(node)) throw new Error("Regex is not supported in Astra DB");
+		if (this.isPrimitive(node) || Array.isArray(node)) return node;
+		const translatedEntries = Object.entries(node).map(([key, value]) => {
+			if (this.isOperator(key)) return [key, this.translateOperatorValue(key, value)];
+			return [key, this.translateNode(value)];
+		});
+		return Object.fromEntries(translatedEntries);
+	}
+	translateOperatorValue(operator, value) {
+		if (this.isBasicOperator(operator) || this.isNumericOperator(operator)) return this.normalizeComparisonValue(value);
+		if (this.isArrayOperator(operator) && Array.isArray(value)) return this.normalizeArrayValues(value);
+		return this.translateNode(value);
+	}
 };
-
-// src/vector/index.ts
-var metricMap = {
-  cosine: "cosine",
-  euclidean: "euclidean",
-  dotproduct: "dot_product"
+//#endregion
+//#region src/vector/index.ts
+const metricMap = {
+	cosine: "cosine",
+	euclidean: "euclidean",
+	dotproduct: "dot_product"
 };
 var AstraVector = class extends MastraVector {
-  #db;
-  constructor({ token, endpoint, keyspace, id }) {
-    super({ id });
-    const client = new DataAPIClient(token);
-    this.#db = client.db(endpoint, { keyspace });
-  }
-  /**
-   * Creates a new collection with the specified configuration.
-   *
-   * @param {string} indexName - The name of the collection to create.
-   * @param {number} dimension - The dimension of the vectors to be stored in the collection.
-   * @param {'cosine' | 'euclidean' | 'dotproduct'} [metric=cosine] - The metric to use to sort vectors in the collection.
-   * @returns {Promise<void>} A promise that resolves when the collection is created.
-   */
-  async createIndex({ indexName, dimension, metric = "cosine" }) {
-    if (!Number.isInteger(dimension) || dimension <= 0) {
-      throw new MastraError({
-        id: createVectorErrorId("ASTRA", "CREATE_INDEX", "INVALID_DIMENSION"),
-        text: "Dimension must be a positive integer",
-        domain: ErrorDomain.MASTRA_VECTOR,
-        category: ErrorCategory.USER
-      });
-    }
-    try {
-      await this.#db.createCollection(indexName, {
-        vector: {
-          dimension,
-          metric: metricMap[metric]
-        },
-        checkExists: false
-      });
-    } catch (error) {
-      new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "CREATE_INDEX", "DB_ERROR"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Inserts or updates vectors in the specified collection.
-   *
-   * @param {string} indexName - The name of the collection to upsert into.
-   * @param {number[][]} vectors - An array of vectors to upsert.
-   * @param {Record<string, any>[]} [metadata] - An optional array of metadata objects corresponding to each vector.
-   * @param {string[]} [ids] - An optional array of IDs corresponding to each vector. If not provided, new IDs will be generated.
-   * @returns {Promise<string[]>} A promise that resolves to an array of IDs of the upserted vectors.
-   */
-  async upsert({ indexName, vectors, metadata, ids }) {
-    const collection = this.#db.collection(indexName);
-    const vectorIds = ids || vectors.map(() => UUID.v7().toString());
-    const records = vectors.map((vector, i) => ({
-      id: vectorIds[i],
-      $vector: vector,
-      metadata: metadata?.[i] || {}
-    }));
-    try {
-      await collection.insertMany(records);
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "UPSERT", "DB_ERROR"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName }
-        },
-        error
-      );
-    }
-    return vectorIds;
-  }
-  transformFilter(filter) {
-    const translator = new AstraFilterTranslator();
-    return translator.translate(filter);
-  }
-  /**
-   * Queries the specified collection using a vector and optional filter.
-   *
-   * @param {string} indexName - The name of the collection to query.
-   * @param {number[]} queryVector - The vector to query with.
-   * @param {number} [topK] - The maximum number of results to return.
-   * @param {Record<string, any>} [filter] - An optional filter to apply to the query. For more on filters in Astra DB, see the filtering reference: https://docs.datastax.com/en/astra-db-serverless/api-reference/documents.html#operators
-   * @param {boolean} [includeVectors=false] - Whether to include the vectors in the response.
-   * @returns {Promise<QueryResult[]>} A promise that resolves to an array of query results.
-   */
-  async query({
-    indexName,
-    queryVector,
-    topK = 10,
-    filter,
-    includeVector = false
-  }) {
-    if (!queryVector) {
-      throw new MastraError({
-        id: createVectorErrorId("ASTRA", "QUERY", "MISSING_VECTOR"),
-        text: "queryVector is required for Astra queries. Metadata-only queries are not supported by this vector store.",
-        domain: ErrorDomain.MASTRA_VECTOR,
-        category: ErrorCategory.USER,
-        details: { indexName }
-      });
-    }
-    const collection = this.#db.collection(indexName);
-    const translatedFilter = this.transformFilter(filter);
-    try {
-      const cursor = collection.find(translatedFilter ?? {}, {
-        sort: { $vector: queryVector },
-        limit: topK,
-        includeSimilarity: true,
-        projection: {
-          $vector: includeVector ? true : false
-        }
-      });
-      const results = await cursor.toArray();
-      return results.map((result) => ({
-        id: result.id,
-        score: result.$similarity,
-        metadata: result.metadata,
-        ...includeVector && { vector: result.$vector }
-      }));
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "QUERY", "DB_ERROR"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Lists all collections in the database.
-   *
-   * @returns {Promise<string[]>} A promise that resolves to an array of collection names.
-   */
-  async listIndexes() {
-    try {
-      return await this.#db.listCollections({ nameOnly: true });
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "LIST_INDEXES", "DB_ERROR"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Retrieves statistics about a vector index.
-   *
-   * @param {string} indexName - The name of the index to describe
-   * @returns A promise that resolves to the index statistics including dimension, count and metric
-   */
-  async describeIndex({ indexName }) {
-    const collection = this.#db.collection(indexName);
-    try {
-      const optionsPromise = collection.options();
-      const countPromise = collection.countDocuments({}, 100);
-      const [options, count] = await Promise.all([optionsPromise, countPromise]);
-      const keys = Object.keys(metricMap);
-      const metric = keys.find((key) => metricMap[key] === options.vector?.metric);
-      return {
-        dimension: options.vector?.dimension,
-        metric,
-        count
-      };
-    } catch (error) {
-      if (error instanceof MastraError) throw error;
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "DESCRIBE_INDEX", "DB_ERROR"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Deletes the specified collection.
-   *
-   * @param {string} indexName - The name of the collection to delete.
-   * @returns {Promise<void>} A promise that resolves when the collection is deleted.
-   */
-  async deleteIndex({ indexName }) {
-    const collection = this.#db.collection(indexName);
-    try {
-      await collection.drop();
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "DELETE_INDEX", "DB_ERROR"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Updates a vector by its ID with the provided vector and/or metadata.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to update.
-   * @param update - An object containing the vector and/or metadata to update.
-   * @param update.vector - An optional array of numbers representing the new vector.
-   * @param update.metadata - An optional record containing the new metadata.
-   * @returns A promise that resolves when the update is complete.
-   * @throws Will throw an error if no updates are provided or if the update operation fails.
-   */
-  async updateVector({ indexName, id, update }) {
-    if (!id) {
-      throw new MastraError({
-        id: createVectorErrorId("ASTRA", "UPDATE_VECTOR", "NO_ID"),
-        text: "id is required for Astra updateVector",
-        domain: ErrorDomain.MASTRA_VECTOR,
-        category: ErrorCategory.USER,
-        details: { indexName }
-      });
-    }
-    if (!update.vector && !update.metadata) {
-      throw new MastraError({
-        id: createVectorErrorId("ASTRA", "UPDATE_VECTOR", "NO_PAYLOAD"),
-        text: "No updates provided for vector",
-        domain: ErrorDomain.MASTRA_VECTOR,
-        category: ErrorCategory.USER,
-        details: {
-          indexName,
-          id
-        }
-      });
-    }
-    try {
-      const collection = this.#db.collection(indexName);
-      const updateDoc = {};
-      if (update.vector) {
-        updateDoc.$vector = update.vector;
-      }
-      if (update.metadata) {
-        updateDoc.metadata = update.metadata;
-      }
-      await collection.findOneAndUpdate({ id }, { $set: updateDoc });
-    } catch (error) {
-      if (error instanceof MastraError) throw error;
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "UPDATE_VECTOR", "FAILED_UNHANDLED"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: {
-            indexName,
-            ...id && { id }
-          }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Deletes a vector by its ID.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to delete.
-   * @returns A promise that resolves when the deletion is complete.
-   * @throws Will throw an error if the deletion operation fails.
-   */
-  async deleteVector({ indexName, id }) {
-    try {
-      const collection = this.#db.collection(indexName);
-      await collection.deleteOne({ id });
-    } catch (error) {
-      if (error instanceof MastraError) throw error;
-      throw new MastraError(
-        {
-          id: createVectorErrorId("ASTRA", "DELETE_VECTOR", "FAILED"),
-          domain: ErrorDomain.MASTRA_VECTOR,
-          category: ErrorCategory.THIRD_PARTY,
-          details: {
-            indexName,
-            ...id && { id }
-          }
-        },
-        error
-      );
-    }
-  }
-  async deleteVectors({ indexName, filter, ids }) {
-    throw new MastraError({
-      id: createVectorErrorId("ASTRA", "DELETE_VECTORS", "NOT_SUPPORTED"),
-      text: "deleteVectors is not yet implemented for Astra vector store",
-      domain: ErrorDomain.MASTRA_VECTOR,
-      category: ErrorCategory.SYSTEM,
-      details: {
-        indexName,
-        ...filter && { filter: JSON.stringify(filter) },
-        ...ids && { idsCount: ids.length }
-      }
-    });
-  }
+	#db;
+	constructor({ token, endpoint, keyspace, id }) {
+		super({ id });
+		const client = new DataAPIClient(token);
+		this.#db = client.db(endpoint, { keyspace });
+	}
+	/**
+	* Creates a new collection with the specified configuration.
+	*
+	* @param {string} indexName - The name of the collection to create.
+	* @param {number} dimension - The dimension of the vectors to be stored in the collection.
+	* @param {'cosine' | 'euclidean' | 'dotproduct'} [metric=cosine] - The metric to use to sort vectors in the collection.
+	* @returns {Promise<void>} A promise that resolves when the collection is created.
+	*/
+	async createIndex({ indexName, dimension, metric = "cosine" }) {
+		if (!Number.isInteger(dimension) || dimension <= 0) throw new MastraError({
+			id: createVectorErrorId("ASTRA", "CREATE_INDEX", "INVALID_DIMENSION"),
+			text: "Dimension must be a positive integer",
+			domain: ErrorDomain.MASTRA_VECTOR,
+			category: ErrorCategory.USER
+		});
+		try {
+			await this.#db.createCollection(indexName, {
+				vector: {
+					dimension,
+					metric: metricMap[metric]
+				},
+				checkExists: false
+			});
+		} catch (error) {
+			new MastraError({
+				id: createVectorErrorId("ASTRA", "CREATE_INDEX", "DB_ERROR"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: { indexName }
+			}, error);
+		}
+	}
+	/**
+	* Inserts or updates vectors in the specified collection.
+	*
+	* @param {string} indexName - The name of the collection to upsert into.
+	* @param {number[][]} vectors - An array of vectors to upsert.
+	* @param {Record<string, any>[]} [metadata] - An optional array of metadata objects corresponding to each vector.
+	* @param {string[]} [ids] - An optional array of IDs corresponding to each vector. If not provided, new IDs will be generated.
+	* @returns {Promise<string[]>} A promise that resolves to an array of IDs of the upserted vectors.
+	*/
+	async upsert({ indexName, vectors, metadata, ids }) {
+		const collection = this.#db.collection(indexName);
+		const vectorIds = ids || vectors.map(() => UUID.v7().toString());
+		const records = vectors.map((vector, i) => ({
+			id: vectorIds[i],
+			$vector: vector,
+			metadata: metadata?.[i] || {}
+		}));
+		try {
+			await collection.insertMany(records);
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "UPSERT", "DB_ERROR"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: { indexName }
+			}, error);
+		}
+		return vectorIds;
+	}
+	transformFilter(filter) {
+		return new AstraFilterTranslator().translate(filter);
+	}
+	/**
+	* Queries the specified collection using a vector and optional filter.
+	*
+	* @param {string} indexName - The name of the collection to query.
+	* @param {number[]} queryVector - The vector to query with.
+	* @param {number} [topK] - The maximum number of results to return.
+	* @param {Record<string, any>} [filter] - An optional filter to apply to the query. For more on filters in Astra DB, see the filtering reference: https://docs.datastax.com/en/astra-db-serverless/api-reference/documents.html#operators
+	* @param {boolean} [includeVectors=false] - Whether to include the vectors in the response.
+	* @returns {Promise<QueryResult[]>} A promise that resolves to an array of query results.
+	*/
+	async query({ indexName, queryVector, topK = 10, filter, includeVector = false }) {
+		if (!queryVector) throw new MastraError({
+			id: createVectorErrorId("ASTRA", "QUERY", "MISSING_VECTOR"),
+			text: "queryVector is required for Astra queries. Metadata-only queries are not supported by this vector store.",
+			domain: ErrorDomain.MASTRA_VECTOR,
+			category: ErrorCategory.USER,
+			details: { indexName }
+		});
+		const collection = this.#db.collection(indexName);
+		const translatedFilter = this.transformFilter(filter);
+		try {
+			return (await collection.find(translatedFilter ?? {}, {
+				sort: { $vector: queryVector },
+				limit: topK,
+				includeSimilarity: true,
+				projection: { $vector: includeVector ? true : false }
+			}).toArray()).map((result) => ({
+				id: result.id,
+				score: result.$similarity,
+				metadata: result.metadata,
+				...includeVector && { vector: result.$vector }
+			}));
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "QUERY", "DB_ERROR"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: { indexName }
+			}, error);
+		}
+	}
+	/**
+	* Lists all collections in the database.
+	*
+	* @returns {Promise<string[]>} A promise that resolves to an array of collection names.
+	*/
+	async listIndexes() {
+		try {
+			return await this.#db.listCollections({ nameOnly: true });
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "LIST_INDEXES", "DB_ERROR"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY
+			}, error);
+		}
+	}
+	/**
+	* Retrieves statistics about a vector index.
+	*
+	* @param {string} indexName - The name of the index to describe
+	* @returns A promise that resolves to the index statistics including dimension, count and metric
+	*/
+	async describeIndex({ indexName }) {
+		const collection = this.#db.collection(indexName);
+		try {
+			const optionsPromise = collection.options();
+			const countPromise = collection.countDocuments({}, 100);
+			const [options, count] = await Promise.all([optionsPromise, countPromise]);
+			const metric = Object.keys(metricMap).find((key) => metricMap[key] === options.vector?.metric);
+			return {
+				dimension: options.vector?.dimension,
+				metric,
+				count
+			};
+		} catch (error) {
+			if (error instanceof MastraError) throw error;
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "DESCRIBE_INDEX", "DB_ERROR"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: { indexName }
+			}, error);
+		}
+	}
+	/**
+	* Deletes the specified collection.
+	*
+	* @param {string} indexName - The name of the collection to delete.
+	* @returns {Promise<void>} A promise that resolves when the collection is deleted.
+	*/
+	async deleteIndex({ indexName }) {
+		const collection = this.#db.collection(indexName);
+		try {
+			await collection.drop();
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "DELETE_INDEX", "DB_ERROR"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: { indexName }
+			}, error);
+		}
+	}
+	/**
+	* Updates a vector by its ID with the provided vector and/or metadata.
+	* @param indexName - The name of the index containing the vector.
+	* @param id - The ID of the vector to update.
+	* @param update - An object containing the vector and/or metadata to update.
+	* @param update.vector - An optional array of numbers representing the new vector.
+	* @param update.metadata - An optional record containing the new metadata.
+	* @returns A promise that resolves when the update is complete.
+	* @throws Will throw an error if no updates are provided or if the update operation fails.
+	*/
+	async updateVector({ indexName, id, update }) {
+		if (!id) throw new MastraError({
+			id: createVectorErrorId("ASTRA", "UPDATE_VECTOR", "NO_ID"),
+			text: "id is required for Astra updateVector",
+			domain: ErrorDomain.MASTRA_VECTOR,
+			category: ErrorCategory.USER,
+			details: { indexName }
+		});
+		if (!update.vector && !update.metadata) throw new MastraError({
+			id: createVectorErrorId("ASTRA", "UPDATE_VECTOR", "NO_PAYLOAD"),
+			text: "No updates provided for vector",
+			domain: ErrorDomain.MASTRA_VECTOR,
+			category: ErrorCategory.USER,
+			details: {
+				indexName,
+				id
+			}
+		});
+		try {
+			const collection = this.#db.collection(indexName);
+			const updateDoc = {};
+			if (update.vector) updateDoc.$vector = update.vector;
+			if (update.metadata) updateDoc.metadata = update.metadata;
+			await collection.findOneAndUpdate({ id }, { $set: updateDoc });
+		} catch (error) {
+			if (error instanceof MastraError) throw error;
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "UPDATE_VECTOR", "FAILED_UNHANDLED"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					...id && { id }
+				}
+			}, error);
+		}
+	}
+	/**
+	* Deletes a vector by its ID.
+	* @param indexName - The name of the index containing the vector.
+	* @param id - The ID of the vector to delete.
+	* @returns A promise that resolves when the deletion is complete.
+	* @throws Will throw an error if the deletion operation fails.
+	*/
+	async deleteVector({ indexName, id }) {
+		try {
+			await this.#db.collection(indexName).deleteOne({ id });
+		} catch (error) {
+			if (error instanceof MastraError) throw error;
+			throw new MastraError({
+				id: createVectorErrorId("ASTRA", "DELETE_VECTOR", "FAILED"),
+				domain: ErrorDomain.MASTRA_VECTOR,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					...id && { id }
+				}
+			}, error);
+		}
+	}
+	async deleteVectors({ indexName, filter, ids }) {
+		throw new MastraError({
+			id: createVectorErrorId("ASTRA", "DELETE_VECTORS", "NOT_SUPPORTED"),
+			text: "deleteVectors is not yet implemented for Astra vector store",
+			domain: ErrorDomain.MASTRA_VECTOR,
+			category: ErrorCategory.SYSTEM,
+			details: {
+				indexName,
+				...filter && { filter: JSON.stringify(filter) },
+				...ids && { idsCount: ids.length }
+			}
+		});
+	}
 };
-
-// src/vector/prompt.ts
-var ASTRA_PROMPT = `When querying Astra, you can ONLY use the operators listed below. Any other operators will be rejected.
+//#endregion
+//#region src/vector/prompt.ts
+/**
+* Vector store specific prompt that details supported operators and examples.
+* This prompt helps users construct valid filters for Astra Vector.
+*/
+const ASTRA_PROMPT = `When querying Astra, you can ONLY use the operators listed below. Any other operators will be rejected.
 Important: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.
 If 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.
 
@@ -450,7 +406,7 @@ Example Complex Query:
     ]}
   ]
 }`;
-
+//#endregion
 export { ASTRA_PROMPT, AstraVector };
-//# sourceMappingURL=index.js.map
+
 //# sourceMappingURL=index.js.map