@invinite-org/invinite-data-cli 1.2.0 → 3.0.0

package/README.md

@@ -214,7 +214,7 @@ command. A handful of commands are hand-written because they do more than one ca
 | `segments` | `list`, `list-detailed` |
 | `sec` | Invinite's SEC document store: `filers`, `filer`, `lifecycle`, `issuers`, `filings` (cursor-paged, `form_facet`), `filing` (its document manifest), `document` / `version` (immutable cited blocks, pages, footnotes), `sections`, `figure`, `fact-places`, `search` (`--mode lexical\|literal`, 100 credits), 13F `holders` / `portfolio` / `holding-deltas` / `form-filers`, `financials-catalog` / `statement` / `financial-fact`, `metric-export` / `export`, `datasets`; downloads `save` (originals), `save-figure`, `export-file` |
 | `earnings` | Calendar, events, live calls, transcripts, Q&A, participants, analysts, guidance and KPI extractions, diff, metrics, prosody, price moves during the call, media, documents, search, company IR documents |
-| `news` | News of US companies from SEC filings and their own newsrooms: `list` (cursor-paged), `get` (full text + attribution), `text` (citable blocks), `developments`, `search` (passages; off until the API enables it), `asset-download` |
+| `news` | News of US companies from SEC filings and their own newsrooms: `list` (cursor-paged), `get` (Invinite's summary + attribution), `text` (the summary in citable blocks), `developments`, `search` (passages; off until the API enables it) |
 | `ownership` | 13F holdings by company / investor, institutions, transactions |
 | `insider-trades`, `ipos`, `market`, `metadata` | Insider transactions, IPOs, market holidays, available metric and filing-section ids |
 | `webhooks` | Earnings-call and `news.published` webhook subscriptions |
@@ -321,10 +321,10 @@ narrow its own publications). The list is cursor-paged: `--all` follows `next_ur
 `--cursor` with the same filters; without `--from` / `--to`, `--all` and `next_cursor` page back through the whole history; with either, the window is at most 92 days.
 
 Every item carries `attribution` (publisher, `source_url`, `published_at`, EDGAR form + accession, `statement`):
-wherever you show a headline or text, show its publisher, link and date with it. `news get` (STANDARD) has the
-`body_text` (`content_status: no_text` = headline and link only); `news text` serves it in blocks (a `409
-revision_changed` = the item was corrected; start again without `--cursor`). Process text with an AI model only when
-`model_processing_allowed` is `true`. `news asset-download` returns a URL valid for at most 60 seconds.
+wherever you show a headline or text, show its publisher, link and date with it. `news get` (STANDARD) has Invinite's
+summary of the publication, `summary_text` / `summary_html` (`content_status: no_text` = headline and link only), never
+the publisher's own text; `news text` serves the summary in blocks (a `409 revision_changed` = the item was corrected;
+start again without `--cursor`). `news search --field title|lede|summary|any` picks the searched text.
 
 `earnings transcript` and `news get` also carry the branded PDF of the version (`pdf`, a permanent public URL, or null while
 none exists): `--pdf` prints the URL, `--pdf-out <file>` saves the file (an error without a PDF). `earnings versions` lists

package/claude-plugin/agents/invinite-data.md

@@ -44,7 +44,7 @@ Common multi-step patterns:
 - **Comparative analysis**: metadata metrics (first) + financials snapshot with multiple tickers + metrics ratios for each
 - **Earnings call review**: earnings events (first, for the `event_id`) → then in parallel press-release + extractions `--kind guidance` + extractions `--kind kpi` + qa + diff (+ optionally price-attribution: minute price moves next to what was said — temporal coincidence, not cause)
 - **Guidance tracking**: earnings guidance-history `--metric <metric>` across calls + extractions of the latest call
-- **Company announcements**: news list `--publisher <cik>` (what the company published itself; `--ticker` = items mentioning it) → news get `--id <id>` for `body_text` + news developments `--publisher <cik>`; keep each item's `attribution` (publisher, `source_url`, `published_at`, EDGAR form + accession) in the results so the caller can cite it
+- **Company announcements**: news list `--publisher <cik>` (what the company published itself; `--ticker` = items mentioning it) → news get `--id <id>` for `summary_text` (Invinite's summary) + news developments `--publisher <cik>`; keep each item's `attribution` (publisher, `source_url`, `published_at`, EDGAR form + accession) in the results so the caller can cite it
 
 ## Output format
 

package/claude-plugin/skills/invinite-data-cli/SKILL.md

@@ -39,7 +39,7 @@ Use the connected Invinite Data API MCP tools when available. Fall back to the `
 | Company IR documents (annual reports, proxy, ESG, investor-day decks, letters, webcast pages) | `earnings_company_documents`, `earnings_company_document` | `invd earnings company-documents\|document` |
 | Search company documents (passages with page numbers) | `earnings_document_search` | `invd earnings document-search` |
 | Keyword / guidance alerts | `earnings_call_alert_create\|list\|update\|delete\|test\|deliveries` | `invd webhooks …` |
