@xopcai/xopc 0.0.88 → 0.0.90

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          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":";;;;;;;;;;;;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;AAGD,OAAI,CAAC,OAAO,IAAI;IACd,MAAM,iBACJ,OAAO,QAAQ,YAAY,WACvB,OAAO,UACP,OAAO,QAAQ,eAAe,WAC5B,OAAO,aACP,KAAA;AACR,QAAI,KACF;KAAE;KAAS,UAAU,OAAO;KAAU,QAAQ,OAAO;KAAQ,EAC7D,uCACD;AACD,WAAO,EAAE,KAAK;KACZ,IAAI;KACJ,OAAO;KACP,SACE,kBACA,OAAO,QAAQ,MAAM,IACrB,OAAO,UACP,2BAA2B,OAAO,YAAY;KAChD,QAAQ;KACT,CAAC;;AAGN,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;KACd,MAAM,iBACJ,OAAO,QAAQ,YAAY,WACvB,OAAO,UACP,OAAO,QAAQ,eAAe,WAC5B,OAAO,aACP,KAAA;AACR,WAAM,OAAO,SAAS;MACpB,OAAO;MACP,MAAM,KAAK,UAAU;OACnB,IAAI;OACJ,OAAO;OACP,SACE,kBACA,OAAO,QAAQ,MAAM,IACrB,OAAO,UACP,2BAA2B,OAAO,YAAY;OAChD,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 {\n  DEFAULT_PACKAGE_CHANNEL,\n  normalizeUpdateChannel,\n  type UpdateChannel,\n} from '../../../infra/update-channels.js';\nimport {\n  formatUpdateApiResult,\n  runGatewayUpdateWithPostSteps,\n  type UpdateRunResult,\n} 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 mapUpdateFailure(result: UpdateRunResult, channel: UpdateChannel) {\n  const apiResult = formatUpdateApiResult(result, channel);\n  const message =\n    typeof apiResult.message === 'string'\n      ? apiResult.message\n      : result.reason ?? 'Update failed';\n  return { apiResult, message };\n}\n\nexport function registerUpdateRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { strictRateLimitMiddleware, service } = deps;\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  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  authenticated.post('/api/update/run', strictRateLimitMiddleware, async (c) => {\n    const config = loadConfig(service.getHealth().configPath);\n    const channel = normalizeUpdateChannel(config.update?.channel) ?? DEFAULT_PACKAGE_CHANNEL;\n\n    const lock = await acquireUpdateLock('gateway');\n    if (!lock) {\n      return c.json(\n        { ok: false, error: 'busy', message: 'Another update is already in progress.' },\n        409,\n      );\n    }\n\n    try {\n      log.info({ channel }, 'Gateway: starting in-process update');\n      const result = await runGatewayUpdateWithPostSteps({\n        channel,\n        cwd: process.cwd(),\n        argv1: process.argv[1],\n        triggerInProcessRestart: () => service.triggerGatewayProcessRestart(),\n      });\n      const apiResult = formatUpdateApiResult(result, channel);\n      if (result.status === 'error') {\n        const { message } = mapUpdateFailure(result, channel);\n        log.warn({ channel, reason: result.reason }, 'Gateway: update failed');\n        return c.json({\n          ok: false,\n          error: 'update-failed',\n          message,\n          result: apiResult,\n        });\n      }\n      log.info({ channel, mode: result.mode }, 'Gateway: update finished');\n      return c.json({ ok: true, result: apiResult });\n    } catch (err) {\n      log.error({ err, channel }, 'Gateway: 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  authenticated.post('/api/update/run/stream', strictRateLimitMiddleware, async (c) => {\n    const config = loadConfig(service.getHealth().configPath);\n    const channel = normalizeUpdateChannel(config.update?.channel) ?? DEFAULT_PACKAGE_CHANNEL;\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 in-process update');\n        const result = await runGatewayUpdateWithPostSteps({\n          channel,\n          cwd: process.cwd(),\n          argv1: process.argv[1],\n          triggerInProcessRestart: () => service.triggerGatewayProcessRestart(),\n          progress: {\n            onStepStart: async (step) => {\n              await stream.writeSSE({\n                event: 'progress',\n                data: JSON.stringify({\n                  line: `[${step.index + 1}/${step.total}] ${step.name}: ${step.command}`,\n                  source: 'stdout',\n                }),\n              });\n            },\n            onStepComplete: async (step) => {\n              if (step.stderrTail) {\n                await stream.writeSSE({\n                  event: 'progress',\n                  data: JSON.stringify({ line: step.stderrTail, source: 'stderr' }),\n                });\n              }\n            },\n          },\n        });\n\n        const apiResult = formatUpdateApiResult(result, channel);\n        if (result.status === 'error') {\n          const { message } = mapUpdateFailure(result, channel);\n          await stream.writeSSE({\n            event: 'result',\n            data: JSON.stringify({\n              ok: false,\n              error: 'update-failed',\n              message,\n              result: apiResult,\n              reason: result.reason,\n            }),\n          });\n          return;\n        }\n\n        await stream.writeSSE({\n          event: 'result',\n          data: JSON.stringify({ ok: true, result: apiResult }),\n        });\n      } catch (err) {\n        log.error({ err, channel }, 'Gateway: streamed 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/workflows.js

@@ -1,25 +1,13 @@
 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";
+import { buildWorkflowDefinition } from "../../../workflows/domain/definition-utils.js";
+import { validateWorkflowDefinitionInput } from "../../../workflows/domain/validation.js";
+import "../../../workflows/domain/index.js";
 //#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;
+	const workflowRunService = service.createWorkflowRunService();
 	authenticated.get("/api/workflows/definitions", (c) => {
 		const catalog = createWorkflowCatalog();
 		const definitions = catalog.list().map((entry) => {
@@ -41,12 +29,26 @@ function registerWorkflowRoutes(authenticated, deps) {
 			return c.json({ error: err instanceof Error ? err.message : "Workflow definition not found" }, 404);
 		}
 	});
+	authenticated.post("/api/workflows/definitions/validate", async (c) => {
+		const body = await readJsonBody(c.req.raw);
+		const result = validateWorkflowDefinitionInput({
+			name: body.name,
+			script: body.script
+		});
+		return c.json(result);
+	});
 	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 validation = validateWorkflowDefinitionInput({
+			name: body.name,
+			script: body.script
+		});
+		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);
@@ -69,75 +71,74 @@ function registerWorkflowRoutes(authenticated, deps) {
 	});
 	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) });
+		const definitionId = c.req.query("definitionId")?.trim();
+		const runs = await workflowRunService.createRunStore(agentId).listRunSummaries(500);
+		const filteredRuns = definitionId ? runs.filter((run) => run.definitionId === definitionId) : runs;
+		return c.json({ stats: buildWorkflowStats(filteredRuns) });
 	});
 	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,
