@mastra/convex 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/convex
 
+## 1.0.8
+
+### 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 [[`20f59b8`](https://github.com/mastra-ai/mastra/commit/20f59b876cf91199efbc49a0e36b391240708f08), [`aba393e`](https://github.com/mastra-ai/mastra/commit/aba393e2da7390c69b80e516a4f153cda6f09376), [`3d83d06`](https://github.com/mastra-ai/mastra/commit/3d83d06f776f00fb5f4163dddd32a030c5c20844), [`e2687a7`](https://github.com/mastra-ai/mastra/commit/e2687a7408790c384563816a9a28ed06735684c9), [`fdd54cf`](https://github.com/mastra-ai/mastra/commit/fdd54cf612a9af876e9fdd85e534454f6e7dd518), [`6315317`](https://github.com/mastra-ai/mastra/commit/63153175fe9a7b224e5be7c209bbebc01dd9b0d5), [`a371ac5`](https://github.com/mastra-ai/mastra/commit/a371ac534aa1bb368a1acf9d8b313378dfdc787e), [`0474c2b`](https://github.com/mastra-ai/mastra/commit/0474c2b2e7c7e1ad8691dca031284841391ff1ef), [`0a5fa1d`](https://github.com/mastra-ai/mastra/commit/0a5fa1d3cb0583889d06687155f26fd7d2edc76c), [`7e0e63e`](https://github.com/mastra-ai/mastra/commit/7e0e63e2e485e84442351f4c7a79a424c83539dc), [`ea43e64`](https://github.com/mastra-ai/mastra/commit/ea43e646dd95d507694b6112b0bf1df22ad552b2), [`f607106`](https://github.com/mastra-ai/mastra/commit/f607106854c6416c4a07d4082604b9f66d047221), [`30456b6`](https://github.com/mastra-ai/mastra/commit/30456b6b08c8fd17e109dd093b73d93b65e83bc5), [`9d11a8c`](https://github.com/mastra-ai/mastra/commit/9d11a8c1c8924eb975a245a5884d40ca1b7e0491), [`9d3b24b`](https://github.com/mastra-ai/mastra/commit/9d3b24b19407ae9c09586cf7766d38dc4dff4a69), [`00d1b16`](https://github.com/mastra-ai/mastra/commit/00d1b16b401199cb294fa23f43336547db4dca9b), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`62919a6`](https://github.com/mastra-ai/mastra/commit/62919a6ee0fbf3779ad21a97b1ec6696515d5104), [`d246696`](https://github.com/mastra-ai/mastra/commit/d246696139a3144a5b21b042d41c532688e957e1), [`354f9ce`](https://github.com/mastra-ai/mastra/commit/354f9ce1ca6af2074b6a196a23f8ec30012dccca), [`16e34ca`](https://github.com/mastra-ai/mastra/commit/16e34caa98b9a114b17a6125e4e3fd87f169d0d0), [`7020c06`](https://github.com/mastra-ai/mastra/commit/7020c0690b199d9da337f0e805f16948e557922e), [`8786a61`](https://github.com/mastra-ai/mastra/commit/8786a61fa54ba265f85eeff9985ca39863d18bb6), [`9467ea8`](https://github.com/mastra-ai/mastra/commit/9467ea87695749a53dfc041576410ebf9ee7bb67), [`7338d94`](https://github.com/mastra-ai/mastra/commit/7338d949380cf68b095342e8e42610dc51d557c1), [`c80dc16`](https://github.com/mastra-ai/mastra/commit/c80dc16e113e6cc159f510ffde501ad4711b2189), [`af8a57e`](https://github.com/mastra-ai/mastra/commit/af8a57ed9ba9685ad8601d5b71ae3706da6222f9), [`d63ffdb`](https://github.com/mastra-ai/mastra/commit/d63ffdbb2c11e76fe5ea45faab44bc15460f010c), [`47cee3e`](https://github.com/mastra-ai/mastra/commit/47cee3e137fe39109cf7fffd2a8cf47b76dc702e), [`1bd5104`](https://github.com/mastra-ai/mastra/commit/1bd51048b6da93507276d6623e3fd96a9e1a8944), [`e9837b5`](https://github.com/mastra-ai/mastra/commit/e9837b53699e18711b09e0ca010a4106376f2653), [`8f1b280`](https://github.com/mastra-ai/mastra/commit/8f1b280b7fe6999ec654f160cb69c1a8719e7a57), [`92dcf02`](https://github.com/mastra-ai/mastra/commit/92dcf029294210ac91b090900c1a0555a425c57a), [`0fd90a2`](https://github.com/mastra-ai/mastra/commit/0fd90a215caf5fca8099c15a67ca03e4427747a3), [`8fb2405`](https://github.com/mastra-ai/mastra/commit/8fb2405138f2d208b7962ad03f121ca25bcc28c5), [`12df98c`](https://github.com/mastra-ai/mastra/commit/12df98c4904643d9481f5c78f3bed443725b4c96)]:
+  - @mastra/core@1.26.0
+
+## 1.0.8-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.0.7
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-convex
 description: Documentation for @mastra/convex. Use when working with @mastra/convex APIs, configuration, or implementation.
 metadata:
   package: "@mastra/convex"
