@xopcai/xopc 0.0.82 → 0.0.84

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

@@ -0,0 +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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"}

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/index.js

@@ -1,12 +1,13 @@
 import { HOOK_EXECUTION_MODES } from "./types/hooks.js";
 import { BUILTIN_PROVIDERS } from "./types/providers.js";
+import { ExtensionRegistryImpl } from "./extension-registry-impl.js";
+import { ExtensionApiImpl, createExtensionLogger, createPathResolver } from "./api.js";
 import { ActivationPlanner } from "./activation-planner.js";
 import { collectConfiguredChannelIds, collectConfiguredProviderIds, mergeActivationContext } from "./activation-context.js";
 import { normalizeExtensionManifest } from "./normalize-manifest.js";
 import { areExtensionsGloballyDisabled, discoverExtensionsFromDisk } from "./discover-extensions.js";
 import { ManifestRegistry } from "./manifest-registry.js";
-import { ExtensionLoader, ExtensionRegistryImpl, normalizeExtensionConfig, resolveExtensionPath } from "./loader.js";
-import { ExtensionApiImpl, createExtensionLogger, createPathResolver } from "./api.js";
+import { ExtensionLoader, normalizeExtensionConfig, resolveExtensionPath } from "./loader.js";
 import { listOnboardChannels, listOnboardProviders, resolveProviderForModel } from "./onboard-helpers.js";
 import { buildExtensionMetadataSnapshot, resolveExtensionLoaderOptionsFromConfig } from "./extension-metadata-snapshot.js";
 import { ExtensionHookRunner, createHookContext, isHookEvent } from "./hooks.js";

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

@@ -9,60 +9,20 @@
 import type { Config } from '../config/config-surface.js';
 import type { MessageBus } from '../infra/bus/index.js';
 import type { SessionIndex } from '../session/manager.js';
-import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { ExtensionApi, ExtensionRegistry, ExtensionCliRegistration, GatewayMethodHandler, HttpRequestHandler, ExtensionCommand, ExtensionReloadRegistration, ExtensionService, ExtensionHookEvent, ExtensionHookHandler, ExtensionManifest, ExtensionRecord, ResolvedExtensionConfig, DiscoveredExtension, TuiExtensionRegistration, TuiExtensionRegistrar } from './types/index.js';
+import type { ExtensionApi, ExtensionManifest, ResolvedExtensionConfig, DiscoveredExtension } from './types/index.js';
 import type { ActivationContext } from './activation-planner.js';
 import { ActivationPlanner, type ActivationLoadPhase } from './activation-planner.js';
 import { type ExtensionLoaderOptions } from './discover-extensions.js';
 import type { ExtensionMetadataSnapshot } from './extension-metadata-snapshot.js';
 import { ManifestRegistry } from './manifest-registry.js';
-import type { ChannelPlugin } from '../channels/plugin-types.js';
 import { type SecurityConfig } from './security.js';
 import { type ProviderPluginRegistry } from '../providers/plugin-registry.js';
 import { type SlotRegistry } from './slots.js';
 import { type ExtensionDiagnostics } from './diagnostics.js';
 export type { ExtensionLoaderOptions, ExtensionSourceOrigin } from './discover-extensions.js';
 export { areExtensionsGloballyDisabled } from './discover-extensions.js';
-export declare class ExtensionRegistryImpl implements ExtensionRegistry {
-    extensions: Map<string, ExtensionRecord>;
-    hooks: Map<ExtensionHookEvent, ExtensionHookHandler[]>;
-    httpRoutes: Map<string, HttpRequestHandler>;
-    commands: Map<string, ExtensionCommand>;
-    services: Map<string, ExtensionService>;
-    gatewayMethods: Map<string, GatewayMethodHandler>;
-    tools: Map<string, AgentTool<any, any>>;
-    channelPlugins: ChannelPlugin[];
-    private cliRegistrations;
-    private reloadRegistrations;
-    private tuiRegistrations;
-    addExtension(record: ExtensionRecord): void;
-    getExtension(id: string): ExtensionRecord | undefined;
-    getEnabledExtensions(): ExtensionRecord[];
-    addHook(event: ExtensionHookEvent, handler: ExtensionHookHandler, extensionId: string, _priority?: number): void;
-    getHooks(event: ExtensionHookEvent): ExtensionHookHandler[];
-    addChannelPlugin(plugin: ChannelPlugin): void;
-    addHttpRoute(path: string, handler: HttpRequestHandler): void;
-    getHttpRoute(path: string): HttpRequestHandler | undefined;
-    addCommand(command: ExtensionCommand): void;
-    getCommand(name: string): ExtensionCommand | undefined;
-    addService(service: ExtensionService): void;
-    getService(id: string): ExtensionService | undefined;
-    addGatewayMethod(method: string, handler: GatewayMethodHandler): void;
-    getGatewayMethod(method: string): GatewayMethodHandler | undefined;
-    addTool(tool: any): void;
-    removeTool(name: string): void;
-    getTools(): Map<string, any>;
-    getTool(name: string): any | undefined;
-    getAllTools(): any[];
-    addCliRegistration(reg: ExtensionCliRegistration): void;
-    getCliRegistrations(): readonly ExtensionCliRegistration[];
-    addTuiRegistration(extensionId: string, register: TuiExtensionRegistrar): void;
-    getTuiRegistrations(): readonly TuiExtensionRegistration[];
-    addReloadRegistration(reg: ExtensionReloadRegistration): void;
-    removeReloadRegistration(extensionId: string): void;
-    getReloadRegistrations(): readonly ExtensionReloadRegistration[];
-    getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[];
-}
+export { ExtensionRegistryImpl } from './extension-registry-impl.js';
+import { ExtensionRegistryImpl } from './extension-registry-impl.js';
 export interface ActivationPlanLoadOptions extends Partial<ActivationContext> {
     phase?: ActivationLoadPhase | 'all';
 }

