@mastra/mssql 1.2.0-alpha.0 → 1.2.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @mastra/mssql
 
+## 1.2.1-alpha.0
+
+### Patch Changes
+
+- Add `BackgroundTasksStorage` domain implementation so `@mastra/core` background task execution works with any storage adapter. ([#15307](https://github.com/mastra-ai/mastra/pull/15307))
+
+- Updated dependencies [[`d63ffdb`](https://github.com/mastra-ai/mastra/commit/d63ffdbb2c11e76fe5ea45faab44bc15460f010c)]:
+  - @mastra/core@1.25.1-alpha.0
+
+## 1.2.0
+
+### Minor Changes
+
+- Added `requestContext` column to the spans table. Request context data from tracing is now persisted alongside other span data. ([#14020](https://github.com/mastra-ai/mastra/pull/14020))
+
+### Patch Changes
+
+- Added resilient column handling to insert and update operations. Unknown columns in records are now silently dropped instead of causing SQL errors, ensuring forward compatibility when newer domain packages add fields that haven't been migrated yet. ([#14021](https://github.com/mastra-ai/mastra/pull/14021))
+
+  For example, calling `db.insert({ tableName, record: { id: '1', title: 'Hello', futureField: 'value' } })` will silently ignore `futureField` if it doesn't exist in the database table, rather than throwing. The same applies to `update` — unknown fields in the data payload are dropped before building the SQL statement.
+
+- Improved semantic recall performance for large message histories. Semantic recall no longer loads entire threads when only the recalled messages are needed, eliminating delays that previously scaled with total message count. (Fixes #11702) ([#14022](https://github.com/mastra-ai/mastra/pull/14022))
+
+- Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`866cc2c`](https://github.com/mastra-ai/mastra/commit/866cc2cb1f0e3b314afab5194f69477fada745d1), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`1d0a8a8`](https://github.com/mastra-ai/mastra/commit/1d0a8a8acf33203d5744fc429b090ad8598aa8ed), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`6bcbf8a`](https://github.com/mastra-ai/mastra/commit/6bcbf8a6774d5a53b21d61db8a45ce2593ca1616), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`18c3a90`](https://github.com/mastra-ai/mastra/commit/18c3a90c9e48cf69500e308affeb8eba5860b2af), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`f35487b`](https://github.com/mastra-ai/mastra/commit/f35487bb2d46c636e22aa71d90025613ae38235a), [`6dc2192`](https://github.com/mastra-ai/mastra/commit/6dc21921aef0f0efab15cd0805fa3d18f277a76f), [`eeb3a3f`](https://github.com/mastra-ai/mastra/commit/eeb3a3f43aca10cf49479eed2a84b7d9ecea02ba), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`05f8d90`](https://github.com/mastra-ai/mastra/commit/05f8d9009290ce6aa03428b3add635268615db85), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`4b8da97`](https://github.com/mastra-ai/mastra/commit/4b8da97a5ce306e97869df6c39535d9069e563db), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`256df35`](https://github.com/mastra-ai/mastra/commit/256df3571d62beb3ad4971faa432927cc140e603), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
+  - @mastra/core@1.11.0
+
 ## 1.2.0-alpha.0
 
 ### Minor 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.2.0-alpha.0"
+  version: "1.2.1-alpha.0"
 ---
 
 ## When to use
@@ -16,7 +16,7 @@ Read the individual reference documents for detailed explanations and code examp
 
 ### Reference
 
-- [Reference: MSSQL Storage](references/reference-storage-mssql.md) - Documentation for the MSSQL storage implementation in Mastra.
+- [Reference: MSSQL storage](references/reference-storage-mssql.md) - Documentation for the MSSQL storage implementation in Mastra.
 
 
 Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/docs/references/reference-storage-mssql.md

@@ -1,4 +1,4 @@
-# MSSQL Storage
+# MSSQL storage
 
 The MSSQL storage implementation provides a production-ready storage solution using Microsoft SQL Server databases.
 
@@ -45,7 +45,7 @@ const storage = new MSSQLStore({
 
 **schemaName** (`string`): The name of the schema you want the storage to use. Will use the default schema if not provided.
 
-## Constructor Examples
+## Constructor examples
 
 You can instantiate `MSSQLStore` in the following ways:
 
@@ -89,7 +89,7 @@ const store5 = new MSSQLStore({
 })
 ```
 
-## Additional Notes
+## Additional notes
 
 ### Schema Management
 

package/dist/index.cjs

@@ -3,9 +3,9 @@
 var error = require('@mastra/core/error');
 var storage = require('@mastra/core/storage');
 var sql = require('mssql');
-var agent = require('@mastra/core/agent');
 var base = require('@mastra/core/base');
 var utils = require('@mastra/core/utils');
+var agent = require('@mastra/core/agent');
 var crypto = require('crypto');
 var evals = require('@mastra/core/evals');
 
@@ -1356,7 +1356,319 @@ function transformFromSqlRow({
   return result;
 }
 
-// src/storage/domains/memory/index.ts
+// src/storage/domains/background-tasks/index.ts
+function serializeJson(v) {
+  if (typeof v === "object" && v != null) return JSON.stringify(v);
+  return v ?? null;
+}
+function rowToTask(row) {
+  const parseJson = (val) => {
+    if (val == null) return void 0;
+    if (typeof val === "string") {
+      try {
+        return JSON.parse(val);
+      } catch {
+        return val;
+      }
+    }
+    return val;
+  };
+  return {
+    id: row.id,
+    status: row.status,
+    toolName: row.tool_name,
+    toolCallId: row.tool_call_id,
+    args: parseJson(row.args) ?? {},
+    agentId: row.agent_id,
+    threadId: row.thread_id ?? void 0,
+    resourceId: row.resource_id ?? void 0,
+    runId: row.run_id ?? "",
+    result: parseJson(row.result),
+    error: parseJson(row.error),
+    retryCount: Number(row.retry_count),
+    maxRetries: Number(row.max_retries),
+    timeoutMs: Number(row.timeout_ms),
+    createdAt: row.createdAt instanceof Date ? row.createdAt : new Date(row.createdAt),
+    startedAt: row.startedAt ? row.startedAt instanceof Date ? row.startedAt : new Date(row.startedAt) : void 0,
+    completedAt: row.completedAt ? row.completedAt instanceof Date ? row.completedAt : new Date(row.completedAt) : void 0
+  };
+}
+var BackgroundTasksMSSQL = class _BackgroundTasksMSSQL extends storage.BackgroundTasksStorage {
+  pool;
+  db;
+  schema;
+  needsConnect;
+  skipDefaultIndexes;
+  indexes;
+  static MANAGED_TABLES = [storage.TABLE_BACKGROUND_TASKS];
+  constructor(config) {
+    super();
+    const { pool, schemaName, skipDefaultIndexes, indexes, needsConnect } = resolveMssqlConfig(config);
+    this.pool = pool;
+    this.schema = schemaName;
+    this.db = new MssqlDB({ pool, schemaName, skipDefaultIndexes });
+    this.needsConnect = needsConnect;
+    this.skipDefaultIndexes = skipDefaultIndexes;
+    this.indexes = indexes?.filter(
+      (idx) => _BackgroundTasksMSSQL.MANAGED_TABLES.includes(idx.table)
+    );
+  }
+  async init() {
+    if (this.needsConnect) {
+      await this.pool.connect();
+      this.needsConnect = false;
+    }
+    await this.db.createTable({
+      tableName: storage.TABLE_BACKGROUND_TASKS,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_BACKGROUND_TASKS]
+    });
+    await this.createDefaultIndexes();
+    await this.createCustomIndexes();
+  }
+  getDefaultIndexDefinitions() {
+    const schemaPrefix = this.schema ? `${this.schema}_` : "";
+    return [
+      {
+        name: `${schemaPrefix}mastra_bg_tasks_status_created_at_idx`,
+        table: storage.TABLE_BACKGROUND_TASKS,
+        columns: ["status", "createdAt"]
+      },
+      {
+        name: `${schemaPrefix}mastra_bg_tasks_agent_status_idx`,
+        table: storage.TABLE_BACKGROUND_TASKS,
+        columns: ["agent_id", "status"]
+      },
+      {
+        name: `${schemaPrefix}mastra_bg_tasks_thread_idx`,
+        table: storage.TABLE_BACKGROUND_TASKS,
+        columns: ["thread_id", "createdAt"]
+      },
+      {
+        name: `${schemaPrefix}mastra_bg_tasks_tool_call_idx`,
+        table: storage.TABLE_BACKGROUND_TASKS,
+        columns: ["tool_call_id"]
+      }
+    ];
+  }
+  async createDefaultIndexes() {
+    if (this.skipDefaultIndexes) return;
+    for (const indexDef of this.getDefaultIndexDefinitions()) {
+      try {
+        await this.db.createIndex(indexDef);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create index ${indexDef.name}:`, error);
+      }
+    }
+  }
+  async createCustomIndexes() {
+    if (!this.indexes || this.indexes.length === 0) return;
+    for (const indexDef of this.indexes) {
+      try {
+        await this.db.createIndex(indexDef);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create custom index ${indexDef.name}:`, error);
+      }
+    }
+  }
+  async dangerouslyClearAll() {
+    await this.db.clearTable({ tableName: storage.TABLE_BACKGROUND_TASKS });
+  }
+  tableName() {
+    return getTableName2({ indexName: storage.TABLE_BACKGROUND_TASKS, schemaName: getSchemaName2(this.schema) });
+  }
+  async createTask(task) {
+    await this.db.insert({
+      tableName: storage.TABLE_BACKGROUND_TASKS,
+      record: {
+        id: task.id,
+        tool_call_id: task.toolCallId,
+        tool_name: task.toolName,
+        agent_id: task.agentId,
+        thread_id: task.threadId ?? null,
+        resource_id: task.resourceId ?? null,
+        run_id: task.runId,
+        status: task.status,
+        args: serializeJson(task.args),
+        result: serializeJson(task.result),
+        error: serializeJson(task.error),
+        retry_count: task.retryCount,
+        max_retries: task.maxRetries,
+        timeout_ms: task.timeoutMs,
+        createdAt: task.createdAt.toISOString(),
+        startedAt: task.startedAt?.toISOString() ?? null,
+        completedAt: task.completedAt?.toISOString() ?? null
+      }
+    });
+  }
+  async updateTask(taskId, update) {
+    const setClauses = [];
+    const params = {};
+    let idx = 1;
+    if ("status" in update) {
+      setClauses.push(`[status] = @p${idx}`);
+      params[`p${idx++}`] = update.status;
+    }
+    if ("result" in update) {
+      setClauses.push(`[result] = @p${idx}`);
+      params[`p${idx++}`] = serializeJson(update.result);
+    }
+    if ("error" in update) {
+      setClauses.push(`[error] = @p${idx}`);
+      params[`p${idx++}`] = serializeJson(update.error);
+    }
+    if ("retryCount" in update) {
+      setClauses.push(`[retry_count] = @p${idx}`);
+      params[`p${idx++}`] = update.retryCount;
+    }
+    if ("startedAt" in update) {
+      setClauses.push(`[startedAt] = @p${idx}`);
+      params[`p${idx++}`] = update.startedAt?.toISOString() ?? null;
+    }
+    if ("completedAt" in update) {
+      setClauses.push(`[completedAt] = @p${idx}`);
+      params[`p${idx++}`] = update.completedAt?.toISOString() ?? null;
+    }
+    if (setClauses.length === 0) return;
+    setClauses.push(`[id] = [id]`);
+    params[`p${idx}`] = taskId;
+    const request = this.pool.request();
+    for (const [name, value] of Object.entries(params)) {
+      request.input(name, value);
+    }
+    await request.query(`UPDATE ${this.tableName()} SET ${setClauses.join(", ")} WHERE [id] = @p${idx}`);
+  }
+  async getTask(taskId) {
+    const request = this.pool.request();
+    request.input("p1", taskId);
+    const result = await request.query(`SELECT * FROM ${this.tableName()} WHERE [id] = @p1`);
+    if (result.recordset.length === 0) return null;
+    return rowToTask(result.recordset[0]);
+  }
+  async listTasks(filter) {
+    const conditions = [];
+    const params = {};
+    let idx = 1;
+    if (filter.status) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      const placeholders = statuses.map(() => {
+        const name = `p${idx++}`;
+        return `@${name}`;
+      });
+      statuses.forEach((s, i) => {
+        params[`p${idx - statuses.length + i}`] = s;
+      });
+      conditions.push(`[status] IN (${placeholders.join(", ")})`);
+    }
+    if (filter.agentId) {
+      params[`p${idx}`] = filter.agentId;
+      conditions.push(`[agent_id] = @p${idx++}`);
+    }
+    if (filter.threadId) {
+      params[`p${idx}`] = filter.threadId;
+      conditions.push(`[thread_id] = @p${idx++}`);
+    }
+    if (filter.resourceId) {
+      params[`p${idx}`] = filter.resourceId;
+      conditions.push(`[resource_id] = @p${idx++}`);
+    }
+    if (filter.runId) {
+      params[`p${idx}`] = filter.runId;
+      conditions.push(`[run_id] = @p${idx++}`);
+    }
+    if (filter.toolName) {
+      params[`p${idx}`] = filter.toolName;
+      conditions.push(`[tool_name] = @p${idx++}`);
+    }
+    const dateCol = filter.dateFilterBy === "startedAt" ? "[startedAt]" : filter.dateFilterBy === "completedAt" ? "[completedAt]" : "[createdAt]";
+    if (filter.fromDate) {
+      params[`p${idx}`] = filter.fromDate.toISOString();
+      conditions.push(`${dateCol} >= @p${idx++}`);
+    }
+    if (filter.toDate) {
+      params[`p${idx}`] = filter.toDate.toISOString();
+      conditions.push(`${dateCol} < @p${idx++}`);
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const countRequest = this.pool.request();
+    for (const [name, value] of Object.entries(params)) {
+      countRequest.input(name, value);
+    }
+    const countResult = await countRequest.query(`SELECT COUNT(*) as count FROM ${this.tableName()} ${where}`);
+    const total = Number(countResult.recordset[0]?.count ?? 0);
+    const orderCol = filter.orderBy === "startedAt" ? "[startedAt]" : filter.orderBy === "completedAt" ? "[completedAt]" : "[createdAt]";
+    const direction = filter.orderDirection === "desc" ? "DESC" : "ASC";
+    let sql5 = `SELECT * FROM ${this.tableName()} ${where} ORDER BY ${orderCol} ${direction}`;
+    if (filter.perPage != null) {
+      const offset = filter.page != null ? filter.page * filter.perPage : 0;
+      params[`p${idx}`] = offset;
+      params[`p${idx + 1}`] = filter.perPage;
+      sql5 += ` OFFSET @p${idx} ROWS FETCH NEXT @p${idx + 1} ROWS ONLY`;
+      idx += 2;
+    }
+    const request = this.pool.request();
+    for (const [name, value] of Object.entries(params)) {
+      request.input(name, value);
+    }
+    const result = await request.query(sql5);
+    return { tasks: result.recordset.map(rowToTask), total };
+  }
+  async deleteTask(taskId) {
+    const request = this.pool.request();
+    request.input("p1", taskId);
+    await request.query(`DELETE FROM ${this.tableName()} WHERE [id] = @p1`);
+  }
+  async deleteTasks(filter) {
+    const conditions = [];
+    const params = {};
+    let idx = 1;
+    if (filter.status) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      const placeholders = statuses.map(() => {
+        const name = `p${idx++}`;
+        return `@${name}`;
+      });
+      statuses.forEach((s, i) => {
+        params[`p${idx - statuses.length + i}`] = s;
+      });
+      conditions.push(`[status] IN (${placeholders.join(", ")})`);
+    }
+    const dateCol = filter.dateFilterBy === "startedAt" ? "[startedAt]" : filter.dateFilterBy === "completedAt" ? "[completedAt]" : "[createdAt]";
+    if (filter.fromDate) {
+      params[`p${idx}`] = filter.fromDate.toISOString();
+      conditions.push(`${dateCol} >= @p${idx++}`);
+    }
+    if (filter.toDate) {
+      params[`p${idx}`] = filter.toDate.toISOString();
+      conditions.push(`${dateCol} < @p${idx++}`);
+    }
+    if (filter.agentId) {
+      params[`p${idx}`] = filter.agentId;
+      conditions.push(`[agent_id] = @p${idx++}`);
+    }
+    if (filter.runId) {
+      params[`p${idx}`] = filter.runId;
+      conditions.push(`[run_id] = @p${idx++}`);
+    }
+    if (conditions.length === 0) return;
+    const request = this.pool.request();
+    for (const [name, value] of Object.entries(params)) {
+      request.input(name, value);
+    }
+    await request.query(`DELETE FROM ${this.tableName()} WHERE ${conditions.join(" AND ")}`);
+  }
+  async getRunningCount() {
+    const result = await this.pool.request().query(`SELECT COUNT(*) as count FROM ${this.tableName()} WHERE [status] = 'running'`);
+    return Number(result.recordset[0]?.count ?? 0);
+  }
+  async getRunningCountByAgent(agentId) {
+    const request = this.pool.request();
+    request.input("p1", agentId);
+    const result = await request.query(
+      `SELECT COUNT(*) as count FROM ${this.tableName()} WHERE [status] = 'running' AND [agent_id] = @p1`
+    );
+    return Number(result.recordset[0]?.count ?? 0);
+  }
+};
 var MemoryMSSQL = class _MemoryMSSQL extends storage.MemoryStorage {
   pool;
   schema;
@@ -3994,11 +4306,13 @@ var MSSQLStore = class extends storage.MastraCompositeStore {
       const workflows = new WorkflowsMSSQL(domainConfig);
       const memory = new MemoryMSSQL(domainConfig);
       const observability = new ObservabilityMSSQL(domainConfig);
+      const backgroundTasks = new BackgroundTasksMSSQL(domainConfig);
       this.stores = {
         scores,
         workflows,
         memory,
-        observability
+        observability,
+        backgroundTasks
       };
     } catch (e) {
       throw new error.MastraError(
@@ -4051,6 +4365,7 @@ var MSSQLStore = class extends storage.MastraCompositeStore {
   }
 };
 
+exports.BackgroundTasksMSSQL = BackgroundTasksMSSQL;
 exports.MSSQLStore = MSSQLStore;
 exports.MemoryMSSQL = MemoryMSSQL;
 exports.ObservabilityMSSQL = ObservabilityMSSQL;