electric-ax 0.2.5 → 0.2.8

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

@@ -30,6 +30,7 @@ const AGENTS_COMMANDS = [
 	`observe`,
 	`inspect`,
 	`ps`,
+	`signal`,
 	`kill`,
 	`start`,
 	`start-builtin`,
@@ -43,6 +44,7 @@ const COMMAND_FLAGS = {
 	spawn: [`--args`],
 	send: [`--type`, `--json`],
 	observe: [`--from`],
+	signal: [`--reason`, `--payload`],
 	ps: [
 		`--type`,
 		`--status`,
@@ -74,8 +76,18 @@ const ENTITY_URL_COMMANDS = new Set([
 	`send`,
 	`observe`,
 	`inspect`,
+	`signal`,
 	`kill`
 ]);
+const ENTITY_SIGNALS = [
+	`SIGINT`,
+	`SIGHUP`,
+	`SIGTERM`,
+	`SIGKILL`,
+	`SIGSTOP`,
+	`SIGCONT`,
+	`SIGUSR`
+];
 function setupCompletions(env, commandName) {
 	const completion = omelette(`${commandName} <namespace> <command> <arg1> <arg2>`);
 	completion.on(`namespace`, ({ reply }) => {
@@ -125,6 +137,10 @@ function setupCompletions(env, commandName) {
 			reply(fetchEntityTypeNames(env));
 			return;
 		}
+		if (command === `signal`) {
+			reply(Promise.resolve(ENTITY_SIGNALS));
+			return;
+		}
 		reply(Promise.resolve([]));
 	});
 	completion.init();

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

@@ -32,6 +32,7 @@ const AGENTS_COMMANDS = [
 	`observe`,
 	`inspect`,
 	`ps`,
+	`signal`,
 	`kill`,
 	`start`,
 	`start-builtin`,
@@ -45,6 +46,7 @@ const COMMAND_FLAGS = {
 	spawn: [`--args`],
 	send: [`--type`, `--json`],
 	observe: [`--from`],
+	signal: [`--reason`, `--payload`],
 	ps: [
 		`--type`,
 		`--status`,
@@ -76,8 +78,18 @@ const ENTITY_URL_COMMANDS = new Set([
 	`send`,
 	`observe`,
 	`inspect`,
+	`signal`,
 	`kill`
 ]);
+const ENTITY_SIGNALS = [
+	`SIGINT`,
+	`SIGHUP`,
+	`SIGTERM`,
+	`SIGKILL`,
+	`SIGSTOP`,
+	`SIGCONT`,
+	`SIGUSR`
+];
 function setupCompletions(env, commandName) {
 	const completion = (0, omelette.default)(`${commandName} <namespace> <command> <arg1> <arg2>`);
 	completion.on(`namespace`, ({ reply }) => {
@@ -127,6 +139,10 @@ function setupCompletions(env, commandName) {
 			reply(fetchEntityTypeNames(env));
 			return;
 		}
+		if (command === `signal`) {
+			reply(Promise.resolve(ENTITY_SIGNALS));
+			return;
+		}
 		reply(Promise.resolve([]));
 	});
 	completion.init();

package/dist/completions.cjs

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

package/dist/completions.d.cts

@@ -1,4 +1,4 @@
-import { ElectricCliEnv } from "./index-OgX1QS9Q.cjs";
+import { ElectricCliEnv } from "./index-DmR3DeFk.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-CwRI9tWl.js";
+import { ElectricCliEnv } from "./index-BsITLCxF.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-B-Lf28Wy.js";
+import { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions } from "./completions-3RE2mC2p.js";
 
 export { fetchEntityTypeNames, fetchEntityUrls, installCompletions, setupCompletions };

package/dist/{index-CwRI9tWl.d.ts → index-BsITLCxF.d.ts}

@@ -61,6 +61,11 @@ interface SendCommandOptions {
   type?: string;
   json?: boolean;
 }
+type EntitySignal = `SIGINT` | `SIGHUP` | `SIGTERM` | `SIGKILL` | `SIGSTOP` | `SIGCONT` | `SIGUSR`;
+interface SignalCommandOptions {
+  reason?: string;
+  payload?: string;
+}
 interface ObserveCommandOptions {
   from?: string;
 }
@@ -85,6 +90,7 @@ interface ElectricCliHandlers {
   observe: (url: string, options: ObserveCommandOptions) => Promise<void>;
   inspect: (url: string) => Promise<void>;
   ps: (options: PsCommandOptions) => Promise<void>;
+  signal: (url: string, signal: string, options: SignalCommandOptions) => Promise<void>;
   kill: (url: string) => Promise<void>;
   start: (options: StartCommandOptions) => Promise<StartedDevEnvironment>;
   startBuiltin: (options: StartBuiltinCommandOptions) => Promise<StartedBuiltinAgentsEnvironment>;
@@ -125,4 +131,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, formatQuickstartBackendStartedMessage, getElectricCliEnv, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };
+export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/{index-OgX1QS9Q.d.cts → index-DmR3DeFk.d.cts}

@@ -61,6 +61,11 @@ interface SendCommandOptions {
   type?: string;
   json?: boolean;
 }
+type EntitySignal = `SIGINT` | `SIGHUP` | `SIGTERM` | `SIGKILL` | `SIGSTOP` | `SIGCONT` | `SIGUSR`;
+interface SignalCommandOptions {
+  reason?: string;
+  payload?: string;
+}
 interface ObserveCommandOptions {
   from?: string;
 }
@@ -85,6 +90,7 @@ interface ElectricCliHandlers {
   observe: (url: string, options: ObserveCommandOptions) => Promise<void>;
   inspect: (url: string) => Promise<void>;
   ps: (options: PsCommandOptions) => Promise<void>;
+  signal: (url: string, signal: string, options: SignalCommandOptions) => Promise<void>;
   kill: (url: string) => Promise<void>;
   start: (options: StartCommandOptions) => Promise<StartedDevEnvironment>;
   startBuiltin: (options: StartBuiltinCommandOptions) => Promise<StartedBuiltinAgentsEnvironment>;
@@ -125,4 +131,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, formatQuickstartBackendStartedMessage, getElectricCliEnv, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };
+export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, getStartedBuiltinAgentsMessage, getStartedEnvironmentMessage, getStoppedEnvironmentMessage, readDotEnvFile, resolveAnthropicApiKey, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, resolvePullWakeOwnerPrincipal, resolvePullWakeRunnerId, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

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-Bj4D5DRa.cjs');
+const require_completions = require('./completions-BeohCOLD.cjs');
 const require_entity_api = require('./entity-api-Cvo55yZx.cjs');
 const require_env = require('./env-CFKgT8o2.cjs');
 const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
@@ -139,6 +139,15 @@ function writeApiKeyToDotEnv(key, cwd) {
 //#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
+const ENTITY_SIGNALS = [
+	`SIGINT`,
+	`SIGHUP`,
+	`SIGTERM`,
+	`SIGKILL`,
+	`SIGSTOP`,
+	`SIGCONT`,
+	`SIGUSR`
+];
 var CliError = class extends Error {};
 function getDefaultElectricAgentsIdentity() {
 	return `${(0, node_os.userInfo)().username}@${(0, node_os.hostname)()}`;
@@ -197,6 +206,17 @@ function parsePayload(input, json) {
 	}
 	return { text: input };
 }
+function parseJsonOption(name, input) {
+	try {
+		return JSON.parse(input);
+	} catch (error) {
+		fail(`${name} must be valid JSON: ${getErrorMessage(error)}`);
+	}
+}
+function assertEntitySignal(signal) {
+	if (ENTITY_SIGNALS.includes(signal)) return signal;
+	fail(`Invalid signal "${signal}". Expected one of: ${ENTITY_SIGNALS.join(`, `)}`);
+}
 function normalizeVariadicArg(value) {
 	if (value === void 0) return [];
 	return Array.isArray(value) ? value : [value];
@@ -458,13 +478,34 @@ async function listEntities(env, options) {
 	}
 }
 async function killEntity(env, url) {
-	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url), { method: `DELETE` });
+	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url, `/signal`), {
+		method: `POST`,
+		body: JSON.stringify({
+			signal: `SIGKILL`,
+			reason: `Killed from CLI`
+		})
+	});
 	if (!res.ok) {
 		const data = await parseJsonResponse(res);
 		failFromResponse(data, res);
 	}
 	console.log(`Killed ${url}`);
 }
+async function signalEntity(env, url, rawSignal, options) {
+	const signal = assertEntitySignal(rawSignal);
+	const body = { signal };
+	if (options.reason !== void 0) body.reason = options.reason;
+	if (options.payload !== void 0) body.payload = parseJsonOption(`--payload`, options.payload);
+	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url, `/signal`), {
+		method: `POST`,
+		body: JSON.stringify(body)
+	});
+	if (!res.ok) {
+		const data = await parseJsonResponse(res);
+		failFromResponse(data, res);
+	}
+	console.log(`Sent ${signal} to ${url}`);
+}
 function printStartedEnvironment(env) {
 	console.log([
 		`Electric Agents dev environment is up.`,
@@ -494,6 +535,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 		observe: (url, options) => observeEntity(env, url, options),
 		inspect: (url) => inspectEntity(env, url),
 		ps: (options) => listEntities(env, options),
+		signal: (url, signal, options) => signalEntity(env, url, signal, options),
 		kill: (url) => killEntity(env, url),
 		start: async (options) => {
 			const { startElectricAgentsDevEnvironment } = await loadStartModule();
@@ -556,6 +598,7 @@ Examples:
   $ ${agentsCommand} types
   $ ${agentsCommand} spawn /horton/onboarding
   $ ${agentsCommand} send /horton/onboarding "Help me onboard to Electric Agents"
+  $ ${agentsCommand} signal /horton/onboarding SIGINT --reason "stop current run"
   $ ${agentsCommand} observe /horton/onboarding
   $ ${agentsCommand} start
   $ ${agentsCommand} start-builtin --anthropic-api-key sk-ant-...
@@ -592,6 +635,12 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.observe(url, command.opts());
 	});
+	agentsCommand.command(`signal <url> <signal>`).description(`Send a lifecycle signal to an entity`).option(`--reason <text>`, `Human-readable signal reason`).option(`--payload <json>`, `JSON payload to attach to the signal`).action(async (...actionArgs) => {
+		const url = actionArgs[0];
+		const signal = actionArgs[1];
+		const command = getCommandActionArg(actionArgs);
+		await handlers.signal(url, signal, command.opts());
+	});
 	agentsCommand.command(`inspect <url>`).description(`Show entity details`).action(async (url) => {
 		await handlers.inspect(url);
 	});
@@ -599,7 +648,7 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.ps(command.opts());
 	});
-	agentsCommand.command(`kill <url>`).description(`Delete an entity`).action(async (url) => {
+	agentsCommand.command(`kill <url>`).description(`Send SIGKILL to an entity`).action(async (url) => {
 		await handlers.kill(url);
 	});
 	agentsCommand.command(`start`).description(`Start the Electric Agents coordinator server`).action(async (...actionArgs) => {

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, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-OgX1QS9Q.cjs";
-export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run };
+import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-DmR3DeFk.cjs";
+export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, 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, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-CwRI9tWl.js";
-export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run };
+import { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run } from "./index-BsITLCxF.js";
+export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, EntitySignal, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SignalCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run };

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { installCompletions, setupCompletions } from "./completions-B-Lf28Wy.js";
+import { installCompletions, setupCompletions } from "./completions-3RE2mC2p.js";
 import { entityApiPath } from "./entity-api-DWMhkYbl.js";
 import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-DIhTv987.js";
 import { appendPathToUrl } from "@electric-ax/agents-runtime";
@@ -137,6 +137,15 @@ function writeApiKeyToDotEnv(key, cwd) {
 //#endregion
 //#region src/index.ts
 const DEFAULT_ELECTRIC_AGENTS_URL = `http://localhost:4437`;
+const ENTITY_SIGNALS = [
+	`SIGINT`,
+	`SIGHUP`,
+	`SIGTERM`,
+	`SIGKILL`,
+	`SIGSTOP`,
+	`SIGCONT`,
+	`SIGUSR`
+];
 var CliError = class extends Error {};
 function getDefaultElectricAgentsIdentity() {
 	return `${userInfo().username}@${hostname()}`;
@@ -195,6 +204,17 @@ function parsePayload(input, json) {
 	}
 	return { text: input };
 }
+function parseJsonOption(name, input) {
+	try {
+		return JSON.parse(input);
+	} catch (error) {
+		fail(`${name} must be valid JSON: ${getErrorMessage(error)}`);
+	}
+}
+function assertEntitySignal(signal) {
+	if (ENTITY_SIGNALS.includes(signal)) return signal;
+	fail(`Invalid signal "${signal}". Expected one of: ${ENTITY_SIGNALS.join(`, `)}`);
+}
 function normalizeVariadicArg(value) {
 	if (value === void 0) return [];
 	return Array.isArray(value) ? value : [value];
@@ -456,13 +476,34 @@ async function listEntities(env, options) {
 	}
 }
 async function killEntity(env, url) {
-	const res = await electricAgentsFetch(env, entityApiPath(url), { method: `DELETE` });
+	const res = await electricAgentsFetch(env, entityApiPath(url, `/signal`), {
+		method: `POST`,
+		body: JSON.stringify({
+			signal: `SIGKILL`,
+			reason: `Killed from CLI`
+		})
+	});
 	if (!res.ok) {
 		const data = await parseJsonResponse(res);
 		failFromResponse(data, res);
 	}
 	console.log(`Killed ${url}`);
 }
+async function signalEntity(env, url, rawSignal, options) {
+	const signal = assertEntitySignal(rawSignal);
+	const body = { signal };
+	if (options.reason !== void 0) body.reason = options.reason;
+	if (options.payload !== void 0) body.payload = parseJsonOption(`--payload`, options.payload);
+	const res = await electricAgentsFetch(env, entityApiPath(url, `/signal`), {
+		method: `POST`,
+		body: JSON.stringify(body)
+	});
+	if (!res.ok) {
+		const data = await parseJsonResponse(res);
+		failFromResponse(data, res);
+	}
+	console.log(`Sent ${signal} to ${url}`);
+}
 function printStartedEnvironment(env) {
 	console.log([
 		`Electric Agents dev environment is up.`,
@@ -492,6 +533,7 @@ function createElectricCliHandlers(env, commandPrefix = commandExample(`electric
 		observe: (url, options) => observeEntity(env, url, options),
 		inspect: (url) => inspectEntity(env, url),
 		ps: (options) => listEntities(env, options),
+		signal: (url, signal, options) => signalEntity(env, url, signal, options),
 		kill: (url) => killEntity(env, url),
 		start: async (options) => {
 			const { startElectricAgentsDevEnvironment } = await loadStartModule();
@@ -554,6 +596,7 @@ Examples:
   $ ${agentsCommand} types
   $ ${agentsCommand} spawn /horton/onboarding
   $ ${agentsCommand} send /horton/onboarding "Help me onboard to Electric Agents"
+  $ ${agentsCommand} signal /horton/onboarding SIGINT --reason "stop current run"
   $ ${agentsCommand} observe /horton/onboarding
   $ ${agentsCommand} start
   $ ${agentsCommand} start-builtin --anthropic-api-key sk-ant-...
@@ -590,6 +633,12 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.observe(url, command.opts());
 	});
+	agentsCommand.command(`signal <url> <signal>`).description(`Send a lifecycle signal to an entity`).option(`--reason <text>`, `Human-readable signal reason`).option(`--payload <json>`, `JSON payload to attach to the signal`).action(async (...actionArgs) => {
+		const url = actionArgs[0];
+		const signal = actionArgs[1];
+		const command = getCommandActionArg(actionArgs);
+		await handlers.signal(url, signal, command.opts());
+	});
 	agentsCommand.command(`inspect <url>`).description(`Show entity details`).action(async (url) => {
 		await handlers.inspect(url);
 	});
@@ -597,7 +646,7 @@ function createElectricProgram({ env = getElectricCliEnv(), commandName = `elect
 		const command = getCommandActionArg(actionArgs);
 		await handlers.ps(command.opts());
 	});
-	agentsCommand.command(`kill <url>`).description(`Delete an entity`).action(async (url) => {
+	agentsCommand.command(`kill <url>`).description(`Send SIGKILL to an entity`).action(async (url) => {
 		await handlers.kill(url);
 	});
 	agentsCommand.command(`start`).description(`Start the Electric Agents coordinator server`).action(async (...actionArgs) => {

package/dist/observe-ui.cjs

@@ -261,6 +261,12 @@ function WakeView({ section }) {
 		})]
 	});
 }
+function ObserveExitHotkey({ onExit }) {
+	(0, ink.useInput)((_input, key) => {
+		if (key.escape) onExit();
+	});
+	return null;
+}
 function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 	const timelineQuery = (0, react.useMemo)(() => (0, __electric_ax_agents_runtime.createEntityIncludesQuery)(db), [db]);
 	const { data: timelineRows = [] } = (0, __tanstack_react_db.useLiveQuery)(timelineQuery, [timelineQuery]);
@@ -268,6 +274,9 @@ function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 		runs: [],
 		inbox: [],
 		wakes: [],
+		signals: [],
+		contextInserted: [],
+		contextRemoved: [],
 		entities: []
 	});
 	const typedRuns = timelineData.runs;
@@ -340,7 +349,7 @@ function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 		]
 	});
 }
-function ObserveApp({ entityUrl, baseUrl, identity, headers, initialOffset }) {
+function ObserveApp({ entityUrl, baseUrl, identity, headers, initialOffset, onExit }) {
 	const [db, setDb] = (0, react.useState)(null);
 	const [error, setError] = (0, react.useState)(null);
 	const closeRef = (0, react.useRef)(null);
@@ -371,43 +380,47 @@ function ObserveApp({ entityUrl, baseUrl, identity, headers, initialOffset }) {
 		initialOffset,
 		headers
 	]);
-	if (error) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
+	if (error) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, {
 		flexDirection: "column",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveExitHotkey, { onExit }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
 			color: "red",
 			children: `Error: ${error}`
-		})
+		})]
 	});