package/dist/src/extensions/loader.js

@@ -1,10 +1,12 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_agent_scope, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { createLogger, createServiceLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_agent_scope, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_paths, resolveBundledExtensionsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
 import { getProviderRegistry, init_plugin_registry } from "../providers/plugin-registry.js";
+import { ExtensionRegistryImpl } from "./extension-registry-impl.js";
+import { ExtensionApiImpl, createExtensionLogger, createPathResolver } from "./api.js";
 import { ActivationPlanner } from "./activation-planner.js";
 import { mergeActivationContext } from "./activation-context.js";
 import { normalizeExtensionManifest } from "./normalize-manifest.js";
@@ -18,7 +20,6 @@ import { validateMediaUnderstandingProviderContracts } from "./media-provider-co
 import { DEFAULT_SECURITY_CONFIG, checkExtensionPathSafety, isExtensionAllowed, logSecurityIssue, provenanceTracker } from "./security.js";
 import { getSlotRegistry } from "./slots.js";
 import { getExtensionCache, getExtensionDiagnostics } from "./diagnostics.js";
-import { ExtensionApiImpl, createExtensionLogger, createPathResolver } from "./api.js";
 import { createRequire } from "node:module";
 import { dirname, isAbsolute, join } from "path";
 import { existsSync, readFileSync } from "fs";
@@ -54,114 +55,6 @@ async function mapWithConcurrency(items, concurrency, fn) {
 		}
 	}));
 }
