instar 1.3.1661 → 1.3.1663

package/dist/threadline/requiredAckStore.d.ts

@@ -0,0 +1,149 @@
+/**
+ * RequiredAckStore — durable state of docs/specs/a2a-required-acknowledgment.md,
+ * in the A2ADeliveryTracker's database: peer capabilities (D1) and the one D5 table
+ * `a2a_ack_watch`, which holds two kinds of row.
+ *
+ * A `watch` row follows one inbound message through this receiver:
+ *   prepared → router in flight (the handle already exists, in the prompt)
+ *   queued   → in the spawn manager's in-memory queue (the D2 journal row)
+ *   open     → a session has it; the D5 clock is running
+ *   closed   → acknowledged, replied, unacknowledged, dropped, or not delivered
+ *
+ * A `pending` row is a kinded ack the sender must hear (`read`, `dropped`,
+ * `unknown`, `unacknowledged`). It stores whether the trigger arrived encrypted,
+ * because known keys empty on restart. Its text is rebuilt from the fixed set.
+ *
+ * Signal-only: nothing here can block a session or a message.
+ */
+import type { Database as BetterSqliteDatabase } from 'better-sqlite3';
+import type { HeldReason } from './requiredAck.js';
+export declare const REQUIRED_ACK_SCHEMA = "\nCREATE TABLE IF NOT EXISTS a2a_peer_caps (\n  peer_fp TEXT PRIMARY KEY,\n  ack_kinds INTEGER NOT NULL,\n  seen_at TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS a2a_ack_watch (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  row_kind TEXT NOT NULL,\n  status TEXT NOT NULL,\n  peer_fp TEXT NOT NULL,\n  message_id TEXT NOT NULL,\n  thread_id TEXT,\n  ack_ref TEXT,\n  session_name TEXT,\n  launch_lane TEXT,\n  trigger_encrypted INTEGER NOT NULL DEFAULT 0,\n  copies INTEGER NOT NULL DEFAULT 0,\n  handed_off INTEGER NOT NULL DEFAULT 0,\n  replied_before_open INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  opened_at TEXT,\n  reminded_at TEXT,\n  closed_at TEXT,\n  close_reason TEXT,\n  ack_kind TEXT,\n  ack_state TEXT,\n  ack_reason TEXT,\n  summary TEXT,\n  attempts INTEGER NOT NULL DEFAULT 0,\n  next_attempt_at TEXT,\n  expires_at TEXT,\n  sent_at TEXT\n);\nCREATE UNIQUE INDEX IF NOT EXISTS idx_a2a_ack_watch_ref ON a2a_ack_watch(ack_ref) WHERE ack_ref IS NOT NULL;\nCREATE UNIQUE INDEX IF NOT EXISTS idx_a2a_ack_watch_msg ON a2a_ack_watch(peer_fp, message_id) WHERE row_kind = 'watch';\nCREATE INDEX IF NOT EXISTS idx_a2a_ack_watch_open ON a2a_ack_watch(status, opened_at) WHERE status IN ('open','queued','prepared','pending');\nCREATE INDEX IF NOT EXISTS idx_a2a_ack_watch_peer ON a2a_ack_watch(peer_fp, close_reason);\n";
+/** Closed rows are removed after this long (D5). */
+export declare const WATCH_RETENTION_MS: number;
+export interface WatchRow {
+    id: number;
+    status: 'prepared' | 'queued' | 'open' | 'closed';
+    peerFp: string;
+    messageId: string;
+    threadId: string | null;
+    ackRef: string;
+    sessionName: string | null;
+    launchLane: 'interactive' | 'headless' | null;
+    triggerEncrypted: boolean;
+    copies: number;
+    handedOff: boolean;
+    repliedBeforeOpen: boolean;
+    openedAt: string | null;
+    remindedAt: string | null;
+    closeReason: string | null;
+}
+export interface PendingRow {
+    id: number;
+    peerFp: string;
+    messageId: string;
+    threadId: string | null;
+    ackKind: 'held' | 'read';
+    ackState: string | null;
+    ackReason: HeldReason | null;
+    summary: string | null;
+    triggerEncrypted: boolean;
+    attempts: number;
+    nextAttemptAt: string;
+    expiresAt: string;
+}
+export interface RequiredAckPeerCounts {
+    /** Messages this peer sent us that sessions never acknowledged within the window. */
+    unacknowledged: number;
+    /** Must-hear receipts that expired before they could be sent. */
+    pendingExpired: number;
+    /** Pending receipts still waiting to go out. */
+    pending: number;
+    /** Messages that reached a topic session on another machine, so are not watched. */
+    notWatchedRemoteTopic: number;
+    /** Watches currently running. */
+    openWatches: number;
+}
+/** A short random handle. A peer never chooses it, and it maps only through this table. */
+export declare function mintAckRef(): string;
+export declare class RequiredAckStore {
+    private readonly db;
+    constructor(db: BetterSqliteDatabase);
+    /** Record the highest value per peer. A chat message without the stamp deletes the row. */
+    notePeerCaps(peerFp: string, ackKinds: unknown, at: string): void;
+    peerAckKinds(peerFp: string): number | null;
+    /**
+     * The row for one inbound message, before the router runs. The handle exists from
+     * here, so a session can never hold a handle with no row behind it. A resend of the
+     * same id reuses the row: a row a session never answered is re-armed, so the new
+     * copy's receipts apply; an acknowledged or replied one stays closed.
+     */
+    prepareWatch(input: {
+        peerFp: string;
+        messageId: string;
+        threadId: string | null;
+        triggerEncrypted: boolean;
+        at: string;
+    }): WatchRow;
+    watchForMessage(peerFp: string, messageId: string): WatchRow | null;
+    watchForRef(ackRef: string): WatchRow | null;
+    /** The D2 journal: held in the spawn queue. A row already handed off stays as it is. */
+    markQueued(id: number, threadId: string | null): void;
+    /**
+     * A session received the message. If a reply beat the row, the row opens already
+     * closed. Idempotent: a later copy reaching a session leaves the clock running.
+     * Returns true when the clock started.
+     */
+    openWatch(id: number, input: {
+        sessionName: string | null;
+        lane: 'interactive' | 'headless';
+        threadId?: string | null;
+        at: string;
+    }): boolean;
+    closeWatch(id: number, reason: string, at: string): void;
+    /** One queued copy died. Returns true when no copy is left and none reached a session. */
+    dropCopy(id: number): boolean;
+    /**
+     * A session-authored send was accepted on this thread to this peer. Closes open
+     * rows; a row not yet open remembers the reply, and opens already closed.
+     */
+    closeOnReply(peerFp: string, threadId: string, at: string): number;
+    /** Open watches, oldest first. Bounded by the partial index. */
+    openWatches(limit?: number): WatchRow[];
+    markReminded(ids: number[], at: string): void;
+    /** Reminder events (not rows: a burst shares one timestamp) sent to sessions about this peer since `sinceIso`. */
+    remindersSince(peerFp: string, sinceIso: string): number;
+    /** Rows a restart interrupted: the server had a message that never finished its hand-off. */
+    interruptedWatches(limit?: number): WatchRow[];
+    /** Durably queue a kinded ack the sender must hear. Idempotent per (peer, message, kind, state). */
+    addPending(input: {
+        peerFp: string;
+        messageId: string;
+        threadId: string | null;
+        ackKind: 'held' | 'read';
+        ackState: string | null;
+        ackReason: HeldReason | null;
+        summary?: string | null;
+        triggerEncrypted: boolean;
+        at: string;
+        expiresAt: string;
+    }): number;
+    /** A `read` write and the watch close, as one step: a limit or a crash cannot lose both. */
+    acceptRead(input: {
+        watch: WatchRow;
+        summary: string;
+        at: string;
+        expiresAt: string;
+    }): number;
+    duePending(nowIsoStr: string, limit?: number): PendingRow[];
+    /** Pending rows past their hour close as expired, counted on the health read. */
+    expirePending(nowIsoStr: string): number;
+    markPendingSent(ids: number[], at: string): void;
+    closePending(ids: number[], reason: string, at: string): void;
+    markPendingRetry(ids: number[], attempts: number, nextAttemptAt: string): void;
+    /** A remote topic session has it: not watched, and health says so. */
+    markNotWatched(id: number, at: string): void;
+    peerCounts(peerFp: string): RequiredAckPeerCounts;
+    /** Retention: closed rows older than 14 days. Bounded per sweep. */
+    sweep(nowMs: number): number;
+}
+//# sourceMappingURL=requiredAckStore.d.ts.map

