@goodfoot/claude-code-hooks 1.0.18 → 1.0.20

package/dist/cli.js

@@ -16,7 +16,6 @@
  */
 import * as crypto from "node:crypto";
 import * as fs from "node:fs";
-import * as os from "node:os";
 import * as path from "node:path";
 import * as esbuild from "esbuild";
 import { glob } from "glob";
@@ -374,51 +373,58 @@ async function discoverHookFiles(pattern, cwd) {
 /**
  * Compiles a TypeScript hook file to a self-contained ESM executable.
  *
+ * Uses esbuild's stdin option to avoid writing temporary wrapper files to disk.
+ * This produces stable, reproducible builds by:
+ * - Using a distinct sourcefile name to avoid import resolution conflicts
+ * - Eliminating environment-specific temp paths from source comments
+ *
  * Uses a two-step process to generate stable content hashes:
  * 1. Compile WITHOUT sourcemaps → generate stable content hash
  * 2. Compile WITH sourcemaps → final output content
  *
- * This ensures content hashes are reproducible across different build
- * environments, since sourcemaps contain file paths that can vary.
- *
  * @param options - Compilation options
  * @returns Compiled content and stable content hash
  */
 async function compileHook(options) {
     const { sourcePath, logFilePath } = options;
-    // Create a temporary wrapper file that imports the hook and executes it
-    // Use system temp directory with deterministic name based on hook basename (not full path)
-    // This ensures builds are reproducible across different environments/machines
-    const hashInputs = [path.basename(sourcePath), logFilePath ? "log" : ""].join(":");
-    const buildHash = crypto.createHash("sha256").update(hashInputs).digest("hex").substring(0, 16);
-    const tempDir = path.join(os.tmpdir(), "claude-code-hooks-build", buildHash);
-    const wrapperPath = path.join(tempDir, "wrapper.ts");
-    const tempOutputNoSourcemap = path.join(tempDir, "output-no-sourcemap.mjs");
-    const tempOutputWithSourcemap = path.join(tempDir, "output.mjs");
-    // Get the path to the runtime module (relative to this CLI)
-    const runtimePath = path.resolve(path.dirname(new URL(import.meta.url).pathname), "./runtime.js");
-    // Ensure temp directory exists (don't delete - concurrent builds may be using it)
-    fs.mkdirSync(tempDir, { recursive: true });
+    // Get the path to the runtime module (absolute, then converted to relative)
+    const runtimePathAbsolute = path.resolve(path.dirname(new URL(import.meta.url).pathname), "./runtime.js");
     // Build log file injection code if specified
     const logFileInjection = logFilePath !== undefined
         ? `process.env['CLAUDE_CODE_HOOKS_CLI_LOG_FILE'] = ${JSON.stringify(logFilePath)};\n`
         : "";
-    // Create wrapper that imports the hook and calls execute
+    // Compute relative paths from resolveDir to avoid absolute paths in source maps.
+    // This ensures reproducible builds regardless of checkout directory.
+    const resolveDir = path.dirname(sourcePath);
+    const relativeSourcePath = `./${path.basename(sourcePath)}`;
+    const relativeRuntimePath = path.relative(resolveDir, runtimePathAbsolute);
+    // Create wrapper content that imports the hook and calls execute
+    // Uses relative paths to produce reproducible builds
     const wrapperContent = `${logFileInjection}
-import hook from '${sourcePath.replace(/\\/g, "/")}';
-import { execute } from '${runtimePath.replace(/\\/g, "/")}';
+import hook from '${relativeSourcePath.replace(/\\/g, "/")}';
+import { execute } from '${relativeRuntimePath.replace(/\\/g, "/")}';
 
 execute(hook);
 `;
-    fs.writeFileSync(wrapperPath, wrapperContent, "utf-8");
+    // Use stdin instead of a temp file - sourcefile becomes the stable reference
+    // The sourcefile name must be distinct from the actual source file to avoid
+    // esbuild resolving the import to the stdin content instead of the real file
+    const baseName = path.basename(sourcePath, path.extname(sourcePath));
+    const stdinOptions = {
+        contents: wrapperContent,
+        resolveDir,
+        sourcefile: `${baseName}-entry.ts`,
+        loader: "ts",
+    };
     // Common esbuild options
     const commonOptions = {
-        entryPoints: [wrapperPath],
+        stdin: stdinOptions,
         format: "esm",
         platform: "node",
         target: "node20",
         bundle: true,
         minify: false,
+        write: false, // Return content directly via outputFiles
         // Keep node built-ins external
         external: [
             "node:*",
@@ -444,22 +450,24 @@ execute(hook);
         conditions: ["import", "node"],
     };
     // Step 1: Compile WITHOUT sourcemaps to generate stable content hash
-    await esbuild.build({
+    const resultNoSourcemap = await esbuild.build({
         ...commonOptions,
-        outfile: tempOutputNoSourcemap,
         sourcemap: false,
     });
-    const contentForHash = fs.readFileSync(tempOutputNoSourcemap, "utf-8");
+    const contentForHash = resultNoSourcemap.outputFiles?.[0]?.text;
+    if (contentForHash === undefined) {
+        throw new Error(`esbuild produced no output for ${sourcePath}`);
+    }
     const contentHash = generateContentHash(contentForHash);
     // Step 2: Compile WITH sourcemaps for final output
-    await esbuild.build({
+    const resultWithSourcemap = await esbuild.build({
         ...commonOptions,
-        outfile: tempOutputWithSourcemap,
         sourcemap: "inline",
     });
-    const content = fs.readFileSync(tempOutputWithSourcemap, "utf-8");
-    // Don't delete temp directory - allows concurrent builds of same source
-    // and the OS will clean up /tmp periodically
+    const content = resultWithSourcemap.outputFiles?.[0]?.text;
+    if (content === undefined) {
+        throw new Error(`esbuild produced no output for ${sourcePath}`);
+    }
     return { content, contentHash };
 }
 /**

package/dist/constants.js

@@ -19,4 +19,6 @@ export const HOOK_FACTORY_TO_EVENT = {
     preCompactHook: "PreCompact",
     permissionRequestHook: "PermissionRequest",
     setupHook: "Setup",
+    teammateIdleHook: "TeammateIdle",
+    taskCompletedHook: "TaskCompleted",
 };

package/dist/hooks.js

@@ -429,3 +429,73 @@ export function permissionRequestHook(config, handler) {
 export function setupHook(config, handler) {
     return createHookFunction("Setup", config, handler);
 }
+// ============================================================================
+// TeammateIdle Hook Factory
+// ============================================================================
+/**
+ * Creates a TeammateIdle hook handler.
+ *
+ * TeammateIdle hooks fire when a teammate in a team is about to go idle,
+ * allowing you to:
+ * - Assign work to idle teammates
+ * - Log team activity
+ * - Coordinate multi-agent workflows
+ *
+ * **Matcher**: No matcher support - fires on all teammate idle events
+ * @param config - Hook configuration with optional timeout (matcher is ignored)
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { teammateIdleHook, teammateIdleOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * // Log when teammates go idle
+ * export default teammateIdleHook({}, async (input, { logger }) => {
+ *   logger.info('Teammate going idle', {
+ *     teammateName: input.teammate_name,
+ *     teamName: input.team_name
+ *   });
+ *
+ *   return teammateIdleOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#teammateidle
+ */
+export function teammateIdleHook(config, handler) {
+    return createHookFunction("TeammateIdle", config, handler);
+}
+// ============================================================================
+// TaskCompleted Hook Factory
+// ============================================================================
+/**
+ * Creates a TaskCompleted hook handler.
+ *
+ * TaskCompleted hooks fire when a task is being marked as completed,
+ * allowing you to:
+ * - Verify task completion
+ * - Log task metrics
+ * - Trigger follow-up actions
+ *
+ * **Matcher**: No matcher support - fires on all task completion events
+ * @param config - Hook configuration with optional timeout (matcher is ignored)
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { taskCompletedHook, taskCompletedOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * // Log task completion
+ * export default taskCompletedHook({}, async (input, { logger }) => {
+ *   logger.info('Task completed', {
+ *     taskId: input.task_id,
+ *     taskSubject: input.task_subject
+ *   });
+ *
+ *   return taskCompletedOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#taskcompleted
+ */
+export function taskCompletedHook(config, handler) {
+    return createHookFunction("TaskCompleted", config, handler);
+}

package/dist/index.js

@@ -11,16 +11,16 @@ export {
 CLAUDE_ENV_VARS, getEnvFilePath, 
 // Getters
 getProjectDir, isRemoteEnvironment, } from "./env.js";
-// Hook factory functions - all 13 hook types
-export { notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, userPromptSubmitHook, } from "./hooks.js";
+// Hook factory functions - all 15 hook types
+export { notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, } from "./hooks.js";
 // Logger exports
 export { LOG_LEVELS, Logger, logger } from "./logger.js";
 // Output builder functions
 export { 
 // Exit codes
 EXIT_CODES, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, 
-// All 13 output builder functions
-preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, userPromptSubmitOutput, } from "./outputs.js";
+// All 15 output builder functions
+preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, } from "./outputs.js";
 // Runtime exports - execute function
 export { 
 // Main execute function for compiled hooks

package/dist/outputs.js

@@ -297,3 +297,23 @@ export const permissionRequestOutput = /* @__PURE__ */ createHookSpecificOutputB
  * ```
  */
 export const setupOutput = /* @__PURE__ */ createHookSpecificOutputBuilder("Setup");
+/**
+ * Creates an output for TeammateIdle hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A TeammateIdleOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * teammateIdleOutput({});
+ * ```
+ */
+export const teammateIdleOutput = /* @__PURE__ */ createSimpleOutputBuilder("TeammateIdle");
+/**
+ * Creates an output for TaskCompleted hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A TaskCompletedOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * taskCompletedOutput({});
+ * ```
+ */
+export const taskCompletedOutput = /* @__PURE__ */ createSimpleOutputBuilder("TaskCompleted");

package/dist/scaffold.js

@@ -50,6 +50,8 @@ const EVENT_TO_OUTPUT_FUNCTION = {
     PreCompact: "preCompactOutput",
     PermissionRequest: "permissionRequestOutput",
     Setup: "setupOutput",
+    TeammateIdle: "teammateIdleOutput",
+    TaskCompleted: "taskCompletedOutput",
 };
 // ============================================================================
 // Validation

package/dist/types.js

@@ -33,4 +33,6 @@ export const HOOK_EVENT_NAMES = [
     "PreCompact",
     "PermissionRequest",
     "Setup",
+    "TeammateIdle",
+    "TaskCompleted",
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodfoot/claude-code-hooks",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "Type-safe Claude Code hooks library with camelCase types and output builders",
   "homepage": "https://github.com/goodfoot-io/marketplace/tree/main/packages/claude-code-hooks",
   "repository": {
@@ -53,7 +53,7 @@
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.31",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.37",
     "@biomejs/biome": "2.3.14",
     "@types/node": "^24",
     "ts-morph": "^25.0.0",

package/types/cli.d.ts

@@ -163,13 +163,15 @@ interface CompileHookResult {
 /**
  * Compiles a TypeScript hook file to a self-contained ESM executable.
  *
+ * Uses esbuild's stdin option to avoid writing temporary wrapper files to disk.
+ * This produces stable, reproducible builds by:
+ * - Using a distinct sourcefile name to avoid import resolution conflicts
+ * - Eliminating environment-specific temp paths from source comments
+ *
  * Uses a two-step process to generate stable content hashes:
  * 1. Compile WITHOUT sourcemaps → generate stable content hash
  * 2. Compile WITH sourcemaps → final output content
  *
- * This ensures content hashes are reproducible across different build
- * environments, since sourcemaps contain file paths that can vary.
- *
  * @param options - Compilation options
  * @returns Compiled content and stable content hash
  */

package/types/hooks.d.ts

@@ -22,8 +22,8 @@
  * @see https://code.claude.com/docs/en/hooks
  */
 import type { Logger } from "./logger.js";
-import type { NotificationOutput, PermissionRequestOutput, PostToolUseFailureOutput, PostToolUseOutput, PreCompactOutput, PreToolUseOutput, SessionEndOutput, SessionStartOutput, SetupOutput, SpecificHookOutput, StopOutput, SubagentStartOutput, SubagentStopOutput, UserPromptSubmitOutput } from "./outputs.js";
-import type { HookEventName, KnownToolName, NotificationInput, PermissionRequestInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreToolUseInput, SessionEndInput, SessionStartInput, SetupInput, StopInput, SubagentStartInput, SubagentStopInput, ToolInputMap, UserPromptSubmitInput } from "./types.js";
+import type { NotificationOutput, PermissionRequestOutput, PostToolUseFailureOutput, PostToolUseOutput, PreCompactOutput, PreToolUseOutput, SessionEndOutput, SessionStartOutput, SetupOutput, SpecificHookOutput, StopOutput, SubagentStartOutput, SubagentStopOutput, TaskCompletedOutput, TeammateIdleOutput, UserPromptSubmitOutput } from "./outputs.js";
+import type { HookEventName, KnownToolName, NotificationInput, PermissionRequestInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreToolUseInput, SessionEndInput, SessionStartInput, SetupInput, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput } from "./types.js";
 /**
  * Configuration options for hook factories.
  *
@@ -798,3 +798,63 @@ export declare function permissionRequestHook(config: HookConfig, handler: HookH
  * @see https://code.claude.com/docs/en/hooks#setup
  */
 export declare function setupHook(config: HookConfig, handler: HookHandler<SetupInput, SetupOutput>): HookFunction<SetupInput, SetupOutput>;
+/**
+ * Creates a TeammateIdle hook handler.
+ *
+ * TeammateIdle hooks fire when a teammate in a team is about to go idle,
+ * allowing you to:
+ * - Assign work to idle teammates
+ * - Log team activity
+ * - Coordinate multi-agent workflows
+ *
+ * **Matcher**: No matcher support - fires on all teammate idle events
+ * @param config - Hook configuration with optional timeout (matcher is ignored)
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { teammateIdleHook, teammateIdleOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * // Log when teammates go idle
+ * export default teammateIdleHook({}, async (input, { logger }) => {
+ *   logger.info('Teammate going idle', {
+ *     teammateName: input.teammate_name,
+ *     teamName: input.team_name
+ *   });
+ *
+ *   return teammateIdleOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#teammateidle
+ */
+export declare function teammateIdleHook(config: HookConfig, handler: HookHandler<TeammateIdleInput, TeammateIdleOutput>): HookFunction<TeammateIdleInput, TeammateIdleOutput>;
+/**
+ * Creates a TaskCompleted hook handler.
+ *
+ * TaskCompleted hooks fire when a task is being marked as completed,
+ * allowing you to:
+ * - Verify task completion
+ * - Log task metrics
+ * - Trigger follow-up actions
+ *
+ * **Matcher**: No matcher support - fires on all task completion events
+ * @param config - Hook configuration with optional timeout (matcher is ignored)
+ * @param handler - The handler function to execute
+ * @returns A hook function that can be exported as the default export
+ * @example
+ * ```typescript
+ * import { taskCompletedHook, taskCompletedOutput } from '@goodfoot/claude-code-hooks';
+ *
+ * // Log task completion
+ * export default taskCompletedHook({}, async (input, { logger }) => {
+ *   logger.info('Task completed', {
+ *     taskId: input.task_id,
+ *     taskSubject: input.task_subject
+ *   });
+ *
+ *   return taskCompletedOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#taskcompleted
+ */
+export declare function taskCompletedHook(config: HookConfig, handler: HookHandler<TaskCompletedInput, TaskCompletedOutput>): HookFunction<TaskCompletedInput, TaskCompletedOutput>;

package/types/index.d.ts

@@ -8,15 +8,15 @@
 export type * from "@anthropic-ai/claude-agent-sdk/sdk-tools.js";
 export { CLAUDE_ENV_VARS, getEnvFilePath, getProjectDir, isRemoteEnvironment, } from "./env.js";
 export type { HookConfig, HookContext, HookFunction, HookHandler, SessionStartContext, TypedHookConfig, TypedPermissionRequestInput, TypedPostToolUseFailureInput, TypedPostToolUseInput, TypedPreToolUseInput, } from "./hooks.js";
-export { notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, userPromptSubmitHook, } from "./hooks.js";
+export { notificationHook, permissionRequestHook, postToolUseFailureHook, postToolUseHook, preCompactHook, preToolUseHook, sessionEndHook, sessionStartHook, setupHook, stopHook, subagentStartHook, subagentStopHook, taskCompletedHook, teammateIdleHook, userPromptSubmitHook, } from "./hooks.js";
 export type { LogEvent, LogEventError, LogEventHandler, LoggerConfig, LogLevel, Unsubscribe } from "./logger.js";
 export { LOG_LEVELS, Logger, logger } from "./logger.js";
 export type { 
 /** @deprecated Use CommonOptions instead */
-BaseOptions, CommonOptions, ExitCode, HookOutput, HookSpecificOutput, NotificationOptions, PermissionRequestAllowDecision, PermissionRequestDecision, PermissionRequestDenyDecision, PermissionRequestHookSpecificOutput, PermissionRequestOptions, PostToolUseFailureHookSpecificOutput, PostToolUseFailureOptions, PostToolUseHookSpecificOutput, PostToolUseOptions, PreCompactOptions, PreToolUseHookSpecificOutput, PreToolUseOptions, SessionEndOptions, SessionStartHookSpecificOutput, SessionStartOptions, SetupHookSpecificOutput, SetupOptions, StopOptions, SubagentStartHookSpecificOutput, SubagentStartOptions, SubagentStopOptions, SyncHookJSONOutput, UserPromptSubmitHookSpecificOutput, UserPromptSubmitOptions, } from "./outputs.js";
-export { EXIT_CODES, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, userPromptSubmitOutput, } from "./outputs.js";
+BaseOptions, CommonOptions, ExitCode, HookOutput, HookSpecificOutput, NotificationOptions, PermissionRequestAllowDecision, PermissionRequestDecision, PermissionRequestDenyDecision, PermissionRequestHookSpecificOutput, PermissionRequestOptions, PostToolUseFailureHookSpecificOutput, PostToolUseFailureOptions, PostToolUseHookSpecificOutput, PostToolUseOptions, PreCompactOptions, PreToolUseHookSpecificOutput, PreToolUseOptions, SessionEndOptions, SessionStartHookSpecificOutput, SessionStartOptions, SetupHookSpecificOutput, SetupOptions, StopOptions, SubagentStartHookSpecificOutput, SubagentStartOptions, SubagentStopOptions, SyncHookJSONOutput, TaskCompletedOptions, TeammateIdleOptions, UserPromptSubmitHookSpecificOutput, UserPromptSubmitOptions, } from "./outputs.js";
+export { EXIT_CODES, notificationOutput, permissionRequestOutput, postToolUseFailureOutput, postToolUseOutput, preCompactOutput, preToolUseOutput, sessionEndOutput, sessionStartOutput, setupOutput, stopOutput, subagentStartOutput, subagentStopOutput, taskCompletedOutput, teammateIdleOutput, userPromptSubmitOutput, } from "./outputs.js";
 export { execute, } from "./runtime.js";
 export type { ContentContext, PatternCheckResult, ToolUseInput } from "./tool-helpers.js";
 export { checkContentForPattern, forEachContent, getFilePath, isAskUserQuestionTool, isBashTool, isEditTool, isExitPlanModeTool, isFileModifyingTool, isGlobTool, isGrepTool, isJsTsFile, isKillShellTool, isMultiEditTool, isNotebookEditTool, isReadTool, isTaskOutputTool, isTaskTool, isTodoWriteTool, isTsFile, isWebFetchTool, isWebSearchTool, isWriteTool, } from "./tool-helpers.js";
-export type { BaseHookInput, FileModifyingToolInput, FileModifyingToolName, HookEventName, HookInput, KnownToolInput, KnownToolName, MultiEditEntry, MultiEditToolInput, NotificationInput, PermissionMode, PermissionRequestInput, PermissionUpdate, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreCompactTrigger, PreToolUseInput, SessionEndInput, SessionEndReason, SessionStartInput, SessionStartSource, SetupInput, SetupTrigger, StopInput, SubagentStartInput, SubagentStopInput, ToolInputMap, UserPromptSubmitInput, } from "./types.js";
+export type { BaseHookInput, FileModifyingToolInput, FileModifyingToolName, HookEventName, HookInput, KnownToolInput, KnownToolName, MultiEditEntry, MultiEditToolInput, NotificationInput, PermissionMode, PermissionRequestInput, PermissionUpdate, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreCompactTrigger, PreToolUseInput, SessionEndInput, SessionEndReason, SessionStartInput, SessionStartSource, SetupInput, SetupTrigger, StopInput, SubagentStartInput, SubagentStopInput, TaskCompletedInput, TeammateIdleInput, ToolInputMap, UserPromptSubmitInput, } from "./types.js";
 export { HOOK_EVENT_NAMES } from "./types.js";

package/types/outputs.d.ts

@@ -211,10 +211,18 @@ export type PermissionRequestOutput = BaseSpecificOutput<"PermissionRequest">;
  *
  */
 export type SetupOutput = BaseSpecificOutput<"Setup">;
+/**
+ *
+ */
+export type TeammateIdleOutput = BaseSpecificOutput<"TeammateIdle">;
+/**
+ *
+ */
+export type TaskCompletedOutput = BaseSpecificOutput<"TaskCompleted">;
 /**
  * Union of all specific output types.
  */
-export type SpecificHookOutput = PreToolUseOutput | PostToolUseOutput | PostToolUseFailureOutput | NotificationOutput | UserPromptSubmitOutput | SessionStartOutput | SessionEndOutput | StopOutput | SubagentStartOutput | SubagentStopOutput | PreCompactOutput | PermissionRequestOutput | SetupOutput;
+export type SpecificHookOutput = PreToolUseOutput | PostToolUseOutput | PostToolUseFailureOutput | NotificationOutput | UserPromptSubmitOutput | SessionStartOutput | SessionEndOutput | StopOutput | SubagentStartOutput | SubagentStopOutput | PreCompactOutput | PermissionRequestOutput | SetupOutput | TeammateIdleOutput | TaskCompletedOutput;
 /**
  * Options for decision-based hooks (Stop, SubagentStop).
  */
@@ -601,6 +609,42 @@ export declare const setupOutput: (options?: CommonOptions & {
     readonly _type: "Setup";
     stdout: SyncHookJSONOutput;
 };
+/**
+ * Options for the TeammateIdle output builder.
+ * TeammateIdle hooks only support common options.
+ */
+export type TeammateIdleOptions = CommonOptions;
+/**
+ * Creates an output for TeammateIdle hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A TeammateIdleOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * teammateIdleOutput({});
+ * ```
+ */
+export declare const teammateIdleOutput: (options?: CommonOptions) => {
+    readonly _type: "TeammateIdle";
+    stdout: SyncHookJSONOutput;
+};
+/**
+ * Options for the TaskCompleted output builder.
+ * TaskCompleted hooks only support common options.
+ */
+export type TaskCompletedOptions = CommonOptions;
+/**
+ * Creates an output for TaskCompleted hooks.
+ * @param options - Configuration options for the hook output
+ * @returns A TaskCompletedOutput object ready for the runtime
+ * @example
+ * ```typescript
+ * taskCompletedOutput({});
+ * ```
+ */
+export declare const taskCompletedOutput: (options?: CommonOptions) => {
+    readonly _type: "TaskCompleted";
+    stdout: SyncHookJSONOutput;
+};
 /**
  * @deprecated Use CommonOptions instead
  */

package/types/types.d.ts

@@ -12,8 +12,8 @@
  * Re-exports types from @anthropic-ai/claude-agent-sdk with "SDK" prefix.
  * These are used as base types for extension, ensuring synchronization with the SDK.
  */
-export type { BaseHookInput as SDKBaseHookInput, HookEvent as SDKHookEvent, HookInput as SDKHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput, } from "@anthropic-ai/claude-agent-sdk";
-import type { BaseHookInput as SDKBaseHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput } from "@anthropic-ai/claude-agent-sdk";
+export type { BaseHookInput as SDKBaseHookInput, HookEvent as SDKHookEvent, HookInput as SDKHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, TaskCompletedHookInput as SDKTaskCompletedHookInput, TeammateIdleHookInput as SDKTeammateIdleHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput, } from "@anthropic-ai/claude-agent-sdk";
+import type { BaseHookInput as SDKBaseHookInput, NotificationHookInput as SDKNotificationHookInput, PermissionMode as SDKPermissionMode, PermissionRequestHookInput as SDKPermissionRequestHookInput, PermissionUpdate as SDKPermissionUpdate, PostToolUseFailureHookInput as SDKPostToolUseFailureHookInput, PostToolUseHookInput as SDKPostToolUseHookInput, PreCompactHookInput as SDKPreCompactHookInput, PreToolUseHookInput as SDKPreToolUseHookInput, SessionEndHookInput as SDKSessionEndHookInput, SessionStartHookInput as SDKSessionStartHookInput, SetupHookInput as SDKSetupHookInput, StopHookInput as SDKStopHookInput, SubagentStartHookInput as SDKSubagentStartHookInput, SubagentStopHookInput as SDKSubagentStopHookInput, TaskCompletedHookInput as SDKTaskCompletedHookInput, TeammateIdleHookInput as SDKTeammateIdleHookInput, UserPromptSubmitHookInput as SDKUserPromptSubmitHookInput } from "@anthropic-ai/claude-agent-sdk";
 import type { AgentInput, AskUserQuestionInput, BashInput, ExitPlanModeInput, FileEditInput, FileReadInput, FileWriteInput, GlobInput, GrepInput, TaskStopInput as KillShellInput, NotebookEditInput, TaskOutputInput, TodoWriteInput, WebFetchInput, WebSearchInput } from "@anthropic-ai/claude-agent-sdk/sdk-tools.js";
 /**
  * Permission mode for controlling how tool executions are handled.
@@ -358,6 +358,46 @@ export interface PermissionRequestInput extends SDKPermissionRequestHookInput {
      */
     tool_use_id: string;
 }
+/**
+ * Input for TeammateIdle hooks.
+ *
+ * Fires when a teammate in a team is about to go idle, allowing you to:
+ * - Assign work to idle teammates
+ * - Log team activity
+ * - Coordinate multi-agent workflows
+ *
+ * This hook does not support matchers; it fires on all teammate idle events.
+ * @example
+ * ```typescript
+ * // Assign work to an idle teammate
+ * teammateIdleHook({}, async (input: TeammateIdleInput) => {
+ *   console.log(`${input.teammate_name} is idle in team ${input.team_name}`);
+ *   return teammateIdleOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#teammateidle
+ */
+export type TeammateIdleInput = SDKTeammateIdleHookInput;
+/**
+ * Input for TaskCompleted hooks.
+ *
+ * Fires when a task is being marked as completed, allowing you to:
+ * - Verify task completion
+ * - Log task metrics
+ * - Trigger follow-up actions
+ *
+ * This hook does not support matchers; it fires on all task completion events.
+ * @example
+ * ```typescript
+ * // Log task completion
+ * taskCompletedHook({}, async (input: TaskCompletedInput) => {
+ *   console.log(`Task ${input.task_id}: ${input.task_subject} completed`);
+ *   return taskCompletedOutput({});
+ * });
+ * ```
+ * @see https://code.claude.com/docs/en/hooks#taskcompleted
+ */
+export type TaskCompletedInput = SDKTaskCompletedHookInput;
 /**
  * Trigger type for Setup hooks.
  */
@@ -415,7 +455,7 @@ export type SetupInput = SDKSetupHookInput;
  * ```
  * @see https://code.claude.com/docs/en/hooks
  */
-export type HookInput = PreToolUseInput | PostToolUseInput | PostToolUseFailureInput | NotificationInput | UserPromptSubmitInput | SessionStartInput | SessionEndInput | StopInput | SubagentStartInput | SubagentStopInput | PreCompactInput | PermissionRequestInput | SetupInput;
+export type HookInput = PreToolUseInput | PostToolUseInput | PostToolUseFailureInput | NotificationInput | UserPromptSubmitInput | SessionStartInput | SessionEndInput | StopInput | SubagentStartInput | SubagentStopInput | PreCompactInput | PermissionRequestInput | SetupInput | TeammateIdleInput | TaskCompletedInput;
 /**
  * Hook event name literal union.
  *
@@ -433,7 +473,7 @@ export type HookEventName = HookInput["hook_event_name"];
  * }
  * ```
  */
-export declare const HOOK_EVENT_NAMES: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest", "Setup"];
+export declare const HOOK_EVENT_NAMES: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest", "Setup", "TeammateIdle", "TaskCompleted"];
 export type { SDKPermissionUpdate as PermissionUpdate };
 /**
  * Re-export all tool input types from the official Claude Agent SDK.