@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

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

@@ -0,0 +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 { 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

@@ -0,0 +1,174 @@
+/**
+ * Shared types for the headless / programmatic MastraCode API.
+ *
+ * These types are consumed by the core runner (`runMC`), the resolution policy,
+ * the output formatters, and the CLI adapter. They are intentionally free of any
+ * `process.*` access so the core API is usable from CI / Node code.
+ */
+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"];
+export declare const VALID_THINKING_LEVELS: readonly ["off", "low", "medium", "high", "xhigh", "max"];
+/**
+ * Named permission modes for non-interactive runs. Maps to a built-in
+ * {@link ResolutionPolicy}:
+ *  - `auto`   — approve every tool and auto-resolve suspensions (the default).
+ *  - `deny`   — refuse every tool approval and abort on any suspension.
+ */
+export type PermissionMode = 'auto' | 'deny';
+export declare const VALID_PERMISSION_MODES: readonly ["auto", "deny"];
+/** How `runMC` should resume `tool_approval_required` and `tool_suspended` events. */
+export interface ResolutionPolicy {
+    /**
+     * Called for every `tool_approval_required` event. Return the decision; the
+     * runner forwards it to `session.respondToToolApproval`.
+     */
+    onToolApproval(event: Extract<AgentControllerEvent, {
+        type: 'tool_approval_required';
+    }>): 'approve' | 'deny';
+    /**
+     * Called for every `tool_suspended` event. Return `resumeData` to resume the
+     * tool, or `{ abort: true }` to abort the run.
+     */
+    onSuspension(event: Extract<AgentControllerEvent, {
+        type: 'tool_suspended';
+    }>): {
+        resumeData: unknown;
+    } | {
+        abort: true;
+    };
+}
+/** Thread selection / mutation options resolved up front by `runMC`. */
+export interface RunMCThreadOptions {
+    /** Resume a specific thread by its exact id. */
+    id?: string;
+    /** Resume the most recently updated thread instead of creating a new one. */
+    continueLatest?: boolean;
+    /** Clone the resolved (or current) thread before running — work on a copy. */
+    clone?: boolean;
+}
+interface RunMCBaseOptions<TState extends Record<string, unknown> = Record<string, unknown>> {
+    /** Controller built via `createMastraCode(...)`. */
+    controller: AgentController<TState>;
+    /** Session built via `createMastraCode(...)`. */
+    session: Session<TState>;
+    /** 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. */
+    thread?: RunMCThreadOptions;
+    /** Resource id for thread scoping. */
+    resourceId?: string;
+    /** Set or rename the thread title before running. */
+    title?: string;
+    /** Abort with `status: 'timeout'` (exit code 2) after this many ms without an event. */
+    timeoutMs?: number;
+    /**
+     * Maximum number of agentic turns (assistant responses). When the limit is
+     * reached the run aborts with `status: 'max_turns'` (exit code 1). No limit
+     * by default.
+     */
+    maxTurns?: number;
+    /** How approvals / suspensions are resolved. Defaults to {@link autoApprovePolicy}. */
+    policy?: ResolutionPolicy;
+    /** External abort signal; aborting it aborts the run. */
+    signal?: AbortSignal;
+}
+export interface RunMCGoalOptions {
+    objective: string;
+    judgeModelId: string;
+    maxRuns: number;
+    goalManager?: GoalManager;
+}
+export type RunMCOptions<TState extends Record<string, unknown> = Record<string, unknown>> = RunMCBaseOptions<TState> & ({
+    /** The task to run as a regular headless turn. */
+    prompt: string;
+    goal?: never;
+} | {
+    prompt?: never;
+    /** Run a persisted goal instead of a regular prompt. */
+    goal: RunMCGoalOptions;
+});
+export type RunMCStatus = 'completed' | 'done' | 'paused' | 'error' | 'aborted' | 'timeout' | 'max_turns';
+export interface RunMCUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+export interface RunMCToolCall {
+    id: string;
+    name: string;
+    args: unknown;
+}
+export interface RunMCToolResult {
+    id: string;
+    name: string;
+    result: unknown;
+    isError: boolean;
+}
+export interface RunMCError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export interface RunMCResult {
+    status: RunMCStatus;
+    /** Aggregated assistant text across all message_end events. */
+    text: string;
+    /** Goal objective when this was a goal run. */
+    objective?: string;
+    /** Terminal goal evaluation when this was a goal run. */
+    goalEvent?: Extract<AgentControllerEvent, {
+        type: 'goal_evaluation';
+    }>;
+    reason?: string;
+    iterations?: number;
+    maxRuns?: number;
+    /** Underlying finish reason from `agent_end`, when the run finished normally. */
+    finishReason?: string;
+    usage?: RunMCUsage;
+    toolCalls: RunMCToolCall[];
+    toolResults: RunMCToolResult[];
+    threadId?: string;
+    error?: RunMCError;
+    /** 0 success, 1 error/aborted/max_turns, 2 timeout. */
+    exitCode: number;
+}
+/**
+ * A handle to an in-flight `runMC` run. It is async-iterable over controller
+ * events and also resolves to a final {@link RunMCResult} via `result`.
+ *
+ * Both `for await (const e of run)` and `await run.result` work on the same run;
+ * awaiting `result` without iterating still drains events internally.
+ */
+export interface MCRun extends AsyncIterable<AgentControllerEvent> {
+    /** Resolves once the run completes, times out, errors, or is aborted. */
+    result: Promise<RunMCResult>;
+    /** Abort the in-flight run. */
+    abort(): void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/headless/types.js

@@ -0,0 +1,19 @@
+//#region src/headless/types.ts
+const VALID_MODES = [
+	"build",
+	"plan",
+	"fast"
+];
+const VALID_THINKING_LEVELS = [
+	"off",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+const VALID_PERMISSION_MODES = ["auto", "deny"];
+//#endregion
+export { VALID_MODES, VALID_PERMISSION_MODES, VALID_THINKING_LEVELS };
+
+//# sourceMappingURL=types.js.map

package/dist/headless/types.js.map

@@ -0,0 +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';\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/hooks/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hook configuration loading from filesystem.
+ * Loads from global (~/.mastracode/hooks.json) and project (.mastracode/hooks.json).
+ * Global hooks run first, project hooks append.
+ */
+import type { HooksConfig, HookEventName } from './types.js';
+export declare const VALID_EVENTS: HookEventName[];
+export declare function loadHooksConfig(projectDir: string, configDirName?: string, homeDir?: string): HooksConfig;
+export declare function getProjectHooksPath(projectDir: string, configDirName?: string): string;
+export declare function getGlobalHooksPath(configDirName?: string, homeDir?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/hooks/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E,eAAO,MAAM,YAAY,EAAE,aAAa,EAevC,CAAC;AAEF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAUrH;AAUD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,SAAqB,GAAG,MAAM,CAElG;AAED,wBAAgB,kBAAkB,CAAC,aAAa,SAAqB,EAAE,OAAO,SAAe,GAAG,MAAM,CAErG"}

package/dist/hooks/config.js

@@ -0,0 +1,80 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import * as path$1 from "path";
+import * as fs$1 from "fs";
+import * as os$1 from "os";
+//#region src/hooks/config.ts
+/**
+* Hook configuration loading from filesystem.
+* Loads from global (~/.mastracode/hooks.json) and project (.mastracode/hooks.json).
+* Global hooks run first, project hooks append.
+*/
+const VALID_EVENTS = [
+	"PreToolUse",
+	"PostToolUse",
+	"Stop",
+	"UserPromptSubmit",
+	"SessionStart",
+	"SessionEnd",
+	"Notification",
+	"AgentStart",
+	"AgentEnd",
+	"PermissionRequest",
+	"PermissionResult",
+	"Interrupt",
+	"SubagentStart",
+	"SubagentEnd"
+];
+function loadHooksConfig(projectDir, configDirName = DEFAULT_CONFIG_DIR, homeDir) {
+	const globalPath = getGlobalHooksPath(configDirName, homeDir);
+	const projectPath = getProjectHooksPath(projectDir, configDirName);
+	return mergeConfigs(loadSingleConfig(globalPath), isSameFile(globalPath, projectPath) ? {} : loadSingleConfig(projectPath));
+}
+function isSameFile(a, b) {
+	try {
+		return fs$1.realpathSync(a) === fs$1.realpathSync(b);
+	} catch {
+		return path$1.resolve(a) === path$1.resolve(b);
+	}
+}
+function getProjectHooksPath(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
+	return path$1.join(projectDir, configDirName, "hooks.json");
+}
+function getGlobalHooksPath(configDirName = DEFAULT_CONFIG_DIR, homeDir = os$1.homedir()) {
+	return path$1.join(homeDir, configDirName, "hooks.json");
+}
+function loadSingleConfig(filePath) {
+	try {
+		if (!fs$1.existsSync(filePath)) return {};
+		const raw = fs$1.readFileSync(filePath, "utf-8");
+		return validateConfig(JSON.parse(raw));
+	} catch {
+		return {};
+	}
+}
+function validateConfig(raw) {
+	if (!raw || typeof raw !== "object") return {};
+	const config = {};
+	const obj = raw;
+	for (const event of VALID_EVENTS) if (Array.isArray(obj[event])) {
+		const hooks = obj[event].filter(isValidHook);
+		if (hooks.length > 0) config[event] = hooks;
+	}
+	return config;
+}
+function isValidHook(raw) {
+	if (!raw || typeof raw !== "object") return false;
+	const obj = raw;
+	return obj.type === "command" && typeof obj.command === "string";
+}
+function mergeConfigs(global, project) {
+	const merged = {};
+	for (const event of VALID_EVENTS) {
+		const combined = [...global[event] ?? [], ...project[event] ?? []];
+		if (combined.length > 0) merged[event] = combined;
+	}
+	return merged;
+}
+//#endregion
+export { VALID_EVENTS, getGlobalHooksPath, getProjectHooksPath, loadHooksConfig };
+
+//# sourceMappingURL=config.js.map

package/dist/hooks/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":["fs","path","os"],"sources":["../../src/hooks/config.ts"],"sourcesContent":["/**\n * Hook configuration loading from filesystem.\n * Loads from global (~/.mastracode/hooks.json) and project (.mastracode/hooks.json).\n * Global hooks run first, project hooks append.\n */\n\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport type { HooksConfig, HookDefinition, HookEventName } from './types.js';\n\nexport const VALID_EVENTS: HookEventName[] = [\n  'PreToolUse',\n  'PostToolUse',\n  'Stop',\n  'UserPromptSubmit',\n  'SessionStart',\n  'SessionEnd',\n  'Notification',\n  'AgentStart',\n  'AgentEnd',\n  'PermissionRequest',\n  'PermissionResult',\n  'Interrupt',\n  'SubagentStart',\n  'SubagentEnd',\n];\n\nexport function loadHooksConfig(projectDir: string, configDirName = DEFAULT_CONFIG_DIR, homeDir?: string): HooksConfig {\n  const globalPath = getGlobalHooksPath(configDirName, homeDir);\n  const projectPath = getProjectHooksPath(projectDir, configDirName);\n\n  const globalConfig = loadSingleConfig(globalPath);\n  // A session started in the home directory resolves both paths to the same\n  // file; loading it twice would register (and run) every hook twice.\n  const projectConfig = isSameFile(globalPath, projectPath) ? {} : loadSingleConfig(projectPath);\n\n  return mergeConfigs(globalConfig, projectConfig);\n}\n\nfunction isSameFile(a: string, b: string): boolean {\n  try {\n    return fs.realpathSync(a) === fs.realpathSync(b);\n  } catch {\n    return path.resolve(a) === path.resolve(b);\n  }\n}\n\nexport function getProjectHooksPath(projectDir: string, configDirName = DEFAULT_CONFIG_DIR): string {\n  return path.join(projectDir, configDirName, 'hooks.json');\n}\n\nexport function getGlobalHooksPath(configDirName = DEFAULT_CONFIG_DIR, homeDir = os.homedir()): string {\n  return path.join(homeDir, configDirName, 'hooks.json');\n}\n\nfunction loadSingleConfig(filePath: string): HooksConfig {\n  try {\n    if (!fs.existsSync(filePath)) return {};\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    return validateConfig(JSON.parse(raw));\n  } catch {\n    return {};\n  }\n}\n\nfunction validateConfig(raw: unknown): HooksConfig {\n  if (!raw || typeof raw !== 'object') return {};\n\n  const config: HooksConfig = {};\n  const obj = raw as Record<string, unknown>;\n\n  for (const event of VALID_EVENTS) {\n    if (Array.isArray(obj[event])) {\n      const hooks = (obj[event] as unknown[]).filter(isValidHook);\n      if (hooks.length > 0) {\n        config[event] = hooks;\n      }\n    }\n  }\n\n  return config;\n}\n\nfunction isValidHook(raw: unknown): raw is HookDefinition {\n  if (!raw || typeof raw !== 'object') return false;\n  const obj = raw as Record<string, unknown>;\n  return obj.type === 'command' && typeof obj.command === 'string';\n}\n\nfunction mergeConfigs(global: HooksConfig, project: HooksConfig): HooksConfig {\n  const merged: HooksConfig = {};\n\n  for (const event of VALID_EVENTS) {\n    const combined = [...(global[event] ?? []), ...(project[event] ?? [])];\n    if (combined.length > 0) {\n      merged[event] = combined;\n    }\n  }\n\n  return merged;\n}\n"],"mappings":";;;;;;;;;;AAYA,MAAa,eAAgC;CAC3C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,SAAgB,gBAAgB,YAAoB,gBAAgB,oBAAoB,SAA+B;CACrH,MAAM,aAAa,mBAAmB,eAAe,OAAO;CAC5D,MAAM,cAAc,oBAAoB,YAAY,aAAa;CAOjE,OAAO,aALc,iBAAiB,UAKP,GAFT,WAAW,YAAY,WAAW,IAAI,CAAC,IAAI,iBAAiB,WAAW,CAE9C;AACjD;AAEA,SAAS,WAAW,GAAW,GAAoB;CACjD,IAAI;EACF,OAAOA,KAAG,aAAa,CAAC,MAAMA,KAAG,aAAa,CAAC;CACjD,QAAQ;EACN,OAAOC,OAAK,QAAQ,CAAC,MAAMA,OAAK,QAAQ,CAAC;CAC3C;AACF;AAEA,SAAgB,oBAAoB,YAAoB,gBAAgB,oBAA4B;CAClG,OAAOA,OAAK,KAAK,YAAY,eAAe,YAAY;AAC1D;AAEA,SAAgB,mBAAmB,gBAAgB,oBAAoB,UAAUC,KAAG,QAAQ,GAAW;CACrG,OAAOD,OAAK,KAAK,SAAS,eAAe,YAAY;AACvD;AAEA,SAAS,iBAAiB,UAA+B;CACvD,IAAI;EACF,IAAI,CAACD,KAAG,WAAW,QAAQ,GAAG,OAAO,CAAC;EACtC,MAAM,MAAMA,KAAG,aAAa,UAAU,OAAO;EAC7C,OAAO,eAAe,KAAK,MAAM,GAAG,CAAC;CACvC,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,eAAe,KAA2B;CACjD,IAAI,CAAC,OAAO,OAAO,QAAQ,UAAU,OAAO,CAAC;CAE7C,MAAM,SAAsB,CAAC;CAC7B,MAAM,MAAM;CAEZ,KAAK,MAAM,SAAS,cAClB,IAAI,MAAM,QAAQ,IAAI,MAAM,GAAG;EAC7B,MAAM,QAAS,IAAI,MAAM,CAAe,OAAO,WAAW;EAC1D,IAAI,MAAM,SAAS,GACjB,OAAO,SAAS;CAEpB;CAGF,OAAO;AACT;AAEA,SAAS,YAAY,KAAqC;CACxD,IAAI,CAAC,OAAO,OAAO,QAAQ,UAAU,OAAO;CAC5C,MAAM,MAAM;CACZ,OAAO,IAAI,SAAS,aAAa,OAAO,IAAI,YAAY;AAC1D;AAEA,SAAS,aAAa,QAAqB,SAAmC;CAC5E,MAAM,SAAsB,CAAC;CAE7B,KAAK,MAAM,SAAS,cAAc;EAChC,MAAM,WAAW,CAAC,GAAI,OAAO,UAAU,CAAC,GAAI,GAAI,QAAQ,UAAU,CAAC,CAAE;EACrE,IAAI,SAAS,SAAS,GACpB,OAAO,SAAS;CAEpB;CAEA,OAAO;AACT"}

package/dist/hooks/executor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Hook process execution.
+ * Spawns shell commands, handles stdin/stdout/exit-code protocol.
+ */
+import type { HookDefinition, HookStdin, HookResult, HookEventResult } from './types.js';
+export declare function executeHook(hook: HookDefinition, stdinPayload: HookStdin): Promise<HookResult>;
+export declare function matchesHook(hook: HookDefinition, context: {
+    tool_name?: string;
+}): boolean;
+export declare function runHooksForEvent(hooks: HookDefinition[], stdinPayload: HookStdin, matchContext?: {
+    tool_name?: string;
+}): Promise<HookEventResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/hooks/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAc,eAAe,EAAE,MAAM,YAAY,CAAC;AAKrG,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA8FpG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAa1F;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,SAAS,EACvB,YAAY,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACxC,OAAO,CAAC,eAAe,CAAC,CA8C1B"}

package/dist/hooks/executor.js

@@ -0,0 +1,129 @@
+import { isBlockingEvent } from "./types.js";
+import { spawn } from "child_process";
+//#region src/hooks/executor.ts
+/**
+* Hook process execution.
+* Spawns shell commands, handles stdin/stdout/exit-code protocol.
+*/
+const DEFAULT_TIMEOUT = 1e4;
+async function executeHook(hook, stdinPayload) {
+	const timeout = hook.timeout ?? DEFAULT_TIMEOUT;
+	const startTime = Date.now();
+	return new Promise((resolve) => {
+		const isWindows = process.platform === "win32";
+		const child = spawn(isWindows ? "cmd" : "/bin/sh", isWindows ? ["/c", hook.command] : ["-c", hook.command], {
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			cwd: stdinPayload.cwd,
+			...isWindows ? { windowsVerbatimArguments: true } : {},
+			env: {
+				...process.env,
+				MASTRA_HOOK_EVENT: stdinPayload.hook_event_name
+			}
+		});
+		let stdout = "";
+		let stderr = "";
+		let timedOut = false;
+		let resolved = false;
+		const timer = setTimeout(() => {
+			timedOut = true;
+			child.kill("SIGKILL");
+		}, timeout);
+		child.stdout?.on("data", (data) => {
+			stdout += data.toString();
+		});
+		child.stderr?.on("data", (data) => {
+			stderr += data.toString();
+		});
+		child.on("close", (exitCode) => {
+			clearTimeout(timer);
+			if (resolved) return;
+			resolved = true;
+			let parsedStdout;
+			if (stdout.trim()) try {
+				parsedStdout = JSON.parse(stdout.trim());
+			} catch {}
+			resolve({
+				hook,
+				exitCode: exitCode ?? 1,
+				stdout: parsedStdout,
+				stderr: stderr.trim() || void 0,
+				timedOut,
+				durationMs: Date.now() - startTime
+			});
+		});
+		child.on("error", (error) => {
+			clearTimeout(timer);
+			if (resolved) return;
+			resolved = true;
+			resolve({
+				hook,
+				exitCode: 1,
+				stderr: error.message,
+				timedOut: false,
+				durationMs: Date.now() - startTime
+			});
+		});
+		child.stdin?.on("error", () => {});
+		try {
+			child.stdin?.write(JSON.stringify(stdinPayload));
+			child.stdin?.end();
+		} catch {}
+	});
+}
+function matchesHook(hook, context) {
+	if (!hook.matcher) return true;
+	if (hook.matcher.tool_name) {
+		if (!context.tool_name) return false;
+		try {
+			return new RegExp(hook.matcher.tool_name).test(context.tool_name);
+		} catch {
+			return false;
+		}
+	}
+	return true;
+}
+async function runHooksForEvent(hooks, stdinPayload, matchContext = {}) {
+	const results = [];
+	const warnings = [];
+	let additionalContext;
+	const applicable = hooks.filter((h) => matchesHook(h, matchContext));
+	if (applicable.length === 0) return {
+		allowed: true,
+		results: [],
+		warnings: []
+	};
+	const blocking = isBlockingEvent(stdinPayload.hook_event_name);
+	for (const hook of applicable) {
+		const result = await executeHook(hook, stdinPayload);
+		results.push(result);
+		if (result.stdout?.additionalContext) additionalContext = additionalContext ? `${additionalContext}\n${result.stdout.additionalContext}` : result.stdout.additionalContext;
+		if (result.timedOut) {
+			warnings.push(`Hook timed out after ${hook.timeout ?? DEFAULT_TIMEOUT}ms: ${hook.command}`);
+			continue;
+		}
+		if (result.exitCode === 2 && blocking) return {
+			allowed: false,
+			blockReason: result.stdout?.reason || result.stderr || `Blocked by hook: ${hook.description || hook.command}`,
+			additionalContext,
+			results,
+			warnings
+		};
+		if (result.exitCode === 0) continue;
+		const warnMsg = result.stderr || `Hook exited with code ${result.exitCode}`;
+		warnings.push(`${hook.description || hook.command}: ${warnMsg}`);
+	}
+	return {
+		allowed: true,
+		additionalContext,
+		results,
+		warnings
+	};
+}
+//#endregion
+export { executeHook, matchesHook, runHooksForEvent };
+
+//# sourceMappingURL=executor.js.map

package/dist/hooks/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","names":[],"sources":["../../src/hooks/executor.ts"],"sourcesContent":["/**\n * Hook process execution.\n * Spawns shell commands, handles stdin/stdout/exit-code protocol.\n */\n\nimport { spawn } from 'node:child_process';\nimport type { HookDefinition, HookStdin, HookResult, HookStdout, HookEventResult } from './types.js';\nimport { isBlockingEvent } from './types.js';\n\nconst DEFAULT_TIMEOUT = 10_000;\n\nexport async function executeHook(hook: HookDefinition, stdinPayload: HookStdin): Promise<HookResult> {\n  const timeout = hook.timeout ?? DEFAULT_TIMEOUT;\n  const startTime = Date.now();\n\n  return new Promise<HookResult>(resolve => {\n    const isWindows = process.platform === 'win32';\n    const shell = isWindows ? 'cmd' : '/bin/sh';\n    const shellArgs = isWindows ? ['/c', hook.command] : ['-c', hook.command];\n\n    const child = spawn(shell, shellArgs, {\n      stdio: ['pipe', 'pipe', 'pipe'],\n      cwd: stdinPayload.cwd,\n      // Without this, Node's default Windows argument escaping re-quotes\n      // hook.command before cmd.exe ever sees it, so a quoted path (or any\n      // path containing spaces) reaches the child process with literal \"\n      // characters embedded in it. mastracode/tui's shell-runner.ts already\n      // sets this for its own cmd invocations; this call site just missed it.\n      ...(isWindows ? { windowsVerbatimArguments: true } : {}),\n      env: {\n        ...process.env,\n        MASTRA_HOOK_EVENT: stdinPayload.hook_event_name,\n      },\n    });\n\n    let stdout = '';\n    let stderr = '';\n    let timedOut = false;\n    let resolved = false;\n\n    const timer = setTimeout(() => {\n      timedOut = true;\n      child.kill('SIGKILL');\n    }, timeout);\n\n    child.stdout?.on('data', (data: Buffer) => {\n      stdout += data.toString();\n    });\n\n    child.stderr?.on('data', (data: Buffer) => {\n      stderr += data.toString();\n    });\n\n    child.on('close', exitCode => {\n      clearTimeout(timer);\n      if (resolved) return;\n      resolved = true;\n\n      let parsedStdout: HookStdout | undefined;\n      if (stdout.trim()) {\n        try {\n          parsedStdout = JSON.parse(stdout.trim()) as HookStdout;\n        } catch {\n          // Not valid JSON — ignore\n        }\n      }\n\n      resolve({\n        hook,\n        exitCode: exitCode ?? 1,\n        stdout: parsedStdout,\n        stderr: stderr.trim() || undefined,\n        timedOut,\n        durationMs: Date.now() - startTime,\n      });\n    });\n\n    child.on('error', error => {\n      clearTimeout(timer);\n      if (resolved) return;\n      resolved = true;\n\n      resolve({\n        hook,\n        exitCode: 1,\n        stderr: error.message,\n        timedOut: false,\n        durationMs: Date.now() - startTime,\n      });\n    });\n\n    // A hook that never reads stdin (or exits before we finish writing) closes\n    // the pipe under us. That surfaces asynchronously as an EPIPE 'error' event\n    // on the socket, which Node escalates to an unhandled error — taking the\n    // whole host process down — unless something is listening. The hook's real\n    // outcome still arrives via 'close', so absorb it.\n    child.stdin?.on('error', () => {});\n\n    try {\n      child.stdin?.write(JSON.stringify(stdinPayload));\n      child.stdin?.end();\n    } catch {\n      // Synchronous stdin write failure — process continues\n    }\n  });\n}\n\nexport function matchesHook(hook: HookDefinition, context: { tool_name?: string }): boolean {\n  if (!hook.matcher) return true;\n\n  if (hook.matcher.tool_name) {\n    if (!context.tool_name) return false;\n    try {\n      return new RegExp(hook.matcher.tool_name).test(context.tool_name);\n    } catch {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport async function runHooksForEvent(\n  hooks: HookDefinition[],\n  stdinPayload: HookStdin,\n  matchContext: { tool_name?: string } = {},\n): Promise<HookEventResult> {\n  const results: HookResult[] = [];\n  const warnings: string[] = [];\n  let additionalContext: string | undefined;\n\n  const applicable = hooks.filter(h => matchesHook(h, matchContext));\n  if (applicable.length === 0) {\n    return { allowed: true, results: [], warnings: [] };\n  }\n\n  const blocking = isBlockingEvent(stdinPayload.hook_event_name);\n\n  for (const hook of applicable) {\n    const result = await executeHook(hook, stdinPayload);\n    results.push(result);\n\n    if (result.stdout?.additionalContext) {\n      additionalContext = additionalContext\n        ? `${additionalContext}\\n${result.stdout.additionalContext}`\n        : result.stdout.additionalContext;\n    }\n\n    if (result.timedOut) {\n      warnings.push(`Hook timed out after ${hook.timeout ?? DEFAULT_TIMEOUT}ms: ${hook.command}`);\n      continue;\n    }\n\n    if (result.exitCode === 2 && blocking) {\n      const reason = result.stdout?.reason || result.stderr || `Blocked by hook: ${hook.description || hook.command}`;\n\n      return {\n        allowed: false,\n        blockReason: reason,\n        additionalContext,\n        results,\n        warnings,\n      };\n    }\n\n    if (result.exitCode === 0) continue;\n\n    const warnMsg = result.stderr || `Hook exited with code ${result.exitCode}`;\n    warnings.push(`${hook.description || hook.command}: ${warnMsg}`);\n  }\n\n  return { allowed: true, additionalContext, results, warnings };\n}\n"],"mappings":"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"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export { HookManager } from './manager.js';
+export { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath, VALID_EVENTS } from './config.js';
+export { executeHook, runHooksForEvent, matchesHook } from './executor.js';
+export { isBlockingEvent } from './types.js';
+export type { HookEventName, HookDefinition, HookMatcher, HooksConfig, HookStdin, HookStdinBase, HookStdinToolEvent, HookStdinUserPrompt, HookStdinStop, HookStdinSession, HookStdinNotification, HookStdinAgentStart, HookStdinAgentEnd, HookStdinPermissionRequest, HookStdinPermissionResult, HookStdinInterrupt, HookStdinSubagentStart, HookStdinSubagentEnd, HookStdout, HookResult, HookEventResult, BlockingHookEvent, LifecycleHookEvent, PermissionKind, PermissionDecision, InterruptReason, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,5 @@
+import { VALID_EVENTS, getGlobalHooksPath, getProjectHooksPath, loadHooksConfig } from "./config.js";
+import { isBlockingEvent } from "./types.js";
+import { executeHook, matchesHook, runHooksForEvent } from "./executor.js";
+import { HookManager } from "./manager.js";
+export { HookManager, VALID_EVENTS, executeHook, getGlobalHooksPath, getProjectHooksPath, isBlockingEvent, loadHooksConfig, matchesHook, runHooksForEvent };

package/dist/hooks/manager.d.ts

@@ -0,0 +1,54 @@
+import type { HooksConfig, HookEventResult, PermissionKind, PermissionDecision, InterruptReason, SessionWorktreeInfo } from './types.js';
+export declare class HookManager {
+    private config;
+    private projectDir;
+    private sessionId;
+    private configDirName;
+    private homeDir?;
+    private runId?;
+    private worktree?;
+    constructor(projectDir: string, sessionId: string, configDirName?: string, homeDir?: string, worktree?: SessionWorktreeInfo);
+    reload(): void;
+    setSessionId(sessionId: string): void;
+    /** Set the active agent run id. Included as `run_id` in all hook stdin while a run is active. */
+    setRunId(runId: string): void;
+    /** Clear the active run id. Call only after end-of-run hooks (AgentEnd, Stop) have been dispatched. */
+    clearRunId(): void;
+    getRunId(): string | undefined;
+    hasHooks(): boolean;
+    getConfig(): HooksConfig;
+    getConfigPaths(): {
+        project: string;
+        global: string;
+    };
+    /**
+     * Build the common stdin base fields. `run_id` is included when an active run
+     * is set, so every event dispatched during a run carries the same identifier.
+     */
+    private baseStdinFields;
+    /**
+     * Session stdin, carrying worktree identity when there is one. Emitted on both
+     * session events so a hook that provisions on start can tear down on end using
+     * the same fields.
+     */
+    private sessionStdin;
+    runPreToolUse(toolName: string, toolInput: unknown): Promise<HookEventResult>;
+    runPostToolUse(toolName: string, toolInput: unknown, toolOutput: unknown, toolError: boolean): Promise<HookEventResult>;
+    runUserPromptSubmit(userMessage: string): Promise<HookEventResult>;
+    runStop(assistantMessage: string | undefined, stopReason: 'complete' | 'aborted' | 'error'): Promise<HookEventResult>;
+    runSessionStart(): Promise<HookEventResult>;
+    runSessionEnd(): Promise<HookEventResult>;
+    /**
+     * Fire notification hooks (non-blocking, fire-and-forget).
+     * Called when the TUI is waiting for user input.
+     */
+    runNotification(reason: string, message?: string): void;
+    runAgentStart(): Promise<HookEventResult>;
+    runAgentEnd(stopReason: 'complete' | 'aborted' | 'error' | 'suspended'): Promise<HookEventResult>;
+    runPermissionRequest(permissionKind: PermissionKind, toolCallId: string, toolName: string, toolInput?: unknown): Promise<HookEventResult>;
+    runPermissionResult(permissionKind: PermissionKind, toolCallId: string, toolName: string, decision: PermissionDecision, toolInput?: unknown): Promise<HookEventResult>;
+    runInterrupt(reason: InterruptReason): Promise<HookEventResult>;
+    runSubagentStart(toolCallId: string, agentType: string, task: string, modelId?: string, forked?: boolean): Promise<HookEventResult>;
+    runSubagentEnd(toolCallId: string, agentType: string, result: unknown, isError: boolean, durationMs: number): Promise<HookEventResult>;
+}
+//# sourceMappingURL=manager.d.ts.map