@mastra/client-js 1.41.0-alpha.10 → 1.41.0-alpha.11

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @mastra/client-js
 
+## 1.41.0-alpha.11
+
+### Minor Changes
+
+- Added a `durable` option to stored agents so agents created through the Agents API can run with durable execution — no code deployment required. ([#21715](https://github.com/mastra-ai/mastra/pull/21715))
+
+  ```typescript
+  await mastraClient.createStoredAgent({
+    id: 'helper',
+    name: 'Helper',
+    instructions: 'You are a helpful assistant.',
+    model: { provider: 'openai', name: 'gpt-5' },
+    durable: true,
+  });
+  ```
+
+  Pass `true` for defaults, or `{ maxSteps, cleanupTimeoutMs }` to tune the durable loop. Cache and pubsub are inherited from the server's Mastra instance, so configure distributed backends there for durability across replicas. Automatic recovery is still configured in code via `recovery.durableAgents`.
+
+- Fixed the agent controller event types, which described payloads the server never sends. ([#21739](https://github.com/mastra-ai/mastra/pull/21739))
+
+  `KnownAgentControllerEvent` was written by hand and had drifted from the controller. Narrowing on `om_activation` gave you an `enabled` boolean that does not exist, `om_status` a `status` string instead of the token windows, `om_thread_title_updated` a `title` instead of `newTitle`, and `subagent_end` only a `toolCallId` — its `agentType`, `result`, `isError` and `durationMs` were missing. `usage_update` typed its payload as `unknown`, so every consumer cast it. Seven events the controller emits (`state_changed`, `command_exit`, `tool_suspension_cancelled`, and the four remaining `subagent_*` events) were not typed at all and fell through `isKnownAgentControllerEvent`.
+
+  `isKnownAgentControllerEvent` now returns `true` for those seven events as well. If you route unrecognised events to a fallback branch, they no longer reach it — give them a case in your `switch` or they are silently dropped.
+
+  `thread_created` now delivers `thread.createdAt` and `thread.updatedAt` as `Date`s, the way the `message_*` events already did — the stream carries them as ISO strings.
+
+  Payload drift is now a compile error instead of a wrong field at runtime, so handlers reading the old fields need updating.
+
+  ```ts
+  // Before: compiled, but `enabled` is always undefined
+  if (event.type === 'om_activation' && event.enabled) { ... }
+
+  // After: tsc rejects it; the event carries cycleId, tokensActivated, generationCount, …
+  if (event.type === 'om_activation') { console.log(event.tokensActivated) }
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`6223446`](https://github.com/mastra-ai/mastra/commit/6223446ddce6166e96e0ba5e00d628b615dee8ca), [`583e235`](https://github.com/mastra-ai/mastra/commit/583e23519c13af16c1746f9c49722d011216611b), [`a77f8d4`](https://github.com/mastra-ai/mastra/commit/a77f8d4740d2178a74c41e4bf678b4fcd8fa0bb2), [`40d358e`](https://github.com/mastra-ai/mastra/commit/40d358e29d55543803e64b49241122f598ffabc7), [`e80cd7e`](https://github.com/mastra-ai/mastra/commit/e80cd7e7683e7d732e1cc6784bcac1d2640d2ce3), [`20504b2`](https://github.com/mastra-ai/mastra/commit/20504b2ecebd0e077acda3d457ab57480a98ed3e)]:
+  - @mastra/core@1.60.0-alpha.11
+
 ## 1.41.0-alpha.10
 
 ### 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.41.0-alpha.10"
+  version: "1.41.0-alpha.11"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.41.0-alpha.10",
+  "version": "1.41.0-alpha.11",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-client-js-agents.md

@@ -778,9 +778,29 @@ const agent = await mastraClient.createStoredAgent({
     version: '1.0',
     team: 'engineering',
   },
+  durable: true,
 })
 ```
 
+#### Durable stored agents
+
+Set `durable` to run the agent as a [durable agent](https://mastra.ai/docs/harness/durable-agents) once the server hydrates it. Pass `true` to accept the defaults, or an object to tune the durable loop:
+
+```typescript
+const agent = await mastraClient.createStoredAgent({
+  id: 'durable-agent',
+  name: 'Durable Agent',
+  instructions: 'You are a helpful assistant.',
+  model: {
+    provider: 'openai',
+    name: 'gpt-5.4',
+  },
+  durable: { maxSteps: 50, cleanupTimeoutMs: 0 },
+})
+```
+
+Only serializable options are accepted. The durable cache and pubsub are inherited from the server's `Mastra` instance. If it has no distributed cache or pubsub configured, durability is process-local. Automatic recovery is still configured in code through `recovery.durableAgents`.
+
 ### `getStoredAgent()`
 
 Get an instance of a specific stored agent:

package/dist/index.cjs

@@ -5672,22 +5672,29 @@ const KNOWN_AGENT_CONTROLLER_EVENT_TYPES = new Set(Object.keys({
 	message_start: true,
 	message_update: true,
 	message_end: true,
+	state_changed: true,
 	tool_input_start: true,
 	tool_input_delta: true,
 	tool_input_end: true,
 	tool_start: true,
 	tool_update: true,
 	shell_output: true,
+	command_exit: true,
 	tool_end: true,
 	tool_approval_required: true,
 	tool_suspended: true,
+	tool_suspension_cancelled: true,
 	mode_changed: true,
 	model_changed: true,
 	thread_changed: true,
 	thread_created: true,
 	thread_deleted: true,
 	subagent_start: true,
+	subagent_text_delta: true,
+	subagent_tool_start: true,
+	subagent_tool_end: true,
 	subagent_end: true,
+	subagent_model_changed: true,
 	task_updated: true,
 	notification: true,
 	notification_summary: true,
@@ -5718,19 +5725,37 @@ const KNOWN_AGENT_CONTROLLER_EVENT_TYPES = new Set(Object.keys({
 function isKnownAgentControllerEvent(event) {
 	return KNOWN_AGENT_CONTROLLER_EVENT_TYPES.has(event.type);
 }
+const toDate = (value) => value instanceof Date ? value : new Date(value);
 function hydrateMessage(message) {
 	return {
 		...message,
-		createdAt: message.createdAt instanceof Date ? message.createdAt : new Date(message.createdAt)
+		createdAt: toDate(message.createdAt)
 	};
 }
-function hydrateEventMessage(event) {
-	if (event.type !== "message_start" && event.type !== "message_update" && event.type !== "message_end") return event;
+function hydrateThread(thread) {
 	return {
-		...event,
-		message: hydrateMessage(event.message)
+		...thread,
+		createdAt: toDate(thread.createdAt),
+		updatedAt: toDate(thread.updatedAt)
 	};
 }
+/** The stream carries every timestamp as an ISO string; give consumers back the `Date`s the type promises. */
+function hydrateEventTimestamps(event) {
+	if (!isKnownAgentControllerEvent(event)) return event;
+	switch (event.type) {
+		case "message_start":
+		case "message_update":
+		case "message_end": return {
+			...event,
+			message: hydrateMessage(event.message)
+		};
+		case "thread_created": return {
+			...event,
+			thread: hydrateThread(event.thread)
+		};
+		default: return event;
+	}
+}
 /**
 * A session bound to a `resourceId` within one agent controller. Sessions are
 * get-or-create on the server, so re-creating the same resourceId (and scope)
@@ -5862,7 +5887,7 @@ var AgentControllerSession = class extends BaseResource {
 							if (!data) continue;
 							let event;
 							try {
-								event = hydrateEventMessage(JSON.parse(data));
+								event = hydrateEventTimestamps(JSON.parse(data));
 							} catch {
 								continue;
 							}