@orkestrel/agent 0.0.31 → 0.0.32

package/dist/src/core/index.cjs

@@ -9,7 +9,7 @@ let _orkestrel_workspace = require("@orkestrel/workspace");
 let _orkestrel_queue = require("@orkestrel/queue");
 let _orkestrel_workflow = require("@orkestrel/workflow");
 let _orkestrel_abort = require("@orkestrel/abort");
-//#region src/core/constants.ts
+// src/core/constants.ts
 /**
 * Lists the roles a conversation message can play, in the order the wire contract names them —
 * the one list the {@link import('./types.js').MessageRole} union derives from, the message
@@ -21,8 +21,7 @@ var MESSAGE_ROLES = Object.freeze([
 	"assistant",
 	"tool"
 ]);
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Reports a judge call cancelled by the caller's signal or its deadline, carrying the
 * {@link JudgeResult} merged from the calls that completed before the cancel and the
@@ -58,8 +57,7 @@ var JudgeAbortError = class extends Error {
 function isJudgeAbortError(value) {
 	return (0, _orkestrel_contract.isInstance)(value, JudgeAbortError);
 }
-//#endregion
-//#region src/core/shapers.ts
+// src/core/shapers.ts
 /**
 * Describes a tool call's JSON wire projection.
 *
@@ -89,12 +87,10 @@ var messageShape = (0, _orkestrel_contract.objectShape)({
 	images: (0, _orkestrel_contract.optionalShape)((0, _orkestrel_contract.arrayShape)((0, _orkestrel_contract.stringShape)())),
 	thinking: (0, _orkestrel_contract.optionalShape)((0, _orkestrel_contract.stringShape)())
 });
-//#endregion
-//#region src/core/contracts.ts
+// src/core/contracts.ts
 /** Validates and projects conversation messages at a JSON wire boundary. */
 var messageContract = (0, _orkestrel_contract.createContract)(messageShape);
-//#endregion
-//#region src/core/cloners.ts
+// src/core/cloners.ts
 /**
 * Owns a value by serializing it to JSON and parsing the text, so the copy shares nothing with its source.
 *
@@ -116,8 +112,7 @@ function copyJSON(value) {
 	if (!text.success || typeof text.value !== "string") return void 0;
 	return (0, _orkestrel_contract.parseJSON)(text.value);
 }
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Filters a list of members by a {@link import('./contexts/index.js').ScopeInterface} allow-list of keys —
 * `undefined` passes everything, `[]` passes nothing, and a non-empty list passes the listed keys
@@ -456,8 +451,7 @@ function renderJSON(value) {
 function matchesJudgment(judgment, question, sources, state, model) {
 	return judgment.model === model && judgment.state === state && judgment.sources.length === sources.length && judgment.sources.every((id, index) => id === sources[index]) && JSON.stringify(judgment.question) === JSON.stringify(question);
 }
-//#endregion
-//#region src/core/validators.ts
+// src/core/validators.ts
 /**
 * Checks whether a value is a judge entry: a string, a JSON record, or a JSON array.
 *
@@ -534,8 +528,7 @@ function isJudgeQuestion(value) {
 function isNonNegativeSafeInteger(value) {
 	return (0, _orkestrel_contract.isFiniteNumber)(value) && Number.isSafeInteger(value) && value >= 0;
 }
-//#endregion
-//#region src/core/providers/constants.ts
+// src/core/providers/constants.ts
 /**
 * Names the opening tag a {@link import('./ThinkSplitter.js').ThinkSplitter} recognizes as the start of
 * an in-content reasoning span — `'<think>'`, the de-facto wire convention thinking models
@@ -601,8 +594,7 @@ var INVALID_RELAY_STATUS = 400;
 var OVERSIZED_RELAY_STATUS = 413;
 /** Names the System One decision endpoint shared by compatible servers. */
 var SYSTEM_ONE_PATH = "/v1/systemone";
-//#endregion
-//#region src/core/providers/errors.ts
+// src/core/providers/errors.ts
 /**
 * Reports a provider stream cancelled mid-flight by its bound signal — thrown by the
 * `stream` method of a {@link ProviderInterface}, carrying the {@link ProviderResult} assembled from
@@ -713,8 +705,7 @@ var JudgeError = class extends Error {
 function isJudgeError(value) {
 	return (0, _orkestrel_contract.isInstance)(value, JudgeError);
 }
-//#endregion
-//#region src/core/providers/shapers.ts
+// src/core/providers/shapers.ts
 /**
 * Describes a provider request's JSON wire projection.
 *
@@ -774,16 +765,14 @@ var relayFrameShape = (0, _orkestrel_contract.unionShape)((0, _orkestrel_contrac
 	channel: (0, _orkestrel_contract.literalShape)(["error"]),
 	message: (0, _orkestrel_contract.stringShape)()
 }));
-//#endregion
-//#region src/core/providers/contracts.ts
+// src/core/providers/contracts.ts
 /** Validates and projects provider requests at a JSON wire boundary. */
 var providerRequestContract = (0, _orkestrel_contract.createContract)(providerRequestShape);
 /** Validates and projects provider results at a JSON wire boundary. */
 var providerResultContract = (0, _orkestrel_contract.createContract)(providerResultShape);
 /** Validates and projects channel-discriminated relay frames at a JSON wire boundary. */
 var relayFrameContract = (0, _orkestrel_contract.createContract)(relayFrameShape);
