claude-ide-bridge 2.28.0 → 2.34.0

package/dist/automation.d.ts

@@ -23,7 +23,7 @@ export interface AutomationCondition {
     /** Only fire if the active file has a diagnostic of at least this severity. */
     diagnosticsMinSeverity?: "error" | "warning";
     /** Only fire if the last test run for any runner had this outcome. */
-    testRunnerLastStatus?: "passed" | "failed";
+    testRunnerLastStatus?: "passed" | "failed" | "any";
 }
 export interface PromptSource {
     prompt?: string;
@@ -87,6 +87,16 @@ export interface OnFileChangedPolicy extends PromptSource {
     /** Placeholders (inline prompt only): {{file}} */
     cooldownMs: number;
 }
+export interface OnPreCompactPolicy extends PromptSource {
+    enabled: boolean;
+    /**
+     * No placeholders — fired just before Claude Code compacts the context window.
+     * Use to snapshot IDE state, write a handoff note, or complete an in-flight task
+     * before Claude loses context. Pairs with onPostCompact.
+     */
+    /** Minimum ms between triggers. Enforced minimum: 5000. */
+    cooldownMs: number;
+}
 export interface OnPostCompactPolicy extends PromptSource {
     enabled: boolean;
     /**
@@ -161,6 +171,34 @@ export interface TestRunResult {
         message: string;
     }>;
 }
+export interface OnDebugSessionEndPolicy extends PromptSource {
+    enabled: boolean;
+    /**
+     * Placeholders (inline prompt only): {{sessionName}}, {{sessionType}}
+     */
+    cooldownMs: number;
+}
+/** Minimal debug session result passed to handleDebugSessionEnd. */
+export interface DebugSessionEndResult {
+    sessionName: string;
+    sessionType: string;
+}
+export interface OnDebugSessionStartPolicy extends PromptSource {
+    enabled: boolean;
+    /**
+     * Placeholders (inline prompt only): {{sessionName}}, {{sessionType}}
+     */
+    cooldownMs: number;
+}
+/** Minimal debug session result passed to handleDebugSessionStart. */
+export interface DebugSessionStartResult {
+    sessionName: string;
+    sessionType: string;
+    /** Number of breakpoints active at session start. */
+    breakpointCount: number;
+    /** Active file at session start (first breakpoint file, if any). */
+    activeFile: string;
+}
 export interface OnGitCommitPolicy extends PromptSource {
     enabled: boolean;
     /**
@@ -310,6 +348,8 @@ export interface AutomationPolicy {
     onCwdChanged?: OnCwdChangedPolicy;
     /** Fired by Claude Code 2.1.76+ PostCompact hook — re-injects IDE context after compaction. */
     onPostCompact?: OnPostCompactPolicy;
+    /** Fired by Claude Code PreCompact hook — runs before context window is trimmed. */
+    onPreCompact?: OnPreCompactPolicy;
     /** Fired by Claude Code 2.1.76+ InstructionsLoaded hook — injects bridge status at session start. */
     onInstructionsLoaded?: OnInstructionsLoadedPolicy;
     /** Fired after every runTests call (or only on failures, depending on onFailureOnly). */
@@ -334,6 +374,10 @@ export interface AutomationPolicy {
     onDiagnosticsCleared?: OnDiagnosticsClearedPolicy;
     /** Fired when a Claude orchestrator task completes with status done. */
     onTaskSuccess?: OnTaskSuccessPolicy;
+    /** Fired when a VS Code debug session terminates (hasActiveSession transitions true→false). */
+    onDebugSessionEnd?: OnDebugSessionEndPolicy;
+    /** Fired when a VS Code debug session starts (hasActiveSession transitions false→true). */
+    onDebugSessionStart?: OnDebugSessionStartPolicy;
 }
 export interface Diagnostic {
     message: string;
@@ -409,8 +453,14 @@ export declare class AutomationHooks {
     private lastTestRunnerStatusByRunner;
     /** Active task ID for the task-success handler (workspace-global). */
     private activeTaskSuccessTaskId;
+    /** Active task ID for the debug-session-end handler (workspace-global). */
+    private activeDebugSessionEndTaskId;
+    /** Active task ID for the debug-session-start handler (workspace-global). */
+    private activeDebugSessionStartTaskId;
     /** Active task ID for the post-compact handler (workspace-global). */
     private activePostCompactTaskId;
+    /** Active task ID for the pre-compact handler (workspace-global). */
+    private activePreCompactTaskId;
     /** Active task ID for the instructions-loaded handler (workspace-global). */
     private activeInstructionsLoadedTaskId;
     /**
@@ -418,6 +468,7 @@ export declare class AutomationHooks {
      * Entries older than 60 minutes are pruned on each enqueue.
      */
     private taskTimestamps;
+    private _lastFiredAt;
     constructor(policy: AutomationPolicy, orchestrator: ClaudeOrchestrator, log: (msg: string) => void, extensionClient?: ExtensionClient | undefined, workspace?: string | undefined);
     /**
      * Central enqueue for all automation-triggered tasks.
@@ -454,6 +505,12 @@ export declare class AutomationHooks {
      * Fires when CC's working directory changes — useful for re-snapshotting workspace context.
      */
     handleCwdChanged(newCwd: string): void;
+    /**
+     * Called when Claude Code fires a PreCompact hook.
+     * Fires the onPreCompact automation hook before context trimming — use to snapshot state or
+     * write a handoff note before Claude loses context.
+     */
+    handlePreCompact(): void;
     /**
      * Called when Claude Code fires a PostCompact hook (Claude Code 2.1.76+).
      * Re-enqueues the configured prompt so Claude can re-snapshot IDE state after losing context.
@@ -516,8 +573,22 @@ export declare class AutomationHooks {
      * Call from bridge.ts when a task transitions to done.
      */
     handleTaskSuccess(result: TaskSuccessResult): void;
+    /**
+     * Called when a VS Code debug session ends (hasActiveSession transitions true→false).
+     * Fires the onDebugSessionEnd automation hook if configured.
+     */
+    handleDebugSessionEnd(result: DebugSessionEndResult): Promise<void>;
+    /**
+     * Called when a VS Code debug session starts (hasActiveSession transitions false→true).
+     * Fires the onDebugSessionStart automation hook if configured.
+     */
+    handleDebugSessionStart(result: DebugSessionStartResult): Promise<void>;
     /** Summary of automation policy for getBridgeStatus. */
     getStatus(): {
+        onPreCompact: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
         onPostCompact: {
             enabled: boolean;
             cooldownMs: number;
@@ -586,6 +657,14 @@ export declare class AutomationHooks {
             enabled: boolean;
             cooldownMs: number;
         } | null;
+        onDebugSessionEnd: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
+        onDebugSessionStart: {
+            enabled: boolean;
+            cooldownMs: number;
+        } | null;
         unwiredEnabledHooks: string[];
         defaultModel: string;
         maxTasksPerHour: number;
@@ -593,4 +672,9 @@ export declare class AutomationHooks {
         defaultEffort: string;
         automationSystemPrompt: string;
     };
+    isPreCompactEnabled(): boolean;
+    getStats(): {
+        hooksEnabled: number;
+        lastFiredAt: string | null;
+    };
 }