electric-ax 0.1.0 → 0.1.2

package/dist/completions.d.cts

@@ -1,4 +1,4 @@
-import { ElectricCliEnv } from "./index-B6gIlecl.cjs";
+import { ElectricCliEnv } from "./index-CQaCUw1k.cjs";
 
 //#region src/completions.d.ts
 declare function fetchEntityTypeNames(env: ElectricCliEnv): Promise<Array<string>>;

package/dist/completions.d.ts

@@ -1,4 +1,4 @@
-import { ElectricCliEnv } from "./index-BJvlcIKL.js";
+import { ElectricCliEnv } from "./index-CrW6PmwB.js";
 
 //#region src/completions.d.ts
 declare function fetchEntityTypeNames(env: ElectricCliEnv): Promise<Array<string>>;

package/dist/{index-B6gIlecl.d.cts → index-CQaCUw1k.d.cts}

@@ -15,7 +15,30 @@ interface StartedBuiltinAgentsEnvironment {
   url: string;
   registeredBaseUrl: string;
   agentServerUrl: string;
-} //#endregion
+}
+interface WaitForServerOptions {
+  fetchImpl?: typeof globalThis.fetch;
+  timeoutMs?: number;
+  intervalMs?: number;
+}
+declare function readDotEnvFile(cwd?: string): Record<string, string>;
+declare function resolveAnthropicApiKey(options: StartBuiltinCommandOptions, env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): string;
+declare function resolveBuiltinAgentsPort(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): number;
+declare function resolveElectricAgentsPort(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): number;
+declare function getStartedEnvironmentMessage(started: StartedDevEnvironment): string;
+declare function getStoppedEnvironmentMessage(stopped: StoppedDevEnvironment): string;
+declare function getStartedBuiltinAgentsMessage(started: StartedBuiltinAgentsEnvironment): string;
+declare function resolveComposeProjectName(_cwd?: string, env?: NodeJS.ProcessEnv): string;
+declare function waitForElectricAgentsServer(baseUrl: string, options?: WaitForServerOptions): Promise<void>;
+declare function startElectricAgentsDevEnvironment(_options?: StartCommandOptions, env?: NodeJS.ProcessEnv, cwd?: string): Promise<StartedDevEnvironment>;
+declare function stopElectricAgentsDevEnvironment(options: StopCommandOptions, env?: NodeJS.ProcessEnv, cwd?: string): Promise<StoppedDevEnvironment>;
+declare function startBuiltinAgentsServer(options: StartBuiltinCommandOptions, params?: {
+  env?: NodeJS.ProcessEnv;
+  cwd?: string;
+  agentServerUrl?: string;
+}): Promise<StartedBuiltinAgentsEnvironment>;
+
+//#endregion
 //#region src/index.d.ts
 declare const DEFAULT_ELECTRIC_AGENTS_URL = "http://localhost:4437";
 interface ElectricCliEnv {
@@ -80,4 +103,4 @@ declare function createElectricProgram({
 declare function run(argv?: Array<string>): Promise<void>;
 
 //#endregion
-export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run };
+export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/{index-BJvlcIKL.d.ts → index-CrW6PmwB.d.ts}

@@ -15,7 +15,30 @@ interface StartedBuiltinAgentsEnvironment {
   url: string;
   registeredBaseUrl: string;
   agentServerUrl: string;
-} //#endregion
+}
+interface WaitForServerOptions {
+  fetchImpl?: typeof globalThis.fetch;
+  timeoutMs?: number;
+  intervalMs?: number;
+}
+declare function readDotEnvFile(cwd?: string): Record<string, string>;
+declare function resolveAnthropicApiKey(options: StartBuiltinCommandOptions, env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): string;
+declare function resolveBuiltinAgentsPort(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): number;
+declare function resolveElectricAgentsPort(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): number;
+declare function getStartedEnvironmentMessage(started: StartedDevEnvironment): string;
+declare function getStoppedEnvironmentMessage(stopped: StoppedDevEnvironment): string;
+declare function getStartedBuiltinAgentsMessage(started: StartedBuiltinAgentsEnvironment): string;
+declare function resolveComposeProjectName(_cwd?: string, env?: NodeJS.ProcessEnv): string;
+declare function waitForElectricAgentsServer(baseUrl: string, options?: WaitForServerOptions): Promise<void>;
+declare function startElectricAgentsDevEnvironment(_options?: StartCommandOptions, env?: NodeJS.ProcessEnv, cwd?: string): Promise<StartedDevEnvironment>;
+declare function stopElectricAgentsDevEnvironment(options: StopCommandOptions, env?: NodeJS.ProcessEnv, cwd?: string): Promise<StoppedDevEnvironment>;
+declare function startBuiltinAgentsServer(options: StartBuiltinCommandOptions, params?: {
+  env?: NodeJS.ProcessEnv;
+  cwd?: string;
+  agentServerUrl?: string;
+}): Promise<StartedBuiltinAgentsEnvironment>;
+
+//#endregion
 //#region src/index.d.ts
 declare const DEFAULT_ELECTRIC_AGENTS_URL = "http://localhost:4437";
 interface ElectricCliEnv {
@@ -80,4 +103,4 @@ declare function createElectricProgram({
 declare function run(argv?: Array<string>): Promise<void>;
 
 //#endregion
-export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run };
+export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/index.cjs

@@ -7,223 +7,7 @@ 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_child_process = require_chunk.__toESM(require("node:child_process"));
-const __electric_ax_agents = require_chunk.__toESM(require("@electric-ax/agents"));
 
-//#region src/start.ts
-const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
-const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
-const DOCKER_COMPOSE_FILE = (0, node_url.fileURLToPath)(new URL(`../docker-compose.full.yml`, require("url").pathToFileURL(__filename).href));
-function parseDotEnvValue(raw) {
-	const trimmed = raw.trim();
-	if (trimmed.startsWith(`"`) && trimmed.endsWith(`"`) || trimmed.startsWith(`'`) && trimmed.endsWith(`'`)) return trimmed.slice(1, -1);
-	const hashIndex = trimmed.indexOf(`#`);
-	return hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex).trim();
-}
-function readDotEnvFile(cwd = process.cwd()) {
-	const envPath = (0, node_path.resolve)(cwd, `.env`);
-	try {
-		const content = (0, node_fs.readFileSync)(envPath, `utf8`);
-		const values = {};
-		for (const line of content.split(/\r?\n/)) {
-			const trimmed = line.trim();
-			if (!trimmed || trimmed.startsWith(`#`)) continue;
-			const equalsIndex = trimmed.indexOf(`=`);
-			if (equalsIndex <= 0) continue;
-			const key = trimmed.slice(0, equalsIndex).trim();
-			const value = parseDotEnvValue(trimmed.slice(equalsIndex + 1));
-			values[key] = value;
-		}
-		return values;
-	} catch (error) {
-		if (error.code === `ENOENT`) return {};
-		throw error;
-	}
-}
-function resolveAnthropicApiKey(options, env = process.env, fileEnv = readDotEnvFile()) {
-	const candidate = options.anthropicApiKey?.trim() || env.ANTHROPIC_API_KEY?.trim() || fileEnv.ANTHROPIC_API_KEY?.trim();
-	if (!candidate) throw new Error(`ANTHROPIC_API_KEY is required. Pass --anthropic-api-key, export it in your shell, or set it in .env.`);
-	return candidate;
-}
-function resolveBuiltinAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
-	const raw = env.ELECTRIC_AGENTS_BUILTIN_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_BUILTIN_PORT?.trim();
-	const parsed = raw ? Number(raw) : DEFAULT_BUILTIN_AGENTS_PORT;
-	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_BUILTIN_PORT must be a positive integer`);
-	return parsed;
-}
-function resolveElectricAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
-	const raw = env.ELECTRIC_AGENTS_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_PORT?.trim();
-	const parsed = raw ? Number(raw) : DEFAULT_ELECTRIC_AGENTS_PORT;
-	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_PORT must be a positive integer`);
-	return parsed;
-}
-function getStartedEnvironmentMessage(started) {
-	return [
-		`Electric Agents dev environment is up.`,
-		`Server + UI: ${started.uiUrl}`,
-		`Docker project: ${started.composeProjectName}`
-	].join(`\n`);
-}
-function getStoppedEnvironmentMessage(stopped) {
-	return [
-		`Electric Agents dev environment is down.`,
-		`Docker project: ${stopped.composeProjectName}`,
-		stopped.removedVolumes ? `Volumes removed: yes` : `Volumes removed: no`
-	].join(`\n`);
-}
-function getStartedBuiltinAgentsMessage(started) {
-	return [
-		`Builtin Horton server is up.`,
-		`Webhook server: ${started.url}`,
-		`Registers with: ${started.agentServerUrl}`,
-		`Press Ctrl-C to stop.`
-	].join(`\n`);
-}
-function slugify(input) {
-	return input.toLowerCase().replace(/[^a-z0-9]+/g, `-`).replace(/^-+|-+$/g, ``);
-}
-function resolveComposeProjectName(cwd = process.cwd(), env = process.env) {
-	const explicit = env.ELECTRIC_AGENTS_COMPOSE_PROJECT?.trim();
-	if (explicit) return explicit;
-	const base = slugify((0, node_path.basename)(cwd)) || `workspace`;
-	return `electric-agents-${base}`;
-}
-async function runDockerCompose(args, env) {
-	await new Promise((resolve, reject) => {
-		const child = (0, node_child_process.spawn)(`docker`, args, {
-			cwd: process.cwd(),
-			env,
-			stdio: `inherit`
-		});
-		child.on(`error`, (error) => {
-			reject(new Error(`Failed to run docker compose: ${error instanceof Error ? error.message : String(error)}`));
-		});
-		child.on(`exit`, (code) => {
-			if (code === 0) {
-				resolve();
-				return;
-			}
-			reject(new Error(`docker compose exited with code ${code ?? `unknown`}`));
-		});
-	});
-}
-function delay(ms) {
-	return new Promise((resolve) => {
-		setTimeout(resolve, ms);
-	});
-}
-async function waitForElectricAgentsServer(baseUrl, options = {}) {
-	const fetchImpl = options.fetchImpl ?? globalThis.fetch;
-	const timeoutMs = options.timeoutMs ?? 6e4;
-	const intervalMs = options.intervalMs ?? 1e3;
-	const deadline = Date.now() + timeoutMs;
-	const healthUrl = `${baseUrl.replace(/\/$/, ``)}/_electric/health`;
-	let lastError = null;
-	while (Date.now() < deadline) {
-		try {
-			const response = await fetchImpl(healthUrl, { signal: AbortSignal.timeout(5e3) });
-			if (response.ok) return;
-			lastError = `healthcheck returned ${response.status}`;
-		} catch (error) {
-			lastError = error instanceof Error ? error.message : String(error);
-		}
-		await delay(intervalMs);
-	}
-	throw new Error(`Timed out waiting for Electric Agents server at ${healthUrl}${lastError ? `: ${lastError}` : ``}`);
-}
-async function startElectricAgentsDevEnvironment(_options = {}, env = process.env, cwd = process.cwd()) {
-	const fileEnv = readDotEnvFile(cwd);
-	const port = resolveElectricAgentsPort(env, fileEnv);
-	const composeProjectName = resolveComposeProjectName(cwd, env);
-	await runDockerCompose([
-		`compose`,
-		`-f`,
-		DOCKER_COMPOSE_FILE,
-		`up`,
-		`-d`
-	], {
-		...env,
-		COMPOSE_PROJECT_NAME: composeProjectName,
-		ELECTRIC_AGENTS_PORT: String(port)
-	});
-	const uiUrl = `http://localhost:${port}`;
-	await waitForElectricAgentsServer(uiUrl);
-	return {
-		port,
-		uiUrl,
-		composeProjectName
-	};
-}
-async function stopElectricAgentsDevEnvironment(options, env = process.env, cwd = process.cwd()) {
-	const composeProjectName = resolveComposeProjectName(cwd, env);
-	const args = [
-		`compose`,
-		`-f`,
-		DOCKER_COMPOSE_FILE,
-		`down`
-	];
-	if (options.removeVolumes) args.push(`--volumes`);
-	await runDockerCompose(args, {
-		...env,
-		COMPOSE_PROJECT_NAME: composeProjectName
-	});
-	return {
-		composeProjectName,
-		removedVolumes: options.removeVolumes ?? false
-	};
-}
-function waitForShutdown(stop, signalSource = process) {
-	return new Promise((resolve, reject) => {
-		let stopping = false;
-		const cleanup = () => {
-			signalSource.off(`SIGINT`, onSigint);
-			signalSource.off(`SIGTERM`, onSigterm);
-		};
-		const shutdown = (signal) => {
-			if (stopping) return;
-			stopping = true;
-			cleanup();
-			stop().then(resolve).catch((error) => {
-				reject(new Error(`Failed to stop builtin agents server after ${signal}: ${error instanceof Error ? error.message : String(error)}`));
-			});
-		};
-		const onSigint = () => {
-			shutdown(`SIGINT`);
-		};
-		const onSigterm = () => {
-			shutdown(`SIGTERM`);
-		};
-		signalSource.on(`SIGINT`, onSigint);
-		signalSource.on(`SIGTERM`, onSigterm);
-	});
-}
-async function startBuiltinAgentsServer(options, params = {}) {
-	const env = params.env ?? process.env;
-	const cwd = params.cwd ?? process.cwd();
-	const fileEnv = readDotEnvFile(cwd);
-	const anthropicApiKey = resolveAnthropicApiKey(options, env, fileEnv);
-	const port = resolveBuiltinAgentsPort(env, fileEnv);
-	const agentServerUrl = params.agentServerUrl ?? env.ELECTRIC_AGENTS_URL?.trim() ?? `http://localhost:${resolveElectricAgentsPort(env, fileEnv)}`;
-	process.env.ANTHROPIC_API_KEY = anthropicApiKey;
-	await waitForElectricAgentsServer(agentServerUrl);
-	const server = new __electric_ax_agents.BuiltinAgentsServer({
-		agentServerUrl,
-		port,
-		workingDirectory: cwd
-	});
-	await server.start();
-	const started = {
-		port,
-		url: server.url,
-		registeredBaseUrl: server.registeredBaseUrl,
-		agentServerUrl
-	};
-	console.log(getStartedBuiltinAgentsMessage(started));
-	await waitForShutdown(() => server.stop());
-	return started;
-}
-
-//#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
 var CliError = class extends Error {};