-//#endregion
-//#region src/core/providers/helpers.ts
+// src/core/providers/helpers.ts
 /**
 * Assembles a provider result with only populated optional fields.
 *
@@ -1264,8 +1253,7 @@ function extractSystemOneUsage(usage) {
 	});
 	return extracted.success ? extracted.value : void 0;
 }
-//#endregion
-//#region src/core/providers/RelayStream.ts
+// src/core/providers/RelayStream.ts
 /**
 * Streams a provider call as validated NDJSON frames under response backpressure.
 *
@@ -1373,8 +1361,7 @@ var RelayStream = class {
 		this.#signal.removeEventListener("abort", this.#listener);
 	}
 };
-//#endregion
-//#region src/core/providers/ThinkSplitter.ts
+// src/core/providers/ThinkSplitter.ts
 /**
 * Separates `<think>…</think>` spans from raw content deltas with per-stream state: text inside a
 * span accumulates on `thinking`, and text outside it returns as clean content, so a provider
@@ -1492,8 +1479,7 @@ var ThinkSplitter = class {
 		return Array.from({ length: max }, (_, index) => max - index).find((length) => this.#pending.endsWith(tag.slice(0, length))) ?? 0;
 	}
 };
-//#endregion
-//#region src/core/providers/AgentProvider.ts
+// src/core/providers/AgentProvider.ts
 /**
 * Implements bounded HTTP streaming and result assembly behind concrete wire seams.
 *
@@ -1704,8 +1690,7 @@ var AgentProvider = class {
 		return response;
 	}
 };
-//#endregion
-//#region src/core/providers/RelayProvider.ts
+// src/core/providers/RelayProvider.ts
 /**
 * Carries provider calls over an authenticated NDJSON relay endpoint.
 *
@@ -1822,8 +1807,7 @@ var RelayProvider = class extends AgentProvider {
 		return parser.parse("\n");
 	}
 };
-//#endregion
-//#region src/core/providers/AgentJudge.ts
+// src/core/providers/AgentJudge.ts
 /**
 * Implements the bounded HTTP calls, validation, and result merging of a judge behind concrete
 * wire seams.
@@ -1963,8 +1947,7 @@ var AgentJudge = class {
 		}
 	}
 };
-//#endregion
-//#region src/core/providers/validators.ts
+// src/core/providers/validators.ts
 /**
 * Checks whether a value is a System One response envelope with optional model and usage.
 *
@@ -2022,8 +2005,7 @@ function isSystemOneAnswer(value) {
 	});
 	return checked.success && checked.value;
 }
-//#endregion
-//#region src/core/providers/SystemOneJudge.ts
+// src/core/providers/SystemOneJudge.ts
 /**
 * Carries judge questions over the System One protocol and derives answers from server distributions.
 *
@@ -2124,8 +2106,7 @@ var SystemOneJudge = class extends AgentJudge {
 		};
 	}
 };
-//#endregion
-//#region src/core/providers/factories.ts
+// src/core/providers/factories.ts
 /**
 * Creates an authorized relay handler that validates a bounded JSON request before streaming.
 *
@@ -2284,8 +2265,7 @@ function createThinkSplitter() {
 function createSystemOneJudge(options) {
 	return new SystemOneJudge(options);
 }
-//#endregion
-//#region src/core/conversations/constants.ts
+// src/core/conversations/constants.ts
 /**
 * Sets the default number of recent live messages the `compact()` method of a
 * {@link ConversationInterface} retains verbatim — `0`, so a manual `compact()` keeps no recent tail and folds every
@@ -2312,8 +2292,7 @@ var DEFAULT_CONVERSATION_KEEP = 0;
 * because it interpolates the per-call provenance `label`).
 */
 var CONVERSATION_RECAP_PREFIX = "[Summary of earlier messages] ";
-//#endregion
-//#region src/core/conversations/errors.ts
+// src/core/conversations/errors.ts
 /**
 * Reports a conversation with no {@link ConversationSummaryHandler} to fold its messages with, a
 * `sections` cap below `1`, a `keep` that is not a nonnegative safe integer, or a judgment or
@@ -2373,8 +2352,7 @@ var ConversationError = class extends Error {
 function isConversationError(value) {
 	return (0, _orkestrel_contract.isInstance)(value, ConversationError);
 }
-//#endregion
-//#region src/core/conversations/validators.ts
+// src/core/conversations/validators.ts
 /**
 * Checks whether a value satisfies the domain conversation-message contract.
 *
@@ -2516,8 +2494,7 @@ function isConversationSnapshot(value) {
 		judgments: (0, _orkestrel_contract.optionalOf)((0, _orkestrel_contract.arrayOf)(isJudgment))
 	}, ["judgments"])(value);
 }
-//#endregion
-//#region src/core/conversations/helpers.ts
+// src/core/conversations/helpers.ts
 /**
 * Builds records for answered or refused request keys, attaching usage only for a single question.
 *
@@ -2726,8 +2703,7 @@ function raceSignal(promise, signal) {
 		promise.then(resolve, reject).finally(() => settled.abort());
 	});
 }
-//#endregion
-//#region src/core/conversations/JudgmentManager.ts
+// src/core/conversations/JudgmentManager.ts
 /**
 * Stores judgments in insertion order and asks a judge only for unmatched question identities.
 *
@@ -2823,8 +2799,7 @@ var JudgmentManager = class {
 		return structuredClone(judgment);
 	}
 };
-//#endregion
-//#region src/core/conversations/Conversation.ts
+// src/core/conversations/Conversation.ts
 /**
 * Represents a conversation — a live uncompacted tail of messages it owns directly above a flat
 * message store, plus compacted, summarized {@link Section} records and a `summarizable` flag,
@@ -3042,8 +3017,7 @@ var Conversation = class {
 		return message;
 	}
 };
-//#endregion
-//#region src/core/conversations/ConversationManager.ts
+// src/core/conversations/ConversationManager.ts
 /**
 * Registers {@link Conversation} instances keyed by `id`, in insertion order, with an active pointer —
 * the id-keyed store over the conversation layer, the `active` / `switch` seam the
@@ -3165,8 +3139,7 @@ var ConversationManager = class {
 		return removed;
 	}
 };
-//#endregion
-//#region src/core/conversations/stores/MemoryConversationStore.ts
+// src/core/conversations/stores/MemoryConversationStore.ts
 /**
 * Implements the {@link ConversationStoreInterface} in memory — a process-lifetime `Map` of
 * {@link ConversationSnapshot} records keyed by conversation id, the default store
@@ -3239,8 +3212,7 @@ var MemoryConversationStore = class {
 		return Promise.resolve();
 	}
 };
-//#endregion
-//#region src/core/conversations/stores/DatabaseConversationStore.ts
+// src/core/conversations/stores/DatabaseConversationStore.ts
 /**
 * Backs a {@link ConversationStoreInterface} with one table of the `databases` layer — a
 * conversation's durable state is a row holding the snapshot as one opaque JSON column, narrowed
@@ -3347,8 +3319,7 @@ var DatabaseConversationStore = class {
 		await this.#table.remove(id);
 	}
 };
-//#endregion
-//#region src/core/conversations/factories.ts
+// src/core/conversations/factories.ts
 /**
 * Creates a conversation — a {@link ConversationInterface} grouping messages above a flat
 * message store it owns directly, with compaction into summarized sections, on-demand
@@ -3523,8 +3494,7 @@ function createDatabaseConversationStore(driver = (0, _orkestrel_database.create
 		tables: { conversations: columns }
 	}).table("conversations"));
 }
-//#endregion
-//#region src/core/contexts/constants.ts
+// src/core/contexts/constants.ts
 /**
 * Names the section header the `build()` method of {@link import('./AgentContext.js').AgentContext}
 * renders the active workspace's text files under — `'## Workspace'`, the leading line of the dedicated
@@ -3540,8 +3510,7 @@ function createDatabaseConversationStore(driver = (0, _orkestrel_database.create
 * `base64` payload attaches to the last user message.
 */
 var WORKSPACE_SECTION_HEADER = "## Workspace";
