@animalabs/agent-framework 0.22.2 → 0.22.3

package/dist/src/prose-drafts.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Held prose drafts: a resident's plain speech that was not sent.
+ *
+ * Plain speech is held back for reasons that are right in themselves: an
+ * explicit send in the same round suppresses the round's prose (so a "sent
+ * it" postscript is not posted twice), a turn may have no destination, and a
+ * malformed or unresolvable routing prefix bounces. Before drafts, the held words were
+ * kept only as a count (or, in explicit mode, as one in-memory latest-wins
+ * clipboard): the law was right, and the penalty was amnesia. A draft keeps
+ * the exact words until the resident resends or dismisses them, or the
+ * retention below lets it go.
+ *
+ * The boundary is publication and agency, not visibility: a draft is never
+ * published except by its resident's explicit resend (or `{{unsent}}`), and
+ * only that resident can list or act on it. Its notices go into the
+ * resident's own history — which residents that share one message slot
+ * (#197) share, as they already share the assistant turn the words came
+ * from.
+ *
+ * Durability is outside the conversation. Drafts live in a RecordJournal of
+ * typed Chronicle records, which do not follow branch switches: undo,
+ * rollback, suppression and branch moves never touch them. A draft written
+ * in a turn that is later undone stays usable (the words were genuinely
+ * written and held back), and a delivered draft stays delivered. The
+ * notices that name a draft are conversation, so they do follow the branch: a draft counts as
+ * named while a message naming it is on the current branch, and one a
+ * rollback or branch move has left unnamed is named again.
+ *
+ * Drafts are kept, not hoarded. Each resident's KEEP_NEWEST newest drafts
+ * are always kept; an older one, in any state, is let go at the journal's
+ * next checkpoint once nothing has happened to it (held, named, attempted,
+ * answered, dismissed) for KEEP_IDLE_MS. The journal checkpoints what it
+ * keeps every CHECKPOINT_EVERY entries, so opening it replays only what came
+ * after, and a resident whose drafts change rarely keeps its older ones
+ * until then. The words stay in the resident's history either way.
+ *
+ * A delivery attempt is journaled durably BEFORE its request leaves the
+ * host, and its outcome after: an attempt with no recorded outcome (a crash
+ * mid-send) reads as unknown, never as unsent. A delivered draft carries a
+ * historical receipt — confirmed at a time, to a destination, with the
+ * connector's message id when it names one — not a claim that the message
+ * still exists. A draft is sent only by its resident's explicit resend or
+ * an envelope's {{unsent}}; nothing replays at boot or on a branch move.
+ */
+import type { JsStore } from '@animalabs/chronicle';
+import type { PublishDestination, PublishOutcome } from './mcpl/channel-registry.js';
+/** Chronicle record type of the drafts journal. */
+export declare const PROSE_DRAFT_RECORD_TYPE = "framework/prose-draft";
+/** Why words were held instead of sent. */
+export type DraftReason = 
+/** An explicit send in the same round suppressed the round's plain speech. */
+'explicit-send'
+/** The speech had no destination (no route this turn, or a failed envelope). */
+ | 'no-destination'
+/** An explicit/hybrid routing prefix was missing, malformed or unresolvable. */
+ | 'bounced';
+export interface DraftAttemptOutcome {
+    status: PublishOutcome['status'];
+    at: number;
+    messageId?: string;
+    reason?: string;
+    detail?: unknown;
+}
+export interface DraftAttempt {
+    attemptId: string;
+    at: number;
+    destination: PublishDestination;
+    /** How the words went out: the drafts tool, or a `{{unsent}}` envelope (explicit or hybrid). */
+    via: 'resend' | 'unsent-token';
+    /** The resident resent knowing an earlier attempt may have been posted. */
+    confirmedDuplicate?: true;
+    /** Absent until recorded; an attempt without one reads as unknown. */
+    outcome?: DraftAttemptOutcome;
+}
+/**
+ * A draft held with words copied from another draft that may already have
+ * been posted (`{{unsent}}` re-bounced while that draft was unconfirmed or in
+ * flight). The new draft keeps the whole authored text and carries the same
+ * duplication risk: it reads `unconfirmed` until a confirmed delivery.
+ */
+export interface InheritedRisk {
+    /** The draft whose words were copied in. */
+    draftId: string;
+    /** The draft whose attempt is the uncertain one, when the copied draft
+     *  itself carried inherited risk (a chain of re-bounces): the evidence is
+     *  that original attempt's, never re-invented. */
+    sourceDraftId?: string;
+    /** That uncertain attempt, when there was one (absent: it was in flight). */
+    destination?: PublishDestination;
+    at?: number;
+    reason: string;
+}
+export interface Draft {
+    id: string;
+    agent: string;
+    /** The held words, byte for byte as a resend publishes them: a run an
+     *  explicit send suppressed exactly as written; a bounce or a hold with no
+     *  destination, its envelope as routing read it (surrounding whitespace
+     *  trimmed). */
+    text: string;
+    reason: DraftReason;
+    /** Words copied in from a draft that may already have been posted. */
+    inheritedRisk?: InheritedRisk;
+    /** Short context for the resident: the bounce reason, or the competing conversations. */
+    note?: string;
+    heldAt: number;
+    attempts: DraftAttempt[];
+    dismissedAt?: number;
+    /** The messages whose notices named this draft, by id. It counts as named
+     *  while one of them is on the current branch. */
+    noticedIn?: string[];
+    /** When a notice last named it. */
+    noticedAt?: number;
+}
+/**
+ * - `held`: no inherited risk, and never attempted or every attempt
+ *   definitely failed — resend freely;
+ * - `unconfirmed`: no attempt was confirmed and the draft is not dismissed;
+ *   either an attempt's outcome is unknown (or was never recorded), or the
+ *   words carry inherited risk regardless of their own attempts. A resend
+ *   needs explicit confirmation. A later attempt that fails does not resolve
+ *   an earlier one that may have landed — the uncertainty stays;
+ * - `delivered`: an attempt was confirmed — its receipt is historical;
+ * - `dismissed`: the resident set it aside.
+ */
+export type DraftState = 'held' | 'unconfirmed' | 'delivered' | 'dismissed';
+export declare function draftState(draft: Draft): DraftState;
+/** The most recent attempt that may have been posted (unknown or unrecorded
+ *  outcome), when no attempt was confirmed. */
+export declare function uncertainAttempt(draft: Draft): DraftAttempt | undefined;
+/** Each resident's newest drafts, by hold order, that are always kept. */
+export declare const KEEP_NEWEST = 100;
+/** How long an older draft is kept after the last thing that happened to it. */
+export declare const KEEP_IDLE_MS: number;
+/** Entries the journal takes between checkpoints. */
+export declare const CHECKPOINT_EVERY = 500;
+/** The store's retention, KEEP_NEWEST, KEEP_IDLE_MS and CHECKPOINT_EVERY
+ *  unless given (tests give smaller ones). */
+export interface DraftRetention {
+    keepNewest: number;
+    keepIdleMs: number;
+    checkpointEvery: number;
+}
+export declare class ProseDraftStore {
+    private readonly journal;
+    /** agent → draft id → draft, in journal (hold) order. */
+    private drafts;
+    /** agent → the id of its latest bounce, kept or not. */
+    private latestBounces;
+    private readonly retention;
+    constructor(store: JsStore, retention?: Partial<DraftRetention>);
+    /** Rebuild the projection from the journal (at open, and to reconcile):
+     *  the latest checkpoint's drafts, then the entries after it. */
+    reload(): void;
+    /**
+     * Write a checkpoint once CHECKPOINT_EVERY entries have been appended since
+     * the last one, letting go of the drafts that aren't kept (see the module
+     * header). The projection drops them only once the checkpoint is written,
+     * so a failed one changes nothing, and the next write tries again.
+     */
+    private checkpointIfDue;
+    private reduce;
+    /**
+     * Journal and apply one entry. A write that fails after the store's append
+     * returned leaves the journal unreconciled: rebuild from it before
+     * rethrowing, so the projection never disagrees with what the journal
+     * holds. An append that fails inside the store can't be read back until
+     * the store is reopened: the journal then refuses every write until the
+     * next start, which replays that entry, so until then each write throws,
+     * no new draft is kept, and the projection lacks that entry.
+     */
+    private write;
+    private agentDrafts;
+    /** A new id, unique among the resident's kept drafts and never its latest
+     *  bounce's. One that retention let go can be given again: after N more
+     *  of its resident's drafts, a given let-go id has come back with a
+     *  probability of about N in 2.75 × 10^10 (ID_LENGTH), and a request naming
+     *  it then reaches the newer draft rather than being refused. */
+    private newId;
+    /**
+     * Hold words as drafts, in order, each journaled durably before this
+     * returns. If the journal refuses a write (after reconciling), the drafts
+     * already written stand and the rest are reported as not held: their words
+     * remain in the resident's history only. A draft whose record reached the
+     * store before its write failed (its sync did) is in the reconciled
+     * journal, so it is held, and counted so. When the store's append itself
+     * threw, the record may still be in its log: the draft is reported as not
+     * held, and the journal refuses further writes until a reload, which
+     * replays it as held if it is there.
+     */
+    hold(agent: string, segments: Array<{
+        text: string;
+        note?: string;
+        inheritedRisk?: InheritedRisk;
+    }>, reason: DraftReason, note?: string): {
+        held: Draft[];
+        notHeld?: {
+            count: number;
+            error: string;
+        };
+    };
+    get(agent: string, id: string): Draft | undefined;
+    /** Held and unconfirmed drafts, newest first (journal order, which is
+     *  exact even for segments held in the same millisecond). */
+    open(agent: string): Draft[];
+    /**
+     * Open drafts, newest first, that no notice on the current branch names:
+     * none was recorded (a crash before the notice), or a rollback or branch
+     * move took away every message that named them. `onBranch` says whether a
+     * message, by id, is on the current branch.
+     */
+    unnoticed(agent: string, onBranch: (messageId: string) => boolean): Draft[];
+    /**
+     * Record that message `messageId`, a notice naming these drafts, is in the
+     * resident's history. The notice is conversation state, buffered until the
+     * store syncs, while this record reaches the OS at once: so the store is
+     * synced FIRST (afterCommittedState), and a notice that never became
+     * durable can't leave a record that suppresses the crash catch-up.
+     */
+    markNoticed(agent: string, ids: string[], messageId: string): void;
+    dismiss(agent: string, id: string): void;
+    /**
+     * Journal a delivery attempt durably, BEFORE the request leaves the host.
+     * Throws (having reconciled) when it cannot be made durable: the caller
+     * must then not send.
+     */
+    beginAttempt(agent: string, id: string, destination: PublishDestination, via: DraftAttempt['via'], confirmedDuplicate: boolean): string;
+    /** Journal what an attempt established. */
+    recordOutcome(agent: string, id: string, attemptId: string, outcome: PublishOutcome): void;
+    /**
+     * Explicit and hybrid mode's `{{unsent}}`: the most recent bounce, while
+     * that draft is still open (held or unconfirmed — the caller must not
+     * resend an unconfirmed one without the resident's confirmation).
+     * Latest-wins, like the clipboard it replaces: once the latest bounce is
+     * delivered, dismissed or let go there is nothing to substitute, even if
+     * older bounces are still held (they stay in the collection, by id).
+     */
+    latestBounce(agent: string): Draft | undefined;
+}
+//# sourceMappingURL=prose-drafts.d.ts.map

package/dist/src/prose-drafts.d.ts.map

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

package/dist/src/prose-drafts.js

@@ -0,0 +1,362 @@
+/**
+ * Held prose drafts: a resident's plain speech that was not sent.
+ *
+ * Plain speech is held back for reasons that are right in themselves: an
+ * explicit send in the same round suppresses the round's prose (so a "sent
+ * it" postscript is not posted twice), a turn may have no destination, and a
+ * malformed or unresolvable routing prefix bounces. Before drafts, the held words were
+ * kept only as a count (or, in explicit mode, as one in-memory latest-wins
+ * clipboard): the law was right, and the penalty was amnesia. A draft keeps
+ * the exact words until the resident resends or dismisses them, or the
+ * retention below lets it go.
+ *
+ * The boundary is publication and agency, not visibility: a draft is never
+ * published except by its resident's explicit resend (or `{{unsent}}`), and
+ * only that resident can list or act on it. Its notices go into the
+ * resident's own history — which residents that share one message slot
+ * (#197) share, as they already share the assistant turn the words came
+ * from.
+ *
+ * Durability is outside the conversation. Drafts live in a RecordJournal of
+ * typed Chronicle records, which do not follow branch switches: undo,
+ * rollback, suppression and branch moves never touch them. A draft written
+ * in a turn that is later undone stays usable (the words were genuinely
+ * written and held back), and a delivered draft stays delivered. The
+ * notices that name a draft are conversation, so they do follow the branch: a draft counts as
+ * named while a message naming it is on the current branch, and one a
+ * rollback or branch move has left unnamed is named again.
+ *
+ * Drafts are kept, not hoarded. Each resident's KEEP_NEWEST newest drafts
+ * are always kept; an older one, in any state, is let go at the journal's
+ * next checkpoint once nothing has happened to it (held, named, attempted,
+ * answered, dismissed) for KEEP_IDLE_MS. The journal checkpoints what it
+ * keeps every CHECKPOINT_EVERY entries, so opening it replays only what came
+ * after, and a resident whose drafts change rarely keeps its older ones
+ * until then. The words stay in the resident's history either way.
+ *
+ * A delivery attempt is journaled durably BEFORE its request leaves the
+ * host, and its outcome after: an attempt with no recorded outcome (a crash
+ * mid-send) reads as unknown, never as unsent. A delivered draft carries a
+ * historical receipt — confirmed at a time, to a destination, with the
+ * connector's message id when it names one — not a claim that the message
+ * still exists. A draft is sent only by its resident's explicit resend or
+ * an envelope's {{unsent}}; nothing replays at boot or on a branch move.
+ */
+import { randomInt } from 'node:crypto';
+import { RecordJournal } from './record-journal.js';
+/** Chronicle record type of the drafts journal. */
+export const PROSE_DRAFT_RECORD_TYPE = 'framework/prose-draft';
+export function draftState(draft) {
+    if (draft.attempts.some((a) => a.outcome?.status === 'delivered'))
+        return 'delivered';
+    if (draft.dismissedAt !== undefined)
+        return 'dismissed';
+    return uncertainAttempt(draft) || draft.inheritedRisk ? 'unconfirmed' : 'held';
+}
+/** The most recent attempt that may have been posted (unknown or unrecorded
+ *  outcome), when no attempt was confirmed. */
+export function uncertainAttempt(draft) {
+    if (draft.attempts.some((a) => a.outcome?.status === 'delivered'))
+        return undefined;
+    for (let i = draft.attempts.length - 1; i >= 0; i--) {
+        const attempt = draft.attempts[i];
+        if (!attempt.outcome || attempt.outcome.status === 'unknown')
+            return attempt;
+    }
+    return undefined;
+}
+/** Unambiguous lowercase alphabet for short ids (no i/l/o/0/1). */
+const ID_ALPHABET = 'abcdefghjkmnpqrstuvwxyz23456789';
+/**
+ * Characters after `d-` in a draft's id: 31^7, about 2.75 × 10^10 ids, so a
+ * mistyped id almost never names a real draft, and an id retention let go is
+ * given again only rarely (see newId).
+ */
+const ID_LENGTH = 7;
+/** Each resident's newest drafts, by hold order, that are always kept. */
+export const KEEP_NEWEST = 100;
+/** How long an older draft is kept after the last thing that happened to it. */
+export const KEEP_IDLE_MS = 7 * 24 * 60 * 60 * 1000;
+/** Entries the journal takes between checkpoints. */
+export const CHECKPOINT_EVERY = 500;
+/** The last time anything happened to a draft: held, named, attempted,
+ *  answered or dismissed. */
+function lastActivity(draft) {
+    let last = Math.max(draft.heldAt, draft.noticedAt ?? 0, draft.dismissedAt ?? 0);
+    for (const attempt of draft.attempts)
+        last = Math.max(last, attempt.at, attempt.outcome?.at ?? 0);
+    return last;
+}
+export class ProseDraftStore {
+    journal;
+    /** agent → draft id → draft, in journal (hold) order. */
+    drafts = new Map();
+    /** agent → the id of its latest bounce, kept or not. */
+    latestBounces = new Map();
+    retention;
+    constructor(store, retention = {}) {
+        this.journal = new RecordJournal(store, { type: PROSE_DRAFT_RECORD_TYPE });
+        this.retention = {
+            keepNewest: retention.keepNewest ?? KEEP_NEWEST,
+            keepIdleMs: retention.keepIdleMs ?? KEEP_IDLE_MS,
+            checkpointEvery: retention.checkpointEvery ?? CHECKPOINT_EVERY,
+        };
+        this.reload();
+        this.checkpointIfDue();
+    }
+    /** Rebuild the projection from the journal (at open, and to reconcile):
+     *  the latest checkpoint's drafts, then the entries after it. */
+    reload() {
+        const { snapshot, entries } = this.journal.load();
+        this.drafts = new Map();
+        this.latestBounces = new Map(Object.entries(snapshot?.latestBounces ?? {}));
+        for (const draft of snapshot?.drafts ?? [])
+            this.agentDrafts(draft.agent).set(draft.id, draft);
+        for (const { entry } of entries)
+            this.reduce(entry);
+    }
+    /**
+     * Write a checkpoint once CHECKPOINT_EVERY entries have been appended since
+     * the last one, letting go of the drafts that aren't kept (see the module
+     * header). The projection drops them only once the checkpoint is written,
+     * so a failed one changes nothing, and the next write tries again.
+     */
+    checkpointIfDue() {
+        const { keepNewest, keepIdleMs, checkpointEvery } = this.retention;
+        if (this.journal.entriesSinceCheckpoint < checkpointEvery)
+            return;
+        const now = Date.now();
+        const kept = new Map();
+        for (const [agent, drafts] of this.drafts) {
+            const all = [...drafts.values()];
+            const keep = new Map();
+            all.forEach((draft, i) => {
+                if (i >= all.length - keepNewest || now - lastActivity(draft) < keepIdleMs)
+                    keep.set(draft.id, draft);
+            });
+            if (keep.size > 0)
+                kept.set(agent, keep);
+        }
+        const snapshot = {
+            v: 1,
+            drafts: [...kept.values()].flatMap((m) => [...m.values()]),
+            latestBounces: Object.fromEntries(this.latestBounces),
+        };
+        try {
+            this.journal.checkpoint(snapshot);
+        }
+        catch (err) {
+            console.error('[drafts] checkpoint failed; the next write tries again:', err);
+            if (this.journal.needsReconcile)
+                this.reload();
+            return;
+        }
+        this.drafts = kept;
+    }
+    reduce(entry) {
+        if (entry.op === 'held') {
+            this.agentDrafts(entry.draft.agent).set(entry.draft.id, { ...entry.draft, attempts: [] });
+            if (entry.draft.reason === 'bounced')
+                this.latestBounces.set(entry.draft.agent, entry.draft.id);
+            return;
+        }
+        if (entry.op === 'noticed') {
+            if (entry.messageId === undefined)
+                return;
+            for (const id of entry.ids) {
+                const draft = this.drafts.get(entry.agent)?.get(id);
+                if (!draft)
+                    continue;
+                draft.noticedIn ??= [];
+                if (!draft.noticedIn.includes(entry.messageId))
+                    draft.noticedIn.push(entry.messageId);
+                draft.noticedAt = Math.max(draft.noticedAt ?? 0, entry.at);
+            }
+            return;
+        }
+        const draft = this.drafts.get(entry.agent)?.get(entry.id);
+        if (!draft)
+            return;
+        if (entry.op === 'dismissed') {
+            draft.dismissedAt ??= entry.at;
+        }
+        else if (entry.op === 'attempt') {
+            draft.attempts.push({
+                attemptId: entry.attemptId,
+                at: entry.at,
+                destination: entry.destination,
+                via: entry.via,
+                ...(entry.confirmedDuplicate ? { confirmedDuplicate: true } : {}),
+            });
+        }
+        else if (entry.op === 'outcome') {
+            const attempt = draft.attempts.find((a) => a.attemptId === entry.attemptId);
+            if (attempt)
+                attempt.outcome = entry.outcome;
+        }
+    }
+    /**
+     * Journal and apply one entry. A write that fails after the store's append
+     * returned leaves the journal unreconciled: rebuild from it before
+     * rethrowing, so the projection never disagrees with what the journal
+     * holds. An append that fails inside the store can't be read back until
+     * the store is reopened: the journal then refuses every write until the
+     * next start, which replays that entry, so until then each write throws,
+     * no new draft is kept, and the projection lacks that entry.
+     */
+    write(entry, durable, afterCommittedState = false) {
+        try {
+            this.journal.append(entry, { durable, afterCommittedState });
+        }
+        catch (err) {
+            if (this.journal.needsReconcile)
+                this.reload();
+            throw err;
+        }
+        this.reduce(entry);
+        this.checkpointIfDue();
+    }
+    agentDrafts(agent) {
+        let map = this.drafts.get(agent);
+        if (!map) {
+            map = new Map();
+            this.drafts.set(agent, map);
+        }
+        return map;
+    }
+    /** A new id, unique among the resident's kept drafts and never its latest
+     *  bounce's. One that retention let go can be given again: after N more
+     *  of its resident's drafts, a given let-go id has come back with a
+     *  probability of about N in 2.75 × 10^10 (ID_LENGTH), and a request naming
+     *  it then reaches the newer draft rather than being refused. */
+    newId(agent) {
+        const existing = this.agentDrafts(agent);
+        const latestBounce = this.latestBounces.get(agent);
+        for (;;) {
+            let id = 'd-';
+            for (let i = 0; i < ID_LENGTH; i++)
+                id += ID_ALPHABET[randomInt(ID_ALPHABET.length)];
+            if (!existing.has(id) && id !== latestBounce)
+                return id;
+        }
+    }
+    /**
+     * Hold words as drafts, in order, each journaled durably before this
+     * returns. If the journal refuses a write (after reconciling), the drafts
+     * already written stand and the rest are reported as not held: their words
+     * remain in the resident's history only. A draft whose record reached the
+     * store before its write failed (its sync did) is in the reconciled
+     * journal, so it is held, and counted so. When the store's append itself
+     * threw, the record may still be in its log: the draft is reported as not
+     * held, and the journal refuses further writes until a reload, which
+     * replays it as held if it is there.
+     */
+    hold(agent, segments, reason, note) {
+        const held = [];
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i];
+            const segmentNote = segment.note ?? note;
+            const draft = {
+                id: this.newId(agent),
+                agent,
+                text: segment.text,
+                reason,
+                ...(segmentNote ? { note: segmentNote } : {}),
+                ...(segment.inheritedRisk ? { inheritedRisk: segment.inheritedRisk } : {}),
+                heldAt: Date.now(),
+            };
+            try {
+                this.write({ op: 'held', draft }, true);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err.message : String(err);
+                const landed = this.get(agent, draft.id);
+                if (landed) {
+                    console.error(`[drafts] ${agent}: ${landed.id} reached the journal, but its write then failed (${error}); it is held`);
+                    held.push(landed);
+                }
+                const count = segments.length - i - (landed ? 1 : 0);
+                return { held, ...(count > 0 ? { notHeld: { count, error } } : {}) };
+            }
+            held.push(this.get(agent, draft.id));
+        }
+        return { held };
+    }
+    get(agent, id) {
+        return this.drafts.get(agent)?.get(id);
+    }
+    /** Held and unconfirmed drafts, newest first (journal order, which is
+     *  exact even for segments held in the same millisecond). */
+    open(agent) {
+        return [...(this.drafts.get(agent)?.values() ?? [])]
+            .filter((d) => { const s = draftState(d); return s === 'held' || s === 'unconfirmed'; })
+            .reverse();
+    }
+    /**
+     * Open drafts, newest first, that no notice on the current branch names:
+     * none was recorded (a crash before the notice), or a rollback or branch
+     * move took away every message that named them. `onBranch` says whether a
+     * message, by id, is on the current branch.
+     */
+    unnoticed(agent, onBranch) {
+        return this.open(agent).filter((d) => !d.noticedIn?.some(onBranch));
+    }
+    /**
+     * Record that message `messageId`, a notice naming these drafts, is in the
+     * resident's history. The notice is conversation state, buffered until the
+     * store syncs, while this record reaches the OS at once: so the store is
+     * synced FIRST (afterCommittedState), and a notice that never became
+     * durable can't leave a record that suppresses the crash catch-up.
+     */
+    markNoticed(agent, ids, messageId) {
+        if (ids.length === 0)
+            return;
+        this.write({ op: 'noticed', agent, ids, at: Date.now(), messageId }, true, true);
+    }
+    dismiss(agent, id) {
+        this.write({ op: 'dismissed', agent, id, at: Date.now() }, true);
+    }
+    /**
+     * Journal a delivery attempt durably, BEFORE the request leaves the host.
+     * Throws (having reconciled) when it cannot be made durable: the caller
+     * must then not send.
+     */
+    beginAttempt(agent, id, destination, via, confirmedDuplicate) {
+        const attemptId = `a-${Date.now().toString(36)}-${randomInt(36 ** 4).toString(36)}`;
+        this.write({
+            op: 'attempt', agent, id, attemptId, at: Date.now(), destination, via,
+            ...(confirmedDuplicate ? { confirmedDuplicate: true } : {}),
+        }, true);
+        return attemptId;
+    }
+    /** Journal what an attempt established. */
+    recordOutcome(agent, id, attemptId, outcome) {
+        this.write({
+            op: 'outcome', agent, id, attemptId,
+            outcome: {
+                status: outcome.status,
+                at: outcome.at,
+                ...(outcome.messageId ? { messageId: outcome.messageId } : {}),
+                ...(outcome.reason ? { reason: outcome.reason } : {}),
+                ...(outcome.detail !== undefined ? { detail: outcome.detail } : {}),
+            },
+        }, true);
+    }
+    /**
+     * Explicit and hybrid mode's `{{unsent}}`: the most recent bounce, while
+     * that draft is still open (held or unconfirmed — the caller must not
+     * resend an unconfirmed one without the resident's confirmation).
+     * Latest-wins, like the clipboard it replaces: once the latest bounce is
+     * delivered, dismissed or let go there is nothing to substitute, even if
+     * older bounces are still held (they stay in the collection, by id).
+     */
+    latestBounce(agent) {
+        const id = this.latestBounces.get(agent);
+        const latest = id === undefined ? undefined : this.get(agent, id);
+        if (!latest)
+            return undefined;
+        const state = draftState(latest);
+        return state === 'held' || state === 'unconfirmed' ? latest : undefined;
+    }
+}
+//# sourceMappingURL=prose-drafts.js.map

