cc-hooks-ts 2.0.45 → 2.0.56

package/dist/index.d.mts

@@ -33,6 +33,19 @@ declare const HookInputSchemas: {
     tool_response: v.UnknownSchema;
     tool_use_id: v.StringSchema<undefined>;
   }, undefined>;
+  readonly PostToolUseFailure: v.ObjectSchema<{
+    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<"PostToolUseFailure", undefined>;
+  } & {
+    tool_name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, AutoComplete<string>>]>;
+    error: v.StringSchema<undefined>;
+    is_interrupt: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    tool_input: v.UnknownSchema;
+    tool_use_id: v.StringSchema<undefined>;
+  }, undefined>;
   readonly Notification: v.ObjectSchema<{
     readonly cwd: v.StringSchema<undefined>;
     readonly permission_mode: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -118,6 +131,43 @@ declare const HookInputSchemas: {
     readonly transcript_path: v.StringSchema<undefined>;
     readonly hook_event_name: v.LiteralSchema<"PermissionRequest", undefined>;
   } & {
+    permission_suggestions: v.ExactOptionalSchema<v.ArraySchema<v.VariantSchema<"type", [v.ObjectSchema<{
+      readonly behavior: v.UnionSchema<[v.LiteralSchema<"allow", undefined>, v.LiteralSchema<"deny", undefined>, v.LiteralSchema<"ask", undefined>], undefined>;
+      readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+      readonly rules: v.ArraySchema<v.ObjectSchema<{
+        readonly ruleContent: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly toolName: v.StringSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly type: v.LiteralSchema<"addRules", undefined>;
+    }, undefined>, v.ObjectSchema<{
+      readonly behavior: v.UnionSchema<[v.LiteralSchema<"allow", undefined>, v.LiteralSchema<"deny", undefined>, v.LiteralSchema<"ask", undefined>], undefined>;
+      readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+      readonly rules: v.ArraySchema<v.ObjectSchema<{
+        readonly ruleContent: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly toolName: v.StringSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly type: v.LiteralSchema<"replaceRules", undefined>;
+    }, undefined>, v.ObjectSchema<{
+      readonly behavior: v.UnionSchema<[v.LiteralSchema<"allow", undefined>, v.LiteralSchema<"deny", undefined>, v.LiteralSchema<"ask", undefined>], undefined>;
+      readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+      readonly rules: v.ArraySchema<v.ObjectSchema<{
+        readonly ruleContent: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly toolName: v.StringSchema<undefined>;
+      }, undefined>, undefined>;
+      readonly type: v.LiteralSchema<"removeRules", undefined>;
+    }, undefined>, v.ObjectSchema<{
+      readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+      readonly mode: v.UnionSchema<[v.LiteralSchema<"acceptEdits", undefined>, v.LiteralSchema<"bypassPermissions", undefined>, v.LiteralSchema<"default", undefined>, v.LiteralSchema<"dontAsk", undefined>, v.LiteralSchema<"plan", undefined>], undefined>;
+      readonly type: v.LiteralSchema<"setMode", undefined>;
+    }, undefined>, v.ObjectSchema<{
+      readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+      readonly directories: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+      readonly type: v.LiteralSchema<"addDirectories", undefined>;
+    }, undefined>, v.ObjectSchema<{
+      readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+      readonly directories: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+      readonly type: v.LiteralSchema<"removeDirectories", undefined>;
+    }, undefined>], undefined>, undefined>, undefined>;
     tool_input: v.UnknownSchema;
     tool_name: v.StringSchema<undefined>;
   }, undefined>;
@@ -129,7 +179,7 @@ declare const HookInputSchemas: {
  *
  * @package
  */
-type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "Notification" | "UserPromptSubmit" | "SessionStart" | "SessionEnd" | "Stop" | "SubagentStart" | "SubagentStop" | "PreCompact" | "PermissionRequest";
+type SupportedHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "Notification" | "UserPromptSubmit" | "SessionStart" | "SessionEnd" | "Stop" | "SubagentStart" | "SubagentStop" | "PreCompact" | "PermissionRequest";
 //#endregion
 //#region src/hooks/input/types.d.ts
 /**
@@ -147,6 +197,8 @@ type HookInput = { [EventKey in SupportedHookEvent]: EventKey extends "PreToolUs
   default: BaseHookInputs["PreToolUse"];
 } : EventKey extends "PostToolUse" ? ToolSpecificPostToolUseInput & {
   default: BaseHookInputs["PostToolUse"];
+} : EventKey extends "PostToolUseFailure" ? ToolSpecificPostToolUseFailureInput & {
+  default: BaseHookInputs["PostToolUseFailure"];
 } : {
   default: BaseHookInputs[EventKey];
 } };
@@ -203,6 +255,53 @@ type ToolSpecificPostToolUseInput = { [K in keyof ToolSchema]: Omit<BaseHookInpu
   tool_name: K;
   tool_response: ToolSchema[K]["response"];
 } };
+type ToolSpecificPostToolUseFailureInput = { [K in keyof ToolSchema]: Omit<BaseHookInputs["PostToolUseFailure"], "tool_input" | "tool_name"> & {
+  tool_input: ToolSchema[K]["input"];
+  tool_name: K;
+} };
+//#endregion
+//#region src/hooks/permission.d.ts
+/**
+ * @package
+ */
+declare const permissionUpdateSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+  readonly behavior: v.UnionSchema<[v.LiteralSchema<"allow", undefined>, v.LiteralSchema<"deny", undefined>, v.LiteralSchema<"ask", undefined>], undefined>;
+  readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+  readonly rules: v.ArraySchema<v.ObjectSchema<{
+    readonly ruleContent: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly toolName: v.StringSchema<undefined>;
+  }, undefined>, undefined>;
+  readonly type: v.LiteralSchema<"addRules", undefined>;
+}, undefined>, v.ObjectSchema<{
+  readonly behavior: v.UnionSchema<[v.LiteralSchema<"allow", undefined>, v.LiteralSchema<"deny", undefined>, v.LiteralSchema<"ask", undefined>], undefined>;
+  readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+  readonly rules: v.ArraySchema<v.ObjectSchema<{
+    readonly ruleContent: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly toolName: v.StringSchema<undefined>;
+  }, undefined>, undefined>;
+  readonly type: v.LiteralSchema<"replaceRules", undefined>;
+}, undefined>, v.ObjectSchema<{
+  readonly behavior: v.UnionSchema<[v.LiteralSchema<"allow", undefined>, v.LiteralSchema<"deny", undefined>, v.LiteralSchema<"ask", undefined>], undefined>;
+  readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+  readonly rules: v.ArraySchema<v.ObjectSchema<{
+    readonly ruleContent: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly toolName: v.StringSchema<undefined>;
+  }, undefined>, undefined>;
+  readonly type: v.LiteralSchema<"removeRules", undefined>;
+}, undefined>, v.ObjectSchema<{
+  readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+  readonly mode: v.UnionSchema<[v.LiteralSchema<"acceptEdits", undefined>, v.LiteralSchema<"bypassPermissions", undefined>, v.LiteralSchema<"default", undefined>, v.LiteralSchema<"dontAsk", undefined>, v.LiteralSchema<"plan", undefined>], undefined>;
+  readonly type: v.LiteralSchema<"setMode", undefined>;
+}, undefined>, v.ObjectSchema<{
+  readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+  readonly directories: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+  readonly type: v.LiteralSchema<"addDirectories", undefined>;
+}, undefined>, v.ObjectSchema<{
+  readonly destination: v.UnionSchema<[v.LiteralSchema<"userSettings", undefined>, v.LiteralSchema<"projectSettings", undefined>, v.LiteralSchema<"localSettings", undefined>, v.LiteralSchema<"session", undefined>, v.LiteralSchema<"cliArg", undefined>], undefined>;
+  readonly directories: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+  readonly type: v.LiteralSchema<"removeDirectories", undefined>;
+}, undefined>], undefined>;
+type PermissionUpdate = v.InferOutput<typeof permissionUpdateSchema>;
 //#endregion
 //#region src/hooks/output/index.d.ts
 /**
@@ -211,6 +310,7 @@ type ToolSpecificPostToolUseInput = { [K in keyof ToolSchema]: Omit<BaseHookInpu
 type HookOutput = {
   PreToolUse: PreToolUseHookOutput;
   PostToolUse: PostToolUseHookOutput;
+  PostToolUseFailure: PostToolUseFailureHookOutput;
   UserPromptSubmit: UserPromptSubmitHookOutput;
   Stop: StopHookOutput;
   SubagentStart: SubagentStartHookOutput;
@@ -302,6 +402,15 @@ interface PostToolUseHookOutput extends CommonHookOutputs {
   };
   reason?: string;
 }
+interface PostToolUseFailureHookOutput extends CommonHookOutputs {
+  hookSpecificOutput?: {
+    hookEventName: "PostToolUseFailure";
+    /**
+     * Adds context for Claude to consider.
+     */
+    additionalContext?: string;
+  };
+}
 /**
  * @see {@link https://docs.anthropic.com/en/docs/claude-code/hooks#userpromptsubmit-decision-control}
  */
