@mastra/code-sdk 1.12.0-alpha.8 → 1.12.0

package/dist/headless/cli.d.ts

@@ -8,6 +8,7 @@ export interface HeadlessArgs {
     output: OutputMode;
     continue_: boolean;
     model?: string;
+    pack?: string;
     mode?: RunMode;
     thinkingLevel?: ThinkingLevel;
     settings?: string;

package/dist/headless/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/headless/cli.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAsC9D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CA+BzC;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACzD,OAAO,CAAC,KAAK,CAAC,CAoJhB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/headless/cli.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAsC9D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CA+BzC;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACzD,OAAO,CAAC,KAAK,CAAC,CAoLhB"}

package/dist/headless/cli.js

@@ -1,9 +1,10 @@
 import { listBuiltinModePacks } from "../onboarding/packs.js";
-import { loadSettings, resolveModelDefaults } from "../onboarding/settings.js";
+import { loadSettings, resolveModelDefaults, saveSettings } from "../onboarding/settings.js";
 import { releaseAllThreadLocks } from "../utils/thread-lock.js";
 import { permissionModeToPolicy } from "./policy.js";
 import { runMC } from "./run-mc.js";
 import { createHumanFormatState, formatHuman, formatJsonl, renderJsonResult } from "./format.js";
+import { activateModePackInSettings, resolveModePackArg, resolvePackSelection } from "../onboarding/pack-activation.js";
 import { createProcessMemoryDiagnosticsFromEnvironment, startConfiguredProcessMemoryDiagnostics, stopProcessMemoryDiagnosticsWithTimeout } from "../process-memory-diagnostics.js";
 import { setupDebugLogging } from "../utils/debug-log.js";
 import { FLAGS, buildParseArgsOptions, renderFlagUsage } from "./flags.js";
@@ -134,6 +135,16 @@ async function runMCCli(predrainedInput, options) {
 		process.stderr.write(`Error: Settings file not found: ${args.settings}\n`);
 		process.exit(1);
 	}
+	const settings = loadSettings(args.settings);
+	let packId;
+	if (args.pack !== void 0) {
+		const resolved = resolveModePackArg(settings, args.pack);
+		if ("error" in resolved) {
+			process.stderr.write(`Error: ${resolved.error}\n`);
+			process.exit(1);
+		}
+		packId = resolved.packId;
+	}
 	const processMemoryDiagnostics = await startConfiguredProcessMemoryDiagnostics(createProcessMemoryDiagnosticsFromEnvironment(process.env), (warning) => {
 		process.stderr.write(`Warning: ${warning}\n`);
 	});
@@ -145,7 +156,7 @@ async function runMCCli(predrainedInput, options) {
 			coAuthor: options?.coAuthor
 		});
 		const { controller, session, mcpManager } = boot;
