@xopcai/xopc 0.0.20 → 0.0.21

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';\n\nimport { loadConfig } from '../../../config/index.js';\nimport { detectInstallKind, resolvePackageRoot } from '../../../infra/update-check.js';\nimport { DEFAULT_PACKAGE_CHANNEL, normalizeUpdateChannel } from '../../../infra/update-channels.js';\nimport { runAutoUpdateCommand } 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\nlet updateRunInFlight = false;\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\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    if (updateRunInFlight) {\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 configPath = service.getHealth().configPath;\n    const config = loadConfig(configPath);\n    const channel =\n      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 c.json(\n          {\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          400,\n        );\n      }\n    }\n\n    updateRunInFlight = true;\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      // Do not run registry check here: the process still reports the old `PACKAGE_VERSION`\n      // until the gateway is restarted, which would keep `update available` set incorrectly.\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      updateRunInFlight = false;\n    }\n  });\n}\n"],"mappings":"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"}
+{"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":"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"}

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

@@ -1,8 +1,8 @@
-import { createLogger } from "../../../utils/logger/index.js";
-import { init_logger } from "../../../utils/logger.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentHomeDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { getWorkspacePath, init_schema } from "../../../config/schema.js";
 import { extractProfileAgentId } from "../../../config/agent-profile.js";
+import { createLogger } from "../../../utils/logger/index.js";
+import { init_logger } from "../../../utils/logger.js";
 import { resolveSafeInboundFilePath } from "../../../channels/attachments/inbound-persist.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath, toWorkspaceRelativePosix } from "../../workspace-editor-path.js";
 import { resolveSafeTtsFilePath } from "../../../channels/attachments/outbound-tts-persist.js";

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

@@ -1,8 +1,8 @@
+import { buildSessionKey, init_session_key, parseSessionKey } from "../../routing/session-key.js";
+import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { updateAsyncLogContext } from "../../utils/logger/context.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { buildSessionKey, init_session_key, parseSessionKey } from "../../routing/session-key.js";
-import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from "../chat-limits.js";
 import { stringifySSEData } from "./sse-json.js";
 import { randomUUID } from "node:crypto";

package/dist/src/gateway/index.js

@@ -1,10 +1,10 @@
 import { GatewayLockError, acquireGatewayLock } from "./lock.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, safeCompare, validateToken } from "./auth.js";
+import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import { GatewayService } from "./service.js";
 import { createAgentResumeHandler, createAgentSSEHandler, createEventsSSEHandler, createSendHandler } from "./hono/sse.js";
 import { createHonoApp } from "./hono/app.js";
 import { GatewayServer } from "./server.js";
-import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import { runGatewayLoop } from "./run-loop.js";
 import { checkPortAvailable, forceFreePortAndWait, listPortListeners, parseLsofOutput } from "./ports.js";
 import { apiError, apiOk } from "./protocol.js";

package/dist/src/gateway/server.js

