electric-ax 0.1.10 → 0.1.12

package/dist/{completions-BHILvHgZ.js → completions-B-Lf28Wy.js}

@@ -35,6 +35,7 @@ const AGENTS_COMMANDS = [
 	`start-builtin`,
 	`stop`,
 	`quickstart`,
+	`init`,
 	`completion`
 ];
 const TYPES_SUBCOMMANDS = [`inspect`, `delete`];

package/dist/{completions-CO5UBiNh.cjs → completions-Bj4D5DRa.cjs}

@@ -37,6 +37,7 @@ const AGENTS_COMMANDS = [
 	`start-builtin`,
 	`stop`,
 	`quickstart`,
+	`init`,
 	`completion`
 ];
 const TYPES_SUBCOMMANDS = [`inspect`, `delete`];

package/dist/completions.cjs

@@ -1,4 +1,4 @@
-const require_completions = require('./completions-CO5UBiNh.cjs');
+const require_completions = require('./completions-Bj4D5DRa.cjs');
 
 exports.fetchEntityTypeNames = require_completions.fetchEntityTypeNames
 exports.fetchEntityUrls = require_completions.fetchEntityUrls

package/dist/completions.d.cts

@@ -1,4 +1,4 @@
-import { ElectricCliEnv } from "./index-Bx8g95OI.cjs";
+import { ElectricCliEnv } from "./index-BNTf2uZL.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-Co_ocoIu.js";
+import { ElectricCliEnv } from "./index-DS2RpaPZ.js";
 
 //#region src/completions.d.ts
 declare function fetchEntityTypeNames(env: ElectricCliEnv): Promise<Array<string>>;

package/dist/completions.js

@@ -1,3 +1,3 @@
-import { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions } from "./completions-BHILvHgZ.js";
+import { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions } from "./completions-B-Lf28Wy.js";
 
 export { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions };

package/dist/{index-Bx8g95OI.d.cts → index-BNTf2uZL.d.cts}

@@ -87,6 +87,7 @@ interface ElectricCliHandlers {
   startBuiltin: (options: StartBuiltinCommandOptions) => Promise<StartedBuiltinAgentsEnvironment>;
   stop: (options: StopCommandOptions) => Promise<StoppedDevEnvironment>;
   quickstart: (options: StartBuiltinCommandOptions) => Promise<void>;
+  init: (projectName?: string) => Promise<void>;
 }
 interface InvocationEnv {
   npm_command?: string;

package/dist/{index-Co_ocoIu.d.ts → index-DS2RpaPZ.d.ts}

@@ -87,6 +87,7 @@ interface ElectricCliHandlers {
   startBuiltin: (options: StartBuiltinCommandOptions) => Promise<StartedBuiltinAgentsEnvironment>;
   stop: (options: StopCommandOptions) => Promise<StoppedDevEnvironment>;
   quickstart: (options: StartBuiltinCommandOptions) => Promise<void>;
+  init: (projectName?: string) => Promise<void>;
 }
 interface InvocationEnv {
   npm_command?: string;

package/dist/index.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_completions = require('./completions-CO5UBiNh.cjs');
+const require_completions = require('./completions-Bj4D5DRa.cjs');
 const require_env = require('./env-BXUgom_C.cjs');
 const node_fs = require_chunk.__toESM(require("node:fs"));
 const node_os = require_chunk.__toESM(require("node:os"));
@@ -285,6 +285,10 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 			].join(`\n`));
 			console.log(``);
 			await startBuiltinAgentsServer(options, { agentServerUrl: started.uiUrl });
+		},
+		init: async (projectName) => {
+			const { initProject } = await import(`./init.js`);
+			await initProject(projectName);
 		}
 	};
 }
@@ -362,6 +366,10 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.quickstart(command.opts());
 	});