-		const effectiveDefaults = resolveModelDefaults(loadSettings(args.settings), listBuiltinModePacks());
+		const effectiveDefaults = resolveModelDefaults(settings, listBuiltinModePacks());
 		if (mcpManager?.hasServers()) try {
 			await mcpManager.initInBackground();
 		} catch (err) {
@@ -160,6 +171,14 @@ async function runMCCli(predrainedInput, options) {
 			model: args.model,
 			mode: args.mode,
 			modeDefaults: effectiveDefaults,
+			...packId ? { pack: {
+				id: packId,
+				resolve: (modeId) => resolvePackSelection(settings, packId, modeId),
+				onApplied: () => {
+					activateModePackInSettings(settings, packId);
+					saveSettings(settings, args.settings);
+				}
+			} } : {},
 			thinkingLevel: args.thinkingLevel,
 			thread: {
 				id: args.thread,

package/dist/headless/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../../src/headless/cli.ts"],"sourcesContent":["/**\n * CLI adapter for headless MastraCode runs.\n *\n * This is the only headless layer that touches the process: it parses argv,\n * reads stdin, bootstraps MastraCode via `createMastraCode`, drives `runMC`,\n * renders events/results to stdout/stderr through the pure formatters, maps the\n * result to an exit code, and owns teardown + `process.exit`.\n */\nimport { existsSync } from 'node:fs';\nimport { parseArgs } from 'node:util';\n\nimport { createMastraCode } from '../index.js';\nimport { listBuiltinModePacks } from '../onboarding/packs.js';\nimport { loadSettings, resolveModelDefaults } from '../onboarding/settings.js';\nimport {\n  createProcessMemoryDiagnosticsFromEnvironment,\n  startConfiguredProcessMemoryDiagnostics,\n  stopProcessMemoryDiagnosticsWithTimeout,\n} from '../process-memory-diagnostics.js';\nimport { setupDebugLogging } from '../utils/debug-log.js';\nimport { releaseAllThreadLocks } from '../utils/thread-lock.js';\n\nimport { buildParseArgsOptions, FLAGS, renderFlagUsage } from './flags.js';\nimport { createHumanFormatState, formatHuman, formatJsonl, renderJsonResult } from './format.js';\nimport { permissionModeToPolicy } from './policy.js';\nimport { runMC } from './run-mc.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\n\n/** Consolidated output mode (replaces the old `--format` + `--output-format`). */\nexport type OutputMode = 'human' | 'json' | 'jsonl';\n\nexport interface HeadlessArgs {\n  prompt?: string;\n  /** Timeout in seconds (CLI surface); converted to ms before `runMC`. */\n  timeout?: number;\n  output: OutputMode;\n  continue_: boolean;\n  model?: string;\n  mode?: RunMode;\n  thinkingLevel?: ThinkingLevel;\n  settings?: string;\n  thread?: string;\n  title?: string;\n  cloneThread: boolean;\n  resourceId?: string;\n  /** Max agentic turns before the run aborts with exit code 1. */\n  maxTurns?: number;\n  /** Named permission mode resolving to a built-in policy. Defaults to `auto`. */\n  permissionMode?: PermissionMode;\n}\n\nconst parseArgsOptions = buildParseArgsOptions();\nconst STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS = 2_000;\n\n/**\n * Returns true if `argv` selects headless mode. This must agree with what\n * {@link parseHeadlessArgs} (and `runMCCli`) accept as a prompt: `--prompt`/`-p`\n * or a bare positional prompt (e.g. `mastracode \"Fix the bug\"`). Note that a\n * prompt piped via stdin without a flag is handled separately by the caller.\n */\nexport function hasHeadlessFlag(argv: string[]): boolean {\n  if (argv.some(a => a === '--prompt' || a === '-p')) return true;\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv.slice(2),\n      options: parseArgsOptions,\n      strict: false,\n      allowPositionals: true,\n    });\n    // A positional prompt only counts when not asking for help.\n    return positionals.length > 0 && !values.help;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parse CLI arguments for headless mode. The flag table in `flags.ts` is the\n * single source of truth: each flag carries its own coercion/validation, so this\n * function just walks {@link FLAGS} and assembles the typed {@link HeadlessArgs}.\n */\nexport function parseHeadlessArgs(argv: string[]): HeadlessArgs {\n  const { values, positionals } = parseArgs({\n    args: argv.slice(2),\n    options: parseArgsOptions,\n    strict: false,\n    allowPositionals: true,\n  });\n\n  // Seed defaults; per-flag values below override these.\n  const args: HeadlessArgs = {\n    output: 'human',\n    continue_: false,\n    cloneThread: false,\n  };\n  const sink = args as unknown as Record<string, unknown>;\n\n  for (const flag of FLAGS) {\n    if (!flag.field) continue; // e.g. --help, handled by the caller\n    const raw = values[flag.key];\n    if (raw === undefined) continue;\n\n    if (flag.type === 'boolean') {\n      sink[flag.field] = Boolean(raw);\n    } else if (typeof raw === 'string') {\n      sink[flag.field] = flag.coerce ? flag.coerce(raw) : raw;\n    }\n  }\n\n  // A bare positional acts as the prompt when --prompt/-p is absent.\n  if (args.prompt === undefined && positionals[0] !== undefined) {\n    args.prompt = positionals[0];\n  }\n\n  if (args.continue_ && args.thread) {\n    throw new Error('--continue and --thread cannot be used together');\n  }\n\n  return args;\n}\n\nexport function printHeadlessUsage(): void {\n  process.stdout.write(`\nUsage: mastracode --prompt <text> [options]\n\nHeadless (non-interactive) mode options:\n${renderFlagUsage()}\n\nThread behavior:\n  By default, a new thread is created for each run.\n  Use --continue to resume the most recent thread, or --thread to target a specific one.\n  Use --clone-thread to branch off a copy before running.\n\nSettings file:\n  Uses the same settings.json as the interactive TUI. Pass --settings to use\n  a custom settings file (e.g., settings-ci.json for CI). All model, pack,\n  subagent, and OM configuration is resolved from settings at startup.\n\nExit codes:\n  0  Agent completed successfully\n  1  Error, aborted, or max turns reached\n  2  Timeout\n\nExamples:\n  mastracode --prompt \"Fix the bug in auth.ts\"\n  mastracode --prompt \"Add tests\" --timeout 300 --output json\n  mastracode --prompt \"Refactor\" --output jsonl\n  mastracode --prompt \"Review this PR\" --permission-mode deny --max-turns 10\n  mastracode --settings ./settings-ci.json --prompt \"Run tests\"\n  mastracode -c --prompt \"Continue where you left off\"\n  echo \"Summarize the repo\" | mastracode --prompt -\n`);\n}\n\n/**\n * Headless CLI entry point: parse arguments, read stdin, initialize MastraCode,\n * run via `runMC`, render output, and exit with the mapped code.\n */\nexport async function runMCCli(\n  predrainedInput?: string | null,\n  options?: { coAuthor?: { name?: string; email?: string } },\n): Promise<never> {\n  if (process.argv.includes('--help') || process.argv.includes('-h')) {\n    printHeadlessUsage();\n    process.exit(0);\n  }\n\n  let args: HeadlessArgs;\n  try {\n    args = parseHeadlessArgs(process.argv);\n  } catch (e) {\n    process.stderr.write(`Error: ${(e as Error).message}\\n`);\n    process.exit(1);\n  }\n\n  let prompt = args.prompt;\n  if (predrainedInput !== undefined) {\n    prompt = predrainedInput ?? '';\n  } else if (prompt === '-' || (!prompt && !process.stdin.isTTY)) {\n    const chunks: Buffer[] = [];\n    for await (const chunk of process.stdin) {\n      chunks.push(chunk as Buffer);\n    }\n    prompt = Buffer.concat(chunks).toString('utf-8').trim();\n  }\n\n  if (!prompt) {\n    printHeadlessUsage();\n    process.stderr.write('Error: --prompt is required (or pipe via stdin)\\n');\n    process.exit(1);\n  }\n\n  if (args.settings && !existsSync(args.settings)) {\n    process.stderr.write(`Error: Settings file not found: ${args.settings}\\n`);\n    process.exit(1);\n  }\n\n  const diagnosticsSetup = createProcessMemoryDiagnosticsFromEnvironment(process.env);\n  const processMemoryDiagnostics = await startConfiguredProcessMemoryDiagnostics(diagnosticsSetup, warning => {\n    process.stderr.write(`Warning: ${warning}\\n`);\n  });\n\n  let boot: Awaited<ReturnType<typeof createMastraCode>> | undefined;\n  // Default to a non-zero exit so an unexpected throw before the run resolves\n  // still surfaces as a failure to the caller / CI.\n  let exitCode = 1;\n  try {\n    boot = await createMastraCode({ settingsPath: args.settings, coAuthor: options?.coAuthor });\n    const { controller, session, mcpManager } = boot;\n    const effectiveDefaults = resolveModelDefaults(loadSettings(args.settings), listBuiltinModePacks());\n\n    if (mcpManager?.hasServers()) {\n      try {\n        await mcpManager.initInBackground();\n      } catch (err) {\n        process.stderr.write(`Warning: MCP server initialization failed: ${(err as Error).message ?? err}\\n`);\n      }\n    }\n\n    setupDebugLogging();\n\n    const humanState = createHumanFormatState();\n    const run = runMC({\n      controller,\n      session,\n      prompt,\n      model: args.model,\n      mode: args.mode,\n      modeDefaults: effectiveDefaults,\n      thinkingLevel: args.thinkingLevel,\n      thread: { id: args.thread, continueLatest: args.continue_, clone: args.cloneThread },\n      resourceId: args.resourceId,\n      title: args.title,\n      timeoutMs: args.timeout ? args.timeout * 1000 : undefined,\n      maxTurns: args.maxTurns,\n      policy: args.permissionMode ? permissionModeToPolicy(args.permissionMode) : undefined,\n    });\n\n    // Stream live events for human + jsonl modes. (json mode prints only the final object.)\n    for await (const event of run) {\n      if (args.output === 'human') {\n        const out = formatHuman(event, humanState);\n        if (out.stdout) process.stdout.write(out.stdout);\n        if (out.stderr) process.stderr.write(out.stderr);\n      } else if (args.output === 'jsonl') {\n        process.stdout.write(JSON.stringify(formatJsonl(event)) + '\\n');\n      }\n    }\n\n    const result = await run.result;\n    exitCode = result.exitCode;\n\n    if (args.output === 'json') {\n      process.stdout.write(renderJsonResult(result));\n    } else if (args.output === 'jsonl') {\n      process.stdout.write(JSON.stringify({ type: 'result', ...result }) + '\\n');\n    }\n\n    if (result.status === 'timeout') {\n      process.stderr.write(`\\nTimeout elapsed. Aborted.\\n`);\n    } else if (result.error && args.output === 'human') {\n      process.stderr.write(`Error: ${result.error.message}\\n`);\n    }\n  } catch (err) {\n    process.stderr.write(`Error: ${(err as Error).message ?? err}\\n`);\n    exitCode = 1;\n  } finally {\n    // --- Teardown (always runs, even on a thrown error) ---\n    releaseAllThreadLocks();\n    if (boot) {\n      // Stop plugin-contributed signal providers (and the plugin reload listener)\n      // before quiescing workers: a provider that keeps polling past this point\n      // could dispatch into a controller that is shutting down. Release thread\n      // claims first so a restarted process need not wait out this teardown.\n      try {\n        boot.releaseThreadClaims();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      try {\n        boot.stopPluginSignalProviders();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      const { controller, mcpManager } = boot;\n      // Release notification dispatch leases before the pubsub that holds them\n      // closes. Headless has no shutdown deadline, so don't let a stalled\n      // in-flight dispatch hold up exit.\n      await Promise.race([\n        boot.stopNotificationDispatch?.().catch(() => {}),\n        new Promise<void>(resolve => setTimeout(resolve, STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS).unref()),\n      ]);\n      await Promise.allSettled([\n        mcpManager?.disconnect(),\n        controller.getMastra()?.stopWorkers(),\n        controller.stopIntervals(),\n      ]);\n      // The signals pubsub is Mastra's event bus, so close it after the workers\n      // stop. Call close() on the object; a detached method loses `this` and\n      // rejects silently, leaving socket files behind.\n      const signalsPubSub = boot.signalsPubSub as { close?: () => Promise<void> | void } | undefined;\n      await Promise.allSettled([signalsPubSub?.close?.()]);\n    }\n    await stopProcessMemoryDiagnosticsWithTimeout(processMemoryDiagnostics, warning => {\n      process.stderr.write(`Warning: ${warning}\\n`);\n    });\n  }\n\n  process.exit(exitCode);\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":[],"sources":["../../src/headless/cli.ts"],"sourcesContent":["/**\n * CLI adapter for headless MastraCode runs.\n *\n * This is the only headless layer that touches the process: it parses argv,\n * reads stdin, bootstraps MastraCode via `createMastraCode`, drives `runMC`,\n * renders events/results to stdout/stderr through the pure formatters, maps the\n * result to an exit code, and owns teardown + `process.exit`.\n */\nimport { existsSync } from 'node:fs';\nimport { parseArgs } from 'node:util';\n\nimport { createMastraCode } from '../index.js';\nimport { activateModePackInSettings, resolveModePackArg, resolvePackSelection } from '../onboarding/pack-activation.js';\nimport { listBuiltinModePacks } from '../onboarding/packs.js';\nimport { loadSettings, resolveModelDefaults, saveSettings } from '../onboarding/settings.js';\nimport {\n  createProcessMemoryDiagnosticsFromEnvironment,\n  startConfiguredProcessMemoryDiagnostics,\n  stopProcessMemoryDiagnosticsWithTimeout,\n} from '../process-memory-diagnostics.js';\nimport { setupDebugLogging } from '../utils/debug-log.js';\nimport { releaseAllThreadLocks } from '../utils/thread-lock.js';\n\nimport { buildParseArgsOptions, FLAGS, renderFlagUsage } from './flags.js';\nimport { createHumanFormatState, formatHuman, formatJsonl, renderJsonResult } from './format.js';\nimport { permissionModeToPolicy } from './policy.js';\nimport { runMC } from './run-mc.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\n\n/** Consolidated output mode (replaces the old `--format` + `--output-format`). */\nexport type OutputMode = 'human' | 'json' | 'jsonl';\n\nexport interface HeadlessArgs {\n  prompt?: string;\n  /** Timeout in seconds (CLI surface); converted to ms before `runMC`. */\n  timeout?: number;\n  output: OutputMode;\n  continue_: boolean;\n  model?: string;\n  pack?: string;\n  mode?: RunMode;\n  thinkingLevel?: ThinkingLevel;\n  settings?: string;\n  thread?: string;\n  title?: string;\n  cloneThread: boolean;\n  resourceId?: string;\n  /** Max agentic turns before the run aborts with exit code 1. */\n  maxTurns?: number;\n  /** Named permission mode resolving to a built-in policy. Defaults to `auto`. */\n  permissionMode?: PermissionMode;\n}\n\nconst parseArgsOptions = buildParseArgsOptions();\nconst STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS = 2_000;\n\n/**\n * Returns true if `argv` selects headless mode. This must agree with what\n * {@link parseHeadlessArgs} (and `runMCCli`) accept as a prompt: `--prompt`/`-p`\n * or a bare positional prompt (e.g. `mastracode \"Fix the bug\"`). Note that a\n * prompt piped via stdin without a flag is handled separately by the caller.\n */\nexport function hasHeadlessFlag(argv: string[]): boolean {\n  if (argv.some(a => a === '--prompt' || a === '-p')) return true;\n  try {\n    const { values, positionals } = parseArgs({\n      args: argv.slice(2),\n      options: parseArgsOptions,\n      strict: false,\n      allowPositionals: true,\n    });\n    // A positional prompt only counts when not asking for help.\n    return positionals.length > 0 && !values.help;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Parse CLI arguments for headless mode. The flag table in `flags.ts` is the\n * single source of truth: each flag carries its own coercion/validation, so this\n * function just walks {@link FLAGS} and assembles the typed {@link HeadlessArgs}.\n */\nexport function parseHeadlessArgs(argv: string[]): HeadlessArgs {\n  const { values, positionals } = parseArgs({\n    args: argv.slice(2),\n    options: parseArgsOptions,\n    strict: false,\n    allowPositionals: true,\n  });\n\n  // Seed defaults; per-flag values below override these.\n  const args: HeadlessArgs = {\n    output: 'human',\n    continue_: false,\n    cloneThread: false,\n  };\n  const sink = args as unknown as Record<string, unknown>;\n\n  for (const flag of FLAGS) {\n    if (!flag.field) continue; // e.g. --help, handled by the caller\n    const raw = values[flag.key];\n    if (raw === undefined) continue;\n\n    if (flag.type === 'boolean') {\n      sink[flag.field] = Boolean(raw);\n    } else if (typeof raw === 'string') {\n      sink[flag.field] = flag.coerce ? flag.coerce(raw) : raw;\n    }\n  }\n\n  // A bare positional acts as the prompt when --prompt/-p is absent.\n  if (args.prompt === undefined && positionals[0] !== undefined) {\n    args.prompt = positionals[0];\n  }\n\n  if (args.continue_ && args.thread) {\n    throw new Error('--continue and --thread cannot be used together');\n  }\n\n  return args;\n}\n\nexport function printHeadlessUsage(): void {\n  process.stdout.write(`\nUsage: mastracode --prompt <text> [options]\n\nHeadless (non-interactive) mode options:\n${renderFlagUsage()}\n\nThread behavior:\n  By default, a new thread is created for each run.\n  Use --continue to resume the most recent thread, or --thread to target a specific one.\n  Use --clone-thread to branch off a copy before running.\n\nSettings file:\n  Uses the same settings.json as the interactive TUI. Pass --settings to use\n  a custom settings file (e.g., settings-ci.json for CI). All model, pack,\n  subagent, and OM configuration is resolved from settings at startup.\n\nExit codes:\n  0  Agent completed successfully\n  1  Error, aborted, or max turns reached\n  2  Timeout\n\nExamples:\n  mastracode --prompt \"Fix the bug in auth.ts\"\n  mastracode --prompt \"Add tests\" --timeout 300 --output json\n  mastracode --prompt \"Refactor\" --output jsonl\n  mastracode --prompt \"Review this PR\" --permission-mode deny --max-turns 10\n  mastracode --settings ./settings-ci.json --prompt \"Run tests\"\n  mastracode -c --prompt \"Continue where you left off\"\n  echo \"Summarize the repo\" | mastracode --prompt -\n`);\n}\n\n/**\n * Headless CLI entry point: parse arguments, read stdin, initialize MastraCode,\n * run via `runMC`, render output, and exit with the mapped code.\n */\nexport async function runMCCli(\n  predrainedInput?: string | null,\n  options?: { coAuthor?: { name?: string; email?: string } },\n): Promise<never> {\n  if (process.argv.includes('--help') || process.argv.includes('-h')) {\n    printHeadlessUsage();\n    process.exit(0);\n  }\n\n  let args: HeadlessArgs;\n  try {\n    args = parseHeadlessArgs(process.argv);\n  } catch (e) {\n    process.stderr.write(`Error: ${(e as Error).message}\\n`);\n    process.exit(1);\n  }\n\n  let prompt = args.prompt;\n  if (predrainedInput !== undefined) {\n    prompt = predrainedInput ?? '';\n  } else if (prompt === '-' || (!prompt && !process.stdin.isTTY)) {\n    const chunks: Buffer[] = [];\n    for await (const chunk of process.stdin) {\n      chunks.push(chunk as Buffer);\n    }\n    prompt = Buffer.concat(chunks).toString('utf-8').trim();\n  }\n\n  if (!prompt) {\n    printHeadlessUsage();\n    process.stderr.write('Error: --prompt is required (or pipe via stdin)\\n');\n    process.exit(1);\n  }\n\n  if (args.settings && !existsSync(args.settings)) {\n    process.stderr.write(`Error: Settings file not found: ${args.settings}\\n`);\n    process.exit(1);\n  }\n\n  // Resolve --pack up front: an unknown pack fails fast with the valid list,\n  // before MastraCode boots. The selection itself is resolved inside runMC\n  // after thread selection, because a resumed thread restores its persisted\n  // mode — the mode that decides whether the pack has a model for this run.\n  // Activation (which mirrors /models → Activate and becomes the global\n  // default pack in settings) is saved via onApplied only once the pack has\n  // actually been applied to the session — a rejected pack must not change\n  // the persisted default on its way out.\n  const settings = loadSettings(args.settings);\n  let packId: string | undefined;\n  if (args.pack !== undefined) {\n    const resolved = resolveModePackArg(settings, args.pack);\n    if ('error' in resolved) {\n      process.stderr.write(`Error: ${resolved.error}\\n`);\n      process.exit(1);\n    }\n    packId = resolved.packId;\n  }\n\n  const diagnosticsSetup = createProcessMemoryDiagnosticsFromEnvironment(process.env);\n  const processMemoryDiagnostics = await startConfiguredProcessMemoryDiagnostics(diagnosticsSetup, warning => {\n    process.stderr.write(`Warning: ${warning}\\n`);\n  });\n\n  let boot: Awaited<ReturnType<typeof createMastraCode>> | undefined;\n  // Default to a non-zero exit so an unexpected throw before the run resolves\n  // still surfaces as a failure to the caller / CI.\n  let exitCode = 1;\n  try {\n    boot = await createMastraCode({ settingsPath: args.settings, coAuthor: options?.coAuthor });\n    const { controller, session, mcpManager } = boot;\n\n    const effectiveDefaults = resolveModelDefaults(settings, listBuiltinModePacks());\n\n    if (mcpManager?.hasServers()) {\n      try {\n        await mcpManager.initInBackground();\n      } catch (err) {\n        process.stderr.write(`Warning: MCP server initialization failed: ${(err as Error).message ?? err}\\n`);\n      }\n    }\n\n    setupDebugLogging();\n\n    const humanState = createHumanFormatState();\n    const run = runMC({\n      controller,\n      session,\n      prompt,\n      model: args.model,\n      mode: args.mode,\n      modeDefaults: effectiveDefaults,\n      ...(packId\n        ? {\n            pack: {\n              id: packId,\n              resolve: (modeId: string) => resolvePackSelection(settings, packId, modeId),\n              onApplied: () => {\n                activateModePackInSettings(settings, packId);\n                saveSettings(settings, args.settings);\n              },\n            },\n          }\n        : {}),\n      thinkingLevel: args.thinkingLevel,\n      thread: { id: args.thread, continueLatest: args.continue_, clone: args.cloneThread },\n      resourceId: args.resourceId,\n      title: args.title,\n      timeoutMs: args.timeout ? args.timeout * 1000 : undefined,\n      maxTurns: args.maxTurns,\n      policy: args.permissionMode ? permissionModeToPolicy(args.permissionMode) : undefined,\n    });\n\n    // Stream live events for human + jsonl modes. (json mode prints only the final object.)\n    for await (const event of run) {\n      if (args.output === 'human') {\n        const out = formatHuman(event, humanState);\n        if (out.stdout) process.stdout.write(out.stdout);\n        if (out.stderr) process.stderr.write(out.stderr);\n      } else if (args.output === 'jsonl') {\n        process.stdout.write(JSON.stringify(formatJsonl(event)) + '\\n');\n      }\n    }\n\n    const result = await run.result;\n    exitCode = result.exitCode;\n\n    if (args.output === 'json') {\n      process.stdout.write(renderJsonResult(result));\n    } else if (args.output === 'jsonl') {\n      process.stdout.write(JSON.stringify({ type: 'result', ...result }) + '\\n');\n    }\n\n    if (result.status === 'timeout') {\n      process.stderr.write(`\\nTimeout elapsed. Aborted.\\n`);\n    } else if (result.error && args.output === 'human') {\n      process.stderr.write(`Error: ${result.error.message}\\n`);\n    }\n  } catch (err) {\n    process.stderr.write(`Error: ${(err as Error).message ?? err}\\n`);\n    exitCode = 1;\n  } finally {\n    // --- Teardown (always runs, even on a thrown error) ---\n    releaseAllThreadLocks();\n    if (boot) {\n      // Stop plugin-contributed signal providers (and the plugin reload listener)\n      // before quiescing workers: a provider that keeps polling past this point\n      // could dispatch into a controller that is shutting down. Release thread\n      // claims first so a restarted process need not wait out this teardown.\n      try {\n        boot.releaseThreadClaims();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      try {\n        boot.stopPluginSignalProviders();\n      } catch {\n        // Best-effort — the process is exiting.\n      }\n      const { controller, mcpManager } = boot;\n      // Release notification dispatch leases before the pubsub that holds them\n      // closes. Headless has no shutdown deadline, so don't let a stalled\n      // in-flight dispatch hold up exit.\n      await Promise.race([\n        boot.stopNotificationDispatch?.().catch(() => {}),\n        new Promise<void>(resolve => setTimeout(resolve, STOP_NOTIFICATION_DISPATCH_TIMEOUT_MS).unref()),\n      ]);\n      await Promise.allSettled([\n        mcpManager?.disconnect(),\n        controller.getMastra()?.stopWorkers(),\n        controller.stopIntervals(),\n      ]);\n      // The signals pubsub is Mastra's event bus, so close it after the workers\n      // stop. Call close() on the object; a detached method loses `this` and\n      // rejects silently, leaving socket files behind.\n      const signalsPubSub = boot.signalsPubSub as { close?: () => Promise<void> | void } | undefined;\n      await Promise.allSettled([signalsPubSub?.close?.()]);\n    }\n    await stopProcessMemoryDiagnosticsWithTimeout(processMemoryDiagnostics, warning => {\n      process.stderr.write(`Warning: ${warning}\\n`);\n    });\n  }\n\n  process.exit(exitCode);\n}\n"],"mappings":"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"}

package/dist/headless/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/headless/flags.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,aAAa,qCAAsC,CAAC;AA6BjE;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,KAAK,EAAE,QAAQ,EAiI3B,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,qBAAqB;UACG,QAAQ,GAAG,SAAS;YAAU,MAAM;cAAY,OAAO;GAM9F;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,IAAI,MAAM,CAmBxC"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/headless/flags.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,aAAa,qCAAsC,CAAC;AA6BjE;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,KAAK,EAAE,QAAQ,EA8I3B,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,qBAAqB;UACG,QAAQ,GAAG,SAAS;YAAU,MAAM;cAAY,OAAO;GAM9F;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,IAAI,MAAM,CAmBxC"}

package/dist/headless/flags.js

@@ -124,7 +124,20 @@ const FLAGS = [
 		field: "model",
 		coerce: validate.string,
 		placeholder: "<id>",
-		help: "Model override (e.g., a provider/model id)"
+		help: "Model override (e.g., a provider/model id); wins over --pack for the active mode"
+	},
+	{
+		key: "pack",
+		type: "string",
+		field: "pack",
+		coerce: validate.string,
+		placeholder: "<id>",
+		help: [
+			"Model pack to activate (like /models → Activate): a builtin pack id",
+			"(anthropic, openai, github-copilot) or a saved custom pack, by",
+			"\"custom:<name>\" or its bare name. Sets the pack for every mode and",
+			"becomes the global default pack. --model overrides it for the active mode."
+		]
 	},
 	{
 		key: "mode",

package/dist/headless/flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"flags.js","names":[],"sources":["../../src/headless/flags.ts"],"sourcesContent":["/**\n * Declarative flag specification for the headless CLI.\n *\n * A single table is the source of truth for three things that previously drifted\n * apart in `cli.ts`:\n *   1. the `node:util` `parseArgs` option config,\n *   2. per-flag value coercion + validation, and\n *   3. the `--help` usage text.\n *\n * Adding a flag means adding one row here; parsing, validation, and the usage\n * listing all follow automatically.\n */\nimport type { OutputMode } from './cli.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\nimport { VALID_MODES, VALID_PERMISSION_MODES, VALID_THINKING_LEVELS } from './types.js';\n\nexport const VALID_OUTPUTS = ['human', 'json', 'jsonl'] as const;\n\n/** Reusable validators. Each throws a descriptive Error or returns the typed value. */\nconst validate = {\n  /** Restrict to a fixed set of string literals. */\n  enum<T extends string>(flag: string, allowed: readonly T[]) {\n    return (raw: string): T => {\n      if (!(allowed as readonly string[]).includes(raw)) {\n        throw new Error(`${flag} must be one of: ${allowed.join(', ')}`);\n      }\n      return raw as T;\n    };\n  },\n  /** Require a positive (>0) integer. */\n  positiveInt(flag: string) {\n    return (raw: string): number => {\n      const parsed = Number(raw);\n      if (!Number.isInteger(parsed) || parsed <= 0) {\n        throw new Error(`${flag} must be a positive integer`);\n      }\n      return parsed;\n    };\n  },\n  /** Pass a string through unchanged. */\n  string(raw: string): string {\n    return raw;\n  },\n};\n\n/**\n * One CLI flag. `key` is the long name (e.g. `output`); `field` is the\n * {@link import('./cli.js').HeadlessArgs} property it populates. `coerce`\n * converts the raw string and validates it. Boolean flags omit `coerce` and set\n * `field` to `true` when present.\n */\nexport interface FlagSpec {\n  /** Long flag name without the leading `--`. */\n  key: string;\n  /** Single-character alias (without the leading `-`), if any. */\n  short?: string;\n  /** Whether the flag takes a value (`string`) or is a switch (`boolean`). */\n  type: 'string' | 'boolean';\n  /** Target field on `HeadlessArgs`. Omit for flags handled out-of-band (e.g. help). */\n  field?: string;\n  /** Coerce/validate a string value. Required for `type: 'string'` flags that map to a field. */\n  coerce?: (raw: string) => unknown;\n  /** `<...>` value placeholder shown in usage, e.g. `<text>`. */\n  placeholder?: string;\n  /** One-line (or multi-line) help description shown in usage. */\n  help: string | string[];\n}\n\nexport const FLAGS: FlagSpec[] = [\n  {\n    key: 'prompt',\n    short: 'p',\n    type: 'string',\n    field: 'prompt',\n    coerce: validate.string,\n    placeholder: '<text>',\n    help: 'The task to execute (required, or pipe via stdin)',\n  },\n  {\n    key: 'continue',\n    short: 'c',\n    type: 'boolean',\n    field: 'continue_',\n    help: 'Resume the most recent thread instead of creating a new one',\n  },\n  {\n    key: 'thread',\n    short: 't',\n    type: 'string',\n    field: 'thread',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Resume a specific thread by ID',\n  },\n  {\n    key: 'title',\n    type: 'string',\n    field: 'title',\n    coerce: validate.string,\n    placeholder: '<title>',\n    help: 'Set or rename the thread title',\n  },\n  {\n    key: 'clone-thread',\n    type: 'boolean',\n    field: 'cloneThread',\n    help: 'Clone the current thread before running (work on a copy)',\n  },\n  {\n    key: 'resource-id',\n    type: 'string',\n    field: 'resourceId',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Set the resource ID for thread scoping',\n  },\n  {\n    key: 'timeout',\n    type: 'string',\n    field: 'timeout',\n    coerce: validate.positiveInt('--timeout'),\n    placeholder: '<seconds>',\n    help: 'Exit with code 2 if not complete within timeout',\n  },\n  {\n    key: 'max-turns',\n    type: 'string',\n    field: 'maxTurns',\n    coerce: validate.positiveInt('--max-turns'),\n    placeholder: '<n>',\n    help: 'Abort after N agentic turns (exit code 1)',\n  },\n  {\n    key: 'permission-mode',\n    type: 'string',\n    field: 'permissionMode',\n    coerce: validate.enum<PermissionMode>('--permission-mode', VALID_PERMISSION_MODES),\n    placeholder: '<mode>',\n    help: [\n      'How tool approvals/suspensions resolve:',\n      '  auto   approve everything (default)',\n      '  deny   refuse approvals, abort on suspension',\n    ],\n  },\n  {\n    key: 'output',\n    short: 'o',\n    type: 'string',\n    field: 'output',\n    coerce: validate.enum<OutputMode>('--output', VALID_OUTPUTS),\n    placeholder: '<mode>',\n    help: [\n      'Output mode: \"human\" (default), \"json\", or \"jsonl\"',\n      '  human  streaming text to stdout, activity to stderr',\n      '  json   single final JSON object (text, usage, tools)',\n      '  jsonl  newline-delimited JSON event stream',\n    ],\n  },\n  {\n    key: 'model',\n    short: 'm',\n    type: 'string',\n    field: 'model',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Model override (e.g., a provider/model id)',\n  },\n  {\n    key: 'mode',\n    type: 'string',\n    field: 'mode',\n    coerce: validate.enum<RunMode>('--mode', VALID_MODES),\n    placeholder: '{build|plan|fast}',\n    help: 'Execution mode — defaults to \"build\" if omitted',\n  },\n  {\n    key: 'thinking-level',\n    type: 'string',\n    field: 'thinkingLevel',\n    coerce: validate.enum<ThinkingLevel>('--thinking-level', VALID_THINKING_LEVELS),\n    placeholder: '<level>',\n    help: 'Thinking level: off, low, medium, high, xhigh, max',\n  },\n  {\n    key: 'settings',\n    type: 'string',\n    field: 'settings',\n    coerce: validate.string,\n    placeholder: '<path>',\n    help: 'Path to settings.json file (default: global settings)',\n  },\n  {\n    key: 'help',\n    short: 'h',\n    type: 'boolean',\n    help: 'Show this help and exit',\n  },\n];\n\n/** `parseArgs` option config derived from {@link FLAGS}. */\nexport function buildParseArgsOptions() {\n  const options: Record<string, { type: 'string' | 'boolean'; short?: string; default?: boolean }> = {};\n  for (const flag of FLAGS) {\n    options[flag.key] = flag.type === 'boolean' ? { type: 'boolean', default: false } : { type: 'string' };\n    if (flag.short) options[flag.key]!.short = flag.short;\n  }\n  return options;\n}\n\n/** Render the aligned `--flag  description` block of the usage text from {@link FLAGS}. */\nexport function renderFlagUsage(): string {\n  const left = (flag: FlagSpec): string => {\n    const long = `--${flag.key}`;\n    const short = flag.short ? `, -${flag.short}` : '';\n    const value = flag.placeholder ? ` ${flag.placeholder}` : '';\n    return `  ${long}${short}${value}`;\n  };\n\n  const rows = FLAGS.map(flag => ({ flag, label: left(flag) }));\n  const width = Math.max(...rows.map(r => r.label.length)) + 2;\n\n  return rows\n    .map(({ flag, label }) => {\n      const lines = Array.isArray(flag.help) ? flag.help : [flag.help];\n      const first = `${label.padEnd(width)}${lines[0]}`;\n      const rest = lines.slice(1).map(line => `${' '.repeat(width)}${line}`);\n      return [first, ...rest].join('\\n');\n    })\n    .join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"flags.js","names":[],"sources":["../../src/headless/flags.ts"],"sourcesContent":["/**\n * Declarative flag specification for the headless CLI.\n *\n * A single table is the source of truth for three things that previously drifted\n * apart in `cli.ts`:\n *   1. the `node:util` `parseArgs` option config,\n *   2. per-flag value coercion + validation, and\n *   3. the `--help` usage text.\n *\n * Adding a flag means adding one row here; parsing, validation, and the usage\n * listing all follow automatically.\n */\nimport type { OutputMode } from './cli.js';\nimport type { PermissionMode, RunMode, ThinkingLevel } from './types.js';\nimport { VALID_MODES, VALID_PERMISSION_MODES, VALID_THINKING_LEVELS } from './types.js';\n\nexport const VALID_OUTPUTS = ['human', 'json', 'jsonl'] as const;\n\n/** Reusable validators. Each throws a descriptive Error or returns the typed value. */\nconst validate = {\n  /** Restrict to a fixed set of string literals. */\n  enum<T extends string>(flag: string, allowed: readonly T[]) {\n    return (raw: string): T => {\n      if (!(allowed as readonly string[]).includes(raw)) {\n        throw new Error(`${flag} must be one of: ${allowed.join(', ')}`);\n      }\n      return raw as T;\n    };\n  },\n  /** Require a positive (>0) integer. */\n  positiveInt(flag: string) {\n    return (raw: string): number => {\n      const parsed = Number(raw);\n      if (!Number.isInteger(parsed) || parsed <= 0) {\n        throw new Error(`${flag} must be a positive integer`);\n      }\n      return parsed;\n    };\n  },\n  /** Pass a string through unchanged. */\n  string(raw: string): string {\n    return raw;\n  },\n};\n\n/**\n * One CLI flag. `key` is the long name (e.g. `output`); `field` is the\n * {@link import('./cli.js').HeadlessArgs} property it populates. `coerce`\n * converts the raw string and validates it. Boolean flags omit `coerce` and set\n * `field` to `true` when present.\n */\nexport interface FlagSpec {\n  /** Long flag name without the leading `--`. */\n  key: string;\n  /** Single-character alias (without the leading `-`), if any. */\n  short?: string;\n  /** Whether the flag takes a value (`string`) or is a switch (`boolean`). */\n  type: 'string' | 'boolean';\n  /** Target field on `HeadlessArgs`. Omit for flags handled out-of-band (e.g. help). */\n  field?: string;\n  /** Coerce/validate a string value. Required for `type: 'string'` flags that map to a field. */\n  coerce?: (raw: string) => unknown;\n  /** `<...>` value placeholder shown in usage, e.g. `<text>`. */\n  placeholder?: string;\n  /** One-line (or multi-line) help description shown in usage. */\n  help: string | string[];\n}\n\nexport const FLAGS: FlagSpec[] = [\n  {\n    key: 'prompt',\n    short: 'p',\n    type: 'string',\n    field: 'prompt',\n    coerce: validate.string,\n    placeholder: '<text>',\n    help: 'The task to execute (required, or pipe via stdin)',\n  },\n  {\n    key: 'continue',\n    short: 'c',\n    type: 'boolean',\n    field: 'continue_',\n    help: 'Resume the most recent thread instead of creating a new one',\n  },\n  {\n    key: 'thread',\n    short: 't',\n    type: 'string',\n    field: 'thread',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Resume a specific thread by ID',\n  },\n  {\n    key: 'title',\n    type: 'string',\n    field: 'title',\n    coerce: validate.string,\n    placeholder: '<title>',\n    help: 'Set or rename the thread title',\n  },\n  {\n    key: 'clone-thread',\n    type: 'boolean',\n    field: 'cloneThread',\n    help: 'Clone the current thread before running (work on a copy)',\n  },\n  {\n    key: 'resource-id',\n    type: 'string',\n    field: 'resourceId',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Set the resource ID for thread scoping',\n  },\n  {\n    key: 'timeout',\n    type: 'string',\n    field: 'timeout',\n    coerce: validate.positiveInt('--timeout'),\n    placeholder: '<seconds>',\n    help: 'Exit with code 2 if not complete within timeout',\n  },\n  {\n    key: 'max-turns',\n    type: 'string',\n    field: 'maxTurns',\n    coerce: validate.positiveInt('--max-turns'),\n    placeholder: '<n>',\n    help: 'Abort after N agentic turns (exit code 1)',\n  },\n  {\n    key: 'permission-mode',\n    type: 'string',\n    field: 'permissionMode',\n    coerce: validate.enum<PermissionMode>('--permission-mode', VALID_PERMISSION_MODES),\n    placeholder: '<mode>',\n    help: [\n      'How tool approvals/suspensions resolve:',\n      '  auto   approve everything (default)',\n      '  deny   refuse approvals, abort on suspension',\n    ],\n  },\n  {\n    key: 'output',\n    short: 'o',\n    type: 'string',\n    field: 'output',\n    coerce: validate.enum<OutputMode>('--output', VALID_OUTPUTS),\n    placeholder: '<mode>',\n    help: [\n      'Output mode: \"human\" (default), \"json\", or \"jsonl\"',\n      '  human  streaming text to stdout, activity to stderr',\n      '  json   single final JSON object (text, usage, tools)',\n      '  jsonl  newline-delimited JSON event stream',\n    ],\n  },\n  {\n    key: 'model',\n    short: 'm',\n    type: 'string',\n    field: 'model',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: 'Model override (e.g., a provider/model id); wins over --pack for the active mode',\n  },\n  {\n    key: 'pack',\n    type: 'string',\n    field: 'pack',\n    coerce: validate.string,\n    placeholder: '<id>',\n    help: [\n      'Model pack to activate (like /models → Activate): a builtin pack id',\n      '(anthropic, openai, github-copilot) or a saved custom pack, by',\n      '\"custom:<name>\" or its bare name. Sets the pack for every mode and',\n      'becomes the global default pack. --model overrides it for the active mode.',\n    ],\n  },\n  {\n    key: 'mode',\n    type: 'string',\n    field: 'mode',\n    coerce: validate.enum<RunMode>('--mode', VALID_MODES),\n    placeholder: '{build|plan|fast}',\n    help: 'Execution mode — defaults to \"build\" if omitted',\n  },\n  {\n    key: 'thinking-level',\n    type: 'string',\n    field: 'thinkingLevel',\n    coerce: validate.enum<ThinkingLevel>('--thinking-level', VALID_THINKING_LEVELS),\n    placeholder: '<level>',\n    help: 'Thinking level: off, low, medium, high, xhigh, max',\n  },\n  {\n    key: 'settings',\n    type: 'string',\n    field: 'settings',\n    coerce: validate.string,\n    placeholder: '<path>',\n    help: 'Path to settings.json file (default: global settings)',\n  },\n  {\n    key: 'help',\n    short: 'h',\n    type: 'boolean',\n    help: 'Show this help and exit',\n  },\n];\n\n/** `parseArgs` option config derived from {@link FLAGS}. */\nexport function buildParseArgsOptions() {\n  const options: Record<string, { type: 'string' | 'boolean'; short?: string; default?: boolean }> = {};\n  for (const flag of FLAGS) {\n    options[flag.key] = flag.type === 'boolean' ? { type: 'boolean', default: false } : { type: 'string' };\n    if (flag.short) options[flag.key]!.short = flag.short;\n  }\n  return options;\n}\n\n/** Render the aligned `--flag  description` block of the usage text from {@link FLAGS}. */\nexport function renderFlagUsage(): string {\n  const left = (flag: FlagSpec): string => {\n    const long = `--${flag.key}`;\n    const short = flag.short ? `, -${flag.short}` : '';\n    const value = flag.placeholder ? ` ${flag.placeholder}` : '';\n    return `  ${long}${short}${value}`;\n  };\n\n  const rows = FLAGS.map(flag => ({ flag, label: left(flag) }));\n  const width = Math.max(...rows.map(r => r.label.length)) + 2;\n\n  return rows\n    .map(({ flag, label }) => {\n      const lines = Array.isArray(flag.help) ? flag.help : [flag.help];\n      const first = `${label.padEnd(width)}${lines[0]}`;\n      const rest = lines.slice(1).map(line => `${' '.repeat(width)}${line}`);\n      return [first, ...rest].join('\\n');\n    })\n    .join('\\n');\n}\n"],"mappings":";;AAgBA,MAAa,gBAAgB;CAAC;CAAS;CAAQ;AAAO;;AAGtD,MAAM,WAAW;;CAEf,KAAuB,MAAc,SAAuB;EAC1D,QAAQ,QAAmB;GACzB,IAAI,CAAE,QAA8B,SAAS,GAAG,GAC9C,MAAM,IAAI,MAAM,GAAG,KAAK,mBAAmB,QAAQ,KAAK,IAAI,GAAG;GAEjE,OAAO;EACT;CACF;;CAEA,YAAY,MAAc;EACxB,QAAQ,QAAwB;GAC9B,MAAM,SAAS,OAAO,GAAG;GACzB,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,UAAU,GACzC,MAAM,IAAI,MAAM,GAAG,KAAK,4BAA4B;GAEtD,OAAO;EACT;CACF;;CAEA,OAAO,KAAqB;EAC1B,OAAO;CACT;AACF;AAyBA,MAAa,QAAoB;CAC/B;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,MAAM;CACR;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,YAAY,WAAW;EACxC,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,YAAY,aAAa;EAC1C,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAqB,qBAAqB,sBAAsB;EACjF,aAAa;EACb,MAAM;GACJ;GACA;GACA;EACF;CACF;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAiB,YAAY,aAAa;EAC3D,aAAa;EACb,MAAM;GACJ;GACA;GACA;GACA;EACF;CACF;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;GACJ;GACA;GACA;GACA;EACF;CACF;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAc,UAAU,WAAW;EACpD,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS,KAAoB,oBAAoB,qBAAqB;EAC9E,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,MAAM;EACN,OAAO;EACP,QAAQ,SAAS;EACjB,aAAa;EACb,MAAM;CACR;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,MAAM;CACR;AACF;;AAGA,SAAgB,wBAAwB;CACtC,MAAM,UAA6F,CAAC;CACpG,KAAK,MAAM,QAAQ,OAAO;EACxB,QAAQ,KAAK,OAAO,KAAK,SAAS,YAAY;GAAE,MAAM;GAAW,SAAS;EAAM,IAAI,EAAE,MAAM,SAAS;EACrG,IAAI,KAAK,OAAO,QAAQ,KAAK,IAAI,CAAE,QAAQ,KAAK;CAClD;CACA,OAAO;AACT;;AAGA,SAAgB,kBAA0B;CACxC,MAAM,QAAQ,SAA2B;EAIvC,OAAO,KAAK,KAHM,KAAK,QACT,KAAK,QAAQ,MAAM,KAAK,UAAU,KAClC,KAAK,cAAc,IAAI,KAAK,gBAAgB;CAE5D;CAEA,MAAM,OAAO,MAAM,KAAI,UAAS;EAAE;EAAM,OAAO,KAAK,IAAI;CAAE,EAAE;CAC5D,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,KAAI,MAAK,EAAE,MAAM,MAAM,CAAC,IAAI;CAE3D,OAAO,KACJ,KAAK,EAAE,MAAM,YAAY;EACxB,MAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC,KAAK,IAAI;EAG/D,OAAO,CAAC,GAFS,MAAM,OAAO,KAAK,IAAI,MAAM,MAE9B,GADF,MAAM,MAAM,CAAC,CAAC,CAAC,KAAI,SAAQ,GAAG,IAAI,OAAO,KAAK,IAAI,MAC1C,CAAC,CAAC,CAAC,KAAK,IAAI;CACnC,CAAC,CAAC,CACD,KAAK,IAAI;AACd"}

package/dist/headless/run-mc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-mc.d.ts","sourceRoot":"","sources":["../../src/headless/run-mc.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,KAAK,EAAoB,YAAY,EAA4B,MAAM,YAAY,CAAC;AA2IlG;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,KAAK,CAoUlG"}
+{"version":3,"file":"run-mc.d.ts","sourceRoot":"","sources":["../../src/headless/run-mc.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,KAAK,EAAoB,YAAY,EAA4B,MAAM,YAAY,CAAC;AA2IlG;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,KAAK,CA+WlG"}

package/dist/headless/run-mc.js

@@ -1,5 +1,7 @@
+import { THREAD_ACTIVE_MODEL_PACK_ID_KEY } from "../onboarding/settings.js";
 import { GoalManager } from "../goal-manager.js";
 import { createGoalReminderSignal } from "../goal-signal.js";
+import { MODEL_FALLBACK_STATE_KEY } from "../auth/account-rotation-processor.js";
 import { autoApprovePolicy } from "./policy.js";
 import { isSessionStartupCancelledError } from "@mastra/core/agent-controller";
 //#region src/headless/run-mc.ts
@@ -288,15 +290,20 @@ function runMC(options) {
 		const restoredThreadSelection = Boolean(restoredThreadId || thread?.clone);
 		const modeIdForModel = options.mode ?? (options.modeDefaults ? session.mode.get() : void 0);
 		const configuredDefaultModelId = modeIdForModel ? options.modeDefaults?.[modeIdForModel] : void 0;
-		const modelIdToApply = options.model ?? (options.mode || !restoredThreadSelection ? configuredDefaultModelId : void 0);
+		const modelIdToApply = options.pack ? options.model : options.model ?? (options.mode || !restoredThreadSelection ? configuredDefaultModelId : void 0);
+		const modelSource = options.model ? "flag" : "mode";
 		try {
 			if (options.mode && !controller.listModes().some((mode) => mode.id === options.mode)) return fail(`Unknown mode: "${options.mode}"`);
 			if (modelIdToApply) {
 				const match = (await controller.listAvailableModels()).find((model) => model.id === modelIdToApply);
-				if (!match) return options.model ? fail(`Unknown model: "${modelIdToApply}"`) : fail(`Unknown model "${modelIdToApply}" configured for mode "${modeIdForModel}"`);
+				if (!match) {
+					if (modelSource === "flag") return fail(`Unknown model: "${modelIdToApply}"`);
+					return fail(`Unknown model "${modelIdToApply}" configured for mode "${modeIdForModel}"`);
+				}
 				if (!match.hasApiKey) {
 					const keyHint = match.apiKeyEnvVar ? ` Set ${match.apiKeyEnvVar} to use this model.` : "";
-					return options.model ? fail(`Model "${modelIdToApply}" has no API key configured.${keyHint}`) : fail(`Model "${modelIdToApply}" (mode: ${modeIdForModel}) has no API key configured.${keyHint}`);
+					if (modelSource === "flag") return fail(`Model "${modelIdToApply}" has no API key configured.${keyHint}`);
+					return fail(`Model "${modelIdToApply}" (mode: ${modeIdForModel}) has no API key configured.${keyHint}`);
 				}
 			}
 		} catch (err) {
@@ -320,7 +327,38 @@ function runMC(options) {
 		}
 		try {
 			if (options.mode) await session.mode.switch({ modeId: options.mode });
-			if (modelIdToApply) await session.model.switch(modelIdToApply);
+			let packModelId;
+			if (options.pack) {
+				const packModeId = options.mode ?? session.mode.get();
+				const packSelection = options.pack.resolve(packModeId);
+				if (!packSelection) return fail(`Model pack "${options.pack.id}" has no model for ${packModeId} mode`);
+				const match = (await controller.listAvailableModels()).find((model) => model.id === packSelection.modelId);
+				if (!match) return fail(`Unknown model "${packSelection.modelId}" from pack "${options.pack.id}"`);
+				if (!match.hasApiKey) {
+					const keyHint = match.apiKeyEnvVar ? ` Set ${match.apiKeyEnvVar} to use this model.` : "";
+					return fail(`Model "${packSelection.modelId}" (pack: ${options.pack.id}) has no API key configured.${keyHint}`);
+				}
+				packModelId = packSelection.modelId;
+				await session.thread.setSetting({
+					key: THREAD_ACTIVE_MODEL_PACK_ID_KEY,
+					value: options.pack.id
+				});
+				await session.thread.setSetting({
+					key: MODEL_FALLBACK_STATE_KEY,
+					value: void 0
+				});
+				for (const [agentType, modelId] of Object.entries(packSelection.subagentModels ?? {})) await session.subagents.model.set({
+					modelId,
+					agentType
+				});
+				await session.state.set({
+					modelRoute: packSelection.modelRoute,
+					[MODEL_FALLBACK_STATE_KEY]: null
+				});
+			}
+			const sessionModelId = modelIdToApply ?? packModelId;
+			if (sessionModelId) await session.model.switch(sessionModelId);
+			options.pack?.onApplied?.();
 			if (options.thinkingLevel) await session.state.set({ thinkingLevel: options.thinkingLevel });
 		} catch (err) {
 			return fail(`Failed to apply run config: ${err.message}`);

package/dist/headless/run-mc.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-mc.js","names":["#maxBuffer","#closed","#resolvers","#buffer"],"sources":["../../src/headless/run-mc.ts"],"sourcesContent":["/**\n * Core programmatic runner for MastraCode headless runs.\n *\n * `runMC` is a pure async runner: it takes an already-built `controller` +\n * `session` (from `createMastraCode(...)`), resolves run config, subscribes to\n * the session, applies a {@link ResolutionPolicy} for approvals/suspensions,\n * sends the prompt, and aggregates events into a {@link RunMCResult}.\n *\n * It never touches `process.*` and never calls `process.exit`. The returned\n * {@link MCRun} is async-iterable over controller events and also resolves to a\n * final result via `result`.\n */\nimport { isSessionStartupCancelledError } from '@mastra/core/agent-controller';\nimport type { AgentControllerEvent, Session } from '@mastra/core/agent-controller';\n\nimport { GoalManager } from '../goal-manager.js';\nimport { createGoalReminderSignal } from '../goal-signal.js';\n\nimport { autoApprovePolicy } from './policy.js';\nimport type { MCRun, ResolutionPolicy, RunMCOptions, RunMCResult, RunMCStatus } from './types.js';\n\nfunction exitCodeForStatus(status: RunMCStatus): number {\n  switch (status) {\n    case 'completed':\n    case 'done':\n      return 0;\n    case 'timeout':\n      return 2;\n    default:\n      return 1;\n  }\n}\n\ninterface MutableResult {\n  text: string;\n  finishReason?: string;\n  usage?: RunMCResult['usage'];\n  toolCalls: RunMCResult['toolCalls'];\n  toolResults: RunMCResult['toolResults'];\n  error?: RunMCResult['error'];\n  threadId?: string;\n  activeAssistantMessageId?: string;\n}\n\nfunction aggregate(event: AgentControllerEvent, acc: MutableResult): void {\n  switch (event.type) {\n    case 'message_start':\n      if (event.message.role === 'assistant') acc.activeAssistantMessageId = event.message.id;\n      break;\n    case 'message_update':\n      if (event.event.type === 'text-delta' && event.id === acc.activeAssistantMessageId) {\n        acc.text += event.event.delta;\n      }\n      break;\n    case 'message_end':\n      if (event.id === acc.activeAssistantMessageId) acc.activeAssistantMessageId = undefined;\n      break;\n    case 'tool_start':\n      acc.toolCalls.push({ id: event.toolCallId, name: event.toolName, args: event.args });\n      break;\n    case 'tool_end': {\n      const matching = acc.toolCalls.find(c => c.id === event.toolCallId);\n      acc.toolResults.push({\n        id: event.toolCallId,\n        name: matching?.name ?? '',\n        result: event.result,\n        isError: event.isError,\n      });\n      break;\n    }\n    case 'usage_update':\n      acc.usage = {\n        inputTokens: event.usage.promptTokens,\n        outputTokens: event.usage.completionTokens,\n        totalTokens: event.usage.totalTokens,\n      };\n      break;\n    case 'error':\n      acc.error = {\n        name: event.error.name,\n        message: event.error.message,\n        stack: event.error.stack,\n      };\n      break;\n  }\n}\n\n/** Resolve a thread by its exact ID. Titles are not unique, so we don't match on them. */\nasync function resolveThread<TState extends Record<string, unknown>>(\n  session: Session<TState>,\n  threadId: string,\n  resourceId?: string,\n): Promise<{ threadId: string } | { error: string }> {\n  const threads = await session.thread.list(resourceId ? { allResources: true } : undefined);\n\n  const byId = threads.find(thread => thread.id === threadId && (!resourceId || thread.resourceId === resourceId));\n  if (byId) return { threadId: byId.id };\n\n  return { error: `No thread found with ID \"${threadId}\"` };\n}\n\n/**\n * A simple back-pressured async queue. Events are pushed in; consumers pull via\n * the async iterator. `close()` ends iteration after draining buffered events.\n *\n * Buffered events are bounded by `maxBuffer`: if a consumer never iterates (the\n * result-only path, `await run.result` without `for await (...)`) — or simply\n * falls far behind — the oldest buffered events are dropped instead of growing\n * without limit. The aggregated {@link RunMCResult} is built independently of\n * this queue, so dropping buffered events never affects the final result.\n */\nclass EventQueue<T> {\n  #buffer: T[] = [];\n  #resolvers: Array<(r: IteratorResult<T>) => void> = [];\n  #closed = false;\n  readonly #maxBuffer: number;\n\n  constructor(maxBuffer = 10_000) {\n    this.#maxBuffer = maxBuffer;\n  }\n\n  push(value: T): void {\n    if (this.#closed) return;\n    const resolve = this.#resolvers.shift();\n    if (resolve) {\n      resolve({ value, done: false });\n      return;\n    }\n    this.#buffer.push(value);\n    if (this.#buffer.length > this.#maxBuffer) {\n      // Bound memory: drop the oldest event once over the cap.\n      this.#buffer.shift();\n    }\n  }\n\n  close(): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    for (const resolve of this.#resolvers.splice(0)) {\n      resolve({ value: undefined as unknown as T, done: true });\n    }\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    return {\n      next: (): Promise<IteratorResult<T>> => {\n        if (this.#buffer.length > 0) {\n          return Promise.resolve({ value: this.#buffer.shift()!, done: false });\n        }\n        if (this.#closed) {\n          return Promise.resolve({ value: undefined as unknown as T, done: true });\n        }\n        return new Promise<IteratorResult<T>>(resolve => this.#resolvers.push(resolve));\n      },\n    };\n  }\n}\n\n/**\n * Run a headless MastraCode turn. Returns an {@link MCRun} handle that is\n * async-iterable over controller events and resolves to a {@link RunMCResult}.\n */\nexport function runMC<TState extends Record<string, unknown>>(options: RunMCOptions<TState>): MCRun {\n  const { controller, session } = options;\n  const goal = options.goal;\n  const policy: ResolutionPolicy = options.policy ?? autoApprovePolicy;\n\n  const queue = new EventQueue<AgentControllerEvent>();\n  const acc: MutableResult = { text: '', toolCalls: [], toolResults: [] };\n\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  let timedOut = false;\n  let aborted = false;\n  let maxTurnsExceeded = false;\n  let assistantTurns = 0;\n  let activeAssistantMessageId: string | undefined;\n  let settled = false;\n  let unsubscribe: (() => void) | undefined;\n  let resolveResult!: (r: RunMCResult) => void;\n\n  const result = new Promise<RunMCResult>(resolve => {\n    resolveResult = resolve;\n  });\n\n  function finish(status: RunMCStatus, data: Partial<RunMCResult> = {}): void {\n    if (settled) return;\n    settled = true;\n    if (timeoutId) clearTimeout(timeoutId);\n    unsubscribe?.();\n    queue.close();\n    resolveResult({\n      status,\n      text: acc.text,\n      finishReason: acc.finishReason,\n      usage: acc.usage,\n      toolCalls: acc.toolCalls,\n      toolResults: acc.toolResults,\n      threadId: acc.threadId ?? session.thread.getId() ?? undefined,\n      error: acc.error,\n      exitCode: exitCodeForStatus(status),\n      ...data,\n    });\n  }\n\n  function fail(message: string, name = 'Error'): void {\n    if (!acc.error) acc.error = { name, message };\n    finish('error');\n  }\n\n  function abort(): void {\n    if (settled) return;\n    aborted = true;\n    session.abort();\n  }\n\n  if (options.signal) {\n    if (options.signal.aborted) {\n      // Defer so the caller can attach iteration / result handlers first.\n      queueMicrotask(() => abort());\n    } else {\n      options.signal.addEventListener('abort', () => abort(), { once: true });\n    }\n  }\n\n  function armTimeout(): void {\n    if (!options.timeoutMs || settled) return;\n    if (timeoutId) clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => {\n      timedOut = true;\n      session.abort();\n      if (goal) finish('timeout');\n    }, options.timeoutMs);\n  }\n\n  // Kick off the run asynchronously so the MCRun handle is returned synchronously.\n  void (async () => {\n    armTimeout();\n\n    // --- Subscribe ---\n    unsubscribe = session.subscribe(event => {\n      if (settled) return;\n      if (goal) armTimeout();\n\n      if (event.type === 'tool_approval_required') {\n        let decision: 'approve' | 'deny';\n        try {\n          decision = policy.onToolApproval(event);\n        } catch (err) {\n          fail(`Resolution policy failed: ${(err as Error).message}`);\n          return;\n        }\n        session.respondToToolApproval({\n          decision: decision === 'approve' ? 'approve' : 'decline',\n          toolCallId: event.toolCallId,\n        });\n        queue.push(event);\n        return;\n      }\n\n      if (event.type === 'tool_suspended') {\n        let outcome: ReturnType<ResolutionPolicy['onSuspension']>;\n        try {\n          outcome = policy.onSuspension(event);\n        } catch (err) {\n          fail(`Resolution policy failed: ${(err as Error).message}`);\n          return;\n        }\n        if ('abort' in outcome) {\n          queue.push(event);\n          abort();\n          return;\n        }\n        void session.respondToToolSuspension({ toolCallId: event.toolCallId, resumeData: outcome.resumeData });\n        queue.push(event);\n        return;\n      }\n\n      if (event.type === 'message_start' && event.message.role === 'assistant') {\n        activeAssistantMessageId = event.message.id;\n      }\n\n      aggregate(event, acc);\n      queue.push(event);\n\n      if (event.type === 'error' && goal) {\n        finish('error');\n        return;\n      }\n\n      // Count agentic turns (one assistant response = one turn). When the cap is\n      // reached, abort the run; agent_end then resolves as 'max_turns'.\n      if (event.type === 'message_end' && event.id === activeAssistantMessageId && options.maxTurns !== undefined) {\n        activeAssistantMessageId = undefined;\n        assistantTurns += 1;\n        if (assistantTurns >= options.maxTurns && !maxTurnsExceeded) {\n          maxTurnsExceeded = true;\n          abort();\n        }\n      }\n\n      if (event.type === 'goal_evaluation' && goal && !event.payload.pending) {\n        if (event.payload.status === 'done' || event.payload.status === 'paused') {\n          finish(event.payload.status, {\n            objective: goal.objective,\n            goalEvent: event,\n            reason: event.payload.reason ?? event.payload.results?.[0]?.reason,\n            iterations: event.payload.iteration,\n            maxRuns: event.payload.maxRuns,\n          });\n        }\n        return;\n      }\n\n      if (event.type === 'agent_end') {\n        acc.finishReason = event.reason;\n        // Goal evaluations can arrive after the agent stream ends, so goal runs\n        // remain active until a terminal goal_evaluation is emitted.\n        if (goal) return;\n        if (timedOut) {\n          finish('timeout');\n        } else if (event.reason === 'error') {\n          finish('error');\n        } else if (maxTurnsExceeded && event.reason !== 'complete') {\n          // The cap forced an abort while the agent still had work to do.\n          finish('max_turns');\n        } else if ((event.reason === 'aborted' || aborted) && !maxTurnsExceeded) {\n          finish('aborted');\n        } else {\n          finish('completed');\n        }\n      }\n    });\n\n    // --- Thread resolution (read-only) ---\n    const thread = options.thread;\n    const targetResourceId = options.resourceId ?? session.identity.getResourceId();\n    let restoredThreadId: string | undefined;\n    try {\n      if (thread?.id) {\n        const resolved = await resolveThread(session, thread.id, targetResourceId);\n        if ('error' in resolved) return fail(resolved.error);\n        restoredThreadId = resolved.threadId;\n      } else if (thread?.continueLatest) {\n        const threads = await session.thread.list(targetResourceId ? { allResources: true } : undefined);\n        const resourceThreads = targetResourceId\n          ? threads.filter(candidate => candidate.resourceId === targetResourceId)\n          : threads;\n        if (resourceThreads.length > 0) {\n          restoredThreadId = [...resourceThreads].sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())[0]!.id;\n        }\n      }\n    } catch (err) {\n      return fail(`Failed to resolve thread: ${(err as Error).message}`);\n    }\n\n    // --- Config validation (read-only) ---\n    const restoredThreadSelection = Boolean(restoredThreadId || thread?.clone);\n    const modeIdForModel = options.mode ?? (options.modeDefaults ? session.mode.get() : undefined);\n    const configuredDefaultModelId = modeIdForModel ? options.modeDefaults?.[modeIdForModel] : undefined;\n    const modelIdToApply =\n      options.model ?? (options.mode || !restoredThreadSelection ? configuredDefaultModelId : undefined);\n    try {\n      if (options.mode && !controller.listModes().some(mode => mode.id === options.mode)) {\n        return fail(`Unknown mode: \"${options.mode}\"`);\n      }\n\n      if (modelIdToApply) {\n        const available = await controller.listAvailableModels();\n        const match = available.find(model => model.id === modelIdToApply);\n        if (!match) {\n          return options.model\n            ? fail(`Unknown model: \"${modelIdToApply}\"`)\n            : fail(`Unknown model \"${modelIdToApply}\" configured for mode \"${modeIdForModel}\"`);\n        }\n        if (!match.hasApiKey) {\n          const keyHint = match.apiKeyEnvVar ? ` Set ${match.apiKeyEnvVar} to use this model.` : '';\n          return options.model\n            ? fail(`Model \"${modelIdToApply}\" has no API key configured.${keyHint}`)\n            : fail(`Model \"${modelIdToApply}\" (mode: ${modeIdForModel}) has no API key configured.${keyHint}`);\n        }\n      }\n    } catch (err) {\n      return fail(`Failed to resolve run config: ${(err as Error).message}`);\n    }\n\n    // --- Resource id ---\n    try {\n      if (options.resourceId) {\n        await controller.setResourceId(session, { resourceId: options.resourceId });\n      }\n    } catch (err) {\n      return fail(`Failed to set resource id: ${(err as Error).message}`);\n    }\n\n    // --- Thread selection ---\n    try {\n      if (restoredThreadId) {\n        await session.thread.switch({ threadId: restoredThreadId });\n      } else if (!thread?.clone) {\n        await session.thread.create();\n      }\n    } catch (err) {\n      return fail(`Failed to select thread: ${(err as Error).message}`);\n    }\n\n    // --- Clone ---\n    if (thread?.clone) {\n      try {\n        await session.thread.clone();\n      } catch (err) {\n        return fail(`Failed to clone thread: ${(err as Error).message}`);\n      }\n    }\n\n    // --- Config application ---\n    try {\n      if (options.mode) {\n        await session.mode.switch({ modeId: options.mode });\n      }\n      if (modelIdToApply) {\n        await session.model.switch(modelIdToApply);\n      }\n      if (options.thinkingLevel) {\n        await session.state.set({ thinkingLevel: options.thinkingLevel } as unknown as Partial<TState>);\n      }\n    } catch (err) {\n      return fail(`Failed to apply run config: ${(err as Error).message}`);\n    }\n\n    // --- Title ---\n    if (options.title) {\n      try {\n        await session.thread.rename({ title: options.title });\n      } catch (err) {\n        return fail(`Failed to set thread title: ${(err as Error).message}`);\n      }\n    }\n\n    // --- Start ---\n    try {\n      if (goal) {\n        const threadId = session.thread.getId();\n        if (!threadId || !(await session.thread.getById({ threadId }))) {\n          await session.thread.create();\n        }\n\n        const goalManager = goal.goalManager ?? new GoalManager();\n        const state = {\n          controller,\n          session,\n          goalManager,\n          pendingNewThread: false,\n        } as any;\n        const objective = await goalManager.setGoal(state, goal.objective, goal.judgeModelId, goal.maxRuns);\n        if (!objective) return fail('Failed to set goal.');\n\n        const agent = controller.getCurrentAgent(session);\n        const persisted = await agent.getObjective({ threadId: session.thread.getId()! });\n        if (!persisted || persisted.id !== objective.id) {\n          return fail('Failed to persist goal objective before sending goal signal.');\n        }\n\n        await goalManager.saveToThread(state);\n        if (!settled) await session.sendSignal(createGoalReminderSignal(objective)).accepted;\n      } else {\n        if (!options.prompt) return fail('A prompt or goal is required.');\n        await session.sendMessage({ content: options.prompt });\n      }\n    } catch (err) {\n      if (\n        isSessionStartupCancelledError(err) ||\n        (err instanceof Error && err.name === 'AbortError' && (aborted || timedOut || options.signal?.aborted))\n      ) {\n        return finish(timedOut ? 'timeout' : maxTurnsExceeded ? 'max_turns' : 'aborted');\n      }\n      return fail(`Failed to start run: ${(err as Error).message}`);\n    }\n  })();\n\n  return {\n    result,\n    abort,\n    [Symbol.asyncIterator](): AsyncIterator<AgentControllerEvent> {\n      return queue[Symbol.asyncIterator]();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"run-mc.js","names":["#maxBuffer","#closed","#resolvers","#buffer"],"sources":["../../src/headless/run-mc.ts"],"sourcesContent":["/**\n * Core programmatic runner for MastraCode headless runs.\n *\n * `runMC` is a pure async runner: it takes an already-built `controller` +\n * `session` (from `createMastraCode(...)`), resolves run config, subscribes to\n * the session, applies a {@link ResolutionPolicy} for approvals/suspensions,\n * sends the prompt, and aggregates events into a {@link RunMCResult}.\n *\n * It never touches `process.*` and never calls `process.exit`. The returned\n * {@link MCRun} is async-iterable over controller events and also resolves to a\n * final result via `result`.\n */\nimport { isSessionStartupCancelledError } from '@mastra/core/agent-controller';\nimport type { AgentControllerEvent, Session } from '@mastra/core/agent-controller';\n\nimport { MODEL_FALLBACK_STATE_KEY } from '../auth/account-rotation-processor.js';\nimport { GoalManager } from '../goal-manager.js';\nimport { createGoalReminderSignal } from '../goal-signal.js';\nimport { THREAD_ACTIVE_MODEL_PACK_ID_KEY } from '../onboarding/settings.js';\n\nimport { autoApprovePolicy } from './policy.js';\nimport type { MCRun, ResolutionPolicy, RunMCOptions, RunMCResult, RunMCStatus } from './types.js';\n\nfunction exitCodeForStatus(status: RunMCStatus): number {\n  switch (status) {\n    case 'completed':\n    case 'done':\n      return 0;\n    case 'timeout':\n      return 2;\n    default:\n      return 1;\n  }\n}\n\ninterface MutableResult {\n  text: string;\n  finishReason?: string;\n  usage?: RunMCResult['usage'];\n  toolCalls: RunMCResult['toolCalls'];\n  toolResults: RunMCResult['toolResults'];\n  error?: RunMCResult['error'];\n  threadId?: string;\n  activeAssistantMessageId?: string;\n}\n\nfunction aggregate(event: AgentControllerEvent, acc: MutableResult): void {\n  switch (event.type) {\n    case 'message_start':\n      if (event.message.role === 'assistant') acc.activeAssistantMessageId = event.message.id;\n      break;\n    case 'message_update':\n      if (event.event.type === 'text-delta' && event.id === acc.activeAssistantMessageId) {\n        acc.text += event.event.delta;\n      }\n      break;\n    case 'message_end':\n      if (event.id === acc.activeAssistantMessageId) acc.activeAssistantMessageId = undefined;\n      break;\n    case 'tool_start':\n      acc.toolCalls.push({ id: event.toolCallId, name: event.toolName, args: event.args });\n      break;\n    case 'tool_end': {\n      const matching = acc.toolCalls.find(c => c.id === event.toolCallId);\n      acc.toolResults.push({\n        id: event.toolCallId,\n        name: matching?.name ?? '',\n        result: event.result,\n        isError: event.isError,\n      });\n      break;\n    }\n    case 'usage_update':\n      acc.usage = {\n        inputTokens: event.usage.promptTokens,\n        outputTokens: event.usage.completionTokens,\n        totalTokens: event.usage.totalTokens,\n      };\n      break;\n    case 'error':\n      acc.error = {\n        name: event.error.name,\n        message: event.error.message,\n        stack: event.error.stack,\n      };\n      break;\n  }\n}\n\n/** Resolve a thread by its exact ID. Titles are not unique, so we don't match on them. */\nasync function resolveThread<TState extends Record<string, unknown>>(\n  session: Session<TState>,\n  threadId: string,\n  resourceId?: string,\n): Promise<{ threadId: string } | { error: string }> {\n  const threads = await session.thread.list(resourceId ? { allResources: true } : undefined);\n\n  const byId = threads.find(thread => thread.id === threadId && (!resourceId || thread.resourceId === resourceId));\n  if (byId) return { threadId: byId.id };\n\n  return { error: `No thread found with ID \"${threadId}\"` };\n}\n\n/**\n * A simple back-pressured async queue. Events are pushed in; consumers pull via\n * the async iterator. `close()` ends iteration after draining buffered events.\n *\n * Buffered events are bounded by `maxBuffer`: if a consumer never iterates (the\n * result-only path, `await run.result` without `for await (...)`) — or simply\n * falls far behind — the oldest buffered events are dropped instead of growing\n * without limit. The aggregated {@link RunMCResult} is built independently of\n * this queue, so dropping buffered events never affects the final result.\n */\nclass EventQueue<T> {\n  #buffer: T[] = [];\n  #resolvers: Array<(r: IteratorResult<T>) => void> = [];\n  #closed = false;\n  readonly #maxBuffer: number;\n\n  constructor(maxBuffer = 10_000) {\n    this.#maxBuffer = maxBuffer;\n  }\n\n  push(value: T): void {\n    if (this.#closed) return;\n    const resolve = this.#resolvers.shift();\n    if (resolve) {\n      resolve({ value, done: false });\n      return;\n    }\n    this.#buffer.push(value);\n    if (this.#buffer.length > this.#maxBuffer) {\n      // Bound memory: drop the oldest event once over the cap.\n      this.#buffer.shift();\n    }\n  }\n\n  close(): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    for (const resolve of this.#resolvers.splice(0)) {\n      resolve({ value: undefined as unknown as T, done: true });\n    }\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    return {\n      next: (): Promise<IteratorResult<T>> => {\n        if (this.#buffer.length > 0) {\n          return Promise.resolve({ value: this.#buffer.shift()!, done: false });\n        }\n        if (this.#closed) {\n          return Promise.resolve({ value: undefined as unknown as T, done: true });\n        }\n        return new Promise<IteratorResult<T>>(resolve => this.#resolvers.push(resolve));\n      },\n    };\n  }\n}\n\n/**\n * Run a headless MastraCode turn. Returns an {@link MCRun} handle that is\n * async-iterable over controller events and resolves to a {@link RunMCResult}.\n */\nexport function runMC<TState extends Record<string, unknown>>(options: RunMCOptions<TState>): MCRun {\n  const { controller, session } = options;\n  const goal = options.goal;\n  const policy: ResolutionPolicy = options.policy ?? autoApprovePolicy;\n\n  const queue = new EventQueue<AgentControllerEvent>();\n  const acc: MutableResult = { text: '', toolCalls: [], toolResults: [] };\n\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  let timedOut = false;\n  let aborted = false;\n  let maxTurnsExceeded = false;\n  let assistantTurns = 0;\n  let activeAssistantMessageId: string | undefined;\n  let settled = false;\n  let unsubscribe: (() => void) | undefined;\n  let resolveResult!: (r: RunMCResult) => void;\n\n  const result = new Promise<RunMCResult>(resolve => {\n    resolveResult = resolve;\n  });\n\n  function finish(status: RunMCStatus, data: Partial<RunMCResult> = {}): void {\n    if (settled) return;\n    settled = true;\n    if (timeoutId) clearTimeout(timeoutId);\n    unsubscribe?.();\n    queue.close();\n    resolveResult({\n      status,\n      text: acc.text,\n      finishReason: acc.finishReason,\n      usage: acc.usage,\n      toolCalls: acc.toolCalls,\n      toolResults: acc.toolResults,\n      threadId: acc.threadId ?? session.thread.getId() ?? undefined,\n      error: acc.error,\n      exitCode: exitCodeForStatus(status),\n      ...data,\n    });\n  }\n\n  function fail(message: string, name = 'Error'): void {\n    if (!acc.error) acc.error = { name, message };\n    finish('error');\n  }\n\n  function abort(): void {\n    if (settled) return;\n    aborted = true;\n    session.abort();\n  }\n\n  if (options.signal) {\n    if (options.signal.aborted) {\n      // Defer so the caller can attach iteration / result handlers first.\n      queueMicrotask(() => abort());\n    } else {\n      options.signal.addEventListener('abort', () => abort(), { once: true });\n    }\n  }\n\n  function armTimeout(): void {\n    if (!options.timeoutMs || settled) return;\n    if (timeoutId) clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => {\n      timedOut = true;\n      session.abort();\n      if (goal) finish('timeout');\n    }, options.timeoutMs);\n  }\n\n  // Kick off the run asynchronously so the MCRun handle is returned synchronously.\n  void (async () => {\n    armTimeout();\n\n    // --- Subscribe ---\n    unsubscribe = session.subscribe(event => {\n      if (settled) return;\n      if (goal) armTimeout();\n\n      if (event.type === 'tool_approval_required') {\n        let decision: 'approve' | 'deny';\n        try {\n          decision = policy.onToolApproval(event);\n        } catch (err) {\n          fail(`Resolution policy failed: ${(err as Error).message}`);\n          return;\n        }\n        session.respondToToolApproval({\n          decision: decision === 'approve' ? 'approve' : 'decline',\n          toolCallId: event.toolCallId,\n        });\n        queue.push(event);\n        return;\n      }\n\n      if (event.type === 'tool_suspended') {\n        let outcome: ReturnType<ResolutionPolicy['onSuspension']>;\n        try {\n          outcome = policy.onSuspension(event);\n        } catch (err) {\n          fail(`Resolution policy failed: ${(err as Error).message}`);\n          return;\n        }\n        if ('abort' in outcome) {\n          queue.push(event);\n          abort();\n          return;\n        }\n        void session.respondToToolSuspension({ toolCallId: event.toolCallId, resumeData: outcome.resumeData });\n        queue.push(event);\n        return;\n      }\n\n      if (event.type === 'message_start' && event.message.role === 'assistant') {\n        activeAssistantMessageId = event.message.id;\n      }\n\n      aggregate(event, acc);\n      queue.push(event);\n\n      if (event.type === 'error' && goal) {\n        finish('error');\n        return;\n      }\n\n      // Count agentic turns (one assistant response = one turn). When the cap is\n      // reached, abort the run; agent_end then resolves as 'max_turns'.\n      if (event.type === 'message_end' && event.id === activeAssistantMessageId && options.maxTurns !== undefined) {\n        activeAssistantMessageId = undefined;\n        assistantTurns += 1;\n        if (assistantTurns >= options.maxTurns && !maxTurnsExceeded) {\n          maxTurnsExceeded = true;\n          abort();\n        }\n      }\n\n      if (event.type === 'goal_evaluation' && goal && !event.payload.pending) {\n        if (event.payload.status === 'done' || event.payload.status === 'paused') {\n          finish(event.payload.status, {\n            objective: goal.objective,\n            goalEvent: event,\n            reason: event.payload.reason ?? event.payload.results?.[0]?.reason,\n            iterations: event.payload.iteration,\n            maxRuns: event.payload.maxRuns,\n          });\n        }\n        return;\n      }\n\n      if (event.type === 'agent_end') {\n        acc.finishReason = event.reason;\n        // Goal evaluations can arrive after the agent stream ends, so goal runs\n        // remain active until a terminal goal_evaluation is emitted.\n        if (goal) return;\n        if (timedOut) {\n          finish('timeout');\n        } else if (event.reason === 'error') {\n          finish('error');\n        } else if (maxTurnsExceeded && event.reason !== 'complete') {\n          // The cap forced an abort while the agent still had work to do.\n          finish('max_turns');\n        } else if ((event.reason === 'aborted' || aborted) && !maxTurnsExceeded) {\n          finish('aborted');\n        } else {\n          finish('completed');\n        }\n      }\n    });\n\n    // --- Thread resolution (read-only) ---\n    const thread = options.thread;\n    const targetResourceId = options.resourceId ?? session.identity.getResourceId();\n    let restoredThreadId: string | undefined;\n    try {\n      if (thread?.id) {\n        const resolved = await resolveThread(session, thread.id, targetResourceId);\n        if ('error' in resolved) return fail(resolved.error);\n        restoredThreadId = resolved.threadId;\n      } else if (thread?.continueLatest) {\n        const threads = await session.thread.list(targetResourceId ? { allResources: true } : undefined);\n        const resourceThreads = targetResourceId\n          ? threads.filter(candidate => candidate.resourceId === targetResourceId)\n          : threads;\n        if (resourceThreads.length > 0) {\n          restoredThreadId = [...resourceThreads].sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())[0]!.id;\n        }\n      }\n    } catch (err) {\n      return fail(`Failed to resolve thread: ${(err as Error).message}`);\n    }\n\n    // --- Config validation (read-only) ---\n    const restoredThreadSelection = Boolean(restoredThreadId || thread?.clone);\n    const modeIdForModel = options.mode ?? (options.modeDefaults ? session.mode.get() : undefined);\n    const configuredDefaultModelId = modeIdForModel ? options.modeDefaults?.[modeIdForModel] : undefined;\n    // A pack's model is not resolved here: a resumed thread restores its\n    // persisted mode during thread selection, and the pack selection depends\n    // on that mode. It is resolved and validated during config application.\n    const modelIdToApply = options.pack\n      ? options.model\n      : (options.model ?? (options.mode || !restoredThreadSelection ? configuredDefaultModelId : undefined));\n    // Where modelIdToApply came from, so validation errors name the right source.\n    const modelSource = options.model ? 'flag' : 'mode';\n    try {\n      if (options.mode && !controller.listModes().some(mode => mode.id === options.mode)) {\n        return fail(`Unknown mode: \"${options.mode}\"`);\n      }\n\n      if (modelIdToApply) {\n        const available = await controller.listAvailableModels();\n        const match = available.find(model => model.id === modelIdToApply);\n        if (!match) {\n          if (modelSource === 'flag') return fail(`Unknown model: \"${modelIdToApply}\"`);\n          return fail(`Unknown model \"${modelIdToApply}\" configured for mode \"${modeIdForModel}\"`);\n        }\n        if (!match.hasApiKey) {\n          const keyHint = match.apiKeyEnvVar ? ` Set ${match.apiKeyEnvVar} to use this model.` : '';\n          if (modelSource === 'flag') return fail(`Model \"${modelIdToApply}\" has no API key configured.${keyHint}`);\n          return fail(`Model \"${modelIdToApply}\" (mode: ${modeIdForModel}) has no API key configured.${keyHint}`);\n        }\n      }\n    } catch (err) {\n      return fail(`Failed to resolve run config: ${(err as Error).message}`);\n    }\n\n    // --- Resource id ---\n    try {\n      if (options.resourceId) {\n        await controller.setResourceId(session, { resourceId: options.resourceId });\n      }\n    } catch (err) {\n      return fail(`Failed to set resource id: ${(err as Error).message}`);\n    }\n\n    // --- Thread selection ---\n    try {\n      if (restoredThreadId) {\n        await session.thread.switch({ threadId: restoredThreadId });\n      } else if (!thread?.clone) {\n        await session.thread.create();\n      }\n    } catch (err) {\n      return fail(`Failed to select thread: ${(err as Error).message}`);\n    }\n\n    // --- Clone ---\n    if (thread?.clone) {\n      try {\n        await session.thread.clone();\n      } catch (err) {\n        return fail(`Failed to clone thread: ${(err as Error).message}`);\n      }\n    }\n\n    // --- Config application ---\n    try {\n      if (options.mode) {\n        await session.mode.switch({ modeId: options.mode });\n      }\n      let packModelId: string | undefined;\n      if (options.pack) {\n        // Resolve the selection against the mode in effect now — thread\n        // selection above may have restored a resumed thread's persisted mode.\n        const packModeId = options.mode ?? session.mode.get();\n        const packSelection = options.pack.resolve(packModeId);\n        if (!packSelection) {\n          return fail(`Model pack \"${options.pack.id}\" has no model for ${packModeId} mode`);\n        }\n        const available = await controller.listAvailableModels();\n        const match = available.find(model => model.id === packSelection.modelId);\n        if (!match) {\n          return fail(`Unknown model \"${packSelection.modelId}\" from pack \"${options.pack.id}\"`);\n        }\n        if (!match.hasApiKey) {\n          const keyHint = match.apiKeyEnvVar ? ` Set ${match.apiKeyEnvVar} to use this model.` : '';\n          return fail(\n            `Model \"${packSelection.modelId}\" (pack: ${options.pack.id}) has no API key configured.${keyHint}`,\n          );\n        }\n        packModelId = packSelection.modelId;\n        // Mirror /models → Activate on the session: sticky thread pack id,\n        // subagent models, and the fallback route. Clears any pending fallback\n        // from a continued thread so the pack's own route starts clean.\n        await session.thread.setSetting({ key: THREAD_ACTIVE_MODEL_PACK_ID_KEY, value: options.pack.id });\n        await session.thread.setSetting({ key: MODEL_FALLBACK_STATE_KEY, value: undefined });\n        for (const [agentType, modelId] of Object.entries(packSelection.subagentModels ?? {})) {\n          await session.subagents.model.set({ modelId, agentType });\n        }\n        await session.state.set({\n          modelRoute: packSelection.modelRoute,\n          [MODEL_FALLBACK_STATE_KEY]: null,\n        } as unknown as Partial<TState>);\n      }\n      const sessionModelId = modelIdToApply ?? packModelId;\n      if (sessionModelId) {\n        await session.model.switch(sessionModelId);\n      }\n      // Persist the pack activation (global default) only once the pack has\n      // fully taken effect on the session — a failed model switch above must\n      // not leave the global default changed.\n      options.pack?.onApplied?.();\n      if (options.thinkingLevel) {\n        await session.state.set({ thinkingLevel: options.thinkingLevel } as unknown as Partial<TState>);\n      }\n    } catch (err) {\n      return fail(`Failed to apply run config: ${(err as Error).message}`);\n    }\n\n    // --- Title ---\n    if (options.title) {\n      try {\n        await session.thread.rename({ title: options.title });\n      } catch (err) {\n        return fail(`Failed to set thread title: ${(err as Error).message}`);\n      }\n    }\n\n    // --- Start ---\n    try {\n      if (goal) {\n        const threadId = session.thread.getId();\n        if (!threadId || !(await session.thread.getById({ threadId }))) {\n          await session.thread.create();\n        }\n\n        const goalManager = goal.goalManager ?? new GoalManager();\n        const state = {\n          controller,\n          session,\n          goalManager,\n          pendingNewThread: false,\n        } as any;\n        const objective = await goalManager.setGoal(state, goal.objective, goal.judgeModelId, goal.maxRuns);\n        if (!objective) return fail('Failed to set goal.');\n\n        const agent = controller.getCurrentAgent(session);\n        const persisted = await agent.getObjective({ threadId: session.thread.getId()! });\n        if (!persisted || persisted.id !== objective.id) {\n          return fail('Failed to persist goal objective before sending goal signal.');\n        }\n\n        await goalManager.saveToThread(state);\n        if (!settled) await session.sendSignal(createGoalReminderSignal(objective)).accepted;\n      } else {\n        if (!options.prompt) return fail('A prompt or goal is required.');\n        await session.sendMessage({ content: options.prompt });\n      }\n    } catch (err) {\n      if (\n        isSessionStartupCancelledError(err) ||\n        (err instanceof Error && err.name === 'AbortError' && (aborted || timedOut || options.signal?.aborted))\n      ) {\n        return finish(timedOut ? 'timeout' : maxTurnsExceeded ? 'max_turns' : 'aborted');\n      }\n      return fail(`Failed to start run: ${(err as Error).message}`);\n    }\n  })();\n\n  return {\n    result,\n    abort,\n    [Symbol.asyncIterator](): AsyncIterator<AgentControllerEvent> {\n      return queue[Symbol.asyncIterator]();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/headless/types.d.ts

@@ -7,6 +7,7 @@
  */
 import type { AgentController, AgentControllerEvent, Session } from '@mastra/core/agent-controller';
 import type { GoalManager } from '../goal-manager.js';
+import type { PackSelection } from '../onboarding/pack-activation.js';
 export type RunMode = 'build' | 'plan' | 'fast';
 export type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 export declare const VALID_MODES: readonly ["build", "plan", "fast"];
@@ -54,12 +55,27 @@ interface RunMCBaseOptions<TState extends Record<string, unknown> = Record<strin
     controller: AgentController<TState>;
     /** Session built via `createMastraCode(...)`. */
     session: Session<TState>;
-    /** Explicit model id override. Takes precedence over `mode`. */
+    /** Explicit model id override. Takes precedence over `mode` and `pack`. */
     model?: string;
     /** Execution mode; resolves a model from `modeDefaults` when `model` is absent. */
     mode?: RunMode;
     /** Per-mode default model ids (resolved from settings at startup). */
     modeDefaults?: Record<string, string>;
+    /**
+     * A model pack to activate for the run (canonical id from
+     * `resolveModePackArg`). The selection is resolved via `resolve` only after
+     * thread selection, because a resumed thread restores its persisted mode —
+     * the mode that decides which model the pack provides. Sets the thread's
+     * activeModelPackId, the subagent models, and the model route; `model`
+     * still wins for the active mode's session model. `onApplied` fires once
+     * the pack has been applied to the session (used by the CLI to persist the
+     * activation as the global default only when it actually took effect).
+     */
+    pack?: {
+        id: string;
+        resolve: (modeId: string) => PackSelection | undefined;
+        onApplied?: () => void;
+    };
     /** Thinking-effort level. */
     thinkingLevel?: ThinkingLevel;
     /** Thread selection / mutation. */

package/dist/headless/types.d.ts.map

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

package/dist/headless/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/headless/types.ts"],"sourcesContent":["/**\n * Shared types for the headless / programmatic MastraCode API.\n *\n * These types are consumed by the core runner (`runMC`), the resolution policy,\n * the output formatters, and the CLI adapter. They are intentionally free of any\n * `process.*` access so the core API is usable from CI / Node code.\n */\nimport type { AgentController, AgentControllerEvent, Session } from '@mastra/core/agent-controller';\n\nimport type { GoalManager } from '../goal-manager.js';\n\nexport type RunMode = 'build' | 'plan' | 'fast';\nexport type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\n\nexport const VALID_MODES = ['build', 'plan', 'fast'] as const;\nexport const VALID_THINKING_LEVELS = ['off', 'low', 'medium', 'high', 'xhigh', 'max'] as const;\n\n/**\n * Named permission modes for non-interactive runs. Maps to a built-in\n * {@link ResolutionPolicy}:\n *  - `auto`   — approve every tool and auto-resolve suspensions (the default).\n *  - `deny`   — refuse every tool approval and abort on any suspension.\n */\nexport type PermissionMode = 'auto' | 'deny';\nexport const VALID_PERMISSION_MODES = ['auto', 'deny'] as const;\n\n/** How `runMC` should resume `tool_approval_required` and `tool_suspended` events. */\nexport interface ResolutionPolicy {\n  /**\n   * Called for every `tool_approval_required` event. Return the decision; the\n   * runner forwards it to `session.respondToToolApproval`.\n   */\n  onToolApproval(event: Extract<AgentControllerEvent, { type: 'tool_approval_required' }>): 'approve' | 'deny';\n  /**\n   * Called for every `tool_suspended` event. Return `resumeData` to resume the\n   * tool, or `{ abort: true }` to abort the run.\n   */\n  onSuspension(\n    event: Extract<AgentControllerEvent, { type: 'tool_suspended' }>,\n  ): { resumeData: unknown } | { abort: true };\n}\n\n/** Thread selection / mutation options resolved up front by `runMC`. */\nexport interface RunMCThreadOptions {\n  /** Resume a specific thread by its exact id. */\n  id?: string;\n  /** Resume the most recently updated thread instead of creating a new one. */\n  continueLatest?: boolean;\n  /** Clone the resolved (or current) thread before running — work on a copy. */\n  clone?: boolean;\n}\n\ninterface RunMCBaseOptions<TState extends Record<string, unknown> = Record<string, unknown>> {\n  /** Controller built via `createMastraCode(...)`. */\n  controller: AgentController<TState>;\n  /** Session built via `createMastraCode(...)`. */\n  session: Session<TState>;\n\n  /** Explicit model id override. Takes precedence over `mode`. */\n  model?: string;\n  /** Execution mode; resolves a model from `modeDefaults` when `model` is absent. */\n  mode?: RunMode;\n  /** Per-mode default model ids (resolved from settings at startup). */\n  modeDefaults?: Record<string, string>;\n  /** Thinking-effort level. */\n  thinkingLevel?: ThinkingLevel;\n  /** Thread selection / mutation. */\n  thread?: RunMCThreadOptions;\n  /** Resource id for thread scoping. */\n  resourceId?: string;\n  /** Set or rename the thread title before running. */\n  title?: string;\n  /** Abort with `status: 'timeout'` (exit code 2) after this many ms without an event. */\n  timeoutMs?: number;\n  /**\n   * Maximum number of agentic turns (assistant responses). When the limit is\n   * reached the run aborts with `status: 'max_turns'` (exit code 1). No limit\n   * by default.\n   */\n  maxTurns?: number;\n  /** How approvals / suspensions are resolved. Defaults to {@link autoApprovePolicy}. */\n  policy?: ResolutionPolicy;\n  /** External abort signal; aborting it aborts the run. */\n  signal?: AbortSignal;\n}\n\nexport interface RunMCGoalOptions {\n  objective: string;\n  judgeModelId: string;\n  maxRuns: number;\n  goalManager?: GoalManager;\n}\n\nexport type RunMCOptions<TState extends Record<string, unknown> = Record<string, unknown>> = RunMCBaseOptions<TState> &\n  (\n    | {\n        /** The task to run as a regular headless turn. */\n        prompt: string;\n        goal?: never;\n      }\n    | {\n        prompt?: never;\n        /** Run a persisted goal instead of a regular prompt. */\n        goal: RunMCGoalOptions;\n      }\n  );\n\nexport type RunMCStatus = 'completed' | 'done' | 'paused' | 'error' | 'aborted' | 'timeout' | 'max_turns';\n\nexport interface RunMCUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface RunMCToolCall {\n  id: string;\n  name: string;\n  args: unknown;\n}\n\nexport interface RunMCToolResult {\n  id: string;\n  name: string;\n  result: unknown;\n  isError: boolean;\n}\n\nexport interface RunMCError {\n  name: string;\n  message: string;\n  stack?: string;\n}\n\nexport interface RunMCResult {\n  status: RunMCStatus;\n  /** Aggregated assistant text across all message_end events. */\n  text: string;\n  /** Goal objective when this was a goal run. */\n  objective?: string;\n  /** Terminal goal evaluation when this was a goal run. */\n  goalEvent?: Extract<AgentControllerEvent, { type: 'goal_evaluation' }>;\n  reason?: string;\n  iterations?: number;\n  maxRuns?: number;\n  /** Underlying finish reason from `agent_end`, when the run finished normally. */\n  finishReason?: string;\n  usage?: RunMCUsage;\n  toolCalls: RunMCToolCall[];\n  toolResults: RunMCToolResult[];\n  threadId?: string;\n  error?: RunMCError;\n  /** 0 success, 1 error/aborted/max_turns, 2 timeout. */\n  exitCode: number;\n}\n\n/**\n * A handle to an in-flight `runMC` run. It is async-iterable over controller\n * events and also resolves to a final {@link RunMCResult} via `result`.\n *\n * Both `for await (const e of run)` and `await run.result` work on the same run;\n * awaiting `result` without iterating still drains events internally.\n */\nexport interface MCRun extends AsyncIterable<AgentControllerEvent> {\n  /** Resolves once the run completes, times out, errors, or is aborted. */\n  result: Promise<RunMCResult>;\n  /** Abort the in-flight run. */\n  abort(): void;\n}\n"],"mappings":";AAcA,MAAa,cAAc;CAAC;CAAS;CAAQ;AAAM;AACnD,MAAa,wBAAwB;CAAC;CAAO;CAAO;CAAU;CAAQ;CAAS;AAAK;AASpF,MAAa,yBAAyB,CAAC,QAAQ,MAAM"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/headless/types.ts"],"sourcesContent":["/**\n * Shared types for the headless / programmatic MastraCode API.\n *\n * These types are consumed by the core runner (`runMC`), the resolution policy,\n * the output formatters, and the CLI adapter. They are intentionally free of any\n * `process.*` access so the core API is usable from CI / Node code.\n */\nimport type { AgentController, AgentControllerEvent, Session } from '@mastra/core/agent-controller';\n\nimport type { GoalManager } from '../goal-manager.js';\nimport type { PackSelection } from '../onboarding/pack-activation.js';\n\nexport type RunMode = 'build' | 'plan' | 'fast';\nexport type ThinkingLevel = 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\n\nexport const VALID_MODES = ['build', 'plan', 'fast'] as const;\nexport const VALID_THINKING_LEVELS = ['off', 'low', 'medium', 'high', 'xhigh', 'max'] as const;\n\n/**\n * Named permission modes for non-interactive runs. Maps to a built-in\n * {@link ResolutionPolicy}:\n *  - `auto`   — approve every tool and auto-resolve suspensions (the default).\n *  - `deny`   — refuse every tool approval and abort on any suspension.\n */\nexport type PermissionMode = 'auto' | 'deny';\nexport const VALID_PERMISSION_MODES = ['auto', 'deny'] as const;\n\n/** How `runMC` should resume `tool_approval_required` and `tool_suspended` events. */\nexport interface ResolutionPolicy {\n  /**\n   * Called for every `tool_approval_required` event. Return the decision; the\n   * runner forwards it to `session.respondToToolApproval`.\n   */\n  onToolApproval(event: Extract<AgentControllerEvent, { type: 'tool_approval_required' }>): 'approve' | 'deny';\n  /**\n   * Called for every `tool_suspended` event. Return `resumeData` to resume the\n   * tool, or `{ abort: true }` to abort the run.\n   */\n  onSuspension(\n    event: Extract<AgentControllerEvent, { type: 'tool_suspended' }>,\n  ): { resumeData: unknown } | { abort: true };\n}\n\n/** Thread selection / mutation options resolved up front by `runMC`. */\nexport interface RunMCThreadOptions {\n  /** Resume a specific thread by its exact id. */\n  id?: string;\n  /** Resume the most recently updated thread instead of creating a new one. */\n  continueLatest?: boolean;\n  /** Clone the resolved (or current) thread before running — work on a copy. */\n  clone?: boolean;\n}\n\ninterface RunMCBaseOptions<TState extends Record<string, unknown> = Record<string, unknown>> {\n  /** Controller built via `createMastraCode(...)`. */\n  controller: AgentController<TState>;\n  /** Session built via `createMastraCode(...)`. */\n  session: Session<TState>;\n\n  /** Explicit model id override. Takes precedence over `mode` and `pack`. */\n  model?: string;\n  /** Execution mode; resolves a model from `modeDefaults` when `model` is absent. */\n  mode?: RunMode;\n  /** Per-mode default model ids (resolved from settings at startup). */\n  modeDefaults?: Record<string, string>;\n  /**\n   * A model pack to activate for the run (canonical id from\n   * `resolveModePackArg`). The selection is resolved via `resolve` only after\n   * thread selection, because a resumed thread restores its persisted mode —\n   * the mode that decides which model the pack provides. Sets the thread's\n   * activeModelPackId, the subagent models, and the model route; `model`\n   * still wins for the active mode's session model. `onApplied` fires once\n   * the pack has been applied to the session (used by the CLI to persist the\n   * activation as the global default only when it actually took effect).\n   */\n  pack?: {\n    id: string;\n    resolve: (modeId: string) => PackSelection | undefined;\n    onApplied?: () => void;\n  };\n  /** Thinking-effort level. */\n  thinkingLevel?: ThinkingLevel;\n  /** Thread selection / mutation. */\n  thread?: RunMCThreadOptions;\n  /** Resource id for thread scoping. */\n  resourceId?: string;\n  /** Set or rename the thread title before running. */\n  title?: string;\n  /** Abort with `status: 'timeout'` (exit code 2) after this many ms without an event. */\n  timeoutMs?: number;\n  /**\n   * Maximum number of agentic turns (assistant responses). When the limit is\n   * reached the run aborts with `status: 'max_turns'` (exit code 1). No limit\n   * by default.\n   */\n  maxTurns?: number;\n  /** How approvals / suspensions are resolved. Defaults to {@link autoApprovePolicy}. */\n  policy?: ResolutionPolicy;\n  /** External abort signal; aborting it aborts the run. */\n  signal?: AbortSignal;\n}\n\nexport interface RunMCGoalOptions {\n  objective: string;\n  judgeModelId: string;\n  maxRuns: number;\n  goalManager?: GoalManager;\n}\n\nexport type RunMCOptions<TState extends Record<string, unknown> = Record<string, unknown>> = RunMCBaseOptions<TState> &\n  (\n    | {\n        /** The task to run as a regular headless turn. */\n        prompt: string;\n        goal?: never;\n      }\n    | {\n        prompt?: never;\n        /** Run a persisted goal instead of a regular prompt. */\n        goal: RunMCGoalOptions;\n      }\n  );\n\nexport type RunMCStatus = 'completed' | 'done' | 'paused' | 'error' | 'aborted' | 'timeout' | 'max_turns';\n\nexport interface RunMCUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface RunMCToolCall {\n  id: string;\n  name: string;\n  args: unknown;\n}\n\nexport interface RunMCToolResult {\n  id: string;\n  name: string;\n  result: unknown;\n  isError: boolean;\n}\n\nexport interface RunMCError {\n  name: string;\n  message: string;\n  stack?: string;\n}\n\nexport interface RunMCResult {\n  status: RunMCStatus;\n  /** Aggregated assistant text across all message_end events. */\n  text: string;\n  /** Goal objective when this was a goal run. */\n  objective?: string;\n  /** Terminal goal evaluation when this was a goal run. */\n  goalEvent?: Extract<AgentControllerEvent, { type: 'goal_evaluation' }>;\n  reason?: string;\n  iterations?: number;\n  maxRuns?: number;\n  /** Underlying finish reason from `agent_end`, when the run finished normally. */\n  finishReason?: string;\n  usage?: RunMCUsage;\n  toolCalls: RunMCToolCall[];\n  toolResults: RunMCToolResult[];\n  threadId?: string;\n  error?: RunMCError;\n  /** 0 success, 1 error/aborted/max_turns, 2 timeout. */\n  exitCode: number;\n}\n\n/**\n * A handle to an in-flight `runMC` run. It is async-iterable over controller\n * events and also resolves to a final {@link RunMCResult} via `result`.\n *\n * Both `for await (const e of run)` and `await run.result` work on the same run;\n * awaiting `result` without iterating still drains events internally.\n */\nexport interface MCRun extends AsyncIterable<AgentControllerEvent> {\n  /** Resolves once the run completes, times out, errors, or is aborted. */\n  result: Promise<RunMCResult>;\n  /** Abort the in-flight run. */\n  abort(): void;\n}\n"],"mappings":";AAeA,MAAa,cAAc;CAAC;CAAS;CAAQ;AAAM;AACnD,MAAa,wBAAwB;CAAC;CAAO;CAAO;CAAU;CAAQ;CAAS;AAAK;AASpF,MAAa,yBAAyB,CAAC,QAAQ,MAAM"}

package/dist/onboarding/pack-activation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared model-pack resolution and activation helpers.
+ *
+ * Used by both the interactive TUI (`--pack`, /models → Activate) and the
+ * headless CLI (`--pack`) so a pack id from the command line behaves exactly
+ * like activating the pack in the picker: the global default pack changes and
+ * the session it starts gets the pack's models for every mode, its subagent
+ * models, its fallback route, and the thread's `activeModelPackId`.
+ */
+import { type ModePack } from './packs.js';
+import { type GlobalSettings } from './settings.js';
+/** Every pack id that can be activated: built-ins plus saved custom packs (`custom:<name>`). */
+export declare function listResolvableModePacks(settings: GlobalSettings): ModePack[];
+/** The valid `--pack` values, in display order. */
+export declare function listValidModePackIds(settings: GlobalSettings): string[];
+/**
+ * Resolve a `--pack` argument to a canonical pack id.
+ *
+ * Accepts a built-in pack id (`anthropic`), a fully qualified custom pack id
+ * (`custom:Kimi`), or a bare custom pack name (`Kimi`) — the `custom:` prefix
+ * is a storage detail users never see in the picker. On a collision between a
+ * built-in id and a custom pack name, the built-in wins; `custom:<name>`
+ * always reaches the custom pack.
+ */
+export declare function resolveModePackArg(settings: GlobalSettings, raw: string): {
+    packId: string;
+} | {
+    error: string;
+};
+export interface PackSelection {
+    modelId: string;
+    subagentModels: Record<string, string>;
+    modelRoute: {
+        entries: Array<{
+            id: string;
+            label: string;
+            modelId: string;
+            accountId?: string;
+            memoryModelId?: string;
+        }>;
+    };
+}
+/** Resolve what activating `packId` in `modeId` applies to the session. */
+export declare function resolvePackSelection(settings: GlobalSettings, packId: string, modeId: string): PackSelection | undefined;
+/**
+ * Mutate global settings the way /models → Activate does: point the global
+ * default pack at `packId` and clear the per-agent subagent model overrides
+ * so the pack's subagent models apply. The caller persists with
+ * `saveSettings`.
+ */
+export declare function activateModePackInSettings(settings: GlobalSettings, packId: string): void;
+//# sourceMappingURL=pack-activation.d.ts.map

package/dist/onboarding/pack-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-activation.d.ts","sourceRoot":"","sources":["../../src/onboarding/pack-activation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAsD,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3E,gGAAgG;AAChG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,QAAQ,EAAE,CAe5E;AAED,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAWhH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC,CAAC;KACJ,CAAC;CACH;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,SAAS,CAyC3B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgBzF"}

package/dist/onboarding/pack-activation.js

@@ -0,0 +1,108 @@
+import { listBuiltinModePacks, resolveModePackFallbackChain } from "./packs.js";
+import { resolveModePackModels } from "./settings.js";
+//#region src/onboarding/pack-activation.ts
+/**
+* Shared model-pack resolution and activation helpers.
+*
+* Used by both the interactive TUI (`--pack`, /models → Activate) and the
+* headless CLI (`--pack`) so a pack id from the command line behaves exactly
+* like activating the pack in the picker: the global default pack changes and
+* the session it starts gets the pack's models for every mode, its subagent
+* models, its fallback route, and the thread's `activeModelPackId`.
+*/
+/** Every pack id that can be activated: built-ins plus saved custom packs (`custom:<name>`). */
+function listResolvableModePacks(settings) {
+	return [...listBuiltinModePacks(), ...settings.customModelPacks.map((pack) => ({
+		id: `custom:${pack.name}`,
+		name: pack.name,
+		description: "Saved custom pack",
+		models: {
+			build: pack.models.build ?? "",
+			plan: pack.models.plan ?? "",
+			fast: pack.models.fast ?? "",
+			...pack.models.memory ? { memory: pack.models.memory } : {}
+		}
+	}))];
+}
+/** The valid `--pack` values, in display order. */
+function listValidModePackIds(settings) {
+	return listResolvableModePacks(settings).map((pack) => pack.id);
+}
+/**
+* Resolve a `--pack` argument to a canonical pack id.
+*
+* Accepts a built-in pack id (`anthropic`), a fully qualified custom pack id
+* (`custom:Kimi`), or a bare custom pack name (`Kimi`) — the `custom:` prefix
+* is a storage detail users never see in the picker. On a collision between a
+* built-in id and a custom pack name, the built-in wins; `custom:<name>`
+* always reaches the custom pack.
+*/
+function resolveModePackArg(settings, raw) {
+	const input = raw.trim();
+	const valid = listValidModePackIds(settings);
+	if (input && valid.includes(input)) return { packId: input };
+	if (input && !input.startsWith("custom:")) {
+		const asCustom = `custom:${input}`;
+		if (valid.includes(asCustom)) return { packId: asCustom };
+	}
+	return { error: `Unknown model pack: "${raw}". Valid packs: ${valid.join(", ")} (a custom pack also accepts its bare name, e.g. "Kimi" for "custom:Kimi")` };
+}
+/** Resolve what activating `packId` in `modeId` applies to the session. */
+function resolvePackSelection(settings, packId, modeId) {
+	const packs = listResolvableModePacks(settings);
+	const packsById = new Map(packs.map((pack) => [pack.id, pack]));
+	const pack = packsById.get(packId);
+	if (!pack) return void 0;
+	const packModels = resolveModePackModels(settings, pack);
+	const modelId = packModels[modeId];
+	if (!modelId) return void 0;
+	return {
+		modelId,
+		subagentModels: Object.fromEntries(Object.entries({
+			explore: "fast",
+			plan: "plan",
+			execute: "build"
+		}).flatMap(([agentType, subagentModeId]) => {
+			const subagentModelId = packModels[subagentModeId];
+			return subagentModelId ? [[agentType, subagentModelId]] : [];
+		})),
+		modelRoute: { entries: resolveModePackFallbackChain(settings.models.packFallbacks, packId, settings.customModelPacks).flatMap((routeId) => {
+			const routePack = packsById.get(routeId);
+			if (!routePack) return [];
+			const routeModels = resolveModePackModels(settings, routePack);
+			const routeModelId = routeModels[modeId];
+			if (!routeModelId) return [];
+			const accountId = settings.models.packAccountPreferences?.[routeId]?.[routeModelId];
+			return [{
+				id: routeId,
+				label: routePack.name,
+				modelId: routeModelId,
+				...accountId ? { accountId } : {},
+				...routeModels.memory ? { memoryModelId: routeModels.memory } : {}
+			}];
+		}) }
+	};
+}
+/**
+* Mutate global settings the way /models → Activate does: point the global
+* default pack at `packId` and clear the per-agent subagent model overrides
+* so the pack's subagent models apply. The caller persists with
+* `saveSettings`.
+*/
+function activateModePackInSettings(settings, packId) {
+	settings.models.activeModelPackId = packId;
+	if (packId.startsWith("custom:")) {
+		const pack = listResolvableModePacks(settings).find((candidate) => candidate.id === packId);
+		if (pack) settings.models.modeDefaults = {
+			build: pack.models.build,
+			plan: pack.models.plan,
+			fast: pack.models.fast,
+			...pack.models.memory ? { memory: pack.models.memory } : {}
+		};
+	} else settings.models.modeDefaults = {};
+	settings.models.subagentModels = {};
+}
+//#endregion
+export { activateModePackInSettings, listResolvableModePacks, listValidModePackIds, resolveModePackArg, resolvePackSelection };
+
+//# sourceMappingURL=pack-activation.js.map

package/dist/onboarding/pack-activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-activation.js","names":[],"sources":["../../src/onboarding/pack-activation.ts"],"sourcesContent":["/**\n * Shared model-pack resolution and activation helpers.\n *\n * Used by both the interactive TUI (`--pack`, /models → Activate) and the\n * headless CLI (`--pack`) so a pack id from the command line behaves exactly\n * like activating the pack in the picker: the global default pack changes and\n * the session it starts gets the pack's models for every mode, its subagent\n * models, its fallback route, and the thread's `activeModelPackId`.\n */\nimport { listBuiltinModePacks, resolveModePackFallbackChain, type ModePack } from './packs.js';\nimport { resolveModePackModels, type GlobalSettings } from './settings.js';\n\n/** Every pack id that can be activated: built-ins plus saved custom packs (`custom:<name>`). */\nexport function listResolvableModePacks(settings: GlobalSettings): ModePack[] {\n  return [\n    ...listBuiltinModePacks(),\n    ...settings.customModelPacks.map(pack => ({\n      id: `custom:${pack.name}`,\n      name: pack.name,\n      description: 'Saved custom pack',\n      models: {\n        build: pack.models.build ?? '',\n        plan: pack.models.plan ?? '',\n        fast: pack.models.fast ?? '',\n        ...(pack.models.memory ? { memory: pack.models.memory } : {}),\n      },\n    })),\n  ];\n}\n\n/** The valid `--pack` values, in display order. */\nexport function listValidModePackIds(settings: GlobalSettings): string[] {\n  return listResolvableModePacks(settings).map(pack => pack.id);\n}\n\n/**\n * Resolve a `--pack` argument to a canonical pack id.\n *\n * Accepts a built-in pack id (`anthropic`), a fully qualified custom pack id\n * (`custom:Kimi`), or a bare custom pack name (`Kimi`) — the `custom:` prefix\n * is a storage detail users never see in the picker. On a collision between a\n * built-in id and a custom pack name, the built-in wins; `custom:<name>`\n * always reaches the custom pack.\n */\nexport function resolveModePackArg(settings: GlobalSettings, raw: string): { packId: string } | { error: string } {\n  const input = raw.trim();\n  const valid = listValidModePackIds(settings);\n  if (input && valid.includes(input)) return { packId: input };\n  if (input && !input.startsWith('custom:')) {\n    const asCustom = `custom:${input}`;\n    if (valid.includes(asCustom)) return { packId: asCustom };\n  }\n  return {\n    error: `Unknown model pack: \"${raw}\". Valid packs: ${valid.join(', ')} (a custom pack also accepts its bare name, e.g. \"Kimi\" for \"custom:Kimi\")`,\n  };\n}\n\nexport interface PackSelection {\n  modelId: string;\n  subagentModels: Record<string, string>;\n  modelRoute: {\n    entries: Array<{\n      id: string;\n      label: string;\n      modelId: string;\n      accountId?: string;\n      memoryModelId?: string;\n    }>;\n  };\n}\n\n/** Resolve what activating `packId` in `modeId` applies to the session. */\nexport function resolvePackSelection(\n  settings: GlobalSettings,\n  packId: string,\n  modeId: string,\n): PackSelection | undefined {\n  const packs = listResolvableModePacks(settings);\n  const packsById = new Map(packs.map(pack => [pack.id, pack]));\n  const pack = packsById.get(packId);\n  if (!pack) return undefined;\n\n  const packModels = resolveModePackModels(settings, pack);\n  const modelId = packModels[modeId];\n  if (!modelId) return undefined;\n\n  const subagentModeMap: Record<string, string> = { explore: 'fast', plan: 'plan', execute: 'build' };\n  const subagentModels = Object.fromEntries(\n    Object.entries(subagentModeMap).flatMap(([agentType, subagentModeId]) => {\n      const subagentModelId = packModels[subagentModeId];\n      return subagentModelId ? [[agentType, subagentModelId]] : [];\n    }),\n  );\n\n  const routeIds = resolveModePackFallbackChain(settings.models.packFallbacks, packId, settings.customModelPacks);\n  const entries = routeIds.flatMap(routeId => {\n    const routePack = packsById.get(routeId);\n    if (!routePack) return [];\n    const routeModels = resolveModePackModels(settings, routePack);\n    const routeModelId = routeModels[modeId];\n    if (!routeModelId) return [];\n    const accountId = settings.models.packAccountPreferences?.[routeId]?.[routeModelId];\n    return [\n      {\n        id: routeId,\n        label: routePack.name,\n        modelId: routeModelId,\n        ...(accountId ? { accountId } : {}),\n        ...(routeModels.memory ? { memoryModelId: routeModels.memory } : {}),\n      },\n    ];\n  });\n\n  // The pack's memory model rides on the route rather than pinning the OM\n  // roles, so it applies only while the pack is active and `/om` choices return\n  // when it is not.\n  return { modelId, subagentModels, modelRoute: { entries } };\n}\n\n/**\n * Mutate global settings the way /models → Activate does: point the global\n * default pack at `packId` and clear the per-agent subagent model overrides\n * so the pack's subagent models apply. The caller persists with\n * `saveSettings`.\n */\nexport function activateModePackInSettings(settings: GlobalSettings, packId: string): void {\n  settings.models.activeModelPackId = packId;\n  if (packId.startsWith('custom:')) {\n    const pack = listResolvableModePacks(settings).find(candidate => candidate.id === packId);\n    if (pack) {\n      settings.models.modeDefaults = {\n        build: pack.models.build,\n        plan: pack.models.plan,\n        fast: pack.models.fast,\n        ...(pack.models.memory ? { memory: pack.models.memory } : {}),\n      };\n    }\n  } else {\n    settings.models.modeDefaults = {};\n  }\n  settings.models.subagentModels = {};\n}\n"],"mappings":"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"}

package/dist/schema.d.ts

@@ -150,6 +150,9 @@ export declare const stateSchema: z.ZodPipe<z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     subagentModelId: z.ZodOptional<z.ZodString>;
+    subagentModelId_explore: z.ZodOptional<z.ZodString>;
+    subagentModelId_plan: z.ZodOptional<z.ZodString>;
+    subagentModelId_execute: z.ZodOptional<z.ZodString>;
     projectPath: z.ZodOptional<z.ZodString>;
     projectName: z.ZodOptional<z.ZodString>;
     factoryProjectId: z.ZodOptional<z.ZodString>;
@@ -317,6 +320,9 @@ export declare const stateSchema: z.ZodPipe<z.ZodObject<{
         }[];
     } | undefined;
     subagentModelId?: string | undefined;
+    subagentModelId_explore?: string | undefined;
+    subagentModelId_plan?: string | undefined;
+    subagentModelId_execute?: string | undefined;
     projectPath?: string | undefined;
     projectName?: string | undefined;
     factoryProjectId?: string | undefined;
@@ -409,6 +415,9 @@ export declare const stateSchema: z.ZodPipe<z.ZodObject<{
         }[];
     } | undefined;
     subagentModelId?: string | undefined;
+    subagentModelId_explore?: string | undefined;
+    subagentModelId_plan?: string | undefined;
+    subagentModelId_execute?: string | undefined;
     projectPath?: string | undefined;
     projectName?: string | undefined;
     factoryProjectId?: string | undefined;

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,sBAAsB,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IAC/C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,CAAC,GAAG,EAAE,mBAAmB,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,OAAO,CAAC;IAChC,uBAAuB,EAAE,OAAO,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oFAAoF;IACpF,8BAA8B,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7D;;;;OAIG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;KACzC,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IAClD,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;QAChD,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,qBAAqB,CAAC,EAAE;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,WAAW,GAAG,eAAe,CAAC;QACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,QAAQ,CAAC;QACxD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC5B,SAAS,CAAC,EAAE;YACV,GAAG,EAAE,OAAO,GAAG,aAAa,CAAC;YAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;SAC/B,CAAC;QACF,YAAY,CAAC,EAAE;YACb,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;IACF,kBAAkB,CAAC,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,mBAAmB,CAAC;QACxE,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqKnB,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -13,6 +13,9 @@ const stateSchema = z.object({
 		memoryModelId: z.string().max(512).optional()
 	})).max(32) }).optional(),
 	subagentModelId: z.string().optional(),
+	subagentModelId_explore: z.string().optional(),
+	subagentModelId_plan: z.string().optional(),
+	subagentModelId_execute: z.string().optional(),
 	projectPath: z.string().optional(),
 	projectName: z.string().optional(),
 	factoryProjectId: z.string().optional(),

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import type { OMModel } from '@mastra/core/agent-controller';\nimport { z } from 'zod';\nimport { DEFAULT_CONFIG_DIR, MODEL_ROUTE_MAX_ENTRIES, MODEL_ROUTE_MAX_FIELD_LENGTH } from './constants.js';\nimport { THINKING_LEVEL_VALUES } from './thinking.js';\nimport type { ThinkingLevelSetting } from './thinking.js';\n\nexport type PermissionPolicy = 'allow' | 'ask' | 'deny';\n\nexport type MastraCodeSessionState = {\n  currentModelId: string;\n  modeId: string;\n};\n\nexport type MastraCodeComposedState = MastraCodeState & MastraCodeSessionState;\n\nexport interface ModelRouteEntry {\n  id: string;\n  label: string;\n  modelId: string;\n  accountId?: string;\n  memoryModelId?: string;\n}\n\nexport interface ModelRoute {\n  entries: ModelRouteEntry[];\n}\n\nexport interface PendingModelFallback {\n  fromEntryId: string;\n  toEntryId: string;\n  toModelId: string;\n  threadId?: string;\n  reason: 'pool-exhausted' | 'persistent-outage';\n  at: string;\n}\n\nexport interface MastraCodeState {\n  [key: string]: unknown;\n  [key: `subagentModelId_${string}`]: string | undefined;\n  subagentModelId?: string;\n  projectPath?: string;\n  projectName?: string;\n  /** Factory project that owns this session. */\n  factoryProjectId?: string;\n  /** Authoritative organization id seeded by factory at session construction. */\n  factoryOrgId?: string;\n  /**\n   * Factory owns this session but could not resolve its organization. Knowledge\n   * capture refuses rather than filing under a substituted identity; without the\n   * marker a projectless factory session is indistinguishable from a local one.\n   */\n  factoryOrgUnresolved?: boolean;\n  /** Linked repository used by this session when source-control execution is required. */\n  projectRepositoryId?: string;\n  /** Active feature branch checked out in the session workdir. */\n  branch?: string;\n  /**\n   * The session's checkout contains third-party content (e.g. a PR branch\n   * under review). Project-level instruction files (AGENTS.md, CLAUDE.md)\n   * are attacker-writable there and must not be ingested into the system\n   * prompt or injected as reminders.\n   */\n  untrustedCheckout?: boolean;\n  /**\n   * Trusted git ref (typically the PR's base branch) to serve project\n   * instruction files from when the checkout is untrusted. Without it,\n   * project-scope instruction files are skipped entirely.\n   */\n  baseRef?: string;\n  /**\n   * Skip the home-directory instruction files (~/.claude/AGENTS.md and\n   * friends). Hosts running sessions for someone else set this so a run never\n   * inherits the machine owner's personal configuration.\n   */\n  skipGlobalInstructions?: boolean;\n  configDir: string;\n  homeDir?: string;\n  gitBranch?: string;\n  lastCommand?: string;\n  observerModelId?: string;\n  reflectorModelId?: string;\n  observerModelSelection: OMModel;\n  reflectorModelSelection: OMModel;\n  observationThreshold: number;\n  reflectionThreshold: number;\n  cavemanObservations: boolean;\n  observeAttachments: 'auto' | boolean;\n  omScope?: 'thread' | 'resource';\n  /** Ordered host-supplied model and account fallback route for this thread. */\n  modelRoute?: ModelRoute;\n  /** One-hop fallback intent written by account rotation and consumed by the host. */\n  mastracodePendingModelFallback?: PendingModelFallback | null;\n  /**\n   * Session-level reasoning-effort override. When unset, the effective level is\n   * resolved at request time from settings (`models.modeThinkingDefaults[mode]`\n   * falling back to `preferences.thinkingLevel`).\n   */\n  thinkingLevel?: ThinkingLevelSetting;\n  yolo: boolean;\n  permissionRules: {\n    categories: Record<string, PermissionPolicy>;\n    tools: Record<string, PermissionPolicy>;\n  };\n  smartEditing: boolean;\n  notifications: 'bell' | 'system' | 'both' | 'off';\n  tasks: Array<{\n    id?: string;\n    content: string;\n    status: 'pending' | 'in_progress' | 'completed';\n    activeForm: string;\n  }>;\n  sandboxAllowedPaths: string[];\n  pluginSkillPaths: string[];\n  pluginCommandPaths: string[];\n  pluginInstructions: string[];\n  activePlan: {\n    title: string;\n    plan: string;\n    approvedAt: string;\n  } | null;\n  activeBrowserSettings?: {\n    enabled: boolean;\n    provider: 'stagehand' | 'agent-browser';\n    headless?: boolean;\n    viewport?: { width: number; height: number } | 'window';\n    cdpUrl?: string;\n    profile?: string;\n    executablePath?: string;\n    scope?: 'shared' | 'thread';\n    stagehand?: {\n      env: 'LOCAL' | 'BROWSERBASE';\n      projectId?: string;\n      model?: string;\n      preserveUserDataDir?: boolean;\n    };\n    agentBrowser?: {\n      storageState?: string;\n    };\n  };\n  activeBrowserModel?: {\n    modelName?: string;\n    source: 'settings' | 'chat-model' | 'codex-oauth' | 'stagehand-default';\n    viaCodexOAuth: boolean;\n  };\n}\n\nexport const stateSchema = z\n  .object({\n    // Session-scoped selection. The controller validates state against this\n    // schema, so these keys must be declared here — Zod strips unknown keys.\n    currentModelId: z.string().optional(),\n    modeId: z.string().optional(),\n    modelRoute: z\n      .object({\n        entries: z\n          .array(\n            z.object({\n              id: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH),\n              label: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH),\n              modelId: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH),\n              accountId: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH).optional(),\n              memoryModelId: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH).optional(),\n            }),\n          )\n          .max(MODEL_ROUTE_MAX_ENTRIES),\n      })\n      .optional(),\n    subagentModelId: z.string().optional(),\n    projectPath: z.string().optional(),\n    projectName: z.string().optional(),\n    factoryProjectId: z.string().optional(),\n    factoryOrgId: z.string().optional(),\n    factoryOrgUnresolved: z.boolean().optional(),\n    projectRepositoryId: z.string().optional(),\n    branch: z.string().optional(),\n    // Session operates on an untrusted checkout — suppress AGENTS.md ingestion.\n    untrustedCheckout: z.boolean().optional(),\n    // Trusted ref to serve instruction files from on untrusted checkouts.\n    baseRef: z.string().optional(),\n    // Skip the operator machine's home-directory instruction files.\n    skipGlobalInstructions: z.boolean().optional(),\n    configDir: z.string().default(DEFAULT_CONFIG_DIR),\n    homeDir: z.string().optional(),\n    gitBranch: z.string().optional(),\n    lastCommand: z.string().optional(),\n    // Observational Memory model settings. Concrete IDs are legacy/explicit\n    // compatibility fields; fresh sessions preserve auto selection intent.\n    observerModelId: z.string().optional(),\n    reflectorModelId: z.string().optional(),\n    observerModelSelection: z.string().optional(),\n    reflectorModelSelection: z.string().optional(),\n    // Observational Memory threshold settings\n    observationThreshold: z.number().default(30_000),\n    reflectionThreshold: z.number().default(40_000),\n    // Whether observations and reflections use the terse caveman-style instruction.\n    // Off by default — caveman style is opt-in via `/om` settings; observers and\n    // reflectors fall back to their built-in (prose) behavior unless enabled.\n    cavemanObservations: z.boolean().default(false),\n    // Whether OM forwards image/file attachment parts to the Observer LLM.\n    // 'auto' (default) checks the provider capabilities registry to decide.\n    // true/false forces the setting regardless of model capabilities.\n    observeAttachments: z.union([z.literal('auto'), z.boolean()]).default('auto'),\n    // Observational Memory scope — 'thread' (per-conversation) or 'resource' (shared across threads)\n    omScope: z.enum(['thread', 'resource']).optional(),\n    // Thinking level for model reasoning effort. Optional: absent means \"no\n    // session override\" — the effective level is resolved from settings\n    // (per-mode defaults, then the global preference) at request time.\n    thinkingLevel: z.preprocess(\n      value => (value === null ? undefined : value),\n      z.enum(THINKING_LEVEL_VALUES).optional(),\n    ),\n    // YOLO mode — auto-approve all tool calls\n    yolo: z.boolean().default(false),\n    // Permission rules — per-category and per-tool approval policies\n    permissionRules: z\n      .object({\n        categories: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n        tools: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n      })\n      .default({ categories: {}, tools: {} }),\n    // Smart editing mode — use AST-based analysis for code edits\n    smartEditing: z.boolean().default(true),\n    // Notification mode — alert when TUI needs user attention\n    notifications: z.enum(['bell', 'system', 'both', 'off']).default('off'),\n    // Task list (ephemeral per-thread, cleared on thread switch/creation)\n    tasks: z\n      .array(\n        z.object({\n          id: z.string().optional(),\n          content: z.string(),\n          status: z.enum(['pending', 'in_progress', 'completed']),\n          activeForm: z.string(),\n        }),\n      )\n      .default([]),\n    // Sandbox allowed paths (per-thread, absolute paths allowed in addition to project root)\n    sandboxAllowedPaths: z.array(z.string()).default([]),\n    // Pending route hop written by account rotation. The host consumes it on\n    // `state_changed` to apply thread stickiness, then clears it back to null.\n    mastracodePendingModelFallback: z\n      .object({\n        fromEntryId: z.string(),\n        toEntryId: z.string(),\n        toModelId: z.string(),\n        threadId: z.string().optional(),\n        reason: z.enum(['pool-exhausted', 'persistent-outage']),\n        at: z.string(),\n      })\n      .nullish(),\n    // Asset directories contributed by active plugins.\n    pluginSkillPaths: z.array(z.string()).default([]),\n    pluginCommandPaths: z.array(z.string()).default([]),\n    pluginInstructions: z.array(z.string()).default([]),\n    // Active plan (set when a plan is approved in Plan mode)\n    activePlan: z\n      .object({\n        title: z.string(),\n        plan: z.string(),\n        approvedAt: z.string(),\n      })\n      .nullable()\n      .default(null),\n    // Active browser settings (tracks what's actually running vs. what's in the settings file)\n    activeBrowserSettings: z\n      .object({\n        enabled: z.boolean(),\n        provider: z.enum(['stagehand', 'agent-browser']),\n        headless: z.boolean().optional(),\n        viewport: z\n          .union([\n            z.object({\n              width: z.number(),\n              height: z.number(),\n            }),\n            z.literal('window'),\n          ])\n          .optional(),\n        cdpUrl: z.string().optional(),\n        profile: z.string().optional(),\n        executablePath: z.string().optional(),\n        scope: z.enum(['shared', 'thread']).optional(),\n        stagehand: z\n          .object({\n            env: z.enum(['LOCAL', 'BROWSERBASE']),\n            projectId: z.string().optional(),\n            model: z.string().optional(),\n            preserveUserDataDir: z.boolean().optional(),\n          })\n          .optional(),\n        agentBrowser: z\n          .object({\n            storageState: z.string().optional(),\n          })\n          .optional(),\n      })\n      .optional(),\n    // Model the active Stagehand browser was created with. Resolved once at\n    // launch so /browser status reports what is really running even if the\n    // user signs in/out of Codex afterwards.\n    activeBrowserModel: z\n      .object({\n        modelName: z.string().optional(),\n        source: z.enum(['settings', 'chat-model', 'codex-oauth', 'stagehand-default']),\n        viaCodexOAuth: z.boolean(),\n      })\n      .optional(),\n  })\n  .transform(state => ({\n    ...state,\n    observerModelSelection: state.observerModelSelection ?? state.observerModelId ?? 'auto',\n    reflectorModelSelection: state.reflectorModelSelection ?? state.reflectorModelId ?? 'auto',\n  }));\n"],"mappings":"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"}
+{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import type { OMModel } from '@mastra/core/agent-controller';\nimport { z } from 'zod';\nimport { DEFAULT_CONFIG_DIR, MODEL_ROUTE_MAX_ENTRIES, MODEL_ROUTE_MAX_FIELD_LENGTH } from './constants.js';\nimport { THINKING_LEVEL_VALUES } from './thinking.js';\nimport type { ThinkingLevelSetting } from './thinking.js';\n\nexport type PermissionPolicy = 'allow' | 'ask' | 'deny';\n\nexport type MastraCodeSessionState = {\n  currentModelId: string;\n  modeId: string;\n};\n\nexport type MastraCodeComposedState = MastraCodeState & MastraCodeSessionState;\n\nexport interface ModelRouteEntry {\n  id: string;\n  label: string;\n  modelId: string;\n  accountId?: string;\n  memoryModelId?: string;\n}\n\nexport interface ModelRoute {\n  entries: ModelRouteEntry[];\n}\n\nexport interface PendingModelFallback {\n  fromEntryId: string;\n  toEntryId: string;\n  toModelId: string;\n  threadId?: string;\n  reason: 'pool-exhausted' | 'persistent-outage';\n  at: string;\n}\n\nexport interface MastraCodeState {\n  [key: string]: unknown;\n  [key: `subagentModelId_${string}`]: string | undefined;\n  subagentModelId?: string;\n  projectPath?: string;\n  projectName?: string;\n  /** Factory project that owns this session. */\n  factoryProjectId?: string;\n  /** Authoritative organization id seeded by factory at session construction. */\n  factoryOrgId?: string;\n  /**\n   * Factory owns this session but could not resolve its organization. Knowledge\n   * capture refuses rather than filing under a substituted identity; without the\n   * marker a projectless factory session is indistinguishable from a local one.\n   */\n  factoryOrgUnresolved?: boolean;\n  /** Linked repository used by this session when source-control execution is required. */\n  projectRepositoryId?: string;\n  /** Active feature branch checked out in the session workdir. */\n  branch?: string;\n  /**\n   * The session's checkout contains third-party content (e.g. a PR branch\n   * under review). Project-level instruction files (AGENTS.md, CLAUDE.md)\n   * are attacker-writable there and must not be ingested into the system\n   * prompt or injected as reminders.\n   */\n  untrustedCheckout?: boolean;\n  /**\n   * Trusted git ref (typically the PR's base branch) to serve project\n   * instruction files from when the checkout is untrusted. Without it,\n   * project-scope instruction files are skipped entirely.\n   */\n  baseRef?: string;\n  /**\n   * Skip the home-directory instruction files (~/.claude/AGENTS.md and\n   * friends). Hosts running sessions for someone else set this so a run never\n   * inherits the machine owner's personal configuration.\n   */\n  skipGlobalInstructions?: boolean;\n  configDir: string;\n  homeDir?: string;\n  gitBranch?: string;\n  lastCommand?: string;\n  observerModelId?: string;\n  reflectorModelId?: string;\n  observerModelSelection: OMModel;\n  reflectorModelSelection: OMModel;\n  observationThreshold: number;\n  reflectionThreshold: number;\n  cavemanObservations: boolean;\n  observeAttachments: 'auto' | boolean;\n  omScope?: 'thread' | 'resource';\n  /** Ordered host-supplied model and account fallback route for this thread. */\n  modelRoute?: ModelRoute;\n  /** One-hop fallback intent written by account rotation and consumed by the host. */\n  mastracodePendingModelFallback?: PendingModelFallback | null;\n  /**\n   * Session-level reasoning-effort override. When unset, the effective level is\n   * resolved at request time from settings (`models.modeThinkingDefaults[mode]`\n   * falling back to `preferences.thinkingLevel`).\n   */\n  thinkingLevel?: ThinkingLevelSetting;\n  yolo: boolean;\n  permissionRules: {\n    categories: Record<string, PermissionPolicy>;\n    tools: Record<string, PermissionPolicy>;\n  };\n  smartEditing: boolean;\n  notifications: 'bell' | 'system' | 'both' | 'off';\n  tasks: Array<{\n    id?: string;\n    content: string;\n    status: 'pending' | 'in_progress' | 'completed';\n    activeForm: string;\n  }>;\n  sandboxAllowedPaths: string[];\n  pluginSkillPaths: string[];\n  pluginCommandPaths: string[];\n  pluginInstructions: string[];\n  activePlan: {\n    title: string;\n    plan: string;\n    approvedAt: string;\n  } | null;\n  activeBrowserSettings?: {\n    enabled: boolean;\n    provider: 'stagehand' | 'agent-browser';\n    headless?: boolean;\n    viewport?: { width: number; height: number } | 'window';\n    cdpUrl?: string;\n    profile?: string;\n    executablePath?: string;\n    scope?: 'shared' | 'thread';\n    stagehand?: {\n      env: 'LOCAL' | 'BROWSERBASE';\n      projectId?: string;\n      model?: string;\n      preserveUserDataDir?: boolean;\n    };\n    agentBrowser?: {\n      storageState?: string;\n    };\n  };\n  activeBrowserModel?: {\n    modelName?: string;\n    source: 'settings' | 'chat-model' | 'codex-oauth' | 'stagehand-default';\n    viaCodexOAuth: boolean;\n  };\n}\n\nexport const stateSchema = z\n  .object({\n    // Session-scoped selection. The controller validates state against this\n    // schema, so these keys must be declared here — Zod strips unknown keys.\n    currentModelId: z.string().optional(),\n    modeId: z.string().optional(),\n    modelRoute: z\n      .object({\n        entries: z\n          .array(\n            z.object({\n              id: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH),\n              label: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH),\n              modelId: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH),\n              accountId: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH).optional(),\n              memoryModelId: z.string().max(MODEL_ROUTE_MAX_FIELD_LENGTH).optional(),\n            }),\n          )\n          .max(MODEL_ROUTE_MAX_ENTRIES),\n      })\n      .optional(),\n    subagentModelId: z.string().optional(),\n    // Per-agentType subagent selections, written by session.subagents.model.set\n    // (key shape: subagentModelId_<agentType>). Declared so state validation\n    // keeps them — Zod strips unknown keys.\n    subagentModelId_explore: z.string().optional(),\n    subagentModelId_plan: z.string().optional(),\n    subagentModelId_execute: z.string().optional(),\n    projectPath: z.string().optional(),\n    projectName: z.string().optional(),\n    factoryProjectId: z.string().optional(),\n    factoryOrgId: z.string().optional(),\n    factoryOrgUnresolved: z.boolean().optional(),\n    projectRepositoryId: z.string().optional(),\n    branch: z.string().optional(),\n    // Session operates on an untrusted checkout — suppress AGENTS.md ingestion.\n    untrustedCheckout: z.boolean().optional(),\n    // Trusted ref to serve instruction files from on untrusted checkouts.\n    baseRef: z.string().optional(),\n    // Skip the operator machine's home-directory instruction files.\n    skipGlobalInstructions: z.boolean().optional(),\n    configDir: z.string().default(DEFAULT_CONFIG_DIR),\n    homeDir: z.string().optional(),\n    gitBranch: z.string().optional(),\n    lastCommand: z.string().optional(),\n    // Observational Memory model settings. Concrete IDs are legacy/explicit\n    // compatibility fields; fresh sessions preserve auto selection intent.\n    observerModelId: z.string().optional(),\n    reflectorModelId: z.string().optional(),\n    observerModelSelection: z.string().optional(),\n    reflectorModelSelection: z.string().optional(),\n    // Observational Memory threshold settings\n    observationThreshold: z.number().default(30_000),\n    reflectionThreshold: z.number().default(40_000),\n    // Whether observations and reflections use the terse caveman-style instruction.\n    // Off by default — caveman style is opt-in via `/om` settings; observers and\n    // reflectors fall back to their built-in (prose) behavior unless enabled.\n    cavemanObservations: z.boolean().default(false),\n    // Whether OM forwards image/file attachment parts to the Observer LLM.\n    // 'auto' (default) checks the provider capabilities registry to decide.\n    // true/false forces the setting regardless of model capabilities.\n    observeAttachments: z.union([z.literal('auto'), z.boolean()]).default('auto'),\n    // Observational Memory scope — 'thread' (per-conversation) or 'resource' (shared across threads)\n    omScope: z.enum(['thread', 'resource']).optional(),\n    // Thinking level for model reasoning effort. Optional: absent means \"no\n    // session override\" — the effective level is resolved from settings\n    // (per-mode defaults, then the global preference) at request time.\n    thinkingLevel: z.preprocess(\n      value => (value === null ? undefined : value),\n      z.enum(THINKING_LEVEL_VALUES).optional(),\n    ),\n    // YOLO mode — auto-approve all tool calls\n    yolo: z.boolean().default(false),\n    // Permission rules — per-category and per-tool approval policies\n    permissionRules: z\n      .object({\n        categories: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n        tools: z.record(z.string(), z.enum(['allow', 'ask', 'deny'])).default({}),\n      })\n      .default({ categories: {}, tools: {} }),\n    // Smart editing mode — use AST-based analysis for code edits\n    smartEditing: z.boolean().default(true),\n    // Notification mode — alert when TUI needs user attention\n    notifications: z.enum(['bell', 'system', 'both', 'off']).default('off'),\n    // Task list (ephemeral per-thread, cleared on thread switch/creation)\n    tasks: z\n      .array(\n        z.object({\n          id: z.string().optional(),\n          content: z.string(),\n          status: z.enum(['pending', 'in_progress', 'completed']),\n          activeForm: z.string(),\n        }),\n      )\n      .default([]),\n    // Sandbox allowed paths (per-thread, absolute paths allowed in addition to project root)\n    sandboxAllowedPaths: z.array(z.string()).default([]),\n    // Pending route hop written by account rotation. The host consumes it on\n    // `state_changed` to apply thread stickiness, then clears it back to null.\n    mastracodePendingModelFallback: z\n      .object({\n        fromEntryId: z.string(),\n        toEntryId: z.string(),\n        toModelId: z.string(),\n        threadId: z.string().optional(),\n        reason: z.enum(['pool-exhausted', 'persistent-outage']),\n        at: z.string(),\n      })\n      .nullish(),\n    // Asset directories contributed by active plugins.\n    pluginSkillPaths: z.array(z.string()).default([]),\n    pluginCommandPaths: z.array(z.string()).default([]),\n    pluginInstructions: z.array(z.string()).default([]),\n    // Active plan (set when a plan is approved in Plan mode)\n    activePlan: z\n      .object({\n        title: z.string(),\n        plan: z.string(),\n        approvedAt: z.string(),\n      })\n      .nullable()\n      .default(null),\n    // Active browser settings (tracks what's actually running vs. what's in the settings file)\n    activeBrowserSettings: z\n      .object({\n        enabled: z.boolean(),\n        provider: z.enum(['stagehand', 'agent-browser']),\n        headless: z.boolean().optional(),\n        viewport: z\n          .union([\n            z.object({\n              width: z.number(),\n              height: z.number(),\n            }),\n            z.literal('window'),\n          ])\n          .optional(),\n        cdpUrl: z.string().optional(),\n        profile: z.string().optional(),\n        executablePath: z.string().optional(),\n        scope: z.enum(['shared', 'thread']).optional(),\n        stagehand: z\n          .object({\n            env: z.enum(['LOCAL', 'BROWSERBASE']),\n            projectId: z.string().optional(),\n            model: z.string().optional(),\n            preserveUserDataDir: z.boolean().optional(),\n          })\n          .optional(),\n        agentBrowser: z\n          .object({\n            storageState: z.string().optional(),\n          })\n          .optional(),\n      })\n      .optional(),\n    // Model the active Stagehand browser was created with. Resolved once at\n    // launch so /browser status reports what is really running even if the\n    // user signs in/out of Codex afterwards.\n    activeBrowserModel: z\n      .object({\n        modelName: z.string().optional(),\n        source: z.enum(['settings', 'chat-model', 'codex-oauth', 'stagehand-default']),\n        viaCodexOAuth: z.boolean(),\n      })\n      .optional(),\n  })\n  .transform(state => ({\n    ...state,\n    observerModelSelection: state.observerModelSelection ?? state.observerModelId ?? 'auto',\n    reflectorModelSelection: state.reflectorModelSelection ?? state.reflectorModelId ?? 'auto',\n  }));\n"],"mappings":";;;;AAkJA,MAAa,cAAc,EACxB,OAAO;CAGN,gBAAgB,EAAE,OAAO,CAAC,CAAC,SAAS;CACpC,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;CAC5B,YAAY,EACT,OAAO,EACN,SAAS,EACN,MACC,EAAE,OAAO;EACP,IAAI,EAAE,OAAO,CAAC,CAAC,IAAA,GAAgC;EAC/C,OAAO,EAAE,OAAO,CAAC,CAAC,IAAA,GAAgC;EAClD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAA,GAAgC;EACpD,WAAW,EAAE,OAAO,CAAC,CAAC,IAAA,GAAgC,CAAC,CAAC,SAAS;EACjE,eAAe,EAAE,OAAO,CAAC,CAAC,IAAA,GAAgC,CAAC,CAAC,SAAS;CACvE,CAAC,CACH,CAAC,CACA,IAAA,EAA2B,EAChC,CAAC,CAAC,CACD,SAAS;CACZ,iBAAiB,EAAE,OAAO,CAAC,CAAC,SAAS;CAIrC,yBAAyB,EAAE,OAAO,CAAC,CAAC,SAAS;CAC7C,sBAAsB,EAAE,OAAO,CAAC,CAAC,SAAS;CAC1C,yBAAyB,EAAE,OAAO,CAAC,CAAC,SAAS;CAC7C,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,kBAAkB,EAAE,OAAO,CAAC,CAAC,SAAS;CACtC,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS;CAClC,sBAAsB,EAAE,QAAQ,CAAC,CAAC,SAAS;CAC3C,qBAAqB,EAAE,OAAO,CAAC,CAAC,SAAS;CACzC,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;CAE5B,mBAAmB,EAAE,QAAQ,CAAC,CAAC,SAAS;CAExC,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;CAE7B,wBAAwB,EAAE,QAAQ,CAAC,CAAC,SAAS;CAC7C,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,kBAAkB;CAChD,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;CAC7B,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CAGjC,iBAAiB,EAAE,OAAO,CAAC,CAAC,SAAS;CACrC,kBAAkB,EAAE,OAAO,CAAC,CAAC,SAAS;CACtC,wBAAwB,EAAE,OAAO,CAAC,CAAC,SAAS;CAC5C,yBAAyB,EAAE,OAAO,CAAC,CAAC,SAAS;CAE7C,sBAAsB,EAAE,OAAO,CAAC,CAAC,QAAQ,GAAM;CAC/C,qBAAqB,EAAE,OAAO,CAAC,CAAC,QAAQ,GAAM;CAI9C,qBAAqB,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK;CAI9C,oBAAoB,EAAE,MAAM,CAAC,EAAE,QAAQ,MAAM,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,MAAM;CAE5E,SAAS,EAAE,KAAK,CAAC,UAAU,UAAU,CAAC,CAAC,CAAC,SAAS;CAIjD,eAAe,EAAE,YACf,UAAU,UAAU,OAAO,KAAA,IAAY,OACvC,EAAE,KAAK,qBAAqB,CAAC,CAAC,SAAS,CACzC;CAEA,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK;CAE/B,iBAAiB,EACd,OAAO;EACN,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,KAAK;GAAC;GAAS;GAAO;EAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;EAC7E,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,KAAK;GAAC;GAAS;GAAO;EAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC1E,CAAC,CAAC,CACD,QAAQ;EAAE,YAAY,CAAC;EAAG,OAAO,CAAC;CAAE,CAAC;CAExC,cAAc,EAAE,QAAQ,CAAC,CAAC,QAAQ,IAAI;CAEtC,eAAe,EAAE,KAAK;EAAC;EAAQ;EAAU;EAAQ;CAAK,CAAC,CAAC,CAAC,QAAQ,KAAK;CAEtE,OAAO,EACJ,MACC,EAAE,OAAO;EACP,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS;EACxB,SAAS,EAAE,OAAO;EAClB,QAAQ,EAAE,KAAK;GAAC;GAAW;GAAe;EAAW,CAAC;EACtD,YAAY,EAAE,OAAO;CACvB,CAAC,CACH,CAAC,CACA,QAAQ,CAAC,CAAC;CAEb,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAGnD,gCAAgC,EAC7B,OAAO;EACN,aAAa,EAAE,OAAO;EACtB,WAAW,EAAE,OAAO;EACpB,WAAW,EAAE,OAAO;EACpB,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;EAC9B,QAAQ,EAAE,KAAK,CAAC,kBAAkB,mBAAmB,CAAC;EACtD,IAAI,EAAE,OAAO;CACf,CAAC,CAAC,CACD,QAAQ;CAEX,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAChD,oBAAoB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAClD,oBAAoB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAElD,YAAY,EACT,OAAO;EACN,OAAO,EAAE,OAAO;EAChB,MAAM,EAAE,OAAO;EACf,YAAY,EAAE,OAAO;CACvB,CAAC,CAAC,CACD,SAAS,CAAC,CACV,QAAQ,IAAI;CAEf,uBAAuB,EACpB,OAAO;EACN,SAAS,EAAE,QAAQ;EACnB,UAAU,EAAE,KAAK,CAAC,aAAa,eAAe,CAAC;EAC/C,UAAU,EAAE,QAAQ,CAAC,CAAC,SAAS;EAC/B,UAAU,EACP,MAAM,CACL,EAAE,OAAO;GACP,OAAO,EAAE,OAAO;GAChB,QAAQ,EAAE,OAAO;EACnB,CAAC,GACD,EAAE,QAAQ,QAAQ,CACpB,CAAC,CAAC,CACD,SAAS;EACZ,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;EAC5B,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;EAC7B,gBAAgB,EAAE,OAAO,CAAC,CAAC,SAAS;EACpC,OAAO,EAAE,KAAK,CAAC,UAAU,QAAQ,CAAC,CAAC,CAAC,SAAS;EAC7C,WAAW,EACR,OAAO;GACN,KAAK,EAAE,KAAK,CAAC,SAAS,aAAa,CAAC;GACpC,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;GAC/B,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;GAC3B,qBAAqB,EAAE,QAAQ,CAAC,CAAC,SAAS;EAC5C,CAAC,CAAC,CACD,SAAS;EACZ,cAAc,EACX,OAAO,EACN,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS,EACpC,CAAC,CAAC,CACD,SAAS;CACd,CAAC,CAAC,CACD,SAAS;CAIZ,oBAAoB,EACjB,OAAO;EACN,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;EAC/B,QAAQ,EAAE,KAAK;GAAC;GAAY;GAAc;GAAe;EAAmB,CAAC;EAC7E,eAAe,EAAE,QAAQ;CAC3B,CAAC,CAAC,CACD,SAAS;AACd,CAAC,CAAC,CACD,WAAU,WAAU;CACnB,GAAG;CACH,wBAAwB,MAAM,0BAA0B,MAAM,mBAAmB;CACjF,yBAAyB,MAAM,2BAA2B,MAAM,oBAAoB;AACtF,EAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/code-sdk",
-  "version": "1.12.0-alpha.8",
+  "version": "1.12.0",
   "description": "Mastra Code SDK: the agent core behind Mastra Code (everything except the TUI) — build your own UIs and surfaces on top of it",
   "type": "module",
   "publishConfig": {
@@ -63,19 +63,19 @@
     "yaml": "^2.7.1",
     "zod": "^4.6.4",
     "@mastra/agent-browser": "0.5.3",
-    "@mastra/core": "1.76.0-alpha.8",
-    "@mastra/duckdb": "1.14.0-alpha.0",
-    "@mastra/mcp": "2.3.0-alpha.1",
-    "@mastra/github-signals": "0.5.1",
-    "@mastra/memory": "1.37.0-alpha.2",
-    "@mastra/observability": "1.19.0-alpha.4",
-    "@mastra/libsql": "1.26.0-alpha.3",
+    "@mastra/core": "1.76.0",
     "@mastra/fastembed": "1.3.2",
-    "@mastra/pg": "1.31.0-alpha.4",
+    "@mastra/github-signals": "0.5.1",
+    "@mastra/libsql": "1.26.0",
+    "@mastra/mcp": "2.3.0",
+    "@mastra/observability": "1.19.0",
+    "@mastra/memory": "1.37.0",
     "@mastra/parallel": "0.1.2",
     "@mastra/stagehand": "0.3.5",
+    "@mastra/duckdb": "1.14.0",
     "@mastra/schema-compat": "1.3.13",
-    "@mastra/tavily": "1.1.2"
+    "@mastra/tavily": "1.1.2",
+    "@mastra/pg": "1.31.0"
   },
   "devDependencies": {
     "@libsql/client": "^0.18.0",
@@ -86,9 +86,9 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.57.0",
     "vitest": "4.1.11",
-    "@internal/types-builder": "0.0.116",
-    "@internal/workspace-test-utils": "0.0.85",
-    "@internal/lint": "0.0.141"
+    "@internal/lint": "0.0.142",
+    "@internal/types-builder": "0.0.117",
+    "@internal/workspace-test-utils": "0.0.86"
   },
   "engines": {
     "node": ">=22.19.0"