cc-hooks-ts 2.1.77 → 2.1.81

package/README.md

@@ -277,19 +277,30 @@ pnpm typecheck
 
 ### How to follow the upstream changes
 
-1. Install the latest version of `@anthropic-ai/claude-agent-sdk` and run `pnpm run check`.
-   - If the command passes without errors, there are no type changes.
+1. Check installed version of `@anthropic-ai/claude-agent-sdk`:
 
-2. Get diff of the types. This example gets the diff between Claude Code 2.0.69 and 2.0.70:
+   ```bash
+   npm list @anthropic-ai/claude-agent-sdk
+   ```
+
+2. Check the latest version of `@anthropic-ai/claude-agent-sdk`:
+
+   ```bash
+   npm view @anthropic-ai/claude-agent-sdk version
+   ```
+
+   - 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.
 
    ```bash
-   npm diff --diff=@anthropic-ai/claude-agent-sdk@0.1.69 --diff=@anthropic-ai/claude-agent-sdk@0.1.70 '**/*.d.ts'
+   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@0.1.69 --diff=@anthropic-ai/claude-agent-sdk@0.1.70 '**/*.d.ts' | delta --side-by-side
+   npm diff --diff=@anthropic-ai/claude-agent-sdk@<old_version> --diff=@anthropic-ai/claude-agent-sdk@<new_version> '**/*.d.ts' | delta --side-by-side
    ```
 
