@songsid/agend 2.3.0 → 2.3.2-beta.1

package/dist/working-recovery.js

@@ -0,0 +1,263 @@
+import { createHash } from "node:crypto";
+export const WORKING_RECOVERY_KIND = "working_recovery";
+export const RECOVERY_STABLE_MS = 120_000;
+export const RECOVERY_NORMAL_MS = 30_000;
+export const RECOVERY_PACE_MS = 5_000;
+const digest = (value) => createHash("sha256").update(JSON.stringify(value)).digest("hex");
+export function buildWorkingRecoveryPrompt(tasks, cause, advisory) {
+    const ids = tasks.filter(r => r.kind === "task").slice(0, 16).map(r => r.id);
+    return `[system:working-recovery] Interrupted work; observed cause: unknown interruption${cause === "unknown_interruption" ? "" : `; prior requested action: ${cause}`}. `
+        + (advisory ? "Advisory: background state is unknown. " : "")
+        + `Task references: ${JSON.stringify(ids)}. Inspect existing jobs, processes, worktrees, receipts and each current card first. `
+        + "Continue only unfinished work still assigned to you, then report normally. Never restart a command or re-send a delegation blindly; do not replay the original request. "
+        + "This is one informational continuation for this work episode.";
+}
+/** Work identity, not boot identity: another failed boot must not create another prompt. */
+export function recoveryKey(instance, snapshot) {
+    return digest([instance, snapshot.observation.configuration, snapshot.observation.sessionId,
+        snapshot.observation.turn, snapshot.observation.recoveryDeliveryId ?? null,
+        [...snapshot.references].sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b)))]);
+}
+/** Stage 3 owns task-only episodes. The legacy turn/obligation owners remain intact until stage 4. */
+export function decideWorkingRecovery(episode, live, enabled, card) {
+    if (!enabled)
+        return { outcome: "deferred", reason: "opted_out" };
+    const snapshot = episode.snapshot, previous = snapshot.observation;
+    if (previous.turn?.cancelled || previous.turn?.completionDelivered)
+        return { outcome: "excluded", reason: "turn_terminal" };
+    if (!live)
+        return { outcome: "deferred", reason: "not_running" };
+    if (live.stopped)
+        return { outcome: "excluded", reason: "session_oom_stopped" };
+    if (live.cancelled)
+        return { outcome: "excluded", reason: "cancelled" };
+    if (previous.configuration !== live.configuration)
+        return { outcome: "excluded", reason: "configuration_changed" };
+    if (!previous.sessionId || !live.sessionId)
+        return { outcome: "deferred", reason: "session_unknown" };
+    if (live.freshChoice)
+        return { outcome: "excluded", reason: "fresh_session_choice" };
+    if (previous.sessionId !== live.sessionId && !live.crashLoopFresh)
+        return { outcome: "excluded", reason: "session_changed" };
+    if (live.legacyPending)
+        return { outcome: "deferred", reason: "legacy_pending" };
+    if (previous.turn || live.legacyCovered || snapshot.references.some(r => r.kind === "owed")) {
+        return { outcome: "excluded", reason: "legacy_owned" };
+    }
+    if (snapshot.unavailable.length || snapshot.totalReferences > snapshot.references.length)
+        return { outcome: "deferred", reason: "references_incomplete" };
+    const tasks = [];
+    for (const ref of snapshot.references) {
+        if (ref.kind !== "task")
+            continue; // waiting on another agent never authorizes a resend
+        const current = card(ref.id);
+        if (current === null)
+            return { outcome: "deferred", reason: "task_store_unavailable" };
+        if (!current || current.assignee !== episode.instance || ["done", "cancelled", "open"].includes(current.status))
+            continue;
+        if (current.status !== "claimed")
+            return { outcome: "deferred", reason: "task_waiting" };
+        if (current.version !== ref.version)
+            return { outcome: "excluded", reason: "task_changed" };
+        tasks.push(ref);
+    }
+    if (!tasks.length)
+        return { outcome: "excluded", reason: "no_unfinished_task" };
+    if (live.nativeWork)
+        return { outcome: "excluded", reason: "native_reengaged" };
+    if (live.paused || !live.idle)
+        return { outcome: "deferred", reason: "not_idle" };
+    if (live.background === true)
+        return { outcome: "deferred", reason: "background_running" };
+    return { outcome: "ready", tasks, advisory: live.background === null };
+}
+/** Authoritative recovery state on the SAME SQLite connection as the outbox. */
+export class WorkingRecoveryStore {
+    db;
+    constructor(db) {
+        this.db = db;
+        db.exec(`CREATE TABLE IF NOT EXISTS working_recovery_episodes (
+      instance_name TEXT PRIMARY KEY, episode_key TEXT NOT NULL, episode_group TEXT NOT NULL,
+      snapshot_json TEXT NOT NULL CHECK(length(CAST(snapshot_json AS BLOB))<=8192),
+      outcome TEXT NOT NULL, reason TEXT NOT NULL, delivery_id TEXT
+    );
+    CREATE TABLE IF NOT EXISTS working_recovery_receipts (episode_key TEXT PRIMARY KEY, outcome TEXT NOT NULL, reason TEXT NOT NULL);
+    CREATE TABLE IF NOT EXISTS working_recovery_run (singleton INTEGER PRIMARY KEY CHECK(singleton=1),
+      boot_id TEXT NOT NULL, pid INTEGER NOT NULL, started_at INTEGER NOT NULL, requested_cause TEXT);
+    CREATE TABLE IF NOT EXISTS working_recovery_summaries (episode_group TEXT PRIMARY KEY);
+    CREATE TABLE IF NOT EXISTS working_recovery_cancellations (instance_name TEXT PRIMARY KEY, configuration TEXT NOT NULL, session_id TEXT);`);
+    }
+    beginRun(bootId, pid, now) {
+        return this.db.transaction(() => {
+            const previous = this.db.prepare("SELECT boot_id,requested_cause FROM working_recovery_run WHERE singleton=1").get();
+            if (previous?.boot_id === bootId)
+                return "unknown_interruption";
+            this.db.prepare("INSERT OR REPLACE INTO working_recovery_run VALUES(1,?,?,?,NULL)").run(bootId, pid, now);
+            return previous?.requested_cause === "manual_restart" || previous?.requested_cause === "update" ? previous.requested_cause : "unknown_interruption";
+        })();
+    }
+    requested(bootId, cause) {
+        this.db.prepare("UPDATE working_recovery_run SET requested_cause=? WHERE singleton=1 AND boot_id=?").run(cause, bootId);
+    }
+    clearRequested(bootId) {
+        this.db.prepare("UPDATE working_recovery_run SET requested_cause=NULL WHERE singleton=1 AND boot_id=?").run(bootId);
+    }
+    cancel(instance, configuration, sessionId) {
+        this.db.prepare("INSERT OR REPLACE INTO working_recovery_cancellations VALUES(?,?,?)").run(instance, configuration, sessionId);
+    }
+    cancelled(instance, snapshot) {
+        const row = this.db.prepare("SELECT configuration,session_id FROM working_recovery_cancellations WHERE instance_name=?").get(instance);
+        return !!row && row.configuration === snapshot.observation.configuration && row.session_id === snapshot.observation.sessionId;
+    }
+    discover(instance, snapshot) {
+        const key = recoveryKey(instance, snapshot);
+        this.db.transaction(() => {
+            const receipt = this.db.prepare("SELECT outcome,reason FROM working_recovery_receipts WHERE episode_key=?").get(key);
+            const current = this.get(instance);
+            if (current?.key === key)
+                return;
+            // An admitted/uncertain delivery is owned by the outbox, never replaced by a new candidate.
+            if (current?.outcome === "admitted" && current.deliveryId) {
+                const delivery = this.db.prepare("SELECT state FROM deliveries WHERE delivery_id=?").get(current.deliveryId);
+                if (!delivery || !["delivered", "failed", "cancelled"].includes(delivery.state))
+                    return;
+            }
+            this.db.prepare(`INSERT OR REPLACE INTO working_recovery_episodes VALUES(?,?,?,?,?,?,NULL)`)
+                .run(instance, key, snapshot.managerBootId, JSON.stringify(snapshot), receipt?.outcome ?? "deferred", receipt?.reason ?? "awaiting_stability");
+        })();
+    }
+    get(instance) {
+        const row = this.db.prepare("SELECT * FROM working_recovery_episodes WHERE instance_name=?").get(instance);
+        return row ? { instance: row.instance_name, key: row.episode_key, group: row.episode_group, snapshot: JSON.parse(row.snapshot_json),
+            outcome: row.outcome, reason: row.reason, deliveryId: row.delivery_id } : null;
+    }
+    list() {
+        return this.db.prepare("SELECT instance_name FROM working_recovery_episodes ORDER BY instance_name").all().map(r => this.get(r.instance_name));
+    }
+    clearPrior(episode) {
+        this.db.prepare("UPDATE working_state_journal SET prior_json=NULL WHERE instance_name=? AND prior_json=?")
+            .run(episode.instance, JSON.stringify(episode.snapshot));
+    }
+    decision(episode, outcome, reason) {
+        const before = this.get(episode.instance);
+        if (before?.key !== episode.key || before.outcome === "admitted"
+            || before.outcome === outcome && before.reason === reason)
+            return;
+        this.db.transaction(() => {
+            const current = this.get(episode.instance);
+            if (current?.key !== episode.key || current.outcome === "admitted")
+                return;
+            this.db.prepare("UPDATE working_recovery_episodes SET outcome=?,reason=? WHERE instance_name=? AND episode_key=?").run(outcome, reason, episode.instance, episode.key);
+            if (outcome === "excluded") {
+                this.db.prepare("INSERT OR IGNORE INTO working_recovery_receipts VALUES(?,?,?)").run(episode.key, outcome, reason);
+                this.clearPrior(episode);
+            }
+        })();
+    }
+    /** The delivery admission and episode receipt commit together, or neither does. */
+    admit(episode, insert, advisory = false) {
+        return this.db.transaction(() => {
+            const current = this.get(episode.instance);
+            if (current?.key !== episode.key || current.outcome !== "deferred")
+                return false;
+            if (this.db.prepare("SELECT 1 FROM working_recovery_receipts WHERE episode_key=?").get(episode.key))
+                return false;
+            const deliveryId = insert();
+            this.db.prepare("UPDATE working_recovery_episodes SET outcome='admitted',reason=?,delivery_id=? WHERE instance_name=? AND episode_key=?")
+                .run(advisory ? "advisory_background_unknown" : "outbox_owned", deliveryId, episode.instance, episode.key);
+            this.db.prepare("INSERT INTO working_recovery_receipts VALUES(?,'admitted',?)")
+                .run(episode.key, advisory ? "advisory_background_unknown" : "outbox_owned");
+            this.clearPrior(episode);
+            return true;
+        })();
+    }
+    summary(group, insert) {
+        return this.db.transaction(() => {
+            if (this.db.prepare("SELECT 1 FROM working_recovery_summaries WHERE episode_group=?").get(group))
+                return false;
+            insert();
+            this.db.prepare("INSERT INTO working_recovery_summaries VALUES(?)").run(group);
+            return true;
+        })();
+    }
+}
+/** No spawn or native probes. Missing prerequisites leave the durable candidate deferred. */
+export class WorkingRecoveryCoordinator {
+    deps;
+    readyAt = null;
+    normalAt = null;
+    lastAdmittedAt = Number.NEGATIVE_INFINITY;
+    lastDispatchedAt = Number.NEGATIVE_INFINITY;
+    dispatchOwner = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    ready() { this.readyAt = this.deps.now(); this.normalAt = null; }
+    reset() { this.readyAt = null; this.normalAt = null; }
+    stable() {
+        const now = this.deps.now(), p = this.deps.pressure();
+        if (!this.deps.active() || this.deps.storm() || p.level !== "normal" || p.sampledAt === null || p.recovering) {
+            this.normalAt = null;
+            return false;
+        }
+        this.normalAt ??= now;
+        return this.readyAt !== null && now - this.readyAt >= RECOVERY_STABLE_MS && now - this.normalAt >= RECOVERY_NORMAL_MS;
+    }
+    verdict(episode) {
+        if (this.deps.store.cancelled(episode.instance, episode.snapshot))
+            return { outcome: "excluded", reason: "cancelled" };
+        return decideWorkingRecovery(episode, this.deps.live(episode.instance), this.deps.enabled(episode.instance), this.deps.card);
+    }
+    tick() {
+        if (!this.stable())
+            return;
+        for (const row of this.deps.store.list()) {
+            if (row.outcome !== "deferred")
+                continue;
+            const verdict = this.verdict(row);
+            if (verdict.outcome !== "ready") {
+                this.deps.store.decision(row, verdict.outcome, verdict.reason);
+                if (row.reason !== verdict.reason || row.outcome !== verdict.outcome)
+                    this.deps.log(row, verdict.outcome, verdict.reason);
+                continue;
+            }
+            if (!this.deps.laneFree(row.instance) || this.deps.now() - this.lastAdmittedAt < RECOVERY_PACE_MS)
+                continue;
+            if (this.deps.admit(row, verdict.tasks, verdict.advisory)) {
+                this.lastAdmittedAt = this.deps.now();
+                this.deps.log(row, "admitted", verdict.advisory ? "advisory_background_unknown" : "outbox_owned");
+            }
+        }
+        const rows = this.deps.store.list();
+        for (const group of new Set(rows.map(row => row.group))) {
+            const members = rows.filter(row => row.group === group);
+            // Finish the paced admission sweep before the single summary, so every
+            // advisory admission in that sweep is named, rather than only its first row.
+            if (members.some(row => row.outcome === "deferred" && this.verdict(row).outcome === "ready"))
+                continue;
+            this.deps.summary(group, members);
+        }
+    }
+    /** Called again by the local pane writer, including after every awaited prerequisite. */
+    accepts(instance, key) {
+        if (!this.stable())
+            return false;
+        const row = this.deps.store.get(instance);
+        return !!row && row.key === key && row.outcome === "admitted" && this.verdict(row).outcome === "ready";
+    }
+    /** Recovered queued rows also pass this physical-write pace, independently of admission. */
+    canDispatch(instance, key) {
+        return this.dispatchOwner === null && this.deps.now() - this.lastDispatchedAt >= RECOVERY_PACE_MS
+            && this.accepts(instance, key);
+    }
+    reserveDispatch(instance, key) {
+        if (!this.canDispatch(instance, key))
+            return null;
+        const owner = { instance, key };
+        this.dispatchOwner = owner;
+        this.lastDispatchedAt = this.deps.now();
+        return () => { if (this.dispatchOwner === owner)
+            this.dispatchOwner = null; };
+    }
+}
+//# sourceMappingURL=working-recovery.js.map

