@seed-ship/mcp-ui-solid 2.2.11 → 2.4.0

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

@@ -0,0 +1,286 @@
+/**
+ * Chat Bus — Type Definitions
+ * v2.4.0: Event-driven chat toolkit for agent interactions
+ *
+ * @experimental — These types may change without major bump until stabilized in v2.5.0.
+ * See CHANGELOG for breaking changes on experimental types.
+ */
+import type { UIComponent, UILayout } from './index';
+/**
+ * @experimental
+ * Base for all chat events — identifies the source stream (C2).
+ * Enables multi-stream support (Deposium supports 3 concurrent streams).
+ */
+export interface ChatEventBase {
+    /** Unique key identifying the active stream */
+    streamKey: string;
+    /** Conversation ID (if available) */
+    conversationId?: string;
+    /** Space/context ID */
+    spaceId?: string;
+    /** Correlation ID linking a sendPrompt command to its resulting stream (C6) */
+    correlationId?: string;
+}
+/**
+ * @experimental
+ * Events emitted by the chat. The host app connects its SSE stream
+ * to these callbacks. Agents consume events to react.
+ *
+ * `onToken` is a hot path (C3) — subscribe with throttle option.
+ * Most agents only need `onStreamEnd`.
+ */
+export interface ChatEvents {
+    onToken: (event: ChatEventBase & {
+        token: string;
+    }) => void;
+    onStreamStart: (event: ChatEventBase) => void;
+    onStreamEnd: (event: ChatEventBase & {
+        metadata: StreamDoneMetadata;
+    }) => void;
+    onError: (event: ChatEventBase & {
+        error: ChatError;
+    }) => void;
+    onUILayout: (event: ChatEventBase & {
+        layout: UILayout;
+    }) => void;
+    onCitation: (event: ChatEventBase & {
+        citation: Citation;
+    }) => void;
+    onToolCall: (event: ChatEventBase & {
+        tool: ToolCallEvent;
+    }) => void;
+    onSuggestions: (event: ChatEventBase & {
+        items: string[];
+    }) => void;
+    onChatPromptResponse: (event: ChatEventBase & {
+        response: ChatPromptResponse;
+    }) => void;
+    onClarificationNeeded: (event: ChatEventBase & {
+        clarification: ClarificationEvent;
+    }) => void;
+    onAgentSwitch: (event: ChatEventBase & {
+        agent: AgentContext;
+    }) => void;
+    onBriefing: (event: ChatEventBase & {
+        briefing: BriefingEvent;
+    }) => void;
+    onCapabilityChange: (event: ChatEventBase & {
+        capabilities: string[];
+    }) => void;
+    onCustomEvent: (type: string, event: ChatEventBase & {
+        data: unknown;
+    }) => void;
+}
+/**
+ * @experimental
+ * Subscription options for event listeners (C3).
+ */
+export interface EventSubscribeOptions {
+    /** Throttle in ms — recommended 100ms for onToken */
+    throttle?: number;
+    /** Filter events by streamKey */
+    streamKey?: string;
+}
+/**
+ * @experimental
+ * Commands that agents send to the chat. The host app implements
+ * these commands on its UI (maps to existing signals).
+ */
+export interface ChatCommands {
+    /** Fill the input field without sending */
+    injectPrompt: (text: string) => void;
+    /** Fill the input and send immediately. Returns correlationId (C6). */
+    sendPrompt: (text: string, metadata?: Record<string, unknown>) => string;
+    /** Append text to the current input value */
+    appendPrompt: (text: string) => void;
+    /** Show a ChatPrompt (choice, confirm, form) above the input (C4) */
+    showChatPrompt: (config: ChatPromptConfig, signal?: AbortSignal) => Promise<ChatPromptResponse>;
+    /** Dismiss the active ChatPrompt */
+    dismissChatPrompt: () => void;
+    /** Show suggestion chips */
+    showSuggestions: (items: SuggestionItem[]) => void;
+    /** Toggle a connector on/off */
+    toggleConnector: (connectorId: string, enabled: boolean) => void;
+    /** Change the chat mode */
+    setMode: (mode: string) => void;
+    /** Scroll to a specific message */
+    scrollToMessage: (messageId: string) => void;
+    /** Show a notification in the chat context */
+    notify: (message: string, type?: 'info' | 'success' | 'warning' | 'error') => void;
+}
+/**
+ * @experimental
+ * The combined events + commands bus.
+ */
+export interface ChatBus {
+    events: ChatEventEmitter;
+    commands: ChatCommandHandler;
+}
+/**
+ * @experimental
+ * Typed event emitter for ChatEvents.
+ */
+export interface ChatEventEmitter {
+    /** Subscribe to an event */
+    on<K extends keyof ChatEvents>(event: K, handler: ChatEvents[K], options?: EventSubscribeOptions): () => void;
+    /** Emit an event to all subscribers */
+    emit<K extends keyof ChatEvents>(event: K, ...args: Parameters<ChatEvents[K]>): void;
+    /** Remove all listeners (cleanup) */
+    clear(): void;
+}
+/**
+ * @experimental
+ * Typed command handler for ChatCommands.
+ */
+export interface ChatCommandHandler {
+    /** Register a command handler (app-side) */
+    handle<K extends keyof ChatCommands>(command: K, handler: ChatCommands[K]): void;
+    /** Execute a command (agent-side) */
+    exec<K extends keyof ChatCommands>(command: K, ...args: Parameters<ChatCommands[K]>): ReturnType<ChatCommands[K]>;
+}
+/**
+ * @experimental
+ * Configuration for a ChatPrompt interaction.
+ */
+export interface ChatPromptConfig {
+    /** Prompt type */
+    type: 'choice' | 'confirm' | 'form' | 'select';
+    /** Title / question displayed */
+    title: string;
+    /** Type-specific configuration */
+    config: ChoicePromptConfig | ConfirmPromptConfig | FormPromptConfig | SelectPromptConfig;
+}
+export interface ChoicePromptConfig {
+    options: Array<{
+        value: string;
+        label: string;
+        icon?: string;
+        description?: string;
+    }>;
+    layout?: 'horizontal' | 'vertical' | 'grid';
+}
+export interface ConfirmPromptConfig {
+    message?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    variant?: 'default' | 'danger';
+}
+export interface FormPromptConfig {
+    fields: Array<{
+        name: string;
+        label: string;
+        type: 'text' | 'number' | 'select' | 'textarea';
+        required?: boolean;
+        placeholder?: string;
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+    }>;
+    submitLabel?: string;
+}
+export interface SelectPromptConfig {
+    options: Array<{
+        value: string;
+        label: string;
+        group?: string;
+    }>;
+    placeholder?: string;
+    searchable?: boolean;
+}
+/**
+ * @experimental
+ * Structured response from a ChatPrompt.
+ */
+export interface ChatPromptResponse {
+    type: ChatPromptConfig['type'];
+    /** The selected value or form data */
+    value: string | Record<string, unknown>;
+    /** Human-readable label (for display in chat as user message) */
+    label: string;
+    /** Whether the user dismissed without answering */
+    dismissed?: boolean;
+}
+export interface SuggestionItem {
+    /** Text to inject when clicked */
+    text: string;
+    /** Display label (defaults to text) */
+    label?: string;
+    /** Icon */
+    icon?: string;
+}
+/**
+ * @experimental
+ * Agent context — who is the active agent?
+ */
+export interface AgentContext {
+    id: string;
+    name: string;
+    persona?: string;
+    avatar?: string;
+    capabilities?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * @experimental
+ * Briefing event — update the briefings tab.
+ */
+export interface BriefingEvent {
+    id: string;
+    action: 'create' | 'update' | 'complete' | 'archive';
+    title: string;
+    sections?: BriefingSection[];
+    status?: 'draft' | 'in_progress' | 'complete';
+    agent?: string;
+    components?: UIComponent[];
+    /** true = do not persist (tooltip, preview). false/absent = app decides storage. */
+    ephemeral?: boolean;
+}
+export interface BriefingSection {
+    title: string;
+    content: string;
+    components?: UIComponent[];
+}
+export interface StreamDoneMetadata {
+    message_hash?: string;
+    intent?: string;
+    model?: string;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    cost_usd?: number;
+    suggestions?: string[];
+    extracted_charts?: unknown[];
+    timing_breakdown?: Record<string, number>;
+    [key: string]: unknown;
+}
+export interface ChatError {
+    message: string;
+    code?: string;
+    recoverable?: boolean;
+}
+export interface Citation {
+    page?: number;
+    document_id?: string;
+    document_name?: string;
+    snippet?: string;
+    score?: number;
+}
+export interface ToolCallEvent {
+    tool: string;
+    status: 'running' | 'completed' | 'failed';
+    params?: Record<string, unknown>;
+    results?: unknown;
+    duration_ms?: number;
+}
+export interface ClarificationEvent {
+    question: string;
+    options: Array<{
+        value: string;
+        label: string;
+        file_id?: number;
+    }>;
+    original_message?: string;
+}
+//# sourceMappingURL=chat-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bus.d.ts","sourceRoot":"","sources":["../../src/types/chat-bus.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-ship/mcp-ui-solid",
-  "version": "2.2.11",
+  "version": "2.4.0",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "main": "./dist/index.cjs",

package/src/components/ChatPrompt.test.tsx

@@ -0,0 +1,280 @@
+/**
+ * Tests for ChatPrompt component
+ * Phase 2: choice, confirm, form subtypes
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { render, fireEvent, cleanup } from '@solidjs/testing-library'
+import { ChatPrompt } from './ChatPrompt'
+import type { ChatPromptConfig, ChatPromptResponse } from '../types/chat-bus'
+
+describe('ChatPrompt', () => {
+  beforeEach(() => cleanup())
+
+  // ─── Choice ──────────────────────────────────────────
+
+  describe('type: choice', () => {
+    const choiceConfig: ChatPromptConfig = {
+      type: 'choice',
+      title: 'Select format',
+      config: {
+        options: [
+          { value: 'pdf', label: 'PDF', icon: '📄' },
+          { value: 'csv', label: 'CSV' },
+          { value: 'json', label: 'JSON', description: 'Raw data' },
+        ],
+      },
+    }
+
+    it('renders title and all options', () => {
+      const { getByText } = render(() => (
+        <ChatPrompt config={choiceConfig} onSubmit={() => {}} />
+      ))
+
+      expect(getByText('Select format')).toBeDefined()
+      expect(getByText('PDF')).toBeDefined()
+      expect(getByText('CSV')).toBeDefined()
+      expect(getByText('JSON')).toBeDefined()
+    })
+
+    it('renders option icons and descriptions', () => {
+      const { getByText } = render(() => (
+        <ChatPrompt config={choiceConfig} onSubmit={() => {}} />
+      ))
+
+      expect(getByText('📄')).toBeDefined()
+      expect(getByText('Raw data')).toBeDefined()
+    })
+
+    it('calls onSubmit with value and label when option clicked', () => {
+      const onSubmit = vi.fn()
+      const { getByText } = render(() => (
+        <ChatPrompt config={choiceConfig} onSubmit={onSubmit} />
+      ))
+
+      fireEvent.click(getByText('CSV'))
+
+      expect(onSubmit).toHaveBeenCalledWith({
+        type: 'choice',
+        value: 'csv',
+        label: 'CSV',
+      })
+    })
+
+    it('supports vertical layout', () => {
+      const verticalConfig: ChatPromptConfig = {
+        ...choiceConfig,
+        config: { ...choiceConfig.config as any, layout: 'vertical' },
+      }
+      const { container } = render(() => (
+        <ChatPrompt config={verticalConfig} onSubmit={() => {}} />
+      ))
+
+      const body = container.querySelector('.flex-col')
+      expect(body).not.toBeNull()
+    })
+  })
+
+  // ─── Confirm ─────────────────────────────────────────
+
+  describe('type: confirm', () => {
+    const confirmConfig: ChatPromptConfig = {
+      type: 'confirm',
+      title: 'Delete 47 documents?',
+      config: {
+        message: 'This action cannot be undone.',
+        confirmLabel: 'Delete',
+        cancelLabel: 'Keep',
+        variant: 'danger',
+      },
+    }
+
+    it('renders title, message, and buttons', () => {
+      const { getByText } = render(() => (
+        <ChatPrompt config={confirmConfig} onSubmit={() => {}} />
+      ))
+
+      expect(getByText('Delete 47 documents?')).toBeDefined()
+      expect(getByText('This action cannot be undone.')).toBeDefined()
+      expect(getByText('Delete')).toBeDefined()
+      expect(getByText('Keep')).toBeDefined()
+    })
+
+    it('calls onSubmit with confirmed on confirm click', () => {
+      const onSubmit = vi.fn()
+      const { getByText } = render(() => (
+        <ChatPrompt config={confirmConfig} onSubmit={onSubmit} />
+      ))
+
+      fireEvent.click(getByText('Delete'))
+
+      expect(onSubmit).toHaveBeenCalledWith({
+        type: 'confirm',
+        value: 'confirmed',
+        label: 'Delete',
+      })
+    })
+
+    it('calls onSubmit with dismissed on cancel click', () => {
+      const onSubmit = vi.fn()
+      const onDismiss = vi.fn()
+      const { getByText } = render(() => (
+        <ChatPrompt config={confirmConfig} onSubmit={onSubmit} onDismiss={onDismiss} />
+      ))
+
+      fireEvent.click(getByText('Keep'))
+
+      expect(onSubmit).toHaveBeenCalledWith({
+        type: 'confirm',
+        value: 'cancelled',
+        label: 'Keep',
+        dismissed: true,
+      })
+      expect(onDismiss).toHaveBeenCalled()
+    })
+
+    it('uses default labels when not provided', () => {
+      const simpleConfig: ChatPromptConfig = {
+        type: 'confirm',
+        title: 'Are you sure?',
+        config: {},
+      }
+      const { getByText } = render(() => (
+        <ChatPrompt config={simpleConfig} onSubmit={() => {}} />
+      ))
+
+      expect(getByText('Confirm')).toBeDefined()
+      expect(getByText('Cancel')).toBeDefined()
+    })
+
+    it('uses danger styling for danger variant', () => {
+      const { getByText } = render(() => (
+        <ChatPrompt config={confirmConfig} onSubmit={() => {}} />
+      ))
+
+      const deleteBtn = getByText('Delete')
+      expect(deleteBtn.className).toContain('bg-red-600')
+    })
+  })
+
+  // ─── Form ────────────────────────────────────────────
+
+  describe('type: form', () => {
+    const formConfig: ChatPromptConfig = {
+      type: 'form',
+      title: 'Additional info',
+      config: {
+        fields: [
+          { name: 'title', label: 'Title', type: 'text', required: true, placeholder: 'Enter title' },
+          { name: 'category', label: 'Category', type: 'select', options: [{ label: 'Report', value: 'report' }, { label: 'Invoice', value: 'invoice' }] },
+          { name: 'notes', label: 'Notes', type: 'textarea' },
+        ],
+        submitLabel: 'Send',
+      },
+    }
+
+    it('renders all fields', () => {
+      const { getByText, getByPlaceholderText } = render(() => (
+        <ChatPrompt config={formConfig} onSubmit={() => {}} />
+      ))
+
+      expect(getByText('Title')).toBeDefined()
+      expect(getByText('Category')).toBeDefined()
+      expect(getByText('Notes')).toBeDefined()
+      expect(getByPlaceholderText('Enter title')).toBeDefined()
+    })
+
+    it('submit button is disabled when required fields empty', () => {
+      const { getByText } = render(() => (
+        <ChatPrompt config={formConfig} onSubmit={() => {}} />
+      ))
+
+      const submitBtn = getByText('Send')
+      expect(submitBtn.hasAttribute('disabled')).toBe(true)
+    })
+
+    it('submit button enables when required fields filled', async () => {
+      const { getByText, getByPlaceholderText } = render(() => (
+        <ChatPrompt config={formConfig} onSubmit={() => {}} />
+      ))
+
+      const titleInput = getByPlaceholderText('Enter title')
+      fireEvent.input(titleInput, { target: { value: 'My Report' } })
+
+      const submitBtn = getByText('Send')
+      expect(submitBtn.hasAttribute('disabled')).toBe(false)
+    })
+
+    it('calls onSubmit with form data on submit', async () => {
+      const onSubmit = vi.fn()
+      const { getByText, getByPlaceholderText } = render(() => (
+        <ChatPrompt config={formConfig} onSubmit={onSubmit} />
+      ))
+
+      fireEvent.input(getByPlaceholderText('Enter title'), { target: { value: 'Q4 Report' } })
+      fireEvent.click(getByText('Send'))
+
+      expect(onSubmit).toHaveBeenCalledWith({
+        type: 'form',
+        value: { title: 'Q4 Report' },
+        label: 'title: Q4 Report',
+      })
+    })
+
+    it('shows required indicator on required fields', () => {
+      const { container } = render(() => (
+        <ChatPrompt config={formConfig} onSubmit={() => {}} />
+      ))
+
+      const asterisks = container.querySelectorAll('.text-red-500')
+      expect(asterisks.length).toBeGreaterThan(0)
+    })
+  })
+
+  // ─── Dismiss ─────────────────────────────────────────
+
+  describe('dismiss', () => {
+    it('calls onSubmit with dismissed:true and onDismiss when X clicked', () => {
+      const onSubmit = vi.fn()
+      const onDismiss = vi.fn()
+      const config: ChatPromptConfig = {
+        type: 'choice',
+        title: 'Test',
+        config: { options: [{ value: 'a', label: 'A' }] },
+      }
+
+      const { getByLabelText } = render(() => (
+        <ChatPrompt config={config} onSubmit={onSubmit} onDismiss={onDismiss} />
+      ))
+
+      fireEvent.click(getByLabelText('Dismiss'))
+
+      expect(onDismiss).toHaveBeenCalled()
+      expect(onSubmit).toHaveBeenCalledWith({
+        type: 'choice',
+        value: '',
+        label: '',
+        dismissed: true,
+      })
+    })
+  })
+
+  // ─── Accessibility ───────────────────────────────────
+
+  describe('accessibility', () => {
+    it('has role="dialog" with title as label', () => {
+      const config: ChatPromptConfig = {
+        type: 'choice',
+        title: 'Pick one',
+        config: { options: [{ value: 'a', label: 'A' }] },
+      }
+
+      const { getByRole } = render(() => (
+        <ChatPrompt config={config} onSubmit={() => {}} />
+      ))
+
+      const dialog = getByRole('dialog')
+      expect(dialog.getAttribute('aria-label')).toBe('Pick one')
+    })
+  })
+})