@mastra/code-sdk 1.9.0-alpha.9 → 1.10.0-alpha.0

package/dist/schedules/tools.js

@@ -0,0 +1,220 @@
+import { parseInterval, validateInterval } from "./interval.js";
+import { describeScheduleSource, shortScheduleId } from "./scheduler.js";
+import { resolveScriptCommand } from "./run-script.js";
+import * as path$1 from "path";
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/schedules/tools.ts
+/**
+* Agent-facing tools for the process-local `/schedules` scheduler.
+*
+* Opt-in (experimental setting). Every tool is bound to the thread of the run
+* that calls it — the model never picks a thread or resource — and can only
+* see or manage schedules on that thread.
+*/
+const SCHEDULE_TOOL_IDS = {
+	create: "schedule_create",
+	list: "schedule_list",
+	update: "schedule_update",
+	resume: "schedule_resume",
+	run: "schedule_run"
+};
+const resultSchema = z.object({
+	content: z.string(),
+	isError: z.boolean().optional()
+});
+const intervalSchema = z.string().min(1).transform((value, ctx) => {
+	const interval = parseInterval(value);
+	if ("error" in interval) {
+		ctx.addIssue({
+			code: "custom",
+			message: interval.error
+		});
+		return z.NEVER;
+	}
+	const check = validateInterval(interval);
+	if ("error" in check) {
+		const suggestion = check.suggestion ? ` Try ${check.suggestion}.` : "";
+		ctx.addIssue({
+			code: "custom",
+			message: `${check.error}${suggestion}`
+		});
+		return z.NEVER;
+	}
+	return interval;
+}).describe("Cadence such as \"5m\", \"2h\", or \"1d\". Minute steps must divide 60, hour steps must divide 24.");
+const triggerSchema = z.discriminatedUnion("kind", [z.object({
+	kind: z.literal("every"),
+	interval: intervalSchema
+})]).describe("When the schedule fires. \"every\" repeats on wall-clock boundaries (5m fires at :00, :05, …).");
+const idSchema = z.string().min(1).describe("Schedule id, or a unique prefix of it (the 8-character short id works).");
+function threadOf(context) {
+	const agent = context?.agent;
+	return agent?.threadId && agent.resourceId ? {
+		threadId: agent.threadId,
+		resourceId: agent.resourceId
+	} : void 0;
+}
+const NO_THREAD = {
+	content: "Schedules require a memory-backed thread.",
+	isError: true
+};
+function resolveFile(token, mode, options) {
+	const expanded = token.startsWith("~/") && options.homeDir ? path$1.join(options.homeDir, token.slice(2)) : token;
+	const absPath = path$1.resolve(options.cwd, expanded);
+	return options.fileExists(absPath) ? {
+		path: absPath,
+		displayPath: token,
+		mode
+	} : void 0;
+}
+function formatSchedule(schedule) {
+	const timing = schedule.status === "paused" ? "paused" : `next at ${new Date(schedule.nextFireAt).toLocaleTimeString()}`;
+	return `${shortScheduleId(schedule.id)}  every ${schedule.trigger.interval.label}  ${timing}  ${describeScheduleSource(schedule)}  (created by ${schedule.createdBy})`;
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function findOne(scheduler, threadId, id) {
+	const needle = id.toLowerCase();
+	const matches = scheduler.list({ threadId }).filter((schedule) => schedule.id.toLowerCase().startsWith(needle));
+	if (matches.length === 1) return { schedule: matches[0] };
+	return {
+		content: matches.length === 0 ? `No schedule "${id}" on this thread.` : `"${id}" matches several schedules.`,
+		isError: true
+	};
+}
+function createScheduleTools({ scheduler, fileOptions }) {
+	const scheduleCreateTool = createTool({
+		id: SCHEDULE_TOOL_IDS.create,
+		description: `Schedule a recurring prompt on this thread. Each fire arrives as a new user turn labelled "schedule".
+
+Pass exactly one source: "prompt" (text sent each fire), "promptFile" (a file re-read and sent as the prompt each fire), or "script" (run each fire; its output is sent, followed by "extraPrompt" if given). Schedules live only until Mastra Code exits.`,
+		inputSchema: z.object({
+			trigger: triggerSchema,
+			prompt: z.string().trim().min(1).optional().describe("Prompt text to send on every fire."),
+			promptFile: z.string().trim().min(1).optional().describe("Path to a file to re-read and send on every fire."),
+			script: z.string().trim().min(1).optional().describe("Path to a script to run on every fire."),
+			extraPrompt: z.string().trim().min(1).optional().describe("Text sent after the script output.")
+		}).refine((input) => [
+			input.prompt,
+			input.promptFile,
+			input.script
+		].filter(Boolean).length === 1, { message: "Provide exactly one of \"prompt\", \"promptFile\", or \"script\"." }).refine((input) => !input.extraPrompt || input.script, { message: "\"extraPrompt\" only applies with \"script\"." }),
+		outputSchema: resultSchema,
+		execute: async (input, context) => {
+			const target = threadOf(context);
+			if (!target) return NO_THREAD;
+			let schedule;
+			if (input.prompt) schedule = scheduler.create({
+				trigger: input.trigger,
+				prompt: input.prompt,
+				createdBy: "agent"
+			}, target);
+			else {
+				const token = input.script ?? input.promptFile;
+				const file = resolveFile(token, input.script ? "script" : "prompt", fileOptions());
+				if (!file) return {
+					content: `File not found: ${token}`,
+					isError: true
+				};
+				if (file.mode === "script") try {
+					resolveScriptCommand(file.path);
+				} catch (error) {
+					return {
+						content: `Can't run ${token}: ${error instanceof Error ? error.message : String(error)}`,
+						isError: true
+					};
+				}
+				schedule = scheduler.create({
+					trigger: input.trigger,
+					file,
+					...input.extraPrompt ? { extraPrompt: input.extraPrompt } : {},
+					createdBy: "agent"
+				}, target);
+			}
+			return { content: `Created schedule ${formatSchedule(schedule)}` };
+		}
+	});
+	const scheduleListTool = createTool({
+		id: SCHEDULE_TOOL_IDS.list,
+		description: "List the recurring prompt schedules on this thread, including ones the user created with /schedules.",
+		inputSchema: z.object({}),
+		outputSchema: resultSchema,
+		execute: async (_input, context) => {
+			const target = threadOf(context);
+			if (!target) return NO_THREAD;
+			const schedules = scheduler.list({ threadId: target.threadId });
+			if (schedules.length === 0) return { content: "No schedules on this thread." };
+			return { content: [`Schedules on this thread (${schedules.length}):`, ...schedules.map(formatSchedule)].join("\n") };
+		}
+	});
+	const scheduleUpdateTool = createTool({
+		id: SCHEDULE_TOOL_IDS.update,
+		description: "Pause or delete a schedule on this thread. Use schedule_resume to resume a paused one.",
+		inputSchema: z.object({
+			id: idSchema,
+			action: z.enum(["pause", "delete"])
+		}),
+		outputSchema: resultSchema,
+		execute: async ({ id, action }, context) => {
+			const target = threadOf(context);
+			if (!target) return NO_THREAD;
+			const found = findOne(scheduler, target.threadId, id);
+			if (!("schedule" in found)) return found;
+			scheduler[action](found.schedule.id);
+			return { content: `${action === "pause" ? "Paused" : "Deleted"} schedule ${shortScheduleId(found.schedule.id)}.` };
+		}
+	});
+	const scheduleResumeTool = createTool({
+		id: SCHEDULE_TOOL_IDS.resume,
+		description: "Resume a paused schedule on this thread. It fires again from the next clock boundary.",
+		inputSchema: z.object({ id: idSchema }),
+		outputSchema: resultSchema,
+		execute: async ({ id }, context) => {
+			const target = threadOf(context);
+			if (!target) return NO_THREAD;
+			const found = findOne(scheduler, target.threadId, id);
+			if (!("schedule" in found)) return found;
+			scheduler.resume(found.schedule.id);
+			return { content: `Resumed schedule ${shortScheduleId(found.schedule.id)}.` };
+		}
+	});
+	const scheduleRunTool = createTool({
+		id: SCHEDULE_TOOL_IDS.run,
+		description: "Fire a schedule on this thread once now, even if it is paused, without changing its cadence. Its prompt arrives as the next user turn.",
+		inputSchema: z.object({ id: idSchema }),
+		outputSchema: resultSchema,
+		execute: async ({ id }, context) => {
+			const target = threadOf(context);
+			if (!target) return NO_THREAD;
+			const found = findOne(scheduler, target.threadId, id);
+			if (!("schedule" in found)) return found;
+			const short = shortScheduleId(found.schedule.id);
+			const result = await scheduler.run(found.schedule.id);
+			switch (result.status) {
+				case "fired": return { content: `Triggered schedule ${short}; its prompt arrives as the next turn.` };
+				case "busy": return { content: `Schedule ${short} is already firing; skipped so its prompt isn't sent twice.` };
+				case "not-found": return {
+					content: `Schedule ${short} was deleted before it fired.`,
+					isError: true
+				};
+				case "failed": return {
+					content: `Schedule ${short} failed to fire: ${errorMessage(result.error)}`,
+					isError: true
+				};
+			}
+		}
+	});
+	return {
+		[SCHEDULE_TOOL_IDS.create]: scheduleCreateTool,
+		[SCHEDULE_TOOL_IDS.list]: scheduleListTool,
+		[SCHEDULE_TOOL_IDS.update]: scheduleUpdateTool,
+		[SCHEDULE_TOOL_IDS.resume]: scheduleResumeTool,
+		[SCHEDULE_TOOL_IDS.run]: scheduleRunTool
+	};
+}
+//#endregion
+export { SCHEDULE_TOOL_IDS, createScheduleTools };
+
+//# sourceMappingURL=tools.js.map

package/dist/schedules/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":["path"],"sources":["../../src/schedules/tools.ts"],"sourcesContent":["/**\n * Agent-facing tools for the process-local `/schedules` scheduler.\n *\n * Opt-in (experimental setting). Every tool is bound to the thread of the run\n * that calls it — the model never picks a thread or resource — and can only\n * see or manage schedules on that thread.\n */\nimport * as path from 'node:path';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { parseInterval, validateInterval } from './interval.js';\nimport { resolveScriptCommand } from './run-script.js';\nimport { describeScheduleSource, shortScheduleId } from './scheduler.js';\nimport type { ScheduleFile, ThreadSchedule, ThreadScheduler } from './scheduler.js';\n\nexport const SCHEDULE_TOOL_IDS = {\n  create: 'schedule_create',\n  list: 'schedule_list',\n  update: 'schedule_update',\n  resume: 'schedule_resume',\n  run: 'schedule_run',\n} as const;\n\nexport type ScheduleFileOptions = {\n  /** Directory relative paths resolve against (the project root). */\n  cwd: string;\n  homeDir?: string;\n  fileExists: (absPath: string) => boolean;\n};\n\nexport type ScheduleToolsOptions = {\n  scheduler: ThreadScheduler;\n  fileOptions: () => ScheduleFileOptions;\n};\n\ntype ToolRunContext = { agent?: { threadId?: string; resourceId?: string } };\n\nconst resultSchema = z.object({\n  content: z.string(),\n  isError: z.boolean().optional(),\n});\ntype ScheduleToolResult = z.infer<typeof resultSchema>;\n\nconst intervalSchema = z\n  .string()\n  .min(1)\n  .transform((value, ctx) => {\n    const interval = parseInterval(value);\n    if ('error' in interval) {\n      ctx.addIssue({ code: 'custom', message: interval.error });\n      return z.NEVER;\n    }\n    const check = validateInterval(interval);\n    if ('error' in check) {\n      const suggestion = check.suggestion ? ` Try ${check.suggestion}.` : '';\n      ctx.addIssue({ code: 'custom', message: `${check.error}${suggestion}` });\n      return z.NEVER;\n    }\n    return interval;\n  })\n  .describe('Cadence such as \"5m\", \"2h\", or \"1d\". Minute steps must divide 60, hour steps must divide 24.');\n\nconst triggerSchema = z\n  .discriminatedUnion('kind', [\n    z.object({\n      kind: z.literal('every'),\n      interval: intervalSchema,\n    }),\n  ])\n  .describe('When the schedule fires. \"every\" repeats on wall-clock boundaries (5m fires at :00, :05, …).');\n\nconst idSchema = z.string().min(1).describe('Schedule id, or a unique prefix of it (the 8-character short id works).');\n\nfunction threadOf(context: unknown): { threadId: string; resourceId: string } | undefined {\n  const agent = (context as ToolRunContext | undefined)?.agent;\n  return agent?.threadId && agent.resourceId ? { threadId: agent.threadId, resourceId: agent.resourceId } : undefined;\n}\n\nconst NO_THREAD: ScheduleToolResult = { content: 'Schedules require a memory-backed thread.', isError: true };\n\nfunction resolveFile(\n  token: string,\n  mode: ScheduleFile['mode'],\n  options: ScheduleFileOptions,\n): ScheduleFile | undefined {\n  const expanded = token.startsWith('~/') && options.homeDir ? path.join(options.homeDir, token.slice(2)) : token;\n  const absPath = path.resolve(options.cwd, expanded);\n  return options.fileExists(absPath) ? { path: absPath, displayPath: token, mode } : undefined;\n}\n\nfunction formatSchedule(schedule: ThreadSchedule): string {\n  const timing =\n    schedule.status === 'paused' ? 'paused' : `next at ${new Date(schedule.nextFireAt).toLocaleTimeString()}`;\n  return `${shortScheduleId(schedule.id)}  every ${schedule.trigger.interval.label}  ${timing}  ${describeScheduleSource(schedule)}  (created by ${schedule.createdBy})`;\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction findOne(\n  scheduler: ThreadScheduler,\n  threadId: string,\n  id: string,\n): { schedule: ThreadSchedule } | ScheduleToolResult {\n  const needle = id.toLowerCase();\n  const matches = scheduler.list({ threadId }).filter(schedule => schedule.id.toLowerCase().startsWith(needle));\n  if (matches.length === 1) return { schedule: matches[0]! };\n  return {\n    content: matches.length === 0 ? `No schedule \"${id}\" on this thread.` : `\"${id}\" matches several schedules.`,\n    isError: true,\n  };\n}\n\nexport function createScheduleTools({ scheduler, fileOptions }: ScheduleToolsOptions) {\n  const scheduleCreateTool = createTool({\n    id: SCHEDULE_TOOL_IDS.create,\n    description: `Schedule a recurring prompt on this thread. Each fire arrives as a new user turn labelled \"schedule\".\n\nPass exactly one source: \"prompt\" (text sent each fire), \"promptFile\" (a file re-read and sent as the prompt each fire), or \"script\" (run each fire; its output is sent, followed by \"extraPrompt\" if given). Schedules live only until Mastra Code exits.`,\n    inputSchema: z\n      .object({\n        trigger: triggerSchema,\n        prompt: z.string().trim().min(1).optional().describe('Prompt text to send on every fire.'),\n        promptFile: z.string().trim().min(1).optional().describe('Path to a file to re-read and send on every fire.'),\n        script: z.string().trim().min(1).optional().describe('Path to a script to run on every fire.'),\n        extraPrompt: z.string().trim().min(1).optional().describe('Text sent after the script output.'),\n      })\n      .refine(input => [input.prompt, input.promptFile, input.script].filter(Boolean).length === 1, {\n        message: 'Provide exactly one of \"prompt\", \"promptFile\", or \"script\".',\n      })\n      .refine(input => !input.extraPrompt || input.script, {\n        message: '\"extraPrompt\" only applies with \"script\".',\n      }),\n    outputSchema: resultSchema,\n    execute: async (input, context): Promise<ScheduleToolResult> => {\n      const target = threadOf(context);\n      if (!target) return NO_THREAD;\n      let schedule: ThreadSchedule;\n      if (input.prompt) {\n        schedule = scheduler.create({ trigger: input.trigger, prompt: input.prompt, createdBy: 'agent' }, target);\n      } else {\n        const token = (input.script ?? input.promptFile)!;\n        const file = resolveFile(token, input.script ? 'script' : 'prompt', fileOptions());\n        if (!file) return { content: `File not found: ${token}`, isError: true };\n        if (file.mode === 'script') {\n          try {\n            resolveScriptCommand(file.path);\n          } catch (error) {\n            return {\n              content: `Can't run ${token}: ${error instanceof Error ? error.message : String(error)}`,\n              isError: true,\n            };\n          }\n        }\n        schedule = scheduler.create(\n          {\n            trigger: input.trigger,\n            file,\n            ...(input.extraPrompt ? { extraPrompt: input.extraPrompt } : {}),\n            createdBy: 'agent',\n          },\n          target,\n        );\n      }\n      return { content: `Created schedule ${formatSchedule(schedule)}` };\n    },\n  });\n\n  const scheduleListTool = createTool({\n    id: SCHEDULE_TOOL_IDS.list,\n    description: 'List the recurring prompt schedules on this thread, including ones the user created with /schedules.',\n    inputSchema: z.object({}),\n    outputSchema: resultSchema,\n    execute: async (_input, context): Promise<ScheduleToolResult> => {\n      const target = threadOf(context);\n      if (!target) return NO_THREAD;\n      const schedules = scheduler.list({ threadId: target.threadId });\n      if (schedules.length === 0) return { content: 'No schedules on this thread.' };\n      return {\n        content: [`Schedules on this thread (${schedules.length}):`, ...schedules.map(formatSchedule)].join('\\n'),\n      };\n    },\n  });\n\n  const scheduleUpdateTool = createTool({\n    id: SCHEDULE_TOOL_IDS.update,\n    description: 'Pause or delete a schedule on this thread. Use schedule_resume to resume a paused one.',\n    inputSchema: z.object({\n      id: idSchema,\n      action: z.enum(['pause', 'delete']),\n    }),\n    outputSchema: resultSchema,\n    execute: async ({ id, action }, context): Promise<ScheduleToolResult> => {\n      const target = threadOf(context);\n      if (!target) return NO_THREAD;\n      const found = findOne(scheduler, target.threadId, id);\n      if (!('schedule' in found)) return found;\n      scheduler[action](found.schedule.id);\n      const verb = action === 'pause' ? 'Paused' : 'Deleted';\n      return { content: `${verb} schedule ${shortScheduleId(found.schedule.id)}.` };\n    },\n  });\n\n  // Separate from schedule_update: resuming lets the timer run the schedule's\n  // script again, so it needs the same approval as creating or running one.\n  const scheduleResumeTool = createTool({\n    id: SCHEDULE_TOOL_IDS.resume,\n    description: 'Resume a paused schedule on this thread. It fires again from the next clock boundary.',\n    inputSchema: z.object({ id: idSchema }),\n    outputSchema: resultSchema,\n    execute: async ({ id }, context): Promise<ScheduleToolResult> => {\n      const target = threadOf(context);\n      if (!target) return NO_THREAD;\n      const found = findOne(scheduler, target.threadId, id);\n      if (!('schedule' in found)) return found;\n      scheduler.resume(found.schedule.id);\n      return { content: `Resumed schedule ${shortScheduleId(found.schedule.id)}.` };\n    },\n  });\n\n  const scheduleRunTool = createTool({\n    id: SCHEDULE_TOOL_IDS.run,\n    description:\n      'Fire a schedule on this thread once now, even if it is paused, without changing its cadence. Its prompt arrives as the next user turn.',\n    inputSchema: z.object({ id: idSchema }),\n    outputSchema: resultSchema,\n    execute: async ({ id }, context): Promise<ScheduleToolResult> => {\n      const target = threadOf(context);\n      if (!target) return NO_THREAD;\n      const found = findOne(scheduler, target.threadId, id);\n      if (!('schedule' in found)) return found;\n      const short = shortScheduleId(found.schedule.id);\n      const result = await scheduler.run(found.schedule.id);\n      switch (result.status) {\n        case 'fired':\n          return { content: `Triggered schedule ${short}; its prompt arrives as the next turn.` };\n        case 'busy':\n          return { content: `Schedule ${short} is already firing; skipped so its prompt isn't sent twice.` };\n        case 'not-found':\n          return { content: `Schedule ${short} was deleted before it fired.`, isError: true };\n        case 'failed':\n          return { content: `Schedule ${short} failed to fire: ${errorMessage(result.error)}`, isError: true };\n      }\n    },\n  });\n\n  return {\n    [SCHEDULE_TOOL_IDS.create]: scheduleCreateTool,\n    [SCHEDULE_TOOL_IDS.list]: scheduleListTool,\n    [SCHEDULE_TOOL_IDS.update]: scheduleUpdateTool,\n    [SCHEDULE_TOOL_IDS.resume]: scheduleResumeTool,\n    [SCHEDULE_TOOL_IDS.run]: scheduleRunTool,\n  };\n}\n"],"mappings":"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"}

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

@@ -1,3 +1,24 @@
+/**
+ * Sub-invocations launched from a parent chat turn (workflow agent steps,
+ * sub-agent tool calls) must run under a fresh isolated Mastra memory scope
+ * so they don't:
+ *
+ *   - write their prompts/responses into the parent chat thread's history, or
+ *   - contend with the parent turn's memory-dependent processors
+ *     (observational-memory, task-state, working-memory-state).
+ *
+ * `withEphemeralMemory` copies the caller's request context into a child,
+ * replaces its MastraMemory with a fresh thread id and inherited resource id,
+ * then passes that isolated child to `fn`. The parent context is never mutated,
+ * so concurrent sub-invocations cannot overwrite or restore each other's
+ * memory values. Isolation writes the ephemeral ids instead of scrubbing them:
+ * inner agent invocations resolve their thread/resource via those reserved
+ * keys, and leaving them unset causes downstream storage saves to throw
+ * "Thread ID is required".
+ *
+ * Callers can override the ephemeral thread id (e.g. for tests) via
+ * `options.threadId`.
+ */
 import { RequestContext } from '@mastra/core/request-context';
 interface EphemeralMemoryOptions {
     threadId?: string;

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

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

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

@@ -1,4 +1,3 @@
-import { randomUUID } from "crypto";
 import { MASTRA_RESOURCE_ID_KEY, MASTRA_THREAD_ID_KEY, RequestContext } from "@mastra/core/request-context";
 //#region src/tools/workflows/ephemeral-memory.ts
 /**
@@ -27,7 +26,7 @@ async function withEphemeralMemory(requestContext, fn, options = {}) {
 	const childRequestContext = new RequestContext(requestContext.entries());
 	const mastraMemory = requestContext.get("MastraMemory");
 	const resourceId = requestContext.get(MASTRA_RESOURCE_ID_KEY);
-	const ephemeralThreadId = options.threadId ?? randomUUID();
+	const ephemeralThreadId = options.threadId ?? globalThis.crypto.randomUUID();
 	const parentResourceId = mastraMemory?.resourceId ?? resourceId ?? "";
 	childRequestContext.set("MastraMemory", {
 		thread: { id: ephemeralThreadId },

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

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

package/dist/utils/discarding-scores-storage.d.ts

@@ -0,0 +1,33 @@
+import type { ListScoresResponse, SaveScorePayload, ScoreRowData } from '@mastra/core/evals';
+import { ScoresStorage } from '@mastra/core/storage';
+import type { StoragePagination } from '@mastra/core/storage';
+/**
+ * A scores domain that accepts writes and keeps nothing.
+ *
+ * mastracode's `outcome` and `efficiency` scorers persist every result through
+ * the scores domain (`validateAndSaveScore` → `getStore('scores')`), but nothing
+ * in mastracode reads scores back. Writing them to libsql grew mastra.db without
+ * bound, and an in-memory store would grow the heap for the life of the process
+ * instead (each payload carries the system prompt, messages, input and output).
+ * Disabling the domain is not an option: core throws
+ * MASTRA_SCORES_STORAGE_NOT_AVAILABLE on every scorer run when it is missing.
+ */
+export declare class DiscardingScoresStorage extends ScoresStorage {
+    getScoreById(): Promise<ScoreRowData | null>;
+    saveScore(score: SaveScorePayload): Promise<{
+        score: ScoreRowData;
+    }>;
+    listScoresByScorerId({ pagination }: {
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+    listScoresByRunId({ pagination }: {
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+    listScoresByEntityId({ pagination }: {
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+    listScoresBySpan({ pagination }: {
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+}
+//# sourceMappingURL=discarding-scores-storage.d.ts.map

package/dist/utils/discarding-scores-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discarding-scores-storage.d.ts","sourceRoot":"","sources":["../../src/utils/discarding-scores-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IAClD,YAAY,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI5C,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IAKpE,oBAAoB,CAAC,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIpG,iBAAiB,CAAC,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjG,oBAAoB,CAAC,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIpG,gBAAgB,CAAC,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAGvG"}

package/dist/utils/discarding-scores-storage.js

@@ -0,0 +1,54 @@
+import { ScoresStorage } from "@mastra/core/storage";
+//#region src/utils/discarding-scores-storage.ts
+/**
+* A scores domain that accepts writes and keeps nothing.
+*
+* mastracode's `outcome` and `efficiency` scorers persist every result through
+* the scores domain (`validateAndSaveScore` → `getStore('scores')`), but nothing
+* in mastracode reads scores back. Writing them to libsql grew mastra.db without
+* bound, and an in-memory store would grow the heap for the life of the process
+* instead (each payload carries the system prompt, messages, input and output).
+* Disabling the domain is not an option: core throws
+* MASTRA_SCORES_STORAGE_NOT_AVAILABLE on every scorer run when it is missing.
+*/
+var DiscardingScoresStorage = class extends ScoresStorage {
+	async getScoreById() {
+		return null;
+	}
+	async saveScore(score) {
+		const now = /* @__PURE__ */ new Date();
+		return { score: {
+			...score,
+			id: score.id ?? crypto.randomUUID(),
+			createdAt: now,
+			updatedAt: now
+		} };
+	}
+	async listScoresByScorerId({ pagination }) {
+		return empty(pagination);
+	}
+	async listScoresByRunId({ pagination }) {
+		return empty(pagination);
+	}
+	async listScoresByEntityId({ pagination }) {
+		return empty(pagination);
+	}
+	async listScoresBySpan({ pagination }) {
+		return empty(pagination);
+	}
+};
+function empty(pagination) {
+	return {
+		pagination: {
+			total: 0,
+			page: pagination.page,
+			perPage: pagination.perPage,
+			hasMore: false
+		},
+		scores: []
+	};
+}
+//#endregion
+export { DiscardingScoresStorage };
+
+//# sourceMappingURL=discarding-scores-storage.js.map

package/dist/utils/discarding-scores-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discarding-scores-storage.js","names":[],"sources":["../../src/utils/discarding-scores-storage.ts"],"sourcesContent":["import type { ListScoresResponse, SaveScorePayload, ScoreRowData } from '@mastra/core/evals';\nimport { ScoresStorage } from '@mastra/core/storage';\nimport type { StoragePagination } from '@mastra/core/storage';\n\n/**\n * A scores domain that accepts writes and keeps nothing.\n *\n * mastracode's `outcome` and `efficiency` scorers persist every result through\n * the scores domain (`validateAndSaveScore` → `getStore('scores')`), but nothing\n * in mastracode reads scores back. Writing them to libsql grew mastra.db without\n * bound, and an in-memory store would grow the heap for the life of the process\n * instead (each payload carries the system prompt, messages, input and output).\n * Disabling the domain is not an option: core throws\n * MASTRA_SCORES_STORAGE_NOT_AVAILABLE on every scorer run when it is missing.\n */\nexport class DiscardingScoresStorage extends ScoresStorage {\n  async getScoreById(): Promise<ScoreRowData | null> {\n    return null;\n  }\n\n  async saveScore(score: SaveScorePayload): Promise<{ score: ScoreRowData }> {\n    const now = new Date();\n    return { score: { ...score, id: score.id ?? crypto.randomUUID(), createdAt: now, updatedAt: now } as ScoreRowData };\n  }\n\n  async listScoresByScorerId({ pagination }: { pagination: StoragePagination }): Promise<ListScoresResponse> {\n    return empty(pagination);\n  }\n\n  async listScoresByRunId({ pagination }: { pagination: StoragePagination }): Promise<ListScoresResponse> {\n    return empty(pagination);\n  }\n\n  async listScoresByEntityId({ pagination }: { pagination: StoragePagination }): Promise<ListScoresResponse> {\n    return empty(pagination);\n  }\n\n  async listScoresBySpan({ pagination }: { pagination: StoragePagination }): Promise<ListScoresResponse> {\n    return empty(pagination);\n  }\n}\n\nfunction empty(pagination: StoragePagination): ListScoresResponse {\n  return { pagination: { total: 0, page: pagination.page, perPage: pagination.perPage, hasMore: false }, scores: [] };\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,IAAa,0BAAb,cAA6C,cAAc;CACzD,MAAM,eAA6C;EACjD,OAAO;CACT;CAEA,MAAM,UAAU,OAA2D;EACzE,MAAM,sBAAM,IAAI,KAAK;EACrB,OAAO,EAAE,OAAO;GAAE,GAAG;GAAO,IAAI,MAAM,MAAM,OAAO,WAAW;GAAG,WAAW;GAAK,WAAW;EAAI,EAAkB;CACpH;CAEA,MAAM,qBAAqB,EAAE,cAA8E;EACzG,OAAO,MAAM,UAAU;CACzB;CAEA,MAAM,kBAAkB,EAAE,cAA8E;EACtG,OAAO,MAAM,UAAU;CACzB;CAEA,MAAM,qBAAqB,EAAE,cAA8E;EACzG,OAAO,MAAM,UAAU;CACzB;CAEA,MAAM,iBAAiB,EAAE,cAA8E;EACrG,OAAO,MAAM,UAAU;CACzB;AACF;AAEA,SAAS,MAAM,YAAmD;CAChE,OAAO;EAAE,YAAY;GAAE,OAAO;GAAG,MAAM,WAAW;GAAM,SAAS,WAAW;GAAS,SAAS;EAAM;EAAG,QAAQ,CAAC;CAAE;AACpH"}

package/dist/utils/maintenance-lock.d.ts

@@ -0,0 +1,42 @@
+export declare class MaintenanceLockError extends Error {
+    readonly ownerPids: number[];
+    constructor(message: string, ownerPids: number[]);
+}
+export declare function getMaintenanceLockPath(): string;
+/** Owner of a lock whose pid file is still being written (PID not known yet). */
+export declare const UNKNOWN_OWNER = -1;
+/**
+ * Creating a pid file (open, then write) is not atomic, so an empty or
+ * unparseable file may belong to a process that is mid-write. Only treat it as
+ * stale once it is older than this.
+ */
+export declare const MALFORMED_PID_FILE_GRACE_MS = 5000;
+/**
+ * PID holding the maintenance lock, `UNKNOWN_OWNER` while its pid file is still
+ * being written, or null. Stale locks are removed.
+ */
+export declare function getMaintenanceLockOwner(): number | null;
+/** PIDs of other live registered sessions. Stale registrations are removed. */
+export declare function getLiveSessionPids(): number[];
+/** Test-only: drop every registration held by this process and forget lock ownership. */
+export declare function resetSessionRegistrationsForTesting(): void;
+/** Register one running session in this process. Pair with exactly one unregisterSession(). */
+export declare function registerSession(): void;
+/** Release one registration made by registerSession(). */
+export declare function unregisterSession(): void;
+/**
+ * Register this session, then wait for any running maintenance to finish.
+ * Waits indefinitely by default: a vacuum on a multi-GB database can take
+ * minutes. With `timeoutMs`, throws after that long naming the holder.
+ */
+export declare function registerSessionAndWaitForMaintenance({ timeoutMs, pollMs, onWait, }?: {
+    timeoutMs?: number;
+    pollMs?: number;
+    onWait?: (ownerPid: number) => void;
+}): Promise<void>;
+/**
+ * Acquire the maintenance lock, then refuse if any mastracode session is live.
+ * Returns a release function.
+ */
+export declare function acquireMaintenanceLock(): () => void;
+//# sourceMappingURL=maintenance-lock.d.ts.map

package/dist/utils/maintenance-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-lock.d.ts","sourceRoot":"","sources":["../../src/utils/maintenance-lock.ts"],"names":[],"mappings":"AAiBA,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,SAAS,EAAE,MAAM,EAAE;gBADnC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EAAE;CAKtC;AAcD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAuCjD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAgBvD;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAmB7C;AAOD,yFAAyF;AACzF,wBAAgB,mCAAmC,IAAI,IAAI,CAG1D;AAYD,+FAA+F;AAC/F,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAED;;;;GAIG;AACH,wBAAsB,oCAAoC,CAAC,EACzD,SAAoB,EACpB,MAAY,EACZ,MAAM,GACP,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,IAAI,CA0CnD"}