@kolisachint/hoocode-agent 0.4.135 → 0.4.136

package/dist/modes/interactive/completion-chime.js

@@ -0,0 +1,96 @@
+/**
+ * Completion chime — a short audible cue (terminal BEL) played when an assistant
+ * turn finishes after the user has likely stepped away, or when the agent blocks
+ * awaiting the user's input (the ask_options pane).
+ *
+ * Design constraints:
+ *   - Output-only, zero dependencies: the cue is a single BEL byte written to the
+ *     terminal. No bundled audio, no subprocesses.
+ *   - Side-effect-free from the turn's perspective: the ring is wrapped in a
+ *     try/catch so a failed write can never throw into the turn path. Worst case
+ *     is no sound.
+ *
+ * Firing conditions (the caller drives these; this class only decides whether a
+ * given signal should actually ring):
+ *   - Turn-complete: the turn ran longer than {@link CompletionChimeOptions.thresholdMs}
+ *     (default 10s), measured from the turn's start to when the agent goes truly
+ *     idle, and the turn was not user-aborted.
+ *   - Blocked-for-input: the agent opened the ask_options pane. This bypasses the
+ *     duration threshold — "it needs you" is worth surfacing immediately.
+ *
+ * Both paths are gated by an enable check and share a single debounce window so
+ * rapid successive turns (or a long turn that ends in an ask_options prompt) do
+ * not spam the bell.
+ */
+/** Terminal bell (BEL, `\a`). Rings the terminal's configured audible/visual alert. */
+export const BELL = "\x07";
+const DEFAULT_THRESHOLD_MS = 10_000;
+const DEFAULT_DEBOUNCE_MS = 5_000;
+export class CompletionChime {
+    isEnabled;
+    doRing;
+    thresholdMs;
+    debounceMs;
+    now;
+    /** Start of the current turn, or undefined when no turn is in flight. */
+    turnStart;
+    /** Timestamp of the last chime, for debouncing. */
+    lastChimeAt;
+    constructor(options) {
+        this.isEnabled = options.isEnabled;
+        this.doRing = options.ring;
+        this.thresholdMs = options.thresholdMs ?? DEFAULT_THRESHOLD_MS;
+        this.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+        this.now = options.now ?? Date.now;
+    }
+    /**
+     * Anchor the start of a turn. Only the first call per turn takes effect, so a
+     * turn that internally retries (re-entering agent_start) still measures its
+     * duration from the original start.
+     */
+    onTurnStart() {
+        if (this.turnStart === undefined) {
+            this.turnStart = this.now();
+        }
+    }
+    /**
+     * The agent has gone truly idle after a turn. Rings if the turn ran longer than
+     * the threshold and was not aborted. Clears the turn anchor either way.
+     */
+    onTurnComplete(options) {
+        const start = this.turnStart;
+        this.turnStart = undefined;
+        if (options.aborted || start === undefined) {
+            return;
+        }
+        if (this.now() - start < this.thresholdMs) {
+            return;
+        }
+        this.fire();
+    }
+    /**
+     * The agent is blocked awaiting user input (ask_options pane). Rings
+     * immediately, bypassing the duration threshold. Leaves the turn anchor intact
+     * — the turn is still in flight and will complete once the user answers.
+     */
+    onBlockedForInput() {
+        this.fire();
+    }
+    fire() {
+        if (!this.isEnabled()) {
+            return;
+        }
+        const at = this.now();
+        if (this.lastChimeAt !== undefined && at - this.lastChimeAt < this.debounceMs) {
+            return;
+        }
+        this.lastChimeAt = at;
+        try {
+            this.doRing();
+        }
+        catch {
+            // Side-effect-free: worst case is no sound. Never throw into the turn path.
+        }
+    }
+}
+//# sourceMappingURL=completion-chime.js.map

