@xopcai/xopc 0.0.23 → 0.0.25

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

@@ -12,6 +12,12 @@ function normalizeReload(raw) {
 		...supportsHotReload !== void 0 ? { supportsHotReload } : {}
 	};
 }
+function normalizeEngines(raw) {
+	if (!isRecord(raw)) return void 0;
+	const xopc = typeof raw.xopc === "string" && raw.xopc.length > 0 ? raw.xopc : void 0;
+	if (!xopc) return void 0;
+	return { xopc };
+}
 function normalizeManifestCommands(raw) {
 	if (!Array.isArray(raw)) return void 0;
 	const out = [];
@@ -60,6 +66,7 @@ function normalizeExtensionManifest(raw) {
 		contracts: normalizeContracts(raw.contracts),
 		setup: normalizeSetup(raw.setup),
 		reload: normalizeReload(raw.reload),
+		engines: normalizeEngines(raw.engines),
 		commands: normalizeManifestCommands(raw.commands),
 		ui: normalizeUiManifest(raw.ui)
 	};
@@ -129,7 +136,8 @@ function normalizeSidebarPanels(raw) {
 			title,
 			entrypoint,
 			icon: typeof item.icon === "string" ? item.icon : void 0,
-			defaultVisible: typeof item.defaultVisible === "boolean" ? item.defaultVisible : void 0
+			defaultVisible: typeof item.defaultVisible === "boolean" ? item.defaultVisible : void 0,
+			when: typeof item.when === "string" && item.when.length > 0 ? item.when : void 0
 		});
 	}
 	return out.length ? out : void 0;
@@ -203,7 +211,8 @@ function normalizePages(raw) {
 			path,
 			entrypoint,
 			showInNav: typeof item.showInNav === "boolean" ? item.showInNav : void 0,
-			navIcon: typeof item.navIcon === "string" ? item.navIcon : void 0
+			navIcon: typeof item.navIcon === "string" ? item.navIcon : void 0,
+			when: typeof item.when === "string" && item.when.length > 0 ? item.when : void 0
 		});
 	}
 	return out.length ? out : void 0;
@@ -220,7 +229,9 @@ function normalizeCommands(raw) {
 			id,
 			title,
 			shortcut: typeof item.shortcut === "string" ? item.shortcut : void 0,
-			opensPanel: typeof item.opensPanel === "string" ? item.opensPanel : void 0
+			opensPanel: typeof item.opensPanel === "string" ? item.opensPanel : void 0,
+			chatAlias: typeof item.chatAlias === "string" && item.chatAlias.length > 0 ? item.chatAlias : void 0,
+			when: typeof item.when === "string" && item.when.length > 0 ? item.when : void 0
 		});
 	}
 	return out.length ? out : void 0;
@@ -238,7 +249,8 @@ function normalizeStatusBarItems(raw) {
 			id,
 			entrypoint,
 			position: position === "left" || position === "right" ? position : void 0,
-			width: typeof item.width === "number" ? item.width : void 0
+			width: typeof item.width === "number" ? item.width : void 0,
+			when: typeof item.when === "string" && item.when.length > 0 ? item.when : void 0
 		});
 	}
 	return out.length ? out : void 0;

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

