@0xmaxma/claude-gateway 1.2.32 → 1.3.0

package/dist/shell/emitter.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtocolEmitter = void 0;
+/**
+ * Synthesizes the stream-json events the gateway's SessionProcess stdout
+ * parser consumes (src/session/process.ts). Every assistant event is emitted
+ * as a FINAL message (top-level stop_reason set): the parser then appends the
+ * full text as a fresh delta and resets its partial tracking, which is what
+ * makes mid-turn (message-level streaming) emission safe.
+ */
+class ProtocolEmitter {
+    constructor(out = process.stdout) {
+        this.out = out;
+    }
+    writeLine(obj) {
+        this.out.write(JSON.stringify(obj) + '\n');
+    }
+    emitInit(sessionId, model, cwd) {
+        this.writeLine({
+            type: 'system',
+            subtype: 'init',
+            session_id: sessionId,
+            model,
+            cwd,
+            tools: [],
+        });
+    }
+    /**
+     * Context-size shim: the gateway reads usage from stream_event/message_start
+     * to display context %. Transcript assistant records carry the same usage,
+     * so replay it. Emitted before each assistant event; the gateway keeps the
+     * latest value and applies it at result time.
+     */
+    emitMessageStartShim(usage, sessionId) {
+        this.writeLine({
+            type: 'stream_event',
+            session_id: sessionId,
+            event: {
+                type: 'message_start',
+                message: {
+                    usage: {
+                        input_tokens: usage.input_tokens ?? 0,
+                        cache_read_input_tokens: usage.cache_read_input_tokens ?? 0,
+                        cache_creation_input_tokens: usage.cache_creation_input_tokens ?? 0,
+                    },
+                },
+            },
+        });
+    }
+    /**
+     * Emit one transcript assistant record as a final assistant event.
+     * Thinking blocks are stripped (the gateway only consumes text and
+     * tool_use blocks; thinking content must not leak into chat history).
+     * Returns the text contained in the record, '' if none.
+     */
+    emitAssistant(record, sessionId) {
+        const blocks = record.message.content.filter((b) => b.type === 'text' || b.type === 'tool_use');
+        if (blocks.length === 0)
+            return '';
+        this.writeLine({
+            type: 'assistant',
+            session_id: sessionId,
+            stop_reason: record.message.stop_reason ?? 'end_turn',
+            message: { role: 'assistant', content: blocks },
+        });
+        return blocks
+            .filter((b) => b.type === 'text')
+            .map((b) => String(b.text ?? ''))
+            .join('');
+    }
+    emitResult(opts) {
+        this.writeLine({
+            type: 'result',
+            subtype: opts.isError ? 'error_during_execution' : 'success',
+            is_error: opts.isError,
+            result: opts.text,
+            duration_ms: opts.durationMs,
+            num_turns: 1,
+            session_id: opts.sessionId,
+            usage: { output_tokens: opts.usage?.output_tokens ?? 0 },
+        });
+    }
+}
+exports.ProtocolEmitter = ProtocolEmitter;
+//# sourceMappingURL=emitter.js.map

package/dist/shell/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/shell/emitter.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,MAAa,eAAe;IAC1B,YAA6B,MAA6B,OAAO,CAAC,MAAM;QAA3C,QAAG,GAAH,GAAG,CAAwC;IAAG,CAAC;IAEpE,SAAS,CAAC,GAA4B;QAC5C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,KAAa,EAAE,GAAW;QACpD,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,SAAS;YACrB,KAAK;YACL,GAAG;YACH,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,KAAgB,EAAE,SAAiB;QACtD,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE;gBACL,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE;oBACP,KAAK,EAAE;wBACL,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;wBACrC,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,IAAI,CAAC;wBAC3D,2BAA2B,EAAE,KAAK,CAAC,2BAA2B,IAAI,CAAC;qBACpE;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,MAAuB,EAAE,SAAiB;QACtD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAClD,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,UAAU;YACrD,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;SAChD,CAAC,CAAC;QAEH,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAE,CAAwB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;aACxD,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED,UAAU,CAAC,IAMV;QACC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS;YAC5D,QAAQ,EAAE,IAAI,CAAC,OAAO;YACtB,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,EAAE;SACzD,CAAC,CAAC;IACL,CAAC;CACF;AApFD,0CAoFC"}

