@alchemy/cli 0.7.0 → 0.7.1

package/README.md

@@ -82,7 +82,7 @@ Have your agent run `agent-prompt` as its first step to get a complete, machine-
 alchemy --json --no-interactive agent-prompt
 ```
 
-This returns a single JSON document with execution policy, preflight instructions, auth matrix, the full command tree with all arguments and options, error codes with recovery actions, and example invocations. No external docs required.
+This returns a single JSON document with execution policy, runtime discovery instructions, preflight instructions, auth matrix, the full command tree with all arguments and options, error codes with recovery actions, and example invocations. No external docs required.
 
 Agents can also call `alchemy --json --no-interactive update-check` to retrieve the current CLI version, latest known version, and install command for upgrades.
 

package/dist/{auth-4HAUNG54.js → auth-BNT5Z5GZ.js}

@@ -3,11 +3,11 @@ if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   registerAuth,
   selectAppAfterAuth
-} from "./chunk-I3X4G2UY.js";
+} from "./chunk-SYP6KKP6.js";
 import "./chunk-HSKKIATB.js";
 import "./chunk-HYCRHNPX.js";
 import "./chunk-TOEVZMIP.js";
-import "./chunk-A6L3WCJN.js";
+import "./chunk-5IFXLC2S.js";
 import "./chunk-7WD3YLRK.js";
 import "./chunk-QEDAULQ2.js";
 export {

package/dist/{chunk-A6L3WCJN.js → chunk-5IFXLC2S.js}

@@ -46,6 +46,53 @@ function suspendStdinKeypressListeners() {
     }
   };
 }
+function resetStdinKeypressDecoder() {
+  const input = stdin;
+  for (const symbol of Object.getOwnPropertySymbols(input)) {
+    const name = String(symbol);
+    if (name === "Symbol(keypress-decoder)" || name === "Symbol(escape-decoder)") {
+      delete input[symbol];
+    }
+  }
+}
+function isReadlineKeypressDataListener(listener) {
+  return typeof listener === "function" && listener.name === "onData";
+}
+function prepareStdinKeypressEvents() {
+  const dataListeners = stdin.listeners("data");
+  const keypressListeners = stdin.listeners("keypress");
+  for (const listener of dataListeners) {
+    stdin.removeListener("data", listener);
+  }
+  for (const listener of keypressListeners) {
+    stdin.removeListener("keypress", listener);
+  }
+  resetStdinKeypressDecoder();
+  readline.emitKeypressEvents(stdin);
+  return () => {
+    for (const listener of stdin.listeners("data")) {
+      stdin.removeListener("data", listener);
+    }
+    resetStdinKeypressDecoder();
+    for (const listener of dataListeners) {
+      if (!isReadlineKeypressDataListener(listener)) {
+        stdin.on("data", listener);
+      }
+    }
+    for (const listener of keypressListeners) {
+      stdin.on("keypress", listener);
+    }
+    if (keypressListeners.length > 0) {
+      readline.emitKeypressEvents(stdin);
+    }
+  };
+}
+function requestPromptInterrupt() {
+  const handled = process.emit("SIGINT", "SIGINT");
+  if (!handled) {
+    process.exit(130);
+  }
+}
 async function runListPrompt(opts) {
   if (!stdin.isTTY || !stdout.isTTY) {
     if (opts.allowMultiple) {
@@ -54,8 +101,7 @@ async function runListPrompt(opts) {
     const initial = opts.initialValue ?? opts.options.find((o) => !o.disabled)?.value ?? null;
     return { value: initial, cancelled: false };
   }
-  readline.emitKeypressEvents(stdin);
-  const restoreKeypressListeners = suspendStdinKeypressListeners();
+  const restoreKeypressEvents = prepareStdinKeypressEvents();
   const previousRawMode = stdin.isRaw;
   stdin.resume();
   stdin.setRawMode(true);
@@ -131,7 +177,7 @@ async function runListPrompt(opts) {
     if (renderedLines > 0) clearRenderedLines(renderedLines);
     stdin.setRawMode(previousRawMode);
     stdin.removeListener("keypress", onKeypress);
-    restoreKeypressListeners();
+    restoreKeypressEvents();
     if (!previousRawMode) {
       stdin.pause();
     }
@@ -144,7 +190,13 @@ async function runListPrompt(opts) {
   const onKeypress = (str, key) => {
     const filtered = getFiltered();
     const current = filtered[cursor];
-    if (key.name === "escape" || key.ctrl && key.name === "c") {
+    if (key.ctrl && key.name === "c") {
+      cleanup();
+      requestPromptInterrupt();
+      resolver({ value: null, cancelled: true });
+      return;
+    }
+    if (key.name === "escape") {
       cleanup();
       resolver({ value: null, cancelled: true });
       return;
@@ -222,8 +274,10 @@ async function promptText(opts) {
   const previousRawMode = stdin.isRaw;
   if (previousRawMode) stdin.setRawMode(false);
   const ABORTED = /* @__PURE__ */ Symbol("aborted");
+  const INTERRUPTED = /* @__PURE__ */ Symbol("interrupted");
+  let removeAbortListener;
   const value = await new Promise((resolve) => {
-    rl.on("SIGINT", () => resolve(null));
+    rl.on("SIGINT", () => resolve(INTERRUPTED));
     rl.question(question, (answer) => resolve(answer));
     if (opts.abortSignal) {
       const onAbort = () => resolve(ABORTED);
@@ -231,18 +285,24 @@ async function promptText(opts) {
         onAbort();
       } else {
         opts.abortSignal.addEventListener("abort", onAbort, { once: true });
+        removeAbortListener = () => opts.abortSignal?.removeEventListener("abort", onAbort);
       }
     }
   });
   rl.close();
+  removeAbortListener?.();
   restoreKeypressListeners();
-  if (previousRawMode) stdin.setRawMode(true);
+  if (previousRawMode) {
+    stdin.setRawMode(true);
+  } else {
+    stdin.pause();
+  }
   if (opts.clearAfterSubmit || value === ABORTED) {
     clearRenderedLines(2);
   }
   if (value === ABORTED) return "";
-  if (value === null) {
-    printCancel(opts.cancelMessage);
+  if (value === INTERRUPTED) {
+    requestPromptInterrupt();
     return null;
   }
   if (!value.trim() && opts.defaultValue !== void 0) return opts.defaultValue;

package/dist/{chunk-WWWVMK3J.js → chunk-RS3DSL3X.js}

@@ -53,7 +53,7 @@ function semverLT(a, b) {
   return false;
 }
 function currentVersion() {
-  return true ? "0.7.0" : "0.0.0";
+  return true ? "0.7.1" : "0.0.0";
 }
 function toUpdateStatus(latestVersion, checkedAt) {
   const current = currentVersion();

package/dist/{chunk-I3X4G2UY.js → chunk-SYP6KKP6.js}

@@ -20,7 +20,7 @@ import {
   promptAutocomplete,
   promptText,
   withSpinner
-} from "./chunk-A6L3WCJN.js";
+} from "./chunk-5IFXLC2S.js";
 import {
   configPath,
   load,

package/dist/index.js

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   registerAuth
-} from "./chunk-I3X4G2UY.js";
+} from "./chunk-SYP6KKP6.js";
 import {
   openBrowser
 } from "./chunk-HSKKIATB.js";
@@ -46,7 +46,7 @@ import {
   getAvailableUpdate,
   getUpdateStatus,
   printUpdateNotice
-} from "./chunk-WWWVMK3J.js";
+} from "./chunk-RS3DSL3X.js";
 import {
   bold,
   brand,
@@ -70,7 +70,7 @@ import {
   weiToEth,
   withSpinner,
   yellow
-} from "./chunk-A6L3WCJN.js";
+} from "./chunk-5IFXLC2S.js";
 import {
   KEY_MAP,
   configDir,
@@ -283,7 +283,6 @@ function validateTxHash(hash) {
 
 // src/commands/config.ts
 var RESET_KEY_MAP = { ...KEY_MAP, app: "app" };
-var APP_SEARCH_THRESHOLD = 15;
 async function saveAppWithPrompt(app) {
   const cfg = load();
   const updated = {
@@ -331,17 +330,12 @@ async function selectOrCreateApp(admin) {
       })),
       { label: "Create a new app", value: CREATE_NEW }
     ];
-    const selected = apps.length > APP_SEARCH_THRESHOLD ? await promptAutocomplete({
+    const selected = await promptAutocomplete({
       message: "Select default app",
       placeholder: "Type app name or id",
       options,
       cancelMessage: "Cancelled app selection.",
       commitLabel: null
-    }) : await promptSelect({
-      message: "Select default app",
-      options,
-      cancelMessage: "Cancelled app selection.",
-      commitLabel: null
     });
     if (selected === null) {
       return;
@@ -1185,8 +1179,9 @@ function registerApps(program2) {
           printJSON({ apps: result.apps.map(maskAppSecrets) });
           return;
         }
-        const appId = await promptSelect({
+        const appId = await promptAutocomplete({
           message: "Select an app",
+          placeholder: "Type to search by name or id",
           options: result.apps.map((app) => ({
             value: app.id,
             label: app.name,
@@ -4694,12 +4689,39 @@ function buildAgentPrompt(program2) {
       "Parse stdout as JSON on exit code 0",
       "Parse stderr as JSON on nonzero exit code",
       "Never run bare 'alchemy' without --json --no-interactive",
+      "Before answering Alchemy CLI capability or usage questions, inspect the live command contract from agent-prompt and trust it over model memory",
+      "For general capability and usage questions, prefer npx -y @alchemy/cli@latest --json --no-interactive agent-prompt so stale local installs or PATH shims do not hide new commands",
+      "Use the user's installed alchemy binary only when executing commands against their local config or diagnosing their installed version",
+      "If installed alchemy help contradicts latest npm help, compare alchemy --json --no-interactive version with npx -y @alchemy/cli@latest --json --no-interactive version and check command -v alchemy",
       "Run alchemy --json --no-interactive update-check when you need to detect available CLI upgrades"
     ],
     preflight: {
       command: "alchemy --json --no-interactive config status",
       description: "Check auth readiness before first command. If complete is false, follow nextCommands in the response to configure auth."
     },
+    runtimeDiscovery: {
+      installed: {
+        command: "alchemy --json --no-interactive agent-prompt",
+        description: "Use for the user's currently installed CLI only when executing against local config or diagnosing local install behavior."
+      },
+      latest: {
+        command: "npx -y @alchemy/cli@latest --json --no-interactive agent-prompt",
+        description: "Default source of truth for general capability and usage questions; avoids stale local installs and PATH shims."
+      },
+      commandHelp: {
+        commandTemplate: "npx -y @alchemy/cli@latest --no-interactive help <command...>",
+        description: "Use for command-specific help from the latest published CLI when constructing an invocation."
+      },
+      versionCheck: {
+        installedCommand: "alchemy --json --no-interactive version",
+        latestCommand: "npx -y @alchemy/cli@latest --json --no-interactive version",
+        description: "Compare when local help or agent-prompt output appears stale after an install or update."
+      },
+      pathCheck: {
+        command: "command -v alchemy && alchemy version",
+        description: "Use when installed CLI behavior contradicts the latest contract or an update appears not to take effect."
+      }
+    },
     auth: [
       {
         method: "API key",
@@ -4809,6 +4831,19 @@ function formatAsSystemPrompt(payload) {
   lines.push(`  Command: ${payload.preflight.command}`);
   lines.push(`  ${payload.preflight.description}`);
   lines.push("");
+  lines.push("Runtime discovery:");
+  lines.push(`  Installed CLI: ${payload.runtimeDiscovery.installed.command}`);
+  lines.push(`    ${payload.runtimeDiscovery.installed.description}`);
+  lines.push(`  Latest npm CLI: ${payload.runtimeDiscovery.latest.command}`);
+  lines.push(`    ${payload.runtimeDiscovery.latest.description}`);
+  lines.push(`  Command help: ${payload.runtimeDiscovery.commandHelp.commandTemplate}`);
+  lines.push(`    ${payload.runtimeDiscovery.commandHelp.description}`);
+  lines.push(`  Installed version: ${payload.runtimeDiscovery.versionCheck.installedCommand}`);
+  lines.push(`  Latest npm version: ${payload.runtimeDiscovery.versionCheck.latestCommand}`);
+  lines.push(`    ${payload.runtimeDiscovery.versionCheck.description}`);
+  lines.push(`  Path check: ${payload.runtimeDiscovery.pathCheck.command}`);
+  lines.push(`    ${payload.runtimeDiscovery.pathCheck.description}`);
+  lines.push("");
   lines.push("Auth methods:");
   for (const auth of payload.auth) {
     lines.push(`  ${auth.method}:`);
@@ -7953,7 +7988,7 @@ function resetUpdateNoticeState() {
 }
 program.name("alchemy").description(
   "The Alchemy CLI lets you query blockchain data, call JSON-RPC methods, and manage your Alchemy configuration."
-).version("0.7.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
+).version("0.7.1", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
   "-n, --network <network>",
   "Target network (default: eth-mainnet) (env: ALCHEMY_NETWORK)"
 ).option("--x402", "Use x402 wallet-based gateway auth").option(
@@ -8144,7 +8179,7 @@ ${styledLine}`;
     const authToken = resolveAuthToken2(cfg);
     const hasApiKey = Boolean(cfg.api_key?.trim() || cfg.app?.apiKey);
     if (authToken && !hasApiKey) {
-      const { selectAppAfterAuth } = await import("./auth-4HAUNG54.js");
+      const { selectAppAfterAuth } = await import("./auth-BNT5Z5GZ.js");
       console.log("");
       console.log(`  No app selected. Please select an app to continue.`);
       await selectAppAfterAuth(authToken);
@@ -8175,7 +8210,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-RBJF5E7U.js");
+      const { runOnboarding } = await import("./onboarding-S6HKWOEA.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -8189,7 +8224,7 @@ ${styledLine}`;
         latestForInteractiveStartup
       );
     }
