hammoc 1.6.0 → 1.7.0

package/packages/server/dist/utils/backgroundBlock.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Background-execution block policy shared by both chat engines (Story 36.1).
+ *
+ * Hammoc runs one CLI/SDK process per turn (turn-per-process) and kills it when
+ * the turn ends, so a backgrounded tool call (`run_in_background: true`) would be
+ * orphaned/killed and only leaves side effects (e.g. task-notification files).
+ * A PreToolUse hook denies such calls before they reach the shell — and unlike
+ * canUseTool, a PreToolUse deny also covers auto-approved tools (bypass/auto modes).
+ *
+ * SDK mode wires the check as an inline hook callback (see chatService); CLI mode
+ * runs it as an external command hook (resources/hooks/block-background.cjs). The
+ * two runtimes differ, so only the predicate + reason are shared here.
+ *
+ * ⚠️ The .cjs script duplicates BACKGROUND_BLOCK_REASON as a literal (it cannot
+ * import a TS module); keep the two strings in sync.
+ */
+export declare const BACKGROUND_BLOCK_REASON = "Background execution is disabled in Hammoc: it runs one process per turn, so a backgrounded task is killed when the turn ends. Re-run without run_in_background (foreground).";
+/**
+ * True when a tool call requests background execution (`run_in_background: true`) — which
+ * must be blocked regardless of WHICH tool it is. Hammoc is turn-per-process, so ANY
+ * backgrounded call is orphaned at turn end. We key off the INPUT FLAG, not the tool name:
+ * a tool-name allow-list silently misses tools (that was the earlier Windows PowerShell gap),
+ * whereas the flag is the actual thing that makes the call doomed.
+ *
+ * Crucially this does NOT touch foreground execution: several foreground tools launched in
+ * parallel within one turn and awaited carry no `run_in_background` flag, so they pass through.
+ */
+export declare function isBlockedBackgroundCall(toolInput: unknown): boolean;
+//# sourceMappingURL=backgroundBlock.d.ts.map

package/packages/server/dist/utils/backgroundBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundBlock.d.ts","sourceRoot":"","sources":["../../src/utils/backgroundBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,kLAC6I,CAAC;AAElL;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAMnE"}

package/packages/server/dist/utils/backgroundBlock.js

@@ -0,0 +1,33 @@
+/**
+ * Background-execution block policy shared by both chat engines (Story 36.1).
+ *
+ * Hammoc runs one CLI/SDK process per turn (turn-per-process) and kills it when
+ * the turn ends, so a backgrounded tool call (`run_in_background: true`) would be
+ * orphaned/killed and only leaves side effects (e.g. task-notification files).
+ * A PreToolUse hook denies such calls before they reach the shell — and unlike
+ * canUseTool, a PreToolUse deny also covers auto-approved tools (bypass/auto modes).
+ *
+ * SDK mode wires the check as an inline hook callback (see chatService); CLI mode
+ * runs it as an external command hook (resources/hooks/block-background.cjs). The
+ * two runtimes differ, so only the predicate + reason are shared here.
+ *
+ * ⚠️ The .cjs script duplicates BACKGROUND_BLOCK_REASON as a literal (it cannot
+ * import a TS module); keep the two strings in sync.
+ */
+export const BACKGROUND_BLOCK_REASON = 'Background execution is disabled in Hammoc: it runs one process per turn, so a backgrounded task is killed when the turn ends. Re-run without run_in_background (foreground).';
+/**
+ * True when a tool call requests background execution (`run_in_background: true`) — which
+ * must be blocked regardless of WHICH tool it is. Hammoc is turn-per-process, so ANY
+ * backgrounded call is orphaned at turn end. We key off the INPUT FLAG, not the tool name:
+ * a tool-name allow-list silently misses tools (that was the earlier Windows PowerShell gap),
+ * whereas the flag is the actual thing that makes the call doomed.
+ *
+ * Crucially this does NOT touch foreground execution: several foreground tools launched in
+ * parallel within one turn and awaited carry no `run_in_background` flag, so they pass through.
+ */
+export function isBlockedBackgroundCall(toolInput) {
+    return (typeof toolInput === 'object' &&
+        toolInput !== null &&
+        toolInput.run_in_background === true);
+}
+//# sourceMappingURL=backgroundBlock.js.map

