claude-ide-bridge 2.14.0 → 2.16.0

package/dist/automation.d.ts

@@ -1,60 +1,61 @@
 import type { ClaudeOrchestrator } from "./claudeOrchestrator.js";
-export interface OnDiagnosticsErrorPolicy {
+/**
+ * Shared fields for prompt resolution in any automation hook.
+ * Exactly one of `prompt` or `promptName` must be provided.
+ *
+ * - `prompt`: inline instruction string with `{{placeholder}}` tokens.
+ * - `promptName`: name of a built-in MCP prompt (e.g. `"unused-in"`, `"why-error"`).
+ * - `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.
+ */
+export interface PromptSource {
+    prompt?: string;
+    promptName?: string;
+    promptArgs?: Record<string, string>;
+}
+export interface OnDiagnosticsErrorPolicy extends PromptSource {
     enabled: boolean;
     minSeverity: "error" | "warning";
-    /** Placeholders: {{file}}, {{diagnostics}} */
-    prompt: string;
+    /** Placeholders (inline prompt only): {{file}}, {{diagnostics}} */
     /** Minimum ms between triggers for the same file. Enforced minimum: 5000. */
     cooldownMs: number;
 }
-export interface OnFileSavePolicy {
+export interface OnFileSavePolicy extends PromptSource {
     enabled: boolean;
     /** Minimatch glob patterns, e.g. ["**\/*.ts", "!node_modules/**"] */
     patterns: string[];
-    /** Placeholders: {{file}} */
-    prompt: string;
+    /** Placeholders (inline prompt only): {{file}} */
     cooldownMs: number;
 }
-export interface OnFileChangedPolicy {
+export interface OnFileChangedPolicy extends PromptSource {
     enabled: boolean;
     /** Minimatch glob patterns, e.g. ["**\/*.ts", "!node_modules/**"] */
     patterns: string[];
-    /** Placeholders: {{file}} */
-    prompt: string;
+    /** Placeholders (inline prompt only): {{file}} */
     cooldownMs: number;
 }
-export interface OnPostCompactPolicy {
+export interface OnPostCompactPolicy extends PromptSource {
     enabled: boolean;
     /**
-     * Prompt to enqueue after Claude compacts its context.
-     * Use this to re-snapshot IDE state so Claude recovers context.
      * No placeholders — fired unconditionally when compaction occurs.
+     * Use promptName (e.g. "project-status") to re-snapshot IDE state.
      */
-    prompt: string;
     /** Minimum ms between triggers (prevents repeated compaction storms). Enforced minimum: 5000. */
     cooldownMs: number;
 }
-export interface OnInstructionsLoadedPolicy {
+export interface OnInstructionsLoadedPolicy extends PromptSource {
     enabled: boolean;
-    /**
-     * Prompt to enqueue when Claude loads its system instructions (first turn of a session).
-     * Useful for injecting a tool-capability summary at session start.
-     * No placeholders.
-     */
-    prompt: string;
 }
-export interface OnCwdChangedPolicy {
+export interface OnCwdChangedPolicy extends PromptSource {
     enabled: boolean;
     /**
-     * Prompt to enqueue when Claude Code's working directory changes (Claude Code 2.1.83+).
-     * Useful for re-initialising workspace context when CC switches projects.
-     * Placeholder: {{cwd}}
+     * Placeholders (inline prompt only): {{cwd}}
      */
-    prompt: string;
     /** Minimum ms between triggers. Enforced minimum: 5000. */
     cooldownMs: number;
 }
-export interface OnTestRunPolicy {
+export interface OnTestRunPolicy extends PromptSource {
     enabled: boolean;
     /**
      * Only trigger when there are test failures or errors.
@@ -63,10 +64,8 @@ export interface OnTestRunPolicy {
      */
     onFailureOnly: boolean;
     /**
-     * Prompt to enqueue after a test run.
-     * Placeholders: {{runner}}, {{failed}}, {{passed}}, {{total}}, {{failures}}
+     * Placeholders (inline prompt only): {{runner}}, {{failed}}, {{passed}}, {{total}}, {{failures}}
      */
-    prompt: string;
     /** Minimum ms between triggers. Enforced minimum: 5000. */
     cooldownMs: number;
 }
@@ -86,13 +85,11 @@ export interface TestRunResult {
         message: string;
     }>;
 }
-export interface OnGitCommitPolicy {
+export interface OnGitCommitPolicy extends PromptSource {
     enabled: boolean;
     /**
-     * Prompt to enqueue after a successful git commit.
-     * Placeholders: {{hash}}, {{branch}}, {{message}}, {{files}}, {{count}}
+     * Placeholders (inline prompt only): {{hash}}, {{branch}}, {{message}}, {{files}}, {{count}}
      */
-    prompt: string;
     /** Minimum ms between triggers. Enforced minimum: 5000. */
     cooldownMs: number;
 }
@@ -104,13 +101,11 @@ export interface GitCommitResult {
     files: string[];
     count: number;
 }
-export interface OnGitPushPolicy {
+export interface OnGitPushPolicy extends PromptSource {
     enabled: boolean;
     /**
-     * Prompt to enqueue after a successful git push.
-     * Placeholders: {{remote}}, {{branch}}, {{hash}}
+     * Placeholders (inline prompt only): {{remote}}, {{branch}}, {{hash}}
      */
-    prompt: string;
     /** Minimum ms between triggers. Enforced minimum: 5000. */
     cooldownMs: number;
 }
@@ -120,13 +115,11 @@ export interface GitPushResult {
     branch: string;
     hash: string;
 }
-export interface OnBranchCheckoutPolicy {
+export interface OnBranchCheckoutPolicy extends PromptSource {
     enabled: boolean;
     /**
-     * Prompt to enqueue after a successful git checkout (branch switch or creation).
-     * Placeholders: {{branch}}, {{previousBranch}}, {{created}}
+     * Placeholders (inline prompt only): {{branch}}, {{previousBranch}}, {{created}}
      */
-    prompt: string;
     /** Minimum ms between triggers. Enforced minimum: 5000. */
     cooldownMs: number;
 }
@@ -136,13 +129,11 @@ export interface BranchCheckoutResult {
     previousBranch: string | null;
     created: boolean;
 }
-export interface OnPullRequestPolicy {
+export interface OnPullRequestPolicy extends PromptSource {
     enabled: boolean;
     /**
-     * Prompt to enqueue after a GitHub PR is successfully created.
-     * Placeholders: {{url}}, {{number}}, {{title}}, {{branch}}
+     * Placeholders (inline prompt only): {{url}}, {{number}}, {{title}}, {{branch}}
      */
-    prompt: string;
     /** Minimum ms between triggers. Enforced minimum: 5000. */
     cooldownMs: number;
 }
@@ -209,6 +200,14 @@ export declare class AutomationHooks {
     /** Active task ID for the pull-request handler (workspace-global). */
     private activePullRequestTaskId;
     constructor(policy: AutomationPolicy, orchestrator: ClaudeOrchestrator, log: (msg: string) => void);
+    /**
+     * Resolve a named prompt, substituting any `{{placeholder}}` tokens in
+     * `promptArgs` values with sanitized event data before calling `getPrompt()`.
+     *
+     * Returns the resolved user-message text, or `null` if the prompt is unknown
+     * or has missing required arguments.
+     */
+    private _resolveNamedPrompt;
     handleDiagnosticsChanged(file: string, diagnostics: Diagnostic[]): void;
     /** Prune lastTrigger entries older than LAST_TRIGGER_MAX_AGE_MS to prevent unbounded growth. */
     private _pruneLastTrigger;