@flamingo-stack/openframe-frontend-core 0.0.715 → 0.0.717

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   ShellTypeBadge,
   SoftwareInfo,
   SoftwareSourceBadge
-} from "./chunk-YBS5QGON.js";
+} from "./chunk-VZI5BA4L.js";
 import {
   AppHeader,
   AppLayout,
@@ -33,15 +33,15 @@ import {
   isMegaMenu,
   navLinkLabel,
   siteNavHasMobileMenus
-} from "./chunk-JHSPIDV5.js";
+} from "./chunk-47FISYO5.js";
 import {
   MobileNavigationDropdown,
   MultiLevelNavigation,
   StickySectionNav,
   useScrollSpy,
   useSectionNavigation
-} from "./chunk-H5R7U2D2.js";
-import "./chunk-DDWFCWOE.js";
+} from "./chunk-NZ5BHDFZ.js";
+import "./chunk-JPD4NXH6.js";
 import {
   AIEnrichButton,
   AIEnrichSection,
@@ -73,6 +73,7 @@ import {
   AlertDialogTrigger,
   AlertTitle,
   AllowedDomainsInput,
+  AnalyzingState,
   AnnouncementBarView,
   AppLayoutDrawerBody,
   AppLayoutDrawerClose,
@@ -85,8 +86,7 @@ import {
   AppLayoutDrawerTrigger,
   AppStoreBadge,
   AppWindowFrame,
-  ApprovalLevelControl,
-  ApprovalLevelMark,
+  ApprovalLevelView,
   ApprovalRequestNotificationTile,
   ArrayEntryManager,
   ArticleDetailLayout,
@@ -565,7 +565,7 @@ import {
   useTrackerClock,
   useWalkthroughVideo,
   usersCountLabel
-} from "./chunk-2LZ3IYGT.js";
+} from "./chunk-B5XU6KOA.js";
 import {
   Board,
   BoardColumn,
@@ -1173,7 +1173,7 @@ import {
   withFirstTouchAttribution,
   withWalkthroughOpenParam,
   writeDismissCookie
-} from "./chunk-ROBQ5TR7.js";
+} from "./chunk-JH2SIWPQ.js";
 import {
   ApprovalBatchMessage,
   ApprovalStatusTag,
@@ -2129,6 +2129,7 @@ export {
   AlertTitle,
   AlertTriangleIcon,
   AllowedDomainsInput,
+  AnalyzingState,
   AnnouncementBarView,
   AppHeader,
   AppLayout,
@@ -2145,8 +2146,7 @@ export {
   AppWindowFrame,
   AppleIcon,
   ApprovalBatchMessage,
-  ApprovalLevelControl,
-  ApprovalLevelMark,
+  ApprovalLevelView,
   ApprovalRequestMessage,
   ApprovalRequestNotificationTile,
   ApprovalStatusTag,

package/dist/{knowledge-YWCB7HNC.js → knowledge-DEKYJXBS.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-CYUUHFXL.js";
 import {
   KnowledgeBaseArticleView
-} from "./chunk-2LZ3IYGT.js";
+} from "./chunk-B5XU6KOA.js";
 import "./chunk-ILNN6QRW.js";
 import "./chunk-LQYXMEYF.js";
 import "./chunk-4JPLYOS6.js";
@@ -21,7 +21,7 @@ import "./chunk-G3GRYDMS.js";
 import "./chunk-PLWMIU72.js";
 import {
   SimpleMarkdownRenderer
-} from "./chunk-ROBQ5TR7.js";
+} from "./chunk-JH2SIWPQ.js";
 import "./chunk-2NASBO7O.js";
 import "./chunk-KBJJQFYU.js";
 import "./chunk-P3JMAMHP.js";

package/dist/{knowledge-GDMGHFEC.cjs → knowledge-EHNRYT7U.cjs}

@@ -8,7 +8,7 @@ var _chunkII4QMH26cjs = require('./chunk-II4QMH26.cjs');
 var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
-var _chunkZSJ6WWFHcjs = require('./chunk-ZSJ6WWFH.cjs');
+var _chunk5MF3NMYCcjs = require('./chunk-5MF3NMYC.cjs');
 require('./chunk-4HJRHEXD.cjs');
 require('./chunk-HQQE74RO.cjs');
 require('./chunk-DEY6XXGO.cjs');
@@ -21,7 +21,7 @@ require('./chunk-AUMKE74M.cjs');
 require('./chunk-LX22Y43B.cjs');
 
 
-var _chunkHETQETPVcjs = require('./chunk-HETQETPV.cjs');
+var _chunkUWQWMGJ7cjs = require('./chunk-UWQWMGJ7.cjs');
 require('./chunk-KT3U3ZRP.cjs');
 require('./chunk-DC4RTYWK.cjs');
 require('./chunk-FFT56TYB.cjs');
@@ -96,10 +96,10 @@ function KnowledgeScreen(_props) {
   const cast = _chunkII4QMH26cjs.useProductDemoCast.call(void 0, );
   const fixture = _react.useMemo.call(void 0, () => buildKnowledgeFixture(cast), [cast]);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-full bg-ods-bg", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkZSJ6WWFHcjs.KnowledgeBaseArticleView,
+    _chunk5MF3NMYCcjs.KnowledgeBaseArticleView,
     {
       ...fixture.article,
-      content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkHETQETPVcjs.SimpleMarkdownRenderer, { content: fixture.content, textSize: "compact" })
+      content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkUWQWMGJ7cjs.SimpleMarkdownRenderer, { content: fixture.content, textSize: "compact" })
     }
   ) });
 }

