@mastra/client-js 1.31.2-alpha.5 → 1.32.0-alpha.10

package/dist/index.js

@@ -2503,6 +2503,38 @@ var Agent = class extends BaseResource {
     };
     return streamResponse;
   }
+  /**
+   * Re-drives an orphaned RUNNING durable-agent run after a process restart.
+   *
+   * Only supported when the target agent is a durable agent (createDurableAgent).
+   * The server rebuilds the runtime state from the persisted snapshot, replays
+   * past chunks, and continues the loop to completion.
+   */
+  async recover(params) {
+    const body = {
+      runId: params.runId,
+      requestContext: parseClientRequestContext(params.requestContext),
+      versions: params.versions
+    };
+    const response = await this.request(`/agents/${this.agentId}/recover`, {
+      method: "POST",
+      body,
+      stream: true
+    });
+    if (!response.body) {
+      throw new Error("No response body");
+    }
+    const streamResponse = response;
+    streamResponse.processDataStream = async ({
+      onChunk
+    }) => {
+      await processMastraStream({
+        stream: streamResponse.body,
+        onChunk
+      });
+    };
+    return streamResponse;
+  }
   /**
    * @deprecated Use `resumeStream(resumeData, { untilIdle: true, ... })` instead.
    *
@@ -6108,16 +6140,24 @@ var Channels = class extends BaseResource {
 
 // src/resources/agent-controller.ts
 var AgentControllerSession = class extends BaseResource {
-  constructor(options, controllerId, resourceId) {
+  constructor(options, controllerId, resourceId, scope) {
     super(options);
     this.controllerId = controllerId;
     this.resourceId = resourceId;
+    this.scope = scope;
   }
   controllerId;
   resourceId;
+  scope;
   base() {
     return `/agent-controller/${encodeURIComponent(this.controllerId)}/sessions/${encodeURIComponent(this.resourceId)}`;
   }
+  /** Append this session's scope (if any) as a `sessionScope` query param. */
+  url(path) {
+    if (this.scope === void 0) return path;
+    const sep = path.includes("?") ? "&" : "?";
+    return `${path}${sep}sessionScope=${encodeURIComponent(this.scope)}`;
+  }
   /**
    * Create or resume this session. Pass `tags` to scope initial thread
    * selection — a thread is a resume candidate only when its metadata matches
@@ -6128,7 +6168,7 @@ var AgentControllerSession = class extends BaseResource {
   create(options) {
     return this.request(`/agent-controller/${encodeURIComponent(this.controllerId)}/sessions`, {
       method: "POST",
-      body: { resourceId: this.resourceId, tags: options?.tags }
+      body: { resourceId: this.resourceId, tags: options?.tags, sessionScope: this.scope }
     });
   }
   /**
@@ -6136,7 +6176,7 @@ var AgentControllerSession = class extends BaseResource {
    * message arrives here as `message_*` events, not on the sendMessage call.
    */
   async subscribe(options) {
-    const response = await this.request(`${this.base()}/stream`, { stream: true });
+    const response = await this.request(this.url(`${this.base()}/stream`), { stream: true });
     if (!response.body) {
       throw new Error("No response body for agent controller session stream");
     }
@@ -6178,17 +6218,25 @@ var AgentControllerSession = class extends BaseResource {
       }
     };
   }