-3. Reflect the changes.
+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`

package/dist/index.d.mts

@@ -19,7 +19,7 @@ declare const HookInputSchemas: {
     readonly transcript_path: v.StringSchema<undefined>;
     readonly hook_event_name: v.LiteralSchema<"PreToolUse", undefined>;
   } & {
-    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, AutoComplete<string>>]>;
+    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.GuardAction<string, (s: string) => s is AutoComplete<string>, undefined>]>;
     tool_input: v.UnknownSchema;
     tool_use_id: v.StringSchema<undefined>;
   }, undefined>;
@@ -32,7 +32,7 @@ declare const HookInputSchemas: {
     readonly transcript_path: v.StringSchema<undefined>;
     readonly hook_event_name: v.LiteralSchema<"PostToolUse", undefined>;
   } & {
-    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, AutoComplete<string>>]>;
+    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.GuardAction<string, (s: string) => s is AutoComplete<string>, undefined>]>;
     tool_input: v.UnknownSchema;
     tool_response: v.UnknownSchema;
     tool_use_id: v.StringSchema<undefined>;
@@ -46,7 +46,7 @@ declare const HookInputSchemas: {
     readonly transcript_path: v.StringSchema<undefined>;
     readonly hook_event_name: v.LiteralSchema<"PostToolUseFailure", undefined>;
   } & {
-    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, AutoComplete<string>>]>;
+    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.GuardAction<string, (s: string) => s is AutoComplete<string>, undefined>]>;
     error: v.StringSchema<undefined>;
     is_interrupt: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
     tool_input: v.UnknownSchema;
@@ -88,6 +88,19 @@ declare const HookInputSchemas: {
     last_assistant_message: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     stop_hook_active: v.BooleanSchema<undefined>;
   }, undefined>;
+  readonly StopFailure: 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<"StopFailure", undefined>;
+  } & {
+    error: v.PicklistSchema<["authentication_failed", "billing_error", "rate_limit", "invalid_request", "server_error", "unknown", "max_output_tokens"], undefined>;
+    error_details: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    last_assistant_message: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+  }, undefined>;
   readonly SubagentStart: v.ObjectSchema<Omit<{
     readonly agent_id: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly agent_type: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -162,7 +175,7 @@ declare const HookInputSchemas: {
     readonly transcript_path: v.StringSchema<undefined>;
     readonly hook_event_name: v.LiteralSchema<"SessionEnd", undefined>;
   } & {
-    reason: v.PicklistSchema<["clear", "logout", "prompt_input_exit", "other", "bypass_permissions_disabled"], undefined>;
+    reason: v.PicklistSchema<["clear", "resume", "logout", "prompt_input_exit", "other", "bypass_permissions_disabled"], undefined>;
   }, undefined>;
   readonly PermissionRequest: v.ObjectSchema<{
     readonly agent_id: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -340,7 +353,7 @@ declare const HookInputSchemas: {
  *
  * @package
  */
-type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "Notification" | "UserPromptSubmit" | "SessionStart" | "SessionEnd" | "Stop" | "SubagentStart" | "SubagentStop" | "PreCompact" | "PostCompact" | "PermissionRequest" | "Setup" | "TeammateIdle" | "TaskCompleted" | "ConfigChange" | "WorktreeCreate" | "WorktreeRemove" | "Elicitation" | "ElicitationResult" | "InstructionsLoaded";
+type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "Notification" | "UserPromptSubmit" | "SessionStart" | "SessionEnd" | "Stop" | "StopFailure" | "SubagentStart" | "SubagentStop" | "PreCompact" | "PostCompact" | "PermissionRequest" | "Setup" | "TeammateIdle" | "TaskCompleted" | "ConfigChange" | "WorktreeCreate" | "WorktreeRemove" | "Elicitation" | "ElicitationResult" | "InstructionsLoaded";
 //#endregion
 //#region src/hooks/input/types.d.ts
 /**
@@ -474,6 +487,7 @@ type HookOutput = {
   PostToolUseFailure: PostToolUseFailureHookOutput;
   UserPromptSubmit: UserPromptSubmitHookOutput;
   Stop: StopHookOutput;
+  StopFailure: CommonHookOutputs;
   SubagentStart: SubagentStartHookOutput;
   SubagentStop: SubagentStopHookOutput;
   SessionStart: SessionStartHookOutput;
@@ -675,6 +689,7 @@ interface SessionStartHookOutput extends CommonHookOutputs {
      * Adds the string to the context.
      */
     additionalContext?: string;
+    initialUserMessage?: string;
   };
 }
 interface SetupHookOutput extends CommonHookOutputs {

package/dist/index.mjs

@@ -179,18 +179,18 @@ function buildSubagentInputSchema(hook_event_name, entries) {
 */
 const HookInputSchemas = {
 	PreToolUse: buildHookInputSchema("PreToolUse", {
-		tool_name: v.pipe(v.string(), v.transform((s) => s)),
+		tool_name: v.pipe(v.string(), v.guard((s) => true)),
 		tool_input: v.unknown(),
 		tool_use_id: v.string()
 	}),
 	PostToolUse: buildHookInputSchema("PostToolUse", {
-		tool_name: v.pipe(v.string(), v.transform((s) => s)),
+		tool_name: v.pipe(v.string(), v.guard((s) => true)),
 		tool_input: v.unknown(),
 		tool_response: v.unknown(),
 		tool_use_id: v.string()
 	}),
 	PostToolUseFailure: buildHookInputSchema("PostToolUseFailure", {
-		tool_name: v.pipe(v.string(), v.transform((s) => s)),
+		tool_name: v.pipe(v.string(), v.guard((s) => true)),
 		error: v.string(),
 		is_interrupt: v.exactOptional(v.boolean()),
 		tool_input: v.unknown(),
@@ -206,6 +206,19 @@ const HookInputSchemas = {
 		last_assistant_message: v.exactOptional(v.string()),
 		stop_hook_active: v.boolean()
 	}),
+	StopFailure: buildHookInputSchema("StopFailure", {
+		error: v.picklist([
+			"authentication_failed",
+			"billing_error",
+			"rate_limit",
+			"invalid_request",
+			"server_error",
+			"unknown",
+			"max_output_tokens"
+		]),
+		error_details: v.exactOptional(v.string()),
+		last_assistant_message: v.exactOptional(v.string())
+	}),
 	SubagentStart: buildSubagentInputSchema("SubagentStart", {}),
 	SubagentStop: buildSubagentInputSchema("SubagentStop", {
 		agent_transcript_path: v.string(),
@@ -232,6 +245,7 @@ const HookInputSchemas = {
 	}),
 	SessionEnd: buildHookInputSchema("SessionEnd", { reason: v.picklist([
 		"clear",
+		"resume",
 		"logout",
 		"prompt_input_exit",
 		"other",

package/package.json

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