@mastra/code-sdk 0.0.0-client-tool-results-20260912062135

package/dist/tools/request-sandbox-access.d.ts

@@ -0,0 +1,6 @@
+/**
+ * request_access tool — requests permission to access a directory outside the project root.
+ * The user can approve or deny the request via TUI dialog.
+ */
+export declare const requestSandboxAccessTool: import("@mastra/core/tools").Tool<unknown, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, string, unknown>;
+//# sourceMappingURL=request-sandbox-access.d.ts.map

package/dist/tools/request-sandbox-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-sandbox-access.d.ts","sourceRoot":"","sources":["../../src/tools/request-sandbox-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,eAAO,MAAM,wBAAwB,sKA6F5B,CAAC"}

package/dist/tools/request-sandbox-access.js

@@ -0,0 +1,79 @@
+import { getAllowedPathsFromContext, isPathAllowed } from "./utils.js";
+import * as os$1 from "os";
+import * as path$1 from "path";
+import { createTool } from "@mastra/core/tools";
+import { LocalFilesystem } from "@mastra/core/workspace";
+import { z } from "zod";
+//#region src/tools/request-sandbox-access.ts
+/**
+* request_access tool — requests permission to access a directory outside the project root.
+* The user can approve or deny the request via TUI dialog.
+*/
+function expandTilde(p) {
+	if (p === "~") return os$1.homedir();
+	if (p.startsWith("~/") || p.startsWith("~\\")) return path$1.join(os$1.homedir(), p.slice(2));
+	return p;
+}
+const requestSandboxAccessTool = createTool({
+	id: "request_access",
+	description: `Request permission to access a directory outside the current project. Use this when you need to read or write files in a directory that is not within the project root. The user will be prompted to approve or deny the request.`,
+	inputSchema: z.object({
+		path: z.string().min(1).describe("The absolute path to the directory you need access to."),
+		reason: z.string().min(1).describe("Brief explanation of why you need access to this directory.")
+	}),
+	suspendSchema: z.object({
+		kind: z.literal("sandbox_access_request"),
+		path: z.string(),
+		reason: z.string()
+	}),
+	resumeSchema: z.union([z.string(), z.array(z.string())]),
+	execute: async ({ path: requestedPath, reason }, context) => {
+		try {
+			const agentControllerCtx = context?.requestContext?.get("controller");
+			const expanded = expandTilde(requestedPath);
+			const absolutePath = path$1.isAbsolute(expanded) ? expanded : path$1.resolve(process.cwd(), expanded);
+			if (isPathAllowed(absolutePath, process.cwd(), getAllowedPathsFromContext(context))) return {
+				content: `Access already granted: "${absolutePath}" is within the project root or allowed paths.`,
+				isError: false
+			};
+			const suspend = context?.agent?.suspend ?? context?.suspend;
+			const resumeData = context?.agent?.resumeData ?? context?.resumeData;
+			if (resumeData === void 0) {
+				if (!suspend) return {
+					content: `Cannot request sandbox access: interactive context not available. The user should manually run /sandbox add ${absolutePath}`,
+					isError: true
+				};
+				await suspend({
+					kind: "sandbox_access_request",
+					path: absolutePath,
+					reason
+				});
+				return;
+			}
+			const answerText = Array.isArray(resumeData) ? resumeData.join(", ") : String(resumeData);
+			if (answerText.toLowerCase().startsWith("y") || answerText.toLowerCase() === "approve") {
+				const currentAllowed = (agentControllerCtx?.getState())?.sandboxAllowedPaths ?? [];
+				const nextAllowed = currentAllowed.includes(absolutePath) ? currentAllowed : [...currentAllowed, absolutePath];
+				if (!currentAllowed.includes(absolutePath)) await agentControllerCtx?.setState({ sandboxAllowedPaths: nextAllowed });
+				const fs = agentControllerCtx?.workspace?.filesystem ?? context?.workspace?.filesystem;
+				if (fs instanceof LocalFilesystem) fs.setAllowedPaths((prev) => [...prev, absolutePath]);
+				return {
+					content: `Access granted: "${absolutePath}" has been added to allowed paths. You can now access files in this directory.`,
+					isError: false
+				};
+			} else return {
+				content: `Access denied: The user declined access to "${absolutePath}".`,
+				isError: false
+			};
+		} catch (error) {
+			return {
+				content: `Failed to request sandbox access: ${error instanceof Error ? error.message : "Unknown error"}`,
+				isError: true
+			};
+		}
+	}
+});
+//#endregion
+export { requestSandboxAccessTool };
+
+//# sourceMappingURL=request-sandbox-access.js.map

