@seed-ship/mcp-ui-solid 6.19.1 → 6.20.0

package/dist/hooks/useStreamingUI.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useStreamingUI.cjs","sources":["../../src/hooks/useStreamingUI.ts"],"sourcesContent":["/**\n * useStreamingUI Hook - Phase 2\n *\n * Client-side hook for consuming the streaming generative UI endpoint.\n * Handles SSE connection, component buffering, reordering, and error handling.\n *\n * Features:\n * - SSE connection with automatic reconnection\n * - Component buffering and reordering by sequenceId\n * - Progress tracking and loading states\n * - Error handling with recovery attempts\n * - Cleanup on unmount\n *\n * Usage:\n * ```tsx\n * const { components, isLoading, error, progress } = useStreamingUI({\n *   query: 'Show me revenue trends',\n *   spaceIds: ['uuid1', 'uuid2'],\n *   onComplete: (metadata) => console.log('Done!', metadata),\n * })\n * ```\n */\n\nimport { createSignal, onCleanup } from 'solid-js'\nimport type { UIComponent } from '../types'\nimport { createLogger } from '../utils/logger'\n\nconst logger = createLogger('useStreamingUI')\n\n// SSR detection without importing solid-js/web (which might cause bundler issues)\nconst isServer = typeof window === 'undefined'\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface UseStreamingUIOptions {\n  query: string\n  spaceIds?: string[]\n  sessionId?: string\n  options?: {\n    useCache?: boolean\n    useLLM?: boolean\n    maxComponents?: number\n    preferredComponents?: Array<'chart' | 'table' | 'metric' | 'text'>\n  }\n  onComplete?: (metadata: CompleteMetadata) => void\n  onError?: (error: StreamError) => void\n  onComponentReceived?: (component: UIComponent) => void\n}\n\nexport interface StreamingUIState {\n  components: UIComponent[]\n  isLoading: boolean\n  isStreaming: boolean\n  error: StreamError | null\n  progress: StreamProgress\n  metadata: CompleteMetadata | null\n}\n\nexport interface StreamProgress {\n  receivedCount: number\n  totalCount: number | null\n  message: string\n  timestamp: string\n}\n\nexport interface CompleteMetadata {\n  layoutId: string\n  componentsCount: number\n  executionTimeMs: number\n  /** Alias for executionTimeMs (for compatibility with FooterRenderer) */\n  executionTime?: number\n  firstTokenMs: number\n  provider: 'groq' | 'mock'\n  model: string\n  tokensUsed?: number\n  costUSD?: number\n  cached: boolean\n}\n\nexport interface StreamError {\n  error: string\n  message: string\n  componentId?: string\n  recoverable: boolean\n}\n\ninterface ComponentBuffer {\n  [sequenceId: number]: {\n    component: UIComponent\n    position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n  }\n}\n\n// ============================================================================\n// SSE Event Types (must match server)\n// ============================================================================\n\ntype SSEEventType = 'status' | 'component-start' | 'component' | 'complete' | 'error'\n\ninterface StatusEvent {\n  message: string\n  timestamp: string\n  totalComponents?: number\n}\n\ninterface ComponentStartEvent {\n  componentId: string\n  type: 'chart' | 'table' | 'metric' | 'text'\n  sequenceId: number\n  position: { colStart: number; colSpan: number }\n}\n\ninterface ComponentEvent {\n  componentId: string\n  sequenceId: number\n  component: UIComponent\n  position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n}\n\n// ============================================================================\n// Hook Implementation\n// ============================================================================\n\nexport function useStreamingUI(options: UseStreamingUIOptions) {\n  // State\n  const [components, setComponents] = createSignal<UIComponent[]>([])\n  const [isLoading, setIsLoading] = createSignal(false)\n  const [isStreaming, setIsStreaming] = createSignal(false)\n  const [error, setError] = createSignal<StreamError | null>(null)\n  const [progress, setProgress] = createSignal<StreamProgress>({\n    receivedCount: 0,\n    totalCount: null,\n    message: 'Initializing...',\n    timestamp: new Date().toISOString(),\n  })\n  const [metadata, setMetadata] = createSignal<CompleteMetadata | null>(null)\n\n  // Component buffer for reordering\n  let componentBuffer: ComponentBuffer = {}\n  let nextSequenceId = 0\n  let eventSource: EventSource | null = null\n  let reconnectAttempts = 0\n  const maxReconnectAttempts = 3\n\n  /**\n   * Flush components from buffer in sequence order\n   */\n  const flushBuffer = () => {\n    const flushed: UIComponent[] = []\n\n    while (componentBuffer[nextSequenceId]) {\n      const { component } = componentBuffer[nextSequenceId]\n      flushed.push(component)\n      delete componentBuffer[nextSequenceId]\n      nextSequenceId++\n    }\n\n    if (flushed.length > 0) {\n      setComponents((prev) => [...prev, ...flushed])\n\n      setProgress((prev) => ({\n        ...prev,\n        receivedCount: prev.receivedCount + flushed.length,\n      }))\n\n      logger.debug('Flushed components from buffer', {\n        count: flushed.length,\n        nextSequenceId,\n      })\n    }\n  }\n\n  /**\n   * Handle SSE status event\n   */\n  const handleStatusEvent = (data: StatusEvent) => {\n    logger.debug('Status event received', data as unknown as Record<string, unknown>)\n\n    setProgress({\n      receivedCount: progress().receivedCount,\n      totalCount: data.totalComponents ?? progress().totalCount,\n      message: data.message,\n      timestamp: data.timestamp,\n    })\n  }\n\n  /**\n   * Handle SSE component-start event\n   */\n  const handleComponentStartEvent = (data: ComponentStartEvent) => {\n    logger.debug('Component-start event received', data as unknown as Record<string, unknown>)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: `Loading ${data.type} component...`,\n      timestamp: new Date().toISOString(),\n    }))\n  }\n\n  /**\n   * Handle SSE component event\n   */\n  const handleComponentEvent = (data: ComponentEvent) => {\n    logger.debug('Component event received', {\n      componentId: data.componentId,\n      sequenceId: data.sequenceId,\n    })\n\n    // Add to buffer\n    componentBuffer[data.sequenceId] = {\n      component: data.component,\n      position: data.position,\n    }\n\n    // Flush buffer in sequence\n    flushBuffer()\n\n    // Notify callback\n    if (options.onComponentReceived) {\n      options.onComponentReceived(data.component)\n    }\n  }\n\n  /**\n   * Handle SSE complete event\n   */\n  const handleCompleteEvent = (data: CompleteMetadata) => {\n    logger.info('Stream completed', data as unknown as Record<string, unknown>)\n\n    setIsStreaming(false)\n    setIsLoading(false)\n    // Normalize executionTimeMs to executionTime for compatibility with FooterRenderer\n    setMetadata({\n      ...data,\n      executionTime: data.executionTimeMs || data.executionTime,\n    })\n\n    // Flush any remaining buffered components\n    flushBuffer()\n\n    setProgress((prev) => ({\n      ...prev,\n      message: 'Dashboard loaded',\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onComplete) {\n      options.onComplete(data)\n    }\n  }\n\n  /**\n   * Handle SSE error event\n   */\n  const handleErrorEvent = (data: StreamError) => {\n    logger.error('Stream error received', data as unknown as Record<string, unknown>)\n\n    setError(data)\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: `Error: ${data.message}`,\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onError) {\n      options.onError(data)\n    }\n\n    // Try to reconnect if recoverable\n    if (data.recoverable && reconnectAttempts < maxReconnectAttempts) {\n      reconnectAttempts++\n      logger.warn('Attempting to reconnect', { attempt: reconnectAttempts })\n      setTimeout(() => startStreaming(), 1000 * reconnectAttempts)\n    }\n  }\n\n  /**\n   * Parse SSE event\n   */\n  const parseSSEEvent = (event: MessageEvent, eventType: SSEEventType) => {\n    try {\n      const data = JSON.parse(event.data)\n\n      switch (eventType) {\n        case 'status':\n          handleStatusEvent(data as StatusEvent)\n          break\n        case 'component-start':\n          handleComponentStartEvent(data as ComponentStartEvent)\n          break\n        case 'component':\n          handleComponentEvent(data as ComponentEvent)\n          break\n        case 'complete':\n          handleCompleteEvent(data as CompleteMetadata)\n          break\n        case 'error':\n          handleErrorEvent(data as StreamError)\n          break\n        default:\n          logger.warn('Unknown SSE event type', { eventType })\n      }\n    } catch (error) {\n      logger.error('Failed to parse SSE event', {\n        error: error instanceof Error ? error.message : String(error),\n        eventType,\n      })\n    }\n  }\n\n  /**\n   * Start SSE streaming\n   */\n  const startStreaming = () => {\n    // SSR Guard: Prevent execution on server-side (Node.js environment)\n    // fetch() and ReadableStream APIs are only available in browsers\n    if (isServer) {\n      logger.warn('startStreaming called on server-side - skipping')\n      setError({\n        error: 'ssr',\n        message: 'Streaming UI cannot start on server-side',\n        recoverable: false,\n      })\n      setIsLoading(false)\n      return\n    }\n\n    // Reset state\n    setComponents([])\n    setError(null)\n    setIsLoading(true)\n    setIsStreaming(true)\n    componentBuffer = {}\n    nextSequenceId = 0\n\n    setProgress({\n      receivedCount: 0,\n      totalCount: null,\n      message: 'Connecting to server...',\n      timestamp: new Date().toISOString(),\n    })\n\n    logger.info('Starting SSE stream', {\n      query: options.query,\n      spaceIds: options.spaceIds,\n    })\n\n    // Build request body\n    const requestBody = {\n      query: options.query,\n      spaceIds: options.spaceIds,\n      sessionId: options.sessionId,\n      options: options.options,\n    }\n\n    // Create EventSource (SSE connection)\n    // Note: EventSource doesn't support POST, so we need to use fetch + ReadableStream\n    fetch('/api/mcp/generative-ui-stream', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(requestBody),\n    })\n      .then(async (response) => {\n        if (!response.ok) {\n          const errorData = await response.json()\n          throw new Error(errorData.message || 'Stream request failed')\n        }\n\n        if (!response.body) {\n          throw new Error('Response body is null')\n        }\n\n        const reader = response.body.getReader()\n        const decoder = new TextDecoder()\n\n        let buffer = ''\n\n        // Read stream\n        const readChunk = async (): Promise<void> => {\n          const { done, value } = await reader.read()\n\n          if (done) {\n            logger.info('Stream ended')\n            return\n          }\n\n          buffer += decoder.decode(value, { stream: true })\n\n          // Process SSE messages\n          const lines = buffer.split('\\n')\n          buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n          let currentEvent: SSEEventType | null = null\n\n          for (const line of lines) {\n            if (line.startsWith('event: ')) {\n              currentEvent = line.slice(7) as SSEEventType\n            } else if (line.startsWith('data: ') && currentEvent) {\n              const data = line.slice(6)\n              parseSSEEvent({ data } as MessageEvent, currentEvent)\n              currentEvent = null\n            }\n          }\n\n          // Continue reading\n          return readChunk()\n        }\n\n        await readChunk()\n      })\n      .catch((err) => {\n        logger.error('Stream fetch failed', {\n          error: err instanceof Error ? err.message : String(err),\n        })\n\n        handleErrorEvent({\n          error: 'Stream connection failed',\n          message: err instanceof Error ? err.message : 'Unknown error',\n          recoverable: true,\n        })\n      })\n  }\n\n  /**\n   * Stop streaming\n   */\n  const stopStreaming = () => {\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    logger.info('Streaming stopped')\n  }\n\n  /**\n   * Cleanup on unmount\n   */\n  onCleanup(() => {\n    stopStreaming()\n  })\n\n  // Auto-start streaming\n  startStreaming()\n\n  // Return state accessors and controls\n  return {\n    components,\n    isLoading,\n    isStreaming,\n    error,\n    progress,\n    metadata,\n    startStreaming,\n    stopStreaming,\n  }\n}\n"],"names":["createLogger","createSignal","error","onCleanup"],"mappings":"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"}
+{"version":3,"file":"useStreamingUI.cjs","sources":["../../src/hooks/useStreamingUI.ts"],"sourcesContent":["/**\n * useStreamingUI Hook - Phase 2\n *\n * Client-side hook for consuming the streaming generative UI endpoint.\n * Handles SSE connection, component buffering, reordering, and error handling.\n *\n * Features:\n * - SSE connection with automatic reconnection\n * - Component buffering and reordering by sequenceId\n * - Progress tracking and loading states\n * - Error handling with recovery attempts\n * - Cleanup on unmount\n *\n * Usage:\n * ```tsx\n * const { components, isLoading, error, progress } = useStreamingUI({\n *   query: 'Show me revenue trends',\n *   spaceIds: ['uuid1', 'uuid2'],\n *   onComplete: (metadata) => console.log('Done!', metadata),\n * })\n * ```\n */\n\nimport { createSignal, onCleanup } from 'solid-js'\nimport type { UIComponent } from '../types'\nimport { createLogger } from '../utils/logger'\nimport { formatMCPUIString } from '../utils/format-string'\n\nconst logger = createLogger('useStreamingUI')\n\n// SSR detection without importing solid-js/web (which might cause bundler issues)\nconst isServer = typeof window === 'undefined'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Every string `useStreamingUI` puts into `progress().message` and\n * `error()` — both are rendered by `<StreamingUIRenderer>`.\n *\n * @since v6.20.0 — `StreamingUIRenderer` feeds these from `MCPUIStrings`\n * (`stream*` keys); a host calling the hook directly passes `messages`.\n */\nexport interface StreamingUIMessages {\n  /** Initial progress message. */\n  initializing: string\n  /** Progress message while the request is sent. */\n  connecting: string\n  /** Progress message on `component-start`. Template — `{type}`. */\n  loadingComponent: string\n  /** Progress message on `complete`. */\n  dashboardLoaded: string\n  /** Progress message after an error. Template — `{message}`. */\n  errorProgress: string\n  /** `StreamError.error` when the fetch / read fails. */\n  connectionFailed: string\n  /** `StreamError.message` when the server answers non-OK without a message. */\n  requestFailed: string\n  /** `StreamError.message` when the response has no body. */\n  emptyResponse: string\n  /** `StreamError.message` when streaming starts during SSR. */\n  serverSide: string\n  /** `StreamError.message` when the failure carries no message. */\n  unknownError: string\n}\n\n/** English defaults of {@link StreamingUIMessages}. */\nexport const DEFAULT_STREAMING_UI_MESSAGES: StreamingUIMessages = {\n  initializing: 'Initializing...',\n  connecting: 'Connecting to server...',\n  loadingComponent: 'Loading {type} component...',\n  dashboardLoaded: 'Dashboard loaded',\n  errorProgress: 'Error: {message}',\n  connectionFailed: 'Stream connection failed',\n  requestFailed: 'Stream request failed',\n  emptyResponse: 'Response body is null',\n  serverSide: 'Streaming UI cannot start on server-side',\n  unknownError: 'Unknown error',\n}\n\nexport interface UseStreamingUIOptions {\n  query: string\n  spaceIds?: string[]\n  sessionId?: string\n  options?: {\n    useCache?: boolean\n    useLLM?: boolean\n    maxComponents?: number\n    preferredComponents?: Array<'chart' | 'table' | 'metric' | 'text'>\n  }\n  onComplete?: (metadata: CompleteMetadata) => void\n  onError?: (error: StreamError) => void\n  onComponentReceived?: (component: UIComponent) => void\n  /**\n   * Localized progress / error messages (v6.20.0). Each key is read when\n   * the message is produced, so an object with getters stays reactive.\n   * Omitted keys fall back to {@link DEFAULT_STREAMING_UI_MESSAGES}.\n   */\n  messages?: Partial<StreamingUIMessages>\n}\n\nexport interface StreamingUIState {\n  components: UIComponent[]\n  isLoading: boolean\n  isStreaming: boolean\n  error: StreamError | null\n  progress: StreamProgress\n  metadata: CompleteMetadata | null\n}\n\nexport interface StreamProgress {\n  receivedCount: number\n  totalCount: number | null\n  message: string\n  timestamp: string\n}\n\nexport interface CompleteMetadata {\n  layoutId: string\n  componentsCount: number\n  executionTimeMs: number\n  /** Alias for executionTimeMs (for compatibility with FooterRenderer) */\n  executionTime?: number\n  firstTokenMs: number\n  provider: 'groq' | 'mock'\n  model: string\n  tokensUsed?: number\n  costUSD?: number\n  cached: boolean\n}\n\nexport interface StreamError {\n  error: string\n  message: string\n  componentId?: string\n  recoverable: boolean\n}\n\ninterface ComponentBuffer {\n  [sequenceId: number]: {\n    component: UIComponent\n    position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n  }\n}\n\n// ============================================================================\n// SSE Event Types (must match server)\n// ============================================================================\n\ntype SSEEventType = 'status' | 'component-start' | 'component' | 'complete' | 'error'\n\ninterface StatusEvent {\n  message: string\n  timestamp: string\n  totalComponents?: number\n}\n\ninterface ComponentStartEvent {\n  componentId: string\n  type: 'chart' | 'table' | 'metric' | 'text'\n  sequenceId: number\n  position: { colStart: number; colSpan: number }\n}\n\ninterface ComponentEvent {\n  componentId: string\n  sequenceId: number\n  component: UIComponent\n  position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n}\n\n// ============================================================================\n// Hook Implementation\n// ============================================================================\n\nexport function useStreamingUI(options: UseStreamingUIOptions) {\n  const msg = (key: keyof StreamingUIMessages): string =>\n    options.messages?.[key] ?? DEFAULT_STREAMING_UI_MESSAGES[key]\n\n  // State\n  const [components, setComponents] = createSignal<UIComponent[]>([])\n  const [isLoading, setIsLoading] = createSignal(false)\n  const [isStreaming, setIsStreaming] = createSignal(false)\n  const [error, setError] = createSignal<StreamError | null>(null)\n  const [progress, setProgress] = createSignal<StreamProgress>({\n    receivedCount: 0,\n    totalCount: null,\n    message: msg('initializing'),\n    timestamp: new Date().toISOString(),\n  })\n  const [metadata, setMetadata] = createSignal<CompleteMetadata | null>(null)\n\n  // Component buffer for reordering\n  let componentBuffer: ComponentBuffer = {}\n  let nextSequenceId = 0\n  let eventSource: EventSource | null = null\n  let reconnectAttempts = 0\n  const maxReconnectAttempts = 3\n\n  /**\n   * Flush components from buffer in sequence order\n   */\n  const flushBuffer = () => {\n    const flushed: UIComponent[] = []\n\n    while (componentBuffer[nextSequenceId]) {\n      const { component } = componentBuffer[nextSequenceId]\n      flushed.push(component)\n      delete componentBuffer[nextSequenceId]\n      nextSequenceId++\n    }\n\n    if (flushed.length > 0) {\n      setComponents((prev) => [...prev, ...flushed])\n\n      setProgress((prev) => ({\n        ...prev,\n        receivedCount: prev.receivedCount + flushed.length,\n      }))\n\n      logger.debug('Flushed components from buffer', {\n        count: flushed.length,\n        nextSequenceId,\n      })\n    }\n  }\n\n  /**\n   * Handle SSE status event\n   */\n  const handleStatusEvent = (data: StatusEvent) => {\n    logger.debug('Status event received', data as unknown as Record<string, unknown>)\n\n    setProgress({\n      receivedCount: progress().receivedCount,\n      totalCount: data.totalComponents ?? progress().totalCount,\n      message: data.message,\n      timestamp: data.timestamp,\n    })\n  }\n\n  /**\n   * Handle SSE component-start event\n   */\n  const handleComponentStartEvent = (data: ComponentStartEvent) => {\n    logger.debug('Component-start event received', data as unknown as Record<string, unknown>)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: formatMCPUIString(msg('loadingComponent'), { type: data.type }),\n      timestamp: new Date().toISOString(),\n    }))\n  }\n\n  /**\n   * Handle SSE component event\n   */\n  const handleComponentEvent = (data: ComponentEvent) => {\n    logger.debug('Component event received', {\n      componentId: data.componentId,\n      sequenceId: data.sequenceId,\n    })\n\n    // Add to buffer\n    componentBuffer[data.sequenceId] = {\n      component: data.component,\n      position: data.position,\n    }\n\n    // Flush buffer in sequence\n    flushBuffer()\n\n    // Notify callback\n    if (options.onComponentReceived) {\n      options.onComponentReceived(data.component)\n    }\n  }\n\n  /**\n   * Handle SSE complete event\n   */\n  const handleCompleteEvent = (data: CompleteMetadata) => {\n    logger.info('Stream completed', data as unknown as Record<string, unknown>)\n\n    setIsStreaming(false)\n    setIsLoading(false)\n    // Normalize executionTimeMs to executionTime for compatibility with FooterRenderer\n    setMetadata({\n      ...data,\n      executionTime: data.executionTimeMs || data.executionTime,\n    })\n\n    // Flush any remaining buffered components\n    flushBuffer()\n\n    setProgress((prev) => ({\n      ...prev,\n      message: msg('dashboardLoaded'),\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onComplete) {\n      options.onComplete(data)\n    }\n  }\n\n  /**\n   * Handle SSE error event\n   */\n  const handleErrorEvent = (data: StreamError) => {\n    logger.error('Stream error received', data as unknown as Record<string, unknown>)\n\n    setError(data)\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: formatMCPUIString(msg('errorProgress'), { message: data.message }),\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onError) {\n      options.onError(data)\n    }\n\n    // Try to reconnect if recoverable\n    if (data.recoverable && reconnectAttempts < maxReconnectAttempts) {\n      reconnectAttempts++\n      logger.warn('Attempting to reconnect', { attempt: reconnectAttempts })\n      setTimeout(() => startStreaming(), 1000 * reconnectAttempts)\n    }\n  }\n\n  /**\n   * Parse SSE event\n   */\n  const parseSSEEvent = (event: MessageEvent, eventType: SSEEventType) => {\n    try {\n      const data = JSON.parse(event.data)\n\n      switch (eventType) {\n        case 'status':\n          handleStatusEvent(data as StatusEvent)\n          break\n        case 'component-start':\n          handleComponentStartEvent(data as ComponentStartEvent)\n          break\n        case 'component':\n          handleComponentEvent(data as ComponentEvent)\n          break\n        case 'complete':\n          handleCompleteEvent(data as CompleteMetadata)\n          break\n        case 'error':\n          handleErrorEvent(data as StreamError)\n          break\n        default:\n          logger.warn('Unknown SSE event type', { eventType })\n      }\n    } catch (error) {\n      logger.error('Failed to parse SSE event', {\n        error: error instanceof Error ? error.message : String(error),\n        eventType,\n      })\n    }\n  }\n\n  /**\n   * Start SSE streaming\n   */\n  const startStreaming = () => {\n    // SSR Guard: Prevent execution on server-side (Node.js environment)\n    // fetch() and ReadableStream APIs are only available in browsers\n    if (isServer) {\n      logger.warn('startStreaming called on server-side - skipping')\n      setError({\n        error: 'ssr',\n        message: msg('serverSide'),\n        recoverable: false,\n      })\n      setIsLoading(false)\n      return\n    }\n\n    // Reset state\n    setComponents([])\n    setError(null)\n    setIsLoading(true)\n    setIsStreaming(true)\n    componentBuffer = {}\n    nextSequenceId = 0\n\n    setProgress({\n      receivedCount: 0,\n      totalCount: null,\n      message: msg('connecting'),\n      timestamp: new Date().toISOString(),\n    })\n\n    logger.info('Starting SSE stream', {\n      query: options.query,\n      spaceIds: options.spaceIds,\n    })\n\n    // Build request body\n    const requestBody = {\n      query: options.query,\n      spaceIds: options.spaceIds,\n      sessionId: options.sessionId,\n      options: options.options,\n    }\n\n    // Create EventSource (SSE connection)\n    // Note: EventSource doesn't support POST, so we need to use fetch + ReadableStream\n    fetch('/api/mcp/generative-ui-stream', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(requestBody),\n    })\n      .then(async (response) => {\n        if (!response.ok) {\n          const errorData = await response.json()\n          throw new Error(errorData.message || msg('requestFailed'))\n        }\n\n        if (!response.body) {\n          throw new Error(msg('emptyResponse'))\n        }\n\n        const reader = response.body.getReader()\n        const decoder = new TextDecoder()\n\n        let buffer = ''\n\n        // Read stream\n        const readChunk = async (): Promise<void> => {\n          const { done, value } = await reader.read()\n\n          if (done) {\n            logger.info('Stream ended')\n            return\n          }\n\n          buffer += decoder.decode(value, { stream: true })\n\n          // Process SSE messages\n          const lines = buffer.split('\\n')\n          buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n          let currentEvent: SSEEventType | null = null\n\n          for (const line of lines) {\n            if (line.startsWith('event: ')) {\n              currentEvent = line.slice(7) as SSEEventType\n            } else if (line.startsWith('data: ') && currentEvent) {\n              const data = line.slice(6)\n              parseSSEEvent({ data } as MessageEvent, currentEvent)\n              currentEvent = null\n            }\n          }\n\n          // Continue reading\n          return readChunk()\n        }\n\n        await readChunk()\n      })\n      .catch((err) => {\n        logger.error('Stream fetch failed', {\n          error: err instanceof Error ? err.message : String(err),\n        })\n\n        handleErrorEvent({\n          error: msg('connectionFailed'),\n          message: err instanceof Error ? err.message : msg('unknownError'),\n          recoverable: true,\n        })\n      })\n  }\n\n  /**\n   * Stop streaming\n   */\n  const stopStreaming = () => {\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    logger.info('Streaming stopped')\n  }\n\n  /**\n   * Cleanup on unmount\n   */\n  onCleanup(() => {\n    stopStreaming()\n  })\n\n  // Auto-start streaming\n  startStreaming()\n\n  // Return state accessors and controls\n  return {\n    components,\n    isLoading,\n    isStreaming,\n    error,\n    progress,\n    metadata,\n    startStreaming,\n    stopStreaming,\n  }\n}\n"],"names":["createLogger","createSignal","formatMCPUIString","error","onCleanup"],"mappings":"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"}

