@xopcai/xopc 0.0.117 → 0.0.119

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  ExtensionHookHandler,\n  HookExecutionMode,\n  TuiExtensionRegistrar,\n  ExtensionSendUserMessageOptions,\n  ExtensionUserMessageContent,\n  ExtensionCustomMessage,\n  ExtensionSendMessageOptions,\n} from './types/index.js';\nimport type { CommandContribution, ContractDeclaration } 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    private readonly _contracts: ContractDeclaration = {},\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  private _assertContract(kind: keyof ContractDeclaration, value: string): void {\n    const declared = this._contracts[kind];\n    if (!declared?.length) {\n      throw new Error(\n        `Extension ${this.id} attempted to register ${kind}:${value}, but manifest contracts.${kind} is missing`,\n      );\n    }\n    const allowed = declared.some((entry) => {\n      if (entry === value) return true;\n      if (entry.endsWith('*')) return value.startsWith(entry.slice(0, -1));\n      return false;\n    });\n    if (!allowed) {\n      throw new Error(\n        `Extension ${this.id} attempted to register ${kind}:${value}, but it is not declared in manifest contracts.${kind}`,\n      );\n    }\n  }\n\n  registerTool(tool: AgentTool): void {\n    this._assertContract('tools', tool.name);\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    this._assertContract('hooks', event);\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._registry.addHook(event as ExtensionHookEvent, handler as ExtensionHookHandler, this.id, opts?.priority ?? 0);\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    this._assertContract('hooks', hookName);\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._assertContract('channels', plugin.id);\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._assertContract('httpRoutes', path);\n    this._registry.addHttpRoute(path, handler);\n    this._eventBus.emit('http:route', { path, handler });\n    this._logger.info(`Registered HTTP route: ${path}`);\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    this._assertContract('commands', command.name);\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      throw new Error(\n        `Extension ${this.id} attempted to bind command ${commandId}, but it is not declared in manifest ui.contributions.commands`,\n      );\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._assertContract('services', service.id);\n    this._registry.addService(service);\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._assertContract('gatewayMethods', method);\n    this._registry.addGatewayMethod(method, handler);\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    for (const command of opts?.commands ?? []) {\n      this._assertContract('cliCommands', command);\n    }\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    this._assertContract('providers', plugin.id);\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    this._assertContract('speechProviders', plugin.id);\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    this._assertContract('mediaUnderstandingProviders', plugin.id);\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    const adapterId = registration.adapter.id;\n    this._assertContract('marketplaceAdapters', adapterId);\n    _registerMarketplaceAdapter(registration);\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._assertContract('tui', this.id);\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":"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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  ExtensionHookHandler,\n  HookExecutionMode,\n  TuiExtensionRegistrar,\n  ExtensionSendUserMessageOptions,\n  ExtensionUserMessageContent,\n  ExtensionCustomMessage,\n  ExtensionSendMessageOptions,\n} from './types/index.js';\nimport type { CommandContribution, ContractDeclaration } 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';\nimport { registerMigration as registerRuntimeMigration } from '../migrations/registry.js';\nimport type { Migration } from '../migrations/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    private readonly _contracts: ContractDeclaration = {},\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  private _assertContract(kind: keyof ContractDeclaration, value: string): void {\n    const declared = this._contracts[kind];\n    if (!declared?.length) {\n      throw new Error(\n        `Extension ${this.id} attempted to register ${kind}:${value}, but manifest contracts.${kind} is missing`,\n      );\n    }\n    const allowed = declared.some((entry) => {\n      if (entry === value) return true;\n      if (entry.endsWith('*')) return value.startsWith(entry.slice(0, -1));\n      return false;\n    });\n    if (!allowed) {\n      throw new Error(\n        `Extension ${this.id} attempted to register ${kind}:${value}, but it is not declared in manifest contracts.${kind}`,\n      );\n    }\n  }\n\n  registerTool(tool: AgentTool): void {\n    this._assertContract('tools', tool.name);\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    this._assertContract('hooks', event);\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._registry.addHook(event as ExtensionHookEvent, handler as ExtensionHookHandler, this.id, opts?.priority ?? 0);\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    this._assertContract('hooks', hookName);\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._assertContract('channels', plugin.id);\n    this._registry.addChannelPlugin(plugin);\n    for (const migration of plugin.migrations ?? []) {\n      this.registerMigration(migration);\n    }\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._assertContract('httpRoutes', path);\n    this._registry.addHttpRoute(path, handler);\n    this._eventBus.emit('http:route', { path, handler });\n    this._logger.info(`Registered HTTP route: ${path}`);\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    this._assertContract('commands', command.name);\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      throw new Error(\n        `Extension ${this.id} attempted to bind command ${commandId}, but it is not declared in manifest ui.contributions.commands`,\n      );\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  registerMigration(migration: Migration): void {\n    this._registry.addMigrationRegistration({ extensionId: this.id, migration });\n    registerRuntimeMigration(`extension:${this.id}`, migration);\n    this._logger.info(`Registered migration: ${migration.id}`);\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._assertContract('services', service.id);\n    this._registry.addService(service);\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._assertContract('gatewayMethods', method);\n    this._registry.addGatewayMethod(method, handler);\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    for (const command of opts?.commands ?? []) {\n      this._assertContract('cliCommands', command);\n    }\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    this._assertContract('providers', plugin.id);\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    this._assertContract('speechProviders', plugin.id);\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    this._assertContract('mediaUnderstandingProviders', plugin.id);\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    const adapterId = registration.adapter.id;\n    this._assertContract('marketplaceAdapters', adapterId);\n    _registerMarketplaceAdapter(registration);\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._assertContract('tui', this.id);\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":"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"}

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

@@ -8,7 +8,7 @@
  */
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { ChannelPlugin } from '../channels/plugin-types.js';
-import type { ExtensionCliRegistration, ExtensionCommand, ExtensionHookEvent, ExtensionHookHandler, ExtensionRecord, ExtensionRegistry, ExtensionReloadRegistration, ExtensionService, GatewayMethodHandler, HttpRequestHandler, TuiExtensionRegistrar, TuiExtensionRegistration } from './types/index.js';
+import type { ExtensionCliRegistration, ExtensionCommand, ExtensionHookEvent, ExtensionHookHandler, ExtensionRecord, ExtensionRegistry, ExtensionMigrationRegistration, ExtensionReloadRegistration, ExtensionService, GatewayMethodHandler, HttpRequestHandler, TuiExtensionRegistrar, TuiExtensionRegistration } from './types/index.js';
 export declare class ExtensionRegistryImpl implements ExtensionRegistry {
     extensions: Map<string, ExtensionRecord>;
     hooks: Map<ExtensionHookEvent, ExtensionHookHandler[]>;
@@ -20,6 +20,7 @@ export declare class ExtensionRegistryImpl implements ExtensionRegistry {
     channelPlugins: ChannelPlugin[];
     private cliRegistrations;
     private reloadRegistrations;
+    private migrationRegistrations;
     private tuiRegistrations;
     addExtension(record: ExtensionRecord): void;
     getExtension(id: string): ExtensionRecord | undefined;
@@ -47,5 +48,7 @@ export declare class ExtensionRegistryImpl implements ExtensionRegistry {
     addReloadRegistration(reg: ExtensionReloadRegistration): void;
     removeReloadRegistration(extensionId: string): void;
     getReloadRegistrations(): readonly ExtensionReloadRegistration[];
+    addMigrationRegistration(reg: ExtensionMigrationRegistration): void;
+    getMigrationRegistrations(): readonly ExtensionMigrationRegistration[];
     getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[];
 }

package/dist/src/extensions/extension-registry-impl.js

@@ -14,6 +14,7 @@ var ExtensionRegistryImpl = class {
 	channelPlugins = [];
 	cliRegistrations = [];
 	reloadRegistrations = [];
+	migrationRegistrations = [];
 	tuiRegistrations = [];
 	addExtension(record) {
 		this.extensions.set(record.id, record);
@@ -104,6 +105,13 @@ var ExtensionRegistryImpl = class {
 	getReloadRegistrations() {
 		return this.reloadRegistrations;
 	}
+	addMigrationRegistration(reg) {
+		this.migrationRegistrations = this.migrationRegistrations.filter((r) => !(r.extensionId === reg.extensionId && r.migration.id === reg.migration.id));
+		this.migrationRegistrations.push(reg);
+	}
+	getMigrationRegistrations() {
+		return this.migrationRegistrations;
+	}
 	getMatchingReloadRegistrations(changedPaths) {
 		return this.reloadRegistrations.filter((reg) => {
 			if (reg.configPrefixes.length === 0) return true;

package/dist/src/extensions/extension-registry-impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-registry-impl.js","names":[],"sources":["../../../src/extensions/extension-registry-impl.ts"],"sourcesContent":["/**\n * `ExtensionRegistryImpl` — extracted from `loader.ts` so `api.ts` can use it\n * without going through `loader.ts` (which imports back from `api.ts`,\n * forming a circular cycle).\n *\n * `loader.ts` still re-exports the class for backward-compat; this file is a\n * leaf and only depends on the type definitions in `./types/index.js`.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport type {\n  ExtensionCliRegistration,\n  ExtensionCommand,\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  ExtensionRecord,\n  ExtensionRegistry,\n  ExtensionReloadRegistration,\n  ExtensionService,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n  TuiExtensionRegistrar,\n  TuiExtensionRegistration,\n} from './types/index.js';\n\nconst log = createLogger('ExtensionRegistry');\n\nexport class ExtensionRegistryImpl implements ExtensionRegistry {\n  extensions = new Map<string, ExtensionRecord>();\n  hooks = new Map<ExtensionHookEvent, ExtensionHookHandler[]>();\n  httpRoutes = new Map<string, HttpRequestHandler>();\n  commands = new Map<string, ExtensionCommand>();\n  services = new Map<string, ExtensionService>();\n  gatewayMethods = new Map<string, GatewayMethodHandler>();\n  tools: Map<string, AgentTool<any, any>> = new Map();\n  channelPlugins: ChannelPlugin[] = [];\n  private cliRegistrations: ExtensionCliRegistration[] = [];\n  private reloadRegistrations: ExtensionReloadRegistration[] = [];\n  private tuiRegistrations: TuiExtensionRegistration[] = [];\n\n  addExtension(record: ExtensionRecord): void {\n    this.extensions.set(record.id, record);\n  }\n\n  getExtension(id: string): ExtensionRecord | undefined {\n    return this.extensions.get(id);\n  }\n\n  getEnabledExtensions(): ExtensionRecord[] {\n    return Array.from(this.extensions.values()).filter((p) => p.enabled);\n  }\n\n  addHook(\n    event: ExtensionHookEvent,\n    handler: ExtensionHookHandler,\n    _extensionId: string,\n    _priority = 0,\n  ): void {\n    if (!this.hooks.has(event)) {\n      this.hooks.set(event, []);\n    }\n    this.hooks.get(event)!.push(handler);\n  }\n\n  getHooks(event: ExtensionHookEvent): ExtensionHookHandler[] {\n    return this.hooks.get(event) || [];\n  }\n\n  addChannelPlugin(plugin: ChannelPlugin): void {\n    this.channelPlugins = this.channelPlugins.filter((p) => p.id !== plugin.id);\n    this.channelPlugins.push(plugin);\n  }\n\n  addHttpRoute(path: string, handler: HttpRequestHandler): void {\n    if (this.httpRoutes.has(path)) {\n      log.warn({ path }, `HTTP route already registered, overwriting`);\n    }\n    this.httpRoutes.set(path, handler);\n  }\n\n  getHttpRoute(path: string): HttpRequestHandler | undefined {\n    return this.httpRoutes.get(path);\n  }\n\n  addCommand(command: ExtensionCommand): void {\n    if (this.commands.has(command.name)) {\n      log.warn({ command: command.name }, `Command already registered, overwriting`);\n    }\n    this.commands.set(command.name, command);\n  }\n\n  getCommand(name: string): ExtensionCommand | undefined {\n    return this.commands.get(name);\n  }\n\n  addService(service: ExtensionService): void {\n    if (this.services.has(service.id)) {\n      log.warn({ service: service.id }, `Service already registered, overwriting`);\n    }\n    this.services.set(service.id, service);\n  }\n\n  getService(id: string): ExtensionService | undefined {\n    return this.services.get(id);\n  }\n\n  addGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    if (this.gatewayMethods.has(method)) {\n      log.warn({ method }, `Gateway method already registered, overwriting`);\n    }\n    this.gatewayMethods.set(method, handler);\n  }\n\n  getGatewayMethod(method: string): GatewayMethodHandler | undefined {\n    return this.gatewayMethods.get(method);\n  }\n\n  // Tools\n  addTool(tool: any): void {\n    if (this.tools.has(tool.name)) {\n      log.warn({ tool: tool.name }, `Tool already registered, overwriting`);\n    }\n    this.tools.set(tool.name, tool);\n  }\n\n  removeTool(name: string): void {\n    this.tools.delete(name);\n  }\n\n  getTools(): Map<string, any> {\n    return this.tools;\n  }\n\n  getTool(name: string): any | undefined {\n    return this.tools.get(name);\n  }\n\n  getAllTools(): any[] {\n    return Array.from(this.tools.values());\n  }\n\n  addCliRegistration(reg: ExtensionCliRegistration): void {\n    this.cliRegistrations.push(reg);\n  }\n\n  getCliRegistrations(): readonly ExtensionCliRegistration[] {\n    return this.cliRegistrations;\n  }\n\n  addTuiRegistration(extensionId: string, register: TuiExtensionRegistrar): void {\n    this.tuiRegistrations.push({ extensionId, register });\n  }\n\n  getTuiRegistrations(): readonly TuiExtensionRegistration[] {\n    return this.tuiRegistrations;\n  }\n\n  addReloadRegistration(reg: ExtensionReloadRegistration): void {\n    this.reloadRegistrations = this.reloadRegistrations.filter(\n      (r) => r.extensionId !== reg.extensionId,\n    );\n    this.reloadRegistrations.push(reg);\n  }\n\n  removeReloadRegistration(extensionId: string): void {\n    this.reloadRegistrations = this.reloadRegistrations.filter(\n      (r) => r.extensionId !== extensionId,\n    );\n  }\n\n  getReloadRegistrations(): readonly ExtensionReloadRegistration[] {\n    return this.reloadRegistrations;\n  }\n\n  getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[] {\n    return this.reloadRegistrations.filter((reg) => {\n      if (reg.configPrefixes.length === 0) {\n        return true;\n      }\n      return reg.configPrefixes.some((prefix) =>\n        changedPaths.some((path) => path === prefix || path.startsWith(`${prefix}.`)),\n      );\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"extension-registry-impl.js","names":[],"sources":["../../../src/extensions/extension-registry-impl.ts"],"sourcesContent":["/**\n * `ExtensionRegistryImpl` — extracted from `loader.ts` so `api.ts` can use it\n * without going through `loader.ts` (which imports back from `api.ts`,\n * forming a circular cycle).\n *\n * `loader.ts` still re-exports the class for backward-compat; this file is a\n * leaf and only depends on the type definitions in `./types/index.js`.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport type {\n  ExtensionCliRegistration,\n  ExtensionCommand,\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  ExtensionRecord,\n  ExtensionRegistry,\n  ExtensionMigrationRegistration,\n  ExtensionReloadRegistration,\n  ExtensionService,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n  TuiExtensionRegistrar,\n  TuiExtensionRegistration,\n} from './types/index.js';\n\nconst log = createLogger('ExtensionRegistry');\n\nexport class ExtensionRegistryImpl implements ExtensionRegistry {\n  extensions = new Map<string, ExtensionRecord>();\n  hooks = new Map<ExtensionHookEvent, ExtensionHookHandler[]>();\n  httpRoutes = new Map<string, HttpRequestHandler>();\n  commands = new Map<string, ExtensionCommand>();\n  services = new Map<string, ExtensionService>();\n  gatewayMethods = new Map<string, GatewayMethodHandler>();\n  tools: Map<string, AgentTool<any, any>> = new Map();\n  channelPlugins: ChannelPlugin[] = [];\n  private cliRegistrations: ExtensionCliRegistration[] = [];\n  private reloadRegistrations: ExtensionReloadRegistration[] = [];\n  private migrationRegistrations: ExtensionMigrationRegistration[] = [];\n  private tuiRegistrations: TuiExtensionRegistration[] = [];\n\n  addExtension(record: ExtensionRecord): void {\n    this.extensions.set(record.id, record);\n  }\n\n  getExtension(id: string): ExtensionRecord | undefined {\n    return this.extensions.get(id);\n  }\n\n  getEnabledExtensions(): ExtensionRecord[] {\n    return Array.from(this.extensions.values()).filter((p) => p.enabled);\n  }\n\n  addHook(\n    event: ExtensionHookEvent,\n    handler: ExtensionHookHandler,\n    _extensionId: string,\n    _priority = 0,\n  ): void {\n    if (!this.hooks.has(event)) {\n      this.hooks.set(event, []);\n    }\n    this.hooks.get(event)!.push(handler);\n  }\n\n  getHooks(event: ExtensionHookEvent): ExtensionHookHandler[] {\n    return this.hooks.get(event) || [];\n  }\n\n  addChannelPlugin(plugin: ChannelPlugin): void {\n    this.channelPlugins = this.channelPlugins.filter((p) => p.id !== plugin.id);\n    this.channelPlugins.push(plugin);\n  }\n\n  addHttpRoute(path: string, handler: HttpRequestHandler): void {\n    if (this.httpRoutes.has(path)) {\n      log.warn({ path }, `HTTP route already registered, overwriting`);\n    }\n    this.httpRoutes.set(path, handler);\n  }\n\n  getHttpRoute(path: string): HttpRequestHandler | undefined {\n    return this.httpRoutes.get(path);\n  }\n\n  addCommand(command: ExtensionCommand): void {\n    if (this.commands.has(command.name)) {\n      log.warn({ command: command.name }, `Command already registered, overwriting`);\n    }\n    this.commands.set(command.name, command);\n  }\n\n  getCommand(name: string): ExtensionCommand | undefined {\n    return this.commands.get(name);\n  }\n\n  addService(service: ExtensionService): void {\n    if (this.services.has(service.id)) {\n      log.warn({ service: service.id }, `Service already registered, overwriting`);\n    }\n    this.services.set(service.id, service);\n  }\n\n  getService(id: string): ExtensionService | undefined {\n    return this.services.get(id);\n  }\n\n  addGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    if (this.gatewayMethods.has(method)) {\n      log.warn({ method }, `Gateway method already registered, overwriting`);\n    }\n    this.gatewayMethods.set(method, handler);\n  }\n\n  getGatewayMethod(method: string): GatewayMethodHandler | undefined {\n    return this.gatewayMethods.get(method);\n  }\n\n  // Tools\n  addTool(tool: any): void {\n    if (this.tools.has(tool.name)) {\n      log.warn({ tool: tool.name }, `Tool already registered, overwriting`);\n    }\n    this.tools.set(tool.name, tool);\n  }\n\n  removeTool(name: string): void {\n    this.tools.delete(name);\n  }\n\n  getTools(): Map<string, any> {\n    return this.tools;\n  }\n\n  getTool(name: string): any | undefined {\n    return this.tools.get(name);\n  }\n\n  getAllTools(): any[] {\n    return Array.from(this.tools.values());\n  }\n\n  addCliRegistration(reg: ExtensionCliRegistration): void {\n    this.cliRegistrations.push(reg);\n  }\n\n  getCliRegistrations(): readonly ExtensionCliRegistration[] {\n    return this.cliRegistrations;\n  }\n\n  addTuiRegistration(extensionId: string, register: TuiExtensionRegistrar): void {\n    this.tuiRegistrations.push({ extensionId, register });\n  }\n\n  getTuiRegistrations(): readonly TuiExtensionRegistration[] {\n    return this.tuiRegistrations;\n  }\n\n  addReloadRegistration(reg: ExtensionReloadRegistration): void {\n    this.reloadRegistrations = this.reloadRegistrations.filter(\n      (r) => r.extensionId !== reg.extensionId,\n    );\n    this.reloadRegistrations.push(reg);\n  }\n\n  removeReloadRegistration(extensionId: string): void {\n    this.reloadRegistrations = this.reloadRegistrations.filter(\n      (r) => r.extensionId !== extensionId,\n    );\n  }\n\n  getReloadRegistrations(): readonly ExtensionReloadRegistration[] {\n    return this.reloadRegistrations;\n  }\n\n  addMigrationRegistration(reg: ExtensionMigrationRegistration): void {\n    this.migrationRegistrations = this.migrationRegistrations.filter(\n      (r) => !(r.extensionId === reg.extensionId && r.migration.id === reg.migration.id),\n    );\n    this.migrationRegistrations.push(reg);\n  }\n\n  getMigrationRegistrations(): readonly ExtensionMigrationRegistration[] {\n    return this.migrationRegistrations;\n  }\n\n  getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[] {\n    return this.reloadRegistrations.filter((reg) => {\n      if (reg.configPrefixes.length === 0) {\n        return true;\n      }\n      return reg.configPrefixes.some((prefix) =>\n        changedPaths.some((path) => path === prefix || path.startsWith(`${prefix}.`)),\n      );\n    });\n  }\n}\n"],"mappings":"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"}

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

@@ -86,15 +86,15 @@ export declare class ExtensionLoader {
     }): void;
     getRegistry(): ExtensionRegistryImpl;
     /**
-     * Phase 1: build manifest registry (filesystem manifests only, no extension code load).
+     * Build the manifest registry from filesystem manifests without loading extension code.
      */
     buildManifestRegistry(): ManifestRegistry;
     /**
-     * Phase 2: activation planner over the manifest registry (pure logic).
+     * Plan activation from manifest metadata with pure logic.
      */
     planActivation(_context?: Partial<ActivationContext>): ActivationPlanner;
     /**
-     * Phase 3: load only extensions selected by the activation plan.
+     * Load only extensions selected by the activation plan.
      */
     loadByActivationPlan(context?: ActivationPlanLoadOptions): Promise<void>;
     getManifestRegistry(): ManifestRegistry;

package/dist/src/extensions/loader.js

@@ -195,7 +195,7 @@ var ExtensionLoader = class {
 		return this.registry;
 	}
 	/**
-	* Phase 1: build manifest registry (filesystem manifests only, no extension code load).
+	* Build the manifest registry from filesystem manifests without loading extension code.
 	*/
 	buildManifestRegistry() {
 		if (this.manifestRegistry) return this.manifestRegistry;
@@ -204,13 +204,13 @@ var ExtensionLoader = class {
 		return this.manifestRegistry;
 	}
 	/**
-	* Phase 2: activation planner over the manifest registry (pure logic).
+	* Plan activation from manifest metadata with pure logic.
 	*/
 	planActivation(_context) {
 		return new ActivationPlanner(this.buildManifestRegistry());
 	}
 	/**
-	* Phase 3: load only extensions selected by the activation plan.
+	* Load only extensions selected by the activation plan.
 	*/
 	async loadByActivationPlan(context) {
 		if (areExtensionsGloballyDisabled(this._appConfig)) {

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

@@ -1 +1 @@
-{"version":3,"file":"loader.js","names":["apiImpl"],"sources":["../../../src/extensions/loader.ts"],"sourcesContent":["/**\n * Extension Loader and Registry\n * \n * Supports three-tier extension storage:\n * 1. Workspace level (workspace/.extensions/) - highest priority\n * 2. Global level (~/.xopc/extensions/) - shared across workspaces\n * 3. Bundled level (xopc/extensions/) - shipped with xopc\n */\n\nimport { existsSync, readFileSync } from 'fs';\nimport { join, dirname, isAbsolute } from 'path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport { createJiti } from 'jiti';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport { loadConfig } from '../config/loader.js';\nimport {\n  resolveAgentWorkspaceDir,\n  resolveExtensionsDir,\n  resolveWorkspaceExtensionsDir,\n  resolveBundledExtensionsDir,\n  resolveExtensionSdkPath,\n} from '../config/paths.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionIndex } from '../session/manager.js';\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type {\n  ExtensionApi,\n  ExtensionModule,\n  ExtensionManifest,\n  ResolvedExtensionConfig,\n  DiscoveredExtension,\n} from './types/index.js';\nimport type { ActivationContext } from './activation-planner.js';\nimport { ActivationPlanner, type ActivationLoadPhase } from './activation-planner.js';\nimport { mergeActivationContext } from './activation-context.js';\nimport {\n  areExtensionsGloballyDisabled,\n  discoverExtensionsFromDisk,\n  type DiscoverConfig,\n  type ExtensionLoaderOptions,\n} from './discover-extensions.js';\nimport type { ExtensionMetadataSnapshot } from './extension-metadata-snapshot.js';\nimport { ManifestRegistry } from './manifest-registry.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport { checkEngineCompatibility } from './engine-check.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport { ExtensionApiImpl, createExtensionLogger, createPathResolver } from './api.js';\nimport { validateSpeechProviderContracts } from './speech-provider-contracts.js';\nimport { validateMediaUnderstandingProviderContracts } from './media-provider-contracts.js';\nimport { createLogger, createServiceLogger } from '../utils/logger.js';\n\n//  Security imports\nimport {\n  checkExtensionPathSafety,\n  isExtensionAllowed,\n  provenanceTracker,\n  logSecurityIssue,\n  DEFAULT_SECURITY_CONFIG,\n  type SecurityConfig,\n  // Note: ExtensionSourceOrigin is defined locally in this file\n} from './security.js';\n\n//  Provider imports\nimport { getProviderRegistry, type ProviderPluginRegistry } from '../providers/plugin-registry.js';\n\n//  Slot imports\nimport {\n  getSlotRegistry,\n  type SlotRegistry,\n  type SlotKey,\n} from './slots.js';\n\n//  Diagnostics imports\nimport {\n  getExtensionCache,\n  getExtensionDiagnostics,\n  type ExtensionLoaderCache,\n  type ExtensionDiagnostics,\n} from './diagnostics.js';\n\nconst EXTENSION_MANIFEST_FILE = 'xopc.extension.json';\n\nconst log = createLogger('ExtensionLoader');\n\nconst DEFAULT_EXTENSION_LOAD_CONCURRENCY = 4;\n\nasync function mapWithConcurrency<T>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T) => Promise<void>,\n): Promise<void> {\n  if (items.length === 0) {\n    return;\n  }\n  const queue = [...items];\n  const workerCount = Math.min(Math.max(1, concurrency), queue.length);\n  await Promise.all(\n    Array.from({ length: workerCount }, async () => {\n      while (queue.length > 0) {\n        const item = queue.shift();\n        if (item === undefined) {\n          break;\n        }\n        await fn(item);\n      }\n    }),\n  );\n}\n\nexport type { ExtensionLoaderOptions, ExtensionSourceOrigin } from './discover-extensions.js';\nexport { areExtensionsGloballyDisabled } from './discover-extensions.js';\n\n// ============================================================================\n// Extension Registry\n// ============================================================================\n\n// `ExtensionRegistryImpl` moved to `./extension-registry-impl.ts` so `api.ts`\n// can use the class without going through loader.ts (which imports back from\n// api.ts and formed a circular cycle). Re-exported here for backward-compat.\nexport { ExtensionRegistryImpl } from './extension-registry-impl.js';\nimport { ExtensionRegistryImpl } from './extension-registry-impl.js';\n\n// ============================================================================\n// Extension Loader\n// ============================================================================\n\nexport interface ActivationPlanLoadOptions extends Partial<ActivationContext> {\n  phase?: ActivationLoadPhase | 'all';\n}\n\nexport class ExtensionLoader {\n  private registry: ExtensionRegistryImpl;\n  private options: ExtensionLoaderOptions;\n  private extensionInstances: Map<string, ExtensionApi> = new Map();\n  private jiti: ReturnType<typeof createJiti>;\n  private _appConfig?: Config;\n  private _runtimeContext?: {\n    bus?: MessageBus;\n    sessionManager?: SessionIndex;\n    scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;\n    setLabel?: (entryId: string, label: string | undefined) => void;\n    sendUserMessage?: import('./types/index.js').ExtensionRuntime['sendUserMessage'];\n    appendEntry?: import('./types/index.js').ExtensionRuntime['appendEntry'];\n    sendMessage?: import('./types/index.js').ExtensionRuntime['sendMessage'];\n  };\n  \n  //  Security\n  private securityConfig: SecurityConfig;\n  \n  //  Provider Registry\n  private providerRegistry: ProviderPluginRegistry;\n  \n  //  Slot Registry & Config\n  private slotRegistry: SlotRegistry;\n  private slotsConfig: Partial<Record<SlotKey, string>> = {};\n  \n  //  Cache and Diagnostics\n  private cache: ExtensionLoaderCache;\n  private diagnostics: ExtensionDiagnostics;\n\n  /** Manifest-only registry cache (no runtime module load). */\n  private manifestRegistry: ManifestRegistry | null = null;\n  private manifestSnapshot: ExtensionMetadataSnapshot | null = null;\n\n  constructor(options?: ExtensionLoaderOptions) {\n    this.registry = new ExtensionRegistryImpl();\n    this.options = options || (() => {\n      const c = loadConfig();\n      const aid = resolveDefaultAgentId(c);\n      return {\n        workspaceDir: resolveAgentWorkspaceDir(c, aid),\n        extensionsDir: resolveWorkspaceExtensionsDir(c, aid),\n      };\n    })();\n\n    // Initialize security config\n    this.securityConfig = DEFAULT_SECURITY_CONFIG;\n    \n    // Initialize provider registry\n    this.providerRegistry = getProviderRegistry();\n    \n    // Initialize slot registry\n    this.slotRegistry = getSlotRegistry();\n    \n    // Initialize cache and diagnostics \n    this.cache = getExtensionCache();\n    this.diagnostics = getExtensionDiagnostics();\n\n    // Build jiti aliases for the public, host-provided extension SDK contract.\n    // Extensions must import from @xopcai/xopc/extension-sdk; private aliases\n    // are intentionally not registered.\n    const alias: Record<string, string> = {};\n    const sdkPath = resolveExtensionSdkPath();\n    if (sdkPath) {\n      const sdkDir = dirname(sdkPath);\n      const sdkSubpaths = [\n        'core',\n        'lazy',\n        'provider',\n        'channel',\n        'hooks',\n        'tools',\n        'testing',\n        'speech',\n        'media',\n      ];\n      const prefix = '@xopcai/xopc/extension-sdk';\n      alias[prefix] = sdkPath;\n      for (const subpath of sdkSubpaths) {\n        alias[`${prefix}/${subpath}`] = join(sdkDir, `${subpath}.ts`);\n      }\n    }\n\n    // Initialize jiti with TypeScript support and SDK alias\n    this.jiti = createJiti(fileURLToPath(import.meta.url), {\n      interopDefault: true,\n      extensions: ['.ts', '.tsx', '.mts', '.cts', '.js', '.mjs', '.cjs', '.json'],\n      alias,\n    });\n  }\n\n  /**\n   * Reuse a pre-built metadata snapshot (avoids duplicate filesystem discovery).\n   */\n  setManifestSnapshot(snapshot: ExtensionMetadataSnapshot | null): void {\n    this.manifestSnapshot = snapshot;\n    this.manifestRegistry = snapshot?.manifestRegistry ?? null;\n  }\n\n  getManifestSnapshot(): ExtensionMetadataSnapshot | null {\n    return this.manifestSnapshot;\n  }\n\n  /**\n   * Set security configuration \n   */\n  setSecurityConfig(config: Partial<SecurityConfig>): void {\n    this.securityConfig = { ...this.securityConfig, ...config };\n  }\n\n  /**\n   * Get security configuration \n   */\n  getSecurityConfig(): SecurityConfig {\n    return this.securityConfig;\n  }\n\n  /**\n   * Get provider registry \n   */\n  getProviderRegistry(): ProviderPluginRegistry {\n    return this.providerRegistry;\n  }\n\n  /**\n   * Get slot registry \n   */\n  getSlotRegistry(): SlotRegistry {\n    return this.slotRegistry;\n  }\n\n  /**\n   * Get diagnostics \n   */\n  getDiagnostics(): ExtensionDiagnostics {\n    return this.diagnostics;\n  }\n\n  /**\n   * Set configuration from main Config object \n   */\n  setConfig(config: Config): void {\n    this._appConfig = config;\n    // Wire slot config\n    const slots = (config.extensions as any)?.slots || {};\n    this.slotsConfig = {\n      memory: slots.memory,\n      tts: slots.tts,\n      imageGeneration: slots.imageGeneration,\n      webSearch: slots.webSearch,\n    };\n\n    // Wire security config\n    const security = (config.extensions as any)?.security;\n    if (security) {\n      this.securityConfig = {\n        checkPermissions: security.checkPermissions ?? true,\n        allowUntrusted: security.allowUntrusted ?? false,\n        allow: security.allow ?? [],\n        trackProvenance: security.trackProvenance ?? true,\n        allowPromptInjection: security.allowPromptInjection ?? false,\n      };\n    }\n  }\n\n  /**\n   * Inject MessageBus and optional SessionManager for ExtensionApi.runtime (Gateway).\n   */\n  setRuntimeContext(ctx: {\n    bus?: MessageBus;\n    sessionManager?: SessionIndex;\n    scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;\n    setLabel?: (entryId: string, label: string | undefined) => void;\n    sendUserMessage?: import('./types/index.js').ExtensionRuntime['sendUserMessage'];\n    appendEntry?: import('./types/index.js').ExtensionRuntime['appendEntry'];\n    sendMessage?: import('./types/index.js').ExtensionRuntime['sendMessage'];\n  }): void {\n    this._runtimeContext = ctx;\n    // ExtensionApi snapshots `runtime` at construction and is tied to this loader's registry.\n    // CLI startup loads extensions with `{ bus }` first; a global cache hit would reuse that\n    // api for the gateway loader (no sessionManager, wrong registry) — breaks extensions that need SessionManager.\n    this.cache.invalidate();\n  }\n\n  getRegistry(): ExtensionRegistryImpl {\n    return this.registry;\n  }\n\n  /**\n   * Phase 1: build manifest registry (filesystem manifests only, no extension code load).\n   */\n  buildManifestRegistry(): ManifestRegistry {\n    if (this.manifestRegistry) {\n      return this.manifestRegistry;\n    }\n    const discovered = this.discoverExtensions();\n    this.manifestRegistry = ManifestRegistry.fromDiscovered(discovered);\n    return this.manifestRegistry;\n  }\n\n  /**\n   * Phase 2: activation planner over the manifest registry (pure logic).\n   */\n  planActivation(_context?: Partial<ActivationContext>): ActivationPlanner {\n    return new ActivationPlanner(this.buildManifestRegistry());\n  }\n\n  /**\n   * Phase 3: load only extensions selected by the activation plan.\n   */\n  async loadByActivationPlan(context?: ActivationPlanLoadOptions): Promise<void> {\n    if (areExtensionsGloballyDisabled(this._appConfig as DiscoverConfig | undefined)) {\n      log.debug('Extension loading skipped (extensions globally disabled)');\n      return;\n    }\n\n    const registry = this.buildManifestRegistry();\n    const planner = new ActivationPlanner(registry);\n    const fullContext = mergeActivationContext(this._appConfig, context);\n    let activatedIds = planner.getActivatedIds(fullContext).sort((a, b) => a.localeCompare(b));\n\n    const phase = context?.phase ?? 'all';\n    if (phase === 'startup' || phase === 'deferred') {\n      activatedIds = planner.filterActivatedIdsByLoadPhase(activatedIds, phase);\n    }\n\n    const concurrency = Number.parseInt(\n      process.env.XOPC_EXTENSION_LOAD_CONCURRENCY ?? '',\n      10,\n    );\n    const loadConcurrency = Number.isFinite(concurrency) && concurrency > 0\n      ? concurrency\n      : DEFAULT_EXTENSION_LOAD_CONCURRENCY;\n\n    await mapWithConcurrency(activatedIds, loadConcurrency, async (extensionId) => {\n      if (this.extensionInstances.has(extensionId)) {\n        return;\n      }\n      const entry = registry.getEntry(extensionId);\n      if (!entry) {\n        log.debug(\n          { extensionId },\n          'Activation plan references extension id that was not discovered on disk',\n        );\n        return;\n      }\n\n      const config: ResolvedExtensionConfig = {\n        id: extensionId,\n        name: entry.manifest.name || extensionId,\n        source: entry.source,\n        path: entry.path,\n        enabled: true,\n        config: this.resolveExtensionConfig(extensionId),\n      };\n\n      await this.loadExtension(config);\n    });\n  }\n\n  getManifestRegistry(): ManifestRegistry {\n    return this.buildManifestRegistry();\n  }\n\n  invalidateManifestCache(): void {\n    this.manifestRegistry = this.manifestSnapshot?.manifestRegistry ?? null;\n  }\n\n  private resolveExtensionConfig(extensionId: string): Record<string, unknown> {\n    if (!this._appConfig) return {};\n    const extensionsConfig = (this._appConfig as Record<string, unknown>).extensions as\n      | Record<string, unknown>\n      | undefined;\n    if (!extensionsConfig || typeof extensionsConfig !== 'object') return {};\n    const raw = extensionsConfig[extensionId];\n    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n      return raw as Record<string, unknown>;\n    }\n    return {};\n  }\n\n  /**\n   * Discover extensions from all three tiers:\n   * 1. Workspace (.extensions/) - highest priority\n   * 2. Global (~/.xopc/extensions/) - shared\n   * 3. Bundled (xopc/extensions/) - lowest priority\n   */\n  discoverExtensions(): DiscoveredExtension[] {\n    if (this.manifestSnapshot) {\n      return this.manifestSnapshot.discovered;\n    }\n    return discoverExtensionsFromDisk(this.options, this._appConfig as DiscoverConfig | undefined);\n  }\n\n  /**\n   * Load all discovered extensions\n   */\n  async loadAllExtensions(enabledIds?: string[]): Promise<void> {\n    const extensions = this.discoverExtensions();\n\n    for (const extension of extensions) {\n      // If enabledIds specified, only load those\n      if (enabledIds && !enabledIds.includes(extension.id)) {\n        continue;\n      }\n\n      const config: ResolvedExtensionConfig = {\n        id: extension.id,\n        name: extension.manifest.name || extension.id,\n        source: extension.source,\n        path: extension.path,\n        enabled: true,\n        config: {},\n      };\n\n      await this.loadExtension(config);\n    }\n  }\n\n  async loadExtensions(configs: ResolvedExtensionConfig[]): Promise<void> {\n    for (const extensionConfig of configs) {\n      if (extensionConfig.enabled) {\n        await this.loadExtension(extensionConfig);\n      }\n    }\n  }\n\n  async loadExtension(config: ResolvedExtensionConfig): Promise<ExtensionApi | null> {\n    try {\n      //  Check cache first\n      const cacheKey = this.cache.buildKey(this.options, [config.id]);\n      const cached = this.cache.get<ExtensionApi>(cacheKey);\n      if (cached) {\n        log.debug({ extensionId: config.id }, 'Extension loaded from cache');\n        return cached;\n      }\n\n      // Check if already loaded\n      if (this.extensionInstances.has(config.id)) {\n        return this.extensionInstances.get(config.id)!;\n      }\n\n      // Resolve extension path using resolveExtensionPath\n      let extensionPath: string | null;\n      if (isAbsolute(config.path)) {\n        extensionPath = config.path;\n      } else {\n        // Try to resolve extension ID to actual path\n        extensionPath = resolveExtensionPath(config.path, this.options) ||\n                     resolveExtensionPath(config.id, this.options);\n      }\n      \n      if (!extensionPath) {\n        log.error({ extensionId: config.id, path: config.path }, `Could not resolve extension path`);\n        this.diagnostics.error(config.id, `Could not resolve extension path: ${config.path}`);\n        return null;\n      }\n\n      log.debug({ extensionId: config.id, extensionPath }, 'Resolved extension path');\n\n      //  Security check\n      const source = config.source || 'bundled';\n      const safetyResult = checkExtensionPathSafety(extensionPath, extensionPath, source);\n      \n      if (!safetyResult.safe) {\n        logSecurityIssue(config.id, safetyResult);\n        \n        if (this.securityConfig.checkPermissions && source !== 'bundled') {\n          // Check allowlist\n          if (!isExtensionAllowed(config.id, this.securityConfig)) {\n            this.diagnostics.error(config.id, `Extension not allowed: ${safetyResult.detail}`);\n            log.error({ extensionId: config.id, reason: safetyResult.reason }, 'Extension blocked by security policy');\n            return null;\n          }\n        }\n      }\n\n      // Track provenance \n      provenanceTracker.track(config.id, source);\n\n      const manifest = this.loadManifest(extensionPath);\n      if (!manifest) {\n        log.error({ extensionId: config.id, extensionPath }, `Failed to load manifest for extension`);\n        this.diagnostics.error(config.id, `Failed to load manifest`);\n        return null;\n      }\n\n      if (!manifest.main || !/\\.(js|mjs|cjs)$/i.test(manifest.main)) {\n        const reason = `Extension manifest main must point at built JavaScript (.js/.mjs/.cjs): ${manifest.main ?? '(missing)'}`;\n        log.warn({ extensionId: config.id, main: manifest.main }, reason);\n        this.diagnostics.error(config.id, reason);\n        return null;\n      }\n\n      if (!manifest.engines?.xopc) {\n        const reason = 'Extension manifest must declare engines.xopc';\n        log.warn({ extensionId: config.id }, reason);\n        this.diagnostics.error(config.id, reason);\n        return null;\n      }\n      const range = manifest.engines.xopc;\n      const engineResult = checkEngineCompatibility(PACKAGE_VERSION, range);\n      if (engineResult.parseWarning) {\n        const reason = engineResult.reason ?? `Could not parse engines.xopc: ${range}`;\n        log.warn({ extensionId: config.id, range, reason }, 'Extension engine range parse failure — skipping load');\n        this.diagnostics.error(config.id, reason);\n        return null;\n      }\n      if (!engineResult.compatible) {\n        log.warn(\n          { extensionId: config.id, range, currentVersion: PACKAGE_VERSION },\n          'Extension engine requirement not met (engines.xopc) — skipping load',\n        );\n        this.diagnostics.error(\n          config.id,\n          engineResult.reason ?? 'Incompatible xopc version (engines.xopc)',\n        );\n        return null;\n      }\n\n      // Validate extension config against schema (basic validation)\n      if (manifest.configSchema) {\n        try {\n          const schema = manifest.configSchema as Record<string, unknown>;\n          const extensionConfig = config.config as Record<string, unknown>;\n          \n          // Basic validation: check required fields and types\n          if (schema.type === 'object' && schema.properties) {\n            const props = schema.properties as Record<string, Record<string, unknown>>;\n            const required = (schema.required as string[]) || [];\n            \n            for (const field of required) {\n              if (extensionConfig[field] === undefined) {\n                log.error({ \n                  extensionId: config.id, \n                  field \n                }, 'Extension config validation failed: missing required field');\n                return null;\n              }\n            }\n            \n            for (const [key, value] of Object.entries(extensionConfig)) {\n              const propSchema = props[key];\n              if (propSchema) {\n                if (propSchema.type && !this.validateType(value, propSchema.type as string)) {\n                  log.error({ \n                    extensionId: config.id, \n                    field: key,\n                    expected: propSchema.type,\n                    actual: typeof value\n                  }, 'Extension config validation failed: type mismatch');\n                  return null;\n                }\n              }\n            }\n          }\n          \n          log.debug({ extensionId: config.id }, 'Extension config validated');\n        } catch (err) {\n          log.warn({ err, extensionId: config.id }, 'Config schema validation skipped');\n        }\n      }\n\n      // Create extension API\n      const extensionDir = dirname(extensionPath);\n      const api = this.createExtensionApi(manifest, config, extensionDir);\n\n      // Load extension module\n      const module = await this.loadModule(extensionPath, manifest);\n      if (!module) {\n        log.error({ extensionId: config.id }, `Failed to load module for extension`);\n        this.diagnostics.error(config.id, `Failed to load module`);\n        return null;\n      }\n\n      //  Check and claim slots\n      const slotClaimed = this.claimExtensionSlots(config.id, manifest);\n      if (!slotClaimed) {\n        log.warn({ extensionId: config.id }, 'Failed to claim required slots');\n      }\n\n      // Initialize extension\n      await this.initializeExtension(module, api, manifest);\n\n      validateSpeechProviderContracts({\n        extensionId: config.id,\n        manifest,\n        registeredProviderIds: (api as ExtensionApiImpl).getRegisteredSpeechProviderIds(),\n        logger: api.logger,\n      });\n\n      validateMediaUnderstandingProviderContracts({\n        extensionId: config.id,\n        manifest,\n        registeredProviderIds: (api as ExtensionApiImpl).getRegisteredMediaUnderstandingProviderIds(),\n        logger: api.logger,\n      });\n\n      // Register to registry\n      this.registry.addExtension({\n        id: config.id,\n        name: manifest.name,\n        version: manifest.version,\n        path: extensionPath,\n        module,\n        config: config.config,\n        enabled: true,\n        source: config.source,\n      });\n\n      // Register extension tools to registry (so AgentManager can access them)\n      // Note: api is actually ExtensionApiImpl at runtime\n      const apiImpl = api as unknown as { _getTools: () => Map<string, AgentTool> };\n      const extensionTools = apiImpl._getTools();\n      for (const tool of extensionTools.values()) {\n        this.registry.addTool(tool);\n      }\n\n      this.extensionInstances.set(config.id, api);\n      \n      //  Cache the loaded extension\n      this.cache.set(cacheKey, api);\n\n      this.diagnostics.info(config.id, `Loaded extension: ${manifest.name}`);\n      log.info({ name: manifest.name, id: manifest.id, source: config.source }, `Loaded extension`);\n\n      return api;\n    } catch (error) {\n      log.error({ err: error, extensionId: config.id }, `Error loading extension`);\n      this.diagnostics.error(config.id, `Error loading extension: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   *  Claim extension slots based on manifest kind\n   * Respects configured preferred plugin from config.extensions.slots\n   */\n  private claimExtensionSlots(extensionId: string, manifest: ExtensionManifest): boolean {\n    const kind = manifest.kind as string;\n    \n    // Map extension kind to slot\n    const slotMap: Record<string, SlotKey> = {\n      'memory': 'memory',\n      'tts': 'tts',\n      'speech-provider': 'tts',\n      'web-search': 'webSearch',\n    };\n    \n    const slotKey = slotMap[kind];\n    if (!slotKey) {\n      return true; // No slot required\n    }\n    \n    // Check if slot is reserved for a different plugin in config\n    const preferredPlugin = this.slotsConfig[slotKey];\n    if (preferredPlugin && preferredPlugin !== extensionId) {\n      log.info(\n        { extensionId, slotKey, preferredPlugin },\n        `Skipping slot claim: slot \"${slotKey}\" is reserved for \"${preferredPlugin}\"`\n      );\n      this.diagnostics.info(\n        extensionId,\n        `Slot \"${slotKey}\" is reserved for \"${preferredPlugin}\", skipping claim`\n      );\n      return false;\n    }\n    \n    const claimed = this.slotRegistry.claim(slotKey, extensionId, null);\n    if (!claimed) {\n      this.diagnostics.warn(extensionId, `Slot \"${slotKey}\" already claimed by another extension`);\n    }\n    return claimed;\n  }\n\n  loadManifest(extensionPath: string): ExtensionManifest | null {\n    const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n    // First try to load xopc.extension.json\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    return null;\n  }\n\n  private moduleEntryCandidates(manifest: ExtensionManifest): string[] {\n    if (!manifest.main) return [];\n    return [manifest.main];\n  }\n\n  private async loadModule(\n    extensionPath: string,\n    manifest: ExtensionManifest,\n  ): Promise<ExtensionModule | null> {\n    const entryPoints = this.moduleEntryCandidates(manifest);\n\n    for (const entry of entryPoints) {\n      const fullPath = isAbsolute(entry) ? entry : join(extensionPath, entry);\n\n      if (existsSync(fullPath)) {\n        try {\n          if (!/\\.(js|mjs|cjs)$/.test(fullPath)) {\n            throw new Error(`Extension runtime entry must be built JavaScript: ${entry}`);\n          }\n          const mod = await import(pathToFileURL(fullPath).href);\n          return mod.default || mod;\n        } catch (error) {\n          log.warn({ err: error, path: fullPath }, `Failed to load module`);\n        }\n      }\n    }\n\n    return null;\n  }\n\n  private createExtensionApi(\n    manifest: ExtensionManifest,\n    resolved: ResolvedExtensionConfig,\n    extensionDir: string,\n  ): ExtensionApi {\n    const logger = createExtensionLogger(`[${manifest.id}]`);\n    const resolvePath = createPathResolver(extensionDir, this.options.workspaceDir || '');\n\n    const appConfig = this._appConfig ?? ({} as Config);\n    const extensionOnly = (resolved.config ?? {}) as Record<string, unknown>;\n\n    const runtime =\n      this._appConfig && this._runtimeContext\n        ? {\n            config: this._appConfig,\n            bus: this._runtimeContext.bus,\n            log: logger,\n            sessionManager: this._runtimeContext.sessionManager,\n            scheduleWebchatContinuation: this._runtimeContext.scheduleWebchatContinuation,\n            setLabel: this._runtimeContext.setLabel,\n            sendUserMessage: this._runtimeContext.sendUserMessage,\n            appendEntry: this._runtimeContext.appendEntry,\n            sendMessage: this._runtimeContext.sendMessage,\n          }\n        : this._appConfig\n          ? {\n              config: this._appConfig,\n              log: logger,\n            }\n          : undefined;\n\n    const api = new ExtensionApiImpl(\n      manifest.id,\n      manifest.name,\n      manifest.version,\n      extensionDir,\n      appConfig,\n      extensionOnly,\n      logger,\n      resolvePath,\n      this.registry,\n      manifest.contracts ?? {},\n      runtime,\n    );\n    if (manifest.reload?.configPrefixes?.length) {\n      api._setReloadConfigPrefixes(manifest.reload.configPrefixes);\n    }\n    const manifestCommands = manifest.ui?.contributions?.commands;\n    if (manifestCommands?.length) {\n      (api as ExtensionApiImpl)._setManifestCommands(manifestCommands);\n    }\n    return api;\n  }\n\n  private async initializeExtension(\n    module: ExtensionModule,\n    api: ExtensionApi,\n    _manifest: ExtensionManifest,\n  ): Promise<void> {\n    if (typeof module === 'function') {\n      // Module is a function that receives the API\n      await module(api);\n    } else if (typeof module === 'object' && module.register) {\n      // Module is a ExtensionDefinition with register method\n      await module.register(api);\n    }\n  }\n\n  async startServices(): Promise<void> {\n    const services = Array.from(this.registry.services.values());\n\n    for (const service of services) {\n      const serviceLog = createServiceLogger(service.id);\n      try {\n        await service.start?.();\n        serviceLog.info(`Started service`);\n      } catch (error) {\n        serviceLog.error({ err: error }, `Failed to start service`);\n      }\n    }\n  }\n\n  async stopServices(): Promise<void> {\n    const services = Array.from(this.registry.services.values()).reverse();\n\n    for (const service of services) {\n      if (service.stop) {\n        const serviceLog = createServiceLogger(service.id);\n        try {\n          await service.stop();\n          serviceLog.info(`Stopped service`);\n        } catch (error) {\n          serviceLog.error({ err: error }, `Failed to stop service`);\n        }\n      }\n    }\n  }\n\n  /**\n   * Basic type validation for config values\n   */\n  private validateType(value: unknown, expectedType: string): boolean {\n    if (expectedType === 'string') return typeof value === 'string';\n    if (expectedType === 'number' || expectedType === 'integer') return typeof value === 'number';\n    if (expectedType === 'boolean') return typeof value === 'boolean';\n    if (expectedType === 'array') return Array.isArray(value);\n    if (expectedType === 'object') return typeof value === 'object' && value !== null && !Array.isArray(value);\n    return true;\n  }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nexport function resolveExtensionPath(id: string, _options: ExtensionLoaderOptions): string | null {\n  const c = loadConfig();\n  const aid = resolveDefaultAgentId(c);\n  // Priority 1: Workspace\n  const workspacePath = join(resolveWorkspaceExtensionsDir(c, aid), id);\n  if (existsSync(workspacePath)) return workspacePath;\n\n  // Priority 2: Global\n  const globalPath = join(resolveExtensionsDir(), id);\n  if (existsSync(globalPath)) return globalPath;\n\n  // Priority 3: Bundled\n  const bundledDir = resolveBundledExtensionsDir();\n  if (bundledDir) {\n    const bundledPath = join(bundledDir, id);\n    if (existsSync(bundledPath)) return bundledPath;\n  }\n\n  return null;\n}\n\nexport function normalizeExtensionConfig(\n  rawConfig: Record<string, unknown>,\n): ResolvedExtensionConfig[] {\n  const extensions: ResolvedExtensionConfig[] = [];\n\n  const enabled = (rawConfig.enabled as string[]) || [];\n  const disabled = (rawConfig.disabled as string[]) || [];\n\n  // Parse enabled extensions\n  for (const id of enabled) {\n    const config = (rawConfig[id] as Record<string, unknown>) || {};\n    extensions.push({\n      id,\n      name: id,\n      source: 'config',\n      path: id,\n      enabled: true,\n      config,\n    });\n  }\n\n  // Parse disabled extensions\n  for (const id of disabled) {\n    if (!extensions.find((p) => p.id === id)) {\n      const config = (rawConfig[id] as Record<string, unknown>) || {};\n      extensions.push({\n        id,\n        name: id,\n        source: 'config',\n        path: id,\n        enabled: false,\n        config,\n      });\n    }\n  }\n\n  return extensions;\n}\n"],"mappings":"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"}
+{"version":3,"file":"loader.js","names":["apiImpl"],"sources":["../../../src/extensions/loader.ts"],"sourcesContent":["/**\n * Extension Loader and Registry\n * \n * Supports three-tier extension storage:\n * 1. Workspace level (workspace/.extensions/) - highest priority\n * 2. Global level (~/.xopc/extensions/) - shared across workspaces\n * 3. Bundled level (xopc/extensions/) - shipped with xopc\n */\n\nimport { existsSync, readFileSync } from 'fs';\nimport { join, dirname, isAbsolute } from 'path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\nimport { createJiti } from 'jiti';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport { loadConfig } from '../config/loader.js';\nimport {\n  resolveAgentWorkspaceDir,\n  resolveExtensionsDir,\n  resolveWorkspaceExtensionsDir,\n  resolveBundledExtensionsDir,\n  resolveExtensionSdkPath,\n} from '../config/paths.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionIndex } from '../session/manager.js';\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type {\n  ExtensionApi,\n  ExtensionModule,\n  ExtensionManifest,\n  ResolvedExtensionConfig,\n  DiscoveredExtension,\n} from './types/index.js';\nimport type { ActivationContext } from './activation-planner.js';\nimport { ActivationPlanner, type ActivationLoadPhase } from './activation-planner.js';\nimport { mergeActivationContext } from './activation-context.js';\nimport {\n  areExtensionsGloballyDisabled,\n  discoverExtensionsFromDisk,\n  type DiscoverConfig,\n  type ExtensionLoaderOptions,\n} from './discover-extensions.js';\nimport type { ExtensionMetadataSnapshot } from './extension-metadata-snapshot.js';\nimport { ManifestRegistry } from './manifest-registry.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport { checkEngineCompatibility } from './engine-check.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport { ExtensionApiImpl, createExtensionLogger, createPathResolver } from './api.js';\nimport { validateSpeechProviderContracts } from './speech-provider-contracts.js';\nimport { validateMediaUnderstandingProviderContracts } from './media-provider-contracts.js';\nimport { createLogger, createServiceLogger } from '../utils/logger.js';\n\n//  Security imports\nimport {\n  checkExtensionPathSafety,\n  isExtensionAllowed,\n  provenanceTracker,\n  logSecurityIssue,\n  DEFAULT_SECURITY_CONFIG,\n  type SecurityConfig,\n  // Note: ExtensionSourceOrigin is defined locally in this file\n} from './security.js';\n\n//  Provider imports\nimport { getProviderRegistry, type ProviderPluginRegistry } from '../providers/plugin-registry.js';\n\n//  Slot imports\nimport {\n  getSlotRegistry,\n  type SlotRegistry,\n  type SlotKey,\n} from './slots.js';\n\n//  Diagnostics imports\nimport {\n  getExtensionCache,\n  getExtensionDiagnostics,\n  type ExtensionLoaderCache,\n  type ExtensionDiagnostics,\n} from './diagnostics.js';\n\nconst EXTENSION_MANIFEST_FILE = 'xopc.extension.json';\n\nconst log = createLogger('ExtensionLoader');\n\nconst DEFAULT_EXTENSION_LOAD_CONCURRENCY = 4;\n\nasync function mapWithConcurrency<T>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T) => Promise<void>,\n): Promise<void> {\n  if (items.length === 0) {\n    return;\n  }\n  const queue = [...items];\n  const workerCount = Math.min(Math.max(1, concurrency), queue.length);\n  await Promise.all(\n    Array.from({ length: workerCount }, async () => {\n      while (queue.length > 0) {\n        const item = queue.shift();\n        if (item === undefined) {\n          break;\n        }\n        await fn(item);\n      }\n    }),\n  );\n}\n\nexport type { ExtensionLoaderOptions, ExtensionSourceOrigin } from './discover-extensions.js';\nexport { areExtensionsGloballyDisabled } from './discover-extensions.js';\n\n// ============================================================================\n// Extension Registry\n// ============================================================================\n\n// `ExtensionRegistryImpl` moved to `./extension-registry-impl.ts` so `api.ts`\n// can use the class without going through loader.ts (which imports back from\n// api.ts and formed a circular cycle). Re-exported here for backward-compat.\nexport { ExtensionRegistryImpl } from './extension-registry-impl.js';\nimport { ExtensionRegistryImpl } from './extension-registry-impl.js';\n\n// ============================================================================\n// Extension Loader\n// ============================================================================\n\nexport interface ActivationPlanLoadOptions extends Partial<ActivationContext> {\n  phase?: ActivationLoadPhase | 'all';\n}\n\nexport class ExtensionLoader {\n  private registry: ExtensionRegistryImpl;\n  private options: ExtensionLoaderOptions;\n  private extensionInstances: Map<string, ExtensionApi> = new Map();\n  private jiti: ReturnType<typeof createJiti>;\n  private _appConfig?: Config;\n  private _runtimeContext?: {\n    bus?: MessageBus;\n    sessionManager?: SessionIndex;\n    scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;\n    setLabel?: (entryId: string, label: string | undefined) => void;\n    sendUserMessage?: import('./types/index.js').ExtensionRuntime['sendUserMessage'];\n    appendEntry?: import('./types/index.js').ExtensionRuntime['appendEntry'];\n    sendMessage?: import('./types/index.js').ExtensionRuntime['sendMessage'];\n  };\n  \n  //  Security\n  private securityConfig: SecurityConfig;\n  \n  //  Provider Registry\n  private providerRegistry: ProviderPluginRegistry;\n  \n  //  Slot Registry & Config\n  private slotRegistry: SlotRegistry;\n  private slotsConfig: Partial<Record<SlotKey, string>> = {};\n  \n  //  Cache and Diagnostics\n  private cache: ExtensionLoaderCache;\n  private diagnostics: ExtensionDiagnostics;\n\n  /** Manifest-only registry cache (no runtime module load). */\n  private manifestRegistry: ManifestRegistry | null = null;\n  private manifestSnapshot: ExtensionMetadataSnapshot | null = null;\n\n  constructor(options?: ExtensionLoaderOptions) {\n    this.registry = new ExtensionRegistryImpl();\n    this.options = options || (() => {\n      const c = loadConfig();\n      const aid = resolveDefaultAgentId(c);\n      return {\n        workspaceDir: resolveAgentWorkspaceDir(c, aid),\n        extensionsDir: resolveWorkspaceExtensionsDir(c, aid),\n      };\n    })();\n\n    // Initialize security config\n    this.securityConfig = DEFAULT_SECURITY_CONFIG;\n    \n    // Initialize provider registry\n    this.providerRegistry = getProviderRegistry();\n    \n    // Initialize slot registry\n    this.slotRegistry = getSlotRegistry();\n    \n    // Initialize cache and diagnostics \n    this.cache = getExtensionCache();\n    this.diagnostics = getExtensionDiagnostics();\n\n    // Build jiti aliases for the public, host-provided extension SDK contract.\n    // Extensions must import from @xopcai/xopc/extension-sdk; private aliases\n    // are intentionally not registered.\n    const alias: Record<string, string> = {};\n    const sdkPath = resolveExtensionSdkPath();\n    if (sdkPath) {\n      const sdkDir = dirname(sdkPath);\n      const sdkSubpaths = [\n        'core',\n        'lazy',\n        'provider',\n        'channel',\n        'hooks',\n        'tools',\n        'testing',\n        'speech',\n        'media',\n      ];\n      const prefix = '@xopcai/xopc/extension-sdk';\n      alias[prefix] = sdkPath;\n      for (const subpath of sdkSubpaths) {\n        alias[`${prefix}/${subpath}`] = join(sdkDir, `${subpath}.ts`);\n      }\n    }\n\n    // Initialize jiti with TypeScript support and SDK alias\n    this.jiti = createJiti(fileURLToPath(import.meta.url), {\n      interopDefault: true,\n      extensions: ['.ts', '.tsx', '.mts', '.cts', '.js', '.mjs', '.cjs', '.json'],\n      alias,\n    });\n  }\n\n  /**\n   * Reuse a pre-built metadata snapshot (avoids duplicate filesystem discovery).\n   */\n  setManifestSnapshot(snapshot: ExtensionMetadataSnapshot | null): void {\n    this.manifestSnapshot = snapshot;\n    this.manifestRegistry = snapshot?.manifestRegistry ?? null;\n  }\n\n  getManifestSnapshot(): ExtensionMetadataSnapshot | null {\n    return this.manifestSnapshot;\n  }\n\n  /**\n   * Set security configuration \n   */\n  setSecurityConfig(config: Partial<SecurityConfig>): void {\n    this.securityConfig = { ...this.securityConfig, ...config };\n  }\n\n  /**\n   * Get security configuration \n   */\n  getSecurityConfig(): SecurityConfig {\n    return this.securityConfig;\n  }\n\n  /**\n   * Get provider registry \n   */\n  getProviderRegistry(): ProviderPluginRegistry {\n    return this.providerRegistry;\n  }\n\n  /**\n   * Get slot registry \n   */\n  getSlotRegistry(): SlotRegistry {\n    return this.slotRegistry;\n  }\n\n  /**\n   * Get diagnostics \n   */\n  getDiagnostics(): ExtensionDiagnostics {\n    return this.diagnostics;\n  }\n\n  /**\n   * Set configuration from main Config object \n   */\n  setConfig(config: Config): void {\n    this._appConfig = config;\n    // Wire slot config\n    const slots = (config.extensions as any)?.slots || {};\n    this.slotsConfig = {\n      memory: slots.memory,\n      tts: slots.tts,\n      imageGeneration: slots.imageGeneration,\n      webSearch: slots.webSearch,\n    };\n\n    // Wire security config\n    const security = (config.extensions as any)?.security;\n    if (security) {\n      this.securityConfig = {\n        checkPermissions: security.checkPermissions ?? true,\n        allowUntrusted: security.allowUntrusted ?? false,\n        allow: security.allow ?? [],\n        trackProvenance: security.trackProvenance ?? true,\n        allowPromptInjection: security.allowPromptInjection ?? false,\n      };\n    }\n  }\n\n  /**\n   * Inject MessageBus and optional SessionManager for ExtensionApi.runtime (Gateway).\n   */\n  setRuntimeContext(ctx: {\n    bus?: MessageBus;\n    sessionManager?: SessionIndex;\n    scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;\n    setLabel?: (entryId: string, label: string | undefined) => void;\n    sendUserMessage?: import('./types/index.js').ExtensionRuntime['sendUserMessage'];\n    appendEntry?: import('./types/index.js').ExtensionRuntime['appendEntry'];\n    sendMessage?: import('./types/index.js').ExtensionRuntime['sendMessage'];\n  }): void {\n    this._runtimeContext = ctx;\n    // ExtensionApi snapshots `runtime` at construction and is tied to this loader's registry.\n    // CLI startup loads extensions with `{ bus }` first; a global cache hit would reuse that\n    // api for the gateway loader (no sessionManager, wrong registry) — breaks extensions that need SessionManager.\n    this.cache.invalidate();\n  }\n\n  getRegistry(): ExtensionRegistryImpl {\n    return this.registry;\n  }\n\n  /**\n   * Build the manifest registry from filesystem manifests without loading extension code.\n   */\n  buildManifestRegistry(): ManifestRegistry {\n    if (this.manifestRegistry) {\n      return this.manifestRegistry;\n    }\n    const discovered = this.discoverExtensions();\n    this.manifestRegistry = ManifestRegistry.fromDiscovered(discovered);\n    return this.manifestRegistry;\n  }\n\n  /**\n   * Plan activation from manifest metadata with pure logic.\n   */\n  planActivation(_context?: Partial<ActivationContext>): ActivationPlanner {\n    return new ActivationPlanner(this.buildManifestRegistry());\n  }\n\n  /**\n   * Load only extensions selected by the activation plan.\n   */\n  async loadByActivationPlan(context?: ActivationPlanLoadOptions): Promise<void> {\n    if (areExtensionsGloballyDisabled(this._appConfig as DiscoverConfig | undefined)) {\n      log.debug('Extension loading skipped (extensions globally disabled)');\n      return;\n    }\n\n    const registry = this.buildManifestRegistry();\n    const planner = new ActivationPlanner(registry);\n    const fullContext = mergeActivationContext(this._appConfig, context);\n    let activatedIds = planner.getActivatedIds(fullContext).sort((a, b) => a.localeCompare(b));\n\n    const phase = context?.phase ?? 'all';\n    if (phase === 'startup' || phase === 'deferred') {\n      activatedIds = planner.filterActivatedIdsByLoadPhase(activatedIds, phase);\n    }\n\n    const concurrency = Number.parseInt(\n      process.env.XOPC_EXTENSION_LOAD_CONCURRENCY ?? '',\n      10,\n    );\n    const loadConcurrency = Number.isFinite(concurrency) && concurrency > 0\n      ? concurrency\n      : DEFAULT_EXTENSION_LOAD_CONCURRENCY;\n\n    await mapWithConcurrency(activatedIds, loadConcurrency, async (extensionId) => {\n      if (this.extensionInstances.has(extensionId)) {\n        return;\n      }\n      const entry = registry.getEntry(extensionId);\n      if (!entry) {\n        log.debug(\n          { extensionId },\n          'Activation plan references extension id that was not discovered on disk',\n        );\n        return;\n      }\n\n      const config: ResolvedExtensionConfig = {\n        id: extensionId,\n        name: entry.manifest.name || extensionId,\n        source: entry.source,\n        path: entry.path,\n        enabled: true,\n        config: this.resolveExtensionConfig(extensionId),\n      };\n\n      await this.loadExtension(config);\n    });\n  }\n\n  getManifestRegistry(): ManifestRegistry {\n    return this.buildManifestRegistry();\n  }\n\n  invalidateManifestCache(): void {\n    this.manifestRegistry = this.manifestSnapshot?.manifestRegistry ?? null;\n  }\n\n  private resolveExtensionConfig(extensionId: string): Record<string, unknown> {\n    if (!this._appConfig) return {};\n    const extensionsConfig = (this._appConfig as Record<string, unknown>).extensions as\n      | Record<string, unknown>\n      | undefined;\n    if (!extensionsConfig || typeof extensionsConfig !== 'object') return {};\n    const raw = extensionsConfig[extensionId];\n    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n      return raw as Record<string, unknown>;\n    }\n    return {};\n  }\n\n  /**\n   * Discover extensions from all three tiers:\n   * 1. Workspace (.extensions/) - highest priority\n   * 2. Global (~/.xopc/extensions/) - shared\n   * 3. Bundled (xopc/extensions/) - lowest priority\n   */\n  discoverExtensions(): DiscoveredExtension[] {\n    if (this.manifestSnapshot) {\n      return this.manifestSnapshot.discovered;\n    }\n    return discoverExtensionsFromDisk(this.options, this._appConfig as DiscoverConfig | undefined);\n  }\n\n  /**\n   * Load all discovered extensions\n   */\n  async loadAllExtensions(enabledIds?: string[]): Promise<void> {\n    const extensions = this.discoverExtensions();\n\n    for (const extension of extensions) {\n      // If enabledIds specified, only load those\n      if (enabledIds && !enabledIds.includes(extension.id)) {\n        continue;\n      }\n\n      const config: ResolvedExtensionConfig = {\n        id: extension.id,\n        name: extension.manifest.name || extension.id,\n        source: extension.source,\n        path: extension.path,\n        enabled: true,\n        config: {},\n      };\n\n      await this.loadExtension(config);\n    }\n  }\n\n  async loadExtensions(configs: ResolvedExtensionConfig[]): Promise<void> {\n    for (const extensionConfig of configs) {\n      if (extensionConfig.enabled) {\n        await this.loadExtension(extensionConfig);\n      }\n    }\n  }\n\n  async loadExtension(config: ResolvedExtensionConfig): Promise<ExtensionApi | null> {\n    try {\n      //  Check cache first\n      const cacheKey = this.cache.buildKey(this.options, [config.id]);\n      const cached = this.cache.get<ExtensionApi>(cacheKey);\n      if (cached) {\n        log.debug({ extensionId: config.id }, 'Extension loaded from cache');\n        return cached;\n      }\n\n      // Check if already loaded\n      if (this.extensionInstances.has(config.id)) {\n        return this.extensionInstances.get(config.id)!;\n      }\n\n      // Resolve extension path using resolveExtensionPath\n      let extensionPath: string | null;\n      if (isAbsolute(config.path)) {\n        extensionPath = config.path;\n      } else {\n        // Try to resolve extension ID to actual path\n        extensionPath = resolveExtensionPath(config.path, this.options) ||\n                     resolveExtensionPath(config.id, this.options);\n      }\n      \n      if (!extensionPath) {\n        log.error({ extensionId: config.id, path: config.path }, `Could not resolve extension path`);\n        this.diagnostics.error(config.id, `Could not resolve extension path: ${config.path}`);\n        return null;\n      }\n\n      log.debug({ extensionId: config.id, extensionPath }, 'Resolved extension path');\n\n      //  Security check\n      const source = config.source || 'bundled';\n      const safetyResult = checkExtensionPathSafety(extensionPath, extensionPath, source);\n      \n      if (!safetyResult.safe) {\n        logSecurityIssue(config.id, safetyResult);\n        \n        if (this.securityConfig.checkPermissions && source !== 'bundled') {\n          // Check allowlist\n          if (!isExtensionAllowed(config.id, this.securityConfig)) {\n            this.diagnostics.error(config.id, `Extension not allowed: ${safetyResult.detail}`);\n            log.error({ extensionId: config.id, reason: safetyResult.reason }, 'Extension blocked by security policy');\n            return null;\n          }\n        }\n      }\n\n      // Track provenance \n      provenanceTracker.track(config.id, source);\n\n      const manifest = this.loadManifest(extensionPath);\n      if (!manifest) {\n        log.error({ extensionId: config.id, extensionPath }, `Failed to load manifest for extension`);\n        this.diagnostics.error(config.id, `Failed to load manifest`);\n        return null;\n      }\n\n      if (!manifest.main || !/\\.(js|mjs|cjs)$/i.test(manifest.main)) {\n        const reason = `Extension manifest main must point at built JavaScript (.js/.mjs/.cjs): ${manifest.main ?? '(missing)'}`;\n        log.warn({ extensionId: config.id, main: manifest.main }, reason);\n        this.diagnostics.error(config.id, reason);\n        return null;\n      }\n\n      if (!manifest.engines?.xopc) {\n        const reason = 'Extension manifest must declare engines.xopc';\n        log.warn({ extensionId: config.id }, reason);\n        this.diagnostics.error(config.id, reason);\n        return null;\n      }\n      const range = manifest.engines.xopc;\n      const engineResult = checkEngineCompatibility(PACKAGE_VERSION, range);\n      if (engineResult.parseWarning) {\n        const reason = engineResult.reason ?? `Could not parse engines.xopc: ${range}`;\n        log.warn({ extensionId: config.id, range, reason }, 'Extension engine range parse failure — skipping load');\n        this.diagnostics.error(config.id, reason);\n        return null;\n      }\n      if (!engineResult.compatible) {\n        log.warn(\n          { extensionId: config.id, range, currentVersion: PACKAGE_VERSION },\n          'Extension engine requirement not met (engines.xopc) — skipping load',\n        );\n        this.diagnostics.error(\n          config.id,\n          engineResult.reason ?? 'Incompatible xopc version (engines.xopc)',\n        );\n        return null;\n      }\n\n      // Validate extension config against schema (basic validation)\n      if (manifest.configSchema) {\n        try {\n          const schema = manifest.configSchema as Record<string, unknown>;\n          const extensionConfig = config.config as Record<string, unknown>;\n          \n          // Basic validation: check required fields and types\n          if (schema.type === 'object' && schema.properties) {\n            const props = schema.properties as Record<string, Record<string, unknown>>;\n            const required = (schema.required as string[]) || [];\n            \n            for (const field of required) {\n              if (extensionConfig[field] === undefined) {\n                log.error({ \n                  extensionId: config.id, \n                  field \n                }, 'Extension config validation failed: missing required field');\n                return null;\n              }\n            }\n            \n            for (const [key, value] of Object.entries(extensionConfig)) {\n              const propSchema = props[key];\n              if (propSchema) {\n                if (propSchema.type && !this.validateType(value, propSchema.type as string)) {\n                  log.error({ \n                    extensionId: config.id, \n                    field: key,\n                    expected: propSchema.type,\n                    actual: typeof value\n                  }, 'Extension config validation failed: type mismatch');\n                  return null;\n                }\n              }\n            }\n          }\n          \n          log.debug({ extensionId: config.id }, 'Extension config validated');\n        } catch (err) {\n          log.warn({ err, extensionId: config.id }, 'Config schema validation skipped');\n        }\n      }\n\n      // Create extension API\n      const extensionDir = dirname(extensionPath);\n      const api = this.createExtensionApi(manifest, config, extensionDir);\n\n      // Load extension module\n      const module = await this.loadModule(extensionPath, manifest);\n      if (!module) {\n        log.error({ extensionId: config.id }, `Failed to load module for extension`);\n        this.diagnostics.error(config.id, `Failed to load module`);\n        return null;\n      }\n\n      //  Check and claim slots\n      const slotClaimed = this.claimExtensionSlots(config.id, manifest);\n      if (!slotClaimed) {\n        log.warn({ extensionId: config.id }, 'Failed to claim required slots');\n      }\n\n      // Initialize extension\n      await this.initializeExtension(module, api, manifest);\n\n      validateSpeechProviderContracts({\n        extensionId: config.id,\n        manifest,\n        registeredProviderIds: (api as ExtensionApiImpl).getRegisteredSpeechProviderIds(),\n        logger: api.logger,\n      });\n\n      validateMediaUnderstandingProviderContracts({\n        extensionId: config.id,\n        manifest,\n        registeredProviderIds: (api as ExtensionApiImpl).getRegisteredMediaUnderstandingProviderIds(),\n        logger: api.logger,\n      });\n\n      // Register to registry\n      this.registry.addExtension({\n        id: config.id,\n        name: manifest.name,\n        version: manifest.version,\n        path: extensionPath,\n        module,\n        config: config.config,\n        enabled: true,\n        source: config.source,\n      });\n\n      // Register extension tools to registry (so AgentManager can access them)\n      // Note: api is actually ExtensionApiImpl at runtime\n      const apiImpl = api as unknown as { _getTools: () => Map<string, AgentTool> };\n      const extensionTools = apiImpl._getTools();\n      for (const tool of extensionTools.values()) {\n        this.registry.addTool(tool);\n      }\n\n      this.extensionInstances.set(config.id, api);\n      \n      //  Cache the loaded extension\n      this.cache.set(cacheKey, api);\n\n      this.diagnostics.info(config.id, `Loaded extension: ${manifest.name}`);\n      log.info({ name: manifest.name, id: manifest.id, source: config.source }, `Loaded extension`);\n\n      return api;\n    } catch (error) {\n      log.error({ err: error, extensionId: config.id }, `Error loading extension`);\n      this.diagnostics.error(config.id, `Error loading extension: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   *  Claim extension slots based on manifest kind\n   * Respects configured preferred plugin from config.extensions.slots\n   */\n  private claimExtensionSlots(extensionId: string, manifest: ExtensionManifest): boolean {\n    const kind = manifest.kind as string;\n    \n    // Map extension kind to slot\n    const slotMap: Record<string, SlotKey> = {\n      'memory': 'memory',\n      'tts': 'tts',\n      'speech-provider': 'tts',\n      'web-search': 'webSearch',\n    };\n    \n    const slotKey = slotMap[kind];\n    if (!slotKey) {\n      return true; // No slot required\n    }\n    \n    // Check if slot is reserved for a different plugin in config\n    const preferredPlugin = this.slotsConfig[slotKey];\n    if (preferredPlugin && preferredPlugin !== extensionId) {\n      log.info(\n        { extensionId, slotKey, preferredPlugin },\n        `Skipping slot claim: slot \"${slotKey}\" is reserved for \"${preferredPlugin}\"`\n      );\n      this.diagnostics.info(\n        extensionId,\n        `Slot \"${slotKey}\" is reserved for \"${preferredPlugin}\", skipping claim`\n      );\n      return false;\n    }\n    \n    const claimed = this.slotRegistry.claim(slotKey, extensionId, null);\n    if (!claimed) {\n      this.diagnostics.warn(extensionId, `Slot \"${slotKey}\" already claimed by another extension`);\n    }\n    return claimed;\n  }\n\n  loadManifest(extensionPath: string): ExtensionManifest | null {\n    const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n    // First try to load xopc.extension.json\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    return null;\n  }\n\n  private moduleEntryCandidates(manifest: ExtensionManifest): string[] {\n    if (!manifest.main) return [];\n    return [manifest.main];\n  }\n\n  private async loadModule(\n    extensionPath: string,\n    manifest: ExtensionManifest,\n  ): Promise<ExtensionModule | null> {\n    const entryPoints = this.moduleEntryCandidates(manifest);\n\n    for (const entry of entryPoints) {\n      const fullPath = isAbsolute(entry) ? entry : join(extensionPath, entry);\n\n      if (existsSync(fullPath)) {\n        try {\n          if (!/\\.(js|mjs|cjs)$/.test(fullPath)) {\n            throw new Error(`Extension runtime entry must be built JavaScript: ${entry}`);\n          }\n          const mod = await import(pathToFileURL(fullPath).href);\n          return mod.default || mod;\n        } catch (error) {\n          log.warn({ err: error, path: fullPath }, `Failed to load module`);\n        }\n      }\n    }\n\n    return null;\n  }\n\n  private createExtensionApi(\n    manifest: ExtensionManifest,\n    resolved: ResolvedExtensionConfig,\n    extensionDir: string,\n  ): ExtensionApi {\n    const logger = createExtensionLogger(`[${manifest.id}]`);\n    const resolvePath = createPathResolver(extensionDir, this.options.workspaceDir || '');\n\n    const appConfig = this._appConfig ?? ({} as Config);\n    const extensionOnly = (resolved.config ?? {}) as Record<string, unknown>;\n\n    const runtime =\n      this._appConfig && this._runtimeContext\n        ? {\n            config: this._appConfig,\n            bus: this._runtimeContext.bus,\n            log: logger,\n            sessionManager: this._runtimeContext.sessionManager,\n            scheduleWebchatContinuation: this._runtimeContext.scheduleWebchatContinuation,\n            setLabel: this._runtimeContext.setLabel,\n            sendUserMessage: this._runtimeContext.sendUserMessage,\n            appendEntry: this._runtimeContext.appendEntry,\n            sendMessage: this._runtimeContext.sendMessage,\n          }\n        : this._appConfig\n          ? {\n              config: this._appConfig,\n              log: logger,\n            }\n          : undefined;\n\n    const api = new ExtensionApiImpl(\n      manifest.id,\n      manifest.name,\n      manifest.version,\n      extensionDir,\n      appConfig,\n      extensionOnly,\n      logger,\n      resolvePath,\n      this.registry,\n      manifest.contracts ?? {},\n      runtime,\n    );\n    if (manifest.reload?.configPrefixes?.length) {\n      api._setReloadConfigPrefixes(manifest.reload.configPrefixes);\n    }\n    const manifestCommands = manifest.ui?.contributions?.commands;\n    if (manifestCommands?.length) {\n      (api as ExtensionApiImpl)._setManifestCommands(manifestCommands);\n    }\n    return api;\n  }\n\n  private async initializeExtension(\n    module: ExtensionModule,\n    api: ExtensionApi,\n    _manifest: ExtensionManifest,\n  ): Promise<void> {\n    if (typeof module === 'function') {\n      // Module is a function that receives the API\n      await module(api);\n    } else if (typeof module === 'object' && module.register) {\n      // Module is a ExtensionDefinition with register method\n      await module.register(api);\n    }\n  }\n\n  async startServices(): Promise<void> {\n    const services = Array.from(this.registry.services.values());\n\n    for (const service of services) {\n      const serviceLog = createServiceLogger(service.id);\n      try {\n        await service.start?.();\n        serviceLog.info(`Started service`);\n      } catch (error) {\n        serviceLog.error({ err: error }, `Failed to start service`);\n      }\n    }\n  }\n\n  async stopServices(): Promise<void> {\n    const services = Array.from(this.registry.services.values()).reverse();\n\n    for (const service of services) {\n      if (service.stop) {\n        const serviceLog = createServiceLogger(service.id);\n        try {\n          await service.stop();\n          serviceLog.info(`Stopped service`);\n        } catch (error) {\n          serviceLog.error({ err: error }, `Failed to stop service`);\n        }\n      }\n    }\n  }\n\n  /**\n   * Basic type validation for config values\n   */\n  private validateType(value: unknown, expectedType: string): boolean {\n    if (expectedType === 'string') return typeof value === 'string';\n    if (expectedType === 'number' || expectedType === 'integer') return typeof value === 'number';\n    if (expectedType === 'boolean') return typeof value === 'boolean';\n    if (expectedType === 'array') return Array.isArray(value);\n    if (expectedType === 'object') return typeof value === 'object' && value !== null && !Array.isArray(value);\n    return true;\n  }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nexport function resolveExtensionPath(id: string, _options: ExtensionLoaderOptions): string | null {\n  const c = loadConfig();\n  const aid = resolveDefaultAgentId(c);\n  // Priority 1: Workspace\n  const workspacePath = join(resolveWorkspaceExtensionsDir(c, aid), id);\n  if (existsSync(workspacePath)) return workspacePath;\n\n  // Priority 2: Global\n  const globalPath = join(resolveExtensionsDir(), id);\n  if (existsSync(globalPath)) return globalPath;\n\n  // Priority 3: Bundled\n  const bundledDir = resolveBundledExtensionsDir();\n  if (bundledDir) {\n    const bundledPath = join(bundledDir, id);\n    if (existsSync(bundledPath)) return bundledPath;\n  }\n\n  return null;\n}\n\nexport function normalizeExtensionConfig(\n  rawConfig: Record<string, unknown>,\n): ResolvedExtensionConfig[] {\n  const extensions: ResolvedExtensionConfig[] = [];\n\n  const enabled = (rawConfig.enabled as string[]) || [];\n  const disabled = (rawConfig.disabled as string[]) || [];\n\n  // Parse enabled extensions\n  for (const id of enabled) {\n    const config = (rawConfig[id] as Record<string, unknown>) || {};\n    extensions.push({\n      id,\n      name: id,\n      source: 'config',\n      path: id,\n      enabled: true,\n      config,\n    });\n  }\n\n  // Parse disabled extensions\n  for (const id of disabled) {\n    if (!extensions.find((p) => p.id === id)) {\n      const config = (rawConfig[id] as Record<string, unknown>) || {};\n      extensions.push({\n        id,\n        name: id,\n        source: 'config',\n        path: id,\n        enabled: false,\n        config,\n      });\n    }\n  }\n\n  return extensions;\n}\n"],"mappings":"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"}

package/dist/src/extensions/sdk/testing.d.ts

@@ -4,6 +4,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { ChannelPlugin } from '../../channels/plugin-types.js';
 import type { Config } from '../../config/config-surface.js';
+import type { Migration } from '../../migrations/types.js';
 import type { ExtensionApi, ExtensionCommand, ExtensionCommandContext, ExtensionLogger, ExtensionReloadHandler, ExtensionService, GatewayMethodHandler, HttpRequestHandler } from '../types/core.js';
 import type { ExtensionHookEvent } from '../types/hooks.js';
 import type { CommandContribution } from '../types/manifest.js';
@@ -36,6 +37,7 @@ export interface MockExtensionApi extends ExtensionApi {
     }>;
     getRegisteredChannelPlugins(): ChannelPlugin[];
     getRegisteredReloadHandlers(): ExtensionReloadHandler[];
+    getRegisteredMigrations(): Migration[];
     getEmittedEvents(): Array<{
         event: string;
         data: unknown;

package/dist/src/extensions/sdk/testing.js

@@ -30,6 +30,7 @@ var MockExtensionApiImpl = class {
 	_gw = [];
 	_channels = [];
 	_reload = [];
+	_migrations = [];
 	_emitted = [];
 	_bus = new EventEmitter();
 	_manifestCommands = /* @__PURE__ */ new Map();
@@ -76,6 +77,9 @@ var MockExtensionApiImpl = class {
 	getRegisteredReloadHandlers() {
 		return [...this._reload];
 	}
+	getRegisteredMigrations() {
+		return [...this._migrations];
+	}
 	getEmittedEvents() {
 		return [...this._emitted];
 	}
@@ -125,6 +129,9 @@ var MockExtensionApiImpl = class {
 	registerReload(handler) {
 		this._reload.push(handler);
 	}
+	registerMigration(migration) {
+		this._migrations.push(migration);
+	}
 	registerService(service) {
 		this._services.push(service);
 	}

package/dist/src/extensions/sdk/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../../../../src/extensions/sdk/testing.ts"],"sourcesContent":["/**\n * Extension testing helpers (Phase 2): mock API + minimal HTTP gateway fixture.\n */\n\nimport type { Command } from 'commander';\nimport { EventEmitter } from 'node:events';\nimport { once } from 'node:events';\nimport type { AddressInfo } from 'node:net';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { Hono } from 'hono';\nimport { serve } from '@hono/node-server';\nimport type { ServerType } from '@hono/node-server';\n\nimport type { ChannelPlugin } from '../../channels/plugin-types.js';\nimport type { Config } from '../../config/config-surface.js';\nimport type {\n  ExtensionApi,\n  ExtensionCommand,\n  ExtensionCommandContext,\n  ExtensionCommandHandler,\n  ExtensionLogger,\n  ExtensionReloadHandler,\n  ExtensionRuntime,\n  ExtensionService,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n} from '../types/core.js';\nimport type { FlagConfig, FlagValue, ShortcutConfig } from '../types/phase4.js';\nimport type {\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  HookHandlerMap,\n  HookOptions,\n} from '../types/hooks.js';\nimport type { CommandContribution } from '../types/manifest.js';\nimport type { TuiExtensionRegistrar } from '../types/tui.js';\nimport { TypedEventBus } from '../typed-event-bus.js';\n\nexport interface MockExtensionApiOptions {\n  id?: string;\n  name?: string;\n  version?: string;\n  source?: string;\n  extensionConfig?: Record<string, unknown>;\n  config?: Partial<Config>;\n  logger?: ExtensionLogger;\n  /** Pretend manifest `ui.contributions.commands` for `onCommand` tests. */\n  manifestCommands?: CommandContribution[];\n}\n\nconst noopLogger: ExtensionLogger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n};\n\nexport interface MockExtensionApi extends ExtensionApi {\n  getRegisteredTools(): AgentTool[];\n  getRegisteredHooks(): Array<{ event: ExtensionHookEvent; handler: unknown }>;\n  getRegisteredCommands(): ExtensionCommand[];\n  getRegisteredHttpRoutes(): Array<{ path: string; handler: HttpRequestHandler }>;\n  getRegisteredServices(): ExtensionService[];\n  getRegisteredGatewayMethods(): Array<{ method: string; handler: GatewayMethodHandler }>;\n  getRegisteredChannelPlugins(): ChannelPlugin[];\n  getRegisteredReloadHandlers(): ExtensionReloadHandler[];\n  getEmittedEvents(): Array<{ event: string; data: unknown }>;\n}\n\nexport function createMockExtensionApi(options: MockExtensionApiOptions = {}): MockExtensionApi {\n  return new MockExtensionApiImpl(options);\n}\n\nclass MockExtensionApiImpl implements MockExtensionApi {\n  readonly id: string;\n  readonly name: string;\n  readonly version: string | undefined;\n  readonly source: string;\n  readonly config: Config;\n  readonly extensionConfig: Record<string, unknown>;\n  readonly logger: ExtensionLogger;\n  readonly runtime: ExtensionRuntime;\n  readonly events: TypedEventBus;\n\n  private readonly _tools: AgentTool[] = [];\n  private readonly _hooks: Array<{ event: ExtensionHookEvent; handler: unknown }> = [];\n  private readonly _commands: ExtensionCommand[] = [];\n  private readonly _http: Array<{ path: string; handler: HttpRequestHandler }> = [];\n  private readonly _services: ExtensionService[] = [];\n  private readonly _gw: Array<{ method: string; handler: GatewayMethodHandler }> = [];\n  private readonly _channels: ChannelPlugin[] = [];\n  private readonly _reload: ExtensionReloadHandler[] = [];\n  private readonly _emitted: Array<{ event: string; data: unknown }> = [];\n  private readonly _bus = new EventEmitter();\n  private readonly _manifestCommands = new Map<string, CommandContribution>();\n\n  constructor(opts: MockExtensionApiOptions) {\n    this.id = opts.id ?? 'test-extension';\n    this.name = opts.name ?? 'Test Extension';\n    this.version = opts.version;\n    this.source = opts.source ?? '/test';\n    this.extensionConfig = opts.extensionConfig ?? {};\n    this.config = (opts.config ?? {}) as Config;\n    this.logger = opts.logger ?? noopLogger;\n    this.runtime = { config: this.config, log: this.logger };\n    this.events = new TypedEventBus({ logger: this.logger });\n    if (opts.manifestCommands?.length) {\n      for (const c of opts.manifestCommands) {\n        this._manifestCommands.set(c.id, c);\n      }\n    }\n  }\n\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  getRegisteredTools(): AgentTool[] {\n    return [...this._tools];\n  }\n  getRegisteredHooks(): Array<{ event: ExtensionHookEvent; handler: unknown }> {\n    return [...this._hooks];\n  }\n  getRegisteredCommands(): ExtensionCommand[] {\n    return [...this._commands];\n  }\n  getRegisteredHttpRoutes(): Array<{ path: string; handler: HttpRequestHandler }> {\n    return [...this._http];\n  }\n  getRegisteredServices(): ExtensionService[] {\n    return [...this._services];\n  }\n  getRegisteredGatewayMethods(): Array<{ method: string; handler: GatewayMethodHandler }> {\n    return [...this._gw];\n  }\n  getRegisteredChannelPlugins(): ChannelPlugin[] {\n    return [...this._channels];\n  }\n  getRegisteredReloadHandlers(): ExtensionReloadHandler[] {\n    return [...this._reload];\n  }\n  getEmittedEvents(): Array<{ event: string; data: unknown }> {\n    return [...this._emitted];\n  }\n\n  registerTool(tool: AgentTool): void {\n    this._tools.push(tool);\n  }\n\n  registerHook(\n    event: ExtensionHookEvent,\n    handler: ExtensionHookHandler,\n    _opts?: HookOptions,\n  ): void {\n    this._hooks.push({ event, handler });\n  }\n\n  onHook<K extends ExtensionHookEvent>(_hookName: K, _handler: HookHandlerMap[K]): void {\n    /* optional for tests */\n  }\n\n  registerChannel(registration: { plugin: ChannelPlugin }): void {\n    this._channels.push(registration.plugin);\n  }\n\n  registerHttpRoute(path: string, handler: HttpRequestHandler): void {\n    this._http.push({ path, handler });\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    this._commands.push(command);\n  }\n\n  onCommand(commandId: string, handler: ExtensionCommandHandler): void {\n    const meta = this._manifestCommands.get(commandId);\n    if (!meta) {\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) name = meta.id;\n    this.registerCommand({ name, description: meta.title, handler });\n  }\n\n  registerReload(handler: ExtensionReloadHandler): void {\n    this._reload.push(handler);\n  }\n\n  registerService(service: ExtensionService): void {\n    this._services.push(service);\n  }\n\n  registerGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    this._gw.push({ method, handler });\n  }\n\n  registerCli(_factory: (ctx: { program: Command }) => void, _opts?: { commands: string[] }): void {\n    /* noop */\n  }\n\n  resolvePath(input: string): string {\n    const base = this.source.replace(/\\/$/, '');\n    const p = input.replace(/^\\//, '');\n    return `${base}/${p}`;\n  }\n\n  emit(event: string, data: unknown): void {\n    this._emitted.push({ event, data });\n    this._bus.emit(event, data);\n  }\n\n  on(event: string, handler: (data: unknown) => void): void {\n    this._bus.on(event, handler);\n  }\n\n  off(event: string, handler: (data: unknown) => void): void {\n    this._bus.off(event, handler);\n  }\n\n  registerProvider(_plugin: unknown): void {\n    /* noop */\n  }\n\n  registerProviderPlugin(_plugin: unknown): void {\n    /* noop */\n  }\n\n  registerSpeechProvider(_plugin: import('../../voice/tts/speech-provider-types.js').SpeechProviderPlugin): void {\n    /* noop */\n  }\n\n  registerMediaUnderstandingProvider(\n    _plugin: import('../../media-understanding/types.js').MediaUnderstandingProvider,\n  ): void {\n    /* noop */\n  }\n\n  registerMarketplaceAdapter(_registration: {\n    adapter: unknown;\n    displayName?: string;\n  }): void {\n    /* noop */\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    /* noop */\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined;\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    /* noop */\n  }\n\n  registerTui(_register: TuiExtensionRegistrar): void {\n    /* noop */\n  }\n\n  setLabel(_entryId: string, _label: string | undefined): void {\n    /* noop */\n  }\n\n  sendUserMessage(\n    _content: import('../types/core.js').ExtensionUserMessageContent,\n    _options?: import('../types/core.js').ExtensionSendUserMessageOptions,\n  ): void {\n    /* noop */\n  }\n\n  appendEntry<T = unknown>(_customType: string, _data?: T): void {\n    /* noop */\n  }\n\n  sendMessage<T = unknown>(\n    _message: import('../types/core.js').ExtensionCustomMessage<T>,\n    _options?: import('../types/core.js').ExtensionSendMessageOptions,\n  ): void {\n    /* noop */\n  }\n}\n\nexport interface TestGateway {\n  baseUrl: string;\n  fetch: (path: string, init?: RequestInit) => Promise<Response>;\n  close: () => Promise<void>;\n}\n\nexport async function createTestGateway(): Promise<TestGateway> {\n  const app = new Hono();\n  app.get('/health', (c) => c.json({ ok: true }));\n\n  const server: ServerType = serve({\n    fetch: app.fetch,\n    port: 0,\n    hostname: '127.0.0.1',\n  });\n\n  if (!server.listening) {\n    await once(server, 'listening');\n  }\n  const addr = server.address() as AddressInfo;\n  const port = addr.port;\n  const baseUrl = `http://127.0.0.1:${port}`;\n\n  return {\n    baseUrl,\n    fetch: (path, init) =>\n      fetch(`${baseUrl}${path.startsWith('/') ? path : `/${path}`}`, init),\n    close: () =>\n      new Promise((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      }),\n  };\n}\n\nexport type { ExtensionCommandContext };\n"],"mappings":"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"}
+{"version":3,"file":"testing.js","names":[],"sources":["../../../../src/extensions/sdk/testing.ts"],"sourcesContent":["/**\n * Extension testing helpers (Phase 2): mock API + minimal HTTP gateway fixture.\n */\n\nimport type { Command } from 'commander';\nimport { EventEmitter } from 'node:events';\nimport { once } from 'node:events';\nimport type { AddressInfo } from 'node:net';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { Hono } from 'hono';\nimport { serve } from '@hono/node-server';\nimport type { ServerType } from '@hono/node-server';\n\nimport type { ChannelPlugin } from '../../channels/plugin-types.js';\nimport type { Config } from '../../config/config-surface.js';\nimport type { Migration } from '../../migrations/types.js';\nimport type {\n  ExtensionApi,\n  ExtensionCommand,\n  ExtensionCommandContext,\n  ExtensionCommandHandler,\n  ExtensionLogger,\n  ExtensionReloadHandler,\n  ExtensionRuntime,\n  ExtensionService,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n} from '../types/core.js';\nimport type { FlagConfig, FlagValue, ShortcutConfig } from '../types/registration.js';\nimport type {\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  HookHandlerMap,\n  HookOptions,\n} from '../types/hooks.js';\nimport type { CommandContribution } from '../types/manifest.js';\nimport type { TuiExtensionRegistrar } from '../types/tui.js';\nimport { TypedEventBus } from '../typed-event-bus.js';\n\nexport interface MockExtensionApiOptions {\n  id?: string;\n  name?: string;\n  version?: string;\n  source?: string;\n  extensionConfig?: Record<string, unknown>;\n  config?: Partial<Config>;\n  logger?: ExtensionLogger;\n  /** Pretend manifest `ui.contributions.commands` for `onCommand` tests. */\n  manifestCommands?: CommandContribution[];\n}\n\nconst noopLogger: ExtensionLogger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n};\n\nexport interface MockExtensionApi extends ExtensionApi {\n  getRegisteredTools(): AgentTool[];\n  getRegisteredHooks(): Array<{ event: ExtensionHookEvent; handler: unknown }>;\n  getRegisteredCommands(): ExtensionCommand[];\n  getRegisteredHttpRoutes(): Array<{ path: string; handler: HttpRequestHandler }>;\n  getRegisteredServices(): ExtensionService[];\n  getRegisteredGatewayMethods(): Array<{ method: string; handler: GatewayMethodHandler }>;\n  getRegisteredChannelPlugins(): ChannelPlugin[];\n  getRegisteredReloadHandlers(): ExtensionReloadHandler[];\n  getRegisteredMigrations(): Migration[];\n  getEmittedEvents(): Array<{ event: string; data: unknown }>;\n}\n\nexport function createMockExtensionApi(options: MockExtensionApiOptions = {}): MockExtensionApi {\n  return new MockExtensionApiImpl(options);\n}\n\nclass MockExtensionApiImpl implements MockExtensionApi {\n  readonly id: string;\n  readonly name: string;\n  readonly version: string | undefined;\n  readonly source: string;\n  readonly config: Config;\n  readonly extensionConfig: Record<string, unknown>;\n  readonly logger: ExtensionLogger;\n  readonly runtime: ExtensionRuntime;\n  readonly events: TypedEventBus;\n\n  private readonly _tools: AgentTool[] = [];\n  private readonly _hooks: Array<{ event: ExtensionHookEvent; handler: unknown }> = [];\n  private readonly _commands: ExtensionCommand[] = [];\n  private readonly _http: Array<{ path: string; handler: HttpRequestHandler }> = [];\n  private readonly _services: ExtensionService[] = [];\n  private readonly _gw: Array<{ method: string; handler: GatewayMethodHandler }> = [];\n  private readonly _channels: ChannelPlugin[] = [];\n  private readonly _reload: ExtensionReloadHandler[] = [];\n  private readonly _migrations: Migration[] = [];\n  private readonly _emitted: Array<{ event: string; data: unknown }> = [];\n  private readonly _bus = new EventEmitter();\n  private readonly _manifestCommands = new Map<string, CommandContribution>();\n\n  constructor(opts: MockExtensionApiOptions) {\n    this.id = opts.id ?? 'test-extension';\n    this.name = opts.name ?? 'Test Extension';\n    this.version = opts.version;\n    this.source = opts.source ?? '/test';\n    this.extensionConfig = opts.extensionConfig ?? {};\n    this.config = (opts.config ?? {}) as Config;\n    this.logger = opts.logger ?? noopLogger;\n    this.runtime = { config: this.config, log: this.logger };\n    this.events = new TypedEventBus({ logger: this.logger });\n    if (opts.manifestCommands?.length) {\n      for (const c of opts.manifestCommands) {\n        this._manifestCommands.set(c.id, c);\n      }\n    }\n  }\n\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  getRegisteredTools(): AgentTool[] {\n    return [...this._tools];\n  }\n  getRegisteredHooks(): Array<{ event: ExtensionHookEvent; handler: unknown }> {\n    return [...this._hooks];\n  }\n  getRegisteredCommands(): ExtensionCommand[] {\n    return [...this._commands];\n  }\n  getRegisteredHttpRoutes(): Array<{ path: string; handler: HttpRequestHandler }> {\n    return [...this._http];\n  }\n  getRegisteredServices(): ExtensionService[] {\n    return [...this._services];\n  }\n  getRegisteredGatewayMethods(): Array<{ method: string; handler: GatewayMethodHandler }> {\n    return [...this._gw];\n  }\n  getRegisteredChannelPlugins(): ChannelPlugin[] {\n    return [...this._channels];\n  }\n  getRegisteredReloadHandlers(): ExtensionReloadHandler[] {\n    return [...this._reload];\n  }\n  getRegisteredMigrations(): Migration[] {\n    return [...this._migrations];\n  }\n  getEmittedEvents(): Array<{ event: string; data: unknown }> {\n    return [...this._emitted];\n  }\n\n  registerTool(tool: AgentTool): void {\n    this._tools.push(tool);\n  }\n\n  registerHook(\n    event: ExtensionHookEvent,\n    handler: ExtensionHookHandler,\n    _opts?: HookOptions,\n  ): void {\n    this._hooks.push({ event, handler });\n  }\n\n  onHook<K extends ExtensionHookEvent>(_hookName: K, _handler: HookHandlerMap[K]): void {\n    /* optional for tests */\n  }\n\n  registerChannel(registration: { plugin: ChannelPlugin }): void {\n    this._channels.push(registration.plugin);\n  }\n\n  registerHttpRoute(path: string, handler: HttpRequestHandler): void {\n    this._http.push({ path, handler });\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    this._commands.push(command);\n  }\n\n  onCommand(commandId: string, handler: ExtensionCommandHandler): void {\n    const meta = this._manifestCommands.get(commandId);\n    if (!meta) {\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) name = meta.id;\n    this.registerCommand({ name, description: meta.title, handler });\n  }\n\n  registerReload(handler: ExtensionReloadHandler): void {\n    this._reload.push(handler);\n  }\n\n  registerMigration(migration: Migration): void {\n    this._migrations.push(migration);\n  }\n\n  registerService(service: ExtensionService): void {\n    this._services.push(service);\n  }\n\n  registerGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    this._gw.push({ method, handler });\n  }\n\n  registerCli(_factory: (ctx: { program: Command }) => void, _opts?: { commands: string[] }): void {\n    /* noop */\n  }\n\n  resolvePath(input: string): string {\n    const base = this.source.replace(/\\/$/, '');\n    const p = input.replace(/^\\//, '');\n    return `${base}/${p}`;\n  }\n\n  emit(event: string, data: unknown): void {\n    this._emitted.push({ event, data });\n    this._bus.emit(event, data);\n  }\n\n  on(event: string, handler: (data: unknown) => void): void {\n    this._bus.on(event, handler);\n  }\n\n  off(event: string, handler: (data: unknown) => void): void {\n    this._bus.off(event, handler);\n  }\n\n  registerProvider(_plugin: unknown): void {\n    /* noop */\n  }\n\n  registerProviderPlugin(_plugin: unknown): void {\n    /* noop */\n  }\n\n  registerSpeechProvider(_plugin: import('../../voice/tts/speech-provider-types.js').SpeechProviderPlugin): void {\n    /* noop */\n  }\n\n  registerMediaUnderstandingProvider(\n    _plugin: import('../../media-understanding/types.js').MediaUnderstandingProvider,\n  ): void {\n    /* noop */\n  }\n\n  registerMarketplaceAdapter(_registration: {\n    adapter: unknown;\n    displayName?: string;\n  }): void {\n    /* noop */\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    /* noop */\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined;\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    /* noop */\n  }\n\n  registerTui(_register: TuiExtensionRegistrar): void {\n    /* noop */\n  }\n\n  setLabel(_entryId: string, _label: string | undefined): void {\n    /* noop */\n  }\n\n  sendUserMessage(\n    _content: import('../types/core.js').ExtensionUserMessageContent,\n    _options?: import('../types/core.js').ExtensionSendUserMessageOptions,\n  ): void {\n    /* noop */\n  }\n\n  appendEntry<T = unknown>(_customType: string, _data?: T): void {\n    /* noop */\n  }\n\n  sendMessage<T = unknown>(\n    _message: import('../types/core.js').ExtensionCustomMessage<T>,\n    _options?: import('../types/core.js').ExtensionSendMessageOptions,\n  ): void {\n    /* noop */\n  }\n}\n\nexport interface TestGateway {\n  baseUrl: string;\n  fetch: (path: string, init?: RequestInit) => Promise<Response>;\n  close: () => Promise<void>;\n}\n\nexport async function createTestGateway(): Promise<TestGateway> {\n  const app = new Hono();\n  app.get('/health', (c) => c.json({ ok: true }));\n\n  const server: ServerType = serve({\n    fetch: app.fetch,\n    port: 0,\n    hostname: '127.0.0.1',\n  });\n\n  if (!server.listening) {\n    await once(server, 'listening');\n  }\n  const addr = server.address() as AddressInfo;\n  const port = addr.port;\n  const baseUrl = `http://127.0.0.1:${port}`;\n\n  return {\n    baseUrl,\n    fetch: (path, init) =>\n      fetch(`${baseUrl}${path.startsWith('/') ? path : `/${path}`}`, init),\n    close: () =>\n      new Promise((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      }),\n  };\n}\n\nexport type { ExtensionCommandContext };\n"],"mappings":"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"}