@flamingo-stack/openframe-frontend-core 0.0.586 → 0.0.587-1973.5528.1

package/src/components/chat/chat-message-list.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import {
+  Fragment,
   useRef,
   useState,
   useCallback,
@@ -138,6 +139,7 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
       renderContextItem,
       renderMention,
       onAskSelect,
+      renderAfterMessage,
       NavLinkAnchor,
       ...props
     },
@@ -986,28 +988,31 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
                     (!Array.isArray(message.content) || message.content.every(s => s.type === 'text'));
                   if (isEmptyPendingTurn) return null;
                   return (
-                    <ChatMessageEnhanced
-                      key={message.id}
-                      ref={getRegisterMessageEl(message.id)}
-                      role={message.role}
-                      name={message.name}
-                      content={message.content}
-                      timestamp={message.timestamp}
-                      isTyping={index === messages.length - 1 && isTyping && message.role === 'assistant'}
-                      avatar={showAvatars ? message.avatar : null}
-                      showAvatar={showAvatars}
-                      assistantType={message.assistantType || assistantType}
-                      approvalVariant={approvalVariant}
-                      authorType={message.authorType}
-                      assistantIcon={message.role !== 'user' ? assistantIcon : undefined}
-                      contextItems={message.contextItems}
-                      resolveContextIcon={resolveContextIcon}
-                      renderContextItem={renderContextItem}
-                      renderMention={renderMention}
-                      renderEntityCard={renderEntityCard}
-                      onAskSelect={index > lastUserMessageIndex ? onAskSelect : undefined}
-                      NavLinkAnchor={NavLinkAnchor}
-                    />
+                    <Fragment key={message.id}>
+                      <ChatMessageEnhanced
+                        ref={getRegisterMessageEl(message.id)}
+                        role={message.role}
+                        name={message.name}
+                        content={message.content}
+                        timestamp={message.timestamp}
+                        isTyping={index === messages.length - 1 && isTyping && message.role === 'assistant'}
+                        avatar={showAvatars ? message.avatar : null}
+                        showAvatar={showAvatars}
+                        assistantType={message.assistantType || assistantType}
+                        approvalVariant={approvalVariant}
+                        authorType={message.authorType}
+                        assistantIcon={message.role !== 'user' ? assistantIcon : undefined}
+                        contextItems={message.contextItems}
+                        resolveContextIcon={resolveContextIcon}
+                        renderContextItem={renderContextItem}
+                        renderMention={renderMention}
+                        renderEntityCard={renderEntityCard}
+                        refs={message.refs}
+                        onAskSelect={index > lastUserMessageIndex ? onAskSelect : undefined}
+                        NavLinkAnchor={NavLinkAnchor}
+                      />
+                      {renderAfterMessage?.(message, index)}
+                    </Fragment>
                   );
                 })}
               </div>

package/src/components/chat/embeddable-chat.tsx

