electric-ax 0.1.17 → 0.2.0

package/dist/observe-ui.cjs

@@ -1,6 +1,7 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_entity_stream_db = require('./entity-stream-db-Djo-7a11.cjs');
+const require_entity_api = require('./entity-api-ClpnLxWJ.cjs');
+const require_entity_stream_db = require('./entity-stream-db-BLbPedyR.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"));
 const react = require_chunk.__toESM(require("react"));
@@ -118,7 +119,7 @@ function ToolResultView({ result }) {
 		}) : null]
 	});
 }
-function MessageInput({ db, baseUrl, entityUrl, identity, disabled }) {
+function MessageInput({ db, baseUrl, entityUrl, identity, assertedAuthEmail, assertedAuthName, headers, disabled }) {
 	const [value, setValue] = (0, react.useState)(``);
 	const [error, setError] = (0, react.useState)(null);
 	const sendAction = (0, react.useMemo)(() => (0, __durable_streams_state.createOptimisticAction)({
@@ -131,9 +132,14 @@ function MessageInput({ db, baseUrl, entityUrl, identity, disabled }) {
 			});
 		},
 		mutationFn: async ({ text }) => {
-			const res = await fetch(`${baseUrl}${entityUrl}/send`, {
+			const res = await fetch(require_entity_api.entityApiUrl(baseUrl, entityUrl, `/send`), {
 				method: `POST`,
-				headers: { "content-type": `application/json` },
+				headers: {
+					"content-type": `application/json`,
+					...require_entity_api.assertedIdentityHeaders(assertedAuthEmail),
+					...assertedAuthName ? { "x-electric-asserted-name": assertedAuthName } : {},
+					...headers
+				},
 				body: JSON.stringify({
 					from: identity,
 					payload: { text }
@@ -157,7 +163,10 @@ function MessageInput({ db, baseUrl, entityUrl, identity, disabled }) {
 		db,
 		baseUrl,
 		entityUrl,
-		identity
+		identity,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers
 	]);
 	(0, ink.useInput)((input, key) => {
 		if (disabled) return;
@@ -231,7 +240,32 @@ function AgentResponseView({ section, label, isStreaming }) {
 		]
 	});
 }
-function ObserveView({ db, entityUrl, baseUrl, identity }) {
+function wakeReason(section) {
+	const { payload } = section;
+	if (payload.timeout) return `timeout`;
+	if (payload.finished_child) return `child ${payload.finished_child.run_status}`;
+	if (payload.changes.length > 0) return `${payload.changes.length} ${payload.changes.length === 1 ? `change` : `changes`}`;
+	if (payload.other_children && payload.other_children.length > 0) return `${payload.other_children.length} child ${payload.other_children.length === 1 ? `update` : `updates`}`;
+	return payload.source;
+}
+function WakeView({ section }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Box, {
+		flexDirection: "column",
+		marginTop: 1,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ink.Text, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+			bold: true,
+			color: "magenta",
+			children: `┌ wake`
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+			dimColor: true,
+			children: `  ${formatTime(new Date(section.timestamp).toISOString())}`
+		})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Text, {
+			dimColor: true,
+			children: `│ ${wakeReason(section)} from ${section.payload.source}`
+		})]
+	});
+}
+function ObserveView({ db, entityUrl, baseUrl, identity, assertedAuthEmail, assertedAuthName, headers }) {
 	const timelineQuery = (0, react.useMemo)(() => (0, __electric_ax_agents_runtime.createEntityIncludesQuery)(db), [db]);
 	const { data: timelineRows = [] } = (0, __tanstack_react_db.useLiveQuery)(timelineQuery, [timelineQuery]);
 	const timelineData = (0, __electric_ax_agents_runtime.normalizeEntityTimelineData)(timelineRows[0] ?? {
@@ -276,6 +310,7 @@ function ObserveView({ db, entityUrl, baseUrl, identity }) {
 							payload: { text: section.text },
 							timestamp: new Date(section.timestamp).toISOString()
 						} }, `msg-${i}`);
+						if (section.kind === `wake`) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(WakeView, { section }, `wake-${i}`);
 						return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AgentResponseView, {
 							section,
 							label: entityUrl,
@@ -303,12 +338,15 @@ function ObserveView({ db, entityUrl, baseUrl, identity }) {
 				baseUrl,
 				entityUrl,
 				identity,
+				assertedAuthEmail,
+				assertedAuthName,
+				headers,
 				disabled: closed
 			})
 		]
 	});
 }
-function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
+function ObserveApp({ entityUrl, baseUrl, identity, assertedAuthEmail, assertedAuthName, headers, initialOffset }) {
 	const [db, setDb] = (0, react.useState)(null);
 	const [error, setError] = (0, react.useState)(null);
 	const closeRef = (0, react.useRef)(null);
@@ -317,7 +355,10 @@ function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
 		require_entity_stream_db.createEntityStreamDB({
 			baseUrl,
 			entityUrl,
-			initialOffset
+			initialOffset,
+			assertedAuthEmail,
+			assertedAuthName,
+			headers
 		}).then((result) => {
 			if (cancelled) {
 				result.close();
@@ -335,7 +376,10 @@ function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
 	}, [
 		baseUrl,
 		entityUrl,
-		initialOffset
+		initialOffset,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers
 	]);
 	if (error) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ink.Box, {
 		flexDirection: "column",
@@ -352,15 +396,21 @@ function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
 		db,
 		entityUrl,
 		baseUrl,
-		identity
+		identity,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers
 	});
 }
 function renderObserve(opts) {
-	const { entityUrl, baseUrl, identity, initialOffset } = opts;
+	const { entityUrl, baseUrl, identity, assertedAuthEmail, assertedAuthName, headers, initialOffset } = opts;
 	const app = (0, ink.render)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ObserveApp, {
 		entityUrl,
 		baseUrl,
 		identity,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers,
 		initialOffset
 	}));
 	process.on(`SIGINT`, () => {

package/dist/observe-ui.d.cts

@@ -1,4 +1,4 @@
-import { EntityStreamDB } from "./entity-stream-db-C2C3t_hD.cjs";
+import { EntityStreamDB } from "./entity-stream-db-CmDwc49J.cjs";
 import { EntityTimelineContentItem, MessageReceived } from "@electric-ax/agents-runtime";
 import React from "react";
 
@@ -40,18 +40,27 @@ declare function MessageInput({
   baseUrl,
   entityUrl,
   identity,
+  assertedAuthEmail,
+  assertedAuthName,
+  headers,
   disabled
 }: {
   db: EntityStreamDB;
   baseUrl: string;
   entityUrl: string;
   identity: string;
+  assertedAuthEmail?: string;
+  assertedAuthName?: string;
+  headers?: Record<string, string>;
   disabled: boolean;
 }): React.ReactElement;
 declare function renderObserve(opts: {
   entityUrl: string;
   baseUrl: string;
   identity: string;
+  assertedAuthEmail?: string;
+  assertedAuthName?: string;
+  headers?: Record<string, string>;
   initialOffset?: string;
 }): void;
 

package/dist/observe-ui.d.ts

@@ -1,4 +1,4 @@
-import { EntityStreamDB } from "./entity-stream-db-BRwzIuHl.js";
+import { EntityStreamDB } from "./entity-stream-db-DgzxI6C_.js";
 import { EntityTimelineContentItem, MessageReceived } from "@electric-ax/agents-runtime";
 import React from "react";
 
@@ -40,18 +40,27 @@ declare function MessageInput({
   baseUrl,
   entityUrl,
   identity,
+  assertedAuthEmail,
+  assertedAuthName,
+  headers,
   disabled
 }: {
   db: EntityStreamDB;
   baseUrl: string;
   entityUrl: string;
   identity: string;
+  assertedAuthEmail?: string;
+  assertedAuthName?: string;
+  headers?: Record<string, string>;
   disabled: boolean;
 }): React.ReactElement;
 declare function renderObserve(opts: {
   entityUrl: string;
   baseUrl: string;
   identity: string;
+  assertedAuthEmail?: string;
+  assertedAuthName?: string;
+  headers?: Record<string, string>;
   initialOffset?: string;
 }): void;
 

package/dist/observe-ui.js

@@ -1,4 +1,5 @@
-import { createEntityStreamDB } from "./entity-stream-db-CGP2xVeJ.js";
+import { assertedIdentityHeaders, entityApiUrl } from "./entity-api-Dh28Mz7H.js";
+import { createEntityStreamDB } from "./entity-stream-db-Czz3S8YF.js";
 import { createOptimisticAction } from "@durable-streams/state";
 import { buildSections, createEntityIncludesQuery, normalizeEntityTimelineData } from "@electric-ax/agents-runtime";
 import React, { useEffect, useMemo, useRef, useState } from "react";
@@ -116,7 +117,7 @@ function ToolResultView({ result }) {
 		}) : null]
 	});
 }
