@electric-ax/agents 0.4.0 → 0.4.1

package/dist/entrypoint.js

@@ -625,8 +625,8 @@ function createHortonDocsSupport(workingDirectory, opts = {}) {
 		logPrefix: `[horton-docs]`
 	});
 	function resolveCurrentQuestion(wake, events, inbox) {
-		if (wake.type === `message_received`) {
-			const eventQuestion = findLatestQuestion(events.filter((event) => event.type === `message_received`).map((event) => event.value));
+		if (wake.type === `inbox`) {
+			const eventQuestion = findLatestQuestion(events.filter((event) => event.type === `inbox`).map((event) => event.value));
 			if (eventQuestion) return eventQuestion;
 		}
 		const wakeQuestion = payloadToText(wake.payload).trim();
@@ -1426,7 +1426,8 @@ function registerHorton(registry, options) {
 	const { workingDirectory, streamFn, skillsRegistry = null, modelCatalog } = options;
 	const docsUrl = options.docsUrl ?? process.env.HORTON_DOCS_URL;
 	if (process.env.BRAVE_SEARCH_API_KEY) serverLog.info(`[horton] Web search: using Brave Search API`);
-	else serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY not set — web search will fall back to Anthropic built-in search (uses your ANTHROPIC_API_KEY)`);
+	else if (process.env.ANTHROPIC_API_KEY) serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY not set — web search will fall back to Anthropic built-in search`);
+	else serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY and ANTHROPIC_API_KEY not set — web search tool will be unavailable`);
 	const docsSupport = createHortonDocsSupport(workingDirectory);
 	const docsSearchTool = docsSupport?.createSearchTool();
 	docsSupport?.ensureReady().catch((error) => {
@@ -1902,7 +1903,7 @@ function truncate(str, max) {
 //#endregion
 //#region src/bootstrap.ts
 async function createBuiltinAgentHandler(options) {
-	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, serverHeaders, defaultDispatchPolicyForType } = options;
+	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
 	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
 	if (!modelCatalog) {
 		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY or OPENAI_API_KEY`);
@@ -1910,7 +1911,7 @@ async function createBuiltinAgentHandler(options) {
 	}
 	const cwd = workingDirectory ?? process.cwd();
 	const here = path.dirname(fileURLToPath(import.meta.url));
-	const baseSkillsDir = path.resolve(here, `../skills`);
+	const baseSkillsDir = baseSkillsDirOverride ?? path.resolve(here, `../skills`);
 	let skillsRegistry = null;
 	try {
 		skillsRegistry = await createSkillsRegistry({
@@ -2098,6 +2099,7 @@ var BuiltinAgentsServer = class {
 				createElectricTools: this.options.createElectricTools,
 				publicUrl,
 				runtimeName: `builtin-agents`,
+				baseSkillsDir: this.options.baseSkillsDir,
 				serverHeaders: pullWake.headers
 			});
 			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY or OPENAI_API_KEY must be set before starting builtin agents`);
@@ -2203,14 +2205,6 @@ function validateUrl(name, value) {
 		throw new Error(`Invalid ${name}: "${value}"`);
 	}
 }
-function buildAssertedAuthHeaders(env) {
-	const headers = {};
-	const email = readEnv(env, [`ELECTRIC_ASSERTED_AUTH_EMAIL`]);
-	const name = readEnv(env, [`ELECTRIC_ASSERTED_AUTH_NAME`]);
-	if (email) headers[`X-Electric-Asserted-Email`] = email;
-	if (name) headers[`X-Electric-Asserted-Name`] = name;
-	return Object.keys(headers).length > 0 ? headers : void 0;
-}
 function parseAdditionalServerHeaders(env) {
 	const raw = readEnv(env, [`ELECTRIC_AGENTS_SERVER_HEADERS`]);
 	if (!raw) return void 0;
@@ -2244,7 +2238,7 @@ function hasHeader(headers, name) {
 function resolveBuiltinAgentsEntrypointOptions(env = process.env, cwd = process.cwd()) {
 	const agentServerUrl = validateUrl(`agent server URL`, readRequiredEnv(env, [`ELECTRIC_AGENTS_SERVER_URL`, `ELECTRIC_AGENTS_BASE_URL`], `agent server base URL`));
 	const runnerId = readRequiredEnv(env, [`ELECTRIC_AGENTS_PULL_WAKE_RUNNER_ID`, `PULL_WAKE_RUNNER_ID`], `pull-wake runner id`);
-	const serverHeaders = mergeHeaders(buildAssertedAuthHeaders(env), parseAdditionalServerHeaders(env));
+	const serverHeaders = mergeHeaders(parseAdditionalServerHeaders(env));
 	return {
 		agentServerUrl,
 		workingDirectory: readEnv(env, [`ELECTRIC_AGENTS_WORKING_DIRECTORY`, `WORKING_DIRECTORY`]) ?? cwd,

package/dist/index.cjs

@@ -648,8 +648,8 @@ function createHortonDocsSupport(workingDirectory, opts = {}) {
 		logPrefix: `[horton-docs]`
 	});
 	function resolveCurrentQuestion(wake, events, inbox) {
-		if (wake.type === `message_received`) {
-			const eventQuestion = findLatestQuestion(events.filter((event) => event.type === `message_received`).map((event) => event.value));
+		if (wake.type === `inbox`) {
+			const eventQuestion = findLatestQuestion(events.filter((event) => event.type === `inbox`).map((event) => event.value));
 			if (eventQuestion) return eventQuestion;
 		}
 		const wakeQuestion = payloadToText(wake.payload).trim();
@@ -1450,7 +1450,8 @@ function registerHorton(registry, options) {
 	const { workingDirectory, streamFn, skillsRegistry = null, modelCatalog } = options;
 	const docsUrl = options.docsUrl ?? process.env.HORTON_DOCS_URL;
 	if (process.env.BRAVE_SEARCH_API_KEY) serverLog.info(`[horton] Web search: using Brave Search API`);
-	else serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY not set — web search will fall back to Anthropic built-in search (uses your ANTHROPIC_API_KEY)`);
+	else if (process.env.ANTHROPIC_API_KEY) serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY not set — web search will fall back to Anthropic built-in search`);
+	else serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY and ANTHROPIC_API_KEY not set — web search tool will be unavailable`);
 	const docsSupport = createHortonDocsSupport(workingDirectory);
 	const docsSearchTool = docsSupport?.createSearchTool();
 	docsSupport?.ensureReady().catch((error) => {
@@ -1927,7 +1928,7 @@ function truncate(str, max) {
 //#region src/bootstrap.ts
 const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = `/_electric/builtin-agent-handler`;
 async function createBuiltinAgentHandler(options) {
-	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, serverHeaders, defaultDispatchPolicyForType } = options;
+	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
 	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
 	if (!modelCatalog) {
 		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY or OPENAI_API_KEY`);
@@ -1935,7 +1936,7 @@ async function createBuiltinAgentHandler(options) {
 	}
 	const cwd = workingDirectory ?? process.cwd();
 	const here = node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
-	const baseSkillsDir = node_path.default.resolve(here, `../skills`);
+	const baseSkillsDir = baseSkillsDirOverride ?? node_path.default.resolve(here, `../skills`);
 	let skillsRegistry = null;
 	try {
 		skillsRegistry = await createSkillsRegistry({
@@ -2133,6 +2134,7 @@ var BuiltinAgentsServer = class {
 				createElectricTools: this.options.createElectricTools,
 				publicUrl,
 				runtimeName: `builtin-agents`,
+				baseSkillsDir: this.options.baseSkillsDir,
 				serverHeaders: pullWake.headers
 			});
 			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY or OPENAI_API_KEY must be set before starting builtin agents`);
@@ -2238,14 +2240,6 @@ function validateUrl(name, value) {
 		throw new Error(`Invalid ${name}: "${value}"`);
 	}
 }
-function buildAssertedAuthHeaders(env) {
-	const headers = {};
-	const email = readEnv(env, [`ELECTRIC_ASSERTED_AUTH_EMAIL`]);
-	const name = readEnv(env, [`ELECTRIC_ASSERTED_AUTH_NAME`]);
-	if (email) headers[`X-Electric-Asserted-Email`] = email;
-	if (name) headers[`X-Electric-Asserted-Name`] = name;
-	return Object.keys(headers).length > 0 ? headers : void 0;
-}
 function parseAdditionalServerHeaders(env) {
 	const raw = readEnv(env, [`ELECTRIC_AGENTS_SERVER_HEADERS`]);
 	if (!raw) return void 0;
@@ -2279,7 +2273,7 @@ function hasHeader(headers, name) {
 function resolveBuiltinAgentsEntrypointOptions(env = process.env, cwd = process.cwd()) {
 	const agentServerUrl = validateUrl(`agent server URL`, readRequiredEnv(env, [`ELECTRIC_AGENTS_SERVER_URL`, `ELECTRIC_AGENTS_BASE_URL`], `agent server base URL`));
 	const runnerId = readRequiredEnv(env, [`ELECTRIC_AGENTS_PULL_WAKE_RUNNER_ID`, `PULL_WAKE_RUNNER_ID`], `pull-wake runner id`);
-	const serverHeaders = mergeHeaders(buildAssertedAuthHeaders(env), parseAdditionalServerHeaders(env));
+	const serverHeaders = mergeHeaders(parseAdditionalServerHeaders(env));
 	return {
 		agentServerUrl,
 		workingDirectory: readEnv(env, [`ELECTRIC_AGENTS_WORKING_DIRECTORY`, `WORKING_DIRECTORY`]) ?? cwd,

package/dist/index.d.cts

@@ -43,6 +43,8 @@ interface BuiltinAgentHandlerOptions {
   streamFn?: StreamFn;
   publicUrl?: string;
   runtimeName?: string;
+  /** Override for the built-in skills directory; required when embedders bundle this package. */
+  baseSkillsDir?: string;
   serverHeaders?: HeadersProvider;
   defaultDispatchPolicyForType?: (typeName: string) => DispatchPolicy | undefined;
   createElectricTools?: (context: {
@@ -125,6 +127,8 @@ interface BuiltinAgentsServerOptions {
    * so the embedder must opt in.
    */
   loadProjectMcpConfig?: boolean;
+  /** Override for the built-in skills directory; required when embedders bundle this package. */
+  baseSkillsDir?: string;
   createElectricTools?: (context: {
     entityUrl: string;
     entityType: string;

package/dist/index.d.ts

@@ -43,6 +43,8 @@ interface BuiltinAgentHandlerOptions {
   streamFn?: StreamFn;
   publicUrl?: string;
   runtimeName?: string;
+  /** Override for the built-in skills directory; required when embedders bundle this package. */
+  baseSkillsDir?: string;
   serverHeaders?: HeadersProvider;
   defaultDispatchPolicyForType?: (typeName: string) => DispatchPolicy | undefined;
   createElectricTools?: (context: {
@@ -125,6 +127,8 @@ interface BuiltinAgentsServerOptions {
    * so the embedder must opt in.
    */
   loadProjectMcpConfig?: boolean;
+  /** Override for the built-in skills directory; required when embedders bundle this package. */
+  baseSkillsDir?: string;
   createElectricTools?: (context: {
     entityUrl: string;
     entityType: string;

package/dist/index.js

@@ -624,8 +624,8 @@ function createHortonDocsSupport(workingDirectory, opts = {}) {
 		logPrefix: `[horton-docs]`
 	});
 	function resolveCurrentQuestion(wake, events, inbox) {
-		if (wake.type === `message_received`) {
-			const eventQuestion = findLatestQuestion(events.filter((event) => event.type === `message_received`).map((event) => event.value));
+		if (wake.type === `inbox`) {
+			const eventQuestion = findLatestQuestion(events.filter((event) => event.type === `inbox`).map((event) => event.value));
 			if (eventQuestion) return eventQuestion;
 		}
 		const wakeQuestion = payloadToText(wake.payload).trim();
@@ -1426,7 +1426,8 @@ function registerHorton(registry, options) {
 	const { workingDirectory, streamFn, skillsRegistry = null, modelCatalog } = options;
 	const docsUrl = options.docsUrl ?? process.env.HORTON_DOCS_URL;
 	if (process.env.BRAVE_SEARCH_API_KEY) serverLog.info(`[horton] Web search: using Brave Search API`);
-	else serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY not set — web search will fall back to Anthropic built-in search (uses your ANTHROPIC_API_KEY)`);
+	else if (process.env.ANTHROPIC_API_KEY) serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY not set — web search will fall back to Anthropic built-in search`);
+	else serverLog.warn(`[horton] BRAVE_SEARCH_API_KEY and ANTHROPIC_API_KEY not set — web search tool will be unavailable`);
 	const docsSupport = createHortonDocsSupport(workingDirectory);
 	const docsSearchTool = docsSupport?.createSearchTool();
 	docsSupport?.ensureReady().catch((error) => {
@@ -1903,7 +1904,7 @@ function truncate(str, max) {
 //#region src/bootstrap.ts
 const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = `/_electric/builtin-agent-handler`;
 async function createBuiltinAgentHandler(options) {
-	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, serverHeaders, defaultDispatchPolicyForType } = options;
+	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
 	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
 	if (!modelCatalog) {
 		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY or OPENAI_API_KEY`);
@@ -1911,7 +1912,7 @@ async function createBuiltinAgentHandler(options) {
 	}
 	const cwd = workingDirectory ?? process.cwd();
 	const here = path.dirname(fileURLToPath(import.meta.url));
-	const baseSkillsDir = path.resolve(here, `../skills`);
+	const baseSkillsDir = baseSkillsDirOverride ?? path.resolve(here, `../skills`);
 	let skillsRegistry = null;
 	try {
 		skillsRegistry = await createSkillsRegistry({
@@ -2109,6 +2110,7 @@ var BuiltinAgentsServer = class {
 				createElectricTools: this.options.createElectricTools,
 				publicUrl,
 				runtimeName: `builtin-agents`,
+				baseSkillsDir: this.options.baseSkillsDir,
 				serverHeaders: pullWake.headers
 			});
 			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY or OPENAI_API_KEY must be set before starting builtin agents`);
@@ -2214,14 +2216,6 @@ function validateUrl(name, value) {
 		throw new Error(`Invalid ${name}: "${value}"`);
 	}
 }
-function buildAssertedAuthHeaders(env) {
-	const headers = {};
-	const email = readEnv(env, [`ELECTRIC_ASSERTED_AUTH_EMAIL`]);
-	const name = readEnv(env, [`ELECTRIC_ASSERTED_AUTH_NAME`]);
-	if (email) headers[`X-Electric-Asserted-Email`] = email;
-	if (name) headers[`X-Electric-Asserted-Name`] = name;
-	return Object.keys(headers).length > 0 ? headers : void 0;
-}
 function parseAdditionalServerHeaders(env) {
 	const raw = readEnv(env, [`ELECTRIC_AGENTS_SERVER_HEADERS`]);
 	if (!raw) return void 0;
@@ -2255,7 +2249,7 @@ function hasHeader(headers, name) {
 function resolveBuiltinAgentsEntrypointOptions(env = process.env, cwd = process.cwd()) {
 	const agentServerUrl = validateUrl(`agent server URL`, readRequiredEnv(env, [`ELECTRIC_AGENTS_SERVER_URL`, `ELECTRIC_AGENTS_BASE_URL`], `agent server base URL`));
 	const runnerId = readRequiredEnv(env, [`ELECTRIC_AGENTS_PULL_WAKE_RUNNER_ID`, `PULL_WAKE_RUNNER_ID`], `pull-wake runner id`);
-	const serverHeaders = mergeHeaders(buildAssertedAuthHeaders(env), parseAdditionalServerHeaders(env));
+	const serverHeaders = mergeHeaders(parseAdditionalServerHeaders(env));
 	return {
 		agentServerUrl,
 		workingDirectory: readEnv(env, [`ELECTRIC_AGENTS_WORKING_DIRECTORY`, `WORKING_DIRECTORY`]) ?? cwd,

package/docs/index.md

@@ -60,7 +60,7 @@ The function that runs when an entity wakes. Receives a [`HandlerContext`](/docs
 ```ts
 registry.define("support", {
   async handler(ctx, wake) {
-    if (wake.type === "message_received") {
+    if (wake.type === "inbox") {
       ctx.useAgent({
         systemPrompt: "You are a support agent.",
         model: "claude-sonnet-4-5-20250929",
@@ -78,11 +78,11 @@ Events that trigger a handler invocation. Wake sources include incoming messages
 
 ```ts
 async handler(ctx, wake) {
-  // wake.type — "message_received", "wake", etc.
+  // wake.type — "inbox", "wake", etc.
   // wake.source — who triggered the wake
   // wake.payload — message content or wake data
 
-  if (wake.type === "message_received") {
+  if (wake.type === "inbox") {
     const userMessage = wake.payload
     // handle incoming message
   }

package/docs/reference/built-in-collections.md

@@ -23,7 +23,7 @@ Every entity automatically has these 17 collections, populated by the runtime as
 | `toolCalls`        | `tool_call`        | `ToolCall`         | Tool call lifecycle          |
 | `reasoning`        | `reasoning`        | `Reasoning`        | Reasoning block lifecycle    |
 | `errors`           | `error`            | `ErrorEvent`       | Diagnostic errors            |
-| `inbox`            | `message_received` | `MessageReceived`  | Inbound messages             |
+| `inbox`            | `inbox` | `MessageReceived`  | Inbound messages             |
 | `wakes`            | `wake`             | `WakeEntry`        | Wake delivery records        |
 | `entityCreated`    | `entity_created`   | `EntityCreated`    | Entity bootstrap metadata    |
 | `entityStopped`    | `entity_stopped`   | `EntityStopped`    | Entity shutdown signal       |

package/docs/reference/wake-event.md

@@ -30,7 +30,7 @@ type WakeEvent = {
 | Field        | Type      | Description                                                              |
 | ------------ | --------- | ------------------------------------------------------------------------ |
 | `source`     | `string`  | URL or identifier of the stream that triggered the wake.                 |
-| `type`       | `string`  | Wake type. Usually `"message_received"` or `"wake"`; fallback webhook events can use `triggerEvent` or `"message"`. See catalog. |
+| `type`       | `string`  | Wake type. Usually `"inbox"` or `"wake"`; fallback webhook events can use `triggerEvent` or `"message"`. See catalog. |
 | `fromOffset` | `number`  | Start offset of new events in the source stream.                         |
 | `toOffset`   | `number`  | End offset (exclusive) of new events.                                    |
 | `eventCount` | `number`  | Number of new events in this wake.                                       |
@@ -40,9 +40,9 @@ type WakeEvent = {
 
 ## Wake-type catalog
 
-Handlers usually see two values for `wake.type`. Direct inbox messages arrive as `"message_received"`. Most non-message triggers are flattened into `"wake"`, with the specifics carried on `wake.payload`. Low-level webhook fallbacks can surface `triggerEvent` directly, or `"message"` when no trigger event is provided.
+Handlers usually see two values for `wake.type`. Direct inbox messages arrive as `"inbox"`. Most non-message triggers are flattened into `"wake"`, with the specifics carried on `wake.payload`. Low-level webhook fallbacks can surface `triggerEvent` directly, or `"message"` when no trigger event is provided.
 
-### `"message_received"`
+### `"inbox"`
 
 An external message landed in the entity's inbox — from `ctx.send()`, the CLI's `electric agents send`, or any direct `/send` HTTP call.
 
@@ -89,7 +89,7 @@ Inspect the payload to distinguish the sub-kind:
 | Observed change     | `ctx.observe(..., { wake: { on: 'change' } })` or `observe(db(...))`        | `payload.changes` is non-empty                                                            |
 | Shared-state change | `await ctx.observe(db(...), { wake: { on: 'change' } })`                    | `payload.changes` is non-empty, `payload.source` identifies the shared-state stream       |
 | Cron fired          | A cron schedule entry on the entity's manifest                              | `payload.source` identifies the schedule; `payload.changes` is empty                      |
-| Scheduled send      | A `future_send` schedule fires                                              | Arrives as `"message_received"` (not `"wake"`) — the schedule produces a message delivery |
+| Scheduled send      | A `future_send` schedule fires                                              | Arrives as `"inbox"` (not `"wake"`) — the schedule produces a message delivery |
 | Timeout             | `timeoutMs` on a `change` wake config elapsed with no changes               | `payload.timeout === true`, `payload.changes` is empty                                    |
 
 For the narrative on how these are produced, see [Waking entities](../usage/waking-entities).

package/docs/usage/spawning-and-coordinating.md

@@ -129,7 +129,7 @@ async handler(ctx) {
 
   const analyst = await ctx.observe(entity("/worker/analyst"))
 
-  if (wake.type === "message_received") {
+  if (wake.type === "inbox") {
     analyst.send(wake.payload)
   }
 }

package/docs/usage/waking-entities.md

@@ -31,13 +31,13 @@ There are five things that can wake an entity:
 
 ### 1. An incoming message
 
-Any external `/send` (via the CLI, HTTP, or another entity's `ctx.send()`) appends a `message_received` event to the entity's stream, which wakes the handler:
+Any external `/send` (via the CLI, HTTP, or another entity's `ctx.send()`) appends a `inbox` event to the entity's stream, which wakes the handler:
 
 ```ts
 ctx.send("/assistant/peer", { text: "hello" })
 ```
 
-The receiving handler sees `wake.type === "message_received"` and finds the payload on `wake.payload`.
+The receiving handler sees `wake.type === "inbox"` and finds the payload on `wake.payload`.
 
 ### 2. A spawned child
 
@@ -97,7 +97,7 @@ The minimum useful pattern is to branch on `wake.type`:
 
 ```ts
 async handler(ctx, wake) {
-  if (wake.type === "message_received") {
+  if (wake.type === "inbox") {
     // external input - reply, dispatch, etc.
     ctx.useAgent({ ... })
     await ctx.agent.run()
@@ -112,8 +112,8 @@ async handler(ctx, wake) {
 
 Two wake types reach handlers directly:
 
-- `"message_received"` — an external message was delivered to this entity's inbox.
-- `"wake"` — a synthesised wake for anything else (child finished, collection change, cron, timeout). The specifics are on `wake.payload`. A future-send schedule delivers a message, so it arrives as `"message_received"`.
+- `"inbox"` — an external message was delivered to this entity's inbox.
+- `"wake"` — a synthesised wake for anything else (child finished, collection change, cron, timeout). The specifics are on `wake.payload`. A future-send schedule delivers a message, so it arrives as `"inbox"`.
 
 For the full payload shape (`changes[]`, `finished_child`, `other_children`, `timeout`), see the [wake-type catalog](../reference/wake-event#wake-type-catalog) in the reference.
 

package/docs/usage/writing-handlers.md

@@ -120,7 +120,7 @@ type WakeEvent = {
 | Field        | Description                                                    |
 | ------------ | -------------------------------------------------------------- |
 | `source`     | The stream or entity that caused the wake.                     |
-| `type`       | The wake type: `"message_received"` for inbox messages or `"wake"` for child completion, observed changes, cron, and timeouts. |
+| `type`       | The wake type: `"inbox"` for inbox messages or `"wake"` for child completion, observed changes, cron, and timeouts. |
 | `fromOffset` | Start offset of the events that triggered this wake.           |
 | `toOffset`   | End offset of the events that triggered this wake.             |
 | `eventCount` | Number of new events since last wake.                          |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@electric-ax/agents",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Built-in Electric Agents runtimes such as Horton and worker",
   "repository": {
     "type": "git",
@@ -32,14 +32,14 @@
     "@mariozechner/pi-agent-core": "^0.70.2",
     "@mariozechner/pi-ai": "^0.70.2",
     "@sinclair/typebox": "^0.34.48",
-    "better-sqlite3": "^11.10.0",
+    "better-sqlite3": "^12.9.0",
     "nanoid": "^3.3.11",
     "pino": "^10.3.1",
     "pino-pretty": "^13.0.0",
     "sqlite-vec": "^0.1.9",
     "zod": "^4.3.6",
-    "@electric-ax/agents-mcp": "0.2.1",
-    "@electric-ax/agents-runtime": "0.2.0"
+    "@electric-ax/agents-mcp": "0.2.2",
+    "@electric-ax/agents-runtime": "0.2.1"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",