@electric-ax/agents 0.4.15 → 0.4.17

package/dist/entrypoint.js

@@ -4,7 +4,7 @@ import { cacheStores, getGlobalDispatcher, interceptors, setGlobalDispatcher } f
 import fs from "node:fs";
 import pino from "pino";
 import { fileURLToPath } from "node:url";
-import { MOONSHOT_API_BASE_URL, MOONSHOT_PROVIDER, appendPathToUrl, buildSkillSlashCommands, completeWithLowCostModel, createContextSkillLoader, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillsRegistry, db, detectAvailableProviders, getMoonshotApiKey, getMoonshotModel, getMoonshotModels, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
+import { MOONSHOT_API_BASE_URL, MOONSHOT_PROVIDER, appendPathToUrl, buildSkillSlashCommands, completeWithLowCostModel, createContextSkillLoader, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillsRegistry, db, detectAvailableProviders, getMoonshotApiKey, getMoonshotModel, getMoonshotModels, pgSync, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
 import { braveSearchTool, createBashTool, createEditTool, createEventSourceTools, createFetchUrlTool, createReadFileTool, createScheduleTools, createSendTool, createWriteTool } from "@electric-ax/agents-runtime/tools";
 import { chooseDefaultSandbox, isE2BAvailable, lazySandbox, remoteSandbox } from "@electric-ax/agents-runtime/sandbox";
 import { z } from "zod";
@@ -19,13 +19,19 @@ import { bridgeMcpTool, buildPromptTools, buildResourceTools, createRegistry, ke
 
 //#region src/durable-streams-cache.ts
 const MEMORY_CACHE_SIZE_BYTES = 100 * 1024 * 1024;
+let installed = false;
 function installDurableStreamsFetchCache(options = {}) {
 	if (options === false) return;
+	if (installed) {
+		console.warn(`[agents] installDurableStreamsFetchCache called more than once; ignoring`);
+		return;
+	}
 	const store = options.store === `sqlite` || options.sqliteLocation ? new cacheStores.SqliteCacheStore({
 		location: options.sqliteLocation,
 		maxCount: options.maxCount
 	}) : new cacheStores.MemoryCacheStore({ maxSize: MEMORY_CACHE_SIZE_BYTES });
 	setGlobalDispatcher(getGlobalDispatcher().compose(interceptors.cache({ store })));
+	installed = true;
 }
 
 //#endregion
@@ -806,6 +812,69 @@ function createSpawnWorkerTool(ctx, modelConfig) {
 	};
 }
 
+//#endregion
+//#region src/tools/observe-pg-sync.ts
+function asToolResult(value) {
+	return {
+		content: [{
+			type: `text`,
+			text: typeof value === `string` ? value : JSON.stringify(value, null, 2)
+		}],
+		details: {}
+	};
+}
+const PgSyncOperation = Type.Union([
+	Type.Literal(`insert`),
+	Type.Literal(`update`),
+	Type.Literal(`delete`)
+]);
+function createObservePgSyncTool(ctx) {
+	return {
+		name: `observe_pg_sync`,
+		label: `Observe Postgres Sync`,
+		description: `Observe an Electric Postgres shape stream and wake this agent when matching row changes arrive.`,
+		parameters: Type.Object({
+			url: Type.Optional(Type.String({ description: `Optional Electric shape endpoint URL. Defaults to the server-configured pg-sync URL.` })),
+			table: Type.String({
+				minLength: 1,
+				pattern: `\\S`,
+				description: `Postgres table name to observe.`
+			}),
+			columns: Type.Optional(Type.Array(Type.String(), { description: `Optional list of columns to include in the shape.` })),
+			where: Type.Optional(Type.String({ description: `Optional Electric shape WHERE clause.` })),
+			params: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Record(Type.String(), Type.String())])),
+			replica: Type.Optional(Type.Union([Type.Literal(`default`), Type.Literal(`full`)])),
+			wake: Type.Optional(Type.Object({
+				ops: Type.Optional(Type.Array(PgSyncOperation)),
+				debounceMs: Type.Optional(Type.Number())
+			}, { additionalProperties: false }))
+		}),
+		execute: async (_toolCallId, params) => {
+			const args = params;
+			if (typeof args.table !== `string` || args.table.trim().length === 0) throw new Error(`table is required`);
+			const source = pgSync({
+				url: args.url,
+				table: args.table,
+				columns: args.columns,
+				where: args.where,
+				params: args.params,
+				replica: args.replica
+			});
+			const wake = {
+				on: `change`,
+				...args.wake?.ops ? { ops: args.wake.ops } : {},
+				...args.wake?.debounceMs !== void 0 ? { debounceMs: args.wake.debounceMs } : {}
+			};
+			await ctx.observe(source, { wake });
+			return asToolResult({
+				sourceRef: source.sourceRef,
+				streamUrl: source.streamUrl,
+				wake
+			});
+		}
+	};
+}
+
 //#endregion
 //#region src/tools/fork.ts
 function createForkTool(ctx) {
@@ -860,6 +929,49 @@ Omit 'entityUrl' to fork your own session. Pass a different session's URL to for
 	};
 }
 
