@mastra/code-sdk 1.2.0-alpha.8 → 1.2.0

package/dist/plugins/signal-lane.d.ts

@@ -0,0 +1,58 @@
+import type { Agent } from '@mastra/core/agent';
+import type { Mastra } from '@mastra/core/mastra';
+import type { InputProcessorOrWorkflow, OutputProcessorOrWorkflow } from '@mastra/core/processors';
+import type { SignalProvider } from '@mastra/core/signals';
+import type { PluginContribution } from './types.js';
+export type PluginSignalLaneOptions = {
+    /**
+     * Ids of providers Mastra Code wires itself (through the Agent constructor).
+     * The lane refuses to start a provider that collides with one of them:
+     * two live instances of the same provider silently clobber each other's
+     * polling, and the built-ins are invisible to the lane's own registry.
+     */
+    reservedProviderIds?: string[];
+    onError?: (message: string, error: unknown) => void;
+};
+/**
+ * Owns the lifecycle of signal providers contributed by plugins.
+ *
+ * Providers are long-lived; processors are per-request. The Agent constructor
+ * conflates the two — it harvests a provider's processors into a closure that
+ * can never be undone — so plugin providers are deliberately kept out of the
+ * `signals` array and driven from here instead, through the same public methods
+ * the constructor uses. That is what makes a provider removable when its plugin
+ * is disabled, updated or uninstalled.
+ */
+export declare class PluginSignalLane {
+    #private;
+    constructor(options?: PluginSignalLaneOptions);
+    getInputProcessors(): readonly InputProcessorOrWorkflow[];
+    getOutputProcessors(): readonly OutputProcessorOrWorkflow[];
+    /**
+     * Reconciles the live providers against a freshly loaded plugin list.
+     *
+     * A plugin whose stamp is unchanged keeps the provider instance it already
+     * has, and the freshly resolved one is dropped without ever being registered,
+     * connected or polled — reload re-runs every plugin's resolver, so unchanged
+     * plugins hand over new instances on every call.
+     *
+     * Providers of plugins that went inactive, failed to load or were uninstalled
+     * are absent from the contributions and get stopped here.
+     */
+    sync(contributions: PluginContribution<SignalProvider<string>>[]): void;
+    /**
+     * Called once Mastra exists. Providers resolved before then are registered and
+     * started here — without a Mastra instance a provider has no storage, and
+     * nothing else will ever hand it one: the Agent propagates Mastra only to the
+     * providers in its own `signals` array, which these deliberately are not in.
+     */
+    setMastra(mastra: Mastra, agent: Agent): void;
+    /**
+     * Retires every live provider and empties both processor lanes. The inverse of
+     * `sync()`, for a caller that is done with this lane — an embedder sharing one
+     * `PluginManager` across controllers would otherwise leave a controller's
+     * providers polling after it is gone.
+     */
+    stopAll(): void;
+}
+//# sourceMappingURL=signal-lane.d.ts.map

package/dist/plugins/signal-lane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-lane.d.ts","sourceRoot":"","sources":["../../src/plugins/signal-lane.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASrD,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;;gBAYf,OAAO,GAAE,uBAA4B;IASjD,kBAAkB,IAAI,SAAS,wBAAwB,EAAE;IAIzD,mBAAmB,IAAI,SAAS,yBAAyB,EAAE;IAI3D;;;;;;;;;;OAUG;IACH,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IA+BvE;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAO7C;;;;;OAKG;IACH,OAAO,IAAI,IAAI;CAyGhB"}

package/dist/plugins/signal-lane.js