package/dist/working-recovery.js.map

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

package/dist/working-state-journal.d.ts

@@ -0,0 +1,70 @@
+import type Database from "better-sqlite3";
+/** Metadata only. Stage 1 observes; these records never authorize a resume. */
+export declare const WORKING_STATE_MAX_BYTES: number;
+export declare const WORKING_STATE_MAX_REFS = 16;
+export type WorkingStateReason = "published" | "execution" | "background" | "turn_started" | "turn_closed" | "completion_delivered" | "cancelled" | "before_stop" | "before_spawn" | "process" | "supervision_ended" | "tasks" | "obligations";
+export interface WorkingStateOwner {
+    bootId: string;
+    spawnGeneration: number;
+    launchAttempt: number;
+    launchFenceEpoch: number;
+}
+export interface WorkingStateTurn {
+    generation: number;
+    deliveryId: string | null;
+    correlationId: string | null;
+    messageId: string | null;
+    cancelled: boolean;
+    completionDelivered: boolean;
+}
+export interface WorkingStateObservation {
+    owner: WorkingStateOwner;
+    backend: string;
+    /** A digest, never a raw workspace/profile or transcript path. */
+    configuration: string;
+    executionState: "idle" | "working" | "stuck" | "paused" | null;
+    processStatus: "running" | "crashed" | "stopped";
+    backgroundWork: boolean | null;
+    turn: WorkingStateTurn | null;
+    /** No generic getSessionId discovery is allowed on this observation path. */
+    sessionId: string | null;
+    backendTurnId: null;
+    /** A confirmed local continuation starts a demonstrably resumed work interval. */
+    recoveryDeliveryId?: string;
+}
+export type WorkingStateReference = {
+    kind: "task";
+    id: string;
+    version: number;
+    status: "claimed" | "blocked" | "review";
+} | {
+    kind: "owed" | "waiting";
+    correlationId: string;
+    requester: string;
+    owner: string;
+    deliveryId: string;
+};
+export interface WorkingStateSnapshot {
+    version: 1;
+    managerBootId: string;
+    observedAt: number;
+    lastActivityAt: number | null;
+    reason: WorkingStateReason;
+    observation: WorkingStateObservation;
+    references: WorkingStateReference[];
+    totalReferences: number;
+    unavailable: Array<"tasks" | "obligations">;
+}
+export interface WorkingStateEntry {
+    instance: string;
+    revision: number;
+    current: WorkingStateSnapshot;
+    prior: WorkingStateSnapshot | null;
+}
+/** Two bounded snapshots per instance: latest, plus first unconsumed interruption. */
+export declare class WorkingStateJournal {
+    private readonly db;
+    constructor(db: Database.Database);
+    get(instance: string): WorkingStateEntry | undefined;
+    observe(instance: string, input: WorkingStateSnapshot): WorkingStateEntry | null;
+}

