@cyanheads/congressgov-mcp-server 0.3.18 → 0.3.20

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

@@ -14,16 +14,31 @@
 function tb(content) {
     return [{ type: 'text', text: content }];
 }
-function stripHtml(html) {
-    return html
+/**
+ * Strip HTML to plain text while preserving paragraph and line breaks. Upstream
+ * summary fields and other narrative bodies ship as HTML; we want the visible
+ * structure (paragraph boundaries) to survive into the rendered Markdown.
+ *
+ * Inline contexts that need single-line output should pass `{ inline: true }`.
+ */
+function stripHtml(html, { inline = false } = {}) {
+    const text = html
+        .replace(/<\s*br\s*\/?\s*>/gi, '\n')
+        .replace(/<\s*\/p\s*>/gi, '\n\n')
         .replace(/<[^>]*>/g, '')
         .replace(/&nbsp;/g, ' ')
         .replace(/&#039;/g, "'")
         .replace(/&amp;/g, '&')
         .replace(/&lt;/g, '<')
         .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/\s+/g, ' ')
+        .replace(/&quot;/g, '"');
+    if (inline)
+        return text.replace(/\s+/g, ' ').trim();
+    return text
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n[ \t]+/g, '\n')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
         .trim();
 }
 /**
@@ -54,7 +69,7 @@ function htmlToMarkdown(html) {
         .replace(/\n{3,}/g, '\n\n')
         .trim();
 }
-/** Safe deep access with HTML stripping. Handles string and number values. */
+/** Safe deep access for compact field display — collapses whitespace to a single line. */
 function s(obj, ...path) {
     let cur = obj;
     for (const key of path) {
@@ -63,7 +78,7 @@ function s(obj, ...path) {
         cur = cur[key];
     }
     if (typeof cur === 'string')
-        return stripHtml(cur);
+        return stripHtml(cur, { inline: true });
     if (typeof cur === 'number')
         return String(cur);
     return;
@@ -85,17 +100,38 @@ function pagHeader(result) {
     return `**${count} result${count !== 1 ? 's' : ''}**${next != null ? ` | next offset: ${next}` : ''}`;
 }
 /** Render a paginated list with header and per-item rendering. */
-function renderList(result, renderItem) {
+function renderList(result, renderItem, query) {
     const items = (result.data ?? []);
     const header = pagHeader(result);
+    const queryLine = query ? `_Search: ${query}_` : undefined;
     if (items.length === 0) {
-        return `${header}\n\nNo results matched the query. Try broadening the filters — widen the date range, drop the type/chamber/state constraint, or remove the date window entirely.`;
+        /** Distinguish "0 total" from "page is past the end" — the header alone reads
+         * as "N items returned but didn't render" when count > 0 and the page is empty. */
+        const p = result.pagination;
+        const total = p?.count ?? 0;
+        const pageHint = total > 0
+            ? `_Page is empty — offset is past the end of ${total} total item${total !== 1 ? 's' : ''}._`
+            : query
+                ? '_No matching results. Broaden the filter or check the criteria above._'
+                : '_No matching results._';
+        return [queryLine, header, '', pageHint].filter(Boolean).join('\n\n');
     }
     const renderer = renderItem ?? renderGenericItem;
     const rendered = items.map((item, i) => typeof item === 'object' && item !== null
         ? renderer(item, i)
         : `${i + 1}. ${String(item)}`);
-    return [header, '', ...rendered].join('\n\n');
+    return [queryLine, header, '', ...rendered].filter(Boolean).join('\n\n');
+}
+/**
+ * Render an object's remaining fields after a hand-built header. Skips keys
+ * already consumed by the header so they don't repeat in the body.
+ */
+function renderDetailRest(obj, skip) {
+    const filtered = {};
+    for (const [k, v] of Object.entries(obj))
+        if (!skip.has(k))
+            filtered[k] = v;
+    return renderDetail(filtered);
 }
 /** Render any object as structured markdown. Used for detail views. */
 function renderDetail(obj) {
@@ -118,13 +154,13 @@ function renderDetail(obj) {
         if (val == null || val === '')
             continue;
         if (typeof val === 'string') {
-            const cleaned = stripHtml(val);
-            if (cleaned.length > 300) {
+            const inline = stripHtml(val, { inline: true });
+            if (inline.length > 300) {
                 lines.push(`**${key}:**`);
-                lines.push(cleaned);
+                lines.push(stripHtml(val));
             }
             else {
-                lines.push(`**${key}:** ${cleaned}`);
+                lines.push(`**${key}:** ${inline}`);
             }
         }
         else if (typeof val === 'number' || typeof val === 'boolean') {
@@ -172,7 +208,7 @@ function renderDetail(obj) {
                     if (v2 == null || v2 === '')
                         continue;
                     if (typeof v2 === 'string')
-                        lines.push(`  **${k2}:** ${stripHtml(v2)}`);
+                        lines.push(`  **${k2}:** ${stripHtml(v2, { inline: true })}`);
                     else if (typeof v2 === 'number' || typeof v2 === 'boolean')
                         lines.push(`  **${k2}:** ${v2}`);
                     else if (typeof v2 === 'object' && v2)
@@ -203,13 +239,13 @@ function renderGenericItem(item, index) {
         if (HEADING_FIELDS.has(key))
             continue;
         if (typeof val === 'string') {
-            const cleaned = stripHtml(val);
-            if (cleaned.length > 300) {
+            const inline = stripHtml(val, { inline: true });
+            if (inline.length > 300) {
                 lines.push(`**${key}:**`);
-                lines.push(cleaned);
+                lines.push(stripHtml(val));
             }
             else {
-                lines.push(`**${key}:** ${cleaned}`);
+                lines.push(`**${key}:** ${inline}`);
             }
         }
         else if (typeof val === 'number' || typeof val === 'boolean') {
@@ -262,7 +298,7 @@ function renderInline(obj) {
         if (val == null || val === '')
             continue;
         if (typeof val === 'string') {
-            const cleaned = stripHtml(val);
+            const cleaned = stripHtml(val, { inline: true });
             const preview = cleaned.length > 120 ? `${cleaned.slice(0, 117)}...` : cleaned;
             parts.push(`${key}: ${preview}`);
         }
@@ -390,7 +426,8 @@ function renderCrsReportItem(item, i) {
     ]);
     if (meta)
         lines.push(meta);
-    lines.push(summary || '_Summary not available._');
+    if (summary)
+        lines.push(summary);
     if (url)
         lines.push(`**URL:** ${url}`);
     return lines.join('\n');
@@ -522,14 +559,533 @@ function renderCommitteeReportTextItem(item, i) {
     }
     return lines.join('\n');
 }
+/** Member-sponsored amendments — `type`/`title` are null upstream; identify by `amendmentNumber`. */
+function renderAmendmentItem(item, i) {
+    const number = s(item, 'amendmentNumber');
+    const url = s(item, 'url') ?? '';
+    /** URL path carries the chamber prefix (samdt / hamdt) we need for a readable type label. */
+    const amdMatch = url.match(/\/amendment\/(\d+)\/(samdt|hamdt|suamdt|huamdt)\//i);
+    const typeCode = amdMatch?.[2]?.toLowerCase();
+    const chamber = typeCode === 'samdt' || typeCode === 'suamdt'
+        ? 'Senate Amendment'
+        : typeCode === 'hamdt' || typeCode === 'huamdt'
+            ? 'House Amendment'
+            : 'Amendment';
+    const heading = number ? `${chamber} ${number}` : 'Amendment';
+    const lines = [`### ${i + 1}. ${heading}`];
+    const meta = join([
+        f('Congress', s(item, 'congress')),
+        f('Introduced', s(item, 'introducedDate')),
+    ]);
+    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(' — ')}`);
+    if (url)
+        lines.push(`**URL:** ${url}`);
+    return lines.join('\n');
+}
+/** 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';
+    const date = s(item, 'date');
+    const lines = [`### ${i + 1}. ${type}`];
+    if (date)
+        lines.push(`**Date:** ${date}`);
+    const formats = item.formats;
+    if (Array.isArray(formats)) {
+        for (const fmt of formats) {
+            const fType = s(fmt, 'type');
+            const fUrl = s(fmt, 'url');
+            if (fType && fUrl)
+                lines.push(`**${fType}:** ${fUrl}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** Nomination type wrapper: `{isCivilian: true}` / `{isMilitary: true}` → readable label. */
+function nominationTypeLabel(raw) {
+    if (!raw || typeof raw !== 'object')
+        return;
+    const t = raw;
+    if (t.isCivilian === true)
+        return 'Civilian';
+    if (t.isMilitary === true)
+        return 'Military';
+    return;
+}
+function nominationHeading(item) {
+    const citation = s(item, 'citation');
+    if (citation)
+        return citation;
+    const number = s(item, 'number');
+    const partNumber = s(item, 'partNumber');
+    if (number && partNumber && partNumber !== '00')
+        return `PN${number}-${Number(partNumber)}`;
+    if (number)
+        return `PN${number}`;
+    return 'Nomination';
+}
+function renderNominationListItem(item, i) {
+    const heading = nominationHeading(item);
+    const type = nominationTypeLabel(item.nominationType);
+    const lines = [`### ${i + 1}. ${heading}`];
+    const description = s(item, 'description');
+    if (description)
+        lines.push(description);
+    const meta = join([
+        f('Congress', s(item, 'congress')),
+        f('Type', type),
+        f('Received', s(item, 'receivedDate')),
+        f('Authority Date', s(item, 'authorityDate')),
+        f('Updated', s(item, 'updateDate')),
+    ]);
+    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 url = s(item, 'url');
+    if (url)
+        lines.push(`**URL:** ${url}`);
+    return lines.join('\n');
+}
+/** Nomination committee items — shape {name, systemCode, chamber, type, activities[], url}. */
+function renderNominationCommitteeItem(item, i) {
+    const name = s(item, 'name') ?? s(item, 'systemCode') ?? 'Committee';
+    const lines = [`### ${i + 1}. ${name}`];
+    const meta = join([
+        f('Code', s(item, 'systemCode')),
+        f('Chamber', s(item, 'chamber')),
+        f('Type', s(item, 'type')),
+    ]);
+    if (meta)
+        lines.push(meta);
+    const activities = item.activities;
+    if (Array.isArray(activities) && activities.length > 0) {
+        lines.push('**Activities:**');
+        for (const a of activities) {
+            const date = s(a, 'date')?.slice(0, 10);
+            const aname = s(a, 'name');
+            lines.push(`- ${[date, aname].filter(Boolean).join(' — ')}`);
+        }
+    }
+    const url = s(item, 'url');
+    if (url)
+        lines.push(`**URL:** ${url}`);
+    return lines.join('\n');
+}
+/** Individual nominee items — shape {firstName, middleName, lastName, ordinal, state, prefix?, suffix?}. */
+function renderNomineeItem(item, i) {
+    const prefix = s(item, 'prefix');
+    const first = s(item, 'firstName');
+    const middle = s(item, 'middleName');
+    const last = s(item, 'lastName');
+    const suffix = s(item, 'suffix');
+    const name = [prefix, first, middle, last, suffix].filter(Boolean).join(' ').trim();
+    const heading = name || 'Nominee';
+    const lines = [`### ${i + 1}. ${heading}`];
+    const meta = join([f('Ordinal', s(item, 'ordinal')), f('State', s(item, 'state'))]);
+    if (meta)
+        lines.push(meta);
+    return lines.join('\n');
+}
+/** Nomination hearing items — shape {chamber, citation, date, jacketNumber, number, partNumber, errata?}. */
+function renderNominationHearingItem(item, i) {
+    const citation = s(item, 'citation');
+    const number = s(item, 'number');
+    const heading = citation ?? (number ? `Hearing ${number}` : 'Hearing');
+    const lines = [`### ${i + 1}. ${heading}`];
+    const partNumber = s(item, 'partNumber');
+    const meta = join([
+        f('Chamber', s(item, 'chamber')),
+        f('Date', s(item, 'date')?.slice(0, 10)),
+        f('Number', number),
+        partNumber && partNumber !== '1' && partNumber !== '01' ? f('Part', partNumber) : undefined,
+        f('Jacket', s(item, 'jacketNumber')),
+        s(item, 'errata') === 'Y' ? '_Errata_' : undefined,
+    ]);
+    if (meta)
+        lines.push(meta);
+    return lines.join('\n');
+}
+/** 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);
+     * bill-specific extensions (committees, sourceSystem) are absent and no-op. */
+    if ('actionDate' in first && 'text' in first)
+        return renderBillActionItem;
+    /** Nominee rows: firstName/lastName, or ordinal + state without citation. */
+    if ('firstName' in first || 'lastName' in first)
+        return renderNomineeItem;
+    /** Committee rows: systemCode + name. */
+    if ('systemCode' in first && 'name' in first)
+        return renderNominationCommitteeItem;
+    /** Hearing rows: jacketNumber is unique to hearings. */
+    if ('jacketNumber' in first)
+        return renderNominationHearingItem;
+    /** Default: nomination list rows (citation/number/partNumber + description/nominationType). */
+    return renderNominationListItem;
+}
+function renderNominationDetail(item) {
+    const heading = nominationHeading(item);
+    const type = nominationTypeLabel(item.nominationType);
+    const lines = [`# ${heading}`];
+    const description = s(item, 'description');
+    if (description)
+        lines.push(description);
+    const meta = join([
+        f('Congress', s(item, 'congress')),
+        f('Type', type),
+        f('Part Number', s(item, 'partNumber')),
+        f('Received', s(item, 'receivedDate')),
+        f('Authority Date', s(item, 'authorityDate')),
+        f('Updated', s(item, 'updateDate')),
+    ]);
+    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 subResources = [];
+    for (const key of ['actions', 'committees', 'hearings']) {
+        const sub = item[key];
+        if (sub && typeof sub.count === 'number' && sub.count > 0)
+            subResources.push(`${sub.count} ${key}`);
+    }
+    if (subResources.length)
+        lines.push(`**Available:** ${subResources.join(', ')}`);
+    const nominees = item.nominees;
+    if (Array.isArray(nominees) && nominees.length > 0) {
+        lines.push(`\n**Nominees (${nominees.length}):**`);
+        for (const n of nominees.slice(0, 20)) {
+            const ord = s(n, 'ordinal');
+            const count = s(n, 'nomineeCount');
+            const org = s(n, 'organization');
+            const title = s(n, 'positionTitle');
+            const parts = [
+                ord ? `Ord ${ord}` : undefined,
+                count ? `${count} nominee(s)` : undefined,
+                org,
+                title,
+            ].filter(Boolean);
+            lines.push(`- ${parts.join(' — ')}`);
+        }
+        if (nominees.length > 20)
+            lines.push(`- _...${nominees.length - 20} more_`);
+    }
+    else if (s(item, 'partNumber') === '00') {
+        /** Parent nominations (partNumber=00) have no nominees array. Sub-resources
+         * also return 0 results — they live on the partitioned children (PN851-1, PN851-2, …). */
+        lines.push('\n_This is a parent nomination. Individual nominees and confirmation actions live on partitioned children (e.g. `PN851-1`, `PN851-2`). Use the partitioned form for `actions`, `committees`, `hearings`, or `nominees`._');
+    }
+    const url = s(item, 'url');
+    if (url)
+        lines.push(`\n**URL:** ${url}`);
+    return lines.join('\n');
+}
+/** Roll call vote detail — question, result, date, party totals. */
+function renderRollVoteDetail(item) {
+    const roll = s(item, 'rollCallNumber');
+    const congress = s(item, 'congress');
+    const session = s(item, 'sessionNumber');
+    const result = s(item, 'result');
+    const question = s(item, 'voteQuestion');
+    const voteType = s(item, 'voteType');
+    const startDate = s(item, 'startDate');
+    const updated = s(item, 'updateDate');
+    const identifier = s(item, 'identifier');
+    const sourceUrl = s(item, 'sourceDataURL');
+    const headingLeft = roll ? `Roll ${roll}` : 'Roll call';
+    const heading = result ? `${headingLeft} — ${result}` : headingLeft;
+    const lines = [`# ${heading}`];
+    if (question)
+        lines.push(`**Question:** ${question}`);
+    const meta = join([
+        f('Congress', congress),
+        f('Session', session),
+        f('Type', voteType),
+        f('Date', startDate),
+        f('Updated', updated),
+        identifier && identifier !== roll ? f('ID', identifier) : undefined,
+    ]);
+    if (meta)
+        lines.push(meta);
+    const totals = item.votePartyTotal;
+    if (Array.isArray(totals) && totals.length > 0) {
+        lines.push('\n**Party Totals:**');
+        for (const t of totals) {
+            const party = s(t, 'party', 'name') ?? s(t, 'voteParty') ?? '?';
+            const yea = s(t, 'yeaTotal') ?? '0';
+            const nay = s(t, 'nayTotal') ?? '0';
+            const present = s(t, 'presentTotal') ?? '0';
+            const notVoting = s(t, 'notVotingTotal') ?? '0';
+            lines.push(`- **${party}:** Yea ${yea}, Nay ${nay}, Present ${present}, Not Voting ${notVoting}`);
+        }
+    }
+    const results = item.results;
+    if (Array.isArray(results) && results.length > 0) {
+        lines.push(`\n**Member Votes:** ${results.length} on this page`);
+        for (const r of results.slice(0, 20)) {
+            const name = s(r, 'firstName') && s(r, 'lastName')
+                ? `${s(r, 'firstName')} ${s(r, 'lastName')}`
+                : (s(r, 'bioguideId') ?? '?');
+            const vote = s(r, 'voteCast');
+            const party = s(r, 'voteParty');
+            const state = s(r, 'voteState');
+            const parts = [
+                name,
+                party && state ? `(${party}-${state})` : undefined,
+                vote ? `→ ${vote}` : undefined,
+            ].filter(Boolean);
+            lines.push(`- ${parts.join(' ')}`);
+        }
+        if (results.length > 20)
+            lines.push(`- _...${results.length - 20} more_`);
+    }
+    if (sourceUrl)
+        lines.push(`\n**Source Data URL:** ${sourceUrl}`);
+    return lines.join('\n');
+}
+/** Bill / law detail — title-first header, then the rest of the structured fields. */
+function renderBillDetail(item) {
+    const type = s(item, 'type')?.toUpperCase() ?? '';
+    const number = s(item, 'number') ?? '';
+    const title = s(item, 'title') ?? 'Untitled';
+    const id = type && number ? `${type} ${number}: ` : '';
+    const lines = [`# ${id}${title}`];
+    const meta = join([
+        f('Congress', s(item, 'congress')),
+        f('Chamber', s(item, 'originChamber')),
+        f('Policy Area', s(item, 'policyArea', 'name')),
+        f('Introduced', s(item, 'introducedDate')),
+        f('Updated', s(item, 'updateDate')),
+    ]);
+    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 laws = item.laws;
+    if (Array.isArray(laws) && laws.length > 0) {
+        const cites = laws
+            .map((law) => {
+            const num = s(law, 'number');
+            const lawType = s(law, 'type');
+            return num && lawType ? `${lawType} ${num}` : (num ?? lawType);
+        })
+            .filter(Boolean);
+        if (cites.length)
+            lines.push(`**Law:** ${cites.join(', ')}`);
+    }
+    const rest = renderDetailRest(item, HEADER_BILL_KEYS);
+    if (rest)
+        lines.push('', rest);
+    return lines.join('\n');
+}
+const HEADER_BILL_KEYS = new Set([
+    'type',
+    'number',
+    'title',
+    'congress',
+    'originChamber',
+    'originChamberCode',
+    'policyArea',
+    'introducedDate',
+    'updateDate',
+    'latestAction',
+    'laws',
+]);
+/** CRS report detail — title-first header, then the rest of the structured fields. */
+function renderCrsReportDetail(item) {
+    const reportNumber = s(item, 'id') ?? s(item, 'reportNumber') ?? s(item, 'number');
+    const title = s(item, 'title') ?? 'Title not available';
+    const heading = reportNumber ? `${reportNumber}: ${title}` : title;
+    const lines = [`# ${heading}`];
+    const meta = join([
+        f('Type', s(item, 'contentType')),
+        f('Status', s(item, 'status')),
+        f('Version', s(item, 'currentVersion') ?? s(item, 'version')),
+        f('Published', s(item, 'publishDate')),
+        f('Updated', s(item, 'updateDate')),
+    ]);
+    if (meta)
+        lines.push(meta);
+    const authors = item.authors;
+    if (Array.isArray(authors) && authors.length > 0) {
+        const names = authors
+            .map((a) => s(a, 'author') ?? s(a, 'name'))
+            .filter(Boolean);
+        if (names.length)
+            lines.push(`**Authors:** ${names.join(', ')}`);
+    }
+    const rest = renderDetailRest(item, HEADER_CRS_KEYS);
+    if (rest)
+        lines.push('', rest);
+    return lines.join('\n');
+}
+const HEADER_CRS_KEYS = new Set([
+    'id',
+    'reportNumber',
+    'number',
+    'title',
+    'contentType',
+    'status',
+    'currentVersion',
+    'version',
+    'publishDate',
+    'updateDate',
+    'authors',
+]);
+/** Member detail. */
+function renderMemberDetail(item) {
+    const name = s(item, 'directOrderName') ??
+        s(item, 'invertedOrderName') ??
+        s(item, 'bioguideId') ??
+        'Unknown';
+    const lines = [`# ${name}`];
+    const meta = join([
+        f('ID', s(item, 'bioguideId')),
+        f('Party', s(item, 'partyName') ?? s(item, 'currentParty')),
+        f('State', s(item, 'state')),
+        item.district != null ? f('District', s(item, 'district')) : undefined,
+        f('Currently Serving', typeof item.currentMember === 'boolean' ? String(item.currentMember) : undefined),
+        f('Birth Year', s(item, 'birthYear')),
+        f('Updated', s(item, 'updateDate')),
+    ]);
+    if (meta)
+        lines.push(meta);
+    const honorific = s(item, 'honorificName');
+    if (honorific)
+        lines.push(`**Honorific:** ${honorific}`);
+    /** terms may be a direct array or nested as `{item: [...]}`. */
+    const rawTerms = item.terms;
+    const termsArr = Array.isArray(rawTerms)
+        ? rawTerms
+        : rawTerms &&
+            typeof rawTerms === 'object' &&
+            Array.isArray(rawTerms.item)
+            ? rawTerms.item
+            : undefined;
+    if (termsArr && termsArr.length > 0) {
+        lines.push(`\n**Terms (${termsArr.length}):**`);
+        const recent = termsArr.slice(-5);
+        for (const term of recent) {
+            const chamber = s(term, 'chamber');
+            const start = s(term, 'startYear');
+            const end = s(term, 'endYear');
+            const party = s(term, 'partyName');
+            const stateName = s(term, 'stateName');
+            const range = start && end ? `${start}–${end}` : start;
+            const parts = [chamber, range, party, stateName].filter(Boolean);
+            lines.push(`- ${parts.join(', ')}`);
+        }
+        if (termsArr.length > 5)
+            lines.push(`- _...${termsArr.length - 5} earlier_`);
+    }
+    const partyHistory = item.partyHistory;
+    if (Array.isArray(partyHistory) && partyHistory.length > 0) {
+        lines.push(`\n**Party History:**`);
+        for (const p of partyHistory) {
+            const partyName = s(p, 'partyName');
+            const start = s(p, 'startYear');
+            const end = s(p, 'endYear');
+            const range = start && end ? `${start}–${end}` : start;
+            const parts = [partyName, range && `(${range})`].filter(Boolean);
+            lines.push(`- ${parts.join(' ')}`);
+        }
+    }
+    const leadership = item.leadership;
+    if (Array.isArray(leadership) && leadership.length > 0) {
+        lines.push(`\n**Leadership Roles (${leadership.length}):**`);
+        for (const l of leadership.slice(0, 10)) {
+            const type = s(l, 'type');
+            const congress = s(l, 'congress');
+            lines.push(`- ${[type, congress ? `Congress ${congress}` : undefined].filter(Boolean).join(' — ')}`);
+        }
+        if (leadership.length > 10)
+            lines.push(`- _...${leadership.length - 10} more_`);
+    }
+    const subResources = [];
+    for (const key of ['sponsoredLegislation', 'cosponsoredLegislation']) {
+        const sub = item[key];
+        if (sub && typeof sub.count === 'number' && sub.count > 0) {
+            const label = key === 'sponsoredLegislation' ? 'sponsored' : 'cosponsored';
+            subResources.push(`${sub.count} ${label}`);
+        }
+    }
+    if (subResources.length)
+        lines.push(`\n**Legislation:** ${subResources.join(', ')}`);
+    const url = s(item, 'url');
+    if (url)
+        lines.push(`\n**URL:** ${url}`);
+    return lines.join('\n');
+}
+/** Committee list item — name + key fields. */
+function renderCommitteeListItem(item, i) {
+    const name = s(item, 'name') ?? s(item, 'systemCode') ?? 'Committee';
+    const lines = [`### ${i + 1}. ${name}`];
+    const meta = join([
+        f('Code', s(item, 'systemCode')),
+        f('Chamber', s(item, 'chamber')),
+        f('Type', s(item, 'committeeTypeCode')),
+        f('Updated', s(item, 'updateDate')),
+    ]);
+    if (meta)
+        lines.push(meta);
+    const url = s(item, 'url');
+    if (url)
+        lines.push(`**URL:** ${url}`);
+    return lines.join('\n');
+}
+/** Committee report list item — citation-first; upstream omits title and bill ref. */
+function renderCommitteeReportListItem(item, i) {
+    const citation = s(item, 'citation');
+    const type = s(item, 'type');
+    const number = s(item, 'number');
+    const part = s(item, 'part');
+    const congress = s(item, 'congress');
+    const chamber = s(item, 'chamber');
+    const updated = s(item, 'updateDate');
+    const url = s(item, 'url');
+    const heading = citation ?? (type && number ? `${type} ${congress ?? ''}-${number}` : 'Committee Report');
+    const lines = [`### ${i + 1}. ${heading}`];
+    const meta = join([
+        f('Congress', congress),
+        f('Chamber', chamber),
+        f('Type', type),
+        f('Number', number),
+        part && part !== '1' ? f('Part', part) : undefined,
+        f('Updated', updated),
+    ]);
+    if (meta)
+        lines.push(meta);
+    if (url)
+        lines.push(`**URL:** ${url}`);
+    return lines.join('\n');
+}
 // ── Per-Tool Format Exports ─────────────────────────────────────────
-function makeFormatter(detailKeys, itemRenderer) {
+/** Read `result.query` (a string) — handlers attach this to echo filter criteria. */
+function queryOf(result) {
+    return typeof result.query === 'string' ? result.query : undefined;
+}
+function makeFormatter(detailKeys, itemRenderer, detailRenderer) {
     return (result) => {
         if (Array.isArray(result.data))
-            return tb(renderList(result, itemRenderer));
+            return tb(renderList(result, itemRenderer, queryOf(result)));
         for (const key of detailKeys) {
-            if (result[key] != null)
-                return tb(renderDetail(result[key]));
+            const detail = result[key];
+            if (detail != null) {
+                const rendered = detailRenderer && typeof detail === 'object' && detail !== null
+                    ? detailRenderer(detail)
+                    : renderDetail(detail);
+                return tb(rendered);
+            }
         }
         return tb(renderDetail(result));
     };
@@ -540,16 +1096,41 @@ export function formatBills(result) {
         const first = result.data[0];
         const firstRecord = typeof first === 'object' && first !== null ? first : undefined;
         const renderer = firstRecord ? pickBillListRenderer(firstRecord) : undefined;
-        return tb(renderList(result, renderer));
+        return tb(renderList(result, renderer, queryOf(result)));
     }
     if (result.bill != null)
-        return tb(renderDetail(result.bill));
+        return tb(renderBillDetail(result.bill));
     return tb(renderDetail(result));
 }
+/**
+ * Bill sub-resource summary item — known shape (no nested `bill.*`, since the
+ * caller already has the bill). Reuses `htmlToMarkdown` so `<p>` / `<strong>`
+ * survive into the rendered Markdown.
+ */
+function renderBillSubresourceSummaryItem(item, i) {
+    const version = s(item, 'actionDesc') ?? s(item, 'versionCode') ?? 'Summary';
+    const actionDate = s(item, 'actionDate');
+    const updated = s(item, 'updateDate');
+    const lines = [`### ${i + 1}. ${version}`];
+    const meta = join([f('Action Date', actionDate), f('Summary Updated', updated)]);
+    if (meta)
+        lines.push(meta);
+    const text = typeof item.text === 'string' ? htmlToMarkdown(item.text) : '';
+    if (text)
+        lines.push('', text);
+    return lines.join('\n');
+}
 function pickBillListRenderer(first) {
     if ('title' in first && 'number' in first)
         return renderBillItem;
-    // Actions always ship a `text` body; most also carry actionDate/actionCode/sourceSystem.
+    /** Bill text versions: `type` + `formats[]`, no `actionDate`. */
+    if ('type' in first && 'formats' in first)
+        return renderBillTextItem;
+    /** Bill sub-resource summaries: `actionDesc`/`versionCode` + `text`, no `actionCode`/`sourceSystem`. */
+    if ('text' in first && ('actionDesc' in first || 'versionCode' in first)) {
+        return renderBillSubresourceSummaryItem;
+    }
+    /** Actions always ship a `text` body; most also carry actionDate/actionCode/sourceSystem. */
     if ('text' in first &&
         ('actionDate' in first || 'actionCode' in first || 'sourceSystem' in first))
         return renderBillActionItem;
@@ -560,16 +1141,23 @@ export const formatSummaries = makeFormatter([], renderSummaryItem);
 /** Member browse, detail, and sponsored/cosponsored legislation. */
 export function formatMembers(result) {
     if (Array.isArray(result.data)) {
+        const hint = queryOf(result);
         const first = result.data[0];
         const firstRecord = typeof first === 'object' && first !== null ? first : undefined;
         if (firstRecord && 'bioguideId' in firstRecord)
-            return tb(renderList(result, renderMemberItem));
-        if (firstRecord && 'number' in firstRecord && 'title' in firstRecord)
-            return tb(renderList(result, renderBillItem));
-        return tb(renderList(result));
+            return tb(renderList(result, renderMemberItem, hint));
+        /** Sponsored/cosponsored may mix bills (type+title) and amendments (amendmentNumber, null type/title).
+         * Dispatch per-row so amendments don't render as 'Untitled'. */
+        if (firstRecord && ('number' in firstRecord || 'amendmentNumber' in firstRecord)) {
+            const dispatch = (item, i) => 'amendmentNumber' in item && item.amendmentNumber != null
+                ? renderAmendmentItem(item, i)
+                : renderBillItem(item, i);
+            return tb(renderList(result, dispatch, hint));
+        }
+        return tb(renderList(result, undefined, hint));
     }
     if (result.member != null)
-        return tb(renderDetail(result.member));
+        return tb(renderMemberDetail(result.member));
     return tb(renderDetail(result));
 }
 /** Pull the committee's display name from nested history when the top-level `name` is missing. */
@@ -584,8 +1172,16 @@ function extractCommitteeName(committee) {
 }
 /** Committee browse, detail, and sub-resources (bills, reports, nominations). */
 export function formatCommittees(result) {
-    if (Array.isArray(result.data))
-        return tb(renderList(result));
+    if (Array.isArray(result.data)) {
+        const hint = queryOf(result);
+        const first = result.data[0];
+        const firstRecord = typeof first === 'object' && first !== null ? first : undefined;
+        /** Committee list rows have `systemCode` + `name`. Sub-resource rows
+         * (bills/reports/nominations) keep their generic / specialized renderers. */
+        if (firstRecord && 'systemCode' in firstRecord && 'name' in firstRecord)
+            return tb(renderList(result, renderCommitteeListItem, hint));
+        return tb(renderList(result, undefined, hint));
+    }
     if (result.committee != null) {
         const committee = result.committee;
         const name = extractCommitteeName(committee);
@@ -597,7 +1193,7 @@ export function formatCommittees(result) {
 /** Committee reports — list, detail, and text. */
 export function formatCommitteeReports(result) {
     if (Array.isArray(result.data))
-        return tb(renderList(result));
+        return tb(renderList(result, renderCommitteeReportListItem, queryOf(result)));
     if (Array.isArray(result.text)) {
         const textResult = { data: result.text, pagination: { count: result.text.length } };
         return tb(renderList(textResult, renderCommitteeReportTextItem));
@@ -611,9 +1207,9 @@ export function formatCommitteeReports(result) {
 /** CRS policy analysis reports. */
 export function formatCrsReports(result) {
     if (Array.isArray(result.data))
-        return tb(renderList(result, renderCrsReportItem));
+        return tb(renderList(result, renderCrsReportItem, queryOf(result)));
     if (result.report != null)
-        return tb(renderDetail(result.report));
+        return tb(renderCrsReportDetail(result.report));
     return tb(renderDetail(result));
 }
 /** Daily Congressional Record — volumes, issues, articles. */
@@ -625,14 +1221,33 @@ export function formatDailyRecord(result) {
         const renderer = firstRecord && ('sectionName' in firstRecord || 'title' in firstRecord)
             ? renderDailyArticleItem
             : renderDailyRecordItem;
-        return tb(renderList(result, renderer));
+        return tb(renderList(result, renderer, queryOf(result)));
     }
     return tb(renderDetail(result));
 }
-/** Enacted public and private laws. */
-export const formatLaws = makeFormatter(['law'], renderBillItem);
+/** Enacted public and private laws. Upstream /law mirrors /bill, so reuse bill formatters. */
+export const formatLaws = makeFormatter(['law'], renderBillItem, renderBillDetail);
 /** House roll call votes and member voting positions. */
-export const formatVotes = makeFormatter(['vote'], renderRollVoteItem);
+export function formatVotes(result) {
+    if (Array.isArray(result.data))
+        return tb(renderList(result, renderRollVoteItem, queryOf(result)));
+    if (result.vote != null)
+        return tb(renderRollVoteDetail(result.vote));
+    return tb(renderDetail(result));
+}
 /** Presidential nominations and Senate confirmation pipeline. */
-export const formatNominations = makeFormatter(['nomination']);
+export function formatNominations(result) {
+    if (Array.isArray(result.data)) {
+        const hint = queryOf(result);
+        const first = result.data[0];
+        const firstRecord = typeof first === 'object' && first !== null ? first : undefined;
+        const renderer = firstRecord
+            ? pickNominationListRenderer(firstRecord)
+            : renderNominationListItem;
+        return tb(renderList(result, renderer, hint));
+    }
+    if (result.nomination != null)
+        return tb(renderNominationDetail(result.nomination));
+    return tb(renderDetail(result));
+}
 //# sourceMappingURL=format-helpers.js.map