codedeck 0.1.1 → 0.1.3

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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"}

package/dist/drivers/terminal.js

@@ -0,0 +1,53 @@
+import { classifyFailure } from "../core/errors.js";
+// Pure so the exit-handler decision is testable without spawning a harness.
+// When a harness dies it often does so WITHOUT emitting a terminal frame —
+// the EPIPE/signal class of crash. This decides what the driver reports
+// instead. A ghost "completed" is the one outcome it refuses to produce: an
+// agent that sees completed proceeds on missing work, while a false "failed"
+// only costs one retry of a retryable session.
+export function synthesizeTerminalEvent(input) {
+    if (input.hasTerminal)
+        return null;
+    const ts = new Date().toISOString();
+    if (input.exitCode === 0) {
+        // Exit 0 with produced output is completion. Exit 0 with NO output but
+        // stderr content is how "exit 0 anyway" crashes look — treat as failure.
+        if (!input.hasMessage && input.stderr.trim()) {
+            return {
+                type: "session.failed",
+                sessionId: input.sessionId,
+                timestamp: ts,
+                error: input.stderr.slice(0, 2000),
+                exitCode: 0,
+                failure: classifyFailure(input.stderr, 0, input.signal ?? null),
+                raw: { stderr: input.stderr.slice(0, 2000) },
+            };
+        }
+        return {
+            type: "session.completed",
+            sessionId: input.sessionId,
+            timestamp: ts,
+            reason: "exit 0",
+            exitCode: 0,
+            raw: { stderr: input.stderr.slice(0, 2000) },
+        };
+    }
+    // exitCode null (signal death, or daemon was restarted and only learned of
+    // the death by polling the pid): there is no exit code to report — say so
+    // instead of inventing one.
+    const errorText = input.stderr.trim()
+        ? input.stderr.slice(0, 2000)
+        : input.exitCode != null
+            ? `${input.harness} exited with code ${input.exitCode}`
+            : `${input.harness} exited without reporting a terminal event`;
+    return {
+        type: "session.failed",
+        sessionId: input.sessionId,
+        timestamp: ts,
+        error: errorText,
+        exitCode: input.exitCode ?? 1,
+        failure: classifyFailure(input.stderr, input.exitCode, input.signal ?? null),
+        raw: { stderr: input.stderr.slice(0, 2000) },
+    };
+}
+//# sourceMappingURL=terminal.js.map

package/dist/drivers/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/drivers/terminal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,+CAA+C;AAC/C,MAAM,UAAU,uBAAuB,CAAC,KAQvC;IACC,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACzB,uEAAuE;QACvE,yEAAyE;QACzE,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,EAAE;gBACb,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;gBAClC,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;gBAC/D,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;aAC/B,CAAC;QAClB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,CAAC;YACX,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;SAC/B,CAAC;IAClB,CAAC;IACD,2EAA2E;IAC3E,0EAA0E;IAC1E,4BAA4B;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;QACnC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QAC7B,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI;YACtB,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,qBAAqB,KAAK,CAAC,QAAQ,EAAE;YACvD,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,4CAA4C,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC7B,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;QAC5E,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;KAC/B,CAAC;AAClB,CAAC"}

package/dist/store/database.js

@@ -32,6 +32,7 @@ export class Database {
         branch TEXT,
         base_commit TEXT,
         pid INTEGER,
+        pid_start_time TEXT,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL,
         completed_at TEXT,
@@ -39,7 +40,9 @@ export class Database {
         usage_output_tokens INTEGER,
         usage_cached_tokens INTEGER,
         usage_cost REAL,
-        last_event TEXT
+        last_event TEXT,
+        effort TEXT,
+        fast INTEGER NOT NULL DEFAULT 0
       );
 
       CREATE TABLE IF NOT EXISTS events (
@@ -50,6 +53,7 @@ export class Database {
         timestamp TEXT NOT NULL,
         normalized_payload TEXT NOT NULL,
         raw_payload TEXT,
+        source_key TEXT,
         FOREIGN KEY(session_id) REFERENCES sessions(id) ON DELETE CASCADE
       );
 
@@ -57,6 +61,29 @@ export class Database {
       CREATE INDEX IF NOT EXISTS idx_sessions_status ON sessions(status);
       CREATE INDEX IF NOT EXISTS idx_sessions_created ON sessions(created_at DESC);
     `);
+        this.addMissingColumns();
+    }
+    // CREATE TABLE IF NOT EXISTS is a no-op on databases that already exist, so
+    // columns added after the first release have to be applied explicitly or
+    // every existing ~/.run-agent/run-agent.db throws "no such column".
+    addMissingColumns() {
+        const existing = new Set(this.db.prepare(`PRAGMA table_info(sessions)`).all().map((c) => c.name));
+        const additions = [
+            ["effort", "TEXT"],
+            ["fast", "INTEGER NOT NULL DEFAULT 0"],
+            ["failure", "TEXT"],
+            ["log_offset", "INTEGER"],
+            ["stderr_offset", "INTEGER"],
+            ["pid_start_time", "TEXT"],
+        ];
+        for (const [name, type] of additions) {
+            if (!existing.has(name))
+                this.db.exec(`ALTER TABLE sessions ADD COLUMN ${name} ${type}`);
+        }
+        const eventColumns = new Set(this.db.prepare(`PRAGMA table_info(events)`).all().map((c) => c.name));
+        if (!eventColumns.has("source_key"))
+            this.db.exec(`ALTER TABLE events ADD COLUMN source_key TEXT`);
+        this.db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS idx_events_source_key ON events(session_id, source_key) WHERE source_key IS NOT NULL`);
     }
     getHandle() {
         return this.db;

package/dist/store/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/store/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,OAAO,QAAQ;IACX,EAAE,CAAe;IACjB,MAAM,CAAS;IAEvB,YAAY,MAAe;QACzB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;QAC7B,UAAU,EAAE,CAAC;QACb,2BAA2B;QAC3B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyCZ,CAAC,CAAC;IACL,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,IAAI,SAAS,GAAoB,IAAI,CAAC;AAEtC,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,IAAI,MAAM;QAAE,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC3C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/store/database.ts"],"names":[],"mappings":"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"}

package/dist/store/events.js

@@ -4,16 +4,21 @@ export class EventStore {
         this.db = db;
     }
     append(sessionId, event, raw) {
+        if (event.sourceKey) {
+            const existing = this.db.prepare(`SELECT sequence FROM events WHERE session_id = ? AND source_key = ? LIMIT 1`).get(sessionId, event.sourceKey);
+            if (existing)
+                return 0;
+        }
         // Get next sequence
         const row = this.db.prepare(`SELECT COALESCE(MAX(sequence), 0) as maxSeq FROM events WHERE session_id = ?`).get(sessionId);
         const nextSeq = (row?.maxSeq ?? 0) + 1;
         const normalized = JSON.stringify(event);
         const rawStr = raw !== undefined ? JSON.stringify(raw) : event.raw !== undefined ? JSON.stringify(event.raw) : null;
         const stmt = this.db.prepare(`
-      INSERT INTO events (session_id, sequence, type, timestamp, normalized_payload, raw_payload)
-      VALUES (?, ?, ?, ?, ?, ?)
+      INSERT INTO events (session_id, sequence, type, timestamp, normalized_payload, raw_payload, source_key)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
     `);
-        const info = stmt.run(sessionId, nextSeq, event.type, event.timestamp, normalized, rawStr);
+        stmt.run(sessionId, nextSeq, event.type, event.timestamp, normalized, rawStr, event.sourceKey ?? null);
         // Update session last_event and updatedAt?
         // Let daemon do it
         return nextSeq;