package/dist/{logs-7QDRV3GN.cjs → logs-3V765P7O.cjs}

@@ -16,7 +16,7 @@ var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
 
-var _chunkZSJ6WWFHcjs = require('./chunk-ZSJ6WWFH.cjs');
+var _chunk5MF3NMYCcjs = require('./chunk-5MF3NMYC.cjs');
 require('./chunk-4HJRHEXD.cjs');
 require('./chunk-HQQE74RO.cjs');
 require('./chunk-DEY6XXGO.cjs');
@@ -29,7 +29,7 @@ require('./chunk-AUMKE74M.cjs');
 require('./chunk-LX22Y43B.cjs');
 
 
-var _chunkHETQETPVcjs = require('./chunk-HETQETPV.cjs');
+var _chunkUWQWMGJ7cjs = require('./chunk-UWQWMGJ7.cjs');
 require('./chunk-KT3U3ZRP.cjs');
 require('./chunk-DC4RTYWK.cjs');
 require('./chunk-FFT56TYB.cjs');
@@ -77,7 +77,7 @@ function entry(logId, minutesAgo, severity, toolType, device2, summary) {
     id: logId,
     logId,
     timestamp: displayTime(_chunkKHXZFLINcjs.demoMinutesAgo.call(void 0, minutesAgo)),
-    status: { label: severity, variant: _chunkZSJ6WWFHcjs.logSeverityVariant.call(void 0, severity) },
+    status: { label: severity, variant: _chunk5MF3NMYCcjs.logSeverityVariant.call(void 0, severity) },
     source: { name: toolType, toolType },
     device: device2,
     description: { title: summary }
@@ -149,13 +149,13 @@ var NO_FILTERS = {};
 var ACTION_COLUMNS = ["copy", "quickView", "open"];
 var BESIDE_DRAWER_HIDDEN = [...ACTION_COLUMNS, "tool", "source"];
 var logHref = () => "#";
-var copyAction = () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZSJ6WWFHcjs.LogCopyIconButton, {});
+var copyAction = () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk5MF3NMYCcjs.LogCopyIconButton, {});
 function LogsScreen({ compact = false }) {
   const [dock, setDock] = _react.useState.call(void 0, null);
   const selected = LOGS_FIXTURE_SELECTED;
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex h-full bg-ods-bg", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "min-w-0 flex-1 overflow-clip", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkZSJ6WWFHcjs.LogsPageView,
+      _chunk5MF3NMYCcjs.LogsPageView,
       {
         showHeader: false,
         className: "p-[var(--spacing-system-l)]",
@@ -163,7 +163,7 @@ function LogsScreen({ compact = false }) {
         onSearchChange: noop,
         onOpenFilters: noop,
         children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkZSJ6WWFHcjs.LogsTableView,
+          _chunk5MF3NMYCcjs.LogsTableView,
           {
             logs: LOGS_FIXTURE_ENTRIES,
             facets: LOGS_FIXTURE_FACETS,
@@ -177,8 +177,8 @@ function LogsScreen({ compact = false }) {
         )
       }
     ) }),
