@insightsentry/mcp 1.4.39 → 1.4.41

package/README.md

@@ -55,6 +55,16 @@ Use `npx` in your MCP config:
 The MCP server also falls back to the key saved by `insight login` when `INSIGHTSENTRY_API_KEY` is not set.
 Set `INSIGHTSENTRY_CONFIG_DIR` to force the CLI and MCP server to read the same saved-login directory when they run with different home directories.
 
+### Bounded live collection for AI agents
+
+The MCP server exposes `collect_live` and `collect_newsfeed`. Both return structured JSON and stop
+after 20 data messages or 10 seconds by default. Calls can request up to 100 messages or 60 seconds;
+whichever limit is reached first ends the collection. A fixed response-size limit may stop a call
+earlier; check `stop_reason`. The structured result includes `activated`, while the text response is
+a short summary so message data is not duplicated. If the subscription does not activate before the
+duration limit, the call returns `activation_timeout`. Use the CLI commands below for continuous
+terminal streaming.
+
 ## CLI Usage
 
 ```bash
@@ -72,6 +82,8 @@ insight get_quotes --codes "NASDAQ:AAPL,NASDAQ:MSFT"
 insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --dp 30
 insight screen_stocks --fields "close,volume,market_cap" --exchanges "NYSE,NASDAQ" --sortBy market_cap --sortOrder desc
 insight download_history --symbol "NASDAQ:AAPL" --bar_type day --from 2024-01-01 --to 2024-06-30 --output_dir ./history
+insight stream_live --symbols "NASDAQ:AAPL,NASDAQ:MSFT" --type both --bar_type minute --bar_interval 1 --max_messages 100 --duration_seconds 30
+insight stream_newsfeed --output_file ./news.ndjson --append --duration_seconds 30
 ```
 
 Symbol codes must use `EXCHANGE:SYMBOL` format. Use `search_symbols` before calling symbol tools.