-| News (SEC filings and the companies' own newsrooms; full text with attribution), its text in blocks, AI-read developments | `news_list`, `news_item`, `news_text`, `news_developments`, `news_search` | `invd news list\|get\|text\|developments\|search` (`news asset-download` is CLI-only) |
+| News (SEC filings and the companies' own newsrooms; Invinite's summary with attribution), the summary in blocks, AI-read developments | `news_list`, `news_item`, `news_text`, `news_developments`, `news_search` | `invd news list\|get\|text\|developments\|search` |
 
 The discovery rules below apply to both transports: call `list_available_metrics` before ratios, growth, CAGR, or financial-statement analysis, and call `list_available_section_ids` before requesting filing sections.
 
@@ -153,12 +153,11 @@ invd webhooks deliveries --id <id> --json
 
 `invd news list` (FREE) lists items newest first from SEC EDGAR filings (`rights: public_record`) and the companies' own newsrooms (`rights: issuer`); wire services are never a source. `--ticker` / `--cik` = items that MENTION the company; `--publisher <cik>` = items the company PUBLISHED itself (its verified newsroom publication) — "what did NVIDIA announce" is `--publisher 1045810`, not `--ticker NVDA`. `--publication-type`, `--issuer-category` and `--issuer-tag` narrow the publisher's own publications (the last two need exactly one `--publisher`). Without `--from` / `--to` it pages back through the whole history; with either, the window is at most 92 days. Pages use a cursor, not an offset: `--all` follows `next_url`; by hand pass `next_cursor` as `--cursor` with the same filters.
 
-- **Attribution duty.** Every item carries `attribution` (`publisher`, `source_url`, `published_at`, `edgar.form` + `edgar.accession` for a filing, `statement`). Whenever you quote or show a headline, lede, `body_text` or text block, name the publisher, link `source_url` and give the date (and the form + accession of a filing). The text is the publisher's own words: quote it verbatim, never present it as Invinite's or as verified fact.
-- **Model use.** Process text with an AI model (summaries, extraction) only when the answer's `model_processing_allowed` is `true`; otherwise use the headline, links and attribution only. The MCP tools already withhold the words in that case (`text_withheld`).
-- `invd news get --id <id>` (STANDARD) has `body_text` (`content_status: available`, else `no_text` = headline and link only), `sightings`, `companies`, images / files and up to 20 developments; `invd news text --id <id>` serves the text in citable blocks (a `409 revision_changed` means the item was corrected: restart without `--cursor`). `superseded_by` names a corrected successor.
-- `invd news developments` lists product launches, partnerships, contracts, availability (AI-read from the text, `derived: true`): report `claim_status` as stated (`planned` is a plan, not availability) and cite the `evidence` quotes with the item's attribution.
-- `invd news search -q <keywords>` searches headlines and texts (`-m lexical` keywords, the default; `-m literal` exact characters; `--field title|body|any`; default window 365 days, at most 8 passages). It answers `503 search_disabled` until the API enables it; read `coverage` before concluding from few or no hits, and cite each passage with its item's `attribution`.
-- `invd news asset-download --id <id> --asset-id <asset_id>` returns a URL valid ≤ 60 s (keep the `credit` with the image); never store it.
+- **Attribution duty.** Every item carries `attribution` (`publisher`, `source_url`, `published_at`, `edgar.form` + `edgar.accession` for a filing, `statement`). Whenever you show a headline, lede, `summary_text` or summary block, name the publisher, link `source_url` and give the date (and the form + accession of a filing). The lede, the summary and the developments are Invinite's own wording of the publication (never the publisher's text): present them as a summary of what the publisher stated, not as verified fact, and point to `source_url` for the publisher's own words.
+- **Model use.** `model_processing_allowed` reports the publisher's machine-readable reservation on its ORIGINAL publication; it is informational — every text the API serves (lede, summary, developments) is Invinite's own wording.
+- `invd news get --id <id>` (STANDARD) has Invinite's long summary as `summary_text` / `summary_html` with `summary_words`, `source_words` and `summarized_at` (`content_status: available`, else `no_text` = headline and link only: an item published before summaries started, a metadata-only item or a reserved source), the branded PDF (`pdf`), `sightings`, `companies` and up to 20 developments; `invd news text --id <id>` serves the summary in citable blocks (`index`, `kind` heading / paragraph / list, `heading`, `text`; a `409 revision_changed` means the item was corrected: restart without `--cursor`). `superseded_by` names a corrected successor.
+- `invd news developments` lists product launches, partnerships, contracts, availability (AI-read from the text, `derived: true`): report `claim_status` as stated (`planned` is a plan, not availability) and cite the item's attribution.
+- `invd news search -q <keywords>` searches headlines and texts (`-m lexical` keywords, the default; `-m literal` exact characters; `--field title|lede|summary|any`; default window 365 days, at most 8 passages). It answers `503 search_disabled` until the API enables it; read `coverage` before concluding from few or no hits, and cite each passage with its item's `attribution`.
 - New items as they appear: `invd ws listen --news --tickers NVDA` (STANDARD); a webhook: `"events":["news.published"]` in `invd webhooks create --body` (STANDARD and above, filtered by `ciks`).
 
 ```bash
@@ -215,7 +214,7 @@ Earnings calls: calendar, transcripts, Q&A, extractions, media, search and webho
 # Analysts of a company (optional: --limit, --offset, --all)
 invd earnings analysts -i MSFT --json
 
-# Earnings call calendar (optional: --from, --to, --status, --session, --exchange, --event-type, --sort, --limit, --offset, --date-kind, --calendar-status, --all)
+# Earnings call calendar (optional: --from, --to, --status, --session, --exchange, --event-type, --sort, --limit, --offset, --date-kind, --calendar-status, --include-expired, --all)
 invd earnings calendar --json
 
 # Call-over-call diff (optional: --event-id, --identifier, --year, --quarter, --date, --event-type, --vs)
@@ -227,7 +226,7 @@ invd earnings document-search -q "Azure growth" -i MSFT --json
 # Earnings call by ID (optional: --include)
 invd earnings event --event-id 9655a5db-8968-40be-8c79-7cd1a8aed8e9 --json
 
-# Event history of a company (optional: --from, --to, --include, --event-type, --sort, --limit, --offset, --all)
+# Event history of a company (optional: --from, --to, --include, --event-type, --sort, --limit, --offset, --include-expired, --all)
 invd earnings events -i MSFT --json
 
 # Guidance and KPI extractions (optional: --event-id, --identifier, --year, --quarter, --date, --event-type, --kind, --review, --limit, --offset, --all)
@@ -338,40 +337,40 @@ invd earnings document --document-id <document_id> --output annual-report.pdf
 Financial statements (standardized & as-reported)
 
 ```bash
