@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/gateway/hono/routes/memory.js

@@ -0,0 +1,290 @@
+import { MemoryPolicySchema, init_schema } from "../../../agent-manifest/schema.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
+import { resolveEffectiveAgentManifestForAgent } from "../../../config/agent-profile.js";
+import { resolveBuiltinMemoryStoreConfig } from "../../../agent/memory/memory-config.js";
+import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, upsertMemoryRecord } from "../../../storage/sqlite/memory-records-repository.js";
+import "../../../storage/sqlite/index.js";
+import { BuiltinMemoryStore } from "../../../agent/memory/builtin-memory-store.js";
+import { discoverMemoryPlugins } from "../../../agent/memory/plugin-discovery.js";
+import { createMemoryManagerFromConfig } from "../../../agent/memory/create-memory-manager.js";
+import { prepareUpdateAgent } from "../../agents-admin.js";
+//#region src/gateway/hono/routes/memory.ts
+init_schema();
+init_agent_scope();
+const MEMORY_KINDS = new Set([
+	"user_profile",
+	"agent_note",
+	"workspace_fact",
+	"daily_note",
+	"session_summary",
+	"derived_insight"
+]);
+function parseLimit(raw, fallback = 100) {
+	const parsed = raw ? Number.parseInt(raw, 10) : fallback;
+	return Number.isFinite(parsed) ? Math.max(1, Math.min(500, parsed)) : fallback;
+}
+function parseKind(raw) {
+	return typeof raw === "string" && MEMORY_KINDS.has(raw) ? raw : void 0;
+}
+function registerMemoryRoutes(authenticated, deps) {
+	authenticated.get("/api/memory/providers", async (c) => {
+		const cfg = deps.service.currentConfig;
+		const plugins = await discoverMemoryPlugins(cfg);
+		return c.json({ providers: [{
+			id: "local",
+			displayName: "Local Markdown Memory",
+			available: true,
+			configured: true,
+			capabilities: {
+				search: true,
+				read: true,
+				write: true,
+				update: true,
+				delete: true,
+				keywordSearch: true,
+				semanticSearch: false,
+				hybridSearch: false,
+				citations: true,
+				sync: false,
+				local: true
+			}
+		}, ...plugins.map((plugin) => ({
+			id: plugin.manifest?.id ?? plugin.name,
+			displayName: plugin.manifest?.displayName ?? plugin.name,
+			available: plugin.available,
+			configured: false,
+			capabilities: plugin.manifest?.capabilities ?? {}
+		}))] });
+	});
+	authenticated.get("/api/memory/config", (c) => {
+		const cfg = deps.service.currentConfig;
+		const manifest = resolveEffectiveAgentManifestForAgent(cfg, c.req.query("agentId") || resolveDefaultAgentId(cfg));
+		return c.json({
+			agentId: manifest.id,
+			memory: manifest.memory
+		});
+	});
+	authenticated.patch("/api/memory/config", deps.strictRateLimitMiddleware, async (c) => {
+		const cfg = deps.service.currentConfig;
+		const body = await c.req.json().catch(() => ({}));
+		const agentId = typeof body.agentId === "string" && body.agentId.trim() ? body.agentId.trim() : resolveDefaultAgentId(cfg);
+		const parsed = MemoryPolicySchema.safeParse(body.memory);
+		if (!parsed.success) return c.json({ error: `memory ${parsed.error.issues[0]?.message ?? "is invalid"}` }, 400);
+		const prep = prepareUpdateAgent(cfg, agentId, { memory: parsed.data });
+		if (prep.ok === false) return c.json({ error: prep.error }, prep.status ?? 400);
+		const save = await deps.service.saveConfig(prep.data.nextConfig);
+		if (!save.saved) return c.json({ error: save.error ?? "save failed" }, 500);
+		const manifest = resolveEffectiveAgentManifestForAgent(deps.service.currentConfig, agentId);
+		return c.json({
+			agentId: manifest.id,
+			memory: manifest.memory
+		});
+	});
+	authenticated.get("/api/memory/records", (c) => {
+		const records = listMemoryRecords({
+			providerId: c.req.query("providerId") || void 0,
+			agentId: c.req.query("agentId") || void 0,
+			workspaceId: c.req.query("workspaceId") || void 0,
+			kind: parseKind(c.req.query("kind")),
+			limit: parseLimit(c.req.query("limit")),
+			offset: c.req.query("offset") ? Number.parseInt(c.req.query("offset"), 10) : 0
+		});
+		return c.json({ records });
+	});
+	authenticated.post("/api/memory/search", async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		const query = typeof body.query === "string" ? body.query.trim() : "";
+		if (!query) return c.json({ error: "Missing required field: query" }, 400);
+		const records = searchMemoryRecords({
+			query,
+			providerId: typeof body.providerId === "string" ? body.providerId : void 0,
+			agentId: typeof body.agentId === "string" ? body.agentId : void 0,
+			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : void 0,
+			kinds: Array.isArray(body.kinds) ? body.kinds.map(parseKind).filter((v) => Boolean(v)) : void 0,
+			maxResults: typeof body.maxResults === "number" ? body.maxResults : void 0,
+			minScore: typeof body.minScore === "number" ? body.minScore : void 0
+		});
+		return c.json({ results: records });
+	});
+	authenticated.post("/api/memory/records", async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		const kind = parseKind(body.kind);
+		const content = typeof body.content === "string" ? body.content.trim() : "";
+		const agentId = typeof body.agentId === "string" && body.agentId.trim() ? body.agentId.trim() : "main";
+		if (!kind || !content) return c.json({ error: "Missing required fields: kind, content" }, 400);
+		const record = upsertMemoryRecord({
+			id: typeof body.id === "string" && body.id.trim() ? body.id.trim() : void 0,
+			providerId: typeof body.providerId === "string" && body.providerId.trim() ? body.providerId.trim() : "local",
+			kind,
+			agentId,
+			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : deps.service.currentWorkspacePath,
+			sessionKey: typeof body.sessionKey === "string" ? body.sessionKey : void 0,
+			content,
+			source: body.source && typeof body.source === "object" ? body.source : void 0,
+			confidence: typeof body.confidence === "number" ? body.confidence : void 0,
+			tags: Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string") : void 0
+		});
+		return c.json({ record }, 201);
+	});
+	authenticated.patch("/api/memory/records/:id", async (c) => {
+		const existing = getMemoryRecord(c.req.param("id"));
+		if (!existing) return c.json({ error: "Memory record not found" }, 404);
+		const body = await c.req.json().catch(() => ({}));
+		const record = upsertMemoryRecord({
+			id: existing.id,
+			providerId: existing.source.provider ?? "local",
+			kind: parseKind(body.kind) ?? existing.kind,
+			agentId: existing.scope.agentId,
+			workspaceId: existing.scope.workspaceId,
+			sessionKey: existing.scope.sessionKey,
+			content: typeof body.content === "string" ? body.content : existing.content,
+			source: body.source && typeof body.source === "object" ? body.source : existing.source,
+			confidence: typeof body.confidence === "number" ? body.confidence : existing.confidence,
+			tags: Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string") : existing.tags
+		});
+		return c.json({ record });
+	});
+	authenticated.delete("/api/memory/records/:id", (c) => {
+		if (!deleteMemoryRecord(c.req.param("id"))) return c.json({ error: "Memory record not found" }, 404);
+		return c.json({ ok: true });
+	});
+	authenticated.get("/api/memory/signals", (c) => {
+		const signals = listMemorySignals({
+			recordId: c.req.query("recordId") || void 0,
+			providerId: c.req.query("providerId") || void 0,
+			agentId: c.req.query("agentId") || void 0,
+			workspaceId: c.req.query("workspaceId") || void 0,
+			limit: parseLimit(c.req.query("limit"))
+		});
+		return c.json({ signals });
+	});
+	authenticated.get("/api/memory/traces", (c) => {
+		const traces = listMemoryTraceEvents({
+			providerId: c.req.query("providerId") || void 0,
+			sessionKey: c.req.query("sessionKey") || void 0,
+			phase: c.req.query("phase") || void 0,
+			limit: parseLimit(c.req.query("limit"))
+		});
+		return c.json({ traces });
+	});
+	authenticated.post("/api/memory/signals", async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		const source = typeof body.source === "string" ? body.source : "";
+		if (!source) return c.json({ error: "Missing required field: source" }, 400);
+		const signalId = appendMemorySignal({
+			providerId: typeof body.providerId === "string" ? body.providerId : void 0,
+			agentId: typeof body.agentId === "string" ? body.agentId : void 0,
+			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : void 0,
+			sessionKey: typeof body.sessionKey === "string" ? body.sessionKey : void 0,
+			signal: {
+				source,
+				recordId: typeof body.recordId === "string" ? body.recordId : void 0,
+				score: typeof body.score === "number" ? body.score : void 0,
+				content: typeof body.content === "string" ? body.content : void 0,
+				metadata: body.metadata && typeof body.metadata === "object" ? body.metadata : void 0
+			}
+		});
+		return c.json({ signalId }, 201);
+	});
+	authenticated.post("/api/memory/providers/:id/test", deps.strictRateLimitMiddleware, async (c) => {
+		const providerId = c.req.param("id");
+		const cfg = deps.service.currentConfig;
+		const workspace = deps.service.currentWorkspacePath;
+		const manager = createMemoryManagerFromConfig(workspace, new BuiltinMemoryStore(resolveBuiltinMemoryStoreConfig(workspace, cfg)), cfg);
+		await manager.initializeAll(`memory-provider-test-${Date.now()}`, {
+			workspace,
+			agentId: resolveDefaultAgentId(cfg)
+		});
+		const provider = manager.providersList.find((p) => p.id === providerId);
+		if (!provider) return c.json({
+			providerId,
+			available: false,
+			checks: [{
+				name: "load",
+				ok: false,
+				message: "Provider not loaded"
+			}]
+		}, 404);
+		const token = `xopc-memory-smoke-${Date.now()}`;
+		const checks = [{
+			name: "load",
+			ok: true
+		}, {
+			name: "available",
+			ok: provider.isAvailable()
+		}];
+		const started = Date.now();
+		try {
+			const write = await manager.write({
+				kind: "workspace_fact",
+				content: `Smoke test record for ${providerId}: ${token}`,
+				scope: { agentId: resolveDefaultAgentId(cfg) },
+				tags: ["xopc-smoke-test"]
+			});
+			checks.push({
+				name: "write",
+				ok: write.success,
+				message: write.error ?? write.message
+			});
+			const ownResults = (await manager.search({
+				query: token,
+				scope: { agentId: resolveDefaultAgentId(cfg) },
+				maxResults: 10
+			})).filter((result) => result.citation.providerId === providerId);
+			checks.push({
+				name: "search",
+				ok: ownResults.length > 0,
+				resultCount: ownResults.length
+			});
+			const recordId = ownResults[0]?.record.id ?? write.record?.id;
+			if (recordId) {
+				const read = await manager.read({
+					id: recordId,
+					scope: { agentId: resolveDefaultAgentId(cfg) }
+				});
+				checks.push({
+					name: "read",
+					ok: Boolean(read),
+					message: read ? void 0 : "Record was not readable"
+				});
+			} else checks.push({
+				name: "read",
+				ok: false,
+				message: "No record id available"
+			});
+			manager.recordSignal({
+				source: "search_recall",
+				content: `Smoke signal for ${providerId}: ${token}`
+			});
+			checks.push({
+				name: "sync",
+				ok: true
+			});
+		} catch (err) {
+			checks.push({
+				name: "error",
+				ok: false,
+				message: err instanceof Error ? err.message : String(err)
+			});
+		} finally {
+			appendMemoryTraceEvent({
+				phase: "test",
+				providerId,
+				request: { token },
+				resultCount: checks.filter((check) => check.ok).length,
+				error: checks.some((check) => !check.ok) ? "one or more checks failed" : void 0,
+				durationMs: Date.now() - started
+			});
+			await manager.shutdownAll();
+		}
+		return c.json({
+			providerId,
+			available: provider.isAvailable(),
+			checks
+		});
+	});
+}
+//#endregion
+export { registerMemoryRoutes };
+
+//# sourceMappingURL=memory.js.map