+		const parentSessionKey = body.parentSessionKey?.trim() || void 0;
+		const result = await workflowRunService.startWorkflowRun({
 			agentId,
-			sessionKey: body.sessionKey?.trim() || `workflow:${agentId}`,
 			definitionId,
 			input: body.input,
+			inputEnvelope: body.inputEnvelope,
 			goal: body.goal,
-			source: body.source ?? { kind: "webui" },
+			parentSessionKey,
+			source: normalizeWorkflowRunSource(body.source),
 			concurrency: normalizePositiveInteger(body.concurrency),
 			maxSubagents: normalizePositiveInteger(body.maxSubagents),
-			tokenBudget: body.tokenBudget
+			tokenBudget: body.tokenBudget,
+			idempotencyKey: body.idempotencyKey
 		});
-		if (!runId) return c.json({ error: "Workflow definition not found" }, 404);
-		return c.json({ runId }, 202);
+		if (result.ok === false) return c.json({
+			error: result.message,
+			code: result.code
+		}, result.httpStatus);
+		return c.json({
+			runId: result.runId,
+			sessionKey: result.sessionKey
+		}, 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);
+		const runs = await workflowRunService.createRunStore(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({
+		const result = await workflowRunService.cancelWorkflowRun({
+			agentId,
 			runId,
-			type: "run_cancelled",
-			payload: { reason: "Cancelled by user" }
+			reason: "Cancelled by user"
 		});
-		const updated = await runStore.rebuildRunView(runId);
-		if (updated) service.emit("workflow.run.updated", {
-			runId,
-			view: updated
+		if (result.ok === false) return c.json({
+			error: result.message,
+			code: result.code
+		}, result.httpStatus);
+		return c.json({
+			cancelled: result.cancelled,
+			alreadyFinished: result.alreadyFinished
 		});
-		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);
+		const view = await workflowRunService.createRunStore(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);
+		const view = await workflowRunService.createRunStore(agentId).rebuildRunView(runId);
 		if (!view) return c.json({ error: "Workflow run not found" }, 404);
 		service.emit("workflow.run.updated", {
 			runId,
@@ -148,104 +149,32 @@ function registerWorkflowRoutes(authenticated, deps) {
 	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,
+		const result = await workflowRunService.retryWorkflowRun({
 			agentId,
-			sessionKey: `workflow:${agentId}`,
-			definitionId: existing.run.definitionId,
-			input: existing.run.input,
-			goal: existing.run.goal,
-			source: { kind: "webui" }
+			runId
 		});
-		if (!newRunId) return c.json({ error: "Workflow definition not found" }, 404);
-		return c.json({ runId: newRunId }, 202);
+		if (result.ok === false) return c.json({
+			error: result.message,
+			code: result.code
+		}, result.httpStatus);
+		return c.json({
+			runId: result.runId,
+			sessionKey: result.sessionKey
+		}, 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,
+	return buildWorkflowDefinition({
 		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);
+		source: loaded.source,
+		script: loaded.script,
+		meta: loaded.meta
 	});
-	return runId;
 }
 function buildWorkflowStats(runs) {
 	const activeStatuses = new Set(["queued", "running"]);
@@ -278,52 +207,6 @@ function buildWorkflowStats(runs) {
 		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();
@@ -331,16 +214,14 @@ async function readJsonBody(request) {
 		return {};
 	}
 }
+function normalizeWorkflowRunSource(source) {
+	if (!source) return { kind: "webui" };
+	return source;
+}
 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 };
 

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

@@ -1 +1 @@
-{"version":3,"file":"workflows.js","names":["resolveModelById"],"sources":["../../../../../src/gateway/hono/routes/workflows.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { Hono } from 'hono';\n\nimport { resolveDefaultAgentId } from '../../../agent/agent-scope.js';\nimport type { BuildChildToolsOptions } from '../../../agent/child-agent-factory.js';\nimport { AgentToolsFactory } from '../../../agent/tools/factory.js';\nimport { createWorkflowCatalog } from '../../../agent/workflow/catalog.js';\nimport { DelegateSubagentRunner } from '../../../agent/workflow/subagent-runner.js';\nimport type { WorkflowDefinition, WorkflowRunSource, WorkflowRunSummary } from '../../../workflows/domain/index.js';\nimport { isTerminalWorkflowRunStatus } from '../../../workflows/domain/run.js';\nimport { WorkflowEngine, WorkflowEventStore, WorkflowRunStore } from '../../../workflows/index.js';\nimport { extractProfileAgentId } from '../../../config/agent-profile.js';\nimport { resolveModelRef } from '../../../config/agent-typed-models.js';\nimport { resolveModel as resolveModelById } from '../../../providers/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst DEFAULT_WORKFLOW_CONCURRENCY = 4;\nconst DEFAULT_WORKFLOW_TIMEOUT_SEC = 30 * 60;\nconst DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;\n\nconst activeWorkflowRuns = new Map<string, AbortController>();\n\ninterface StartWorkflowRunRequestBody {\n  definitionId?: string;\n  input?: unknown;\n  goal?: string;\n  agentId?: string;\n  sessionKey?: string;\n  source?: WorkflowRunSource;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n}\n\ninterface SaveWorkflowDefinitionRequestBody {\n  name?: string;\n  script?: string;\n}\n\nexport function registerWorkflowRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { service } = deps;\n\n  authenticated.get('/api/workflows/definitions', (c) => {\n    const catalog = createWorkflowCatalog();\n    const definitions = catalog.list().map((entry) => {\n      try {\n        return toWorkflowDefinition(catalog.load(entry.name));\n      } catch {\n        return null;\n      }\n    }).filter((definition): definition is WorkflowDefinition => Boolean(definition));\n\n    return c.json({ definitions });\n  });\n\n  authenticated.get('/api/workflows/definitions/:id', (c) => {\n    const id = c.req.param('id');\n    const catalog = createWorkflowCatalog();\n    try {\n      const definition = toWorkflowDefinition(catalog.load(id));\n      return c.json({ definition });\n    } catch (err) {\n      return c.json({ error: err instanceof Error ? err.message : 'Workflow definition not found' }, 404);\n    }\n  });\n\n  authenticated.post('/api/workflows/definitions', async (c) => {\n    const body = await readJsonBody<SaveWorkflowDefinitionRequestBody>(c.req.raw);\n    const name = body.name?.trim();\n    const script = body.script?.trim();\n    if (!name) {\n      return c.json({ error: 'name is required' }, 400);\n    }\n    if (!script) {\n      return c.json({ error: 'script is required' }, 400);\n    }\n\n    const catalog = createWorkflowCatalog();\n    try {\n      catalog.save(name, script);\n      const definition = toWorkflowDefinition(catalog.load(name));\n      return c.json({ definition }, 201);\n    } catch (err) {\n      return c.json({ error: err instanceof Error ? err.message : 'Failed to save workflow' }, 400);\n    }\n  });\n\n  authenticated.delete('/api/workflows/definitions/:id', (c) => {\n    const id = c.req.param('id').trim();\n    if (!id) {\n      return c.json({ error: 'id is required' }, 400);\n    }\n\n    const catalog = createWorkflowCatalog();\n    try {\n      const removed = catalog.remove(id);\n      if (!removed) {\n        return c.json({ error: 'User workflow not found or cannot delete built-in workflow' }, 404);\n      }\n      return c.json({ removed: true });\n    } catch (err) {\n      return c.json({ error: err instanceof Error ? err.message : 'Failed to delete workflow' }, 400);\n    }\n  });\n\n  authenticated.get('/api/workflows/stats', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runStore = createRunStore(service.currentConfig, agentId);\n    const runs = await runStore.listRunSummaries(500);\n    return c.json({ stats: buildWorkflowStats(runs) });\n  });\n\n  authenticated.post('/api/workflows/runs', async (c) => {\n    const body = await readJsonBody<StartWorkflowRunRequestBody>(c.req.raw);\n    const definitionId = body.definitionId?.trim();\n    if (!definitionId) {\n      return c.json({ error: 'definitionId is required' }, 400);\n    }\n\n    const agentId = getAgentId(body.agentId ?? c.req.query('agentId'), service.currentConfig);\n    const sessionKey = body.sessionKey?.trim() || `workflow:${agentId}`;\n    const runId = await queueWorkflowRun({\n      deps,\n      agentId,\n      sessionKey,\n      definitionId,\n      input: body.input,\n      goal: body.goal,\n      source: body.source ?? { kind: 'webui' },\n      concurrency: normalizePositiveInteger(body.concurrency),\n      maxSubagents: normalizePositiveInteger(body.maxSubagents),\n      tokenBudget: body.tokenBudget,\n    });\n\n    if (!runId) {\n      return c.json({ error: 'Workflow definition not found' }, 404);\n    }\n\n    return c.json({ runId }, 202);\n  });\n\n  authenticated.get('/api/workflows/runs', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const rawLimit = c.req.query('limit');\n    const limit = rawLimit ? Number.parseInt(rawLimit, 10) : 50;\n    const runStore = createRunStore(service.currentConfig, agentId);\n    const runs = await runStore.listRunSummaries(Number.isFinite(limit) ? limit : 50);\n    return c.json({ runs });\n  });\n\n  authenticated.post('/api/workflows/runs/:runId/cancel', async (c) => {\n    const runId = c.req.param('runId');\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runStore = createRunStore(service.currentConfig, agentId);\n\n    const controller = activeWorkflowRuns.get(runId);\n    if (controller) {\n      controller.abort();\n      activeWorkflowRuns.delete(runId);\n      return c.json({ cancelled: true });\n    }\n\n    const view = await runStore.readRunView(runId);\n    if (!view) {\n      return c.json({ error: 'Workflow run not found' }, 404);\n    }\n\n    if (isTerminalWorkflowRunStatus(view.run.status)) {\n      return c.json({ cancelled: true, alreadyFinished: true });\n    }\n\n    const eventStore = new WorkflowEventStore(service.currentConfig, agentId);\n    await eventStore.append({\n      runId,\n      type: 'run_cancelled',\n      payload: { reason: 'Cancelled by user' },\n    });\n    const updated = await runStore.rebuildRunView(runId);\n    if (updated) {\n      service.emit('workflow.run.updated', { runId, view: updated });\n    }\n    return c.json({ cancelled: true });\n  });\n\n  authenticated.get('/api/workflows/runs/:runId', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runId = c.req.param('runId');\n    const runStore = createRunStore(service.currentConfig, agentId);\n    const view = await runStore.readRunView(runId);\n    if (!view) {\n      return c.json({ error: 'Workflow run not found' }, 404);\n    }\n    return c.json({ view });\n  });\n\n  authenticated.post('/api/workflows/runs/:runId/rebuild', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runId = c.req.param('runId');\n    const runStore = createRunStore(service.currentConfig, agentId);\n    const view = await runStore.rebuildRunView(runId);\n    if (!view) {\n      return c.json({ error: 'Workflow run not found' }, 404);\n    }\n    service.emit('workflow.run.updated', { runId, view });\n    return c.json({ view });\n  });\n\n  authenticated.post('/api/workflows/runs/:runId/retry', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runId = c.req.param('runId');\n    const runStore = createRunStore(service.currentConfig, agentId);\n    const existing = await runStore.readRunView(runId);\n    if (!existing) {\n      return c.json({ error: 'Workflow run not found' }, 404);\n    }\n\n    const sessionKey = `workflow:${agentId}`;\n    const newRunId = await queueWorkflowRun({\n      deps,\n      agentId,\n      sessionKey,\n      definitionId: existing.run.definitionId,\n      input: existing.run.input,\n      goal: existing.run.goal,\n      source: { kind: 'webui' },\n    });\n\n    if (!newRunId) {\n      return c.json({ error: 'Workflow definition not found' }, 404);\n    }\n\n    return c.json({ runId: newRunId }, 202);\n  });\n}\n\nfunction createRunStore(config: AuthenticatedRouteDeps['service']['currentConfig'], agentId: string): WorkflowRunStore {\n  const eventStore = new WorkflowEventStore(config, agentId);\n  return new WorkflowRunStore(config, agentId, eventStore);\n}\n\nfunction getAgentId(rawAgentId: string | undefined, config: AuthenticatedRouteDeps['service']['currentConfig']): string {\n  const trimmed = rawAgentId?.trim();\n  if (trimmed) {\n    return trimmed;\n  }\n  return resolveDefaultAgentId(config);\n}\n\nfunction toWorkflowDefinition(loaded: ReturnType<ReturnType<typeof createWorkflowCatalog>['load']>): WorkflowDefinition {\n  const nowMs = Date.now();\n  const phases = loaded.meta.phases?.map((phase, index) => ({\n    id: normalizeId(phase.title) || `phase-${index + 1}`,\n    title: phase.title,\n    description: phase.detail,\n  })) ?? [];\n\n  return {\n    id: loaded.name,\n    name: loaded.name,\n    title: toTitle(loaded.name),\n    description: loaded.meta.description,\n    version: '1.0.0',\n    phases,\n    runtime: {\n      kind: 'script',\n      source: loaded.script,\n    },\n    defaults: {\n      concurrency: DEFAULT_WORKFLOW_CONCURRENCY,\n      timeoutSec: DEFAULT_WORKFLOW_TIMEOUT_SEC,\n      maxSubagents: loaded.meta.estimatedAgents?.max ?? DEFAULT_WORKFLOW_MAX_SUBAGENTS,\n    },\n    metadata: {\n      tags: loaded.meta.tags ?? [],\n      builtIn: loaded.source === 'builtin',\n      source: loaded.source,\n      whenToUse: loaded.meta.whenToUse,\n      estimatedAgents: loaded.meta.estimatedAgents,\n      examplePrompts: loaded.meta.examplePrompts,\n      i18n: loaded.meta.i18n,\n      createdAtMs: nowMs,\n      updatedAtMs: nowMs,\n    },\n  };\n}\n\ninterface QueueWorkflowRunParams {\n  deps: AuthenticatedRouteDeps;\n  agentId: string;\n  sessionKey: string;\n  definitionId: string;\n  input?: unknown;\n  goal?: string;\n  source: WorkflowRunSource;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n}\n\nasync function queueWorkflowRun(params: QueueWorkflowRunParams): Promise<string | null> {\n  const { deps, agentId, sessionKey, definitionId } = params;\n  const { service } = deps;\n  const catalog = createWorkflowCatalog();\n  let definition: WorkflowDefinition;\n  try {\n    definition = toWorkflowDefinition(catalog.load(definitionId));\n  } catch {\n    return null;\n  }\n\n  const eventStore = new WorkflowEventStore(service.currentConfig, agentId);\n  const runStore = new WorkflowRunStore(service.currentConfig, agentId, eventStore);\n  const runId = randomUUID();\n  const abortController = new AbortController();\n  const engine = createWorkflowEngine({\n    deps,\n    eventStore,\n    runStore,\n    sessionKey,\n  });\n\n  activeWorkflowRuns.set(runId, abortController);\n  void engine.startRun(definition, {\n    runId,\n    input: params.input,\n    goal: params.goal,\n    source: params.source,\n    signal: abortController.signal,\n    concurrency: params.concurrency,\n    maxSubagents: params.maxSubagents,\n    tokenBudget: params.tokenBudget,\n  }).catch((err) => {\n    service.emit('workflow.run.error', {\n      runId,\n      error: err instanceof Error ? err.message : String(err),\n    });\n  }).finally(() => {\n    activeWorkflowRuns.delete(runId);\n  });\n\n  return runId;\n}\n\nfunction buildWorkflowStats(runs: WorkflowRunSummary[]): {\n  totalRuns: number;\n  activeRuns: number;\n  succeededRuns: number;\n  failedRuns: number;\n  averageDurationMs: number | null;\n  topDefinitions: Array<{ definitionId: string; count: number }>;\n} {\n  const activeStatuses = new Set(['queued', 'running']);\n  const succeededStatuses = new Set(['succeeded']);\n  const failedStatuses = new Set(['failed', 'timeout', 'cancelled']);\n\n  let durationTotal = 0;\n  let durationCount = 0;\n  const definitionCounts = new Map<string, number>();\n\n  for (const run of runs) {\n    definitionCounts.set(run.definitionId, (definitionCounts.get(run.definitionId) ?? 0) + 1);\n    if (run.metrics.durationMs != null && Number.isFinite(run.metrics.durationMs)) {\n      durationTotal += run.metrics.durationMs;\n      durationCount += 1;\n    }\n  }\n\n  const topDefinitions = [...definitionCounts.entries()]\n    .sort((left, right) => right[1] - left[1])\n    .slice(0, 5)\n    .map(([definitionId, count]) => ({ definitionId, count }));\n\n  return {\n    totalRuns: runs.length,\n    activeRuns: runs.filter((run) => activeStatuses.has(run.status)).length,\n    succeededRuns: runs.filter((run) => succeededStatuses.has(run.status)).length,\n    failedRuns: runs.filter((run) => failedStatuses.has(run.status)).length,\n    averageDurationMs: durationCount > 0 ? Math.round(durationTotal / durationCount) : null,\n    topDefinitions,\n  };\n}\n\nfunction createWorkflowEngine(params: {\n  deps: AuthenticatedRouteDeps;\n  eventStore: WorkflowEventStore;\n  runStore: WorkflowRunStore;\n  sessionKey: string;\n}): WorkflowEngine {\n  const { service } = params.deps;\n  const runner = new DelegateSubagentRunner({\n    workspace: service.currentWorkspacePath,\n    bus: service.messageBusInstance,\n    getDefaultModel: () => resolveModelById(service.agentService.getModelForSession(params.sessionKey)),\n    getConfig: () => service.currentConfig,\n    buildChildTools: (childOptions) => buildWorkflowChildTools(childOptions),\n  });\n\n  return new WorkflowEngine({\n    cwd: service.currentWorkspacePath,\n    eventStore: params.eventStore,\n    runStore: params.runStore,\n    runner,\n    resolveModelId: (modelId) => {\n      const agentId = extractProfileAgentId(params.sessionKey, service.currentConfig);\n      return resolveModelById(resolveModelRef(service.currentConfig, agentId, modelId));\n    },\n    onEventAppended: (event) => {\n      service.emit('workflow.event.appended', { runId: event.runId, event });\n    },\n    onRunViewUpdated: (view) => {\n      service.emit('workflow.run.updated', { runId: view.run.id, view });\n    },\n  });\n}\n\nfunction buildWorkflowChildTools(childOptions: BuildChildToolsOptions) {\n  const childFactory = new AgentToolsFactory({\n    workspace: childOptions.workspace,\n    bus: childOptions.bus,\n    getCurrentContext: () => null,\n    getConfig: childOptions.getConfig,\n    getPrimaryModel: () => childOptions.model,\n    toolExecutorConfig: childOptions.toolExecutorConfig,\n  });\n  return childFactory.createAllTools({\n    workspace: childOptions.workspace,\n    getPrimaryModel: () => childOptions.model,\n    disabledTools: new Set(['extensions']),\n  });\n}\n\nasync function readJsonBody<T>(request: Request): Promise<T> {\n  try {\n    return await request.json() as T;\n  } catch {\n    return {} as T;\n  }\n}\n\nfunction normalizePositiveInteger(value: number | undefined): number | undefined {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {\n    return undefined;\n  }\n  return Math.floor(value);\n}\n\nfunction normalizeId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nfunction toTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflows.js","names":[],"sources":["../../../../../src/gateway/hono/routes/workflows.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { resolveDefaultAgentId } from '../../../agent/agent-scope.js';\nimport { createWorkflowCatalog } from '../../../agent/workflow/catalog.js';\nimport type {\n  WorkflowDefinition,\n  WorkflowRunInputEnvelope,\n  WorkflowRunSource,\n  WorkflowRunSummary,\n} from '../../../workflows/domain/index.js';\nimport { buildWorkflowDefinition, validateWorkflowDefinitionInput } from '../../../workflows/domain/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\ninterface StartWorkflowRunRequestBody {\n  definitionId?: string;\n  input?: unknown;\n  inputEnvelope?: WorkflowRunInputEnvelope;\n  goal?: string;\n  agentId?: string;\n  parentSessionKey?: string;\n  source?: WorkflowRunSource;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n  idempotencyKey?: string;\n}\n\ninterface SaveWorkflowDefinitionRequestBody {\n  name?: string;\n  script?: string;\n}\n\nexport function registerWorkflowRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { service } = deps;\n  const workflowRunService = service.createWorkflowRunService();\n\n  authenticated.get('/api/workflows/definitions', (c) => {\n    const catalog = createWorkflowCatalog();\n    const definitions = catalog.list().map((entry) => {\n      try {\n        return toWorkflowDefinition(catalog.load(entry.name));\n      } catch {\n        return null;\n      }\n    }).filter((definition): definition is WorkflowDefinition => Boolean(definition));\n\n    return c.json({ definitions });\n  });\n\n  authenticated.get('/api/workflows/definitions/:id', (c) => {\n    const id = c.req.param('id');\n    const catalog = createWorkflowCatalog();\n    try {\n      const definition = toWorkflowDefinition(catalog.load(id));\n      return c.json({ definition });\n    } catch (err) {\n      return c.json({ error: err instanceof Error ? err.message : 'Workflow definition not found' }, 404);\n    }\n  });\n\n  authenticated.post('/api/workflows/definitions/validate', async (c) => {\n    const body = await readJsonBody<SaveWorkflowDefinitionRequestBody>(c.req.raw);\n    const result = validateWorkflowDefinitionInput({\n      name: body.name,\n      script: body.script,\n    });\n    return c.json(result);\n  });\n\n  authenticated.post('/api/workflows/definitions', async (c) => {\n    const body = await readJsonBody<SaveWorkflowDefinitionRequestBody>(c.req.raw);\n    const validation = validateWorkflowDefinitionInput({\n      name: body.name,\n      script: body.script,\n    });\n    if (!validation.valid) {\n      return c.json({ error: validation.errors[0]?.message ?? 'Invalid workflow definition', validation }, 400);\n    }\n\n    const name = body.name?.trim() ?? '';\n    const script = body.script ?? '';\n    const catalog = createWorkflowCatalog();\n    try {\n      catalog.save(name, script);\n      const definition = toWorkflowDefinition(catalog.load(name));\n      return c.json({ definition }, 201);\n    } catch (err) {\n      return c.json({ error: err instanceof Error ? err.message : 'Failed to save workflow' }, 400);\n    }\n  });\n\n  authenticated.delete('/api/workflows/definitions/:id', (c) => {\n    const id = c.req.param('id').trim();\n    if (!id) {\n      return c.json({ error: 'id is required' }, 400);\n    }\n\n    const catalog = createWorkflowCatalog();\n    try {\n      const removed = catalog.remove(id);\n      if (!removed) {\n        return c.json({ error: 'User workflow not found or cannot delete built-in workflow' }, 404);\n      }\n      return c.json({ removed: true });\n    } catch (err) {\n      return c.json({ error: err instanceof Error ? err.message : 'Failed to delete workflow' }, 400);\n    }\n  });\n\n  authenticated.get('/api/workflows/stats', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const definitionId = c.req.query('definitionId')?.trim();\n    const runStore = workflowRunService.createRunStore(agentId);\n    const runs = await runStore.listRunSummaries(500);\n    const filteredRuns = definitionId ? runs.filter((run) => run.definitionId === definitionId) : runs;\n    return c.json({ stats: buildWorkflowStats(filteredRuns) });\n  });\n\n  authenticated.post('/api/workflows/runs', async (c) => {\n    const body = await readJsonBody<StartWorkflowRunRequestBody>(c.req.raw);\n    const definitionId = body.definitionId?.trim();\n    if (!definitionId) {\n      return c.json({ error: 'definitionId is required' }, 400);\n    }\n\n    const agentId = getAgentId(body.agentId ?? c.req.query('agentId'), service.currentConfig);\n    const parentSessionKey = body.parentSessionKey?.trim() || undefined;\n    const result = await workflowRunService.startWorkflowRun({\n      agentId,\n      definitionId,\n      input: body.input,\n      inputEnvelope: body.inputEnvelope,\n      goal: body.goal,\n      parentSessionKey,\n      source: normalizeWorkflowRunSource(body.source),\n      concurrency: normalizePositiveInteger(body.concurrency),\n      maxSubagents: normalizePositiveInteger(body.maxSubagents),\n      tokenBudget: body.tokenBudget,\n      idempotencyKey: body.idempotencyKey,\n    });\n\n    if (result.ok === false) {\n      return c.json({ error: result.message, code: result.code }, result.httpStatus);\n    }\n\n    return c.json({ runId: result.runId, sessionKey: result.sessionKey }, 202);\n  });\n\n  authenticated.get('/api/workflows/runs', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const rawLimit = c.req.query('limit');\n    const limit = rawLimit ? Number.parseInt(rawLimit, 10) : 50;\n    const runStore = workflowRunService.createRunStore(agentId);\n    const runs = await runStore.listRunSummaries(Number.isFinite(limit) ? limit : 50);\n    return c.json({ runs });\n  });\n\n  authenticated.post('/api/workflows/runs/:runId/cancel', async (c) => {\n    const runId = c.req.param('runId');\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const result = await workflowRunService.cancelWorkflowRun({\n      agentId,\n      runId,\n      reason: 'Cancelled by user',\n    });\n    if (result.ok === false) {\n      return c.json({ error: result.message, code: result.code }, result.httpStatus);\n    }\n    return c.json({\n      cancelled: result.cancelled,\n      alreadyFinished: result.alreadyFinished,\n    });\n  });\n\n  authenticated.get('/api/workflows/runs/:runId', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runId = c.req.param('runId');\n    const runStore = workflowRunService.createRunStore(agentId);\n    const view = await runStore.readRunView(runId);\n    if (!view) {\n      return c.json({ error: 'Workflow run not found' }, 404);\n    }\n    return c.json({ view });\n  });\n\n  authenticated.post('/api/workflows/runs/:runId/rebuild', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runId = c.req.param('runId');\n    const runStore = workflowRunService.createRunStore(agentId);\n    const view = await runStore.rebuildRunView(runId);\n    if (!view) {\n      return c.json({ error: 'Workflow run not found' }, 404);\n    }\n    service.emit('workflow.run.updated', { runId, view });\n    return c.json({ view });\n  });\n\n  authenticated.post('/api/workflows/runs/:runId/retry', async (c) => {\n    const agentId = getAgentId(c.req.query('agentId'), service.currentConfig);\n    const runId = c.req.param('runId');\n    const result = await workflowRunService.retryWorkflowRun({ agentId, runId });\n    if (result.ok === false) {\n      return c.json({ error: result.message, code: result.code }, result.httpStatus);\n    }\n\n    return c.json({ runId: result.runId, sessionKey: result.sessionKey }, 202);\n  });\n}\n\nfunction getAgentId(rawAgentId: string | undefined, config: AuthenticatedRouteDeps['service']['currentConfig']): string {\n  const trimmed = rawAgentId?.trim();\n  if (trimmed) {\n    return trimmed;\n  }\n  return resolveDefaultAgentId(config);\n}\n\nfunction toWorkflowDefinition(loaded: ReturnType<ReturnType<typeof createWorkflowCatalog>['load']>): WorkflowDefinition {\n  return buildWorkflowDefinition({\n    name: loaded.name,\n    source: loaded.source,\n    script: loaded.script,\n    meta: loaded.meta,\n  });\n}\n\nfunction buildWorkflowStats(runs: WorkflowRunSummary[]): {\n  totalRuns: number;\n  activeRuns: number;\n  succeededRuns: number;\n  failedRuns: number;\n  averageDurationMs: number | null;\n  topDefinitions: Array<{ definitionId: string; count: number }>;\n} {\n  const activeStatuses = new Set(['queued', 'running']);\n  const succeededStatuses = new Set(['succeeded']);\n  const failedStatuses = new Set(['failed', 'timeout', 'cancelled']);\n\n  let durationTotal = 0;\n  let durationCount = 0;\n  const definitionCounts = new Map<string, number>();\n\n  for (const run of runs) {\n    definitionCounts.set(run.definitionId, (definitionCounts.get(run.definitionId) ?? 0) + 1);\n    if (run.metrics.durationMs != null && Number.isFinite(run.metrics.durationMs)) {\n      durationTotal += run.metrics.durationMs;\n      durationCount += 1;\n    }\n  }\n\n  const topDefinitions = [...definitionCounts.entries()]\n    .sort((left, right) => right[1] - left[1])\n    .slice(0, 5)\n    .map(([definitionId, count]) => ({ definitionId, count }));\n\n  return {\n    totalRuns: runs.length,\n    activeRuns: runs.filter((run) => activeStatuses.has(run.status)).length,\n    succeededRuns: runs.filter((run) => succeededStatuses.has(run.status)).length,\n    failedRuns: runs.filter((run) => failedStatuses.has(run.status)).length,\n    averageDurationMs: durationCount > 0 ? Math.round(durationTotal / durationCount) : null,\n    topDefinitions,\n  };\n}\n\nasync function readJsonBody<T>(request: Request): Promise<T> {\n  try {\n    return await request.json() as T;\n  } catch {\n    return {} as T;\n  }\n}\n\nfunction normalizeWorkflowRunSource(source: WorkflowRunSource | undefined): WorkflowRunSource {\n  if (!source) {\n    return { kind: 'webui' };\n  }\n  return source;\n}\n\nfunction normalizePositiveInteger(value: number | undefined): number | undefined {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {\n    return undefined;\n  }\n  return Math.floor(value);\n}\n\n"],"mappings":"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"}

package/dist/src/gateway/server.js

@@ -1,10 +1,12 @@
 import { resolveGatewayBindHost, resolveGatewayListenHosts } from "../config/gateway-bind.js";
+import { ensureXopcCliOnPath } from "../infra/path-env.js";
 import { resolveGatewayListenPlan } from "./listen.js";
 import { GatewayService } from "./service.js";
 import { handleSiteShareUpgrade } from "../share/site-share-router.js";
 import { createHonoApp } from "./hono/app.js";
 import { serve } from "@hono/node-server";
 //#region src/gateway/server.ts
+ensureXopcCliOnPath();
 var GatewayServer = class {
 	server;
 	extraServers = [];

package/dist/src/gateway/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../../../src/gateway/server.ts"],"sourcesContent":["import { serve, type ServerType } from '@hono/node-server';\nimport type { IncomingMessage } from 'node:http';\nimport type { Socket } from 'node:net';\n\nimport type { GatewayBindMode } from '../config/schema.js';\nimport { resolveGatewayBindHost, resolveGatewayListenHosts } from '../config/gateway-bind.js';\nimport { resolveGatewayListenPlan } from './listen.js';\nimport { GatewayService } from './service.js';\nimport { createHonoApp } from './hono/app.js';\nimport { handleSiteShareUpgrade } from '../share/site-share-router.js';\n\nexport interface GatewayServerConfig {\n  port: number;\n  /** Resolved listen address (sync plan); re-validated async at start when possible. */\n  bindHost: string;\n  bind?: GatewayBindMode;\n  customBindHost?: string;\n  token?: string;\n  verbose?: boolean;\n  configPath?: string;\n  enableHotReload?: boolean;\n}\n\nexport class GatewayServer {\n  private server?: ServerType;\n  private extraServers: ServerType[] = [];\n  private config: GatewayServerConfig;\n  private service: GatewayService;\n\n  constructor(config: GatewayServerConfig) {\n    this.config = config;\n    this.service = new GatewayService({\n      configPath: config.configPath,\n      enableHotReload: config.enableHotReload,\n      deferChannelConnectUntilAfterHttp: true,\n      listenBind: config.bind,\n      listenCustomBindHost: config.customBindHost,\n      listenPort: config.port,\n    });\n  }\n\n  async start(): Promise<void> {\n    const cfg = this.service.currentConfig;\n    const plan = resolveGatewayListenPlan({\n      cfg,\n      bindOverride: this.config.bind,\n    });\n\n    let bindHost: string;\n    try {\n      bindHost = await resolveGatewayBindHost({\n        bindMode: plan.bindMode,\n        customBindHost: plan.customBindHost ?? this.config.customBindHost,\n      });\n    } catch (err) {\n      bindHost = plan.bindHost;\n      if (plan.bindMode === 'custom') {\n        throw err;\n      }\n    }\n\n    if (plan.bindMode === 'custom') {\n      const expected = plan.customBindHost?.trim();\n      if (!expected || bindHost !== expected) {\n        throw new Error(\n          `gateway bind=custom requested ${expected ?? '(missing)'} but resolved ${bindHost}`,\n        );\n      }\n    }\n\n    const listenHosts = await resolveGatewayListenHosts(bindHost);\n    console.log(`[GatewayServer] Starting gateway server on ${bindHost}:${this.config.port}...`);\n\n    await this.service.start();\n    this.service.registerGatewayShutdownForRestart(async () => {\n      await this.stop();\n    });\n\n    const { configureTunnelFromGatewayConfig } = await import('../tunnel/gateway-lifecycle.js');\n    await configureTunnelFromGatewayConfig(this.service.currentConfig, { deferWellKnownFetch: true });\n\n    const effectiveToken = this.config.token || this.service.getAuthToken();\n    const app = createHonoApp({\n      service: this.service,\n      token: effectiveToken,\n    });\n\n    const primaryHost = listenHosts[0] ?? bindHost;\n    const attachUpgrade = (server: ServerType): void => {\n      // `@hono/node-server`'s `serve()` returns the underlying `http.Server`.\n      const inner = server as unknown as {\n        on(event: 'upgrade', listener: (req: IncomingMessage, socket: Socket, head: Buffer) => void): void;\n      };\n      inner.on('upgrade', (req, socket, head) => {\n        try {\n          handleSiteShareUpgrade(this.service, req, socket, head);\n        } catch (err) {\n          console.error('[GatewayServer] site-share upgrade error:', err);\n          try {\n            socket.destroy();\n          } catch {\n            /* ignore */\n          }\n        }\n      });\n    };\n\n    this.server = serve(\n      {\n        fetch: app.fetch,\n        port: this.config.port,\n        hostname: primaryHost,\n      },\n      () => {\n        console.log(`[GatewayServer] Gateway server running at http://${primaryHost}:${this.config.port}`);\n        this.service.markHttpListening();\n        void this.service.onHttpListening().catch((err) => {\n          console.error('[GatewayServer] Deferred channel startup failed:', err);\n        });\n      },\n    );\n    attachUpgrade(this.server);\n\n    for (const aliasHost of listenHosts.slice(1)) {\n      const extra = serve({\n        fetch: app.fetch,\n        port: this.config.port,\n        hostname: aliasHost,\n      });\n      attachUpgrade(extra);\n      this.extraServers.push(extra);\n    }\n  }\n\n  async close(opts?: { reason?: string; restartExpectedMs?: number | null }): Promise<void> {\n    const reason = opts?.reason ?? 'gateway stopping';\n    console.log(`[GatewayServer] Closing gateway server: ${reason}`);\n    await this.stop();\n  }\n\n  async stop(): Promise<void> {\n    console.log('[GatewayServer] Stopping gateway server...');\n\n    const closeServer = async (server: ServerType | undefined) => {\n      if (!server) {\n        return;\n      }\n      const forceClose = setTimeout(() => {\n        (server as { closeAllConnections?: () => void }).closeAllConnections?.();\n      }, 2000);\n      await new Promise<void>((resolve) => {\n        server.close(() => {\n          clearTimeout(forceClose);\n          resolve();\n        });\n      });\n    };\n\n    await closeServer(this.server);\n    this.server = undefined;\n\n    for (const extra of this.extraServers) {\n      await closeServer(extra);\n    }\n    this.extraServers = [];\n\n    await this.service.stop();\n\n    console.log('[GatewayServer] Gateway server stopped');\n  }\n\n  get isRunning(): boolean {\n    return this.server !== undefined;\n  }\n\n  get serviceInstance(): GatewayService {\n    return this.service;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"server.js","names":[],"sources":["../../../src/gateway/server.ts"],"sourcesContent":["import { serve, type ServerType } from '@hono/node-server';\nimport type { IncomingMessage } from 'node:http';\nimport type { Socket } from 'node:net';\n\nimport { ensureXopcCliOnPath } from '../infra/path-env.js';\n\nensureXopcCliOnPath();\n\nimport type { GatewayBindMode } from '../config/schema.js';\nimport { resolveGatewayBindHost, resolveGatewayListenHosts } from '../config/gateway-bind.js';\nimport { resolveGatewayListenPlan } from './listen.js';\nimport { GatewayService } from './service.js';\nimport { createHonoApp } from './hono/app.js';\nimport { handleSiteShareUpgrade } from '../share/site-share-router.js';\n\nexport interface GatewayServerConfig {\n  port: number;\n  /** Resolved listen address (sync plan); re-validated async at start when possible. */\n  bindHost: string;\n  bind?: GatewayBindMode;\n  customBindHost?: string;\n  token?: string;\n  verbose?: boolean;\n  configPath?: string;\n  enableHotReload?: boolean;\n}\n\nexport class GatewayServer {\n  private server?: ServerType;\n  private extraServers: ServerType[] = [];\n  private config: GatewayServerConfig;\n  private service: GatewayService;\n\n  constructor(config: GatewayServerConfig) {\n    this.config = config;\n    this.service = new GatewayService({\n      configPath: config.configPath,\n      enableHotReload: config.enableHotReload,\n      deferChannelConnectUntilAfterHttp: true,\n      listenBind: config.bind,\n      listenCustomBindHost: config.customBindHost,\n      listenPort: config.port,\n    });\n  }\n\n  async start(): Promise<void> {\n    const cfg = this.service.currentConfig;\n    const plan = resolveGatewayListenPlan({\n      cfg,\n      bindOverride: this.config.bind,\n    });\n\n    let bindHost: string;\n    try {\n      bindHost = await resolveGatewayBindHost({\n        bindMode: plan.bindMode,\n        customBindHost: plan.customBindHost ?? this.config.customBindHost,\n      });\n    } catch (err) {\n      bindHost = plan.bindHost;\n      if (plan.bindMode === 'custom') {\n        throw err;\n      }\n    }\n\n    if (plan.bindMode === 'custom') {\n      const expected = plan.customBindHost?.trim();\n      if (!expected || bindHost !== expected) {\n        throw new Error(\n          `gateway bind=custom requested ${expected ?? '(missing)'} but resolved ${bindHost}`,\n        );\n      }\n    }\n\n    const listenHosts = await resolveGatewayListenHosts(bindHost);\n    console.log(`[GatewayServer] Starting gateway server on ${bindHost}:${this.config.port}...`);\n\n    await this.service.start();\n    this.service.registerGatewayShutdownForRestart(async () => {\n      await this.stop();\n    });\n\n    const { configureTunnelFromGatewayConfig } = await import('../tunnel/gateway-lifecycle.js');\n    await configureTunnelFromGatewayConfig(this.service.currentConfig, { deferWellKnownFetch: true });\n\n    const effectiveToken = this.config.token || this.service.getAuthToken();\n    const app = createHonoApp({\n      service: this.service,\n      token: effectiveToken,\n    });\n\n    const primaryHost = listenHosts[0] ?? bindHost;\n    const attachUpgrade = (server: ServerType): void => {\n      // `@hono/node-server`'s `serve()` returns the underlying `http.Server`.\n      const inner = server as unknown as {\n        on(event: 'upgrade', listener: (req: IncomingMessage, socket: Socket, head: Buffer) => void): void;\n      };\n      inner.on('upgrade', (req, socket, head) => {\n        try {\n          handleSiteShareUpgrade(this.service, req, socket, head);\n        } catch (err) {\n          console.error('[GatewayServer] site-share upgrade error:', err);\n          try {\n            socket.destroy();\n          } catch {\n            /* ignore */\n          }\n        }\n      });\n    };\n\n    this.server = serve(\n      {\n        fetch: app.fetch,\n        port: this.config.port,\n        hostname: primaryHost,\n      },\n      () => {\n        console.log(`[GatewayServer] Gateway server running at http://${primaryHost}:${this.config.port}`);\n        this.service.markHttpListening();\n        void this.service.onHttpListening().catch((err) => {\n          console.error('[GatewayServer] Deferred channel startup failed:', err);\n        });\n      },\n    );\n    attachUpgrade(this.server);\n\n    for (const aliasHost of listenHosts.slice(1)) {\n      const extra = serve({\n        fetch: app.fetch,\n        port: this.config.port,\n        hostname: aliasHost,\n      });\n      attachUpgrade(extra);\n      this.extraServers.push(extra);\n    }\n  }\n\n  async close(opts?: { reason?: string; restartExpectedMs?: number | null }): Promise<void> {\n    const reason = opts?.reason ?? 'gateway stopping';\n    console.log(`[GatewayServer] Closing gateway server: ${reason}`);\n    await this.stop();\n  }\n\n  async stop(): Promise<void> {\n    console.log('[GatewayServer] Stopping gateway server...');\n\n    const closeServer = async (server: ServerType | undefined) => {\n      if (!server) {\n        return;\n      }\n      const forceClose = setTimeout(() => {\n        (server as { closeAllConnections?: () => void }).closeAllConnections?.();\n      }, 2000);\n      await new Promise<void>((resolve) => {\n        server.close(() => {\n          clearTimeout(forceClose);\n          resolve();\n        });\n      });\n    };\n\n    await closeServer(this.server);\n    this.server = undefined;\n\n    for (const extra of this.extraServers) {\n      await closeServer(extra);\n    }\n    this.extraServers = [];\n\n    await this.service.stop();\n\n    console.log('[GatewayServer] Gateway server stopped');\n  }\n\n  get isRunning(): boolean {\n    return this.server !== undefined;\n  }\n\n  get serviceInstance(): GatewayService {\n    return this.service;\n  }\n}\n"],"mappings":";;;;;;;;AAMA,qBAAqB;AAqBrB,IAAa,gBAAb,MAA2B;CACzB;CACA,eAAqC,EAAE;CACvC;CACA;CAEA,YAAY,QAA6B;AACvC,OAAK,SAAS;AACd,OAAK,UAAU,IAAI,eAAe;GAChC,YAAY,OAAO;GACnB,iBAAiB,OAAO;GACxB,mCAAmC;GACnC,YAAY,OAAO;GACnB,sBAAsB,OAAO;GAC7B,YAAY,OAAO;GACpB,CAAC;;CAGJ,MAAM,QAAuB;EAC3B,MAAM,MAAM,KAAK,QAAQ;EACzB,MAAM,OAAO,yBAAyB;GACpC;GACA,cAAc,KAAK,OAAO;GAC3B,CAAC;EAEF,IAAI;AACJ,MAAI;AACF,cAAW,MAAM,uBAAuB;IACtC,UAAU,KAAK;IACf,gBAAgB,KAAK,kBAAkB,KAAK,OAAO;IACpD,CAAC;WACK,KAAK;AACZ,cAAW,KAAK;AAChB,OAAI,KAAK,aAAa,SACpB,OAAM;;AAIV,MAAI,KAAK,aAAa,UAAU;GAC9B,MAAM,WAAW,KAAK,gBAAgB,MAAM;AAC5C,OAAI,CAAC,YAAY,aAAa,SAC5B,OAAM,IAAI,MACR,iCAAiC,YAAY,YAAY,gBAAgB,WAC1E;;EAIL,MAAM,cAAc,MAAM,0BAA0B,SAAS;AAC7D,UAAQ,IAAI,8CAA8C,SAAS,GAAG,KAAK,OAAO,KAAK,KAAK;AAE5F,QAAM,KAAK,QAAQ,OAAO;AAC1B,OAAK,QAAQ,kCAAkC,YAAY;AACzD,SAAM,KAAK,MAAM;IACjB;EAEF,MAAM,EAAE,qCAAqC,MAAM,OAAO;AAC1D,QAAM,iCAAiC,KAAK,QAAQ,eAAe,EAAE,qBAAqB,MAAM,CAAC;EAEjG,MAAM,iBAAiB,KAAK,OAAO,SAAS,KAAK,QAAQ,cAAc;EACvE,MAAM,MAAM,cAAc;GACxB,SAAS,KAAK;GACd,OAAO;GACR,CAAC;EAEF,MAAM,cAAc,YAAY,MAAM;EACtC,MAAM,iBAAiB,WAA6B;AAKlD,UAAM,GAAG,YAAY,KAAK,QAAQ,SAAS;AACzC,QAAI;AACF,4BAAuB,KAAK,SAAS,KAAK,QAAQ,KAAK;aAChD,KAAK;AACZ,aAAQ,MAAM,6CAA6C,IAAI;AAC/D,SAAI;AACF,aAAO,SAAS;aACV;;KAIV;;AAGJ,OAAK,SAAS,MACZ;GACE,OAAO,IAAI;GACX,MAAM,KAAK,OAAO;GAClB,UAAU;GACX,QACK;AACJ,WAAQ,IAAI,oDAAoD,YAAY,GAAG,KAAK,OAAO,OAAO;AAClG,QAAK,QAAQ,mBAAmB;AAC3B,QAAK,QAAQ,iBAAiB,CAAC,OAAO,QAAQ;AACjD,YAAQ,MAAM,oDAAoD,IAAI;KACtE;IAEL;AACD,gBAAc,KAAK,OAAO;AAE1B,OAAK,MAAM,aAAa,YAAY,MAAM,EAAE,EAAE;GAC5C,MAAM,QAAQ,MAAM;IAClB,OAAO,IAAI;IACX,MAAM,KAAK,OAAO;IAClB,UAAU;IACX,CAAC;AACF,iBAAc,MAAM;AACpB,QAAK,aAAa,KAAK,MAAM;;;CAIjC,MAAM,MAAM,MAA8E;EACxF,MAAM,SAAS,MAAM,UAAU;AAC/B,UAAQ,IAAI,2CAA2C,SAAS;AAChE,QAAM,KAAK,MAAM;;CAGnB,MAAM,OAAsB;AAC1B,UAAQ,IAAI,6CAA6C;EAEzD,MAAM,cAAc,OAAO,WAAmC;AAC5D,OAAI,CAAC,OACH;GAEF,MAAM,aAAa,iBAAiB;AACjC,WAAgD,uBAAuB;MACvE,IAAK;AACR,SAAM,IAAI,SAAe,YAAY;AACnC,WAAO,YAAY;AACjB,kBAAa,WAAW;AACxB,cAAS;MACT;KACF;;AAGJ,QAAM,YAAY,KAAK,OAAO;AAC9B,OAAK,SAAS,KAAA;AAEd,OAAK,MAAM,SAAS,KAAK,aACvB,OAAM,YAAY,MAAM;AAE1B,OAAK,eAAe,EAAE;AAEtB,QAAM,KAAK,QAAQ,MAAM;AAEzB,UAAQ,IAAI,yCAAyC;;CAGvD,IAAI,YAAqB;AACvB,SAAO,KAAK,WAAW,KAAA;;CAGzB,IAAI,kBAAkC;AACpC,SAAO,KAAK"}

package/dist/src/gateway/service.d.ts

@@ -1,6 +1,7 @@
 import { AgentService } from '../agent/service.js';
 import { MessageBus } from '../infra/bus/index.js';
 import { CronService } from '../cron/index.js';
+import { WorkflowRunService } from '../workflows/service/workflow-run-service.js';
 import { ExtensionLoader } from '../extensions/index.js';
 import { SessionIndex } from '../session/index.js';
 import type { Config } from '../config/schema.js';
@@ -43,6 +44,8 @@ export declare class GatewayService {
     private lastChannelConnectDeferSource;
     private readonly readiness;
     private startupTrace;
+    private workflowSessionBridge;
+    private workflowRunServiceInstance;
     /**
      * Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
      * `submitClarifyResponse`, clarify-bridge dispatch). Owns the
@@ -216,6 +219,8 @@ export declare class GatewayService {
     getEffectiveListenPort(): number;
     get cronServiceInstance(): CronService;
     get sessionIndexInstance(): SessionIndex;
+    /** Shared workflow run orchestrator + session bridge (one instance per gateway). */
+    createWorkflowRunService(): WorkflowRunService;
     /** Process a message directly through the agent (for CLI mode). */
     processDirect(content: string, sessionKey?: string): Promise<string>;
     subscribe(sessionId: string, listener: (event: ServiceEvent) => Promise<void> | void): () => void;