@orkestrel/agent 0.0.31 → 0.0.33

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

@@ -691,7 +691,7 @@ export declare interface AgentInterface {
  */
 export declare class AgentJobError extends Error {
     /** Names the machine-readable condition — `'PARTIAL'`: a job that ended partial under a disallowing policy. */
-    readonly code: "PARTIAL";
+    readonly code: 'PARTIAL';
     /** Holds the partial {@link AgentResult} the cancelled job produced. */
     readonly partial: AgentResult;
     constructor(message: string, partial: AgentResult);
@@ -1543,7 +1543,7 @@ export declare interface AgentTurn {
     readonly usage: TokenUsage | undefined;
     readonly spent: TokenUsage | undefined;
     readonly messages: readonly Message[];
-    readonly ending: 'answer' | 'tools' | 'cancel';
+    readonly outcome: 'answer' | 'tools' | 'cancel';
     readonly partial: boolean;
     readonly futile: boolean;
     readonly estimate: number | undefined;
@@ -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.
@@ -4604,7 +4616,7 @@ export declare interface GaugeInterface extends LedgerGauge {
  * `'CAPACITY'` otherwise. `replay` names the thinking the next request carries. Default: `'none'`.
  * Measured use is `prompt + completion - (thinking ?? 0)` for `'none'`, and `prompt + completion`
  * otherwise; absent completion counts as 0. Without prompt usage, use is `overhead + scale * estimate`.
- * Capacity left is `max(0, capacity - used)`. The reply reserve adds recall framing at the marginal
+ * Capacity left is `max(0, capacity - used)`. The reply reserve adds recall uniform at the marginal
  * rate to the largest observed reply's `completion - (thinking ?? 0)` for every policy.
  * Without a positive reply observation, it prices the longest reply text at that rate. Recall room is
  * `max(0, (remainder - predict - reserve) / 2 / rate)`; recall closes at `remainder - predict < 2 * reserve`.
@@ -4996,7 +5008,7 @@ export declare function intersectKeys(parent: readonly string[] | undefined, chi
 export declare const INVALID_RELAY_STATUS = 400;
 
 /**
- * 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)
@@ -5014,7 +5026,7 @@ export declare const INVALID_RELAY_STATUS = 400;
 export declare function isAgentError(value: unknown): value is AgentError;
 
 /**
- * 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)
@@ -5032,7 +5044,7 @@ export declare function isAgentError(value: unknown): value is AgentError;
 export declare function isAgentJobError(value: unknown): value is AgentJobError;
 
 /**
- * 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)
@@ -5094,7 +5106,7 @@ export declare function isConversationSnapshot(value: unknown): value is Convers
 export declare function isFraction(value: unknown): value is number;
 
 /**
- * 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
@@ -5126,7 +5138,7 @@ export declare function isJudgeAbortError(value: unknown): value is JudgeAbortEr
 export declare function isJudgeEntry(value: unknown): value is JudgeEntry;
 
 /**
- * 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
@@ -5179,7 +5191,7 @@ export declare function isJudgeQuestion(value: unknown): value is JudgeQuestion;
 export declare function isJudgment(value: unknown): value is Judgment;
 
 /**
- * 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)
@@ -5246,7 +5258,7 @@ export declare function isNonNegativeSafeInteger(value: unknown): value is numbe
 export declare function isPositiveSafeInteger(value: unknown): value is number;
 
 /**
- * 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)
@@ -5264,7 +5276,7 @@ export declare function isPositiveSafeInteger(value: unknown): value is number;
 export declare function isProviderAbortError(value: unknown): value is ProviderAbortError;
 
 /**
- * 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
@@ -5376,7 +5388,7 @@ export declare function joinThinking(running: string | undefined, next: string):
  */
 export declare class JudgeAbortError extends Error {
     /** Names the machine-readable condition — `'ABORT'`: a judge call cancelled mid-flight. */
-    readonly code: "ABORT";
+    readonly code: 'ABORT';
     readonly partial: JudgeResult;
     constructor(partial: JudgeResult, options?: ErrorOptions);
 }
@@ -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.
@@ -5950,15 +5970,15 @@ export declare interface LedgerOwner {
 }
 
 /** Names a briefing source's planning group: a topic match, an off-topic rule or correction, or a name match. */
-export declare type LedgerPlanningGroup = 1 | 2 | 3;
+export declare type LedgerPlanGroup = 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.
  *
@@ -6432,7 +6457,7 @@ export declare const MAX_ERROR_BODY_LENGTH = 2048;
  * @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
@@ -6444,7 +6469,7 @@ export declare const MAX_ERROR_BODY_LENGTH = 2048;
  * @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 }
  * ```
  */
 export declare function measureMessage(message: Message): MessageMeasure;
@@ -6468,7 +6493,7 @@ export declare function measureMessage(message: Message): MessageMeasure;
  * @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 }
  * ```
  */
 export declare function measureRequest(request: ProviderRequest): RequestMeasure;
@@ -6595,7 +6620,7 @@ export declare const MESSAGE_TOKEN_OVERHEAD = 4;
 /** Validates and projects conversation messages at a JSON wire boundary. */
 export declare const messageContract: ContractInterface<Readonly<{
 id: string;
-role: "system" | "user" | "assistant" | "tool";
+role: "assistant" | "system" | "tool" | "user";
 content: string;
 } & {
 calls?: readonly Readonly<{
@@ -6693,7 +6718,7 @@ export declare interface MessageManagerInterface {
  *
  * @remarks
  * The structural estimate is not a tokenizer allocation. `id` and `role` are joins back to the
- * message, not token components. A message's estimate is the sum of `content`, `framing`, `calls`,
+ * message, not token components. A message's estimate is the sum of `content`, `uniform`, `calls`,
  * `thinking`, and `images`; no total is stored. A provider's template effects and the estimation
  * error are not individually attributed.
  */
@@ -6702,9 +6727,9 @@ export declare interface MessageMeasure {
     readonly role: MessageRole;
     /** Holds the `ceil(length / 4)` estimate of the message `content`. */
     readonly content: number;
-    /** Holds the fixed per-message framing overhead. */
-    readonly framing: number;
-    /** Holds the estimate of the JSON-rendered `calls`, or the framing overhead when they cannot be rendered; `0` when the message carries none. */
+    /** Holds the fixed per-message uniform overhead. */
+    readonly uniform: number;
+    /** Holds the estimate of the JSON-rendered `calls`, or the uniform overhead when they cannot be rendered; `0` when the message carries none. */
     readonly calls: number;
     /** Holds the estimate of the message `thinking`; `0` when absent. */
     readonly thinking: number;
@@ -6829,7 +6854,7 @@ export declare function placeMember(input: LedgerProjectionInput, links: Readonl
  */
 export declare class ProviderAbortError extends Error {
     /** Names the machine-readable condition — `'ABORT'`: a stream cancelled mid-flight. */
-    readonly code: "ABORT";
+    readonly code: 'ABORT';
     readonly partial: ProviderResult;
     constructor(partial: ProviderResult, options?: ErrorOptions);
 }
@@ -6990,7 +7015,7 @@ export declare interface ProviderRequest {
 export declare const providerRequestContract: ContractInterface<Readonly<{
 messages: readonly Readonly<{
 id: string;
-role: "system" | "user" | "assistant" | "tool";
+role: "assistant" | "system" | "tool" | "user";
 content: string;
 } & {
 calls?: readonly Readonly<{
@@ -7205,7 +7230,7 @@ export declare function raceSignal<T>(promise: Promise<T>, signal: AbortSignal |
  * rankLedgerCut(2, false, 'rule') // 3
  * ```
  */
-export declare function rankLedgerCut(group: LedgerPlanningGroup, unsettled: boolean, category: LedgerCategory | undefined): number;
+export declare function rankLedgerCut(group: LedgerPlanGroup, unsettled: boolean, category: LedgerCategory | undefined): number;
 
 /**
  * Decodes UTF-8 chunks with a final flush and releases the stream on every exit.
@@ -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