-# As-reported balance sheet (optional: --sort, --limit, --offset, --all)
+# As-reported balance sheet (optional: --sort, --limit, --offset, --reported-only, --all)
 invd financials as-reported-balance-sheet -i AAPL -p annual --json
 
-# As-reported balance sheet (detailed) (optional: --sort, --limit, --offset, --with-formula, --all)
+# As-reported balance sheet (detailed) (optional: --sort, --limit, --offset, --with-formula, --reported-only, --all)
 invd financials as-reported-balance-sheet-detailed -i AAPL -p annual --json
 
-# As-reported balance sheet (presentation) (optional: --sort, --limit, --offset, --all)
+# As-reported balance sheet (presentation) (optional: --sort, --limit, --offset, --reported-only, --all)
 invd financials as-reported-balance-sheet-presentation -i AAPL -p annual --json
 
-# As-reported cash flow statement (optional: --sort, --limit, --offset, --all)
+# As-reported cash flow statement (optional: --sort, --limit, --offset, --reported-only, --display-sign, --all)
 invd financials as-reported-cash-flow -i AAPL -p annual --json
 
-# As-reported cash flow statement (detailed) (optional: --sort, --limit, --offset, --with-formula, --all)
+# As-reported cash flow statement (detailed) (optional: --sort, --limit, --offset, --with-formula, --reported-only, --display-sign, --all)
 invd financials as-reported-cash-flow-detailed -i AAPL -p annual --json
 