@@ -436,10 +220,23 @@ async function killEntity(env, url) {
 	console.log(`Killed ${url}`);
 }
 function printStartedEnvironment(env) {
-	console.log(getStartedEnvironmentMessage(env));
+	console.log([
+		`Electric Agents dev environment is up.`,
+		`Server + UI: ${env.uiUrl}`,
+		`Docker project: ${env.composeProjectName}`
+	].join(`\n`));
 }
 function printStoppedEnvironment(env) {
-	console.log(getStoppedEnvironmentMessage(env));
+	console.log([
+		`Electric Agents dev environment is down.`,
+		`Docker project: ${env.composeProjectName}`,
+		env.removedVolumes ? `Volumes removed: yes` : `Volumes removed: no`
+	].join(`\n`));
+}
+let startModulePromise = null;
+async function loadStartModule() {
+	startModulePromise ??= import(`./start.js`);
+	return startModulePromise;
 }
 function createElectricCliHandlers(env, commandPrefix = commandExample(`electric`)) {
 	return {
@@ -453,19 +250,23 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 		ps: (options) => listEntities(env, options),
 		kill: (url) => killEntity(env, url),
 		start: async (options) => {
+			const { startElectricAgentsDevEnvironment } = await loadStartModule();
 			const started = await startElectricAgentsDevEnvironment(options);
 			printStartedEnvironment(started);
 			return started;
 		},
 		startBuiltin: async (options) => {
+			const { startBuiltinAgentsServer } = await loadStartModule();
 			return startBuiltinAgentsServer(options, { agentServerUrl: env.electricAgentsUrl });
 		},
 		stop: async (options) => {
+			const { stopElectricAgentsDevEnvironment } = await loadStartModule();
 			const stopped = await stopElectricAgentsDevEnvironment(options);
 			printStoppedEnvironment(stopped);
 			return stopped;
 		},
 		quickstart: async (options) => {
+			const { startBuiltinAgentsServer, startElectricAgentsDevEnvironment } = await loadStartModule();
 			const started = await startElectricAgentsDevEnvironment();
 			printStartedEnvironment(started);
 			console.log(``);

package/dist/index.d.cts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run } from "./index-B6gIlecl.cjs";
+import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run } from "./index-CQaCUw1k.cjs";
 export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run };

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run } from "./index-BJvlcIKL.js";
+import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run } from "./index-CrW6PmwB.js";
 export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, getElectricCliEnv, resolveCommandPrefix, run };

