@animalabs/agent-framework 0.32.0 → 0.34.0

package/dist/src/tune-out/window-anchor.js

@@ -0,0 +1,202 @@
+/** The subconscious's window start, set by sequence in legacy mode and by a fixed ordinal once its window is presented. */
+export class SubconsciousWindowAnchor {
+    host;
+    /**
+     * The starts whose ordinal isn't set and kept yet, the one in force
+     * (`inForce`) first if it is among them: some row older than a start is
+     * still out of the window, or setting or keeping the ordinal it was fixed
+     * at (`ordinal`) failed, which the next presentation tries again. A start
+     * set by an ordinal already known (`known`) waits only for its setting and
+     * keeping: kept for `keep` (none for a start in force only) and as the
+     * start in force, traced when clamped (`clampedFrom`, the ordinal kept
+     * before).
+     */
+    pending = [];
+    constructor(host) {
+        this.host = host;
+    }
+    /**
+     * Set the window start (the coordinator's setSubconsciousAnchor). In
+     * legacy mode by its sequence, as before the index. In presented mode by
+     * its ordinal when one was fixed, clamped to the window's index length
+     * and traced when past it, the clamped ordinal kept as the start; the
+     * strategy's persisted anchor where it is earlier, or, with no ordinal
+     * known, where it has one, at a resume that asks for it
+     * (keepEarlierAnchor); else by its sequence for now, converted as
+     * the strategy converts one, and the ordinal is fixed (see the module
+     * doc) as soon as no row the subconscious is owed stored before the start
+     * is out of its window, now or at a later presentation (presented). An
+     * ordinal set is kept as the start in force once it is set, and tried
+     * again at the next presentation until both succeed. The starts of
+     * `others`, the other active tune-outs' whose ordinal isn't kept yet, are
+     * fixed the same way, without moving the window to them. Never throws: a
+     * set that fails is logged, and the anchor stays where it was.
+     */
+    set(start, others = []) {
+        try {
+            const strategy = this.host.strategy();
+            if (!strategy)
+                return;
+            if (!this.host.presents()) {
+                this.pending = [];
+                strategy.setAnchor(start.sequence);
+                return;
+            }
+            const was = this.pending;
+            const carried = (wanted, inForce) => ({
+                ...(was.find((p) => !p.known && sameStart(p.start, wanted)) ?? { start: wanted }),
+                inForce,
+            });
+            this.pending = others.map((other) => carried(other, false));
+            let known = start.ordinal;
+            let inForceOnly = start.inForceOnly === true;
+            if (start.keepEarlierAnchor) {
+                const persisted = persistedOrdinal(strategy);
+                if (persisted === null) {
+                    // Whether the strategy holds an earlier start (a cancelled
+                    // tune-out's, set and never kept) can't be told: the kept one set
+                    // over it would drop the rows it held from the window, and be kept
+                    // in force. The window stays where it was, nothing set or kept in
+                    // force; the next enter or restart sets it. The others are fixed,
+                    // and so is the start itself where no ordinal is kept for it,
+                    // without moving the window to it.
+                    if (known === undefined)
+                        this.pending.push(carried(start, false));
+                    this.tryFix();
+                    return;
+                }
+                // With no ordinal kept (one fixed and set whose keeping failed), the
+                // persisted anchor is the start this window had, wherever it is: the
+                // sequence converted again could give a later one, leaving out a
+                // row presented out of record order (AF #844 review 5, #47). The
+                // start's own ordinal is fixed beside it, unmoved to.
+                if (persisted !== undefined && (known === undefined || persisted < known)) {
+                    if (known === undefined)
+                        this.pending.push(carried(start, false));
+                    known = persisted;
+                    inForceOnly = true;
+                }
+            }
+            if (known !== undefined) {
+                const length = this.host.cm()?.indexLength() ?? 0;
+                const ordinal = Math.min(known, length);
+                this.pending.unshift({
+                    start,
+                    ordinal,
+                    inForce: true,
+                    known: { keep: inForceOnly ? [] : start.epochIds, ...(ordinal !== known ? { clampedFrom: known } : {}) },
+                });
+            }
+            else {
+                this.pending.unshift(carried(start, true));
+                strategy.setAnchor(start.sequence);
+            }
+            this.tryFix();
+        }
+        catch (error) {
+            console.error(`[tune-out] the subconscious's window start couldn't be set, so it stays where it was:`, error);
+        }
+    }
+    /**
+     * The store's branch moved (the framework's followBranchMove, before the
+     * agents follow it): an ordinal is a place on the branch it was fixed on,
+     * so a start pending at one (its setting or keeping failed), or set by one
+     * kept there (`known`), waits again to be fixed, from the window it
+     * presents on now, as a start never fixed does (tryFix): one for a
+     * tune-out still active (`active`, the coordinator's, where the framework
+     * says). One fixed for tune-outs none of which is active any more, and
+     * the start in force only (a cancelled tune-out's, set by its kept
+     * ordinal: fixed again, it would be the active one's start), are dropped,
+     * as every start fixed at an ordinal was before (AF #844 review 3, #30
+     * and #44): the anchor the destination's strategy keeps stands until the
+     * next enter or restart sets one.
+     */
+    branchMoved(active) {
+        const holds = active === undefined ? undefined : new Set(active);
+        this.pending = this.pending
+            .filter((p) => {
+            if (p.known && p.known.keep.length === 0)
+                return false;
+            const fixedThere = p.ordinal !== undefined || p.known !== undefined;
+            return !fixedThere || holds === undefined || p.start.epochIds.some((id) => holds.has(id));
+        })
+            .map((p) => ({ start: p.start, inForce: p.inForce }));
+    }
+    /** Rows entered the subconscious's window (the presentation index's onPresented): a start waiting to be fixed may be fixable now. */
+    presented() {
+        if (this.pending.length === 0)
+            return;
+        try {
+            this.tryFix();
+        }
+        catch (error) {
+            console.error(`[tune-out] the subconscious's window start couldn't be fixed at this presentation; the next one tries again:`, error);
+        }
+    }
+    /**
+     * Fix each pending start's ordinal, once no row owed and stored before it
+     * is out of the window, then set it (the start in force) and keep it;
+     * until both succeed a start stays pending at that ordinal. A start set by
+     * an ordinal known is set and kept the same way, and traced only when
+     * clamped.
+     */
+    tryFix() {
+        if (this.pending.length === 0 || !this.host.presents())
+            return;
+        const cm = this.host.cm();
+        const strategy = this.host.strategy();
+        if (!cm || !strategy)
+            return;
+        // Read once, and only for a start still to be fixed.
+        let owed;
+        for (const entry of [...this.pending]) {
+            if (entry.ordinal === undefined) {
+                owed ??= this.host.owed();
+                if (owed.some((row) => row.sequence < entry.start.sequence))
+                    continue;
+                // Just past the last row in the window stored before the start.
+                let ordinal = 0;
+                for (const row of cm.getPresentedMessages()) {
+                    if (row.sequence >= entry.start.sequence)
+                        continue;
+                    const at = cm.ordinalOf(row.id);
+                    if (at !== undefined && at + 1 > ordinal)
+                        ordinal = at + 1;
+                }
+                entry.ordinal = ordinal;
+            }
+            const ordinal = entry.ordinal;
+            if (entry.inForce)
+                strategy.setAnchorOrdinal(ordinal);
+            if (!this.host.fixed(entry.known ? entry.known.keep : entry.start.epochIds, ordinal, entry.inForce))
+                continue;
+            this.pending = this.pending.filter((p) => p !== entry);
+            if (!entry.known) {
+                this.host.emitTrace({
+                    type: 'tune-out:subconscious-window', agentName: this.host.agentName,
+                    epochIds: [...entry.start.epochIds], how: 'fixed', ordinal,
+                });
+            }
+            else if (entry.known.clampedFrom !== undefined) {
+                this.host.emitTrace({
+                    type: 'tune-out:subconscious-window', agentName: this.host.agentName,
+                    epochIds: [...entry.start.epochIds], how: 'clamped', ordinal, kept: entry.known.clampedFrom,
+                });
+            }
+        }
+    }
+}
+/** The anchor the strategy persisted, as an ordinal: undefined where it persisted none, null where it can't be read. */
+function persistedOrdinal(strategy) {
+    try {
+        return strategy.getAnchorOrdinal();
+    }
+    catch (error) {
+        console.error(`[tune-out] the subconscious's persisted window start couldn't be read, so the window start stays where it was; the next enter or restart sets it:`, error);
+        return null;
+    }
+}
+function sameStart(a, b) {
+    return a.sequence === b.sequence && a.epochIds.length === b.epochIds.length && a.epochIds.every((id) => b.epochIds.includes(id));
+}
+//# sourceMappingURL=window-anchor.js.map