package/dist/working-state-journal.js

@@ -0,0 +1,106 @@
+/** Metadata only. Stage 1 observes; these records never authorize a resume. */
+export const WORKING_STATE_MAX_BYTES = 8 * 1024;
+export const WORKING_STATE_MAX_REFS = 16;
+const reasons = new Set(["published", "execution", "background", "turn_started", "turn_closed", "completion_delivered", "cancelled", "before_stop", "before_spawn", "process", "supervision_ended", "tasks", "obligations"]);
+const id = (v) => typeof v === "string" && v.length > 0 && Buffer.byteLength(v) <= 256 && !/[\u0000-\u001f\u007f]/.test(v);
+const integer = (v) => Number.isSafeInteger(v) && v >= 0;
+/** Whitelist every field: callers cannot accidentally persist a pane/config/message. */
+function bounded(input) {
+    const o = input.observation, owner = o.owner, turn = o.turn;
+    if (!id(input.managerBootId) || !reasons.has(input.reason) || !Number.isFinite(input.observedAt)
+        || !id(owner.bootId) || ![owner.spawnGeneration, owner.launchAttempt, owner.launchFenceEpoch].every(integer)
+        || !id(o.backend) || !/^[a-f0-9]{64}$/.test(o.configuration)
+        || ![null, "idle", "working", "stuck", "paused"].includes(o.executionState)
+        || !["running", "crashed", "stopped"].includes(o.processStatus))
+        throw new Error("Invalid working-state observation");
+    const refs = [];
+    for (const ref of input.references.slice(0, WORKING_STATE_MAX_REFS)) {
+        if (ref.kind === "task" && id(ref.id) && integer(ref.version) && ["claimed", "blocked", "review"].includes(ref.status)) {
+            refs.push({ kind: "task", id: ref.id, version: ref.version, status: ref.status });
+        }
+        else if ((ref.kind === "owed" || ref.kind === "waiting") && [ref.correlationId, ref.requester, ref.owner, ref.deliveryId].every(id)) {
+            refs.push({ kind: ref.kind, correlationId: ref.correlationId, requester: ref.requester, owner: ref.owner, deliveryId: ref.deliveryId });
+        }
+    }
+    const value = {
+        version: 1, managerBootId: input.managerBootId, observedAt: input.observedAt, reason: input.reason,
+        lastActivityAt: typeof input.lastActivityAt === "number" && Number.isFinite(input.lastActivityAt) ? input.lastActivityAt : null,
+        observation: {
+            owner: { bootId: owner.bootId, spawnGeneration: owner.spawnGeneration, launchAttempt: owner.launchAttempt, launchFenceEpoch: owner.launchFenceEpoch },
+            backend: o.backend, configuration: o.configuration, executionState: o.executionState, processStatus: o.processStatus,
+            backgroundWork: typeof o.backgroundWork === "boolean" ? o.backgroundWork : null,
+            turn: turn && integer(turn.generation) ? { generation: turn.generation,
+                deliveryId: id(turn.deliveryId) ? turn.deliveryId : null, correlationId: id(turn.correlationId) ? turn.correlationId : null,
+                messageId: id(turn.messageId) ? turn.messageId : null, cancelled: turn.cancelled === true, completionDelivered: turn.completionDelivered === true } : null,
+            sessionId: id(o.sessionId) ? o.sessionId : null, backendTurnId: null,
+            ...(id(o.recoveryDeliveryId) ? { recoveryDeliveryId: o.recoveryDeliveryId } : {}),
+        },
+        references: refs, totalReferences: Math.max(integer(input.totalReferences) ? input.totalReferences : 0, input.references.length),
+        unavailable: ["tasks", "obligations"].filter(x => input.unavailable.includes(x)),
+    };
+    while (Buffer.byteLength(JSON.stringify(value)) > WORKING_STATE_MAX_BYTES && value.references.length)
+        value.references.pop();
+    if (Buffer.byteLength(JSON.stringify(value)) > WORKING_STATE_MAX_BYTES)
+        throw new Error("Working-state observation exceeds its byte budget");
+    return value;
+}
+function notable(s) {
+    const turn = s.observation.turn;
+    return s.totalReferences > 0 || s.observation.backgroundWork === true || (!!turn && !turn.cancelled && !turn.completionDelivered)
+        || (s.observation.executionState === "working" && !turn?.cancelled && !turn?.completionDelivered);
+}
+/** Two bounded snapshots per instance: latest, plus first unconsumed interruption. */
+export class WorkingStateJournal {
+    db;
+    constructor(db) {
+        this.db = db;
+        db.exec(`CREATE TABLE IF NOT EXISTS working_state_journal (
+      instance_name TEXT PRIMARY KEY, revision INTEGER NOT NULL,
+      current_json TEXT NOT NULL CHECK(length(CAST(current_json AS BLOB)) <= 8192),
+      prior_json TEXT CHECK(prior_json IS NULL OR length(CAST(prior_json AS BLOB)) <= 8192)
+    )`);
+    }
+    get(instance) {
+        const row = this.db.prepare("SELECT revision,current_json,prior_json FROM working_state_journal WHERE instance_name=?").get(instance);
+        if (!row)
+            return undefined;
+        return { instance, revision: row.revision, current: JSON.parse(row.current_json), prior: row.prior_json ? JSON.parse(row.prior_json) : null };
+    }
+    observe(instance, input) {
+        if (!id(instance))
+            throw new Error("Invalid working-state instance");
+        let snapshot = bounded(input);
+        return this.db.transaction(() => {
+            const previous = this.get(instance);
+            // A confirmed continuation identifies work, not a CLI generation. A
+            // replacement may temporarily lack session ownership; recover the marker
+            // only after it proves the same configuration/session, never for a fresh one.
+            if (!snapshot.observation.recoveryDeliveryId && snapshot.observation.sessionId) {
+                const matching = [previous?.current, previous?.prior].find(s => s?.observation.recoveryDeliveryId
+                    && s.observation.configuration === snapshot.observation.configuration
+                    && s.observation.sessionId === snapshot.observation.sessionId);
+                if (matching) {
+                    snapshot.observation.recoveryDeliveryId = matching.observation.recoveryDeliveryId;
+                    snapshot = bounded(snapshot); // The inherited metadata must also fit the byte budget.
+                }
+            }
+            // Exact heartbeats do not write or emit. The caller observes changes, not polling.
+            const comparable = (s) => JSON.stringify({ ...s, observedAt: 0, reason: "observation" });
+            const boundary = snapshot.reason === "before_stop" || snapshot.reason === "before_spawn";
+            if (previous && comparable(previous.current) === comparable(snapshot)
+                && !(boundary && previous.current.reason !== snapshot.reason))
+                return null;
+            let prior = previous?.prior ?? null;
+            if (!prior && previous?.current.managerBootId !== snapshot.managerBootId && previous && notable(previous.current))
+                prior = previous.current;
+            if (!prior && boundary && notable(snapshot))
+                prior = snapshot;
+            const revision = (previous?.revision ?? 0) + 1;
+            this.db.prepare(`INSERT INTO working_state_journal(instance_name,revision,current_json,prior_json) VALUES(?,?,?,?)
+        ON CONFLICT(instance_name) DO UPDATE SET revision=excluded.revision,current_json=excluded.current_json,prior_json=excluded.prior_json`)
+                .run(instance, revision, JSON.stringify(snapshot), prior ? JSON.stringify(prior) : null);
+            return { instance, revision, current: snapshot, prior };
+        })();
+    }
+}
+//# sourceMappingURL=working-state-journal.js.map

package/dist/working-state-journal.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@songsid/agend",
-  "version": "2.3.0",
+  "version": "2.3.2-beta.1",
   "description": "Multi-agent fleet daemon — run coding CLIs (Claude, Muse, Codex, OpenCode) from Discord or Telegram",
   "type": "module",
   "bin": {