package/packages/server/dist/utils/backgroundBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundBlock.js","sourceRoot":"","sources":["../../src/utils/backgroundBlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,+KAA+K,CAAC;AAElL;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAkB;IACxD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,SAAS,KAAK,IAAI;QACjB,SAA6C,CAAC,iBAAiB,KAAK,IAAI,CAC1E,CAAC;AACJ,CAAC"}

package/packages/server/dist/utils/backgroundTaskTracker.d.ts

@@ -0,0 +1,20 @@
+export interface BackgroundTaskState {
+    pending: number;
+    waiting: boolean;
+}
+export type BackgroundTaskChangeCallback = (state: BackgroundTaskState) => void;
+export declare class BackgroundTaskTracker {
+    private pendingCount;
+    private _mainResponseEnded;
+    private onChange?;
+    constructor(onChange?: BackgroundTaskChangeCallback);
+    trackToolUse(input: unknown): void;
+    trackTaskDone(): void;
+    markMainEnded(): void;
+    get mainResponseEnded(): boolean;
+    get isWaiting(): boolean;
+    get isFullyDone(): boolean;
+    get pending(): number;
+    private notify;
+}
+//# sourceMappingURL=backgroundTaskTracker.d.ts.map

package/packages/server/dist/utils/backgroundTaskTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundTaskTracker.d.ts","sourceRoot":"","sources":["../../src/utils/backgroundTaskTracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAEhF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,CAA+B;gBAEpC,QAAQ,CAAC,EAAE,4BAA4B;IAInD,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAWlC,aAAa,IAAI,IAAI;IAKrB,aAAa,IAAI,IAAI;IAKrB,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,OAAO,CAAC,MAAM;CAGf"}

package/packages/server/dist/utils/backgroundTaskTracker.js

@@ -0,0 +1,40 @@
+export class BackgroundTaskTracker {
+    pendingCount = 0;
+    _mainResponseEnded = false;
+    onChange;
+    constructor(onChange) {
+        this.onChange = onChange;
+    }
+    trackToolUse(input) {
+        if (typeof input === 'object' &&
+            input !== null &&
+            input.run_in_background === true) {
+            this.pendingCount++;
+            this.notify();
+        }
+    }
+    trackTaskDone() {
+        this.pendingCount = Math.max(0, this.pendingCount - 1);
+        this.notify();
+    }
+    markMainEnded() {
+        this._mainResponseEnded = true;
+        this.notify();
+    }
+    get mainResponseEnded() {
+        return this._mainResponseEnded;
+    }
+    get isWaiting() {
+        return this._mainResponseEnded && this.pendingCount > 0;
+    }
+    get isFullyDone() {
+        return this._mainResponseEnded && this.pendingCount === 0;
+    }
+    get pending() {
+        return this.pendingCount;
+    }
+    notify() {
+        this.onChange?.({ pending: this.pendingCount, waiting: this.isWaiting });
+    }
+}
+//# sourceMappingURL=backgroundTaskTracker.js.map

