@animalabs/agent-framework 0.32.0 → 0.34.0

package/dist/src/tune-out/tools.d.ts

@@ -16,6 +16,57 @@ import type { AgentConfig, ToolDefinition } from '../types/index.js';
 export declare const SUBCONSCIOUS_TOOL_NAMES: readonly ['deliver_summary', 'cancel_tuneout', 'note_disposition', 'speak_in_channel'];
 export type SubconsciousToolName = (typeof SUBCONSCIOUS_TOOL_NAMES)[number];
 export declare const SUBCONSCIOUS_TOOLS: ToolDefinition[];
+/**
+ * Who reads a tuned-out channel's traffic, as the text a resident reads
+ * says it: the persistent subconscious by the name it runs under, or reader
+ * forks. There is no hold without a reader (0.33.0) but one whose release
+ * failed after the persistent reader ended, or at a start with none
+ * configured: none runs then (`running: false`), the reader named as
+ * configured, or by its default name, for tune_out's own text, and what a
+ * held channel's messages are says that none reads them (tuneOutHeldWords,
+ * tunedOutTrafficWords). A persistent reader's name is a value the host
+ * supplied, marked as such (suppliedValue).
+ */
+export type TuneOutReader = {
+    readonly kind: 'persistent';
+    readonly name: string;
+    readonly running?: false;
+} | {
+    readonly kind: 'forks';
+};
+/**
+ * What a tuned-out channel's messages are, as the words after "its
+ * messages" in a refusal a resident reads (a channel tool's on a tuned-out
+ * channel): held from it and read by `reader`, by the name it runs under or
+ * as forks of the resident's context.
+ */
+export declare function tuneOutHeldWords(reader: TuneOutReader): string;
+/**
+ * What a tuned-out channel's traffic is, as the words after "its traffic"
+ * in the [tuned out] note to a send there: held from the resident and read
+ * by `reader` until the tune-out ends, or, where none runs, held until its
+ * release is tried again (TuneOutReader).
+ */
+export declare function tunedOutTrafficWords(reader: TuneOutReader): string;
+/**
+ * Whether a tuned-out channel's messages get to its reader, as the words
+ * after "its messages" in tune_out's answers about the channel's transport,
+ * in the sentence's `form`: they reach `reader`, by the name it runs under
+ * or as "the reader" (forks, as tuneOutTool says it). Where no reader runs,
+ * those answers aren't given: tuneOutNoReaderAnswer is, in their place.
+ */
+export declare function tuneOutReachWords(reader: TuneOutReader, form: 'reach' | 'may not reach' | "don't reach"): string;
+/**
+ * tune_out's answer about a tuned-out channel's transport where no reader
+ * runs (`running: false`, a hold left on record by a failed release): a
+ * sentence of its own, given alone in place of each answer that says
+ * whether the messages reach the reader and when (tuneOutReachWords), since
+ * opening the channel doesn't change that none reads them. Undefined where
+ * a reader runs. tune_out is refused with no reader, repeated for a channel
+ * already tuned out too, so this answers a tune_out whose reader ended
+ * while its channel's open was out.
+ */
+export declare function tuneOutNoReaderAnswer(reader: TuneOutReader): string | undefined;
 /**
  * Configuration for the subconscious (FrameworkConfig.subconscious). Two
  * shapes, by `reader`:
@@ -60,12 +111,21 @@ interface SubconsciousConfigBase {
      *  a reader none. */
     thinkingBinding?: AgentConfig['thinkingBinding'];
 }