package/dist/hooks/useStreamingUI.d.ts

@@ -21,6 +21,37 @@
  * ```
  */
 import type { UIComponent } from '../types';
+/**
+ * Every string `useStreamingUI` puts into `progress().message` and
+ * `error()` — both are rendered by `<StreamingUIRenderer>`.
+ *
+ * @since v6.20.0 — `StreamingUIRenderer` feeds these from `MCPUIStrings`
+ * (`stream*` keys); a host calling the hook directly passes `messages`.
+ */
+export interface StreamingUIMessages {
+    /** Initial progress message. */
+    initializing: string;
+    /** Progress message while the request is sent. */
+    connecting: string;
+    /** Progress message on `component-start`. Template — `{type}`. */
+    loadingComponent: string;
+    /** Progress message on `complete`. */
+    dashboardLoaded: string;
+    /** Progress message after an error. Template — `{message}`. */
+    errorProgress: string;
+    /** `StreamError.error` when the fetch / read fails. */
+    connectionFailed: string;
+    /** `StreamError.message` when the server answers non-OK without a message. */
+    requestFailed: string;
+    /** `StreamError.message` when the response has no body. */
+    emptyResponse: string;
+    /** `StreamError.message` when streaming starts during SSR. */
+    serverSide: string;
+    /** `StreamError.message` when the failure carries no message. */
+    unknownError: string;
+}
+/** English defaults of {@link StreamingUIMessages}. */
+export declare const DEFAULT_STREAMING_UI_MESSAGES: StreamingUIMessages;
 export interface UseStreamingUIOptions {
     query: string;
     spaceIds?: string[];
@@ -34,6 +65,12 @@ export interface UseStreamingUIOptions {
     onComplete?: (metadata: CompleteMetadata) => void;
     onError?: (error: StreamError) => void;
     onComponentReceived?: (component: UIComponent) => void;
+    /**
+     * Localized progress / error messages (v6.20.0). Each key is read when
+     * the message is produced, so an object with getters stays reactive.
+     * Omitted keys fall back to {@link DEFAULT_STREAMING_UI_MESSAGES}.
+     */
+    messages?: Partial<StreamingUIMessages>;
 }
 export interface StreamingUIState {
     components: UIComponent[];

package/dist/hooks/useStreamingUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useStreamingUI.d.ts","sourceRoot":"","sources":["../../src/hooks/useStreamingUI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAY3C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,mBAAmB,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAA;KACnE,CAAA;IACD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAA;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,WAAW,EAAE,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,cAAc,CAAA;IACxB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB;AAuCD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;EAuV5D"}
+{"version":3,"file":"useStreamingUI.d.ts","sourceRoot":"","sources":["../../src/hooks/useStreamingUI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAa3C;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAA;IACxB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAA;IACxB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,uDAAuD;AACvD,eAAO,MAAM,6BAA6B,EAAE,mBAW3C,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,mBAAmB,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAA;KACnE,CAAA;IACD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAA;IACtD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,WAAW,EAAE,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,cAAc,CAAA;IACxB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB;AAuCD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;EA0V5D"}

package/dist/hooks/useStreamingUI.js

@@ -1,8 +1,25 @@
 import { createSignal, onCleanup } from "solid-js";
 import { createLogger } from "../utils/logger.js";
+import { formatMCPUIString } from "../utils/format-string.js";
 const logger = createLogger("useStreamingUI");
 const isServer = typeof window === "undefined";
+const DEFAULT_STREAMING_UI_MESSAGES = {
+  initializing: "Initializing...",
+  connecting: "Connecting to server...",
+  loadingComponent: "Loading {type} component...",
+  dashboardLoaded: "Dashboard loaded",
+  errorProgress: "Error: {message}",
+  connectionFailed: "Stream connection failed",
+  requestFailed: "Stream request failed",
+  emptyResponse: "Response body is null",
+  serverSide: "Streaming UI cannot start on server-side",
+  unknownError: "Unknown error"
+};
 function useStreamingUI(options) {
+  const msg = (key) => {
+    var _a;
+    return ((_a = options.messages) == null ? void 0 : _a[key]) ?? DEFAULT_STREAMING_UI_MESSAGES[key];
+  };
   const [components, setComponents] = createSignal([]);
   const [isLoading, setIsLoading] = createSignal(false);
   const [isStreaming, setIsStreaming] = createSignal(false);
@@ -10,7 +27,7 @@ function useStreamingUI(options) {
   const [progress, setProgress] = createSignal({
     receivedCount: 0,
     totalCount: null,
-    message: "Initializing...",
+    message: msg("initializing"),
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   });
   const [metadata, setMetadata] = createSignal(null);
@@ -51,7 +68,7 @@ function useStreamingUI(options) {
     logger.debug("Component-start event received", data);
     setProgress((prev) => ({
       ...prev,
-      message: `Loading ${data.type} component...`,
+      message: formatMCPUIString(msg("loadingComponent"), { type: data.type }),
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     }));
   };
@@ -80,7 +97,7 @@ function useStreamingUI(options) {
     flushBuffer();
     setProgress((prev) => ({
       ...prev,
-      message: "Dashboard loaded",
+      message: msg("dashboardLoaded"),
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     }));
     if (options.onComplete) {
@@ -94,7 +111,7 @@ function useStreamingUI(options) {
     setIsLoading(false);
     setProgress((prev) => ({
       ...prev,
-      message: `Error: ${data.message}`,
+      message: formatMCPUIString(msg("errorProgress"), { message: data.message }),
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     }));
     if (options.onError) {
@@ -140,7 +157,7 @@ function useStreamingUI(options) {
       logger.warn("startStreaming called on server-side - skipping");
       setError({
         error: "ssr",
-        message: "Streaming UI cannot start on server-side",
+        message: msg("serverSide"),
         recoverable: false
       });
       setIsLoading(false);
@@ -155,7 +172,7 @@ function useStreamingUI(options) {
     setProgress({
       receivedCount: 0,
       totalCount: null,
-      message: "Connecting to server...",
+      message: msg("connecting"),
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     });
     logger.info("Starting SSE stream", {
@@ -177,10 +194,10 @@ function useStreamingUI(options) {
     }).then(async (response) => {
       if (!response.ok) {
         const errorData = await response.json();
-        throw new Error(errorData.message || "Stream request failed");
+        throw new Error(errorData.message || msg("requestFailed"));
       }
       if (!response.body) {
-        throw new Error("Response body is null");
+        throw new Error(msg("emptyResponse"));
       }
       const reader = response.body.getReader();
       const decoder = new TextDecoder();
@@ -212,8 +229,8 @@ function useStreamingUI(options) {
         error: err instanceof Error ? err.message : String(err)
       });
       handleErrorEvent({
-        error: "Stream connection failed",
-        message: err instanceof Error ? err.message : "Unknown error",
+        error: msg("connectionFailed"),
+        message: err instanceof Error ? err.message : msg("unknownError"),
         recoverable: true
       });
     });
@@ -239,6 +256,7 @@ function useStreamingUI(options) {
   };
 }
 export {
+  DEFAULT_STREAMING_UI_MESSAGES,
   useStreamingUI
 };
 //# sourceMappingURL=useStreamingUI.js.map

package/dist/hooks/useStreamingUI.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStreamingUI.js","sources":["../../src/hooks/useStreamingUI.ts"],"sourcesContent":["/**\n * useStreamingUI Hook - Phase 2\n *\n * Client-side hook for consuming the streaming generative UI endpoint.\n * Handles SSE connection, component buffering, reordering, and error handling.\n *\n * Features:\n * - SSE connection with automatic reconnection\n * - Component buffering and reordering by sequenceId\n * - Progress tracking and loading states\n * - Error handling with recovery attempts\n * - Cleanup on unmount\n *\n * Usage:\n * ```tsx\n * const { components, isLoading, error, progress } = useStreamingUI({\n *   query: 'Show me revenue trends',\n *   spaceIds: ['uuid1', 'uuid2'],\n *   onComplete: (metadata) => console.log('Done!', metadata),\n * })\n * ```\n */\n\nimport { createSignal, onCleanup } from 'solid-js'\nimport type { UIComponent } from '../types'\nimport { createLogger } from '../utils/logger'\n\nconst logger = createLogger('useStreamingUI')\n\n// SSR detection without importing solid-js/web (which might cause bundler issues)\nconst isServer = typeof window === 'undefined'\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface UseStreamingUIOptions {\n  query: string\n  spaceIds?: string[]\n  sessionId?: string\n  options?: {\n    useCache?: boolean\n    useLLM?: boolean\n    maxComponents?: number\n    preferredComponents?: Array<'chart' | 'table' | 'metric' | 'text'>\n  }\n  onComplete?: (metadata: CompleteMetadata) => void\n  onError?: (error: StreamError) => void\n  onComponentReceived?: (component: UIComponent) => void\n}\n\nexport interface StreamingUIState {\n  components: UIComponent[]\n  isLoading: boolean\n  isStreaming: boolean\n  error: StreamError | null\n  progress: StreamProgress\n  metadata: CompleteMetadata | null\n}\n\nexport interface StreamProgress {\n  receivedCount: number\n  totalCount: number | null\n  message: string\n  timestamp: string\n}\n\nexport interface CompleteMetadata {\n  layoutId: string\n  componentsCount: number\n  executionTimeMs: number\n  /** Alias for executionTimeMs (for compatibility with FooterRenderer) */\n  executionTime?: number\n  firstTokenMs: number\n  provider: 'groq' | 'mock'\n  model: string\n  tokensUsed?: number\n  costUSD?: number\n  cached: boolean\n}\n\nexport interface StreamError {\n  error: string\n  message: string\n  componentId?: string\n  recoverable: boolean\n}\n\ninterface ComponentBuffer {\n  [sequenceId: number]: {\n    component: UIComponent\n    position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n  }\n}\n\n// ============================================================================\n// SSE Event Types (must match server)\n// ============================================================================\n\ntype SSEEventType = 'status' | 'component-start' | 'component' | 'complete' | 'error'\n\ninterface StatusEvent {\n  message: string\n  timestamp: string\n  totalComponents?: number\n}\n\ninterface ComponentStartEvent {\n  componentId: string\n  type: 'chart' | 'table' | 'metric' | 'text'\n  sequenceId: number\n  position: { colStart: number; colSpan: number }\n}\n\ninterface ComponentEvent {\n  componentId: string\n  sequenceId: number\n  component: UIComponent\n  position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n}\n\n// ============================================================================\n// Hook Implementation\n// ============================================================================\n\nexport function useStreamingUI(options: UseStreamingUIOptions) {\n  // State\n  const [components, setComponents] = createSignal<UIComponent[]>([])\n  const [isLoading, setIsLoading] = createSignal(false)\n  const [isStreaming, setIsStreaming] = createSignal(false)\n  const [error, setError] = createSignal<StreamError | null>(null)\n  const [progress, setProgress] = createSignal<StreamProgress>({\n    receivedCount: 0,\n    totalCount: null,\n    message: 'Initializing...',\n    timestamp: new Date().toISOString(),\n  })\n  const [metadata, setMetadata] = createSignal<CompleteMetadata | null>(null)\n\n  // Component buffer for reordering\n  let componentBuffer: ComponentBuffer = {}\n  let nextSequenceId = 0\n  let eventSource: EventSource | null = null\n  let reconnectAttempts = 0\n  const maxReconnectAttempts = 3\n\n  /**\n   * Flush components from buffer in sequence order\n   */\n  const flushBuffer = () => {\n    const flushed: UIComponent[] = []\n\n    while (componentBuffer[nextSequenceId]) {\n      const { component } = componentBuffer[nextSequenceId]\n      flushed.push(component)\n      delete componentBuffer[nextSequenceId]\n      nextSequenceId++\n    }\n\n    if (flushed.length > 0) {\n      setComponents((prev) => [...prev, ...flushed])\n\n      setProgress((prev) => ({\n        ...prev,\n        receivedCount: prev.receivedCount + flushed.length,\n      }))\n\n      logger.debug('Flushed components from buffer', {\n        count: flushed.length,\n        nextSequenceId,\n      })\n    }\n  }\n\n  /**\n   * Handle SSE status event\n   */\n  const handleStatusEvent = (data: StatusEvent) => {\n    logger.debug('Status event received', data as unknown as Record<string, unknown>)\n\n    setProgress({\n      receivedCount: progress().receivedCount,\n      totalCount: data.totalComponents ?? progress().totalCount,\n      message: data.message,\n      timestamp: data.timestamp,\n    })\n  }\n\n  /**\n   * Handle SSE component-start event\n   */\n  const handleComponentStartEvent = (data: ComponentStartEvent) => {\n    logger.debug('Component-start event received', data as unknown as Record<string, unknown>)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: `Loading ${data.type} component...`,\n      timestamp: new Date().toISOString(),\n    }))\n  }\n\n  /**\n   * Handle SSE component event\n   */\n  const handleComponentEvent = (data: ComponentEvent) => {\n    logger.debug('Component event received', {\n      componentId: data.componentId,\n      sequenceId: data.sequenceId,\n    })\n\n    // Add to buffer\n    componentBuffer[data.sequenceId] = {\n      component: data.component,\n      position: data.position,\n    }\n\n    // Flush buffer in sequence\n    flushBuffer()\n\n    // Notify callback\n    if (options.onComponentReceived) {\n      options.onComponentReceived(data.component)\n    }\n  }\n\n  /**\n   * Handle SSE complete event\n   */\n  const handleCompleteEvent = (data: CompleteMetadata) => {\n    logger.info('Stream completed', data as unknown as Record<string, unknown>)\n\n    setIsStreaming(false)\n    setIsLoading(false)\n    // Normalize executionTimeMs to executionTime for compatibility with FooterRenderer\n    setMetadata({\n      ...data,\n      executionTime: data.executionTimeMs || data.executionTime,\n    })\n\n    // Flush any remaining buffered components\n    flushBuffer()\n\n    setProgress((prev) => ({\n      ...prev,\n      message: 'Dashboard loaded',\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onComplete) {\n      options.onComplete(data)\n    }\n  }\n\n  /**\n   * Handle SSE error event\n   */\n  const handleErrorEvent = (data: StreamError) => {\n    logger.error('Stream error received', data as unknown as Record<string, unknown>)\n\n    setError(data)\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: `Error: ${data.message}`,\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onError) {\n      options.onError(data)\n    }\n\n    // Try to reconnect if recoverable\n    if (data.recoverable && reconnectAttempts < maxReconnectAttempts) {\n      reconnectAttempts++\n      logger.warn('Attempting to reconnect', { attempt: reconnectAttempts })\n      setTimeout(() => startStreaming(), 1000 * reconnectAttempts)\n    }\n  }\n\n  /**\n   * Parse SSE event\n   */\n  const parseSSEEvent = (event: MessageEvent, eventType: SSEEventType) => {\n    try {\n      const data = JSON.parse(event.data)\n\n      switch (eventType) {\n        case 'status':\n          handleStatusEvent(data as StatusEvent)\n          break\n        case 'component-start':\n          handleComponentStartEvent(data as ComponentStartEvent)\n          break\n        case 'component':\n          handleComponentEvent(data as ComponentEvent)\n          break\n        case 'complete':\n          handleCompleteEvent(data as CompleteMetadata)\n          break\n        case 'error':\n          handleErrorEvent(data as StreamError)\n          break\n        default:\n          logger.warn('Unknown SSE event type', { eventType })\n      }\n    } catch (error) {\n      logger.error('Failed to parse SSE event', {\n        error: error instanceof Error ? error.message : String(error),\n        eventType,\n      })\n    }\n  }\n\n  /**\n   * Start SSE streaming\n   */\n  const startStreaming = () => {\n    // SSR Guard: Prevent execution on server-side (Node.js environment)\n    // fetch() and ReadableStream APIs are only available in browsers\n    if (isServer) {\n      logger.warn('startStreaming called on server-side - skipping')\n      setError({\n        error: 'ssr',\n        message: 'Streaming UI cannot start on server-side',\n        recoverable: false,\n      })\n      setIsLoading(false)\n      return\n    }\n\n    // Reset state\n    setComponents([])\n    setError(null)\n    setIsLoading(true)\n    setIsStreaming(true)\n    componentBuffer = {}\n    nextSequenceId = 0\n\n    setProgress({\n      receivedCount: 0,\n      totalCount: null,\n      message: 'Connecting to server...',\n      timestamp: new Date().toISOString(),\n    })\n\n    logger.info('Starting SSE stream', {\n      query: options.query,\n      spaceIds: options.spaceIds,\n    })\n\n    // Build request body\n    const requestBody = {\n      query: options.query,\n      spaceIds: options.spaceIds,\n      sessionId: options.sessionId,\n      options: options.options,\n    }\n\n    // Create EventSource (SSE connection)\n    // Note: EventSource doesn't support POST, so we need to use fetch + ReadableStream\n    fetch('/api/mcp/generative-ui-stream', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(requestBody),\n    })\n      .then(async (response) => {\n        if (!response.ok) {\n          const errorData = await response.json()\n          throw new Error(errorData.message || 'Stream request failed')\n        }\n\n        if (!response.body) {\n          throw new Error('Response body is null')\n        }\n\n        const reader = response.body.getReader()\n        const decoder = new TextDecoder()\n\n        let buffer = ''\n\n        // Read stream\n        const readChunk = async (): Promise<void> => {\n          const { done, value } = await reader.read()\n\n          if (done) {\n            logger.info('Stream ended')\n            return\n          }\n\n          buffer += decoder.decode(value, { stream: true })\n\n          // Process SSE messages\n          const lines = buffer.split('\\n')\n          buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n          let currentEvent: SSEEventType | null = null\n\n          for (const line of lines) {\n            if (line.startsWith('event: ')) {\n              currentEvent = line.slice(7) as SSEEventType\n            } else if (line.startsWith('data: ') && currentEvent) {\n              const data = line.slice(6)\n              parseSSEEvent({ data } as MessageEvent, currentEvent)\n              currentEvent = null\n            }\n          }\n\n          // Continue reading\n          return readChunk()\n        }\n\n        await readChunk()\n      })\n      .catch((err) => {\n        logger.error('Stream fetch failed', {\n          error: err instanceof Error ? err.message : String(err),\n        })\n\n        handleErrorEvent({\n          error: 'Stream connection failed',\n          message: err instanceof Error ? err.message : 'Unknown error',\n          recoverable: true,\n        })\n      })\n  }\n\n  /**\n   * Stop streaming\n   */\n  const stopStreaming = () => {\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    logger.info('Streaming stopped')\n  }\n\n  /**\n   * Cleanup on unmount\n   */\n  onCleanup(() => {\n    stopStreaming()\n  })\n\n  // Auto-start streaming\n  startStreaming()\n\n  // Return state accessors and controls\n  return {\n    components,\n    isLoading,\n    isStreaming,\n    error,\n    progress,\n    metadata,\n    startStreaming,\n    stopStreaming,\n  }\n}\n"],"names":["error"],"mappings":"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"}
+{"version":3,"file":"useStreamingUI.js","sources":["../../src/hooks/useStreamingUI.ts"],"sourcesContent":["/**\n * useStreamingUI Hook - Phase 2\n *\n * Client-side hook for consuming the streaming generative UI endpoint.\n * Handles SSE connection, component buffering, reordering, and error handling.\n *\n * Features:\n * - SSE connection with automatic reconnection\n * - Component buffering and reordering by sequenceId\n * - Progress tracking and loading states\n * - Error handling with recovery attempts\n * - Cleanup on unmount\n *\n * Usage:\n * ```tsx\n * const { components, isLoading, error, progress } = useStreamingUI({\n *   query: 'Show me revenue trends',\n *   spaceIds: ['uuid1', 'uuid2'],\n *   onComplete: (metadata) => console.log('Done!', metadata),\n * })\n * ```\n */\n\nimport { createSignal, onCleanup } from 'solid-js'\nimport type { UIComponent } from '../types'\nimport { createLogger } from '../utils/logger'\nimport { formatMCPUIString } from '../utils/format-string'\n\nconst logger = createLogger('useStreamingUI')\n\n// SSR detection without importing solid-js/web (which might cause bundler issues)\nconst isServer = typeof window === 'undefined'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Every string `useStreamingUI` puts into `progress().message` and\n * `error()` — both are rendered by `<StreamingUIRenderer>`.\n *\n * @since v6.20.0 — `StreamingUIRenderer` feeds these from `MCPUIStrings`\n * (`stream*` keys); a host calling the hook directly passes `messages`.\n */\nexport interface StreamingUIMessages {\n  /** Initial progress message. */\n  initializing: string\n  /** Progress message while the request is sent. */\n  connecting: string\n  /** Progress message on `component-start`. Template — `{type}`. */\n  loadingComponent: string\n  /** Progress message on `complete`. */\n  dashboardLoaded: string\n  /** Progress message after an error. Template — `{message}`. */\n  errorProgress: string\n  /** `StreamError.error` when the fetch / read fails. */\n  connectionFailed: string\n  /** `StreamError.message` when the server answers non-OK without a message. */\n  requestFailed: string\n  /** `StreamError.message` when the response has no body. */\n  emptyResponse: string\n  /** `StreamError.message` when streaming starts during SSR. */\n  serverSide: string\n  /** `StreamError.message` when the failure carries no message. */\n  unknownError: string\n}\n\n/** English defaults of {@link StreamingUIMessages}. */\nexport const DEFAULT_STREAMING_UI_MESSAGES: StreamingUIMessages = {\n  initializing: 'Initializing...',\n  connecting: 'Connecting to server...',\n  loadingComponent: 'Loading {type} component...',\n  dashboardLoaded: 'Dashboard loaded',\n  errorProgress: 'Error: {message}',\n  connectionFailed: 'Stream connection failed',\n  requestFailed: 'Stream request failed',\n  emptyResponse: 'Response body is null',\n  serverSide: 'Streaming UI cannot start on server-side',\n  unknownError: 'Unknown error',\n}\n\nexport interface UseStreamingUIOptions {\n  query: string\n  spaceIds?: string[]\n  sessionId?: string\n  options?: {\n    useCache?: boolean\n    useLLM?: boolean\n    maxComponents?: number\n    preferredComponents?: Array<'chart' | 'table' | 'metric' | 'text'>\n  }\n  onComplete?: (metadata: CompleteMetadata) => void\n  onError?: (error: StreamError) => void\n  onComponentReceived?: (component: UIComponent) => void\n  /**\n   * Localized progress / error messages (v6.20.0). Each key is read when\n   * the message is produced, so an object with getters stays reactive.\n   * Omitted keys fall back to {@link DEFAULT_STREAMING_UI_MESSAGES}.\n   */\n  messages?: Partial<StreamingUIMessages>\n}\n\nexport interface StreamingUIState {\n  components: UIComponent[]\n  isLoading: boolean\n  isStreaming: boolean\n  error: StreamError | null\n  progress: StreamProgress\n  metadata: CompleteMetadata | null\n}\n\nexport interface StreamProgress {\n  receivedCount: number\n  totalCount: number | null\n  message: string\n  timestamp: string\n}\n\nexport interface CompleteMetadata {\n  layoutId: string\n  componentsCount: number\n  executionTimeMs: number\n  /** Alias for executionTimeMs (for compatibility with FooterRenderer) */\n  executionTime?: number\n  firstTokenMs: number\n  provider: 'groq' | 'mock'\n  model: string\n  tokensUsed?: number\n  costUSD?: number\n  cached: boolean\n}\n\nexport interface StreamError {\n  error: string\n  message: string\n  componentId?: string\n  recoverable: boolean\n}\n\ninterface ComponentBuffer {\n  [sequenceId: number]: {\n    component: UIComponent\n    position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n  }\n}\n\n// ============================================================================\n// SSE Event Types (must match server)\n// ============================================================================\n\ntype SSEEventType = 'status' | 'component-start' | 'component' | 'complete' | 'error'\n\ninterface StatusEvent {\n  message: string\n  timestamp: string\n  totalComponents?: number\n}\n\ninterface ComponentStartEvent {\n  componentId: string\n  type: 'chart' | 'table' | 'metric' | 'text'\n  sequenceId: number\n  position: { colStart: number; colSpan: number }\n}\n\ninterface ComponentEvent {\n  componentId: string\n  sequenceId: number\n  component: UIComponent\n  position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n}\n\n// ============================================================================\n// Hook Implementation\n// ============================================================================\n\nexport function useStreamingUI(options: UseStreamingUIOptions) {\n  const msg = (key: keyof StreamingUIMessages): string =>\n    options.messages?.[key] ?? DEFAULT_STREAMING_UI_MESSAGES[key]\n\n  // State\n  const [components, setComponents] = createSignal<UIComponent[]>([])\n  const [isLoading, setIsLoading] = createSignal(false)\n  const [isStreaming, setIsStreaming] = createSignal(false)\n  const [error, setError] = createSignal<StreamError | null>(null)\n  const [progress, setProgress] = createSignal<StreamProgress>({\n    receivedCount: 0,\n    totalCount: null,\n    message: msg('initializing'),\n    timestamp: new Date().toISOString(),\n  })\n  const [metadata, setMetadata] = createSignal<CompleteMetadata | null>(null)\n\n  // Component buffer for reordering\n  let componentBuffer: ComponentBuffer = {}\n  let nextSequenceId = 0\n  let eventSource: EventSource | null = null\n  let reconnectAttempts = 0\n  const maxReconnectAttempts = 3\n\n  /**\n   * Flush components from buffer in sequence order\n   */\n  const flushBuffer = () => {\n    const flushed: UIComponent[] = []\n\n    while (componentBuffer[nextSequenceId]) {\n      const { component } = componentBuffer[nextSequenceId]\n      flushed.push(component)\n      delete componentBuffer[nextSequenceId]\n      nextSequenceId++\n    }\n\n    if (flushed.length > 0) {\n      setComponents((prev) => [...prev, ...flushed])\n\n      setProgress((prev) => ({\n        ...prev,\n        receivedCount: prev.receivedCount + flushed.length,\n      }))\n\n      logger.debug('Flushed components from buffer', {\n        count: flushed.length,\n        nextSequenceId,\n      })\n    }\n  }\n\n  /**\n   * Handle SSE status event\n   */\n  const handleStatusEvent = (data: StatusEvent) => {\n    logger.debug('Status event received', data as unknown as Record<string, unknown>)\n\n    setProgress({\n      receivedCount: progress().receivedCount,\n      totalCount: data.totalComponents ?? progress().totalCount,\n      message: data.message,\n      timestamp: data.timestamp,\n    })\n  }\n\n  /**\n   * Handle SSE component-start event\n   */\n  const handleComponentStartEvent = (data: ComponentStartEvent) => {\n    logger.debug('Component-start event received', data as unknown as Record<string, unknown>)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: formatMCPUIString(msg('loadingComponent'), { type: data.type }),\n      timestamp: new Date().toISOString(),\n    }))\n  }\n\n  /**\n   * Handle SSE component event\n   */\n  const handleComponentEvent = (data: ComponentEvent) => {\n    logger.debug('Component event received', {\n      componentId: data.componentId,\n      sequenceId: data.sequenceId,\n    })\n\n    // Add to buffer\n    componentBuffer[data.sequenceId] = {\n      component: data.component,\n      position: data.position,\n    }\n\n    // Flush buffer in sequence\n    flushBuffer()\n\n    // Notify callback\n    if (options.onComponentReceived) {\n      options.onComponentReceived(data.component)\n    }\n  }\n\n  /**\n   * Handle SSE complete event\n   */\n  const handleCompleteEvent = (data: CompleteMetadata) => {\n    logger.info('Stream completed', data as unknown as Record<string, unknown>)\n\n    setIsStreaming(false)\n    setIsLoading(false)\n    // Normalize executionTimeMs to executionTime for compatibility with FooterRenderer\n    setMetadata({\n      ...data,\n      executionTime: data.executionTimeMs || data.executionTime,\n    })\n\n    // Flush any remaining buffered components\n    flushBuffer()\n\n    setProgress((prev) => ({\n      ...prev,\n      message: msg('dashboardLoaded'),\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onComplete) {\n      options.onComplete(data)\n    }\n  }\n\n  /**\n   * Handle SSE error event\n   */\n  const handleErrorEvent = (data: StreamError) => {\n    logger.error('Stream error received', data as unknown as Record<string, unknown>)\n\n    setError(data)\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: formatMCPUIString(msg('errorProgress'), { message: data.message }),\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onError) {\n      options.onError(data)\n    }\n\n    // Try to reconnect if recoverable\n    if (data.recoverable && reconnectAttempts < maxReconnectAttempts) {\n      reconnectAttempts++\n      logger.warn('Attempting to reconnect', { attempt: reconnectAttempts })\n      setTimeout(() => startStreaming(), 1000 * reconnectAttempts)\n    }\n  }\n\n  /**\n   * Parse SSE event\n   */\n  const parseSSEEvent = (event: MessageEvent, eventType: SSEEventType) => {\n    try {\n      const data = JSON.parse(event.data)\n\n      switch (eventType) {\n        case 'status':\n          handleStatusEvent(data as StatusEvent)\n          break\n        case 'component-start':\n          handleComponentStartEvent(data as ComponentStartEvent)\n          break\n        case 'component':\n          handleComponentEvent(data as ComponentEvent)\n          break\n        case 'complete':\n          handleCompleteEvent(data as CompleteMetadata)\n          break\n        case 'error':\n          handleErrorEvent(data as StreamError)\n          break\n        default:\n          logger.warn('Unknown SSE event type', { eventType })\n      }\n    } catch (error) {\n      logger.error('Failed to parse SSE event', {\n        error: error instanceof Error ? error.message : String(error),\n        eventType,\n      })\n    }\n  }\n\n  /**\n   * Start SSE streaming\n   */\n  const startStreaming = () => {\n    // SSR Guard: Prevent execution on server-side (Node.js environment)\n    // fetch() and ReadableStream APIs are only available in browsers\n    if (isServer) {\n      logger.warn('startStreaming called on server-side - skipping')\n      setError({\n        error: 'ssr',\n        message: msg('serverSide'),\n        recoverable: false,\n      })\n      setIsLoading(false)\n      return\n    }\n\n    // Reset state\n    setComponents([])\n    setError(null)\n    setIsLoading(true)\n    setIsStreaming(true)\n    componentBuffer = {}\n    nextSequenceId = 0\n\n    setProgress({\n      receivedCount: 0,\n      totalCount: null,\n      message: msg('connecting'),\n      timestamp: new Date().toISOString(),\n    })\n\n    logger.info('Starting SSE stream', {\n      query: options.query,\n      spaceIds: options.spaceIds,\n    })\n\n    // Build request body\n    const requestBody = {\n      query: options.query,\n      spaceIds: options.spaceIds,\n      sessionId: options.sessionId,\n      options: options.options,\n    }\n\n    // Create EventSource (SSE connection)\n    // Note: EventSource doesn't support POST, so we need to use fetch + ReadableStream\n    fetch('/api/mcp/generative-ui-stream', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(requestBody),\n    })\n      .then(async (response) => {\n        if (!response.ok) {\n          const errorData = await response.json()\n          throw new Error(errorData.message || msg('requestFailed'))\n        }\n\n        if (!response.body) {\n          throw new Error(msg('emptyResponse'))\n        }\n\n        const reader = response.body.getReader()\n        const decoder = new TextDecoder()\n\n        let buffer = ''\n\n        // Read stream\n        const readChunk = async (): Promise<void> => {\n          const { done, value } = await reader.read()\n\n          if (done) {\n            logger.info('Stream ended')\n            return\n          }\n\n          buffer += decoder.decode(value, { stream: true })\n\n          // Process SSE messages\n          const lines = buffer.split('\\n')\n          buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n          let currentEvent: SSEEventType | null = null\n\n          for (const line of lines) {\n            if (line.startsWith('event: ')) {\n              currentEvent = line.slice(7) as SSEEventType\n            } else if (line.startsWith('data: ') && currentEvent) {\n              const data = line.slice(6)\n              parseSSEEvent({ data } as MessageEvent, currentEvent)\n              currentEvent = null\n            }\n          }\n\n          // Continue reading\n          return readChunk()\n        }\n\n        await readChunk()\n      })\n      .catch((err) => {\n        logger.error('Stream fetch failed', {\n          error: err instanceof Error ? err.message : String(err),\n        })\n\n        handleErrorEvent({\n          error: msg('connectionFailed'),\n          message: err instanceof Error ? err.message : msg('unknownError'),\n          recoverable: true,\n        })\n      })\n  }\n\n  /**\n   * Stop streaming\n   */\n  const stopStreaming = () => {\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    logger.info('Streaming stopped')\n  }\n\n  /**\n   * Cleanup on unmount\n   */\n  onCleanup(() => {\n    stopStreaming()\n  })\n\n  // Auto-start streaming\n  startStreaming()\n\n  // Return state accessors and controls\n  return {\n    components,\n    isLoading,\n    isStreaming,\n    error,\n    progress,\n    metadata,\n    startStreaming,\n    stopStreaming,\n  }\n}\n"],"names":["error"],"mappings":"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"}

package/dist/hooks.cjs

@@ -9,6 +9,7 @@ const useDragDrop = require("./hooks/useDragDrop.cjs");
 const useResize = require("./hooks/useResize.cjs");
 const useAutocomplete = require("./hooks/useAutocomplete.cjs");
 const useDataValidator = require("./hooks/useDataValidator.cjs");
+exports.DEFAULT_STREAMING_UI_MESSAGES = useStreamingUI.DEFAULT_STREAMING_UI_MESSAGES;
 exports.useStreamingUI = useStreamingUI.useStreamingUI;
 exports.useAction = useAction.useAction;
 exports.useToolAction = useAction.useToolAction;

package/dist/hooks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"hooks.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/hooks.js

@@ -1,4 +1,4 @@
-import { useStreamingUI } from "./hooks/useStreamingUI.js";
+import { DEFAULT_STREAMING_UI_MESSAGES, useStreamingUI } from "./hooks/useStreamingUI.js";
 import { useAction, useToolAction } from "./hooks/useAction.js";
 import { evaluateCondition, useConditionalField } from "./hooks/useConditionalField.js";
 import { useConfirmModal, useModal } from "./hooks/useModal.js";
@@ -8,6 +8,7 @@ import { useResize } from "./hooks/useResize.js";
 import { useAutocomplete } from "./hooks/useAutocomplete.js";
 import { useDataValidator } from "./hooks/useDataValidator.js";
 export {
+  DEFAULT_STREAMING_UI_MESSAGES,
   evaluateCondition,
   useAction,
   useAutocomplete,

package/dist/index.cjs

@@ -44,15 +44,18 @@ const useResize = require("./hooks/useResize.cjs");
 const useAutocomplete = require("./hooks/useAutocomplete.cjs");
 const useDataValidator = require("./hooks/useDataValidator.cjs");
 const AutocompleteContext = require("./context/AutocompleteContext.cjs");
+const validation = require("./services/validation.cjs");
+const degradedProjections = require("./utils/degraded-projections.cjs");
+const chartDataTable = require("./components/chart-data-table.cjs");
 const chatBus = require("./services/chat-bus.cjs");
 const chatPromptController = require("./services/chat-prompt-controller.cjs");
 const index = require("./testing/index.cjs");
 const componentRegistry = require("./services/component-registry.cjs");
-const validation = require("./services/validation.cjs");
 const MCPActionContext = require("./context/MCPActionContext.cjs");
 const groq = require("./plugins/groq.cjs");
 const rest = require("./plugins/rest.cjs");
 const supabase = require("./plugins/supabase.cjs");
+const formatString = require("./utils/format-string.cjs");
 const dataValidator = require("./services/data-validator.cjs");
 exports.UIResourceRenderer = UIResourceRenderer.UIResourceRenderer;
 exports.renderCellValue = UIResourceRenderer.renderCellValue;
@@ -108,11 +111,13 @@ exports.setDuplicateMountReporter = duplicateMountRegistry.setDuplicateMountRepo
 exports.DEFAULT_MCPUI_STRINGS = MCPUIStringsContext.DEFAULT_MCPUI_STRINGS;
 exports.MCPUIStringsContext = MCPUIStringsContext.MCPUIStringsContext;
 exports.MCPUIStringsProvider = MCPUIStringsContext.MCPUIStringsProvider;
+exports.resolveMCPUILocale = MCPUIStringsContext.resolveMCPUILocale;
 exports.useMCPUIStrings = MCPUIStringsContext.useMCPUIStrings;
 exports.MCPUITelemetryContext = MCPUITelemetryContext.MCPUITelemetryContext;
 exports.MCPUITelemetryProvider = MCPUITelemetryContext.MCPUITelemetryProvider;
 exports.useTelemetry = MCPUITelemetryContext.useTelemetry;
 exports.createTelemetryDispatcher = telemetry.createTelemetryDispatcher;
+exports.DEFAULT_STREAMING_UI_MESSAGES = useStreamingUI.DEFAULT_STREAMING_UI_MESSAGES;
 exports.useStreamingUI = useStreamingUI.useStreamingUI;
 exports.useAction = useAction.useAction;
 exports.useToolAction = useAction.useToolAction;
@@ -128,6 +133,22 @@ exports.useDataValidator = useDataValidator.useDataValidator;
 exports.AutocompleteProvider = AutocompleteContext.AutocompleteProvider;
 exports.useAutocompleteContext = AutocompleteContext.useAutocompleteContext;
 exports.useAutocompleteContextSafe = AutocompleteContext.useAutocompleteContextSafe;
+exports.DEFAULT_IFRAME_DOMAINS = validation.DEFAULT_IFRAME_DOMAINS;
+exports.DEFAULT_RESOURCE_LIMITS = validation.DEFAULT_RESOURCE_LIMITS;
+exports.DEFAULT_VALIDATION_MESSAGES = validation.DEFAULT_VALIDATION_MESSAGES;
+exports.TRUSTED_IFRAME_DOMAINS = validation.TRUSTED_IFRAME_DOMAINS;
+exports.getIframeSandbox = validation.getIframeSandbox;
+exports.validateComponent = validation.validateComponent;
+exports.validateFieldValue = validation.validateFieldValue;
+exports.validateFormData = validation.validateFormData;
+exports.validateIframeDomain = validation.validateIframeDomain;
+exports.validateLayout = validation.validateLayout;
+exports.DEGRADED_PROJECTION_LABELS = degradedProjections.DEGRADED_PROJECTION_LABELS;
+exports.chartToDegradedTable = degradedProjections.chartToDegradedTable;
+exports.graphToDegradedTable = degradedProjections.graphToDegradedTable;
+exports.mapToDegradedTable = degradedProjections.mapToDegradedTable;
+exports.CHART_DATA_TABLE_LABELS = chartDataTable.CHART_DATA_TABLE_LABELS;
+exports.chartToDataTable = chartDataTable.chartToDataTable;
 exports.clarificationToPromptConfig = chatBus.clarificationToPromptConfig;
 exports.createChatBus = chatBus.createChatBus;
 exports.createCommandHandler = chatBus.createCommandHandler;
@@ -138,13 +159,6 @@ exports.PromptReplacedError = chatPromptController.PromptReplacedError;
 exports.createChatPromptController = chatPromptController.createChatPromptController;
 exports.createMockChatBus = index.createMockChatBus;
 exports.ComponentRegistry = componentRegistry.ComponentRegistry;
-exports.DEFAULT_IFRAME_DOMAINS = validation.DEFAULT_IFRAME_DOMAINS;
-exports.DEFAULT_RESOURCE_LIMITS = validation.DEFAULT_RESOURCE_LIMITS;
-exports.TRUSTED_IFRAME_DOMAINS = validation.TRUSTED_IFRAME_DOMAINS;
-exports.getIframeSandbox = validation.getIframeSandbox;
-exports.validateComponent = validation.validateComponent;
-exports.validateIframeDomain = validation.validateIframeDomain;
-exports.validateLayout = validation.validateLayout;
 exports.MCPActionContext = MCPActionContext.MCPActionContext;
 exports.MCPActionProvider = MCPActionContext.MCPActionProvider;
 exports.useMCPAction = MCPActionContext.useMCPAction;
@@ -152,5 +166,6 @@ exports.useMCPActionSafe = MCPActionContext.useMCPActionSafe;
 exports.createGroqPlugin = groq.createGroqPlugin;
 exports.createRestPlugin = rest.createRestPlugin;
 exports.createSupabasePlugin = supabase.createSupabasePlugin;
+exports.formatMCPUIString = formatString.formatMCPUIString;
 exports.validateAgainstSource = dataValidator.validateAgainstSource;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.cts

@@ -67,7 +67,7 @@ export { markRenderStart, markRenderEnd, PERF_PREFIX } from './utils/perf';
 export { getUiResourceStableKey } from './utils/stable-key';
 export { setDuplicateMountReporter } from './utils/duplicate-mount-registry';
 export type { DuplicateMountInfo, DuplicateMountReporter, } from './utils/duplicate-mount-registry';
-export { MCPUIStringsProvider, MCPUIStringsContext, useMCPUIStrings, DEFAULT_MCPUI_STRINGS, } from './context/MCPUIStringsContext';
+export { MCPUIStringsProvider, MCPUIStringsContext, useMCPUIStrings, DEFAULT_MCPUI_STRINGS, formatMCPUIString, resolveMCPUILocale, } from './context/MCPUIStringsContext';
 export type { MCPUIStrings, MCPUIStringsProviderProps, } from './context/MCPUIStringsContext';
 export { MCPUITelemetryProvider, MCPUITelemetryContext, useTelemetry, } from './context/MCPUITelemetryContext';
 export type { MCPUITelemetryProviderProps } from './context/MCPUITelemetryContext';
@@ -91,8 +91,8 @@ export type { BriefingDiffProps } from './components/BriefingDiff';
 export type { GhostTextProps, GhostTextInputProps } from './components/GhostText';
 export type { AutocompleteDropdownProps } from './components/AutocompleteDropdown';
 export type { AutocompleteFormFieldProps, AutocompleteFormFieldParams } from './components/AutocompleteFormField';
-export { useStreamingUI, useAction, useToolAction, useConditionalField, evaluateCondition, useModal, useConfirmModal, useFormPersistence, useDragDrop, useResize, useAutocomplete, useDataValidator, } from './hooks';
-export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, UseActionReturn, UseActionOptions, UseToolActionReturn, UseConditionalFieldOptions, UseModalReturn, UseConfirmModalReturn, UseFormPersistenceOptions, UseFormPersistenceReturn, UseDragDropOptions, UseDragDropReturn, DragProps, UseResizeOptions, UseResizeReturn, ResizeEdge, UseAutocompleteOptions, UseAutocompleteReturn, UseDataValidatorOptions, UseDataValidatorReturn, } from './hooks';
+export { useStreamingUI, DEFAULT_STREAMING_UI_MESSAGES, useAction, useToolAction, useConditionalField, evaluateCondition, useModal, useConfirmModal, useFormPersistence, useDragDrop, useResize, useAutocomplete, useDataValidator, } from './hooks';
+export type { UseStreamingUIOptions, StreamingUIMessages, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, UseActionReturn, UseActionOptions, UseToolActionReturn, UseConditionalFieldOptions, UseModalReturn, UseConfirmModalReturn, UseFormPersistenceOptions, UseFormPersistenceReturn, UseDragDropOptions, UseDragDropReturn, DragProps, UseResizeOptions, UseResizeReturn, ResizeEdge, UseAutocompleteOptions, UseAutocompleteReturn, UseDataValidatorOptions, UseDataValidatorReturn, } from './hooks';
 export { MCPActionProvider, MCPActionContext, useMCPAction, useMCPActionSafe } from './context';
 export { AutocompleteProvider, useAutocompleteContext, useAutocompleteContextSafe, } from './context/AutocompleteContext';
 export type { MCPActionContextValue, MCPActionProviderProps, ActionRequest, ActionResult, } from './context';
@@ -100,6 +100,12 @@ export type { AutocompleteContextValue, AutocompleteProviderProps, } from './con
 export { createGroqPlugin, createSupabasePlugin, createRestPlugin, } from './plugins';
 export type { UIComponent, UILayout, GridPosition, ComponentType, RendererError, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, ActionComponentParams, GridComponentParams, FormFieldOption, FormFieldType, FormFieldParams, FormComponentParams, ShowWhenOperator, ShowWhenCondition, ActionRequestBase, ActionResultBase, ActionLifecycleCallbacks, ModalSize, ModalComponentParams, ActionGroupLayout, ActionGroupGap, ActionGroupParams, GalleryImage, ImageGalleryParams, VideoComponentParams, CodeComponentParams, LatLngPoint, MapMarker, MapComponentParams, MapPopupConfig, MapGeoJSONStyle, MapLayer, MapPMTilesConfig, IframePolicy, ValidationOptions, ResizeConstraints, DragDropConfig, DragEventData, DraggableGridItemProps as DraggableGridItemPropsType, AutocompleteResultType, AutocompleteOption, AutocompleteResult, AutocompleteContext, AutocompletePlugin, GroqPluginConfig, SupabasePluginConfig, DuckDBPluginConfig, RestPluginConfig, FieldAutocompleteConfig, AutocompleteProviderConfig, } from './types';
 export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, ComponentRegistry, createEventEmitter, createCommandHandler, createChatBus, mergeScratchpadSections, validateAgainstSource, } from './services';
+export { validateFieldValue, validateFormData, DEFAULT_VALIDATION_MESSAGES, } from './services/validation';
+export type { FormValidationMessages } from './services/validation';
+export { graphToDegradedTable, mapToDegradedTable, chartToDegradedTable, DEGRADED_PROJECTION_LABELS, } from './utils/degraded-projections';
+export type { DegradedProjectionLabels } from './utils/degraded-projections';
+export { chartToDataTable, CHART_DATA_TABLE_LABELS } from './components/chart-data-table';
+export type { ChartDataTableLabels } from './components/chart-data-table';
 export { clarificationToPromptConfig } from './services/chat-bus';
 export { elicitationToPromptConfig } from './services/chat-bus';
 export { createChatPromptController, PromptReplacedError, } from './services/chat-prompt-controller';

package/dist/index.d.ts

@@ -67,7 +67,7 @@ export { markRenderStart, markRenderEnd, PERF_PREFIX } from './utils/perf';
 export { getUiResourceStableKey } from './utils/stable-key';
 export { setDuplicateMountReporter } from './utils/duplicate-mount-registry';
 export type { DuplicateMountInfo, DuplicateMountReporter, } from './utils/duplicate-mount-registry';
-export { MCPUIStringsProvider, MCPUIStringsContext, useMCPUIStrings, DEFAULT_MCPUI_STRINGS, } from './context/MCPUIStringsContext';
+export { MCPUIStringsProvider, MCPUIStringsContext, useMCPUIStrings, DEFAULT_MCPUI_STRINGS, formatMCPUIString, resolveMCPUILocale, } from './context/MCPUIStringsContext';
 export type { MCPUIStrings, MCPUIStringsProviderProps, } from './context/MCPUIStringsContext';
 export { MCPUITelemetryProvider, MCPUITelemetryContext, useTelemetry, } from './context/MCPUITelemetryContext';
 export type { MCPUITelemetryProviderProps } from './context/MCPUITelemetryContext';
@@ -91,8 +91,8 @@ export type { BriefingDiffProps } from './components/BriefingDiff';
 export type { GhostTextProps, GhostTextInputProps } from './components/GhostText';
 export type { AutocompleteDropdownProps } from './components/AutocompleteDropdown';
 export type { AutocompleteFormFieldProps, AutocompleteFormFieldParams } from './components/AutocompleteFormField';
-export { useStreamingUI, useAction, useToolAction, useConditionalField, evaluateCondition, useModal, useConfirmModal, useFormPersistence, useDragDrop, useResize, useAutocomplete, useDataValidator, } from './hooks';
-export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, UseActionReturn, UseActionOptions, UseToolActionReturn, UseConditionalFieldOptions, UseModalReturn, UseConfirmModalReturn, UseFormPersistenceOptions, UseFormPersistenceReturn, UseDragDropOptions, UseDragDropReturn, DragProps, UseResizeOptions, UseResizeReturn, ResizeEdge, UseAutocompleteOptions, UseAutocompleteReturn, UseDataValidatorOptions, UseDataValidatorReturn, } from './hooks';
+export { useStreamingUI, DEFAULT_STREAMING_UI_MESSAGES, useAction, useToolAction, useConditionalField, evaluateCondition, useModal, useConfirmModal, useFormPersistence, useDragDrop, useResize, useAutocomplete, useDataValidator, } from './hooks';
+export type { UseStreamingUIOptions, StreamingUIMessages, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, UseActionReturn, UseActionOptions, UseToolActionReturn, UseConditionalFieldOptions, UseModalReturn, UseConfirmModalReturn, UseFormPersistenceOptions, UseFormPersistenceReturn, UseDragDropOptions, UseDragDropReturn, DragProps, UseResizeOptions, UseResizeReturn, ResizeEdge, UseAutocompleteOptions, UseAutocompleteReturn, UseDataValidatorOptions, UseDataValidatorReturn, } from './hooks';
 export { MCPActionProvider, MCPActionContext, useMCPAction, useMCPActionSafe } from './context';
 export { AutocompleteProvider, useAutocompleteContext, useAutocompleteContextSafe, } from './context/AutocompleteContext';
 export type { MCPActionContextValue, MCPActionProviderProps, ActionRequest, ActionResult, } from './context';
@@ -100,6 +100,12 @@ export type { AutocompleteContextValue, AutocompleteProviderProps, } from './con
 export { createGroqPlugin, createSupabasePlugin, createRestPlugin, } from './plugins';
 export type { UIComponent, UILayout, GridPosition, ComponentType, RendererError, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, ActionComponentParams, GridComponentParams, FormFieldOption, FormFieldType, FormFieldParams, FormComponentParams, ShowWhenOperator, ShowWhenCondition, ActionRequestBase, ActionResultBase, ActionLifecycleCallbacks, ModalSize, ModalComponentParams, ActionGroupLayout, ActionGroupGap, ActionGroupParams, GalleryImage, ImageGalleryParams, VideoComponentParams, CodeComponentParams, LatLngPoint, MapMarker, MapComponentParams, MapPopupConfig, MapGeoJSONStyle, MapLayer, MapPMTilesConfig, IframePolicy, ValidationOptions, ResizeConstraints, DragDropConfig, DragEventData, DraggableGridItemProps as DraggableGridItemPropsType, AutocompleteResultType, AutocompleteOption, AutocompleteResult, AutocompleteContext, AutocompletePlugin, GroqPluginConfig, SupabasePluginConfig, DuckDBPluginConfig, RestPluginConfig, FieldAutocompleteConfig, AutocompleteProviderConfig, } from './types';
 export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, ComponentRegistry, createEventEmitter, createCommandHandler, createChatBus, mergeScratchpadSections, validateAgainstSource, } from './services';
+export { validateFieldValue, validateFormData, DEFAULT_VALIDATION_MESSAGES, } from './services/validation';
+export type { FormValidationMessages } from './services/validation';
+export { graphToDegradedTable, mapToDegradedTable, chartToDegradedTable, DEGRADED_PROJECTION_LABELS, } from './utils/degraded-projections';
+export type { DegradedProjectionLabels } from './utils/degraded-projections';
+export { chartToDataTable, CHART_DATA_TABLE_LABELS } from './components/chart-data-table';
+export type { ChartDataTableLabels } from './components/chart-data-table';
 export { clarificationToPromptConfig } from './services/chat-bus';
 export { elicitationToPromptConfig } from './services/chat-bus';
 export { createChatPromptController, PromptReplacedError, } from './services/chat-prompt-controller';

package/dist/index.d.ts.map

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