@mastra/core 0.9.4 → 0.10.0-alpha.1

package/dist/utils.d.cts

@@ -1,27 +1,26 @@
-import { ar as VercelTool, C as ToolAction, a as Mastra, b3 as MastraPrimitives, H as MastraMemory, b4 as ToolsInput, as as CoreTool, F as Agent, L as Workflow, K as Step, au as StepExecutionContext, aK as WorkflowContext, t as NewWorkflow, N as NewStep, b5 as AgentNetwork, b6 as MCPServerBase } from './base-CAEcd6q2.cjs';
+import { aO as VercelTool, a9 as ToolAction, a as Mastra, bf as MastraPrimitives, ab as MastraMemory, t as ToolsInput, aP as CoreTool, r as Agent, q as LegacyWorkflow, p as LegacyStep, x as StepExecutionContext, s as WorkflowContext, af as Workflow, ae as Step, bg as AgentNetwork, bh as MCPServerBase } from './base-aJ3etsh5.cjs';
 import { LanguageModelV1, CoreMessage, Message } from 'ai';
 import { MastraTTS } from './tts/index.cjs';
 import { MastraVector } from './vector/index.cjs';
-import { a as Metric } from './types-BtMyV38I.cjs';
+import { M as Metric } from './types-Bo1uigWx.cjs';
 import { z } from 'zod';
-import { L as Logger } from './index-QV27jkxQ.cjs';
-import './base-H7siSAfu.cjs';
+import { I as IMastraLogger } from './logger-EhZkzZOr.cjs';
+import './base-aPYtPBT2.cjs';
 import { RuntimeContext } from './runtime-context/index.cjs';
 import 'sift';
 import 'json-schema';
-import '@opentelemetry/api';
-import 'xstate';
-import 'node:events';
-import 'node:http';
-import 'hono';
-import 'events';
 import './deployer/index.cjs';
 import './bundler/index.cjs';
+import '@opentelemetry/api';
 import 'stream';
-import 'pino';
 import '@opentelemetry/sdk-trace-base';
+import 'node:http';
+import 'hono';
 import 'hono/cors';
 import 'hono-openapi';
+import 'xstate';
+import 'node:events';
+import 'events';
 import 'ai/test';
 import './vector/filter/index.cjs';
 
@@ -64,7 +63,7 @@ interface ToolOptions {
     runId?: string;
     threadId?: string;
     resourceId?: string;
-    logger?: Logger;
+    logger?: IMastraLogger;
     description?: string;
     mastra?: (Mastra & MastraPrimitives) | MastraPrimitives;
     runtimeContext: RuntimeContext;
@@ -101,9 +100,53 @@ declare function makeCoreTool(originalTool: ToolToConvert, options: ToolOptions,
  */
 declare function createMastraProxy({ mastra, logger }: {
     mastra: Mastra;
-    logger: Logger;
-}): Mastra<Record<string, Agent<any, ToolsInput, Record<string, Metric>>>, Record<string, Workflow<Step<string, any, any, StepExecutionContext<any, WorkflowContext<any, Step<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, NewWorkflow<NewStep<string, any, any, any, any>[], string, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>>>, Record<string, MastraVector>, Record<string, MastraTTS>, Logger, Record<string, AgentNetwork>, Record<string, MCPServerBase>>;
-declare function checkEvalStorageFields(traceObject: any, logger?: Logger): boolean;
+    logger: IMastraLogger;
+}): Mastra<Record<string, Agent<any, ToolsInput, Record<string, Metric>>>, Record<string, LegacyWorkflow<LegacyStep<string, any, any, StepExecutionContext<any, WorkflowContext<any, LegacyStep<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, Workflow<Step<string, any, any, any, any>[], string, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>>>, Record<string, MastraVector>, Record<string, MastraTTS>, IMastraLogger, Record<string, AgentNetwork>, Record<string, MCPServerBase>>;
+declare function checkEvalStorageFields(traceObject: any, logger?: IMastraLogger): boolean;
+declare function isUiMessage(message: CoreMessage | Message): message is Message;
+declare function isCoreMessage(message: CoreMessage | Message): message is CoreMessage;
 declare function ensureAllMessagesAreCoreMessages(messages: (CoreMessage | Message)[]): CoreMessage[];