+/**
+ * The name a persistent reader runs under: its configuration's `name`, or,
+ * where the host gave none, `'Subconscious'` (PersistentReaderConfig.name).
+ * The one place the framework names a reader the host didn't: everything
+ * that needs the name of an unnamed reader asks this.
+ */
+export declare function persistentReaderName(config: {
+    name?: string;
+}): string;
 export interface PersistentReaderConfig extends SubconsciousConfigBase {
     reader?: 'persistent';
     /**
      * Registry + participant name. Default 'Subconscious' — following the
      * Context Manager precedent: a title-case functional voice, not an
-     * agent-prefixed identifier.
+     * agent-prefixed identifier. persistentReaderName applies the default.
      */
     name?: string;
     /** Model id; defaults to the primary agent's (same-model side-process).
@@ -75,28 +135,52 @@ export interface PersistentReaderConfig extends SubconsciousConfigBase {
      *  `thinkingBinding` set its own. */
     model?: string;
     /**
-     * The voice/criteria mode block — recipe-side and co-authored with the
-     * resident (it is an aspect of their attention). Report-shaped, second
-     * person toward the resident. Canary before fleet use (issue #77).
+     * The persistent reader's system prompt (its AgentConfig.systemPrompt).
+     * Who writes it and what it says, a policy for the reader tools
+     * included, are the host's choice. Canary before fleet use (issue #77).
      */
     systemPrompt: string;
     /** WindowedPassthroughStrategy re-anchor fraction (default 0.5). */
     reAnchorFraction?: number;
+    /**
+     * How a resident's rounds go out in the subconscious's requests once its
+     * window follows the presentation index (#291, answer 13). Its own rounds go
+     * as stored either way.
+     *
+     * - `'transcript'` (the default): a line per tool call (the tool's name and
+     *   its input in brief) and per result (its outcome in brief), the text as
+     *   stored, and none of the resident's thinking (foreign-rounds.ts).
+     * - `'raw'`: as stored, as 0.30.0 sent them: the resident's thinking
+     *   blocks, its tool calls and their results, in the subconscious's
+     *   requests under the resident's name. A provider pairs tool blocks only
+     *   in the turns of the agent that made the call, so it may refuse them, or
+     *   the formatter may move them into the subconscious's own turns, where
+     *   they read as calls it made.
+     *
+     * A thinking block's signature binds the block to the prefix the resident
+     * was sent, so the block can't be sent as part of another agent's prefix;
+     * its text could be. Leaving the text out is the transcript's choice, not
+     * the provider's.
+     */
+    foreignRounds?: 'transcript' | 'raw';
 }
 export interface ForkReaderConfig extends SubconsciousConfigBase {
     reader: 'forks';
     /**
      * Whose weights run the fork. Required, never defaulted: a fork holds the
-     * resident's whole prefix, and which model reads it is the one fact the
-     * resident's consent names. The resident's own model is the copy; another
-     * model is allowed when stated here. `create` refuses the omission.
+     * resident's whole prefix, and which model reads it is recorded on each
+     * fork's `dendrite:agent-created` trace and is what a host's
+     * `dendrite.beforeDerive` can decide on. The resident's own model, or
+     * another model stated here. `create` refuses the omission.
      */
     model: string;
     /**
-     * The reader's voice block — report-shaped, second person toward the
-     * resident, co-authored with them. Delivered as the first message after
-     * the fork point, with the notice, the standing dispositions and the held
-     * traffic; never a system prompt.
+     * The reader's voice block: text the host supplies, handed to `framing`.
+     * The default framing (defaultReaderFraming) puts it in the one message a
+     * fork receives after the fork point, with the notice, the standing
+     * dispositions and the held traffic; it is never a system prompt. Who
+     * writes it and what it says, a policy for the reader tools included,
+     * are the host's choice.
      */
     voice: string;
     /**
@@ -114,7 +198,13 @@ export interface ForkReaderConfig extends SubconsciousConfigBase {
      * framework stores whatever this returns as a user message with
      * `metadata.kind = 'tune-out-reader-framing'`; the notice, voice,
      * dispositions and held traffic are in the context, and nothing else
-     * about the fork's prompt is fixed by the path.
+     * about the fork's prompt is fixed by the path. note_disposition tells a
+     * reader that a disposition it records is shown to the reader each time
+     * it runs, and a fork is shown them only as its framing puts them
+     * (`dispositions`), so a framing that leaves them out makes that untrue.
+     * Likewise the held traffic reaches the fork only as its framing puts it
+     * (`backlog`): the fork's view, the residents', leaves the raw rows out,
+     * as it leaves out all held traffic (the default framing shows them).
      */
     framing?: (context: ReaderFramingContext) => ContentBlock[];
 }