package/dist/modes/interactive/completion-chime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-chime.js","sourceRoot":"","sources":["../../../src/modes/interactive/completion-chime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,uFAAuF;AACvF,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAE3B,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAkBlC,MAAM,OAAO,eAAe;IACV,SAAS,CAAgB;IACzB,MAAM,CAAa;IACnB,WAAW,CAAS;IACpB,UAAU,CAAS;IACnB,GAAG,CAAe;IAEnC,yEAAyE;IACjE,SAAS,CAAqB;IACtC,mDAAmD;IAC3C,WAAW,CAAqB;IAExC,YAAY,OAA+B,EAAE;QAC5C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC/D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAAA,CACnC;IAED;;;;OAIG;IACH,WAAW,GAAS;QACnB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;IAAA,CACD;IAED;;;OAGG;IACH,cAAc,CAAC,OAA6B,EAAQ;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,OAAO,CAAC,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO;QACR,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,OAAO;QACR,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;IAAA,CACZ;IAED;;;;OAIG;IACH,iBAAiB,GAAS;QACzB,IAAI,CAAC,IAAI,EAAE,CAAC;IAAA,CACZ;IAEO,IAAI,GAAS;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACvB,OAAO;QACR,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/E,OAAO;QACR,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACJ,IAAI,CAAC,MAAM,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACR,4EAA4E;QAC7E,CAAC;IAAA,CACD;CACD","sourcesContent":["/**\n * Completion chime — a short audible cue (terminal BEL) played when an assistant\n * turn finishes after the user has likely stepped away, or when the agent blocks\n * awaiting the user's input (the ask_options pane).\n *\n * Design constraints:\n *   - Output-only, zero dependencies: the cue is a single BEL byte written to the\n *     terminal. No bundled audio, no subprocesses.\n *   - Side-effect-free from the turn's perspective: the ring is wrapped in a\n *     try/catch so a failed write can never throw into the turn path. Worst case\n *     is no sound.\n *\n * Firing conditions (the caller drives these; this class only decides whether a\n * given signal should actually ring):\n *   - Turn-complete: the turn ran longer than {@link CompletionChimeOptions.thresholdMs}\n *     (default 10s), measured from the turn's start to when the agent goes truly\n *     idle, and the turn was not user-aborted.\n *   - Blocked-for-input: the agent opened the ask_options pane. This bypasses the\n *     duration threshold — \"it needs you\" is worth surfacing immediately.\n *\n * Both paths are gated by an enable check and share a single debounce window so\n * rapid successive turns (or a long turn that ends in an ask_options prompt) do\n * not spam the bell.\n */\n\n/** Terminal bell (BEL, `\\a`). Rings the terminal's configured audible/visual alert. */\nexport const BELL = \"\\x07\";\n\nconst DEFAULT_THRESHOLD_MS = 10_000;\nconst DEFAULT_DEBOUNCE_MS = 5_000;\n\nexport interface CompletionChimeOptions {\n\t/** Read fresh on every potential ring so live setting changes take effect immediately. */\n\tisEnabled: () => boolean;\n\t/**\n\t * Emit the audible cue. Called inside a try/catch — implementations need not\n\t * guard against throwing, but nothing they throw will reach the turn path.\n\t */\n\tring: () => void;\n\t/** Minimum turn duration before a turn-complete chime fires. Defaults to 10s. */\n\tthresholdMs?: number;\n\t/** Minimum gap between two chimes. Defaults to 5s. */\n\tdebounceMs?: number;\n\t/** Clock, injectable for tests. Defaults to {@link Date.now}. */\n\tnow?: () => number;\n}\n\nexport class CompletionChime {\n\tprivate readonly isEnabled: () => boolean;\n\tprivate readonly doRing: () => void;\n\tprivate readonly thresholdMs: number;\n\tprivate readonly debounceMs: number;\n\tprivate readonly now: () => number;\n\n\t/** Start of the current turn, or undefined when no turn is in flight. */\n\tprivate turnStart: number | undefined;\n\t/** Timestamp of the last chime, for debouncing. */\n\tprivate lastChimeAt: number | undefined;\n\n\tconstructor(options: CompletionChimeOptions) {\n\t\tthis.isEnabled = options.isEnabled;\n\t\tthis.doRing = options.ring;\n\t\tthis.thresholdMs = options.thresholdMs ?? DEFAULT_THRESHOLD_MS;\n\t\tthis.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;\n\t\tthis.now = options.now ?? Date.now;\n\t}\n\n\t/**\n\t * Anchor the start of a turn. Only the first call per turn takes effect, so a\n\t * turn that internally retries (re-entering agent_start) still measures its\n\t * duration from the original start.\n\t */\n\tonTurnStart(): void {\n\t\tif (this.turnStart === undefined) {\n\t\t\tthis.turnStart = this.now();\n\t\t}\n\t}\n\n\t/**\n\t * The agent has gone truly idle after a turn. Rings if the turn ran longer than\n\t * the threshold and was not aborted. Clears the turn anchor either way.\n\t */\n\tonTurnComplete(options: { aborted: boolean }): void {\n\t\tconst start = this.turnStart;\n\t\tthis.turnStart = undefined;\n\t\tif (options.aborted || start === undefined) {\n\t\t\treturn;\n\t\t}\n\t\tif (this.now() - start < this.thresholdMs) {\n\t\t\treturn;\n\t\t}\n\t\tthis.fire();\n\t}\n\n\t/**\n\t * The agent is blocked awaiting user input (ask_options pane). Rings\n\t * immediately, bypassing the duration threshold. Leaves the turn anchor intact\n\t * — the turn is still in flight and will complete once the user answers.\n\t */\n\tonBlockedForInput(): void {\n\t\tthis.fire();\n\t}\n\n\tprivate fire(): void {\n\t\tif (!this.isEnabled()) {\n\t\t\treturn;\n\t\t}\n\t\tconst at = this.now();\n\t\tif (this.lastChimeAt !== undefined && at - this.lastChimeAt < this.debounceMs) {\n\t\t\treturn;\n\t\t}\n\t\tthis.lastChimeAt = at;\n\t\ttry {\n\t\t\tthis.doRing();\n\t\t} catch {\n\t\t\t// Side-effect-free: worst case is no sound. Never throw into the turn path.\n\t\t}\n\t}\n}\n"]}

package/dist/modes/interactive/interactive-mode.d.ts

@@ -75,6 +75,9 @@ export declare class InteractiveMode {
     private retryLoader;
     private retryCountdown;
     private retryEscapeHandler?;
+    private chime?;
+    private chimePendingRetry;
+    private chimeTurnAborted;
     private shutdownRequested;
     private dialogs;
     private extensionTerminalInputUnsubscribers;
@@ -190,6 +193,14 @@ export declare class InteractiveMode {
     private createBuiltInSlashCommands;
     private setupEditorSubmitHandler;
     private subscribeToAgent;
+    /**
+     * Deferred completion chime. Called from the agent_end handler, it waits one
+     * tick so the streaming flag settles and any retry has had a chance to arm, then
+     * rings only when the session is genuinely idle (not streaming, not compacting)
+     * and no retry is pending. The chime itself enforces the enable/threshold/debounce
+     * rules; here we only decide whether the turn has truly ended.
+     */
+    private maybeChimeOnIdle;
     private handleEvent;
     /** Extract text content from a user message */
     private getUserMessageText;