cc-hooks-ts 2.1.87 → 2.1.91

package/README.md

@@ -102,7 +102,7 @@ Then, load defined hooks in your Claude Code settings at `~/.claude/settings.jso
 
 ## Tool Specific Hooks
 
-In `PreToolUse`, `PostToolUse`, and `PostToolUseFailure` events, you can define hooks specific to tools by specifying tool names in the trigger configuration.
+In `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, and `PermissionDenied` events, you can define hooks specific to tools by specifying tool names in the trigger configuration.
 
 For example, you can create a hook that only runs before the `Read` tool is used:
 
@@ -147,6 +147,24 @@ Then configure it in Claude Code settings:
 }
 ```
 
+The same trigger shape also works for permission hooks:
+
+```typescript
+const permissionRequestHook = defineHook({
+  trigger: { PermissionRequest: { Bash: true } },
+  run: (context) => {
+    // context.input.tool_input is typed as BashInput
+    const { command } = context.input.tool_input;
+
+    if (command.includes("rm -rf")) {
+      return context.blockingError("Refusing destructive command");
+    }
+
+    return context.success();
+  },
+});
+```
+
 ### Custom Tool Types Support
 
 You can add support for custom tools by extending the tool type definitions.

package/dist/index.d.mts

@@ -212,7 +212,7 @@ declare const HookInputSchemas: {
       readonly type: v.LiteralSchema<"removeRules", undefined>;
     }, undefined>, v.ObjectSchema<{
       readonly destination: v.PicklistSchema<["userSettings", "projectSettings", "localSettings", "session", "cliArg"], undefined>;
-      readonly mode: v.PicklistSchema<["acceptEdits", "bypassPermissions", "default", "dontAsk", "plan"], undefined>;
+      readonly mode: v.PicklistSchema<["acceptEdits", "bypassPermissions", "default", "dontAsk", "plan", "auto"], undefined>;
       readonly type: v.LiteralSchema<"setMode", undefined>;
     }, undefined>, v.ObjectSchema<{
       readonly destination: v.PicklistSchema<["userSettings", "projectSettings", "localSettings", "session", "cliArg"], undefined>;
@@ -410,8 +410,8 @@ type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" |
 //#endregion
 //#region src/hooks/input/types.d.ts
 /**
- * Internal type that combines base hook inputs with tool-specific inputs for PreToolUse events.
- * For non-PreToolUse events, this is equivalent to BaseHookInputs.
+ * Internal type that combines base hook inputs with tool-specific inputs for tool-aware events.
+ * For all other events, this is equivalent to BaseHookInputs.
  *
  * @example
  * ```ts
@@ -426,13 +426,17 @@ type HookInput = { [EventKey in SupportedHookEvent]: EventKey extends "PreToolUs
   default: BaseHookInputs["PostToolUse"];
 } : EventKey extends "PostToolUseFailure" ? ToolSpecificPostToolUseFailureInput & {
   default: BaseHookInputs["PostToolUseFailure"];
+} : EventKey extends "PermissionRequest" ? ToolSpecificPermissionRequestInput & {
+  default: BaseHookInputs["PermissionRequest"];
+} : EventKey extends "PermissionDenied" ? ToolSpecificPermissionDeniedInput & {
+  default: BaseHookInputs["PermissionDenied"];
 } : {
   default: BaseHookInputs[EventKey];
 } };
 /**
  * Extracts all possible hook input types for a specific event type.
  * For non-tool-specific events, this returns only the default input type.
- * For tool-specific events (PreToolUse/PostToolUse), this returns a union of all possible inputs including default and tool-specific variants.
+ * For tool-specific events, this returns a union of all possible inputs including default and tool-specific variants.
  *
  * @example
  * ```ts
@@ -486,6 +490,14 @@ type ToolSpecificPostToolUseFailureInput = { [K in keyof ToolSchema]: Omit<BaseH
   tool_input: ToolSchema[K]["input"];
   tool_name: K;
 } };
+type ToolSpecificPermissionRequestInput = { [K in keyof ToolSchema]: Omit<BaseHookInputs["PermissionRequest"], "tool_input" | "tool_name"> & {
+  tool_input: ToolSchema[K]["input"];
+  tool_name: K;
+} };
+type ToolSpecificPermissionDeniedInput = { [K in keyof ToolSchema]: Omit<BaseHookInputs["PermissionDenied"], "tool_input" | "tool_name"> & {
+  tool_input: ToolSchema[K]["input"];
+  tool_name: K;
+} };
 //#endregion
 //#region src/hooks/permission.d.ts
 /**
@@ -517,7 +529,7 @@ declare const permissionUpdateSchema: v.VariantSchema<"type", [v.ObjectSchema<{
   readonly type: v.LiteralSchema<"removeRules", undefined>;
 }, undefined>, v.ObjectSchema<{
   readonly destination: v.PicklistSchema<["userSettings", "projectSettings", "localSettings", "session", "cliArg"], undefined>;
-  readonly mode: v.PicklistSchema<["acceptEdits", "bypassPermissions", "default", "dontAsk", "plan"], undefined>;
+  readonly mode: v.PicklistSchema<["acceptEdits", "bypassPermissions", "default", "dontAsk", "plan", "auto"], undefined>;
   readonly type: v.LiteralSchema<"setMode", undefined>;
 }, undefined>, v.ObjectSchema<{
   readonly destination: v.PicklistSchema<["userSettings", "projectSettings", "localSettings", "session", "cliArg"], undefined>;
@@ -640,8 +652,9 @@ interface PreToolUseHookOutput extends CommonHookOutputs {
      * - `allow` bypasses the permission system. `permissionDecisionReason` is shown to the user but not to Claude.
      * - `deny` prevents the tool call from executing. `permissionDecisionReason` is shown to Claude.
      * - `ask` asks the user to confirm the tool call in the UI. `permissionDecisionReason` is shown to the user but not to Claude.
+     * - `defer` exits gracefully so the tool can be resumed later.
      */
-    permissionDecision?: "allow" | "ask" | "deny";
+    permissionDecision?: "allow" | "ask" | "deny" | "defer";
     permissionDecisionReason?: string;
     updatedInput?: Record<string, unknown>;
     additionalContext?: string;

package/dist/index.mjs

@@ -134,7 +134,8 @@ const permissionUpdateSchema = v.variant("type", [
 			"bypassPermissions",
 			"default",
 			"dontAsk",
-			"plan"
+			"plan",
+			"auto"
 		]),
 		type: v.literal("setMode")
 	}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hooks-ts",
-  "version": "2.1.87",
+  "version": "2.1.91",
   "type": "module",
   "description": "Write claude code hooks with type safety",
   "sideEffects": false,
@@ -62,7 +62,7 @@
     "vitest": "4.1.2"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.2.88",
+    "@anthropic-ai/claude-agent-sdk": "0.2.91",
     "get-stdin": "10.0.0",
     "valibot": "^1.1.0"
   },