@@ -134,13 +224,20 @@ export interface ReaderFramingContext {
     /** Standing dispositions recorded on the epoch, or null. */
     dispositions: string | null;
     /**
-     * The traffic held since the last look, oldest first; empty when nothing
-     * arrived. It includes the messages still queued behind the resident's
-     * turn (admitted, not yet stored), last: their ids are held handles and
-     * their sequences provisional, as a module's held rows are.
+     * The traffic held since the last look, oldest first, as stored; empty
+     * when nothing arrived. A held message is stored as it arrives, the
+     * resident's turn alive or not (#291), so the stored rows are all of it,
+     * but for one a surgery's hold or a manager awaiting recovery keeps in
+     * memory: it isn't stored yet, and is in the first backlog after it is.
      */
     backlog: StoredMessage[];
-    /** How many of `backlog`'s last entries are still queued behind the resident's turn. Absent is none. */
+    /**
+     * Was how many of `backlog`'s last entries were still queued behind the
+     * resident's turn. Since #291 nothing is queued, so the framework never
+     * sets it.
+     *
+     * @deprecated Never set since #291; removed in a later release.
+     */
     queuedCount?: number;
 }
 /**

package/dist/src/tune-out/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tune-out/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,eAAO,MAAM,uBAAuB,YAClC,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,CACV,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAmF9C,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG,gBAAgB,CAAC;AAE3E,UAAU,sBAAsB;IAC9B,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;6CAGyC;IACzC,oBAAoB,CAAC,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAC3D;;;;yBAIqB;IACrB,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;yCAIqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,OAAO,4BAA4B,EAAE,eAAe,CAAC;IAC7E,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,YAAY,EAAE,CAAC;CAC7D;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvC,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wGAAwG;IACxG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAkC9E"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tune-out/tools.ts"],"names":[],"mappings":"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"}

package/dist/src/tune-out/tools.js

@@ -1,4 +1,5 @@
 import { authorLine } from '../author-presentation.js';
+import { appendAll } from '../append-all.js';
 export const SUBCONSCIOUS_TOOL_NAMES = [
     'deliver_summary',
     'cancel_tuneout',
@@ -8,10 +9,9 @@ export const SUBCONSCIOUS_TOOL_NAMES = [
 export const SUBCONSCIOUS_TOOLS = [
     {
         name: 'deliver_summary',
-        description: 'Deliver a summary into the resident\'s context, in your own voice, ' +
-            'addressed to them (second person). Use at cadence when the diverted ' +
-            'traffic merits it; staying silent is always allowed — an empty ' +
-            'period needs no report.',
+        description: 'Deliver a summary into the resident\'s context: `text` arrives there ' +
+            'verbatim (leading and trailing whitespace trimmed), under your own ' +
+            'name.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -29,11 +29,15 @@ export const SUBCONSCIOUS_TOOLS = [
     },
     {
         name: 'cancel_tuneout',
-        description: 'End the tune-out on a channel now — use when something needs the ' +
-            'resident\'s full attention. The diverted backlog is delivered to ' +
-            'them (capped), and normal attention resumes. Add your own note in ' +
-            '`text`; it arrives alongside the backlog, in your voice. If you were ' +
-            'started to read one hold, you can end only that hold.',
+        description: 'End the tune-out on a channel. The diverted backlog is delivered ' +
+            'to the resident (capped), and the channel\'s traffic reaches them as ' +
+            'it did before the tune-out, unless the all-except hold holds it too. ' +
+            'A note in `text` arrives alongside the ' +
+            'backlog, verbatim (leading and trailing whitespace trimmed), under ' +
+            'your own name. Where the cancel has to wait (an operator\'s change to ' +
+            'the store, say), its answer says so, and whether your note waits with ' +
+            'it. If you were started to read ' +
+            'one hold, you can end only that hold.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -49,10 +53,10 @@ export const SUBCONSCIOUS_TOOLS = [
     },
     {
         name: 'note_disposition',
-        description: 'Record a standing disposition for yourself — a durable note that ' +
-            'shapes how you treat future traffic ("antra\'s pings always ' +
-            'escalate", "ignore release-bot"). Replaces any previous note under ' +
-            'the same key.',
+        description: 'Record a standing disposition: a durable note, kept under `key` ' +
+            'across invocations and shown to the reader each time it runs (e.g. ' +
+            'key "<sender>", text "<a note on their messages>"). Replaces any ' +
+            'previous note under the same key.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -67,14 +71,14 @@ export const SUBCONSCIOUS_TOOLS = [
     },
     {
         name: 'speak_in_channel',
-        description: 'Post a message into a tuned-out channel, in your own words and ' +
-            'clearly as yourself (not as the resident); it goes out through the ' +
-            'resident\'s publish path, so the channel sees it under their account. ' +
-            'Use sparingly — e.g. to tell someone the resident is tuned out and ' +
-            'when to expect them. If you were started to read one hold, you can ' +
-            'post only into a channel that hold still holds, and a post made once ' +
-            'it has ended is refused; your report can say it instead. Disabled unless ' +
-            'the resident\'s configuration allows it.',
+        description: 'Post `text` into a tuned-out channel, as written (leading and trailing ' +
+            'whitespace trimmed). It goes out through ' +
+            'the resident\'s publish path, so the channel sees it under the ' +
+            'resident\'s account; nothing in the post names you. If you were ' +
+            'started to read one hold, you can post only into a channel that hold ' +
+            'still holds, and a post made once it has ended is refused; your report ' +
+            'can say it instead. Disabled unless the resident\'s configuration ' +
+            'allows it.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -85,6 +89,68 @@ export const SUBCONSCIOUS_TOOLS = [
         },
     },
 ];
+/**
+ * What a tuned-out channel's messages are, as the words after "its
+ * messages" in a refusal a resident reads (a channel tool's on a tuned-out
+ * channel): held from it and read by `reader`, by the name it runs under or
+ * as forks of the resident's context.
+ */
+export function tuneOutHeldWords(reader) {
+    if (reader.kind === 'persistent' && reader.running === false) {
+        return "are held from you, with no reader running here to read them, until the tune-out's release, which failed, is tried again";
+    }
+    return reader.kind === 'persistent' ? `are held from you and read by ${reader.name}`
+        : 'are held from you and read by forks of your context';
+}
+/**
+ * What a tuned-out channel's traffic is, as the words after "its traffic"
+ * in the [tuned out] note to a send there: held from the resident and read
+ * by `reader` until the tune-out ends, or, where none runs, held until its
+ * release is tried again (TuneOutReader).
+ */
+export function tunedOutTrafficWords(reader) {
+    if (reader.kind === 'persistent' && reader.running === false) {
+        return "is still held from you, with no reader running here to read it, until the tune-out's release, which failed, is tried again.";
+    }
+    return reader.kind === 'persistent'
+        ? `is still held from you, and read by ${reader.name}, until the tune-out ends.`
+        : 'is still held from you, and read by forks of your context, until the tune-out ends.';
+}
+/**
+ * Whether a tuned-out channel's messages get to its reader, as the words
+ * after "its messages" in tune_out's answers about the channel's transport,
+ * in the sentence's `form`: they reach `reader`, by the name it runs under
+ * or as "the reader" (forks, as tuneOutTool says it). Where no reader runs,
+ * those answers aren't given: tuneOutNoReaderAnswer is, in their place.
+ */
+export function tuneOutReachWords(reader, form) {
+    return `${form} ${reader.kind === 'persistent' ? reader.name : 'the reader'}`;
+}
+/**
+ * tune_out's answer about a tuned-out channel's transport where no reader
+ * runs (`running: false`, a hold left on record by a failed release): a
+ * sentence of its own, given alone in place of each answer that says
+ * whether the messages reach the reader and when (tuneOutReachWords), since
+ * opening the channel doesn't change that none reads them. Undefined where
+ * a reader runs. tune_out is refused with no reader, repeated for a channel
+ * already tuned out too, so this answers a tune_out whose reader ended
+ * while its channel's open was out.
+ */
+export function tuneOutNoReaderAnswer(reader) {
+    if (reader.kind !== 'persistent' || reader.running !== false)
+        return undefined;
+    return 'The tune-out is recorded, but its messages are held, with no reader running here to read them, until the '
+        + "tune-out's release, which failed, is tried again; opening its channel doesn't change that.";
+}
+/**
+ * The name a persistent reader runs under: its configuration's `name`, or,
+ * where the host gave none, `'Subconscious'` (PersistentReaderConfig.name).
+ * The one place the framework names a reader the host didn't: everything
+ * that needs the name of an unnamed reader asks this.
+ */
+export function persistentReaderName(config) {
+    return config.name ?? 'Subconscious';
+}
 /**
  * The default reader-fork framing: a header naming the channel, epoch and
  * trigger; the notice; the voice block; standing dispositions if any; then
@@ -101,17 +167,12 @@ export function defaultReaderFraming(ctx) {
         return content;
     }
     const n = ctx.backlog.length;
-    const q = Math.min(Math.max(0, Math.floor(ctx.queuedCount ?? 0)), n);
     const lines = [`\n[Held in ${ctx.channelId} since your last look: ${n} message${n === 1 ? '' : 's'}]`];
     const flush = () => {
         if (lines.length > 0)
             content.push({ type: 'text', text: lines.splice(0).join('\n') });
     };
-    const which = q === n ? (q === 1 ? 'It' : 'They') : (q === 1 ? 'The last one' : `The last ${q}`);
-    const queuedNote = `[${which} arrived while ${ctx.resident}'s turn was running, so ${q === 1 ? 'it is' : 'they are'} still queued, not yet stored.]`;
-    for (const [i, message] of ctx.backlog.entries()) {
-        if (q > 0 && i === n - q)
-            lines.push(queuedNote);
+    for (const message of ctx.backlog) {
         const author = message.metadata?.author?.name ?? message.participant;
         const text = message.content
             .filter((b) => b.type === 'text')
@@ -121,7 +182,7 @@ export function defaultReaderFraming(ctx) {
         const media = message.content.filter((b) => b.type !== 'text');
         if (media.length > 0) {
             flush();
-            content.push(...media);
+            appendAll(content, media);
         }
     }
     flush();

package/dist/src/tune-out/tools.js.map

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

package/dist/src/tune-out/window-anchor.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Where the persistent subconscious's window starts (#291, AF-5).
+ *
+ * The subconscious reads a tune-out's held traffic through a windowed
+ * passthrough strategy: everything from the anchor on, the anchor at the
+ * oldest active tune-out's start (the coordinator's anchorSubconscious), or
+ * at an earlier start kept in force: a cancelled tune-out's, kept while
+ * another stays active and across a restart, until the next enter sets the
+ * oldest active one's (below).
+ * While its window is the record, a start is a sequence, and the window is
+ * every row stored at it or after. Once its window follows the presentation
+ * index, the window is the rows in the order it was shown them, and a start
+ * is an index ordinal: the row at it and every row presented after it.
+ *
+ * A tune-out's start can't be turned into an ordinal once and for all at its
+ * enter. The subconscious's window grows only at its own points, so a row
+ * stored before the start can still be out of its window then (its turn
+ * alive, the host quiesced), and would be presented after the start, inside
+ * the window. Converting the sequence again later (a restart, another
+ * tune-out's enter) can give another ordinal, and so another window, once
+ * rows have been presented out of record order. So each tune-out's start is
+ * fixed once, at the first moment no row the subconscious is owed stored
+ * before the start is out of its window: the ordinal just past the last row
+ * in its window stored before the start, which leaves every such row out
+ * (0 when there is none). Others' rows enter a window in record order, so
+ * that is where the first row stored at the start or after entered, unless
+ * one of the subconscious's own rows was presented ahead of them, at its
+ * write, in the turn the tune-out began in; that row stays out too, the turn
+ * having been before the tune-out. The coordinator keeps the ordinal
+ * (subconsciousWindowFixed), and from then on the start is set by it,
+ * clamped to the window's length on a branch whose window is shorter (a
+ * rollback), the clamped ordinal then kept as the start, never converted
+ * again. A kept ordinal is kept as the start in force once it is set, not
+ * before, and one whose setting or keeping fails is tried again at the next
+ * presentation, as a fix is. One set while the window is the record (a
+ * branch move whose re-initialization of the subconscious failed) waits
+ * longer: it is set by sequence and fixed at the next enter or restart once
+ * the window presents. One whose setting or keeping failed before a branch
+ * move is fixed again on the branch moved to, from its window there, as one
+ * never fixed is: an ordinal is a place on the branch it was fixed on; one
+ * for tune-outs none of which is active then, and a cancelled tune-out's
+ * start set in force by its kept ordinal, are dropped at the move. A
+ * restart that finds a start in force kept sets that one, and fixes the
+ * oldest active tune-out's start, if it isn't kept, without moving the
+ * window to it; one that finds none in force kept sets the anchor the
+ * strategy persisted, as the start in force: where the oldest's start is
+ * kept, if it is earlier (a cancelled tune-out's start that was set but
+ * never kept), and where it isn't (its fix set, its keeping failed),
+ * wherever it is, rather than converting the oldest's sequence again, that
+ * start fixed without moving the window to it; where that anchor can't be
+ * read, it sets nothing, the window left where it was until the next enter
+ * or restart.
+ */
+import type { ContextManager, StoredMessage } from '@animalabs/context-manager';
+import type { SubconsciousWindowStart } from './coordinator.js';
+import type { TraceEventInput } from '../types/trace.js';
+/** The windowed strategy's anchor setters and read, as the anchor uses them. */
+export interface AnchoredStrategy {
+    setAnchor(sequence: number): void;
+    setAnchorOrdinal(ordinal: number): void;
+    getAnchorOrdinal(): number | undefined;
+}
+/** What the anchor reads of the framework. */
+export interface SubconsciousWindowAnchorHost {
+    /** The subconscious's name, for its traces. */
+    readonly agentName: string;
+    /** Its context manager while it is registered. */
+    cm(): Pick<ContextManager, 'indexLength' | 'getPresentedMessages' | 'ordinalOf'> | undefined;
+    /** Its windowed strategy. */
+    strategy(): AnchoredStrategy | null;
+    /** Whether its window follows the presentation index, so its places are ordinals. */
+    presents(): boolean;
+    /** The rows it is owed that its window doesn't hold yet, one per body (AgentPresentation.owedOf). */
+    owed(): readonly Pick<StoredMessage, 'sequence'>[];
+    /**
+     * Keep a start fixed for `epochIds` (TuneOutCoordinator.subconsciousWindowFixed), as the start in force when
+     * `inForce`; false when it couldn't be kept.
+     */
+    fixed(epochIds: readonly string[], ordinal: number, inForce: boolean): boolean;
+    emitTrace(event: Extract<TraceEventInput, {
+        type: 'tune-out:subconscious-window';
+    }>): void;
+}
+/** The subconscious's window start, set by sequence in legacy mode and by a fixed ordinal once its window is presented. */
+export declare class SubconsciousWindowAnchor {
+    private readonly 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).
+     */
+    private pending;
+    constructor(host: SubconsciousWindowAnchorHost);
+    /**
+     * 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: SubconsciousWindowStart, others?: readonly SubconsciousWindowStart[]): void;
+    /**
+     * 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?: readonly string[]): void;
+    /** Rows entered the subconscious's window (the presentation index's onPresented): a start waiting to be fixed may be fixable now. */
+    presented(): void;
+    /**
+     * 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.
+     */
+    private tryFix;
+}
+//# sourceMappingURL=window-anchor.d.ts.map

package/dist/src/tune-out/window-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-anchor.d.ts","sourceRoot":"","sources":["../../../src/tune-out/window-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,8CAA8C;AAC9C,MAAM,WAAW,4BAA4B;IAC3C,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,sBAAsB,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC;IAC7F,6BAA6B;IAC7B,QAAQ,IAAI,gBAAgB,GAAG,IAAI,CAAC;IACpC,qFAAqF;IACrF,QAAQ,IAAI,OAAO,CAAC;IACpB,qGAAqG;IACrG,IAAI,IAAI,SAAS,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC;IACnD;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/E,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE;QAAE,IAAI,EAAE,8BAA8B,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CAC5F;AAED,2HAA2H;AAC3H,qBAAa,wBAAwB;IAkBvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBjC;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAKP;IAER,YAA6B,IAAI,EAAE,4BAA4B,EAAI;IAEnE;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,KAAK,EAAE,uBAAuB,EAAE,MAAM,GAAE,SAAS,uBAAuB,EAAO,GAAG,IAAI,CA2DzF;IAED;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAS5C;IAED,qIAAqI;IACrI,SAAS,IAAI,IAAI,CAOhB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;CAqCf"}