@cyanheads/congressgov-mcp-server 0.4.3 → 0.5.0

package/dist/mcp-server/tools/format-helpers.js

@@ -6,11 +6,15 @@
  * NOT reliably forwarded. These formatters render complete, structured
  * markdown so the LLM can reason about all returned data.
  *
- * **Completeness invariant.** A record reaching a detail renderer is rendered
- * whole: every upstream field appears, and no value is cut mid-string. A
- * hand-built header may curate presentation, but it ends in `renderDetailRest`,
- * and a curated collection row ends in `withUnnamedFields` — so a field neither
- * one names still reaches the reader. The single deliberate exception is a
+ * **Completeness invariant.** A record reaching any renderer — detail view or
+ * list row — is rendered whole: every upstream field appears, and no value is
+ * cut mid-string. A hand-built header may curate presentation, but a detail
+ * header ends in `renderDetailRest`, a list row ends in `withRowRest`, and a
+ * curated single-line row ends in `withUnnamedFields` — so a field none of them
+ * names still reaches the reader. A collection a curated line renders lossily
+ * (its latest entry only, or only some of each entry's fields) is deliberately
+ * left out of the row's named set, so the fall-through carries it whole. The
+ * single deliberate exception is a
  * `{count, url}` sub-resource reference, rendered as "N available": the URL is
  * the upstream REST endpoint, and the tool's own operation is the callable path
  * to those rows. Caps belong to pagination, which has a continuation path
@@ -218,11 +222,10 @@ function renderDetail(obj) {
                     lines.push(`**${key}:** ${count} available`);
                 continue;
             }
-            // latestAction: { actionDate, text }
             if (key === 'latestAction') {
-                const date = s(nested, 'actionDate');
-                const text = s(nested, 'text');
-                lines.push(`**Latest Action:** ${[date, text].filter(Boolean).join(' — ')}`);
+                const line = latestActionLine(record);
+                if (line)
+                    lines.push(line);
                 continue;
             }
             // Small objects inline, larger ones nested
@@ -248,22 +251,28 @@ function renderDetail(obj) {
 }
 /** Render any list item with all its fields. */
 function renderGenericItem(item, index) {
-    // Build heading from common identifier fields
-    const id = item.type && item.number != null
-        ? `${String(item.type).toUpperCase()} ${item.number}`
-        : (s(item, 'citation') ?? s(item, 'bioguideId') ?? s(item, 'systemCode'));
-    const name = s(item, 'title') ??
-        s(item, 'name') ??
-        s(item, 'fullName') ??
-        s(item, 'directOrderName') ??
-        s(item, 'description') ??
-        s(item, 'question');
+    /**
+     * Only the keys the heading actually consumed are skipped below. A fixed
+     * skip-list swallows the alternates: a committee-report row carries both a
+     * `citation` and a `type`/`number` pair, and the heading built from the pair
+     * would drop `H. Rept. 113-118` — the label Congress.gov itself publishes.
+     */
+    const named = new Set();
+    let id;
+    if (item.type && item.number != null) {
+        named.add('type').add('number');
+        id = `${String(item.type).toUpperCase()} ${item.number}`;
+    }
+    else {
+        id = pick(item, named, 'citation', 'bioguideId', 'systemCode');
+    }
+    const name = pick(item, named, 'title', 'name', 'fullName', 'directOrderName', 'description', 'question');
     const heading = [id, name].filter(Boolean).join(': ') || 'Item';
     const lines = [`### ${index + 1}. ${heading}`];
     for (const [key, val] of Object.entries(item)) {
         if (val == null || val === '')
             continue;
-        if (HEADING_FIELDS.has(key))
+        if (named.has(key))
             continue;
         if (typeof val === 'string') {
             const inline = stripHtml(val, { inline: true });
@@ -279,10 +288,9 @@ function renderGenericItem(item, index) {
             lines.push(`**${key}:** ${val}`);
         }
         else if (typeof val === 'object' && !Array.isArray(val) && val !== null) {
-            if (key === 'latestAction') {
-                const date = s(val, 'actionDate');
-                const text = s(val, 'text');
-                lines.push(`**Latest Action:** ${[date, text].filter(Boolean).join(' — ')}`);
+            const action = key === 'latestAction' ? latestActionLine(item) : undefined;
+            if (action) {
+                lines.push(action);
             }
             else {
                 lines.push(`**${key}:** ${renderInline(val)}`);
@@ -303,19 +311,25 @@ function renderGenericItem(item, index) {
     }
     return lines.join('\n');
 }
-const HEADING_FIELDS = new Set([
-    'type',
-    'number',
-    'citation',
-    'bioguideId',
-    'systemCode',
-    'title',
-    'name',
-    'fullName',
-    'directOrderName',
-    'description',
-    'question',
-]);
+/** Fields of a `latestAction` object the curated line names — `actionTime` is not one. */
+const LATEST_ACTION_KEYS = new Set(['actionDate', 'text']);
+/**
+ * The `**Latest Action:** date — text` line, followed by any sub-field that
+ * curation does not name. Every renderer that shows a `latestAction` object
+ * shows it the same lossy way, so the fall-through lives here rather than in
+ * each caller's key set — upstream carries `actionTime` on bill rows reached
+ * through `member_lookup sponsored`, and it reached no `content[]` client.
+ * Returns undefined when the row carries no latest action at all.
+ */
+function latestActionLine(item) {
+    const action = item.latestAction;
+    if (!action || typeof action !== 'object' || Array.isArray(action))
+        return;
+    const record = action;
+    const curated = [s(record, 'actionDate'), s(record, 'text')].filter(Boolean).join(' — ');
+    const line = withUnnamedFields(record, curated, LATEST_ACTION_KEYS);
+    return line ? `**Latest Action:** ${line.replace(/^ — /, '')}` : undefined;
+}
 /**
  * Compact one-line render of a small object. Compact but never lossy: values are
  * carried in full and nested objects/arrays recurse, so no field or character is
@@ -370,6 +384,35 @@ function withUnnamedFields(row, curated, named) {
     const unnamed = inlineFields(rest);
     return unnamed ? `${curated} — ${unnamed}` : curated;
 }
+/**
+ * A curated multi-line list row followed by every field of the row the curation
+ * never named — the list-row counterpart to a detail header's `renderDetailRest`
+ * tail. Without it a hand-built row renders a fixed field set, and anything
+ * upstream adds (or the curation never reached, like a subcommittee's `parent`)
+ * stays in `structuredContent` and never reaches a `content[]`-only client.
+ */
+function withRowRest(item, lines, named) {
+    const rest = renderDetailRest(item, named);
+    return rest ? [...lines, '', rest].join('\n') : lines.join('\n');
+}
+/**
+ * First present value among `keys`, marking only the key actually consumed as
+ * named. An alias chain (`updateDate ?? publishDate`) otherwise swallows the
+ * alternates: they are distinct upstream facts, so the ones the header did not
+ * render have to stay available to the fall-through. Renderers that call this
+ * hold their key constant as an array and copy it into a fresh set per row —
+ * `pick` mutates the set it is given.
+ */
+function pick(item, named, ...keys) {
+    for (const key of keys) {
+        const val = s(item, key);
+        if (val != null && val !== '') {
+            named.add(key);
+            return val;
+        }
+    }
+    return;
+}
 // ── Domain-Specific Item Renderers ──────────────────────────────────
 /**
  * Public/private law citations from a bill or law record's `laws[]`, e.g.
@@ -412,17 +455,30 @@ function renderBillItem(item, i) {
         });
         lines.push(`**Sponsor:** ${sponsors.join(', ')}`);
     }
-    const actionDate = s(item, 'latestAction', 'actionDate');
-    const actionText = s(item, 'latestAction', 'text');
-    if (actionDate || actionText)
-        lines.push(`**Latest Action:** ${[actionDate, actionText].filter(Boolean).join(' — ')}`);
+    const latestAction = latestActionLine(item);
+    if (latestAction)
+        lines.push(latestAction);
     const updated = s(item, 'updateDate');
     if (updated)
         lines.push(`**Updated:** ${updated}`);
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, BILL_ROW_KEYS);
 }
+/** `sponsors` is absent: the curated line drops each sponsor's `bioguideId`. */
+const BILL_ROW_KEYS = new Set([
+    'type',
+    'number',
+    'title',
+    'congress',
+    'originChamber',
+    'originChamberCode',
+    'policyArea',
+    'laws',
+    'latestAction',
+    'updateDate',
+    'url',
+]);
 function renderMemberItem(item, i) {
     const name = s(item, 'name') ?? s(item, 'directOrderName') ?? s(item, 'fullName') ?? 'Unknown Member';
     const url = s(item, 'url');
@@ -455,15 +511,28 @@ function renderMemberItem(item, i) {
     }
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, MEMBER_ROW_KEYS);
 }
+/** `terms` is absent: the curated line renders the latest term only. */
+const MEMBER_ROW_KEYS = new Set([
+    'bioguideId',
+    'name',
+    'directOrderName',
+    'fullName',
+    'partyName',
+    'party',
+    'state',
+    'district',
+    'url',
+]);
 function renderSummaryItem(item, i) {
+    const named = new Set(SUMMARY_ROW_KEYS);
     const billType = s(item, 'bill', 'type')?.toUpperCase() ?? '';
     const billNum = s(item, 'bill', 'number') ?? '';
     const congress = s(item, 'bill', 'congress') ?? '';
-    const version = s(item, 'actionDesc') ?? s(item, 'versionCode') ?? '';
+    const version = pick(item, named, 'actionDesc', 'versionCode') ?? '';
     const actionDate = s(item, 'actionDate') ?? '';
-    const summaryUpdate = s(item, 'lastSummaryUpdateDate') ?? s(item, 'updateDate') ?? '';
+    const summaryUpdate = pick(item, named, 'lastSummaryUpdateDate', 'updateDate') ?? '';
     const rawText = typeof item.text === 'string' ? item.text : '';
     const text = rawText ? htmlToMarkdown(rawText) : '';
     const url = s(item, 'url') ?? s(item, 'bill', 'url');
@@ -478,19 +547,28 @@ function renderSummaryItem(item, i) {
     if (meta)
         lines.push(meta);
     const billTitle = s(item, 'bill', 'title');
-    lines.push(`**Bill Title:** ${billTitle ?? 'Not available'}`);
+    const billLine = `**Bill Title:** ${billTitle ?? 'Not available'}`;
+    const bill = item.bill;
+    lines.push(bill && typeof bill === 'object' && !Array.isArray(bill)
+        ? withUnnamedFields(bill, billLine, BILL_REF_KEYS)
+        : billLine);
     // The summary text is the critical data — the whole point of this tool
     lines.push('');
     lines.push(text || '_Summary text not available._');
     if (url)
         lines.push(`\n**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, named);
 }
+/** `actionDesc`/`versionCode` and the two update dates are resolved by `pick`. */
+const SUMMARY_ROW_KEYS = ['actionDate', 'text', 'url', 'bill'];
+/** Fields of a summary row's nested bill reference the heading already renders. */
+const BILL_REF_KEYS = new Set(['congress', 'type', 'number', 'title', 'url']);
 function renderCrsReportItem(item, i) {
+    const named = new Set(CRS_REPORT_ROW_KEYS);
     const reportNumber = s(item, 'reportNumber') ?? s(item, 'number') ?? s(item, 'id') ?? 'Report number not available';
     const title = s(item, 'title') ?? 'Title not available';
-    const updated = s(item, 'updateDate') ?? s(item, 'publishDate') ?? s(item, 'date') ?? '';
-    const summary = s(item, 'summary') ?? s(item, 'abstract') ?? '';
+    const updated = pick(item, named, 'updateDate', 'publishDate', 'date') ?? '';
+    const summary = pick(item, named, 'summary', 'abstract') ?? '';
     const contentType = s(item, 'contentType');
     const status = s(item, 'status');
     const version = s(item, 'version');
@@ -508,8 +586,23 @@ function renderCrsReportItem(item, i) {
         lines.push(summary);
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, named);
 }
+/**
+ * The three identifier aliases are all named: upstream sends one of them, and
+ * the heading renders whichever arrived. The date and summary aliases are
+ * distinct facts, so `pick` names only the one the header consumed.
+ */
+const CRS_REPORT_ROW_KEYS = [
+    'reportNumber',
+    'number',
+    'id',
+    'title',
+    'contentType',
+    'status',
+    'version',
+    'url',
+];
 /** Daily Congressional Record articles — flattened from section-wrapped shape. */
 function renderDailyArticleItem(item, i) {
     const title = s(item, 'title') ?? 'Untitled article';
@@ -530,8 +623,9 @@ function renderDailyArticleItem(item, i) {
                 lines.push(`**${type}:** ${url}`);
         }
     }
-    return lines.join('\n');
+    return withRowRest(item, lines, DAILY_ARTICLE_ROW_KEYS);
 }
+const DAILY_ARTICLE_ROW_KEYS = new Set(['title', 'sectionName', 'startPage', 'endPage', 'text']);
 /** Daily Congressional Record volumes and issues. */
 function renderDailyRecordItem(item, i) {
     const volume = s(item, 'volumeNumber');
@@ -554,8 +648,17 @@ function renderDailyRecordItem(item, i) {
         lines.push(meta);
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, DAILY_RECORD_ROW_KEYS);
 }
+/** `issueDate` is absent: the heading shows the date, the fall-through the time. */
+const DAILY_RECORD_ROW_KEYS = new Set([
+    'volumeNumber',
+    'issueNumber',
+    'congress',
+    'sessionNumber',
+    'updateDate',
+    'url',
+]);
 /** House roll call votes. */
 function renderRollVoteItem(item, i) {
     const roll = s(item, 'rollCallNumber');
@@ -592,8 +695,23 @@ function renderRollVoteItem(item, i) {
         lines.push(`**URL:** ${url}`);
     if (sourceUrl)
         lines.push(`**Source Data URL:** ${sourceUrl}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, ROLL_VOTE_ROW_KEYS);
 }
+const ROLL_VOTE_ROW_KEYS = new Set([
+    'rollCallNumber',
+    'identifier',
+    'legislationType',
+    'legislationNumber',
+    'legislationUrl',
+    'result',
+    'voteType',
+    'startDate',
+    'congress',
+    'sessionNumber',
+    'updateDate',
+    'sourceDataURL',
+    'url',
+]);
 /** Bill legislative actions. */
 function renderBillActionItem(item, i) {
     const actionDate = s(item, 'actionDate');
@@ -612,8 +730,10 @@ function renderBillActionItem(item, i) {
         if (names.length > 0)
             lines.push(`**Committees:** ${names.join(', ')}`);
     }
-    return lines.join('\n');
+    return withRowRest(item, lines, BILL_ACTION_ROW_KEYS);
 }
+/** `committees` is absent: the name list drops each committee's `systemCode`. */
+const BILL_ACTION_ROW_KEYS = new Set(['actionDate', 'text', 'type', 'actionCode', 'sourceSystem']);
 /** Committee report text — items wrap a `formats` array of {type, url, isErrata}. */
 function renderCommitteeReportTextItem(item, i) {
     const formats = item.formats;
@@ -635,8 +755,9 @@ function renderCommitteeReportTextItem(item, i) {
         const label = e.isErrata ? `${e.type} (Errata)` : e.type;
         lines.push(`**${label}:** ${e.url}`);
     }
-    return lines.join('\n');
+    return withRowRest(item, lines, COMMITTEE_REPORT_TEXT_ROW_KEYS);
 }
+const COMMITTEE_REPORT_TEXT_ROW_KEYS = new Set(['formats']);
 /** Member-sponsored amendments — `type`/`title` are null upstream; identify by `amendmentNumber`. */
 function renderAmendmentItem(item, i) {
     const number = s(item, 'amendmentNumber');
@@ -657,14 +778,20 @@ function renderAmendmentItem(item, i) {
     ]);
     if (meta)
         lines.push(meta);
-    const actionDate = s(item, 'latestAction', 'actionDate');
-    const actionText = s(item, 'latestAction', 'text');
-    if (actionDate || actionText)
-        lines.push(`**Latest Action:** ${[actionDate, actionText].filter(Boolean).join(' — ')}`);
+    const latestAction = latestActionLine(item);
+    if (latestAction)
+        lines.push(latestAction);
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, AMENDMENT_ROW_KEYS);
 }
+const AMENDMENT_ROW_KEYS = new Set([
+    'amendmentNumber',
+    'congress',
+    'introducedDate',
+    'latestAction',
+    'url',
+]);
 /** Bill text versions — heading from `type` (e.g. "Enrolled Bill"), formats[] as labeled URLs. */
 function renderBillTextItem(item, i) {
     const type = s(item, 'type') ?? 'Bill Text';
@@ -681,8 +808,9 @@ function renderBillTextItem(item, i) {
                 lines.push(`**${fType}:** ${fUrl}`);
         }
     }
-    return lines.join('\n');
+    return withRowRest(item, lines, BILL_TEXT_ROW_KEYS);
 }
+const BILL_TEXT_ROW_KEYS = new Set(['type', 'date', 'formats']);
 /** Nomination type wrapper: `{isCivilian: true}` / `{isMilitary: true}` → readable label. */
 function nominationTypeLabel(raw) {
     if (!raw || typeof raw !== 'object')
@@ -722,15 +850,27 @@ function renderNominationListItem(item, i) {
     ]);
     if (meta)
         lines.push(meta);
-    const actionDate = s(item, 'latestAction', 'actionDate');
-    const actionText = s(item, 'latestAction', 'text');
-    if (actionDate || actionText)
-        lines.push(`**Latest Action:** ${[actionDate, actionText].filter(Boolean).join(' — ')}`);
+    const latestAction = latestActionLine(item);
+    if (latestAction)
+        lines.push(latestAction);
     const url = s(item, 'url');
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, NOMINATION_ROW_KEYS);
 }
+const NOMINATION_ROW_KEYS = new Set([
+    'citation',
+    'number',
+    'partNumber',
+    'nominationType',
+    'description',
+    'congress',
+    'receivedDate',
+    'authorityDate',
+    'updateDate',
+    'latestAction',
+    'url',
+]);
 /** Nomination committee items — shape {name, systemCode, chamber, type, activities[], url}. */
 function renderNominationCommitteeItem(item, i) {
     const name = s(item, 'name') ?? s(item, 'systemCode') ?? 'Committee';
@@ -754,8 +894,10 @@ function renderNominationCommitteeItem(item, i) {
     const url = s(item, 'url');
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, NOMINATION_COMMITTEE_ROW_KEYS);
 }
+/** `activities` is absent: the curated lines cut each activity date to 10 chars. */
+const NOMINATION_COMMITTEE_ROW_KEYS = new Set(['name', 'systemCode', 'chamber', 'type', 'url']);
 /** Individual nominee items — shape {firstName, middleName, lastName, ordinal, state, prefix?, suffix?}. */
 function renderNomineeItem(item, i) {
     const prefix = s(item, 'prefix');
@@ -769,8 +911,17 @@ function renderNomineeItem(item, i) {
     const meta = join([f('Ordinal', s(item, 'ordinal')), f('State', s(item, 'state'))]);
     if (meta)
         lines.push(meta);
-    return lines.join('\n');
+    return withRowRest(item, lines, NOMINEE_ITEM_KEYS);
 }
+const NOMINEE_ITEM_KEYS = new Set([
+    'prefix',
+    'firstName',
+    'middleName',
+    'lastName',
+    'suffix',
+    'ordinal',
+    'state',
+]);
 /** Nomination hearing items — shape {chamber, citation, date, jacketNumber, number, partNumber, errata?}. */
 function renderNominationHearingItem(item, i) {
     const citation = s(item, 'citation');
@@ -780,7 +931,7 @@ function renderNominationHearingItem(item, i) {
     const partNumber = s(item, 'partNumber');
     const meta = join([
         f('Chamber', s(item, 'chamber')),
-        f('Date', s(item, 'date')?.slice(0, 10)),
+        f('Date', s(item, 'date')),
         f('Number', number),
         partNumber && partNumber !== '1' && partNumber !== '01' ? f('Part', partNumber) : undefined,
         f('Jacket', s(item, 'jacketNumber')),
@@ -788,8 +939,17 @@ function renderNominationHearingItem(item, i) {
     ]);
     if (meta)
         lines.push(meta);
-    return lines.join('\n');
+    return withRowRest(item, lines, NOMINATION_HEARING_ROW_KEYS);
 }
+const NOMINATION_HEARING_ROW_KEYS = new Set([
+    'citation',
+    'number',
+    'chamber',
+    'date',
+    'partNumber',
+    'jacketNumber',
+    'errata',
+]);
 /** Dispatch nomination list rows to the right renderer by shape signal. */
 function pickNominationListRenderer(first) {
     /** Action rows share the bill-action shape (actionDate, text, type, actionCode);
@@ -825,10 +985,9 @@ function renderNominationDetail(item) {
     ]);
     if (meta)
         lines.push(meta);
-    const actionDate = s(item, 'latestAction', 'actionDate');
-    const actionText = s(item, 'latestAction', 'text');
-    if (actionDate || actionText)
-        lines.push(`**Latest Action:** ${[actionDate, actionText].filter(Boolean).join(' — ')}`);
+    const latestAction = latestActionLine(item);
+    if (latestAction)
+        lines.push(latestAction);
     const subResources = [];
     for (const key of ['actions', 'committees', 'hearings']) {
         const sub = item[key];
@@ -946,9 +1105,10 @@ const HEADER_ROLL_VOTE_KEYS = new Set([
 ]);
 /** One member's position: "Warren Davidson (R-OH) → Nay". */
 function renderMemberVoteRow(r) {
+    const named = new Set(MEMBER_VOTE_ROW_KEYS);
     const first = s(r, 'firstName');
     const last = s(r, 'lastName');
-    const name = first && last ? `${first} ${last}` : (last ?? first ?? s(r, 'bioguideId') ?? '?');
+    const name = (first && last ? `${first} ${last}` : (last ?? first)) ?? pick(r, named, 'bioguideId') ?? '?';
     const party = s(r, 'voteParty');
     const state = s(r, 'voteState');
     const cast = s(r, 'voteCast');
@@ -959,8 +1119,11 @@ function renderMemberVoteRow(r) {
             : state
                 ? `(${state})`
                 : undefined;
-    return `- ${[name, loc, cast ? `→ ${cast}` : undefined].filter(Boolean).join(' ')}`;
+    const curated = `- ${[name, loc, cast ? `→ ${cast}` : undefined].filter(Boolean).join(' ')}`;
+    return withUnnamedFields(r, curated, named);
 }
+/** `bioguideId` is named only when it stood in for a missing name. */
+const MEMBER_VOTE_ROW_KEYS = ['firstName', 'lastName', 'voteParty', 'voteState', 'voteCast'];
 /**
  * Member voting positions for one roll call — vote-context header, the
  * `pagination`-derived range footer, then the paginated roster from `data[]`.
@@ -986,6 +1149,9 @@ function renderVoteMembers(result) {
     const legNum = s(vote, 'legislationNumber');
     if (legType && legNum)
         lines.push(`**Legislation:** ${legType} ${legNum}`);
+    const voteRest = renderDetailRest(vote, VOTE_CONTEXT_KEYS);
+    if (voteRest)
+        lines.push('', voteRest);
     if (rows.length === 0) {
         lines.push('', total > 0
             ? `_Page is empty — offset is past the end of ${total} member position${total !== 1 ? 's' : ''}._`
@@ -1003,6 +1169,16 @@ function renderVoteMembers(result) {
     }
     return lines.join('\n');
 }
+/** Fields of the `vote` context sibling the members header already renders. */
+const VOTE_CONTEXT_KEYS = new Set([
+    'rollCallNumber',
+    'congress',
+    'sessionNumber',
+    'voteQuestion',
+    'result',
+    'legislationType',
+    'legislationNumber',
+]);
 // ── Senate roll call votes (LIS feed) ───────────────────────────────
 /**
  * Senate vote payloads come from the LIS XML feed, not the Congress.gov JSON API,
@@ -1032,17 +1208,34 @@ function renderSenateVoteItem(item, i) {
     const title = s(item, 'title');
     if (title)
         lines.push(title);
-    return lines.join('\n');
+    return withRowRest(item, lines, SENATE_VOTE_ROW_KEYS);
 }
+/** `chamber` is the dispatch marker, implicit in the Senate heading. */
+const SENATE_VOTE_ROW_KEYS = new Set([
+    'chamber',
+    'voteNumber',
+    'issue',
+    'result',
+    'question',
+    'measure',
+    'voteDate',
+    'yeas',
+    'nays',
+    'title',
+]);
 /** One Senate member's position — uses the feed's pre-formatted "Baldwin (D-WI)" label. */
 function renderSenateMemberRow(r) {
     const cast = s(r, 'voteCast');
     const full = s(r, 'memberFull');
-    if (full)
-        return `- ${full}${cast ? ` → ${cast}` : ''}`;
+    if (full) {
+        /** The feed composes memberFull from the last name, party, and state. */
+        const named = new Set([...SENATE_MEMBER_ROW_KEYS, 'memberFull', 'lastName', 'party', 'state']);
+        return withUnnamedFields(r, `- ${full}${cast ? ` → ${cast}` : ''}`, named);
+    }
+    const named = new Set([...SENATE_MEMBER_ROW_KEYS, 'firstName', 'lastName', 'party', 'state']);
     const first = s(r, 'firstName');
     const last = s(r, 'lastName');
-    const name = first && last ? `${first} ${last}` : (last ?? first ?? s(r, 'lisMemberId') ?? '?');
+    const name = (first && last ? `${first} ${last}` : (last ?? first)) ?? pick(r, named, 'lisMemberId') ?? '?';
     const party = s(r, 'party');
     const state = s(r, 'state');
     const loc = party && state
@@ -1052,8 +1245,10 @@ function renderSenateMemberRow(r) {
             : state
                 ? `(${state})`
                 : undefined;
-    return `- ${[name, loc, cast ? `→ ${cast}` : undefined].filter(Boolean).join(' ')}`;
+    const curated = `- ${[name, loc, cast ? `→ ${cast}` : undefined].filter(Boolean).join(' ')}`;
+    return withUnnamedFields(r, curated, named);
 }
+const SENATE_MEMBER_ROW_KEYS = ['chamber', 'voteCast'];
 /** Senate vote detail — question, result, tally, derived party totals, document/amendment. */
 function renderSenateVoteDetail(item) {
     const num = s(item, 'voteNumber');
@@ -1170,6 +1365,9 @@ function renderSenateVoteMembers(result) {
     ], ' — ');
     if (context)
         lines.push(context);
+    const voteRest = renderDetailRest(vote, SENATE_VOTE_CONTEXT_KEYS);
+    if (voteRest)
+        lines.push('', voteRest);
     if (rows.length === 0) {
         lines.push('', total > 0
             ? `_Page is empty — offset is past the end of ${total} member position${total !== 1 ? 's' : ''}._`
@@ -1185,6 +1383,17 @@ function renderSenateVoteMembers(result) {
     }
     return lines.join('\n');
 }
+/** Fields of the Senate `vote` context sibling the members header already renders. */
+const SENATE_VOTE_CONTEXT_KEYS = new Set([
+    'chamber',
+    'voteNumber',
+    'congress',
+    'session',
+    'voteQuestionText',
+    'question',
+    'voteResultText',
+    'voteResult',
+]);
 /** Senate payloads carry a `chamber: 'senate'` marker on the envelope, vote, and items. */
 function isSenateResult(result) {
     if (result.chamber === 'senate')
@@ -1213,10 +1422,9 @@ function renderBillDetail(item) {
     ]);
     if (meta)
         lines.push(meta);
-    const actionDate = s(item, 'latestAction', 'actionDate');
-    const actionText = s(item, 'latestAction', 'text');
-    if (actionDate || actionText)
-        lines.push(`**Latest Action:** ${[actionDate, actionText].filter(Boolean).join(' — ')}`);
+    const latestAction = latestActionLine(item);
+    if (latestAction)
+        lines.push(latestAction);
     const citation = lawCitations(item);
     if (citation)
         lines.push(`**Law:** ${citation}`);
@@ -1402,8 +1610,18 @@ function renderCommitteeListItem(item, i) {
     const url = s(item, 'url');
     if (url)
         lines.push(`**URL:** ${url}`);
-    return lines.join('\n');
+    return withRowRest(item, lines, COMMITTEE_ROW_KEYS);
 }
+/** `parent` is absent: a subcommittee row's owning committee code has to reach the reader. */
+const COMMITTEE_ROW_KEYS = new Set([
+    'name',
+    'systemCode',
+    'chamber',
+    'committeeTypeCode',
+    'updateDate',
+    'url',
+    'approximate',
+]);
 /** Committee report list item — citation-first; upstream omits title and bill ref. */
 function renderCommitteeReportListItem(item, i) {
     const citation = s(item, 'citation');
@@ -1428,8 +1646,76 @@ function renderCommitteeReportListItem(item, i) {
         lines.push(meta);
     if (url)
         lines.push(`**URL:** ${url}`);
+    return withRowRest(item, lines, COMMITTEE_REPORT_ROW_KEYS);
+}
+const COMMITTEE_REPORT_ROW_KEYS = new Set([
+    'citation',
+    'type',
+    'number',
+    'part',
+    'congress',
+    'chamber',
+    'updateDate',
+    'url',
+]);
+// ── Document Content (the `content` operation) ──────────────────────
+/**
+ * One character window of a legislative document's text.
+ *
+ * The other renderers in this file reshape upstream JSON records; this one
+ * carries a document body, so the text is emitted verbatim — no entity work, no
+ * whitespace collapsing, no markdown wrapper. GPO's pre-formatted layout (column
+ * alignment, indentation, blank-line structure) *is* the document's structure,
+ * and a code fence would break on the doubled backticks bill text uses for
+ * opening quotation marks.
+ *
+ * The header states the window in both vocabularies: a 1-based human range, and
+ * the 0-based `offset` / `nextOffset` a caller actually feeds back.
+ */
+function renderDocumentContent(content) {
+    const total = typeof content.totalCharacters === 'number' ? content.totalCharacters : 0;
+    const offset = typeof content.offset === 'number' ? content.offset : 0;
+    const text = typeof content.text === 'string' ? content.text : '';
+    const nextOffset = typeof content.nextOffset === 'number' ? content.nextOffset : null;
+    const truncated = content.truncated === true;
+    const title = s(content, 'documentTitle') ?? 'Document';
+    const lines = [`# ${title}`];
+    const range = text.length > 0
+        ? `**Characters ${(offset + 1).toLocaleString('en-US')}–${(offset + text.length).toLocaleString('en-US')} of ${total.toLocaleString('en-US')}**`
+        : `**0 characters**`;
+    lines.push(join([
+        f('Format', s(content, 'format')),
+        range,
+        `**Truncated:** ${truncated}`,
+        `offset: ${offset}`,
+        nextOffset != null ? `next offset: ${nextOffset}` : '_end of document_',
+    ]));
+    const sourceUrl = s(content, 'sourceUrl');
+    if (sourceUrl)
+        lines.push(`**Source:** ${sourceUrl}`);
+    const rest = renderDetailRest(content, DOCUMENT_CONTENT_KEYS);
+    if (rest)
+        lines.push('', rest);
+    lines.push('', text || '_This document is empty._');
     return lines.join('\n');
 }
+const DOCUMENT_CONTENT_KEYS = new Set([
+    'documentTitle',
+    'format',
+    'sourceUrl',
+    'text',
+    'totalCharacters',
+    'offset',
+    'truncated',
+    'nextOffset',
+]);
+/** The `content` payload, when the result carries one. */
+function documentContentOf(result) {
+    const content = result.content;
+    return typeof content === 'object' && content !== null && !Array.isArray(content)
+        ? content
+        : undefined;
+}
 // ── Per-Tool Format Exports ─────────────────────────────────────────
 function makeFormatter(detailKeys, itemRenderer, detailRenderer) {
     return (result) => {
@@ -1449,6 +1735,9 @@ function makeFormatter(detailKeys, itemRenderer, detailRenderer) {
 }
 /** Bill browse, detail, and sub-resources (actions, amendments, cosponsors, etc.). */
 export function formatBills(result) {
+    const content = documentContentOf(result);
+    if (content)
+        return tb(renderDocumentContent(content));
     if (Array.isArray(result.data)) {
         const first = result.data[0];
         const firstRecord = typeof first === 'object' && first !== null ? first : undefined;
@@ -1465,7 +1754,8 @@ export function formatBills(result) {
  * survive into the rendered Markdown.
  */
 function renderBillSubresourceSummaryItem(item, i) {
-    const version = s(item, 'actionDesc') ?? s(item, 'versionCode') ?? 'Summary';
+    const named = new Set(BILL_SUMMARY_SUBRESOURCE_ROW_KEYS);
+    const version = pick(item, named, 'actionDesc', 'versionCode') ?? 'Summary';
     const actionDate = s(item, 'actionDate');
     const updated = s(item, 'updateDate');
     const lines = [`### ${i + 1}. ${version}`];
@@ -1475,8 +1765,9 @@ function renderBillSubresourceSummaryItem(item, i) {
     const text = typeof item.text === 'string' ? htmlToMarkdown(item.text) : '';
     if (text)
         lines.push('', text);
-    return lines.join('\n');
+    return withRowRest(item, lines, named);
 }
+const BILL_SUMMARY_SUBRESOURCE_ROW_KEYS = ['actionDate', 'updateDate', 'text'];
 function pickBillListRenderer(first) {
     if ('title' in first && 'number' in first)
         return renderBillItem;
@@ -1522,8 +1813,19 @@ function renderSearchBillItem(item, i) {
     const summary = s(item, 'summaryPreview');
     if (summary)
         lines.push('', summary);
-    return lines.join('\n');
+    return withRowRest(item, lines, SEARCH_BILL_ROW_KEYS);
 }
+const SEARCH_BILL_ROW_KEYS = new Set([
+    'billId',
+    'billType',
+    'billNumber',
+    'congress',
+    'title',
+    'originChamber',
+    'latestActionDate',
+    'latestActionText',
+    'summaryPreview',
+]);
 /** Local bill keyword search over the FTS mirror. */
 export const formatSearchBills = makeFormatter([], renderSearchBillItem);
 /** Member browse, detail, and sponsored/cosponsored legislation. */
@@ -1578,6 +1880,9 @@ export function formatCommittees(result) {
 }
 /** Committee reports — list, detail, and text. */
 export function formatCommitteeReports(result) {
+    const content = documentContentOf(result);
+    if (content)
+        return tb(renderDocumentContent(content));
     if (Array.isArray(result.data))
         return tb(renderList(result, renderCommitteeReportListItem));
     if (Array.isArray(result.text)) {
@@ -1600,6 +1905,9 @@ export function formatCrsReports(result) {
 }
 /** Daily Congressional Record. Dispatches between volumes/issues and flattened articles. */
 export function formatDailyRecord(result) {
+    const content = documentContentOf(result);
+    if (content)
+        return tb(renderDocumentContent(content));
     if (Array.isArray(result.data)) {
         const first = result.data[0];
         const firstRecord = typeof first === 'object' && first !== null ? first : undefined;