@xopcai/xopc 0.0.149 → 0.0.151

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"lockfile.js","names":[],"sources":["../../../src/extensions/lockfile.ts"],"sourcesContent":["import { readFile, mkdir } from 'fs/promises';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { existsSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { createHash } from 'crypto';\nimport { createLogger } from '../utils/logger.js';\nimport { resolveExtensionsLockPath, resolveExtensionsDir } from '../config/paths.js';\n\nconst log = createLogger('ExtensionLockfile');\n\n// ============================================\n// Types\n// ============================================\n\nexport type ExtensionSource = 'npm' | 'local' | 'git' | 'store';\n\nexport interface ExtensionLockEntry {\n  /** Extension ID */\n  name: string;\n  /** Installed version */\n  version: string;\n  /** Resolved URL or path */\n  resolved: string;\n  /** Download artifact integrity, formatted as sha256-<base64>. */\n  integrity?: string;\n  /** Deterministic hash of installed files, formatted as dir-sha256-<base64>. */\n  installedIntegrity?: string;\n  /** Immutable artifact URL used during install, when available. */\n  artifactUrl?: string;\n  /** Manifest snapshot captured at install time. */\n  manifest?: Record<string, unknown>;\n  /** package.json snapshot captured at install time. */\n  packageJson?: Record<string, unknown>;\n  /** Installation timestamp */\n  installedAt: string;\n  /** Source type */\n  source: ExtensionSource;\n  /** Local path (for local extensions) */\n  localPath?: string;\n  /** Git reference (for git extensions) */\n  gitRef?: string;\n  /** Dependencies */\n  dependencies?: Record<string, string>;\n}\n\nexport interface ExtensionsLockfile {\n  version: number;\n  lockfileVersion: number;\n  /** Installed extensions */\n  extensions: Record<string, ExtensionLockEntry>;\n  /** Last updated timestamp */\n  lastUpdated?: string;\n}\n\n// ============================================\n// Extension Lockfile Manager\n// ============================================\n\nexport class ExtensionLockfileManager {\n  private readonly lockfilePath: string;\n\n  constructor(lockfilePath?: string) {\n    this.lockfilePath = lockfilePath || resolveExtensionsLockPath();\n  }\n\n  /**\n   * Load the lockfile\n   */\n  async load(): Promise<ExtensionsLockfile> {\n    if (!existsSync(this.lockfilePath)) {\n      return { version: 1, lockfileVersion: 1, extensions: {} };\n    }\n\n    try {\n      const content = await readFile(this.lockfilePath, 'utf-8');\n      const data = JSON.parse(content);\n      return {\n        version: data.version || 1,\n        lockfileVersion: data.lockfileVersion || 1,\n        extensions: data.extensions || {},\n        lastUpdated: data.lastUpdated,\n      };\n    } catch (error) {\n      log.warn({ error }, 'Failed to load lockfile, starting fresh');\n      return { version: 1, lockfileVersion: 1, extensions: {} };\n    }\n  }\n\n  /**\n   * Save the lockfile\n   */\n  async save(data: ExtensionsLockfile): Promise<void> {\n    data.lastUpdated = new Date().toISOString();\n\n    await mkdir(dirname(this.lockfilePath), { recursive: true });\n    await writeTextAtomic(this.lockfilePath, JSON.stringify(data, null, 2));\n\n    log.debug('Lockfile saved');\n  }\n\n  /**\n   * Add or update an extension entry\n   */\n  async upsert(\n    extensionId: string,\n    entry: Omit<ExtensionLockEntry, 'installedAt'>\n  ): Promise<void> {\n    const data = await this.load();\n\n    data.extensions[extensionId] = {\n      ...entry,\n      installedAt: new Date().toISOString(),\n    };\n\n    await this.save(data);\n    log.info({ extensionId, version: entry.version }, 'Extension locked');\n  }\n\n  /**\n   * Remove an extension entry\n   */\n  async remove(extensionId: string): Promise<void> {\n    const data = await this.load();\n\n    if (data.extensions[extensionId]) {\n      delete data.extensions[extensionId];\n      await this.save(data);\n      log.info({ extensionId }, 'Extension removed from lockfile');\n    }\n  }\n\n  /**\n   * Get a specific extension entry\n   */\n  async get(extensionId: string): Promise<ExtensionLockEntry | null> {\n    const data = await this.load();\n    return data.extensions[extensionId] || null;\n  }\n\n  /**\n   * Check if an extension is locked\n   */\n  async has(extensionId: string): Promise<boolean> {\n    const data = await this.load();\n    return extensionId in data.extensions;\n  }\n\n  /**\n   * List all locked extensions\n   */\n  async list(): Promise<ExtensionLockEntry[]> {\n    const data = await this.load();\n    return Object.values(data.extensions);\n  }\n\n  /**\n   * Verify extension integrity\n   */\n  async verify(extensionId: string): Promise<{ valid: boolean; reason?: string }> {\n    const entry = await this.get(extensionId);\n\n    if (!entry) {\n      return { valid: false, reason: 'Extension not in lockfile' };\n    }\n\n    const extDir = join(resolveExtensionsDir(), extensionId);\n\n    if (!existsSync(extDir)) {\n      return { valid: false, reason: 'Extension directory not found' };\n    }\n\n    // TODO: Verify integrity hash if available\n    // This would require reading and hashing the extension files\n\n    return { valid: true };\n  }\n\n  /**\n   * Verify all locked extensions\n   */\n  async verifyAll(): Promise<\n    Array<{ extensionId: string; valid: boolean; reason?: string }>\n  > {\n    const data = await this.load();\n    const results: Array<{ extensionId: string; valid: boolean; reason?: string }> = [];\n\n    for (const extensionId of Object.keys(data.extensions)) {\n      results.push({\n        extensionId,\n        ...(await this.verify(extensionId)),\n      });\n    }\n\n    return results;\n  }\n\n  /**\n   * Freeze current state (save with validation)\n   */\n  async freeze(): Promise<ExtensionsLockfile> {\n    const data = await this.load();\n\n    // Validate all extensions exist\n    for (const [extensionId] of Object.entries(data.extensions)) {\n      const extDir = join(resolveExtensionsDir(), extensionId);\n\n      if (!existsSync(extDir)) {\n        log.warn({ extensionId }, 'Extension in lockfile but not installed');\n      }\n    }\n\n    data.lastUpdated = new Date().toISOString();\n    await this.save(data);\n\n    log.info('Lockfile frozen');\n    return data;\n  }\n\n  /**\n   * Generate integrity hash for a file\n   */\n  static async generateIntegrity(filePath: string): Promise<string> {\n    const { readFile } = await import('fs/promises');\n    const content = await readFile(filePath);\n    return 'sha512-' + createHash('sha512').update(content).digest('base64');\n  }\n}\n\n// ============================================\n// Global Instance\n// ============================================\n\nlet globalManager: ExtensionLockfileManager | undefined;\n\nexport function getExtensionLockfileManager(\n  lockfilePath?: string\n): ExtensionLockfileManager {\n  if (!globalManager) {\n    globalManager = new ExtensionLockfileManager(lockfilePath);\n  }\n  return globalManager;\n}\n\nexport function resetExtensionLockfileManager(): void {\n  globalManager = undefined;\n}\n\n// ============================================\n// Convenience Functions\n// ============================================\n\nexport async function loadExtensionLockfile(\n  lockfilePath?: string\n): Promise<ExtensionsLockfile> {\n  const manager = getExtensionLockfileManager(lockfilePath);\n  return manager.load();\n}\n\nexport async function saveExtensionLockfile(\n  data: ExtensionsLockfile,\n  lockfilePath?: string\n): Promise<void> {\n  const manager = getExtensionLockfileManager(lockfilePath);\n  return manager.save(data);\n}\n"],"mappings":";;;;;;;;;wBACgE;aAId;YACmC;AAErF,MAAM,MAAM,aAAa,oBAAoB;AAkD7C,IAAa,2BAAb,MAAsC;CACpC;CAEA,YAAY,cAAuB;AACjC,OAAK,eAAe,gBAAgB,2BAA2B;;;;;CAMjE,MAAM,OAAoC;AACxC,MAAI,CAAC,WAAW,KAAK,aAAa,CAChC,QAAO;GAAE,SAAS;GAAG,iBAAiB;GAAG,YAAY,EAAE;GAAE;AAG3D,MAAI;GACF,MAAM,UAAU,MAAM,SAAS,KAAK,cAAc,QAAQ;GAC1D,MAAM,OAAO,KAAK,MAAM,QAAQ;AAChC,UAAO;IACL,SAAS,KAAK,WAAW;IACzB,iBAAiB,KAAK,mBAAmB;IACzC,YAAY,KAAK,cAAc,EAAE;IACjC,aAAa,KAAK;IACnB;WACM,OAAO;AACd,OAAI,KAAK,EAAE,OAAO,EAAE,0CAA0C;AAC9D,UAAO;IAAE,SAAS;IAAG,iBAAiB;IAAG,YAAY,EAAE;IAAE;;;;;;CAO7D,MAAM,KAAK,MAAyC;AAClD,OAAK,+BAAc,IAAI,MAAM,EAAC,aAAa;AAE3C,QAAM,MAAM,QAAQ,KAAK,aAAa,EAAE,EAAE,WAAW,MAAM,CAAC;AAC5D,QAAM,gBAAgB,KAAK,cAAc,KAAK,UAAU,MAAM,MAAM,EAAE,CAAC;AAEvE,MAAI,MAAM,iBAAiB;;;;;CAM7B,MAAM,OACJ,aACA,OACe;EACf,MAAM,OAAO,MAAM,KAAK,MAAM;AAE9B,OAAK,WAAW,eAAe;GAC7B,GAAG;GACH,8BAAa,IAAI,MAAM,EAAC,aAAa;GACtC;AAED,QAAM,KAAK,KAAK,KAAK;AACrB,MAAI,KAAK;GAAE;GAAa,SAAS,MAAM;GAAS,EAAE,mBAAmB;;;;;CAMvE,MAAM,OAAO,aAAoC;EAC/C,MAAM,OAAO,MAAM,KAAK,MAAM;AAE9B,MAAI,KAAK,WAAW,cAAc;AAChC,UAAO,KAAK,WAAW;AACvB,SAAM,KAAK,KAAK,KAAK;AACrB,OAAI,KAAK,EAAE,aAAa,EAAE,kCAAkC;;;;;;CAOhE,MAAM,IAAI,aAAyD;AAEjE,UAAO,MADY,KAAK,MAAM,EAClB,WAAW,gBAAgB;;;;;CAMzC,MAAM,IAAI,aAAuC;AAE/C,SAAO,gBAAe,MADH,KAAK,MAAM,EACH;;;;;CAM7B,MAAM,OAAsC;EAC1C,MAAM,OAAO,MAAM,KAAK,MAAM;AAC9B,SAAO,OAAO,OAAO,KAAK,WAAW;;;;;CAMvC,MAAM,OAAO,aAAmE;AAG9E,MAAI,CAAC,MAFe,KAAK,IAAI,YAAY,CAGvC,QAAO;GAAE,OAAO;GAAO,QAAQ;GAA6B;AAK9D,MAAI,CAAC,WAFU,KAAK,sBAAsB,EAAE,YAEtB,CAAC,CACrB,QAAO;GAAE,OAAO;GAAO,QAAQ;GAAiC;AAMlE,SAAO,EAAE,OAAO,MAAM;;;;;CAMxB,MAAM,YAEJ;EACA,MAAM,OAAO,MAAM,KAAK,MAAM;EAC9B,MAAM,UAA2E,EAAE;AAEnF,OAAK,MAAM,eAAe,OAAO,KAAK,KAAK,WAAW,CACpD,SAAQ,KAAK;GACX;GACA,GAAI,MAAM,KAAK,OAAO,YAAY;GACnC,CAAC;AAGJ,SAAO;;;;;CAMT,MAAM,SAAsC;EAC1C,MAAM,OAAO,MAAM,KAAK,MAAM;AAG9B,OAAK,MAAM,CAAC,gBAAgB,OAAO,QAAQ,KAAK,WAAW,CAGzD,KAAI,CAAC,WAFU,KAAK,sBAAsB,EAAE,YAEtB,CAAC,CACrB,KAAI,KAAK,EAAE,aAAa,EAAE,0CAA0C;AAIxE,OAAK,+BAAc,IAAI,MAAM,EAAC,aAAa;AAC3C,QAAM,KAAK,KAAK,KAAK;AAErB,MAAI,KAAK,kBAAkB;AAC3B,SAAO;;;;;CAMT,aAAa,kBAAkB,UAAmC;EAChE,MAAM,EAAE,aAAa,MAAM,OAAO;EAClC,MAAM,UAAU,MAAM,SAAS,SAAS;AACxC,SAAO,YAAY,WAAW,SAAS,CAAC,OAAO,QAAQ,CAAC,OAAO,SAAS;;;AAQ5E,IAAI;AAEJ,SAAgB,4BACd,cAC0B;AAC1B,KAAI,CAAC,cACH,iBAAgB,IAAI,yBAAyB,aAAa;AAE5D,QAAO;;AAGT,SAAgB,gCAAsC;AACpD,iBAAgB,KAAA;;AAOlB,eAAsB,sBACpB,cAC6B;AAE7B,QADgB,4BAA4B,aAC9B,CAAC,MAAM;;AAGvB,eAAsB,sBACpB,MACA,cACe;AAEf,QADgB,4BAA4B,aAC9B,CAAC,KAAK,KAAK"}