package/packages/server/dist/utils/backgroundTaskTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundTaskTracker.js","sourceRoot":"","sources":["../../src/utils/backgroundTaskTracker.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,qBAAqB;IACxB,YAAY,GAAG,CAAC,CAAC;IACjB,kBAAkB,GAAG,KAAK,CAAC;IAC3B,QAAQ,CAAgC;IAEhD,YAAY,QAAuC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,YAAY,CAAC,KAAc;QACzB,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACb,KAAyC,CAAC,iBAAiB,KAAK,IAAI,EACrE,CAAC;YACD,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,aAAa;QACX,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,aAAa;QACX,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/packages/server/dist/utils/bundledBinaryModelSupport.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Resolve the platform binary path (claude.exe on Windows, claude elsewhere) bundled inside
+ * @anthropic-ai/claude-agent-sdk, or null if not installed. Exported so CLI mode
+ * (cliSessionPool) can prefer this version-pinned engine over a system install — it is the
+ * same Claude Code CLI binary, so SDK and CLI modes run the identical engine.
+ */
+export declare function resolveBundledBinaryPath(): string | null;
 /**
  * True when `model` is a known native-1M model but the bundled binary does NOT
  * recognize it — so its 1M context silently falls back to ~200K. Conservative:

package/packages/server/dist/utils/bundledBinaryModelSupport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundledBinaryModelSupport.d.ts","sourceRoot":"","sources":["../../src/utils/bundledBinaryModelSupport.ts"],"names":[],"mappings":"AA8EA;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBlF"}
+{"version":3,"file":"bundledBinaryModelSupport.d.ts","sourceRoot":"","sources":["../../src/utils/bundledBinaryModelSupport.ts"],"names":[],"mappings":"AA2BA;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAUxD;AAwCD;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBlF"}

package/packages/server/dist/utils/bundledBinaryModelSupport.js

@@ -18,11 +18,16 @@ import { isNative1MModel } from '@hammoc/shared';
 import { createLogger } from './logger.js';
 const log = createLogger('bundledBinaryModelSupport');
 /** Claude model ids embedded in the binary, e.g. claude-opus-4-8, claude-sonnet-4-6, claude-opus-4-20250514. */
-const MODEL_ID_RE = /claude-(?:opus|sonnet|haiku)-[0-9]+(?:-[0-9]+)*/g;
+const MODEL_ID_RE = /claude-(?:opus|sonnet|haiku|fable|mythos)-[0-9]+(?:-[0-9]+)*/g;
 let cache = null;
 let scanPromise = null;