package/dist/shell/pty-host.d.ts

@@ -0,0 +1,21 @@
+export interface PtyHostOptions {
+    cols: number;
+    rows: number;
+    cwd: string;
+    onData: (data: string) => void;
+    onExit: (exitCode: number) => void;
+}
+/** Hosts the real interactive `claude` inside a pseudo-terminal. */
+export declare class PtyHost {
+    private child;
+    constructor(binary: string, args: string[], opts: PtyHostOptions);
+    /** Raw keystroke write (control sequences allowed — caller sanitizes user text). */
+    writeRaw(data: string): void;
+    /**
+     * Paste large text without overwhelming the PTY line discipline:
+     * chunked writes with small delays.
+     */
+    writeChunked(data: string): Promise<void>;
+    kill(signal?: string): void;
+}
+//# sourceMappingURL=pty-host.d.ts.map

package/dist/shell/pty-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-host.d.ts","sourceRoot":"","sources":["../../src/shell/pty-host.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,oEAAoE;AACpE,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAW;gBAEZ,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc;IAiBhE,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAO5B"}

package/dist/shell/pty-host.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PtyHost = void 0;
+const path = __importStar(require("path"));
+const pty = __importStar(require("node-pty"));
+const WRITE_CHUNK_BYTES = 8 * 1024;
+const WRITE_CHUNK_DELAY_MS = 10;
+// Keys matching these prefixes are scrubbed before spawning the child PTY:
+// CLAUDECODE/CLAUDE_CODE_ prevent nested-claude child-session behavior that
+// silently stops transcript JSONL writes; CLAUDE_REAL_BIN is a wrapper-only
+// variable and must not leak into the child.
+const SCRUB_ENV_PREFIXES = ['CLAUDECODE', 'CLAUDE_CODE_', 'CLAUDE_REAL_BIN', 'PTY_SHELL_'];
+// Auth vars that share the CLAUDE_CODE_ prefix but must be kept.
+const SCRUB_ENV_KEEPLIST = new Set(['CLAUDE_CODE_OAUTH_TOKEN']);
+function childEnv() {
+    const env = { ...process.env };
+    for (const key of Object.keys(env)) {
+        if (!SCRUB_ENV_KEEPLIST.has(key) &&
+            SCRUB_ENV_PREFIXES.some((p) => key.startsWith(p))) {
+            delete env[key];
+        }
+    }
+    return env;
+}
+/** Hosts the real interactive `claude` inside a pseudo-terminal. */
+class PtyHost {
+    constructor(binary, args, opts) {
+        // Recursion guard: CLAUDE_BIN points at this wrapper; the wrapper must
+        // never resolve the "real" binary back to itself.
+        if (path.basename(binary).includes('claude-pty-shell')) {
+            throw new Error(`refusing to spawn self as claude binary: ${binary}`);
+        }
+        this.child = pty.spawn(binary, args, {
+            name: 'xterm-256color',
+            cols: opts.cols,
+            rows: opts.rows,
+            cwd: opts.cwd,
+            env: childEnv(),
+        });
+        this.child.onData(opts.onData);
+        this.child.onExit(({ exitCode }) => opts.onExit(exitCode));
+    }
+    /** Raw keystroke write (control sequences allowed — caller sanitizes user text). */
+    writeRaw(data) {
+        this.child.write(data);
+    }
+    /**
+     * Paste large text without overwhelming the PTY line discipline:
+     * chunked writes with small delays.
+     */
+    async writeChunked(data) {
+        for (let i = 0; i < data.length; i += WRITE_CHUNK_BYTES) {
+            this.child.write(data.slice(i, i + WRITE_CHUNK_BYTES));
+            if (i + WRITE_CHUNK_BYTES < data.length) {
+                await new Promise((r) => setTimeout(r, WRITE_CHUNK_DELAY_MS));
+            }
+        }
+    }
+    kill(signal) {
+        try {
+            this.child.kill(signal);
+        }
+        catch {
+            /* already dead */
+        }
+    }
+}
+exports.PtyHost = PtyHost;
+//# sourceMappingURL=pty-host.js.map

