@orkestrel/agent 0.0.31 → 0.0.33

package/dist/src/core/index.js

@@ -1,4 +1,4 @@
-import { ContractError, arrayOf, arrayShape, attempt, booleanShape, boundsOf, canonicalStringify, cloneJSONValue, createContract, isArray, isBoolean, isError, isFiniteNumber, isInstance, isJSONValue, isNumber, isObject, isRecord, isString, jsonShape, literalShape, nullableOf, numberShape, objectOf, objectShape, optionalOf, optionalShape, parseJSON, parseJSONAs, parseJSONValue, preview, rawShape, recordOf, recordShape, stringShape, unionShape } from "@orkestrel/contract";
+import { ContractError, INTRINSICS, arrayOf, arrayShape, attempt, booleanShape, boundsOf, canonicalStringify, cloneJSONValue, createContract, holds, isArray, isBoolean, isError, isFiniteNumber, isFunction, isJSONValue, isNumber, isObject, isRecord, isString, jsonShape, literalShape, nullableOf, numberShape, objectOf, objectShape, optionalOf, optionalShape, parseJSON, parseJSONAs, parseJSONValue, preview, rawShape, recordOf, recordShape, stringShape, unionShape } from "@orkestrel/contract";
 import { createTokenBudget, createTokenMeter, isBudget, isBudgetError, isTokenUsage } from "@orkestrel/budget";
 import { Timeout, createTimeout } from "@orkestrel/timeout";
 import { createDatabase, createMemoryDriver } from "@orkestrel/database";
@@ -8,7 +8,7 @@ import { WorkspaceManager, isBinary, isText } from "@orkestrel/workspace";
 import { createQueue } from "@orkestrel/queue";
 import { createRunner, errorToMessage } from "@orkestrel/workflow";
 import { createAbort } from "@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
@@ -20,8 +20,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
@@ -40,11 +39,12 @@ var JudgeAbortError = class extends Error {
 	constructor(partial, options) {
 		super("judge call aborted", options);
 		this.name = "JudgeAbortError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.JudgeAbortError"), { value: this });
 		this.partial = partial;
 	}
 };
 /**
-* Narrows a caught value to a {@link JudgeAbortError} through `instanceof`, so a `catch` can
+* Narrows a caught value to a {@link JudgeAbortError} through its identity brand and declared members, so a `catch` can
 * recover its `partial` result.
 *
 * @param value - The caught value
@@ -55,10 +55,29 @@ var JudgeAbortError = class extends Error {
 * ```
 */
 function isJudgeAbortError(value) {
-	return isInstance(value, JudgeAbortError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.JudgeAbortError"))?.value === value)) return false;
+		if (!(INTRINSICS.reflect.read(value, "code") === "ABORT")) return false;
+		const partial = INTRINSICS.reflect.read(value, "partial");
+		if (!(isObject(partial) || isFunction(partial))) return false;
+		const answers = INTRINSICS.reflect.read(partial, "answers");
+		const refusals = INTRINSICS.reflect.read(partial, "refusals");
+		const usage = INTRINSICS.reflect.read(partial, "usage");
+		return isString(INTRINSICS.reflect.read(partial, "model")) && (usage === void 0 || (isObject(usage) || isFunction(usage)) && [
+			"prompt",
+			"completion",
+			"total"
+		].every((key) => isNumber(INTRINSICS.reflect.read(usage, key)))) && (isObject(answers) || isFunction(answers)) && INTRINSICS.values(answers).every((answer) => {
+			if (!(isObject(answer) || isFunction(answer))) return false;
+			const form = INTRINSICS.reflect.read(answer, "form");
+			if (form === "noul") return isNumber(INTRINSICS.reflect.read(answer, "noul"));
+			const probabilities = INTRINSICS.reflect.read(answer, "probabilities");
+			if (form === "score") return arrayOf(isNumber)(probabilities);
+			return form === "choice" && (isObject(probabilities) || isFunction(probabilities)) && INTRINSICS.values(probabilities).every(isNumber);
+		}) && (refusals === void 0 || (isObject(refusals) || isFunction(refusals)) && INTRINSICS.values(refusals).every((refusal) => (isObject(refusal) || isFunction(refusal)) && arrayOf(isString)(INTRINSICS.reflect.read(refusal, "missing"))));
+	});
 }