-# As-reported cash flow statement (presentation) (optional: --sort, --limit, --offset, --all)
+# As-reported cash flow statement (presentation) (optional: --sort, --limit, --offset, --reported-only, --display-sign, --all)
 invd financials as-reported-cash-flow-presentation -i AAPL -p annual --json
 
-# As-reported income statement (optional: --sort, --limit, --offset, --all)
+# As-reported income statement (optional: --sort, --limit, --offset, --reported-only, --all)
 invd financials as-reported-income-statement -i AAPL -p annual --json
 
-# As-reported income statement (detailed) (optional: --sort, --limit, --offset, --with-formula, --all)
+# As-reported income statement (detailed) (optional: --sort, --limit, --offset, --with-formula, --reported-only, --all)
 invd financials as-reported-income-statement-detailed -i AAPL -p annual --json
 
-# As-reported income statement (presentation) (optional: --sort, --limit, --offset, --all)
+# As-reported income statement (presentation) (optional: --sort, --limit, --offset, --reported-only, --all)
 invd financials as-reported-income-statement-presentation -i AAPL -p annual --json
 
-# As-reported snapshot (optional: --calendar-year, --calendar-quarter)
+# As-reported snapshot (optional: --calendar-year, --calendar-quarter, --reported-only, --display-sign)
 invd financials as-reported-snapshot -i AAPL,MSFT -p annual --json
 
-# As-reported snapshot (detailed) (optional: --calendar-year, --calendar-quarter, --with-formula)
+# As-reported snapshot (detailed) (optional: --calendar-year, --calendar-quarter, --reported-only, --display-sign, --with-formula)
 invd financials as-reported-snapshot-detailed -i AAPL,MSFT -p annual --json
 
-# As-reported snapshot (presentation) (optional: --calendar-year, --calendar-quarter)
+# As-reported snapshot (presentation) (optional: --calendar-year, --calendar-quarter, --reported-only, --display-sign)
 invd financials as-reported-snapshot-presentation -i AAPL,MSFT -p annual --json
 
 # Standardized balance sheet (optional: --sort, --limit, --offset, --all)
@@ -498,27 +497,24 @@ invd metrics ratios -i AAPL -p annual --json
 News of US companies from SEC filings and their own newsrooms: items, full text with attribution, developments and files
 
 ```bash
-# Get a short-lived URL of a news image or file (optional: --purpose)
-invd news asset-download --id 13351ae7-876b-4839-ba2b-78873f6b4e00 --asset-id 612cd78d-b618-42c6-b3be-ff5c9df1a0f7 --json
-
 # List company developments from news (optional: --publisher, --topic, --item-id, --from, --to, --effective-from, --effective-to, --limit, --cursor, --all)
 invd news developments --json
 
-# List news items (optional: --ticker, --cik, --from, --to, --source, --kind, --topic, --earnings, --has-media, --publisher, --publication-type, --issuer-category, --issuer-tag, --limit, --cursor, --all)
+# List news items (optional: --ticker, --cik, --from, --to, --source, --kind, --topic, --earnings, --publisher, --publication-type, --issuer-category, --issuer-tag, --limit, --cursor, --all)
 invd news list --json
 
 # Search news (optional: --mode, --case-sensitive, --field, --ticker, --cik, --publisher, --publisher-host, --kind, --topic, --from, --to, --limit)
 invd news search -q "data center revenue" -m lexical -t NVDA --json
 
-# Get a news item's text in blocks (optional: --limit, --max-chars, --cursor, --all)
-invd news text --id 13351ae7-876b-4839-ba2b-78873f6b4e00 --json
+# Get a news item's summary in blocks (optional: --limit, --max-chars, --cursor, --all)
+invd news text --id 06304274-da4a-400e-9d5c-fb4ce04f01c9 --json
 ```
 
 <!-- invd:hand:news get -->
 ```bash
-# Get a news item (optional: --body text|html|both); --pdf prints its branded PDF's URL, --pdf-out saves the file
-invd news get --body both --id 13351ae7-876b-4839-ba2b-78873f6b4e00 --json
-invd news get --id 13351ae7-876b-4839-ba2b-78873f6b4e00 --pdf-out item.pdf
+# Get a news item with Invinite's summary; --pdf prints its branded PDF's URL, --pdf-out saves the file
+invd news get --id 06304274-da4a-400e-9d5c-fb4ce04f01c9 --json
+invd news get --id 06304274-da4a-400e-9d5c-fb4ce04f01c9 --pdf-out item.pdf
 ```
 <!-- /invd:hand:news get -->
 
