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

package/dist/schedules/interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interval.js","names":[],"sources":["../../src/schedules/interval.ts"],"sourcesContent":["/**\n * Interval parsing and fire-time math for `/schedules`.\n *\n * Users type `5m`, `2h`, `1 day`. Schedules fire on local wall-clock\n * boundaries (5m fires at :00, :05, ...), so only intervals that divide the\n * hour (minutes) or the day (hours) give a stable cadence; anything else is\n * rejected with the nearest valid suggestion instead of silently drifting.\n */\n\nconst SECOND_MS = 1_000;\nconst MINUTE_MS = 60 * SECOND_MS;\nconst HOUR_MS = 60 * MINUTE_MS;\nconst DAY_MS = 24 * HOUR_MS;\n\nexport type ParsedInterval = { ms: number; label: string };\nexport type IntervalError = { error: string };\n\nconst UNIT_MS: Record<string, { ms: number; short: string }> = {\n  s: { ms: SECOND_MS, short: 's' },\n  sec: { ms: SECOND_MS, short: 's' },\n  secs: { ms: SECOND_MS, short: 's' },\n  second: { ms: SECOND_MS, short: 's' },\n  seconds: { ms: SECOND_MS, short: 's' },\n  m: { ms: MINUTE_MS, short: 'm' },\n  min: { ms: MINUTE_MS, short: 'm' },\n  mins: { ms: MINUTE_MS, short: 'm' },\n  minute: { ms: MINUTE_MS, short: 'm' },\n  minutes: { ms: MINUTE_MS, short: 'm' },\n  h: { ms: HOUR_MS, short: 'h' },\n  hr: { ms: HOUR_MS, short: 'h' },\n  hrs: { ms: HOUR_MS, short: 'h' },\n  hour: { ms: HOUR_MS, short: 'h' },\n  hours: { ms: HOUR_MS, short: 'h' },\n  d: { ms: DAY_MS, short: 'd' },\n  day: { ms: DAY_MS, short: 'd' },\n  days: { ms: DAY_MS, short: 'd' },\n};\n\nconst INTERVAL_RE = /^(\\d+)\\s*([a-z]+)$/i;\n\n/** Parse `5m`, `2h`, `1 day`, `90 minutes` into milliseconds plus a normalized label. */\nexport function parseInterval(text: string): ParsedInterval | IntervalError {\n  const match = INTERVAL_RE.exec(text.trim());\n  if (!match) {\n    return { error: `Invalid interval \"${text}\". Use a number followed by a unit, e.g. 5m, 2h, 1d.` };\n  }\n  const value = Number(match[1]);\n  const unit = UNIT_MS[match[2]!.toLowerCase()];\n  if (!unit) {\n    return { error: `Unknown interval unit \"${match[2]}\". Use s, m, h, or d.` };\n  }\n  if (value <= 0) {\n    return { error: 'Interval must be greater than zero.' };\n  }\n  return { ms: value * unit.ms, label: `${value}${unit.short}` };\n}\n\nexport type IntervalCheck = { ok: true } | { error: string; suggestion?: string };\n\nconst MINUTE_DIVISORS = [1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30, 60];\nconst HOUR_DIVISORS = [1, 2, 3, 4, 6, 8, 12, 24];\n\nfunction nearest(candidates: number[], target: number): number {\n  return candidates.reduce((best, candidate) =>\n    Math.abs(candidate - target) < Math.abs(best - target) ? candidate : best,\n  );\n}\n\n/**\n * Check that an interval fires on stable clock boundaries: whole minutes that\n * divide the hour, whole hours that divide the day, or exactly one day.\n */\nexport function validateInterval({ ms }: { ms: number }): IntervalCheck {\n  if (ms < MINUTE_MS) {\n    return { error: 'Schedules fire at most once per minute.', suggestion: '1m' };\n  }\n  if (ms % MINUTE_MS !== 0) {\n    const minutes = Math.round(ms / MINUTE_MS);\n    return {\n      error: 'Interval must be a whole number of minutes.',\n      suggestion: `${Math.max(1, nearest(MINUTE_DIVISORS, minutes))}m`,\n    };\n  }\n  const minutes = ms / MINUTE_MS;\n  if (minutes < 60) {\n    if (60 % minutes === 0) {\n      return { ok: true };\n    }\n    return {\n      error: `${minutes}m does not divide an hour evenly.`,\n      suggestion: `${nearest(MINUTE_DIVISORS, minutes)}m`,\n    };\n  }\n  if (minutes % 60 !== 0) {\n    const hours = Math.round(minutes / 60);\n    return {\n      error: `${minutes}m is not a whole number of hours.`,\n      suggestion: hours < 24 ? `${nearest(HOUR_DIVISORS, hours)}h` : '1d',\n    };\n  }\n  const hours = minutes / 60;\n  if (hours < 24) {\n    if (24 % hours === 0) {\n      return { ok: true };\n    }\n    return {\n      error: `${hours}h does not divide a day evenly.`,\n      suggestion: `${nearest(HOUR_DIVISORS, hours)}h`,\n    };\n  }\n  if (hours === 24) {\n    return { ok: true };\n  }\n  return {\n    error: 'Intervals longer than one day are not supported.',\n    suggestion: '1d',\n  };\n}\n\n/** Hour-and-longer cadences: which local wall-clock slot a minute belongs to. */\nfunction hourSlotKey(date: Date, stepHours: number): number {\n  return (\n    ((date.getFullYear() * 12 + date.getMonth()) * 31 + date.getDate()) * 24 +\n    Math.floor(date.getHours() / stepHours) * stepHours\n  );\n}\n\n/**\n * The first boundary strictly after `after`, on the local wall clock\n * (5m → :00, :05, ...; 2h → 00:00, 02:00, ...; 1d → midnight). `intervalMs`\n * must pass {@link validateInterval}.\n *\n * Around daylight-saving changes this behaves like cron:\n * - Sub-hour cadences follow the minute hand, so they keep firing every N real\n *   minutes through both the skipped and the repeated hour. Across a\n *   half-hour change, the gap between fires never exceeds the interval.\n * - Hourly and daily cadences fire once per wall-clock slot. A boundary that\n *   falls in a skipped hour fires at the first minute after the jump (02:00 →\n *   03:00), and a repeated hour does not fire a second time.\n *\n * Computing from `after` rather than from the previous fire means a late\n * timer (sleep, busy event loop) skips missed boundaries instead of bursting\n * to catch up.\n */\nexport function nextFireTime(intervalMs: number, after: number): number {\n  // Truncate in UTC: local setters resolve a repeated hour to its first occurrence.\n  const cursor = new Date(Math.floor(after / MINUTE_MS) * MINUTE_MS);\n  const stepMinutes = intervalMs / MINUTE_MS;\n  // Walk minute by minute: at most an hour for sub-hour cadences, ~a day otherwise.\n  if (stepMinutes < 60) {\n    // Never wait longer than one interval: a half-hour clock change (Lord Howe\n    // Island) can otherwise shift the minute hand past the next boundary.\n    const latest = cursor.getTime() + intervalMs;\n    do cursor.setTime(cursor.getTime() + MINUTE_MS);\n    while (cursor.getMinutes() % stepMinutes !== 0 && cursor.getTime() < latest);\n    return cursor.getTime();\n  }\n  const stepHours = stepMinutes / 60;\n  const startSlot = hourSlotKey(new Date(after), stepHours);\n  do cursor.setTime(cursor.getTime() + MINUTE_MS);\n  while (hourSlotKey(cursor, stepHours) <= startSlot);\n  return cursor.getTime();\n}\n"],"mappings":"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"}

package/dist/schedules/prompt.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Fire-time prompt assembly for Mastra Code schedules.
+ *
+ * File-backed schedules only hold a descriptor; each fire runs the script or
+ * re-reads the file so the model always sees current output. Failures become
+ * the prompt text rather than a skipped fire — a schedule that silently stops
+ * delivering is worse than one that reports "the script broke".
+ */
+import type { ThreadSchedule } from './scheduler.js';
+export declare const SCRIPT_TIMEOUT_MS = 60000;
+export type ScriptResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+};
+export type RunScript = (absPath: string, options: {
+    cwd: string;
+    timeoutMs: number;
+}) => Promise<ScriptResult>;
+/**
+ * One fire's prompt. `outcome` summarizes a file-backed fire for the
+ * transcript header: `exit 0`, `exit 3`, `killed` (timeout/signal), or
+ * `failed` (the file could not be run or read).
+ */
+export type AssembledPrompt = {
+    prompt: string;
+    outcome?: string;
+};
+export type AssemblePromptOptions = {
+    cwd: string;
+    runScript: RunScript;
+    readFile: (absPath: string) => Promise<string>;
+};
+export declare function formatScriptOutput(displayPath: string, result: ScriptResult): string;
+export declare function assembleSchedulePrompt(spec: Pick<ThreadSchedule, 'prompt' | 'file' | 'extraPrompt'>, options: AssemblePromptOptions): Promise<AssembledPrompt>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/schedules/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/schedules/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEvF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhH;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAMpF;AAMD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC,EAC7D,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/schedules/prompt.js

