@seed-ship/mcp-ui-solid 5.1.0 → 5.2.0

package/dist/services/chat-bus.cjs

@@ -134,6 +134,76 @@ function mergeScratchpadSections(existing, incoming, mode = "replace") {
       return incoming;
   }
 }
+function elicitationToPromptConfig(event) {
+  const propEntries = Object.entries(event.requestedSchema.properties);
+  if (propEntries.length === 1 && propEntries[0][1].type === "boolean") {
+    return {
+      type: "confirm",
+      title: event.message,
+      config: {
+        message: propEntries[0][1].description
+      }
+    };
+  }
+  if (propEntries.length === 1) {
+    const [, schema] = propEntries[0];
+    if (schema.enum && schema.enum.length > 0 && schema.enum.length <= 4) {
+      return {
+        type: "choice",
+        title: event.message,
+        config: {
+          options: schema.enum.map((val, idx) => {
+            var _a;
+            return {
+              value: String(val),
+              label: ((_a = schema.enumNames) == null ? void 0 : _a[idx]) ?? String(val)
+            };
+          }),
+          layout: "vertical"
+        }
+      };
+    }
+  }
+  const required = new Set(event.requestedSchema.required ?? []);
+  const fields = propEntries.map(([name, schema]) => ({
+    name,
+    label: schema.title ?? name,
+    ...schemaToFieldType(schema),
+    required: required.has(name),
+    helpText: schema.description,
+    ...schema.default !== void 0 ? { placeholder: String(schema.default) } : {}
+  }));
+  return {
+    type: "form",
+    title: event.message,
+    config: { fields }
+  };
+}
+function schemaToFieldType(schema) {
+  if (schema.enum && schema.enum.length > 0) {
+    return {
+      type: "select",
+      options: schema.enum.map((val, idx) => {
+        var _a;
+        return {
+          label: ((_a = schema.enumNames) == null ? void 0 : _a[idx]) ?? String(val),
+          value: String(val)
+        };
+      })
+    };
+  }
+  if (schema.type === "boolean") return { type: "checkbox" };
+  if (schema.type === "number" || schema.type === "integer") return { type: "number" };
+  if (schema.type === "string") {
+    if (schema.format === "email") return { type: "email" };
+    if (schema.format === "date" || schema.format === "date-time") return { type: "date" };
+    return { type: "text" };
+  }
+  console.warn(
+    `[MCP-UI] elicitationToPromptConfig: unsupported schema type "${schema.type}", falling back to text.`
+  );
+  return { type: "text" };
+}
 function clarificationToPromptConfig(event) {
   return {
     type: "choice",
@@ -160,5 +230,6 @@ exports.clarificationToPromptConfig = clarificationToPromptConfig;
 exports.createChatBus = createChatBus;
 exports.createCommandHandler = createCommandHandler;
 exports.createEventEmitter = createEventEmitter;
+exports.elicitationToPromptConfig = elicitationToPromptConfig;
 exports.mergeScratchpadSections = mergeScratchpadSections;
 //# sourceMappingURL=chat-bus.cjs.map

package/dist/services/chat-bus.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"chat-bus.cjs","sources":["../../src/services/chat-bus.ts"],"sourcesContent":["/**\n * Chat Bus — Event Emitter + Command Handler\n * v2.4.0: Core primitives for the chat event/command bus\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport type {\n  ChatEvents,\n  ChatCommands,\n  ChatEventEmitter,\n  ChatCommandHandler,\n  ChatBus,\n  EventSubscribeOptions,\n  ScratchpadSection,\n  ClarificationEvent,\n  ChatPromptConfig,\n} from '../types/chat-bus'\n\n// ─── Event Emitter ───────────────────────────────────────────\n\ninterface Listener<F extends (...args: any[]) => any> {\n  handler: F\n  options?: EventSubscribeOptions\n  throttledHandler?: F\n}\n\n/**\n * Create a typed event emitter with throttle and streamKey filtering support.\n *\n * @experimental\n *\n * @example\n * const emitter = createEventEmitter<ChatEvents>()\n * const unsub = emitter.on('onToken', (event) => console.log(event.token), { throttle: 100 })\n * emitter.emit('onToken', { streamKey: 'abc', token: 'hello' })\n * unsub()\n */\nexport function createEventEmitter(): ChatEventEmitter {\n  const listeners = new Map<string, Set<Listener<any>>>()\n\n  interface ThrottledFn<F> {\n    fn: F\n    cancel: () => void\n  }\n\n  function createThrottled<F extends (...args: any[]) => void>(fn: F, ms: number): ThrottledFn<F> {\n    let lastCall = 0\n    let timer: ReturnType<typeof setTimeout> | null = null\n    let lastArgs: any[] | null = null\n    let cancelled = false\n\n    const throttled = ((...args: any[]) => {\n      if (cancelled) return\n      lastArgs = args\n      const now = Date.now()\n      const remaining = ms - (now - lastCall)\n\n      if (remaining <= 0) {\n        if (timer) { clearTimeout(timer); timer = null }\n        lastCall = now\n        fn(...args)\n      } else if (!timer) {\n        timer = setTimeout(() => {\n          lastCall = Date.now()\n          timer = null\n          if (lastArgs && !cancelled) {\n            try { fn(...lastArgs) } catch (err) { console.error('[ChatBus] Error in throttled handler:', err) }\n          }\n        }, remaining)\n      }\n    }) as F\n\n    return {\n      fn: throttled,\n      cancel: () => { cancelled = true; if (timer) { clearTimeout(timer); timer = null } },\n    }\n  }\n\n  return {\n    on(event, handler, options) {\n      if (!listeners.has(event as string)) {\n        listeners.set(event as string, new Set())\n      }\n\n      const listener: Listener<typeof handler> = { handler, options }\n\n      // Apply throttle if requested\n      let throttleHandle: ThrottledFn<typeof handler> | null = null\n      if (options?.throttle && options.throttle > 0) {\n        throttleHandle = createThrottled(handler, options.throttle)\n        listener.throttledHandler = throttleHandle.fn\n      }\n\n      listeners.get(event as string)!.add(listener)\n\n      // Return unsubscribe function — cancels pending throttle timers\n      return () => {\n        throttleHandle?.cancel()\n        listeners.get(event as string)?.delete(listener)\n      }\n    },\n\n    emit(event, ...args) {\n      const set = listeners.get(event as string)\n      if (!set) return\n\n      for (const listener of set) {\n        // StreamKey filtering: skip if listener wants a specific streamKey\n        // For most events args[0] has streamKey; for onCustomEvent args[1] has it\n        if (listener.options?.streamKey) {\n          let streamKeyArg: unknown\n          for (const arg of args) {\n            if (arg && typeof arg === 'object' && 'streamKey' in (arg as any)) {\n              streamKeyArg = (arg as any).streamKey\n              break\n            }\n          }\n          if (streamKeyArg !== undefined && streamKeyArg !== listener.options.streamKey) continue\n        }\n\n        const fn = listener.throttledHandler || listener.handler\n        try {\n          fn(...args)\n        } catch (err) {\n          console.error(`[ChatBus] Error in ${event as string} handler:`, err)\n        }\n      }\n    },\n\n    clear() {\n      listeners.clear()\n    },\n  } as ChatEventEmitter\n}\n\n// ─── Command Handler ─────────────────────────────────────────\n\n/**\n * Create a typed command handler. The host app registers handlers,\n * agents execute commands.\n *\n * @experimental\n *\n * @example\n * const commands = createCommandHandler<ChatCommands>()\n * commands.handle('injectPrompt', (text) => setInputValue(text))\n * commands.exec('injectPrompt', 'Hello world')\n */\nexport function createCommandHandler(): ChatCommandHandler {\n  const handlers = new Map<string, (...args: any[]) => any>()\n\n  return {\n    handle(command, handler) {\n      handlers.set(command as string, handler)\n    },\n\n    exec(command, ...args) {\n      const handler = handlers.get(command as string)\n      if (!handler) {\n        console.warn(`[ChatBus] No handler registered for command: ${command as string}`)\n        return undefined as any\n      }\n      return handler(...args)\n    },\n  } as ChatCommandHandler\n}\n\n// ─── Chat Bus Factory ────────────────────────────────────────\n\n/**\n * Create a complete ChatBus with events + commands.\n *\n * @experimental\n *\n * @example\n * const bus = createChatBus()\n * bus.events.on('onStreamEnd', (event) => { ... })\n * bus.commands.handle('sendPrompt', (text) => { ... })\n */\nexport function createChatBus(): ChatBus {\n  return {\n    events: createEventEmitter(),\n    commands: createCommandHandler(),\n  }\n}\n\n// ─── Scratchpad Section Merge Helper ─────────────────────────\n\n/**\n * Merge sections from a ScratchpadEvent into existing state sections.\n * Handles replace/append/upsert modes.\n *\n * @example\n * const newSections = mergeScratchpadSections(\n *   currentState.sections,\n *   event.sections,\n *   event.sectionMode\n * )\n */\nexport function mergeScratchpadSections(\n  existing: ScratchpadSection[],\n  incoming: ScratchpadSection[] | undefined,\n  mode: 'replace' | 'append' | 'upsert' = 'replace'\n): ScratchpadSection[] {\n  if (!incoming) return existing\n\n  switch (mode) {\n    case 'append':\n      return [...existing, ...incoming]\n\n    case 'upsert': {\n      const result = [...existing]\n      for (const section of incoming) {\n        const idx = result.findIndex((s) => s.id === section.id)\n        if (idx >= 0) {\n          result[idx] = section\n        } else {\n          result.push(section)\n        }\n      }\n      return result\n    }\n\n    case 'replace':\n    default:\n      return incoming\n  }\n}\n\n// ─── Clarification → Prompt Helper (v4.3.9) ──────────────────\n\n/**\n * Convert a ClarificationEvent into a ChatPromptConfig.\n * Universal bridge for apps receiving clarification events via SSE.\n *\n * Legacy runtime `file_id` (removed from the type in v5.0.0) is still\n * transparently migrated into `metadata.file_id` when present, so payloads\n * from older servers continue to work without upgrade pressure.\n *\n * @experimental\n * @since v4.3.9\n * @example\n * bus.events.on('onClarificationNeeded', ({ clarification }) => {\n *   bus.commands.exec('showChatPrompt', clarificationToPromptConfig(clarification))\n * })\n */\nexport function clarificationToPromptConfig(\n  event: ClarificationEvent\n): ChatPromptConfig {\n  return {\n    type: 'choice',\n    title: event.question,\n    config: {\n      options: event.options.map((opt) => {\n        const merged: Record<string, unknown> = { ...(opt.metadata ?? {}) }\n        // Runtime fallback for legacy payloads that still carry file_id at the top level.\n        const legacyFileId = (opt as { file_id?: number }).file_id\n        if (legacyFileId !== undefined && merged.file_id === undefined) {\n          merged.file_id = legacyFileId\n        }\n        return {\n          value: opt.value,\n          label: opt.label,\n          // Only include metadata if non-empty (keeps payloads clean)\n          ...(Object.keys(merged).length > 0 ? { metadata: merged } : {}),\n        }\n      }),\n      layout: 'vertical',\n    },\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-bus.cjs","sources":["../../src/services/chat-bus.ts"],"sourcesContent":["/**\n * Chat Bus — Event Emitter + Command Handler\n * v2.4.0: Core primitives for the chat event/command bus\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport type {\n  ChatEvents,\n  ChatCommands,\n  ChatEventEmitter,\n  ChatCommandHandler,\n  ChatBus,\n  EventSubscribeOptions,\n  ScratchpadSection,\n  ClarificationEvent,\n  ElicitationEvent,\n  ElicitationPropertySchema,\n  ChatPromptConfig,\n  FormPromptConfig,\n} from '../types/chat-bus'\n\n// ─── Event Emitter ───────────────────────────────────────────\n\ninterface Listener<F extends (...args: any[]) => any> {\n  handler: F\n  options?: EventSubscribeOptions\n  throttledHandler?: F\n}\n\n/**\n * Create a typed event emitter with throttle and streamKey filtering support.\n *\n * @experimental\n *\n * @example\n * const emitter = createEventEmitter<ChatEvents>()\n * const unsub = emitter.on('onToken', (event) => console.log(event.token), { throttle: 100 })\n * emitter.emit('onToken', { streamKey: 'abc', token: 'hello' })\n * unsub()\n */\nexport function createEventEmitter(): ChatEventEmitter {\n  const listeners = new Map<string, Set<Listener<any>>>()\n\n  interface ThrottledFn<F> {\n    fn: F\n    cancel: () => void\n  }\n\n  function createThrottled<F extends (...args: any[]) => void>(fn: F, ms: number): ThrottledFn<F> {\n    let lastCall = 0\n    let timer: ReturnType<typeof setTimeout> | null = null\n    let lastArgs: any[] | null = null\n    let cancelled = false\n\n    const throttled = ((...args: any[]) => {\n      if (cancelled) return\n      lastArgs = args\n      const now = Date.now()\n      const remaining = ms - (now - lastCall)\n\n      if (remaining <= 0) {\n        if (timer) { clearTimeout(timer); timer = null }\n        lastCall = now\n        fn(...args)\n      } else if (!timer) {\n        timer = setTimeout(() => {\n          lastCall = Date.now()\n          timer = null\n          if (lastArgs && !cancelled) {\n            try { fn(...lastArgs) } catch (err) { console.error('[ChatBus] Error in throttled handler:', err) }\n          }\n        }, remaining)\n      }\n    }) as F\n\n    return {\n      fn: throttled,\n      cancel: () => { cancelled = true; if (timer) { clearTimeout(timer); timer = null } },\n    }\n  }\n\n  return {\n    on(event, handler, options) {\n      if (!listeners.has(event as string)) {\n        listeners.set(event as string, new Set())\n      }\n\n      const listener: Listener<typeof handler> = { handler, options }\n\n      // Apply throttle if requested\n      let throttleHandle: ThrottledFn<typeof handler> | null = null\n      if (options?.throttle && options.throttle > 0) {\n        throttleHandle = createThrottled(handler, options.throttle)\n        listener.throttledHandler = throttleHandle.fn\n      }\n\n      listeners.get(event as string)!.add(listener)\n\n      // Return unsubscribe function — cancels pending throttle timers\n      return () => {\n        throttleHandle?.cancel()\n        listeners.get(event as string)?.delete(listener)\n      }\n    },\n\n    emit(event, ...args) {\n      const set = listeners.get(event as string)\n      if (!set) return\n\n      for (const listener of set) {\n        // StreamKey filtering: skip if listener wants a specific streamKey\n        // For most events args[0] has streamKey; for onCustomEvent args[1] has it\n        if (listener.options?.streamKey) {\n          let streamKeyArg: unknown\n          for (const arg of args) {\n            if (arg && typeof arg === 'object' && 'streamKey' in (arg as any)) {\n              streamKeyArg = (arg as any).streamKey\n              break\n            }\n          }\n          if (streamKeyArg !== undefined && streamKeyArg !== listener.options.streamKey) continue\n        }\n\n        const fn = listener.throttledHandler || listener.handler\n        try {\n          fn(...args)\n        } catch (err) {\n          console.error(`[ChatBus] Error in ${event as string} handler:`, err)\n        }\n      }\n    },\n\n    clear() {\n      listeners.clear()\n    },\n  } as ChatEventEmitter\n}\n\n// ─── Command Handler ─────────────────────────────────────────\n\n/**\n * Create a typed command handler. The host app registers handlers,\n * agents execute commands.\n *\n * @experimental\n *\n * @example\n * const commands = createCommandHandler<ChatCommands>()\n * commands.handle('injectPrompt', (text) => setInputValue(text))\n * commands.exec('injectPrompt', 'Hello world')\n */\nexport function createCommandHandler(): ChatCommandHandler {\n  const handlers = new Map<string, (...args: any[]) => any>()\n\n  return {\n    handle(command, handler) {\n      handlers.set(command as string, handler)\n    },\n\n    exec(command, ...args) {\n      const handler = handlers.get(command as string)\n      if (!handler) {\n        console.warn(`[ChatBus] No handler registered for command: ${command as string}`)\n        return undefined as any\n      }\n      return handler(...args)\n    },\n  } as ChatCommandHandler\n}\n\n// ─── Chat Bus Factory ────────────────────────────────────────\n\n/**\n * Create a complete ChatBus with events + commands.\n *\n * @experimental\n *\n * @example\n * const bus = createChatBus()\n * bus.events.on('onStreamEnd', (event) => { ... })\n * bus.commands.handle('sendPrompt', (text) => { ... })\n */\nexport function createChatBus(): ChatBus {\n  return {\n    events: createEventEmitter(),\n    commands: createCommandHandler(),\n  }\n}\n\n// ─── Scratchpad Section Merge Helper ─────────────────────────\n\n/**\n * Merge sections from a ScratchpadEvent into existing state sections.\n * Handles replace/append/upsert modes.\n *\n * @example\n * const newSections = mergeScratchpadSections(\n *   currentState.sections,\n *   event.sections,\n *   event.sectionMode\n * )\n */\nexport function mergeScratchpadSections(\n  existing: ScratchpadSection[],\n  incoming: ScratchpadSection[] | undefined,\n  mode: 'replace' | 'append' | 'upsert' = 'replace'\n): ScratchpadSection[] {\n  if (!incoming) return existing\n\n  switch (mode) {\n    case 'append':\n      return [...existing, ...incoming]\n\n    case 'upsert': {\n      const result = [...existing]\n      for (const section of incoming) {\n        const idx = result.findIndex((s) => s.id === section.id)\n        if (idx >= 0) {\n          result[idx] = section\n        } else {\n          result.push(section)\n        }\n      }\n      return result\n    }\n\n    case 'replace':\n    default:\n      return incoming\n  }\n}\n\n// ─── Clarification → Prompt Helper (v4.3.9) ──────────────────\n\n/**\n * Convert a ClarificationEvent into a ChatPromptConfig.\n * Universal bridge for apps receiving clarification events via SSE.\n *\n * Legacy runtime `file_id` (removed from the type in v5.0.0) is still\n * transparently migrated into `metadata.file_id` when present, so payloads\n * from older servers continue to work without upgrade pressure.\n *\n * @experimental\n * @since v4.3.9\n * @example\n * bus.events.on('onClarificationNeeded', ({ clarification }) => {\n *   bus.commands.exec('showChatPrompt', clarificationToPromptConfig(clarification))\n * })\n */\n// ─── Elicitation → Prompt Helper (v5.2.0) ───────────────────\n\n/**\n * Convert an MCP `elicitation/create` payload into a `ChatPromptConfig`.\n *\n * Mapping rules :\n * - Single `boolean` property → `type: 'confirm'`\n * - Single property with `enum` of ≤4 values → `type: 'choice'` (one option per enum value)\n * - Anything else → `type: 'form'` with one field per schema property\n *\n * JSON Schema primitive types map to mcp-ui form field types :\n *\n * | JSON Schema | mcp-ui FormFieldType |\n * |---|---|\n * | `type: 'string'` | `'text'` |\n * | `type: 'string', format: 'email'` | `'email'` |\n * | `type: 'string', format: 'date'` or `'date-time'` | `'date'` |\n * | `type: 'string', enum: [...]` | `'select'` |\n * | `type: 'number' \\| 'integer'` | `'number'` |\n * | `type: 'boolean'` | `'checkbox'` |\n *\n * Unknown shapes fall through to plain text with a `helpText` warning.\n *\n * @experimental\n * @since v5.2.0\n *\n * @example\n * bus.events.on('onElicitation', ({ elicitation }) => {\n *   bus.commands.exec('showChatPrompt', elicitationToPromptConfig(elicitation))\n * })\n */\nexport function elicitationToPromptConfig(event: ElicitationEvent): ChatPromptConfig {\n  const propEntries = Object.entries(event.requestedSchema.properties)\n\n  // Shortcut 1 : single boolean → confirm\n  if (propEntries.length === 1 && propEntries[0][1].type === 'boolean') {\n    return {\n      type: 'confirm',\n      title: event.message,\n      config: {\n        message: propEntries[0][1].description,\n      },\n    }\n  }\n\n  // Shortcut 2 : single enum property with ≤4 values → choice\n  if (propEntries.length === 1) {\n    const [, schema] = propEntries[0]\n    if (schema.enum && schema.enum.length > 0 && schema.enum.length <= 4) {\n      return {\n        type: 'choice',\n        title: event.message,\n        config: {\n          options: schema.enum.map((val, idx) => ({\n            value: String(val),\n            label: schema.enumNames?.[idx] ?? String(val),\n          })),\n          layout: 'vertical',\n        },\n      }\n    }\n  }\n\n  // Default : full form\n  const required = new Set(event.requestedSchema.required ?? [])\n  const fields: FormPromptConfig['fields'] = propEntries.map(([name, schema]) => ({\n    name,\n    label: schema.title ?? name,\n    ...schemaToFieldType(schema),\n    required: required.has(name),\n    helpText: schema.description,\n    ...(schema.default !== undefined ? { placeholder: String(schema.default) } : {}),\n  }))\n\n  return {\n    type: 'form',\n    title: event.message,\n    config: { fields },\n  }\n}\n\nfunction schemaToFieldType(\n  schema: ElicitationPropertySchema\n):\n  | { type: FormPromptConfig['fields'][number]['type']; options?: Array<{ label: string; value: string }> }\n  | { type: FormPromptConfig['fields'][number]['type']; helpText?: string } {\n  // Enum → select\n  if (schema.enum && schema.enum.length > 0) {\n    return {\n      type: 'select',\n      options: schema.enum.map((val, idx) => ({\n        label: schema.enumNames?.[idx] ?? String(val),\n        value: String(val),\n      })),\n    }\n  }\n\n  if (schema.type === 'boolean') return { type: 'checkbox' }\n  if (schema.type === 'number' || schema.type === 'integer') return { type: 'number' }\n  if (schema.type === 'string') {\n    if (schema.format === 'email') return { type: 'email' }\n    if (schema.format === 'date' || schema.format === 'date-time') return { type: 'date' }\n    return { type: 'text' }\n  }\n\n  // Unknown primitive — fall back to text with a warning\n  console.warn(\n    `[MCP-UI] elicitationToPromptConfig: unsupported schema type \"${(schema as { type?: string }).type}\", falling back to text.`\n  )\n  return { type: 'text' }\n}\n\nexport function clarificationToPromptConfig(\n  event: ClarificationEvent\n): ChatPromptConfig {\n  return {\n    type: 'choice',\n    title: event.question,\n    config: {\n      options: event.options.map((opt) => {\n        const merged: Record<string, unknown> = { ...(opt.metadata ?? {}) }\n        // Runtime fallback for legacy payloads that still carry file_id at the top level.\n        const legacyFileId = (opt as { file_id?: number }).file_id\n        if (legacyFileId !== undefined && merged.file_id === undefined) {\n          merged.file_id = legacyFileId\n        }\n        return {\n          value: opt.value,\n          label: opt.label,\n          // Only include metadata if non-empty (keeps payloads clean)\n          ...(Object.keys(merged).length > 0 ? { metadata: merged } : {}),\n        }\n      }),\n      layout: 'vertical',\n    },\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/services/chat-bus.d.ts

@@ -4,7 +4,7 @@
  *
  * @experimental — This API may change without major bump until v2.5.0.
  */
-import type { ChatEventEmitter, ChatCommandHandler, ChatBus, ScratchpadSection, ClarificationEvent, ChatPromptConfig } from '../types/chat-bus';
+import type { ChatEventEmitter, ChatCommandHandler, ChatBus, ScratchpadSection, ClarificationEvent, ElicitationEvent, ChatPromptConfig } from '../types/chat-bus';
 /**
  * Create a typed event emitter with throttle and streamKey filtering support.
  *
@@ -67,5 +67,35 @@ export declare function mergeScratchpadSections(existing: ScratchpadSection[], i
  *   bus.commands.exec('showChatPrompt', clarificationToPromptConfig(clarification))
  * })
  */
+/**
+ * Convert an MCP `elicitation/create` payload into a `ChatPromptConfig`.
+ *
+ * Mapping rules :
+ * - Single `boolean` property → `type: 'confirm'`
+ * - Single property with `enum` of ≤4 values → `type: 'choice'` (one option per enum value)
+ * - Anything else → `type: 'form'` with one field per schema property
+ *
+ * JSON Schema primitive types map to mcp-ui form field types :
+ *
+ * | JSON Schema | mcp-ui FormFieldType |
+ * |---|---|
+ * | `type: 'string'` | `'text'` |
+ * | `type: 'string', format: 'email'` | `'email'` |
+ * | `type: 'string', format: 'date'` or `'date-time'` | `'date'` |
+ * | `type: 'string', enum: [...]` | `'select'` |
+ * | `type: 'number' \| 'integer'` | `'number'` |
+ * | `type: 'boolean'` | `'checkbox'` |
+ *
+ * Unknown shapes fall through to plain text with a `helpText` warning.
+ *
+ * @experimental
+ * @since v5.2.0
+ *
+ * @example
+ * bus.events.on('onElicitation', ({ elicitation }) => {
+ *   bus.commands.exec('showChatPrompt', elicitationToPromptConfig(elicitation))
+ * })
+ */
+export declare function elicitationToPromptConfig(event: ElicitationEvent): ChatPromptConfig;
 export declare function clarificationToPromptConfig(event: ClarificationEvent): ChatPromptConfig;
 //# sourceMappingURL=chat-bus.d.ts.map

package/dist/services/chat-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-bus.d.ts","sourceRoot":"","sources":["../../src/services/chat-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAGV,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EAEP,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAU1B;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAgGrD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAiBzD;AAID;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACzC,IAAI,GAAE,SAAS,GAAG,QAAQ,GAAG,QAAoB,GAChD,iBAAiB,EAAE,CAwBrB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,CAsBlB"}
+{"version":3,"file":"chat-bus.d.ts","sourceRoot":"","sources":["../../src/services/chat-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAGV,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EAEP,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAEhB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAA;AAU1B;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAgGrD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAiBzD;AAID;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACzC,IAAI,GAAE,SAAS,GAAG,QAAQ,GAAG,QAAoB,GAChD,iBAAiB,EAAE,CAwBrB;AAID;;;;;;;;;;;;;;GAcG;AAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAgDnF;AAiCD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,CAsBlB"}

package/dist/services/chat-bus.js

@@ -132,6 +132,76 @@ function mergeScratchpadSections(existing, incoming, mode = "replace") {
       return incoming;
   }
 }
+function elicitationToPromptConfig(event) {
+  const propEntries = Object.entries(event.requestedSchema.properties);
+  if (propEntries.length === 1 && propEntries[0][1].type === "boolean") {
+    return {
+      type: "confirm",
+      title: event.message,
+      config: {
+        message: propEntries[0][1].description
+      }
+    };
+  }
+  if (propEntries.length === 1) {
+    const [, schema] = propEntries[0];
+    if (schema.enum && schema.enum.length > 0 && schema.enum.length <= 4) {
+      return {
+        type: "choice",
+        title: event.message,
+        config: {
+          options: schema.enum.map((val, idx) => {
+            var _a;
+            return {
+              value: String(val),
+              label: ((_a = schema.enumNames) == null ? void 0 : _a[idx]) ?? String(val)
+            };
+          }),
+          layout: "vertical"
+        }
+      };
+    }
+  }
+  const required = new Set(event.requestedSchema.required ?? []);
+  const fields = propEntries.map(([name, schema]) => ({
+    name,
+    label: schema.title ?? name,
+    ...schemaToFieldType(schema),
+    required: required.has(name),
+    helpText: schema.description,
+    ...schema.default !== void 0 ? { placeholder: String(schema.default) } : {}
+  }));
+  return {
+    type: "form",
+    title: event.message,
+    config: { fields }
+  };
+}
+function schemaToFieldType(schema) {
+  if (schema.enum && schema.enum.length > 0) {
+    return {
+      type: "select",
+      options: schema.enum.map((val, idx) => {
+        var _a;
+        return {
+          label: ((_a = schema.enumNames) == null ? void 0 : _a[idx]) ?? String(val),
+          value: String(val)
+        };
+      })
+    };
+  }
+  if (schema.type === "boolean") return { type: "checkbox" };
+  if (schema.type === "number" || schema.type === "integer") return { type: "number" };
+  if (schema.type === "string") {
+    if (schema.format === "email") return { type: "email" };
+    if (schema.format === "date" || schema.format === "date-time") return { type: "date" };
+    return { type: "text" };
+  }
+  console.warn(
+    `[MCP-UI] elicitationToPromptConfig: unsupported schema type "${schema.type}", falling back to text.`
+  );
+  return { type: "text" };
+}
 function clarificationToPromptConfig(event) {
   return {
     type: "choice",
@@ -159,6 +229,7 @@ export {
   createChatBus,
   createCommandHandler,
   createEventEmitter,
+  elicitationToPromptConfig,
   mergeScratchpadSections
 };
 //# sourceMappingURL=chat-bus.js.map

package/dist/services/chat-bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-bus.js","sources":["../../src/services/chat-bus.ts"],"sourcesContent":["/**\n * Chat Bus — Event Emitter + Command Handler\n * v2.4.0: Core primitives for the chat event/command bus\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport type {\n  ChatEvents,\n  ChatCommands,\n  ChatEventEmitter,\n  ChatCommandHandler,\n  ChatBus,\n  EventSubscribeOptions,\n  ScratchpadSection,\n  ClarificationEvent,\n  ChatPromptConfig,\n} from '../types/chat-bus'\n\n// ─── Event Emitter ───────────────────────────────────────────\n\ninterface Listener<F extends (...args: any[]) => any> {\n  handler: F\n  options?: EventSubscribeOptions\n  throttledHandler?: F\n}\n\n/**\n * Create a typed event emitter with throttle and streamKey filtering support.\n *\n * @experimental\n *\n * @example\n * const emitter = createEventEmitter<ChatEvents>()\n * const unsub = emitter.on('onToken', (event) => console.log(event.token), { throttle: 100 })\n * emitter.emit('onToken', { streamKey: 'abc', token: 'hello' })\n * unsub()\n */\nexport function createEventEmitter(): ChatEventEmitter {\n  const listeners = new Map<string, Set<Listener<any>>>()\n\n  interface ThrottledFn<F> {\n    fn: F\n    cancel: () => void\n  }\n\n  function createThrottled<F extends (...args: any[]) => void>(fn: F, ms: number): ThrottledFn<F> {\n    let lastCall = 0\n    let timer: ReturnType<typeof setTimeout> | null = null\n    let lastArgs: any[] | null = null\n    let cancelled = false\n\n    const throttled = ((...args: any[]) => {\n      if (cancelled) return\n      lastArgs = args\n      const now = Date.now()\n      const remaining = ms - (now - lastCall)\n\n      if (remaining <= 0) {\n        if (timer) { clearTimeout(timer); timer = null }\n        lastCall = now\n        fn(...args)\n      } else if (!timer) {\n        timer = setTimeout(() => {\n          lastCall = Date.now()\n          timer = null\n          if (lastArgs && !cancelled) {\n            try { fn(...lastArgs) } catch (err) { console.error('[ChatBus] Error in throttled handler:', err) }\n          }\n        }, remaining)\n      }\n    }) as F\n\n    return {\n      fn: throttled,\n      cancel: () => { cancelled = true; if (timer) { clearTimeout(timer); timer = null } },\n    }\n  }\n\n  return {\n    on(event, handler, options) {\n      if (!listeners.has(event as string)) {\n        listeners.set(event as string, new Set())\n      }\n\n      const listener: Listener<typeof handler> = { handler, options }\n\n      // Apply throttle if requested\n      let throttleHandle: ThrottledFn<typeof handler> | null = null\n      if (options?.throttle && options.throttle > 0) {\n        throttleHandle = createThrottled(handler, options.throttle)\n        listener.throttledHandler = throttleHandle.fn\n      }\n\n      listeners.get(event as string)!.add(listener)\n\n      // Return unsubscribe function — cancels pending throttle timers\n      return () => {\n        throttleHandle?.cancel()\n        listeners.get(event as string)?.delete(listener)\n      }\n    },\n\n    emit(event, ...args) {\n      const set = listeners.get(event as string)\n      if (!set) return\n\n      for (const listener of set) {\n        // StreamKey filtering: skip if listener wants a specific streamKey\n        // For most events args[0] has streamKey; for onCustomEvent args[1] has it\n        if (listener.options?.streamKey) {\n          let streamKeyArg: unknown\n          for (const arg of args) {\n            if (arg && typeof arg === 'object' && 'streamKey' in (arg as any)) {\n              streamKeyArg = (arg as any).streamKey\n              break\n            }\n          }\n          if (streamKeyArg !== undefined && streamKeyArg !== listener.options.streamKey) continue\n        }\n\n        const fn = listener.throttledHandler || listener.handler\n        try {\n          fn(...args)\n        } catch (err) {\n          console.error(`[ChatBus] Error in ${event as string} handler:`, err)\n        }\n      }\n    },\n\n    clear() {\n      listeners.clear()\n    },\n  } as ChatEventEmitter\n}\n\n// ─── Command Handler ─────────────────────────────────────────\n\n/**\n * Create a typed command handler. The host app registers handlers,\n * agents execute commands.\n *\n * @experimental\n *\n * @example\n * const commands = createCommandHandler<ChatCommands>()\n * commands.handle('injectPrompt', (text) => setInputValue(text))\n * commands.exec('injectPrompt', 'Hello world')\n */\nexport function createCommandHandler(): ChatCommandHandler {\n  const handlers = new Map<string, (...args: any[]) => any>()\n\n  return {\n    handle(command, handler) {\n      handlers.set(command as string, handler)\n    },\n\n    exec(command, ...args) {\n      const handler = handlers.get(command as string)\n      if (!handler) {\n        console.warn(`[ChatBus] No handler registered for command: ${command as string}`)\n        return undefined as any\n      }\n      return handler(...args)\n    },\n  } as ChatCommandHandler\n}\n\n// ─── Chat Bus Factory ────────────────────────────────────────\n\n/**\n * Create a complete ChatBus with events + commands.\n *\n * @experimental\n *\n * @example\n * const bus = createChatBus()\n * bus.events.on('onStreamEnd', (event) => { ... })\n * bus.commands.handle('sendPrompt', (text) => { ... })\n */\nexport function createChatBus(): ChatBus {\n  return {\n    events: createEventEmitter(),\n    commands: createCommandHandler(),\n  }\n}\n\n// ─── Scratchpad Section Merge Helper ─────────────────────────\n\n/**\n * Merge sections from a ScratchpadEvent into existing state sections.\n * Handles replace/append/upsert modes.\n *\n * @example\n * const newSections = mergeScratchpadSections(\n *   currentState.sections,\n *   event.sections,\n *   event.sectionMode\n * )\n */\nexport function mergeScratchpadSections(\n  existing: ScratchpadSection[],\n  incoming: ScratchpadSection[] | undefined,\n  mode: 'replace' | 'append' | 'upsert' = 'replace'\n): ScratchpadSection[] {\n  if (!incoming) return existing\n\n  switch (mode) {\n    case 'append':\n      return [...existing, ...incoming]\n\n    case 'upsert': {\n      const result = [...existing]\n      for (const section of incoming) {\n        const idx = result.findIndex((s) => s.id === section.id)\n        if (idx >= 0) {\n          result[idx] = section\n        } else {\n          result.push(section)\n        }\n      }\n      return result\n    }\n\n    case 'replace':\n    default:\n      return incoming\n  }\n}\n\n// ─── Clarification → Prompt Helper (v4.3.9) ──────────────────\n\n/**\n * Convert a ClarificationEvent into a ChatPromptConfig.\n * Universal bridge for apps receiving clarification events via SSE.\n *\n * Legacy runtime `file_id` (removed from the type in v5.0.0) is still\n * transparently migrated into `metadata.file_id` when present, so payloads\n * from older servers continue to work without upgrade pressure.\n *\n * @experimental\n * @since v4.3.9\n * @example\n * bus.events.on('onClarificationNeeded', ({ clarification }) => {\n *   bus.commands.exec('showChatPrompt', clarificationToPromptConfig(clarification))\n * })\n */\nexport function clarificationToPromptConfig(\n  event: ClarificationEvent\n): ChatPromptConfig {\n  return {\n    type: 'choice',\n    title: event.question,\n    config: {\n      options: event.options.map((opt) => {\n        const merged: Record<string, unknown> = { ...(opt.metadata ?? {}) }\n        // Runtime fallback for legacy payloads that still carry file_id at the top level.\n        const legacyFileId = (opt as { file_id?: number }).file_id\n        if (legacyFileId !== undefined && merged.file_id === undefined) {\n          merged.file_id = legacyFileId\n        }\n        return {\n          value: opt.value,\n          label: opt.label,\n          // Only include metadata if non-empty (keeps payloads clean)\n          ...(Object.keys(merged).length > 0 ? { metadata: merged } : {}),\n        }\n      }),\n      layout: 'vertical',\n    },\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-bus.js","sources":["../../src/services/chat-bus.ts"],"sourcesContent":["/**\n * Chat Bus — Event Emitter + Command Handler\n * v2.4.0: Core primitives for the chat event/command bus\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport type {\n  ChatEvents,\n  ChatCommands,\n  ChatEventEmitter,\n  ChatCommandHandler,\n  ChatBus,\n  EventSubscribeOptions,\n  ScratchpadSection,\n  ClarificationEvent,\n  ElicitationEvent,\n  ElicitationPropertySchema,\n  ChatPromptConfig,\n  FormPromptConfig,\n} from '../types/chat-bus'\n\n// ─── Event Emitter ───────────────────────────────────────────\n\ninterface Listener<F extends (...args: any[]) => any> {\n  handler: F\n  options?: EventSubscribeOptions\n  throttledHandler?: F\n}\n\n/**\n * Create a typed event emitter with throttle and streamKey filtering support.\n *\n * @experimental\n *\n * @example\n * const emitter = createEventEmitter<ChatEvents>()\n * const unsub = emitter.on('onToken', (event) => console.log(event.token), { throttle: 100 })\n * emitter.emit('onToken', { streamKey: 'abc', token: 'hello' })\n * unsub()\n */\nexport function createEventEmitter(): ChatEventEmitter {\n  const listeners = new Map<string, Set<Listener<any>>>()\n\n  interface ThrottledFn<F> {\n    fn: F\n    cancel: () => void\n  }\n\n  function createThrottled<F extends (...args: any[]) => void>(fn: F, ms: number): ThrottledFn<F> {\n    let lastCall = 0\n    let timer: ReturnType<typeof setTimeout> | null = null\n    let lastArgs: any[] | null = null\n    let cancelled = false\n\n    const throttled = ((...args: any[]) => {\n      if (cancelled) return\n      lastArgs = args\n      const now = Date.now()\n      const remaining = ms - (now - lastCall)\n\n      if (remaining <= 0) {\n        if (timer) { clearTimeout(timer); timer = null }\n        lastCall = now\n        fn(...args)\n      } else if (!timer) {\n        timer = setTimeout(() => {\n          lastCall = Date.now()\n          timer = null\n          if (lastArgs && !cancelled) {\n            try { fn(...lastArgs) } catch (err) { console.error('[ChatBus] Error in throttled handler:', err) }\n          }\n        }, remaining)\n      }\n    }) as F\n\n    return {\n      fn: throttled,\n      cancel: () => { cancelled = true; if (timer) { clearTimeout(timer); timer = null } },\n    }\n  }\n\n  return {\n    on(event, handler, options) {\n      if (!listeners.has(event as string)) {\n        listeners.set(event as string, new Set())\n      }\n\n      const listener: Listener<typeof handler> = { handler, options }\n\n      // Apply throttle if requested\n      let throttleHandle: ThrottledFn<typeof handler> | null = null\n      if (options?.throttle && options.throttle > 0) {\n        throttleHandle = createThrottled(handler, options.throttle)\n        listener.throttledHandler = throttleHandle.fn\n      }\n\n      listeners.get(event as string)!.add(listener)\n\n      // Return unsubscribe function — cancels pending throttle timers\n      return () => {\n        throttleHandle?.cancel()\n        listeners.get(event as string)?.delete(listener)\n      }\n    },\n\n    emit(event, ...args) {\n      const set = listeners.get(event as string)\n      if (!set) return\n\n      for (const listener of set) {\n        // StreamKey filtering: skip if listener wants a specific streamKey\n        // For most events args[0] has streamKey; for onCustomEvent args[1] has it\n        if (listener.options?.streamKey) {\n          let streamKeyArg: unknown\n          for (const arg of args) {\n            if (arg && typeof arg === 'object' && 'streamKey' in (arg as any)) {\n              streamKeyArg = (arg as any).streamKey\n              break\n            }\n          }\n          if (streamKeyArg !== undefined && streamKeyArg !== listener.options.streamKey) continue\n        }\n\n        const fn = listener.throttledHandler || listener.handler\n        try {\n          fn(...args)\n        } catch (err) {\n          console.error(`[ChatBus] Error in ${event as string} handler:`, err)\n        }\n      }\n    },\n\n    clear() {\n      listeners.clear()\n    },\n  } as ChatEventEmitter\n}\n\n// ─── Command Handler ─────────────────────────────────────────\n\n/**\n * Create a typed command handler. The host app registers handlers,\n * agents execute commands.\n *\n * @experimental\n *\n * @example\n * const commands = createCommandHandler<ChatCommands>()\n * commands.handle('injectPrompt', (text) => setInputValue(text))\n * commands.exec('injectPrompt', 'Hello world')\n */\nexport function createCommandHandler(): ChatCommandHandler {\n  const handlers = new Map<string, (...args: any[]) => any>()\n\n  return {\n    handle(command, handler) {\n      handlers.set(command as string, handler)\n    },\n\n    exec(command, ...args) {\n      const handler = handlers.get(command as string)\n      if (!handler) {\n        console.warn(`[ChatBus] No handler registered for command: ${command as string}`)\n        return undefined as any\n      }\n      return handler(...args)\n    },\n  } as ChatCommandHandler\n}\n\n// ─── Chat Bus Factory ────────────────────────────────────────\n\n/**\n * Create a complete ChatBus with events + commands.\n *\n * @experimental\n *\n * @example\n * const bus = createChatBus()\n * bus.events.on('onStreamEnd', (event) => { ... })\n * bus.commands.handle('sendPrompt', (text) => { ... })\n */\nexport function createChatBus(): ChatBus {\n  return {\n    events: createEventEmitter(),\n    commands: createCommandHandler(),\n  }\n}\n\n// ─── Scratchpad Section Merge Helper ─────────────────────────\n\n/**\n * Merge sections from a ScratchpadEvent into existing state sections.\n * Handles replace/append/upsert modes.\n *\n * @example\n * const newSections = mergeScratchpadSections(\n *   currentState.sections,\n *   event.sections,\n *   event.sectionMode\n * )\n */\nexport function mergeScratchpadSections(\n  existing: ScratchpadSection[],\n  incoming: ScratchpadSection[] | undefined,\n  mode: 'replace' | 'append' | 'upsert' = 'replace'\n): ScratchpadSection[] {\n  if (!incoming) return existing\n\n  switch (mode) {\n    case 'append':\n      return [...existing, ...incoming]\n\n    case 'upsert': {\n      const result = [...existing]\n      for (const section of incoming) {\n        const idx = result.findIndex((s) => s.id === section.id)\n        if (idx >= 0) {\n          result[idx] = section\n        } else {\n          result.push(section)\n        }\n      }\n      return result\n    }\n\n    case 'replace':\n    default:\n      return incoming\n  }\n}\n\n// ─── Clarification → Prompt Helper (v4.3.9) ──────────────────\n\n/**\n * Convert a ClarificationEvent into a ChatPromptConfig.\n * Universal bridge for apps receiving clarification events via SSE.\n *\n * Legacy runtime `file_id` (removed from the type in v5.0.0) is still\n * transparently migrated into `metadata.file_id` when present, so payloads\n * from older servers continue to work without upgrade pressure.\n *\n * @experimental\n * @since v4.3.9\n * @example\n * bus.events.on('onClarificationNeeded', ({ clarification }) => {\n *   bus.commands.exec('showChatPrompt', clarificationToPromptConfig(clarification))\n * })\n */\n// ─── Elicitation → Prompt Helper (v5.2.0) ───────────────────\n\n/**\n * Convert an MCP `elicitation/create` payload into a `ChatPromptConfig`.\n *\n * Mapping rules :\n * - Single `boolean` property → `type: 'confirm'`\n * - Single property with `enum` of ≤4 values → `type: 'choice'` (one option per enum value)\n * - Anything else → `type: 'form'` with one field per schema property\n *\n * JSON Schema primitive types map to mcp-ui form field types :\n *\n * | JSON Schema | mcp-ui FormFieldType |\n * |---|---|\n * | `type: 'string'` | `'text'` |\n * | `type: 'string', format: 'email'` | `'email'` |\n * | `type: 'string', format: 'date'` or `'date-time'` | `'date'` |\n * | `type: 'string', enum: [...]` | `'select'` |\n * | `type: 'number' \\| 'integer'` | `'number'` |\n * | `type: 'boolean'` | `'checkbox'` |\n *\n * Unknown shapes fall through to plain text with a `helpText` warning.\n *\n * @experimental\n * @since v5.2.0\n *\n * @example\n * bus.events.on('onElicitation', ({ elicitation }) => {\n *   bus.commands.exec('showChatPrompt', elicitationToPromptConfig(elicitation))\n * })\n */\nexport function elicitationToPromptConfig(event: ElicitationEvent): ChatPromptConfig {\n  const propEntries = Object.entries(event.requestedSchema.properties)\n\n  // Shortcut 1 : single boolean → confirm\n  if (propEntries.length === 1 && propEntries[0][1].type === 'boolean') {\n    return {\n      type: 'confirm',\n      title: event.message,\n      config: {\n        message: propEntries[0][1].description,\n      },\n    }\n  }\n\n  // Shortcut 2 : single enum property with ≤4 values → choice\n  if (propEntries.length === 1) {\n    const [, schema] = propEntries[0]\n    if (schema.enum && schema.enum.length > 0 && schema.enum.length <= 4) {\n      return {\n        type: 'choice',\n        title: event.message,\n        config: {\n          options: schema.enum.map((val, idx) => ({\n            value: String(val),\n            label: schema.enumNames?.[idx] ?? String(val),\n          })),\n          layout: 'vertical',\n        },\n      }\n    }\n  }\n\n  // Default : full form\n  const required = new Set(event.requestedSchema.required ?? [])\n  const fields: FormPromptConfig['fields'] = propEntries.map(([name, schema]) => ({\n    name,\n    label: schema.title ?? name,\n    ...schemaToFieldType(schema),\n    required: required.has(name),\n    helpText: schema.description,\n    ...(schema.default !== undefined ? { placeholder: String(schema.default) } : {}),\n  }))\n\n  return {\n    type: 'form',\n    title: event.message,\n    config: { fields },\n  }\n}\n\nfunction schemaToFieldType(\n  schema: ElicitationPropertySchema\n):\n  | { type: FormPromptConfig['fields'][number]['type']; options?: Array<{ label: string; value: string }> }\n  | { type: FormPromptConfig['fields'][number]['type']; helpText?: string } {\n  // Enum → select\n  if (schema.enum && schema.enum.length > 0) {\n    return {\n      type: 'select',\n      options: schema.enum.map((val, idx) => ({\n        label: schema.enumNames?.[idx] ?? String(val),\n        value: String(val),\n      })),\n    }\n  }\n\n  if (schema.type === 'boolean') return { type: 'checkbox' }\n  if (schema.type === 'number' || schema.type === 'integer') return { type: 'number' }\n  if (schema.type === 'string') {\n    if (schema.format === 'email') return { type: 'email' }\n    if (schema.format === 'date' || schema.format === 'date-time') return { type: 'date' }\n    return { type: 'text' }\n  }\n\n  // Unknown primitive — fall back to text with a warning\n  console.warn(\n    `[MCP-UI] elicitationToPromptConfig: unsupported schema type \"${(schema as { type?: string }).type}\", falling back to text.`\n  )\n  return { type: 'text' }\n}\n\nexport function clarificationToPromptConfig(\n  event: ClarificationEvent\n): ChatPromptConfig {\n  return {\n    type: 'choice',\n    title: event.question,\n    config: {\n      options: event.options.map((opt) => {\n        const merged: Record<string, unknown> = { ...(opt.metadata ?? {}) }\n        // Runtime fallback for legacy payloads that still carry file_id at the top level.\n        const legacyFileId = (opt as { file_id?: number }).file_id\n        if (legacyFileId !== undefined && merged.file_id === undefined) {\n          merged.file_id = legacyFileId\n        }\n        return {\n          value: opt.value,\n          label: opt.label,\n          // Only include metadata if non-empty (keeps payloads clean)\n          ...(Object.keys(merged).length > 0 ? { metadata: merged } : {}),\n        }\n      }),\n      layout: 'vertical',\n    },\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/services/chat-prompt-controller.cjs

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const solidJs = require("solid-js");
+class PromptReplacedError extends Error {
+  constructor(message = "Prompt replaced by a newer one") {
+    super(message);
+    __publicField(this, "name", "PromptReplacedError");
+  }
+}
+function createChatPromptController() {
+  const [activePrompt, setActivePrompt] = solidJs.createSignal(null);
+  let pending = null;
+  function cleanupAbort(entry) {
+    if (entry.signal && entry.onAbort) {
+      entry.signal.removeEventListener("abort", entry.onAbort);
+    }
+  }
+  function handle(config, signal) {
+    if (pending) {
+      const previous = pending;
+      pending = null;
+      cleanupAbort(previous);
+      previous.reject(new PromptReplacedError());
+    }
+    if (signal == null ? void 0 : signal.aborted) {
+      setActivePrompt(null);
+      return Promise.reject(new DOMException("Prompt aborted", "AbortError"));
+    }
+    return new Promise((resolve, reject) => {
+      const entry = { type: config.type, resolve, reject, signal };
+      if (signal) {
+        entry.onAbort = () => {
+          if (pending === entry) {
+            pending = null;
+            cleanupAbort(entry);
+            setActivePrompt(null);
+            reject(new DOMException("Prompt aborted", "AbortError"));
+          }
+        };
+        signal.addEventListener("abort", entry.onAbort, { once: true });
+      }
+      pending = entry;
+      setActivePrompt(config);
+    });
+  }
+  function resolveActive(response) {
+    if (!pending) return;
+    const entry = pending;
+    pending = null;
+    cleanupAbort(entry);
+    setActivePrompt(null);
+    entry.resolve(response);
+  }
+  function dismissActive() {
+    if (!pending) return;
+    const entry = pending;
+    pending = null;
+    cleanupAbort(entry);
+    setActivePrompt(null);
+    entry.resolve({ type: entry.type, value: "", label: "", dismissed: true });
+  }
+  function abort(reason = "Prompt aborted") {
+    if (!pending) return;
+    const entry = pending;
+    pending = null;
+    cleanupAbort(entry);
+    setActivePrompt(null);
+    entry.reject(new DOMException(reason, "AbortError"));
+  }
+  return {
+    handle,
+    activePrompt,
+    resolveActive,
+    dismissActive,
+    abort
+  };
+}
+exports.PromptReplacedError = PromptReplacedError;
+exports.createChatPromptController = createChatPromptController;
+//# sourceMappingURL=chat-prompt-controller.cjs.map

package/dist/services/chat-prompt-controller.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-prompt-controller.cjs","sources":["../../src/services/chat-prompt-controller.ts"],"sourcesContent":["/**\n * createChatPromptController — centralised lifecycle for `showChatPrompt`\n *\n * @experimental\n * @since v5.2.0\n *\n * The controller owns the resolver closure, AbortSignal wiring, and\n * re-entrance policy in one primitive. Consumers go from ~20 LOC of manual\n * wiring per app to :\n *\n * ```ts\n * const ctrl = createChatPromptController()\n * bus.commands.handle('showChatPrompt', ctrl.handle)\n * // ...\n * <Show when={ctrl.activePrompt()}>\n *   {(cfg) => (\n *     <ChatPrompt\n *       config={cfg()}\n *       onSubmit={ctrl.resolveActive}\n *       onDismiss={ctrl.dismissActive}\n *     />\n *   )}\n * </Show>\n * ```\n *\n * ## Re-entrance policy\n *\n * If a new `showChatPrompt` arrives while a previous Promise is still\n * pending, the previous Promise rejects **synchronously** with a\n * `PromptReplacedError` before the new prompt is installed. Callers that\n * care can branch on `err instanceof PromptReplacedError` or `err.name ===\n * 'PromptReplacedError'`.\n *\n * ## Abort semantics\n *\n * `handle(config, signal?)` honours `AbortSignal` :\n *\n * - If `signal.aborted === true` on entry → returns a rejected Promise with\n *   `new DOMException('Prompt aborted', 'AbortError')`, does NOT set\n *   `activePrompt`.\n * - Otherwise registers a once-only listener that rejects with the same\n *   `DOMException` on abort, clearing the active state.\n *\n * `AbortError` is the Web Platform convention (matches `fetch()`,\n * `Response.body.cancel()`, etc.) — callers can branch on `err.name ===\n * 'AbortError'` without importing any mcp-ui type.\n */\n\nimport { createSignal, type Accessor } from 'solid-js'\nimport type { ChatPromptConfig, ChatPromptResponse } from '../types/chat-bus'\n\n// ─── Error class ─────────────────────────────────────────────\n\n/**\n * Thrown when an active `showChatPrompt` Promise is rejected because a new\n * prompt arrived before the previous one resolved. Consumers can use\n * `instanceof PromptReplacedError` or `err.name === 'PromptReplacedError'` to\n * branch (retry, bail, log).\n *\n * @experimental\n * @since v5.2.0\n */\nexport class PromptReplacedError extends Error {\n  readonly name = 'PromptReplacedError' as const\n  constructor(message = 'Prompt replaced by a newer one') {\n    super(message)\n  }\n}\n\n// ─── Controller shape ────────────────────────────────────────\n\nexport interface ChatPromptController {\n  /**\n   * Register as the bus handler :\n   * `bus.commands.handle('showChatPrompt', ctrl.handle)`\n   */\n  handle: (config: ChatPromptConfig, signal?: AbortSignal) => Promise<ChatPromptResponse>\n\n  /**\n   * Reactive accessor for the currently active prompt config (null when no\n   * prompt is pending). Use in JSX to drive `<ChatPrompt>` rendering.\n   */\n  activePrompt: Accessor<ChatPromptConfig | null>\n\n  /** Call this from `<ChatPrompt>`'s `onSubmit` prop. */\n  resolveActive: (response: ChatPromptResponse) => void\n\n  /** Call this from `<ChatPrompt>`'s `onDismiss` prop. */\n  dismissActive: () => void\n\n  /**\n   * Cancel the active prompt programmatically (e.g. on route change). Rejects\n   * the pending Promise with the supplied reason or an `AbortError`.\n   */\n  abort: (reason?: string) => void\n}\n\n// ─── Factory ─────────────────────────────────────────────────\n\n/**\n * Create a stateful controller that owns the active prompt Promise, the\n * AbortSignal listener, and the re-entrance policy. See module JSDoc for\n * full usage.\n *\n * @experimental\n * @since v5.2.0\n */\nexport function createChatPromptController(): ChatPromptController {\n  const [activePrompt, setActivePrompt] = createSignal<ChatPromptConfig | null>(null)\n\n  interface PendingEntry {\n    type: ChatPromptConfig['type']\n    resolve: (r: ChatPromptResponse) => void\n    reject: (err: unknown) => void\n    signal?: AbortSignal\n    onAbort?: () => void\n  }\n\n  let pending: PendingEntry | null = null\n\n  function cleanupAbort(entry: PendingEntry): void {\n    if (entry.signal && entry.onAbort) {\n      entry.signal.removeEventListener('abort', entry.onAbort)\n    }\n  }\n\n  function clearPending(): void {\n    if (pending) {\n      cleanupAbort(pending)\n      pending = null\n    }\n    setActivePrompt(null)\n  }\n\n  function handle(\n    config: ChatPromptConfig,\n    signal?: AbortSignal\n  ): Promise<ChatPromptResponse> {\n    // Re-entrance : synchronously reject the previous Promise before\n    // installing the new prompt. The caller's .catch sees the rejection\n    // on the microtask boundary regardless.\n    if (pending) {\n      const previous = pending\n      pending = null\n      cleanupAbort(previous)\n      previous.reject(new PromptReplacedError())\n    }\n\n    // Abort already tripped on entry : return a rejected Promise without\n    // ever showing the UI.\n    if (signal?.aborted) {\n      setActivePrompt(null)\n      return Promise.reject(new DOMException('Prompt aborted', 'AbortError'))\n    }\n\n    return new Promise<ChatPromptResponse>((resolve, reject) => {\n      const entry: PendingEntry = { type: config.type, resolve, reject, signal }\n\n      if (signal) {\n        entry.onAbort = () => {\n          // If this entry is still active, reject + clear. If a newer prompt\n          // has since replaced it, the cleanup already ran — no-op.\n          if (pending === entry) {\n            pending = null\n            cleanupAbort(entry)\n            setActivePrompt(null)\n            reject(new DOMException('Prompt aborted', 'AbortError'))\n          }\n        }\n        signal.addEventListener('abort', entry.onAbort, { once: true })\n      }\n\n      pending = entry\n      setActivePrompt(config)\n    })\n  }\n\n  function resolveActive(response: ChatPromptResponse): void {\n    if (!pending) return\n    const entry = pending\n    pending = null\n    cleanupAbort(entry)\n    setActivePrompt(null)\n    entry.resolve(response)\n  }\n\n  function dismissActive(): void {\n    if (!pending) return\n    const entry = pending\n    pending = null\n    cleanupAbort(entry)\n    setActivePrompt(null)\n    // Surface as a resolved Promise with dismissed: true — matches existing\n    // ChatPrompt onDismiss contract from v4.x.\n    entry.resolve({ type: entry.type, value: '', label: '', dismissed: true })\n  }\n\n  function abort(reason = 'Prompt aborted'): void {\n    if (!pending) return\n    const entry = pending\n    pending = null\n    cleanupAbort(entry)\n    setActivePrompt(null)\n    entry.reject(new DOMException(reason, 'AbortError'))\n  }\n\n  return {\n    handle,\n    activePrompt,\n    resolveActive,\n    dismissActive,\n    abort,\n  }\n}\n"],"names":["createSignal"],"mappings":";;;;;;AA8DO,MAAM,4BAA4B,MAAM;AAAA,EAE7C,YAAY,UAAU,kCAAkC;AACtD,UAAM,OAAO;AAFN,gCAAO;AAAA,EAGhB;AACF;AAwCO,SAAS,6BAAmD;AACjE,QAAM,CAAC,cAAc,eAAe,IAAIA,QAAAA,aAAsC,IAAI;AAUlF,MAAI,UAA+B;AAEnC,WAAS,aAAa,OAA2B;AAC/C,QAAI,MAAM,UAAU,MAAM,SAAS;AACjC,YAAM,OAAO,oBAAoB,SAAS,MAAM,OAAO;AAAA,IACzD;AAAA,EACF;AAUA,WAAS,OACP,QACA,QAC6B;AAI7B,QAAI,SAAS;AACX,YAAM,WAAW;AACjB,gBAAU;AACV,mBAAa,QAAQ;AACrB,eAAS,OAAO,IAAI,qBAAqB;AAAA,IAC3C;AAIA,QAAI,iCAAQ,SAAS;AACnB,sBAAgB,IAAI;AACpB,aAAO,QAAQ,OAAO,IAAI,aAAa,kBAAkB,YAAY,CAAC;AAAA,IACxE;AAEA,WAAO,IAAI,QAA4B,CAAC,SAAS,WAAW;AAC1D,YAAM,QAAsB,EAAE,MAAM,OAAO,MAAM,SAAS,QAAQ,OAAA;AAElE,UAAI,QAAQ;AACV,cAAM,UAAU,MAAM;AAGpB,cAAI,YAAY,OAAO;AACrB,sBAAU;AACV,yBAAa,KAAK;AAClB,4BAAgB,IAAI;AACpB,mBAAO,IAAI,aAAa,kBAAkB,YAAY,CAAC;AAAA,UACzD;AAAA,QACF;AACA,eAAO,iBAAiB,SAAS,MAAM,SAAS,EAAE,MAAM,MAAM;AAAA,MAChE;AAEA,gBAAU;AACV,sBAAgB,MAAM;AAAA,IACxB,CAAC;AAAA,EACH;AAEA,WAAS,cAAc,UAAoC;AACzD,QAAI,CAAC,QAAS;AACd,UAAM,QAAQ;AACd,cAAU;AACV,iBAAa,KAAK;AAClB,oBAAgB,IAAI;AACpB,UAAM,QAAQ,QAAQ;AAAA,EACxB;AAEA,WAAS,gBAAsB;AAC7B,QAAI,CAAC,QAAS;AACd,UAAM,QAAQ;AACd,cAAU;AACV,iBAAa,KAAK;AAClB,oBAAgB,IAAI;AAGpB,UAAM,QAAQ,EAAE,MAAM,MAAM,MAAM,OAAO,IAAI,OAAO,IAAI,WAAW,KAAA,CAAM;AAAA,EAC3E;AAEA,WAAS,MAAM,SAAS,kBAAwB;AAC9C,QAAI,CAAC,QAAS;AACd,UAAM,QAAQ;AACd,cAAU;AACV,iBAAa,KAAK;AAClB,oBAAgB,IAAI;AACpB,UAAM,OAAO,IAAI,aAAa,QAAQ,YAAY,CAAC;AAAA,EACrD;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;;"}

package/dist/services/chat-prompt-controller.d.ts

@@ -0,0 +1,93 @@
+/**
+ * createChatPromptController — centralised lifecycle for `showChatPrompt`
+ *
+ * @experimental
+ * @since v5.2.0
+ *
+ * The controller owns the resolver closure, AbortSignal wiring, and
+ * re-entrance policy in one primitive. Consumers go from ~20 LOC of manual
+ * wiring per app to :
+ *
+ * ```ts
+ * const ctrl = createChatPromptController()
+ * bus.commands.handle('showChatPrompt', ctrl.handle)
+ * // ...
+ * <Show when={ctrl.activePrompt()}>
+ *   {(cfg) => (
+ *     <ChatPrompt
+ *       config={cfg()}
+ *       onSubmit={ctrl.resolveActive}
+ *       onDismiss={ctrl.dismissActive}
+ *     />
+ *   )}
+ * </Show>
+ * ```
+ *
+ * ## Re-entrance policy
+ *
+ * If a new `showChatPrompt` arrives while a previous Promise is still
+ * pending, the previous Promise rejects **synchronously** with a
+ * `PromptReplacedError` before the new prompt is installed. Callers that
+ * care can branch on `err instanceof PromptReplacedError` or `err.name ===
+ * 'PromptReplacedError'`.
+ *
+ * ## Abort semantics
+ *
+ * `handle(config, signal?)` honours `AbortSignal` :
+ *
+ * - If `signal.aborted === true` on entry → returns a rejected Promise with
+ *   `new DOMException('Prompt aborted', 'AbortError')`, does NOT set
+ *   `activePrompt`.
+ * - Otherwise registers a once-only listener that rejects with the same
+ *   `DOMException` on abort, clearing the active state.
+ *
+ * `AbortError` is the Web Platform convention (matches `fetch()`,
+ * `Response.body.cancel()`, etc.) — callers can branch on `err.name ===
+ * 'AbortError'` without importing any mcp-ui type.
+ */
+import { type Accessor } from 'solid-js';
+import type { ChatPromptConfig, ChatPromptResponse } from '../types/chat-bus';
+/**
+ * Thrown when an active `showChatPrompt` Promise is rejected because a new
+ * prompt arrived before the previous one resolved. Consumers can use
+ * `instanceof PromptReplacedError` or `err.name === 'PromptReplacedError'` to
+ * branch (retry, bail, log).
+ *
+ * @experimental
+ * @since v5.2.0
+ */
+export declare class PromptReplacedError extends Error {
+    readonly name: "PromptReplacedError";
+    constructor(message?: string);
+}
+export interface ChatPromptController {
+    /**
+     * Register as the bus handler :
+     * `bus.commands.handle('showChatPrompt', ctrl.handle)`
+     */
+    handle: (config: ChatPromptConfig, signal?: AbortSignal) => Promise<ChatPromptResponse>;
+    /**
+     * Reactive accessor for the currently active prompt config (null when no
+     * prompt is pending). Use in JSX to drive `<ChatPrompt>` rendering.
+     */
+    activePrompt: Accessor<ChatPromptConfig | null>;
+    /** Call this from `<ChatPrompt>`'s `onSubmit` prop. */
+    resolveActive: (response: ChatPromptResponse) => void;
+    /** Call this from `<ChatPrompt>`'s `onDismiss` prop. */
+    dismissActive: () => void;
+    /**
+     * Cancel the active prompt programmatically (e.g. on route change). Rejects
+     * the pending Promise with the supplied reason or an `AbortError`.
+     */
+    abort: (reason?: string) => void;
+}
+/**
+ * Create a stateful controller that owns the active prompt Promise, the
+ * AbortSignal listener, and the re-entrance policy. See module JSDoc for
+ * full usage.
+ *
+ * @experimental
+ * @since v5.2.0
+ */
+export declare function createChatPromptController(): ChatPromptController;
+//# sourceMappingURL=chat-prompt-controller.d.ts.map

package/dist/services/chat-prompt-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-prompt-controller.d.ts","sourceRoot":"","sources":["../../src/services/chat-prompt-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAI7E;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAS;gBAClC,OAAO,SAAmC;CAGvD;AAID,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAEvF;;;OAGG;IACH,YAAY,EAAE,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAE/C,uDAAuD;IACvD,aAAa,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAErD,wDAAwD;IACxD,aAAa,EAAE,MAAM,IAAI,CAAA;IAEzB;;;OAGG;IACH,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAID;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,oBAAoB,CA0GjE"}

package/dist/services/chat-prompt-controller.js

@@ -0,0 +1,83 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { createSignal } from "solid-js";
+class PromptReplacedError extends Error {
+  constructor(message = "Prompt replaced by a newer one") {
+    super(message);
+    __publicField(this, "name", "PromptReplacedError");
+  }
+}
+function createChatPromptController() {
+  const [activePrompt, setActivePrompt] = createSignal(null);
+  let pending = null;
+  function cleanupAbort(entry) {
+    if (entry.signal && entry.onAbort) {
+      entry.signal.removeEventListener("abort", entry.onAbort);
+    }
+  }
+  function handle(config, signal) {
+    if (pending) {
+      const previous = pending;
+      pending = null;
+      cleanupAbort(previous);
+      previous.reject(new PromptReplacedError());
+    }
+    if (signal == null ? void 0 : signal.aborted) {
+      setActivePrompt(null);
+      return Promise.reject(new DOMException("Prompt aborted", "AbortError"));
+    }
+    return new Promise((resolve, reject) => {
+      const entry = { type: config.type, resolve, reject, signal };
+      if (signal) {
+        entry.onAbort = () => {
+          if (pending === entry) {
+            pending = null;
+            cleanupAbort(entry);
+            setActivePrompt(null);
+            reject(new DOMException("Prompt aborted", "AbortError"));
+          }
+        };
+        signal.addEventListener("abort", entry.onAbort, { once: true });
+      }
+      pending = entry;
+      setActivePrompt(config);
+    });
+  }
+  function resolveActive(response) {
+    if (!pending) return;
+    const entry = pending;
+    pending = null;
+    cleanupAbort(entry);
+    setActivePrompt(null);
+    entry.resolve(response);
+  }
+  function dismissActive() {
+    if (!pending) return;
+    const entry = pending;
+    pending = null;
+    cleanupAbort(entry);
+    setActivePrompt(null);
+    entry.resolve({ type: entry.type, value: "", label: "", dismissed: true });
+  }
+  function abort(reason = "Prompt aborted") {
+    if (!pending) return;
+    const entry = pending;
+    pending = null;
+    cleanupAbort(entry);
+    setActivePrompt(null);
+    entry.reject(new DOMException(reason, "AbortError"));
+  }
+  return {
+    handle,
+    activePrompt,
+    resolveActive,
+    dismissActive,
+    abort
+  };
+}
+export {
+  PromptReplacedError,
+  createChatPromptController
+};
+//# sourceMappingURL=chat-prompt-controller.js.map