electric-ax 0.1.13 → 0.1.14

package/dist/index.cjs

@@ -8,7 +8,95 @@ const node_os = require_chunk.__toESM(require("node:os"));
 const node_path = require_chunk.__toESM(require("node:path"));
 const node_url = require_chunk.__toESM(require("node:url"));
 const commander = require_chunk.__toESM(require("commander"));
+const node_readline_promises = require_chunk.__toESM(require("node:readline/promises"));
 
+//#region src/prompt-api-key.ts
+const FRIENDLY_INTRO = [
+	``,
+	`The Electric Agents quickstart requires setting an API key to connect to an LLM provider.`,
+	``,
+	`Currently (in this initial developer preview release) the key must be an ANTHROPIC_API_KEY.`,
+	`Support for other LLM providers is coming very soon.`,
+	``,
+	`Note that your API key never leaves your local computer. It's used by the agent entities`,
+	`installed by default in the Electric Agents runtime and by the example agents included`,
+	`in the quickstart template.`,
+	``,
+	`Would you like to:`,
+	``,
+	`  1. manually setup a .env file with ANTHROPIC_API_KEY=...`,
+	`  2. paste your api key into a prompt and we'll set it up for you`,
+	``
+].join(`\n`);
+const MANUAL_SETUP_INSTRUCTIONS = [
+	``,
+	`No problem. To finish setup:`,
+	``,
+	`  1. Get a key from https://console.anthropic.com/settings/keys`,
+	`  2. Add a line to your .env file:`,
+	`         ANTHROPIC_API_KEY=sk-ant-...`,
+	`  3. Re-run the command.`,
+	``
+].join(`\n`);
+function defaultPromptIO() {
+	return {
+		input: process.stdin,
+		output: process.stdout,
+		isTTY: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+		cwd: process.cwd(),
+		exit: process.exit.bind(process)
+	};
+}
+async function ensureAnthropicApiKey(options, io = defaultPromptIO()) {
+	try {
+		return require_env.resolveAnthropicApiKey(options);
+	} catch (error) {
+		if (!io.isTTY) throw error;
+	}
+	io.output.write(FRIENDLY_INTRO);
+	const rl = (0, node_readline_promises.createInterface)({
+		input: io.input,
+		output: io.output
+	});
+	try {
+		const choice = (await rl.question(`Enter 1/2: `)).trim();
+		if (choice === `1`) {
+			io.output.write(MANUAL_SETUP_INSTRUCTIONS);
+			io.exit(0);
+			throw new Error(`unreachable`);
+		}
+		if (choice === `2`) {
+			const key = (await rl.question(`Paste your ANTHROPIC_API_KEY: `)).trim();
+			if (!key) throw new Error(`No API key provided. Re-run the command and try again.`);
+			const envPath = writeApiKeyToDotEnv(key, io.cwd);
+			process.env.ANTHROPIC_API_KEY = key;
+			io.output.write(`\nSaved ANTHROPIC_API_KEY to ${envPath}\n\n`);
+			return key;
+		}
+		throw new Error(`Unrecognized choice ${JSON.stringify(choice)}. Please re-run the command and enter 1 or 2.`);
+	} finally {
+		rl.close();
+	}
+}
+function writeApiKeyToDotEnv(key, cwd) {
+	const envPath = (0, node_path.resolve)(cwd, `.env`);
+	const newLine = `ANTHROPIC_API_KEY=${key}`;
+	if (!(0, node_fs.existsSync)(envPath)) {
+		(0, node_fs.writeFileSync)(envPath, `${newLine}\n`, `utf8`);
+		return envPath;
+	}
+	const existing = (0, node_fs.readFileSync)(envPath, `utf8`);
+	const replaced = existing.replace(/^ANTHROPIC_API_KEY=.*$/m, newLine);
+	if (replaced !== existing) {
+		(0, node_fs.writeFileSync)(envPath, replaced, `utf8`);
+		return envPath;
+	}
+	const separator = existing.length === 0 || existing.endsWith(`\n`) ? `` : `\n`;
+	(0, node_fs.writeFileSync)(envPath, `${existing}${separator}${newLine}\n`, `utf8`);
+	return envPath;
+}
+
+//#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
 var CliError = class extends Error {};
@@ -257,6 +345,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 			return started;
 		},
 		startBuiltin: async (options) => {
+			options.anthropicApiKey = await ensureAnthropicApiKey(options);
 			const { startBuiltinAgentsServer } = await loadStartModule();
 			return startBuiltinAgentsServer(options, { agentServerUrl: env.electricAgentsUrl });
 		},