package/dist/src/extensions/manifest-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifest-registry.js","names":[],"sources":["../../../src/extensions/manifest-registry.ts"],"sourcesContent":["/**\n * Manifest registry — indexes extension manifests without loading runtime code.\n */\n\nimport type { DiscoveredExtension } from './types/loader.js';\nimport type { ExtensionManifest, ModelSupportDeclaration } from './types/manifest.js';\n\nexport interface ManifestRegistryEntry {\n  id: string;\n  manifest: ExtensionManifest;\n  source: 'workspace' | 'global' | 'bundled' | 'config';\n  path: string;\n}\n\nexport class ManifestRegistry {\n  private entries = new Map<string, ManifestRegistryEntry>();\n\n  private providerIndex = new Map<string, string>();\n  private speechProviderIndex = new Map<string, string>();\n  private mediaUnderstandingProviderIndex = new Map<string, string>();\n  private channelIndex = new Map<string, string>();\n  private modelPrefixIndex = new Map<string, string>();\n  private envVarIndex = new Map<string, string>();\n\n  static fromDiscovered(discovered: DiscoveredExtension[]): ManifestRegistry {\n    const registry = new ManifestRegistry();\n    for (const ext of discovered) {\n      registry.addEntry({\n        id: ext.id,\n        manifest: ext.manifest,\n        source: ext.source,\n        path: ext.path,\n      });\n    }\n    return registry;\n  }\n\n  addEntry(entry: ManifestRegistryEntry): void {\n    this.entries.set(entry.id, entry);\n    this.buildIndexesForEntry(entry);\n  }\n\n  private buildIndexesForEntry(entry: ManifestRegistryEntry): void {\n    const manifest = entry.manifest;\n\n    if (manifest.providers) {\n      for (const providerId of manifest.providers) {\n        this.providerIndex.set(providerId, entry.id);\n      }\n    }\n\n    for (const providerId of manifest.speechProviders ?? []) {\n      this.speechProviderIndex.set(providerId, entry.id);\n    }\n    for (const providerId of manifest.contracts?.speechProviders ?? []) {\n      this.speechProviderIndex.set(providerId, entry.id);\n    }\n\n    for (const providerId of manifest.mediaUnderstandingProviders ?? []) {\n      this.mediaUnderstandingProviderIndex.set(providerId, entry.id);\n    }\n    for (const providerId of manifest.contracts?.mediaUnderstandingProviders ?? []) {\n      this.mediaUnderstandingProviderIndex.set(providerId, entry.id);\n    }\n\n    if (manifest.channels) {\n      for (const channelId of manifest.channels) {\n        this.channelIndex.set(channelId, entry.id);\n      }\n    }\n\n    if (manifest.modelSupport?.modelPrefixes) {\n      for (const prefix of manifest.modelSupport.modelPrefixes) {\n        this.modelPrefixIndex.set(prefix, entry.id);\n      }\n    }\n\n    if (manifest.providerAuthEnvVars) {\n      for (const envVars of Object.values(manifest.providerAuthEnvVars)) {\n        for (const envVar of envVars) {\n          this.envVarIndex.set(envVar, entry.id);\n        }\n      }\n    }\n    if (manifest.channelEnvVars) {\n      for (const envVars of Object.values(manifest.channelEnvVars)) {\n        for (const envVar of envVars) {\n          this.envVarIndex.set(envVar, entry.id);\n        }\n      }\n    }\n  }\n\n  getAllEntries(): ManifestRegistryEntry[] {\n    return Array.from(this.entries.values());\n  }\n\n  getEntry(id: string): ManifestRegistryEntry | undefined {\n    return this.entries.get(id);\n  }\n\n  findByProvider(providerId: string): ManifestRegistryEntry | undefined {\n    const extensionId = this.providerIndex.get(providerId);\n    return extensionId ? this.entries.get(extensionId) : undefined;\n  }\n\n  findBySpeechProvider(providerId: string): ManifestRegistryEntry | undefined {\n    const extensionId = this.speechProviderIndex.get(providerId);\n    return extensionId ? this.entries.get(extensionId) : undefined;\n  }\n\n  findByMediaUnderstandingProvider(providerId: string): ManifestRegistryEntry | undefined {\n    const extensionId = this.mediaUnderstandingProviderIndex.get(providerId);\n    return extensionId ? this.entries.get(extensionId) : undefined;\n  }\n\n  findByChannel(channelId: string): ManifestRegistryEntry | undefined {\n    const extensionId = this.channelIndex.get(channelId);\n    return extensionId ? this.entries.get(extensionId) : undefined;\n  }\n\n  findByModelId(modelId: string): ManifestRegistryEntry | undefined {\n    const normalizedModelId = modelId.toLowerCase();\n\n    for (const [prefix, extensionId] of this.modelPrefixIndex) {\n      if (normalizedModelId.startsWith(prefix.toLowerCase())) {\n        return this.entries.get(extensionId);\n      }\n    }\n\n    for (const entry of this.entries.values()) {\n      if (this.matchesModelPatterns(normalizedModelId, entry.manifest.modelSupport)) {\n        return entry;\n      }\n    }\n\n    return undefined;\n  }\n\n  findByEnvVar(envVarName: string): ManifestRegistryEntry | undefined {\n    const extensionId = this.envVarIndex.get(envVarName);\n    return extensionId ? this.entries.get(extensionId) : undefined;\n  }\n\n  detectAvailableByEnv(env: NodeJS.ProcessEnv): ManifestRegistryEntry[] {\n    const found = new Set<string>();\n    const results: ManifestRegistryEntry[] = [];\n\n    for (const [envVar, extensionId] of this.envVarIndex) {\n      if (env[envVar] && !found.has(extensionId)) {\n        found.add(extensionId);\n        const entry = this.entries.get(extensionId);\n        if (entry) {\n          results.push(entry);\n        }\n      }\n    }\n\n    return results;\n  }\n\n  listProviderExtensions(): ManifestRegistryEntry[] {\n    return this.getAllEntries().filter(\n      (entry) => entry.manifest.providers && entry.manifest.providers.length > 0,\n    );\n  }\n\n  listChannelExtensions(): ManifestRegistryEntry[] {\n    return this.getAllEntries().filter(\n      (entry) => entry.manifest.channels && entry.manifest.channels.length > 0,\n    );\n  }\n\n  listEnabledByDefault(): ManifestRegistryEntry[] {\n    return this.getAllEntries().filter((entry) => entry.manifest.enabledByDefault === true);\n  }\n\n  private matchesModelPatterns(\n    modelId: string,\n    modelSupport?: ModelSupportDeclaration,\n  ): boolean {\n    if (!modelSupport?.modelPatterns) {\n      return false;\n    }\n\n    for (const pattern of modelSupport.modelPatterns) {\n      try {\n        const regex = new RegExp(pattern, 'i');\n        if (regex.test(modelId)) {\n          return true;\n        }\n      } catch {\n        // Invalid regex, skip\n      }\n    }\n\n    return false;\n  }\n}\n"],"mappings":";;;;AAca,oBAAb,MAAa,iBAAiB;EAC5B,0BAAkB,IAAI,KAAoC;EAE1D,gCAAwB,IAAI,KAAqB;EACjD,sCAA8B,IAAI,KAAqB;EACvD,kDAA0C,IAAI,KAAqB;EACnE,+BAAuB,IAAI,KAAqB;EAChD,mCAA2B,IAAI,KAAqB;EACpD,8BAAsB,IAAI,KAAqB;EAE/C,OAAO,eAAe,YAAqD;GACzE,MAAM,WAAW,IAAI,kBAAkB;AACvC,QAAK,MAAM,OAAO,WAChB,UAAS,SAAS;IAChB,IAAI,IAAI;IACR,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,MAAM,IAAI;IACX,CAAC;AAEJ,UAAO;;EAGT,SAAS,OAAoC;AAC3C,QAAK,QAAQ,IAAI,MAAM,IAAI,MAAM;AACjC,QAAK,qBAAqB,MAAM;;EAGlC,qBAA6B,OAAoC;GAC/D,MAAM,WAAW,MAAM;AAEvB,OAAI,SAAS,UACX,MAAK,MAAM,cAAc,SAAS,UAChC,MAAK,cAAc,IAAI,YAAY,MAAM,GAAG;AAIhD,QAAK,MAAM,cAAc,SAAS,mBAAmB,EAAE,CACrD,MAAK,oBAAoB,IAAI,YAAY,MAAM,GAAG;AAEpD,QAAK,MAAM,cAAc,SAAS,WAAW,mBAAmB,EAAE,CAChE,MAAK,oBAAoB,IAAI,YAAY,MAAM,GAAG;AAGpD,QAAK,MAAM,cAAc,SAAS,+BAA+B,EAAE,CACjE,MAAK,gCAAgC,IAAI,YAAY,MAAM,GAAG;AAEhE,QAAK,MAAM,cAAc,SAAS,WAAW,+BAA+B,EAAE,CAC5E,MAAK,gCAAgC,IAAI,YAAY,MAAM,GAAG;AAGhE,OAAI,SAAS,SACX,MAAK,MAAM,aAAa,SAAS,SAC/B,MAAK,aAAa,IAAI,WAAW,MAAM,GAAG;AAI9C,OAAI,SAAS,cAAc,cACzB,MAAK,MAAM,UAAU,SAAS,aAAa,cACzC,MAAK,iBAAiB,IAAI,QAAQ,MAAM,GAAG;AAI/C,OAAI,SAAS,oBACX,MAAK,MAAM,WAAW,OAAO,OAAO,SAAS,oBAAoB,CAC/D,MAAK,MAAM,UAAU,QACnB,MAAK,YAAY,IAAI,QAAQ,MAAM,GAAG;AAI5C,OAAI,SAAS,eACX,MAAK,MAAM,WAAW,OAAO,OAAO,SAAS,eAAe,CAC1D,MAAK,MAAM,UAAU,QACnB,MAAK,YAAY,IAAI,QAAQ,MAAM,GAAG;;EAM9C,gBAAyC;AACvC,UAAO,MAAM,KAAK,KAAK,QAAQ,QAAQ,CAAC;;EAG1C,SAAS,IAA+C;AACtD,UAAO,KAAK,QAAQ,IAAI,GAAG;;EAG7B,eAAe,YAAuD;GACpE,MAAM,cAAc,KAAK,cAAc,IAAI,WAAW;AACtD,UAAO,cAAc,KAAK,QAAQ,IAAI,YAAY,GAAG,KAAA;;EAGvD,qBAAqB,YAAuD;GAC1E,MAAM,cAAc,KAAK,oBAAoB,IAAI,WAAW;AAC5D,UAAO,cAAc,KAAK,QAAQ,IAAI,YAAY,GAAG,KAAA;;EAGvD,iCAAiC,YAAuD;GACtF,MAAM,cAAc,KAAK,gCAAgC,IAAI,WAAW;AACxE,UAAO,cAAc,KAAK,QAAQ,IAAI,YAAY,GAAG,KAAA;;EAGvD,cAAc,WAAsD;GAClE,MAAM,cAAc,KAAK,aAAa,IAAI,UAAU;AACpD,UAAO,cAAc,KAAK,QAAQ,IAAI,YAAY,GAAG,KAAA;;EAGvD,cAAc,SAAoD;GAChE,MAAM,oBAAoB,QAAQ,aAAa;AAE/C,QAAK,MAAM,CAAC,QAAQ,gBAAgB,KAAK,iBACvC,KAAI,kBAAkB,WAAW,OAAO,aAAa,CAAC,CACpD,QAAO,KAAK,QAAQ,IAAI,YAAY;AAIxC,QAAK,MAAM,SAAS,KAAK,QAAQ,QAAQ,CACvC,KAAI,KAAK,qBAAqB,mBAAmB,MAAM,SAAS,aAAa,CAC3E,QAAO;;EAOb,aAAa,YAAuD;GAClE,MAAM,cAAc,KAAK,YAAY,IAAI,WAAW;AACpD,UAAO,cAAc,KAAK,QAAQ,IAAI,YAAY,GAAG,KAAA;;EAGvD,qBAAqB,KAAiD;GACpE,MAAM,wBAAQ,IAAI,KAAa;GAC/B,MAAM,UAAmC,EAAE;AAE3C,QAAK,MAAM,CAAC,QAAQ,gBAAgB,KAAK,YACvC,KAAI,IAAI,WAAW,CAAC,MAAM,IAAI,YAAY,EAAE;AAC1C,UAAM,IAAI,YAAY;IACtB,MAAM,QAAQ,KAAK,QAAQ,IAAI,YAAY;AAC3C,QAAI,MACF,SAAQ,KAAK,MAAM;;AAKzB,UAAO;;EAGT,yBAAkD;AAChD,UAAO,KAAK,eAAe,CAAC,QACzB,UAAU,MAAM,SAAS,aAAa,MAAM,SAAS,UAAU,SAAS,EAC1E;;EAGH,wBAAiD;AAC/C,UAAO,KAAK,eAAe,CAAC,QACzB,UAAU,MAAM,SAAS,YAAY,MAAM,SAAS,SAAS,SAAS,EACxE;;EAGH,uBAAgD;AAC9C,UAAO,KAAK,eAAe,CAAC,QAAQ,UAAU,MAAM,SAAS,qBAAqB,KAAK;;EAGzF,qBACE,SACA,cACS;AACT,OAAI,CAAC,cAAc,cACjB,QAAO;AAGT,QAAK,MAAM,WAAW,aAAa,cACjC,KAAI;AAEF,QAAI,IADc,OAAO,SAAS,IACzB,CAAC,KAAK,QAAQ,CACrB,QAAO;WAEH;AAKV,UAAO"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"marketplace.js","names":[],"sources":["../../../src/extensions/marketplace.ts"],"sourcesContent":["/**\n * Extension marketplace catalog from xopc-store (`GET /api/v1/packages?type=extension`).\n * Base URL: `XOPC_SKILLS_STORE_URL` → `gateway.skillsStoreBaseUrl` → `https://store.xopc.ai`.\n */\n\nimport { loadConfig } from '../config/loader.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ExtensionMarketplace');\n\nconst DEFAULT_STORE_BASE = 'https://store.xopc.ai';\nconst CACHE_TTL_MS = 5 * 60 * 1000;\n\nexport interface RegistryEntry {\n  id: string;\n  name: string;\n  description?: string;\n  npmPackage: string;\n  version?: string;\n  categories?: string[];\n  tags?: string[];\n  verified?: boolean;\n  homepage?: string;\n  author?: string;\n}\n\nexport interface ExtensionRegistryFile {\n  version: number;\n  extensions: RegistryEntry[];\n}\n\nlet cache: { at: number; data: ExtensionRegistryFile } | null = null;\nlet lastStale: ExtensionRegistryFile | null = null;\n\n/** Resolved xopc-store base (same order as skills marketplace). */\nexport function getExtensionMarketplaceStoreBaseUrl(): string {\n  return normalizeStoreBaseUrl();\n}\n\nfunction emptyRegistry(): ExtensionRegistryFile {\n  return { version: 1, extensions: [] };\n}\n\nfunction normalizeStoreBaseUrl(): string {\n  const env = process.env.XOPC_SKILLS_STORE_URL?.trim();\n  if (env) {\n    try {\n      return new URL(env).toString().replace(/\\/$/, '');\n    } catch {\n      // fall through\n    }\n  }\n  try {\n    const fromCfg = loadConfig().gateway?.skillsStoreBaseUrl?.trim();\n    if (fromCfg) {\n      try {\n        return new URL(fromCfg).toString().replace(/\\/$/, '');\n      } catch {\n        // fall through\n      }\n    }\n  } catch {\n    /* ignore config load edge cases */\n  }\n  return DEFAULT_STORE_BASE;\n}\n\nfunction titleCaseSlug(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join(' ');\n}\n\nasync function fetchExtensionCatalogFromStore(): Promise<RegistryEntry[] | null> {\n  const base = normalizeStoreBaseUrl();\n  const listUrl = `${base}/api/v1/packages?type=extension&pageSize=200`;\n  try {\n    const res = await fetch(listUrl, { signal: AbortSignal.timeout(20_000) });\n    if (!res.ok) {\n      log.warn({ status: res.status, url: listUrl }, 'Store extension catalog request failed');\n      return null;\n    }\n    const raw = (await res.json()) as {\n      items?: Array<{\n        name?: string;\n        description?: string | null;\n        latestVersion?: string;\n        author?: { username?: string | null };\n      }>;\n    };\n    const items = Array.isArray(raw.items) ? raw.items : [];\n    const extensions: RegistryEntry[] = [];\n    for (const it of items) {\n      const name = typeof it.name === 'string' ? it.name.trim() : '';\n      if (!name) continue;\n      const author = it.author?.username ?? undefined;\n      extensions.push({\n        id: name,\n        name: titleCaseSlug(name),\n        description: typeof it.description === 'string' ? it.description : undefined,\n        npmPackage: name,\n        version: typeof it.latestVersion === 'string' ? it.latestVersion : undefined,\n        author,\n        verified: author === 'xopcai',\n      });\n    }\n    return extensions.length > 0 ? extensions : null;\n  } catch (err) {\n    log.warn({ err, url: listUrl }, 'Store extension catalog fetch failed');\n    return null;\n  }\n}\n\nexport async function fetchRegistry(forceRefresh = false): Promise<ExtensionRegistryFile> {\n  const now = Date.now();\n  if (!forceRefresh && cache && now - cache.at < CACHE_TTL_MS) {\n    return cache.data;\n  }\n\n  const storeBase = normalizeStoreBaseUrl();\n  const fromStore = await fetchExtensionCatalogFromStore();\n  if (fromStore && fromStore.length > 0) {\n    const data: ExtensionRegistryFile = { version: 1, extensions: fromStore };\n    lastStale = data;\n    cache = { at: now, data };\n    log.debug({ count: fromStore.length, storeBase }, 'Loaded extension catalog from xopc-store');\n    return data;\n  }\n\n  log.warn({ storeBase }, 'Extension catalog from xopc-store was empty or unreachable');\n  if (lastStale) {\n    return lastStale;\n  }\n  return emptyRegistry();\n}\n\nfunction matchesKeyword(entry: RegistryEntry, keyword: string): boolean {\n  const k = keyword.toLowerCase();\n  const hay = [\n    entry.id,\n    entry.name,\n    entry.description ?? '',\n    ...(entry.categories ?? []),\n    ...(entry.tags ?? []),\n    entry.npmPackage,\n  ]\n    .join(' ')\n    .toLowerCase();\n  return hay.includes(k);\n}\n\nexport async function searchExtensions(keyword: string): Promise<RegistryEntry[]> {\n  const reg = await fetchRegistry();\n  const k = keyword.trim();\n  if (!k) return reg.extensions;\n  return reg.extensions.filter((e) => matchesKeyword(e, k));\n}\n\nexport async function findExtension(id: string): Promise<RegistryEntry | undefined> {\n  const reg = await fetchRegistry();\n  return reg.extensions.find((e) => e.id === id);\n}\n\nexport async function listExtensions(category?: string): Promise<RegistryEntry[]> {\n  const reg = await fetchRegistry();\n  if (!category?.trim()) return reg.extensions;\n  const c = category.trim().toLowerCase();\n  return reg.extensions.filter((e) =>\n    (e.categories ?? []).some((x) => x.toLowerCase() === c),\n  );\n}\n"],"mappings":"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"}

package/dist/src/extensions/media-provider-contracts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"media-provider-contracts.js","names":[],"sources":["../../../src/extensions/media-provider-contracts.ts"],"sourcesContent":["/**\n * Media understanding (STT / image / video) extension contract validation.\n */\n\nimport { getMediaUnderstandingProvider } from '../media-understanding/registry.js';\n\nimport type { ExtensionLogger } from './types/core.js';\nimport type { ExtensionManifest } from './types/manifest.js';\n\nfunction normalizeId(id: string): string {\n  return id.trim().toLowerCase();\n}\n\n/** Declared media understanding provider ids from manifest (top-level + contracts). */\nexport function declaredMediaUnderstandingProviderIds(manifest: ExtensionManifest): string[] {\n  const ids = new Set<string>();\n  for (const id of manifest.mediaUnderstandingProviders ?? []) {\n    if (typeof id === 'string' && id.trim()) {\n      ids.add(normalizeId(id));\n    }\n  }\n  for (const id of manifest.contracts?.mediaUnderstandingProviders ?? []) {\n    if (typeof id === 'string' && id.trim()) {\n      ids.add(normalizeId(id));\n    }\n  }\n  return [...ids];\n}\n\n/** Registered ids normalized for comparison (includes canonical plugin ids). */\nexport function normalizeRegisteredMediaUnderstandingProviderIds(\n  registeredIds: readonly string[],\n): string[] {\n  const normalized = new Set<string>();\n  for (const id of registeredIds) {\n    const trimmed = id.trim();\n    if (!trimmed) continue;\n    normalized.add(normalizeId(trimmed));\n    const canonical = getMediaUnderstandingProvider(trimmed)?.id;\n    if (canonical) {\n      normalized.add(normalizeId(canonical));\n    }\n  }\n  return [...normalized];\n}\n\n/**\n * Warn when a manifest declares media understanding contracts but the extension\n * did not register matching providers at load time.\n */\nexport function validateMediaUnderstandingProviderContracts(params: {\n  extensionId: string;\n  manifest: ExtensionManifest;\n  registeredProviderIds: readonly string[];\n  logger: ExtensionLogger;\n}): void {\n  const declared = declaredMediaUnderstandingProviderIds(params.manifest);\n  if (declared.length === 0) {\n    return;\n  }\n\n  const registered = new Set(\n    normalizeRegisteredMediaUnderstandingProviderIds(params.registeredProviderIds),\n  );\n\n  for (const id of declared) {\n    const plugin = getMediaUnderstandingProvider(id);\n    const canonical = plugin ? normalizeId(plugin.id) : id;\n    if (!registered.has(canonical) && !registered.has(id)) {\n      params.logger.warn(\n        `Media understanding provider contract \"${id}\" declared in manifest but not registered by extension \"${params.extensionId}\"`,\n      );\n    }\n  }\n}\n"],"mappings":";;;;;AASA,SAAS,YAAY,IAAoB;AACvC,QAAO,GAAG,MAAM,CAAC,aAAa;;;AAIhC,SAAgB,sCAAsC,UAAuC;CAC3F,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,MAAM,SAAS,+BAA+B,EAAE,CACzD,KAAI,OAAO,OAAO,YAAY,GAAG,MAAM,CACrC,KAAI,IAAI,YAAY,GAAG,CAAC;AAG5B,MAAK,MAAM,MAAM,SAAS,WAAW,+BAA+B,EAAE,CACpE,KAAI,OAAO,OAAO,YAAY,GAAG,MAAM,CACrC,KAAI,IAAI,YAAY,GAAG,CAAC;AAG5B,QAAO,CAAC,GAAG,IAAI;;;AAIjB,SAAgB,iDACd,eACU;CACV,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,MAAM,eAAe;EAC9B,MAAM,UAAU,GAAG,MAAM;AACzB,MAAI,CAAC,QAAS;AACd,aAAW,IAAI,YAAY,QAAQ,CAAC;EACpC,MAAM,YAAY,8BAA8B,QAAQ,EAAE;AAC1D,MAAI,UACF,YAAW,IAAI,YAAY,UAAU,CAAC;;AAG1C,QAAO,CAAC,GAAG,WAAW;;;;;;AAOxB,SAAgB,4CAA4C,QAKnD;CACP,MAAM,WAAW,sCAAsC,OAAO,SAAS;AACvE,KAAI,SAAS,WAAW,EACtB;CAGF,MAAM,aAAa,IAAI,IACrB,iDAAiD,OAAO,sBAAsB,CAC/E;AAED,MAAK,MAAM,MAAM,UAAU;EACzB,MAAM,SAAS,8BAA8B,GAAG;EAChD,MAAM,YAAY,SAAS,YAAY,OAAO,GAAG,GAAG;AACpD,MAAI,CAAC,WAAW,IAAI,UAAU,IAAI,CAAC,WAAW,IAAI,GAAG,CACnD,QAAO,OAAO,KACZ,0CAA0C,GAAG,0DAA0D,OAAO,YAAY,GAC3H"}

package/dist/src/extensions/normalize-manifest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize-manifest.js","names":[],"sources":["../../../src/extensions/normalize-manifest.ts"],"sourcesContent":["import type {\n  ActivationDeclaration,\n  ChatWidgetContribution,\n  ChatWidgetMatch,\n  CommandContribution,\n  ContractDeclaration,\n  EnginesDeclaration,\n  ExtensionManifest,\n  ChannelContributionDeclaration,\n  ChannelActionDescriptor,\n  ChannelConfigUiHint,\n  ExtensionManifestCommand,\n  ExtensionUiContributions,\n  ExtensionUiManifest,\n  ExtensionUiPermission,\n  ModelSupportDeclaration,\n  PageContribution,\n  ProviderAuthChoice,\n  SettingsPanelContribution,\n  SetupDeclaration,\n  SidebarPanelContribution,\n  StatusBarItemContribution,\n} from './types/manifest.js';\nimport type { ExtensionKind } from './types/core.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction normalizeReload(raw: unknown): ExtensionManifest['reload'] {\n  if (!isRecord(raw)) return undefined;\n  const configPrefixes = Array.isArray(raw.configPrefixes)\n    ? raw.configPrefixes.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const supportsHotReload =\n    typeof raw.supportsHotReload === 'boolean' ? raw.supportsHotReload : undefined;\n  if (!configPrefixes?.length && supportsHotReload === undefined) return undefined;\n  return {\n    ...(configPrefixes?.length ? { configPrefixes } : {}),\n    ...(supportsHotReload !== undefined ? { supportsHotReload } : {}),\n  };\n}\n\nfunction normalizeEngines(raw: unknown): EnginesDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const xopc = typeof raw.xopc === 'string' && raw.xopc.length > 0 ? raw.xopc : undefined;\n  const extensionApi =\n    typeof raw.extensionApi === 'string' && raw.extensionApi.length > 0\n      ? raw.extensionApi\n      : undefined;\n  const extensionUiApi =\n    typeof raw.extensionUiApi === 'string' && raw.extensionUiApi.length > 0\n      ? raw.extensionUiApi\n      : undefined;\n  if (!xopc && !extensionApi && !extensionUiApi) return undefined;\n  return { xopc, extensionApi, extensionUiApi };\n}\n\nfunction normalizeManifestCommands(raw: unknown): ExtensionManifestCommand[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ExtensionManifestCommand[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const name = typeof item.name === 'string' ? item.name.trim() : '';\n    const description = typeof item.description === 'string' ? item.description : '';\n    if (!name || !description) continue;\n    const aliases = Array.isArray(item.aliases)\n      ? item.aliases.filter((x): x is string => typeof x === 'string')\n      : undefined;\n    const scope = Array.isArray(item.scope)\n      ? item.scope.filter(\n          (x): x is 'global' | 'private' | 'group' =>\n            x === 'global' || x === 'private' || x === 'group',\n        )\n      : undefined;\n    const examples = Array.isArray(item.examples)\n      ? item.examples.filter((x): x is string => typeof x === 'string')\n      : undefined;\n    out.push({\n      name,\n      description,\n      ...(aliases?.length ? { aliases } : {}),\n      ...(scope?.length ? { scope } : {}),\n      ...(examples?.length ? { examples } : {}),\n    });\n  }\n  return out.length > 0 ? out : undefined;\n}\n\nfunction normalizeChannelContributions(raw: unknown): Record<string, ChannelContributionDeclaration> | undefined {\n  if (!isRecord(raw)) return undefined;\n  const out: Record<string, ChannelContributionDeclaration> = {};\n  for (const [id, value] of Object.entries(raw)) {\n    if (!isRecord(value)) continue;\n    const label = typeof value.label === 'string' && value.label.trim() ? value.label.trim() : '';\n    if (!id.trim() || !label) continue;\n    out[id.trim()] = {\n      label,\n      description: typeof value.description === 'string' ? value.description : undefined,\n      docsPath: typeof value.docsPath === 'string' ? value.docsPath : undefined,\n      order: typeof value.order === 'number' && Number.isFinite(value.order) ? value.order : undefined,\n      configPath: typeof value.configPath === 'string' ? value.configPath : undefined,\n      capabilities: isRecord(value.capabilities) ? value.capabilities : undefined,\n      configSchema: isRecord(value.configSchema) ? value.configSchema : undefined,\n      uiHints: normalizeChannelUiHints(value.uiHints),\n      actions: normalizeChannelActions(value.actions),\n      i18n: normalizeChannelContributionI18n(value.i18n),\n    };\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nfunction normalizeChannelContributionI18n(raw: unknown): ChannelContributionDeclaration['i18n'] {\n  if (!isRecord(raw)) return undefined;\n  const out: NonNullable<ChannelContributionDeclaration['i18n']> = {};\n  for (const [locale, value] of Object.entries(raw)) {\n    if (!locale.trim() || !isRecord(value)) continue;\n    const entry = {\n      label: typeof value.label === 'string' ? value.label : undefined,\n      description: typeof value.description === 'string' ? value.description : undefined,\n      configSchema: isRecord(value.configSchema) ? value.configSchema : undefined,\n      uiHints: normalizeChannelUiHints(value.uiHints),\n      actions: normalizeChannelActions(value.actions),\n    };\n    if (entry.label || entry.description || entry.configSchema || entry.uiHints || entry.actions) {\n      out[locale.trim().toLowerCase().replace('_', '-')] = entry;\n    }\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nfunction normalizeChannelUiHints(raw: unknown): Record<string, ChannelConfigUiHint> | undefined {\n  if (!isRecord(raw)) return undefined;\n  const out: Record<string, ChannelConfigUiHint> = {};\n  for (const [key, value] of Object.entries(raw)) {\n    if (!key.trim() || !isRecord(value)) continue;\n    out[key.trim()] = {\n      label: typeof value.label === 'string' ? value.label : undefined,\n      help: typeof value.help === 'string' ? value.help : undefined,\n      tags: Array.isArray(value.tags) ? value.tags.filter((x): x is string => typeof x === 'string') : undefined,\n      advanced: typeof value.advanced === 'boolean' ? value.advanced : undefined,\n      sensitive: typeof value.sensitive === 'boolean' ? value.sensitive : undefined,\n      placeholder: typeof value.placeholder === 'string' ? value.placeholder : undefined,\n      itemTemplate: value.itemTemplate,\n    };\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nfunction normalizeChannelActions(raw: unknown): Record<string, ChannelActionDescriptor> | undefined {\n  if (!isRecord(raw)) return undefined;\n  const out: Record<string, ChannelActionDescriptor> = {};\n  for (const [key, value] of Object.entries(raw)) {\n    if (!key.trim() || !isRecord(value)) continue;\n    const result = value.result;\n    out[key.trim()] = {\n      label: typeof value.label === 'string' ? value.label : undefined,\n      description: typeof value.description === 'string' ? value.description : undefined,\n      result:\n        result === 'ok' || result === 'qr' || result === 'poll' || result === 'diagnostics' || result === 'form'\n          ? result\n          : undefined,\n      schema: isRecord(value.schema) ? value.schema : undefined,\n    };\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\n/**\n * Normalize raw JSON manifest into ExtensionManifest with stable optional fields.\n */\nexport function normalizeExtensionManifest(raw: Record<string, unknown>): ExtensionManifest {\n  const id = String(raw.id ?? '');\n  return {\n    id,\n    name: typeof raw.name === 'string' && raw.name.length > 0 ? raw.name : id,\n    description: typeof raw.description === 'string' ? raw.description : undefined,\n    version: typeof raw.version === 'string' ? raw.version : undefined,\n    kind: raw.kind as ExtensionKind | undefined,\n    main: typeof raw.main === 'string' ? raw.main : undefined,\n    configSchema: isRecord(raw.configSchema) ? (raw.configSchema as Record<string, unknown>) : undefined,\n    dependencies: isRecord(raw.dependencies) ? (raw.dependencies as Record<string, string>) : undefined,\n\n    enabledByDefault: typeof raw.enabledByDefault === 'boolean' ? raw.enabledByDefault : undefined,\n\n    providers: Array.isArray(raw.providers)\n      ? raw.providers.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    speechProviders: Array.isArray(raw.speechProviders)\n      ? raw.speechProviders.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    mediaUnderstandingProviders: Array.isArray(raw.mediaUnderstandingProviders)\n      ? raw.mediaUnderstandingProviders.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    providerAuthEnvVars: normalizeStringArrayMap(raw.providerAuthEnvVars),\n    providerAuthChoices: normalizeProviderAuthChoices(raw.providerAuthChoices),\n    modelSupport: normalizeModelSupport(raw.modelSupport),\n    autoEnableWhenConfiguredProviders: Array.isArray(raw.autoEnableWhenConfiguredProviders)\n      ? raw.autoEnableWhenConfiguredProviders.filter((x): x is string => typeof x === 'string')\n      : undefined,\n\n    channels: Array.isArray(raw.channels)\n      ? raw.channels.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    channelEnvVars: normalizeStringArrayMap(raw.channelEnvVars),\n    channelContributions: normalizeChannelContributions(raw.channelContributions),\n\n    activation: normalizeActivation(raw.activation),\n    contracts: normalizeContracts(raw.contracts),\n    setup: normalizeSetup(raw.setup),\n    reload: normalizeReload(raw.reload),\n    engines: normalizeEngines(raw.engines),\n    commands: normalizeManifestCommands(raw.commands),\n    ui: normalizeUiManifest(raw.ui),\n  };\n}\n\nconst VALID_UI_PERMISSIONS = new Set<ExtensionUiPermission>([\n  'agent.send',\n  'agent.subscribe',\n  'session.read',\n  'session.write',\n  'config.read',\n  'config.write',\n  'storage',\n  'notification',\n  'clipboard',\n  'theme',\n  'workspace.read',\n  'workspace.write',\n]);\n\nexport function normalizeUiManifest(raw: unknown): ExtensionUiManifest | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (!isRecord(raw)) return undefined;\n  const main = typeof raw.main === 'string' && raw.main.length > 0 ? raw.main : undefined;\n  const icon = typeof raw.icon === 'string' && raw.icon.length > 0 ? raw.icon : undefined;\n  let permissions: ExtensionUiPermission[] | undefined;\n  if (Array.isArray(raw.permissions)) {\n    const p = raw.permissions.filter(\n      (x): x is ExtensionUiPermission =>\n        typeof x === 'string' && VALID_UI_PERMISSIONS.has(x as ExtensionUiPermission),\n    );\n    permissions = p.length ? p : undefined;\n  }\n  const contributions = normalizeUiContributions(raw.contributions);\n  if (!main && !icon && !permissions && !contributions) return undefined;\n  return {\n    ...(main !== undefined ? { main } : {}),\n    ...(icon !== undefined ? { icon } : {}),\n    ...(permissions !== undefined ? { permissions } : {}),\n    ...(contributions !== undefined ? { contributions } : {}),\n  };\n}\n\nfunction normalizeUiContributions(raw: unknown): ExtensionUiContributions | undefined {\n  if (!isRecord(raw)) return undefined;\n  const sidebarPanels = normalizeSidebarPanels(raw.sidebarPanels);\n  const settingsPanels = normalizeSettingsPanels(raw.settingsPanels);\n  const chatWidgets = normalizeChatWidgets(raw.chatWidgets);\n  const pages = normalizePages(raw.pages);\n  const commands = normalizeCommands(raw.commands);\n  const statusBarItems = normalizeStatusBarItems(raw.statusBarItems);\n  const out: ExtensionUiContributions = {\n    ...(sidebarPanels ? { sidebarPanels } : {}),\n    ...(settingsPanels ? { settingsPanels } : {}),\n    ...(chatWidgets ? { chatWidgets } : {}),\n    ...(pages ? { pages } : {}),\n    ...(commands ? { commands } : {}),\n    ...(statusBarItems ? { statusBarItems } : {}),\n  };\n  return Object.keys(out).length ? out : undefined;\n}\n\nfunction normalizeSidebarPanels(raw: unknown): SidebarPanelContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: SidebarPanelContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      entrypoint,\n      icon: typeof item.icon === 'string' ? item.icon : undefined,\n      defaultVisible: typeof item.defaultVisible === 'boolean' ? item.defaultVisible : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeSettingsPanels(raw: unknown): SettingsPanelContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: SettingsPanelContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      entrypoint,\n      order: typeof item.order === 'number' ? item.order : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeChatWidgetMatch(raw: unknown): ChatWidgetMatch | undefined {\n  if (!isRecord(raw)) return undefined;\n  const toolName = typeof raw.toolName === 'string' ? raw.toolName : undefined;\n  const contentType = typeof raw.contentType === 'string' ? raw.contentType : undefined;\n  let metadata: Record<string, unknown> | undefined;\n  if (isRecord(raw.metadata)) {\n    metadata = { ...raw.metadata };\n  }\n  if (!toolName && !contentType && !metadata) return undefined;\n  return { toolName, contentType, metadata };\n}\n\nfunction normalizeChatWidgets(raw: unknown): ChatWidgetContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ChatWidgetContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    const match = normalizeChatWidgetMatch(item.match);\n    if (!match) continue;\n    out.push({\n      id,\n      title,\n      entrypoint,\n      match,\n      maxHeight: typeof item.maxHeight === 'number' ? item.maxHeight : undefined,\n      interactive: typeof item.interactive === 'boolean' ? item.interactive : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizePages(raw: unknown): PageContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: PageContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const path = item.path;\n    const entrypoint = item.entrypoint;\n    if (\n      typeof id !== 'string' ||\n      typeof title !== 'string' ||\n      typeof path !== 'string' ||\n      typeof entrypoint !== 'string'\n    ) {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      path,\n      entrypoint,\n      showInNav: typeof item.showInNav === 'boolean' ? item.showInNav : undefined,\n      navIcon: typeof item.navIcon === 'string' ? item.navIcon : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeCommands(raw: unknown): CommandContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: CommandContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    if (typeof id !== 'string' || typeof title !== 'string') continue;\n    out.push({\n      id,\n      title,\n      shortcut: typeof item.shortcut === 'string' ? item.shortcut : undefined,\n      opensPanel: typeof item.opensPanel === 'string' ? item.opensPanel : undefined,\n      chatAlias:\n        typeof item.chatAlias === 'string' && item.chatAlias.length > 0 ? item.chatAlias : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeStatusBarItems(raw: unknown): StatusBarItemContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: StatusBarItemContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof entrypoint !== 'string') continue;\n    const position = item.position;\n    out.push({\n      id,\n      entrypoint,\n      position: position === 'left' || position === 'right' ? position : undefined,\n      width: typeof item.width === 'number' ? item.width : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeStringArrayMap(\n  raw: unknown,\n): Record<string, string[]> | undefined {\n  if (!isRecord(raw)) return undefined;\n  const out: Record<string, string[]> = {};\n  for (const [k, v] of Object.entries(raw)) {\n    if (Array.isArray(v)) {\n      const arr = v.filter((x): x is string => typeof x === 'string');\n      if (arr.length) out[k] = arr;\n    }\n  }\n  return Object.keys(out).length ? out : undefined;\n}\n\nfunction normalizeProviderAuthChoices(raw: unknown): ProviderAuthChoice[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ProviderAuthChoice[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const provider = item.provider;\n    const method = item.method;\n    const choiceId = item.choiceId;\n    const choiceLabel = item.choiceLabel;\n    if (\n      typeof provider !== 'string' ||\n      typeof choiceId !== 'string' ||\n      typeof choiceLabel !== 'string' ||\n      (method !== 'api-key' && method !== 'oauth' && method !== 'cli' && method !== 'env')\n    ) {\n      continue;\n    }\n    out.push({\n      provider,\n      method,\n      choiceId,\n      choiceLabel,\n      choiceHint: typeof item.choiceHint === 'string' ? item.choiceHint : undefined,\n      groupId: typeof item.groupId === 'string' ? item.groupId : undefined,\n      groupLabel: typeof item.groupLabel === 'string' ? item.groupLabel : undefined,\n      groupHint: typeof item.groupHint === 'string' ? item.groupHint : undefined,\n      cliFlag: typeof item.cliFlag === 'string' ? item.cliFlag : undefined,\n      cliOption: typeof item.cliOption === 'string' ? item.cliOption : undefined,\n      cliDescription: typeof item.cliDescription === 'string' ? item.cliDescription : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeModelSupport(raw: unknown): ModelSupportDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const modelPrefixes = Array.isArray(raw.modelPrefixes)\n    ? raw.modelPrefixes.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const modelPatterns = Array.isArray(raw.modelPatterns)\n    ? raw.modelPatterns.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  if (!modelPrefixes?.length && !modelPatterns?.length) return undefined;\n  return { modelPrefixes, modelPatterns };\n}\n\nfunction normalizeActivation(raw: unknown): ActivationDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const onStartup = typeof raw.onStartup === 'boolean' ? raw.onStartup : undefined;\n  const onProviders = Array.isArray(raw.onProviders)\n    ? raw.onProviders.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const onCommands = Array.isArray(raw.onCommands)\n    ? raw.onCommands.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const onChannels = Array.isArray(raw.onChannels)\n    ? raw.onChannels.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const capRaw = raw.onCapabilities;\n  const onCapabilities = Array.isArray(capRaw)\n    ? capRaw.filter(\n        (x): x is 'provider' | 'channel' | 'tool' | 'hook' =>\n          x === 'provider' || x === 'channel' || x === 'tool' || x === 'hook',\n      )\n    : undefined;\n  if (\n    onStartup === undefined &&\n    !onProviders?.length &&\n    !onCommands?.length &&\n    !onChannels?.length &&\n    !onCapabilities?.length\n  ) {\n    return undefined;\n  }\n  return { onStartup, onProviders, onCommands, onChannels, onCapabilities };\n}\n\nfunction normalizeContracts(raw: unknown): ContractDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const pick = (k: string) =>\n    Array.isArray(raw[k]) ? raw[k].filter((x: unknown): x is string => typeof x === 'string') : undefined;\n  const c: ContractDeclaration = {\n    tools: pick('tools'),\n    hooks: pick('hooks'),\n    commands: pick('commands'),\n    cliCommands: pick('cliCommands'),\n    channels: pick('channels'),\n    httpRoutes: pick('httpRoutes'),\n    gatewayMethods: pick('gatewayMethods'),\n    services: pick('services'),\n    tui: pick('tui'),\n    providers: pick('providers'),\n    marketplaceAdapters: pick('marketplaceAdapters'),\n    mediaUnderstandingProviders: pick('mediaUnderstandingProviders'),\n    speechProviders: pick('speechProviders'),\n    imageGenerationProviders: pick('imageGenerationProviders'),\n    webSearchProviders: pick('webSearchProviders'),\n    memoryProviders: pick('memoryProviders'),\n  };\n  return Object.values(c).some((value) => Array.isArray(value) && value.length > 0)\n    ? c\n    : undefined;\n}\n\nfunction normalizeSetup(raw: unknown): SetupDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const requiresRuntime = typeof raw.requiresRuntime === 'boolean' ? raw.requiresRuntime : undefined;\n  let providers: SetupDeclaration['providers'];\n  if (Array.isArray(raw.providers)) {\n    providers = [];\n    for (const p of raw.providers) {\n      if (!isRecord(p) || typeof p.id !== 'string') continue;\n      providers.push({\n        id: p.id,\n        authMethods: Array.isArray(p.authMethods)\n          ? p.authMethods.filter((x): x is string => typeof x === 'string')\n          : undefined,\n        envVars: Array.isArray(p.envVars)\n          ? p.envVars.filter((x): x is string => typeof x === 'string')\n          : undefined,\n      });\n    }\n    if (providers.length === 0) providers = undefined;\n  }\n  if (!providers && requiresRuntime === undefined) return undefined;\n  return { providers, requiresRuntime };\n}\n"],"mappings":"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"}

package/dist/src/extensions/onboard-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"onboard-helpers.js","names":[],"sources":["../../../src/extensions/onboard-helpers.ts"],"sourcesContent":["/**\n * Onboarding helpers — manifest-only, no extension runtime load.\n */\n\nimport type { ManifestRegistry } from './manifest-registry.js';\nimport type { ProviderAuthChoice } from './types/manifest.js';\n\nexport interface OnboardProviderInfo {\n  extensionId: string;\n  providerId: string;\n  extensionName: string;\n  envConfigured: boolean;\n  configuredEnvVar?: string;\n  authChoices: ProviderAuthChoice[];\n  modelPrefixes: string[];\n}\n\nexport interface OnboardChannelInfo {\n  extensionId: string;\n  channelId: string;\n  extensionName: string;\n  envConfigured: boolean;\n  configuredEnvVar?: string;\n}\n\nexport function listOnboardProviders(\n  registry: ManifestRegistry,\n  env: NodeJS.ProcessEnv = process.env,\n): OnboardProviderInfo[] {\n  const results: OnboardProviderInfo[] = [];\n\n  for (const entry of registry.listProviderExtensions()) {\n    const manifest = entry.manifest;\n    const providers = manifest.providers || [];\n\n    for (const providerId of providers) {\n      const envVars = manifest.providerAuthEnvVars?.[providerId] || [];\n      const configuredEnvVar = envVars.find((v) => !!env[v]);\n\n      const authChoices = (manifest.providerAuthChoices || []).filter(\n        (c) => c.provider === providerId,\n      );\n\n      results.push({\n        extensionId: entry.id,\n        providerId,\n        extensionName: manifest.name || entry.id,\n        envConfigured: !!configuredEnvVar,\n        configuredEnvVar,\n        authChoices,\n        modelPrefixes: manifest.modelSupport?.modelPrefixes || [],\n      });\n    }\n  }\n\n  results.sort((a, b) => {\n    if (a.envConfigured && !b.envConfigured) return -1;\n    if (!a.envConfigured && b.envConfigured) return 1;\n    return a.extensionName.localeCompare(b.extensionName);\n  });\n\n  return results;\n}\n\nexport function listOnboardChannels(\n  registry: ManifestRegistry,\n  env: NodeJS.ProcessEnv = process.env,\n): OnboardChannelInfo[] {\n  const results: OnboardChannelInfo[] = [];\n\n  for (const entry of registry.listChannelExtensions()) {\n    const manifest = entry.manifest;\n    const channels = manifest.channels || [];\n\n    for (const channelId of channels) {\n      const envVars = manifest.channelEnvVars?.[channelId] || [];\n      const configuredEnvVar = envVars.find((v) => !!env[v]);\n\n      results.push({\n        extensionId: entry.id,\n        channelId,\n        extensionName: manifest.name || entry.id,\n        envConfigured: !!configuredEnvVar,\n        configuredEnvVar,\n      });\n    }\n  }\n\n  results.sort((a, b) => {\n    if (a.envConfigured && !b.envConfigured) return -1;\n    if (!a.envConfigured && b.envConfigured) return 1;\n    return a.extensionName.localeCompare(b.extensionName);\n  });\n\n  return results;\n}\n\nexport function resolveProviderForModel(\n  registry: ManifestRegistry,\n  modelId: string,\n): { extensionId: string; providerId: string } | undefined {\n  const entry = registry.findByModelId(modelId);\n  if (!entry) return undefined;\n\n  const providers = entry.manifest.providers;\n  if (!providers || providers.length === 0) return undefined;\n\n  return {\n    extensionId: entry.id,\n    providerId: providers[0],\n  };\n}\n"],"mappings":";AAyBA,SAAgB,qBACd,UACA,MAAyB,QAAQ,KACV;CACvB,MAAM,UAAiC,EAAE;AAEzC,MAAK,MAAM,SAAS,SAAS,wBAAwB,EAAE;EACrD,MAAM,WAAW,MAAM;EACvB,MAAM,YAAY,SAAS,aAAa,EAAE;AAE1C,OAAK,MAAM,cAAc,WAAW;GAElC,MAAM,oBADU,SAAS,sBAAsB,eAAe,EAAE,EAC/B,MAAM,MAAM,CAAC,CAAC,IAAI,GAAG;GAEtD,MAAM,eAAe,SAAS,uBAAuB,EAAE,EAAE,QACtD,MAAM,EAAE,aAAa,WACvB;AAED,WAAQ,KAAK;IACX,aAAa,MAAM;IACnB;IACA,eAAe,SAAS,QAAQ,MAAM;IACtC,eAAe,CAAC,CAAC;IACjB;IACA;IACA,eAAe,SAAS,cAAc,iBAAiB,EAAE;IAC1D,CAAC;;;AAIN,SAAQ,MAAM,GAAG,MAAM;AACrB,MAAI,EAAE,iBAAiB,CAAC,EAAE,cAAe,QAAO;AAChD,MAAI,CAAC,EAAE,iBAAiB,EAAE,cAAe,QAAO;AAChD,SAAO,EAAE,cAAc,cAAc,EAAE,cAAc;GACrD;AAEF,QAAO;;AAGT,SAAgB,oBACd,UACA,MAAyB,QAAQ,KACX;CACtB,MAAM,UAAgC,EAAE;AAExC,MAAK,MAAM,SAAS,SAAS,uBAAuB,EAAE;EACpD,MAAM,WAAW,MAAM;EACvB,MAAM,WAAW,SAAS,YAAY,EAAE;AAExC,OAAK,MAAM,aAAa,UAAU;GAEhC,MAAM,oBADU,SAAS,iBAAiB,cAAc,EAAE,EACzB,MAAM,MAAM,CAAC,CAAC,IAAI,GAAG;AAEtD,WAAQ,KAAK;IACX,aAAa,MAAM;IACnB;IACA,eAAe,SAAS,QAAQ,MAAM;IACtC,eAAe,CAAC,CAAC;IACjB;IACD,CAAC;;;AAIN,SAAQ,MAAM,GAAG,MAAM;AACrB,MAAI,EAAE,iBAAiB,CAAC,EAAE,cAAe,QAAO;AAChD,MAAI,CAAC,EAAE,iBAAiB,EAAE,cAAe,QAAO;AAChD,SAAO,EAAE,cAAc,cAAc,EAAE,cAAc;GACrD;AAEF,QAAO;;AAGT,SAAgB,wBACd,UACA,SACyD;CACzD,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,KAAI,CAAC,MAAO,QAAO,KAAA;CAEnB,MAAM,YAAY,MAAM,SAAS;AACjC,KAAI,CAAC,aAAa,UAAU,WAAW,EAAG,QAAO,KAAA;AAEjD,QAAO;EACL,aAAa,MAAM;EACnB,YAAY,UAAU;EACvB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"package-contract.js","names":[],"sources":["../../../src/extensions/package-contract.ts"],"sourcesContent":["export const PACKAGE_DEPENDENCY_SECTIONS = [\n  'dependencies',\n  'devDependencies',\n  'peerDependencies',\n  'optionalDependencies',\n] as const;\n\nexport interface PackageDependencyIssue {\n  section: (typeof PACKAGE_DEPENDENCY_SECTIONS)[number];\n  name: string;\n  version: string;\n  code: 'workspace_dependency' | 'host_sdk_runtime_dependency' | 'ui_sdk_runtime_dependency';\n  message: string;\n}\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction dependencyVersion(pkg: Record<string, unknown>, section: string, name: string): string | undefined {\n  const deps = pkg[section];\n  if (!isRecord(deps)) return undefined;\n  const value = deps[name];\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport function collectExtensionPackageDependencyIssues(\n  pkg: Record<string, unknown>,\n  options: { strictRuntimeSdkDeps?: boolean } = {},\n): PackageDependencyIssue[] {\n  const issues: PackageDependencyIssue[] = [];\n  for (const section of PACKAGE_DEPENDENCY_SECTIONS) {\n    const deps = pkg[section];\n    if (!isRecord(deps)) continue;\n    for (const [name, rawVersion] of Object.entries(deps)) {\n      if (typeof rawVersion !== 'string') continue;\n      if (rawVersion.startsWith('workspace:')) {\n        issues.push({\n          section,\n          name,\n          version: rawVersion,\n          code: 'workspace_dependency',\n          message: `${section}.${name} uses ${rawVersion}; published extensions must not depend on workspace protocols.`,\n        });\n      }\n    }\n  }\n\n  if (options.strictRuntimeSdkDeps) {\n    const hostRuntime = dependencyVersion(pkg, 'dependencies', '@xopcai/xopc');\n    if (hostRuntime) {\n      issues.push({\n        section: 'dependencies',\n        name: '@xopcai/xopc',\n        version: hostRuntime,\n        code: 'host_sdk_runtime_dependency',\n        message:\n          '@xopcai/xopc must not be a runtime dependency of an extension package; use devDependencies for types and optional peerDependencies for host compatibility.',\n      });\n    }\n    const uiRuntime = dependencyVersion(pkg, 'dependencies', '@xopcai/extension-ui-sdk');\n    if (uiRuntime) {\n      issues.push({\n        section: 'dependencies',\n        name: '@xopcai/extension-ui-sdk',\n        version: uiRuntime,\n        code: 'ui_sdk_runtime_dependency',\n        message:\n          '@xopcai/extension-ui-sdk should be bundled into static UI assets and kept in devDependencies, not runtime dependencies.',\n      });\n    }\n  }\n\n  return issues;\n}\n\nexport function hasWorkspaceProtocolDependencies(pkg: Record<string, unknown>): boolean {\n  return collectExtensionPackageDependencyIssues(pkg).some((x) => x.code === 'workspace_dependency');\n}\n"],"mappings":";AAAA,MAAa,8BAA8B;CACzC;CACA;CACA;CACA;CACD;AAUD,SAAS,SAAS,GAA0C;AAC1D,QAAO,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,EAAE;;AAGjE,SAAS,kBAAkB,KAA8B,SAAiB,MAAkC;CAC1G,MAAM,OAAO,IAAI;AACjB,KAAI,CAAC,SAAS,KAAK,CAAE,QAAO,KAAA;CAC5B,MAAM,QAAQ,KAAK;AACnB,QAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;;AAG7C,SAAgB,wCACd,KACA,UAA8C,EAAE,EACtB;CAC1B,MAAM,SAAmC,EAAE;AAC3C,MAAK,MAAM,WAAW,6BAA6B;EACjD,MAAM,OAAO,IAAI;AACjB,MAAI,CAAC,SAAS,KAAK,CAAE;AACrB,OAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QAAQ,KAAK,EAAE;AACrD,OAAI,OAAO,eAAe,SAAU;AACpC,OAAI,WAAW,WAAW,aAAa,CACrC,QAAO,KAAK;IACV;IACA;IACA,SAAS;IACT,MAAM;IACN,SAAS,GAAG,QAAQ,GAAG,KAAK,QAAQ,WAAW;IAChD,CAAC;;;AAKR,KAAI,QAAQ,sBAAsB;EAChC,MAAM,cAAc,kBAAkB,KAAK,gBAAgB,eAAe;AAC1E,MAAI,YACF,QAAO,KAAK;GACV,SAAS;GACT,MAAM;GACN,SAAS;GACT,MAAM;GACN,SACE;GACH,CAAC;EAEJ,MAAM,YAAY,kBAAkB,KAAK,gBAAgB,2BAA2B;AACpF,MAAI,UACF,QAAO,KAAK;GACV,SAAS;GACT,MAAM;GACN,SAAS;GACT,MAAM;GACN,SACE;GACH,CAAC;;AAIN,QAAO;;AAGT,SAAgB,iCAAiC,KAAuC;AACtF,QAAO,wCAAwC,IAAI,CAAC,MAAM,MAAM,EAAE,SAAS,uBAAuB"}

package/dist/src/extensions/sdk/channel-entry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"channel-entry.js","names":[],"sources":["../../../../src/extensions/sdk/channel-entry.ts"],"sourcesContent":["/**\n * Channel plugin entry helper for extensions.\n */\n\nimport type { ExtensionApi } from '../types/index.js';\nimport type { ChannelPlugin } from '../../channels/plugin-types.js';\n\nexport interface DefineChannelPluginEntryOptions<TPlugin extends ChannelPlugin> {\n  id: string;\n  name: string;\n  description?: string;\n  plugin: TPlugin;\n  setRuntime?: (runtime: unknown) => void;\n  registerFull?: (api: ExtensionApi) => void;\n}\n\nexport function defineChannelPluginEntry<TPlugin extends ChannelPlugin>(\n  options: DefineChannelPluginEntryOptions<TPlugin>,\n) {\n  return {\n    id: options.id,\n    name: options.name,\n    description: options.description,\n    register(api: ExtensionApi) {\n      options.setRuntime?.(api as unknown);\n      api.registerChannel({ plugin: options.plugin });\n      options.registerFull?.(api);\n    },\n  };\n}\n"],"mappings":";AAgBA,SAAgB,yBACd,SACA;AACA,QAAO;EACL,IAAI,QAAQ;EACZ,MAAM,QAAQ;EACd,aAAa,QAAQ;EACrB,SAAS,KAAmB;AAC1B,WAAQ,aAAa,IAAe;AACpC,OAAI,gBAAgB,EAAE,QAAQ,QAAQ,QAAQ,CAAC;AAC/C,WAAQ,eAAe,IAAI;;EAE9B"}

package/dist/src/extensions/sdk/channel-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"channel-helpers.js","names":[],"sources":["../../../../src/extensions/sdk/channel-helpers.ts"],"sourcesContent":["import type { Command } from 'commander';\nimport type { ExtensionRegistry } from '../types/index.js';\n\n/**\n * Apply all `registerCli` factories collected on the registry to a Commander program.\n */\nexport function registerExtensionCliProgram(program: Command, registry: ExtensionRegistry): void {\n  for (const reg of registry.getCliRegistrations()) {\n    reg.factory({ program });\n  }\n}\n"],"mappings":";;;;AAMA,SAAgB,4BAA4B,SAAkB,UAAmC;AAC/F,MAAK,MAAM,OAAO,SAAS,qBAAqB,CAC9C,KAAI,QAAQ,EAAE,SAAS,CAAC"}

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

@@ -1 +0,0 @@
-{"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 '@xopcai/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// Public subpath barrels under `@xopcai/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/sdk/lazy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy.js","names":[],"sources":["../../../../src/extensions/sdk/lazy.ts"],"sourcesContent":["/**\n * Lazy dynamic import helpers for extension entrypoints.\n */\n\nexport function lazyModule<T>(loader: () => Promise<T>): () => Promise<T> {\n  let cached: T | undefined;\n  let loading: Promise<T> | undefined;\n\n  return async () => {\n    if (cached) return cached;\n\n    if (!loading) {\n      loading = loader().then((module) => {\n        cached = module;\n        loading = undefined;\n        return module;\n      });\n    }\n\n    return loading;\n  };\n}\n\nexport function lazyFunction<TModule, TArgs extends unknown[], TReturn>(\n  loader: () => Promise<TModule>,\n  selector: (module: TModule) => (...args: TArgs) => TReturn,\n): (...args: TArgs) => Promise<TReturn> {\n  const load = lazyModule(loader);\n\n  return async (...args: TArgs) => {\n    const module = await load();\n    const fn = selector(module);\n    return fn(...args);\n  };\n}\n"],"mappings":";;;;AAIA,SAAgB,WAAc,QAA4C;CACxE,IAAI;CACJ,IAAI;AAEJ,QAAO,YAAY;AACjB,MAAI,OAAQ,QAAO;AAEnB,MAAI,CAAC,QACH,WAAU,QAAQ,CAAC,MAAM,WAAW;AAClC,YAAS;AACT,aAAU,KAAA;AACV,UAAO;IACP;AAGJ,SAAO;;;AAIX,SAAgB,aACd,QACA,UACsC;CACtC,MAAM,OAAO,WAAW,OAAO;AAE/B,QAAO,OAAO,GAAG,SAAgB;AAG/B,SADW,SAAS,MADC,MAAM,CAElB,CAAC,GAAG,KAAK"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"security.js","names":["path"],"sources":["../../../src/extensions/security.ts"],"sourcesContent":["/**\n * Extension Security Module\n * \n *  Plugin security and sandboxing.\n * Provides path safety checks, permission validation, and allowlist management.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('Extension:Security');\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type ExtensionSourceOrigin = 'workspace' | 'global' | 'bundled' | 'config';\n\nexport interface SafetyCheckResult {\n  safe: boolean;\n  reason?: 'world_writable' | 'ownership_mismatch' | 'symlink_escape' | 'hardlink' | 'stat_failed';\n  detail?: string;\n}\n\nexport interface SecurityConfig {\n  /** Enable security checks */\n  checkPermissions: boolean;\n  /** Allow loading untrusted extensions (not in allowlist) */\n  allowUntrusted: boolean;\n  /** List of allowed extension IDs */\n  allow: string[];\n  /** Enable provenance tracking */\n  trackProvenance: boolean;\n  /** Allow extensions to inject content into system prompts */\n  allowPromptInjection: boolean;\n}\n\n// ============================================================================\n// Default Security Config\n// ============================================================================\n\nexport const DEFAULT_SECURITY_CONFIG: SecurityConfig = {\n  checkPermissions: true,\n  allowUntrusted: false,\n  allow: [],\n  trackProvenance: true,\n  allowPromptInjection: false,\n};\n\n// ============================================================================\n// Path Safety Checks\n// ============================================================================\n\n/**\n * Check if a path is safe for extension loading.\n * - Rejects world-writable directories (mode & 0o002)\n * - Verifies file ownership (UID match)\n * - Detects symlink escape (realpath outside root)\n * - Rejects hardlinks to non-bundled files\n */\nexport function checkExtensionPathSafety(\n  sourcePath: string,\n  rootDir: string,\n  origin: ExtensionSourceOrigin,\n): SafetyCheckResult {\n  try {\n    // 1. Symlink escape check\n    const realSource = fs.realpathSync(sourcePath);\n    const realRoot = fs.realpathSync(rootDir);\n    \n    if (!realSource.startsWith(realRoot + path.sep) && realSource !== realRoot) {\n      return {\n        safe: false,\n        reason: 'symlink_escape',\n        detail: `Real path ${realSource} escapes root directory ${realRoot}`,\n      };\n    }\n\n    // 2. Skip platform-specific checks on Windows\n    if (process.platform === 'win32') {\n      return { safe: true };\n    }\n\n    // 3. World-writable check (only for non-bundled extensions)\n    const stat = fs.statSync(sourcePath);\n    \n    if (origin !== 'bundled' && (stat.mode & 0o002) !== 0) {\n      return {\n        safe: false,\n        reason: 'world_writable',\n        detail: `Path ${sourcePath} is world-writable`,\n      };\n    }\n\n    // 4. Ownership check (only for non-bundled extensions)\n    if (origin !== 'bundled' && process.getuid) {\n      const currentUid = process.getuid();\n      // Allow root (uid 0) or same owner\n      if (stat.uid !== currentUid && stat.uid !== 0) {\n        return {\n          safe: false,\n          reason: 'ownership_mismatch',\n          detail: `Path owned by UID ${stat.uid}, current process is UID ${currentUid}`,\n        };\n      }\n    }\n\n    // 5. Hardlink check (only for non-bundled extensions and regular files)\n    // Skip for directories - APFS creates spurious hardlink counts due to\n    // Time Machine snapshots and APFS clones, causing false positives\n    if (origin !== 'bundled') {\n      const sourceStat = fs.statSync(sourcePath);\n      // Only check regular files, not directories\n      if (sourceStat.isFile() && sourceStat.nlink > 1) {\n        return {\n          safe: false,\n          reason: 'hardlink',\n          detail: `Path ${sourcePath} is a hardlink (nlink: ${sourceStat.nlink})`,\n        };\n      }\n    }\n\n    return { safe: true };\n  } catch (error) {\n    return {\n      safe: false,\n      reason: 'stat_failed',\n      detail: `Failed to stat path: ${error instanceof Error ? error.message : String(error)}`,\n    };\n  }\n}\n\n/**\n * Check all files in an extension directory recursively\n */\nexport function checkExtensionDirSafety(\n  extensionDir: string,\n  rootDir: string,\n  origin: ExtensionSourceOrigin,\n): { safe: boolean; issues: SafetyCheckResult[] } {\n  const issues: SafetyCheckResult[] = [];\n  \n  if (!fs.existsSync(extensionDir)) {\n    return { safe: false, issues: [{ safe: false, reason: 'stat_failed', detail: 'Directory does not exist' }] };\n  }\n\n  const walkDir = (dir: string) => {\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n    \n    for (const entry of entries) {\n      const fullPath = path.join(dir, entry.name);\n      \n      if (entry.isSymbolicLink()) {\n        const result = checkExtensionPathSafety(fullPath, rootDir, origin);\n        if (!result.safe) {\n          issues.push(result);\n        }\n      } else if (entry.isDirectory()) {\n        walkDir(fullPath);\n      } else if (entry.isFile()) {\n        const result = checkExtensionPathSafety(fullPath, rootDir, origin);\n        if (!result.safe) {\n          issues.push(result);\n        }\n      }\n    }\n  };\n\n  walkDir(extensionDir);\n  \n  return {\n    safe: issues.length === 0,\n    issues,\n  };\n}\n\n// ============================================================================\n// Allowlist Management\n// ============================================================================\n\n/**\n * Check if an extension is allowed by the allowlist\n */\nexport function isExtensionAllowed(\n  extensionId: string,\n  config: SecurityConfig,\n): boolean {\n  // If allowlist is empty and allowUntrusted is false, only bundled extensions are allowed\n  if (config.allow.length === 0 && !config.allowUntrusted) {\n    return false;\n  }\n  \n  // Check if in allowlist\n  if (config.allow.includes(extensionId)) {\n    return true;\n  }\n  \n  // If allowUntrusted is true, allow anything\n  return config.allowUntrusted;\n}\n\n// ============================================================================\n// Provenance Tracking\n// ============================================================================\n\nexport interface ProvenanceInfo {\n  extensionId: string;\n  source: ExtensionSourceOrigin;\n  installMethod?: 'manual' | 'npm' | 'git' | 'download' | 'unknown';\n  installDate?: Date;\n  checksum?: string;\n}\n\n/**\n * Simple provenance tracking (in-memory for now)\n */\nclass ProvenanceTracker {\n  private provenance = new Map<string, ProvenanceInfo>();\n  \n  track(extensionId: string, source: ExtensionSourceOrigin, method?: string): void {\n    this.provenance.set(extensionId, {\n      extensionId,\n      source,\n      installMethod: method as ProvenanceInfo['installMethod'],\n      installDate: new Date(),\n    });\n  }\n  \n  get(extensionId: string): ProvenanceInfo | undefined {\n    return this.provenance.get(extensionId);\n  }\n  \n  getAll(): ProvenanceInfo[] {\n    return Array.from(this.provenance.values());\n  }\n}\n\nexport const provenanceTracker = new ProvenanceTracker();\n\n// ============================================================================\n// Security Logger\n// ============================================================================\n\nexport function logSecurityIssue(\n  extensionId: string,\n  result: SafetyCheckResult,\n): void {\n  if (result.reason === 'world_writable') {\n    log.warn(`[Security] Extension \"${extensionId}\" is in world-writable directory: ${result.detail}`);\n  } else if (result.reason === 'ownership_mismatch') {\n    log.warn(`[Security] Extension \"${extensionId}\" ownership mismatch: ${result.detail}`);\n  } else if (result.reason === 'symlink_escape') {\n    log.error(`[Security] Extension \"${extensionId}\" symlink escape attempt: ${result.detail}`);\n  } else if (result.reason === 'hardlink') {\n    log.warn(`[Security] Extension \"${extensionId}\" hardlink detected: ${result.detail}`);\n  }\n}\n"],"mappings":"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"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"slots.js","names":[],"sources":["../../../src/extensions/slots.ts"],"sourcesContent":["/**\n * Extension Slot System\n * \n * Slot exclusivity for capabilities that allow only one active implementation.\n * Some capabilities (memory backend, TTS provider) can only have one active implementation.\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('Extension:Slots');\n\n// ============================================================================\n// Slot Types\n// ============================================================================\n\nexport type SlotKey = 'memory' | 'tts' | 'imageGeneration' | 'webSearch';\n\nexport interface SlotClaim {\n  pluginId: string;\n  instance: unknown;\n  claimedAt: Date;\n}\n\nexport interface SlotConfig {\n  /** Slot key */\n  key: SlotKey;\n  /** Preferred plugin ID (from config) */\n  preferredPlugin?: string;\n}\n\n// ============================================================================\n// Slot Registry\n// ============================================================================\n\n/**\n * Manages exclusive slots for extensions.\n * Ensures only one plugin can claim a specific slot at a time.\n */\nexport class SlotRegistry {\n  private slots = new Map<SlotKey, SlotClaim>();\n\n  /**\n   * Claim a slot for a plugin\n   * @returns true if claim succeeded, false if slot already taken\n   */\n  claim(key: SlotKey, pluginId: string, instance: unknown): boolean {\n    const existing = this.slots.get(key);\n    \n    if (existing && existing.pluginId !== pluginId) {\n      log.warn(\n        `Slot \"${key}\" already claimed by \"${existing.pluginId}\", rejecting claim from \"${pluginId}\"`\n      );\n      return false;\n    }\n\n    this.slots.set(key, {\n      pluginId,\n      instance,\n      claimedAt: new Date(),\n    });\n    \n    log.info(`Slot \"${key}\" claimed by \"${pluginId}\"`);\n    return true;\n  }\n\n  /**\n   * Release a slot\n   * @returns true if released, false if not owned by the plugin\n   */\n  release(key: SlotKey, pluginId: string): boolean {\n    const existing = this.slots.get(key);\n    \n    if (!existing || existing.pluginId !== pluginId) {\n      return false;\n    }\n\n    this.slots.delete(key);\n    log.info(`Slot \"${key}\" released by \"${pluginId}\"`);\n    return true;\n  }\n\n  /**\n   * Get the instance in a slot\n   */\n  get<T>(key: SlotKey): T | undefined {\n    return this.slots.get(key)?.instance as T | undefined;\n  }\n\n  /**\n   * Check if a slot is claimed\n   */\n  isClaimed(key: SlotKey): boolean {\n    return this.slots.has(key);\n  }\n\n  /**\n   * Get which plugin claimed a slot\n   */\n  getClaimant(key: SlotKey): string | undefined {\n    return this.slots.get(key)?.pluginId;\n  }\n\n  /**\n   * Get all claimed slots\n   */\n  getAllClaims(): Map<SlotKey, SlotClaim> {\n    return new Map(this.slots);\n  }\n\n  /**\n   * Clear all slots (useful for testing or reset)\n   */\n  clear(): void {\n    this.slots.clear();\n    log.info('All slots cleared');\n  }\n\n  /**\n   * Force release a slot (admin operation)\n   */\n  forceRelease(key: SlotKey): boolean {\n    if (this.slots.has(key)) {\n      const claimant = this.slots.get(key)!.pluginId;\n      this.slots.delete(key);\n      log.warn(`Slot \"${key}\" force-released (was claimed by \"${claimant}\")`);\n      return true;\n    }\n    return false;\n  }\n}\n\n// ============================================================================\n// Slot Factory (for creating slots dynamically)\n// ============================================================================\n\nconst registeredSlotTypes = new Set<SlotKey>();\n\n/**\n * Register a new slot type (for extensibility)\n */\nexport function registerSlotType(key: SlotKey): void {\n  if (!registeredSlotTypes.has(key)) {\n    registeredSlotTypes.add(key);\n    log.debug(`Registered slot type: ${key}`);\n  }\n}\n\n/**\n * Get all registered slot types\n */\nexport function getRegisteredSlotTypes(): SlotKey[] {\n  return Array.from(registeredSlotTypes);\n}\n\n// Initialize default slot types\nregisterSlotType('memory');\nregisterSlotType('tts');\nregisterSlotType('imageGeneration');\nregisterSlotType('webSearch');\n\n// ============================================================================\n// Singleton Instance\n// ============================================================================\n\nlet globalSlotRegistry: SlotRegistry | null = null;\n\nexport function getSlotRegistry(): SlotRegistry {\n  if (!globalSlotRegistry) {\n    globalSlotRegistry = new SlotRegistry();\n  }\n  return globalSlotRegistry;\n}\n\nexport function setSlotRegistry(registry: SlotRegistry): void {\n  globalSlotRegistry = registry;\n}\n"],"mappings":";;;aAOkD;AAElD,MAAM,MAAM,aAAa,kBAAkB;;;;;AA6B3C,IAAa,eAAb,MAA0B;CACxB,wBAAgB,IAAI,KAAyB;;;;;CAM7C,MAAM,KAAc,UAAkB,UAA4B;EAChE,MAAM,WAAW,KAAK,MAAM,IAAI,IAAI;AAEpC,MAAI,YAAY,SAAS,aAAa,UAAU;AAC9C,OAAI,KACF,SAAS,IAAI,wBAAwB,SAAS,SAAS,2BAA2B,SAAS,GAC5F;AACD,UAAO;;AAGT,OAAK,MAAM,IAAI,KAAK;GAClB;GACA;GACA,2BAAW,IAAI,MAAM;GACtB,CAAC;AAEF,MAAI,KAAK,SAAS,IAAI,gBAAgB,SAAS,GAAG;AAClD,SAAO;;;;;;CAOT,QAAQ,KAAc,UAA2B;EAC/C,MAAM,WAAW,KAAK,MAAM,IAAI,IAAI;AAEpC,MAAI,CAAC,YAAY,SAAS,aAAa,SACrC,QAAO;AAGT,OAAK,MAAM,OAAO,IAAI;AACtB,MAAI,KAAK,SAAS,IAAI,iBAAiB,SAAS,GAAG;AACnD,SAAO;;;;;CAMT,IAAO,KAA6B;AAClC,SAAO,KAAK,MAAM,IAAI,IAAI,EAAE;;;;;CAM9B,UAAU,KAAuB;AAC/B,SAAO,KAAK,MAAM,IAAI,IAAI;;;;;CAM5B,YAAY,KAAkC;AAC5C,SAAO,KAAK,MAAM,IAAI,IAAI,EAAE;;;;;CAM9B,eAAwC;AACtC,SAAO,IAAI,IAAI,KAAK,MAAM;;;;;CAM5B,QAAc;AACZ,OAAK,MAAM,OAAO;AAClB,MAAI,KAAK,oBAAoB;;;;;CAM/B,aAAa,KAAuB;AAClC,MAAI,KAAK,MAAM,IAAI,IAAI,EAAE;GACvB,MAAM,WAAW,KAAK,MAAM,IAAI,IAAI,CAAE;AACtC,QAAK,MAAM,OAAO,IAAI;AACtB,OAAI,KAAK,SAAS,IAAI,oCAAoC,SAAS,IAAI;AACvE,UAAO;;AAET,SAAO;;;AAQX,MAAM,sCAAsB,IAAI,KAAc;;;;AAK9C,SAAgB,iBAAiB,KAAoB;AACnD,KAAI,CAAC,oBAAoB,IAAI,IAAI,EAAE;AACjC,sBAAoB,IAAI,IAAI;AAC5B,MAAI,MAAM,yBAAyB,MAAM;;;;;;AAO7C,SAAgB,yBAAoC;AAClD,QAAO,MAAM,KAAK,oBAAoB;;AAIxC,iBAAiB,SAAS;AAC1B,iBAAiB,MAAM;AACvB,iBAAiB,kBAAkB;AACnC,iBAAiB,YAAY;AAM7B,IAAI,qBAA0C;AAE9C,SAAgB,kBAAgC;AAC9C,KAAI,CAAC,mBACH,sBAAqB,IAAI,cAAc;AAEzC,QAAO;;AAGT,SAAgB,gBAAgB,UAA8B;AAC5D,sBAAqB"}

package/dist/src/extensions/speech-provider-contracts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"speech-provider-contracts.js","names":[],"sources":["../../../src/extensions/speech-provider-contracts.ts"],"sourcesContent":["/**\n * Speech provider extension contract validation.\n */\n\nimport { getSpeechProvider } from '../voice/tts/speech-registry.js';\n\nimport type { ExtensionLogger } from './types/core.js';\nimport type { ExtensionManifest } from './types/manifest.js';\n\nfunction normalizeId(id: string): string {\n  return id.trim().toLowerCase();\n}\n\n/** Declared speech provider ids from manifest (top-level + contracts). */\nexport function declaredSpeechProviderIds(manifest: ExtensionManifest): string[] {\n  const ids = new Set<string>();\n  for (const id of manifest.speechProviders ?? []) {\n    if (typeof id === 'string' && id.trim()) {\n      ids.add(normalizeId(id));\n    }\n  }\n  for (const id of manifest.contracts?.speechProviders ?? []) {\n    if (typeof id === 'string' && id.trim()) {\n      ids.add(normalizeId(id));\n    }\n  }\n  return [...ids];\n}\n\n/** Registered ids normalized for comparison (includes canonical plugin ids). */\nexport function normalizeRegisteredSpeechProviderIds(registeredIds: readonly string[]): string[] {\n  const normalized = new Set<string>();\n  for (const id of registeredIds) {\n    const trimmed = id.trim();\n    if (!trimmed) continue;\n    normalized.add(normalizeId(trimmed));\n    const canonical = getSpeechProvider(trimmed)?.id;\n    if (canonical) {\n      normalized.add(normalizeId(canonical));\n    }\n  }\n  return [...normalized];\n}\n\n/**\n * Warn when a manifest declares speech provider contracts but the extension\n * did not register matching providers at load time.\n */\nexport function validateSpeechProviderContracts(params: {\n  extensionId: string;\n  manifest: ExtensionManifest;\n  registeredProviderIds: readonly string[];\n  logger: ExtensionLogger;\n}): void {\n  const declared = declaredSpeechProviderIds(params.manifest);\n  if (declared.length === 0) {\n    return;\n  }\n\n  const registered = new Set(normalizeRegisteredSpeechProviderIds(params.registeredProviderIds));\n\n  for (const id of declared) {\n    const plugin = getSpeechProvider(id);\n    const canonical = plugin ? normalizeId(plugin.id) : id;\n    if (!registered.has(canonical) && !registered.has(id)) {\n      params.logger.warn(\n        `Speech provider contract \"${id}\" declared in manifest but not registered by extension \"${params.extensionId}\"`,\n      );\n    }\n  }\n}\n"],"mappings":";;;;;AASA,SAAS,YAAY,IAAoB;AACvC,QAAO,GAAG,MAAM,CAAC,aAAa;;;AAIhC,SAAgB,0BAA0B,UAAuC;CAC/E,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,MAAM,SAAS,mBAAmB,EAAE,CAC7C,KAAI,OAAO,OAAO,YAAY,GAAG,MAAM,CACrC,KAAI,IAAI,YAAY,GAAG,CAAC;AAG5B,MAAK,MAAM,MAAM,SAAS,WAAW,mBAAmB,EAAE,CACxD,KAAI,OAAO,OAAO,YAAY,GAAG,MAAM,CACrC,KAAI,IAAI,YAAY,GAAG,CAAC;AAG5B,QAAO,CAAC,GAAG,IAAI;;;AAIjB,SAAgB,qCAAqC,eAA4C;CAC/F,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,MAAM,eAAe;EAC9B,MAAM,UAAU,GAAG,MAAM;AACzB,MAAI,CAAC,QAAS;AACd,aAAW,IAAI,YAAY,QAAQ,CAAC;EACpC,MAAM,YAAY,kBAAkB,QAAQ,EAAE;AAC9C,MAAI,UACF,YAAW,IAAI,YAAY,UAAU,CAAC;;AAG1C,QAAO,CAAC,GAAG,WAAW;;;;;;AAOxB,SAAgB,gCAAgC,QAKvC;CACP,MAAM,WAAW,0BAA0B,OAAO,SAAS;AAC3D,KAAI,SAAS,WAAW,EACtB;CAGF,MAAM,aAAa,IAAI,IAAI,qCAAqC,OAAO,sBAAsB,CAAC;AAE9F,MAAK,MAAM,MAAM,UAAU;EACzB,MAAM,SAAS,kBAAkB,GAAG;EACpC,MAAM,YAAY,SAAS,YAAY,OAAO,GAAG,GAAG;AACpD,MAAI,CAAC,WAAW,IAAI,UAAU,IAAI,CAAC,WAAW,IAAI,GAAG,CACnD,QAAO,OAAO,KACZ,6BAA6B,GAAG,0DAA0D,OAAO,YAAY,GAC9G"}

package/dist/src/extensions/store-zip-limits.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store-zip-limits.js","names":[],"sources":["../../../src/extensions/store-zip-limits.ts"],"sourcesContent":["/** xopc-store extension zip limit (matches server scan). */\nexport const MAX_EXTENSION_STORE_ZIP_BYTES = 10 * 1024 * 1024;\n"],"mappings":";;AACA,MAAa,gCAAgC,KAAK,OAAO"}

package/dist/src/extensions/typed-event-bus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"typed-event-bus.js","names":[],"sources":["../../../src/extensions/typed-event-bus.ts"],"sourcesContent":["/**\n * Typed Event Bus \n *\n * Type-safe event bus for inter-extension communication.\n *\n * Features:\n * - Type-safe event emission and listening\n * - Request-response pattern (RPC)\n * - Wildcard pattern matching for events\n * - Automatic cleanup on extension unload\n * - Error handling with optional error catching\n */\n\nimport type {\n  EventMap,\n  RequestMap,\n  EventHandler,\n  EventHandlerMeta,\n  RequestHandler,\n  RequestHandlerMeta,\n  WildcardEventHandler,\n  WildcardHandlerMeta,\n  TypedEventBusOptions,\n  RequestOptions,\n} from './types/events.js';\nimport type { ExtensionLogger } from './types/core.js';\n\ninterface InternalRequest {\n  id: string;\n  method: string;\n  params: unknown;\n  timeout: number;\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timer?: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Type-safe event bus for inter-extension communication\n *\n * @example\n * ```typescript\n * interface MyEvents {\n *   'user:login': { userId: string; timestamp: number };\n *   'message:received': { chatId: string; content: string };\n * }\n *\n * interface MyRequests {\n *   'user:get': { userId: string };\n * }\n *\n * interface MyResponses {\n *   'user:get': { name: string; email: string };\n * }\n *\n * const bus = new TypedEventBus<MyEvents, MyRequests, MyResponses>();\n *\n * // Listen for events\n * bus.on('user:login', (data) => {\n *   console.log(`User ${data.userId} logged in`);\n * });\n *\n * // Emit events\n * bus.emit('user:login', { userId: 'user123', timestamp: Date.now() });\n *\n * // Request-response\n * bus.onRequest('user:get', async (params) => {\n *   return { name: 'John', email: 'john@example.com' };\n * });\n *\n * const user = await bus.request('user:get', { userId: 'user123' });\n * ```\n */\nexport class TypedEventBus<\n  TEvents extends EventMap = EventMap,\n  TRequests extends RequestMap = RequestMap,\n  _TResponses extends RequestMap = RequestMap\n> {\n  private eventHandlers = new Map<keyof TEvents, EventHandlerMeta[]>();\n  private wildcardHandlers: WildcardHandlerMeta[] = [];\n  private requestHandlers = new Map<keyof TRequests, RequestHandlerMeta[]>();\n  private pendingRequests = new Map<string, InternalRequest>();\n  private options: Required<TypedEventBusOptions>;\n  private requestIdCounter = 0;\n\n  constructor(options: TypedEventBusOptions = {}) {\n    this.options = {\n      requestTimeout: options.requestTimeout ?? 5000,\n      catchErrors: options.catchErrors ?? true,\n      logger: options.logger ?? this.createDefaultLogger(),\n    };\n  }\n\n  // ============================================================================\n  // Event Emission and Listening\n  // ============================================================================\n\n  /**\n   * Subscribe to an event\n   *\n   * @param event - Event name\n   * @param handler - Event handler function\n   * @param options - Handler options (extensionId, once)\n   * @returns Unsubscribe function\n   */\n  on<K extends keyof TEvents>(\n    event: K,\n    handler: EventHandler<TEvents[K]>,\n    options: { extensionId?: string; once?: boolean } = {}\n  ): () => void {\n    const meta: EventHandlerMeta = {\n      handler: handler as EventHandler<unknown>,\n      extensionId: options.extensionId,\n      once: options.once,\n    };\n\n    const handlers = this.eventHandlers.get(event) || [];\n    handlers.push(meta);\n    this.eventHandlers.set(event, handlers);\n\n    // Return unsubscribe function\n    return () => {\n      this.off(event, handler);\n    };\n  }\n\n  /**\n   * Unsubscribe from an event\n   *\n   * @param event - Event name\n   * @param handler - Handler to remove\n   */\n  off<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): void {\n    const handlers = this.eventHandlers.get(event);\n    if (!handlers) return;\n\n    const index = handlers.findIndex((h) => h.handler === handler);\n    if (index >= 0) {\n      handlers.splice(index, 1);\n      if (handlers.length === 0) {\n        this.eventHandlers.delete(event);\n      }\n    }\n  }\n\n  /**\n   * Emit an event\n   *\n   * @param event - Event name\n   * @param data - Event data\n   */\n  emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void {\n    // Call specific handlers\n    const handlers = this.eventHandlers.get(event);\n    if (handlers) {\n      // Filter out 'once' handlers that need to be removed after execution\n      const handlersToRemove: number[] = [];\n\n      handlers.forEach((meta, index) => {\n        try {\n          meta.handler(data);\n          if (meta.once) {\n            handlersToRemove.push(index);\n          }\n        } catch (error) {\n          this.handleError(`Error in event handler for ${String(event)}`, error);\n        }\n      });\n\n      // Remove once handlers (in reverse order to maintain indices)\n      for (let i = handlersToRemove.length - 1; i >= 0; i--) {\n        handlers.splice(handlersToRemove[i], 1);\n      }\n\n      if (handlers.length === 0) {\n        this.eventHandlers.delete(event);\n      }\n    }\n\n    // Call wildcard handlers\n    this.wildcardHandlers.forEach((meta) => {\n      if (this.matchWildcard(meta.pattern, String(event))) {\n        try {\n          meta.handler(data, String(event));\n        } catch (error) {\n          this.handleError(`Error in wildcard handler for ${String(event)}`, error);\n        }\n      }\n    });\n  }\n\n  // ============================================================================\n  // Wildcard Pattern Matching\n  // ============================================================================\n\n  /**\n   * Subscribe to events matching a wildcard pattern\n   *\n   * @param pattern - Wildcard pattern (e.g., 'user:*', '*:update')\n   * @param handler - Handler function\n   * @param options - Handler options (extensionId)\n   * @returns Unsubscribe function\n   */\n  onWildcard(\n    pattern: string,\n    handler: WildcardEventHandler,\n    options: { extensionId?: string } = {}\n  ): () => void {\n    const meta: WildcardHandlerMeta = {\n      handler,\n      pattern,\n      extensionId: options.extensionId,\n    };\n\n    this.wildcardHandlers.push(meta);\n\n    return () => {\n      const index = this.wildcardHandlers.findIndex((h) => h.handler === handler);\n      if (index >= 0) {\n        this.wildcardHandlers.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Check if an event matches a wildcard pattern\n   */\n  private matchWildcard(pattern: string, event: string): boolean {\n    // Handle single * that matches everything\n    if (pattern === '*') {\n      return true;\n    }\n\n    // Convert pattern to regex\n    // * matches any sequence of characters\n    // Escape special regex characters except *\n    const regexPattern = pattern\n      .replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&') // Escape regex special chars\n      .replace(/\\*/g, '.*'); // * becomes .*\n\n    const regex = new RegExp(`^${regexPattern}$`);\n    return regex.test(event);\n  }\n\n  // ============================================================================\n  // Request-Response Pattern\n  // ============================================================================\n\n  /**\n   * Register a request handler\n   */\n  onRequest<K extends keyof TRequests>(\n    method: K,\n    handler: (params: TRequests[K]) => unknown | Promise<unknown>,\n    options: { extensionId?: string } = {}\n  ): void {\n    const meta: RequestHandlerMeta = {\n      handler: handler as RequestHandler<unknown, unknown>,\n      extensionId: options.extensionId,\n    };\n\n    const handlers = this.requestHandlers.get(method) || [];\n    handlers.push(meta);\n    this.requestHandlers.set(method, handlers);\n  }\n\n  /**\n   * Make a request and wait for response\n   */\n  async request<K extends keyof TRequests>(\n    method: K,\n    params: TRequests[K],\n    _options: RequestOptions = {}\n  ): Promise<unknown> {\n    // Check if there are any handlers\n    const handlers = this.requestHandlers.get(method);\n    if (!handlers || handlers.length === 0) {\n      throw new Error(`No handler registered for request: ${String(method)}`);\n    }\n\n    // Try handlers in order until one returns a non-null result\n    for (const meta of handlers) {\n      try {\n        const result = await meta.handler(params);\n        if (result !== null && result !== undefined) {\n          return result;\n        }\n      } catch (error) {\n        this.handleError(`Error in request handler for ${String(method)}`, error);\n        throw error;\n      }\n    }\n\n    throw new Error(`All handlers returned null for request: ${String(method)}`);\n  }\n\n  // ============================================================================\n  // Extension Cleanup\n  // ============================================================================\n\n  /**\n   * Remove all listeners and handlers for a specific extension\n   *\n   * @param extensionId - Extension ID to cleanup\n   */\n  cleanup(extensionId: string): void {\n    for (const [event, handlers] of this.eventHandlers.entries()) {\n      const filtered = handlers.filter((h) => h.extensionId !== extensionId);\n      if (filtered.length === 0) {\n        this.eventHandlers.delete(event);\n      } else {\n        this.eventHandlers.set(event, filtered);\n      }\n    }\n\n    this.wildcardHandlers = this.wildcardHandlers.filter((h) => h.extensionId !== extensionId);\n\n    for (const [method, handlers] of this.requestHandlers.entries()) {\n      const filtered = handlers.filter((h) => h.extensionId !== extensionId);\n      if (filtered.length === 0) {\n        this.requestHandlers.delete(method);\n      } else {\n        this.requestHandlers.set(method, filtered);\n      }\n    }\n  }\n\n  cleanupAll(): void {\n    this.eventHandlers.clear();\n    this.wildcardHandlers = [];\n    this.requestHandlers.clear();\n    for (const req of this.pendingRequests.values()) {\n      req.reject(new Error('EventBus cleanup'));\n    }\n    this.pendingRequests.clear();\n  }\n\n  // ============================================================================\n  // Utility Methods\n  // ============================================================================\n\n  /**\n   * Get number of active event handlers for an event\n   */\n  listenerCount<K extends keyof TEvents>(event: K): number {\n    const handlers = this.eventHandlers.get(event);\n    return handlers?.length || 0;\n  }\n\n  /**\n   * Get all registered event names\n   */\n  eventNames(): (keyof TEvents)[] {\n    return Array.from(this.eventHandlers.keys());\n  }\n\n  /**\n   * Remove all listeners (use with caution)\n   */\n  removeAllListeners(): void {\n    this.eventHandlers.clear();\n    this.wildcardHandlers = [];\n    this.requestHandlers.clear();\n\n    // Cancel all pending requests\n    for (const request of this.pendingRequests.values()) {\n      if (request.timer) {\n        clearTimeout(request.timer);\n      }\n      request.reject(new Error('EventBus destroyed'));\n    }\n    this.pendingRequests.clear();\n  }\n\n  // ============================================================================\n  // Private Helpers\n  // ============================================================================\n\n  private handleError(message: string, error: unknown): void {\n    if (this.options.catchErrors) {\n      this.options.logger.error(`${message}: ${error instanceof Error ? error.message : String(error)}`);\n    } else {\n      throw error;\n    }\n  }\n\n  private createDefaultLogger(): ExtensionLogger {\n    return {\n      debug: () => {},\n      info: () => {},\n      warn: console.warn,\n      error: console.error,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,IAAa,gBAAb,MAIE;CACA,gCAAwB,IAAI,KAAwC;CACpE,mBAAkD,EAAE;CACpD,kCAA0B,IAAI,KAA4C;CAC1E,kCAA0B,IAAI,KAA8B;CAC5D;CACA,mBAA2B;CAE3B,YAAY,UAAgC,EAAE,EAAE;AAC9C,OAAK,UAAU;GACb,gBAAgB,QAAQ,kBAAkB;GAC1C,aAAa,QAAQ,eAAe;GACpC,QAAQ,QAAQ,UAAU,KAAK,qBAAqB;GACrD;;;;;;;;;;CAeH,GACE,OACA,SACA,UAAoD,EAAE,EAC1C;EACZ,MAAM,OAAyB;GACpB;GACT,aAAa,QAAQ;GACrB,MAAM,QAAQ;GACf;EAED,MAAM,WAAW,KAAK,cAAc,IAAI,MAAM,IAAI,EAAE;AACpD,WAAS,KAAK,KAAK;AACnB,OAAK,cAAc,IAAI,OAAO,SAAS;AAGvC,eAAa;AACX,QAAK,IAAI,OAAO,QAAQ;;;;;;;;;CAU5B,IAA6B,OAAU,SAAyC;EAC9E,MAAM,WAAW,KAAK,cAAc,IAAI,MAAM;AAC9C,MAAI,CAAC,SAAU;EAEf,MAAM,QAAQ,SAAS,WAAW,MAAM,EAAE,YAAY,QAAQ;AAC9D,MAAI,SAAS,GAAG;AACd,YAAS,OAAO,OAAO,EAAE;AACzB,OAAI,SAAS,WAAW,EACtB,MAAK,cAAc,OAAO,MAAM;;;;;;;;;CAWtC,KAA8B,OAAU,MAAwB;EAE9D,MAAM,WAAW,KAAK,cAAc,IAAI,MAAM;AAC9C,MAAI,UAAU;GAEZ,MAAM,mBAA6B,EAAE;AAErC,YAAS,SAAS,MAAM,UAAU;AAChC,QAAI;AACF,UAAK,QAAQ,KAAK;AAClB,SAAI,KAAK,KACP,kBAAiB,KAAK,MAAM;aAEvB,OAAO;AACd,UAAK,YAAY,8BAA8B,OAAO,MAAM,IAAI,MAAM;;KAExE;AAGF,QAAK,IAAI,IAAI,iBAAiB,SAAS,GAAG,KAAK,GAAG,IAChD,UAAS,OAAO,iBAAiB,IAAI,EAAE;AAGzC,OAAI,SAAS,WAAW,EACtB,MAAK,cAAc,OAAO,MAAM;;AAKpC,OAAK,iBAAiB,SAAS,SAAS;AACtC,OAAI,KAAK,cAAc,KAAK,SAAS,OAAO,MAAM,CAAC,CACjD,KAAI;AACF,SAAK,QAAQ,MAAM,OAAO,MAAM,CAAC;YAC1B,OAAO;AACd,SAAK,YAAY,iCAAiC,OAAO,MAAM,IAAI,MAAM;;IAG7E;;;;;;;;;;CAeJ,WACE,SACA,SACA,UAAoC,EAAE,EAC1B;EACZ,MAAM,OAA4B;GAChC;GACA;GACA,aAAa,QAAQ;GACtB;AAED,OAAK,iBAAiB,KAAK,KAAK;AAEhC,eAAa;GACX,MAAM,QAAQ,KAAK,iBAAiB,WAAW,MAAM,EAAE,YAAY,QAAQ;AAC3E,OAAI,SAAS,EACX,MAAK,iBAAiB,OAAO,OAAO,EAAE;;;;;;CAQ5C,cAAsB,SAAiB,OAAwB;AAE7D,MAAI,YAAY,IACd,QAAO;EAMT,MAAM,eAAe,QAClB,QAAQ,qBAAqB,OAAO,CACpC,QAAQ,OAAO,KAAK;AAGvB,SAAO,IADW,OAAO,IAAI,aAAa,GAC9B,CAAC,KAAK,MAAM;;;;;CAU1B,UACE,QACA,SACA,UAAoC,EAAE,EAChC;EACN,MAAM,OAA2B;GACtB;GACT,aAAa,QAAQ;GACtB;EAED,MAAM,WAAW,KAAK,gBAAgB,IAAI,OAAO,IAAI,EAAE;AACvD,WAAS,KAAK,KAAK;AACnB,OAAK,gBAAgB,IAAI,QAAQ,SAAS;;;;;CAM5C,MAAM,QACJ,QACA,QACA,WAA2B,EAAE,EACX;EAElB,MAAM,WAAW,KAAK,gBAAgB,IAAI,OAAO;AACjD,MAAI,CAAC,YAAY,SAAS,WAAW,EACnC,OAAM,IAAI,MAAM,sCAAsC,OAAO,OAAO,GAAG;AAIzE,OAAK,MAAM,QAAQ,SACjB,KAAI;GACF,MAAM,SAAS,MAAM,KAAK,QAAQ,OAAO;AACzC,OAAI,WAAW,QAAQ,WAAW,KAAA,EAChC,QAAO;WAEF,OAAO;AACd,QAAK,YAAY,gCAAgC,OAAO,OAAO,IAAI,MAAM;AACzE,SAAM;;AAIV,QAAM,IAAI,MAAM,2CAA2C,OAAO,OAAO,GAAG;;;;;;;CAY9E,QAAQ,aAA2B;AACjC,OAAK,MAAM,CAAC,OAAO,aAAa,KAAK,cAAc,SAAS,EAAE;GAC5D,MAAM,WAAW,SAAS,QAAQ,MAAM,EAAE,gBAAgB,YAAY;AACtE,OAAI,SAAS,WAAW,EACtB,MAAK,cAAc,OAAO,MAAM;OAEhC,MAAK,cAAc,IAAI,OAAO,SAAS;;AAI3C,OAAK,mBAAmB,KAAK,iBAAiB,QAAQ,MAAM,EAAE,gBAAgB,YAAY;AAE1F,OAAK,MAAM,CAAC,QAAQ,aAAa,KAAK,gBAAgB,SAAS,EAAE;GAC/D,MAAM,WAAW,SAAS,QAAQ,MAAM,EAAE,gBAAgB,YAAY;AACtE,OAAI,SAAS,WAAW,EACtB,MAAK,gBAAgB,OAAO,OAAO;OAEnC,MAAK,gBAAgB,IAAI,QAAQ,SAAS;;;CAKhD,aAAmB;AACjB,OAAK,cAAc,OAAO;AAC1B,OAAK,mBAAmB,EAAE;AAC1B,OAAK,gBAAgB,OAAO;AAC5B,OAAK,MAAM,OAAO,KAAK,gBAAgB,QAAQ,CAC7C,KAAI,uBAAO,IAAI,MAAM,mBAAmB,CAAC;AAE3C,OAAK,gBAAgB,OAAO;;;;;CAU9B,cAAuC,OAAkB;AAEvD,SADiB,KAAK,cAAc,IAAI,MACzB,EAAE,UAAU;;;;;CAM7B,aAAgC;AAC9B,SAAO,MAAM,KAAK,KAAK,cAAc,MAAM,CAAC;;;;;CAM9C,qBAA2B;AACzB,OAAK,cAAc,OAAO;AAC1B,OAAK,mBAAmB,EAAE;AAC1B,OAAK,gBAAgB,OAAO;AAG5B,OAAK,MAAM,WAAW,KAAK,gBAAgB,QAAQ,EAAE;AACnD,OAAI,QAAQ,MACV,cAAa,QAAQ,MAAM;AAE7B,WAAQ,uBAAO,IAAI,MAAM,qBAAqB,CAAC;;AAEjD,OAAK,gBAAgB,OAAO;;CAO9B,YAAoB,SAAiB,OAAsB;AACzD,MAAI,KAAK,QAAQ,YACf,MAAK,QAAQ,OAAO,MAAM,GAAG,QAAQ,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GAAG;MAElG,OAAM;;CAIV,sBAA+C;AAC7C,SAAO;GACL,aAAa;GACb,YAAY;GACZ,MAAM,QAAQ;GACd,OAAO,QAAQ;GAChB"}

package/dist/src/extensions/types/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","names":[],"sources":["../../../../src/extensions/types/hooks.ts"],"sourcesContent":["/**\n * Extension System - Hook Types\n * \n * Hook events, handlers, and context types.\n *  Strongly typed hook system with execution modes.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n// Re-export AgentMessage for use in hook system\nexport type { AgentMessage };\n\n// ============================================================================\n// Hook Event Types ( Strongly Typed)\n// ============================================================================\n\nexport type ExtensionHookEvent = \n  // Existing hooks\n  | 'before_agent_start'\n  | 'agent_end'\n  | 'before_compaction'\n  | 'after_compaction'\n  | 'message_received'\n  | 'message_sending'\n  | 'message_sent'\n  | 'before_tool_call'\n  | 'after_tool_call'\n  | 'session_start'\n  | 'session_end'\n  | 'gateway_start'\n  | 'gateway_stop'\n  //  Enhanced hooks\n  | 'context'\n  | 'input'\n  | 'turn_start'\n  | 'turn_end'\n  //  Tool execution lifecycle\n  | 'tool_execution_start'\n  | 'tool_execution_update'\n  | 'tool_execution_end'\n  //  LLM Observation hooks\n  | 'before_model_resolve'\n  | 'before_prompt_build'\n  | 'llm_input'\n  | 'llm_output'\n  //  Inbound claim hook\n  | 'inbound_claim'\n  //  Reset hook\n  | 'before_reset'\n  //  Message write hook\n  | 'before_message_write'\n  // Sub-agent lifecycle (openclaw parity surface)\n  | 'subagent_spawning'\n  | 'subagent_delivery_target'\n  | 'subagent_ended'\n  /** After a webchat direct stream finishes (success or error); session lock released. */\n  | 'webchat_turn_complete';\n\n// ============================================================================\n// Hook Execution Modes \n// ============================================================================\n\n/**\n * Hook execution mode determines how handlers are processed:\n * - void: Fire-and-forget, parallel execution (for notifications)\n * - modifying: Sequential execution, results merge (for modifications)\n * - claiming: First handler to return handled:true wins (for exclusive handling)\n */\nexport type HookExecutionMode = 'void' | 'modifying' | 'claiming';\n\n/**\n * Maps each hook event to its execution mode\n */\nexport const HOOK_EXECUTION_MODES: Record<ExtensionHookEvent, HookExecutionMode> = {\n  // Void: Fire-and-forget, parallel execution\n  'message_received': 'void',\n  'message_sent': 'void',\n  'agent_end': 'void',\n  'llm_input': 'void',\n  'llm_output': 'void',\n  'after_tool_call': 'void',\n  'session_start': 'void',\n  'session_end': 'void',\n  'gateway_start': 'void',\n  'gateway_stop': 'void',\n  'before_compaction': 'void',\n  'after_compaction': 'void',\n  'turn_start': 'void',\n  'turn_end': 'void',\n  'tool_execution_start': 'void',\n  'tool_execution_update': 'void',\n  'tool_execution_end': 'void',\n  'before_reset': 'void',\n  'subagent_ended': 'void',\n  'webchat_turn_complete': 'void',\n  \n  // Modifying: Sequential execution, results merge\n  'before_agent_start': 'modifying',\n  'before_model_resolve': 'modifying',\n  'before_prompt_build': 'modifying',\n  'message_sending': 'modifying',\n  'before_tool_call': 'modifying',\n  'context': 'modifying',\n  'input': 'modifying',\n  'before_message_write': 'modifying',\n  'subagent_spawning': 'modifying',\n  'subagent_delivery_target': 'modifying',\n  \n  // Claiming: First handler with handled:true wins\n  'inbound_claim': 'claiming',\n};\n\n// ============================================================================\n// Untyped hook handler (extensions may use before wiring strong types)\n// ============================================================================\n\nexport type ExtensionHookHandler = (event: unknown, context?: unknown) => unknown | Promise<unknown>;\n\nexport interface HookOptions {\n  priority?: number;\n  once?: boolean;\n}\n\n// ============================================================================\n//  Strongly Typed Hook Handler Map\n// ============================================================================\n\n// Forward declarations for circular references\nexport interface HookAgentContext {\n  timestamp?: Date;\n  extensionId?: string;\n  sessionKey?: string;\n  agentId?: string;\n  isMcpTool?: boolean;\n  mcpServerId?: string;\n}\n\n// LLM Observation Hook Types\nexport interface HookBeforeModelResolveEvent {\n  prompt: string;\n  model?: string;\n  provider?: string;\n}\n\nexport interface HookBeforeModelResolveResult {\n  modelOverride?: string;\n  providerOverride?: string;\n}\n\nexport interface HookBeforePromptBuildEvent {\n  prompt: string;\n  messages?: Array<{ role: string; content: string }>;\n}\n\nexport interface HookBeforePromptBuildResult {\n  prompt?: string;\n  prependContext?: string;\n}\n\nexport interface HookLlmInputEvent {\n  runId: string;\n  provider: string;\n  model: string;\n  prompt: string;\n  systemPrompt?: string;\n  messages?: Array<{ role: string; content: string }>;\n  temperature?: number;\n  maxTokens?: number;\n}\n\nexport interface HookLlmOutputEvent {\n  runId: string;\n  provider: string;\n  model: string;\n  content: string;\n  usage?: {\n    input?: number;\n    output?: number;\n    total?: number;\n  };\n  finishReason?: string;\n}\n\n// Inbound Claim Hook Types\nexport interface HookInboundClaimEvent {\n  channelId: string;\n  from: string;\n  content: string;\n  timestamp?: Date;\n}\n\nexport interface HookInboundClaimResult {\n  handled: boolean;\n  response?: string;\n}\n\n// Before Reset Hook Types\nexport interface HookBeforeResetEvent {\n  sessionKey: string;\n  reason?: 'user_request' | 'timeout' | 'error' | 'manual';\n}\n\nexport interface HookBeforeResetResult {\n  allowReset: boolean;\n  reason?: string;\n}\n\n// Before Message Write Hook Types\nexport interface HookBeforeMessageWriteEvent {\n  channelId: string;\n  to: string;\n  content: string;\n}\n\nexport interface HookBeforeMessageWriteResult {\n  content?: string;\n  cancel?: boolean;\n  reason?: string;\n}\n\n// Turn Hook Types\nexport interface HookTurnStartEvent {\n  turnId: string;\n  prompt?: string;\n  agentId?: string;\n  sessionKey?: string;\n}\n\nexport interface HookTurnEndEvent {\n  turnId: string;\n  response?: string;\n  error?: string;\n  durationMs?: number;\n}\n\n// Tool Execution Hook Types\nexport interface HookToolExecutionStartEvent {\n  toolName: string;\n  params: Record<string, unknown>;\n  executionId: string;\n}\n\nexport interface HookToolExecutionUpdateEvent {\n  toolName: string;\n  executionId: string;\n  progress?: number;\n  message?: string;\n}\n\nexport interface HookToolExecutionEndEvent {\n  toolName: string;\n  executionId: string;\n  result?: unknown;\n  error?: string;\n  durationMs?: number;\n}\n\n// ============================================================================\n// Sub-agent hook types (delegate_task + future subagent sessions)\n// ============================================================================\n\nexport interface HookSubagentSpawningEvent {\n  childSessionKey: string;\n  requester?: {\n    channel?: string;\n    accountId?: string;\n    to?: string;\n    threadId?: string | number;\n  };\n  threadRequested?: boolean;\n  agentId?: string;\n  label?: string;\n}\n\nexport type HookSubagentSpawningResult =\n  | { status: 'ok'; threadBindingReady?: boolean }\n  | { status: 'error'; error: string }\n  | void;\n\nexport interface HookSubagentDeliveryTargetEvent {\n  childSessionKey: string;\n  requesterSessionKey?: string;\n  requesterOrigin?: {\n    channel?: string;\n    accountId?: string;\n    to?: string;\n    threadId?: string | number;\n  };\n  expectsCompletionMessage?: boolean;\n}\n\nexport type HookSubagentDeliveryTargetResult =\n  | {\n      origin: {\n        channel: string;\n        accountId?: string;\n        to?: string;\n        threadId?: string | number;\n      };\n    }\n  | void;\n\nexport interface HookSubagentEndedEvent {\n  targetSessionKey: string;\n  accountId?: string;\n}\n\n// ============================================================================\n// Strongly Typed Handler Map \n// ============================================================================\n\n/**\n * Strongly typed handler map - each hook has precise event/result types\n */\nexport type HookHandlerMap = {\n  // Agent lifecycle\n  before_agent_start: (\n    event: BeforeAgentStartContext,\n    ctx: HookAgentContext,\n  ) => Promise<BeforeAgentStartResult | void> | BeforeAgentStartResult | void;\n  \n  before_model_resolve: (\n    event: HookBeforeModelResolveEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookBeforeModelResolveResult | void> | HookBeforeModelResolveResult | void;\n  \n  before_prompt_build: (\n    event: HookBeforePromptBuildEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookBeforePromptBuildResult | void> | HookBeforePromptBuildResult | void;\n  \n  llm_input: (\n    event: HookLlmInputEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  llm_output: (\n    event: HookLlmOutputEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  agent_end: (\n    event: AgentEndContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n\n  webchat_turn_complete: (\n    event: WebchatTurnCompleteEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  // Compaction\n  before_compaction: (\n    event: BeforeCompactionContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  after_compaction: (\n    event: AfterCompactionContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  // Messages\n  message_received: (\n    event: MessageReceivedContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  message_sending: (\n    event: MessageSendingContext,\n    ctx: HookAgentContext,\n  ) => Promise<MessageSendingResult | void> | MessageSendingResult | void;\n  \n  message_sent: (\n    event: MessageSentContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  inbound_claim: (\n    event: HookInboundClaimEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookInboundClaimResult | void> | HookInboundClaimResult | void;\n  \n  before_message_write: (\n    event: HookBeforeMessageWriteEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookBeforeMessageWriteResult | void> | HookBeforeMessageWriteResult | void;\n  \n  // Tools\n  before_tool_call: (\n    event: BeforeToolCallContext,\n    ctx: HookAgentContext,\n  ) => Promise<BeforeToolCallResult | void> | BeforeToolCallResult | void;\n  \n  after_tool_call: (\n    event: AfterToolCallContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  tool_execution_start: (\n    event: HookToolExecutionStartEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  tool_execution_update: (\n    event: HookToolExecutionUpdateEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  tool_execution_end: (\n    event: HookToolExecutionEndEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n\n  subagent_spawning: (\n    event: HookSubagentSpawningEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookSubagentSpawningResult> | HookSubagentSpawningResult;\n\n  subagent_delivery_target: (\n    event: HookSubagentDeliveryTargetEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookSubagentDeliveryTargetResult> | HookSubagentDeliveryTargetResult;\n\n  subagent_ended: (\n    event: HookSubagentEndedEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  // Session\n  session_start: (\n    event: SessionStartContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  session_end: (\n    event: SessionEndContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  // Gateway\n  gateway_start: (\n    event: GatewayStartContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  gateway_stop: (\n    event: GatewayStopContext,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  // Enhanced (xopc-specific)\n  context: (\n    event: ContextEvent,\n    ctx: HookAgentContext,\n  ) => Promise<ContextResult | void> | ContextResult | void;\n  \n  input: (\n    event: InputEvent,\n    ctx: HookAgentContext,\n  ) => Promise<InputResult | void> | InputResult | void;\n  \n  // Turn lifecycle\n  turn_start: (\n    event: HookTurnStartEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  turn_end: (\n    event: HookTurnEndEvent,\n    ctx: HookAgentContext,\n  ) => Promise<void> | void;\n  \n  // Reset\n  before_reset: (\n    event: HookBeforeResetEvent,\n    ctx: HookAgentContext,\n  ) => Promise<HookBeforeResetResult | void> | HookBeforeResetResult | void;\n};\n\n// ============================================================================\n// Shared hook context fields\n// ============================================================================\n\nexport interface HookContext {\n  timestamp?: Date;\n  extensionId?: string;\n  sessionKey?: string;\n  agentId?: string;\n  isMcpTool?: boolean;\n  mcpServerId?: string;\n}\n\nexport interface BeforeAgentStartContext extends HookContext {\n  prompt: string;\n  messages?: unknown[];\n}\n\nexport interface BeforeAgentStartResult {\n  systemPrompt?: string;\n  prependContext?: string;\n}\n\nexport interface AgentEndContext extends HookContext {\n  messages: unknown[];\n  success: boolean;\n  error?: string;\n  durationMs?: number;\n}\n\n/** Payload for {@link ExtensionHookEvent} `webchat_turn_complete` (also passed as `event` fields + ctx.sessionKey). */\nexport interface WebchatTurnCompleteEvent extends HookContext {\n  sessionKey: string;\n  /** Channel id (e.g. `telegram:default`, `webchat`) when the turn is not webchat-only. */\n  channel?: string;\n  chatId?: string;\n  /** Raw inbound user text from the POST body (before model envelope). */\n  inboundUserText: string;\n  /** Last assistant visible text after persistence (may be empty). */\n  assistantPlainText: string;\n  /** User aborted the HTTP/SSE run. */\n  aborted: boolean;\n  /** Set when the direct stream threw before normal completion. */\n  streamError?: string;\n}\n\nexport interface BeforeCompactionContext extends HookContext {\n  messageCount: number;\n  tokenCount?: number;\n}\n\nexport interface AfterCompactionContext extends HookContext {\n  messageCount: number;\n  tokenCount?: number;\n  compactedCount: number;\n}\n\nexport interface MessageReceivedContext extends HookContext {\n  channelId: string;\n  from: string;\n  content: string;\n  timestamp?: Date;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface MessageSendingContext extends HookContext {\n  to: string;\n  content: string;\n  /** Channel id (e.g. telegram) when sending through ChannelManager. */\n  channel?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface MessageSendingResult {\n  content?: string;\n  cancel?: boolean;\n  cancelReason?: string;\n}\n\nexport interface MessageSentContext extends HookContext {\n  to: string;\n  content: string;\n  success: boolean;\n  error?: string;\n  channel?: string;\n}\n\nexport interface BeforeToolCallContext extends HookContext {\n  toolName: string;\n  params: Record<string, unknown>;\n}\n\nexport interface BeforeToolCallResult {\n  params?: Record<string, unknown>;\n  block?: boolean;\n  blockReason?: string;\n}\n\nexport interface AfterToolCallContext extends HookContext {\n  toolName: string;\n  params: Record<string, unknown>;\n  result?: unknown;\n  error?: string;\n  durationMs?: number;\n}\n\nexport interface SessionStartContext extends HookContext {\n  sessionId: string;\n  resumedFrom?: string;\n}\n\nexport interface SessionEndContext extends HookContext {\n  sessionId: string;\n  reason?: 'completed' | 'error' | 'timeout' | 'user_request';\n}\n\nexport interface GatewayStartContext extends HookContext {\n  port: number;\n  host: string;\n}\n\nexport interface GatewayStopContext extends HookContext {\n  port: number;\n  reason?: string;\n}\n\n// ============================================================================\n// Enhanced Hook Event Types\n// ============================================================================\n\nexport interface ContextEvent {\n  messages: Array<{ role: string; content: string }>;\n  agentId?: string;\n  sessionKey?: string;\n}\n\nexport interface ContextResult {\n  messages: Array<{ role: string; content: string }>;\n}\n\nexport interface InputEvent {\n  text: string;\n  images?: string[];\n  channelId?: string;\n  from?: string;\n}\n\nexport interface InputResult {\n  action: 'continue' | 'handled' | 'blocked';\n  text?: string;\n  images?: string[];\n  response?: string;\n  skipAgent?: boolean;\n}\n\nexport interface TurnEvent {\n  turnId: string;\n  prompt?: string;\n  agentId?: string;\n  sessionKey?: string;\n}\n\nexport interface TurnResult {\n  context?: string;\n  skipTurn?: boolean;\n}\n"],"mappings":";;;;AAyEA,MAAa,uBAAsE;CAEjF,oBAAoB;CACpB,gBAAgB;CAChB,aAAa;CACb,aAAa;CACb,cAAc;CACd,mBAAmB;CACnB,iBAAiB;CACjB,eAAe;CACf,iBAAiB;CACjB,gBAAgB;CAChB,qBAAqB;CACrB,oBAAoB;CACpB,cAAc;CACd,YAAY;CACZ,wBAAwB;CACxB,yBAAyB;CACzB,sBAAsB;CACtB,gBAAgB;CAChB,kBAAkB;CAClB,yBAAyB;CAGzB,sBAAsB;CACtB,wBAAwB;CACxB,uBAAuB;CACvB,mBAAmB;CACnB,oBAAoB;CACpB,WAAW;CACX,SAAS;CACT,wBAAwB;CACxB,qBAAqB;CACrB,4BAA4B;CAG5B,iBAAiB;CAClB"}

package/dist/src/extensions/types/providers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"providers.js","names":[],"sources":["../../../../src/extensions/types/providers.ts"],"sourcesContent":["/**\n * Extension System - Provider Plugin Types\n * \n *  Provider plugin system for customizable LLM backends.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n// ============================================================================\n// Provider Plugin Interface\n// ============================================================================\n\nexport interface ProviderPlugin {\n  /** Unique provider identifier */\n  id: string;\n  /** Human-readable name */\n  name: string;\n  /** Provider description */\n  description?: string;\n  /** Supported model definitions */\n  models: ProviderModelDefinition[];\n  /** Create a streaming response */\n  createStream(params: ProviderStreamParams): AsyncIterable<ProviderStreamChunk>;\n  /** Check if the provider is properly configured */\n  isConfigured?(config: Record<string, unknown>): boolean;\n  /** Get required environment variables */\n  requiredEnvVars?(): string[];\n  /** Get default model */\n  defaultModel?: string;\n  /** Supported capabilities */\n  capabilities?: ProviderCapabilities;\n}\n\nexport interface ProviderModelDefinition {\n  /** Model ID */\n  id: string;\n  /** Display name */\n  name: string;\n  /** Context window size in tokens */\n  contextWindow?: number;\n  /** Maximum output tokens */\n  maxOutputTokens?: number;\n  /** Supports image input */\n  supportsImages?: boolean;\n  /** Supports tool/function calling */\n  supportsTools?: boolean;\n  /** Supports streaming */\n  supportsStreaming?: boolean;\n  /** Supports JSON mode */\n  supportsJson?: boolean;\n  /** Pricing info */\n  pricing?: {\n    input: number;  // per 1M tokens\n    output: number;\n  };\n}\n\nexport interface ProviderCapabilities {\n  /** Supports multimodal input */\n  multimodal?: boolean;\n  /** Supports function calling */\n  functionCalling?: boolean;\n  /** Supports JSON output */\n  json?: boolean;\n  /** Supports system prompts */\n  systemPrompt?: boolean;\n  /** Supports temperature control */\n  temperature?: boolean;\n  /** Supports max tokens control */\n  maxTokens?: boolean;\n  /** Supports vision/image input */\n  vision?: boolean;\n  /** Supports streaming */\n  streaming?: boolean;\n}\n\nexport interface ProviderStreamParams {\n  /** Model ID */\n  model: string;\n  /** System prompt supplied to the provider request */\n  systemPrompt?: string;\n  /** Chat messages */\n  messages: Array<AgentMessage>;\n  /** Temperature (0-2) */\n  temperature?: number;\n  /** Maximum tokens to generate */\n  maxTokens?: number;\n  /** Tools/function definitions */\n  tools?: unknown[];\n  /** API key resolved for this provider, when available */\n  apiKey?: string;\n  /** Session identifier for provider-side caching/routing */\n  sessionId?: string;\n  /** Reasoning/thinking level requested by the agent runtime */\n  reasoning?: string;\n  /** Custom HTTP headers requested by the agent runtime */\n  headers?: Record<string, string>;\n  /** Request timeout in milliseconds */\n  timeoutMs?: number;\n  /** Maximum provider retry attempts */\n  maxRetries?: number;\n  /** Provider request metadata */\n  metadata?: Record<string, unknown>;\n  /** Prompt cache retention preference */\n  cacheRetention?: string;\n  /** Preferred transport, if the provider supports multiple transports */\n  transport?: string;\n  /** Custom token budgets for thinking levels */\n  thinkingBudgets?: {\n    minimal?: number;\n    low?: number;\n    medium?: number;\n    high?: number;\n  };\n  /** Stop sequences */\n  stop?: string[];\n  /** Presence penalty */\n  presencePenalty?: number;\n  /** Frequency penalty */\n  frequencyPenalty?: number;\n  /** Top-p nucleus sampling */\n  topP?: number;\n  /** Abort signal */\n  signal?: AbortSignal;\n  /** Additional provider-specific params */\n  extra?: Record<string, unknown>;\n}\n\nexport interface ProviderStreamChunk {\n  /** Chunk type */\n  type: 'text' | 'tool_call' | 'usage' | 'done' | 'error';\n  /** Text content */\n  text?: string;\n  /** Tool call (function calling) */\n  toolCall?: {\n    id: string;\n    name: string;\n    arguments: string;  // JSON string\n  };\n  /** Token usage */\n  usage?: {\n    input: number;\n    output: number;\n    total?: number;\n  };\n  /** Error message */\n  error?: string;\n  /** Finish reason */\n  finishReason?: 'stop' | 'length' | 'content_filter' | 'tool_calls' | null;\n}\n\n// ============================================================================\n// Non-Streaming Provider (for simple providers)\n// ============================================================================\n\nexport interface ProviderCompleteParams extends ProviderStreamParams {\n  /** Wait for complete response instead of streaming */\n  stream?: false;\n}\n\nexport interface ProviderResponse {\n  /** Response content */\n  content: string;\n  /** Tool calls */\n  toolCalls?: Array<{\n    id: string;\n    name: string;\n    arguments: Record<string, unknown>;\n  }>;\n  /** Token usage */\n  usage?: {\n    input: number;\n    output: number;\n    total: number;\n  };\n  /** Finish reason */\n  finishReason: 'stop' | 'length' | 'content_filter' | 'tool_calls';\n  /** Model used */\n  model: string;\n  /** Provider ID */\n  provider: string;\n}\n\n// ============================================================================\n// Provider Registry\n// ============================================================================\n\nexport interface ProviderRegistry {\n  /** Register a provider */\n  register(provider: ProviderPlugin): void;\n  /** Get a provider by ID */\n  get(id: string): ProviderPlugin | undefined;\n  /** List all providers */\n  listAll(): ProviderPlugin[];\n  /** Get models for a provider */\n  getModels(providerId: string): ProviderModelDefinition[];\n  /** Check if a provider is registered */\n  has(id: string): boolean;\n  /** Remove a provider */\n  unregister(id: string): boolean;\n}\n\n// ============================================================================\n// Built-in Provider IDs\n// ============================================================================\n\nexport const BUILTIN_PROVIDERS = {\n  OPENAI: 'openai',\n  ANTHROPIC: 'anthropic',\n  GEMINI: 'gemini',\n  OLLAMA: 'ollama',\n  CUSTOM: 'custom',\n} as const;\n\nexport type BuiltinProviderId = typeof BUILTIN_PROVIDERS[keyof typeof BUILTIN_PROVIDERS];\n"],"mappings":";AA8MA,MAAa,oBAAoB;CAC/B,QAAQ;CACR,WAAW;CACX,QAAQ;CACR,QAAQ;CACR,QAAQ;CACT"}