cc-hooks-ts 2.1.86 → 2.1.90

package/README.md

@@ -20,6 +20,8 @@ See [examples](./examples) for more usage examples.
   - [Documentation](#documentation)
   - [Development](#development)
     - [How to follow the upstream changes](#how-to-follow-the-upstream-changes)
+      - [If a Dependabot PR already exists](#if-a-dependabot-pr-already-exists)
+      - [If no Dependabot PR exists](#if-no-dependabot-pr-exists)
   - [License](#license)
   - [Contributing](#contributing)
 
@@ -100,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:
 
@@ -145,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.
@@ -277,38 +297,52 @@ pnpm typecheck
 
 ### How to follow the upstream changes
 
-1. Check installed version of `@anthropic-ai/claude-agent-sdk`:
+Dependabot automatically creates PRs to bump `@anthropic-ai/claude-agent-sdk`. The CI bot posts a type diff comment on each PR.
 
-   ```bash
-   npm list @anthropic-ai/claude-agent-sdk
+#### If a Dependabot PR already exists
+
+1. Find the Dependabot PR that bumps `@anthropic-ai/claude-agent-sdk` and check out its branch.
+
+2. Read the type diff posted as a PR comment, then reflect the changes.
+   - Edit `src/hooks/` for changed hook input / output types.
+     - No need for adding tests in most cases since we are testing the whole type definitions in these files:
+       - `src/hooks/input/schemas.test-d.ts`
+       - `src/hooks/output/index.test-d.ts`
+       - `src/hooks/event.test-d.ts`
+       - `src/hooks/permission.test-d.ts`
+   - Edit `src/index.ts` for changed tool input / output types.
+   - YOU SHOULD NOT MODIFY `version` in `package.json` manually.
+
+3. Push to the Dependabot PR branch.
+
+4. Update the PR title to:
+
+   ```plaintext
+   fix: update to parity with Claude Code v$(npm info @anthropic-ai/claude-agent-sdk claudeCodeVersion)
    ```
 
-2. Check the latest version of `@anthropic-ai/claude-agent-sdk`:
+#### If no Dependabot PR exists
+
+1. Create a new branch and bump `@anthropic-ai/claude-agent-sdk` to the latest version:
 
    ```bash
-   npm view @anthropic-ai/claude-agent-sdk version
+   git switch -c bump-claude-agent-sdk
+   pnpm add @anthropic-ai/claude-agent-sdk@latest
    ```
 
-   - If the latest version is the same as your installed version, then there is no upstream change and you are good to go!
-
-3. Get diff of the types.
+2. Get the type diff between the old and new versions:
 
    ```bash
    npm diff --diff=@anthropic-ai/claude-agent-sdk@<old_version> --diff=@anthropic-ai/claude-agent-sdk@<new_version> '**/*.d.ts'
-
-   # Only for humans, You can use dandavison/delta for better diff visualization
-   npm diff --diff=@anthropic-ai/claude-agent-sdk@<old_version> --diff=@anthropic-ai/claude-agent-sdk@<new_version> '**/*.d.ts' | delta --side-by-side
    ```
 
-4. Reflect the changes.
-   - Edit `src/hooks/` for changed hook input / output types.
-     - No need for adding tests in most cases since we are testing the whole type definitions in these files:
-       - `src/hooks/input/schemas.test-d.ts`
-       - `src/hooks/output/index.test-d.ts`
-       - `src/hooks/event.test-d.ts`
-       - `src/hooks/permission.test-d.ts`
-   - Edit `src/index.ts` for changed tool input / output types.
-   - YOU SHOULD NOT MODIFY `version` in `package.json` manually.
+3. Reflect the changes (same as step 2 above).
+
+4. Commit, push, and create a PR with the title:
+
+   ```plaintext
+   fix: update to parity with Claude Code v$(npm info @anthropic-ai/claude-agent-sdk claudeCodeVersion)
+   ```
 
 ## License
 

package/dist/index.d.mts

@@ -226,6 +226,20 @@ declare const HookInputSchemas: {
     tool_input: v.UnknownSchema;
     tool_name: v.StringSchema<undefined>;
   }, undefined>;
+  readonly PermissionDenied: v.ObjectSchema<{
+    readonly agent_id: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly agent_type: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly cwd: v.StringSchema<undefined>;
+    readonly permission_mode: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly session_id: v.StringSchema<undefined>;
+    readonly transcript_path: v.StringSchema<undefined>;
+    readonly hook_event_name: v.LiteralSchema<"PermissionDenied", undefined>;
+  } & {
+    reason: v.StringSchema<undefined>;
+    tool_input: v.UnknownSchema;
+    tool_name: v.StringSchema<undefined>;
+    tool_use_id: v.StringSchema<undefined>;
+  }, undefined>;
   readonly Setup: v.ObjectSchema<{
     readonly agent_id: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly agent_type: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -392,12 +406,12 @@ declare const HookInputSchemas: {
  *
  * @package
  */
-type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "Notification" | "UserPromptSubmit" | "SessionStart" | "SessionEnd" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop" | "PreCompact" | "PostCompact" | "PermissionRequest" | "Setup" | "TeammateIdle" | "TaskCreated" | "TaskCompleted" | "ConfigChange" | "WorktreeCreate" | "WorktreeRemove" | "Elicitation" | "ElicitationResult" | "InstructionsLoaded" | "CwdChanged" | "FileChanged";
+type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "Notification" | "UserPromptSubmit" | "SessionStart" | "SessionEnd" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop" | "PreCompact" | "PostCompact" | "PermissionRequest" | "PermissionDenied" | "Setup" | "TeammateIdle" | "TaskCreated" | "TaskCompleted" | "ConfigChange" | "WorktreeCreate" | "WorktreeRemove" | "Elicitation" | "ElicitationResult" | "InstructionsLoaded" | "CwdChanged" | "FileChanged";
 //#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
@@ -412,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
@@ -472,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
 /**
@@ -530,6 +556,7 @@ type HookOutput = {
   SubagentStart: SubagentStartHookOutput;
   SubagentStop: SubagentStopHookOutput;
   SessionStart: SessionStartHookOutput;
+  PermissionDenied: PermissionDeniedHookOutput;
   PermissionRequest: PermissionRequestHookOutput;
   Setup: SetupHookOutput;
   Notification: NotificationHookOutput;
@@ -625,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;
@@ -772,6 +800,12 @@ interface PermissionRequestHookOutput extends CommonHookOutputs {
     };
   };
 }
+interface PermissionDeniedHookOutput extends CommonHookOutputs {
+  hookSpecificOutput?: {
+    hookEventName: "PermissionDenied";
+    retry?: boolean;
+  };
+}
 interface ElicitationHookOutput extends CommonHookOutputs {
   hookSpecificOutput?: {
     action?: "accept" | "decline" | "cancel";

package/dist/index.mjs

@@ -256,6 +256,12 @@ const HookInputSchemas = {
 		tool_input: v.unknown(),
 		tool_name: v.string()
 	}),
+	PermissionDenied: buildHookInputSchema("PermissionDenied", {
+		reason: v.string(),
+		tool_input: v.unknown(),
+		tool_name: v.string(),
+		tool_use_id: v.string()
+	}),
 	Setup: buildHookInputSchema("Setup", { trigger: v.picklist(["init", "maintenance"]) }),
 	TeammateIdle: buildHookInputSchema("TeammateIdle", {
 		team_name: v.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hooks-ts",
-  "version": "2.1.86",
+  "version": "2.1.90",
   "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.86",
+    "@anthropic-ai/claude-agent-sdk": "0.2.90",
     "get-stdin": "10.0.0",
     "valibot": "^1.1.0"
   },