@songsid/agend 2.2.0-beta.15 → 2.2.0-beta.17

package/dist/compact-watch.d.ts

@@ -0,0 +1,78 @@
+export declare const COMPACT_WATCH_POLL_MS = 2000;
+/** A long session's compaction can take minutes (one of 1M tokens took about two); ten is well past that. */
+export declare const COMPACT_WATCH_TIMEOUT_MS: number;
+export declare const COMPACT_WATCH_KEEP_MS: number;
+export type CompactFormat = "claude" | "codex";
+export type CompactState = "running" | "done" | "timeout" | "lost";
+export interface CompactWatchView {
+    id: string;
+    state: CompactState;
+}
+/** The transcript's end just before the command was written (the daemon's). */
+export interface CompactCheckpoint {
+    path: string;
+    ino: number;
+    size: number;
+}
+/** One launch of an instance, as a value: a respawn, pause/wake or new fence is another. */
+export declare function launchIdentity(o: {
+    bootId: unknown;
+    spawnGeneration: unknown;
+    launchAttempt: unknown;
+    launchFenceEpoch: unknown;
+}): string;
+/** Whether one whole transcript record says the conversation was compacted (its own top-level fields only). */
+export declare function isCompactionRecord(format: CompactFormat, line: string): boolean;
+export interface CompactWatchDeps {
+    /** The instance's transcript now, as the Log resolves it; format null: none AgEnD can read. */
+    source(name: string): {
+        path: string | null;
+        format: CompactFormat | null;
+    };
+    /** The launch that runs the instance now (launchIdentity); null: none. */
+    owner(name: string): string | null;
+    /** A watch ended (done, lost or timed out): the status frame should go out again. */
+    changed(name: string): void;
+    now?(): number;
+    setInterval?(fn: () => void, ms: number): unknown;
+    clearInterval?(handle: unknown): void;
+}
+export declare class CompactWatch {
+    private readonly deps;
+    private readonly watches;
+    constructor(deps: CompactWatchDeps);
+    private now;
+    private every;
+    private clear;
+    /**
+     * Before a /compact is handed to the daemon: a watch that waits for the daemon to say the command was written.
+     * Returns its id (sent along with the paste), or null when this backend's compaction cannot be seen.
+     */
+    begin(name: string): string | null;
+    /**
+     * The daemon wrote (or gave up on) the command with this id. Written: it says under which launch, and where the
+     * transcript ended just before the write. Both must be this instance's now — the launch running it and the transcript
+     * the watch reads — or the watch is lost.
+     */
+    pasted(name: string, id: string, written: boolean, report?: {
+        owner?: unknown;
+        checkpoint?: unknown;
+    }): void;
+    /** The command was not handed over after all: forget its watch (nothing was announced for it). */
+    cancel(name: string, id: string): void;
+    /** What the status frame says about the instance's last /compact — or nothing. */
+    view(name: string): CompactWatchView | null;
+    /** The instance went away, or the fleet stops. */
+    forget(name: string): void;
+    stopAll(): void;
+    private drop;
+    private finish;
+    /**
+     * Whether the watch still stands as `base` was set: the same watch and base, running, the same launch, the source
+     * still this format with a transcript (else lost, said here) — and still this transcript: one that moved meanwhile
+     * stops this look, and the next look starts at the new one's end. Checked after every await and before it ends.
+     */
+    private standing;
+    /** One look at the transcript: the watch's timer calls it (tests call it directly). */
+    poll(name: string, id: string): Promise<void>;
+}

package/dist/compact-watch.js

