@xopcai/xopc 0.0.103 → 0.0.105

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

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../../../../src/extensions/sdk/testing.ts"],"sourcesContent":["/**\n * Extension testing helpers (Phase 2): mock API + minimal HTTP gateway fixture.\n */\n\nimport type { Command } from 'commander';\nimport { EventEmitter } from 'node:events';\nimport { once } from 'node:events';\nimport type { AddressInfo } from 'node:net';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { Hono } from 'hono';\nimport { serve } from '@hono/node-server';\nimport type { ServerType } from '@hono/node-server';\n\nimport type { ChannelPlugin } from '../../channels/plugin-types.js';\nimport type { Config } from '../../config/config-surface.js';\nimport type {\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 type { TuiExtensionRegistrar } from '../types/tui.js';\nimport { TypedEventBus } from '../typed-event-bus.js';\n\nexport interface MockExtensionApiOptions {\n  id?: string;\n  name?: string;\n  version?: string;\n  source?: string;\n  extensionConfig?: Record<string, unknown>;\n  config?: Partial<Config>;\n  logger?: ExtensionLogger;\n  /** Pretend manifest `ui.contributions.commands` for `onCommand` tests. */\n  manifestCommands?: CommandContribution[];\n}\n\nconst noopLogger: ExtensionLogger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n};\n\nexport interface MockExtensionApi extends ExtensionApi {\n  getRegisteredTools(): AgentTool[];\n  getRegisteredHooks(): Array<{ event: ExtensionHookEvent; handler: unknown }>;\n  getRegisteredCommands(): ExtensionCommand[];\n  getRegisteredHttpRoutes(): Array<{ path: string; handler: HttpRequestHandler }>;\n  getRegisteredServices(): ExtensionService[];\n  getRegisteredGatewayMethods(): Array<{ method: string; handler: GatewayMethodHandler }>;\n  getRegisteredChannelPlugins(): ChannelPlugin[];\n  getRegisteredReloadHandlers(): ExtensionReloadHandler[];\n  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  registerSpeechProvider(_plugin: import('../../voice/tts/speech-provider-types.js').SpeechProviderPlugin): void {\n    /* noop */\n  }\n\n  registerMediaUnderstandingProvider(\n    _plugin: import('../../media-understanding/types.js').MediaUnderstandingProvider,\n  ): void {\n    /* noop */\n  }\n\n  registerMarketplaceAdapter(_registration: {\n    adapter: unknown;\n    displayName?: string;\n  }): void {\n    /* noop */\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    /* noop */\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined;\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    /* noop */\n  }\n\n  registerTui(_register: TuiExtensionRegistrar): void {\n    /* noop */\n  }\n}\n\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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"}
+{"version":3,"file":"testing.js","names":[],"sources":["../../../../src/extensions/sdk/testing.ts"],"sourcesContent":["/**\n * Extension testing helpers (Phase 2): mock API + minimal HTTP gateway fixture.\n */\n\nimport type { Command } from 'commander';\nimport { EventEmitter } from 'node:events';\nimport { once } from 'node:events';\nimport type { AddressInfo } from 'node:net';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { Hono } from 'hono';\nimport { serve } from '@hono/node-server';\nimport type { ServerType } from '@hono/node-server';\n\nimport type { ChannelPlugin } from '../../channels/plugin-types.js';\nimport type { Config } from '../../config/config-surface.js';\nimport type {\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 type { TuiExtensionRegistrar } from '../types/tui.js';\nimport { TypedEventBus } from '../typed-event-bus.js';\n\nexport interface MockExtensionApiOptions {\n  id?: string;\n  name?: string;\n  version?: string;\n  source?: string;\n  extensionConfig?: Record<string, unknown>;\n  config?: Partial<Config>;\n  logger?: ExtensionLogger;\n  /** Pretend manifest `ui.contributions.commands` for `onCommand` tests. */\n  manifestCommands?: CommandContribution[];\n}\n\nconst noopLogger: ExtensionLogger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n};\n\nexport interface MockExtensionApi extends ExtensionApi {\n  getRegisteredTools(): AgentTool[];\n  getRegisteredHooks(): Array<{ event: ExtensionHookEvent; handler: unknown }>;\n  getRegisteredCommands(): ExtensionCommand[];\n  getRegisteredHttpRoutes(): Array<{ path: string; handler: HttpRequestHandler }>;\n  getRegisteredServices(): ExtensionService[];\n  getRegisteredGatewayMethods(): Array<{ method: string; handler: GatewayMethodHandler }>;\n  getRegisteredChannelPlugins(): ChannelPlugin[];\n  getRegisteredReloadHandlers(): ExtensionReloadHandler[];\n  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  registerSpeechProvider(_plugin: import('../../voice/tts/speech-provider-types.js').SpeechProviderPlugin): void {\n    /* noop */\n  }\n\n  registerMediaUnderstandingProvider(\n    _plugin: import('../../media-understanding/types.js').MediaUnderstandingProvider,\n  ): void {\n    /* noop */\n  }\n\n  registerMarketplaceAdapter(_registration: {\n    adapter: unknown;\n    displayName?: string;\n  }): void {\n    /* noop */\n  }\n\n  registerFlag(_name: string, _config: FlagConfig): void {\n    /* noop */\n  }\n\n  getFlag(_name: string): FlagValue {\n    return undefined;\n  }\n\n  registerShortcut(_key: string, _config: ShortcutConfig): void {\n    /* noop */\n  }\n\n  registerTui(_register: TuiExtensionRegistrar): void {\n    /* noop */\n  }\n\n  setLabel(_entryId: string, _label: string | undefined): void {\n    /* noop */\n  }\n\n  sendUserMessage(\n    _content: import('../types/core.js').ExtensionUserMessageContent,\n    _options?: import('../types/core.js').ExtensionSendUserMessageOptions,\n  ): void {\n    /* noop */\n  }\n\n  appendEntry<T = unknown>(_customType: string, _data?: T): void {\n    /* noop */\n  }\n\n  sendMessage<T = unknown>(\n    _message: import('../types/core.js').ExtensionCustomMessage<T>,\n    _options?: import('../types/core.js').ExtensionSendMessageOptions,\n  ): void {\n    /* noop */\n  }\n}\n\nexport interface TestGateway {\n  baseUrl: string;\n  fetch: (path: string, init?: RequestInit) => Promise<Response>;\n  close: () => Promise<void>;\n}\n\nexport async function createTestGateway(): Promise<TestGateway> {\n  const app = new Hono();\n  app.get('/health', (c) => c.json({ ok: true }));\n\n  const server: ServerType = serve({\n    fetch: app.fetch,\n    port: 0,\n    hostname: '127.0.0.1',\n  });\n\n  if (!server.listening) {\n    await once(server, 'listening');\n  }\n  const addr = server.address() as AddressInfo;\n  const port = addr.port;\n  const baseUrl = `http://127.0.0.1:${port}`;\n\n  return {\n    baseUrl,\n    fetch: (path, init) =>\n      fetch(`${baseUrl}${path.startsWith('/') ? path : `/${path}`}`, init),\n    close: () =>\n      new Promise((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      }),\n  };\n}\n\nexport type { ExtensionCommandContext };\n"],"mappings":"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"}

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