-    const { startREPL } = await import("./interactive-F2AFLW7U.js");
+    const { startREPL } = await import("./interactive-N33RCX33.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {

package/dist/{interactive-F2AFLW7U.js → interactive-N33RCX33.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-TOEVZMIP.js";
 import {
   getUpdateNoticeLines
-} from "./chunk-WWWVMK3J.js";
+} from "./chunk-RS3DSL3X.js";
 import {
   bold,
   brand,
@@ -17,7 +17,7 @@ import {
   dim,
   green,
   setBrandedHelpSuppressed
-} from "./chunk-A6L3WCJN.js";
+} from "./chunk-5IFXLC2S.js";
 import {
   configDir,
   load
@@ -436,6 +436,9 @@ async function startREPL(program, latestUpdate = null) {
   };
   return new Promise((resolve) => {
     rl.on("line", (line) => void onLine(line));
+    rl.on("SIGINT", () => {
+      rl.close();
+    });
     rl.on("close", () => {
       if (Array.isArray(rlWithHistory.history)) {
         saveReplHistory([...rlWithHistory.history].reverse());

package/dist/{onboarding-RBJF5E7U.js → onboarding-S6HKWOEA.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getUpdateNoticeLines
-} from "./chunk-WWWVMK3J.js";
+} from "./chunk-RS3DSL3X.js";
 import {
   bold,
   brand,
@@ -10,7 +10,7 @@ import {
   dim,
   green,
   promptText
-} from "./chunk-A6L3WCJN.js";
+} from "./chunk-5IFXLC2S.js";
 import {
   load,
   save
@@ -51,7 +51,7 @@ async function runOnboarding(_program, latestUpdate = null) {
       auth_token_expires_at: result.expiresAt
     });
     console.log(`  ${green("\u2713")} Logged in successfully`);
-    const { selectAppAfterAuth } = await import("./auth-4HAUNG54.js");
+    const { selectAppAfterAuth } = await import("./auth-BNT5Z5GZ.js");
     await selectAppAfterAuth(result.token);
     return true;
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Alchemy CLI — interact with blockchain data",
   "type": "module",
   "bin": {