-/** Resolve the platform binary path (claude.exe on Windows, claude elsewhere), or null if not installed. */
-function resolveBundledBinaryPath() {
+/**
+ * Resolve the platform binary path (claude.exe on Windows, claude elsewhere) bundled inside
+ * @anthropic-ai/claude-agent-sdk, or null if not installed. Exported so CLI mode
+ * (cliSessionPool) can prefer this version-pinned engine over a system install — it is the
+ * same Claude Code CLI binary, so SDK and CLI modes run the identical engine.
+ */
+export function resolveBundledBinaryPath() {
     const pkg = `@anthropic-ai/claude-agent-sdk-${os.platform()}-${os.arch()}`;
     const exe = os.platform() === 'win32' ? 'claude.exe' : 'claude';
     try {
@@ -90,7 +95,7 @@ export async function modelMissingNative1MSupport(model) {
     const base = model.replace(/\[1m\]$/i, '');
     // Only fully-versioned ids are checkable against the binary; bare aliases like
     // 'opus'/'sonnet' resolve to a concrete model server-side, so skip them.
-    if (!/^claude-(?:opus|sonnet|haiku)-[0-9]/.test(base))
+    if (!/^claude-(?:opus|sonnet|haiku|fable|mythos)-[0-9]/.test(base))
         return false;
     if (!isNative1MModel(base))
         return false;

package/packages/server/dist/utils/bundledBinaryModelSupport.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundledBinaryModelSupport.js","sourceRoot":"","sources":["../../src/utils/bundledBinaryModelSupport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundledBinaryModelSupport.js","sourceRoot":"","sources":["../../src/utils/bundledBinaryModelSupport.ts"],"names":[],"mappings":"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"}

package/packages/server/dist/utils/cliDebugLog.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLI Debug Log — unified per-session decision trace for CLI-mode debugging.
+ *
+ * Records every classification/emit decision the server makes (screen parse → block
+ * type → client emit, file parse → block type → client emit) and every decision the
+ * client reports back (event received → segment classified → rendered). Both sides
+ * land in ONE chronological file so a post-mortem can diff server-emitted vs
+ * client-received at each timestamp.
+ *
+ * Activation: always-on when CLI engine runs (lightweight — one WriteStream per turn,
+ * best-effort writes). No env-var gate; the file is gitignored under `logs/`.
+ *
+ * Format (one JSON line per entry):
+ *   {"ts":"2026-06-20T10:15:32.123Z","src":"S","ev":"grid-card-emit","d":{...}}
+ *   {"ts":"2026-06-20T10:15:32.200Z","src":"C","ev":"recv-thinking","d":{...}}
+ *
+ * `src`: "S" = [CLILog-Server], "C" = [CLILog-Client]
+ */
+export interface CliDebugLogEntry {
+    ts: string;
+    src: 'S' | 'C';
+    ev: string;
+    d?: Record<string, unknown>;
+}
+export declare class CliDebugLog {
+    private stream;
+    readonly filePath: string;
+    constructor(sessionId: string);
+    /** Server-side decision log. */
+    server(event: string, data?: Record<string, unknown>): void;
+    /** Client-side decision log (relayed from browser via socket). */
+    client(event: string, data?: Record<string, unknown>): void;
+    /** Client-side decision log with original client timestamp preserved. */
+    clientWithTs(ts: string, event: string, data?: Record<string, unknown>): void;
+    close(): void;
+    private write;
+}
+//# sourceMappingURL=cliDebugLog.d.ts.map

package/packages/server/dist/utils/cliDebugLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliDebugLog.d.ts","sourceRoot":"","sources":["../../src/utils/cliDebugLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,SAAS,EAAE,MAAM;IAY7B,gCAAgC;IAChC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,kEAAkE;IAClE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,yEAAyE;IACzE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7E,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,KAAK;CAMd"}

package/packages/server/dist/utils/cliDebugLog.js

@@ -0,0 +1,65 @@
+/**
+ * CLI Debug Log — unified per-session decision trace for CLI-mode debugging.
+ *
+ * Records every classification/emit decision the server makes (screen parse → block
+ * type → client emit, file parse → block type → client emit) and every decision the
+ * client reports back (event received → segment classified → rendered). Both sides
+ * land in ONE chronological file so a post-mortem can diff server-emitted vs
+ * client-received at each timestamp.
+ *
+ * Activation: always-on when CLI engine runs (lightweight — one WriteStream per turn,
+ * best-effort writes). No env-var gate; the file is gitignored under `logs/`.
+ *
+ * Format (one JSON line per entry):
+ *   {"ts":"2026-06-20T10:15:32.123Z","src":"S","ev":"grid-card-emit","d":{...}}
+ *   {"ts":"2026-06-20T10:15:32.200Z","src":"C","ev":"recv-thinking","d":{...}}
+ *
+ * `src`: "S" = [CLILog-Server], "C" = [CLILog-Client]
+ */
+import { mkdirSync, createWriteStream } from 'fs';
+import path from 'path';
+const LOG_DIR = path.join(process.cwd(), 'logs', 'cli-debug');
+export class CliDebugLog {
+    stream = null;
+    filePath;
+    constructor(sessionId) {
+        const sid = sessionId || 'unknown';
+        const fname = `${sid}-${Date.now()}.jsonl`;
+        this.filePath = path.join(LOG_DIR, fname);
+        try {
+            mkdirSync(LOG_DIR, { recursive: true });
+            this.stream = createWriteStream(this.filePath, { encoding: 'utf8' });
+        }
+        catch {
+            // best-effort — never break the engine
+        }
+    }
+    /** Server-side decision log. */
+    server(event, data) {
+        this.write({ ts: new Date().toISOString(), src: 'S', ev: event, ...(data ? { d: data } : {}) });
+    }
+    /** Client-side decision log (relayed from browser via socket). */
+    client(event, data) {
+        this.write({ ts: new Date().toISOString(), src: 'C', ev: event, ...(data ? { d: data } : {}) });
+    }
+    /** Client-side decision log with original client timestamp preserved. */
+    clientWithTs(ts, event, data) {
+        this.write({ ts, src: 'C', ev: event, ...(data ? { d: data } : {}) });
+    }
+    close() {
+        try {
+            this.stream?.end();
+        }
+        catch { /* ignore */ }
+        this.stream = null;
+    }
+    write(entry) {
+        if (!this.stream)
+            return;
+        try {
+            this.stream.write(JSON.stringify(entry) + '\n');
+        }
+        catch { /* best-effort */ }
+    }
+}
+//# sourceMappingURL=cliDebugLog.js.map

package/packages/server/dist/utils/cliDebugLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliDebugLog.js","sourceRoot":"","sources":["../../src/utils/cliDebugLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAoB,MAAM,IAAI,CAAC;AACpE,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAE9D,MAAM,OAAO,WAAW;IACd,MAAM,GAAuB,IAAI,CAAC;IACjC,QAAQ,CAAS;IAE1B,YAAY,SAAiB;QAC3B,MAAM,GAAG,GAAG,SAAS,IAAI,SAAS,CAAC;QACnC,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,MAAM,CAAC,KAAa,EAAE,IAA8B;QAClD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAC,KAAa,EAAE,IAA8B;QAClD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,yEAAyE;IACzE,YAAY,CAAC,EAAU,EAAE,KAAa,EAAE,IAA8B;QACpE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,KAAuB;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/packages/server/dist/utils/cliEngineUtils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI Engine Utilities (Epic 33)
+ * Small pure helpers for the CLI conversation engine's call-site gating logic.
+ */
+import type { EngineMode } from '@hammoc/shared';
+/**
+ * Decide whether to forward the CLI engine's generation-progress callback
+ * (the "↓ N tokens · Ns" spinner counter, Story 32.7) to the browser.
+ *
+ * Gated on two conditions (Story 33.3):
+ *   1. the effective engine is the CLI engine (the SDK engine ignores the callback
+ *      anyway — real token streaming makes a counter unnecessary), and
+ *   2. the user's `cliShowGenerationProgress` preference is enabled (default ON when
+ *      unset — Story 33.2).
+ *
+ * When this returns false the call site passes `undefined`, so the engine's
+ * `emitProgress` early-returns and no `generation:progress` event is emitted.
+ */
+export declare function shouldForwardCliProgress(engineMode: EngineMode, showProgressPref: boolean | undefined): boolean;
+/**
+ * Decide whether to forward the CLI engine's raw-screen passthrough (the read-only PTY
+ * mirror) to the browser.
+ *
+ * Gated on two conditions:
+ *   1. the effective engine is the CLI engine (the SDK engine has no PTY and never
+ *      calls the callback anyway), and
+ *   2. the user's `cliPtyMirror` preference is enabled (default ON when unset — Story
+ *      37.7 promoted the mirror from a diagnostic opt-in to a default feature; the
+ *      `false` opt-out is still honored so a user can turn it off).
+ *
+ * When this returns false the call site passes `undefined`, so the engine's onData never
+ * invokes onScreenFrame and no `cli:screen-frame` event is emitted.
+ */
+export declare function shouldForwardCliPtyMirror(engineMode: EngineMode, mirrorPref: boolean | undefined): boolean;
+//# sourceMappingURL=cliEngineUtils.d.ts.map

package/packages/server/dist/utils/cliEngineUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliEngineUtils.d.ts","sourceRoot":"","sources":["../../src/utils/cliEngineUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,OAAO,GAAG,SAAS,GACpC,OAAO,CAET;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,OAAO,GAAG,SAAS,GAC9B,OAAO,CAET"}

package/packages/server/dist/utils/cliEngineUtils.js

@@ -0,0 +1,38 @@
+/**
+ * CLI Engine Utilities (Epic 33)
+ * Small pure helpers for the CLI conversation engine's call-site gating logic.
+ */
+/**
+ * Decide whether to forward the CLI engine's generation-progress callback
+ * (the "↓ N tokens · Ns" spinner counter, Story 32.7) to the browser.
+ *
+ * Gated on two conditions (Story 33.3):
+ *   1. the effective engine is the CLI engine (the SDK engine ignores the callback
+ *      anyway — real token streaming makes a counter unnecessary), and
+ *   2. the user's `cliShowGenerationProgress` preference is enabled (default ON when
+ *      unset — Story 33.2).
+ *
+ * When this returns false the call site passes `undefined`, so the engine's
+ * `emitProgress` early-returns and no `generation:progress` event is emitted.
+ */
+export function shouldForwardCliProgress(engineMode, showProgressPref) {
+    return engineMode === 'cli' && (showProgressPref ?? true);
+}
+/**
+ * Decide whether to forward the CLI engine's raw-screen passthrough (the read-only PTY
+ * mirror) to the browser.
+ *
+ * Gated on two conditions:
+ *   1. the effective engine is the CLI engine (the SDK engine has no PTY and never
+ *      calls the callback anyway), and
+ *   2. the user's `cliPtyMirror` preference is enabled (default ON when unset — Story
+ *      37.7 promoted the mirror from a diagnostic opt-in to a default feature; the
+ *      `false` opt-out is still honored so a user can turn it off).
+ *
+ * When this returns false the call site passes `undefined`, so the engine's onData never
+ * invokes onScreenFrame and no `cli:screen-frame` event is emitted.
+ */
+export function shouldForwardCliPtyMirror(engineMode, mirrorPref) {
+    return engineMode === 'cli' && (mirrorPref ?? true);
+}
+//# sourceMappingURL=cliEngineUtils.js.map

package/packages/server/dist/utils/cliEngineUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliEngineUtils.js","sourceRoot":"","sources":["../../src/utils/cliEngineUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAsB,EACtB,gBAAqC;IAErC,OAAO,UAAU,KAAK,KAAK,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAsB,EACtB,UAA+B;IAE/B,OAAO,UAAU,KAAK,KAAK,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/packages/server/dist/utils/effortUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effortUtils.d.ts","sourceRoot":"","sources":["../../src/utils/effortUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAU7H;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAM3E"}
+{"version":3,"file":"effortUtils.d.ts","sourceRoot":"","sources":["../../src/utils/effortUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAW7H;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAO3E"}

package/packages/server/dist/utils/effortUtils.js

@@ -12,8 +12,9 @@ export function clampEffortForModel(effort, model) {
     if (!effort)
         return effort;
     const supportsMax = !!model && (model === 'opus' || model === 'sonnet' ||
-        model.includes('opus-4-6') || model.includes('opus-4-7') || model.includes('opus-4-8') || model.includes('sonnet-4-6'));
-    const supportsXHigh = !!model && (model === 'opus' || model.includes('opus-4-7') || model.includes('opus-4-8'));
+        model.includes('opus-4-6') || model.includes('opus-4-7') || model.includes('opus-4-8') || model.includes('sonnet-4-6') ||
+        model.includes('fable'));
+    const supportsXHigh = !!model && (model === 'opus' || model.includes('opus-4-7') || model.includes('opus-4-8') || model.includes('fable'));
     if (effort === 'max' && !supportsMax)
         return 'high';
     if (effort === 'xhigh' && !supportsXHigh)
@@ -31,6 +32,7 @@ export function supportsAdaptiveThinking(model) {
     if (!model)
         return false;
     return (model === 'opus' || model === 'sonnet' ||
-        model.includes('opus-4-6') || model.includes('opus-4-7') || model.includes('opus-4-8') || model.includes('sonnet-4-6'));
+        model.includes('opus-4-6') || model.includes('opus-4-7') || model.includes('opus-4-8') || model.includes('sonnet-4-6') ||
+        model.includes('fable'));
 }
 //# sourceMappingURL=effortUtils.js.map

package/packages/server/dist/utils/effortUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"effortUtils.js","sourceRoot":"","sources":["../../src/utils/effortUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkC,EAAE,KAAyB;IAC/F,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,IAAI,CAC7B,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ;QACtC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CACvH,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAChH,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IACpD,IAAI,MAAM,KAAK,OAAO,IAAI,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC;IACxD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CACL,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ;QACtC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CACvH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"effortUtils.js","sourceRoot":"","sources":["../../src/utils/effortUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkC,EAAE,KAAyB;IAC/F,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,IAAI,CAC7B,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ;QACtC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QACtH,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CACxB,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3I,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IACpD,IAAI,MAAM,KAAK,OAAO,IAAI,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC;IACxD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CACL,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ;QACtC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QACtH,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CACxB,CAAC;AACJ,CAAC"}

package/packages/server/dist/utils/trailingThrottle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Trailing-edge throttle (Story 37.8) — paces CLI mirror screen frames so a burst of PTY
+ * redraws (the spinner repaints many times a second) collapses to at most one send per
+ * interval, while still guaranteeing the LATEST frame in the burst is delivered.
+ *
+ * Semantics:
+ *   - `schedule(value)` — leading edge: if nothing fired within the interval, run `fn`
+ *     immediately; otherwise stash `value` as pending and run it once when the interval
+ *     elapses (trailing edge, always the most recent value).
+ *   - `cancel()` — drop any pending value and clear the timer. Called at turn teardown,
+ *     which then sends the final screen directly (outside the throttle) so the last frame
+ *     is never lost to an unelapsed interval.
+ *
+ * Pure / timer-only: no xterm or socket coupling, so it unit-tests with fake timers.
+ */
+export interface TrailingThrottle<T> {
+    schedule(value: T): void;
+    cancel(): void;
+}
+export declare function createTrailingThrottle<T>(intervalMs: number, fn: (value: T) => void): TrailingThrottle<T>;
+//# sourceMappingURL=trailingThrottle.d.ts.map

package/packages/server/dist/utils/trailingThrottle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailingThrottle.d.ts","sourceRoot":"","sources":["../../src/utils/trailingThrottle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACzB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GACrB,gBAAgB,CAAC,CAAC,CAAC,CAoCrB"}

package/packages/server/dist/utils/trailingThrottle.js

@@ -0,0 +1,36 @@
+export function createTrailingThrottle(intervalMs, fn) {
+    let timer = null;
+    let pending = null;
+    const fire = (value) => {
+        // Open the cool-down window first; a schedule() during it stashes `pending`, which the
+        // trailing timer below flushes. Then run fn.
+        timer = setTimeout(onInterval, intervalMs);
+        fn(value);
+    };
+    function onInterval() {
+        timer = null;
+        if (pending) {
+            const { value } = pending;
+            pending = null;
+            fire(value); // trailing edge — re-opens the window so a steady stream keeps pacing
+        }
+    }
+    return {
+        schedule(value) {
+            if (timer === null) {
+                fire(value); // leading edge — nothing in flight, send immediately
+            }
+            else {
+                pending = { value }; // within the window — keep only the latest
+            }
+        },
+        cancel() {
+            if (timer !== null) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            pending = null;
+        },
+    };
+}
+//# sourceMappingURL=trailingThrottle.js.map

package/packages/server/dist/utils/trailingThrottle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailingThrottle.js","sourceRoot":"","sources":["../../src/utils/trailingThrottle.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,EAAsB;IAEtB,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,OAAO,GAAwB,IAAI,CAAC;IAExC,MAAM,IAAI,GAAG,CAAC,KAAQ,EAAQ,EAAE;QAC9B,uFAAuF;QACvF,6CAA6C;QAC7C,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC3C,EAAE,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC;IAEF,SAAS,UAAU;QACjB,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,sEAAsE;QACrF,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,CAAC,KAAQ;YACf,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,qDAAqD;YACpE,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,2CAA2C;YAClE,CAAC;QACH,CAAC;QACD,MAAM;YACJ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}