package/dist/shell/pty-host.js.map

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

package/dist/shell/screen.d.ts

@@ -0,0 +1,44 @@
+export type DialogKind = 'bypass-permissions' | 'trust-folder' | 'unknown-select';
+/**
+ * TUI string constants — verified against Claude Code v2.1.x.
+ * When upgrading Claude Code, re-check each constant against the new TUI output.
+ * All matchers live here so a UI change requires touching exactly one file.
+ *
+ *   BUSY_MARKER        status bar text during an active turn
+ *   PROMPT_RE          idle input caret pattern
+ *   BYPASS_PERMS       "Bypass Permissions" dialog markers
+ *   TRUST_FOLDER       workspace trust dialog marker
+ *   NUMBERED_SELECT_RE generic numbered select — combined with CONFIRM_MARKER
+ */
+export declare const TUI_BUSY_MARKER = "esc to interrupt";
+export declare const TUI_PROMPT_RE: RegExp;
+export declare const TUI_BYPASS_PERMS: readonly ["Bypass Permissions mode", "Yes, I accept"];
+export declare const TUI_TRUST_FOLDER = "Do you trust the files in this folder";
+export declare const TUI_NUMBERED_SELECT_RE: RegExp;
+export declare const TUI_CONFIRM_MARKER = "Enter to confirm";
+/**
+ * Virtual terminal fed with raw PTY bytes. Used ONLY for liveness signals
+ * (busy / idle / dialog detection) — assistant text is never parsed from
+ * the screen; the transcript JSONL is the text source of truth.
+ */
+export declare class ScreenModel {
+    readonly cols: number;
+    readonly rows: number;
+    private term;
+    private lastDataTs;
+    /** Set when a busy marker is seen in a raw chunk; survives fast busy→idle flips between polls. */
+    private busySeenInRaw;
+    constructor(cols?: number, rows?: number);
+    write(data: string): void;
+    /** Milliseconds since the PTY last produced output. */
+    quietMs(): number;
+    text(): string;
+    /** Claude is processing a turn (spinner area shows "esc to interrupt"). */
+    isBusy(): boolean;
+    /** Consume the raw-chunk busy flag (catches turns faster than the poll interval). */
+    consumeBusySeen(): boolean;
+    /** Idle input prompt is on screen. */
+    hasPrompt(): boolean;
+    detectDialog(): DialogKind | null;
+}
+//# sourceMappingURL=screen.d.ts.map

package/dist/shell/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../src/shell/screen.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAOlF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAClD,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,eAAO,MAAM,gBAAgB,uDAAwD,CAAC;AACtF,eAAO,MAAM,gBAAgB,0CAA0C,CAAC;AACxE,eAAO,MAAM,sBAAsB,QAAU,CAAC;AAC9C,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,qBAAa,WAAW;aAMM,IAAI;aAAwB,IAAI;IAL5D,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,UAAU,CAAc;IAChC,kGAAkG;IAClG,OAAO,CAAC,aAAa,CAAS;gBAEF,IAAI,SAAM,EAAkB,IAAI,SAAK;IAIjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,uDAAuD;IACvD,OAAO,IAAI,MAAM;IAIjB,IAAI,IAAI,MAAM;IAUd,2EAA2E;IAC3E,MAAM,IAAI,OAAO;IAIjB,qFAAqF;IACrF,eAAe,IAAI,OAAO;IAM1B,sCAAsC;IACtC,SAAS,IAAI,OAAO;IAIpB,YAAY,IAAI,UAAU,GAAG,IAAI;CAclC"}

