@xopcai/xopc 0.0.118 → 0.0.119

package/dist/src/gateway/service/config-coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-coordinator.js","names":["writeConfigToDisk"],"sources":["../../../../src/gateway/service/config-coordinator.ts"],"sourcesContent":["/**\n * GatewayConfigCoordinator — owns config persistence, hot-reload, and the\n * per-section reload handlers.\n *\n * Was 350 lines of `GatewayService` covering nine concerns:\n *   - manual `reloadConfig()` (CLI/UI trigger)\n *   - `saveConfig()` / `updateConfig()` (PATCH /api/config)\n *   - `setBundledExtensionActivationTarget` (extension store install)\n *   - `afterWeixinCredentialsPersisted` / `afterFeishuCredentialsPersisted`\n *     (QR-login follow-ups that bypass the watcher)\n *   - `ConfigHotReloader` (fs.watch → debounced per-section dispatch)\n *   - Eight section reload handlers (models / agents / channels / cron /\n *     heartbeat / tools / mcp / extensions)\n *   - `scheduleChannelPluginsAfterPersist` (coalesces rapid saves so\n *     Telegram/Weixin do not stop/start repeatedly)\n *\n * Pulled out so the gateway composition root stays focused on lifecycle, and\n * each handler is reachable from one place when adding a new config section.\n *\n * **Config state ownership.** `GatewayService.config` is still the single\n * source of truth — this coordinator reads it via `getConfig()` and writes it\n * back via `setConfig()` after every reload / persist. We pass through rather\n * than holding our own copy so other coordinators (sessions, marketplace,\n * agent runner) see the latest config the moment a reload commits.\n */\nimport type { Config } from '../../config/schema.js';\nimport type { Config as SurfaceConfig } from '../../config/config-surface.js';\nimport type { AgentService } from '../../agent/service.js';\nimport type { ChannelManager } from '../../channels/manager.js';\nimport type { CronService } from '../../cron/index.js';\nimport type { HeartbeatService } from '../heartbeat/index.js';\nimport type { ExtensionLoader } from '../../extensions/loader.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { ConfigHotReloader } from '../../config/reload.js';\nimport { loadConfig, saveConfig as writeConfigToDisk } from '../../config/index.js';\nimport { sanitizeTunnelConfig } from '../../tunnel/tunnel-config.js';\nimport { getModelRegistry } from '../../providers/index.js';\nimport { disposeAllSessionMcpRuntimes } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { computeBundledExtensionExtensionsPatch } from '../../extensions/bundled-extension-activation.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('GatewayConfigCoordinator');\n\nexport interface GatewayConfigCoordinatorOptions {\n  configPath: string;\n  bus: MessageBus;\n  /** Hot reload (fs.watch) — disabled in tests / certain CLI modes. */\n  enableHotReload: boolean;\n  getConfig: () => Config;\n  /** Writes the new config back into `GatewayService.config`. */\n  setConfig: (next: Config) => void;\n  getAgentService: () => AgentService;\n  getChannelManager: () => ChannelManager;\n  getCronService: () => CronService;\n  getHeartbeatService: () => HeartbeatService | null;\n  getExtensionLoader: () => ExtensionLoader | null;\n  /** Re-evaluate browser-extension server attachment after agent defaults change. */\n  reconcileBrowserExtensionServer: () => Promise<void>;\n  /** Latest channel status snapshot for the `channels.status` SSE event. */\n  getChannelsStatus: () => unknown;\n  /** SSE emit (used for `config.reload` + `channels.status`). */\n  emit: (type: string, payload: unknown) => void;\n}\n\nexport class GatewayConfigCoordinator {\n  private readonly opts: GatewayConfigCoordinatorOptions;\n  private configReloader: ConfigHotReloader | null = null;\n  private channelReloadFlushPromise: Promise<void> | null = null;\n  private channelReloadPending = false;\n\n  constructor(opts: GatewayConfigCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────────────\n\n  /** Start the fs.watch-based reloader (idempotent — only starts once). */\n  startHotReloader(): void {\n    if (this.configReloader) return;\n    this.configReloader = new ConfigHotReloader(\n      this.opts.configPath,\n      this.opts.getConfig(),\n      {\n        onModelsReload: (newConfig) => this.handleModelsReload(newConfig),\n        onAgentDefaultsReload: (newConfig) => this.handleAgentDefaultsReload(newConfig),\n        onChannelsReload: (newConfig) => this.handleChannelsReload(newConfig),\n        onCronReload: (newConfig) => this.handleCronReload(newConfig),\n        onHeartbeatReload: (newConfig) => this.handleHeartbeatReload(newConfig),\n        onToolsReload: (newConfig) => this.handleToolsReload(newConfig),\n        onMcpReload: (newConfig) => this.handleMcpReload(newConfig),\n        onExtensionsReload: async (newConfig, changedPaths) => {\n          await this.handleExtensionsReload(newConfig, changedPaths);\n        },\n        onFullRestart: (newConfig) => {\n          log.warn(\n            { requiresProcessRestart: true, hint: 'Restart the gateway process (hot reload cannot apply this change).' },\n            'Config reload: full gateway restart required — see prior \"restartPaths\" info log',\n          );\n          this.opts.setConfig(newConfig);\n          this.opts.emit('config.reload', { section: 'full', requiresRestart: true });\n        },\n      },\n      {\n        debounceMs: 300,\n        enabled: this.opts.enableHotReload,\n      }\n    );\n    this.configReloader.start();\n  }\n\n  async stopHotReloader(): Promise<void> {\n    if (this.configReloader) {\n      await this.configReloader.stop();\n      this.configReloader = null;\n    }\n  }\n\n  // ── Manual reload (UI trigger) ─────────────────────────────────────────\n\n  async reloadConfig(): Promise<{ reloaded: boolean; error?: string }> {\n    if (!this.configReloader) {\n      return { reloaded: false, error: 'Config reloader not initialized' };\n    }\n    const result = await this.configReloader.triggerReload();\n    return { reloaded: result.success, error: result.error };\n  }\n\n  // ── Persist (PATCH /api/config, marketplace install, etc.) ─────────────\n\n  async saveConfig(config: Config): Promise<{ saved: boolean; error?: string }> {\n    try {\n      await this.writeConfigAndReloadFromDisk(config);\n      this.scheduleChannelPluginsAfterPersist();\n      return { saved: true };\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ err, errorMessage: em, phase: 'infra.config' }, `Failed to save config: ${em}`);\n      return { saved: false, error: em };\n    }\n  }\n\n  /** Merge partial updates into `currentConfig` and persist. */\n  async updateConfig(updates: Partial<Config>): Promise<{ updated: boolean; error?: string }> {\n    try {\n      log.debug('Updating configuration...');\n      const merged = { ...this.opts.getConfig(), ...updates };\n      this.opts.setConfig(merged);\n      await this.writeConfigAndReloadFromDisk(merged);\n      this.scheduleChannelPluginsAfterPersist();\n      log.debug('Configuration updated successfully');\n      return { updated: true };\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ err, errorMessage: em, phase: 'infra.config' }, `Failed to update config: ${em}`);\n      return { updated: false, error: em };\n    }\n  }\n\n  /**\n   * App store (phase 1): persist `extensions.enabled` / `extensions.disabled`\n   * for a bundled extension. Marketplace-only extensions hot-load on enable;\n   * disable still needs a gateway restart to unload.\n   */\n  async setBundledExtensionActivationTarget(\n    extensionId: string,\n    wanted: boolean,\n  ): Promise<{ ok: boolean; error?: string; requiresGatewayRestart: boolean }> {\n    const loader = this.opts.getExtensionLoader();\n    if (!loader) {\n      return { ok: false, error: 'Extension loader unavailable', requiresGatewayRestart: false };\n    }\n    const id = extensionId.trim();\n    if (!id) {\n      return { ok: false, error: 'Invalid extension id', requiresGatewayRestart: false };\n    }\n    const patch = computeBundledExtensionExtensionsPatch(loader, this.opts.getConfig(), id, wanted);\n    if (patch.ok === false) {\n      return { ok: false, error: patch.error, requiresGatewayRestart: false };\n    }\n    const newConfig = { ...this.opts.getConfig(), extensions: patch.extensions } as Config;\n    const saved = await this.saveConfig(newConfig);\n    if (!saved.saved) {\n      return { ok: false, error: saved.error ?? 'Failed to save config', requiresGatewayRestart: false };\n    }\n    loader.setConfig(this.opts.getConfig() as unknown as SurfaceConfig);\n\n    let requiresGatewayRestart = true;\n    if (wanted) {\n      try {\n        loader.invalidateManifestCache();\n        await loader.loadByActivationPlan();\n        requiresGatewayRestart = false;\n      } catch (err) {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, extensionId: id, errorMessage: em },\n          `Extension hot-load after bundled activation failed: ${em}`,\n        );\n        requiresGatewayRestart = true;\n      }\n    }\n\n    this.opts.emit('config.reload', { section: 'extensions', source: 'bundled-activation' });\n    return { ok: true, requiresGatewayRestart };\n  }\n\n  // ── QR-login follow-ups (bypass fs watcher) ────────────────────────────\n\n  async afterWeixinCredentialsPersisted(): Promise<void> {\n    const next = loadConfig(this.opts.configPath);\n    this.opts.setConfig(next);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(next);\n    this.configReloader?.syncCurrentConfig(next);\n    await this.handleChannelsReload(next);\n    const { weixinPlugin } = await import('../../channels/weixin/index.js');\n    await weixinPlugin.reloadMonitorsWithConfig(this.opts.getConfig(), this.opts.bus);\n    log.info('Weixin monitors restarted after credential login');\n  }\n\n  async afterFeishuCredentialsPersisted(): Promise<void> {\n    const next = loadConfig(this.opts.configPath);\n    this.opts.setConfig(next);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(next);\n    this.configReloader?.syncCurrentConfig(next);\n    await this.handleChannelsReload(next);\n    log.info('Feishu config applied after QR setup');\n  }\n\n  // ── Section reload handlers (also used by manual triggers) ─────────────\n\n  /**\n   * Apply `latest.channels` to every registered channel plugin (Telegram,\n   * Weixin, extensions). Single runtime path for: file watcher hot reload, API\n   * saves, and Weixin QR follow-up.\n   */\n  async handleChannelsReload(newConfig: Config): Promise<void> {\n    log.debug('Reloading channels config...');\n    this.opts.setConfig(newConfig);\n    await this.opts.getChannelManager().updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'channels' });\n    this.opts.emit('channels.status', { channels: this.opts.getChannelsStatus() });\n    log.debug('Channels config reloaded');\n  }\n\n  /**\n   * Apply `gateway.heartbeat` from current config after PATCH /api/config (and\n   * when hot reload is off). File watcher uses `handleHeartbeatReload` with\n   * the same effect when paths match.\n   */\n  reloadHeartbeatFromCurrentConfig(): void {\n    this.handleHeartbeatReload(this.opts.getConfig());\n  }\n\n  // ── Internals ──────────────────────────────────────────────────────────\n\n  private handleModelsReload(newConfig: Config): void {\n    log.debug('Reloading models config...');\n    this.opts.setConfig(newConfig);\n    getModelRegistry().refresh();\n    this.opts.emit('config.reload', { section: 'models' });\n    log.debug('Models config reloaded');\n  }\n\n  private handleAgentDefaultsReload(newConfig: Config): void {\n    log.debug('Reloading agent defaults...');\n    this.opts.setConfig(newConfig);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(newConfig);\n    void this.opts.reconcileBrowserExtensionServer();\n    this.opts.emit('config.reload', { section: 'agents' });\n    log.debug('Agent defaults reloaded');\n  }\n\n  /**\n   * Coalesces rapid saves so Telegram/Weixin do not stop/start repeatedly.\n   * The persist path schedules the channel apply; the same coalescer absorbs\n   * follow-up saves until the first flush settles.\n   */\n  private scheduleChannelPluginsAfterPersist(): void {\n    this.channelReloadPending = true;\n    if (this.channelReloadFlushPromise) return;\n    this.channelReloadFlushPromise = (async () => {\n      try {\n        while (this.channelReloadPending) {\n          this.channelReloadPending = false;\n          await this.handleChannelsReload(this.opts.getConfig());\n        }\n      } catch (err) {\n        const em = err instanceof Error ? err.message : String(err);\n        log.error({ err, errorMessage: em }, `Channel reload after persist failed: ${em}`);\n      } finally {\n        this.channelReloadFlushPromise = null;\n        if (this.channelReloadPending) {\n          this.scheduleChannelPluginsAfterPersist();\n        }\n      }\n    })();\n  }\n\n  private handleCronReload(newConfig: Config): void {\n    log.debug('Reloading cron config...');\n    this.opts.setConfig(newConfig);\n    this.opts.getCronService().updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'cron' });\n    log.debug('Cron config reloaded');\n  }\n\n  private handleHeartbeatReload(newConfig: Config): void {\n    log.debug('Reloading heartbeat config...');\n    this.opts.setConfig(newConfig);\n    this.opts.getHeartbeatService()?.updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'heartbeat' });\n    log.debug('Heartbeat config reloaded');\n  }\n\n  private handleToolsReload(newConfig: Config): void {\n    log.debug('Reloading tools config...');\n    this.opts.setConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'tools' });\n    log.debug('Tools config reloaded');\n  }\n\n  private handleMcpReload(newConfig: Config): void {\n    log.debug('Reloading MCP config...');\n    this.opts.setConfig(newConfig);\n    void disposeAllSessionMcpRuntimes().catch((err) => {\n      log.warn({ err }, 'MCP runtime dispose on config reload failed');\n    });\n    this.opts.emit('config.reload', { section: 'mcp' });\n    log.debug('MCP config reloaded');\n  }\n\n  /** Dispatch config hot reload to extensions that registered `registerReload`. */\n  private async handleExtensionsReload(\n    newConfig: Config,\n    changedPaths: string[],\n  ): Promise<void> {\n    this.opts.setConfig(newConfig);\n    const loader = this.opts.getExtensionLoader();\n    loader?.setConfig(newConfig as unknown as SurfaceConfig);\n\n    if (!loader) {\n      this.opts.emit('config.reload', {\n        section: 'extensions',\n        source: 'extension-reload',\n        changedPaths,\n      });\n      return;\n    }\n\n    const registry = loader.getRegistry();\n    const matchingRegs = registry.getMatchingReloadRegistrations(changedPaths);\n\n    if (matchingRegs.length === 0) {\n      log.debug({ changedPaths }, 'No extension reload handlers matched');\n      this.opts.emit('config.reload', {\n        section: 'extensions',\n        source: 'extension-reload',\n        changedPaths,\n      });\n      return;\n    }\n\n    for (const reg of matchingRegs) {\n      const relevantPaths = changedPaths.filter(\n        (p) =>\n          reg.configPrefixes.length === 0 ||\n          reg.configPrefixes.some(\n            (prefix) => p === prefix || p.startsWith(`${prefix}.`),\n          ),\n      );\n\n      log.info(\n        { extensionId: reg.extensionId, relevantPaths },\n        'Calling extension reload handler',\n      );\n\n      try {\n        const result = await reg.handler(newConfig, relevantPaths);\n        if (result.success) {\n          log.info({ extensionId: reg.extensionId }, 'Extension reload succeeded');\n        } else {\n          log.warn(\n            { extensionId: reg.extensionId, error: result.error },\n            `Extension reload reported failure: ${result.error ?? 'unknown'}`,\n          );\n        }\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        log.error(\n          { err, extensionId: reg.extensionId, errorMessage },\n          `Extension reload handler threw: ${errorMessage}`,\n        );\n      }\n    }\n\n    this.opts.emit('config.reload', {\n      section: 'extensions',\n      source: 'extension-reload',\n      changedPaths,\n    });\n  }\n\n  /**\n   * Persist and replace `currentConfig` with the validated file contents so\n   * runtime matches disk (PATCH merge objects can drift from Zod-normalized\n   * output).\n   */\n  private async writeConfigAndReloadFromDisk(configToWrite: Config): Promise<void> {\n    await writeConfigToDisk(configToWrite, this.opts.configPath);\n    const reloaded = loadConfig(this.opts.configPath);\n    this.opts.setConfig(reloaded);\n    if (sanitizeTunnelConfig(reloaded)) {\n      await writeConfigToDisk(reloaded, this.opts.configPath);\n    }\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(reloaded);\n    await this.opts.reconcileBrowserExtensionServer();\n    // Hot-apply: reconcile managed dreaming cron jobs immediately after config persists.\n    await this.opts.getAgentService().reconcileDreamingNow().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Dreaming cron reconcile after save failed: ${em}`);\n    });\n    // Align watcher baseline before channel hooks run so fs `change` does not\n    // re-apply the same diff concurrently.\n    this.configReloader?.syncCurrentConfig(reloaded);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"config-coordinator.js","names":["writeConfigToDisk"],"sources":["../../../../src/gateway/service/config-coordinator.ts"],"sourcesContent":["/**\n * GatewayConfigCoordinator — owns config persistence, hot-reload, and the\n * per-section reload handlers.\n *\n * Was 350 lines of `GatewayService` covering nine concerns:\n *   - manual `reloadConfig()` (CLI/UI trigger)\n *   - `saveConfig()` / `updateConfig()` (PATCH /api/config)\n *   - `setBundledExtensionActivationTarget` (extension store install)\n *   - `afterWeixinCredentialsPersisted` / `afterFeishuCredentialsPersisted`\n *     (QR-login follow-ups that bypass the watcher)\n *   - `ConfigHotReloader` (fs.watch → debounced per-section dispatch)\n *   - Section reload handlers (models / agents / channels /\n *     heartbeat / tools / mcp / extensions)\n *   - `scheduleChannelPluginsAfterPersist` (coalesces rapid saves so\n *     Telegram/Weixin do not stop/start repeatedly)\n *\n * Pulled out so the gateway composition root stays focused on lifecycle, and\n * each handler is reachable from one place when adding a new config section.\n *\n * **Config state ownership.** `GatewayService.config` is still the single\n * source of truth — this coordinator reads it via `getConfig()` and writes it\n * back via `setConfig()` after every reload / persist. We pass through rather\n * than holding our own copy so other coordinators (sessions, marketplace,\n * agent runner) see the latest config the moment a reload commits.\n */\nimport type { Config } from '../../config/schema.js';\nimport type { Config as SurfaceConfig } from '../../config/config-surface.js';\nimport type { AgentService } from '../../agent/service.js';\nimport type { ChannelManager } from '../../channels/manager.js';\nimport type { HeartbeatService } from '../heartbeat/index.js';\nimport type { ExtensionLoader } from '../../extensions/loader.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { ConfigHotReloader } from '../../config/reload.js';\nimport { loadConfig, saveConfig as writeConfigToDisk } from '../../config/index.js';\nimport { sanitizeTunnelConfig } from '../../tunnel/tunnel-config.js';\nimport { getModelRegistry } from '../../providers/index.js';\nimport { disposeAllSessionMcpRuntimes } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { computeBundledExtensionExtensionsPatch } from '../../extensions/bundled-extension-activation.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('GatewayConfigCoordinator');\n\nexport interface GatewayConfigCoordinatorOptions {\n  configPath: string;\n  bus: MessageBus;\n  /** Hot reload (fs.watch) — disabled in tests / certain CLI modes. */\n  enableHotReload: boolean;\n  getConfig: () => Config;\n  /** Writes the new config back into `GatewayService.config`. */\n  setConfig: (next: Config) => void;\n  getAgentService: () => AgentService;\n  getChannelManager: () => ChannelManager;\n  getHeartbeatService: () => HeartbeatService | null;\n  getExtensionLoader: () => ExtensionLoader | null;\n  /** Re-evaluate browser-extension server attachment after agent defaults change. */\n  reconcileBrowserExtensionServer: () => Promise<void>;\n  /** Sync built-in dreaming automations after memory.dreaming changes. */\n  reconcileDreamingAutomations: () => Promise<void>;\n  /** Latest channel status snapshot for the `channels.status` SSE event. */\n  getChannelsStatus: () => unknown;\n  /** SSE emit (used for `config.reload` + `channels.status`). */\n  emit: (type: string, payload: unknown) => void;\n}\n\nexport class GatewayConfigCoordinator {\n  private readonly opts: GatewayConfigCoordinatorOptions;\n  private configReloader: ConfigHotReloader | null = null;\n  private channelReloadFlushPromise: Promise<void> | null = null;\n  private channelReloadPending = false;\n\n  constructor(opts: GatewayConfigCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────────────\n\n  /** Start the fs.watch-based reloader (idempotent — only starts once). */\n  startHotReloader(): void {\n    if (this.configReloader) return;\n    this.configReloader = new ConfigHotReloader(\n      this.opts.configPath,\n      this.opts.getConfig(),\n      {\n        onModelsReload: (newConfig) => this.handleModelsReload(newConfig),\n        onAgentDefaultsReload: (newConfig) => this.handleAgentDefaultsReload(newConfig),\n        onChannelsReload: (newConfig) => this.handleChannelsReload(newConfig),\n        onCronReload: (newConfig) => this.handleAutomationReload(newConfig),\n        onHeartbeatReload: (newConfig) => this.handleHeartbeatReload(newConfig),\n        onToolsReload: (newConfig) => this.handleToolsReload(newConfig),\n        onMcpReload: (newConfig) => this.handleMcpReload(newConfig),\n        onExtensionsReload: async (newConfig, changedPaths) => {\n          await this.handleExtensionsReload(newConfig, changedPaths);\n        },\n        onFullRestart: (newConfig) => {\n          log.warn(\n            { requiresProcessRestart: true, hint: 'Restart the gateway process (hot reload cannot apply this change).' },\n            'Config reload: full gateway restart required — see prior \"restartPaths\" info log',\n          );\n          this.opts.setConfig(newConfig);\n          this.opts.emit('config.reload', { section: 'full', requiresRestart: true });\n        },\n      },\n      {\n        debounceMs: 300,\n        enabled: this.opts.enableHotReload,\n      }\n    );\n    this.configReloader.start();\n  }\n\n  async stopHotReloader(): Promise<void> {\n    if (this.configReloader) {\n      await this.configReloader.stop();\n      this.configReloader = null;\n    }\n  }\n\n  // ── Manual reload (UI trigger) ─────────────────────────────────────────\n\n  async reloadConfig(): Promise<{ reloaded: boolean; error?: string }> {\n    if (!this.configReloader) {\n      return { reloaded: false, error: 'Config reloader not initialized' };\n    }\n    const result = await this.configReloader.triggerReload();\n    return { reloaded: result.success, error: result.error };\n  }\n\n  // ── Persist (PATCH /api/config, marketplace install, etc.) ─────────────\n\n  async saveConfig(config: Config): Promise<{ saved: boolean; error?: string }> {\n    try {\n      await this.writeConfigAndReloadFromDisk(config);\n      this.scheduleChannelPluginsAfterPersist();\n      return { saved: true };\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ err, errorMessage: em, phase: 'infra.config' }, `Failed to save config: ${em}`);\n      return { saved: false, error: em };\n    }\n  }\n\n  /** Merge partial updates into `currentConfig` and persist. */\n  async updateConfig(updates: Partial<Config>): Promise<{ updated: boolean; error?: string }> {\n    try {\n      log.debug('Updating configuration...');\n      const merged = { ...this.opts.getConfig(), ...updates };\n      this.opts.setConfig(merged);\n      await this.writeConfigAndReloadFromDisk(merged);\n      this.scheduleChannelPluginsAfterPersist();\n      log.debug('Configuration updated successfully');\n      return { updated: true };\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ err, errorMessage: em, phase: 'infra.config' }, `Failed to update config: ${em}`);\n      return { updated: false, error: em };\n    }\n  }\n\n  /**\n   * App store (phase 1): persist `extensions.enabled` / `extensions.disabled`\n   * for a bundled extension. Marketplace-only extensions hot-load on enable;\n   * disable still needs a gateway restart to unload.\n   */\n  async setBundledExtensionActivationTarget(\n    extensionId: string,\n    wanted: boolean,\n  ): Promise<{ ok: boolean; error?: string; requiresGatewayRestart: boolean }> {\n    const loader = this.opts.getExtensionLoader();\n    if (!loader) {\n      return { ok: false, error: 'Extension loader unavailable', requiresGatewayRestart: false };\n    }\n    const id = extensionId.trim();\n    if (!id) {\n      return { ok: false, error: 'Invalid extension id', requiresGatewayRestart: false };\n    }\n    const patch = computeBundledExtensionExtensionsPatch(loader, this.opts.getConfig(), id, wanted);\n    if (patch.ok === false) {\n      return { ok: false, error: patch.error, requiresGatewayRestart: false };\n    }\n    const newConfig = { ...this.opts.getConfig(), extensions: patch.extensions } as Config;\n    const saved = await this.saveConfig(newConfig);\n    if (!saved.saved) {\n      return { ok: false, error: saved.error ?? 'Failed to save config', requiresGatewayRestart: false };\n    }\n    loader.setConfig(this.opts.getConfig() as unknown as SurfaceConfig);\n\n    let requiresGatewayRestart = true;\n    if (wanted) {\n      try {\n        loader.invalidateManifestCache();\n        await loader.loadByActivationPlan();\n        requiresGatewayRestart = false;\n      } catch (err) {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, extensionId: id, errorMessage: em },\n          `Extension hot-load after bundled activation failed: ${em}`,\n        );\n        requiresGatewayRestart = true;\n      }\n    }\n\n    this.opts.emit('config.reload', { section: 'extensions', source: 'bundled-activation' });\n    return { ok: true, requiresGatewayRestart };\n  }\n\n  // ── QR-login follow-ups (bypass fs watcher) ────────────────────────────\n\n  async afterWeixinCredentialsPersisted(): Promise<void> {\n    const next = loadConfig(this.opts.configPath);\n    this.opts.setConfig(next);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(next);\n    this.configReloader?.syncCurrentConfig(next);\n    await this.handleChannelsReload(next);\n    const { weixinPlugin } = await import('../../channels/weixin/index.js');\n    await weixinPlugin.reloadMonitorsWithConfig(this.opts.getConfig(), this.opts.bus);\n    log.info('Weixin monitors restarted after credential login');\n  }\n\n  async afterFeishuCredentialsPersisted(): Promise<void> {\n    const next = loadConfig(this.opts.configPath);\n    this.opts.setConfig(next);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(next);\n    this.configReloader?.syncCurrentConfig(next);\n    await this.handleChannelsReload(next);\n    log.info('Feishu config applied after QR setup');\n  }\n\n  // ── Section reload handlers (also used by manual triggers) ─────────────\n\n  /**\n   * Apply `latest.channels` to every registered channel plugin (Telegram,\n   * Weixin, extensions). Single runtime path for: file watcher hot reload, API\n   * saves, and Weixin QR follow-up.\n   */\n  async handleChannelsReload(newConfig: Config): Promise<void> {\n    log.debug('Reloading channels config...');\n    this.opts.setConfig(newConfig);\n    await this.opts.getChannelManager().updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'channels' });\n    this.opts.emit('channels.status', { channels: this.opts.getChannelsStatus() });\n    log.debug('Channels config reloaded');\n  }\n\n  /**\n   * Apply `gateway.heartbeat` from current config after PATCH /api/config (and\n   * when hot reload is off). File watcher uses `handleHeartbeatReload` with\n   * the same effect when paths match.\n   */\n  reloadHeartbeatFromCurrentConfig(): void {\n    this.handleHeartbeatReload(this.opts.getConfig());\n  }\n\n  // ── Internals ──────────────────────────────────────────────────────────\n\n  private handleModelsReload(newConfig: Config): void {\n    log.debug('Reloading models config...');\n    this.opts.setConfig(newConfig);\n    getModelRegistry().refresh();\n    this.opts.emit('config.reload', { section: 'models' });\n    log.debug('Models config reloaded');\n  }\n\n  private handleAgentDefaultsReload(newConfig: Config): void {\n    log.debug('Reloading agent defaults...');\n    this.opts.setConfig(newConfig);\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(newConfig);\n    void this.opts.reconcileBrowserExtensionServer();\n    void this.opts.reconcileDreamingAutomations().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Dreaming automation refresh failed: ${em}`);\n    });\n    this.opts.emit('config.reload', { section: 'agents' });\n    log.debug('Agent defaults reloaded');\n  }\n\n  /**\n   * Coalesces rapid saves so Telegram/Weixin do not stop/start repeatedly.\n   * The persist path schedules the channel apply; the same coalescer absorbs\n   * follow-up saves until the first flush settles.\n   */\n  private scheduleChannelPluginsAfterPersist(): void {\n    this.channelReloadPending = true;\n    if (this.channelReloadFlushPromise) return;\n    this.channelReloadFlushPromise = (async () => {\n      try {\n        while (this.channelReloadPending) {\n          this.channelReloadPending = false;\n          await this.handleChannelsReload(this.opts.getConfig());\n        }\n      } catch (err) {\n        const em = err instanceof Error ? err.message : String(err);\n        log.error({ err, errorMessage: em }, `Channel reload after persist failed: ${em}`);\n      } finally {\n        this.channelReloadFlushPromise = null;\n        if (this.channelReloadPending) {\n          this.scheduleChannelPluginsAfterPersist();\n        }\n      }\n    })();\n  }\n\n  private handleAutomationReload(newConfig: Config): void {\n    log.debug('Reloading automation-related config...');\n    this.opts.setConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'automations' });\n    log.debug('Automation-related config reloaded');\n  }\n\n  private handleHeartbeatReload(newConfig: Config): void {\n    log.debug('Reloading heartbeat config...');\n    this.opts.setConfig(newConfig);\n    this.opts.getHeartbeatService()?.updateConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'heartbeat' });\n    log.debug('Heartbeat config reloaded');\n  }\n\n  private handleToolsReload(newConfig: Config): void {\n    log.debug('Reloading tools config...');\n    this.opts.setConfig(newConfig);\n    this.opts.emit('config.reload', { section: 'tools' });\n    log.debug('Tools config reloaded');\n  }\n\n  private handleMcpReload(newConfig: Config): void {\n    log.debug('Reloading MCP config...');\n    this.opts.setConfig(newConfig);\n    void disposeAllSessionMcpRuntimes().catch((err) => {\n      log.warn({ err }, 'MCP runtime dispose on config reload failed');\n    });\n    this.opts.emit('config.reload', { section: 'mcp' });\n    log.debug('MCP config reloaded');\n  }\n\n  /** Dispatch config hot reload to extensions that registered `registerReload`. */\n  private async handleExtensionsReload(\n    newConfig: Config,\n    changedPaths: string[],\n  ): Promise<void> {\n    this.opts.setConfig(newConfig);\n    const loader = this.opts.getExtensionLoader();\n    loader?.setConfig(newConfig as unknown as SurfaceConfig);\n\n    if (!loader) {\n      this.opts.emit('config.reload', {\n        section: 'extensions',\n        source: 'extension-reload',\n        changedPaths,\n      });\n      return;\n    }\n\n    const registry = loader.getRegistry();\n    const matchingRegs = registry.getMatchingReloadRegistrations(changedPaths);\n\n    if (matchingRegs.length === 0) {\n      log.debug({ changedPaths }, 'No extension reload handlers matched');\n      this.opts.emit('config.reload', {\n        section: 'extensions',\n        source: 'extension-reload',\n        changedPaths,\n      });\n      return;\n    }\n\n    for (const reg of matchingRegs) {\n      const relevantPaths = changedPaths.filter(\n        (p) =>\n          reg.configPrefixes.length === 0 ||\n          reg.configPrefixes.some(\n            (prefix) => p === prefix || p.startsWith(`${prefix}.`),\n          ),\n      );\n\n      log.info(\n        { extensionId: reg.extensionId, relevantPaths },\n        'Calling extension reload handler',\n      );\n\n      try {\n        const result = await reg.handler(newConfig, relevantPaths);\n        if (result.success) {\n          log.info({ extensionId: reg.extensionId }, 'Extension reload succeeded');\n        } else {\n          log.warn(\n            { extensionId: reg.extensionId, error: result.error },\n            `Extension reload reported failure: ${result.error ?? 'unknown'}`,\n          );\n        }\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        log.error(\n          { err, extensionId: reg.extensionId, errorMessage },\n          `Extension reload handler threw: ${errorMessage}`,\n        );\n      }\n    }\n\n    this.opts.emit('config.reload', {\n      section: 'extensions',\n      source: 'extension-reload',\n      changedPaths,\n    });\n  }\n\n  /**\n   * Persist and replace `currentConfig` with the validated file contents so\n   * runtime matches disk (PATCH merge objects can drift from Zod-normalized\n   * output).\n   */\n  private async writeConfigAndReloadFromDisk(configToWrite: Config): Promise<void> {\n    await writeConfigToDisk(configToWrite, this.opts.configPath);\n    const reloaded = loadConfig(this.opts.configPath);\n    this.opts.setConfig(reloaded);\n    if (sanitizeTunnelConfig(reloaded)) {\n      await writeConfigToDisk(reloaded, this.opts.configPath);\n    }\n    this.opts.getAgentService().applyAgentDefaultsFromConfig(reloaded);\n    await this.opts.reconcileBrowserExtensionServer();\n    // Keep built-in dreaming automations aligned with memory.dreaming.\n    await this.opts.reconcileDreamingAutomations().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Dreaming automation refresh after save failed: ${em}`);\n    });\n    // Align watcher baseline before channel hooks run so fs `change` does not\n    // re-apply the same diff concurrently.\n    this.configReloader?.syncCurrentConfig(reloaded);\n  }\n}\n"],"mappings":";;;;;;;;;;;;gBAmC4D;aAGP;AAErD,MAAM,MAAM,aAAa,2BAA2B;AAwBpD,IAAa,2BAAb,MAAsC;CACpC;CACA,iBAAmD;CACnD,4BAA0D;CAC1D,uBAA+B;CAE/B,YAAY,MAAuC;AACjD,OAAK,OAAO;;;CAMd,mBAAyB;AACvB,MAAI,KAAK,eAAgB;AACzB,OAAK,iBAAiB,IAAI,kBACxB,KAAK,KAAK,YACV,KAAK,KAAK,WAAW,EACrB;GACE,iBAAiB,cAAc,KAAK,mBAAmB,UAAU;GACjE,wBAAwB,cAAc,KAAK,0BAA0B,UAAU;GAC/E,mBAAmB,cAAc,KAAK,qBAAqB,UAAU;GACrE,eAAe,cAAc,KAAK,uBAAuB,UAAU;GACnE,oBAAoB,cAAc,KAAK,sBAAsB,UAAU;GACvE,gBAAgB,cAAc,KAAK,kBAAkB,UAAU;GAC/D,cAAc,cAAc,KAAK,gBAAgB,UAAU;GAC3D,oBAAoB,OAAO,WAAW,iBAAiB;AACrD,UAAM,KAAK,uBAAuB,WAAW,aAAa;;GAE5D,gBAAgB,cAAc;AAC5B,QAAI,KACF;KAAE,wBAAwB;KAAM,MAAM;KAAsE,EAC5G,qFACD;AACD,SAAK,KAAK,UAAU,UAAU;AAC9B,SAAK,KAAK,KAAK,iBAAiB;KAAE,SAAS;KAAQ,iBAAiB;KAAM,CAAC;;GAE9E,EACD;GACE,YAAY;GACZ,SAAS,KAAK,KAAK;GACpB,CACF;AACD,OAAK,eAAe,OAAO;;CAG7B,MAAM,kBAAiC;AACrC,MAAI,KAAK,gBAAgB;AACvB,SAAM,KAAK,eAAe,MAAM;AAChC,QAAK,iBAAiB;;;CAM1B,MAAM,eAA+D;AACnE,MAAI,CAAC,KAAK,eACR,QAAO;GAAE,UAAU;GAAO,OAAO;GAAmC;EAEtE,MAAM,SAAS,MAAM,KAAK,eAAe,eAAe;AACxD,SAAO;GAAE,UAAU,OAAO;GAAS,OAAO,OAAO;GAAO;;CAK1D,MAAM,WAAW,QAA6D;AAC5E,MAAI;AACF,SAAM,KAAK,6BAA6B,OAAO;AAC/C,QAAK,oCAAoC;AACzC,UAAO,EAAE,OAAO,MAAM;WACf,KAAK;GACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,MAAM;IAAE;IAAK,cAAc;IAAI,OAAO;IAAgB,EAAE,0BAA0B,KAAK;AAC3F,UAAO;IAAE,OAAO;IAAO,OAAO;IAAI;;;;CAKtC,MAAM,aAAa,SAAyE;AAC1F,MAAI;AACF,OAAI,MAAM,4BAA4B;GACtC,MAAM,SAAS;IAAE,GAAG,KAAK,KAAK,WAAW;IAAE,GAAG;IAAS;AACvD,QAAK,KAAK,UAAU,OAAO;AAC3B,SAAM,KAAK,6BAA6B,OAAO;AAC/C,QAAK,oCAAoC;AACzC,OAAI,MAAM,qCAAqC;AAC/C,UAAO,EAAE,SAAS,MAAM;WACjB,KAAK;GACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,MAAM;IAAE;IAAK,cAAc;IAAI,OAAO;IAAgB,EAAE,4BAA4B,KAAK;AAC7F,UAAO;IAAE,SAAS;IAAO,OAAO;IAAI;;;;;;;;CASxC,MAAM,oCACJ,aACA,QAC2E;EAC3E,MAAM,SAAS,KAAK,KAAK,oBAAoB;AAC7C,MAAI,CAAC,OACH,QAAO;GAAE,IAAI;GAAO,OAAO;GAAgC,wBAAwB;GAAO;EAE5F,MAAM,KAAK,YAAY,MAAM;AAC7B,MAAI,CAAC,GACH,QAAO;GAAE,IAAI;GAAO,OAAO;GAAwB,wBAAwB;GAAO;EAEpF,MAAM,QAAQ,uCAAuC,QAAQ,KAAK,KAAK,WAAW,EAAE,IAAI,OAAO;AAC/F,MAAI,MAAM,OAAO,MACf,QAAO;GAAE,IAAI;GAAO,OAAO,MAAM;GAAO,wBAAwB;GAAO;EAEzE,MAAM,YAAY;GAAE,GAAG,KAAK,KAAK,WAAW;GAAE,YAAY,MAAM;GAAY;EAC5E,MAAM,QAAQ,MAAM,KAAK,WAAW,UAAU;AAC9C,MAAI,CAAC,MAAM,MACT,QAAO;GAAE,IAAI;GAAO,OAAO,MAAM,SAAS;GAAyB,wBAAwB;GAAO;AAEpG,SAAO,UAAU,KAAK,KAAK,WAAW,CAA6B;EAEnE,IAAI,yBAAyB;AAC7B,MAAI,OACF,KAAI;AACF,UAAO,yBAAyB;AAChC,SAAM,OAAO,sBAAsB;AACnC,4BAAyB;WAClB,KAAK;GACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,KACF;IAAE;IAAK,aAAa;IAAI,cAAc;IAAI,EAC1C,uDAAuD,KACxD;AACD,4BAAyB;;AAI7B,OAAK,KAAK,KAAK,iBAAiB;GAAE,SAAS;GAAc,QAAQ;GAAsB,CAAC;AACxF,SAAO;GAAE,IAAI;GAAM;GAAwB;;CAK7C,MAAM,kCAAiD;EACrD,MAAM,OAAO,WAAW,KAAK,KAAK,WAAW;AAC7C,OAAK,KAAK,UAAU,KAAK;AACzB,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,KAAK;AAC9D,OAAK,gBAAgB,kBAAkB,KAAK;AAC5C,QAAM,KAAK,qBAAqB,KAAK;EACrC,MAAM,EAAE,iBAAiB,MAAM,OAAO;AACtC,QAAM,aAAa,yBAAyB,KAAK,KAAK,WAAW,EAAE,KAAK,KAAK,IAAI;AACjF,MAAI,KAAK,mDAAmD;;CAG9D,MAAM,kCAAiD;EACrD,MAAM,OAAO,WAAW,KAAK,KAAK,WAAW;AAC7C,OAAK,KAAK,UAAU,KAAK;AACzB,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,KAAK;AAC9D,OAAK,gBAAgB,kBAAkB,KAAK;AAC5C,QAAM,KAAK,qBAAqB,KAAK;AACrC,MAAI,KAAK,uCAAuC;;;;;;;CAUlD,MAAM,qBAAqB,WAAkC;AAC3D,MAAI,MAAM,+BAA+B;AACzC,OAAK,KAAK,UAAU,UAAU;AAC9B,QAAM,KAAK,KAAK,mBAAmB,CAAC,aAAa,UAAU;AAC3D,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,YAAY,CAAC;AACxD,OAAK,KAAK,KAAK,mBAAmB,EAAE,UAAU,KAAK,KAAK,mBAAmB,EAAE,CAAC;AAC9E,MAAI,MAAM,2BAA2B;;;;;;;CAQvC,mCAAyC;AACvC,OAAK,sBAAsB,KAAK,KAAK,WAAW,CAAC;;CAKnD,mBAA2B,WAAyB;AAClD,MAAI,MAAM,6BAA6B;AACvC,OAAK,KAAK,UAAU,UAAU;AAC9B,oBAAkB,CAAC,SAAS;AAC5B,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,UAAU,CAAC;AACtD,MAAI,MAAM,yBAAyB;;CAGrC,0BAAkC,WAAyB;AACzD,MAAI,MAAM,8BAA8B;AACxC,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,UAAU;AAC9D,OAAK,KAAK,iCAAiC;AAC3C,OAAK,KAAK,8BAA8B,CAAC,OAAO,QAAQ;GAC3D,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,KAAK;IAAE;IAAK,cAAc;IAAI,EAAE,uCAAuC,KAAK;IAChF;AACF,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,UAAU,CAAC;AACtD,MAAI,MAAM,0BAA0B;;;;;;;CAQtC,qCAAmD;AACjD,OAAK,uBAAuB;AAC5B,MAAI,KAAK,0BAA2B;AACpC,OAAK,6BAA6B,YAAY;AAC5C,OAAI;AACF,WAAO,KAAK,sBAAsB;AAChC,UAAK,uBAAuB;AAC5B,WAAM,KAAK,qBAAqB,KAAK,KAAK,WAAW,CAAC;;YAEjD,KAAK;IACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,QAAI,MAAM;KAAE;KAAK,cAAc;KAAI,EAAE,wCAAwC,KAAK;aAC1E;AACR,SAAK,4BAA4B;AACjC,QAAI,KAAK,qBACP,MAAK,oCAAoC;;MAG3C;;CAGN,uBAA+B,WAAyB;AACtD,MAAI,MAAM,yCAAyC;AACnD,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,eAAe,CAAC;AAC3D,MAAI,MAAM,qCAAqC;;CAGjD,sBAA8B,WAAyB;AACrD,MAAI,MAAM,gCAAgC;AAC1C,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,qBAAqB,EAAE,aAAa,UAAU;AACxD,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,aAAa,CAAC;AACzD,MAAI,MAAM,4BAA4B;;CAGxC,kBAA0B,WAAyB;AACjD,MAAI,MAAM,4BAA4B;AACtC,OAAK,KAAK,UAAU,UAAU;AAC9B,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,SAAS,CAAC;AACrD,MAAI,MAAM,wBAAwB;;CAGpC,gBAAwB,WAAyB;AAC/C,MAAI,MAAM,0BAA0B;AACpC,OAAK,KAAK,UAAU,UAAU;AACzB,gCAA8B,CAAC,OAAO,QAAQ;AACjD,OAAI,KAAK,EAAE,KAAK,EAAE,8CAA8C;IAChE;AACF,OAAK,KAAK,KAAK,iBAAiB,EAAE,SAAS,OAAO,CAAC;AACnD,MAAI,MAAM,sBAAsB;;;CAIlC,MAAc,uBACZ,WACA,cACe;AACf,OAAK,KAAK,UAAU,UAAU;EAC9B,MAAM,SAAS,KAAK,KAAK,oBAAoB;AAC7C,UAAQ,UAAU,UAAsC;AAExD,MAAI,CAAC,QAAQ;AACX,QAAK,KAAK,KAAK,iBAAiB;IAC9B,SAAS;IACT,QAAQ;IACR;IACD,CAAC;AACF;;EAIF,MAAM,eADW,OAAO,aACK,CAAC,+BAA+B,aAAa;AAE1E,MAAI,aAAa,WAAW,GAAG;AAC7B,OAAI,MAAM,EAAE,cAAc,EAAE,uCAAuC;AACnE,QAAK,KAAK,KAAK,iBAAiB;IAC9B,SAAS;IACT,QAAQ;IACR;IACD,CAAC;AACF;;AAGF,OAAK,MAAM,OAAO,cAAc;GAC9B,MAAM,gBAAgB,aAAa,QAChC,MACC,IAAI,eAAe,WAAW,KAC9B,IAAI,eAAe,MAChB,WAAW,MAAM,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,CACvD,CACJ;AAED,OAAI,KACF;IAAE,aAAa,IAAI;IAAa;IAAe,EAC/C,mCACD;AAED,OAAI;IACF,MAAM,SAAS,MAAM,IAAI,QAAQ,WAAW,cAAc;AAC1D,QAAI,OAAO,QACT,KAAI,KAAK,EAAE,aAAa,IAAI,aAAa,EAAE,6BAA6B;QAExE,KAAI,KACF;KAAE,aAAa,IAAI;KAAa,OAAO,OAAO;KAAO,EACrD,sCAAsC,OAAO,SAAS,YACvD;YAEI,KAAK;IACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACrE,QAAI,MACF;KAAE;KAAK,aAAa,IAAI;KAAa;KAAc,EACnD,mCAAmC,eACpC;;;AAIL,OAAK,KAAK,KAAK,iBAAiB;GAC9B,SAAS;GACT,QAAQ;GACR;GACD,CAAC;;;;;;;CAQJ,MAAc,6BAA6B,eAAsC;AAC/E,QAAMA,WAAkB,eAAe,KAAK,KAAK,WAAW;EAC5D,MAAM,WAAW,WAAW,KAAK,KAAK,WAAW;AACjD,OAAK,KAAK,UAAU,SAAS;AAC7B,MAAI,qBAAqB,SAAS,CAChC,OAAMA,WAAkB,UAAU,KAAK,KAAK,WAAW;AAEzD,OAAK,KAAK,iBAAiB,CAAC,6BAA6B,SAAS;AAClE,QAAM,KAAK,KAAK,iCAAiC;AAEjD,QAAM,KAAK,KAAK,8BAA8B,CAAC,OAAO,QAAQ;GAC5D,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,KAAK;IAAE;IAAK,cAAc;IAAI,EAAE,kDAAkD,KAAK;IAC3F;AAGF,OAAK,gBAAgB,kBAAkB,SAAS"}

package/dist/src/gateway/service/sessions-api.d.ts

@@ -64,6 +64,7 @@ export declare class GatewaySessionsApi {
             nextBeforeCursor?: string;
         };
     }>;
+    getTimeline(key: string): Promise<import("../../session/transcript-outline.js").SessionTimelineItem[]>;
     patch(key: string, body: SessionPatchBody): Promise<{
         ok: true;
     } | {
@@ -142,7 +143,7 @@ export declare class GatewaySessionsApi {
     }>;
     stats(): Promise<import("../../session/types.js").GlobalSessionStats>;
     /**
-     * Distinct chat-id pairs from sessions, grouped by channel. Used by cron job
+     * Distinct chat-id pairs from sessions, grouped by channel. Used by automation
      * configuration UI to seed the "send to existing chat" picker.
      */
     chatIds(channel?: string): Promise<Array<{

package/dist/src/gateway/service/sessions-api.js

@@ -1,5 +1,6 @@
 import { retireSessionMcpRuntimeForSessionKey } from "../../agent/mcp/bundle-mcp-runtime.js";
 import "../../agent/mcp/bundle-mcp-tools.js";
+import { buildSessionTimeline } from "../../session/transcript-outline.js";
 import { collectMediaUrisFromMessages, deleteMediaUris } from "../../media/session-references.js";
 import { getDistinctSessionChatIds } from "./session-chat-ids.js";
 import { performSessionReset } from "../session-reset-service.js";
@@ -44,6 +45,10 @@ var GatewaySessionsApi = class {
 	getMessagePage(key, options) {
 		return this.opts.sessionIndex.getSessionMessagePage(key, options);
 	}
+	async getTimeline(key) {
+		if (!await this.opts.sessionIndex.getSessionMetadata(key)) return null;
+		return buildSessionTimeline(await this.opts.sessionIndex.getStore().loadTranscriptRows(key));
+	}
 	patch(key, body) {
 		return this.opts.sessionIndex.patchSession(key, body);
 	}
@@ -156,7 +161,7 @@ var GatewaySessionsApi = class {
 		return this.opts.sessionIndex.getStats();
 	}
 	/**
-	* Distinct chat-id pairs from sessions, grouped by channel. Used by cron job
+	* Distinct chat-id pairs from sessions, grouped by channel. Used by automation
 	* configuration UI to seed the "send to existing chat" picker.
 	*/
 	chatIds(channel) {

package/dist/src/gateway/service/sessions-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessions-api.js","names":[],"sources":["../../../../src/gateway/service/sessions-api.ts"],"sourcesContent":["/**\n * GatewaySessionsApi — session CRUD, search, compaction, tag/pin/archive,\n * stats, and chat-id grouping for the gateway REST surface.\n *\n * Twenty-four methods, previously sitting on `GatewayService` as a mix of\n * one-line `sessionIndex.*` delegations and small composite operations (e.g.\n * `restoreCheckpoint` also evicts the in-memory agent, `runCompaction` also\n * appends a transcript context entry). Centralising them here lets routes\n * depend on the narrow `GatewaySessionsApi` surface instead of the full\n * `GatewayService`, and keeps the gateway composition root focused on\n * lifecycle + wiring.\n */\n\nimport type { AgentService } from '../../agent/service.js';\nimport type { CompactionResult } from '../../agent/memory/compaction.js';\nimport { retireSessionMcpRuntimeForSessionKey } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { SessionIndex } from '../../session/index.js';\nimport type { ExportFormat, SessionListQuery } from '../../session/types.js';\nimport type { SessionPatchBody } from '../../session/patch-metadata.js';\nimport { collectMediaUrisFromMessages, deleteMediaUris } from '../../media/session-references.js';\nimport { getDistinctSessionChatIds } from './session-chat-ids.js';\nimport { performSessionReset, type SessionResetResult } from '../session-reset-service.js';\n\nexport interface GatewaySessionsApiOptions {\n  sessionIndex: SessionIndex;\n  /** Resolves the live agent service (created lazily; throws if gateway is starting). */\n  getAgentService: () => AgentService;\n  /** Read-only view of in-flight webchat runs (per session key → run id). */\n  getActiveWebchatRunId: (sessionKey: string) => string | undefined;\n}\n\nexport class GatewaySessionsApi {\n  private readonly opts: GatewaySessionsApiOptions;\n\n  constructor(opts: GatewaySessionsApiOptions) {\n    this.opts = opts;\n  }\n\n  // ── List / get ─────────────────────────────────────────────────────────\n\n  listSessions(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSessions(query);\n  }\n\n  /** Subagent sessions have keys starting with `subagent:`. */\n  listSubagents(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSubagents(query);\n  }\n\n  getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ) {\n    return this.opts.sessionIndex.getSession(key, options);\n  }\n\n  async resolveSession(input: {\n    key?: string;\n    sessionKey?: string;\n    sessionId?: string;\n  }): Promise<\n    | {\n        sessionKey: string;\n        sessionId: string;\n        session: Awaited<ReturnType<GatewaySessionsApi['getSession']>>;\n      }\n    | null\n  > {\n    const explicitKey = input.sessionKey?.trim() || input.key?.trim();\n    const resolvedKey =\n      explicitKey ||\n      (input.sessionId?.trim()\n        ? await this.opts.sessionIndex.resolveSessionKeyBySessionId(input.sessionId.trim())\n        : null);\n    if (!resolvedKey) {\n      return null;\n    }\n    const session = await this.getSession(resolvedKey);\n    if (!session?.sessionId) {\n      return null;\n    }\n    return { sessionKey: resolvedKey, sessionId: session.sessionId, session };\n  }\n\n  /** Read-only: in-flight webchat agent run for this session key, if any. */\n  getActiveRun(sessionKey: string): { active: boolean; runId?: string } {\n    const key = sessionKey.trim();\n    if (!key) return { active: false };\n    const runId = this.opts.getActiveWebchatRunId(key)?.trim();\n    if (!runId) return { active: false };\n    return { active: true, runId };\n  }\n\n  getMessagePage(\n    key: string,\n    options?: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    },\n  ) {\n    return this.opts.sessionIndex.getSessionMessagePage(key, options);\n  }\n\n  // ── Metadata patches ──────────────────────────────────────────────────\n\n  patch(key: string, body: SessionPatchBody): Promise<{ ok: true } | { ok: false; error: string }> {\n    return this.opts.sessionIndex.patchSession(key, body);\n  }\n\n  async getAgentConfig(sessionKey: string) {\n    return this.opts.getAgentService().sessionInspector.agentConfig(sessionKey);\n  }\n\n  /** Resolved markdown workspace for a session (after hydration / mkdir). */\n  getEffectiveWorkspacePath(sessionKey: string): Promise<string> {\n    return this.opts.getAgentService().getEffectiveWorkspacePathForSession(sessionKey);\n  }\n\n  patchAgentConfig(\n    sessionKey: string,\n    body: {\n      thinkingLevel?: string;\n      model?: string | null;\n      reasoningLevel?: string;\n      verboseLevel?: string;\n      workingDirectory?: string;\n    },\n  ) {\n    return this.opts.getAgentService().sessionConfig.patch(sessionKey, body);\n  }\n\n  // ── Compaction checkpoints ────────────────────────────────────────────\n\n  listCompactionCheckpoints(key: string) {\n    return this.opts.sessionIndex.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.opts.sessionIndex.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    await this.opts.sessionIndex.restoreCompactionCheckpoint(key, checkpointId);\n    this.opts.getAgentService().evictSessionAgent(key);\n  }\n\n  async runCompaction(\n    key: string,\n    options?: { instructions?: string; force?: boolean },\n  ): Promise<CompactionResult> {\n    const result = await this.opts.getAgentService().sessionInspector.compact(key, options);\n    if (result.compacted) {\n      void this.opts.sessionIndex\n        .appendTranscriptContextEntry(key, {\n          text: 'Session transcript compacted',\n          data: {\n            firstKeptIndex: result.firstKeptIndex,\n            tokensBefore: result.tokensBefore,\n            tokensAfter: result.tokensAfter,\n            summaryPreview: result.summary.slice(0, 500),\n          },\n        })\n        .catch(() => {});\n    }\n    return result;\n  }\n\n  // ── Lifecycle (delete / rename / tag / pin / archive) ─────────────────\n\n  async delete(key: string): Promise<{ deleted: boolean }> {\n    const messages = await this.opts.sessionIndex.loadMessages(key).catch(() => []);\n    const result = await this.opts.sessionIndex.deleteSession(key);\n    if (result) {\n      await deleteMediaUris(collectMediaUrisFromMessages(messages));\n      this.opts.getAgentService().evictSessionAgent(key);\n      await retireSessionMcpRuntimeForSessionKey({ sessionKey: key, reason: 'session-delete' });\n    }\n    return { deleted: result };\n  }\n\n  /** Reset transcript in place (archive + new session id); preserves session key and overrides. */\n  reset(key: string): Promise<SessionResetResult> {\n    return performSessionReset(key, {\n      sessionIndex: this.opts.sessionIndex,\n      getAgentService: this.opts.getAgentService,\n    });\n  }\n\n  deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    return this.opts.sessionIndex.deleteSessions(keys);\n  }\n\n  async rename(key: string, name: string): Promise<{ renamed: boolean }> {\n    await this.opts.sessionIndex.renameSession(key, name);\n    return { renamed: true };\n  }\n\n  async tag(key: string, tags: string[]): Promise<{ tagged: boolean }> {\n    await this.opts.sessionIndex.tagSession(key, tags);\n    return { tagged: true };\n  }\n\n  async untag(key: string, tags: string[]): Promise<{ untagged: boolean }> {\n    await this.opts.sessionIndex.untagSession(key, tags);\n    return { untagged: true };\n  }\n\n  async archive(key: string): Promise<{ archived: boolean }> {\n    await this.opts.sessionIndex.archiveSession(key);\n    return { archived: true };\n  }\n\n  async unarchive(key: string): Promise<{ unarchived: boolean }> {\n    await this.opts.sessionIndex.unarchiveSession(key);\n    return { unarchived: true };\n  }\n\n  async pin(key: string): Promise<{ pinned: boolean }> {\n    await this.opts.sessionIndex.pinSession(key);\n    return { pinned: true };\n  }\n\n  async unpin(key: string): Promise<{ unpinned: boolean }> {\n    await this.opts.sessionIndex.unpinSession(key);\n    return { unpinned: true };\n  }\n\n  // ── Search + export + stats ───────────────────────────────────────────\n\n  search(query: string) {\n    return this.opts.sessionIndex.searchSessions(query);\n  }\n\n  searchIn(key: string, keyword: string) {\n    return this.opts.sessionIndex.searchInSession(key, keyword);\n  }\n\n  async export(key: string, format: ExportFormat): Promise<{ content: string }> {\n    const content = await this.opts.sessionIndex.exportSession(key, format);\n    return { content };\n  }\n\n  importExport(\n    targetKey: string,\n    jsonContent: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.opts.sessionIndex.importSessionExport(targetKey, jsonContent);\n  }\n\n  fork(\n    key: string,\n    targetKey: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.opts.sessionIndex.forkSession(key, targetKey);\n  }\n\n  forkRows(\n    key: string,\n    targetKey: string,\n    options: { throughRow?: number } = {},\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.opts.sessionIndex.forkSessionRows(key, targetKey, options);\n  }\n\n  btwQuery(sessionKey: string, question: string): Promise<{ text: string; error?: string }> {\n    return this.opts.getAgentService().sessionInspector.btwQuery(sessionKey, question);\n  }\n\n  stats() {\n    return this.opts.sessionIndex.getStats();\n  }\n\n  /**\n   * Distinct chat-id pairs from sessions, grouped by channel. Used by cron job\n   * configuration UI to seed the \"send to existing chat\" picker.\n   */\n  chatIds(channel?: string): Promise<\n    Array<{\n      channel: string;\n      chatId: string;\n      lastActive: string;\n      accountId?: string;\n      peerKind?: string;\n      peerId?: string;\n    }>\n  > {\n    return getDistinctSessionChatIds(this.opts.sessionIndex, channel);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sessions-api.js","names":[],"sources":["../../../../src/gateway/service/sessions-api.ts"],"sourcesContent":["/**\n * GatewaySessionsApi — session CRUD, search, compaction, tag/pin/archive,\n * stats, and chat-id grouping for the gateway REST surface.\n *\n * Twenty-four methods, previously sitting on `GatewayService` as a mix of\n * one-line `sessionIndex.*` delegations and small composite operations (e.g.\n * `restoreCheckpoint` also evicts the in-memory agent, `runCompaction` also\n * appends a transcript context entry). Centralising them here lets routes\n * depend on the narrow `GatewaySessionsApi` surface instead of the full\n * `GatewayService`, and keeps the gateway composition root focused on\n * lifecycle + wiring.\n */\n\nimport type { AgentService } from '../../agent/service.js';\nimport type { CompactionResult } from '../../agent/memory/compaction.js';\nimport { retireSessionMcpRuntimeForSessionKey } from '../../agent/mcp/bundle-mcp-tools.js';\nimport { SessionIndex } from '../../session/index.js';\nimport type { ExportFormat, SessionListQuery } from '../../session/types.js';\nimport { buildSessionTimeline } from '../../session/transcript-outline.js';\nimport type { SessionPatchBody } from '../../session/patch-metadata.js';\nimport { collectMediaUrisFromMessages, deleteMediaUris } from '../../media/session-references.js';\nimport { getDistinctSessionChatIds } from './session-chat-ids.js';\nimport { performSessionReset, type SessionResetResult } from '../session-reset-service.js';\n\nexport interface GatewaySessionsApiOptions {\n  sessionIndex: SessionIndex;\n  /** Resolves the live agent service (created lazily; throws if gateway is starting). */\n  getAgentService: () => AgentService;\n  /** Read-only view of in-flight webchat runs (per session key → run id). */\n  getActiveWebchatRunId: (sessionKey: string) => string | undefined;\n}\n\nexport class GatewaySessionsApi {\n  private readonly opts: GatewaySessionsApiOptions;\n\n  constructor(opts: GatewaySessionsApiOptions) {\n    this.opts = opts;\n  }\n\n  // ── List / get ─────────────────────────────────────────────────────────\n\n  listSessions(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSessions(query);\n  }\n\n  /** Subagent sessions have keys starting with `subagent:`. */\n  listSubagents(query?: SessionListQuery) {\n    return this.opts.sessionIndex.listSubagents(query);\n  }\n\n  getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ) {\n    return this.opts.sessionIndex.getSession(key, options);\n  }\n\n  async resolveSession(input: {\n    key?: string;\n    sessionKey?: string;\n    sessionId?: string;\n  }): Promise<\n    | {\n        sessionKey: string;\n        sessionId: string;\n        session: Awaited<ReturnType<GatewaySessionsApi['getSession']>>;\n      }\n    | null\n  > {\n    const explicitKey = input.sessionKey?.trim() || input.key?.trim();\n    const resolvedKey =\n      explicitKey ||\n      (input.sessionId?.trim()\n        ? await this.opts.sessionIndex.resolveSessionKeyBySessionId(input.sessionId.trim())\n        : null);\n    if (!resolvedKey) {\n      return null;\n    }\n    const session = await this.getSession(resolvedKey);\n    if (!session?.sessionId) {\n      return null;\n    }\n    return { sessionKey: resolvedKey, sessionId: session.sessionId, session };\n  }\n\n  /** Read-only: in-flight webchat agent run for this session key, if any. */\n  getActiveRun(sessionKey: string): { active: boolean; runId?: string } {\n    const key = sessionKey.trim();\n    if (!key) return { active: false };\n    const runId = this.opts.getActiveWebchatRunId(key)?.trim();\n    if (!runId) return { active: false };\n    return { active: true, runId };\n  }\n\n  getMessagePage(\n    key: string,\n    options?: {\n      offset?: number;\n      limit?: number;\n      before?: string;\n      includeTranscriptSummary?: boolean;\n      includeTranscriptRows?: boolean;\n    },\n  ) {\n    return this.opts.sessionIndex.getSessionMessagePage(key, options);\n  }\n\n  async getTimeline(key: string) {\n    const metadata = await this.opts.sessionIndex.getSessionMetadata(key);\n    if (!metadata) return null;\n    const rows = await this.opts.sessionIndex.getStore().loadTranscriptRows(key);\n    return buildSessionTimeline(rows);\n  }\n\n  // ── Metadata patches ──────────────────────────────────────────────────\n\n  patch(key: string, body: SessionPatchBody): Promise<{ ok: true } | { ok: false; error: string }> {\n    return this.opts.sessionIndex.patchSession(key, body);\n  }\n\n  async getAgentConfig(sessionKey: string) {\n    return this.opts.getAgentService().sessionInspector.agentConfig(sessionKey);\n  }\n\n  /** Resolved markdown workspace for a session (after hydration / mkdir). */\n  getEffectiveWorkspacePath(sessionKey: string): Promise<string> {\n    return this.opts.getAgentService().getEffectiveWorkspacePathForSession(sessionKey);\n  }\n\n  patchAgentConfig(\n    sessionKey: string,\n    body: {\n      thinkingLevel?: string;\n      model?: string | null;\n      reasoningLevel?: string;\n      verboseLevel?: string;\n      workingDirectory?: string;\n    },\n  ) {\n    return this.opts.getAgentService().sessionConfig.patch(sessionKey, body);\n  }\n\n  // ── Compaction checkpoints ────────────────────────────────────────────\n\n  listCompactionCheckpoints(key: string) {\n    return this.opts.sessionIndex.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.opts.sessionIndex.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  async restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void> {\n    await this.opts.sessionIndex.restoreCompactionCheckpoint(key, checkpointId);\n    this.opts.getAgentService().evictSessionAgent(key);\n  }\n\n  async runCompaction(\n    key: string,\n    options?: { instructions?: string; force?: boolean },\n  ): Promise<CompactionResult> {\n    const result = await this.opts.getAgentService().sessionInspector.compact(key, options);\n    if (result.compacted) {\n      void this.opts.sessionIndex\n        .appendTranscriptContextEntry(key, {\n          text: 'Session transcript compacted',\n          data: {\n            firstKeptIndex: result.firstKeptIndex,\n            tokensBefore: result.tokensBefore,\n            tokensAfter: result.tokensAfter,\n            summaryPreview: result.summary.slice(0, 500),\n          },\n        })\n        .catch(() => {});\n    }\n    return result;\n  }\n\n  // ── Lifecycle (delete / rename / tag / pin / archive) ─────────────────\n\n  async delete(key: string): Promise<{ deleted: boolean }> {\n    const messages = await this.opts.sessionIndex.loadMessages(key).catch(() => []);\n    const result = await this.opts.sessionIndex.deleteSession(key);\n    if (result) {\n      await deleteMediaUris(collectMediaUrisFromMessages(messages));\n      this.opts.getAgentService().evictSessionAgent(key);\n      await retireSessionMcpRuntimeForSessionKey({ sessionKey: key, reason: 'session-delete' });\n    }\n    return { deleted: result };\n  }\n\n  /** Reset transcript in place (archive + new session id); preserves session key and overrides. */\n  reset(key: string): Promise<SessionResetResult> {\n    return performSessionReset(key, {\n      sessionIndex: this.opts.sessionIndex,\n      getAgentService: this.opts.getAgentService,\n    });\n  }\n\n  deleteMany(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    return this.opts.sessionIndex.deleteSessions(keys);\n  }\n\n  async rename(key: string, name: string): Promise<{ renamed: boolean }> {\n    await this.opts.sessionIndex.renameSession(key, name);\n    return { renamed: true };\n  }\n\n  async tag(key: string, tags: string[]): Promise<{ tagged: boolean }> {\n    await this.opts.sessionIndex.tagSession(key, tags);\n    return { tagged: true };\n  }\n\n  async untag(key: string, tags: string[]): Promise<{ untagged: boolean }> {\n    await this.opts.sessionIndex.untagSession(key, tags);\n    return { untagged: true };\n  }\n\n  async archive(key: string): Promise<{ archived: boolean }> {\n    await this.opts.sessionIndex.archiveSession(key);\n    return { archived: true };\n  }\n\n  async unarchive(key: string): Promise<{ unarchived: boolean }> {\n    await this.opts.sessionIndex.unarchiveSession(key);\n    return { unarchived: true };\n  }\n\n  async pin(key: string): Promise<{ pinned: boolean }> {\n    await this.opts.sessionIndex.pinSession(key);\n    return { pinned: true };\n  }\n\n  async unpin(key: string): Promise<{ unpinned: boolean }> {\n    await this.opts.sessionIndex.unpinSession(key);\n    return { unpinned: true };\n  }\n\n  // ── Search + export + stats ───────────────────────────────────────────\n\n  search(query: string) {\n    return this.opts.sessionIndex.searchSessions(query);\n  }\n\n  searchIn(key: string, keyword: string) {\n    return this.opts.sessionIndex.searchInSession(key, keyword);\n  }\n\n  async export(key: string, format: ExportFormat): Promise<{ content: string }> {\n    const content = await this.opts.sessionIndex.exportSession(key, format);\n    return { content };\n  }\n\n  importExport(\n    targetKey: string,\n    jsonContent: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.opts.sessionIndex.importSessionExport(targetKey, jsonContent);\n  }\n\n  fork(\n    key: string,\n    targetKey: string,\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.opts.sessionIndex.forkSession(key, targetKey);\n  }\n\n  forkRows(\n    key: string,\n    targetKey: string,\n    options: { throughRow?: number } = {},\n  ): Promise<{ sessionKey: string; rowCount: number }> {\n    return this.opts.sessionIndex.forkSessionRows(key, targetKey, options);\n  }\n\n  btwQuery(sessionKey: string, question: string): Promise<{ text: string; error?: string }> {\n    return this.opts.getAgentService().sessionInspector.btwQuery(sessionKey, question);\n  }\n\n  stats() {\n    return this.opts.sessionIndex.getStats();\n  }\n\n  /**\n   * Distinct chat-id pairs from sessions, grouped by channel. Used by automation\n   * configuration UI to seed the \"send to existing chat\" picker.\n   */\n  chatIds(channel?: string): Promise<\n    Array<{\n      channel: string;\n      chatId: string;\n      lastActive: string;\n      accountId?: string;\n      peerKind?: string;\n      peerId?: string;\n    }>\n  > {\n    return getDistinctSessionChatIds(this.opts.sessionIndex, channel);\n  }\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { AgentService } from '../agent/service.js';
 import { MessageBus } from '../infra/bus/index.js';
-import { CronService } from '../cron/index.js';
+import { AutomationService } from '../automations/index.js';
 import { NotesService } from '../notes/index.js';
 import { WorkflowRunService } from '../workflows/service/workflow-run-service.js';
 import { ExtensionLoader } from '../extensions/index.js';
@@ -22,7 +22,7 @@ export declare class GatewayService {
     private configPath;
     private _agentService;
     private channelManager;
-    private cronService;
+    private automationService;
     private notesService;
     private extensionLoader;
     private extensionMetadataSnapshot;
@@ -53,6 +53,8 @@ export declare class GatewayService {
     private goalRunner;
     private goalNotifications;
     private connectorSupervisor;
+    private stopAutomationProductEventBridge;
+    private stopSessionTranscriptAutomationEvents;
     /**
      * Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
      * `submitClarifyResponse`, clarify-bridge dispatch). Owns the
@@ -233,7 +235,8 @@ export declare class GatewayService {
     get messageBusInstance(): MessageBus;
     /** Effective HTTP listen port (CLI `--port` override or config default). */
     getEffectiveListenPort(): number;
-    get cronServiceInstance(): CronService;
+    get automationServiceInstance(): AutomationService;
+    private reconcileDreamingAutomations;
     get notesServiceInstance(): NotesService;
     get sessionIndexInstance(): SessionIndex;
     /** Shared workflow run orchestrator + session bridge (one instance per gateway). */
@@ -244,6 +247,7 @@ export declare class GatewayService {
     processDirect(content: string, sessionKey?: string): Promise<string>;
     subscribe(sessionId: string, listener: (event: ServiceEvent) => Promise<void> | void): () => void;
     emit(type: string, payload: unknown): void;
+    private startAutomationProductEventBridge;
     /** Replay events since `lastEventId` for SSE reconnection. */
     getEventsSince(sessionId: string, lastEventId: string): ServiceEvent[];
     /**

package/dist/src/gateway/service.js

@@ -16,6 +16,8 @@ import { loadConfig, saveConfig } from "../config/loader.js";
 import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { resolveEffectiveGatewayPort } from "./host.js";
+import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
 import { closeXopcDatabase, openXopcDatabase } from "../storage/sqlite/connection.js";
 import { GoalRunner } from "../goals/goal-runner.js";
 import { GoalNotificationService } from "../goals/goal-notifications.js";
@@ -31,15 +33,16 @@ import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
 import { AgentService } from "../agent/service.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";
+import { AutomationService } from "../automations/service/automation-service.js";
+import "../automations/index.js";
 import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
 import { registerClarifyBridge } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
-import { CronService } from "../cron/service.js";
-import "../cron/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
+import { reconcileDreamingAutomations } from "./dreaming-automation-reconciler.js";
 import { NotesStore } from "../notes/store.js";
 import { buildNoteAgentContext } from "../notes/agent-context.js";
 import { NotesService } from "../notes/service.js";
@@ -59,6 +62,7 @@ import { isGatewayStrictSecurityEnabled } from "./rate-limit/env-flags.js";
 import "./rate-limit/index.js";
 import { assertGatewayRuntimeConfig } from "./runtime-config.js";
 import { auditGatewayConfig } from "./security/audit.js";
+import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { scheduleGatewayUpdateCheck } from "../infra/update-startup.js";
 import { resolveChannelConnectDeferSet } from "./resolve-channel-connect-defer.js";
 import { restartGatewayProcessWithFreshPid } from "./respawn.js";
@@ -87,7 +91,7 @@ var GatewayService = class {
 	configPath;
 	_agentService = null;
 	channelManager;
-	cronService;
+	automationService;
 	notesService;
 	extensionLoader = null;
 	extensionMetadataSnapshot = null;
@@ -120,6 +124,8 @@ var GatewayService = class {
 	goalRunner = null;
 	goalNotifications = null;
 	connectorSupervisor = null;
+	stopAutomationProductEventBridge = null;
+	stopSessionTranscriptAutomationEvents = null;
 	/**
 	* Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
 	* `submitClarifyResponse`, clarify-bridge dispatch). Owns the
@@ -145,6 +151,7 @@ var GatewayService = class {
 		this.serviceConfig = serviceConfig;
 		this.bus = new MessageBus();
 		this.configPath = serviceConfig.configPath || resolveConfigPath();
+		runBootstrapMigrationsSync(this.configPath);
 		this.config = loadConfig(this.configPath);
 		const starterResult = ensureStarterAgentsInitialized(this.config);
 		if (starterResult.changed) {
@@ -204,7 +211,7 @@ var GatewayService = class {
 		this.workspacePath = getWorkspacePath(this.config) || "./workspace";
 		this.initializeExtensionLoader();
 		this.sessionIndex = new SessionIndex({ config: this.config });
-		this.cronService = new CronService({ maxConcurrentJobs: this.config.cron?.maxConcurrentJobs });
+		this.automationService = new AutomationService();
 		this.notesService = new NotesService(new NotesStore());
 		this.agentRunner = new GatewayAgentRunner({
 			bus: this.bus,
@@ -237,10 +244,10 @@ var GatewayService = class {
 			},
 			getAgentService: () => this.ensureAgentService(),
 			getChannelManager: () => this.channelManager,
-			getCronService: () => this.cronService,
 			getHeartbeatService: () => this.heartbeatService,
 			getExtensionLoader: () => this.extensionLoader,
 			reconcileBrowserExtensionServer: () => this.reconcileBrowserExtensionServer(),
+			reconcileDreamingAutomations: () => this.reconcileDreamingAutomations(),
 			getChannelsStatus: () => this.getChannelsStatus(),
 			emit: (type, payload) => this.emit(type, payload)
 		});
@@ -251,7 +258,6 @@ var GatewayService = class {
 	}
 	ensureAgentService() {
 		if (this._agentService) return this._agentService;
-		const cronRef = { service: this.cronService };
 		this._agentService = new AgentService(this.bus, {
 			workspace: this.workspacePath,
 			model: getAgentDefaultModelRef(this.config),
@@ -280,7 +286,7 @@ var GatewayService = class {
 				});
 			},
 			extensionRegistry: this.extensionLoader?.getRegistry(),
-			getCronService: () => cronRef.service,
+			getAutomationService: () => this.automationService,
 			getWorkflowRunService: () => this.createWorkflowRunService(),
 			sourceContextResolver: async (binding) => {
 				if (binding.kind !== "note") return null;
@@ -305,16 +311,11 @@ var GatewayService = class {
 			getModelForSession: (sk) => this._agentService.getModelForSession(sk),
 			switchModelForSession: (sk, id) => this._agentService.switchModelForSession(sk, id)
 		});
-		this.cronService.setDeps({
+		this.automationService.setDeps({
 			agentService: this._agentService,
-			messageBus: this.bus,
-			heartbeatService: this.ensureHeartbeatService(),
-			sessionStore: this.sessionIndex.getStore(),
-			getDefaultCronAgentId: () => getDefaultAgentId(this.config),
-			workflowRunService: this.createWorkflowRunService(),
-			goalRunner: this.createGoalRunner()
+			getDefaultAgentId: () => getDefaultAgentId(this.config),
+			workflowRunService: this.createWorkflowRunService()
 		});
-		cronRef.service = this.cronService;
 		this._agentService.persistentGoals.setWebchatContinuationScheduler((sessionKey, message) => {
 			const scheduleWhenIdle = () => {
 				if (this._agentService.getInboundTurnDepth(sessionKey) > 0) {
@@ -336,7 +337,6 @@ var GatewayService = class {
 		this.heartbeatService = new HeartbeatService({
 			agentService: this.ensureAgentService(),
 			messageBus: this.bus,
-			cronService: this.cronService,
 			sessionStore: this.sessionIndex.getStore(),
 			getConfig: () => this.config
 		});
@@ -614,15 +614,12 @@ var GatewayService = class {
 		}, "Gateway channel startup phase-1 complete");
 		await trace.measure("sessions.initialize", () => this.sessionIndex.initialize());
 		log.debug("Session manager initialized");
-		this.cronService.setDeps({
+		this.automationService.setDeps({
 			agentService: this.agentService,
-			messageBus: this.bus,
-			heartbeatService: this.ensureHeartbeatService(),
-			sessionStore: this.sessionIndex.getStore(),
-			getDefaultCronAgentId: () => getDefaultAgentId(this.config),
-			workflowRunService: this.createWorkflowRunService(),
-			goalRunner: this.createGoalRunner()
+			getDefaultAgentId: () => getDefaultAgentId(this.config),
+			workflowRunService: this.createWorkflowRunService()
 		});
+		this.startAutomationProductEventBridge();
 		await trace.measure("workflows.reconcile", () => this.reconcileInterruptedWorkflowRuns());
 		this.sessionIndex.on("sessionUpdated", (data) => {
 			this.emit("session.updated", {
@@ -631,7 +628,8 @@ var GatewayService = class {
 				tags: data.tags
 			});
 		});
-		if (this.config.cron?.enabled !== false) await trace.measure("cron.initialize", () => this.cronService.initialize());
+		await trace.measure("automations.initialize", () => this.automationService.initialize());
+		await trace.measure("dreaming.reconcile", () => this.reconcileDreamingAutomations());
 		await this.notesService.initialize();
 		this.ensureHeartbeatService().start(heartbeatRunnerConfigFromConfig(this.config));
 		this.connectorSupervisor = startConnectorSupervisor({
@@ -775,7 +773,11 @@ var GatewayService = class {
 		this.lastChannelConnectDeferMode = "auto";
 		this.lastChannelConnectDeferSource = "off";
 		await this.channelManager.stop();
-		await this.cronService.stop();
+		await this.automationService.stop();
+		this.stopAutomationProductEventBridge?.();
+		this.stopAutomationProductEventBridge = null;
+		this.stopSessionTranscriptAutomationEvents?.();
+		this.stopSessionTranscriptAutomationEvents = null;
 		await this.notesService.flush();
 		buckets.destroyAll();
 		closeXopcDatabase();
@@ -1074,8 +1076,14 @@ var GatewayService = class {
 	getEffectiveListenPort() {
 		return resolveEffectiveGatewayPort(this.config, this.serviceConfig.listenPort);
 	}
-	get cronServiceInstance() {
-		return this.cronService;
+	get automationServiceInstance() {
+		return this.automationService;
+	}
+	async reconcileDreamingAutomations() {
+		await reconcileDreamingAutomations({
+			config: this.config,
+			automationService: this.automationService
+		});
 	}
 	get notesServiceInstance() {
 		return this.notesService;
@@ -1134,6 +1142,32 @@ var GatewayService = class {
 		this.sse.emit(type, payload);
 		this.createGoalNotificationService().handleGatewayEvent(type, payload);
 	}
+	startAutomationProductEventBridge() {
+		this.stopAutomationProductEventBridge?.();
+		this.stopSessionTranscriptAutomationEvents?.();
+		this.stopAutomationProductEventBridge = onAutomationProductEvent((event) => {
+			this.automationService.triggerEvent(event).catch((err) => {
+				const em = err instanceof Error ? err.message : String(err);
+				log.warn({
+					err,
+					eventType: event.type,
+					source: event.source
+				}, `Automation product event failed: ${em}`);
+			});
+		});
+		this.stopSessionTranscriptAutomationEvents = onSessionTranscriptUpdate((update) => {
+			if (!update.sessionKey || update.sessionKey.includes(":automation:")) return;
+			publishAutomationProductEvent({
+				type: "session.transcript.updated",
+				source: "sessions",
+				payload: {
+					sessionKey: update.sessionKey,
+					messageId: update.messageId,
+					hasMessage: update.message !== void 0
+				}
+			});
+		});
+	}
 	/** Replay events since `lastEventId` for SSE reconnection. */
 	getEventsSince(sessionId, lastEventId) {
 		return this.sse.getEventsSince(sessionId, lastEventId);