+/** Represents a validated SQL identifier (e.g., table or column name). */
+type SqlIdentifier = string & {
+    __brand: 'SqlIdentifier';
+};
+/** Represents a validated dot-separated SQL field key. */
+type FieldKey = string & {
+    __brand: 'FieldKey';
+};
+/**
+ * Parses and returns a valid SQL identifier (such as a table or column name).
+ * The identifier must:
+ *   - Start with a letter (a-z, A-Z) or underscore (_)
+ *   - Contain only letters, numbers, or underscores
+ *   - Be at most 63 characters long
+ *
+ * @param name - The identifier string to parse.
+ * @param kind - Optional label for error messages (e.g., 'table name').
+ * @returns The validated identifier as a branded type.
+ * @throws {Error} If the identifier does not conform to SQL naming rules.
+ *
+ * @example
+ * const id = parseSqlIdentifier('my_table'); // Ok
+ * parseSqlIdentifier('123table'); // Throws error
+ */
+declare function parseSqlIdentifier(name: string, kind?: string): SqlIdentifier;
+/**
+ * Parses and returns a valid dot-separated SQL field key (e.g., 'user.profile.name').
+ * Each segment must:
+ *   - Start with a letter (a-z, A-Z) or underscore (_)
+ *   - Contain only letters, numbers, or underscores
+ *   - Be at most 63 characters long
+ *
+ * @param key - The dot-separated field key string to parse.
+ * @returns The validated field key as a branded type.
+ * @throws {Error} If any segment of the key is invalid.
+ *
+ * @example
+ * const key = parseFieldKey('user_profile.name'); // Ok
+ * parseFieldKey('user..name'); // Throws error
+ * parseFieldKey('user.123name'); // Throws error
+ */
+declare function parseFieldKey(key: string): FieldKey;
 
-export { type TagMaskOptions, type ToolOptions, checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureAllMessagesAreCoreMessages, ensureToolProperties, isVercelTool, isZodType, makeCoreTool, maskStreamTags, resolveSerializedZodOutput };
+export { type TagMaskOptions, type ToolOptions, checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureAllMessagesAreCoreMessages, ensureToolProperties, isCoreMessage, isUiMessage, isVercelTool, isZodType, makeCoreTool, maskStreamTags, parseFieldKey, parseSqlIdentifier, resolveSerializedZodOutput };

package/dist/utils.d.ts

@@ -1,27 +1,26 @@
-import { ar as VercelTool, C as ToolAction, a as Mastra, b3 as MastraPrimitives, H as MastraMemory, b4 as ToolsInput, as as CoreTool, F as Agent, L as Workflow, K as Step, au as StepExecutionContext, aK as WorkflowContext, t as NewWorkflow, N as NewStep, b5 as AgentNetwork, b6 as MCPServerBase } from './base-BCfssGt6.js';
+import { aO as VercelTool, a9 as ToolAction, a as Mastra, bf as MastraPrimitives, ab as MastraMemory, t as ToolsInput, aP as CoreTool, r as Agent, q as LegacyWorkflow, p as LegacyStep, x as StepExecutionContext, s as WorkflowContext, af as Workflow, ae as Step, bg as AgentNetwork, bh as MCPServerBase } from './base-DttB7sJD.js';
 import { LanguageModelV1, CoreMessage, Message } from 'ai';
 import { MastraTTS } from './tts/index.js';
 import { MastraVector } from './vector/index.js';
-import { a as Metric } from './types-BtMyV38I.js';
+import { M as Metric } from './types-Bo1uigWx.js';
 import { z } from 'zod';
-import { L as Logger } from './index-QV27jkxQ.js';
-import './base-4Z34GQL8.js';
+import { I as IMastraLogger } from './logger-EhZkzZOr.js';
+import './base-tc5kgDTD.js';
 import { RuntimeContext } from './runtime-context/index.js';
 import 'sift';
 import 'json-schema';
-import '@opentelemetry/api';
-import 'xstate';
-import 'node:events';
-import 'node:http';
-import 'hono';
-import 'events';
 import './deployer/index.js';
 import './bundler/index.js';
+import '@opentelemetry/api';
 import 'stream';