package/dist/shell/screen.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenModel = exports.TUI_CONFIRM_MARKER = exports.TUI_NUMBERED_SELECT_RE = exports.TUI_TRUST_FOLDER = exports.TUI_BYPASS_PERMS = exports.TUI_PROMPT_RE = exports.TUI_BUSY_MARKER = void 0;
+const headless_1 = require("@xterm/headless");
+/** The TUI renders spaces as U+00A0 (non-breaking) — normalize before matching. */
+function normalize(text) {
+    return text.replace(/ /g, ' ');
+}
+/**
+ * TUI string constants — verified against Claude Code v2.1.x.
+ * When upgrading Claude Code, re-check each constant against the new TUI output.
+ * All matchers live here so a UI change requires touching exactly one file.
+ *
+ *   BUSY_MARKER        status bar text during an active turn
+ *   PROMPT_RE          idle input caret pattern
+ *   BYPASS_PERMS       "Bypass Permissions" dialog markers
+ *   TRUST_FOLDER       workspace trust dialog marker
+ *   NUMBERED_SELECT_RE generic numbered select — combined with CONFIRM_MARKER
+ */
+exports.TUI_BUSY_MARKER = 'esc to interrupt';
+exports.TUI_PROMPT_RE = /^❯ /m;
+exports.TUI_BYPASS_PERMS = ['Bypass Permissions mode', 'Yes, I accept'];
+exports.TUI_TRUST_FOLDER = 'Do you trust the files in this folder';
+exports.TUI_NUMBERED_SELECT_RE = /❯ 1\./;
+exports.TUI_CONFIRM_MARKER = 'Enter to confirm';
+/**
+ * Virtual terminal fed with raw PTY bytes. Used ONLY for liveness signals
+ * (busy / idle / dialog detection) — assistant text is never parsed from
+ * the screen; the transcript JSONL is the text source of truth.
+ */
+class ScreenModel {
+    constructor(cols = 200, rows = 50) {
+        this.cols = cols;
+        this.rows = rows;
+        this.lastDataTs = Date.now();
+        /** Set when a busy marker is seen in a raw chunk; survives fast busy→idle flips between polls. */
+        this.busySeenInRaw = false;
+        this.term = new headless_1.Terminal({ cols, rows, allowProposedApi: true });
+    }
+    write(data) {
+        this.lastDataTs = Date.now();
+        if (normalize(data).includes(exports.TUI_BUSY_MARKER))
+            this.busySeenInRaw = true;
+        this.term.write(data);
+    }
+    /** Milliseconds since the PTY last produced output. */
+    quietMs() {
+        return Date.now() - this.lastDataTs;
+    }
+    text() {
+        const buf = this.term.buffer.active;
+        const lines = [];
+        for (let i = 0; i < this.term.rows; i++) {
+            const line = buf.getLine(buf.viewportY + i);
+            lines.push(line ? line.translateToString(true) : '');
+        }
+        return normalize(lines.join('\n'));
+    }
+    /** Claude is processing a turn (spinner area shows "esc to interrupt"). */
+    isBusy() {
+        return this.text().includes(exports.TUI_BUSY_MARKER);
+    }
+    /** Consume the raw-chunk busy flag (catches turns faster than the poll interval). */
+    consumeBusySeen() {
+        const seen = this.busySeenInRaw;
+        this.busySeenInRaw = false;
+        return seen;
+    }
+    /** Idle input prompt is on screen. */
+    hasPrompt() {
+        return exports.TUI_PROMPT_RE.test(this.text());
+    }
+    detectDialog() {
+        const text = this.text();
+        if (exports.TUI_BYPASS_PERMS.every((s) => text.includes(s))) {
+            return 'bypass-permissions';
+        }
+        if (text.includes(exports.TUI_TRUST_FOLDER)) {
+            return 'trust-folder';
+        }
+        // Generic numbered select dialog while no turn output is flowing.
+        if (!text.includes(exports.TUI_BUSY_MARKER) && exports.TUI_NUMBERED_SELECT_RE.test(text) && text.includes(exports.TUI_CONFIRM_MARKER)) {
+            return 'unknown-select';
+        }
+        return null;
+    }
+}
+exports.ScreenModel = ScreenModel;
+//# sourceMappingURL=screen.js.map

package/dist/shell/screen.js.map

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

package/dist/shell/tailer.d.ts

