@mastra/mssql 1.2.0 → 1.2.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @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

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"
+  version: "1.2.1-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

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;