@@ -16,6 +16,9 @@ var GatewayServer = class {
 	async start() {
 		console.log(`[GatewayServer] Starting gateway server on ${this.config.host}:${this.config.port}...`);
 		await this.service.start();
+		this.service.registerGatewayShutdownForRestart(async () => {
+			await this.stop();
+		});
 		const effectiveToken = this.config.token || this.service.getAuthToken();
 		const app = createHonoApp({
 			service: this.service,

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 { GatewayService } from './service.js';\nimport { createHonoApp } from './hono/app.js';\n\nexport interface GatewayServerConfig {\n  host: string;\n  port: number;\n  token?: string;\n  verbose?: boolean;\n  configPath?: string;\n  enableHotReload?: boolean;\n}\n\nexport class GatewayServer {\n  private server?: 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    });\n  }\n\n  async start(): Promise<void> {\n    console.log(`[GatewayServer] Starting gateway server on ${this.config.host}:${this.config.port}...`);\n\n    // Start the underlying service first\n    await this.service.start();\n\n    // Create Hono app\n    // Priority: CLI token > service auto-generated token\n    const effectiveToken = this.config.token || this.service.getAuthToken();\n    const app = createHonoApp({\n      service: this.service,\n      token: effectiveToken,\n    });\n\n    // Create Node.js HTTP server (no WebSocket upgrade needed)\n    this.server = serve({\n      fetch: app.fetch,\n      port: this.config.port,\n      hostname: this.config.host,\n    }, () => {\n      console.log(`[GatewayServer] Gateway server running at http://${this.config.host}:${this.config.port}`);\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    // Stop the HTTP server\n    if (this.server) {\n      // Force server close after a short delay to allow connections to drain\n      const forceClose = setTimeout(() => {\n        if (this.server) {\n          (this.server as any).closeAllConnections?.();\n        }\n      }, 2000);\n      \n      await new Promise<void>((resolve) => {\n        this.server!.close(() => {\n          clearTimeout(forceClose);\n          resolve();\n        });\n      });\n      this.server = undefined;\n    }\n\n    // Stop the underlying service\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":";;;;AAaA,IAAa,gBAAb,MAA2B;CACzB;CACA;CACA;CAEA,YAAY,QAA6B;AACvC,OAAK,SAAS;AACd,OAAK,UAAU,IAAI,eAAe;GAChC,YAAY,OAAO;GACnB,iBAAiB,OAAO;GACzB,CAAC;;CAGJ,MAAM,QAAuB;AAC3B,UAAQ,IAAI,8CAA8C,KAAK,OAAO,KAAK,GAAG,KAAK,OAAO,KAAK,KAAK;AAGpG,QAAM,KAAK,QAAQ,OAAO;EAI1B,MAAM,iBAAiB,KAAK,OAAO,SAAS,KAAK,QAAQ,cAAc;EACvE,MAAM,MAAM,cAAc;GACxB,SAAS,KAAK;GACd,OAAO;GACR,CAAC;AAGF,OAAK,SAAS,MAAM;GAClB,OAAO,IAAI;GACX,MAAM,KAAK,OAAO;GAClB,UAAU,KAAK,OAAO;GACvB,QAAQ;AACP,WAAQ,IAAI,oDAAoD,KAAK,OAAO,KAAK,GAAG,KAAK,OAAO,OAAO;IACvG;;CAGJ,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;AAGzD,MAAI,KAAK,QAAQ;GAEf,MAAM,aAAa,iBAAiB;AAClC,QAAI,KAAK,OACN,MAAK,OAAe,uBAAuB;MAE7C,IAAK;AAER,SAAM,IAAI,SAAe,YAAY;AACnC,SAAK,OAAQ,YAAY;AACvB,kBAAa,WAAW;AACxB,cAAS;MACT;KACF;AACF,QAAK,SAAS,KAAA;;AAIhB,QAAM,KAAK,QAAQ,MAAM;AAEzB,UAAQ,IAAI,yCAAyC;;CAGvD,IAAI,YAAqB;AACvB,SAAO,KAAK,WAAW,KAAA;;CAGzB,IAAI,kBAAkC;AACpC,SAAO,KAAK"}
+{"version":3,"file":"server.js","names":[],"sources":["../../../src/gateway/server.ts"],"sourcesContent":["import { serve, type ServerType } from '@hono/node-server';\nimport { GatewayService } from './service.js';\nimport { createHonoApp } from './hono/app.js';\n\nexport interface GatewayServerConfig {\n  host: string;\n  port: number;\n  token?: string;\n  verbose?: boolean;\n  configPath?: string;\n  enableHotReload?: boolean;\n}\n\nexport class GatewayServer {\n  private server?: 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    });\n  }\n\n  async start(): Promise<void> {\n    console.log(`[GatewayServer] Starting gateway server on ${this.config.host}:${this.config.port}...`);\n\n    // Start the underlying service first\n    await this.service.start();\n    this.service.registerGatewayShutdownForRestart(async () => {\n      await this.stop();\n    });\n\n    // Create Hono app\n    // Priority: CLI token > service auto-generated token\n    const effectiveToken = this.config.token || this.service.getAuthToken();\n    const app = createHonoApp({\n      service: this.service,\n      token: effectiveToken,\n    });\n\n    // Create Node.js HTTP server (no WebSocket upgrade needed)\n    this.server = serve({\n      fetch: app.fetch,\n      port: this.config.port,\n      hostname: this.config.host,\n    }, () => {\n      console.log(`[GatewayServer] Gateway server running at http://${this.config.host}:${this.config.port}`);\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    // Stop the HTTP server\n    if (this.server) {\n      // Force server close after a short delay to allow connections to drain\n      const forceClose = setTimeout(() => {\n        if (this.server) {\n          (this.server as any).closeAllConnections?.();\n        }\n      }, 2000);\n      \n      await new Promise<void>((resolve) => {\n        this.server!.close(() => {\n          clearTimeout(forceClose);\n          resolve();\n        });\n      });\n      this.server = undefined;\n    }\n\n    // Stop the underlying service\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":";;;;AAaA,IAAa,gBAAb,MAA2B;CACzB;CACA;CACA;CAEA,YAAY,QAA6B;AACvC,OAAK,SAAS;AACd,OAAK,UAAU,IAAI,eAAe;GAChC,YAAY,OAAO;GACnB,iBAAiB,OAAO;GACzB,CAAC;;CAGJ,MAAM,QAAuB;AAC3B,UAAQ,IAAI,8CAA8C,KAAK,OAAO,KAAK,GAAG,KAAK,OAAO,KAAK,KAAK;AAGpG,QAAM,KAAK,QAAQ,OAAO;AAC1B,OAAK,QAAQ,kCAAkC,YAAY;AACzD,SAAM,KAAK,MAAM;IACjB;EAIF,MAAM,iBAAiB,KAAK,OAAO,SAAS,KAAK,QAAQ,cAAc;EACvE,MAAM,MAAM,cAAc;GACxB,SAAS,KAAK;GACd,OAAO;GACR,CAAC;AAGF,OAAK,SAAS,MAAM;GAClB,OAAO,IAAI;GACX,MAAM,KAAK,OAAO;GAClB,UAAU,KAAK,OAAO;GACvB,QAAQ;AACP,WAAQ,IAAI,oDAAoD,KAAK,OAAO,KAAK,GAAG,KAAK,OAAO,OAAO;IACvG;;CAGJ,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;AAGzD,MAAI,KAAK,QAAQ;GAEf,MAAM,aAAa,iBAAiB;AAClC,QAAI,KAAK,OACN,MAAK,OAAe,uBAAuB;MAE7C,IAAK;AAER,SAAM,IAAI,SAAe,YAAY;AACnC,SAAK,OAAQ,YAAY;AACvB,kBAAa,WAAW;AACxB,cAAS;MACT;KACF;AACF,QAAK,SAAS,KAAA;;AAIhB,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

@@ -40,6 +40,8 @@ export declare class GatewayService {
     /** Per-run abort for webchat (POST /api/agent/abort or client disconnect). */
     private runAbortControllers;
     private stopGatewayUpdateCheck;
+    /** When set (e.g. by `GatewayServer`), `triggerGatewayProcessRestart` can stop HTTP then exit. */
+    private gatewayShutdownForRestart;
     private readonly clarifyBridge;
     /** Maps webchat session key → active `runId` for `clarify` tool routing. */
     private activeWebchatRunBySession;
@@ -94,6 +96,10 @@ export declare class GatewayService {
      * Handle tools config hot reload
      */
     private handleToolsReload;
+    /**
+     * Dispatch config hot reload to extensions that registered `registerReload`, matching changed paths.
+     */
+    private handleExtensionsReload;
     /**
      * Reload configuration from disk (manual trigger)
      */
@@ -106,6 +112,11 @@ export declare class GatewayService {
      * channel apply as an API save, then force Weixin long-poll restart (see `reloadMonitorsWithConfig`).
      */
     afterWeixinCredentialsPersisted(): Promise<void>;
+    /**
+     * After Feishu WebUI QR setup: `channels.feishu` was written directly to disk; reload into memory
+     * and apply channel plugins (same baseline as PATCH /api/config).
+     */
+    afterFeishuCredentialsPersisted(): Promise<void>;
     /**
      * Save current config to disk
      */
@@ -193,6 +204,18 @@ export declare class GatewayService {
     requestHeartbeatNow(opts?: {
         reason?: string;
     }): void;
+    /**
+     * Register graceful shutdown used after spawning a replacement gateway process (foreground CLI server).
+     */
+    registerGatewayShutdownForRestart(handler: () => Promise<void>): void;
+    /**
+     * Respawn the gateway process when supported (spawn + exit, supervisor exit, or disabled when XOPC_NO_RESPAWN).
+     */
+    triggerGatewayProcessRestart(): {
+        ok: boolean;
+        mode: string;
+        message?: string;
+    };
     /**
      * Get health status
      */

package/dist/src/gateway/service.js

@@ -1,16 +1,16 @@
 import { __toCommonJS } from "../../_virtual/_rolldown/runtime.js";
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
+import { resolveStateDir } from "../config/paths-state.js";
+import { getWorkspacePath, init_schema } from "../config/schema.js";
+import { buildSessionKey, init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { getLogDir } from "../utils/logger/config.js";
 import { getLogStats } from "../utils/logger/stats.js";
 import { inboundCorrelationMetadataFromAsyncLogContext } from "../utils/logger/context.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveStateDir } from "../config/paths-state.js";
 import { init_paths, resolveAgentDir, resolveConfigPath, resolveCronJobsPath, resolveWorkspaceExtensionsDir } from "../config/paths.js";
-import { getWorkspacePath, init_schema } from "../config/schema.js";
 import { loadConfig, saveConfig } from "../config/loader.js";
-import { buildSessionKey, init_session_key, parseSessionKey } from "../routing/session-key.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { getModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { createSkillConfigManager } from "../agent/skills/config.js";
@@ -39,6 +39,7 @@ import { AgentRunRelay } from "./agent-run-relay.js";
 import { ClarifyBridge } from "./clarify-bridge.js";
 import { downloadSkillZipBuffer, fetchMarketplacePackageDetail, listSkillPackages, resolveSkillZipDownloadUrl, resolveSkillsStoreBaseUrl, skillIdForMarketplaceInstall } from "../agent/skills/skills-store-client.js";
 import { scheduleGatewayUpdateCheck } from "../infra/update-startup.js";
+import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import "./chat-limits.js";
 import crypto from "crypto";
 //#region src/gateway/service.ts
@@ -73,6 +74,8 @@ var GatewayService = class {
 	/** Per-run abort for webchat (POST /api/agent/abort or client disconnect). */
 	runAbortControllers = /* @__PURE__ */ new Map();
 	stopGatewayUpdateCheck = null;
+	/** When set (e.g. by `GatewayServer`), `triggerGatewayProcessRestart` can stop HTTP then exit. */
+	gatewayShutdownForRestart = null;
 	clarifyBridge = new ClarifyBridge();
 	/** Maps webchat session key → active `runId` for `clarify` tool routing. */
 	activeWebchatRunBySession = /* @__PURE__ */ new Map();
@@ -286,6 +289,9 @@ var GatewayService = class {
 			onCronReload: (newConfig) => this.handleCronReload(newConfig),
 			onHeartbeatReload: (newConfig) => this.handleHeartbeatReload(newConfig),
 			onToolsReload: (newConfig) => this.handleToolsReload(newConfig),
+			onExtensionsReload: async (newConfig, changedPaths) => {
+				await this.handleExtensionsReload(newConfig, changedPaths);
+			},
 			onFullRestart: (newConfig) => {
 				log.warn({
 					requiresProcessRestart: true,
@@ -377,6 +383,58 @@ var GatewayService = class {
 		log.debug("Tools config reloaded");
 	}
 	/**
+	* Dispatch config hot reload to extensions that registered `registerReload`, matching changed paths.
+	*/
+	async handleExtensionsReload(newConfig, changedPaths) {
+		this.config = newConfig;
+		this.extensionLoader?.setConfig(this.config);
+		if (!this.extensionLoader) {
+			this.emit("config.reload", {
+				section: "extensions",
+				source: "extension-reload",
+				changedPaths
+			});
+			return;
+		}
+		const matchingRegs = this.extensionLoader.getRegistry().getMatchingReloadRegistrations(changedPaths);
+		if (matchingRegs.length === 0) {
+			log.debug({ changedPaths }, "No extension reload handlers matched");
+			this.emit("config.reload", {
+				section: "extensions",
+				source: "extension-reload",
+				changedPaths
+			});
+			return;
+		}
+		for (const reg of matchingRegs) {
+			const relevantPaths = changedPaths.filter((p) => reg.configPrefixes.length === 0 || reg.configPrefixes.some((prefix) => p === prefix || p.startsWith(`${prefix}.`)));
+			log.info({
+				extensionId: reg.extensionId,
+				relevantPaths
+			}, "Calling extension reload handler");
+			try {
+				const result = await reg.handler(newConfig, relevantPaths);
+				if (result.success) log.info({ extensionId: reg.extensionId }, "Extension reload succeeded");
+				else log.warn({
+					extensionId: reg.extensionId,
+					error: result.error
+				}, `Extension reload reported failure: ${result.error ?? "unknown"}`);
+			} catch (err) {
+				const errorMessage = err instanceof Error ? err.message : String(err);
+				log.error({
+					err,
+					extensionId: reg.extensionId,
+					errorMessage
+				}, `Extension reload handler threw: ${errorMessage}`);
+			}
+		}
+		this.emit("config.reload", {
+			section: "extensions",
+			source: "extension-reload",
+			changedPaths
+		});
+	}
+	/**
 	* Reload configuration from disk (manual trigger)
 	*/
 	async reloadConfig() {
@@ -405,6 +463,18 @@ var GatewayService = class {
 		log.info("Weixin monitors restarted after credential login");
 	}
 	/**
+	* After Feishu WebUI QR setup: `channels.feishu` was written directly to disk; reload into memory
+	* and apply channel plugins (same baseline as PATCH /api/config).
+	*/
+	async afterFeishuCredentialsPersisted() {
+		const next = loadConfig(this.configPath);
+		this.config = next;
+		this.agentService.applyAgentDefaultsFromConfig(next);
+		this.configReloader?.syncCurrentConfig(next);
+		await this.handleChannelsReload(next);
+		log.info("Feishu config applied after QR setup");
+	}
+	/**
 	* Save current config to disk
 	*/
 	/**
@@ -744,6 +814,43 @@ var GatewayService = class {
 		this.heartbeatService.requestNow({ reason: opts?.reason ?? "manual" });
 	}
 	/**
+	* Register graceful shutdown used after spawning a replacement gateway process (foreground CLI server).
+	*/
+	registerGatewayShutdownForRestart(handler) {
+		this.gatewayShutdownForRestart = handler;
+	}
+	/**
+	* Respawn the gateway process when supported (spawn + exit, supervisor exit, or disabled when XOPC_NO_RESPAWN).
+	*/
+	triggerGatewayProcessRestart() {
+		const result = restartGatewayProcessWithFreshPid();
+		if (result.mode === "failed") return {
+			ok: false,
+			mode: result.mode,
+			message: result.detail ?? "spawn failed"
+		};
+		if (result.mode === "disabled") return {
+			ok: false,
+			mode: "disabled",
+			message: "Process respawn is disabled (XOPC_NO_RESPAWN). Restart the gateway manually (e.g. xopc gateway restart)."
+		};
+		const shutdown = this.gatewayShutdownForRestart;
+		if (!shutdown) return {
+			ok: false,
+			mode: result.mode,
+			message: "Gateway restart is not available in this process."
+		};
+		setImmediate(() => {
+			shutdown().finally(() => {
+				process.exit(0);
+			});
+		});
+		return {
+			ok: true,
+			mode: result.mode
+		};
+	}
+	/**
 	* Get health status
 	*/
 	getHealth() {