electric-ax 0.1.17 → 0.2.0

package/dist/completions.d.cts

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

package/dist/entity-api-ClpnLxWJ.cjs

@@ -0,0 +1,38 @@
+"use strict";
+const require_chunk = require('./chunk-BCwAaXi7.cjs');
+const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
+
+//#region src/entity-api.ts
+function withLeadingSlash(path) {
+	return path.startsWith(`/`) ? path : `/${path}`;
+}
+function entityApiPath(entityUrl, suffix = ``) {
+	return `/_electric/entities${withLeadingSlash(entityUrl)}${suffix}`;
+}
+function entityApiUrl(baseUrl, entityUrl, suffix = ``) {
+	return (0, __electric_ax_agents_runtime.appendPathToUrl)(baseUrl, entityApiPath(entityUrl, suffix));
+}
+function assertedIdentityHeaders(identity) {
+	const trimmed = identity?.trim();
+	return trimmed ? { "x-electric-asserted-email": trimmed } : {};
+}
+
+//#endregion
+Object.defineProperty(exports, 'assertedIdentityHeaders', {
+  enumerable: true,
+  get: function () {
+    return assertedIdentityHeaders;
+  }
+});
+Object.defineProperty(exports, 'entityApiPath', {
+  enumerable: true,
+  get: function () {
+    return entityApiPath;
+  }
+});
+Object.defineProperty(exports, 'entityApiUrl', {
+  enumerable: true,
+  get: function () {
+    return entityApiUrl;
+  }
+});

package/dist/entity-api-Dh28Mz7H.js

@@ -0,0 +1,19 @@
+import { appendPathToUrl } from "@electric-ax/agents-runtime";
+
+//#region src/entity-api.ts
+function withLeadingSlash(path) {
+	return path.startsWith(`/`) ? path : `/${path}`;
+}
+function entityApiPath(entityUrl, suffix = ``) {
+	return `/_electric/entities${withLeadingSlash(entityUrl)}${suffix}`;
+}
+function entityApiUrl(baseUrl, entityUrl, suffix = ``) {
+	return appendPathToUrl(baseUrl, entityApiPath(entityUrl, suffix));
+}
+function assertedIdentityHeaders(identity) {
+	const trimmed = identity?.trim();
+	return trimmed ? { "x-electric-asserted-email": trimmed } : {};
+}
+
+//#endregion
+export { assertedIdentityHeaders, entityApiPath, entityApiUrl };

package/dist/{entity-stream-db-Djo-7a11.cjs → entity-stream-db-BLbPedyR.cjs}

@@ -1,5 +1,6 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
+const require_entity_api = require('./entity-api-ClpnLxWJ.cjs');
 const __durable_streams_state = require_chunk.__toESM(require("@durable-streams/state"));
 const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
 