package/dist/index.js

@@ -1,227 +1,11 @@
 #!/usr/bin/env node
 import { installCompletions, setupCompletions } from "./completions-BHILvHgZ.js";
-import { readFileSync, realpathSync } from "node:fs";
+import { realpathSync } 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 { spawn } from "node:child_process";
-import { BuiltinAgentsServer } from "@electric-ax/agents";
 
-//#region src/start.ts
-const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
-const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
-const DOCKER_COMPOSE_FILE = fileURLToPath(new URL(`../docker-compose.full.yml`, import.meta.url));
-function parseDotEnvValue(raw) {
-	const trimmed = raw.trim();
-	if (trimmed.startsWith(`"`) && trimmed.endsWith(`"`) || trimmed.startsWith(`'`) && trimmed.endsWith(`'`)) return trimmed.slice(1, -1);
-	const hashIndex = trimmed.indexOf(`#`);
-	return hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex).trim();
-}
-function readDotEnvFile(cwd = process.cwd()) {
-	const envPath = resolve(cwd, `.env`);
-	try {
-		const content = readFileSync(envPath, `utf8`);
-		const values = {};
-		for (const line of content.split(/\r?\n/)) {
-			const trimmed = line.trim();
-			if (!trimmed || trimmed.startsWith(`#`)) continue;
-			const equalsIndex = trimmed.indexOf(`=`);
-			if (equalsIndex <= 0) continue;
-			const key = trimmed.slice(0, equalsIndex).trim();
-			const value = parseDotEnvValue(trimmed.slice(equalsIndex + 1));
-			values[key] = value;
-		}
-		return values;
-	} catch (error) {
-		if (error.code === `ENOENT`) return {};
-		throw error;
-	}
-}
-function resolveAnthropicApiKey(options, env = process.env, fileEnv = readDotEnvFile()) {
-	const candidate = options.anthropicApiKey?.trim() || env.ANTHROPIC_API_KEY?.trim() || fileEnv.ANTHROPIC_API_KEY?.trim();
-	if (!candidate) throw new Error(`ANTHROPIC_API_KEY is required. Pass --anthropic-api-key, export it in your shell, or set it in .env.`);
-	return candidate;
-}
-function resolveBuiltinAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
-	const raw = env.ELECTRIC_AGENTS_BUILTIN_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_BUILTIN_PORT?.trim();
-	const parsed = raw ? Number(raw) : DEFAULT_BUILTIN_AGENTS_PORT;
-	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_BUILTIN_PORT must be a positive integer`);
-	return parsed;
-}
-function resolveElectricAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
-	const raw = env.ELECTRIC_AGENTS_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_PORT?.trim();
-	const parsed = raw ? Number(raw) : DEFAULT_ELECTRIC_AGENTS_PORT;
-	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_PORT must be a positive integer`);
-	return parsed;
-}
-function getStartedEnvironmentMessage(started) {
-	return [
-		`Electric Agents dev environment is up.`,
-		`Server + UI: ${started.uiUrl}`,
-		`Docker project: ${started.composeProjectName}`
-	].join(`\n`);
-}
-function getStoppedEnvironmentMessage(stopped) {
-	return [
-		`Electric Agents dev environment is down.`,
-		`Docker project: ${stopped.composeProjectName}`,
-		stopped.removedVolumes ? `Volumes removed: yes` : `Volumes removed: no`
-	].join(`\n`);
-}
-function getStartedBuiltinAgentsMessage(started) {
-	return [
-		`Builtin Horton server is up.`,
-		`Webhook server: ${started.url}`,
-		`Registers with: ${started.agentServerUrl}`,
-		`Press Ctrl-C to stop.`
-	].join(`\n`);
-}
-function slugify(input) {
-	return input.toLowerCase().replace(/[^a-z0-9]+/g, `-`).replace(/^-+|-+$/g, ``);
-}
-function resolveComposeProjectName(cwd = process.cwd(), env = process.env) {
-	const explicit = env.ELECTRIC_AGENTS_COMPOSE_PROJECT?.trim();
-	if (explicit) return explicit;
-	const base = slugify(basename(cwd)) || `workspace`;
-	return `electric-agents-${base}`;
-}
-async function runDockerCompose(args, env) {
-	await new Promise((resolve$1, reject) => {
-		const child = spawn(`docker`, args, {
-			cwd: process.cwd(),
-			env,
-			stdio: `inherit`
-		});
-		child.on(`error`, (error) => {
-			reject(new Error(`Failed to run docker compose: ${error instanceof Error ? error.message : String(error)}`));
-		});
-		child.on(`exit`, (code) => {
-			if (code === 0) {
-				resolve$1();
-				return;
-			}
-			reject(new Error(`docker compose exited with code ${code ?? `unknown`}`));
-		});
-	});
-}
-function delay(ms) {
-	return new Promise((resolve$1) => {
-		setTimeout(resolve$1, ms);
-	});
-}
-async function waitForElectricAgentsServer(baseUrl, options = {}) {
-	const fetchImpl = options.fetchImpl ?? globalThis.fetch;
-	const timeoutMs = options.timeoutMs ?? 6e4;
-	const intervalMs = options.intervalMs ?? 1e3;
-	const deadline = Date.now() + timeoutMs;
-	const healthUrl = `${baseUrl.replace(/\/$/, ``)}/_electric/health`;
-	let lastError = null;
-	while (Date.now() < deadline) {
-		try {
-			const response = await fetchImpl(healthUrl, { signal: AbortSignal.timeout(5e3) });
-			if (response.ok) return;
-			lastError = `healthcheck returned ${response.status}`;
-		} catch (error) {
-			lastError = error instanceof Error ? error.message : String(error);
-		}
-		await delay(intervalMs);
-	}
-	throw new Error(`Timed out waiting for Electric Agents server at ${healthUrl}${lastError ? `: ${lastError}` : ``}`);
-}
-async function startElectricAgentsDevEnvironment(_options = {}, env = process.env, cwd = process.cwd()) {
-	const fileEnv = readDotEnvFile(cwd);
-	const port = resolveElectricAgentsPort(env, fileEnv);
-	const composeProjectName = resolveComposeProjectName(cwd, env);
-	await runDockerCompose([
-		`compose`,
-		`-f`,
-		DOCKER_COMPOSE_FILE,
-		`up`,
-		`-d`
-	], {
-		...env,
-		COMPOSE_PROJECT_NAME: composeProjectName,
-		ELECTRIC_AGENTS_PORT: String(port)
-	});
-	const uiUrl = `http://localhost:${port}`;
-	await waitForElectricAgentsServer(uiUrl);
-	return {
-		port,
-		uiUrl,
-		composeProjectName
-	};
-}
-async function stopElectricAgentsDevEnvironment(options, env = process.env, cwd = process.cwd()) {
-	const composeProjectName = resolveComposeProjectName(cwd, env);
-	const args = [
-		`compose`,
-		`-f`,
-		DOCKER_COMPOSE_FILE,
-		`down`
-	];
-	if (options.removeVolumes) args.push(`--volumes`);
-	await runDockerCompose(args, {
-		...env,
-		COMPOSE_PROJECT_NAME: composeProjectName
-	});
-	return {
-		composeProjectName,
-		removedVolumes: options.removeVolumes ?? false
-	};
-}
-function waitForShutdown(stop, signalSource = process) {
-	return new Promise((resolve$1, reject) => {
-		let stopping = false;
-		const cleanup = () => {
-			signalSource.off(`SIGINT`, onSigint);
-			signalSource.off(`SIGTERM`, onSigterm);
-		};
-		const shutdown = (signal) => {
-			if (stopping) return;
-			stopping = true;
-			cleanup();
-			stop().then(resolve$1).catch((error) => {
-				reject(new Error(`Failed to stop builtin agents server after ${signal}: ${error instanceof Error ? error.message : String(error)}`));
-			});
-		};
-		const onSigint = () => {
-			shutdown(`SIGINT`);
-		};
-		const onSigterm = () => {
-			shutdown(`SIGTERM`);
-		};
-		signalSource.on(`SIGINT`, onSigint);
-		signalSource.on(`SIGTERM`, onSigterm);
-	});
-}
-async function startBuiltinAgentsServer(options, params = {}) {
-	const env = params.env ?? process.env;
-	const cwd = params.cwd ?? process.cwd();
-	const fileEnv = readDotEnvFile(cwd);
-	const anthropicApiKey = resolveAnthropicApiKey(options, env, fileEnv);
-	const port = resolveBuiltinAgentsPort(env, fileEnv);
-	const agentServerUrl = params.agentServerUrl ?? env.ELECTRIC_AGENTS_URL?.trim() ?? `http://localhost:${resolveElectricAgentsPort(env, fileEnv)}`;
-	process.env.ANTHROPIC_API_KEY = anthropicApiKey;
-	await waitForElectricAgentsServer(agentServerUrl);
-	const server = new BuiltinAgentsServer({
-		agentServerUrl,
-		port,
-		workingDirectory: cwd
-	});
-	await server.start();
-	const started = {
-		port,
-		url: server.url,
-		registeredBaseUrl: server.registeredBaseUrl,
-		agentServerUrl
-	};
-	console.log(getStartedBuiltinAgentsMessage(started));
-	await waitForShutdown(() => server.stop());
-	return started;
-}
-
-//#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
 var CliError = class extends Error {};
