@mastra/client-js 1.54.0-alpha.1 → 1.54.0-alpha.3

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.1"
+  version: "1.54.0-alpha.3"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.54.0-alpha.1",
+  "version": "1.54.0-alpha.3",
   "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/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,