@@ -0,0 +1,64 @@
+export interface UsageInfo {
+    input_tokens?: number;
+    cache_read_input_tokens?: number;
+    cache_creation_input_tokens?: number;
+    output_tokens?: number;
+}
+export interface AssistantRecord {
+    type: 'assistant';
+    isSidechain?: boolean;
+    message: {
+        role: 'assistant';
+        content: Array<{
+            type: string;
+            [k: string]: unknown;
+        }>;
+        stop_reason?: string | null;
+        usage?: UsageInfo;
+    };
+    uuid?: string;
+    timestamp?: string;
+}
+export interface TailerEvents {
+    /** A new (non-sidechain) assistant record was appended. */
+    onAssistant: (record: AssistantRecord) => void;
+    /** Claude finished a turn (system/turn_duration record). */
+    onTurnEnd: (durationMs: number) => void;
+    onError: (err: Error) => void;
+}
+/**
+ * cwd → Claude Code project-dir slug (verified against v2.1.x: `/` and `.` both become `-`).
+ * If Claude Code ever changes this scheme, findFile()'s fallback UUID scan will still
+ * locate the transcript — the primary path is just an optimistic fast path.
+ */
+export declare function projectSlug(cwd: string): string;
+export declare function transcriptPath(cwd: string, sessionId: string): string;
+/**
+ * Incrementally reads the session transcript JSONL that interactive Claude
+ * Code appends to *during* a turn. This is the text source of truth and the
+ * streaming source: records are surfaced the moment they hit the file.
+ */
+export declare class TranscriptTailer {
+    private readonly cwd;
+    private readonly sessionId;
+    private readonly events;
+    private readonly pollMs;
+    private offset;
+    private partialLine;
+    private timer;
+    private resolvedPath;
+    /** Total records dispatched since start — non-zero means claude is writing output. */
+    seenRecords: number;
+    /** Timestamp of last fallback scan — caps expensive readdirSync to once per 2s. */
+    private lastFallbackScanMs;
+    private static readonly FALLBACK_SCAN_INTERVAL_MS;
+    constructor(cwd: string, sessionId: string, events: TailerEvents, pollMs?: number);
+    start(): void;
+    stop(): void;
+    /** Force one synchronous read (used right before emitting a result). */
+    flush(): void;
+    private findFile;
+    private poll;
+    private dispatch;
+}
+//# sourceMappingURL=tailer.d.ts.map

package/dist/shell/tailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailer.d.ts","sourceRoot":"","sources":["../../src/shell/tailer.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE;QACP,IAAI,EAAE,WAAW,CAAC;QAClB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QACvD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,KAAK,CAAC,EAAE,SAAS,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,WAAW,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/C,4DAA4D;IAC5D,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAYzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAuB;IAC3C,sFAAsF;IACtF,WAAW,SAAK;IAChB,mFAAmF;IACnF,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAS;gBAGvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,MAAM,SAAM;IAG/B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAKZ,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,IAAI;IA2CZ,OAAO,CAAC,QAAQ;CAejB"}

package/dist/shell/tailer.js