@@ -434,10 +218,23 @@ async function killEntity(env, url) {
 	console.log(`Killed ${url}`);
 }
 function printStartedEnvironment(env) {
-	console.log(getStartedEnvironmentMessage(env));
+	console.log([
+		`Electric Agents dev environment is up.`,
+		`Server + UI: ${env.uiUrl}`,
+		`Docker project: ${env.composeProjectName}`
+	].join(`\n`));
 }
 function printStoppedEnvironment(env) {
-	console.log(getStoppedEnvironmentMessage(env));
+	console.log([
+		`Electric Agents dev environment is down.`,
+		`Docker project: ${env.composeProjectName}`,
+		env.removedVolumes ? `Volumes removed: yes` : `Volumes removed: no`
+	].join(`\n`));
+}
+let startModulePromise = null;
+async function loadStartModule() {
+	startModulePromise ??= import(`./start.js`);
+	return startModulePromise;
 }
 function createElectricCliHandlers(env, commandPrefix = commandExample(`electric`)) {
 	return {
@@ -451,19 +248,23 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 		ps: (options) => listEntities(env, options),
 		kill: (url) => killEntity(env, url),
 		start: async (options) => {
+			const { startElectricAgentsDevEnvironment } = await loadStartModule();
 			const started = await startElectricAgentsDevEnvironment(options);
 			printStartedEnvironment(started);
 			return started;
 		},
 		startBuiltin: async (options) => {
+			const { startBuiltinAgentsServer } = await loadStartModule();
 			return startBuiltinAgentsServer(options, { agentServerUrl: env.electricAgentsUrl });
 		},
 		stop: async (options) => {
+			const { stopElectricAgentsDevEnvironment } = await loadStartModule();
 			const stopped = await stopElectricAgentsDevEnvironment(options);
 			printStoppedEnvironment(stopped);
 			return stopped;
 		},
 		quickstart: async (options) => {
+			const { startBuiltinAgentsServer, startElectricAgentsDevEnvironment } = await loadStartModule();
 			const started = await startElectricAgentsDevEnvironment();
 			printStartedEnvironment(started);
 			console.log(``);

package/dist/start.cjs

@@ -0,0 +1,231 @@
+"use strict";
+const require_chunk = require('./chunk-BCwAaXi7.cjs');
+const node_fs = require_chunk.__toESM(require("node:fs"));
+const node_path = require_chunk.__toESM(require("node:path"));
+const node_url = require_chunk.__toESM(require("node:url"));
+const node_child_process = require_chunk.__toESM(require("node:child_process"));
+const __electric_ax_agents = require_chunk.__toESM(require("@electric-ax/agents"));
+
+//#region src/start.ts
+const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
+const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
+const DEFAULT_COMPOSE_PROJECT_NAME = `electric-agents`;
+const DOCKER_COMPOSE_FILE = (0, node_url.fileURLToPath)(new URL(`../docker-compose.full.yml`, require("url").pathToFileURL(__filename).href));
+function parseDotEnvValue(raw) {
+	const trimmed = raw.trim();
+	if (trimmed.startsWith(`"`) && trimmed.endsWith(`"`) || trimmed.startsWith(`'`) && trimmed.endsWith(`'`)) return trimmed.slice(1, -1);
+	const hashIndex = trimmed.indexOf(`#`);
+	return hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex).trim();
+}
+function readDotEnvFile(cwd = process.cwd()) {
+	const envPath = (0, node_path.resolve)(cwd, `.env`);
+	try {
+		const content = (0, node_fs.readFileSync)(envPath, `utf8`);
+		const values = {};
+		for (const line of content.split(/\r?\n/)) {
+			const trimmed = line.trim();
+			if (!trimmed || trimmed.startsWith(`#`)) continue;
+			const equalsIndex = trimmed.indexOf(`=`);
+			if (equalsIndex <= 0) continue;
+			const key = trimmed.slice(0, equalsIndex).trim();
+			const value = parseDotEnvValue(trimmed.slice(equalsIndex + 1));
+			values[key] = value;
+		}
+		return values;
+	} catch (error) {
+		if (error.code === `ENOENT`) return {};
+		throw error;
+	}
+}
+function resolveAnthropicApiKey(options, env = process.env, fileEnv = readDotEnvFile()) {
+	const candidate = options.anthropicApiKey?.trim() || env.ANTHROPIC_API_KEY?.trim() || fileEnv.ANTHROPIC_API_KEY?.trim();
+	if (!candidate) throw new Error(`ANTHROPIC_API_KEY is required. Pass --anthropic-api-key, export it in your shell, or set it in .env.`);
+	return candidate;
+}
+function resolveBuiltinAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
+	const raw = env.ELECTRIC_AGENTS_BUILTIN_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_BUILTIN_PORT?.trim();
+	const parsed = raw ? Number(raw) : DEFAULT_BUILTIN_AGENTS_PORT;
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_BUILTIN_PORT must be a positive integer`);
+	return parsed;
+}
+function resolveElectricAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
+	const raw = env.ELECTRIC_AGENTS_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_PORT?.trim();
+	const parsed = raw ? Number(raw) : DEFAULT_ELECTRIC_AGENTS_PORT;
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_PORT must be a positive integer`);
+	return parsed;
+}
+function getStartedEnvironmentMessage(started) {
+	return [
+		`Electric Agents dev environment is up.`,
+		`Server + UI: ${started.uiUrl}`,
+		`Docker project: ${started.composeProjectName}`
+	].join(`\n`);
+}
+function getStoppedEnvironmentMessage(stopped) {
+	return [
+		`Electric Agents dev environment is down.`,
+		`Docker project: ${stopped.composeProjectName}`,
+		stopped.removedVolumes ? `Volumes removed: yes` : `Volumes removed: no`
+	].join(`\n`);
+}
+function getStartedBuiltinAgentsMessage(started) {
+	return [
+		`Builtin Horton server is up.`,
+		`Webhook server: ${started.url}`,
+		`Registers with: ${started.agentServerUrl}`,
+		`Press Ctrl-C to stop.`
+	].join(`\n`);
+}
+function resolveComposeProjectName(_cwd = process.cwd(), env = process.env) {
+	const explicit = env.ELECTRIC_AGENTS_COMPOSE_PROJECT?.trim();
+	if (explicit) return explicit;
+	return DEFAULT_COMPOSE_PROJECT_NAME;
+}
+async function runDockerCompose(args, env) {
+	await new Promise((resolve, reject) => {
+		const child = (0, node_child_process.spawn)(`docker`, args, {
+			cwd: process.cwd(),
+			env,
+			stdio: `inherit`
+		});
+		child.on(`error`, (error) => {
+			reject(new Error(`Failed to run docker compose: ${error instanceof Error ? error.message : String(error)}`));
+		});
+		child.on(`exit`, (code) => {
+			if (code === 0) {
+				resolve();
+				return;
+			}
+			reject(new Error(`docker compose exited with code ${code ?? `unknown`}`));
+		});
+	});
+}
+function delay(ms) {
+	return new Promise((resolve) => {
+		setTimeout(resolve, ms);
+	});
+}
+async function waitForElectricAgentsServer(baseUrl, options = {}) {
+	const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+	const timeoutMs = options.timeoutMs ?? 6e4;
+	const intervalMs = options.intervalMs ?? 1e3;
+	const deadline = Date.now() + timeoutMs;
+	const healthUrl = `${baseUrl.replace(/\/$/, ``)}/_electric/health`;
+	let lastError = null;
+	while (Date.now() < deadline) {
+		try {
+			const response = await fetchImpl(healthUrl, { signal: AbortSignal.timeout(5e3) });
+			if (response.ok) return;
+			lastError = `healthcheck returned ${response.status}`;
+		} catch (error) {
+			lastError = error instanceof Error ? error.message : String(error);
+		}
+		await delay(intervalMs);
+	}
+	throw new Error(`Timed out waiting for Electric Agents server at ${healthUrl}${lastError ? `: ${lastError}` : ``}`);
+}
+async function startElectricAgentsDevEnvironment(_options = {}, env = process.env, cwd = process.cwd()) {
+	const fileEnv = readDotEnvFile(cwd);
+	const port = resolveElectricAgentsPort(env, fileEnv);
+	const composeProjectName = resolveComposeProjectName(cwd, env);
+	await runDockerCompose([
+		`compose`,
+		`-f`,
+		DOCKER_COMPOSE_FILE,
+		`up`,
+		`-d`
+	], {
+		...env,
+		COMPOSE_PROJECT_NAME: composeProjectName,
+		ELECTRIC_AGENTS_PORT: String(port)
+	});
+	const uiUrl = `http://localhost:${port}`;
+	await waitForElectricAgentsServer(uiUrl);
+	return {
+		port,
+		uiUrl,
+		composeProjectName
+	};
+}
+async function stopElectricAgentsDevEnvironment(options, env = process.env, cwd = process.cwd()) {
+	const composeProjectName = resolveComposeProjectName(cwd, env);
+	const args = [
+		`compose`,
+		`-f`,
+		DOCKER_COMPOSE_FILE,
+		`down`
+	];
+	if (options.removeVolumes) args.push(`--volumes`);
+	await runDockerCompose(args, {
+		...env,
+		COMPOSE_PROJECT_NAME: composeProjectName
+	});
+	return {
+		composeProjectName,
+		removedVolumes: options.removeVolumes ?? false
+	};
+}
+function waitForShutdown(stop, signalSource = process) {
+	return new Promise((resolve, reject) => {
+		let stopping = false;
+		const cleanup = () => {
+			signalSource.off(`SIGINT`, onSigint);
+			signalSource.off(`SIGTERM`, onSigterm);
+		};
+		const shutdown = (signal) => {
+			if (stopping) return;
+			stopping = true;
+			cleanup();
+			stop().then(resolve).catch((error) => {
+				reject(new Error(`Failed to stop builtin agents server after ${signal}: ${error instanceof Error ? error.message : String(error)}`));
+			});
+		};
+		const onSigint = () => {
+			shutdown(`SIGINT`);
+		};
+		const onSigterm = () => {
+			shutdown(`SIGTERM`);
+		};
+		signalSource.on(`SIGINT`, onSigint);
+		signalSource.on(`SIGTERM`, onSigterm);
+	});
+}
+async function startBuiltinAgentsServer(options, params = {}) {
+	const env = params.env ?? process.env;
+	const cwd = params.cwd ?? process.cwd();
+	const fileEnv = readDotEnvFile(cwd);
+	const anthropicApiKey = resolveAnthropicApiKey(options, env, fileEnv);
+	const port = resolveBuiltinAgentsPort(env, fileEnv);
+	const agentServerUrl = params.agentServerUrl ?? env.ELECTRIC_AGENTS_URL?.trim() ?? `http://localhost:${resolveElectricAgentsPort(env, fileEnv)}`;
+	process.env.ANTHROPIC_API_KEY = anthropicApiKey;
+	await waitForElectricAgentsServer(agentServerUrl);
+	const server = new __electric_ax_agents.BuiltinAgentsServer({
+		agentServerUrl,
+		port,
+		workingDirectory: cwd
+	});
+	await server.start();
+	const started = {
+		port,
+		url: server.url,
+		registeredBaseUrl: server.registeredBaseUrl,
+		agentServerUrl
+	};
+	console.log(getStartedBuiltinAgentsMessage(started));
+	await waitForShutdown(() => server.stop());
+	return started;
+}
+
+//#endregion
+exports.getStartedBuiltinAgentsMessage = getStartedBuiltinAgentsMessage
+exports.getStartedEnvironmentMessage = getStartedEnvironmentMessage
+exports.getStoppedEnvironmentMessage = getStoppedEnvironmentMessage
+exports.readDotEnvFile = readDotEnvFile
+exports.resolveAnthropicApiKey = resolveAnthropicApiKey
+exports.resolveBuiltinAgentsPort = resolveBuiltinAgentsPort
+exports.resolveComposeProjectName = resolveComposeProjectName
+exports.resolveElectricAgentsPort = resolveElectricAgentsPort
+exports.startBuiltinAgentsServer = startBuiltinAgentsServer
+exports.startElectricAgentsDevEnvironment = startElectricAgentsDevEnvironment
+exports.stopElectricAgentsDevEnvironment = stopElectricAgentsDevEnvironment
+exports.waitForElectricAgentsServer = waitForElectricAgentsServer