-//#endregion
-//#region src/core/contexts/instructions/Instruction.ts
+// src/core/contexts/instructions/Instruction.ts
 /**
 * Represents an immutable named directive — an {@link InstructionInterface} assembled once from
 * its input (`name` / `content` and an optional `priority`), the `id` minted at
@@ -3576,8 +3545,7 @@ var Instruction = class {
 		if (input.override !== void 0) this.override = input.override;
 	}
 };
-//#endregion
-//#region src/core/contexts/instructions/InstructionManager.ts
+// src/core/contexts/instructions/InstructionManager.ts
 /**
 * Registers the immutable {@link Instruction} instances a richer context assembles a directives block
 * from — keyed by `name` so adding an instruction whose name is already stored overwrites it,
@@ -3668,8 +3636,7 @@ var InstructionManager = class {
 		return removed;
 	}
 };
-//#endregion
-//#region src/core/contexts/helpers.ts
+// src/core/contexts/helpers.ts
 /**
 * Renders a path-addressed text body as a fenced reference block — a `File: <path>` label line
 * over a language-tagged fence, the framing the
@@ -3840,8 +3807,7 @@ function intersectKeys(parent, child) {
 	const allowed = new Set(parent);
 	return child.filter((key) => allowed.has(key));
 }
-//#endregion
-//#region src/core/contexts/scopes/Scope.ts
+// src/core/contexts/scopes/Scope.ts
 /**
 * Represents a named, immutable filter over a richer context's items — an optional allow-list per
 * category (`instructions` / `tools` / `files`), each keyed by that category's identity (an
@@ -3901,8 +3867,7 @@ var Scope = class Scope {
 		});
 	}
 };
-//#endregion
-//#region src/core/contexts/scopes/ScopeManager.ts
+// src/core/contexts/scopes/ScopeManager.ts
 /**
 * Registers the named filters a richer context reuses — immutable {@link Scope} instances keyed by their
 * minted `id`, in insertion order, where `add` always mints and stores rather than overwriting,
@@ -3969,8 +3934,7 @@ var ScopeManager = class {
 		return removed;
 	}
 };
-//#endregion
-//#region src/core/contexts/AgentContext.ts
+// src/core/contexts/AgentContext.ts
 /**
 * Assembles a provider request from the richer turn context — the optional system prompt, the
 * observable context managers (instructions / workspaces), the
@@ -4124,8 +4088,7 @@ var AgentContext = class {
 		return this.#conversations.active ?? conversation;
 	}
 };
-//#endregion
-//#region src/core/contexts/factories.ts
+// src/core/contexts/factories.ts
 /**
 * Creates an instruction — an immutable {@link InstructionInterface} (a named directive)
 * from its `name` / `content` and optional `priority`, the `id` minted at construction.
@@ -4269,8 +4232,7 @@ function createScopeManager(options) {
 function createAgentContext(options) {
 	return new AgentContext(options);
 }
-//#endregion
-//#region src/core/agents/constants.ts
+// src/core/agents/constants.ts
 /**
 * Caps an {@link AgentInterface} turn's tool iterations by default — `10` context → provider →
 * tools cycles before the loop stops, so a model that keeps requesting tools can never loop
@@ -4297,8 +4259,7 @@ var MESSAGE_TOKEN_OVERHEAD = 4;
 * exact count.
 */
 var IMAGE_TOKEN_ESTIMATE = 512;
