From b38070e2109377684d98a742a85771a6f2fe8378 Mon Sep 17 00:00:00 2001 From: Wagner Costa Date: Fri, 28 Aug 2026 21:03:01 -0300 Subject: [PATCH] fix: Add --podcasts to news search for MCP parity and release 0.2.3 --- docs/commands/README.md | 2 +- docs/commands/routes/news.md | 1 + package.json | 2 +- skills/asknews-cli/references/commands/index.md | 2 +- skills/asknews-cli/references/commands/news.md | 1 + skills/asknews-cli/references/task-recipes.md | 4 +++- src/commands/curated.ts | 4 ++++ test/contract/help-coverage.test.ts | 1 + 8 files changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/commands/README.md b/docs/commands/README.md index 1a7cf07..2b53370 100644 --- a/docs/commands/README.md +++ b/docs/commands/README.md @@ -5,7 +5,7 @@ description: Complete generated reference for AskNews CLI commands # CLI command reference -Generated from AskNews CLI 0.2.2 and AskNews API 0.31.1. +Generated from AskNews CLI 0.2.3 and AskNews API 0.31.1. The installed CLI is authoritative. Run `asknews --help` for the exact options in your version. Regenerate these pages with `pnpm sync:openapi`. diff --git a/docs/commands/routes/news.md b/docs/commands/routes/news.md index b7c535e..7f3c58b 100644 --- a/docs/commands/routes/news.md +++ b/docs/commands/routes/news.md @@ -47,6 +47,7 @@ Search enriched real-time or historical news | `--continents ` | Filter on articles where the content is most related to continents in this list. [query, array, optional, allowed: Africa\|Asia\|Oceania\|Europe\|Middle East\|North America\|South America] | | `--sentiment ` | Sentiment to filter articles on. [query, string, optional] Choices: negative, neutral, positive. | | `--authors ` | Authors to filter articles by. [query, array, optional] | +| `--podcasts ` | Control whether podcast transcripts are included alongside news articles. 'include' searches both news and podcasts, 'only' returns only podcasts, and 'none' excludes podcasts. [query, string, optional, default: "include"] Choices: include, only, none. | | `--return-type ` | Format to return articles in. 'dicts' returns a list of article dictionaries with full metadata. 'string' returns a prompt-optimized string format. String is good for accepting concise input into LLMs, dicts is good for detailed analysis and using large json objects for further processing. [query, string, optional, default: "dicts"] Choices: string, dicts. | **Examples:** diff --git a/package.json b/package.json index d5518ff..6f8933c 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@emergentmethods/asknews-cli", - "version": "0.2.2", + "version": "0.2.3", "description": "The official AskNews CLI for humans, automation, and agents", "type": "module", "license": "MIT", diff --git a/skills/asknews-cli/references/commands/index.md b/skills/asknews-cli/references/commands/index.md index 2ac56b8..d4c289e 100644 --- a/skills/asknews-cli/references/commands/index.md +++ b/skills/asknews-cli/references/commands/index.md @@ -1,6 +1,6 @@ # CLI command reference -Generated from AskNews CLI 0.2.2 and AskNews API 0.31.1. +Generated from AskNews CLI 0.2.3 and AskNews API 0.31.1. The installed CLI is authoritative. Run `asknews --help` for the exact options in your version. Regenerate these pages with `pnpm sync:openapi`. diff --git a/skills/asknews-cli/references/commands/news.md b/skills/asknews-cli/references/commands/news.md index 0a204ed..84f3f86 100644 --- a/skills/asknews-cli/references/commands/news.md +++ b/skills/asknews-cli/references/commands/news.md @@ -42,6 +42,7 @@ Search enriched real-time or historical news | `--continents ` | Filter on articles where the content is most related to continents in this list. [query, array, optional, allowed: Africa\|Asia\|Oceania\|Europe\|Middle East\|North America\|South America] | | `--sentiment ` | Sentiment to filter articles on. [query, string, optional] Choices: negative, neutral, positive. | | `--authors ` | Authors to filter articles by. [query, array, optional] | +| `--podcasts ` | Control whether podcast transcripts are included alongside news articles. 'include' searches both news and podcasts, 'only' returns only podcasts, and 'none' excludes podcasts. [query, string, optional, default: "include"] Choices: include, only, none. | | `--return-type ` | Format to return articles in. 'dicts' returns a list of article dictionaries with full metadata. 'string' returns a prompt-optimized string format. String is good for accepting concise input into LLMs, dicts is good for detailed analysis and using large json objects for further processing. [query, string, optional, default: "dicts"] Choices: string, dicts. | **Examples:** diff --git a/skills/asknews-cli/references/task-recipes.md b/skills/asknews-cli/references/task-recipes.md index 3650d46..21a8fd7 100644 --- a/skills/asknews-cli/references/task-recipes.md +++ b/skills/asknews-cli/references/task-recipes.md @@ -34,7 +34,9 @@ The query is a semantic search where keywords are prioritized. Use `--string-gua `--entity-guarantee` when a keyword or entity must be present, and `--reverse-string-guarantee` to exclude a name or concept. Apply date, language, country, domain, entity, or string filters only when justified by the task; inspect `asknews news search --help` for exact syntax and current -enums. Advanced parameters not exposed here (search method, strategy, geo filters, caching) remain +enums. Podcast transcripts are included by default; use `--podcasts none` to exclude them or +`--podcasts only` to search podcasts alone (podcast items have a `domain_url` ending in `.podcast`). +Advanced parameters not exposed here (search method, strategy, geo filters, caching) remain available on `asknews api news search-news`. When answering from articles: diff --git a/src/commands/curated.ts b/src/commands/curated.ts index 7f567cd..1a830b4 100644 --- a/src/commands/curated.ts +++ b/src/commands/curated.ts @@ -223,6 +223,10 @@ function registerNews(program: Command): void { type: "array", itemType: "string", }, + podcasts: { + description: + "Control whether podcast transcripts are included alongside news articles. 'include' searches both news and podcasts, 'only' returns only podcasts, and 'none' excludes podcasts.", + }, return_type: { description: "Format to return articles in. 'dicts' returns a list of article dictionaries with full metadata. 'string' returns a prompt-optimized string format. String is good for accepting concise input into LLMs, dicts is good for detailed analysis and using large json objects for further processing.", diff --git a/test/contract/help-coverage.test.ts b/test/contract/help-coverage.test.ts index e9a37d7..0ba16a4 100644 --- a/test/contract/help-coverage.test.ts +++ b/test/contract/help-coverage.test.ts @@ -106,6 +106,7 @@ describe("command help OpenAPI coverage", () => { "--continents", "--sentiment", "--authors", + "--podcasts", "--return-type", ].sort(), );