@@ -8,21 +9,28 @@ function getMainStreamPath(entityUrl, entity) {
 	return entity.streams?.main ?? `${entityUrl}/main`;
 }
 async function createEntityStreamDB(opts) {
-	const { baseUrl, entityUrl, initialOffset } = opts;
+	const { baseUrl, entityUrl, initialOffset, assertedAuthEmail, assertedAuthName, headers: serverHeaders } = opts;
 	console.log(`[createEntityStreamDB] Creating entity stream DB for ${baseUrl}${entityUrl}`);
+	const requestHeaders = {
+		"content-type": `application/json`,
+		...require_entity_api.assertedIdentityHeaders(assertedAuthEmail),
+		...assertedAuthName ? { "x-electric-asserted-name": assertedAuthName } : {},
+		...serverHeaders
+	};
 	let res;
 	try {
-		res = await fetch(`${baseUrl}${entityUrl}`, { headers: { "content-type": `application/json` } });
+		res = await fetch(require_entity_api.entityApiUrl(baseUrl, entityUrl), { headers: requestHeaders });
 	} catch (err) {
 		throw new Error(`Could not connect to the Electric Agents server at ${baseUrl} — is it running?\n  ${err instanceof Error ? err.message : String(err)}`);
 	}
 	if (!res.ok) throw new Error(`Failed to fetch entity at ${entityUrl}: ${res.statusText}`);
 	const entity = await res.json();
 	const streamPath = getMainStreamPath(entityUrl, entity);
-	const streamUrl = `${baseUrl}${streamPath}`;
+	const streamUrl = (0, __electric_ax_agents_runtime.appendPathToUrl)(baseUrl, streamPath);
 	const db = (0, __durable_streams_state.createStreamDB)({
 		streamOptions: {
 			url: streamUrl,
+			headers: requestHeaders,
 			contentType: `application/json`,
 			...initialOffset ? { offset: initialOffset } : {}
 		},

package/dist/{entity-stream-db-BRwzIuHl.d.ts → entity-stream-db-CmDwc49J.d.cts}

@@ -6,8 +6,11 @@ declare function createEntityStreamDB(opts: {
   baseUrl: string;
   entityUrl: string;
   initialOffset?: string;
+  assertedAuthEmail?: string;
+  assertedAuthName?: string;
+  headers?: Record<string, string>;
 }): Promise<{
   db: EntityStreamDB;
   close: () => void;
 }>; //#endregion
-export { EntityStreamDB$1 as EntityStreamDB, createEntityStreamDB as createEntityStreamDB$1 };
+export { EntityStreamDB$1 as EntityStreamDB, createEntityStreamDB };

package/dist/{entity-stream-db-CGP2xVeJ.js → entity-stream-db-Czz3S8YF.js}

@@ -1,26 +1,34 @@
+import { assertedIdentityHeaders, entityApiUrl } from "./entity-api-Dh28Mz7H.js";
 import { createStreamDB } from "@durable-streams/state";
-import { entityStateSchema } from "@electric-ax/agents-runtime";
+import { appendPathToUrl, entityStateSchema } from "@electric-ax/agents-runtime";
 
 //#region src/entity-stream-db.ts
 function getMainStreamPath(entityUrl, entity) {
 	return entity.streams?.main ?? `${entityUrl}/main`;
 }
 async function createEntityStreamDB(opts) {
-	const { baseUrl, entityUrl, initialOffset } = opts;
+	const { baseUrl, entityUrl, initialOffset, assertedAuthEmail, assertedAuthName, headers: serverHeaders } = opts;
 	console.log(`[createEntityStreamDB] Creating entity stream DB for ${baseUrl}${entityUrl}`);
+	const requestHeaders = {
+		"content-type": `application/json`,
+		...assertedIdentityHeaders(assertedAuthEmail),
+		...assertedAuthName ? { "x-electric-asserted-name": assertedAuthName } : {},
+		...serverHeaders
+	};
 	let res;
 	try {
-		res = await fetch(`${baseUrl}${entityUrl}`, { headers: { "content-type": `application/json` } });
+		res = await fetch(entityApiUrl(baseUrl, entityUrl), { headers: requestHeaders });
 	} catch (err) {
 		throw new Error(`Could not connect to the Electric Agents server at ${baseUrl} — is it running?\n  ${err instanceof Error ? err.message : String(err)}`);
 	}
 	if (!res.ok) throw new Error(`Failed to fetch entity at ${entityUrl}: ${res.statusText}`);
 	const entity = await res.json();
 	const streamPath = getMainStreamPath(entityUrl, entity);
-	const streamUrl = `${baseUrl}${streamPath}`;
+	const streamUrl = appendPathToUrl(baseUrl, streamPath);
 	const db = createStreamDB({
 		streamOptions: {
 			url: streamUrl,
+			headers: requestHeaders,
 			contentType: `application/json`,
 			...initialOffset ? { offset: initialOffset } : {}
 		},

package/dist/{entity-stream-db-C2C3t_hD.d.cts → entity-stream-db-DgzxI6C_.d.ts}

@@ -6,8 +6,11 @@ declare function createEntityStreamDB(opts: {
   baseUrl: string;
   entityUrl: string;
   initialOffset?: string;
+  assertedAuthEmail?: string;
+  assertedAuthName?: string;
+  headers?: Record<string, string>;
 }): Promise<{
   db: EntityStreamDB;
   close: () => void;
 }>; //#endregion
-export { EntityStreamDB$1 as EntityStreamDB, createEntityStreamDB };
+export { EntityStreamDB$1 as EntityStreamDB, createEntityStreamDB as createEntityStreamDB$1 };

package/dist/entity-stream-db.cjs

@@ -1,3 +1,4 @@
-const require_entity_stream_db = require('./entity-stream-db-Djo-7a11.cjs');
+require('./entity-api-ClpnLxWJ.cjs');
+const require_entity_stream_db = require('./entity-stream-db-BLbPedyR.cjs');
 
 exports.createEntityStreamDB = require_entity_stream_db.createEntityStreamDB

package/dist/entity-stream-db.d.cts

@@ -1,2 +1,2 @@
-import { EntityStreamDB, createEntityStreamDB } from "./entity-stream-db-C2C3t_hD.cjs";
+import { EntityStreamDB, createEntityStreamDB } from "./entity-stream-db-CmDwc49J.cjs";
 export { EntityStreamDB, createEntityStreamDB };

package/dist/entity-stream-db.d.ts

@@ -1,2 +1,2 @@
-import { EntityStreamDB, createEntityStreamDB$1 as createEntityStreamDB } from "./entity-stream-db-BRwzIuHl.js";
+import { EntityStreamDB, createEntityStreamDB$1 as createEntityStreamDB } from "./entity-stream-db-DgzxI6C_.js";
 export { EntityStreamDB, createEntityStreamDB };

package/dist/entity-stream-db.js

@@ -1,3 +1,4 @@
-import { createEntityStreamDB } from "./entity-stream-db-CGP2xVeJ.js";
+import "./entity-api-Dh28Mz7H.js";
+import { createEntityStreamDB } from "./entity-stream-db-Czz3S8YF.js";
 
 export { createEntityStreamDB };

package/dist/{index-B2MsxFCW.d.cts → index-BQ4JyfkG.d.cts}

@@ -19,22 +19,22 @@ interface StoppedDevEnvironment {
   removedVolumes: boolean;
 }
 interface StartedBuiltinAgentsEnvironment {
-  port: number;
+  runnerId: string;
   url: string;
-  registeredBaseUrl: string;
   agentServerUrl: string;
 }
 interface WaitForServerOptions {
   fetchImpl?: typeof globalThis.fetch;
+  headers?: Record<string, string>;
   timeoutMs?: number;
   intervalMs?: number;
 }
-declare function resolveBuiltinAgentsPort(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): number;
-declare function resolveBuiltinAgentsHost(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): string;
 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 resolvePullWakeRunnerId(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): string;
+declare function resolvePullWakeOwnerId(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): 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>;
@@ -52,6 +52,9 @@ declare const DEFAULT_ELECTRIC_AGENTS_URL = "http://localhost:4437";
 interface ElectricCliEnv {
   electricAgentsUrl: string;
   electricAgentsIdentity: string;
+  electricAssertedAuthEmail?: string;
+  electricAssertedAuthName?: string;
+  electricAgentsHeaders?: Record<string, string>;
 }
 interface SpawnCommandOptions {
   args?: string;
@@ -124,4 +127,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, resolveBuiltinAgentsHost, resolveBuiltinAgentsPort, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };
+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, resolvePullWakeOwnerId, resolvePullWakeRunnerId, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/{index-BDO8dHhT.d.ts → index-D6TZ88Yg.d.ts}

@@ -19,22 +19,22 @@ interface StoppedDevEnvironment {
   removedVolumes: boolean;
 }
 interface StartedBuiltinAgentsEnvironment {
-  port: number;
+  runnerId: string;
   url: string;
-  registeredBaseUrl: string;
   agentServerUrl: string;
 }
 interface WaitForServerOptions {
   fetchImpl?: typeof globalThis.fetch;
+  headers?: Record<string, string>;
   timeoutMs?: number;
   intervalMs?: number;
 }
-declare function resolveBuiltinAgentsPort(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): number;
-declare function resolveBuiltinAgentsHost(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): string;
 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 resolvePullWakeRunnerId(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): string;
+declare function resolvePullWakeOwnerId(env?: NodeJS.ProcessEnv, fileEnv?: Record<string, string>): 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>;
@@ -52,6 +52,9 @@ declare const DEFAULT_ELECTRIC_AGENTS_URL = "http://localhost:4437";
 interface ElectricCliEnv {
   electricAgentsUrl: string;
   electricAgentsIdentity: string;
+  electricAssertedAuthEmail?: string;
+  electricAssertedAuthName?: string;
+  electricAgentsHeaders?: Record<string, string>;
 }
 interface SpawnCommandOptions {
   args?: string;
@@ -124,4 +127,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, resolveBuiltinAgentsHost, resolveBuiltinAgentsPort, resolveCommandPrefix, resolveComposeProjectName, resolveElectricAgentsPort, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };
+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, resolvePullWakeOwnerId, resolvePullWakeRunnerId, run, startBuiltinAgentsServer, startElectricAgentsDevEnvironment, stopElectricAgentsDevEnvironment, waitForElectricAgentsServer };

package/dist/index.cjs

@@ -2,7 +2,9 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
 const require_completions = require('./completions-Bj4D5DRa.cjs');
-const require_env = require('./env-BXUgom_C.cjs');
+const require_entity_api = require('./entity-api-ClpnLxWJ.cjs');
+const require_env = require('./env-CFKgT8o2.cjs');
+const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
 const node_fs = require_chunk.__toESM(require("node:fs"));
 const node_os = require_chunk.__toESM(require("node:os"));
 const node_path = require_chunk.__toESM(require("node:path"));
@@ -67,11 +69,16 @@ async function ensureAnthropicApiKey(options, io = defaultPromptIO()) {
 		await validate(explicitKey);
 		return explicitKey;
 	}
+	let resolvedKey;
 	try {
-		const key = require_env.resolveAnthropicApiKey(options);
-		assertAnthropicApiKeyPrefix(key);
-		await validate(key);
-		return key;
+		resolvedKey = require_env.resolveAnthropicApiKey(options);
+	} catch (error) {
+		if (!io.isTTY) throw error;
+	}
+	if (resolvedKey !== void 0) try {
+		assertAnthropicApiKeyPrefix(resolvedKey);
+		await validate(resolvedKey);
+		return resolvedKey;
 	} catch (error) {
 		if (!io.isTTY) throw error;
 		initialError = error;
@@ -135,10 +142,32 @@ var CliError = class extends Error {};
 function getDefaultElectricAgentsIdentity() {
 	return `${(0, node_os.userInfo)().username}@${(0, node_os.hostname)()}`;
 }
+function parseElectricAgentsHeaders(raw) {
+	const trimmed = raw?.trim();
+	if (!trimmed) return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(trimmed);
+	} catch {
+		fail(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: expected JSON`);
+	}
+	if (!parsed || typeof parsed !== `object` || Array.isArray(parsed)) fail(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: expected a JSON object`);
+	const headers = new Headers();
+	for (const [name, value] of Object.entries(parsed)) {
+		if (typeof value !== `string`) fail(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: header "${name}" must be a string`);
+		headers.set(name, value);
+	}
+	const normalized = Object.fromEntries(headers.entries());
+	return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
 function getElectricCliEnv(env = process.env) {
+	const explicitIdentity = env.ELECTRIC_AGENTS_IDENTITY?.trim();
 	return {
 		electricAgentsUrl: env.ELECTRIC_AGENTS_URL || DEFAULT_ELECTRIC_AGENTS_URL,
-		electricAgentsIdentity: env.ELECTRIC_AGENTS_IDENTITY || getDefaultElectricAgentsIdentity()
+		electricAgentsIdentity: explicitIdentity || getDefaultElectricAgentsIdentity(),
+		electricAssertedAuthEmail: env.ELECTRIC_ASSERTED_AUTH_EMAIL?.trim() || explicitIdentity || void 0,
+		electricAssertedAuthName: env.ELECTRIC_ASSERTED_AUTH_NAME?.trim(),
+		electricAgentsHeaders: parseElectricAgentsHeaders(env.ELECTRIC_AGENTS_SERVER_HEADERS)
 	};
 }
 function getErrorMessage(error) {
@@ -265,10 +294,13 @@ function resolveCommandPrefix(argv, env = process.env) {
 }
 async function electricAgentsFetch(env, path, opts = {}) {
 	try {
-		return await fetch(`${env.electricAgentsUrl}${path}`, {
+		return await fetch((0, __electric_ax_agents_runtime.appendPathToUrl)(env.electricAgentsUrl, path), {
 			...opts,
 			headers: {
 				"content-type": `application/json`,
+				...require_entity_api.assertedIdentityHeaders(env.electricAssertedAuthEmail),
+				...env.electricAssertedAuthName ? { "x-electric-asserted-name": env.electricAssertedAuthName } : {},
+				...env.electricAgentsHeaders,
 				...opts.headers
 			}
 		});
@@ -343,7 +375,7 @@ async function spawnEntity(env, urlPath, options) {
 	} catch (error) {
 		fail(`--args must be valid JSON: ${getErrorMessage(error)}`);
 	}
-	const res = await electricAgentsFetch(env, urlPath, {
+	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(urlPath), {
 		method: `PUT`,
 		body: JSON.stringify({ args: spawnArgs })
 	});
@@ -360,7 +392,7 @@ async function sendMessage(env, url, message, options) {
 		payload
 	};
 	if (options.type) body.type = options.type;
-	const res = await electricAgentsFetch(env, `${url}/send`, {
+	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url, `/send`), {
 		method: `POST`,
 		body: JSON.stringify(body)
 	});
@@ -377,11 +409,14 @@ async function observeEntity(env, url, options) {
 		entityUrl: url,
 		baseUrl: env.electricAgentsUrl,
 		identity: env.electricAgentsIdentity,
+		assertedAuthEmail: env.electricAssertedAuthEmail,
+		assertedAuthName: env.electricAssertedAuthName,
+		headers: env.electricAgentsHeaders,
 		initialOffset: options.from
 	});
 }
 async function inspectEntity(env, url) {
-	const res = await electricAgentsFetch(env, url);
+	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url));
 	const data = await parseJsonResponse(res);
 	if (!res.ok) failFromResponse(data, res);
 	console.log(JSON.stringify(data, null, 2));
@@ -406,7 +441,7 @@ async function listEntities(env, options) {
 	}
 }
 async function killEntity(env, url) {
-	const res = await electricAgentsFetch(env, url, { method: `DELETE` });
+	const res = await electricAgentsFetch(env, require_entity_api.entityApiPath(url), { method: `DELETE` });
 	if (!res.ok) {
 		const data = await parseJsonResponse(res);
 		failFromResponse(data, res);

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-B2MsxFCW.cjs";
+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-BQ4JyfkG.cjs";
 export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, 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-BDO8dHhT.js";
+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-D6TZ88Yg.js";
 export { DEFAULT_ELECTRIC_AGENTS_URL, ElectricCliEnv, ElectricCliHandlers, ObserveCommandOptions, PsCommandOptions, SendCommandOptions, SpawnCommandOptions, StartBuiltinCommandOptions, StartCommandOptions, StartedBuiltinAgentsEnvironment, StartedDevEnvironment, StopCommandOptions, StoppedDevEnvironment, createElectricCliHandlers, createElectricProgram, formatQuickstartBackendStartedMessage, getElectricCliEnv, resolveCommandPrefix, run };

package/dist/index.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { installCompletions, setupCompletions } from "./completions-B-Lf28Wy.js";
-import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-LZtIfFz1.js";
+import { assertedIdentityHeaders, entityApiPath } from "./entity-api-Dh28Mz7H.js";
+import { resolveAnthropicApiKey$1 as resolveAnthropicApiKey } from "./env-DIhTv987.js";
+import { appendPathToUrl } from "@electric-ax/agents-runtime";
 import { existsSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
 import { hostname, userInfo } from "node:os";
 import { basename, resolve } from "node:path";
@@ -65,11 +67,16 @@ async function ensureAnthropicApiKey(options, io = defaultPromptIO()) {
 		await validate(explicitKey);
 		return explicitKey;
 	}
+	let resolvedKey;
 	try {
-		const key = resolveAnthropicApiKey(options);
-		assertAnthropicApiKeyPrefix(key);
-		await validate(key);
-		return key;
+		resolvedKey = resolveAnthropicApiKey(options);
+	} catch (error) {
+		if (!io.isTTY) throw error;
+	}
+	if (resolvedKey !== void 0) try {
+		assertAnthropicApiKeyPrefix(resolvedKey);
+		await validate(resolvedKey);
+		return resolvedKey;
 	} catch (error) {
 		if (!io.isTTY) throw error;
 		initialError = error;
@@ -133,10 +140,32 @@ var CliError = class extends Error {};
 function getDefaultElectricAgentsIdentity() {
 	return `${userInfo().username}@${hostname()}`;
 }
+function parseElectricAgentsHeaders(raw) {
+	const trimmed = raw?.trim();
+	if (!trimmed) return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(trimmed);
+	} catch {
+		fail(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: expected JSON`);
+	}
+	if (!parsed || typeof parsed !== `object` || Array.isArray(parsed)) fail(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: expected a JSON object`);
+	const headers = new Headers();
+	for (const [name, value] of Object.entries(parsed)) {
+		if (typeof value !== `string`) fail(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: header "${name}" must be a string`);
+		headers.set(name, value);
+	}
+	const normalized = Object.fromEntries(headers.entries());
+	return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
 function getElectricCliEnv(env = process.env) {
+	const explicitIdentity = env.ELECTRIC_AGENTS_IDENTITY?.trim();
 	return {
 		electricAgentsUrl: env.ELECTRIC_AGENTS_URL || DEFAULT_ELECTRIC_AGENTS_URL,
-		electricAgentsIdentity: env.ELECTRIC_AGENTS_IDENTITY || getDefaultElectricAgentsIdentity()
+		electricAgentsIdentity: explicitIdentity || getDefaultElectricAgentsIdentity(),
+		electricAssertedAuthEmail: env.ELECTRIC_ASSERTED_AUTH_EMAIL?.trim() || explicitIdentity || void 0,
+		electricAssertedAuthName: env.ELECTRIC_ASSERTED_AUTH_NAME?.trim(),
+		electricAgentsHeaders: parseElectricAgentsHeaders(env.ELECTRIC_AGENTS_SERVER_HEADERS)
 	};
 }
 function getErrorMessage(error) {
@@ -263,10 +292,13 @@ function resolveCommandPrefix(argv, env = process.env) {
 }
 async function electricAgentsFetch(env, path$1, opts = {}) {
 	try {
-		return await fetch(`${env.electricAgentsUrl}${path$1}`, {
+		return await fetch(appendPathToUrl(env.electricAgentsUrl, path$1), {
 			...opts,
 			headers: {
 				"content-type": `application/json`,
+				...assertedIdentityHeaders(env.electricAssertedAuthEmail),
+				...env.electricAssertedAuthName ? { "x-electric-asserted-name": env.electricAssertedAuthName } : {},
+				...env.electricAgentsHeaders,
 				...opts.headers
 			}
 		});
@@ -341,7 +373,7 @@ async function spawnEntity(env, urlPath, options) {
 	} catch (error) {
 		fail(`--args must be valid JSON: ${getErrorMessage(error)}`);
 	}
-	const res = await electricAgentsFetch(env, urlPath, {
+	const res = await electricAgentsFetch(env, entityApiPath(urlPath), {
 		method: `PUT`,
 		body: JSON.stringify({ args: spawnArgs })
 	});
@@ -358,7 +390,7 @@ async function sendMessage(env, url, message, options) {
 		payload
 	};
 	if (options.type) body.type = options.type;
-	const res = await electricAgentsFetch(env, `${url}/send`, {
+	const res = await electricAgentsFetch(env, entityApiPath(url, `/send`), {
 		method: `POST`,
 		body: JSON.stringify(body)
 	});
@@ -375,11 +407,14 @@ async function observeEntity(env, url, options) {
 		entityUrl: url,
 		baseUrl: env.electricAgentsUrl,
 		identity: env.electricAgentsIdentity,
+		assertedAuthEmail: env.electricAssertedAuthEmail,
+		assertedAuthName: env.electricAssertedAuthName,
+		headers: env.electricAgentsHeaders,
 		initialOffset: options.from
 	});
 }
 async function inspectEntity(env, url) {
-	const res = await electricAgentsFetch(env, url);
+	const res = await electricAgentsFetch(env, entityApiPath(url));
 	const data = await parseJsonResponse(res);
 	if (!res.ok) failFromResponse(data, res);
 	console.log(JSON.stringify(data, null, 2));
@@ -404,7 +439,7 @@ async function listEntities(env, options) {
 	}
 }
 async function killEntity(env, url) {
-	const res = await electricAgentsFetch(env, url, { method: `DELETE` });
+	const res = await electricAgentsFetch(env, entityApiPath(url), { method: `DELETE` });
 	if (!res.ok) {
 		const data = await parseJsonResponse(res);
 		failFromResponse(data, res);