-import 'pino';
 import '@opentelemetry/sdk-trace-base';
+import 'node:http';
+import 'hono';
 import 'hono/cors';
 import 'hono-openapi';
+import 'xstate';
+import 'node:events';
+import 'events';
 import 'ai/test';
 import './vector/filter/index.js';
 
@@ -64,7 +63,7 @@ interface ToolOptions {
     runId?: string;
     threadId?: string;
     resourceId?: string;
-    logger?: Logger;
+    logger?: IMastraLogger;
     description?: string;
     mastra?: (Mastra & MastraPrimitives) | MastraPrimitives;
     runtimeContext: RuntimeContext;
@@ -101,9 +100,53 @@ declare function makeCoreTool(originalTool: ToolToConvert, options: ToolOptions,
  */
 declare function createMastraProxy({ mastra, logger }: {
     mastra: Mastra;
-    logger: Logger;
-}): Mastra<Record<string, Agent<any, ToolsInput, Record<string, Metric>>>, Record<string, Workflow<Step<string, any, any, StepExecutionContext<any, WorkflowContext<any, Step<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, NewWorkflow<NewStep<string, any, any, any, any>[], string, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>>>, Record<string, MastraVector>, Record<string, MastraTTS>, Logger, Record<string, AgentNetwork>, Record<string, MCPServerBase>>;
-declare function checkEvalStorageFields(traceObject: any, logger?: Logger): boolean;
+    logger: IMastraLogger;
+}): Mastra<Record<string, Agent<any, ToolsInput, Record<string, Metric>>>, Record<string, LegacyWorkflow<LegacyStep<string, any, any, StepExecutionContext<any, WorkflowContext<any, LegacyStep<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, Workflow<Step<string, any, any, any, any>[], string, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>>>, Record<string, MastraVector>, Record<string, MastraTTS>, IMastraLogger, Record<string, AgentNetwork>, Record<string, MCPServerBase>>;
+declare function checkEvalStorageFields(traceObject: any, logger?: IMastraLogger): boolean;
+declare function isUiMessage(message: CoreMessage | Message): message is Message;
+declare function isCoreMessage(message: CoreMessage | Message): message is CoreMessage;
 declare function ensureAllMessagesAreCoreMessages(messages: (CoreMessage | Message)[]): CoreMessage[];
+/** Represents a validated SQL identifier (e.g., table or column name). */
+type SqlIdentifier = string & {
+    __brand: 'SqlIdentifier';
+};
+/** Represents a validated dot-separated SQL field key. */
+type FieldKey = string & {
+    __brand: 'FieldKey';
+};
+/**
+ * Parses and returns a valid SQL identifier (such as a table or column name).
+ * The identifier must:
+ *   - Start with a letter (a-z, A-Z) or underscore (_)
+ *   - Contain only letters, numbers, or underscores
+ *   - Be at most 63 characters long
+ *
+ * @param name - The identifier string to parse.
+ * @param kind - Optional label for error messages (e.g., 'table name').
+ * @returns The validated identifier as a branded type.
+ * @throws {Error} If the identifier does not conform to SQL naming rules.
+ *
+ * @example
+ * const id = parseSqlIdentifier('my_table'); // Ok
+ * parseSqlIdentifier('123table'); // Throws error
+ */
+declare function parseSqlIdentifier(name: string, kind?: string): SqlIdentifier;
+/**
+ * Parses and returns a valid dot-separated SQL field key (e.g., 'user.profile.name').
+ * Each segment must:
+ *   - Start with a letter (a-z, A-Z) or underscore (_)
+ *   - Contain only letters, numbers, or underscores
+ *   - Be at most 63 characters long
+ *
+ * @param key - The dot-separated field key string to parse.
+ * @returns The validated field key as a branded type.
+ * @throws {Error} If any segment of the key is invalid.
+ *
+ * @example
+ * const key = parseFieldKey('user_profile.name'); // Ok
+ * parseFieldKey('user..name'); // Throws error
+ * parseFieldKey('user.123name'); // Throws error
+ */
+declare function parseFieldKey(key: string): FieldKey;
 