-//#endregion
-//#region src/core/shapers.ts
+// src/core/shapers.ts
 /**
 * Describes a tool call's JSON wire projection.
 *
@@ -88,12 +107,10 @@ var messageShape = objectShape({
 	images: optionalShape(arrayShape(stringShape())),
 	thinking: optionalShape(stringShape())
 });
-//#endregion
-//#region src/core/contracts.ts
+// src/core/contracts.ts
 /** Validates and projects conversation messages at a JSON wire boundary. */
 var messageContract = 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.
 *
@@ -115,8 +132,7 @@ function copyJSON(value) {
 	if (!text.success || typeof text.value !== "string") return void 0;
 	return 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
@@ -455,8 +471,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.
 *
@@ -533,8 +548,7 @@ function isJudgeQuestion(value) {
 function isNonNegativeSafeInteger(value) {
 	return 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
@@ -600,8 +614,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
@@ -622,11 +635,12 @@ var ProviderAbortError = class extends Error {
 	constructor(partial, options) {
 		super("provider stream aborted", options);
 		this.name = "ProviderAbortError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.ProviderAbortError"), { value: this });
 		this.partial = partial;
 	}
 };
 /**
-* Narrows an unknown caught value to a {@link ProviderAbortError} through `instanceof`, so a
+* Narrows an unknown caught value to a {@link ProviderAbortError} through its identity brand and declared members, so a
 * `catch` can recover its `partial` result.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -642,7 +656,19 @@ var ProviderAbortError = class extends Error {
 * ```
 */
 function isProviderAbortError(value) {
-	return isInstance(value, ProviderAbortError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.ProviderAbortError"))?.value === value)) return false;
+		if (!(INTRINSICS.reflect.read(value, "code") === "ABORT")) return false;
+		const partial = INTRINSICS.reflect.read(value, "partial");
+		if (!(isObject(partial) || isFunction(partial))) return false;
+		const usage = INTRINSICS.reflect.read(partial, "usage");
+		const tools = INTRINSICS.reflect.read(partial, "tools");
+		return isString(INTRINSICS.reflect.read(partial, "content")) && (INTRINSICS.reflect.read(partial, "thinking") === void 0 || isString(INTRINSICS.reflect.read(partial, "thinking"))) && (INTRINSICS.reflect.read(partial, "truncated") === void 0 || isBoolean(INTRINSICS.reflect.read(partial, "truncated"))) && (usage === void 0 || (isObject(usage) || isFunction(usage)) && [
+			"prompt",
+			"completion",
+			"total"
+		].every((key) => isNumber(INTRINSICS.reflect.read(usage, key)))) && (tools === void 0 || arrayOf((tool) => (isObject(tool) || isFunction(tool)) && isString(INTRINSICS.reflect.read(tool, "id")) && isString(INTRINSICS.reflect.read(tool, "name")) && (isObject(INTRINSICS.reflect.read(tool, "arguments")) || isFunction(INTRINSICS.reflect.read(tool, "arguments"))))(tools));
+	});
 }
 /**
 * Reports a coded provider failure with its HTTP status and underlying cause when available.
@@ -661,12 +687,13 @@ var ProviderError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options);
 		this.name = "ProviderError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.ProviderError"), { value: this });
 		this.code = code;
 		this.status = options?.status;
 	}
 };
 /**
-* Narrows a caught value to the provider failure class through `instanceof`.
+* Narrows a caught value to the provider failure class through its identity brand and declared members.
 *
 * @param value - The caught value
 * @returns True if the value is a provider failure; false otherwise
@@ -676,7 +703,13 @@ var ProviderError = class extends Error {
 * ```
 */
 function isProviderError(value) {
-	return isInstance(value, ProviderError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.ProviderError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "HTTP" || code === "PROTOCOL" || code === "PROVIDER")) return false;
+		const status = INTRINSICS.reflect.read(value, "status");
+		return status === void 0 || isNumber(status);
+	});
 }
 /**
 * Reports a coded judge failure with its HTTP status and underlying cause when available.
@@ -695,12 +728,13 @@ var JudgeError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options);
 		this.name = "JudgeError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.JudgeError"), { value: this });
 		this.code = code;
 		this.status = options?.status;
 	}
 };
 /**
-* Narrows a caught value to the judge failure class through `instanceof`.
+* Narrows a caught value to the judge failure class through its identity brand and declared members.
 *
 * @param value - The caught value
 * @returns True if the value is a {@link JudgeError}; false otherwise
@@ -710,10 +744,15 @@ var JudgeError = class extends Error {
 * ```
 */
 function isJudgeError(value) {
-	return isInstance(value, JudgeError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.JudgeError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "HTTP" || code === "PROTOCOL" || code === "QUESTION")) return false;
+		const status = INTRINSICS.reflect.read(value, "status");
+		return status === void 0 || isNumber(status);
+	});
 }
