@goodfoot/claude-code-hooks 1.2.1 → 1.2.3

package/README.md

@@ -107,7 +107,7 @@ npm test        # Run tests
 
 ### Available Hook Types
 
-The `--hooks` argument accepts a comma-separated list of any of these 13 event types:
+The `--hooks` argument accepts a comma-separated list of any of these 15 event types:
 
 | Hook Type            | Description                                |
 | -------------------- | ------------------------------------------ |
@@ -119,9 +119,11 @@ The `--hooks` argument accepts a comma-separated list of any of these 13 event t
 | `SessionStart`       | When session begins                        |
 | `SessionEnd`         | When session terminates                    |
 | `Stop`               | After main agent finishes                  |
+| `StopFailure`        | When session stops due to an error         |
 | `SubagentStart`      | When an Agent tool starts                   |
 | `SubagentStop`       | When an Agent tool completes                |
 | `PreCompact`         | Before context compaction                  |
+| `PostCompact`        | After context compaction completes         |
 | `PermissionRequest`  | When permission is requested               |
 | `Setup`              | On init, install, or update events         |
 

package/dist/cli.js

@@ -435,6 +435,7 @@ execute(hook);
         target: "node20",
         bundle: true,
         minify: false,
+        treeShaking: true,
         write: false, // Return content directly via outputFiles
         banner: { js: esmRequireBanner },
         // Keep node built-ins external
@@ -950,4 +951,4 @@ if (isDirectExecution) {
     });
 }
 // Export for testing
-export { parseArgs, validateArgs, analyzeHookFile, discoverHookFiles, compileHook, generateContentHash, detectHookContext, generateCommandPath, generateHooksJson, groupHooksByEventAndMatcher, readExistingHooksJson, removeOldGeneratedFiles, extractPreservedHooks, mergeHooksJson, HOOK_FACTORY_TO_EVENT, };
+export { analyzeHookFile, compileHook, detectHookContext, discoverHookFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, mergeHooksJson, parseArgs, readExistingHooksJson, removeOldGeneratedFiles, validateArgs, };

package/dist/constants.js