-var ExtensionRegistryImpl = class {
-	extensions = /* @__PURE__ */ new Map();
-	hooks = /* @__PURE__ */ new Map();
-	httpRoutes = /* @__PURE__ */ new Map();
-	commands = /* @__PURE__ */ new Map();
-	services = /* @__PURE__ */ new Map();
-	gatewayMethods = /* @__PURE__ */ new Map();
-	tools = /* @__PURE__ */ new Map();
-	channelPlugins = [];
-	cliRegistrations = [];
-	reloadRegistrations = [];
-	tuiRegistrations = [];
-	addExtension(record) {
-		this.extensions.set(record.id, record);
-	}
-	getExtension(id) {
-		return this.extensions.get(id);
-	}
-	getEnabledExtensions() {
-		return Array.from(this.extensions.values()).filter((p) => p.enabled);
-	}
-	addHook(event, handler, extensionId, _priority = 0) {
-		if (!this.hooks.has(event)) this.hooks.set(event, []);
-		this.hooks.get(event).push(handler);
-	}
-	getHooks(event) {
-		return this.hooks.get(event) || [];
-	}
-	addChannelPlugin(plugin) {
-		this.channelPlugins = this.channelPlugins.filter((p) => p.id !== plugin.id);
-		this.channelPlugins.push(plugin);
-	}
-	addHttpRoute(path, handler) {
-		if (this.httpRoutes.has(path)) log.warn({ path }, `HTTP route already registered, overwriting`);
-		this.httpRoutes.set(path, handler);
-	}
-	getHttpRoute(path) {
-		return this.httpRoutes.get(path);
-	}
-	addCommand(command) {
-		if (this.commands.has(command.name)) log.warn({ command: command.name }, `Command already registered, overwriting`);
-		this.commands.set(command.name, command);
-	}
-	getCommand(name) {
-		return this.commands.get(name);
-	}
-	addService(service) {
-		if (this.services.has(service.id)) log.warn({ service: service.id }, `Service already registered, overwriting`);
-		this.services.set(service.id, service);
-	}
-	getService(id) {
-		return this.services.get(id);
-	}
-	addGatewayMethod(method, handler) {
-		if (this.gatewayMethods.has(method)) log.warn({ method }, `Gateway method already registered, overwriting`);
-		this.gatewayMethods.set(method, handler);
-	}
-	getGatewayMethod(method) {
-		return this.gatewayMethods.get(method);
-	}
-	addTool(tool) {
-		if (this.tools.has(tool.name)) log.warn({ tool: tool.name }, `Tool already registered, overwriting`);
-		this.tools.set(tool.name, tool);
-	}
-	removeTool(name) {
-		this.tools.delete(name);
-	}
-	getTools() {
-		return this.tools;
-	}
-	getTool(name) {
-		return this.tools.get(name);
-	}
-	getAllTools() {
-		return Array.from(this.tools.values());
-	}
-	addCliRegistration(reg) {
-		this.cliRegistrations.push(reg);
-	}
-	getCliRegistrations() {
-		return this.cliRegistrations;
-	}
-	addTuiRegistration(extensionId, register) {
-		this.tuiRegistrations.push({
-			extensionId,
-			register
-		});
-	}
-	getTuiRegistrations() {
-		return this.tuiRegistrations;
-	}
-	addReloadRegistration(reg) {
-		this.reloadRegistrations = this.reloadRegistrations.filter((r) => r.extensionId !== reg.extensionId);
-		this.reloadRegistrations.push(reg);
-	}
-	removeReloadRegistration(extensionId) {
-		this.reloadRegistrations = this.reloadRegistrations.filter((r) => r.extensionId !== extensionId);
-	}
-	getReloadRegistrations() {
-		return this.reloadRegistrations;
-	}
-	getMatchingReloadRegistrations(changedPaths) {
-		return this.reloadRegistrations.filter((reg) => {
-			if (reg.configPrefixes.length === 0) return true;
-			return reg.configPrefixes.some((prefix) => changedPaths.some((path) => path === prefix || path.startsWith(`${prefix}.`)));
-		});
-	}
-};
 var ExtensionLoader = class {
 	registry;
 	options;

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 } from 'node:url';\nimport { createRequire } from 'node:module';\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  ExtensionRegistry,\n  ExtensionCliRegistration,\n  GatewayMethodHandler,\n  HttpRequestHandler,\n  ExtensionCommand,\n  ExtensionReloadRegistration,\n  ExtensionService,\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  ExtensionManifest,\n  ExtensionRecord,\n  ResolvedExtensionConfig,\n  DiscoveredExtension,\n  TuiExtensionRegistration,\n  TuiExtensionRegistrar,\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 type { ChannelPlugin } from '../channels/plugin-types.js';\nimport { bundledChannelPlugins } from '../channels/plugins/bundled.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\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\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  };\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    for (const p of bundledChannelPlugins) {\n      this.registry.addChannelPlugin(p);\n    }\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 alias for extension-sdk (+ subpath entry points)\n    const alias: Record<string, string> = {};\n    const sdkPath = resolveExtensionSdkPath();\n    if (sdkPath) {\n      alias['xopc/extension-sdk'] = sdkPath;\n      const sdkDir = dirname(sdkPath);\n      alias['xopc/extension-sdk/core'] = join(sdkDir, 'core.ts');\n      alias['xopc/extension-sdk/lazy'] = join(sdkDir, 'lazy.ts');\n      alias['xopc/extension-sdk/provider'] = join(sdkDir, 'provider.ts');\n      alias['xopc/extension-sdk/channel'] = join(sdkDir, 'channel.ts');\n      alias['xopc/extension-sdk/hooks'] = join(sdkDir, 'hooks.ts');\n      alias['xopc/extension-sdk/tools'] = join(sdkDir, 'tools.ts');\n      alias['xopc/extension-sdk/testing'] = join(sdkDir, 'testing.ts');\n      alias['xopc/extension-sdk/speech'] = join(sdkDir, 'speech.ts');\n      alias['xopc/extension-sdk/media'] = join(sdkDir, 'media.ts');\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  }): 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.engines?.xopc) {\n        const range = manifest.engines.xopc;\n        const engineResult = checkEngineCompatibility(PACKAGE_VERSION, range);\n        if (engineResult.parseWarning) {\n          log.warn(\n            { extensionId: config.id, range, reason: engineResult.reason },\n            'Engine range parse warning — loading anyway',\n          );\n        } else 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\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      'image-generation': 'imageGeneration',\n      'imageGeneration': 'imageGeneration',\n      'web-search': 'webSearch',\n      'webSearch': '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    // Fallback to package.json\n    const packagePath = join(extensionPath, 'package.json');\n    if (existsSync(packagePath)) {\n      try {\n        const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n        \n        // Check for xopc.extension marker\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        // Also support xopc-extension-* naming convention\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\n  /**\n   * Build candidate extension entry paths. After `tsdown`, manifests may still\n   * point at `*.ts` while the shipped tree only contains the emitted `*.js`.\n   */\n  private moduleEntryCandidates(manifest: ExtensionManifest): string[] {\n    const raw = [\n      manifest.main,\n      'index.ts',\n      'index.js',\n      'extension.ts',\n      'extension.js',\n    ].filter(Boolean) as string[];\n\n    const out: string[] = [];\n    for (const entry of raw) {\n      out.push(entry);\n      if (entry.endsWith('.tsx')) {\n        out.push(`${entry.slice(0, -4)}.js`);\n      } else if (entry.endsWith('.ts')) {\n        out.push(`${entry.slice(0, -3)}.js`);\n      } else if (entry.endsWith('.mts')) {\n        out.push(`${entry.slice(0, -4)}.mjs`);\n      } else if (entry.endsWith('.cts')) {\n        out.push(`${entry.slice(0, -4)}.cjs`);\n      }\n    }\n    return [...new Set(out)];\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            const require = createRequire(import.meta.url);\n            const mod = require(fullPath);\n            return mod.default || mod;\n          }\n          const mod = this.jiti(fullPath);\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          }\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      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  // Check if it's an npm package\n  try {\n    const require = createRequire(import.meta.url);\n    const resolved = require.resolve(id);\n    return dirname(resolved);\n  } catch {\n    return null;\n  }\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 } from 'node:url';\nimport { createRequire } from 'node:module';\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 { bundledChannelPlugins } from '../channels/plugins/bundled.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  };\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    for (const p of bundledChannelPlugins) {\n      this.registry.addChannelPlugin(p);\n    }\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 alias for extension-sdk (+ subpath entry points)\n    const alias: Record<string, string> = {};\n    const sdkPath = resolveExtensionSdkPath();\n    if (sdkPath) {\n      alias['xopc/extension-sdk'] = sdkPath;\n      const sdkDir = dirname(sdkPath);\n      alias['xopc/extension-sdk/core'] = join(sdkDir, 'core.ts');\n      alias['xopc/extension-sdk/lazy'] = join(sdkDir, 'lazy.ts');\n      alias['xopc/extension-sdk/provider'] = join(sdkDir, 'provider.ts');\n      alias['xopc/extension-sdk/channel'] = join(sdkDir, 'channel.ts');\n      alias['xopc/extension-sdk/hooks'] = join(sdkDir, 'hooks.ts');\n      alias['xopc/extension-sdk/tools'] = join(sdkDir, 'tools.ts');\n      alias['xopc/extension-sdk/testing'] = join(sdkDir, 'testing.ts');\n      alias['xopc/extension-sdk/speech'] = join(sdkDir, 'speech.ts');\n      alias['xopc/extension-sdk/media'] = join(sdkDir, 'media.ts');\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  }): 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.engines?.xopc) {\n        const range = manifest.engines.xopc;\n        const engineResult = checkEngineCompatibility(PACKAGE_VERSION, range);\n        if (engineResult.parseWarning) {\n          log.warn(\n            { extensionId: config.id, range, reason: engineResult.reason },\n            'Engine range parse warning — loading anyway',\n          );\n        } else 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\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      'image-generation': 'imageGeneration',\n      'imageGeneration': 'imageGeneration',\n      'web-search': 'webSearch',\n      'webSearch': '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    // Fallback to package.json\n    const packagePath = join(extensionPath, 'package.json');\n    if (existsSync(packagePath)) {\n      try {\n        const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n        \n        // Check for xopc.extension marker\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        // Also support xopc-extension-* naming convention\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\n  /**\n   * Build candidate extension entry paths. After `tsdown`, manifests may still\n   * point at `*.ts` while the shipped tree only contains the emitted `*.js`.\n   */\n  private moduleEntryCandidates(manifest: ExtensionManifest): string[] {\n    const raw = [\n      manifest.main,\n      'index.ts',\n      'index.js',\n      'extension.ts',\n      'extension.js',\n    ].filter(Boolean) as string[];\n\n    const out: string[] = [];\n    for (const entry of raw) {\n      out.push(entry);\n      if (entry.endsWith('.tsx')) {\n        out.push(`${entry.slice(0, -4)}.js`);\n      } else if (entry.endsWith('.ts')) {\n        out.push(`${entry.slice(0, -3)}.js`);\n      } else if (entry.endsWith('.mts')) {\n        out.push(`${entry.slice(0, -4)}.mjs`);\n      } else if (entry.endsWith('.cts')) {\n        out.push(`${entry.slice(0, -4)}.cjs`);\n      }\n    }\n    return [...new Set(out)];\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            const require = createRequire(import.meta.url);\n            const mod = require(fullPath);\n            return mod.default || mod;\n          }\n          const mod = this.jiti(fullPath);\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          }\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      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  // Check if it's an npm package\n  try {\n    const require = createRequire(import.meta.url);\n    const resolved = require.resolve(id);\n    return dirname(resolved);\n  } catch {\n    return null;\n  }\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/lockfile.js

