@xopcai/xopc 0.0.81 → 0.0.83

package/dist/src/cron/executor.js

@@ -1,7 +1,7 @@
-import { init_agent_scope, normalizeAgentId } from "../agent/agent-scope.js";
-import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_agent_scope, normalizeAgentId } from "../agent/agent-scope.js";
+import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { bundledChannelPlugins } from "../generated/bundled-channel-plugins.js";
 import { shouldSilence, stripHeartbeatToken } from "../heartbeat/tokens.js";
 import { getChannelPlugin, listChannelPlugins, syncChannelPluginsFromManager } from "../channels/plugins/registry.js";
@@ -276,7 +276,7 @@ var DefaultJobExecutor = class {
 		});
 		const executePromise = (async () => {
 			if (signal.aborted) throw new Error("Job was aborted");
-			await this.agentService.applyCronJobWorkingDirectory(sessionKey, job.workingDirectory);
+			await this.agentService.sessionConfig.applyCronJobWorkingDirectory(sessionKey, job.workingDirectory);
 			const jobModel = resolveIsolatedCronJobModel(job);
 			if (jobModel) {
 				if (!await this.agentService.switchModelForSession(sessionKey, jobModel)) {
@@ -288,7 +288,7 @@ var DefaultJobExecutor = class {
 					await this.agentService.resetSessionModelToAgentDefault(sessionKey);
 				}
 			} else await this.agentService.resetSessionModelToAgentDefault(sessionKey);
-			const response = await this.agentService.processDirect(message, sessionKey);
+			const response = await this.agentService.turnDispatcher.processDirect(message, sessionKey);
 			const model = this.agentService.getModelForSession(sessionKey);
 			log.info({
 				jobId: job.id,

package/dist/src/cron/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","names":[],"sources":["../../../src/cron/executor.ts"],"sourcesContent":["// Cron job executor with timeout, retry logic and agent integration\nimport type {\n  CronRunOutcome,\n  HeartbeatWakeSink,\n  JobData,\n  JobExecution,\n  JobExecutor,\n  JobExecutorDeps,\n} from './types.js';\nimport type { OutboundMessage } from '../channels/transport-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  getChannelPlugin,\n  listChannelPlugins,\n  syncChannelPluginsFromManager,\n} from '../channels/plugins/registry.js';\nimport { bundledChannelPlugins } from '../generated/bundled-channel-plugins.js';\nimport { getCronPayloadText } from './job-content.js';\nimport type { SessionStore } from '../session/store.js';\nimport type { CronRunLogStore } from './run-log-store.js';\nimport {\n  DEFAULT_ACK_MAX_CHARS,\n  NO_REPLY,\n  shouldSilence,\n  stripHeartbeatToken,\n} from '../heartbeat/tokens.js';\nimport { DEFAULT_AGENT_ID, normalizeAgentId } from '../agent/agent-scope.js';\nimport { buildSessionKey } from '../routing/session-key.js';\n\nconst log = createLogger('CronExecutor');\n\n// Error backoff schedule in ms\nconst ERROR_BACKOFF_MS = [\n  30_000,   // 1st error  →  30s\n  60_000,   // 2nd error  →  1min\n  5 * 60_000,   // 3rd error  →  5min\n  15 * 60_000,  // 4th error  →  15min\n  60 * 60_000,  // 5th+ error →  60min\n];\n\nfunction errorBackoffMs(consecutiveErrors: number): number {\n  const idx = Math.min(consecutiveErrors - 1, ERROR_BACKOFF_MS.length - 1);\n  return ERROR_BACKOFF_MS[Math.max(0, idx)];\n}\n\nfunction resolveIsolatedCronJobModel(job: JobData): string | undefined {\n  const fromJob = job.model?.trim();\n  if (fromJob) return fromJob;\n  if (job.payload?.kind === 'agentTurn') {\n    const m = job.payload.model?.trim();\n    if (m) return m;\n  }\n  return undefined;\n}\n\nexport class DefaultJobExecutor implements JobExecutor {\n  private history: Map<string, JobExecution[]> = new Map();\n  private runningJobs = new Map<string, AbortController>();\n  private agentService: any = null;\n  private messageBus: any = null;\n  private heartbeatService: HeartbeatWakeSink | null = null;\n  private sessionStore: SessionStore | undefined;\n  private runLogStore: CronRunLogStore | null = null;\n  private getDefaultCronAgentId: (() => string) | null = null;\n\n  setRunLogStore(store: CronRunLogStore | null): void {\n    this.runLogStore = store;\n  }\n\n  setDeps(deps: JobExecutorDeps): void {\n    this.agentService = deps.agentService;\n    this.messageBus = deps.messageBus;\n    this.heartbeatService = deps.heartbeatService ?? null;\n    if (deps.sessionStore !== undefined) {\n      this.sessionStore = deps.sessionStore;\n    }\n    this.getDefaultCronAgentId = deps.getDefaultCronAgentId ?? null;\n  }\n\n  private async buildCronOutboundMessage(\n    channel: string,\n    to: string,\n    content: string,\n  ): Promise<OutboundMessage> {\n    if (listChannelPlugins().length === 0) {\n      syncChannelPluginsFromManager(bundledChannelPlugins);\n    }\n    const plugin = getChannelPlugin(channel);\n    if (plugin?.cronDelivery) {\n      const { chatId, accountId, metadata } = await plugin.cronDelivery.normalizeDeliveryTarget(\n        to,\n        this.sessionStore,\n      );\n      const meta =\n        accountId || metadata\n          ? { ...(metadata ?? {}), ...(accountId ? { accountId } : {}) }\n          : undefined;\n      return {\n        channel,\n        chat_id: chatId,\n        content,\n        type: 'message',\n        ...(meta && Object.keys(meta).length > 0 ? { metadata: meta } : {}),\n      };\n    }\n    return {\n      channel,\n      chat_id: to,\n      content,\n      type: 'message',\n    };\n  }\n\n  async execute(job: JobData, signal: AbortSignal, deps?: JobExecutorDeps): Promise<void> {\n    // Set deps if provided\n    if (deps) {\n      this.setDeps(deps);\n    }\n\n    const executionId = crypto.randomUUID();\n    const execution: JobExecution = {\n      id: executionId,\n      jobId: job.id,\n      status: 'running',\n      startedAt: new Date().toISOString(),\n      retryCount: 0,\n    };\n\n    // Record execution start\n    this.addToHistory(job.id, execution);\n    this.runningJobs.set(job.id, new AbortController());\n\n    log.info(\n      { jobId: job.id, executionId, preview: getCronPayloadText(job).slice(0, 100) },\n      'Job executing'\n    );\n\n    let result: CronRunOutcome;\n\n    try {\n      // Check for cancellation\n      if (signal.aborted) {\n        throw new Error('Job was cancelled before execution');\n      }\n\n      // Execute the job\n      result = await this.performJob(job, signal);\n\n      // Mark as success/failed\n      execution.status = result.status === 'ok' ? 'success' : result.status === 'skipped' ? 'cancelled' : 'failed';\n      execution.endedAt = new Date().toISOString();\n      execution.duration = Date.now() - new Date(execution.startedAt).getTime();\n      execution.summary = result.summary;\n      execution.error = result.error;\n      execution.sessionId = result.sessionId;\n      execution.sessionKey = result.sessionKey;\n      execution.sessionType = result.sessionType;\n      execution.model = result.model;\n\n      if (result.status === 'ok') {\n        log.info(\n          { jobId: job.id, executionId, duration: execution.duration },\n          'Job completed'\n        );\n      } else if (result.status === 'skipped') {\n        log.warn({ jobId: job.id, executionId, reason: result.error }, 'Job skipped');\n      } else {\n        log.error(\n          { jobId: job.id, executionId, error: result.error },\n          'Job failed'\n        );\n      }\n\n      if (result.status === 'ok' && this.heartbeatService) {\n        try {\n          this.heartbeatService.requestNow({ reason: `cron:${job.id}` });\n        } catch (e) {\n          log.warn({ jobId: job.id, err: e }, 'Heartbeat wake after cron failed');\n        }\n      }\n    } catch (error) {\n      execution.status = 'failed';\n      execution.endedAt = new Date().toISOString();\n      execution.duration = Date.now() - new Date(execution.startedAt).getTime();\n      execution.error = error instanceof Error ? error.message : String(error);\n\n      log.error(\n        { jobId: job.id, executionId, error: execution.error },\n        'Job execution error'\n      );\n\n      result = {\n        status: 'error',\n        error: execution.error,\n      };\n    } finally {\n      this.runningJobs.delete(job.id);\n    }\n\n    if (this.runLogStore) {\n      await this.runLogStore.appendCompleted(execution);\n    }\n\n    return;\n  }\n\n  /**\n   * Perform the actual job work - integrate with AgentService\n   */\n  protected async performJob(job: JobData, signal: AbortSignal): Promise<CronRunOutcome> {\n    const timeout = job.timeout || 60000;\n    const sessionTarget = job.sessionTarget || 'main';\n\n    // Check for abort before starting\n    if (signal.aborted) {\n      return { status: 'skipped', error: 'Job was aborted before execution' };\n    }\n\n    // If no agent service, fall back to basic execution\n    if (!this.agentService || !this.messageBus) {\n      log.warn({ jobId: job.id }, 'No agent service configured, using basic execution');\n      return this.basicExecute(job, signal, timeout);\n    }\n\n    try {\n      if (sessionTarget === 'main') {\n        return await this.executeMainSession(job, signal, timeout);\n      } else {\n        return await this.executeIsolated(job, signal, timeout);\n      }\n    } catch (error) {\n      return {\n        status: 'error',\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  /**\n   * Execute in main session - sends system event\n   */\n  private async executeMainSession(\n    job: JobData,\n    signal: AbortSignal,\n    timeout: number\n  ): Promise<CronRunOutcome> {\n    const text = getCronPayloadText(job);\n\n    if (!text || !text.trim()) {\n      return { status: 'skipped', error: 'Main session job requires non-empty message' };\n    }\n\n    // Parse delivery from job config, or parse routing from payload text: \"channel:chat_id:content\"\n    let channel: string;\n    let to: string;\n    let actualMessage: string;\n\n    if (job.delivery?.channel === 'local') {\n      channel = 'local';\n      to = '';\n      actualMessage = text;\n    } else if (job.delivery?.channel && job.delivery?.to) {\n      // Use explicit delivery config\n      channel = job.delivery.channel;\n      to = job.delivery.to;\n      actualMessage = text;\n    } else {\n      // Parse from payload text: \"channel:chat_id:content\"\n      const parts = text.split(':');\n      const hasAtLeastThreeParts = parts.length >= 3;\n      \n      // Check if first part looks like a known channel\n      if (listChannelPlugins().length === 0) {\n        syncChannelPluginsFromManager(bundledChannelPlugins);\n      }\n      const registeredChannelIds = listChannelPlugins().map((p) => p.id);\n      const knownChannels = [...new Set([...registeredChannelIds, 'cli', 'gateway', 'local'])];\n      const firstPartIsChannel = knownChannels.includes(parts[0]);\n      \n      if (hasAtLeastThreeParts && firstPartIsChannel) {\n        channel = parts[0];\n        to = parts[1];\n        actualMessage = parts.slice(2).join(':');\n        log.info(\n          { jobId: job.id, channel, to, parsedFrom: 'message', originalLength: text.length },\n          'Parsed delivery from payload text'\n        );\n      } else {\n        // Fallback to defaults\n        channel = 'cli';\n        to = 'cron';\n        actualMessage = text;\n        log.debug(\n          { jobId: job.id, partsCount: parts.length, firstPart: parts[0], hasDelivery: !!job.delivery },\n          'Using default delivery - message format not recognized'\n        );\n      }\n    }\n\n    // Create timeout promise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => reject(new Error(`Job timed out after ${timeout}ms`)), timeout);\n    });\n\n    // Create execution promise\n    const executePromise = (async () => {\n      // Check for abort\n      if (signal.aborted) {\n        throw new Error('Job was aborted');\n      }\n\n      if (channel === 'local') {\n        log.info(\n          { jobId: job.id, messageLength: actualMessage.length },\n          'Cron main session: local channel — no outbound publish'\n        );\n        return {\n          status: 'ok' as const,\n          summary: actualMessage.slice(0, 200),\n        };\n      }\n\n      const outbound = await this.buildCronOutboundMessage(channel, to, actualMessage);\n\n      await this.messageBus.publishOutbound(outbound);\n\n      log.info(\n        { jobId: job.id, channel, to: outbound.chat_id, messageLength: actualMessage.length },\n        'Sent message to main session'\n      );\n\n      return {\n        status: 'ok' as const,\n        summary: actualMessage.slice(0, 200),\n      };\n    })();\n\n    // Race against timeout\n    return await Promise.race([executePromise, timeoutPromise]);\n  }\n\n  /**\n   * Execute in isolated mode - runs agent independently\n   */\n  private async executeIsolated(\n    job: JobData,\n    signal: AbortSignal,\n    timeout: number\n  ): Promise<CronRunOutcome> {\n    const message = getCronPayloadText(job);\n\n    if (!message || !message.trim()) {\n      return { status: 'skipped', error: 'Isolated job requires non-empty message' };\n    }\n\n    const aid = job.agentId?.trim();\n    const fallbackAgentId = this.getDefaultCronAgentId?.() ?? DEFAULT_AGENT_ID;\n    const sessionKey = buildSessionKey({\n      agentId: normalizeAgentId(aid || fallbackAgentId),\n      source: 'cron',\n      accountId: 'default',\n      peerKind: 'dm',\n      peerId: job.id,\n    });\n\n    // Create timeout promise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => reject(new Error(`Job timed out after ${timeout}ms`)), timeout);\n    });\n\n    // Create execution promise\n    const executePromise = (async () => {\n      // Check for abort\n      if (signal.aborted) {\n        throw new Error('Job was aborted');\n      }\n\n      await this.agentService.applyCronJobWorkingDirectory(sessionKey, job.workingDirectory);\n\n      const jobModel = resolveIsolatedCronJobModel(job);\n      if (jobModel) {\n        const ok = await this.agentService.switchModelForSession(sessionKey, jobModel);\n        if (!ok) {\n          log.warn({ jobId: job.id, sessionKey, model: jobModel }, 'Cron job model invalid; using agent default');\n          await this.agentService.resetSessionModelToAgentDefault(sessionKey);\n        }\n      } else {\n        await this.agentService.resetSessionModelToAgentDefault(sessionKey);\n      }\n\n      const response = await this.agentService.processDirect(message, sessionKey);\n\n      const model = this.agentService.getModelForSession(sessionKey);\n\n      log.info(\n        { jobId: job.id, sessionKey, responseLength: response.length, model },\n        'Agent execution completed'\n      );\n\n      // Handle delivery (`local` channel or `mode: none` = no outbound; transcript in SessionStore)\n      const delivery = job.delivery;\n      const outboundChannel = delivery?.channel;\n      const shouldPublish =\n        delivery &&\n        delivery.mode !== 'none' &&\n        outboundChannel !== 'local' &&\n        delivery.to;\n\n      if (shouldPublish) {\n        if (shouldSilence(response, DEFAULT_ACK_MAX_CHARS) || response.trim() === NO_REPLY) {\n          return {\n            status: 'ok' as const,\n            summary: response.slice(0, 200),\n            sessionId: sessionKey,\n            sessionKey,\n            sessionType: 'cron',\n            model,\n          };\n        }\n        const { stripped } = stripHeartbeatToken(response);\n        const outboundText = stripped || response.trim();\n\n        const targetChannel = outboundChannel || 'cli';\n        const outbound = await this.buildCronOutboundMessage(targetChannel, delivery.to, outboundText);\n\n        await this.messageBus.publishOutbound(outbound);\n\n        log.info(\n          { jobId: job.id, channel: targetChannel, to: outbound.chat_id },\n          'Delivered agent response'\n        );\n\n        return {\n          status: 'ok' as const,\n          summary: response.slice(0, 200),\n          sessionId: sessionKey,\n          sessionKey,\n          sessionType: 'cron',\n          model,\n        };\n      }\n\n      // No outbound delivery: transcript is in SessionStore under `sessionKey`.\n      return {\n        status: 'ok' as const,\n        summary: response.slice(0, 200),\n        sessionId: sessionKey,\n        sessionKey,\n        sessionType: 'cron',\n        model,\n      };\n    })();\n\n    // Race against timeout\n    try {\n      return await Promise.race([executePromise, timeoutPromise]);\n    } finally {\n      const { retireSessionMcpRuntimeForSessionKey } = await import('../agent/mcp/bundle-mcp-tools.js');\n      await retireSessionMcpRuntimeForSessionKey({\n        sessionKey,\n        reason: 'cron-isolated-end',\n      }).catch(() => {});\n    }\n  }\n\n  /**\n   * Basic execution without agent service (fallback)\n   */\n  private async basicExecute(\n    job: JobData,\n    signal: AbortSignal,\n    timeout: number\n  ): Promise<CronRunOutcome> {\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        reject(new Error(`Job timed out after ${timeout}ms`));\n      }, timeout);\n\n      // Listen for abort signal\n      const abortHandler = () => {\n        clearTimeout(timeoutId);\n        reject(new Error('Job was aborted'));\n      };\n      signal.addEventListener('abort', abortHandler);\n\n      // Simulate basic work\n      setTimeout(() => {\n        clearTimeout(timeoutId);\n        signal.removeEventListener('abort', abortHandler);\n\n        if (signal.aborted) {\n          reject(new Error('Job was aborted'));\n        } else {\n          resolve({\n            status: 'ok',\n            summary: `Executed: ${getCronPayloadText(job).slice(0, 100)}`,\n          });\n        }\n      }, 100);\n    });\n  }\n\n  /**\n   * Cancel a running job\n   */\n  cancelJob(jobId: string): boolean {\n    const controller = this.runningJobs.get(jobId);\n    if (controller) {\n      controller.abort();\n      this.runningJobs.delete(jobId);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Get execution history for a job\n   */\n  getHistory(jobId: string, limit = 10): JobExecution[] {\n    const history = this.history.get(jobId) || [];\n    return history.slice(-limit);\n  }\n\n  /**\n   * Get currently running executions\n   */\n  getRunningExecutions(): JobExecution[] {\n    const result: JobExecution[] = [];\n    for (const [jobId] of this.runningJobs) {\n      const history = this.history.get(jobId);\n      if (history) {\n        const running = history.find((e) => e.status === 'running');\n        if (running) result.push(running);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Check if a job is currently running\n   */\n  isRunning(jobId: string): boolean {\n    return this.runningJobs.has(jobId);\n  }\n\n  /**\n   * Get consecutive error count for a job\n   */\n  getConsecutiveErrors(jobId: string): number {\n    const history = this.history.get(jobId) || [];\n    // Find last execution\n    for (let i = history.length - 1; i >= 0; i--) {\n      if (history[i].status !== 'running') {\n        if (history[i].status === 'failed' || history[i].status === 'cancelled') {\n          // Count consecutive errors before this\n          let count = 0;\n          for (let j = i - 1; j >= 0; j--) {\n            if (history[j].status === 'failed' || history[j].status === 'cancelled') {\n              count++;\n            } else {\n              break;\n            }\n          }\n          return count + 1;\n        }\n        return 0;\n      }\n    }\n    return 0;\n  }\n\n  /**\n   * Calculate backoff delay for a job\n   */\n  calculateBackoff(jobId: string): number {\n    const errors = this.getConsecutiveErrors(jobId);\n    return errorBackoffMs(errors);\n  }\n\n  /**\n   * Clear old history entries\n   */\n  cleanupHistory(maxAgeDays = 7): void {\n    const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;\n\n    for (const [jobId, executions] of this.history) {\n      this.history.set(\n        jobId,\n        executions.filter((e) => new Date(e.startedAt).getTime() > cutoff)\n      );\n    }\n  }\n\n  private addToHistory(jobId: string, execution: JobExecution): void {\n    const existing = this.history.get(jobId) || [];\n    existing.push(execution);\n    // Keep last 100 executions per job\n    if (existing.length > 100) {\n      existing.shift();\n    }\n    this.history.set(jobId, existing);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"executor.js","names":[],"sources":["../../../src/cron/executor.ts"],"sourcesContent":["// Cron job executor with timeout, retry logic and agent integration\nimport type {\n  CronRunOutcome,\n  HeartbeatWakeSink,\n  JobData,\n  JobExecution,\n  JobExecutor,\n  JobExecutorDeps,\n} from './types.js';\nimport type { OutboundMessage } from '../channels/transport-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  getChannelPlugin,\n  listChannelPlugins,\n  syncChannelPluginsFromManager,\n} from '../channels/plugins/registry.js';\nimport { bundledChannelPlugins } from '../generated/bundled-channel-plugins.js';\nimport { getCronPayloadText } from './job-content.js';\nimport type { SessionStore } from '../session/store.js';\nimport type { CronRunLogStore } from './run-log-store.js';\nimport {\n  DEFAULT_ACK_MAX_CHARS,\n  NO_REPLY,\n  shouldSilence,\n  stripHeartbeatToken,\n} from '../heartbeat/tokens.js';\nimport { DEFAULT_AGENT_ID, normalizeAgentId } from '../agent/agent-scope.js';\nimport { buildSessionKey } from '../routing/session-key.js';\n\nconst log = createLogger('CronExecutor');\n\n// Error backoff schedule in ms\nconst ERROR_BACKOFF_MS = [\n  30_000,   // 1st error  →  30s\n  60_000,   // 2nd error  →  1min\n  5 * 60_000,   // 3rd error  →  5min\n  15 * 60_000,  // 4th error  →  15min\n  60 * 60_000,  // 5th+ error →  60min\n];\n\nfunction errorBackoffMs(consecutiveErrors: number): number {\n  const idx = Math.min(consecutiveErrors - 1, ERROR_BACKOFF_MS.length - 1);\n  return ERROR_BACKOFF_MS[Math.max(0, idx)];\n}\n\nfunction resolveIsolatedCronJobModel(job: JobData): string | undefined {\n  const fromJob = job.model?.trim();\n  if (fromJob) return fromJob;\n  if (job.payload?.kind === 'agentTurn') {\n    const m = job.payload.model?.trim();\n    if (m) return m;\n  }\n  return undefined;\n}\n\nexport class DefaultJobExecutor implements JobExecutor {\n  private history: Map<string, JobExecution[]> = new Map();\n  private runningJobs = new Map<string, AbortController>();\n  private agentService: any = null;\n  private messageBus: any = null;\n  private heartbeatService: HeartbeatWakeSink | null = null;\n  private sessionStore: SessionStore | undefined;\n  private runLogStore: CronRunLogStore | null = null;\n  private getDefaultCronAgentId: (() => string) | null = null;\n\n  setRunLogStore(store: CronRunLogStore | null): void {\n    this.runLogStore = store;\n  }\n\n  setDeps(deps: JobExecutorDeps): void {\n    this.agentService = deps.agentService;\n    this.messageBus = deps.messageBus;\n    this.heartbeatService = deps.heartbeatService ?? null;\n    if (deps.sessionStore !== undefined) {\n      this.sessionStore = deps.sessionStore;\n    }\n    this.getDefaultCronAgentId = deps.getDefaultCronAgentId ?? null;\n  }\n\n  private async buildCronOutboundMessage(\n    channel: string,\n    to: string,\n    content: string,\n  ): Promise<OutboundMessage> {\n    if (listChannelPlugins().length === 0) {\n      syncChannelPluginsFromManager(bundledChannelPlugins);\n    }\n    const plugin = getChannelPlugin(channel);\n    if (plugin?.cronDelivery) {\n      const { chatId, accountId, metadata } = await plugin.cronDelivery.normalizeDeliveryTarget(\n        to,\n        this.sessionStore,\n      );\n      const meta =\n        accountId || metadata\n          ? { ...(metadata ?? {}), ...(accountId ? { accountId } : {}) }\n          : undefined;\n      return {\n        channel,\n        chat_id: chatId,\n        content,\n        type: 'message',\n        ...(meta && Object.keys(meta).length > 0 ? { metadata: meta } : {}),\n      };\n    }\n    return {\n      channel,\n      chat_id: to,\n      content,\n      type: 'message',\n    };\n  }\n\n  async execute(job: JobData, signal: AbortSignal, deps?: JobExecutorDeps): Promise<void> {\n    // Set deps if provided\n    if (deps) {\n      this.setDeps(deps);\n    }\n\n    const executionId = crypto.randomUUID();\n    const execution: JobExecution = {\n      id: executionId,\n      jobId: job.id,\n      status: 'running',\n      startedAt: new Date().toISOString(),\n      retryCount: 0,\n    };\n\n    // Record execution start\n    this.addToHistory(job.id, execution);\n    this.runningJobs.set(job.id, new AbortController());\n\n    log.info(\n      { jobId: job.id, executionId, preview: getCronPayloadText(job).slice(0, 100) },\n      'Job executing'\n    );\n\n    let result: CronRunOutcome;\n\n    try {\n      // Check for cancellation\n      if (signal.aborted) {\n        throw new Error('Job was cancelled before execution');\n      }\n\n      // Execute the job\n      result = await this.performJob(job, signal);\n\n      // Mark as success/failed\n      execution.status = result.status === 'ok' ? 'success' : result.status === 'skipped' ? 'cancelled' : 'failed';\n      execution.endedAt = new Date().toISOString();\n      execution.duration = Date.now() - new Date(execution.startedAt).getTime();\n      execution.summary = result.summary;\n      execution.error = result.error;\n      execution.sessionId = result.sessionId;\n      execution.sessionKey = result.sessionKey;\n      execution.sessionType = result.sessionType;\n      execution.model = result.model;\n\n      if (result.status === 'ok') {\n        log.info(\n          { jobId: job.id, executionId, duration: execution.duration },\n          'Job completed'\n        );\n      } else if (result.status === 'skipped') {\n        log.warn({ jobId: job.id, executionId, reason: result.error }, 'Job skipped');\n      } else {\n        log.error(\n          { jobId: job.id, executionId, error: result.error },\n          'Job failed'\n        );\n      }\n\n      if (result.status === 'ok' && this.heartbeatService) {\n        try {\n          this.heartbeatService.requestNow({ reason: `cron:${job.id}` });\n        } catch (e) {\n          log.warn({ jobId: job.id, err: e }, 'Heartbeat wake after cron failed');\n        }\n      }\n    } catch (error) {\n      execution.status = 'failed';\n      execution.endedAt = new Date().toISOString();\n      execution.duration = Date.now() - new Date(execution.startedAt).getTime();\n      execution.error = error instanceof Error ? error.message : String(error);\n\n      log.error(\n        { jobId: job.id, executionId, error: execution.error },\n        'Job execution error'\n      );\n\n      result = {\n        status: 'error',\n        error: execution.error,\n      };\n    } finally {\n      this.runningJobs.delete(job.id);\n    }\n\n    if (this.runLogStore) {\n      await this.runLogStore.appendCompleted(execution);\n    }\n\n    return;\n  }\n\n  /**\n   * Perform the actual job work - integrate with AgentService\n   */\n  protected async performJob(job: JobData, signal: AbortSignal): Promise<CronRunOutcome> {\n    const timeout = job.timeout || 60000;\n    const sessionTarget = job.sessionTarget || 'main';\n\n    // Check for abort before starting\n    if (signal.aborted) {\n      return { status: 'skipped', error: 'Job was aborted before execution' };\n    }\n\n    // If no agent service, fall back to basic execution\n    if (!this.agentService || !this.messageBus) {\n      log.warn({ jobId: job.id }, 'No agent service configured, using basic execution');\n      return this.basicExecute(job, signal, timeout);\n    }\n\n    try {\n      if (sessionTarget === 'main') {\n        return await this.executeMainSession(job, signal, timeout);\n      } else {\n        return await this.executeIsolated(job, signal, timeout);\n      }\n    } catch (error) {\n      return {\n        status: 'error',\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  /**\n   * Execute in main session - sends system event\n   */\n  private async executeMainSession(\n    job: JobData,\n    signal: AbortSignal,\n    timeout: number\n  ): Promise<CronRunOutcome> {\n    const text = getCronPayloadText(job);\n\n    if (!text || !text.trim()) {\n      return { status: 'skipped', error: 'Main session job requires non-empty message' };\n    }\n\n    // Parse delivery from job config, or parse routing from payload text: \"channel:chat_id:content\"\n    let channel: string;\n    let to: string;\n    let actualMessage: string;\n\n    if (job.delivery?.channel === 'local') {\n      channel = 'local';\n      to = '';\n      actualMessage = text;\n    } else if (job.delivery?.channel && job.delivery?.to) {\n      // Use explicit delivery config\n      channel = job.delivery.channel;\n      to = job.delivery.to;\n      actualMessage = text;\n    } else {\n      // Parse from payload text: \"channel:chat_id:content\"\n      const parts = text.split(':');\n      const hasAtLeastThreeParts = parts.length >= 3;\n      \n      // Check if first part looks like a known channel\n      if (listChannelPlugins().length === 0) {\n        syncChannelPluginsFromManager(bundledChannelPlugins);\n      }\n      const registeredChannelIds = listChannelPlugins().map((p) => p.id);\n      const knownChannels = [...new Set([...registeredChannelIds, 'cli', 'gateway', 'local'])];\n      const firstPartIsChannel = knownChannels.includes(parts[0]);\n      \n      if (hasAtLeastThreeParts && firstPartIsChannel) {\n        channel = parts[0];\n        to = parts[1];\n        actualMessage = parts.slice(2).join(':');\n        log.info(\n          { jobId: job.id, channel, to, parsedFrom: 'message', originalLength: text.length },\n          'Parsed delivery from payload text'\n        );\n      } else {\n        // Fallback to defaults\n        channel = 'cli';\n        to = 'cron';\n        actualMessage = text;\n        log.debug(\n          { jobId: job.id, partsCount: parts.length, firstPart: parts[0], hasDelivery: !!job.delivery },\n          'Using default delivery - message format not recognized'\n        );\n      }\n    }\n\n    // Create timeout promise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => reject(new Error(`Job timed out after ${timeout}ms`)), timeout);\n    });\n\n    // Create execution promise\n    const executePromise = (async () => {\n      // Check for abort\n      if (signal.aborted) {\n        throw new Error('Job was aborted');\n      }\n\n      if (channel === 'local') {\n        log.info(\n          { jobId: job.id, messageLength: actualMessage.length },\n          'Cron main session: local channel — no outbound publish'\n        );\n        return {\n          status: 'ok' as const,\n          summary: actualMessage.slice(0, 200),\n        };\n      }\n\n      const outbound = await this.buildCronOutboundMessage(channel, to, actualMessage);\n\n      await this.messageBus.publishOutbound(outbound);\n\n      log.info(\n        { jobId: job.id, channel, to: outbound.chat_id, messageLength: actualMessage.length },\n        'Sent message to main session'\n      );\n\n      return {\n        status: 'ok' as const,\n        summary: actualMessage.slice(0, 200),\n      };\n    })();\n\n    // Race against timeout\n    return await Promise.race([executePromise, timeoutPromise]);\n  }\n\n  /**\n   * Execute in isolated mode - runs agent independently\n   */\n  private async executeIsolated(\n    job: JobData,\n    signal: AbortSignal,\n    timeout: number\n  ): Promise<CronRunOutcome> {\n    const message = getCronPayloadText(job);\n\n    if (!message || !message.trim()) {\n      return { status: 'skipped', error: 'Isolated job requires non-empty message' };\n    }\n\n    const aid = job.agentId?.trim();\n    const fallbackAgentId = this.getDefaultCronAgentId?.() ?? DEFAULT_AGENT_ID;\n    const sessionKey = buildSessionKey({\n      agentId: normalizeAgentId(aid || fallbackAgentId),\n      source: 'cron',\n      accountId: 'default',\n      peerKind: 'dm',\n      peerId: job.id,\n    });\n\n    // Create timeout promise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => reject(new Error(`Job timed out after ${timeout}ms`)), timeout);\n    });\n\n    // Create execution promise\n    const executePromise = (async () => {\n      // Check for abort\n      if (signal.aborted) {\n        throw new Error('Job was aborted');\n      }\n\n      await this.agentService.sessionConfig.applyCronJobWorkingDirectory(sessionKey, job.workingDirectory);\n\n      const jobModel = resolveIsolatedCronJobModel(job);\n      if (jobModel) {\n        const ok = await this.agentService.switchModelForSession(sessionKey, jobModel);\n        if (!ok) {\n          log.warn({ jobId: job.id, sessionKey, model: jobModel }, 'Cron job model invalid; using agent default');\n          await this.agentService.resetSessionModelToAgentDefault(sessionKey);\n        }\n      } else {\n        await this.agentService.resetSessionModelToAgentDefault(sessionKey);\n      }\n\n      const response = await this.agentService.turnDispatcher.processDirect(message, sessionKey);\n\n      const model = this.agentService.getModelForSession(sessionKey);\n\n      log.info(\n        { jobId: job.id, sessionKey, responseLength: response.length, model },\n        'Agent execution completed'\n      );\n\n      // Handle delivery (`local` channel or `mode: none` = no outbound; transcript in SessionStore)\n      const delivery = job.delivery;\n      const outboundChannel = delivery?.channel;\n      const shouldPublish =\n        delivery &&\n        delivery.mode !== 'none' &&\n        outboundChannel !== 'local' &&\n        delivery.to;\n\n      if (shouldPublish) {\n        if (shouldSilence(response, DEFAULT_ACK_MAX_CHARS) || response.trim() === NO_REPLY) {\n          return {\n            status: 'ok' as const,\n            summary: response.slice(0, 200),\n            sessionId: sessionKey,\n            sessionKey,\n            sessionType: 'cron',\n            model,\n          };\n        }\n        const { stripped } = stripHeartbeatToken(response);\n        const outboundText = stripped || response.trim();\n\n        const targetChannel = outboundChannel || 'cli';\n        const outbound = await this.buildCronOutboundMessage(targetChannel, delivery.to, outboundText);\n\n        await this.messageBus.publishOutbound(outbound);\n\n        log.info(\n          { jobId: job.id, channel: targetChannel, to: outbound.chat_id },\n          'Delivered agent response'\n        );\n\n        return {\n          status: 'ok' as const,\n          summary: response.slice(0, 200),\n          sessionId: sessionKey,\n          sessionKey,\n          sessionType: 'cron',\n          model,\n        };\n      }\n\n      // No outbound delivery: transcript is in SessionStore under `sessionKey`.\n      return {\n        status: 'ok' as const,\n        summary: response.slice(0, 200),\n        sessionId: sessionKey,\n        sessionKey,\n        sessionType: 'cron',\n        model,\n      };\n    })();\n\n    // Race against timeout\n    try {\n      return await Promise.race([executePromise, timeoutPromise]);\n    } finally {\n      const { retireSessionMcpRuntimeForSessionKey } = await import('../agent/mcp/bundle-mcp-tools.js');\n      await retireSessionMcpRuntimeForSessionKey({\n        sessionKey,\n        reason: 'cron-isolated-end',\n      }).catch(() => {});\n    }\n  }\n\n  /**\n   * Basic execution without agent service (fallback)\n   */\n  private async basicExecute(\n    job: JobData,\n    signal: AbortSignal,\n    timeout: number\n  ): Promise<CronRunOutcome> {\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        reject(new Error(`Job timed out after ${timeout}ms`));\n      }, timeout);\n\n      // Listen for abort signal\n      const abortHandler = () => {\n        clearTimeout(timeoutId);\n        reject(new Error('Job was aborted'));\n      };\n      signal.addEventListener('abort', abortHandler);\n\n      // Simulate basic work\n      setTimeout(() => {\n        clearTimeout(timeoutId);\n        signal.removeEventListener('abort', abortHandler);\n\n        if (signal.aborted) {\n          reject(new Error('Job was aborted'));\n        } else {\n          resolve({\n            status: 'ok',\n            summary: `Executed: ${getCronPayloadText(job).slice(0, 100)}`,\n          });\n        }\n      }, 100);\n    });\n  }\n\n  /**\n   * Cancel a running job\n   */\n  cancelJob(jobId: string): boolean {\n    const controller = this.runningJobs.get(jobId);\n    if (controller) {\n      controller.abort();\n      this.runningJobs.delete(jobId);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Get execution history for a job\n   */\n  getHistory(jobId: string, limit = 10): JobExecution[] {\n    const history = this.history.get(jobId) || [];\n    return history.slice(-limit);\n  }\n\n  /**\n   * Get currently running executions\n   */\n  getRunningExecutions(): JobExecution[] {\n    const result: JobExecution[] = [];\n    for (const [jobId] of this.runningJobs) {\n      const history = this.history.get(jobId);\n      if (history) {\n        const running = history.find((e) => e.status === 'running');\n        if (running) result.push(running);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Check if a job is currently running\n   */\n  isRunning(jobId: string): boolean {\n    return this.runningJobs.has(jobId);\n  }\n\n  /**\n   * Get consecutive error count for a job\n   */\n  getConsecutiveErrors(jobId: string): number {\n    const history = this.history.get(jobId) || [];\n    // Find last execution\n    for (let i = history.length - 1; i >= 0; i--) {\n      if (history[i].status !== 'running') {\n        if (history[i].status === 'failed' || history[i].status === 'cancelled') {\n          // Count consecutive errors before this\n          let count = 0;\n          for (let j = i - 1; j >= 0; j--) {\n            if (history[j].status === 'failed' || history[j].status === 'cancelled') {\n              count++;\n            } else {\n              break;\n            }\n          }\n          return count + 1;\n        }\n        return 0;\n      }\n    }\n    return 0;\n  }\n\n  /**\n   * Calculate backoff delay for a job\n   */\n  calculateBackoff(jobId: string): number {\n    const errors = this.getConsecutiveErrors(jobId);\n    return errorBackoffMs(errors);\n  }\n\n  /**\n   * Clear old history entries\n   */\n  cleanupHistory(maxAgeDays = 7): void {\n    const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;\n\n    for (const [jobId, executions] of this.history) {\n      this.history.set(\n        jobId,\n        executions.filter((e) => new Date(e.startedAt).getTime() > cutoff)\n      );\n    }\n  }\n\n  private addToHistory(jobId: string, execution: JobExecution): void {\n    const existing = this.history.get(jobId) || [];\n    existing.push(execution);\n    // Keep last 100 executions per job\n    if (existing.length > 100) {\n      existing.shift();\n    }\n    this.history.set(jobId, existing);\n  }\n}\n"],"mappings":";;;;;;;;;aAUkD;kBAgB2B;kBACjB;AAE5D,MAAM,MAAM,aAAa,eAAe;AAGxC,MAAM,mBAAmB;CACvB;CACA;CACA,IAAI;CACJ,KAAK;CACL,KAAK;CACN;AAED,SAAS,eAAe,mBAAmC;CACzD,MAAM,MAAM,KAAK,IAAI,oBAAoB,GAAG,iBAAiB,SAAS,EAAE;AACxE,QAAO,iBAAiB,KAAK,IAAI,GAAG,IAAI;;AAG1C,SAAS,4BAA4B,KAAkC;CACrE,MAAM,UAAU,IAAI,OAAO,MAAM;AACjC,KAAI,QAAS,QAAO;AACpB,KAAI,IAAI,SAAS,SAAS,aAAa;EACrC,MAAM,IAAI,IAAI,QAAQ,OAAO,MAAM;AACnC,MAAI,EAAG,QAAO;;;AAKlB,IAAa,qBAAb,MAAuD;CACrD,0BAA+C,IAAI,KAAK;CACxD,8BAAsB,IAAI,KAA8B;CACxD,eAA4B;CAC5B,aAA0B;CAC1B,mBAAqD;CACrD;CACA,cAA8C;CAC9C,wBAAuD;CAEvD,eAAe,OAAqC;AAClD,OAAK,cAAc;;CAGrB,QAAQ,MAA6B;AACnC,OAAK,eAAe,KAAK;AACzB,OAAK,aAAa,KAAK;AACvB,OAAK,mBAAmB,KAAK,oBAAoB;AACjD,MAAI,KAAK,iBAAiB,KAAA,EACxB,MAAK,eAAe,KAAK;AAE3B,OAAK,wBAAwB,KAAK,yBAAyB;;CAG7D,MAAc,yBACZ,SACA,IACA,SAC0B;AAC1B,MAAI,oBAAoB,CAAC,WAAW,EAClC,+BAA8B,sBAAsB;EAEtD,MAAM,SAAS,iBAAiB,QAAQ;AACxC,MAAI,QAAQ,cAAc;GACxB,MAAM,EAAE,QAAQ,WAAW,aAAa,MAAM,OAAO,aAAa,wBAChE,IACA,KAAK,aACN;GACD,MAAM,OACJ,aAAa,WACT;IAAE,GAAI,YAAY,EAAE;IAAG,GAAI,YAAY,EAAE,WAAW,GAAG,EAAE;IAAG,GAC5D,KAAA;AACN,UAAO;IACL;IACA,SAAS;IACT;IACA,MAAM;IACN,GAAI,QAAQ,OAAO,KAAK,KAAK,CAAC,SAAS,IAAI,EAAE,UAAU,MAAM,GAAG,EAAE;IACnE;;AAEH,SAAO;GACL;GACA,SAAS;GACT;GACA,MAAM;GACP;;CAGH,MAAM,QAAQ,KAAc,QAAqB,MAAuC;AAEtF,MAAI,KACF,MAAK,QAAQ,KAAK;EAGpB,MAAM,cAAc,OAAO,YAAY;EACvC,MAAM,YAA0B;GAC9B,IAAI;GACJ,OAAO,IAAI;GACX,QAAQ;GACR,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,YAAY;GACb;AAGD,OAAK,aAAa,IAAI,IAAI,UAAU;AACpC,OAAK,YAAY,IAAI,IAAI,IAAI,IAAI,iBAAiB,CAAC;AAEnD,MAAI,KACF;GAAE,OAAO,IAAI;GAAI;GAAa,SAAS,mBAAmB,IAAI,CAAC,MAAM,GAAG,IAAI;GAAE,EAC9E,gBACD;EAED,IAAI;AAEJ,MAAI;AAEF,OAAI,OAAO,QACT,OAAM,IAAI,MAAM,qCAAqC;AAIvD,YAAS,MAAM,KAAK,WAAW,KAAK,OAAO;AAG3C,aAAU,SAAS,OAAO,WAAW,OAAO,YAAY,OAAO,WAAW,YAAY,cAAc;AACpG,aAAU,2BAAU,IAAI,MAAM,EAAC,aAAa;AAC5C,aAAU,WAAW,KAAK,KAAK,GAAG,IAAI,KAAK,UAAU,UAAU,CAAC,SAAS;AACzE,aAAU,UAAU,OAAO;AAC3B,aAAU,QAAQ,OAAO;AACzB,aAAU,YAAY,OAAO;AAC7B,aAAU,aAAa,OAAO;AAC9B,aAAU,cAAc,OAAO;AAC/B,aAAU,QAAQ,OAAO;AAEzB,OAAI,OAAO,WAAW,KACpB,KAAI,KACF;IAAE,OAAO,IAAI;IAAI;IAAa,UAAU,UAAU;IAAU,EAC5D,gBACD;YACQ,OAAO,WAAW,UAC3B,KAAI,KAAK;IAAE,OAAO,IAAI;IAAI;IAAa,QAAQ,OAAO;IAAO,EAAE,cAAc;OAE7E,KAAI,MACF;IAAE,OAAO,IAAI;IAAI;IAAa,OAAO,OAAO;IAAO,EACnD,aACD;AAGH,OAAI,OAAO,WAAW,QAAQ,KAAK,iBACjC,KAAI;AACF,SAAK,iBAAiB,WAAW,EAAE,QAAQ,QAAQ,IAAI,MAAM,CAAC;YACvD,GAAG;AACV,QAAI,KAAK;KAAE,OAAO,IAAI;KAAI,KAAK;KAAG,EAAE,mCAAmC;;WAGpE,OAAO;AACd,aAAU,SAAS;AACnB,aAAU,2BAAU,IAAI,MAAM,EAAC,aAAa;AAC5C,aAAU,WAAW,KAAK,KAAK,GAAG,IAAI,KAAK,UAAU,UAAU,CAAC,SAAS;AACzE,aAAU,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAExE,OAAI,MACF;IAAE,OAAO,IAAI;IAAI;IAAa,OAAO,UAAU;IAAO,EACtD,sBACD;AAED,YAAS;IACP,QAAQ;IACR,OAAO,UAAU;IAClB;YACO;AACR,QAAK,YAAY,OAAO,IAAI,GAAG;;AAGjC,MAAI,KAAK,YACP,OAAM,KAAK,YAAY,gBAAgB,UAAU;;;;;CASrD,MAAgB,WAAW,KAAc,QAA8C;EACrF,MAAM,UAAU,IAAI,WAAW;EAC/B,MAAM,gBAAgB,IAAI,iBAAiB;AAG3C,MAAI,OAAO,QACT,QAAO;GAAE,QAAQ;GAAW,OAAO;GAAoC;AAIzE,MAAI,CAAC,KAAK,gBAAgB,CAAC,KAAK,YAAY;AAC1C,OAAI,KAAK,EAAE,OAAO,IAAI,IAAI,EAAE,qDAAqD;AACjF,UAAO,KAAK,aAAa,KAAK,QAAQ,QAAQ;;AAGhD,MAAI;AACF,OAAI,kBAAkB,OACpB,QAAO,MAAM,KAAK,mBAAmB,KAAK,QAAQ,QAAQ;OAE1D,QAAO,MAAM,KAAK,gBAAgB,KAAK,QAAQ,QAAQ;WAElD,OAAO;AACd,UAAO;IACL,QAAQ;IACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D;;;;;;CAOL,MAAc,mBACZ,KACA,QACA,SACyB;EACzB,MAAM,OAAO,mBAAmB,IAAI;AAEpC,MAAI,CAAC,QAAQ,CAAC,KAAK,MAAM,CACvB,QAAO;GAAE,QAAQ;GAAW,OAAO;GAA+C;EAIpF,IAAI;EACJ,IAAI;EACJ,IAAI;AAEJ,MAAI,IAAI,UAAU,YAAY,SAAS;AACrC,aAAU;AACV,QAAK;AACL,mBAAgB;aACP,IAAI,UAAU,WAAW,IAAI,UAAU,IAAI;AAEpD,aAAU,IAAI,SAAS;AACvB,QAAK,IAAI,SAAS;AAClB,mBAAgB;SACX;GAEL,MAAM,QAAQ,KAAK,MAAM,IAAI;GAC7B,MAAM,uBAAuB,MAAM,UAAU;AAG7C,OAAI,oBAAoB,CAAC,WAAW,EAClC,+BAA8B,sBAAsB;GAEtD,MAAM,uBAAuB,oBAAoB,CAAC,KAAK,MAAM,EAAE,GAAG;GAElE,MAAM,qBAAqB,CADJ,GAAG,IAAI,IAAI;IAAC,GAAG;IAAsB;IAAO;IAAW;IAAQ,CAAC,CAC/C,CAAC,SAAS,MAAM,GAAG;AAE3D,OAAI,wBAAwB,oBAAoB;AAC9C,cAAU,MAAM;AAChB,SAAK,MAAM;AACX,oBAAgB,MAAM,MAAM,EAAE,CAAC,KAAK,IAAI;AACxC,QAAI,KACF;KAAE,OAAO,IAAI;KAAI;KAAS;KAAI,YAAY;KAAW,gBAAgB,KAAK;KAAQ,EAClF,oCACD;UACI;AAEL,cAAU;AACV,SAAK;AACL,oBAAgB;AAChB,QAAI,MACF;KAAE,OAAO,IAAI;KAAI,YAAY,MAAM;KAAQ,WAAW,MAAM;KAAI,aAAa,CAAC,CAAC,IAAI;KAAU,EAC7F,yDACD;;;EAKL,MAAM,iBAAiB,IAAI,SAAgB,GAAG,WAAW;AACvD,oBAAiB,uBAAO,IAAI,MAAM,uBAAuB,QAAQ,IAAI,CAAC,EAAE,QAAQ;IAChF;EAGF,MAAM,kBAAkB,YAAY;AAElC,OAAI,OAAO,QACT,OAAM,IAAI,MAAM,kBAAkB;AAGpC,OAAI,YAAY,SAAS;AACvB,QAAI,KACF;KAAE,OAAO,IAAI;KAAI,eAAe,cAAc;KAAQ,EACtD,yDACD;AACD,WAAO;KACL,QAAQ;KACR,SAAS,cAAc,MAAM,GAAG,IAAI;KACrC;;GAGH,MAAM,WAAW,MAAM,KAAK,yBAAyB,SAAS,IAAI,cAAc;AAEhF,SAAM,KAAK,WAAW,gBAAgB,SAAS;AAE/C,OAAI,KACF;IAAE,OAAO,IAAI;IAAI;IAAS,IAAI,SAAS;IAAS,eAAe,cAAc;IAAQ,EACrF,+BACD;AAED,UAAO;IACL,QAAQ;IACR,SAAS,cAAc,MAAM,GAAG,IAAI;IACrC;MACC;AAGJ,SAAO,MAAM,QAAQ,KAAK,CAAC,gBAAgB,eAAe,CAAC;;;;;CAM7D,MAAc,gBACZ,KACA,QACA,SACyB;EACzB,MAAM,UAAU,mBAAmB,IAAI;AAEvC,MAAI,CAAC,WAAW,CAAC,QAAQ,MAAM,CAC7B,QAAO;GAAE,QAAQ;GAAW,OAAO;GAA2C;EAGhF,MAAM,MAAM,IAAI,SAAS,MAAM;EAC/B,MAAM,kBAAkB,KAAK,yBAAyB,IAAA;EACtD,MAAM,aAAa,gBAAgB;GACjC,SAAS,iBAAiB,OAAO,gBAAgB;GACjD,QAAQ;GACR,WAAW;GACX,UAAU;GACV,QAAQ,IAAI;GACb,CAAC;EAGF,MAAM,iBAAiB,IAAI,SAAgB,GAAG,WAAW;AACvD,oBAAiB,uBAAO,IAAI,MAAM,uBAAuB,QAAQ,IAAI,CAAC,EAAE,QAAQ;IAChF;EAGF,MAAM,kBAAkB,YAAY;AAElC,OAAI,OAAO,QACT,OAAM,IAAI,MAAM,kBAAkB;AAGpC,SAAM,KAAK,aAAa,cAAc,6BAA6B,YAAY,IAAI,iBAAiB;GAEpG,MAAM,WAAW,4BAA4B,IAAI;AACjD,OAAI;QAEE,CAAC,MADY,KAAK,aAAa,sBAAsB,YAAY,SAAS,EACrE;AACP,SAAI,KAAK;MAAE,OAAO,IAAI;MAAI;MAAY,OAAO;MAAU,EAAE,8CAA8C;AACvG,WAAM,KAAK,aAAa,gCAAgC,WAAW;;SAGrE,OAAM,KAAK,aAAa,gCAAgC,WAAW;GAGrE,MAAM,WAAW,MAAM,KAAK,aAAa,eAAe,cAAc,SAAS,WAAW;GAE1F,MAAM,QAAQ,KAAK,aAAa,mBAAmB,WAAW;AAE9D,OAAI,KACF;IAAE,OAAO,IAAI;IAAI;IAAY,gBAAgB,SAAS;IAAQ;IAAO,EACrE,4BACD;GAGD,MAAM,WAAW,IAAI;GACrB,MAAM,kBAAkB,UAAU;AAOlC,OALE,YACA,SAAS,SAAS,UAClB,oBAAoB,WACpB,SAAS,IAEQ;AACjB,QAAI,cAAc,UAAA,IAAgC,IAAI,SAAS,MAAM,KAAA,WACnE,QAAO;KACL,QAAQ;KACR,SAAS,SAAS,MAAM,GAAG,IAAI;KAC/B,WAAW;KACX;KACA,aAAa;KACb;KACD;IAEH,MAAM,EAAE,aAAa,oBAAoB,SAAS;IAClD,MAAM,eAAe,YAAY,SAAS,MAAM;IAEhD,MAAM,gBAAgB,mBAAmB;IACzC,MAAM,WAAW,MAAM,KAAK,yBAAyB,eAAe,SAAS,IAAI,aAAa;AAE9F,UAAM,KAAK,WAAW,gBAAgB,SAAS;AAE/C,QAAI,KACF;KAAE,OAAO,IAAI;KAAI,SAAS;KAAe,IAAI,SAAS;KAAS,EAC/D,2BACD;AAED,WAAO;KACL,QAAQ;KACR,SAAS,SAAS,MAAM,GAAG,IAAI;KAC/B,WAAW;KACX;KACA,aAAa;KACb;KACD;;AAIH,UAAO;IACL,QAAQ;IACR,SAAS,SAAS,MAAM,GAAG,IAAI;IAC/B,WAAW;IACX;IACA,aAAa;IACb;IACD;MACC;AAGJ,MAAI;AACF,UAAO,MAAM,QAAQ,KAAK,CAAC,gBAAgB,eAAe,CAAC;YACnD;GACR,MAAM,EAAE,yCAAyC,MAAM,OAAO;AAC9D,SAAM,qCAAqC;IACzC;IACA,QAAQ;IACT,CAAC,CAAC,YAAY,GAAG;;;;;;CAOtB,MAAc,aACZ,KACA,QACA,SACyB;AACzB,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,YAAY,iBAAiB;AACjC,2BAAO,IAAI,MAAM,uBAAuB,QAAQ,IAAI,CAAC;MACpD,QAAQ;GAGX,MAAM,qBAAqB;AACzB,iBAAa,UAAU;AACvB,2BAAO,IAAI,MAAM,kBAAkB,CAAC;;AAEtC,UAAO,iBAAiB,SAAS,aAAa;AAG9C,oBAAiB;AACf,iBAAa,UAAU;AACvB,WAAO,oBAAoB,SAAS,aAAa;AAEjD,QAAI,OAAO,QACT,wBAAO,IAAI,MAAM,kBAAkB,CAAC;QAEpC,SAAQ;KACN,QAAQ;KACR,SAAS,aAAa,mBAAmB,IAAI,CAAC,MAAM,GAAG,IAAI;KAC5D,CAAC;MAEH,IAAI;IACP;;;;;CAMJ,UAAU,OAAwB;EAChC,MAAM,aAAa,KAAK,YAAY,IAAI,MAAM;AAC9C,MAAI,YAAY;AACd,cAAW,OAAO;AAClB,QAAK,YAAY,OAAO,MAAM;AAC9B,UAAO;;AAET,SAAO;;;;;CAMT,WAAW,OAAe,QAAQ,IAAoB;AAEpD,UADgB,KAAK,QAAQ,IAAI,MAAM,IAAI,EAAE,EAC9B,MAAM,CAAC,MAAM;;;;;CAM9B,uBAAuC;EACrC,MAAM,SAAyB,EAAE;AACjC,OAAK,MAAM,CAAC,UAAU,KAAK,aAAa;GACtC,MAAM,UAAU,KAAK,QAAQ,IAAI,MAAM;AACvC,OAAI,SAAS;IACX,MAAM,UAAU,QAAQ,MAAM,MAAM,EAAE,WAAW,UAAU;AAC3D,QAAI,QAAS,QAAO,KAAK,QAAQ;;;AAGrC,SAAO;;;;;CAMT,UAAU,OAAwB;AAChC,SAAO,KAAK,YAAY,IAAI,MAAM;;;;;CAMpC,qBAAqB,OAAuB;EAC1C,MAAM,UAAU,KAAK,QAAQ,IAAI,MAAM,IAAI,EAAE;AAE7C,OAAK,IAAI,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,IACvC,KAAI,QAAQ,GAAG,WAAW,WAAW;AACnC,OAAI,QAAQ,GAAG,WAAW,YAAY,QAAQ,GAAG,WAAW,aAAa;IAEvE,IAAI,QAAQ;AACZ,SAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,IAC1B,KAAI,QAAQ,GAAG,WAAW,YAAY,QAAQ,GAAG,WAAW,YAC1D;QAEA;AAGJ,WAAO,QAAQ;;AAEjB,UAAO;;AAGX,SAAO;;;;;CAMT,iBAAiB,OAAuB;AAEtC,SAAO,eADQ,KAAK,qBAAqB,MACb,CAAC;;;;;CAM/B,eAAe,aAAa,GAAS;EACnC,MAAM,SAAS,KAAK,KAAK,GAAG,aAAa,KAAK,KAAK,KAAK;AAExD,OAAK,MAAM,CAAC,OAAO,eAAe,KAAK,QACrC,MAAK,QAAQ,IACX,OACA,WAAW,QAAQ,MAAM,IAAI,KAAK,EAAE,UAAU,CAAC,SAAS,GAAG,OAAO,CACnE;;CAIL,aAAqB,OAAe,WAA+B;EACjE,MAAM,WAAW,KAAK,QAAQ,IAAI,MAAM,IAAI,EAAE;AAC9C,WAAS,KAAK,UAAU;AAExB,MAAI,SAAS,SAAS,IACpB,UAAS,OAAO;AAElB,OAAK,QAAQ,IAAI,OAAO,SAAS"}

package/dist/src/cron/persistence.js

@@ -1,6 +1,6 @@
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { JobDataSchema } from "./validation.js";
 import { access, readFile } from "fs/promises";
 //#region src/cron/persistence.ts

package/dist/src/cron/run-log-store.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveCronRunsDir } from "../config/paths.js";
-import { join } from "path";
 import { appendFile, mkdir, readFile, readdir, unlink, writeFile } from "fs/promises";
+import { join } from "path";
 //#region src/cron/run-log-store.ts
 init_paths();
 init_logger();

package/dist/src/daemon/index.d.ts

@@ -24,4 +24,3 @@ export * from './types.js';
 export * from './constants.js';
 export * from './service.js';
 export * from './install-plan.js';
-export * from './launchd-restart-handoff.js';

package/dist/src/daemon/index.js

@@ -1,5 +1,4 @@
 import { DEFAULT_GATEWAY_PORT, LAUNCH_AGENT_EXIT_TIMEOUT_SECONDS, LAUNCH_AGENT_THROTTLE_INTERVAL_SECONDS, SERVICE_VERSION_ENV_KEY, SYSTEMD_RESTART_SEC, SYSTEMD_START_LIMIT_BURST, SYSTEMD_START_LIMIT_INTERVAL_SEC, formatGatewayServiceDescription, resolveGatewayLaunchAgentLabel, resolveGatewaySystemdServiceName, resolveGatewayWindowsTaskName, resolveLaunchAgentPlistPath, resolveSystemdUnitPath } from "./constants.js";
 import { describeGatewayServiceRestart, getPlatformName, getServiceLabel, isDaemonAvailable, isDaemonAvailableAsync, resolveGatewayService, startGatewayService } from "./service.js";
 import { buildGatewayInstallArgs, buildGatewayInstallPlan, validateInstallPlanProgram } from "./install-plan.js";
-import { scheduleDetachedLaunchdRestartHandoff } from "./launchd-restart-handoff.js";
-export { DEFAULT_GATEWAY_PORT, LAUNCH_AGENT_EXIT_TIMEOUT_SECONDS, LAUNCH_AGENT_THROTTLE_INTERVAL_SECONDS, SERVICE_VERSION_ENV_KEY, SYSTEMD_RESTART_SEC, SYSTEMD_START_LIMIT_BURST, SYSTEMD_START_LIMIT_INTERVAL_SEC, buildGatewayInstallArgs, buildGatewayInstallPlan, describeGatewayServiceRestart, formatGatewayServiceDescription, getPlatformName, getServiceLabel, isDaemonAvailable, isDaemonAvailableAsync, resolveGatewayLaunchAgentLabel, resolveGatewayService, resolveGatewaySystemdServiceName, resolveGatewayWindowsTaskName, resolveLaunchAgentPlistPath, resolveSystemdUnitPath, scheduleDetachedLaunchdRestartHandoff, startGatewayService, validateInstallPlanProgram };
+export { DEFAULT_GATEWAY_PORT, LAUNCH_AGENT_EXIT_TIMEOUT_SECONDS, LAUNCH_AGENT_THROTTLE_INTERVAL_SECONDS, SERVICE_VERSION_ENV_KEY, SYSTEMD_RESTART_SEC, SYSTEMD_START_LIMIT_BURST, SYSTEMD_START_LIMIT_INTERVAL_SEC, buildGatewayInstallArgs, buildGatewayInstallPlan, describeGatewayServiceRestart, formatGatewayServiceDescription, getPlatformName, getServiceLabel, isDaemonAvailable, isDaemonAvailableAsync, resolveGatewayLaunchAgentLabel, resolveGatewayService, resolveGatewaySystemdServiceName, resolveGatewayWindowsTaskName, resolveLaunchAgentPlistPath, resolveSystemdUnitPath, startGatewayService, validateInstallPlanProgram };

package/dist/src/daemon/install-plan.js

@@ -2,9 +2,9 @@ import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { SERVICE_VERSION_ENV_KEY, formatGatewayServiceDescription } from "./constants.js";
+import { existsSync } from "node:fs";
 import path from "node:path";
 import { homedir } from "node:os";
-import { existsSync } from "node:fs";
 //#region src/daemon/install-plan.ts
 /**
 * Install Plan Builder - Build gateway installation configuration
@@ -69,7 +69,8 @@ function buildGatewayInstallPlan(params) {
 		XOPC_LOG_FILE: "true",
 		XOPC_LOG_CONSOLE: "false",
 		XOPC_LOG_DIR: resolveLogDir(),
-		[SERVICE_VERSION_ENV_KEY]: version
+		[SERVICE_VERSION_ENV_KEY]: version,
+		XOPC_SERVICE_MARKER: "1"
 	};
 	if (params.token) environment.XOPC_GATEWAY_TOKEN = params.token;
 	for (const key of [

package/dist/src/daemon/install-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"install-plan.js","names":[],"sources":["../../../src/daemon/install-plan.ts"],"sourcesContent":["/**\n * Install Plan Builder - Build gateway installation configuration\n *\n * Aligned with OpenClaw: adds XOPC_SERVICE_VERSION, StandardOut/ErrorPath,\n * supports binary runtime detection, and --foreground arg passing.\n */\n\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { homedir } from 'node:os';\nimport { createLogger } from '../utils/logger.js';\nimport { SERVICE_VERSION_ENV_KEY, formatGatewayServiceDescription } from './constants.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport type { GatewayServiceInstallArgs, GatewayServiceEnv } from './types.js';\n\nconst log = createLogger('InstallPlan');\n\nexport interface InstallPlan {\n  programArguments: string[];\n  workingDirectory: string;\n  environment: Record<string, string>;\n  description: string;\n}\n\n// ─── Path Resolution ───\n\nfunction resolveDefaultConfigPath(): string {\n  const envConfig = process.env.XOPC_CONFIG || process.env.XOPC_CONFIG_PATH;\n  if (envConfig) return envConfig;\n  return path.join(homedir(), '.xopc', 'xopc.json');\n}\n\nfunction resolveDefaultWorkspace(): string {\n  const envWorkspace = process.env.XOPC_WORKSPACE;\n  if (envWorkspace) return envWorkspace;\n  return path.join(homedir(), '.xopc', 'workspace');\n}\n\nfunction resolveLogDir(): string {\n  return path.join(homedir(), '.xopc', 'logs');\n}\n\n// ─── Binary Detection ───\n\nfunction isSEABinary(): boolean {\n  // Node.js SEA (Single Executable Application) detection\n  return !!(process as NodeJS.Process & { pkg?: unknown }).pkg ||\n    process.execPath.endsWith('xopc') ||\n    process.execPath.endsWith('xopc.exe');\n}\n\nfunction resolveEntryPoint(): string {\n  if (isSEABinary()) {\n    return process.execPath;\n  }\n  // Resolve relative to this file's location → ../cli/index.js (built output)\n  const thisDir = path.dirname(new URL(import.meta.url).pathname);\n  return path.join(thisDir, '..', 'cli', 'index.js');\n}\n\n// ─── Plan Builder ───\n\nexport function buildGatewayInstallPlan(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): InstallPlan {\n  const configPath = resolveDefaultConfigPath();\n  const workspace = resolveDefaultWorkspace();\n  const version = params.version || PACKAGE_VERSION;\n\n  // Determine program + arguments\n  let programArguments: string[];\n\n  if (params.runtime === 'binary' || isSEABinary()) {\n    // SEA binary: direct execution\n    const binaryPath = process.execPath;\n    programArguments = [binaryPath, 'gateway', '--foreground', '--port', params.port.toString()];\n  } else {\n    // Node.js runtime\n    const nodeArgs = process.execArgv.filter(\n      (arg) => !arg.startsWith('--inspect') && !arg.startsWith('--debug'),\n    );\n    const entryPoint = resolveEntryPoint();\n    programArguments = [\n      process.execPath,\n      ...nodeArgs,\n      entryPoint,\n      'gateway',\n      '--foreground',\n      '--port', params.port.toString(),\n    ];\n  }\n\n  if (params.bind && params.bind !== 'loopback') {\n    programArguments.push('--bind', params.bind);\n  }\n\n  // Build environment\n  const environment: Record<string, string> = {\n    XOPC_CONFIG: configPath,\n    XOPC_WORKSPACE: workspace,\n    XOPC_LOG_LEVEL: process.env.XOPC_LOG_LEVEL || 'info',\n    XOPC_LOG_FILE: 'true',\n    XOPC_LOG_CONSOLE: 'false',\n    XOPC_LOG_DIR: resolveLogDir(),\n    [SERVICE_VERSION_ENV_KEY]: version,\n  };\n\n  if (params.token) {\n    environment.XOPC_GATEWAY_TOKEN = params.token;\n  }\n\n  // Copy relevant API key env vars\n  const relevantEnvVars = [\n    'OPENAI_API_KEY',\n    'ANTHROPIC_API_KEY',\n    'GOOGLE_API_KEY',\n    'BRAVE_API_KEY',\n    'DASHSCOPE_API_KEY',\n    'XOPC_LOG_RETENTION_DAYS',\n  ];\n\n  for (const key of relevantEnvVars) {\n    if (process.env[key]) {\n      environment[key] = process.env[key]!;\n    }\n  }\n\n  // Add custom env from params (non-XOPC keys only; XOPC keys already handled)\n  if (params.env) {\n    for (const [key, value] of Object.entries(params.env)) {\n      if (value !== undefined && !key.startsWith('XOPC_')) {\n        environment[key] = value;\n      }\n    }\n  }\n\n  // Service description\n  const profile = params.env?.XOPC_PROFILE?.trim() || undefined;\n  const description = formatGatewayServiceDescription({ profile, version });\n\n  log.info({\n    programArguments: programArguments.slice(0, 3),\n    envKeys: Object.keys(environment),\n    version,\n  }, 'Built gateway install plan');\n\n  return {\n    programArguments,\n    workingDirectory: path.dirname(configPath),\n    environment,\n    description,\n  };\n}\n\n// ─── Install Args Builder ───\n\nexport function buildGatewayInstallArgs(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): GatewayServiceInstallArgs {\n  const plan = buildGatewayInstallPlan(params);\n\n  return {\n    env: params.env || process.env,\n    programArguments: plan.programArguments,\n    workingDirectory: plan.workingDirectory,\n    environment: plan.environment,\n    description: plan.description,\n  };\n}\n\n// ─── Validation ───\n\n/** Check if the program in an install plan still exists on disk */\nexport function validateInstallPlanProgram(programArguments: string[]): boolean {\n  if (programArguments.length === 0) return false;\n  const program = programArguments[0];\n  return existsSync(program);\n}\n"],"mappings":";;;;;;;;;;;;;;aAUkD;sBAEM;AAGxD,MAAM,MAAM,aAAa,cAAc;AAWvC,SAAS,2BAAmC;CAC1C,MAAM,YAAY,QAAQ,IAAI,eAAe,QAAQ,IAAI;AACzD,KAAI,UAAW,QAAO;AACtB,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,YAAY;;AAGnD,SAAS,0BAAkC;CACzC,MAAM,eAAe,QAAQ,IAAI;AACjC,KAAI,aAAc,QAAO;AACzB,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,YAAY;;AAGnD,SAAS,gBAAwB;AAC/B,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,OAAO;;AAK9C,SAAS,cAAuB;AAE9B,QAAO,CAAC,CAAE,QAA+C,OACvD,QAAQ,SAAS,SAAS,OAAO,IACjC,QAAQ,SAAS,SAAS,WAAW;;AAGzC,SAAS,oBAA4B;AACnC,KAAI,aAAa,CACf,QAAO,QAAQ;CAGjB,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS;AAC/D,QAAO,KAAK,KAAK,SAAS,MAAM,OAAO,WAAW;;AAKpD,SAAgB,wBAAwB,QAOxB;CACd,MAAM,aAAa,0BAA0B;CAC7C,MAAM,YAAY,yBAAyB;CAC3C,MAAM,UAAU,OAAO,WAAW;CAGlC,IAAI;AAEJ,KAAI,OAAO,YAAY,YAAY,aAAa,CAG9C,oBAAmB;EADA,QAAQ;EACK;EAAW;EAAgB;EAAU,OAAO,KAAK,UAAU;EAAC;MACvF;EAEL,MAAM,WAAW,QAAQ,SAAS,QAC/B,QAAQ,CAAC,IAAI,WAAW,YAAY,IAAI,CAAC,IAAI,WAAW,UAAU,CACpE;EACD,MAAM,aAAa,mBAAmB;AACtC,qBAAmB;GACjB,QAAQ;GACR,GAAG;GACH;GACA;GACA;GACA;GAAU,OAAO,KAAK,UAAU;GACjC;;AAGH,KAAI,OAAO,QAAQ,OAAO,SAAS,WACjC,kBAAiB,KAAK,UAAU,OAAO,KAAK;CAI9C,MAAM,cAAsC;EAC1C,aAAa;EACb,gBAAgB;EAChB,gBAAgB,QAAQ,IAAI,kBAAkB;EAC9C,eAAe;EACf,kBAAkB;EAClB,cAAc,eAAe;GAC5B,0BAA0B;EAC5B;AAED,KAAI,OAAO,MACT,aAAY,qBAAqB,OAAO;AAa1C,MAAK,MAAM,OAAO;EARhB;EACA;EACA;EACA;EACA;EACA;EAG+B,CAC/B,KAAI,QAAQ,IAAI,KACd,aAAY,OAAO,QAAQ,IAAI;AAKnC,KAAI,OAAO;OACJ,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,IAAI,CACnD,KAAI,UAAU,KAAA,KAAa,CAAC,IAAI,WAAW,QAAQ,CACjD,aAAY,OAAO;;CAOzB,MAAM,cAAc,gCAAgC;EAAE,SADtC,OAAO,KAAK,cAAc,MAAM,IAAI,KAAA;EACW;EAAS,CAAC;AAEzE,KAAI,KAAK;EACP,kBAAkB,iBAAiB,MAAM,GAAG,EAAE;EAC9C,SAAS,OAAO,KAAK,YAAY;EACjC;EACD,EAAE,6BAA6B;AAEhC,QAAO;EACL;EACA,kBAAkB,KAAK,QAAQ,WAAW;EAC1C;EACA;EACD;;AAKH,SAAgB,wBAAwB,QAOV;CAC5B,MAAM,OAAO,wBAAwB,OAAO;AAE5C,QAAO;EACL,KAAK,OAAO,OAAO,QAAQ;EAC3B,kBAAkB,KAAK;EACvB,kBAAkB,KAAK;EACvB,aAAa,KAAK;EAClB,aAAa,KAAK;EACnB;;;AAMH,SAAgB,2BAA2B,kBAAqC;AAC9E,KAAI,iBAAiB,WAAW,EAAG,QAAO;CAC1C,MAAM,UAAU,iBAAiB;AACjC,QAAO,WAAW,QAAQ"}
+{"version":3,"file":"install-plan.js","names":[],"sources":["../../../src/daemon/install-plan.ts"],"sourcesContent":["/**\n * Install Plan Builder - Build gateway installation configuration\n *\n * Aligned with OpenClaw: adds XOPC_SERVICE_VERSION, StandardOut/ErrorPath,\n * supports binary runtime detection, and --foreground arg passing.\n */\n\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { homedir } from 'node:os';\nimport { createLogger } from '../utils/logger.js';\nimport { SERVICE_VERSION_ENV_KEY, formatGatewayServiceDescription } from './constants.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport type { GatewayServiceInstallArgs, GatewayServiceEnv } from './types.js';\n\nconst log = createLogger('InstallPlan');\n\nexport interface InstallPlan {\n  programArguments: string[];\n  workingDirectory: string;\n  environment: Record<string, string>;\n  description: string;\n}\n\n// ─── Path Resolution ───\n\nfunction resolveDefaultConfigPath(): string {\n  const envConfig = process.env.XOPC_CONFIG || process.env.XOPC_CONFIG_PATH;\n  if (envConfig) return envConfig;\n  return path.join(homedir(), '.xopc', 'xopc.json');\n}\n\nfunction resolveDefaultWorkspace(): string {\n  const envWorkspace = process.env.XOPC_WORKSPACE;\n  if (envWorkspace) return envWorkspace;\n  return path.join(homedir(), '.xopc', 'workspace');\n}\n\nfunction resolveLogDir(): string {\n  return path.join(homedir(), '.xopc', 'logs');\n}\n\n// ─── Binary Detection ───\n\nfunction isSEABinary(): boolean {\n  // Node.js SEA (Single Executable Application) detection\n  return !!(process as NodeJS.Process & { pkg?: unknown }).pkg ||\n    process.execPath.endsWith('xopc') ||\n    process.execPath.endsWith('xopc.exe');\n}\n\nfunction resolveEntryPoint(): string {\n  if (isSEABinary()) {\n    return process.execPath;\n  }\n  // Resolve relative to this file's location → ../cli/index.js (built output)\n  const thisDir = path.dirname(new URL(import.meta.url).pathname);\n  return path.join(thisDir, '..', 'cli', 'index.js');\n}\n\n// ─── Plan Builder ───\n\nexport function buildGatewayInstallPlan(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): InstallPlan {\n  const configPath = resolveDefaultConfigPath();\n  const workspace = resolveDefaultWorkspace();\n  const version = params.version || PACKAGE_VERSION;\n\n  // Determine program + arguments\n  let programArguments: string[];\n\n  if (params.runtime === 'binary' || isSEABinary()) {\n    // SEA binary: direct execution\n    const binaryPath = process.execPath;\n    programArguments = [binaryPath, 'gateway', '--foreground', '--port', params.port.toString()];\n  } else {\n    // Node.js runtime\n    const nodeArgs = process.execArgv.filter(\n      (arg) => !arg.startsWith('--inspect') && !arg.startsWith('--debug'),\n    );\n    const entryPoint = resolveEntryPoint();\n    programArguments = [\n      process.execPath,\n      ...nodeArgs,\n      entryPoint,\n      'gateway',\n      '--foreground',\n      '--port', params.port.toString(),\n    ];\n  }\n\n  if (params.bind && params.bind !== 'loopback') {\n    programArguments.push('--bind', params.bind);\n  }\n\n  // Build environment\n  const environment: Record<string, string> = {\n    XOPC_CONFIG: configPath,\n    XOPC_WORKSPACE: workspace,\n    XOPC_LOG_LEVEL: process.env.XOPC_LOG_LEVEL || 'info',\n    XOPC_LOG_FILE: 'true',\n    XOPC_LOG_CONSOLE: 'false',\n    XOPC_LOG_DIR: resolveLogDir(),\n    [SERVICE_VERSION_ENV_KEY]: version,\n    XOPC_SERVICE_MARKER: '1',\n  };\n\n  if (params.token) {\n    environment.XOPC_GATEWAY_TOKEN = params.token;\n  }\n\n  // Copy relevant API key env vars\n  const relevantEnvVars = [\n    'OPENAI_API_KEY',\n    'ANTHROPIC_API_KEY',\n    'GOOGLE_API_KEY',\n    'BRAVE_API_KEY',\n    'DASHSCOPE_API_KEY',\n    'XOPC_LOG_RETENTION_DAYS',\n  ];\n\n  for (const key of relevantEnvVars) {\n    if (process.env[key]) {\n      environment[key] = process.env[key]!;\n    }\n  }\n\n  // Add custom env from params (non-XOPC keys only; XOPC keys already handled)\n  if (params.env) {\n    for (const [key, value] of Object.entries(params.env)) {\n      if (value !== undefined && !key.startsWith('XOPC_')) {\n        environment[key] = value;\n      }\n    }\n  }\n\n  // Service description\n  const profile = params.env?.XOPC_PROFILE?.trim() || undefined;\n  const description = formatGatewayServiceDescription({ profile, version });\n\n  log.info({\n    programArguments: programArguments.slice(0, 3),\n    envKeys: Object.keys(environment),\n    version,\n  }, 'Built gateway install plan');\n\n  return {\n    programArguments,\n    workingDirectory: path.dirname(configPath),\n    environment,\n    description,\n  };\n}\n\n// ─── Install Args Builder ───\n\nexport function buildGatewayInstallArgs(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): GatewayServiceInstallArgs {\n  const plan = buildGatewayInstallPlan(params);\n\n  return {\n    env: params.env || process.env,\n    programArguments: plan.programArguments,\n    workingDirectory: plan.workingDirectory,\n    environment: plan.environment,\n    description: plan.description,\n  };\n}\n\n// ─── Validation ───\n\n/** Check if the program in an install plan still exists on disk */\nexport function validateInstallPlanProgram(programArguments: string[]): boolean {\n  if (programArguments.length === 0) return false;\n  const program = programArguments[0];\n  return existsSync(program);\n}\n"],"mappings":";;;;;;;;;;;;;;aAUkD;sBAEM;AAGxD,MAAM,MAAM,aAAa,cAAc;AAWvC,SAAS,2BAAmC;CAC1C,MAAM,YAAY,QAAQ,IAAI,eAAe,QAAQ,IAAI;AACzD,KAAI,UAAW,QAAO;AACtB,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,YAAY;;AAGnD,SAAS,0BAAkC;CACzC,MAAM,eAAe,QAAQ,IAAI;AACjC,KAAI,aAAc,QAAO;AACzB,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,YAAY;;AAGnD,SAAS,gBAAwB;AAC/B,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,OAAO;;AAK9C,SAAS,cAAuB;AAE9B,QAAO,CAAC,CAAE,QAA+C,OACvD,QAAQ,SAAS,SAAS,OAAO,IACjC,QAAQ,SAAS,SAAS,WAAW;;AAGzC,SAAS,oBAA4B;AACnC,KAAI,aAAa,CACf,QAAO,QAAQ;CAGjB,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS;AAC/D,QAAO,KAAK,KAAK,SAAS,MAAM,OAAO,WAAW;;AAKpD,SAAgB,wBAAwB,QAOxB;CACd,MAAM,aAAa,0BAA0B;CAC7C,MAAM,YAAY,yBAAyB;CAC3C,MAAM,UAAU,OAAO,WAAW;CAGlC,IAAI;AAEJ,KAAI,OAAO,YAAY,YAAY,aAAa,CAG9C,oBAAmB;EADA,QAAQ;EACK;EAAW;EAAgB;EAAU,OAAO,KAAK,UAAU;EAAC;MACvF;EAEL,MAAM,WAAW,QAAQ,SAAS,QAC/B,QAAQ,CAAC,IAAI,WAAW,YAAY,IAAI,CAAC,IAAI,WAAW,UAAU,CACpE;EACD,MAAM,aAAa,mBAAmB;AACtC,qBAAmB;GACjB,QAAQ;GACR,GAAG;GACH;GACA;GACA;GACA;GAAU,OAAO,KAAK,UAAU;GACjC;;AAGH,KAAI,OAAO,QAAQ,OAAO,SAAS,WACjC,kBAAiB,KAAK,UAAU,OAAO,KAAK;CAI9C,MAAM,cAAsC;EAC1C,aAAa;EACb,gBAAgB;EAChB,gBAAgB,QAAQ,IAAI,kBAAkB;EAC9C,eAAe;EACf,kBAAkB;EAClB,cAAc,eAAe;GAC5B,0BAA0B;EAC3B,qBAAqB;EACtB;AAED,KAAI,OAAO,MACT,aAAY,qBAAqB,OAAO;AAa1C,MAAK,MAAM,OAAO;EARhB;EACA;EACA;EACA;EACA;EACA;EAG+B,CAC/B,KAAI,QAAQ,IAAI,KACd,aAAY,OAAO,QAAQ,IAAI;AAKnC,KAAI,OAAO;OACJ,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,IAAI,CACnD,KAAI,UAAU,KAAA,KAAa,CAAC,IAAI,WAAW,QAAQ,CACjD,aAAY,OAAO;;CAOzB,MAAM,cAAc,gCAAgC;EAAE,SADtC,OAAO,KAAK,cAAc,MAAM,IAAI,KAAA;EACW;EAAS,CAAC;AAEzE,KAAI,KAAK;EACP,kBAAkB,iBAAiB,MAAM,GAAG,EAAE;EAC9C,SAAS,OAAO,KAAK,YAAY;EACjC;EACD,EAAE,6BAA6B;AAEhC,QAAO;EACL;EACA,kBAAkB,KAAK,QAAQ,WAAW;EAC1C;EACA;EACD;;AAKH,SAAgB,wBAAwB,QAOV;CAC5B,MAAM,OAAO,wBAAwB,OAAO;AAE5C,QAAO;EACL,KAAK,OAAO,OAAO,QAAQ;EAC3B,kBAAkB,KAAK;EACvB,kBAAkB,KAAK;EACvB,aAAa,KAAK;EAClB,aAAa,KAAK;EACnB;;;AAMH,SAAgB,2BAA2B,kBAAqC;AAC9E,KAAI,iBAAiB,WAAW,EAAG,QAAO;CAC1C,MAAM,UAAU,iBAAiB;AACjC,QAAO,WAAW,QAAQ"}

package/dist/src/daemon/launchd.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { resolveGatewayLaunchAgentLabel, resolveLaunchAgentPlistPath as resolveLaunchAgentPlistPath$1 } from "./constants.js";
-import path from "node:path";
-import os from "node:os";
 import { existsSync } from "node:fs";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
 import { spawn, spawnSync } from "node:child_process";
 //#region src/daemon/launchd.ts
 /**

package/dist/src/daemon/systemd.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { resolveGatewaySystemdServiceName, resolveSystemdUnitPath } from "./constants.js";
-import path from "node:path";
-import os from "node:os";
 import { existsSync } from "node:fs";
 import { access, constants as constants$1, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
 import { spawn, spawnSync } from "node:child_process";
 //#region src/daemon/systemd.ts
 /**

package/dist/src/daemon/types.d.ts

@@ -45,10 +45,6 @@ export type GatewayServiceRestartOutcome = 'restarted' | 'scheduled';
 export interface GatewayServiceRestartResult {
     outcome: GatewayServiceRestartOutcome;
 }
-export interface GatewayRestartIntent {
-    force?: boolean;
-    waitMs?: number;
-}
 export type StartRepairIssueCode = 'version-mismatch' | 'temporary-program' | 'missing-program';
 export interface GatewayServiceStartRepairIssue {
     code: StartRepairIssueCode;
@@ -78,8 +74,6 @@ export interface DaemonActionResponse {
 }
 export interface DaemonLifecycleOptions {
     json?: boolean;
-    force?: boolean;
-    safe?: boolean;
     wait?: string;
     disable?: boolean;
 }

package/dist/src/extensions/api.d.ts

@@ -11,7 +11,7 @@ import type { ChannelPlugin } from '../channels/plugin-types.js';
 import type { Config } from '../config/config-surface.js';
 import { EventEmitter } from 'events';
 import { TypedEventBus } from './typed-event-bus.js';
-import { ExtensionRegistryImpl } from './loader.js';
+import { ExtensionRegistryImpl } from './extension-registry-impl.js';
 import type { SpeechProviderPlugin } from '../voice/tts/speech-provider-types.js';
 import type { MediaUnderstandingProvider } from '../media-understanding/types.js';
 export declare class ExtensionApiImpl implements ExtensionApi {

package/dist/src/extensions/api.js

@@ -4,9 +4,9 @@ import { registerSpeechProvider } from "../voice/tts/speech-registry.js";
 import { HOOK_EXECUTION_MODES } from "./types/hooks.js";
 import { commandRegistry } from "../chat-commands/registry.js";
 import { TypedEventBus } from "./typed-event-bus.js";
-import { registerMediaUnderstandingProvider } from "../media-understanding/registry.js";
-import { ExtensionRegistryImpl } from "./loader.js";
+import { ExtensionRegistryImpl } from "./extension-registry-impl.js";
 import { registerMarketplaceAdapter, unregisterMarketplaceAdapter } from "../agent/skills/marketplace/registry.js";
+import { registerMediaUnderstandingProvider } from "../media-understanding/registry.js";
 import { isAbsolute, resolve } from "path";
 import { EventEmitter } from "events";
 //#region src/extensions/api.ts

package/dist/src/extensions/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","names":[],"sources":["../../../src/extensions/api.ts"],"sourcesContent":["/**\n * Extension API Implementation\n * \n *  Complete extension API with strong typing, security, and provider support.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Command } from 'commander';\nimport type {\n  ExtensionApi,\n  ExtensionLogger,\n  ExtensionRuntime,\n  ExtensionCliRegistration,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n  ExtensionCommand,\n  ExtensionCommandContext,\n  ExtensionCommandHandler,\n  ExtensionReloadHandler,\n  ExtensionService,\n  FlagConfig,\n  FlagValue,\n  ShortcutConfig,\n  HookHandlerMap,\n  ExtensionHookEvent,\n  HookExecutionMode,\n  TuiExtensionRegistrar,\n} from './types/index.js';\nimport type { CommandContribution } from './types/manifest.js';\nimport type { CommandDefinition } from '../chat-commands/types.js';\nimport { commandRegistry } from '../chat-commands/registry.js';\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport {\n  HOOK_EXECUTION_MODES,\n} from './types/hooks.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { Config as SchemaConfig } from '../config/schema.js';\nimport { resolve, isAbsolute } from 'path';\nimport { EventEmitter } from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { TypedEventBus } from './typed-event-bus.js';\nimport { ExtensionRegistryImpl } from './loader.js';\nimport { registerMarketplaceAdapter as _registerMarketplaceAdapter, unregisterMarketplaceAdapter as _unregisterMarketplaceAdapter } from '../agent/skills/marketplace/registry.js';\nimport { registerSpeechProvider as registerSpeechProviderInRegistry } from '../voice/tts/speech-registry.js';\nimport type { SpeechProviderPlugin } from '../voice/tts/speech-provider-types.js';\nimport { registerMediaUnderstandingProvider as registerMediaUnderstandingProviderInRegistry } from '../media-understanding/registry.js';\nimport type { MediaUnderstandingProvider } from '../media-understanding/types.js';\n\nexport class ExtensionApiImpl implements ExtensionApi {\n  private _tools: Map<string, AgentTool> = new Map();\n  private _hooks: Map<string, Set<Function>> = new Map();\n  //  Strongly typed hooks (for on() method)\n  private _typedHooks: Map<ExtensionHookEvent, Set<Function>> = new Map();\n  private _eventBus = new EventEmitter();\n  private _typedEventBus: TypedEventBus;\n  \n  //  Unified Registry\n  private _registry: ExtensionRegistryImpl;\n\n  private readonly _runtime: ExtensionRuntime;\n\n  private _reloadConfigPrefixes: string[] = [];\n  private _registeredCommandIds: string[] = [];\n  private _registeredSpeechProviderIds: string[] = [];\n  private _registeredMediaUnderstandingProviderIds: string[] = [];\n  private _registeredMarketplaceAdapterIds: string[] = [];\n  private readonly _manifestCommands = new Map<string, CommandContribution>();\n\n  constructor(\n    public readonly id: string,\n    public readonly name: string,\n    public readonly version: string | undefined,\n    public readonly source: string,\n    public readonly config: Config,\n    public readonly extensionConfig: Record<string, unknown>,\n    private readonly _logger: ExtensionLogger,\n    private readonly _resolvePath: (input: string) => string,\n    private readonly _coreRegistry?: ExtensionRegistryImpl,\n    runtime?: ExtensionRuntime,\n  ) {\n    // Initialize typed event bus\n    this._typedEventBus = new TypedEventBus({\n      logger: _logger,\n    });\n    \n    this._registry = _coreRegistry ?? new ExtensionRegistryImpl();\n    this._runtime =\n      runtime ??\n      ({\n        config: this.config,\n        log: this._logger,\n      } as ExtensionRuntime);\n  }\n\n  get logger(): ExtensionLogger {\n    return this._logger;\n  }\n\n  get runtime(): ExtensionRuntime {\n    return this._runtime;\n  }\n\n  registerTool(tool: AgentTool): void {\n    if (this._tools.has(tool.name)) {\n      this._logger.warn(`Tool ${tool.name} already registered, overwriting`);\n    }\n    this._tools.set(tool.name, tool);\n    this._logger.info(`Registered tool: ${tool.name}`);\n  }\n\n  registerHook(event: string, handler: Function, opts?: { priority?: number; once?: boolean }): void {\n    if (!this._hooks.has(event)) {\n      this._hooks.set(event, new Set());\n    }\n    this._hooks.get(event)!.add(handler);\n\n    if (opts?.once) {\n      const wrapper = async (...args: unknown[]) => {\n        await handler(...args);\n        this._hooks.get(event)?.delete(wrapper);\n      };\n      this._hooks.get(event)!.add(wrapper);\n    }\n\n    this._logger.info(`Registered hook: ${event}`);\n  }\n\n  /**\n   *  Strongly typed hook registration\n   * Provides compile-time type checking and IDE autocomplete\n   * \n   * @example\n   * api.on('before_agent_start', async (event, ctx) => {\n   *   console.log('Agent starting with prompt:', event.prompt);\n   *   return { systemPrompt: event.systemPrompt };\n   * });\n   */\n  onHook<K extends ExtensionHookEvent>(\n    hookName: K,\n    handler: HookHandlerMap[K],\n    _opts?: { priority?: number },\n  ): void {\n    // Get execution mode for this hook\n    const mode = (HOOK_EXECUTION_MODES as Record<string, HookExecutionMode>)[hookName];\n    \n    if (!this._typedHooks.has(hookName)) {\n      this._typedHooks.set(hookName, new Set());\n    }\n    \n    this._typedHooks.get(hookName)!.add(handler);\n\n    this._logger.debug(`Registered typed hook: ${hookName} (mode: ${mode})`);\n  }\n\n  /**\n   *  Get typed hooks for a specific event\n   */\n  _getTypedHooks<K extends ExtensionHookEvent>(hookName: K): HookHandlerMap[K][] {\n    const hooks = this._typedHooks.get(hookName);\n    return hooks ? Array.from(hooks) as HookHandlerMap[K][] : [];\n  }\n\n  /** Adds a ChannelPlugin to the extension registry; emits `channel:register` for observability. */\n  registerChannel(registration: { plugin: ChannelPlugin }): void {\n    const plugin = registration.plugin;\n    this._registry.addChannelPlugin(plugin);\n    this._eventBus.emit('channel:register', plugin);\n    this._logger.info(`Registered channel plugin: ${plugin.id}`);\n  }\n\n  registerHttpRoute(path: string, handler: HttpRequestHandler): void {\n    this._eventBus.emit('http:route', { path, handler });\n    this._logger.info(`Registered HTTP route: ${path}`);\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    const commandId = `ext.${this.id}.${command.name}`;\n\n    const definition: CommandDefinition = {\n      id: commandId,\n      name: command.name,\n      aliases: command.aliases,\n      description: command.description,\n      category: 'extension',\n      scope: command.scope ?? ['global'],\n      acceptsArgs: command.acceptsArgs,\n      examples: command.examples,\n      handler: async (ctx, args) => {\n        const extensionCtx: ExtensionCommandContext = {\n          sessionKey: ctx.sessionKey,\n          source: ctx.source,\n          isGroup: ctx.isGroup,\n          config: ctx.config as SchemaConfig as ExtensionCommandContext['config'],\n          reply: (text: string) => ctx.reply(text),\n        };\n\n        const result = await command.handler(args, extensionCtx);\n\n        if (!result) {\n          return { content: '', success: true };\n        }\n        return {\n          content: result.content,\n          success: result.success ?? true,\n        };\n      },\n    };\n\n    commandRegistry.register(definition);\n    this._registeredCommandIds.push(commandId);\n    this._registry.addCommand(command);\n\n    this._eventBus.emit('command:register', command);\n    this._logger.info(`Registered chat command: /${command.name}`);\n  }\n\n  /** Injected from manifest `ui.contributions.commands` by the loader. */\n  _setManifestCommands(commands: CommandContribution[]): void {\n    this._manifestCommands.clear();\n    for (const c of commands) {\n      this._manifestCommands.set(c.id, c);\n    }\n  }\n\n  onCommand(commandId: string, handler: ExtensionCommandHandler): void {\n    const meta = this._manifestCommands.get(commandId);\n    if (!meta) {\n      this._logger.warn(\n        `onCommand: unknown command id \"${commandId}\" — registering runtime-only chat command`,\n      );\n      const name = commandId.includes('.')\n        ? (commandId.split('.').pop() ?? commandId).trim()\n        : commandId;\n      this.registerCommand({\n        name: name || commandId,\n        description: commandId,\n        handler,\n      });\n      return;\n    }\n    let name: string;\n    if (meta.chatAlias?.trim()) {\n      name = meta.chatAlias.trim().replace(/^\\//, '');\n    } else {\n      name = meta.id.includes('.') ? (meta.id.split('.').pop() ?? meta.id) : meta.id;\n    }\n    if (!name) {\n      name = meta.id;\n    }\n    this.registerCommand({\n      name,\n      description: meta.title,\n      handler,\n    });\n    this._logger.info(`Bound manifest command \"${commandId}\" as /${name}`);\n  }\n\n  registerReload(handler: ExtensionReloadHandler): void {\n    const prefixes =\n      this._reloadConfigPrefixes.length > 0\n        ? this._reloadConfigPrefixes\n        : [`extensions.${this.id}`];\n\n    this._registry.addReloadRegistration({\n      extensionId: this.id,\n      handler,\n      configPrefixes: prefixes,\n    });\n    this._logger.info('Registered reload handler');\n  }\n\n  /** Called from loader when manifest declares `reload.configPrefixes`. */\n  _setReloadConfigPrefixes(prefixes: string[]): void {\n    this._reloadConfigPrefixes = [...prefixes];\n  }\n\n  registerService(service: ExtensionService): void {\n    this._eventBus.emit('service:register', service);\n    this._logger.info(`Registered service: ${service.id}`);\n  }\n\n  registerGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    this._eventBus.emit('gateway:method', { method, handler });\n    this._logger.info(`Registered gateway method: ${method}`);\n  }\n\n  registerCli(\n    factory: (ctx: { program: Command }) => void,\n    opts?: { commands: string[] },\n  ): void {\n    const reg: ExtensionCliRegistration = {\n      extensionId: this.id,\n      commands: opts?.commands ?? [],\n      factory,\n    };\n    this._registry.addCliRegistration(reg);\n    this._eventBus.emit('cli:register', reg);\n    this._logger.info(\n      `Registered CLI factory${opts?.commands?.length ? ` (${opts.commands.join(', ')})` : ''}`,\n    );\n  }\n\n  resolvePath(input: string): string {\n    return this._resolvePath(input);\n  }\n\n  emit(event: string, data: unknown): void {\n    this._eventBus.emit(event, data);\n  }\n\n  on(event: string, handler: (data: unknown) => void): void {\n    this._eventBus.on(event, handler);\n  }\n\n  off(event: string, handler: (data: unknown) => void): void {\n    this._eventBus.off(event, handler);\n  }\n\n  //  Typed Event Bus\n  get events(): TypedEventBus {\n    return this._typedEventBus;\n  }\n\n  //  Unified Registry Methods\n  \n  /**\n   * Register a full ProviderPlugin\n   */\n  registerProvider(plugin: import('./types/providers.js').ProviderPlugin): void {\n    import('../providers/plugin-registry.js').then(({ getProviderRegistry }) => {\n      const registry = getProviderRegistry();\n      registry.register(plugin);\n      this._logger.info(`Extension registered provider: ${plugin.id}`);\n    }).catch((err: unknown) => {\n      this._logger.error(`Failed to register provider: ${err instanceof Error ? err.message : String(err)}`);\n    });\n  }\n\n  /**\n   * Register a full ProviderPlugin (alias for registerProvider)\n   */\n  registerProviderPlugin(plugin: import('./types/providers.js').ProviderPlugin): void {\n    this.registerProvider(plugin);\n  }\n\n  registerSpeechProvider(plugin: SpeechProviderPlugin): void {\n    registerSpeechProviderInRegistry(plugin);\n    if (!this._registeredSpeechProviderIds.includes(plugin.id)) {\n      this._registeredSpeechProviderIds.push(plugin.id);\n    }\n    this._logger.info(`Registered speech provider: ${plugin.id}`);\n  }\n\n  /** Speech provider ids registered through this extension API instance. */\n  getRegisteredSpeechProviderIds(): readonly string[] {\n    return [...this._registeredSpeechProviderIds];\n  }\n\n  registerMediaUnderstandingProvider(plugin: MediaUnderstandingProvider): void {\n    registerMediaUnderstandingProviderInRegistry(plugin);\n    if (!this._registeredMediaUnderstandingProviderIds.includes(plugin.id)) {\n      this._registeredMediaUnderstandingProviderIds.push(plugin.id);\n    }\n    this._logger.info(`Registered media understanding provider: ${plugin.id}`);\n  }\n\n  /** Media understanding provider ids registered through this extension API instance. */\n  getRegisteredMediaUnderstandingProviderIds(): readonly string[] {\n    return [...this._registeredMediaUnderstandingProviderIds];\n  }\n\n  /**\n   * Register a skills marketplace adapter so it appears in the UI provider picker.\n   */\n  registerMarketplaceAdapter(registration: {\n    adapter: import('../agent/skills/marketplace/adapter.types.js').SkillsMarketplaceAdapter;\n    displayName?: string;\n  }): void {\n    _registerMarketplaceAdapter(registration);\n    const adapterId = registration.adapter.id;\n    if (!this._registeredMarketplaceAdapterIds.includes(adapterId)) {\n      this._registeredMarketplaceAdapterIds.push(adapterId);\n    }\n    this._logger.info(`Extension registered marketplace adapter: ${adapterId}`);\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    // this._registry.registerFlag(name, config, this.id);\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined; // this._registry.getFlag(name);\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    // this._registry.registerShortcut(key, config, { extensionId: this.id });\n  }\n\n  registerTui(register: TuiExtensionRegistrar): void {\n    this._registry.addTuiRegistration(this.id, register);\n    this._logger.info('Registered TUI contributions (deferred until xopc tui starts)');\n  }\n\n  // Internal methods for extension manager\n  _getTools(): Map<string, AgentTool> {\n    return this._tools;\n  }\n\n  _getHooks(): Map<string, Set<Function>> {\n    return this._hooks;\n  }\n\n  _getEventBus(): EventEmitter {\n    return this._eventBus;\n  }\n\n  _cleanup(): void {\n    for (const commandId of this._registeredCommandIds) {\n      commandRegistry.unregister(commandId);\n    }\n    this._registeredCommandIds = [];\n    this._manifestCommands.clear();\n\n    this._registry.removeReloadRegistration(this.id);\n\n    for (const adapterId of this._registeredMarketplaceAdapterIds) {\n      _unregisterMarketplaceAdapter(adapterId);\n    }\n    this._registeredMarketplaceAdapterIds = [];\n\n    this._typedEventBus.cleanupAll();\n    this._eventBus.removeAllListeners();\n    this._hooks.clear();\n    this._typedHooks.clear();\n  }\n}\n\n// ============================================================================\n// Default Logger\n// ============================================================================\n\nexport function createExtensionLogger(prefix: string): ExtensionLogger {\n  const childLogger = createLogger(`Extension:${prefix}`);\n\n  return {\n    debug: (msg: string) => childLogger.debug(msg),\n    info: (msg: string) => childLogger.info(msg),\n    warn: (msg: string) => childLogger.warn(msg),\n    error: (msg: string) => childLogger.error(msg),\n  };\n}\n\n// ============================================================================\n// Path Resolver\n// ============================================================================\n\nexport function createPathResolver(extensionDir: string, workspaceDir: string) {\n  return (input: string): string => {\n    if (input.startsWith('~')) {\n      return input.replace('~', process.env.HOME || '');\n    }\n    if (input.startsWith('.')) {\n      return resolve(extensionDir, input);\n    }\n    if (!isAbsolute(input)) {\n      return resolve(workspaceDir, input);\n    }\n    return input;\n  };\n}\n"],"mappings":";;;;;;;;;;;;aAuCkD;AASlD,IAAa,mBAAb,MAAsD;CACpD,yBAAyC,IAAI,KAAK;CAClD,yBAA6C,IAAI,KAAK;CAEtD,8BAA8D,IAAI,KAAK;CACvE,YAAoB,IAAI,cAAc;CACtC;CAGA;CAEA;CAEA,wBAA0C,EAAE;CAC5C,wBAA0C,EAAE;CAC5C,+BAAiD,EAAE;CACnD,2CAA6D,EAAE;CAC/D,mCAAqD,EAAE;CACvD,oCAAqC,IAAI,KAAkC;CAE3E,YACE,IACA,MACA,SACA,QACA,QACA,iBACA,SACA,cACA,eACA,SACA;AAVgB,OAAA,KAAA;AACA,OAAA,OAAA;AACA,OAAA,UAAA;AACA,OAAA,SAAA;AACA,OAAA,SAAA;AACA,OAAA,kBAAA;AACC,OAAA,UAAA;AACA,OAAA,eAAA;AACA,OAAA,gBAAA;AAIjB,OAAK,iBAAiB,IAAI,cAAc,EACtC,QAAQ,SACT,CAAC;AAEF,OAAK,YAAY,iBAAiB,IAAI,uBAAuB;AAC7D,OAAK,WACH,WACC;GACC,QAAQ,KAAK;GACb,KAAK,KAAK;GACX;;CAGL,IAAI,SAA0B;AAC5B,SAAO,KAAK;;CAGd,IAAI,UAA4B;AAC9B,SAAO,KAAK;;CAGd,aAAa,MAAuB;AAClC,MAAI,KAAK,OAAO,IAAI,KAAK,KAAK,CAC5B,MAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,kCAAkC;AAExE,OAAK,OAAO,IAAI,KAAK,MAAM,KAAK;AAChC,OAAK,QAAQ,KAAK,oBAAoB,KAAK,OAAO;;CAGpD,aAAa,OAAe,SAAmB,MAAoD;AACjG,MAAI,CAAC,KAAK,OAAO,IAAI,MAAM,CACzB,MAAK,OAAO,IAAI,uBAAO,IAAI,KAAK,CAAC;AAEnC,OAAK,OAAO,IAAI,MAAM,CAAE,IAAI,QAAQ;AAEpC,MAAI,MAAM,MAAM;GACd,MAAM,UAAU,OAAO,GAAG,SAAoB;AAC5C,UAAM,QAAQ,GAAG,KAAK;AACtB,SAAK,OAAO,IAAI,MAAM,EAAE,OAAO,QAAQ;;AAEzC,QAAK,OAAO,IAAI,MAAM,CAAE,IAAI,QAAQ;;AAGtC,OAAK,QAAQ,KAAK,oBAAoB,QAAQ;;;;;;;;;;;;CAahD,OACE,UACA,SACA,OACM;EAEN,MAAM,OAAQ,qBAA2D;AAEzE,MAAI,CAAC,KAAK,YAAY,IAAI,SAAS,CACjC,MAAK,YAAY,IAAI,0BAAU,IAAI,KAAK,CAAC;AAG3C,OAAK,YAAY,IAAI,SAAS,CAAE,IAAI,QAAQ;AAE5C,OAAK,QAAQ,MAAM,0BAA0B,SAAS,UAAU,KAAK,GAAG;;;;;CAM1E,eAA6C,UAAkC;EAC7E,MAAM,QAAQ,KAAK,YAAY,IAAI,SAAS;AAC5C,SAAO,QAAQ,MAAM,KAAK,MAAM,GAA0B,EAAE;;;CAI9D,gBAAgB,cAA+C;EAC7D,MAAM,SAAS,aAAa;AAC5B,OAAK,UAAU,iBAAiB,OAAO;AACvC,OAAK,UAAU,KAAK,oBAAoB,OAAO;AAC/C,OAAK,QAAQ,KAAK,8BAA8B,OAAO,KAAK;;CAG9D,kBAAkB,MAAc,SAAmC;AACjE,OAAK,UAAU,KAAK,cAAc;GAAE;GAAM;GAAS,CAAC;AACpD,OAAK,QAAQ,KAAK,0BAA0B,OAAO;;CAGrD,gBAAgB,SAAiC;EAC/C,MAAM,YAAY,OAAO,KAAK,GAAG,GAAG,QAAQ;EAE5C,MAAM,aAAgC;GACpC,IAAI;GACJ,MAAM,QAAQ;GACd,SAAS,QAAQ;GACjB,aAAa,QAAQ;GACrB,UAAU;GACV,OAAO,QAAQ,SAAS,CAAC,SAAS;GAClC,aAAa,QAAQ;GACrB,UAAU,QAAQ;GAClB,SAAS,OAAO,KAAK,SAAS;IAC5B,MAAM,eAAwC;KAC5C,YAAY,IAAI;KAChB,QAAQ,IAAI;KACZ,SAAS,IAAI;KACb,QAAQ,IAAI;KACZ,QAAQ,SAAiB,IAAI,MAAM,KAAK;KACzC;IAED,MAAM,SAAS,MAAM,QAAQ,QAAQ,MAAM,aAAa;AAExD,QAAI,CAAC,OACH,QAAO;KAAE,SAAS;KAAI,SAAS;KAAM;AAEvC,WAAO;KACL,SAAS,OAAO;KAChB,SAAS,OAAO,WAAW;KAC5B;;GAEJ;AAED,kBAAgB,SAAS,WAAW;AACpC,OAAK,sBAAsB,KAAK,UAAU;AAC1C,OAAK,UAAU,WAAW,QAAQ;AAElC,OAAK,UAAU,KAAK,oBAAoB,QAAQ;AAChD,OAAK,QAAQ,KAAK,6BAA6B,QAAQ,OAAO;;;CAIhE,qBAAqB,UAAuC;AAC1D,OAAK,kBAAkB,OAAO;AAC9B,OAAK,MAAM,KAAK,SACd,MAAK,kBAAkB,IAAI,EAAE,IAAI,EAAE;;CAIvC,UAAU,WAAmB,SAAwC;EACnE,MAAM,OAAO,KAAK,kBAAkB,IAAI,UAAU;AAClD,MAAI,CAAC,MAAM;AACT,QAAK,QAAQ,KACX,kCAAkC,UAAU,2CAC7C;GACD,MAAM,OAAO,UAAU,SAAS,IAAI,IAC/B,UAAU,MAAM,IAAI,CAAC,KAAK,IAAI,WAAW,MAAM,GAChD;AACJ,QAAK,gBAAgB;IACnB,MAAM,QAAQ;IACd,aAAa;IACb;IACD,CAAC;AACF;;EAEF,IAAI;AACJ,MAAI,KAAK,WAAW,MAAM,CACxB,QAAO,KAAK,UAAU,MAAM,CAAC,QAAQ,OAAO,GAAG;MAE/C,QAAO,KAAK,GAAG,SAAS,IAAI,GAAI,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,IAAI,KAAK,KAAM,KAAK;AAE9E,MAAI,CAAC,KACH,QAAO,KAAK;AAEd,OAAK,gBAAgB;GACnB;GACA,aAAa,KAAK;GAClB;GACD,CAAC;AACF,OAAK,QAAQ,KAAK,2BAA2B,UAAU,QAAQ,OAAO;;CAGxE,eAAe,SAAuC;EACpD,MAAM,WACJ,KAAK,sBAAsB,SAAS,IAChC,KAAK,wBACL,CAAC,cAAc,KAAK,KAAK;AAE/B,OAAK,UAAU,sBAAsB;GACnC,aAAa,KAAK;GAClB;GACA,gBAAgB;GACjB,CAAC;AACF,OAAK,QAAQ,KAAK,4BAA4B;;;CAIhD,yBAAyB,UAA0B;AACjD,OAAK,wBAAwB,CAAC,GAAG,SAAS;;CAG5C,gBAAgB,SAAiC;AAC/C,OAAK,UAAU,KAAK,oBAAoB,QAAQ;AAChD,OAAK,QAAQ,KAAK,uBAAuB,QAAQ,KAAK;;CAGxD,sBAAsB,QAAgB,SAAqC;AACzE,OAAK,UAAU,KAAK,kBAAkB;GAAE;GAAQ;GAAS,CAAC;AAC1D,OAAK,QAAQ,KAAK,8BAA8B,SAAS;;CAG3D,YACE,SACA,MACM;EACN,MAAM,MAAgC;GACpC,aAAa,KAAK;GAClB,UAAU,MAAM,YAAY,EAAE;GAC9B;GACD;AACD,OAAK,UAAU,mBAAmB,IAAI;AACtC,OAAK,UAAU,KAAK,gBAAgB,IAAI;AACxC,OAAK,QAAQ,KACX,yBAAyB,MAAM,UAAU,SAAS,KAAK,KAAK,SAAS,KAAK,KAAK,CAAC,KAAK,KACtF;;CAGH,YAAY,OAAuB;AACjC,SAAO,KAAK,aAAa,MAAM;;CAGjC,KAAK,OAAe,MAAqB;AACvC,OAAK,UAAU,KAAK,OAAO,KAAK;;CAGlC,GAAG,OAAe,SAAwC;AACxD,OAAK,UAAU,GAAG,OAAO,QAAQ;;CAGnC,IAAI,OAAe,SAAwC;AACzD,OAAK,UAAU,IAAI,OAAO,QAAQ;;CAIpC,IAAI,SAAwB;AAC1B,SAAO,KAAK;;;;;CAQd,iBAAiB,QAA6D;AAC5E,SAAO,mCAAmC,MAAM,EAAE,0BAA0B;AACzD,wBACT,CAAC,SAAS,OAAO;AACzB,QAAK,QAAQ,KAAK,kCAAkC,OAAO,KAAK;IAChE,CAAC,OAAO,QAAiB;AACzB,QAAK,QAAQ,MAAM,gCAAgC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;IACtG;;;;;CAMJ,uBAAuB,QAA6D;AAClF,OAAK,iBAAiB,OAAO;;CAG/B,uBAAuB,QAAoC;AACzD,yBAAiC,OAAO;AACxC,MAAI,CAAC,KAAK,6BAA6B,SAAS,OAAO,GAAG,CACxD,MAAK,6BAA6B,KAAK,OAAO,GAAG;AAEnD,OAAK,QAAQ,KAAK,+BAA+B,OAAO,KAAK;;;CAI/D,iCAAoD;AAClD,SAAO,CAAC,GAAG,KAAK,6BAA6B;;CAG/C,mCAAmC,QAA0C;AAC3E,qCAA6C,OAAO;AACpD,MAAI,CAAC,KAAK,yCAAyC,SAAS,OAAO,GAAG,CACpE,MAAK,yCAAyC,KAAK,OAAO,GAAG;AAE/D,OAAK,QAAQ,KAAK,4CAA4C,OAAO,KAAK;;;CAI5E,6CAAgE;AAC9D,SAAO,CAAC,GAAG,KAAK,yCAAyC;;;;;CAM3D,2BAA2B,cAGlB;AACP,6BAA4B,aAAa;EACzC,MAAM,YAAY,aAAa,QAAQ;AACvC,MAAI,CAAC,KAAK,iCAAiC,SAAS,UAAU,CAC5D,MAAK,iCAAiC,KAAK,UAAU;AAEvD,OAAK,QAAQ,KAAK,6CAA6C,YAAY;;CAG7E,aAAa,OAAe,SAA2B;CAIvD,QAAQ,OAA0B;CAIlC,iBAAiB,MAAc,SAA+B;CAI9D,YAAY,UAAuC;AACjD,OAAK,UAAU,mBAAmB,KAAK,IAAI,SAAS;AACpD,OAAK,QAAQ,KAAK,gEAAgE;;CAIpF,YAAoC;AAClC,SAAO,KAAK;;CAGd,YAAwC;AACtC,SAAO,KAAK;;CAGd,eAA6B;AAC3B,SAAO,KAAK;;CAGd,WAAiB;AACf,OAAK,MAAM,aAAa,KAAK,sBAC3B,iBAAgB,WAAW,UAAU;AAEvC,OAAK,wBAAwB,EAAE;AAC/B,OAAK,kBAAkB,OAAO;AAE9B,OAAK,UAAU,yBAAyB,KAAK,GAAG;AAEhD,OAAK,MAAM,aAAa,KAAK,iCAC3B,8BAA8B,UAAU;AAE1C,OAAK,mCAAmC,EAAE;AAE1C,OAAK,eAAe,YAAY;AAChC,OAAK,UAAU,oBAAoB;AACnC,OAAK,OAAO,OAAO;AACnB,OAAK,YAAY,OAAO;;;AAQ5B,SAAgB,sBAAsB,QAAiC;CACrE,MAAM,cAAc,aAAa,aAAa,SAAS;AAEvD,QAAO;EACL,QAAQ,QAAgB,YAAY,MAAM,IAAI;EAC9C,OAAO,QAAgB,YAAY,KAAK,IAAI;EAC5C,OAAO,QAAgB,YAAY,KAAK,IAAI;EAC5C,QAAQ,QAAgB,YAAY,MAAM,IAAI;EAC/C;;AAOH,SAAgB,mBAAmB,cAAsB,cAAsB;AAC7E,SAAQ,UAA0B;AAChC,MAAI,MAAM,WAAW,IAAI,CACvB,QAAO,MAAM,QAAQ,KAAK,QAAQ,IAAI,QAAQ,GAAG;AAEnD,MAAI,MAAM,WAAW,IAAI,CACvB,QAAO,QAAQ,cAAc,MAAM;AAErC,MAAI,CAAC,WAAW,MAAM,CACpB,QAAO,QAAQ,cAAc,MAAM;AAErC,SAAO"}
+{"version":3,"file":"api.js","names":[],"sources":["../../../src/extensions/api.ts"],"sourcesContent":["/**\n * Extension API Implementation\n * \n *  Complete extension API with strong typing, security, and provider support.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Command } from 'commander';\nimport type {\n  ExtensionApi,\n  ExtensionLogger,\n  ExtensionRuntime,\n  ExtensionCliRegistration,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n  ExtensionCommand,\n  ExtensionCommandContext,\n  ExtensionCommandHandler,\n  ExtensionReloadHandler,\n  ExtensionService,\n  FlagConfig,\n  FlagValue,\n  ShortcutConfig,\n  HookHandlerMap,\n  ExtensionHookEvent,\n  HookExecutionMode,\n  TuiExtensionRegistrar,\n} from './types/index.js';\nimport type { CommandContribution } from './types/manifest.js';\nimport type { CommandDefinition } from '../chat-commands/types.js';\nimport { commandRegistry } from '../chat-commands/registry.js';\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport {\n  HOOK_EXECUTION_MODES,\n} from './types/hooks.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { Config as SchemaConfig } from '../config/schema.js';\nimport { resolve, isAbsolute } from 'path';\nimport { EventEmitter } from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { TypedEventBus } from './typed-event-bus.js';\nimport { ExtensionRegistryImpl } from './extension-registry-impl.js';\nimport { registerMarketplaceAdapter as _registerMarketplaceAdapter, unregisterMarketplaceAdapter as _unregisterMarketplaceAdapter } from '../agent/skills/marketplace/registry.js';\nimport { registerSpeechProvider as registerSpeechProviderInRegistry } from '../voice/tts/speech-registry.js';\nimport type { SpeechProviderPlugin } from '../voice/tts/speech-provider-types.js';\nimport { registerMediaUnderstandingProvider as registerMediaUnderstandingProviderInRegistry } from '../media-understanding/registry.js';\nimport type { MediaUnderstandingProvider } from '../media-understanding/types.js';\n\nexport class ExtensionApiImpl implements ExtensionApi {\n  private _tools: Map<string, AgentTool> = new Map();\n  private _hooks: Map<string, Set<Function>> = new Map();\n  //  Strongly typed hooks (for on() method)\n  private _typedHooks: Map<ExtensionHookEvent, Set<Function>> = new Map();\n  private _eventBus = new EventEmitter();\n  private _typedEventBus: TypedEventBus;\n  \n  //  Unified Registry\n  private _registry: ExtensionRegistryImpl;\n\n  private readonly _runtime: ExtensionRuntime;\n\n  private _reloadConfigPrefixes: string[] = [];\n  private _registeredCommandIds: string[] = [];\n  private _registeredSpeechProviderIds: string[] = [];\n  private _registeredMediaUnderstandingProviderIds: string[] = [];\n  private _registeredMarketplaceAdapterIds: string[] = [];\n  private readonly _manifestCommands = new Map<string, CommandContribution>();\n\n  constructor(\n    public readonly id: string,\n    public readonly name: string,\n    public readonly version: string | undefined,\n    public readonly source: string,\n    public readonly config: Config,\n    public readonly extensionConfig: Record<string, unknown>,\n    private readonly _logger: ExtensionLogger,\n    private readonly _resolvePath: (input: string) => string,\n    private readonly _coreRegistry?: ExtensionRegistryImpl,\n    runtime?: ExtensionRuntime,\n  ) {\n    // Initialize typed event bus\n    this._typedEventBus = new TypedEventBus({\n      logger: _logger,\n    });\n    \n    this._registry = _coreRegistry ?? new ExtensionRegistryImpl();\n    this._runtime =\n      runtime ??\n      ({\n        config: this.config,\n        log: this._logger,\n      } as ExtensionRuntime);\n  }\n\n  get logger(): ExtensionLogger {\n    return this._logger;\n  }\n\n  get runtime(): ExtensionRuntime {\n    return this._runtime;\n  }\n\n  registerTool(tool: AgentTool): void {\n    if (this._tools.has(tool.name)) {\n      this._logger.warn(`Tool ${tool.name} already registered, overwriting`);\n    }\n    this._tools.set(tool.name, tool);\n    this._logger.info(`Registered tool: ${tool.name}`);\n  }\n\n  registerHook(event: string, handler: Function, opts?: { priority?: number; once?: boolean }): void {\n    if (!this._hooks.has(event)) {\n      this._hooks.set(event, new Set());\n    }\n    this._hooks.get(event)!.add(handler);\n\n    if (opts?.once) {\n      const wrapper = async (...args: unknown[]) => {\n        await handler(...args);\n        this._hooks.get(event)?.delete(wrapper);\n      };\n      this._hooks.get(event)!.add(wrapper);\n    }\n\n    this._logger.info(`Registered hook: ${event}`);\n  }\n\n  /**\n   *  Strongly typed hook registration\n   * Provides compile-time type checking and IDE autocomplete\n   * \n   * @example\n   * api.on('before_agent_start', async (event, ctx) => {\n   *   console.log('Agent starting with prompt:', event.prompt);\n   *   return { systemPrompt: event.systemPrompt };\n   * });\n   */\n  onHook<K extends ExtensionHookEvent>(\n    hookName: K,\n    handler: HookHandlerMap[K],\n    _opts?: { priority?: number },\n  ): void {\n    // Get execution mode for this hook\n    const mode = (HOOK_EXECUTION_MODES as Record<string, HookExecutionMode>)[hookName];\n    \n    if (!this._typedHooks.has(hookName)) {\n      this._typedHooks.set(hookName, new Set());\n    }\n    \n    this._typedHooks.get(hookName)!.add(handler);\n\n    this._logger.debug(`Registered typed hook: ${hookName} (mode: ${mode})`);\n  }\n\n  /**\n   *  Get typed hooks for a specific event\n   */\n  _getTypedHooks<K extends ExtensionHookEvent>(hookName: K): HookHandlerMap[K][] {\n    const hooks = this._typedHooks.get(hookName);\n    return hooks ? Array.from(hooks) as HookHandlerMap[K][] : [];\n  }\n\n  /** Adds a ChannelPlugin to the extension registry; emits `channel:register` for observability. */\n  registerChannel(registration: { plugin: ChannelPlugin }): void {\n    const plugin = registration.plugin;\n    this._registry.addChannelPlugin(plugin);\n    this._eventBus.emit('channel:register', plugin);\n    this._logger.info(`Registered channel plugin: ${plugin.id}`);\n  }\n\n  registerHttpRoute(path: string, handler: HttpRequestHandler): void {\n    this._eventBus.emit('http:route', { path, handler });\n    this._logger.info(`Registered HTTP route: ${path}`);\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    const commandId = `ext.${this.id}.${command.name}`;\n\n    const definition: CommandDefinition = {\n      id: commandId,\n      name: command.name,\n      aliases: command.aliases,\n      description: command.description,\n      category: 'extension',\n      scope: command.scope ?? ['global'],\n      acceptsArgs: command.acceptsArgs,\n      examples: command.examples,\n      handler: async (ctx, args) => {\n        const extensionCtx: ExtensionCommandContext = {\n          sessionKey: ctx.sessionKey,\n          source: ctx.source,\n          isGroup: ctx.isGroup,\n          config: ctx.config as SchemaConfig as ExtensionCommandContext['config'],\n          reply: (text: string) => ctx.reply(text),\n        };\n\n        const result = await command.handler(args, extensionCtx);\n\n        if (!result) {\n          return { content: '', success: true };\n        }\n        return {\n          content: result.content,\n          success: result.success ?? true,\n        };\n      },\n    };\n\n    commandRegistry.register(definition);\n    this._registeredCommandIds.push(commandId);\n    this._registry.addCommand(command);\n\n    this._eventBus.emit('command:register', command);\n    this._logger.info(`Registered chat command: /${command.name}`);\n  }\n\n  /** Injected from manifest `ui.contributions.commands` by the loader. */\n  _setManifestCommands(commands: CommandContribution[]): void {\n    this._manifestCommands.clear();\n    for (const c of commands) {\n      this._manifestCommands.set(c.id, c);\n    }\n  }\n\n  onCommand(commandId: string, handler: ExtensionCommandHandler): void {\n    const meta = this._manifestCommands.get(commandId);\n    if (!meta) {\n      this._logger.warn(\n        `onCommand: unknown command id \"${commandId}\" — registering runtime-only chat command`,\n      );\n      const name = commandId.includes('.')\n        ? (commandId.split('.').pop() ?? commandId).trim()\n        : commandId;\n      this.registerCommand({\n        name: name || commandId,\n        description: commandId,\n        handler,\n      });\n      return;\n    }\n    let name: string;\n    if (meta.chatAlias?.trim()) {\n      name = meta.chatAlias.trim().replace(/^\\//, '');\n    } else {\n      name = meta.id.includes('.') ? (meta.id.split('.').pop() ?? meta.id) : meta.id;\n    }\n    if (!name) {\n      name = meta.id;\n    }\n    this.registerCommand({\n      name,\n      description: meta.title,\n      handler,\n    });\n    this._logger.info(`Bound manifest command \"${commandId}\" as /${name}`);\n  }\n\n  registerReload(handler: ExtensionReloadHandler): void {\n    const prefixes =\n      this._reloadConfigPrefixes.length > 0\n        ? this._reloadConfigPrefixes\n        : [`extensions.${this.id}`];\n\n    this._registry.addReloadRegistration({\n      extensionId: this.id,\n      handler,\n      configPrefixes: prefixes,\n    });\n    this._logger.info('Registered reload handler');\n  }\n\n  /** Called from loader when manifest declares `reload.configPrefixes`. */\n  _setReloadConfigPrefixes(prefixes: string[]): void {\n    this._reloadConfigPrefixes = [...prefixes];\n  }\n\n  registerService(service: ExtensionService): void {\n    this._eventBus.emit('service:register', service);\n    this._logger.info(`Registered service: ${service.id}`);\n  }\n\n  registerGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    this._eventBus.emit('gateway:method', { method, handler });\n    this._logger.info(`Registered gateway method: ${method}`);\n  }\n\n  registerCli(\n    factory: (ctx: { program: Command }) => void,\n    opts?: { commands: string[] },\n  ): void {\n    const reg: ExtensionCliRegistration = {\n      extensionId: this.id,\n      commands: opts?.commands ?? [],\n      factory,\n    };\n    this._registry.addCliRegistration(reg);\n    this._eventBus.emit('cli:register', reg);\n    this._logger.info(\n      `Registered CLI factory${opts?.commands?.length ? ` (${opts.commands.join(', ')})` : ''}`,\n    );\n  }\n\n  resolvePath(input: string): string {\n    return this._resolvePath(input);\n  }\n\n  emit(event: string, data: unknown): void {\n    this._eventBus.emit(event, data);\n  }\n\n  on(event: string, handler: (data: unknown) => void): void {\n    this._eventBus.on(event, handler);\n  }\n\n  off(event: string, handler: (data: unknown) => void): void {\n    this._eventBus.off(event, handler);\n  }\n\n  //  Typed Event Bus\n  get events(): TypedEventBus {\n    return this._typedEventBus;\n  }\n\n  //  Unified Registry Methods\n  \n  /**\n   * Register a full ProviderPlugin\n   */\n  registerProvider(plugin: import('./types/providers.js').ProviderPlugin): void {\n    import('../providers/plugin-registry.js').then(({ getProviderRegistry }) => {\n      const registry = getProviderRegistry();\n      registry.register(plugin);\n      this._logger.info(`Extension registered provider: ${plugin.id}`);\n    }).catch((err: unknown) => {\n      this._logger.error(`Failed to register provider: ${err instanceof Error ? err.message : String(err)}`);\n    });\n  }\n\n  /**\n   * Register a full ProviderPlugin (alias for registerProvider)\n   */\n  registerProviderPlugin(plugin: import('./types/providers.js').ProviderPlugin): void {\n    this.registerProvider(plugin);\n  }\n\n  registerSpeechProvider(plugin: SpeechProviderPlugin): void {\n    registerSpeechProviderInRegistry(plugin);\n    if (!this._registeredSpeechProviderIds.includes(plugin.id)) {\n      this._registeredSpeechProviderIds.push(plugin.id);\n    }\n    this._logger.info(`Registered speech provider: ${plugin.id}`);\n  }\n\n  /** Speech provider ids registered through this extension API instance. */\n  getRegisteredSpeechProviderIds(): readonly string[] {\n    return [...this._registeredSpeechProviderIds];\n  }\n\n  registerMediaUnderstandingProvider(plugin: MediaUnderstandingProvider): void {\n    registerMediaUnderstandingProviderInRegistry(plugin);\n    if (!this._registeredMediaUnderstandingProviderIds.includes(plugin.id)) {\n      this._registeredMediaUnderstandingProviderIds.push(plugin.id);\n    }\n    this._logger.info(`Registered media understanding provider: ${plugin.id}`);\n  }\n\n  /** Media understanding provider ids registered through this extension API instance. */\n  getRegisteredMediaUnderstandingProviderIds(): readonly string[] {\n    return [...this._registeredMediaUnderstandingProviderIds];\n  }\n\n  /**\n   * Register a skills marketplace adapter so it appears in the UI provider picker.\n   */\n  registerMarketplaceAdapter(registration: {\n    adapter: import('../agent/skills/marketplace/adapter.types.js').SkillsMarketplaceAdapter;\n    displayName?: string;\n  }): void {\n    _registerMarketplaceAdapter(registration);\n    const adapterId = registration.adapter.id;\n    if (!this._registeredMarketplaceAdapterIds.includes(adapterId)) {\n      this._registeredMarketplaceAdapterIds.push(adapterId);\n    }\n    this._logger.info(`Extension registered marketplace adapter: ${adapterId}`);\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    // this._registry.registerFlag(name, config, this.id);\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined; // this._registry.getFlag(name);\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    // this._registry.registerShortcut(key, config, { extensionId: this.id });\n  }\n\n  registerTui(register: TuiExtensionRegistrar): void {\n    this._registry.addTuiRegistration(this.id, register);\n    this._logger.info('Registered TUI contributions (deferred until xopc tui starts)');\n  }\n\n  // Internal methods for extension manager\n  _getTools(): Map<string, AgentTool> {\n    return this._tools;\n  }\n\n  _getHooks(): Map<string, Set<Function>> {\n    return this._hooks;\n  }\n\n  _getEventBus(): EventEmitter {\n    return this._eventBus;\n  }\n\n  _cleanup(): void {\n    for (const commandId of this._registeredCommandIds) {\n      commandRegistry.unregister(commandId);\n    }\n    this._registeredCommandIds = [];\n    this._manifestCommands.clear();\n\n    this._registry.removeReloadRegistration(this.id);\n\n    for (const adapterId of this._registeredMarketplaceAdapterIds) {\n      _unregisterMarketplaceAdapter(adapterId);\n    }\n    this._registeredMarketplaceAdapterIds = [];\n\n    this._typedEventBus.cleanupAll();\n    this._eventBus.removeAllListeners();\n    this._hooks.clear();\n    this._typedHooks.clear();\n  }\n}\n\n// ============================================================================\n// Default Logger\n// ============================================================================\n\nexport function createExtensionLogger(prefix: string): ExtensionLogger {\n  const childLogger = createLogger(`Extension:${prefix}`);\n\n  return {\n    debug: (msg: string) => childLogger.debug(msg),\n    info: (msg: string) => childLogger.info(msg),\n    warn: (msg: string) => childLogger.warn(msg),\n    error: (msg: string) => childLogger.error(msg),\n  };\n}\n\n// ============================================================================\n// Path Resolver\n// ============================================================================\n\nexport function createPathResolver(extensionDir: string, workspaceDir: string) {\n  return (input: string): string => {\n    if (input.startsWith('~')) {\n      return input.replace('~', process.env.HOME || '');\n    }\n    if (input.startsWith('.')) {\n      return resolve(extensionDir, input);\n    }\n    if (!isAbsolute(input)) {\n      return resolve(workspaceDir, input);\n    }\n    return input;\n  };\n}\n"],"mappings":"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"}

package/dist/src/extensions/bundle-mcp.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from "../config/paths.js";
 import { isRecord } from "../utils/is-record.js";
 import { normalizeConfiguredMcpServers } from "../config/mcp-config-normalize.js";
-import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
 //#region src/extensions/bundle-mcp.ts
 init_paths();
 function extractMcpServerMap(raw) {

package/dist/src/extensions/discover-extensions.js

@@ -1,6 +1,6 @@
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
 import { normalizeExtensionManifest } from "./normalize-manifest.js";

package/dist/src/extensions/extension-registry-impl.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `ExtensionRegistryImpl` — extracted from `loader.ts` so `api.ts` can use it
+ * without going through `loader.ts` (which imports back from `api.ts`,
+ * forming a circular cycle).
+ *
+ * `loader.ts` still re-exports the class for backward-compat; this file is a
+ * leaf and only depends on the type definitions in `./types/index.js`.
+ */
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { ChannelPlugin } from '../channels/plugin-types.js';
+import type { ExtensionCliRegistration, ExtensionCommand, ExtensionHookEvent, ExtensionHookHandler, ExtensionRecord, ExtensionRegistry, ExtensionReloadRegistration, ExtensionService, GatewayMethodHandler, HttpRequestHandler, TuiExtensionRegistrar, TuiExtensionRegistration } from './types/index.js';
+export declare class ExtensionRegistryImpl implements ExtensionRegistry {
+    extensions: Map<string, ExtensionRecord>;
+    hooks: Map<ExtensionHookEvent, ExtensionHookHandler[]>;
+    httpRoutes: Map<string, HttpRequestHandler>;
+    commands: Map<string, ExtensionCommand>;
+    services: Map<string, ExtensionService>;
+    gatewayMethods: Map<string, GatewayMethodHandler>;
+    tools: Map<string, AgentTool<any, any>>;
+    channelPlugins: ChannelPlugin[];
+    private cliRegistrations;
+    private reloadRegistrations;
+    private tuiRegistrations;
+    addExtension(record: ExtensionRecord): void;
+    getExtension(id: string): ExtensionRecord | undefined;
+    getEnabledExtensions(): ExtensionRecord[];
+    addHook(event: ExtensionHookEvent, handler: ExtensionHookHandler, _extensionId: string, _priority?: number): void;
+    getHooks(event: ExtensionHookEvent): ExtensionHookHandler[];
+    addChannelPlugin(plugin: ChannelPlugin): void;
+    addHttpRoute(path: string, handler: HttpRequestHandler): void;
+    getHttpRoute(path: string): HttpRequestHandler | undefined;
+    addCommand(command: ExtensionCommand): void;
+    getCommand(name: string): ExtensionCommand | undefined;
+    addService(service: ExtensionService): void;
+    getService(id: string): ExtensionService | undefined;
+    addGatewayMethod(method: string, handler: GatewayMethodHandler): void;
+    getGatewayMethod(method: string): GatewayMethodHandler | undefined;
+    addTool(tool: any): void;
+    removeTool(name: string): void;
+    getTools(): Map<string, any>;
+    getTool(name: string): any | undefined;
+    getAllTools(): any[];
+    addCliRegistration(reg: ExtensionCliRegistration): void;
+    getCliRegistrations(): readonly ExtensionCliRegistration[];
+    addTuiRegistration(extensionId: string, register: TuiExtensionRegistrar): void;
+    getTuiRegistrations(): readonly TuiExtensionRegistration[];
+    addReloadRegistration(reg: ExtensionReloadRegistration): void;
+    removeReloadRegistration(extensionId: string): void;
+    getReloadRegistrations(): readonly ExtensionReloadRegistration[];
+    getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[];
+}