package/dist/src/gateway/hono/routes/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","names":[],"sources":["../../../../../src/gateway/hono/routes/memory.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { BuiltinMemoryStore } from '../../../agent/memory/builtin-memory-store.js';\nimport { createMemoryManagerFromConfig } from '../../../agent/memory/create-memory-manager.js';\nimport { resolveBuiltinMemoryStoreConfig } from '../../../agent/memory/memory-config.js';\nimport { discoverMemoryPlugins } from '../../../agent/memory/plugin-discovery.js';\nimport type { MemoryKind } from '../../../agent/memory/types.js';\nimport { MemoryPolicySchema } from '../../../agent-manifest/schema.js';\nimport { resolveDefaultAgentId } from '../../../agent/agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport type { Config } from '../../../config/schema.js';\nimport { prepareUpdateAgent } from '../../agents-admin.js';\nimport {\n  appendMemorySignal,\n  appendMemoryTraceEvent,\n  deleteMemoryRecord,\n  getMemoryRecord,\n  listMemoryRecords,\n  listMemorySignals,\n  listMemoryTraceEvents,\n  searchMemoryRecords,\n  upsertMemoryRecord,\n} from '../../../storage/sqlite/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst MEMORY_KINDS = new Set<MemoryKind>([\n  'user_profile',\n  'agent_note',\n  'workspace_fact',\n  'daily_note',\n  'session_summary',\n  'derived_insight',\n]);\n\nfunction parseLimit(raw: string | undefined, fallback = 100): number {\n  const parsed = raw ? Number.parseInt(raw, 10) : fallback;\n  return Number.isFinite(parsed) ? Math.max(1, Math.min(500, parsed)) : fallback;\n}\n\nfunction parseKind(raw: unknown): MemoryKind | undefined {\n  return typeof raw === 'string' && MEMORY_KINDS.has(raw as MemoryKind)\n    ? (raw as MemoryKind)\n    : undefined;\n}\n\nexport function registerMemoryRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  authenticated.get('/api/memory/providers', async (c) => {\n    const cfg = deps.service.currentConfig as Config;\n    const plugins = await discoverMemoryPlugins(cfg);\n    return c.json({\n      providers: [\n        {\n          id: 'local',\n          displayName: 'Local Markdown Memory',\n          available: true,\n          configured: true,\n          capabilities: {\n            search: true,\n            read: true,\n            write: true,\n            update: true,\n            delete: true,\n            keywordSearch: true,\n            semanticSearch: false,\n            hybridSearch: false,\n            citations: true,\n            sync: false,\n            local: true,\n          },\n        },\n        ...plugins.map((plugin) => ({\n          id: plugin.manifest?.id ?? plugin.name,\n          displayName: plugin.manifest?.displayName ?? plugin.name,\n          available: plugin.available,\n          configured: false,\n          capabilities: plugin.manifest?.capabilities ?? {},\n        })),\n      ],\n    });\n  });\n\n  authenticated.get('/api/memory/config', (c) => {\n    const cfg = deps.service.currentConfig as Config;\n    const agentId = c.req.query('agentId') || resolveDefaultAgentId(cfg);\n    const manifest = resolveEffectiveAgentManifestForAgent(cfg, agentId);\n    return c.json({ agentId: manifest.id, memory: manifest.memory });\n  });\n\n  authenticated.patch('/api/memory/config', deps.strictRateLimitMiddleware, async (c) => {\n    const cfg = deps.service.currentConfig as Config;\n    const body = await c.req.json().catch(() => ({}));\n    const agentId = typeof body.agentId === 'string' && body.agentId.trim()\n      ? body.agentId.trim()\n      : resolveDefaultAgentId(cfg);\n    const parsed = MemoryPolicySchema.safeParse(body.memory);\n    if (!parsed.success) {\n      return c.json({ error: `memory ${parsed.error.issues[0]?.message ?? 'is invalid'}` }, 400);\n    }\n    const prep = prepareUpdateAgent(cfg, agentId, { memory: parsed.data });\n    if (prep.ok === false) {\n      return c.json({ error: prep.error }, prep.status ?? 400);\n    }\n    const save = await deps.service.saveConfig(prep.data.nextConfig);\n    if (!save.saved) return c.json({ error: save.error ?? 'save failed' }, 500);\n    const manifest = resolveEffectiveAgentManifestForAgent(deps.service.currentConfig as Config, agentId);\n    return c.json({ agentId: manifest.id, memory: manifest.memory });\n  });\n\n  authenticated.get('/api/memory/records', (c) => {\n    const records = listMemoryRecords({\n      providerId: c.req.query('providerId') || undefined,\n      agentId: c.req.query('agentId') || undefined,\n      workspaceId: c.req.query('workspaceId') || undefined,\n      kind: parseKind(c.req.query('kind')),\n      limit: parseLimit(c.req.query('limit')),\n      offset: c.req.query('offset') ? Number.parseInt(c.req.query('offset')!, 10) : 0,\n    });\n    return c.json({ records });\n  });\n\n  authenticated.post('/api/memory/search', async (c) => {\n    const body = await c.req.json().catch(() => ({}));\n    const query = typeof body.query === 'string' ? body.query.trim() : '';\n    if (!query) {\n      return c.json({ error: 'Missing required field: query' }, 400);\n    }\n    const records = searchMemoryRecords({\n      query,\n      providerId: typeof body.providerId === 'string' ? body.providerId : undefined,\n      agentId: typeof body.agentId === 'string' ? body.agentId : undefined,\n      workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : undefined,\n      kinds: Array.isArray(body.kinds)\n        ? body.kinds.map(parseKind).filter((v): v is MemoryKind => Boolean(v))\n        : undefined,\n      maxResults: typeof body.maxResults === 'number' ? body.maxResults : undefined,\n      minScore: typeof body.minScore === 'number' ? body.minScore : undefined,\n    });\n    return c.json({ results: records });\n  });\n\n  authenticated.post('/api/memory/records', async (c) => {\n    const body = await c.req.json().catch(() => ({}));\n    const kind = parseKind(body.kind);\n    const content = typeof body.content === 'string' ? body.content.trim() : '';\n    const agentId = typeof body.agentId === 'string' && body.agentId.trim() ? body.agentId.trim() : 'main';\n    if (!kind || !content) {\n      return c.json({ error: 'Missing required fields: kind, content' }, 400);\n    }\n    const record = upsertMemoryRecord({\n      id: typeof body.id === 'string' && body.id.trim() ? body.id.trim() : undefined,\n      providerId: typeof body.providerId === 'string' && body.providerId.trim() ? body.providerId.trim() : 'local',\n      kind,\n      agentId,\n      workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : deps.service.currentWorkspacePath,\n      sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n      content,\n      source: body.source && typeof body.source === 'object' ? body.source : undefined,\n      confidence: typeof body.confidence === 'number' ? body.confidence : undefined,\n      tags: Array.isArray(body.tags) ? body.tags.filter((tag): tag is string => typeof tag === 'string') : undefined,\n    });\n    return c.json({ record }, 201);\n  });\n\n  authenticated.patch('/api/memory/records/:id', async (c) => {\n    const existing = getMemoryRecord(c.req.param('id'));\n    if (!existing) return c.json({ error: 'Memory record not found' }, 404);\n    const body = await c.req.json().catch(() => ({}));\n    const record = upsertMemoryRecord({\n      id: existing.id,\n      providerId: existing.source.provider ?? 'local',\n      kind: parseKind(body.kind) ?? existing.kind,\n      agentId: existing.scope.agentId,\n      workspaceId: existing.scope.workspaceId,\n      sessionKey: existing.scope.sessionKey,\n      content: typeof body.content === 'string' ? body.content : existing.content,\n      source: body.source && typeof body.source === 'object' ? body.source : existing.source,\n      confidence: typeof body.confidence === 'number' ? body.confidence : existing.confidence,\n      tags: Array.isArray(body.tags) ? body.tags.filter((tag): tag is string => typeof tag === 'string') : existing.tags,\n    });\n    return c.json({ record });\n  });\n\n  authenticated.delete('/api/memory/records/:id', (c) => {\n    const deleted = deleteMemoryRecord(c.req.param('id'));\n    if (!deleted) return c.json({ error: 'Memory record not found' }, 404);\n    return c.json({ ok: true });\n  });\n\n  authenticated.get('/api/memory/signals', (c) => {\n    const signals = listMemorySignals({\n      recordId: c.req.query('recordId') || undefined,\n      providerId: c.req.query('providerId') || undefined,\n      agentId: c.req.query('agentId') || undefined,\n      workspaceId: c.req.query('workspaceId') || undefined,\n      limit: parseLimit(c.req.query('limit')),\n    });\n    return c.json({ signals });\n  });\n\n  authenticated.get('/api/memory/traces', (c) => {\n    const traces = listMemoryTraceEvents({\n      providerId: c.req.query('providerId') || undefined,\n      sessionKey: c.req.query('sessionKey') || undefined,\n      phase: c.req.query('phase') || undefined,\n      limit: parseLimit(c.req.query('limit')),\n    });\n    return c.json({ traces });\n  });\n\n  authenticated.post('/api/memory/signals', async (c) => {\n    const body = await c.req.json().catch(() => ({}));\n    const source = typeof body.source === 'string' ? body.source : '';\n    if (!source) return c.json({ error: 'Missing required field: source' }, 400);\n    const signalId = appendMemorySignal({\n      providerId: typeof body.providerId === 'string' ? body.providerId : undefined,\n      agentId: typeof body.agentId === 'string' ? body.agentId : undefined,\n      workspaceId: typeof body.workspaceId === 'string' ? body.workspaceId : undefined,\n      sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n      signal: {\n        source: source as never,\n        recordId: typeof body.recordId === 'string' ? body.recordId : undefined,\n        score: typeof body.score === 'number' ? body.score : undefined,\n        content: typeof body.content === 'string' ? body.content : undefined,\n        metadata: body.metadata && typeof body.metadata === 'object' ? body.metadata : undefined,\n      },\n    });\n    return c.json({ signalId }, 201);\n  });\n\n  authenticated.post('/api/memory/providers/:id/test', deps.strictRateLimitMiddleware, async (c) => {\n    const providerId = c.req.param('id');\n    const cfg = deps.service.currentConfig as Config;\n    const workspace = deps.service.currentWorkspacePath;\n    const store = new BuiltinMemoryStore(resolveBuiltinMemoryStoreConfig(workspace, cfg));\n    const manager = createMemoryManagerFromConfig(workspace, store, cfg);\n    await manager.initializeAll(`memory-provider-test-${Date.now()}`, { workspace, agentId: resolveDefaultAgentId(cfg) });\n    const provider = manager.providersList.find((p) => p.id === providerId);\n    if (!provider) return c.json({ providerId, available: false, checks: [{ name: 'load', ok: false, message: 'Provider not loaded' }] }, 404);\n\n    const token = `xopc-memory-smoke-${Date.now()}`;\n    const checks: Array<{ name: string; ok: boolean; message?: string; resultCount?: number }> = [\n      { name: 'load', ok: true },\n      { name: 'available', ok: provider.isAvailable() },\n    ];\n    const started = Date.now();\n    try {\n      const write = await manager.write({\n        kind: 'workspace_fact',\n        content: `Smoke test record for ${providerId}: ${token}`,\n        scope: { agentId: resolveDefaultAgentId(cfg) },\n        tags: ['xopc-smoke-test'],\n      });\n      checks.push({ name: 'write', ok: write.success, message: write.error ?? write.message });\n      const results = await manager.search({ query: token, scope: { agentId: resolveDefaultAgentId(cfg) }, maxResults: 10 });\n      const ownResults = results.filter((result) => result.citation.providerId === providerId);\n      checks.push({ name: 'search', ok: ownResults.length > 0, resultCount: ownResults.length });\n      const recordId = ownResults[0]?.record.id ?? write.record?.id;\n      if (recordId) {\n        const read = await manager.read({ id: recordId, scope: { agentId: resolveDefaultAgentId(cfg) } });\n        checks.push({ name: 'read', ok: Boolean(read), message: read ? undefined : 'Record was not readable' });\n      } else {\n        checks.push({ name: 'read', ok: false, message: 'No record id available' });\n      }\n      manager.recordSignal({ source: 'search_recall', content: `Smoke signal for ${providerId}: ${token}` });\n      checks.push({ name: 'sync', ok: true });\n    } catch (err) {\n      checks.push({ name: 'error', ok: false, message: err instanceof Error ? err.message : String(err) });\n    } finally {\n      appendMemoryTraceEvent({\n        phase: 'test',\n        providerId,\n        request: { token },\n        resultCount: checks.filter((check) => check.ok).length,\n        error: checks.some((check) => !check.ok) ? 'one or more checks failed' : undefined,\n        durationMs: Date.now() - started,\n      });\n      await manager.shutdownAll();\n    }\n    return c.json({ providerId, available: provider.isAvailable(), checks });\n  });\n}\n"],"mappings":"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"}