@@ -1 +1 @@
-{"version":3,"file":"normalize-manifest.js","names":[],"sources":["../../../src/extensions/normalize-manifest.ts"],"sourcesContent":["import type {\n  ActivationDeclaration,\n  ChatWidgetContribution,\n  ChatWidgetMatch,\n  CommandContribution,\n  ContractDeclaration,\n  ExtensionManifest,\n  ExtensionManifestCommand,\n  ExtensionUiContributions,\n  ExtensionUiManifest,\n  ExtensionUiPermission,\n  ModelSupportDeclaration,\n  PageContribution,\n  ProviderAuthChoice,\n  SettingsPanelContribution,\n  SetupDeclaration,\n  SidebarPanelContribution,\n  StatusBarItemContribution,\n} from './types/manifest.js';\nimport type { ExtensionKind } from './types/core.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction normalizeReload(raw: unknown): ExtensionManifest['reload'] {\n  if (!isRecord(raw)) return undefined;\n  const configPrefixes = Array.isArray(raw.configPrefixes)\n    ? raw.configPrefixes.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const supportsHotReload =\n    typeof raw.supportsHotReload === 'boolean' ? raw.supportsHotReload : undefined;\n  if (!configPrefixes?.length && supportsHotReload === undefined) return undefined;\n  return {\n    ...(configPrefixes?.length ? { configPrefixes } : {}),\n    ...(supportsHotReload !== undefined ? { supportsHotReload } : {}),\n  };\n}\n\nfunction normalizeManifestCommands(raw: unknown): ExtensionManifestCommand[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ExtensionManifestCommand[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const name = typeof item.name === 'string' ? item.name.trim() : '';\n    const description = typeof item.description === 'string' ? item.description : '';\n    if (!name || !description) continue;\n    const aliases = Array.isArray(item.aliases)\n      ? item.aliases.filter((x): x is string => typeof x === 'string')\n      : undefined;\n    const scope = Array.isArray(item.scope)\n      ? item.scope.filter(\n          (x): x is 'global' | 'private' | 'group' =>\n            x === 'global' || x === 'private' || x === 'group',\n        )\n      : undefined;\n    const examples = Array.isArray(item.examples)\n      ? item.examples.filter((x): x is string => typeof x === 'string')\n      : undefined;\n    out.push({\n      name,\n      description,\n      ...(aliases?.length ? { aliases } : {}),\n      ...(scope?.length ? { scope } : {}),\n      ...(examples?.length ? { examples } : {}),\n    });\n  }\n  return out.length > 0 ? out : undefined;\n}\n\n/**\n * Normalize raw JSON manifest into ExtensionManifest with stable optional fields.\n */\nexport function normalizeExtensionManifest(raw: Record<string, unknown>): ExtensionManifest {\n  const id = String(raw.id ?? '');\n  return {\n    id,\n    name: typeof raw.name === 'string' && raw.name.length > 0 ? raw.name : id,\n    description: typeof raw.description === 'string' ? raw.description : undefined,\n    version: typeof raw.version === 'string' ? raw.version : undefined,\n    kind: raw.kind as ExtensionKind | undefined,\n    main: typeof raw.main === 'string' ? raw.main : undefined,\n    configSchema: isRecord(raw.configSchema) ? (raw.configSchema as Record<string, unknown>) : undefined,\n    dependencies: isRecord(raw.dependencies) ? (raw.dependencies as Record<string, string>) : undefined,\n\n    enabledByDefault: typeof raw.enabledByDefault === 'boolean' ? raw.enabledByDefault : undefined,\n    legacyExtensionIds: Array.isArray(raw.legacyExtensionIds)\n      ? raw.legacyExtensionIds.filter((x): x is string => typeof x === 'string')\n      : undefined,\n\n    providers: Array.isArray(raw.providers)\n      ? raw.providers.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    providerAuthEnvVars: normalizeStringArrayMap(raw.providerAuthEnvVars),\n    providerAuthChoices: normalizeProviderAuthChoices(raw.providerAuthChoices),\n    modelSupport: normalizeModelSupport(raw.modelSupport),\n    autoEnableWhenConfiguredProviders: Array.isArray(raw.autoEnableWhenConfiguredProviders)\n      ? raw.autoEnableWhenConfiguredProviders.filter((x): x is string => typeof x === 'string')\n      : undefined,\n\n    channels: Array.isArray(raw.channels)\n      ? raw.channels.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    channelEnvVars: normalizeStringArrayMap(raw.channelEnvVars),\n\n    activation: normalizeActivation(raw.activation),\n    contracts: normalizeContracts(raw.contracts),\n    setup: normalizeSetup(raw.setup),\n    reload: normalizeReload(raw.reload),\n    commands: normalizeManifestCommands(raw.commands),\n    ui: normalizeUiManifest(raw.ui),\n  };\n}\n\nconst VALID_UI_PERMISSIONS = new Set<ExtensionUiPermission>([\n  'agent.send',\n  'agent.subscribe',\n  'session.read',\n  'session.write',\n  'config.read',\n  'config.write',\n  'storage',\n  'notification',\n  'clipboard',\n  'theme',\n  'workspace.read',\n  'workspace.write',\n]);\n\nexport function normalizeUiManifest(raw: unknown): ExtensionUiManifest | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (!isRecord(raw)) return undefined;\n  const main = typeof raw.main === 'string' && raw.main.length > 0 ? raw.main : undefined;\n  const icon = typeof raw.icon === 'string' && raw.icon.length > 0 ? raw.icon : undefined;\n  let permissions: ExtensionUiPermission[] | undefined;\n  if (Array.isArray(raw.permissions)) {\n    const p = raw.permissions.filter(\n      (x): x is ExtensionUiPermission =>\n        typeof x === 'string' && VALID_UI_PERMISSIONS.has(x as ExtensionUiPermission),\n    );\n    permissions = p.length ? p : undefined;\n  }\n  const contributions = normalizeUiContributions(raw.contributions);\n  if (!main && !icon && !permissions && !contributions) return undefined;\n  return {\n    ...(main !== undefined ? { main } : {}),\n    ...(icon !== undefined ? { icon } : {}),\n    ...(permissions !== undefined ? { permissions } : {}),\n    ...(contributions !== undefined ? { contributions } : {}),\n  };\n}\n\nfunction normalizeUiContributions(raw: unknown): ExtensionUiContributions | undefined {\n  if (!isRecord(raw)) return undefined;\n  const sidebarPanels = normalizeSidebarPanels(raw.sidebarPanels);\n  const settingsPanels = normalizeSettingsPanels(raw.settingsPanels);\n  const chatWidgets = normalizeChatWidgets(raw.chatWidgets);\n  const pages = normalizePages(raw.pages);\n  const commands = normalizeCommands(raw.commands);\n  const statusBarItems = normalizeStatusBarItems(raw.statusBarItems);\n  const out: ExtensionUiContributions = {\n    ...(sidebarPanels ? { sidebarPanels } : {}),\n    ...(settingsPanels ? { settingsPanels } : {}),\n    ...(chatWidgets ? { chatWidgets } : {}),\n    ...(pages ? { pages } : {}),\n    ...(commands ? { commands } : {}),\n    ...(statusBarItems ? { statusBarItems } : {}),\n  };\n  return Object.keys(out).length ? out : undefined;\n}\n\nfunction normalizeSidebarPanels(raw: unknown): SidebarPanelContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: SidebarPanelContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      entrypoint,\n      icon: typeof item.icon === 'string' ? item.icon : undefined,\n      defaultVisible: typeof item.defaultVisible === 'boolean' ? item.defaultVisible : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeSettingsPanels(raw: unknown): SettingsPanelContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: SettingsPanelContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      entrypoint,\n      order: typeof item.order === 'number' ? item.order : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeChatWidgetMatch(raw: unknown): ChatWidgetMatch | undefined {\n  if (!isRecord(raw)) return undefined;\n  const toolName = typeof raw.toolName === 'string' ? raw.toolName : undefined;\n  const contentType = typeof raw.contentType === 'string' ? raw.contentType : undefined;\n  let metadata: Record<string, unknown> | undefined;\n  if (isRecord(raw.metadata)) {\n    metadata = { ...raw.metadata };\n  }\n  if (!toolName && !contentType && !metadata) return undefined;\n  return { toolName, contentType, metadata };\n}\n\nfunction normalizeChatWidgets(raw: unknown): ChatWidgetContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ChatWidgetContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    const match = normalizeChatWidgetMatch(item.match);\n    if (!match) continue;\n    out.push({\n      id,\n      title,\n      entrypoint,\n      match,\n      maxHeight: typeof item.maxHeight === 'number' ? item.maxHeight : undefined,\n      interactive: typeof item.interactive === 'boolean' ? item.interactive : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizePages(raw: unknown): PageContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: PageContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const path = item.path;\n    const entrypoint = item.entrypoint;\n    if (\n      typeof id !== 'string' ||\n      typeof title !== 'string' ||\n      typeof path !== 'string' ||\n      typeof entrypoint !== 'string'\n    ) {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      path,\n      entrypoint,\n      showInNav: typeof item.showInNav === 'boolean' ? item.showInNav : undefined,\n      navIcon: typeof item.navIcon === 'string' ? item.navIcon : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeCommands(raw: unknown): CommandContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: CommandContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    if (typeof id !== 'string' || typeof title !== 'string') continue;\n    out.push({\n      id,\n      title,\n      shortcut: typeof item.shortcut === 'string' ? item.shortcut : undefined,\n      opensPanel: typeof item.opensPanel === 'string' ? item.opensPanel : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeStatusBarItems(raw: unknown): StatusBarItemContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: StatusBarItemContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof entrypoint !== 'string') continue;\n    const position = item.position;\n    out.push({\n      id,\n      entrypoint,\n      position: position === 'left' || position === 'right' ? position : undefined,\n      width: typeof item.width === 'number' ? item.width : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeStringArrayMap(\n  raw: unknown,\n): Record<string, string[]> | undefined {\n  if (!isRecord(raw)) return undefined;\n  const out: Record<string, string[]> = {};\n  for (const [k, v] of Object.entries(raw)) {\n    if (Array.isArray(v)) {\n      const arr = v.filter((x): x is string => typeof x === 'string');\n      if (arr.length) out[k] = arr;\n    }\n  }\n  return Object.keys(out).length ? out : undefined;\n}\n\nfunction normalizeProviderAuthChoices(raw: unknown): ProviderAuthChoice[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ProviderAuthChoice[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const provider = item.provider;\n    const method = item.method;\n    const choiceId = item.choiceId;\n    const choiceLabel = item.choiceLabel;\n    if (\n      typeof provider !== 'string' ||\n      typeof choiceId !== 'string' ||\n      typeof choiceLabel !== 'string' ||\n      (method !== 'api-key' && method !== 'oauth' && method !== 'cli' && method !== 'env')\n    ) {\n      continue;\n    }\n    out.push({\n      provider,\n      method,\n      choiceId,\n      choiceLabel,\n      choiceHint: typeof item.choiceHint === 'string' ? item.choiceHint : undefined,\n      groupId: typeof item.groupId === 'string' ? item.groupId : undefined,\n      groupLabel: typeof item.groupLabel === 'string' ? item.groupLabel : undefined,\n      groupHint: typeof item.groupHint === 'string' ? item.groupHint : undefined,\n      cliFlag: typeof item.cliFlag === 'string' ? item.cliFlag : undefined,\n      cliOption: typeof item.cliOption === 'string' ? item.cliOption : undefined,\n      cliDescription: typeof item.cliDescription === 'string' ? item.cliDescription : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeModelSupport(raw: unknown): ModelSupportDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const modelPrefixes = Array.isArray(raw.modelPrefixes)\n    ? raw.modelPrefixes.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const modelPatterns = Array.isArray(raw.modelPatterns)\n    ? raw.modelPatterns.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  if (!modelPrefixes?.length && !modelPatterns?.length) return undefined;\n  return { modelPrefixes, modelPatterns };\n}\n\nfunction normalizeActivation(raw: unknown): ActivationDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const onProviders = Array.isArray(raw.onProviders)\n    ? raw.onProviders.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const onCommands = Array.isArray(raw.onCommands)\n    ? raw.onCommands.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const onChannels = Array.isArray(raw.onChannels)\n    ? raw.onChannels.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const capRaw = raw.onCapabilities;\n  const onCapabilities = Array.isArray(capRaw)\n    ? capRaw.filter(\n        (x): x is 'provider' | 'channel' | 'tool' | 'hook' =>\n          x === 'provider' || x === 'channel' || x === 'tool' || x === 'hook',\n      )\n    : undefined;\n  if (!onProviders?.length && !onCommands?.length && !onChannels?.length && !onCapabilities?.length) {\n    return undefined;\n  }\n  return { onProviders, onCommands, onChannels, onCapabilities };\n}\n\nfunction normalizeContracts(raw: unknown): ContractDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const pick = (k: string) =>\n    Array.isArray(raw[k]) ? raw[k].filter((x: unknown): x is string => typeof x === 'string') : undefined;\n  const c: ContractDeclaration = {\n    mediaUnderstandingProviders: pick('mediaUnderstandingProviders'),\n    speechProviders: pick('speechProviders'),\n    imageGenerationProviders: pick('imageGenerationProviders'),\n    webSearchProviders: pick('webSearchProviders'),\n    memoryProviders: pick('memoryProviders'),\n  };\n  if (\n    !c.mediaUnderstandingProviders?.length &&\n    !c.speechProviders?.length &&\n    !c.imageGenerationProviders?.length &&\n    !c.webSearchProviders?.length &&\n    !c.memoryProviders?.length\n  ) {\n    return undefined;\n  }\n  return c;\n}\n\nfunction normalizeSetup(raw: unknown): SetupDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const requiresRuntime = typeof raw.requiresRuntime === 'boolean' ? raw.requiresRuntime : undefined;\n  let providers: SetupDeclaration['providers'];\n  if (Array.isArray(raw.providers)) {\n    providers = [];\n    for (const p of raw.providers) {\n      if (!isRecord(p) || typeof p.id !== 'string') continue;\n      providers.push({\n        id: p.id,\n        authMethods: Array.isArray(p.authMethods)\n          ? p.authMethods.filter((x): x is string => typeof x === 'string')\n          : undefined,\n        envVars: Array.isArray(p.envVars)\n          ? p.envVars.filter((x): x is string => typeof x === 'string')\n          : undefined,\n      });\n    }\n    if (providers.length === 0) providers = undefined;\n  }\n  if (!providers && requiresRuntime === undefined) return undefined;\n  return { providers, requiresRuntime };\n}\n"],"mappings":"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"}
+{"version":3,"file":"normalize-manifest.js","names":[],"sources":["../../../src/extensions/normalize-manifest.ts"],"sourcesContent":["import type {\n  ActivationDeclaration,\n  ChatWidgetContribution,\n  ChatWidgetMatch,\n  CommandContribution,\n  ContractDeclaration,\n  EnginesDeclaration,\n  ExtensionManifest,\n  ExtensionManifestCommand,\n  ExtensionUiContributions,\n  ExtensionUiManifest,\n  ExtensionUiPermission,\n  ModelSupportDeclaration,\n  PageContribution,\n  ProviderAuthChoice,\n  SettingsPanelContribution,\n  SetupDeclaration,\n  SidebarPanelContribution,\n  StatusBarItemContribution,\n} from './types/manifest.js';\nimport type { ExtensionKind } from './types/core.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction normalizeReload(raw: unknown): ExtensionManifest['reload'] {\n  if (!isRecord(raw)) return undefined;\n  const configPrefixes = Array.isArray(raw.configPrefixes)\n    ? raw.configPrefixes.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const supportsHotReload =\n    typeof raw.supportsHotReload === 'boolean' ? raw.supportsHotReload : undefined;\n  if (!configPrefixes?.length && supportsHotReload === undefined) return undefined;\n  return {\n    ...(configPrefixes?.length ? { configPrefixes } : {}),\n    ...(supportsHotReload !== undefined ? { supportsHotReload } : {}),\n  };\n}\n\nfunction normalizeEngines(raw: unknown): EnginesDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const xopc = typeof raw.xopc === 'string' && raw.xopc.length > 0 ? raw.xopc : undefined;\n  if (!xopc) return undefined;\n  return { xopc };\n}\n\nfunction normalizeManifestCommands(raw: unknown): ExtensionManifestCommand[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ExtensionManifestCommand[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const name = typeof item.name === 'string' ? item.name.trim() : '';\n    const description = typeof item.description === 'string' ? item.description : '';\n    if (!name || !description) continue;\n    const aliases = Array.isArray(item.aliases)\n      ? item.aliases.filter((x): x is string => typeof x === 'string')\n      : undefined;\n    const scope = Array.isArray(item.scope)\n      ? item.scope.filter(\n          (x): x is 'global' | 'private' | 'group' =>\n            x === 'global' || x === 'private' || x === 'group',\n        )\n      : undefined;\n    const examples = Array.isArray(item.examples)\n      ? item.examples.filter((x): x is string => typeof x === 'string')\n      : undefined;\n    out.push({\n      name,\n      description,\n      ...(aliases?.length ? { aliases } : {}),\n      ...(scope?.length ? { scope } : {}),\n      ...(examples?.length ? { examples } : {}),\n    });\n  }\n  return out.length > 0 ? out : undefined;\n}\n\n/**\n * Normalize raw JSON manifest into ExtensionManifest with stable optional fields.\n */\nexport function normalizeExtensionManifest(raw: Record<string, unknown>): ExtensionManifest {\n  const id = String(raw.id ?? '');\n  return {\n    id,\n    name: typeof raw.name === 'string' && raw.name.length > 0 ? raw.name : id,\n    description: typeof raw.description === 'string' ? raw.description : undefined,\n    version: typeof raw.version === 'string' ? raw.version : undefined,\n    kind: raw.kind as ExtensionKind | undefined,\n    main: typeof raw.main === 'string' ? raw.main : undefined,\n    configSchema: isRecord(raw.configSchema) ? (raw.configSchema as Record<string, unknown>) : undefined,\n    dependencies: isRecord(raw.dependencies) ? (raw.dependencies as Record<string, string>) : undefined,\n\n    enabledByDefault: typeof raw.enabledByDefault === 'boolean' ? raw.enabledByDefault : undefined,\n    legacyExtensionIds: Array.isArray(raw.legacyExtensionIds)\n      ? raw.legacyExtensionIds.filter((x): x is string => typeof x === 'string')\n      : undefined,\n\n    providers: Array.isArray(raw.providers)\n      ? raw.providers.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    providerAuthEnvVars: normalizeStringArrayMap(raw.providerAuthEnvVars),\n    providerAuthChoices: normalizeProviderAuthChoices(raw.providerAuthChoices),\n    modelSupport: normalizeModelSupport(raw.modelSupport),\n    autoEnableWhenConfiguredProviders: Array.isArray(raw.autoEnableWhenConfiguredProviders)\n      ? raw.autoEnableWhenConfiguredProviders.filter((x): x is string => typeof x === 'string')\n      : undefined,\n\n    channels: Array.isArray(raw.channels)\n      ? raw.channels.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    channelEnvVars: normalizeStringArrayMap(raw.channelEnvVars),\n\n    activation: normalizeActivation(raw.activation),\n    contracts: normalizeContracts(raw.contracts),\n    setup: normalizeSetup(raw.setup),\n    reload: normalizeReload(raw.reload),\n    engines: normalizeEngines(raw.engines),\n    commands: normalizeManifestCommands(raw.commands),\n    ui: normalizeUiManifest(raw.ui),\n  };\n}\n\nconst VALID_UI_PERMISSIONS = new Set<ExtensionUiPermission>([\n  'agent.send',\n  'agent.subscribe',\n  'session.read',\n  'session.write',\n  'config.read',\n  'config.write',\n  'storage',\n  'notification',\n  'clipboard',\n  'theme',\n  'workspace.read',\n  'workspace.write',\n]);\n\nexport function normalizeUiManifest(raw: unknown): ExtensionUiManifest | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (!isRecord(raw)) return undefined;\n  const main = typeof raw.main === 'string' && raw.main.length > 0 ? raw.main : undefined;\n  const icon = typeof raw.icon === 'string' && raw.icon.length > 0 ? raw.icon : undefined;\n  let permissions: ExtensionUiPermission[] | undefined;\n  if (Array.isArray(raw.permissions)) {\n    const p = raw.permissions.filter(\n      (x): x is ExtensionUiPermission =>\n        typeof x === 'string' && VALID_UI_PERMISSIONS.has(x as ExtensionUiPermission),\n    );\n    permissions = p.length ? p : undefined;\n  }\n  const contributions = normalizeUiContributions(raw.contributions);\n  if (!main && !icon && !permissions && !contributions) return undefined;\n  return {\n    ...(main !== undefined ? { main } : {}),\n    ...(icon !== undefined ? { icon } : {}),\n    ...(permissions !== undefined ? { permissions } : {}),\n    ...(contributions !== undefined ? { contributions } : {}),\n  };\n}\n\nfunction normalizeUiContributions(raw: unknown): ExtensionUiContributions | undefined {\n  if (!isRecord(raw)) return undefined;\n  const sidebarPanels = normalizeSidebarPanels(raw.sidebarPanels);\n  const settingsPanels = normalizeSettingsPanels(raw.settingsPanels);\n  const chatWidgets = normalizeChatWidgets(raw.chatWidgets);\n  const pages = normalizePages(raw.pages);\n  const commands = normalizeCommands(raw.commands);\n  const statusBarItems = normalizeStatusBarItems(raw.statusBarItems);\n  const out: ExtensionUiContributions = {\n    ...(sidebarPanels ? { sidebarPanels } : {}),\n    ...(settingsPanels ? { settingsPanels } : {}),\n    ...(chatWidgets ? { chatWidgets } : {}),\n    ...(pages ? { pages } : {}),\n    ...(commands ? { commands } : {}),\n    ...(statusBarItems ? { statusBarItems } : {}),\n  };\n  return Object.keys(out).length ? out : undefined;\n}\n\nfunction normalizeSidebarPanels(raw: unknown): SidebarPanelContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: SidebarPanelContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      entrypoint,\n      icon: typeof item.icon === 'string' ? item.icon : undefined,\n      defaultVisible: typeof item.defaultVisible === 'boolean' ? item.defaultVisible : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeSettingsPanels(raw: unknown): SettingsPanelContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: SettingsPanelContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      entrypoint,\n      order: typeof item.order === 'number' ? item.order : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeChatWidgetMatch(raw: unknown): ChatWidgetMatch | undefined {\n  if (!isRecord(raw)) return undefined;\n  const toolName = typeof raw.toolName === 'string' ? raw.toolName : undefined;\n  const contentType = typeof raw.contentType === 'string' ? raw.contentType : undefined;\n  let metadata: Record<string, unknown> | undefined;\n  if (isRecord(raw.metadata)) {\n    metadata = { ...raw.metadata };\n  }\n  if (!toolName && !contentType && !metadata) return undefined;\n  return { toolName, contentType, metadata };\n}\n\nfunction normalizeChatWidgets(raw: unknown): ChatWidgetContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ChatWidgetContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof title !== 'string' || typeof entrypoint !== 'string') {\n      continue;\n    }\n    const match = normalizeChatWidgetMatch(item.match);\n    if (!match) continue;\n    out.push({\n      id,\n      title,\n      entrypoint,\n      match,\n      maxHeight: typeof item.maxHeight === 'number' ? item.maxHeight : undefined,\n      interactive: typeof item.interactive === 'boolean' ? item.interactive : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizePages(raw: unknown): PageContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: PageContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    const path = item.path;\n    const entrypoint = item.entrypoint;\n    if (\n      typeof id !== 'string' ||\n      typeof title !== 'string' ||\n      typeof path !== 'string' ||\n      typeof entrypoint !== 'string'\n    ) {\n      continue;\n    }\n    out.push({\n      id,\n      title,\n      path,\n      entrypoint,\n      showInNav: typeof item.showInNav === 'boolean' ? item.showInNav : undefined,\n      navIcon: typeof item.navIcon === 'string' ? item.navIcon : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeCommands(raw: unknown): CommandContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: CommandContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const title = item.title;\n    if (typeof id !== 'string' || typeof title !== 'string') continue;\n    out.push({\n      id,\n      title,\n      shortcut: typeof item.shortcut === 'string' ? item.shortcut : undefined,\n      opensPanel: typeof item.opensPanel === 'string' ? item.opensPanel : undefined,\n      chatAlias:\n        typeof item.chatAlias === 'string' && item.chatAlias.length > 0 ? item.chatAlias : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeStatusBarItems(raw: unknown): StatusBarItemContribution[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: StatusBarItemContribution[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const id = item.id;\n    const entrypoint = item.entrypoint;\n    if (typeof id !== 'string' || typeof entrypoint !== 'string') continue;\n    const position = item.position;\n    out.push({\n      id,\n      entrypoint,\n      position: position === 'left' || position === 'right' ? position : undefined,\n      width: typeof item.width === 'number' ? item.width : undefined,\n      when: typeof item.when === 'string' && item.when.length > 0 ? item.when : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeStringArrayMap(\n  raw: unknown,\n): Record<string, string[]> | undefined {\n  if (!isRecord(raw)) return undefined;\n  const out: Record<string, string[]> = {};\n  for (const [k, v] of Object.entries(raw)) {\n    if (Array.isArray(v)) {\n      const arr = v.filter((x): x is string => typeof x === 'string');\n      if (arr.length) out[k] = arr;\n    }\n  }\n  return Object.keys(out).length ? out : undefined;\n}\n\nfunction normalizeProviderAuthChoices(raw: unknown): ProviderAuthChoice[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const out: ProviderAuthChoice[] = [];\n  for (const item of raw) {\n    if (!isRecord(item)) continue;\n    const provider = item.provider;\n    const method = item.method;\n    const choiceId = item.choiceId;\n    const choiceLabel = item.choiceLabel;\n    if (\n      typeof provider !== 'string' ||\n      typeof choiceId !== 'string' ||\n      typeof choiceLabel !== 'string' ||\n      (method !== 'api-key' && method !== 'oauth' && method !== 'cli' && method !== 'env')\n    ) {\n      continue;\n    }\n    out.push({\n      provider,\n      method,\n      choiceId,\n      choiceLabel,\n      choiceHint: typeof item.choiceHint === 'string' ? item.choiceHint : undefined,\n      groupId: typeof item.groupId === 'string' ? item.groupId : undefined,\n      groupLabel: typeof item.groupLabel === 'string' ? item.groupLabel : undefined,\n      groupHint: typeof item.groupHint === 'string' ? item.groupHint : undefined,\n      cliFlag: typeof item.cliFlag === 'string' ? item.cliFlag : undefined,\n      cliOption: typeof item.cliOption === 'string' ? item.cliOption : undefined,\n      cliDescription: typeof item.cliDescription === 'string' ? item.cliDescription : undefined,\n    });\n  }\n  return out.length ? out : undefined;\n}\n\nfunction normalizeModelSupport(raw: unknown): ModelSupportDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const modelPrefixes = Array.isArray(raw.modelPrefixes)\n    ? raw.modelPrefixes.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const modelPatterns = Array.isArray(raw.modelPatterns)\n    ? raw.modelPatterns.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  if (!modelPrefixes?.length && !modelPatterns?.length) return undefined;\n  return { modelPrefixes, modelPatterns };\n}\n\nfunction normalizeActivation(raw: unknown): ActivationDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const onProviders = Array.isArray(raw.onProviders)\n    ? raw.onProviders.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const onCommands = Array.isArray(raw.onCommands)\n    ? raw.onCommands.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const onChannels = Array.isArray(raw.onChannels)\n    ? raw.onChannels.filter((x): x is string => typeof x === 'string')\n    : undefined;\n  const capRaw = raw.onCapabilities;\n  const onCapabilities = Array.isArray(capRaw)\n    ? capRaw.filter(\n        (x): x is 'provider' | 'channel' | 'tool' | 'hook' =>\n          x === 'provider' || x === 'channel' || x === 'tool' || x === 'hook',\n      )\n    : undefined;\n  if (!onProviders?.length && !onCommands?.length && !onChannels?.length && !onCapabilities?.length) {\n    return undefined;\n  }\n  return { onProviders, onCommands, onChannels, onCapabilities };\n}\n\nfunction normalizeContracts(raw: unknown): ContractDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const pick = (k: string) =>\n    Array.isArray(raw[k]) ? raw[k].filter((x: unknown): x is string => typeof x === 'string') : undefined;\n  const c: ContractDeclaration = {\n    mediaUnderstandingProviders: pick('mediaUnderstandingProviders'),\n    speechProviders: pick('speechProviders'),\n    imageGenerationProviders: pick('imageGenerationProviders'),\n    webSearchProviders: pick('webSearchProviders'),\n    memoryProviders: pick('memoryProviders'),\n  };\n  if (\n    !c.mediaUnderstandingProviders?.length &&\n    !c.speechProviders?.length &&\n    !c.imageGenerationProviders?.length &&\n    !c.webSearchProviders?.length &&\n    !c.memoryProviders?.length\n  ) {\n    return undefined;\n  }\n  return c;\n}\n\nfunction normalizeSetup(raw: unknown): SetupDeclaration | undefined {\n  if (!isRecord(raw)) return undefined;\n  const requiresRuntime = typeof raw.requiresRuntime === 'boolean' ? raw.requiresRuntime : undefined;\n  let providers: SetupDeclaration['providers'];\n  if (Array.isArray(raw.providers)) {\n    providers = [];\n    for (const p of raw.providers) {\n      if (!isRecord(p) || typeof p.id !== 'string') continue;\n      providers.push({\n        id: p.id,\n        authMethods: Array.isArray(p.authMethods)\n          ? p.authMethods.filter((x): x is string => typeof x === 'string')\n          : undefined,\n        envVars: Array.isArray(p.envVars)\n          ? p.envVars.filter((x): x is string => typeof x === 'string')\n          : undefined,\n      });\n    }\n    if (providers.length === 0) providers = undefined;\n  }\n  if (!providers && requiresRuntime === undefined) return undefined;\n  return { providers, requiresRuntime };\n}\n"],"mappings":";AAsBA,SAAS,SAAS,GAA0C;AAC1D,QAAO,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,EAAE;;AAGjE,SAAS,gBAAgB,KAA2C;AAClE,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,iBAAiB,MAAM,QAAQ,IAAI,eAAe,GACpD,IAAI,eAAe,QAAQ,MAAmB,OAAO,MAAM,SAAS,GACpE,KAAA;CACJ,MAAM,oBACJ,OAAO,IAAI,sBAAsB,YAAY,IAAI,oBAAoB,KAAA;AACvE,KAAI,CAAC,gBAAgB,UAAU,sBAAsB,KAAA,EAAW,QAAO,KAAA;AACvE,QAAO;EACL,GAAI,gBAAgB,SAAS,EAAE,gBAAgB,GAAG,EAAE;EACpD,GAAI,sBAAsB,KAAA,IAAY,EAAE,mBAAmB,GAAG,EAAE;EACjE;;AAGH,SAAS,iBAAiB,KAA8C;AACtE,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,OAAO,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,SAAS,IAAI,IAAI,OAAO,KAAA;AAC9E,KAAI,CAAC,KAAM,QAAO,KAAA;AAClB,QAAO,EAAE,MAAM;;AAGjB,SAAS,0BAA0B,KAAsD;AACvF,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAAkC,EAAE;AAC1C,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,OAAO,OAAO,KAAK,SAAS,WAAW,KAAK,KAAK,MAAM,GAAG;EAChE,MAAM,cAAc,OAAO,KAAK,gBAAgB,WAAW,KAAK,cAAc;AAC9E,MAAI,CAAC,QAAQ,CAAC,YAAa;EAC3B,MAAM,UAAU,MAAM,QAAQ,KAAK,QAAQ,GACvC,KAAK,QAAQ,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAC9D,KAAA;EACJ,MAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM,GACnC,KAAK,MAAM,QACR,MACC,MAAM,YAAY,MAAM,aAAa,MAAM,QAC9C,GACD,KAAA;EACJ,MAAM,WAAW,MAAM,QAAQ,KAAK,SAAS,GACzC,KAAK,SAAS,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAC/D,KAAA;AACJ,MAAI,KAAK;GACP;GACA;GACA,GAAI,SAAS,SAAS,EAAE,SAAS,GAAG,EAAE;GACtC,GAAI,OAAO,SAAS,EAAE,OAAO,GAAG,EAAE;GAClC,GAAI,UAAU,SAAS,EAAE,UAAU,GAAG,EAAE;GACzC,CAAC;;AAEJ,QAAO,IAAI,SAAS,IAAI,MAAM,KAAA;;;;;AAMhC,SAAgB,2BAA2B,KAAiD;CAC1F,MAAM,KAAK,OAAO,IAAI,MAAM,GAAG;AAC/B,QAAO;EACL;EACA,MAAM,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,SAAS,IAAI,IAAI,OAAO;EACvE,aAAa,OAAO,IAAI,gBAAgB,WAAW,IAAI,cAAc,KAAA;EACrE,SAAS,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU,KAAA;EACzD,MAAM,IAAI;EACV,MAAM,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO,KAAA;EAChD,cAAc,SAAS,IAAI,aAAa,GAAI,IAAI,eAA2C,KAAA;EAC3F,cAAc,SAAS,IAAI,aAAa,GAAI,IAAI,eAA0C,KAAA;EAE1F,kBAAkB,OAAO,IAAI,qBAAqB,YAAY,IAAI,mBAAmB,KAAA;EACrF,oBAAoB,MAAM,QAAQ,IAAI,mBAAmB,GACrD,IAAI,mBAAmB,QAAQ,MAAmB,OAAO,MAAM,SAAS,GACxE,KAAA;EAEJ,WAAW,MAAM,QAAQ,IAAI,UAAU,GACnC,IAAI,UAAU,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAC/D,KAAA;EACJ,qBAAqB,wBAAwB,IAAI,oBAAoB;EACrE,qBAAqB,6BAA6B,IAAI,oBAAoB;EAC1E,cAAc,sBAAsB,IAAI,aAAa;EACrD,mCAAmC,MAAM,QAAQ,IAAI,kCAAkC,GACnF,IAAI,kCAAkC,QAAQ,MAAmB,OAAO,MAAM,SAAS,GACvF,KAAA;EAEJ,UAAU,MAAM,QAAQ,IAAI,SAAS,GACjC,IAAI,SAAS,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAC9D,KAAA;EACJ,gBAAgB,wBAAwB,IAAI,eAAe;EAE3D,YAAY,oBAAoB,IAAI,WAAW;EAC/C,WAAW,mBAAmB,IAAI,UAAU;EAC5C,OAAO,eAAe,IAAI,MAAM;EAChC,QAAQ,gBAAgB,IAAI,OAAO;EACnC,SAAS,iBAAiB,IAAI,QAAQ;EACtC,UAAU,0BAA0B,IAAI,SAAS;EACjD,IAAI,oBAAoB,IAAI,GAAG;EAChC;;AAGH,MAAM,uBAAuB,IAAI,IAA2B;CAC1D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,oBAAoB,KAA+C;AACjF,KAAI,QAAQ,KAAA,KAAa,QAAQ,KAAM,QAAO,KAAA;AAC9C,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,OAAO,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,SAAS,IAAI,IAAI,OAAO,KAAA;CAC9E,MAAM,OAAO,OAAO,IAAI,SAAS,YAAY,IAAI,KAAK,SAAS,IAAI,IAAI,OAAO,KAAA;CAC9E,IAAI;AACJ,KAAI,MAAM,QAAQ,IAAI,YAAY,EAAE;EAClC,MAAM,IAAI,IAAI,YAAY,QACvB,MACC,OAAO,MAAM,YAAY,qBAAqB,IAAI,EAA2B,CAChF;AACD,gBAAc,EAAE,SAAS,IAAI,KAAA;;CAE/B,MAAM,gBAAgB,yBAAyB,IAAI,cAAc;AACjE,KAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,cAAe,QAAO,KAAA;AAC7D,QAAO;EACL,GAAI,SAAS,KAAA,IAAY,EAAE,MAAM,GAAG,EAAE;EACtC,GAAI,SAAS,KAAA,IAAY,EAAE,MAAM,GAAG,EAAE;EACtC,GAAI,gBAAgB,KAAA,IAAY,EAAE,aAAa,GAAG,EAAE;EACpD,GAAI,kBAAkB,KAAA,IAAY,EAAE,eAAe,GAAG,EAAE;EACzD;;AAGH,SAAS,yBAAyB,KAAoD;AACpF,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,gBAAgB,uBAAuB,IAAI,cAAc;CAC/D,MAAM,iBAAiB,wBAAwB,IAAI,eAAe;CAClE,MAAM,cAAc,qBAAqB,IAAI,YAAY;CACzD,MAAM,QAAQ,eAAe,IAAI,MAAM;CACvC,MAAM,WAAW,kBAAkB,IAAI,SAAS;CAChD,MAAM,iBAAiB,wBAAwB,IAAI,eAAe;CAClE,MAAM,MAAgC;EACpC,GAAI,gBAAgB,EAAE,eAAe,GAAG,EAAE;EAC1C,GAAI,iBAAiB,EAAE,gBAAgB,GAAG,EAAE;EAC5C,GAAI,cAAc,EAAE,aAAa,GAAG,EAAE;EACtC,GAAI,QAAQ,EAAE,OAAO,GAAG,EAAE;EAC1B,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,GAAI,iBAAiB,EAAE,gBAAgB,GAAG,EAAE;EAC7C;AACD,QAAO,OAAO,KAAK,IAAI,CAAC,SAAS,MAAM,KAAA;;AAGzC,SAAS,uBAAuB,KAAsD;AACpF,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAAkC,EAAE;AAC1C,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,KAAK,KAAK;EAChB,MAAM,QAAQ,KAAK;EACnB,MAAM,aAAa,KAAK;AACxB,MAAI,OAAO,OAAO,YAAY,OAAO,UAAU,YAAY,OAAO,eAAe,SAC/E;AAEF,MAAI,KAAK;GACP;GACA;GACA;GACA,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO,KAAA;GAClD,gBAAgB,OAAO,KAAK,mBAAmB,YAAY,KAAK,iBAAiB,KAAA;GACjF,MAAM,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAAI,KAAK,OAAO,KAAA;GAC3E,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,wBAAwB,KAAuD;AACtF,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAAmC,EAAE;AAC3C,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,KAAK,KAAK;EAChB,MAAM,QAAQ,KAAK;EACnB,MAAM,aAAa,KAAK;AACxB,MAAI,OAAO,OAAO,YAAY,OAAO,UAAU,YAAY,OAAO,eAAe,SAC/E;AAEF,MAAI,KAAK;GACP;GACA;GACA;GACA,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,KAAA;GACtD,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,yBAAyB,KAA2C;AAC3E,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,WAAW,OAAO,IAAI,aAAa,WAAW,IAAI,WAAW,KAAA;CACnE,MAAM,cAAc,OAAO,IAAI,gBAAgB,WAAW,IAAI,cAAc,KAAA;CAC5E,IAAI;AACJ,KAAI,SAAS,IAAI,SAAS,CACxB,YAAW,EAAE,GAAG,IAAI,UAAU;AAEhC,KAAI,CAAC,YAAY,CAAC,eAAe,CAAC,SAAU,QAAO,KAAA;AACnD,QAAO;EAAE;EAAU;EAAa;EAAU;;AAG5C,SAAS,qBAAqB,KAAoD;AAChF,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAAgC,EAAE;AACxC,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,KAAK,KAAK;EAChB,MAAM,QAAQ,KAAK;EACnB,MAAM,aAAa,KAAK;AACxB,MAAI,OAAO,OAAO,YAAY,OAAO,UAAU,YAAY,OAAO,eAAe,SAC/E;EAEF,MAAM,QAAQ,yBAAyB,KAAK,MAAM;AAClD,MAAI,CAAC,MAAO;AACZ,MAAI,KAAK;GACP;GACA;GACA;GACA;GACA,WAAW,OAAO,KAAK,cAAc,WAAW,KAAK,YAAY,KAAA;GACjE,aAAa,OAAO,KAAK,gBAAgB,YAAY,KAAK,cAAc,KAAA;GACzE,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,eAAe,KAA8C;AACpE,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAA0B,EAAE;AAClC,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,KAAK,KAAK;EAChB,MAAM,QAAQ,KAAK;EACnB,MAAM,OAAO,KAAK;EAClB,MAAM,aAAa,KAAK;AACxB,MACE,OAAO,OAAO,YACd,OAAO,UAAU,YACjB,OAAO,SAAS,YAChB,OAAO,eAAe,SAEtB;AAEF,MAAI,KAAK;GACP;GACA;GACA;GACA;GACA,WAAW,OAAO,KAAK,cAAc,YAAY,KAAK,YAAY,KAAA;GAClE,SAAS,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,KAAA;GAC3D,MAAM,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAAI,KAAK,OAAO,KAAA;GAC3E,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,kBAAkB,KAAiD;AAC1E,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,KAAK,KAAK;EAChB,MAAM,QAAQ,KAAK;AACnB,MAAI,OAAO,OAAO,YAAY,OAAO,UAAU,SAAU;AACzD,MAAI,KAAK;GACP;GACA;GACA,UAAU,OAAO,KAAK,aAAa,WAAW,KAAK,WAAW,KAAA;GAC9D,YAAY,OAAO,KAAK,eAAe,WAAW,KAAK,aAAa,KAAA;GACpE,WACE,OAAO,KAAK,cAAc,YAAY,KAAK,UAAU,SAAS,IAAI,KAAK,YAAY,KAAA;GACrF,MAAM,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAAI,KAAK,OAAO,KAAA;GAC3E,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,wBAAwB,KAAuD;AACtF,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAAmC,EAAE;AAC3C,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,KAAK,KAAK;EAChB,MAAM,aAAa,KAAK;AACxB,MAAI,OAAO,OAAO,YAAY,OAAO,eAAe,SAAU;EAC9D,MAAM,WAAW,KAAK;AACtB,MAAI,KAAK;GACP;GACA;GACA,UAAU,aAAa,UAAU,aAAa,UAAU,WAAW,KAAA;GACnE,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,KAAA;GACrD,MAAM,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAAI,KAAK,OAAO,KAAA;GAC3E,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,wBACP,KACsC;AACtC,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,MAAgC,EAAE;AACxC,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,CACtC,KAAI,MAAM,QAAQ,EAAE,EAAE;EACpB,MAAM,MAAM,EAAE,QAAQ,MAAmB,OAAO,MAAM,SAAS;AAC/D,MAAI,IAAI,OAAQ,KAAI,KAAK;;AAG7B,QAAO,OAAO,KAAK,IAAI,CAAC,SAAS,MAAM,KAAA;;AAGzC,SAAS,6BAA6B,KAAgD;AACpF,KAAI,CAAC,MAAM,QAAQ,IAAI,CAAE,QAAO,KAAA;CAChC,MAAM,MAA4B,EAAE;AACpC,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,CAAC,SAAS,KAAK,CAAE;EACrB,MAAM,WAAW,KAAK;EACtB,MAAM,SAAS,KAAK;EACpB,MAAM,WAAW,KAAK;EACtB,MAAM,cAAc,KAAK;AACzB,MACE,OAAO,aAAa,YACpB,OAAO,aAAa,YACpB,OAAO,gBAAgB,YACtB,WAAW,aAAa,WAAW,WAAW,WAAW,SAAS,WAAW,MAE9E;AAEF,MAAI,KAAK;GACP;GACA;GACA;GACA;GACA,YAAY,OAAO,KAAK,eAAe,WAAW,KAAK,aAAa,KAAA;GACpE,SAAS,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,KAAA;GAC3D,YAAY,OAAO,KAAK,eAAe,WAAW,KAAK,aAAa,KAAA;GACpE,WAAW,OAAO,KAAK,cAAc,WAAW,KAAK,YAAY,KAAA;GACjE,SAAS,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,KAAA;GAC3D,WAAW,OAAO,KAAK,cAAc,WAAW,KAAK,YAAY,KAAA;GACjE,gBAAgB,OAAO,KAAK,mBAAmB,WAAW,KAAK,iBAAiB,KAAA;GACjF,CAAC;;AAEJ,QAAO,IAAI,SAAS,MAAM,KAAA;;AAG5B,SAAS,sBAAsB,KAAmD;AAChF,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,gBAAgB,MAAM,QAAQ,IAAI,cAAc,GAClD,IAAI,cAAc,QAAQ,MAAmB,OAAO,MAAM,SAAS,GACnE,KAAA;CACJ,MAAM,gBAAgB,MAAM,QAAQ,IAAI,cAAc,GAClD,IAAI,cAAc,QAAQ,MAAmB,OAAO,MAAM,SAAS,GACnE,KAAA;AACJ,KAAI,CAAC,eAAe,UAAU,CAAC,eAAe,OAAQ,QAAO,KAAA;AAC7D,QAAO;EAAE;EAAe;EAAe;;AAGzC,SAAS,oBAAoB,KAAiD;AAC5E,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,cAAc,MAAM,QAAQ,IAAI,YAAY,GAC9C,IAAI,YAAY,QAAQ,MAAmB,OAAO,MAAM,SAAS,GACjE,KAAA;CACJ,MAAM,aAAa,MAAM,QAAQ,IAAI,WAAW,GAC5C,IAAI,WAAW,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAChE,KAAA;CACJ,MAAM,aAAa,MAAM,QAAQ,IAAI,WAAW,GAC5C,IAAI,WAAW,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAChE,KAAA;CACJ,MAAM,SAAS,IAAI;CACnB,MAAM,iBAAiB,MAAM,QAAQ,OAAO,GACxC,OAAO,QACJ,MACC,MAAM,cAAc,MAAM,aAAa,MAAM,UAAU,MAAM,OAChE,GACD,KAAA;AACJ,KAAI,CAAC,aAAa,UAAU,CAAC,YAAY,UAAU,CAAC,YAAY,UAAU,CAAC,gBAAgB,OACzF;AAEF,QAAO;EAAE;EAAa;EAAY;EAAY;EAAgB;;AAGhE,SAAS,mBAAmB,KAA+C;AACzE,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,QAAQ,MACZ,MAAM,QAAQ,IAAI,GAAG,GAAG,IAAI,GAAG,QAAQ,MAA4B,OAAO,MAAM,SAAS,GAAG,KAAA;CAC9F,MAAM,IAAyB;EAC7B,6BAA6B,KAAK,8BAA8B;EAChE,iBAAiB,KAAK,kBAAkB;EACxC,0BAA0B,KAAK,2BAA2B;EAC1D,oBAAoB,KAAK,qBAAqB;EAC9C,iBAAiB,KAAK,kBAAkB;EACzC;AACD,KACE,CAAC,EAAE,6BAA6B,UAChC,CAAC,EAAE,iBAAiB,UACpB,CAAC,EAAE,0BAA0B,UAC7B,CAAC,EAAE,oBAAoB,UACvB,CAAC,EAAE,iBAAiB,OAEpB;AAEF,QAAO;;AAGT,SAAS,eAAe,KAA4C;AAClE,KAAI,CAAC,SAAS,IAAI,CAAE,QAAO,KAAA;CAC3B,MAAM,kBAAkB,OAAO,IAAI,oBAAoB,YAAY,IAAI,kBAAkB,KAAA;CACzF,IAAI;AACJ,KAAI,MAAM,QAAQ,IAAI,UAAU,EAAE;AAChC,cAAY,EAAE;AACd,OAAK,MAAM,KAAK,IAAI,WAAW;AAC7B,OAAI,CAAC,SAAS,EAAE,IAAI,OAAO,EAAE,OAAO,SAAU;AAC9C,aAAU,KAAK;IACb,IAAI,EAAE;IACN,aAAa,MAAM,QAAQ,EAAE,YAAY,GACrC,EAAE,YAAY,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAC/D,KAAA;IACJ,SAAS,MAAM,QAAQ,EAAE,QAAQ,GAC7B,EAAE,QAAQ,QAAQ,MAAmB,OAAO,MAAM,SAAS,GAC3D,KAAA;IACL,CAAC;;AAEJ,MAAI,UAAU,WAAW,EAAG,aAAY,KAAA;;AAE1C,KAAI,CAAC,aAAa,oBAAoB,KAAA,EAAW,QAAO,KAAA;AACxD,QAAO;EAAE;EAAW;EAAiB"}

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

