cc-hooks-ts 2.1.86 → 2.1.87

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)
 
@@ -277,38 +279,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,7 +406,7 @@ 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
 /**
@@ -530,6 +544,7 @@ type HookOutput = {
   SubagentStart: SubagentStartHookOutput;
   SubagentStop: SubagentStopHookOutput;
   SessionStart: SessionStartHookOutput;
+  PermissionDenied: PermissionDeniedHookOutput;
   PermissionRequest: PermissionRequestHookOutput;
   Setup: SetupHookOutput;
   Notification: NotificationHookOutput;
@@ -772,6 +787,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.87",
   "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.88",
     "get-stdin": "10.0.0",
     "valibot": "^1.1.0"
   },