package/dist/src/gateway/hono/routes/voice.js

@@ -174,10 +174,18 @@ function registerVoiceRoutes(authenticated, deps) {
 		const config = service.currentConfig;
 		const baseTtsConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);
 		const provider = typeof body.provider === "string" && body.provider.trim() ? body.provider.trim() : baseTtsConfig.provider;
+		const providerConfig = body.providerConfig && typeof body.providerConfig === "object" && !Array.isArray(body.providerConfig) ? body.providerConfig : void 0;
 		const ttsConfig = {
 			...baseTtsConfig,
 			enabled: true,
 			provider,
+			providers: {
+				...baseTtsConfig.providers ?? {},
+				...providerConfig ? { [provider]: {
+					...baseTtsConfig.providers?.[provider] ?? {},
+					...providerConfig
+				} } : {}
+			},
 			fallback: {
 				enabled: false,
 				order: [provider]
@@ -188,6 +196,7 @@ function registerVoiceRoutes(authenticated, deps) {
 			error: { message: `TTS provider "${provider}" is not configured.` }
 		}, 503);
 		try {
+			const startedAt = Date.now();
 			const result = await speak(text, ttsConfig, {
 				appConfig: config,
 				parseDirectives: false,
@@ -196,13 +205,17 @@ function registerVoiceRoutes(authenticated, deps) {
 					...typeof body.voice === "string" && body.voice.trim() ? { voice: body.voice.trim() } : {}
 				}
 			});
+			if (!result.audio.length) throw new Error(`TTS provider "${result.provider}" returned empty audio`);
+			const mimeType = result.format === "opus" || result.format === "ogg" ? "audio/ogg" : result.format === "mp3" || result.format === "mpeg" ? "audio/mpeg" : result.format === "wav" ? "audio/wav" : `audio/${result.format}`;
 			return c.json({
 				ok: true,
 				payload: {
 					audio: result.audio.toString("base64"),
+					mimeType,
 					format: result.format,
 					provider: result.provider,
-					...result.duration !== void 0 ? { duration: result.duration } : {}
+					latencyMs: Date.now() - startedAt,
+					audioSize: result.audio.length
 				}
 			});
 		} catch (error) {

package/dist/src/gateway/hono/routes/voice.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice.js","names":[],"sources":["../../../../../src/gateway/hono/routes/voice.ts"],"sourcesContent":["/**\n * Voice routes — POST /api/voice/transcribe\n *\n * Single endpoint that:\n *   1. Runs STT (Whisper preferred for low latency, Alibaba fallback)\n *   2. Optionally runs LLM refine on the raw transcript\n *   3. Returns { raw, refined?, language }\n *\n * LLM refine is auto-applied when a model is resolvable; gracefully degrades\n * to raw-only when no LLM is configured.\n */\n\nimport type { Hono } from 'hono';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../../providers/index.js';\nimport { isSTTAvailable, transcribe } from '../../../voice/stt/index.js';\nimport { isTTSAvailable, mergeTtsConfigFromAppConfig, speak } from '../../../voice/tts/index.js';\nimport { listTtsProvidersForApi } from '../../../voice/tts/list-providers.js';\nimport { listSttProvidersForApi } from '../../../voice/stt/list-providers.js';\nimport { mergeSttConfigFromAppConfig } from '../../../channels/attachments/voice-stt-webchat.js';\nimport { resolveSttProviderConfigSlice } from '../../../voice/stt/config-slice.js';\nimport { resolveTtsProviderConfigSlice } from '../../../voice/tts/config-slice.js';\nimport { createGatewayRouteLogger } from '../lib/route-logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createGatewayRouteLogger('Voice');\n\nfunction readVoiceApiKeyFromConfigFileOnly(\n  cfg: Config,\n  kind: 'stt' | 'tts',\n  providerId: string,\n): string | undefined {\n  const id = providerId.trim();\n  if (!id) return undefined;\n  const slice =\n    kind === 'stt'\n      ? resolveSttProviderConfigSlice(id, cfg.tools?.media?.audio)\n      : resolveTtsProviderConfigSlice(id, cfg.messages?.tts);\n  const key = slice.apiKey;\n  return typeof key === 'string' && key.trim() ? key.trim() : undefined;\n}\n\nconst REFINE_TIMEOUT_MS = 15_000;\nconst MAX_AUDIO_BYTES = 25 * 1024 * 1024; // 25 MB\n\nconst REFINE_SYSTEM_PROMPT = `你是语音转文字后处理助手。将语音转写原文整理为高质量文本输入。\n\n规则：\n1. 修正明显的语音识别错误\n2. 添加正确的标点符号\n3. 去除口语赘词（嗯、啊、那个、就是说、然后就是）\n4. 保持原意不变，不要扩写或改变语义\n5. 如果原文已经很好，原样输出\n6. 只输出整理后的文字，不要解释`;\n\nfunction resolveRefineModel(config: Config | undefined): ReturnType<typeof resolveModel> | null {\n  const envRef = process.env.XOPC_VOICE_REFINE_MODEL?.trim();\n  if (envRef) {\n    try {\n      return resolveModel(envRef);\n    } catch { /* fall through */ }\n  }\n  for (const candidate of ['openai/gpt-4o-mini', 'google/gemini-2.0-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch { /* next */ }\n  }\n  try {\n    return resolveModel(getDefaultModelSync(config));\n  } catch {\n    return null;\n  }\n}\n\nasync function refineTranscript(\n  raw: string,\n  config: Config | undefined,\n  signal?: AbortSignal,\n): Promise<string | undefined> {\n  if (!raw.trim()) return undefined;\n\n  const model = resolveRefineModel(config);\n  if (!model) {\n    log.debug('No LLM model available for voice refine; returning raw only');\n    return undefined;\n  }\n\n  try {\n    const userMsg: UserMessage = {\n      role: 'user',\n      content: `${REFINE_SYSTEM_PROMPT}\\n\\n原文：${raw}`,\n      timestamp: Date.now(),\n    };\n\n    const timeoutSignal =\n      typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n        ? AbortSignal.timeout(REFINE_TIMEOUT_MS)\n        : undefined;\n    const mergedSignal =\n      signal && timeoutSignal && typeof AbortSignal.any === 'function'\n        ? AbortSignal.any([signal, timeoutSignal])\n        : signal ?? timeoutSignal;\n\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: Math.min(raw.length * 3, 4096),\n        temperature: 0.2,\n        signal: mergedSignal as AbortSignal,\n      },\n    );\n\n    let out = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          out += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const refined = out.trim();\n    if (!refined || refined === raw.trim()) return undefined;\n    return refined;\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    log.warn({ errorMessage: msg }, 'Voice refine failed; returning raw only');\n    return undefined;\n  }\n}\n\nexport function registerVoiceRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { service, strictRateLimitMiddleware } = deps;\n\n  /**\n   * GET /api/voice/providers\n   *\n   * Lists registered SpeechProviderPlugin ids with configured state for the\n   * current gateway config (OpenClaw `tts.providers` equivalent).\n   */\n  authenticated.get('/api/voice/providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listTtsProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * GET /api/voice/stt-providers\n   *\n   * Lists registered MediaUnderstandingProvider ids with configured state for\n   * the current gateway config (OpenClaw `tools.media.audio.providers` equivalent).\n   */\n  authenticated.get('/api/voice/stt-providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listSttProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * POST /api/voice/reveal-api-key — return plaintext voice provider apiKey from config file only.\n   * Body: `{ kind: 'stt' | 'tts', provider: string }`\n   */\n  authenticated.post('/api/voice/reveal-api-key', strictRateLimitMiddleware, async (c) => {\n    let body: { kind?: unknown; provider?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n    const kind = body.kind === 'stt' || body.kind === 'tts' ? body.kind : null;\n    const provider = typeof body.provider === 'string' ? body.provider.trim() : '';\n    if (!kind) {\n      return c.json({ ok: false, error: { message: 'kind must be \"stt\" or \"tts\"' } }, 400);\n    }\n    if (!provider) {\n      return c.json({ ok: false, error: { message: 'provider is required' } }, 400);\n    }\n\n    const cfg = service.currentConfig as Config;\n    const apiKey = readVoiceApiKeyFromConfigFileOnly(cfg, kind, provider);\n    return c.json({\n      ok: true,\n      payload: {\n        kind,\n        provider,\n        apiKey: apiKey ?? null,\n        source: apiKey ? ('config' as const) : ('none' as const),\n      },\n    });\n  });\n\n  /**\n   * POST /api/voice/tts-test\n   *\n   * Body: { text: string, provider?: string, model?: string, voice?: string }\n   * Response: { ok: true, payload: { audio: string, format: string, provider: string } }\n   */\n  authenticated.post('/api/voice/tts-test', strictRateLimitMiddleware, async (c) => {\n    let body: { text?: unknown; provider?: unknown; model?: unknown; voice?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const text = typeof body.text === 'string' ? body.text.trim() : '';\n    if (!text) {\n      return c.json({ ok: false, error: { message: 'text is required' } }, 400);\n    }\n    if (text.length > 1000) {\n      return c.json({ ok: false, error: { message: 'text exceeds 1000 characters' } }, 400);\n    }\n\n    const config = service.currentConfig as Config;\n    const baseTtsConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);\n    const provider = typeof body.provider === 'string' && body.provider.trim() ? body.provider.trim() : baseTtsConfig.provider;\n    const ttsConfig = {\n      ...baseTtsConfig,\n      enabled: true,\n      provider,\n      fallback: { enabled: false, order: [provider] },\n    };\n\n    if (!isTTSAvailable(ttsConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: `TTS provider \"${provider}\" is not configured.` },\n      }, 503);\n    }\n\n    try {\n      const result = await speak(text, ttsConfig, {\n        appConfig: config,\n        parseDirectives: false,\n        tts: {\n          ...(typeof body.model === 'string' && body.model.trim() ? { model: body.model.trim() } : {}),\n          ...(typeof body.voice === 'string' && body.voice.trim() ? { voice: body.voice.trim() } : {}),\n        },\n      });\n      return c.json({\n        ok: true,\n        payload: {\n          audio: result.audio.toString('base64'),\n          format: result.format,\n          provider: result.provider,\n          ...(result.duration !== undefined ? { duration: result.duration } : {}),\n        },\n      });\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg, provider }, 'Voice TTS test failed');\n      return c.json({ ok: false, error: { message: `TTS test failed: ${msg}` } }, 502);\n    }\n  });\n\n  /**\n   * POST /api/voice/transcribe\n   *\n   * Body: { audio: string (base64), mimeType: string, language?: string }\n   * Response: { ok: true, payload: { raw: string, refined?: string, language?: string } }\n   */\n  authenticated.post('/api/voice/transcribe', async (c) => {\n    let body: { audio?: string; mimeType?: string; language?: string } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { audio, mimeType, language } = body;\n    if (!audio || typeof audio !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: audio (base64)' } }, 400);\n    }\n    if (!mimeType || typeof mimeType !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: mimeType' } }, 400);\n    }\n\n    // Decode base64 audio\n    let audioBuffer: Buffer;\n    try {\n      audioBuffer = Buffer.from(audio, 'base64');\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid base64 audio data' } }, 400);\n    }\n\n    if (audioBuffer.length === 0) {\n      return c.json({ ok: false, error: { message: 'Empty audio data' } }, 400);\n    }\n    if (audioBuffer.length > MAX_AUDIO_BYTES) {\n      return c.json({ ok: false, error: { message: 'Audio data exceeds 25 MB limit' } }, 400);\n    }\n\n    // Resolve STT config from app config\n    const config = service.currentConfig as Config;\n    const sttConfigRaw = config.tools?.media?.audio;\n    const sttConfig = mergeSttConfigFromAppConfig(sttConfigRaw, config.tools?.media);\n\n    if (!isSTTAvailable(sttConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: 'STT is not configured. Enable STT in gateway config (tools.media.audio).' },\n      }, 503);\n    }\n\n    // Run STT\n    let raw: string;\n    let detectedLanguage: string | undefined;\n    try {\n      const result = await transcribe(audioBuffer, sttConfig, {\n        language: language || (sttConfig.provider === 'alibaba' ? 'zh' : undefined),\n      });\n      raw = result.text;\n      detectedLanguage = result.language ?? language;\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg }, 'Voice transcription failed');\n      return c.json({ ok: false, error: { message: `Transcription failed: ${msg}` } }, 502);\n    }\n\n    if (!raw.trim()) {\n      return c.json({\n        ok: true,\n        payload: { raw: '', language: detectedLanguage },\n      });\n    }\n\n    // Run LLM refine (auto, best-effort)\n    const refined = await refineTranscript(raw, config);\n\n    return c.json({\n      ok: true,\n      payload: {\n        raw,\n        ...(refined ? { refined } : {}),\n        ...(detectedLanguage ? { language: detectedLanguage } : {}),\n      },\n    });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"voice.js","names":[],"sources":["../../../../../src/gateway/hono/routes/voice.ts"],"sourcesContent":["/**\n * Voice routes — POST /api/voice/transcribe\n *\n * Single endpoint that:\n *   1. Runs STT (Whisper preferred for low latency, Alibaba fallback)\n *   2. Optionally runs LLM refine on the raw transcript\n *   3. Returns { raw, refined?, language }\n *\n * LLM refine is auto-applied when a model is resolvable; gracefully degrades\n * to raw-only when no LLM is configured.\n */\n\nimport type { Hono } from 'hono';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../../providers/index.js';\nimport { isSTTAvailable, transcribe } from '../../../voice/stt/index.js';\nimport { isTTSAvailable, mergeTtsConfigFromAppConfig, speak } from '../../../voice/tts/index.js';\nimport { listTtsProvidersForApi } from '../../../voice/tts/list-providers.js';\nimport { listSttProvidersForApi } from '../../../voice/stt/list-providers.js';\nimport { mergeSttConfigFromAppConfig } from '../../../channels/attachments/voice-stt-webchat.js';\nimport { resolveSttProviderConfigSlice } from '../../../voice/stt/config-slice.js';\nimport { resolveTtsProviderConfigSlice } from '../../../voice/tts/config-slice.js';\nimport { createGatewayRouteLogger } from '../lib/route-logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createGatewayRouteLogger('Voice');\n\nfunction readVoiceApiKeyFromConfigFileOnly(\n  cfg: Config,\n  kind: 'stt' | 'tts',\n  providerId: string,\n): string | undefined {\n  const id = providerId.trim();\n  if (!id) return undefined;\n  const slice =\n    kind === 'stt'\n      ? resolveSttProviderConfigSlice(id, cfg.tools?.media?.audio)\n      : resolveTtsProviderConfigSlice(id, cfg.messages?.tts);\n  const key = slice.apiKey;\n  return typeof key === 'string' && key.trim() ? key.trim() : undefined;\n}\n\nconst REFINE_TIMEOUT_MS = 15_000;\nconst MAX_AUDIO_BYTES = 25 * 1024 * 1024; // 25 MB\n\nconst REFINE_SYSTEM_PROMPT = `你是语音转文字后处理助手。将语音转写原文整理为高质量文本输入。\n\n规则：\n1. 修正明显的语音识别错误\n2. 添加正确的标点符号\n3. 去除口语赘词（嗯、啊、那个、就是说、然后就是）\n4. 保持原意不变，不要扩写或改变语义\n5. 如果原文已经很好，原样输出\n6. 只输出整理后的文字，不要解释`;\n\nfunction resolveRefineModel(config: Config | undefined): ReturnType<typeof resolveModel> | null {\n  const envRef = process.env.XOPC_VOICE_REFINE_MODEL?.trim();\n  if (envRef) {\n    try {\n      return resolveModel(envRef);\n    } catch { /* fall through */ }\n  }\n  for (const candidate of ['openai/gpt-4o-mini', 'google/gemini-2.0-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch { /* next */ }\n  }\n  try {\n    return resolveModel(getDefaultModelSync(config));\n  } catch {\n    return null;\n  }\n}\n\nasync function refineTranscript(\n  raw: string,\n  config: Config | undefined,\n  signal?: AbortSignal,\n): Promise<string | undefined> {\n  if (!raw.trim()) return undefined;\n\n  const model = resolveRefineModel(config);\n  if (!model) {\n    log.debug('No LLM model available for voice refine; returning raw only');\n    return undefined;\n  }\n\n  try {\n    const userMsg: UserMessage = {\n      role: 'user',\n      content: `${REFINE_SYSTEM_PROMPT}\\n\\n原文：${raw}`,\n      timestamp: Date.now(),\n    };\n\n    const timeoutSignal =\n      typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n        ? AbortSignal.timeout(REFINE_TIMEOUT_MS)\n        : undefined;\n    const mergedSignal =\n      signal && timeoutSignal && typeof AbortSignal.any === 'function'\n        ? AbortSignal.any([signal, timeoutSignal])\n        : signal ?? timeoutSignal;\n\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: Math.min(raw.length * 3, 4096),\n        temperature: 0.2,\n        signal: mergedSignal as AbortSignal,\n      },\n    );\n\n    let out = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          out += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const refined = out.trim();\n    if (!refined || refined === raw.trim()) return undefined;\n    return refined;\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    log.warn({ errorMessage: msg }, 'Voice refine failed; returning raw only');\n    return undefined;\n  }\n}\n\nexport function registerVoiceRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { service, strictRateLimitMiddleware } = deps;\n\n  /**\n   * GET /api/voice/providers\n   *\n   * Lists registered SpeechProviderPlugin ids with configured state for the\n   * current gateway config (OpenClaw `tts.providers` equivalent).\n   */\n  authenticated.get('/api/voice/providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listTtsProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * GET /api/voice/stt-providers\n   *\n   * Lists registered MediaUnderstandingProvider ids with configured state for\n   * the current gateway config (OpenClaw `tools.media.audio.providers` equivalent).\n   */\n  authenticated.get('/api/voice/stt-providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listSttProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * POST /api/voice/reveal-api-key — return plaintext voice provider apiKey from config file only.\n   * Body: `{ kind: 'stt' | 'tts', provider: string }`\n   */\n  authenticated.post('/api/voice/reveal-api-key', strictRateLimitMiddleware, async (c) => {\n    let body: { kind?: unknown; provider?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n    const kind = body.kind === 'stt' || body.kind === 'tts' ? body.kind : null;\n    const provider = typeof body.provider === 'string' ? body.provider.trim() : '';\n    if (!kind) {\n      return c.json({ ok: false, error: { message: 'kind must be \"stt\" or \"tts\"' } }, 400);\n    }\n    if (!provider) {\n      return c.json({ ok: false, error: { message: 'provider is required' } }, 400);\n    }\n\n    const cfg = service.currentConfig as Config;\n    const apiKey = readVoiceApiKeyFromConfigFileOnly(cfg, kind, provider);\n    return c.json({\n      ok: true,\n      payload: {\n        kind,\n        provider,\n        apiKey: apiKey ?? null,\n        source: apiKey ? ('config' as const) : ('none' as const),\n      },\n    });\n  });\n\n  /**\n   * POST /api/voice/tts-test\n   *\n   * Body: { text: string, provider?: string, model?: string, voice?: string }\n   * Response: { ok: true, payload: { audio: string, format: string, provider: string } }\n   */\n  authenticated.post('/api/voice/tts-test', strictRateLimitMiddleware, async (c) => {\n    let body: { text?: unknown; provider?: unknown; model?: unknown; voice?: unknown; providerConfig?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const text = typeof body.text === 'string' ? body.text.trim() : '';\n    if (!text) {\n      return c.json({ ok: false, error: { message: 'text is required' } }, 400);\n    }\n    if (text.length > 1000) {\n      return c.json({ ok: false, error: { message: 'text exceeds 1000 characters' } }, 400);\n    }\n\n    const config = service.currentConfig as Config;\n    const baseTtsConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);\n    const provider = typeof body.provider === 'string' && body.provider.trim() ? body.provider.trim() : baseTtsConfig.provider;\n    const providerConfig =\n      body.providerConfig && typeof body.providerConfig === 'object' && !Array.isArray(body.providerConfig)\n        ? (body.providerConfig as Record<string, unknown>)\n        : undefined;\n    const ttsConfig = {\n      ...baseTtsConfig,\n      enabled: true,\n      provider,\n      providers: {\n        ...(baseTtsConfig.providers ?? {}),\n        ...(providerConfig ? { [provider]: { ...(baseTtsConfig.providers?.[provider] ?? {}), ...providerConfig } } : {}),\n      },\n      fallback: { enabled: false, order: [provider] },\n    };\n\n    if (!isTTSAvailable(ttsConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: `TTS provider \"${provider}\" is not configured.` },\n      }, 503);\n    }\n\n    try {\n      const startedAt = Date.now();\n      const result = await speak(text, ttsConfig, {\n        appConfig: config,\n        parseDirectives: false,\n        tts: {\n          ...(typeof body.model === 'string' && body.model.trim() ? { model: body.model.trim() } : {}),\n          ...(typeof body.voice === 'string' && body.voice.trim() ? { voice: body.voice.trim() } : {}),\n        },\n      });\n      if (!result.audio.length) {\n        throw new Error(`TTS provider \"${result.provider}\" returned empty audio`);\n      }\n      const mimeType =\n        result.format === 'opus' || result.format === 'ogg'\n          ? 'audio/ogg'\n          : result.format === 'mp3' || result.format === 'mpeg'\n            ? 'audio/mpeg'\n            : result.format === 'wav'\n              ? 'audio/wav'\n              : `audio/${result.format}`;\n      return c.json({\n        ok: true,\n        payload: {\n          audio: result.audio.toString('base64'),\n          mimeType,\n          format: result.format,\n          provider: result.provider,\n          latencyMs: Date.now() - startedAt,\n          audioSize: result.audio.length,\n        },\n      });\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg, provider }, 'Voice TTS test failed');\n      return c.json({ ok: false, error: { message: `TTS test failed: ${msg}` } }, 502);\n    }\n  });\n\n  /**\n   * POST /api/voice/transcribe\n   *\n   * Body: { audio: string (base64), mimeType: string, language?: string }\n   * Response: { ok: true, payload: { raw: string, refined?: string, language?: string } }\n   */\n  authenticated.post('/api/voice/transcribe', async (c) => {\n    let body: { audio?: string; mimeType?: string; language?: string } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { audio, mimeType, language } = body;\n    if (!audio || typeof audio !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: audio (base64)' } }, 400);\n    }\n    if (!mimeType || typeof mimeType !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: mimeType' } }, 400);\n    }\n\n    // Decode base64 audio\n    let audioBuffer: Buffer;\n    try {\n      audioBuffer = Buffer.from(audio, 'base64');\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid base64 audio data' } }, 400);\n    }\n\n    if (audioBuffer.length === 0) {\n      return c.json({ ok: false, error: { message: 'Empty audio data' } }, 400);\n    }\n    if (audioBuffer.length > MAX_AUDIO_BYTES) {\n      return c.json({ ok: false, error: { message: 'Audio data exceeds 25 MB limit' } }, 400);\n    }\n\n    // Resolve STT config from app config\n    const config = service.currentConfig as Config;\n    const sttConfigRaw = config.tools?.media?.audio;\n    const sttConfig = mergeSttConfigFromAppConfig(sttConfigRaw, config.tools?.media);\n\n    if (!isSTTAvailable(sttConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: 'STT is not configured. Enable STT in gateway config (tools.media.audio).' },\n      }, 503);\n    }\n\n    // Run STT\n    let raw: string;\n    let detectedLanguage: string | undefined;\n    try {\n      const result = await transcribe(audioBuffer, sttConfig, {\n        language: language || (sttConfig.provider === 'alibaba' ? 'zh' : undefined),\n      });\n      raw = result.text;\n      detectedLanguage = result.language ?? language;\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg }, 'Voice transcription failed');\n      return c.json({ ok: false, error: { message: `Transcription failed: ${msg}` } }, 502);\n    }\n\n    if (!raw.trim()) {\n      return c.json({\n        ok: true,\n        payload: { raw: '', language: detectedLanguage },\n      });\n    }\n\n    // Run LLM refine (auto, best-effort)\n    const refined = await refineTranscript(raw, config);\n\n    return c.json({\n      ok: true,\n      payload: {\n        raw,\n        ...(refined ? { refined } : {}),\n        ...(detectedLanguage ? { language: detectedLanguage } : {}),\n      },\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;gBAgBgF;AAWhF,MAAM,MAAM,yBAAyB,QAAQ;AAE7C,SAAS,kCACP,KACA,MACA,YACoB;CACpB,MAAM,KAAK,WAAW,MAAM;AAC5B,KAAI,CAAC,GAAI,QAAO,KAAA;CAKhB,MAAM,OAHJ,SAAS,QACL,8BAA8B,IAAI,IAAI,OAAO,OAAO,MAAM,GAC1D,8BAA8B,IAAI,IAAI,UAAU,IAAI,EACxC;AAClB,QAAO,OAAO,QAAQ,YAAY,IAAI,MAAM,GAAG,IAAI,MAAM,GAAG,KAAA;;AAG9D,MAAM,oBAAoB;AAC1B,MAAM,kBAAkB,KAAK,OAAO;AAEpC,MAAM,uBAAuB;;;;;;;;;AAU7B,SAAS,mBAAmB,QAAoE;CAC9F,MAAM,SAAS,QAAQ,IAAI,yBAAyB,MAAM;AAC1D,KAAI,OACF,KAAI;AACF,SAAO,aAAa,OAAO;SACrB;AAEV,MAAK,MAAM,aAAa,CAAC,sBAAsB,0BAA0B,CACvE,KAAI;AACF,SAAO,aAAa,UAAU;SACxB;AAEV,KAAI;AACF,SAAO,aAAa,oBAAoB,OAAO,CAAC;SAC1C;AACN,SAAO;;;AAIX,eAAe,iBACb,KACA,QACA,QAC6B;AAC7B,KAAI,CAAC,IAAI,MAAM,CAAE,QAAO,KAAA;CAExB,MAAM,QAAQ,mBAAmB,OAAO;AACxC,KAAI,CAAC,OAAO;AACV,MAAI,MAAM,8DAA8D;AACxE;;AAGF,KAAI;EACF,MAAM,UAAuB;GAC3B,MAAM;GACN,SAAS,GAAG,qBAAqB,SAAS;GAC1C,WAAW,KAAK,KAAK;GACtB;EAED,MAAM,gBACJ,OAAO,gBAAgB,eAAe,OAAO,YAAY,YAAY,aACjE,YAAY,QAAQ,kBAAkB,GACtC,KAAA;EACN,MAAM,eACJ,UAAU,iBAAiB,OAAO,YAAY,QAAQ,aAClD,YAAY,IAAI,CAAC,QAAQ,cAAc,CAAC,GACxC,UAAU;EAEhB,MAAM,SAAS,MAAM,SACnB,OACA,EAAE,UAAU,CAAC,QAAQ,EAAE,EACvB;GACE,WAAW,KAAK,IAAI,IAAI,SAAS,GAAG,KAAK;GACzC,aAAa;GACb,QAAQ;GACT,CACF;EAED,IAAI,MAAM;AACV,MAAI,MAAM,QAAQ,OAAO,QAAQ;QAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,QAAO,OAAQ,EAAwB,QAAQ,GAAG;;EAKxD,MAAM,UAAU,IAAI,MAAM;AAC1B,MAAI,CAAC,WAAW,YAAY,IAAI,MAAM,CAAE,QAAO,KAAA;AAC/C,SAAO;UACA,OAAO;EACd,MAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAClE,MAAI,KAAK,EAAE,cAAc,KAAK,EAAE,0CAA0C;AAC1E;;;AAIJ,SAAgB,oBAAoB,eAAqB,MAAoC;CAC3F,MAAM,EAAE,SAAS,8BAA8B;;;;;;;AAQ/C,eAAc,IAAI,yBAAyB,MAAM;EAC/C,MAAM,SAAS,QAAQ;EACvB,MAAM,UAAU,uBAAuB,OAAO;AAC9C,SAAO,EAAE,KAAK;GAAE,IAAI;GAAM;GAAS,CAAC;GACpC;;;;;;;AAQF,eAAc,IAAI,6BAA6B,MAAM;EACnD,MAAM,SAAS,QAAQ;EACvB,MAAM,UAAU,uBAAuB,OAAO;AAC9C,SAAO,EAAE,KAAK;GAAE,IAAI;GAAM;GAAS,CAAC;GACpC;;;;;AAMF,eAAc,KAAK,6BAA6B,2BAA2B,OAAO,MAAM;EACtF,IAAI,OAA+C,EAAE;AACrD,MAAI;AACF,UAAQ,MAAM,EAAE,IAAI,MAAM;UACpB;AACN,UAAO,EAAE,KAAK;IAAE,IAAI;IAAO,OAAO,EAAE,SAAS,qBAAqB;IAAE,EAAE,IAAI;;EAE5E,MAAM,OAAO,KAAK,SAAS,SAAS,KAAK,SAAS,QAAQ,KAAK,OAAO;EACtE,MAAM,WAAW,OAAO,KAAK,aAAa,WAAW,KAAK,SAAS,MAAM,GAAG;AAC5E,MAAI,CAAC,KACH,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,mCAA+B;GAAE,EAAE,IAAI;AAEtF,MAAI,CAAC,SACH,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,wBAAwB;GAAE,EAAE,IAAI;EAG/E,MAAM,MAAM,QAAQ;EACpB,MAAM,SAAS,kCAAkC,KAAK,MAAM,SAAS;AACrE,SAAO,EAAE,KAAK;GACZ,IAAI;GACJ,SAAS;IACP;IACA;IACA,QAAQ,UAAU;IAClB,QAAQ,SAAU,WAAsB;IACzC;GACF,CAAC;GACF;;;;;;;AAQF,eAAc,KAAK,uBAAuB,2BAA2B,OAAO,MAAM;EAChF,IAAI,OAA2G,EAAE;AACjH,MAAI;AACF,UAAQ,MAAM,EAAE,IAAI,MAAM;UACpB;AACN,UAAO,EAAE,KAAK;IAAE,IAAI;IAAO,OAAO,EAAE,SAAS,qBAAqB;IAAE,EAAE,IAAI;;EAG5E,MAAM,OAAO,OAAO,KAAK,SAAS,WAAW,KAAK,KAAK,MAAM,GAAG;AAChE,MAAI,CAAC,KACH,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,oBAAoB;GAAE,EAAE,IAAI;AAE3E,MAAI,KAAK,SAAS,IAChB,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,gCAAgC;GAAE,EAAE,IAAI;EAGvF,MAAM,SAAS,QAAQ;EACvB,MAAM,gBAAgB,4BAA4B,OAAO,UAAU,IAAI;EACvE,MAAM,WAAW,OAAO,KAAK,aAAa,YAAY,KAAK,SAAS,MAAM,GAAG,KAAK,SAAS,MAAM,GAAG,cAAc;EAClH,MAAM,iBACJ,KAAK,kBAAkB,OAAO,KAAK,mBAAmB,YAAY,CAAC,MAAM,QAAQ,KAAK,eAAe,GAChG,KAAK,iBACN,KAAA;EACN,MAAM,YAAY;GAChB,GAAG;GACH,SAAS;GACT;GACA,WAAW;IACT,GAAI,cAAc,aAAa,EAAE;IACjC,GAAI,iBAAiB,GAAG,WAAW;KAAE,GAAI,cAAc,YAAY,aAAa,EAAE;KAAG,GAAG;KAAgB,EAAE,GAAG,EAAE;IAChH;GACD,UAAU;IAAE,SAAS;IAAO,OAAO,CAAC,SAAS;IAAE;GAChD;AAED,MAAI,CAAC,eAAe,UAAU,CAC5B,QAAO,EAAE,KAAK;GACZ,IAAI;GACJ,OAAO,EAAE,SAAS,iBAAiB,SAAS,uBAAuB;GACpE,EAAE,IAAI;AAGT,MAAI;GACF,MAAM,YAAY,KAAK,KAAK;GAC5B,MAAM,SAAS,MAAM,MAAM,MAAM,WAAW;IAC1C,WAAW;IACX,iBAAiB;IACjB,KAAK;KACH,GAAI,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,MAAM,GAAG,EAAE,OAAO,KAAK,MAAM,MAAM,EAAE,GAAG,EAAE;KAC3F,GAAI,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,MAAM,GAAG,EAAE,OAAO,KAAK,MAAM,MAAM,EAAE,GAAG,EAAE;KAC5F;IACF,CAAC;AACF,OAAI,CAAC,OAAO,MAAM,OAChB,OAAM,IAAI,MAAM,iBAAiB,OAAO,SAAS,wBAAwB;GAE3E,MAAM,WACJ,OAAO,WAAW,UAAU,OAAO,WAAW,QAC1C,cACA,OAAO,WAAW,SAAS,OAAO,WAAW,SAC3C,eACA,OAAO,WAAW,QAChB,cACA,SAAS,OAAO;AAC1B,UAAO,EAAE,KAAK;IACZ,IAAI;IACJ,SAAS;KACP,OAAO,OAAO,MAAM,SAAS,SAAS;KACtC;KACA,QAAQ,OAAO;KACf,UAAU,OAAO;KACjB,WAAW,KAAK,KAAK,GAAG;KACxB,WAAW,OAAO,MAAM;KACzB;IACF,CAAC;WACK,OAAO;GACd,MAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAClE,OAAI,MAAM;IAAE,cAAc;IAAK;IAAU,EAAE,wBAAwB;AACnE,UAAO,EAAE,KAAK;IAAE,IAAI;IAAO,OAAO,EAAE,SAAS,oBAAoB,OAAO;IAAE,EAAE,IAAI;;GAElF;;;;;;;AAQF,eAAc,KAAK,yBAAyB,OAAO,MAAM;EACvD,IAAI,OAAiE,EAAE;AACvE,MAAI;AACF,UAAQ,MAAM,EAAE,IAAI,MAAM;UACpB;AACN,UAAO,EAAE,KAAK;IAAE,IAAI;IAAO,OAAO,EAAE,SAAS,qBAAqB;IAAE,EAAE,IAAI;;EAG5E,MAAM,EAAE,OAAO,UAAU,aAAa;AACtC,MAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,0CAA0C;GAAE,EAAE,IAAI;AAEjG,MAAI,CAAC,YAAY,OAAO,aAAa,SACnC,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,oCAAoC;GAAE,EAAE,IAAI;EAI3F,IAAI;AACJ,MAAI;AACF,iBAAc,OAAO,KAAK,OAAO,SAAS;UACpC;AACN,UAAO,EAAE,KAAK;IAAE,IAAI;IAAO,OAAO,EAAE,SAAS,6BAA6B;IAAE,EAAE,IAAI;;AAGpF,MAAI,YAAY,WAAW,EACzB,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,oBAAoB;GAAE,EAAE,IAAI;AAE3E,MAAI,YAAY,SAAS,gBACvB,QAAO,EAAE,KAAK;GAAE,IAAI;GAAO,OAAO,EAAE,SAAS,kCAAkC;GAAE,EAAE,IAAI;EAIzF,MAAM,SAAS,QAAQ;EACvB,MAAM,eAAe,OAAO,OAAO,OAAO;EAC1C,MAAM,YAAY,4BAA4B,cAAc,OAAO,OAAO,MAAM;AAEhF,MAAI,CAAC,eAAe,UAAU,CAC5B,QAAO,EAAE,KAAK;GACZ,IAAI;GACJ,OAAO,EAAE,SAAS,4EAA4E;GAC/F,EAAE,IAAI;EAIT,IAAI;EACJ,IAAI;AACJ,MAAI;GACF,MAAM,SAAS,MAAM,WAAW,aAAa,WAAW,EACtD,UAAU,aAAa,UAAU,aAAa,YAAY,OAAO,KAAA,IAClE,CAAC;AACF,SAAM,OAAO;AACb,sBAAmB,OAAO,YAAY;WAC/B,OAAO;GACd,MAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAClE,OAAI,MAAM,EAAE,cAAc,KAAK,EAAE,6BAA6B;AAC9D,UAAO,EAAE,KAAK;IAAE,IAAI;IAAO,OAAO,EAAE,SAAS,yBAAyB,OAAO;IAAE,EAAE,IAAI;;AAGvF,MAAI,CAAC,IAAI,MAAM,CACb,QAAO,EAAE,KAAK;GACZ,IAAI;GACJ,SAAS;IAAE,KAAK;IAAI,UAAU;IAAkB;GACjD,CAAC;EAIJ,MAAM,UAAU,MAAM,iBAAiB,KAAK,OAAO;AAEnD,SAAO,EAAE,KAAK;GACZ,IAAI;GACJ,SAAS;IACP;IACA,GAAI,UAAU,EAAE,SAAS,GAAG,EAAE;IAC9B,GAAI,mBAAmB,EAAE,UAAU,kBAAkB,GAAG,EAAE;IAC3D;GACF,CAAC;GACF"}

package/dist/src/gateway/hono/sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.js","names":[],"sources":["../../../../src/gateway/hono/sse.ts"],"sourcesContent":["import { streamSSE } from 'hono/streaming';\nimport type { Context } from 'hono';\nimport type { GatewayService } from '../service.js';\nimport { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from '../chat-limits.js';\nimport { createLogger, updateAsyncLogContext } from '../../utils/logger.js';\nimport { stringifySSEData } from './sse-json.js';\nimport { resolveWebchatSessionKey } from '../resolve-webchat-session-key.js';\n\nconst log = createLogger('Gateway:SSE');\n\n// Active SSE connections tracking for connection limiting\nconst activeConnections = new Map<string, AbortController>();\n\nexport interface SSEHandlerConfig {\n  service: GatewayService;\n  maxSseConnections?: number;\n}\n\n// Type validation for agent request body\ninterface AgentRequestBody {\n  message: string;\n  channel?: string;\n  sessionKey?: string;\n  /** Epoch ms when the client started this send (abort cutoff / stale POST drop). */\n  clientCreatedAtMs?: number;\n  thinking?: string;\n  attachments?: Array<{\n    type: string;\n    mimeType?: string;\n    data?: string;\n    uri?: string;\n    name?: string;\n    size?: number;\n    workspaceRelativePath?: string;\n    durationSeconds?: number;\n  }>;\n}\n\nfunction isValidAgentRequest(body: unknown): body is AgentRequestBody {\n  if (!body || typeof body !== 'object') return false;\n  const b = body as Record<string, unknown>;\n  // Allow empty message if attachments are provided\n  const hasMessage = typeof b.message === 'string';\n  const hasAttachments = Array.isArray(b.attachments) && b.attachments.length > 0;\n  return hasMessage || hasAttachments;\n}\n\n/** Max base64 character length that can decode to `MAX_WEBCHAT_ATTACHMENT_FILE_BYTES`. */\nfunction maxBase64CharsForBinary(maxBinaryBytes: number): number {\n  return 4 * Math.ceil(maxBinaryBytes / 3);\n}\n\n/**\n * POST /api/agent — Send a message to the agent, stream response via SSE.\n *\n * Request body: { message, channel?, sessionKey, attachments? }\n * Accept: text/event-stream → SSE stream\n * Accept: application/json → wait for full response, return JSON\n *\n * SSE events follow XOPC Chat Stream Protocol v1:\n *   run_start, user_message, user_transcript, assistant_message_start,\n *   assistant_delta, thinking_delta, thinking_end, tool_start, tool_update,\n *   tool_end, assistant_message_end, compaction, tts_audio, clarify_request,\n *   run_end, error.\n */\nexport function createAgentSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n\n    // Input validation\n    if (!isValidAgentRequest(body)) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: 'Missing required field: message or attachments' }\n      }, 400);\n    }\n\n    const { message, channel = 'webchat', attachments, thinking } = body;\n    const clientCreatedAtMs =\n      typeof body.clientCreatedAtMs === 'number' && Number.isFinite(body.clientCreatedAtMs)\n        ? body.clientCreatedAtMs\n        : undefined;\n    const resolved = resolveWebchatSessionKey({\n      sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n    });\n    if (resolved.ok === false) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: resolved.error },\n      }, 400);\n    }\n    const chatId = resolved.sessionKey;\n\n    updateAsyncLogContext({ sessionKey: String(chatId) });\n\n    if (Array.isArray(attachments)) {\n      const maxDataChars = maxBase64CharsForBinary(MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);\n      for (const a of attachments) {\n        if (!a || typeof a !== 'object') continue;\n        const data = (a as { data?: unknown }).data;\n        if (typeof data === 'string' && data.length > maxDataChars) {\n          return c.json(\n            {\n              ok: false,\n              error: {\n                code: 'BAD_REQUEST',\n                message: `Attachment exceeds maximum size (${MAX_WEBCHAT_ATTACHMENT_FILE_BYTES} bytes)`,\n              },\n            },\n            400,\n          );\n        }\n      }\n    }\n\n    const accept = c.req.header('Accept') || '';\n    const wantSSE = accept.includes('text/event-stream');\n\n    const clientAbort = new AbortController();\n    const raw = c.req.raw;\n    // Keep webchat runs alive across transient disconnects (page refresh / tab route switch)\n    // so the client can reattach via /api/agent/resume using runId from `run_start`.\n    // Explicit cancellation still goes through /api/agent/abort.\n    if (channel !== 'webchat') {\n      if (raw.signal.aborted) {\n        clientAbort.abort();\n      } else {\n        raw.signal.addEventListener('abort', () => clientAbort.abort(), { once: true });\n      }\n    }\n\n    // --- Non-streaming fallback: collect everything, return JSON ---\n    if (!wantSSE) {\n      const jsonSessionKey = channel === 'webchat' ? chatId : undefined;\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n      try {\n        let finalResult: { status: string; summary: string } | undefined;\n        const tokens: string[] = [];\n\n        while (true) {\n          const { done, value } = await generator.next();\n          if (done) {\n            finalResult = value as { status: string; summary: string };\n            break;\n          }\n          const chunk = value as { type: string; payload?: { delta?: unknown } };\n          if (chunk.type === 'assistant_delta' && typeof chunk.payload?.delta === 'string') {\n            tokens.push(chunk.payload.delta);\n          }\n        }\n\n        return c.json({\n          ok: true,\n          payload: {\n            ...finalResult,\n            content: tokens.join(''),\n            ...(jsonSessionKey !== undefined\n              ? { sessionKey: jsonSessionKey, key: jsonSessionKey }\n              : {}),\n          },\n        });\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        log.error(\n          { err: error, errorMessage: em, phase: 'gateway.agent_run', sessionKey: jsonSessionKey, channel },\n          `Agent run failed (JSON mode): ${em}`,\n        );\n        return c.json({\n          ok: false,\n          error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n        }, 500);\n      }\n    }\n\n    // --- SSE streaming ---\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      if (channel !== 'webchat') {\n        stream.onAbort(() => {\n          clientAbort.abort();\n        });\n      }\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n\n      let eventId = 0;\n\n      try {\n        while (true) {\n          const { done, value } = await generator.next();\n\n          if (done) break;\n\n          const chunk = value as { type: string; seq?: unknown };\n          await stream.writeSSE({\n            id: typeof chunk.seq === 'number' ? String(chunk.seq) : String(++eventId),\n            event: chunk.type || 'message',\n            data: stringifySSEData(chunk),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error }, 'Agent run failed (SSE mode)');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId: 'unknown',\n            sessionKey: chatId,\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/agent/resume — Re-attach to an in-progress agent run via SSE.\n *\n * Request body: { runId, sessionKey }\n * The relay replays all buffered events from the beginning and then live-tails\n * until the run completes.\n *\n * SSE events are identical to those from POST /api/agent.\n */\nexport function createAgentResumeHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n    if (!body || typeof body !== 'object') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { runId, sessionKey } = body as { runId?: string; sessionKey?: string };\n    if (typeof sessionKey === 'string' && sessionKey.trim()) {\n      updateAsyncLogContext({ sessionKey: sessionKey.trim() });\n    }\n    if (!runId || typeof runId !== 'string') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required field: runId' } }, 400);\n    }\n\n    if (!service.runRelay.hasRun(runId)) {\n      return c.json({ ok: false, error: { code: 'NOT_FOUND', message: 'Run not found or already expired' } }, 404);\n    }\n\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      let eventId = 0;\n      try {\n        for await (const event of service.runRelay.subscribe(runId)) {\n          await stream.writeSSE({\n            id: typeof event.seq === 'number' ? String(event.seq) : String(++eventId),\n            event: event.type || 'message',\n            data: stringifySSEData(event),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error, runId }, 'Resume stream failed');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId,\n            sessionKey: typeof sessionKey === 'string' ? sessionKey : '',\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/send — Send a message through a channel (non-streaming).\n */\nexport function createSendHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => ({}));\n    const channel = body.channel as string;\n    const chatId = body.chatId as string;\n    const content = body.content as string;\n\n    if (!channel || !chatId || !content) {\n      return c.json(\n        { ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required fields: channel, chatId, content' } },\n        400,\n      );\n    }\n\n    try {\n      const result = await service.sendMessage(channel, chatId, content);\n      return c.json({ ok: true, payload: result });\n    } catch (error) {\n      log.error({ err: error }, 'Send failed');\n      return c.json(\n        { ok: false, error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' } },\n        500,\n      );\n    }\n  };\n}\n\n/**\n * GET /api/events — Server-pushed event stream (SSE).\n *\n * The client opens this long-lived connection to receive:\n *   - channel status changes\n *   - config reload notifications\n *   - cron execution results\n *   - any other server-initiated events\n *\n * Supports Last-Event-ID for reconnection.\n * Enforces maximum connection limit to prevent DoS.\n */\nexport function createEventsSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n  const maxConnections = config.maxSseConnections ?? 100;\n\n  return async (c: Context) => {\n    // Check maximum connections limit\n    if (activeConnections.size >= maxConnections) {\n      log.warn({ current: activeConnections.size, max: maxConnections }, 'SSE connection limit reached');\n      return c.json({\n        ok: false,\n        error: { code: 'TOO_MANY_CONNECTIONS', message: 'Maximum SSE connections exceeded' }\n      }, 503);\n    }\n\n    const lastEventId = c.req.header('Last-Event-ID') || undefined;\n    const sessionId = c.req.header('X-Session-Id')\n      || c.req.query('sessionId')\n      || crypto.randomUUID();\n\n    updateAsyncLogContext({ sessionId: String(sessionId) });\n\n    const abortController = new AbortController();\n    activeConnections.set(sessionId, abortController);\n\n    return streamSSE(c, async (stream) => {\n      let aborted = false;\n\n      // Send a hello event so the client knows the stream is established\n      await stream.writeSSE({\n        id: '0',\n        event: 'connected',\n        data: JSON.stringify({ sessionId }),\n      });\n\n      // Subscribe to service events\n      const cleanup = service.subscribe(sessionId, async (event) => {\n        if (aborted) return;\n        try {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        } catch {\n          // Stream closed, will be cleaned up by onAbort\n        }\n      });\n\n      // Replay missed events on reconnect\n      if (lastEventId) {\n        const missed = service.getEventsSince(sessionId, lastEventId);\n        for (const event of missed) {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        }\n      }\n\n      // Keep alive with periodic comments (every 30s)\n      const keepAlive = setInterval(async () => {\n        if (aborted) { clearInterval(keepAlive); return; }\n        try {\n          await stream.writeSSE({ event: 'ping', data: '' });\n        } catch {\n          clearInterval(keepAlive);\n        }\n      }, 30_000);\n\n      // Block until aborted — streamSSE closes when the callback returns\n      await new Promise<void>((resolve) => {\n        stream.onAbort(() => {\n          aborted = true;\n          clearInterval(keepAlive);\n          cleanup();\n          activeConnections.delete(sessionId);\n          log.debug({ sessionId }, 'Event stream disconnected');\n          resolve();\n        });\n      });\n    });\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse.js","names":[],"sources":["../../../../src/gateway/hono/sse.ts"],"sourcesContent":["import { streamSSE } from 'hono/streaming';\nimport type { Context } from 'hono';\nimport type { GatewayService } from '../service.js';\nimport { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from '../chat-limits.js';\nimport { createLogger, updateAsyncLogContext } from '../../utils/logger.js';\nimport { stringifySSEData } from './sse-json.js';\nimport { resolveWebchatSessionKey } from '../resolve-webchat-session-key.js';\nimport type { UserTurnAttachment } from '../user-turn-input.js';\n\nconst log = createLogger('Gateway:SSE');\n\n// Active SSE connections tracking for connection limiting\nconst activeConnections = new Map<string, AbortController>();\n\nexport interface SSEHandlerConfig {\n  service: GatewayService;\n  maxSseConnections?: number;\n}\n\n// Type validation for agent request body\ninterface AgentRequestBody {\n  message: string;\n  channel?: string;\n  sessionKey?: string;\n  /** Epoch ms when the client started this send (abort cutoff / stale POST drop). */\n  clientCreatedAtMs?: number;\n  thinking?: string;\n  attachments?: UserTurnAttachment[];\n}\n\nfunction isValidAgentRequest(body: unknown): body is AgentRequestBody {\n  if (!body || typeof body !== 'object') return false;\n  const b = body as Record<string, unknown>;\n  // Allow empty message if attachments are provided\n  const hasMessage = typeof b.message === 'string';\n  const hasAttachments = Array.isArray(b.attachments) && b.attachments.length > 0;\n  return hasMessage || hasAttachments;\n}\n\n/** Max base64 character length that can decode to `MAX_WEBCHAT_ATTACHMENT_FILE_BYTES`. */\nfunction maxBase64CharsForBinary(maxBinaryBytes: number): number {\n  return 4 * Math.ceil(maxBinaryBytes / 3);\n}\n\n/**\n * POST /api/agent — Send a message to the agent, stream response via SSE.\n *\n * Request body: { message, channel?, sessionKey, attachments? }\n * Accept: text/event-stream → SSE stream\n * Accept: application/json → wait for full response, return JSON\n *\n * SSE events follow XOPC Chat Stream Protocol v1:\n *   run_start, user_message, user_transcript, assistant_message_start,\n *   assistant_delta, thinking_delta, thinking_end, tool_start, tool_update,\n *   tool_end, assistant_message_end, compaction, tts_audio, clarify_request,\n *   run_end, error.\n */\nexport function createAgentSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n\n    // Input validation\n    if (!isValidAgentRequest(body)) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: 'Missing required field: message or attachments' }\n      }, 400);\n    }\n\n    const { message, channel = 'webchat', attachments, thinking } = body;\n    const clientCreatedAtMs =\n      typeof body.clientCreatedAtMs === 'number' && Number.isFinite(body.clientCreatedAtMs)\n        ? body.clientCreatedAtMs\n        : undefined;\n    const resolved = resolveWebchatSessionKey({\n      sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n    });\n    if (resolved.ok === false) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: resolved.error },\n      }, 400);\n    }\n    const chatId = resolved.sessionKey;\n\n    updateAsyncLogContext({ sessionKey: String(chatId) });\n\n    if (Array.isArray(attachments)) {\n      const maxDataChars = maxBase64CharsForBinary(MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);\n      for (const a of attachments) {\n        if (!a || typeof a !== 'object') continue;\n        const data = (a as { data?: unknown }).data;\n        if (typeof data === 'string' && data.length > maxDataChars) {\n          return c.json(\n            {\n              ok: false,\n              error: {\n                code: 'BAD_REQUEST',\n                message: `Attachment exceeds maximum size (${MAX_WEBCHAT_ATTACHMENT_FILE_BYTES} bytes)`,\n              },\n            },\n            400,\n          );\n        }\n      }\n    }\n\n    const accept = c.req.header('Accept') || '';\n    const wantSSE = accept.includes('text/event-stream');\n\n    const clientAbort = new AbortController();\n    const raw = c.req.raw;\n    // Keep webchat runs alive across transient disconnects (page refresh / tab route switch)\n    // so the client can reattach via /api/agent/resume using runId from `run_start`.\n    // Explicit cancellation still goes through /api/agent/abort.\n    if (channel !== 'webchat') {\n      if (raw.signal.aborted) {\n        clientAbort.abort();\n      } else {\n        raw.signal.addEventListener('abort', () => clientAbort.abort(), { once: true });\n      }\n    }\n\n    // --- Non-streaming fallback: collect everything, return JSON ---\n    if (!wantSSE) {\n      const jsonSessionKey = channel === 'webchat' ? chatId : undefined;\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n      try {\n        let finalResult: { status: string; summary: string } | undefined;\n        const tokens: string[] = [];\n\n        while (true) {\n          const { done, value } = await generator.next();\n          if (done) {\n            finalResult = value as { status: string; summary: string };\n            break;\n          }\n          const chunk = value as { type: string; payload?: { delta?: unknown } };\n          if (chunk.type === 'assistant_delta' && typeof chunk.payload?.delta === 'string') {\n            tokens.push(chunk.payload.delta);\n          }\n        }\n\n        return c.json({\n          ok: true,\n          payload: {\n            ...finalResult,\n            content: tokens.join(''),\n            ...(jsonSessionKey !== undefined\n              ? { sessionKey: jsonSessionKey, key: jsonSessionKey }\n              : {}),\n          },\n        });\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        log.error(\n          { err: error, errorMessage: em, phase: 'gateway.agent_run', sessionKey: jsonSessionKey, channel },\n          `Agent run failed (JSON mode): ${em}`,\n        );\n        return c.json({\n          ok: false,\n          error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n        }, 500);\n      }\n    }\n\n    // --- SSE streaming ---\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      if (channel !== 'webchat') {\n        stream.onAbort(() => {\n          clientAbort.abort();\n        });\n      }\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n\n      let eventId = 0;\n\n      try {\n        while (true) {\n          const { done, value } = await generator.next();\n\n          if (done) break;\n\n          const chunk = value as { type: string; seq?: unknown };\n          await stream.writeSSE({\n            id: typeof chunk.seq === 'number' ? String(chunk.seq) : String(++eventId),\n            event: chunk.type || 'message',\n            data: stringifySSEData(chunk),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error }, 'Agent run failed (SSE mode)');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId: 'unknown',\n            sessionKey: chatId,\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/agent/resume — Re-attach to an in-progress agent run via SSE.\n *\n * Request body: { runId, sessionKey }\n * The relay replays all buffered events from the beginning and then live-tails\n * until the run completes.\n *\n * SSE events are identical to those from POST /api/agent.\n */\nexport function createAgentResumeHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n    if (!body || typeof body !== 'object') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { runId, sessionKey } = body as { runId?: string; sessionKey?: string };\n    if (typeof sessionKey === 'string' && sessionKey.trim()) {\n      updateAsyncLogContext({ sessionKey: sessionKey.trim() });\n    }\n    if (!runId || typeof runId !== 'string') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required field: runId' } }, 400);\n    }\n\n    if (!service.runRelay.hasRun(runId)) {\n      return c.json({ ok: false, error: { code: 'NOT_FOUND', message: 'Run not found or already expired' } }, 404);\n    }\n\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      let eventId = 0;\n      try {\n        for await (const event of service.runRelay.subscribe(runId)) {\n          await stream.writeSSE({\n            id: typeof event.seq === 'number' ? String(event.seq) : String(++eventId),\n            event: event.type || 'message',\n            data: stringifySSEData(event),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error, runId }, 'Resume stream failed');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId,\n            sessionKey: typeof sessionKey === 'string' ? sessionKey : '',\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/send — Send a message through a channel (non-streaming).\n */\nexport function createSendHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => ({}));\n    const channel = body.channel as string;\n    const chatId = body.chatId as string;\n    const content = body.content as string;\n\n    if (!channel || !chatId || !content) {\n      return c.json(\n        { ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required fields: channel, chatId, content' } },\n        400,\n      );\n    }\n\n    try {\n      const result = await service.sendMessage(channel, chatId, content);\n      return c.json({ ok: true, payload: result });\n    } catch (error) {\n      log.error({ err: error }, 'Send failed');\n      return c.json(\n        { ok: false, error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' } },\n        500,\n      );\n    }\n  };\n}\n\n/**\n * GET /api/events — Server-pushed event stream (SSE).\n *\n * The client opens this long-lived connection to receive:\n *   - channel status changes\n *   - config reload notifications\n *   - cron execution results\n *   - any other server-initiated events\n *\n * Supports Last-Event-ID for reconnection.\n * Enforces maximum connection limit to prevent DoS.\n */\nexport function createEventsSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n  const maxConnections = config.maxSseConnections ?? 100;\n\n  return async (c: Context) => {\n    // Check maximum connections limit\n    if (activeConnections.size >= maxConnections) {\n      log.warn({ current: activeConnections.size, max: maxConnections }, 'SSE connection limit reached');\n      return c.json({\n        ok: false,\n        error: { code: 'TOO_MANY_CONNECTIONS', message: 'Maximum SSE connections exceeded' }\n      }, 503);\n    }\n\n    const lastEventId = c.req.header('Last-Event-ID') || undefined;\n    const sessionId = c.req.header('X-Session-Id')\n      || c.req.query('sessionId')\n      || crypto.randomUUID();\n\n    updateAsyncLogContext({ sessionId: String(sessionId) });\n\n    const abortController = new AbortController();\n    activeConnections.set(sessionId, abortController);\n\n    return streamSSE(c, async (stream) => {\n      let aborted = false;\n\n      // Send a hello event so the client knows the stream is established\n      await stream.writeSSE({\n        id: '0',\n        event: 'connected',\n        data: JSON.stringify({ sessionId }),\n      });\n\n      // Subscribe to service events\n      const cleanup = service.subscribe(sessionId, async (event) => {\n        if (aborted) return;\n        try {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        } catch {\n          // Stream closed, will be cleaned up by onAbort\n        }\n      });\n\n      // Replay missed events on reconnect\n      if (lastEventId) {\n        const missed = service.getEventsSince(sessionId, lastEventId);\n        for (const event of missed) {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        }\n      }\n\n      // Keep alive with periodic comments (every 30s)\n      const keepAlive = setInterval(async () => {\n        if (aborted) { clearInterval(keepAlive); return; }\n        try {\n          await stream.writeSSE({ event: 'ping', data: '' });\n        } catch {\n          clearInterval(keepAlive);\n        }\n      }, 30_000);\n\n      // Block until aborted — streamSSE closes when the callback returns\n      await new Promise<void>((resolve) => {\n        stream.onAbort(() => {\n          aborted = true;\n          clearInterval(keepAlive);\n          cleanup();\n          activeConnections.delete(sessionId);\n          log.debug({ sessionId }, 'Event stream disconnected');\n          resolve();\n        });\n      });\n    });\n  };\n}\n"],"mappings":"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"}

package/dist/src/gateway/service/agent-runner.d.ts

@@ -10,9 +10,8 @@
  *   - `abortAgentRun(runId)` — POST /api/agent/abort + cleanup
  *   - `steerWebchatAgent(chatId, message)` — Agent.steer queue at tool boundary
  *   - `submitClarifyResponse(requestId, answer)` — UI answers a `clarify` call
- *   - `enqueueWebchatPersistentGoalKickoff(sessionKey, goalText)` — initial
- *     `/goal` kickoff posts the goal text as the next user turn
- *   - `drainScheduledWebchatContinuation(sk, msg)` — background continuation
+ *   - `runScheduledWebchatTurn(sk, userTurn)` — background webchat user turn
+ *   - `drainScheduledWebchatContinuation(sk, msg)` — background text continuation
  *     (extension scheduler + persistent-goal flow)
  *   - `clarifyForSession({ sessionKey, request })` — clarify-bridge dispatch
  *     used by `gatewayClarify.requestClarification` in AgentService
@@ -28,6 +27,7 @@ import type { ChannelManager } from '../../channels/manager.js';
 import type { SessionIndex } from '../../session/index.js';
 import { AgentRunRelay, type RelayEvent } from '../agent-run-relay.js';
 import { ClarifyBridge, type ClarifyBridgeRequest } from '../clarify-bridge.js';
+import type { UserTurnAttachment, UserTurnInput } from '../user-turn-input.js';
 export interface GatewayAgentRunnerOptions {
     bus: MessageBus;
     sessionIndex: SessionIndex;
@@ -53,13 +53,7 @@ export declare class GatewayAgentRunner {
     getClarifyBridge(): ClarifyBridge;
     /** Called from `GatewayService.stop()` so the bridge gets cleaned up. */
     disposeClarifyBridge(): void;
-    runAgent(message: string, channel: string, chatId: string, attachments?: Array<{
-        type: string;
-        mimeType?: string;
-        data?: string;
-        name?: string;
-        size?: number;
-    }>, thinking?: string, runOptions?: {
+    runAgent(message: string, channel: string, chatId: string, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
         signal?: AbortSignal;
         clientCreatedAtMs?: number;
     }): AsyncGenerator<{
@@ -83,9 +77,8 @@ export declare class GatewayAgentRunner {
     }>;
     /** Deliver a user's answer to a pending `clarify` tool call. */
     submitClarifyResponse(requestId: string, answer: string): boolean;
-    /** Hermes-style: after HTTP sets a goal, enqueue the goal text as the next user turn. */
-    enqueueWebchatPersistentGoalKickoff(sessionKey: string, goalText: string): void;
     /** Same execution path as scheduled continuation, but lets callers observe failures. */
+    runScheduledWebchatTurn(sessionKey: string, userTurn: UserTurnInput): Promise<void>;
     runScheduledWebchatContinuation(sessionKey: string, message: string): Promise<void>;
     /** Background drain for extension-initiated webchat turns (`scheduleWebchatContinuation`). */
     drainScheduledWebchatContinuation(sessionKey: string, message: string): Promise<void>;