@mastra/code-sdk 0.0.0-mastracode-cloud-20260706153555

package/dist/hooks/config.js

@@ -0,0 +1,78 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+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);
+  const globalConfig = loadSingleConfig(globalPath);
+  const projectConfig = loadSingleConfig(projectPath);
+  return mergeConfigs(globalConfig, projectConfig);
+}
+function getProjectHooksPath(projectDir, configDirName = DEFAULT_CONFIG_DIR) {
+  return path.join(projectDir, configDirName, "hooks.json");
+}
+function getGlobalHooksPath(configDirName = DEFAULT_CONFIG_DIR, homeDir = os.homedir()) {
+  return path.join(homeDir, configDirName, "hooks.json");
+}
+function loadSingleConfig(filePath) {
+  try {
+    if (!fs.existsSync(filePath)) return {};
+    const raw = fs.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;
+}
+export {
+  VALID_EVENTS,
+  getGlobalHooksPath,
+  getProjectHooksPath,
+  loadHooksConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/hooks/config.js.map

@@ -0,0 +1 @@
+{"version":3,"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":"AAMA,YAAY,QAAQ;AACpB,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,0BAA0B;AAG5B,MAAM,eAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,gBAAgB,YAAoB,gBAAgB,oBAAoB,SAA+B;AACrH,QAAM,aAAa,mBAAmB,eAAe,OAAO;AAC5D,QAAM,cAAc,oBAAoB,YAAY,aAAa;AAEjE,QAAM,eAAe,iBAAiB,UAAU;AAChD,QAAM,gBAAgB,iBAAiB,WAAW;AAElD,SAAO,aAAa,cAAc,aAAa;AACjD;AAEO,SAAS,oBAAoB,YAAoB,gBAAgB,oBAA4B;AAClG,SAAO,KAAK,KAAK,YAAY,eAAe,YAAY;AAC1D;AAEO,SAAS,mBAAmB,gBAAgB,oBAAoB,UAAU,GAAG,QAAQ,GAAW;AACrG,SAAO,KAAK,KAAK,SAAS,eAAe,YAAY;AACvD;AAEA,SAAS,iBAAiB,UAA+B;AACvD,MAAI;AACF,QAAI,CAAC,GAAG,WAAW,QAAQ,EAAG,QAAO,CAAC;AACtC,UAAM,MAAM,GAAG,aAAa,UAAU,OAAO;AAC7C,WAAO,eAAe,KAAK,MAAM,GAAG,CAAC;AAAA,EACvC,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,eAAe,KAA2B;AACjD,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO,CAAC;AAE7C,QAAM,SAAsB,CAAC;AAC7B,QAAM,MAAM;AAEZ,aAAW,SAAS,cAAc;AAChC,QAAI,MAAM,QAAQ,IAAI,KAAK,CAAC,GAAG;AAC7B,YAAM,QAAS,IAAI,KAAK,EAAgB,OAAO,WAAW;AAC1D,UAAI,MAAM,SAAS,GAAG;AACpB,eAAO,KAAK,IAAI;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,YAAY,KAAqC;AACxD,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,MAAM;AACZ,SAAO,IAAI,SAAS,aAAa,OAAO,IAAI,YAAY;AAC1D;AAEA,SAAS,aAAa,QAAqB,SAAmC;AAC5E,QAAM,SAAsB,CAAC;AAE7B,aAAW,SAAS,cAAc;AAChC,UAAM,WAAW,CAAC,GAAI,OAAO,KAAK,KAAK,CAAC,GAAI,GAAI,QAAQ,KAAK,KAAK,CAAC,CAAE;AACrE,QAAI,SAAS,SAAS,GAAG;AACvB,aAAO,KAAK,IAAI;AAAA,IAClB;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

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,CAiFpG;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,125 @@
+import { spawn } from "node:child_process";
+import { isBlockingEvent } from "./types.js";
+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 shell = isWindows ? "cmd" : "/bin/sh";
+    const shellArgs = isWindows ? ["/c", hook.command] : ["-c", hook.command];
+    const child = spawn(shell, shellArgs, {
+      stdio: ["pipe", "pipe", "pipe"],
+      cwd: stdinPayload.cwd,
+      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
+      });
+    });
+    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}
+${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) {
+      const reason = result.stdout?.reason || result.stderr || `Blocked by hook: ${hook.description || hook.command}`;
+      return {
+        allowed: false,
+        blockReason: reason,
+        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 };
+}
+export {
+  executeHook,
+  matchesHook,
+  runHooksForEvent
+};
+//# sourceMappingURL=executor.js.map