@@ -380,6 +489,7 @@ interface PermissionRequestHookOutput extends CommonHookOutputs {
     decision: {
       behavior: "allow";
       updatedInput?: Record<string, unknown>;
+      updatedPermissions?: PermissionUpdate[];
     } | {
       behavior: "deny";
       interrupt?: boolean;

package/dist/index.mjs

@@ -28,6 +28,63 @@ function createContext(input) {
 		})
 	};
 }
+const permissionBehaviorSchema = v.union([
+	v.literal("allow"),
+	v.literal("deny"),
+	v.literal("ask")
+]);
+const permissionUpdateDestinationSchema = v.union([
+	v.literal("userSettings"),
+	v.literal("projectSettings"),
+	v.literal("localSettings"),
+	v.literal("session"),
+	v.literal("cliArg")
+]);
+const permissionRuleValueSchema = v.object({
+	ruleContent: v.exactOptional(v.string()),
+	toolName: v.string()
+});
+const permissionUpdateSchema = v.variant("type", [
+	v.object({
+		behavior: permissionBehaviorSchema,
+		destination: permissionUpdateDestinationSchema,
+		rules: v.array(permissionRuleValueSchema),
+		type: v.literal("addRules")
+	}),
+	v.object({
+		behavior: permissionBehaviorSchema,
+		destination: permissionUpdateDestinationSchema,
+		rules: v.array(permissionRuleValueSchema),
+		type: v.literal("replaceRules")
+	}),
+	v.object({
+		behavior: permissionBehaviorSchema,
+		destination: permissionUpdateDestinationSchema,
+		rules: v.array(permissionRuleValueSchema),
+		type: v.literal("removeRules")
+	}),
+	v.object({
+		destination: permissionUpdateDestinationSchema,
+		mode: v.union([
+			v.literal("acceptEdits"),
+			v.literal("bypassPermissions"),
+			v.literal("default"),
+			v.literal("dontAsk"),
+			v.literal("plan")
+		]),
+		type: v.literal("setMode")
+	}),
+	v.object({
+		destination: permissionUpdateDestinationSchema,
+		directories: v.array(v.string()),
+		type: v.literal("addDirectories")
+	}),
+	v.object({
+		destination: permissionUpdateDestinationSchema,
+		directories: v.array(v.string()),
+		type: v.literal("removeDirectories")
+	})
+]);
 const baseHookInputSchema = v.object({
 	cwd: v.string(),
 	permission_mode: v.exactOptional(v.string()),
@@ -53,6 +110,13 @@ const HookInputSchemas = {
 		tool_response: v.unknown(),
 		tool_use_id: v.string()
 	}),
+	PostToolUseFailure: buildHookInputSchema("PostToolUseFailure", {
+		tool_name: v.pipe(v.string(), v.transform((s) => s)),
+		error: v.string(),
+		is_interrupt: v.exactOptional(v.boolean()),
+		tool_input: v.unknown(),
+		tool_use_id: v.string()
+	}),
 	Notification: buildHookInputSchema("Notification", {
 		message: v.string(),
 		notification_type: v.string(),
@@ -81,6 +145,7 @@ const HookInputSchemas = {
 	]) }),
 	SessionEnd: buildHookInputSchema("SessionEnd", { reason: v.string() }),
 	PermissionRequest: buildHookInputSchema("PermissionRequest", {
+		permission_suggestions: v.exactOptional(v.array(permissionUpdateSchema)),
 		tool_input: v.unknown(),
 		tool_name: v.string()
 	})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hooks-ts",
-  "version": "2.0.45",
+  "version": "2.0.56",
   "type": "module",
   "description": "Write claude code hooks with type safety",
   "sideEffects": false,
@@ -43,7 +43,7 @@
   },
   "devDependencies": {
     "@arethetypeswrong/core": "0.18.2",
-    "@biomejs/biome": "2.3.5",
+    "@biomejs/biome": "2.3.8",
     "@types/node": "24.10.1",
     "@typescript/native-preview": "^7.0.0-dev.20251108.1",
     "@virtual-live-lab/eslint-config": "2.3.1",
@@ -54,15 +54,15 @@
     "publint": "0.3.15",
     "release-it": "19.0.6",
     "release-it-pnpm": "4.6.6",
-    "tsdown": "0.16.4",
+    "tsdown": "0.16.8",
     "type-fest": "5.2.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.46.4",
+    "typescript-eslint": "8.48.0",
     "unplugin-unused": "0.5.6",
-    "vitest": "4.0.9"
+    "vitest": "4.0.14"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.1.45",
+    "@anthropic-ai/claude-agent-sdk": "0.1.56",
     "valibot": "^1.1.0"
   },
   "scripts": {