codedeck 0.1.2 → 0.1.4

package/dist/drivers/session-driver.js

@@ -0,0 +1,122 @@
+import { killTree } from "../utils/process.js";
+import { safeJsonParse } from "./helpers.js";
+import { SessionRuntime, nativeIdFrom } from "./session-runtime.js";
+import { synthesizeTerminalEvent } from "./terminal.js";
+export function createRuntimeHooks(options) {
+    return {
+        onLine: (line, { sessionId, push, setNativeId, isStderr }) => {
+            if (isStderr) {
+                const event = options.parseStderr?.(line, sessionId);
+                if (event)
+                    push(event);
+                return;
+            }
+            const parsedEvents = options.parse(line, sessionId);
+            for (const event of parsedEvents) {
+                const native = event.type === "session.started" && event.nativeSessionId
+                    ? event.nativeSessionId
+                    : nativeIdFrom(event.raw, options.nativeKeys);
+                if (native)
+                    setNativeId(native);
+                push(event);
+            }
+            if (options.plainTextFallback &&
+                parsedEvents.length === 0 &&
+                line.trim() &&
+                line.trim() !== "null" &&
+                safeJsonParse(line) === null) {
+                push({
+                    type: "text.delta",
+                    sessionId,
+                    timestamp: new Date().toISOString(),
+                    delta: `${line}\n`,
+                    raw: line,
+                });
+            }
+            const native = nativeIdFrom(safeJsonParse(line), options.nativeKeys);
+            if (native)
+                setNativeId(native);
+        },
+        synthesizeTerminal: (ctx) => {
+            const event = synthesizeTerminalEvent({ ...ctx, harness: options.harness });
+            return event ? [event] : [];
+        },
+    };
+}
+export class SessionDriver {
+    handles = new Map();
+    async start(options) {
+        const runtime = SessionRuntime.spawn({
+            sessionId: options.sessionId,
+            cmd: this.id,
+            args: this.buildArgs(options),
+            cwd: options.cwd,
+            nativeSessionId: options.resumeSessionId,
+            hooks: this.hooks,
+        });
+        this.handles.set(options.sessionId, runtime);
+        return {
+            id: options.sessionId,
+            nativeSessionId: runtime.nativeSessionId,
+            pid: runtime.pid,
+            cwd: options.cwd,
+            model: options.model,
+            handle: runtime,
+        };
+    }
+    async attach(req) {
+        if (!req.pid)
+            return;
+        const runtime = SessionRuntime.reattach({
+            sessionId: req.sessionId,
+            pid: req.pid,
+            pidStartTime: req.pidStartTime,
+            nativeSessionId: req.nativeSessionId,
+            logOffset: req.logOffset,
+            stderrOffset: req.stderrOffset,
+            hooks: this.hooks,
+        });
+        this.handles.set(req.sessionId, runtime);
+    }
+    async send(session, message) {
+        const runtime = this.handles.get(session.id);
+        const nativeId = session.nativeSessionId || runtime?.nativeSessionId;
+        if (!nativeId)
+            throw new Error(this.resumeError);
+        const newSession = await this.start({
+            sessionId: session.id,
+            prompt: message,
+            cwd: session.cwd,
+            model: session.model,
+            resumeSessionId: nativeId,
+        });
+        session.pid = newSession.pid;
+        session.handle = newSession.handle;
+        session.nativeSessionId = newSession.nativeSessionId || nativeId;
+    }
+    async stop(session) {
+        const runtime = this.handles.get(session.id);
+        if (runtime) {
+            await runtime.stop();
+            return;
+        }
+        if (!session.pid)
+            return;
+        if (!session.pidStartTime)
+            throw new Error(`Cannot safely stop session ${session.id}: PID identity is unavailable`);
+        await killTree(session.pid, 3000, session.pidStartTime);
+    }
+    async *events(session) {
+        const runtime = this.handles.get(session.id);
+        if (!runtime)
+            return;
+        yield* runtime.events();
+    }
+    getHandle(sessionId) {
+        return this.handles.get(sessionId);
+    }
+    getOffsets(sessionId) {
+        return this.handles.get(sessionId)?.offsets;
+    }
+}
+//# sourceMappingURL=session-driver.js.map

package/dist/drivers/session-driver.js.map

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

package/dist/drivers/session-runtime.js