+//#endregion
+//#region src/tools/set-title.ts
+function createSetTitleTool(ctx) {
+	return {
+		name: `set_title`,
+		label: `Set Title`,
+		description: `Set the chat session title shown in the UI. Use this when the current title is missing, stale, misleading, or the user asks to rename the session. Provide a concise, human-readable title.`,
+		parameters: Type.Object({ title: Type.String({ description: `New session title. Whitespace is trimmed and the title must not be empty.` }) }),
+		execute: async (_toolCallId, params) => {
+			const { title } = params;
+			const trimmedTitle = typeof title === `string` ? title.trim() : ``;
+			if (trimmedTitle.length === 0) return {
+				content: [{
+					type: `text`,
+					text: `Error: title must be a non-empty string.`
+				}],
+				details: { updated: false }
+			};
+			try {
+				await ctx.setTag(`title`, trimmedTitle);
+				return {
+					content: [{
+						type: `text`,
+						text: `Session title set to “${trimmedTitle}”.`
+					}],
+					details: {
+						updated: true,
+						title: trimmedTitle
+					}
+				};
+			} catch (err) {
+				return {
+					content: [{
+						type: `text`,
+						text: `Error setting session title: ${err instanceof Error ? err.message : `Unknown error`}`
+					}],
+					details: { updated: false }
+				};
+			}
+		}
+	};
+}
+
 //#endregion
 //#region src/model-catalog.ts
 const MODEL_INPUTS_SCHEMA_DEF = `electricModelInputs`;
@@ -1041,7 +1153,7 @@ function modelInputSchemaDefs(catalog) {
 
 //#endregion
 //#region src/agents/horton.ts
-const TITLE_SYSTEM_PROMPT = "You generate concise chat session titles in 3-5 words. Respond with only the title, no quotes, no punctuation, no preamble.";
+const TITLE_SYSTEM_PROMPT = "You generate a concise 3-5 word chat session title from the user's first message. Respond with only the title — no quotes, punctuation, preamble, or explanation. The user may reference images, files, or attachments you cannot see; infer a title from their intent anyway. Never apologize or say anything is missing — always output a short title.";
 const TITLE_USER_PROMPT = (userMessage) => `User request:\n${userMessage}`;
 const TITLE_GENERATION_TIMEOUT_MS = 8e3;
 const HORTON_SKILLS_SLASH_COMMAND_OWNER = `horton:skills`;
@@ -1135,12 +1247,16 @@ function withTimeout(promise, ms, description) {
 		if (timeout) clearTimeout(timeout);
 	});
 }
