@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

package/dist/tools/web-search.d.ts

@@ -0,0 +1,114 @@
+import { type WebSearchProviderSetting } from '../onboarding/settings.js';
+/**
+ * Check whether a Tavily API key is available in the environment.
+ * Used to select model-independent web tools before falling back to
+ * model-native web search.
+ */
+export declare function hasTavilyKey(): boolean;
+/** Check whether a Parallel API key is available in the environment. */
+export declare function hasParallelKey(): boolean;
+/**
+ * Wraps the @mastra/tavily search tool with mastracode-specific behavior:
+ * relevance filtering, markdown string formatting, and token truncation.
+ * The underlying Tavily tool handles client init, input validation, and the API call.
+ */
+export declare function createWebSearchTool(): import("@mastra/core/tools").Tool<{
+    query: string;
+    searchDepth?: "advanced" | "basic" | "fast" | "ultra-fast" | undefined;
+    maxResults?: number | undefined;
+    includeAnswer?: "advanced" | "basic" | boolean | undefined;
+    includeImages?: boolean | undefined;
+    includeImageDescriptions?: boolean | undefined;
+    includeRawContent?: "markdown" | "text" | false | undefined;
+    includeDomains?: string[] | undefined;
+    excludeDomains?: string[] | undefined;
+    timeRange?: "day" | "month" | "week" | "year" | undefined;
+}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
+/**
+ * Wraps the @mastra/tavily extract tool with mastracode-specific behavior:
+ * markdown string formatting and token truncation.
+ */
+export declare function createWebExtractTool(): import("@mastra/core/tools").Tool<{
+    urls: string[];
+    extractDepth?: "advanced" | "basic" | undefined;
+    query?: string | undefined;
+    includeImages?: boolean | undefined;
+    format?: "markdown" | "text" | undefined;
+}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
+/**
+ * Wraps the @mastra/parallel search tool with Mastra Code's standard tool id,
+ * markdown string output, and token truncation.
+ */
+export declare function createParallelWebSearchTool(): import("@mastra/core/tools").Tool<{
+    query: string;
+}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
+/**
+ * Wraps the @mastra/parallel extract tool with Mastra Code's standard tool id,
+ * markdown string output, and token truncation.
+ */
+export declare function createParallelWebExtractTool(): import("@mastra/core/tools").Tool<{
+    urls: string[];
+    objective?: string | undefined;
+    searchQueries?: string[] | undefined;
+    excerptMaxCharsPerResult?: number | undefined;
+    clientModel?: string | undefined;
+    fullContent?: number | boolean | undefined;
+    maxCharsTotal?: number | undefined;
+    fetchPolicy?: {
+        maxAgeSeconds?: number | undefined;
+        timeoutSeconds?: number | undefined;
+        disableCacheFallback?: boolean | undefined;
+    } | undefined;
+    sessionId?: string | undefined;
+}, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
+/**
+ * Resolve which model-independent web provider to use. An explicit user
+ * preference wins while its API key is configured; otherwise `auto` picks the
+ * first configured provider key (Tavily, then Parallel).
+ */
+export declare function resolveWebSearchProvider(preference?: WebSearchProviderSetting): 'tavily' | 'parallel' | undefined;
+/**
+ * Create the configured model-independent web tools for the provider selected
+ * via the `webSearchProvider` preference (set in the TUI settings panel).
+ */
+export declare function createConfiguredWebTools(): {
+    web_search: import("@mastra/core/tools").Tool<{
+        query: string;
+    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
+    web_extract: import("@mastra/core/tools").Tool<{
+        urls: string[];
+        objective?: string | undefined;
+        searchQueries?: string[] | undefined;
+        excerptMaxCharsPerResult?: number | undefined;
+        clientModel?: string | undefined;
+        fullContent?: number | boolean | undefined;
+        maxCharsTotal?: number | undefined;
+        fetchPolicy?: {
+            maxAgeSeconds?: number | undefined;
+            timeoutSeconds?: number | undefined;
+            disableCacheFallback?: boolean | undefined;
+        } | undefined;
+        sessionId?: string | undefined;
+    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
+} | {
+    web_search: import("@mastra/core/tools").Tool<{
+        query: string;
+        searchDepth?: "advanced" | "basic" | "fast" | "ultra-fast" | undefined;
+        maxResults?: number | undefined;
+        includeAnswer?: "advanced" | "basic" | boolean | undefined;
+        includeImages?: boolean | undefined;
+        includeImageDescriptions?: boolean | undefined;
+        includeRawContent?: "markdown" | "text" | false | undefined;
+        includeDomains?: string[] | undefined;
+        excludeDomains?: string[] | undefined;
+        timeRange?: "day" | "month" | "week" | "year" | undefined;
+    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-search", unknown>;
+    web_extract: import("@mastra/core/tools").Tool<{
+        urls: string[];
+        extractDepth?: "advanced" | "basic" | undefined;
+        query?: string | undefined;
+        includeImages?: boolean | undefined;
+        format?: "markdown" | "text" | undefined;
+    }, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "web-extract", unknown>;
+} | undefined;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAwBxF;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wEAAwE;AACxE,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;mIA8BlC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB;;;;;;oIAwBnC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B;;mIAuB1C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B;;;;;;;;;qBAtI1C,CAAC;sBAEK,CAAC;4BAEe,CAAC;;;oIA0JxB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,wBAAiC,GAC5C,QAAQ,GAAG,UAAU,GAAG,SAAS,CAQnC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB;;;;;;;;;;;;;yBArLtC,CAAC;0BAEK,CAAC;gCAEe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;cAmMxB"}

package/dist/tools/web-search.js

@@ -0,0 +1,155 @@
+import { loadSettings } from "../onboarding/settings.js";
+import { truncateStringForTokenEstimate } from "../utils/token-estimator.js";
+import { createTool, isValidationError } from "@mastra/core/tools";
+import { z } from "zod";
+import { createParallelExtractTool, createParallelSearchTool } from "@mastra/parallel";
+import { createTavilyExtractTool, createTavilySearchTool } from "@mastra/tavily";
+//#region src/tools/web-search.ts
+const MAX_WEB_SEARCH_TOKENS = 2e3;
+const MAX_WEB_EXTRACT_TOKENS = 2e3;
+const MIN_RELEVANCE_SCORE = .25;
+const parallelWebSearchInputSchema = z.object({ query: z.string().min(1).describe("The search query") });
+function requireParallelOutput(output, operation) {
+	if (output === void 0) throw new Error(`Parallel ${operation} returned no output`);
+	if (isValidationError(output)) throw new Error(output.message);
+	return output;
+}
+/**
+* Check whether a Tavily API key is available in the environment.
+* Used to select model-independent web tools before falling back to
+* model-native web search.
+*/
+function hasTavilyKey() {
+	return !!process.env.TAVILY_API_KEY;
+}
+/** Check whether a Parallel API key is available in the environment. */
+function hasParallelKey() {
+	return !!process.env.PARALLEL_API_KEY;
+}
+/**
+* Wraps the @mastra/tavily search tool with mastracode-specific behavior:
+* relevance filtering, markdown string formatting, and token truncation.
+* The underlying Tavily tool handles client init, input validation, and the API call.
+*/
+function createWebSearchTool() {
+	const tavilySearchTool = createTavilySearchTool();
+	return createTool({
+		id: "web-search",
+		description: tavilySearchTool.description,
+		inputSchema: tavilySearchTool.inputSchema,
+		execute: async (input, context) => {
+			const output = await tavilySearchTool.execute(input, context);
+			const parts = [];
+			if (output.answer) parts.push(`Answer: ${output.answer}`);
+			const filtered = output.results.filter((r) => (r.score ?? 1) >= MIN_RELEVANCE_SCORE);
+			for (const r of filtered) parts.push(`## ${r.title}\n${r.url}\n${r.content}`);
+			const images = (output.images || []).map((img) => img.url).filter(Boolean);
+			if (images.length > 0) parts.push(`Images:\n${images.join("\n")}`);
+			return truncateStringForTokenEstimate(parts.join("\n\n"), MAX_WEB_SEARCH_TOKENS);
+		}
+	});
+}
+/**
+* Wraps the @mastra/tavily extract tool with mastracode-specific behavior:
+* markdown string formatting and token truncation.
+*/
+function createWebExtractTool() {
+	const tavilyExtractTool = createTavilyExtractTool();
+	return createTool({
+		id: "web-extract",
+		description: tavilyExtractTool.description,
+		inputSchema: tavilyExtractTool.inputSchema,
+		execute: async (input, context) => {
+			const output = await tavilyExtractTool.execute(input, context);
+			const parts = [];
+			for (const r of output.results) parts.push(`## ${r.url}\n${r.rawContent}`);
+			for (const r of output.failedResults) parts.push(`## ${r.url}\nError: ${r.error}`);
+			return truncateStringForTokenEstimate(parts.join("\n\n"), MAX_WEB_EXTRACT_TOKENS);
+		}
+	});
+}
+/**
+* Wraps the @mastra/parallel search tool with Mastra Code's standard tool id,
+* markdown string output, and token truncation.
+*/
+function createParallelWebSearchTool() {
+	const parallelSearchTool = createParallelSearchTool();
+	return createTool({
+		id: "web-search",
+		description: parallelSearchTool.description,
+		inputSchema: parallelWebSearchInputSchema,
+		execute: async (input, context) => {
+			const output = requireParallelOutput(await parallelSearchTool.execute({ searchQueries: [input.query] }, context), "search");
+			const parts = [];
+			for (const result of output.results) {
+				const title = result.title || result.url;
+				const excerpts = (result.excerpts || []).filter(Boolean).join("\n");
+				parts.push([
+					`## ${title}`,
+					result.url,
+					excerpts
+				].filter(Boolean).join("\n"));
+			}
+			return truncateStringForTokenEstimate(parts.join("\n\n"), MAX_WEB_SEARCH_TOKENS);
+		}
+	});
+}
+/**
+* Wraps the @mastra/parallel extract tool with Mastra Code's standard tool id,
+* markdown string output, and token truncation.
+*/
+function createParallelWebExtractTool() {
+	const parallelExtractTool = createParallelExtractTool();
+	return createTool({
+		id: "web-extract",
+		description: parallelExtractTool.description,
+		inputSchema: parallelExtractTool.inputSchema,
+		execute: async (input, context) => {
+			const output = requireParallelOutput(await parallelExtractTool.execute(input, context), "extract");
+			const parts = [];
+			for (const result of output.results) {
+				const content = result.fullContent || (result.excerpts || []).filter(Boolean).join("\n");
+				parts.push([`## ${result.url}`, content].filter(Boolean).join("\n"));
+			}
+			for (const error of output.errors) {
+				const status = error.httpStatusCode ? ` (${error.httpStatusCode})` : "";
+				parts.push([
+					`## ${error.url}`,
+					`Error: ${error.errorType}${status}`,
+					error.content
+				].filter(Boolean).join("\n"));
+			}
+			return truncateStringForTokenEstimate(parts.join("\n\n"), MAX_WEB_EXTRACT_TOKENS);
+		}
+	});
+}
+/**
+* Resolve which model-independent web provider to use. An explicit user
+* preference wins while its API key is configured; otherwise `auto` picks the
+* first configured provider key (Tavily, then Parallel).
+*/
+function resolveWebSearchProvider(preference = "auto") {
+	if (preference === "tavily" && hasTavilyKey()) return "tavily";
+	if (preference === "parallel" && hasParallelKey()) return "parallel";
+	if (hasTavilyKey()) return "tavily";
+	if (hasParallelKey()) return "parallel";
+}
+/**
+* Create the configured model-independent web tools for the provider selected
+* via the `webSearchProvider` preference (set in the TUI settings panel).
+*/
+function createConfiguredWebTools() {
+	const provider = resolveWebSearchProvider(loadSettings().preferences.webSearchProvider);
+	if (provider === "parallel") return {
+		web_search: createParallelWebSearchTool(),
+		web_extract: createParallelWebExtractTool()
+	};
+	if (provider === "tavily") return {
+		web_search: createWebSearchTool(),
+		web_extract: createWebExtractTool()
+	};
+}
+//#endregion
+export { createConfiguredWebTools, createParallelWebExtractTool, createParallelWebSearchTool, createWebExtractTool, createWebSearchTool, hasParallelKey, hasTavilyKey, resolveWebSearchProvider };
+
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","names":[],"sources":["../../src/tools/web-search.ts"],"sourcesContent":["import { createTool, isValidationError, type ValidationError } from '@mastra/core/tools';\nimport { createParallelSearchTool, createParallelExtractTool } from '@mastra/parallel';\nimport { createTavilySearchTool, createTavilyExtractTool } from '@mastra/tavily';\nimport { z } from 'zod';\n\nimport { loadSettings, type WebSearchProviderSetting } from '../onboarding/settings.js';\nimport { truncateStringForTokenEstimate } from '../utils/token-estimator.js';\n\nconst MAX_WEB_SEARCH_TOKENS = 2_000;\nconst MAX_WEB_EXTRACT_TOKENS = 2_000;\n\nconst MIN_RELEVANCE_SCORE = 0.25;\n\nconst parallelWebSearchInputSchema = z.object({\n  query: z.string().min(1).describe('The search query'),\n});\n\nfunction requireParallelOutput<T>(output: T | ValidationError | void, operation: 'search' | 'extract'): T {\n  if (output === undefined) {\n    throw new Error(`Parallel ${operation} returned no output`);\n  }\n\n  if (isValidationError(output)) {\n    throw new Error(output.message);\n  }\n\n  return output;\n}\n\n/**\n * Check whether a Tavily API key is available in the environment.\n * Used to select model-independent web tools before falling back to\n * model-native web search.\n */\nexport function hasTavilyKey(): boolean {\n  return !!process.env.TAVILY_API_KEY;\n}\n\n/** Check whether a Parallel API key is available in the environment. */\nexport function hasParallelKey(): boolean {\n  return !!process.env.PARALLEL_API_KEY;\n}\n\n/**\n * Wraps the @mastra/tavily search tool with mastracode-specific behavior:\n * relevance filtering, markdown string formatting, and token truncation.\n * The underlying Tavily tool handles client init, input validation, and the API call.\n */\nexport function createWebSearchTool() {\n  const tavilySearchTool = createTavilySearchTool();\n\n  return createTool({\n    id: 'web-search',\n    description: tavilySearchTool.description!,\n    inputSchema: tavilySearchTool.inputSchema!,\n    execute: async (input, context) => {\n      const output: any = await tavilySearchTool.execute!(input as any, context as any);\n\n      const parts: string[] = [];\n\n      if (output.answer) {\n        parts.push(`Answer: ${output.answer}`);\n      }\n\n      const filtered = output.results.filter((r: any) => (r.score ?? 1) >= MIN_RELEVANCE_SCORE);\n      for (const r of filtered) {\n        parts.push(`## ${r.title}\\n${r.url}\\n${r.content}`);\n      }\n\n      const images = (output.images || []).map((img: any) => img.url).filter(Boolean);\n      if (images.length > 0) {\n        parts.push(`Images:\\n${images.join('\\n')}`);\n      }\n\n      const text = parts.join('\\n\\n');\n      return truncateStringForTokenEstimate(text, MAX_WEB_SEARCH_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/tavily extract tool with mastracode-specific behavior:\n * markdown string formatting and token truncation.\n */\nexport function createWebExtractTool() {\n  const tavilyExtractTool = createTavilyExtractTool();\n\n  return createTool({\n    id: 'web-extract',\n    description: tavilyExtractTool.description!,\n    inputSchema: tavilyExtractTool.inputSchema!,\n    execute: async (input, context) => {\n      const output: any = await tavilyExtractTool.execute!(input as any, context as any);\n\n      const parts: string[] = [];\n\n      for (const r of output.results) {\n        parts.push(`## ${r.url}\\n${r.rawContent}`);\n      }\n\n      for (const r of output.failedResults) {\n        parts.push(`## ${r.url}\\nError: ${r.error}`);\n      }\n\n      const text = parts.join('\\n\\n');\n      return truncateStringForTokenEstimate(text, MAX_WEB_EXTRACT_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/parallel search tool with Mastra Code's standard tool id,\n * markdown string output, and token truncation.\n */\nexport function createParallelWebSearchTool() {\n  const parallelSearchTool = createParallelSearchTool();\n\n  return createTool({\n    id: 'web-search',\n    description: parallelSearchTool.description!,\n    inputSchema: parallelWebSearchInputSchema,\n    execute: async (input, context) => {\n      const output = requireParallelOutput(\n        await parallelSearchTool.execute!({ searchQueries: [input.query] }, context),\n        'search',\n      );\n      const parts: string[] = [];\n\n      for (const result of output.results) {\n        const title = result.title || result.url;\n        const excerpts = (result.excerpts || []).filter(Boolean).join('\\n');\n        parts.push([`## ${title}`, result.url, excerpts].filter(Boolean).join('\\n'));\n      }\n\n      return truncateStringForTokenEstimate(parts.join('\\n\\n'), MAX_WEB_SEARCH_TOKENS);\n    },\n  });\n}\n\n/**\n * Wraps the @mastra/parallel extract tool with Mastra Code's standard tool id,\n * markdown string output, and token truncation.\n */\nexport function createParallelWebExtractTool() {\n  const parallelExtractTool = createParallelExtractTool();\n\n  return createTool({\n    id: 'web-extract',\n    description: parallelExtractTool.description!,\n    inputSchema: parallelExtractTool.inputSchema!,\n    execute: async (input, context) => {\n      const output = requireParallelOutput(await parallelExtractTool.execute!(input, context), 'extract');\n      const parts: string[] = [];\n\n      for (const result of output.results) {\n        const content = result.fullContent || (result.excerpts || []).filter(Boolean).join('\\n');\n        parts.push([`## ${result.url}`, content].filter(Boolean).join('\\n'));\n      }\n\n      for (const error of output.errors) {\n        const status = error.httpStatusCode ? ` (${error.httpStatusCode})` : '';\n        parts.push([`## ${error.url}`, `Error: ${error.errorType}${status}`, error.content].filter(Boolean).join('\\n'));\n      }\n\n      return truncateStringForTokenEstimate(parts.join('\\n\\n'), MAX_WEB_EXTRACT_TOKENS);\n    },\n  });\n}\n\n/**\n * Resolve which model-independent web provider to use. An explicit user\n * preference wins while its API key is configured; otherwise `auto` picks the\n * first configured provider key (Tavily, then Parallel).\n */\nexport function resolveWebSearchProvider(\n  preference: WebSearchProviderSetting = 'auto',\n): 'tavily' | 'parallel' | undefined {\n  if (preference === 'tavily' && hasTavilyKey()) return 'tavily';\n  if (preference === 'parallel' && hasParallelKey()) return 'parallel';\n\n  // `auto`, or an explicit choice whose key is no longer configured.\n  if (hasTavilyKey()) return 'tavily';\n  if (hasParallelKey()) return 'parallel';\n  return undefined;\n}\n\n/**\n * Create the configured model-independent web tools for the provider selected\n * via the `webSearchProvider` preference (set in the TUI settings panel).\n */\nexport function createConfiguredWebTools() {\n  const provider = resolveWebSearchProvider(loadSettings().preferences.webSearchProvider);\n\n  if (provider === 'parallel') {\n    return {\n      web_search: createParallelWebSearchTool(),\n      web_extract: createParallelWebExtractTool(),\n    };\n  }\n\n  if (provider === 'tavily') {\n    return {\n      web_search: createWebSearchTool(),\n      web_extract: createWebExtractTool(),\n    };\n  }\n\n  return undefined;\n}\n"],"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,28 @@
+/**
+ * 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`.
+ */
+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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,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,44 @@
+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 ?? globalThis.crypto.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 { 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 ?? globalThis.crypto.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":";;;;;;;;;;;;;;;;;;;;;;;AA2BA,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,OAAO,WAAW;CAC3E,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"}