-	if (!db) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+	if (!db) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveExitHotkey, { onExit }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
 		dimColor: true,
 		children: `Connecting to ${entityUrl}...`
-	}) });
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveView, {
+	})] });
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveExitHotkey, { onExit }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveView, {
 		db,
 		entityUrl,
 		baseUrl,
 		identity,
 		headers
-	});
+	})] });
 }
 function renderObserve(opts) {
 	const { entityUrl, baseUrl, identity, headers, initialOffset } = opts;
-	const app = (0, ink.render)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveApp, {
+	let app;
+	const exit = () => {
+		app.unmount();
+		process.exit(0);
+	};
+	app = (0, ink.render)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveApp, {
 		entityUrl,
 		baseUrl,
 		identity,
 		headers,
-		initialOffset
+		initialOffset,
+		onExit: exit
 	}));
-	process.on(`SIGINT`, () => {
-		app.unmount();
-		process.exit(0);
-	});
+	process.on(`SIGINT`, exit);
 }
 
 //#endregion
 exports.AgentTextView = AgentTextView
 exports.MessageInput = MessageInput
+exports.ObserveExitHotkey = ObserveExitHotkey
 exports.ToolCallView = ToolCallView
 exports.ToolResultView = ToolResultView
 exports.UserMessageView = UserMessageView