@@ -0,0 +1,166 @@
+//#region src/plugins/signal-lane.ts
+/**
+* Owns the lifecycle of signal providers contributed by plugins.
+*
+* Providers are long-lived; processors are per-request. The Agent constructor
+* conflates the two — it harvests a provider's processors into a closure that
+* can never be undone — so plugin providers are deliberately kept out of the
+* `signals` array and driven from here instead, through the same public methods
+* the constructor uses. That is what makes a provider removable when its plugin
+* is disabled, updated or uninstalled.
+*/
+var PluginSignalLane = class {
+	#live = /* @__PURE__ */ new Map();
+	#reservedProviderIds;
+	#onError;
+	#agent;
+	#mastra;
+	#inputProcessors = [];
+	#outputProcessors = [];
+	constructor(options = {}) {
+		this.#reservedProviderIds = new Set(options.reservedProviderIds ?? []);
+		this.#onError = options.onError ?? ((message, error) => {
+			console.warn(message, error);
+		});
+	}
+	getInputProcessors() {
+		return this.#inputProcessors;
+	}
+	getOutputProcessors() {
+		return this.#outputProcessors;
+	}
+	/**
+	* Reconciles the live providers against a freshly loaded plugin list.
+	*
+	* A plugin whose stamp is unchanged keeps the provider instance it already
+	* has, and the freshly resolved one is dropped without ever being registered,
+	* connected or polled — reload re-runs every plugin's resolver, so unchanged
+	* plugins hand over new instances on every call.
+	*
+	* Providers of plugins that went inactive, failed to load or were uninstalled
+	* are absent from the contributions and get stopped here.
+	*/
+	sync(contributions) {
+		const seen = /* @__PURE__ */ new Set();
+		for (const { pluginId, versionStamp, value: provider } of contributions) {
+			const key = `${pluginId}::${provider.id}`;
+			seen.add(key);
+			const live = this.#live.get(key);
+			if (live && live.versionStamp === versionStamp) continue;
+			if (live) this.#retire(key, live);
+			if (this.#isProviderIdTaken(provider.id)) {
+				this.#onError(`Plugin "${pluginId}" signal provider "${provider.id}" is already running; refusing to start a second instance.`, void 0);
+				seen.delete(key);
+				continue;
+			}
+			this.#live.set(key, {
+				pluginId,
+				provider,
+				versionStamp,
+				started: false
+			});
+		}
+		for (const [key, live] of this.#live) if (!seen.has(key)) this.#retire(key, live);
+		this.#startPending();
+		this.#rebuildProcessors();
+	}
+	/**
+	* Called once Mastra exists. Providers resolved before then are registered and
+	* started here — without a Mastra instance a provider has no storage, and
+	* nothing else will ever hand it one: the Agent propagates Mastra only to the
+	* providers in its own `signals` array, which these deliberately are not in.
+	*/
+	setMastra(mastra, agent) {
+		this.#mastra = mastra;
+		this.#agent = agent;
+		this.#startPending();
+		this.#rebuildProcessors();
+	}
+	/**
+	* Retires every live provider and empties both processor lanes. The inverse of
+	* `sync()`, for a caller that is done with this lane — an embedder sharing one
+	* `PluginManager` across controllers would otherwise leave a controller's
+	* providers polling after it is gone.
+	*/
+	stopAll() {
+		for (const [key, live] of this.#live) this.#retire(key, live);
+		this.#rebuildProcessors();
+	}
+	#startPending() {
+		const mastra = this.#mastra;
+		const agent = this.#agent;
+		if (!mastra || !agent) return;
+		for (const [key, live] of this.#live) {
+			if (live.started) continue;
+			try {
+				live.provider.__registerMastra(mastra);
+				live.provider.connect(agent);
+				live.provider.startPolling();
+				live.started = true;
+				this.#runStart(key, live);
+			} catch (error) {
+				this.#failProvider(key, live, error);
+			}
+		}
+	}
+	async #runStart(key, live) {
+		try {
+			await live.provider.start?.();
+			if (this.#live.get(key) !== live) this.#stopProvider(live);
+		} catch (error) {
+			if (this.#live.get(key) !== live) {
+				this.#stopProvider(live);
+				return;
+			}
+			this.#failProvider(key, live, error);
+			this.#rebuildProcessors();
+		}
+	}
+	/**
+	* Isolated: one failing provider does not take down its plugin's tools,
+	* commands, skills or sibling providers. A plugin author who wants a provider
+	* treated as required throws from the `signalProviders` resolver instead,
+	* which fails the whole plugin record.
+	*/
+	#failProvider(key, live, error) {
+		this.#onError(`Plugin "${live.pluginId}" signal provider "${live.provider.id}" failed to start:`, error);
+		this.#retire(key, live);
+	}
+	#retire(key, live) {
+		this.#stopProvider(live);
+		this.#live.delete(key);
+	}
+	#stopProvider(live) {
+		try {
+			live.provider.stop();
+		} catch (error) {
+			this.#onError(`Plugin "${live.pluginId}" signal provider "${live.provider.id}" failed to stop:`, error);
+		}
+	}
+	#isProviderIdTaken(providerId) {
+		if (this.#reservedProviderIds.has(providerId)) return true;
+		for (const live of this.#live.values()) if (live.provider.id === providerId) return true;
+		return false;
+	}
+	#rebuildProcessors() {
+		const input = [];
+		const output = [];
+		for (const live of this.#live.values()) {
+			if (!live.started) continue;
+			try {
+				const providerInput = live.provider.getInputProcessors?.() ?? [];
+				const providerOutput = live.provider.getOutputProcessors?.() ?? [];
+				input.push(...providerInput);
+				output.push(...providerOutput);
+			} catch (error) {
+				this.#onError(`Plugin "${live.pluginId}" signal provider "${live.provider.id}" failed to provide processors:`, error);
+			}
+		}
+		this.#inputProcessors = input;
+		this.#outputProcessors = output;
+	}
+};
+//#endregion
+export { PluginSignalLane };
+
+//# sourceMappingURL=signal-lane.js.map

