@xopcai/xopc 0.0.103 → 0.0.104

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 { WorkflowRunView } from '../workflows/domain/index.js';\nimport type {\n  CronRunOutcome,\n  CronWorkflowRunStarter,\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';\nimport {\n  buildWorkflowRunCronSummary,\n  buildWorkflowRunDeliveryText,\n  isWorkflowRunCronSuccess,\n  resolveWorkflowCronWaitMs,\n  waitForWorkflowRunView,\n} from './workflow-run-completion.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  private workflowRunService: CronWorkflowRunStarter | 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    this.workflowRunService = deps.workflowRunService ?? 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      execution.workflowRunId = result.workflowRunId;\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, errorMessage: result.error, phase: 'cron.execute' },\n          `Job failed: ${result.error ?? 'unknown'}`,\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        {\n          err: error,\n          errorMessage: execution.error,\n          jobId: job.id,\n          executionId,\n          phase: 'cron.execute',\n        },\n        `Job execution error: ${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    try {\n      if (job.payload.kind === 'workflowRun') {\n        return await this.executeWorkflowRun(job, signal);\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      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  private async executeWorkflowRun(job: JobData, signal: AbortSignal): Promise<CronRunOutcome> {\n    if (signal.aborted) {\n      return { status: 'skipped', error: 'Job was aborted before workflow run start' };\n    }\n\n    if (job.payload.kind !== 'workflowRun') {\n      return { status: 'error', error: 'Cron job payload is not workflowRun' };\n    }\n\n    if (!this.workflowRunService) {\n      return { status: 'error', error: 'Workflow run service is not configured for cron' };\n    }\n\n    const fallbackAgentId = this.getDefaultCronAgentId?.() ?? DEFAULT_AGENT_ID;\n    const agentId = normalizeAgentId(job.payload.agentId || job.agentId || fallbackAgentId);\n    const fireId = job.payload.source?.fireId || crypto.randomUUID();\n    const source = {\n      kind: 'cron' as const,\n      scheduleId: job.payload.source?.scheduleId || job.id,\n      fireId,\n      scheduledAtMs: job.payload.source?.scheduledAtMs ?? Date.now(),\n    };\n    const result = await this.workflowRunService.startWorkflowRun({\n      agentId,\n      definitionId: job.payload.definitionId,\n      input: job.payload.input,\n      inputEnvelope: job.payload.inputEnvelope,\n      goal: job.payload.goal,\n      source,\n      idempotencyKey: `cron:${job.id}:${fireId}`,\n    });\n\n    if (result.ok === false) {\n      return {\n        status: 'error',\n        error: result.message,\n      };\n    }\n\n    log.info(\n      {\n        jobId: job.id,\n        workflowRunId: result.runId,\n        definitionId: job.payload.definitionId,\n        sessionKey: result.sessionKey,\n      },\n      'Workflow run started from cron',\n    );\n\n    const waitForCompletion = job.payload.waitForCompletion !== false;\n    if (!waitForCompletion || !this.workflowRunService.readWorkflowRunView) {\n      return {\n        status: 'ok',\n        summary: `Started workflow run ${result.runId}`,\n        sessionId: result.sessionKey,\n        sessionKey: result.sessionKey,\n        sessionType: 'workflow',\n        workflowRunId: result.runId,\n      };\n    }\n\n    return this.waitForWorkflowRunOutcome({\n      job,\n      agentId,\n      sessionKey: result.sessionKey,\n      initialRunId: result.runId,\n      signal,\n    });\n  }\n\n  private async waitForWorkflowRunOutcome(params: {\n    job: JobData;\n    agentId: string;\n    sessionKey: string;\n    initialRunId: string;\n    signal: AbortSignal;\n  }): Promise<CronRunOutcome> {\n    const waitMs = resolveWorkflowCronWaitMs(params.job.timeout);\n    const maxWorkflowRetries = Math.max(0, params.job.maxRetries ?? 0);\n    let runId = params.initialRunId;\n    let attempt = 0;\n\n    while (attempt <= maxWorkflowRetries) {\n      const waitResult = await waitForWorkflowRunView({\n        readView: (id) => this.workflowRunService!.readWorkflowRunView!(params.agentId, id),\n        runId,\n        signal: params.signal,\n        timeoutMs: waitMs,\n      });\n\n      if (waitResult.kind === 'aborted') {\n        return { status: 'skipped', error: 'Job was aborted while waiting for workflow run' };\n      }\n\n      if (waitResult.kind === 'timeout') {\n        return {\n          status: 'error',\n          error: `Workflow run ${runId} did not finish within ${waitMs}ms`,\n          summary: waitResult.lastView ? buildWorkflowRunCronSummary(waitResult.lastView) : undefined,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n      }\n\n      const view = waitResult.view;\n      const summary = buildWorkflowRunCronSummary(view);\n      const succeeded = isWorkflowRunCronSuccess(view);\n\n      if (succeeded) {\n        const baseOutcome: CronRunOutcome = {\n          status: 'ok',\n          summary,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n        await this.deliverWorkflowRunOutcome(params.job, view, baseOutcome);\n        return baseOutcome;\n      }\n\n      const canRetry =\n        attempt < maxWorkflowRetries &&\n        view.run.status === 'failed' &&\n        Boolean(this.workflowRunService?.retryWorkflowRun);\n\n      if (!canRetry) {\n        return {\n          status: 'error',\n          summary,\n          error: summary,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n      }\n\n      const retryResult = await this.workflowRunService!.retryWorkflowRun!({\n        agentId: params.agentId,\n        runId,\n      });\n      if (retryResult.ok === false) {\n        return {\n          status: 'error',\n          error: retryResult.message,\n          summary,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n      }\n\n      runId = retryResult.runId;\n      attempt += 1;\n      log.info(\n        { jobId: params.job.id, attempt, workflowRunId: runId },\n        'Retrying failed workflow run from cron',\n      );\n    }\n\n    return {\n      status: 'error',\n      error: 'Workflow run retries exhausted',\n      sessionId: params.sessionKey,\n      sessionKey: params.sessionKey,\n      sessionType: 'workflow',\n      workflowRunId: runId,\n    };\n  }\n\n  private async deliverWorkflowRunOutcome(\n    job: JobData,\n    view: WorkflowRunView,\n    outcome: CronRunOutcome,\n  ): Promise<void> {\n    if (!this.messageBus) return;\n    const delivery = job.delivery;\n    if (!delivery || delivery.mode === 'none' || delivery.channel === 'local' || !delivery.to?.trim()) {\n      return;\n    }\n\n    try {\n      const text = buildWorkflowRunDeliveryText(view);\n      const outbound = await this.buildCronOutboundMessage(delivery.channel!, delivery.to!, text);\n      await this.messageBus.publishOutbound(outbound);\n      log.info(\n        { jobId: job.id, channel: delivery.channel, to: outbound.chat_id, workflowRunId: view.run.id },\n        'Delivered workflow run result from cron',\n      );\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ jobId: job.id, err, workflowRunId: view.run.id }, `Workflow cron delivery failed: ${em}`);\n      if (outcome.status === 'ok') {\n        outcome.summary = `${outcome.summary ?? ''} (delivery failed: ${em})`.trim();\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":"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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 { WorkflowRunView } from '../workflows/domain/index.js';\nimport type {\n  CronRunOutcome,\n  CronWorkflowRunStarter,\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} from '../channels/plugins/registry.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';\nimport {\n  buildWorkflowRunCronSummary,\n  buildWorkflowRunDeliveryText,\n  isWorkflowRunCronSuccess,\n  resolveWorkflowCronWaitMs,\n  waitForWorkflowRunView,\n} from './workflow-run-completion.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  private workflowRunService: CronWorkflowRunStarter | 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    this.workflowRunService = deps.workflowRunService ?? null;\n  }\n\n  private async buildCronOutboundMessage(\n    channel: string,\n    to: string,\n    content: string,\n  ): Promise<OutboundMessage> {\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      execution.workflowRunId = result.workflowRunId;\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, errorMessage: result.error, phase: 'cron.execute' },\n          `Job failed: ${result.error ?? 'unknown'}`,\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        {\n          err: error,\n          errorMessage: execution.error,\n          jobId: job.id,\n          executionId,\n          phase: 'cron.execute',\n        },\n        `Job execution error: ${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    try {\n      if (job.payload.kind === 'workflowRun') {\n        return await this.executeWorkflowRun(job, signal);\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      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  private async executeWorkflowRun(job: JobData, signal: AbortSignal): Promise<CronRunOutcome> {\n    if (signal.aborted) {\n      return { status: 'skipped', error: 'Job was aborted before workflow run start' };\n    }\n\n    if (job.payload.kind !== 'workflowRun') {\n      return { status: 'error', error: 'Cron job payload is not workflowRun' };\n    }\n\n    if (!this.workflowRunService) {\n      return { status: 'error', error: 'Workflow run service is not configured for cron' };\n    }\n\n    const fallbackAgentId = this.getDefaultCronAgentId?.() ?? DEFAULT_AGENT_ID;\n    const agentId = normalizeAgentId(job.payload.agentId || job.agentId || fallbackAgentId);\n    const fireId = job.payload.source?.fireId || crypto.randomUUID();\n    const source = {\n      kind: 'cron' as const,\n      scheduleId: job.payload.source?.scheduleId || job.id,\n      fireId,\n      scheduledAtMs: job.payload.source?.scheduledAtMs ?? Date.now(),\n    };\n    const result = await this.workflowRunService.startWorkflowRun({\n      agentId,\n      definitionId: job.payload.definitionId,\n      input: job.payload.input,\n      inputEnvelope: job.payload.inputEnvelope,\n      goal: job.payload.goal,\n      source,\n      idempotencyKey: `cron:${job.id}:${fireId}`,\n    });\n\n    if (result.ok === false) {\n      return {\n        status: 'error',\n        error: result.message,\n      };\n    }\n\n    log.info(\n      {\n        jobId: job.id,\n        workflowRunId: result.runId,\n        definitionId: job.payload.definitionId,\n        sessionKey: result.sessionKey,\n      },\n      'Workflow run started from cron',\n    );\n\n    const waitForCompletion = job.payload.waitForCompletion !== false;\n    if (!waitForCompletion || !this.workflowRunService.readWorkflowRunView) {\n      return {\n        status: 'ok',\n        summary: `Started workflow run ${result.runId}`,\n        sessionId: result.sessionKey,\n        sessionKey: result.sessionKey,\n        sessionType: 'workflow',\n        workflowRunId: result.runId,\n      };\n    }\n\n    return this.waitForWorkflowRunOutcome({\n      job,\n      agentId,\n      sessionKey: result.sessionKey,\n      initialRunId: result.runId,\n      signal,\n    });\n  }\n\n  private async waitForWorkflowRunOutcome(params: {\n    job: JobData;\n    agentId: string;\n    sessionKey: string;\n    initialRunId: string;\n    signal: AbortSignal;\n  }): Promise<CronRunOutcome> {\n    const waitMs = resolveWorkflowCronWaitMs(params.job.timeout);\n    const maxWorkflowRetries = Math.max(0, params.job.maxRetries ?? 0);\n    let runId = params.initialRunId;\n    let attempt = 0;\n\n    while (attempt <= maxWorkflowRetries) {\n      const waitResult = await waitForWorkflowRunView({\n        readView: (id) => this.workflowRunService!.readWorkflowRunView!(params.agentId, id),\n        runId,\n        signal: params.signal,\n        timeoutMs: waitMs,\n      });\n\n      if (waitResult.kind === 'aborted') {\n        return { status: 'skipped', error: 'Job was aborted while waiting for workflow run' };\n      }\n\n      if (waitResult.kind === 'timeout') {\n        return {\n          status: 'error',\n          error: `Workflow run ${runId} did not finish within ${waitMs}ms`,\n          summary: waitResult.lastView ? buildWorkflowRunCronSummary(waitResult.lastView) : undefined,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n      }\n\n      const view = waitResult.view;\n      const summary = buildWorkflowRunCronSummary(view);\n      const succeeded = isWorkflowRunCronSuccess(view);\n\n      if (succeeded) {\n        const baseOutcome: CronRunOutcome = {\n          status: 'ok',\n          summary,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n        await this.deliverWorkflowRunOutcome(params.job, view, baseOutcome);\n        return baseOutcome;\n      }\n\n      const canRetry =\n        attempt < maxWorkflowRetries &&\n        view.run.status === 'failed' &&\n        Boolean(this.workflowRunService?.retryWorkflowRun);\n\n      if (!canRetry) {\n        return {\n          status: 'error',\n          summary,\n          error: summary,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n      }\n\n      const retryResult = await this.workflowRunService!.retryWorkflowRun!({\n        agentId: params.agentId,\n        runId,\n      });\n      if (retryResult.ok === false) {\n        return {\n          status: 'error',\n          error: retryResult.message,\n          summary,\n          sessionId: params.sessionKey,\n          sessionKey: params.sessionKey,\n          sessionType: 'workflow',\n          workflowRunId: runId,\n        };\n      }\n\n      runId = retryResult.runId;\n      attempt += 1;\n      log.info(\n        { jobId: params.job.id, attempt, workflowRunId: runId },\n        'Retrying failed workflow run from cron',\n      );\n    }\n\n    return {\n      status: 'error',\n      error: 'Workflow run retries exhausted',\n      sessionId: params.sessionKey,\n      sessionKey: params.sessionKey,\n      sessionType: 'workflow',\n      workflowRunId: runId,\n    };\n  }\n\n  private async deliverWorkflowRunOutcome(\n    job: JobData,\n    view: WorkflowRunView,\n    outcome: CronRunOutcome,\n  ): Promise<void> {\n    if (!this.messageBus) return;\n    const delivery = job.delivery;\n    if (!delivery || delivery.mode === 'none' || delivery.channel === 'local' || !delivery.to?.trim()) {\n      return;\n    }\n\n    try {\n      const text = buildWorkflowRunDeliveryText(view);\n      const outbound = await this.buildCronOutboundMessage(delivery.channel!, delivery.to!, text);\n      await this.messageBus.publishOutbound(outbound);\n      log.info(\n        { jobId: job.id, channel: delivery.channel, to: outbound.chat_id, workflowRunId: view.run.id },\n        'Delivered workflow run result from cron',\n      );\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ jobId: job.id, err, workflowRunId: view.run.id }, `Workflow cron delivery failed: ${em}`);\n      if (outcome.status === 'ok') {\n        outcome.summary = `${outcome.summary ?? ''} (delivery failed: ${em})`.trim();\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      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":"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"}

package/dist/src/extensions/activation-context.js

@@ -93,7 +93,9 @@ function defaultModelId(config) {
 	if (!isRecord(agents)) return void 0;
 	const defaults = agents.defaults;
 	if (!isRecord(defaults)) return void 0;
-	const model = defaults.model;
+	const models = defaults.models;
+	if (!isRecord(models)) return void 0;
+	const model = models.chat;
 	if (isRecord(model)) {
 		const primary = model.primary;
 		if (typeof primary === "string" && primary.trim().length > 0) return primary;

package/dist/src/extensions/activation-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation-context.js","names":["root"],"sources":["../../../src/extensions/activation-context.ts"],"sourcesContent":["/**\n * Build ActivationContext from app config + optional overrides.\n */\n\nimport type { Config } from '../config/config-surface.js';\nimport { mergeSttConfigFromAppConfig } from '../channels/attachments/voice-stt-webchat.js';\nimport { collectSttProviderConfigEntries } from '../voice/stt/config-slice.js';\nimport { isSttProviderConfigured } from '../voice/stt/list-providers.js';\nimport { collectTtsProviderConfigEntries } from '../voice/tts/config-slice.js';\nimport { isProviderConfigured } from '../voice/tts/factory.js';\nimport { mergeTtsConfigFromAppConfig } from '../voice/tts/merge-config.js';\nimport { isProviderConfiguredSync } from '../providers/index.js';\nimport { PROVIDER_ENV_MAP } from '../providers/env-keys.js';\nimport type { ActivationContext } from './activation-planner.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction telegramConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts)) {\n    for (const acc of Object.values(accounts)) {\n      if (!isRecord(acc)) continue;\n      if (acc.enabled === false) continue;\n      if (typeof acc.botToken === 'string' && acc.botToken.trim().length > 0) return true;\n    }\n  }\n  return false;\n}\n\nfunction weixinConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts) && Object.keys(accounts).length > 0) {\n    for (const acc of Object.values(accounts)) {\n      if (isRecord(acc) && acc.enabled === false) continue;\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Derive configured channel plugin ids from `channels.*` config.\n */\nexport function collectConfiguredChannelIds(config: unknown): string[] | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const channels = root?.channels;\n  if (!isRecord(channels)) return undefined;\n\n  const ids: string[] = [];\n\n  if (telegramConfigured(channels.telegram as Record<string, unknown> | undefined)) {\n    ids.push('telegram');\n  }\n  if (weixinConfigured(channels.weixin as Record<string, unknown> | undefined)) {\n    ids.push('weixin');\n  }\n\n  for (const [key, value] of Object.entries(channels)) {\n    if (key === 'telegram' || key === 'weixin') continue;\n    if (isRecord(value) && value.enabled === true && !ids.includes(key)) {\n      ids.push(key);\n    }\n  }\n\n  return ids.length ? ids : undefined;\n}\n\nfunction collectConfiguredLlmProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const candidateIds = new Set<string>(Object.keys(PROVIDER_ENV_MAP));\n  const providers = root?.providers;\n  if (isRecord(providers)) {\n    for (const key of Object.keys(providers)) {\n      candidateIds.add(key);\n    }\n  }\n  const ids: string[] = [];\n  for (const key of candidateIds) {\n    if (isProviderConfiguredSync(key)) {\n      ids.push(key);\n    }\n  }\n  return ids;\n}\n\nfunction collectConfiguredSpeechProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const messages = root?.messages;\n  if (!isRecord(messages) || !isRecord(messages.tts)) {\n    return [];\n  }\n\n  const ttsConfig = mergeTtsConfigFromAppConfig(messages.tts);\n  const ids = new Set<string>();\n  const primary = ttsConfig.provider?.trim();\n  if (primary && isProviderConfigured(primary, ttsConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectTtsProviderConfigEntries(ttsConfig))) {\n    if (isProviderConfigured(providerId, ttsConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\nfunction collectConfiguredMediaUnderstandingProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const tools = root?.tools;\n  if (!isRecord(tools) || !isRecord(tools.media)) {\n    return [];\n  }\n\n  const sttConfig = mergeSttConfigFromAppConfig(\n    tools.media.audio as Parameters<typeof mergeSttConfigFromAppConfig>[0],\n    tools.media as Parameters<typeof mergeSttConfigFromAppConfig>[1],\n  );\n  const ids = new Set<string>();\n  const primary = sttConfig.provider?.trim();\n  if (primary && isSttProviderConfigured(primary, sttConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectSttProviderConfigEntries(sttConfig))) {\n    if (isSttProviderConfigured(providerId, sttConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\n/**\n * Derive configured provider ids for extension activation (LLM + speech + STT).\n */\nexport function collectConfiguredProviderIds(config: unknown): string[] | undefined {\n  const ids = new Set<string>([\n    ...collectConfiguredLlmProviderIds(config),\n    ...collectConfiguredSpeechProviderIds(config),\n    ...collectConfiguredMediaUnderstandingProviderIds(config),\n  ]);\n  return ids.size > 0 ? [...ids] : undefined;\n}\n\nfunction defaultModelId(config: unknown): string | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const agents = root?.agents;\n  if (!isRecord(agents)) return undefined;\n  const defaults = agents.defaults;\n  if (!isRecord(defaults)) return undefined;\n  const model = defaults.model;\n  if (isRecord(model)) {\n    const primary = model.primary;\n    if (typeof primary === 'string' && primary.trim().length > 0) return primary;\n  }\n  return undefined;\n}\n\n/**\n * Merge partial activation context over values inferred from loaded app config.\n */\nexport function mergeActivationContext(\n  appConfig: Config | Record<string, unknown> | undefined,\n  partial?: Partial<ActivationContext>,\n): ActivationContext {\n  const ext = appConfig && isRecord((appConfig as Record<string, unknown>).extensions)\n    ? ((appConfig as Record<string, unknown>).extensions as Record<string, unknown>)\n    : undefined;\n\n  const base: ActivationContext = {\n    enabledIds: Array.isArray(ext?.enabled)\n      ? ext!.enabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    disabledIds: Array.isArray(ext?.disabled)\n      ? ext!.disabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    requestedModelId: defaultModelId(appConfig),\n    configuredProviderIds: collectConfiguredProviderIds(appConfig),\n    configuredChannelIds: collectConfiguredChannelIds(appConfig),\n    env: process.env,\n  };\n\n  return {\n    env: partial?.env ?? base.env,\n    enabledIds: partial?.enabledIds !== undefined ? partial.enabledIds : base.enabledIds,\n    disabledIds: partial?.disabledIds !== undefined ? partial.disabledIds : base.disabledIds,\n    requestedModelId:\n      partial?.requestedModelId !== undefined ? partial.requestedModelId : base.requestedModelId,\n    configuredProviderIds:\n      partial?.configuredProviderIds !== undefined\n        ? partial.configuredProviderIds\n        : base.configuredProviderIds,\n    configuredChannelIds:\n      partial?.configuredChannelIds !== undefined\n        ? partial.configuredChannelIds\n        : base.configuredChannelIds,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"activation-context.js","names":["root"],"sources":["../../../src/extensions/activation-context.ts"],"sourcesContent":["/**\n * Build ActivationContext from app config + optional overrides.\n */\n\nimport type { Config } from '../config/config-surface.js';\nimport { mergeSttConfigFromAppConfig } from '../channels/attachments/voice-stt-webchat.js';\nimport { collectSttProviderConfigEntries } from '../voice/stt/config-slice.js';\nimport { isSttProviderConfigured } from '../voice/stt/list-providers.js';\nimport { collectTtsProviderConfigEntries } from '../voice/tts/config-slice.js';\nimport { isProviderConfigured } from '../voice/tts/factory.js';\nimport { mergeTtsConfigFromAppConfig } from '../voice/tts/merge-config.js';\nimport { isProviderConfiguredSync } from '../providers/index.js';\nimport { PROVIDER_ENV_MAP } from '../providers/env-keys.js';\nimport type { ActivationContext } from './activation-planner.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction telegramConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts)) {\n    for (const acc of Object.values(accounts)) {\n      if (!isRecord(acc)) continue;\n      if (acc.enabled === false) continue;\n      if (typeof acc.botToken === 'string' && acc.botToken.trim().length > 0) return true;\n    }\n  }\n  return false;\n}\n\nfunction weixinConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts) && Object.keys(accounts).length > 0) {\n    for (const acc of Object.values(accounts)) {\n      if (isRecord(acc) && acc.enabled === false) continue;\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Derive configured channel plugin ids from `channels.*` config.\n */\nexport function collectConfiguredChannelIds(config: unknown): string[] | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const channels = root?.channels;\n  if (!isRecord(channels)) return undefined;\n\n  const ids: string[] = [];\n\n  if (telegramConfigured(channels.telegram as Record<string, unknown> | undefined)) {\n    ids.push('telegram');\n  }\n  if (weixinConfigured(channels.weixin as Record<string, unknown> | undefined)) {\n    ids.push('weixin');\n  }\n\n  for (const [key, value] of Object.entries(channels)) {\n    if (key === 'telegram' || key === 'weixin') continue;\n    if (isRecord(value) && value.enabled === true && !ids.includes(key)) {\n      ids.push(key);\n    }\n  }\n\n  return ids.length ? ids : undefined;\n}\n\nfunction collectConfiguredLlmProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const candidateIds = new Set<string>(Object.keys(PROVIDER_ENV_MAP));\n  const providers = root?.providers;\n  if (isRecord(providers)) {\n    for (const key of Object.keys(providers)) {\n      candidateIds.add(key);\n    }\n  }\n  const ids: string[] = [];\n  for (const key of candidateIds) {\n    if (isProviderConfiguredSync(key)) {\n      ids.push(key);\n    }\n  }\n  return ids;\n}\n\nfunction collectConfiguredSpeechProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const messages = root?.messages;\n  if (!isRecord(messages) || !isRecord(messages.tts)) {\n    return [];\n  }\n\n  const ttsConfig = mergeTtsConfigFromAppConfig(messages.tts);\n  const ids = new Set<string>();\n  const primary = ttsConfig.provider?.trim();\n  if (primary && isProviderConfigured(primary, ttsConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectTtsProviderConfigEntries(ttsConfig))) {\n    if (isProviderConfigured(providerId, ttsConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\nfunction collectConfiguredMediaUnderstandingProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const tools = root?.tools;\n  if (!isRecord(tools) || !isRecord(tools.media)) {\n    return [];\n  }\n\n  const sttConfig = mergeSttConfigFromAppConfig(\n    tools.media.audio as Parameters<typeof mergeSttConfigFromAppConfig>[0],\n    tools.media as Parameters<typeof mergeSttConfigFromAppConfig>[1],\n  );\n  const ids = new Set<string>();\n  const primary = sttConfig.provider?.trim();\n  if (primary && isSttProviderConfigured(primary, sttConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectSttProviderConfigEntries(sttConfig))) {\n    if (isSttProviderConfigured(providerId, sttConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\n/**\n * Derive configured provider ids for extension activation (LLM + speech + STT).\n */\nexport function collectConfiguredProviderIds(config: unknown): string[] | undefined {\n  const ids = new Set<string>([\n    ...collectConfiguredLlmProviderIds(config),\n    ...collectConfiguredSpeechProviderIds(config),\n    ...collectConfiguredMediaUnderstandingProviderIds(config),\n  ]);\n  return ids.size > 0 ? [...ids] : undefined;\n}\n\nfunction defaultModelId(config: unknown): string | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const agents = root?.agents;\n  if (!isRecord(agents)) return undefined;\n  const defaults = agents.defaults;\n  if (!isRecord(defaults)) return undefined;\n  const models = defaults.models;\n  if (!isRecord(models)) return undefined;\n  const model = models.chat;\n  if (isRecord(model)) {\n    const primary = model.primary;\n    if (typeof primary === 'string' && primary.trim().length > 0) return primary;\n  }\n  return undefined;\n}\n\n/**\n * Merge partial activation context over values inferred from loaded app config.\n */\nexport function mergeActivationContext(\n  appConfig: Config | Record<string, unknown> | undefined,\n  partial?: Partial<ActivationContext>,\n): ActivationContext {\n  const ext = appConfig && isRecord((appConfig as Record<string, unknown>).extensions)\n    ? ((appConfig as Record<string, unknown>).extensions as Record<string, unknown>)\n    : undefined;\n\n  const base: ActivationContext = {\n    enabledIds: Array.isArray(ext?.enabled)\n      ? ext!.enabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    disabledIds: Array.isArray(ext?.disabled)\n      ? ext!.disabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    requestedModelId: defaultModelId(appConfig),\n    configuredProviderIds: collectConfiguredProviderIds(appConfig),\n    configuredChannelIds: collectConfiguredChannelIds(appConfig),\n    env: process.env,\n  };\n\n  return {\n    env: partial?.env ?? base.env,\n    enabledIds: partial?.enabledIds !== undefined ? partial.enabledIds : base.enabledIds,\n    disabledIds: partial?.disabledIds !== undefined ? partial.disabledIds : base.disabledIds,\n    requestedModelId:\n      partial?.requestedModelId !== undefined ? partial.requestedModelId : base.requestedModelId,\n    configuredProviderIds:\n      partial?.configuredProviderIds !== undefined\n        ? partial.configuredProviderIds\n        : base.configuredProviderIds,\n    configuredChannelIds:\n      partial?.configuredChannelIds !== undefined\n        ? partial.configuredChannelIds\n        : base.configuredChannelIds,\n  };\n}\n"],"mappings":"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"}

package/dist/src/extensions/activation-planner.js

@@ -96,6 +96,18 @@ var ActivationPlanner = class {
 				}
 			}
 		}
+		for (const entry of this.registry.getAllEntries()) {
+			if (decided.has(entry.id)) continue;
+			if (entry.manifest.channelContributions && Object.keys(entry.manifest.channelContributions).length > 0) {
+				decisions.push({
+					extensionId: entry.id,
+					activated: true,
+					reason: "activation_trigger",
+					trigger: "channel-contribution"
+				});
+				decided.add(entry.id);
+			}
+		}
 		for (const entry of this.registry.getAllEntries()) {
 			if (decided.has(entry.id)) continue;
 			if (entry.manifest.enabledByDefault) {

package/dist/src/extensions/activation-planner.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation-planner.js","names":[],"sources":["../../../src/extensions/activation-planner.ts"],"sourcesContent":["/**\n * Decides which extensions to activate from manifest metadata + config + env.\n */\n\nimport type { ManifestRegistry, ManifestRegistryEntry } from './manifest-registry.js';\n\nexport type ActivationLoadPhase = 'startup' | 'deferred';\n\nexport type ActivationReason =\n  | 'explicit_enabled'\n  | 'explicit_disabled'\n  | 'enabled_by_default'\n  | 'model_match'\n  | 'env_var_detected'\n  | 'auto_enable_provider'\n  | 'activation_trigger'\n  | 'not_activated';\n\nexport interface ActivationDecision {\n  extensionId: string;\n  activated: boolean;\n  reason: ActivationReason;\n  trigger?: string;\n}\n\nexport interface ActivationContext {\n  enabledIds?: string[];\n  disabledIds?: string[];\n  requestedModelId?: string;\n  configuredProviderIds?: string[];\n  configuredChannelIds?: string[];\n  env?: NodeJS.ProcessEnv;\n}\n\nexport class ActivationPlanner {\n  constructor(private registry: ManifestRegistry) {}\n\n  plan(context: ActivationContext): ActivationDecision[] {\n    const decisions: ActivationDecision[] = [];\n    const decided = new Set<string>();\n\n    if (context.enabledIds) {\n      for (const id of context.enabledIds) {\n        decisions.push({\n          extensionId: id,\n          activated: true,\n          reason: 'explicit_enabled',\n        });\n        decided.add(id);\n      }\n    }\n\n    if (context.disabledIds) {\n      for (const id of context.disabledIds) {\n        if (!decided.has(id)) {\n          decisions.push({\n            extensionId: id,\n            activated: false,\n            reason: 'explicit_disabled',\n          });\n          decided.add(id);\n        }\n      }\n    }\n\n    if (context.requestedModelId) {\n      const entry = this.registry.findByModelId(context.requestedModelId);\n      if (entry && !decided.has(entry.id)) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: true,\n          reason: 'model_match',\n          trigger: context.requestedModelId,\n        });\n        decided.add(entry.id);\n      }\n    }\n\n    if (context.env) {\n      const envEntries = this.registry.detectAvailableByEnv(context.env);\n      for (const entry of envEntries) {\n        if (!decided.has(entry.id)) {\n          const triggerVar = this.findTriggerEnvVar(entry, context.env);\n          decisions.push({\n            extensionId: entry.id,\n            activated: true,\n            reason: 'env_var_detected',\n            trigger: triggerVar,\n          });\n          decided.add(entry.id);\n        }\n      }\n    }\n\n    if (context.configuredProviderIds) {\n      for (const entry of this.registry.getAllEntries()) {\n        if (decided.has(entry.id)) continue;\n\n        const autoEnableProviders = entry.manifest.autoEnableWhenConfiguredProviders;\n        if (autoEnableProviders) {\n          const matchedProvider = autoEnableProviders.find((pid) =>\n            context.configuredProviderIds!.includes(pid),\n          );\n          if (matchedProvider) {\n            decisions.push({\n              extensionId: entry.id,\n              activated: true,\n              reason: 'auto_enable_provider',\n              trigger: matchedProvider,\n            });\n            decided.add(entry.id);\n          }\n        }\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (decided.has(entry.id)) continue;\n\n      const activation = entry.manifest.activation;\n      if (!activation) continue;\n\n      if (activation.onProviders && context.configuredProviderIds) {\n        const matched = activation.onProviders.find((pid) =>\n          context.configuredProviderIds!.includes(pid),\n        );\n        if (matched) {\n          decisions.push({\n            extensionId: entry.id,\n            activated: true,\n            reason: 'activation_trigger',\n            trigger: `provider:${matched}`,\n          });\n          decided.add(entry.id);\n          continue;\n        }\n      }\n\n      if (activation.onChannels && context.configuredChannelIds) {\n        const matched = activation.onChannels.find((cid) =>\n          context.configuredChannelIds!.includes(cid),\n        );\n        if (matched) {\n          decisions.push({\n            extensionId: entry.id,\n            activated: true,\n            reason: 'activation_trigger',\n            trigger: `channel:${matched}`,\n          });\n          decided.add(entry.id);\n          continue;\n        }\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (decided.has(entry.id)) continue;\n\n      if (entry.manifest.enabledByDefault) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: true,\n          reason: 'enabled_by_default',\n        });\n        decided.add(entry.id);\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (!decided.has(entry.id)) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: false,\n          reason: 'not_activated',\n        });\n      }\n    }\n\n    return decisions;\n  }\n\n  getActivatedIds(context: ActivationContext): string[] {\n    return this.plan(context)\n      .filter((d) => d.activated)\n      .map((d) => d.extensionId);\n  }\n\n  /**\n   * Split activated ids by manifest `activation.onStartup`.\n   * Extensions without the field remain on the startup path (backward compatible).\n   */\n  filterActivatedIdsByLoadPhase(\n    activatedIds: readonly string[],\n    phase: ActivationLoadPhase,\n  ): string[] {\n    return activatedIds.filter((extensionId) => {\n      const entry = this.registry.getEntry(extensionId);\n      const onStartup = entry?.manifest.activation?.onStartup;\n      const eager = onStartup !== false;\n      return phase === 'startup' ? eager : !eager;\n    });\n  }\n\n  explainPlan(context: ActivationContext): string {\n    const decisions = this.plan(context);\n    const lines: string[] = ['Extension Activation Plan:'];\n\n    for (const decision of decisions) {\n      const status = decision.activated ? '✅' : '❌';\n      const trigger = decision.trigger ? ` (trigger: ${decision.trigger})` : '';\n      lines.push(`  ${status} ${decision.extensionId}: ${decision.reason}${trigger}`);\n    }\n\n    return lines.join('\\n');\n  }\n\n  private findTriggerEnvVar(\n    entry: ManifestRegistryEntry,\n    env: NodeJS.ProcessEnv,\n  ): string | undefined {\n    const manifest = entry.manifest;\n\n    if (manifest.providerAuthEnvVars) {\n      for (const envVars of Object.values(manifest.providerAuthEnvVars)) {\n        for (const envVar of envVars) {\n          if (env[envVar]) return envVar;\n        }\n      }\n    }\n\n    if (manifest.channelEnvVars) {\n      for (const envVars of Object.values(manifest.channelEnvVars)) {\n        for (const envVar of envVars) {\n          if (env[envVar]) return envVar;\n        }\n      }\n    }\n\n    return undefined;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"activation-planner.js","names":[],"sources":["../../../src/extensions/activation-planner.ts"],"sourcesContent":["/**\n * Decides which extensions to activate from manifest metadata + config + env.\n */\n\nimport type { ManifestRegistry, ManifestRegistryEntry } from './manifest-registry.js';\n\nexport type ActivationLoadPhase = 'startup' | 'deferred';\n\nexport type ActivationReason =\n  | 'explicit_enabled'\n  | 'explicit_disabled'\n  | 'enabled_by_default'\n  | 'model_match'\n  | 'env_var_detected'\n  | 'auto_enable_provider'\n  | 'activation_trigger'\n  | 'not_activated';\n\nexport interface ActivationDecision {\n  extensionId: string;\n  activated: boolean;\n  reason: ActivationReason;\n  trigger?: string;\n}\n\nexport interface ActivationContext {\n  enabledIds?: string[];\n  disabledIds?: string[];\n  requestedModelId?: string;\n  configuredProviderIds?: string[];\n  configuredChannelIds?: string[];\n  env?: NodeJS.ProcessEnv;\n}\n\nexport class ActivationPlanner {\n  constructor(private registry: ManifestRegistry) {}\n\n  plan(context: ActivationContext): ActivationDecision[] {\n    const decisions: ActivationDecision[] = [];\n    const decided = new Set<string>();\n\n    if (context.enabledIds) {\n      for (const id of context.enabledIds) {\n        decisions.push({\n          extensionId: id,\n          activated: true,\n          reason: 'explicit_enabled',\n        });\n        decided.add(id);\n      }\n    }\n\n    if (context.disabledIds) {\n      for (const id of context.disabledIds) {\n        if (!decided.has(id)) {\n          decisions.push({\n            extensionId: id,\n            activated: false,\n            reason: 'explicit_disabled',\n          });\n          decided.add(id);\n        }\n      }\n    }\n\n    if (context.requestedModelId) {\n      const entry = this.registry.findByModelId(context.requestedModelId);\n      if (entry && !decided.has(entry.id)) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: true,\n          reason: 'model_match',\n          trigger: context.requestedModelId,\n        });\n        decided.add(entry.id);\n      }\n    }\n\n    if (context.env) {\n      const envEntries = this.registry.detectAvailableByEnv(context.env);\n      for (const entry of envEntries) {\n        if (!decided.has(entry.id)) {\n          const triggerVar = this.findTriggerEnvVar(entry, context.env);\n          decisions.push({\n            extensionId: entry.id,\n            activated: true,\n            reason: 'env_var_detected',\n            trigger: triggerVar,\n          });\n          decided.add(entry.id);\n        }\n      }\n    }\n\n    if (context.configuredProviderIds) {\n      for (const entry of this.registry.getAllEntries()) {\n        if (decided.has(entry.id)) continue;\n\n        const autoEnableProviders = entry.manifest.autoEnableWhenConfiguredProviders;\n        if (autoEnableProviders) {\n          const matchedProvider = autoEnableProviders.find((pid) =>\n            context.configuredProviderIds!.includes(pid),\n          );\n          if (matchedProvider) {\n            decisions.push({\n              extensionId: entry.id,\n              activated: true,\n              reason: 'auto_enable_provider',\n              trigger: matchedProvider,\n            });\n            decided.add(entry.id);\n          }\n        }\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (decided.has(entry.id)) continue;\n\n      const activation = entry.manifest.activation;\n      if (!activation) continue;\n\n      if (activation.onProviders && context.configuredProviderIds) {\n        const matched = activation.onProviders.find((pid) =>\n          context.configuredProviderIds!.includes(pid),\n        );\n        if (matched) {\n          decisions.push({\n            extensionId: entry.id,\n            activated: true,\n            reason: 'activation_trigger',\n            trigger: `provider:${matched}`,\n          });\n          decided.add(entry.id);\n          continue;\n        }\n      }\n\n      if (activation.onChannels && context.configuredChannelIds) {\n        const matched = activation.onChannels.find((cid) =>\n          context.configuredChannelIds!.includes(cid),\n        );\n        if (matched) {\n          decisions.push({\n            extensionId: entry.id,\n            activated: true,\n            reason: 'activation_trigger',\n            trigger: `channel:${matched}`,\n          });\n          decided.add(entry.id);\n          continue;\n        }\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (decided.has(entry.id)) continue;\n      if (entry.manifest.channelContributions && Object.keys(entry.manifest.channelContributions).length > 0) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: true,\n          reason: 'activation_trigger',\n          trigger: 'channel-contribution',\n        });\n        decided.add(entry.id);\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (decided.has(entry.id)) continue;\n\n      if (entry.manifest.enabledByDefault) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: true,\n          reason: 'enabled_by_default',\n        });\n        decided.add(entry.id);\n      }\n    }\n\n    for (const entry of this.registry.getAllEntries()) {\n      if (!decided.has(entry.id)) {\n        decisions.push({\n          extensionId: entry.id,\n          activated: false,\n          reason: 'not_activated',\n        });\n      }\n    }\n\n    return decisions;\n  }\n\n  getActivatedIds(context: ActivationContext): string[] {\n    return this.plan(context)\n      .filter((d) => d.activated)\n      .map((d) => d.extensionId);\n  }\n\n  /**\n   * Split activated ids by manifest `activation.onStartup`.\n   * Extensions without the field remain on the startup path (backward compatible).\n   */\n  filterActivatedIdsByLoadPhase(\n    activatedIds: readonly string[],\n    phase: ActivationLoadPhase,\n  ): string[] {\n    return activatedIds.filter((extensionId) => {\n      const entry = this.registry.getEntry(extensionId);\n      const onStartup = entry?.manifest.activation?.onStartup;\n      const eager = onStartup !== false;\n      return phase === 'startup' ? eager : !eager;\n    });\n  }\n\n  explainPlan(context: ActivationContext): string {\n    const decisions = this.plan(context);\n    const lines: string[] = ['Extension Activation Plan:'];\n\n    for (const decision of decisions) {\n      const status = decision.activated ? '✅' : '❌';\n      const trigger = decision.trigger ? ` (trigger: ${decision.trigger})` : '';\n      lines.push(`  ${status} ${decision.extensionId}: ${decision.reason}${trigger}`);\n    }\n\n    return lines.join('\\n');\n  }\n\n  private findTriggerEnvVar(\n    entry: ManifestRegistryEntry,\n    env: NodeJS.ProcessEnv,\n  ): string | undefined {\n    const manifest = entry.manifest;\n\n    if (manifest.providerAuthEnvVars) {\n      for (const envVars of Object.values(manifest.providerAuthEnvVars)) {\n        for (const envVar of envVars) {\n          if (env[envVar]) return envVar;\n        }\n      }\n    }\n\n    if (manifest.channelEnvVars) {\n      for (const envVars of Object.values(manifest.channelEnvVars)) {\n        for (const envVar of envVars) {\n          if (env[envVar]) return envVar;\n        }\n      }\n    }\n\n    return undefined;\n  }\n}\n"],"mappings":"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"}

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

@@ -5,7 +5,7 @@
  */
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Command } from 'commander';
-import type { ExtensionApi, ExtensionLogger, ExtensionRuntime, GatewayMethodHandler, HttpRequestHandler, ExtensionCommand, ExtensionCommandHandler, ExtensionReloadHandler, ExtensionService, FlagConfig, FlagValue, ShortcutConfig, HookHandlerMap, ExtensionHookEvent, TuiExtensionRegistrar } from './types/index.js';
+import type { ExtensionApi, ExtensionLogger, ExtensionRuntime, GatewayMethodHandler, HttpRequestHandler, ExtensionCommand, ExtensionCommandHandler, ExtensionReloadHandler, ExtensionService, FlagConfig, FlagValue, ShortcutConfig, HookHandlerMap, ExtensionHookEvent, TuiExtensionRegistrar, ExtensionSendUserMessageOptions, ExtensionUserMessageContent, ExtensionCustomMessage, ExtensionSendMessageOptions } from './types/index.js';
 import type { CommandContribution } from './types/manifest.js';
 import type { ChannelPlugin } from '../channels/plugin-types.js';
 import type { Config } from '../config/config-surface.js';
@@ -111,6 +111,10 @@ export declare class ExtensionApiImpl implements ExtensionApi {
     getFlag(_name: string): FlagValue;
     registerShortcut(_key: string, _config: ShortcutConfig): void;
     registerTui(register: TuiExtensionRegistrar): void;
+    setLabel(entryId: string, label: string | undefined): void;
+    sendUserMessage(content: ExtensionUserMessageContent, options?: ExtensionSendUserMessageOptions): void;
+    appendEntry<T = unknown>(customType: string, data?: T): void;
+    sendMessage<T = unknown>(message: ExtensionCustomMessage<T>, options?: ExtensionSendMessageOptions): void;
     _getTools(): Map<string, AgentTool>;
     _getHooks(): Map<string, Set<Function>>;
     _getEventBus(): EventEmitter;

package/dist/src/extensions/api.js

@@ -266,6 +266,18 @@ var ExtensionApiImpl = class {
 		this._registry.addTuiRegistration(this.id, register);
 		this._logger.info("Registered TUI contributions (deferred until xopc tui starts)");
 	}
+	setLabel(entryId, label) {
+		this._runtime.setLabel?.(entryId, label);
+	}
+	sendUserMessage(content, options) {
+		this._runtime.sendUserMessage?.(content, options);
+	}
+	appendEntry(customType, data) {
+		this._runtime.appendEntry?.(customType, data);
+	}
+	sendMessage(message, options) {
+		this._runtime.sendMessage?.(message, options);
+	}
 	_getTools() {
 		return this._tools;
 	}

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 './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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"}
+{"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  ExtensionSendUserMessageOptions,\n  ExtensionUserMessageContent,\n  ExtensionCustomMessage,\n  ExtensionSendMessageOptions,\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  setLabel(entryId: string, label: string | undefined): void {\n    this._runtime.setLabel?.(entryId, label);\n  }\n\n  sendUserMessage(\n    content: ExtensionUserMessageContent,\n    options?: ExtensionSendUserMessageOptions,\n  ): void {\n    this._runtime.sendUserMessage?.(content, options);\n  }\n\n  appendEntry<T = unknown>(customType: string, data?: T): void {\n    this._runtime.appendEntry?.(customType, data);\n  }\n\n  sendMessage<T = unknown>(\n    message: ExtensionCustomMessage<T>,\n    options?: ExtensionSendMessageOptions,\n  ): void {\n    this._runtime.sendMessage?.(message, options);\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":";;;;;;;;;;;;aA2CkD;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;;CAGpF,SAAS,SAAiB,OAAiC;AACzD,OAAK,SAAS,WAAW,SAAS,MAAM;;CAG1C,gBACE,SACA,SACM;AACN,OAAK,SAAS,kBAAkB,SAAS,QAAQ;;CAGnD,YAAyB,YAAoB,MAAgB;AAC3D,OAAK,SAAS,cAAc,YAAY,KAAK;;CAG/C,YACE,SACA,SACM;AACN,OAAK,SAAS,cAAc,SAAS,QAAQ;;CAI/C,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"}

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

@@ -1,24 +1,18 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.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";
+import { init_normalize_manifest, normalizeExtensionManifest } from "./normalize-manifest.js";
 import { join } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
 //#region src/extensions/discover-extensions.ts
 /**
 * Filesystem-only extension discovery (manifest parse, no module load).
 */
-init_agent_scope();
-init_loader();
-init_paths();
-init_logger();
 function asSchemaConfig(config) {
 	return config;
 }
-const EXTENSION_MANIFEST_FILE = "xopc.extension.json";
-const log = createLogger("ExtensionDiscover");
 function isRecord(x) {
 	return typeof x === "object" && x !== null && !Array.isArray(x);
 }
@@ -118,12 +112,12 @@ function discoverInDirectory(dir, source, discovered) {
 	}
 }
 function resolveDiscoveryPaths(options, config) {
-	const cfg = asSchemaConfig(config ?? loadConfig());
-	const aid = resolveDefaultAgentId(cfg);
+	const cfg = config ? asSchemaConfig(config) : null;
+	const aid = cfg ? resolveDefaultAgentId(cfg) : null;
 	return {
 		bundledDir: resolveBundledExtensionsDir(),
 		globalDir: options.extensionsDir ?? resolveExtensionsDir(),
-		workspaceExtensionsDir: options.workspaceExtensionsDir ?? resolveWorkspaceExtensionsDir(cfg, aid)
+		workspaceExtensionsDir: options.workspaceExtensionsDir ?? (cfg && aid ? resolveWorkspaceExtensionsDir(cfg, aid) : null)
 	};
 }
 /**
@@ -134,7 +128,7 @@ function discoverExtensionsFromDisk(options = {}, config) {
 	const paths = resolveDiscoveryPaths(options, config);
 	if (paths.bundledDir) discoverInDirectory(paths.bundledDir, "bundled", discovered);
 	discoverInDirectory(paths.globalDir, "global", discovered);
-	discoverInDirectory(paths.workspaceExtensionsDir, "workspace", discovered);
+	if (paths.workspaceExtensionsDir) discoverInDirectory(paths.workspaceExtensionsDir, "workspace", discovered);
 	return Array.from(discovered.values());
 }
 /** True when extension discovery/load should be skipped entirely. */
@@ -142,7 +136,17 @@ function areExtensionsGloballyDisabled(config) {
 	if (process.env.XOPC_SKIP_EXTENSIONS === "1" || process.env.XOPC_SKIP_EXTENSIONS === "true") return true;
 	return (config && isRecord(config) && isRecord(config.extensions) ? config.extensions : void 0)?.enabled === false;
 }
+var EXTENSION_MANIFEST_FILE, log;
+var init_discover_extensions = __esmMin((() => {
+	init_agent_scope();
+	init_paths();
+	init_logger();
+	init_normalize_manifest();
+	EXTENSION_MANIFEST_FILE = "xopc.extension.json";
+	log = createLogger("ExtensionDiscover");
+}));
 //#endregion
-export { areExtensionsGloballyDisabled, discoverExtensionsFromDisk };
+init_discover_extensions();
+export { areExtensionsGloballyDisabled, discoverExtensionsFromDisk, init_discover_extensions };
 
 //# sourceMappingURL=discover-extensions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"discover-extensions.js","names":[],"sources":["../../../src/extensions/discover-extensions.ts"],"sourcesContent":["/**\n * Filesystem-only extension discovery (manifest parse, no module load).\n */\n\nimport { existsSync, readdirSync, readFileSync } from 'fs';\nimport { join } from 'path';\n\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport { loadConfig } from '../config/loader.js';\nimport type { Config } from '../config/schema.js';\nimport {\n  resolveBundledExtensionsDir,\n  resolveExtensionsDir,\n  resolveWorkspaceExtensionsDir,\n} from '../config/paths.js';\nimport { createLogger } from '../utils/logger.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport type { ExtensionManifest } from './types/manifest.js';\nimport type { DiscoveredExtension } from './types/loader.js';\n\n/** App config slice used for discovery (any loaded config shape). */\nexport type DiscoverConfig = Record<string, unknown>;\n\nfunction asSchemaConfig(config: DiscoverConfig): Config {\n  return config as Config;\n}\n\nconst EXTENSION_MANIFEST_FILE = 'xopc.extension.json';\n\nconst log = createLogger('ExtensionDiscover');\n\nexport type ExtensionSourceOrigin = 'workspace' | 'global' | 'bundled' | 'config';\n\nexport interface ExtensionLoaderOptions {\n  workspaceDir?: string;\n  extensionsDir?: string;\n  workspaceExtensionsDir?: string;\n  bundledExtensions?: string[];\n}\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction loadManifest(extensionPath: string): ExtensionManifest | null {\n  const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n  if (existsSync(manifestPath)) {\n    try {\n      const raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n      if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n        log.error({ manifestPath }, 'Manifest root must be a JSON object');\n        return null;\n      }\n      return normalizeExtensionManifest(raw as Record<string, unknown>);\n    } catch (error) {\n      log.error({ err: error, manifestPath }, 'Failed to parse manifest');\n      return null;\n    }\n  }\n\n  const packagePath = join(extensionPath, 'package.json');\n  if (existsSync(packagePath)) {\n    try {\n      const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n\n      if (packageJson.xopc?.extension) {\n        const xopcConfig = packageJson.xopc;\n        return normalizeExtensionManifest({\n          id: xopcConfig.id || packageJson.name,\n          name: xopcConfig.name || packageJson.name,\n          description: xopcConfig.description || packageJson.description,\n          version: xopcConfig.version || packageJson.version || '1.0.0',\n          kind: xopcConfig.kind || 'utility',\n          main: xopcConfig.main || packageJson.main || 'index.js',\n          configSchema: xopcConfig.configSchema,\n        });\n      }\n\n      if (packageJson.name?.startsWith('xopc-extension-')) {\n        const id = packageJson.name.replace('xopc-extension-', '');\n        return normalizeExtensionManifest({\n          id,\n          name: packageJson.name,\n          description: packageJson.description,\n          version: packageJson.version || '1.0.0',\n          kind: 'utility',\n          main: packageJson.main || 'index.js',\n        });\n      }\n    } catch (error) {\n      log.error({ err: error, packagePath }, 'Failed to parse package.json');\n    }\n  }\n\n  return null;\n}\n\nfunction discoverInDirectory(\n  dir: string,\n  source: ExtensionSourceOrigin,\n  discovered: Map<string, DiscoveredExtension>,\n): void {\n  if (!existsSync(dir)) {\n    return;\n  }\n\n  let entries: string[];\n  try {\n    entries = readdirSync(dir);\n  } catch {\n    return;\n  }\n\n  for (const entry of entries) {\n    const extensionPath = join(dir, entry);\n\n    try {\n      if (!existsSync(extensionPath)) continue;\n    } catch {\n      continue;\n    }\n\n    const manifest = loadManifest(extensionPath);\n    if (!manifest) continue;\n\n    const extensionId = manifest.id || entry;\n\n    const existing = discovered.get(extensionId);\n    if (existing) {\n      const priority = { workspace: 3, global: 2, bundled: 1, config: 0 };\n      if (priority[source] <= priority[existing.source]) {\n        log.debug(\n          { extensionId, from: source, existing: existing.source },\n          'Skipping lower priority extension',\n        );\n        continue;\n      }\n      log.info(\n        { extensionId, from: source, overriding: existing.source },\n        'Extension override by higher priority source',\n      );\n    }\n\n    discovered.set(extensionId, {\n      id: extensionId,\n      path: extensionPath,\n      source,\n      manifest,\n    });\n  }\n}\n\nfunction resolveDiscoveryPaths(\n  options: ExtensionLoaderOptions,\n  config?: DiscoverConfig,\n): {\n  bundledDir: string | null;\n  globalDir: string;\n  workspaceExtensionsDir: string;\n} {\n  const cfg = asSchemaConfig(config ?? loadConfig());\n  const aid = resolveDefaultAgentId(cfg);\n\n  return {\n    bundledDir: resolveBundledExtensionsDir(),\n    globalDir: options.extensionsDir ?? resolveExtensionsDir(),\n    workspaceExtensionsDir:\n      options.workspaceExtensionsDir ??\n      resolveWorkspaceExtensionsDir(cfg, aid),\n  };\n}\n\n/**\n * Discover extensions from workspace, global, and bundled tiers without loading code.\n */\nexport function discoverExtensionsFromDisk(\n  options: ExtensionLoaderOptions = {},\n  config?: DiscoverConfig,\n): DiscoveredExtension[] {\n  const discovered = new Map<string, DiscoveredExtension>();\n  const paths = resolveDiscoveryPaths(options, config);\n\n  if (paths.bundledDir) {\n    discoverInDirectory(paths.bundledDir, 'bundled', discovered);\n  }\n\n  discoverInDirectory(paths.globalDir, 'global', discovered);\n  discoverInDirectory(paths.workspaceExtensionsDir, 'workspace', discovered);\n\n  return Array.from(discovered.values());\n}\n\n/** True when extension discovery/load should be skipped entirely. */\nexport function areExtensionsGloballyDisabled(config?: DiscoverConfig): boolean {\n  if (\n    process.env.XOPC_SKIP_EXTENSIONS === '1' ||\n    process.env.XOPC_SKIP_EXTENSIONS === 'true'\n  ) {\n    return true;\n  }\n\n  const ext =\n    config && isRecord(config) && isRecord((config as Record<string, unknown>).extensions)\n      ? ((config as Record<string, unknown>).extensions as Record<string, unknown>)\n      : undefined;\n\n  return ext?.enabled === false;\n}\n"],"mappings":"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"}
+{"version":3,"file":"discover-extensions.js","names":[],"sources":["../../../src/extensions/discover-extensions.ts"],"sourcesContent":["/**\n * Filesystem-only extension discovery (manifest parse, no module load).\n */\n\nimport { existsSync, readdirSync, readFileSync } from 'fs';\nimport { join } from 'path';\n\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport {\n  resolveBundledExtensionsDir,\n  resolveExtensionsDir,\n  resolveWorkspaceExtensionsDir,\n} from '../config/paths.js';\nimport { createLogger } from '../utils/logger.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport type { ExtensionManifest } from './types/manifest.js';\nimport type { DiscoveredExtension } from './types/loader.js';\n\n/** App config slice used for discovery (any loaded config shape). */\nexport type DiscoverConfig = Record<string, unknown>;\n\nfunction asSchemaConfig(config: DiscoverConfig): Config {\n  return config as Config;\n}\n\nconst EXTENSION_MANIFEST_FILE = 'xopc.extension.json';\n\nconst log = createLogger('ExtensionDiscover');\n\nexport type ExtensionSourceOrigin = 'workspace' | 'global' | 'bundled' | 'config';\n\nexport interface ExtensionLoaderOptions {\n  workspaceDir?: string;\n  extensionsDir?: string;\n  workspaceExtensionsDir?: string;\n  bundledExtensions?: string[];\n}\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction loadManifest(extensionPath: string): ExtensionManifest | null {\n  const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n  if (existsSync(manifestPath)) {\n    try {\n      const raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n      if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n        log.error({ manifestPath }, 'Manifest root must be a JSON object');\n        return null;\n      }\n      return normalizeExtensionManifest(raw as Record<string, unknown>);\n    } catch (error) {\n      log.error({ err: error, manifestPath }, 'Failed to parse manifest');\n      return null;\n    }\n  }\n\n  const packagePath = join(extensionPath, 'package.json');\n  if (existsSync(packagePath)) {\n    try {\n      const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n\n      if (packageJson.xopc?.extension) {\n        const xopcConfig = packageJson.xopc;\n        return normalizeExtensionManifest({\n          id: xopcConfig.id || packageJson.name,\n          name: xopcConfig.name || packageJson.name,\n          description: xopcConfig.description || packageJson.description,\n          version: xopcConfig.version || packageJson.version || '1.0.0',\n          kind: xopcConfig.kind || 'utility',\n          main: xopcConfig.main || packageJson.main || 'index.js',\n          configSchema: xopcConfig.configSchema,\n        });\n      }\n\n      if (packageJson.name?.startsWith('xopc-extension-')) {\n        const id = packageJson.name.replace('xopc-extension-', '');\n        return normalizeExtensionManifest({\n          id,\n          name: packageJson.name,\n          description: packageJson.description,\n          version: packageJson.version || '1.0.0',\n          kind: 'utility',\n          main: packageJson.main || 'index.js',\n        });\n      }\n    } catch (error) {\n      log.error({ err: error, packagePath }, 'Failed to parse package.json');\n    }\n  }\n\n  return null;\n}\n\nfunction discoverInDirectory(\n  dir: string,\n  source: ExtensionSourceOrigin,\n  discovered: Map<string, DiscoveredExtension>,\n): void {\n  if (!existsSync(dir)) {\n    return;\n  }\n\n  let entries: string[];\n  try {\n    entries = readdirSync(dir);\n  } catch {\n    return;\n  }\n\n  for (const entry of entries) {\n    const extensionPath = join(dir, entry);\n\n    try {\n      if (!existsSync(extensionPath)) continue;\n    } catch {\n      continue;\n    }\n\n    const manifest = loadManifest(extensionPath);\n    if (!manifest) continue;\n\n    const extensionId = manifest.id || entry;\n\n    const existing = discovered.get(extensionId);\n    if (existing) {\n      const priority = { workspace: 3, global: 2, bundled: 1, config: 0 };\n      if (priority[source] <= priority[existing.source]) {\n        log.debug(\n          { extensionId, from: source, existing: existing.source },\n          'Skipping lower priority extension',\n        );\n        continue;\n      }\n      log.info(\n        { extensionId, from: source, overriding: existing.source },\n        'Extension override by higher priority source',\n      );\n    }\n\n    discovered.set(extensionId, {\n      id: extensionId,\n      path: extensionPath,\n      source,\n      manifest,\n    });\n  }\n}\n\nfunction resolveDiscoveryPaths(\n  options: ExtensionLoaderOptions,\n  config?: DiscoverConfig,\n): {\n  bundledDir: string | null;\n  globalDir: string;\n  workspaceExtensionsDir: string | null;\n} {\n  const cfg = config ? asSchemaConfig(config) : null;\n  const aid = cfg ? resolveDefaultAgentId(cfg) : null;\n\n  return {\n    bundledDir: resolveBundledExtensionsDir(),\n    globalDir: options.extensionsDir ?? resolveExtensionsDir(),\n    workspaceExtensionsDir:\n      options.workspaceExtensionsDir ??\n      (cfg && aid ? resolveWorkspaceExtensionsDir(cfg, aid) : null),\n  };\n}\n\n/**\n * Discover extensions from workspace, global, and bundled tiers without loading code.\n */\nexport function discoverExtensionsFromDisk(\n  options: ExtensionLoaderOptions = {},\n  config?: DiscoverConfig,\n): DiscoveredExtension[] {\n  const discovered = new Map<string, DiscoveredExtension>();\n  const paths = resolveDiscoveryPaths(options, config);\n\n  if (paths.bundledDir) {\n    discoverInDirectory(paths.bundledDir, 'bundled', discovered);\n  }\n\n  discoverInDirectory(paths.globalDir, 'global', discovered);\n  if (paths.workspaceExtensionsDir) {\n    discoverInDirectory(paths.workspaceExtensionsDir, 'workspace', discovered);\n  }\n\n  return Array.from(discovered.values());\n}\n\n/** True when extension discovery/load should be skipped entirely. */\nexport function areExtensionsGloballyDisabled(config?: DiscoverConfig): boolean {\n  if (\n    process.env.XOPC_SKIP_EXTENSIONS === '1' ||\n    process.env.XOPC_SKIP_EXTENSIONS === 'true'\n  ) {\n    return true;\n  }\n\n  const ext =\n    config && isRecord(config) && isRecord((config as Record<string, unknown>).extensions)\n      ? ((config as Record<string, unknown>).extensions as Record<string, unknown>)\n      : undefined;\n\n  return ext?.enabled === false;\n}\n"],"mappings":"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"}