@cyanheads/gdelt-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Barrel export for all GDELT MCP tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { gdeltGetCoverageBreakdown } from './get-coverage-breakdown.tool.js';
+export { gdeltGetCoverageTimeline } from './get-coverage-timeline.tool.js';
+export { gdeltGetToneDistribution } from './get-tone-distribution.tool.js';
+export { gdeltGetTvClips } from './get-tv-clips.tool.js';
+export { gdeltGetTvContext } from './get-tv-context.tool.js';
+export { gdeltGetTvTrending } from './get-tv-trending.tool.js';
+export { gdeltListTvStations } from './list-tv-stations.tool.js';
+export { gdeltSearchArticles } from './search-articles.tool.js';
+export { gdeltSearchTv } from './search-tv.tool.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/tools/definitions/list-tv-stations.tool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview GDELT TV station listing tool. Lists all television stations available
+ * for TV search with monitoring date ranges and active status.
+ * @module mcp-server/tools/definitions/list-tv-stations.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const gdeltListTvStations: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    stations: z.ZodArray<z.ZodObject<{
+        stationId: z.ZodString;
+        description: z.ZodString;
+        market: z.ZodString;
+        network: z.ZodString;
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        isActive: z.ZodBoolean;
+    }, z.core.$strip>>;
+    activeCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_stations";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The station list returned empty — API may be temporarily unavailable.";
+    readonly recovery: "Retry after a short delay; the station list is static and should always return data.";
+}, {
+    readonly reason: "gdelt_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "GDELT TV API is unreachable or rate-limited.";
+    readonly retryable: true;
+    readonly recovery: "Wait at least 5 seconds before retrying — GDELT enforces 1 request per 5 seconds.";
+}]>;
+//# sourceMappingURL=list-tv-stations.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-tv-stations.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tv-stations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-tv-stations.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;GAyG9B,CAAC"}