@@ -0,0 +1,181 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranscriptTailer = void 0;
+exports.projectSlug = projectSlug;
+exports.transcriptPath = transcriptPath;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * cwd → Claude Code project-dir slug (verified against v2.1.x: `/` and `.` both become `-`).
+ * If Claude Code ever changes this scheme, findFile()'s fallback UUID scan will still
+ * locate the transcript — the primary path is just an optimistic fast path.
+ */
+function projectSlug(cwd) {
+    return cwd.replace(/[/.]/g, '-');
+}
+function transcriptPath(cwd, sessionId) {
+    return path.join(os.homedir(), '.claude', 'projects', projectSlug(cwd), `${sessionId}.jsonl`);
+}
+/**
+ * Incrementally reads the session transcript JSONL that interactive Claude
+ * Code appends to *during* a turn. This is the text source of truth and the
+ * streaming source: records are surfaced the moment they hit the file.
+ */
+class TranscriptTailer {
+    constructor(cwd, sessionId, events, pollMs = 150) {
+        this.cwd = cwd;
+        this.sessionId = sessionId;
+        this.events = events;
+        this.pollMs = pollMs;
+        this.offset = 0;
+        this.partialLine = '';
+        this.timer = null;
+        this.resolvedPath = null;
+        /** Total records dispatched since start — non-zero means claude is writing output. */
+        this.seenRecords = 0;
+        /** Timestamp of last fallback scan — caps expensive readdirSync to once per 2s. */
+        this.lastFallbackScanMs = 0;
+    }
+    start() {
+        this.timer = setInterval(() => this.poll(), this.pollMs);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** Force one synchronous read (used right before emitting a result). */
+    flush() {
+        this.poll();
+    }
+    findFile() {
+        if (this.resolvedPath)
+            return this.resolvedPath;
+        const expected = transcriptPath(this.cwd, this.sessionId);
+        if (fs.existsSync(expected)) {
+            this.resolvedPath = expected;
+            return expected;
+        }
+        // Fallback if the slug scheme ever changes: scan project dirs for the uuid.
+        // Capped to once per 2s — readdirSync over hundreds of project dirs every 150ms poll
+        // is expensive before the transcript file has been created.
+        const now = Date.now();
+        if (now - this.lastFallbackScanMs < TranscriptTailer.FALLBACK_SCAN_INTERVAL_MS)
+            return null;
+        this.lastFallbackScanMs = now;
+        const projectsRoot = path.join(os.homedir(), '.claude', 'projects');
+        let dirs = [];
+        try {
+            dirs = fs.readdirSync(projectsRoot);
+        }
+        catch {
+            return null;
+        }
+        for (const dir of dirs) {
+            const candidate = path.join(projectsRoot, dir, `${this.sessionId}.jsonl`);
+            if (fs.existsSync(candidate)) {
+                this.resolvedPath = candidate;
+                return candidate;
+            }
+        }
+        return null;
+    }
+    poll() {
+        const file = this.findFile();
+        if (!file)
+            return;
+        let size;
+        try {
+            size = fs.statSync(file).size;
+        }
+        catch {
+            return; // transient: file rotated/removed
+        }
+        if (size <= this.offset)
+            return;
+        let chunk;
+        try {
+            const fd = fs.openSync(file, 'r');
+            const buf = Buffer.alloc(size - this.offset);
+            fs.readSync(fd, buf, 0, buf.length, this.offset);
+            fs.closeSync(fd);
+            chunk = buf.toString('utf8');
+        }
+        catch (err) {
+            this.events.onError(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        this.offset = size;
+        const data = this.partialLine + chunk;
+        const lines = data.split('\n');
+        this.partialLine = lines.pop() ?? '';
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            let record;
+            try {
+                record = JSON.parse(line);
+            }
+            catch {
+                // Mid-write torn line should be impossible (we split on \n), so a bad
+                // line is real corruption — surface it, never swallow.
+                this.events.onError(new Error(`unparseable transcript line (${line.length} bytes)`));
+                continue;
+            }
+            this.dispatch(record);
+        }
+    }
+    dispatch(record) {
+        if (record.isSidechain === true)
+            return; // subagent-internal records
+        this.seenRecords++;
+        if (record.type === 'assistant') {
+            const message = record.message;
+            if (message && Array.isArray(message.content)) {
+                this.events.onAssistant(record);
+            }
+            return;
+        }
+        if (record.type === 'system' && record.subtype === 'turn_duration') {
+            const durationMs = typeof record.durationMs === 'number' ? record.durationMs : 0;
+            this.events.onTurnEnd(durationMs);
+        }
+    }
+}
+exports.TranscriptTailer = TranscriptTailer;
+TranscriptTailer.FALLBACK_SCAN_INTERVAL_MS = 2000;
+//# sourceMappingURL=tailer.js.map

package/dist/shell/tailer.js.map

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

package/dist/types.d.ts

@@ -29,7 +29,8 @@ export interface AgentConfig {
     };
     claude: {
         model: string;
-        dangerouslySkipPermissions: boolean;
+        /** @deprecated --dangerously-skip-permissions is always passed now; this field is ignored. */
+        dangerouslySkipPermissions?: boolean;
         extraFlags: string[];
     };
     /** Heartbeat / cron settings */
@@ -81,6 +82,11 @@ export interface GatewayConfig {
         api?: {
             keys: ApiKey[];
         };
+        /**
+         * true (default) = headless backend (claude --print + stream-json).
+         * false = interactive backend: claude TUI under the claude-pty-shell PTY wrapper.
+         */
+        headless?: boolean;
         /** Global history retention/cleanup defaults */
         history?: HistoryConfig & {
             cleanupHour?: number;