@insightsentry/mcp 1.4.14 → 1.4.16

package/dist/cli.d.ts

@@ -11,15 +11,26 @@ export declare function buildHelp(): string;
 export declare function buildDownloadHistoryHelp(): 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<{
+    stdout?: string;
+    stderr?: string;
+}>;
 interface CliIO {
     write: (s: string) => void;
     exit: (code: number) => void;
     request?: RequestFn;
+    createRequestFromApiKey?: (apiKey: string) => RequestFn;
+    runCommand?: RunCommandFn;
     progress?: (s: string) => void;
     prompt?: (question: string) => Promise<string>;
+    selectTool?: (options: ToolSelectionOption[]) => Promise<string | null>;
     isInteractive?: boolean;
     getAuthStatus?: () => AuthStatus;
 }
+interface ToolSelectionOption {
+    name: string;
+    description: string;
+}
 export declare function runCli(argv: string[], io: CliIO): Promise<void>;
 export declare function main(): void;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAyC,MAAM,kBAAkB,CAAC;AAgB1F,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAG7E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAwB/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;CACf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoCpD;AAED,wBAAgB,SAAS,IAAI,MAAM,CA6ClC;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CA8BjD;AAyFD,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;AAElB,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,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC;CAClC;AAKD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAiMrE;AAymBD,wBAAgB,IAAI,SASnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAyC,MAAM,kBAAkB,CAAC;AAgB1F,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAG7E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA8B/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;CACf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoCpD;AAED,wBAAgB,SAAS,IAAI,MAAM,CA8ClC;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CA8BjD;AAyFD,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;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,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,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,CA+OrE;AA04BD,wBAAgB,IAAI,SAWnB"}

package/dist/cli.js

@@ -1,5 +1,8 @@
+import { execFile } from "node:child_process";
 import { stdin as input, stdout as output } from "node:process";
+import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
+import { promisify } from "node:util";
 import { z } from "zod";
 import { ApiClient } from "./api-client.js";
 import { coerceArgs, getZodEnumValues, getZodTypeName, isOptionalZodType } from "./arg-coercion.js";
@@ -12,10 +15,12 @@ import { supportsCsvStorage, validateResponseStorageTarget, } from "./response-s
 import { analyzeSymbolCodes, shouldPromptSymbolScopedParam } from "./symbol-param-applicability.js";
 import { validateSymbolLikeArg } from "./symbol-validation.js";
 import { toolDefinitions } from "./tool-definitions.js";
-import { runApiTool } from "./tool-runner.js";
+import { runApiTool, validateFilterExpression } from "./tool-runner.js";
 export { coerceArgs } from "./arg-coercion.js";
 const DOWNLOAD_HISTORY_COMMAND = "download_history";
+const UPDATE_COMMAND = "update";
 const MAX_INTERACTIVE_PROMPT_ATTEMPTS = 3;
