@mastra/lance 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/lance
 
+## 1.0.5
+
+### 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.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

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.4",
+  "version": "1.0.5",
   "package": "@mastra/lance",
   "exports": {},
   "modules": {}

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

@@ -2,7 +2,7 @@
 
 The LanceDB storage implementation provides a high-performance storage solution using the LanceDB database system, which excels at handling both traditional data storage and vector operations.
 
-> **Observability Not Supported:** LanceDB storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to LanceDB, and Mastra Studio's observability features won't work with LanceDB 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:** LanceDB storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to LanceDB, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with LanceDB 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.
 
 ## Installation
 

package/dist/index.cjs

@@ -3,9 +3,9 @@
 var lancedb = require('@lancedb/lancedb');
 var error = require('@mastra/core/error');
 var storage = require('@mastra/core/storage');
-var agent = require('@mastra/core/agent');
 var base = require('@mastra/core/base');
 var apacheArrow = require('apache-arrow');
+var agent = require('@mastra/core/agent');
 var evals = require('@mastra/core/evals');
 var vector = require('@mastra/core/vector');
 var filter = require('@mastra/core/vector/filter');
@@ -589,7 +589,188 @@ var LanceDB = 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 toRecord(task) {
+  return {
+    id: task.id,
+    tool_call_id: task.toolCallId,
+    tool_name: task.toolName,
+    agent_id: task.agentId,
+    thread_id: task.threadId ?? "",
+    resource_id: task.resourceId ?? "",
+    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,
+    startedAt: task.startedAt ?? /* @__PURE__ */ new Date(0),
+    completedAt: task.completedAt ?? /* @__PURE__ */ new Date(0)
+  };
+}
+function fromRecord(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;
+  };
+  const startedAt = row.startedAt instanceof Date ? row.startedAt : row.startedAt ? new Date(row.startedAt) : void 0;
+  const completedAt = row.completedAt instanceof Date ? row.completedAt : row.completedAt ? new Date(row.completedAt) : void 0;
+  return {
+    id: String(row.id),
+    status: String(row.status),
+    toolName: String(row.tool_name),
+    toolCallId: String(row.tool_call_id),
+    args: parseJson(row.args) ?? {},
+    agentId: String(row.agent_id),
+    threadId: row.thread_id && row.thread_id !== "" ? String(row.thread_id) : void 0,
+    resourceId: row.resource_id && row.resource_id !== "" ? String(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: row.createdAt instanceof Date ? row.createdAt : new Date(row.createdAt),
+    startedAt: startedAt && startedAt.getTime() > 0 ? startedAt : void 0,
+    completedAt: completedAt && completedAt.getTime() > 0 ? completedAt : void 0
+  };
+}
+function escapeStr(val) {
+  return val.replace(/'/g, "''");
+}
+var StoreBackgroundTasksLance = class extends storage.BackgroundTasksStorage {
+  client;
+  #db;
+  constructor(config) {
+    super();
+    const client = resolveLanceConfig(config);
+    this.client = client;
+    this.#db = new LanceDB({ client });
+  }
+  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 table = await this.client.openTable(storage.TABLE_BACKGROUND_TASKS);
+    await table.add([toRecord(task)], { mode: "append" });
+  }
+  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;
+    const table = await this.client.openTable(storage.TABLE_BACKGROUND_TASKS);
+    await table.delete(`id = '${escapeStr(taskId)}'`);
+    await table.add([toRecord(merged)], { mode: "append" });
+  }
+  async getTask(taskId) {
+    try {
+      const table = await this.client.openTable(storage.TABLE_BACKGROUND_TASKS);
+      const records = await table.query().where(`id = '${escapeStr(taskId)}'`).limit(1).toArray();
+      if (records.length === 0) return null;
+      return fromRecord(records[0]);
+    } catch {
+      return null;
+    }
+  }
+  async listTasks(filter) {
+    try {
+      const table = await this.client.openTable(storage.TABLE_BACKGROUND_TASKS);
+      const conditions = [];
+      if (filter.status) {
+        const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+        const inList = statuses.map((s) => `'${escapeStr(s)}'`).join(", ");
+        conditions.push(`status IN (${inList})`);
+      }
+      if (filter.agentId) conditions.push(`agent_id = '${escapeStr(filter.agentId)}'`);
+      if (filter.threadId) conditions.push(`thread_id = '${escapeStr(filter.threadId)}'`);
+      if (filter.resourceId) conditions.push(`resource_id = '${escapeStr(filter.resourceId)}'`);
+      if (filter.runId) conditions.push(`run_id = '${escapeStr(filter.runId)}'`);
+      if (filter.toolName) conditions.push(`tool_name = '${escapeStr(filter.toolName)}'`);
+      let query = table.query();
+      if (conditions.length > 0) {
+        query = query.where(conditions.join(" AND "));
+      }
+      const records = await query.toArray();
+      let tasks = records.map(fromRecord);
+      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 direction = filter.orderDirection ?? "asc";
+      tasks.sort((a, b) => {
+        const aVal = a[orderBy]?.getTime() ?? 0;
+        const bVal = b[orderBy]?.getTime() ?? 0;
+        return direction === "asc" ? aVal - bVal : bVal - aVal;
+      });
+      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 };
+    } catch {
+      return { tasks: [], total: 0 };
+    }
+  }
+  async deleteTask(taskId) {
+    const table = await this.client.openTable(storage.TABLE_BACKGROUND_TASKS);
+    await table.delete(`id = '${escapeStr(taskId)}'`);
+  }
+  async deleteTasks(filter) {
+    const { tasks } = await this.listTasks(filter);
+    if (tasks.length === 0) return;
+    const table = await this.client.openTable(storage.TABLE_BACKGROUND_TASKS);
+    for (const task of tasks) {
+      await table.delete(`id = '${escapeStr(task.id)}'`);
+    }
+  }
+  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 StoreMemoryLance = class extends storage.MemoryStorage {
   client;
   #db;
@@ -2010,7 +2191,8 @@ var LanceStorage = class _LanceStorage extends storage.MastraCompositeStore {
       instance.stores = {
         workflows: new StoreWorkflowsLance({ client: instance.lanceClient }),
         scores: new StoreScoresLance({ client: instance.lanceClient }),
-        memory: new StoreMemoryLance({ client: instance.lanceClient })
+        memory: new StoreMemoryLance({ client: instance.lanceClient }),
+        backgroundTasks: new StoreBackgroundTasksLance({ client: instance.lanceClient })
       };
       return instance;
     } catch (e) {
@@ -2052,7 +2234,8 @@ var LanceStorage = class _LanceStorage extends storage.MastraCompositeStore {
     instance.stores = {
       workflows: new StoreWorkflowsLance({ client }),
       scores: new StoreScoresLance({ client }),
-      memory: new StoreMemoryLance({ client })
+      memory: new StoreMemoryLance({ client }),
+      backgroundTasks: new StoreBackgroundTasksLance({ client })
     };
     return instance;
   }
@@ -3399,6 +3582,7 @@ var LanceVectorStore = class _LanceVectorStore extends vector.MastraVector {
 
 exports.LanceStorage = LanceStorage;
 exports.LanceVectorStore = LanceVectorStore;
+exports.StoreBackgroundTasksLance = StoreBackgroundTasksLance;
 exports.StoreMemoryLance = StoreMemoryLance;
 exports.StoreScoresLance = StoreScoresLance;
 exports.StoreWorkflowsLance = StoreWorkflowsLance;