@@ -1,10 +1,10 @@
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveExtensionsDir, resolveExtensionsLockPath } from "../config/paths.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { mkdir, readFile } from "fs/promises";
 import { dirname, join } from "path";
 import { existsSync } from "fs";
-import { mkdir, readFile } from "fs/promises";
 import { createHash } from "crypto";
 //#region src/extensions/lockfile.ts
 init_write_file_atomic();

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

@@ -1,11 +1,12 @@
 import { ProviderPluginRegistry, getProviderRegistry, init_plugin_registry } from "../../providers/plugin-registry.js";
 import { HOOK_EXECUTION_MODES } from "../types/hooks.js";
 import { TypedEventBus } from "../typed-event-bus.js";
+import { ExtensionRegistryImpl } from "../extension-registry-impl.js";
 import { defineChannelPluginEntry } from "./channel-entry.js";
 import { DEFAULT_SECURITY_CONFIG, checkExtensionDirSafety, checkExtensionPathSafety, isExtensionAllowed, logSecurityIssue, provenanceTracker } from "../security.js";
 import { SlotRegistry, getSlotRegistry, registerSlotType } from "../slots.js";
 import { ExtensionDiagnostics, ExtensionLoaderCacheImpl, getExtensionCache, getExtensionDiagnostics } from "../diagnostics.js";
