claude-ide-bridge 2.19.0 → 2.22.0

package/dist/automation.d.ts

@@ -1,4 +1,5 @@
 import type { ClaudeOrchestrator } from "./claudeOrchestrator.js";
+import type { ExtensionClient } from "./extensionClient.js";
 /**
  * Shared fields for prompt resolution in any automation hook.
  * Exactly one of `prompt` or `promptName` must be provided.
@@ -8,11 +9,14 @@ import type { ClaudeOrchestrator } from "./claudeOrchestrator.js";
  * - `promptArgs`: static args passed to the named prompt. Values may contain
  *   `{{placeholder}}` tokens that are substituted with sanitized event data
  *   (control chars stripped, length capped) before the prompt is resolved.
+ * - `condition`: optional minimatch glob. If set, the hook only fires when the
+ *   primary event value (file path, branch name, tool name, etc.) matches.
  */
 export interface PromptSource {
     prompt?: string;
     promptName?: string;
     promptArgs?: Record<string, string>;
+    condition?: string;
 }
 export interface OnDiagnosticsErrorPolicy extends PromptSource {
     enabled: boolean;
@@ -144,6 +148,49 @@ export interface PullRequestResult {
     title: string;
     branch: string;
 }
+export interface OnTaskCreatedPolicy extends PromptSource {
+    enabled: boolean;
+    /**
+     * Fired by Claude Code 2.1.84+ TaskCreated hook — fires when Claude creates a subagent task.
+     * Placeholders (inline prompt only): {{taskId}}, {{prompt}}
+     */
+    /** Minimum ms between triggers. Enforced minimum: 5000. */
+    cooldownMs: number;
+}
+/** Minimal task-created result passed to handleTaskCreated. */
+export interface TaskCreatedResult {
+    taskId: string;
+    prompt: string;
+}
+export interface OnPermissionDeniedPolicy extends PromptSource {
+    enabled: boolean;
+    /**
+     * Fired by Claude Code 2.1.89+ PermissionDenied hook — fires when a tool call is blocked.
+     * Placeholders (inline prompt only): {{tool}}, {{reason}}
+     */
+    /** Minimum ms between triggers. Enforced minimum: 5000. */
+    cooldownMs: number;
+}
+/** Minimal permission-denied result passed to handlePermissionDenied. */
+export interface PermissionDeniedResult {
+    tool: string;
+    reason: string;
+}
+export interface OnDiagnosticsClearedPolicy extends PromptSource {
+    enabled: boolean;
+    /** Placeholders (inline prompt only): {{file}} */
+    cooldownMs: number;
+}
+export interface OnTaskSuccessPolicy extends PromptSource {
+    enabled: boolean;
+    /** Placeholders (inline prompt only): {{taskId}}, {{output}} */
+    cooldownMs: number;
+}
+/** Minimal task-success result passed to handleTaskSuccess. */
+export interface TaskSuccessResult {
+    taskId: string;
+    output: string;
+}
 export interface AutomationPolicy {
     onDiagnosticsError?: OnDiagnosticsErrorPolicy;
     onFileSave?: OnFileSavePolicy;
@@ -165,6 +212,14 @@ export interface AutomationPolicy {
     onBranchCheckout?: OnBranchCheckoutPolicy;
     /** Fired after every successful githubCreatePR call. */
     onPullRequest?: OnPullRequestPolicy;
+    /** Fired by Claude Code 2.1.84+ TaskCreated hook — fires when Claude creates a subagent task. */
+    onTaskCreated?: OnTaskCreatedPolicy;
+    /** Fired by Claude Code 2.1.89+ PermissionDenied hook — fires when a tool call is blocked. */
+    onPermissionDenied?: OnPermissionDeniedPolicy;
+    /** Fired when all errors/warnings clear for a file (non-zero → zero transition). */
+    onDiagnosticsCleared?: OnDiagnosticsClearedPolicy;
+    /** Fired when a Claude orchestrator task completes with status done. */
+    onTaskSuccess?: OnTaskSuccessPolicy;
 }
 export interface Diagnostic {
     message: string;
@@ -177,6 +232,7 @@ export declare class AutomationHooks {
     private readonly policy;
     private readonly orchestrator;
     private readonly log;
+    private readonly extensionClient?;
     /** Last trigger time per "trigger key" (e.g. "diagnostics:/path/to/file"). */
     private lastTrigger;
     /**
@@ -199,7 +255,17 @@ export declare class AutomationHooks {
     private activeBranchCheckoutTaskId;
     /** Active task ID for the pull-request handler (workspace-global). */
     private activePullRequestTaskId;
-    constructor(policy: AutomationPolicy, orchestrator: ClaudeOrchestrator, log: (msg: string) => void);
+    /** Active task ID for the task-created handler (workspace-global). */
+    private activeTaskCreatedTaskId;
+    /** Active task ID for the permission-denied handler (workspace-global). */
+    private activePermissionDeniedTaskId;
+    /** Active task IDs per file for the diagnostics-cleared handler. */
+    private activeDiagnosticsClearedTasks;
+    /** Tracks previous error count per normalized file path for zero-transition detection. */
+    private prevDiagnosticErrors;
+    /** Active task ID for the task-success handler (workspace-global). */
+    private activeTaskSuccessTaskId;
+    constructor(policy: AutomationPolicy, orchestrator: ClaudeOrchestrator, log: (msg: string) => void, extensionClient?: ExtensionClient | undefined);
     /**
      * Resolve a named prompt, substituting any `{{placeholder}}` tokens in
      * `promptArgs` values with sanitized event data before calling `getPrompt()`.
@@ -208,6 +274,7 @@ export declare class AutomationHooks {
      * or has missing required arguments.
      */
     private _resolveNamedPrompt;
+    private _matchesCondition;
     handleDiagnosticsChanged(file: string, diagnostics: Diagnostic[]): void;
     /** Prune lastTrigger entries older than LAST_TRIGGER_MAX_AGE_MS to prevent unbounded growth. */
     private _pruneLastTrigger;
@@ -242,7 +309,7 @@ export declare class AutomationHooks {
      * Called after a successful gitCommit tool call.
      * Fires the onGitCommit automation hook if configured.
      */
-    handleGitCommit(result: GitCommitResult): void;
+    handleGitCommit(result: GitCommitResult): Promise<void>;
     /**
      * Called after a successful gitPush tool call.
      * Fires the onGitPush automation hook if configured.
@@ -257,6 +324,18 @@ export declare class AutomationHooks {
      * Fires the onPullRequest automation hook if configured.
      */
     handlePullRequest(result: PullRequestResult): void;
+    handleTaskCreated(result: TaskCreatedResult): void;
+    handlePermissionDenied(result: PermissionDeniedResult): void;
+    /**
+     * Fires the onDiagnosticsCleared hook when a file transitions from non-zero to zero errors.
+     * Called internally by handleDiagnosticsChanged.
+     */
+    handleDiagnosticsCleared(normalizedFile: string): void;
+    /**
+     * Fires the onTaskSuccess hook when a Claude orchestrator task completes with status "done".
+     * Call from bridge.ts when a task transitions to done.
+     */
+    handleTaskSuccess(result: TaskSuccessResult): void;
     /** Summary of automation policy for getBridgeStatus. */
     getStatus(): {
         onPostCompact: {
@@ -299,5 +378,21 @@ export declare class AutomationHooks {
             enabled: boolean;
             cooldownMs: number;
         } | null;
+        onTaskCreated: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
+        onPermissionDenied: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
+        onDiagnosticsCleared: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
+        onTaskSuccess: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
     };
 }