-//#endregion
-//#region src/core/agents/errors.ts
+// src/core/agents/errors.ts
 /**
 * Reports an {@link AgentInterface} run that ended {@link AgentResult.partial} under a
 * `partial` policy of `false` (the default) — thrown by an agent-job handler (a
@@ -4403,8 +4364,7 @@ var AgentError = class extends Error {
 function isAgentError(value) {
 	return (0, _orkestrel_contract.isInstance)(value, AgentError);
 }
-//#endregion
-//#region src/core/agents/Channel.ts
+// src/core/agents/Channel.ts
 /**
 * Buffers chunks in a minimal unbounded async channel — the eager pump writes them in (`push`)
 * and ends it (`close` / `fail`) regardless of consumption, while a consumer reads them back live
@@ -4474,8 +4434,7 @@ var Channel = class {
 		});
 	}
 };
-//#endregion
-//#region src/core/agents/helpers.ts
+// src/core/agents/helpers.ts
 /**
 * Projects an unknown value onto a fresh, exact `JSONValue` representation of an
 * {@link AgentResult} — capturing each structural field once through a total boundary,
@@ -5057,8 +5016,7 @@ function extractQueueOptions(options) {
 		...timeout === void 0 ? {} : { timeout }
 	};
 }
-//#endregion
-//#region src/core/agents/Agent.ts
+// src/core/agents/Agent.ts
 /**
 * Composes a {@link ProviderInterface}, an {@link AgentContext}, and a
 * {@link ToolManagerInterface} into a bounded context → provider → tools → repeat turn, exposed
@@ -5621,8 +5579,7 @@ var Agent = class {
 		return AbortSignal.any(signals);
 	}
 };
-//#endregion
-//#region src/core/agents/AgentFanout.ts
+// src/core/agents/AgentFanout.ts
 /**
 * Executes one runner's agent jobs — spawning each unit's declared children on its first attempt
 * only, then rehydrating the unit through a registry with the controller signal and settling it
@@ -5680,8 +5637,7 @@ var AgentFanout = class {
 		return settleAgentJob(this.#registry.build(controller.input, controller.signal), this.#partial);
 	}
 };
-//#endregion
-//#region src/core/agents/Authority.ts
+// src/core/agents/Authority.ts
 /**
 * Gates the agent loop's tool calls — the synchronous policy consulted before each call runs,
 * turning one {@link AuthorityContext} into an {@link AuthorityDecision} by walking the ordered
@@ -5735,8 +5691,7 @@ var Authority = class {
 		return this.#fallback;
 	}
 };
-//#endregion
-//#region src/core/agents/AgentRegistry.ts
+// src/core/agents/AgentRegistry.ts
 /**
 * Makes a durable, JSON-serializable {@link AgentJobInput} runnable — holds the named pools of
 * live, non-serializable pieces (providers, tools, authorities, schedulers), throws on a name
@@ -5823,8 +5778,7 @@ var AgentRegistry = class {
 		return manager;
 	}
 };
-//#endregion
-//#region src/core/agents/factories.ts
+// src/core/agents/factories.ts
 /**
 * Creates an agent loop — an {@link AgentInterface} composing a
 * {@link ProviderInterface}, its {@link AgentContextInterface}, and a tool registry
@@ -6059,8 +6013,7 @@ function createAgentRunner(options) {
 		handler: fanout.execute.bind(fanout)
 	});
 }
-//#endregion
-//#region src/core/ledgers/constants.ts
+// src/core/ledgers/constants.ts
 /**
 * Lists the categories the ledger files a message under, in the order the category question
 * names them — the one list the {@link LedgerCategory} union derives from.
@@ -6163,8 +6116,7 @@ var DEFAULT_RECALL_LIMIT = 2;
 var LEDGER_SCALE_DRIFT = .06;
 /** Matches the logprob decoding failure `invalid or duplicate top logprob token`, which the ledger holds for the ledger's life. */
 var DETERMINISTIC_JUDGE_ERROR = /invalid or duplicate top logprob token/;
