@invinite-org/invinite-data-cli 0.9.1 → 0.10.0

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

@@ -1,6 +1,6 @@
 {
   "specVersion": "1.0.0",
-  "specSha256": "29791b1feb50cba08c83146dd9e871f7a1abdad2a9b72cb52451b83a462d8374",
+  "specSha256": "6c548f91ff9a962b3dd46e4059a57540f1bee64691c69d704d6de35cef78190b",
   "groups": [
     {
       "name": "company",
@@ -42,6 +42,10 @@
       "name": "metrics",
       "description": "Ratios, growth and CAGR derived from the statements"
     },
+    {
+      "name": "news",
+      "description": "News of US companies from SEC filings and their own newsrooms: items, full text with attribution, developments and files"
+    },
     {
       "name": "ownership",
       "description": "13F holdings, holders and position changes of institutional investors"
@@ -1136,8 +1140,8 @@
           "in": "query",
           "required": true,
           "type": "string",
-          "example": "revenue",
-          "description": "Normalized metric (e.g. revenue, eps_non_gaap, segment:iphone)"
+          "example": "revenue_growth",
+          "description": "Normalized metric (e.g. revenue, eps_non_gaap, revenue_growth, segment:iphone)"
         },
         {
           "name": "period_kind",
@@ -4729,6 +4733,568 @@
         "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": "id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "News item id"
+        },
+        {
+          "name": "asset_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "7e2f0c19-5a8b-4d3e-9f1a-2b6c8d0e4a7b",
+          "description": "Asset id (`assets[].id` of the item)"
+        }
+      ],
+      "view": "keyValue",
+      "columns": [
+        "purpose",
+        "url",
+        "expires_at",
+        "content_type",
+        "credit"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "newsDevelopments",
+      "group": "news",
+      "action": "developments",
+      "method": "get",
+      "path": "/v1/news/developments",
+      "auth": true,
+      "summary": "List company developments from news",
+      "params": [
+        {
+          "name": "publisher",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Published by these companies (CIK, padded or not; ≤ 20): an item with a verified issuer-newsroom publication of one of them — not a mention, not the item's first source. The CIK namespace is the SEC's"
+        },
+        {
+          "name": "topic",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "product_launch"
+          ],
+          "description": "Only these topics, comma-separated or repeated: product_launch, product_update, availability, partnership, customer_contract, capacity_expansion, regulatory, research"
+        },
+        {
+          "name": "item_id",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "Only the developments of this news item"
+        },
+        {
+          "name": "from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-22",
+          "description": "Start of the announcement window: an ISO 8601 instant or a day (YYYY-MM-DD, from its UTC midnight). Default: `to` minus 7 days"
+        },
+        {
+          "name": "to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-29",
+          "description": "End of the announcement window: an ISO 8601 instant (exclusive) or a day (inclusive). Default: now. At most 92 days after `from` (400 otherwise)"
+        },
+        {
+          "name": "effective_from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-01",
+          "description": "Effective on or after this day (developments without an effective date are left out)"
+        },
+        {
+          "name": "effective_to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-12-31",
+          "description": "Effective on or before this day (developments without an effective date are left out)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 20,
+          "description": "Developments per page"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "WyIyMDI2LTEwLTI5VDIwOjMwOjA1LjEyMzQ1NloiLCI0YzFkOWU2Mi0zYjdhLTRmMmUtOGQxYy05ZTBhN2I2YzVkNGYiXQ",
+          "description": "`next_cursor` of the previous page (with the same filters); an altered or foreign cursor is a 400 `invalid_cursor`"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "developments",
+      "columns": [
+        "announced_at",
+        "topic",
+        "claim_status",
+        "title",
+        "item.attribution.publisher"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "developments"
+      ]
+    },
+    {
+      "operationId": "newsItem",
+      "group": "news",
+      "action": "get",
+      "method": "get",
+      "path": "/v1/news/{id}",
+      "auth": true,
+      "summary": "Get a news item",
+      "params": [
+        {
+          "name": "id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "News item id"
+        }
+      ],
+      "view": "keyValue",
+      "columns": [
+        "id",
+        "published_at",
+        "title",
+        "kind",
+        "source.id",
+        "url",
+        "content_status",
+        "attribution.publisher",
+        "attribution.publisher_host",
+        "attribution.source_url",
+        "attribution.published_at",
+        "attribution.rights",
+        "attribution.edgar.form",
+        "attribution.edgar.accession",
+        "attribution.statement",
+        "body_text"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "newsItems",
+      "group": "news",
+      "action": "list",
+      "method": "get",
+      "path": "/v1/news",
+      "auth": true,
+      "summary": "List news items",
+      "params": [
+        {
+          "name": "ticker",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "NVDA"
+          ],
+          "description": "Items mentioning these tickers (≤ 20, comma-separated or repeated). `BRK.B` and `BRK-B` both match; responses carry the stored dash spelling. With `cik`, either matches"
+        },
+        {
+          "name": "cik",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Items mentioning these companies by CIK (padded or not, ≤ 20). With `ticker`, either matches"
+        },
+        {
+          "name": "from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-22",
+          "description": "Start of the publication window: an ISO 8601 instant or a day (YYYY-MM-DD, from its UTC midnight). Default: `to` minus 7 days"
+        },
+        {
+          "name": "to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-29",
+          "description": "End of the publication window: an ISO 8601 instant (exclusive) or a day (inclusive). Default: now. At most 92 days after `from` (400 otherwise)"
+        },
+        {
+          "name": "source",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "edgar"
+          ],
+          "description": "The item's FIRST source: `edgar` (an SEC filing) or `ir` (any company newsroom), comma-separated or repeated"
+        },
+        {
+          "name": "kind",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "earnings_results"
+          ],
+          "description": "Only these kinds, comma-separated or repeated: earnings_results, results_date, call_announcement, event_announcement, guidance, m_and_a, material_agreement, management_change, dividend, capital_markets, legal_spam, promo, other"
+        },
+        {
+          "name": "topic",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "product_launch"
+          ],
+          "description": "Only these topics (any of them), comma-separated or repeated: product_launch, product_update, availability, partnership, customer_contract, capacity_expansion, regulatory, research, other"
+        },
+        {
+          "name": "earnings",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "true",
+          "description": "true = only earnings news (results, results dates, call announcements, guidance); false = none of it"
+        },
+        {
+          "name": "publisher",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Published by these companies (CIK, padded or not; ≤ 20): an item with a verified issuer-newsroom publication of one of them — not a mention, not the item's first source. The CIK namespace is the SEC's"
+        },
+        {
+          "name": "publication_type",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "press_release"
+          ],
+          "description": "Only these publication types of the issuer's own publication, comma-separated or repeated: press_release, company_blog, company_update"
+        },
+        {
+          "name": "issuer_category",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "Press Releases"
+          ],
+          "description": "The publisher's own newsroom category, by exact label or by the publisher's category id (≤ 10); needs exactly one `publisher` — labels and ids are per newsroom"
+        },
+        {
+          "name": "issuer_tag",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "Data Center"
+          ],
+          "description": "The publisher's own newsroom tag, by exact label or id (≤ 10); needs exactly one `publisher`"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 20,
+          "description": "Items per page"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "WyIyMDI2LTEwLTI5VDIwOjMwOjA1LjEyMzQ1NloiLCI0YzFkOWU2Mi0zYjdhLTRmMmUtOGQxYy05ZTBhN2I2YzVkNGYiXQ",
+          "description": "`next_cursor` of the previous page (with the same filters); an altered or foreign cursor is a 400 `invalid_cursor`"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "items",
+      "columns": [
+        "published_at",
+        "source.id",
+        "kind",
+        "is_earnings_news",
+        "symbols",
+        "title",
+        "attribution.publisher"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "items"
+      ]
+    },
+    {
+      "operationId": "newsSearch",
+      "group": "news",
+      "action": "search",
+      "method": "get",
+      "path": "/v1/news/search",
+      "auth": true,
+      "summary": "Search news",
+      "params": [
+        {
+          "name": "q",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "data center revenue",
+          "description": "The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for",
+          "alias": "q"
+        },
+        {
+          "name": "mode",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "lexical",
+            "literal"
+          ],
+          "default": "lexical",
+          "example": "lexical",
+          "description": "lexical (keywords and phrases, default) or literal (exact characters)",
+          "alias": "m"
+        },
+        {
+          "name": "case_sensitive",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)"
+        },
+        {
+          "name": "field",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "title",
+            "body",
+            "any"
+          ],
+          "default": "any",
+          "example": "any",
+          "description": "title = headlines and ledes, body = the item text, any = both"
+        },
+        {
+          "name": "ticker",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "NVDA"
+          ],
+          "description": "Items mentioning these tickers (≤ 20, comma-separated or repeated). `BRK.B` and `BRK-B` both match; responses carry the stored dash spelling. With `cik`, either matches",
+          "alias": "t"
+        },
+        {
+          "name": "cik",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Items mentioning these companies by CIK (padded or not, ≤ 20). With `ticker`, either matches"
+        },
+        {
+          "name": "publisher",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "1045810"
+          ],
+          "description": "Published by these companies (CIK, padded or not; ≤ 20): an item with a verified issuer-newsroom publication of one of them — not a mention, not the item's first source. The CIK namespace is the SEC's"
+        },
+        {
+          "name": "kind",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "earnings_results"
+          ],
+          "description": "Only these kinds, comma-separated or repeated: earnings_results, results_date, call_announcement, event_announcement, guidance, m_and_a, material_agreement, management_change, dividend, capital_markets, legal_spam, promo, other"
+        },
+        {
+          "name": "topic",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "example": [
+            "product_launch"
+          ],
+          "description": "Only these topics (any of them), comma-separated or repeated: product_launch, product_update, availability, partnership, customer_contract, capacity_expansion, regulatory, research, other"
+        },
+        {
+          "name": "from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-07-01",
+          "description": "Start of the publication window: an ISO 8601 instant or a day (YYYY-MM-DD, from its UTC midnight). Default: `to` minus 365 days"
+        },
+        {
+          "name": "to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-29",
+          "description": "End of the publication window: an ISO 8601 instant (exclusive) or a day (inclusive). Default: now. At most 731 days after `from` (400 otherwise)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 5,
+          "example": 5,
+          "description": "Maximum number of passages (at most 8)",
+          "alias": "l"
+        }
+      ],
+      "exampleParams": [
+        "ticker",
+        "mode"
+      ],
+      "view": "table",
+      "rowsPath": "hits",
+      "columns": [
+        "score",
+        "match.type",
+        "field",
+        "item.published_at",
+        "item.symbols",
+        "item.title",
+        "text"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "newsItemText",
+      "group": "news",
+      "action": "text",
+      "method": "get",
+      "path": "/v1/news/{id}/text",
+      "auth": true,
+      "summary": "Get a news item's text in blocks",
+      "params": [
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 10,
+          "example": 20,
+          "description": "Blocks per page"
+        },
+        {
+          "name": "max_chars",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 12000,
+          "example": 12000,
+          "description": "Unicode code points per page; a block is never split (the minimum is the largest block)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "WyIyMDI2LTEwLTI5VDIwOjMwOjA1LjEyMzQ1NloiLCI0YzFkOWU2Mi0zYjdhLTRmMmUtOGQxYy05ZTBhN2I2YzVkNGYiXQ",
+          "description": "`next_cursor` of the previous page (with the same filters); an altered or foreign cursor is a 400 `invalid_cursor`"
+        },
+        {
+          "name": "id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "4c1d9e62-3b7a-4f2e-8d1c-9e0a7b6c5d4f",
+          "description": "News item id"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "blocks",
+      "columns": [
+        "index",
+        "heading",
+        "text"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "blocks"
+      ]
+    },
     {
       "operationId": "institutionalOwnershipHoldingsByCompany",
       "group": "ownership",

package/dist/src/hand-written-commands.d.ts

@@ -18,7 +18,7 @@ export declare const HAND_WRITTEN_COMMANDS: readonly [{
     readonly reason: "copies the bundled Claude plugin into agent config dirs";
 }, {
     readonly command: "ws";
-    readonly reason: "WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts)";
+    readonly reason: "WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts), --news the news.live channel (src/client/news-live.ts)";
 }, {
     readonly command: "earnings transcript";
     readonly reason: "renders the transcript as text and saves it with -o";

package/dist/src/hand-written-commands.js

@@ -9,7 +9,7 @@ export const HAND_WRITTEN_COMMANDS = [
     { command: 'logout', reason: 'clears the local credential store' },
     { command: 'config', reason: 'local settings (API key, API host)' },
     { command: 'plugin', reason: 'copies the bundled Claude plugin into agent config dirs' },
-    { command: 'ws', reason: 'WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts)' },
+    { command: 'ws', reason: 'WebSocket stream (/v1/ws); --earnings is the live transcript (src/client/earnings-live.ts), --news the news.live channel (src/client/news-live.ts)' },
     { command: 'earnings transcript', reason: 'renders the transcript as text and saves it with -o' },
     { command: 'earnings press-release', reason: 'prints the release text with --body and saves it with -o' },
     { command: 'earnings audio', reason: 'downloads the recording from its URL with -o' },

package/dist/src/hand-written-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"hand-written-commands.js","sourceRoot":"","sources":["../../src/hand-written-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,oEAAoE,EAAE;IAClG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,mCAAmC,EAAE;IAClE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,oCAAoC,EAAE;IACnE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,yDAAyD,EAAE;IACxF,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,4FAA4F,EAAE;IACvH,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,qDAAqD,EAAE;IACjG,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,0DAA0D,EAAE;IACzG,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,8CAA8C,EAAE;IACrF,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,sEAAsE,EAAE;IAC9G,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,mDAAmD,EAAE;IAC9F,EAAE,OAAO,EAAE,4BAA4B,EAAE,MAAM,EAAE,sDAAsD,EAAE;IACzG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,uEAAuE,EAAE;CACzG,CAAC"}
+{"version":3,"file":"hand-written-commands.js","sourceRoot":"","sources":["../../src/hand-written-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,oEAAoE,EAAE;IAClG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,mCAAmC,EAAE;IAClE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,oCAAoC,EAAE;IACnE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,yDAAyD,EAAE;IACxF,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,oJAAoJ,EAAE;IAC/K,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,qDAAqD,EAAE;IACjG,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,0DAA0D,EAAE;IACzG,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,8CAA8C,EAAE;IACrF,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,sEAAsE,EAAE;IAC9G,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,mDAAmD,EAAE;IAC9F,EAAE,OAAO,EAAE,4BAA4B,EAAE,MAAM,EAAE,sDAAsD,EAAE;IACzG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,uEAAuE,EAAE;CACzG,CAAC"}

package/package.json

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