package/dist/threadline/requiredAckStore.d.ts.map

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

package/dist/threadline/requiredAckStore.js

@@ -0,0 +1,283 @@
+/**
+ * RequiredAckStore — durable state of docs/specs/a2a-required-acknowledgment.md,
+ * in the A2ADeliveryTracker's database: peer capabilities (D1) and the one D5 table
+ * `a2a_ack_watch`, which holds two kinds of row.
+ *
+ * A `watch` row follows one inbound message through this receiver:
+ *   prepared → router in flight (the handle already exists, in the prompt)
+ *   queued   → in the spawn manager's in-memory queue (the D2 journal row)
+ *   open     → a session has it; the D5 clock is running
+ *   closed   → acknowledged, replied, unacknowledged, dropped, or not delivered
+ *
+ * A `pending` row is a kinded ack the sender must hear (`read`, `dropped`,
+ * `unknown`, `unacknowledged`). It stores whether the trigger arrived encrypted,
+ * because known keys empty on restart. Its text is rebuilt from the fixed set.
+ *
+ * Signal-only: nothing here can block a session or a message.
+ */
+import crypto from 'node:crypto';
+export const REQUIRED_ACK_SCHEMA = `
+CREATE TABLE IF NOT EXISTS a2a_peer_caps (
+  peer_fp TEXT PRIMARY KEY,
+  ack_kinds INTEGER NOT NULL,
+  seen_at TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS a2a_ack_watch (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  row_kind TEXT NOT NULL,
+  status TEXT NOT NULL,
+  peer_fp TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  thread_id TEXT,
+  ack_ref TEXT,
+  session_name TEXT,
+  launch_lane TEXT,
+  trigger_encrypted INTEGER NOT NULL DEFAULT 0,
+  copies INTEGER NOT NULL DEFAULT 0,
+  handed_off INTEGER NOT NULL DEFAULT 0,
+  replied_before_open INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL,
+  opened_at TEXT,
+  reminded_at TEXT,
+  closed_at TEXT,
+  close_reason TEXT,
+  ack_kind TEXT,
+  ack_state TEXT,
+  ack_reason TEXT,
+  summary TEXT,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at TEXT,
+  expires_at TEXT,
+  sent_at TEXT
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_a2a_ack_watch_ref ON a2a_ack_watch(ack_ref) WHERE ack_ref IS NOT NULL;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_a2a_ack_watch_msg ON a2a_ack_watch(peer_fp, message_id) WHERE row_kind = 'watch';
+CREATE INDEX IF NOT EXISTS idx_a2a_ack_watch_open ON a2a_ack_watch(status, opened_at) WHERE status IN ('open','queued','prepared','pending');
+CREATE INDEX IF NOT EXISTS idx_a2a_ack_watch_peer ON a2a_ack_watch(peer_fp, close_reason);
+`;
+/** Closed rows are removed after this long (D5). */
+export const WATCH_RETENTION_MS = 14 * 24 * 60 * 60 * 1000;
+const SWEEP_LIMIT = 500;
+function toWatch(r) {
+    return {
+        id: r.id, status: r.status, peerFp: r.peer_fp, messageId: r.message_id, threadId: r.thread_id ?? null,
+        ackRef: r.ack_ref, sessionName: r.session_name ?? null, launchLane: r.launch_lane ?? null,
+        triggerEncrypted: r.trigger_encrypted === 1, copies: r.copies, handedOff: r.handed_off === 1,
+        repliedBeforeOpen: r.replied_before_open === 1, openedAt: r.opened_at ?? null, remindedAt: r.reminded_at ?? null,
+        closeReason: r.close_reason ?? null,
+    };
+}
+function toPending(r) {
+    return {
+        id: r.id, peerFp: r.peer_fp, messageId: r.message_id, threadId: r.thread_id ?? null,
+        ackKind: r.ack_kind, ackState: r.ack_state ?? null, ackReason: r.ack_reason ?? null,
+        summary: r.summary ?? null, triggerEncrypted: r.trigger_encrypted === 1, attempts: r.attempts,
+        nextAttemptAt: r.next_attempt_at, expiresAt: r.expires_at,
+    };
+}
+/** A short random handle. A peer never chooses it, and it maps only through this table. */
+export function mintAckRef() {
+    return `ack-${crypto.randomBytes(6).toString('hex')}`;
+}
+export class RequiredAckStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ── D1: capabilities ──────────────────────────────────────────────
+    /** Record the highest value per peer. A chat message without the stamp deletes the row. */
+    notePeerCaps(peerFp, ackKinds, at) {
+        if (!peerFp)
+            return;
+        if (typeof ackKinds === 'number' && Number.isFinite(ackKinds) && ackKinds >= 1) {
+            this.db.prepare(`INSERT INTO a2a_peer_caps (peer_fp, ack_kinds, seen_at) VALUES (?, ?, ?)
+         ON CONFLICT(peer_fp) DO UPDATE SET ack_kinds = MAX(a2a_peer_caps.ack_kinds, excluded.ack_kinds), seen_at = excluded.seen_at`).run(peerFp, Math.floor(ackKinds), at);
+        }
+        else {
+            this.db.prepare(`DELETE FROM a2a_peer_caps WHERE peer_fp = ?`).run(peerFp);
+        }
+    }
+    peerAckKinds(peerFp) {
+        const r = this.db.prepare(`SELECT ack_kinds FROM a2a_peer_caps WHERE peer_fp = ?`).get(peerFp);
+        return r?.ack_kinds ?? null;
+    }
+    // ── Watch rows ────────────────────────────────────────────────────
+    /**
+     * The row for one inbound message, before the router runs. The handle exists from
+     * here, so a session can never hold a handle with no row behind it. A resend of the
+     * same id reuses the row: a row a session never answered is re-armed, so the new
+     * copy's receipts apply; an acknowledged or replied one stays closed.
+     */
+    prepareWatch(input) {
+        const existing = this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE row_kind = 'watch' AND peer_fp = ? AND message_id = ?`)
+            .get(input.peerFp, input.messageId);
+        if (existing) {
+            if (existing.status === 'closed' && existing.close_reason !== 'acknowledged' && existing.close_reason !== 'replied') {
+                this.db.prepare(`UPDATE a2a_ack_watch SET status = 'prepared', closed_at = NULL, close_reason = NULL, copies = 0, reminded_at = NULL, opened_at = NULL, handed_off = 0 WHERE id = ?`).run(existing.id);
+            }
+            // A copy that arrived encrypted means the peer holds keys, so the acknowledgment
+            // must never go plaintext, whichever copy came first.
+            if (input.triggerEncrypted && !existing.trigger_encrypted) {
+                this.db.prepare(`UPDATE a2a_ack_watch SET trigger_encrypted = 1 WHERE id = ?`).run(existing.id);
+            }
+            return toWatch(this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE id = ?`).get(existing.id));
+        }
+        const ackRef = mintAckRef();
+        this.db.prepare(`INSERT INTO a2a_ack_watch (row_kind, status, peer_fp, message_id, thread_id, ack_ref, trigger_encrypted, created_at)
+       VALUES ('watch', 'prepared', ?, ?, ?, ?, ?, ?)`).run(input.peerFp, input.messageId, input.threadId, ackRef, input.triggerEncrypted ? 1 : 0, input.at);
+        return toWatch(this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE ack_ref = ?`).get(ackRef));
+    }
+    watchForMessage(peerFp, messageId) {
+        const r = this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE row_kind = 'watch' AND peer_fp = ? AND message_id = ?`).get(peerFp, messageId);
+        return r ? toWatch(r) : null;
+    }
+    watchForRef(ackRef) {
+        const r = this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE row_kind = 'watch' AND ack_ref = ?`).get(ackRef);
+        return r ? toWatch(r) : null;
+    }
+    /** The D2 journal: held in the spawn queue. A row already handed off stays as it is. */
+    markQueued(id, threadId) {
+        this.db.prepare(`UPDATE a2a_ack_watch SET status = 'queued', copies = copies + 1, thread_id = COALESCE(?, thread_id)
+       WHERE id = ? AND status IN ('prepared','queued')`).run(threadId, id);
+    }
+    /**
+     * A session received the message. If a reply beat the row, the row opens already
+     * closed. Idempotent: a later copy reaching a session leaves the clock running.
+     * Returns true when the clock started.
+     */
+    openWatch(id, input) {
+        const r = this.db.prepare(`SELECT status, replied_before_open FROM a2a_ack_watch WHERE id = ?`).get(id);
+        if (!r)
+            return false;
+        if (r.status === 'open') {
+            // The spawn manager's callback got here first; the router's report knows the
+            // thread it resolved and, on the injected path, the session.
+            this.db.prepare(`UPDATE a2a_ack_watch SET thread_id = COALESCE(?, thread_id), session_name = COALESCE(session_name, ?) WHERE id = ?`)
+                .run(input.threadId ?? null, input.sessionName, id);
+            return false;
+        }
+        if (r.status === 'closed') {
+            this.db.prepare(`UPDATE a2a_ack_watch SET handed_off = 1 WHERE id = ?`).run(id);
+            return false;
+        }
+        if (r.replied_before_open === 1) {
+            this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', handed_off = 1, closed_at = ?, close_reason = 'replied', session_name = ?, launch_lane = ?, thread_id = COALESCE(?, thread_id) WHERE id = ?`).run(input.at, input.sessionName, input.lane, input.threadId ?? null, id);
+            return false;
+        }
+        this.db.prepare(`UPDATE a2a_ack_watch SET status = 'open', handed_off = 1, opened_at = ?, session_name = ?, launch_lane = ?, thread_id = COALESCE(?, thread_id) WHERE id = ?`).run(input.at, input.sessionName, input.lane, input.threadId ?? null, id);
+        return true;
+    }
+    closeWatch(id, reason, at) {
+        this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = ? WHERE id = ? AND status != 'closed'`).run(at, reason, id);
+    }
+    /** One queued copy died. Returns true when no copy is left and none reached a session. */
+    dropCopy(id) {
+        const r = this.db.prepare(`SELECT status, copies, handed_off FROM a2a_ack_watch WHERE id = ?`).get(id);
+        if (!r || r.status !== 'queued' || r.handed_off === 1)
+            return false;
+        const left = Math.max(0, r.copies - 1);
+        this.db.prepare(`UPDATE a2a_ack_watch SET copies = ? WHERE id = ?`).run(left, id);
+        return left === 0;
+    }
+    /**
+     * A session-authored send was accepted on this thread to this peer. Closes open
+     * rows; a row not yet open remembers the reply, and opens already closed.
+     */
+    closeOnReply(peerFp, threadId, at) {
+        const closed = this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = 'replied'
+       WHERE row_kind = 'watch' AND peer_fp = ? AND thread_id = ? AND status = 'open'`).run(at, peerFp, threadId);
+        this.db.prepare(`UPDATE a2a_ack_watch SET replied_before_open = 1
+       WHERE row_kind = 'watch' AND peer_fp = ? AND thread_id = ? AND status IN ('prepared','queued')`).run(peerFp, threadId);
+        return closed.changes;
+    }
+    /** Open watches, oldest first. Bounded by the partial index. */
+    openWatches(limit = 500) {
+        return this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE status = 'open' AND row_kind = 'watch' ORDER BY opened_at ASC LIMIT ?`).all(limit).map(toWatch);
+    }
+    markReminded(ids, at) {
+        const stmt = this.db.prepare(`UPDATE a2a_ack_watch SET reminded_at = ? WHERE id = ?`);
+        this.db.transaction(() => { for (const id of ids)
+            stmt.run(at, id); })();
+    }
+    /** Reminder events (not rows: a burst shares one timestamp) sent to sessions about this peer since `sinceIso`. */
+    remindersSince(peerFp, sinceIso) {
+        const r = this.db.prepare(`SELECT COUNT(DISTINCT reminded_at) AS n FROM a2a_ack_watch WHERE row_kind = 'watch' AND peer_fp = ? AND reminded_at IS NOT NULL AND reminded_at >= ?`).get(peerFp, sinceIso);
+        return r.n;
+    }
+    /** Rows a restart interrupted: the server had a message that never finished its hand-off. */
+    interruptedWatches(limit = 500) {
+        return this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE row_kind = 'watch' AND status IN ('prepared','queued') ORDER BY created_at ASC LIMIT ?`).all(limit).map(toWatch);
+    }
+    // ── Pending kinded acks ───────────────────────────────────────────
+    /** Durably queue a kinded ack the sender must hear. Idempotent per (peer, message, kind, state). */
+    addPending(input) {
+        const existing = this.db.prepare(`SELECT id FROM a2a_ack_watch WHERE row_kind = 'pending' AND status = 'pending' AND peer_fp = ? AND message_id = ? AND ack_kind = ? AND COALESCE(ack_state,'') = COALESCE(?,'')`).get(input.peerFp, input.messageId, input.ackKind, input.ackState);
+        if (existing)
+            return existing.id;
+        const info = this.db.prepare(`INSERT INTO a2a_ack_watch (row_kind, status, peer_fp, message_id, thread_id, trigger_encrypted, created_at, ack_kind, ack_state, ack_reason, summary, next_attempt_at, expires_at)
+       VALUES ('pending', 'pending', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(input.peerFp, input.messageId, input.threadId, input.triggerEncrypted ? 1 : 0, input.at, input.ackKind, input.ackState, input.ackReason, input.summary ?? null, input.at, input.expiresAt);
+        return Number(info.lastInsertRowid);
+    }
+    /** A `read` write and the watch close, as one step: a limit or a crash cannot lose both. */
+    acceptRead(input) {
+        return this.db.transaction(() => {
+            const id = this.addPending({
+                peerFp: input.watch.peerFp, messageId: input.watch.messageId, threadId: input.watch.threadId,
+                ackKind: 'read', ackState: null, ackReason: null, summary: input.summary,
+                triggerEncrypted: input.watch.triggerEncrypted, at: input.at, expiresAt: input.expiresAt,
+            });
+            this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = 'acknowledged' WHERE id = ?`).run(input.at, input.watch.id);
+            return id;
+        })();
+    }
+    duePending(nowIsoStr, limit = 200) {
+        return this.db.prepare(`SELECT * FROM a2a_ack_watch WHERE status = 'pending' AND row_kind = 'pending' AND next_attempt_at <= ? ORDER BY next_attempt_at ASC LIMIT ?`).all(nowIsoStr, limit).map(toPending);
+    }
+    /** Pending rows past their hour close as expired, counted on the health read. */
+    expirePending(nowIsoStr) {
+        return this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = 'expired' WHERE status = 'pending' AND row_kind = 'pending' AND expires_at <= ?`).run(nowIsoStr, nowIsoStr).changes;
+    }
+    markPendingSent(ids, at) {
+        const stmt = this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = 'sent', sent_at = ? WHERE id = ?`);
+        this.db.transaction(() => { for (const id of ids)
+            stmt.run(at, at, id); })();
+    }
+    closePending(ids, reason, at) {
+        const stmt = this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = ? WHERE id = ?`);
+        this.db.transaction(() => { for (const id of ids)
+            stmt.run(at, reason, id); })();
+    }
+    markPendingRetry(ids, attempts, nextAttemptAt) {
+        const stmt = this.db.prepare(`UPDATE a2a_ack_watch SET attempts = ?, next_attempt_at = ? WHERE id = ?`);
+        this.db.transaction(() => { for (const id of ids)
+            stmt.run(attempts, nextAttemptAt, id); })();
+    }
+    /** A remote topic session has it: not watched, and health says so. */
+    markNotWatched(id, at) {
+        this.db.prepare(`UPDATE a2a_ack_watch SET status = 'closed', closed_at = ?, close_reason = 'remote-topic', handed_off = 1 WHERE id = ?`).run(at, id);
+    }
+    // ── Reads ─────────────────────────────────────────────────────────
+    peerCounts(peerFp) {
+        const rows = this.db.prepare(`SELECT row_kind, status, close_reason, ack_state, COUNT(*) AS n FROM a2a_ack_watch WHERE peer_fp = ? GROUP BY row_kind, status, close_reason, ack_state`).all(peerFp);
+        const out = { unacknowledged: 0, pendingExpired: 0, pending: 0, notWatchedRemoteTopic: 0, openWatches: 0 };
+        for (const r of rows) {
+            if (r.row_kind === 'watch' && r.status === 'closed' && r.close_reason === 'unacknowledged')
+                out.unacknowledged += r.n;
+            else if (r.row_kind === 'watch' && r.status === 'closed' && r.close_reason === 'remote-topic')
+                out.notWatchedRemoteTopic += r.n;
+            else if (r.row_kind === 'watch' && r.status === 'open')
+                out.openWatches += r.n;
+            else if (r.row_kind === 'pending' && r.status === 'pending')
+                out.pending += r.n;
+            else if (r.row_kind === 'pending' && r.close_reason === 'expired')
+                out.pendingExpired += r.n;
+        }
+        return out;
+    }
+    /** Retention: closed rows older than 14 days. Bounded per sweep. */
+    sweep(nowMs) {
+        const cutoff = new Date(nowMs - WATCH_RETENTION_MS).toISOString();
+        return this.db.prepare(`DELETE FROM a2a_ack_watch WHERE id IN (SELECT id FROM a2a_ack_watch WHERE status = 'closed' AND closed_at < ? LIMIT ${SWEEP_LIMIT})`).run(cutoff).changes;
+    }
+}
+//# sourceMappingURL=requiredAckStore.js.map

package/dist/threadline/requiredAckStore.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.1661",
+  "version": "1.3.1663",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",