@xopcai/xopc 0.0.86 → 0.0.88

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

@@ -120,6 +120,7 @@ function registerUpdateRoutes(authenticated, deps) {
 				message: String(parsed.message ?? "Git checkout — use git pull instead.")
 			}, 400);
 			if (!result.ok) {
+				const installMessage = typeof parsed?.message === "string" ? parsed.message : typeof parsed?.stderrTail === "string" ? parsed.stderrTail : void 0;
 				log.warn({
 					channel,
 					exitCode: result.exitCode,
@@ -128,7 +129,7 @@ function registerUpdateRoutes(authenticated, deps) {
 				return c.json({
 					ok: false,
 					error: "update-failed",
-					message: result.stderr?.trim() || result.reason || `Update exited with code ${result.exitCode ?? "unknown"}`,
+					message: installMessage || result.stderr?.trim() || result.reason || `Update exited with code ${result.exitCode ?? "unknown"}`,
 					result: parsed
 				});
 			}
@@ -199,12 +200,13 @@ function registerUpdateRoutes(authenticated, deps) {
 					return;
 				}
 				if (!result.ok) {
+					const installMessage = typeof parsed?.message === "string" ? parsed.message : typeof parsed?.stderrTail === "string" ? parsed.stderrTail : void 0;
 					await stream.writeSSE({
 						event: "result",
 						data: JSON.stringify({
 							ok: false,
 							error: "update-failed",
-							message: result.stderr?.trim() || result.reason || `Update exited with code ${result.exitCode ?? "unknown"}`,
+							message: installMessage || result.stderr?.trim() || result.reason || `Update exited with code ${result.exitCode ?? "unknown"}`,
 							result: parsed,
 							exitCode: result.exitCode,
 							reason: result.reason

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

@@ -1 +1 @@
-{"version":3,"file":"update.js","names":[],"sources":["../../../../../src/gateway/hono/routes/update.ts"],"sourcesContent":["import type { Hono } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport { loadConfig } from '../../../config/index.js';\nimport { acquireUpdateLock } from '../../../infra/update-lock.js';\nimport { detectInstallKind, resolvePackageRoot } from '../../../infra/update-check.js';\nimport {\n  DEFAULT_PACKAGE_CHANNEL,\n  normalizeUpdateChannel,\n  type UpdateChannel,\n} from '../../../infra/update-channels.js';\nimport { runAutoUpdateCommand, runAutoUpdateCommandWithProgress } from '../../../infra/update-runner.js';\nimport { getUpdateAvailable, runGatewayUpdateCheck } from '../../../infra/update-startup.js';\nimport { PACKAGE_VERSION } from '../../../package-version.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createLogger('GatewayUpdate');\n\nfunction parseUpdateCliJson(stdout: string): Record<string, unknown> | null {\n  const t = stdout.trim();\n  if (!t) return null;\n  try {\n    const parsed = JSON.parse(t) as unknown;\n    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)\n      ? (parsed as Record<string, unknown>)\n      : null;\n  } catch {\n    const lines = t.split('\\n').filter(Boolean);\n    for (let i = lines.length - 1; i >= 0; i--) {\n      const line = lines[i]!.trim();\n      if (!line.startsWith('{')) continue;\n      try {\n        const parsed = JSON.parse(line) as unknown;\n        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n          return parsed as Record<string, unknown>;\n        }\n      } catch {\n        // try previous line\n      }\n    }\n  }\n  return null;\n}\n\ntype PreconditionOk = {\n  ok: true;\n  channel: UpdateChannel;\n  root: string | null;\n};\n\nfunction isPreconditionFail(\n  x: PreconditionOk | { ok: false; status: 400; body: Record<string, unknown> },\n): x is { ok: false; status: 400; body: Record<string, unknown> } {\n  return !x.ok;\n}\n\nasync function npmUpdatePreconditions(\n  service: AuthenticatedRouteDeps['service'],\n): Promise<PreconditionOk | { ok: false; status: 400; body: Record<string, unknown> }> {\n  const config = loadConfig(service.getHealth().configPath);\n  const channel = normalizeUpdateChannel(config.update?.channel) ?? DEFAULT_PACKAGE_CHANNEL;\n\n  const root = await resolvePackageRoot();\n  if (root) {\n    const kind = await detectInstallKind(root);\n    if (kind === 'git') {\n      return {\n        ok: false,\n        status: 400,\n        body: {\n          ok: false,\n          error: 'git-checkout',\n          message:\n            'Running from a git checkout. Use `git pull` in the repo, or install from npm to use one-click update.',\n        },\n      };\n    }\n  }\n\n  return { ok: true, channel, root };\n}\n\nexport function registerUpdateRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { strictRateLimitMiddleware, service } = deps;\n\n  /**\n   * GET /api/update/status\n   */\n  authenticated.get('/api/update/status', (c) => {\n    const update = getUpdateAvailable();\n    return c.json({\n      ok: true,\n      payload: {\n        currentVersion: PACKAGE_VERSION,\n        updateAvailable: update !== null,\n        latestVersion: update?.latestVersion ?? null,\n        channel: update?.channel ?? null,\n      },\n    });\n  });\n\n  /**\n   * POST /api/update/check\n   */\n  authenticated.post('/api/update/check', strictRateLimitMiddleware, async (c) => {\n    const config = loadConfig(service.getHealth().configPath);\n    await runGatewayUpdateCheck({\n      config,\n      force: true,\n      onUpdateAvailableChange: (update) => {\n        service.emit('update.available', update);\n      },\n    });\n    const result = getUpdateAvailable();\n    return c.json({\n      ok: true,\n      payload: {\n        currentVersion: PACKAGE_VERSION,\n        updateAvailable: result !== null,\n        latestVersion: result?.latestVersion ?? null,\n        channel: result?.channel ?? null,\n      },\n    });\n  });\n\n  /**\n   * POST /api/update/run — one-click npm install (OpenClaw-style). Rejects git checkouts.\n   */\n  authenticated.post('/api/update/run', strictRateLimitMiddleware, async (c) => {\n    const pre = await npmUpdatePreconditions(service);\n    if (isPreconditionFail(pre)) {\n      return c.json(pre.body, pre.status);\n    }\n\n    const lock = await acquireUpdateLock('gateway');\n    if (!lock) {\n      return c.json(\n        {\n          ok: false,\n          error: 'busy',\n          message: 'Another update is already in progress.',\n        },\n        409,\n      );\n    }\n\n    const { channel, root } = pre;\n    try {\n      log.info({ channel }, 'Gateway: starting one-click npm update');\n      const result = await runAutoUpdateCommand({ channel, root });\n      const parsed = parseUpdateCliJson(result.stdout ?? '');\n\n      if (result.ok && parsed?.status === 'skipped' && parsed?.reason === 'git-checkout') {\n        return c.json(\n          {\n            ok: false,\n            error: 'git-checkout',\n            message: String(parsed.message ?? 'Git checkout — use git pull instead.'),\n          },\n          400,\n        );\n      }\n\n      if (!result.ok) {\n        log.warn(\n          { channel, exitCode: result.exitCode, reason: result.reason },\n          'Gateway: one-click npm update failed',\n        );\n        return c.json({\n          ok: false,\n          error: 'update-failed',\n          message: result.stderr?.trim() || result.reason || `Update exited with code ${result.exitCode ?? 'unknown'}`,\n          result: parsed,\n        });\n      }\n\n      log.info({ channel }, 'Gateway: one-click npm update finished');\n      return c.json({ ok: true, result: parsed });\n    } catch (err) {\n      log.error({ err, channel }, 'Gateway: one-click npm update threw');\n      return c.json(\n        {\n          ok: false,\n          error: 'internal',\n          message: err instanceof Error ? err.message : String(err),\n        },\n        500,\n      );\n    } finally {\n      await lock.release();\n    }\n  });\n\n  /**\n   * POST /api/update/run/stream — SSE-streamed npm update with progress lines.\n   */\n  authenticated.post('/api/update/run/stream', strictRateLimitMiddleware, async (c) => {\n    const pre = await npmUpdatePreconditions(service);\n    if (isPreconditionFail(pre)) {\n      return c.json(pre.body, pre.status);\n    }\n\n    const { channel, root } = pre;\n\n    return streamSSE(c, async (stream) => {\n      const lock = await acquireUpdateLock('gateway');\n      if (!lock) {\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({\n            ok: false,\n            error: 'busy',\n            message: 'Another update is already in progress.',\n          }),\n        });\n        return;\n      }\n\n      try {\n        log.info({ channel }, 'Gateway: starting streamed one-click npm update');\n        const result = await runAutoUpdateCommandWithProgress({\n          channel,\n          root,\n          onProgress: async (line, source) => {\n            await stream.writeSSE({\n              event: 'progress',\n              data: JSON.stringify({ line, source }),\n            });\n          },\n        });\n\n        const parsed = parseUpdateCliJson(result.stdout ?? '');\n\n        if (result.ok && parsed?.status === 'skipped' && parsed?.reason === 'git-checkout') {\n          await stream.writeSSE({\n            event: 'result',\n            data: JSON.stringify({\n              ok: false,\n              error: 'git-checkout',\n              message: String(parsed.message ?? 'Git checkout — use git pull instead.'),\n            }),\n          });\n          return;\n        }\n\n        if (!result.ok) {\n          await stream.writeSSE({\n            event: 'result',\n            data: JSON.stringify({\n              ok: false,\n              error: 'update-failed',\n              message:\n                result.stderr?.trim() || result.reason || `Update exited with code ${result.exitCode ?? 'unknown'}`,\n              result: parsed,\n              exitCode: result.exitCode,\n              reason: result.reason,\n            }),\n          });\n          return;\n        }\n\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({ ok: true, result: parsed }),\n        });\n      } catch (err) {\n        log.error({ err, channel }, 'Gateway: streamed npm update threw');\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({\n            ok: false,\n            error: 'internal',\n            message: err instanceof Error ? err.message : String(err),\n          }),\n        });\n      } finally {\n        await lock.release();\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;sBAa8D;aACN;AAGxD,MAAM,MAAM,aAAa,gBAAgB;AAEzC,SAAS,mBAAmB,QAAgD;CAC1E,MAAM,IAAI,OAAO,MAAM;AACvB,KAAI,CAAC,EAAG,QAAO;AACf,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,EAAE;AAC5B,SAAO,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,GAChE,SACD;SACE;EACN,MAAM,QAAQ,EAAE,MAAM,KAAK,CAAC,OAAO,QAAQ;AAC3C,OAAK,IAAI,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK;GAC1C,MAAM,OAAO,MAAM,GAAI,MAAM;AAC7B,OAAI,CAAC,KAAK,WAAW,IAAI,CAAE;AAC3B,OAAI;IACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,QAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;WAEH;;;AAKZ,QAAO;;AAST,SAAS,mBACP,GACgE;AAChE,QAAO,CAAC,EAAE;;AAGZ,eAAe,uBACb,SACqF;CAErF,MAAM,UAAU,uBADD,WAAW,QAAQ,WAAW,CAAC,WACD,CAAC,QAAQ,QAAQ,IAAA;CAE9D,MAAM,OAAO,MAAM,oBAAoB;AACvC,KAAI;MAEE,MADe,kBAAkB,KAAK,KAC7B,MACX,QAAO;GACL,IAAI;GACJ,QAAQ;GACR,MAAM;IACJ,IAAI;IACJ,OAAO;IACP,SACE;IACH;GACF;;AAIL,QAAO;EAAE,IAAI;EAAM;EAAS;EAAM;;AAGpC,SAAgB,qBAAqB,eAAqB,MAAoC;CAC5F,MAAM,EAAE,2BAA2B,YAAY;;;;AAK/C,eAAc,IAAI,uBAAuB,MAAM;EAC7C,MAAM,SAAS,oBAAoB;AACnC,SAAO,EAAE,KAAK;GACZ,IAAI;GACJ,SAAS;IACP,gBAAgB;IAChB,iBAAiB,WAAW;IAC5B,eAAe,QAAQ,iBAAiB;IACxC,SAAS,QAAQ,WAAW;IAC7B;GACF,CAAC;GACF;;;;AAKF,eAAc,KAAK,qBAAqB,2BAA2B,OAAO,MAAM;AAE9E,QAAM,sBAAsB;GAC1B,QAFa,WAAW,QAAQ,WAAW,CAAC,WAEtC;GACN,OAAO;GACP,0BAA0B,WAAW;AACnC,YAAQ,KAAK,oBAAoB,OAAO;;GAE3C,CAAC;EACF,MAAM,SAAS,oBAAoB;AACnC,SAAO,EAAE,KAAK;GACZ,IAAI;GACJ,SAAS;IACP,gBAAgB;IAChB,iBAAiB,WAAW;IAC5B,eAAe,QAAQ,iBAAiB;IACxC,SAAS,QAAQ,WAAW;IAC7B;GACF,CAAC;GACF;;;;AAKF,eAAc,KAAK,mBAAmB,2BAA2B,OAAO,MAAM;EAC5E,MAAM,MAAM,MAAM,uBAAuB,QAAQ;AACjD,MAAI,mBAAmB,IAAI,CACzB,QAAO,EAAE,KAAK,IAAI,MAAM,IAAI,OAAO;EAGrC,MAAM,OAAO,MAAM,kBAAkB,UAAU;AAC/C,MAAI,CAAC,KACH,QAAO,EAAE,KACP;GACE,IAAI;GACJ,OAAO;GACP,SAAS;GACV,EACD,IACD;EAGH,MAAM,EAAE,SAAS,SAAS;AAC1B,MAAI;AACF,OAAI,KAAK,EAAE,SAAS,EAAE,yCAAyC;GAC/D,MAAM,SAAS,MAAM,qBAAqB;IAAE;IAAS;IAAM,CAAC;GAC5D,MAAM,SAAS,mBAAmB,OAAO,UAAU,GAAG;AAEtD,OAAI,OAAO,MAAM,QAAQ,WAAW,aAAa,QAAQ,WAAW,eAClE,QAAO,EAAE,KACP;IACE,IAAI;IACJ,OAAO;IACP,SAAS,OAAO,OAAO,WAAW,uCAAuC;IAC1E,EACD,IACD;AAGH,OAAI,CAAC,OAAO,IAAI;AACd,QAAI,KACF;KAAE;KAAS,UAAU,OAAO;KAAU,QAAQ,OAAO;KAAQ,EAC7D,uCACD;AACD,WAAO,EAAE,KAAK;KACZ,IAAI;KACJ,OAAO;KACP,SAAS,OAAO,QAAQ,MAAM,IAAI,OAAO,UAAU,2BAA2B,OAAO,YAAY;KACjG,QAAQ;KACT,CAAC;;AAGJ,OAAI,KAAK,EAAE,SAAS,EAAE,yCAAyC;AAC/D,UAAO,EAAE,KAAK;IAAE,IAAI;IAAM,QAAQ;IAAQ,CAAC;WACpC,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAS,EAAE,sCAAsC;AAClE,UAAO,EAAE,KACP;IACE,IAAI;IACJ,OAAO;IACP,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;IAC1D,EACD,IACD;YACO;AACR,SAAM,KAAK,SAAS;;GAEtB;;;;AAKF,eAAc,KAAK,0BAA0B,2BAA2B,OAAO,MAAM;EACnF,MAAM,MAAM,MAAM,uBAAuB,QAAQ;AACjD,MAAI,mBAAmB,IAAI,CACzB,QAAO,EAAE,KAAK,IAAI,MAAM,IAAI,OAAO;EAGrC,MAAM,EAAE,SAAS,SAAS;AAE1B,SAAO,UAAU,GAAG,OAAO,WAAW;GACpC,MAAM,OAAO,MAAM,kBAAkB,UAAU;AAC/C,OAAI,CAAC,MAAM;AACT,UAAM,OAAO,SAAS;KACpB,OAAO;KACP,MAAM,KAAK,UAAU;MACnB,IAAI;MACJ,OAAO;MACP,SAAS;MACV,CAAC;KACH,CAAC;AACF;;AAGF,OAAI;AACF,QAAI,KAAK,EAAE,SAAS,EAAE,kDAAkD;IACxE,MAAM,SAAS,MAAM,iCAAiC;KACpD;KACA;KACA,YAAY,OAAO,MAAM,WAAW;AAClC,YAAM,OAAO,SAAS;OACpB,OAAO;OACP,MAAM,KAAK,UAAU;QAAE;QAAM;QAAQ,CAAC;OACvC,CAAC;;KAEL,CAAC;IAEF,MAAM,SAAS,mBAAmB,OAAO,UAAU,GAAG;AAEtD,QAAI,OAAO,MAAM,QAAQ,WAAW,aAAa,QAAQ,WAAW,gBAAgB;AAClF,WAAM,OAAO,SAAS;MACpB,OAAO;MACP,MAAM,KAAK,UAAU;OACnB,IAAI;OACJ,OAAO;OACP,SAAS,OAAO,OAAO,WAAW,uCAAuC;OAC1E,CAAC;MACH,CAAC;AACF;;AAGF,QAAI,CAAC,OAAO,IAAI;AACd,WAAM,OAAO,SAAS;MACpB,OAAO;MACP,MAAM,KAAK,UAAU;OACnB,IAAI;OACJ,OAAO;OACP,SACE,OAAO,QAAQ,MAAM,IAAI,OAAO,UAAU,2BAA2B,OAAO,YAAY;OAC1F,QAAQ;OACR,UAAU,OAAO;OACjB,QAAQ,OAAO;OAChB,CAAC;MACH,CAAC;AACF;;AAGF,UAAM,OAAO,SAAS;KACpB,OAAO;KACP,MAAM,KAAK,UAAU;MAAE,IAAI;MAAM,QAAQ;MAAQ,CAAC;KACnD,CAAC;YACK,KAAK;AACZ,QAAI,MAAM;KAAE;KAAK;KAAS,EAAE,qCAAqC;AACjE,UAAM,OAAO,SAAS;KACpB,OAAO;KACP,MAAM,KAAK,UAAU;MACnB,IAAI;MACJ,OAAO;MACP,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;MAC1D,CAAC;KACH,CAAC;aACM;AACR,UAAM,KAAK,SAAS;;IAEtB;GACF"}
+{"version":3,"file":"update.js","names":[],"sources":["../../../../../src/gateway/hono/routes/update.ts"],"sourcesContent":["import type { Hono } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport { loadConfig } from '../../../config/index.js';\nimport { acquireUpdateLock } from '../../../infra/update-lock.js';\nimport { detectInstallKind, resolvePackageRoot } from '../../../infra/update-check.js';\nimport {\n  DEFAULT_PACKAGE_CHANNEL,\n  normalizeUpdateChannel,\n  type UpdateChannel,\n} from '../../../infra/update-channels.js';\nimport { runAutoUpdateCommand, runAutoUpdateCommandWithProgress } from '../../../infra/update-runner.js';\nimport { getUpdateAvailable, runGatewayUpdateCheck } from '../../../infra/update-startup.js';\nimport { PACKAGE_VERSION } from '../../../package-version.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createLogger('GatewayUpdate');\n\nfunction parseUpdateCliJson(stdout: string): Record<string, unknown> | null {\n  const t = stdout.trim();\n  if (!t) return null;\n  try {\n    const parsed = JSON.parse(t) as unknown;\n    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)\n      ? (parsed as Record<string, unknown>)\n      : null;\n  } catch {\n    const lines = t.split('\\n').filter(Boolean);\n    for (let i = lines.length - 1; i >= 0; i--) {\n      const line = lines[i]!.trim();\n      if (!line.startsWith('{')) continue;\n      try {\n        const parsed = JSON.parse(line) as unknown;\n        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n          return parsed as Record<string, unknown>;\n        }\n      } catch {\n        // try previous line\n      }\n    }\n  }\n  return null;\n}\n\ntype PreconditionOk = {\n  ok: true;\n  channel: UpdateChannel;\n  root: string | null;\n};\n\nfunction isPreconditionFail(\n  x: PreconditionOk | { ok: false; status: 400; body: Record<string, unknown> },\n): x is { ok: false; status: 400; body: Record<string, unknown> } {\n  return !x.ok;\n}\n\nasync function npmUpdatePreconditions(\n  service: AuthenticatedRouteDeps['service'],\n): Promise<PreconditionOk | { ok: false; status: 400; body: Record<string, unknown> }> {\n  const config = loadConfig(service.getHealth().configPath);\n  const channel = normalizeUpdateChannel(config.update?.channel) ?? DEFAULT_PACKAGE_CHANNEL;\n\n  const root = await resolvePackageRoot();\n  if (root) {\n    const kind = await detectInstallKind(root);\n    if (kind === 'git') {\n      return {\n        ok: false,\n        status: 400,\n        body: {\n          ok: false,\n          error: 'git-checkout',\n          message:\n            'Running from a git checkout. Use `git pull` in the repo, or install from npm to use one-click update.',\n        },\n      };\n    }\n  }\n\n  return { ok: true, channel, root };\n}\n\nexport function registerUpdateRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { strictRateLimitMiddleware, service } = deps;\n\n  /**\n   * GET /api/update/status\n   */\n  authenticated.get('/api/update/status', (c) => {\n    const update = getUpdateAvailable();\n    return c.json({\n      ok: true,\n      payload: {\n        currentVersion: PACKAGE_VERSION,\n        updateAvailable: update !== null,\n        latestVersion: update?.latestVersion ?? null,\n        channel: update?.channel ?? null,\n      },\n    });\n  });\n\n  /**\n   * POST /api/update/check\n   */\n  authenticated.post('/api/update/check', strictRateLimitMiddleware, async (c) => {\n    const config = loadConfig(service.getHealth().configPath);\n    await runGatewayUpdateCheck({\n      config,\n      force: true,\n      onUpdateAvailableChange: (update) => {\n        service.emit('update.available', update);\n      },\n    });\n    const result = getUpdateAvailable();\n    return c.json({\n      ok: true,\n      payload: {\n        currentVersion: PACKAGE_VERSION,\n        updateAvailable: result !== null,\n        latestVersion: result?.latestVersion ?? null,\n        channel: result?.channel ?? null,\n      },\n    });\n  });\n\n  /**\n   * POST /api/update/run — one-click npm install (OpenClaw-style). Rejects git checkouts.\n   */\n  authenticated.post('/api/update/run', strictRateLimitMiddleware, async (c) => {\n    const pre = await npmUpdatePreconditions(service);\n    if (isPreconditionFail(pre)) {\n      return c.json(pre.body, pre.status);\n    }\n\n    const lock = await acquireUpdateLock('gateway');\n    if (!lock) {\n      return c.json(\n        {\n          ok: false,\n          error: 'busy',\n          message: 'Another update is already in progress.',\n        },\n        409,\n      );\n    }\n\n    const { channel, root } = pre;\n    try {\n      log.info({ channel }, 'Gateway: starting one-click npm update');\n      const result = await runAutoUpdateCommand({ channel, root });\n      const parsed = parseUpdateCliJson(result.stdout ?? '');\n\n      if (result.ok && parsed?.status === 'skipped' && parsed?.reason === 'git-checkout') {\n        return c.json(\n          {\n            ok: false,\n            error: 'git-checkout',\n            message: String(parsed.message ?? 'Git checkout — use git pull instead.'),\n          },\n          400,\n        );\n      }\n\n        if (!result.ok) {\n          const installMessage =\n            typeof parsed?.message === 'string'\n              ? parsed.message\n              : typeof parsed?.stderrTail === 'string'\n                ? parsed.stderrTail\n                : undefined;\n          log.warn(\n            { channel, exitCode: result.exitCode, reason: result.reason },\n            'Gateway: one-click npm update failed',\n          );\n          return c.json({\n            ok: false,\n            error: 'update-failed',\n            message:\n              installMessage ||\n              result.stderr?.trim() ||\n              result.reason ||\n              `Update exited with code ${result.exitCode ?? 'unknown'}`,\n            result: parsed,\n          });\n        }\n\n      log.info({ channel }, 'Gateway: one-click npm update finished');\n      return c.json({ ok: true, result: parsed });\n    } catch (err) {\n      log.error({ err, channel }, 'Gateway: one-click npm update threw');\n      return c.json(\n        {\n          ok: false,\n          error: 'internal',\n          message: err instanceof Error ? err.message : String(err),\n        },\n        500,\n      );\n    } finally {\n      await lock.release();\n    }\n  });\n\n  /**\n   * POST /api/update/run/stream — SSE-streamed npm update with progress lines.\n   */\n  authenticated.post('/api/update/run/stream', strictRateLimitMiddleware, async (c) => {\n    const pre = await npmUpdatePreconditions(service);\n    if (isPreconditionFail(pre)) {\n      return c.json(pre.body, pre.status);\n    }\n\n    const { channel, root } = pre;\n\n    return streamSSE(c, async (stream) => {\n      const lock = await acquireUpdateLock('gateway');\n      if (!lock) {\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({\n            ok: false,\n            error: 'busy',\n            message: 'Another update is already in progress.',\n          }),\n        });\n        return;\n      }\n\n      try {\n        log.info({ channel }, 'Gateway: starting streamed one-click npm update');\n        const result = await runAutoUpdateCommandWithProgress({\n          channel,\n          root,\n          onProgress: async (line, source) => {\n            await stream.writeSSE({\n              event: 'progress',\n              data: JSON.stringify({ line, source }),\n            });\n          },\n        });\n\n        const parsed = parseUpdateCliJson(result.stdout ?? '');\n\n        if (result.ok && parsed?.status === 'skipped' && parsed?.reason === 'git-checkout') {\n          await stream.writeSSE({\n            event: 'result',\n            data: JSON.stringify({\n              ok: false,\n              error: 'git-checkout',\n              message: String(parsed.message ?? 'Git checkout — use git pull instead.'),\n            }),\n          });\n          return;\n        }\n\n        if (!result.ok) {\n          const installMessage =\n            typeof parsed?.message === 'string'\n              ? parsed.message\n              : typeof parsed?.stderrTail === 'string'\n                ? parsed.stderrTail\n                : undefined;\n          await stream.writeSSE({\n            event: 'result',\n            data: JSON.stringify({\n              ok: false,\n              error: 'update-failed',\n              message:\n                installMessage ||\n                result.stderr?.trim() ||\n                result.reason ||\n                `Update exited with code ${result.exitCode ?? 'unknown'}`,\n              result: parsed,\n              exitCode: result.exitCode,\n              reason: result.reason,\n            }),\n          });\n          return;\n        }\n\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({ ok: true, result: parsed }),\n        });\n      } catch (err) {\n        log.error({ err, channel }, 'Gateway: streamed npm update threw');\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({\n            ok: false,\n            error: 'internal',\n            message: err instanceof Error ? err.message : String(err),\n          }),\n        });\n      } finally {\n        await lock.release();\n      }\n    });\n  });\n}\n"],"mappings":"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"}

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

@@ -2,12 +2,16 @@ import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../../providers/index.js";
 import { resolveTtsProviderConfigSlice } from "../../../voice/tts/config-slice.js";
+import { isTTSAvailable } from "../../../voice/tts/factory.js";
+import { speak } from "../../../voice/tts/speak-core.js";
+import { mergeTtsConfigFromAppConfig } from "../../../voice/tts/merge-config.js";
 import { resolveSttProviderConfigSlice } from "../../../voice/stt/config-slice.js";
 import { transcribe } from "../../../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../../../voice/stt/availability.js";
 import "../../../voice/stt/index.js";
 import { mergeSttConfigFromAppConfig } from "../../../channels/attachments/voice-stt-webchat.js";
 import { listSttProvidersForApi } from "../../../voice/stt/list-providers.js";
+import "../../../voice/tts/index.js";
 import { listTtsProvidersForApi } from "../../../voice/tts/list-providers.js";
 import { complete } from "@earendil-works/pi-ai";
 //#region src/gateway/hono/routes/voice.ts
@@ -145,6 +149,77 @@ function registerVoiceRoutes(authenticated, deps) {
 		});
 	});
 	/**
+	* POST /api/voice/tts-test
+	*
+	* Body: { text: string, provider?: string, model?: string, voice?: string }
+	* Response: { ok: true, payload: { audio: string, format: string, provider: string } }
+	*/
+	authenticated.post("/api/voice/tts-test", strictRateLimitMiddleware, async (c) => {
+		let body = {};
+		try {
+			body = await c.req.json();
+		} catch {
+			return c.json({
+				ok: false,
+				error: { message: "Invalid JSON body" }
+			}, 400);
+		}
+		const text = typeof body.text === "string" ? body.text.trim() : "";
+		if (!text) return c.json({
+			ok: false,
+			error: { message: "text is required" }
+		}, 400);
+		if (text.length > 1e3) return c.json({
+			ok: false,
+			error: { message: "text exceeds 1000 characters" }
+		}, 400);
+		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 ttsConfig = {
+			...baseTtsConfig,
+			enabled: true,
+			provider,
+			fallback: {
+				enabled: false,
+				order: [provider]
+			}
+		};
+		if (!isTTSAvailable(ttsConfig)) return c.json({
+			ok: false,
+			error: { message: `TTS provider "${provider}" is not configured.` }
+		}, 503);
+		try {
+			const result = await speak(text, ttsConfig, {
+				appConfig: config,
+				parseDirectives: false,
+				tts: {
+					...typeof body.model === "string" && body.model.trim() ? { model: body.model.trim() } : {},
+					...typeof body.voice === "string" && body.voice.trim() ? { voice: body.voice.trim() } : {}
+				}
+			});
+			return c.json({
+				ok: true,
+				payload: {
+					audio: result.audio.toString("base64"),
+					format: result.format,
+					provider: result.provider,
+					...result.duration !== void 0 ? { duration: result.duration } : {}
+				}
+			});
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			log.error({
+				errorMessage: msg,
+				provider
+			}, "Voice TTS test failed");
+			return c.json({
+				ok: false,
+				error: { message: `TTS test failed: ${msg}` }
+			}, 502);
+		}
+	});
+	/**
 	* POST /api/voice/transcribe
 	*
 	* Body: { audio: string (base64), mimeType: string, language?: string }

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 { 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 { createLogger } from '../../../utils/logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createLogger('Gateway: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/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 { createLogger } from '../../../utils/logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createLogger('Gateway: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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"}

package/dist/src/gateway/hono/routes/workflows.d.ts

@@ -0,0 +1,3 @@
+import type { Hono } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerWorkflowRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void;

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

@@ -0,0 +1,347 @@
+import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
+import { extractProfileAgentId } from "../../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
+import { createWorkflowCatalog } from "../../../agent/workflow/catalog.js";
+import { DelegateSubagentRunner } from "../../../agent/workflow/subagent-runner.js";
+import { resolveModelRef } from "../../../config/agent-typed-models.js";
+import { AgentToolsFactory } from "../../../agent/tools/factory.js";
+import { isTerminalWorkflowRunStatus } from "../../../workflows/domain/run.js";
+import { WorkflowEngine } from "../../../workflows/engine/workflow-engine.js";
+import { WorkflowEventStore } from "../../../workflows/store/event-store.js";
+import { WorkflowRunStore } from "../../../workflows/store/run-store.js";
+import "../../../workflows/index.js";
+import { randomUUID } from "node:crypto";
+//#region src/gateway/hono/routes/workflows.ts
+init_agent_scope();
+init_providers();
+const DEFAULT_WORKFLOW_CONCURRENCY = 4;
+const DEFAULT_WORKFLOW_TIMEOUT_SEC = 1800;
+const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;
+const activeWorkflowRuns = /* @__PURE__ */ new Map();
+function registerWorkflowRoutes(authenticated, deps) {
+	const { service } = deps;
+	authenticated.get("/api/workflows/definitions", (c) => {
+		const catalog = createWorkflowCatalog();
+		const definitions = catalog.list().map((entry) => {
+			try {
+				return toWorkflowDefinition(catalog.load(entry.name));
+			} catch {
+				return null;
+			}
+		}).filter((definition) => Boolean(definition));
+		return c.json({ definitions });
+	});
+	authenticated.get("/api/workflows/definitions/:id", (c) => {
+		const id = c.req.param("id");
+		const catalog = createWorkflowCatalog();
+		try {
+			const definition = toWorkflowDefinition(catalog.load(id));
+			return c.json({ definition });
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Workflow definition not found" }, 404);
+		}
+	});
+	authenticated.post("/api/workflows/definitions", async (c) => {
+		const body = await readJsonBody(c.req.raw);
+		const name = body.name?.trim();
+		const script = body.script?.trim();
+		if (!name) return c.json({ error: "name is required" }, 400);
+		if (!script) return c.json({ error: "script is required" }, 400);
+		const catalog = createWorkflowCatalog();
+		try {
+			catalog.save(name, script);
+			const definition = toWorkflowDefinition(catalog.load(name));
+			return c.json({ definition }, 201);
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Failed to save workflow" }, 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);
+			return c.json({ removed: true });
+		} catch (err) {
+			return c.json({ error: err instanceof Error ? err.message : "Failed to delete workflow" }, 400);
+		}
+	});
+	authenticated.get("/api/workflows/stats", async (c) => {
+		const agentId = getAgentId(c.req.query("agentId"), service.currentConfig);
+		const runs = await createRunStore(service.currentConfig, agentId).listRunSummaries(500);
+		return c.json({ stats: buildWorkflowStats(runs) });
+	});
+	authenticated.post("/api/workflows/runs", async (c) => {
+		const body = await readJsonBody(c.req.raw);
+		const definitionId = body.definitionId?.trim();
+		if (!definitionId) return c.json({ error: "definitionId is required" }, 400);
+		const agentId = getAgentId(body.agentId ?? c.req.query("agentId"), service.currentConfig);
+		const runId = await queueWorkflowRun({
+			deps,
+			agentId,
+			sessionKey: body.sessionKey?.trim() || `workflow:${agentId}`,
+			definitionId,
+			input: body.input,
+			goal: body.goal,
+			source: body.source ?? { kind: "webui" },
+			concurrency: normalizePositiveInteger(body.concurrency),
+			maxSubagents: normalizePositiveInteger(body.maxSubagents),
+			tokenBudget: body.tokenBudget
+		});
+		if (!runId) return c.json({ error: "Workflow definition not found" }, 404);
+		return c.json({ runId }, 202);
+	});
+	authenticated.get("/api/workflows/runs", async (c) => {
+		const agentId = getAgentId(c.req.query("agentId"), service.currentConfig);
+		const rawLimit = c.req.query("limit");
+		const limit = rawLimit ? Number.parseInt(rawLimit, 10) : 50;
+		const runs = await createRunStore(service.currentConfig, agentId).listRunSummaries(Number.isFinite(limit) ? limit : 50);
+		return c.json({ runs });
+	});
+	authenticated.post("/api/workflows/runs/:runId/cancel", async (c) => {
+		const runId = c.req.param("runId");
+		const agentId = getAgentId(c.req.query("agentId"), service.currentConfig);
+		const runStore = createRunStore(service.currentConfig, agentId);
+		const controller = activeWorkflowRuns.get(runId);
+		if (controller) {
+			controller.abort();
+			activeWorkflowRuns.delete(runId);
+			return c.json({ cancelled: true });
+		}
+		const view = await runStore.readRunView(runId);
+		if (!view) return c.json({ error: "Workflow run not found" }, 404);
+		if (isTerminalWorkflowRunStatus(view.run.status)) return c.json({
+			cancelled: true,
+			alreadyFinished: true
+		});
+		await new WorkflowEventStore(service.currentConfig, agentId).append({
+			runId,
+			type: "run_cancelled",
+			payload: { reason: "Cancelled by user" }
+		});
+		const updated = await runStore.rebuildRunView(runId);
+		if (updated) service.emit("workflow.run.updated", {
+			runId,
+			view: updated
+		});
+		return c.json({ cancelled: true });
+	});
+	authenticated.get("/api/workflows/runs/:runId", async (c) => {
+		const agentId = getAgentId(c.req.query("agentId"), service.currentConfig);
+		const runId = c.req.param("runId");
+		const view = await createRunStore(service.currentConfig, agentId).readRunView(runId);
+		if (!view) return c.json({ error: "Workflow run not found" }, 404);
+		return c.json({ view });
+	});
+	authenticated.post("/api/workflows/runs/:runId/rebuild", async (c) => {
+		const agentId = getAgentId(c.req.query("agentId"), service.currentConfig);
+		const runId = c.req.param("runId");
+		const view = await createRunStore(service.currentConfig, agentId).rebuildRunView(runId);
+		if (!view) return c.json({ error: "Workflow run not found" }, 404);
+		service.emit("workflow.run.updated", {
+			runId,
+			view
+		});
+		return c.json({ view });
+	});
+	authenticated.post("/api/workflows/runs/:runId/retry", async (c) => {
+		const agentId = getAgentId(c.req.query("agentId"), service.currentConfig);
+		const runId = c.req.param("runId");
+		const existing = await createRunStore(service.currentConfig, agentId).readRunView(runId);
+		if (!existing) return c.json({ error: "Workflow run not found" }, 404);
+		const newRunId = await queueWorkflowRun({
+			deps,
+			agentId,
+			sessionKey: `workflow:${agentId}`,
+			definitionId: existing.run.definitionId,
+			input: existing.run.input,
+			goal: existing.run.goal,
+			source: { kind: "webui" }
+		});
+		if (!newRunId) return c.json({ error: "Workflow definition not found" }, 404);
+		return c.json({ runId: newRunId }, 202);
+	});
+}
+function createRunStore(config, agentId) {
+	return new WorkflowRunStore(config, agentId, new WorkflowEventStore(config, agentId));
+}
+function getAgentId(rawAgentId, config) {
+	const trimmed = rawAgentId?.trim();
+	if (trimmed) return trimmed;
+	return resolveDefaultAgentId(config);
+}
+function toWorkflowDefinition(loaded) {
+	const nowMs = Date.now();
+	const phases = loaded.meta.phases?.map((phase, index) => ({
+		id: normalizeId(phase.title) || `phase-${index + 1}`,
+		title: phase.title,
+		description: phase.detail
+	})) ?? [];
+	return {
+		id: loaded.name,
+		name: loaded.name,
+		title: toTitle(loaded.name),
+		description: loaded.meta.description,
+		version: "1.0.0",
+		phases,
+		runtime: {
+			kind: "script",
+			source: loaded.script
+		},
+		defaults: {
+			concurrency: DEFAULT_WORKFLOW_CONCURRENCY,
+			timeoutSec: DEFAULT_WORKFLOW_TIMEOUT_SEC,
+			maxSubagents: loaded.meta.estimatedAgents?.max ?? DEFAULT_WORKFLOW_MAX_SUBAGENTS
+		},
+		metadata: {
+			tags: loaded.meta.tags ?? [],
+			builtIn: loaded.source === "builtin",
+			source: loaded.source,
+			whenToUse: loaded.meta.whenToUse,
+			estimatedAgents: loaded.meta.estimatedAgents,
+			examplePrompts: loaded.meta.examplePrompts,
+			i18n: loaded.meta.i18n,
+			createdAtMs: nowMs,
+			updatedAtMs: nowMs
+		}
+	};
+}
+async function queueWorkflowRun(params) {
+	const { deps, agentId, sessionKey, definitionId } = params;
+	const { service } = deps;
+	const catalog = createWorkflowCatalog();
+	let definition;
+	try {
+		definition = toWorkflowDefinition(catalog.load(definitionId));
+	} catch {
+		return null;
+	}
+	const eventStore = new WorkflowEventStore(service.currentConfig, agentId);
+	const runStore = new WorkflowRunStore(service.currentConfig, agentId, eventStore);
+	const runId = randomUUID();
+	const abortController = new AbortController();
+	const engine = createWorkflowEngine({
+		deps,
+		eventStore,
+		runStore,
+		sessionKey
+	});
+	activeWorkflowRuns.set(runId, abortController);
+	engine.startRun(definition, {
+		runId,
+		input: params.input,
+		goal: params.goal,
+		source: params.source,
+		signal: abortController.signal,
+		concurrency: params.concurrency,
+		maxSubagents: params.maxSubagents,
+		tokenBudget: params.tokenBudget
+	}).catch((err) => {
+		service.emit("workflow.run.error", {
+			runId,
+			error: err instanceof Error ? err.message : String(err)
+		});
+	}).finally(() => {
+		activeWorkflowRuns.delete(runId);
+	});
+	return runId;
+}
+function buildWorkflowStats(runs) {
+	const activeStatuses = new Set(["queued", "running"]);
+	const succeededStatuses = new Set(["succeeded"]);
+	const failedStatuses = new Set([
+		"failed",
+		"timeout",
+		"cancelled"
+	]);
+	let durationTotal = 0;
+	let durationCount = 0;
+	const definitionCounts = /* @__PURE__ */ new Map();
+	for (const run of runs) {
+		definitionCounts.set(run.definitionId, (definitionCounts.get(run.definitionId) ?? 0) + 1);
+		if (run.metrics.durationMs != null && Number.isFinite(run.metrics.durationMs)) {
+			durationTotal += run.metrics.durationMs;
+			durationCount += 1;
+		}
+	}
+	const topDefinitions = [...definitionCounts.entries()].sort((left, right) => right[1] - left[1]).slice(0, 5).map(([definitionId, count]) => ({
+		definitionId,
+		count
+	}));
+	return {
+		totalRuns: runs.length,
+		activeRuns: runs.filter((run) => activeStatuses.has(run.status)).length,
+		succeededRuns: runs.filter((run) => succeededStatuses.has(run.status)).length,
+		failedRuns: runs.filter((run) => failedStatuses.has(run.status)).length,
+		averageDurationMs: durationCount > 0 ? Math.round(durationTotal / durationCount) : null,
+		topDefinitions
+	};
+}
+function createWorkflowEngine(params) {
+	const { service } = params.deps;
+	const runner = new DelegateSubagentRunner({
+		workspace: service.currentWorkspacePath,
+		bus: service.messageBusInstance,
+		getDefaultModel: () => resolveModel(service.agentService.getModelForSession(params.sessionKey)),
+		getConfig: () => service.currentConfig,
+		buildChildTools: (childOptions) => buildWorkflowChildTools(childOptions)
+	});
+	return new WorkflowEngine({
+		cwd: service.currentWorkspacePath,
+		eventStore: params.eventStore,
+		runStore: params.runStore,
+		runner,
+		resolveModelId: (modelId) => {
+			const agentId = extractProfileAgentId(params.sessionKey, service.currentConfig);
+			return resolveModel(resolveModelRef(service.currentConfig, agentId, modelId));
+		},
+		onEventAppended: (event) => {
+			service.emit("workflow.event.appended", {
+				runId: event.runId,
+				event
+			});
+		},
+		onRunViewUpdated: (view) => {
+			service.emit("workflow.run.updated", {
+				runId: view.run.id,
+				view
+			});
+		}
+	});
+}
+function buildWorkflowChildTools(childOptions) {
+	return new AgentToolsFactory({
+		workspace: childOptions.workspace,
+		bus: childOptions.bus,
+		getCurrentContext: () => null,
+		getConfig: childOptions.getConfig,
+		getPrimaryModel: () => childOptions.model,
+		toolExecutorConfig: childOptions.toolExecutorConfig
+	}).createAllTools({
+		workspace: childOptions.workspace,
+		getPrimaryModel: () => childOptions.model,
+		disabledTools: new Set(["extensions"])
+	});
+}
+async function readJsonBody(request) {
+	try {
+		return await request.json();
+	} catch {
+		return {};
+	}
+}
+function normalizePositiveInteger(value) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value < 1) return;
+	return Math.floor(value);
+}
+function normalizeId(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function toTitle(value) {
+	return value.split(/[_-]+/g).filter(Boolean).map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
+}
+//#endregion
+export { registerWorkflowRoutes };
+
+//# sourceMappingURL=workflows.js.map