@electric-ax/agents 0.4.8 → 0.4.10

package/dist/entrypoint.js

@@ -3,9 +3,8 @@ import path from "node:path";
 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 { MOONSHOT_API_BASE_URL, MOONSHOT_PROVIDER, appendPathToUrl, completeWithLowCostModel, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillTools, createSkillsRegistry, db, detectAvailableProviders, getMoonshotApiKey, getMoonshotModels, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
 import { braveSearchTool, createBashTool, createEditTool, createEventSourceTools, createFetchUrlTool, createReadFileTool, createSendTool, createWriteTool, fetchUrlTool } from "@electric-ax/agents-runtime/tools";
-import { eq, not, queryOnce } from "@durable-streams/state";
 import { z } from "zod";
 import { createHash } from "node:crypto";
 import fs$1 from "node:fs/promises";
@@ -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({
@@ -775,6 +774,7 @@ function createSpawnWorkerTool(ctx, modelConfig) {
 
 //#endregion
 //#region src/model-catalog.ts
+const MODEL_INPUTS_SCHEMA_DEF = `electricModelInputs`;
 const REASONING_EFFORT_VALUES = [
 	`auto`,
 	`minimal`,
@@ -786,13 +786,15 @@ 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`;
+const DEFAULT_MOONSHOT_MODEL = `kimi-k2.6`;
 function modelValue(provider, id) {
 	return `${provider}:${id}`;
 }
-function providerLabel(provider) {
+function builtinModelProviderLabel(provider) {
 	if (provider === `anthropic`) return `Anthropic`;
 	if (provider === `openai-codex`) return `OpenAI Codex`;
 	if (provider === `deepseek`) return `DeepSeek`;
+	if (provider === MOONSHOT_PROVIDER) return `Kimi`;
 	return `OpenAI`;
 }
 function configuredProviders() {
@@ -804,7 +806,8 @@ function mockFallbackCatalog() {
 		id: DEFAULT_ANTHROPIC_MODEL,
 		label: `Anthropic ${DEFAULT_ANTHROPIC_MODEL}`,
 		value: modelValue(`anthropic`, DEFAULT_ANTHROPIC_MODEL),
-		reasoning: true
+		reasoning: true,
+		input: [`text`, `image`]
 	};
 	return {
 		choices: [fallback],
@@ -822,6 +825,9 @@ async function fetchAvailableModelIds(provider) {
 		}) : provider === `deepseek` ? await fetch(`https://api.deepseek.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.DEEPSEEK_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
+		}) : provider === MOONSHOT_PROVIDER ? await fetch(`${MOONSHOT_API_BASE_URL}/models`, {
+			headers: { authorization: `Bearer ${getMoonshotApiKey() ?? ``}` },
+			signal: AbortSignal.timeout(3e3)
 		}) : await fetch(`https://api.openai.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.OPENAI_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
@@ -835,24 +841,42 @@ async function fetchAvailableModelIds(provider) {
 		return null;
 	}
 }
-async function choicesForProvider(provider) {
-	const knownModels = getModels(provider);
-	if (provider === `openai-codex`) return knownModels.map((model) => ({
+function knownModelsForProvider(provider) {
+	return provider === MOONSHOT_PROVIDER ? getMoonshotModels() : getModels(provider);
+}
+function choiceForKnownModel(provider, model) {
+	return {
 		provider,
 		id: model.id,
-		label: `${providerLabel(provider)} ${model.name}`,
+		label: `${builtinModelProviderLabel(provider)} ${model.name}`,
 		value: modelValue(provider, model.id),
-		reasoning: model.reasoning
-	}));
+		reasoning: model.reasoning,
+		input: model.input
+	};
+}
+function listBuiltinModelChoices(providers) {
+	return providers.flatMap((provider) => knownModelsForProvider(provider).map((model) => choiceForKnownModel(provider, model)));
+}
+async function choicesForProvider(provider) {
+	const knownChoices = listBuiltinModelChoices([provider]);
+	if (provider === `openai-codex`) return knownChoices;
 	const availableIds = await fetchAvailableModelIds(provider);
-	const models = availableIds === null ? knownModels : knownModels.filter((model) => availableIds.has(model.id));
-	return models.map((model) => ({
-		provider,
-		id: model.id,
-		label: `${providerLabel(provider)} ${model.name}`,
-		value: modelValue(provider, model.id),
-		reasoning: model.reasoning
-	}));
+	return availableIds === null ? knownChoices : knownChoices.filter((choice) => availableIds.has(choice.id));
+}
+function enabledModelSet(values) {
+	if (!values) return null;
+	const enabled = new Set();
+	for (const value of values) {
+		const trimmed = value.trim();
+		if (trimmed) enabled.add(trimmed);
+	}
+	return enabled.size > 0 ? enabled : null;
+}
+function filterChoicesByEnabledModels(choices, values) {
+	const enabled = enabledModelSet(values);
+	if (!enabled) return choices;
+	const filtered = choices.filter((choice) => enabled.has(choice.value));
+	return filtered.length > 0 ? filtered : choices;
 }
 function withProviderPayloadDefaults(config, choice, reasoningEffort) {
 	if (choice.provider !== `openai` && choice.provider !== `openai-codex` || !choice.reasoning) return config;
@@ -880,9 +904,10 @@ function parseReasoningEffort(value) {
 async function createBuiltinModelCatalog(options = {}) {
 	const providers = configuredProviders();
 	if (providers.length === 0 && options.allowMockFallback) return mockFallbackCatalog();
-	const choices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
+	const providerChoices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
+	const choices = filterChoicesByEnabledModels(providerChoices, options.enabledModelValues);
 	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.find((choice) => choice.provider === `deepseek` && choice.id === DEFAULT_DEEPSEEK_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.find((choice) => choice.provider === MOONSHOT_PROVIDER && choice.id === DEFAULT_MOONSHOT_MODEL) ?? choices[0];
 	return {
 		choices,
 		defaultChoice
@@ -898,13 +923,24 @@ function resolveBuiltinModelConfig(catalog, args) {
 		provider: choice.provider,
 		model: choice.id,
 		...reasoningEffort && { reasoningEffort },
-		...choice.provider === `openai-codex` && { getApiKey: () => readCodexAccessToken() }
+		...choice.provider === `openai-codex` && { getApiKey: () => readCodexAccessToken() },
+		...choice.provider === MOONSHOT_PROVIDER && { getApiKey: () => getMoonshotApiKey() }
 	};
 	return withProviderPayloadDefaults(config, choice, reasoningEffort);
 }
 function modelChoiceValues(catalog) {
 	return catalog.choices.map((choice) => choice.value);
 }
+function modelInputSchemaDefs(catalog) {
+	return { [MODEL_INPUTS_SCHEMA_DEF]: {
+		type: `object`,
+		properties: Object.fromEntries(catalog.choices.map((choice) => [choice.value, {
+			type: `array`,
+			items: { enum: [`text`, `image`] },
+			default: choice.input
+		}]))
+	} };
+}
 
 //#endregion
 //#region src/agents/horton.ts
@@ -1002,10 +1038,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.
@@ -1024,7 +1060,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.
@@ -1034,11 +1070,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.` : ``;
@@ -1123,12 +1159,45 @@ function payloadToTitleText(payload) {
 	}
 	return String(payload);
 }
+function attachmentTitleText(attachment) {
+	const mimeType = typeof attachment.mimeType === `string` ? attachment.mimeType : ``;
+	const filename = typeof attachment.filename === `string` && attachment.filename.trim() ? attachment.filename.trim() : typeof attachment.id === `string` ? attachment.id : `attachment`;
+	const kind = mimeType.startsWith(`image/`) ? `image` : `file`;
+	return `Attached ${kind}: ${filename}`;
+}
+function attachmentsForInboxMessage(ctx, inboxKey) {
+	const manifests = ctx.db.collections.manifests?.toArray;
+	if (!Array.isArray(manifests)) return [];
+	return manifests.filter((entry) => {
+		if (!entry || typeof entry !== `object`) return false;
+		const attachment = entry;
+		if (attachment.kind !== `attachment`) return false;
+		if (attachment.role !== `input`) return false;
+		const subject = attachment.subject;
+		return subject !== null && typeof subject === `object` && !Array.isArray(subject) && subject.type === `inbox` && subject.key === inboxKey;
+	});
+}
+function messageTitleText(ctx, message) {
+	const pieces = [];
+	const text = payloadToTitleText(message.payload).trim();
+	if (text) pieces.push(text);
+	const key = typeof message.key === `string` ? message.key : null;
+	const attachments = key ? attachmentsForInboxMessage(ctx, key) : [];
+	for (const attachment of attachments) {
+		const attachmentText = attachmentTitleText(attachment);
+		if (attachmentText) pieces.push(attachmentText);
+	}
+	return pieces.join(`\n`);
+}
 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);
+	const text = messageTitleText(ctx, firstMessage);
 	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 {
@@ -1163,7 +1232,7 @@ function createAssistantHandler(options) {
 			...mcp.tools()
 		];
 		const hasEventSourceTools = tools.some((tool) => getToolName(tool) === `list_event_sources`);
-		const titlePromise = ctx.firstWake && !ctx.tags.title ? (async () => {
+		const titlePromise = !ctx.tags.title ? (async () => {
 			const firstUserMessage = await extractFirstUserMessage(ctx);
 			if (!firstUserMessage) return;
 			let title = null;
@@ -1284,21 +1353,13 @@ function registerHorton(registry, options) {
 		model: z.enum(modelChoiceValues(modelCatalog)).default(modelCatalog.defaultChoice.value),
 		reasoningEffort: z.enum(REASONING_EFFORT_VALUES).default(`auto`).describe(`Reasoning effort for compatible reasoning models. Auto uses a safe provider default.`),
 		workingDirectory: z.string().optional().describe(`Working directory for file operations. Defaults to the server's configured cwd.`)
-	});
+	}).meta({ $defs: modelInputSchemaDefs(modelCatalog) });
 	registry.define(`horton`, {
 		description: `Friendly capable assistant — chat, code, research, dispatch`,
 		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
@@ -1512,10 +1573,13 @@ function createBuiltinElectricTools(custom) {
 	};
 }
 async function createBuiltinAgentHandler(options) {
-	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
-	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
+	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, enabledModelValues, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
+	const modelCatalog = await createBuiltinModelCatalog({
+		allowMockFallback: Boolean(streamFn),
+		enabledModelValues
+	});
 	if (!modelCatalog) {
-		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY or OPENAI_API_KEY`);
+		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or MOONSHOT_API_KEY`);
 		return null;
 	}
 	const cwd = workingDirectory ?? process.cwd();
@@ -1709,9 +1773,10 @@ var BuiltinAgentsServer = class {
 				publicUrl,
 				runtimeName: `builtin-agents`,
 				baseSkillsDir: this.options.baseSkillsDir,
+				enabledModelValues: this.options.enabledModelValues,
 				serverHeaders: pullWake.headers
 			});
-			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY or OPENAI_API_KEY must be set before starting builtin agents`);
+			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or MOONSHOT_API_KEY must be set before starting builtin agents`);
 			await registerBuiltinAgentTypes(this.bootstrap);
 			const registeredRunner = pullWake.registerRunner ? await this.registerPullWakeRunner(pullWake) : null;
 			this.pullWakeRunner = createPullWakeRunner({

package/dist/index.cjs

@@ -29,7 +29,6 @@ const __electric_ax_agents_runtime = __toESM(require("@electric-ax/agents-runtim
 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"));
@@ -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({
@@ -799,6 +798,7 @@ function createSpawnWorkerTool(ctx, modelConfig) {
 
 //#endregion
 //#region src/model-catalog.ts
+const MODEL_INPUTS_SCHEMA_DEF = `electricModelInputs`;
 const REASONING_EFFORT_VALUES = [
 	`auto`,
 	`minimal`,
@@ -810,13 +810,15 @@ 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`;
+const DEFAULT_MOONSHOT_MODEL = `kimi-k2.6`;
 function modelValue(provider, id) {
 	return `${provider}:${id}`;
 }
-function providerLabel(provider) {
+function builtinModelProviderLabel(provider) {
 	if (provider === `anthropic`) return `Anthropic`;
 	if (provider === `openai-codex`) return `OpenAI Codex`;
 	if (provider === `deepseek`) return `DeepSeek`;
+	if (provider === __electric_ax_agents_runtime.MOONSHOT_PROVIDER) return `Kimi`;
 	return `OpenAI`;
 }
 function configuredProviders() {
@@ -828,7 +830,8 @@ function mockFallbackCatalog() {
 		id: DEFAULT_ANTHROPIC_MODEL,
 		label: `Anthropic ${DEFAULT_ANTHROPIC_MODEL}`,
 		value: modelValue(`anthropic`, DEFAULT_ANTHROPIC_MODEL),
-		reasoning: true
+		reasoning: true,
+		input: [`text`, `image`]
 	};
 	return {
 		choices: [fallback],
@@ -846,6 +849,9 @@ async function fetchAvailableModelIds(provider) {
 		}) : provider === `deepseek` ? await fetch(`https://api.deepseek.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.DEEPSEEK_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
+		}) : provider === __electric_ax_agents_runtime.MOONSHOT_PROVIDER ? await fetch(`${__electric_ax_agents_runtime.MOONSHOT_API_BASE_URL}/models`, {
+			headers: { authorization: `Bearer ${(0, __electric_ax_agents_runtime.getMoonshotApiKey)() ?? ``}` },
+			signal: AbortSignal.timeout(3e3)
 		}) : await fetch(`https://api.openai.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.OPENAI_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
@@ -859,24 +865,42 @@ async function fetchAvailableModelIds(provider) {
 		return null;
 	}
 }
-async function choicesForProvider(provider) {
-	const knownModels = (0, __mariozechner_pi_ai.getModels)(provider);
-	if (provider === `openai-codex`) return knownModels.map((model) => ({
+function knownModelsForProvider(provider) {
+	return provider === __electric_ax_agents_runtime.MOONSHOT_PROVIDER ? (0, __electric_ax_agents_runtime.getMoonshotModels)() : (0, __mariozechner_pi_ai.getModels)(provider);
+}
+function choiceForKnownModel(provider, model) {
+	return {
 		provider,
 		id: model.id,
-		label: `${providerLabel(provider)} ${model.name}`,
+		label: `${builtinModelProviderLabel(provider)} ${model.name}`,
 		value: modelValue(provider, model.id),
-		reasoning: model.reasoning
-	}));
+		reasoning: model.reasoning,
+		input: model.input
+	};
+}
+function listBuiltinModelChoices(providers) {
+	return providers.flatMap((provider) => knownModelsForProvider(provider).map((model) => choiceForKnownModel(provider, model)));
+}
+async function choicesForProvider(provider) {
+	const knownChoices = listBuiltinModelChoices([provider]);
+	if (provider === `openai-codex`) return knownChoices;
 	const availableIds = await fetchAvailableModelIds(provider);
-	const models = availableIds === null ? knownModels : knownModels.filter((model) => availableIds.has(model.id));
-	return models.map((model) => ({
-		provider,
-		id: model.id,
-		label: `${providerLabel(provider)} ${model.name}`,
-		value: modelValue(provider, model.id),
-		reasoning: model.reasoning
-	}));
+	return availableIds === null ? knownChoices : knownChoices.filter((choice) => availableIds.has(choice.id));
+}
+function enabledModelSet(values) {
+	if (!values) return null;
+	const enabled = new Set();
+	for (const value of values) {
+		const trimmed = value.trim();
+		if (trimmed) enabled.add(trimmed);
+	}
+	return enabled.size > 0 ? enabled : null;
+}
+function filterChoicesByEnabledModels(choices, values) {
+	const enabled = enabledModelSet(values);
+	if (!enabled) return choices;
+	const filtered = choices.filter((choice) => enabled.has(choice.value));
+	return filtered.length > 0 ? filtered : choices;
 }
 function withProviderPayloadDefaults(config, choice, reasoningEffort) {
 	if (choice.provider !== `openai` && choice.provider !== `openai-codex` || !choice.reasoning) return config;
@@ -904,9 +928,10 @@ function parseReasoningEffort(value) {
 async function createBuiltinModelCatalog(options = {}) {
 	const providers = configuredProviders();
 	if (providers.length === 0 && options.allowMockFallback) return mockFallbackCatalog();
-	const choices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
+	const providerChoices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
+	const choices = filterChoicesByEnabledModels(providerChoices, options.enabledModelValues);
 	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.find((choice) => choice.provider === `deepseek` && choice.id === DEFAULT_DEEPSEEK_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.find((choice) => choice.provider === __electric_ax_agents_runtime.MOONSHOT_PROVIDER && choice.id === DEFAULT_MOONSHOT_MODEL) ?? choices[0];
 	return {
 		choices,
 		defaultChoice
@@ -922,13 +947,24 @@ function resolveBuiltinModelConfig(catalog, args) {
 		provider: choice.provider,
 		model: choice.id,
 		...reasoningEffort && { reasoningEffort },
-		...choice.provider === `openai-codex` && { getApiKey: () => (0, __electric_ax_agents_runtime.readCodexAccessToken)() }
+		...choice.provider === `openai-codex` && { getApiKey: () => (0, __electric_ax_agents_runtime.readCodexAccessToken)() },
+		...choice.provider === __electric_ax_agents_runtime.MOONSHOT_PROVIDER && { getApiKey: () => (0, __electric_ax_agents_runtime.getMoonshotApiKey)() }
 	};
 	return withProviderPayloadDefaults(config, choice, reasoningEffort);
 }
 function modelChoiceValues(catalog) {
 	return catalog.choices.map((choice) => choice.value);
 }
+function modelInputSchemaDefs(catalog) {
+	return { [MODEL_INPUTS_SCHEMA_DEF]: {
+		type: `object`,
+		properties: Object.fromEntries(catalog.choices.map((choice) => [choice.value, {
+			type: `array`,
+			items: { enum: [`text`, `image`] },
+			default: choice.input
+		}]))
+	} };
+}
 
 //#endregion
 //#region src/agents/horton.ts
@@ -1027,10 +1063,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.
@@ -1049,7 +1085,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.
@@ -1059,11 +1095,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.` : ``;
@@ -1148,12 +1184,45 @@ function payloadToTitleText(payload) {
 	}
 	return String(payload);
 }
+function attachmentTitleText(attachment) {
+	const mimeType = typeof attachment.mimeType === `string` ? attachment.mimeType : ``;
+	const filename = typeof attachment.filename === `string` && attachment.filename.trim() ? attachment.filename.trim() : typeof attachment.id === `string` ? attachment.id : `attachment`;
+	const kind = mimeType.startsWith(`image/`) ? `image` : `file`;
+	return `Attached ${kind}: ${filename}`;
+}
+function attachmentsForInboxMessage(ctx, inboxKey) {
+	const manifests = ctx.db.collections.manifests?.toArray;
+	if (!Array.isArray(manifests)) return [];
+	return manifests.filter((entry) => {
+		if (!entry || typeof entry !== `object`) return false;
+		const attachment = entry;
+		if (attachment.kind !== `attachment`) return false;
+		if (attachment.role !== `input`) return false;
+		const subject = attachment.subject;
+		return subject !== null && typeof subject === `object` && !Array.isArray(subject) && subject.type === `inbox` && subject.key === inboxKey;
+	});
+}
+function messageTitleText(ctx, message) {
+	const pieces = [];
+	const text = payloadToTitleText(message.payload).trim();
+	if (text) pieces.push(text);
+	const key = typeof message.key === `string` ? message.key : null;
+	const attachments = key ? attachmentsForInboxMessage(ctx, key) : [];
+	for (const attachment of attachments) {
+		const attachmentText = attachmentTitleText(attachment);
+		if (attachmentText) pieces.push(attachmentText);
+	}
+	return pieces.join(`\n`);
+}
 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);
+	const text = messageTitleText(ctx, firstMessage);
 	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 {
@@ -1188,7 +1257,7 @@ function createAssistantHandler(options) {
 			...__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 titlePromise = !ctx.tags.title ? (async () => {
 			const firstUserMessage = await extractFirstUserMessage(ctx);
 			if (!firstUserMessage) return;
 			let title = null;
@@ -1309,21 +1378,13 @@ function registerHorton(registry, options) {
 		model: zod.z.enum(modelChoiceValues(modelCatalog)).default(modelCatalog.defaultChoice.value),
 		reasoningEffort: zod.z.enum(REASONING_EFFORT_VALUES).default(`auto`).describe(`Reasoning effort for compatible reasoning models. Auto uses a safe provider default.`),
 		workingDirectory: zod.z.string().optional().describe(`Working directory for file operations. Defaults to the server's configured cwd.`)
-	});
+	}).meta({ $defs: modelInputSchemaDefs(modelCatalog) });
 	registry.define(`horton`, {
 		description: `Friendly capable assistant — chat, code, research, dispatch`,
 		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
@@ -1538,10 +1599,13 @@ function createBuiltinElectricTools(custom) {
 	};
 }
 async function createBuiltinAgentHandler(options) {
-	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
-	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
+	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, enabledModelValues, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
+	const modelCatalog = await createBuiltinModelCatalog({
+		allowMockFallback: Boolean(streamFn),
+		enabledModelValues
+	});
 	if (!modelCatalog) {
-		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY or OPENAI_API_KEY`);
+		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or MOONSHOT_API_KEY`);
 		return null;
 	}
 	const cwd = workingDirectory ?? process.cwd();
@@ -1745,9 +1809,10 @@ var BuiltinAgentsServer = class {
 				publicUrl,
 				runtimeName: `builtin-agents`,
 				baseSkillsDir: this.options.baseSkillsDir,
+				enabledModelValues: this.options.enabledModelValues,
 				serverHeaders: pullWake.headers
 			});
-			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY or OPENAI_API_KEY must be set before starting builtin agents`);
+			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or MOONSHOT_API_KEY must be set before starting builtin agents`);
 			await registerBuiltinAgentTypes(this.bootstrap);
 			const registeredRunner = pullWake.registerRunner ? await this.registerPullWakeRunner(pullWake) : null;
 			this.pullWakeRunner = (0, __electric_ax_agents_runtime.createPullWakeRunner)({
@@ -1919,6 +1984,7 @@ Object.defineProperty(exports, 'braveSearchTool', {
   }
 });
 exports.buildHortonSystemPrompt = buildHortonSystemPrompt
+exports.builtinModelProviderLabel = builtinModelProviderLabel
 exports.createAgentHandler = createAgentHandler
 exports.createBuiltinAgentHandler = createBuiltinAgentHandler
 exports.createBuiltinElectricTools = createBuiltinElectricTools
@@ -1926,6 +1992,7 @@ exports.createHortonDocsSupport = createHortonDocsSupport
 exports.createHortonTools = createHortonTools
 exports.createSpawnWorkerTool = createSpawnWorkerTool
 exports.generateTitle = generateTitle
+exports.listBuiltinModelChoices = listBuiltinModelChoices
 exports.registerAgentTypes = registerAgentTypes
 exports.registerBuiltinAgentTypes = registerBuiltinAgentTypes
 exports.registerHorton = registerHorton

package/dist/index.d.cts

@@ -20,6 +20,7 @@ interface BuiltinAgentHandlerOptions {
   serveEndpoint?: string;
   workingDirectory?: string;
   streamFn?: StreamFn;
+  enabledModelValues?: ReadonlyArray<string> | null;
   publicUrl?: string;
   runtimeName?: string;
   /** Override for the built-in skills directory; required when embedders bundle this package. */
@@ -79,6 +80,8 @@ interface BuiltinAgentsServerOptions {
   loadProjectMcpConfig?: boolean;
   /** Override for the built-in skills directory; required when embedders bundle this package. */
   baseSkillsDir?: string;
+  /** Restrict the model values exposed by built-in agent creation schemas. */
+  enabledModelValues?: ReadonlyArray<string> | null;
   createElectricTools?: NonNullable<ProcessWakeConfig[`createElectricTools`]>;
 }
 declare class BuiltinAgentsServer {
@@ -125,23 +128,31 @@ declare function runBuiltinAgentsEntrypoint({
 //#endregion
 //#region src/model-catalog.d.ts
 type BuiltinModelProvider = AvailableProvider;
+type BuiltinModelInput = `text` | `image`;
 interface BuiltinModelChoice {
   provider: BuiltinModelProvider;
   id: string;
   label: string;
   value: string;
   reasoning: boolean;
+  input: Array<BuiltinModelInput>;
 }
 interface BuiltinModelCatalog {
   choices: Array<BuiltinModelChoice>;
   defaultChoice: BuiltinModelChoice;
 }
+interface BuiltinModelCatalogOptions {
+  allowMockFallback?: boolean;
+  enabledModelValues?: ReadonlyArray<string> | null;
+}
 declare const REASONING_EFFORT_VALUES: readonly ["auto", "minimal", "low", "medium", "high"];
 type BuiltinReasoningEffort = (typeof REASONING_EFFORT_VALUES)[number];
 type ExplicitReasoningEffort = Exclude<BuiltinReasoningEffort, `auto`>;
 type BuiltinAgentModelConfig = Pick<AgentConfig, `model` | `provider` | `onPayload` | `getApiKey`> & {
   reasoningEffort?: ExplicitReasoningEffort;
 };
+declare function builtinModelProviderLabel(provider: BuiltinModelProvider): string;
+declare function listBuiltinModelChoices(providers: ReadonlyArray<BuiltinModelProvider>): Array<BuiltinModelChoice>;
 declare function resolveBuiltinModelConfig(catalog: BuiltinModelCatalog, args: Readonly<Record<string, unknown>>): BuiltinAgentModelConfig;
 
 //#endregion
@@ -203,4 +214,4 @@ declare function createHortonDocsSupport(workingDirectory: string, opts?: {
 }): HortonDocsSupport | null;
 
 //#endregion
-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 };
+export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, BuiltinElectricToolsFactory, BuiltinModelCatalogOptions, BuiltinModelChoice, BuiltinModelProvider, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, McpConfig, McpListedEntry, McpRegistry, McpServerConfig, RegistrySnapshot, RegistrySubscriber, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, braveSearchTool, buildHortonSystemPrompt, builtinModelProviderLabel, createAgentHandler, createBuiltinAgentHandler, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, listBuiltinModelChoices, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 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 { ChangeEvent } from "@durable-streams/state";
 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";
@@ -20,6 +20,7 @@ interface BuiltinAgentHandlerOptions {
   serveEndpoint?: string;
   workingDirectory?: string;
   streamFn?: StreamFn;
+  enabledModelValues?: ReadonlyArray<string> | null;
   publicUrl?: string;
   runtimeName?: string;
   /** Override for the built-in skills directory; required when embedders bundle this package. */
@@ -79,6 +80,8 @@ interface BuiltinAgentsServerOptions {
   loadProjectMcpConfig?: boolean;
   /** Override for the built-in skills directory; required when embedders bundle this package. */
   baseSkillsDir?: string;
+  /** Restrict the model values exposed by built-in agent creation schemas. */
+  enabledModelValues?: ReadonlyArray<string> | null;
   createElectricTools?: NonNullable<ProcessWakeConfig[`createElectricTools`]>;
 }
 declare class BuiltinAgentsServer {
@@ -125,23 +128,31 @@ declare function runBuiltinAgentsEntrypoint({
 //#endregion
 //#region src/model-catalog.d.ts
 type BuiltinModelProvider = AvailableProvider;
+type BuiltinModelInput = `text` | `image`;
 interface BuiltinModelChoice {
   provider: BuiltinModelProvider;
   id: string;
   label: string;
   value: string;
   reasoning: boolean;
+  input: Array<BuiltinModelInput>;
 }
 interface BuiltinModelCatalog {
   choices: Array<BuiltinModelChoice>;
   defaultChoice: BuiltinModelChoice;
 }
+interface BuiltinModelCatalogOptions {
+  allowMockFallback?: boolean;
+  enabledModelValues?: ReadonlyArray<string> | null;
+}
 declare const REASONING_EFFORT_VALUES: readonly ["auto", "minimal", "low", "medium", "high"];
 type BuiltinReasoningEffort = (typeof REASONING_EFFORT_VALUES)[number];
 type ExplicitReasoningEffort = Exclude<BuiltinReasoningEffort, `auto`>;
 type BuiltinAgentModelConfig = Pick<AgentConfig, `model` | `provider` | `onPayload` | `getApiKey`> & {
   reasoningEffort?: ExplicitReasoningEffort;
 };
+declare function builtinModelProviderLabel(provider: BuiltinModelProvider): string;
+declare function listBuiltinModelChoices(providers: ReadonlyArray<BuiltinModelProvider>): Array<BuiltinModelChoice>;
 declare function resolveBuiltinModelConfig(catalog: BuiltinModelCatalog, args: Readonly<Record<string, unknown>>): BuiltinAgentModelConfig;
 
 //#endregion
@@ -203,4 +214,4 @@ declare function createHortonDocsSupport(workingDirectory: string, opts?: {
 }): HortonDocsSupport | null;
 
 //#endregion
-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 };
+export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, BuiltinElectricToolsFactory, BuiltinModelCatalogOptions, BuiltinModelChoice, BuiltinModelProvider, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, McpConfig, McpListedEntry, McpRegistry, McpServerConfig, RegistrySnapshot, RegistrySubscriber, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, braveSearchTool, buildHortonSystemPrompt, builtinModelProviderLabel, createAgentHandler, createBuiltinAgentHandler, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, listBuiltinModelChoices, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/dist/index.js

@@ -1,11 +1,10 @@
 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 { MOONSHOT_API_BASE_URL, MOONSHOT_PROVIDER, appendPathToUrl, completeWithLowCostModel, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillTools, createSkillsRegistry, db, detectAvailableProviders, getMoonshotApiKey, getMoonshotModels, 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";
@@ -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({
@@ -775,6 +774,7 @@ function createSpawnWorkerTool(ctx, modelConfig) {
 
 //#endregion
 //#region src/model-catalog.ts
+const MODEL_INPUTS_SCHEMA_DEF = `electricModelInputs`;
 const REASONING_EFFORT_VALUES = [
 	`auto`,
 	`minimal`,
@@ -786,13 +786,15 @@ 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`;
+const DEFAULT_MOONSHOT_MODEL = `kimi-k2.6`;
 function modelValue(provider, id) {
 	return `${provider}:${id}`;
 }
-function providerLabel(provider) {
+function builtinModelProviderLabel(provider) {
 	if (provider === `anthropic`) return `Anthropic`;
 	if (provider === `openai-codex`) return `OpenAI Codex`;
 	if (provider === `deepseek`) return `DeepSeek`;
+	if (provider === MOONSHOT_PROVIDER) return `Kimi`;
 	return `OpenAI`;
 }
 function configuredProviders() {
@@ -804,7 +806,8 @@ function mockFallbackCatalog() {
 		id: DEFAULT_ANTHROPIC_MODEL,
 		label: `Anthropic ${DEFAULT_ANTHROPIC_MODEL}`,
 		value: modelValue(`anthropic`, DEFAULT_ANTHROPIC_MODEL),
-		reasoning: true
+		reasoning: true,
+		input: [`text`, `image`]
 	};
 	return {
 		choices: [fallback],
@@ -822,6 +825,9 @@ async function fetchAvailableModelIds(provider) {
 		}) : provider === `deepseek` ? await fetch(`https://api.deepseek.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.DEEPSEEK_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
+		}) : provider === MOONSHOT_PROVIDER ? await fetch(`${MOONSHOT_API_BASE_URL}/models`, {
+			headers: { authorization: `Bearer ${getMoonshotApiKey() ?? ``}` },
+			signal: AbortSignal.timeout(3e3)
 		}) : await fetch(`https://api.openai.com/v1/models`, {
 			headers: { authorization: `Bearer ${process.env.OPENAI_API_KEY ?? ``}` },
 			signal: AbortSignal.timeout(3e3)
@@ -835,24 +841,42 @@ async function fetchAvailableModelIds(provider) {
 		return null;
 	}
 }
-async function choicesForProvider(provider) {
-	const knownModels = getModels(provider);
-	if (provider === `openai-codex`) return knownModels.map((model) => ({
+function knownModelsForProvider(provider) {
+	return provider === MOONSHOT_PROVIDER ? getMoonshotModels() : getModels(provider);
+}
+function choiceForKnownModel(provider, model) {
+	return {
 		provider,
 		id: model.id,
-		label: `${providerLabel(provider)} ${model.name}`,
+		label: `${builtinModelProviderLabel(provider)} ${model.name}`,
 		value: modelValue(provider, model.id),
-		reasoning: model.reasoning
-	}));
+		reasoning: model.reasoning,
+		input: model.input
+	};
+}
+function listBuiltinModelChoices(providers) {
+	return providers.flatMap((provider) => knownModelsForProvider(provider).map((model) => choiceForKnownModel(provider, model)));
+}
+async function choicesForProvider(provider) {
+	const knownChoices = listBuiltinModelChoices([provider]);
+	if (provider === `openai-codex`) return knownChoices;
 	const availableIds = await fetchAvailableModelIds(provider);
-	const models = availableIds === null ? knownModels : knownModels.filter((model) => availableIds.has(model.id));
-	return models.map((model) => ({
-		provider,
-		id: model.id,
-		label: `${providerLabel(provider)} ${model.name}`,
-		value: modelValue(provider, model.id),
-		reasoning: model.reasoning
-	}));
+	return availableIds === null ? knownChoices : knownChoices.filter((choice) => availableIds.has(choice.id));
+}
+function enabledModelSet(values) {
+	if (!values) return null;
+	const enabled = new Set();
+	for (const value of values) {
+		const trimmed = value.trim();
+		if (trimmed) enabled.add(trimmed);
+	}
+	return enabled.size > 0 ? enabled : null;
+}
+function filterChoicesByEnabledModels(choices, values) {
+	const enabled = enabledModelSet(values);
+	if (!enabled) return choices;
+	const filtered = choices.filter((choice) => enabled.has(choice.value));
+	return filtered.length > 0 ? filtered : choices;
 }
 function withProviderPayloadDefaults(config, choice, reasoningEffort) {
 	if (choice.provider !== `openai` && choice.provider !== `openai-codex` || !choice.reasoning) return config;
@@ -880,9 +904,10 @@ function parseReasoningEffort(value) {
 async function createBuiltinModelCatalog(options = {}) {
 	const providers = configuredProviders();
 	if (providers.length === 0 && options.allowMockFallback) return mockFallbackCatalog();
-	const choices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
+	const providerChoices = (await Promise.all(providers.map((provider) => choicesForProvider(provider)))).flat();
+	const choices = filterChoicesByEnabledModels(providerChoices, options.enabledModelValues);
 	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.find((choice) => choice.provider === `deepseek` && choice.id === DEFAULT_DEEPSEEK_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.find((choice) => choice.provider === MOONSHOT_PROVIDER && choice.id === DEFAULT_MOONSHOT_MODEL) ?? choices[0];
 	return {
 		choices,
 		defaultChoice
@@ -898,13 +923,24 @@ function resolveBuiltinModelConfig(catalog, args) {
 		provider: choice.provider,
 		model: choice.id,
 		...reasoningEffort && { reasoningEffort },
-		...choice.provider === `openai-codex` && { getApiKey: () => readCodexAccessToken() }
+		...choice.provider === `openai-codex` && { getApiKey: () => readCodexAccessToken() },
+		...choice.provider === MOONSHOT_PROVIDER && { getApiKey: () => getMoonshotApiKey() }
 	};
 	return withProviderPayloadDefaults(config, choice, reasoningEffort);
 }
 function modelChoiceValues(catalog) {
 	return catalog.choices.map((choice) => choice.value);
 }
+function modelInputSchemaDefs(catalog) {
+	return { [MODEL_INPUTS_SCHEMA_DEF]: {
+		type: `object`,
+		properties: Object.fromEntries(catalog.choices.map((choice) => [choice.value, {
+			type: `array`,
+			items: { enum: [`text`, `image`] },
+			default: choice.input
+		}]))
+	} };
+}
 
 //#endregion
 //#region src/agents/horton.ts
@@ -1003,10 +1039,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.
@@ -1025,7 +1061,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.
@@ -1035,11 +1071,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.` : ``;
@@ -1124,12 +1160,45 @@ function payloadToTitleText(payload) {
 	}
 	return String(payload);
 }
+function attachmentTitleText(attachment) {
+	const mimeType = typeof attachment.mimeType === `string` ? attachment.mimeType : ``;
+	const filename = typeof attachment.filename === `string` && attachment.filename.trim() ? attachment.filename.trim() : typeof attachment.id === `string` ? attachment.id : `attachment`;
+	const kind = mimeType.startsWith(`image/`) ? `image` : `file`;
+	return `Attached ${kind}: ${filename}`;
+}
+function attachmentsForInboxMessage(ctx, inboxKey) {
+	const manifests = ctx.db.collections.manifests?.toArray;
+	if (!Array.isArray(manifests)) return [];
+	return manifests.filter((entry) => {
+		if (!entry || typeof entry !== `object`) return false;
+		const attachment = entry;
+		if (attachment.kind !== `attachment`) return false;
+		if (attachment.role !== `input`) return false;
+		const subject = attachment.subject;
+		return subject !== null && typeof subject === `object` && !Array.isArray(subject) && subject.type === `inbox` && subject.key === inboxKey;
+	});
+}
+function messageTitleText(ctx, message) {
+	const pieces = [];
+	const text = payloadToTitleText(message.payload).trim();
+	if (text) pieces.push(text);
+	const key = typeof message.key === `string` ? message.key : null;
+	const attachments = key ? attachmentsForInboxMessage(ctx, key) : [];
+	for (const attachment of attachments) {
+		const attachmentText = attachmentTitleText(attachment);
+		if (attachmentText) pieces.push(attachmentText);
+	}
+	return pieces.join(`\n`);
+}
 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);
+	const text = messageTitleText(ctx, firstMessage);
 	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 {
@@ -1164,7 +1233,7 @@ function createAssistantHandler(options) {
 			...mcp.tools()
 		];
 		const hasEventSourceTools = tools.some((tool) => getToolName(tool) === `list_event_sources`);
-		const titlePromise = ctx.firstWake && !ctx.tags.title ? (async () => {
+		const titlePromise = !ctx.tags.title ? (async () => {
 			const firstUserMessage = await extractFirstUserMessage(ctx);
 			if (!firstUserMessage) return;
 			let title = null;
@@ -1285,21 +1354,13 @@ function registerHorton(registry, options) {
 		model: z.enum(modelChoiceValues(modelCatalog)).default(modelCatalog.defaultChoice.value),
 		reasoningEffort: z.enum(REASONING_EFFORT_VALUES).default(`auto`).describe(`Reasoning effort for compatible reasoning models. Auto uses a safe provider default.`),
 		workingDirectory: z.string().optional().describe(`Working directory for file operations. Defaults to the server's configured cwd.`)
-	});
+	}).meta({ $defs: modelInputSchemaDefs(modelCatalog) });
 	registry.define(`horton`, {
 		description: `Friendly capable assistant — chat, code, research, dispatch`,
 		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
@@ -1514,10 +1575,13 @@ function createBuiltinElectricTools(custom) {
 	};
 }
 async function createBuiltinAgentHandler(options) {
-	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
-	const modelCatalog = await createBuiltinModelCatalog({ allowMockFallback: Boolean(streamFn) });
+	const { agentServerUrl, serveEndpoint, workingDirectory, streamFn, enabledModelValues, createElectricTools, publicUrl, runtimeName, baseSkillsDir: baseSkillsDirOverride, serverHeaders, defaultDispatchPolicyForType } = options;
+	const modelCatalog = await createBuiltinModelCatalog({
+		allowMockFallback: Boolean(streamFn),
+		enabledModelValues
+	});
 	if (!modelCatalog) {
-		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY or OPENAI_API_KEY`);
+		serverLog.warn(`[builtin-agents] no supported model provider API key found — set ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or MOONSHOT_API_KEY`);
 		return null;
 	}
 	const cwd = workingDirectory ?? process.cwd();
@@ -1721,9 +1785,10 @@ var BuiltinAgentsServer = class {
 				publicUrl,
 				runtimeName: `builtin-agents`,
 				baseSkillsDir: this.options.baseSkillsDir,
+				enabledModelValues: this.options.enabledModelValues,
 				serverHeaders: pullWake.headers
 			});
-			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY or OPENAI_API_KEY must be set before starting builtin agents`);
+			if (!this.bootstrap) throw new Error(`ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, or MOONSHOT_API_KEY must be set before starting builtin agents`);
 			await registerBuiltinAgentTypes(this.bootstrap);
 			const registeredRunner = pullWake.registerRunner ? await this.registerPullWakeRunner(pullWake) : null;
 			this.pullWakeRunner = createPullWakeRunner({
@@ -1884,4 +1949,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, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };
+export { BuiltinAgentsServer, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, WORKER_TOOL_NAMES, braveSearchTool, buildHortonSystemPrompt, builtinModelProviderLabel, createAgentHandler, createBuiltinAgentHandler, createBuiltinElectricTools, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, listBuiltinModelChoices, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@electric-ax/agents",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "Built-in Electric Agents runtimes such as Horton and worker",
   "repository": {
     "type": "git",
@@ -38,7 +38,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@durable-streams/state": "https://pkg.pr.new/durable-streams/durable-streams/@durable-streams/state@5d5c217",
+    "@durable-streams/state": "^0.2.9",
     "@mariozechner/pi-agent-core": "^0.70.2",
     "@mariozechner/pi-ai": "^0.70.2",
     "@sinclair/typebox": "^0.34.48",
@@ -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.4"
+    "@electric-ax/agents-runtime": "0.3.6"
   },
   "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.
 
 ---