package/dist/observe-ui.d.cts

@@ -50,6 +50,11 @@ declare function MessageInput({
   headers?: Record<string, string>;
   disabled: boolean;
 }): React.ReactElement;
+declare function ObserveExitHotkey({
+  onExit
+}: {
+  onExit: () => void;
+}): React.ReactElement | null;
 declare function renderObserve(opts: {
   entityUrl: string;
   baseUrl: string;
@@ -59,4 +64,4 @@ declare function renderObserve(opts: {
 }): void;
 
 //#endregion
-export { AgentTextView, MessageInput, ToolCallView, ToolResultView, UserMessageView, formatTime, renderObserve, truncate };
+export { AgentTextView, MessageInput, ObserveExitHotkey, ToolCallView, ToolResultView, UserMessageView, formatTime, renderObserve, truncate };

package/dist/observe-ui.d.ts

@@ -50,6 +50,11 @@ declare function MessageInput({
   headers?: Record<string, string>;
   disabled: boolean;
 }): React.ReactElement;
+declare function ObserveExitHotkey({
+  onExit
+}: {
+  onExit: () => void;
+}): React.ReactElement | null;
 declare function renderObserve(opts: {
   entityUrl: string;
   baseUrl: string;
@@ -59,4 +64,4 @@ declare function renderObserve(opts: {
 }): void;
 
 //#endregion
-export { AgentTextView, MessageInput, ToolCallView, ToolResultView, UserMessageView, formatTime, renderObserve, truncate };
+export { AgentTextView, MessageInput, ObserveExitHotkey, ToolCallView, ToolResultView, UserMessageView, formatTime, renderObserve, truncate };

package/dist/observe-ui.js

@@ -259,6 +259,12 @@ function WakeView({ section }) {
 		})]
 	});
 }