-    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: setDock, className: "relative w-[calc(400px+var(--spacing-system-m))] shrink-0", children: dock && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZSJ6WWFHcjs.AppLayoutDrawerContainerContext.Provider, { value: dock, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkZSJ6WWFHcjs.LogDrawer,
+    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: setDock, className: "relative w-[calc(400px+var(--spacing-system-m))] shrink-0", children: dock && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk5MF3NMYCcjs.AppLayoutDrawerContainerContext.Provider, { value: dock, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunk5MF3NMYCcjs.LogDrawer,
       {
         docked: true,
         isOpen: true,
@@ -190,12 +190,12 @@ function LogsScreen({ compact = false }) {
           { label: "Log ID", value: selected.logId },
           {
             label: "Source",
-            value: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZSJ6WWFHcjs.ToolBadge, { toolType: _chunkHETQETPVcjs.normalizeToolTypeWithFallback.call(void 0, selected.source.toolType) })
+            value: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk5MF3NMYCcjs.ToolBadge, { toolType: _chunkUWQWMGJ7cjs.normalizeToolTypeWithFallback.call(void 0, selected.source.toolType) })
           },
-          { label: "Device", value: _chunkZSJ6WWFHcjs.logSourceLabels.call(void 0, selected.device).deviceName }
+          { label: "Device", value: _chunk5MF3NMYCcjs.logSourceLabels.call(void 0, selected.device).deviceName }
         ],
         deviceCard: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkZSJ6WWFHcjs.DeviceCard,
+          _chunk5MF3NMYCcjs.DeviceCard,
           {
             ...LOGS_FIXTURE_DEVICE,
             actions: {

package/dist/{logs-E742S5A2.js → logs-Q7YFIVYI.js}

@@ -16,7 +16,7 @@ import {
   ToolBadge,
   logSeverityVariant,
   logSourceLabels
-} from "./chunk-2LZ3IYGT.js";
+} from "./chunk-B5XU6KOA.js";
 import "./chunk-ILNN6QRW.js";
 import "./chunk-LQYXMEYF.js";
 import "./chunk-4JPLYOS6.js";
@@ -29,7 +29,7 @@ import "./chunk-G3GRYDMS.js";
 import "./chunk-PLWMIU72.js";
 import {
   normalizeToolTypeWithFallback
-} from "./chunk-ROBQ5TR7.js";
+} from "./chunk-JH2SIWPQ.js";
 import "./chunk-2NASBO7O.js";
 import "./chunk-KBJJQFYU.js";
 import "./chunk-P3JMAMHP.js";

package/dist/{policies-XTPAKRHI.js → policies-BTIENK5A.js}

@@ -10,7 +10,7 @@ import {
   PolicySummaryCards,
   computePolicySummary,
   getPolicyTableStatus
-} from "./chunk-2LZ3IYGT.js";
+} from "./chunk-B5XU6KOA.js";
 import "./chunk-ILNN6QRW.js";
 import "./chunk-LQYXMEYF.js";
 import "./chunk-4JPLYOS6.js";
@@ -21,7 +21,7 @@ import "./chunk-HFL2F4RM.js";
 import "./chunk-WSDT7LYL.js";
 import "./chunk-G3GRYDMS.js";
 import "./chunk-PLWMIU72.js";
-import "./chunk-ROBQ5TR7.js";
+import "./chunk-JH2SIWPQ.js";
 import "./chunk-2NASBO7O.js";
 import "./chunk-KBJJQFYU.js";
 import "./chunk-P3JMAMHP.js";

package/dist/{policies-BEVF6AEM.cjs → policies-TXU5AIXS.cjs}

@@ -10,7 +10,7 @@ var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
 
-var _chunkZSJ6WWFHcjs = require('./chunk-ZSJ6WWFH.cjs');
+var _chunk5MF3NMYCcjs = require('./chunk-5MF3NMYC.cjs');
 require('./chunk-4HJRHEXD.cjs');
 require('./chunk-HQQE74RO.cjs');
 require('./chunk-DEY6XXGO.cjs');
