@mastra/client-js 1.54.0-alpha.2 → 1.54.0-alpha.4

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.54.0-alpha.2"
+  version: "1.54.0-alpha.4"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.54.0-alpha.2",
+  "version": "1.54.0-alpha.4",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-harness-agent-controller.md

@@ -133,6 +133,24 @@ const session = await controller.createSession({
 
 Use [`session.thread.create()`](https://mastra.ai/reference/agent-controller/session) and [`session.thread.switch()`](https://mastra.ai/reference/agent-controller/session) to move one live Session between conversations.
 
+### Transfer thread ownership
+
+Each new thread stores its durable owner in `metadata.ownerId` and its original creator in `metadata.createdBy`. Both default to the Session host's `ownerId`. `createdBy` doesn't change when ownership transfers.
+
+Read the active thread's owner and transfer it through `session.thread`:
+
+```typescript
+const currentOwnerId = await session.thread.getOwner()
+
+await session.thread.transferOwnership({
+  toOwnerId: 'user-456',
+})
+```
+
+Transfers are serialized within one process. Hosts that require a durable cross-process compare-and-set should commit it in their own storage first, then call `transferOwnership()` to mirror the owner onto the active thread.
+
+Every run snapshots the thread owner when it starts. Tools and other dynamic runtime code can read that value from `AgentControllerRequestContext.threadOwnerId`. If ownership changes during a run, the active run keeps the old snapshot and the next run receives the new owner. `context.session.ownerId` remains the identity of the process-local Session host.
+
 ### List stored messages from the client
 
 Use the Agent Controller client to page through a thread's stored messages. Passing an options object returns the messages with pagination metadata:

package/dist/docs/references/reference-client-js-agent-controller.md

@@ -121,11 +121,11 @@ Pass `options.requestContext` to merge custom context into the run's request con
 
 ### `steer(message, options?)`
 
-Injects a message into the in-flight run without starting a new turn.
+Aborts the in-flight run, then sends the message as a new turn. Pass a string, or `{ content, files }` to attach files in the same shape as `sendMessage()`.
 
 ### `followUp(message, options?)`
 
-Queues a follow-up message. If the session is idle it sends immediately. If a run is active it queues for after the run completes.
+Queues a follow-up message. If the session is idle it sends immediately. If a run is active it queues for after the run completes. Pass a string, or `{ content, files }` to attach files in the same shape as `sendMessage()`.
 
 ### `abort()`
 

package/dist/index.cjs

@@ -6075,6 +6075,7 @@ const KNOWN_AGENT_CONTROLLER_EVENT_TYPES = new Set(Object.keys({
 	thread_changed: true,
 	thread_created: true,
 	thread_deleted: true,
+	thread_owner_changed: true,
 	thread_title_updated: true,
 	subagent_start: true,
 	subagent_text_delta: true,
@@ -6437,13 +6438,21 @@ var AgentControllerSession = class extends BaseResource {
 			}
 		});
 	}
-	/** Inject a message into the in-flight run without starting a new turn. */
+	/**
+	* Aborts the in-flight run, then sends the message as a new turn.
+	* Pass a structured message to attach files, as with `sendMessage`.
+	*/
 	async steer(message, options) {
+		const { content, files } = typeof message === "string" ? {
+			content: message,
+			files: void 0
+		} : message;
 		const requestContext = parseClientRequestContext(options?.requestContext);
 		await this.request(this.url(`${this.base()}/steer`), {
 			method: "POST",
 			body: {
-				message,
+				message: content,
+				...files?.length ? { files } : {},
 				...requestContext ? { requestContext } : {}
 			}
 		});
@@ -6554,13 +6563,19 @@ var AgentControllerSession = class extends BaseResource {
 	/**
 	* Queue a follow-up message. If the session is idle it sends immediately;
 	* if a run is active it queues for after completion.
+	* Pass a structured message to attach files, as with `sendMessage`.
 	*/
 	async followUp(message, options) {
+		const { content, files } = typeof message === "string" ? {
+			content: message,
+			files: void 0
+		} : message;
 		const requestContext = parseClientRequestContext(options?.requestContext);
 		await this.request(this.url(`${this.base()}/follow-up`), {
 			method: "POST",
 			body: {
-				message,
+				message: content,
+				...files?.length ? { files } : {},
 				...requestContext ? { requestContext } : {}
 			}
 		});