+function ObserveExitHotkey({ onExit }) {
+	useInput((_input, key) => {
+		if (key.escape) onExit();
+	});
+	return null;
+}
 function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 	const timelineQuery = useMemo(() => createEntityIncludesQuery(db), [db]);
 	const { data: timelineRows = [] } = useLiveQuery(timelineQuery, [timelineQuery]);
@@ -266,6 +272,9 @@ function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 		runs: [],
 		inbox: [],
 		wakes: [],
+		signals: [],
+		contextInserted: [],
+		contextRemoved: [],
 		entities: []
 	});
 	const typedRuns = timelineData.runs;
@@ -338,7 +347,7 @@ function ObserveView({ db, entityUrl, baseUrl, identity, headers }) {
 		]
 	});
 }
-function ObserveApp({ entityUrl, baseUrl, identity, headers, initialOffset }) {
+function ObserveApp({ entityUrl, baseUrl, identity, headers, initialOffset, onExit }) {
 	const [db, setDb] = useState(null);
 	const [error, setError] = useState(null);
 	const closeRef = useRef(null);
@@ -369,39 +378,42 @@ function ObserveApp({ entityUrl, baseUrl, identity, headers, initialOffset }) {
 		initialOffset,
 		headers
 	]);
-	if (error) return /* @__PURE__ */ jsx(Box, {
+	if (error) return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
-		children: /* @__PURE__ */ jsx(Text, {
+		children: [/* @__PURE__ */ jsx(ObserveExitHotkey, { onExit }), /* @__PURE__ */ jsx(Text, {
 			color: "red",
 			children: `Error: ${error}`
-		})
+		})]
 	});
-	if (!db) return /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, {
+	if (!db) return /* @__PURE__ */ jsxs(Box, { children: [/* @__PURE__ */ jsx(ObserveExitHotkey, { onExit }), /* @__PURE__ */ jsx(Text, {
 		dimColor: true,
 		children: `Connecting to ${entityUrl}...`
-	}) });
-	return /* @__PURE__ */ jsx(ObserveView, {
+	})] });
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(ObserveExitHotkey, { onExit }), /* @__PURE__ */ jsx(ObserveView, {
 		db,
 		entityUrl,
 		baseUrl,
 		identity,
 		headers
-	});
+	})] });
 }
 function renderObserve(opts) {
 	const { entityUrl, baseUrl, identity, headers, initialOffset } = opts;
-	const app = render(/* @__PURE__ */ jsx(ObserveApp, {
+	let app;
+	const exit = () => {
+		app.unmount();
+		process.exit(0);
+	};
+	app = render(/* @__PURE__ */ jsx(ObserveApp, {
 		entityUrl,
 		baseUrl,
 		identity,
 		headers,
-		initialOffset
+		initialOffset,
+		onExit: exit
 	}));
-	process.on(`SIGINT`, () => {
-		app.unmount();
-		process.exit(0);
-	});
+	process.on(`SIGINT`, exit);
 }
 
 //#endregion
-export { AgentTextView, MessageInput, ToolCallView, ToolResultView, UserMessageView, formatTime, renderObserve, truncate };
+export { AgentTextView, MessageInput, ObserveExitHotkey, ToolCallView, ToolResultView, UserMessageView, formatTime, renderObserve, truncate };

package/dist/start.d.cts

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

package/dist/start.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electric-ax",
-  "version": "0.2.5",
+  "version": "0.2.8",
   "description": "CLI for Electric Agents",
   "author": "ElectricSQL team and contributors",
   "license": "Apache-2.0",
@@ -39,15 +39,15 @@
   "dependencies": {
     "@durable-streams/client": "https://pkg.pr.new/durable-streams/durable-streams/@durable-streams/client@5d5c217",
     "@durable-streams/state": "https://pkg.pr.new/durable-streams/durable-streams/@durable-streams/state@5d5c217",
-    "@electric-sql/client": "^1.5.18",
+    "@electric-sql/client": "^1.5.19",
     "@tanstack/db": "^0.6.4",
     "@tanstack/react-db": "^0.1.82",
     "commander": "^13.1.0",
     "ink": "^6.8.0",
     "omelette": "^0.4.17",
     "react": "^19.2.0",
-    "@electric-ax/agents": "0.4.5",
-    "@electric-ax/agents-runtime": "0.3.1"
+    "@electric-ax/agents": "0.4.8",
+    "@electric-ax/agents-runtime": "0.3.4"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.0",