package/dist/start.d.cts

@@ -0,0 +1,2 @@
+import { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveComposeProjectName, resolveElectricAgentsPort, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer } from "./index-CQaCUw1k.cjs";
+export { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveComposeProjectName, resolveElectricAgentsPort, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/start.d.ts

@@ -0,0 +1,2 @@
+import { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveComposeProjectName, resolveElectricAgentsPort, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer } from "./index-CrW6PmwB.js";
+export { StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StoppedDevEnvironment, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveComposeProjectName, resolveElectricAgentsPort, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/start.js

@@ -0,0 +1,218 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { BuiltinAgentsServer } from "@electric-ax/agents";
+
+//#region src/start.ts
+const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
+const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
+const DEFAULT_COMPOSE_PROJECT_NAME = `electric-agents`;
+const DOCKER_COMPOSE_FILE = fileURLToPath(new URL(`../docker-compose.full.yml`, import.meta.url));
+function parseDotEnvValue(raw) {
+	const trimmed = raw.trim();
+	if (trimmed.startsWith(`"`) && trimmed.endsWith(`"`) || trimmed.startsWith(`'`) && trimmed.endsWith(`'`)) return trimmed.slice(1, -1);
+	const hashIndex = trimmed.indexOf(`#`);
+	return hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex).trim();
+}
+function readDotEnvFile(cwd = process.cwd()) {
+	const envPath = resolve(cwd, `.env`);
+	try {
+		const content = readFileSync(envPath, `utf8`);
+		const values = {};
+		for (const line of content.split(/\r?\n/)) {
+			const trimmed = line.trim();
+			if (!trimmed || trimmed.startsWith(`#`)) continue;
+			const equalsIndex = trimmed.indexOf(`=`);
+			if (equalsIndex <= 0) continue;
+			const key = trimmed.slice(0, equalsIndex).trim();
+			const value = parseDotEnvValue(trimmed.slice(equalsIndex + 1));
+			values[key] = value;
+		}
+		return values;
+	} catch (error) {
+		if (error.code === `ENOENT`) return {};
+		throw error;
+	}
+}
+function resolveAnthropicApiKey(options, env = process.env, fileEnv = readDotEnvFile()) {
+	const candidate = options.anthropicApiKey?.trim() || env.ANTHROPIC_API_KEY?.trim() || fileEnv.ANTHROPIC_API_KEY?.trim();
+	if (!candidate) throw new Error(`ANTHROPIC_API_KEY is required. Pass --anthropic-api-key, export it in your shell, or set it in .env.`);
+	return candidate;
+}
+function resolveBuiltinAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
+	const raw = env.ELECTRIC_AGENTS_BUILTIN_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_BUILTIN_PORT?.trim();
+	const parsed = raw ? Number(raw) : DEFAULT_BUILTIN_AGENTS_PORT;
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_BUILTIN_PORT must be a positive integer`);
+	return parsed;
+}
+function resolveElectricAgentsPort(env = process.env, fileEnv = readDotEnvFile()) {
+	const raw = env.ELECTRIC_AGENTS_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_PORT?.trim();
+	const parsed = raw ? Number(raw) : DEFAULT_ELECTRIC_AGENTS_PORT;
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`ELECTRIC_AGENTS_PORT must be a positive integer`);
+	return parsed;
+}
+function getStartedEnvironmentMessage(started) {
+	return [
+		`Electric Agents dev environment is up.`,
+		`Server + UI: ${started.uiUrl}`,
+		`Docker project: ${started.composeProjectName}`
+	].join(`\n`);
+}
+function getStoppedEnvironmentMessage(stopped) {
+	return [
+		`Electric Agents dev environment is down.`,
+		`Docker project: ${stopped.composeProjectName}`,
+		stopped.removedVolumes ? `Volumes removed: yes` : `Volumes removed: no`
+	].join(`\n`);
+}
+function getStartedBuiltinAgentsMessage(started) {
+	return [
+		`Builtin Horton server is up.`,
+		`Webhook server: ${started.url}`,
+		`Registers with: ${started.agentServerUrl}`,
+		`Press Ctrl-C to stop.`
+	].join(`\n`);
+}
+function resolveComposeProjectName(_cwd = process.cwd(), env = process.env) {
+	const explicit = env.ELECTRIC_AGENTS_COMPOSE_PROJECT?.trim();
+	if (explicit) return explicit;
+	return DEFAULT_COMPOSE_PROJECT_NAME;
+}
+async function runDockerCompose(args, env) {
+	await new Promise((resolve$1, reject) => {
+		const child = spawn(`docker`, args, {
+			cwd: process.cwd(),
+			env,
+			stdio: `inherit`
+		});
+		child.on(`error`, (error) => {
+			reject(new Error(`Failed to run docker compose: ${error instanceof Error ? error.message : String(error)}`));
+		});
+		child.on(`exit`, (code) => {
+			if (code === 0) {
+				resolve$1();
+				return;
+			}
+			reject(new Error(`docker compose exited with code ${code ?? `unknown`}`));
+		});
+	});
+}
+function delay(ms) {
+	return new Promise((resolve$1) => {
+		setTimeout(resolve$1, ms);
+	});
+}
+async function waitForElectricAgentsServer(baseUrl, options = {}) {
+	const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+	const timeoutMs = options.timeoutMs ?? 6e4;
+	const intervalMs = options.intervalMs ?? 1e3;
+	const deadline = Date.now() + timeoutMs;
+	const healthUrl = `${baseUrl.replace(/\/$/, ``)}/_electric/health`;
+	let lastError = null;
+	while (Date.now() < deadline) {
+		try {
+			const response = await fetchImpl(healthUrl, { signal: AbortSignal.timeout(5e3) });
+			if (response.ok) return;
+			lastError = `healthcheck returned ${response.status}`;
+		} catch (error) {
+			lastError = error instanceof Error ? error.message : String(error);
+		}
+		await delay(intervalMs);
+	}
+	throw new Error(`Timed out waiting for Electric Agents server at ${healthUrl}${lastError ? `: ${lastError}` : ``}`);
+}
+async function startElectricAgentsDevEnvironment(_options = {}, env = process.env, cwd = process.cwd()) {
+	const fileEnv = readDotEnvFile(cwd);
+	const port = resolveElectricAgentsPort(env, fileEnv);
+	const composeProjectName = resolveComposeProjectName(cwd, env);
+	await runDockerCompose([
+		`compose`,
+		`-f`,
+		DOCKER_COMPOSE_FILE,
+		`up`,
+		`-d`
+	], {
+		...env,
+		COMPOSE_PROJECT_NAME: composeProjectName,
+		ELECTRIC_AGENTS_PORT: String(port)
+	});
+	const uiUrl = `http://localhost:${port}`;
+	await waitForElectricAgentsServer(uiUrl);
+	return {
+		port,
+		uiUrl,
+		composeProjectName
+	};
+}
+async function stopElectricAgentsDevEnvironment(options, env = process.env, cwd = process.cwd()) {
+	const composeProjectName = resolveComposeProjectName(cwd, env);
+	const args = [
+		`compose`,
+		`-f`,
+		DOCKER_COMPOSE_FILE,
+		`down`
+	];
+	if (options.removeVolumes) args.push(`--volumes`);
+	await runDockerCompose(args, {
+		...env,
+		COMPOSE_PROJECT_NAME: composeProjectName
+	});
+	return {
+		composeProjectName,
+		removedVolumes: options.removeVolumes ?? false
+	};
+}
+function waitForShutdown(stop, signalSource = process) {
+	return new Promise((resolve$1, reject) => {
+		let stopping = false;
+		const cleanup = () => {
+			signalSource.off(`SIGINT`, onSigint);
+			signalSource.off(`SIGTERM`, onSigterm);
+		};
+		const shutdown = (signal) => {
+			if (stopping) return;
+			stopping = true;
+			cleanup();
+			stop().then(resolve$1).catch((error) => {
+				reject(new Error(`Failed to stop builtin agents server after ${signal}: ${error instanceof Error ? error.message : String(error)}`));
+			});
+		};
+		const onSigint = () => {
+			shutdown(`SIGINT`);
+		};
+		const onSigterm = () => {
+			shutdown(`SIGTERM`);
+		};
+		signalSource.on(`SIGINT`, onSigint);
+		signalSource.on(`SIGTERM`, onSigterm);
+	});
+}
+async function startBuiltinAgentsServer(options, params = {}) {
+	const env = params.env ?? process.env;
+	const cwd = params.cwd ?? process.cwd();
+	const fileEnv = readDotEnvFile(cwd);
+	const anthropicApiKey = resolveAnthropicApiKey(options, env, fileEnv);
+	const port = resolveBuiltinAgentsPort(env, fileEnv);
+	const agentServerUrl = params.agentServerUrl ?? env.ELECTRIC_AGENTS_URL?.trim() ?? `http://localhost:${resolveElectricAgentsPort(env, fileEnv)}`;
+	process.env.ANTHROPIC_API_KEY = anthropicApiKey;
+	await waitForElectricAgentsServer(agentServerUrl);
+	const server = new BuiltinAgentsServer({
+		agentServerUrl,
+		port,
+		workingDirectory: cwd
+	});
+	await server.start();
+	const started = {
+		port,
+		url: server.url,
+		registeredBaseUrl: server.registeredBaseUrl,
+		agentServerUrl
+	};
+	console.log(getStartedBuiltinAgentsMessage(started));
+	await waitForShutdown(() => server.stop());
+	return started;
+}
+
+//#endregion
+export { getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveBuiltinAgentsPort, resolveComposeProjectName, resolveElectricAgentsPort, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/types-table.cjs

@@ -0,0 +1,67 @@
+"use strict";
+const require_chunk = require('./chunk-BCwAaXi7.cjs');
+const react = require_chunk.__toESM(require("react"));
+const ink = require_chunk.__toESM(require("ink"));
+const react_jsx_runtime = require_chunk.__toESM(require("react/jsx-runtime"));
+
+//#region src/types-table.tsx
+function TypesTable({ types }) {
+	const groups = new Map();
+	for (const t of types) {
+		const server = t.serve_endpoint ?? `built-in`;
+		if (!groups.has(server)) groups.set(server, []);
+		groups.get(server).push(t);
+	}
+	const entries = Array.from(groups.entries());
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
+		flexDirection: "column",
+		children: entries.map(([server, serverTypes], i) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, {
+			flexDirection: "column",
+			marginTop: i > 0 ? 1 : 0,
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+					bold: true,
+					dimColor: true,
+					children: server === `built-in` ? `Built-in agents` : server
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
+					width: 25,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+						bold: true,
+						children: "NAME"
+					})
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+					bold: true,
+					children: "DESCRIPTION"
+				})] }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
+					width: 25,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+						dimColor: true,
+						children: `─`.repeat(23)
+					})
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+					dimColor: true,
+					children: `─`.repeat(40)
+				})] }),
+				serverTypes.map((t) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
+					width: 25,
+					flexShrink: 0,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, { children: t.name })
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
+					flexGrow: 1,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+						wrap: "wrap",
+						children: t.description
+					})
+				})] }, t.name))
+			]
+		}, server))
+	});
+}
+function renderTypesTable(types) {
+	console.log((0, ink.renderToString)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TypesTable, { types })));
+}
+
+//#endregion
+exports.renderTypesTable = renderTypesTable