+	agentsCommand.command(`init [project-name]`).description(`Scaffold a new Electric Agents project from a starter template`).action(async (...actionArgs) => {
+		const projectName = actionArgs[0];
+		await handlers.init(projectName);
+	});
 	const completionCommand = agentsCommand.command(`completion [action]`).description(`Set up shell completion`).addHelpText(`after`, `
 Setup (add to your shell init file):
 

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-Bx8g95OI.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-BNTf2uZL.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-Co_ocoIu.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-DS2RpaPZ.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,5 +1,5 @@
 #!/usr/bin/env node
-import { installCompletions, setupCompletions } from "./completions-BHILvHgZ.js";
+import { installCompletions, setupCompletions } from "./completions-B-Lf28Wy.js";
 import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-LZtIfFz1.js";
 import { realpathSync } from "node:fs";
 import { hostname, userInfo } from "node:os";
@@ -68,9 +68,9 @@ function resolveCommandPrefix(argv, env = process.env) {
 	}
 	return commandExample(resolveCommandName(argv));
 }
-async function electricAgentsFetch(env, path, opts = {}) {
+async function electricAgentsFetch(env, path$1, opts = {}) {
 	try {
-		return await fetch(`${env.electricAgentsUrl}${path}`, {
+		return await fetch(`${env.electricAgentsUrl}${path$1}`, {
 			...opts,
 			headers: {
 				"content-type": `application/json`,
@@ -283,6 +283,10 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 			].join(`\n`));
 			console.log(``);
 			await startBuiltinAgentsServer(options, { agentServerUrl: started.uiUrl });
+		},
+		init: async (projectName) => {
+			const { initProject } = await import(`./init.js`);
+			await initProject(projectName);
 		}
 	};
 }
@@ -360,6 +364,10 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.quickstart(command.opts());
 	});
+	agentsCommand.command(`init [project-name]`).description(`Scaffold a new Electric Agents project from a starter template`).action(async (...actionArgs) => {
+		const projectName = actionArgs[0];
+		await handlers.init(projectName);
+	});
 	const completionCommand = agentsCommand.command(`completion [action]`).description(`Set up shell completion`).addHelpText(`after`, `
 Setup (add to your shell init file):
 

package/dist/init.cjs

@@ -0,0 +1,44 @@
+"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_child_process = require_chunk.__toESM(require("node:child_process"));
+
+//#region src/init.ts
+const TEMPLATE_REPO = `electric-sql/electric/tree/main/examples/agents-chat-starter`;
+async function initProject(projectName) {
+	const name = projectName ?? `my-agents-app`;
+	const targetDir = node_path.default.resolve(process.cwd(), name);
+	if (node_fs.default.existsSync(targetDir)) {
+		console.error(`Error: directory "${name}" already exists`);
+		process.exit(1);
+	}
+	console.log(`Scaffolding Electric Agents project into ${name}...`);
+	console.log(``);
+	try {
+		(0, node_child_process.execSync)(`npx gitpick ${TEMPLATE_REPO} ${name}`, {
+			stdio: `inherit`,
+			cwd: process.cwd()
+		});
+	} catch {
+		console.error(`Failed to scaffold project. Make sure npx is available.`);
+		process.exit(1);
+	}
+	console.log(``);
+	console.log(`Done! Next steps:`);
+	console.log(``);
+	console.log(`  cd ${name}`);
+	console.log(`  pnpm install`);
+	console.log(`  cp .env.example .env`);
+	console.log(``);
+	console.log(`Then set your ANTHROPIC_API_KEY in .env`);
+	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(`  pnpm dev                          # in another terminal`);
+	console.log(``);
+}
+
+//#endregion
+exports.initProject = initProject

package/dist/init.d.cts

@@ -0,0 +1,5 @@
+//#region src/init.d.ts
+declare function initProject(projectName?: string): Promise<void>;
+
+//#endregion
+export { initProject };

package/dist/init.d.ts

@@ -0,0 +1,5 @@
+//#region src/init.d.ts
+declare function initProject(projectName?: string): Promise<void>;
+
+//#endregion
+export { initProject };

package/dist/init.js

@@ -0,0 +1,42 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+
+//#region src/init.ts
+const TEMPLATE_REPO = `electric-sql/electric/tree/main/examples/agents-chat-starter`;
+async function initProject(projectName) {
+	const name = projectName ?? `my-agents-app`;
+	const targetDir = path.resolve(process.cwd(), name);
+	if (fs.existsSync(targetDir)) {
+		console.error(`Error: directory "${name}" already exists`);
+		process.exit(1);
+	}
+	console.log(`Scaffolding Electric Agents project into ${name}...`);
+	console.log(``);
+	try {
+		execSync(`npx gitpick ${TEMPLATE_REPO} ${name}`, {
+			stdio: `inherit`,
+			cwd: process.cwd()
+		});
+	} catch {
+		console.error(`Failed to scaffold project. Make sure npx is available.`);
+		process.exit(1);
+	}
+	console.log(``);
+	console.log(`Done! Next steps:`);
+	console.log(``);
+	console.log(`  cd ${name}`);
+	console.log(`  pnpm install`);
+	console.log(`  cp .env.example .env`);
+	console.log(``);
+	console.log(`Then set your ANTHROPIC_API_KEY in .env`);
+	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(`  pnpm dev                          # in another terminal`);
+	console.log(``);
+}
+
+//#endregion
+export { initProject };

package/dist/start.cjs

@@ -5,6 +5,18 @@ 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/version.ts
+/**
+* Default Docker image tags used by the CLI when launching
+* the dev environment via docker compose.
+*
+* For release builds these remain "latest".
+* The canary CI overwrites them to "canary" before building.
+*/
+const ELECTRIC_IMAGE_TAG = `latest`;
+const ELECTRIC_AGENTS_SERVER_IMAGE_TAG = `latest`;
+
+//#endregion
 //#region src/start.ts
 const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
 const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
@@ -105,7 +117,9 @@ async function startElectricAgentsDevEnvironment(_options = {}, env = process.en
 	], {
 		...env,
 		COMPOSE_PROJECT_NAME: composeProjectName,
-		ELECTRIC_AGENTS_PORT: String(port)
+		ELECTRIC_AGENTS_PORT: String(port),
+		ELECTRIC_IMAGE_TAG: env.ELECTRIC_IMAGE_TAG ?? ELECTRIC_IMAGE_TAG,
+		ELECTRIC_AGENTS_SERVER_IMAGE_TAG: env.ELECTRIC_AGENTS_SERVER_IMAGE_TAG ?? ELECTRIC_AGENTS_SERVER_IMAGE_TAG
 	});
 	const uiUrl = `http://localhost:${port}`;
 	await waitForElectricAgentsServer(uiUrl);

