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

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

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

package/dist/hooks/manager.js

@@ -0,0 +1,241 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import { getGlobalHooksPath, getProjectHooksPath, loadHooksConfig } from "./config.js";
+import { runHooksForEvent } from "./executor.js";
+//#region src/hooks/manager.ts
+/**
+* HookManager — high-level orchestration for the hooks system.
+* Created once at startup, provides methods for each lifecycle event.
+*/
+const emptyResult = () => ({
+	allowed: true,
+	results: [],
+	warnings: []
+});
+var HookManager = class {
+	config;
+	projectDir;
+	sessionId;
+	configDirName;
+	homeDir;
+	runId;
+	worktree;
+	constructor(projectDir, sessionId, configDirName = DEFAULT_CONFIG_DIR, homeDir, worktree) {
+		this.worktree = worktree;
+		this.projectDir = projectDir;
+		this.sessionId = sessionId;
+		this.configDirName = configDirName;
+		this.homeDir = homeDir;
+		this.config = loadHooksConfig(projectDir, configDirName, homeDir);
+	}
+	reload() {
+		this.config = loadHooksConfig(this.projectDir, this.configDirName, this.homeDir);
+	}
+	setSessionId(sessionId) {
+		this.sessionId = sessionId;
+	}
+	/** Set the active agent run id. Included as `run_id` in all hook stdin while a run is active. */
+	setRunId(runId) {
+		this.runId = runId;
+	}
+	/** Clear the active run id. Call only after end-of-run hooks (AgentEnd, Stop) have been dispatched. */
+	clearRunId() {
+		this.runId = void 0;
+	}
+	getRunId() {
+		return this.runId;
+	}
+	hasHooks() {
+		return Object.keys(this.config).length > 0;
+	}
+	getConfig() {
+		return this.config;
+	}
+	getConfigPaths() {
+		return {
+			project: getProjectHooksPath(this.projectDir, this.configDirName),
+			global: getGlobalHooksPath(this.configDirName, this.homeDir)
+		};
+	}
+	/**
+	* 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.
+	*/
+	baseStdinFields(hook_event_name) {
+		const base = {
+			session_id: this.sessionId,
+			cwd: this.projectDir,
+			hook_event_name
+		};
+		if (this.runId) base.run_id = this.runId;
+		return base;
+	}
+	/**
+	* 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.
+	*/
+	sessionStdin(hook_event_name) {
+		const stdin = this.baseStdinFields(hook_event_name);
+		if (this.worktree) {
+			stdin.worktree_path = this.worktree.path;
+			if (this.worktree.branch) stdin.branch = this.worktree.branch;
+			if (this.worktree.mainRepoPath) stdin.main_repo_path = this.worktree.mainRepoPath;
+		}
+		return stdin;
+	}
+	async runPreToolUse(toolName, toolInput) {
+		const hooks = this.config.PreToolUse;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("PreToolUse"),
+			tool_name: toolName,
+			tool_input: toolInput
+		}, { tool_name: toolName });
+	}
+	async runPostToolUse(toolName, toolInput, toolOutput, toolError) {
+		const hooks = this.config.PostToolUse;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("PostToolUse"),
+			tool_name: toolName,
+			tool_input: toolInput,
+			tool_output: toolOutput,
+			tool_error: toolError
+		}, { tool_name: toolName });
+	}
+	async runUserPromptSubmit(userMessage) {
+		const hooks = this.config.UserPromptSubmit;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("UserPromptSubmit"),
+			user_message: userMessage
+		});
+	}
+	async runStop(assistantMessage, stopReason) {
+		const hooks = this.config.Stop;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("Stop"),
+			assistant_message: assistantMessage,
+			stop_reason: stopReason
+		});
+	}
+	async runSessionStart() {
+		const hooks = this.config.SessionStart;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		return runHooksForEvent(hooks, this.sessionStdin("SessionStart"));
+	}
+	async runSessionEnd() {
+		const hooks = this.config.SessionEnd;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		return runHooksForEvent(hooks, this.sessionStdin("SessionEnd"));
+	}
+	/**
+	* Fire notification hooks (non-blocking, fire-and-forget).
+	* Called when the TUI is waiting for user input.
+	*/
+	runNotification(reason, message) {
+		const hooks = this.config.Notification;
+		if (!hooks || hooks.length === 0) return;
+		runHooksForEvent(hooks, {
+			...this.baseStdinFields("Notification"),
+			reason,
+			message
+		}).catch(() => {});
+	}
+	async runAgentStart() {
+		const hooks = this.config.AgentStart;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("AgentStart"),
+			run_id: runId
+		});
+	}
+	async runAgentEnd(stopReason) {
+		const hooks = this.config.AgentEnd;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("AgentEnd"),
+			run_id: runId,
+			stop_reason: stopReason
+		});
+	}
+	async runPermissionRequest(permissionKind, toolCallId, toolName, toolInput) {
+		const hooks = this.config.PermissionRequest;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("PermissionRequest"),
+			run_id: runId,
+			permission_kind: permissionKind,
+			tool_call_id: toolCallId,
+			tool_name: toolName,
+			...toolInput !== void 0 ? { tool_input: toolInput } : {}
+		});
+	}
+	async runPermissionResult(permissionKind, toolCallId, toolName, decision, toolInput) {
+		const hooks = this.config.PermissionResult;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("PermissionResult"),
+			run_id: runId,
+			permission_kind: permissionKind,
+			tool_call_id: toolCallId,
+			tool_name: toolName,
+			decision,
+			...toolInput !== void 0 ? { tool_input: toolInput } : {}
+		});
+	}
+	async runInterrupt(reason) {
+		const hooks = this.config.Interrupt;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("Interrupt"),
+			run_id: runId,
+			reason
+		});
+	}
+	async runSubagentStart(toolCallId, agentType, task, modelId, forked) {
+		const hooks = this.config.SubagentStart;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("SubagentStart"),
+			run_id: runId,
+			tool_call_id: toolCallId,
+			agent_type: agentType,
+			task,
+			...modelId !== void 0 ? { model_id: modelId } : {},
+			...forked !== void 0 ? { forked } : {}
+		});
+	}
+	async runSubagentEnd(toolCallId, agentType, result, isError, durationMs) {
+		const hooks = this.config.SubagentEnd;
+		if (!hooks || hooks.length === 0) return emptyResult();
+		const runId = this.runId;
+		if (!runId) return emptyResult();
+		return runHooksForEvent(hooks, {
+			...this.baseStdinFields("SubagentEnd"),
+			run_id: runId,
+			tool_call_id: toolCallId,
+			agent_type: agentType,
+			result,
+			is_error: isError,
+			duration_ms: durationMs
+		});
+	}
+};
+//#endregion
+export { HookManager };
+
+//# sourceMappingURL=manager.js.map