package/dist/src/tune-out/window-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-anchor.js","sourceRoot":"","sources":["../../../src/tune-out/window-anchor.ts"],"names":[],"mappings":"AAoFA,2HAA2H;AAC3H,MAAM,OAAO,wBAAwB;IAkBN,IAAI;IAjBjC;;;;;;;;;OASG;IACK,OAAO,GAKV,EAAE,CAAC;IAER,YAA6B,IAAkC;oBAAlC,IAAI;IAAiC,CAAC;IAEnE;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,KAA8B,EAAE,MAAM,GAAuC,EAAE;QACjF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;gBAClB,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACnC,OAAO;YACT,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,MAAM,OAAO,GAAG,CAAC,MAA+B,EAAE,OAAgB,EAAE,EAAE,CAAC,CAAC;gBACtE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;gBACjF,OAAO;aACR,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC5D,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1B,IAAI,WAAW,GAAG,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC;YAC7C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACvB,2DAA2D;oBAC3D,kEAAkE;oBAClE,mEAAmE;oBACnE,kEAAkE;oBAClE,kEAAkE;oBAClE,8DAA8D;oBAC9D,mCAAmC;oBACnC,IAAI,KAAK,KAAK,SAAS;wBAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClE,IAAI,CAAC,MAAM,EAAE,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,qEAAqE;gBACrE,qEAAqE;gBACrE,iEAAiE;gBACjE,iEAAiE;gBACjE,sDAAsD;gBACtD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;oBAC1E,IAAI,KAAK,KAAK,SAAS;wBAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClE,KAAK,GAAG,SAAS,CAAC;oBAClB,WAAW,GAAG,IAAI,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;gBAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACxC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;oBACnB,KAAK;oBACL,OAAO;oBACP,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;iBACzG,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC3C,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uFAAuF,EAAE,KAAK,CAAC,CAAC;QAChH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,MAA0B;QACpC,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACZ,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YACvD,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;YACpE,OAAO,CAAC,UAAU,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,qIAAqI;IACrI,SAAS;QACP,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACtC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8GAA8G,EAAE,KAAK,CAAC,CAAC;QACvI,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM;QACZ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC7B,qDAAqD;QACrD,IAAI,IAA4D,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBACtE,gEAAgE;gBAChE,IAAI,OAAO,GAAG,CAAC,CAAC;gBAChB,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,oBAAoB,EAAE,EAAE,CAAC;oBAC5C,IAAI,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ;wBAAE,SAAS;oBACnD,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAChC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO;wBAAE,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC7D,CAAC;gBACD,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;YAC1B,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO;gBAAE,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;gBAAE,SAAS;YAC9G,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;oBAClB,IAAI,EAAE,8BAA8B,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;oBACpE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO;iBAC3D,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACjD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;oBAClB,IAAI,EAAE,8BAA8B,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;oBACpE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;iBAC5F,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,wHAAwH;AACxH,SAAS,gBAAgB,CAAC,QAA0B;IAClD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mJAAmJ,EAAE,KAAK,CAAC,CAAC;QAC1K,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,CAA0B,EAAE,CAA0B;IACvE,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACnI,CAAC"}

