@signal4/s4 2.0.0

package/dist/format.js

@@ -0,0 +1,682 @@
+/** Shared formatting utilities — markdown output for MCP tools. */
+const PUBLIC_URL = "https://api.signal4.ca";
+// ---------------------------------------------------------------------------
+// Primitives
+// ---------------------------------------------------------------------------
+export function fmtTime(seconds) {
+    if (seconds == null)
+        return "0:00";
+    const s = Math.floor(seconds);
+    const h = Math.floor(s / 3600);
+    const m = Math.floor((s % 3600) / 60);
+    const sec = s % 60;
+    if (h)
+        return `${h}:${String(m).padStart(2, "0")}:${String(sec).padStart(2, "0")}`;
+    return `${m}:${String(sec).padStart(2, "0")}`;
+}
+export function fmtHours(seconds) {
+    if (!seconds)
+        return "?";
+    const h = seconds / 3600;
+    if (h >= 1)
+        return `${h.toLocaleString("en", { maximumFractionDigits: 1 })}h`;
+    return fmtTime(seconds);
+}
+export function fmtDuration(seconds) {
+    if (!seconds)
+        return "?";
+    const m = Math.floor(seconds / 60);
+    const s = Math.floor(seconds % 60);
+    if (m >= 60) {
+        const h = Math.floor(m / 60);
+        const rm = m % 60;
+        return `${h}h${String(rm).padStart(2, "0")}m`;
+    }
+    return `${m}m${String(s).padStart(2, "0")}s`;
+}
+export function truncate(text, maxlen = 200) {
+    if (!text)
+        return "";
+    const clean = text.replace(/\n/g, " ").trim();
+    if (clean.length <= maxlen)
+        return clean;
+    const cut = clean.slice(0, maxlen);
+    const last = cut.lastIndexOf(" ");
+    return (last > maxlen * 0.5 ? cut.slice(0, last) : cut) + "...";
+}
+export function fmtDate(iso) {
+    return iso ? iso.slice(0, 10) : "?";
+}
+// ---------------------------------------------------------------------------
+// Quote dedup
+// ---------------------------------------------------------------------------
+export function dedupQuotes(quotes) {
+    const seen = new Set();
+    const out = [];
+    for (const q of quotes) {
+        const key = [
+            q.episode_title ?? q.content_id ?? "",
+            q.timestamp_start ?? q.start_time ?? 0,
+            (q.text ?? "").slice(0, 80),
+        ].join("|");
+        if (!seen.has(key)) {
+            seen.add(key);
+            out.push(q);
+        }
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Similarity tier
+// ---------------------------------------------------------------------------
+function simTier(sim) {
+    if (sim >= 0.60)
+        return "strong";
+    if (sim >= 0.45)
+        return "relevant";
+    if (sim >= 0.40)
+        return "borderline";
+    if (sim > 0)
+        return "weak";
+    return "";
+}
+// ---------------------------------------------------------------------------
+// Clip URL
+// ---------------------------------------------------------------------------
+function clipUrl(contentId, start, end, existing) {
+    if (existing && !existing.includes("localhost"))
+        return existing;
+    if (contentId && start != null && end != null) {
+        return `${PUBLIC_URL}/api/v1/media/content/${contentId}?start_time=${start}&end_time=${end}&media_type=audio`;
+    }
+    return "";
+}
+// ---------------------------------------------------------------------------
+// Empty state
+// ---------------------------------------------------------------------------
+export function emptyStateSuggestions(params) {
+    const suggestions = [];
+    if (params.days && params.days < 30)
+        suggestions.push("Try a wider window: days=30");
+    else if (params.days && params.days < 90)
+        suggestions.push("Try a wider window: days=90");
+    if (params.mode === "semantic" && params.topic)
+        suggestions.push("Try hybrid mode: mode='hybrid'");
+    if (params.mode === "keyword" && params.topic)
+        suggestions.push("Try semantic mode: mode='semantic'");
+    if (params.speaker_name && params.topic)
+        suggestions.push("Drop speaker_name to search all speakers");
+    const query = params.topic || params.speaker_name || "this query";
+    let msg = `No matching content for "${query}"`;
+    if (params.days)
+        msg += ` in the last ${params.days} days`;
+    msg += ".";
+    if (suggestions.length)
+        msg += "\n" + suggestions.map((s) => `- ${s}`).join("\n");
+    return msg;
+}
+// ---------------------------------------------------------------------------
+// Quotes
+// ---------------------------------------------------------------------------
+export function formatQuotes(data) {
+    const quotes = dedupQuotes(data.quotes ?? []);
+    if (!quotes.length)
+        return "No quotes found matching your search criteria.";
+    const total = data.total_results ?? quotes.length;
+    const ms = data.processing_time_ms ?? 0;
+    const lines = [`**${total} results** (showing ${quotes.length}, ${ms.toFixed(0)}ms)\n`];
+    for (let i = 0; i < quotes.length; i++) {
+        const q = quotes[i];
+        const spk = q.speaker ?? {};
+        const spkName = spk.name ?? "Unknown";
+        const spkId = spk.identity_id;
+        const conf = spk.confidence ?? 0;
+        const appear = spk.appearance_type ?? "";
+        const sim = q.similarity ?? 0;
+        const ch = q.channel_name ?? "?";
+        const date = fmtDate(q.episode_date);
+        const text = (q.text ?? "").slice(0, 300);
+        const segId = q.segment_id ?? "?";
+        const contentId = q.content_id ?? "?";
+        const tStart = q.timestamp_start ?? q.start_time;
+        const tEnd = q.timestamp_end ?? q.end_time;
+        const clip = clipUrl(q.content_id, tStart ?? undefined, tEnd ?? undefined, q.clip_url);
+        const tier = simTier(sim);
+        const tierStr = tier ? ` ${tier}` : "";
+        const idStr = spkId ? ` id:${spkId}` : "";
+        const clipTag = appear === "clipped" ? " **[clipped]**" : "";
+        const timeStr = tStart != null ? ` ${fmtTime(tStart)}-${fmtTime(tEnd)}` : "";
+        lines.push(`${i + 1}. **${spkName}**${clipTag} (conf:${Math.round(conf * 100)}%${idStr}) on ${ch} ` +
+            `[${date}${timeStr}] sim:${sim.toFixed(2)}${tierStr}`);
+        lines.push(`   seg:${segId} | episode:${contentId}`);
+        if (clip)
+            lines.push(`   🔊 ${clip}`);
+        lines.push(`   > ${text}\n`);
+    }
+    if (total > quotes.length) {
+        lines.push(`_${total - quotes.length} more results available (use offset parameter)_`);
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Speaker
+// ---------------------------------------------------------------------------
+export function formatSpeaker(data) {
+    const name = data.name ?? data.primary_name ?? "Unknown";
+    const lines = [`# ${name}`];
+    if (data.occupation) {
+        let occ = `**${data.occupation}**`;
+        if (data.organization)
+            occ += ` at ${data.organization}`;
+        lines.push(occ);
+    }
+    if (data.bio)
+        lines.push(`\n${data.bio}`);
+    lines.push("");
+    const stats = [];
+    if (data.total_appearances)
+        stats.push(`${data.total_appearances} appearances`);
+    if (data.total_episodes)
+        stats.push(`${data.total_episodes} episodes`);
+    if (data.total_duration_seconds)
+        stats.push(`${fmtHours(data.total_duration_seconds)} total`);
+    if (stats.length)
+        lines.push(`**Stats:** ${stats.join(", ")}`);
+    const sid = data.speaker_id ?? data.id;
+    if (sid)
+        lines.push(`Speaker ID: \`${sid}\``);
+    const topChannels = data.top_channels ?? [];
+    if (topChannels.length) {
+        lines.push("\n**Top Channels:**");
+        for (const ch of topChannels.slice(0, 8)) {
+            lines.push(`- ${ch.name ?? "?"} (ID: ${ch.channel_id ?? "?"}, ${ch.count ?? 0} appearances)`);
+        }
+    }
+    const related = data.related_speakers ?? [];
+    if (related.length) {
+        lines.push("\n**Co-appearances:**");
+        for (const r of related.slice(0, 10)) {
+            const count = r.appearance_count ?? r.co_appearances ?? "?";
+            lines.push(`- ${r.name ?? "?"} (${count})`);
+        }
+    }
+    const recent = data.recent_episodes ?? [];
+    if (recent.length) {
+        lines.push("\n**Recent Episodes:**");
+        for (const ep of recent.slice(0, 8)) {
+            const date = fmtDate(ep.publish_date);
+            lines.push(`- [${date}] ${ep.channel_name ?? "?"} — ${ep.title ?? "?"}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Channel
+// ---------------------------------------------------------------------------
+export function formatChannel(data) {
+    const name = data.display_name ?? data.name ?? "Channel";
+    const lines = [`# ${name}`];
+    const meta = [];
+    if (data.platform)
+        meta.push(`**Platform:** ${data.platform}`);
+    if (data.episode_count)
+        meta.push(`**Episodes:** ${data.episode_count}`);
+    if (data.language)
+        meta.push(`**Language:** ${data.language}`);
+    if (meta.length)
+        lines.push(meta.join(" | "));
+    lines.push(`Channel ID: \`${data.channel_id ?? data.id ?? ""}\``);
+    if (data.description)
+        lines.push(`\n${data.description.slice(0, 500)}`);
+    if (data.primary_url)
+        lines.push(`\nURL: ${data.primary_url}`);
+    const ranking = data.ranking;
+    if (ranking) {
+        const parts = [];
+        if (ranking.tier)
+            parts.push(`tier ${ranking.tier}`);
+        if (ranking.importance_rank)
+            parts.push(`rank #${ranking.importance_rank}`);
+        if (parts.length)
+            lines.push(`\n**Ranking:** ${parts.join(", ")}`);
+        for (const cp of (ranking.chart_positions ?? []).slice(0, 5)) {
+            lines.push(`- Chart: ${cp.platform ?? "?"} ${cp.country ?? "?"}/${cp.category ?? "?"} #${cp.rank ?? "?"}`);
+        }
+    }
+    const speakers = data.regular_speakers ?? data.speakers ?? [];
+    if (speakers.length) {
+        lines.push("\n**Speakers:**");
+        for (const s of speakers.slice(0, 10)) {
+            const count = s.appearance_count ?? s.count ?? "?";
+            lines.push(`- ${s.name ?? "?"} (${count} appearances)`);
+        }
+    }
+    const recent = data.recent_episodes ?? [];
+    if (recent.length) {
+        lines.push("\n**Recent Episodes:**");
+        for (const ep of recent.slice(0, 8)) {
+            lines.push(`- [${fmtDate(ep.publish_date)}] ${ep.title ?? "?"}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Segment
+// ---------------------------------------------------------------------------
+export function formatSegment(data) {
+    const segId = data.segment_id ?? "?";
+    const spk = data.speaker_name ?? "Unknown";
+    const ch = data.channel_name ?? "?";
+    const title = data.episode_title ?? "?";
+    const contentId = data.content_id ?? "?";
+    const date = fmtDate(data.episode_date);
+    const tStart = data.start_time;
+    const tEnd = data.end_time;
+    const clip = clipUrl(data.content_id, tStart ?? undefined, tEnd ?? undefined, data.clip_url);
+    const lines = [
+        `**Segment ${segId}**`,
+        `- **Speaker:** ${spk}`,
+        `- **Channel:** ${ch}`,
+        `- **Episode:** ${title} (\`${contentId}\`)`,
+        `- **Date:** ${date}`,
+    ];
+    if (tStart != null)
+        lines.push(`- **Time:** ${fmtTime(tStart)} – ${fmtTime(tEnd)}`);
+    if (clip)
+        lines.push(`- **Audio clip:** ${clip}`);
+    lines.push(`\n> ${data.text ?? ""}`);
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Analysis
+// ---------------------------------------------------------------------------
+export function formatAnalysis(data) {
+    if (data.error)
+        return `Error: ${data.error}`;
+    const lines = ["**Analysis complete**\n"];
+    const q = data.quantitative_metrics ?? {};
+    const centrality = q.discourse_centrality;
+    if (centrality?.label) {
+        lines.push(`Discourse centrality: ${centrality.label} (${centrality.level ?? "?"}/5)`);
+    }
+    const parts = [];
+    if (q.total_segments)
+        parts.push(`${q.total_segments} segments`);
+    if (q.unique_channels)
+        parts.push(`${q.unique_channels} channels`);
+    if (q.unique_videos ?? q.episode_count)
+        parts.push(`${q.unique_videos ?? q.episode_count} episodes`);
+    if (parts.length)
+        lines.push(parts.join(", ") + "\n");
+    const themes = data.themes ?? [];
+    if (themes.length) {
+        lines.push("**Themes:**");
+        for (let i = 0; i < themes.length; i++) {
+            const t = themes[i];
+            if (!t)
+                continue;
+            const name = t.name ?? t.label ?? `Theme ${i + 1}`;
+            const count = t.segment_count ?? t.count;
+            const countStr = count ? ` (${count} segments)` : "";
+            lines.push(`${i + 1}. ${name}${countStr}`);
+            const desc = t.summary ?? t.description;
+            if (desc)
+                lines.push(`   ${desc.slice(0, 200)}`);
+        }
+        lines.push("");
+    }
+    if (data.summary)
+        lines.push(data.summary);
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Comparison
+// ---------------------------------------------------------------------------
+export function formatComparison(data, topic) {
+    if (data.error)
+        return `Error: ${data.error}`;
+    const lines = [`**Speaker comparison: ${topic}**\n`];
+    const speakers = data.speakers ?? {};
+    for (const [name, sp] of Object.entries(speakers)) {
+        const count = sp.segment_count ?? 0;
+        lines.push(`### ${name} (${count} segments)`);
+        if (sp.position_summary)
+            lines.push(`**Position:** ${sp.position_summary}`);
+        if (sp.framing)
+            lines.push(`**Framing:** ${sp.framing}`);
+        if (sp.tone)
+            lines.push(`**Tone:** ${sp.tone}`);
+        const claims = sp.key_claims ?? [];
+        if (claims.length) {
+            lines.push("**Key claims:**");
+            for (const c of claims.slice(0, 5)) {
+                const text = typeof c === "string" ? c : c.claim ?? String(c);
+                lines.push(`- ${text}`);
+            }
+        }
+        lines.push("");
+    }
+    if (data.comparison || data.summary) {
+        lines.push("---");
+        lines.push(data.comparison ?? data.summary ?? "");
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Dossier
+// ---------------------------------------------------------------------------
+export function formatDossier(data, speakerName, topic) {
+    if (data.error)
+        return `Error: ${data.error}`;
+    const lines = [`**Dossier: ${speakerName} on ${topic}**\n`];
+    const sp = data.speaker ?? {};
+    if (sp.occupation)
+        lines.push(`*${sp.occupation}*`);
+    if (sp.segment_count)
+        lines.push(`${sp.segment_count} segments analyzed\n`);
+    const contras = data.contradictions;
+    if (contras?.verdict) {
+        lines.push(`**Contradiction check:** ${contras.verdict.replace(/_/g, " ")}`);
+        for (const c of contras.contradictions ?? []) {
+            lines.push(`- [${c.severity ?? "?"}] ${c.description ?? "?"}`);
+        }
+        lines.push("");
+    }
+    if (data.summary)
+        lines.push(data.summary);
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Contradictions
+// ---------------------------------------------------------------------------
+export function formatContradictions(data, speakerName, topic) {
+    if (data.error)
+        return `Error: ${data.error}`;
+    const lines = [`**Contradiction check: ${speakerName} on ${topic}**\n`];
+    const contras = data.contradictions ?? {};
+    const verdict = contras.verdict ?? "unknown";
+    lines.push(`**Verdict:** ${verdict.replace(/_/g, " ")}\n`);
+    for (const c of contras.contradictions ?? []) {
+        lines.push(`### [${c.severity ?? "?"}] ${c.description ?? "?"}`);
+        if (c.earlier?.claim)
+            lines.push(`**Earlier** (${c.earlier.date ?? "?"}): ${c.earlier.claim}`);
+        if (c.later?.claim)
+            lines.push(`**Later** (${c.later.date ?? "?"}): ${c.later.claim}`);
+        if (c.possible_context)
+            lines.push(`*Context:* ${c.possible_context}`);
+        lines.push("");
+    }
+    const consistent = contras.consistent_positions ?? [];
+    if (consistent.length) {
+        lines.push("**Consistent positions:**");
+        for (const pos of consistent)
+            lines.push(`- ${pos}`);
+        lines.push("");
+    }
+    const timeline = data.stance_timeline ?? [];
+    if (timeline.length) {
+        lines.push("**Stance timeline:**");
+        for (const t of timeline.slice(0, 20)) {
+            lines.push(`- ${t.segment_id ?? "?"}: ${t.stance ?? "?"} — ${(t.claim ?? "").slice(0, 100)}`);
+        }
+    }
+    if (data.summary && !(contras.contradictions ?? []).length)
+        lines.push(data.summary);
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Briefing / Discourse Summary
+// ---------------------------------------------------------------------------
+export function formatBriefing(data) {
+    const lines = [];
+    const stats = data.statistics ?? {};
+    if (stats.total_episodes || stats.total_channels) {
+        lines.push(`**Briefing:** ${stats.total_episodes ?? "?"} episodes, ` +
+            `${stats.total_channels ?? "?"} channels, ` +
+            `${(stats.total_duration_hours ?? 0).toFixed(0)}h\n`);
+    }
+    for (let i = 0; i < (data.topics ?? []).length; i++) {
+        const t = data.topics[i];
+        const title = t.title ?? t.label ?? "?";
+        const segs = t.segment_count ?? 0;
+        const chs = t.channel_count ?? 0;
+        const score = t.score ?? 0;
+        lines.push(`${i + 1}. **${title}** (${segs} segments, ${chs} channels, score:${score.toFixed(2)})`);
+        const summary = t.summary ?? t.description;
+        if (summary)
+            lines.push(`   ${truncate(summary, 250)}`);
+        for (const c of (t.citations ?? []).slice(0, 2)) {
+            const label = [c.speaker_name, c.channel_name].filter(Boolean).join(" on ");
+            if (c.text)
+                lines.push(`   "${truncate(c.text, 120)}" — ${label}`);
+        }
+        lines.push("");
+    }
+    const events = data.events ?? [];
+    if (events.length) {
+        lines.push("**Key events:**");
+        for (const ev of events.slice(0, 5)) {
+            lines.push(`- ${ev.title ?? ev.description ?? "?"}`);
+        }
+        lines.push("");
+    }
+    const speakers = data.key_speakers ?? [];
+    if (speakers.length) {
+        const parts = speakers.slice(0, 8).map((s) => `${s.name ?? "?"} (${s.segment_count ?? "?"} seg)`);
+        lines.push(`**Key speakers:** ${parts.join(", ")}\n`);
+    }
+    if (data.synthesis)
+        lines.push(data.synthesis);
+    return lines.join("\n") || "No briefing data available.";
+}
+export function formatDiscourseSummary(data) {
+    const lines = [];
+    const synthesis = data.synthesis ??
+        data.summary ??
+        data.text ??
+        data.content;
+    if (synthesis)
+        lines.push(synthesis);
+    const topics = data.topics ?? [];
+    if (topics.length) {
+        lines.push("\n**Topics:**");
+        for (let i = 0; i < topics.length; i++) {
+            const t = topics[i];
+            const name = t.title ?? t.label ?? `Topic ${i + 1}`;
+            const count = t.segment_count;
+            const countStr = count ? ` (${count} segments)` : "";
+            lines.push(`${i + 1}. ${name}${countStr}`);
+            const desc = t.summary ?? t.description;
+            if (desc)
+                lines.push(`   ${desc.slice(0, 200)}`);
+        }
+    }
+    const speakers = data.key_speakers ?? [];
+    if (speakers.length) {
+        lines.push("\n**Key Speakers:**");
+        for (const s of speakers.slice(0, 10)) {
+            lines.push(`- ${s.name ?? "?"}`);
+        }
+    }
+    return lines.join("\n") || "No discourse data available.";
+}
+// ---------------------------------------------------------------------------
+// Topics
+// ---------------------------------------------------------------------------
+export function formatTopics(topics, totalClusters, partition) {
+    if (!topics.length)
+        return "No topic clusters found.";
+    const lines = [
+        `**${topics.length} of ${totalClusters ?? topics.length} topic clusters** (${partition ?? "?"})\n`,
+    ];
+    for (let i = 0; i < topics.length; i++) {
+        const t = topics[i];
+        const catTag = t.category ? ` [${t.category}]` : "";
+        lines.push(`${i + 1}. **${t.title ?? "?"}**${catTag}`);
+        lines.push(`   ${t.segment_count ?? 0} segments across ${t.channel_count ?? 0} channels`);
+        const speakers = t.top_speakers ?? [];
+        if (speakers.length) {
+            lines.push(`   Voices: ${speakers.slice(0, 3).map((s) => s.name ?? "?").join(", ")}`);
+        }
+        const topSeg = (t.top_segments ?? [])[0];
+        if (topSeg?.text) {
+            lines.push(`   "${truncate(topSeg.text, 120)}" — ${topSeg.channel_name ?? ""}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Ad formatters
+// ---------------------------------------------------------------------------
+export function formatAdStats(data) {
+    const lines = ["# Ad Analytics Overview\n"];
+    lines.push(`**${(data.total_ad_hashes ?? 0).toLocaleString()}** confirmed ad sentences`);
+    lines.push(`**${data.total_brands ?? 0}** advertisers (+ ${(data.total_advertisers ?? 0) - (data.total_brands ?? 0)} network promos)`);
+    lines.push(`**${(data.ad_reads_in_window ?? 0).toLocaleString()}** ad reads in last ${data.time_window_days ?? 30}d`);
+    lines.push(`**${(data.episodes_with_ads_in_window ?? 0).toLocaleString()}** episodes with ads`);
+    lines.push(`**${data.avg_ad_read_duration_seconds ?? 0}s** avg ad read duration`);
+    const byCat = data.ads_by_category ?? data.by_category ?? {};
+    if (Object.keys(byCat).length) {
+        lines.push("\n**By Category:**");
+        const sorted = Object.entries(byCat).sort((a, b) => b[1] - a[1]);
+        for (const [cat, count] of sorted) {
+            lines.push(`- ${cat}: ${count.toLocaleString()}`);
+        }
+    }
+    const top = data.top_advertisers ?? [];
+    if (top.length) {
+        lines.push("\n**Top Advertisers:**");
+        for (let i = 0; i < top.length; i++) {
+            const a = top[i];
+            lines.push(`${i + 1}. **${a.name}** (${a.category ?? "?"}) — ` +
+                `${a.total_episode_count.toLocaleString()} episodes, ${a.total_channel_count} channels`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatAdvertiserList(data) {
+    const advs = data.advertisers ?? [];
+    if (!advs.length)
+        return "No advertisers found.";
+    const total = data.total ?? advs.length;
+    const lines = [`**${total} advertisers** (showing ${advs.length})\n`];
+    for (let i = 0; i < advs.length; i++) {
+        const a = advs[i];
+        const aliases = a.aliases?.length ? ` (aka ${a.aliases.slice(0, 3).join(", ")})` : "";
+        lines.push(`${i + 1}. **${a.name}**${aliases} [${a.category ?? "?"}] — ` +
+            `${a.total_episode_count.toLocaleString()} episodes, ${a.total_channel_count} channels`);
+    }
+    return lines.join("\n");
+}
+export function formatAdvertiserDetail(data) {
+    if (data.error)
+        return `Error: ${data.error}`;
+    const lines = [`# ${data.name}`];
+    if (data.category)
+        lines.push(`**Category:** ${data.category}`);
+    if (data.aliases?.length)
+        lines.push(`**Also known as:** ${data.aliases.join(", ")}`);
+    if (data.website)
+        lines.push(`**Website:** ${data.website}`);
+    lines.push(`**Episodes:** ${data.total_episode_count.toLocaleString()} | **Channels:** ${data.total_channel_count}`);
+    if (data.first_seen)
+        lines.push(`**Active:** ${fmtDate(data.first_seen)} — ${fmtDate(data.last_seen)}`);
+    const channels = data.top_channels ?? [];
+    if (channels.length) {
+        lines.push("\n**Top Channels:**");
+        for (const ch of channels.slice(0, 10)) {
+            lines.push(`- ${ch.name} (${ch.platform ?? "?"}) — ${ch.episode_count} episodes`);
+        }
+    }
+    const samples = data.sample_reads ?? [];
+    if (samples.length) {
+        lines.push("\n**Recent Ad Reads:**");
+        for (const s of samples) {
+            const dur = s.duration_seconds ? ` (${s.duration_seconds}s)` : "";
+            lines.push(`- [${fmtDate(s.date)}] ${s.episode_title ?? "?"}${dur}`);
+            if (s.text)
+                lines.push(`  > ${s.text.slice(0, 200)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatChannelAds(data) {
+    if (data.error)
+        return `Error: ${data.error}`;
+    const chName = data.channel?.name ?? data.channel_name ?? "Channel";
+    const lines = [`# Ads on ${chName}`];
+    lines.push(`**${(data.total_ad_reads ?? 0).toLocaleString()}** ad reads in last ${data.time_window_days ?? 30}d\n`);
+    for (let i = 0; i < data.advertisers.length; i++) {
+        const a = data.advertisers[i];
+        const promo = a.is_network_promo ? " [network]" : "";
+        lines.push(`${i + 1}. **${a.name}**${promo} [${a.category ?? "?"}] — ` +
+            `${a.episode_count} episodes, ${a.read_count} reads`);
+    }
+    return lines.join("\n") || "No ad data for this channel.";
+}
+export function formatAdTrends(data) {
+    if (!data.advertisers?.length)
+        return "No trending data available.";
+    const lines = [`# Ad Trends (${data.comparison ?? ""})\n`];
+    for (const a of data.advertisers) {
+        const icon = { growing: "+", declining: "-", new: "NEW", gone: "GONE", stable: "=" }[a.trend] ?? "?";
+        lines.push(`[${icon}] **${a.name}** (${a.category ?? "?"}) — ` +
+            `${a.current_episodes} eps (was ${a.prior_episodes}, ${a.change_pct > 0 ? "+" : ""}${a.change_pct.toFixed(0)}%)`);
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Claims
+// ---------------------------------------------------------------------------
+export function formatClaims(data) {
+    const claims = data.claims ?? [];
+    if (!claims.length)
+        return "No claims found matching your search criteria.";
+    const total = data.total_results ?? claims.length;
+    const ms = data.processing_time_ms ?? 0;
+    const mode = data.search_mode ?? "";
+    const lines = [`**${total} claims** (showing ${claims.length}, ${ms.toFixed(0)}ms, mode: ${mode})\n`];
+    for (let i = 0; i < claims.length; i++) {
+        const c = claims[i];
+        const obs = c.observation_count ?? 0;
+        const eps = c.episode_count ?? 0;
+        const chs = c.channel_count ?? 0;
+        const sim = c.similarity;
+        const topic = c.topic ?? "";
+        const stance = c.stance ?? "";
+        const lastSeen = (c.last_seen ?? "").slice(0, 10);
+        const simStr = sim != null ? ` sim:${sim.toFixed(2)}` : "";
+        const tag = topic ? ` [${topic}]` : "";
+        const stanceStr = stance ? ` (${stance})` : "";
+        lines.push(`${i + 1}. ${c.summary}${tag}${stanceStr}${simStr}`);
+        lines.push(`   ${obs} observations, ${eps} episodes, ${chs} channels, last: ${lastSeen}`);
+        const entities = c.entities ?? [];
+        if (entities.length)
+            lines.push(`   Entities: ${entities.slice(0, 6).join(", ")}`);
+        const speakers = c.top_speakers ?? [];
+        if (speakers.length) {
+            const parts = speakers.slice(0, 3).map((s) => `${s.name} (${s.observation_count})`);
+            lines.push(`   Speakers: ${parts.join(", ")}`);
+        }
+        const channels = c.top_channels ?? [];
+        if (channels.length) {
+            const parts = channels.slice(0, 3).map((ch) => `${ch.name} (${ch.observation_count})`);
+            lines.push(`   Channels: ${parts.join(", ")}`);
+        }
+        const samples = c.sample_observations ?? [];
+        for (const s of samples.slice(0, 2)) {
+            const date = (s.publish_date ?? "").slice(0, 10);
+            const ep = truncate(s.episode_title, 60);
+            const ch = s.channel_name ?? "?";
+            const spk = s.speaker_name ? ` (${s.speaker_name})` : "";
+            lines.push(`   - [${date}] ${ch} — ${ep}${spk}`);
+        }
+        lines.push("");
+    }
+    if (data.has_more) {
+        lines.push(`_${total - claims.length} more claims available (use offset parameter)_`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map