@xopcai/xopc 0.0.105 → 0.0.107

package/dist/src/extensions/api.js

@@ -25,7 +25,7 @@ var ExtensionApiImpl = class {
 	_registeredMediaUnderstandingProviderIds = [];
 	_registeredMarketplaceAdapterIds = [];
 	_manifestCommands = /* @__PURE__ */ new Map();
-	constructor(id, name, version, source, config, extensionConfig, _logger, _resolvePath, _coreRegistry, runtime) {
+	constructor(id, name, version, source, config, extensionConfig, _logger, _resolvePath, _coreRegistry, _contracts = {}, runtime) {
 		this.id = id;
 		this.name = name;
 		this.version = version;
@@ -35,6 +35,7 @@ var ExtensionApiImpl = class {
 		this._logger = _logger;
 		this._resolvePath = _resolvePath;
 		this._coreRegistry = _coreRegistry;
+		this._contracts = _contracts;
 		this._typedEventBus = new TypedEventBus({ logger: _logger });
 		this._registry = _coreRegistry ?? new ExtensionRegistryImpl();
 		this._runtime = runtime ?? {
@@ -48,12 +49,23 @@ var ExtensionApiImpl = class {
 	get runtime() {
 		return this._runtime;
 	}
+	_assertContract(kind, value) {
+		const declared = this._contracts[kind];
+		if (!declared?.length) throw new Error(`Extension ${this.id} attempted to register ${kind}:${value}, but manifest contracts.${kind} is missing`);
+		if (!declared.some((entry) => {
+			if (entry === value) return true;
+			if (entry.endsWith("*")) return value.startsWith(entry.slice(0, -1));
+			return false;
+		})) throw new Error(`Extension ${this.id} attempted to register ${kind}:${value}, but it is not declared in manifest contracts.${kind}`);
+	}
 	registerTool(tool) {
+		this._assertContract("tools", tool.name);
 		if (this._tools.has(tool.name)) this._logger.warn(`Tool ${tool.name} already registered, overwriting`);
 		this._tools.set(tool.name, tool);
 		this._logger.info(`Registered tool: ${tool.name}`);
 	}
 	registerHook(event, handler, opts) {
+		this._assertContract("hooks", event);
 		if (!this._hooks.has(event)) this._hooks.set(event, /* @__PURE__ */ new Set());
 		this._hooks.get(event).add(handler);
 		if (opts?.once) {
@@ -63,6 +75,7 @@ var ExtensionApiImpl = class {
 			};
 			this._hooks.get(event).add(wrapper);
 		}
+		this._registry.addHook(event, handler, this.id, opts?.priority ?? 0);
 		this._logger.info(`Registered hook: ${event}`);
 	}
 	/**
@@ -76,6 +89,7 @@ var ExtensionApiImpl = class {
 	* });
 	*/
 	onHook(hookName, handler, _opts) {
+		this._assertContract("hooks", hookName);
 		const mode = HOOK_EXECUTION_MODES[hookName];
 		if (!this._typedHooks.has(hookName)) this._typedHooks.set(hookName, /* @__PURE__ */ new Set());
 		this._typedHooks.get(hookName).add(handler);
@@ -91,11 +105,14 @@ var ExtensionApiImpl = class {
 	/** Adds a ChannelPlugin to the extension registry; emits `channel:register` for observability. */
 	registerChannel(registration) {
 		const plugin = registration.plugin;
+		this._assertContract("channels", plugin.id);
 		this._registry.addChannelPlugin(plugin);
 		this._eventBus.emit("channel:register", plugin);
 		this._logger.info(`Registered channel plugin: ${plugin.id}`);
 	}
 	registerHttpRoute(path, handler) {
+		this._assertContract("httpRoutes", path);
+		this._registry.addHttpRoute(path, handler);
 		this._eventBus.emit("http:route", {
 			path,
 			handler
@@ -103,6 +120,7 @@ var ExtensionApiImpl = class {
 		this._logger.info(`Registered HTTP route: ${path}`);
 	}
 	registerCommand(command) {
+		this._assertContract("commands", command.name);
 		const commandId = `ext.${this.id}.${command.name}`;
 		const definition = {
 			id: commandId,
@@ -145,16 +163,7 @@ var ExtensionApiImpl = class {
 	}
 	onCommand(commandId, handler) {
 		const meta = this._manifestCommands.get(commandId);
-		if (!meta) {
-			this._logger.warn(`onCommand: unknown command id "${commandId}" — registering runtime-only chat command`);
-			const name = commandId.includes(".") ? (commandId.split(".").pop() ?? commandId).trim() : commandId;
-			this.registerCommand({
-				name: name || commandId,
-				description: commandId,
-				handler
-			});
-			return;
-		}
+		if (!meta) throw new Error(`Extension ${this.id} attempted to bind command ${commandId}, but it is not declared in manifest ui.contributions.commands`);
 		let name;
 		if (meta.chatAlias?.trim()) name = meta.chatAlias.trim().replace(/^\//, "");
 		else name = meta.id.includes(".") ? meta.id.split(".").pop() ?? meta.id : meta.id;
@@ -180,10 +189,14 @@ var ExtensionApiImpl = class {
 		this._reloadConfigPrefixes = [...prefixes];
 	}
 	registerService(service) {
+		this._assertContract("services", service.id);
+		this._registry.addService(service);
 		this._eventBus.emit("service:register", service);
 		this._logger.info(`Registered service: ${service.id}`);
 	}
 	registerGatewayMethod(method, handler) {
+		this._assertContract("gatewayMethods", method);
+		this._registry.addGatewayMethod(method, handler);
 		this._eventBus.emit("gateway:method", {
 			method,
 			handler
@@ -191,6 +204,7 @@ var ExtensionApiImpl = class {
 		this._logger.info(`Registered gateway method: ${method}`);
 	}
 	registerCli(factory, opts) {
+		for (const command of opts?.commands ?? []) this._assertContract("cliCommands", command);
 		const reg = {
 			extensionId: this.id,
 			commands: opts?.commands ?? [],
@@ -219,6 +233,7 @@ var ExtensionApiImpl = class {
 	* Register a full ProviderPlugin
 	*/
 	registerProvider(plugin) {
+		this._assertContract("providers", plugin.id);
 		import("../providers/plugin-registry.js").then(({ getProviderRegistry }) => {
 			getProviderRegistry().register(plugin);
 			this._logger.info(`Extension registered provider: ${plugin.id}`);
@@ -233,6 +248,7 @@ var ExtensionApiImpl = class {
 		this.registerProvider(plugin);
 	}
 	registerSpeechProvider(plugin) {
+		this._assertContract("speechProviders", plugin.id);
 		registerSpeechProvider(plugin);
 		if (!this._registeredSpeechProviderIds.includes(plugin.id)) this._registeredSpeechProviderIds.push(plugin.id);
 		this._logger.info(`Registered speech provider: ${plugin.id}`);
@@ -242,6 +258,7 @@ var ExtensionApiImpl = class {
 		return [...this._registeredSpeechProviderIds];
 	}
 	registerMediaUnderstandingProvider(plugin) {
+		this._assertContract("mediaUnderstandingProviders", plugin.id);
 		registerMediaUnderstandingProvider(plugin);
 		if (!this._registeredMediaUnderstandingProviderIds.includes(plugin.id)) this._registeredMediaUnderstandingProviderIds.push(plugin.id);
 		this._logger.info(`Registered media understanding provider: ${plugin.id}`);
@@ -254,8 +271,9 @@ var ExtensionApiImpl = class {
 	* Register a skills marketplace adapter so it appears in the UI provider picker.
 	*/
 	registerMarketplaceAdapter(registration) {
-		registerMarketplaceAdapter(registration);
 		const adapterId = registration.adapter.id;
+		this._assertContract("marketplaceAdapters", adapterId);
+		registerMarketplaceAdapter(registration);
 		if (!this._registeredMarketplaceAdapterIds.includes(adapterId)) this._registeredMarketplaceAdapterIds.push(adapterId);
 		this._logger.info(`Extension registered marketplace adapter: ${adapterId}`);
 	}
@@ -263,6 +281,7 @@ var ExtensionApiImpl = class {
 	getFlag(_name) {}
 	registerShortcut(_key, _config) {}
 	registerTui(register) {
+		this._assertContract("tui", this.id);
 		this._registry.addTuiRegistration(this.id, register);
 		this._logger.info("Registered TUI contributions (deferred until xopc tui starts)");
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"api.js","names":[],"sources":["../../../src/extensions/api.ts"],"sourcesContent":["/**\n * Extension API Implementation\n * \n *  Complete extension API with strong typing, security, and provider support.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Command } from 'commander';\nimport type {\n  ExtensionApi,\n  ExtensionLogger,\n  ExtensionRuntime,\n  ExtensionCliRegistration,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n  ExtensionCommand,\n  ExtensionCommandContext,\n  ExtensionCommandHandler,\n  ExtensionReloadHandler,\n  ExtensionService,\n  FlagConfig,\n  FlagValue,\n  ShortcutConfig,\n  HookHandlerMap,\n  ExtensionHookEvent,\n  HookExecutionMode,\n  TuiExtensionRegistrar,\n  ExtensionSendUserMessageOptions,\n  ExtensionUserMessageContent,\n  ExtensionCustomMessage,\n  ExtensionSendMessageOptions,\n} from './types/index.js';\nimport type { CommandContribution } from './types/manifest.js';\nimport type { CommandDefinition } from '../chat-commands/types.js';\nimport { commandRegistry } from '../chat-commands/registry.js';\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport {\n  HOOK_EXECUTION_MODES,\n} from './types/hooks.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { Config as SchemaConfig } from '../config/schema.js';\nimport { resolve, isAbsolute } from 'path';\nimport { EventEmitter } from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { TypedEventBus } from './typed-event-bus.js';\nimport { ExtensionRegistryImpl } from './extension-registry-impl.js';\nimport { registerMarketplaceAdapter as _registerMarketplaceAdapter, unregisterMarketplaceAdapter as _unregisterMarketplaceAdapter } from '../agent/skills/marketplace/registry.js';\nimport { registerSpeechProvider as registerSpeechProviderInRegistry } from '../voice/tts/speech-registry.js';\nimport type { SpeechProviderPlugin } from '../voice/tts/speech-provider-types.js';\nimport { registerMediaUnderstandingProvider as registerMediaUnderstandingProviderInRegistry } from '../media-understanding/registry.js';\nimport type { MediaUnderstandingProvider } from '../media-understanding/types.js';\n\nexport class ExtensionApiImpl implements ExtensionApi {\n  private _tools: Map<string, AgentTool> = new Map();\n  private _hooks: Map<string, Set<Function>> = new Map();\n  //  Strongly typed hooks (for on() method)\n  private _typedHooks: Map<ExtensionHookEvent, Set<Function>> = new Map();\n  private _eventBus = new EventEmitter();\n  private _typedEventBus: TypedEventBus;\n  \n  //  Unified Registry\n  private _registry: ExtensionRegistryImpl;\n\n  private readonly _runtime: ExtensionRuntime;\n\n  private _reloadConfigPrefixes: string[] = [];\n  private _registeredCommandIds: string[] = [];\n  private _registeredSpeechProviderIds: string[] = [];\n  private _registeredMediaUnderstandingProviderIds: string[] = [];\n  private _registeredMarketplaceAdapterIds: string[] = [];\n  private readonly _manifestCommands = new Map<string, CommandContribution>();\n\n  constructor(\n    public readonly id: string,\n    public readonly name: string,\n    public readonly version: string | undefined,\n    public readonly source: string,\n    public readonly config: Config,\n    public readonly extensionConfig: Record<string, unknown>,\n    private readonly _logger: ExtensionLogger,\n    private readonly _resolvePath: (input: string) => string,\n    private readonly _coreRegistry?: ExtensionRegistryImpl,\n    runtime?: ExtensionRuntime,\n  ) {\n    // Initialize typed event bus\n    this._typedEventBus = new TypedEventBus({\n      logger: _logger,\n    });\n    \n    this._registry = _coreRegistry ?? new ExtensionRegistryImpl();\n    this._runtime =\n      runtime ??\n      ({\n        config: this.config,\n        log: this._logger,\n      } as ExtensionRuntime);\n  }\n\n  get logger(): ExtensionLogger {\n    return this._logger;\n  }\n\n  get runtime(): ExtensionRuntime {\n    return this._runtime;\n  }\n\n  registerTool(tool: AgentTool): void {\n    if (this._tools.has(tool.name)) {\n      this._logger.warn(`Tool ${tool.name} already registered, overwriting`);\n    }\n    this._tools.set(tool.name, tool);\n    this._logger.info(`Registered tool: ${tool.name}`);\n  }\n\n  registerHook(event: string, handler: Function, opts?: { priority?: number; once?: boolean }): void {\n    if (!this._hooks.has(event)) {\n      this._hooks.set(event, new Set());\n    }\n    this._hooks.get(event)!.add(handler);\n\n    if (opts?.once) {\n      const wrapper = async (...args: unknown[]) => {\n        await handler(...args);\n        this._hooks.get(event)?.delete(wrapper);\n      };\n      this._hooks.get(event)!.add(wrapper);\n    }\n\n    this._logger.info(`Registered hook: ${event}`);\n  }\n\n  /**\n   *  Strongly typed hook registration\n   * Provides compile-time type checking and IDE autocomplete\n   * \n   * @example\n   * api.on('before_agent_start', async (event, ctx) => {\n   *   console.log('Agent starting with prompt:', event.prompt);\n   *   return { systemPrompt: event.systemPrompt };\n   * });\n   */\n  onHook<K extends ExtensionHookEvent>(\n    hookName: K,\n    handler: HookHandlerMap[K],\n    _opts?: { priority?: number },\n  ): void {\n    // Get execution mode for this hook\n    const mode = (HOOK_EXECUTION_MODES as Record<string, HookExecutionMode>)[hookName];\n    \n    if (!this._typedHooks.has(hookName)) {\n      this._typedHooks.set(hookName, new Set());\n    }\n    \n    this._typedHooks.get(hookName)!.add(handler);\n\n    this._logger.debug(`Registered typed hook: ${hookName} (mode: ${mode})`);\n  }\n\n  /**\n   *  Get typed hooks for a specific event\n   */\n  _getTypedHooks<K extends ExtensionHookEvent>(hookName: K): HookHandlerMap[K][] {\n    const hooks = this._typedHooks.get(hookName);\n    return hooks ? Array.from(hooks) as HookHandlerMap[K][] : [];\n  }\n\n  /** Adds a ChannelPlugin to the extension registry; emits `channel:register` for observability. */\n  registerChannel(registration: { plugin: ChannelPlugin }): void {\n    const plugin = registration.plugin;\n    this._registry.addChannelPlugin(plugin);\n    this._eventBus.emit('channel:register', plugin);\n    this._logger.info(`Registered channel plugin: ${plugin.id}`);\n  }\n\n  registerHttpRoute(path: string, handler: HttpRequestHandler): void {\n    this._eventBus.emit('http:route', { path, handler });\n    this._logger.info(`Registered HTTP route: ${path}`);\n  }\n\n  registerCommand(command: ExtensionCommand): void {\n    const commandId = `ext.${this.id}.${command.name}`;\n\n    const definition: CommandDefinition = {\n      id: commandId,\n      name: command.name,\n      aliases: command.aliases,\n      description: command.description,\n      category: 'extension',\n      scope: command.scope ?? ['global'],\n      acceptsArgs: command.acceptsArgs,\n      examples: command.examples,\n      handler: async (ctx, args) => {\n        const extensionCtx: ExtensionCommandContext = {\n          sessionKey: ctx.sessionKey,\n          source: ctx.source,\n          isGroup: ctx.isGroup,\n          config: ctx.config as SchemaConfig as ExtensionCommandContext['config'],\n          reply: (text: string) => ctx.reply(text),\n        };\n\n        const result = await command.handler(args, extensionCtx);\n\n        if (!result) {\n          return { content: '', success: true };\n        }\n        return {\n          content: result.content,\n          success: result.success ?? true,\n        };\n      },\n    };\n\n    commandRegistry.register(definition);\n    this._registeredCommandIds.push(commandId);\n    this._registry.addCommand(command);\n\n    this._eventBus.emit('command:register', command);\n    this._logger.info(`Registered chat command: /${command.name}`);\n  }\n\n  /** Injected from manifest `ui.contributions.commands` by the loader. */\n  _setManifestCommands(commands: CommandContribution[]): void {\n    this._manifestCommands.clear();\n    for (const c of commands) {\n      this._manifestCommands.set(c.id, c);\n    }\n  }\n\n  onCommand(commandId: string, handler: ExtensionCommandHandler): void {\n    const meta = this._manifestCommands.get(commandId);\n    if (!meta) {\n      this._logger.warn(\n        `onCommand: unknown command id \"${commandId}\" — registering runtime-only chat command`,\n      );\n      const name = commandId.includes('.')\n        ? (commandId.split('.').pop() ?? commandId).trim()\n        : commandId;\n      this.registerCommand({\n        name: name || commandId,\n        description: commandId,\n        handler,\n      });\n      return;\n    }\n    let name: string;\n    if (meta.chatAlias?.trim()) {\n      name = meta.chatAlias.trim().replace(/^\\//, '');\n    } else {\n      name = meta.id.includes('.') ? (meta.id.split('.').pop() ?? meta.id) : meta.id;\n    }\n    if (!name) {\n      name = meta.id;\n    }\n    this.registerCommand({\n      name,\n      description: meta.title,\n      handler,\n    });\n    this._logger.info(`Bound manifest command \"${commandId}\" as /${name}`);\n  }\n\n  registerReload(handler: ExtensionReloadHandler): void {\n    const prefixes =\n      this._reloadConfigPrefixes.length > 0\n        ? this._reloadConfigPrefixes\n        : [`extensions.${this.id}`];\n\n    this._registry.addReloadRegistration({\n      extensionId: this.id,\n      handler,\n      configPrefixes: prefixes,\n    });\n    this._logger.info('Registered reload handler');\n  }\n\n  /** Called from loader when manifest declares `reload.configPrefixes`. */\n  _setReloadConfigPrefixes(prefixes: string[]): void {\n    this._reloadConfigPrefixes = [...prefixes];\n  }\n\n  registerService(service: ExtensionService): void {\n    this._eventBus.emit('service:register', service);\n    this._logger.info(`Registered service: ${service.id}`);\n  }\n\n  registerGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n    this._eventBus.emit('gateway:method', { method, handler });\n    this._logger.info(`Registered gateway method: ${method}`);\n  }\n\n  registerCli(\n    factory: (ctx: { program: Command }) => void,\n    opts?: { commands: string[] },\n  ): void {\n    const reg: ExtensionCliRegistration = {\n      extensionId: this.id,\n      commands: opts?.commands ?? [],\n      factory,\n    };\n    this._registry.addCliRegistration(reg);\n    this._eventBus.emit('cli:register', reg);\n    this._logger.info(\n      `Registered CLI factory${opts?.commands?.length ? ` (${opts.commands.join(', ')})` : ''}`,\n    );\n  }\n\n  resolvePath(input: string): string {\n    return this._resolvePath(input);\n  }\n\n  emit(event: string, data: unknown): void {\n    this._eventBus.emit(event, data);\n  }\n\n  on(event: string, handler: (data: unknown) => void): void {\n    this._eventBus.on(event, handler);\n  }\n\n  off(event: string, handler: (data: unknown) => void): void {\n    this._eventBus.off(event, handler);\n  }\n\n  //  Typed Event Bus\n  get events(): TypedEventBus {\n    return this._typedEventBus;\n  }\n\n  //  Unified Registry Methods\n  \n  /**\n   * Register a full ProviderPlugin\n   */\n  registerProvider(plugin: import('./types/providers.js').ProviderPlugin): void {\n    import('../providers/plugin-registry.js').then(({ getProviderRegistry }) => {\n      const registry = getProviderRegistry();\n      registry.register(plugin);\n      this._logger.info(`Extension registered provider: ${plugin.id}`);\n    }).catch((err: unknown) => {\n      this._logger.error(`Failed to register provider: ${err instanceof Error ? err.message : String(err)}`);\n    });\n  }\n\n  /**\n   * Register a full ProviderPlugin (alias for registerProvider)\n   */\n  registerProviderPlugin(plugin: import('./types/providers.js').ProviderPlugin): void {\n    this.registerProvider(plugin);\n  }\n\n  registerSpeechProvider(plugin: SpeechProviderPlugin): void {\n    registerSpeechProviderInRegistry(plugin);\n    if (!this._registeredSpeechProviderIds.includes(plugin.id)) {\n      this._registeredSpeechProviderIds.push(plugin.id);\n    }\n    this._logger.info(`Registered speech provider: ${plugin.id}`);\n  }\n\n  /** Speech provider ids registered through this extension API instance. */\n  getRegisteredSpeechProviderIds(): readonly string[] {\n    return [...this._registeredSpeechProviderIds];\n  }\n\n  registerMediaUnderstandingProvider(plugin: MediaUnderstandingProvider): void {\n    registerMediaUnderstandingProviderInRegistry(plugin);\n    if (!this._registeredMediaUnderstandingProviderIds.includes(plugin.id)) {\n      this._registeredMediaUnderstandingProviderIds.push(plugin.id);\n    }\n    this._logger.info(`Registered media understanding provider: ${plugin.id}`);\n  }\n\n  /** Media understanding provider ids registered through this extension API instance. */\n  getRegisteredMediaUnderstandingProviderIds(): readonly string[] {\n    return [...this._registeredMediaUnderstandingProviderIds];\n  }\n\n  /**\n   * Register a skills marketplace adapter so it appears in the UI provider picker.\n   */\n  registerMarketplaceAdapter(registration: {\n    adapter: import('../agent/skills/marketplace/adapter.types.js').SkillsMarketplaceAdapter;\n    displayName?: string;\n  }): void {\n    _registerMarketplaceAdapter(registration);\n    const adapterId = registration.adapter.id;\n    if (!this._registeredMarketplaceAdapterIds.includes(adapterId)) {\n      this._registeredMarketplaceAdapterIds.push(adapterId);\n    }\n    this._logger.info(`Extension registered marketplace adapter: ${adapterId}`);\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    // this._registry.registerFlag(name, config, this.id);\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined; // this._registry.getFlag(name);\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    // this._registry.registerShortcut(key, config, { extensionId: this.id });\n  }\n\n  registerTui(register: TuiExtensionRegistrar): void {\n    this._registry.addTuiRegistration(this.id, register);\n    this._logger.info('Registered TUI contributions (deferred until xopc tui starts)');\n  }\n\n  setLabel(entryId: string, label: string | undefined): void {\n    this._runtime.setLabel?.(entryId, label);\n  }\n\n  sendUserMessage(\n    content: ExtensionUserMessageContent,\n    options?: ExtensionSendUserMessageOptions,\n  ): void {\n    this._runtime.sendUserMessage?.(content, options);\n  }\n\n  appendEntry<T = unknown>(customType: string, data?: T): void {\n    this._runtime.appendEntry?.(customType, data);\n  }\n\n  sendMessage<T = unknown>(\n    message: ExtensionCustomMessage<T>,\n    options?: ExtensionSendMessageOptions,\n  ): void {\n    this._runtime.sendMessage?.(message, options);\n  }\n\n  // Internal methods for extension manager\n  _getTools(): Map<string, AgentTool> {\n    return this._tools;\n  }\n\n  _getHooks(): Map<string, Set<Function>> {\n    return this._hooks;\n  }\n\n  _getEventBus(): EventEmitter {\n    return this._eventBus;\n  }\n\n  _cleanup(): void {\n    for (const commandId of this._registeredCommandIds) {\n      commandRegistry.unregister(commandId);\n    }\n    this._registeredCommandIds = [];\n    this._manifestCommands.clear();\n\n    this._registry.removeReloadRegistration(this.id);\n\n    for (const adapterId of this._registeredMarketplaceAdapterIds) {\n      _unregisterMarketplaceAdapter(adapterId);\n    }\n    this._registeredMarketplaceAdapterIds = [];\n\n    this._typedEventBus.cleanupAll();\n    this._eventBus.removeAllListeners();\n    this._hooks.clear();\n    this._typedHooks.clear();\n  }\n}\n\n// ============================================================================\n// Default Logger\n// ============================================================================\n\nexport function createExtensionLogger(prefix: string): ExtensionLogger {\n  const childLogger = createLogger(`Extension:${prefix}`);\n\n  return {\n    debug: (msg: string) => childLogger.debug(msg),\n    info: (msg: string) => childLogger.info(msg),\n    warn: (msg: string) => childLogger.warn(msg),\n    error: (msg: string) => childLogger.error(msg),\n  };\n}\n\n// ============================================================================\n// Path Resolver\n// ============================================================================\n\nexport function createPathResolver(extensionDir: string, workspaceDir: string) {\n  return (input: string): string => {\n    if (input.startsWith('~')) {\n      return input.replace('~', process.env.HOME || '');\n    }\n    if (input.startsWith('.')) {\n      return resolve(extensionDir, input);\n    }\n    if (!isAbsolute(input)) {\n      return resolve(workspaceDir, input);\n    }\n    return input;\n  };\n}\n"],"mappings":"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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';\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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"}

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

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

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

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { init_normalize_manifest, normalizeExtensionManifest } from "./normalize-manifest.js";
 import { join } from "path";
@@ -127,6 +127,7 @@ function discoverExtensionsFromDisk(options = {}, config) {
 	const discovered = /* @__PURE__ */ new Map();
 	const paths = resolveDiscoveryPaths(options, config);
 	if (paths.bundledDir) discoverInDirectory(paths.bundledDir, "bundled", discovered);
+	if (process.env.XOPC_BUNDLED_EXTENSIONS_ROOT || paths.bundledDir?.includes(`${join("dist", "electron", "extensions")}`)) return Array.from(discovered.values());
 	discoverInDirectory(paths.globalDir, "global", discovered);
 	if (paths.workspaceExtensionsDir) discoverInDirectory(paths.workspaceExtensionsDir, "workspace", discovered);
 	return Array.from(discovered.values());

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

@@ -1 +1 @@
-{"version":3,"file":"discover-extensions.js","names":[],"sources":["../../../src/extensions/discover-extensions.ts"],"sourcesContent":["/**\n * Filesystem-only extension discovery (manifest parse, no module load).\n */\n\nimport { existsSync, readdirSync, readFileSync } from 'fs';\nimport { join } from 'path';\n\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport {\n  resolveBundledExtensionsDir,\n  resolveExtensionsDir,\n  resolveWorkspaceExtensionsDir,\n} from '../config/paths.js';\nimport { createLogger } from '../utils/logger.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport type { ExtensionManifest } from './types/manifest.js';\nimport type { DiscoveredExtension } from './types/loader.js';\n\n/** App config slice used for discovery (any loaded config shape). */\nexport type DiscoverConfig = Record<string, unknown>;\n\nfunction asSchemaConfig(config: DiscoverConfig): Config {\n  return config as Config;\n}\n\nconst EXTENSION_MANIFEST_FILE = 'xopc.extension.json';\n\nconst log = createLogger('ExtensionDiscover');\n\nexport type ExtensionSourceOrigin = 'workspace' | 'global' | 'bundled' | 'config';\n\nexport interface ExtensionLoaderOptions {\n  workspaceDir?: string;\n  extensionsDir?: string;\n  workspaceExtensionsDir?: string;\n  bundledExtensions?: string[];\n}\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction loadManifest(extensionPath: string): ExtensionManifest | null {\n  const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n  if (existsSync(manifestPath)) {\n    try {\n      const raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n      if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n        log.error({ manifestPath }, 'Manifest root must be a JSON object');\n        return null;\n      }\n      return normalizeExtensionManifest(raw as Record<string, unknown>);\n    } catch (error) {\n      log.error({ err: error, manifestPath }, 'Failed to parse manifest');\n      return null;\n    }\n  }\n\n  const packagePath = join(extensionPath, 'package.json');\n  if (existsSync(packagePath)) {\n    try {\n      const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n\n      if (packageJson.xopc?.extension) {\n        const xopcConfig = packageJson.xopc;\n        return normalizeExtensionManifest({\n          id: xopcConfig.id || packageJson.name,\n          name: xopcConfig.name || packageJson.name,\n          description: xopcConfig.description || packageJson.description,\n          version: xopcConfig.version || packageJson.version || '1.0.0',\n          kind: xopcConfig.kind || 'utility',\n          main: xopcConfig.main || packageJson.main || 'index.js',\n          configSchema: xopcConfig.configSchema,\n        });\n      }\n\n      if (packageJson.name?.startsWith('xopc-extension-')) {\n        const id = packageJson.name.replace('xopc-extension-', '');\n        return normalizeExtensionManifest({\n          id,\n          name: packageJson.name,\n          description: packageJson.description,\n          version: packageJson.version || '1.0.0',\n          kind: 'utility',\n          main: packageJson.main || 'index.js',\n        });\n      }\n    } catch (error) {\n      log.error({ err: error, packagePath }, 'Failed to parse package.json');\n    }\n  }\n\n  return null;\n}\n\nfunction discoverInDirectory(\n  dir: string,\n  source: ExtensionSourceOrigin,\n  discovered: Map<string, DiscoveredExtension>,\n): void {\n  if (!existsSync(dir)) {\n    return;\n  }\n\n  let entries: string[];\n  try {\n    entries = readdirSync(dir);\n  } catch {\n    return;\n  }\n\n  for (const entry of entries) {\n    const extensionPath = join(dir, entry);\n\n    try {\n      if (!existsSync(extensionPath)) continue;\n    } catch {\n      continue;\n    }\n\n    const manifest = loadManifest(extensionPath);\n    if (!manifest) continue;\n\n    const extensionId = manifest.id || entry;\n\n    const existing = discovered.get(extensionId);\n    if (existing) {\n      const priority = { workspace: 3, global: 2, bundled: 1, config: 0 };\n      if (priority[source] <= priority[existing.source]) {\n        log.debug(\n          { extensionId, from: source, existing: existing.source },\n          'Skipping lower priority extension',\n        );\n        continue;\n      }\n      log.info(\n        { extensionId, from: source, overriding: existing.source },\n        'Extension override by higher priority source',\n      );\n    }\n\n    discovered.set(extensionId, {\n      id: extensionId,\n      path: extensionPath,\n      source,\n      manifest,\n    });\n  }\n}\n\nfunction resolveDiscoveryPaths(\n  options: ExtensionLoaderOptions,\n  config?: DiscoverConfig,\n): {\n  bundledDir: string | null;\n  globalDir: string;\n  workspaceExtensionsDir: string | null;\n} {\n  const cfg = config ? asSchemaConfig(config) : null;\n  const aid = cfg ? resolveDefaultAgentId(cfg) : null;\n\n  return {\n    bundledDir: resolveBundledExtensionsDir(),\n    globalDir: options.extensionsDir ?? resolveExtensionsDir(),\n    workspaceExtensionsDir:\n      options.workspaceExtensionsDir ??\n      (cfg && aid ? resolveWorkspaceExtensionsDir(cfg, aid) : null),\n  };\n}\n\n/**\n * Discover extensions from workspace, global, and bundled tiers without loading code.\n */\nexport function discoverExtensionsFromDisk(\n  options: ExtensionLoaderOptions = {},\n  config?: DiscoverConfig,\n): DiscoveredExtension[] {\n  const discovered = new Map<string, DiscoveredExtension>();\n  const paths = resolveDiscoveryPaths(options, config);\n\n  if (paths.bundledDir) {\n    discoverInDirectory(paths.bundledDir, 'bundled', discovered);\n  }\n\n  discoverInDirectory(paths.globalDir, 'global', discovered);\n  if (paths.workspaceExtensionsDir) {\n    discoverInDirectory(paths.workspaceExtensionsDir, 'workspace', discovered);\n  }\n\n  return Array.from(discovered.values());\n}\n\n/** True when extension discovery/load should be skipped entirely. */\nexport function areExtensionsGloballyDisabled(config?: DiscoverConfig): boolean {\n  if (\n    process.env.XOPC_SKIP_EXTENSIONS === '1' ||\n    process.env.XOPC_SKIP_EXTENSIONS === 'true'\n  ) {\n    return true;\n  }\n\n  const ext =\n    config && isRecord(config) && isRecord((config as Record<string, unknown>).extensions)\n      ? ((config as Record<string, unknown>).extensions as Record<string, unknown>)\n      : undefined;\n\n  return ext?.enabled === false;\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,SAAS,eAAe,QAAgC;AACtD,QAAO;;AAgBT,SAAS,SAAS,GAA0C;AAC1D,QAAO,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,EAAE;;AAGjE,SAAS,aAAa,eAAiD;CACrE,MAAM,eAAe,KAAK,eAAe,wBAAwB;AAEjE,KAAI,WAAW,aAAa,CAC1B,KAAI;EACF,MAAM,MAAM,KAAK,MAAM,aAAa,cAAc,QAAQ,CAAC;AAC3D,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,IAAI,EAAE;AACzD,OAAI,MAAM,EAAE,cAAc,EAAE,sCAAsC;AAClE,UAAO;;AAET,SAAO,2BAA2B,IAA+B;UAC1D,OAAO;AACd,MAAI,MAAM;GAAE,KAAK;GAAO;GAAc,EAAE,2BAA2B;AACnE,SAAO;;CAIX,MAAM,cAAc,KAAK,eAAe,eAAe;AACvD,KAAI,WAAW,YAAY,CACzB,KAAI;EACF,MAAM,cAAc,KAAK,MAAM,aAAa,aAAa,QAAQ,CAAC;AAElE,MAAI,YAAY,MAAM,WAAW;GAC/B,MAAM,aAAa,YAAY;AAC/B,UAAO,2BAA2B;IAChC,IAAI,WAAW,MAAM,YAAY;IACjC,MAAM,WAAW,QAAQ,YAAY;IACrC,aAAa,WAAW,eAAe,YAAY;IACnD,SAAS,WAAW,WAAW,YAAY,WAAW;IACtD,MAAM,WAAW,QAAQ;IACzB,MAAM,WAAW,QAAQ,YAAY,QAAQ;IAC7C,cAAc,WAAW;IAC1B,CAAC;;AAGJ,MAAI,YAAY,MAAM,WAAW,kBAAkB,CAEjD,QAAO,2BAA2B;GAChC,IAFS,YAAY,KAAK,QAAQ,mBAAmB,GAEnD;GACF,MAAM,YAAY;GAClB,aAAa,YAAY;GACzB,SAAS,YAAY,WAAW;GAChC,MAAM;GACN,MAAM,YAAY,QAAQ;GAC3B,CAAC;UAEG,OAAO;AACd,MAAI,MAAM;GAAE,KAAK;GAAO;GAAa,EAAE,+BAA+B;;AAI1E,QAAO;;AAGT,SAAS,oBACP,KACA,QACA,YACM;AACN,KAAI,CAAC,WAAW,IAAI,CAClB;CAGF,IAAI;AACJ,KAAI;AACF,YAAU,YAAY,IAAI;SACpB;AACN;;AAGF,MAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,gBAAgB,KAAK,KAAK,MAAM;AAEtC,MAAI;AACF,OAAI,CAAC,WAAW,cAAc,CAAE;UAC1B;AACN;;EAGF,MAAM,WAAW,aAAa,cAAc;AAC5C,MAAI,CAAC,SAAU;EAEf,MAAM,cAAc,SAAS,MAAM;EAEnC,MAAM,WAAW,WAAW,IAAI,YAAY;AAC5C,MAAI,UAAU;GACZ,MAAM,WAAW;IAAE,WAAW;IAAG,QAAQ;IAAG,SAAS;IAAG,QAAQ;IAAG;AACnE,OAAI,SAAS,WAAW,SAAS,SAAS,SAAS;AACjD,QAAI,MACF;KAAE;KAAa,MAAM;KAAQ,UAAU,SAAS;KAAQ,EACxD,oCACD;AACD;;AAEF,OAAI,KACF;IAAE;IAAa,MAAM;IAAQ,YAAY,SAAS;IAAQ,EAC1D,+CACD;;AAGH,aAAW,IAAI,aAAa;GAC1B,IAAI;GACJ,MAAM;GACN;GACA;GACD,CAAC;;;AAIN,SAAS,sBACP,SACA,QAKA;CACA,MAAM,MAAM,SAAS,eAAe,OAAO,GAAG;CAC9C,MAAM,MAAM,MAAM,sBAAsB,IAAI,GAAG;AAE/C,QAAO;EACL,YAAY,6BAA6B;EACzC,WAAW,QAAQ,iBAAiB,sBAAsB;EAC1D,wBACE,QAAQ,2BACP,OAAO,MAAM,8BAA8B,KAAK,IAAI,GAAG;EAC3D;;;;;AAMH,SAAgB,2BACd,UAAkC,EAAE,EACpC,QACuB;CACvB,MAAM,6BAAa,IAAI,KAAkC;CACzD,MAAM,QAAQ,sBAAsB,SAAS,OAAO;AAEpD,KAAI,MAAM,WACR,qBAAoB,MAAM,YAAY,WAAW,WAAW;AAG9D,qBAAoB,MAAM,WAAW,UAAU,WAAW;AAC1D,KAAI,MAAM,uBACR,qBAAoB,MAAM,wBAAwB,aAAa,WAAW;AAG5E,QAAO,MAAM,KAAK,WAAW,QAAQ,CAAC;;;AAIxC,SAAgB,8BAA8B,QAAkC;AAC9E,KACE,QAAQ,IAAI,yBAAyB,OACrC,QAAQ,IAAI,yBAAyB,OAErC,QAAO;AAQT,SAJE,UAAU,SAAS,OAAO,IAAI,SAAU,OAAmC,WAAW,GAChF,OAAmC,aACrC,KAAA,IAEM,YAAY;;;;mBAzMsC;aAMpC;cACsB;0BACmB;AAW/D,2BAA0B;AAE1B,OAAM,aAAa,oBAAoB"}
+{"version":3,"file":"discover-extensions.js","names":[],"sources":["../../../src/extensions/discover-extensions.ts"],"sourcesContent":["/**\n * Filesystem-only extension discovery (manifest parse, no module load).\n */\n\nimport { existsSync, readdirSync, readFileSync } from 'fs';\nimport { join } from 'path';\n\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport {\n  resolveBundledExtensionsDir,\n  resolveExtensionsDir,\n  resolveWorkspaceExtensionsDir,\n} from '../config/paths.js';\nimport { createLogger } from '../utils/logger.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport type { ExtensionManifest } from './types/manifest.js';\nimport type { DiscoveredExtension } from './types/loader.js';\n\n/** App config slice used for discovery (any loaded config shape). */\nexport type DiscoverConfig = Record<string, unknown>;\n\nfunction asSchemaConfig(config: DiscoverConfig): Config {\n  return config as Config;\n}\n\nconst EXTENSION_MANIFEST_FILE = 'xopc.extension.json';\n\nconst log = createLogger('ExtensionDiscover');\n\nexport type ExtensionSourceOrigin = 'workspace' | 'global' | 'bundled' | 'config';\n\nexport interface ExtensionLoaderOptions {\n  workspaceDir?: string;\n  extensionsDir?: string;\n  workspaceExtensionsDir?: string;\n  bundledExtensions?: string[];\n}\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction loadManifest(extensionPath: string): ExtensionManifest | null {\n  const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n  if (existsSync(manifestPath)) {\n    try {\n      const raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n      if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n        log.error({ manifestPath }, 'Manifest root must be a JSON object');\n        return null;\n      }\n      return normalizeExtensionManifest(raw as Record<string, unknown>);\n    } catch (error) {\n      log.error({ err: error, manifestPath }, 'Failed to parse manifest');\n      return null;\n    }\n  }\n\n  const packagePath = join(extensionPath, 'package.json');\n  if (existsSync(packagePath)) {\n    try {\n      const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n\n      if (packageJson.xopc?.extension) {\n        const xopcConfig = packageJson.xopc;\n        return normalizeExtensionManifest({\n          id: xopcConfig.id || packageJson.name,\n          name: xopcConfig.name || packageJson.name,\n          description: xopcConfig.description || packageJson.description,\n          version: xopcConfig.version || packageJson.version || '1.0.0',\n          kind: xopcConfig.kind || 'utility',\n          main: xopcConfig.main || packageJson.main || 'index.js',\n          configSchema: xopcConfig.configSchema,\n        });\n      }\n\n      if (packageJson.name?.startsWith('xopc-extension-')) {\n        const id = packageJson.name.replace('xopc-extension-', '');\n        return normalizeExtensionManifest({\n          id,\n          name: packageJson.name,\n          description: packageJson.description,\n          version: packageJson.version || '1.0.0',\n          kind: 'utility',\n          main: packageJson.main || 'index.js',\n        });\n      }\n    } catch (error) {\n      log.error({ err: error, packagePath }, 'Failed to parse package.json');\n    }\n  }\n\n  return null;\n}\n\nfunction discoverInDirectory(\n  dir: string,\n  source: ExtensionSourceOrigin,\n  discovered: Map<string, DiscoveredExtension>,\n): void {\n  if (!existsSync(dir)) {\n    return;\n  }\n\n  let entries: string[];\n  try {\n    entries = readdirSync(dir);\n  } catch {\n    return;\n  }\n\n  for (const entry of entries) {\n    const extensionPath = join(dir, entry);\n\n    try {\n      if (!existsSync(extensionPath)) continue;\n    } catch {\n      continue;\n    }\n\n    const manifest = loadManifest(extensionPath);\n    if (!manifest) continue;\n\n    const extensionId = manifest.id || entry;\n\n    const existing = discovered.get(extensionId);\n    if (existing) {\n      const priority = { workspace: 3, global: 2, bundled: 1, config: 0 };\n      if (priority[source] <= priority[existing.source]) {\n        log.debug(\n          { extensionId, from: source, existing: existing.source },\n          'Skipping lower priority extension',\n        );\n        continue;\n      }\n      log.info(\n        { extensionId, from: source, overriding: existing.source },\n        'Extension override by higher priority source',\n      );\n    }\n\n    discovered.set(extensionId, {\n      id: extensionId,\n      path: extensionPath,\n      source,\n      manifest,\n    });\n  }\n}\n\nfunction resolveDiscoveryPaths(\n  options: ExtensionLoaderOptions,\n  config?: DiscoverConfig,\n): {\n  bundledDir: string | null;\n  globalDir: string;\n  workspaceExtensionsDir: string | null;\n} {\n  const cfg = config ? asSchemaConfig(config) : null;\n  const aid = cfg ? resolveDefaultAgentId(cfg) : null;\n\n  return {\n    bundledDir: resolveBundledExtensionsDir(),\n    globalDir: options.extensionsDir ?? resolveExtensionsDir(),\n    workspaceExtensionsDir:\n      options.workspaceExtensionsDir ??\n      (cfg && aid ? resolveWorkspaceExtensionsDir(cfg, aid) : null),\n  };\n}\n\n/**\n * Discover extensions from workspace, global, and bundled tiers without loading code.\n */\nexport function discoverExtensionsFromDisk(\n  options: ExtensionLoaderOptions = {},\n  config?: DiscoverConfig,\n): DiscoveredExtension[] {\n  const discovered = new Map<string, DiscoveredExtension>();\n  const paths = resolveDiscoveryPaths(options, config);\n\n  if (paths.bundledDir) {\n    discoverInDirectory(paths.bundledDir, 'bundled', discovered);\n  }\n\n  // Electron ships self-contained extension bundles. Do not let stale user/global source\n  // extensions override those packaged manifests.\n  if (process.env.XOPC_BUNDLED_EXTENSIONS_ROOT || paths.bundledDir?.includes(`${join('dist', 'electron', 'extensions')}`)) {\n    return Array.from(discovered.values());\n  }\n\n  discoverInDirectory(paths.globalDir, 'global', discovered);\n  if (paths.workspaceExtensionsDir) {\n    discoverInDirectory(paths.workspaceExtensionsDir, 'workspace', discovered);\n  }\n\n  return Array.from(discovered.values());\n}\n\n/** True when extension discovery/load should be skipped entirely. */\nexport function areExtensionsGloballyDisabled(config?: DiscoverConfig): boolean {\n  if (\n    process.env.XOPC_SKIP_EXTENSIONS === '1' ||\n    process.env.XOPC_SKIP_EXTENSIONS === 'true'\n  ) {\n    return true;\n  }\n\n  const ext =\n    config && isRecord(config) && isRecord((config as Record<string, unknown>).extensions)\n      ? ((config as Record<string, unknown>).extensions as Record<string, unknown>)\n      : undefined;\n\n  return ext?.enabled === false;\n}\n"],"mappings":"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"}

package/dist/src/extensions/health.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { getExtensionLockfileManager } from "./lockfile.js";
-import { readFile, readdir } from "fs/promises";
 import { join } from "path";
 import { existsSync } from "fs";
+import { readFile, readdir } from "fs/promises";
 //#region src/extensions/health.ts
 init_paths();
 var ExtensionHealthChecker = class {

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

@@ -24,6 +24,7 @@ export interface ListedExtension {
     path: string;
     origin: 'workspace' | 'global' | 'bundled';
 }
+export declare function peekExtensionManifestFromStoreZip(buffer: Buffer): Record<string, unknown> | undefined;
 /** Read `id` from the shallowest xopc.extension.json in a store zip (for --force / preflight). */
 export declare function peekExtensionIdFromStoreZip(buffer: Buffer): string | undefined;
 /**

package/dist/src/extensions/install.js

@@ -1,6 +1,9 @@
+import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir as resolveExtensionsDir$1 } from "../config/paths.js";
+import { checkEngineCompatibility } from "./engine-check.js";
+import { collectExtensionPackageDependencyIssues } from "./package-contract.js";
 import { MAX_EXTENSION_STORE_ZIP_BYTES } from "./store-zip-limits.js";
 import { dirname, isAbsolute, join, resolve, sep } from "path";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
@@ -14,6 +17,7 @@ import AdmZip from "adm-zip";
 * Supports three-tier storage: workspace, global, bundled
 */
 init_paths();
+init_package_version();
 init_logger();
 const log = createLogger("ExtensionInstall");
 const NPM_INSTALL_ENV = process.env.XOPC_EXTENSION_NPM_INSTALL?.trim().toLowerCase();
@@ -111,8 +115,7 @@ function inferExtensionStripPrefix(primaryManifestPath) {
 	if (!lower.endsWith(suff)) return "";
 	return norm.slice(0, norm.length - 19);
 }
-/** Read `id` from the shallowest xopc.extension.json in a store zip (for --force / preflight). */
-function peekExtensionIdFromStoreZip(buffer) {
+function readShallowestExtensionManifestFromZip(buffer) {
 	if (buffer.length > 10485760) return void 0;
 	let zip;
 	try {
@@ -129,14 +132,22 @@ function peekExtensionIdFromStoreZip(buffer) {
 	if (!entry) return void 0;
 	try {
 		const raw = entry.getData().toString("utf8");
-		const m = JSON.parse(raw);
-		const id = typeof m.id === "string" ? m.id.trim() : "";
-		if (!id || id.includes("/") || id.includes("\\")) return void 0;
-		return id;
+		const parsed = JSON.parse(raw);
+		return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
 	} catch {
 		return;
 	}
 }
+function peekExtensionManifestFromStoreZip(buffer) {
+	return readShallowestExtensionManifestFromZip(buffer);
+}
+/** Read `id` from the shallowest xopc.extension.json in a store zip (for --force / preflight). */
+function peekExtensionIdFromStoreZip(buffer) {
+	const m = readShallowestExtensionManifestFromZip(buffer);
+	const id = typeof m?.id === "string" ? m.id.trim() : "";
+	if (!id || id.includes("/") || id.includes("\\")) return void 0;
+	return id;
+}
 /**
 * Install an extension from an xopc-store zip buffer (layout: manifest at archive root
 * or under a single top-level folder).
@@ -293,6 +304,13 @@ async function installFromDirectory(sourceDir, extensionsDir) {
 	if (existsSync(packagePath)) try {
 		packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
 	} catch {}
+	if (packageJson) {
+		const packageIssues = collectExtensionPackageDependencyIssues(packageJson, { strictRuntimeSdkDeps: true });
+		if (packageIssues.length > 0) return {
+			ok: false,
+			error: `Extension package is not installable as an independent package:\n${packageIssues.map((issue) => `- ${issue.message}`).join("\n")}`
+		};
+	}
 	const extensionId = manifest?.id || packageJson?.name;
 	if (!extensionId) return {
 		ok: false,
@@ -307,7 +325,32 @@ async function installFromDirectory(sourceDir, extensionsDir) {
 		ok: false,
 		error: `Extension already exists at ${targetDir}. Use update instead.`
 	};
-	const mainFile = manifest?.main || "index.js";
+	if (!manifest) return {
+		ok: false,
+		error: "Extension must include xopc.extension.json"
+	};
+	if (!manifest.engines?.xopc) return {
+		ok: false,
+		error: "Extension manifest must declare engines.xopc"
+	};
+	const engineCheck = checkEngineCompatibility(PACKAGE_VERSION, manifest.engines.xopc);
+	if (engineCheck.parseWarning) return {
+		ok: false,
+		error: engineCheck.reason ?? `Could not parse engines.xopc ${manifest.engines.xopc}`
+	};
+	if (!engineCheck.compatible) return {
+		ok: false,
+		error: engineCheck.reason ?? `xopc ${PACKAGE_VERSION} does not satisfy engines.xopc ${manifest.engines.xopc}`
+	};
+	if (!manifest.main) return {
+		ok: false,
+		error: "Extension manifest must declare main"
+	};
+	if (!/\.(mjs|cjs|js)$/i.test(manifest.main)) return {
+		ok: false,
+		error: `Extension main must point at built JavaScript (.js/.mjs/.cjs), got: ${manifest.main}`
+	};
+	const mainFile = manifest.main;
 	if (!existsSync(join(sourceDir, mainFile))) return {
 		ok: false,
 		error: `Main entry not found: ${mainFile}`
@@ -467,6 +510,6 @@ function readManifest(extensionDir) {
 	}
 }
 //#endregion
-export { installExtensionFromStoreZip, installFromLocal, installFromNpm, listAllExtensions, peekExtensionIdFromStoreZip, removeExtension, resolveExtensionsDir };
+export { installExtensionFromStoreZip, installFromLocal, installFromNpm, listAllExtensions, peekExtensionIdFromStoreZip, peekExtensionManifestFromStoreZip, removeExtension, resolveExtensionsDir };
 
 //# sourceMappingURL=install.js.map