-function MessageInput({ db, baseUrl, entityUrl, identity, disabled }) {
+function MessageInput({ db, baseUrl, entityUrl, identity, assertedAuthEmail, assertedAuthName, headers, disabled }) {
 	const [value, setValue] = useState(``);
 	const [error, setError] = useState(null);
 	const sendAction = useMemo(() => createOptimisticAction({
@@ -129,9 +130,14 @@ function MessageInput({ db, baseUrl, entityUrl, identity, disabled }) {
 			});
 		},
 		mutationFn: async ({ text }) => {
-			const res = await fetch(`${baseUrl}${entityUrl}/send`, {
+			const res = await fetch(entityApiUrl(baseUrl, entityUrl, `/send`), {
 				method: `POST`,
-				headers: { "content-type": `application/json` },
+				headers: {
+					"content-type": `application/json`,
+					...assertedIdentityHeaders(assertedAuthEmail),
+					...assertedAuthName ? { "x-electric-asserted-name": assertedAuthName } : {},
+					...headers
+				},
 				body: JSON.stringify({
 					from: identity,
 					payload: { text }
@@ -155,7 +161,10 @@ function MessageInput({ db, baseUrl, entityUrl, identity, disabled }) {
 		db,
 		baseUrl,
 		entityUrl,
-		identity
+		identity,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers
 	]);
 	useInput((input, key) => {
 		if (disabled) return;
@@ -229,7 +238,32 @@ function AgentResponseView({ section, label, isStreaming }) {
 		]
 	});
 }
-function ObserveView({ db, entityUrl, baseUrl, identity }) {
+function wakeReason(section) {
+	const { payload } = section;
+	if (payload.timeout) return `timeout`;
+	if (payload.finished_child) return `child ${payload.finished_child.run_status}`;
+	if (payload.changes.length > 0) return `${payload.changes.length} ${payload.changes.length === 1 ? `change` : `changes`}`;
+	if (payload.other_children && payload.other_children.length > 0) return `${payload.other_children.length} child ${payload.other_children.length === 1 ? `update` : `updates`}`;
+	return payload.source;
+}
+function WakeView({ section }) {
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		marginTop: 1,
+		children: [/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			color: "magenta",
+			children: `┌ wake`
+		}), /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: `  ${formatTime(new Date(section.timestamp).toISOString())}`
+		})] }), /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: `│ ${wakeReason(section)} from ${section.payload.source}`
+		})]
+	});
+}
+function ObserveView({ db, entityUrl, baseUrl, identity, assertedAuthEmail, assertedAuthName, headers }) {
 	const timelineQuery = useMemo(() => createEntityIncludesQuery(db), [db]);
 	const { data: timelineRows = [] } = useLiveQuery(timelineQuery, [timelineQuery]);
 	const timelineData = normalizeEntityTimelineData(timelineRows[0] ?? {
@@ -274,6 +308,7 @@ function ObserveView({ db, entityUrl, baseUrl, identity }) {
 							payload: { text: section.text },
 							timestamp: new Date(section.timestamp).toISOString()
 						} }, `msg-${i}`);
+						if (section.kind === `wake`) return /* @__PURE__ */ jsx(WakeView, { section }, `wake-${i}`);
 						return /* @__PURE__ */ jsx(AgentResponseView, {
 							section,
 							label: entityUrl,
@@ -301,12 +336,15 @@ function ObserveView({ db, entityUrl, baseUrl, identity }) {
 				baseUrl,
 				entityUrl,
 				identity,
+				assertedAuthEmail,
+				assertedAuthName,
+				headers,
 				disabled: closed
 			})
 		]
 	});
 }
