@goodfoot/claude-code-hooks 1.0.23 → 1.2.0

package/dist/cli.js

@@ -863,7 +863,7 @@ async function main() {
         const hookFiles = await discoverHookFiles(args.input, cwd);
         log("info", `Discovered ${hookFiles.length} hook files`, { files: hookFiles });
         if (hookFiles.length === 0) {
-            process.stderr.write(`No hook files found matching pattern: ${args.input}\n`);
+            process.stderr.write(`Error: No hook files found matching pattern: ${args.input}\n`);
             process.exit(1);
         }
         // Read existing hooks.json to preserve non-generated hooks
@@ -880,8 +880,8 @@ async function main() {
         }
         // Compile all hooks
         const compiledHooks = await compileAllHooks({ hookFiles, outputDir: buildDir, logFilePath });
-        if (compiledHooks.length === 0) {
-            process.stderr.write("No valid hooks found in discovered files.\n");
+        if (compiledHooks.length === 0 && hookFiles.length > 0) {
+            process.stderr.write("Error: No valid hooks found in discovered files.\n");
             process.exit(1);
         }
         // Auto-detect hook context based on output path

package/dist/constants.js

@@ -21,4 +21,10 @@ export const HOOK_FACTORY_TO_EVENT = {
     setupHook: "Setup",
     teammateIdleHook: "TeammateIdle",
     taskCompletedHook: "TaskCompleted",
+    elicitationHook: "Elicitation",
+    elicitationResultHook: "ElicitationResult",
+    configChangeHook: "ConfigChange",
+    instructionsLoadedHook: "InstructionsLoaded",
+    worktreeCreateHook: "WorktreeCreate",
+    worktreeRemoveHook: "WorktreeRemove",
 };

package/dist/hooks.js

@@ -499,3 +499,180 @@ export function teammateIdleHook(config, handler) {
 export function taskCompletedHook(config, handler) {
     return createHookFunction("TaskCompleted", config, handler);
 }
+// ============================================================================
+// Elicitation Hook Factory
+// ============================================================================
+/**
+ * Creates an Elicitation hook handler.
+ *
+ * Elicitation hooks fire when an MCP server requests user input, allowing you to:
+ * - Accept, decline, or cancel elicitation requests programmatically
+ * - Provide structured form input or URL-based auth responses
+ * - Log or audit elicitation requests
+ *
+ * **Matcher**: No matcher support - fires on all elicitation events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { elicitationHook, elicitationOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default elicitationHook({}, async (input, { logger }) => {
+ *   logger.info('Elicitation request', { server: input.mcp_server_name });
+ *   return elicitationOutput({
+ *     hookSpecificOutput: { action: 'accept', content: { approved: true } }
+ *   });
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#elicitation
+ */
+export function elicitationHook(config, handler) {
+    return createHookFunction("Elicitation", config, handler);
+}
+// ============================================================================
+// ElicitationResult Hook Factory
+// ============================================================================
+/**
+ * Creates an ElicitationResult hook handler.
+ *
+ * ElicitationResult hooks fire with the result of an MCP elicitation request,
+ * allowing you to:
+ * - Observe elicitation outcomes
+ * - Modify the result before it is returned to the MCP server
+ * - Log elicitation completions
+ *
+ * **Matcher**: No matcher support - fires on all elicitation result events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { elicitationResultHook, elicitationResultOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default elicitationResultHook({}, async (input, { logger }) => {
+ *   logger.info('Elicitation result', { action: input.action });
+ *   return elicitationResultOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#elicitationresult
+ */
+export function elicitationResultHook(config, handler) {
+    return createHookFunction("ElicitationResult", config, handler);
+}
+// ============================================================================
+// ConfigChange Hook Factory
+// ============================================================================
+/**
+ * Creates a ConfigChange hook handler.
+ *
+ * ConfigChange hooks fire when Claude Code configuration changes, allowing you to:
+ * - React to settings file changes
+ * - Log or audit configuration changes
+ * - Apply custom logic when settings are updated
+ *
+ * **Matcher**: Matches against `source` ('user_settings', 'project_settings', etc.)
+ * @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 { configChangeHook, configChangeOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default configChangeHook({}, async (input, { logger }) => {
+ *   logger.info('Config changed', { source: input.source, file: input.file_path });
+ *   return configChangeOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#configchange
+ */
+export function configChangeHook(config, handler) {
+    return createHookFunction("ConfigChange", config, handler);
+}
+// ============================================================================
+// InstructionsLoaded Hook Factory
+// ============================================================================
+/**
+ * Creates an InstructionsLoaded hook handler.
+ *
+ * InstructionsLoaded hooks fire when a CLAUDE.md or similar instructions file
+ * is loaded, allowing you to:
+ * - React to instructions being applied
+ * - Log which instruction files are active
+ * - Observe the instruction loading hierarchy
+ *
+ * **Matcher**: No matcher support - fires on all instruction load events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { instructionsLoadedHook, instructionsLoadedOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default instructionsLoadedHook({}, async (input, { logger }) => {
+ *   logger.info('Instructions loaded', { file: input.file_path, type: input.memory_type });
+ *   return instructionsLoadedOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#instructionsloaded
+ */
+export function instructionsLoadedHook(config, handler) {
+    return createHookFunction("InstructionsLoaded", config, handler);
+}
+// ============================================================================
+// WorktreeCreate Hook Factory
+// ============================================================================
+/**
+ * Creates a WorktreeCreate hook handler.
+ *
+ * WorktreeCreate hooks fire when a git worktree is created, allowing you to:
+ * - Set up worktree-specific configuration
+ * - Log worktree creation events
+ * - Initialize worktree resources
+ *
+ * **Matcher**: No matcher support - fires on all worktree creation events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { worktreeCreateHook, worktreeCreateOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default worktreeCreateHook({}, async (input, { logger }) => {
+ *   logger.info('Worktree created', { name: input.name });
+ *   return worktreeCreateOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#worktreecreate
+ */
+export function worktreeCreateHook(config, handler) {
+    return createHookFunction("WorktreeCreate", config, handler);
+}
+// ============================================================================
+// WorktreeRemove Hook Factory
+// ============================================================================
+/**
+ * Creates a WorktreeRemove hook handler.
+ *
+ * WorktreeRemove hooks fire when a git worktree is removed, allowing you to:
+ * - Clean up worktree-specific resources
+ * - Log worktree removal events
+ *
+ * **Matcher**: No matcher support - fires on all worktree removal events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { worktreeRemoveHook, worktreeRemoveOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default worktreeRemoveHook({}, async (input, { logger }) => {
+ *   logger.info('Worktree removed', { path: input.worktree_path });
+ *   return worktreeRemoveOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#worktreeremove
+ */
+export function worktreeRemoveHook(config, handler) {
+    return createHookFunction("WorktreeRemove", 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 15 hook types
-export { notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, } from "./hooks.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";
 // Logger exports
 export { LOG_LEVELS, Logger, logger } from "./logger.js";
 // Output builder functions
-export { 
+export { configChangeOutput, 
 // Exit codes
-EXIT_CODES, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, 
-// All 15 output builder functions
-preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, } from "./outputs.js";
+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";
 // Runtime exports - execute function
 export { 
 // Main execute function for compiled hooks

package/dist/outputs.js

@@ -69,6 +69,23 @@ function createDecisionOutputBuilder(hookType) {
         stdout: options,
     });
 }
+/**
+ * Factory for exit-code-based hooks (TeammateIdle, TaskCompleted).
+ *
+ * These hooks don't use JSON decision control (no CommonOptions).
+ * The only option is `stderr` — when present, it triggers exit code 2 (BLOCK).
+ * Stdout always receives `{}` (empty JSON object).
+ * @param hookType - The hook type name used as the _type discriminator
+ * @returns A builder function that creates the output object
+ * @internal
+ */
+function createExitCodeOutputBuilder(hookType) {
+    return ({ stderr } = {}) => ({
+        _type: hookType,
+        stdout: {},
+        ...(stderr !== undefined ? { stderr } : {}),
+    });
+}
 /**
  * Creates an output for PreToolUse hooks.
  * @param options - Configuration options for the hook output
@@ -303,17 +320,94 @@ export const setupOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("Setu
  * @returns A TeammateIdleOutput object ready for the runtime
  * @example
  * ```typescript
+ * // Allow teammate to go idle
  * teammateIdleOutput({});
+ *
+ * // Block with feedback
+ * teammateIdleOutput({ stderr: 'Continue working: unfinished tasks remain.' });
  * ```
  */
-export const teammateIdleOutput = /* @__PURE__ */ createSimpleOutputBuilder("TeammateIdle");
+export const teammateIdleOutput = /* @__PURE__ */ createExitCodeOutputBuilder("TeammateIdle");
 /**
  * Creates an output for TaskCompleted hooks.
  * @param options - Configuration options for the hook output
  * @returns A TaskCompletedOutput object ready for the runtime
  * @example
  * ```typescript
+ * // Allow task completion
  * taskCompletedOutput({});
+ *
+ * // Block with feedback
+ * taskCompletedOutput({ stderr: 'Cannot complete: tests are failing.' });
+ * ```
+ */
+export const taskCompletedOutput = /* @__PURE__ */ createExitCodeOutputBuilder("TaskCompleted");
+/**
+ * Creates an output for Elicitation hooks.
+ * @param options - Configuration options for the hook output
+ * @returns An ElicitationOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * // Accept the elicitation
+ * elicitationOutput({
+ *   hookSpecificOutput: { action: 'accept', content: { username: 'alice' } }
+ * });
+ *
+ * // Decline the elicitation
+ * elicitationOutput({
+ *   hookSpecificOutput: { action: 'decline' }
+ * });
+ * ```
+ */
+export const elicitationOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("Elicitation");
+/**
+ * Creates an output for ElicitationResult hooks.
+ * @param options - Configuration options for the hook output
+ * @returns An ElicitationResultOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * elicitationResultOutput({});
+ * ```
+ */
+export const elicitationResultOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("ElicitationResult");
+/**
+ * Creates an output for ConfigChange hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A ConfigChangeOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * configChangeOutput({});
+ * ```
+ */
+export const configChangeOutput = /* @__PURE__ */ createSimpleOutputBuilder("ConfigChange");
+/**
+ * Creates an output for InstructionsLoaded hooks.
+ * @param options - Configuration options for the hook output
+ * @returns An InstructionsLoadedOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * instructionsLoadedOutput({});
+ * ```
+ */
+export const instructionsLoadedOutput = 
+/* @__PURE__ */ createSimpleOutputBuilder("InstructionsLoaded");
+/**
+ * Creates an output for WorktreeCreate hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A WorktreeCreateOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * worktreeCreateOutput({});
+ * ```
+ */
+export const worktreeCreateOutput = /* @__PURE__ */ createSimpleOutputBuilder("WorktreeCreate");
+/**
+ * Creates an output for WorktreeRemove hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A WorktreeRemoveOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * worktreeRemoveOutput({});
  * ```
  */
-export const taskCompletedOutput = /* @__PURE__ */ createSimpleOutputBuilder("TaskCompleted");
+export const worktreeRemoveOutput = /* @__PURE__ */ createSimpleOutputBuilder("WorktreeRemove");

package/dist/runtime.js

@@ -106,8 +106,8 @@ function handleHandlerError(error) {
 /**
  * Converts a SpecificHookOutput to HookOutput for wire format.
  *
- * SpecificHookOutput types have: { _type, exitCode, stdout, stderr? }
- * HookOutput has: { exitCode, stdout, stderr? }
+ * SpecificHookOutput types have: { _type, stdout, stderr? }
+ * HookOutput has: { stdout, stderr? }
  *
  * Since output builders now produce wire-format directly, this function
  * simply strips the `_type` discriminator field.
@@ -118,11 +118,12 @@ function handleHandlerError(error) {
  * ```typescript
  * const specificOutput = preToolUseOutput({ hookSpecificOutput: { permissionDecision: 'allow' } });
  * const hookOutput = convertToHookOutput(specificOutput);
- * // hookOutput: { exitCode: 0, stdout: { hookSpecificOutput: { ... } } }
+ * // hookOutput: { stdout: { hookSpecificOutput: { ... } } }
  * ```
  */
 export function convertToHookOutput(specificOutput) {
-    return { stdout: specificOutput.stdout };
+    const { stdout, stderr } = specificOutput;
+    return stderr !== undefined ? { stdout, stderr } : { stdout };
 }
 // ============================================================================
 // Execute Function
@@ -216,9 +217,16 @@ export async function execute(hookFn) {
         if (output !== undefined) {
             writeStdout(output.stdout);
         }
-        // Clear logger context
+        // Clean up logger (single cleanup path)
         logger.clearContext();
         logger.close();
+        // Exit-code BLOCK: unlike handler throw (no stdout), this path still writes
+        // structured JSON to stdout (as empty {}) alongside the stderr message.
+        // The caller controls stderr formatting (no appended newline).
+        if (output?.stderr !== undefined) {
+            process.stderr.write(output.stderr);
+            process.exit(EXIT_CODES.BLOCK);
+        }
         // Exit with success (handler errors exit via handleHandlerError with code 2)
         process.exit(EXIT_CODES.SUCCESS);
     }

package/dist/scaffold.js

@@ -52,6 +52,12 @@ const EVENT_TO_OUTPUT_FUNCTION = {
     Setup: "setupOutput",
     TeammateIdle: "teammateIdleOutput",
     TaskCompleted: "taskCompletedOutput",
+    Elicitation: "elicitationOutput",
+    ElicitationResult: "elicitationResultOutput",
+    ConfigChange: "configChangeOutput",
+    InstructionsLoaded: "instructionsLoadedOutput",
+    WorktreeCreate: "worktreeCreateOutput",
+    WorktreeRemove: "worktreeRemoveOutput",
 };
 // ============================================================================
 // Validation
@@ -119,7 +125,7 @@ function generatePackageJson(projectName, outputPath) {
             "@goodfoot/claude-code-hooks": "^1.0.9",
         },
         devDependencies: {
-            "@biomejs/biome": "2.4.1",
+            "@biomejs/biome": "2.4.6",
             "@types/node": "^22.0.0",
             typescript: "^5.9.3",
             vitest: "^4.0.16",
@@ -162,7 +168,7 @@ function generateTsConfig() {
  */
 function generateBiomeConfig() {
     return `{
-  "$schema": "https://biomejs.dev/schemas/2.4.1/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.6/schema.json",
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
@@ -313,6 +319,20 @@ function generateHookTemplate(eventName) {
     systemMessage: "Permission request processed.",
   });`;
             break;
+        case "Elicitation":
+            returnStatement = `return ${outputName}({
+    hookSpecificOutput: { action: "accept" },
+  });`;
+            break;
+        case "ElicitationResult":
+            returnStatement = `return ${outputName}({});`;
+            break;
+        case "ConfigChange":
+        case "InstructionsLoaded":
+        case "WorktreeCreate":
+        case "WorktreeRemove":
+            returnStatement = `return ${outputName}({});`;
+            break;
         default:
             // SessionEnd, Notification, SubagentStart use simple output with systemMessage
             returnStatement = `return ${outputName}({

package/dist/types.js

@@ -35,4 +35,10 @@ export const HOOK_EVENT_NAMES = [
     "Setup",
     "TeammateIdle",
     "TaskCompleted",
+    "Elicitation",
+    "ElicitationResult",
+    "ConfigChange",
+    "InstructionsLoaded",
+    "WorktreeCreate",
+    "WorktreeRemove",
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodfoot/claude-code-hooks",
-  "version": "1.0.23",
+  "version": "1.2.0",
   "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.42",
-    "@biomejs/biome": "2.4.1",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.69",
+    "@biomejs/biome": "2.4.6",
     "@types/node": "^24",
     "ts-morph": "^25.0.0",
     "tsx": "^4.20.3",

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 { NotificationOutput, PermissionRequestOutput, PostToolUseFailureOutput, PostToolUseOutput, PreCompactOutput, PreToolUseOutput, SessionEndOutput, SessionStartOutput, SetupOutput, SpecificHookOutput, StopOutput, SubagentStartOutput, SubagentStopOutput, TaskCompletedOutput, TeammateIdleOutput, UserPromptSubmitOutput } from "./outputs.js";
-import type { HookEventName, KnownToolName, NotificationInput, PermissionRequestInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreToolUseInput, SessionEndInput, SessionStartInput, SetupInput, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput } from "./types.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";
 /**
  * Configuration options for hook factories.
  *
@@ -870,4 +870,151 @@ export declare function teammateIdleHook(config: HookConfig, handler: HookHandle
  * @see https://code.claude.com/docs/en/hooks#taskcompleted
  */
 export declare function taskCompletedHook(config: HookConfig, handler: HookHandler<TaskCompletedInput, TaskCompletedOutput>): HookFunction<TaskCompletedInput, TaskCompletedOutput>;
+/**
+ * Creates an Elicitation hook handler.
+ *
+ * Elicitation hooks fire when an MCP server requests user input, allowing you to:
+ * - Accept, decline, or cancel elicitation requests programmatically
+ * - Provide structured form input or URL-based auth responses
+ * - Log or audit elicitation requests
+ *
+ * **Matcher**: No matcher support - fires on all elicitation events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { elicitationHook, elicitationOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default elicitationHook({}, async (input, { logger }) => {
+ *   logger.info('Elicitation request', { server: input.mcp_server_name });
+ *   return elicitationOutput({
+ *     hookSpecificOutput: { action: 'accept', content: { approved: true } }
+ *   });
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#elicitation
+ */
+export declare function elicitationHook(config: HookConfig, handler: HookHandler<ElicitationInput, ElicitationOutput>): HookFunction<ElicitationInput, ElicitationOutput>;
+/**
+ * Creates an ElicitationResult hook handler.
+ *
+ * ElicitationResult hooks fire with the result of an MCP elicitation request,
+ * allowing you to:
+ * - Observe elicitation outcomes
+ * - Modify the result before it is returned to the MCP server
+ * - Log elicitation completions
+ *
+ * **Matcher**: No matcher support - fires on all elicitation result events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { elicitationResultHook, elicitationResultOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default elicitationResultHook({}, async (input, { logger }) => {
+ *   logger.info('Elicitation result', { action: input.action });
+ *   return elicitationResultOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#elicitationresult
+ */
+export declare function elicitationResultHook(config: HookConfig, handler: HookHandler<ElicitationResultInput, ElicitationResultOutput>): HookFunction<ElicitationResultInput, ElicitationResultOutput>;
+/**
+ * Creates a ConfigChange hook handler.
+ *
+ * ConfigChange hooks fire when Claude Code configuration changes, allowing you to:
+ * - React to settings file changes
+ * - Log or audit configuration changes
+ * - Apply custom logic when settings are updated
+ *
+ * **Matcher**: Matches against `source` ('user_settings', 'project_settings', etc.)
+ * @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 { configChangeHook, configChangeOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default configChangeHook({}, async (input, { logger }) => {
+ *   logger.info('Config changed', { source: input.source, file: input.file_path });
+ *   return configChangeOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#configchange
+ */
+export declare function configChangeHook(config: HookConfig, handler: HookHandler<ConfigChangeInput, ConfigChangeOutput>): HookFunction<ConfigChangeInput, ConfigChangeOutput>;
+/**
+ * Creates an InstructionsLoaded hook handler.
+ *
+ * InstructionsLoaded hooks fire when a CLAUDE.md or similar instructions file
+ * is loaded, allowing you to:
+ * - React to instructions being applied
+ * - Log which instruction files are active
+ * - Observe the instruction loading hierarchy
+ *
+ * **Matcher**: No matcher support - fires on all instruction load events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { instructionsLoadedHook, instructionsLoadedOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default instructionsLoadedHook({}, async (input, { logger }) => {
+ *   logger.info('Instructions loaded', { file: input.file_path, type: input.memory_type });
+ *   return instructionsLoadedOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#instructionsloaded
+ */
+export declare function instructionsLoadedHook(config: HookConfig, handler: HookHandler<InstructionsLoadedInput, InstructionsLoadedOutput>): HookFunction<InstructionsLoadedInput, InstructionsLoadedOutput>;
+/**
+ * Creates a WorktreeCreate hook handler.
+ *
+ * WorktreeCreate hooks fire when a git worktree is created, allowing you to:
+ * - Set up worktree-specific configuration
+ * - Log worktree creation events
+ * - Initialize worktree resources
+ *
+ * **Matcher**: No matcher support - fires on all worktree creation events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { worktreeCreateHook, worktreeCreateOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default worktreeCreateHook({}, async (input, { logger }) => {
+ *   logger.info('Worktree created', { name: input.name });
+ *   return worktreeCreateOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#worktreecreate
+ */
+export declare function worktreeCreateHook(config: HookConfig, handler: HookHandler<WorktreeCreateInput, WorktreeCreateOutput>): HookFunction<WorktreeCreateInput, WorktreeCreateOutput>;
+/**
+ * Creates a WorktreeRemove hook handler.
+ *
+ * WorktreeRemove hooks fire when a git worktree is removed, allowing you to:
+ * - Clean up worktree-specific resources
+ * - Log worktree removal events
+ *
+ * **Matcher**: No matcher support - fires on all worktree removal events
+ * @param config - Hook configuration with optional timeout
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { worktreeRemoveHook, worktreeRemoveOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * export default worktreeRemoveHook({}, async (input, { logger }) => {
+ *   logger.info('Worktree removed', { path: input.worktree_path });
+ *   return worktreeRemoveOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#worktreeremove
+ */
+export declare function worktreeRemoveHook(config: HookConfig, handler: HookHandler<WorktreeRemoveInput, WorktreeRemoveOutput>): HookFunction<WorktreeRemoveInput, WorktreeRemoveOutput>;
 export {};

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 { notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, } 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 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, ExitCode, HookOutput, HookSpecificOutput, 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, } from "./outputs.js";
-export { EXIT_CODES, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, } from "./outputs.js";
+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";
 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, ConfigInput, FileModifyingToolInput, FileModifyingToolName, HookEventName, HookInput, 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, } 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, 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 { HOOK_EVENT_NAMES } from "./types.js";

package/types/outputs.d.ts

@@ -7,6 +7,7 @@
  * @see https://code.claude.com/docs/en/hooks
  * @module
  */
+import type { ElicitationHookSpecificOutput as SDKElicitationHookSpecificOutput, ElicitationResultHookSpecificOutput as SDKElicitationResultHookSpecificOutput } from "@anthropic-ai/claude-agent-sdk";
 import type { NotificationHookSpecificOutput as SDKNotificationHookSpecificOutput, PermissionRequestHookSpecificOutput as SDKPermissionRequestHookSpecificOutput, PostToolUseFailureHookSpecificOutput as SDKPostToolUseFailureHookSpecificOutput, PostToolUseHookSpecificOutput as SDKPostToolUseHookSpecificOutput, PreToolUseHookSpecificOutput as SDKPreToolUseHookSpecificOutput, SessionStartHookSpecificOutput as SDKSessionStartHookSpecificOutput, SetupHookSpecificOutput as SDKSetupHookSpecificOutput, SubagentStartHookSpecificOutput as SDKSubagentStartHookSpecificOutput, SyncHookJSONOutput as SDKSyncHookJSONOutput, UserPromptSubmitHookSpecificOutput as SDKUserPromptSubmitHookSpecificOutput } from "@anthropic-ai/claude-agent-sdk/sdk.js";
 /**
  * Exit codes used by Claude Code hooks.
@@ -36,7 +37,7 @@ export type { SDKSyncHookJSONOutput };
 /**
  * Re-export SDK hook-specific output types (includes hookEventName discriminator).
  */
-export type { SDKNotificationHookSpecificOutput, SDKPreToolUseHookSpecificOutput, SDKPostToolUseHookSpecificOutput, SDKPostToolUseFailureHookSpecificOutput, SDKUserPromptSubmitHookSpecificOutput, SDKSessionStartHookSpecificOutput, SDKSetupHookSpecificOutput, SDKSubagentStartHookSpecificOutput, SDKPermissionRequestHookSpecificOutput, };
+export type { SDKElicitationHookSpecificOutput, SDKElicitationResultHookSpecificOutput, SDKNotificationHookSpecificOutput, SDKPreToolUseHookSpecificOutput, SDKPostToolUseHookSpecificOutput, SDKPostToolUseFailureHookSpecificOutput, SDKUserPromptSubmitHookSpecificOutput, SDKSessionStartHookSpecificOutput, SDKSetupHookSpecificOutput, SDKSubagentStartHookSpecificOutput, SDKPermissionRequestHookSpecificOutput, };
 /**
  * PreToolUse hook-specific output fields.
  * Omits `hookEventName` which is added automatically by the builder.
@@ -77,6 +78,16 @@ export type PermissionRequestHookSpecificOutput = Omit<SDKPermissionRequestHookS
  * Omits `hookEventName` which is added automatically by the builder.
  */
 export type SetupHookSpecificOutput = Omit<SDKSetupHookSpecificOutput, "hookEventName">;
+/**
+ * Elicitation hook-specific output fields.
+ * Omits `hookEventName` which is added automatically by the builder.
+ */
+export type ElicitationHookSpecificOutput = Omit<SDKElicitationHookSpecificOutput, "hookEventName">;
+/**
+ * ElicitationResult hook-specific output fields.
+ * Omits `hookEventName` which is added automatically by the builder.
+ */
+export type ElicitationResultHookSpecificOutput = Omit<SDKElicitationResultHookSpecificOutput, "hookEventName">;
 /**
  * Allow decision for permission requests.
  * Derived from SDK's PermissionRequestHookSpecificOutput.
@@ -104,7 +115,7 @@ export type NotificationHookSpecificOutput = Omit<SDKNotificationHookSpecificOut
 /**
  * Full hook-specific output with hookEventName discriminator.
  */
-export type HookSpecificOutput = SDKPreToolUseHookSpecificOutput | SDKPostToolUseHookSpecificOutput | SDKPostToolUseFailureHookSpecificOutput | SDKUserPromptSubmitHookSpecificOutput | SDKSessionStartHookSpecificOutput | SDKSetupHookSpecificOutput | SDKSubagentStartHookSpecificOutput | SDKPermissionRequestHookSpecificOutput | SDKNotificationHookSpecificOutput;
+export type HookSpecificOutput = SDKPreToolUseHookSpecificOutput | SDKPostToolUseHookSpecificOutput | SDKPostToolUseFailureHookSpecificOutput | SDKUserPromptSubmitHookSpecificOutput | SDKSessionStartHookSpecificOutput | SDKSetupHookSpecificOutput | SDKSubagentStartHookSpecificOutput | SDKPermissionRequestHookSpecificOutput | SDKNotificationHookSpecificOutput | SDKElicitationHookSpecificOutput | SDKElicitationResultHookSpecificOutput;
 /**
  * The JSON output format expected by Claude Code (sync hooks only).
  * Extends SDK's SyncHookJSONOutput to include Notification hook support.
@@ -132,6 +143,8 @@ export interface SyncHookJSONOutput {
 export interface HookOutput {
     /** JSON-serializable output to write to stdout. */
     stdout: SyncHookJSONOutput;
+    /** Optional message to write to stderr. When present, the runtime exits with code 2 (BLOCK). */
+    stderr?: string;
 }
 /**
  * Common options available to all output builders.
@@ -147,12 +160,24 @@ export interface CommonOptions {
     /** Reason for stopping/blocking (sets exit code to BLOCK). */
     stopReason?: string;
 }
+/**
+ * Options for exit-code-based hooks (TeammateIdle, TaskCompleted).
+ *
+ * These hooks use exit codes only, not JSON decision control.
+ * When `stderr` is provided, the runtime writes it to stderr and exits with code 2 (BLOCK).
+ * When absent, the hook exits with code 0 (SUCCESS).
+ */
+export interface ExitCodeOptions {
+    /** Message to write to stderr. When present, exits with code 2 (BLOCK). */
+    stderr?: string;
+}
 /**
  * Base structure for all specific outputs.
  */
 interface BaseSpecificOutput<T extends string> {
     readonly _type: T;
     stdout: SyncHookJSONOutput;
+    stderr?: string;
 }
 /**
  *
@@ -214,10 +239,34 @@ export type TeammateIdleOutput = BaseSpecificOutput<"TeammateIdle">;
  *
  */
 export type TaskCompletedOutput = BaseSpecificOutput<"TaskCompleted">;
+/**
+ *
+ */
+export type ElicitationOutput = BaseSpecificOutput<"Elicitation">;
+/**
+ *
+ */
+export type ElicitationResultOutput = BaseSpecificOutput<"ElicitationResult">;
+/**
+ *
+ */
+export type ConfigChangeOutput = BaseSpecificOutput<"ConfigChange">;
+/**
+ *
+ */
+export type InstructionsLoadedOutput = BaseSpecificOutput<"InstructionsLoaded">;
+/**
+ *
+ */
+export type WorktreeCreateOutput = BaseSpecificOutput<"WorktreeCreate">;
+/**
+ *
+ */
+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;
+export type SpecificHookOutput = PreToolUseOutput | PostToolUseOutput | PostToolUseFailureOutput | NotificationOutput | UserPromptSubmitOutput | SessionStartOutput | SessionEndOutput | StopOutput | SubagentStartOutput | SubagentStopOutput | PreCompactOutput | PermissionRequestOutput | SetupOutput | TeammateIdleOutput | TaskCompletedOutput | ElicitationOutput | ElicitationResultOutput | ConfigChangeOutput | InstructionsLoadedOutput | WorktreeCreateOutput | WorktreeRemoveOutput;
 /**
  * Options for decision-based hooks (Stop, SubagentStop).
  */
@@ -606,39 +655,173 @@ export declare const setupOutput: (options?: CommonOptions & {
 };
 /**
  * Options for the TeammateIdle output builder.
- * TeammateIdle hooks only support common options.
+ * TeammateIdle hooks use exit codes only, not JSON decision control.
  */
-export type TeammateIdleOptions = CommonOptions;
+export type TeammateIdleOptions = ExitCodeOptions;
 /**
  * Creates an output for TeammateIdle hooks.
  * @param options - Configuration options for the hook output
  * @returns A TeammateIdleOutput object ready for the runtime
  * @example
  * ```typescript
+ * // Allow teammate to go idle
  * teammateIdleOutput({});
+ *
+ * // Block with feedback
+ * teammateIdleOutput({ stderr: 'Continue working: unfinished tasks remain.' });
  * ```
  */
-export declare const teammateIdleOutput: (options?: CommonOptions) => {
+export declare const teammateIdleOutput: ({ stderr }?: ExitCodeOptions) => {
     readonly _type: "TeammateIdle";
     stdout: SyncHookJSONOutput;
+    stderr?: string;
 };
 /**
  * Options for the TaskCompleted output builder.
- * TaskCompleted hooks only support common options.
+ * TaskCompleted hooks use exit codes only, not JSON decision control.
  */
-export type TaskCompletedOptions = CommonOptions;
+export type TaskCompletedOptions = ExitCodeOptions;
 /**
  * Creates an output for TaskCompleted hooks.
  * @param options - Configuration options for the hook output
  * @returns A TaskCompletedOutput object ready for the runtime
  * @example
  * ```typescript
+ * // Allow task completion
  * taskCompletedOutput({});
+ *
+ * // Block with feedback
+ * taskCompletedOutput({ stderr: 'Cannot complete: tests are failing.' });
  * ```
  */
-export declare const taskCompletedOutput: (options?: CommonOptions) => {
+export declare const taskCompletedOutput: ({ stderr }?: ExitCodeOptions) => {
     readonly _type: "TaskCompleted";
     stdout: SyncHookJSONOutput;
+    stderr?: string;
+};
+/**
+ * Options for the Elicitation output builder.
+ */
+export type ElicitationOptions = CommonOptions & {
+    /** Hook-specific output matching the wire format. */
+    hookSpecificOutput?: ElicitationHookSpecificOutput;
+};
+/**
+ * Creates an output for Elicitation hooks.
+ * @param options - Configuration options for the hook output
+ * @returns An ElicitationOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * // Accept the elicitation
+ * elicitationOutput({
+ *   hookSpecificOutput: { action: 'accept', content: { username: 'alice' } }
+ * });
+ *
+ * // Decline the elicitation
+ * elicitationOutput({
+ *   hookSpecificOutput: { action: 'decline' }
+ * });
+ * ```
+ */
+export declare const elicitationOutput: (options?: CommonOptions & {
+    hookSpecificOutput?: ElicitationHookSpecificOutput | undefined;
+}) => {
+    readonly _type: "Elicitation";
+    stdout: SyncHookJSONOutput;
+};
+/**
+ * Options for the ElicitationResult output builder.
+ */
+export type ElicitationResultOptions = CommonOptions & {
+    /** Hook-specific output matching the wire format. */
+    hookSpecificOutput?: ElicitationResultHookSpecificOutput;
+};
+/**
+ * Creates an output for ElicitationResult hooks.
+ * @param options - Configuration options for the hook output
+ * @returns An ElicitationResultOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * elicitationResultOutput({});
+ * ```
+ */
+export declare const elicitationResultOutput: (options?: CommonOptions & {
+    hookSpecificOutput?: ElicitationResultHookSpecificOutput | undefined;
+}) => {
+    readonly _type: "ElicitationResult";
+    stdout: SyncHookJSONOutput;
+};
+/**
+ * Options for the ConfigChange output builder.
+ * ConfigChange hooks only support common options.
+ */
+export type ConfigChangeOptions = CommonOptions;
+/**
+ * Creates an output for ConfigChange hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A ConfigChangeOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * configChangeOutput({});
+ * ```
+ */
+export declare const configChangeOutput: (options?: CommonOptions) => {
+    readonly _type: "ConfigChange";
+    stdout: SyncHookJSONOutput;
+};
+/**
+ * Options for the InstructionsLoaded output builder.
+ * InstructionsLoaded hooks only support common options.
+ */
+export type InstructionsLoadedOptions = CommonOptions;
+/**
+ * Creates an output for InstructionsLoaded hooks.
+ * @param options - Configuration options for the hook output
+ * @returns An InstructionsLoadedOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * instructionsLoadedOutput({});
+ * ```
+ */
+export declare const instructionsLoadedOutput: (options?: CommonOptions) => {
+    readonly _type: "InstructionsLoaded";
+    stdout: SyncHookJSONOutput;
+};
+/**
+ * Options for the WorktreeCreate output builder.
+ * WorktreeCreate hooks only support common options.
+ */
+export type WorktreeCreateOptions = CommonOptions;
+/**
+ * Creates an output for WorktreeCreate hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A WorktreeCreateOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * worktreeCreateOutput({});
+ * ```
+ */
+export declare const worktreeCreateOutput: (options?: CommonOptions) => {
+    readonly _type: "WorktreeCreate";
+    stdout: SyncHookJSONOutput;
+};
+/**
+ * Options for the WorktreeRemove output builder.
+ * WorktreeRemove hooks only support common options.
+ */
+export type WorktreeRemoveOptions = CommonOptions;
+/**
+ * Creates an output for WorktreeRemove hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A WorktreeRemoveOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * worktreeRemoveOutput({});
+ * ```
+ */
+export declare const worktreeRemoveOutput: (options?: CommonOptions) => {
+    readonly _type: "WorktreeRemove";
+    stdout: SyncHookJSONOutput;
 };
 /**
  * @deprecated Use CommonOptions instead

package/types/runtime.d.ts

@@ -24,8 +24,8 @@ import type { HookInput } from "./types.js";
 /**
  * Converts a SpecificHookOutput to HookOutput for wire format.
  *
- * SpecificHookOutput types have: { _type, exitCode, stdout, stderr? }
- * HookOutput has: { exitCode, stdout, stderr? }
+ * SpecificHookOutput types have: { _type, stdout, stderr? }
+ * HookOutput has: { stdout, stderr? }
  *
  * Since output builders now produce wire-format directly, this function
  * simply strips the `_type` discriminator field.
@@ -36,7 +36,7 @@ import type { HookInput } from "./types.js";
  * ```typescript
  * const specificOutput = preToolUseOutput({ hookSpecificOutput: { permissionDecision: 'allow' } });
  * const hookOutput = convertToHookOutput(specificOutput);
- * // hookOutput: { exitCode: 0, stdout: { hookSpecificOutput: { ... } } }
+ * // hookOutput: { stdout: { hookSpecificOutput: { ... } } }
  * ```
  */
 export declare function convertToHookOutput(specificOutput: SpecificHookOutput): HookOutput;

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, HookEvent as SDKHookEvent, HookInput as SDKHookInput, 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, } from "@anthropic-ai/claude-agent-sdk";
-import type { BaseHookInput as SDKBaseHookInput, 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 } 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, 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";
 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.
@@ -165,6 +165,74 @@ export type TeammateIdleInput = {
 export type TaskCompletedInput = {
     [K in keyof SDKTaskCompletedHookInput]: SDKTaskCompletedHookInput[K];
 } & {};
+/**
+ * Input for Elicitation hooks.
+ *
+ * Fires when an MCP server requests user input (elicitation), allowing you to:
+ * - Intercept and handle MCP server prompts programmatically
+ * - Accept, decline, or cancel elicitation requests
+ * - Provide structured form input or URL-based auth responses
+ * @see https://code.claude.com/docs/en/hooks#elicitation
+ */
+export type ElicitationInput = {
+    [K in keyof SDKElicitationHookInput]: SDKElicitationHookInput[K];
+} & {};
+/**
+ * Input for ElicitationResult hooks.
+ *
+ * Fires with the result of an elicitation request, allowing you to:
+ * - Observe and log elicitation outcomes
+ * - Modify the result before it is returned to the MCP server
+ * @see https://code.claude.com/docs/en/hooks#elicitationresult
+ */
+export type ElicitationResultInput = {
+    [K in keyof SDKElicitationResultHookInput]: SDKElicitationResultHookInput[K];
+} & {};
+/**
+ * Input for ConfigChange hooks.
+ *
+ * Fires when Claude Code configuration changes (settings files, skills), allowing you to:
+ * - React to configuration changes
+ * - Log or audit configuration changes
+ * - Apply custom logic when settings are updated
+ * @see https://code.claude.com/docs/en/hooks#configchange
+ */
+export type ConfigChangeInput = {
+    [K in keyof SDKConfigChangeHookInput]: SDKConfigChangeHookInput[K];
+} & {};
+/**
+ * Input for InstructionsLoaded hooks.
+ *
+ * Fires when a CLAUDE.md (or similar instructions file) is loaded, allowing you to:
+ * - React to instructions being loaded
+ * - Log which instruction files are active for the session
+ * @see https://code.claude.com/docs/en/hooks#instructionsloaded
+ */
+export type InstructionsLoadedInput = {
+    [K in keyof SDKInstructionsLoadedHookInput]: SDKInstructionsLoadedHookInput[K];
+} & {};
+/**
+ * Input for WorktreeCreate hooks.
+ *
+ * Fires when a git worktree is created, allowing you to:
+ * - React to new worktree creation
+ * - Set up worktree-specific configuration
+ * @see https://code.claude.com/docs/en/hooks#worktreecreate
+ */
+export type WorktreeCreateInput = {
+    [K in keyof SDKWorktreeCreateHookInput]: SDKWorktreeCreateHookInput[K];
+} & {};
+/**
+ * Input for WorktreeRemove hooks.
+ *
+ * Fires when a git worktree is removed, allowing you to:
+ * - React to worktree removal
+ * - Clean up worktree-specific resources
+ * @see https://code.claude.com/docs/en/hooks#worktreeremove
+ */
+export type WorktreeRemoveInput = {
+    [K in keyof SDKWorktreeRemoveHookInput]: SDKWorktreeRemoveHookInput[K];
+} & {};
 /**
  * Input for SessionEnd hooks.
  *
@@ -259,7 +327,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;
+export type HookInput = PreToolUseInput | PostToolUseInput | PostToolUseFailureInput | NotificationInput | UserPromptSubmitInput | SessionStartInput | SessionEndInput | StopInput | SubagentStartInput | SubagentStopInput | PreCompactInput | PermissionRequestInput | SetupInput | TeammateIdleInput | TaskCompletedInput | ElicitationInput | ElicitationResultInput | ConfigChangeInput | InstructionsLoadedInput | WorktreeCreateInput | WorktreeRemoveInput;
 /**
  * Hook event name literal union.
  *
@@ -277,7 +345,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"];
+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 type { SDKPermissionUpdate as PermissionUpdate };
 /**
  * Re-export all tool input types from the official Claude Agent SDK.