@@ -21,7 +21,7 @@ require('./chunk-MZ4KBSH7.cjs');
 require('./chunk-WBNAEYTQ.cjs');
 require('./chunk-AUMKE74M.cjs');
 require('./chunk-LX22Y43B.cjs');
-require('./chunk-HETQETPV.cjs');
+require('./chunk-UWQWMGJ7.cjs');
 require('./chunk-KT3U3ZRP.cjs');
 require('./chunk-DC4RTYWK.cjs');
 require('./chunk-FFT56TYB.cjs');
@@ -82,14 +82,14 @@ var POLICIES = [
   policy("policy-local-admins", "No local admins", "No everyday account is a local administrator.", false, 0)
 ];
 var POLICIES_FIXTURE = {
-  summary: _chunkZSJ6WWFHcjs.computePolicySummary.call(void 0, POLICIES),
+  summary: _chunk5MF3NMYCcjs.computePolicySummary.call(void 0, POLICIES),
   rows: POLICIES.map((item) => ({
     id: item.id,
     name: item.name,
     description: item.description,
     critical: item.critical,
     severityLabel: item.critical ? "Critical" : "Low",
-    status: _chunkZSJ6WWFHcjs.getPolicyTableStatus.call(void 0, item),
+    status: _chunk5MF3NMYCcjs.getPolicyTableStatus.call(void 0, item),
     actions: [
       { label: "Policy Details", onClick: noop },
       { label: "Delete Policy", onClick: noop }
@@ -103,16 +103,16 @@ var POLICIES_FIXTURE = {
 var _jsxruntime = require('react/jsx-runtime');
 function PoliciesScreen({ compact = false }) {
   const table = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkZSJ6WWFHcjs.PoliciesTable,
+    _chunk5MF3NMYCcjs.PoliciesTable,
     {
       rows: POLICIES_FIXTURE.rows,
       rowAsLink: true,
-      rightSlot: compact ? void 0 : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZSJ6WWFHcjs.DataTable.RowCount, {}),
+      rightSlot: compact ? void 0 : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk5MF3NMYCcjs.DataTable.RowCount, {}),
       emptyMessage: "No policies found."
     }
   );
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex h-full flex-col gap-[var(--spacing-system-l)] bg-ods-bg p-[var(--spacing-system-l)]", children: [
-    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZSJ6WWFHcjs.PolicySummaryCards, { summary: POLICIES_FIXTURE.summary, now: POLICIES_FIXTURE.now }),
+    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk5MF3NMYCcjs.PolicySummaryCards, { summary: POLICIES_FIXTURE.summary, now: POLICIES_FIXTURE.now }),
     table
   ] });
 }

package/dist/{software-update-KPHX4XQ7.cjs → software-update-MINTICZY.cjs}

@@ -16,7 +16,7 @@ var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
 
-var _chunkZSJ6WWFHcjs = require('./chunk-ZSJ6WWFH.cjs');
+var _chunk5MF3NMYCcjs = require('./chunk-5MF3NMYC.cjs');
 require('./chunk-4HJRHEXD.cjs');
 require('./chunk-HQQE74RO.cjs');
 require('./chunk-DEY6XXGO.cjs');
@@ -27,7 +27,7 @@ require('./chunk-MZ4KBSH7.cjs');
 require('./chunk-WBNAEYTQ.cjs');
 require('./chunk-AUMKE74M.cjs');
 require('./chunk-LX22Y43B.cjs');
-require('./chunk-HETQETPV.cjs');
+require('./chunk-UWQWMGJ7.cjs');
 require('./chunk-KT3U3ZRP.cjs');
 require('./chunk-DC4RTYWK.cjs');
 require('./chunk-FFT56TYB.cjs');