@@ -808,13 +808,14 @@ function SourceChips({
   const [expanded, setExpanded] = useState(false);
 
   if (cited.length === 0) {
-    const fallback = uncited.slice(0, FALLBACK_TOP_RETRIEVED);
-    if (fallback.length === 0) return null;
+    const visible = expanded ? uncited : uncited.slice(0, FALLBACK_TOP_RETRIEVED);
+    const hiddenCount = Math.max(0, uncited.length - FALLBACK_TOP_RETRIEVED);
+    if (visible.length === 0) return null;
     return (
       <div className="mt-2 flex flex-col gap-1.5 border-t border-ods-border pt-2">
         <span className="uppercase text-ods-text-muted text-h6">Top retrieved sources</span>
-        <div className="flex flex-wrap gap-1.5">
-          {fallback.map(src => (
+        <div className={`flex flex-wrap gap-1.5 ${expanded ? 'max-h-[200px] overflow-y-auto overscroll-contain' : ''}`}>
+          {visible.map(src => (
             <SourceChip
               key={src.index}
               src={src}
@@ -824,6 +825,16 @@ function SourceChips({
               onDiscuss={onDiscuss}
             />
           ))}
+          {hiddenCount > 0 && (
+            <button
+              onClick={() => setExpanded(!expanded)}
+              className="inline-flex cursor-pointer items-center gap-1 rounded border border-ods-accent bg-ods-card px-2 py-0.5 text-ods-accent transition-colors text-h6 hover:bg-ods-accent/10"
+              aria-expanded={expanded}
+              aria-label={expanded ? 'Show fewer sources' : `Show ${hiddenCount} additional retrieved sources`}
+            >
+              {expanded ? 'Show less' : `+${hiddenCount} more retrieved ${hiddenCount === 1 ? 'source' : 'sources'}`}
+            </button>
+          )}
         </div>
       </div>
     );
@@ -1579,6 +1590,10 @@ function EmbeddableChatInner({
         // explicitly — see `Message.hidden` and `chat-message-list`'s skip.
         ...(m.hidden ? { hidden: true } : {}),
         ...(m.scrollAnchor ? { scrollAnchor: m.scrollAnchor } : {}),
+        // Preserve same-turn rich metadata. Source chips and entity-card
+        // renderers consume it after this raw-to-Message projection.
+        ...(m.sources && m.sources.length > 0 ? { sources: m.sources } : {}),
+        ...(m.refs && m.refs.length > 0 ? { refs: m.refs } : {}),
         // Forward attached context items so the user bubble renders its chips.
         ...(m.contextItems && m.contextItems.length > 0 ? { contextItems: m.contextItems } : {}),
       };
@@ -1829,24 +1844,41 @@ function EmbeddableChatInner({
     return out;
   }, [commandsById, enabledSet]);
 
-  // Find sources for the last assistant message; split into cited / uncited.
-  const lastAssistantMsg = [...rawMessages].reverse().find(m => m.role === 'assistant');
-  const lastSources = useMemo(() => {
-    if (chatLoading) return undefined;
-    const sources = lastAssistantMsg?.sources;
-    if (!sources || sources.length === 0) return undefined;
-    const content = lastAssistantMsg?.content || '';
-    const citationOrder = [...content.matchAll(/\[(\d+)\]/g)].map(m => parseInt(m[1], 10));
-    const seenOrder = new Map<number, number>();
-    citationOrder.forEach(idx => {
-      if (!seenOrder.has(idx)) seenOrder.set(idx, seenOrder.size);
-    });
-    const cited = sources
-      .filter(s => seenOrder.has(s.index))
-      .sort((a, b) => (seenOrder.get(a.index) ?? 0) - (seenOrder.get(b.index) ?? 0));
-    const uncited = sources.filter(s => !seenOrder.has(s.index));
-    return { cited, uncited };
-  }, [lastAssistantMsg, chatLoading]);
+  const renderSourcesAfterMessage = useCallback(
+    (message: Message, index: number) => {
+      if (message.role !== 'assistant' || !message.sources?.length) return null;
+      if (chatLoading && index === messages.length - 1) return null;
+      const content =
+        typeof message.content === 'string'
+          ? message.content
+          : message.content
+              .filter(segment => segment.type === 'text')
+              .map(segment => segment.text)
+              .join('\n');
+      const citationOrder = [...content.matchAll(/\[(\d+)\]/g)].map(m => parseInt(m[1], 10));
+      const seenOrder = new Map<number, number>();
+      citationOrder.forEach(idx => {
+        if (!seenOrder.has(idx)) seenOrder.set(idx, seenOrder.size);
+      });
+      const cited = message.sources
+        .filter(s => seenOrder.has(s.index))
+        .sort((a, b) => (seenOrder.get(a.index) ?? 0) - (seenOrder.get(b.index) ?? 0));
+      const uncited = message.sources.filter(s => !seenOrder.has(s.index));
+      return (
+        <div className="flex-shrink-0 pb-2">
+          <SourceChips
+            cited={cited}
+            uncited={uncited}
+            baseRoute={resolvedBaseRoute}
+            chipBasePlatform={chipBasePlatform}
+            onClose={handleNavigationClose}
+            onDiscuss={discussRef}
+          />
+        </div>
+      );
+    },
+    [chatLoading, messages.length, resolvedBaseRoute, chipBasePlatform, handleNavigationClose, discussRef],
+  );
 
   // Host node for in-panel Radix portals (see the body wrapper below).
   const [portalHost, setPortalHost] = useState<HTMLDivElement | null>(null);
@@ -2390,6 +2422,7 @@ function EmbeddableChatInner({
                                   resolveContextIcon={resolveContextIcon}
                                   renderContextItem={renderContextItem}
                                   renderMention={renderMention}
+                                  renderAfterMessage={renderSourcesAfterMessage}
                                   // Gated on `chatLoading` for the same reason the composer
                                   // is: no second send while a turn is in flight. Passive
                                   // demo hosts (previewMode) stay read-only.
@@ -2427,20 +2460,6 @@ function EmbeddableChatInner({
                                   onLoadMore={loadMoreMessages}
                                 />
                               )}
-                              {lastSources &&
-                                (lastSources.cited.length > 0 || lastSources.uncited.length > 0) &&
-                                !chatLoading && (
-                                  <div className="flex-shrink-0 pb-2">
-                                    <SourceChips
-                                      cited={lastSources.cited}
-                                      uncited={lastSources.uncited}
-                                      baseRoute={resolvedBaseRoute}
-                                      chipBasePlatform={chipBasePlatform}
-                                      onClose={handleNavigationClose}
-                                      onDiscuss={discussRef}
-                                    />
-                                  </div>
-                                )}
                             </div>
                           ) : activeMode === 'mingo' ? (
                             /* Figma node 7532:222444 — default (Mingo-mode) empty state:

package/src/components/chat/entity-cards/__tests__/dispatch-video-refs.test.tsx

@@ -0,0 +1,74 @@
+import React from 'react';
+import { describe, expect, it } from 'vitest';
+import type { ChatRef } from '../../chat-ref.types';
+import { BlockCard } from '../block-card';
+import { ChatVideoEntityCard } from '../chat-video-entity-card';
+import { renderChatInlineEntityCard } from '../dispatch';
+
+describe('renderChatInlineEntityCard video refs', () => {
+  it.each([
+    {
+      id: 'MdFJNoJeqZQ',
+      url: 'https://www.youtube.com/watch?v=MdFJNoJeqZQ',
+      metadata: { youtubeUrl: 'MdFJNoJeqZQ' },
+    },
+    {
+      id: 'mux-9b6586b494',
+      url: 'https://stream.mux.com/playback-id.m3u8',
+      metadata: { videoUrl: 'https://stream.mux.com/playback-id.m3u8' },
+    },
+    {
+      id: 'mp4-1b2047dc1b',
+      url: 'https://cdn.example.test/product-overview.mp4',
+      metadata: { videoUrl: 'https://cdn.example.test/product-overview.mp4' },
+    },
+  ])('passes playable metadata for $id to the video card', ({ id, url, metadata }) => {
+    const ref: ChatRef = { type: 'video', id, title: 'Video', url, metadata };
+
+    const result = renderChatInlineEntityCard(ref);
+
+    expect(React.isValidElement(result)).toBe(true);
+    const block = result as React.ReactElement<React.ComponentProps<typeof BlockCard>>;
+    expect(block.type).toBe(BlockCard);
+    const video = block.props.children as React.ReactElement<React.ComponentProps<typeof ChatVideoEntityCard>>;
+    expect(video.type).toBe(ChatVideoEntityCard);
+    expect(video.props.chatRef.metadata).toMatchObject(metadata);
+  });
+
+  it('lets a validated top-level URL override conflicting route metadata', () => {
+    const ref: ChatRef = {
+      type: 'video',
+      id: 'mux-9b6586b494',
+      title: 'Video',
+      url: 'https://stream.mux.com/trusted-playback.m3u8',
+      metadata: {
+        videoUrl: 'https://cdn.example.test/untrusted.mp4',
+        youtubeUrl: 'untrustedId',
+      },
+    };
+
+    const result = renderChatInlineEntityCard(ref);
+    const block = result as React.ReactElement<React.ComponentProps<typeof BlockCard>>;
+    const video = block.props.children as React.ReactElement<React.ComponentProps<typeof ChatVideoEntityCard>>;
+
+    expect(video.props.chatRef.metadata).toEqual({
+      videoUrl: 'https://stream.mux.com/trusted-playback.m3u8',
+    });
+  });
+
+  it('keeps a direct-video URL direct when its query mentions a YouTube URL', () => {
+    const directUrl = 'https://cdn.example.test/product-overview.mp4?source=youtube.com/watch?v=MdFJNoJeqZQ';
+    const ref: ChatRef = {
+      type: 'video',
+      id: 'mp4-direct',
+      title: 'Product overview',
+      url: directUrl,
+    };
+
+    const result = renderChatInlineEntityCard(ref);
+    const block = result as React.ReactElement<React.ComponentProps<typeof BlockCard>>;
+    const video = block.props.children as React.ReactElement<React.ComponentProps<typeof ChatVideoEntityCard>>;
+
+    expect(video.props.chatRef.metadata).toEqual({ videoUrl: directUrl });
+  });
+});

package/src/components/chat/entity-cards/dispatch.tsx

@@ -30,6 +30,7 @@
  */
 
 import React, { type ReactNode } from 'react';
+import { isSourceMetadataCardRef } from '../../../chat-protocol/source-metadata';
 import { useRequiredChatRuntime } from '../../../contexts/chat-runtime-context';
 import Image from '../../../embed-shims/next-image';
 import { useRouter } from '../../../embed-shims/next-navigation';
@@ -41,6 +42,7 @@ import {
   formatTimeWithTimezone,
   formatDurationFromRange,
 } from '../../../utils/format';
+import { extractYouTubeId } from '../../features/video';
 import { MingoIcon } from '../../icons';
 import { ArrowRightUpIcon } from '../../icons-v2-generated/arrows/arrow-right-up-icon';
 import { ClickupLogoIcon } from '../../icons-v2-generated/brand-logos/clickup-logo-icon';
@@ -422,6 +424,15 @@ function hubspotStatusToVariant(status: string | undefined): MingoInfoCardStatus
  * which renders the marker as plain text (same anti-hallucination
  * posture as every other card type).
  */
+function validatedHttpsUrl(value: unknown): string | null {
+  if (typeof value !== 'string') return null;
+  try {
+    return new URL(value).protocol === 'https:' ? value : null;
+  } catch {
+    return null;
+  }
+}
+
 function decodeVideoMarkerId(id: string): { videoUrl?: string; youtubeUrl?: string } | null {
   // Prefix checks FIRST: an id like `mux-1234567` (11 chars) would also
   // satisfy the bare-YouTube-id pattern below.
@@ -439,8 +450,8 @@ function decodeVideoMarkerId(id: string): { videoUrl?: string; youtubeUrl?: stri
       const url = atob(b64);
       // https-only — the id is model-emitted text; never let a marker
       // smuggle a non-https src into a player.
-      if (!/^https:\/\//.test(url)) return null;
-      return { videoUrl: url };
+      const safeUrl = validatedHttpsUrl(url);
+      return safeUrl ? { videoUrl: safeUrl } : null;
     } catch {
       return null;
     }
@@ -449,6 +460,29 @@ function decodeVideoMarkerId(id: string): { videoUrl?: string; youtubeUrl?: stri
   return null;
 }
 
+function validatedVideoMetadata(chatRef: ChatRef): Record<string, unknown> | null {
+  const input = chatRef.metadata ?? {};
+  const metadata: Record<string, unknown> = {};
+  for (const key of ['videoUrl', 'highlightVideoUrl', 'videoPoster', 'highlightVideoPoster'] as const) {
+    const url = validatedHttpsUrl(input[key]);
+    if (url) metadata[key] = url;
+  }
+  const youtubeUrl = input.youtubeUrl;
+  if (typeof youtubeUrl === 'string' && /^[A-Za-z0-9_-]{11}$/.test(youtubeUrl)) {
+    metadata.youtubeUrl = youtubeUrl;
+  }
+
+  const safeUrl = validatedHttpsUrl(chatRef.url);
+  if (safeUrl) {
+    const youtubeId = extractYouTubeId(safeUrl);
+    delete metadata.videoUrl;
+    delete metadata.youtubeUrl;
+    metadata[youtubeId ? 'youtubeUrl' : 'videoUrl'] = youtubeId ?? safeUrl;
+  }
+
+  return Object.keys(metadata).length > 0 ? metadata : null;
+}
+
 /** Read hero-video metadata off a FETCHED item — the API-driven
  *  replacement for the retired refs-frame `metadata.videoUrl` check. Two item
  *  shapes: ChatRef-shaped items (per-object hydration routes) carry the
@@ -1228,6 +1262,10 @@ interface ChatCardRegistryEntry {
    *  point — a host that re-homes a type must be able to say so even when
    *  the row already carries the content host's own url. */
   noComposedHref?: boolean;
+  /** Render a document card from same-turn SOURCES metadata when its optional
+   *  hydration endpoint has no row. Only doc refs opt in: their source record
+   *  already carries the complete title/path/navigation fallback. */
+  renderFromSourceMetadata?: boolean;
 }
 
 /**
@@ -1250,6 +1288,7 @@ function refHydratedEntry(
   docType: string,
   label: string,
   renderRef: (displayRef: ChatRef, opts: ChatCardRenderOptions) => React.ReactNode,
+  renderFromSourceMetadata = false,
 ): ChatCardRegistryEntry {
   return {
     label,
@@ -1259,6 +1298,19 @@ function refHydratedEntry(
     fallbackHref: (item: { url?: string | null }) => item?.url ?? null,
     skeleton: () => <MingoInfoCardSkeleton />,
     render: (item, chatRef, opts) => renderRef(fetchedItemDisplayRef(item, chatRef), opts),
+    renderFromSourceMetadata,
+  };
+}
+
+function sourceMetadataCardItem(chatRef: ChatRef): ChatCardItem {
+  return {
+    type: chatRef.type,
+    id: chatRef.id,
+    title: chatRef.title,
+    url: chatRef.url,
+    targetPlatform: chatRef.targetPlatform,
+    sourceRepo: chatRef.sourceRepo,
+    metadata: chatRef.metadata,
   };
 }
 
@@ -1454,12 +1506,18 @@ const CHAT_CARD_REGISTRY: Record<string, ChatCardRegistryEntry> = {
   hubspot_ticket_self: refHydratedEntry('hubspot_ticket_self', 'HubSpot ticket (self)', (displayRef, opts) => (
     <HubspotTicketChatCard chatRef={displayRef} isNewTab={opts.isNewTab} discuss={opts.discuss} />
   )),
-  data_room_doc: refHydratedEntry('data_room_doc', 'Data-room doc', (displayRef, opts) => (
-    <DataRoomDocChatCard chatRef={displayRef} isNewTab={opts.isNewTab} discuss={opts.discuss} />
-  )),
-  markdown: refHydratedEntry('markdown', 'Doc page (markdown)', (displayRef, opts) => (
-    <DataRoomDocChatCard chatRef={displayRef} isNewTab={opts.isNewTab} discuss={opts.discuss} />
-  )),
+  data_room_doc: refHydratedEntry(
+    'data_room_doc',
+    'Data-room doc',
+    (displayRef, opts) => <DataRoomDocChatCard chatRef={displayRef} isNewTab={opts.isNewTab} discuss={opts.discuss} />,
+    true,
+  ),
+  markdown: refHydratedEntry(
+    'markdown',
+    'Doc page (markdown)',
+    (displayRef, opts) => <DataRoomDocChatCard chatRef={displayRef} isNewTab={opts.isNewTab} discuss={opts.discuss} />,
+    true,
+  ),
   // Body-synthesized video ids (`shortVideoId` content hashes / YouTube
   // ids) have no backing table row to fetch — ref-only by nature.
   video: {
@@ -1902,6 +1960,13 @@ export function ChatCardLoader({
   }
   if (isLoading) return <>{fetchEntry.skeleton?.() ?? null}</>;
   if (!item) {
+    const hasSourceMetadata =
+      fetchEntry.renderFromSourceMetadata &&
+      isSourceMetadataCardRef(chatRef) &&
+      typeof finalChatRef.metadata?.path === 'string';
+    if (hasSourceMetadata) {
+      return finish(fetchEntry.render(sourceMetadataCardItem(finalChatRef), finalChatRef, renderOpts));
+    }
     // FAIL LOUD (explicit product decision 2026-08-13): a card that
     // cannot hydrate renders a VISIBLE error card — silent removal made
     // broken answers look fine. Three distinguishable states:
@@ -1983,24 +2048,28 @@ export function renderChatInlineEntityCard(
     />
   );
 
-  // Embedded videos are SELF-DESCRIBING: the marker id alone recovers the
-  // playable URL (`decodeVideoMarkerId`), so the player renders on ANY
-  // transport with zero refs/fetch. Undecodable ids (legacy sha1 hashes,
-  // hallucinations) fall through to the loader → plain-text degrade.
+  // SOURCES metadata may enrich an opaque video marker with its playable URL.
+  // Self-describing marker ids remain transport-independent through
+  // `decodeVideoMarkerId`; undecodable ids without matching metadata fall
+  // through to the loader and degrade to plain text.
   // Hero videos on FETCHED entity types (webinars, releases, …) are
   // handled post-fetch inside ChatCardLoader (`itemVideoMetadata`) — the
-  // marker's ref plays no part in either path.
+  // marker metadata is not required for that post-fetch path.
   if (chatRef.type === 'video') {
+    const enrichedMetadata = validatedVideoMetadata(chatRef);
     const decoded = decodeVideoMarkerId(chatRef.id);
-    if (decoded) {
+    const playableMetadata = enrichedMetadata ?? decoded;
+    if (playableMetadata) {
       const displayRef: ChatRef = {
         ...chatRef,
         title: chatRef.title && chatRef.title !== chatRef.id ? chatRef.title : 'Video',
         url:
           chatRef.url ??
-          decoded.videoUrl ??
-          (decoded.youtubeUrl ? `https://www.youtube.com/watch?v=${decoded.youtubeUrl}` : null),
-        metadata: { ...(chatRef.metadata ?? {}), ...decoded },
+          (typeof playableMetadata.videoUrl === 'string' ? playableMetadata.videoUrl : null) ??
+          (typeof playableMetadata.youtubeUrl === 'string'
+            ? `https://www.youtube.com/watch?v=${playableMetadata.youtubeUrl}`
+            : null),
+        metadata: playableMetadata,
       };
       return (
         <BlockCard inline={<ChatInlineVideoPill chatRef={displayRef} />}>

package/src/components/chat/hooks/__tests__/use-slash-commands.test.ts

@@ -0,0 +1,64 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import type { SlashCommandSummary } from '../../types/component.types';
+
+const { embedAuthedFetchMock } = vi.hoisted(() => ({
+  embedAuthedFetchMock: vi.fn(),
+}));
+
+vi.mock('../../../../utils/embed-authed-fetch', () => ({
+  embedAuthedFetch: embedAuthedFetchMock,
+}));
+
+import { fetchSlashCommands } from '../use-slash-commands';
+
+const command = (id: string): SlashCommandSummary => ({
+  id,
+  description: `${id} description`,
+  actions: [{ id: 'browse', label: 'Recent' }],
+});
+
+const commandsUrl = 'https://hub.example/api/docs/commands';
+
+describe('fetchSlashCommands', () => {
+  beforeEach(() => {
+    embedAuthedFetchMock.mockReset();
+  });
+
+  it('fetches the full registry and filters normalized prefixes locally', async () => {
+    embedAuthedFetchMock.mockResolvedValue({
+      ok: true,
+      json: () => Promise.resolve({ commands: [command('roadmap'), command('webinars')] }),
+    });
+
+    const commands = await fetchSlashCommands(' W ', undefined, commandsUrl);
+
+    expect(commands.map(({ id }) => id)).toEqual(['webinars']);
+    expect(embedAuthedFetchMock).toHaveBeenCalledTimes(1);
+    const [requestedUrl] = embedAuthedFetchMock.mock.calls[0] as [string];
+    expect(new URL(requestedUrl).search).toBe('');
+  });
+
+  it('returns every command for an empty prefix', async () => {
+    const registry = [command('roadmap'), command('webinars')];
+    embedAuthedFetchMock.mockResolvedValue({
+      ok: true,
+      json: () => Promise.resolve({ commands: registry }),
+    });
+
+    await expect(fetchSlashCommands('', undefined, commandsUrl)).resolves.toEqual(registry);
+  });
+
+  it('caps non-empty prefix matches at ten commands', async () => {
+    embedAuthedFetchMock.mockResolvedValue({
+      ok: true,
+      json: () =>
+        Promise.resolve({
+          commands: Array.from({ length: 12 }, (_, index) => command(`webinar-${index}`)),
+        }),
+    });
+
+    const commands = await fetchSlashCommands('webinar', undefined, commandsUrl);
+
+    expect(commands).toHaveLength(10);
+  });
+});

package/src/components/chat/hooks/use-nats-chat-adapter.ts

@@ -61,6 +61,7 @@ import type {
   MessageSegment,
   NatsMessageType,
   ChatApprovalStatus,
+  ChatSource,
 } from '../types';
 import type { DialogItem } from '../types/component.types';
 import type {
@@ -352,6 +353,8 @@ export function mapProcessedToUnified(
     role: 'user' | 'assistant' | 'error';
     content: string | MessageSegment[];
     name?: string;
+    sources?: ChatSource[];
+    refs?: ChatRef[];
   }>,
 ): UnifiedChatMessage[] {
   const out: UnifiedChatMessage[] = [];
@@ -363,12 +366,16 @@ export function mapProcessedToUnified(
         role: m.role,
         content: '',
         segments: m.content,
+        ...(m.sources ? { sources: m.sources } : {}),
+        ...(m.refs ? { refs: m.refs } : {}),
       });
     } else {
       out.push({
         id: m.id,
         role: m.role,
         content: m.content,
+        ...(m.sources ? { sources: m.sources } : {}),
+        ...(m.refs ? { refs: m.refs } : {}),
       });
     }
   }

package/src/components/chat/hooks/use-slash-commands.ts

@@ -24,10 +24,12 @@ import type { SlashCommandActionId, SlashCommandSummaryAction, SlashCommandSumma
 // canonical declaration.
 export type { SlashCommandActionId, SlashCommandSummaryAction, SlashCommandSummary };
 
+const COMMANDS_MAX_RESULTS = 10;
+
 /**
- * Fetch slash-command suggestions for the CURRENT deployment platform,
- * matching id-prefix `prefix`. The chat source is server-resolved — the
- * client sends NO `source` param on the URL.
+ * Fetch the full slash-command registry for the CURRENT deployment platform,
+ * then match id-prefix `prefix` locally. The chat source is server-resolved —
+ * the client sends NO `source` param on the URL.
  *
  * `commandsUrl` is required — supplied by `useChatRuntime().endpoints.commandsUrl`
  * at the call site. NO default value.
@@ -56,13 +58,15 @@ export async function fetchSlashCommands(
 ): Promise<SlashCommandSummary[]> {
   try {
     const url = new URL(commandsUrl, window.location.origin);
-    if (prefix) url.searchParams.set('q', prefix);
     // `headers: {}` opts out of the default `Content-Type: application/json`
     // — this is a bare GET with no body, so no content-type is needed.
     const res = await embedAuthedFetch(url.toString(), { signal, headers: {} });
     if (!res.ok) return [];
     const data = (await res.json()) as { commands?: SlashCommandSummary[] };
-    return data.commands ?? [];
+    const commands = data.commands ?? [];
+    const normalizedPrefix = prefix.trim().toLowerCase();
+    if (!normalizedPrefix) return commands;
+    return commands.filter(({ id }) => id.startsWith(normalizedPrefix)).slice(0, COMMANDS_MAX_RESULTS);
   } catch (err) {
     // Cancellation (unmount / dep change) MUST propagate so react-query treats
     // it as cancelled, not as a successful empty result. Every OTHER failure

package/src/components/chat/hooks/use-sse-chat-adapter.ts

@@ -63,7 +63,7 @@ import type { ChatDialogStore } from '../stream/chat-dialog-store';
 import type { ChatStreamReducerOptions } from '../stream/chat-stream-reducer';
 import { useChatStreamReducer } from '../stream/use-chat-stream-reducer';
 import type { DialogItem } from '../types/component.types';
-import type { Message, MessageSegment } from '../types/message.types';
+import type { ChatSource, Message, MessageSegment } from '../types/message.types';
 import type {
   UnifiedChatState,
   UnifiedChatMessage,
@@ -81,6 +81,7 @@ import { useSlashCommandRegistry, type SlashCommandSummary } from './use-slash-c
 // Canonical home of the per-turn meta row moved to the stream module in
 // Phase 3; re-exported here to keep the legacy import path stable.
 export type { ChatTurnMeta } from '../stream/chat-stream-reducer';
+export type { ChatSource } from '../types/message.types';
 
 // ─── Stable no-op references for the Guide-mode dialog-management stubs ──
 // Plain module-scope constants so the adapter's return identity stays
@@ -128,34 +129,6 @@ const noopBumpMetaTick = (): void => {};
  *  hub-side platform-utils, not in lib). */
 export type DocSource = string;
 
-export interface ChatSource {
-  index: number;
-  name: string;
-  path: string;
-  documentType: string;
-  externalUrl?: string;
-  /** Platform that owns the destination at `externalUrl`. */
-  targetPlatform?: string | null;
-  /** Primary-key value for single-row chips. */
-  id?: string;
-  /** Per-row items for grouped chips. */
-  items?: Array<{
-    id: string;
-    documentType: string;
-    name: string;
-    externalUrl?: string;
-    targetPlatform?: string | null;
-    /** In-app doc-tree path for markdown / data-room-doc rows so the
-     *  grouped chip's anchor can trigger an in-page doc-tree swap via
-     *  `handleChatNavClick` (parity with single-row chips + cards). */
-    path?: string | null;
-  }>;
-  /** RagTableConfig.id for this source. */
-  sourceRepo?: string;
-  /** Optional display label override returned by the chat API. */
-  label?: string;
-}
-
 export interface DocChatMessage {
   id: string;
   role: 'user' | 'assistant';