@mastra/client-js 1.28.1-alpha.4 → 1.29.0-alpha.10

package/dist/index.js

@@ -2333,6 +2333,26 @@ var Agent = class extends BaseResource {
     };
     return streamResponse;
   }
+  /**
+   * Lists suspended runs for this agent from storage — runs waiting on a
+   * tool-call approval or on a tool that suspended. Backed by storage, so it
+   * works after a server restart and across server instances. Pass the
+   * returned runId to approveToolCall(), declineToolCall(), or resumeStream().
+   * @param params - Optional filters (threadId, resourceId, fromDate, toDate) and pagination (perPage, page)
+   * @param requestContext - Optional request context
+   * @returns Promise containing the matching runs and the total count before pagination
+   */
+  async listSuspendedRuns(params, requestContext) {
+    const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
+    if (params?.threadId) searchParams.set("threadId", params.threadId);
+    if (params?.resourceId) searchParams.set("resourceId", params.resourceId);
+    if (params?.fromDate) searchParams.set("fromDate", params.fromDate.toISOString());
+    if (params?.toDate) searchParams.set("toDate", params.toDate.toISOString());
+    if (params?.perPage !== void 0) searchParams.set("perPage", String(params.perPage));
+    if (params?.page !== void 0) searchParams.set("page", String(params.page));
+    const query = searchParams.size ? `?${searchParams}` : "";
+    return this.request(`/agents/${this.agentId}/suspended-runs${query}`);
+  }
   async approveToolCall(params) {
     const { requestContext, ...rest } = params;
     const processedParams = { ...rest, requestContext: parseClientRequestContext(requestContext) };
@@ -6704,10 +6724,10 @@ var MastraClient = class extends BaseResource {
     if (logLevel) {
       searchParams.set("logLevel", logLevel);
     }
-    if (page) {
+    if (page !== void 0) {
       searchParams.set("page", String(page));
     }
-    if (perPage) {
+    if (perPage !== void 0) {
       searchParams.set("perPage", String(perPage));
     }
     if (_filters) {
@@ -6749,10 +6769,10 @@ var MastraClient = class extends BaseResource {
     if (logLevel) {
       searchParams.set("logLevel", logLevel);
     }
-    if (page) {
+    if (page !== void 0) {
       searchParams.set("page", String(page));
     }
-    if (perPage) {
+    if (perPage !== void 0) {
       searchParams.set("perPage", String(perPage));
     }
     if (_filters) {
@@ -7994,12 +8014,14 @@ var MastraClient = class extends BaseResource {
     );
   }
   /**
-   * Lists workflow schedules with optional filtering by workflowId or status.
+   * Lists schedules with optional filtering by workflowId, status, ownerType, or ownerId.
    */
   listSchedules(params = {}) {
     const searchParams = new URLSearchParams();
     if (params.workflowId) searchParams.set("workflowId", params.workflowId);
     if (params.status) searchParams.set("status", params.status);
+    if (params.ownerType) searchParams.set("ownerType", params.ownerType);
+    if (params.ownerId) searchParams.set("ownerId", params.ownerId);
     const qs = searchParams.toString();
     return this.request(`/schedules${qs ? `?${qs}` : ""}`);
   }
@@ -8036,6 +8058,90 @@ var MastraClient = class extends BaseResource {
   resumeSchedule(scheduleId) {
     return this.request(`/schedules/${encodeURIComponent(scheduleId)}/resume`, { method: "POST" });
   }
+  /**
+   * Lists heartbeats across all agents. Pass `agentId` to scope the list to
+   * a single agent. Filter further by `threadId`, `resourceId`, or `name`.
+   */
+  listHeartbeats(params = {}) {
+    const searchParams = new URLSearchParams();
+    if (params.agentId) searchParams.set("agentId", params.agentId);
+    if (params.threadId) searchParams.set("threadId", params.threadId);
+    if (params.resourceId) searchParams.set("resourceId", params.resourceId);
+    if (params.name) searchParams.set("name", params.name);
+    const qs = searchParams.toString();
+    return this.request(`/heartbeats${qs ? `?${qs}` : ""}`).then(
+      (response) => response.heartbeats
+    );
+  }
+  /**
+   * Gets a single heartbeat by id.
+   */
+  getHeartbeat(heartbeatId) {
+    return this.request(`/heartbeats/${encodeURIComponent(heartbeatId)}`);
+  }
+  /**
+   * Creates a heartbeat for the agent named by `agentId`. By default each call
+   * creates a new heartbeat with a random `hb_<uuid>` id — multiple heartbeats
+   * per agent/thread are supported. Use `name` to label distinct heartbeats.
+   * Pass `id` to choose a stable id (normalized to `hb_<slug>`); creating one
+   * with an id that already exists throws.
+   *
+   * Trigger (fire) history is read through the generic schedules surface:
+   * `listScheduleTriggers(heartbeat.id)`.
+   */
+  createHeartbeat(options) {
+    return this.request(`/heartbeats`, {
+      method: "POST",
+      body: options
+    });
+  }
+  /**
+   * Patches an existing heartbeat. `threadId` / `resourceId` are immutable —
+   * to retarget, delete and recreate.
+   */
+  updateHeartbeat(heartbeatId, patch) {
+    return this.request(`/heartbeats/${encodeURIComponent(heartbeatId)}`, {
+      method: "PATCH",
+      body: patch
+    });
+  }
+  /**
+   * Deletes a heartbeat.
+   */
+  deleteHeartbeat(heartbeatId) {
+    return this.request(`/heartbeats/${encodeURIComponent(heartbeatId)}`, {
+      method: "DELETE"
+    });
+  }
+  /**
+   * Pauses a heartbeat. Idempotent — pausing an already-paused heartbeat
+   * returns the current state unchanged.
+   */
+  pauseHeartbeat(heartbeatId) {
+    return this.request(`/heartbeats/${encodeURIComponent(heartbeatId)}/pause`, {
+      method: "POST"
+    });
+  }
+  /**
+   * Resumes a paused heartbeat. Recomputes nextFireAt from "now" so a
+   * long-paused heartbeat does not fire a backlog. Idempotent.
+   */
+  resumeHeartbeat(heartbeatId) {
+    return this.request(`/heartbeats/${encodeURIComponent(heartbeatId)}/resume`, {
+      method: "POST"
+    });
+  }
+  /**
+   * Fires a heartbeat manually, out-of-band from the cron schedule. Behaves
+   * like a scheduled fire (honoring `ifActive` / `ifIdle`) but
+   * does not advance `nextFireAt`. The returned `claimId` is the trigger row's
+   * runId — look it up via `listScheduleTriggers(heartbeatId)`.
+   */
+  runHeartbeat(heartbeatId) {
+    return this.request(`/heartbeats/${encodeURIComponent(heartbeatId)}/run`, {
+      method: "POST"
+    });
+  }
 };
 
 // src/tools.ts