@insightsentry/mcp 1.4.42 → 1.4.44

package/dist/chart.js

@@ -1,32 +1,105 @@
-import { writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { ChartJSNodeCanvas } from "chartjs-node-canvas";
+import { abortable } from "./cancellation.js";
 const DEFAULT_WIDTH = 800;
 const DEFAULT_HEIGHT = 400;
-// Cache canvases by dimension to avoid re-creating them
-const canvasCache = new Map();
-function getCanvas(width, height) {
-    const key = `${width}x${height}`;
-    let canvas = canvasCache.get(key);
-    if (!canvas) {
-        canvas = new ChartJSNodeCanvas({
-            width,
-            height,
-            backgroundColour: "white",
-        });
-        canvasCache.set(key, canvas);
+const MAX_ACTIVE = 2;
+const MAX_PENDING = 32;
+// Reuse the installed renderer's protected canvas/Chart.js facilities. Creating
+// a renderer for every dimension reloads Chart.js and retains module instances.
+class SizedRenderer extends ChartJSNodeCanvas {
+    constructor() {
+        super({ width: 1, height: 1 });
     }
-    return canvas;
+    async renderSized(config, width, height) {
+        const canvas = this._createCanvas(width, height);
+        try {
+            new this._chartJs(canvas, {
+                ...config,
+                options: { ...config.options, responsive: false, animation: false },
+                plugins: [
+                    ...(config.plugins ?? []),
+                    {
+                        id: "insight-white-background",
+                        beforeDraw(chart) {
+                            const ctx = chart.ctx;
+                            ctx.save();
+                            ctx.globalCompositeOperation = "destination-over";
+                            ctx.fillStyle = "white";
+                            ctx.fillRect(0, 0, chart.width, chart.height);
+                            ctx.restore();
+                        },
+                    },
+                ],
+            });
+            return await new Promise((resolve, reject) => canvas.toBuffer((error, buffer) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve(buffer);
+            }, "image/png"));
+        }
+        finally {
+            this._chartJs.getChart(canvas)?.destroy();
+            canvas.width = 0;
+            canvas.height = 0;
+        }
+    }
+}
+const idleRenderers = [];
+let active = 0;
+const pending = [];
+async function acquire(signal) {
+    signal?.throwIfAborted();
+    if (active < MAX_ACTIVE) {
+        active++;
+        return;
+    }
+    if (pending.length >= MAX_PENDING)
+        throw new Error("Chart renderer is busy. Retry render_chart after the current renders finish.");
+    let resume;
+    const ready = new Promise((resolve) => {
+        resume = resolve;
+        pending.push(resume);
+    });
+    try {
+        await abortable(ready, signal);
+    }
+    catch (error) {
+        const index = pending.indexOf(resume);
+        if (index >= 0)
+            pending.splice(index, 1);
+        else
+            release(); // The permit was assigned just before cancellation.
+        throw error;
+    }
+}
+function release() {
+    const next = pending.shift();
+    if (next)
+        next();
+    else
+        active--;
 }
-export async function renderChart(config, width = DEFAULT_WIDTH, height = DEFAULT_HEIGHT) {
-    const canvas = getCanvas(width, height);
-    const buffer = await canvas.renderToBuffer(config);
-    const base64 = buffer.toString("base64");
-    // Save to a temp file so the LLM can pass the path directly to the user
-    const fileName = `insightsentry_chart_${Date.now()}.png`;
-    const filePath = join(tmpdir(), fileName);
-    writeFileSync(filePath, buffer);
-    return { base64, filePath };
+export async function renderChart(config, width = DEFAULT_WIDTH, height = DEFAULT_HEIGHT, signal) {
+    await acquire(signal);
+    let renderer;
+    try {
+        signal?.throwIfAborted();
+        renderer = idleRenderers.pop() ?? new SizedRenderer();
+        const buffer = await renderer.renderSized(config, width, height);
+        signal?.throwIfAborted();
+        const filePath = join(tmpdir(), `insightsentry_chart_${randomUUID()}.png`);
+        await writeFile(filePath, buffer, { flag: "wx" });
+        return { base64: buffer.toString("base64"), filePath };
+    }
+    finally {
+        if (renderer)
+            idleRenderers.push(renderer);
+        release();
+    }
 }
 //# sourceMappingURL=chart.js.map

package/dist/chart.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart.js","sourceRoot":"","sources":["../src/chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,wDAAwD;AACxD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEzD,SAAS,SAAS,CAAC,KAAa,EAAE,MAAc;IAC9C,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC;IACjC,IAAI,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,iBAAiB,CAAC;YAC7B,KAAK;YACL,MAAM;YACN,gBAAgB,EAAE,OAAO;SAC1B,CAAC,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA0B,EAC1B,QAAgB,aAAa,EAC7B,SAAiB,cAAc;IAE/B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEzC,wEAAwE;IACxE,MAAM,QAAQ,GAAG,uBAAuB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1C,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEhC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"chart.js","sourceRoot":"","sources":["../src/chart.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -1,4 +1,5 @@
 import type { ChartConfiguration } from "chart.js";
+import { type ApiRequestOptions } from "./api-client.js";
 import { type AuthStatus } from "./auth-status.js";
 import { type StreamOutput, type StreamOutputOptions } from "./stream-output.js";
 import { type ToolDefinition } from "./tool-definitions.js";
@@ -19,7 +20,7 @@ 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 RequestFn = (method: string, pathTemplate: string, params: Record<string, any>, options?: ApiRequestOptions) => Promise<any>;
 type RunCommandFn = (command: string, args: string[]) => Promise<{
     stdout?: string;
     stderr?: string;
@@ -29,6 +30,7 @@ type RenderChartFn = (config: ChartConfiguration, width?: number, height?: numbe
     filePath: string;
 }>;
 interface CliIO {
+    signal?: AbortSignal;
     write: (s: string) => void;
     exit: (code: number) => void;
     request?: RequestFn;

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -14,13 +14,13 @@ import { downloadHistorySchema } from "./download-history-schema.js";
 import { downloadHistory, validateOutputDirectory, } from "./history.js";
 import { validateHistoryIntervalArgs } from "./history-validation.js";
 import { PACKAGE_JSON } from "./package-info.js";
-import { supportsCsvStorage, validateResponseStorageTarget, } from "./response-storage.js";
+import { supportsCsvStorage, validateDocumentStorageTarget, validateResponseStorageTarget, } from "./response-storage.js";
 import { createStreamOutput, } from "./stream-output.js";
 import { analyzeSymbolCodes, shouldPromptSymbolScopedParam } from "./symbol-param-applicability.js";
 import { validateSymbolLikeArg } from "./symbol-validation.js";
 import { toolDefinitions } from "./tool-definitions.js";
 import { runApiTool, validateFilterExpression } from "./tool-runner.js";
-import { fetchLatestPackageVersion, formatUpgradeNotice, formatVersionStatus, getVersionStatus, } from "./version-status.js";
+import { fetchLatestPackageVersion, formatUpgradeNotice, formatVersionStatus, getVersionStatus, peekVersionStatus, } from "./version-status.js";
 import { buildLiveStreamRequest, buildNewsfeedStreamRequest, } from "./websocket-contract.js";
 import { LIVE_STREAM_SCHEMA, NEWSFEED_STREAM_SCHEMA, STREAM_OUTPUT_SCHEMA, } from "./websocket-schemas.js";
 import { runWebSocketStream, } from "./websocket-stream.js";
@@ -287,6 +287,7 @@ const toolExamples = {
         'insight get_symbol_history_period --symbol "NASDAQ:AAPL" --bar_type minute --start_date 2025-01',
     ],
     get_sip_quotes: ['insight get_sip_quotes --codes "SIP:AAPL,SIP:MSFT"'],
+    get_sip_trades: ['insight get_sip_trades --code "SIP:AAPL" --date YYYY-MM-DD'],
     get_sip_series: [
         'insight get_sip_series --code "SIP:AAPL" --bar_type minute --bar_interval 5 --dp 100',
     ],
@@ -437,6 +438,20 @@ function formatTypeName(t) {
 }
 const REQUIRED_DOWNLOAD_HISTORY_ARGS = ["symbol", "bar_type", "from", "to", "output_dir"];
 export async function runCli(argv, io) {
+    const parsed = parseArgs(argv);
+    const refresh = new AbortController();
+    if (io.writeNotice &&
+        !parsed.help &&
+        !parsed.version &&
+        parsed.toolName &&
+        (toolDefinitions.some((tool) => tool.name === parsed.toolName) ||
+            isHistoryDownloadCommand(parsed.toolName) ||
+            parsed.toolName === "render_chart")) {
+        void getVersionStatus(PACKAGE_JSON, io.getLatestVersion ?? fetchLatestPackageVersion, {
+            cachePath: getVersionCacheLocation(),
+            signal: refresh.signal,
+        });
+    }
     try {
         await runCliInner(argv, io);
     }
@@ -448,6 +463,9 @@ export async function runCli(argv, io) {
         }
         throw error;
     }
+    finally {
+        refresh.abort();
+    }
 }
 function isPromptAbortError(error) {
     if (!error || typeof error !== "object")
@@ -484,6 +502,18 @@ async function runCliInner(argv, io) {
         io.exit(0);
         return;
     }
+    const builtinHelp = {
+        login: "Usage: insight login --key <api-key>\nSave your InsightSentry API key locally.",
+        logout: "Usage: insight logout\nRemove the saved API key.",
+        update: "Usage: insight update\nInstall the latest InsightSentry Tool package.",
+        version: "Usage: insight version\nShow installed and latest package versions.",
+        whoami: "Usage: insight whoami\nShow the configured user's email or UUID.",
+    };
+    if (help && builtinHelp[toolName]) {
+        io.write(builtinHelp[toolName]);
+        io.exit(0);
+        return;
+    }
     // Built-in commands
     if (toolName === "login") {
         const key = await resolveLoginKey(args, io);
@@ -581,6 +611,7 @@ async function runCliInner(argv, io) {
             }
             reportArgUsage(io, historyArgs, Object.keys(downloadHistorySchema), inputArgs);
             const result = await downloadHistory(parseDownloadHistoryArgs(historyArgs), {
+                signal: io.signal,
                 request,
                 onProgress: (event) => {
                     const target = event.files.length ? ` -> ${event.files.join(", ")}` : "";
@@ -589,6 +620,8 @@ async function runCliInner(argv, io) {
                 },
             });
             io.write(JSON.stringify(result, null, 2));
+            if (result.failed > 0)
+                io.exit(1);
             await maybeWritePostToolUpgradeNotice(io);
         }
         catch (error) {
@@ -635,7 +668,7 @@ async function runCliInner(argv, io) {
             const { config, width, height } = parseRenderChartArgs(resolvedArgs);
             reportArgUsage(io, resolvedArgs, Object.keys(RENDER_CHART_SCHEMA), inputArgs);
             const renderer = io.renderChart ?? renderChart;
-            const result = await renderer(config, width, height);
+            const result = await renderer(config, width, height, io.signal);
             io.write(JSON.stringify({
                 file: result.filePath,
                 mime_type: "image/png",
@@ -730,6 +763,7 @@ async function runCliInner(argv, io) {
             toolName: tool.name,
             method: tool.method,
             pathTemplate: tool.pathTemplate,
+            signal: io.signal,
             args: coerceArgs(apiArgs, tool.schema),
             request,
         });
@@ -1106,7 +1140,7 @@ async function runVersionCommand(io) {
 async function maybeWritePostToolUpgradeNotice(io) {
     if (!io.writeNotice)
         return;
-    const status = await getCachedVersionStatus(io);
+    const status = peekVersionStatus(PACKAGE_JSON, getVersionCacheLocation());
     const notice = formatUpgradeNotice(status);
     if (notice)
         io.writeNotice(notice);
@@ -1205,7 +1239,7 @@ function resolveRequest(io, apiKeyOverride) {
     const client = new ApiClient(apiKey, {
         onRetry: (event) => io.progress?.(formatRetryNotice(event)),
     });
-    return (method, path, params) => client.request(method, path, params);
+    return (method, path, params, options) => client.request(method, path, params, options);
 }
 function formatRetryNotice(event) {
     const seconds = Math.max(1, Math.ceil(event.delayMs / 1000));
@@ -1276,13 +1310,27 @@ async function resolveToolArgs(args, tool, io) {
                 resolved[key] = answer;
             }
         }
-        const storageAnswer = await resolveInteractiveStorageMode(resolved, tool.name, io);
-        if (storageAnswer === null)
-            return null;
-        await resolveStorageDestination(resolved, tool.name, io);
-        const filterAnswer = await resolveInteractiveFilter(resolved, io);
-        if (filterAnswer === null)
-            return null;
+        if (tool.name === "get_document" && coerceArgs(resolved, tool.schema).text === false) {
+            if (!resolved.output_file && !resolved.output_dir) {
+                const answer = await promptForOptionalStorageDestinationArg("output_file", z
+                    .string()
+                    .describe("PDF file path. Leave blank to save under ./.tmp/insight.")
+                    .optional(), resolved, tool.name, io);
+                if (answer === null)
+                    return null;
+                if (answer !== undefined)
+                    resolved.output_file = answer;
+            }
+        }
+        else {
+            const storageAnswer = await resolveInteractiveStorageMode(resolved, tool.name, io);
+            if (storageAnswer === null)
+                return null;
+            await resolveStorageDestination(resolved, tool.name, io);
+            const filterAnswer = await resolveInteractiveFilter(resolved, io);
+            if (filterAnswer === null)
+                return null;
+        }
     }
     else if (missingToolArgs(resolved, tool).length > 0) {
         return null;
@@ -1386,7 +1434,10 @@ async function promptForOptionalStorageDestinationArg(key, zodType, resolved, to
 }
 async function validateStorageDestinationAnswer(key, resolved, toolName, answer) {
     try {
-        await validateResponseStorageTarget({
+        const validate = toolName === "get_document" && coerceArgs(resolved, { text: z.boolean() }).text === false
+            ? validateDocumentStorageTarget
+            : validateResponseStorageTarget;
+        await validate({
             toolName,
             store: resolved.store,
             output_file: key === "output_file" ? answer : undefined,
@@ -2001,6 +2052,7 @@ export function main() {
         prompt: (question) => rl.question(question),
         selectTool: canUseKeyboardToolSelection() ? selectToolWithKeyboard : undefined,
         isInteractive: interactive,
+        signal: streamAbort.signal,
         streamSignal: streamAbort.signal,
         getStreamSignalExitCode: () => signalExitCode,
         runStream: async (options) => {
@@ -2013,12 +2065,12 @@ export function main() {
             }
         },
         exit: (code) => {
-            process.exitCode = code;
+            process.exitCode = signalExitCode ?? code;
         },
     })
         .catch((error) => {
         process.stderr.write(`Error: ${errorMessage(error)}\n`);
-        process.exitCode = 1;
+        process.exitCode = signalExitCode ?? 1;
     })
         .finally(() => {
         process.removeListener("SIGINT", handleSigint);