cc-hooks-ts 2.1.94 → 2.1.121

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { AgentInput, AgentOutput, AskUserQuestionInput, AskUserQuestionOutput, BashInput, BashOutput, ConfigInput, ConfigOutput, EnterWorktreeInput, EnterWorktreeOutput, ExitPlanModeInput, ExitPlanModeOutput, ExitWorktreeInput, ExitWorktreeOutput, FileEditInput, FileEditOutput, FileReadInput, FileReadOutput, FileWriteInput, FileWriteOutput, GlobInput, GlobOutput, GrepInput, GrepOutput, ListMcpResourcesInput, ListMcpResourcesOutput, McpInput, McpOutput, NotebookEditInput, NotebookEditOutput, ReadMcpResourceInput, ReadMcpResourceOutput, TaskOutputInput, TaskStopInput, TaskStopOutput, TodoWriteInput, TodoWriteOutput, WebFetchInput, WebFetchOutput, WebSearchInput, WebSearchOutput } from "@anthropic-ai/claude-agent-sdk/sdk-tools";
+import { AgentInput, AgentOutput, AskUserQuestionInput, AskUserQuestionOutput, BashInput, BashOutput, EnterWorktreeInput, EnterWorktreeOutput, ExitPlanModeInput, ExitPlanModeOutput, ExitWorktreeInput, ExitWorktreeOutput, FileEditInput, FileEditOutput, FileReadInput, FileReadOutput, FileWriteInput, FileWriteOutput, GlobInput, GlobOutput, GrepInput, GrepOutput, ListMcpResourcesInput, ListMcpResourcesOutput, McpInput, McpOutput, NotebookEditInput, NotebookEditOutput, ReadMcpResourceInput, ReadMcpResourceOutput, TaskOutputInput, TaskStopInput, TaskStopOutput, TodoWriteInput, TodoWriteOutput, WebFetchInput, WebFetchOutput, WebSearchInput, WebSearchOutput } from "@anthropic-ai/claude-agent-sdk/sdk-tools";
 
 //#region src/utils/types.d.ts
 type Awaitable<T> = Promise<T> | T;
@@ -33,6 +33,7 @@ declare const HookInputSchemas: {
     readonly hook_event_name: v.LiteralSchema<"PostToolUse", undefined>;
   } & {
     tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.GuardAction<string, (s: string) => s is AutoComplete<string>, undefined>]>;
+    duration_ms: v.ExactOptionalSchema<v.NumberSchema<undefined>, undefined>;
     tool_input: v.UnknownSchema;
     tool_response: v.UnknownSchema;
     tool_use_id: v.StringSchema<undefined>;
@@ -47,11 +48,28 @@ declare const HookInputSchemas: {
     readonly hook_event_name: v.LiteralSchema<"PostToolUseFailure", undefined>;
   } & {
     tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.GuardAction<string, (s: string) => s is AutoComplete<string>, undefined>]>;
+    duration_ms: v.ExactOptionalSchema<v.NumberSchema<undefined>, undefined>;
     error: v.StringSchema<undefined>;
     is_interrupt: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
     tool_input: v.UnknownSchema;
     tool_use_id: v.StringSchema<undefined>;
   }, undefined>;