package/dist/types-table.d.cts

@@ -0,0 +1,10 @@
+//#region src/types-table.d.ts
+interface EntityType {
+  name: string;
+  description: string;
+  serve_endpoint?: string;
+}
+declare function renderTypesTable(types: Array<EntityType>): void;
+
+//#endregion
+export { renderTypesTable };

package/dist/types-table.d.ts

@@ -0,0 +1,10 @@
+//#region src/types-table.d.ts
+interface EntityType {
+  name: string;
+  description: string;
+  serve_endpoint?: string;
+}
+declare function renderTypesTable(types: Array<EntityType>): void;
+
+//#endregion
+export { renderTypesTable };

package/dist/types-table.js

@@ -0,0 +1,65 @@
+import React from "react";
+import { Box, Text, renderToString } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/types-table.tsx
+function TypesTable({ types }) {
+	const groups = new Map();
+	for (const t of types) {
+		const server = t.serve_endpoint ?? `built-in`;
+		if (!groups.has(server)) groups.set(server, []);
+		groups.get(server).push(t);
+	}
+	const entries = Array.from(groups.entries());
+	return /* @__PURE__ */ jsx(Box, {
+		flexDirection: "column",
+		children: entries.map(([server, serverTypes], i) => /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			marginTop: i > 0 ? 1 : 0,
+			children: [
+				/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					dimColor: true,
+					children: server === `built-in` ? `Built-in agents` : server
+				}),
+				/* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Box, {
+					width: 25,
+					children: /* @__PURE__ */ jsx(Text, {
+						bold: true,
+						children: "NAME"
+					})
+				}), /* @__PURE__ */ jsx(Text, {
+					bold: true,
+					children: "DESCRIPTION"
+				})] }),
+				/* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Box, {
+					width: 25,
+					children: /* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: `─`.repeat(23)
+					})
+				}), /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: `─`.repeat(40)
+				})] }),
+				serverTypes.map((t) => /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(Box, {
+					width: 25,
+					flexShrink: 0,
+					children: /* @__PURE__ */ jsx(Text, { children: t.name })
+				}), /* @__PURE__ */ jsx(Box, {
+					flexGrow: 1,
+					children: /* @__PURE__ */ jsx(Text, {
+						wrap: "wrap",
+						children: t.description
+					})
+				})] }, t.name))
+			]
+		}, server))
+	});
+}
+function renderTypesTable(types) {
+	console.log(renderToString(/* @__PURE__ */ jsx(TypesTable, { types })));
+}
+
+//#endregion
+export { renderTypesTable };

package/package.json

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