@invinite-org/invinite-data-cli 0.1.21 → 0.2.0

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

@@ -1,21 +1,56 @@
 ---
-name: invinite-data-cli
-description: Fetch financial data using the Invinite Data API CLI. Use this skill whenever the user wants to look up company information, financial statements, SEC filings, institutional ownership, insider trades, IPO data, market holidays, financial metrics, or any stock/company-related data. Also use when the user mentions tickers, CIKs, balance sheets, income statements, cash flows, 10-K, 10-Q, ratios, CAGR, growth rates, dividends, stock splits, or institutional holdings — even if they don't mention "Invinite" by name.
+name: invinite-financial-data
+description: Fetch financial data through the Invinite Data API MCP connector or invd CLI. Use whenever the user wants company information, financial statements, SEC filings, institutional ownership, insider trades, IPO data, market holidays, financial metrics, earnings calls, or other stock/company data, including requests mentioning tickers, CIKs, balance sheets, income statements, cash flows, 10-K, 10-Q, ratios, CAGR, growth rates, dividends, stock splits, institutional holdings, call transcripts, earnings guidance, KPIs, Q&A, analysts, live calls, slides, or press releases.
 allowed-tools: Bash(invd *)
 ---
 
-# Invinite Data API CLI
+# Invinite Data API
 
-The `invd` CLI provides access to comprehensive financial data from the Invinite Data API. Always use `--json` when fetching data for analysis — it returns structured JSON you can pipe to `jq` or parse programmatically.
+Use the connected Invinite Data API MCP tools when available. Fall back to the `invd` CLI when MCP is unavailable. Both transports access the same team-billed Data API.
+
+## Transport selection
+
+1. Prefer MCP tools when an Invinite Data connector is available. Call the direct domain tool matching the request; unlike the Web API MCP server, the Data API MCP server does not use meta-tools such as `call_endpoint`.
+2. Use the CLI examples below when MCP is unavailable or when the user explicitly requests CLI usage. Always pass `--json` for data used in analysis.
+3. Do not mix transports merely to repeat a successful request.
+
+### MCP and CLI mapping
+
+| Data need | MCP tool | CLI command family |
+|---|---|---|
+| Search/details/list | `company_search`, `company_details`, `available_companies` | `invd company ...` |
+| Dividends/periods/splits | `company_dividends`, `company_fiscal_periods`, `company_splits` | `invd company ...` |
+| Standardized statements/snapshots | `standardized_financial_statement`, `standardized_financial_snapshot` | `invd financials ...` |
+| As-reported statements/snapshots | `as_reported_financial_statement`, `as_reported_financial_snapshot` | `invd financials ... --as-reported` |
+| Ratios/growth/CAGR | `financial_ratios`, `financial_growth`, `financial_cagr` | `invd metrics ...` |
+| Segment data | `segmented_financials` | `invd segments ...` |
+| SEC filings/search/sections | `sec_filings`, `sec_filings_search`, `sec_filing_sections` | `invd filings ...` |
+| Filing and metric discovery | `sec_available_form_types`, `list_available_section_ids`, `list_available_metrics` | `invd filings form-types`, `invd metadata ...` |
+| Institutional ownership | `holdings_by_company`, `holdings_by_investor`, `institutional_investors`, `institutional_transactions` | `invd ownership ...` |
+| Insider trades/IPOs/holidays | `insider_trades`, `ipos`, `market_holidays` | `invd insider-trades`, `invd ipos`, `invd market ...` |
+| Earnings call calendar/events/live | `earnings_call_calendar`, `earnings_call_events`, `earnings_call_live` | `invd earnings calendar\|events\|live` |
+| Call transcript/Q&A/participants | `earnings_call_transcript`, `earnings_call_qa`, `earnings_call_participants` | `invd earnings transcript\|qa\|participants` |
+| Call guidance/KPIs, diff vs prior call | `earnings_call_guidance`, `earnings_call_diff` | `invd earnings extractions\|guidance-history\|diff` |
+| Call documents/press release | `earnings_call_documents`, `earnings_call_press_release` | `invd earnings documents\|press-release` |
+| Search across calls | `earnings_call_search` | `invd earnings 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.
 
 ## Prerequisites
 
-The CLI must be installed (`npm install -g @invinite-org/invinite-data-cli`) and authenticated. Authentication is resolved in this order:
+### MCP
+
+Connect `https://data.invinite.com/t/<teamId>/mcp` through OAuth. The team in the URL controls data billing. Leave OAuth client ID and secret empty so the client uses Dynamic Client Registration and PKCE.
+
+### CLI
+
+Install the CLI with `npm install -g @invinite-org/invinite-data-cli`, then run `invd login` or `invd login --team <teamId>`. Authentication is resolved in this order:
 1. `INVINITE_DATA_API_KEY` environment variable
