@mastra/code-sdk 0.0.0-client-tool-results-20260912062135

package/dist/hooks/config.js

@@ -0,0 +1,73 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import * as fs$1 from "fs";
+import * as os$1 from "os";
+import * as path$1 from "path";
+//#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), loadSingleConfig(projectPath));
+}
+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":["path","os","fs"],"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  const projectConfig = loadSingleConfig(projectPath);\n\n  return mergeConfigs(globalConfig, projectConfig);\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;CAKjE,OAAO,aAHc,iBAAiB,UAGP,GAFT,iBAAiB,WAEO,CAAC;AACjD;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,CAACE,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

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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"}