pi-ca-leash 1.1.0 → 1.2.0

package/node_modules/@pi-claude-code-agent/runtime/dist/drivers/claude-interactive.js

@@ -0,0 +1,404 @@
+import { mkdirSync, readdirSync, readSync, openSync, closeSync, fstatSync, writeFileSync, existsSync, } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { coerceClaudeCliSessionId } from "./claude-cli.js";
+import { parseClaudeSdkMessage } from "./claude-sdk.js";
+import { enrichInitWithCapabilities, foldThinkingLevelForClaude } from "./thinking.js";
+const DEFAULTS = {
+    readyQuietMs: 600,
+    readyTimeoutMs: 15_000,
+    submitDelayMs: 40,
+    pollIntervalMs: 120,
+    turnTimeoutMs: 10 * 60_000,
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** POSIX single-quote a string for safe embedding in a shell command. */
+function shSingleQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function buildInteractiveArgs(input) {
+    // No `-p`: bare `claude` launches the interactive TUI. We pre-assign the
+    // session id so we can find its transcript JSONL by filename, and inject a
+    // per-invocation settings file carrying our Stop hook.
+    const args = [
+        "--session-id",
+        input.claudeSessionId,
+        "--settings",
+        input.settingsPath,
+        // yolo-only: interactive permission prompts are not automated yet, so we
+        // always launch without them. `run()` refuses securityMode "safe" before
+        // ever reaching here, so this is never a silent sandbox downgrade.
+        "--dangerously-skip-permissions",
+    ];
+    if (input.model)
+        args.push("--model", input.model);
+    if (input.appendSystemPrompt)
+        args.push("--append-system-prompt", input.appendSystemPrompt);
+    if (input.additionalDirectories?.length)
+        args.push("--add-dir", ...input.additionalDirectories);
+    if (input.effort)
+        args.push("--effort", input.effort);
+    return args;
+}
+function stopHookSettings(signalPath) {
+    // Append one line per turn end. `printf` is dependency-free (no jq/node) and
+    // the path is single-quoted so spaces in the storage dir are safe.
+    const command = `printf 'stop\\n' >> ${shSingleQuote(signalPath)}`;
+    return JSON.stringify({ hooks: { Stop: [{ hooks: [{ type: "command", command }] }] } }, null, 2);
+}
+/** Locate `<configDir>/projects/<any-slug>/<sessionId>.jsonl`. */
+function findTranscript(configDir, sessionId) {
+    const projectsDir = join(configDir, "projects");
+    if (!existsSync(projectsDir))
+        return undefined;
+    const target = `${sessionId}.jsonl`;
+    let slugs;
+    try {
+        slugs = readdirSync(projectsDir);
+    }
+    catch {
+        return undefined;
+    }
+    for (const slug of slugs) {
+        const candidate = join(projectsDir, slug, target);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/** Read bytes appended to `path` since `offset`. Returns text + new offset. */
+function readAppended(path, offset) {
+    let fd;
+    try {
+        fd = openSync(path, "r");
+        const size = fstatSync(fd).size;
+        if (size <= offset)
+            return { text: "", offset };
+        const length = size - offset;
+        const buf = Buffer.allocUnsafe(length);
+        const read = readSync(fd, buf, 0, length, offset);
+        return { text: buf.subarray(0, read).toString("utf8"), offset: offset + read };
+    }
+    catch {
+        return { text: "", offset };
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+export class ClaudeInteractiveDriver {
+    name = "claude-interactive";
+    executable;
+    injectedPtySpawn;
+    configDirOverride;
+    opts;
+    sessions = new Map();
+    constructor(options = {}) {
+        this.injectedPtySpawn = options.ptySpawn;
+        this.executable = options.executable ?? process.env.CLAUDE_CLI_EXECUTABLE ?? "claude";
+        this.configDirOverride = options.configDir;
+        this.opts = {
+            readyQuietMs: options.readyQuietMs ?? DEFAULTS.readyQuietMs,
+            readyTimeoutMs: options.readyTimeoutMs ?? DEFAULTS.readyTimeoutMs,
+            submitDelayMs: options.submitDelayMs ?? DEFAULTS.submitDelayMs,
+            pollIntervalMs: options.pollIntervalMs ?? DEFAULTS.pollIntervalMs,
+            turnTimeoutMs: options.turnTimeoutMs ?? DEFAULTS.turnTimeoutMs,
+        };
+    }
+    run(input, onEventRaw) {
+        const effort = input.thinkingLevel ? foldThinkingLevelForClaude(input.thinkingLevel) : undefined;
+        const onEvent = enrichInitWithCapabilities(onEventRaw, {
+            thinkingLevelSupported: true,
+            requestedThinkingLevel: input.thinkingLevel,
+            effectiveThinkingLevel: effort,
+        });
+        let turnAborted = false;
+        const done = (async () => {
+            // Refuse safe mode loudly rather than silently dropping the sandbox.
+            if (input.securityMode === "safe") {
+                await onEvent({
+                    type: "error",
+                    payload: {
+                        message: "claude-interactive supports only securityMode 'yolo' for now " +
+                            "(interactive permission prompts are not yet automated). " +
+                            "Pass securityMode: 'yolo' to use this driver.",
+                        code: "CLAUDE_INTERACTIVE_SAFE_UNSUPPORTED",
+                    },
+                });
+                return { code: 1, signal: null };
+            }
+            let session;
+            try {
+                session = await this.ensureSession(input, effort);
+            }
+            catch (error) {
+                await onEvent({
+                    type: "error",
+                    payload: {
+                        message: enrichSpawnError(error instanceof Error ? error.message : String(error)),
+                        code: "CLAUDE_INTERACTIVE_SPAWN_ERROR",
+                    },
+                });
+                return { code: 1, signal: null };
+            }
+            await session.ready;
+            if (session.exited) {
+                await onEvent({
+                    type: "error",
+                    payload: {
+                        message: `claude interactive process exited before the turn (code=${session.exitCode ?? "null"})`,
+                        code: "CLAUDE_INTERACTIVE_EXITED",
+                    },
+                });
+                return { code: session.exitCode ?? 1, signal: null };
+            }
+            // Drain any transcript lines already written by prior turns / init so a
+            // turn only emits its own messages. (On the first turn this drains the
+            // system/init line, which we DO want to emit — so we emit during drain.)
+            await this.pumpTranscript(session, onEvent);
+            // Type the prompt via bracketed paste so embedded newlines in a
+            // multi-line prompt don't submit early; Enter submits the whole thing.
+            session.proc.write(`\x1b[200~${input.prompt}\x1b[201~`);
+            await sleep(this.opts.submitDelayMs);
+            session.proc.write("\r");
+            // Wait for the turn to end: a new Stop-hook signal line. Stream
+            // transcript messages as they're written in the meantime.
+            const deadline = Date.now() + this.opts.turnTimeoutMs;
+            while (true) {
+                if (turnAborted) {
+                    await this.pumpTranscript(session, onEvent);
+                    return { code: 130, signal: "SIGINT" };
+                }
+                if (session.exited) {
+                    await this.pumpTranscript(session, onEvent);
+                    // /quit (graceful dispose) exits 0; any other exit mid-turn is an error.
+                    if (session.disposed)
+                        return { code: session.exitCode ?? 0, signal: null };
+                    await onEvent({
+                        type: "error",
+                        payload: {
+                            message: `claude interactive process exited mid-turn (code=${session.exitCode ?? "null"})`,
+                            code: "CLAUDE_INTERACTIVE_EXITED",
+                        },
+                    });
+                    return { code: session.exitCode ?? 1, signal: null };
+                }
+                await this.pumpTranscript(session, onEvent);
+                if (this.consumeTurnEnd(session)) {
+                    // Final flush — Stop fires after the last assistant message is
+                    // written, but give one more read to catch a trailing line.
+                    await this.pumpTranscript(session, onEvent);
+                    return { code: 0, signal: null };
+                }
+                if (Date.now() > deadline) {
+                    await onEvent({
+                        type: "error",
+                        payload: {
+                            message: `claude-interactive turn timed out after ${this.opts.turnTimeoutMs}ms with no Stop hook`,
+                            code: "CLAUDE_INTERACTIVE_TURN_TIMEOUT",
+                        },
+                    });
+                    return { code: 1, signal: null };
+                }
+                await sleep(this.opts.pollIntervalMs);
+            }
+        })();
+        return {
+            kill: (_signal = "SIGINT") => {
+                // Interrupt = cancel the CURRENT turn, keep the session hot. ESC tells
+                // the TUI to abort the in-flight response. The process is NOT killed
+                // here — teardown happens via dispose() (`/quit`). The pump loop sees
+                // `turnAborted` and resolves the active turn.
+                turnAborted = true;
+                const session = this.sessions.get(input.sessionId);
+                session?.proc.write("\x1b");
+            },
+            done,
+        };
+    }
+    /**
+     * Graceful teardown of a session's interactive process. The runtime's
+     * `stop()` calls this. We type `/quit` (a real interactive command) so the
+     * TUI shuts down cleanly, flushing its transcript, then drop the session.
+     */
+    async dispose(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        this.sessions.delete(sessionId);
+        session.disposed = true;
+        if (session.exited)
+            return;
+        try {
+            session.proc.write("/quit\r");
+        }
+        catch {
+            // fall through to force-kill
+        }
+        // Wait briefly for a clean exit, then force-kill.
+        const deadline = Date.now() + 3_000;
+        while (!session.exited && Date.now() < deadline) {
+            await sleep(50);
+        }
+        if (!session.exited) {
+            try {
+                session.proc.kill();
+            }
+            catch {
+                // already gone
+            }
+        }
+    }
+    async ensureSession(input, effort) {
+        const existing = this.sessions.get(input.sessionId);
+        if (existing && !existing.exited && !existing.disposed)
+            return existing;
+        const claudeSessionId = coerceClaudeCliSessionId(input.sessionId);
+        const configDir = this.configDirOverride ??
+            input.env?.CLAUDE_CONFIG_DIR ??
+            process.env.CLAUDE_CONFIG_DIR ??
+            join(homedir(), ".claude");
+        const workDir = input.sessionStorageDir ?? join(tmpdir(), "pi-ca-leash-interactive", input.sessionId);
+        mkdirSync(workDir, { recursive: true });
+        const signalPath = join(workDir, "interactive-turn-end.signal");
+        writeFileSync(signalPath, ""); // create so offset tracking starts at 0
+        const settingsPath = join(workDir, "interactive-settings.json");
+        writeFileSync(settingsPath, stopHookSettings(signalPath));
+        const args = buildInteractiveArgs({
+            claudeSessionId,
+            settingsPath,
+            model: input.model,
+            appendSystemPrompt: input.appendSystemPrompt,
+            additionalDirectories: input.additionalDirectories,
+            effort,
+        });
+        const env = {};
+        for (const [k, v] of Object.entries(process.env))
+            if (v !== undefined)
+                env[k] = v;
+        for (const [k, v] of Object.entries(input.env ?? {}))
+            env[k] = v;
+        if (!env.TERM)
+            env.TERM = "xterm-256color";
+        const spawnPty = this.injectedPtySpawn ?? (await this.loadNodePty());
+        const proc = spawnPty(this.executable, args, {
+            cwd: input.cwd,
+            env,
+            cols: 120,
+            rows: 40,
+            name: env.TERM,
+        });
+        const session = {
+            proc,
+            claudeSessionId,
+            configDir,
+            signalPath,
+            signalOffset: 0,
+            transcriptOffset: 0,
+            jsonlRemainder: "",
+            ready: Promise.resolve(),
+            exited: false,
+            exitCode: null,
+            disposed: false,
+        };
+        // Readiness: resolve once PTY output has been quiet for `readyQuietMs`
+        // (the banner finished rendering) or `readyTimeoutMs` elapses.
+        let resolveReady;
+        session.ready = new Promise((resolve) => {
+            resolveReady = resolve;
+        });
+        let quietTimer;
+        let settled = false;
+        const settle = () => {
+            if (settled)
+                return;
+            settled = true;
+            if (quietTimer)
+                clearTimeout(quietTimer);
+            resolveReady();
+        };
+        const armQuiet = () => {
+            if (quietTimer)
+                clearTimeout(quietTimer);
+            quietTimer = setTimeout(settle, this.opts.readyQuietMs);
+            if (typeof quietTimer.unref === "function")
+                quietTimer.unref();
+        };
+        armQuiet();
+        const hardTimer = setTimeout(settle, this.opts.readyTimeoutMs);
+        if (typeof hardTimer.unref === "function")
+            hardTimer.unref();
+        proc.onData(() => {
+            if (!settled)
+                armQuiet();
+        });
+        proc.onExit(({ exitCode }) => {
+            session.exited = true;
+            session.exitCode = exitCode;
+            settle();
+        });
+        this.sessions.set(input.sessionId, session);
+        return session;
+    }
+    /** Read newly written transcript lines, parse, and emit them as messages. */
+    async pumpTranscript(session, onEvent) {
+        if (!session.transcriptPath) {
+            session.transcriptPath = findTranscript(session.configDir, session.claudeSessionId);
+            if (!session.transcriptPath)
+                return;
+        }
+        const { text, offset } = readAppended(session.transcriptPath, session.transcriptOffset);
+        session.transcriptOffset = offset;
+        if (!text)
+            return;
+        const buffer = session.jsonlRemainder + text;
+        const lines = buffer.split("\n");
+        session.jsonlRemainder = lines.pop() ?? "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(trimmed);
+            }
+            catch {
+                continue; // transcript may contain non-message bookkeeping lines
+            }
+            for (const message of parseClaudeSdkMessage(parsed)) {
+                await onEvent({ type: "message", payload: message });
+            }
+        }
+    }
+    /** True if the Stop hook appended at least one new line since last checked. */
+    consumeTurnEnd(session) {
+        const { text, offset } = readAppended(session.signalPath, session.signalOffset);
+        session.signalOffset = offset;
+        return text.includes("stop");
+    }
+    async loadNodePty() {
+        let mod;
+        try {
+            // Non-literal specifier so TS does not statically resolve the optional
+            // native dependency at build time (it may be absent). Runtime import is
+            // identical to `import("node-pty")`.
+            const spec = "node-pty";
+            mod = (await import(spec));
+        }
+        catch (error) {
+            throw new Error("claude-interactive driver requires the optional dependency 'node-pty'. " +
+                "Install it with `npm install node-pty`. " +
+                (error instanceof Error ? error.message : String(error)));
+        }
+        return mod.spawn;
+    }
+}
+function enrichSpawnError(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("enoent") || lower.includes("not found")) {
+        return `${message}\nHint: claude executable could not be spawned. Check PATH or set CLAUDE_CLI_EXECUTABLE.`;
+    }
+    return message;
+}
+//# sourceMappingURL=claude-interactive.js.map

package/node_modules/@pi-claude-code-agent/runtime/dist/drivers/claude-interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-interactive.js","sourceRoot":"","sources":["../../src/drivers/claude-interactive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAgGvF,MAAM,QAAQ,GAAG;IACf,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,MAAM;IACtB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,GAAG;IACnB,aAAa,EAAE,EAAE,GAAG,MAAM;CAC3B,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAE1E,yEAAyE;AACzE,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,oBAAoB,CAAC,KAO7B;IACC,yEAAyE;IACzE,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,IAAI,GAAG;QACX,cAAc;QACd,KAAK,CAAC,eAAe;QACrB,YAAY;QACZ,KAAK,CAAC,YAAY;QAClB,yEAAyE;QACzE,yEAAyE;QACzE,mEAAmE;QACnE,gCAAgC;KACjC,CAAC;IACF,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,kBAAkB;QAAE,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5F,IAAI,KAAK,CAAC,qBAAqB,EAAE,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAChG,IAAI,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,6EAA6E;IAC7E,mEAAmE;IACnE,MAAM,OAAO,GAAG,uBAAuB,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACnE,OAAO,IAAI,CAAC,SAAS,CACnB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAChE,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,SAAS,cAAc,CAAC,SAAiB,EAAE,SAAiB;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,SAAS,QAAQ,CAAC;IACpC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,SAAS,YAAY,CAAC,IAAY,EAAE,MAAc;IAChD,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;QAChC,IAAI,IAAI,IAAI,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,oBAA6B,CAAC;IAE7B,UAAU,CAAS;IACnB,gBAAgB,CAAc;IAC9B,iBAAiB,CAAU;IAC3B,IAAI,CAAkB;IACtB,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE1D,YAAY,UAA0C,EAAE;QACtD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,CAAC;QACtF,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG;YACV,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY;YAC3D,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;YACjE,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa;YAC9D,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;YACjE,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa;SAC/D,CAAC;IACJ,CAAC;IAED,GAAG,CACD,KAA4B,EAC5B,UAAgE;QAEhE,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjG,MAAM,OAAO,GAAG,0BAA0B,CAAC,UAAU,EAAE;YACrD,sBAAsB,EAAE,IAAI;YAC5B,sBAAsB,EAAE,KAAK,CAAC,aAAa;YAC3C,sBAAsB,EAAE,MAAM;SAC/B,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,MAAM,IAAI,GAAG,CAAC,KAAK,IAAqE,EAAE;YACxF,qEAAqE;YACrE,IAAI,KAAK,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;gBAClC,MAAM,OAAO,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE;wBACP,OAAO,EACL,+DAA+D;4BAC/D,0DAA0D;4BAC1D,+CAA+C;wBACjD,IAAI,EAAE,qCAAqC;qBAC5C;iBACF,CAAC,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACnC,CAAC;YAED,IAAI,OAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE;wBACP,OAAO,EAAE,gBAAgB,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBACjF,IAAI,EAAE,gCAAgC;qBACvC;iBACF,CAAC,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACnC,CAAC;YAED,MAAM,OAAO,CAAC,KAAK,CAAC;YACpB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,OAAO,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE;wBACP,OAAO,EAAE,2DAA2D,OAAO,CAAC,QAAQ,IAAI,MAAM,GAAG;wBACjG,IAAI,EAAE,2BAA2B;qBAClC;iBACF,CAAC,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACvD,CAAC;YAED,wEAAwE;YACxE,uEAAuE;YACvE,yEAAyE;YACzE,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE5C,gEAAgE;YAChE,uEAAuE;YACvE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;YACxD,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEzB,gEAAgE;YAChE,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;YACtD,OAAO,IAAI,EAAE,CAAC;gBACZ,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC5C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACzC,CAAC;gBACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC5C,yEAAyE;oBACzE,IAAI,OAAO,CAAC,QAAQ;wBAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;oBAC3E,MAAM,OAAO,CAAC;wBACZ,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE;4BACP,OAAO,EAAE,oDAAoD,OAAO,CAAC,QAAQ,IAAI,MAAM,GAAG;4BAC1F,IAAI,EAAE,2BAA2B;yBAClC;qBACF,CAAC,CAAC;oBACH,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACvD,CAAC;gBACD,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5C,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,+DAA+D;oBAC/D,4DAA4D;oBAC5D,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC5C,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACnC,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;oBAC1B,MAAM,OAAO,CAAC;wBACZ,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE;4BACP,OAAO,EAAE,2CAA2C,IAAI,CAAC,IAAI,CAAC,aAAa,sBAAsB;4BACjG,IAAI,EAAE,iCAAiC;yBACxC;qBACF,CAAC,CAAC;oBACH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACnC,CAAC;gBACD,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO;YACL,IAAI,EAAE,CAAC,UAA0B,QAAQ,EAAE,EAAE;gBAC3C,uEAAuE;gBACvE,qEAAqE;gBACrE,sEAAsE;gBACtE,8CAA8C;gBAC9C,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACnD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YACD,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO;QAC3B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,kDAAkD;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACpC,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAChD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,KAA4B,EAC5B,MAA+D;QAE/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAExE,MAAM,eAAe,GAAG,wBAAwB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,SAAS,GACb,IAAI,CAAC,iBAAiB;YACtB,KAAK,CAAC,GAAG,EAAE,iBAAiB;YAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB;YAC7B,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QAE7B,MAAM,OAAO,GACX,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,yBAAyB,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxF,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;QAChE,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,wCAAwC;QACvE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;QAChE,aAAa,CAAC,YAAY,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QAE1D,MAAM,IAAI,GAAG,oBAAoB,CAAC;YAChC,eAAe;YACf,YAAY;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;YAC5C,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;YAClD,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,KAAK,SAAS;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE;YAC3C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG;YACH,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC;QAEH,MAAM,OAAO,GAAe;YAC1B,IAAI;YACJ,eAAe;YACf,SAAS;YACT,UAAU;YACV,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,EAAE;YAClB,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;YACxB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;SAChB,CAAC;QAEF,uEAAuE;QACvE,+DAA+D;QAC/D,IAAI,YAAwB,CAAC;QAC7B,OAAO,CAAC,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,IAAI,UAAsC,CAAC;QAC3C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,UAAU;gBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACzC,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,UAAU;gBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACzC,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxD,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU;gBAAE,UAAU,CAAC,KAAK,EAAE,CAAC;QACjE,CAAC,CAAC;QACF,QAAQ,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU;YAAE,SAAS,CAAC,KAAK,EAAE,CAAC;QAE7D,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACf,IAAI,CAAC,OAAO;gBAAE,QAAQ,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YACtB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC5B,MAAM,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6EAA6E;IACrE,KAAK,CAAC,cAAc,CAC1B,OAAmB,EACnB,OAA6D;QAE7D,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC5B,OAAO,CAAC,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;YACpF,IAAI,CAAC,OAAO,CAAC,cAAc;gBAAE,OAAO;QACtC,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxF,OAAO,CAAC,gBAAgB,GAAG,MAAM,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,uDAAuD;YACnE,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,+EAA+E;IACvE,cAAc,CAAC,OAAmB;QACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAChF,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,GAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,uEAAuE;YACvE,wEAAwE;YACxE,qCAAqC;YACrC,MAAM,IAAI,GAAG,UAAU,CAAC;YACxB,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAqC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,yEAAyE;gBACvE,0CAA0C;gBAC1C,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,OAAO,GAAG,OAAO,0FAA0F,CAAC;IAC9G,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/node_modules/@pi-claude-code-agent/runtime/dist/drivers/claude-pty.d.ts

@@ -0,0 +1,146 @@
+import type { DriverEventEnvelope, RuntimeDriver, RuntimeDriverRunHandle, RuntimeDriverRunInput } from "../types.js";
+/**
+ * `claude-pty` driver — drives the REAL Claude Code interactive TUI.
+ *
+ * Unlike `claude-cli` / `claude-sdk` (which spawn a fresh one-shot process per
+ * turn and fake continuity via `--resume`), this driver keeps ONE long-lived
+ * interactive `claude` process alive per session, inside a PTY, and types each
+ * turn's prompt into it. Context stays hot in the live process — no per-turn
+ * cold start, no transcript reload.
+ *
+ * The hard problems of driving a TUI (no structured stdout, fragile
+ * turn-completion detection) are NOT solved by scraping the rendered screen.
+ * They are also NOT solved by the session transcript JSONL: the interactive
+ * TUI keeps its transcript in memory and never flushes the file the way the
+ * headless `-p` path does (verified against claude 2.1.x — the path the Stop
+ * hook reports never materialises, even after `/quit`).
+ *
+ * Instead we observe the session entirely through Claude Code HOOKS. We inject
+ * a per-invocation `--settings` file (so the user's `~/.claude/settings.json`
+ * and other running sessions are untouched) registering command hooks that
+ * append their JSON payload — one line each — to a per-session `hooks.jsonl`:
+ *
+ *  - `PostToolUse` payloads carry `tool_name` / `tool_input` / `tool_response`
+ *    → emitted as normalized tool_use + tool_result messages.
+ *  - `Stop` payloads carry `last_assistant_message` AND mark the deterministic
+ *    end of a turn → emitted as an assistant message, then the turn resolves.
+ *
+ * The PTY's only jobs: keep the TUI alive, type input (bracketed paste),
+ * answer the first-run trust dialog, send ESC to cancel a turn, and send
+ * `/quit` to tear the session down.
+ */
+export interface PtyProcessLike {
+    readonly pid: number;
+    write(data: string): void;
+    onData(listener: (data: string) => void): void;
+    onExit(listener: (event: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    kill(signal?: string): void;
+}
+export type PtySpawnFn = (file: string, args: string[], options: {
+    cwd: string;
+    env: Record<string, string>;
+    cols: number;
+    rows: number;
+    name: string;
+}) => PtyProcessLike;
+export interface ClaudePtyDriverOptions {
+    /** Inject a PTY spawner (tests). Defaults to the Python pty allocator. */
+    ptySpawn?: PtySpawnFn;
+    executable?: string;
+    /** Python 3 interpreter used by the default PTY allocator. */
+    pythonExecutable?: string;
+    /** Override where Claude writes transcripts/config. Defaults to env / ~/.claude. */
+    configDir?: string;
+    /** Quiet window after spawn before the TUI is considered ready for input. */
+    readyQuietMs?: number;
+    /** Hard cap waiting for the TUI to settle after spawn. */
+    readyTimeoutMs?: number;
+    /**
+     * Minimum time to keep watching for the first-run trust dialog before
+     * concluding it won't appear (an early quiet gap during terminal setup can
+     * precede the dialog by hundreds of ms — concluding "ready" then would type
+     * the prompt into a not-yet-rendered TUI). Trusted dirs pay this once.
+     */
+    startupMinMs?: number;
+    /** Delay between bracketed-paste of the prompt and the submitting Enter. */
+    submitDelayMs?: number;
+    /** Poll cadence for the hook-payload file. */
+    pollIntervalMs?: number;
+    /** Hard cap for a single turn before giving up. */
+    turnTimeoutMs?: number;
+}
+export declare function buildPtyArgs(input: {
+    claudeSessionId: string;
+    settingsPath: string;
+    /**
+     * When true, launch with `--resume <id>` instead of `--session-id <id>` so
+     * the TUI reloads the existing transcript. Used only when respawning a
+     * session whose persistent process died mid-conversation — a fresh
+     * `--session-id` launch would otherwise start with no prior context.
+     */
+    resume?: boolean;
+    model?: string;
+    appendSystemPrompt?: string;
+    additionalDirectories?: string[];
+    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+}): string[];
+export declare class ClaudePtyDriver implements RuntimeDriver {
+    readonly name: "claude-pty";
+    private readonly executable;
+    private readonly pythonExecutable;
+    private readonly injectedPtySpawn?;
+    private readonly configDirOverride?;
+    private readonly opts;
+    private readonly sessions;
+    constructor(options?: ClaudePtyDriverOptions);
+    run(input: RuntimeDriverRunInput, onEventRaw: (event: DriverEventEnvelope) => Promise<void> | void): RuntimeDriverRunHandle;
+    /**
+     * Graceful teardown of a session's interactive process. The runtime's
+     * `stop()` calls this. We type `/quit` (a real interactive command) so the
+     * TUI shuts down cleanly, flushing its transcript, then drop the session.
+     */
+    dispose(sessionId: string): Promise<void>;
+    private ensureSession;
+    /**
+     * Drive the one-time startup to a ready-for-input state.
+     *
+     * The naive "first quiet window = ready" heuristic is wrong: terminal-setup
+     * escapes are emitted, then there's a lull of a few hundred ms BEFORE the
+     * first-run trust dialog renders. Concluding "ready" in that lull types the
+     * prompt into a not-yet-rendered TUI and the dialog later swallows it.
+     *
+     * So we keep watching: if the trust dialog appears (it isn't suppressed by
+     * `--dangerously-skip-permissions` in interactive mode), accept it with Enter
+     * (preselected "Yes, I trust this folder"); otherwise only conclude "no
+     * dialog, ready" once output is quiet AND we've watched at least
+     * `startupMinMs` (so an early lull can't short-circuit). Either way we then
+     * wait for the post-dialog render to settle before returning.
+     */
+    private awaitStartup;
+    /**
+     * Read newly appended hook payload lines, emit their normalized messages,
+     * and report whether a Stop hook (turn end) was among them.
+     */
+    private pumpHooks;
+    /** Advance past hook lines already written (without emitting them). */
+    private drainHooks;
+    /** Pull complete newly-appended lines from the hooks file, advancing offset. */
+    private readHookLines;
+    /**
+     * Default PTY allocator — spawns Python 3 running {@link PTY_ALLOCATOR},
+     * which `pty.fork()`s a real pseudo-terminal, sets its window size, execs the
+     * target, and relays bytes between our stdio pipes and the pty master.
+     *
+     * Why Python instead of a native pty addon (node-pty): a real pty needs
+     * `openpty`/`forkpty` syscalls, so every JS pty library is either a native
+     * addon (needs a matching prebuild or a from-source compile — brittle on new
+     * Node ABIs) or a wrapper around a system binary. `python3` is present by
+     * default on macOS and most Linux, needs no compile step, and works headless
+     * (unlike the `script` binary, which requires its own controlling terminal).
+     * Tests inject their own `ptySpawn`, so this is only the production default.
+     */
+    private readonly pythonPtySpawn;
+}