npm - @xopcai/xopc - Versions diffs - 0.0.28 → 0.0.29 - Mend

@xopcai/xopc 0.0.28 → 0.0.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (160) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"loader.js","names":["apiImpl"],"sources":["../../../src/extensions/loader.ts"],"sourcesContent":["/*\n Extension Loader and Registry\n * \n * Supports three-tier extension storage:\n * 1. Workspace level (workspace/.extensions/) - highest priority\n * 2. Global level (~/.xopc/extensions/) - shared across workspaces\n * 3. Bundled level (xopc/extensions/) - shipped with xopc\n /\n\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport { join, dirname, isAbsolute } from 'path';\nimport { fileURLToPath } from 'node:url';\nimport { createRequire } from 'node:module';\nimport { createJiti } from 'jiti';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport { loadConfig } from '../config/loader.js';\nimport {\n resolveAgentWorkspaceDir,\n resolveExtensionsDir,\n resolveWorkspaceExtensionsDir,\n resolveBundledExtensionsDir,\n resolveExtensionSdkPath,\n} from '../config/paths.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionManager } from '../session/manager.js';\nimport type { AgentTool } from '@mariozechner/pi-agent-core';\nimport type {\n ExtensionApi,\n ExtensionModule,\n ExtensionRegistry,\n ExtensionCliRegistration,\n GatewayMethodHandler,\n HttpRequestHandler,\n ExtensionCommand,\n ExtensionReloadRegistration,\n ExtensionService,\n ExtensionHookEvent,\n ExtensionHookHandler,\n ExtensionManifest,\n ExtensionRecord,\n ResolvedExtensionConfig,\n DiscoveredExtension,\n} from './types/index.js';\nimport type { ActivationContext } from './activation-planner.js';\nimport { ActivationPlanner } from './activation-planner.js';\nimport { mergeActivationContext } from './activation-context.js';\nimport { ManifestRegistry } from './manifest-registry.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport { checkEngineCompatibility } from './engine-check.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport { bundledChannelPlugins } from '../channels/plugins/bundled.js';\nimport { ExtensionApiImpl, createExtensionLogger, createPathResolver } from './api.js';\nimport { 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\n// Extension source origin for debugging\nexport type ExtensionSourceOrigin = 'workspace' \| 'global' \| 'bundled' \| 'config';\n\n// ============================================================================\n// Extension Registry\n// ============================================================================\n\nexport class ExtensionRegistryImpl implements ExtensionRegistry {\n extensions = new Map<string, ExtensionRecord>();\n hooks = new Map<ExtensionHookEvent, ExtensionHookHandler[]>();\n httpRoutes = new Map<string, HttpRequestHandler>();\n commands = new Map<string, ExtensionCommand>();\n services = new Map<string, ExtensionService>();\n gatewayMethods = new Map<string, GatewayMethodHandler>();\n tools: Map<string, AgentTool<any, any>> = new Map();\n channelPlugins: ChannelPlugin[] = [];\n private cliRegistrations: ExtensionCliRegistration[] = [];\n private reloadRegistrations: ExtensionReloadRegistration[] = [];\n\n addExtension(record: ExtensionRecord): void {\n this.extensions.set(record.id, record);\n }\n\n getExtension(id: string): ExtensionRecord \| undefined {\n return this.extensions.get(id);\n }\n\n getEnabledExtensions(): ExtensionRecord[] {\n return Array.from(this.extensions.values()).filter((p) => p.enabled);\n }\n\n addHook(\n event: ExtensionHookEvent,\n handler: ExtensionHookHandler,\n extensionId: string,\n _priority = 0,\n ): void {\n if (!this.hooks.has(event)) {\n this.hooks.set(event, []);\n }\n this.hooks.get(event)!.push(handler);\n }\n\n getHooks(event: ExtensionHookEvent): ExtensionHookHandler[] {\n return this.hooks.get(event) \|\| [];\n }\n\n addChannelPlugin(plugin: ChannelPlugin): void {\n this.channelPlugins = this.channelPlugins.filter((p) => p.id !== plugin.id);\n this.channelPlugins.push(plugin);\n }\n\n addHttpRoute(path: string, handler: HttpRequestHandler): void {\n if (this.httpRoutes.has(path)) {\n log.warn({ path }, `HTTP route already registered, overwriting`);\n }\n this.httpRoutes.set(path, handler);\n }\n\n getHttpRoute(path: string): HttpRequestHandler \| undefined {\n return this.httpRoutes.get(path);\n }\n\n addCommand(command: ExtensionCommand): void {\n if (this.commands.has(command.name)) {\n log.warn({ command: command.name }, `Command already registered, overwriting`);\n }\n this.commands.set(command.name, command);\n }\n\n getCommand(name: string): ExtensionCommand \| undefined {\n return this.commands.get(name);\n }\n\n addService(service: ExtensionService): void {\n if (this.services.has(service.id)) {\n log.warn({ service: service.id }, `Service already registered, overwriting`);\n }\n this.services.set(service.id, service);\n }\n\n getService(id: string): ExtensionService \| undefined {\n return this.services.get(id);\n }\n\n addGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n if (this.gatewayMethods.has(method)) {\n log.warn({ method }, `Gateway method already registered, overwriting`);\n }\n this.gatewayMethods.set(method, handler);\n }\n\n getGatewayMethod(method: string): GatewayMethodHandler \| undefined {\n return this.gatewayMethods.get(method);\n }\n\n // Tools\n addTool(tool: any): void {\n if (this.tools.has(tool.name)) {\n log.warn({ tool: tool.name }, `Tool already registered, overwriting`);\n }\n this.tools.set(tool.name, tool);\n }\n\n removeTool(name: string): void {\n this.tools.delete(name);\n }\n\n getTools(): Map<string, any> {\n return this.tools;\n }\n\n getTool(name: string): any \| undefined {\n return this.tools.get(name);\n }\n\n getAllTools(): any[] {\n return Array.from(this.tools.values());\n }\n\n addCliRegistration(reg: ExtensionCliRegistration): void {\n this.cliRegistrations.push(reg);\n }\n\n getCliRegistrations(): readonly ExtensionCliRegistration[] {\n return this.cliRegistrations;\n }\n\n addReloadRegistration(reg: ExtensionReloadRegistration): void {\n this.reloadRegistrations = this.reloadRegistrations.filter(\n (r) => r.extensionId !== reg.extensionId,\n );\n this.reloadRegistrations.push(reg);\n }\n\n removeReloadRegistration(extensionId: string): void {\n this.reloadRegistrations = this.reloadRegistrations.filter(\n (r) => r.extensionId !== extensionId,\n );\n }\n\n getReloadRegistrations(): readonly ExtensionReloadRegistration[] {\n return this.reloadRegistrations;\n }\n\n getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[] {\n return this.reloadRegistrations.filter((reg) => {\n if (reg.configPrefixes.length === 0) {\n return true;\n }\n return reg.configPrefixes.some((prefix) =>\n changedPaths.some((path) => path === prefix \|\| path.startsWith(`${prefix}.`)),\n );\n });\n }\n}\n\n// ============================================================================\n// Extension Loader\n// ============================================================================\n\nexport interface ExtensionLoaderOptions {\n workspaceDir?: string;\n extensionsDir?: string;\n bundledExtensions?: string[];\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?: { bus: MessageBus; sessionManager?: SessionManager };\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\n constructor(options?: ExtensionLoaderOptions) {\n this.registry = new ExtensionRegistryImpl();\n for (const p of bundledChannelPlugins) {\n this.registry.addChannelPlugin(p);\n }\n this.options = options \|\| (() => {\n const c = loadConfig();\n const aid = resolveDefaultAgentId(c);\n return {\n workspaceDir: resolveAgentWorkspaceDir(c, aid),\n extensionsDir: resolveWorkspaceExtensionsDir(c, aid),\n };\n })();\n\n // Initialize security config\n this.securityConfig = DEFAULT_SECURITY_CONFIG;\n \n // Initialize provider registry\n this.providerRegistry = getProviderRegistry();\n \n // Initialize slot registry\n this.slotRegistry = getSlotRegistry();\n \n // Initialize cache and diagnostics \n this.cache = getExtensionCache();\n this.diagnostics = getExtensionDiagnostics();\n\n // Build jiti alias for extension-sdk (+ subpath entry points)\n const alias: Record<string, string> = {};\n const sdkPath = resolveExtensionSdkPath();\n if (sdkPath) {\n alias['xopc/extension-sdk'] = sdkPath;\n const sdkDir = dirname(sdkPath);\n alias['xopc/extension-sdk/core'] = join(sdkDir, 'core.ts');\n alias['xopc/extension-sdk/lazy'] = join(sdkDir, 'lazy.ts');\n alias['xopc/extension-sdk/provider'] = join(sdkDir, 'provider.ts');\n alias['xopc/extension-sdk/channel'] = join(sdkDir, 'channel.ts');\n alias['xopc/extension-sdk/hooks'] = join(sdkDir, 'hooks.ts');\n alias['xopc/extension-sdk/tools'] = join(sdkDir, 'tools.ts');\n alias['xopc/extension-sdk/testing'] = join(sdkDir, 'testing.ts');\n }\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 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: { bus: MessageBus; sessionManager?: SessionManager }): void {\n this._runtimeContext = ctx;\n }\n\n getRegistry(): ExtensionRegistryImpl {\n return this.registry;\n }\n\n /\n Phase 1: build manifest registry (filesystem manifests only, no extension code load).\n /\n buildManifestRegistry(): ManifestRegistry {\n if (this.manifestRegistry) {\n return this.manifestRegistry;\n }\n const discovered = this.discoverExtensions();\n this.manifestRegistry = ManifestRegistry.fromDiscovered(discovered);\n return this.manifestRegistry;\n }\n\n /\n Phase 2: activation planner over the manifest registry (pure logic).\n /\n planActivation(_context?: Partial<ActivationContext>): ActivationPlanner {\n return new ActivationPlanner(this.buildManifestRegistry());\n }\n\n /\n Phase 3: load only extensions selected by the activation plan.\n /\n async loadByActivationPlan(context?: Partial<ActivationContext>): Promise<void> {\n const registry = this.buildManifestRegistry();\n const planner = new ActivationPlanner(registry);\n const fullContext = mergeActivationContext(this._appConfig, context);\n const activatedIds = planner.getActivatedIds(fullContext).sort((a, b) => a.localeCompare(b));\n\n for (const extensionId of activatedIds) {\n if (this.extensionInstances.has(extensionId)) continue;\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 continue;\n }\n\n const config: ResolvedExtensionConfig = {\n id: extensionId,\n name: entry.manifest.name \|\| extensionId,\n source: entry.source,\n path: entry.path,\n enabled: true,\n config: this.resolveExtensionConfig(extensionId),\n };\n\n await this.loadExtension(config);\n }\n }\n\n getManifestRegistry(): ManifestRegistry {\n return this.buildManifestRegistry();\n }\n\n invalidateManifestCache(): void {\n this.manifestRegistry = 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 const discovered = new Map<string, DiscoveredExtension>();\n\n // Priority 3: Bundled extensions (lowest)\n const bundledDir = resolveBundledExtensionsDir();\n if (bundledDir) {\n this.discoverInDirectory(bundledDir, 'bundled', discovered);\n }\n\n // Priority 2: Global extensions\n const globalDir = resolveExtensionsDir();\n this.discoverInDirectory(globalDir, 'global', discovered);\n\n // Priority 1: Workspace extensions (highest, can override)\n const c = loadConfig();\n const aid = resolveDefaultAgentId(c);\n const workspaceExtensionsDir = resolveWorkspaceExtensionsDir(c, aid);\n this.discoverInDirectory(workspaceExtensionsDir, 'workspace', discovered);\n\n return Array.from(discovered.values());\n }\n\n private discoverInDirectory(\n dir: string,\n source: ExtensionSourceOrigin,\n discovered: Map<string, DiscoveredExtension>,\n ): void {\n if (!existsSync(dir)) {\n return;\n }\n\n let entries: string[];\n try {\n entries = readdirSync(dir);\n } catch {\n return;\n }\n\n for (const entry of entries) {\n const extensionPath = join(dir, entry);\n\n // Check if it's a directory\n try {\n const stat = existsSync(extensionPath);\n if (!stat) continue;\n } catch {\n continue;\n }\n\n // Try to load manifest\n const manifest = this.loadManifest(extensionPath);\n if (!manifest) continue;\n\n const extensionId = manifest.id \|\| entry;\n\n // Higher priority origins can override lower ones\n const existing = discovered.get(extensionId);\n if (existing) {\n const priority = { workspace: 3, global: 2, bundled: 1, config: 0 };\n if (priority[source] <= priority[existing.source]) {\n log.debug(\n { extensionId, from: source, existing: existing.source },\n 'Skipping lower priority extension',\n );\n continue;\n }\n log.info(\n { extensionId, from: source, overriding: existing.source },\n 'Extension override by higher priority source',\n );\n }\n\n discovered.set(extensionId, {\n id: extensionId,\n path: extensionPath,\n source,\n manifest,\n });\n }\n }\n\n /\n Load all discovered extensions\n /\n async loadAllExtensions(enabledIds?: string[]): Promise<void> {\n const extensions = this.discoverExtensions();\n\n for (const extension of extensions) {\n // If enabledIds specified, only load those\n if (enabledIds && !enabledIds.includes(extension.id)) {\n continue;\n }\n\n const config: ResolvedExtensionConfig = {\n id: extension.id,\n name: extension.manifest.name \|\| extension.id,\n source: extension.source,\n path: extension.path,\n enabled: true,\n config: {},\n };\n\n await this.loadExtension(config);\n }\n }\n\n async loadExtensions(configs: ResolvedExtensionConfig[]): Promise<void> {\n for (const extensionConfig of configs) {\n if (extensionConfig.enabled) {\n await this.loadExtension(extensionConfig);\n }\n }\n }\n\n async loadExtension(config: ResolvedExtensionConfig): Promise<ExtensionApi \| null> {\n try {\n // Check cache first\n const cacheKey = this.cache.buildKey(this.options, [config.id]);\n const cached = this.cache.get<ExtensionApi>(cacheKey);\n if (cached) {\n log.debug({ extensionId: config.id }, 'Extension loaded from cache');\n return cached;\n }\n\n // Check if already loaded\n if (this.extensionInstances.has(config.id)) {\n return this.extensionInstances.get(config.id)!;\n }\n\n // Resolve extension path using resolveExtensionPath\n let extensionPath: string \| null;\n if (isAbsolute(config.path)) {\n extensionPath = config.path;\n } else {\n // Try to resolve extension ID to actual path\n extensionPath = resolveExtensionPath(config.path, this.options) \|\|\n resolveExtensionPath(config.id, this.options);\n }\n \n if (!extensionPath) {\n log.error({ extensionId: config.id, path: config.path }, `Could not resolve extension path`);\n this.diagnostics.error(config.id, `Could not resolve extension path: ${config.path}`);\n return null;\n }\n\n log.debug({ extensionId: config.id, extensionPath }, 'Resolved extension path');\n\n // Security check\n const source = config.source \|\| 'bundled';\n const safetyResult = checkExtensionPathSafety(extensionPath, extensionPath, source);\n \n if (!safetyResult.safe) {\n logSecurityIssue(config.id, safetyResult);\n \n if (this.securityConfig.checkPermissions && source !== 'bundled') {\n // Check allowlist\n if (!isExtensionAllowed(config.id, this.securityConfig)) {\n this.diagnostics.error(config.id, `Extension not allowed: ${safetyResult.detail}`);\n log.error({ extensionId: config.id, reason: safetyResult.reason }, 'Extension blocked by security policy');\n return null;\n }\n }\n }\n\n // Track provenance \n provenanceTracker.track(config.id, source);\n\n const manifest = this.loadManifest(extensionPath);\n if (!manifest) {\n log.error({ extensionId: config.id, extensionPath }, `Failed to load manifest for extension`);\n this.diagnostics.error(config.id, `Failed to load manifest`);\n return null;\n }\n\n if (manifest.engines?.xopc) {\n const range = manifest.engines.xopc;\n const engineResult = checkEngineCompatibility(PACKAGE_VERSION, range);\n if (engineResult.parseWarning) {\n log.warn(\n { extensionId: config.id, range, reason: engineResult.reason },\n 'Engine range parse warning — loading anyway',\n );\n } else if (!engineResult.compatible) {\n log.warn(\n { extensionId: config.id, range, currentVersion: PACKAGE_VERSION },\n 'Extension engine requirement not met (engines.xopc) — skipping load',\n );\n this.diagnostics.error(\n config.id,\n engineResult.reason ?? 'Incompatible xopc version (engines.xopc)',\n );\n return null;\n }\n }\n\n // Validate extension config against schema (basic validation)\n if (manifest.configSchema) {\n try {\n const schema = manifest.configSchema as Record<string, unknown>;\n const extensionConfig = config.config as Record<string, unknown>;\n \n // Basic validation: check required fields and types\n if (schema.type === 'object' && schema.properties) {\n const props = schema.properties as Record<string, Record<string, unknown>>;\n const required = (schema.required as string[]) \|\| [];\n \n for (const field of required) {\n if (extensionConfig[field] === undefined) {\n log.error({ \n extensionId: config.id, \n field \n }, 'Extension config validation failed: missing required field');\n return null;\n }\n }\n \n for (const [key, value] of Object.entries(extensionConfig)) {\n const propSchema = props[key];\n if (propSchema) {\n if (propSchema.type && !this.validateType(value, propSchema.type as string)) {\n log.error({ \n extensionId: config.id, \n field: key,\n expected: propSchema.type,\n actual: typeof value\n }, 'Extension config validation failed: type mismatch');\n return null;\n }\n }\n }\n }\n \n log.debug({ extensionId: config.id }, 'Extension config validated');\n } catch (err) {\n log.warn({ err, extensionId: config.id }, 'Config schema validation skipped');\n }\n }\n\n // Create extension API\n const extensionDir = dirname(extensionPath);\n const api = this.createExtensionApi(manifest, config, extensionDir);\n\n // Load extension module\n const module = await this.loadModule(extensionPath, manifest);\n if (!module) {\n log.error({ extensionId: config.id }, `Failed to load module for extension`);\n this.diagnostics.error(config.id, `Failed to load module`);\n return null;\n }\n\n // Check and claim slots\n const slotClaimed = this.claimExtensionSlots(config.id, manifest);\n if (!slotClaimed) {\n log.warn({ extensionId: config.id }, 'Failed to claim required slots');\n }\n\n // Initialize extension\n await this.initializeExtension(module, api, manifest);\n\n // 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 'image-generation': 'imageGeneration',\n 'imageGeneration': 'imageGeneration',\n 'web-search': 'webSearch',\n 'webSearch': 'webSearch',\n };\n \n const slotKey = slotMap[kind];\n if (!slotKey) {\n return true; // No slot required\n }\n \n // Check if slot is reserved for a different plugin in config\n const preferredPlugin = this.slotsConfig[slotKey];\n if (preferredPlugin && preferredPlugin !== extensionId) {\n log.info(\n { extensionId, slotKey, preferredPlugin },\n `Skipping slot claim: slot \"${slotKey}\" is reserved for \"${preferredPlugin}\"`\n );\n this.diagnostics.info(\n extensionId,\n `Slot \"${slotKey}\" is reserved for \"${preferredPlugin}\", skipping claim`\n );\n return false;\n }\n \n const claimed = this.slotRegistry.claim(slotKey, extensionId, null);\n if (!claimed) {\n this.diagnostics.warn(extensionId, `Slot \"${slotKey}\" already claimed by another extension`);\n }\n return claimed;\n }\n\n loadManifest(extensionPath: string): ExtensionManifest \| null {\n const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n // First try to load xopc.extension.json\n if (existsSync(manifestPath)) {\n try {\n const raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n if (!raw \|\| typeof raw !== 'object' \|\| Array.isArray(raw)) {\n log.error({ manifestPath }, 'Manifest root must be a JSON object');\n return null;\n }\n return normalizeExtensionManifest(raw as Record<string, unknown>);\n } catch (error) {\n log.error({ err: error, manifestPath }, `Failed to parse manifest`);\n return null;\n }\n }\n\n // Fallback to package.json\n const packagePath = join(extensionPath, 'package.json');\n if (existsSync(packagePath)) {\n try {\n const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n \n // Check for xopc.extension marker\n if (packageJson.xopc?.extension) {\n const xopcConfig = packageJson.xopc;\n return normalizeExtensionManifest({\n id: xopcConfig.id \|\| packageJson.name,\n name: xopcConfig.name \|\| packageJson.name,\n description: xopcConfig.description \|\| packageJson.description,\n version: xopcConfig.version \|\| packageJson.version \|\| '1.0.0',\n kind: xopcConfig.kind \|\| 'utility',\n main: xopcConfig.main \|\| packageJson.main \|\| 'index.js',\n configSchema: xopcConfig.configSchema,\n });\n }\n\n // Also support xopc-extension- naming convention\n if (packageJson.name?.startsWith('xopc-extension-')) {\n const id = packageJson.name.replace('xopc-extension-', '');\n return normalizeExtensionManifest({\n id,\n name: packageJson.name,\n description: packageJson.description,\n version: packageJson.version \|\| '1.0.0',\n kind: 'utility',\n main: packageJson.main \|\| 'index.js',\n });\n }\n } catch (error) {\n log.error({ err: error, packagePath }, `Failed to parse package.json`);\n }\n }\n\n return null;\n }\n\n private async loadModule(\n extensionPath: string,\n manifest: ExtensionManifest,\n ): Promise<ExtensionModule \| null> {\n // Determine entry point - .ts files prioritized for development\n const entryPoints = [\n manifest.main,\n 'index.ts',\n 'index.js',\n 'extension.ts',\n 'extension.js',\n ].filter(Boolean) as string[];\n\n for (const entry of entryPoints) {\n const fullPath = isAbsolute(entry) ? entry : join(extensionPath, entry);\n\n if (existsSync(fullPath)) {\n try {\n // Use jiti to load both .ts and .js files\n const mod = this.jiti(fullPath);\n return mod.default \|\| mod;\n } catch (error) {\n log.warn({ err: error, path: fullPath }, `Failed to load module`);\n }\n }\n }\n\n return null;\n }\n\n private createExtensionApi(\n manifest: ExtensionManifest,\n resolved: ResolvedExtensionConfig,\n extensionDir: string,\n ): ExtensionApi {\n const logger = createExtensionLogger(`[${manifest.id}]`);\n const resolvePath = createPathResolver(extensionDir, this.options.workspaceDir \|\| '');\n\n const appConfig = this._appConfig ?? ({} as Config);\n const extensionOnly = (resolved.config ?? {}) as Record<string, unknown>;\n\n const runtime =\n this._appConfig && this._runtimeContext\n ? {\n config: this._appConfig,\n bus: this._runtimeContext.bus,\n log: logger,\n sessionManager: this._runtimeContext.sessionManager,\n }\n : this._appConfig\n ? {\n config: this._appConfig,\n log: logger,\n }\n : undefined;\n\n const api = new ExtensionApiImpl(\n manifest.id,\n manifest.name,\n manifest.version,\n extensionDir,\n appConfig,\n extensionOnly,\n logger,\n resolvePath,\n this.registry,\n runtime,\n );\n if (manifest.reload?.configPrefixes?.length) {\n api._setReloadConfigPrefixes(manifest.reload.configPrefixes);\n }\n const manifestCommands = manifest.ui?.contributions?.commands;\n if (manifestCommands?.length) {\n (api as ExtensionApiImpl)._setManifestCommands(manifestCommands);\n }\n return api;\n }\n\n private async initializeExtension(\n module: ExtensionModule,\n api: ExtensionApi,\n _manifest: ExtensionManifest,\n ): Promise<void> {\n if (typeof module === 'function') {\n // Module is a function that receives the API\n await module(api);\n } else if (typeof module === 'object' && module.register) {\n // Module is a ExtensionDefinition with register method\n await module.register(api);\n }\n }\n\n async startServices(): Promise<void> {\n const services = Array.from(this.registry.services.values());\n\n for (const service of services) {\n const serviceLog = createServiceLogger(service.id);\n try {\n await service.start?.();\n serviceLog.info(`Started service`);\n } catch (error) {\n serviceLog.error({ err: error }, `Failed to start service`);\n }\n }\n }\n\n async stopServices(): Promise<void> {\n const services = Array.from(this.registry.services.values()).reverse();\n\n for (const service of services) {\n if (service.stop) {\n const serviceLog = createServiceLogger(service.id);\n try {\n await service.stop();\n serviceLog.info(`Stopped service`);\n } catch (error) {\n serviceLog.error({ err: error }, `Failed to stop service`);\n }\n }\n }\n }\n\n /*\n Basic type validation for config values\n */\n private validateType(value: unknown, expectedType: string): boolean {\n if (expectedType === 'string') return typeof value === 'string';\n if (expectedType === 'number' \|\| expectedType === 'integer') return typeof value === 'number';\n if (expectedType === 'boolean') return typeof value === 'boolean';\n if (expectedType === 'array') return Array.isArray(value);\n if (expectedType === 'object') return typeof value === 'object' && value !== null && !Array.isArray(value);\n return true;\n }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nexport function resolveExtensionPath(id: string, _options: ExtensionLoaderOptions): string \| null {\n const c = loadConfig();\n const aid = resolveDefaultAgentId(c);\n // Priority 1: Workspace\n const workspacePath = join(resolveWorkspaceExtensionsDir(c, aid), id);\n if (existsSync(workspacePath)) return workspacePath;\n\n // Priority 2: Global\n const globalPath = join(resolveExtensionsDir(), id);\n if (existsSync(globalPath)) return globalPath;\n\n // Priority 3: Bundled\n const bundledDir = resolveBundledExtensionsDir();\n if (bundledDir) {\n const bundledPath = join(bundledDir, id);\n if (existsSync(bundledPath)) return bundledPath;\n }\n\n // Check if it's an npm package\n try {\n const require = createRequire(import.meta.url);\n const resolved = require.resolve(id);\n return dirname(resolved);\n } catch {\n return null;\n }\n}\n\nexport function normalizeExtensionConfig(\n rawConfig: Record<string, unknown>,\n): ResolvedExtensionConfig[] {\n const extensions: ResolvedExtensionConfig[] = [];\n\n const enabled = (rawConfig.enabled as string[]) \|\| [];\n const disabled = (rawConfig.disabled as string[]) \|\| [];\n\n // Parse enabled extensions\n for (const id of enabled) {\n const config = (rawConfig[id] as Record<string, unknown>) \|\| {};\n extensions.push({\n id,\n name: id,\n source: 'config',\n path: id,\n enabled: true,\n config,\n });\n }\n\n // Parse disabled extensions\n for (const id of disabled) {\n if (!extensions.find((p) => p.id === id)) {\n const config = (rawConfig[id] as Record<string, unknown>) \|\| {};\n extensions.push({\n id,\n name: id,\n source: 'config',\n path: id,\n enabled: false,\n config,\n });\n }\n }\n\n return extensions;\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"loader.js","names":["apiImpl"],"sources":["../../../src/extensions/loader.ts"],"sourcesContent":["/*\n Extension Loader and Registry\n * \n * Supports three-tier extension storage:\n * 1. Workspace level (workspace/.extensions/) - highest priority\n * 2. Global level (~/.xopc/extensions/) - shared across workspaces\n * 3. Bundled level (xopc/extensions/) - shipped with xopc\n /\n\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport { join, dirname, isAbsolute } from 'path';\nimport { fileURLToPath } from 'node:url';\nimport { createRequire } from 'node:module';\nimport { createJiti } from 'jiti';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport { loadConfig } from '../config/loader.js';\nimport {\n resolveAgentWorkspaceDir,\n resolveExtensionsDir,\n resolveWorkspaceExtensionsDir,\n resolveBundledExtensionsDir,\n resolveExtensionSdkPath,\n} from '../config/paths.js';\nimport type { Config } from '../config/config-surface.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionManager } from '../session/manager.js';\nimport type { AgentTool } from '@mariozechner/pi-agent-core';\nimport type {\n ExtensionApi,\n ExtensionModule,\n ExtensionRegistry,\n ExtensionCliRegistration,\n GatewayMethodHandler,\n HttpRequestHandler,\n ExtensionCommand,\n ExtensionReloadRegistration,\n ExtensionService,\n ExtensionHookEvent,\n ExtensionHookHandler,\n ExtensionManifest,\n ExtensionRecord,\n ResolvedExtensionConfig,\n DiscoveredExtension,\n} from './types/index.js';\nimport type { ActivationContext } from './activation-planner.js';\nimport { ActivationPlanner } from './activation-planner.js';\nimport { mergeActivationContext } from './activation-context.js';\nimport { ManifestRegistry } from './manifest-registry.js';\nimport { normalizeExtensionManifest } from './normalize-manifest.js';\nimport { checkEngineCompatibility } from './engine-check.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport { bundledChannelPlugins } from '../channels/plugins/bundled.js';\nimport { ExtensionApiImpl, createExtensionLogger, createPathResolver } from './api.js';\nimport { 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\n// Extension source origin for debugging\nexport type ExtensionSourceOrigin = 'workspace' \| 'global' \| 'bundled' \| 'config';\n\n// ============================================================================\n// Extension Registry\n// ============================================================================\n\nexport class ExtensionRegistryImpl implements ExtensionRegistry {\n extensions = new Map<string, ExtensionRecord>();\n hooks = new Map<ExtensionHookEvent, ExtensionHookHandler[]>();\n httpRoutes = new Map<string, HttpRequestHandler>();\n commands = new Map<string, ExtensionCommand>();\n services = new Map<string, ExtensionService>();\n gatewayMethods = new Map<string, GatewayMethodHandler>();\n tools: Map<string, AgentTool<any, any>> = new Map();\n channelPlugins: ChannelPlugin[] = [];\n private cliRegistrations: ExtensionCliRegistration[] = [];\n private reloadRegistrations: ExtensionReloadRegistration[] = [];\n\n addExtension(record: ExtensionRecord): void {\n this.extensions.set(record.id, record);\n }\n\n getExtension(id: string): ExtensionRecord \| undefined {\n return this.extensions.get(id);\n }\n\n getEnabledExtensions(): ExtensionRecord[] {\n return Array.from(this.extensions.values()).filter((p) => p.enabled);\n }\n\n addHook(\n event: ExtensionHookEvent,\n handler: ExtensionHookHandler,\n extensionId: string,\n _priority = 0,\n ): void {\n if (!this.hooks.has(event)) {\n this.hooks.set(event, []);\n }\n this.hooks.get(event)!.push(handler);\n }\n\n getHooks(event: ExtensionHookEvent): ExtensionHookHandler[] {\n return this.hooks.get(event) \|\| [];\n }\n\n addChannelPlugin(plugin: ChannelPlugin): void {\n this.channelPlugins = this.channelPlugins.filter((p) => p.id !== plugin.id);\n this.channelPlugins.push(plugin);\n }\n\n addHttpRoute(path: string, handler: HttpRequestHandler): void {\n if (this.httpRoutes.has(path)) {\n log.warn({ path }, `HTTP route already registered, overwriting`);\n }\n this.httpRoutes.set(path, handler);\n }\n\n getHttpRoute(path: string): HttpRequestHandler \| undefined {\n return this.httpRoutes.get(path);\n }\n\n addCommand(command: ExtensionCommand): void {\n if (this.commands.has(command.name)) {\n log.warn({ command: command.name }, `Command already registered, overwriting`);\n }\n this.commands.set(command.name, command);\n }\n\n getCommand(name: string): ExtensionCommand \| undefined {\n return this.commands.get(name);\n }\n\n addService(service: ExtensionService): void {\n if (this.services.has(service.id)) {\n log.warn({ service: service.id }, `Service already registered, overwriting`);\n }\n this.services.set(service.id, service);\n }\n\n getService(id: string): ExtensionService \| undefined {\n return this.services.get(id);\n }\n\n addGatewayMethod(method: string, handler: GatewayMethodHandler): void {\n if (this.gatewayMethods.has(method)) {\n log.warn({ method }, `Gateway method already registered, overwriting`);\n }\n this.gatewayMethods.set(method, handler);\n }\n\n getGatewayMethod(method: string): GatewayMethodHandler \| undefined {\n return this.gatewayMethods.get(method);\n }\n\n // Tools\n addTool(tool: any): void {\n if (this.tools.has(tool.name)) {\n log.warn({ tool: tool.name }, `Tool already registered, overwriting`);\n }\n this.tools.set(tool.name, tool);\n }\n\n removeTool(name: string): void {\n this.tools.delete(name);\n }\n\n getTools(): Map<string, any> {\n return this.tools;\n }\n\n getTool(name: string): any \| undefined {\n return this.tools.get(name);\n }\n\n getAllTools(): any[] {\n return Array.from(this.tools.values());\n }\n\n addCliRegistration(reg: ExtensionCliRegistration): void {\n this.cliRegistrations.push(reg);\n }\n\n getCliRegistrations(): readonly ExtensionCliRegistration[] {\n return this.cliRegistrations;\n }\n\n addReloadRegistration(reg: ExtensionReloadRegistration): void {\n this.reloadRegistrations = this.reloadRegistrations.filter(\n (r) => r.extensionId !== reg.extensionId,\n );\n this.reloadRegistrations.push(reg);\n }\n\n removeReloadRegistration(extensionId: string): void {\n this.reloadRegistrations = this.reloadRegistrations.filter(\n (r) => r.extensionId !== extensionId,\n );\n }\n\n getReloadRegistrations(): readonly ExtensionReloadRegistration[] {\n return this.reloadRegistrations;\n }\n\n getMatchingReloadRegistrations(changedPaths: string[]): ExtensionReloadRegistration[] {\n return this.reloadRegistrations.filter((reg) => {\n if (reg.configPrefixes.length === 0) {\n return true;\n }\n return reg.configPrefixes.some((prefix) =>\n changedPaths.some((path) => path === prefix \|\| path.startsWith(`${prefix}.`)),\n );\n });\n }\n}\n\n// ============================================================================\n// Extension Loader\n// ============================================================================\n\nexport interface ExtensionLoaderOptions {\n workspaceDir?: string;\n extensionsDir?: string;\n bundledExtensions?: string[];\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?: SessionManager;\n scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;\n };\n \n // Security\n private securityConfig: SecurityConfig;\n \n // Provider Registry\n private providerRegistry: ProviderPluginRegistry;\n \n // Slot Registry & Config\n private slotRegistry: SlotRegistry;\n private slotsConfig: Partial<Record<SlotKey, string>> = {};\n \n // Cache and Diagnostics\n private cache: ExtensionLoaderCache;\n private diagnostics: ExtensionDiagnostics;\n\n /* Manifest-only registry cache (no runtime module load). /\n private manifestRegistry: ManifestRegistry \| null = null;\n\n constructor(options?: ExtensionLoaderOptions) {\n this.registry = new ExtensionRegistryImpl();\n for (const p of bundledChannelPlugins) {\n this.registry.addChannelPlugin(p);\n }\n this.options = options \|\| (() => {\n const c = loadConfig();\n const aid = resolveDefaultAgentId(c);\n return {\n workspaceDir: resolveAgentWorkspaceDir(c, aid),\n extensionsDir: resolveWorkspaceExtensionsDir(c, aid),\n };\n })();\n\n // Initialize security config\n this.securityConfig = DEFAULT_SECURITY_CONFIG;\n \n // Initialize provider registry\n this.providerRegistry = getProviderRegistry();\n \n // Initialize slot registry\n this.slotRegistry = getSlotRegistry();\n \n // Initialize cache and diagnostics \n this.cache = getExtensionCache();\n this.diagnostics = getExtensionDiagnostics();\n\n // Build jiti alias for extension-sdk (+ subpath entry points)\n const alias: Record<string, string> = {};\n const sdkPath = resolveExtensionSdkPath();\n if (sdkPath) {\n alias['xopc/extension-sdk'] = sdkPath;\n const sdkDir = dirname(sdkPath);\n alias['xopc/extension-sdk/core'] = join(sdkDir, 'core.ts');\n alias['xopc/extension-sdk/lazy'] = join(sdkDir, 'lazy.ts');\n alias['xopc/extension-sdk/provider'] = join(sdkDir, 'provider.ts');\n alias['xopc/extension-sdk/channel'] = join(sdkDir, 'channel.ts');\n alias['xopc/extension-sdk/hooks'] = join(sdkDir, 'hooks.ts');\n alias['xopc/extension-sdk/tools'] = join(sdkDir, 'tools.ts');\n alias['xopc/extension-sdk/testing'] = join(sdkDir, 'testing.ts');\n }\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 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?: SessionManager;\n scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;\n }): void {\n this._runtimeContext = ctx;\n // ExtensionApi snapshots `runtime` at construction and is tied to this loader's registry.\n // CLI bootstrap loads extensions with `{ bus }` first; a global cache hit would reuse that\n // api for the gateway loader (no sessionManager, wrong registry) — breaks e.g. `/goal`.\n this.cache.invalidate();\n }\n\n getRegistry(): ExtensionRegistryImpl {\n return this.registry;\n }\n\n /\n Phase 1: build manifest registry (filesystem manifests only, no extension code load).\n /\n buildManifestRegistry(): ManifestRegistry {\n if (this.manifestRegistry) {\n return this.manifestRegistry;\n }\n const discovered = this.discoverExtensions();\n this.manifestRegistry = ManifestRegistry.fromDiscovered(discovered);\n return this.manifestRegistry;\n }\n\n /\n Phase 2: activation planner over the manifest registry (pure logic).\n /\n planActivation(_context?: Partial<ActivationContext>): ActivationPlanner {\n return new ActivationPlanner(this.buildManifestRegistry());\n }\n\n /\n Phase 3: load only extensions selected by the activation plan.\n /\n async loadByActivationPlan(context?: Partial<ActivationContext>): Promise<void> {\n const registry = this.buildManifestRegistry();\n const planner = new ActivationPlanner(registry);\n const fullContext = mergeActivationContext(this._appConfig, context);\n const activatedIds = planner.getActivatedIds(fullContext).sort((a, b) => a.localeCompare(b));\n\n for (const extensionId of activatedIds) {\n if (this.extensionInstances.has(extensionId)) continue;\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 continue;\n }\n\n const config: ResolvedExtensionConfig = {\n id: extensionId,\n name: entry.manifest.name \|\| extensionId,\n source: entry.source,\n path: entry.path,\n enabled: true,\n config: this.resolveExtensionConfig(extensionId),\n };\n\n await this.loadExtension(config);\n }\n }\n\n getManifestRegistry(): ManifestRegistry {\n return this.buildManifestRegistry();\n }\n\n invalidateManifestCache(): void {\n this.manifestRegistry = 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 const discovered = new Map<string, DiscoveredExtension>();\n\n // Priority 3: Bundled extensions (lowest)\n const bundledDir = resolveBundledExtensionsDir();\n if (bundledDir) {\n this.discoverInDirectory(bundledDir, 'bundled', discovered);\n }\n\n // Priority 2: Global extensions\n const globalDir = resolveExtensionsDir();\n this.discoverInDirectory(globalDir, 'global', discovered);\n\n // Priority 1: Workspace extensions (highest, can override)\n const c = loadConfig();\n const aid = resolveDefaultAgentId(c);\n const workspaceExtensionsDir = resolveWorkspaceExtensionsDir(c, aid);\n this.discoverInDirectory(workspaceExtensionsDir, 'workspace', discovered);\n\n return Array.from(discovered.values());\n }\n\n private discoverInDirectory(\n dir: string,\n source: ExtensionSourceOrigin,\n discovered: Map<string, DiscoveredExtension>,\n ): void {\n if (!existsSync(dir)) {\n return;\n }\n\n let entries: string[];\n try {\n entries = readdirSync(dir);\n } catch {\n return;\n }\n\n for (const entry of entries) {\n const extensionPath = join(dir, entry);\n\n // Check if it's a directory\n try {\n const stat = existsSync(extensionPath);\n if (!stat) continue;\n } catch {\n continue;\n }\n\n // Try to load manifest\n const manifest = this.loadManifest(extensionPath);\n if (!manifest) continue;\n\n const extensionId = manifest.id \|\| entry;\n\n // Higher priority origins can override lower ones\n const existing = discovered.get(extensionId);\n if (existing) {\n const priority = { workspace: 3, global: 2, bundled: 1, config: 0 };\n if (priority[source] <= priority[existing.source]) {\n log.debug(\n { extensionId, from: source, existing: existing.source },\n 'Skipping lower priority extension',\n );\n continue;\n }\n log.info(\n { extensionId, from: source, overriding: existing.source },\n 'Extension override by higher priority source',\n );\n }\n\n discovered.set(extensionId, {\n id: extensionId,\n path: extensionPath,\n source,\n manifest,\n });\n }\n }\n\n /\n Load all discovered extensions\n /\n async loadAllExtensions(enabledIds?: string[]): Promise<void> {\n const extensions = this.discoverExtensions();\n\n for (const extension of extensions) {\n // If enabledIds specified, only load those\n if (enabledIds && !enabledIds.includes(extension.id)) {\n continue;\n }\n\n const config: ResolvedExtensionConfig = {\n id: extension.id,\n name: extension.manifest.name \|\| extension.id,\n source: extension.source,\n path: extension.path,\n enabled: true,\n config: {},\n };\n\n await this.loadExtension(config);\n }\n }\n\n async loadExtensions(configs: ResolvedExtensionConfig[]): Promise<void> {\n for (const extensionConfig of configs) {\n if (extensionConfig.enabled) {\n await this.loadExtension(extensionConfig);\n }\n }\n }\n\n async loadExtension(config: ResolvedExtensionConfig): Promise<ExtensionApi \| null> {\n try {\n // Check cache first\n const cacheKey = this.cache.buildKey(this.options, [config.id]);\n const cached = this.cache.get<ExtensionApi>(cacheKey);\n if (cached) {\n log.debug({ extensionId: config.id }, 'Extension loaded from cache');\n return cached;\n }\n\n // Check if already loaded\n if (this.extensionInstances.has(config.id)) {\n return this.extensionInstances.get(config.id)!;\n }\n\n // Resolve extension path using resolveExtensionPath\n let extensionPath: string \| null;\n if (isAbsolute(config.path)) {\n extensionPath = config.path;\n } else {\n // Try to resolve extension ID to actual path\n extensionPath = resolveExtensionPath(config.path, this.options) \|\|\n resolveExtensionPath(config.id, this.options);\n }\n \n if (!extensionPath) {\n log.error({ extensionId: config.id, path: config.path }, `Could not resolve extension path`);\n this.diagnostics.error(config.id, `Could not resolve extension path: ${config.path}`);\n return null;\n }\n\n log.debug({ extensionId: config.id, extensionPath }, 'Resolved extension path');\n\n // Security check\n const source = config.source \|\| 'bundled';\n const safetyResult = checkExtensionPathSafety(extensionPath, extensionPath, source);\n \n if (!safetyResult.safe) {\n logSecurityIssue(config.id, safetyResult);\n \n if (this.securityConfig.checkPermissions && source !== 'bundled') {\n // Check allowlist\n if (!isExtensionAllowed(config.id, this.securityConfig)) {\n this.diagnostics.error(config.id, `Extension not allowed: ${safetyResult.detail}`);\n log.error({ extensionId: config.id, reason: safetyResult.reason }, 'Extension blocked by security policy');\n return null;\n }\n }\n }\n\n // Track provenance \n provenanceTracker.track(config.id, source);\n\n const manifest = this.loadManifest(extensionPath);\n if (!manifest) {\n log.error({ extensionId: config.id, extensionPath }, `Failed to load manifest for extension`);\n this.diagnostics.error(config.id, `Failed to load manifest`);\n return null;\n }\n\n if (manifest.engines?.xopc) {\n const range = manifest.engines.xopc;\n const engineResult = checkEngineCompatibility(PACKAGE_VERSION, range);\n if (engineResult.parseWarning) {\n log.warn(\n { extensionId: config.id, range, reason: engineResult.reason },\n 'Engine range parse warning — loading anyway',\n );\n } else if (!engineResult.compatible) {\n log.warn(\n { extensionId: config.id, range, currentVersion: PACKAGE_VERSION },\n 'Extension engine requirement not met (engines.xopc) — skipping load',\n );\n this.diagnostics.error(\n config.id,\n engineResult.reason ?? 'Incompatible xopc version (engines.xopc)',\n );\n return null;\n }\n }\n\n // Validate extension config against schema (basic validation)\n if (manifest.configSchema) {\n try {\n const schema = manifest.configSchema as Record<string, unknown>;\n const extensionConfig = config.config as Record<string, unknown>;\n \n // Basic validation: check required fields and types\n if (schema.type === 'object' && schema.properties) {\n const props = schema.properties as Record<string, Record<string, unknown>>;\n const required = (schema.required as string[]) \|\| [];\n \n for (const field of required) {\n if (extensionConfig[field] === undefined) {\n log.error({ \n extensionId: config.id, \n field \n }, 'Extension config validation failed: missing required field');\n return null;\n }\n }\n \n for (const [key, value] of Object.entries(extensionConfig)) {\n const propSchema = props[key];\n if (propSchema) {\n if (propSchema.type && !this.validateType(value, propSchema.type as string)) {\n log.error({ \n extensionId: config.id, \n field: key,\n expected: propSchema.type,\n actual: typeof value\n }, 'Extension config validation failed: type mismatch');\n return null;\n }\n }\n }\n }\n \n log.debug({ extensionId: config.id }, 'Extension config validated');\n } catch (err) {\n log.warn({ err, extensionId: config.id }, 'Config schema validation skipped');\n }\n }\n\n // Create extension API\n const extensionDir = dirname(extensionPath);\n const api = this.createExtensionApi(manifest, config, extensionDir);\n\n // Load extension module\n const module = await this.loadModule(extensionPath, manifest);\n if (!module) {\n log.error({ extensionId: config.id }, `Failed to load module for extension`);\n this.diagnostics.error(config.id, `Failed to load module`);\n return null;\n }\n\n // Check and claim slots\n const slotClaimed = this.claimExtensionSlots(config.id, manifest);\n if (!slotClaimed) {\n log.warn({ extensionId: config.id }, 'Failed to claim required slots');\n }\n\n // Initialize extension\n await this.initializeExtension(module, api, manifest);\n\n // 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 'image-generation': 'imageGeneration',\n 'imageGeneration': 'imageGeneration',\n 'web-search': 'webSearch',\n 'webSearch': 'webSearch',\n };\n \n const slotKey = slotMap[kind];\n if (!slotKey) {\n return true; // No slot required\n }\n \n // Check if slot is reserved for a different plugin in config\n const preferredPlugin = this.slotsConfig[slotKey];\n if (preferredPlugin && preferredPlugin !== extensionId) {\n log.info(\n { extensionId, slotKey, preferredPlugin },\n `Skipping slot claim: slot \"${slotKey}\" is reserved for \"${preferredPlugin}\"`\n );\n this.diagnostics.info(\n extensionId,\n `Slot \"${slotKey}\" is reserved for \"${preferredPlugin}\", skipping claim`\n );\n return false;\n }\n \n const claimed = this.slotRegistry.claim(slotKey, extensionId, null);\n if (!claimed) {\n this.diagnostics.warn(extensionId, `Slot \"${slotKey}\" already claimed by another extension`);\n }\n return claimed;\n }\n\n loadManifest(extensionPath: string): ExtensionManifest \| null {\n const manifestPath = join(extensionPath, EXTENSION_MANIFEST_FILE);\n\n // First try to load xopc.extension.json\n if (existsSync(manifestPath)) {\n try {\n const raw = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n if (!raw \|\| typeof raw !== 'object' \|\| Array.isArray(raw)) {\n log.error({ manifestPath }, 'Manifest root must be a JSON object');\n return null;\n }\n return normalizeExtensionManifest(raw as Record<string, unknown>);\n } catch (error) {\n log.error({ err: error, manifestPath }, `Failed to parse manifest`);\n return null;\n }\n }\n\n // Fallback to package.json\n const packagePath = join(extensionPath, 'package.json');\n if (existsSync(packagePath)) {\n try {\n const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));\n \n // Check for xopc.extension marker\n if (packageJson.xopc?.extension) {\n const xopcConfig = packageJson.xopc;\n return normalizeExtensionManifest({\n id: xopcConfig.id \|\| packageJson.name,\n name: xopcConfig.name \|\| packageJson.name,\n description: xopcConfig.description \|\| packageJson.description,\n version: xopcConfig.version \|\| packageJson.version \|\| '1.0.0',\n kind: xopcConfig.kind \|\| 'utility',\n main: xopcConfig.main \|\| packageJson.main \|\| 'index.js',\n configSchema: xopcConfig.configSchema,\n });\n }\n\n // Also support xopc-extension- naming convention\n if (packageJson.name?.startsWith('xopc-extension-')) {\n const id = packageJson.name.replace('xopc-extension-', '');\n return normalizeExtensionManifest({\n id,\n name: packageJson.name,\n description: packageJson.description,\n version: packageJson.version \|\| '1.0.0',\n kind: 'utility',\n main: packageJson.main \|\| 'index.js',\n });\n }\n } catch (error) {\n log.error({ err: error, packagePath }, `Failed to parse package.json`);\n }\n }\n\n return null;\n }\n\n private async loadModule(\n extensionPath: string,\n manifest: ExtensionManifest,\n ): Promise<ExtensionModule \| null> {\n // Determine entry point - .ts files prioritized for development\n const entryPoints = [\n manifest.main,\n 'index.ts',\n 'index.js',\n 'extension.ts',\n 'extension.js',\n ].filter(Boolean) as string[];\n\n for (const entry of entryPoints) {\n const fullPath = isAbsolute(entry) ? entry : join(extensionPath, entry);\n\n if (existsSync(fullPath)) {\n try {\n // Use jiti to load both .ts and .js files\n const mod = this.jiti(fullPath);\n return mod.default \|\| mod;\n } catch (error) {\n log.warn({ err: error, path: fullPath }, `Failed to load module`);\n }\n }\n }\n\n return null;\n }\n\n private createExtensionApi(\n manifest: ExtensionManifest,\n resolved: ResolvedExtensionConfig,\n extensionDir: string,\n ): ExtensionApi {\n const logger = createExtensionLogger(`[${manifest.id}]`);\n const resolvePath = createPathResolver(extensionDir, this.options.workspaceDir \|\| '');\n\n const appConfig = this._appConfig ?? ({} as Config);\n const extensionOnly = (resolved.config ?? {}) as Record<string, unknown>;\n\n const runtime =\n this._appConfig && this._runtimeContext\n ? {\n config: this._appConfig,\n bus: this._runtimeContext.bus,\n log: logger,\n sessionManager: this._runtimeContext.sessionManager,\n scheduleWebchatContinuation: this._runtimeContext.scheduleWebchatContinuation,\n }\n : this._appConfig\n ? {\n config: this._appConfig,\n log: logger,\n }\n : undefined;\n\n const api = new ExtensionApiImpl(\n manifest.id,\n manifest.name,\n manifest.version,\n extensionDir,\n appConfig,\n extensionOnly,\n logger,\n resolvePath,\n this.registry,\n runtime,\n );\n if (manifest.reload?.configPrefixes?.length) {\n api._setReloadConfigPrefixes(manifest.reload.configPrefixes);\n }\n const manifestCommands = manifest.ui?.contributions?.commands;\n if (manifestCommands?.length) {\n (api as ExtensionApiImpl)._setManifestCommands(manifestCommands);\n }\n return api;\n }\n\n private async initializeExtension(\n module: ExtensionModule,\n api: ExtensionApi,\n _manifest: ExtensionManifest,\n ): Promise<void> {\n if (typeof module === 'function') {\n // Module is a function that receives the API\n await module(api);\n } else if (typeof module === 'object' && module.register) {\n // Module is a ExtensionDefinition with register method\n await module.register(api);\n }\n }\n\n async startServices(): Promise<void> {\n const services = Array.from(this.registry.services.values());\n\n for (const service of services) {\n const serviceLog = createServiceLogger(service.id);\n try {\n await service.start?.();\n serviceLog.info(`Started service`);\n } catch (error) {\n serviceLog.error({ err: error }, `Failed to start service`);\n }\n }\n }\n\n async stopServices(): Promise<void> {\n const services = Array.from(this.registry.services.values()).reverse();\n\n for (const service of services) {\n if (service.stop) {\n const serviceLog = createServiceLogger(service.id);\n try {\n await service.stop();\n serviceLog.info(`Stopped service`);\n } catch (error) {\n serviceLog.error({ err: error }, `Failed to stop service`);\n }\n }\n }\n }\n\n /*\n Basic type validation for config values\n */\n private validateType(value: unknown, expectedType: string): boolean {\n if (expectedType === 'string') return typeof value === 'string';\n if (expectedType === 'number' \|\| expectedType === 'integer') return typeof value === 'number';\n if (expectedType === 'boolean') return typeof value === 'boolean';\n if (expectedType === 'array') return Array.isArray(value);\n if (expectedType === 'object') return typeof value === 'object' && value !== null && !Array.isArray(value);\n return true;\n }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nexport function resolveExtensionPath(id: string, _options: ExtensionLoaderOptions): string \| null {\n const c = loadConfig();\n const aid = resolveDefaultAgentId(c);\n // Priority 1: Workspace\n const workspacePath = join(resolveWorkspaceExtensionsDir(c, aid), id);\n if (existsSync(workspacePath)) return workspacePath;\n\n // Priority 2: Global\n const globalPath = join(resolveExtensionsDir(), id);\n if (existsSync(globalPath)) return globalPath;\n\n // Priority 3: Bundled\n const bundledDir = resolveBundledExtensionsDir();\n if (bundledDir) {\n const bundledPath = join(bundledDir, id);\n if (existsSync(bundledPath)) return bundledPath;\n }\n\n // Check if it's an npm package\n try {\n const require = createRequire(import.meta.url);\n const resolved = require.resolve(id);\n return dirname(resolved);\n } catch {\n return null;\n }\n}\n\nexport function normalizeExtensionConfig(\n rawConfig: Record<string, unknown>,\n): ResolvedExtensionConfig[] {\n const extensions: ResolvedExtensionConfig[] = [];\n\n const enabled = (rawConfig.enabled as string[]) \|\| [];\n const disabled = (rawConfig.disabled as string[]) \|\| [];\n\n // Parse enabled extensions\n for (const id of enabled) {\n const config = (rawConfig[id] as Record<string, unknown>) \|\| {};\n extensions.push({\n id,\n name: id,\n source: 'config',\n path: id,\n enabled: true,\n config,\n });\n }\n\n // Parse disabled extensions\n for (const id of disabled) {\n if (!extensions.find((p) => p.id === id)) {\n const config = (rawConfig[id] as Record<string, unknown>) \|\| {};\n extensions.push({\n id,\n name: id,\n source: 'config',\n path: id,\n enabled: false,\n config,\n });\n }\n }\n\n return extensions;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAcgE;aACf;YAOrB;sBA4B4B;aAIe;sBAc4B;AAiBnG,MAAM,0BAA0B;AAEhC,MAAM,MAAM,aAAa,kBAAkB;AAS3C,IAAa,wBAAb,MAAgE;CAC9D,6BAAa,IAAI,KAA8B;CAC/C,wBAAQ,IAAI,KAAiD;CAC7D,6BAAa,IAAI,KAAiC;CAClD,2BAAW,IAAI,KAA+B;CAC9C,2BAAW,IAAI,KAA+B;CAC9C,iCAAiB,IAAI,KAAmC;CACxD,wBAA0C,IAAI,KAAK;CACnD,iBAAkC,EAAE;CACpC,mBAAuD,EAAE;CACzD,sBAA6D,EAAE;CAE/D,aAAa,QAA+B;AAC1C,OAAK,WAAW,IAAI,OAAO,IAAI,OAAO;;CAGxC,aAAa,IAAyC;AACpD,SAAO,KAAK,WAAW,IAAI,GAAG;;CAGhC,uBAA0C;AACxC,SAAO,MAAM,KAAK,KAAK,WAAW,QAAQ,CAAC,CAAC,QAAQ,MAAM,EAAE,QAAQ;;CAGtE,QACE,OACA,SACA,aACA,YAAY,GACN;AACN,MAAI,CAAC,KAAK,MAAM,IAAI,MAAM,CACxB,MAAK,MAAM,IAAI,OAAO,EAAE,CAAC;AAE3B,OAAK,MAAM,IAAI,MAAM,CAAE,KAAK,QAAQ;;CAGtC,SAAS,OAAmD;AAC1D,SAAO,KAAK,MAAM,IAAI,MAAM,IAAI,EAAE;;CAGpC,iBAAiB,QAA6B;AAC5C,OAAK,iBAAiB,KAAK,eAAe,QAAQ,MAAM,EAAE,OAAO,OAAO,GAAG;AAC3E,OAAK,eAAe,KAAK,OAAO;;CAGlC,aAAa,MAAc,SAAmC;AAC5D,MAAI,KAAK,WAAW,IAAI,KAAK,CAC3B,KAAI,KAAK,EAAE,MAAM,EAAE,6CAA6C;AAElE,OAAK,WAAW,IAAI,MAAM,QAAQ;;CAGpC,aAAa,MAA8C;AACzD,SAAO,KAAK,WAAW,IAAI,KAAK;;CAGlC,WAAW,SAAiC;AAC1C,MAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,CACjC,KAAI,KAAK,EAAE,SAAS,QAAQ,MAAM,EAAE,0CAA0C;AAEhF,OAAK,SAAS,IAAI,QAAQ,MAAM,QAAQ;;CAG1C,WAAW,MAA4C;AACrD,SAAO,KAAK,SAAS,IAAI,KAAK;;CAGhC,WAAW,SAAiC;AAC1C,MAAI,KAAK,SAAS,IAAI,QAAQ,GAAG,CAC/B,KAAI,KAAK,EAAE,SAAS,QAAQ,IAAI,EAAE,0CAA0C;AAE9E,OAAK,SAAS,IAAI,QAAQ,IAAI,QAAQ;;CAGxC,WAAW,IAA0C;AACnD,SAAO,KAAK,SAAS,IAAI,GAAG;;CAG9B,iBAAiB,QAAgB,SAAqC;AACpE,MAAI,KAAK,eAAe,IAAI,OAAO,CACjC,KAAI,KAAK,EAAE,QAAQ,EAAE,iDAAiD;AAExE,OAAK,eAAe,IAAI,QAAQ,QAAQ;;CAG1C,iBAAiB,QAAkD;AACjE,SAAO,KAAK,eAAe,IAAI,OAAO;;CAIxC,QAAQ,MAAiB;AACvB,MAAI,KAAK,MAAM,IAAI,KAAK,KAAK,CAC3B,KAAI,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,uCAAuC;AAEvE,OAAK,MAAM,IAAI,KAAK,MAAM,KAAK;;CAGjC,WAAW,MAAoB;AAC7B,OAAK,MAAM,OAAO,KAAK;;CAGzB,WAA6B;AAC3B,SAAO,KAAK;;CAGd,QAAQ,MAA+B;AACrC,SAAO,KAAK,MAAM,IAAI,KAAK;;CAG7B,cAAqB;AACnB,SAAO,MAAM,KAAK,KAAK,MAAM,QAAQ,CAAC;;CAGxC,mBAAmB,KAAqC;AACtD,OAAK,iBAAiB,KAAK,IAAI;;CAGjC,sBAA2D;AACzD,SAAO,KAAK;;CAGd,sBAAsB,KAAwC;AAC5D,OAAK,sBAAsB,KAAK,oBAAoB,QACjD,MAAM,EAAE,gBAAgB,IAAI,YAC9B;AACD,OAAK,oBAAoB,KAAK,IAAI;;CAGpC,yBAAyB,aAA2B;AAClD,OAAK,sBAAsB,KAAK,oBAAoB,QACjD,MAAM,EAAE,gBAAgB,YAC1B;;CAGH,yBAAiE;AAC/D,SAAO,KAAK;;CAGd,+BAA+B,cAAuD;AACpF,SAAO,KAAK,oBAAoB,QAAQ,QAAQ;AAC9C,OAAI,IAAI,eAAe,WAAW,EAChC,QAAO;AAET,UAAO,IAAI,eAAe,MAAM,WAC9B,aAAa,MAAM,SAAS,SAAS,UAAU,KAAK,WAAW,GAAG,OAAO,GAAG,CAAC,CAC9E;IACD;;;AAcN,IAAa,kBAAb,MAA6B;CAC3B;CACA;CACA,qCAAwD,IAAI,KAAK;CACjE;CACA;CACA;CAOA;CAGA;CAGA;CACA,cAAwD,EAAE;CAG1D;CACA;;CAGA,mBAAoD;CAEpD,YAAY,SAAkC;AAC5C,OAAK,WAAW,IAAI,uBAAuB;AAC3C,OAAK,MAAM,KAAK,sBACd,MAAK,SAAS,iBAAiB,EAAE;AAEnC,OAAK,UAAU,kBAAkB;GAC/B,MAAM,IAAI,YAAY;GACtB,MAAM,MAAM,sBAAsB,EAAE;AACpC,UAAO;IACL,cAAc,yBAAyB,GAAG,IAAI;IAC9C,eAAe,8BAA8B,GAAG,IAAI;IACrD;MACC;AAGJ,OAAK,iBAAiB;AAGtB,OAAK,mBAAmB,qBAAqB;AAG7C,OAAK,eAAe,iBAAiB;AAGrC,OAAK,QAAQ,mBAAmB;AAChC,OAAK,cAAc,yBAAyB;EAG5C,MAAM,QAAgC,EAAE;EACxC,MAAM,UAAU,yBAAyB;AACzC,MAAI,SAAS;AACX,SAAM,wBAAwB;GAC9B,MAAM,SAAS,QAAQ,QAAQ;AAC/B,SAAM,6BAA6B,KAAK,QAAQ,UAAU;AAC1D,SAAM,6BAA6B,KAAK,QAAQ,UAAU;AAC1D,SAAM,iCAAiC,KAAK,QAAQ,cAAc;AAClE,SAAM,gCAAgC,KAAK,QAAQ,aAAa;AAChE,SAAM,8BAA8B,KAAK,QAAQ,WAAW;AAC5D,SAAM,8BAA8B,KAAK,QAAQ,WAAW;AAC5D,SAAM,gCAAgC,KAAK,QAAQ,aAAa;;AAIlE,OAAK,OAAO,WAAW,cAAc,OAAO,KAAK,IAAI,EAAE;GACrD,gBAAgB;GAChB,YAAY;IAAC;IAAO;IAAQ;IAAQ;IAAQ;IAAO;IAAQ;IAAQ;IAAQ;GAC3E;GACD,CAAC;;;;;CAMJ,kBAAkB,QAAuC;AACvD,OAAK,iBAAiB;GAAE,GAAG,KAAK;GAAgB,GAAG;GAAQ;;;;;CAM7D,oBAAoC;AAClC,SAAO,KAAK;;;;;CAMd,sBAA8C;AAC5C,SAAO,KAAK;;;;;CAMd,kBAAgC;AAC9B,SAAO,KAAK;;;;;CAMd,iBAAuC;AACrC,SAAO,KAAK;;;;;CAMd,UAAU,QAAsB;AAC9B,OAAK,aAAa;EAElB,MAAM,QAAS,OAAO,YAAoB,SAAS,EAAE;AACrD,OAAK,cAAc;GACjB,QAAQ,MAAM;GACd,KAAK,MAAM;GACX,iBAAiB,MAAM;GACvB,WAAW,MAAM;GAClB;EAGD,MAAM,WAAY,OAAO,YAAoB;AAC7C,MAAI,SACF,MAAK,iBAAiB;GACpB,kBAAkB,SAAS,oBAAoB;GAC/C,gBAAgB,SAAS,kBAAkB;GAC3C,OAAO,SAAS,SAAS,EAAE;GAC3B,iBAAiB,SAAS,mBAAmB;GAC7C,sBAAsB,SAAS,wBAAwB;GACxD;;;;;CAOL,kBAAkB,KAIT;AACP,OAAK,kBAAkB;AAIvB,OAAK,MAAM,YAAY;;CAGzB,cAAqC;AACnC,SAAO,KAAK;;;;;CAMd,wBAA0C;AACxC,MAAI,KAAK,iBACP,QAAO,KAAK;EAEd,MAAM,aAAa,KAAK,oBAAoB;AAC5C,OAAK,mBAAmB,iBAAiB,eAAe,WAAW;AACnE,SAAO,KAAK;;;;;CAMd,eAAe,UAA0D;AACvE,SAAO,IAAI,kBAAkB,KAAK,uBAAuB,CAAC;;;;;CAM5D,MAAM,qBAAqB,SAAqD;EAC9E,MAAM,WAAW,KAAK,uBAAuB;EAC7C,MAAM,UAAU,IAAI,kBAAkB,SAAS;EAC/C,MAAM,cAAc,uBAAuB,KAAK,YAAY,QAAQ;EACpE,MAAM,eAAe,QAAQ,gBAAgB,YAAY,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC;AAE5F,OAAK,MAAM,eAAe,cAAc;AACtC,OAAI,KAAK,mBAAmB,IAAI,YAAY,CAAE;GAC9C,MAAM,QAAQ,SAAS,SAAS,YAAY;AAC5C,OAAI,CAAC,OAAO;AACV,QAAI,MACF,EAAE,aAAa,EACf,0EACD;AACD;;GAGF,MAAM,SAAkC;IACtC,IAAI;IACJ,MAAM,MAAM,SAAS,QAAQ;IAC7B,QAAQ,MAAM;IACd,MAAM,MAAM;IACZ,SAAS;IACT,QAAQ,KAAK,uBAAuB,YAAY;IACjD;AAED,SAAM,KAAK,cAAc,OAAO;;;CAIpC,sBAAwC;AACtC,SAAO,KAAK,uBAAuB;;CAGrC,0BAAgC;AAC9B,OAAK,mBAAmB;;CAG1B,uBAA+B,aAA8C;AAC3E,MAAI,CAAC,KAAK,WAAY,QAAO,EAAE;EAC/B,MAAM,mBAAoB,KAAK,WAAuC;AAGtE,MAAI,CAAC,oBAAoB,OAAO,qBAAqB,SAAU,QAAO,EAAE;EACxE,MAAM,MAAM,iBAAiB;AAC7B,MAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,IAAI,CACvD,QAAO;AAET,SAAO,EAAE;;;;;;;;CASX,qBAA4C;EAC1C,MAAM,6BAAa,IAAI,KAAkC;EAGzD,MAAM,aAAa,6BAA6B;AAChD,MAAI,WACF,MAAK,oBAAoB,YAAY,WAAW,WAAW;EAI7D,MAAM,YAAY,sBAAsB;AACxC,OAAK,oBAAoB,WAAW,UAAU,WAAW;EAGzD,MAAM,IAAI,YAAY;EAEtB,MAAM,yBAAyB,8BAA8B,GADjD,sBAAsB,EACiC,CAAC;AACpE,OAAK,oBAAoB,wBAAwB,aAAa,WAAW;AAEzE,SAAO,MAAM,KAAK,WAAW,QAAQ,CAAC;;CAGxC,oBACE,KACA,QACA,YACM;AACN,MAAI,CAAC,WAAW,IAAI,CAClB;EAGF,IAAI;AACJ,MAAI;AACF,aAAU,YAAY,IAAI;UACpB;AACN;;AAGF,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,gBAAgB,KAAK,KAAK,MAAM;AAGtC,OAAI;AAEF,QAAI,CADS,WAAW,cACf,CAAE;WACL;AACN;;GAIF,MAAM,WAAW,KAAK,aAAa,cAAc;AACjD,OAAI,CAAC,SAAU;GAEf,MAAM,cAAc,SAAS,MAAM;GAGnC,MAAM,WAAW,WAAW,IAAI,YAAY;AAC5C,OAAI,UAAU;IACZ,MAAM,WAAW;KAAE,WAAW;KAAG,QAAQ;KAAG,SAAS;KAAG,QAAQ;KAAG;AACnE,QAAI,SAAS,WAAW,SAAS,SAAS,SAAS;AACjD,SAAI,MACF;MAAE;MAAa,MAAM;MAAQ,UAAU,SAAS;MAAQ,EACxD,oCACD;AACD;;AAEF,QAAI,KACF;KAAE;KAAa,MAAM;KAAQ,YAAY,SAAS;KAAQ,EAC1D,+CACD;;AAGH,cAAW,IAAI,aAAa;IAC1B,IAAI;IACJ,MAAM;IACN;IACA;IACD,CAAC;;;;;;CAON,MAAM,kBAAkB,YAAsC;EAC5D,MAAM,aAAa,KAAK,oBAAoB;AAE5C,OAAK,MAAM,aAAa,YAAY;AAElC,OAAI,cAAc,CAAC,WAAW,SAAS,UAAU,GAAG,CAClD;GAGF,MAAM,SAAkC;IACtC,IAAI,UAAU;IACd,MAAM,UAAU,SAAS,QAAQ,UAAU;IAC3C,QAAQ,UAAU;IAClB,MAAM,UAAU;IAChB,SAAS;IACT,QAAQ,EAAE;IACX;AAED,SAAM,KAAK,cAAc,OAAO;;;CAIpC,MAAM,eAAe,SAAmD;AACtE,OAAK,MAAM,mBAAmB,QAC5B,KAAI,gBAAgB,QAClB,OAAM,KAAK,cAAc,gBAAgB;;CAK/C,MAAM,cAAc,QAA+D;AACjF,MAAI;GAEF,MAAM,WAAW,KAAK,MAAM,SAAS,KAAK,SAAS,CAAC,OAAO,GAAG,CAAC;GAC/D,MAAM,SAAS,KAAK,MAAM,IAAkB,SAAS;AACrD,OAAI,QAAQ;AACV,QAAI,MAAM,EAAE,aAAa,OAAO,IAAI,EAAE,8BAA8B;AACpE,WAAO;;AAIT,OAAI,KAAK,mBAAmB,IAAI,OAAO,GAAG,CACxC,QAAO,KAAK,mBAAmB,IAAI,OAAO,GAAG;GAI/C,IAAI;AACJ,OAAI,WAAW,OAAO,KAAK,CACzB,iBAAgB,OAAO;OAGvB,iBAAgB,qBAAqB,OAAO,MAAM,KAAK,QAAQ,IAClD,qBAAqB,OAAO,IAAI,KAAK,QAAQ;AAG5D,OAAI,CAAC,eAAe;AAClB,QAAI,MAAM;KAAE,aAAa,OAAO;KAAI,MAAM,OAAO;KAAM,EAAE,mCAAmC;AAC5F,SAAK,YAAY,MAAM,OAAO,IAAI,qCAAqC,OAAO,OAAO;AACrF,WAAO;;AAGT,OAAI,MAAM;IAAE,aAAa,OAAO;IAAI;IAAe,EAAE,0BAA0B;GAG/E,MAAM,SAAS,OAAO,UAAU;GAChC,MAAM,eAAe,yBAAyB,eAAe,eAAe,OAAO;AAEnF,OAAI,CAAC,aAAa,MAAM;AACtB,qBAAiB,OAAO,IAAI,aAAa;AAEzC,QAAI,KAAK,eAAe,oBAAoB,WAAW;SAEjD,CAAC,mBAAmB,OAAO,IAAI,KAAK,eAAe,EAAE;AACvD,WAAK,YAAY,MAAM,OAAO,IAAI,0BAA0B,aAAa,SAAS;AAClF,UAAI,MAAM;OAAE,aAAa,OAAO;OAAI,QAAQ,aAAa;OAAQ,EAAE,uCAAuC;AAC1G,aAAO;;;;AAMb,qBAAkB,MAAM,OAAO,IAAI,OAAO;GAE1C,MAAM,WAAW,KAAK,aAAa,cAAc;AACjD,OAAI,CAAC,UAAU;AACb,QAAI,MAAM;KAAE,aAAa,OAAO;KAAI;KAAe,EAAE,wCAAwC;AAC7F,SAAK,YAAY,MAAM,OAAO,IAAI,0BAA0B;AAC5D,WAAO;;AAGT,OAAI,SAAS,SAAS,MAAM;IAC1B,MAAM,QAAQ,SAAS,QAAQ;IAC/B,MAAM,eAAe,yBAAyB,iBAAiB,MAAM;AACrE,QAAI,aAAa,aACf,KAAI,KACF;KAAE,aAAa,OAAO;KAAI;KAAO,QAAQ,aAAa;KAAQ,EAC9D,8CACD;aACQ,CAAC,aAAa,YAAY;AACnC,SAAI,KACF;MAAE,aAAa,OAAO;MAAI;MAAO,gBAAgB;MAAiB,EAClE,sEACD;AACD,UAAK,YAAY,MACf,OAAO,IACP,aAAa,UAAU,2CACxB;AACD,YAAO;;;AAKX,OAAI,SAAS,aACX,KAAI;IACF,MAAM,SAAS,SAAS;IACxB,MAAM,kBAAkB,OAAO;AAG/B,QAAI,OAAO,SAAS,YAAY,OAAO,YAAY;KACjD,MAAM,QAAQ,OAAO;KACrB,MAAM,WAAY,OAAO,YAAyB,EAAE;AAEpD,UAAK,MAAM,SAAS,SAClB,KAAI,gBAAgB,WAAW,KAAA,GAAW;AACxC,UAAI,MAAM;OACR,aAAa,OAAO;OACpB;OACD,EAAE,6DAA6D;AAChE,aAAO;;AAIX,UAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,gBAAgB,EAAE;MAC1D,MAAM,aAAa,MAAM;AACzB,UAAI;WACE,WAAW,QAAQ,CAAC,KAAK,aAAa,OAAO,WAAW,KAAe,EAAE;AAC3E,YAAI,MAAM;SACR,aAAa,OAAO;SACpB,OAAO;SACP,UAAU,WAAW;SACrB,QAAQ,OAAO;SAChB,EAAE,oDAAoD;AACvD,eAAO;;;;;AAMf,QAAI,MAAM,EAAE,aAAa,OAAO,IAAI,EAAE,6BAA6B;YAC5D,KAAK;AACZ,QAAI,KAAK;KAAE;KAAK,aAAa,OAAO;KAAI,EAAE,mCAAmC;;GAKjF,MAAM,eAAe,QAAQ,cAAc;GAC3C,MAAM,MAAM,KAAK,mBAAmB,UAAU,QAAQ,aAAa;GAGnE,MAAM,SAAS,MAAM,KAAK,WAAW,eAAe,SAAS;AAC7D,OAAI,CAAC,QAAQ;AACX,QAAI,MAAM,EAAE,aAAa,OAAO,IAAI,EAAE,sCAAsC;AAC5E,SAAK,YAAY,MAAM,OAAO,IAAI,wBAAwB;AAC1D,WAAO;;AAKT,OAAI,CADgB,KAAK,oBAAoB,OAAO,IAAI,SACxC,CACd,KAAI,KAAK,EAAE,aAAa,OAAO,IAAI,EAAE,iCAAiC;AAIxE,SAAM,KAAK,oBAAoB,QAAQ,KAAK,SAAS;AAGrD,QAAK,SAAS,aAAa;IACzB,IAAI,OAAO;IACX,MAAM,SAAS;IACf,SAAS,SAAS;IAClB,MAAM;IACN;IACA,QAAQ,OAAO;IACf,SAAS;IACT,QAAQ,OAAO;IAChB,CAAC;GAKF,MAAM,iBAAiBA,IAAQ,WAAW;AAC1C,QAAK,MAAM,QAAQ,eAAe,QAAQ,CACxC,MAAK,SAAS,QAAQ,KAAK;AAG7B,QAAK,mBAAmB,IAAI,OAAO,IAAI,IAAI;AAG3C,QAAK,MAAM,IAAI,UAAU,IAAI;AAE7B,QAAK,YAAY,KAAK,OAAO,IAAI,qBAAqB,SAAS,OAAO;AACtE,OAAI,KAAK;IAAE,MAAM,SAAS;IAAM,IAAI,SAAS;IAAI,QAAQ,OAAO;IAAQ,EAAE,mBAAmB;AAE7F,UAAO;WACA,OAAO;AACd,OAAI,MAAM;IAAE,KAAK;IAAO,aAAa,OAAO;IAAI,EAAE,0BAA0B;AAC5E,QAAK,YAAY,MAAM,OAAO,IAAI,4BAA4B,QAAQ;AACtE,UAAO;;;;;;;CAQX,oBAA4B,aAAqB,UAAsC;EAarF,MAAM,UAAU;GARd,UAAU;GACV,OAAO;GACP,oBAAoB;GACpB,mBAAmB;GACnB,cAAc;GACd,aAAa;GAGQ,CAZV,SAAS;AAatB,MAAI,CAAC,QACH,QAAO;EAIT,MAAM,kBAAkB,KAAK,YAAY;AACzC,MAAI,mBAAmB,oBAAoB,aAAa;AACtD,OAAI,KACF;IAAE;IAAa;IAAS;IAAiB,EACzC,8BAA8B,QAAQ,qBAAqB,gBAAgB,GAC5E;AACD,QAAK,YAAY,KACf,aACA,SAAS,QAAQ,qBAAqB,gBAAgB,mBACvD;AACD,UAAO;;EAGT,MAAM,UAAU,KAAK,aAAa,MAAM,SAAS,aAAa,KAAK;AACnE,MAAI,CAAC,QACH,MAAK,YAAY,KAAK,aAAa,SAAS,QAAQ,wCAAwC;AAE9F,SAAO;;CAGT,aAAa,eAAiD;EAC5D,MAAM,eAAe,KAAK,eAAe,wBAAwB;AAGjE,MAAI,WAAW,aAAa,CAC1B,KAAI;GACF,MAAM,MAAM,KAAK,MAAM,aAAa,cAAc,QAAQ,CAAC;AAC3D,OAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,IAAI,EAAE;AACzD,QAAI,MAAM,EAAE,cAAc,EAAE,sCAAsC;AAClE,WAAO;;AAET,UAAO,2BAA2B,IAA+B;WAC1D,OAAO;AACd,OAAI,MAAM;IAAE,KAAK;IAAO;IAAc,EAAE,2BAA2B;AACnE,UAAO;;EAKX,MAAM,cAAc,KAAK,eAAe,eAAe;AACvD,MAAI,WAAW,YAAY,CACzB,KAAI;GACF,MAAM,cAAc,KAAK,MAAM,aAAa,aAAa,QAAQ,CAAC;AAGlE,OAAI,YAAY,MAAM,WAAW;IAC/B,MAAM,aAAa,YAAY;AAC/B,WAAO,2BAA2B;KAChC,IAAI,WAAW,MAAM,YAAY;KACjC,MAAM,WAAW,QAAQ,YAAY;KACrC,aAAa,WAAW,eAAe,YAAY;KACnD,SAAS,WAAW,WAAW,YAAY,WAAW;KACtD,MAAM,WAAW,QAAQ;KACzB,MAAM,WAAW,QAAQ,YAAY,QAAQ;KAC7C,cAAc,WAAW;KAC1B,CAAC;;AAIJ,OAAI,YAAY,MAAM,WAAW,kBAAkB,CAEjD,QAAO,2BAA2B;IAChC,IAFS,YAAY,KAAK,QAAQ,mBAAmB,GAEnD;IACF,MAAM,YAAY;IAClB,aAAa,YAAY;IACzB,SAAS,YAAY,WAAW;IAChC,MAAM;IACN,MAAM,YAAY,QAAQ;IAC3B,CAAC;WAEG,OAAO;AACd,OAAI,MAAM;IAAE,KAAK;IAAO;IAAa,EAAE,+BAA+B;;AAI1E,SAAO;;CAGT,MAAc,WACZ,eACA,UACiC;EAEjC,MAAM,cAAc;GAClB,SAAS;GACT;GACA;GACA;GACA;GACD,CAAC,OAAO,QAAQ;AAEjB,OAAK,MAAM,SAAS,aAAa;GAC/B,MAAM,WAAW,WAAW,MAAM,GAAG,QAAQ,KAAK,eAAe,MAAM;AAEvE,OAAI,WAAW,SAAS,CACtB,KAAI;IAEF,MAAM,MAAM,KAAK,KAAK,SAAS;AAC/B,WAAO,IAAI,WAAW;YACf,OAAO;AACd,QAAI,KAAK;KAAE,KAAK;KAAO,MAAM;KAAU,EAAE,wBAAwB;;;AAKvE,SAAO;;CAGT,mBACE,UACA,UACA,cACc;EACd,MAAM,SAAS,sBAAsB,IAAI,SAAS,GAAG,GAAG;EACxD,MAAM,cAAc,mBAAmB,cAAc,KAAK,QAAQ,gBAAgB,GAAG;EAErF,MAAM,YAAY,KAAK,cAAe,EAAE;EACxC,MAAM,gBAAiB,SAAS,UAAU,EAAE;EAE5C,MAAM,UACJ,KAAK,cAAc,KAAK,kBACpB;GACE,QAAQ,KAAK;GACb,KAAK,KAAK,gBAAgB;GAC1B,KAAK;GACL,gBAAgB,KAAK,gBAAgB;GACrC,6BAA6B,KAAK,gBAAgB;GACnD,GACD,KAAK,aACH;GACE,QAAQ,KAAK;GACb,KAAK;GACN,GACD,KAAA;EAER,MAAM,MAAM,IAAI,iBACd,SAAS,IACT,SAAS,MACT,SAAS,SACT,cACA,WACA,eACA,QACA,aACA,KAAK,UACL,QACD;AACD,MAAI,SAAS,QAAQ,gBAAgB,OACnC,KAAI,yBAAyB,SAAS,OAAO,eAAe;EAE9D,MAAM,mBAAmB,SAAS,IAAI,eAAe;AACrD,MAAI,kBAAkB,OACnB,KAAyB,qBAAqB,iBAAiB;AAElE,SAAO;;CAGT,MAAc,oBACZ,QACA,KACA,WACe;AACf,MAAI,OAAO,WAAW,WAEpB,OAAM,OAAO,IAAI;WACR,OAAO,WAAW,YAAY,OAAO,SAE9C,OAAM,OAAO,SAAS,IAAI;;CAI9B,MAAM,gBAA+B;EACnC,MAAM,WAAW,MAAM,KAAK,KAAK,SAAS,SAAS,QAAQ,CAAC;AAE5D,OAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,aAAa,oBAAoB,QAAQ,GAAG;AAClD,OAAI;AACF,UAAM,QAAQ,SAAS;AACvB,eAAW,KAAK,kBAAkB;YAC3B,OAAO;AACd,eAAW,MAAM,EAAE,KAAK,OAAO,EAAE,0BAA0B;;;;CAKjE,MAAM,eAA8B;EAClC,MAAM,WAAW,MAAM,KAAK,KAAK,SAAS,SAAS,QAAQ,CAAC,CAAC,SAAS;AAEtE,OAAK,MAAM,WAAW,SACpB,KAAI,QAAQ,MAAM;GAChB,MAAM,aAAa,oBAAoB,QAAQ,GAAG;AAClD,OAAI;AACF,UAAM,QAAQ,MAAM;AACpB,eAAW,KAAK,kBAAkB;YAC3B,OAAO;AACd,eAAW,MAAM,EAAE,KAAK,OAAO,EAAE,yBAAyB;;;;;;;CASlE,aAAqB,OAAgB,cAA+B;AAClE,MAAI,iBAAiB,SAAU,QAAO,OAAO,UAAU;AACvD,MAAI,iBAAiB,YAAY,iBAAiB,UAAW,QAAO,OAAO,UAAU;AACrF,MAAI,iBAAiB,UAAW,QAAO,OAAO,UAAU;AACxD,MAAI,iBAAiB,QAAS,QAAO,MAAM,QAAQ,MAAM;AACzD,MAAI,iBAAiB,SAAU,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;AAC1G,SAAO;;;AAQX,SAAgB,qBAAqB,IAAY,UAAiD;CAChG,MAAM,IAAI,YAAY;CAGtB,MAAM,gBAAgB,KAAK,8BAA8B,GAF7C,sBAAsB,EAE6B,CAAC,EAAE,GAAG;AACrE,KAAI,WAAW,cAAc,CAAE,QAAO;CAGtC,MAAM,aAAa,KAAK,sBAAsB,EAAE,GAAG;AACnD,KAAI,WAAW,WAAW,CAAE,QAAO;CAGnC,MAAM,aAAa,6BAA6B;AAChD,KAAI,YAAY;EACd,MAAM,cAAc,KAAK,YAAY,GAAG;AACxC,MAAI,WAAW,YAAY,CAAE,QAAO;;AAItC,KAAI;AAGF,SAAO,QAFS,cAAc,OAAO,KAAK,IAClB,CAAC,QAAQ,GACV,CAAC;SAClB;AACN,SAAO;;;AAIX,SAAgB,yBACd,WAC2B;CAC3B,MAAM,aAAwC,EAAE;CAEhD,MAAM,UAAW,UAAU,WAAwB,EAAE;CACrD,MAAM,WAAY,UAAU,YAAyB,EAAE;AAGvD,MAAK,MAAM,MAAM,SAAS;EACxB,MAAM,SAAU,UAAU,OAAmC,EAAE;AAC/D,aAAW,KAAK;GACd;GACA,MAAM;GACN,QAAQ;GACR,MAAM;GACN,SAAS;GACT;GACD,CAAC;;AAIJ,MAAK,MAAM,MAAM,SACf,KAAI,CAAC,WAAW,MAAM,MAAM,EAAE,OAAO,GAAG,EAAE;EACxC,MAAM,SAAU,UAAU,OAAmC,EAAE;AAC/D,aAAW,KAAK;GACd;GACA,MAAM;GACN,QAAQ;GACR,MAAM;GACN,SAAS;GACT;GACD,CAAC;;AAIN,QAAO"}

package/dist/src/extensions/sdk/index.d.ts CHANGED Viewed

@@ -9,7 +9,7 @@
  */
 export type { ExtensionDefinition, ExtensionModule, ExtensionKind, ExtensionApi, ExtensionLogger, ExtensionManifest, ExtensionRecord, ExtensionRegistry, ResolvedExtensionConfig, ExtensionRuntime, ExtensionCliRegistration, } from '../types/index.js';
 export type { AgentTool, AgentToolResult, AgentToolUpdateCallback, ToolExecutionStartEvent, ToolExecutionUpdateEvent, ToolExecutionEndEvent, } from '../types/index.js';
-export type { ExtensionHookEvent, ExtensionHookHandler, HookOptions, HookAgentContext, AgentMessage, ContextEvent, ContextResult, InputEvent, InputResult, TurnEvent, TurnResult, HookHandlerMap, HookExecutionMode, HookBeforeModelResolveEvent, HookBeforeModelResolveResult, HookBeforePromptBuildEvent, HookBeforePromptBuildResult, HookLlmInputEvent, HookLlmOutputEvent, HookInboundClaimEvent, HookInboundClaimResult, HookBeforeResetEvent, HookBeforeResetResult, HookBeforeMessageWriteEvent, HookBeforeMessageWriteResult, HookTurnStartEvent, HookTurnEndEvent, HookToolExecutionStartEvent, HookToolExecutionUpdateEvent, HookToolExecutionEndEvent, HookContext, BeforeAgentStartContext, BeforeAgentStartResult, AgentEndContext, BeforeCompactionContext, AfterCompactionContext, MessageReceivedContext, MessageSendingContext, MessageSendingResult, MessageSentContext, BeforeToolCallContext, BeforeToolCallResult, AfterToolCallContext, SessionStartContext, SessionEndContext, GatewayStartContext, GatewayStopContext, } from '../types/index.js';
+export type { ExtensionHookEvent, ExtensionHookHandler, HookOptions, HookAgentContext, AgentMessage, ContextEvent, ContextResult, InputEvent, InputResult, TurnEvent, TurnResult, HookHandlerMap, HookExecutionMode, HookBeforeModelResolveEvent, HookBeforeModelResolveResult, HookBeforePromptBuildEvent, HookBeforePromptBuildResult, HookLlmInputEvent, HookLlmOutputEvent, HookInboundClaimEvent, HookInboundClaimResult, HookBeforeResetEvent, HookBeforeResetResult, HookBeforeMessageWriteEvent, HookBeforeMessageWriteResult, HookTurnStartEvent, HookTurnEndEvent, HookToolExecutionStartEvent, HookToolExecutionUpdateEvent, HookToolExecutionEndEvent, HookContext, BeforeAgentStartContext, BeforeAgentStartResult, AgentEndContext, WebchatTurnCompleteEvent, BeforeCompactionContext, AfterCompactionContext, MessageReceivedContext, MessageSendingContext, MessageSendingResult, MessageSentContext, BeforeToolCallContext, BeforeToolCallResult, AfterToolCallContext, SessionStartContext, SessionEndContext, GatewayStartContext, GatewayStopContext, } from '../types/index.js';
 export type { EventMap, RequestMap, EventHandler, EventHandlerMeta, RequestHandler, RequestHandlerMeta, WildcardEventHandler, WildcardHandlerMeta, TypedEventBusOptions, RequestOptions, } from '../types/index.js';
 export type { ProviderPlugin, ProviderModelDefinition, ProviderCapabilities, ProviderStreamParams, ProviderStreamChunk, ProviderCompleteParams, ProviderResponse, ProviderRegistry, BUILTIN_PROVIDERS, BuiltinProviderId, } from '../types/index.js';
 export type { ProviderConfig, ModelConfig, OAuthConfig, OAuthCallbacks, OAuthCredentials, FlagConfig, FlagValue, ShortcutConfig, ShortcutHandler, } from '../types/index.js';

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":[],"sources":["../../../../src/extensions/sdk/index.ts"],"sourcesContent":["/*\n xopc Extension SDK\n * \n * Official SDK for developing xopc extensions.\n * Import types and utilities from this module:\n * \n * @example\n * import type { ExtensionApi, ExtensionDefinition } from 'xopc/extension-sdk';\n */\n\n// ============================================================================\n// Core extension types\n// ============================================================================\n\nexport type {\n ExtensionDefinition,\n ExtensionModule,\n ExtensionKind,\n ExtensionApi,\n ExtensionLogger,\n ExtensionManifest,\n ExtensionRecord,\n ExtensionRegistry,\n ResolvedExtensionConfig,\n ExtensionRuntime,\n ExtensionCliRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Tools (re-exported from @mariozechner/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 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\n// ============================================================================\n// Security Types\n// ============================================================================\n\nexport type {\n SafetyCheckResult,\n SecurityConfig,\n ExtensionSourceOrigin,\n ProvenanceInfo,\n} from '../security.js';\n\n// ============================================================================\n// Slot Types\n// ============================================================================\n\nexport type {\n SlotKey,\n SlotClaim,\n SlotConfig,\n} from '../slots.js';\n\n// ============================================================================\n// Diagnostics Types\n// ============================================================================\n\nexport type {\n DiagnosticLevel,\n ExtensionDiagnostic,\n ExtensionLoaderCache,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Channels (ChannelPlugin registry)\n// ============================================================================\n\nexport type {\n ChannelPlugin,\n ChannelPluginInitOptions,\n ChannelPluginStartOptions,\n} from '../../channels/plugin-types.js';\n\n// ============================================================================\n// HTTP\n// ============================================================================\n\nexport type {\n HttpRequestHandler,\n HttpRequest,\n HttpResponse,\n} from '../types/index.js';\n\n// ============================================================================\n// Commands\n// ============================================================================\n\nexport type {\n ExtensionCommand,\n ExtensionCommandHandler,\n ExtensionCommandContext,\n ExtensionCommandResult,\n ExtensionReloadHandler,\n ExtensionReloadResult,\n ExtensionReloadRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport type {\n ExtensionService,\n} from '../types/index.js';\n\n// ============================================================================\n// Gateway\n// ============================================================================\n\nexport type {\n GatewayMethodHandler,\n} from '../types/index.js';\n\n// ============================================================================\n// Export Classes\n// ============================================================================\n\nexport { TypedEventBus } from '../typed-event-bus.js';\nexport { ExtensionRegistryImpl } from '../loader.js';\nexport { ProviderPluginRegistry, getProviderRegistry } from '../../providers/plugin-registry.js';\nexport { SlotRegistry, getSlotRegistry, registerSlotType } from '../slots.js';\nexport { HOOK_EXECUTION_MODES } from '../types/hooks.js';\n\nexport { defineChannelPluginEntry } from './channel-entry.js';\nexport { registerExtensionCliProgram } from './channel-helpers.js';\n\n// ============================================================================\n// Export Hook Runner and Utilities\n// ============================================================================\n\nexport { \n ExtensionHookRunner, \n createHookContext, \n isHookEvent \n} from '../hooks.js';\n\n// ============================================================================\n// Security Utilities\n// ============================================================================\n\nexport {\n checkExtensionPathSafety,\n checkExtensionDirSafety,\n isExtensionAllowed,\n provenanceTracker,\n logSecurityIssue,\n DEFAULT_SECURITY_CONFIG,\n} from '../security.js';\n\n// ============================================================================\n// Diagnostics Utilities\n// ============================================================================\n\nexport {\n getExtensionCache,\n getExtensionDiagnostics,\n ExtensionLoaderCacheImpl,\n ExtensionDiagnostics,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Config\n// ============================================================================\n\nexport type { Config } from '../../config/config-surface.js';\n\n// Subpath barrels (also available as `xopc/extension-sdk/<name>`)\nexport { lazyModule, lazyFunction } from './lazy.js';\n\nexport { createMockExtensionApi, createTestGateway } from './testing.js';\nexport type {\n MockExtensionApi,\n MockExtensionApiOptions,\n TestGateway,\n} from './testing.js';\n"],"mappings":";;;;;;;;;;;;;~~sBAiPiG~~"}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../../../../src/extensions/sdk/index.ts"],"sourcesContent":["/*\n xopc Extension SDK\n * \n * Official SDK for developing xopc extensions.\n * Import types and utilities from this module:\n * \n * @example\n * import type { ExtensionApi, ExtensionDefinition } from 'xopc/extension-sdk';\n */\n\n// ============================================================================\n// Core extension types\n// ============================================================================\n\nexport type {\n ExtensionDefinition,\n ExtensionModule,\n ExtensionKind,\n ExtensionApi,\n ExtensionLogger,\n ExtensionManifest,\n ExtensionRecord,\n ExtensionRegistry,\n ResolvedExtensionConfig,\n ExtensionRuntime,\n ExtensionCliRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Tools (re-exported from @mariozechner/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\n// ============================================================================\n// Security Types\n// ============================================================================\n\nexport type {\n SafetyCheckResult,\n SecurityConfig,\n ExtensionSourceOrigin,\n ProvenanceInfo,\n} from '../security.js';\n\n// ============================================================================\n// Slot Types\n// ============================================================================\n\nexport type {\n SlotKey,\n SlotClaim,\n SlotConfig,\n} from '../slots.js';\n\n// ============================================================================\n// Diagnostics Types\n// ============================================================================\n\nexport type {\n DiagnosticLevel,\n ExtensionDiagnostic,\n ExtensionLoaderCache,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Channels (ChannelPlugin registry)\n// ============================================================================\n\nexport type {\n ChannelPlugin,\n ChannelPluginInitOptions,\n ChannelPluginStartOptions,\n} from '../../channels/plugin-types.js';\n\n// ============================================================================\n// HTTP\n// ============================================================================\n\nexport type {\n HttpRequestHandler,\n HttpRequest,\n HttpResponse,\n} from '../types/index.js';\n\n// ============================================================================\n// Commands\n// ============================================================================\n\nexport type {\n ExtensionCommand,\n ExtensionCommandHandler,\n ExtensionCommandContext,\n ExtensionCommandResult,\n ExtensionReloadHandler,\n ExtensionReloadResult,\n ExtensionReloadRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Services\n// ============================================================================\n\nexport type {\n ExtensionService,\n} from '../types/index.js';\n\n// ============================================================================\n// Gateway\n// ============================================================================\n\nexport type {\n GatewayMethodHandler,\n} from '../types/index.js';\n\n// ============================================================================\n// Export Classes\n// ============================================================================\n\nexport { TypedEventBus } from '../typed-event-bus.js';\nexport { ExtensionRegistryImpl } from '../loader.js';\nexport { ProviderPluginRegistry, getProviderRegistry } from '../../providers/plugin-registry.js';\nexport { SlotRegistry, getSlotRegistry, registerSlotType } from '../slots.js';\nexport { HOOK_EXECUTION_MODES } from '../types/hooks.js';\n\nexport { defineChannelPluginEntry } from './channel-entry.js';\nexport { registerExtensionCliProgram } from './channel-helpers.js';\n\n// ============================================================================\n// Export Hook Runner and Utilities\n// ============================================================================\n\nexport { \n ExtensionHookRunner, \n createHookContext, \n isHookEvent \n} from '../hooks.js';\n\n// ============================================================================\n// Security Utilities\n// ============================================================================\n\nexport {\n checkExtensionPathSafety,\n checkExtensionDirSafety,\n isExtensionAllowed,\n provenanceTracker,\n logSecurityIssue,\n DEFAULT_SECURITY_CONFIG,\n} from '../security.js';\n\n// ============================================================================\n// Diagnostics Utilities\n// ============================================================================\n\nexport {\n getExtensionCache,\n getExtensionDiagnostics,\n ExtensionLoaderCacheImpl,\n ExtensionDiagnostics,\n} from '../diagnostics.js';\n\n// ============================================================================\n// Config\n// ============================================================================\n\nexport type { Config } from '../../config/config-surface.js';\n\n// Subpath barrels (also available as `xopc/extension-sdk/<name>`)\nexport { lazyModule, lazyFunction } from './lazy.js';\n\nexport { createMockExtensionApi, createTestGateway } from './testing.js';\nexport type {\n MockExtensionApi,\n MockExtensionApiOptions,\n TestGateway,\n} from './testing.js';\n"],"mappings":";;;;;;;;;;;;;sBAkPiG"}

package/dist/src/extensions/types/core.d.ts CHANGED Viewed

@@ -11,6 +11,7 @@ import type { TypedEventBus } from './events.js';
 import type { AgentTool } from '@mariozechner/pi-agent-core';
 import type { ExtensionHookEvent, ExtensionHookHandler, HookOptions, HookHandlerMap } from './hooks.js';
 import type { ChannelPlugin } from '../../channels/plugin-types.js';
+import type { SessionMetadata } from '../../session/types.js';
 import type { FlagConfig, FlagValue, ShortcutConfig } from './phase4.js';
 import type { ProviderPlugin } from './providers.js';
 export interface ExtensionDefinition {
@@ -38,6 +39,8 @@ export type ExtensionModule = ExtensionDefinition | ((api: ExtensionApi) => void
 /** Optional: session manager when extension runs inside Gateway. */
 export type ExtensionSessionManager = {
     initialize?: () => Promise<void>;
+    getSessionMetadata?: (key: string) => Promise<SessionMetadata | null>;
+    updateSessionMetadata?: (key: string, updates: Partial<SessionMetadata>) => Promise<void>;
 };
 export interface ExtensionRuntime {
     config: Config;
@@ -45,6 +48,11 @@ export interface ExtensionRuntime {
     bus?: MessageBus;
     log: ExtensionLogger;
     sessionManager?: ExtensionSessionManager;
+    /**
+     * Queue another webchat agent turn (same as POST /api/agent) after the current run unlocks.
+     * Only injected in the Gateway process.
+     */
+    scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;
 }
 export interface ExtensionCliRegistration {
     extensionId: string;

package/dist/src/extensions/types/hooks.d.ts CHANGED Viewed

@@ -6,7 +6,9 @@
  */
 import type { AgentMessage } from '@mariozechner/pi-agent-core';
 export type { AgentMessage };
-export type ExtensionHookEvent = 'before_agent_start' | 'agent_end' | 'before_compaction' | 'after_compaction' | 'message_received' | 'message_sending' | 'message_sent' | 'before_tool_call' | 'after_tool_call' | 'session_start' | 'session_end' | 'gateway_start' | 'gateway_stop' | 'context' | 'input' | 'turn_start' | 'turn_end' | 'tool_execution_start' | 'tool_execution_update' | 'tool_execution_end' | 'before_model_resolve' | 'before_prompt_build' | 'llm_input' | 'llm_output' | 'inbound_claim' | 'before_reset' | 'before_message_write' | 'subagent_spawning' | 'subagent_delivery_target' | 'subagent_ended';
+export type ExtensionHookEvent = 'before_agent_start' | 'agent_end' | 'before_compaction' | 'after_compaction' | 'message_received' | 'message_sending' | 'message_sent' | 'before_tool_call' | 'after_tool_call' | 'session_start' | 'session_end' | 'gateway_start' | 'gateway_stop' | 'context' | 'input' | 'turn_start' | 'turn_end' | 'tool_execution_start' | 'tool_execution_update' | 'tool_execution_end' | 'before_model_resolve' | 'before_prompt_build' | 'llm_input' | 'llm_output' | 'inbound_claim' | 'before_reset' | 'before_message_write' | 'subagent_spawning' | 'subagent_delivery_target' | 'subagent_ended'
+/** After a webchat direct stream finishes (success or error); session lock released. */
+ | 'webchat_turn_complete';
 /**
  * Hook execution mode determines how handlers are processed:
  * - void: Fire-and-forget, parallel execution (for notifications)
@@ -184,6 +186,7 @@ export type HookHandlerMap = {
     llm_input: (event: HookLlmInputEvent, ctx: HookAgentContext) => Promise<void> | void;
     llm_output: (event: HookLlmOutputEvent, ctx: HookAgentContext) => Promise<void> | void;
     agent_end: (event: AgentEndContext, ctx: HookAgentContext) => Promise<void> | void;
+    webchat_turn_complete: (event: WebchatTurnCompleteEvent, ctx: HookAgentContext) => Promise<void> | void;
     before_compaction: (event: BeforeCompactionContext, ctx: HookAgentContext) => Promise<void> | void;
     after_compaction: (event: AfterCompactionContext, ctx: HookAgentContext) => Promise<void> | void;
     message_received: (event: MessageReceivedContext, ctx: HookAgentContext) => Promise<void> | void;
@@ -229,6 +232,18 @@ export interface AgentEndContext extends HookContext {
     error?: string;
     durationMs?: number;
 }
+/** Payload for {@link ExtensionHookEvent} `webchat_turn_complete` (also passed as `event` fields + ctx.sessionKey). */
+export interface WebchatTurnCompleteEvent extends HookContext {
+    sessionKey: string;
+    /** Raw inbound user text from the POST body (before model envelope). */
+    inboundUserText: string;
+    /** Last assistant visible text after persistence (may be empty). */
+    assistantPlainText: string;
+    /** User aborted the HTTP/SSE run. */
+    aborted: boolean;
+    /** Set when the direct stream threw before normal completion. */
+    streamError?: string;
+}
 export interface BeforeCompactionContext extends HookContext {
     messageCount: number;
     tokenCount?: number;

package/dist/src/extensions/types/hooks.js CHANGED Viewed

@@ -22,6 +22,7 @@ const HOOK_EXECUTION_MODES = {
 	"tool_execution_end": "void",
 	"before_reset": "void",
 	"subagent_ended": "void",
+	"webchat_turn_complete": "void",
 	"before_agent_start": "modifying",
 	"before_model_resolve": "modifying",
 	"before_prompt_build": "modifying",

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

	@@ -1 +1 @@
1	- {"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 '@mariozechner/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\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 \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}\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 // 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}\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\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":";;;;AAuEA,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;CAGlB,sBAAsB;CACtB,wBAAwB;CACxB,uBAAuB;CACvB,mBAAmB;CACnB,oBAAoB;CACpB,WAAW;CACX,SAAS;CACT,wBAAwB;CACxB,qBAAqB;CACrB,4BAA4B;CAG5B,iBAAiB;CAClB"}
1	+ {"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 '@mariozechner/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}\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}\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 /* 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/gateway/agents-admin.d.ts CHANGED Viewed

@@ -6,6 +6,8 @@ export type GatewayAgentRow = {
     id: string;
     name?: string;
     description?: string;
+    /** Value from `IDENTITY.md` **Avatar:** line when present (may be URL, `xopc:…`, etc.). */
+    avatar?: string;
     workspace: string;
     bootstrapDir: string;
     model?: {
@@ -29,7 +31,9 @@ export type GatewayAgentsListResponse = {
     agents: GatewayAgentRow[];
     builtinToolIds: string[];
 };
-export declare function listGatewayAgents(cfg: Config): GatewayAgentsListResponse;
+/** Extract `**Avatar:**` value from bootstrap IDENTITY.md (same line shape as the gateway console parser). */
+export declare function extractAvatarFromIdentityMarkdown(content: string): string | undefined;
+export declare function listGatewayAgents(cfg: Config): Promise<GatewayAgentsListResponse>;
 export type CreateAgentBody = {
     /** Display name stored on the agent entry. */
     name: string;
@@ -95,3 +99,17 @@ export declare function writeAgentBootstrapFile(cfg: Config, agentId: string, na
     agentId: string;
     path: string;
 }>>;
+export declare function readAgentAvatarFile(cfg: Config, agentId: string): Promise<AgentAdminResult<{
+    agentId: string;
+    buffer: Buffer;
+    contentType: string;
+    path: string;
+}>>;
+export declare function writeAgentAvatarFromBase64(cfg: Config, agentId: string, base64: string, mimeType: string): Promise<AgentAdminResult<{
+    agentId: string;
+    path: string;
+}>>;
+/** Remove any `agent-avatar.*` in the agent bootstrap dir. Idempotent: ok even when no file existed. */
+export declare function deleteAgentAvatarFile(cfg: Config, agentId: string): Promise<AgentAdminResult<{
+    agentId: string;
+}>>;