package/dist/plugins/signal-lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-lane.js","names":["#live","#reservedProviderIds","#onError","#inputProcessors","#outputProcessors","#retire","#isProviderIdTaken","#startPending","#rebuildProcessors","#mastra","#agent","#runStart","#failProvider","#stopProvider"],"sources":["../../src/plugins/signal-lane.ts"],"sourcesContent":["import type { Agent } from '@mastra/core/agent';\nimport type { Mastra } from '@mastra/core/mastra';\nimport type { InputProcessorOrWorkflow, OutputProcessorOrWorkflow } from '@mastra/core/processors';\nimport type { SignalProvider } from '@mastra/core/signals';\n\nimport type { PluginContribution } from './types.js';\n\ntype LiveProvider = {\n  pluginId: string;\n  provider: SignalProvider<string>;\n  versionStamp: string;\n  started: boolean;\n};\n\nexport type PluginSignalLaneOptions = {\n  /**\n   * Ids of providers Mastra Code wires itself (through the Agent constructor).\n   * The lane refuses to start a provider that collides with one of them:\n   * two live instances of the same provider silently clobber each other's\n   * polling, and the built-ins are invisible to the lane's own registry.\n   */\n  reservedProviderIds?: string[];\n  onError?: (message: string, error: unknown) => void;\n};\n\n/**\n * Owns the lifecycle of signal providers contributed by plugins.\n *\n * Providers are long-lived; processors are per-request. The Agent constructor\n * conflates the two — it harvests a provider's processors into a closure that\n * can never be undone — so plugin providers are deliberately kept out of the\n * `signals` array and driven from here instead, through the same public methods\n * the constructor uses. That is what makes a provider removable when its plugin\n * is disabled, updated or uninstalled.\n */\nexport class PluginSignalLane {\n  readonly #live = new Map<string, LiveProvider>();\n  readonly #reservedProviderIds: Set<string>;\n  readonly #onError: (message: string, error: unknown) => void;\n  #agent: Agent | undefined;\n  #mastra: Mastra | undefined;\n  // Replaced wholesale, never mutated: a request that already resolved its\n  // processors keeps the array it read, so a reload mid-request cannot change\n  // the pipeline underneath it.\n  #inputProcessors: InputProcessorOrWorkflow[] = [];\n  #outputProcessors: OutputProcessorOrWorkflow[] = [];\n\n  constructor(options: PluginSignalLaneOptions = {}) {\n    this.#reservedProviderIds = new Set(options.reservedProviderIds ?? []);\n    this.#onError =\n      options.onError ??\n      ((message, error) => {\n        console.warn(message, error);\n      });\n  }\n\n  getInputProcessors(): readonly InputProcessorOrWorkflow[] {\n    return this.#inputProcessors;\n  }\n\n  getOutputProcessors(): readonly OutputProcessorOrWorkflow[] {\n    return this.#outputProcessors;\n  }\n\n  /**\n   * Reconciles the live providers against a freshly loaded plugin list.\n   *\n   * A plugin whose stamp is unchanged keeps the provider instance it already\n   * has, and the freshly resolved one is dropped without ever being registered,\n   * connected or polled — reload re-runs every plugin's resolver, so unchanged\n   * plugins hand over new instances on every call.\n   *\n   * Providers of plugins that went inactive, failed to load or were uninstalled\n   * are absent from the contributions and get stopped here.\n   */\n  sync(contributions: PluginContribution<SignalProvider<string>>[]): void {\n    const seen = new Set<string>();\n\n    for (const { pluginId, versionStamp, value: provider } of contributions) {\n      const key = `${pluginId}::${provider.id}`;\n      seen.add(key);\n\n      const live = this.#live.get(key);\n      if (live && live.versionStamp === versionStamp) continue;\n      if (live) this.#retire(key, live);\n\n      if (this.#isProviderIdTaken(provider.id)) {\n        this.#onError(\n          `Plugin \"${pluginId}\" signal provider \"${provider.id}\" is already running; refusing to start a second instance.`,\n          undefined,\n        );\n        seen.delete(key);\n        continue;\n      }\n\n      this.#live.set(key, { pluginId, provider, versionStamp, started: false });\n    }\n\n    for (const [key, live] of this.#live) {\n      if (!seen.has(key)) this.#retire(key, live);\n    }\n\n    this.#startPending();\n    this.#rebuildProcessors();\n  }\n\n  /**\n   * Called once Mastra exists. Providers resolved before then are registered and\n   * started here — without a Mastra instance a provider has no storage, and\n   * nothing else will ever hand it one: the Agent propagates Mastra only to the\n   * providers in its own `signals` array, which these deliberately are not in.\n   */\n  setMastra(mastra: Mastra, agent: Agent): void {\n    this.#mastra = mastra;\n    this.#agent = agent;\n    this.#startPending();\n    this.#rebuildProcessors();\n  }\n\n  /**\n   * Retires every live provider and empties both processor lanes. The inverse of\n   * `sync()`, for a caller that is done with this lane — an embedder sharing one\n   * `PluginManager` across controllers would otherwise leave a controller's\n   * providers polling after it is gone.\n   */\n  stopAll(): void {\n    for (const [key, live] of this.#live) this.#retire(key, live);\n    this.#rebuildProcessors();\n  }\n\n  #startPending(): void {\n    const mastra = this.#mastra;\n    const agent = this.#agent;\n    if (!mastra || !agent) return;\n\n    for (const [key, live] of this.#live) {\n      if (live.started) continue;\n      try {\n        live.provider.__registerMastra(mastra);\n        live.provider.connect(agent);\n        live.provider.startPolling();\n        live.started = true;\n        // `start()` is the provider's own warm-up and may do network work, so it\n        // is not awaited — this runs on the boot path and on every plugin\n        // reload, and a slow provider must not hold either up. The Agent\n        // constructor treats it the same way (agent.ts: `void provider.start?.()`).\n        void this.#runStart(key, live);\n      } catch (error) {\n        this.#failProvider(key, live, error);\n      }\n    }\n  }\n\n  async #runStart(key: string, live: LiveProvider): Promise<void> {\n    try {\n      await live.provider.start?.();\n      // Retired or replaced while warming up: whatever `start()` just armed was\n      // armed after this provider was stopped, so it is stopped again. Without\n      // this a provider replaced mid-warm-up keeps working against the thread\n      // its successor is now watching.\n      if (this.#live.get(key) !== live) this.#stopProvider(live);\n    } catch (error) {\n      if (this.#live.get(key) !== live) {\n        this.#stopProvider(live);\n        return;\n      }\n      this.#failProvider(key, live, error);\n      this.#rebuildProcessors();\n    }\n  }\n\n  /**\n   * Isolated: one failing provider does not take down its plugin's tools,\n   * commands, skills or sibling providers. A plugin author who wants a provider\n   * treated as required throws from the `signalProviders` resolver instead,\n   * which fails the whole plugin record.\n   */\n  #failProvider(key: string, live: LiveProvider, error: unknown): void {\n    this.#onError(`Plugin \"${live.pluginId}\" signal provider \"${live.provider.id}\" failed to start:`, error);\n    this.#retire(key, live);\n  }\n\n  #retire(key: string, live: LiveProvider): void {\n    this.#stopProvider(live);\n    this.#live.delete(key);\n  }\n\n  #stopProvider(live: LiveProvider): void {\n    try {\n      live.provider.stop();\n    } catch (error) {\n      this.#onError(`Plugin \"${live.pluginId}\" signal provider \"${live.provider.id}\" failed to stop:`, error);\n    }\n  }\n\n  #isProviderIdTaken(providerId: string): boolean {\n    if (this.#reservedProviderIds.has(providerId)) return true;\n    for (const live of this.#live.values()) {\n      if (live.provider.id === providerId) return true;\n    }\n    return false;\n  }\n\n  #rebuildProcessors(): void {\n    const input: InputProcessorOrWorkflow[] = [];\n    const output: OutputProcessorOrWorkflow[] = [];\n    for (const live of this.#live.values()) {\n      // Only started providers contribute: one that has not been handed Mastra\n      // yet has no storage, so running its processors would fail on the first\n      // request rather than wait for the lifecycle to complete.\n      if (!live.started) continue;\n      // Guarded like every other provider call: a throwing getter drops that\n      // provider's processors from this rebuild instead of unwinding the whole\n      // lane mid-sync. Both getters are read before either lane is touched so a\n      // provider never contributes input processors without its output ones.\n      try {\n        const providerInput = live.provider.getInputProcessors?.() ?? [];\n        const providerOutput = live.provider.getOutputProcessors?.() ?? [];\n        input.push(...providerInput);\n        output.push(...providerOutput);\n      } catch (error) {\n        this.#onError(\n          `Plugin \"${live.pluginId}\" signal provider \"${live.provider.id}\" failed to provide processors:`,\n          error,\n        );\n      }\n    }\n    this.#inputProcessors = input;\n    this.#outputProcessors = output;\n  }\n}\n"],"mappings":"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"}

package/dist/plugins/types.d.ts

@@ -1,4 +1,27 @@
+import type { InputProcessor, OutputProcessor } from '@mastra/core/processors';
+import type { SignalProvider } from '@mastra/core/signals';
 import type { MastraCodePluginConfigSchema, MastraCodePluginConfigValue, MastraCodePluginTools, MastraCodeToolRenderConfig } from '../plugin.js';
