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

package/dist/agents/subagents/plan.js

@@ -0,0 +1,18 @@
+import { MC_TOOLS } from "../../tool-names.js";
+//#region src/agents/subagents/plan.ts
+const planSubagent = {
+	id: "plan",
+	name: "Plan",
+	description: "Investigate a task and propose an implementation plan without modifying files.",
+	instructions: `You are a read-only planning agent. Inspect the relevant code using view, find_files, search_content, and file_stat before proposing changes. Do not modify files or run shell commands. Return a concise implementation plan with file paths, ordered steps, risks, and concrete verification criteria. State assumptions and unresolved questions.`,
+	allowedWorkspaceTools: [
+		MC_TOOLS.VIEW,
+		MC_TOOLS.FIND_FILES,
+		MC_TOOLS.SEARCH_CONTENT,
+		MC_TOOLS.FILE_STAT
+	]
+};
+//#endregion
+export { planSubagent };
+
+//# sourceMappingURL=plan.js.map

package/dist/agents/subagents/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","names":[],"sources":["../../../src/agents/subagents/plan.ts"],"sourcesContent":["import type { AgentControllerSubagent } from '@mastra/core/agent-controller';\nimport { MC_TOOLS } from '../../tool-names.js';\n\nexport const planSubagent: AgentControllerSubagent = {\n  id: 'plan',\n  name: 'Plan',\n  description: 'Investigate a task and propose an implementation plan without modifying files.',\n  instructions: `You are a read-only planning agent. Inspect the relevant code using view, find_files, search_content, and file_stat before proposing changes. Do not modify files or run shell commands. Return a concise implementation plan with file paths, ordered steps, risks, and concrete verification criteria. State assumptions and unresolved questions.`,\n  allowedWorkspaceTools: [MC_TOOLS.VIEW, MC_TOOLS.FIND_FILES, MC_TOOLS.SEARCH_CONTENT, MC_TOOLS.FILE_STAT],\n};\n"],"mappings":";;AAGA,MAAa,eAAwC;CACnD,IAAI;CACJ,MAAM;CACN,aAAa;CACb,cAAc;CACd,uBAAuB;EAAC,SAAS;EAAM,SAAS;EAAY,SAAS;EAAgB,SAAS;CAAS;AACzG"}

package/dist/agents/thread-caveman-state.d.ts

@@ -0,0 +1,17 @@
+import type { Session } from '@mastra/core/agent-controller';
+/**
+ * Wires MastraCode-owned state into controller thread events so it persists
+ * per-thread and new threads inherit the most recent value.
+ *
+ * This is intentionally implemented in mastracode rather than core: these
+ * settings are mastracode-specific concepts, so persistence stays scoped to
+ * the host.
+ */
+export declare function attachOMThreadStatePersistence(session: Session<Record<string, unknown>>): void;
+/**
+ * Eagerly restores MastraCode-owned OM settings for the currently-selected
+ * thread. Called once at TUI startup after the initial thread is selected,
+ * since the subscription set up later misses the startup `thread_changed` event.
+ */
+export declare function restoreOMThreadStateForCurrentThread(session: Session<Record<string, unknown>>): Promise<void>;
+//# sourceMappingURL=thread-caveman-state.d.ts.map

package/dist/agents/thread-caveman-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-caveman-state.d.ts","sourceRoot":"","sources":["../../src/agents/thread-caveman-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAkGpF;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAqB9F;AAED;;;;GAIG;AACH,wBAAsB,oCAAoC,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAInH"}

package/dist/agents/thread-caveman-state.js

@@ -0,0 +1,107 @@
+//#region src/agents/thread-caveman-state.ts
+const THREAD_STATE_SETTINGS = [
+	{
+		key: "cavemanObservations",
+		isValid: (value) => typeof value === "boolean",
+		seedMissingFromCurrentState: true
+	},
+	{
+		key: "observeAttachments",
+		isValid: (value) => value === "auto" || typeof value === "boolean",
+		seedMissingFromCurrentState: true
+	},
+	{
+		key: "sandboxAllowedPaths",
+		isValid: (value) => Array.isArray(value) && value.every((item) => typeof item === "string"),
+		clearValueWhenMissing: []
+	}
+];
+function getStateValue(session, setting) {
+	const value = session.state.get()[setting.key];
+	return setting.isValid(value) ? value : void 0;
+}
+function stateValuesEqual(left, right) {
+	if (Array.isArray(left) && Array.isArray(right)) return left.length === right.length && left.every((item, index) => item === right[index]);
+	return left === right;
+}
+async function findThread(session, threadId) {
+	return (await session.thread.list({ allResources: true })).find((t) => t.id === threadId);
+}
+/**
+* Restores MastraCode-owned per-thread state for the given thread:
+* - If the thread already has a valid value in metadata, mirror it into controller state.
+* - Otherwise, persist the current session.state value to the thread so future
+*   sessions see the user's last-selected setting.
+*/
+async function restoreSettingsForThread(session, threadId) {
+	const thread = await findThread(session, threadId);
+	if (session.thread.getId() !== threadId) return;
+	const updates = {};
+	const settingsToSeed = [];
+	for (const setting of THREAD_STATE_SETTINGS) {
+		const persisted = thread?.metadata?.[setting.key];
+		if (setting.isValid(persisted)) {
+			if (getStateValue(session, setting) !== persisted) updates[setting.key] = persisted;
+			continue;
+		}
+		if (setting.clearValueWhenMissing !== void 0) {
+			const current = getStateValue(session, setting);
+			if (current !== void 0 && !stateValuesEqual(current, setting.clearValueWhenMissing)) updates[setting.key] = setting.clearValueWhenMissing;
+			continue;
+		}
+		if (setting.seedMissingFromCurrentState) {
+			const current = getStateValue(session, setting);
+			if (current !== void 0) settingsToSeed.push({
+				key: setting.key,
+				value: current
+			});
+		}
+	}
+	if (Object.keys(updates).length > 0) {
+		if (session.thread.getId() !== threadId) return;
+		await session.state.set(updates);
+	}
+	for (const setting of settingsToSeed) {
+		if (session.thread.getId() !== threadId) return;
+		await session.thread.setSetting(setting);
+	}
+}
+/**
+* Wires MastraCode-owned state into controller thread events so it persists
+* per-thread and new threads inherit the most recent value.
+*
+* This is intentionally implemented in mastracode rather than core: these
+* settings are mastracode-specific concepts, so persistence stays scoped to
+* the host.
+*/
+function attachOMThreadStatePersistence(session) {
+	session.subscribe((event) => {
+		if (event.type === "thread_changed" || event.type === "thread_created") {
+			restoreSettingsForThread(session, event.type === "thread_changed" ? event.threadId : event.thread.id).catch(() => {});
+			return;
+		}
+		if (event.type === "state_changed") for (const setting of THREAD_STATE_SETTINGS) {
+			if (!event.changedKeys.includes(setting.key)) continue;
+			const value = event.state[setting.key];
+			if (!setting.isValid(value)) continue;
+			session.thread.setSetting({
+				key: setting.key,
+				value
+			}).catch(() => {});
+		}
+	});
+}
+/**
+* Eagerly restores MastraCode-owned OM settings for the currently-selected
+* thread. Called once at TUI startup after the initial thread is selected,
+* since the subscription set up later misses the startup `thread_changed` event.
+*/
+async function restoreOMThreadStateForCurrentThread(session) {
+	const threadId = session.thread.getId();
+	if (!threadId) return;
+	await restoreSettingsForThread(session, threadId);
+}
+//#endregion
+export { attachOMThreadStatePersistence, restoreOMThreadStateForCurrentThread };
+
+//# sourceMappingURL=thread-caveman-state.js.map