@@ -0,0 +1,39 @@
+//#region src/schedules/prompt.ts
+const SCRIPT_TIMEOUT_MS = 6e4;
+function appendExtra(text, extra) {
+	return extra ? `${text}\n\n${extra}` : text;
+}
+function formatScriptOutput(displayPath, result) {
+	const body = [result.stdout, result.stderr].map((part) => part.trimEnd()).filter(Boolean).join("\n");
+	return `Output of ${displayPath} (exit ${result.exitCode ?? "null"}):\n${body || "(no output)"}`;
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+async function assembleSchedulePrompt(spec, options) {
+	const { file } = spec;
+	if (!file) return { prompt: spec.prompt ?? "" };
+	let text;
+	let outcome;
+	try {
+		if (file.mode === "script") {
+			const result = await options.runScript(file.path, {
+				cwd: options.cwd,
+				timeoutMs: SCRIPT_TIMEOUT_MS
+			});
+			text = formatScriptOutput(file.displayPath, result);
+			outcome = result.exitCode === null ? "killed" : `exit ${result.exitCode}`;
+		} else text = (await options.readFile(file.path)).trim();
+	} catch (error) {
+		text = `Schedule ${file.displayPath} failed: ${errorMessage(error)}`;
+		outcome = "failed";
+	}
+	return {
+		prompt: appendExtra(text, spec.extraPrompt),
+		...outcome ? { outcome } : {}
+	};
+}
+//#endregion
+export { SCRIPT_TIMEOUT_MS, assembleSchedulePrompt, formatScriptOutput };
+
+//# sourceMappingURL=prompt.js.map

package/dist/schedules/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","names":[],"sources":["../../src/schedules/prompt.ts"],"sourcesContent":["/**\n * Fire-time prompt assembly for Mastra Code schedules.\n *\n * File-backed schedules only hold a descriptor; each fire runs the script or\n * re-reads the file so the model always sees current output. Failures become\n * the prompt text rather than a skipped fire — a schedule that silently stops\n * delivering is worse than one that reports \"the script broke\".\n */\nimport type { ThreadSchedule } from './scheduler.js';\n\nexport const SCRIPT_TIMEOUT_MS = 60_000;\n\nexport type ScriptResult = { stdout: string; stderr: string; exitCode: number | null };\n\nexport type RunScript = (absPath: string, options: { cwd: string; timeoutMs: number }) => Promise<ScriptResult>;\n\n/**\n * One fire's prompt. `outcome` summarizes a file-backed fire for the\n * transcript header: `exit 0`, `exit 3`, `killed` (timeout/signal), or\n * `failed` (the file could not be run or read).\n */\nexport type AssembledPrompt = { prompt: string; outcome?: string };\n\nexport type AssemblePromptOptions = {\n  cwd: string;\n  runScript: RunScript;\n  readFile: (absPath: string) => Promise<string>;\n};\n\nfunction appendExtra(text: string, extra: string | undefined): string {\n  return extra ? `${text}\\n\\n${extra}` : text;\n}\n\nexport function formatScriptOutput(displayPath: string, result: ScriptResult): string {\n  const body = [result.stdout, result.stderr]\n    .map(part => part.trimEnd())\n    .filter(Boolean)\n    .join('\\n');\n  return `Output of ${displayPath} (exit ${result.exitCode ?? 'null'}):\\n${body || '(no output)'}`;\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport async function assembleSchedulePrompt(\n  spec: Pick<ThreadSchedule, 'prompt' | 'file' | 'extraPrompt'>,\n  options: AssemblePromptOptions,\n): Promise<AssembledPrompt> {\n  const { file } = spec;\n  if (!file) return { prompt: spec.prompt ?? '' };\n\n  let text: string;\n  let outcome: string | undefined;\n  try {\n    if (file.mode === 'script') {\n      const result = await options.runScript(file.path, { cwd: options.cwd, timeoutMs: SCRIPT_TIMEOUT_MS });\n      text = formatScriptOutput(file.displayPath, result);\n      outcome = result.exitCode === null ? 'killed' : `exit ${result.exitCode}`;\n    } else {\n      text = (await options.readFile(file.path)).trim();\n    }\n  } catch (error) {\n    text = `Schedule ${file.displayPath} failed: ${errorMessage(error)}`;\n    outcome = 'failed';\n  }\n  return { prompt: appendExtra(text, spec.extraPrompt), ...(outcome ? { outcome } : {}) };\n}\n"],"mappings":";AAUA,MAAa,oBAAoB;AAmBjC,SAAS,YAAY,MAAc,OAAmC;CACpE,OAAO,QAAQ,GAAG,KAAK,MAAM,UAAU;AACzC;AAEA,SAAgB,mBAAmB,aAAqB,QAA8B;CACpF,MAAM,OAAO,CAAC,OAAO,QAAQ,OAAO,MAAM,CAAC,CACxC,KAAI,SAAQ,KAAK,QAAQ,CAAC,CAAC,CAC3B,OAAO,OAAO,CAAC,CACf,KAAK,IAAI;CACZ,OAAO,aAAa,YAAY,SAAS,OAAO,YAAY,OAAO,MAAM,QAAQ;AACnF;AAEA,SAAS,aAAa,OAAwB;CAC5C,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAEA,eAAsB,uBACpB,MACA,SAC0B;CAC1B,MAAM,EAAE,SAAS;CACjB,IAAI,CAAC,MAAM,OAAO,EAAE,QAAQ,KAAK,UAAU,GAAG;CAE9C,IAAI;CACJ,IAAI;CACJ,IAAI;EACF,IAAI,KAAK,SAAS,UAAU;GAC1B,MAAM,SAAS,MAAM,QAAQ,UAAU,KAAK,MAAM;IAAE,KAAK,QAAQ;IAAK,WAAW;GAAkB,CAAC;GACpG,OAAO,mBAAmB,KAAK,aAAa,MAAM;GAClD,UAAU,OAAO,aAAa,OAAO,WAAW,QAAQ,OAAO;EACjE,OACE,QAAQ,MAAM,QAAQ,SAAS,KAAK,IAAI,EAAA,CAAG,KAAK;CAEpD,SAAS,OAAO;EACd,OAAO,YAAY,KAAK,YAAY,WAAW,aAAa,KAAK;EACjE,UAAU;CACZ;CACA,OAAO;EAAE,QAAQ,YAAY,MAAM,KAAK,WAAW;EAAG,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;CAAG;AACxF"}

package/dist/schedules/run-script.d.ts

@@ -0,0 +1,8 @@
+import type { RunScript } from './prompt.js';
+export declare function isExecutableFile(absPath: string): boolean;
+export declare function resolveScriptCommand(absPath: string): {
+    command: string;
+    args: string[];
+};
+export declare const runScript: RunScript;
+//# sourceMappingURL=run-script.d.ts.map

package/dist/schedules/run-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-script.d.ts","sourceRoot":"","sources":["../../src/schedules/run-script.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAc3D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAOzF;AAED,eAAO,MAAM,SAAS,EAAE,SAyBvB,CAAC"}

package/dist/schedules/run-script.js

@@ -0,0 +1,83 @@
+import * as path$1 from "path";
+import { execFile } from "child_process";
+import * as fs$1 from "fs";
+//#region src/schedules/run-script.ts
+/**
+* Runs a schedule's script file at fire time.
+*
+* The file path is always passed as the literal command (or as the single
+* argument to a fixed interpreter) — never through a shell string — so the
+* user's extra prompt can never be interpolated into a command line.
+*/
+/** Interpreter for scripts that lack an executable bit, keyed by extension. */
+const INTERPRETERS = {
+	".sh": () => "/bin/sh",
+	".js": () => process.execPath,
+	".mjs": () => process.execPath,
+	".cjs": () => process.execPath,
+	".ts": () => process.execPath,
+	".py": () => "python3"
+};
+const MAX_OUTPUT_BYTES = 1024 * 1024;
+function isExecutableFile(absPath) {
+	try {
+		fs$1.accessSync(absPath, fs$1.constants.X_OK);
+		return fs$1.statSync(absPath).isFile();
+	} catch {
+		return false;
+	}
+}
+function resolveScriptCommand(absPath) {
+	if (isExecutableFile(absPath)) return {
+		command: absPath,
+		args: []
+	};
+	const interpreter = INTERPRETERS[path$1.extname(absPath).toLowerCase()];
+	if (!interpreter) throw new Error(`${absPath} is not executable and has no known interpreter`);
+	return {
+		command: interpreter(),
+		args: [absPath]
+	};
+}
+const runScript = async (absPath, { cwd, timeoutMs }) => {
+	const { command, args } = resolveScriptCommand(absPath);
+	return new Promise((resolve, reject) => {
+		execFile(command, args, {
+			cwd,
+			timeout: timeoutMs,
+			maxBuffer: MAX_OUTPUT_BYTES,
+			windowsHide: true
+		}, (error, stdout, stderr) => {
+			if (!error) {
+				resolve({
+					stdout,
+					stderr,
+					exitCode: 0
+				});
+				return;
+			}
+			const spawnError = error;
+			if (typeof spawnError.code === "number") {
+				resolve({
+					stdout,
+					stderr,
+					exitCode: spawnError.code
+				});
+				return;
+			}
+			if (spawnError.killed) {
+				resolve({
+					stdout,
+					stderr: `${stderr}\n[timed out after ${timeoutMs}ms]`.trim(),
+					exitCode: null
+				});
+				return;
+			}
+			reject(error);
+		});
+	});
+};
+//#endregion
+export { isExecutableFile, resolveScriptCommand, runScript };
+
+//# sourceMappingURL=run-script.js.map

package/dist/schedules/run-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-script.js","names":["fs","path"],"sources":["../../src/schedules/run-script.ts"],"sourcesContent":["/**\n * Runs a schedule's script file at fire time.\n *\n * The file path is always passed as the literal command (or as the single\n * argument to a fixed interpreter) — never through a shell string — so the\n * user's extra prompt can never be interpolated into a command line.\n */\nimport { execFile } from 'node:child_process';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { RunScript, ScriptResult } from './prompt.js';\n\n/** Interpreter for scripts that lack an executable bit, keyed by extension. */\nconst INTERPRETERS: Record<string, () => string> = {\n  '.sh': () => '/bin/sh',\n  '.js': () => process.execPath,\n  '.mjs': () => process.execPath,\n  '.cjs': () => process.execPath,\n  '.ts': () => process.execPath,\n  '.py': () => 'python3',\n};\n\nconst MAX_OUTPUT_BYTES = 1024 * 1024;\n\nexport function isExecutableFile(absPath: string): boolean {\n  try {\n    fs.accessSync(absPath, fs.constants.X_OK);\n    return fs.statSync(absPath).isFile();\n  } catch {\n    return false;\n  }\n}\n\nexport function resolveScriptCommand(absPath: string): { command: string; args: string[] } {\n  if (isExecutableFile(absPath)) return { command: absPath, args: [] };\n  const interpreter = INTERPRETERS[path.extname(absPath).toLowerCase()];\n  if (!interpreter) {\n    throw new Error(`${absPath} is not executable and has no known interpreter`);\n  }\n  return { command: interpreter(), args: [absPath] };\n}\n\nexport const runScript: RunScript = async (absPath, { cwd, timeoutMs }) => {\n  const { command, args } = resolveScriptCommand(absPath);\n  return new Promise<ScriptResult>((resolve, reject) => {\n    execFile(\n      command,\n      args,\n      { cwd, timeout: timeoutMs, maxBuffer: MAX_OUTPUT_BYTES, windowsHide: true },\n      (error, stdout, stderr) => {\n        if (!error) {\n          resolve({ stdout, stderr, exitCode: 0 });\n          return;\n        }\n        const spawnError = error as NodeJS.ErrnoException & { code?: number | string; killed?: boolean };\n        if (typeof spawnError.code === 'number') {\n          resolve({ stdout, stderr, exitCode: spawnError.code });\n          return;\n        }\n        if (spawnError.killed) {\n          resolve({ stdout, stderr: `${stderr}\\n[timed out after ${timeoutMs}ms]`.trim(), exitCode: null });\n          return;\n        }\n        reject(error);\n      },\n    );\n  });\n};\n"],"mappings":";;;;;;;;;;;;AAaA,MAAM,eAA6C;CACjD,aAAa;CACb,aAAa,QAAQ;CACrB,cAAc,QAAQ;CACtB,cAAc,QAAQ;CACtB,aAAa,QAAQ;CACrB,aAAa;AACf;AAEA,MAAM,mBAAmB,OAAO;AAEhC,SAAgB,iBAAiB,SAA0B;CACzD,IAAI;EACF,KAAG,WAAW,SAASA,KAAG,UAAU,IAAI;EACxC,OAAOA,KAAG,SAAS,OAAO,CAAC,CAAC,OAAO;CACrC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,qBAAqB,SAAsD;CACzF,IAAI,iBAAiB,OAAO,GAAG,OAAO;EAAE,SAAS;EAAS,MAAM,CAAC;CAAE;CACnE,MAAM,cAAc,aAAaC,OAAK,QAAQ,OAAO,CAAC,CAAC,YAAY;CACnE,IAAI,CAAC,aACH,MAAM,IAAI,MAAM,GAAG,QAAQ,gDAAgD;CAE7E,OAAO;EAAE,SAAS,YAAY;EAAG,MAAM,CAAC,OAAO;CAAE;AACnD;AAEA,MAAa,YAAuB,OAAO,SAAS,EAAE,KAAK,gBAAgB;CACzE,MAAM,EAAE,SAAS,SAAS,qBAAqB,OAAO;CACtD,OAAO,IAAI,SAAuB,SAAS,WAAW;EACpD,SACE,SACA,MACA;GAAE;GAAK,SAAS;GAAW,WAAW;GAAkB,aAAa;EAAK,IACzE,OAAO,QAAQ,WAAW;GACzB,IAAI,CAAC,OAAO;IACV,QAAQ;KAAE;KAAQ;KAAQ,UAAU;IAAE,CAAC;IACvC;GACF;GACA,MAAM,aAAa;GACnB,IAAI,OAAO,WAAW,SAAS,UAAU;IACvC,QAAQ;KAAE;KAAQ;KAAQ,UAAU,WAAW;IAAK,CAAC;IACrD;GACF;GACA,IAAI,WAAW,QAAQ;IACrB,QAAQ;KAAE;KAAQ,QAAQ,GAAG,OAAO,qBAAqB,UAAU,KAAK,KAAK;KAAG,UAAU;IAAK,CAAC;IAChG;GACF;GACA,OAAO,KAAK;EACd,CACF;CACF,CAAC;AACH"}

package/dist/schedules/scheduler.d.ts

@@ -0,0 +1,101 @@
+import type { ParsedInterval } from './interval.js';
+import type { AssembledPrompt } from './prompt.js';
+/** `source` attribute on fired signals; the TUI labels these turns `schedule`. */
+export declare const SCHEDULE_SIGNAL_SOURCE = "schedule";
+/** When a schedule fires. Only recurring `every` triggers exist today. */
+export type ScheduleTrigger = {
+    kind: 'every';
+    interval: ParsedInterval;
+};
+/** A file a schedule runs as a script, or re-reads and sends as the prompt, on every fire. */
+export type ScheduleFile = {
+    path: string;
+    displayPath: string;
+    mode: 'script' | 'prompt';
+};
+/** What to send on each fire: `prompt` text, or a `file` (plus `extraPrompt` appended after it). */
+export type ThreadScheduleSource = {
+    prompt: string;
+} | {
+    file: ScheduleFile;
+    extraPrompt?: string;
+};
+export type ThreadScheduleSpec = ThreadScheduleSource & {
+    trigger: ScheduleTrigger;
+    /** Who is creating it: the user via `/schedules`, or the agent via its schedule tools. Defaults to `user`. */
+    createdBy?: 'user' | 'agent';
+};
+export type ThreadSchedule = {
+    id: string;
+    threadId: string;
+    resourceId: string;
+    trigger: ScheduleTrigger;
+    prompt?: string;
+    file?: ScheduleFile;
+    extraPrompt?: string;
+    createdBy: 'user' | 'agent';
+    status: 'active' | 'paused';
+    /** Next boundary this schedule fires at; only meaningful while active. */
+    nextFireAt: number;
+    createdAt: number;
+};
+export type ThreadSchedulerOptions = {
+    /** Build the prompt for one fire (runs scripts / reads files). */
+    assemblePrompt: (schedule: ThreadSchedule) => Promise<AssembledPrompt>;
+    /** Hand the prompt to the agent for the schedule's thread. */
+    deliver: (schedule: ThreadSchedule, assembled: AssembledPrompt) => Promise<void>;
+    /** A fire failed before reaching the agent. */
+    onError?: (error: unknown, schedule: ThreadSchedule) => void;
+    now?: () => number;
+};
+/** How late a timer may run before its fire counts as missed (sleep, stalled event loop). */
+export declare const LATE_FIRE_GRACE_MS = 60000;
+/**
+ * Outcome of a manual `run()`. `failed` means nothing reached the agent: the
+ * prompt could not be built or the agent refused it.
+ */
+export type ScheduleRunResult = {
+    status: 'fired';
+} | {
+    status: 'failed';
+    error: unknown;
+} | {
+    status: 'busy';
+} | {
+    status: 'not-found';
+};
+export declare class ThreadScheduler {
+    #private;
+    constructor(options: ThreadSchedulerOptions);
+    /** Throws when the interval is not a supported wall-clock cadence (see `validateInterval`) or the prompt is empty. */
+    create(spec: ThreadScheduleSpec, target: {
+        threadId: string;
+        resourceId: string;
+    }): ThreadSchedule;
+    list(filter?: {
+        threadId?: string;
+    }): ThreadSchedule[];
+    delete(id: string): boolean;
+    pause(id: string): boolean;
+    resume(id: string): boolean;
+    /** Whether a fire of this schedule (timer or manual) is still assembling or delivering. */
+    isFiring(id: string): boolean;
+    /**
+     * Fire once now, outside the cadence. Returns `busy` without firing when a
+     * fire of this schedule is still running (a slow script, say), so the same
+     * script never runs twice at once. Resolves once the fire finished; a fire
+     * that never reached the agent resolves `failed` instead of calling `onError`.
+     */
+    run(id: string): Promise<ScheduleRunResult>;
+    /** Drop every schedule and timer (process shutdown). */
+    stop(): void;
+}
+export declare function shortScheduleId(id: string): string;
+/** One-line human summary of what a schedule sends: `run ./check.sh + "extra"`, `read notes.md`, `"prompt"`. */
+export declare function describeScheduleSource(schedule: Pick<ThreadSchedule, 'prompt' | 'file' | 'extraPrompt'>): string;
+/**
+ * Attributes on a fired schedule signal. They carry everything the transcript
+ * header needs, so reloaded history renders without the process-local entry.
+ */
+export declare function scheduleSignalAttributes(schedule: ThreadSchedule, assembled?: Pick<AssembledPrompt, 'outcome'>): Record<string, string>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/schedules/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/schedules/scheduler.ts"],"names":[],"mappings":"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"}

package/dist/schedules/scheduler.js

@@ -0,0 +1,169 @@
+import { nextFireTime, validateInterval } from "./interval.js";
+import { randomUUID } from "crypto";
+//#region src/schedules/scheduler.ts
+/**
+* Process-local scheduler behind `/schedules`.
+*
+* Schedules live only in this process: timers fire them and they die with it.
+* Nothing is written to shared storage, so other Mastra Code processes on the
+* same database never see — or fire — this session's schedules.
+*/
+/** `source` attribute on fired signals; the TUI labels these turns `schedule`. */
+const SCHEDULE_SIGNAL_SOURCE = "schedule";
+/** How late a timer may run before its fire counts as missed (sleep, stalled event loop). */
+const LATE_FIRE_GRACE_MS = 6e4;
+var ThreadScheduler = class {
+	#entries = /* @__PURE__ */ new Map();
+	#options;
+	constructor(options) {
+		this.#options = options;
+	}
+	#now() {
+		return this.#options.now?.() ?? Date.now();
+	}
+	/** Throws when the interval is not a supported wall-clock cadence (see `validateInterval`) or the prompt is empty. */
+	create(spec, target) {
+		const { interval } = spec.trigger;
+		const check = validateInterval(interval);
+		if ("error" in check) throw new Error(`Invalid schedule interval: ${check.error}${check.suggestion ? ` Try ${check.suggestion}.` : ""}`);
+		if ("prompt" in spec && !spec.prompt.trim()) throw new Error("Schedule prompt is empty.");
+		const now = this.#now();
+		const schedule = {
+			id: randomUUID(),
+			threadId: target.threadId,
+			resourceId: target.resourceId,
+			trigger: {
+				kind: "every",
+				interval: { ...interval }
+			},
+			..."file" in spec ? {
+				file: { ...spec.file },
+				...spec.extraPrompt ? { extraPrompt: spec.extraPrompt } : {}
+			} : { prompt: spec.prompt },
+			createdBy: spec.createdBy ?? "user",
+			status: "active",
+			nextFireAt: nextFireTime(interval.ms, now),
+			createdAt: now
+		};
+		const entry = {
+			schedule,
+			inFlight: 0
+		};
+		this.#entries.set(schedule.id, entry);
+		this.#arm(entry);
+		return { ...schedule };
+	}
+	list(filter = {}) {
+		return [...this.#entries.values()].map((entry) => ({ ...entry.schedule })).filter((schedule) => !filter.threadId || schedule.threadId === filter.threadId).sort((a, b) => a.createdAt - b.createdAt);
+	}
+	delete(id) {
+		const entry = this.#entries.get(id);
+		if (!entry) return false;
+		clearTimeout(entry.timer);
+		this.#entries.delete(id);
+		return true;
+	}
+	pause(id) {
+		const entry = this.#entries.get(id);
+		if (!entry) return false;
+		clearTimeout(entry.timer);
+		entry.timer = void 0;
+		entry.schedule.status = "paused";
+		return true;
+	}
+	resume(id) {
+		const entry = this.#entries.get(id);
+		if (!entry) return false;
+		if (entry.schedule.status === "active") return true;
+		entry.schedule.status = "active";
+		entry.schedule.nextFireAt = nextFireTime(entry.schedule.trigger.interval.ms, this.#now());
+		this.#arm(entry);
+		return true;
+	}
+	/** Whether a fire of this schedule (timer or manual) is still assembling or delivering. */
+	isFiring(id) {
+		return (this.#entries.get(id)?.inFlight ?? 0) > 0;
+	}
+	/**
+	* Fire once now, outside the cadence. Returns `busy` without firing when a
+	* fire of this schedule is still running (a slow script, say), so the same
+	* script never runs twice at once. Resolves once the fire finished; a fire
+	* that never reached the agent resolves `failed` instead of calling `onError`.
+	*/
+	async run(id) {
+		const entry = this.#entries.get(id);
+		if (!entry) return { status: "not-found" };
+		if (entry.inFlight > 0) return { status: "busy" };
+		const result = await this.#fire(entry);
+		if (result.kind === "failed") return {
+			status: "failed",
+			error: result.error
+		};
+		return result.kind === "delivered" ? { status: "fired" } : { status: "not-found" };
+	}
+	/** Drop every schedule and timer (process shutdown). */
+	stop() {
+		for (const entry of this.#entries.values()) clearTimeout(entry.timer);
+		this.#entries.clear();
+	}
+	#arm(entry) {
+		clearTimeout(entry.timer);
+		const scheduledAt = entry.schedule.nextFireAt;
+		entry.timer = setTimeout(() => {
+			if (this.#entries.get(entry.schedule.id) !== entry || entry.schedule.status !== "active") return;
+			const now = this.#now();
+			entry.schedule.nextFireAt = nextFireTime(entry.schedule.trigger.interval.ms, Math.max(now, scheduledAt));
+			this.#arm(entry);
+			if (now - scheduledAt > 6e4) return;
+			if (entry.inFlight === 0) this.#fire(entry).then((result) => {
+				if (result.kind === "failed") this.#options.onError?.(result.error, { ...entry.schedule });
+			});
+		}, Math.max(0, scheduledAt - this.#now()));
+		entry.timer.unref?.();
+	}
+	async #fire(entry) {
+		const schedule = { ...entry.schedule };
+		entry.inFlight++;
+		try {
+			const assembled = await this.#options.assemblePrompt(schedule);
+			if (this.#entries.get(schedule.id) !== entry) return { kind: "deleted" };
+			await this.#options.deliver(schedule, assembled);
+			return { kind: "delivered" };
+		} catch (error) {
+			return {
+				kind: "failed",
+				error
+			};
+		} finally {
+			entry.inFlight--;
+		}
+	}
+};
+function shortScheduleId(id) {
+	return id.slice(0, 8);
+}
+/** One-line human summary of what a schedule sends: `run ./check.sh + "extra"`, `read notes.md`, `"prompt"`. */
+function describeScheduleSource(schedule) {
+	if (!schedule.file) return `"${schedule.prompt ?? ""}"`;
+	const verb = schedule.file.mode === "script" ? "run" : "read";
+	const extra = schedule.extraPrompt ? ` + "${schedule.extraPrompt}"` : "";
+	return `${verb} ${schedule.file.displayPath}${extra}`;
+}
+/**
+* Attributes on a fired schedule signal. They carry everything the transcript
+* header needs, so reloaded history renders without the process-local entry.
+*/
+function scheduleSignalAttributes(schedule, assembled = {}) {
+	return {
+		source: SCHEDULE_SIGNAL_SOURCE,
+		scheduleId: schedule.id,
+		scheduleCadence: schedule.trigger.interval.label,
+		scheduleSource: describeScheduleSource(schedule),
+		scheduleCreatedBy: schedule.createdBy,
+		...assembled.outcome ? { scheduleOutcome: assembled.outcome } : {}
+	};
+}
+//#endregion
+export { LATE_FIRE_GRACE_MS, SCHEDULE_SIGNAL_SOURCE, ThreadScheduler, describeScheduleSource, scheduleSignalAttributes, shortScheduleId };
+
+//# sourceMappingURL=scheduler.js.map

package/dist/schedules/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","names":["#options","#now","#entries","#arm","#fire"],"sources":["../../src/schedules/scheduler.ts"],"sourcesContent":["/**\n * Process-local scheduler behind `/schedules`.\n *\n * Schedules live only in this process: timers fire them and they die with it.\n * Nothing is written to shared storage, so other Mastra Code processes on the\n * same database never see — or fire — this session's schedules.\n */\nimport { randomUUID } from 'node:crypto';\nimport { nextFireTime, validateInterval } from './interval.js';\nimport type { ParsedInterval } from './interval.js';\nimport type { AssembledPrompt } from './prompt.js';\n\n/** `source` attribute on fired signals; the TUI labels these turns `schedule`. */\nexport const SCHEDULE_SIGNAL_SOURCE = 'schedule';\n\n/** When a schedule fires. Only recurring `every` triggers exist today. */\nexport type ScheduleTrigger = { kind: 'every'; interval: ParsedInterval };\n\n/** A file a schedule runs as a script, or re-reads and sends as the prompt, on every fire. */\nexport type ScheduleFile = { path: string; displayPath: string; mode: 'script' | 'prompt' };\n\n/** What to send on each fire: `prompt` text, or a `file` (plus `extraPrompt` appended after it). */\nexport type ThreadScheduleSource = { prompt: string } | { file: ScheduleFile; extraPrompt?: string };\n\nexport type ThreadScheduleSpec = ThreadScheduleSource & {\n  trigger: ScheduleTrigger;\n  /** Who is creating it: the user via `/schedules`, or the agent via its schedule tools. Defaults to `user`. */\n  createdBy?: 'user' | 'agent';\n};\n\nexport type ThreadSchedule = {\n  id: string;\n  threadId: string;\n  resourceId: string;\n  trigger: ScheduleTrigger;\n  prompt?: string;\n  file?: ScheduleFile;\n  extraPrompt?: string;\n  createdBy: 'user' | 'agent';\n  status: 'active' | 'paused';\n  /** Next boundary this schedule fires at; only meaningful while active. */\n  nextFireAt: number;\n  createdAt: number;\n};\n\nexport type ThreadSchedulerOptions = {\n  /** Build the prompt for one fire (runs scripts / reads files). */\n  assemblePrompt: (schedule: ThreadSchedule) => Promise<AssembledPrompt>;\n  /** Hand the prompt to the agent for the schedule's thread. */\n  deliver: (schedule: ThreadSchedule, assembled: AssembledPrompt) => Promise<void>;\n  /** A fire failed before reaching the agent. */\n  onError?: (error: unknown, schedule: ThreadSchedule) => void;\n  now?: () => number;\n};\n\n/** How late a timer may run before its fire counts as missed (sleep, stalled event loop). */\nexport const LATE_FIRE_GRACE_MS = 60_000;\n\n/**\n * Outcome of a manual `run()`. `failed` means nothing reached the agent: the\n * prompt could not be built or the agent refused it.\n */\nexport type ScheduleRunResult =\n  | { status: 'fired' }\n  | { status: 'failed'; error: unknown }\n  | { status: 'busy' }\n  | { status: 'not-found' };\n\ntype FireOutcome = { kind: 'delivered' } | { kind: 'deleted' } | { kind: 'failed'; error: unknown };\n\ntype Entry = { schedule: ThreadSchedule; timer?: ReturnType<typeof setTimeout>; inFlight: number };\n\nexport class ThreadScheduler {\n  #entries = new Map<string, Entry>();\n  #options: ThreadSchedulerOptions;\n\n  constructor(options: ThreadSchedulerOptions) {\n    this.#options = options;\n  }\n\n  #now(): number {\n    return this.#options.now?.() ?? Date.now();\n  }\n\n  /** Throws when the interval is not a supported wall-clock cadence (see `validateInterval`) or the prompt is empty. */\n  create(spec: ThreadScheduleSpec, target: { threadId: string; resourceId: string }): ThreadSchedule {\n    const { interval } = spec.trigger;\n    const check = validateInterval(interval);\n    if ('error' in check) {\n      throw new Error(\n        `Invalid schedule interval: ${check.error}${check.suggestion ? ` Try ${check.suggestion}.` : ''}`,\n      );\n    }\n    if ('prompt' in spec && !spec.prompt.trim()) throw new Error('Schedule prompt is empty.');\n    const now = this.#now();\n    const schedule: ThreadSchedule = {\n      id: randomUUID(),\n      threadId: target.threadId,\n      resourceId: target.resourceId,\n      trigger: { kind: 'every', interval: { ...interval } },\n      ...('file' in spec\n        ? { file: { ...spec.file }, ...(spec.extraPrompt ? { extraPrompt: spec.extraPrompt } : {}) }\n        : { prompt: spec.prompt }),\n      createdBy: spec.createdBy ?? 'user',\n      status: 'active',\n      nextFireAt: nextFireTime(interval.ms, now),\n      createdAt: now,\n    };\n    const entry: Entry = { schedule, inFlight: 0 };\n    this.#entries.set(schedule.id, entry);\n    this.#arm(entry);\n    return { ...schedule };\n  }\n\n  list(filter: { threadId?: string } = {}): ThreadSchedule[] {\n    return [...this.#entries.values()]\n      .map(entry => ({ ...entry.schedule }))\n      .filter(schedule => !filter.threadId || schedule.threadId === filter.threadId)\n      .sort((a, b) => a.createdAt - b.createdAt);\n  }\n\n  delete(id: string): boolean {\n    const entry = this.#entries.get(id);\n    if (!entry) return false;\n    clearTimeout(entry.timer);\n    this.#entries.delete(id);\n    return true;\n  }\n\n  pause(id: string): boolean {\n    const entry = this.#entries.get(id);\n    if (!entry) return false;\n    clearTimeout(entry.timer);\n    entry.timer = undefined;\n    entry.schedule.status = 'paused';\n    return true;\n  }\n\n  resume(id: string): boolean {\n    const entry = this.#entries.get(id);\n    if (!entry) return false;\n    if (entry.schedule.status === 'active') return true;\n    entry.schedule.status = 'active';\n    entry.schedule.nextFireAt = nextFireTime(entry.schedule.trigger.interval.ms, this.#now());\n    this.#arm(entry);\n    return true;\n  }\n\n  /** Whether a fire of this schedule (timer or manual) is still assembling or delivering. */\n  isFiring(id: string): boolean {\n    return (this.#entries.get(id)?.inFlight ?? 0) > 0;\n  }\n\n  /**\n   * Fire once now, outside the cadence. Returns `busy` without firing when a\n   * fire of this schedule is still running (a slow script, say), so the same\n   * script never runs twice at once. Resolves once the fire finished; a fire\n   * that never reached the agent resolves `failed` instead of calling `onError`.\n   */\n  async run(id: string): Promise<ScheduleRunResult> {\n    const entry = this.#entries.get(id);\n    if (!entry) return { status: 'not-found' };\n    if (entry.inFlight > 0) return { status: 'busy' };\n    const result = await this.#fire(entry);\n    if (result.kind === 'failed') return { status: 'failed', error: result.error };\n    return result.kind === 'delivered' ? { status: 'fired' } : { status: 'not-found' };\n  }\n\n  /** Drop every schedule and timer (process shutdown). */\n  stop(): void {\n    for (const entry of this.#entries.values()) clearTimeout(entry.timer);\n    this.#entries.clear();\n  }\n\n  #arm(entry: Entry): void {\n    clearTimeout(entry.timer);\n    const scheduledAt = entry.schedule.nextFireAt;\n    entry.timer = setTimeout(\n      () => {\n        if (this.#entries.get(entry.schedule.id) !== entry || entry.schedule.status !== 'active') return;\n        // Timers can fire a hair early; step from the later of now and the\n        // intended boundary so the same boundary is never fired twice.\n        const now = this.#now();\n        entry.schedule.nextFireAt = nextFireTime(entry.schedule.trigger.interval.ms, Math.max(now, scheduledAt));\n        this.#arm(entry);\n        // A timer that ran long after its boundary (machine asleep) is a missed fire, not a late one.\n        if (now - scheduledAt > LATE_FIRE_GRACE_MS) return;\n        // A slow script can outlast a short interval; don't stack fires.\n        if (entry.inFlight === 0) {\n          void this.#fire(entry).then(result => {\n            if (result.kind === 'failed') this.#options.onError?.(result.error, { ...entry.schedule });\n          });\n        }\n      },\n      Math.max(0, scheduledAt - this.#now()),\n    );\n    entry.timer.unref?.();\n  }\n\n  async #fire(entry: Entry): Promise<FireOutcome> {\n    const schedule = { ...entry.schedule };\n    entry.inFlight++;\n    try {\n      const assembled = await this.#options.assemblePrompt(schedule);\n      // Deleted while its prompt was being built: drop the fire quietly.\n      if (this.#entries.get(schedule.id) !== entry) return { kind: 'deleted' };\n      await this.#options.deliver(schedule, assembled);\n      return { kind: 'delivered' };\n    } catch (error) {\n      return { kind: 'failed', error };\n    } finally {\n      entry.inFlight--;\n    }\n  }\n}\n\nexport function shortScheduleId(id: string): string {\n  return id.slice(0, 8);\n}\n\n/** One-line human summary of what a schedule sends: `run ./check.sh + \"extra\"`, `read notes.md`, `\"prompt\"`. */\nexport function describeScheduleSource(schedule: Pick<ThreadSchedule, 'prompt' | 'file' | 'extraPrompt'>): string {\n  if (!schedule.file) return `\"${schedule.prompt ?? ''}\"`;\n  const verb = schedule.file.mode === 'script' ? 'run' : 'read';\n  const extra = schedule.extraPrompt ? ` + \"${schedule.extraPrompt}\"` : '';\n  return `${verb} ${schedule.file.displayPath}${extra}`;\n}\n\n/**\n * Attributes on a fired schedule signal. They carry everything the transcript\n * header needs, so reloaded history renders without the process-local entry.\n */\nexport function scheduleSignalAttributes(\n  schedule: ThreadSchedule,\n  assembled: Pick<AssembledPrompt, 'outcome'> = {},\n): Record<string, string> {\n  return {\n    source: SCHEDULE_SIGNAL_SOURCE,\n    scheduleId: schedule.id,\n    scheduleCadence: schedule.trigger.interval.label,\n    scheduleSource: describeScheduleSource(schedule),\n    scheduleCreatedBy: schedule.createdBy,\n    ...(assembled.outcome ? { scheduleOutcome: assembled.outcome } : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/schedules/tools.d.ts

@@ -0,0 +1,57 @@
+import type { ThreadScheduler } from './scheduler.js';
+export declare const SCHEDULE_TOOL_IDS: {
+    readonly create: "schedule_create";
+    readonly list: "schedule_list";
+    readonly update: "schedule_update";
+    readonly resume: "schedule_resume";
+    readonly run: "schedule_run";
+};
+export type ScheduleFileOptions = {
+    /** Directory relative paths resolve against (the project root). */
+    cwd: string;
+    homeDir?: string;
+    fileExists: (absPath: string) => boolean;
+};
+export type ScheduleToolsOptions = {
+    scheduler: ThreadScheduler;
+    fileOptions: () => ScheduleFileOptions;
+};
+export declare function createScheduleTools({ scheduler, fileOptions }: ScheduleToolsOptions): {
+    schedule_create: import("@mastra/core/tools").Tool<{
+        trigger: {
+            kind: "every";
+            interval: import("./interval.js").ParsedInterval;
+        };
+        prompt?: string | undefined;
+        promptFile?: string | undefined;
+        script?: string | undefined;
+        extraPrompt?: string | undefined;
+    }, {
+        content: string;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "schedule_create", unknown>;
+    schedule_list: import("@mastra/core/tools").Tool<Record<string, never>, {
+        content: string;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "schedule_list", unknown>;
+    schedule_update: import("@mastra/core/tools").Tool<{
+        id: string;
+        action: "pause" | "delete";
+    }, {
+        content: string;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "schedule_update", unknown>;
+    schedule_resume: import("@mastra/core/tools").Tool<{
+        id: string;
+    }, {
+        content: string;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "schedule_resume", unknown>;
+    schedule_run: import("@mastra/core/tools").Tool<{
+        id: string;
+    }, {
+        content: string;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "schedule_run", unknown>;
+};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/schedules/tools.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAgC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpF,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,WAAW,EAAE,MAAM,mBAAmB,CAAC;CACxC,CAAC;AAiFF,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4InF"}