-//#endregion
-//#region src/core/ledgers/errors.ts
+// src/core/ledgers/errors.ts
 /**
 * Reports an invalid ledger configuration, failed calibration, or unowned request selection,
 * carrying the machine-readable `code`.
@@ -6206,15 +6158,14 @@ var LedgerError = class extends Error {
 function isLedgerError(value) {
 	return (0, _orkestrel_contract.isInstance)(value, LedgerError);
 }
-//#endregion
-//#region src/core/ledgers/helpers.ts
+// src/core/ledgers/helpers.ts
 /**
 * Collects the live message ids placed in records or left without a record.
 * @param projection - The projected records and unplaced ids
 * @returns The distinct live message ids
 * @example
 * ```ts
-* collectProjectionIds({ records: [], stale: [], orphans: ['message-1'] }) // Set { 'message-1' }
+* collectProjectionIds({ records: [], amendments: [], orphans: ['message-1'] }) // Set { 'message-1' }
 * ```
 */
 function collectProjectionIds(projection) {
@@ -6653,8 +6604,8 @@ function matchEntities(registry, text, partial) {
 * argument. A message that names no owner joins where its earlier side of an amendment pair joins,
 * or on the rules record when it is filed as a rule or a correction, and is an orphan otherwise.
 *
-* A sentence an amending message made stale is left out and listed in `stale`. An amending message
-* that is itself replaced keeps that effect, so the old value never revives.
+* Every live sentence is retained. Accepted direct edges are listed in `amendments`. An amending message
+* that is itself superseded retains its accepted edge without restoring its text.
 *
 * A sentence that opens with a pronoun takes the party named in the sentence before it. The reading
 * trusts capitals, so a capitalized word that is no person, such as a carrier named mid-sentence,
@@ -6662,7 +6613,7 @@ function matchEntities(registry, text, partial) {
 * the follow-up facts the records exist for.
 *
 * @param input - The messages, readings, entities, and classification to project
-* @returns The records with owner records ordered by their first member and the rules record last, the stale sentences, and the live message ids no record placed
+* @returns The records with owner records ordered by their first member and the rules record last, the accepted amendments, and the live message ids no record placed
 *
 * @example
 * ```ts
@@ -6687,8 +6638,7 @@ function buildRecords(input) {
 		earlier,
 		later
 	}))), (pair) => pair.later)].map(([later, pairs]) => [later, pairs.map((pair) => pair.earlier)]));
-	const stale = collectStale(input, byId, live);
-	const dead = new Set(stale.map((entry) => `${entry.source} ${entry.sentence}`));
+	const amendments = collectAmendments(input, byId, live);
 	const holders = [...input.owners.values()].flat();
 	const system = collectNames(input.system);
 	const settled = /* @__PURE__ */ new Map();
@@ -6703,7 +6653,7 @@ function buildRecords(input) {
 			id
 		}))), (entry) => entry.key)].map(([key, entries]) => {
 			const ids = entries.map((entry) => entry.id);
-			const lines = ids.flatMap((id) => buildLines(input, byId, id, dead, holders, system));
+			const lines = ids.flatMap((id) => buildLines(input, byId, id, holders, system));
 			const owner = key.slice(LEDGER_OWNER_PREFIX.length);
 			const holder = input.owners.get(owner)?.[0];
 			const title = key === "rules" ? "Rules" : holder === void 0 ? `account ${owner}` : `${holder} (account ${owner})`;
@@ -6717,17 +6667,19 @@ function buildRecords(input) {
 				}
 			};
 		}).sort((left, right) => Number(left.record.key === "rules") - Number(right.record.key === "rules") || left.first - right.first || (left.record.key < right.record.key ? -1 : left.record.key > right.record.key ? 1 : 0)).map(({ record }) => record),
-		stale,
+		amendments,
 		orphans
 	};
 }
 /**
-* Selects a request's view of the projected records.
+* Selects a request's records, collapsing owners with equal ordered member ids under titles joined with `; `.
 *
 * @remarks
 * The view holds the owner records the request names in the order it names them, then the rules
 * record with the lines whose topics meet the request's first, each group in position order. The
-* returned records and lines are copies.
+* returned records and lines are copies. Owner records with the same member ids in the same order
+* collapse into the first requested record, keeping its key, members, and lines and joining their
+* titles with `; ` before trimming.
 *
 * @param projection - The output of {@link buildRecords}
 * @param request - The owners and the desk topics the request names
@@ -6743,10 +6695,14 @@ function selectRecords(projection, request) {
 	const topics = new Set(request.topics);
 	const rules = projection.records.find((one) => one.key === LEDGER_RULES_KEY);
 	const sides = Map.groupBy((rules?.lines ?? []).filter(() => true), (line) => line.topics.some((topic) => topics.has(topic)));
-	return [...[...new Set(request.owners)].flatMap((owner) => {
+	const owners = [...new Set(request.owners)].flatMap((owner) => {
 		const record = projection.records.find((one) => one.key === `${LEDGER_OWNER_PREFIX}${owner}`);
-		return record === void 0 ? [] : [structuredClone(record)];
-	}), ...rules === void 0 ? [] : [structuredClone({
+		return record === void 0 ? [] : [record];
+	});
+	return [...[...Map.groupBy(owners, (record) => JSON.stringify(record.members)).values()].flatMap(([record, ...rest]) => record === void 0 ? [] : [structuredClone({
+		...record,
+		title: [record.title, ...rest.map((one) => one.title)].join("; ")
+	})]), ...rules === void 0 ? [] : [structuredClone({
 		...rules,
 		lines: [...sides.get(true) ?? [], ...sides.get(false) ?? []]
 	})]];
@@ -6758,6 +6714,7 @@ function selectRecords(projection, request) {
 * The briefing joins rendered records with one blank line.
 *
 * @param record - A record or view with a `title` and `lines`
+* @param context - Rendering facts for optional accepted amendment annotations
 * @returns `## TITLE` followed by `- LINE` for each line
 *
 * @example
@@ -6766,13 +6723,14 @@ function selectRecords(projection, request) {
 * // '## Rules\n- Refunds need a manager.'
 * ```
 */
-function renderLedgerRecord(record) {
-	return [`## ${record.title}`, ...record.lines.map((line) => `- ${line.text}`)].join("\n");
+function renderLedgerRecord(record, context) {
+	return [`## ${record.title}`, ...record.lines.flatMap((line) => [context === void 0 ? "" : renderLedgerAnnotation(line, context), `- ${line.text}`].filter((text) => text !== ""))].join("\n");
 }
 /**
 * Renders one owner record under a `###` heading, which the briefing nests under its one `## Pinned` heading.
 *
 * @param record - An owner record or view with a `title` and `lines`
+* @param context - Rendering facts for optional accepted amendment annotations
 * @returns `### TITLE` followed by `- LINE` for each line
 *
 * @example
@@ -6780,8 +6738,57 @@ function renderLedgerRecord(record) {
 * renderLedgerPinned({ title: 'Odile Marlow (account OM-30418)', lines: [] }) // '### Odile Marlow (account OM-30418)'
 * ```
 */
-function renderLedgerPinned(record) {
-	return `#${renderLedgerRecord(record)}`;
+function renderLedgerPinned(record, context) {
+	return `#${renderLedgerRecord(record, context)}`;
+}
+/**
+* Derives complete source identities, first occurrences, and local references from the actual briefing lines.
+* @param messages - Original messages whose indexed sentences establish completeness
+* @param lines - Retained lines in rendering order after deduplication and trimming
+* @param amendments - Accepted direct message amendment edges
+* @returns Immutable rendering facts for this retained population
+*
+* @example
+* ```ts
+* buildLedgerRenderContext([], [], []).complete.size // 0
+* ```
+*/
+function buildLedgerRenderContext(messages, lines, amendments) {
+	const identities = new Set(lines.map((line) => `${line.source} ${line.sentence}`));
+	return {
+		amendments,
+		complete: new Set(messages.filter((message) => {
+			const sentences = splitSentences(message.content);
+			return sentences.length > 0 && sentences.every((_, index) => identities.has(`${message.id} ${index}`));
+		}).map((message) => message.id)),
+		first: new Map(lines.toReversed().map((line) => [line.source, line])),
+		references: new Map([...new Set(lines.map((line) => line.source))].map((source, index) => [source, String(index + 1)]))
+	};
+}
+/**
+* Renders source framing and unresolved amendment scope at a source's first retained line.
+* @param line - The retained occurrence to annotate
+* @param context - Actual complete sources, first occurrences, local references, and accepted amendment edges
+* @returns Source framing and truthful inclusion notes, or empty text for an unrelated or repeated occurrence
+* @throws {LedgerError} Thrown when the context holds no reference for the annotated source or a fully included amender (code `'REQUEST'`)
+*
+* @example
+* ```ts
+* renderLedgerAnnotation({ text: 'Unchanged.', source: 'user-1', sentence: 0, topics: [], role: 'user' }, buildLedgerRenderContext([], [], [])) // ''
+* ```
+*/
+function renderLedgerAnnotation(line, context) {
+	if (context.first.get(line.source) !== line) return "";
+	const amendments = context.amendments.filter((pair) => pair.earlier === line.source);
+	const endpoint = context.complete.has(line.source) && context.amendments.some((pair) => pair.later === line.source && context.first.has(pair.earlier));
+	if (amendments.length === 0 && !endpoint) return "";
+	const included = amendments.filter((pair) => context.complete.has(pair.later));
+	if (context.references.get(line.source) === void 0 || included.some((pair) => context.references.get(pair.later) === void 0)) throw new LedgerError("REFERENCE", "Ledger rendering requires retained source references");
+	return [
+		`[Ledger source ${context.references.get(line.source)}]`,
+		...included.map((pair) => `Accepted later amendment [Ledger source ${context.references.get(pair.later)}] is fully included in this briefing. Sentence scope is unresolved.`),
+		...amendments.some((pair) => !context.complete.has(pair.later)) ? ["Accepted later amendment text is not fully included in this briefing. Sentence scope is unresolved."] : []
+	].join("\n");
 }
 /**
 * Splits a recall topic at its joints.
@@ -6977,74 +6984,62 @@ function placeMember(input, links, amending, id, seen, settled) {
 	return keys;
 }
 /**
-* Collects the sentences that live messages made stale.
+* Collects accepted direct amendments of live messages.
 *
 * @remarks
-* A sentence of a live message is stale when it shares an id or a number with a message that
-* amends it. An amending message takes effect while it is live, and keeps its effect after another
-* message supersedes it, so the value it replaced never revives. A user or tool message that the
-* input excludes or files quiet never takes effect.
+* An accepted edge relates an earlier live message to an amender without claiming which sentences
+* changed. An amender takes effect while live and retains its edge after another message supersedes
+* it, without restoring the superseded text. An excluded or quiet user or tool message has no effect.
 *
 * @param input - The exclusions and classification to read
 * @param byId - The messages by id
 * @param live - The live message ids from {@link collectLive}
-* @returns The stale sentences in conversation order, each with the tokens it shares
+* @returns The distinct accepted direct edges in conversation order
 *
 * @example
 * ```ts
-* collectStale(input, byId, ['user-1', 'user-3']) // [{ source: 'user-1', sentence: 1, tokens: ['ESC-2291'] }]
+* collectAmendments(input, byId, ['user-1', 'user-3']) // [{ earlier: 'user-1', later: 'user-3' }]
 * ```
 */
-function collectStale(input, byId, live) {
+function collectAmendments(input, byId, live) {
 	const { classification } = input;
 	const excluded = new Set(input.exclusions);
+	const living = new Set(live);
+	const ordered = [...new Set(input.messages.map((message) => message.id))];
+	const positions = new Map(ordered.map((id, index) => [id, index]));
 	const effective = /* @__PURE__ */ new Set([...live, ...[...byId.values()].filter((message) => message.role !== "assistant" && !excluded.has(message.id) && !classification.quiet.has(message.id) && (classification.supersessions.get(message.id) ?? []).length > 0).map((message) => message.id)]);
-	return live.flatMap((id) => {
-		const laters = (classification.amendments.get(id) ?? []).filter((later) => effective.has(later)).flatMap((later) => {
-			const message = byId.get(later);
-			return message === void 0 ? [] : [extractTokens(message.content)];
-		});
-		if (laters.length === 0) return [];
-		return splitSentences(byId.get(id)?.content ?? "").flatMap((text, sentence) => {
-			const own = extractTokens(text);
-			const tokens = new Set(laters.flatMap((other) => [...[...own.ids].filter((token) => other.ids.has(token)), ...[...own.numbers].filter((token) => other.numbers.has(token)).map(String)]));
-			return tokens.size > 0 ? [{
-				source: id,
-				sentence,
-				tokens: [...tokens]
-			}] : [];
-		});
-	});
+	return ordered.filter((id) => living.has(id)).flatMap((earlier) => [...new Set(classification.amendments.get(earlier) ?? [])].filter((later) => effective.has(later) && positions.has(later)).sort((a, b) => (positions.get(a) ?? 0) - (positions.get(b) ?? 0)).map((later) => ({
+		earlier,
+		later
+	})));
 }
 /**
 * Builds the record lines of one message.
 *
 * @remarks
-* Each sentence that is not stale becomes a line. A sentence that opens with a pronoun and follows
+* Each original indexed sentence becomes a line. A sentence that opens with a pronoun and follows
 * another sentence takes the last name of the sentence before it that is neither an owner name nor
 * a system name, and its line text opens with that party and a colon.
 *
 * @param input - The classification whose topics the lines carry
 * @param byId - The messages by id
 * @param id - The message id
-* @param dead - The stale sentences as `SOURCE SENTENCE` keys
 * @param holders - The owner names, which never serve as a party
 * @param system - The system text's names, which never serve as a party
 * @returns The lines in sentence order; empty when the message is absent
 *
 * @example
 * ```ts
-* buildLines(input, byId, 'user-1', new Set(), [], []).map((line) => line.text)
+* buildLines(input, byId, 'user-1', [], []).map((line) => line.text)
 * // ['Odile Marlow phoned about BW-5512.', 'Odile Marlow: She wants a refund.']
 * ```
 */
-function buildLines(input, byId, id, dead, holders, system) {
+function buildLines(input, byId, id, holders, system) {
 	const message = byId.get(id);
 	if (message === void 0) return [];
 	const sentences = splitSentences(message.content);
 	const topics = input.classification.topics.get(id) ?? [];
 	return sentences.flatMap((sentence, at) => {
-		if (dead.has(`${id} ${at}`)) return [];
 		const party = /^(?:He|She|They|His|Her|Their)(?![\p{L}\p{N}])/u.test(sentence) && at > 0 ? collectNames(sentences[at - 1] ?? "").filter((name) => !holders.includes(name) && !system.includes(name)).at(-1) : void 0;
 		const line = {
 			text: party === void 0 ? sentence : `${party}: ${sentence}`,
@@ -7059,8 +7054,7 @@ function buildLines(input, byId, id, dead, holders, system) {
 		}];
 	});
 }
-//#endregion
-//#region src/core/ledgers/Classifier.ts
+// src/core/ledgers/Classifier.ts
 /**
 * Files messages through the conversation's judgment manager and reads their categories and corrections.
 *
@@ -7346,8 +7340,7 @@ var Classifier = class {
 		}
 	}
 };
-//#endregion
-//#region src/core/ledgers/validators.ts
+// src/core/ledgers/validators.ts
 /**
 * Checks whether a value is finite and lies in the interval (0, 1].
 * @param value - The value to inspect
@@ -7372,8 +7365,7 @@ function isFraction(value) {
 function isPositiveSafeInteger(value) {
 	return (0, _orkestrel_contract.isFiniteNumber)(value) && Number.isSafeInteger(value) && value > 0;
 }
-//#endregion
-//#region src/core/ledgers/Gauge.ts
+// src/core/ledgers/Gauge.ts
 /**
 * Prices prompts in tokens from a measured scale and overhead cost, and measures the room a request
 * has left.
@@ -7466,8 +7458,7 @@ var Gauge = class {
 		if ((0, _orkestrel_contract.isFiniteNumber)(reply?.completion)) this.#reply = Math.max(this.#reply, reply.completion - (reply.thinking ?? 0));
 	}
 };
-//#endregion
-//#region src/core/ledgers/LedgerPass.ts
+// src/core/ledgers/LedgerPass.ts
 /**
 * Holds what one pass of a ledger request keeps: the selection its run adopted last, the
 * conversation boundary its calls count additions from, its summed usage, and its gauge calls.
@@ -7611,8 +7602,7 @@ var LedgerPass = class {
 		this.#log = [...this.#log, { thinking }];
 	}
 };
-//#endregion
-//#region src/core/ledgers/LedgerRequest.ts
+// src/core/ledgers/LedgerRequest.ts
 /**
 * Holds what one ledger request keeps while it is served: its message, its filing readings and
 * plan, the gauge calls of its passes, and its repeat and recall stops.
@@ -7765,8 +7755,7 @@ var LedgerRequest = class {
 		return this.#listings.get(result);
 	}
 };
-//#endregion
-//#region src/core/ledgers/Ledger.ts
+// src/core/ledgers/Ledger.ts
 /**
 * Serves one conversation through classified records, a bounded briefing, and a final answer pass.
 * @example
@@ -8124,17 +8113,17 @@ var Ledger = class {
 			projection: buildRecords(input)
 		};
 	}
-	#projectLines(input, projection, id) {
-		return buildLines(input, new Map(input.messages.map((message) => [message.id, message])), id, new Set(projection.stale.map((line) => `${line.source} ${line.sentence}`)), [...input.owners.values()].flat(), collectNames(this.#options.system));
+	#projectLines(input, id) {
+		return buildLines(input, new Map(input.messages.map((message) => [message.id, message])), id, [...input.owners.values()].flat(), collectNames(this.#options.system));
 	}
-	#renderSource(id, lines) {
+	#renderSource(id, lines, context) {
 		const message = this.#conversation.message(id);
 		if (message === void 0) return "";
 		const sentences = splitSentences(message.content);
-		const text = sentences.length === lines.length ? message.content : lines.map((line) => sentences[line.sentence] ?? "").join(" ");
-		if (text === "" || message.role !== "tool") return text;
+		const text = sentences.every((_, index) => lines.some((line) => line.sentence === index)) ? message.content : lines.map((line) => sentences[line.sentence] ?? "").join(" ");
+		if (text === "") return "";
 		const reading = this.#readLookups().find((one) => one.id === id);
-		return reading === void 0 ? text : `${renderLookupCall(reading.name, reading.arguments)}: ${text}`;
+		return [...lines.map((line) => renderLedgerAnnotation(line, context)), message.role !== "tool" || reading === void 0 ? text : `${renderLookupCall(reading.name, reading.arguments)}: ${text}`].filter((part) => part !== "").join("\n");
 	}
 	#collectAfter(request) {
 		const messages = this.#conversation.messages();
@@ -8217,7 +8206,7 @@ var Ledger = class {
 			const score = [...words].filter((word) => asked?.words.has(word)).reduce((sum, word) => sum + Math.log(texts.length / (counts.get(word) ?? 1)), 0);
 			return [{
 				source: message.id,
-				lines: this.#projectLines(input, projection, message.id),
+				lines: this.#projectLines(input, message.id),
 				position,
 				group,
 				ruled,
@@ -8251,7 +8240,7 @@ var Ledger = class {
 			source: unit.source,
 			record: this.#buildUnitRecord(unit.source, unit.category, input, projection, held)
 		}));
-		const trimmed = this.#trim(steps, records, mapped, new Set(ordered.map((unit) => unit.source)), cap);
+		const trimmed = this.#trim(steps, records, mapped, new Set(ordered.map((unit) => unit.source)), cap, projection.amendments);
 		const briefing = trimmed.briefing;
 		const shown = /* @__PURE__ */ new Set([...trimmed.included, ...records.flatMap((record) => record.members.filter((source) => {
 			const full = record.lines.filter((line) => line.source === source);
@@ -8263,10 +8252,10 @@ var Ledger = class {
 			...briefing === "" ? {} : { briefing }
 		};
 	}
-	#trim(steps, records, mapped, included, cap) {
+	#trim(steps, records, mapped, included, cap, amendments) {
 		const trimmed = steps.reduce((cut, step) => {
 			if (cut.briefing !== void 0) return cut;
-			const briefing = this.#render(cut.records, mapped, cut.included);
+			const briefing = this.#render(cut.records, mapped, cut.included, amendments);
 			const content = [this.#options.system, briefing].filter((part) => part !== "").join("\n\n");
 			if (this.#price([{
 				id: "system",
@@ -8292,7 +8281,7 @@ var Ledger = class {
 		return {
 			records: trimmed.records,
 			included: trimmed.included,
-			briefing: trimmed.briefing ?? this.#render(trimmed.records, mapped, trimmed.included)
+			briefing: trimmed.briefing ?? this.#render(trimmed.records, mapped, trimmed.included, amendments)
 		};
 	}
 	#buildUnitRecord(source, category, input, projection, held) {
@@ -8305,25 +8294,33 @@ var Ledger = class {
 	}
 	#collectAmended(input, projection, source, held) {
 		const live = collectProjectionIds(projection);
-		return scanAmendments(input.classification.amendments, source, (id) => id === source || !held.has(id) && live.has(id)).flatMap((id) => this.#projectLines(input, projection, id));
+		return scanAmendments(input.classification.amendments, source, (id) => id === source || !held.has(id) && live.has(id)).flatMap((id) => this.#projectLines(input, id));
 	}
-	#render(records, mapped, included) {
-		const owners = records.filter((record) => record.key !== "rules" && record.lines.length > 0).map(renderLedgerPinned).join("\n\n");
+	#render(records, mapped, included, amendments) {
 		const entries = mapped.filter((unit) => included.has(unit.source)).flatMap(({ record: unit }) => [...Map.groupBy(unit.lines, (line) => line.source)].map(([source, lines]) => ({
 			unit,
 			source,
 			lines
 		})));
 		const first = new Map(entries.toReversed().map((entry) => [entry.source, entry]));
-		const rendered = entries.filter((entry) => first.get(entry.source) === entry).map(({ unit, source, lines }) => ({
+		const unique = entries.filter((entry) => first.get(entry.source) === entry);
+		const record = records.find((candidate) => candidate.key === "rules" && candidate.lines.length > 0);
+		const ownerRecords = records.filter((candidate) => candidate.key !== "rules" && candidate.lines.length > 0);
+		const context = buildLedgerRenderContext(this.#conversation.messages(), [
+			...ownerRecords.flatMap((candidate) => candidate.lines),
+			...unique.filter((entry) => entry.unit.key !== LEDGER_RULES_KEY).flatMap((entry) => entry.lines),
+			...record?.lines ?? [],
+			...unique.filter((entry) => entry.unit.key === LEDGER_RULES_KEY).flatMap((entry) => entry.lines)
+		], amendments);
+		const owners = ownerRecords.map((owner) => renderLedgerPinned(owner, context)).join("\n\n");
+		const rendered = unique.map(({ unit, source, lines }) => ({
 			rules: unit.key === LEDGER_RULES_KEY,
-			texts: unit.key === "rules" && source === unit.members[0] ? lines.map((line) => this.#renderSource(source, [line])) : [this.#renderSource(source, lines)]
+			texts: unit.key === "rules" && source === unit.members[0] ? lines.map((line) => this.#renderSource(source, [line], context)) : [this.#renderSource(source, lines, context)]
 		}));
 		const pinned = rendered.filter((one) => !one.rules).flatMap((one) => one.texts);
 		const rules = rendered.filter((one) => one.rules).flatMap((one) => one.texts);
 		const body = [owners, pinned.join("\n")].filter((text) => text !== "").join("\n\n");
-		const record = records.find((candidate) => candidate.key === "rules" && candidate.lines.length > 0);
-		return [body === "" ? "" : `## Pinned\n${body}`, record === void 0 ? rules.length === 0 ? "" : ["## Rules", ...rules].join("\n") : [renderLedgerRecord(record), ...rules].join("\n")].filter((text) => text !== "").join("\n\n");
+		return [body === "" ? "" : `## Pinned\n${body}`, record === void 0 ? rules.length === 0 ? "" : ["## Rules", ...rules].join("\n") : [renderLedgerRecord(record, context), ...rules].join("\n")].filter((text) => text !== "").join("\n\n");
 	}
 	#selectTail(request, cap, input) {
 		const first = input.messages.findIndex((message) => this.#requests.has(message.id));
@@ -8463,8 +8460,7 @@ var Ledger = class {
 		return lines.length === 0 ? void 0 : `${LEDGER_NOTES.results}\n${lines.join("\n")}`;
 	}
 };
-//#endregion
-//#region src/core/ledgers/factories.ts
+// src/core/ledgers/factories.ts
 /**
 * Creates a conversation ledger after checking its thresholds, allocation, and tool names.
 * @param provider - The provider that answers requests
@@ -8480,7 +8476,6 @@ var Ledger = class {
 function createLedger(provider, options) {
 	return new Ledger(provider, options);
 }
-//#endregion
 exports.Agent = Agent;
 exports.AgentContext = AgentContext;
 exports.AgentError = AgentError;
@@ -8554,6 +8549,7 @@ exports.attachImages = attachImages;
 exports.attachUserImages = attachUserImages;
 exports.buildJudgeResult = buildJudgeResult;
 exports.buildJudgments = buildJudgments;
+exports.buildLedgerRenderContext = buildLedgerRenderContext;
 exports.buildLines = buildLines;
 exports.buildProviderHeaders = buildProviderHeaders;
 exports.buildProviderResult = buildProviderResult;
@@ -8562,13 +8558,13 @@ exports.buildRecapMessage = buildRecapMessage;
 exports.buildRecords = buildRecords;
 exports.buildSummaryMessage = buildSummaryMessage;
 exports.chargeUsage = chargeUsage;
+exports.collectAmendments = collectAmendments;
 exports.collectExchanges = collectExchanges;
 exports.collectImageData = collectImageData;
 exports.collectLive = collectLive;
 exports.collectNames = collectNames;
 exports.collectProjectionIds = collectProjectionIds;
 exports.collectRegistry = collectRegistry;
-exports.collectStale = collectStale;
 exports.collectToolGroups = collectToolGroups;
 exports.computeReading = computeReading;
 exports.computeThinking = computeThinking;
@@ -8658,6 +8654,7 @@ exports.removeEntries = removeEntries;
 exports.renderCauseChain = renderCauseChain;
 exports.renderFencedFile = renderFencedFile;
 exports.renderJSON = renderJSON;
+exports.renderLedgerAnnotation = renderLedgerAnnotation;
 exports.renderLedgerPinned = renderLedgerPinned;
 exports.renderLedgerRecord = renderLedgerRecord;
 exports.renderLookupCall = renderLookupCall;