-2. OS keychain (via optional `keytar`)
-3. Stored config (set via `invd config set-key`)
+2. `.env` file
+3. OS keychain (via optional `keytar`)
+4. Stored config
 
-If a command fails with an auth error, tell the user to run `invd config set-key` or set `INVINITE_DATA_API_KEY`.
+If an MCP call fails with an auth error, reconnect the connector and complete OAuth. If a CLI call fails with an auth error, run `invd login`; manual `invd config set-key` and `INVINITE_DATA_API_KEY` remain supported fallbacks.
 
 ## Global Options
 
@@ -197,6 +232,71 @@ invd metadata metrics --json
 invd metadata section-ids --json
 ```
 
+### Earnings Calls
+
+Commands about one call take a selector: `--event <event_id>` (from `events` / `calendar`), or `-i <ticker>` with `--year` + `--quarter` (fiscal) or `--date YYYY-MM-DD` (New York call day).
+
+```bash
+# Calendar across companies, a company's calls, calls being captured right now
+# --event-type: earnings_call (calendar default), investor_day, conference, agm, other, all (events default)
+invd earnings calendar --from 2026-10-20 --to 2026-10-31 --json
+invd earnings calendar --event-type all --json   # investor days, conferences, AGMs too
+invd earnings events -i AAPL -s desc -l 4 --json
+invd earnings live --json
+invd earnings event <event_id> --json
+
+# Transcript (formats: speakers, text, words, sections, cleaned), versions, word diff between versions
+# qa_start_ms = where the Q&A begins (ms into the call, null without one)
+invd earnings transcript -i AAPL --year 2026 --quarter 4 --format speakers --json
+invd earnings versions --event <event_id> --json
+invd earnings transcript-diff --event <event_id> --from 1 --json
+
+# Q&A pairs, speakers, analysts of a company, one person's appearances
+invd earnings qa --event <event_id> --json
+invd earnings participants --event <event_id> --json
+invd earnings analysts -i AAPL --json
+invd earnings person <person_id> --json
+
+# Press release, guidance / KPI extractions, a metric's guidance across calls
+invd earnings press-release --event <event_id> --body --json
+invd earnings extractions --event <event_id> --kind guidance --json
+invd earnings extractions --event <event_id> --kind kpi --json
+invd earnings guidance-history -i AAPL --metric revenue --json
+
+# Derived: diff vs the prior call, call metrics, prosody
+invd earnings diff --event <event_id> --json
+invd earnings metrics --event <event_id> --json
+invd earnings prosody --event <event_id> --section qa --json
+
+# Media (signed URLs expire after 15 min; --output saves the file)
+invd earnings audio --event <event_id> --output call.mp3
+invd earnings slides --event <event_id> --markdown --json
+invd earnings documents --event <event_id> --kind cfo_commentary --json
+invd earnings documents --event <event_id> --output ./docs   # a row without url (link-only sec_filing) is warned on stderr; use its source_url
+invd earnings stream --event <event_id> --json   # live HLS URL of a call in progress (PRO)
+
+# Semantic search over transcripts and slides
+invd earnings search -q "data center demand" -i NVDA --json
+```
+
+- `--transcript-version N` (not `--version`) selects a published transcript version; `--as-of <iso>` the version current at that instant.
+- `extractions --review approved|auto|all` filters guidance by review status; `diff --vs prior` is the only comparison base.
+- Every `*_ms` field is milliseconds from the call's start: cite it as `[m:ss]`.
+- The live transcript (`ws listen --earnings`), audio, slides, the live stream and webhooks need the PRO plan (calendar, events and `live` need LITE, the other reads STANDARD); a `403` names the plan a route needs.
+
+### Live transcripts and webhooks
+
+```bash
+# Follow a live call over the WebSocket (event ID or CIK; NDJSON with --json)
+invd ws listen --earnings <event_id> --json
+invd ws listen --earnings 320193 --names
+
+# Earnings-call webhook subscriptions (the secret is printed once)
+invd webhooks list --json
+invd webhooks create --url https://hooks.example.com/invinite --events earnings_call.transcript_ready --ciks 320193
+invd webhooks deliveries <id> --json
+```
+
 ### Health Check
 
 ```bash