-function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
+function ObserveApp({ entityUrl, baseUrl, identity, assertedAuthEmail, assertedAuthName, headers, initialOffset }) {
 	const [db, setDb] = useState(null);
 	const [error, setError] = useState(null);
 	const closeRef = useRef(null);
@@ -315,7 +353,10 @@ function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
 		createEntityStreamDB({
 			baseUrl,
 			entityUrl,
-			initialOffset
+			initialOffset,
+			assertedAuthEmail,
+			assertedAuthName,
+			headers
 		}).then((result) => {
 			if (cancelled) {
 				result.close();
@@ -333,7 +374,10 @@ function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
 	}, [
 		baseUrl,
 		entityUrl,
-		initialOffset
+		initialOffset,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers
 	]);
 	if (error) return /* @__PURE__ */ jsx(Box, {
 		flexDirection: "column",
@@ -350,15 +394,21 @@ function ObserveApp({ entityUrl, baseUrl, identity, initialOffset }) {
 		db,
 		entityUrl,
 		baseUrl,
-		identity
+		identity,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers
 	});
 }
 function renderObserve(opts) {
-	const { entityUrl, baseUrl, identity, initialOffset } = opts;
+	const { entityUrl, baseUrl, identity, assertedAuthEmail, assertedAuthName, headers, initialOffset } = opts;
 	const app = render(/* @__PURE__ */ jsx(ObserveApp, {
 		entityUrl,
 		baseUrl,
 		identity,
+		assertedAuthEmail,
+		assertedAuthName,
+		headers,
 		initialOffset
 	}));
 	process.on(`SIGINT`, () => {

package/dist/start.cjs

@@ -1,6 +1,7 @@
 "use strict";
 const require_chunk = require('./chunk-BCwAaXi7.cjs');
-const require_env = require('./env-BXUgom_C.cjs');
+const require_env = require('./env-CFKgT8o2.cjs');
+const __electric_ax_agents_runtime = require_chunk.__toESM(require("@electric-ax/agents-runtime"));
 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"));
@@ -19,19 +20,11 @@ const ELECTRIC_AGENTS_SERVER_IMAGE_TAG = `latest`;
 //#endregion
 //#region src/start.ts
 const DEFAULT_ELECTRIC_AGENTS_PORT = 4437;
-const DEFAULT_BUILTIN_AGENTS_PORT = 4448;
-const DEFAULT_BUILTIN_AGENTS_HOST = `0.0.0.0`;
 const DEFAULT_COMPOSE_PROJECT_NAME = `electric-agents`;
+const DEFAULT_PULL_WAKE_RUNNER_ID = `builtin-agents`;
+const DEFAULT_PULL_WAKE_OWNER_ID = `builtin-agents`;
+const DEFAULT_PULL_WAKE_OWNER_NAME = `Built-in agents`;
 const DOCKER_COMPOSE_FILE = (0, node_url.fileURLToPath)(new URL(`../docker-compose.full.yml`, require("url").pathToFileURL(__filename).href));
-function resolveBuiltinAgentsPort(env = process.env, fileEnv = require_env.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 resolveBuiltinAgentsHost(env = process.env, fileEnv = require_env.readDotEnvFile()) {
-	return env.ELECTRIC_AGENTS_BUILTIN_HOST?.trim() || fileEnv.ELECTRIC_AGENTS_BUILTIN_HOST?.trim() || DEFAULT_BUILTIN_AGENTS_HOST;
-}
 function resolveElectricAgentsPort(env = process.env, fileEnv = require_env.readDotEnvFile()) {
 	const raw = env.ELECTRIC_AGENTS_PORT?.trim() || fileEnv.ELECTRIC_AGENTS_PORT?.trim();
 	const parsed = raw ? Number(raw) : DEFAULT_ELECTRIC_AGENTS_PORT;
@@ -54,12 +47,73 @@ function getStoppedEnvironmentMessage(stopped) {
 }
 function getStartedBuiltinAgentsMessage(started) {
 	return [
-		`Builtin Horton server is up.`,
-		`Webhook server: ${started.url}`,
+		`Builtin agents pull-wake runner is up.`,
+		`Runner: ${started.runnerId}`,
+		`Runtime: ${started.url}`,
 		`Registers with: ${started.agentServerUrl}`,
 		`Press Ctrl-C to stop.`
 	].join(`\n`);
 }
+function readConfigValue(env, fileEnv, names) {
+	for (const name of names) {
+		const value = env[name]?.trim() || fileEnv[name]?.trim();
+		if (value) return value;
+	}
+	return void 0;
+}
+function runnerIdFromIdentity(identity) {
+	if (!identity) return DEFAULT_PULL_WAKE_RUNNER_ID;
+	const slug = identity.toLowerCase().replace(/[^a-z0-9._-]+/g, `-`).replace(/^-+|-+$/g, ``);
+	return slug ? `builtin-${slug}` : DEFAULT_PULL_WAKE_RUNNER_ID;
+}
+function resolvePullWakeRunnerId(env = process.env, fileEnv = require_env.readDotEnvFile()) {
+	return readConfigValue(env, fileEnv, [`ELECTRIC_AGENTS_PULL_WAKE_RUNNER_ID`, `PULL_WAKE_RUNNER_ID`]) ?? runnerIdFromIdentity(readConfigValue(env, fileEnv, [`ELECTRIC_ASSERTED_AUTH_EMAIL`, `ELECTRIC_AGENTS_IDENTITY`]));
+}
+function resolvePullWakeOwnerId(env = process.env, fileEnv = require_env.readDotEnvFile()) {
+	return readConfigValue(env, fileEnv, [`ELECTRIC_ASSERTED_AUTH_EMAIL`, `ELECTRIC_AGENTS_IDENTITY`]) ?? DEFAULT_PULL_WAKE_OWNER_ID;
+}
+function buildAssertedAuthHeaders(env, fileEnv) {
+	const email = resolvePullWakeOwnerId(env, fileEnv);
+	const name = readConfigValue(env, fileEnv, [`ELECTRIC_ASSERTED_AUTH_NAME`]) ?? DEFAULT_PULL_WAKE_OWNER_NAME;
+	const headers = {};
+	headers[`X-Electric-Asserted-Email`] = email;
+	headers[`X-Electric-Asserted-Name`] = name;
+	return {
+		headers,
+		ownerUserId: email,
+		name
+	};
+}
+function parseAdditionalServerHeaders(env, fileEnv) {
+	const raw = readConfigValue(env, fileEnv, [`ELECTRIC_AGENTS_SERVER_HEADERS`]);
+	if (!raw) return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		throw new Error(`Invalid ELECTRIC_AGENTS_SERVER_HEADERS: expected JSON`);
+	}
+	if (!parsed || typeof parsed !== `object` || Array.isArray(parsed)) throw new Error(`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`) throw new Error(`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 mergeHeaders(...sources) {
+	const headers = new Headers();
+	for (const source of sources) {
+		if (!source) continue;
+		new Headers(source).forEach((value, key) => headers.set(key, value));
+	}
+	const merged = Object.fromEntries(headers.entries());
+	return Object.keys(merged).length > 0 ? merged : void 0;
+}
+function hasHeader(headers, name) {
+	return headers ? new Headers(headers).has(name) : false;
+}
 function resolveComposeProjectName(_cwd = process.cwd(), env = process.env) {
 	const explicit = env.ELECTRIC_AGENTS_COMPOSE_PROJECT?.trim();
 	if (explicit) return explicit;
@@ -94,11 +148,14 @@ async function waitForElectricAgentsServer(baseUrl, options = {}) {
 	const timeoutMs = options.timeoutMs ?? 6e4;
 	const intervalMs = options.intervalMs ?? 1e3;
 	const deadline = Date.now() + timeoutMs;
-	const healthUrl = `${baseUrl.replace(/\/$/, ``)}/_electric/health`;
+	const healthUrl = (0, __electric_ax_agents_runtime.appendPathToUrl)(baseUrl, `/_electric/health`);
 	let lastError = null;
 	while (Date.now() < deadline) {
 		try {
-			const response = await fetchImpl(healthUrl, { signal: AbortSignal.timeout(5e3) });
+			const response = await fetchImpl(healthUrl, {
+				headers: options.headers,
+				signal: AbortSignal.timeout(5e3)
+			});
 			if (response.ok) return;
 			lastError = `healthcheck returned ${response.status}`;
 		} catch (error) {
@@ -112,6 +169,7 @@ async function startElectricAgentsDevEnvironment(_options = {}, env = process.en
 	const fileEnv = require_env.readDotEnvFile(cwd);
 	const port = resolveElectricAgentsPort(env, fileEnv);
 	const composeProjectName = resolveComposeProjectName(cwd, env);
+	const assertedAuth = buildAssertedAuthHeaders(env, fileEnv);
 	await runDockerCompose([
 		`compose`,
 		`-f`,
@@ -123,7 +181,10 @@ async function startElectricAgentsDevEnvironment(_options = {}, env = process.en
 		COMPOSE_PROJECT_NAME: composeProjectName,
 		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
+		ELECTRIC_AGENTS_SERVER_IMAGE_TAG: env.ELECTRIC_AGENTS_SERVER_IMAGE_TAG ?? ELECTRIC_AGENTS_SERVER_IMAGE_TAG,
+		ELECTRIC_AGENTS_DEV_ASSERTED_AUTH: env.ELECTRIC_AGENTS_DEV_ASSERTED_AUTH ?? fileEnv.ELECTRIC_AGENTS_DEV_ASSERTED_AUTH ?? `1`,
+		ELECTRIC_ASSERTED_AUTH_EMAIL: env.ELECTRIC_ASSERTED_AUTH_EMAIL ?? fileEnv.ELECTRIC_ASSERTED_AUTH_EMAIL ?? assertedAuth.ownerUserId,
+		ELECTRIC_ASSERTED_AUTH_NAME: env.ELECTRIC_ASSERTED_AUTH_NAME ?? fileEnv.ELECTRIC_ASSERTED_AUTH_NAME ?? assertedAuth.name
 	});
 	const uiUrl = `http://localhost:${port}`;
 	await waitForElectricAgentsServer(uiUrl);
@@ -181,22 +242,29 @@ async function startBuiltinAgentsServer(options, params = {}) {
 	const cwd = params.cwd ?? process.cwd();
 	const fileEnv = require_env.readDotEnvFile(cwd);
 	const anthropicApiKey = require_env.resolveAnthropicApiKey(options, env, fileEnv);
-	const host = resolveBuiltinAgentsHost(env, fileEnv);
-	const port = resolveBuiltinAgentsPort(env, fileEnv);
+	const runnerId = resolvePullWakeRunnerId(env, fileEnv);
+	const assertedAuth = buildAssertedAuthHeaders(env, fileEnv);
+	const serverHeaders = mergeHeaders(assertedAuth.headers, parseAdditionalServerHeaders(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);
+	await waitForElectricAgentsServer(agentServerUrl, { headers: serverHeaders });
 	const server = new __electric_ax_agents.BuiltinAgentsServer({
 		agentServerUrl,
-		host,
-		port,
-		workingDirectory: cwd
+		workingDirectory: cwd,
+		loadProjectMcpConfig: true,
+		pullWake: {
+			runnerId,
+			ownerUserId: assertedAuth.ownerUserId,
+			registerRunner: true,
+			headers: serverHeaders,
+			claimHeaders: serverHeaders,
+			claimTokenHeader: hasHeader(serverHeaders, `authorization`) ? `electric-claim-token` : void 0
+		}
 	});
-	await server.start();
+	const url = await server.start();
 	const started = {
-		port,
-		url: server.url,
-		registeredBaseUrl: server.registeredBaseUrl,
+		runnerId,
+		url,
 		agentServerUrl
 	};
 	if (params.printStartedMessage ?? true) console.log(getStartedBuiltinAgentsMessage(started));
@@ -210,10 +278,10 @@ exports.getStartedEnvironmentMessage = getStartedEnvironmentMessage
 exports.getStoppedEnvironmentMessage = getStoppedEnvironmentMessage
 exports.readDotEnvFile = require_env.readDotEnvFile
 exports.resolveAnthropicApiKey = require_env.resolveAnthropicApiKey
-exports.resolveBuiltinAgentsHost = resolveBuiltinAgentsHost
-exports.resolveBuiltinAgentsPort = resolveBuiltinAgentsPort
 exports.resolveComposeProjectName = resolveComposeProjectName
 exports.resolveElectricAgentsPort = resolveElectricAgentsPort
+exports.resolvePullWakeOwnerId = resolvePullWakeOwnerId
+exports.resolvePullWakeRunnerId = resolvePullWakeRunnerId
 exports.startBuiltinAgentsServer = startBuiltinAgentsServer
 exports.startElectricAgentsDevEnvironment = startElectricAgentsDevEnvironment
 exports.stopElectricAgentsDevEnvironment = stopElectricAgentsDevEnvironment

package/dist/start.d.cts

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

package/dist/start.d.ts

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