flaio-cli 0.3.1

package/dist/agents/session-metadata.js

@@ -0,0 +1,34 @@
+// ---------------------------------------------------------------------------
+// Per-session metadata store (cost, tokens, model, context window)
+// ---------------------------------------------------------------------------
+import { EventEmitter } from "node:events";
+/**
+ * Singleton metadata store — keyed by flaio session ID.
+ * Emits `"update"` with (sessionId, metadata) on every change.
+ */
+class SessionMetadataStore extends EventEmitter {
+    data = new Map();
+    get(sessionId) {
+        return this.data.get(sessionId);
+    }
+    update(sessionId, partial) {
+        const existing = this.data.get(sessionId) ?? {};
+        const merged = {
+            ...existing,
+            ...partial,
+            contextWindow: partial.contextWindow
+                ? { ...existing.contextWindow, ...partial.contextWindow }
+                : existing.contextWindow,
+        };
+        this.data.set(sessionId, merged);
+        this.emit("update", sessionId, merged);
+    }
+    remove(sessionId) {
+        this.data.delete(sessionId);
+    }
+    clear() {
+        this.data.clear();
+    }
+}
+export const sessionMetadataStore = new SessionMetadataStore();
+//# sourceMappingURL=session-metadata.js.map

package/dist/agents/session-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-metadata.js","sourceRoot":"","sources":["../../src/agents/session-metadata.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAqB3C;;;GAGG;AACH,MAAM,oBAAqB,SAAQ,YAAY;IACrC,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAElD,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,OAAiC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAoB;YAC9B,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,aAAa,EAAE,OAAO,CAAC,aAAa;gBAClC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE;gBACzD,CAAC,CAAC,QAAQ,CAAC,aAAa;SAC3B,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/agents/sideband/hook-scripts.d.ts

@@ -0,0 +1,29 @@
+export declare function installHookScripts(): Promise<{
+    hookPath: string;
+    statusLinePath: string;
+}>;
+/**
+ * Returns the hooks configuration object to merge into ~/.claude/settings.json.
+ * Claude Code hook format:
+ *   { "PreToolUse": [{ "matcher": "", "hooks": [{ "type": "command", "command": "..." }] }] }
+ * matcher is a regex string — "" or omitted matches all occurrences.
+ * Some events (Stop) don't support matchers — omit matcher for those.
+ */
+export declare function getClaudeHooksConfig(hookPath: string): Record<string, unknown>;
+/**
+ * Returns the status line configuration for ~/.claude/settings.json.
+ * See: https://code.claude.com/docs/en/statusline
+ */
+export declare function getClaudeStatusLineConfig(statusLinePath: string): Record<string, unknown>;
+/**
+ * Returns hooks config to merge into ~/.gemini/settings.json.
+ */
+export declare function getGeminiHooksConfig(hookPath: string): Record<string, unknown>;
+/**
+ * Reads a JSON settings file, deep-merges the patch, and writes it back.
+ * For hook arrays, appends our hook if not already present (preserves user hooks).
+ */
+export declare function mergeSettingsFile(filePath: string, patch: Record<string, unknown>): Promise<void>;
+export declare function areClaudeHooksConfigured(): Promise<boolean>;
+export declare function areGeminiHooksConfigured(): Promise<boolean>;
+//# sourceMappingURL=hook-scripts.d.ts.map

package/dist/agents/sideband/hook-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-scripts.d.ts","sourceRoot":"","sources":["../../../src/agents/sideband/hook-scripts.ts"],"names":[],"mappings":"AA0CA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAUhG;AAuBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB9E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzF;AAeD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW9E;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAcf;AAuED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CA4BjE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CAkBjE"}

package/dist/agents/sideband/hook-scripts.js