@@ -234,6 +334,15 @@ invd ownership holdings-by-company -i AAPL --min-value 10000000 --json
 invd filings search -r "artificial intelligence strategy" -i MSFT --json
 ```
 
+### Reading an earnings call
+Find the call, then read it from the cheapest source to the most detailed:
+```bash
+invd earnings events -i NVDA -s desc -l 4 --json            # pick the event_id
+invd earnings transcript --event <event_id> --format sections --json
+invd earnings extractions --event <event_id> --kind guidance --json
+invd earnings search -q "gross margin outlook" --event <event_id> --json
+```
+
 ### Reading specific filing sections
 First find section IDs, then fetch the section:
 ```bash
@@ -249,3 +358,5 @@ invd filings sections -i AAPL --form-type 10-K --section-id risk_factors --json
 - For financial statements, `annual` gives the full year, `quarterly` gives each quarter, `ttm` gives trailing twelve months, `ytd` gives year-to-date
 - The `snapshot` command is the most efficient way to get complete financials for one or more companies at once
 - Filing sections return full text — great for detailed analysis of risk factors, MD&A, business descriptions, etc.
+- Following a live call: `invd earnings live --json` lists the calls in progress; `invd ws listen --earnings <event_id>` streams the transcript (PRO) and exits once the final transcript is ready
+- Earnings-call identifiers: `event_id` (UUID) from `invd earnings events` / `calendar` is the most precise selector; ticker + `--year` + `--quarter` uses the company's fiscal quarter

package/dist/src/cli.d.ts

@@ -1,2 +1,4 @@
 import { Command } from 'commander';
+/** `package.json` sits one level up under tsx (`src/cli.ts`), two in the build (`dist/src/cli.js`). */
+export declare function packageVersion(): string;
 export declare function createProgram(): Command;

package/dist/src/cli.js

@@ -1,3 +1,4 @@
+import { createRequire } from 'node:module';
 import { Command } from 'commander';
 import { setJsonMode } from './shared/spinner.js';
 import { registerConfigCommands } from './commands/config.js';
@@ -10,17 +11,35 @@ import { registerIposCommands } from './commands/ipos.js';
 import { registerOwnershipCommands } from './commands/ownership.js';
 import { registerInsiderTradesCommands } from './commands/insider-trades.js';
 import { registerFilingsCommands } from './commands/filings.js';
+import { registerEarningsCommands } from './commands/earnings.js';
 import { registerMarketCommands } from './commands/market.js';
 import { registerMetadataCommands } from './commands/metadata.js';
+import { registerWebhooksCommands } from './commands/webhooks.js';
 import { registerWsCommands } from './commands/ws.js';
 import { registerPluginCommands } from './commands/plugin.js';
 import { registerLoginCommands } from './commands/login.js';