-export { type TagMaskOptions, type ToolOptions, checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureAllMessagesAreCoreMessages, ensureToolProperties, isVercelTool, isZodType, makeCoreTool, maskStreamTags, resolveSerializedZodOutput };
+export { type TagMaskOptions, type ToolOptions, checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureAllMessagesAreCoreMessages, ensureToolProperties, isCoreMessage, isUiMessage, isVercelTool, isZodType, makeCoreTool, maskStreamTags, parseFieldKey, parseSqlIdentifier, resolveSerializedZodOutput };

package/dist/utils.js

@@ -1 +1 @@
-export { checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureAllMessagesAreCoreMessages, ensureToolProperties, isVercelTool, isZodType, makeCoreTool, maskStreamTags, resolveSerializedZodOutput } from './chunk-S34QVMKE.js';
+export { checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureAllMessagesAreCoreMessages, ensureToolProperties, isCoreMessage, isUiMessage, isVercelTool, isZodType, makeCoreTool, maskStreamTags, parseFieldKey, parseSqlIdentifier, resolveSerializedZodOutput } from './chunk-2PW6UJMW.js';

package/dist/vector/filter/index.cjs

@@ -1,10 +1,192 @@
 'use strict';
 
-var chunkYK3XJ52U_cjs = require('../../chunk-YK3XJ52U.cjs');
+// src/vector/filter/base.ts
+var BaseFilterTranslator = class _BaseFilterTranslator {
+  /**
+   * Operator type checks
+   */
+  isOperator(key) {
+    return key.startsWith("$");
+  }
+  static BASIC_OPERATORS = ["$eq", "$ne"];
+  static NUMERIC_OPERATORS = ["$gt", "$gte", "$lt", "$lte"];
+  static ARRAY_OPERATORS = ["$in", "$nin", "$all", "$elemMatch"];
+  static LOGICAL_OPERATORS = ["$and", "$or", "$not", "$nor"];
+  static ELEMENT_OPERATORS = ["$exists"];
+  static REGEX_OPERATORS = ["$regex", "$options"];
+  static DEFAULT_OPERATORS = {
+    logical: _BaseFilterTranslator.LOGICAL_OPERATORS,
+    basic: _BaseFilterTranslator.BASIC_OPERATORS,
+    numeric: _BaseFilterTranslator.NUMERIC_OPERATORS,
+    array: _BaseFilterTranslator.ARRAY_OPERATORS,
+    element: _BaseFilterTranslator.ELEMENT_OPERATORS,
+    regex: _BaseFilterTranslator.REGEX_OPERATORS
+  };
+  isLogicalOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.logical.includes(key);
+  }
+  isBasicOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.basic.includes(key);
+  }
+  isNumericOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.numeric.includes(key);
+  }
+  isArrayOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.array.includes(key);
+  }
+  isElementOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.element.includes(key);
+  }
+  isRegexOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.regex.includes(key);
+  }
+  isFieldOperator(key) {
+    return this.isOperator(key) && !this.isLogicalOperator(key);
+  }
+  isCustomOperator(key) {
+    const support = this.getSupportedOperators();
+    return support.custom?.includes(key) ?? false;
+  }
+  getSupportedOperators() {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS;
+  }
+  isValidOperator(key) {
+    const support = this.getSupportedOperators();
+    const allSupported = Object.values(support).flat();
+    return allSupported.includes(key);
+  }
+  /**
+   * Value normalization for comparison operators
+   */
+  normalizeComparisonValue(value) {
+    if (value instanceof Date) {
+      return value.toISOString();
+    }
+    if (typeof value === "number" && Object.is(value, -0)) {
+      return 0;
+    }
+    return value;
+  }
+  /**
+   * Helper method to simulate $all operator using $and + $eq when needed.
+   * Some vector stores don't support $all natively.
+   */
+  simulateAllOperator(field, values) {
+    return {
+      $and: values.map((value) => ({
+        [field]: { $in: [this.normalizeComparisonValue(value)] }
+      }))
+    };
+  }
+  /**
+   * Utility functions for type checking
+   */
+  isPrimitive(value) {
+    return value === null || value === void 0 || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+  }
+  isRegex(value) {
+    return value instanceof RegExp;
+  }
+  isEmpty(obj) {
+    return obj === null || obj === void 0 || typeof obj === "object" && Object.keys(obj).length === 0;
+  }
+  static ErrorMessages = {
+    UNSUPPORTED_OPERATOR: (op) => `Unsupported operator: ${op}`,
+    INVALID_LOGICAL_OPERATOR_LOCATION: (op, path) => `Logical operator ${op} cannot be used at field level: ${path}`,
+    NOT_REQUIRES_OBJECT: `$not operator requires an object`,
+    NOT_CANNOT_BE_EMPTY: `$not operator cannot be empty`,
+    INVALID_LOGICAL_OPERATOR_CONTENT: (path) => `Logical operators must contain field conditions, not direct operators: ${path}`,
+    INVALID_TOP_LEVEL_OPERATOR: (op) => `Invalid top-level operator: ${op}`,
+    ELEM_MATCH_REQUIRES_OBJECT: `$elemMatch requires an object with conditions`
+  };
+  /**
+   * Helper to handle array value normalization consistently
+   */
+  normalizeArrayValues(values) {
+    return values.map((value) => this.normalizeComparisonValue(value));
+  }
+  validateFilter(filter) {
+    const validation = this.validateFilterSupport(filter);
+    if (!validation.supported) {
+      throw new Error(validation.messages.join(", "));
+    }
+  }
+  /**
+   * Validates if a filter structure is supported by the specific vector DB
+   * and returns detailed validation information.
+   */
+  validateFilterSupport(node, path = "") {
+    const messages = [];
+    if (this.isPrimitive(node) || this.isEmpty(node)) {
+      return { supported: true, messages: [] };
+    }
+    if (Array.isArray(node)) {
+      const arrayResults = node.map((item) => this.validateFilterSupport(item, path));
+      const arrayMessages = arrayResults.flatMap((r) => r.messages);
+      return {
+        supported: arrayResults.every((r) => r.supported),
+        messages: arrayMessages
+      };
+    }
+    const nodeObj = node;
+    let isSupported = true;
+    for (const [key, value] of Object.entries(nodeObj)) {
+      const newPath = path ? `${path}.${key}` : key;
+      if (this.isOperator(key)) {
+        if (!this.isValidOperator(key)) {
+          isSupported = false;
+          messages.push(_BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(key));
+          continue;
+        }
+        if (!path && !this.isLogicalOperator(key)) {
+          isSupported = false;
+          messages.push(_BaseFilterTranslator.ErrorMessages.INVALID_TOP_LEVEL_OPERATOR(key));
+          continue;
+        }
+        if (key === "$elemMatch" && (typeof value !== "object" || Array.isArray(value))) {
+          isSupported = false;
+          messages.push(_BaseFilterTranslator.ErrorMessages.ELEM_MATCH_REQUIRES_OBJECT);
+          continue;
+        }
+        if (this.isLogicalOperator(key)) {
+          if (key === "$not") {
+            if (Array.isArray(value) || typeof value !== "object") {
+              isSupported = false;
+              messages.push(_BaseFilterTranslator.ErrorMessages.NOT_REQUIRES_OBJECT);
+              continue;
+            }
+            if (this.isEmpty(value)) {
+              isSupported = false;
+              messages.push(_BaseFilterTranslator.ErrorMessages.NOT_CANNOT_BE_EMPTY);
+              continue;
+            }
+            continue;
+          }
+          if (path && !this.isLogicalOperator(path.split(".").pop())) {
+            isSupported = false;
+            messages.push(_BaseFilterTranslator.ErrorMessages.INVALID_LOGICAL_OPERATOR_LOCATION(key, newPath));
+            continue;
+          }
+          if (Array.isArray(value)) {
+            const hasDirectOperators = value.some(
+              (item) => typeof item === "object" && Object.keys(item).length === 1 && this.isFieldOperator(Object.keys(item)[0])
+            );
+            if (hasDirectOperators) {
+              isSupported = false;
+              messages.push(_BaseFilterTranslator.ErrorMessages.INVALID_LOGICAL_OPERATOR_CONTENT(newPath));
+              continue;
+            }
+          }
+        }
+      }
+      const nestedValidation = this.validateFilterSupport(value, newPath);
+      if (!nestedValidation.supported) {
+        isSupported = false;
+        messages.push(...nestedValidation.messages);
+      }
+    }
+    return { supported: isSupported, messages };
+  }
+};
 
