@mastra/libsql 1.9.1 → 1.10.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @mastra/libsql
 
+## 1.10.0-alpha.1
+
+### Minor Changes
+
+- Extend the schedules storage schema to support owned schedules and richer trigger audit. This is a breaking schema change to `mastra_schedules` and `mastra_schedule_triggers`; scheduled workflows are still in alpha so no compat shim is provided. ([#16166](https://github.com/mastra-ai/mastra/pull/16166))
+  - `Schedule` gains optional `ownerType` / `ownerId` so a schedule row can be attributed to an owning subsystem (e.g. an agent that owns a heartbeat schedule). Workflow schedules leave both fields unset.
+  - `ScheduleTrigger.status` is renamed to `outcome` and the type is widened to `ScheduleTriggerOutcome` so future outcome values can be added without another rename.
+  - `ScheduleTrigger` gains a stable `id` primary key and new `triggerKind`, `parentTriggerId`, and `metadata` fields. `triggerKind` distinguishes `schedule-fire` rows from later `queue-drain` rows (used by upcoming heartbeat work); `parentTriggerId` links related rows; `metadata` carries outcome-specific context.
+  - The libsql, pg, and mongodb adapters all add the new columns/indexes. Their `@mastra/core` peer dependency is tightened to `>=1.32.0-0 <2.0.0-0` so installing a new storage adapter against an older core (or vice-versa) surfaces a peer-dependency warning at install time instead of silently writing/reading the wrong field.
+  - Scheduler producer, server schemas/handler, and client SDK types are updated to use the new fields. The `triggers` response on `GET /api/schedules/:id/triggers` now returns `outcome` instead of `status`.
+  - The bundled Studio (Mastra CLI) is updated to read `outcome` so the schedule detail page keeps polling and rendering publish-failure rows correctly.
+
+### Patch Changes
+
+- Updated dependencies [[`ca28c23`](https://github.com/mastra-ai/mastra/commit/ca28c232a2f18801a6cf20fe053479237b4d4fb0)]:
+  - @mastra/core@1.32.0-alpha.3
+
+## 1.10.0-alpha.0
+
+### Minor Changes
+
+- Added the `schedules` storage domain so LibSQL-backed Mastra apps can use scheduled workflows. Creates `mastra_schedules` and `mastra_schedule_triggers` tables on init. ([#15830](https://github.com/mastra-ai/mastra/pull/15830))
+
+### Patch Changes
+
+- Updated dependencies [[`c05c9a1`](https://github.com/mastra-ai/mastra/commit/c05c9a13230988cef6d438a62f37760f31927bc7), [`e24aacb`](https://github.com/mastra-ai/mastra/commit/e24aacba07bd66f5d95b636dc24016fca26b52cf), [`c721164`](https://github.com/mastra-ai/mastra/commit/c7211643f7ac861f83b19a3757cc921487fc9d75), [`1b55954`](https://github.com/mastra-ai/mastra/commit/1b559541c1e08a10e49d01ffc51a634dfc37a286), [`5adc55e`](https://github.com/mastra-ai/mastra/commit/5adc55e63407be8ee977914957d68bcc2a075ceb), [`70017d7`](https://github.com/mastra-ai/mastra/commit/70017d72ab741b5d7040e2a15c251a317782e39e), [`e4942bc`](https://github.com/mastra-ai/mastra/commit/e4942bc7fdc903572f7d84f26d5e15f9d39c763d)]:
+  - @mastra/core@1.32.0-alpha.1
+
 ## 1.9.1
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-libsql
 description: Documentation for @mastra/libsql. Use when working with @mastra/libsql APIs, configuration, or implementation.
 metadata:
   package: "@mastra/libsql"
-  version: "1.9.1"
+  version: "1.10.0-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.9.1",
+  "version": "1.10.0-alpha.1",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -8896,6 +8896,271 @@ var PromptBlocksLibSQL = class extends storage.PromptBlocksStorage {
     };
   }
 };
+function parseJson2(val) {
+  if (val == null) return void 0;
+  if (typeof val === "string") {
+    try {
+      return JSON.parse(val);
+    } catch {
+      return val;
+    }
+  }
+  return val;
+}
+function toNumber(val) {
+  if (typeof val === "bigint") return Number(val);
+  return Number(val);
+}
+function rowToSchedule(row) {
+  const target = parseJson2(row.target);
+  if (!target) {
+    throw new Error(`Schedule row ${row.id} has invalid target`);
+  }
+  const schedule = {
+    id: String(row.id),
+    target,
+    cron: String(row.cron),
+    status: String(row.status),
+    nextFireAt: toNumber(row.next_fire_at),
+    createdAt: toNumber(row.created_at),
+    updatedAt: toNumber(row.updated_at)
+  };
+  if (row.timezone != null) schedule.timezone = String(row.timezone);
+  if (row.last_fire_at != null) schedule.lastFireAt = toNumber(row.last_fire_at);
+  if (row.last_run_id != null) schedule.lastRunId = String(row.last_run_id);
+  const metadata = parseJson2(row.metadata);
+  if (metadata !== void 0) schedule.metadata = metadata;
+  if (row.owner_type != null) schedule.ownerType = String(row.owner_type);
+  if (row.owner_id != null) schedule.ownerId = String(row.owner_id);
+  return schedule;
+}
+function rowToTrigger(row) {
+  const trigger = {
+    id: row.id != null ? String(row.id) : void 0,
+    scheduleId: String(row.schedule_id),
+    runId: row.run_id != null ? String(row.run_id) : null,
+    scheduledFireAt: toNumber(row.scheduled_fire_at),
+    actualFireAt: toNumber(row.actual_fire_at),
+    outcome: String(row.outcome),
+    triggerKind: row.trigger_kind != null ? String(row.trigger_kind) : "schedule-fire"
+  };
+  if (row.error != null) trigger.error = String(row.error);
+  if (row.parent_trigger_id != null) trigger.parentTriggerId = String(row.parent_trigger_id);
+  const metadata = parseJson2(row.metadata);
+  if (metadata !== void 0) trigger.metadata = metadata;
+  return trigger;
+}
+var SchedulesLibSQL = class extends storage.SchedulesStorage {
+  #db;
+  #client;
+  constructor(config) {
+    super();
+    const client = resolveClient(config);
+    this.#client = client;
+    this.#db = new LibSQLDB({ client, maxRetries: config.maxRetries, initialBackoffMs: config.initialBackoffMs });
+  }
+  async init() {
+    await this.#db.createTable({
+      tableName: storage.TABLE_SCHEDULES,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_SCHEDULES]
+    });
+    await this.#db.createTable({
+      tableName: storage.TABLE_SCHEDULE_TRIGGERS,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_SCHEDULE_TRIGGERS]
+    });
+  }
+  async dangerouslyClearAll() {
+    await this.#db.deleteData({ tableName: storage.TABLE_SCHEDULE_TRIGGERS });
+    await this.#db.deleteData({ tableName: storage.TABLE_SCHEDULES });
+  }
+  async createSchedule(schedule) {
+    const existing = await this.getSchedule(schedule.id);
+    if (existing) {
+      throw new Error(`Schedule with id "${schedule.id}" already exists`);
+    }
+    await this.#db.insert({
+      tableName: storage.TABLE_SCHEDULES,
+      record: {
+        id: schedule.id,
+        target: schedule.target,
+        cron: schedule.cron,
+        timezone: schedule.timezone ?? null,
+        status: schedule.status,
+        next_fire_at: schedule.nextFireAt,
+        last_fire_at: schedule.lastFireAt ?? null,
+        last_run_id: schedule.lastRunId ?? null,
+        created_at: schedule.createdAt,
+        updated_at: schedule.updatedAt,
+        metadata: schedule.metadata ?? null,
+        owner_type: schedule.ownerType ?? null,
+        owner_id: schedule.ownerId ?? null
+      }
+    });
+    return schedule;
+  }
+  async getSchedule(id) {
+    const result = await this.#client.execute({
+      sql: `SELECT ${buildSelectColumns(storage.TABLE_SCHEDULES)} FROM ${storage.TABLE_SCHEDULES} WHERE id = ?`,
+      args: [id]
+    });
+    const row = result.rows[0];
+    return row ? rowToSchedule(row) : null;
+  }
+  async listSchedules(filter) {
+    const conditions = [];
+    const params = [];
+    if (filter?.status) {
+      conditions.push("status = ?");
+      params.push(filter.status);
+    }
+    if (filter?.workflowId) {
+      conditions.push("json_extract(target, '$.workflowId') = ?");
+      params.push(filter.workflowId);
+    }
+    if (filter?.ownerType !== void 0) {
+      if (filter.ownerType === null) {
+        conditions.push("owner_type IS NULL");
+      } else {
+        conditions.push("owner_type = ?");
+        params.push(filter.ownerType);
+      }
+    }
+    if (filter?.ownerId !== void 0) {
+      if (filter.ownerId === null) {
+        conditions.push("owner_id IS NULL");
+      } else {
+        conditions.push("owner_id = ?");
+        params.push(filter.ownerId);
+      }
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = await this.#client.execute({
+      sql: `SELECT ${buildSelectColumns(storage.TABLE_SCHEDULES)} FROM ${storage.TABLE_SCHEDULES} ${where} ORDER BY created_at ASC`,
+      args: params
+    });
+    return result.rows.map((r) => rowToSchedule(r));
+  }
+  async listDueSchedules(now, limit) {
+    const cap = limit ?? 100;
+    const result = await this.#client.execute({
+      sql: `SELECT ${buildSelectColumns(storage.TABLE_SCHEDULES)} FROM ${storage.TABLE_SCHEDULES}
+            WHERE status = ? AND next_fire_at <= ?
+            ORDER BY next_fire_at ASC
+            LIMIT ?`,
+      args: ["active", now, cap]
+    });
+    return result.rows.map((r) => rowToSchedule(r));
+  }
+  async updateSchedule(id, patch) {
+    const setClauses = [];
+    const params = [];
+    if ("cron" in patch && patch.cron !== void 0) {
+      setClauses.push("cron = ?");
+      params.push(patch.cron);
+    }
+    if ("timezone" in patch) {
+      setClauses.push("timezone = ?");
+      params.push(patch.timezone ?? null);
+    }
+    if ("status" in patch && patch.status !== void 0) {
+      setClauses.push("status = ?");
+      params.push(patch.status);
+    }
+    if ("nextFireAt" in patch && patch.nextFireAt !== void 0) {
+      setClauses.push("next_fire_at = ?");
+      params.push(patch.nextFireAt);
+    }
+    if ("target" in patch && patch.target !== void 0) {
+      setClauses.push("target = jsonb(?)");
+      params.push(JSON.stringify(patch.target));
+    }
+    if ("metadata" in patch) {
+      setClauses.push("metadata = jsonb(?)");
+      params.push(patch.metadata != null ? JSON.stringify(patch.metadata) : null);
+    }
+    if ("ownerType" in patch) {
+      setClauses.push("owner_type = ?");
+      params.push(patch.ownerType ?? null);
+    }
+    if ("ownerId" in patch) {
+      setClauses.push("owner_id = ?");
+      params.push(patch.ownerId ?? null);
+    }
+    setClauses.push("updated_at = ?");
+    params.push(Date.now());
+    params.push(id);
+    if (setClauses.length === 1) {
+      const existing = await this.getSchedule(id);
+      if (!existing) throw new Error(`Schedule ${id} not found`);
+      return existing;
+    }
+    await this.#client.execute({
+      sql: `UPDATE ${storage.TABLE_SCHEDULES} SET ${setClauses.join(", ")} WHERE id = ?`,
+      args: params
+    });
+    const updated = await this.getSchedule(id);
+    if (!updated) throw new Error(`Schedule ${id} not found`);
+    return updated;
+  }
+  async updateScheduleNextFire(id, expectedNextFireAt, newNextFireAt, lastFireAt, lastRunId) {
+    const result = await this.#client.execute({
+      sql: `UPDATE ${storage.TABLE_SCHEDULES}
+            SET next_fire_at = ?, last_fire_at = ?, last_run_id = ?, updated_at = ?
+            WHERE id = ? AND next_fire_at = ? AND status = ?`,
+      args: [newNextFireAt, lastFireAt, lastRunId, Date.now(), id, expectedNextFireAt, "active"]
+    });
+    return (result.rowsAffected ?? 0) > 0;
+  }
+  async deleteSchedule(id) {
+    await this.#client.execute({
+      sql: `DELETE FROM ${storage.TABLE_SCHEDULE_TRIGGERS} WHERE schedule_id = ?`,
+      args: [id]
+    });
+    await this.#client.execute({
+      sql: `DELETE FROM ${storage.TABLE_SCHEDULES} WHERE id = ?`,
+      args: [id]
+    });
+  }
+  async recordTrigger(trigger) {
+    const id = trigger.id ?? crypto.randomUUID();
+    await this.#db.insert({
+      tableName: storage.TABLE_SCHEDULE_TRIGGERS,
+      record: {
+        id,
+        schedule_id: trigger.scheduleId,
+        run_id: trigger.runId,
+        scheduled_fire_at: trigger.scheduledFireAt,
+        actual_fire_at: trigger.actualFireAt,
+        outcome: trigger.outcome,
+        error: trigger.error ?? null,
+        trigger_kind: trigger.triggerKind ?? "schedule-fire",
+        parent_trigger_id: trigger.parentTriggerId ?? null,
+        metadata: trigger.metadata ?? null
+      }
+    });
+  }
+  async listTriggers(scheduleId, opts) {
+    const conditions = ["schedule_id = ?"];
+    const params = [scheduleId];
+    if (opts?.fromActualFireAt != null) {
+      conditions.push("actual_fire_at >= ?");
+      params.push(opts.fromActualFireAt);
+    }
+    if (opts?.toActualFireAt != null) {
+      conditions.push("actual_fire_at < ?");
+      params.push(opts.toActualFireAt);
+    }
+    const limitClause = opts?.limit != null ? `LIMIT ${Math.floor(opts.limit)}` : "";
+    const result = await this.#client.execute({
+      sql: `SELECT ${buildSelectColumns(storage.TABLE_SCHEDULE_TRIGGERS)} FROM ${storage.TABLE_SCHEDULE_TRIGGERS}
+            WHERE ${conditions.join(" AND ")}
+            ORDER BY actual_fire_at DESC
+            ${limitClause}`,
+      args: params
+    });
+    return result.rows.map((r) => rowToTrigger(r));
+  }
+};
 var ScorerDefinitionsLibSQL = class extends storage.ScorerDefinitionsStorage {
   #db;
   #client;
@@ -11127,6 +11392,7 @@ var LibSQLStore = class extends storage.MastraCompositeStore {
     const skills = new SkillsLibSQL(domainConfig);
     const blobs = new BlobsLibSQL(domainConfig);
     const backgroundTasks = new BackgroundTasksLibSQL(domainConfig);
+    const schedules = new SchedulesLibSQL(domainConfig);
     this.stores = {
       scores,
       workflows,
@@ -11143,7 +11409,8 @@ var LibSQLStore = class extends storage.MastraCompositeStore {
       workspaces,
       skills,
       blobs,
-      backgroundTasks
+      backgroundTasks,
+      schedules
     };
   }
 };
@@ -11262,6 +11529,7 @@ exports.MCPServersLibSQL = MCPServersLibSQL;
 exports.MemoryLibSQL = MemoryLibSQL;
 exports.ObservabilityLibSQL = ObservabilityLibSQL;
 exports.PromptBlocksLibSQL = PromptBlocksLibSQL;
+exports.SchedulesLibSQL = SchedulesLibSQL;
 exports.ScorerDefinitionsLibSQL = ScorerDefinitionsLibSQL;
 exports.ScoresLibSQL = ScoresLibSQL;
 exports.SkillsLibSQL = SkillsLibSQL;