@@ -4,11 +4,12 @@
  * Core extension definitions and Extension API interface.
  */
 import type { Command } from 'commander';
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { ImageContent, TextContent } from '@earendil-works/pi-ai';
 import type { Config } from '../../config/config-surface.js';
 import type { Config as FullConfig } from '../../config/schema.js';
 import type { MessageBus } from '../../infra/bus/index.js';
 import type { TypedEventBus } from './events.js';
-import type { AgentTool } from '@earendil-works/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';
@@ -54,6 +55,28 @@ export interface ExtensionRuntime {
      * Only injected in the Gateway process.
      */
     scheduleWebchatContinuation?: (sessionKey: string, message: string) => void;
+    /** Set or clear a TUI transcript label, when running inside an interactive TUI host. */
+    setLabel?: (entryId: string, label: string | undefined) => void;
+    /** Send a user-visible message through the active interactive host. */
+    sendUserMessage?: (content: ExtensionUserMessageContent, options?: ExtensionSendUserMessageOptions) => void;
+    /** Append extension state for replay by sessionManager APIs. */
+    appendEntry?: <T = unknown>(customType: string, data?: T) => void;
+    /** Append a visible extension custom message to the active interactive host. */
+    sendMessage?: <T = unknown>(message: ExtensionCustomMessage<T>, options?: ExtensionSendMessageOptions) => void;
+}
+export type ExtensionUserMessageContent = string | (TextContent | ImageContent)[];
+export interface ExtensionSendUserMessageOptions {
+    deliverAs?: 'steer' | 'followUp';
+}
+export interface ExtensionCustomMessage<T = unknown> {
+    customType: string;
+    content?: string | unknown[];
+    display?: boolean;
+    details?: T;
+}
+export interface ExtensionSendMessageOptions {
+    triggerTurn?: boolean;
+    deliverAs?: 'steer' | 'followUp' | 'nextTurn';
 }
 export interface ExtensionCliRegistration {
     extensionId: string;
@@ -137,6 +160,14 @@ export interface ExtensionApi {
      * Callback runs when `xopc tui` starts — not during gateway-only extension load.
      */
     registerTui(register: TuiExtensionRegistrar): void;
+    /** Set or clear a label on a TUI transcript entry. No-op outside an interactive TUI host. */
+    setLabel(entryId: string, label: string | undefined): void;
+    /** Send a user-visible message to the active interactive host. No-op outside an interactive host. */
+    sendUserMessage(content: ExtensionUserMessageContent, options?: ExtensionSendUserMessageOptions): void;
+    /** Append extension state for replay by sessionManager APIs. No-op outside an interactive host. */
+    appendEntry<T = unknown>(customType: string, data?: T): void;
+    /** Append a visible extension custom message. No-op outside an interactive host. */
+    sendMessage<T = unknown>(message: ExtensionCustomMessage<T>, options?: ExtensionSendMessageOptions): void;
 }
 export interface ExtensionLogger {
     debug(msg: string): void;

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

@@ -28,6 +28,7 @@ export interface ExtensionManifest {
     autoEnableWhenConfiguredProviders?: string[];
     channels?: string[];
     channelEnvVars?: Record<string, string[]>;
+    channelContributions?: Record<string, ChannelContributionDeclaration>;
     activation?: ActivationDeclaration;
     contracts?: ContractDeclaration;
     setup?: SetupDeclaration;
@@ -46,6 +47,65 @@ export interface ExtensionManifest {
     /** Frontend UI declaration — enables extensions to render custom UI in the Gateway Console. */
     ui?: ExtensionUiManifest;
 }
+export interface ChannelConfigUiHint {
+    label?: string;
+    help?: string;
+    tags?: string[];
+    advanced?: boolean;
+    sensitive?: boolean;
+    placeholder?: string;
+    itemTemplate?: unknown;
+}
+export interface ChannelContributionCapabilities {
+    login?: boolean;
+    pairing?: boolean;
+    doctor?: boolean;
+    multiAccount?: boolean;
+    streaming?: boolean;
+    media?: boolean;
+    [key: string]: unknown;
+}
+export interface ChannelActionDescriptor {
+    label?: string;
+    description?: string;
+    result?: 'ok' | 'qr' | 'poll' | 'diagnostics' | 'form';
+    schema?: Record<string, unknown>;
+}
+export interface ChannelContributionI18n {
+    label?: string;
+    description?: string;
+    configSchema?: Record<string, unknown>;
+    uiHints?: Record<string, ChannelConfigUiHint>;
+    actions?: Record<string, ChannelActionDescriptor>;
+    ui?: ChannelContributionUiDeclaration;
+}
+export interface ChannelContributionDeclaration {
+    label: string;
+    description?: string;
+    docsPath?: string;
+    order?: number;
+    configPath?: string;
+    capabilities?: ChannelContributionCapabilities;
+    configSchema?: Record<string, unknown>;
+    uiHints?: Record<string, ChannelConfigUiHint>;
+    actions?: Record<string, ChannelActionDescriptor>;
+    ui?: ChannelContributionUiDeclaration;
+    i18n?: Record<string, ChannelContributionI18n>;
+}
+export interface ChannelContributionUiDeclaration {
+    icon?: string;
+    card?: {
+        primaryAction?: string;
+        summaryFields?: string[];
+    };
+    modal?: {
+        entrypoint?: string;
+        minHeight?: number;
+        maxHeight?: number;
+        permissions?: ExtensionUiPermission[];
+        placement?: 'before-config' | 'after-setup' | 'replace-config';
+    };
+}
 export interface ExtensionManifestCommand {
     name: string;
     description: string;

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

@@ -2,7 +2,7 @@
  * TUI extension host contract — minimal surface for `api.registerTui()`.
  * Implementations live under `src/tui/extension-host/` (pi-tui types stay there).
  */
-export type TuiNotifyLevel = 'info' | 'warn' | 'error';
+export type TuiNotifyLevel = 'info' | 'warn' | 'warning' | 'error';
 export interface TuiAutocompleteSuggestion {
     name: string;
     description?: string;
@@ -11,27 +11,436 @@ export type TuiAutocompleteProvider = (query: string, context: {
     cwd: string;
     sessionKey: string;
 }) => TuiAutocompleteSuggestion[] | Promise<TuiAutocompleteSuggestion[]>;
+export interface TuiAutocompleteItem {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface TuiAutocompleteSuggestions {
+    items: TuiAutocompleteItem[];
+    prefix: string;
+}
+export interface TuiAutocompleteProviderApi {
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, options: {
+        signal: AbortSignal;
+        force?: boolean;
+    }): Promise<TuiAutocompleteSuggestions | null>;
+    applyCompletion(lines: string[], cursorLine: number, cursorCol: number, item: TuiAutocompleteItem, prefix: string): {
+        lines: string[];
+        cursorLine: number;
+        cursorCol: number;
+    };
+    shouldTriggerFileCompletion?(lines: string[], cursorLine: number, cursorCol: number): boolean;
+    triggerCharacters?: string[];
+}
+export type TuiAutocompleteProviderFactory = (current: TuiAutocompleteProviderApi) => TuiAutocompleteProviderApi;
 export interface TuiToolRenderContext {
     toolName: string;
+    toolCallId: string;
     args: unknown;
     resultText: string;
+    content?: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    details?: unknown;
+    invalidate: () => void;
+    lastComponent: unknown;
+    state: Record<string, unknown>;
+    cwd: string;
+    executionStarted: boolean;
+    argsComplete: boolean;
     isError: boolean;
+    isPartial?: boolean;
+    expanded: boolean;
+    showImages: boolean;
+}
+export type TuiToolRendererResult = string[] | TuiRenderableComponent | null | undefined;
+export type TuiToolRenderer = (ctx: TuiToolRenderContext) => TuiToolRendererResult;
+export interface TuiToolRenderResultOptions {
     expanded: boolean;
+    isPartial: boolean;
+}
+export interface TuiToolRendererDefinition {
+    renderShell?: 'default' | 'self';
+    render?: TuiToolRenderer;
+    renderCall?: (args: unknown, theme: TuiTheme, context: TuiToolRenderContext) => TuiToolRendererResult;
+    renderResult?: (result: {
+        content?: TuiToolRenderContext['content'];
+        details?: unknown;
+        text: string;
+    }, options: TuiToolRenderResultOptions, theme: TuiTheme, context: TuiToolRenderContext) => TuiToolRendererResult;
+}
+export type TuiToolRendererRegistration = TuiToolRenderer | TuiToolRendererDefinition;
+export interface TuiCommandInfo {
+    name: string;
+    description?: string;
+    source: 'builtin' | 'extension';
+}
+export interface TuiContextUsage {
+    /** xopc-native token estimate field. */
+    estimatedTokens: number | null;
+    /** pi-compatible token estimate field. */
+    tokens: number | null;
+    contextWindow: number | null;
+    /** xopc-native context usage percent field. */
+    usagePercent: number | null;
+    /** pi-compatible context usage percent field. */
+    percent: number | null;
+}
+export interface TuiModelInfo {
+    provider?: string;
+    id: string;
+    ref: string;
+    contextWindow?: number | null;
+}
+export type TuiModelRegistryModel = {
+    provider: string;
+    id: string;
+    ref?: string;
+    contextWindow?: number | null;
+} & Record<string, unknown>;
+export type TuiModelAuthResult = {
+    ok: true;
+    apiKey?: string;
+    headers?: Record<string, string>;
+} | {
+    ok: false;
+    error: string;
+};
+export interface TuiModelRegistry {
+    find(provider: string, modelId: string): TuiModelRegistryModel | undefined;
+    getApiKeyAndHeaders(model: TuiModelRegistryModel): Promise<TuiModelAuthResult>;
+}
+export type TuiThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'adaptive';
+export type TuiReasoningLevel = 'off' | 'on' | 'stream';
+export type TuiVerboseLevel = 'off' | 'on' | 'full';
+export interface TuiDialogOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+}
+export type TuiTheme = Record<string, unknown>;
+export interface TuiThemeInfo {
+    name: string;
+    path: string | undefined;
+}
+export interface TuiSetThemeResult {
+    success: boolean;
+    error?: string;
+}
+export interface TuiCustomMessage<T = unknown> {
+    customType: string;
+    content: string | unknown[];
+    display?: boolean;
+    details?: T;
+}
+export interface TuiMessageRenderOptions {
+    expanded: boolean;
+}
+export type TuiMessageRenderer<T = unknown> = (message: TuiCustomMessage<T>, options: TuiMessageRenderOptions, theme: TuiTheme) => TuiRenderableComponent | undefined;
+export type TuiWidgetPlacement = 'aboveEditor' | 'belowEditor';
+export interface TuiWidgetOptions {
+    placement?: TuiWidgetPlacement;
+}
+export type TuiRenderableComponent = {
+    render(width: number): string[];
+    invalidate?(): void;
+    dispose?(): void;
+};
+export type TuiWidgetFactory = (tui: unknown, theme: unknown) => TuiRenderableComponent;
+export type TuiHeaderFactory = (tui: unknown, theme: unknown) => TuiRenderableComponent;
+export interface TuiFooterDataProvider {
+    getGitBranch(): string | null;
+    getExtensionStatuses(): ReadonlyMap<string, string>;
+    getAvailableProviderCount(): number;
+    onBranchChange(callback: () => void): () => void;
+}
+export type TuiFooterFactory = (tui: unknown, theme: unknown, footerData: TuiFooterDataProvider) => TuiRenderableComponent;
+export type TuiEditorComponent = TuiRenderableComponent & {
+    getText(): string;
+    setText(text: string): void;
+    handleInput(data: string): void;
+    onSubmit?: (text: string) => void;
+    onChange?: (text: string) => void;
+    addToHistory?(text: string): void;
+    insertTextAtCursor?(text: string): void;
+    getExpandedText?(): string;
+    setAutocompleteProvider?(provider: TuiAutocompleteProviderApi): void;
+    borderColor?: (text: string) => string;
+    setPaddingX?(padding: number): void;
+    setAutocompleteMaxVisible?(maxVisible: number): void;
+};
+export type TuiEditorFactory = (tui: unknown, theme: unknown, keybindings: unknown) => TuiEditorComponent;
+export type TuiCustomComponent = unknown & {
+    dispose?(): void;
+};
+export type TuiOverlayAnchor = 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center' | 'left-center' | 'right-center';
+export interface TuiOverlayMargin {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+export type TuiOverlaySizeValue = number | `${number}%`;
+export interface TuiOverlayOptions {
+    width?: TuiOverlaySizeValue;
+    minWidth?: number;
+    maxHeight?: TuiOverlaySizeValue;
+    anchor?: TuiOverlayAnchor;
+    offsetX?: number;
+    offsetY?: number;
+    row?: TuiOverlaySizeValue;
+    col?: TuiOverlaySizeValue;
+    margin?: TuiOverlayMargin | number;
+    visible?: (termWidth: number, termHeight: number) => boolean;
+    nonCapturing?: boolean;
+}
+export interface TuiOverlayHandle {
+    hide(): void;
+    setHidden(hidden: boolean): void;
+    isHidden(): boolean;
+    focus(): void;
+    unfocus(options?: {
+        target: unknown | null;
+    }): void;
+    isFocused(): boolean;
+}
+export type TuiCustomFactoryResult = TuiCustomComponent | Promise<TuiCustomComponent>;
+export type TuiCustomLegacyFactory<T> = (done: (result: T) => void) => TuiCustomFactoryResult;
+export type TuiCustomFullFactory<T> = (tui: unknown, theme: unknown, keybindings: unknown, done: (result: T) => void) => TuiCustomFactoryResult;
+export type TuiCustomFactory<T> = TuiCustomLegacyFactory<T> | TuiCustomFullFactory<T>;
+export interface TuiCustomOptions {
+    /** xopc currently renders custom components as overlays. */
+    overlay?: boolean;
+    overlayOptions?: TuiOverlayOptions | (() => TuiOverlayOptions | undefined);
+    onHandle?: (handle: TuiOverlayHandle) => void;
+}
+export type TuiTerminalInputHandler = (data: string) => {
+    consume?: boolean;
+    data?: string;
+} | undefined;
+export interface TuiCompactOptions {
+    customInstructions?: string;
+    onComplete?: (result: TuiCompactResult) => void;
+    onError?: (error: Error) => void;
+}
+export interface TuiCompactResult {
+    compacted: boolean;
+    summary?: string;
+    tokensBefore?: number;
+    tokensAfter?: number;
+    transcriptSummary?: string;
+}
+export interface TuiSystemPromptOptions {
+    cwd: string;
+    sessionKey?: string;
+    model?: TuiModelInfo;
+}
+export interface TuiReplacementResult {
+    cancelled: boolean;
+}
+export interface TuiReplacedSessionContext extends TuiActionContext {
+    sendMessage<T = unknown>(message: TuiCustomMessage<T>, options?: {
+        triggerTurn?: boolean;
+        deliverAs?: 'steer' | 'followUp' | 'nextTurn';
+    }): Promise<void>;
+    sendUserMessage(content: string | Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>, options?: {
+        deliverAs?: 'steer' | 'followUp';
+    }): Promise<void>;
+}
+export interface TuiNewSessionOptions {
+    parentSession?: string;
+    setup?: (sessionManager: TuiReadonlySessionManager) => Promise<void>;
+    withSession?: (ctx: TuiReplacedSessionContext) => Promise<void>;
+}
+export interface TuiForkOptions {
+    position?: 'before' | 'at';
+    withSession?: (ctx: TuiReplacedSessionContext) => Promise<void>;
+}
+export interface TuiNavigateTreeOptions {
+    summarize?: boolean;
+    customInstructions?: string;
+    replaceInstructions?: boolean;
+    label?: string;
+}
+export interface TuiSwitchSessionOptions {
+    withSession?: (ctx: TuiReplacedSessionContext) => Promise<void>;
+}
+export interface TuiSessionSnapshotEntry {
+    id: string;
+    type: string;
+    parentId: string | null;
+    userLabel?: string;
+    labelTimestamp?: string;
+    role?: 'user' | 'assistant' | 'system';
+    message?: {
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+        usage?: {
+            input: number;
+            output: number;
+            cost: {
+                total: number;
+            };
+        };
+    };
+    content: string;
+    timestamp?: number;
+    raw?: unknown;
+}
+export interface TuiSessionSnapshotHeader {
+    type: 'session';
+    version?: number;
+    id: string;
+    timestamp: string;
+    cwd: string;
+    parentSession?: string;
+}
+export interface TuiSessionSnapshotTreeNode {
+    entry: TuiSessionSnapshotEntry;
+    children: TuiSessionSnapshotTreeNode[];
+    label?: string;
+    labelTimestamp?: string;
+}
+export interface TuiReadonlySessionManager {
+    getEntries(): TuiSessionSnapshotEntry[];
+    getBranch(): TuiSessionSnapshotEntry[];
+    getLeafEntry(): TuiSessionSnapshotEntry | undefined;
+    getLeafId(): string | null;
+    getEntry(entryId: string): TuiSessionSnapshotEntry | undefined;
+    getLabel(entryId: string): string | undefined;
+    getHeader(): TuiSessionSnapshotHeader | null;
+    getTree(): TuiSessionSnapshotTreeNode[];
+    getSessionId(): string;
+    getSessionFile(): string | undefined;
+    getSessionDir(): string | undefined;
+    getSessionName(): string | undefined;
+    getCwd(): string;
+}
+export interface TuiActionUiContext {
+    select(title: string, options: string[], opts?: TuiDialogOptions): Promise<string | undefined>;
+    confirm(title: string, message: string, opts?: TuiDialogOptions): Promise<boolean>;
+    input(title: string, placeholder?: string, opts?: TuiDialogOptions): Promise<string | undefined>;
+    notify(message: string, level?: TuiNotifyLevel): void;
+    onTerminalInput(handler: TuiTerminalInputHandler): () => void;
+    setStatus(key: string, text: string | null | undefined): void;
+    setWorkingMessage(message?: string | null): void;
+    setWorkingVisible(visible: boolean): void;
+    setWorkingIndicator(options?: TuiWorkingIndicatorOptions | null): void;
+    setHiddenThinkingLabel(label?: string | null): void;
+    setWidget(key: string, lines: string[] | null | undefined, options?: TuiWidgetOptions): void;
+    setWidget(key: string, factory: TuiWidgetFactory | undefined, options?: TuiWidgetOptions): void;
+    setFooter(factory: TuiFooterFactory | undefined): void;
+    setHeader(factory: TuiHeaderFactory | undefined): void;
+    custom<T>(factory: TuiCustomFactory<T>, options?: TuiCustomOptions): Promise<T>;
+    setTitle(title: string): void;
+    pasteToEditor(text: string): void;
+    setEditorText(text: string): void;
+    getEditorText(): string;
+    editor(title: string, prefill?: string): Promise<string | undefined>;
+    addAutocompleteProvider(factory: TuiAutocompleteProviderFactory): () => void;
+    setEditorComponent(factory: TuiEditorFactory | undefined): void;
+    getEditorComponent(): TuiEditorFactory | undefined;
+    readonly theme: TuiTheme;
+    getAllThemes(): TuiThemeInfo[];
+    getTheme(name: string): TuiTheme | undefined;
+    setTheme(theme: string): TuiSetThemeResult;
+    getToolsExpanded(): boolean;
+    setToolsExpanded(expanded: boolean): void;
+}
+export interface TuiActionContext {
+    readonly mode: 'tui';
+    readonly hasUI: true;
+    readonly signal?: AbortSignal;
+    readonly ui: TuiActionUiContext;
+    readonly sessionManager: TuiReadonlySessionManager;
+    readonly modelRegistry: TuiModelRegistry;
+    readonly model: TuiModelInfo | undefined;
+    cwd: string;
+    sessionKey: string;
+    isProjectTrusted(): boolean;
+    isIdle(): boolean;
+    hasPendingMessages(): boolean;
+    abort(): void | Promise<void>;
+    shutdown(): void;
+    compact(options?: TuiCompactOptions): void | Promise<void | TuiCompactResult>;
+    getSystemPrompt(): string;
+    getSystemPromptOptions(): TuiSystemPromptOptions;
+    waitForIdle(): Promise<void>;
+    newSession(options?: TuiNewSessionOptions): Promise<TuiReplacementResult>;
+    fork(entryId: string, options?: TuiForkOptions): Promise<TuiReplacementResult>;
+    navigateTree(targetId: string, options?: TuiNavigateTreeOptions): Promise<TuiReplacementResult>;
+    switchSession(sessionPath: string, options?: TuiSwitchSessionOptions): Promise<TuiReplacementResult>;
+    reload(): Promise<void>;
+    getModel(): TuiModelInfo | undefined;
+    setModel(modelRef: string): void | Promise<void>;
+    getThinkingLevel(): TuiThinkingLevel | undefined;
+    setThinkingLevel(level: TuiThinkingLevel): void | Promise<void>;
+    getReasoningLevel(): TuiReasoningLevel | undefined;
+    setReasoningLevel(level: TuiReasoningLevel): void | Promise<void>;
+    getVerboseLevel(): TuiVerboseLevel | undefined;
+    setVerboseLevel(level: TuiVerboseLevel): void | Promise<void>;
+    getCommands(): TuiCommandInfo[];
+    getContextUsage(): TuiContextUsage | undefined;
+    notify(message: string, level?: TuiNotifyLevel): void;
+}
+export type TuiSlashCommandContext = TuiActionContext;
+export type TuiSlashCommandHandler = (args: string, context?: TuiSlashCommandContext) => void | Promise<void>;
+export type TuiShortcutContext = TuiActionContext;
+export type TuiShortcutHandler = (context: TuiShortcutContext) => void | Promise<void>;
+export interface TuiWorkingIndicatorOptions {
+    /** Animation frames. Use an empty array to hide the indicator. */
+    frames?: string[];
+    /** Frame interval in milliseconds for animated indicators. */
+    intervalMs?: number;
 }
-export type TuiToolRenderer = (ctx: TuiToolRenderContext) => string[] | null;
-export type TuiSlashCommandHandler = (args: string) => void | Promise<void>;
 /** Host passed to extension `registerTui` callbacks when `xopc tui` starts. */
 export interface TuiExtensionHostContract {
     readonly extensionId: string;
     setFooterWidget(key: string, lines: string[] | null): void;
     setHeaderWidget(key: string, lines: string[] | null): void;
+    setWidget(key: string, lines: string[] | null | undefined, options?: TuiWidgetOptions): void;
+    setWidget(key: string, factory: TuiWidgetFactory | undefined, options?: TuiWidgetOptions): void;
+    setFooter(factory: TuiFooterFactory | undefined): void;
+    setHeader(factory: TuiHeaderFactory | undefined): void;
     addAutocompleteProvider(provider: TuiAutocompleteProvider): () => void;
-    registerToolRenderer(toolName: string, renderer: TuiToolRenderer): () => void;
+    addAutocompleteProvider(factory: TuiAutocompleteProviderFactory): () => void;
+    registerToolRenderer(toolName: string, renderer: TuiToolRendererRegistration): () => void;
+    registerMessageRenderer<T = unknown>(customType: string, renderer: TuiMessageRenderer<T>): () => void;
     registerSlashCommand(name: string, description: string, handler: TuiSlashCommandHandler): () => void;
+    registerShortcut(key: string, description: string, handler: TuiShortcutHandler): () => void;
     notify(message: string, level?: TuiNotifyLevel): void;
+    onTerminalInput(handler: TuiTerminalInputHandler): () => void;
     showOverlay(component: unknown): void;
     hideOverlay(): void;
-    setStatus(key: string, text: string | null): void;
+    custom<T>(factory: TuiCustomFactory<T>, options?: TuiCustomOptions): Promise<T>;
+    setTitle(title: string): void;
+    pasteToEditor(text: string): void;
+    setEditorText(text: string): void;
+    getEditorText(): string;
+    editor(title: string, prefill?: string): Promise<string | undefined>;
+    setEditorComponent(factory: TuiEditorFactory | undefined): void;
+    getEditorComponent(): TuiEditorFactory | undefined;
+    readonly theme: TuiTheme;
+    getAllThemes(): TuiThemeInfo[];
+    getTheme(name: string): TuiTheme | undefined;
+    setTheme(theme: string): TuiSetThemeResult;
+    getToolsExpanded(): boolean;
+    setToolsExpanded(expanded: boolean): void;
+    select(title: string, options: string[], opts?: TuiDialogOptions): Promise<string | undefined>;
+    confirm(title: string, message: string, opts?: TuiDialogOptions): Promise<boolean>;
+    input(title: string, placeholder?: string, opts?: TuiDialogOptions): Promise<string | undefined>;
+    setStatus(key: string, text: string | null | undefined): void;
+    setWorkingMessage(message?: string | null): void;
+    setWorkingVisible(visible: boolean): void;
+    setWorkingIndicator(options?: TuiWorkingIndicatorOptions | null): void;
+    setHiddenThinkingLabel(label?: string | null): void;
 }
 export type TuiExtensionRegistrar = (host: TuiExtensionHostContract) => void | Promise<void>;
 export interface TuiExtensionRegistration {

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -2,5 +2,5 @@
  * Built-in agent tool `name` values for gateway admin UI (disable toggles).
  * Extension tools are not listed; users can still add arbitrary strings in config.
  */
-export declare const GATEWAY_BUILTIN_TOOL_IDS: readonly ["read_file", "write_file", "edit_file", "list_dir", "grep", "find", "shell", "web_search", "web_fetch", "send_message", "send_media", "memory_search", "memory_get", "curated_memory", "session_search", "image", "image_generate", "browser_use", "extensions", "bundle-mcp"];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: readonly ["read_file", "write_file", "edit_file", "list_dir", "grep", "find", "shell", "session_status", "dreaming", "tool_manual", "clarify", "todo", "skills_list", "skill_view", "skill_manage", "web_search", "web_fetch", "web_extract", "send_message", "send_media", "read_media", "create_share", "text_to_speech", "memory_search", "memory_get", "curated_memory", "session_search", "cronjob", "workflow", "delegate_task", "execute_code", "image", "image_generate", "browser_use", "extensions", "bundle-mcp"];
 export type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];