-
-
-Object.defineProperty(exports, "BaseFilterTranslator", {
-  enumerable: true,
-  get: function () { return chunkYK3XJ52U_cjs.BaseFilterTranslator; }
-});
+exports.BaseFilterTranslator = BaseFilterTranslator;

package/dist/vector/filter/index.js

@@ -1 +1,190 @@
-export { BaseFilterTranslator } from '../../chunk-LGERQTJM.js';
+// src/vector/filter/base.ts
+var BaseFilterTranslator = class _BaseFilterTranslator {
+  /**
+   * Operator type checks
+   */
+  isOperator(key) {
+    return key.startsWith("$");
+  }
+  static BASIC_OPERATORS = ["$eq", "$ne"];
+  static NUMERIC_OPERATORS = ["$gt", "$gte", "$lt", "$lte"];
+  static ARRAY_OPERATORS = ["$in", "$nin", "$all", "$elemMatch"];
+  static LOGICAL_OPERATORS = ["$and", "$or", "$not", "$nor"];
+  static ELEMENT_OPERATORS = ["$exists"];
+  static REGEX_OPERATORS = ["$regex", "$options"];
+  static DEFAULT_OPERATORS = {
+    logical: _BaseFilterTranslator.LOGICAL_OPERATORS,
+    basic: _BaseFilterTranslator.BASIC_OPERATORS,
+    numeric: _BaseFilterTranslator.NUMERIC_OPERATORS,
+    array: _BaseFilterTranslator.ARRAY_OPERATORS,
+    element: _BaseFilterTranslator.ELEMENT_OPERATORS,
+    regex: _BaseFilterTranslator.REGEX_OPERATORS
+  };
+  isLogicalOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.logical.includes(key);
+  }
+  isBasicOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.basic.includes(key);
+  }
+  isNumericOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.numeric.includes(key);
+  }
+  isArrayOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.array.includes(key);
+  }
+  isElementOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.element.includes(key);
+  }
+  isRegexOperator(key) {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS.regex.includes(key);
+  }
+  isFieldOperator(key) {
+    return this.isOperator(key) && !this.isLogicalOperator(key);
+  }
+  isCustomOperator(key) {
+    const support = this.getSupportedOperators();
+    return support.custom?.includes(key) ?? false;
+  }
+  getSupportedOperators() {
+    return _BaseFilterTranslator.DEFAULT_OPERATORS;
+  }
+  isValidOperator(key) {
+    const support = this.getSupportedOperators();
+    const allSupported = Object.values(support).flat();
+    return allSupported.includes(key);
+  }
+  /**
+   * Value normalization for comparison operators
+   */
+  normalizeComparisonValue(value) {
+    if (value instanceof Date) {
+      return value.toISOString();
+    }
+    if (typeof value === "number" && Object.is(value, -0)) {
+      return 0;
+    }
+    return value;
+  }
+  /**
+   * Helper method to simulate $all operator using $and + $eq when needed.
+   * Some vector stores don't support $all natively.
+   */
+  simulateAllOperator(field, values) {
+    return {
+      $and: values.map((value) => ({
+        [field]: { $in: [this.normalizeComparisonValue(value)] }
+      }))
+    };
+  }
+  /**
+   * Utility functions for type checking
+   */
+  isPrimitive(value) {
+    return value === null || value === void 0 || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+  }
+  isRegex(value) {
+    return value instanceof RegExp;
+  }
+  isEmpty(obj) {
+    return obj === null || obj === void 0 || typeof obj === "object" && Object.keys(obj).length === 0;
+  }
+  static ErrorMessages = {
+    UNSUPPORTED_OPERATOR: (op) => `Unsupported operator: ${op}`,
+    INVALID_LOGICAL_OPERATOR_LOCATION: (op, path) => `Logical operator ${op} cannot be used at field level: ${path}`,
+    NOT_REQUIRES_OBJECT: `$not operator requires an object`,
+    NOT_CANNOT_BE_EMPTY: `$not operator cannot be empty`,
+    INVALID_LOGICAL_OPERATOR_CONTENT: (path) => `Logical operators must contain field conditions, not direct operators: ${path}`,
+    INVALID_TOP_LEVEL_OPERATOR: (op) => `Invalid top-level operator: ${op}`,
+    ELEM_MATCH_REQUIRES_OBJECT: `$elemMatch requires an object with conditions`
+  };
+  /**
+   * Helper to handle array value normalization consistently
+   */
+  normalizeArrayValues(values) {
+    return values.map((value) => this.normalizeComparisonValue(value));
+  }
+  validateFilter(filter) {
+    const validation = this.validateFilterSupport(filter);
+    if (!validation.supported) {
+      throw new Error(validation.messages.join(", "));
+    }
+  }
+  /**
+   * Validates if a filter structure is supported by the specific vector DB
+   * and returns detailed validation information.
+   */
+  validateFilterSupport(node, path = "") {
+    const messages = [];
+    if (this.isPrimitive(node) || this.isEmpty(node)) {
+      return { supported: true, messages: [] };
+    }
+    if (Array.isArray(node)) {
+      const arrayResults = node.map((item) => this.validateFilterSupport(item, path));
+      const arrayMessages = arrayResults.flatMap((r) => r.messages);
+      return {
+        supported: arrayResults.every((r) => r.supported),
+        messages: arrayMessages
+      };
+    }
+    const nodeObj = node;
+    let isSupported = true;
+    for (const [key, value] of Object.entries(nodeObj)) {
+      const newPath = path ? `${path}.${key}` : key;
+      if (this.isOperator(key)) {
+        if (!this.isValidOperator(key)) {
+          isSupported = false;
+          messages.push(_BaseFilterTranslator.ErrorMessages.UNSUPPORTED_OPERATOR(key));
+          continue;
+        }
+        if (!path && !this.isLogicalOperator(key)) {
+          isSupported = false;
+          messages.push(_BaseFilterTranslator.ErrorMessages.INVALID_TOP_LEVEL_OPERATOR(key));
+          continue;
+        }
+        if (key === "$elemMatch" && (typeof value !== "object" || Array.isArray(value))) {
+          isSupported = false;
+          messages.push(_BaseFilterTranslator.ErrorMessages.ELEM_MATCH_REQUIRES_OBJECT);
+          continue;
+        }
+        if (this.isLogicalOperator(key)) {
+          if (key === "$not") {
+            if (Array.isArray(value) || typeof value !== "object") {
+              isSupported = false;
+              messages.push(_BaseFilterTranslator.ErrorMessages.NOT_REQUIRES_OBJECT);
+              continue;
+            }
+            if (this.isEmpty(value)) {
+              isSupported = false;
+              messages.push(_BaseFilterTranslator.ErrorMessages.NOT_CANNOT_BE_EMPTY);
+              continue;
+            }
+            continue;
+          }
+          if (path && !this.isLogicalOperator(path.split(".").pop())) {
+            isSupported = false;
+            messages.push(_BaseFilterTranslator.ErrorMessages.INVALID_LOGICAL_OPERATOR_LOCATION(key, newPath));
+            continue;
+          }
+          if (Array.isArray(value)) {
+            const hasDirectOperators = value.some(
+              (item) => typeof item === "object" && Object.keys(item).length === 1 && this.isFieldOperator(Object.keys(item)[0])
+            );
+            if (hasDirectOperators) {
+              isSupported = false;
+              messages.push(_BaseFilterTranslator.ErrorMessages.INVALID_LOGICAL_OPERATOR_CONTENT(newPath));
+              continue;
+            }
+          }
+        }
+      }
+      const nestedValidation = this.validateFilterSupport(value, newPath);
+      if (!nestedValidation.supported) {
+        isSupported = false;
+        messages.push(...nestedValidation.messages);
+      }
+    }
+    return { supported: isSupported, messages };
+  }
+};
+
+export { BaseFilterTranslator };

package/dist/vector/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkWQKOM7XM_cjs = require('../chunk-WQKOM7XM.cjs');
+var chunkPIZM25KI_cjs = require('../chunk-PIZM25KI.cjs');
 
 
 
 Object.defineProperty(exports, "MastraVector", {
   enumerable: true,
-  get: function () { return chunkWQKOM7XM_cjs.MastraVector; }
+  get: function () { return chunkPIZM25KI_cjs.MastraVector; }
 });