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

package/CHANGELOG.md

@@ -1,5 +1,99 @@
 # @mastra/client-js
 
+## 1.32.0-alpha.10
+
+### Patch Changes
+
+- Updated dependencies [[`4adc391`](https://github.com/mastra-ai/mastra/commit/4adc3911075249c352bb4832d2471922826344de), [`171c3a2`](https://github.com/mastra-ai/mastra/commit/171c3a23f36199ad1354166fb515b22b57f310c2), [`b486abf`](https://github.com/mastra-ai/mastra/commit/b486abfa2a7528c6f527e4015c819ea9fa54aaad)]:
+  - @mastra/core@1.51.0-alpha.10
+  - @mastra/schema-compat@1.3.4-alpha.2
+
+## 1.32.0-alpha.9
+
+### Patch Changes
+
+- Updated dependencies [[`edce8d2`](https://github.com/mastra-ai/mastra/commit/edce8d2769f19e27a05737c627af2d765472a4f8)]:
+  - @mastra/core@1.51.0-alpha.9
+
+## 1.32.0-alpha.8
+
+### Minor Changes
+
+- Added image attachment support to agent controller chat. You can now send images (and other files) with a message, and the Mastra Code web chat lets you attach, paste, or drag-and-drop images which render inline in the transcript. ([#19368](https://github.com/mastra-ai/mastra/pull/19368))
+
+  ```ts
+  await session.sendMessage({
+    content: 'What is in this screenshot?',
+    files: [{ data: base64Png, mediaType: 'image/png', filename: 'screenshot.png' }],
+  });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`bd6d240`](https://github.com/mastra-ai/mastra/commit/bd6d2402db93dddaef0721667e7e8a030e7c6e16), [`0111486`](https://github.com/mastra-ai/mastra/commit/01114867612593eef5cfa2fda6a1194dfedda841), [`96a3749`](https://github.com/mastra-ai/mastra/commit/96a37492235f5b8076b3e3177d83ed5a5e44a640), [`3e26c87`](https://github.com/mastra-ai/mastra/commit/3e26c87de0c5bc2583b795ce6ca5889b6b161acb), [`a5008f2`](https://github.com/mastra-ai/mastra/commit/a5008f22ae710ad9402ea9f2547d8c02f74d384b)]:
+  - @mastra/core@1.51.0-alpha.8
+
+## 1.32.0-alpha.7
+
+### Minor Changes
+
+- Added an optional session scope to the agent controller API so clients can address independent sessions that share one resource (for example one session per git worktree). ([#19357](https://github.com/mastra-ai/mastra/pull/19357))
+
+  Session routes now accept a `sessionScope` query parameter, and `AgentController.session()` in the client accepts a scope that travels on every request:
+
+  ```ts
+  const controller = client.getAgentController('code');
+
+  // Address the worktree's own session instead of the shared one:
+  const session = controller.session('repo-123', '/worktrees/feature-a');
+  await session.create({ tags: { projectPath: '/worktrees/feature-a' } });
+  await session.sendMessage('hello');
+  ```
+
+  Requests without a scope behave exactly as before.
+
+- Added run activity reporting to agent controller sessions. `session.state()` responses include a `running` flag so UIs can show a working indicator immediately when attaching to a session that is already mid-run, and each thread returned by `session.listThreads()` carries a `state` of `'active'` or `'idle'` (backed by the same per-thread run tracking that signal `ifIdle` delivery uses), so one listing can power activity indicators across every worktree or scope sharing a resource instead of polling each session: ([#19357](https://github.com/mastra-ai/mastra/pull/19357))
+
+  ```ts
+  const session = client.getAgentController('code').session(resourceId);
+
+  const { running } = await session.state(); // is the session mid-run?
+
+  const threads = await session.listThreads({ tags: { projectPath } });
+  const busy = threads.filter(thread => thread.state === 'active');
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`25e7c12`](https://github.com/mastra-ai/mastra/commit/25e7c126a770069ae7fb7ecf1d2adb40e017b009), [`1ce5121`](https://github.com/mastra-ai/mastra/commit/1ce512155d122bb21f47d98383e82ffbf84b39e8), [`3cfc47a`](https://github.com/mastra-ai/mastra/commit/3cfc47a6b89940aadd0f46fb01ae9624a73a865d), [`2bb7817`](https://github.com/mastra-ai/mastra/commit/2bb78176112fde628483de2830528f7eee911e56), [`51d9870`](https://github.com/mastra-ai/mastra/commit/51d987032c689c2855374d0f244f5d654da809d1), [`5cab274`](https://github.com/mastra-ai/mastra/commit/5cab2744250e22d12fefa7b32637dce224233cee), [`7fa27d3`](https://github.com/mastra-ai/mastra/commit/7fa27d3b6f5ed68cd34e454a4d3ad9c482a0cfbc), [`a58dcbb`](https://github.com/mastra-ai/mastra/commit/a58dcbb546d7e1d65ebdc1f39e55f0908fcd9391), [`153bd3b`](https://github.com/mastra-ai/mastra/commit/153bd3b396bdfed6b74cf43de12db8fd2d83c04a), [`07bb863`](https://github.com/mastra-ai/mastra/commit/07bb8631919c6f7cf377dccd45b096e0f17fbed0), [`8a586ec`](https://github.com/mastra-ai/mastra/commit/8a586eca9a4914f31dff6140d0d45ac375b00669), [`3927473`](https://github.com/mastra-ai/mastra/commit/392747323ddb10c643d12be7b9ae913159dfaeed), [`dce50dc`](https://github.com/mastra-ai/mastra/commit/dce50dc9a1c1fcd0f427bb5f6250ec74910cb04b), [`634caff`](https://github.com/mastra-ai/mastra/commit/634caff29a9200ad058b67d53f96d9e5832fb8a2)]:
+  - @mastra/core@1.51.0-alpha.7
+
+## 1.31.2-alpha.6
+
+### Patch Changes
+
+- Added HTTP and client bindings for recovering an interrupted durable agent run. ([#19191](https://github.com/mastra-ai/mastra/pull/19191))
+
+  **What changed**
+  - `@mastra/server`: new `POST /agents/:agentId/recover` route. Given the id of a durable agent run that was interrupted by a deploy or crash, the server picks the run back up from where it left off and streams the rest of the response to the caller. Non-durable agents are rejected, and callers can only recover runs that belong to them (same permission and ownership rules as resuming a suspended run).
+  - `@mastra/client-js`: new `agent.recover({ runId })` method that reads that stream from the browser or Node. It behaves the same as `agent.resumeStream()` — you get back a readable stream of the agent's remaining response.
+
+  **Why**
+
+  The underlying core API for recovering an interrupted durable agent run could previously only be called from server-side code. This adds the standard HTTP + client surface so operators can reattach to an interrupted run from a dashboard, an admin tool, or any other client, using the same auth and ownership rules as the rest of the agents API.
+
+  **Usage**
+
+  ```ts
+  const stream = await mastraClient.getAgent('support').recover({ runId: 'run-abc123' });
+  for await (const chunk of stream) {
+    // render or forward the remaining agent output
+  }
+  ```
+
+- Updated dependencies [[`e2d5f37`](https://github.com/mastra-ai/mastra/commit/e2d5f373bd289be534d5f8694d34465010533df6)]:
+  - @mastra/core@1.51.0-alpha.6
+
 ## 1.31.2-alpha.5
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-client-js
 description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
 metadata:
   package: "@mastra/client-js"
-  version: "1.31.2-alpha.5"
+  version: "1.32.0-alpha.10"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.31.2-alpha.5",
+  "version": "1.32.0-alpha.10",
   "package": "@mastra/client-js",
   "exports": {
     "RequestContext": {

package/dist/index.cjs

@@ -2508,6 +2508,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.
    *
@@ -6113,16 +6145,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
@@ -6133,7 +6173,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 }
     });
   }
   /**
@@ -6141,7 +6181,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");
     }
@@ -6183,17 +6223,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 }
     });
@@ -6204,35 +6252,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 —
@@ -6246,36 +6293,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 ?? {}
     });
@@ -6284,7 +6333,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;
   }
@@ -6293,33 +6342,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 }
     });
@@ -6327,7 +6376,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
     });
@@ -6335,25 +6384,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 }
     });
@@ -6364,7 +6413,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
     });
@@ -6393,9 +6442,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) {