-  version: "1.0.7"
+  version: "1.0.8"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.7",
+  "version": "1.0.8",
   "package": "@mastra/convex",
   "exports": {
     "mastraStorage": {

package/dist/index.cjs

@@ -3,10 +3,10 @@
 var chunkPW7BUVK5_cjs = require('./chunk-PW7BUVK5.cjs');
 var chunkFTVDAP6U_cjs = require('./chunk-FTVDAP6U.cjs');
 var storage = require('@mastra/core/storage');
-var agent = require('@mastra/core/agent');
-var error = require('@mastra/core/error');
 var crypto = require('crypto');
 var base = require('@mastra/core/base');
+var agent = require('@mastra/core/agent');
+var error = require('@mastra/core/error');
 var vector = require('@mastra/core/vector');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -87,6 +87,7 @@ var ConvexDB = class extends base.MastraBase {
     super({ name: "convex-db" });
     this.client = client;
   }
+  client;
   async hasColumn(_table, _column) {
     return true;
   }
@@ -181,7 +182,134 @@ var ConvexDB = class extends base.MastraBase {
   }
 };
 
-// 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 ?? void 0;
+}
+function toStored(task) {
+  return {
+    ...task,
+    args: serializeJson(task.args),
+    result: serializeJson(task.result),
+    error: serializeJson(task.error),
+    createdAt: task.createdAt.toISOString(),
+    startedAt: task.startedAt?.toISOString(),
+    completedAt: task.completedAt?.toISOString()
+  };
+}
+function fromStored(stored) {
+  const parseJson = (val) => {
+    if (!val) return void 0;
+    try {
+      return JSON.parse(val);
+    } catch {
+      return val;
+    }
+  };
+  return {
+    id: stored.id,
+    status: stored.status,
+    toolName: stored.toolName,
+    toolCallId: stored.toolCallId,
+    args: parseJson(stored.args) ?? {},
+    agentId: stored.agentId,
+    threadId: stored.threadId,
+    resourceId: stored.resourceId,
+    runId: stored.runId,
+    result: parseJson(stored.result),
+    error: parseJson(stored.error),
+    retryCount: stored.retryCount,
+    maxRetries: stored.maxRetries,
+    timeoutMs: stored.timeoutMs,
+    createdAt: new Date(stored.createdAt),
+    startedAt: stored.startedAt ? new Date(stored.startedAt) : void 0,
+    completedAt: stored.completedAt ? new Date(stored.completedAt) : void 0
+  };
+}
+var BackgroundTasksConvex = class extends storage.BackgroundTasksStorage {
+  #db;
+  constructor(config) {
+    super();
+    const client = resolveConvexConfig(config);
+    this.#db = new ConvexDB(client);
+  }
+  async dangerouslyClearAll() {
+    await this.#db.clearTable({ tableName: storage.TABLE_BACKGROUND_TASKS });
+  }
+  async createTask(task) {
+    await this.#db.insert({ tableName: storage.TABLE_BACKGROUND_TASKS, record: toStored(task) });
+  }
+  async updateTask(taskId, update) {
+    const existing = await this.getTask(taskId);
+    if (!existing) return;
+    const merged = { ...existing };
+    if ("status" in update) merged.status = update.status;
+    if ("result" in update) merged.result = update.result;
+    if ("error" in update) merged.error = update.error;
+    if ("retryCount" in update) merged.retryCount = update.retryCount;
+    if ("startedAt" in update) merged.startedAt = update.startedAt;
+    if ("completedAt" in update) merged.completedAt = update.completedAt;
+    await this.#db.deleteMany(storage.TABLE_BACKGROUND_TASKS, [taskId]);
+    await this.#db.insert({ tableName: storage.TABLE_BACKGROUND_TASKS, record: toStored(merged) });
+  }
+  async getTask(taskId) {
+    const data = await this.#db.load({ tableName: storage.TABLE_BACKGROUND_TASKS, keys: { id: taskId } });
+    return data ? fromStored(data) : null;
+  }
+  async listTasks(filter) {
+    const all = await this.#db.queryTable(storage.TABLE_BACKGROUND_TASKS);
+    let tasks = all.map(fromStored);
+    if (filter.status) {
+      const s = Array.isArray(filter.status) ? filter.status : [filter.status];
+      tasks = tasks.filter((t) => s.includes(t.status));
+    }
+    if (filter.agentId) tasks = tasks.filter((t) => t.agentId === filter.agentId);
+    if (filter.threadId) tasks = tasks.filter((t) => t.threadId === filter.threadId);
+    if (filter.toolName) tasks = tasks.filter((t) => t.toolName === filter.toolName);
+    if (filter.runId) tasks = tasks.filter((t) => t.runId === filter.runId);
+    const dateCol = filter.dateFilterBy ?? "createdAt";
+    if (filter.fromDate) {
+      tasks = tasks.filter((t) => {
+        const val = t[dateCol];
+        return val != null && val >= filter.fromDate;
+      });
+    }
+    if (filter.toDate) {
+      tasks = tasks.filter((t) => {
+        const val = t[dateCol];
+        return val != null && val < filter.toDate;
+      });
+    }
+    const orderBy = filter.orderBy ?? "createdAt";
+    const dir = filter.orderDirection === "desc" ? -1 : 1;
+    tasks.sort((a, b) => ((a[orderBy]?.getTime() ?? 0) - (b[orderBy]?.getTime() ?? 0)) * dir);
+    const total = tasks.length;
+    if (filter.page != null && filter.perPage != null) {
+      const start = filter.page * filter.perPage;
+      tasks = tasks.slice(start, start + filter.perPage);
+    } else if (filter.perPage != null) {
+      tasks = tasks.slice(0, filter.perPage);
+    }
+    return { tasks, total };
+  }
+  async deleteTask(taskId) {
+    await this.#db.deleteMany(storage.TABLE_BACKGROUND_TASKS, [taskId]);
+  }
+  async deleteTasks(filter) {
+    const { tasks } = await this.listTasks(filter);
+    const taskIds = tasks.map((t) => t.id);
+    await this.#db.deleteMany(storage.TABLE_BACKGROUND_TASKS, taskIds);
+  }
+  async getRunningCount() {
+    const { total } = await this.listTasks({ status: "running" });
+    return total;
+  }
+  async getRunningCountByAgent(agentId) {
+    const { total } = await this.listTasks({ status: "running", agentId });
+    return total;
+  }
+};
 var MemoryConvex = class extends storage.MemoryStorage {
   #db;
   constructor(config) {
@@ -939,7 +1067,8 @@ var ConvexStore = class extends storage.MastraCompositeStore {
     this.stores = {
       memory,
       workflows,
-      scores
+      scores,
+      backgroundTasks: new BackgroundTasksConvex(domainConfig)
     };
   }
 };