package/dist/src/types/agent.d.ts

@@ -200,11 +200,15 @@ export interface AgentConfig {
          * counts it. After a fold, each block after the stretch it rewrote is
          * bound to a conversation the request no longer holds. Where the context
          * strategy still sends such a block, the provider drops it on every call
-         * until a later fold takes it out of the context, and while such blocks
-         * are sent, no stream gives a sample and the calibration keeps the value
-         * it had. A strategy that leaves that thinking out at the fold sends none
-         * to drop. The direct API carries the control too, but reads no report: it
-         * traces no usage and feeds no calibration.
+         * until a later fold takes it out of the context, or, with `binds` set
+         * too, until the next compile after a note lands: the stream tells the
+         * context manager which stored reply's thinking was dropped
+         * (`noteThinkingDropped`), and once a note lands, the next compile sends
+         * that reply without it. While such blocks are sent,
+         * no stream gives a sample and the calibration keeps the value it had. A
+         * strategy that leaves that thinking out at the fold sends none to drop.
+         * The direct API carries the control too, but reads no report: it traces
+         * no usage, feeds no calibration and notes nothing.
          *
          * Default false: nothing is sent, and the account's default applies.
          */
@@ -228,6 +232,11 @@ export interface AgentConfig {
          *   thinking is kept at the next compile. The direct API
          *   (`runInference`) notes nothing, so each of its replies' thinking is
          *   left out at the compile after it's stored;
+         * - with `dropBlock` set too, each framework stream tells the context
+         *   manager which stored replies' thinking the provider reports dropping
+         *   (`noteThinkingDropped`), naming the compile it was built from, so
+         *   once a note lands, the next compile sends those replies without their
+         *   thinking;
          * - with `physicalWindowTokens` set too, `maxStreamTokens` no longer
          *   starts a new stream mid-turn, since the new stream's compile can take
          *   the turn's earlier reasoning out of the request;
@@ -307,8 +316,28 @@ export interface AgentConfig {
      * - 'disabled': generated prose is never published. Only explicit tools may
      *   send externally; prose remains in Chronicle, and a turn that wrote plain
      *   speech ends with a private `[delivered] plain speech → no channel` receipt.
+     * - 'locked': unprefixed prose goes to one destination the agent chose, on
+     *   every turn, and nothing moves it automatically: not the channel that
+     *   woke the turn, not an addressed message, a heartbeat or channel_open.
+     *   Only the `prose_locus` tool moves it, to a channel or to drafts (held,
+     *   never posted unless the agent resends them). The choice persists
+     *   across turns and restarts. Until the agent first makes one,
+     *   `proseLock` is the destination. It governs routing through the channel
+     *   registry: a module that handles final speech itself (`onAgentSpeech`,
+     *   such as the in-process Discord module) receives it in every mode, this
+     *   one included. See docs/locked-prose-routing.md.
      */
-    proseRouting?: 'locus' | 'explicit' | 'hybrid' | 'disabled';
+    proseRouting?: 'locus' | 'explicit' | 'hybrid' | 'disabled' | 'locked';
+    /**
+     * Locked mode's destination until the agent chooses one with `prose_locus`:
+     * `"#channel"`, `"@person"`, a channel id, or `"drafts"`. Resolved as a
+     * `>>` target is, at each turn's start, so a channel its server hasn't
+     * registered yet resolves once it has; until it resolves, plain speech is
+     * held as drafts. Left out, plain speech is held as drafts until the agent
+     * chooses. The agent's own choice, once made, takes its place. Ignored in
+     * the other modes.
+     */
+    proseLock?: string;
     /**
      * Stored participants that are this agent's own voice, in addition to its
      * name: their turns are presented to the model as this agent's assistant
@@ -395,6 +424,52 @@ export interface AgentConfig {
      *   view.
      */
     clock?: import('../clock-rows.js').ClockConfig;
+    /**
+     * Keep the rows that open a turn raw for the whole turn (on when left out):
+     * at a start that opens a turn, the framework pins raw the rows of the
+     * agent's window after its newest own message and its consumed mark
+     * (`pinRange`, named `agent-framework:turn-inputs`; the README says
+     * which rows exactly), and removes the pin when the turn ends, so the
+     * strategy doesn't compress the rows the turn opened with while it runs,
+     * unless a committing compile refuses as over budget with it held: the
+     * pin is then removed and the compile runs once more (README). `false` places no pin:
+     * the turn's opening rows are compressed as any others, and a pin of the
+     * name left from before (a crash's) is removed at the next start that opens
+     * a turn, as a silent start removes one.
+     */
+    turnInputsPin?: boolean;
+    /**
+     * The other configured agents whose own rows this agent's window takes
+     * (none when left out). Residents share one slot, and each is shown only
+     * its own rows and the rows meant for it: another resident's rounds,
+     * replies, tool results and notes stay out of its window (#291, decision
+     * 1; rows an earlier release stored carry no stamp and stay in the window
+     * written down from the record: 291-presentation-mandatory). A name here
+     * is an observe edge in this agent's registry record, on
+     * that agent (`{ agent: name }`, the path the subconscious's edge takes),
+     * and the presentation index presents that agent's own rows to this one
+     * at its points, as it does any arrival (bearingOf); the history tools
+     * leave them in for its calls (ModuleContext.observes). That agent's own
+     * rows this one's window doesn't hold yet, those stored before the edge
+     * was declared included, enter it at its next presentation point, after
+     * what it holds: an edge declared on a store with history hands the
+     * observer that agent's earlier rows at once, at the end of its window
+     * (`ObserveEdge.fromMessageId`, which would start the edge at a row, is
+     * read by nothing yet). Only own rows: mail and channel traffic meant for that agent, and its stored
+     * context injections, stay out. One way: `nova` observing `mira` shows
+     * nova mira's rows, not mira nova's. `create()` refuses a name that is
+     * this agent's own or no configured agent's. Read when a configured agent
+     * is created; a derived agent's spec carries its own edges.
+     */
+    observes?: string[];
+    /**
+     * How the rounds of an agent it observes (`observes`) go out in this
+     * agent's requests, as `PersistentReaderConfig.foreignRounds` for the
+     * persistent subconscious: `'transcript'` (the default), a line per tool
+     * call and per result and none of their thinking, or `'raw'`, as stored.
+     * Unread for an agent that observes no one.
+     */
+    foreignRounds?: 'transcript' | 'raw';
 }
 /** The intentionally small set of agent settings that may change in-process. */
 export interface AgentRuntimeSettingsPatch {
@@ -555,22 +630,19 @@ export interface InferenceRequest {
      *  all of them without materializing content, the turn has no cause left
      *  and does not run. */
     coalescingBatchSubjects?: string[];
-    /** Host-owned: this wake's sole cause is this write, deferred for its
-     *  agent while a turn was alive: a coalesced render placed in its queue
+    /** Host-owned: this wake's sole cause is this row, by the stored row's
+     *  id: one stored for its agent as it arrived, or one stored and not
+     *  presented to its agent at its write, because a turn of the agent's was
+     *  alive: a coalesced render its turn being assembled doesn't read
      *  (wakeToRead), or a message, notice or event whose wake was queued with
-     *  it. Once a request that carried the write was answered and, for a wake
-     *  that carries a channel and isn't marked `ambient`, the agent has since
-     *  published into that channel having read it, or once the write is in
-     *  neither the agent's queue nor its store's current branch, the wake
-     *  starts no turn. */
-    readsDeferredWrite?: string;
-    /** Host-owned: this wake's sole cause is this message, stored in its
-     *  agent's store as it arrived, not deferred (its row's id). Once a
-     *  request that carried the message was answered and, for a wake that
-     *  carries a channel and isn't marked `ambient`, the agent has since
-     *  published into that channel having read it, or once the message isn't
-     *  on its store's current branch, the wake starts no turn. */
-    readsStoredMessage?: string;
+     *  it. Once a request that carried the row was answered (an answered
+     *  request's consumed watermark covers it, in the agent's window once its
+     *  context presents rows) and, for a wake that carries a channel and isn't
+     *  marked `ambient`, the agent has since published into that channel
+     *  having read it, or once the row is not on its store's current branch,
+     *  the wake starts no turn. A row stored and not yet presented to the
+     *  agent keeps its wake. */
+    readsRow?: string;
     agentName: string;
     reason: string;
     source: string;
@@ -630,10 +702,9 @@ export interface InferenceRequest {
      * (`chat:ambient`). A coalesced push's wake carries it only to read a
      * render, and only when every notice the render stands for was. Such a
      * message asked nothing of the agent, so a wake for it that carries
-     * `readsDeferredWrite` or `readsStoredMessage` is dropped once a request
-     * that carried the message was answered, with no publish asked of the
-     * agent. A message with neither tag is in doubt, and is judged as an
-     * addressed one.
+     * `readsRow` is dropped once a request that carried the message
+     * was answered, with no publish asked of the agent. A message with neither
+     * tag is in doubt, and is judged as an addressed one.
      */
     ambient?: true;
     /**
@@ -664,6 +735,31 @@ export interface InferenceRequest {
      * channel (ambient-only batches leave it unset).
      */
     wakeChannelId?: string;
+    /**
+     * Framework-set on a gate wake whose batch held no message that addressed
+     * the agent, and which so took no route: the channels its messages came
+     * from (a `chat:system` notice names none, unless it's a coalesced
+     * render's latest occurrence), each once. A start merged from several
+     * requests carries every one's channels, or, when any of them comes from
+     * outside the framework, isn't a silent heartbeat tick and brought
+     * channels, only those requests' channels. A request a quiesce keeps in
+     * another's place, and one a provider hold takes another into, carry both
+     * requests' channels.
+     * The framework's own wakes that continue a
+     * turn (a restart, a re-inference, a continuation, a retry, a bounce, a
+     * re-arm), unless its own wake named a channel that resolves to none,
+     * carry the channels the turn's starts gathered, whether or not the turn
+     * had a locus, so a turn's trigger can name channels from several batches,
+     * and a turn they open with no locus can name them too.
+     * When such a turn's plain speech, or a sleep's announcement, is routed
+     * with no locus, the agent is told these channels, unless the turn's own
+     * wake named a channel that resolves to none, or the turn is an ephemeral
+     * run's, which is told nothing.
+     */
+    wakeChannels?: Array<{
+        serverId: string;
+        channelId: string;
+    }>;
     /** Timestamp of the event the wake provenance was taken from (ms). */
     wakeAt?: number;
     /** Batched-wake lines the gate handed to this wake rather than wrote

package/dist/src/types/agent.d.ts.map

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

package/dist/src/types/events.d.ts

@@ -315,6 +315,8 @@ export interface ToolCall {
  * Converted from wire-format McplContentBlock to membrane ContentBlock.
  */
 export interface McplPushEvent {
+    /** The occurrence's suppression, when a coalesced push's wake decided it (CoalescedOccurrence.suppressionDecision). */
+    suppressionDecision?: string | null;
     type: 'mcpl:push-event';
     serverId: string;
     featureSet: string;

package/dist/src/types/events.d.ts.map

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

package/dist/src/types/framework.d.ts

@@ -163,16 +163,14 @@ export interface FrameworkConfig {
      */
     subconscious?: import('../tune-out/tools.js').SubconsciousConfig;
     /**
-     * Tune-out without a reader (issue #232 §3.3). The hold machinery always
-     * runs when MCPL channels exist, so a persisted epoch is resumed and
-     * released whatever the configuration; this switch only decides whether
-     * residents are offered `tune_out` when no reader is configured. Without
-     * a reader a tune-out is a silent hold: no cadence, no wake budget,
-     * mentions are acknowledged, the backlog is released on cancel.
+     * Tune-out settings. Residents are offered `tune_out` only with a reader
+     * (`subconscious`), or while a hold a failed release left is still on
+     * record to check or cancel: a hold nothing summarizes would hand the resident an
+     * undated backlog all at once when it ends. `enabled`, which offered one
+     * without a reader, was removed in 0.33.0: `enabled: true` is refused at
+     * `create` (`false` is still accepted, from JavaScript, and does nothing).
      */
     tuneOut?: {
-        /** Offer `tune_out` without a subconscious. Default: only with one. */
-        enabled?: boolean;
         /**
          * Announce the all-except scope in the excepted channel: one bracketed
          * line under the resident's name when it opens (who, for how long) and
@@ -186,16 +184,23 @@ export interface FrameworkConfig {
      * (architecture channel, 2026-10-06: the §3 carve-out accepted by the
      * residents).
      *
-     * - `'delivery'` (default): the locus comes only from the delivery that
-     *   woke the turn, a conversation fork's home channel, or a channel the
-     *   agent opened during the turn. Incoming traffic never moves it — not
-     *   between turns, not mid-turn. A turn with no such locus keeps its
-     *   prose private, and says so in a `[routing]` notice.
+     * - `'delivery'` (default): the locus comes from the delivery that woke
+     *   the turn, a conversation fork's home channel, or a channel the agent
+     *   opened during the turn, and past those only from an open all-except
+     *   hold's channel or `unpromptedChannel` (below), each for the turns that
+     *   take it. Incoming traffic never moves it — not between turns, not
+     *   mid-turn. A turn with no such locus keeps its prose private, and says
+     *   so in a `[routing]` notice.
      * - `'latest-inbound'`: the previous rule. The most recent delivered
      *   inbound message is a global fallback locus for turns without one, and
      *   an addressed message injected mid-turn re-pins the turn's locus.
      *
-     * Held traffic never moves the locus under either rule.
+     * Held traffic never moves the locus under either rule. Under either, a
+     * turn the agent's own timer starts takes `unpromptedChannel` where it's
+     * set, after an all-except hold's channel and before both rules' own
+     * fallbacks. Neither rule applies to an agent under locked prose routing
+     * (AgentConfig.proseRouting 'locked'): its turns speak at its lock,
+     * whatever arrives.
      */
     speech?: {
         locus?: 'delivery' | 'latest-inbound';
@@ -227,9 +232,29 @@ export interface FrameworkConfig {
      */
     hostModePath?: string;
     /**
-     * Branch-independent durable queue of context writes deferred while
-     * quiesced. Defaults to `<storePath>/recovery/deferred-writes.json`; same
-     * rationale and fallback as `hostModePath`.
+     * Where a release before #291 kept its durable queue of deferred context
+     * writes. Defaults to `<storePath>/recovery/deferred-writes.json`; without
+     * either, the store's `framework/deferred-writes` slot. This release keeps
+     * no durable queue: a write is stored when it is made, and enters each
+     * agent's window at that agent's presentation points. Two holds keep a
+     * write in memory instead, and a crash loses it: a live operator surgery
+     * (a rollback, a suppression, a branch switch), until its release stores
+     * it, and an agent's context manager refusing its work after a failed
+     * re-initialization, until a branch move (switchBranch, a rollback or a
+     * suppression) re-initializes it.
+     *
+     * create() reads the record once and stores its writes. A write for an
+     * agent no longer registered goes to the primary when it is a failed
+     * reply, a channel notice its reader could act on, or a module's write
+     * for a run or a fork, and is dropped otherwise, logged. It then rewrites
+     * the record with what it left for the next boot: a write it couldn't
+     * store, or couldn't tell had already landed, with that agent's later
+     * writes. A write the store refuses as malformed is dropped, logged, as an
+     * earlier release's flush dropped it. When the store doesn't sync after
+     * the import, the record is left as it was.
+     *
+     * @deprecated Read once at boot by the deferred-write importer; removed in
+     * the next release.
      */
     deferredWritesPath?: string;
     /**
@@ -446,6 +471,34 @@ export interface FrameworkConfig {
      * `default`) refuses that request the same way, naming the feature set.
      */
     inferenceRouting?: InferenceRoutingPolicy;
+    /**
+     * The channel for a turn the agent's own timer starts, which no message
+     * prompted: the wake `skip_reply` schedules, or the end of a `sleep`. Plain
+     * speech in locus or hybrid prose routing goes there, and so does
+     * `channel_publish` naming no channel in any prose routing mode but locked,
+     * which servers are told as the turn's default outgoing channel. An
+     * all-except hold's channel still comes first while one is open, and without
+     * the setting such a turn follows `speech.locus`. A turn the framework opens
+     * to continue such a turn that had no locus of its own, as in explicit or
+     * disabled routing, takes it too: a `!` continuation, autoContinue's next
+     * turn, or a bounced reply's wake. No other turn takes it: not one a message
+     * prompted, from a channel, a module, a person at a console or another agent;
+     * not a heartbeat's or a reminder's (its plain speech is held as drafts); not
+     * a conversation fork's or an ephemeral run's; not a locked agent's, which
+     * speaks at its lock or holds its speech as drafts; and not a start merged
+     * from a timer's wake and any other cause. One value, for every agent on the
+     * framework. A registered channel's id, e.g. `discord:{guildId}:{channelId}`,
+     * or, to pick one server's where two register that id,
+     * `{serverId}:{channelId}`. `create()` refuses a value that is neither a
+     * string nor null, or is blank; null reads as not set. A value that names no
+     * registered channel, several, or one its server declared inbound-only, when
+     * a turn would take it, is logged, and logged again only after a turn has
+     * used it since; the turn takes what it would without the setting.
+     * `channel_publish`'s description adds a default for such turns only on a
+     * framework with an event gate, the only one with such turns; on any other
+     * the description is as it is without the setting.
+     */
+    unpromptedChannel?: string | null;
     /** EventGate config. If omitted, all events trigger inference (unchanged default). */
     gate?: GateOptions;
     /**
@@ -602,6 +655,8 @@ export interface InferenceLogEntry {
     success: boolean;
     /** Why it didn't succeed: the failure's message, or what stopped it */
     error?: string;
+    /** `error` in the framework's words, with no provider's text: what an agent may be shown of it */
+    errorWords?: string;
     /** Request data or blob ID if large. A stream the framework ended at a
      *  tool boundary (stopReason 'turn_ended', 'context_budget' or
      *  'physical_window') records a note in place of the body. */