-//#endregion
-//#region src/core/providers/shapers.ts
+// src/core/providers/shapers.ts
 /**
 * Describes a provider request's JSON wire projection.
 *
@@ -773,16 +812,14 @@ var relayFrameShape = unionShape(objectShape({
 	channel: literalShape(["error"]),
 	message: 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 = createContract(providerRequestShape);
 /** Validates and projects provider results at a JSON wire boundary. */
 var providerResultContract = createContract(providerResultShape);
 /** Validates and projects channel-discriminated relay frames at a JSON wire boundary. */
 var relayFrameContract = createContract(relayFrameShape);
-//#endregion
-//#region src/core/providers/helpers.ts
+// src/core/providers/helpers.ts
 /**
 * Assembles a provider result with only populated optional fields.
 *
@@ -1263,8 +1300,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.
 *
@@ -1372,8 +1408,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
@@ -1491,8 +1526,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.
 *
@@ -1703,8 +1737,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.
 *
@@ -1821,8 +1854,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.
@@ -1962,8 +1994,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.
 *
@@ -2021,8 +2052,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.
 *
@@ -2123,8 +2153,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.
 *
@@ -2283,8 +2312,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
@@ -2311,8 +2339,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
@@ -2349,12 +2376,13 @@ var ConversationError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options?.cause === void 0 ? void 0 : { cause: options.cause });
 		this.name = "ConversationError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.ConversationError"), { value: this });
 		this.code = code;
 		this.context = options?.context;
 	}
 };
 /**
-* Narrows an unknown caught value to a {@link ConversationError} through `instanceof`, so a
+* Narrows an unknown caught value to a {@link ConversationError} through its identity brand and declared members, so a
 * `catch` can branch on its `code`.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -2370,10 +2398,15 @@ var ConversationError = class extends Error {
 * ```
 */
 function isConversationError(value) {
-	return isInstance(value, ConversationError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.ConversationError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "SUMMARIZER" || code === "SECTIONS" || code === "JUDGMENT" || code === "KEEP")) return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || isObject(context) || isFunction(context);
+	});
 }