package/dist/start.d.cts

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

package/dist/start.d.ts

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

package/dist/start.js

@@ -3,6 +3,18 @@ import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 import { BuiltinAgentsServer } from "@electric-ax/agents";
 
+//#region src/version.ts
+/**
+* Default Docker image tags used by the CLI when launching
+* the dev environment via docker compose.
+*
+* For release builds these remain "latest".
+* The canary CI overwrites them to "canary" before building.
+*/
+const ELECTRIC_IMAGE_TAG = `latest`;
+const ELECTRIC_AGENTS_SERVER_IMAGE_TAG = `latest`;
+
+//#endregion
 //#region src/start.ts
 const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
 const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
@@ -103,7 +115,9 @@ async function startElectricAgentsDevEnvironment(_options = {}, env = process.en
 	], {
 		...env,
 		COMPOSE_PROJECT_NAME: composeProjectName,
-		ELECTRIC_AGENTS_PORT: String(port)
+		ELECTRIC_AGENTS_PORT: String(port),
+		ELECTRIC_IMAGE_TAG: env.ELECTRIC_IMAGE_TAG ?? ELECTRIC_IMAGE_TAG,
+		ELECTRIC_AGENTS_SERVER_IMAGE_TAG: env.ELECTRIC_AGENTS_SERVER_IMAGE_TAG ?? ELECTRIC_AGENTS_SERVER_IMAGE_TAG
 	});
 	const uiUrl = `http://localhost:${port}`;
 	await waitForElectricAgentsServer(uiUrl);

package/docker-compose.full.yml

@@ -27,7 +27,7 @@ services:
       - electric-agents-postgres-data:/var/lib/postgresql
 
   electric:
-    image: electricsql/electric:latest
+    image: electricsql/electric:${ELECTRIC_IMAGE_TAG:-latest}
     restart: unless-stopped
     depends_on:
       postgres:
@@ -37,7 +37,8 @@ services:
       ELECTRIC_INSECURE: 'true'
 
   electric-agents:
-    image: electricax/agents-server:latest
+    image: electricax/agents-server:${ELECTRIC_AGENTS_SERVER_IMAGE_TAG:-latest}
+    pull_policy: always
     restart: unless-stopped
     extra_hosts:
       - 'host.docker.internal:host-gateway'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electric-ax",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "CLI for Electric Agents",
   "author": "ElectricSQL team and contributors",
   "license": "Apache-2.0",
@@ -46,8 +46,8 @@
     "ink": "^6.8.0",
     "omelette": "^0.4.17",
     "react": "^19.2.0",
-    "@electric-ax/agents-runtime": "0.0.4",
-    "@electric-ax/agents": "0.1.5"
+    "@electric-ax/agents": "0.2.1",
+    "@electric-ax/agents-runtime": "0.1.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",