@@ -0,0 +1,247 @@
+/**
+ * Board 003648ac: whether a /compact sent from the web chat has finished. The chat said only "sent", forever.
+ *
+ * - **Only what the CLI writes.** Claude Code appends a `system` `compact_boundary` record to the session's JSONL and
+ *   Codex a `compacted` record to its rollout (the same records the Log tab shows as "compacted", log-steps.ts). Only
+ *   a record's own top-level fields count: a long record is read whole (≤ WHOLE_LINE_MAX_BYTES, also when it spans
+ *   several reads) and parsed, never judged by text in its head; one that can't be read whole stays unknown. Other
+ *   backends (kiro included) record nothing AgEnD can attribute to the instance, so their compaction is never called
+ *   finished: `begin` answers null.
+ * - **From just before the command's own write.** The daemon queues a paste behind its lock and a wake; just before
+ *   it writes this one, it takes the transcript's end (`checkpoint`), and once written it sends that with the launch it
+ *   wrote under (`raw_paste_written`). So neither an older boundary nor one written while the command waited counts,
+ *   and a compaction that finishes fast is not missed.
+ * - **One transcript, one launch.** The watch is bound to that launch (boot, spawn generation, attempt, fence) and to
+ *   the transcript's format and path; it is rechecked before every read and after every await, and before it ends.
+ *   Another launch, another backend or no transcript ends it as lost. Each look reads through one opened file whose
+ *   identity was checked; another file at the path, or this one cut short, starts again at its end: a boundary may then
+ *   be missed (the watch times out), never invented.
+ * - **Bounded.** One watch per instance (a new /compact replaces it), a look every COMPACT_WATCH_POLL_MS of at most
+ *   LOOKS_PER_POLL bounded reads (readNewLines), and an end: done, lost, or timed out after COMPACT_WATCH_TIMEOUT_MS
+ *   from the command. A finished watch stays in view for COMPACT_WATCH_KEEP_MS so a page that was away still learns it.
+ */
+import { randomBytes } from "node:crypto";
+import { open, stat } from "node:fs/promises";
+import { LOOKS_PER_POLL, readNewLines, readWholeLine, WHOLE_LINE_MAX_BYTES } from "./transcript-jsonl.js";
+export const COMPACT_WATCH_POLL_MS = 2_000;
+/** A long session's compaction can take minutes (one of 1M tokens took about two); ten is well past that. */
+export const COMPACT_WATCH_TIMEOUT_MS = 10 * 60_000;
+export const COMPACT_WATCH_KEEP_MS = 2 * 60_000;
+/** One launch of an instance, as a value: a respawn, pause/wake or new fence is another. */
+export function launchIdentity(o) {
+    return JSON.stringify([o.bootId, o.spawnGeneration, o.launchAttempt, o.launchFenceEpoch]);
+}
+/** Whether one whole transcript record says the conversation was compacted (its own top-level fields only). */
+export function isCompactionRecord(format, line) {
+    let e;
+    try {
+        e = JSON.parse(line);
+    }
+    catch {
+        return false;
+    }
+    if (!e || typeof e !== "object" || Array.isArray(e))
+        return false;
+    const r = e;
+    return format === "claude" ? r.type === "system" && r.subtype === "compact_boundary" && r.isSidechain !== true : r.type === "compacted";
+}
+/** A long record worth reading whole: its head mentions the record at all (anything else is skipped unread). */
+const mayBeCompaction = (format, head) => head.includes(format === "claude" ? "compact_boundary" : "compacted");
+export class CompactWatch {
+    deps;
+    watches = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() { return this.deps.now ? this.deps.now() : performance.now(); }
+    every(fn, ms) { return this.deps.setInterval ? this.deps.setInterval(fn, ms) : setInterval(fn, ms); }
+    clear(handle) {
+        if (this.deps.clearInterval)
+            this.deps.clearInterval(handle);
+        else
+            clearInterval(handle);
+    }
+    /**
+     * Before a /compact is handed to the daemon: a watch that waits for the daemon to say the command was written.
+     * Returns its id (sent along with the paste), or null when this backend's compaction cannot be seen.
+     */
+    begin(name) {
+        const src = this.deps.source(name);
+        if (!src.format || !src.path)
+            return null;
+        this.drop(name);
+        const id = randomBytes(8).toString("hex");
+        const w = { id, state: "running", deadline: this.now() + COMPACT_WATCH_TIMEOUT_MS, endedAt: null, timer: null, reading: false, base: null };
+        w.timer = this.every(() => { void this.poll(name, id); }, COMPACT_WATCH_POLL_MS);
+        this.watches.set(name, w);
+        return id;
+    }
+    /**
+     * The daemon wrote (or gave up on) the command with this id. Written: it says under which launch, and where the
+     * transcript ended just before the write. Both must be this instance's now — the launch running it and the transcript
+     * the watch reads — or the watch is lost.
+     */
+    pasted(name, id, written, report = {}) {
+        const w = this.watches.get(name);
+        if (!w || w.id !== id || w.state !== "running" || w.base)
+            return;
+        if (!written) {
+            this.finish(name, w, "lost");
+            return;
+        }
+        const owner = this.deps.owner(name);
+        const src = this.deps.source(name);
+        const cp = report.checkpoint;
+        const valid = !!cp && typeof cp === "object" && typeof cp.path === "string" && Number.isSafeInteger(cp.ino) && Number.isSafeInteger(cp.size) && cp.size >= 0;
+        if (owner === null || report.owner !== owner || !src.format || !src.path || !valid || cp.path !== src.path) {
+            this.finish(name, w, "lost");
+            return;
+        }
+        w.base = { format: src.format, path: src.path, ino: cp.ino, offset: cp.size, skipping: false, owner, pending: null };
+    }
+    /** The command was not handed over after all: forget its watch (nothing was announced for it). */
+    cancel(name, id) {
+        if (this.watches.get(name)?.id === id)
+            this.drop(name);
+    }
+    /** What the status frame says about the instance's last /compact — or nothing. */
+    view(name) {
+        const w = this.watches.get(name);
+        if (!w)
+            return null;
+        if (w.endedAt !== null && this.now() - w.endedAt >= COMPACT_WATCH_KEEP_MS) {
+            this.watches.delete(name);
+            return null;
+        }
+        return { id: w.id, state: w.state };
+    }
+    /** The instance went away, or the fleet stops. */
+    forget(name) { this.drop(name); }
+    stopAll() { for (const name of [...this.watches.keys()])
+        this.drop(name); }
+    drop(name) {
+        const w = this.watches.get(name);
+        if (!w)
+            return;
+        if (w.timer !== null)
+            this.clear(w.timer);
+        this.watches.delete(name);
+    }
+    finish(name, w, state) {
+        if (this.watches.get(name) !== w || w.state !== "running")
+            return;
+        if (w.timer !== null) {
+            this.clear(w.timer);
+            w.timer = null;
+        }
+        w.state = state;
+        w.endedAt = this.now();
+        this.deps.changed(name);
+    }
+    /**
+     * Whether the watch still stands as `base` was set: the same watch and base, running, the same launch, the source
+     * still this format with a transcript (else lost, said here) — and still this transcript: one that moved meanwhile
+     * stops this look, and the next look starts at the new one's end. Checked after every await and before it ends.
+     */
+    standing(name, w, base) {
+        if (this.watches.get(name) !== w || w.state !== "running" || w.base !== base)
+            return false;
+        const src = this.deps.source(name);
+        if (this.deps.owner(name) !== base.owner || src.format !== base.format || !src.path) {
+            this.finish(name, w, "lost");
+            return false;
+        }
+        return src.path === base.path;
+    }
+    /** One look at the transcript: the watch's timer calls it (tests call it directly). */
+    async poll(name, id) {
+        const w = this.watches.get(name);
+        if (!w || w.id !== id || w.state !== "running" || w.reading)
+            return;
+        if (this.now() >= w.deadline) {
+            this.finish(name, w, "timeout");
+            return;
+        }
+        const base = w.base;
+        if (!base)
+            return; // the command has not reached the pane yet
+        w.reading = true;
+        try {
+            const src = this.deps.source(name);
+            if (this.deps.owner(name) !== base.owner || src.format !== base.format || !src.path) {
+                this.finish(name, w, "lost");
+                return;
+            }
+            if (src.path !== base.path) {
+                // Another transcript of the same launch: only what is written to it from now on.
+                const moved = src.path;
+                const { size, ino } = await stat(moved);
+                const now = this.deps.source(name);
+                if (this.watches.get(name) !== w || w.state !== "running" || w.base !== base)
+                    return;
+                if (this.deps.owner(name) !== base.owner || now.format !== base.format || !now.path) {
+                    this.finish(name, w, "lost");
+                    return;
+                }
+                if (now.path === moved)
+                    Object.assign(base, { path: moved, ino, offset: size, skipping: false, pending: null });
+                return;
+            }
+            const fh = await open(base.path, "r");
+            try {
+                const st = await fh.stat();
+                if (!this.standing(name, w, base))
+                    return;
+                if (st.ino !== base.ino || st.size < base.offset) {
+                    Object.assign(base, { ino: st.ino, offset: st.size, skipping: false, pending: null });
+                    return;
+                }
+                // Every read below goes through this handle: the file whose identity was just checked, whatever the path holds now.
+                const whole = async (offset, bytes) => (await readWholeLine(base.path, offset, bytes, WHOLE_LINE_MAX_BYTES, fh).catch(() => null)) ?? "";
+                for (let look = 0; look < LOOKS_PER_POLL; look++) {
+                    const read = await readNewLines(base.path, base.offset, { skipping: base.skipping, handle: fh });
+                    if (!this.standing(name, w, base))
+                        return;
+                    let found = read.lines.some(l => isCompactionRecord(base.format, l));
+                    // A long record that began in an earlier read ends in this one: read it whole now.
+                    if (base.pending !== null && read.longEnd !== undefined) {
+                        if (!found && isCompactionRecord(base.format, await whole(base.pending, read.longEnd - 1 - base.pending)))
+                            found = true;
+                        base.pending = null;
+                    }
+                    for (const l of read.long) {
+                        if (found || !mayBeCompaction(base.format, l.head))
+                            continue;
+                        if (!l.complete) {
+                            base.pending = l.offset;
+                            continue;
+                        }
+                        if (isCompactionRecord(base.format, await whole(l.offset, l.bytes)))
+                            found = true;
+                    }
+                    if (!this.standing(name, w, base))
+                        return;
+                    const moved = read.newOffset !== base.offset;
+                    base.offset = read.newOffset;
+                    base.skipping = read.skipping;
+                    if (found) {
+                        this.finish(name, w, "done");
+                        return;
+                    }
+                    if (!moved || !read.more)
+                        break;
+                }
+            }
+            finally {
+                await fh.close();
+            }
+        }
+        catch {
+            // A look that fails is tried again on the next tick; the deadline still ends the watch.
+        }
+        finally {
+            w.reading = false;
+        }
+    }
+}
+//# sourceMappingURL=compact-watch.js.map

