@electric-ax/agents 0.4.6 → 0.4.9

package/dist/entrypoint.js

@@ -4,7 +4,7 @@ import fs from "node:fs";
 import pino from "pino";
 import { fileURLToPath } from "node:url";
 import { appendPathToUrl, completeWithLowCostModel, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillTools, createSkillsRegistry, db, detectAvailableProviders, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
-import { eq, not, queryOnce } from "@durable-streams/state";
+import { braveSearchTool, createBashTool, createEditTool, createEventSourceTools, createFetchUrlTool, createReadFileTool, createSendTool, createWriteTool, fetchUrlTool } from "@electric-ax/agents-runtime/tools";
 import { z } from "zod";
 import { createHash } from "node:crypto";
 import fs$1 from "node:fs/promises";
@@ -13,7 +13,6 @@ import { Type } from "@sinclair/typebox";
 import { load } from "sqlite-vec";
 import { nanoid } from "nanoid";
 import { getModels } from "@mariozechner/pi-ai";
-import { braveSearchTool, createBashTool, createEditTool, createFetchUrlTool, createReadFileTool, createSendTool, createWriteTool, fetchUrlTool } from "@electric-ax/agents-runtime/tools";
 import { bridgeMcpTool, buildPromptTools, buildResourceTools, createRegistry, keychainPersistence, loadConfig, mcp, watchConfig } from "@electric-ax/agents-mcp";
 
 //#region src/log.ts
@@ -652,9 +651,9 @@ function createHortonDocsSupport(workingDirectory, opts = {}) {
 		},
 		createSearchTool() {
 			return {
-				name: `search_durable_agents_docs`,
-				label: `Search Durable Agents Docs`,
-				description: `Run a hybrid BM25 plus vector search over the local Durable Agents documentation index.`,
+				name: `search_electric_agents_docs`,
+				label: `Search Electric Agents Docs`,
+				description: `Run a hybrid BM25 plus vector search over the local Electric Agents documentation index.`,
 				parameters: Type.Object({
 					query: Type.String({ description: `The docs question or search query to run.` }),
 					limit: Type.Optional(Type.Number({
@@ -785,12 +784,14 @@ const REASONING_EFFORT_VALUES = [
 const DEFAULT_ANTHROPIC_MODEL = `claude-sonnet-4-6`;
 const DEFAULT_OPENAI_MODEL = `gpt-4.1`;
 const DEFAULT_CODEX_MODEL = `gpt-5.4`;
+const DEFAULT_DEEPSEEK_MODEL = `deepseek-v4-flash`;
 function modelValue(provider, id) {
 	return `${provider}:${id}`;
 }
 function providerLabel(provider) {
 	if (provider === `anthropic`) return `Anthropic`;
 	if (provider === `openai-codex`) return `OpenAI Codex`;
+	if (provider === `deepseek`) return `DeepSeek`;
 	return `OpenAI`;
 }
 function configuredProviders() {
@@ -817,6 +818,9 @@ async function fetchAvailableModelIds(provider) {
 				"anthropic-version": `2023-06-01`
 			},
 			signal: AbortSignal.timeout(3e3)
+		}) : provider === `deepseek` ? await fetch(`https://api.deepseek.com/v1/models`, {
+			headers: { authorization: `Bearer ${process.env.DEEPSEEK_API_KEY ?? ``}` },
+			signal: AbortSignal.timeout(3e3)
 		}) : await fetch(`https://api.openai.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.OPENAI_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
@@ -877,7 +881,7 @@ async function createBuiltinModelCatalog(options = {}) {
 	if (providers.length === 0 && options.allowMockFallback) return mockFallbackCatalog();
 	const choices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
 	if (choices.length === 0) return options.allowMockFallback ? mockFallbackCatalog() : null;
-	const defaultChoice = choices.find((choice) => choice.provider === `anthropic` && choice.id === DEFAULT_ANTHROPIC_MODEL) ?? choices.find((choice) => choice.provider === `openai` && choice.id === DEFAULT_OPENAI_MODEL) ?? choices.find((choice) => choice.provider === `openai-codex` && choice.id === DEFAULT_CODEX_MODEL) ?? choices[0];
+	const defaultChoice = choices.find((choice) => choice.provider === `anthropic` && choice.id === DEFAULT_ANTHROPIC_MODEL) ?? choices.find((choice) => choice.provider === `openai` && choice.id === DEFAULT_OPENAI_MODEL) ?? choices.find((choice) => choice.provider === `openai-codex` && choice.id === DEFAULT_CODEX_MODEL) ?? choices.find((choice) => choice.provider === `deepseek` && choice.id === DEFAULT_DEEPSEEK_MODEL) ?? choices[0];
 	return {
 		choices,
 		defaultChoice
@@ -997,9 +1001,10 @@ async function generateTitle(userMessage, llmCall, onFallback) {
 	}
 }
 function buildHortonSystemPrompt(workingDirectory, opts = {}) {
-	const docsTools = opts.hasDocsSupport ? `\n- search_durable_agents_docs: hybrid search over the built-in Durable Agents docs index` : ``;
+	const docsTools = opts.hasDocsSupport ? `\n- search_electric_agents_docs: hybrid search over the built-in Electric Agents docs index` : ``;
+	const eventSourceTools = opts.hasEventSourceTools ? `\n- list_event_sources: list external webhook/event feeds you can subscribe to, including available buckets and parameters\n- subscribe_event_source: subscribe yourself to one of those feeds or buckets so matching future events wake you\n- list_event_source_subscriptions: list your active event source subscriptions\n- unsubscribe_event_source: remove one of your event source subscriptions by id` : ``;
 	const skillsTools = opts.hasSkills ? `\n- use_skill: load a skill (knowledge, instructions, or a tutorial) into your context to help with the user's request\n- remove_skill: unload a skill from context when you're done with it` : ``;
-	const docsGuidance = opts.hasDocsSupport ? `\n- For ANY question about Electric Agents, Durable Agents, or this framework, ALWAYS use search_durable_agents_docs FIRST. Do not use web_search or fetch_url for Electric Agents topics unless the docs search returns no useful results.\n- The search tool returns chunk content directly — you do not need to read the source files.\n- Use repo read/bash tools only for non-doc files or when you need to inspect exact implementation code in the workspace.` : ``;
+	const docsGuidance = opts.hasDocsSupport ? `\n- For ANY question about Electric Agents or this framework, ALWAYS use search_electric_agents_docs FIRST. Do not use web_search or fetch_url for Electric Agents topics unless the docs search returns no useful results.\n- The search tool returns chunk content directly — you do not need to read the source files.\n- Use repo read/bash tools only for non-doc files or when you need to inspect exact implementation code in the workspace.` : ``;
 	const skillsGuidance = opts.hasSkills ? `\n# Skills\nYou have access to skills — specialized knowledge and guided workflows you can load on demand. Your context includes a skills catalog listing what's available. When the user's request matches a skill's description or keywords, load it with use_skill.
 
 Some skills are user-invocable — the user can trigger them with a slash command like \`/quickstart\`. When you see a message starting with \`/\` followed by a skill name, load that skill immediately with use_skill. Pass any text after the skill name as args.
@@ -1018,7 +1023,7 @@ Do NOT load a skill and then ignore its instructions. The skill is there because
 When a user is new or asks how to get started with Electric Agents, **don't assume a single path**. Present the options and let them choose:
 
 - **Learn the concepts first** → Explain what Electric Agents is, answer questions, point to docs.
-  Use search_durable_agents_docs to look up answers. Only load the quickstart skill if the user explicitly asks for a hands-on guided tutorial.
+  Use search_electric_agents_docs to look up answers. Only load the quickstart skill if the user explicitly asks for a hands-on guided tutorial.
 
 - **Hands-on guided tutorial** → Load the quickstart skill (or tell them to type \`/quickstart\`).
   This is a step-by-step build that takes them from zero to a running app.
@@ -1028,11 +1033,11 @@ When a user is new or asks how to get started with Electric Agents, **don't assu
   This sets up project structure and orients them in the codebase.
 
 - **Have a specific question?** → Answer it directly.
-  Use search_durable_agents_docs first, then fall back to fetch_url or general knowledge if needed.
+  Use search_electric_agents_docs first, then fall back to fetch_url or general knowledge if needed.
 
 Don't force onboarding. If someone just wants to chat or code, let them. When in doubt, ask what they'd like to do rather than picking a path for them.`;
 	const docsUrlGuidance = opts.docsUrl ? `\n# Electric Agents documentation
-- ${opts.hasDocsSupport ? `If search_durable_agents_docs is available, use it first (faster, hybrid search).` : `Use fetch_url to look up documentation pages.`}
+- ${opts.hasDocsSupport ? `If search_electric_agents_docs is available, use it first (faster, hybrid search).` : `Use fetch_url to look up documentation pages.`}
 - The Electric Agents docs site is at ${opts.docsUrl}
 - The docs site covers: Usage (entity definition, handlers, tools, state, spawning, coordination, waking, shared state, client integration, app setup), Reference (handler context, entity definitions, configurations, tools, state proxies, wake events, registries), Entities (Horton, Worker), and Patterns (Manager-Worker, Pipeline, Map-Reduce, Dispatcher, Blackboard, Reactive Observers).
 - For general coding questions unrelated to Electric Agents, use web_search or your own knowledge.` : ``;
@@ -1051,8 +1056,8 @@ When a user opens with a greeting ("hi", "hello", "hey", etc.) or a broad statem
 - web_search: search the web
 - fetch_url: fetch and convert a URL to markdown
 - spawn_worker: dispatch a subagent for an isolated task
-- send: send a message to an Electric Agent/entity by entity URL
-${docsTools}${skillsTools}
+- send: send a message to an Electric Agent/entity. To schedule future work for yourself, call send with self: true and afterMs.
+${eventSourceTools}${docsTools}${skillsTools}
 
 # Working with files
 - Prefer edit over write when modifying existing files.
@@ -1085,6 +1090,11 @@ Report outcomes faithfully. If a command failed, say so with the relevant output
 Working directory: ${workingDirectory}
 The current year is ${new Date().getFullYear()}.`;
 }
+function getToolName(tool) {
+	if (typeof tool !== `object` || tool === null) return null;
+	const name = tool.name;
+	return typeof name === `string` ? name : null;
+}
 function createHortonTools(workingDirectory, ctx, readSet, opts = {}) {
 	return [
 		createBashTool(workingDirectory),
@@ -1099,7 +1109,7 @@ function createHortonTools(workingDirectory, ctx, readSet, opts = {}) {
 			logPrefix: opts.logPrefix ?? `[horton]`
 		})] : [fetchUrlTool],
 		createSpawnWorkerTool(ctx, opts.modelConfig),
-		createSendTool(ctx.send),
+		createSendTool(ctx.send, { selfEntityUrl: ctx.entityUrl }),
 		...opts.docsSearchTool ? [opts.docsSearchTool] : []
 	];
 }
@@ -1113,11 +1123,14 @@ function payloadToTitleText(payload) {
 	return String(payload);
 }
 async function extractFirstUserMessage(ctx) {
-	const firstMessage = await queryOnce((q) => q.from({ inbox: ctx.db.collections.inbox }).where(({ inbox }) => not(eq(inbox.from, `system`))).orderBy(({ inbox }) => inbox._seq, `asc`).findOne());
+	const firstMessage = ctx.db.collections.inbox.toArray.filter((message) => message.from !== `system`).sort((left, right) => messageSeq(left) - messageSeq(right))[0];
 	if (!firstMessage) return null;
 	const text = payloadToTitleText(firstMessage.payload);
 	return text.length > 0 ? text : null;
 }
+function messageSeq(message) {
+	return typeof message._seq === `number` ? message._seq : -1;
+}
 function readAgentsMd(workingDirectory) {
 	const agentsMdPath = path.join(workingDirectory, `AGENTS.md`);
 	try {
@@ -1151,6 +1164,7 @@ function createAssistantHandler(options) {
 			...skillsRegistry && skillsRegistry.catalog.size > 0 ? createSkillTools(skillsRegistry, ctx) : [],
 			...mcp.tools()
 		];
+		const hasEventSourceTools = tools.some((tool) => getToolName(tool) === `list_event_sources`);
 		const titlePromise = ctx.firstWake && !ctx.tags.title ? (async () => {
 			const firstUserMessage = await extractFirstUserMessage(ctx);
 			if (!firstUserMessage) return;
@@ -1237,7 +1251,8 @@ function createAssistantHandler(options) {
 				hasSkills,
 				docsUrl,
 				modelProvider: modelConfig.provider,
-				modelId: String(modelConfig.model)
+				modelId: String(modelConfig.model),
+				hasEventSourceTools
 			}),
 			...modelConfig,
 			tools,
@@ -1277,15 +1292,7 @@ function registerHorton(registry, options) {
 		creationSchema: hortonCreationSchema,
 		handler: assistantHandler
 	});
-	const typeNames = [`horton`];
-	if (streamFn) {
-		registry.define(`chat`, {
-			description: `Compatibility alias for the built-in assistant type.`,
-			handler: assistantHandler
-		});
-		typeNames.push(`chat`);
-	}
-	return typeNames;
+	return [`horton`];
 }
 
 //#endregion
@@ -1349,7 +1356,7 @@ function buildToolsForWorker(tools, workingDirectory, ctx, readSet) {
 			out.push(createSpawnWorkerTool(ctx));
 			break;
 		case `send`:
-			out.push(createSendTool(ctx.send));
+			out.push(createSendTool(ctx.send, { selfEntityUrl: ctx.entityUrl }));
 			break;
 	}
 	return out;
@@ -1477,6 +1484,27 @@ function registerWorker(registry, options) {
 
 //#endregion
 //#region src/bootstrap.ts
+function toolName(tool) {
+	return typeof tool.name === `string` ? tool.name : null;
+}
+function dedupeToolsByName(tools) {
+	const seen = new Set();
+	const deduped = [];
+	for (const tool of tools) {
+		const name = toolName(tool);
+		if (name && seen.has(name)) continue;
+		if (name) seen.add(name);
+		deduped.push(tool);
+	}
+	return deduped;
+}
+function createBuiltinElectricTools(custom) {
+	return async (context) => {
+		const builtinTools = createEventSourceTools(context);
+		const customTools = custom ? await custom(context) : [];
+		return dedupeToolsByName([...builtinTools, ...customTools]);
+	};
+}
 async function createBuiltinAgentHandler(options) {
 	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
 	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
@@ -1519,7 +1547,7 @@ async function createBuiltinAgentHandler(options) {
 		defaultDispatchPolicyForType,
 		serverHeaders,
 		idleTimeout: 5 * 6e4,
-		createElectricTools,
+		createElectricTools: createBuiltinElectricTools(createElectricTools),
 		publicUrl,
 		name: runtimeName ?? `builtin-agents`
 	});

package/dist/index.cjs

@@ -26,9 +26,9 @@ const require_server_headers = require('./server-headers-65vIhxvJ.cjs');
 const node_path = __toESM(require("node:path"));
 const node_url = __toESM(require("node:url"));
 const __electric_ax_agents_runtime = __toESM(require("@electric-ax/agents-runtime"));
+const __electric_ax_agents_runtime_tools = __toESM(require("@electric-ax/agents-runtime/tools"));
 const node_fs = __toESM(require("node:fs"));
 const pino = __toESM(require("pino"));
-const __durable_streams_state = __toESM(require("@durable-streams/state"));
 const zod = __toESM(require("zod"));
 const node_crypto = __toESM(require("node:crypto"));
 const node_fs_promises = __toESM(require("node:fs/promises"));
@@ -37,7 +37,6 @@ const __sinclair_typebox = __toESM(require("@sinclair/typebox"));
 const sqlite_vec = __toESM(require("sqlite-vec"));
 const nanoid = __toESM(require("nanoid"));
 const __mariozechner_pi_ai = __toESM(require("@mariozechner/pi-ai"));
-const __electric_ax_agents_runtime_tools = __toESM(require("@electric-ax/agents-runtime/tools"));
 const __electric_ax_agents_mcp = __toESM(require("@electric-ax/agents-mcp"));
 
 //#region src/log.ts
@@ -676,9 +675,9 @@ function createHortonDocsSupport(workingDirectory, opts = {}) {
 		},
 		createSearchTool() {
 			return {
-				name: `search_durable_agents_docs`,
-				label: `Search Durable Agents Docs`,
-				description: `Run a hybrid BM25 plus vector search over the local Durable Agents documentation index.`,
+				name: `search_electric_agents_docs`,
+				label: `Search Electric Agents Docs`,
+				description: `Run a hybrid BM25 plus vector search over the local Electric Agents documentation index.`,
 				parameters: __sinclair_typebox.Type.Object({
 					query: __sinclair_typebox.Type.String({ description: `The docs question or search query to run.` }),
 					limit: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Number({
@@ -809,12 +808,14 @@ const REASONING_EFFORT_VALUES = [
 const DEFAULT_ANTHROPIC_MODEL = `claude-sonnet-4-6`;
 const DEFAULT_OPENAI_MODEL = `gpt-4.1`;
 const DEFAULT_CODEX_MODEL = `gpt-5.4`;
+const DEFAULT_DEEPSEEK_MODEL = `deepseek-v4-flash`;
 function modelValue(provider, id) {
 	return `${provider}:${id}`;
 }
 function providerLabel(provider) {
 	if (provider === `anthropic`) return `Anthropic`;
 	if (provider === `openai-codex`) return `OpenAI Codex`;
+	if (provider === `deepseek`) return `DeepSeek`;
 	return `OpenAI`;
 }
 function configuredProviders() {
@@ -841,6 +842,9 @@ async function fetchAvailableModelIds(provider) {
 				"anthropic-version": `2023-06-01`
 			},
 			signal: AbortSignal.timeout(3e3)
+		}) : provider === `deepseek` ? await fetch(`https://api.deepseek.com/v1/models`, {
+			headers: { authorization: `Bearer ${process.env.DEEPSEEK_API_KEY ?? ``}` },
+			signal: AbortSignal.timeout(3e3)
 		}) : await fetch(`https://api.openai.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.OPENAI_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
@@ -901,7 +905,7 @@ async function createBuiltinModelCatalog(options = {}) {
 	if (providers.length === 0 && options.allowMockFallback) return mockFallbackCatalog();
 	const choices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
 	if (choices.length === 0) return options.allowMockFallback ? mockFallbackCatalog() : null;
-	const defaultChoice = choices.find((choice) => choice.provider === `anthropic` && choice.id === DEFAULT_ANTHROPIC_MODEL) ?? choices.find((choice) => choice.provider === `openai` && choice.id === DEFAULT_OPENAI_MODEL) ?? choices.find((choice) => choice.provider === `openai-codex` && choice.id === DEFAULT_CODEX_MODEL) ?? choices[0];
+	const defaultChoice = choices.find((choice) => choice.provider === `anthropic` && choice.id === DEFAULT_ANTHROPIC_MODEL) ?? choices.find((choice) => choice.provider === `openai` && choice.id === DEFAULT_OPENAI_MODEL) ?? choices.find((choice) => choice.provider === `openai-codex` && choice.id === DEFAULT_CODEX_MODEL) ?? choices.find((choice) => choice.provider === `deepseek` && choice.id === DEFAULT_DEEPSEEK_MODEL) ?? choices[0];
 	return {
 		choices,
 		defaultChoice
@@ -1022,9 +1026,10 @@ async function generateTitle(userMessage, llmCall, onFallback) {
 	}
 }
 function buildHortonSystemPrompt(workingDirectory, opts = {}) {
-	const docsTools = opts.hasDocsSupport ? `\n- search_durable_agents_docs: hybrid search over the built-in Durable Agents docs index` : ``;
+	const docsTools = opts.hasDocsSupport ? `\n- search_electric_agents_docs: hybrid search over the built-in Electric Agents docs index` : ``;
+	const eventSourceTools = opts.hasEventSourceTools ? `\n- list_event_sources: list external webhook/event feeds you can subscribe to, including available buckets and parameters\n- subscribe_event_source: subscribe yourself to one of those feeds or buckets so matching future events wake you\n- list_event_source_subscriptions: list your active event source subscriptions\n- unsubscribe_event_source: remove one of your event source subscriptions by id` : ``;
 	const skillsTools = opts.hasSkills ? `\n- use_skill: load a skill (knowledge, instructions, or a tutorial) into your context to help with the user's request\n- remove_skill: unload a skill from context when you're done with it` : ``;
-	const docsGuidance = opts.hasDocsSupport ? `\n- For ANY question about Electric Agents, Durable Agents, or this framework, ALWAYS use search_durable_agents_docs FIRST. Do not use web_search or fetch_url for Electric Agents topics unless the docs search returns no useful results.\n- The search tool returns chunk content directly — you do not need to read the source files.\n- Use repo read/bash tools only for non-doc files or when you need to inspect exact implementation code in the workspace.` : ``;
+	const docsGuidance = opts.hasDocsSupport ? `\n- For ANY question about Electric Agents or this framework, ALWAYS use search_electric_agents_docs FIRST. Do not use web_search or fetch_url for Electric Agents topics unless the docs search returns no useful results.\n- The search tool returns chunk content directly — you do not need to read the source files.\n- Use repo read/bash tools only for non-doc files or when you need to inspect exact implementation code in the workspace.` : ``;
 	const skillsGuidance = opts.hasSkills ? `\n# Skills\nYou have access to skills — specialized knowledge and guided workflows you can load on demand. Your context includes a skills catalog listing what's available. When the user's request matches a skill's description or keywords, load it with use_skill.
 
 Some skills are user-invocable — the user can trigger them with a slash command like \`/quickstart\`. When you see a message starting with \`/\` followed by a skill name, load that skill immediately with use_skill. Pass any text after the skill name as args.
@@ -1043,7 +1048,7 @@ Do NOT load a skill and then ignore its instructions. The skill is there because
 When a user is new or asks how to get started with Electric Agents, **don't assume a single path**. Present the options and let them choose:
 
 - **Learn the concepts first** → Explain what Electric Agents is, answer questions, point to docs.
-  Use search_durable_agents_docs to look up answers. Only load the quickstart skill if the user explicitly asks for a hands-on guided tutorial.
+  Use search_electric_agents_docs to look up answers. Only load the quickstart skill if the user explicitly asks for a hands-on guided tutorial.
 
 - **Hands-on guided tutorial** → Load the quickstart skill (or tell them to type \`/quickstart\`).
   This is a step-by-step build that takes them from zero to a running app.
@@ -1053,11 +1058,11 @@ When a user is new or asks how to get started with Electric Agents, **don't assu
   This sets up project structure and orients them in the codebase.
 
 - **Have a specific question?** → Answer it directly.
-  Use search_durable_agents_docs first, then fall back to fetch_url or general knowledge if needed.
+  Use search_electric_agents_docs first, then fall back to fetch_url or general knowledge if needed.
 
 Don't force onboarding. If someone just wants to chat or code, let them. When in doubt, ask what they'd like to do rather than picking a path for them.`;
 	const docsUrlGuidance = opts.docsUrl ? `\n# Electric Agents documentation
-- ${opts.hasDocsSupport ? `If search_durable_agents_docs is available, use it first (faster, hybrid search).` : `Use fetch_url to look up documentation pages.`}
+- ${opts.hasDocsSupport ? `If search_electric_agents_docs is available, use it first (faster, hybrid search).` : `Use fetch_url to look up documentation pages.`}
 - The Electric Agents docs site is at ${opts.docsUrl}
 - The docs site covers: Usage (entity definition, handlers, tools, state, spawning, coordination, waking, shared state, client integration, app setup), Reference (handler context, entity definitions, configurations, tools, state proxies, wake events, registries), Entities (Horton, Worker), and Patterns (Manager-Worker, Pipeline, Map-Reduce, Dispatcher, Blackboard, Reactive Observers).
 - For general coding questions unrelated to Electric Agents, use web_search or your own knowledge.` : ``;
@@ -1076,8 +1081,8 @@ When a user opens with a greeting ("hi", "hello", "hey", etc.) or a broad statem
 - web_search: search the web
 - fetch_url: fetch and convert a URL to markdown
 - spawn_worker: dispatch a subagent for an isolated task
-- send: send a message to an Electric Agent/entity by entity URL
-${docsTools}${skillsTools}
+- send: send a message to an Electric Agent/entity. To schedule future work for yourself, call send with self: true and afterMs.
+${eventSourceTools}${docsTools}${skillsTools}
 
 # Working with files
 - Prefer edit over write when modifying existing files.
@@ -1110,6 +1115,11 @@ Report outcomes faithfully. If a command failed, say so with the relevant output
 Working directory: ${workingDirectory}
 The current year is ${new Date().getFullYear()}.`;
 }
+function getToolName(tool) {
+	if (typeof tool !== `object` || tool === null) return null;
+	const name = tool.name;
+	return typeof name === `string` ? name : null;
+}
 function createHortonTools(workingDirectory, ctx, readSet, opts = {}) {
 	return [
 		(0, __electric_ax_agents_runtime_tools.createBashTool)(workingDirectory),
@@ -1124,7 +1134,7 @@ function createHortonTools(workingDirectory, ctx, readSet, opts = {}) {
 			logPrefix: opts.logPrefix ?? `[horton]`
 		})] : [__electric_ax_agents_runtime_tools.fetchUrlTool],
 		createSpawnWorkerTool(ctx, opts.modelConfig),
-		(0, __electric_ax_agents_runtime_tools.createSendTool)(ctx.send),
+		(0, __electric_ax_agents_runtime_tools.createSendTool)(ctx.send, { selfEntityUrl: ctx.entityUrl }),
 		...opts.docsSearchTool ? [opts.docsSearchTool] : []
 	];
 }
@@ -1138,11 +1148,14 @@ function payloadToTitleText(payload) {
 	return String(payload);
 }
 async function extractFirstUserMessage(ctx) {
-	const firstMessage = await (0, __durable_streams_state.queryOnce)((q) => q.from({ inbox: ctx.db.collections.inbox }).where(({ inbox }) => (0, __durable_streams_state.not)((0, __durable_streams_state.eq)(inbox.from, `system`))).orderBy(({ inbox }) => inbox._seq, `asc`).findOne());
+	const firstMessage = ctx.db.collections.inbox.toArray.filter((message) => message.from !== `system`).sort((left, right) => messageSeq(left) - messageSeq(right))[0];
 	if (!firstMessage) return null;
 	const text = payloadToTitleText(firstMessage.payload);
 	return text.length > 0 ? text : null;
 }
+function messageSeq(message) {
+	return typeof message._seq === `number` ? message._seq : -1;
+}
 function readAgentsMd(workingDirectory) {
 	const agentsMdPath = node_path.default.join(workingDirectory, `AGENTS.md`);
 	try {
@@ -1176,6 +1189,7 @@ function createAssistantHandler(options) {
 			...skillsRegistry && skillsRegistry.catalog.size > 0 ? (0, __electric_ax_agents_runtime.createSkillTools)(skillsRegistry, ctx) : [],
 			...__electric_ax_agents_mcp.mcp.tools()
 		];
+		const hasEventSourceTools = tools.some((tool) => getToolName(tool) === `list_event_sources`);
 		const titlePromise = ctx.firstWake && !ctx.tags.title ? (async () => {
 			const firstUserMessage = await extractFirstUserMessage(ctx);
 			if (!firstUserMessage) return;
@@ -1262,7 +1276,8 @@ function createAssistantHandler(options) {
 				hasSkills,
 				docsUrl,
 				modelProvider: modelConfig.provider,
-				modelId: String(modelConfig.model)
+				modelId: String(modelConfig.model),
+				hasEventSourceTools
 			}),
 			...modelConfig,
 			tools,
@@ -1302,15 +1317,7 @@ function registerHorton(registry, options) {
 		creationSchema: hortonCreationSchema,
 		handler: assistantHandler
 	});
-	const typeNames = [`horton`];
-	if (streamFn) {
-		registry.define(`chat`, {
-			description: `Compatibility alias for the built-in assistant type.`,
-			handler: assistantHandler
-		});
-		typeNames.push(`chat`);
-	}
-	return typeNames;
+	return [`horton`];
 }
 
 //#endregion
@@ -1374,7 +1381,7 @@ function buildToolsForWorker(tools, workingDirectory, ctx, readSet) {
 			out.push(createSpawnWorkerTool(ctx));
 			break;
 		case `send`:
-			out.push((0, __electric_ax_agents_runtime_tools.createSendTool)(ctx.send));
+			out.push((0, __electric_ax_agents_runtime_tools.createSendTool)(ctx.send, { selfEntityUrl: ctx.entityUrl }));
 			break;
 	}
 	return out;
@@ -1503,6 +1510,27 @@ function registerWorker(registry, options) {
 //#endregion
 //#region src/bootstrap.ts
 const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = `/_electric/builtin-agent-handler`;
+function toolName(tool) {
+	return typeof tool.name === `string` ? tool.name : null;
+}
+function dedupeToolsByName(tools) {
+	const seen = new Set();
+	const deduped = [];
+	for (const tool of tools) {
+		const name = toolName(tool);
+		if (name && seen.has(name)) continue;
+		if (name) seen.add(name);
+		deduped.push(tool);
+	}
+	return deduped;
+}
+function createBuiltinElectricTools(custom) {
+	return async (context) => {
+		const builtinTools = (0, __electric_ax_agents_runtime_tools.createEventSourceTools)(context);
+		const customTools = custom ? await custom(context) : [];
+		return dedupeToolsByName([...builtinTools, ...customTools]);
+	};
+}
 async function createBuiltinAgentHandler(options) {
 	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
 	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
@@ -1545,7 +1573,7 @@ async function createBuiltinAgentHandler(options) {
 		defaultDispatchPolicyForType,
 		serverHeaders,
 		idleTimeout: 5 * 6e4,
-		createElectricTools,
+		createElectricTools: createBuiltinElectricTools(createElectricTools),
 		publicUrl,
 		name: runtimeName ?? `builtin-agents`
 	});
@@ -1887,6 +1915,7 @@ Object.defineProperty(exports, 'braveSearchTool', {
 exports.buildHortonSystemPrompt = buildHortonSystemPrompt
 exports.createAgentHandler = createAgentHandler
 exports.createBuiltinAgentHandler = createBuiltinAgentHandler
+exports.createBuiltinElectricTools = createBuiltinElectricTools
 exports.createHortonDocsSupport = createHortonDocsSupport
 exports.createHortonTools = createHortonTools
 exports.createSpawnWorkerTool = createSpawnWorkerTool

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { AgentConfig, AgentTool, AvailableProvider, DispatchPolicy, EntityRegistry, EntityStreamDBWithActions, HandlerContext, HeadersProvider, PullWakeRunnerConfig, RuntimeHandler, SkillsRegistry, WakeEvent } from "@electric-ax/agents-runtime";
-import { ChangeEvent } from "@durable-streams/state";
+import { AgentConfig, AgentTool, AvailableProvider, DispatchPolicy, EntityRegistry, HandlerContext, HeadersProvider, ProcessWakeConfig, PullWakeRunnerConfig, RuntimeHandler, SkillsRegistry, WakeEvent } from "@electric-ax/agents-runtime";
 import { AgentTool as AgentTool$1, StreamFn } from "@mariozechner/pi-agent-core";
 import { IncomingMessage, ServerResponse } from "node:http";
 import { ListedEntry as McpListedEntry, McpConfig, McpServerConfig, McpServerConfig as McpServerConfig$1, Registry, Registry as McpRegistry, RegistrySnapshot, RegistrySubscriber } from "@electric-ax/agents-mcp";
+import { ChangeEvent } from "@durable-streams/state";
 import { braveSearchTool } from "@electric-ax/agents-runtime/tools";
 
 //#region src/bootstrap.d.ts
@@ -14,6 +14,7 @@ interface AgentHandlerResult {
   typeNames: Array<string>;
   skillsRegistry: SkillsRegistry | null;
 }
+type BuiltinElectricToolsFactory = NonNullable<ProcessWakeConfig[`createElectricTools`]>;
 interface BuiltinAgentHandlerOptions {
   agentServerUrl: string;
   serveEndpoint?: string;
@@ -25,43 +26,15 @@ interface BuiltinAgentHandlerOptions {
   baseSkillsDir?: string;
   serverHeaders?: HeadersProvider;
   defaultDispatchPolicyForType?: (typeName: string) => DispatchPolicy | undefined;
-  createElectricTools?: (context: {
-    entityUrl: string;
-    entityType: string;
-    args: Readonly<Record<string, unknown>>;
-    db: EntityStreamDBWithActions;
-    events: Array<ChangeEvent>;
-    upsertCronSchedule: (opts: {
-      id: string;
-      expression: string;
-      timezone?: string;
-      payload?: unknown;
-      debounceMs?: number;
-      timeoutMs?: number;
-    }) => Promise<{
-      txid: string;
-    }>;
-    upsertFutureSendSchedule: (opts: {
-      id: string;
-      payload: unknown;
-      targetUrl?: string;
-      fireAt: string;
-      from?: string;
-      messageType?: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-    deleteSchedule: (opts: {
-      id: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+  createElectricTools?: BuiltinElectricToolsFactory;
 }
+declare function createBuiltinElectricTools(custom?: BuiltinElectricToolsFactory): BuiltinElectricToolsFactory;
 declare function createBuiltinAgentHandler(options: BuiltinAgentHandlerOptions): Promise<AgentHandlerResult | null>;
 declare function createAgentHandler(agentServerUrl: string, workingDirectory?: string, streamFn?: StreamFn, createElectricTools?: BuiltinAgentHandlerOptions[`createElectricTools`], serveEndpoint?: string): Promise<AgentHandlerResult | null>;
 declare function registerBuiltinAgentTypes(bootstrap: AgentHandlerResult): Promise<void>;
-declare const registerAgentTypes: typeof registerBuiltinAgentTypes; //#endregion
+declare const registerAgentTypes: typeof registerBuiltinAgentTypes;
+
+//#endregion
 //#region src/server.d.ts
 interface BuiltinAgentsServerOptions {
   agentServerUrl: string;
@@ -106,38 +79,7 @@ interface BuiltinAgentsServerOptions {
   loadProjectMcpConfig?: boolean;
   /** Override for the built-in skills directory; required when embedders bundle this package. */
   baseSkillsDir?: string;
-  createElectricTools?: (context: {
-    entityUrl: string;
-    entityType: string;
-    args: Readonly<Record<string, unknown>>;
-    db: EntityStreamDBWithActions;
-    events: Array<ChangeEvent>;
-    upsertCronSchedule: (opts: {
-      id: string;
-      expression: string;
-      timezone?: string;
-      payload?: unknown;
-      debounceMs?: number;
-      timeoutMs?: number;
-    }) => Promise<{
-      txid: string;
-    }>;
-    upsertFutureSendSchedule: (opts: {
-      id: string;
-      payload: unknown;
-      targetUrl?: string;
-      fireAt: string;
-      from?: string;
-      messageType?: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-    deleteSchedule: (opts: {
-      id: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+  createElectricTools?: NonNullable<ProcessWakeConfig[`createElectricTools`]>;
 }
 declare class BuiltinAgentsServer {
   private bootstrap;
@@ -154,7 +96,9 @@ declare class BuiltinAgentsServer {
   start(): Promise<string>;
   stop(): Promise<void>;
   private registerPullWakeRunner;
-} //#endregion
+}
+
+//#endregion
 //#region src/entrypoint-lib.d.ts
 type EnvSource = Record<string, string | undefined>;
 interface BuiltinAgentsEntrypointOptions extends BuiltinAgentsServerOptions {}
@@ -206,6 +150,7 @@ declare const HORTON_MODEL = "claude-sonnet-4-6";
 declare function generateTitle(userMessage: string, llmCall: (prompt: string) => Promise<string>, onFallback?: (reason: string) => void): Promise<string>;
 declare function buildHortonSystemPrompt(workingDirectory: string, opts?: {
   hasDocsSupport?: boolean;
+  hasEventSourceTools?: boolean;
   hasSkills?: boolean;
   docsUrl?: string;
   modelProvider?: string;
@@ -258,4 +203,4 @@ declare function createHortonDocsSupport(workingDirectory: string, opts?: {
 }): HortonDocsSupport | null;
 
 //#endregion
-export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, McpConfig, McpListedEntry, McpRegistry, McpServerConfig, RegistrySnapshot, RegistrySubscriber, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, braveSearchTool, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };
+export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, BuiltinElectricToolsFactory, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, McpConfig, McpListedEntry, McpRegistry, McpServerConfig, RegistrySnapshot, RegistrySubscriber, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, braveSearchTool, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { AgentConfig, AgentTool, AvailableProvider, DispatchPolicy, EntityRegistry, EntityStreamDBWithActions, HandlerContext, HeadersProvider, PullWakeRunnerConfig, RuntimeHandler, SkillsRegistry, WakeEvent } from "@electric-ax/agents-runtime";
-import { ChangeEvent } from "@durable-streams/state";
+import { AgentConfig, AgentTool, AvailableProvider, DispatchPolicy, EntityRegistry, HandlerContext, HeadersProvider, ProcessWakeConfig, PullWakeRunnerConfig, RuntimeHandler, SkillsRegistry, WakeEvent } from "@electric-ax/agents-runtime";
 import { braveSearchTool } from "@electric-ax/agents-runtime/tools";
 import { ListedEntry as McpListedEntry, McpConfig, McpServerConfig, McpServerConfig as McpServerConfig$1, Registry, Registry as McpRegistry, RegistrySnapshot, RegistrySubscriber } from "@electric-ax/agents-mcp";
 import { AgentTool as AgentTool$1, StreamFn } from "@mariozechner/pi-agent-core";
 import { IncomingMessage, ServerResponse } from "node:http";
+import { ChangeEvent } from "@durable-streams/state";
 
 //#region src/bootstrap.d.ts
 declare const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = "/_electric/builtin-agent-handler";
@@ -14,6 +14,7 @@ interface AgentHandlerResult {
   typeNames: Array<string>;
   skillsRegistry: SkillsRegistry | null;
 }
+type BuiltinElectricToolsFactory = NonNullable<ProcessWakeConfig[`createElectricTools`]>;
 interface BuiltinAgentHandlerOptions {
   agentServerUrl: string;
   serveEndpoint?: string;
@@ -25,43 +26,15 @@ interface BuiltinAgentHandlerOptions {
   baseSkillsDir?: string;
   serverHeaders?: HeadersProvider;
   defaultDispatchPolicyForType?: (typeName: string) => DispatchPolicy | undefined;
-  createElectricTools?: (context: {
-    entityUrl: string;
-    entityType: string;
-    args: Readonly<Record<string, unknown>>;
-    db: EntityStreamDBWithActions;
-    events: Array<ChangeEvent>;
-    upsertCronSchedule: (opts: {
-      id: string;
-      expression: string;
-      timezone?: string;
-      payload?: unknown;
-      debounceMs?: number;
-      timeoutMs?: number;
-    }) => Promise<{
-      txid: string;
-    }>;
-    upsertFutureSendSchedule: (opts: {
-      id: string;
-      payload: unknown;
-      targetUrl?: string;
-      fireAt: string;
-      from?: string;
-      messageType?: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-    deleteSchedule: (opts: {
-      id: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+  createElectricTools?: BuiltinElectricToolsFactory;
 }
+declare function createBuiltinElectricTools(custom?: BuiltinElectricToolsFactory): BuiltinElectricToolsFactory;
 declare function createBuiltinAgentHandler(options: BuiltinAgentHandlerOptions): Promise<AgentHandlerResult | null>;
 declare function createAgentHandler(agentServerUrl: string, workingDirectory?: string, streamFn?: StreamFn, createElectricTools?: BuiltinAgentHandlerOptions[`createElectricTools`], serveEndpoint?: string): Promise<AgentHandlerResult | null>;
 declare function registerBuiltinAgentTypes(bootstrap: AgentHandlerResult): Promise<void>;
-declare const registerAgentTypes: typeof registerBuiltinAgentTypes; //#endregion
+declare const registerAgentTypes: typeof registerBuiltinAgentTypes;
+
+//#endregion
 //#region src/server.d.ts
 interface BuiltinAgentsServerOptions {
   agentServerUrl: string;
@@ -106,38 +79,7 @@ interface BuiltinAgentsServerOptions {
   loadProjectMcpConfig?: boolean;
   /** Override for the built-in skills directory; required when embedders bundle this package. */
   baseSkillsDir?: string;
-  createElectricTools?: (context: {
-    entityUrl: string;
-    entityType: string;
-    args: Readonly<Record<string, unknown>>;
-    db: EntityStreamDBWithActions;
-    events: Array<ChangeEvent>;
-    upsertCronSchedule: (opts: {
-      id: string;
-      expression: string;
-      timezone?: string;
-      payload?: unknown;
-      debounceMs?: number;
-      timeoutMs?: number;
-    }) => Promise<{
-      txid: string;
-    }>;
-    upsertFutureSendSchedule: (opts: {
-      id: string;
-      payload: unknown;
-      targetUrl?: string;
-      fireAt: string;
-      from?: string;
-      messageType?: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-    deleteSchedule: (opts: {
-      id: string;
-    }) => Promise<{
-      txid: string;
-    }>;
-  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+  createElectricTools?: NonNullable<ProcessWakeConfig[`createElectricTools`]>;
 }
 declare class BuiltinAgentsServer {
   private bootstrap;
@@ -154,7 +96,9 @@ declare class BuiltinAgentsServer {
   start(): Promise<string>;
   stop(): Promise<void>;
   private registerPullWakeRunner;
-} //#endregion
+}
+
+//#endregion
 //#region src/entrypoint-lib.d.ts
 type EnvSource = Record<string, string | undefined>;
 interface BuiltinAgentsEntrypointOptions extends BuiltinAgentsServerOptions {}
@@ -206,6 +150,7 @@ declare const HORTON_MODEL = "claude-sonnet-4-6";
 declare function generateTitle(userMessage: string, llmCall: (prompt: string) => Promise<string>, onFallback?: (reason: string) => void): Promise<string>;
 declare function buildHortonSystemPrompt(workingDirectory: string, opts?: {
   hasDocsSupport?: boolean;
+  hasEventSourceTools?: boolean;
   hasSkills?: boolean;
   docsUrl?: string;
   modelProvider?: string;
@@ -258,4 +203,4 @@ declare function createHortonDocsSupport(workingDirectory: string, opts?: {
 }): HortonDocsSupport | null;
 
 //#endregion
-export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, McpConfig, McpListedEntry, McpRegistry, McpServerConfig, RegistrySnapshot, RegistrySubscriber, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, braveSearchTool, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };
+export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, BuiltinElectricToolsFactory, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, McpConfig, McpListedEntry, McpRegistry, McpServerConfig, RegistrySnapshot, RegistrySubscriber, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, braveSearchTool, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/dist/index.js

@@ -2,9 +2,9 @@ import { mergeElectricPrincipalHeader } from "./server-headers-KD5yHFYT.js";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { appendPathToUrl, completeWithLowCostModel, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillTools, createSkillsRegistry, db, detectAvailableProviders, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
+import { braveSearchTool, braveSearchTool as braveSearchTool$1, createBashTool, createEditTool, createEventSourceTools, createFetchUrlTool, createReadFileTool, createSendTool, createWriteTool, fetchUrlTool } from "@electric-ax/agents-runtime/tools";
 import fs from "node:fs";
 import pino from "pino";
-import { eq, not, queryOnce } from "@durable-streams/state";
 import { z } from "zod";
 import { createHash } from "node:crypto";
 import fs$1 from "node:fs/promises";
@@ -13,7 +13,6 @@ import { Type } from "@sinclair/typebox";
 import { load } from "sqlite-vec";
 import { nanoid } from "nanoid";
 import { getModels } from "@mariozechner/pi-ai";
-import { braveSearchTool, braveSearchTool as braveSearchTool$1, createBashTool, createEditTool, createFetchUrlTool, createReadFileTool, createSendTool, createWriteTool, fetchUrlTool } from "@electric-ax/agents-runtime/tools";
 import { bridgeMcpTool, buildPromptTools, buildResourceTools, createRegistry, keychainPersistence, loadConfig, mcp, watchConfig } from "@electric-ax/agents-mcp";
 
 //#region src/log.ts
@@ -652,9 +651,9 @@ function createHortonDocsSupport(workingDirectory, opts = {}) {
 		},
 		createSearchTool() {
 			return {
-				name: `search_durable_agents_docs`,
-				label: `Search Durable Agents Docs`,
-				description: `Run a hybrid BM25 plus vector search over the local Durable Agents documentation index.`,
+				name: `search_electric_agents_docs`,
+				label: `Search Electric Agents Docs`,
+				description: `Run a hybrid BM25 plus vector search over the local Electric Agents documentation index.`,
 				parameters: Type.Object({
 					query: Type.String({ description: `The docs question or search query to run.` }),
 					limit: Type.Optional(Type.Number({
@@ -785,12 +784,14 @@ const REASONING_EFFORT_VALUES = [
 const DEFAULT_ANTHROPIC_MODEL = `claude-sonnet-4-6`;
 const DEFAULT_OPENAI_MODEL = `gpt-4.1`;
 const DEFAULT_CODEX_MODEL = `gpt-5.4`;
+const DEFAULT_DEEPSEEK_MODEL = `deepseek-v4-flash`;
 function modelValue(provider, id) {
 	return `${provider}:${id}`;
 }
 function providerLabel(provider) {
 	if (provider === `anthropic`) return `Anthropic`;
 	if (provider === `openai-codex`) return `OpenAI Codex`;
+	if (provider === `deepseek`) return `DeepSeek`;
 	return `OpenAI`;
 }
 function configuredProviders() {
@@ -817,6 +818,9 @@ async function fetchAvailableModelIds(provider) {
 				"anthropic-version": `2023-06-01`
 			},
 			signal: AbortSignal.timeout(3e3)
+		}) : provider === `deepseek` ? await fetch(`https://api.deepseek.com/v1/models`, {
+			headers: { authorization: `Bearer ${process.env.DEEPSEEK_API_KEY ?? ``}` },
+			signal: AbortSignal.timeout(3e3)
 		}) : await fetch(`https://api.openai.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.OPENAI_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
@@ -877,7 +881,7 @@ async function createBuiltinModelCatalog(options = {}) {
 	if (providers.length === 0 && options.allowMockFallback) return mockFallbackCatalog();
 	const choices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
 	if (choices.length === 0) return options.allowMockFallback ? mockFallbackCatalog() : null;
-	const defaultChoice = choices.find((choice) => choice.provider === `anthropic` && choice.id === DEFAULT_ANTHROPIC_MODEL) ?? choices.find((choice) => choice.provider === `openai` && choice.id === DEFAULT_OPENAI_MODEL) ?? choices.find((choice) => choice.provider === `openai-codex` && choice.id === DEFAULT_CODEX_MODEL) ?? choices[0];
+	const defaultChoice = choices.find((choice) => choice.provider === `anthropic` && choice.id === DEFAULT_ANTHROPIC_MODEL) ?? choices.find((choice) => choice.provider === `openai` && choice.id === DEFAULT_OPENAI_MODEL) ?? choices.find((choice) => choice.provider === `openai-codex` && choice.id === DEFAULT_CODEX_MODEL) ?? choices.find((choice) => choice.provider === `deepseek` && choice.id === DEFAULT_DEEPSEEK_MODEL) ?? choices[0];
 	return {
 		choices,
 		defaultChoice
@@ -998,9 +1002,10 @@ async function generateTitle(userMessage, llmCall, onFallback) {
 	}
 }
 function buildHortonSystemPrompt(workingDirectory, opts = {}) {
-	const docsTools = opts.hasDocsSupport ? `\n- search_durable_agents_docs: hybrid search over the built-in Durable Agents docs index` : ``;
+	const docsTools = opts.hasDocsSupport ? `\n- search_electric_agents_docs: hybrid search over the built-in Electric Agents docs index` : ``;
+	const eventSourceTools = opts.hasEventSourceTools ? `\n- list_event_sources: list external webhook/event feeds you can subscribe to, including available buckets and parameters\n- subscribe_event_source: subscribe yourself to one of those feeds or buckets so matching future events wake you\n- list_event_source_subscriptions: list your active event source subscriptions\n- unsubscribe_event_source: remove one of your event source subscriptions by id` : ``;
 	const skillsTools = opts.hasSkills ? `\n- use_skill: load a skill (knowledge, instructions, or a tutorial) into your context to help with the user's request\n- remove_skill: unload a skill from context when you're done with it` : ``;
-	const docsGuidance = opts.hasDocsSupport ? `\n- For ANY question about Electric Agents, Durable Agents, or this framework, ALWAYS use search_durable_agents_docs FIRST. Do not use web_search or fetch_url for Electric Agents topics unless the docs search returns no useful results.\n- The search tool returns chunk content directly — you do not need to read the source files.\n- Use repo read/bash tools only for non-doc files or when you need to inspect exact implementation code in the workspace.` : ``;
+	const docsGuidance = opts.hasDocsSupport ? `\n- For ANY question about Electric Agents or this framework, ALWAYS use search_electric_agents_docs FIRST. Do not use web_search or fetch_url for Electric Agents topics unless the docs search returns no useful results.\n- The search tool returns chunk content directly — you do not need to read the source files.\n- Use repo read/bash tools only for non-doc files or when you need to inspect exact implementation code in the workspace.` : ``;
 	const skillsGuidance = opts.hasSkills ? `\n# Skills\nYou have access to skills — specialized knowledge and guided workflows you can load on demand. Your context includes a skills catalog listing what's available. When the user's request matches a skill's description or keywords, load it with use_skill.
 
 Some skills are user-invocable — the user can trigger them with a slash command like \`/quickstart\`. When you see a message starting with \`/\` followed by a skill name, load that skill immediately with use_skill. Pass any text after the skill name as args.
@@ -1019,7 +1024,7 @@ Do NOT load a skill and then ignore its instructions. The skill is there because
 When a user is new or asks how to get started with Electric Agents, **don't assume a single path**. Present the options and let them choose:
 
 - **Learn the concepts first** → Explain what Electric Agents is, answer questions, point to docs.
-  Use search_durable_agents_docs to look up answers. Only load the quickstart skill if the user explicitly asks for a hands-on guided tutorial.
+  Use search_electric_agents_docs to look up answers. Only load the quickstart skill if the user explicitly asks for a hands-on guided tutorial.
 
 - **Hands-on guided tutorial** → Load the quickstart skill (or tell them to type \`/quickstart\`).
   This is a step-by-step build that takes them from zero to a running app.
@@ -1029,11 +1034,11 @@ When a user is new or asks how to get started with Electric Agents, **don't assu
   This sets up project structure and orients them in the codebase.
 
 - **Have a specific question?** → Answer it directly.
-  Use search_durable_agents_docs first, then fall back to fetch_url or general knowledge if needed.
+  Use search_electric_agents_docs first, then fall back to fetch_url or general knowledge if needed.
 
 Don't force onboarding. If someone just wants to chat or code, let them. When in doubt, ask what they'd like to do rather than picking a path for them.`;
 	const docsUrlGuidance = opts.docsUrl ? `\n# Electric Agents documentation
-- ${opts.hasDocsSupport ? `If search_durable_agents_docs is available, use it first (faster, hybrid search).` : `Use fetch_url to look up documentation pages.`}
+- ${opts.hasDocsSupport ? `If search_electric_agents_docs is available, use it first (faster, hybrid search).` : `Use fetch_url to look up documentation pages.`}
 - The Electric Agents docs site is at ${opts.docsUrl}
 - The docs site covers: Usage (entity definition, handlers, tools, state, spawning, coordination, waking, shared state, client integration, app setup), Reference (handler context, entity definitions, configurations, tools, state proxies, wake events, registries), Entities (Horton, Worker), and Patterns (Manager-Worker, Pipeline, Map-Reduce, Dispatcher, Blackboard, Reactive Observers).
 - For general coding questions unrelated to Electric Agents, use web_search or your own knowledge.` : ``;
@@ -1052,8 +1057,8 @@ When a user opens with a greeting ("hi", "hello", "hey", etc.) or a broad statem
 - web_search: search the web
 - fetch_url: fetch and convert a URL to markdown
 - spawn_worker: dispatch a subagent for an isolated task
-- send: send a message to an Electric Agent/entity by entity URL
-${docsTools}${skillsTools}
+- send: send a message to an Electric Agent/entity. To schedule future work for yourself, call send with self: true and afterMs.
+${eventSourceTools}${docsTools}${skillsTools}
 
 # Working with files
 - Prefer edit over write when modifying existing files.
@@ -1086,6 +1091,11 @@ Report outcomes faithfully. If a command failed, say so with the relevant output
 Working directory: ${workingDirectory}
 The current year is ${new Date().getFullYear()}.`;
 }
+function getToolName(tool) {
+	if (typeof tool !== `object` || tool === null) return null;
+	const name = tool.name;
+	return typeof name === `string` ? name : null;
+}
 function createHortonTools(workingDirectory, ctx, readSet, opts = {}) {
 	return [
 		createBashTool(workingDirectory),
@@ -1100,7 +1110,7 @@ function createHortonTools(workingDirectory, ctx, readSet, opts = {}) {
 			logPrefix: opts.logPrefix ?? `[horton]`
 		})] : [fetchUrlTool],
 		createSpawnWorkerTool(ctx, opts.modelConfig),
-		createSendTool(ctx.send),
+		createSendTool(ctx.send, { selfEntityUrl: ctx.entityUrl }),
 		...opts.docsSearchTool ? [opts.docsSearchTool] : []
 	];
 }
@@ -1114,11 +1124,14 @@ function payloadToTitleText(payload) {
 	return String(payload);
 }
 async function extractFirstUserMessage(ctx) {
-	const firstMessage = await queryOnce((q) => q.from({ inbox: ctx.db.collections.inbox }).where(({ inbox }) => not(eq(inbox.from, `system`))).orderBy(({ inbox }) => inbox._seq, `asc`).findOne());
+	const firstMessage = ctx.db.collections.inbox.toArray.filter((message) => message.from !== `system`).sort((left, right) => messageSeq(left) - messageSeq(right))[0];
 	if (!firstMessage) return null;
 	const text = payloadToTitleText(firstMessage.payload);
 	return text.length > 0 ? text : null;
 }
+function messageSeq(message) {
+	return typeof message._seq === `number` ? message._seq : -1;
+}
 function readAgentsMd(workingDirectory) {
 	const agentsMdPath = path.join(workingDirectory, `AGENTS.md`);
 	try {
@@ -1152,6 +1165,7 @@ function createAssistantHandler(options) {
 			...skillsRegistry && skillsRegistry.catalog.size > 0 ? createSkillTools(skillsRegistry, ctx) : [],
 			...mcp.tools()
 		];
+		const hasEventSourceTools = tools.some((tool) => getToolName(tool) === `list_event_sources`);
 		const titlePromise = ctx.firstWake && !ctx.tags.title ? (async () => {
 			const firstUserMessage = await extractFirstUserMessage(ctx);
 			if (!firstUserMessage) return;
@@ -1238,7 +1252,8 @@ function createAssistantHandler(options) {
 				hasSkills,
 				docsUrl,
 				modelProvider: modelConfig.provider,
-				modelId: String(modelConfig.model)
+				modelId: String(modelConfig.model),
+				hasEventSourceTools
 			}),
 			...modelConfig,
 			tools,
@@ -1278,15 +1293,7 @@ function registerHorton(registry, options) {
 		creationSchema: hortonCreationSchema,
 		handler: assistantHandler
 	});
-	const typeNames = [`horton`];
-	if (streamFn) {
-		registry.define(`chat`, {
-			description: `Compatibility alias for the built-in assistant type.`,
-			handler: assistantHandler
-		});
-		typeNames.push(`chat`);
-	}
-	return typeNames;
+	return [`horton`];
 }
 
 //#endregion
@@ -1350,7 +1357,7 @@ function buildToolsForWorker(tools, workingDirectory, ctx, readSet) {
 			out.push(createSpawnWorkerTool(ctx));
 			break;
 		case `send`:
-			out.push(createSendTool(ctx.send));
+			out.push(createSendTool(ctx.send, { selfEntityUrl: ctx.entityUrl }));
 			break;
 	}
 	return out;
@@ -1479,6 +1486,27 @@ function registerWorker(registry, options) {
 //#endregion
 //#region src/bootstrap.ts
 const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = `/_electric/builtin-agent-handler`;
+function toolName(tool) {
+	return typeof tool.name === `string` ? tool.name : null;
+}
+function dedupeToolsByName(tools) {
+	const seen = new Set();
+	const deduped = [];
+	for (const tool of tools) {
+		const name = toolName(tool);
+		if (name && seen.has(name)) continue;
+		if (name) seen.add(name);
+		deduped.push(tool);
+	}
+	return deduped;
+}
+function createBuiltinElectricTools(custom) {
+	return async (context) => {
+		const builtinTools = createEventSourceTools(context);
+		const customTools = custom ? await custom(context) : [];
+		return dedupeToolsByName([...builtinTools, ...customTools]);
+	};
+}
 async function createBuiltinAgentHandler(options) {
 	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
 	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
@@ -1521,7 +1549,7 @@ async function createBuiltinAgentHandler(options) {
 		defaultDispatchPolicyForType,
 		serverHeaders,
 		idleTimeout: 5 * 6e4,
-		createElectricTools,
+		createElectricTools: createBuiltinElectricTools(createElectricTools),
 		publicUrl,
 		name: runtimeName ?? `builtin-agents`
 	});
@@ -1850,4 +1878,4 @@ async function runBuiltinAgentsEntrypoint({ env = process.env, cwd = process.cwd
 }
 
 //#endregion
-export { BuiltinAgentsServer, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, WORKER_TOOL_NAMES, braveSearchTool, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };
+export { BuiltinAgentsServer, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, WORKER_TOOL_NAMES, braveSearchTool, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@electric-ax/agents",
-  "version": "0.4.6",
+  "version": "0.4.9",
   "description": "Built-in Electric Agents runtimes such as Horton and worker",
   "repository": {
     "type": "git",
@@ -49,7 +49,7 @@
     "sqlite-vec": "^0.1.9",
     "zod": "^4.3.6",
     "@electric-ax/agents-mcp": "0.2.2",
-    "@electric-ax/agents-runtime": "0.3.2"
+    "@electric-ax/agents-runtime": "0.3.5"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -58,7 +58,7 @@
     "cross-env": "^10.1.0",
     "tsdown": "^0.9.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.0.0",
+    "typescript": "^5.9.3",
     "vitest": "^4.1.0"
   },
   "files": [

package/skills/quickstart.md

@@ -100,7 +100,7 @@ IMPORTANT: Never write files until the user explicitly confirms. "Ask to write"
 
 - **Continue building** — add an HTTP API route and a React frontend to this app so users can interact with the analyzer from the browser.
 - **Start a new app** — use the `agents-chat-starter` template for a full multi-agent chat app with rooms, agent spawning, and a Slack-style UI. Load the init skill or tell them to type `/init`.
-- **Explore the docs** — read about other coordination patterns (blackboard, pipeline, map-reduce), dive into the API reference, or learn about shared state, context assembly, and other advanced features. Use `search_durable_agents_docs` to look things up.
+- **Explore the docs** — read about other coordination patterns (blackboard, pipeline, map-reduce), dive into the API reference, or learn about shared state, context assembly, and other advanced features. Use `search_electric_agents_docs` to look things up.
 
 Wait for the user to choose. Only proceed to Step 4 if they want to continue building.
 
@@ -116,7 +116,7 @@ Wait for the user to choose. Only proceed to Step 4 if they want to continue bui
 - `server.ts` is at the working directory root. Entity files go in `entities/`.
 - Worker spawn args MUST include `tools` array (at least one tool, e.g. `tools: ["bash"]`).
 - Use `edit` tool for small changes (like updating server.ts). Use `write` for full entity file updates.
-- If the user asks a question about Electric Agents concepts, APIs, or patterns between steps, use the `search_durable_agents_docs` tool to look up the answer in the built-in documentation before guessing or searching the web.
+- If the user asks a question about Electric Agents concepts, APIs, or patterns between steps, use the `search_electric_agents_docs` tool to look up the answer in the built-in documentation before guessing or searching the web.
 
 ---