@@ -267,7 +356,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 			return stopped;
 		},
 		quickstart: async (options) => {
-			require_env.resolveAnthropicApiKey(options);
+			options.anthropicApiKey = await ensureAnthropicApiKey(options);
 			const { startBuiltinAgentsServer, startElectricAgentsDevEnvironment } = await loadStartModule();
 			const started = await startElectricAgentsDevEnvironment();
 			printStartedEnvironment(started);

package/dist/index.js

@@ -1,12 +1,100 @@
 #!/usr/bin/env node
 import { installCompletions, setupCompletions } from "./completions-B-Lf28Wy.js";
 import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-LZtIfFz1.js";
-import { realpathSync } from "node:fs";
+import { existsSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
 import { hostname, userInfo } from "node:os";
 import { basename, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
+import { createInterface } from "node:readline/promises";
 
+//#region src/prompt-api-key.ts
+const FRIENDLY_INTRO = [
+	``,
+	`The Electric Agents quickstart requires setting an API key to connect to an LLM provider.`,
+	``,
+	`Currently (in this initial developer preview release) the key must be an ANTHROPIC_API_KEY.`,
+	`Support for other LLM providers is coming very soon.`,
+	``,
+	`Note that your API key never leaves your local computer. It's used by the agent entities`,
+	`installed by default in the Electric Agents runtime and by the example agents included`,
+	`in the quickstart template.`,
+	``,
+	`Would you like to:`,
+	``,
+	`  1. manually setup a .env file with ANTHROPIC_API_KEY=...`,
+	`  2. paste your api key into a prompt and we'll set it up for you`,
+	``
+].join(`\n`);
+const MANUAL_SETUP_INSTRUCTIONS = [
+	``,
+	`No problem. To finish setup:`,
+	``,
+	`  1. Get a key from https://console.anthropic.com/settings/keys`,
+	`  2. Add a line to your .env file:`,
+	`         ANTHROPIC_API_KEY=sk-ant-...`,
+	`  3. Re-run the command.`,
+	``
+].join(`\n`);
+function defaultPromptIO() {
+	return {
+		input: process.stdin,
+		output: process.stdout,
+		isTTY: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+		cwd: process.cwd(),
+		exit: process.exit.bind(process)
+	};
+}
+async function ensureAnthropicApiKey(options, io = defaultPromptIO()) {
+	try {
+		return resolveAnthropicApiKey(options);
+	} catch (error) {
+		if (!io.isTTY) throw error;
+	}
+	io.output.write(FRIENDLY_INTRO);
+	const rl = createInterface({
+		input: io.input,
+		output: io.output
+	});
+	try {
+		const choice = (await rl.question(`Enter 1/2: `)).trim();
+		if (choice === `1`) {
+			io.output.write(MANUAL_SETUP_INSTRUCTIONS);
+			io.exit(0);
+			throw new Error(`unreachable`);
+		}
+		if (choice === `2`) {
+			const key = (await rl.question(`Paste your ANTHROPIC_API_KEY: `)).trim();
+			if (!key) throw new Error(`No API key provided. Re-run the command and try again.`);
+			const envPath = writeApiKeyToDotEnv(key, io.cwd);
+			process.env.ANTHROPIC_API_KEY = key;
+			io.output.write(`\nSaved ANTHROPIC_API_KEY to ${envPath}\n\n`);
+			return key;
+		}
+		throw new Error(`Unrecognized choice ${JSON.stringify(choice)}. Please re-run the command and enter 1 or 2.`);
+	} finally {
+		rl.close();
+	}
+}
+function writeApiKeyToDotEnv(key, cwd) {
+	const envPath = resolve(cwd, `.env`);
+	const newLine = `ANTHROPIC_API_KEY=${key}`;
+	if (!existsSync(envPath)) {
+		writeFileSync(envPath, `${newLine}\n`, `utf8`);
+		return envPath;
+	}
+	const existing = readFileSync(envPath, `utf8`);
+	const replaced = existing.replace(/^ANTHROPIC_API_KEY=.*$/m, newLine);
+	if (replaced !== existing) {
+		writeFileSync(envPath, replaced, `utf8`);
+		return envPath;
+	}
+	const separator = existing.length === 0 || existing.endsWith(`\n`) ? `` : `\n`;
+	writeFileSync(envPath, `${existing}${separator}${newLine}\n`, `utf8`);
+	return envPath;
+}
+
+//#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
 var CliError = class extends Error {};
@@ -255,6 +343,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 			return started;
 		},
 		startBuiltin: async (options) => {
+			options.anthropicApiKey = await ensureAnthropicApiKey(options);
 			const { startBuiltinAgentsServer } = await loadStartModule();
 			return startBuiltinAgentsServer(options, { agentServerUrl: env.electricAgentsUrl });
 		},
@@ -265,7 +354,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 			return stopped;
 		},
 		quickstart: async (options) => {
-			resolveAnthropicApiKey(options);
+			options.anthropicApiKey = await ensureAnthropicApiKey(options);
 			const { startBuiltinAgentsServer, startElectricAgentsDevEnvironment } = await loadStartModule();
 			const started = await startElectricAgentsDevEnvironment();
 			printStartedEnvironment(started);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electric-ax",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "CLI for Electric Agents",
   "author": "ElectricSQL team and contributors",
   "license": "Apache-2.0",