electric-ax 0.1.12 → 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 {};
@@ -60,13 +148,13 @@ function resolveCommandName(argv) {
 	return invoked.replace(/\.(c|m)?js$/, ``);
 }
 function commandExample(commandName) {
-	return `${commandName} agent`;
+	return `${commandName} agents`;
 }
 function resolveCommandPrefix(argv, env = process.env) {
 	if (env.npm_command === `exec`) {
 		const userAgent = env.npm_config_user_agent ?? ``;
-		if (userAgent.startsWith(`pnpm/`)) return `pnpx electric-ax agent`;
-		if (userAgent.startsWith(`npm/`)) return `npx electric-ax agent`;
+		if (userAgent.startsWith(`pnpm/`)) return `pnpx electric-ax agents`;
+		if (userAgent.startsWith(`npm/`)) return `npx electric-ax agents`;
 	}
 	return commandExample(resolveCommandName(argv));
 }
@@ -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);
@@ -313,7 +402,7 @@ Examples:
 function createElectricProgram({ env = getElectricCliEnv(), commandName = `electric`, commandPrefix = commandExample(commandName), handlers = createElectricCliHandlers(env, commandPrefix) } = {}) {
 	const program = new commander.Command();
 	program.name(commandName).description(`Manage Electric tooling`).showHelpAfterError().showSuggestionAfterError().addHelpText(`after`, getHelpText(commandName));
-	const agentsCommand = program.command(`agent`).alias(`agents`).description(`Manage Electric Agents`);
+	const agentsCommand = program.command(`agents`).description(`Manage Electric Agents`);
 	const typesCommand = agentsCommand.command(`types`).description(`List entity types`).action(async () => {
 		await handlers.listTypes();
 	});
@@ -378,7 +467,7 @@ Setup (add to your shell init file):
   Fish:  ${commandName} --completion-fish | source    # add to config.fish
 
 Auto-install (detects your shell and updates init file):
-  ${commandName} agent completion install
+  ${commandName} agents completion install
 `).action((action) => {
 		if (action === `install`) {
 			try {
@@ -393,7 +482,7 @@ Auto-install (detects your shell and updates init file):
 		console.log(`Add to your shell init file:`);
 		console.log(`  Bash/Zsh:  eval "$(${commandName} --completion)"`);
 		console.log(`  Fish:      ${commandName} --completion-fish | source\n`);
-		console.log(`Or auto-install:  ${commandName} agent completion install`);
+		console.log(`Or auto-install:  ${commandName} agents completion install`);
 	});
 	completionCommand.alias(`completions`);
 	return program;

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 {};
@@ -58,13 +146,13 @@ function resolveCommandName(argv) {
 	return invoked.replace(/\.(c|m)?js$/, ``);
 }
 function commandExample(commandName) {
-	return `${commandName} agent`;
+	return `${commandName} agents`;
 }
 function resolveCommandPrefix(argv, env = process.env) {
 	if (env.npm_command === `exec`) {
 		const userAgent = env.npm_config_user_agent ?? ``;
-		if (userAgent.startsWith(`pnpm/`)) return `pnpx electric-ax agent`;
-		if (userAgent.startsWith(`npm/`)) return `npx electric-ax agent`;
+		if (userAgent.startsWith(`pnpm/`)) return `pnpx electric-ax agents`;
+		if (userAgent.startsWith(`npm/`)) return `npx electric-ax agents`;
 	}
 	return commandExample(resolveCommandName(argv));
 }
@@ -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);
@@ -311,7 +400,7 @@ Examples:
 function createElectricProgram({ env = getElectricCliEnv(), commandName = `electric`, commandPrefix = commandExample(commandName), handlers = createElectricCliHandlers(env, commandPrefix) } = {}) {
 	const program = new Command();
 	program.name(commandName).description(`Manage Electric tooling`).showHelpAfterError().showSuggestionAfterError().addHelpText(`after`, getHelpText(commandName));
-	const agentsCommand = program.command(`agent`).alias(`agents`).description(`Manage Electric Agents`);
+	const agentsCommand = program.command(`agents`).description(`Manage Electric Agents`);
 	const typesCommand = agentsCommand.command(`types`).description(`List entity types`).action(async () => {
 		await handlers.listTypes();
 	});
@@ -376,7 +465,7 @@ Setup (add to your shell init file):
   Fish:  ${commandName} --completion-fish | source    # add to config.fish
 
 Auto-install (detects your shell and updates init file):
-  ${commandName} agent completion install
+  ${commandName} agents completion install
 `).action((action) => {
 		if (action === `install`) {
 			try {
@@ -391,7 +480,7 @@ Auto-install (detects your shell and updates init file):
 		console.log(`Add to your shell init file:`);
 		console.log(`  Bash/Zsh:  eval "$(${commandName} --completion)"`);
 		console.log(`  Fish:      ${commandName} --completion-fish | source\n`);
-		console.log(`Or auto-install:  ${commandName} agent completion install`);
+		console.log(`Or auto-install:  ${commandName} agents completion install`);
 	});
 	completionCommand.alias(`completions`);
 	return program;

package/dist/init.cjs

@@ -35,7 +35,7 @@ async function initProject(projectName) {
 	console.log(`Get one at https://console.anthropic.com/settings/keys`);
 	console.log(``);
 	console.log(`Start infrastructure and run:`);
-	console.log(`  npx electric-ax agent quickstart  # in one terminal`);
+	console.log(`  npx electric-ax agents quickstart  # in one terminal`);
 	console.log(`  pnpm dev                          # in another terminal`);
 	console.log(``);
 }

package/dist/init.js

@@ -33,7 +33,7 @@ async function initProject(projectName) {
 	console.log(`Get one at https://console.anthropic.com/settings/keys`);
 	console.log(``);
 	console.log(`Start infrastructure and run:`);
-	console.log(`  npx electric-ax agent quickstart  # in one terminal`);
+	console.log(`  npx electric-ax agents quickstart  # in one terminal`);
 	console.log(`  pnpm dev                          # in another terminal`);
 	console.log(``);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electric-ax",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "CLI for Electric Agents",
   "author": "ElectricSQL team and contributors",
   "license": "Apache-2.0",
@@ -46,7 +46,7 @@
     "ink": "^6.8.0",
     "omelette": "^0.4.17",
     "react": "^19.2.0",
-    "@electric-ax/agents": "0.2.1",
+    "@electric-ax/agents": "0.2.2",
     "@electric-ax/agents-runtime": "0.1.1"
   },
   "devDependencies": {