-  /** Send a user message. The reply streams over `subscribe()`. */
+  /**
+   * Send a user message. The reply streams over `subscribe()`.
+   * Pass a structured message to attach files (e.g. pasted images) as base64-encoded data:
+   * `sendMessage({ content: 'What is in this image?', files })`.
+   */
   async sendMessage(message) {
-    await this.request(`${this.base()}/messages`, { method: "POST", body: { message } });
+    const { content, files } = typeof message === "string" ? { content: message, files: void 0 } : message;
+    await this.request(this.url(`${this.base()}/messages`), {
+      method: "POST",
+      body: { message: content, ...files?.length ? { files } : {} }
+    });
   }
   /** Abort the in-flight run for this session. */
   async abort() {
-    await this.request(`${this.base()}/abort`, { method: "POST" });
+    await this.request(this.url(`${this.base()}/abort`), { method: "POST" });
   }
   /** Approve or decline a pending tool call (`tool_approval_required`). */
   async approveTool(toolCallId, approved) {
-    await this.request(`${this.base()}/tool-approval`, {
+    await this.request(this.url(`${this.base()}/tool-approval`), {
       method: "POST",
       body: { toolCallId, approved }
     });
@@ -6199,35 +6247,34 @@ var AgentControllerSession = class extends BaseResource {
    * `request_access`, and a {@link PlanResume} for `submit_plan`.
    */
   async respondToToolSuspension(toolCallId, resumeData) {
-    await this.request(`${this.base()}/tool-suspension`, {
+    await this.request(this.url(`${this.base()}/tool-suspension`), {
       method: "POST",
       body: { toolCallId, resumeData }
     });
   }
   /** Inject a message into the in-flight run without starting a new turn. */
   async steer(message) {
-    await this.request(`${this.base()}/steer`, { method: "POST", body: { message } });
+    await this.request(this.url(`${this.base()}/steer`), { method: "POST", body: { message } });
   }
   /** Get the current mode, model, and thread (for initial UI hydration). */
   state() {
-    return this.request(this.base());
+    return this.request(this.url(this.base()));
   }
   /** Merge key-value pairs into the session state. Existing keys not in the payload are preserved. */
   async setState(updates) {
-    await this.request(`${this.base()}/state`, { method: "PUT", body: { state: updates } });
+    await this.request(this.url(`${this.base()}/state`), { method: "PUT", body: { state: updates } });
   }
   /** Switch the active mode (e.g. `build`, `plan`). */
   async switchMode(modeId) {
-    await this.request(`${this.base()}/mode`, { method: "POST", body: { modeId } });
+    await this.request(this.url(`${this.base()}/mode`), { method: "POST", body: { modeId } });
   }
   /** Switch the model. Defaults to thread scope. */
   async switchModel(modelId, options) {
-    await this.request(`${this.base()}/model`, {
+    await this.request(this.url(`${this.base()}/model`), {
       method: "POST",
       body: { modelId, scope: options?.scope, modeId: options?.modeId }
     });
   }
-  /** List the threads for this session's resource, most-recently-updated first. Pass `limit` for just the newest N. */
   /**
    * List the session's threads, newest first. Pass `limit` to cap the count
    * (e.g. for a sidebar) and `tags` to scope to threads matching every tag —
@@ -6241,36 +6288,38 @@ var AgentControllerSession = class extends BaseResource {
     if (opts.limit != null) params.set("limit", String(opts.limit));
     if (opts.tags && Object.keys(opts.tags).length > 0) params.set("tags", JSON.stringify(opts.tags));
     const query = params.toString() ? `?${params.toString()}` : "";
-    const body = await this.request(`${this.base()}/threads${query}`);
+    const body = await this.request(
+      this.url(`${this.base()}/threads${query}`)
+    );
     return body.threads;
   }
   /** Switch the session to an existing thread (rebinds stream + state). */
   async switchThread(threadId) {
-    await this.request(`${this.base()}/thread`, { method: "POST", body: { threadId } });
+    await this.request(this.url(`${this.base()}/thread`), { method: "POST", body: { threadId } });
   }
   /** Create a new thread (unbinds previous, binds the new one). */
   async createThread(title) {
-    return this.request(`${this.base()}/threads`, {
+    return this.request(this.url(`${this.base()}/threads`), {
       method: "POST",
       body: { title }
     });
   }
   /** Delete a thread. If it's the active thread the session unbinds. */
   async deleteThread(threadId) {
-    await this.request(`${this.base()}/threads/${encodeURIComponent(threadId)}`, {
+    await this.request(this.url(`${this.base()}/threads/${encodeURIComponent(threadId)}`), {
       method: "DELETE"
     });
   }
   /** Rename a thread. */
   async renameThread(threadId, title) {
-    await this.request(`${this.base()}/threads/${encodeURIComponent(threadId)}`, {
+    await this.request(this.url(`${this.base()}/threads/${encodeURIComponent(threadId)}`), {
       method: "PUT",
       body: { title }
     });
   }
   /** Clone a thread (and its messages). The session binds to the clone. */
   async cloneThread(options) {
-    return this.request(`${this.base()}/threads/clone`, {
+    return this.request(this.url(`${this.base()}/threads/clone`), {
       method: "POST",
       body: options ?? {}
     });
@@ -6279,7 +6328,7 @@ var AgentControllerSession = class extends BaseResource {
   async listMessages(threadId, limit) {
     const params = limit != null ? `?limit=${limit}` : "";
     const body = await this.request(
-      `${this.base()}/threads/${encodeURIComponent(threadId)}/messages${params}`
+      this.url(`${this.base()}/threads/${encodeURIComponent(threadId)}/messages${params}`)
     );
     return body.messages;
   }
@@ -6288,33 +6337,33 @@ var AgentControllerSession = class extends BaseResource {
    * if a run is active it queues for after completion.
    */
   async followUp(message) {
-    await this.request(`${this.base()}/follow-up`, { method: "POST", body: { message } });
+    await this.request(this.url(`${this.base()}/follow-up`), { method: "POST", body: { message } });
   }
   /** Get the observational memory record for this session's thread. */
   async getOMRecord() {
-    const body = await this.request(`${this.base()}/om`);
+    const body = await this.request(this.url(`${this.base()}/om`));
     return body.record;
   }
   /** Change the session's resource identity. */
   async setResourceId(newResourceId) {
-    await this.request(`${this.base()}/resource`, {
+    await this.request(this.url(`${this.base()}/resource`), {
       method: "POST",
       body: { newResourceId }
     });
   }
   /** Get known resource IDs for this session. */
   async getResourceIds() {
-    const body = await this.request(`${this.base()}/resources`);
+    const body = await this.request(this.url(`${this.base()}/resources`));
     return body.resourceIds;
   }
   /** Get the current goal for this session's thread. */
   async getGoal() {
-    const body = await this.request(`${this.base()}/goal`);
+    const body = await this.request(this.url(`${this.base()}/goal`));
     return body.goal;
   }
   /** Set a new goal objective. The agent's in-loop judge evaluates progress after each turn. */
   async setGoal(objective, options) {
-    const body = await this.request(`${this.base()}/goal`, {
+    const body = await this.request(this.url(`${this.base()}/goal`), {
       method: "POST",
       body: { objective, ...options }
     });
@@ -6322,7 +6371,7 @@ var AgentControllerSession = class extends BaseResource {
   }
   /** Update goal options (judge model, max runs, status). */
   async updateGoal(options) {
-    const body = await this.request(`${this.base()}/goal`, {
+    const body = await this.request(this.url(`${this.base()}/goal`), {
       method: "PUT",
       body: options
     });
@@ -6330,25 +6379,25 @@ var AgentControllerSession = class extends BaseResource {
   }
   /** Clear the current goal. */
   async clearGoal() {
-    await this.request(`${this.base()}/goal`, { method: "DELETE" });
+    await this.request(this.url(`${this.base()}/goal`), { method: "DELETE" });
   }
   // ---------------------------------------------------------------------------
   // Permissions
   // ---------------------------------------------------------------------------
   /** Get the current permission rules (per-category and per-tool policies). */
   async getPermissions() {
-    return this.request(`${this.base()}/permissions`);
+    return this.request(this.url(`${this.base()}/permissions`));
   }
   /** Set the approval policy for a tool category. */
   async setPermissionForCategory(category, policy) {
-    await this.request(`${this.base()}/permissions/category`, {
+    await this.request(this.url(`${this.base()}/permissions/category`), {
       method: "PUT",
       body: { category, policy }
     });
   }
   /** Set the approval policy for a specific tool. */
   async setPermissionForTool(toolName, policy) {
-    await this.request(`${this.base()}/permissions/tool`, {
+    await this.request(this.url(`${this.base()}/permissions/tool`), {
       method: "PUT",
       body: { toolName, policy }
     });
@@ -6359,7 +6408,7 @@ var AgentControllerSession = class extends BaseResource {
    * or is persisted for later.
    */
   async sendNotification(input) {
-    return this.request(`${this.base()}/notifications`, {
+    return this.request(this.url(`${this.base()}/notifications`), {
       method: "POST",
       body: input
     });
@@ -6388,9 +6437,13 @@ var AgentController = class extends BaseResource {
   async workspaceStatus() {
     return this.request(`${this.basePath()}/workspace`);
   }
-  /** Scope to a session bound to `resourceId` (e.g. a user or conversation id). */
-  session(resourceId) {
-    return new AgentControllerSession(this.options, this.controllerId, resourceId);
+  /**
+   * Scope to a session bound to `resourceId` (e.g. a user or conversation id).
+   * Pass `scope` to address an independent session over the same resourceId
+   * (e.g. one session per git worktree, with the worktree path as the scope).
+   */
+  session(resourceId, scope) {
+    return new AgentControllerSession(this.options, this.controllerId, resourceId, scope);
   }
 };
 function agentControllerMessageText(message) {