@mastra/mssql 1.4.1 → 1.5.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @mastra/mssql
 
+## 1.5.0-alpha.0
+
+### Minor Changes
+
+- Added exact metadata filtering to message history queries across Memory APIs and supported storage providers. ([#19991](https://github.com/mastra-ai/mastra/pull/19991))
+
+  ```ts
+  const messages = await memory.recall({
+    threadId: 'thread-1',
+    filter: {
+      metadata: {
+        status: 'done',
+        priority: 'high',
+      },
+    },
+  });
+  ```
+
+  Multiple fields use AND semantics. Supported values are strings, finite numbers, booleans, and `null`.
+
+### Patch Changes
+
+- Updated dependencies [[`0dca9d0`](https://github.com/mastra-ai/mastra/commit/0dca9d0b1356024a53b72ea6f040db528b126caa)]:
+  - @mastra/core@1.54.0-alpha.0
+
 ## 1.4.1
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-mssql
 description: Documentation for @mastra/mssql. Use when working with @mastra/mssql APIs, configuration, or implementation.
 metadata:
   package: "@mastra/mssql"
-  version: "1.4.1"
+  version: "1.5.0-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.1",
+  "version": "1.5.0-alpha.0",
   "package": "@mastra/mssql",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -2292,6 +2292,32 @@ var BackgroundTasksMSSQL = class _BackgroundTasksMSSQL extends storage.Backgroun
     return Number(result.recordset[0]?.count ?? 0);
   }
 };
+function bindMssqlMetadataParams(request, params) {
+  for (const [paramName, paramValue] of Object.entries(params)) {
+    request.input(paramName, paramValue);
+  }
+}
+function buildMssqlMessageMetadataFilter(metadataFilter) {
+  if (!metadataFilter) return { clauses: [], params: {} };
+  const clauses = [];
+  const params = {};
+  Object.entries(metadataFilter).forEach(([key, value], index) => {
+    const keyParam = `metadataKey${index}`;
+    params[keyParam] = key;
+    clauses.push("ISJSON(content) = 1");
+    if (value === null) {
+      clauses.push(`EXISTS (SELECT 1 FROM OPENJSON(content, '$.metadata') WHERE [key] = @${keyParam} AND [type] = 0)`);
+      return;
+    }
+    const valueParam = `metadataValue${index}`;
+    params[valueParam] = String(value);
+    const jsonType = typeof value === "string" ? 1 : typeof value === "number" ? 2 : 3;
+    clauses.push(
+      `EXISTS (SELECT 1 FROM OPENJSON(content, '$.metadata') WHERE [key] = @${keyParam} AND [type] = ${jsonType} AND [value] = @${valueParam})`
+    );
+  });
+  return { clauses, params };
+}
 var MemoryMSSQL = class _MemoryMSSQL extends storage.MemoryStorage {
   pool;
   schema;
@@ -2851,6 +2877,7 @@ var MemoryMSSQL = class _MemoryMSSQL extends storage.MemoryStorage {
   }
   async listMessages(args) {
     const { threadId, resourceId, include, filter, perPage: perPageInput, page = 0, orderBy } = args;
+    const metadataFilter = storage.validateStorageMetadataFilter(filter?.metadata);
     const threadIds = Array.isArray(threadId) ? threadId : [threadId];
     if (threadIds.length === 0 || threadIds.some((id) => !id.trim())) {
       throw new error.MastraError(
@@ -2887,10 +2914,13 @@ var MemoryMSSQL = class _MemoryMSSQL extends storage.MemoryStorage {
         ...resourceId ? { resourceId } : {},
         ...buildDateRangeFilter(filter?.dateRange, "createdAt")
       };
-      const { sql: actualWhereClause = "", params: whereParams } = prepareWhereClause(
+      const { sql: preparedWhereClause = "", params: whereParams } = prepareWhereClause(
         filters);
+      const metadataWhere = buildMssqlMessageMetadataFilter(metadataFilter);
+      const actualWhereClause = metadataWhere.clauses.length ? `${preparedWhereClause || " WHERE 1 = 1"} AND ${metadataWhere.clauses.join(" AND ")}` : preparedWhereClause;
       const bindWhereParams = (req) => {
         Object.entries(whereParams).forEach(([paramName, paramValue]) => req.input(paramName, paramValue));
+        bindMssqlMetadataParams(req, metadataWhere.params);
       };
       if (perPage === 0 && (!include || include.length === 0)) {
         return { messages: [], total: 0, page, perPage: perPageForResponse, hasMore: false };
@@ -2926,6 +2956,7 @@ var MemoryMSSQL = class _MemoryMSSQL extends storage.MemoryStorage {
       };
       const baseRows = perPage === 0 ? [] : await fetchBaseMessages();
       const messages = [...baseRows];
+      const primaryPageCount = messages.length;
       const seqById = /* @__PURE__ */ new Map();
       messages.forEach((msg) => {
         if (typeof msg.seq_id === "number") seqById.set(msg.id, msg.seq_id);
@@ -2966,7 +2997,7 @@ var MemoryMSSQL = class _MemoryMSSQL extends storage.MemoryStorage {
       });
       const threadIdSet = new Set(threadIds);
       const returnedThreadMessageCount = finalMessages.filter((m) => m.threadId && threadIdSet.has(m.threadId)).length;
-      const hasMore = perPageInput !== false && returnedThreadMessageCount < total && offset + perPage < total;
+      const hasMore = metadataFilter ? perPageInput !== false && offset + primaryPageCount < total : perPageInput !== false && returnedThreadMessageCount < total && offset + perPage < total;
       return {
         messages: finalMessages,
         total,