+/** Processors a plugin contributed, normalized into the lane they belong to. */
+export type LoadedPluginProcessors = {
+    input: InputProcessor[];
+    output: OutputProcessor[];
+};
+/**
+ * A single contribution, carrying the id of the plugin that owns it. Ownership
+ * has to survive collection: the signal lane keys live providers by
+ * `(pluginId, providerId)`, and a processor's state id is derived from the
+ * plugin id so it stays stable when the plugin is reloaded.
+ */
+export type PluginContribution<TValue> = {
+    pluginId: string;
+    /** The owning plugin's {@link LoadedPlugin.versionStamp} at collection time. */
+    versionStamp: string;
+    value: TValue;
+};
+export type PluginProcessorEntries = {
+    input: PluginContribution<InputProcessor>[];
+    output: PluginContribution<OutputProcessor>[];
+};
 export type PluginScope = 'global' | 'project';
 export type PluginSource = 'local' | 'github';
 export type PluginStatus = 'active' | 'inactive' | 'blocked' | 'load failed' | 'conflicted';
@@ -30,11 +53,24 @@ export type LoadedPlugin = ScopedInstalledPluginRecord & {
     tools: MastraCodePluginTools;
     renderConfigs?: Record<string, MastraCodeToolRenderConfig>;
     toolNames: string[];
+    processors?: LoadedPluginProcessors;
+    signalProviders?: SignalProvider<string>[];
     skillPaths?: string[];
     commandPaths?: string[];
     configSchema?: MastraCodePluginConfigSchema;
     configValues?: Record<string, MastraCodePluginConfigValue>;
     conflicts?: string[];
+    /**
+     * Changes when this plugin's contributions should be rebuilt: source content
+     * (git HEAD for GitHub checkouts, entry file version for local plugins) plus
+     * the registry record's config values and enabled flag. Reload fires on
+     * non-content events too — a config edit hands the plugin different values
+     * while every file is untouched — so both halves matter.
+     *
+     * Consumers that own long-lived instances (the signal-provider lane) compare
+     * this to decide between keeping what they have and cycling it.
+     */
+    versionStamp?: string;
 };
 export type PluginScopePaths = {
     scope: PluginScope;

package/dist/plugins/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC/C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC;AAE5F,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC/C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,2BAA2B,GAAG;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,qBAAqB,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/workflows/create-workflow.d.ts

@@ -0,0 +1,7 @@
+export declare const createWorkflowTool: import("@mastra/core/tools").Tool<{
+    request: string;
+}, {
+    summary: string;
+    workflowId?: string | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "create-workflow", unknown>;
+//# sourceMappingURL=create-workflow.d.ts.map

package/dist/tools/workflows/create-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workflow.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/create-workflow.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,kBAAkB;;;;;8HAsG7B,CAAC"}

package/dist/tools/workflows/create-workflow.js

@@ -0,0 +1,81 @@
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/tools/workflows/create-workflow.ts
+/**
+* Coerce an unknown thrown value into a readable string. Sub-agent tool errors
+* come through the stream in various shapes (Error, plain object, string) —
+* normalise so the parent tool's error message is always useful.
+*/
+function stringifyError(err) {
+	if (err instanceof Error) return err.message;
+	if (typeof err === "string") return err;
+	try {
+		return JSON.stringify(err) ?? String(err);
+	} catch {
+		return String(err);
+	}
+}
+const createWorkflowTool = createTool({
+	id: "create-workflow",
+	description: "Build and save a Dynamic Workflow on behalf of the user. Pass the user request verbatim — a focused sub-agent handles discovery, construction, and persistence, then returns a summary. Use this whenever the user asks to \"build a workflow\", \"compose a workflow\", or similar. Do NOT try to construct workflows inline yourself.",
+	inputSchema: z.object({ request: z.string().describe("The user request, verbatim — do not paraphrase or summarise.") }),
+	outputSchema: z.object({
+		summary: z.string().describe("Natural-language summary of what the sub-agent built. Relay this to the user."),
+		workflowId: z.string().optional().describe("The id of the saved workflow, if save-workflow returned ok.")
+	}),
+	execute: async ({ request }, { mastra, requestContext }) => {
+		if (!mastra) throw new Error("create-workflow requires a Mastra context.");
+		const builder = mastra.getAgent("workflow-builder");
+		if (!builder) throw new Error("The \"workflow-builder\" sub-agent is not registered on this Mastra instance. Cannot build workflows.");
+		const stream = await builder.stream(request, { requestContext });
+		let workflowId;
+		let saveAttempted = false;
+		let saveSucceeded = false;
+		const toolErrors = [];
+		const reader = stream.fullStream.getReader();
+		let streamCompleted = false;
+		try {
+			while (true) {
+				const { value, done } = await reader.read();
+				if (done) {
+					streamCompleted = true;
+					break;
+				}
+				if (value?.type === "tool-call" && value.payload?.toolName === "save-workflow") saveAttempted = true;
+				if (value?.type === "tool-result" && value.payload?.toolName === "save-workflow") {
+					const result = value.payload.result;
+					if (result && result.ok === true && typeof result.id === "string") {
+						workflowId = result.id;
+						saveSucceeded = true;
+					}
+				}
+				if (value?.type === "tool-error" && typeof value.payload?.toolName === "string") toolErrors.push({
+					toolName: value.payload.toolName,
+					error: stringifyError(value.payload.error)
+				});
+			}
+		} finally {
+			if (!streamCompleted) await reader.cancel().catch(() => void 0);
+			reader.releaseLock();
+		}
+		const summary = await stream.text;
+		const saveErrors = toolErrors.filter((e) => e.toolName === "save-workflow");
+		if (saveErrors.length > 0 && !saveSucceeded) throw new Error(`create-workflow failed: save-workflow threw ${saveErrors.length} error(s):\n- ${saveErrors.map((e) => e.error).join("\n- ")}\n\nSub-agent summary (unreliable, save did not succeed):\n${summary}`);
+		if (!saveAttempted) {
+			const otherErrors = toolErrors.length ? `\n\nOther sub-agent tool errors:\n- ${toolErrors.map((e) => `${e.toolName}: ${e.error}`).join("\n- ")}` : "";
+			throw new Error(`create-workflow failed: the workflow-builder sub-agent never called save-workflow. No workflow was persisted.${otherErrors}\n\nSub-agent summary:\n${summary}`);
+		}
+		if (!saveSucceeded) {
+			const otherErrors = toolErrors.length ? `\n\nSub-agent tool errors:\n- ${toolErrors.map((e) => `${e.toolName}: ${e.error}`).join("\n- ")}` : "";
+			throw new Error(`create-workflow failed: save-workflow was called but did not return { ok: true }.${otherErrors}\n\nSub-agent summary:\n${summary}`);
+		}
+		return {
+			summary,
+			workflowId
+		};
+	}
+});
+//#endregion
+export { createWorkflowTool };
+
+//# sourceMappingURL=create-workflow.js.map

package/dist/tools/workflows/create-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workflow.js","names":[],"sources":["../../../src/tools/workflows/create-workflow.ts"],"sourcesContent":["/**\n * Parent-mode tool: delegate workflow construction to the workflow-builder\n * sub-agent. The parent code-agent calls this with the user's request verbatim;\n * the sub-agent runs its own discovery → compose → save loop and returns a\n * one-paragraph summary the parent relays to the user.\n *\n * The split exists so the parent code-agent's system prompt stays focused on\n * coding and isn't polluted with the long workflow-authoring contract.\n */\nimport type { Mastra } from '@mastra/core/mastra';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\n/**\n * Coerce an unknown thrown value into a readable string. Sub-agent tool errors\n * come through the stream in various shapes (Error, plain object, string) —\n * normalise so the parent tool's error message is always useful.\n */\nfunction stringifyError(err: unknown): string {\n  if (err instanceof Error) return err.message;\n  if (typeof err === 'string') return err;\n  try {\n    return JSON.stringify(err) ?? String(err);\n  } catch {\n    return String(err);\n  }\n}\n\nexport const createWorkflowTool = createTool({\n  id: 'create-workflow',\n  description:\n    'Build and save a Dynamic Workflow on behalf of the user. Pass the user request verbatim — a focused sub-agent handles discovery, construction, and persistence, then returns a summary. Use this whenever the user asks to \"build a workflow\", \"compose a workflow\", or similar. Do NOT try to construct workflows inline yourself.',\n  inputSchema: z.object({\n    request: z.string().describe('The user request, verbatim — do not paraphrase or summarise.'),\n  }),\n  outputSchema: z.object({\n    summary: z.string().describe('Natural-language summary of what the sub-agent built. Relay this to the user.'),\n    workflowId: z.string().optional().describe('The id of the saved workflow, if save-workflow returned ok.'),\n  }),\n  execute: async ({ request }, { mastra, requestContext }) => {\n    if (!mastra) throw new Error('create-workflow requires a Mastra context.');\n    const builder = (mastra as Mastra).getAgent('workflow-builder' as never);\n    if (!builder) {\n      throw new Error(\n        'The \"workflow-builder\" sub-agent is not registered on this Mastra instance. Cannot build workflows.',\n      );\n    }\n\n    // Propagate the parent code-agent's requestContext so the sub-agent's\n    // dynamic model resolver (getDynamicModel) sees controller.session.modelId.\n    // Without this the sub-agent throws \"No model selected\" even when the user\n    // has /models configured for the main code-agent.\n    const stream = await builder.stream(request, { requestContext });\n\n    // Sub-agent runs its own tool loop. We MUST verify save-workflow actually\n    // ran and returned ok — otherwise the sub-agent's natural-language \"summary\"\n    // is worthless (it will happily claim success without ever calling the tool,\n    // or claim success after save-workflow threw). Surface every error the\n    // sub-agent's tools produce so the caller sees them instead of a fake ok.\n    let workflowId: string | undefined;\n    let saveAttempted = false;\n    let saveSucceeded = false;\n    const toolErrors: Array<{ toolName: string; error: string }> = [];\n\n    const reader = stream.fullStream.getReader();\n    let streamCompleted = false;\n    try {\n      while (true) {\n        const { value, done } = await reader.read();\n        if (done) {\n          streamCompleted = true;\n          break;\n        }\n        if (value?.type === 'tool-call' && value.payload?.toolName === 'save-workflow') {\n          saveAttempted = true;\n        }\n        if (value?.type === 'tool-result' && value.payload?.toolName === 'save-workflow') {\n          const result = value.payload.result as { id?: string; ok?: boolean } | undefined;\n          if (result && result.ok === true && typeof result.id === 'string') {\n            workflowId = result.id;\n            saveSucceeded = true;\n          }\n        }\n        if (value?.type === 'tool-error' && typeof value.payload?.toolName === 'string') {\n          toolErrors.push({ toolName: value.payload.toolName, error: stringifyError(value.payload.error) });\n        }\n      }\n    } finally {\n      if (!streamCompleted) {\n        await reader.cancel().catch(() => undefined);\n      }\n      reader.releaseLock();\n    }\n\n    const summary = await stream.text;\n\n    // If save-workflow errored, surface that error explicitly — do NOT return\n    // the sub-agent's summary as if things were fine.\n    const saveErrors = toolErrors.filter(e => e.toolName === 'save-workflow');\n    if (saveErrors.length > 0 && !saveSucceeded) {\n      throw new Error(\n        `create-workflow failed: save-workflow threw ${saveErrors.length} error(s):\\n- ${saveErrors\n          .map(e => e.error)\n          .join('\\n- ')}\\n\\nSub-agent summary (unreliable, save did not succeed):\\n${summary}`,\n      );\n    }\n\n    // If save-workflow was never called, the sub-agent gave up (or hallucinated\n    // success). Fail loudly so the caller doesn't think a workflow exists.\n    if (!saveAttempted) {\n      const otherErrors = toolErrors.length\n        ? `\\n\\nOther sub-agent tool errors:\\n- ${toolErrors.map(e => `${e.toolName}: ${e.error}`).join('\\n- ')}`\n        : '';\n      throw new Error(\n        `create-workflow failed: the workflow-builder sub-agent never called save-workflow. No workflow was persisted.${otherErrors}\\n\\nSub-agent summary:\\n${summary}`,\n      );\n    }\n\n    // Save was attempted but never returned ok (no tool-result with { ok: true, id }).\n    if (!saveSucceeded) {\n      const otherErrors = toolErrors.length\n        ? `\\n\\nSub-agent tool errors:\\n- ${toolErrors.map(e => `${e.toolName}: ${e.error}`).join('\\n- ')}`\n        : '';\n      throw new Error(\n        `create-workflow failed: save-workflow was called but did not return { ok: true }.${otherErrors}\\n\\nSub-agent summary:\\n${summary}`,\n      );\n    }\n\n    return { summary, workflowId };\n  },\n});\n"],"mappings":";;;;;;;;AAkBA,SAAS,eAAe,KAAsB;CAC5C,IAAI,eAAe,OAAO,OAAO,IAAI;CACrC,IAAI,OAAO,QAAQ,UAAU,OAAO;CACpC,IAAI;EACF,OAAO,KAAK,UAAU,GAAG,KAAK,OAAO,GAAG;CAC1C,QAAQ;EACN,OAAO,OAAO,GAAG;CACnB;AACF;AAEA,MAAa,qBAAqB,WAAW;CAC3C,IAAI;CACJ,aACE;CACF,aAAa,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,8DAA8D,EAC7F,CAAC;CACD,cAAc,EAAE,OAAO;EACrB,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,+EAA+E;EAC5G,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6DAA6D;CAC1G,CAAC;CACD,SAAS,OAAO,EAAE,WAAW,EAAE,QAAQ,qBAAqB;EAC1D,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,4CAA4C;EACzE,MAAM,UAAW,OAAkB,SAAS,kBAA2B;EACvE,IAAI,CAAC,SACH,MAAM,IAAI,MACR,uGACF;EAOF,MAAM,SAAS,MAAM,QAAQ,OAAO,SAAS,EAAE,eAAe,CAAC;EAO/D,IAAI;EACJ,IAAI,gBAAgB;EACpB,IAAI,gBAAgB;EACpB,MAAM,aAAyD,CAAC;EAEhE,MAAM,SAAS,OAAO,WAAW,UAAU;EAC3C,IAAI,kBAAkB;EACtB,IAAI;GACF,OAAO,MAAM;IACX,MAAM,EAAE,OAAO,SAAS,MAAM,OAAO,KAAK;IAC1C,IAAI,MAAM;KACR,kBAAkB;KAClB;IACF;IACA,IAAI,OAAO,SAAS,eAAe,MAAM,SAAS,aAAa,iBAC7D,gBAAgB;IAElB,IAAI,OAAO,SAAS,iBAAiB,MAAM,SAAS,aAAa,iBAAiB;KAChF,MAAM,SAAS,MAAM,QAAQ;KAC7B,IAAI,UAAU,OAAO,OAAO,QAAQ,OAAO,OAAO,OAAO,UAAU;MACjE,aAAa,OAAO;MACpB,gBAAgB;KAClB;IACF;IACA,IAAI,OAAO,SAAS,gBAAgB,OAAO,MAAM,SAAS,aAAa,UACrE,WAAW,KAAK;KAAE,UAAU,MAAM,QAAQ;KAAU,OAAO,eAAe,MAAM,QAAQ,KAAK;IAAE,CAAC;GAEpG;EACF,UAAU;GACR,IAAI,CAAC,iBACH,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,KAAA,CAAS;GAE7C,OAAO,YAAY;EACrB;EAEA,MAAM,UAAU,MAAM,OAAO;EAI7B,MAAM,aAAa,WAAW,QAAO,MAAK,EAAE,aAAa,eAAe;EACxE,IAAI,WAAW,SAAS,KAAK,CAAC,eAC5B,MAAM,IAAI,MACR,+CAA+C,WAAW,OAAO,gBAAgB,WAC9E,KAAI,MAAK,EAAE,KAAK,CAAC,CACjB,KAAK,MAAM,EAAE,6DAA6D,SAC/E;EAKF,IAAI,CAAC,eAAe;GAClB,MAAM,cAAc,WAAW,SAC3B,uCAAuC,WAAW,KAAI,MAAK,GAAG,EAAE,SAAS,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,MACnG;GACJ,MAAM,IAAI,MACR,gHAAgH,YAAY,0BAA0B,SACxJ;EACF;EAGA,IAAI,CAAC,eAAe;GAClB,MAAM,cAAc,WAAW,SAC3B,iCAAiC,WAAW,KAAI,MAAK,GAAG,EAAE,SAAS,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,MAC7F;GACJ,MAAM,IAAI,MACR,oFAAoF,YAAY,0BAA0B,SAC5H;EACF;EAEA,OAAO;GAAE;GAAS;EAAW;CAC/B;AACF,CAAC"}

package/dist/tools/workflows/delete-workflow.d.ts

@@ -0,0 +1,7 @@
+export declare const deleteWorkflowTool: import("@mastra/core/tools").Tool<{
+    id: string;
+}, {
+    ok: true;
+    id: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "delete-workflow", unknown>;
+//# sourceMappingURL=delete-workflow.d.ts.map

package/dist/tools/workflows/delete-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-workflow.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/delete-workflow.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,kBAAkB;;;;;8HAe7B,CAAC"}

package/dist/tools/workflows/delete-workflow.js

@@ -0,0 +1,21 @@
+import { deleteWorkflow } from "../../workflows/service.js";
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/tools/workflows/delete-workflow.ts
+const deleteWorkflowTool = createTool({
+	id: "delete-workflow",
+	description: "Remove a saved workflow from storage and unregister the live in-process Workflow instance. Idempotent. Subsequent save-workflow calls with the same id re-register cleanly.",
+	inputSchema: z.object({ id: z.string().describe("The workflow id to delete.") }),
+	outputSchema: z.object({
+		ok: z.literal(true),
+		id: z.string()
+	}),
+	execute: async ({ id }, { mastra }) => {
+		if (!mastra) throw new Error("delete-workflow requires a Mastra context.");
+		return deleteWorkflow(mastra, id);
+	}
+});
+//#endregion
+export { deleteWorkflowTool };
+
+//# sourceMappingURL=delete-workflow.js.map

package/dist/tools/workflows/delete-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-workflow.js","names":[],"sources":["../../../src/tools/workflows/delete-workflow.ts"],"sourcesContent":["/**\n * Parent-mode tool: delete a saved workflow from storage and unregister the\n * live in-process Workflow instance so a subsequent save-workflow with the\n * same id re-registers cleanly.\n */\nimport type { Mastra } from '@mastra/core/mastra';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\nimport { deleteWorkflow } from '../../workflows/service.js';\n\nexport const deleteWorkflowTool = createTool({\n  id: 'delete-workflow',\n  description:\n    'Remove a saved workflow from storage and unregister the live in-process Workflow instance. Idempotent. Subsequent save-workflow calls with the same id re-register cleanly.',\n  inputSchema: z.object({\n    id: z.string().describe('The workflow id to delete.'),\n  }),\n  outputSchema: z.object({\n    ok: z.literal(true),\n    id: z.string(),\n  }),\n  execute: async ({ id }, { mastra }) => {\n    if (!mastra) throw new Error('delete-workflow requires a Mastra context.');\n    return deleteWorkflow(mastra as Mastra, id);\n  },\n});\n"],"mappings":";;;;AAUA,MAAa,qBAAqB,WAAW;CAC3C,IAAI;CACJ,aACE;CACF,aAAa,EAAE,OAAO,EACpB,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,4BAA4B,EACtD,CAAC;CACD,cAAc,EAAE,OAAO;EACrB,IAAI,EAAE,QAAQ,IAAI;EAClB,IAAI,EAAE,OAAO;CACf,CAAC;CACD,SAAS,OAAO,EAAE,MAAM,EAAE,aAAa;EACrC,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,4CAA4C;EACzE,OAAO,eAAe,QAAkB,EAAE;CAC5C;AACF,CAAC"}

package/dist/tools/workflows/ephemeral-memory.d.ts

@@ -0,0 +1,7 @@
+import { RequestContext } from '@mastra/core/request-context';
+interface EphemeralMemoryOptions {
+    threadId?: string;
+}
+export declare function withEphemeralMemory<T>(requestContext: RequestContext | undefined, fn: (requestContext: RequestContext | undefined) => Promise<T>, options?: EphemeralMemoryOptions): Promise<T>;
+export {};
+//# sourceMappingURL=ephemeral-memory.d.ts.map

package/dist/tools/workflows/ephemeral-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-memory.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/ephemeral-memory.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgD,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE5G,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,EAAE,EAAE,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9D,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/dist/tools/workflows/ephemeral-memory.js

@@ -0,0 +1,45 @@
+import { randomUUID } from "crypto";
+import { MASTRA_RESOURCE_ID_KEY, MASTRA_THREAD_ID_KEY, RequestContext } from "@mastra/core/request-context";
+//#region src/tools/workflows/ephemeral-memory.ts
+/**
+* Sub-invocations launched from a parent chat turn (workflow agent steps,
+* sub-agent tool calls) must run under a fresh isolated Mastra memory scope
+* so they don't:
+*
+*   - write their prompts/responses into the parent chat thread's history, or
+*   - contend with the parent turn's memory-dependent processors
+*     (observational-memory, task-state, working-memory-state).
+*
+* `withEphemeralMemory` copies the caller's request context into a child,
+* replaces its MastraMemory with a fresh thread id and inherited resource id,
+* then passes that isolated child to `fn`. The parent context is never mutated,
+* so concurrent sub-invocations cannot overwrite or restore each other's
+* memory values. Isolation writes the ephemeral ids instead of scrubbing them:
+* inner agent invocations resolve their thread/resource via those reserved
+* keys, and leaving them unset causes downstream storage saves to throw
+* "Thread ID is required".
+*
+* Callers can override the ephemeral thread id (e.g. for tests) via
+* `options.threadId`.
+*/
+async function withEphemeralMemory(requestContext, fn, options = {}) {
+	if (!requestContext) return fn(void 0);
+	const childRequestContext = new RequestContext(requestContext.entries());
+	const mastraMemory = requestContext.get("MastraMemory");
+	const resourceId = requestContext.get(MASTRA_RESOURCE_ID_KEY);
+	const ephemeralThreadId = options.threadId ?? randomUUID();
+	const parentResourceId = mastraMemory?.resourceId ?? resourceId ?? "";
+	childRequestContext.set("MastraMemory", {
+		thread: { id: ephemeralThreadId },
+		resourceId: parentResourceId,
+		memoryConfig: void 0
+	});
+	childRequestContext.set(MASTRA_THREAD_ID_KEY, ephemeralThreadId);
+	if (parentResourceId) childRequestContext.set(MASTRA_RESOURCE_ID_KEY, parentResourceId);
+	else childRequestContext.delete(MASTRA_RESOURCE_ID_KEY);
+	return fn(childRequestContext);
+}
+//#endregion
+export { withEphemeralMemory };
+
+//# sourceMappingURL=ephemeral-memory.js.map

package/dist/tools/workflows/ephemeral-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-memory.js","names":[],"sources":["../../../src/tools/workflows/ephemeral-memory.ts"],"sourcesContent":["/**\n * Sub-invocations launched from a parent chat turn (workflow agent steps,\n * sub-agent tool calls) must run under a fresh isolated Mastra memory scope\n * so they don't:\n *\n *   - write their prompts/responses into the parent chat thread's history, or\n *   - contend with the parent turn's memory-dependent processors\n *     (observational-memory, task-state, working-memory-state).\n *\n * `withEphemeralMemory` copies the caller's request context into a child,\n * replaces its MastraMemory with a fresh thread id and inherited resource id,\n * then passes that isolated child to `fn`. The parent context is never mutated,\n * so concurrent sub-invocations cannot overwrite or restore each other's\n * memory values. Isolation writes the ephemeral ids instead of scrubbing them:\n * inner agent invocations resolve their thread/resource via those reserved\n * keys, and leaving them unset causes downstream storage saves to throw\n * \"Thread ID is required\".\n *\n * Callers can override the ephemeral thread id (e.g. for tests) via\n * `options.threadId`.\n */\nimport { randomUUID } from 'node:crypto';\nimport { MASTRA_RESOURCE_ID_KEY, MASTRA_THREAD_ID_KEY, RequestContext } from '@mastra/core/request-context';\n\ninterface EphemeralMemoryOptions {\n  threadId?: string;\n}\n\nexport async function withEphemeralMemory<T>(\n  requestContext: RequestContext | undefined,\n  fn: (requestContext: RequestContext | undefined) => Promise<T>,\n  options: EphemeralMemoryOptions = {},\n): Promise<T> {\n  if (!requestContext) return fn(undefined);\n\n  const childRequestContext = new RequestContext(requestContext.entries());\n  const mastraMemory = requestContext.get('MastraMemory') as\n    | { thread?: { id?: string }; resourceId?: string; memoryConfig?: unknown }\n    | undefined;\n  const resourceId = requestContext.get(MASTRA_RESOURCE_ID_KEY) as string | undefined;\n  const ephemeralThreadId = options.threadId ?? randomUUID();\n  const parentResourceId = mastraMemory?.resourceId ?? resourceId ?? '';\n\n  childRequestContext.set('MastraMemory', {\n    thread: { id: ephemeralThreadId },\n    resourceId: parentResourceId,\n    memoryConfig: undefined,\n  });\n  // Stamp the reserved thread/resource-key context values with the same\n  // ephemeral ids. Inner agent invocations (workflow agent steps, sub-agent\n  // tool calls) read these keys to resolve their runtime thread; leaving\n  // MASTRA_THREAD_ID_KEY unset causes prepare-memory-step to build a\n  // MessageList without a threadId, which storage rejects downstream.\n  childRequestContext.set(MASTRA_THREAD_ID_KEY, ephemeralThreadId);\n  if (parentResourceId) {\n    childRequestContext.set(MASTRA_RESOURCE_ID_KEY, parentResourceId);\n  } else {\n    childRequestContext.delete(MASTRA_RESOURCE_ID_KEY);\n  }\n\n  return fn(childRequestContext);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA4BA,eAAsB,oBACpB,gBACA,IACA,UAAkC,CAAC,GACvB;CACZ,IAAI,CAAC,gBAAgB,OAAO,GAAG,KAAA,CAAS;CAExC,MAAM,sBAAsB,IAAI,eAAe,eAAe,QAAQ,CAAC;CACvE,MAAM,eAAe,eAAe,IAAI,cAAc;CAGtD,MAAM,aAAa,eAAe,IAAI,sBAAsB;CAC5D,MAAM,oBAAoB,QAAQ,YAAY,WAAW;CACzD,MAAM,mBAAmB,cAAc,cAAc,cAAc;CAEnE,oBAAoB,IAAI,gBAAgB;EACtC,QAAQ,EAAE,IAAI,kBAAkB;EAChC,YAAY;EACZ,cAAc,KAAA;CAChB,CAAC;CAMD,oBAAoB,IAAI,sBAAsB,iBAAiB;CAC/D,IAAI,kBACF,oBAAoB,IAAI,wBAAwB,gBAAgB;MAEhE,oBAAoB,OAAO,sBAAsB;CAGnD,OAAO,GAAG,mBAAmB;AAC/B"}

package/dist/tools/workflows/extract-json-schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extract a JSON Schema from a Mastra tool's schema field. Tools created via
+ * `createTool({...})` wrap their Zod schemas with `toStandardSchema`, exposing
+ * `['~standard'].jsonSchema` as a `{ input(opts), output(opts) }` converter
+ * (see packages/schema-compat/src/standard-schema/adapters/zod-v3.ts:110-119).
+ * `direction` selects which side — pass 'input' for inputSchema, 'output' for
+ * outputSchema. Returns undefined if the schema is missing or not
+ * standard-schema-compliant — the workflow-builder agent then knows the tool's
+ * shape is opaque and must reshape via mapping.
+ */
+export declare function extractJsonSchema(maybeSchema: unknown, direction: 'input' | 'output'): unknown | undefined;
+//# sourceMappingURL=extract-json-schema.d.ts.map

package/dist/tools/workflows/extract-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-json-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/extract-json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAc1G"}

package/dist/tools/workflows/extract-json-schema.js

@@ -0,0 +1,22 @@
+//#region src/tools/workflows/extract-json-schema.ts
+/**
+* Extract a JSON Schema from a Mastra tool's schema field. Tools created via
+* `createTool({...})` wrap their Zod schemas with `toStandardSchema`, exposing
+* `['~standard'].jsonSchema` as a `{ input(opts), output(opts) }` converter
+* (see packages/schema-compat/src/standard-schema/adapters/zod-v3.ts:110-119).
+* `direction` selects which side — pass 'input' for inputSchema, 'output' for
+* outputSchema. Returns undefined if the schema is missing or not
+* standard-schema-compliant — the workflow-builder agent then knows the tool's
+* shape is opaque and must reshape via mapping.
+*/
+function extractJsonSchema(maybeSchema, direction) {
+	try {
+		return (maybeSchema?.["~standard"]?.jsonSchema)?.[direction]?.({ target: "draft-2020-12" });
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { extractJsonSchema };
+
+//# sourceMappingURL=extract-json-schema.js.map

package/dist/tools/workflows/extract-json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-json-schema.js","names":["s"],"sources":["../../../src/tools/workflows/extract-json-schema.ts"],"sourcesContent":["/**\n * Extract a JSON Schema from a Mastra tool's schema field. Tools created via\n * `createTool({...})` wrap their Zod schemas with `toStandardSchema`, exposing\n * `['~standard'].jsonSchema` as a `{ input(opts), output(opts) }` converter\n * (see packages/schema-compat/src/standard-schema/adapters/zod-v3.ts:110-119).\n * `direction` selects which side — pass 'input' for inputSchema, 'output' for\n * outputSchema. Returns undefined if the schema is missing or not\n * standard-schema-compliant — the workflow-builder agent then knows the tool's\n * shape is opaque and must reshape via mapping.\n */\nexport function extractJsonSchema(maybeSchema: unknown, direction: 'input' | 'output'): unknown | undefined {\n  try {\n    const s = maybeSchema as\n      | {\n          ['~standard']?: {\n            jsonSchema?: { input?: (opts: unknown) => unknown; output?: (opts: unknown) => unknown };\n          };\n        }\n      | undefined;\n    const converter = s?.['~standard']?.jsonSchema;\n    return converter?.[direction]?.({ target: 'draft-2020-12' });\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,kBAAkB,aAAsB,WAAoD;CAC1G,IAAI;EASF,QADkBA,cAAI,YAAY,EAAE,WAAA,GACjB,UAAU,GAAG,EAAE,QAAQ,gBAAgB,CAAC;CAC7D,QAAQ;EACN;CACF;AACF"}

package/dist/tools/workflows/get-workflow.d.ts

@@ -0,0 +1,11 @@
+export declare const getWorkflowTool: import("@mastra/core/tools").Tool<{
+    id: string;
+}, {
+    id: string;
+    status: "active" | "archived";
+    description?: string | undefined;
+    inputSchema?: any;
+    outputSchema?: any;
+    graph?: any[] | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "get-workflow", unknown>;
+//# sourceMappingURL=get-workflow.d.ts.map

package/dist/tools/workflows/get-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-workflow.d.ts","sourceRoot":"","sources":["../../../src/tools/workflows/get-workflow.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,eAAe;;;;;;;;;2HA2B1B,CAAC"}