package/dist/agents/thread-caveman-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-caveman-state.js","names":[],"sources":["../../src/agents/thread-caveman-state.ts"],"sourcesContent":["import type { AgentControllerThread, Session } from '@mastra/core/agent-controller';\n\ninterface ThreadStateSetting {\n  key: string;\n  isValid(value: unknown): boolean;\n  seedMissingFromCurrentState?: boolean;\n  clearValueWhenMissing?: unknown;\n}\n\nconst THREAD_STATE_SETTINGS: ThreadStateSetting[] = [\n  {\n    key: 'cavemanObservations',\n    isValid: (value: unknown): value is boolean => typeof value === 'boolean',\n    seedMissingFromCurrentState: true,\n  },\n  {\n    key: 'observeAttachments',\n    isValid: (value: unknown): value is 'auto' | boolean => value === 'auto' || typeof value === 'boolean',\n    seedMissingFromCurrentState: true,\n  },\n  {\n    key: 'sandboxAllowedPaths',\n    isValid: (value: unknown): value is string[] =>\n      Array.isArray(value) && value.every(item => typeof item === 'string'),\n    clearValueWhenMissing: [],\n  },\n];\n\nfunction getStateValue(session: Session<Record<string, unknown>>, setting: ThreadStateSetting): unknown {\n  const value = session.state.get()[setting.key];\n  return setting.isValid(value) ? value : undefined;\n}\n\nfunction stateValuesEqual(left: unknown, right: unknown): boolean {\n  if (Array.isArray(left) && Array.isArray(right)) {\n    return left.length === right.length && left.every((item, index) => item === right[index]);\n  }\n  return left === right;\n}\n\nasync function findThread(\n  session: Session<Record<string, unknown>>,\n  threadId: string,\n): Promise<AgentControllerThread | undefined> {\n  const threads = await session.thread.list({ allResources: true });\n  return threads.find(t => t.id === threadId);\n}\n\n/**\n * Restores MastraCode-owned per-thread state for the given thread:\n * - If the thread already has a valid value in metadata, mirror it into controller state.\n * - Otherwise, persist the current session.state value to the thread so future\n *   sessions see the user's last-selected setting.\n */\nasync function restoreSettingsForThread(session: Session<Record<string, unknown>>, threadId: string): Promise<void> {\n  const thread = await findThread(session, threadId);\n  if (session.thread.getId() !== threadId) return;\n\n  const updates: Record<string, unknown> = {};\n  const settingsToSeed: Array<{ key: string; value: unknown }> = [];\n\n  for (const setting of THREAD_STATE_SETTINGS) {\n    const persisted = thread?.metadata?.[setting.key];\n\n    if (setting.isValid(persisted)) {\n      if (getStateValue(session, setting) !== persisted) {\n        updates[setting.key] = persisted;\n      }\n      continue;\n    }\n\n    if (setting.clearValueWhenMissing !== undefined) {\n      const current = getStateValue(session, setting);\n      if (current !== undefined && !stateValuesEqual(current, setting.clearValueWhenMissing)) {\n        updates[setting.key] = setting.clearValueWhenMissing;\n      }\n      continue;\n    }\n\n    if (setting.seedMissingFromCurrentState) {\n      const current = getStateValue(session, setting);\n      if (current !== undefined) {\n        settingsToSeed.push({ key: setting.key, value: current });\n      }\n    }\n  }\n\n  if (Object.keys(updates).length > 0) {\n    if (session.thread.getId() !== threadId) return;\n    await session.state.set(updates);\n  }\n\n  for (const setting of settingsToSeed) {\n    if (session.thread.getId() !== threadId) return;\n    await session.thread.setSetting(setting);\n  }\n}\n\n/**\n * Wires MastraCode-owned state into controller thread events so it persists\n * per-thread and new threads inherit the most recent value.\n *\n * This is intentionally implemented in mastracode rather than core: these\n * settings are mastracode-specific concepts, so persistence stays scoped to\n * the host.\n */\nexport function attachOMThreadStatePersistence(session: Session<Record<string, unknown>>): void {\n  session.subscribe(event => {\n    if (event.type === 'thread_changed' || event.type === 'thread_created') {\n      const threadId = event.type === 'thread_changed' ? event.threadId : event.thread.id;\n      void restoreSettingsForThread(session, threadId).catch(() => {\n        // Persistence is best-effort; don't crash the TUI if storage hiccups.\n      });\n      return;\n    }\n\n    if (event.type === 'state_changed') {\n      for (const setting of THREAD_STATE_SETTINGS) {\n        if (!event.changedKeys.includes(setting.key)) continue;\n        const value = event.state[setting.key];\n        if (!setting.isValid(value)) continue;\n        void session.thread.setSetting({ key: setting.key, value }).catch(() => {\n          // Persistence is best-effort; don't crash the TUI if storage hiccups.\n        });\n      }\n    }\n  });\n}\n\n/**\n * Eagerly restores MastraCode-owned OM settings for the currently-selected\n * thread. Called once at TUI startup after the initial thread is selected,\n * since the subscription set up later misses the startup `thread_changed` event.\n */\nexport async function restoreOMThreadStateForCurrentThread(session: Session<Record<string, unknown>>): Promise<void> {\n  const threadId = session.thread.getId();\n  if (!threadId) return;\n  await restoreSettingsForThread(session, threadId);\n}\n"],"mappings":"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"}

package/dist/agents/tool-availability.d.ts

@@ -0,0 +1,10 @@
+import type { WorkspaceToolHookContext, WorkspaceToolsConfig } from '@mastra/core/workspace';
+export declare function guardPlanModePlanFileWrites({ workspaceToolName, input, context }: WorkspaceToolHookContext): {
+    proceed: false;
+    output: string;
+} | undefined;
+export declare const MASTRACODE_WORKSPACE_TOOLS: WorkspaceToolsConfig;
+export declare const PLAN_MODE_AVAILABLE_TOOLS: readonly string[];
+export declare const EXPLORE_MODE_AVAILABLE_TOOLS: readonly string[];
+export declare const GOAL_JUDGE_READONLY_TOOLS: readonly string[];
+//# sourceMappingURL=tool-availability.d.ts.map

package/dist/agents/tool-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../../src/agents/tool-availability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AA4D7F,wBAAgB,2BAA2B,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,wBAAwB;;;cA0B1G;AAED,eAAO,MAAM,0BAA0B,EAAE,oBAKxC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAwBtD,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAUzD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAMtD,CAAC"}

package/dist/agents/tool-availability.js

@@ -0,0 +1,96 @@
+import { getLocalPlansRelativeDir, isPlanFilePath } from "../utils/plans.js";
+import { MC_TOOLS, TOOL_NAME_OVERRIDES } from "../tool-names.js";
+import { WORKSPACE_TOOLS } from "@mastra/core/workspace";
+//#region src/agents/tool-availability.ts
+const PLAN_MODE_WRITE_TOOL_NAMES = /* @__PURE__ */ new Set([WORKSPACE_TOOLS.FILESYSTEM.WRITE_FILE, WORKSPACE_TOOLS.FILESYSTEM.EDIT_FILE]);
+function getRequestContextValue(requestContext, key) {
+	if (!requestContext) return void 0;
+	if (typeof requestContext.get === "function") return requestContext.get(key);
+	return requestContext[key];
+}
+function getHarnessContext(context) {
+	const requestContext = context?.requestContext;
+	const harness = getRequestContextValue(requestContext, "harness");
+	return harness && typeof harness === "object" ? harness : void 0;
+}
+function getHarnessState(harness) {
+	const state = harness?.session?.state?.get?.();
+	return state && typeof state === "object" ? state : void 0;
+}
+function getHarnessModeId(harness) {
+	const modeId = harness?.session?.modeId ?? getHarnessState(harness)?.modeId;
+	return typeof modeId === "string" ? modeId : void 0;
+}
+function getHarnessProjectPath(harness) {
+	const projectPath = getHarnessState(harness)?.projectPath;
+	return typeof projectPath === "string" ? projectPath : void 0;
+}
+function getHarnessFactoryProjectId(harness) {
+	const factoryProjectId = getHarnessState(harness)?.factoryProjectId;
+	return typeof factoryProjectId === "string" ? factoryProjectId : void 0;
+}
+function getToolInputPath(input) {
+	const toolPath = input?.path;
+	return typeof toolPath === "string" ? toolPath : void 0;
+}
+function guardPlanModePlanFileWrites({ workspaceToolName, input, context }) {
+	if (!PLAN_MODE_WRITE_TOOL_NAMES.has(workspaceToolName)) return;
+	const harness = getHarnessContext(context);
+	if (getHarnessModeId(harness) !== "plan") return;
+	const planOptions = { factoryProjectId: getHarnessFactoryProjectId(harness) };
+	const planDirHint = `${getLocalPlansRelativeDir(planOptions)}/`;
+	const projectPath = getHarnessProjectPath(harness);
+	const inputPath = getToolInputPath(input);
+	if (!projectPath || !inputPath) return {
+		proceed: false,
+		output: `Plan mode can only write plan files inside ${planDirHint}.`
+	};
+	if (isPlanFilePath(projectPath, inputPath, planOptions)) return;
+	return {
+		proceed: false,
+		output: `Plan mode can only write plan files inside ${planDirHint}. Refusing to edit ${inputPath}.`
+	};
+}
+const MASTRACODE_WORKSPACE_TOOLS = {
+	...TOOL_NAME_OVERRIDES,
+	hooks: { beforeToolCall: guardPlanModePlanFileWrites }
+};
+const PLAN_MODE_AVAILABLE_TOOLS = [
+	MC_TOOLS.VIEW,
+	MC_TOOLS.FIND_FILES,
+	MC_TOOLS.SEARCH_CONTENT,
+	MC_TOOLS.FILE_STAT,
+	MC_TOOLS.LSP_INSPECT,
+	MC_TOOLS.WRITE_FILE,
+	MC_TOOLS.STRING_REPLACE_LSP,
+	"ask_user",
+	"submit_plan",
+	"task_write",
+	"task_update",
+	"task_complete",
+	"task_check",
+	MC_TOOLS.NOTIFICATION_INBOX,
+	"list-workflows",
+	"get-workflow"
+];
+const EXPLORE_MODE_AVAILABLE_TOOLS = [
+	MC_TOOLS.VIEW,
+	MC_TOOLS.FIND_FILES,
+	MC_TOOLS.SEARCH_CONTENT,
+	MC_TOOLS.FILE_STAT,
+	MC_TOOLS.LSP_INSPECT,
+	"ask_user",
+	"list-workflows",
+	"get-workflow"
+];
+const GOAL_JUDGE_READONLY_TOOLS = [
+	MC_TOOLS.VIEW,
+	MC_TOOLS.SEARCH_CONTENT,
+	MC_TOOLS.FIND_FILES,
+	MC_TOOLS.FILE_STAT,
+	MC_TOOLS.LSP_INSPECT
+];
+//#endregion
+export { EXPLORE_MODE_AVAILABLE_TOOLS, GOAL_JUDGE_READONLY_TOOLS, MASTRACODE_WORKSPACE_TOOLS, PLAN_MODE_AVAILABLE_TOOLS, guardPlanModePlanFileWrites };
+
+//# sourceMappingURL=tool-availability.js.map

package/dist/agents/tool-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-availability.js","names":[],"sources":["../../src/agents/tool-availability.ts"],"sourcesContent":["import { WORKSPACE_TOOLS } from '@mastra/core/workspace';\nimport type { WorkspaceToolHookContext, WorkspaceToolsConfig } from '@mastra/core/workspace';\nimport { MC_TOOLS, TOOL_NAME_OVERRIDES } from '../tool-names.js';\nimport { getLocalPlansRelativeDir, isPlanFilePath } from '../utils/plans.js';\n\nconst PLAN_MODE_WRITE_TOOL_NAMES = new Set<string>([\n  WORKSPACE_TOOLS.FILESYSTEM.WRITE_FILE,\n  WORKSPACE_TOOLS.FILESYSTEM.EDIT_FILE,\n]);\n\nfunction getRequestContextValue(requestContext: unknown, key: string): unknown {\n  if (!requestContext) return undefined;\n  if (typeof (requestContext as { get?: unknown }).get === 'function') {\n    return (requestContext as { get: (key: string) => unknown }).get(key);\n  }\n  return (requestContext as Record<string, unknown>)[key];\n}\n\n/**\n * Subset of the real `HarnessRequestContext` shape (see\n * packages/core/src/harness/types.ts). The mode is a string property\n * (`session.modeId`) and live state is read via `session.state.get()`.\n */\ninterface PlanModeGuardHarness {\n  session?: {\n    modeId?: unknown;\n    state?: { get?: () => unknown };\n  };\n}\n\nfunction getHarnessContext(context: unknown): PlanModeGuardHarness | undefined {\n  const requestContext = (context as { requestContext?: unknown } | undefined)?.requestContext;\n  const harness = getRequestContextValue(requestContext, 'harness');\n  return harness && typeof harness === 'object' ? (harness as PlanModeGuardHarness) : undefined;\n}\n\nfunction getHarnessState(harness: PlanModeGuardHarness | undefined): Record<string, unknown> | undefined {\n  const state = harness?.session?.state?.get?.();\n  return state && typeof state === 'object' ? (state as Record<string, unknown>) : undefined;\n}\n\nfunction getHarnessModeId(harness: PlanModeGuardHarness | undefined): string | undefined {\n  const modeId = harness?.session?.modeId ?? getHarnessState(harness)?.modeId;\n  return typeof modeId === 'string' ? modeId : undefined;\n}\n\nfunction getHarnessProjectPath(harness: PlanModeGuardHarness | undefined): string | undefined {\n  const projectPath = getHarnessState(harness)?.projectPath;\n  return typeof projectPath === 'string' ? projectPath : undefined;\n}\n\nfunction getHarnessFactoryProjectId(harness: PlanModeGuardHarness | undefined): string | undefined {\n  const factoryProjectId = getHarnessState(harness)?.factoryProjectId;\n  return typeof factoryProjectId === 'string' ? factoryProjectId : undefined;\n}\n\nfunction getToolInputPath(input: unknown): string | undefined {\n  const toolPath = (input as { path?: unknown } | undefined)?.path;\n  return typeof toolPath === 'string' ? toolPath : undefined;\n}\n\nexport function guardPlanModePlanFileWrites({ workspaceToolName, input, context }: WorkspaceToolHookContext) {\n  if (!PLAN_MODE_WRITE_TOOL_NAMES.has(workspaceToolName)) return;\n\n  const harness = getHarnessContext(context);\n  if (getHarnessModeId(harness) !== 'plan') return;\n\n  const factoryProjectId = getHarnessFactoryProjectId(harness);\n  const planOptions = { factoryProjectId };\n  const planDirHint = `${getLocalPlansRelativeDir(planOptions)}/`;\n  const projectPath = getHarnessProjectPath(harness);\n  const inputPath = getToolInputPath(input);\n  if (!projectPath || !inputPath) {\n    return {\n      proceed: false as const,\n      output: `Plan mode can only write plan files inside ${planDirHint}.`,\n    };\n  }\n\n  // Plan mode may write any `.md` file directly inside the configured plan directory,\n  // but nothing else in the project.\n  if (isPlanFilePath(projectPath, inputPath, planOptions)) return;\n\n  return {\n    proceed: false as const,\n    output: `Plan mode can only write plan files inside ${planDirHint}. Refusing to edit ${inputPath}.`,\n  };\n}\n\nexport const MASTRACODE_WORKSPACE_TOOLS: WorkspaceToolsConfig = {\n  ...TOOL_NAME_OVERRIDES,\n  hooks: {\n    beforeToolCall: guardPlanModePlanFileWrites,\n  },\n};\n\nexport const PLAN_MODE_AVAILABLE_TOOLS: readonly string[] = [\n  // Read-only exploration tools\n  MC_TOOLS.VIEW,\n  MC_TOOLS.FIND_FILES,\n  MC_TOOLS.SEARCH_CONTENT,\n  MC_TOOLS.FILE_STAT,\n  MC_TOOLS.LSP_INSPECT,\n  // Plan file writing. Tool hooks enforce that these can only write `.md`\n  // files inside the session's configured plan directory while in plan mode.\n  MC_TOOLS.WRITE_FILE,\n  MC_TOOLS.STRING_REPLACE_LSP,\n  // Plan delivery tools\n  'ask_user',\n  'submit_plan',\n  // Task tools for plan-stage tracking\n  'task_write',\n  'task_update',\n  'task_complete',\n  'task_check',\n  // Notification access\n  MC_TOOLS.NOTIFICATION_INBOX,\n  // Read-only workflow inspection (no create/run/delete in plan mode).\n  'list-workflows',\n  'get-workflow',\n];\n\nexport const EXPLORE_MODE_AVAILABLE_TOOLS: readonly string[] = [\n  MC_TOOLS.VIEW,\n  MC_TOOLS.FIND_FILES,\n  MC_TOOLS.SEARCH_CONTENT,\n  MC_TOOLS.FILE_STAT,\n  MC_TOOLS.LSP_INSPECT,\n  'ask_user',\n  // Read-only workflow inspection (no create/run/delete in fast mode either).\n  'list-workflows',\n  'get-workflow',\n];\n\nexport const GOAL_JUDGE_READONLY_TOOLS: readonly string[] = [\n  MC_TOOLS.VIEW,\n  MC_TOOLS.SEARCH_CONTENT,\n  MC_TOOLS.FIND_FILES,\n  MC_TOOLS.FILE_STAT,\n  MC_TOOLS.LSP_INSPECT,\n];\n"],"mappings":";;;;AAKA,MAAM,6CAA6B,IAAI,IAAY,CACjD,gBAAgB,WAAW,YAC3B,gBAAgB,WAAW,SAC7B,CAAC;AAED,SAAS,uBAAuB,gBAAyB,KAAsB;CAC7E,IAAI,CAAC,gBAAgB,OAAO,KAAA;CAC5B,IAAI,OAAQ,eAAqC,QAAQ,YACvD,OAAQ,eAAqD,IAAI,GAAG;CAEtE,OAAQ,eAA2C;AACrD;AAcA,SAAS,kBAAkB,SAAoD;CAC7E,MAAM,iBAAkB,SAAsD;CAC9E,MAAM,UAAU,uBAAuB,gBAAgB,SAAS;CAChE,OAAO,WAAW,OAAO,YAAY,WAAY,UAAmC,KAAA;AACtF;AAEA,SAAS,gBAAgB,SAAgF;CACvG,MAAM,QAAQ,SAAS,SAAS,OAAO,MAAM;CAC7C,OAAO,SAAS,OAAO,UAAU,WAAY,QAAoC,KAAA;AACnF;AAEA,SAAS,iBAAiB,SAA+D;CACvF,MAAM,SAAS,SAAS,SAAS,UAAU,gBAAgB,OAAO,CAAC,EAAE;CACrE,OAAO,OAAO,WAAW,WAAW,SAAS,KAAA;AAC/C;AAEA,SAAS,sBAAsB,SAA+D;CAC5F,MAAM,cAAc,gBAAgB,OAAO,CAAC,EAAE;CAC9C,OAAO,OAAO,gBAAgB,WAAW,cAAc,KAAA;AACzD;AAEA,SAAS,2BAA2B,SAA+D;CACjG,MAAM,mBAAmB,gBAAgB,OAAO,CAAC,EAAE;CACnD,OAAO,OAAO,qBAAqB,WAAW,mBAAmB,KAAA;AACnE;AAEA,SAAS,iBAAiB,OAAoC;CAC5D,MAAM,WAAY,OAA0C;CAC5D,OAAO,OAAO,aAAa,WAAW,WAAW,KAAA;AACnD;AAEA,SAAgB,4BAA4B,EAAE,mBAAmB,OAAO,WAAqC;CAC3G,IAAI,CAAC,2BAA2B,IAAI,iBAAiB,GAAG;CAExD,MAAM,UAAU,kBAAkB,OAAO;CACzC,IAAI,iBAAiB,OAAO,MAAM,QAAQ;CAG1C,MAAM,cAAc,EAAE,kBADG,2BAA2B,OACf,EAAE;CACvC,MAAM,cAAc,GAAG,yBAAyB,WAAW,EAAE;CAC7D,MAAM,cAAc,sBAAsB,OAAO;CACjD,MAAM,YAAY,iBAAiB,KAAK;CACxC,IAAI,CAAC,eAAe,CAAC,WACnB,OAAO;EACL,SAAS;EACT,QAAQ,8CAA8C,YAAY;CACpE;CAKF,IAAI,eAAe,aAAa,WAAW,WAAW,GAAG;CAEzD,OAAO;EACL,SAAS;EACT,QAAQ,8CAA8C,YAAY,qBAAqB,UAAU;CACnG;AACF;AAEA,MAAa,6BAAmD;CAC9D,GAAG;CACH,OAAO,EACL,gBAAgB,4BAClB;AACF;AAEA,MAAa,4BAA+C;CAE1D,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CAGT,SAAS;CACT,SAAS;CAET;CACA;CAEA;CACA;CACA;CACA;CAEA,SAAS;CAET;CACA;AACF;AAEA,MAAa,+BAAkD;CAC7D,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT;CAEA;CACA;AACF;AAEA,MAAa,4BAA+C;CAC1D,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;AACX"}

package/dist/agents/tools.d.ts

@@ -0,0 +1,36 @@
+import type { ToolsInput } from '@mastra/core/agent';
+import { NotificationsStorage } from '@mastra/core/notifications';
+import type { CreateNotificationInput, ListDueNotificationsInput, ListNotificationsInput, UpdateNotificationInput } from '@mastra/core/notifications';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { MastraCompositeStore } from '@mastra/core/storage';
+import type { ToolAfterHookContext, ToolHooks } from '@mastra/core/tools';
+import type { HookManager } from '../hooks/index.js';
+import type { McpManager } from '../mcp/index.js';
+/** Minimal shape for tools passed to createDynamicTools. */
+export type ToolLike = {
+    execute?: (...args: any[]) => Promise<unknown> | unknown;
+} & Record<string, any>;
+export declare class LazyNotificationsStorage extends NotificationsStorage {
+    private readonly storage;
+    constructor(storage: MastraCompositeStore);
+    private getNotificationsStorage;
+    createNotification(input: CreateNotificationInput): Promise<import("@mastra/core/notifications").NotificationRecord>;
+    listNotifications(input: ListNotificationsInput): Promise<import("@mastra/core/notifications").NotificationRecord[]>;
+    listDueNotifications(input: ListDueNotificationsInput): Promise<import("@mastra/core/notifications").NotificationRecord[]>;
+    getNotification(input: {
+        threadId: string;
+        id: string;
+    }): Promise<import("@mastra/core/notifications").NotificationRecord | null>;
+    updateNotification(input: UpdateNotificationInput): Promise<import("@mastra/core/notifications").NotificationRecord>;
+    dangerouslyClearAll(): Promise<void>;
+}
+export type PostToolObserver = (context: ToolAfterHookContext) => void | Promise<void>;
+export declare function createToolHooks(hookManager?: HookManager, postToolObserver?: PostToolObserver): ToolHooks | undefined;
+type DynamicToolProvider = Record<string, ToolLike | undefined> | ((ctx: {
+    requestContext: RequestContext;
+}) => Record<string, ToolLike | undefined> | Promise<Record<string, ToolLike | undefined>>);
+export declare function createDynamicTools(mcpManager?: McpManager, extraTools?: DynamicToolProvider, disabledTools?: string[], storage?: MastraCompositeStore, pluginTools?: Record<string, ToolLike>): ({ requestContext, }: {
+    requestContext: RequestContext;
+}) => ToolsInput | Promise<ToolsInput>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAA+B,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWlD,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC1D,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAExB,qBAAa,wBAAyB,SAAQ,oBAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;YAI5C,uBAAuB;IAQ/B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;IAIjD,iBAAiB,CAAC,KAAK,EAAE,sBAAsB;IAI/C,oBAAoB,CAAC,KAAK,EAAE,yBAAyB;IAIrD,eAAe,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAIvD,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;IAIjD,mBAAmB;CAG1B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvF,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAoCrH;AAED,KAAK,mBAAmB,GACpB,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GACpC,CAAC,CAAC,GAAG,EAAE;IACL,cAAc,EAAE,cAAc,CAAC;CAChC,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAEhG,wBAAgB,kBAAkB,CAChC,UAAU,CAAC,EAAE,UAAU,EACvB,UAAU,CAAC,EAAE,mBAAmB,EAChC,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAEN,qBAE7B;IACD,cAAc,EAAE,cAAc,CAAC;CAChC,KAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA6FrC"}

package/dist/agents/tools.js

@@ -0,0 +1,117 @@
+import { MC_TOOLS } from "../tool-names.js";
+import { createConfiguredWebTools } from "../tools/web-search.js";
+import { requestSandboxAccessTool } from "../tools/request-sandbox-access.js";
+import "../tools/index.js";
+import { createWorkflowTool } from "../tools/workflows/create-workflow.js";
+import { deleteWorkflowTool } from "../tools/workflows/delete-workflow.js";
+import { getWorkflowTool } from "../tools/workflows/get-workflow.js";
+import { listWorkflowsTool } from "../tools/workflows/list-workflows.js";
+import { runWorkflowTool } from "../tools/workflows/run-workflow.js";
+import { WORKFLOW_MANAGEMENT_TOOL_IDS } from "../tools/workflows/tool-ids.js";
+import { createOpenAI } from "@ai-sdk/openai";
+import { NotificationsStorage, createNotificationInboxTool } from "@mastra/core/notifications";
+import { createAnthropic } from "@ai-sdk/anthropic";
+//#region src/agents/tools.ts
+var LazyNotificationsStorage = class extends NotificationsStorage {
+	storage;
+	constructor(storage) {
+		super();
+		this.storage = storage;
+	}
+	async getNotificationsStorage() {
+		const notifications = await this.storage.getStore("notifications");
+		if (!notifications) throw new Error("notification_inbox requires a notifications storage domain");
+		return notifications;
+	}
+	async createNotification(input) {
+		return (await this.getNotificationsStorage()).createNotification(input);
+	}
+	async listNotifications(input) {
+		return (await this.getNotificationsStorage()).listNotifications(input);
+	}
+	async listDueNotifications(input) {
+		return (await this.getNotificationsStorage()).listDueNotifications(input);
+	}
+	async getNotification(input) {
+		return (await this.getNotificationsStorage()).getNotification(input);
+	}
+	async updateNotification(input) {
+		return (await this.getNotificationsStorage()).updateNotification(input);
+	}
+	async dangerouslyClearAll() {
+		return (await this.getNotificationsStorage()).dangerouslyClearAll();
+	}
+};
+function createToolHooks(hookManager, postToolObserver) {
+	if (!hookManager && !postToolObserver) return void 0;
+	return {
+		beforeToolCall: async ({ toolName, input }) => {
+			if (!hookManager) return;
+			const preResult = await hookManager.runPreToolUse(toolName, input);
+			if (!preResult.allowed) return {
+				proceed: false,
+				output: { error: preResult.blockReason ?? `Blocked by PreToolUse hook for tool "${toolName}"` }
+			};
+		},
+		afterToolCall: async (context) => {
+			const { toolName, input, output, error } = context;
+			if (hookManager) {
+				const failed = error !== void 0;
+				await hookManager.runPostToolUse(toolName, input, failed ? { error: error instanceof Error ? error.message : String(error) } : output, failed).catch(() => void 0);
+			}
+			await Promise.resolve().then(() => postToolObserver?.(context)).catch((error) => {
+				console.warn(`[MastraCode] Post-tool observer failed for ${toolName}.`, error);
+			});
+		}
+	};
+}
+function createDynamicTools(mcpManager, extraTools, disabledTools, storage, pluginTools) {
+	return function getDynamicTools({ requestContext }) {
+		const ctx = requestContext.get("controller");
+		const state = ctx?.getState();
+		const modelId = ctx?.session?.modelId;
+		const isAnthropicModel = modelId?.startsWith("anthropic/");
+		const isOpenAIModel = modelId?.startsWith("openai/");
+		const tools = {
+			request_access: requestSandboxAccessTool,
+			[WORKFLOW_MANAGEMENT_TOOL_IDS.createWorkflow]: createWorkflowTool,
+			[WORKFLOW_MANAGEMENT_TOOL_IDS.listWorkflows]: listWorkflowsTool,
+			[WORKFLOW_MANAGEMENT_TOOL_IDS.getWorkflow]: getWorkflowTool,
+			[WORKFLOW_MANAGEMENT_TOOL_IDS.runWorkflow]: runWorkflowTool,
+			[WORKFLOW_MANAGEMENT_TOOL_IDS.deleteWorkflow]: deleteWorkflowTool
+		};
+		if (storage) tools[MC_TOOLS.NOTIFICATION_INBOX] = createNotificationInboxTool({ storage: new LazyNotificationsStorage(storage) });
+		const configuredWebTools = createConfiguredWebTools();
+		if (configuredWebTools) Object.assign(tools, configuredWebTools);
+		else if (isAnthropicModel) tools.web_search = createAnthropic({}).tools.webSearch_20250305();
+		else if (isOpenAIModel) tools.web_search = createOpenAI({}).tools.webSearch();
+		if (mcpManager) {
+			const mcpTools = mcpManager.getTools();
+			Object.assign(tools, mcpTools);
+		}
+		const finish = (resolvedExtra) => {
+			if (resolvedExtra) {
+				for (const [name, tool] of Object.entries(resolvedExtra)) if (tool && !(name in tools)) tools[name] = tool;
+			}
+			if (pluginTools) {
+				for (const [name, tool] of Object.entries(pluginTools)) if (!(name in tools)) tools[name] = tool;
+			}
+			if (disabledTools?.length) for (const toolName of disabledTools) delete tools[toolName];
+			const permissionRules = state?.permissionRules;
+			if (permissionRules?.tools) {
+				for (const [name, policy] of Object.entries(permissionRules.tools)) if (policy === "deny") delete tools[name];
+			}
+			return tools;
+		};
+		if (typeof extraTools === "function") {
+			const resolved = extraTools({ requestContext });
+			if (resolved && typeof resolved.then === "function") return Promise.resolve(resolved).then(finish);
+			return finish(resolved);
+		}
+		return finish(extraTools);
+	};
+}
+//#endregion
+export { LazyNotificationsStorage, createDynamicTools, createToolHooks };
+
+//# sourceMappingURL=tools.js.map

package/dist/agents/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../../src/agents/tools.ts"],"sourcesContent":["import { createAnthropic } from '@ai-sdk/anthropic';\nimport { createOpenAI } from '@ai-sdk/openai';\nimport type { ToolsInput } from '@mastra/core/agent';\nimport type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport { createNotificationInboxTool, NotificationsStorage } from '@mastra/core/notifications';\nimport type {\n  CreateNotificationInput,\n  ListDueNotificationsInput,\n  ListNotificationsInput,\n  UpdateNotificationInput,\n} from '@mastra/core/notifications';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { MastraCompositeStore } from '@mastra/core/storage';\nimport type { ToolAfterHookContext, ToolHooks } from '@mastra/core/tools';\nimport type { HookManager } from '../hooks/index.js';\nimport type { McpManager } from '../mcp/index.js';\nimport type { MastraCodeComposedState } from '../schema.js';\nimport { MC_TOOLS } from '../tool-names.js';\nimport { createConfiguredWebTools, requestSandboxAccessTool } from '../tools/index.js';\nimport { createWorkflowTool } from '../tools/workflows/create-workflow.js';\nimport { deleteWorkflowTool } from '../tools/workflows/delete-workflow.js';\nimport { getWorkflowTool } from '../tools/workflows/get-workflow.js';\nimport { listWorkflowsTool } from '../tools/workflows/list-workflows.js';\nimport { runWorkflowTool } from '../tools/workflows/run-workflow.js';\nimport { WORKFLOW_MANAGEMENT_TOOL_IDS } from '../tools/workflows/tool-ids.js';\n\n/** Minimal shape for tools passed to createDynamicTools. */\nexport type ToolLike = {\n  execute?: (...args: any[]) => Promise<unknown> | unknown;\n} & Record<string, any>;\n\nexport class LazyNotificationsStorage extends NotificationsStorage {\n  constructor(private readonly storage: MastraCompositeStore) {\n    super();\n  }\n\n  private async getNotificationsStorage(): Promise<NotificationsStorage> {\n    const notifications = await this.storage.getStore('notifications');\n    if (!notifications) {\n      throw new Error('notification_inbox requires a notifications storage domain');\n    }\n    return notifications;\n  }\n\n  async createNotification(input: CreateNotificationInput) {\n    return (await this.getNotificationsStorage()).createNotification(input);\n  }\n\n  async listNotifications(input: ListNotificationsInput) {\n    return (await this.getNotificationsStorage()).listNotifications(input);\n  }\n\n  async listDueNotifications(input: ListDueNotificationsInput) {\n    return (await this.getNotificationsStorage()).listDueNotifications(input);\n  }\n\n  async getNotification(input: { threadId: string; id: string }) {\n    return (await this.getNotificationsStorage()).getNotification(input);\n  }\n\n  async updateNotification(input: UpdateNotificationInput) {\n    return (await this.getNotificationsStorage()).updateNotification(input);\n  }\n\n  async dangerouslyClearAll() {\n    return (await this.getNotificationsStorage()).dangerouslyClearAll();\n  }\n}\n\nexport type PostToolObserver = (context: ToolAfterHookContext) => void | Promise<void>;\n\nexport function createToolHooks(hookManager?: HookManager, postToolObserver?: PostToolObserver): ToolHooks | undefined {\n  if (!hookManager && !postToolObserver) return undefined;\n\n  return {\n    beforeToolCall: async ({ toolName, input }) => {\n      if (!hookManager) return;\n      const preResult = await hookManager.runPreToolUse(toolName, input);\n      if (!preResult.allowed) {\n        return {\n          proceed: false as const,\n          output: {\n            error: preResult.blockReason ?? `Blocked by PreToolUse hook for tool \"${toolName}\"`,\n          },\n        };\n      }\n    },\n    afterToolCall: async context => {\n      const { toolName, input, output, error } = context;\n      if (hookManager) {\n        const failed = error !== undefined;\n        await hookManager\n          .runPostToolUse(\n            toolName,\n            input,\n            failed ? { error: error instanceof Error ? error.message : String(error) } : output,\n            failed,\n          )\n          .catch(() => undefined);\n      }\n      await Promise.resolve()\n        .then(() => postToolObserver?.(context))\n        .catch(error => {\n          console.warn(`[MastraCode] Post-tool observer failed for ${toolName}.`, error);\n        });\n    },\n  };\n}\n\ntype DynamicToolProvider =\n  | Record<string, ToolLike | undefined>\n  | ((ctx: {\n      requestContext: RequestContext;\n    }) => Record<string, ToolLike | undefined> | Promise<Record<string, ToolLike | undefined>>);\n\nexport function createDynamicTools(\n  mcpManager?: McpManager,\n  extraTools?: DynamicToolProvider,\n  disabledTools?: string[],\n  storage?: MastraCompositeStore,\n  pluginTools?: Record<string, ToolLike>,\n) {\n  return function getDynamicTools({\n    requestContext,\n  }: {\n    requestContext: RequestContext;\n  }): ToolsInput | Promise<ToolsInput> {\n    const ctx = requestContext.get('controller') as AgentControllerRequestContext<MastraCodeComposedState> | undefined;\n    const state = ctx?.getState();\n\n    const modelId = ctx?.session?.modelId;\n    const isAnthropicModel = modelId?.startsWith('anthropic/');\n    const isOpenAIModel = modelId?.startsWith('openai/');\n\n    // Filesystem, grep, glob, edit, write, execute_command, and process\n    // management tools are now provided by the workspace (see workspace.ts).\n    // Only tools without a workspace equivalent remain here.\n    const tools: Record<string, ToolLike> = {\n      request_access: requestSandboxAccessTool,\n      // Workflow surface. `create-workflow` delegates to the workflow-builder\n      // sub-agent; the other four are Dynamic Workflow management operations.\n      // Permission categories live in permissions.ts (TOOL_CATEGORY_MAP).\n      [WORKFLOW_MANAGEMENT_TOOL_IDS.createWorkflow]: createWorkflowTool,\n      [WORKFLOW_MANAGEMENT_TOOL_IDS.listWorkflows]: listWorkflowsTool,\n      [WORKFLOW_MANAGEMENT_TOOL_IDS.getWorkflow]: getWorkflowTool,\n      [WORKFLOW_MANAGEMENT_TOOL_IDS.runWorkflow]: runWorkflowTool,\n      [WORKFLOW_MANAGEMENT_TOOL_IDS.deleteWorkflow]: deleteWorkflowTool,\n    };\n\n    if (storage) {\n      tools[MC_TOOLS.NOTIFICATION_INBOX] = createNotificationInboxTool({\n        storage: new LazyNotificationsStorage(storage),\n      });\n    }\n\n    const configuredWebTools = createConfiguredWebTools();\n    if (configuredWebTools) {\n      Object.assign(tools, configuredWebTools);\n    } else if (isAnthropicModel) {\n      const anthropic = createAnthropic({});\n      tools.web_search = anthropic.tools.webSearch_20250305();\n    } else if (isOpenAIModel) {\n      const openai = createOpenAI({});\n      tools.web_search = openai.tools.webSearch();\n    }\n\n    if (mcpManager) {\n      const mcpTools = mcpManager.getTools();\n      Object.assign(tools, mcpTools);\n    }\n\n    const finish = (resolvedExtra: Record<string, ToolLike | undefined> | undefined) => {\n      if (resolvedExtra) {\n        for (const [name, tool] of Object.entries(resolvedExtra)) {\n          if (tool && !(name in tools)) {\n            tools[name] = tool;\n          }\n        }\n      }\n\n      if (pluginTools) {\n        for (const [name, tool] of Object.entries(pluginTools)) {\n          if (!(name in tools)) {\n            tools[name] = tool;\n          }\n        }\n      }\n\n      // Remove tools explicitly disabled via config so the model never sees them.\n      if (disabledTools?.length) {\n        for (const toolName of disabledTools) {\n          delete tools[toolName];\n        }\n      }\n\n      // Remove tools that have a per-tool 'deny' policy so the model never sees them.\n      const permissionRules = state?.permissionRules;\n      if (permissionRules?.tools) {\n        for (const [name, policy] of Object.entries(permissionRules.tools)) {\n          if (policy === 'deny') {\n            delete tools[name];\n          }\n        }\n      }\n\n      return tools as ToolsInput;\n    };\n\n    if (typeof extraTools === 'function') {\n      const resolved = extraTools({ requestContext });\n      // Stay synchronous for sync providers; only go async when the provider does.\n      if (resolved && typeof (resolved as PromiseLike<unknown>).then === 'function') {\n        return Promise.resolve(resolved).then(finish);\n      }\n      return finish(resolved as Record<string, ToolLike | undefined>);\n    }\n\n    return finish(extraTools);\n  };\n}\n"],"mappings":"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"}

package/dist/agents/workflow-builder-agent.d.ts

@@ -0,0 +1,2 @@
+export declare const workflowBuilderAgent: import("@mastra/core/agent").Agent<"workflow-builder", import("@mastra/core/agent").ToolsInput, undefined, any, import("@mastra/core/agent").AgentEditorConfig | undefined>;
+//# sourceMappingURL=workflow-builder-agent.d.ts.map

package/dist/agents/workflow-builder-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-builder-agent.d.ts","sourceRoot":"","sources":["../../src/agents/workflow-builder-agent.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,oBAAoB,6KA2D/B,CAAC"}

package/dist/agents/workflow-builder-agent.js

@@ -0,0 +1,80 @@
+import { getDynamicModel } from "./model.js";
+import { WORKFLOW_AUTHORING_TOOL_IDS } from "../tools/workflows/tool-ids.js";
+import { listAvailableAgentsTool } from "../tools/workflows/list-available-agents.js";
+import { listAvailableToolsTool } from "../tools/workflows/list-available-tools.js";
+import { listAvailableWorkflowsTool } from "../tools/workflows/list-available-workflows.js";
+import { saveWorkflowTool } from "../tools/workflows/save-workflow.js";
+import { createWorkflowBuilderAgent } from "@mastra/core/workflows/builder";
+//#region src/agents/workflow-builder-agent.ts
+/**
+* Workflow Builder sub-agent.
+*
+* The parent code-agent (build/plan/explore modes) delegates to this agent
+* via the `create-workflow` tool. Keeping the long workflow-authoring system
+* prompt here — instead of inlining it into every parent mode — keeps the
+* parent modes lean and lets the same author logic ship to Studio later.
+*
+* The sub-agent's tool set is intentionally tiny: discover what's available,
+* construct the entire definition in one thought, save it. No setter loop,
+* no per-step mutations.
+*/
+const workflowBuilderAgent = createWorkflowBuilderAgent({
+	id: "workflow-builder",
+	name: "Workflow Builder",
+	description: "Turns plain-language workflow descriptions into runnable, persisted workflow definitions.",
+	tools: {
+		[WORKFLOW_AUTHORING_TOOL_IDS.listAgents]: listAvailableAgentsTool,
+		[WORKFLOW_AUTHORING_TOOL_IDS.listTools]: listAvailableToolsTool,
+		[WORKFLOW_AUTHORING_TOOL_IDS.listWorkflows]: listAvailableWorkflowsTool,
+		[WORKFLOW_AUTHORING_TOOL_IDS.saveWorkflow]: saveWorkflowTool
+	},
+	surfaceInstructions: `# Mastra Code authoring policy
+
+Your job: turn the user's verbatim plain-language request into a complete Dynamic Workflow definition and persist it with save-workflow. Success means save-workflow returned \`{ ok: true, id }\` for the workflow the user asked for; do not claim success before that result.
+
+Save each definition successfully **exactly once**: after \`save-workflow\` returns \`{ ok: true, id }\`, never save that workflow again. The workflow the user asked for is always saved LAST. You may save other workflows before it **only** when they are helper workflows the requested workflow references as \`{ type: "workflow" }\` entries — never to probe the schema or split one workflow into pieces the user did not ask for. A rejected save is not a successful save; correct the reported issues and make the one sequential corrected attempt permitted by the protocol below.
+
+# \`code-agent\` — when to use it as an agent step
+
+The Mastra instance registers \`code-agent\` (mastracode's coding agent) alongside the workflow-builder. When discovery surfaces it in \`list-available-agents\`, know that under the hood it has full access to workspace tools (view / edit / run commands), MCP tools, and web search — and it *reasons* over a prompt to pick the right ones.
+
+Use it as an \`agent\` step when the workflow needs judgment or open-ended tool orchestration you can't hardcode — e.g. "read these files and figure out what changed", "review these logs and summarise the failures", "call the right MCP tool to open a Linear issue based on this content".
+
+When the workflow needs a **specific, deterministic** operation (like \`execute_command wc -l file.ts\` or a single fixed web-search call), prefer a plain \`tool\` step — cheaper, no LLM in the middle, and reproducible.
+
+# Workspace tool output shapes — read this before wiring a file-oriented workflow
+
+The workspace tools you are most likely to compose with return **strings, not objects**, and the shared bridge-agent and \`initData\` re-threading guidance applies to them directly:
+
+- \`find_files\` returns a formatted \`string\` listing, and the entries are **bare basenames with no path prefix** (e.g. \`app-tools.ts\\nserver.ts\`). A downstream step told only "summarise each file" therefore has no idea which folder they live in.
+- \`find_files\` — inputSchema \`{ path?: string, ... }\`, outputSchema tree-formatted text (string).
+- \`view\` — inputSchema \`{ path: string, ... }\`, outputSchema \`string | { __workspaceMedia: true, text: string, mediaType: string, data: string }\`.
+
+Two consequences, both covered by the shared playbook's worked examples:
+
+1. A string listing is not iterable, so \`foreach\` needs a bridge \`agent\` step with a top-level array \`outputSchema\` between the listing tool and the loop.
+2. Because the listing strips the folder path, the mapping that builds the bridge agent's prompt MUST re-thread the original path with \`\${initData.<pathField>}\` alongside \`\${stepResults.<listing-step>}\`. Skipping this is the most common cause of downstream "file not found" failures.
+
+Always confirm these shapes against \`list-available-tools\` rather than trusting the summary above.
+
+# Mastra Code discovery notes
+
+The three shared listing tools behave here exactly as the shared playbook describes; each row's \`id\` is the value you copy into \`agentId\` / \`toolId\` / \`workflowId\`. \`list-available-workflows\` includes both code-defined and Dynamic Workflows, and its catalog is always available on this surface.
+
+Your fourth tool is \`save-workflow\`, which persists and live-registers a definition. Make one sequential complete call per attempt, only after composition and the shared pre-action check.
+
+# Mastra Code execution and response protocol
+
+1. Complete discovery, composition, and the shared pre-action check before calling \`save-workflow\`.
+2. If the design needs helper workflows (for example, per-branch wrappers so \`parallel\` branches can consume different fields — see the shared nested-workflow guidance), save each helper FIRST, one complete definition per call, in dependency order. Each \`save-workflow\` success live-registers that helper, which makes it a valid \`workflowId\` for the next definition. Confirm with \`list-available-workflows\` before referencing it, and give each helper a real \`id\` and \`description\` — helpers are permanent, user-visible registry entries, not scratch space.
+3. Call \`save-workflow\` with one complete \`{ id, description, inputSchema, outputSchema, graph }\` definition for the requested workflow. There are no incremental setter tools and no parallel save attempts.
+4. Wait for the tool result. Success means exactly that \`save-workflow\` returned \`{ ok: true, id }\`; at that point the workflow is persisted and live-registered.
+5. If the tool rejects the definition, do not claim success. Use the returned diagnostics and authoritative discovery to correct every named issue, rerun the shared pre-action check, and make one sequential corrected complete save attempt. Do not rationalize a registry mismatch as a missing engine feature.
+6. After success, follow the shared summary rules and end with the concrete run command \`/workflows run <id> {…}\` for the requested workflow. If you saved helper workflows, name them so the user knows they now exist in the registry.
+`,
+	model: getDynamicModel
+});
+//#endregion
+export { workflowBuilderAgent };
+
+//# sourceMappingURL=workflow-builder-agent.js.map

package/dist/agents/workflow-builder-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-builder-agent.js","names":[],"sources":["../../src/agents/workflow-builder-agent.ts"],"sourcesContent":["/**\n * Workflow Builder sub-agent.\n *\n * The parent code-agent (build/plan/explore modes) delegates to this agent\n * via the `create-workflow` tool. Keeping the long workflow-authoring system\n * prompt here — instead of inlining it into every parent mode — keeps the\n * parent modes lean and lets the same author logic ship to Studio later.\n *\n * The sub-agent's tool set is intentionally tiny: discover what's available,\n * construct the entire definition in one thought, save it. No setter loop,\n * no per-step mutations.\n */\nimport { createWorkflowBuilderAgent } from '@mastra/core/workflows/builder';\nimport { listAvailableAgentsTool } from '../tools/workflows/list-available-agents.js';\nimport { listAvailableToolsTool } from '../tools/workflows/list-available-tools.js';\nimport { listAvailableWorkflowsTool } from '../tools/workflows/list-available-workflows.js';\nimport { saveWorkflowTool } from '../tools/workflows/save-workflow.js';\nimport { WORKFLOW_AUTHORING_TOOL_IDS } from '../tools/workflows/tool-ids.js';\nimport { getDynamicModel } from './model.js';\n\nexport const workflowBuilderAgent = createWorkflowBuilderAgent({\n  id: 'workflow-builder',\n  name: 'Workflow Builder',\n  description: 'Turns plain-language workflow descriptions into runnable, persisted workflow definitions.',\n  tools: {\n    [WORKFLOW_AUTHORING_TOOL_IDS.listAgents]: listAvailableAgentsTool,\n    [WORKFLOW_AUTHORING_TOOL_IDS.listTools]: listAvailableToolsTool,\n    [WORKFLOW_AUTHORING_TOOL_IDS.listWorkflows]: listAvailableWorkflowsTool,\n    [WORKFLOW_AUTHORING_TOOL_IDS.saveWorkflow]: saveWorkflowTool,\n  },\n  surfaceInstructions: `# Mastra Code authoring policy\n\nYour job: turn the user's verbatim plain-language request into a complete Dynamic Workflow definition and persist it with save-workflow. Success means save-workflow returned \\`{ ok: true, id }\\` for the workflow the user asked for; do not claim success before that result.\n\nSave each definition successfully **exactly once**: after \\`save-workflow\\` returns \\`{ ok: true, id }\\`, never save that workflow again. The workflow the user asked for is always saved LAST. You may save other workflows before it **only** when they are helper workflows the requested workflow references as \\`{ type: \"workflow\" }\\` entries — never to probe the schema or split one workflow into pieces the user did not ask for. A rejected save is not a successful save; correct the reported issues and make the one sequential corrected attempt permitted by the protocol below.\n\n# \\`code-agent\\` — when to use it as an agent step\n\nThe Mastra instance registers \\`code-agent\\` (mastracode's coding agent) alongside the workflow-builder. When discovery surfaces it in \\`list-available-agents\\`, know that under the hood it has full access to workspace tools (view / edit / run commands), MCP tools, and web search — and it *reasons* over a prompt to pick the right ones.\n\nUse it as an \\`agent\\` step when the workflow needs judgment or open-ended tool orchestration you can't hardcode — e.g. \"read these files and figure out what changed\", \"review these logs and summarise the failures\", \"call the right MCP tool to open a Linear issue based on this content\".\n\nWhen the workflow needs a **specific, deterministic** operation (like \\`execute_command wc -l file.ts\\` or a single fixed web-search call), prefer a plain \\`tool\\` step — cheaper, no LLM in the middle, and reproducible.\n\n# Workspace tool output shapes — read this before wiring a file-oriented workflow\n\nThe workspace tools you are most likely to compose with return **strings, not objects**, and the shared bridge-agent and \\`initData\\` re-threading guidance applies to them directly:\n\n- \\`find_files\\` returns a formatted \\`string\\` listing, and the entries are **bare basenames with no path prefix** (e.g. \\`app-tools.ts\\\\nserver.ts\\`). A downstream step told only \"summarise each file\" therefore has no idea which folder they live in.\n- \\`find_files\\` — inputSchema \\`{ path?: string, ... }\\`, outputSchema tree-formatted text (string).\n- \\`view\\` — inputSchema \\`{ path: string, ... }\\`, outputSchema \\`string | { __workspaceMedia: true, text: string, mediaType: string, data: string }\\`.\n\nTwo consequences, both covered by the shared playbook's worked examples:\n\n1. A string listing is not iterable, so \\`foreach\\` needs a bridge \\`agent\\` step with a top-level array \\`outputSchema\\` between the listing tool and the loop.\n2. Because the listing strips the folder path, the mapping that builds the bridge agent's prompt MUST re-thread the original path with \\`\\${initData.<pathField>}\\` alongside \\`\\${stepResults.<listing-step>}\\`. Skipping this is the most common cause of downstream \"file not found\" failures.\n\nAlways confirm these shapes against \\`list-available-tools\\` rather than trusting the summary above.\n\n# Mastra Code discovery notes\n\nThe three shared listing tools behave here exactly as the shared playbook describes; each row's \\`id\\` is the value you copy into \\`agentId\\` / \\`toolId\\` / \\`workflowId\\`. \\`list-available-workflows\\` includes both code-defined and Dynamic Workflows, and its catalog is always available on this surface.\n\nYour fourth tool is \\`save-workflow\\`, which persists and live-registers a definition. Make one sequential complete call per attempt, only after composition and the shared pre-action check.\n\n# Mastra Code execution and response protocol\n\n1. Complete discovery, composition, and the shared pre-action check before calling \\`save-workflow\\`.\n2. If the design needs helper workflows (for example, per-branch wrappers so \\`parallel\\` branches can consume different fields — see the shared nested-workflow guidance), save each helper FIRST, one complete definition per call, in dependency order. Each \\`save-workflow\\` success live-registers that helper, which makes it a valid \\`workflowId\\` for the next definition. Confirm with \\`list-available-workflows\\` before referencing it, and give each helper a real \\`id\\` and \\`description\\` — helpers are permanent, user-visible registry entries, not scratch space.\n3. Call \\`save-workflow\\` with one complete \\`{ id, description, inputSchema, outputSchema, graph }\\` definition for the requested workflow. There are no incremental setter tools and no parallel save attempts.\n4. Wait for the tool result. Success means exactly that \\`save-workflow\\` returned \\`{ ok: true, id }\\`; at that point the workflow is persisted and live-registered.\n5. If the tool rejects the definition, do not claim success. Use the returned diagnostics and authoritative discovery to correct every named issue, rerun the shared pre-action check, and make one sequential corrected complete save attempt. Do not rationalize a registry mismatch as a missing engine feature.\n6. After success, follow the shared summary rules and end with the concrete run command \\`/workflows run <id> {…}\\` for the requested workflow. If you saved helper workflows, name them so the user knows they now exist in the registry.\n`,\n  // Same dynamic model resolver mastracode's main code-agent uses — picks up\n  // the user's configured provider/model from session state. When the parent\n  // code-agent delegates to this sub-agent (via `create-workflow`), the\n  // request context propagates so the same model resolves.\n  model: getDynamicModel,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,uBAAuB,2BAA2B;CAC7D,IAAI;CACJ,MAAM;CACN,aAAa;CACb,OAAO;GACJ,4BAA4B,aAAa;GACzC,4BAA4B,YAAY;GACxC,4BAA4B,gBAAgB;GAC5C,4BAA4B,eAAe;CAC9C;CACA,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDrB,OAAO;AACT,CAAC"}