-import { ExtensionRegistryImpl } from "../loader.js";
+import "../loader.js";
 import { ExtensionHookRunner, createHookContext, isHookEvent } from "../hooks.js";
 import { registerExtensionCliProgram } from "./channel-helpers.js";
 import { lazyFunction, lazyModule } from "./lazy.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/extensions/sdk/index.ts"],"sourcesContent":["/**\n * xopc Extension SDK\n * \n * Official SDK for developing xopc extensions.\n * Import types and utilities from this module:\n * \n * @example\n * import type { ExtensionApi, ExtensionDefinition } from 'xopc/extension-sdk';\n */\n\n// ============================================================================\n// Core extension types\n// ============================================================================\n\nexport type {\n  ExtensionDefinition,\n  ExtensionModule,\n  ExtensionKind,\n  ExtensionApi,\n  ExtensionLogger,\n  ExtensionManifest,\n  ExtensionRecord,\n  ExtensionRegistry,\n  ResolvedExtensionConfig,\n  ExtensionRuntime,\n  ExtensionCliRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Tools (re-exported from @earendil-works/pi-agent-core)\n// ============================================================================\n\nexport type {\n  AgentTool,\n  AgentToolResult,\n  AgentToolUpdateCallback,\n  ToolExecutionStartEvent,\n  ToolExecutionUpdateEvent,\n  ToolExecutionEndEvent,\n} from '../types/index.js';\n\n// ============================================================================\n// Hooks ( Strongly Typed)\n// ============================================================================\n\nexport type {\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  HookOptions,\n  HookAgentContext,\n  AgentMessage,\n  ContextEvent,\n  ContextResult,\n  InputEvent,\n  InputResult,\n  TurnEvent,\n  TurnResult,\n  //  New hook types\n  HookHandlerMap,\n  HookExecutionMode,\n  // Note: HOOK_EXECUTION_MODES is exported as value below\n  //  LLM observation hooks\n  HookBeforeModelResolveEvent,\n  HookBeforeModelResolveResult,\n  HookBeforePromptBuildEvent,\n  HookBeforePromptBuildResult,\n  HookLlmInputEvent,\n  HookLlmOutputEvent,\n  //  Inbound claim\n  HookInboundClaimEvent,\n  HookInboundClaimResult,\n  //  Reset hook\n  HookBeforeResetEvent,\n  HookBeforeResetResult,\n  //  Message write hook\n  HookBeforeMessageWriteEvent,\n  HookBeforeMessageWriteResult,\n  //  Turn hooks\n  HookTurnStartEvent,\n  HookTurnEndEvent,\n  //  Tool execution hooks\n  HookToolExecutionStartEvent,\n  HookToolExecutionUpdateEvent,\n  HookToolExecutionEndEvent,\n  // Existing context types\n  HookContext,\n  BeforeAgentStartContext,\n  BeforeAgentStartResult,\n  AgentEndContext,\n  WebchatTurnCompleteEvent,\n  BeforeCompactionContext,\n  AfterCompactionContext,\n  MessageReceivedContext,\n  MessageSendingContext,\n  MessageSendingResult,\n  MessageSentContext,\n  BeforeToolCallContext,\n  BeforeToolCallResult,\n  AfterToolCallContext,\n  SessionStartContext,\n  SessionEndContext,\n  GatewayStartContext,\n  GatewayStopContext,\n} from '../types/index.js';\n\n// ============================================================================\n//  Typed Event Bus\n// ============================================================================\n\nexport type {\n  EventMap,\n  RequestMap,\n  EventHandler,\n  EventHandlerMeta,\n  RequestHandler,\n  RequestHandlerMeta,\n  WildcardEventHandler,\n  WildcardHandlerMeta,\n  TypedEventBusOptions,\n  RequestOptions,\n} from '../types/index.js';\n\n// ============================================================================\n//  Provider Types\n// ============================================================================\n\nexport type {\n  ProviderPlugin,\n  ProviderModelDefinition,\n  ProviderCapabilities,\n  ProviderStreamParams,\n  ProviderStreamChunk,\n  ProviderCompleteParams,\n  ProviderResponse,\n  ProviderRegistry,\n  BUILTIN_PROVIDERS,\n  BuiltinProviderId,\n} from '../types/index.js';\n\n// ============================================================================\n//  Advanced Features\n// ============================================================================\n\nexport type {\n  ProviderConfig,\n  ModelConfig,\n  OAuthConfig,\n  OAuthCallbacks,\n  OAuthCredentials,\n  FlagConfig,\n  FlagValue,\n  ShortcutConfig,\n  ShortcutHandler,\n} from '../types/index.js';\n\nexport type {\n  TuiExtensionHostContract,\n  TuiExtensionRegistrar,\n  TuiAutocompleteProvider,\n  TuiAutocompleteSuggestion,\n  TuiToolRenderer,\n  TuiToolRenderContext,\n  TuiSlashCommandHandler,\n  TuiNotifyLevel,\n} from '../types/index.js';\n\n// ============================================================================\n//  Security Types\n// ============================================================================\n\nexport type {\n  SafetyCheckResult,\n  SecurityConfig,\n  ExtensionSourceOrigin,\n  ProvenanceInfo,\n} from '../security.js';\n\n// ============================================================================\n//  Slot Types\n// ============================================================================\n\nexport type {\n  SlotKey,\n  SlotClaim,\n  SlotConfig,\n} from '../slots.js';\n\n// ============================================================================\n//  Diagnostics Types\n// ============================================================================\n\nexport type {\n  DiagnosticLevel,\n  ExtensionDiagnostic,\n  ExtensionLoaderCache,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Channels (ChannelPlugin registry)\n// ============================================================================\n\nexport type {\n  ChannelPlugin,\n  ChannelPluginInitOptions,\n  ChannelPluginStartOptions,\n} from '../../channels/plugin-types.js';\n\n// ============================================================================\n// HTTP\n// ============================================================================\n\nexport type {\n  HttpRequestHandler,\n  HttpRequest,\n  HttpResponse,\n} from '../types/index.js';\n\n// ============================================================================\n// Commands\n// ============================================================================\n\nexport type {\n  ExtensionCommand,\n  ExtensionCommandHandler,\n  ExtensionCommandContext,\n  ExtensionCommandResult,\n  ExtensionReloadHandler,\n  ExtensionReloadResult,\n  ExtensionReloadRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport type {\n  ExtensionService,\n} from '../types/index.js';\n\n// ============================================================================\n// Gateway\n// ============================================================================\n\nexport type {\n  GatewayMethodHandler,\n} from '../types/index.js';\n\n// ============================================================================\n// Export Classes\n// ============================================================================\n\nexport { TypedEventBus } from '../typed-event-bus.js';\nexport { ExtensionRegistryImpl } from '../loader.js';\nexport { ProviderPluginRegistry, getProviderRegistry } from '../../providers/plugin-registry.js';\nexport { SlotRegistry, getSlotRegistry, registerSlotType } from '../slots.js';\nexport { HOOK_EXECUTION_MODES } from '../types/hooks.js';\n\nexport { defineChannelPluginEntry } from './channel-entry.js';\nexport { registerExtensionCliProgram } from './channel-helpers.js';\n\n// ============================================================================\n// Export Hook Runner and Utilities\n// ============================================================================\n\nexport { \n  ExtensionHookRunner, \n  createHookContext, \n  isHookEvent \n} from '../hooks.js';\n\n// ============================================================================\n//  Security Utilities\n// ============================================================================\n\nexport {\n  checkExtensionPathSafety,\n  checkExtensionDirSafety,\n  isExtensionAllowed,\n  provenanceTracker,\n  logSecurityIssue,\n  DEFAULT_SECURITY_CONFIG,\n} from '../security.js';\n\n// ============================================================================\n//  Diagnostics Utilities\n// ============================================================================\n\nexport {\n  getExtensionCache,\n  getExtensionDiagnostics,\n  ExtensionLoaderCacheImpl,\n  ExtensionDiagnostics,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Config\n// ============================================================================\n\nexport type { Config } from '../../config/config-surface.js';\n\n// Subpath barrels (also available as `xopc/extension-sdk/<name>`)\nexport { lazyModule, lazyFunction } from './lazy.js';\n\nexport { createMockExtensionApi, createTestGateway } from './testing.js';\nexport type {\n  MockExtensionApi,\n  MockExtensionApiOptions,\n  TestGateway,\n} from './testing.js';\n"],"mappings":";;;;;;;;;;;;;sBA6PiG"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/extensions/sdk/index.ts"],"sourcesContent":["/**\n * xopc Extension SDK\n * \n * Official SDK for developing xopc extensions.\n * Import types and utilities from this module:\n * \n * @example\n * import type { ExtensionApi, ExtensionDefinition } from 'xopc/extension-sdk';\n */\n\n// ============================================================================\n// Core extension types\n// ============================================================================\n\nexport type {\n  ExtensionDefinition,\n  ExtensionModule,\n  ExtensionKind,\n  ExtensionApi,\n  ExtensionLogger,\n  ExtensionManifest,\n  ExtensionRecord,\n  ExtensionRegistry,\n  ResolvedExtensionConfig,\n  ExtensionRuntime,\n  ExtensionCliRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Tools (re-exported from @earendil-works/pi-agent-core)\n// ============================================================================\n\nexport type {\n  AgentTool,\n  AgentToolResult,\n  AgentToolUpdateCallback,\n  ToolExecutionStartEvent,\n  ToolExecutionUpdateEvent,\n  ToolExecutionEndEvent,\n} from '../types/index.js';\n\n// ============================================================================\n// Hooks ( Strongly Typed)\n// ============================================================================\n\nexport type {\n  ExtensionHookEvent,\n  ExtensionHookHandler,\n  HookOptions,\n  HookAgentContext,\n  AgentMessage,\n  ContextEvent,\n  ContextResult,\n  InputEvent,\n  InputResult,\n  TurnEvent,\n  TurnResult,\n  //  New hook types\n  HookHandlerMap,\n  HookExecutionMode,\n  // Note: HOOK_EXECUTION_MODES is exported as value below\n  //  LLM observation hooks\n  HookBeforeModelResolveEvent,\n  HookBeforeModelResolveResult,\n  HookBeforePromptBuildEvent,\n  HookBeforePromptBuildResult,\n  HookLlmInputEvent,\n  HookLlmOutputEvent,\n  //  Inbound claim\n  HookInboundClaimEvent,\n  HookInboundClaimResult,\n  //  Reset hook\n  HookBeforeResetEvent,\n  HookBeforeResetResult,\n  //  Message write hook\n  HookBeforeMessageWriteEvent,\n  HookBeforeMessageWriteResult,\n  //  Turn hooks\n  HookTurnStartEvent,\n  HookTurnEndEvent,\n  //  Tool execution hooks\n  HookToolExecutionStartEvent,\n  HookToolExecutionUpdateEvent,\n  HookToolExecutionEndEvent,\n  // Existing context types\n  HookContext,\n  BeforeAgentStartContext,\n  BeforeAgentStartResult,\n  AgentEndContext,\n  WebchatTurnCompleteEvent,\n  BeforeCompactionContext,\n  AfterCompactionContext,\n  MessageReceivedContext,\n  MessageSendingContext,\n  MessageSendingResult,\n  MessageSentContext,\n  BeforeToolCallContext,\n  BeforeToolCallResult,\n  AfterToolCallContext,\n  SessionStartContext,\n  SessionEndContext,\n  GatewayStartContext,\n  GatewayStopContext,\n} from '../types/index.js';\n\n// ============================================================================\n//  Typed Event Bus\n// ============================================================================\n\nexport type {\n  EventMap,\n  RequestMap,\n  EventHandler,\n  EventHandlerMeta,\n  RequestHandler,\n  RequestHandlerMeta,\n  WildcardEventHandler,\n  WildcardHandlerMeta,\n  TypedEventBusOptions,\n  RequestOptions,\n} from '../types/index.js';\n\n// ============================================================================\n//  Provider Types\n// ============================================================================\n\nexport type {\n  ProviderPlugin,\n  ProviderModelDefinition,\n  ProviderCapabilities,\n  ProviderStreamParams,\n  ProviderStreamChunk,\n  ProviderCompleteParams,\n  ProviderResponse,\n  ProviderRegistry,\n  BUILTIN_PROVIDERS,\n  BuiltinProviderId,\n} from '../types/index.js';\n\n// ============================================================================\n//  Advanced Features\n// ============================================================================\n\nexport type {\n  ProviderConfig,\n  ModelConfig,\n  OAuthConfig,\n  OAuthCallbacks,\n  OAuthCredentials,\n  FlagConfig,\n  FlagValue,\n  ShortcutConfig,\n  ShortcutHandler,\n} from '../types/index.js';\n\nexport type {\n  TuiExtensionHostContract,\n  TuiExtensionRegistrar,\n  TuiAutocompleteProvider,\n  TuiAutocompleteSuggestion,\n  TuiToolRenderer,\n  TuiToolRenderContext,\n  TuiSlashCommandHandler,\n  TuiNotifyLevel,\n} from '../types/index.js';\n\n// ============================================================================\n//  Security Types\n// ============================================================================\n\nexport type {\n  SafetyCheckResult,\n  SecurityConfig,\n  ExtensionSourceOrigin,\n  ProvenanceInfo,\n} from '../security.js';\n\n// ============================================================================\n//  Slot Types\n// ============================================================================\n\nexport type {\n  SlotKey,\n  SlotClaim,\n  SlotConfig,\n} from '../slots.js';\n\n// ============================================================================\n//  Diagnostics Types\n// ============================================================================\n\nexport type {\n  DiagnosticLevel,\n  ExtensionDiagnostic,\n  ExtensionLoaderCache,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Channels (ChannelPlugin registry)\n// ============================================================================\n\nexport type {\n  ChannelPlugin,\n  ChannelPluginInitOptions,\n  ChannelPluginStartOptions,\n} from '../../channels/plugin-types.js';\n\n// ============================================================================\n// HTTP\n// ============================================================================\n\nexport type {\n  HttpRequestHandler,\n  HttpRequest,\n  HttpResponse,\n} from '../types/index.js';\n\n// ============================================================================\n// Commands\n// ============================================================================\n\nexport type {\n  ExtensionCommand,\n  ExtensionCommandHandler,\n  ExtensionCommandContext,\n  ExtensionCommandResult,\n  ExtensionReloadHandler,\n  ExtensionReloadResult,\n  ExtensionReloadRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport type {\n  ExtensionService,\n} from '../types/index.js';\n\n// ============================================================================\n// Gateway\n// ============================================================================\n\nexport type {\n  GatewayMethodHandler,\n} from '../types/index.js';\n\n// ============================================================================\n// Export Classes\n// ============================================================================\n\nexport { TypedEventBus } from '../typed-event-bus.js';\nexport { ExtensionRegistryImpl } from '../loader.js';\nexport { ProviderPluginRegistry, getProviderRegistry } from '../../providers/plugin-registry.js';\nexport { SlotRegistry, getSlotRegistry, registerSlotType } from '../slots.js';\nexport { HOOK_EXECUTION_MODES } from '../types/hooks.js';\n\nexport { defineChannelPluginEntry } from './channel-entry.js';\nexport { registerExtensionCliProgram } from './channel-helpers.js';\n\n// ============================================================================\n// Export Hook Runner and Utilities\n// ============================================================================\n\nexport { \n  ExtensionHookRunner, \n  createHookContext, \n  isHookEvent \n} from '../hooks.js';\n\n// ============================================================================\n//  Security Utilities\n// ============================================================================\n\nexport {\n  checkExtensionPathSafety,\n  checkExtensionDirSafety,\n  isExtensionAllowed,\n  provenanceTracker,\n  logSecurityIssue,\n  DEFAULT_SECURITY_CONFIG,\n} from '../security.js';\n\n// ============================================================================\n//  Diagnostics Utilities\n// ============================================================================\n\nexport {\n  getExtensionCache,\n  getExtensionDiagnostics,\n  ExtensionLoaderCacheImpl,\n  ExtensionDiagnostics,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Config\n// ============================================================================\n\nexport type { Config } from '../../config/config-surface.js';\n\n// Subpath barrels (also available as `xopc/extension-sdk/<name>`)\nexport { lazyModule, lazyFunction } from './lazy.js';\n\nexport { createMockExtensionApi, createTestGateway } from './testing.js';\nexport type {\n  MockExtensionApi,\n  MockExtensionApiOptions,\n  TestGateway,\n} from './testing.js';\n"],"mappings":";;;;;;;;;;;;;;sBA6PiG"}

package/dist/src/extensions/types/events.d.ts

@@ -3,7 +3,12 @@
  *
  * Type-safe event bus for inter-extension communication.
  */
-import type { ExtensionLogger } from './core.js';
+interface ExtensionLogger {
+    debug(msg: string): void;
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+}
 export interface EventMap extends Record<string, unknown> {
 }
 export interface RequestMap extends Record<string, unknown> {
@@ -54,3 +59,4 @@ export interface TypedEventBus {
     cleanup(extensionId: string): void;
     cleanupAll(): void;
 }
+export {};

package/dist/src/gateway/agents-admin.js

@@ -1,13 +1,13 @@
 import { DEFAULT_AGENT_ID, init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
+import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { applyAgentConfig, findAgentEntryIndex, pruneAgentConfig, removeAgentDirsFromDisk } from "../commands/agents.config.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { seedAgentProfileMarkdownFiles } from "../agent/context/workspace-seed.js";
-import { join, resolve } from "node:path";
 import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
 //#region src/gateway/agents-admin.ts
 /**
 * Gateway REST helpers for multi-agent management.