+const PACKAGE_NAME = '@invinite-org/invinite-data-cli';
+/** `package.json` sits one level up under tsx (`src/cli.ts`), two in the build (`dist/src/cli.js`). */
+export function packageVersion() {
+    const requireJson = createRequire(import.meta.url);
+    for (const candidate of ['../package.json', '../../package.json']) {
+        try {
+            const pkg = requireJson(candidate);
+            if (pkg.name === PACKAGE_NAME && pkg.version)
+                return pkg.version;
+        }
+        catch {
+            // not at this level
+        }
+    }
+    return '0.0.0';
+}
 export function createProgram() {
     const program = new Command();
     program
         .name('invd')
         .description('CLI for the Invinite financial data API')
-        .version('0.1.0')
+        .version(packageVersion())
         .option('--json', 'Output raw JSON (pipe-friendly)')
         .option('--all', 'Auto-paginate through all results')
         .hook('preAction', (thisCommand) => {
@@ -39,8 +58,10 @@ export function createProgram() {
     registerOwnershipCommands(program);
     registerInsiderTradesCommands(program);
     registerFilingsCommands(program);
+    registerEarningsCommands(program);
     registerMarketCommands(program);
     registerMetadataCommands(program);
+    registerWebhooksCommands(program);
     registerWsCommands(program);
     registerPluginCommands(program);
     registerLoginCommands(program);

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,yCAAyC,CAAC;SACtD,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACnD,MAAM,CAAC,OAAO,EAAE,mCAAmC,CAAC;SACpD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACpC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACvC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,YAAY,GAAG,iCAAiC,CAAC;AAEvD,uGAAuG;AACvG,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,KAAK,MAAM,SAAS,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAwC,CAAC;YAC1E,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,yCAAyC,CAAC;SACtD,OAAO,CAAC,cAAc,EAAE,CAAC;SACzB,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACnD,MAAM,CAAC,OAAO,EAAE,mCAAmC,CAAC;SACpD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACpC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACvC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/client/api-client.d.ts

@@ -1,6 +1,18 @@
 export interface RequestOptions {
     path: string;
-    params?: Record<string, string | undefined>;
+    /** An array value is sent as a repeated parameter (`status=a&status=b`). */
+    params?: Record<string, string | string[] | undefined>;
     silent?: boolean;
 }
+/** Same auth / URL building as `apiGet`, without the JSON parse; a non-2xx throws `ApiError`. */
+export declare function apiGetRaw(opts: RequestOptions & {
+    accept?: string;
+}): Promise<Response>;
 export declare function apiGet<T = unknown>(opts: RequestOptions): Promise<T>;
+export interface ApiRequestOptions extends RequestOptions {
+    method: 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Sent as JSON. */
+    body?: unknown;
+}
+/** A write with a JSON body; same auth / `ApiError` handling as `apiGet`. A 204 / empty body → `undefined`. */
+export declare function apiRequest<T = unknown>(opts: ApiRequestOptions): Promise<T>;

package/dist/src/client/api-client.js

@@ -7,28 +7,47 @@ function buildUrl(path, params) {
     const url = new URL(`${base}${path}`);
     if (params) {
         for (const [key, value] of Object.entries(params)) {
-            if (value !== undefined && value !== '') {
-                url.searchParams.set(key, value);
+            for (const item of Array.isArray(value) ? value : [value]) {
+                if (item !== undefined && item !== '') {
+                    url.searchParams.append(key, item);
+                }
             }
         }
     }
     return url.toString();
 }
+async function apiErrorFrom(response) {
+    const body = await response.json().catch(() => null);
+    return new ApiError(response.status, body?.error || response.statusText || 'Unknown Error', body?.message || `Request failed with status ${response.status}`);
+}
+async function request(opts, accept, init = {}) {
+    const apiKey = await getApiKey();
+    const url = buildUrl(opts.path, opts.params);
+    const headers = {
+        'Authorization': `Bearer ${apiKey}`,
+        'Accept': accept,
+    };
+    if (init.body !== undefined)
+        headers['Content-Type'] = 'application/json';
+    const response = await fetch(url, {
+        headers,
+        ...(init.method ? { method: init.method } : {}),
+        ...(init.body !== undefined ? { body: JSON.stringify(init.body) } : {}),
+    });
+    if (!response.ok) {
+        throw await apiErrorFrom(response);
+    }
+    return response;
+}
+/** Same auth / URL building as `apiGet`, without the JSON parse; a non-2xx throws `ApiError`. */
+export async function apiGetRaw(opts) {
+    return request(opts, opts.accept ?? '*/*');
+}
 export async function apiGet(opts) {
     const spinner = opts.silent ? null : createSpinner('Fetching data...');
     try {
-        const apiKey = await getApiKey();
-        const url = buildUrl(opts.path, opts.params);
-        const response = await fetch(url, {
-            headers: {
-                'Authorization': `Bearer ${apiKey}`,
-                'Accept': 'application/json',
-            },
-        });
+        const response = await request(opts, 'application/json');
         const body = await response.json();
-        if (!response.ok) {
-            throw new ApiError(response.status, body?.error || 'Unknown Error', body?.message || `Request failed with status ${response.status}`);
-        }
         spinner?.succeed('Done');
         return body;
     }
@@ -37,4 +56,18 @@ export async function apiGet(opts) {
         throw error;
     }
 }
+/** A write with a JSON body; same auth / `ApiError` handling as `apiGet`. A 204 / empty body → `undefined`. */
+export async function apiRequest(opts) {
+    const spinner = opts.silent ? null : createSpinner('Sending request...');
+    try {
+        const response = await request(opts, 'application/json', { method: opts.method, body: opts.body });
+        const text = response.status === 204 ? '' : await response.text();
+        spinner?.succeed('Done');
+        return (text ? JSON.parse(text) : undefined);
+    }
+    catch (error) {
+        spinner?.fail('Failed');
+        throw error;
+    }
+}
 //# sourceMappingURL=api-client.js.map

package/dist/src/client/api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../src/client/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD,SAAS,QAAQ,CAAC,IAAY,EAAE,MAA2C;IACzE,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACxC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAc,IAAoB;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;QAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,QAAQ,CAChB,QAAQ,CAAC,MAAM,EACf,IAAI,EAAE,KAAK,IAAI,eAAe,EAC9B,IAAI,EAAE,OAAO,IAAI,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CACjE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,IAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../src/client/api-client.ts"],"names":[],"mappings":"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"}

package/dist/src/client/download.d.ts

@@ -0,0 +1,23 @@
+export interface SaveOptions {
+    /** Replace an existing file. */
+    force?: boolean;
+}
+/**
+ * Streams a presigned URL to disk. Plain fetch: NO Authorization header — the URL is a
+ * bearer URL and R2 would reject the extra header. Written through `writeViaPart`.
+ */
+export declare function downloadToFile(url: string, file: string, opts?: SaveOptions & {
+    spinnerText?: string;
+}): Promise<{
+    path: string;
+    bytes: number;
+}>;
+/** Writes text (transcript, press release) to `file`; refuses an existing target unless `force`. */
+export declare function writeTextFile(file: string, text: string, opts?: SaveOptions): Promise<{
+    path: string;
+    bytes: number;
+}>;
+/** `mkdir -p` of a directory target (`documents --output dir/`); returns its absolute path. */
+export declare function ensureDir(dir: string): Promise<string>;
+/** File extension for a `content_type` (parameters ignored); `bin` when unknown. */
+export declare function extensionFor(contentType: string | null | undefined): string;

package/dist/src/client/download.js

@@ -0,0 +1,116 @@
+import { createWriteStream, rmSync } from 'node:fs';
+import { access, mkdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createSpinner } from '../shared/spinner.js';
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolves `file` against cwd and refuses an existing target unless `force`. */
+async function prepareTarget(file, opts) {
+    const path = resolve(file);
+    if (!opts.force && await exists(path)) {
+        throw new Error(`${path} already exists (use --force to overwrite)`);
+    }
+    await mkdir(dirname(path), { recursive: true });
+    return path;
+}
+/** Exit codes of the signals that abort a write (128 + signal number, as a shell reports them). */
+const ABORT_SIGNALS = { SIGINT: 130, SIGTERM: 143 };
+/**
+ * Runs `write(part, signal)` against `<path>.part` and renames it onto `path` on success, so a
+ * failed write never leaves a partial file or clobbers an existing one. While it runs, SIGINT /
+ * SIGTERM (Ctrl-C) abort `signal`, remove the `.part` file synchronously and exit with 130 / 143 —
+ * a listener replaces Node's default exit, which would skip the cleanup.
+ */
+async function writeViaPart(path, write) {
+    const part = `${path}.part`;
+    const controller = new AbortController();
+    const onSignal = (signal) => {
+        controller.abort();
+        rmSync(part, { force: true });
+        process.exit(ABORT_SIGNALS[signal]);
+    };
+    for (const signal of Object.keys(ABORT_SIGNALS))
+        process.once(signal, onSignal);
+    try {
+        await write(part, controller.signal);
+        await rename(part, path);
+    }
+    catch (error) {
+        await rm(part, { force: true });
+        throw error;
+    }
+    finally {
+        for (const signal of Object.keys(ABORT_SIGNALS))
+            process.off(signal, onSignal);
+    }
+}
+/**
+ * Streams a presigned URL to disk. Plain fetch: NO Authorization header — the URL is a
+ * bearer URL and R2 would reject the extra header. Written through `writeViaPart`.
+ */
+export async function downloadToFile(url, file, opts = {}) {
+    const path = await prepareTarget(file, opts);
+    const spinner = createSpinner(opts.spinnerText ?? 'Downloading...');
+    try {
+        await writeViaPart(path, async (part, signal) => {
+            const response = await fetch(url, { signal });
+            if (!response.ok || !response.body) {
+                throw new Error(`Download failed with status ${response.status}`);
+            }
+            await pipeline(Readable.fromWeb(response.body), createWriteStream(part), { signal });
+        });
+        const { size } = await stat(path);
+        spinner.succeed('Downloaded');
+        return { path, bytes: size };
+    }
+    catch (error) {
+        spinner.fail('Download failed');
+        throw error;
+    }
+}
+/** Writes text (transcript, press release) to `file`; refuses an existing target unless `force`. */
+export async function writeTextFile(file, text, opts = {}) {
+    const path = await prepareTarget(file, opts);
+    await writeViaPart(path, (part, signal) => writeFile(part, text, { encoding: 'utf8', signal }));
+    return { path, bytes: Buffer.byteLength(text, 'utf8') };
+}
+/** `mkdir -p` of a directory target (`documents --output dir/`); returns its absolute path. */
+export async function ensureDir(dir) {
+    const path = resolve(dir);
+    await mkdir(path, { recursive: true });
+    return path;
+}
+const EXTENSIONS = {
+    'application/pdf': 'pdf',
+    'text/html': 'html',
+    'text/plain': 'txt',
+    'text/csv': 'csv',
+    'application/json': 'json',
+    'application/xml': 'xml',
+    'text/xml': 'xml',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',
+    'application/msword': 'doc',
+    'application/vnd.ms-excel': 'xls',
+    'application/vnd.ms-powerpoint': 'ppt',
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/gif': 'gif',
+    'audio/mpeg': 'mp3',
+};
+/** File extension for a `content_type` (parameters ignored); `bin` when unknown. */
+export function extensionFor(contentType) {
+    const type = (contentType ?? '').split(';')[0].trim().toLowerCase();
+    return EXTENSIONS[type] ?? 'bin';
+}
+//# sourceMappingURL=download.js.map

package/dist/src/client/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/client/download.ts"],"names":[],"mappings":"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"}

package/dist/src/client/earnings-live.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pure pieces of `invd ws listen --earnings`: the subscribe frame and one step per server
+ * frame of IDA's `earnings-calls.live` channel (`src/routes/websocket/types/earningsMessages.ts`).
+ */
+export declare const EARNINGS_LIVE_CHANNEL = "earnings-calls.live";
+export type LiveTarget = {
+    event_id: string;
+} | {
+    cik: string;
+};
+export interface SpeakerAssignment {
+    speaker_label: string;
+    from_seq: number;
+    to_seq: number | null;
+    name: string;
+    role?: string;
+    title?: string | null;
+    firm?: string | null;
+}
+export interface LiveSegment {
+    seq: number;
+    start_ms: number;
+    speaker_label: string | null;
+    text: string;
+    is_final: boolean;
+}
+export interface LiveState {
+    /** Highest final seq printed (or the `since_seq` asked for): a reconnect resumes after it. */
+    lastSeq: number;
+    eventId: string | null;
+    names: {
+        revision: number;
+        assignments: SpeakerAssignment[];
+    } | null;
+}
+export interface LiveOptions {
+    partials: boolean;
+    names: boolean;
+}
+export interface LiveStep {
+    state: LiveState;
+    lines: string[];
+    /** A partial to show in place of the previous one (TTY only). */
+    partial?: string;
+    /** Stop: exit code + a closing line. */
+    end?: {
+        code: 0 | 1;
+        message: string;
+    };
+    /** Close the socket and resubscribe through the backoff. */
+    reconnect?: boolean;
+}
+/** `--earnings`: a UUID is an event_id, 1–10 digits a CIK. */
+export declare function parseTarget(value: string): LiveTarget;
+/** `--since-seq`: an integer ≥ -1; default -1 (the whole call from its first final). */
+export declare function parseSinceSeq(value: string | undefined): number;
+export declare function subscribeFrame(target: LiveTarget, sinceSeq: number, partials: boolean): {
+    since_seq: number;
+    partials: boolean;
+    event_id: string;
+    type: string;
+    channel: string;
+} | {
+    since_seq: number;
+    partials: boolean;
+    cik: string;
+    type: string;
+    channel: string;
+};
+export declare function initialLiveState(sinceSeq: number): LiveState;
+/** The assignment of `label` covering `seq` (the latest-starting one wins), else null. */
+export declare function nameFor(assignments: SpeakerAssignment[], label: string | null, seq: number): string | null;
+/** `[m:ss] name: text`, the name from the snapshot, else `Speaker <label>`. */
+export declare function formatSegment(segment: LiveSegment, assignments: SpeakerAssignment[]): string;
+export declare function finalTranscriptHint(eventId: string | null): string;
+/** One server frame → the new state and what to print / do. Unknown frames are ignored. */
+export declare function liveStep(state: LiveState, frame: Record<string, any>, opts: LiveOptions): LiveStep;
+/** Frames of the earnings channel (the socket also carries `new_filing` broadcasts and pings). */
+export declare function isEarningsFrame(frame: Record<string, any>): boolean;