@@ -802,7 +798,7 @@ Ask for the company's own publications (publisher = CIK), then read one in full
 ```bash
 invd news list --publisher 1045810 --from 2026-10-29 --json         # what NVIDIA published itself
 invd news list --ticker NVDA --source edgar --from 2026-10-29 --json   # SEC filings mentioning NVIDIA
-invd news get --id <id> --json                                        # body_text + attribution
+invd news get --id <id> --json                                        # summary_text + attribution
 invd news developments --publisher 1045810 --topic product_launch --json
 ```
 Answer with the publisher, the date and the link of each item (`attribution`), and keep "announced" / "planned" claims as such.

package/dist/src/commands/news.js

@@ -1,4 +1,3 @@
-import { Option } from 'commander';
 import chalk from 'chalk';
 import { apiGet } from '../client/api-client.js';
 import { printPdfUrl, savePdf } from '../client/pdf.js';
@@ -11,7 +10,10 @@ import { setJsonMode } from '../shared/spinner.js';
  * The hand-written `invd news get`: it can save the item's PDF, so it is not one REST call plus one view
  * (`src/hand-written-commands.ts`). Every other `news` action is generated and attached to the same group.
  */
-/** The attribution block, then the text it attributes (backend news task 17); the URL above the long text. */
+/**
+ * The attribution block, then Invinite's summary it attributes (backend news summaries task 5, API 2.0.0): the lengths and
+ * the PDF URL above the long text. The publisher's own text is never served.
+ */
 const COLUMNS = [
     'id',
     'published_at',
@@ -19,7 +21,6 @@ const COLUMNS = [
     'kind',
     'source.id',
     'url',
-    'content_status',
     'attribution.publisher',
     'attribution.publisher_host',
     'attribution.source_url',
@@ -28,17 +29,19 @@ const COLUMNS = [
     'attribution.edgar.form',
     'attribution.edgar.accession',
     'attribution.statement',
-    'content_formats',
+    'content_status',
+    'summary_words',
+    'source_words',
+    'summarized_at',
     'pdf.url',
-    'body_text',
-    'body_html',
+    'summary_text',
+    'summary_html',
 ];
 export function registerNewsCommands(program) {
     const news = program.commands.find(command => command.name() === 'news') ?? program.command('news');
     news.command('get')
-        .description('Get a news item')
+        .description("Get a news item with Invinite's summary of the publication")
         .requiredOption('--id <id>', 'News item id')
-        .addOption(new Option('--body <form>', 'Which text forms to return: text = body_text (plain, default), html = body_html (sanitized HTML with the images inline) instead, both = both').choices(['text', 'html', 'both']))
         .option('--pdf', 'Print the URL of the branded PDF of this item')
         .option('--pdf-out <file>', 'Save the branded PDF of this item (e.g. item.pdf)')
         .option('--force', 'Overwrite an existing --pdf-out file')
@@ -48,7 +51,6 @@ export function registerNewsCommands(program) {
             setJsonMode(true);
         const data = await apiGet({
             path: `/v1/news/${encodeURIComponent(cmdOpts.id)}`,
-            params: { body: cmdOpts.body },
         });
         const saved = await savePdf(data.pdf, cmdOpts, 'Downloading news PDF...');
         output(data, opts, () => {

package/dist/src/commands/news.js.map

@@ -1 +1 @@
-{"version":3,"file":"news.js","sourceRoot":"","sources":["../../../src/commands/news.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"news.js","sourceRoot":"","sources":["../../../src/commands/news.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;GAGG;AAEH;;;GAGG;AACH,MAAM,OAAO,GAAG;IACd,IAAI;IACJ,cAAc;IACd,OAAO;IACP,MAAM;IACN,WAAW;IACX,KAAK;IACL,uBAAuB;IACvB,4BAA4B;IAC5B,wBAAwB;IACxB,0BAA0B;IAC1B,oBAAoB;IACpB,wBAAwB;IACxB,6BAA6B;IAC7B,uBAAuB;IACvB,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,eAAe;IACf,SAAS;IACT,cAAc;IACd,cAAc;CACf,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;SAChB,WAAW,CAAC,4DAA4D,CAAC;SACzE,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC;SAC3C,MAAM,CAAC,OAAO,EAAE,+CAA+C,CAAC;SAChE,MAAM,CAAC,kBAAkB,EAAE,mDAAmD,CAAC;SAC/E,MAAM,CAAC,SAAS,EAAE,sCAAsC,CAAC;SACzD,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAwE,EAAE,EAAE;QAC3G,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI;YAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAsB;YAC7C,IAAI,EAAE,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;SACnD,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,yBAAyB,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YACtB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC/F,OAAO;YACT,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,cAAc,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;AACtB,CAAC"}

package/dist/src/generated/cli-manifest.json

@@ -1,6 +1,6 @@
 {
   "specVersion": "1.0.0",
-  "specSha256": "558348830d2357af9cbbb9e5cb7f3ab1d6538afbf990ea779ccb07546df5c405",
+  "specSha256": "f2359dda15915d63db6863c844c1ca07e9cfd365e1296a1901310967b79e24ce",
   "groups": [
     {
       "name": "company",
@@ -601,6 +601,18 @@
             "confirmed"
           ],
           "description": "Filter by `calendar.status` (repeatable), applied beside `status`"
+        },
+        {
+          "name": "include_expired",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Expired calendar rows (an estimate that never became a call, a duplicate, a non-call issuer; see `expired_reason`) are omitted unless true. Default: false"
         }
       ],
       "view": "table",
@@ -1001,6 +1013,18 @@
           "default": 0,
           "example": 0,
           "description": "Number of events to skip for pagination"
+        },
+        {
+          "name": "include_expired",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Expired calendar rows (an estimate that never became a call, a duplicate, a non-call issuer; see `expired_reason`) are omitted unless true. Default: false"
         }
       ],
       "view": "table",
@@ -2242,6 +2266,19 @@
           "default": 0,
           "example": 0,
           "description": "Number of periods to skip for pagination"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
         }
       ],
       "view": "json",
@@ -2327,7 +2364,20 @@
           ],
           "default": "false",
           "example": "true",
-          "description": "Include formula in response"
+          "description": "Include each derived fact's formula (its members and their values)"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
         }
       ],
       "view": "json",
@@ -2401,6 +2451,19 @@
           "default": 0,
           "example": 0,
           "description": "Number of periods to skip for pagination"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
         }
       ],
       "view": "json",