package/dist/src/prose-drafts.js.map

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

package/dist/src/prose-segments.d.ts

@@ -10,9 +10,28 @@
  * collapsing those distinct messages into one (item 4). This helper instead
  * yields each contiguous run of text — the segments a surface should deliver as
  * separate, ordered messages. Contiguous text blocks merge into one segment;
- * `tool_use` / `tool_result` blocks are segment boundaries; empty or
+ * `tool_use` / `tool_result` blocks are segment boundaries, as are XML tool
+ * mode's `tool_attempt` / `tool_notice` (a refused attempt and the harness's
+ * notice end a round just as a call and its results do); empty or
  * whitespace-only runs are dropped.
  */
 import type { ContentBlock } from '@animalabs/membrane';
-export declare function splitProseSegments(content: readonly ContentBlock[]): string[];
+/**
+ * The runs exactly as written: contiguous text blocks joined with a newline,
+ * nothing trimmed. Whitespace-only runs are dropped. Held drafts keep these,
+ * so a draft's words (indentation included) are the resident's own, byte for
+ * byte; speech routes each run trimmed of surrounding whitespace.
+ */
+export declare function splitProseRuns(content: readonly ContentBlock[]): string[];
+/**
+ * A turn's content without the prose of some of its tool rounds, the turn's
+ * rounds counted from 0 in order. A round's prose is its text
+ * before its calls, and a round starts at the first block after the previous
+ * round's `tool_result` blocks. So a round with no prose still counts, two
+ * calls of one round (their `tool_use` blocks come before any result) stay
+ * one round, and a round is found by its place, whatever its text holds.
+ * Other rounds' text, every non-text block and the text after the last round
+ * stay.
+ */
+export declare function withoutRoundsProse(content: readonly ContentBlock[], rounds: ReadonlySet<number>): ContentBlock[];
 //# sourceMappingURL=prose-segments.d.ts.map