@@ -14,9 +14,11 @@ export const HOOK_FACTORY_TO_EVENT = {
     sessionStartHook: "SessionStart",
     sessionEndHook: "SessionEnd",
     stopHook: "Stop",
+    stopFailureHook: "StopFailure",
     subagentStartHook: "SubagentStart",
     subagentStopHook: "SubagentStop",
     preCompactHook: "PreCompact",
+    postCompactHook: "PostCompact",
     permissionRequestHook: "PermissionRequest",
     setupHook: "Setup",
     teammateIdleHook: "TeammateIdle",

package/dist/hooks.js

@@ -267,6 +267,39 @@ export function stopHook(config, handler) {
     return createHookFunction("Stop", config, handler);
 }
 // ============================================================================
+// StopFailure Hook Factory
+// ============================================================================
+/**
+ * Creates a StopFailure hook handler.
+ *
+ * StopFailure hooks fire when Claude Code encounters an error while stopping
+ * (e.g., API errors, authentication failures, rate limits), allowing you to:
+ * - Log stop failure events and error details
+ * - Alert on unexpected session termination errors
+ * - Observe what error caused the failure
+ *
+ * **Matcher**: No matcher support - fires on all stop failure events
+ * @param config - Hook configuration with optional timeout (matcher is ignored)
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { stopFailureHook, stopFailureOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default stopFailureHook({}, async (input, { logger }) => {
+ *   logger.error('Session stopped due to error', {
+ *     error: input.error,
+ *     details: input.error_details
+ *   });
+ *   return stopFailureOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#stopfailure
+ */
+export function stopFailureHook(config, handler) {
+    return createHookFunction("StopFailure", config, handler);
+}
+// ============================================================================
 // SubagentStart Hook Factory
 // ============================================================================
 /**
@@ -385,6 +418,38 @@ export function subagentStopHook(config, handler) {
 export function preCompactHook(config, handler) {
     return createHookFunction("PreCompact", config, handler);
 }
+// ============================================================================
+// PostCompact Hook Factory
+// ============================================================================
+/**
+ * Creates a PostCompact hook handler.
+ *
+ * PostCompact hooks fire after context compaction completes, allowing you to:
+ * - Observe the compaction summary and details
+ * - Log compaction events
+ * - React to the new compacted state
+ *
+ * **Matcher**: Matches against `trigger` ('manual', 'auto')
+ * @param config - Hook configuration with optional matcher and timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { postCompactHook, postCompactOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default postCompactHook({}, async (input, { logger }) => {
+ *   logger.info('Context compaction completed', {
+ *     trigger: input.trigger,
+ *     summary: input.compact_summary
+ *   });
+ *   return postCompactOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#postcompact
+ */
+export function postCompactHook(config, handler) {
+    return createHookFunction("PostCompact", config, handler);
+}
 /** @inheritdoc */
 export function permissionRequestHook(config, handler) {
     return createHookFunction("PermissionRequest", config, handler);

package/dist/index.js

@@ -11,16 +11,16 @@ export {
 CLAUDE_ENV_VARS, getEnvFilePath, 
 // Getters
 getProjectDir, isRemoteEnvironment, } from "./env.js";
-// Hook factory functions - all 21 hook types
-export { configChangeHook, elicitationHook, elicitationResultHook, instructionsLoadedHook, notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, worktreeCreateHook, worktreeRemoveHook, } from "./hooks.js";
+// Hook factory functions - all 23 hook types
+export { configChangeHook, elicitationHook, elicitationResultHook, instructionsLoadedHook, notificationHook, permissionRequestHook, postCompactHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopFailureHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, worktreeCreateHook, worktreeRemoveHook, } from "./hooks.js";
 // Logger exports
 export { LOG_LEVELS, Logger, logger } from "./logger.js";
 // Output builder functions
 export { configChangeOutput, 
 // Exit codes
-EXIT_CODES, elicitationOutput, elicitationResultOutput, instructionsLoadedOutput, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, 
-// All 21 output builder functions
-preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, worktreeCreateOutput, worktreeRemoveOutput, } from "./outputs.js";
+EXIT_CODES, elicitationOutput, elicitationResultOutput, instructionsLoadedOutput, notificationOutput, permissionRequestOutput, postCompactOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, 
+// All 23 output builder functions
+preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopFailureOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, worktreeCreateOutput, worktreeRemoveOutput, } from "./outputs.js";
 // Runtime exports - execute function
 export { 
 // Main execute function for compiled hooks

package/dist/outputs.js

@@ -199,6 +199,16 @@ export const sessionEndOutput = /* @__PURE__ */ createSimpleOutputBuilder("Sessi
  * ```
  */
 export const stopOutput = /* @__PURE__ */ createDecisionOutputBuilder("Stop");
+/**
+ * Creates an output for StopFailure hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A StopFailureOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * stopFailureOutput({});
+ * ```
+ */
+export const stopFailureOutput = /* @__PURE__ */ createSimpleOutputBuilder("StopFailure");
 /**
  * Creates an output for SubagentStart hooks.
  * @param options - Configuration options for the hook output
@@ -257,6 +267,16 @@ export const notificationOutput = /* @__PURE__ */ createHookSpecificOutputBuilde
  * ```
  */
 export const preCompactOutput = /* @__PURE__ */ createSimpleOutputBuilder("PreCompact");
+/**
+ * Creates an output for PostCompact hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A PostCompactOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * postCompactOutput({});
+ * ```
+ */
+export const postCompactOutput = /* @__PURE__ */ createSimpleOutputBuilder("PostCompact");
 /**
  * Creates an output for PermissionRequest hooks.
  * @param options - Configuration options for the hook output

package/dist/scaffold.js

@@ -45,9 +45,11 @@ const EVENT_TO_OUTPUT_FUNCTION = {
     SessionStart: "sessionStartOutput",
     SessionEnd: "sessionEndOutput",
     Stop: "stopOutput",
+    StopFailure: "stopFailureOutput",
     SubagentStart: "subagentStartOutput",
     SubagentStop: "subagentStopOutput",
     PreCompact: "preCompactOutput",
+    PostCompact: "postCompactOutput",
     PermissionRequest: "permissionRequestOutput",
     Setup: "setupOutput",
     TeammateIdle: "teammateIdleOutput",
@@ -125,7 +127,7 @@ function generatePackageJson(projectName, outputPath) {
             "@goodfoot/claude-code-hooks": "^1.0.9",
         },
         devDependencies: {
-            "@biomejs/biome": "2.4.6",
+            "@biomejs/biome": "2.4.8",
             "@types/node": "^22.0.0",
             typescript: "^5.9.3",
             vitest: "^4.0.16",
@@ -168,7 +170,7 @@ function generateTsConfig() {
  */
 function generateBiomeConfig() {
     return `{
-  "$schema": "https://biomejs.dev/schemas/2.4.6/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.8/schema.json",
   "formatter": {
     "enabled": true,
     "indentStyle": "space",

package/dist/types.js

@@ -28,9 +28,11 @@ export const HOOK_EVENT_NAMES = [
     "SessionStart",
     "SessionEnd",
     "Stop",
+    "StopFailure",
     "SubagentStart",
     "SubagentStop",
     "PreCompact",
+    "PostCompact",
     "PermissionRequest",
     "Setup",
     "TeammateIdle",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodfoot/claude-code-hooks",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Type-safe Claude Code hooks library with camelCase types and output builders",
   "homepage": "https://github.com/goodfoot-io/marketplace/tree/main/packages/claude-code-hooks",
   "repository": {
@@ -53,8 +53,8 @@
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.71",
-    "@biomejs/biome": "2.4.6",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.80",
+    "@biomejs/biome": "2.4.8",
     "@types/node": "^24",
     "ts-morph": "^25.0.0",
     "tsx": "^4.20.3",

package/types/cli.d.ts

@@ -262,5 +262,5 @@ declare function extractPreservedHooks(existingHooksJson: HooksJson): Partial<Re
  * @returns Merged HooksJson
  */
 declare function mergeHooksJson(newHooksJson: HooksJson, preservedHooks: Partial<Record<HookEventName, MatcherEntry[]>>): HooksJson;
-export { parseArgs, validateArgs, analyzeHookFile, discoverHookFiles, compileHook, generateContentHash, detectHookContext, generateCommandPath, generateHooksJson, groupHooksByEventAndMatcher, readExistingHooksJson, removeOldGeneratedFiles, extractPreservedHooks, mergeHooksJson, HOOK_FACTORY_TO_EVENT, };
-export type { CliArgs, HookMetadata, CompiledHook, HookConfig, MatcherEntry, HooksJson };
+export type { CliArgs, CompiledHook, HookConfig, HookMetadata, HooksJson, MatcherEntry };
+export { analyzeHookFile, compileHook, detectHookContext, discoverHookFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, mergeHooksJson, parseArgs, readExistingHooksJson, removeOldGeneratedFiles, validateArgs, };

package/types/hooks.d.ts

@@ -22,8 +22,8 @@
  * @see https://code.claude.com/docs/en/hooks
  */
 import type { Logger } from "./logger.js";
-import type { ConfigChangeOutput, ElicitationOutput, ElicitationResultOutput, InstructionsLoadedOutput, NotificationOutput, PermissionRequestOutput, PostToolUseFailureOutput, PostToolUseOutput, PreCompactOutput, PreToolUseOutput, SessionEndOutput, SessionStartOutput, SetupOutput, SpecificHookOutput, StopOutput, SubagentStartOutput, SubagentStopOutput, TaskCompletedOutput, TeammateIdleOutput, UserPromptSubmitOutput, WorktreeCreateOutput, WorktreeRemoveOutput } from "./outputs.js";
-import type { ConfigChangeInput, ElicitationInput, ElicitationResultInput, HookEventName, InstructionsLoadedInput, KnownToolName, NotificationInput, PermissionRequestInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreToolUseInput, SessionEndInput, SessionStartInput, SetupInput, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput, WorktreeCreateInput, WorktreeRemoveInput } from "./types.js";
+import type { ConfigChangeOutput, ElicitationOutput, ElicitationResultOutput, InstructionsLoadedOutput, NotificationOutput, PermissionRequestOutput, PostCompactOutput, PostToolUseFailureOutput, PostToolUseOutput, PreCompactOutput, PreToolUseOutput, SessionEndOutput, SessionStartOutput, SetupOutput, SpecificHookOutput, StopFailureOutput, StopOutput, SubagentStartOutput, SubagentStopOutput, TaskCompletedOutput, TeammateIdleOutput, UserPromptSubmitOutput, WorktreeCreateOutput, WorktreeRemoveOutput } from "./outputs.js";
+import type { ConfigChangeInput, ElicitationInput, ElicitationResultInput, HookEventName, InstructionsLoadedInput, KnownToolName, NotificationInput, PermissionRequestInput, PostCompactInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreToolUseInput, SessionEndInput, SessionStartInput, SetupInput, StopFailureInput, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput, WorktreeCreateInput, WorktreeRemoveInput } from "./types.js";
 /**
  * Configuration options for hook factories.
  *
@@ -612,6 +612,34 @@ export declare function sessionEndHook(config: HookConfig, handler: HookHandler<
  * @see https://code.claude.com/docs/en/hooks#stop
  */
 export declare function stopHook(config: HookConfig, handler: HookHandler<StopInput, StopOutput>): HookFunction<StopInput, StopOutput>;
+/**
+ * Creates a StopFailure hook handler.
+ *
+ * StopFailure hooks fire when Claude Code encounters an error while stopping
+ * (e.g., API errors, authentication failures, rate limits), allowing you to:
+ * - Log stop failure events and error details
+ * - Alert on unexpected session termination errors
+ * - Observe what error caused the failure
+ *
+ * **Matcher**: No matcher support - fires on all stop failure events
+ * @param config - Hook configuration with optional timeout (matcher is ignored)
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { stopFailureHook, stopFailureOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default stopFailureHook({}, async (input, { logger }) => {
+ *   logger.error('Session stopped due to error', {
+ *     error: input.error,
+ *     details: input.error_details
+ *   });
+ *   return stopFailureOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#stopfailure
+ */
+export declare function stopFailureHook(config: HookConfig, handler: HookHandler<StopFailureInput, StopFailureOutput>): HookFunction<StopFailureInput, StopFailureOutput>;
 /**
  * Creates a SubagentStart hook handler.
  *
@@ -716,6 +744,33 @@ export declare function subagentStopHook(config: HookConfig, handler: HookHandle
  * @see https://code.claude.com/docs/en/hooks#precompact
  */
 export declare function preCompactHook(config: HookConfig, handler: HookHandler<PreCompactInput, PreCompactOutput>): HookFunction<PreCompactInput, PreCompactOutput>;
+/**
+ * Creates a PostCompact hook handler.
+ *
+ * PostCompact hooks fire after context compaction completes, allowing you to:
+ * - Observe the compaction summary and details
+ * - Log compaction events
+ * - React to the new compacted state
+ *
+ * **Matcher**: Matches against `trigger` ('manual', 'auto')
+ * @param config - Hook configuration with optional matcher and timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { postCompactHook, postCompactOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default postCompactHook({}, async (input, { logger }) => {
+ *   logger.info('Context compaction completed', {
+ *     trigger: input.trigger,
+ *     summary: input.compact_summary
+ *   });
+ *   return postCompactOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#postcompact
+ */
+export declare function postCompactHook(config: HookConfig, handler: HookHandler<PostCompactInput, PostCompactOutput>): HookFunction<PostCompactInput, PostCompactOutput>;
 /**
  * Creates a PermissionRequest hook handler.
  *

package/types/index.d.ts

@@ -8,15 +8,15 @@
 export type * from "@anthropic-ai/claude-agent-sdk/sdk-tools.js";
 export { CLAUDE_ENV_VARS, getEnvFilePath, getProjectDir, isRemoteEnvironment, } from "./env.js";
 export type { HookConfig, HookContext, HookFunction, HookHandler, SessionStartContext, TypedHookConfig, TypedPermissionRequestInput, TypedPostToolUseFailureHookInput, TypedPostToolUseHookInput, TypedPreToolUseHookInput, } from "./hooks.js";
-export { configChangeHook, elicitationHook, elicitationResultHook, instructionsLoadedHook, notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, worktreeCreateHook, worktreeRemoveHook, } from "./hooks.js";
+export { configChangeHook, elicitationHook, elicitationResultHook, instructionsLoadedHook, notificationHook, permissionRequestHook, postCompactHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopFailureHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, worktreeCreateHook, worktreeRemoveHook, } from "./hooks.js";
 export type { LogEvent, LogEventError, LogEventHandler, LoggerConfig, LogLevel, Unsubscribe } from "./logger.js";
 export { LOG_LEVELS, Logger, logger } from "./logger.js";
 export type { 
 /** @deprecated Use CommonOptions instead */
-BaseOptions, CommonOptions, ConfigChangeOptions, ElicitationHookSpecificOutput, ElicitationOptions, ElicitationResultHookSpecificOutput, ElicitationResultOptions, ExitCode, ExitCodeOptions, HookOutput, HookSpecificOutput, InstructionsLoadedOptions, NotificationHookSpecificOutput, NotificationOptions, PermissionRequestAllowDecision, PermissionRequestDecision, PermissionRequestDenyDecision, PermissionRequestHookSpecificOutput, PermissionRequestOptions, PostToolUseFailureHookSpecificOutput, PostToolUseFailureOptions, PostToolUseHookSpecificOutput, PostToolUseOptions, PreCompactOptions, PreToolUseHookSpecificOutput, PreToolUseOptions, SessionEndOptions, SessionStartHookSpecificOutput, SessionStartOptions, SetupHookSpecificOutput, SetupOptions, StopOptions, SubagentStartHookSpecificOutput, SubagentStartOptions, SubagentStopOptions, SyncHookJSONOutput, TaskCompletedOptions, TeammateIdleOptions, UserPromptSubmitHookSpecificOutput, UserPromptSubmitOptions, WorktreeCreateOptions, WorktreeRemoveOptions, } from "./outputs.js";
-export { configChangeOutput, EXIT_CODES, elicitationOutput, elicitationResultOutput, instructionsLoadedOutput, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, worktreeCreateOutput, worktreeRemoveOutput, } from "./outputs.js";
+BaseOptions, CommonOptions, ConfigChangeOptions, ElicitationHookSpecificOutput, ElicitationOptions, ElicitationResultHookSpecificOutput, ElicitationResultOptions, ExitCode, ExitCodeOptions, HookOutput, HookSpecificOutput, InstructionsLoadedOptions, NotificationHookSpecificOutput, NotificationOptions, PermissionRequestAllowDecision, PermissionRequestDecision, PermissionRequestDenyDecision, PermissionRequestHookSpecificOutput, PermissionRequestOptions, PostCompactOptions, PostToolUseFailureHookSpecificOutput, PostToolUseFailureOptions, PostToolUseHookSpecificOutput, PostToolUseOptions, PreCompactOptions, PreToolUseHookSpecificOutput, PreToolUseOptions, SessionEndOptions, SessionStartHookSpecificOutput, SessionStartOptions, SetupHookSpecificOutput, SetupOptions, StopFailureOptions, StopOptions, SubagentStartHookSpecificOutput, SubagentStartOptions, SubagentStopOptions, SyncHookJSONOutput, TaskCompletedOptions, TeammateIdleOptions, UserPromptSubmitHookSpecificOutput, UserPromptSubmitOptions, WorktreeCreateOptions, WorktreeRemoveOptions, } from "./outputs.js";
+export { configChangeOutput, EXIT_CODES, elicitationOutput, elicitationResultOutput, instructionsLoadedOutput, notificationOutput, permissionRequestOutput, postCompactOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopFailureOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, worktreeCreateOutput, worktreeRemoveOutput, } from "./outputs.js";
 export { execute, } from "./runtime.js";
 export type { ContentContext, PatternCheckResult, ToolUseInput } from "./tool-helpers.js";
 export { checkContentForPattern, forEachContent, getFilePath, isAskUserQuestionTool, isBashTool, isConfigTool, isEditTool, isExitPlanModeTool, isFileModifyingTool, isGlobTool, isGrepTool, isJsTsFile, isKillShellTool, isListMcpResourcesTool, isMcpTool, isMultiEditTool, isNotebookEditTool, isReadMcpResourceTool, isReadTool, isTaskOutputTool, isTaskTool, isTodoWriteTool, isTsFile, isWebFetchTool, isWebSearchTool, isWriteTool, } from "./tool-helpers.js";
-export type { BaseHookInput, ConfigChangeInput, ConfigInput, ElicitationInput, ElicitationResultInput, FileModifyingToolInput, FileModifyingToolName, HookEventName, HookInput, InstructionsLoadedInput, KnownToolInput, KnownToolName, ListMcpResourcesInput, McpInput, MultiEditEntry, MultiEditToolInput, NotificationInput, PermissionMode, PermissionRequestInput, PermissionUpdate, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreCompactTrigger, PreToolUseInput, ReadMcpResourceInput, SessionEndInput, SessionEndReason, SessionStartInput, SessionStartSource, SetupInput, SetupTrigger, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput, WorktreeCreateInput, WorktreeRemoveInput, } from "./types.js";
+export type { BaseHookInput, ConfigChangeInput, ConfigInput, ElicitationInput, ElicitationResultInput, FileModifyingToolInput, FileModifyingToolName, HookEventName, HookInput, InstructionsLoadedInput, KnownToolInput, KnownToolName, ListMcpResourcesInput, McpInput, MultiEditEntry, MultiEditToolInput, NotificationInput, PermissionMode, PermissionRequestInput, PermissionUpdate, PostCompactInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreCompactTrigger, PreToolUseInput, ReadMcpResourceInput, SessionEndInput, SessionEndReason, SessionStartInput, SessionStartSource, SetupInput, SetupTrigger, StopFailureInput, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput, WorktreeCreateInput, WorktreeRemoveInput, } from "./types.js";
 export { HOOK_EVENT_NAMES } from "./types.js";

package/types/outputs.d.ts

@@ -33,11 +33,10 @@ export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
 /**
  * Re-export the SDK's SyncHookJSONOutput type.
  */
-export type { SDKSyncHookJSONOutput };
 /**
  * Re-export SDK hook-specific output types (includes hookEventName discriminator).
  */
-export type { SDKElicitationHookSpecificOutput, SDKElicitationResultHookSpecificOutput, SDKNotificationHookSpecificOutput, SDKPreToolUseHookSpecificOutput, SDKPostToolUseHookSpecificOutput, SDKPostToolUseFailureHookSpecificOutput, SDKUserPromptSubmitHookSpecificOutput, SDKSessionStartHookSpecificOutput, SDKSetupHookSpecificOutput, SDKSubagentStartHookSpecificOutput, SDKPermissionRequestHookSpecificOutput, };
+export type { SDKElicitationHookSpecificOutput, SDKElicitationResultHookSpecificOutput, SDKNotificationHookSpecificOutput, SDKPermissionRequestHookSpecificOutput, SDKPostToolUseFailureHookSpecificOutput, SDKPostToolUseHookSpecificOutput, SDKPreToolUseHookSpecificOutput, SDKSessionStartHookSpecificOutput, SDKSetupHookSpecificOutput, SDKSubagentStartHookSpecificOutput, SDKSyncHookJSONOutput, SDKUserPromptSubmitHookSpecificOutput, };
 /**
  * PreToolUse hook-specific output fields.
  * Omits `hookEventName` which is added automatically by the builder.
@@ -211,6 +210,10 @@ export type SessionEndOutput = BaseSpecificOutput<"SessionEnd">;
  *
  */
 export type StopOutput = BaseSpecificOutput<"Stop">;
+/**
+ *
+ */
+export type StopFailureOutput = BaseSpecificOutput<"StopFailure">;
 /**
  *
  */
@@ -223,6 +226,10 @@ export type SubagentStopOutput = BaseSpecificOutput<"SubagentStop">;
  *
  */
 export type PreCompactOutput = BaseSpecificOutput<"PreCompact">;
+/**
+ *
+ */
+export type PostCompactOutput = BaseSpecificOutput<"PostCompact">;
 /**
  *
  */
@@ -266,7 +273,7 @@ export type WorktreeRemoveOutput = BaseSpecificOutput<"WorktreeRemove">;
 /**
  * Union of all specific output types.
  */
-export type SpecificHookOutput = PreToolUseOutput | PostToolUseOutput | PostToolUseFailureOutput | NotificationOutput | UserPromptSubmitOutput | SessionStartOutput | SessionEndOutput | StopOutput | SubagentStartOutput | SubagentStopOutput | PreCompactOutput | PermissionRequestOutput | SetupOutput | TeammateIdleOutput | TaskCompletedOutput | ElicitationOutput | ElicitationResultOutput | ConfigChangeOutput | InstructionsLoadedOutput | WorktreeCreateOutput | WorktreeRemoveOutput;
+export type SpecificHookOutput = PreToolUseOutput | PostToolUseOutput | PostToolUseFailureOutput | NotificationOutput | UserPromptSubmitOutput | SessionStartOutput | SessionEndOutput | StopOutput | StopFailureOutput | SubagentStartOutput | SubagentStopOutput | PreCompactOutput | PostCompactOutput | PermissionRequestOutput | SetupOutput | TeammateIdleOutput | TaskCompletedOutput | ElicitationOutput | ElicitationResultOutput | ConfigChangeOutput | InstructionsLoadedOutput | WorktreeCreateOutput | WorktreeRemoveOutput;
 /**
  * Options for decision-based hooks (Stop, SubagentStop).
  */
@@ -470,6 +477,24 @@ export declare const stopOutput: (options?: DecisionOptions) => {
     readonly _type: "Stop";
     stdout: SyncHookJSONOutput;
 };
+/**
+ * Options for the StopFailure output builder.
+ * StopFailure hooks only support common options.
+ */
+export type StopFailureOptions = CommonOptions;
+/**
+ * Creates an output for StopFailure hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A StopFailureOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * stopFailureOutput({});
+ * ```
+ */
+export declare const stopFailureOutput: (options?: CommonOptions) => {
+    readonly _type: "StopFailure";
+    stdout: SyncHookJSONOutput;
+};
 /**
  * Options for the SubagentStart output builder.
  */
@@ -572,6 +597,24 @@ export declare const preCompactOutput: (options?: CommonOptions) => {
     readonly _type: "PreCompact";
     stdout: SyncHookJSONOutput;
 };
+/**
+ * Options for the PostCompact output builder.
+ * PostCompact hooks only support common options.
+ */
+export type PostCompactOptions = CommonOptions;
+/**
+ * Creates an output for PostCompact hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A PostCompactOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * postCompactOutput({});
+ * ```
+ */
+export declare const postCompactOutput: (options?: CommonOptions) => {
+    readonly _type: "PostCompact";
+    stdout: SyncHookJSONOutput;
+};
 /**
  * Options for the PermissionRequest output builder.
  */

package/types/types.d.ts

@@ -12,8 +12,8 @@
  * Re-exports types from @anthropic-ai/claude-agent-sdk with "SDK" prefix.
  * These are used as base types for extension, ensuring synchronization with the SDK.
  */
-export type { BaseHookInput as SDKBaseHookInput, ConfigChangeHookInput as SDKConfigChangeHookInput, ElicitationHookInput as SDKElicitationHookInput, ElicitationResultHookInput as SDKElicitationResultHookInput, HookEvent as SDKHookEvent, HookInput as SDKHookInput, InstructionsLoadedHookInput as SDKInstructionsLoadedHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, TaskCompletedHookInput as SDKTaskCompletedHookInput, TeammateIdleHookInput as SDKTeammateIdleHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput, WorktreeCreateHookInput as SDKWorktreeCreateHookInput, WorktreeRemoveHookInput as SDKWorktreeRemoveHookInput, } from "@anthropic-ai/claude-agent-sdk";
-import type { BaseHookInput as SDKBaseHookInput, ConfigChangeHookInput as SDKConfigChangeHookInput, ElicitationHookInput as SDKElicitationHookInput, ElicitationResultHookInput as SDKElicitationResultHookInput, InstructionsLoadedHookInput as SDKInstructionsLoadedHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, TaskCompletedHookInput as SDKTaskCompletedHookInput, TeammateIdleHookInput as SDKTeammateIdleHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput, WorktreeCreateHookInput as SDKWorktreeCreateHookInput, WorktreeRemoveHookInput as SDKWorktreeRemoveHookInput } from "@anthropic-ai/claude-agent-sdk";
+export type { BaseHookInput as SDKBaseHookInput, ConfigChangeHookInput as SDKConfigChangeHookInput, ElicitationHookInput as SDKElicitationHookInput, ElicitationResultHookInput as SDKElicitationResultHookInput, HookEvent as SDKHookEvent, HookInput as SDKHookInput, InstructionsLoadedHookInput as SDKInstructionsLoadedHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostCompactHookInput as SDKPostCompactHookInput, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopFailureHookInput as SDKStopFailureHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, TaskCompletedHookInput as SDKTaskCompletedHookInput, TeammateIdleHookInput as SDKTeammateIdleHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput, WorktreeCreateHookInput as SDKWorktreeCreateHookInput, WorktreeRemoveHookInput as SDKWorktreeRemoveHookInput, } from "@anthropic-ai/claude-agent-sdk";
+import type { BaseHookInput as SDKBaseHookInput, ConfigChangeHookInput as SDKConfigChangeHookInput, ElicitationHookInput as SDKElicitationHookInput, ElicitationResultHookInput as SDKElicitationResultHookInput, InstructionsLoadedHookInput as SDKInstructionsLoadedHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostCompactHookInput as SDKPostCompactHookInput, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopFailureHookInput as SDKStopFailureHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, TaskCompletedHookInput as SDKTaskCompletedHookInput, TeammateIdleHookInput as SDKTeammateIdleHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput, WorktreeCreateHookInput as SDKWorktreeCreateHookInput, WorktreeRemoveHookInput as SDKWorktreeRemoveHookInput } from "@anthropic-ai/claude-agent-sdk";
 import type { AgentInput, AskUserQuestionInput, BashInput, ConfigInput, ExitPlanModeInput, FileEditInput, FileReadInput, FileWriteInput, GlobInput, GrepInput, TaskStopInput as KillShellInput, ListMcpResourcesInput, McpInput, NotebookEditInput, ReadMcpResourceInput, TaskOutputInput, TodoWriteInput, WebFetchInput, WebSearchInput } from "@anthropic-ai/claude-agent-sdk/sdk-tools.js";
 /**
  * Permission mode for controlling how tool executions are handled.
@@ -42,6 +42,7 @@ export type PreCompactTrigger = "manual" | "auto";
  * Reason for session end events.
  *
  * - `'clear'` - Session cleared by user
+ * - `'resume'` - Session resumed from a previous session
  * - `'logout'` - User logged out
  * - `'prompt_input_exit'` - User exited at prompt input
  * - `'other'` - Other reasons
@@ -49,7 +50,7 @@ export type PreCompactTrigger = "manual" | "auto";
  *
  * Note: SDK's ExitReason resolves to string. This type provides concrete literals for better DX.
  */
-export type SessionEndReason = "clear" | "logout" | "prompt_input_exit" | "other" | "bypass_permissions_disabled";
+export type SessionEndReason = "clear" | "resume" | "logout" | "prompt_input_exit" | "other" | "bypass_permissions_disabled";
 /**
  * Common fields present in all hook inputs.
  *
@@ -123,6 +124,18 @@ export type SessionStartInput = {
 export type StopInput = {
     [K in keyof SDKStopHookInput]: SDKStopHookInput[K];
 } & {};
+/**
+ * Input for StopFailure hooks.
+ *
+ * Fires when Claude Code encounters an error while stopping (e.g., API errors,
+ * rate limits, authentication failures), allowing you to:
+ * - Log stop failure events and error details
+ * - Alert on unexpected session termination errors
+ * @see https://code.claude.com/docs/en/hooks#stopfailure
+ */
+export type StopFailureInput = {
+    [K in keyof SDKStopFailureHookInput]: SDKStopFailureHookInput[K];
+} & {};
 /**
  * Input for SubagentStart hooks.
  * @see https://code.claude.com/docs/en/hooks#subagentstart
@@ -144,6 +157,18 @@ export type SubagentStopInput = {
 export type PreCompactInput = {
     [K in keyof SDKPreCompactHookInput]: SDKPreCompactHookInput[K];
 } & {};
+/**
+ * Input for PostCompact hooks.
+ *
+ * Fires after context compaction completes, allowing you to:
+ * - Observe the compaction summary
+ * - Log compaction events with context details
+ * - React to the new compacted state
+ * @see https://code.claude.com/docs/en/hooks#postcompact
+ */
+export type PostCompactInput = {
+    [K in keyof SDKPostCompactHookInput]: SDKPostCompactHookInput[K];
+} & {};
 /**
  * Input for Setup hooks.
  * @see https://code.claude.com/docs/en/hooks#setup
@@ -327,7 +352,7 @@ export type SetupTrigger = "init" | "maintenance";
  * ```
  * @see https://code.claude.com/docs/en/hooks
  */
-export type HookInput = PreToolUseInput | PostToolUseInput | PostToolUseFailureInput | NotificationInput | UserPromptSubmitInput | SessionStartInput | SessionEndInput | StopInput | SubagentStartInput | SubagentStopInput | PreCompactInput | PermissionRequestInput | SetupInput | TeammateIdleInput | TaskCompletedInput | ElicitationInput | ElicitationResultInput | ConfigChangeInput | InstructionsLoadedInput | WorktreeCreateInput | WorktreeRemoveInput;
+export type HookInput = PreToolUseInput | PostToolUseInput | PostToolUseFailureInput | NotificationInput | UserPromptSubmitInput | SessionStartInput | SessionEndInput | StopInput | StopFailureInput | SubagentStartInput | SubagentStopInput | PreCompactInput | PostCompactInput | PermissionRequestInput | SetupInput | TeammateIdleInput | TaskCompletedInput | ElicitationInput | ElicitationResultInput | ConfigChangeInput | InstructionsLoadedInput | WorktreeCreateInput | WorktreeRemoveInput;
 /**
  * Hook event name literal union.
  *
@@ -345,7 +370,7 @@ export type HookEventName = HookInput["hook_event_name"];
  * }
  * ```
  */
-export declare const HOOK_EVENT_NAMES: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "InstructionsLoaded", "WorktreeCreate", "WorktreeRemove"];
+export declare const HOOK_EVENT_NAMES: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "InstructionsLoaded", "WorktreeCreate", "WorktreeRemove"];
 export type { SDKPermissionUpdate as PermissionUpdate };
 /**
  * Re-export all tool input types from the official Claude Agent SDK.