@@ -2474,6 +2537,32 @@
           "default": 0,
           "example": 0,
           "description": "Number of periods to skip for pagination"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
+        },
+        {
+          "name": "display_sign",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "as_filed",
+            "cash_flow_direction"
+          ],
+          "default": "as_filed",
+          "example": "as_filed",
+          "description": "Sign of cash-flow facts. `as_filed` (default): the value as the company tagged it in XBRL. `cash_flow_direction`: a credit-balance cash-flow fact (outside the supplemental disclosures) is negated so outflows read negative. Standardized cash-flow metrics already carry one sign per metric (outflows negative, capital expenditures positive)."
         }
       ],
       "view": "json",
@@ -2559,7 +2648,33 @@
           ],
           "default": "false",
           "example": "true",
-          "description": "Include formula in response"
+          "description": "Include each derived fact's formula (its members and their values)"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
+        },
+        {
+          "name": "display_sign",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "as_filed",
+            "cash_flow_direction"
+          ],
+          "default": "as_filed",
+          "example": "as_filed",
+          "description": "Sign of cash-flow facts. `as_filed` (default): the value as the company tagged it in XBRL. `cash_flow_direction`: a credit-balance cash-flow fact (outside the supplemental disclosures) is negated so outflows read negative. Standardized cash-flow metrics already carry one sign per metric (outflows negative, capital expenditures positive)."
         }
       ],
       "view": "json",
