@xopcai/xopc 0.0.141 → 0.0.143

package/dist/src/gateway/hono/routes/public-gateway.js

@@ -1,5 +1,10 @@
 import { PACKAGE_VERSION, init_package_version } from "../../../package-version.js";
+import { claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, releaseConnectorWebhookDelivery } from "../../../storage/sqlite/connector-repository.js";
+import "../../../storage/sqlite/index.js";
+import { composioLogoResponse } from "../../../connectors/composio-logo.js";
+import { appendComposioTriggerEvent, applyComposioConnectionLifecycleEvent, normalizeComposioTriggerPayload, verifyComposioWebhook } from "../../../connectors/composio-triggers.js";
 import { serveStaticFile } from "../lib/static-ui.js";
+import { createHash } from "node:crypto";
 //#region src/gateway/hono/routes/public-gateway.ts
 init_package_version();
 function registerPublicGatewayRoutes(app, service) {
@@ -18,6 +23,78 @@ function registerPublicGatewayRoutes(app, service) {
 			startupDurationMs: health.startupDurationMs
 		});
 	});
+	app.post("/api/connectors/composio/webhook", async (c) => {
+		const secret = process.env.COMPOSIO_WEBHOOK_SECRET?.trim();
+		if (!secret) return c.json({
+			ok: false,
+			error: "Composio webhook is not configured."
+		}, 503);
+		const webhookId = c.req.header("webhook-id")?.trim() ?? "";
+		const body = await c.req.text();
+		let payload;
+		try {
+			payload = verifyComposioWebhook({
+				body,
+				webhookId,
+				webhookTimestamp: c.req.header("webhook-timestamp")?.trim() ?? "",
+				signature: c.req.header("webhook-signature")?.trim() ?? "",
+				secret
+			});
+		} catch {
+			return c.json({
+				ok: false,
+				error: "Invalid Composio webhook."
+			}, 401);
+		}
+		try {
+			const claim = claimConnectorWebhookDelivery({
+				id: webhookId,
+				provider: "composio",
+				payloadHash: createHash("sha256").update(body).digest("hex")
+			});
+			if (claim !== "claimed") return c.json({
+				ok: true,
+				payload: {
+					eventId: webhookId,
+					duplicate: true,
+					status: claim
+				}
+			});
+			const archivedPayload = payload && typeof payload === "object" && !Array.isArray(payload) ? {
+				...payload,
+				id: webhookId
+			} : {
+				id: webhookId,
+				data: payload
+			};
+			const normalized = normalizeComposioTriggerPayload(archivedPayload, webhookId);
+			applyComposioConnectionLifecycleEvent(archivedPayload);
+			const event = await appendComposioTriggerEvent(service.currentConfig, archivedPayload);
+			const runs = await service.automationServiceInstance.triggerEvent({
+				type: `connector.${normalized.trigger ?? normalized.type}`,
+				source: normalized.toolkit ? `composio:${normalized.toolkit}` : "composio",
+				payload: {
+					...normalized.data,
+					connectorId: normalized.toolkit ? `composio-${normalized.toolkit}` : "composio",
+					webhookId
+				}
+			});
+			completeConnectorWebhookDelivery(webhookId);
+			return c.json({
+				ok: true,
+				payload: {
+					eventId: event.id,
+					automationRuns: runs.length
+				}
+			});
+		} catch (error) {
+			releaseConnectorWebhookDelivery(webhookId, error);
+			return c.json({
+				ok: false,
+				error: "Composio webhook processing failed."
+			}, 500);
+		}
+	});
 	app.get("/api", (c) => {
 		return c.json({
 			service: "xopc-gateway",
@@ -67,6 +144,22 @@ function registerPublicGatewayRoutes(app, service) {
 		if (response) return response;
 		return c.text("Not found", 404);
 	});
+	app.get("/connector-icons/composio/:toolkit", async (c) => {
+		try {
+			return await composioLogoResponse(c.req.param("toolkit"));
+		} catch {
+			return c.json({
+				ok: false,
+				error: "Connector logo is unavailable."
+			}, 404);
+		}
+	});
+	/** From `web/public/connector-icons/` (Vite copies to static root). Public: img requests send no Bearer token. */
+	app.get("/connector-icons/*", (c) => {
+		const response = serveStaticFile(`connector-icons/${c.req.path.replace("/connector-icons/", "")}`, c.req.raw);
+		if (response) return response;
+		return c.text("Not found", 404);
+	});
 	app.get("/favicon.ico", (c) => {
 		const response = serveStaticFile("favicon.ico", c.req.raw);
 		if (response) return response;

package/dist/src/gateway/hono/routes/public-gateway.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-gateway.js","names":[],"sources":["../../../../../src/gateway/hono/routes/public-gateway.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { PACKAGE_VERSION } from '../../../package-version.js';\nimport type { GatewayService } from '../../service.js';\nimport { serveStaticFile } from '../lib/static-ui.js';\n\nexport function registerPublicGatewayRoutes(app: Hono, service: GatewayService): void {\n  app.get('/health', (c) => {\n    return c.json(service.getHealth());\n  });\n\n  /** Public liveness probe (no auth) — minimal payload for CLI / load balancers. */\n  app.get('/api/health', (c) => {\n    const health = service.getHealth();\n    return c.json({\n      status: health.ready ? 'ok' : 'starting',\n      ready: health.ready,\n      httpListening: health.httpListening,\n      version: health.version,\n      uptime: health.uptime,\n      startupDurationMs: health.startupDurationMs,\n    });\n  });\n\n  app.get('/api', (c) => {\n    return c.json({\n      service: 'xopc-gateway',\n      version: PACKAGE_VERSION,\n      transport: 'streamable-http',\n      endpoints: [\n        'GET  /health',\n        'GET  /api/health',\n        'GET  /status',\n        'GET  /api/status',\n        'POST /api/agent           (SSE stream / JSON)',\n        'POST /api/agent/abort',\n        'POST /api/agent/steer',\n        'POST /api/send',\n        'GET  /api/events          (SSE stream)',\n        'GET  /api/channels/catalog',\n        'GET  /api/channels/status',\n        'POST /api/channels/:channelId/actions/:actionId',\n        'GET  /api/config',\n        'GET  /api/agents',\n        'POST /api/agents',\n        'PATCH /api/agents/:id',\n        'DELETE /api/agents/:id',\n        'GET/PUT/DELETE /api/agents/:id/avatar',\n        'GET/PUT /api/agents/:id/files/...',\n        'DELETE /api/providers/:providerId/key',\n        'PATCH /api/config',\n        'POST /api/config/reload',\n        'POST /api/heartbeat/trigger',\n        '...  /api/automations/*',\n        '...  /api/automation-runs/*',\n        'GET/PATCH /api/sessions/:key/agent-config',\n        '...  /api/sessions/*',\n        'GET  /api/host/fs/meta',\n        'GET  /api/host/fs/list',\n      ],\n    });\n  });\n\n  app.get('/assets/*', (c) => {\n    const path = c.req.path.replace('/assets/', '');\n    const response = serveStaticFile(`assets/${path}`, c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  /** From `web/public/channel-icons/` (Vite copies to static root). Public: img requests send no Bearer token. */\n  app.get('/channel-icons/*', (c) => {\n    const path = c.req.path.replace('/channel-icons/', '');\n    const response = serveStaticFile(`channel-icons/${path}`, c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/favicon.ico', (c) => {\n    const response = serveStaticFile('favicon.ico', c.req.raw);\n    if (response) return response;\n    const fallback = serveStaticFile('logo.svg', c.req.raw);\n    if (fallback) return fallback;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/logo.svg', (c) => {\n    const response = serveStaticFile('logo.svg', c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/logo-dark.svg', (c) => {\n    const response = serveStaticFile('logo-dark.svg', c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/', (c) => {\n    const response = serveStaticFile('index.html', c.req.raw);\n    if (response) return response;\n    return c.text('UI not found', 404);\n  });\n}\n"],"mappings":";;;sBAE8D;AAI9D,SAAgB,4BAA4B,KAAW,SAA+B;AACpF,KAAI,IAAI,YAAY,MAAM;AACxB,SAAO,EAAE,KAAK,QAAQ,WAAW,CAAC;GAClC;;AAGF,KAAI,IAAI,gBAAgB,MAAM;EAC5B,MAAM,SAAS,QAAQ,WAAW;AAClC,SAAO,EAAE,KAAK;GACZ,QAAQ,OAAO,QAAQ,OAAO;GAC9B,OAAO,OAAO;GACd,eAAe,OAAO;GACtB,SAAS,OAAO;GAChB,QAAQ,OAAO;GACf,mBAAmB,OAAO;GAC3B,CAAC;GACF;AAEF,KAAI,IAAI,SAAS,MAAM;AACrB,SAAO,EAAE,KAAK;GACZ,SAAS;GACT,SAAS;GACT,WAAW;GACX,WAAW;IACT;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACD;GACF,CAAC;GACF;AAEF,KAAI,IAAI,cAAc,MAAM;EAE1B,MAAM,WAAW,gBAAgB,UADpB,EAAE,IAAI,KAAK,QAAQ,YAAY,GACG,IAAI,EAAE,IAAI,IAAI;AAC7D,MAAI,SAAU,QAAO;AACrB,SAAO,EAAE,KAAK,aAAa,IAAI;GAC/B;;AAGF,KAAI,IAAI,qBAAqB,MAAM;EAEjC,MAAM,WAAW,gBAAgB,iBADpB,EAAE,IAAI,KAAK,QAAQ,mBAAmB,GACG,IAAI,EAAE,IAAI,IAAI;AACpE,MAAI,SAAU,QAAO;AACrB,SAAO,EAAE,KAAK,aAAa,IAAI;GAC/B;AAEF,KAAI,IAAI,iBAAiB,MAAM;EAC7B,MAAM,WAAW,gBAAgB,eAAe,EAAE,IAAI,IAAI;AAC1D,MAAI,SAAU,QAAO;EACrB,MAAM,WAAW,gBAAgB,YAAY,EAAE,IAAI,IAAI;AACvD,MAAI,SAAU,QAAO;AACrB,SAAO,EAAE,KAAK,aAAa,IAAI;GAC/B;AAEF,KAAI,IAAI,cAAc,MAAM;EAC1B,MAAM,WAAW,gBAAgB,YAAY,EAAE,IAAI,IAAI;AACvD,MAAI,SAAU,QAAO;AACrB,SAAO,EAAE,KAAK,aAAa,IAAI;GAC/B;AAEF,KAAI,IAAI,mBAAmB,MAAM;EAC/B,MAAM,WAAW,gBAAgB,iBAAiB,EAAE,IAAI,IAAI;AAC5D,MAAI,SAAU,QAAO;AACrB,SAAO,EAAE,KAAK,aAAa,IAAI;GAC/B;AAEF,KAAI,IAAI,MAAM,MAAM;EAClB,MAAM,WAAW,gBAAgB,cAAc,EAAE,IAAI,IAAI;AACzD,MAAI,SAAU,QAAO;AACrB,SAAO,EAAE,KAAK,gBAAgB,IAAI;GAClC"}
+{"version":3,"file":"public-gateway.js","names":[],"sources":["../../../../../src/gateway/hono/routes/public-gateway.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport type { Hono } from 'hono';\n\nimport { composioLogoResponse } from '../../../connectors/composio-logo.js';\nimport {\n  appendComposioTriggerEvent,\n  applyComposioConnectionLifecycleEvent,\n  normalizeComposioTriggerPayload,\n  verifyComposioWebhook,\n} from '../../../connectors/composio-triggers.js';\nimport { PACKAGE_VERSION } from '../../../package-version.js';\nimport {\n  claimConnectorWebhookDelivery,\n  completeConnectorWebhookDelivery,\n  releaseConnectorWebhookDelivery,\n} from '../../../storage/sqlite/index.js';\nimport type { GatewayService } from '../../service.js';\nimport { serveStaticFile } from '../lib/static-ui.js';\n\nexport function registerPublicGatewayRoutes(app: Hono, service: GatewayService): void {\n  app.get('/health', (c) => {\n    return c.json(service.getHealth());\n  });\n\n  /** Public liveness probe (no auth) — minimal payload for CLI / load balancers. */\n  app.get('/api/health', (c) => {\n    const health = service.getHealth();\n    return c.json({\n      status: health.ready ? 'ok' : 'starting',\n      ready: health.ready,\n      httpListening: health.httpListening,\n      version: health.version,\n      uptime: health.uptime,\n      startupDurationMs: health.startupDurationMs,\n    });\n  });\n\n  app.post('/api/connectors/composio/webhook', async (c) => {\n    const secret = process.env.COMPOSIO_WEBHOOK_SECRET?.trim();\n    if (!secret) return c.json({ ok: false, error: 'Composio webhook is not configured.' }, 503);\n    const webhookId = c.req.header('webhook-id')?.trim() ?? '';\n    const body = await c.req.text();\n    let payload: unknown;\n    try {\n      payload = verifyComposioWebhook({\n        body,\n        webhookId,\n        webhookTimestamp: c.req.header('webhook-timestamp')?.trim() ?? '',\n        signature: c.req.header('webhook-signature')?.trim() ?? '',\n        secret,\n      });\n    } catch {\n      return c.json({ ok: false, error: 'Invalid Composio webhook.' }, 401);\n    }\n    try {\n      const claim = claimConnectorWebhookDelivery({\n        id: webhookId,\n        provider: 'composio',\n        payloadHash: createHash('sha256').update(body).digest('hex'),\n      });\n      if (claim !== 'claimed') {\n        return c.json({ ok: true, payload: { eventId: webhookId, duplicate: true, status: claim } });\n      }\n      const archivedPayload = payload && typeof payload === 'object' && !Array.isArray(payload)\n        ? { ...payload as Record<string, unknown>, id: webhookId }\n        : { id: webhookId, data: payload };\n      const normalized = normalizeComposioTriggerPayload(archivedPayload, webhookId);\n      applyComposioConnectionLifecycleEvent(archivedPayload);\n      const event = await appendComposioTriggerEvent(service.currentConfig, archivedPayload);\n      const runs = await service.automationServiceInstance.triggerEvent({\n        type: `connector.${normalized.trigger ?? normalized.type}`,\n        source: normalized.toolkit ? `composio:${normalized.toolkit}` : 'composio',\n        payload: {\n          ...normalized.data,\n          connectorId: normalized.toolkit ? `composio-${normalized.toolkit}` : 'composio',\n          webhookId,\n        },\n      });\n      completeConnectorWebhookDelivery(webhookId);\n      return c.json({ ok: true, payload: { eventId: event.id, automationRuns: runs.length } });\n    } catch (error) {\n      releaseConnectorWebhookDelivery(webhookId, error);\n      return c.json({ ok: false, error: 'Composio webhook processing failed.' }, 500);\n    }\n  });\n\n  app.get('/api', (c) => {\n    return c.json({\n      service: 'xopc-gateway',\n      version: PACKAGE_VERSION,\n      transport: 'streamable-http',\n      endpoints: [\n        'GET  /health',\n        'GET  /api/health',\n        'GET  /status',\n        'GET  /api/status',\n        'POST /api/agent           (SSE stream / JSON)',\n        'POST /api/agent/abort',\n        'POST /api/agent/steer',\n        'POST /api/send',\n        'GET  /api/events          (SSE stream)',\n        'GET  /api/channels/catalog',\n        'GET  /api/channels/status',\n        'POST /api/channels/:channelId/actions/:actionId',\n        'GET  /api/config',\n        'GET  /api/agents',\n        'POST /api/agents',\n        'PATCH /api/agents/:id',\n        'DELETE /api/agents/:id',\n        'GET/PUT/DELETE /api/agents/:id/avatar',\n        'GET/PUT /api/agents/:id/files/...',\n        'DELETE /api/providers/:providerId/key',\n        'PATCH /api/config',\n        'POST /api/config/reload',\n        'POST /api/heartbeat/trigger',\n        '...  /api/automations/*',\n        '...  /api/automation-runs/*',\n        'GET/PATCH /api/sessions/:key/agent-config',\n        '...  /api/sessions/*',\n        'GET  /api/host/fs/meta',\n        'GET  /api/host/fs/list',\n      ],\n    });\n  });\n\n  app.get('/assets/*', (c) => {\n    const path = c.req.path.replace('/assets/', '');\n    const response = serveStaticFile(`assets/${path}`, c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  /** From `web/public/channel-icons/` (Vite copies to static root). Public: img requests send no Bearer token. */\n  app.get('/channel-icons/*', (c) => {\n    const path = c.req.path.replace('/channel-icons/', '');\n    const response = serveStaticFile(`channel-icons/${path}`, c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/connector-icons/composio/:toolkit', async (c) => {\n    try {\n      return await composioLogoResponse(c.req.param('toolkit'));\n    } catch {\n      return c.json({ ok: false, error: 'Connector logo is unavailable.' }, 404);\n    }\n  });\n\n  /** From `web/public/connector-icons/` (Vite copies to static root). Public: img requests send no Bearer token. */\n  app.get('/connector-icons/*', (c) => {\n    const path = c.req.path.replace('/connector-icons/', '');\n    const response = serveStaticFile(`connector-icons/${path}`, c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/favicon.ico', (c) => {\n    const response = serveStaticFile('favicon.ico', c.req.raw);\n    if (response) return response;\n    const fallback = serveStaticFile('logo.svg', c.req.raw);\n    if (fallback) return fallback;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/logo.svg', (c) => {\n    const response = serveStaticFile('logo.svg', c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/logo-dark.svg', (c) => {\n    const response = serveStaticFile('logo-dark.svg', c.req.raw);\n    if (response) return response;\n    return c.text('Not found', 404);\n  });\n\n  app.get('/', (c) => {\n    const response = serveStaticFile('index.html', c.req.raw);\n    if (response) return response;\n    return c.text('UI not found', 404);\n  });\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import { getDefaultModelSync, init_providers, resolveModel } from "../../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../../providers/model-call.js";
 import { resolveTtsProviderConfigSlice } from "../../../voice/tts/config-slice.js";
 import { isTTSAvailable } from "../../../voice/tts/factory.js";
 import { speak } from "../../../voice/tts/speak-core.js";
@@ -12,7 +13,6 @@ import { listSttProvidersForApi } from "../../../voice/stt/list-providers.js";
 import "../../../voice/tts/index.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
 import { listTtsProvidersForApi } from "../../../voice/tts/list-providers.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 //#region src/gateway/hono/routes/voice.ts
 init_providers();
 const log = createGatewayRouteLogger("Voice");
@@ -62,7 +62,7 @@ async function refineTranscript(raw, config, signal) {
 		};
 		const timeoutSignal = typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function" ? AbortSignal.timeout(REFINE_TIMEOUT_MS) : void 0;
 		const mergedSignal = signal && timeoutSignal && typeof AbortSignal.any === "function" ? AbortSignal.any([signal, timeoutSignal]) : signal ?? timeoutSignal;
-		const result = await complete(model, { messages: [userMsg] }, {
+		const result = await completeWithResolvedCredentials(model, { messages: [userMsg] }, {
 			maxTokens: Math.min(raw.length * 3, 4096),
 			temperature: .2,
 			signal: mergedSignal

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/compat';\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-5.6-luna', 'google/gemini-3.5-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":"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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 { type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport type { Config } from '../../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../../providers/model-call.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-5.6-luna', 'google/gemini-3.5-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 completeWithResolvedCredentials(\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":"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"}

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

@@ -1,13 +1,14 @@
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { createWorkflowCatalog } from "../../../agent/workflow/catalog.js";
 import { resolveProjectAgentId } from "../../../projects/project-agent.js";
 import "../../../projects/index.js";
-import { messagesToClientHistory } from "../../../session/client-history.js";
-import { buildWorkflowDefinition } from "../../../workflows/domain/definition-utils.js";
 import { validateWorkflowDefinitionInput } from "../../../workflows/domain/validation.js";
+import { WorkflowNameConflictError, WorkflowRevisionConflictError, createWorkflowCatalog } from "../../../agent/workflow/catalog.js";
+import { messagesToClientHistory } from "../../../session/client-history.js";
 import "../../../workflows/domain/index.js";
 import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.js";
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
+import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
+import "../../../workflows/authoring/index.js";
 import "../../../workflows/draft/index.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
@@ -20,7 +21,7 @@ function registerWorkflowRoutes(authenticated, deps) {
 		const catalog = createWorkflowCatalog();
 		const definitions = catalog.list().map((entry) => {
 			try {
-				return toWorkflowDefinition(catalog.load(entry.name));
+				return catalog.load(entry.name);
 			} catch {
 				return null;
 			}
@@ -31,7 +32,7 @@ function registerWorkflowRoutes(authenticated, deps) {
 		const id = c.req.param("id");
 		const catalog = createWorkflowCatalog();
 		try {
-			const definition = toWorkflowDefinition(catalog.load(id));
+			const definition = catalog.load(id);
 			return c.json({ definition });
 		} catch (err) {
 			return c.json({ error: err instanceof Error ? err.message : "Workflow definition not found" }, 404);
@@ -41,11 +42,11 @@ function registerWorkflowRoutes(authenticated, deps) {
 		const body = await readJsonBody(c.req.raw);
 		const result = validateWorkflowDefinitionInput({
 			name: body.name,
-			script: body.script
+			graph: body.graph
 		});
 		return c.json(result);
 	});
-	authenticated.post("/api/workflows/definitions/draft", async (c) => {
+	authenticated.post("/api/workflows/definitions/generate", async (c) => {
 		const body = await readJsonBody(c.req.raw);
 		const prompt = body.prompt?.trim();
 		if (!prompt) return c.json({ error: "prompt is required" }, 400);
@@ -57,7 +58,7 @@ function registerWorkflowRoutes(authenticated, deps) {
 				agentId,
 				language: body.language,
 				mode: body.mode,
-				existingScript: body.existingScript,
+				existingGraph: body.existingGraph,
 				constraints: body.constraints
 			}, c.req.raw.signal);
 			return c.json({ draft }, 201);
@@ -67,31 +68,146 @@ function registerWorkflowRoutes(authenticated, deps) {
 	});
 	authenticated.post("/api/workflows/definitions", async (c) => {
 		const body = await readJsonBody(c.req.raw);
+		if (!Number.isSafeInteger(body.expectedRevision) || body.expectedRevision < 0) return c.json({ error: "expectedRevision is required" }, 400);
 		const validation = validateWorkflowDefinitionInput({
 			name: body.name,
-			script: body.script
+			graph: body.graph
 		});
 		if (!validation.valid) return c.json({
 			error: validation.errors[0]?.message ?? "Invalid workflow definition",
 			validation
 		}, 400);
 		const name = body.name?.trim() ?? "";
-		const script = body.script ?? "";
 		const catalog = createWorkflowCatalog();
 		try {
-			catalog.save(name, script);
-			const definition = toWorkflowDefinition(catalog.load(name));
-			return c.json({ definition }, 201);
+			const { definition } = catalog.save({
+				name,
+				graph: body.graph,
+				manifest: body.manifest,
+				expectedRevision: body.expectedRevision,
+				intent: body.expectedRevision === 0 ? "create" : "update"
+			});
+			return c.json({ definition }, body.expectedRevision === 0 ? 201 : 200);
 		} catch (err) {
+			if (err instanceof WorkflowNameConflictError) return c.json({
+				error: `Workflow name "${err.workflowName}" is already in use.`,
+				code: "WORKFLOW_NAME_EXISTS",
+				name: err.workflowName,
+				currentRevision: err.currentRevision,
+				suggestedName: suggestAvailableWorkflowName(err.workflowName, catalog.list().map((entry) => entry.name))
+			}, 409);
+			if (err instanceof WorkflowRevisionConflictError) return c.json({
+				error: err.message,
+				code: "WORKFLOW_REVISION_CONFLICT",
+				currentRevision: err.currentRevision
+			}, 409);
 			return c.json({ error: err instanceof Error ? err.message : "Failed to save workflow" }, 400);
 		}
 	});
+	authenticated.put("/api/workflows/definitions/:id", async (c) => {
+		const id = c.req.param("id").trim();
+		const body = await readJsonBody(c.req.raw);
+		if (!Number.isSafeInteger(body.expectedRevision) || body.expectedRevision < 1) return c.json({ error: "expectedRevision is required" }, 400);
+		const validation = validateWorkflowDefinitionInput({
+			name: id,
+			graph: body.graph
+		});
+		if (!validation.valid) return c.json({
+			error: validation.errors[0]?.message ?? "Invalid workflow definition",
+			validation
+		}, 400);
+		const catalog = createWorkflowCatalog();
+		try {
+			const { definition } = catalog.save({
+				name: id,
+				graph: body.graph,
+				manifest: body.manifest,
+				expectedRevision: body.expectedRevision,
+				intent: "update"
+			});
+			return c.json({ definition });
+		} catch (err) {
+			if (err instanceof WorkflowRevisionConflictError) return c.json({
+				error: err.message,
+				code: "WORKFLOW_REVISION_CONFLICT",
+				currentRevision: err.currentRevision
+			}, 409);
+			return c.json({ error: err instanceof Error ? err.message : "Failed to save workflow" }, 400);
+		}
+	});
+	authenticated.get("/api/workflows/definitions/:id/revisions", (c) => {
+		const id = c.req.param("id");
+		try {
+			return c.json({ revisions: createWorkflowCatalog().listRevisions(id) });
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Failed to list workflow revisions" }, 400);
+		}
+	});
+	authenticated.get("/api/workflows/definitions/:id/revisions/:revision", (c) => {
+		const id = c.req.param("id");
+		const revision = Number.parseInt(c.req.param("revision"), 10);
+		try {
+			return c.json({ definition: createWorkflowCatalog().loadRevision(id, revision) });
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Workflow revision not found" }, 404);
+		}
+	});
+	authenticated.post("/api/workflows/definitions/:id/revisions/:revision/restore", async (c) => {
+		const id = c.req.param("id");
+		const revision = Number.parseInt(c.req.param("revision"), 10);
+		const body = await readJsonBody(c.req.raw);
+		if (!Number.isSafeInteger(body.expectedRevision)) return c.json({ error: "expectedRevision is required" }, 400);
+		try {
+			const { definition } = createWorkflowCatalog().restore(id, revision, body.expectedRevision);
+			return c.json({ definition }, 201);
+		} catch (err) {
+			if (err instanceof WorkflowRevisionConflictError) return c.json({
+				error: err.message,
+				currentRevision: err.currentRevision
+			}, 409);
+			return c.json({ error: err instanceof Error ? err.message : "Failed to restore workflow revision" }, 400);
+		}
+	});
+	authenticated.get("/api/workflows/drafts", (c) => {
+		const workflowName = c.req.query("workflowName")?.trim();
+		return c.json({ drafts: new WorkflowDraftStore().list(workflowName) });
+	});
+	authenticated.get("/api/workflows/drafts/:draftId", (c) => {
+		try {
+			const draft = new WorkflowDraftStore().get(c.req.param("draftId"));
+			return draft ? c.json({ draft }) : c.json({ error: "Workflow draft not found" }, 404);
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Failed to load workflow draft" }, 400);
+		}
+	});
+	authenticated.post("/api/workflows/drafts", async (c) => {
+		const body = await readJsonBody(c.req.raw);
+		try {
+			const draft = new WorkflowDraftStore().save(body);
+			return c.json({ draft }, body.id ? 200 : 201);
+		} catch (err) {
+			if (err instanceof WorkflowDraftConflictError) return c.json({
+				error: err.message,
+				currentUpdatedAtMs: err.currentUpdatedAtMs
+			}, 409);
+			return c.json({ error: err instanceof Error ? err.message : "Failed to save workflow draft" }, 400);
+		}
+	});
+	authenticated.delete("/api/workflows/drafts/:draftId", (c) => {
+		try {
+			return new WorkflowDraftStore().remove(c.req.param("draftId")) ? c.json({ removed: true }) : c.json({ error: "Workflow draft not found" }, 404);
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Failed to delete workflow draft" }, 400);
+		}
+	});
 	authenticated.delete("/api/workflows/definitions/:id", (c) => {
 		const id = c.req.param("id").trim();
 		if (!id) return c.json({ error: "id is required" }, 400);
 		const catalog = createWorkflowCatalog();
 		try {
 			if (!catalog.remove(id)) return c.json({ error: "User workflow not found or cannot delete built-in workflow" }, 404);
+			const drafts = new WorkflowDraftStore().list(id);
+			for (const draft of drafts) new WorkflowDraftStore().remove(draft.id);
 			return c.json({ removed: true });
 		} catch (err) {
 			return c.json({ error: err instanceof Error ? err.message : "Failed to delete workflow" }, 400);
@@ -332,15 +448,6 @@ function getAgentId(rawAgentId, config) {
 	if (trimmed) return trimmed;
 	return resolveDefaultAgentId(config);
 }
-function toWorkflowDefinition(loaded) {
-	return buildWorkflowDefinition({
-		name: loaded.name,
-		source: loaded.source,
-		script: loaded.script,
-		meta: loaded.meta,
-		manifest: loaded.manifest
-	});
-}
 function buildWorkflowStats(runs) {
 	const activeStatuses = new Set(["queued", "running"]);
 	const succeededStatuses = new Set(["succeeded"]);
@@ -387,6 +494,14 @@ function normalizePositiveInteger(value) {
 	if (typeof value !== "number" || !Number.isFinite(value) || value < 1) return;
 	return Math.floor(value);
 }
+function suggestAvailableWorkflowName(name, existingNames) {
+	const used = new Set(existingNames);
+	for (let suffix = 2; suffix < 1e3; suffix += 1) {
+		const candidate = `${name}_${suffix}`;
+		if (!used.has(candidate)) return candidate;
+	}
+	return `${name}_${Date.now()}`;
+}
 function findWorkflowArtifact(view, artifactId) {
 	return [...view.artifacts ?? [], ...extractResultArtifacts(view.run?.result)].find((artifact) => artifact.id === artifactId) ?? null;
 }