@@ -0,0 +1,333 @@
+import fs from "node:fs";
+import { EventEmitter } from "node:events";
+import { getPaths } from "../config/paths.js";
+import path from "node:path";
+import { FileTailer } from "./tailer.js";
+import { spawnDetached } from "./helpers.js";
+import { killTree, processAlive, processGroupAlive, processStartTime, sleep } from "../utils/process.js";
+export function sessionLogPaths(sessionId) {
+    const { logsDir } = getPaths();
+    return {
+        stdoutPath: path.join(logsDir, `${sessionId}.ndjson`),
+        stderrPath: path.join(logsDir, `${sessionId}.stderr.log`),
+        metadataPath: path.join(logsDir, `${sessionId}.process.json`),
+    };
+}
+export function readSessionProcessMetadata(sessionId) {
+    try {
+        const value = JSON.parse(fs.readFileSync(sessionLogPaths(sessionId).metadataPath, "utf8"));
+        if (typeof value.pid !== "number" || !Number.isInteger(value.pid) || value.pid <= 0)
+            return undefined;
+        return {
+            pid: value.pid,
+            pidStartTime: typeof value.pidStartTime === "string" ? value.pidStartTime : undefined,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+// Shared session wire-up for all drivers: detached spawn with file output
+// (or reattach to files of a process that outlived the daemon), incremental
+// parse into normalized events, terminal synthesis on silent death, and the
+// buffer+emitter event loop drivers expose through `events()`.
+export class SessionRuntime {
+    sessionId;
+    hooks;
+    pid;
+    emitter = new EventEmitter();
+    buffer = [];
+    done = false;
+    exitCode = null;
+    nativeSessionId;
+    proc;
+    tailer;
+    stderrTailer;
+    stderrBuf = "";
+    exitWatch = null;
+    expectedStartTime;
+    stopRequested = false;
+    safeLogOffset = 0;
+    safeStderrOffset = 0;
+    yieldedEvents = 0;
+    // A raw line can normalize to several events (e.g. opencode message emits
+    // message + text.delta). Keep the safe offset behind the line until the
+    // final event from that line has been yielded to the daemon. A line that
+    // normalizes to no event gets the same treatment: read-ahead must never
+    // move the cursor past an earlier buffered event.
+    eventBoundaries = new WeakMap();
+    pendingNoEvent = { log: null, stderr: null };
+    constructor(sessionId, hooks) {
+        this.sessionId = sessionId;
+        this.hooks = hooks;
+    }
+    static spawn(opts) {
+        const rt = new SessionRuntime(opts.sessionId, opts.hooks);
+        if (opts.nativeSessionId)
+            rt.nativeSessionId = opts.nativeSessionId;
+        const paths = sessionLogPaths(opts.sessionId);
+        const { proc, stdoutOffset, stderrOffset } = spawnDetached({
+            cmd: opts.cmd,
+            args: opts.args,
+            cwd: opts.cwd,
+            stdoutPath: paths.stdoutPath,
+            stderrPath: paths.stderrPath,
+        });
+        rt.proc = proc;
+        rt.pid = proc.pid;
+        rt.expectedStartTime = processStartTime(rt.pid);
+        try {
+            // Sidecar closes the tiny spawn→SQLite-update window. Rename makes the
+            // record all-or-nothing if the daemon dies during serialization.
+            const tempPath = `${paths.metadataPath}.tmp-${process.pid}`;
+            fs.writeFileSync(tempPath, JSON.stringify({ pid: rt.pid, pidStartTime: rt.expectedStartTime }) + "\n", "utf8");
+            fs.renameSync(tempPath, paths.metadataPath);
+        }
+        catch { }
+        rt.wire(paths, stdoutOffset, stderrOffset);
+        // Spawn-level failure (ENOENT = binary missing): infra, not task.
+        proc.on("error", (err) => {
+            const failure = {
+                code: "SPAWN_FAILED",
+                blame: "infra",
+                retryable: err.code !== "ENOENT",
+                detail: err.message,
+            };
+            rt.push({
+                type: "session.failed",
+                sessionId: opts.sessionId,
+                timestamp: new Date().toISOString(),
+                error: err.message,
+                failure,
+                raw: err,
+            });
+            rt.finish(null, null);
+        });
+        return rt;
+    }
+    // Rebuild the event feed for a session whose detached process outlived a
+    // daemon restart: tail the log files from the persisted offsets. Nothing
+    // is spawned; if the pid is already dead, the runtime drains the files and
+    // classifies the death like any other exit.
+    static reattach(opts) {
+        const rt = new SessionRuntime(opts.sessionId, opts.hooks);
+        rt.pid = opts.pid;
+        rt.expectedStartTime = opts.pidStartTime;
+        if (opts.nativeSessionId)
+            rt.nativeSessionId = opts.nativeSessionId;
+        const paths = sessionLogPaths(opts.sessionId);
+        rt.wire(paths, opts.logOffset ?? 0, opts.stderrOffset ?? 0);
+        return rt;
+    }
+    wire(paths, stdoutOffset, stderrOffset) {
+        this.safeLogOffset = stdoutOffset;
+        this.safeStderrOffset = stderrOffset;
+        this.stderrTailer = new FileTailer(paths.stderrPath, {
+            startOffset: stderrOffset,
+            onLine: (line, offset) => {
+                this.stderrBuf = (this.stderrBuf + line + "\n").slice(-65536);
+                this.handleLine("stderr", line, offset);
+            },
+        });
+        this.tailer = new FileTailer(paths.stdoutPath, {
+            startOffset: stdoutOffset,
+            onLine: (line, offset) => this.handleLine("log", line, offset),
+        });
+        if (this.proc) {
+            // Same-lifetime case: the ChildProcess observes the pid directly.
+            this.proc.on("exit", (code, signal) => this.finish(code, signal));
+        }
+        else {
+            // Cross-restart case: no ChildProcess — poll the pid until it is gone,
+            // or until its start identity changes (PID reuse), then drain the files.
+            this.exitWatch = setInterval(() => {
+                if (this.done) {
+                    if (this.exitWatch)
+                        clearInterval(this.exitWatch);
+                    this.exitWatch = null;
+                    return;
+                }
+                if (this.processMatches())
+                    return;
+                if (this.exitWatch)
+                    clearInterval(this.exitWatch);
+                this.exitWatch = null;
+                // Grace so the harness finishes its final write before we drain.
+                void sleep(300).then(() => this.finish(null, null));
+            }, 500);
+        }
+        this.tailer.start();
+        this.stderrTailer.start();
+    }
+    processMatches() {
+        if (!processAlive(this.pid))
+            return processGroupAlive(this.pid);
+        if (this.expectedStartTime === undefined)
+            return true;
+        const current = processStartTime(this.pid);
+        return current !== undefined && current === this.expectedStartTime;
+    }
+    handleLine(stream, line, offset) {
+        const before = this.buffer.length;
+        try {
+            this.hooks.onLine(line, this.lineCtx(stream === "stderr"));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // A malformed/unexpected frame must not crash the daemon or strand the
+            // detached harness. Surface it as a normal event and keep tailing.
+            this.push({
+                type: "error",
+                sessionId: this.sessionId,
+                timestamp: new Date().toISOString(),
+                error: `failed to parse ${stream} line: ${message}`,
+                raw: line,
+            });
+        }
+        const added = this.buffer.length - before;
+        if (added === 0) {
+            // Do not advance immediately if earlier events are still buffered: this
+            // line may have been read ahead before the daemon persisted them.
+            this.pendingNoEvent[stream] = { beforeEventCount: this.buffer.length, offset };
+            this.flushPendingOffsets();
+            return;
+        }
+        for (let index = before; index < this.buffer.length; index += 1) {
+            const event = this.buffer[index];
+            event.sourceKey = `${stream}:${offset}:${index - before}`;
+            this.eventBoundaries.set(event, { stream, offset, last: index === this.buffer.length - 1 });
+        }
+    }
+    lineCtx(isStderr) {
+        return {
+            sessionId: this.sessionId,
+            push: this.push,
+            setNativeId: this.setNativeId,
+            isStderr,
+        };
+    }
+    push = (ev) => {
+        ev.sessionId = this.sessionId;
+        this.buffer.push(ev);
+        this.emitter.emit("event", ev);
+    };
+    setNativeId = (id) => {
+        if (id && !this.nativeSessionId)
+            this.nativeSessionId = id;
+    };
+    markSafeOffset(stream, offset) {
+        if (stream === "log")
+            this.safeLogOffset = Math.max(this.safeLogOffset, offset);
+        else
+            this.safeStderrOffset = Math.max(this.safeStderrOffset, offset);
+    }
+    flushPendingOffsets() {
+        for (const stream of ["log", "stderr"]) {
+            const pending = this.pendingNoEvent[stream];
+            if (pending && pending.beforeEventCount <= this.yieldedEvents) {
+                this.markSafeOffset(stream, pending.offset);
+                this.pendingNoEvent[stream] = null;
+            }
+        }
+    }
+    markEventYielded(event) {
+        const boundary = this.eventBoundaries.get(event);
+        if (boundary?.last)
+            this.markSafeOffset(boundary.stream, boundary.offset);
+        this.flushPendingOffsets();
+    }
+    finish(exitCode, signal) {
+        if (this.done)
+            return;
+        // Final drain so lines written just before exit are parsed before any
+        // terminal synthesis looks at the buffer.
+        this.tailer.flush();
+        this.stderrTailer.flush();
+        this.exitCode = exitCode;
+        this.done = true;
+        const hasTerminal = this.buffer.some((e) => e.type === "session.completed" || e.type === "session.failed");
+        if (!hasTerminal && !this.stopRequested) {
+            const hasMessage = this.buffer.some((e) => e.type === "message" || e.type === "text.delta");
+            for (const ev of this.hooks.synthesizeTerminal({
+                sessionId: this.sessionId,
+                exitCode,
+                signal,
+                hasTerminal,
+                hasMessage,
+                stderr: this.stderrBuf,
+            })) {
+                this.push(ev);
+            }
+        }
+        this.emitter.emit("done");
+        this.tailer.stop();
+        this.stderrTailer.stop();
+    }
+    // Byte offsets of the last fully yielded line in each file — persisted by
+    // the daemon so a reattaching runtime does not replay stored events.
+    get offsets() {
+        return { log: this.safeLogOffset, stderr: this.safeStderrOffset };
+    }
+    get drained() {
+        return this.done && this.yieldedEvents >= this.buffer.length;
+    }
+    async stop(graceMs = 3000) {
+        if (!this.processMatches()) {
+            // The process raced us to exit (or changed identity). Close this runtime
+            // without synthesizing a conflicting harness failure; the daemon owns
+            // the single explicit stopped terminal event.
+            this.stopRequested = true;
+            this.finish(null, "SIGTERM");
+            return;
+        }
+        this.stopRequested = true;
+        // Deliberately does NOT cancel the pid-death watcher: killing the process
+        // is how the runtime learns it died (exit event or poll) and concludes the
+        // event stream. If polling has not fired by the time killTree returns,
+        // finish synchronously once the pid is gone.
+        await killTree(this.pid, graceMs, this.expectedStartTime);
+        if (!processAlive(this.pid) && !processGroupAlive(this.pid))
+            this.finish(null, "SIGTERM");
+    }
+    async *events() {
+        let idx = 0;
+        while (true) {
+            while (idx < this.buffer.length) {
+                const event = this.buffer[idx++];
+                this.yieldedEvents += 1;
+                this.markEventYielded(event);
+                yield event;
+            }
+            if (this.done && idx >= this.buffer.length)
+                break;
+            const { promise, resolve } = Promise.withResolvers();
+            const onEvent = () => {
+                this.emitter.off("event", onEvent);
+                this.emitter.off("done", onDone);
+                resolve();
+            };
+            const onDone = () => {
+                this.emitter.off("event", onEvent);
+                this.emitter.off("done", onDone);
+                resolve();
+            };
+            this.emitter.once("event", onEvent);
+            this.emitter.once("done", onDone);
+            await promise;
+        }
+    }
+}
+// Shared helper for driver hooks: pull a native session id out of a line's
+// parsed event or raw JSON without duplicating try/catch in every driver.
+export function nativeIdFrom(obj, keys) {
+    if (!obj || typeof obj !== "object")
+        return undefined;
+    const record = obj;
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "string" && value)
+            return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=session-runtime.js.map

package/dist/drivers/session-runtime.js.map

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

package/dist/drivers/tailer.js

@@ -0,0 +1,149 @@
+import fs from "node:fs";
+import { StringDecoder } from "node:string_decoder";
+const MAX_READ_BYTES = 64 * 1024;
+// Incremental line reader over a FILE — the replacement for stdio pipes.
+// The harness writes its output to disk, so a daemon restart never breaks
+// the stream: the new daemon reopens the file at the persisted offset and
+// keeps parsing where the old one stopped. A pipe, by contrast, dies with
+// the daemon and EPIPEs the child (the crash class this removes).
+export class FileTailer {
+    filePath;
+    opts;
+    // Bytes actually read (including a partial trailing line held back).
+    readOffset = 0;
+    // Bytes up to the end of the last COMPLETE line — the persistable cursor.
+    lineOffset = 0;
+    leftover = "";
+    decoder = new StringDecoder("utf8");
+    decoderEnded = false;
+    watcher = null;
+    pollTimer = null;
+    stopped = false;
+    constructor(filePath, opts) {
+        this.filePath = filePath;
+        this.opts = opts;
+    }
+    start() {
+        if (this.stopped)
+            return;
+        const start = this.opts.startOffset ?? 0;
+        this.readOffset = start;
+        this.lineOffset = start;
+        this.pump();
+        try {
+            this.watcher = fs.watch(this.filePath, () => this.pump());
+            // The file may not exist yet (spawn raced us) or may sit on a mount
+            // without watch support — the poll below covers both.
+            this.watcher.on("error", () => { });
+        }
+        catch { }
+        this.pollTimer = setInterval(() => this.pump(), this.opts.pollMs ?? 300);
+    }
+    stop() {
+        this.stopped = true;
+        try {
+            this.watcher?.close();
+        }
+        catch { }
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        this.watcher = null;
+        this.pollTimer = null;
+    }
+    // Byte position after the last fully consumed line. A partial trailing
+    // line is NOT counted, so a persisted offset never re-emits half a line
+    // after a restart.
+    get consumedOffset() {
+        return this.lineOffset;
+    }
+    // Drain the entire file to EOF, including a partial trailing line. The
+    // regular pump is bounded to avoid allocating the whole unread history;
+    // flush loops over bounded chunks because the process is known to be dead.
+    flush() {
+        if (this.stopped)
+            return;
+        const deadline = Date.now() + 1000;
+        while (Date.now() < deadline) {
+            const before = this.readOffset;
+            this.pump();
+            if (this.readOffset === before)
+                break;
+            let size;
+            try {
+                size = fs.statSync(this.filePath).size;
+            }
+            catch {
+                break;
+            }
+            if (size <= this.readOffset)
+                break;
+        }
+        this.finishPartial();
+    }
+    pump() {
+        if (this.stopped)
+            return;
+        let size;
+        try {
+            size = fs.statSync(this.filePath).size;
+        }
+        catch {
+            return; // not created yet
+        }
+        if (size < this.readOffset) {
+            // Truncated (log rewritten): both cursors and the UTF-8 decoder restart.
+            this.readOffset = 0;
+            this.lineOffset = 0;
+            this.leftover = "";
+            this.decoder = new StringDecoder("utf8");
+            this.decoderEnded = false;
+        }
+        if (size === this.readOffset)
+            return;
+        let chunk;
+        try {
+            const fd = fs.openSync(this.filePath, "r");
+            try {
+                const len = Math.min(size - this.readOffset, MAX_READ_BYTES);
+                const buf = Buffer.allocUnsafe(len);
+                const bytesRead = fs.readSync(fd, buf, 0, len, this.readOffset);
+                if (bytesRead === 0)
+                    return;
+                this.readOffset += bytesRead;
+                chunk = this.decoder.write(buf.subarray(0, bytesRead));
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+        }
+        catch {
+            return;
+        }
+        this.processText(chunk);
+    }
+    processText(chunk) {
+        const data = this.leftover + chunk;
+        const lines = data.split("\n");
+        this.leftover = lines.pop() ?? "";
+        for (const line of lines) {
+            this.lineOffset += Buffer.byteLength(line, "utf8") + 1;
+            // Empty lines still advance the safe cursor; parsers may ignore them.
+            this.opts.onLine(line, this.lineOffset);
+        }
+    }
+    finishPartial() {
+        if (!this.decoderEnded) {
+            const finalChunk = this.decoder.end();
+            this.decoderEnded = true;
+            if (finalChunk)
+                this.processText(finalChunk);
+        }
+        if (this.leftover) {
+            const line = this.leftover;
+            this.lineOffset += Buffer.byteLength(line, "utf8");
+            this.leftover = "";
+            this.opts.onLine(line, this.lineOffset);
+        }
+    }
+}
+//# sourceMappingURL=tailer.js.map

package/dist/drivers/tailer.js.map

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