+function looksLikeNonTitle(title) {
+	if (title.split(/\s+/).filter(Boolean).length > 8) return true;
+	return /[!?,]/.test(title);
+}
 async function generateTitle(userMessage, llmCall, onFallback) {
 	try {
 		const raw = await llmCall(TITLE_USER_PROMPT(userMessage));
 		const title = raw.trim();
-		if (title.length > 0) return title;
-		onFallback?.(`empty LLM title response`);
+		if (title.length > 0 && !looksLikeNonTitle(title)) return title;
+		onFallback?.(title.length === 0 ? `empty LLM title response` : `non-title LLM response`);
 		return buildFallbackTitle(userMessage);
 	} catch (err) {
 		onFallback?.(err instanceof Error ? err.message : String(err));
@@ -1150,6 +1266,7 @@ async function generateTitle(userMessage, llmCall, onFallback) {
 function buildHortonSystemPrompt(workingDirectory, opts = {}) {
 	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 titleTool = `\n- set_title: set or rename this chat session's UI title`;
 	const scheduleTools = opts.hasScheduleTools ? `\n- upsert_cron_schedule: create or update a recurring cron wake for yourself. Always include payload with the concrete instruction/message you should receive when the cron fires.\n- delete_schedule: delete one of your cron or future-send schedules by stable id\n- list_schedules: list your manifest-backed cron and future-send schedules` : ``;
 	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 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.` : ``;
@@ -1205,8 +1322,9 @@ When a user opens with a greeting ("hi", "hello", "hey", etc.) or a broad statem
 - fetch_url: fetch and convert a URL to markdown
 - spawn_worker: dispatch a subagent for an isolated task
 - fork: spawn a child session that inherits this conversation's history up to the latest completed response. Same parent-ownership model as spawn_worker — when the fork's next run finishes, you'll wake with its response.
+- observe_pg_sync: observe an Electric Postgres sync stream and wake on matching changes
 - send: send a message to an Electric Agent/entity. To schedule future work for yourself, call send with self: true and afterMs.
-${eventSourceTools}${scheduleTools}${docsTools}${skillsTools}
+${eventSourceTools}${titleTool}${scheduleTools}${docsTools}${skillsTools}
 
 # Working with files
 - Prefer edit over write when modifying existing files.
@@ -1273,6 +1391,8 @@ function createHortonTools(sandbox, ctx, readSet, opts = {}) {
 		})] : [createFetchUrlTool(sandbox)],
 		createSpawnWorkerTool(ctx, opts.modelConfig),
 		createForkTool(ctx),
+		createObservePgSyncTool(ctx),
+		createSetTitleTool(ctx),
 		createSendTool(ctx.send, { selfEntityUrl: ctx.entityUrl }),
 		...opts.docsSearchTool ? [opts.docsSearchTool] : []
 	];

package/dist/index.cjs

@@ -818,6 +818,69 @@ function createSpawnWorkerTool(ctx, modelConfig) {
 	};
 }
 
+//#endregion
+//#region src/tools/observe-pg-sync.ts
+function asToolResult(value) {
+	return {
+		content: [{
+			type: `text`,
+			text: typeof value === `string` ? value : JSON.stringify(value, null, 2)
+		}],
+		details: {}
+	};
+}
+const PgSyncOperation = __sinclair_typebox.Type.Union([
+	__sinclair_typebox.Type.Literal(`insert`),
+	__sinclair_typebox.Type.Literal(`update`),
+	__sinclair_typebox.Type.Literal(`delete`)
+]);
+function createObservePgSyncTool(ctx) {
+	return {
+		name: `observe_pg_sync`,
+		label: `Observe Postgres Sync`,
+		description: `Observe an Electric Postgres shape stream and wake this agent when matching row changes arrive.`,
+		parameters: __sinclair_typebox.Type.Object({
+			url: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.String({ description: `Optional Electric shape endpoint URL. Defaults to the server-configured pg-sync URL.` })),
+			table: __sinclair_typebox.Type.String({
+				minLength: 1,
+				pattern: `\\S`,
+				description: `Postgres table name to observe.`
+			}),
+			columns: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Array(__sinclair_typebox.Type.String(), { description: `Optional list of columns to include in the shape.` })),
+			where: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.String({ description: `Optional Electric shape WHERE clause.` })),
+			params: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Union([__sinclair_typebox.Type.Array(__sinclair_typebox.Type.String()), __sinclair_typebox.Type.Record(__sinclair_typebox.Type.String(), __sinclair_typebox.Type.String())])),
+			replica: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Union([__sinclair_typebox.Type.Literal(`default`), __sinclair_typebox.Type.Literal(`full`)])),
+			wake: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Object({
+				ops: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Array(PgSyncOperation)),
+				debounceMs: __sinclair_typebox.Type.Optional(__sinclair_typebox.Type.Number())
+			}, { additionalProperties: false }))
+		}),
+		execute: async (_toolCallId, params) => {
+			const args = params;
+			if (typeof args.table !== `string` || args.table.trim().length === 0) throw new Error(`table is required`);
+			const source = (0, __electric_ax_agents_runtime.pgSync)({
+				url: args.url,
+				table: args.table,
+				columns: args.columns,
+				where: args.where,
+				params: args.params,
+				replica: args.replica
+			});
+			const wake = {
+				on: `change`,
+				...args.wake?.ops ? { ops: args.wake.ops } : {},
+				...args.wake?.debounceMs !== void 0 ? { debounceMs: args.wake.debounceMs } : {}
+			};
+			await ctx.observe(source, { wake });
+			return asToolResult({
+				sourceRef: source.sourceRef,
+				streamUrl: source.streamUrl,
+				wake
+			});
+		}
+	};
+}
+
 //#endregion
 //#region src/tools/fork.ts
 function createForkTool(ctx) {
@@ -872,6 +935,49 @@ Omit 'entityUrl' to fork your own session. Pass a different session's URL to for
 	};
 }
 
+//#endregion
+//#region src/tools/set-title.ts
+function createSetTitleTool(ctx) {
+	return {
+		name: `set_title`,
+		label: `Set Title`,
+		description: `Set the chat session title shown in the UI. Use this when the current title is missing, stale, misleading, or the user asks to rename the session. Provide a concise, human-readable title.`,
+		parameters: __sinclair_typebox.Type.Object({ title: __sinclair_typebox.Type.String({ description: `New session title. Whitespace is trimmed and the title must not be empty.` }) }),
+		execute: async (_toolCallId, params) => {
+			const { title } = params;
+			const trimmedTitle = typeof title === `string` ? title.trim() : ``;
+			if (trimmedTitle.length === 0) return {
+				content: [{
+					type: `text`,
+					text: `Error: title must be a non-empty string.`
+				}],
+				details: { updated: false }
+			};
+			try {
+				await ctx.setTag(`title`, trimmedTitle);
+				return {
+					content: [{
+						type: `text`,
+						text: `Session title set to “${trimmedTitle}”.`
+					}],
+					details: {
+						updated: true,
+						title: trimmedTitle
+					}
+				};
+			} catch (err) {
+				return {
+					content: [{
+						type: `text`,
+						text: `Error setting session title: ${err instanceof Error ? err.message : `Unknown error`}`
+					}],
+					details: { updated: false }
+				};
+			}
+		}
+	};
+}
+
 //#endregion
 //#region src/model-catalog.ts
 const MODEL_INPUTS_SCHEMA_DEF = `electricModelInputs`;
@@ -1054,7 +1160,7 @@ function modelInputSchemaDefs(catalog) {
 //#endregion
 //#region src/agents/horton.ts
 const HORTON_MODEL = `claude-sonnet-4-6`;
-const TITLE_SYSTEM_PROMPT = "You generate concise chat session titles in 3-5 words. Respond with only the title, no quotes, no punctuation, no preamble.";
+const TITLE_SYSTEM_PROMPT = "You generate a concise 3-5 word chat session title from the user's first message. Respond with only the title — no quotes, punctuation, preamble, or explanation. The user may reference images, files, or attachments you cannot see; infer a title from their intent anyway. Never apologize or say anything is missing — always output a short title.";
 const TITLE_USER_PROMPT = (userMessage) => `User request:\n${userMessage}`;
 const TITLE_GENERATION_TIMEOUT_MS = 8e3;
 const HORTON_SKILLS_SLASH_COMMAND_OWNER = `horton:skills`;
@@ -1148,12 +1254,16 @@ function withTimeout(promise, ms, description) {
 		if (timeout) clearTimeout(timeout);
 	});
 }
+function looksLikeNonTitle(title) {
+	if (title.split(/\s+/).filter(Boolean).length > 8) return true;
+	return /[!?,]/.test(title);
+}
 async function generateTitle(userMessage, llmCall, onFallback) {
 	try {
 		const raw = await llmCall(TITLE_USER_PROMPT(userMessage));
 		const title = raw.trim();
-		if (title.length > 0) return title;
-		onFallback?.(`empty LLM title response`);
+		if (title.length > 0 && !looksLikeNonTitle(title)) return title;
+		onFallback?.(title.length === 0 ? `empty LLM title response` : `non-title LLM response`);
 		return buildFallbackTitle(userMessage);
 	} catch (err) {
 		onFallback?.(err instanceof Error ? err.message : String(err));
@@ -1163,6 +1273,7 @@ async function generateTitle(userMessage, llmCall, onFallback) {
 function buildHortonSystemPrompt(workingDirectory, opts = {}) {
 	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 titleTool = `\n- set_title: set or rename this chat session's UI title`;
 	const scheduleTools = opts.hasScheduleTools ? `\n- upsert_cron_schedule: create or update a recurring cron wake for yourself. Always include payload with the concrete instruction/message you should receive when the cron fires.\n- delete_schedule: delete one of your cron or future-send schedules by stable id\n- list_schedules: list your manifest-backed cron and future-send schedules` : ``;
 	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 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.` : ``;
@@ -1218,8 +1329,9 @@ When a user opens with a greeting ("hi", "hello", "hey", etc.) or a broad statem
 - fetch_url: fetch and convert a URL to markdown
 - spawn_worker: dispatch a subagent for an isolated task
 - fork: spawn a child session that inherits this conversation's history up to the latest completed response. Same parent-ownership model as spawn_worker — when the fork's next run finishes, you'll wake with its response.
+- observe_pg_sync: observe an Electric Postgres sync stream and wake on matching changes
 - send: send a message to an Electric Agent/entity. To schedule future work for yourself, call send with self: true and afterMs.
-${eventSourceTools}${scheduleTools}${docsTools}${skillsTools}
+${eventSourceTools}${titleTool}${scheduleTools}${docsTools}${skillsTools}
 
 # Working with files
 - Prefer edit over write when modifying existing files.
@@ -1286,6 +1398,8 @@ function createHortonTools(sandbox, ctx, readSet, opts = {}) {
 		})] : [(0, __electric_ax_agents_runtime_tools.createFetchUrlTool)(sandbox)],
 		createSpawnWorkerTool(ctx, opts.modelConfig),
 		createForkTool(ctx),
+		createObservePgSyncTool(ctx),
+		createSetTitleTool(ctx),
 		(0, __electric_ax_agents_runtime_tools.createSendTool)(ctx.send, { selfEntityUrl: ctx.entityUrl }),
 		...opts.docsSearchTool ? [opts.docsSearchTool] : []
 	];
@@ -1912,13 +2026,19 @@ function resolveCwd(args, fallback) {
 //#endregion
 //#region src/durable-streams-cache.ts
 const MEMORY_CACHE_SIZE_BYTES = 100 * 1024 * 1024;
+let installed = false;
 function installDurableStreamsFetchCache(options = {}) {
 	if (options === false) return;
+	if (installed) {
+		console.warn(`[agents] installDurableStreamsFetchCache called more than once; ignoring`);
+		return;
+	}
 	const store = options.store === `sqlite` || options.sqliteLocation ? new undici.cacheStores.SqliteCacheStore({
 		location: options.sqliteLocation,
 		maxCount: options.maxCount
 	}) : new undici.cacheStores.MemoryCacheStore({ maxSize: MEMORY_CACHE_SIZE_BYTES });
 	(0, undici.setGlobalDispatcher)((0, undici.getGlobalDispatcher)().compose(undici.interceptors.cache({ store })));
+	installed = true;
 }
 
 //#endregion

package/dist/index.js

@@ -1,7 +1,7 @@
 import { mergeElectricPrincipalHeader } from "./server-headers-KD5yHFYT.js";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { MOONSHOT_API_BASE_URL, MOONSHOT_PROVIDER, appendPathToUrl, buildSkillSlashCommands, completeWithLowCostModel, createContextSkillLoader, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillsRegistry, db, detectAvailableProviders, getMoonshotApiKey, getMoonshotModel, getMoonshotModels, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
+import { MOONSHOT_API_BASE_URL, MOONSHOT_PROVIDER, appendPathToUrl, buildSkillSlashCommands, completeWithLowCostModel, createContextSkillLoader, createEntityRegistry, createPullWakeRunner, createRuntimeHandler, createSkillsRegistry, db, detectAvailableProviders, getMoonshotApiKey, getMoonshotModel, getMoonshotModels, pgSync, readCodexAccessToken, registerToolProvider, unregisterToolProvider } from "@electric-ax/agents-runtime";
 import { braveSearchTool, braveSearchTool as braveSearchTool$1, createBashTool, createEditTool, createEventSourceTools, createFetchUrlTool, createReadFileTool, createScheduleTools, createSendTool, createWriteTool } from "@electric-ax/agents-runtime/tools";
 import { chooseDefaultSandbox, isE2BAvailable, lazySandbox, remoteSandbox } from "@electric-ax/agents-runtime/sandbox";
 import fsSync from "node:fs";
@@ -794,6 +794,69 @@ function createSpawnWorkerTool(ctx, modelConfig) {
 	};
 }
 
+//#endregion
+//#region src/tools/observe-pg-sync.ts
+function asToolResult(value) {
+	return {
+		content: [{
+			type: `text`,
+			text: typeof value === `string` ? value : JSON.stringify(value, null, 2)
+		}],
+		details: {}
+	};
+}
+const PgSyncOperation = Type.Union([
+	Type.Literal(`insert`),
+	Type.Literal(`update`),
+	Type.Literal(`delete`)
+]);
+function createObservePgSyncTool(ctx) {
+	return {
+		name: `observe_pg_sync`,
+		label: `Observe Postgres Sync`,
+		description: `Observe an Electric Postgres shape stream and wake this agent when matching row changes arrive.`,
+		parameters: Type.Object({
+			url: Type.Optional(Type.String({ description: `Optional Electric shape endpoint URL. Defaults to the server-configured pg-sync URL.` })),
+			table: Type.String({
+				minLength: 1,
+				pattern: `\\S`,
+				description: `Postgres table name to observe.`
+			}),
+			columns: Type.Optional(Type.Array(Type.String(), { description: `Optional list of columns to include in the shape.` })),
+			where: Type.Optional(Type.String({ description: `Optional Electric shape WHERE clause.` })),
+			params: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Record(Type.String(), Type.String())])),
+			replica: Type.Optional(Type.Union([Type.Literal(`default`), Type.Literal(`full`)])),
+			wake: Type.Optional(Type.Object({
+				ops: Type.Optional(Type.Array(PgSyncOperation)),
+				debounceMs: Type.Optional(Type.Number())
+			}, { additionalProperties: false }))
+		}),
+		execute: async (_toolCallId, params) => {
+			const args = params;
+			if (typeof args.table !== `string` || args.table.trim().length === 0) throw new Error(`table is required`);
+			const source = pgSync({
+				url: args.url,
+				table: args.table,
+				columns: args.columns,
+				where: args.where,
+				params: args.params,
+				replica: args.replica
+			});
+			const wake = {
+				on: `change`,
+				...args.wake?.ops ? { ops: args.wake.ops } : {},
+				...args.wake?.debounceMs !== void 0 ? { debounceMs: args.wake.debounceMs } : {}
+			};
+			await ctx.observe(source, { wake });
+			return asToolResult({
+				sourceRef: source.sourceRef,
+				streamUrl: source.streamUrl,
+				wake
+			});
+		}
+	};
+}
+
 //#endregion
 //#region src/tools/fork.ts
 function createForkTool(ctx) {
@@ -848,6 +911,49 @@ Omit 'entityUrl' to fork your own session. Pass a different session's URL to for
 	};
 }
 
+//#endregion
+//#region src/tools/set-title.ts
+function createSetTitleTool(ctx) {
+	return {
+		name: `set_title`,
+		label: `Set Title`,
+		description: `Set the chat session title shown in the UI. Use this when the current title is missing, stale, misleading, or the user asks to rename the session. Provide a concise, human-readable title.`,
+		parameters: Type.Object({ title: Type.String({ description: `New session title. Whitespace is trimmed and the title must not be empty.` }) }),
+		execute: async (_toolCallId, params) => {
+			const { title } = params;
+			const trimmedTitle = typeof title === `string` ? title.trim() : ``;
+			if (trimmedTitle.length === 0) return {
+				content: [{
+					type: `text`,
+					text: `Error: title must be a non-empty string.`
+				}],
+				details: { updated: false }
+			};
+			try {
+				await ctx.setTag(`title`, trimmedTitle);
+				return {
+					content: [{
+						type: `text`,
+						text: `Session title set to “${trimmedTitle}”.`
+					}],
+					details: {
+						updated: true,
+						title: trimmedTitle
+					}
+				};
+			} catch (err) {
+				return {
+					content: [{
+						type: `text`,
+						text: `Error setting session title: ${err instanceof Error ? err.message : `Unknown error`}`
+					}],
+					details: { updated: false }
+				};
+			}
+		}
+	};
+}
+
 //#endregion
 //#region src/model-catalog.ts
 const MODEL_INPUTS_SCHEMA_DEF = `electricModelInputs`;
@@ -1030,7 +1136,7 @@ function modelInputSchemaDefs(catalog) {
 //#endregion
 //#region src/agents/horton.ts
 const HORTON_MODEL = `claude-sonnet-4-6`;
-const TITLE_SYSTEM_PROMPT = "You generate concise chat session titles in 3-5 words. Respond with only the title, no quotes, no punctuation, no preamble.";
+const TITLE_SYSTEM_PROMPT = "You generate a concise 3-5 word chat session title from the user's first message. Respond with only the title — no quotes, punctuation, preamble, or explanation. The user may reference images, files, or attachments you cannot see; infer a title from their intent anyway. Never apologize or say anything is missing — always output a short title.";
 const TITLE_USER_PROMPT = (userMessage) => `User request:\n${userMessage}`;
 const TITLE_GENERATION_TIMEOUT_MS = 8e3;
 const HORTON_SKILLS_SLASH_COMMAND_OWNER = `horton:skills`;
@@ -1124,12 +1230,16 @@ function withTimeout(promise, ms, description) {
 		if (timeout) clearTimeout(timeout);
 	});
 }
+function looksLikeNonTitle(title) {
+	if (title.split(/\s+/).filter(Boolean).length > 8) return true;
+	return /[!?,]/.test(title);
+}
 async function generateTitle(userMessage, llmCall, onFallback) {
 	try {
 		const raw = await llmCall(TITLE_USER_PROMPT(userMessage));
 		const title = raw.trim();
-		if (title.length > 0) return title;
-		onFallback?.(`empty LLM title response`);
+		if (title.length > 0 && !looksLikeNonTitle(title)) return title;
+		onFallback?.(title.length === 0 ? `empty LLM title response` : `non-title LLM response`);
 		return buildFallbackTitle(userMessage);
 	} catch (err) {
 		onFallback?.(err instanceof Error ? err.message : String(err));
@@ -1139,6 +1249,7 @@ async function generateTitle(userMessage, llmCall, onFallback) {
 function buildHortonSystemPrompt(workingDirectory, opts = {}) {
 	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 titleTool = `\n- set_title: set or rename this chat session's UI title`;
 	const scheduleTools = opts.hasScheduleTools ? `\n- upsert_cron_schedule: create or update a recurring cron wake for yourself. Always include payload with the concrete instruction/message you should receive when the cron fires.\n- delete_schedule: delete one of your cron or future-send schedules by stable id\n- list_schedules: list your manifest-backed cron and future-send schedules` : ``;
 	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 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.` : ``;
@@ -1194,8 +1305,9 @@ When a user opens with a greeting ("hi", "hello", "hey", etc.) or a broad statem
 - fetch_url: fetch and convert a URL to markdown
 - spawn_worker: dispatch a subagent for an isolated task
 - fork: spawn a child session that inherits this conversation's history up to the latest completed response. Same parent-ownership model as spawn_worker — when the fork's next run finishes, you'll wake with its response.
+- observe_pg_sync: observe an Electric Postgres sync stream and wake on matching changes
 - send: send a message to an Electric Agent/entity. To schedule future work for yourself, call send with self: true and afterMs.
-${eventSourceTools}${scheduleTools}${docsTools}${skillsTools}
+${eventSourceTools}${titleTool}${scheduleTools}${docsTools}${skillsTools}
 
 # Working with files
 - Prefer edit over write when modifying existing files.
@@ -1262,6 +1374,8 @@ function createHortonTools(sandbox, ctx, readSet, opts = {}) {
 		})] : [createFetchUrlTool(sandbox)],
 		createSpawnWorkerTool(ctx, opts.modelConfig),
 		createForkTool(ctx),
+		createObservePgSyncTool(ctx),
+		createSetTitleTool(ctx),
 		createSendTool(ctx.send, { selfEntityUrl: ctx.entityUrl }),
 		...opts.docsSearchTool ? [opts.docsSearchTool] : []
 	];
@@ -1888,13 +2002,19 @@ function resolveCwd(args, fallback) {
 //#endregion
 //#region src/durable-streams-cache.ts
 const MEMORY_CACHE_SIZE_BYTES = 100 * 1024 * 1024;
+let installed = false;
 function installDurableStreamsFetchCache(options = {}) {
 	if (options === false) return;
+	if (installed) {
+		console.warn(`[agents] installDurableStreamsFetchCache called more than once; ignoring`);
+		return;
+	}
 	const store = options.store === `sqlite` || options.sqliteLocation ? new cacheStores.SqliteCacheStore({
 		location: options.sqliteLocation,
 		maxCount: options.maxCount
 	}) : new cacheStores.MemoryCacheStore({ maxSize: MEMORY_CACHE_SIZE_BYTES });
 	setGlobalDispatcher(getGlobalDispatcher().compose(interceptors.cache({ store })));
+	installed = true;
 }
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@electric-ax/agents",
-  "version": "0.4.15",
+  "version": "0.4.17",
   "description": "Built-in Electric Agents runtimes such as Horton and worker",
   "repository": {
     "type": "git",
@@ -49,8 +49,8 @@
     "sqlite-vec": "^0.1.9",
     "undici": "^7.24.7",
     "zod": "^4.3.6",
-    "@electric-ax/agents-mcp": "0.2.2",
-    "@electric-ax/agents-runtime": "0.3.11"
+    "@electric-ax/agents-mcp": "0.2.3",
+    "@electric-ax/agents-runtime": "0.3.13"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",