electric-ax 0.1.1 → 0.1.3

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.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/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/docker-compose.full.yml

@@ -24,7 +24,7 @@ services:
       timeout: 5s
       retries: 30
     volumes:
-      - electric-agents-postgres-data:/var/lib/postgresql/data
+      - electric-agents-postgres-data:/var/lib/postgresql
 
   electric:
     image: electricsql/electric:latest

package/package.json

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