-//#endregion
-//#region src/core/conversations/validators.ts
+// src/core/conversations/validators.ts
 /**
 * Checks whether a value satisfies the domain conversation-message contract.
 *
@@ -2515,8 +2548,7 @@ function isConversationSnapshot(value) {
 		judgments: optionalOf(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.
 *
@@ -2725,8 +2757,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.
 *
@@ -2822,8 +2853,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,
@@ -3041,8 +3071,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
@@ -3164,8 +3193,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
@@ -3238,8 +3266,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
@@ -3346,8 +3373,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
@@ -3522,8 +3548,7 @@ function createDatabaseConversationStore(driver = createMemoryDriver()) {
 		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
@@ -3539,8 +3564,7 @@ function createDatabaseConversationStore(driver = createMemoryDriver()) {
 * `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
@@ -3575,8 +3599,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,
@@ -3667,8 +3690,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
@@ -3839,8 +3861,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
@@ -3900,8 +3921,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,
@@ -3968,8 +3988,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
@@ -4123,8 +4142,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.
@@ -4268,8 +4286,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
@@ -4296,8 +4313,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
@@ -4323,11 +4339,12 @@ var AgentJobError = class extends Error {
 	constructor(message, partial) {
 		super(message);
 		this.name = "AgentJobError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.AgentJobError"), { value: this });
 		this.partial = partial;
 	}
 };
 /**
-* Narrows an unknown caught value to an {@link AgentJobError} through `instanceof`, so a
+* Narrows an unknown caught value to an {@link AgentJobError} through its identity brand and declared members, so a
 * `catch` can recover its `partial` result.
 *
 * @param value - The value to test (typically a `catch` binding or a rejected enqueue)
@@ -4343,7 +4360,30 @@ var AgentJobError = class extends Error {
 * ```
 */
 function isAgentJobError(value) {
-	return isInstance(value, AgentJobError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.AgentJobError"))?.value === value)) return false;
+		if (!(INTRINSICS.reflect.read(value, "code") === "PARTIAL")) return false;
+		const partial = INTRINSICS.reflect.read(value, "partial");
+		if (!(isObject(partial) || isFunction(partial))) return false;
+		const usage = INTRINSICS.reflect.read(partial, "usage");
+		const stop = INTRINSICS.reflect.read(partial, "stop");
+		if (stop !== void 0) {
+			if (!(isObject(stop) || isFunction(stop))) return false;
+			const layer = INTRINSICS.reflect.read(stop, "layer");
+			const spent = INTRINSICS.reflect.read(stop, "usage");
+			if (!isString(INTRINSICS.reflect.read(stop, "id")) || !(INTRINSICS.reflect.read(stop, "estimate") === void 0 || isNumber(INTRINSICS.reflect.read(stop, "estimate"))) || !(spent === void 0 || (isObject(spent) || isFunction(spent)) && [
+				"prompt",
+				"completion",
+				"total"
+			].every((key) => isNumber(INTRINSICS.reflect.read(spent, key))))) return false;
+			if (layer !== "model" && !((layer === "meter" || layer === "budget") && isNumber(INTRINSICS.reflect.read(stop, "max")) && isNumber(INTRINSICS.reflect.read(stop, "consumed")))) return false;
+		}
+		return isString(INTRINSICS.reflect.read(partial, "content")) && (INTRINSICS.reflect.read(partial, "thinking") === void 0 || isString(INTRINSICS.reflect.read(partial, "thinking"))) && isBoolean(INTRINSICS.reflect.read(partial, "partial")) && (usage === void 0 || (isObject(usage) || isFunction(usage)) && [
+			"prompt",
+			"completion",
+			"total"
+		].every((key) => isNumber(INTRINSICS.reflect.read(usage, key))));
+	});
 }
 /**
 * Reports a run sharing accounting with a live run, a `limit` that is not a nonnegative safe integer, a name absent from a registry pool, or a strict run whose request exceeds its window. Agent construction, the `stream` and `generate` methods, and registry accessors throw synchronously, before returning a handle or promise; a `'WINDOW'` refusal rejects the run's `result` instead. Await the call inside `try`/`catch` to catch it.
@@ -4379,12 +4419,13 @@ var AgentError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options?.cause === void 0 ? void 0 : { cause: options.cause });
 		this.name = "AgentError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.AgentError"), { value: this });
 		this.code = code;
 		this.context = options?.context;
 	}
 };
 /**
-* Narrows an unknown caught value to an {@link AgentError} through `instanceof`, so a `catch`
+* Narrows an unknown caught value to an {@link AgentError} through its identity brand and declared members, so a `catch`
 * can branch on its `code`.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -4400,10 +4441,15 @@ var AgentError = class extends Error {
 * ```
 */
 function isAgentError(value) {
-	return isInstance(value, AgentError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.AgentError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "CONCURRENCY" || code === "LIMIT" || code === "REGISTRY" || code === "WINDOW")) return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || isObject(context) || isFunction(context);
+	});
 }