package/dist/compact-watch.js.map

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

package/dist/daemon.js

@@ -1,6 +1,7 @@
 import { AGENT_WHATS_NEW, agendVersion, planWhatsNew, readWhatsNewRecord, recordWhatsNew, whatsNewNotice } from "./agent-whats-new.js";
 import { join, dirname, basename, resolve } from "node:path";
 import { mkdirSync, writeFileSync, readFileSync, readdirSync, existsSync, unlinkSync, rmSync, appendFileSync, statSync, renameSync } from "node:fs";
+import { launchIdentity } from "./compact-watch.js";
 import { fileURLToPath } from "node:url";
 import { ensureInstanceDir } from "./private-dir.js";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
@@ -102,7 +103,7 @@ export function buildInstructionReloadNotice(binaryName, instanceName, instanceD
         : binaryName === "kiro-cli"
             ? `.kiro/steering/agend-${instanceName}.md`
             : binaryName === "agy"
-                ? ".agents/agents.md"
+                ? ".agents/AGENTS.md"
                 : join(instanceDir, "fleet-instructions.md");
     return `[system] Your AgEnD instructions have been updated. Reload only ${source}; do not scan other instruction directories. Do not reply to this message.`;
 }
@@ -3782,21 +3783,51 @@ export class Daemon extends EventEmitter {
     isDeliveryEpochCurrent(epoch) {
         return epoch === this.deliveryEpoch;
     }
-    queueRawPaste(rawText, deliveryEpoch = this.deliveryEpoch, confirmClear = false, durableAttempt, ownSwitch) {
+    queueRawPaste(rawText, deliveryEpoch = this.deliveryEpoch, confirmClear = false, durableAttempt, ownSwitch, notifyWritten) {
         const reportSwitch = (result) => {
             if (!ownSwitch)
                 return;
             this.ipcServer?.broadcast({ type: "runtime_switch_result", id: ownSwitch.id, ...result });
         };
+        // Board 003648ac: the fleet follows a web /compact from just before its paste is written: the transcript's end then
+        // (taken here, under this launch, before the write) and the launch it was written under ride with the notice — once.
+        // The checkpoint and the launch are taken together, right before the paste (each attempt takes them again); the
+        // notice carries those — never the launch at notice time, which a respawn in between would relabel.
+        let told = false;
+        let checkpoint = null;
+        let owner = null;
+        const tellWritten = (written) => {
+            if (!notifyWritten || told)
+                return;
+            told = true;
+            this.ipcServer?.broadcast({ type: "raw_paste_written", id: notifyWritten, outcome: written ? "written" : "not_written",
+                ...(written ? { owner, checkpoint } : {}) });
+        };
+        const takeCheckpoint = () => {
+            owner = launchIdentity(this.interactionOwner());
+            const path = this.logTranscriptPath();
+            checkpoint = null;
+            if (!path)
+                return;
+            try {
+                const st = statSync(path);
+                checkpoint = { path, ino: st.ino, size: st.size };
+            }
+            catch {
+                checkpoint = null;
+            }
+        };
         if (!this.tmux || !this.isDeliveryEpochCurrent(deliveryEpoch)) {
             if (durableAttempt)
                 this.retryDurableDeliveryBeforeBegin(durableAttempt, "raw_paste target unavailable before pane queue");
             reportSwitch({ outcome: "not_sent" });
+            tellWritten(false);
             return;
         }
         this.pasteLock = this.pasteLock.then(async () => {
             if (!this.isDeliveryEpochCurrent(deliveryEpoch)) {
                 reportSwitch({ outcome: "not_sent" });
+                tellWritten(false);
                 this.logger.info("Pending raw delivery dropped by user cancel");
                 if (durableAttempt)
                     this.retryDurableDeliveryBeforeBegin(durableAttempt, "raw_paste epoch changed while queued");
@@ -3809,6 +3840,7 @@ export class Daemon extends EventEmitter {
                     if (durableAttempt)
                         this.retryDurableDeliveryBeforeBegin(durableAttempt, "raw_paste epoch changed while waking");
                     reportSwitch({ outcome: "not_sent" }); // #1690: cancelled before anything was typed — said at once, nothing saved
+                    tellWritten(false);
                     return;
                 }
                 const delivered = await this.deliverMessage(rawText, undefined, {
@@ -3818,8 +3850,11 @@ export class Daemon extends EventEmitter {
                     preserveExactBytes: true,
                     // #1690: our own /model holds every other delivery from its write on — before the lock is released, so a steer
                     // or /btw waiting on it cannot type into the gap before claude paints "Switch model?" (default cursor: Yes).
-                    ...(ownSwitch ? { onPaneWritten: () => { this.ownSwitch = ownSwitch; } } : {}),
+                    ...(ownSwitch || notifyWritten ? { onPaneWritten: () => { if (ownSwitch)
+                            this.ownSwitch = ownSwitch; tellWritten(true); } } : {}),
+                    ...(notifyWritten ? { beforePaneWrite: takeCheckpoint } : {}),
                 });
+                tellWritten(false); // never written (once told, this says nothing)
                 if (delivered)
                     this.finishDurableSubmission(durableAttempt ?? null, verdict);
                 else if (durableAttempt && verdict.paneWriteStarted) {
@@ -3856,6 +3891,7 @@ export class Daemon extends EventEmitter {
                         this.ownSwitch = null;
                     reportSwitch({ outcome: "not_confirmed" });
                 }
+                tellWritten(false);
                 return;
             }
             if (confirmClear)
@@ -3897,7 +3933,8 @@ export class Daemon extends EventEmitter {
         const sw = msg.runtime_switch;
         const ownSwitch = sw && typeof sw.id === "string" && sw.kind === "model" && typeof sw.requested === "string"
             ? { id: sw.id, kind: "model", requested: sw.requested } : undefined;
-        this.queueRawPaste(msg.content, this.captureDeliveryEpoch(msg.delivery_epoch), msg.confirm_clear === true, durableAttempt ? { ...durableAttempt, submissionMode: "raw_paste", silentSchedule: msg.silent_schedule === true } : undefined, ownSwitch);
+        const notifyWritten = typeof msg.notify_written === "string" && /^[0-9a-f]{16}$/.test(msg.notify_written) ? msg.notify_written : undefined;
+        this.queueRawPaste(msg.content, this.captureDeliveryEpoch(msg.delivery_epoch), msg.confirm_clear === true, durableAttempt ? { ...durableAttempt, submissionMode: "raw_paste", silentSchedule: msg.silent_schedule === true } : undefined, ownSwitch, notifyWritten);
     }
     /**
      * #1690 (the user's choice A): after AgEnD's own `/model <name>`, claude may ask "Switch model?" (a warm cache for
@@ -6969,7 +7006,7 @@ export class Daemon extends EventEmitter {
                     return stale();
                 if (residue !== "clear")
                     return this.failDelivery(verdict, status, "input-residue", residue);
-                const written = await this.writeMessageToPane(formatted, windowId, handingOffToNativeQueue, status, opts?.submissionId, verdict, opts?.durableAttempt, opts?.steer === true, writeCurrent, opts?.humanVerificationId);
+                const written = await this.writeMessageToPane(formatted, windowId, handingOffToNativeQueue, status, opts?.submissionId, verdict, opts?.durableAttempt, opts?.steer === true, writeCurrent, opts?.humanVerificationId, opts?.beforePaneWrite);
                 // #1690: still under the lock — whatever waits on it next must already see what this write started.
                 if (verdict.paneWriteStarted)
                     opts?.onPaneWritten?.();
@@ -8485,7 +8522,9 @@ export class Daemon extends EventEmitter {
     verdict = { reached: false }, durableAttempt, steer = false, 
     // #829: the caller's fence, asked once more after the last await before the
     // first side effect. Stale means unwritten: false, with no failure verdict.
-    stillCurrent, humanVerificationId) {
+    stillCurrent, humanVerificationId, 
+    // Board 003648ac: called synchronously right before each paste — after the last await and fence of that attempt.
+    beforePaste) {
         const signature = this.submissionSignature(formatted, humanVerificationId ?? submissionId, humanVerificationId !== undefined);
         const rawPaste = durableAttempt?.submissionMode === "raw_paste";
         const humanAttempt = verdict.humanReceipt;
@@ -8614,6 +8653,7 @@ export class Daemon extends EventEmitter {
             // same pane; the write-ahead Enter marker later separates safe pre-Enter
             // recovery from a possibly executed command.
             const pasteGeneration = this.spawnGeneration;
+            beforePaste?.();
             const pasted = await this.tmux.pasteBuffer(formatted);
             if (pasted)
                 this.rememberPaste(formatted, pasteGeneration);