@orkestrel/agent 0.0.31 → 0.0.32

package/dist/src/core/index.d.cts

@@ -1798,29 +1798,42 @@ export declare function buildJudgeResult(model: string, results: readonly JudgeR
  */
 export declare function buildJudgments(request: JudgeRequest, result: JudgeResult, sources: readonly string[], state: string, model: string): readonly JudgmentInput[];
 
+/**
+ * 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
+ * ```
+ */
+export declare function buildLedgerRenderContext(messages: readonly Message[], lines: readonly LedgerLine[], amendments: readonly LedgerAmendment[]): LedgerRenderContext;
+
 /**
  * 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.']
  * ```
  */
-export declare function buildLines(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, id: string, dead: ReadonlySet<string>, holders: readonly string[], system: readonly string[]): readonly LedgerLine[];
+export declare function buildLines(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, id: string, holders: readonly string[], system: readonly string[]): readonly LedgerLine[];
 
 /**
  * Builds a request's JSON headers, awaiting the caller's header hook inside the call's
@@ -1910,8 +1923,8 @@ export declare function buildRecapMessage(section: Section): Message;
  * 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,
@@ -1919,7 +1932,7 @@ export declare function buildRecapMessage(section: Section): Message;
  * 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
@@ -2268,6 +2281,26 @@ export declare interface CodedErrorOptions {
     readonly context?: Readonly<Record<string, unknown>>;
 }
 
+/**
+ * Collects accepted direct amendments of live messages.
+ *
+ * @remarks
+ * 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 distinct accepted direct edges in conversation order
+ *
+ * @example
+ * ```ts
+ * collectAmendments(input, byId, ['user-1', 'user-3']) // [{ earlier: 'user-1', later: 'user-3' }]
+ * ```
+ */
+export declare function collectAmendments(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, live: readonly string[]): readonly LedgerAmendment[];
+
 /**
  * Collects whole exchanges, joining every exchange spanned by a tool group.
  *
@@ -2350,7 +2383,7 @@ export declare function collectNames(text: string): readonly string[];
  * @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' }
  * ```
  */
 export declare function collectProjectionIds(projection: LedgerProjection): ReadonlySet<string>;
@@ -2375,27 +2408,6 @@ export declare function collectProjectionIds(projection: LedgerProjection): Read
  */
 export declare function collectRegistry(readings: readonly LedgerLookupReading[]): LedgerRegistry;
 
-/**
- * Collects the sentences that live messages made stale.
- *
- * @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.
- *
- * @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
- *
- * @example
- * ```ts
- * collectStale(input, byId, ['user-1', 'user-3']) // [{ source: 'user-1', sentence: 1, tokens: ['ESC-2291'] }]
- * ```
- */
-export declare function collectStale(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, live: readonly string[]): readonly LedgerStaleSentence[];
-
 /**
  * Collects each assistant message that carries calls together with the tool messages that answer
  * it, then each run of tool messages that no assistant message owns.
@@ -5653,6 +5665,12 @@ export declare const LEDGER_SCALE_DRIFT = 0.06;
  */
 export declare type LedgerAgentOptions = Pick<AgentOptions, 'limit' | 'timeout' | 'on'>;
 
+/** Identifies an accepted direct message amendment whose sentence scope remains unresolved. */
+export declare interface LedgerAmendment {
+    readonly earlier: string;
+    readonly later: string;
+}
+
 /** Names the category the ledger files a message under, one of {@link LEDGER_CATEGORIES}. */
 export declare type LedgerCategory = (typeof LEDGER_CATEGORIES)[number];
 
@@ -5729,7 +5747,9 @@ export declare type LedgerErrorCode =
 /** Reports a lookup tool named `recall` or a name another lookup tool carries. */
 | 'LOOKUP'
 /** Reports a supplied gauge outside its bounds, or a calibration call that reports no prompt usage, or a prompt usage of 0 or less. */
-| 'GAUGE';
+| 'GAUGE'
+/** Reports a render context that holds no reference for a source it annotates. */
+| 'REFERENCE';
 
 /**
  * Carries the price of a prompt in tokens, measured against the model the ledger serves.
@@ -5953,12 +5973,12 @@ export declare interface LedgerOwner {
 export declare type LedgerPlanningGroup = 1 | 2 | 3;
 
 /**
- * Carries the records projected from a conversation, the stale sentences, and the live messages no
+ * Carries the records projected from a conversation, accepted amendments, and the live messages no
  * record placed.
  */
 export declare interface LedgerProjection {
     readonly records: readonly LedgerRecord[];
-    readonly stale: readonly LedgerStaleSentence[];
+    readonly amendments: readonly LedgerAmendment[];
     readonly orphans: readonly string[];
 }
 
@@ -6026,8 +6046,9 @@ export declare interface LedgerRecallOptions {
  *
  * @remarks
  * `key` is `rules` for the rules record and `owner:` followed by the owner id for an owner record.
- * `title` is `Rules`, or the owner's first name with its id. `members` lists the placed message ids
- * in conversation order.
+ * `title` is `Rules`, or the owner's first name with its id. In a request view, owner records with
+ * the same member ids in the same order render once, under their titles joined with `; `.
+ * `members` lists the placed message ids in conversation order.
  */
 export declare interface LedgerRecord {
     readonly key: string;
@@ -6049,6 +6070,24 @@ export declare interface LedgerRegistry {
     readonly owners: ReadonlyMap<string, readonly string[]>;
 }
 
+/**
+ * Supplies accepted amendments and completely included sources for one briefing rendering.
+ *
+ * @remarks
+ * `first` identifies each source's first retained line object in actual emission order. Build this
+ * context from the same line objects passed to the renderers after deduplication and trimming;
+ * recompute it when the retained population changes. `references` assigns each distinct retained
+ * source its decimal display reference in first-occurrence order, starting at 1. These
+ * briefing-local references can change after trimming; the projection, recall, and storage retain
+ * original source IDs.
+ */
+export declare interface LedgerRenderContext {
+    readonly amendments: readonly LedgerAmendment[];
+    readonly complete: ReadonlySet<string>;
+    readonly first: ReadonlyMap<string, LedgerLine>;
+    readonly references: ReadonlyMap<string, string>;
+}
+
 /**
  * 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.
@@ -6276,20 +6315,6 @@ export declare interface LedgerShare {
     readonly tail: number;
 }
 
-/**
- * Carries one sentence a later message made stale, with the tokens the two share.
- *
- * @remarks
- * `source` is the earlier message's id and `sentence` the zero-based index of the sentence. The
- * projection leaves a stale sentence out of the records and the briefing. Recall and answer notes
- * keep the stored content. The seed tail replaces lookup results with status stubs.
- */
-export declare interface LedgerStaleSentence {
-    readonly source: string;
-    readonly sentence: number;
-    readonly tokens: readonly string[];
-}
-
 /**
  * Carries the probability cutoff of each reading the ledger takes from its judge.
  *
@@ -7643,10 +7668,25 @@ export declare function renderFencedFile(path: string, language: string, content
  */
 export declare function renderJSON(value: unknown): string | undefined;
 
+/**
+ * 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([], [], [])) // ''
+ * ```
+ */
+export declare function renderLedgerAnnotation(line: LedgerLine, context: LedgerRenderContext): string;
+
 /**
  * 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
@@ -7654,7 +7694,7 @@ export declare function renderJSON(value: unknown): string | undefined;
  * renderLedgerPinned({ title: 'Odile Marlow (account OM-30418)', lines: [] }) // '### Odile Marlow (account OM-30418)'
  * ```
  */
-export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' | 'lines'>): string;
+export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' | 'lines'>, context?: LedgerRenderContext): string;
 
 /**
  * Renders one record as a heading and one list item per line.
@@ -7663,6 +7703,7 @@ export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' |
  * 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
@@ -7671,7 +7712,7 @@ export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' |
  * // '## Rules\n- Refunds need a manager.'
  * ```
  */
-export declare function renderLedgerRecord(record: Pick<LedgerRecord, 'title' | 'lines'>): string;
+export declare function renderLedgerRecord(record: Pick<LedgerRecord, 'title' | 'lines'>, context?: LedgerRenderContext): string;
 
 /**
  * Renders a lookup call as its tool name and its JSON arguments.
@@ -8336,12 +8377,14 @@ export declare interface Selection {
 export declare type SelectionHandler = (conversation: ConversationInterface, request: Message, signal: AbortSignal) => Promise<Selection>;
 
 /**
- * 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

package/dist/src/core/index.d.ts

@@ -1798,29 +1798,42 @@ export declare function buildJudgeResult(model: string, results: readonly JudgeR
  */
 export declare function buildJudgments(request: JudgeRequest, result: JudgeResult, sources: readonly string[], state: string, model: string): readonly JudgmentInput[];
 
+/**
+ * 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
+ * ```
+ */
+export declare function buildLedgerRenderContext(messages: readonly Message[], lines: readonly LedgerLine[], amendments: readonly LedgerAmendment[]): LedgerRenderContext;
+
 /**
  * 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.']
  * ```
  */
-export declare function buildLines(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, id: string, dead: ReadonlySet<string>, holders: readonly string[], system: readonly string[]): readonly LedgerLine[];
+export declare function buildLines(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, id: string, holders: readonly string[], system: readonly string[]): readonly LedgerLine[];
 
 /**
  * Builds a request's JSON headers, awaiting the caller's header hook inside the call's
@@ -1910,8 +1923,8 @@ export declare function buildRecapMessage(section: Section): Message;
  * 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,
@@ -1919,7 +1932,7 @@ export declare function buildRecapMessage(section: Section): Message;
  * 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
@@ -2268,6 +2281,26 @@ export declare interface CodedErrorOptions {
     readonly context?: Readonly<Record<string, unknown>>;
 }
 
+/**
+ * Collects accepted direct amendments of live messages.
+ *
+ * @remarks
+ * 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 distinct accepted direct edges in conversation order
+ *
+ * @example
+ * ```ts
+ * collectAmendments(input, byId, ['user-1', 'user-3']) // [{ earlier: 'user-1', later: 'user-3' }]
+ * ```
+ */
+export declare function collectAmendments(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, live: readonly string[]): readonly LedgerAmendment[];
+
 /**
  * Collects whole exchanges, joining every exchange spanned by a tool group.
  *
@@ -2350,7 +2383,7 @@ export declare function collectNames(text: string): readonly string[];
  * @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' }
  * ```
  */
 export declare function collectProjectionIds(projection: LedgerProjection): ReadonlySet<string>;
@@ -2375,27 +2408,6 @@ export declare function collectProjectionIds(projection: LedgerProjection): Read
  */
 export declare function collectRegistry(readings: readonly LedgerLookupReading[]): LedgerRegistry;
 
-/**
- * Collects the sentences that live messages made stale.
- *
- * @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.
- *
- * @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
- *
- * @example
- * ```ts
- * collectStale(input, byId, ['user-1', 'user-3']) // [{ source: 'user-1', sentence: 1, tokens: ['ESC-2291'] }]
- * ```
- */
-export declare function collectStale(input: LedgerProjectionInput, byId: ReadonlyMap<string, Message>, live: readonly string[]): readonly LedgerStaleSentence[];
-
 /**
  * Collects each assistant message that carries calls together with the tool messages that answer
  * it, then each run of tool messages that no assistant message owns.
@@ -5653,6 +5665,12 @@ export declare const LEDGER_SCALE_DRIFT = 0.06;
  */
 export declare type LedgerAgentOptions = Pick<AgentOptions, 'limit' | 'timeout' | 'on'>;
 
+/** Identifies an accepted direct message amendment whose sentence scope remains unresolved. */
+export declare interface LedgerAmendment {
+    readonly earlier: string;
+    readonly later: string;
+}
+
 /** Names the category the ledger files a message under, one of {@link LEDGER_CATEGORIES}. */
 export declare type LedgerCategory = (typeof LEDGER_CATEGORIES)[number];
 
@@ -5729,7 +5747,9 @@ export declare type LedgerErrorCode =
 /** Reports a lookup tool named `recall` or a name another lookup tool carries. */
 | 'LOOKUP'
 /** Reports a supplied gauge outside its bounds, or a calibration call that reports no prompt usage, or a prompt usage of 0 or less. */
-| 'GAUGE';
+| 'GAUGE'
+/** Reports a render context that holds no reference for a source it annotates. */
+| 'REFERENCE';
 
 /**
  * Carries the price of a prompt in tokens, measured against the model the ledger serves.
@@ -5953,12 +5973,12 @@ export declare interface LedgerOwner {
 export declare type LedgerPlanningGroup = 1 | 2 | 3;
 
 /**
- * Carries the records projected from a conversation, the stale sentences, and the live messages no
+ * Carries the records projected from a conversation, accepted amendments, and the live messages no
  * record placed.
  */
 export declare interface LedgerProjection {
     readonly records: readonly LedgerRecord[];
-    readonly stale: readonly LedgerStaleSentence[];
+    readonly amendments: readonly LedgerAmendment[];
     readonly orphans: readonly string[];
 }
 
@@ -6026,8 +6046,9 @@ export declare interface LedgerRecallOptions {
  *
  * @remarks
  * `key` is `rules` for the rules record and `owner:` followed by the owner id for an owner record.
- * `title` is `Rules`, or the owner's first name with its id. `members` lists the placed message ids
- * in conversation order.
+ * `title` is `Rules`, or the owner's first name with its id. In a request view, owner records with
+ * the same member ids in the same order render once, under their titles joined with `; `.
+ * `members` lists the placed message ids in conversation order.
  */
 export declare interface LedgerRecord {
     readonly key: string;
@@ -6049,6 +6070,24 @@ export declare interface LedgerRegistry {
     readonly owners: ReadonlyMap<string, readonly string[]>;
 }
 
+/**
+ * Supplies accepted amendments and completely included sources for one briefing rendering.
+ *
+ * @remarks
+ * `first` identifies each source's first retained line object in actual emission order. Build this
+ * context from the same line objects passed to the renderers after deduplication and trimming;
+ * recompute it when the retained population changes. `references` assigns each distinct retained
+ * source its decimal display reference in first-occurrence order, starting at 1. These
+ * briefing-local references can change after trimming; the projection, recall, and storage retain
+ * original source IDs.
+ */
+export declare interface LedgerRenderContext {
+    readonly amendments: readonly LedgerAmendment[];
+    readonly complete: ReadonlySet<string>;
+    readonly first: ReadonlyMap<string, LedgerLine>;
+    readonly references: ReadonlyMap<string, string>;
+}
+
 /**
  * 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.
@@ -6276,20 +6315,6 @@ export declare interface LedgerShare {
     readonly tail: number;
 }
 
-/**
- * Carries one sentence a later message made stale, with the tokens the two share.
- *
- * @remarks
- * `source` is the earlier message's id and `sentence` the zero-based index of the sentence. The
- * projection leaves a stale sentence out of the records and the briefing. Recall and answer notes
- * keep the stored content. The seed tail replaces lookup results with status stubs.
- */
-export declare interface LedgerStaleSentence {
-    readonly source: string;
-    readonly sentence: number;
-    readonly tokens: readonly string[];
-}
-
 /**
  * Carries the probability cutoff of each reading the ledger takes from its judge.
  *
@@ -7643,10 +7668,25 @@ export declare function renderFencedFile(path: string, language: string, content
  */
 export declare function renderJSON(value: unknown): string | undefined;
 
+/**
+ * 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([], [], [])) // ''
+ * ```
+ */
+export declare function renderLedgerAnnotation(line: LedgerLine, context: LedgerRenderContext): string;
+
 /**
  * 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
@@ -7654,7 +7694,7 @@ export declare function renderJSON(value: unknown): string | undefined;
  * renderLedgerPinned({ title: 'Odile Marlow (account OM-30418)', lines: [] }) // '### Odile Marlow (account OM-30418)'
  * ```
  */
-export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' | 'lines'>): string;
+export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' | 'lines'>, context?: LedgerRenderContext): string;
 
 /**
  * Renders one record as a heading and one list item per line.
@@ -7663,6 +7703,7 @@ export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' |
  * 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
@@ -7671,7 +7712,7 @@ export declare function renderLedgerPinned(record: Pick<LedgerRecord, 'title' |
  * // '## Rules\n- Refunds need a manager.'
  * ```
  */
-export declare function renderLedgerRecord(record: Pick<LedgerRecord, 'title' | 'lines'>): string;
+export declare function renderLedgerRecord(record: Pick<LedgerRecord, 'title' | 'lines'>, context?: LedgerRenderContext): string;
 
 /**
  * Renders a lookup call as its tool name and its JSON arguments.
@@ -8336,12 +8377,14 @@ export declare interface Selection {
 export declare type SelectionHandler = (conversation: ConversationInterface, request: Message, signal: AbortSignal) => Promise<Selection>;
 
 /**
- * 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