package/dist/tools/request-sandbox-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-sandbox-access.js","names":["os","path"],"sources":["../../src/tools/request-sandbox-access.ts"],"sourcesContent":["/**\n * request_access tool — requests permission to access a directory outside the project root.\n * The user can approve or deny the request via TUI dialog.\n */\n\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport { createTool } from '@mastra/core/tools';\nimport { LocalFilesystem } from '@mastra/core/workspace';\nimport { z } from 'zod';\nimport type { MastraCodeState } from '../schema.js';\nimport { isPathAllowed, getAllowedPathsFromContext } from './utils.js';\n\nfunction expandTilde(p: string): string {\n  if (p === '~') return os.homedir();\n  if (p.startsWith('~/') || p.startsWith('~\\\\')) return path.join(os.homedir(), p.slice(2));\n  return p;\n}\n\ntype RequestSandboxAccessInput = {\n  path: string;\n  reason: string;\n};\n\nconst requestSandboxAccessInputSchema = z.object({\n  path: z.string().min(1).describe('The absolute path to the directory you need access to.'),\n  reason: z.string().min(1).describe('Brief explanation of why you need access to this directory.'),\n});\n\nexport const requestSandboxAccessTool = createTool({\n  id: 'request_access',\n  description: `Request permission to access a directory outside the current project. Use this when you need to read or write files in a directory that is not within the project root. The user will be prompted to approve or deny the request.`,\n  inputSchema: requestSandboxAccessInputSchema,\n  suspendSchema: z.object({\n    kind: z.literal('sandbox_access_request'),\n    path: z.string(),\n    reason: z.string(),\n  }),\n  resumeSchema: z.union([z.string(), z.array(z.string())]),\n  execute: async ({ path: requestedPath, reason }: RequestSandboxAccessInput, context: any) => {\n    try {\n      const agentControllerCtx = context?.requestContext?.get('controller') as\n        | AgentControllerRequestContext<MastraCodeState>\n        | undefined;\n\n      // Resolve to absolute path (expand ~ first since Node path APIs don't handle it)\n      const expanded = expandTilde(requestedPath);\n      const absolutePath = path.isAbsolute(expanded) ? expanded : path.resolve(process.cwd(), expanded);\n\n      // Check if already allowed\n      const projectRoot = process.cwd();\n      const allowedPaths = getAllowedPathsFromContext(context);\n      if (isPathAllowed(absolutePath, projectRoot, allowedPaths)) {\n        return {\n          content: `Access already granted: \"${absolutePath}\" is within the project root or allowed paths.`,\n          isError: false,\n        };\n      }\n\n      const suspend = context?.agent?.suspend ?? context?.suspend;\n      const resumeData = context?.agent?.resumeData ?? context?.resumeData;\n\n      // First pass: pause via the native tool-suspension primitive so the host can\n      // prompt the user. The suspend payload carries the request details; the host\n      // resumes with the user's answer as resume data.\n      if (resumeData === undefined) {\n        if (!suspend) {\n          return {\n            content: `Cannot request sandbox access: interactive context not available. The user should manually run /sandbox add ${absolutePath}`,\n            isError: true,\n          };\n        }\n        await suspend({ kind: 'sandbox_access_request', path: absolutePath, reason });\n        return;\n      }\n\n      const answerText = Array.isArray(resumeData) ? resumeData.join(', ') : String(resumeData);\n      const approved = answerText.toLowerCase().startsWith('y') || answerText.toLowerCase() === 'approve';\n      if (approved) {\n        // Persist to controller state first (and await it) so the value is\n        // committed before the next tool call re-derives the workspace's\n        // allowed paths from state. The workspace factory rebuilds the\n        // filesystem allowlist from `sandboxAllowedPaths` on every call\n        // (getDynamicWorkspace), so an unawaited setState would let that\n        // rebuild clobber the in-turn widen below before the grant lands.\n        const controllerState = agentControllerCtx?.getState();\n        const currentAllowed = (controllerState?.sandboxAllowedPaths as string[] | undefined) ?? [];\n        const nextAllowed = currentAllowed.includes(absolutePath) ? currentAllowed : [...currentAllowed, absolutePath];\n        if (!currentAllowed.includes(absolutePath)) {\n          await agentControllerCtx?.setState({\n            sandboxAllowedPaths: nextAllowed,\n          });\n        }\n\n        // Also update the live workspace filesystem immediately so tools in\n        // the same turn (e.g. `view`) can access the path without waiting for\n        // a fresh workspace build. The resolved workspace is carried on the\n        // controller request context — the tool-execution context does not expose\n        // it — so read the filesystem from there.\n        const fs = agentControllerCtx?.workspace?.filesystem ?? context?.workspace?.filesystem;\n        if (fs instanceof LocalFilesystem) {\n          fs.setAllowedPaths((prev: readonly string[]) => [...prev, absolutePath]);\n        }\n\n        return {\n          content: `Access granted: \"${absolutePath}\" has been added to allowed paths. You can now access files in this directory.`,\n          isError: false,\n        };\n      } else {\n        return {\n          content: `Access denied: The user declined access to \"${absolutePath}\".`,\n          isError: false,\n        };\n      }\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : 'Unknown error';\n      return {\n        content: `Failed to request sandbox access: ${msg}`,\n        isError: true,\n      };\n    }\n  },\n} as any);\n"],"mappings":";;;;;;;;;;;AAcA,SAAS,YAAY,GAAmB;CACtC,IAAI,MAAM,KAAK,OAAOA,KAAG,QAAQ;CACjC,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,KAAK,GAAG,OAAOC,OAAK,KAAKD,KAAG,QAAQ,GAAG,EAAE,MAAM,CAAC,CAAC;CACxF,OAAO;AACT;AAYA,MAAa,2BAA2B,WAAW;CACjD,IAAI;CACJ,aAAa;CACb,aARsC,EAAE,OAAO;EAC/C,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,wDAAwD;EACzF,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,6DAA6D;CAClG,CAKe;CACb,eAAe,EAAE,OAAO;EACtB,MAAM,EAAE,QAAQ,wBAAwB;EACxC,MAAM,EAAE,OAAO;EACf,QAAQ,EAAE,OAAO;CACnB,CAAC;CACD,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD,SAAS,OAAO,EAAE,MAAM,eAAe,UAAqC,YAAiB;EAC3F,IAAI;GACF,MAAM,qBAAqB,SAAS,gBAAgB,IAAI,YAAY;GAKpE,MAAM,WAAW,YAAY,aAAa;GAC1C,MAAM,eAAeC,OAAK,WAAW,QAAQ,IAAI,WAAWA,OAAK,QAAQ,QAAQ,IAAI,GAAG,QAAQ;GAKhG,IAAI,cAAc,cAFE,QAAQ,IAEc,GADrB,2BAA2B,OACQ,CAAC,GACvD,OAAO;IACL,SAAS,4BAA4B,aAAa;IAClD,SAAS;GACX;GAGF,MAAM,UAAU,SAAS,OAAO,WAAW,SAAS;GACpD,MAAM,aAAa,SAAS,OAAO,cAAc,SAAS;GAK1D,IAAI,eAAe,KAAA,GAAW;IAC5B,IAAI,CAAC,SACH,OAAO;KACL,SAAS,+GAA+G;KACxH,SAAS;IACX;IAEF,MAAM,QAAQ;KAAE,MAAM;KAA0B,MAAM;KAAc;IAAO,CAAC;IAC5E;GACF;GAEA,MAAM,aAAa,MAAM,QAAQ,UAAU,IAAI,WAAW,KAAK,IAAI,IAAI,OAAO,UAAU;GAExF,IADiB,WAAW,YAAY,CAAC,CAAC,WAAW,GAAG,KAAK,WAAW,YAAY,MAAM,WAC5E;IAQZ,MAAM,kBADkB,oBAAoB,SAAS,EAAA,EACZ,uBAAgD,CAAC;IAC1F,MAAM,cAAc,eAAe,SAAS,YAAY,IAAI,iBAAiB,CAAC,GAAG,gBAAgB,YAAY;IAC7G,IAAI,CAAC,eAAe,SAAS,YAAY,GACvC,MAAM,oBAAoB,SAAS,EACjC,qBAAqB,YACvB,CAAC;IAQH,MAAM,KAAK,oBAAoB,WAAW,cAAc,SAAS,WAAW;IAC5E,IAAI,cAAc,iBAChB,GAAG,iBAAiB,SAA4B,CAAC,GAAG,MAAM,YAAY,CAAC;IAGzE,OAAO;KACL,SAAS,oBAAoB,aAAa;KAC1C,SAAS;IACX;GACF,OACE,OAAO;IACL,SAAS,+CAA+C,aAAa;IACrE,SAAS;GACX;EAEJ,SAAS,OAAO;GAEd,OAAO;IACL,SAAS,qCAFC,iBAAiB,QAAQ,MAAM,UAAU;IAGnD,SAAS;GACX;EACF;CACF;AACF,CAAQ"}

package/dist/tools/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Check whether `targetPath` falls inside `projectRoot` or any of the
+ * additional `allowedPaths`.  All arguments are expected to be absolute.
+ *
+ * Returns `true` when access should be **allowed**.
+ */
+export declare function isPathAllowed(targetPath: string, projectRoot: string, allowedPaths?: string[]): boolean;
+/**
+ * Read allowed paths from the Mastra controller runtime context.
+ * Combines skill paths (computed dynamically from projectPath and configDir)
+ * with user-approved sandbox paths from controller state so that both parent
+ * and subagent tools have the same access.
+ * Returns default skill paths when the context is unavailable (e.g. in tests).
+ */
+export declare function getAllowedPathsFromContext(toolContext: {
+    requestContext?: {
+        get: (key: string) => unknown;
+    };
+} | undefined): string[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/tools/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,OAAO,CAK3G;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE;IAAE,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,GAC9E,MAAM,EAAE,CAgBV"}

package/dist/tools/utils.js

@@ -0,0 +1,32 @@
+import "../constants.js";
+import { buildSkillPaths } from "../agents/workspace.js";
+import * as path$1 from "path";
+//#region src/tools/utils.ts
+/**
+* Check whether `targetPath` falls inside `projectRoot` or any of the
+* additional `allowedPaths`.  All arguments are expected to be absolute.
+*
+* Returns `true` when access should be **allowed**.
+*/
+function isPathAllowed(targetPath, projectRoot, allowedPaths = []) {
+	const resolved = path$1.resolve(targetPath);
+	return [projectRoot, ...allowedPaths].map((p) => path$1.resolve(p)).some((root) => resolved === root || resolved.startsWith(root + path$1.sep));
+}
+/**
+* Read allowed paths from the Mastra controller runtime context.
+* Combines skill paths (computed dynamically from projectPath and configDir)
+* with user-approved sandbox paths from controller state so that both parent
+* and subagent tools have the same access.
+* Returns default skill paths when the context is unavailable (e.g. in tests).
+*/
+function getAllowedPathsFromContext(toolContext) {
+	const agentControllerCtx = toolContext?.requestContext?.get("controller");
+	const state = agentControllerCtx?.getState?.() ?? agentControllerCtx?.session?.state?.get?.();
+	const skillPaths = buildSkillPaths(state?.projectPath ? path$1.resolve(state.projectPath) : process.cwd(), state?.configDir ?? ".mastracode");
+	const sandboxPaths = state?.sandboxAllowedPaths ?? [];
+	return [...skillPaths, ...sandboxPaths];
+}
+//#endregion
+export { getAllowedPathsFromContext, isPathAllowed };
+
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":["path"],"sources":["../../src/tools/utils.ts"],"sourcesContent":["import * as path from 'node:path';\nimport { buildSkillPaths } from '../agents/workspace.js';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\n\n/**\n * Check whether `targetPath` falls inside `projectRoot` or any of the\n * additional `allowedPaths`.  All arguments are expected to be absolute.\n *\n * Returns `true` when access should be **allowed**.\n */\nexport function isPathAllowed(targetPath: string, projectRoot: string, allowedPaths: string[] = []): boolean {\n  const resolved = path.resolve(targetPath);\n  const roots = [projectRoot, ...allowedPaths].map(p => path.resolve(p));\n\n  return roots.some(root => resolved === root || resolved.startsWith(root + path.sep));\n}\n\n/**\n * Read allowed paths from the Mastra controller runtime context.\n * Combines skill paths (computed dynamically from projectPath and configDir)\n * with user-approved sandbox paths from controller state so that both parent\n * and subagent tools have the same access.\n * Returns default skill paths when the context is unavailable (e.g. in tests).\n */\nexport function getAllowedPathsFromContext(\n  toolContext: { requestContext?: { get: (key: string) => unknown } } | undefined,\n): string[] {\n  const agentControllerCtx = toolContext?.requestContext?.get('controller') as\n    | {\n        getState?: () => { sandboxAllowedPaths?: string[]; projectPath?: string; configDir?: string };\n        session?: {\n          state?: { get?: () => { sandboxAllowedPaths?: string[]; projectPath?: string; configDir?: string } };\n        };\n      }\n    | undefined;\n  const state = agentControllerCtx?.getState?.() ?? agentControllerCtx?.session?.state?.get?.();\n  const projectPath = state?.projectPath ? path.resolve(state.projectPath) : process.cwd();\n  const configDir = state?.configDir ?? DEFAULT_CONFIG_DIR;\n  const skillPaths = buildSkillPaths(projectPath, configDir);\n  const sandboxPaths = state?.sandboxAllowedPaths ?? [];\n\n  return [...skillPaths, ...sandboxPaths];\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,cAAc,YAAoB,aAAqB,eAAyB,CAAC,GAAY;CAC3G,MAAM,WAAWA,OAAK,QAAQ,UAAU;CAGxC,OAFc,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC,KAAI,MAAKA,OAAK,QAAQ,CAAC,CAEzD,CAAC,CAAC,MAAK,SAAQ,aAAa,QAAQ,SAAS,WAAW,OAAOA,OAAK,GAAG,CAAC;AACrF;;;;;;;;AASA,SAAgB,2BACd,aACU;CACV,MAAM,qBAAqB,aAAa,gBAAgB,IAAI,YAAY;CAQxE,MAAM,QAAQ,oBAAoB,WAAW,KAAK,oBAAoB,SAAS,OAAO,MAAM;CAG5F,MAAM,aAAa,gBAFC,OAAO,cAAcA,OAAK,QAAQ,MAAM,WAAW,IAAI,QAAQ,IAAI,GACrE,OAAO,aAAA,aACgC;CACzD,MAAM,eAAe,OAAO,uBAAuB,CAAC;CAEpD,OAAO,CAAC,GAAG,YAAY,GAAG,YAAY;AACxC"}

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 { createParallelExtractTool, createParallelSearchTool } from "@mastra/parallel";
+import { createTavilyExtractTool, createTavilySearchTool } from "@mastra/tavily";
+import { z } from "zod";
+//#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"}