@@ -33,3 +33,5 @@ export { checkExtensionPathSafety, checkExtensionDirSafety, isExtensionAllowed,
 export { getExtensionCache, getExtensionDiagnostics, ExtensionLoaderCacheImpl, ExtensionDiagnostics, } from '../diagnostics.js';
 export type { Config } from '../../config/config-surface.js';
 export { lazyModule, lazyFunction } from './lazy.js';
+export { createMockExtensionApi, createTestGateway } from './testing.js';
+export type { MockExtensionApi, MockExtensionApiOptions, TestGateway, } from './testing.js';

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

@@ -9,9 +9,10 @@ import { ExtensionRegistryImpl } from "../loader.js";
 import { ExtensionHookRunner, createHookContext, isHookEvent } from "../hooks.js";
 import { registerExtensionCliProgram } from "./channel-helpers.js";
 import { lazyFunction, lazyModule } from "./lazy.js";
+import { createMockExtensionApi, createTestGateway } from "./testing.js";
 //#region src/extensions/sdk/index.ts
 init_plugin_registry();
 //#endregion
-export { DEFAULT_SECURITY_CONFIG, ExtensionDiagnostics, ExtensionHookRunner, ExtensionLoaderCacheImpl, ExtensionRegistryImpl, HOOK_EXECUTION_MODES, ProviderPluginRegistry, SlotRegistry, TypedEventBus, checkExtensionDirSafety, checkExtensionPathSafety, createHookContext, defineChannelPluginEntry, getExtensionCache, getExtensionDiagnostics, getProviderRegistry, getSlotRegistry, isExtensionAllowed, isHookEvent, lazyFunction, lazyModule, logSecurityIssue, provenanceTracker, registerExtensionCliProgram, registerSlotType };
+export { DEFAULT_SECURITY_CONFIG, ExtensionDiagnostics, ExtensionHookRunner, ExtensionLoaderCacheImpl, ExtensionRegistryImpl, HOOK_EXECUTION_MODES, ProviderPluginRegistry, SlotRegistry, TypedEventBus, checkExtensionDirSafety, checkExtensionPathSafety, createHookContext, createMockExtensionApi, createTestGateway, defineChannelPluginEntry, getExtensionCache, getExtensionDiagnostics, getProviderRegistry, getSlotRegistry, isExtensionAllowed, isHookEvent, lazyFunction, lazyModule, logSecurityIssue, provenanceTracker, registerExtensionCliProgram, registerSlotType };
 
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/extensions/sdk/index.ts"],"sourcesContent":["/**\n * xopc Extension SDK\n * \n * Official SDK for developing xopc extensions.\n * Import types and utilities from this module:\n * \n * @example\n * import type { ExtensionApi, ExtensionDefinition } from 'xopc/extension-sdk';\n */\n\n// ============================================================================\n// Core extension types\n// ============================================================================\n\nexport type {\n  ExtensionDefinition,\n  ExtensionModule,\n  ExtensionKind,\n  ExtensionApi,\n  ExtensionLogger,\n  ExtensionManifest,\n  ExtensionRecord,\n  ExtensionRegistry,\n  ResolvedExtensionConfig,\n  ExtensionRuntime,\n  ExtensionCliRegistration,\n} from '../types/index.js';\n\n// ============================================================================\n// Tools (re-exported from @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"],"mappings":";;;;;;;;;;;;sBAiPiG"}
+{"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"}

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

@@ -1,5 +1,51 @@
 /**
- * Lightweight test doubles — no Vitest dependency.
+ * Extension testing helpers (Phase 2): mock API + minimal HTTP gateway fixture.
  */
-import type { ExtensionApi } from '../types/core.js';
-export declare function createMockExtensionApi(overrides?: Partial<ExtensionApi>): ExtensionApi;
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+import type { ChannelPlugin } from '../../channels/plugin-types.js';
+import type { Config } from '../../config/config-surface.js';
+import type { ExtensionApi, ExtensionCommand, ExtensionCommandContext, ExtensionLogger, ExtensionReloadHandler, ExtensionService, GatewayMethodHandler, HttpRequestHandler } from '../types/core.js';
+import type { ExtensionHookEvent } from '../types/hooks.js';
+import type { CommandContribution } from '../types/manifest.js';
+export interface MockExtensionApiOptions {
+    id?: string;
+    name?: string;
+    version?: string;
+    source?: string;
+    extensionConfig?: Record<string, unknown>;
+    config?: Partial<Config>;
+    logger?: ExtensionLogger;
+    /** Pretend manifest `ui.contributions.commands` for `onCommand` tests. */
+    manifestCommands?: CommandContribution[];
+}
+export interface MockExtensionApi extends ExtensionApi {
+    getRegisteredTools(): AgentTool[];
+    getRegisteredHooks(): Array<{
+        event: ExtensionHookEvent;
+        handler: unknown;
+    }>;
+    getRegisteredCommands(): ExtensionCommand[];
+    getRegisteredHttpRoutes(): Array<{
+        path: string;
+        handler: HttpRequestHandler;
+    }>;
+    getRegisteredServices(): ExtensionService[];
+    getRegisteredGatewayMethods(): Array<{
+        method: string;
+        handler: GatewayMethodHandler;
+    }>;
+    getRegisteredChannelPlugins(): ChannelPlugin[];
+    getRegisteredReloadHandlers(): ExtensionReloadHandler[];
+    getEmittedEvents(): Array<{
+        event: string;
+        data: unknown;
+    }>;
+}
+export declare function createMockExtensionApi(options?: MockExtensionApiOptions): MockExtensionApi;
+export interface TestGateway {
+    baseUrl: string;
+    fetch: (path: string, init?: RequestInit) => Promise<Response>;
+    close: () => Promise<void>;
+}
+export declare function createTestGateway(): Promise<TestGateway>;
+export type { ExtensionCommandContext };

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

@@ -1,12 +1,181 @@
+import { TypedEventBus } from "../typed-event-bus.js";
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { EventEmitter, once } from "node:events";
 //#region src/extensions/sdk/testing.ts
-function createMockExtensionApi(overrides) {
+const noopLogger = {
+	debug: () => {},
+	info: () => {},
+	warn: () => {},
+	error: () => {}
+};
+function createMockExtensionApi(options = {}) {
+	return new MockExtensionApiImpl(options);
+}
+var MockExtensionApiImpl = class {
+	id;
+	name;
+	version;
+	source;
+	config;
+	extensionConfig;
+	logger;
+	runtime;
+	events;
+	_tools = [];
+	_hooks = [];
+	_commands = [];
+	_http = [];
+	_services = [];
+	_gw = [];
+	_channels = [];
+	_reload = [];
+	_emitted = [];
+	_bus = new EventEmitter();
+	_manifestCommands = /* @__PURE__ */ new Map();
+	constructor(opts) {
+		this.id = opts.id ?? "test-extension";
+		this.name = opts.name ?? "Test Extension";
+		this.version = opts.version;
+		this.source = opts.source ?? "/test";
+		this.extensionConfig = opts.extensionConfig ?? {};
+		this.config = opts.config ?? {};
+		this.logger = opts.logger ?? noopLogger;
+		this.runtime = {
+			config: this.config,
+			log: this.logger
+		};
+		this.events = new TypedEventBus({ logger: this.logger });
+		if (opts.manifestCommands?.length) for (const c of opts.manifestCommands) this._manifestCommands.set(c.id, c);
+	}
+	_setManifestCommands(commands) {
+		this._manifestCommands.clear();
+		for (const c of commands) this._manifestCommands.set(c.id, c);
+	}
+	getRegisteredTools() {
+		return [...this._tools];
+	}
+	getRegisteredHooks() {
+		return [...this._hooks];
+	}
+	getRegisteredCommands() {
+		return [...this._commands];
+	}
+	getRegisteredHttpRoutes() {
+		return [...this._http];
+	}
+	getRegisteredServices() {
+		return [...this._services];
+	}
+	getRegisteredGatewayMethods() {
+		return [...this._gw];
+	}
+	getRegisteredChannelPlugins() {
+		return [...this._channels];
+	}
+	getRegisteredReloadHandlers() {
+		return [...this._reload];
+	}
+	getEmittedEvents() {
+		return [...this._emitted];
+	}
+	registerTool(tool) {
+		this._tools.push(tool);
+	}
+	registerHook(event, handler, _opts) {
+		this._hooks.push({
+			event,
+			handler
+		});
+	}
+	onHook(_hookName, _handler) {}
+	registerChannel(registration) {
+		this._channels.push(registration.plugin);
+	}
+	registerHttpRoute(path, handler) {
+		this._http.push({
+			path,
+			handler
+		});
+	}
+	registerCommand(command) {
+		this._commands.push(command);
+	}
+	onCommand(commandId, handler) {
+		const meta = this._manifestCommands.get(commandId);
+		if (!meta) {
+			const name = commandId.includes(".") ? (commandId.split(".").pop() ?? commandId).trim() : commandId;
+			this.registerCommand({
+				name: name || commandId,
+				description: commandId,
+				handler
+			});
+			return;
+		}
+		let name;
+		if (meta.chatAlias?.trim()) name = meta.chatAlias.trim().replace(/^\//, "");
+		else name = meta.id.includes(".") ? meta.id.split(".").pop() ?? meta.id : meta.id;
+		if (!name) name = meta.id;
+		this.registerCommand({
+			name,
+			description: meta.title,
+			handler
+		});
+	}
+	registerReload(handler) {
+		this._reload.push(handler);
+	}
+	registerService(service) {
+		this._services.push(service);
+	}
+	registerGatewayMethod(method, handler) {
+		this._gw.push({
+			method,
+			handler
+		});
+	}
+	registerCli(_factory, _opts) {}
+	resolvePath(input) {
+		return `${this.source.replace(/\/$/, "")}/${input.replace(/^\//, "")}`;
+	}
+	emit(event, data) {
+		this._emitted.push({
+			event,
+			data
+		});
+		this._bus.emit(event, data);
+	}
+	on(event, handler) {
+		this._bus.on(event, handler);
+	}
+	off(event, handler) {
+		this._bus.off(event, handler);
+	}
+	registerProvider(_plugin) {}
+	registerProviderPlugin(_plugin) {}
+	registerFlag(_name, _config) {}
+	getFlag(_name) {}
+	registerShortcut(_key, _config) {}
+};
+async function createTestGateway() {
+	const app = new Hono();
+	app.get("/health", (c) => c.json({ ok: true }));
+	const server = serve({
+		fetch: app.fetch,
+		port: 0,
+		hostname: "127.0.0.1"
+	});
+	if (!server.listening) await once(server, "listening");
+	const baseUrl = `http://127.0.0.1:${server.address().port}`;
 	return {
-		id: "mock",
-		name: "mock",
-		...overrides
+		baseUrl,
+		fetch: (path, init) => fetch(`${baseUrl}${path.startsWith("/") ? path : `/${path}`}`, init),
+		close: () => new Promise((resolve, reject) => {
+			server.close((err) => err ? reject(err) : resolve());
+		})
 	};
 }
 //#endregion
-export { createMockExtensionApi };
+export { createMockExtensionApi, createTestGateway };
 
 //# sourceMappingURL=testing.js.map

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

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

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

@@ -79,6 +79,11 @@ export interface ExtensionApi {
     }): void;
     registerHttpRoute(path: string, handler: HttpRequestHandler): void;
     registerCommand(command: ExtensionCommand): void;
+    /**
+     * Bind a handler to a manifest-declared command id (`ui.contributions.commands`).
+     * Metadata comes from the manifest; optional `chatAlias` becomes the slash command name.
+     */
+    onCommand(commandId: string, handler: ExtensionCommandHandler): void;
     /**
      * Register a reload handler when config paths matching this extension change during hot reload.
      */

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

@@ -3,6 +3,11 @@
  * New fields are optional for backward compatibility.
  */
 import type { ExtensionKind } from './core.js';
+/** Declared in `engines` in the extension manifest (e.g. VSCode-style). */
+export interface EnginesDeclaration {
+    /** Semver range string for the running xopc CLI / gateway, e.g. `">=0.0.20"`. */
+    xopc?: string;
+}
 export interface ExtensionManifest {
     id: string;
     name: string;
@@ -29,6 +34,11 @@ export interface ExtensionManifest {
         configPrefixes?: string[];
         supportsHotReload?: boolean;
     };
+    /**
+     * Host / runtime requirements (e.g. compatible xopc semver range).
+     * Normalized from `xopc.extension.json` `engines`.
+     */
+    engines?: EnginesDeclaration;
     /** Chat commands metadata (runtime registration still required in `register()`). */
     commands?: ExtensionManifestCommand[];
     /** Frontend UI declaration — enables extensions to render custom UI in the Gateway Console. */
@@ -70,6 +80,8 @@ export interface SidebarPanelContribution {
     icon?: string;
     entrypoint: string;
     defaultVisible?: boolean;
+    /** When-expression for visibility (see Phase 2). */
+    when?: string;
 }
 /** A panel rendered inside the settings page. */
 export interface SettingsPanelContribution {
@@ -102,6 +114,7 @@ export interface PageContribution {
     showInNav?: boolean;
     /** Lucide icon name */
     navIcon?: string;
+    when?: string;
 }
 /** A command registered in the command palette. */
 export interface CommandContribution {
@@ -109,6 +122,9 @@ export interface CommandContribution {
     title: string;
     shortcut?: string;
     opensPanel?: string;
+    /** Optional chat slash name (e.g. `/hello`); bound via `api.onCommand`. */
+    chatAlias?: string;
+    when?: string;
 }
 /** A small widget rendered in the status bar. */
 export interface StatusBarItemContribution {
@@ -116,6 +132,7 @@ export interface StatusBarItemContribution {
     entrypoint: string;
     position?: 'left' | 'right';
     width?: number;
+    when?: string;
 }
 export interface ProviderAuthChoice {
     provider: string;

package/dist/src/extensions/when-context.d.ts

@@ -0,0 +1,6 @@
+import type { Config as SurfaceConfig } from '../config/config-surface.js';
+import type { ExtensionLoader } from './loader.js';
+/**
+ * Flat payload for `GET /api/context` and client-side `when` evaluation.
+ */
+export declare function buildWhenContextSnapshot(config: SurfaceConfig, loader: ExtensionLoader | null): Record<string, unknown>;