@mastra/editor 0.14.1 → 0.14.2-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @mastra/editor
 
+## 0.14.2-alpha.1
+
+### Patch Changes
+
+- Fixed Studio instruction edits dropping `providerOptions` from code-defined agents. When code defines instructions as a structured system message — for example with an Anthropic prompt-cache breakpoint — editing and publishing the instructions in Studio replaced them with a plain string, silently removing the provider options. Every request then paid full uncached input cost until the override was removed. ([#22493](https://github.com/mastra-ai/mastra/pull/22493))
+
+  Studio now owns only the wording: the published text is wrapped back in the code-defined message envelope when the override is applied, so provider options survive edits. This applies retroactively — existing published overrides pick up the code envelope on upgrade, with no migration needed.
+
+  ```ts
+  const agent = new Agent({
+    id: 'voice-agent',
+    name: 'Voice Agent',
+    instructions: {
+      role: 'system',
+      content: 'You are a helpful voice assistant.',
+      providerOptions: { anthropic: { cacheControl: { type: 'ephemeral' } } },
+    },
+    model: 'anthropic/claude-sonnet-4-6',
+  });
+
+  // Before: after publishing an instructions edit in Studio, the agent ran with a
+  // plain string — the cacheControl breakpoint was gone until the override was deleted.
+  // After: the edited text is published inside the same system message, and
+  // providerOptions.anthropic.cacheControl keeps working.
+  ```
+
+  Instructions delegated entirely to Studio (`editor: { instructions: true }`) have no code-defined envelope and are unaffected. Fixes https://github.com/mastra-ai/mastra/issues/10980
+
+- Updated dependencies [[`0885364`](https://github.com/mastra-ai/mastra/commit/0885364c2fc7fa31febcfc444fc1ba5231ac1257)]:
+  - @mastra/core@1.63.1-alpha.2
+  - @mastra/memory@1.28.1-alpha.1
+
+## 0.14.2-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`295e506`](https://github.com/mastra-ai/mastra/commit/295e506b9e6cec99e7181c5f712648888cd9486f), [`8c3be07`](https://github.com/mastra-ai/mastra/commit/8c3be0761a862c5c035ed6e5d633de87cbba20e7), [`078affd`](https://github.com/mastra-ai/mastra/commit/078affdaea57ac5e95a77e9e7b197d1878190684), [`9e3403e`](https://github.com/mastra-ai/mastra/commit/9e3403e9868240cb18841898e84cf008ebd7a87e), [`791bf5e`](https://github.com/mastra-ai/mastra/commit/791bf5e81cd27e2e1cff66122f1380ab8a3dda41)]:
+  - @mastra/memory@1.28.1-alpha.0
+  - @mastra/core@1.63.1-alpha.1
+  - @mastra/mcp@1.17.2
+
 ## 0.14.1
 
 ### Patch Changes

package/LICENSE.md

@@ -1,10 +1,12 @@
 Portions of this software are licensed as follows:
 
-- All content that resides under any directory named "ee/" within this
+- All content that resides under any directory named `ee/` within this
   repository, including but not limited to:
-  - `packages/core/src/auth/ee/`
-  - `packages/server/src/server/auth/ee/`
-    is licensed under the license defined in `ee/LICENSE`.
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
 
 - All third-party components incorporated into the Mastra Software are
   licensed under the original license provided by the owner of the

package/dist/index.cjs

@@ -905,7 +905,7 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
 		this.logger?.debug(`[applyStoredOverrides] Applying stored overrides to code agent "${agent.id}"`);
 		if (instructionsEditable && storedConfig.instructions !== void 0 && storedConfig.instructions !== null) {
 			const resolved = this.resolveStoredInstructions(storedConfig.instructions);
-			if (resolved !== void 0) fork.__updateInstructions(resolved);
+			if (resolved !== void 0) fork.__updateInstructions(this.mergeInstructionEnvelope(agent, resolved));
 		}
 		const hasStoredTools = storedConfig.tools != null;
 		const hasStoredMCPClients = storedConfig.mcpClients != null;
@@ -1192,6 +1192,54 @@ var EditorAgentNamespace = class extends CrudEditorNamespace {
 			return resolveInstructionBlocks(blocks, context, { promptBlocksStorage: promptBlocksStore });
 		};
 	}
+	/**
+	* Wrap stored instruction text in the code-defined agent's message envelope.
+	*
+	* Stored overrides can only carry plain text (`string | AgentInstructionBlock[]`),
+	* but code-defined instructions may be structured system messages carrying
+	* `providerOptions` (e.g. `anthropic.cacheControl` prompt-cache breakpoints).
+	* Studio owns the wording; code keeps the envelope, so publishing an edit
+	* can't silently drop provider options.
+	*
+	* When the code instructions are plain text (or absent, e.g. editor-owned
+	* agents), the stored value is returned unchanged. When code instructions are
+	* an array of messages, the last message's envelope is kept: an Anthropic
+	* cache breakpoint on the last system block covers everything before it, so
+	* it is the one worth preserving when Studio flattens the array into one text.
+	*/
+	mergeInstructionEnvelope(agent, stored) {
+		const raw = agent.__getOverridableFields?.()?.instructions;
+		const pickEnvelope = (value) => {
+			const candidate = Array.isArray(value) ? value[value.length - 1] : value;
+			return typeof candidate === "object" && candidate !== null && "content" in candidate ? candidate : void 0;
+		};
+		const wrap = (envelope, text) => ({
+			...envelope,
+			content: text
+		});
+		if (raw == null || typeof raw === "string" || Array.isArray(raw) && raw.every((entry) => typeof entry === "string")) return stored;
+		if (typeof raw !== "function") {
+			const envelope = pickEnvelope(raw);
+			if (!envelope) return stored;
+			if (typeof stored === "string") return wrap(envelope, stored);
+			return async (args) => wrap(envelope, await stored(args));
+		}
+		const getOriginal = agent.getInstructions.bind(agent);
+		return async ({ requestContext, mastra }) => {
+			const text = typeof stored === "string" ? stored : await stored({
+				requestContext,
+				mastra
+			});
+			let original;
+			try {
+				original = await getOriginal({ requestContext });
+			} catch {
+				return text;
+			}
+			const envelope = pickEnvelope(original);
+			return envelope ? wrap(envelope, text) : text;
+		};
+	}
 	applyStoredToolDescriptions(codeTools, storedTools) {
 		if (!storedTools || Array.isArray(storedTools)) return codeTools;
 		let nextTools;