package/dist/mcp-server/tools/definitions/list-tv-stations.tool.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview GDELT TV station listing tool. Lists all television stations available
+ * for TV search with monitoring date ranges and active status.
+ * @module mcp-server/tools/definitions/list-tv-stations.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGdeltTvService } from '../../../services/gdelt/gdelt-tv-service.js';
+export const gdeltListTvStations = tool('gdelt_list_tv_stations', {
+    title: 'List GDELT TV Stations',
+    description: 'List all television stations available for TV search with their market, network, monitoring ' +
+        'start date, and monitoring end date. ' +
+        'Stations with an end date within the last 24 hours are flagged as active; ' +
+        'stations with earlier end dates are discontinued. ' +
+        'Use before querying to verify a station was active during the target time period, ' +
+        'or to discover valid station IDs for the stations parameter in other TV tools. ' +
+        'Most station monitoring ended October 2024 when the Internet Archive TV feed stopped updating.',
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    errors: [
+        {
+            reason: 'no_stations',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The station list returned empty — API may be temporarily unavailable.',
+            recovery: 'Retry after a short delay; the station list is static and should always return data.',
+        },
+        {
+            reason: 'gdelt_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'GDELT TV API is unreachable or rate-limited.',
+            retryable: true,
+            recovery: 'Wait at least 5 seconds before retrying — GDELT enforces 1 request per 5 seconds.',
+        },
+    ],
+    input: z.object({}),
+    output: z.object({
+        stations: z
+            .array(z
+            .object({
+            stationId: z.string().describe('Station ID used in TV query operators (e.g. "CNN").'),
+            description: z.string().describe('Human-readable station description.'),
+            market: z.string().describe('Market (e.g. "National", "San Francisco").'),
+            network: z.string().describe('Network affiliation (e.g. "CNN", "NBC").'),
+            startDate: z.string().describe('Monitoring start date in ISO 8601 format.'),
+            endDate: z.string().describe('Monitoring end date in ISO 8601 format.'),
+            isActive: z
+                .boolean()
+                .describe('True when the end date is within the last 24 hours (recently updated feed). ' +
+                'False for discontinued stations.'),
+        })
+            .describe('A single TV station with monitoring metadata.'))
+            .describe('All TV stations sorted by station ID.'),
+        activeCount: z.number().describe('Number of stations currently flagged as active.'),
+        totalCount: z.number().describe('Total number of stations in the list.'),
+    }),
+    async handler(_input, ctx) {
+        ctx.log.info('gdelt_list_tv_stations');
+        const svc = getGdeltTvService();
+        const stations = await svc.listStations(ctx);
+        if (stations.length === 0) {
+            throw ctx.fail('no_stations', 'Station list returned empty', {
+                ...ctx.recoveryFor('no_stations'),
+            });
+        }
+        const sorted = stations.slice().sort((a, b) => a.stationId.localeCompare(b.stationId));
+        const activeCount = sorted.filter((s) => s.isActive).length;
+        ctx.log.info('gdelt_list_tv_stations completed', { total: sorted.length, active: activeCount });
+        return { stations: sorted, activeCount, totalCount: sorted.length };
+    },
+    format: (result) => {
+        const lines = [
+            `## GDELT TV Stations`,
+            `**Total:** ${result.totalCount} | **Active:** ${result.activeCount}`,
+        ];
+        // Group by market for readability
+        const national = result.stations.filter((s) => s.market === 'National');
+        const local = result.stations.filter((s) => s.market !== 'National');
+        if (national.length > 0) {
+            lines.push('\n### National Networks');
+            for (const s of national) {
+                const status = s.isActive ? '✓ Active' : `Ended ${s.endDate}`;
+                lines.push(`- **${s.stationId}** — ${s.description} | ${s.network} | ${s.startDate}–${s.endDate} | ${status}`);
+            }
+        }
+        if (local.length > 0) {
+            lines.push('\n### Local/Regional Stations');
+            for (const s of local) {
+                const status = s.isActive ? '✓ Active' : `Ended ${s.endDate}`;
+                lines.push(`- **${s.stationId}** — ${s.description} | Market: ${s.market} | ${s.network} | ${s.startDate}–${s.endDate} | ${status}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-tv-stations.tool.js.map

package/dist/mcp-server/tools/definitions/list-tv-stations.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tv-stations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-tv-stations.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/search-articles.tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview GDELT article search tool. Full-text search across the last 3 months
+ * of global news coverage in 65+ languages using the GDELT DOC API.
+ * @module mcp-server/tools/definitions/search-articles.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const gdeltSearchArticles: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    timespan: z.ZodOptional<z.ZodString>;
+    startDatetime: z.ZodOptional<z.ZodString>;
+    endDatetime: z.ZodOptional<z.ZodString>;
+    maxRecords: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        date: "date";
+        relevance: "relevance";
+        social: "social";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    articles: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodString;
+        seendate: z.ZodString;
+        domain: z.ZodString;
+        language: z.ZodString;
+        sourcecountry: z.ZodString;
+        socialimage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totalReturned: z.ZodNumber;
+    query: z.ZodString;
+    timespan: z.ZodOptional<z.ZodString>;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_articles";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No articles matched the query within the specified time range.";
+    readonly recovery: "Broaden the query, remove operators, extend timespan, or try synonym terms.";
+}, {
+    readonly reason: "gdelt_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "GDELT DOC API is unreachable or rate-limited.";
+    readonly retryable: true;
+    readonly recovery: "Wait at least 5 seconds before retrying — GDELT enforces 1 request per 5 seconds.";
+}]>;
+//# sourceMappingURL=search-articles.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-articles.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-articles.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-articles.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6J9B,CAAC"}

package/dist/mcp-server/tools/definitions/search-articles.tool.js

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview GDELT article search tool. Full-text search across the last 3 months
+ * of global news coverage in 65+ languages using the GDELT DOC API.
+ * @module mcp-server/tools/definitions/search-articles.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGdeltDocService } from '../../../services/gdelt/gdelt-doc-service.js';
+export const gdeltSearchArticles = tool('gdelt_search_articles', {
+    title: 'Search GDELT Articles',
+    description: 'Search the last 3 months of global news coverage (65+ languages) using the GDELT DOC API. ' +
+        'Returns up to 250 articles with URL, title, source domain, language, country, publication date, and social image URL. ' +
+        'Query supports full GDELT syntax: phrases ("bird flu"), boolean OR ((flu OR pandemic)), source country (sourcecountry:china), ' +
+        'source language (sourcelang:spanish), domain (domain:who.int), GKG theme (theme:DISEASE_OUTBREAK), ' +
+        'tone filter (tone<-5 for negative), proximity (near20:"flu virus"), and repeat (repeat3:"outbreak"). ' +
+        'Note: this API covers only the most recent 3 months — use gdelt_search_tv for historical TV transcripts back to 2009.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    errors: [
+        {
+            reason: 'no_articles',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No articles matched the query within the specified time range.',
+            recovery: 'Broaden the query, remove operators, extend timespan, or try synonym terms.',
+        },
+        {
+            reason: 'gdelt_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'GDELT DOC API is unreachable or rate-limited.',
+            retryable: true,
+            recovery: 'Wait at least 5 seconds before retrying — GDELT enforces 1 request per 5 seconds.',
+        },
+    ],
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Search query. Supports GDELT operators: phrases ("bird flu"), boolean OR ((flu OR pandemic)), ' +
+            'sourcecountry:china, sourcelang:spanish, domain:who.int, theme:DISEASE_OUTBREAK, tone<-5, ' +
+            'near20:"flu virus", repeat3:"outbreak".'),
+        timespan: z
+            .string()
+            .optional()
+            .describe('Time window relative to now, e.g. "24h", "7d", "1m". Ignored when startDatetime/endDatetime are set. ' +
+            'Maximum is 3 months (the full DOC API window). Defaults to the full 3-month window.'),
+        startDatetime: z
+            .string()
+            .optional()
+            .describe('Start of date range in GDELT format YYYYMMDDHHMMSS (e.g. 20240101000000). ' +
+            'Must be used together with endDatetime.'),
+        endDatetime: z
+            .string()
+            .optional()
+            .describe('End of date range in GDELT format YYYYMMDDHHMMSS (e.g. 20240131235959). ' +
+            'Must be used together with startDatetime.'),
+        maxRecords: z
+            .number()
+            .int()
+            .min(1)
+            .max(250)
+            .default(75)
+            .describe('Maximum number of articles to return (1–250).'),
+        sort: z
+            .enum(['date', 'relevance', 'social'])
+            .default('relevance')
+            .describe('Sort order: relevance (default), date (newest first), social (most socially shared).'),
+    }),
+    output: z.object({
+        articles: z
+            .array(z
+            .object({
+            url: z.string().describe('Article URL.'),
+            title: z.string().describe('Article title.'),
+            seendate: z
+                .string()
+                .describe('Publication datetime in GDELT format (YYYYMMDDTHHMMSSZ).'),
+            domain: z.string().describe('Source domain (e.g. "nytimes.com").'),
+            language: z.string().describe('Article language (e.g. "English", "Spanish").'),
+            sourcecountry: z
+                .string()
+                .describe('Country of the source outlet (e.g. "United States").'),
+            socialimage: z
+                .string()
+                .optional()
+                .describe('Social sharing image URL when provided by the source.'),
+        })
+            .describe('A single news article with metadata.'))
+            .describe('Matching articles sorted per the sort parameter.'),
+        totalReturned: z.number().describe('Number of articles returned in this response.'),
+        query: z.string().describe('Echoed query string for use in follow-up calls.'),
+        timespan: z.string().optional().describe('Echoed timespan parameter when provided.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no articles matched — echoes filters and suggests how to broaden. Absent on successful responses.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('gdelt_search_articles', { query: input.query });
+        const svc = getGdeltDocService();
+        const result = await svc.searchArticles({
+            query: input.query,
+            ...(input.timespan && { timespan: input.timespan }),
+            ...(input.startDatetime && { startDatetime: input.startDatetime }),
+            ...(input.endDatetime && { endDatetime: input.endDatetime }),
+            maxRecords: input.maxRecords,
+            sort: input.sort,
+        }, ctx);
+        if (result.articles.length === 0) {
+            throw ctx.fail('no_articles', `No articles matched "${input.query}"`, {
+                recovery: {
+                    hint: `No articles matched "${input.query}". Try broadening the query or extending the timespan.`,
+                },
+            });
+        }
+        ctx.log.info('gdelt_search_articles completed', { count: result.articles.length });
+        return {
+            articles: result.articles,
+            totalReturned: result.totalReturned,
+            query: input.query,
+            ...(input.timespan && { timespan: input.timespan }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## GDELT Article Search`,
+            `**Query:** ${result.query}`,
+            ...(result.timespan ? [`**Timespan:** ${result.timespan}`] : []),
+            `**Articles returned:** ${result.totalReturned}`,
+        ];
+        if (result.notice)
+            lines.push(`\n> ${result.notice}`);
+        for (const a of result.articles) {
+            lines.push(`\n### ${a.title}`);
+            lines.push(`**URL:** ${a.url}`);
+            lines.push(`**Source:** ${a.domain} | **Country:** ${a.sourcecountry} | **Language:** ${a.language}`);
+            lines.push(`**Date:** ${a.seendate}`);
+            if (a.socialimage)
+                lines.push(`**Image:** ${a.socialimage}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-articles.tool.js.map

package/dist/mcp-server/tools/definitions/search-articles.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-articles.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-articles.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/search-tv.tool.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview GDELT TV search tool. Searches US television news closed captions
+ * for spoken mentions and returns normalized per-station coverage time series.
+ * @module mcp-server/tools/definitions/search-tv.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const gdeltSearchTv: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    stations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    timespan: z.ZodOptional<z.ZodString>;
+    startDatetime: z.ZodOptional<z.ZodString>;
+    endDatetime: z.ZodOptional<z.ZodString>;
+    smoothing: z.ZodOptional<z.ZodNumber>;
+    normalize: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    query: z.ZodString;
+    dateResolution: z.ZodEnum<{
+        hour: "hour";
+        day: "day";
+        month: "month";
+    }>;
+    timeRange: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+    }, z.core.$strip>;
+    series: z.ZodArray<z.ZodObject<{
+        station: z.ZodString;
+        data: z.ZodArray<z.ZodObject<{
+            date: z.ZodString;
+            value: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    normalized: z.ZodBoolean;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_tv_coverage";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No TV coverage found for the query in the specified time range.";
+    readonly recovery: string;
+}, {
+    readonly reason: "gdelt_unavailable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "GDELT TV API is unreachable or rate-limited.";
+    readonly retryable: true;
+    readonly recovery: "Wait at least 5 seconds before retrying — GDELT enforces 1 request per 5 seconds.";
+}]>;
+//# sourceMappingURL=search-tv.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-tv.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tv.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-tv.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgLxB,CAAC"}

package/dist/mcp-server/tools/definitions/search-tv.tool.js

@@ -0,0 +1,159 @@
+/**
+ * @fileoverview GDELT TV search tool. Searches US television news closed captions
+ * for spoken mentions and returns normalized per-station coverage time series.
+ * @module mcp-server/tools/definitions/search-tv.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getGdeltTvService } from '../../../services/gdelt/gdelt-tv-service.js';
+export const gdeltSearchTv = tool('gdelt_search_tv', {
+    title: 'Search GDELT TV News',
+    description: 'Search US television news closed captions (2009–October 2024, 150+ stations) for spoken mentions ' +
+        'of a query. Returns a normalized per-station time series showing relative airtime devoted to the topic. ' +
+        'Use the stations parameter to compare specific networks (e.g. ["CNN", "FOXNEWS", "MSNBC"]); ' +
+        'omit to get combined national coverage. ' +
+        'TV query also supports in-query operators: station:CNN, network:CBS, market:"National", ' +
+        'show:"Anderson Cooper 360", context:"vaccine". ' +
+        'Important: most station monitoring ended October 2024 — use gdelt_list_tv_stations to verify ' +
+        'active date ranges before querying recent events.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    errors: [
+        {
+            reason: 'no_tv_coverage',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No TV coverage found for the query in the specified time range.',
+            recovery: 'Check that the stations were active during the time range using gdelt_list_tv_stations, ' +
+                'broaden the query, or extend the timespan.',
+        },
+        {
+            reason: 'gdelt_unavailable',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'GDELT TV API is unreachable or rate-limited.',
+            retryable: true,
+            recovery: 'Wait at least 5 seconds before retrying — GDELT enforces 1 request per 5 seconds.',
+        },
+    ],
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Search query for TV transcript content. Supports TV operators: ' +
+            'station:CNN, network:CBS, market:"National", show:"Anderson Cooper", context:"vaccine". ' +
+            'Boolean OR and phrase operators also work.'),
+        stations: z
+            .array(z.string())
+            .optional()
+            .describe('Station IDs to filter to (e.g. ["CNN", "FOXNEWS", "MSNBC"]). ' +
+            'Omit to get coverage across all available stations. ' +
+            'Use gdelt_list_tv_stations to see valid station IDs.'),
+        timespan: z
+            .string()
+            .optional()
+            .describe('Time window, e.g. "1m", "6m", "1y". ' +
+            'Ignored when startDatetime/endDatetime are set. ' +
+            'TV data spans 2009–October 2024.'),
+        startDatetime: z
+            .string()
+            .optional()
+            .describe('Start datetime in GDELT format YYYYMMDDHHMMSS. Must pair with endDatetime.'),
+        endDatetime: z
+            .string()
+            .optional()
+            .describe('End datetime in GDELT format YYYYMMDDHHMMSS. Must pair with startDatetime.'),
+        smoothing: z
+            .number()
+            .int()
+            .min(0)
+            .max(5)
+            .optional()
+            .describe('Smoothing window in timesteps (0 = none). Reduces noise for sporadic topics.'),
+        normalize: z
+            .boolean()
+            .default(true)
+            .describe('When true (default), values are normalized as % of total airtime, enabling cross-station comparison. ' +
+            'When false, returns raw coverage volume.'),
+    }),
+    output: z.object({
+        query: z.string().describe('Echoed query string.'),
+        dateResolution: z
+            .enum(['hour', 'day', 'month'])
+            .describe('Temporal resolution of data points.'),
+        timeRange: z
+            .object({
+            start: z.string().describe('Earliest date in the returned data.'),
+            end: z.string().describe('Latest date in the returned data.'),
+        })
+            .describe('Date range spanned by the returned data.'),
+        series: z
+            .array(z
+            .object({
+            station: z.string().describe('Station ID (e.g. "CNN").'),
+            data: z
+                .array(z
+                .object({
+                date: z.string().describe('Timestep in ISO 8601 format.'),
+                value: z.number().describe('Coverage value (normalized % or raw count).'),
+            })
+                .describe('A single coverage data point.'))
+                .describe('Time-ordered coverage data for this station.'),
+        })
+            .describe('Coverage time series for a single station.'))
+            .describe('One series per station or combined national coverage.'),
+        normalized: z.boolean().describe('True when values are normalized coverage percentages.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no coverage was found. Absent on successful responses.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('gdelt_search_tv', { query: input.query, stations: input.stations });
+        const svc = getGdeltTvService();
+        const result = await svc.searchTv({
+            query: input.query,
+            ...(input.stations?.length && { stations: input.stations }),
+            ...(input.timespan && { timespan: input.timespan }),
+            ...(input.startDatetime && { startDatetime: input.startDatetime }),
+            ...(input.endDatetime && { endDatetime: input.endDatetime }),
+            ...(input.smoothing != null && { smoothing: input.smoothing }),
+            normalize: input.normalize,
+        }, ctx);
+        if (result.series.length === 0 || result.series.every((s) => s.data.length === 0)) {
+            throw ctx.fail('no_tv_coverage', `No TV coverage found for "${input.query}"`, {
+                recovery: {
+                    hint: `No TV coverage for "${input.query}". Most TV data ends October 2024 — ` +
+                        `use gdelt_list_tv_stations to check station active dates.`,
+                },
+            });
+        }
+        ctx.log.info('gdelt_search_tv completed', { seriesCount: result.series.length });
+        return {
+            query: input.query,
+            dateResolution: result.dateResolution,
+            timeRange: result.timeRange,
+            series: result.series,
+            normalized: result.normalized,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## GDELT TV News Coverage`,
+            `**Query:** ${result.query}`,
+            `**Date Resolution:** ${result.dateResolution}`,
+            `**Time Range:** ${result.timeRange.start} to ${result.timeRange.end}`,
+            `**Normalized:** ${result.normalized ? 'Yes (% of airtime)' : 'No (raw count)'}`,
+            `**Stations:** ${result.series.length}`,
+        ];
+        if (result.notice)
+            lines.push(`\n> ${result.notice}`);
+        for (const s of result.series) {
+            const peak = s.data.reduce((max, d) => (d.value > max.value ? d : max), s.data[0] ?? { date: '', value: 0 });
+            const total = s.data.reduce((sum, d) => sum + d.value, 0);
+            lines.push(`\n### ${s.station}`);
+            lines.push(`Points: ${s.data.length} | Total: ${total.toFixed(2)}`);
+            if (peak.date)
+                lines.push(`Peak: ${peak.value.toFixed(3)} at ${peak.date}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-tv.tool.js.map

package/dist/mcp-server/tools/definitions/search-tv.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tv.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-tv.tool.ts"],"names":[],"mappings":"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"}