-//#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
@@ -4473,8 +4519,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,
@@ -4701,7 +4746,7 @@ function estimateTokens(text) {
 function estimateMessages(messages) {
 	return messages.reduce((sum, message) => {
 		const measure = measureMessage(message);
-		return sum + measure.content + measure.framing + measure.calls + measure.thinking + measure.images;
+		return sum + measure.content + measure.uniform + measure.calls + measure.thinking + measure.images;
 	}, 0);
 }
 /**
@@ -4711,7 +4756,7 @@ function estimateMessages(messages) {
 * @remarks
 * The result is a structural estimate, not a tokenizer allocation. `id` and `role` are joins back to
 * the message, not token components, and a provider's template effects and the estimation error are
-* not individually attributed. `content` is `ceil(length / 4)`, `framing` is
+* not individually attributed. `content` is `ceil(length / 4)`, `uniform` is
 * {@link import('./constants.js').MESSAGE_TOKEN_OVERHEAD}, `calls` is the estimate of the JSON-rendered
 * calls (`0` when the message carries none, the framing overhead when they cannot be rendered),
 * `thinking` is the estimate of the thinking (`0` when absent), and `images` is the attached image
@@ -4723,7 +4768,7 @@ function estimateMessages(messages) {
 * @example
 * ```ts
 * measureMessage({ id: '1', role: 'user', content: 'hello' })
-* // { id: '1', role: 'user', content: 2, framing: 4, calls: 0, thinking: 0, images: 0 }
+* // { id: '1', role: 'user', content: 2, uniform: 4, calls: 0, thinking: 0, images: 0 }
 * ```
 */
 function measureMessage(message) {
@@ -4733,7 +4778,7 @@ function measureMessage(message) {
 		id: message.id,
 		role: message.role,
 		content: estimateTokens(message.content),
-		framing: 4,
+		uniform: 4,
 		calls,
 		thinking: message.thinking === void 0 ? 0 : estimateTokens(message.thinking),
 		images: (message.images?.length ?? 0) * 512
@@ -4765,7 +4810,7 @@ function measureMessage(message) {
 */
 function estimateRequest(request) {
 	const measure = measureRequest(request);
-	return measure.messages.reduce((sum, message) => sum + message.content + message.framing + message.calls + message.thinking + message.images, measure.tools + measure.schema);
+	return measure.messages.reduce((sum, message) => sum + message.content + message.uniform + message.calls + message.thinking + message.images, measure.tools + measure.schema);
 }
 /**
 * Measures the disjoint estimate components of a complete provider request — each message through
@@ -4786,7 +4831,7 @@ function estimateRequest(request) {
 * @example
 * ```ts
 * measureRequest({ messages: [{ id: '1', role: 'user', content: 'hello' }] })
-* // { messages: [{ id: '1', role: 'user', content: 2, framing: 4, calls: 0, thinking: 0, images: 0 }], tools: 0, schema: 0 }
+* // { messages: [{ id: '1', role: 'user', content: 2, uniform: 4, calls: 0, thinking: 0, images: 0 }], tools: 0, schema: 0 }
 * ```
 */
 function measureRequest(request) {
@@ -5056,8 +5101,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
@@ -5238,7 +5282,7 @@ var Agent = class {
 		this.#window?.clear();
 		const cancelled = abort.signal.aborted;
 		const turns = [];
-		while (turns.length < limit && (turns.at(-1)?.ending ?? "tools") === "tools") {
+		while (turns.length < limit && (turns.at(-1)?.outcome ?? "tools") === "tools") {
 			const index = turns.length;
 			const base = turns.at(-1)?.messages ?? entry.messages;
 			const futile = turns.at(-1)?.futile ?? false;
@@ -5248,7 +5292,7 @@ var Agent = class {
 				usage: void 0,
 				spent: void 0,
 				messages: base,
-				ending: "cancel",
+				outcome: "cancel",
 				partial: true,
 				futile,
 				estimate: void 0,
@@ -5294,7 +5338,7 @@ var Agent = class {
 			if (!provided.success) {
 				turns.push({
 					...settled,
-					ending: "cancel",
+					outcome: "cancel",
 					partial: true
 				});
 				continue;
@@ -5316,7 +5360,7 @@ var Agent = class {
 				if (abort.signal.aborted) {
 					turns.push({
 						...settled,
-						ending: "cancel",
+						outcome: "cancel",
 						partial: true
 					});
 					continue;
@@ -5351,7 +5395,7 @@ var Agent = class {
 						assistant,
 						...replies
 					],
-					ending: "tools",
+					outcome: "tools",
 					partial: true
 				});
 				continue;
@@ -5364,7 +5408,7 @@ var Agent = class {
 			turns.push({
 				...settled,
 				content: result.content,
-				ending: "answer",
+				outcome: "answer",
 				partial: abort.signal.aborted,
 				truncated: result.truncated === true
 			});
@@ -5372,7 +5416,7 @@ var Agent = class {
 		const final = turns.at(-1);
 		const thinkings = turns.flatMap((turn) => turn.thinking === void 0 ? [] : [turn.thinking]);
 		return {
-			content: final?.ending === "answer" ? final.content : turns.map((turn) => turn.content).join(""),
+			content: final?.outcome === "answer" ? final.content : turns.map((turn) => turn.content).join(""),
 			thinking: thinkings.length === 0 ? void 0 : thinkings.join("\n\n"),
 			usage: [
 				...turns.map((turn) => turn.usage),
@@ -5380,7 +5424,7 @@ var Agent = class {
 				...turns.map((turn) => turn.spent)
 			].reduce((total, one) => one === void 0 ? total : sumUsage(total, one), void 0),
 			partial: final?.partial ?? cancelled,
-			exhausted: final?.ending === "tools" && !abort.signal.aborted,
+			exhausted: final?.outcome === "tools" && !abort.signal.aborted,
 			stop: inferStop(abort.signal.reason, allowance, budget, this.#provider.id, final)
 		};
 	}
@@ -5620,8 +5664,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
@@ -5679,8 +5722,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
@@ -5734,8 +5776,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
@@ -5822,8 +5863,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
@@ -6058,8 +6098,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.
@@ -6162,8 +6201,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`.
@@ -6187,11 +6225,12 @@ var LedgerError = class extends Error {
 	constructor(code, message) {
 		super(message);
 		this.name = "LedgerError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.LedgerError"), { value: this });
 		this.code = code;
 	}
 };
 /**
-* Narrows an unknown caught value to a {@link LedgerError} through `instanceof`, so a `catch` can
+* Narrows an unknown caught value to a {@link LedgerError} through its identity brand and declared members, so a `catch` can
 * branch on its `code`.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -6203,17 +6242,21 @@ var LedgerError = class extends Error {
 * ```
 */
 function isLedgerError(value) {
-	return isInstance(value, LedgerError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.LedgerError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "REQUEST" || code === "THRESHOLD" || code === "SHARE" || code === "CAPACITY" || code === "LIMIT" || code === "TOPIC" || code === "LOOKUP" || code === "GAUGE" || code === "REFERENCE")) return false;
+		return true;
+	});
 }
-//#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) {
@@ -6652,8 +6695,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,
@@ -6661,7 +6704,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
@@ -6686,8 +6729,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();
@@ -6702,7 +6744,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})`;
@@ -6716,17 +6758,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
@@ -6742,10 +6786,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) ?? []]
 	})]];
@@ -6757,6 +6805,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
@@ -6765,13 +6814,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
@@ -6779,8 +6829,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.
@@ -6976,74 +7075,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}`,
@@ -7058,8 +7145,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.
 *
@@ -7345,8 +7431,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
@@ -7371,8 +7456,7 @@ function isFraction(value) {
 function isPositiveSafeInteger(value) {
 	return 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.
@@ -7465,8 +7549,7 @@ var Gauge = class {
 		if (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.
@@ -7610,8 +7693,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.
@@ -7764,8 +7846,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
@@ -8123,17 +8204,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();
@@ -8216,7 +8297,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,
@@ -8250,7 +8331,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);
@@ -8262,10 +8343,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",
@@ -8291,7 +8372,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) {
@@ -8304,25 +8385,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));
@@ -8462,8 +8551,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
@@ -8479,7 +8567,6 @@ var Ledger = class {
 function createLedger(provider, options) {
 	return new Ledger(provider, options);
 }
-//#endregion
-export { Agent, AgentContext, AgentError, AgentFanout, AgentJobError, AgentJudge, AgentProvider, AgentRegistry, Authority, CONVERSATION_RECAP_PREFIX, Channel, Classifier, Conversation, ConversationError, ConversationManager, DECISIVE_CATEGORIES, DEFAULT_AGENT_LIMIT, DEFAULT_AUTHORITY_ZONE, DEFAULT_CONVERSATION_KEEP, DEFAULT_LEDGER_LIMIT, DEFAULT_LEDGER_SHARE, DEFAULT_PROVIDER_TIMEOUT, DEFAULT_RECALL_LIMIT, DEFAULT_RELAY_LIMIT, DETERMINISTIC_JUDGE_ERROR, DatabaseConversationStore, Gauge, IMAGE_TOKEN_ESTIMATE, INVALID_RELAY_STATUS, Instruction, InstructionManager, JudgeAbortError, JudgeError, JudgmentManager, LEDGER_CATEGORIES, LEDGER_NOTES, LEDGER_OWNER_PREFIX, LEDGER_QUESTIONS, LEDGER_RULES_KEY, LEDGER_SCALE_DRIFT, Ledger, LedgerError, LedgerRequest, MAX_ERROR_BODY_LENGTH, MESSAGE_ROLES, MESSAGE_TOKEN_OVERHEAD, MemoryConversationStore, OVERSIZED_RELAY_STATUS, PLACED_CATEGORIES, ProviderAbortError, ProviderError, QUIET_CATEGORIES, RELAY_CONTENT_TYPE, RELAY_PROVIDER_MESSAGE, RelayProvider, RelayStream, SYSTEM_ONE_PATH, Scope, ScopeManager, SystemOneJudge, THINK_CLOSE, THINK_OPEN, ThinkSplitter, UNAUTHORIZED_RELAY_STATUS, UPSTREAM_RELAY_STATUS, WORKSPACE_SECTION_HEADER, agentResultToJSON, armReaderAbort, assembleResult, attachImages, attachUserImages, buildJudgeResult, buildJudgments, buildLines, buildProviderHeaders, buildProviderResult, buildRecallMessage, buildRecapMessage, buildRecords, buildSummaryMessage, chargeUsage, collectExchanges, collectImageData, collectLive, collectNames, collectProjectionIds, collectRegistry, collectStale, collectToolGroups, computeReading, computeThinking, copyJSON, createAgent, createAgentContext, createAgentQueue, createAgentRegistry, createAgentRunner, createAuthority, createChannel, createConversation, createConversationManager, createDatabaseConversationStore, createInstruction, createInstructionManager, createLedger, createMemoryConversationStore, createRelay, createRelayProvider, createScope, createScopeManager, createSystemOneJudge, createThinkSplitter, cutListing, denyCall, estimateMessages, estimateRequest, estimateTokens, extractQueueOptions, extractSystemOneAnswer, extractSystemOneUsage, extractTokens, extractWords, filterAllowList, findLedgerCall, fitSlope, handleAgentQueueJob, hasCalls, identifyLookup, inferStop, intersectKeys, isAgentError, isAgentJobError, isConversationError, isConversationSnapshot, isFraction, isJudgeAbortError, isJudgeEntry, isJudgeError, isJudgeQuestion, isJudgment, isLedgerError, isMessage, isNonNegativeSafeInteger, isPositiveSafeInteger, isProviderAbortError, isProviderError, isSection, isSystemOneAnswer, isSystemOneResponse, joinThinking, linkOwners, matchEntities, matchesCutLine, matchesJudgment, measureMessage, measureRequest, messageContract, messageShape, normalizeArgument, placeMember, providerRequestContract, providerRequestShape, providerResultContract, providerResultShape, questionToSystemOne, raceSignal, rankLedgerCut, readChunks, readFailure, readText, relayFrameContract, relayFrameShape, releaseReader, removeEntries, renderCauseChain, renderFencedFile, renderJSON, renderLedgerPinned, renderLedgerRecord, renderLookupCall, renderSection, renderStub, renderToolValue, renderTopicNames, requestToRelay, requireBudget, requireEntry, requireJudgment, requireKeep, requireLimit, requireRolling, requireSectionsCap, resolvePredict, sanitizeToken, sanitizeUsage, scanAmendments, selectRecords, settleAgentJob, splitResultLines, splitSentences, splitTopic, splitWords, stripThinking, sumUsage, tokenUsageToJSON, toolCallShape };
+export { Agent, AgentContext, AgentError, AgentFanout, AgentJobError, AgentJudge, AgentProvider, AgentRegistry, Authority, CONVERSATION_RECAP_PREFIX, Channel, Classifier, Conversation, ConversationError, ConversationManager, DECISIVE_CATEGORIES, DEFAULT_AGENT_LIMIT, DEFAULT_AUTHORITY_ZONE, DEFAULT_CONVERSATION_KEEP, DEFAULT_LEDGER_LIMIT, DEFAULT_LEDGER_SHARE, DEFAULT_PROVIDER_TIMEOUT, DEFAULT_RECALL_LIMIT, DEFAULT_RELAY_LIMIT, DETERMINISTIC_JUDGE_ERROR, DatabaseConversationStore, Gauge, IMAGE_TOKEN_ESTIMATE, INVALID_RELAY_STATUS, Instruction, InstructionManager, JudgeAbortError, JudgeError, JudgmentManager, LEDGER_CATEGORIES, LEDGER_NOTES, LEDGER_OWNER_PREFIX, LEDGER_QUESTIONS, LEDGER_RULES_KEY, LEDGER_SCALE_DRIFT, Ledger, LedgerError, LedgerRequest, MAX_ERROR_BODY_LENGTH, MESSAGE_ROLES, MESSAGE_TOKEN_OVERHEAD, MemoryConversationStore, OVERSIZED_RELAY_STATUS, PLACED_CATEGORIES, ProviderAbortError, ProviderError, QUIET_CATEGORIES, RELAY_CONTENT_TYPE, RELAY_PROVIDER_MESSAGE, RelayProvider, RelayStream, SYSTEM_ONE_PATH, Scope, ScopeManager, SystemOneJudge, THINK_CLOSE, THINK_OPEN, ThinkSplitter, UNAUTHORIZED_RELAY_STATUS, UPSTREAM_RELAY_STATUS, WORKSPACE_SECTION_HEADER, agentResultToJSON, armReaderAbort, assembleResult, attachImages, attachUserImages, buildJudgeResult, buildJudgments, buildLedgerRenderContext, buildLines, buildProviderHeaders, buildProviderResult, buildRecallMessage, buildRecapMessage, buildRecords, buildSummaryMessage, chargeUsage, collectAmendments, collectExchanges, collectImageData, collectLive, collectNames, collectProjectionIds, collectRegistry, collectToolGroups, computeReading, computeThinking, copyJSON, createAgent, createAgentContext, createAgentQueue, createAgentRegistry, createAgentRunner, createAuthority, createChannel, createConversation, createConversationManager, createDatabaseConversationStore, createInstruction, createInstructionManager, createLedger, createMemoryConversationStore, createRelay, createRelayProvider, createScope, createScopeManager, createSystemOneJudge, createThinkSplitter, cutListing, denyCall, estimateMessages, estimateRequest, estimateTokens, extractQueueOptions, extractSystemOneAnswer, extractSystemOneUsage, extractTokens, extractWords, filterAllowList, findLedgerCall, fitSlope, handleAgentQueueJob, hasCalls, identifyLookup, inferStop, intersectKeys, isAgentError, isAgentJobError, isConversationError, isConversationSnapshot, isFraction, isJudgeAbortError, isJudgeEntry, isJudgeError, isJudgeQuestion, isJudgment, isLedgerError, isMessage, isNonNegativeSafeInteger, isPositiveSafeInteger, isProviderAbortError, isProviderError, isSection, isSystemOneAnswer, isSystemOneResponse, joinThinking, linkOwners, matchEntities, matchesCutLine, matchesJudgment, measureMessage, measureRequest, messageContract, messageShape, normalizeArgument, placeMember, providerRequestContract, providerRequestShape, providerResultContract, providerResultShape, questionToSystemOne, raceSignal, rankLedgerCut, readChunks, readFailure, readText, relayFrameContract, relayFrameShape, releaseReader, removeEntries, renderCauseChain, renderFencedFile, renderJSON, renderLedgerAnnotation, renderLedgerPinned, renderLedgerRecord, renderLookupCall, renderSection, renderStub, renderToolValue, renderTopicNames, requestToRelay, requireBudget, requireEntry, requireJudgment, requireKeep, requireLimit, requireRolling, requireSectionsCap, resolvePredict, sanitizeToken, sanitizeUsage, scanAmendments, selectRecords, settleAgentJob, splitResultLines, splitSentences, splitTopic, splitWords, stripThinking, sumUsage, tokenUsageToJSON, toolCallShape };
 
 //# sourceMappingURL=index.js.map