@mastra/cloudflare-d1 1.0.4-alpha.0 → 1.0.5-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/cloudflare-d1
 
+## 1.0.5-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.4
+
+### Patch Changes
+
+- dependencies updates: ([#10188](https://github.com/mastra-ai/mastra/pull/10188))
+  - Updated dependency [`cloudflare@^5.2.0` ↗︎](https://www.npmjs.com/package/cloudflare/v/5.2.0) (from `^4.5.0`, in `dependencies`)
+- Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`fbf22a7`](https://github.com/mastra-ai/mastra/commit/fbf22a7ad86bcb50dcf30459f0d075e51ddeb468), [`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`12c647c`](https://github.com/mastra-ai/mastra/commit/12c647cf3a26826eb72d40b42e3c8356ceae16ed), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`819f03c`](https://github.com/mastra-ai/mastra/commit/819f03c25823373b32476413bd76be28a5d8705a), [`04160ee`](https://github.com/mastra-ai/mastra/commit/04160eedf3130003cf842ad08428c8ff69af4cc1), [`2c27503`](https://github.com/mastra-ai/mastra/commit/2c275032510d131d2cde47f99953abf0fe02c081), [`424a1df`](https://github.com/mastra-ai/mastra/commit/424a1df7bee59abb5c83717a54807fdd674a6224), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0), [`12c88a6`](https://github.com/mastra-ai/mastra/commit/12c88a6e32bf982c2fe0c6af62e65a3414519a75), [`43595bf`](https://github.com/mastra-ai/mastra/commit/43595bf7b8df1a6edce7a23b445b5124d2a0b473), [`78670e9`](https://github.com/mastra-ai/mastra/commit/78670e97e76d7422cf7025faf371b2aeafed860d), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`d400e7c`](https://github.com/mastra-ai/mastra/commit/d400e7c8b8d7afa6ba2c71769eace4048e3cef8e), [`f58d1a7`](https://github.com/mastra-ai/mastra/commit/f58d1a7a457588a996c3ecb53201a68f3d28c432), [`a49a929`](https://github.com/mastra-ai/mastra/commit/a49a92904968b4fc67e01effee8c7c8d0464ba85), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
+  - @mastra/core@1.18.0
+
 ## 1.0.4-alpha.0
 
 ### Patch Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.4-alpha.0",
+  "version": "1.0.5-alpha.0",
   "package": "@mastra/cloudflare-d1",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-storage-cloudflare-d1.md

@@ -2,7 +2,7 @@
 
 The Cloudflare D1 storage implementation provides a serverless SQL database solution using Cloudflare D1, supporting relational operations and transactional consistency.
 
-> **Observability Not Supported:** Cloudflare D1 storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to D1, and Mastra Studio's observability features won't work with D1 as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** Cloudflare D1 storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to D1, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with D1 as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 > **Row Size Limit:** Cloudflare D1 enforces a **1 MiB maximum row size**. This limit can be exceeded when storing messages with base64-encoded attachments such as images. See [Handling large attachments](https://mastra.ai/docs/memory/storage) for workarounds including uploading attachments to external storage.
 

package/dist/index.cjs

@@ -3,9 +3,9 @@
 var error = require('@mastra/core/error');
 var storage = require('@mastra/core/storage');
 var Cloudflare = require('cloudflare');
-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 evals = require('@mastra/core/evals');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -730,7 +730,246 @@ var D1DB = 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 ?? null;
+}
+function rowToTask(row) {
+  const parseJson = (val) => {
+    if (val == null || val === "") 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 ?? 0),
+    maxRetries: Number(row.max_retries ?? 0),
+    timeoutMs: Number(row.timeout_ms ?? 3e5),
+    createdAt: new Date(row.createdAt),
+    startedAt: row.startedAt ? new Date(row.startedAt) : void 0,
+    completedAt: row.completedAt ? new Date(row.completedAt) : void 0
+  };
+}
+var BackgroundTasksStorageD1 = class extends storage.BackgroundTasksStorage {
+  #db;
+  constructor(config) {
+    super();
+    const resolved = resolveD1Config(config);
+    this.#db = new D1DB(resolved);
+  }
+  async init() {
+    await this.#db.createTable({ tableName: storage.TABLE_BACKGROUND_TASKS, schema: storage.TABLE_SCHEMAS[storage.TABLE_BACKGROUND_TASKS] });
+  }
+  async dangerouslyClearAll() {
+    await this.#db.clearTable({ tableName: storage.TABLE_BACKGROUND_TASKS });
+  }
+  async createTask(task) {
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    const { sql, params } = createSqlBuilder().insert(
+      fullTableName,
+      [
+        "id",
+        "tool_call_id",
+        "tool_name",
+        "agent_id",
+        "thread_id",
+        "resource_id",
+        "run_id",
+        "status",
+        "args",
+        "result",
+        "error",
+        "retry_count",
+        "max_retries",
+        "timeout_ms",
+        "createdAt",
+        "startedAt",
+        "completedAt"
+      ],
+      [
+        task.id,
+        task.toolCallId,
+        task.toolName,
+        task.agentId,
+        task.threadId ?? null,
+        task.resourceId ?? null,
+        task.runId,
+        task.status,
+        serializeJson(task.args),
+        serializeJson(task.result),
+        serializeJson(task.error),
+        task.retryCount,
+        task.maxRetries,
+        task.timeoutMs,
+        task.createdAt.toISOString(),
+        task.startedAt?.toISOString() ?? null,
+        task.completedAt?.toISOString() ?? null
+      ]
+    ).build();
+    await this.#db.executeQuery({ sql, params });
+  }
+  async updateTask(taskId, update) {
+    const sets = [];
+    const params = [];
+    if ("status" in update) {
+      sets.push("status = ?");
+      params.push(update.status);
+    }
+    if ("result" in update) {
+      sets.push("result = ?");
+      params.push(serializeJson(update.result));
+    }
+    if ("error" in update) {
+      sets.push("error = ?");
+      params.push(serializeJson(update.error));
+    }
+    if ("retryCount" in update) {
+      sets.push("retry_count = ?");
+      params.push(update.retryCount);
+    }
+    if ("startedAt" in update) {
+      sets.push("startedAt = ?");
+      params.push(update.startedAt?.toISOString() ?? null);
+    }
+    if ("completedAt" in update) {
+      sets.push("completedAt = ?");
+      params.push(update.completedAt?.toISOString() ?? null);
+    }
+    if (sets.length === 0) return;
+    params.push(taskId);
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    await this.#db.executeQuery({
+      sql: `UPDATE ${fullTableName} SET ${sets.join(", ")} WHERE id = ?`,
+      params
+    });
+  }
+  async getTask(taskId) {
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    const { sql, params } = createSqlBuilder().select("*").from(fullTableName).where("id = ?", taskId).build();
+    const row = await this.#db.executeQuery({ sql, params, first: true });
+    return row ? rowToTask(row) : null;
+  }
+  async listTasks(filter) {
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    let builder = createSqlBuilder().select("*").from(fullTableName);
+    let countBuilder = createSqlBuilder().count().from(fullTableName);
+    if (filter.status) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      builder = builder.where(`status IN (${statuses.map(() => "?").join(",")})`, ...statuses);
+      countBuilder = countBuilder.where(`status IN (${statuses.map(() => "?").join(",")})`, ...statuses);
+    }
+    if (filter.agentId) {
+      builder = builder.whereAnd("agent_id = ?", filter.agentId);
+      countBuilder = countBuilder.whereAnd("agent_id = ?", filter.agentId);
+    }
+    if (filter.threadId) {
+      builder = builder.whereAnd("thread_id = ?", filter.threadId);
+      countBuilder = countBuilder.whereAnd("thread_id = ?", filter.threadId);
+    }
+    if (filter.runId) {
+      builder = builder.whereAnd("run_id = ?", filter.runId);
+      countBuilder = countBuilder.whereAnd("run_id = ?", filter.runId);
+    }
+    if (filter.toolName) {
+      builder = builder.whereAnd("tool_name = ?", filter.toolName);
+      countBuilder = countBuilder.whereAnd("tool_name = ?", filter.toolName);
+    }
+    const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
+    if (filter.fromDate) {
+      builder = builder.whereAnd(`${dateCol} >= ?`, filter.fromDate.toISOString());
+      countBuilder = countBuilder.whereAnd(`${dateCol} >= ?`, filter.fromDate.toISOString());
+    }
+    if (filter.toDate) {
+      builder = builder.whereAnd(`${dateCol} < ?`, filter.toDate.toISOString());
+      countBuilder = countBuilder.whereAnd(`${dateCol} < ?`, filter.toDate.toISOString());
+    }
+    const { sql: countSql, params: countParams } = countBuilder.build();
+    const countRow = await this.#db.executeQuery({ sql: countSql, params: countParams, first: true });
+    const total = Number(countRow?.count ?? 0);
+    const orderCol = filter.orderBy === "startedAt" ? "startedAt" : filter.orderBy === "completedAt" ? "completedAt" : "createdAt";
+    builder = builder.orderBy(orderCol, filter.orderDirection === "desc" ? "DESC" : "ASC");
+    if (filter.perPage != null) {
+      builder = builder.limit(filter.perPage);
+      if (filter.page != null) {
+        builder = builder.offset(filter.page * filter.perPage);
+      }
+    }
+    const { sql, params } = builder.build();
+    const rows = await this.#db.executeQuery({ sql, params });
+    return { tasks: rows.map(rowToTask), total };
+  }
+  async deleteTask(taskId) {
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    await this.#db.executeQuery({ sql: `DELETE FROM ${fullTableName} WHERE id = ?`, params: [taskId] });
+  }
+  async deleteTasks(filter) {
+    const conditions = [];
+    const params = [];
+    if (filter.status) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      conditions.push(`status IN (${statuses.map(() => "?").join(",")})`);
+      params.push(...statuses);
+    }
+    const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
+    if (filter.fromDate) {
+      conditions.push(`${dateCol} >= ?`);
+      params.push(filter.fromDate.toISOString());
+    }
+    if (filter.toDate) {
+      conditions.push(`${dateCol} < ?`);
+      params.push(filter.toDate.toISOString());
+    }
+    if (filter.agentId) {
+      conditions.push("agent_id = ?");
+      params.push(filter.agentId);
+    }
+    if (filter.runId) {
+      conditions.push("run_id = ?");
+      params.push(filter.runId);
+    }
+    if (conditions.length === 0) return;
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    await this.#db.executeQuery({
+      sql: `DELETE FROM ${fullTableName} WHERE ${conditions.join(" AND ")}`,
+      params
+    });
+  }
+  async getRunningCount() {
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    const row = await this.#db.executeQuery({
+      sql: `SELECT COUNT(*) as count FROM ${fullTableName} WHERE status = 'running'`,
+      params: [],
+      first: true
+    });
+    return Number(row?.count ?? 0);
+  }
+  async getRunningCountByAgent(agentId) {
+    const fullTableName = this.#db.getTableName(storage.TABLE_BACKGROUND_TASKS);
+    const row = await this.#db.executeQuery({
+      sql: `SELECT COUNT(*) as count FROM ${fullTableName} WHERE status = 'running' AND agent_id = ?`,
+      params: [agentId],
+      first: true
+    });
+    return Number(row?.count ?? 0);
+  }
+};
 var MemoryStorageD1 = class extends storage.MemoryStorage {
   #db;
   constructor(config) {
@@ -2229,21 +2468,25 @@ var D1Store = class extends storage.MastraCompositeStore {
     let scores;
     let workflows;
     let memory;
+    let backgroundTasks;
     if (this.binding) {
       const domainConfig = { binding: this.binding, tablePrefix: this.tablePrefix };
       scores = new ScoresStorageD1(domainConfig);
       workflows = new WorkflowsStorageD1(domainConfig);
       memory = new MemoryStorageD1(domainConfig);
+      backgroundTasks = new BackgroundTasksStorageD1(domainConfig);
     } else {
       const domainConfig = { client: this.client, tablePrefix: this.tablePrefix };
       scores = new ScoresStorageD1(domainConfig);
       workflows = new WorkflowsStorageD1(domainConfig);
       memory = new MemoryStorageD1(domainConfig);
+      backgroundTasks = new BackgroundTasksStorageD1(domainConfig);
     }
     this.stores = {
       scores,
       workflows,
-      memory
+      memory,
+      backgroundTasks
     };
   }
   /**
@@ -2255,6 +2498,7 @@ var D1Store = class extends storage.MastraCompositeStore {
   }
 };
 
+exports.BackgroundTasksStorageD1 = BackgroundTasksStorageD1;
 exports.D1Store = D1Store;
 exports.MemoryStorageD1 = MemoryStorageD1;
 exports.ScoresStorageD1 = ScoresStorageD1;