+const execFileAsync = promisify(execFile);
 const STORAGE_DESTINATION_SCHEMA = {
     output_file: z.string().describe("File path for stored response.").optional(),
     output_dir: z
@@ -33,6 +38,10 @@ const CSV_STORE_SCHEMA = z
     .default("none")
     .optional()
     .describe("Store original API response before filtering. CSV is available for series/history responses. Default: none.");
+const FILTER_SCHEMA = z
+    .string()
+    .optional()
+    .describe("JSONata expression to transform the response. Leave empty for no filter.");
 export function parseArgs(argv) {
     const args = {};
     let toolName = null;
@@ -91,13 +100,14 @@ export function buildHelp() {
     lines.push("  insight get_earnings --c US");
     lines.push('  insight list_options --code "NASDAQ:AAPL" --type call --range 10');
     lines.push("");
-    lines.push("All tools support --filter <jsonata> to transform the response.");
+    lines.push("API tools support --filter <jsonata> to transform the response.");
     lines.push("Use: insight <tool> --help for tool-specific parameters.");
     lines.push("");
     lines.push("Authentication:");
     lines.push("  insight login --key <your-api-key>    Save API key (persisted across sessions)");
     lines.push("  insight whoami                        Print the logged-in user's email");
     lines.push("  insight logout                        Remove saved API key");
+    lines.push("  insight update                        Update this CLI with npm");
     lines.push("");
     lines.push("  Or set INSIGHTSENTRY_API_KEY environment variable (takes priority over saved key).");
     lines.push("  Get your API key from https://insightsentry.com/dashboard");
@@ -281,7 +291,24 @@ function formatTypeName(t) {
 }
 const REQUIRED_DOWNLOAD_HISTORY_ARGS = ["symbol", "bar_type", "from", "to", "output_dir"];
 export async function runCli(argv, io) {
-    const { toolName, args, help } = parseArgs(argv);
+    let { toolName, args, help } = parseArgs(argv);
+    let sessionApiKey;
+    if (!toolName) {
+        if (!help && io.isInteractive === true && io.prompt) {
+            const selected = await resolveInteractiveToolName(io);
+            if (!selected) {
+                io.exit(1);
+                return;
+            }
+            toolName = selected.toolName;
+            sessionApiKey = selected.apiKey;
+        }
+        else {
+            io.write(buildHelp());
+            io.exit(0);
+            return;
+        }
+    }
     if (!toolName) {
         io.write(buildHelp());
         io.exit(0);
@@ -312,6 +339,10 @@ export async function runCli(argv, io) {
         io.exit(0);
         return;
     }
+    if (toolName === UPDATE_COMMAND) {
+        await runUpdateCommand(io);
+        return;
+    }
     if (toolName === "whoami") {
         const status = (io.getAuthStatus ?? getAuthStatus)();
         if (status.subject) {
@@ -330,22 +361,26 @@ export async function runCli(argv, io) {
             io.exit(0);
             return;
         }
-        const request = resolveRequest(io);
-        if (!request) {
-            io.write("Error: No API key found.\n\nSet it with:  insight login --key <your-api-key>\nOr export:    export INSIGHTSENTRY_API_KEY=your-api-key\n\nGet your API key from https://insightsentry.com/dashboard");
-            io.exit(1);
-            return;
-        }
         try {
-            const providedValidationError = validateDownloadHistoryArgs(args);
-            if (providedValidationError) {
-                io.write(`Invalid ${downloadHistoryPromptLabel(providedValidationError.key)}: ${providedValidationError.error}\n`);
-                io.exit(1);
-                return;
+            const inputArgs = { ...args };
+            const interactive = io.isInteractive === true && Boolean(io.prompt);
+            if (interactive) {
+                for (const error of collectInvalidProvidedDownloadHistoryArgs(inputArgs)) {
+                    io.write(`Invalid ${downloadHistoryPromptLabel(error.key)}: ${error.error}\n`);
+                    delete inputArgs[error.key];
+                }
+            }
+            else {
+                const providedValidationError = validateDownloadHistoryArgs(inputArgs);
+                if (providedValidationError) {
+                    io.write(`Invalid ${downloadHistoryPromptLabel(providedValidationError.key)}: ${providedValidationError.error}\n`);
+                    io.exit(1);
+                    return;
+                }
             }
-            const historyArgs = await resolveDownloadHistoryArgs(args, io);
+            const historyArgs = await resolveDownloadHistoryArgs(inputArgs, io);
             if (!historyArgs) {
-                io.write(`Error: Missing required options for download_history: ${missingDownloadHistoryArgs(args).join(", ")}\n\nRun: insight download_history --help`);
+                io.write(`Error: Missing required options for download_history: ${missingDownloadHistoryArgs(inputArgs).join(", ")}\n\nRun: insight download_history --help`);
                 io.exit(1);
                 return;
             }
@@ -355,6 +390,12 @@ export async function runCli(argv, io) {
                 io.exit(1);
                 return;
             }
+            const request = resolveRequest(io, sessionApiKey);
+            if (!request) {
+                io.write("Error: No API key found.\n\nSet it with:  insight login --key <your-api-key>\nOr export:    export INSIGHTSENTRY_API_KEY=your-api-key\n\nGet your API key from https://insightsentry.com/dashboard");
+                io.exit(1);
+                return;
+            }
             const result = await downloadHistory(parseDownloadHistoryArgs(historyArgs), {
                 request,
                 onProgress: (event) => {
@@ -384,13 +425,6 @@ export async function runCli(argv, io) {
         io.exit(0);
         return;
     }
-    // Resolve request function
-    const request = resolveRequest(io);
-    if (!request) {
-        io.write("Error: No API key found.\n\nSet it with:  insight login --key <your-api-key>\nOr export:    export INSIGHTSENTRY_API_KEY=your-api-key\n\nGet your API key from https://insightsentry.com/dashboard");
-        io.exit(1);
-        return;
-    }
     const inputArgs = { ...args };
     const interactive = io.isInteractive === true && Boolean(io.prompt);
     if (interactive) {
@@ -411,9 +445,27 @@ export async function runCli(argv, io) {
     }
     const storeModeError = validateStoreMode(tool.name, inputArgs.store);
     if (storeModeError) {
-        io.write(`Invalid Store: ${storeModeError}\n`);
-        io.exit(1);
-        return;
+        if (interactive) {
+            io.write(`Invalid Store: ${storeModeError}\n`);
+            delete inputArgs.store;
+        }
+        else {
+            io.write(`Invalid Store: ${storeModeError}\n`);
+            io.exit(1);
+            return;
+        }
+    }
+    const filterError = validateFilterExpression(inputArgs.filter);
+    if (filterError) {
+        if (interactive) {
+            io.write(`Invalid Filter: ${filterError}\n`);
+            delete inputArgs.filter;
+        }
+        else {
+            io.write(`Invalid Filter: ${filterError}\n`);
+            io.exit(1);
+            return;
+        }
     }
     const resolvedArgs = await resolveToolArgs(inputArgs, tool, io);
     if (!resolvedArgs) {
@@ -428,6 +480,13 @@ export async function runCli(argv, io) {
         io.exit(1);
         return;
     }
+    // Resolve request function
+    const request = resolveRequest(io, sessionApiKey);
+    if (!request) {
+        io.write("Error: No API key found.\n\nSet it with:  insight login --key <your-api-key>\nOr export:    export INSIGHTSENTRY_API_KEY=your-api-key\n\nGet your API key from https://insightsentry.com/dashboard");
+        io.exit(1);
+        return;
+    }
     try {
         const outputValue = await runApiTool({
             toolName: tool.name,
@@ -444,6 +503,91 @@ export async function runCli(argv, io) {
         io.exit(1);
     }
 }
+async function resolveInteractiveToolName(io) {
+    let apiKey;
+    const status = (io.getAuthStatus ?? getAuthStatus)();
+    if (!status.authenticated) {
+        io.write(status.message);
+        apiKey = (await resolveLoginKey({}, io)) ?? undefined;
+        if (!apiKey) {
+            io.write("Usage: insight login --key <your-api-key>\n\nGet your API key from https://insightsentry.com/dashboard");
+            return null;
+        }
+        saveConfig({ apiKey });
+        io.write(`API key saved to ${getConfigLocation()}`);
+    }
+    const options = interactiveToolOptions();
+    if (io.selectTool) {
+        const selected = await io.selectTool(options);
+        if (!selected)
+            io.write("No tool selected.");
+        return selected ? { toolName: selected, apiKey } : null;
+    }
+    io.write(buildInteractiveToolList(options));
+    for (let attempt = 0; attempt < MAX_INTERACTIVE_PROMPT_ATTEMPTS; attempt++) {
+        const answer = (await io.prompt?.("Choose tool (number or name): "))?.trim() ?? "";
+        const selected = parseToolSelection(answer, options);
+        if (selected)
+            return { toolName: selected, apiKey };
+        io.write("Invalid tool selection.");
+    }
+    io.write("No tool selected.");
+    return null;
+}
+async function runUpdateCommand(io) {
+    const runCommand = io.runCommand ?? defaultRunCommand;
+    io.write("Updating InsightSentry MCP CLI with: npm install -g @insightsentry/mcp");
+    try {
+        const result = await runCommand("npm", ["install", "-g", "@insightsentry/mcp"]);
+        const details = [result.stdout?.trim(), result.stderr?.trim()].filter(Boolean).join("\n");
+        if (details)
+            io.write(details);
+        io.write("InsightSentry MCP CLI updated.");
+        io.exit(0);
+    }
+    catch (error) {
+        io.write(`Error: ${error?.message ?? String(error)}`);
+        io.exit(1);
+    }
+}
+async function defaultRunCommand(command, args) {
+    return execFileAsync(command, args);
+}
+function interactiveToolOptions() {
+    return [
+        ...toolDefinitions.map((tool) => ({
+            name: tool.name,
+            description: summarizeToolDescription(tool.description),
+        })),
+        {
+            name: DOWNLOAD_HISTORY_COMMAND,
+            description: "Download historical ranges to JSON/CSV files",
+        },
+    ];
+}
+function buildInteractiveToolList(options) {
+    return [
+        "Choose a tool:",
+        "",
+        ...options.map((option, index) => `${index + 1}. ${option.name} - ${option.description}`),
+        "",
+        "Use arrow keys in a TTY, or type a number/name.",
+    ].join("\n");
+}
+function summarizeToolDescription(description) {
+    return description.split("→")[0].split(".")[0].trim();
+}
+function parseToolSelection(rawSelection, options) {
+    const selection = rawSelection.trim();
+    if (!selection)
+        return null;
+    const number = Number(selection);
+    if (Number.isInteger(number) && number >= 1 && number <= options.length) {
+        return options[number - 1].name;
+    }
+    const normalized = selection.toLowerCase();
+    return options.find((option) => option.name.toLowerCase() === normalized)?.name ?? null;
+}
 async function resolveLoginKey(args, io) {
     if (args.key?.trim())
         return args.key.trim();
@@ -460,12 +604,14 @@ async function resolveLoginKey(args, io) {
     }
     return null;
 }
-function resolveRequest(io) {
+function resolveRequest(io, apiKeyOverride) {
     if (io.request)
         return io.request;
-    const apiKey = resolveApiKey();
+    const apiKey = apiKeyOverride?.trim() || resolveApiKey();
     if (!apiKey)
         return null;
+    if (io.createRequestFromApiKey)
+        return io.createRequestFromApiKey(apiKey);
     const client = new ApiClient(apiKey);
     return (method, path, params) => client.request(method, path, params);
 }
@@ -508,6 +654,9 @@ async function resolveToolArgs(args, tool, 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;
@@ -528,6 +677,29 @@ async function resolveInteractiveStorageMode(resolved, toolName, io) {
 function storeModeSchema(toolName) {
     return supportsCsvStorage(toolName) ? CSV_STORE_SCHEMA : JSON_STORE_SCHEMA;
 }
+async function resolveInteractiveFilter(resolved, io) {
+    if (resolved.filter !== undefined)
+        return;
+    const answer = await promptForOptionalFilterArg(io);
+    if (answer === null)
+        return null;
+    if (answer !== undefined)
+        resolved.filter = answer;
+}
+async function promptForOptionalFilterArg(io) {
+    const label = "Filter";
+    const question = optionalPromptQuestion(label, FILTER_SCHEMA);
+    for (let attempt = 0; attempt < MAX_INTERACTIVE_PROMPT_ATTEMPTS; attempt++) {
+        const answer = (await io.prompt?.(question))?.trim() ?? "";
+        if (!answer)
+            return undefined;
+        const error = validateFilterExpression(answer);
+        if (!error)
+            return answer;
+        io.write(`Invalid ${label}: ${error}\n`);
+    }
+    return null;
+}
 function shouldSkipInteractiveToolArg(toolName, key, args) {
     if (toolName === "screen_crypto" && key === "countries")
         return true;
@@ -640,7 +812,7 @@ async function resolveDownloadHistoryArgs(args, io) {
         if (resolved[key] !== undefined)
             continue;
         if (REQUIRED_DOWNLOAD_HISTORY_ARGS.includes(key)) {
-            const answer = await promptForDownloadHistoryArg(key, io);
+            const answer = await promptForDownloadHistoryArg(key, resolved, io);
             if (!answer)
                 return null;
             resolved[key] = answer;
@@ -786,11 +958,18 @@ function validateStoreMode(toolName, store) {
     }
     return null;
 }
-async function promptForDownloadHistoryArg(key, io) {
+async function promptForDownloadHistoryArg(key, resolved, io) {
     const label = downloadHistoryPromptLabel(key);
-    const question = promptQuestion(label, downloadHistorySchema[key], "required");
+    const defaultAnswer = getDownloadHistoryPromptDefault(key, resolved);
+    const question = defaultAnswer
+        ? promptQuestion(label, downloadHistorySchema[key], "required", {
+            blankInstruction: "press Enter to use default",
+            value: defaultAnswer,
+        })
+        : promptQuestion(label, downloadHistorySchema[key], "required");
     for (let attempt = 0; attempt < MAX_INTERACTIVE_PROMPT_ATTEMPTS; attempt++) {
-        const answer = (await io.prompt?.(question))?.trim() ?? "";
+        const rawAnswer = (await io.prompt?.(question))?.trim() ?? "";
+        const answer = rawAnswer || defaultAnswer || "";
         const error = validateDownloadHistoryArgAnswer(key, answer);
         if (error) {
             io.write(`Invalid ${label}: ${error}\n`);
@@ -803,6 +982,20 @@ async function promptForDownloadHistoryArg(key, io) {
     }
     return null;
 }
+function getDownloadHistoryPromptDefault(key, resolved) {
+    if (key !== "to")
+        return null;
+    return resolved.bar_type === "second" ? currentUtcDay() : currentUtcMonth();
+}
+function currentUtcDay(date = new Date()) {
+    return `${date.getUTCFullYear()}-${pad2(date.getUTCMonth() + 1)}-${pad2(date.getUTCDate())}`;
+}
+function currentUtcMonth(date = new Date()) {
+    return `${date.getUTCFullYear()}-${pad2(date.getUTCMonth() + 1)}`;
+}
+function pad2(value) {
+    return String(value).padStart(2, "0");
+}
 async function validateDownloadHistoryStorageAnswer(key, answer) {
     if (key !== "output_dir")
         return null;
@@ -859,6 +1052,22 @@ function validateDownloadHistoryArgs(args) {
         return historyIntervalError;
     return null;
 }
+function collectInvalidProvidedDownloadHistoryArgs(args) {
+    const errors = [];
+    for (const key of Object.keys(downloadHistorySchema)) {
+        if (args[key] === undefined)
+            continue;
+        const error = validateDownloadHistoryArgAnswer(key, args[key]);
+        if (error)
+            errors.push({ key, error });
+    }
+    if (!errors.some((error) => error.key === "bar_interval")) {
+        const historyIntervalError = validateHistoryIntervalArgs(DOWNLOAD_HISTORY_COMMAND, args);
+        if (historyIntervalError)
+            errors.push(historyIntervalError);
+    }
+    return errors;
+}
 function downloadHistoryPromptLabel(key) {
     switch (key) {
         case "symbol":
@@ -919,7 +1128,7 @@ function parseDownloadHistoryArgs(args) {
 function optionalPromptQuestion(label, zodType) {
     return promptQuestion(label, zodType, "optional");
 }
-function promptQuestion(label, zodType, requirement) {
+function promptQuestion(label, zodType, requirement, defaultOverride) {
     const parts = [requirement];
     const enumValues = getZodEnumValues(zodType);
     if (enumValues.length > 0)
@@ -929,12 +1138,16 @@ function promptQuestion(label, zodType, requirement) {
         if (typeName && typeName !== "string")
             parts.push(`type: ${typeName}`);
     }
-    const defaultValue = getPromptDefault(zodType);
+    const defaultValue = defaultOverride?.value ?? getPromptDefault(zodType);
     if (defaultValue !== null)
         parts.push(`Default: ${defaultValue}`);
     const hint = getPromptHint(zodType);
-    if (requirement !== "required")
+    if (defaultOverride) {
+        parts.push(defaultOverride.blankInstruction);
+    }
+    else if (requirement !== "required") {
         parts.push("press Enter to skip");
+    }
     const description = hint ? `${label}: ${hint}\n` : "";
     return `${description}${label} (${parts.join(", ")}): `;
 }
@@ -975,13 +1188,114 @@ function getPromptHint(zodType) {
         return null;
     return hint;
 }
+function canUseKeyboardToolSelection() {
+    return (input.isTTY === true &&
+        output.isTTY === true &&
+        typeof input.setRawMode === "function" &&
+        process.env.CI !== "true");
+}
+function selectToolWithKeyboard(options) {
+    return new Promise((resolve) => {
+        let selectedIndex = 0;
+        let typed = "";
+        let error = "";
+        let closed = false;
+        const wasRaw = input.isRaw;
+        const render = () => {
+            output.write("\x1B[2J\x1B[H\x1B[?25l");
+            output.write("Choose a tool:\n\n");
+            for (const [index, option] of options.entries()) {
+                const marker = index === selectedIndex ? ">" : " ";
+                output.write(`${marker} ${index + 1}. ${option.name} - ${option.description}\n`);
+            }
+            output.write("\nUse Up/Down, Enter, or type a number/name.");
+            output.write(`\nChoose tool: ${typed}`);
+            if (error)
+                output.write(`\n${error}`);
+        };
+        const cleanup = () => {
+            if (closed)
+                return;
+            closed = true;
+            input.off("keypress", onKeypress);
+            input.setRawMode(Boolean(wasRaw));
+            output.write("\x1B[?25h\n");
+        };
+        const finish = (toolName) => {
+            cleanup();
+            resolve(toolName);
+        };
+        const updateSelectedFromTyped = () => {
+            const selected = parseToolSelection(typed, options);
+            if (!selected)
+                return;
+            selectedIndex = options.findIndex((option) => option.name === selected);
+        };
+        const onKeypress = (value, key) => {
+            if (key.ctrl && key.name === "c") {
+                finish(null);
+                return;
+            }
+            if (key.name === "escape") {
+                finish(null);
+                return;
+            }
+            if (key.name === "up") {
+                selectedIndex = selectedIndex === 0 ? options.length - 1 : selectedIndex - 1;
+                typed = "";
+                error = "";
+                render();
+                return;
+            }
+            if (key.name === "down") {
+                selectedIndex = selectedIndex === options.length - 1 ? 0 : selectedIndex + 1;
+                typed = "";
+                error = "";
+                render();
+                return;
+            }
+            if (key.name === "return" || key.name === "enter") {
+                const selected = typed.trim()
+                    ? parseToolSelection(typed, options)
+                    : options[selectedIndex].name;
+                if (selected) {
+                    finish(selected);
+                    return;
+                }
+                error = "Invalid tool selection.";
+                render();
+                return;
+            }
+            if (key.name === "backspace") {
+                typed = typed.slice(0, -1);
+                error = "";
+                updateSelectedFromTyped();
+                render();
+                return;
+            }
+            if (value && value >= " " && !key.ctrl && key.sequence !== "\x7F") {
+                typed += value;
+                error = "";
+                updateSelectedFromTyped();
+                render();
+            }
+        };
+        emitKeypressEvents(input);
+        input.setRawMode(true);
+        input.resume();
+        input.on("keypress", onKeypress);
+        render();
+    });
+}
 export function main() {
     const rl = createInterface({ input, output });
+    const interactive = process.stdin.isTTY && process.stdout.isTTY && process.env.CI !== "true";
     runCli(process.argv.slice(2), {
         write: (s) => process.stdout.write(`${s}\n`),
         progress: (s) => process.stderr.write(`${s}\n`),
         prompt: (question) => rl.question(question),
-        isInteractive: process.stdin.isTTY && process.stdout.isTTY && process.env.CI !== "true",
+        selectTool: canUseKeyboardToolSelection() ? selectToolWithKeyboard : undefined,
+        isInteractive: interactive,
         exit: (code) => process.exit(code),
     }).finally(() => rl.close());
 }