@@ -2633,6 +2748,32 @@
           "default": 0,
           "example": 0,
           "description": "Number of periods to skip for pagination"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
+        },
+        {
+          "name": "display_sign",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "as_filed",
+            "cash_flow_direction"
+          ],
+          "default": "as_filed",
+          "example": "as_filed",
+          "description": "Sign of cash-flow facts. `as_filed` (default): the value as the company tagged it in XBRL. `cash_flow_direction`: a credit-balance cash-flow fact (outside the supplemental disclosures) is negated so outflows read negative. Standardized cash-flow metrics already carry one sign per metric (outflows negative, capital expenditures positive)."
         }
       ],
       "view": "json",
@@ -2706,6 +2847,19 @@
           "default": 0,
           "example": 0,
           "description": "Number of periods to skip for pagination"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
         }
       ],
       "view": "json",
@@ -2791,7 +2945,20 @@
           ],
           "default": "false",
           "example": "true",
-          "description": "Include formula in response"
+          "description": "Include each derived fact's formula (its members and their values)"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
         }
       ],
       "view": "json",
@@ -2865,6 +3032,19 @@
           "default": 0,
           "example": 0,
           "description": "Number of periods to skip for pagination"
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
         }
       ],
       "view": "json",
@@ -2921,6 +3101,32 @@
           "type": "integer",
           "example": 4,
           "description": "Calendar quarter (1-4). For annual periods, should not be provided. For non-annual periods, must be provided together with calendar_year."
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
+        },
+        {
+          "name": "display_sign",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "as_filed",
+            "cash_flow_direction"
+          ],
+          "default": "as_filed",
+          "example": "as_filed",
+          "description": "Sign of cash-flow facts. `as_filed` (default): the value as the company tagged it in XBRL. `cash_flow_direction`: a credit-balance cash-flow fact (outside the supplemental disclosures) is negated so outflows read negative. Standardized cash-flow metrics already carry one sign per metric (outflows negative, capital expenditures positive)."
         }
       ],
       "view": "json",
@@ -2975,6 +3181,32 @@
           "example": 4,
           "description": "Calendar quarter (1-4). For annual periods, should not be provided. For non-annual periods, must be provided together with calendar_year."
         },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
+        },
+        {
+          "name": "display_sign",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "as_filed",
+            "cash_flow_direction"
+          ],
+          "default": "as_filed",
+          "example": "as_filed",
+          "description": "Sign of cash-flow facts. `as_filed` (default): the value as the company tagged it in XBRL. `cash_flow_direction`: a credit-balance cash-flow fact (outside the supplemental disclosures) is negated so outflows read negative. Standardized cash-flow metrics already carry one sign per metric (outflows negative, capital expenditures positive)."
+        },
         {
           "name": "with_formula",
           "in": "query",
@@ -2986,7 +3218,7 @@
           ],
           "default": "false",
           "example": "true",
-          "description": "Include formula in response"
+          "description": "Include each derived fact's formula (its members and their values)"
         }
       ],
       "view": "json",
@@ -3040,6 +3272,32 @@
           "type": "integer",
           "example": 4,
           "description": "Calendar quarter (1-4). For annual periods, should not be provided. For non-annual periods, must be provided together with calendar_year."
+        },
+        {
+          "name": "reported_only",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "default": "false",
+          "example": "true",
+          "description": "`true`: only the facts the company reported (`derived: false`); the pipeline's derived Q4 / TTM / YTD values are left out"
+        },
+        {
+          "name": "display_sign",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "as_filed",
+            "cash_flow_direction"
+          ],
+          "default": "as_filed",
+          "example": "as_filed",
+          "description": "Sign of cash-flow facts. `as_filed` (default): the value as the company tagged it in XBRL. `cash_flow_direction`: a credit-balance cash-flow fact (outside the supplemental disclosures) is negated so outflows read negative. Standardized cash-flow metrics already carry one sign per metric (outflows negative, capital expenditures positive)."
         }
       ],
       "view": "json",
@@ -4565,54 +4823,6 @@
         "periods"
       ]
     },