+  readonly PostToolBatch: 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<"PostToolBatch", undefined>;
+  } & {
+    tool_calls: v.ArraySchema<v.ObjectSchema<{
+      readonly tool_input: v.UnknownSchema;
+      readonly tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.GuardAction<string, (s: string) => s is AutoComplete<string>, undefined>]>;
+      readonly tool_response: v.ExactOptionalSchema<v.UnknownSchema, undefined>;
+      readonly tool_use_id: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+  }, undefined>;
   readonly Notification: v.ObjectSchema<{
     readonly agent_id: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly agent_type: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -77,6 +95,21 @@ declare const HookInputSchemas: {
     prompt: v.StringSchema<undefined>;
     session_title: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
   }, undefined>;
+  readonly UserPromptExpansion: 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<"UserPromptExpansion", undefined>;
+  } & {
+    command_args: v.StringSchema<undefined>;
+    command_name: v.StringSchema<undefined>;
+    command_source: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    expansion_type: v.PicklistSchema<["slash_command", "mcp_prompt"], undefined>;
+    prompt: v.StringSchema<undefined>;
+  }, undefined>;
   readonly Stop: v.ObjectSchema<{
     readonly agent_id: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly agent_type: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -407,7 +440,7 @@ declare const HookInputSchemas: {
  *
  * @package
  */
-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";
+type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "PostToolBatch" | "Notification" | "UserPromptSubmit" | "UserPromptExpansion" | "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
 /**
@@ -431,6 +464,8 @@ type HookInput = { [EventKey in SupportedHookEvent]: EventKey extends "PreToolUs
   default: BaseHookInputs["PermissionRequest"];
 } : EventKey extends "PermissionDenied" ? ToolSpecificPermissionDeniedInput & {
   default: BaseHookInputs["PermissionDenied"];
+} : EventKey extends "PostToolBatch" ? {
+  default: PostToolBatchInput;
 } : {
   default: BaseHookInputs[EventKey];
 } };
@@ -499,6 +534,15 @@ type ToolSpecificPermissionDeniedInput = { [K in keyof ToolSchema]: Omit<BaseHoo
   tool_input: ToolSchema[K]["input"];
   tool_name: K;
 } };
+type BatchedToolCall = { [K in keyof ToolSchema]: {
+  tool_input: ToolSchema[K]["input"];
+  tool_name: K;
+  tool_response?: ToolSchema[K]["response"];
+  tool_use_id: string;
+} }[keyof ToolSchema];
+type PostToolBatchInput = Omit<BaseHookInputs["PostToolBatch"], "tool_calls"> & {
+  tool_calls: BatchedToolCall[];
+};
 //#endregion
 //#region src/hooks/permission.d.ts
 /**
@@ -551,6 +595,8 @@ type HookOutput = {
   PreToolUse: PreToolUseHookOutput;
   PostToolUse: PostToolUseHookOutput;
   PostToolUseFailure: PostToolUseFailureHookOutput;
+  PostToolBatch: PostToolBatchHookOutput;
+  UserPromptExpansion: UserPromptExpansionHookOutput;
   UserPromptSubmit: UserPromptSubmitHookOutput;
   Stop: StopHookOutput;
   StopFailure: CommonHookOutputs;
@@ -676,6 +722,13 @@ interface PostToolUseHookOutput extends CommonHookOutputs {
      * Adds context for Claude to consider.
      */
     additionalContext?: string;
+    /**
+     * Replaces the tool output before it is sent to the model.
+     */
+    updatedToolOutput?: unknown;
+    /**
+     * Replaces the output for MCP tools only. Prefer `updatedToolOutput`, which works for all tools.
+     */
     updatedMCPToolOutput?: unknown;
   };
   reason?: string;
@@ -689,6 +742,27 @@ interface PostToolUseFailureHookOutput extends CommonHookOutputs {
     additionalContext?: string;
   };
 }
+interface PostToolBatchHookOutput extends CommonHookOutputs {
+  hookSpecificOutput?: {
+    hookEventName: "PostToolBatch";
+    /**
+     * Adds context for Claude to consider.
+     */
+    additionalContext?: string;
+  };
+}
+/**
+ * @see {@link https://docs.anthropic.com/en/docs/claude-code/hooks#userpromptsubmit-decision-control}
+ */
+interface UserPromptExpansionHookOutput extends CommonHookOutputs {
+  hookSpecificOutput?: {
+    hookEventName: "UserPromptExpansion";
+    /**
+     * Adds the string to the context.
+     */
+    additionalContext?: string;
+  };
+}
 /**
  * @see {@link https://docs.anthropic.com/en/docs/claude-code/hooks#userpromptsubmit-decision-control}
  */
@@ -1213,10 +1287,6 @@ interface ToolSchema {
     input: BashInput;
     response: BashOutput;
   };
-  Config: {
-    input: ConfigInput;
-    response: ConfigOutput;
-  };
   Edit: {
     input: FileEditInput;
     response: FileEditOutput;

package/dist/index.mjs

@@ -186,17 +186,25 @@ const HookInputSchemas = {
 	}),
 	PostToolUse: buildHookInputSchema("PostToolUse", {
 		tool_name: v.pipe(v.string(), v.guard((s) => true)),
+		duration_ms: v.exactOptional(v.number()),
 		tool_input: v.unknown(),
 		tool_response: v.unknown(),
 		tool_use_id: v.string()
 	}),
 	PostToolUseFailure: buildHookInputSchema("PostToolUseFailure", {
 		tool_name: v.pipe(v.string(), v.guard((s) => true)),
+		duration_ms: v.exactOptional(v.number()),
 		error: v.string(),
 		is_interrupt: v.exactOptional(v.boolean()),
 		tool_input: v.unknown(),
 		tool_use_id: v.string()
 	}),
+	PostToolBatch: buildHookInputSchema("PostToolBatch", { tool_calls: v.array(v.object({
+		tool_input: v.unknown(),
+		tool_name: v.pipe(v.string(), v.guard((s) => true)),
+		tool_response: v.exactOptional(v.unknown()),
+		tool_use_id: v.string()
+	})) }),
 	Notification: buildHookInputSchema("Notification", {
 		message: v.string(),
 		notification_type: v.string(),
@@ -206,6 +214,13 @@ const HookInputSchemas = {
 		prompt: v.string(),
 		session_title: v.exactOptional(v.string())
 	}),
+	UserPromptExpansion: buildHookInputSchema("UserPromptExpansion", {
+		command_args: v.string(),
+		command_name: v.string(),
+		command_source: v.exactOptional(v.string()),
+		expansion_type: v.picklist(["slash_command", "mcp_prompt"]),
+		prompt: v.string()
+	}),
 	Stop: buildHookInputSchema("Stop", {
 		last_assistant_message: v.exactOptional(v.string()),
 		stop_hook_active: v.boolean()

package/package.json

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