package/dist/hooks/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","names":[],"sources":["../../src/hooks/manager.ts"],"sourcesContent":["/**\n * HookManager — high-level orchestration for the hooks system.\n * Created once at startup, provides methods for each lifecycle event.\n */\nimport { DEFAULT_CONFIG_DIR } from '../constants.js';\nimport { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath } from './config.js';\nimport { runHooksForEvent } from './executor.js';\nimport type {\n  HooksConfig,\n  HookEventResult,\n  HookEventName,\n  HookStdinToolEvent,\n  HookStdinUserPrompt,\n  HookStdinStop,\n  HookStdinSession,\n  HookStdinNotification,\n  HookStdinAgentStart,\n  HookStdinAgentEnd,\n  HookStdinPermissionRequest,\n  HookStdinPermissionResult,\n  HookStdinInterrupt,\n  HookStdinSubagentStart,\n  HookStdinSubagentEnd,\n  PermissionKind,\n  PermissionDecision,\n  InterruptReason,\n  SessionWorktreeInfo,\n} from './types.js';\n\nconst emptyResult = (): HookEventResult => ({ allowed: true, results: [], warnings: [] });\n\nexport class HookManager {\n  private config: HooksConfig;\n  private projectDir: string;\n  private sessionId: string;\n  private configDirName: string;\n  private homeDir?: string;\n  private runId?: string;\n  private worktree?: SessionWorktreeInfo;\n\n  constructor(\n    projectDir: string,\n    sessionId: string,\n    configDirName = DEFAULT_CONFIG_DIR,\n    homeDir?: string,\n    worktree?: SessionWorktreeInfo,\n  ) {\n    this.worktree = worktree;\n    this.projectDir = projectDir;\n    this.sessionId = sessionId;\n    this.configDirName = configDirName;\n    this.homeDir = homeDir;\n    this.config = loadHooksConfig(projectDir, configDirName, homeDir);\n  }\n\n  reload(): void {\n    this.config = loadHooksConfig(this.projectDir, this.configDirName, this.homeDir);\n  }\n\n  setSessionId(sessionId: string): void {\n    this.sessionId = sessionId;\n  }\n\n  /** Set the active agent run id. Included as `run_id` in all hook stdin while a run is active. */\n  setRunId(runId: string): void {\n    this.runId = runId;\n  }\n\n  /** Clear the active run id. Call only after end-of-run hooks (AgentEnd, Stop) have been dispatched. */\n  clearRunId(): void {\n    this.runId = undefined;\n  }\n\n  getRunId(): string | undefined {\n    return this.runId;\n  }\n\n  hasHooks(): boolean {\n    return Object.keys(this.config).length > 0;\n  }\n\n  getConfig(): HooksConfig {\n    return this.config;\n  }\n\n  getConfigPaths(): { project: string; global: string } {\n    return {\n      project: getProjectHooksPath(this.projectDir, this.configDirName),\n      global: getGlobalHooksPath(this.configDirName, this.homeDir),\n    };\n  }\n\n  // =========================================================================\n  // Stdin Helpers\n  // =========================================================================\n\n  /**\n   * Build the common stdin base fields. `run_id` is included when an active run\n   * is set, so every event dispatched during a run carries the same identifier.\n   */\n  private baseStdinFields<T extends HookEventName>(\n    hook_event_name: T,\n  ): {\n    session_id: string;\n    cwd: string;\n    hook_event_name: T;\n    run_id?: string;\n  } {\n    const base: { session_id: string; cwd: string; hook_event_name: T; run_id?: string } = {\n      session_id: this.sessionId,\n      cwd: this.projectDir,\n      hook_event_name,\n    };\n    if (this.runId) base.run_id = this.runId;\n    return base;\n  }\n\n  /**\n   * Session stdin, carrying worktree identity when there is one. Emitted on both\n   * session events so a hook that provisions on start can tear down on end using\n   * the same fields.\n   */\n  private sessionStdin(hook_event_name: 'SessionStart' | 'SessionEnd'): HookStdinSession {\n    const stdin: HookStdinSession = this.baseStdinFields(hook_event_name);\n    if (this.worktree) {\n      stdin.worktree_path = this.worktree.path;\n      if (this.worktree.branch) stdin.branch = this.worktree.branch;\n      if (this.worktree.mainRepoPath) stdin.main_repo_path = this.worktree.mainRepoPath;\n    }\n    return stdin;\n  }\n\n  // =========================================================================\n  // Blocking Event Methods (decisions enforced by callers)\n  // =========================================================================\n\n  async runPreToolUse(toolName: string, toolInput: unknown): Promise<HookEventResult> {\n    const hooks = this.config.PreToolUse;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinToolEvent = {\n      ...this.baseStdinFields('PreToolUse'),\n      tool_name: toolName,\n      tool_input: toolInput,\n    };\n\n    return runHooksForEvent(hooks, stdin, { tool_name: toolName });\n  }\n\n  async runPostToolUse(\n    toolName: string,\n    toolInput: unknown,\n    toolOutput: unknown,\n    toolError: boolean,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PostToolUse;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinToolEvent = {\n      ...this.baseStdinFields('PostToolUse'),\n      tool_name: toolName,\n      tool_input: toolInput,\n      tool_output: toolOutput,\n      tool_error: toolError,\n    };\n\n    return runHooksForEvent(hooks, stdin, { tool_name: toolName });\n  }\n\n  async runUserPromptSubmit(userMessage: string): Promise<HookEventResult> {\n    const hooks = this.config.UserPromptSubmit;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinUserPrompt = {\n      ...this.baseStdinFields('UserPromptSubmit'),\n      user_message: userMessage,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runStop(\n    assistantMessage: string | undefined,\n    stopReason: 'complete' | 'aborted' | 'error',\n  ): Promise<HookEventResult> {\n    const hooks = this.config.Stop;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinStop = {\n      ...this.baseStdinFields('Stop'),\n      assistant_message: assistantMessage,\n      stop_reason: stopReason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSessionStart(): Promise<HookEventResult> {\n    const hooks = this.config.SessionStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSession = this.sessionStdin('SessionStart');\n\n    return runHooksForEvent(hooks, stdin);\n  }\n  async runSessionEnd(): Promise<HookEventResult> {\n    const hooks = this.config.SessionEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSession = this.sessionStdin('SessionEnd');\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  /**\n   * Fire notification hooks (non-blocking, fire-and-forget).\n   * Called when the TUI is waiting for user input.\n   */\n  runNotification(reason: string, message?: string): void {\n    const hooks = this.config.Notification;\n    if (!hooks || hooks.length === 0) return;\n\n    const stdin: HookStdinNotification = {\n      ...this.baseStdinFields('Notification'),\n      reason,\n      message,\n    };\n\n    // Fire-and-forget — don't await\n    runHooksForEvent(hooks, stdin).catch(() => {});\n  }\n\n  // =========================================================================\n  // Lifecycle Event Methods (non-blocking: observe behavior, never enforce)\n  // =========================================================================\n\n  async runAgentStart(): Promise<HookEventResult> {\n    const hooks = this.config.AgentStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinAgentStart = {\n      ...this.baseStdinFields('AgentStart'),\n      run_id: runId,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runAgentEnd(stopReason: 'complete' | 'aborted' | 'error' | 'suspended'): Promise<HookEventResult> {\n    const hooks = this.config.AgentEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinAgentEnd = {\n      ...this.baseStdinFields('AgentEnd'),\n      run_id: runId,\n      stop_reason: stopReason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runPermissionRequest(\n    permissionKind: PermissionKind,\n    toolCallId: string,\n    toolName: string,\n    toolInput?: unknown,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PermissionRequest;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinPermissionRequest = {\n      ...this.baseStdinFields('PermissionRequest'),\n      run_id: runId,\n      permission_kind: permissionKind,\n      tool_call_id: toolCallId,\n      tool_name: toolName,\n      ...(toolInput !== undefined ? { tool_input: toolInput } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runPermissionResult(\n    permissionKind: PermissionKind,\n    toolCallId: string,\n    toolName: string,\n    decision: PermissionDecision,\n    toolInput?: unknown,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.PermissionResult;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinPermissionResult = {\n      ...this.baseStdinFields('PermissionResult'),\n      run_id: runId,\n      permission_kind: permissionKind,\n      tool_call_id: toolCallId,\n      tool_name: toolName,\n      decision,\n      ...(toolInput !== undefined ? { tool_input: toolInput } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runInterrupt(reason: InterruptReason): Promise<HookEventResult> {\n    const hooks = this.config.Interrupt;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinInterrupt = {\n      ...this.baseStdinFields('Interrupt'),\n      run_id: runId,\n      reason,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSubagentStart(\n    toolCallId: string,\n    agentType: string,\n    task: string,\n    modelId?: string,\n    forked?: boolean,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.SubagentStart;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSubagentStart = {\n      ...this.baseStdinFields('SubagentStart'),\n      run_id: runId,\n      tool_call_id: toolCallId,\n      agent_type: agentType,\n      task,\n      ...(modelId !== undefined ? { model_id: modelId } : {}),\n      ...(forked !== undefined ? { forked } : {}),\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n\n  async runSubagentEnd(\n    toolCallId: string,\n    agentType: string,\n    result: unknown,\n    isError: boolean,\n    durationMs: number,\n  ): Promise<HookEventResult> {\n    const hooks = this.config.SubagentEnd;\n    if (!hooks || hooks.length === 0) {\n      return emptyResult();\n    }\n    const runId = this.runId;\n    if (!runId) {\n      return emptyResult();\n    }\n\n    const stdin: HookStdinSubagentEnd = {\n      ...this.baseStdinFields('SubagentEnd'),\n      run_id: runId,\n      tool_call_id: toolCallId,\n      agent_type: agentType,\n      result,\n      is_error: isError,\n      duration_ms: durationMs,\n    };\n\n    return runHooksForEvent(hooks, stdin);\n  }\n}\n"],"mappings":"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"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Type definitions for the hooks system.
+ * Hooks are user-configured shell commands that run at lifecycle events.
+ */
+export type HookEventName = 'PreToolUse' | 'PostToolUse' | 'Stop' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Notification' | 'AgentStart' | 'AgentEnd' | 'PermissionRequest' | 'PermissionResult' | 'Interrupt' | 'SubagentStart' | 'SubagentEnd';
+export type BlockingHookEvent = 'PreToolUse' | 'Stop' | 'UserPromptSubmit';
+/** Lifecycle hook events are non-blocking: they observe behavior without changing it. */
+export type LifecycleHookEvent = 'AgentStart' | 'AgentEnd' | 'PermissionRequest' | 'PermissionResult' | 'Interrupt' | 'SubagentStart' | 'SubagentEnd';
+export declare function isBlockingEvent(event: HookEventName): event is BlockingHookEvent;
+export interface HookMatcher {
+    /** Regex pattern matched against tool_name (PreToolUse/PostToolUse only). */
+    tool_name?: string;
+}
+export interface HookDefinition {
+    /** Hook type. Only "command" supported in phase 1. */
+    type: 'command';
+    /** Shell command to execute via /bin/sh -c. */
+    command: string;
+    /** Optional matcher to filter when this hook runs. */
+    matcher?: HookMatcher;
+    /** Timeout in ms. Default 10000. Process killed after timeout. */
+    timeout?: number;
+    /** Human-readable description for /hooks display. */
+    description?: string;
+}
+export interface HooksConfig {
+    PreToolUse?: HookDefinition[];
+    PostToolUse?: HookDefinition[];
+    Stop?: HookDefinition[];
+    UserPromptSubmit?: HookDefinition[];
+    SessionStart?: HookDefinition[];
+    SessionEnd?: HookDefinition[];
+    Notification?: HookDefinition[];
+    AgentStart?: HookDefinition[];
+    AgentEnd?: HookDefinition[];
+    PermissionRequest?: HookDefinition[];
+    PermissionResult?: HookDefinition[];
+    Interrupt?: HookDefinition[];
+    SubagentStart?: HookDefinition[];
+    SubagentEnd?: HookDefinition[];
+}
+export interface HookStdinBase {
+    session_id: string;
+    cwd: string;
+    hook_event_name: HookEventName;
+    /**
+     * Stable MastraCode-generated id for the active agent run. Present on events
+     * emitted while a run is active (AgentStart..AgentEnd, tool hooks, Stop).
+     * Absent outside a run (SessionStart, SessionEnd, Notification fired idle).
+     */
+    run_id?: string;
+}
+export interface HookStdinToolEvent extends HookStdinBase {
+    hook_event_name: 'PreToolUse' | 'PostToolUse';
+    tool_name: string;
+    tool_input: unknown;
+    tool_output?: unknown;
+    tool_error?: boolean;
+}
+export interface HookStdinUserPrompt extends HookStdinBase {
+    hook_event_name: 'UserPromptSubmit';
+    user_message: string;
+}
+export interface HookStdinStop extends HookStdinBase {
+    hook_event_name: 'Stop';
+    assistant_message?: string;
+    stop_reason: 'complete' | 'aborted' | 'error';
+}
+/**
+ * Describes the git worktree a session is running in. Absent for sessions
+ * started in an ordinary checkout.
+ */
+export interface SessionWorktreeInfo {
+    /** Absolute path to the worktree root. */
+    path: string;
+    /** Branch checked out in the worktree, when it can be resolved. */
+    branch?: string;
+    /** Absolute path to the main repository the worktree is linked to. */
+    mainRepoPath?: string;
+}
+export interface HookStdinSession extends HookStdinBase {
+    hook_event_name: 'SessionStart' | 'SessionEnd';
+    /**
+     * Set only when the session's project directory is a git worktree, so a hook
+     * can provision or tear down per-worktree resources (a database, a bucket, a
+     * dev server) and distinguish that from a session in the main checkout.
+     */
+    worktree_path?: string;
+    branch?: string;
+    main_repo_path?: string;
+}
+export interface HookStdinNotification extends HookStdinBase {
+    hook_event_name: 'Notification';
+    /** Why the notification fired: agent_done, ask_question, tool_approval, plan_approval, sandbox_access */
+    reason: string;
+    /** Optional human-readable message for the notification. */
+    message?: string;
+}
+export interface HookStdinAgentStart extends HookStdinBase {
+    hook_event_name: 'AgentStart';
+    run_id: string;
+}
+export interface HookStdinAgentEnd extends HookStdinBase {
+    hook_event_name: 'AgentEnd';
+    run_id: string;
+    stop_reason: 'complete' | 'aborted' | 'error' | 'suspended';
+}
+export type PermissionKind = 'tool_approval' | 'sandbox_access' | 'plan_approval';
+export interface HookStdinPermissionRequest extends HookStdinBase {
+    hook_event_name: 'PermissionRequest';
+    run_id: string;
+    permission_kind: PermissionKind;
+    tool_call_id: string;
+    tool_name: string;
+    tool_input?: unknown;
+}
+export type PermissionDecision = 'approved' | 'declined' | 'dismissed' | 'auto_approved' | 'auto_declined';
+export interface HookStdinPermissionResult extends HookStdinBase {
+    hook_event_name: 'PermissionResult';
+    run_id: string;
+    permission_kind: PermissionKind;
+    tool_call_id: string;
+    tool_name: string;
+    tool_input?: unknown;
+    decision: PermissionDecision;
+}
+export type InterruptReason = 'user_interrupt' | 'goal_judge_interrupt' | 'process_sigint';
+export interface HookStdinInterrupt extends HookStdinBase {
+    hook_event_name: 'Interrupt';
+    run_id: string;
+    reason: InterruptReason;
+}
+export interface HookStdinSubagentStart extends HookStdinBase {
+    hook_event_name: 'SubagentStart';
+    run_id: string;
+    tool_call_id: string;
+    agent_type: string;
+    task: string;
+    model_id?: string;
+    forked?: boolean;
+}
+export interface HookStdinSubagentEnd extends HookStdinBase {
+    hook_event_name: 'SubagentEnd';
+    run_id: string;
+    tool_call_id: string;
+    agent_type: string;
+    result: unknown;
+    is_error: boolean;
+    duration_ms: number;
+}
+export type HookStdin = HookStdinToolEvent | HookStdinUserPrompt | HookStdinStop | HookStdinSession | HookStdinNotification | HookStdinAgentStart | HookStdinAgentEnd | HookStdinPermissionRequest | HookStdinPermissionResult | HookStdinInterrupt | HookStdinSubagentStart | HookStdinSubagentEnd;
+export interface HookStdout {
+    decision?: 'allow' | 'block';
+    reason?: string;
+    additionalContext?: string;
+}
+export interface HookResult {
+    hook: HookDefinition;
+    exitCode: number;
+    stdout?: HookStdout;
+    stderr?: string;
+    timedOut: boolean;
+    durationMs: number;
+}
+export interface HookEventResult {
+    allowed: boolean;
+    blockReason?: string;
+    additionalContext?: string;
+    results: HookResult[];
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/hooks/types.js

@@ -0,0 +1,8 @@
+//#region src/hooks/types.ts
+function isBlockingEvent(event) {
+	return event === "PreToolUse" || event === "Stop" || event === "UserPromptSubmit";
+}
+//#endregion
+export { isBlockingEvent };
+
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/hooks/types.ts"],"sourcesContent":["/**\n * Type definitions for the hooks system.\n * Hooks are user-configured shell commands that run at lifecycle events.\n */\n\n// =============================================================================\n// Hook Event Names\n// =============================================================================\nexport type 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\nexport type BlockingHookEvent = 'PreToolUse' | 'Stop' | 'UserPromptSubmit';\n\n/** Lifecycle hook events are non-blocking: they observe behavior without changing it. */\nexport type LifecycleHookEvent =\n  | 'AgentStart'\n  | 'AgentEnd'\n  | 'PermissionRequest'\n  | 'PermissionResult'\n  | 'Interrupt'\n  | 'SubagentStart'\n  | 'SubagentEnd';\n\nexport function isBlockingEvent(event: HookEventName): event is BlockingHookEvent {\n  return event === 'PreToolUse' || event === 'Stop' || event === 'UserPromptSubmit';\n}\n\n// =============================================================================\n// Hook Configuration\n// =============================================================================\n\nexport interface HookMatcher {\n  /** Regex pattern matched against tool_name (PreToolUse/PostToolUse only). */\n  tool_name?: string;\n}\n\nexport interface HookDefinition {\n  /** Hook type. Only \"command\" supported in phase 1. */\n  type: 'command';\n  /** Shell command to execute via /bin/sh -c. */\n  command: string;\n  /** Optional matcher to filter when this hook runs. */\n  matcher?: HookMatcher;\n  /** Timeout in ms. Default 10000. Process killed after timeout. */\n  timeout?: number;\n  /** Human-readable description for /hooks display. */\n  description?: string;\n}\nexport interface HooksConfig {\n  PreToolUse?: HookDefinition[];\n  PostToolUse?: HookDefinition[];\n  Stop?: HookDefinition[];\n  UserPromptSubmit?: HookDefinition[];\n  SessionStart?: HookDefinition[];\n  SessionEnd?: HookDefinition[];\n  Notification?: HookDefinition[];\n  AgentStart?: HookDefinition[];\n  AgentEnd?: HookDefinition[];\n  PermissionRequest?: HookDefinition[];\n  PermissionResult?: HookDefinition[];\n  Interrupt?: HookDefinition[];\n  SubagentStart?: HookDefinition[];\n  SubagentEnd?: HookDefinition[];\n}\n\n// =============================================================================\n// Stdin Protocol (JSON sent to hook process)\n// =============================================================================\n\nexport interface HookStdinBase {\n  session_id: string;\n  cwd: string;\n  hook_event_name: HookEventName;\n  /**\n   * Stable MastraCode-generated id for the active agent run. Present on events\n   * emitted while a run is active (AgentStart..AgentEnd, tool hooks, Stop).\n   * Absent outside a run (SessionStart, SessionEnd, Notification fired idle).\n   */\n  run_id?: string;\n}\n\nexport interface HookStdinToolEvent extends HookStdinBase {\n  hook_event_name: 'PreToolUse' | 'PostToolUse';\n  tool_name: string;\n  tool_input: unknown;\n  tool_output?: unknown;\n  tool_error?: boolean;\n}\n\nexport interface HookStdinUserPrompt extends HookStdinBase {\n  hook_event_name: 'UserPromptSubmit';\n  user_message: string;\n}\n\nexport interface HookStdinStop extends HookStdinBase {\n  hook_event_name: 'Stop';\n  assistant_message?: string;\n  stop_reason: 'complete' | 'aborted' | 'error';\n}\n/**\n * Describes the git worktree a session is running in. Absent for sessions\n * started in an ordinary checkout.\n */\nexport interface SessionWorktreeInfo {\n  /** Absolute path to the worktree root. */\n  path: string;\n  /** Branch checked out in the worktree, when it can be resolved. */\n  branch?: string;\n  /** Absolute path to the main repository the worktree is linked to. */\n  mainRepoPath?: string;\n}\n\nexport interface HookStdinSession extends HookStdinBase {\n  hook_event_name: 'SessionStart' | 'SessionEnd';\n  /**\n   * Set only when the session's project directory is a git worktree, so a hook\n   * can provision or tear down per-worktree resources (a database, a bucket, a\n   * dev server) and distinguish that from a session in the main checkout.\n   */\n  worktree_path?: string;\n  branch?: string;\n  main_repo_path?: string;\n}\n\nexport interface HookStdinNotification extends HookStdinBase {\n  hook_event_name: 'Notification';\n  /** Why the notification fired: agent_done, ask_question, tool_approval, plan_approval, sandbox_access */\n  reason: string;\n  /** Optional human-readable message for the notification. */\n  message?: string;\n}\n\nexport interface HookStdinAgentStart extends HookStdinBase {\n  hook_event_name: 'AgentStart';\n  run_id: string;\n}\n\nexport interface HookStdinAgentEnd extends HookStdinBase {\n  hook_event_name: 'AgentEnd';\n  run_id: string;\n  stop_reason: 'complete' | 'aborted' | 'error' | 'suspended';\n}\n\nexport type PermissionKind = 'tool_approval' | 'sandbox_access' | 'plan_approval';\n\nexport interface HookStdinPermissionRequest extends HookStdinBase {\n  hook_event_name: 'PermissionRequest';\n  run_id: string;\n  permission_kind: PermissionKind;\n  tool_call_id: string;\n  tool_name: string;\n  tool_input?: unknown;\n}\n\nexport type PermissionDecision = 'approved' | 'declined' | 'dismissed' | 'auto_approved' | 'auto_declined';\n\nexport interface HookStdinPermissionResult extends HookStdinBase {\n  hook_event_name: 'PermissionResult';\n  run_id: string;\n  permission_kind: PermissionKind;\n  tool_call_id: string;\n  tool_name: string;\n  tool_input?: unknown;\n  decision: PermissionDecision;\n}\n\nexport type InterruptReason = 'user_interrupt' | 'goal_judge_interrupt' | 'process_sigint';\n\nexport interface HookStdinInterrupt extends HookStdinBase {\n  hook_event_name: 'Interrupt';\n  run_id: string;\n  reason: InterruptReason;\n}\n\nexport interface HookStdinSubagentStart extends HookStdinBase {\n  hook_event_name: 'SubagentStart';\n  run_id: string;\n  tool_call_id: string;\n  agent_type: string;\n  task: string;\n  model_id?: string;\n  forked?: boolean;\n}\n\nexport interface HookStdinSubagentEnd extends HookStdinBase {\n  hook_event_name: 'SubagentEnd';\n  run_id: string;\n  tool_call_id: string;\n  agent_type: string;\n  result: unknown;\n  is_error: boolean;\n  duration_ms: number;\n}\n\nexport type HookStdin =\n  | HookStdinToolEvent\n  | HookStdinUserPrompt\n  | HookStdinStop\n  | HookStdinSession\n  | HookStdinNotification\n  | HookStdinAgentStart\n  | HookStdinAgentEnd\n  | HookStdinPermissionRequest\n  | HookStdinPermissionResult\n  | HookStdinInterrupt\n  | HookStdinSubagentStart\n  | HookStdinSubagentEnd;\n\n// =============================================================================\n// Stdout Protocol (JSON read from hook process)\n// =============================================================================\n\nexport interface HookStdout {\n  decision?: 'allow' | 'block';\n  reason?: string;\n  additionalContext?: string;\n}\n\n// =============================================================================\n// Execution Results\n// =============================================================================\n\nexport interface HookResult {\n  hook: HookDefinition;\n  exitCode: number;\n  stdout?: HookStdout;\n  stderr?: string;\n  timedOut: boolean;\n  durationMs: number;\n}\n\nexport interface HookEventResult {\n  allowed: boolean;\n  blockReason?: string;\n  additionalContext?: string;\n  results: HookResult[];\n  warnings: string[];\n}\n"],"mappings":";AAoCA,SAAgB,gBAAgB,OAAkD;CAChF,OAAO,UAAU,gBAAgB,UAAU,UAAU,UAAU;AACjE"}