@@ -114,14 +114,14 @@ var noop = () => {
 var HIDDEN_WHEN_COMPACT = ["organization"];
 function StaticPackageField({ value }) {
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkZSJ6WWFHcjs.Autocomplete,
+    _chunk5MF3NMYCcjs.Autocomplete,
     {
-      label: _chunkZSJ6WWFHcjs.PACKAGE_SEARCH_LABEL,
+      label: _chunk5MF3NMYCcjs.PACKAGE_SEARCH_LABEL,
       labelVariant: "large",
       options: value ? [{ value: value.id, label: value.name, description: _nullishCoalesce(value.description, () => ( void 0)) }] : [],
       value: _nullishCoalesce(_optionalChain([value, 'optionalAccess', _ => _.id]), () => ( null)),
       onChange: noop,
-      placeholder: _chunkZSJ6WWFHcjs.PACKAGE_SEARCH_PLACEHOLDER
+      placeholder: _chunk5MF3NMYCcjs.PACKAGE_SEARCH_PLACEHOLDER
     }
   );
 }
@@ -135,7 +135,7 @@ function SoftwareUpdateScreen({ compact = false }) {
     [fixture.devices, fixture.selectedIds]
   );
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-full bg-ods-bg pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-full", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkZSJ6WWFHcjs.SoftwareActionForm,
+    _chunk5MF3NMYCcjs.SoftwareActionForm,
     {
       action: fixture.action,
       showHeader: false,
@@ -147,7 +147,7 @@ function SoftwareUpdateScreen({ compact = false }) {
       initialValues: fixture.initialValues,
       renderPackageSearch,
       renderDevicePicker: () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunkZSJ6WWFHcjs.DeviceSelector,
+        _chunk5MF3NMYCcjs.DeviceSelector,
         {
           devices: selected,
           loading: false,

package/dist/{software-update-FXWIEKSW.js → software-update-SW2HOBHW.js}

@@ -16,7 +16,7 @@ import {
   PACKAGE_SEARCH_LABEL,
   PACKAGE_SEARCH_PLACEHOLDER,
   SoftwareActionForm
-} from "./chunk-2LZ3IYGT.js";
+} from "./chunk-B5XU6KOA.js";
 import "./chunk-ILNN6QRW.js";
 import "./chunk-LQYXMEYF.js";
 import "./chunk-4JPLYOS6.js";
@@ -27,7 +27,7 @@ import "./chunk-HFL2F4RM.js";
 import "./chunk-WSDT7LYL.js";
 import "./chunk-G3GRYDMS.js";
 import "./chunk-PLWMIU72.js";
-import "./chunk-ROBQ5TR7.js";
+import "./chunk-JH2SIWPQ.js";
 import "./chunk-2NASBO7O.js";
 import "./chunk-KBJJQFYU.js";
 import "./chunk-P3JMAMHP.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.715",
+  "version": "0.0.717",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",

package/src/chat-protocol/nats-decoder.ts

@@ -20,7 +20,7 @@ import { MESSAGE_TYPE } from '../components/chat/types/message.types';
 import type { AskOptionData } from '../components/chat/types/message.types';
 import { ESCALATION_STATE, escalationResolvedStatus } from './events';
 import type { ApprovalToolCall, ChatStreamEvent } from './events';
-import { sourceMetadataEvent } from './source-metadata';
+import { attachmentsEvent, sourceMetadataEvent } from './source-metadata';
 import { isRecord } from './wire-narrow';
 
 /** Minimal structural view of a NATS chunk (see `ChunkData` in
@@ -122,13 +122,15 @@ export function decodeNatsChunk(chunk: unknown): ChatStreamEvent | null {
       }
       return null;
 
-    // Two chunk names, one payload and one decoder. `SOURCES` is the contract
-    // the backend is moving to; `GUIDE` is the v2 envelope it ships in during
-    // the rollout (see `MESSAGE_TYPE.GUIDE`). The chunk arrives BEFORE or
-    // between the answer's text deltas, so the reducer — not this decoder —
-    // owns attaching it to the right turn.
-    case MESSAGE_TYPE.GUIDE:
-    case MESSAGE_TYPE.SOURCES: {
+    // The chunk arrives BEFORE or between the answer's text deltas, so the
+    // reducer — not this decoder — owns attaching it to the right turn.
+    case MESSAGE_TYPE.ATTACHMENTS: {
+      const event = attachmentsEvent(data);
+      return event ? { ...event, ...seq } : null;
+    }
+
+    // The envelope `ATTACHMENTS` replaced (see `MESSAGE_TYPE.GUIDE`).
+    case MESSAGE_TYPE.GUIDE: {
       const event = sourceMetadataEvent(data.payload);
       return event ? { ...event, ...seq } : null;
     }

package/src/chat-protocol/source-metadata.ts

@@ -1,8 +1,8 @@
 /**
  * Source-metadata payload → `{ sources, refs }`.
  *
- * ONE decoder for two arrival paths: the live `GUIDE`/`SOURCES` NATS chunk and
- * the persisted row of the same name in dialog history. That is the whole point
+ * ONE decoder for two arrival paths: the live `ATTACHMENTS` NATS chunk and the
+ * persisted row of the same name in dialog history. That is the whole point
  * of putting it here rather than in either consumer — a reloaded thread has to
  * render identically to the live turn, and two parsers is exactly how that stops
  * being true.
@@ -313,6 +313,29 @@ export function sourceMetadataEvent(payload: unknown): SourcesEvent | null {
   };
 }
 
+/** `null` fields dropped, at any depth. */
+function withoutNulls(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(withoutNulls);
+  if (!isRecord(value)) return value;
+  return Object.fromEntries(
+    Object.entries(value)
+      .filter(([, field]) => field !== null)
+      .map(([key, field]) => [key, withoutNulls(field)]),
+  );
+}
+
+/**
+ * Decode one typed `ATTACHMENTS` record — the live chunk or the persisted
+ * `AttachmentsData` row, which carry `sources` / `videos` / `cards` directly.
+ *
+ * GraphQL answers an unset field with `null` where the live chunk omits it, so
+ * nulls are read as absent: a reloaded source must not gain a
+ * `targetPlatform: null` ("no destination") the live one never carried.
+ */
+export function attachmentsEvent(record: unknown): SourcesEvent | null {
+  return sourceMetadataEvent(withoutNulls(record));
+}
+
 /** What one assistant answer carries: its citations and its expandable refs. */
 export interface SourceMetadata {
   sources?: ChatSource[];

package/src/components/chat/types/message.types.ts

@@ -12,15 +12,13 @@ export const MESSAGE_TYPE = {
   TEXT: 'TEXT',
   THINKING: 'THINKING',
   ASK: 'ASK',
-  /** Per-answer source metadata (documents, videos, entity cards).
+  /** Per-answer attachments (cited documents, videos, entity cards).
    *
-   *  TWO names for ONE payload, on purpose. `SOURCES` is the contract the
-   *  backend is moving to; `GUIDE` is the envelope it ships in today, reused
-   *  from Guide Mode v2 so a released frontend keeps working during the v2→v3
-   *  rollout. Both decode through the same path, so dropping `GUIDE` later is a
-   *  deletion here and nothing else. */
+   *  `ATTACHMENTS` carries `sources` / `videos` / `cards` on the record itself.
+   *  `GUIDE` is the envelope it replaced — the same arrays under `payload` —
+   *  and stays only until every backend ships `ATTACHMENTS`. */
+  ATTACHMENTS: 'ATTACHMENTS',
   GUIDE: 'GUIDE',
-  SOURCES: 'SOURCES',
   EXECUTING_TOOL: 'EXECUTING_TOOL',
   EXECUTED_TOOL: 'EXECUTED_TOOL',
   APPROVAL_REQUEST: 'APPROVAL_REQUEST',
@@ -412,7 +410,7 @@ export interface ThinkingMessageData extends MessageDataBase {
  *
  * Lives here, beside `Message`, because BOTH transports produce it now: the SSE
  * adapter reads it off the per-turn metadata frame, and the NATS path decodes it
- * out of a `GUIDE`/`SOURCES` chunk. It used to be declared inside
+ * out of an `ATTACHMENTS` chunk. It used to be declared inside
  * `use-sse-chat-adapter`, which made "a Guide answer's citations" structurally a
  * property of one transport — `use-sse-chat-adapter` still re-exports the name
  * so existing imports keep working.
@@ -451,13 +449,20 @@ export interface ChatSource {
   label?: string;
 }
 
-/** Persisted source-metadata row. `payload` is the SAME object the live chunk
- *  carries, so history and realtime share one decoder (`sourceMetadataEvent`)
- *  and cannot drift apart. Left as an open record here rather than typed
- *  structurally: it is unvalidated wire data, and the decoder is what turns it
- *  into `ChatSource[]` / `ChatRef[]`. */
+/** Persisted attachments row (GraphQL `AttachmentsData`). The arrays are the
+ *  SAME ones the live chunk carries, so history and realtime share one decoder
+ *  (`attachmentsEvent`) and cannot drift apart. Left untyped: it is unvalidated
+ *  wire data, and the decoder is what turns it into `ChatSource[]` / `ChatRef[]`. */
+export interface AttachmentsMessageData extends MessageDataBase {
+  type: 'ATTACHMENTS';
+  sources?: unknown;
+  videos?: unknown;
+  cards?: unknown;
+}
+
+/** The envelope `ATTACHMENTS` replaced: the same arrays under `payload`. */
 export interface SourceMetadataMessageData extends MessageDataBase {
-  type: 'GUIDE' | 'SOURCES';
+  type: 'GUIDE';
   payload?: unknown;
 }
 
@@ -603,6 +608,7 @@ export type MessageData =
   | TextMessageData
   | ThinkingMessageData
   | AskMessageData
+  | AttachmentsMessageData
   | SourceMetadataMessageData
   | ExecutingToolMessageData
   | ExecutedToolMessageData
@@ -654,7 +660,7 @@ export interface ProcessedMessage {
    *  Absent when the source row(s) carried no seq. */
   streamSeq?: number;
   /** Documents this answer cited — see `Message.sources`, the same field.
-   *  Replayed from the turn's persisted `GUIDE`/`SOURCES` row, so a reloaded
+   *  Replayed from the turn's persisted `ATTACHMENTS` row, so a reloaded
    *  answer carries the citations the live one did. */
   sources?: ChatSource[];
   /** Entity references this answer's metadata described — see `Message.refs`. */

package/src/components/chat/types/unified-chat-state.types.ts

@@ -239,7 +239,7 @@ export interface UnifiedChatMessage {
   /**
    * Documents this answer cited, rendered as chips beneath it. Produced by
    * BOTH transports now — SSE reads them off the per-turn metadata frame, NATS
-   * decodes them out of a `GUIDE`/`SOURCES` chunk.
+   * decodes them out of an `ATTACHMENTS` chunk.
    */
   sources?: ChatSource[];
   /**

package/src/components/chat/utils/process-historical-messages.ts

@@ -34,7 +34,12 @@ import {
 // One normalizer for ask rows, shared with the live decoder — history and the
 // stream must agree on which options are usable.
 import { normalizeAskOptions } from '../../../chat-protocol/nats-decoder';
-import { mergeSourceMetadata, sourceMetadataEvent, type SourceMetadata } from '../../../chat-protocol/source-metadata';
+import {
+  attachmentsEvent,
+  mergeSourceMetadata,
+  sourceMetadataEvent,
+  type SourceMetadata,
+} from '../../../chat-protocol/source-metadata';
 import { applyApprovalStatusToSegment } from '../stream/message-mutations';
 import {
   MESSAGE_TYPE,
@@ -122,11 +127,14 @@ export function decodeHistoricalMessageData(data: MessageData): ChatStreamEvent
       }
       return null;
 
-    // Persisted source metadata, through the SAME decoder the live chunk uses
-    // (`sourceMetadataEvent`). That shared parse is the whole reason a reloaded
+    // Persisted attachments, through the SAME decoder the live chunk uses
+    // (`attachmentsEvent`). That shared parse is the whole reason a reloaded
     // answer renders identically to the one the reader watched arrive.
+    case MESSAGE_TYPE.ATTACHMENTS:
+      return attachmentsEvent(data);
+
+    // The envelope `ATTACHMENTS` replaced (see `MESSAGE_TYPE.GUIDE`).
     case MESSAGE_TYPE.GUIDE:
-    case MESSAGE_TYPE.SOURCES:
       return 'payload' in data ? sourceMetadataEvent(data.payload) : null;
 
     // Same completeness gate as the live decoder (`decodeNatsChunk`): a