@@ -0,0 +1,259 @@
+// ---------------------------------------------------------------------------
+// Hook script installer + settings merger for Claude Code and Gemini CLI
+// ---------------------------------------------------------------------------
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+const HOOK_DIR = path.join(os.homedir(), ".config", "flaio", "hooks");
+// ---------------------------------------------------------------------------
+// Hook script content
+// ---------------------------------------------------------------------------
+/**
+ * Shell script that appends hook JSON from stdin to the sideband events file.
+ * No-op when FLAIO_SIDEBAND_DIR is not set (safe for normal CLI usage).
+ */
+const RELAY_HOOK_SH = `#!/bin/sh
+# Support both new and legacy env var names
+dir="\${FLAIO_SIDEBAND_DIR:-$CODE_RELAY_SIDEBAND_DIR}"
+[ -z "$dir" ] && exit 0
+cat >> "$dir/events.jsonl"
+printf '\\n' >> "$dir/events.jsonl"
+`;
+/**
+ * Shell script for Claude Code status line. Reads JSON from stdin,
+ * writes to metadata.json, then outputs a formatted display string.
+ */
+const RELAY_STATUSLINE_SH = `#!/bin/sh
+# Support both new and legacy env var names
+dir="\${FLAIO_SIDEBAND_DIR:-$CODE_RELAY_SIDEBAND_DIR}"
+[ -z "$dir" ] && exit 0
+input=$(cat)
+printf '%s' "$input" > "$dir/metadata.json"
+`;
+// ---------------------------------------------------------------------------
+// Install scripts to disk
+// ---------------------------------------------------------------------------
+export async function installHookScripts() {
+    await fs.mkdir(HOOK_DIR, { recursive: true });
+    const hookPath = path.join(HOOK_DIR, "relay-hook.sh");
+    const statusLinePath = path.join(HOOK_DIR, "relay-statusline.sh");
+    await fs.writeFile(hookPath, RELAY_HOOK_SH, { mode: 0o755 });
+    await fs.writeFile(statusLinePath, RELAY_STATUSLINE_SH, { mode: 0o755 });
+    return { hookPath, statusLinePath };
+}
+// ---------------------------------------------------------------------------
+// Claude Code settings hooks config
+// ---------------------------------------------------------------------------
+/** All Claude Code hook event names we want to intercept. */
+const CLAUDE_HOOK_EVENTS = [
+    "SessionStart",
+    "UserPromptSubmit",
+    "PreToolUse",
+    "PermissionRequest",
+    "PostToolUse",
+    "PostToolUseFailure",
+    "Notification",
+    "SubagentStart",
+    "SubagentStop",
+    "Stop",
+    "TaskCompleted",
+    "PreCompact",
+    "SessionEnd",
+];
+/**
+ * Returns the hooks configuration object to merge into ~/.claude/settings.json.
+ * Claude Code hook format:
+ *   { "PreToolUse": [{ "matcher": "", "hooks": [{ "type": "command", "command": "..." }] }] }
+ * matcher is a regex string — "" or omitted matches all occurrences.
+ * Some events (Stop) don't support matchers — omit matcher for those.
+ */
+export function getClaudeHooksConfig(hookPath) {
+    // Events that don't support matchers — always fire on every occurrence
+    const NO_MATCHER_EVENTS = new Set(["UserPromptSubmit", "Stop", "TaskCompleted"]);
+    const hooks = {};
+    for (const event of CLAUDE_HOOK_EVENTS) {
+        const entry = {
+            hooks: [
+                {
+                    type: "command",
+                    command: hookPath,
+                },
+            ],
+        };
+        if (!NO_MATCHER_EVENTS.has(event)) {
+            entry.matcher = "";
+        }
+        hooks[event] = [entry];
+    }
+    return { hooks };
+}
+/**
+ * Returns the status line configuration for ~/.claude/settings.json.
+ * See: https://code.claude.com/docs/en/statusline
+ */
+export function getClaudeStatusLineConfig(statusLinePath) {
+    return {
+        statusLine: {
+            type: "command",
+            command: statusLinePath,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Gemini CLI settings hooks config
+// ---------------------------------------------------------------------------
+const GEMINI_HOOK_EVENTS = [
+    "BeforeTool",
+    "AfterTool",
+    "BeforeAgent",
+    "AfterAgent",
+    "SessionStart",
+    "SessionEnd",
+];
+/**
+ * Returns hooks config to merge into ~/.gemini/settings.json.
+ */
+export function getGeminiHooksConfig(hookPath) {
+    const hooks = {};
+    for (const event of GEMINI_HOOK_EVENTS) {
+        hooks[event] = [
+            {
+                type: "command",
+                command: hookPath,
+            },
+        ];
+    }
+    return { hooks };
+}
+// ---------------------------------------------------------------------------
+// Settings file merger
+// ---------------------------------------------------------------------------
+/**
+ * Reads a JSON settings file, deep-merges the patch, and writes it back.
+ * For hook arrays, appends our hook if not already present (preserves user hooks).
+ */
+export async function mergeSettingsFile(filePath, patch) {
+    let existing = {};
+    try {
+        const text = await fs.readFile(filePath, "utf-8");
+        existing = JSON.parse(text);
+    }
+    catch {
+        // File doesn't exist or invalid JSON — start fresh
+    }
+    const merged = deepMergeHooks(existing, patch);
+    // Ensure parent directory exists
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(merged, null, 2) + "\n");
+}
+/**
+ * Deep merge that handles hooks specially: for hook arrays, removes any
+ * old-format entries with the same command, then adds/replaces with new-format
+ * entries. Preserves the user's OTHER hooks.
+ */
+function deepMergeHooks(target, source) {
+    const result = { ...target };
+    for (const [key, sourceVal] of Object.entries(source)) {
+        const targetVal = result[key];
+        if (key === "hooks" && isObj(targetVal) && isObj(sourceVal)) {
+            // Merge hook events individually
+            const mergedHooks = { ...targetVal };
+            for (const [event, hooks] of Object.entries(sourceVal)) {
+                if (!Array.isArray(hooks))
+                    continue;
+                let existing = Array.isArray(mergedHooks[event]) ? [...mergedHooks[event]] : [];
+                for (const hook of hooks) {
+                    const cmd = extractCommand(hook);
+                    if (cmd) {
+                        // Remove any existing entries (old or new format) with the same command
+                        existing = existing.filter((e) => {
+                            if (!isObj(e))
+                                return true;
+                            return extractCommand(e) !== cmd;
+                        });
+                    }
+                    existing.push(hook);
+                }
+                mergedHooks[event] = existing;
+            }
+            result[key] = mergedHooks;
+        }
+        else if (isObj(targetVal) && isObj(sourceVal)) {
+            result[key] = deepMergeHooks(targetVal, sourceVal);
+        }
+        else {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+function isObj(val) {
+    return val !== null && typeof val === "object" && !Array.isArray(val);
+}
+/** Extract the command string from a hook entry (supports both old and new format). */
+function extractCommand(entry) {
+    // New format: { matcher: {}, hooks: [{ type, command }] }
+    const entryHooks = entry.hooks;
+    if (Array.isArray(entryHooks) && entryHooks.length > 0) {
+        const first = entryHooks[0];
+        if (isObj(first) && typeof first.command === "string") {
+            return first.command;
+        }
+    }
+    // Old format: { type, command }
+    if (typeof entry.command === "string") {
+        return entry.command;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Check if hooks are already configured
+// ---------------------------------------------------------------------------
+export async function areClaudeHooksConfigured() {
+    try {
+        const settingsPath = path.join(os.homedir(), ".claude", "settings.json");
+        const text = await fs.readFile(settingsPath, "utf-8");
+        const settings = JSON.parse(text);
+        const hooks = settings?.hooks;
+        if (!hooks || typeof hooks !== "object")
+            return false;
+        // Check if at least SessionStart hook exists with our script
+        const sessionStartHooks = hooks.SessionStart;
+        if (!Array.isArray(sessionStartHooks))
+            return false;
+        const hookPath = path.join(HOOK_DIR, "relay-hook.sh");
+        return sessionStartHooks.some((entry) => {
+            if (!isObj(entry))
+                return false;
+            // New format: { matcher: {}, hooks: [{ type, command }] }
+            const entryHooks = entry.hooks;
+            if (Array.isArray(entryHooks)) {
+                return entryHooks.some((h) => isObj(h) && h.command === hookPath);
+            }
+            // Legacy format: { type, command }
+            return entry.command === hookPath;
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export async function areGeminiHooksConfigured() {
+    try {
+        const settingsPath = path.join(os.homedir(), ".gemini", "settings.json");
+        const text = await fs.readFile(settingsPath, "utf-8");
+        const settings = JSON.parse(text);
+        const hooks = settings?.hooks;
+        if (!hooks || typeof hooks !== "object")
+            return false;
+        const sessionStartHooks = hooks.SessionStart;
+        if (!Array.isArray(sessionStartHooks))
+            return false;
+        const hookPath = path.join(HOOK_DIR, "relay-hook.sh");
+        return sessionStartHooks.some((h) => isObj(h) && h.command === hookPath);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=hook-scripts.js.map

package/dist/agents/sideband/hook-scripts.js.map

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

package/dist/agents/sideband/sideband-receiver.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from "node:events";
+/**
+ * SidebandReceiver manages a per-session temp directory where hook scripts
+ * and status line scripts write data. It watches two files:
+ *
+ *   events.jsonl    — hook events (one JSON object per line, append-only)
+ *   metadata.json   — status line metadata (overwritten each update)
+ *
+ * Emits:
+ *   "hook"     (event: HookEvent)
+ *   "metadata" (data: SessionMetadata)
+ */
+export declare class SidebandReceiver extends EventEmitter {
+    private readonly sessionId;
+    private dir;
+    private eventsWatcher;
+    private metadataWatcher;
+    private eventsOffset;
+    private stopped;
+    constructor(sessionId: string);
+    /** The sideband temp directory path (available after start). */
+    get sidebandDir(): string | null;
+    /**
+     * Env vars to inject into the PTY spawn environment.
+     * Must be called after start().
+     */
+    getSpawnEnv(): Record<string, string>;
+    /** Create the temp dir and start watching. */
+    start(): Promise<void>;
+    /** Stop watching and clean up the temp directory. */
+    stop(): Promise<void>;
+    private watchEvents;
+    private readNewEvents;
+    private watchMetadata;
+    private readMetadata;
+}
+//# sourceMappingURL=sideband-receiver.d.ts.map

package/dist/agents/sideband/sideband-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sideband-receiver.d.ts","sourceRoot":"","sources":["../../../src/agents/sideband/sideband-receiver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAOpC,OAAO,CAAC,QAAQ,CAAC,SAAS;IANtC,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEK,SAAS,EAAE,MAAM;IAI9C,gEAAgE;IAChE,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED;;;OAGG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAWrC,8CAA8C;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,qDAAqD;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;CAWrB"}

package/dist/agents/sideband/sideband-receiver.js

@@ -0,0 +1,203 @@
+// ---------------------------------------------------------------------------
+// SidebandReceiver — watches temp dir for hook events + status line metadata
+// ---------------------------------------------------------------------------
+import { EventEmitter } from "node:events";
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+/**
+ * SidebandReceiver manages a per-session temp directory where hook scripts
+ * and status line scripts write data. It watches two files:
+ *
+ *   events.jsonl    — hook events (one JSON object per line, append-only)
+ *   metadata.json   — status line metadata (overwritten each update)
+ *
+ * Emits:
+ *   "hook"     (event: HookEvent)
+ *   "metadata" (data: SessionMetadata)
+ */
+export class SidebandReceiver extends EventEmitter {
+    sessionId;
+    dir = null;
+    eventsWatcher = null;
+    metadataWatcher = null;
+    eventsOffset = 0;
+    stopped = false;
+    constructor(sessionId) {
+        super();
+        this.sessionId = sessionId;
+    }
+    /** The sideband temp directory path (available after start). */
+    get sidebandDir() {
+        return this.dir;
+    }
+    /**
+     * Env vars to inject into the PTY spawn environment.
+     * Must be called after start().
+     */
+    getSpawnEnv() {
+        if (!this.dir)
+            return {};
+        return {
+            FLAIO_SESSION_ID: this.sessionId,
+            FLAIO_SIDEBAND_DIR: this.dir,
+            // Backward compat — remove in next major
+            CODE_RELAY_SESSION_ID: this.sessionId,
+            CODE_RELAY_SIDEBAND_DIR: this.dir,
+        };
+    }
+    /** Create the temp dir and start watching. */
+    async start() {
+        this.dir = await fsp.mkdtemp(path.join(os.tmpdir(), `flaio-${this.sessionId}-`));
+        // Pre-create the files so fs.watch has something to watch
+        const eventsPath = path.join(this.dir, "events.jsonl");
+        const metadataPath = path.join(this.dir, "metadata.json");
+        await fsp.writeFile(eventsPath, "");
+        await fsp.writeFile(metadataPath, "");
+        this.watchEvents(eventsPath);
+        this.watchMetadata(metadataPath);
+    }
+    /** Stop watching and clean up the temp directory. */
+    async stop() {
+        this.stopped = true;
+        if (this.eventsWatcher) {
+            this.eventsWatcher.close();
+            this.eventsWatcher = null;
+        }
+        if (this.metadataWatcher) {
+            this.metadataWatcher.close();
+            this.metadataWatcher = null;
+        }
+        if (this.dir) {
+            try {
+                await fsp.rm(this.dir, { recursive: true, force: true });
+            }
+            catch {
+                // Best effort cleanup
+            }
+            this.dir = null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // events.jsonl watcher — read new lines on change
+    // -------------------------------------------------------------------------
+    watchEvents(filePath) {
+        this.eventsWatcher = fs.watch(filePath, () => {
+            if (this.stopped)
+                return;
+            this.readNewEvents(filePath);
+        });
+    }
+    readNewEvents(filePath) {
+        let fd = null;
+        try {
+            fd = fs.openSync(filePath, "r");
+            const stat = fs.fstatSync(fd);
+            const bytesToRead = stat.size - this.eventsOffset;
+            if (bytesToRead <= 0) {
+                fs.closeSync(fd);
+                return;
+            }
+            const buf = Buffer.alloc(bytesToRead);
+            fs.readSync(fd, buf, 0, bytesToRead, this.eventsOffset);
+            this.eventsOffset = stat.size;
+            fs.closeSync(fd);
+            fd = null;
+            const text = buf.toString("utf-8");
+            const lines = text.split("\n").filter(Boolean);
+            for (const line of lines) {
+                try {
+                    const parsed = JSON.parse(line);
+                    this.emit("hook", parsed);
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        catch {
+            if (fd !== null) {
+                try {
+                    fs.closeSync(fd);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // metadata.json watcher — read and parse on change
+    // -------------------------------------------------------------------------
+    watchMetadata(filePath) {
+        // Debounce: status line may update rapidly
+        let debounceTimer = null;
+        this.metadataWatcher = fs.watch(filePath, () => {
+            if (this.stopped)
+                return;
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => {
+                this.readMetadata(filePath);
+            }, 200);
+        });
+    }
+    readMetadata(filePath) {
+        try {
+            const text = fs.readFileSync(filePath, "utf-8").trim();
+            if (!text)
+                return;
+            const raw = JSON.parse(text);
+            const metadata = normalizeMetadata(raw);
+            this.emit("metadata", metadata);
+        }
+        catch {
+            // File may be mid-write — will retry on next change
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Normalize snake_case keys from status line JSON → camelCase SessionMetadata
+// ---------------------------------------------------------------------------
+function normalizeMetadata(raw) {
+    const model = raw.model;
+    const cost = raw.cost;
+    const ctx = raw.context_window;
+    const metadata = {};
+    if (model) {
+        if (typeof model.id === "string")
+            metadata.modelId = model.id;
+        if (typeof model.display_name === "string")
+            metadata.modelDisplayName = model.display_name;
+    }
+    if (cost) {
+        if (typeof cost.total_cost_usd === "number")
+            metadata.totalCostUsd = cost.total_cost_usd;
+        if (typeof cost.total_duration_ms === "number")
+            metadata.totalDurationMs = cost.total_duration_ms;
+        if (typeof cost.total_lines_added === "number")
+            metadata.totalLinesAdded = cost.total_lines_added;
+        if (typeof cost.total_lines_removed === "number")
+            metadata.totalLinesRemoved = cost.total_lines_removed;
+    }
+    if (ctx) {
+        metadata.contextWindow = {};
+        if (typeof ctx.total_tokens === "number")
+            metadata.contextWindow.totalTokens = ctx.total_tokens;
+        if (typeof ctx.used_tokens === "number")
+            metadata.contextWindow.usedTokens = ctx.used_tokens;
+        if (typeof ctx.used_percentage === "number")
+            metadata.contextWindow.usedPercentage = ctx.used_percentage;
+        if (typeof ctx.cache_creation_tokens === "number")
+            metadata.contextWindow.cacheCreationTokens = ctx.cache_creation_tokens;
+        if (typeof ctx.cache_read_tokens === "number")
+            metadata.contextWindow.cacheReadTokens = ctx.cache_read_tokens;
+    }
+    if (typeof raw.session_id === "string")
+        metadata.sessionId = raw.session_id;
+    if (typeof raw.transcript_path === "string")
+        metadata.transcriptPath = raw.transcript_path;
+    if (typeof raw.version === "string")
+        metadata.version = raw.version;
+    return metadata;
+}
+//# sourceMappingURL=sideband-receiver.js.map

package/dist/agents/sideband/sideband-receiver.js.map

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

package/dist/agents/sideband/status-resolver.d.ts

@@ -0,0 +1,55 @@
+import type { AgentStatus } from "../drivers/base-driver.js";
+export type DetailedStatus = {
+    state: "running";
+    detail: "thinking" | "tool_use" | "writing" | "subagent" | "compacting" | "general";
+} | {
+    state: "waiting_input";
+    detail: "prompt" | "idle_timeout" | "ask_question" | "task_completed";
+} | {
+    state: "waiting_permission";
+    detail: "tool_approval";
+} | {
+    state: "starting";
+} | {
+    state: "idle";
+} | {
+    state: "exited";
+};
+export interface ResolvedStatus {
+    agentStatus: AgentStatus;
+    detailed: DetailedStatus;
+    toolName?: string;
+}
+/** Raw hook event as written to the JSONL sideband file. */
+export interface HookEvent {
+    /** Hook name, e.g. "PreToolUse", "Stop", "Notification" */
+    hook: string;
+    /** Session ID from the CLI (Claude's internal session ID) */
+    sessionId?: string;
+    /** Tool name (PreToolUse / PostToolUse / PostToolUseFailure) */
+    toolName?: string;
+    /** Error message (PostToolUseFailure) */
+    error?: string;
+    /** Notification type: "permission_prompt", "idle_prompt", "elicitation_dialog" */
+    notificationType?: string;
+    /** Model info from SessionStart */
+    model?: string;
+    /** Raw JSON payload passed via stdin (kept for forward-compatibility) */
+    raw?: Record<string, unknown>;
+}
+export declare function resolveFromClaudeHook(event: HookEvent): ResolvedStatus;
+/**
+ * Parse Gemini's OSC title string to determine status.
+ * Gemini CLI with `--show-status` sets terminal title via OSC:
+ *  - "◇ Ready" → waiting_input
+ *  - "✦ Working" → running
+ *  - "✋ Action Required" → waiting_permission
+ */
+export declare function resolveFromGeminiOscTitle(title: string): ResolvedStatus | null;
+export declare function resolveFromGeminiHook(event: HookEvent): ResolvedStatus;
+/**
+ * Extract OSC title from raw PTY data.
+ * OSC format: ESC ] 0 ; <title> BEL  or  ESC ] 0 ; <title> ESC \
+ */
+export declare function extractOscTitle(data: string): string | null;
+//# sourceMappingURL=status-resolver.d.ts.map

package/dist/agents/sideband/status-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-resolver.d.ts","sourceRoot":"","sources":["../../../src/agents/sideband/status-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAM7D,MAAM,MAAM,cAAc,GACtB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAA;CAAE,GACzG;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,CAAA;CAAE,GACjG;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACxD;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GACrB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAQD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CA2GtE;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAyB9E;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAgDtE;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D"}