@@ -90,7 +102,69 @@ All API tools support:
 insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --store csv --output_file ./aapl.csv
 ```
 
-## Tools
+### WebSocket Streams
+
+The long-running WebSocket commands are available through the terminal CLI:
+
+```bash
+# Use the same settings for every symbol
+insight stream_live --symbols "NASDAQ:AAPL,NASDAQ:MSFT" --type quote \
+  --max_messages 100 --duration_seconds 30
+
+# Use different settings per symbol
+insight stream_live \
+  --subscriptions '[{"code":"NASDAQ:AAPL","type":"series","bar_type":"minute","bar_interval":5},{"code":"NASDAQ:MSFT","type":"quote"}]' \
+  --duration_seconds 60
+
+# Collect 100 data messages, then disconnect successfully
+insight stream_live --symbols "NASDAQ:AAPL" --type quote --max_messages 100
+
+# Stream all news to stdout
+insight stream_newsfeed --max_messages 20 --duration_seconds 30
+
+# Append filtered news to a file and also emit it to stdout
+insight stream_newsfeed --content "earnings" --related_symbols "NASDAQ:AAPL" \
+  --output_file ./news.ndjson --append --tee --duration_seconds 60
+```
+
+In an interactive terminal, run `insight stream_live` or choose it from the no-argument command
+picker to use a short guided setup for subscriptions and output. Supplying any stream flags uses
+non-interactive flag mode and never prompts.
+
+Each received JSON message is written as one NDJSON line. With `--output_file`, the file is replaced
+unless `--append` is set; `--tee` also writes the same lines to stdout. Connection status, retries,
+and local errors are written to stderr, so stdout remains valid NDJSON and can be piped safely:
+
+```bash
+insight stream_live --symbols "NASDAQ:AAPL" --type quote \
+  --max_messages 20 --duration_seconds 30 --quiet | jq -c .
+```
+
+The CLI answers WebSocket control pings, reconnects with bounded exponential backoff, and resends
+the complete request after reconnecting. It does not reconnect when the server returns an error that
+requires user action; that error is retained in the NDJSON output and reported on stderr before the
+command exits unsuccessfully. Advanced subscription JSON rejects unknown fields instead of silently
+discarding them. Press Ctrl+C to close gracefully after queued file output is finalized.
+
+Use `--duration_seconds` or `--max_messages` for a bounded run that drains queued output, disconnects,
+and exits successfully. The message limit counts quote, series, or news data—not connection status or
+market-data timestamp frames—and continues across reconnects. `--max_reconnect_attempts 0` disables
+automatic reconnects.
+
+Use `--quiet` to suppress WebSocket connection and status diagnostics. Preflight errors still use
+stderr, received server error frames remain in NDJSON, and failures retain a non-zero exit code.
+
+Newsfeed connections replay up to 10 recent matching items before streaming new items. Reconnecting
+can therefore repeat items already written; consumers should deduplicate by `link`, or by
+`published_at`, `source`, and `title` when no link is present. Content terms are matched with OR,
+while populated `source`, `related_symbols`, and `content` filters are combined with AND.
+
+Quote updates can be sparse. Merge updates by `code` when maintaining a current quote snapshot.
+
+Run `insight stream_live --help` or `insight stream_newsfeed --help` for every flag. Continuous
+WebSocket streaming is CLI-only; use the bounded MCP collection tools from an AI client.
+
+## MCP Tools
 
 Auth and files:
 
@@ -112,6 +186,8 @@ Market data:
 | `get_sip_quotes` | Latest SIP quotes |
 | `get_sip_series` | Recent SIP market-data series |
 | `get_sip_history` | SIP intraday history for a specific period |
+| `collect_live` | Collect a bounded sample of live quotes or series |
+| `collect_newsfeed` | Collect a bounded sample of live financial news |
 | `get_symbol_info` | Symbol metadata |
 | `get_symbol_session` | Trading hours and session details |
 | `get_symbol_contracts` | Futures contract list |

package/dist/cli.d.ts

@@ -1,11 +1,14 @@
 import type { ChartConfiguration } from "chart.js";
 import { type AuthStatus } from "./auth-status.js";
+import { type StreamOutput, type StreamOutputOptions } from "./stream-output.js";
 import { type ToolDefinition } from "./tool-definitions.js";
 import { type LatestVersionProvider } from "./version-status.js";
+import { type RunWebSocketStreamOptions, type StreamRunResult } from "./websocket-stream.js";
 export { coerceArgs } from "./arg-coercion.js";
 interface ParsedArgs {
     toolName: string | null;
     args: Record<string, string>;
+    valuelessArgs: string[];
     help: boolean;
     version: boolean;
 }
@@ -14,6 +17,7 @@ export declare function buildVersion(): string;
 export declare function buildHelp(): string;
 export declare function buildDownloadHistoryHelp(commandName?: string): string;
 export declare function buildRenderChartHelp(): string;
+export declare function buildStreamHelp(commandName: string): string;
 export declare function buildToolHelp(tool: ToolDefinition): string;
 type RequestFn = (method: string, pathTemplate: string, params: Record<string, any>) => Promise<any>;
 type RunCommandFn = (command: string, args: string[]) => Promise<{
@@ -38,6 +42,11 @@ interface CliIO {
     selectTool?: (options: ToolSelectionOption[]) => Promise<string | null>;
     isInteractive?: boolean;
     getAuthStatus?: () => AuthStatus;
+    getApiKey?: () => string | undefined;
+    createStreamOutput?: (options: StreamOutputOptions) => Promise<StreamOutput>;
+    runStream?: (options: RunWebSocketStreamOptions) => Promise<StreamRunResult>;
+    streamSignal?: AbortSignal;
+    getStreamSignalExitCode?: () => number | undefined;
 }
 interface ToolSelectionOption {
     name: string;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD,OAAO,EAAE,KAAK,UAAU,EAAyC,MAAM,kBAAkB,CAAC;AAwB1F,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAE7E,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsD/C,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA0CpD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAoDlC;AAED,wBAAgB,wBAAwB,CAAC,WAAW,SAA2B,GAAG,MAAM,CA8BvF;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAe7C;AAmHD,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAsC1D;AAkCD,KAAK,SAAS,GAAG,CACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACxB,OAAO,CAAC,GAAG,CAAC,CAAC;AAClB,KAAK,YAAY,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACnD,KAAK,aAAa,GAAG,CACnB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnD,UAAU,KAAK;IACb,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;IACxD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC;CAClC;AAKD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrE;AAq4CD,wBAAgB,IAAI,SAYnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}