-    {
-      "operationId": "newsAssetDownload",
-      "group": "news",
-      "action": "asset-download",
-      "method": "get",
-      "path": "/v1/news/{id}/assets/{asset_id}/download",
-      "auth": true,
-      "summary": "Get a short-lived URL of a news image or file",
-      "params": [
-        {
-          "name": "purpose",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "enum": [
-            "display",
-            "download"
-          ],
-          "example": "display",
-          "description": "display = an inline URL (an image with `can_display`, or a PDF with `can_download`: viewed in the browser); download = an attachment (`can_download`). Omitted: download when allowed, else display"
-        },
-        {
-          "name": "id",
-          "in": "path",
-          "required": true,
-          "type": "string",
-          "example": "13351ae7-876b-4839-ba2b-78873f6b4e00",
-          "description": "News item id"
-        },
-        {
-          "name": "asset_id",
-          "in": "path",
-          "required": true,
-          "type": "string",
-          "example": "612cd78d-b618-42c6-b3be-ff5c9df1a0f7",
-          "description": "Asset id (`assets[].id` of the item)"
-        }
-      ],
-      "view": "keyValue",
-      "columns": [
-        "purpose",
-        "url",
-        "expires_at",
-        "content_type",
-        "credit"
-      ],
-      "pagination": "none"
-    },
     {
       "operationId": "newsDevelopments",
       "group": "news",
@@ -4808,18 +5018,6 @@
           "example": "true",
           "description": "true = only earnings news (results, results dates, call announcements, guidance); false = none of it"
         },
-        {
-          "name": "has_media",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "enum": [
-            "true",
-            "false"
-          ],
-          "example": "true",
-          "description": "true = only items with media you can get now (`media_count` > 0: an original PDF or image to show or download); false = items without"
-        },
         {
           "name": "publisher",
           "in": "query",
@@ -4949,12 +5147,13 @@
           "type": "string",
           "enum": [
             "title",
-            "body",
+            "lede",
+            "summary",
             "any"
           ],
           "default": "any",
           "example": "any",
-          "description": "title = headlines and ledes, body = the item text, any = both"
+          "description": "title = headlines, lede = the ledes, summary = the summaries, any = every field"
         },
         {
           "name": "ticker",
@@ -5071,7 +5270,7 @@
       "method": "get",
       "path": "/v1/news/{id}/text",
       "auth": true,
-      "summary": "Get a news item's text in blocks",
+      "summary": "Get a news item's summary in blocks",
       "params": [
         {
           "name": "limit",
@@ -5089,7 +5288,7 @@
           "type": "integer",
           "default": 12000,
           "example": 12000,
-          "description": "Unicode code points per page; a block is never split (the minimum is the largest block)"
+          "description": "Unicode code points per page; a block is never split (the minimum is larger than any block)"
         },
         {
           "name": "cursor",
@@ -5104,7 +5303,7 @@
           "in": "path",
           "required": true,
           "type": "string",
-          "example": "13351ae7-876b-4839-ba2b-78873f6b4e00",
+          "example": "06304274-da4a-400e-9d5c-fb4ce04f01c9",
           "description": "News item id"
         }
       ],

package/dist/src/spec-flags.d.ts

@@ -4,7 +4,7 @@ export declare function flagName(parameterName: string): string;
 export declare const RESERVED_FLAGS: readonly string[];
 /**
  * The JSON-body flags `defineOperationCommand` adds to an operation WITH a request body only: a body-less read may
- * name a parameter `body` (`GET /v1/news/{id}?body=html` → `invd news get --body html`).
+ * name a parameter `body` (a `GET …?body=html` would become `--body html`).
  */
 export declare const BODY_FLAGS: readonly string[];
 /** Short flags commander owns (`-V`, `-h`). */

package/dist/src/spec-flags.js

@@ -6,7 +6,7 @@ export function flagName(parameterName) {
 export const RESERVED_FLAGS = ['json', 'all', 'show-cost', 'version', 'help'];
 /**
  * The JSON-body flags `defineOperationCommand` adds to an operation WITH a request body only: a body-less read may
- * name a parameter `body` (`GET /v1/news/{id}?body=html` → `invd news get --body html`).
+ * name a parameter `body` (a `GET …?body=html` would become `--body html`).
  */
 export const BODY_FLAGS = ['body', 'body-file'];
 /** Short flags commander owns (`-V`, `-h`). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invinite-org/invinite-data-cli",
-  "version": "1.2.0",
+  "version": "3.0.0",
   "type": "module",
   "description": "CLI for the Invinite Data API",
   "publishConfig": {