package/dist/hooks/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"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      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    try {\n      child.stdin?.write(JSON.stringify(stdinPayload));\n      child.stdin?.end();\n    } catch {\n      // 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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","names":[]}

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,16 @@
+import { HookManager } from "./manager.js";
+import { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath, VALID_EVENTS } from "./config.js";
+import { executeHook, runHooksForEvent, matchesHook } from "./executor.js";
+import { isBlockingEvent } from "./types.js";
+export {
+  HookManager,
+  VALID_EVENTS,
+  executeHook,
+  getGlobalHooksPath,
+  getProjectHooksPath,
+  isBlockingEvent,
+  loadHooksConfig,
+  matchesHook,
+  runHooksForEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/index.ts"],"sourcesContent":["export { HookManager } from './manager.js';\nexport { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath, VALID_EVENTS } from './config.js';\nexport { executeHook, runHooksForEvent, matchesHook } from './executor.js';\nexport { isBlockingEvent } from './types.js';\nexport type {\n  HookEventName,\n  HookDefinition,\n  HookMatcher,\n  HooksConfig,\n  HookStdin,\n  HookStdinBase,\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  HookStdout,\n  HookResult,\n  HookEventResult,\n  BlockingHookEvent,\n  LifecycleHookEvent,\n  PermissionKind,\n  PermissionDecision,\n  InterruptReason,\n} from './types.js';\n"],"mappings":"AAAA,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB,qBAAqB,oBAAoB,oBAAoB;AACvF,SAAS,aAAa,kBAAkB,mBAAmB;AAC3D,SAAS,uBAAuB;","names":[]}

package/dist/hooks/manager.d.ts

@@ -0,0 +1,47 @@
+import type { HooksConfig, HookEventResult, PermissionKind, PermissionDecision, InterruptReason } from './types.js';
+export declare class HookManager {
+    private config;
+    private projectDir;
+    private sessionId;
+    private configDirName;
+    private homeDir?;
+    private runId?;
+    constructor(projectDir: string, sessionId: string, configDirName?: string, homeDir?: string);
+    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;
+    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":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EAcf,cAAc,EACd,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,SAAqB,EAAE,OAAO,CAAC,EAAE,MAAM;IAQvG,MAAM,IAAI,IAAI;IAId,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,uGAAuG;IACvG,UAAU,IAAI,IAAI;IAIlB,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,QAAQ,IAAI,OAAO;IAInB,SAAS,IAAI,WAAW;IAIxB,cAAc,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAWrD;;;OAGG;IACH,OAAO,CAAC,eAAe;IAqBjB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAe7E,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,eAAe,CAAC;IAiBrB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAclE,OAAO,CACX,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAC3C,OAAO,CAAC,eAAe,CAAC;IAerB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAY3C,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAa/C;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBjD,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAkBzC,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBjG,oBAAoB,CACxB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,eAAe,CAAC;IAsBrB,mBAAmB,CACvB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,eAAe,CAAC;IAwBrB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB/D,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,eAAe,CAAC;IAuBrB,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;CAsB5B"}

package/dist/hooks/manager.js

@@ -0,0 +1,284 @@
+import { DEFAULT_CONFIG_DIR } from "../constants.js";
+import { loadHooksConfig, getProjectHooksPath, getGlobalHooksPath } from "./config.js";
+import { runHooksForEvent } from "./executor.js";
+const emptyResult = () => ({ allowed: true, results: [], warnings: [] });
+class HookManager {
+  config;
+  projectDir;
+  sessionId;
+  configDirName;
+  homeDir;
+  runId;
+  constructor(projectDir, sessionId, configDirName = DEFAULT_CONFIG_DIR, homeDir) {
+    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)
+    };
+  }
+  // =========================================================================
+  // Stdin Helpers
+  // =========================================================================
+  /**
+   * 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;
+  }
+  // =========================================================================
+  // Blocking Event Methods (decisions enforced by callers)
+  // =========================================================================
+  async runPreToolUse(toolName, toolInput) {
+    const hooks = this.config.PreToolUse;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("PreToolUse"),
+      tool_name: toolName,
+      tool_input: toolInput
+    };
+    return runHooksForEvent(hooks, stdin, { tool_name: toolName });
+  }
+  async runPostToolUse(toolName, toolInput, toolOutput, toolError) {
+    const hooks = this.config.PostToolUse;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("PostToolUse"),
+      tool_name: toolName,
+      tool_input: toolInput,
+      tool_output: toolOutput,
+      tool_error: toolError
+    };
+    return runHooksForEvent(hooks, stdin, { tool_name: toolName });
+  }
+  async runUserPromptSubmit(userMessage) {
+    const hooks = this.config.UserPromptSubmit;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("UserPromptSubmit"),
+      user_message: userMessage
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  async runStop(assistantMessage, stopReason) {
+    const hooks = this.config.Stop;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("Stop"),
+      assistant_message: assistantMessage,
+      stop_reason: stopReason
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  async runSessionStart() {
+    const hooks = this.config.SessionStart;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("SessionStart")
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  async runSessionEnd() {
+    const hooks = this.config.SessionEnd;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("SessionEnd")
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  /**
+   * 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;
+    const stdin = {
+      ...this.baseStdinFields("Notification"),
+      reason,
+      message
+    };
+    runHooksForEvent(hooks, stdin).catch(() => {
+    });
+  }
+  // =========================================================================
+  // Lifecycle Event Methods (non-blocking: observe behavior, never enforce)
+  // =========================================================================
+  async runAgentStart() {
+    const hooks = this.config.AgentStart;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const runId = this.runId;
+    if (!runId) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("AgentStart"),
+      run_id: runId
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  async runAgentEnd(stopReason) {
+    const hooks = this.config.AgentEnd;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const runId = this.runId;
+    if (!runId) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("AgentEnd"),
+      run_id: runId,
+      stop_reason: stopReason
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  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();
+    }
+    const stdin = {
+      ...this.baseStdinFields("PermissionRequest"),
+      run_id: runId,
+      permission_kind: permissionKind,
+      tool_call_id: toolCallId,
+      tool_name: toolName,
+      ...toolInput !== void 0 ? { tool_input: toolInput } : {}
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  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();
+    }
+    const stdin = {
+      ...this.baseStdinFields("PermissionResult"),
+      run_id: runId,
+      permission_kind: permissionKind,
+      tool_call_id: toolCallId,
+      tool_name: toolName,
+      decision,
+      ...toolInput !== void 0 ? { tool_input: toolInput } : {}
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  async runInterrupt(reason) {
+    const hooks = this.config.Interrupt;
+    if (!hooks || hooks.length === 0) {
+      return emptyResult();
+    }
+    const runId = this.runId;
+    if (!runId) {
+      return emptyResult();
+    }
+    const stdin = {
+      ...this.baseStdinFields("Interrupt"),
+      run_id: runId,
+      reason
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  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();
+    }
+    const stdin = {
+      ...this.baseStdinFields("SubagentStart"),
+      run_id: runId,
+      tool_call_id: toolCallId,
+      agent_type: agentType,
+      task,
+      ...modelId !== void 0 ? { model_id: modelId } : {},
+      ...forked !== void 0 ? { forked } : {}
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+  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();
+    }
+    const stdin = {
+      ...this.baseStdinFields("SubagentEnd"),
+      run_id: runId,
+      tool_call_id: toolCallId,
+      agent_type: agentType,
+      result,
+      is_error: isError,
+      duration_ms: durationMs
+    };
+    return runHooksForEvent(hooks, stdin);
+  }
+}
+export {
+  HookManager
+};
+//# sourceMappingURL=manager.js.map

package/dist/hooks/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"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} 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\n  constructor(projectDir: string, sessionId: string, configDirName = DEFAULT_CONFIG_DIR, homeDir?: string) {\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  // 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 = {\n      ...this.baseStdinFields('SessionStart'),\n    };\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 = {\n      ...this.baseStdinFields('SessionEnd'),\n    };\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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","names":[]}