@flamingo-stack/openframe-frontend-core 0.0.706-snapshot.20261006181108 → 0.0.706

package/dist/chat-protocol/index.cjs

@@ -308,13 +308,15 @@ var MESSAGE_TYPE = {
   TEXT: "TEXT",
   THINKING: "THINKING",
   ASK: "ASK",
-  /** Per-answer attachments (cited documents, videos, entity cards).
+  /** Per-answer source metadata (documents, videos, entity cards).
    *
-   *  `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",
+   *  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. */
   GUIDE: "GUIDE",
+  SOURCES: "SOURCES",
   EXECUTING_TOOL: "EXECUTING_TOOL",
   EXECUTED_TOOL: "EXECUTED_TOOL",
   APPROVAL_REQUEST: "APPROVAL_REQUEST",
@@ -542,16 +544,6 @@ function sourceMetadataEvent(payload) {
     ...refs.length > 0 ? { refs } : {}
   };
 }
-function withoutNulls(value) {
-  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)])
-  );
-}
-function attachmentsEvent(record) {
-  return sourceMetadataEvent(withoutNulls(record));
-}
 
 // src/chat-protocol/nats-decoder.ts
 function str(value) {
@@ -618,14 +610,13 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
-    // 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: {
+    // 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: {
       const event = sourceMetadataEvent(data.payload);
       return event ? { ...event, ...seq } : null;
     }

package/dist/chat-protocol/index.js

@@ -306,13 +306,15 @@ var MESSAGE_TYPE = {
   TEXT: "TEXT",
   THINKING: "THINKING",
   ASK: "ASK",
-  /** Per-answer attachments (cited documents, videos, entity cards).
+  /** Per-answer source metadata (documents, videos, entity cards).
    *
-   *  `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",
+   *  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. */
   GUIDE: "GUIDE",
+  SOURCES: "SOURCES",
   EXECUTING_TOOL: "EXECUTING_TOOL",
   EXECUTED_TOOL: "EXECUTED_TOOL",
   APPROVAL_REQUEST: "APPROVAL_REQUEST",
@@ -540,16 +542,6 @@ function sourceMetadataEvent(payload) {
     ...refs.length > 0 ? { refs } : {}
   };
 }
-function withoutNulls(value) {
-  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)])
-  );
-}
-function attachmentsEvent(record) {
-  return sourceMetadataEvent(withoutNulls(record));
-}
 
 // src/chat-protocol/nats-decoder.ts
 function str(value) {
@@ -616,14 +608,13 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
-    // 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: {
+    // 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: {
       const event = sourceMetadataEvent(data.payload);
       return event ? { ...event, ...seq } : null;
     }

package/dist/chat-protocol/nats-decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nats-decoder.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/nats-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,UAAU,CAAC;AAyClE;;wDAEwD;AACxD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,CASjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAyStE"}
+{"version":3,"file":"nats-decoder.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/nats-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,UAAU,CAAC;AAyClE;;wDAEwD;AACxD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,CASjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAuStE"}

package/dist/chat-protocol/source-metadata.d.ts

@@ -1,8 +1,8 @@
 /**
  * Source-metadata payload → `{ sources, refs }`.
  *
- * 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
+ * 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
  * 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.
@@ -46,15 +46,6 @@ export declare function youtubeVideoId(value: unknown): string | undefined;
  * an earlier chunk of the same turn had already supplied.
  */
 export declare function sourceMetadataEvent(payload: unknown): SourcesEvent | null;
-/**
- * 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 declare function attachmentsEvent(record: unknown): SourcesEvent | null;
 /** What one assistant answer carries: its citations and its expandable refs. */
 export interface SourceMetadata {
     sources?: ChatSource[];

package/dist/chat-protocol/source-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-metadata.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/source-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAsC7C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAkBjE;AAqMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAYzE;AAaD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAErE;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc,CAcxG"}
+{"version":3,"file":"source-metadata.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/source-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAsC7C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAkBjE;AAqMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAYzE;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc,CAcxG"}

package/dist/{chunk-2YHNQAMU.js → chunk-3EZ4HHAP.js}

@@ -1,10 +1,10 @@
 "use client";
 import {
   createSseSubscription
-} from "./chunk-HTBN3XYF.js";
+} from "./chunk-G6UMNAVI.js";
 import {
   useChatIdentity
-} from "./chunk-IBQZMRWO.js";
+} from "./chunk-7GEBFJT2.js";
 import {
   embedAuthedFetch
 } from "./chunk-FXJ3WWUB.js";

package/dist/{chunk-FBY4V3YS.js → chunk-3NCM4ZQB.js}

@@ -4,7 +4,7 @@ import {
   getOSLabel,
   getShellLabel,
   getToolLabel
-} from "./chunk-HTBN3XYF.js";
+} from "./chunk-G6UMNAVI.js";
 import {
   useOnboardingState
 } from "./chunk-KUC673HM.js";

package/dist/{chunk-F4E3L3KV.cjs → chunk-3PLDQDE6.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
 
 
-var _chunk7XVBJDH7cjs = require('./chunk-7XVBJDH7.cjs');
+var _chunkGWQEYPYMcjs = require('./chunk-GWQEYPYM.cjs');
 
 
 var _chunkOF6GEI5Acjs = require('./chunk-OF6GEI5A.cjs');
@@ -12,7 +12,7 @@ var _chunkOF6GEI5Acjs = require('./chunk-OF6GEI5A.cjs');
 
 
 
-var _chunkAGNG62O2cjs = require('./chunk-AGNG62O2.cjs');
+var _chunk7OFPU7WEcjs = require('./chunk-7OFPU7WE.cjs');
 
 
 var _chunkUVTD52MDcjs = require('./chunk-UVTD52MD.cjs');
@@ -39,7 +39,7 @@ var _jsxruntime = require('react/jsx-runtime');
 function DocSearchResultRow({ result, isHighlighted }) {
   const docType = _optionalChain([result, 'access', _ => _.metadata, 'optionalAccess', _2 => _2.documentType]) || void 0;
   const sourceRepo = _optionalChain([result, 'access', _3 => _3.metadata, 'optionalAccess', _4 => _4.sourceRepo]) || void 0;
-  const { Icon: SourceIcon, label: iconLabel } = _chunkAGNG62O2cjs.resolveSourceIcon.call(void 0, {
+  const { Icon: SourceIcon, label: iconLabel } = _chunk7OFPU7WEcjs.resolveSourceIcon.call(void 0, {
     sourceRepo,
     documentType: docType
   });
@@ -69,7 +69,7 @@ function DocSearchBar({
   renderResult
 }) {
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunk7XVBJDH7cjs.SearchInput,
+    _chunkGWQEYPYMcjs.SearchInput,
     {
       placeholder,
       value: query,
@@ -119,7 +119,7 @@ function mapDocSearchResults(docs) {
       results.push({
         id: `group-${entry.repo}`,
         // Same table label and count as the chat's grouped chip: one owner each.
-        title: `${_chunkAGNG62O2cjs.getSourceLabel.call(void 0, entry.repo)} ${_chunkAGNG62O2cjs.recordCountLabel.call(void 0, rows.length)}`,
+        title: `${_chunk7OFPU7WEcjs.getSourceLabel.call(void 0, entry.repo)} ${_chunk7OFPU7WEcjs.recordCountLabel.call(void 0, rows.length)}`,
         path: rows[0].path,
         type: "file",
         metadata: {
@@ -311,27 +311,27 @@ function useDocSearch(config) {
         case "navigate-same-tab": {
           if (wantsNewTab) {
             setKeepOpen(true);
-            window.open(action.href, "_blank", _chunkAGNG62O2cjs.NEW_TAB_FEATURES);
+            window.open(action.href, "_blank", _chunk7OFPU7WEcjs.NEW_TAB_FEATURES);
             return;
           }
           setKeepOpen(false);
           const path = baseRoute && action.href.startsWith(`${baseRoute}/`) ? action.href.slice(baseRoute.length + 1) : null;
           if (path && _optionalChain([onInPageSwap, 'optionalCall', _16 => _16(path)])) return;
-          router.push(_chunkAGNG62O2cjs.stripSameOriginToPath.call(void 0, action.href));
+          router.push(_chunk7OFPU7WEcjs.stripSameOriginToPath.call(void 0, action.href));
           return;
         }
         case "navigate-new-tab":
           setKeepOpen(true);
           if (_optionalChain([runtime, 'optionalAccess', _17 => _17.navigation, 'access', _18 => _18.mode]) === "embed") {
             const targetPlatform = _nullishCoalesce(_optionalChain([result, 'access', _19 => _19.metadata, 'optionalAccess', _20 => _20.targetPlatform]), () => ( null));
-            _chunkAGNG62O2cjs.resolveExternalNavigation.call(void 0, {
+            _chunk7OFPU7WEcjs.resolveExternalNavigation.call(void 0, {
               href: action.href,
               targetPlatform,
               runtime
             }).open();
             return;
           }
-          window.open(action.href, "_blank", _chunkAGNG62O2cjs.NEW_TAB_FEATURES);
+          window.open(action.href, "_blank", _chunk7OFPU7WEcjs.NEW_TAB_FEATURES);
           return;
         case "ask-ai":
           setKeepOpen(false);

package/dist/{chunk-4RVC6TCE.js → chunk-4CJMQLB5.js}

@@ -8,7 +8,7 @@ import {
   SelectTrigger,
   SelectValue,
   Textarea
-} from "./chunk-HTBN3XYF.js";
+} from "./chunk-G6UMNAVI.js";
 import {
   useContactSubmission,
   useHumanitySignals,
@@ -18,7 +18,7 @@ import {
   ChatAttachmentAddButton,
   ChatAttachmentChipStrip,
   useChatAttachments
-} from "./chunk-IBQZMRWO.js";
+} from "./chunk-7GEBFJT2.js";
 import {
   SECTION_HEADING_CLASS,
   accentSentenceMarks

package/dist/{chunk-YQWTGQG5.js → chunk-4ILM7W2R.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   DEFAULT_FOLDER_INDEX_FILE
-} from "./chunk-HTBN3XYF.js";
+} from "./chunk-G6UMNAVI.js";
 import {
   scrollElementIntoView
 } from "./chunk-CZ7Y7UG4.js";

package/dist/{chunk-RZNRVXHH.js → chunk-6232S532.js}

@@ -10,7 +10,7 @@ import {
   StatusFilterComponent,
   TASK_TYPE_LABELS,
   TASK_TYPE_TEXT_COLORS
-} from "./chunk-HTBN3XYF.js";
+} from "./chunk-G6UMNAVI.js";
 import {
   usePathname,
   useRouter,

package/dist/{chunk-IBQZMRWO.js → chunk-7GEBFJT2.js}

@@ -966,13 +966,15 @@ var MESSAGE_TYPE = {
   TEXT: "TEXT",
   THINKING: "THINKING",
   ASK: "ASK",
-  /** Per-answer attachments (cited documents, videos, entity cards).
+  /** Per-answer source metadata (documents, videos, entity cards).
    *
-   *  `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",
+   *  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. */
   GUIDE: "GUIDE",
+  SOURCES: "SOURCES",
   EXECUTING_TOOL: "EXECUTING_TOOL",
   EXECUTED_TOOL: "EXECUTED_TOOL",
   APPROVAL_REQUEST: "APPROVAL_REQUEST",
@@ -18269,16 +18271,6 @@ function sourceMetadataEvent(payload) {
     ...refs.length > 0 ? { refs } : {}
   };
 }
-function withoutNulls(value) {
-  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)])
-  );
-}
-function attachmentsEvent(record) {
-  return sourceMetadataEvent(withoutNulls(record));
-}
 function mergeSourceMetadata(previous, event) {
   const byIndex = /* @__PURE__ */ new Map();
   for (const source of [...previous?.sources ?? [], ...event.sources ?? []]) {
@@ -21492,14 +21484,13 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
-    // 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: {
+    // 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: {
       const event = sourceMetadataEvent(data.payload);
       return event ? { ...event, ...seq } : null;
     }
@@ -21854,13 +21845,11 @@ function decodeHistoricalMessageData(data) {
         return { type: "thinking-delta", text: data.text };
       }
       return null;
-    // Persisted attachments, through the SAME decoder the live chunk uses
-    // (`attachmentsEvent`). That shared parse is the whole reason a reloaded
+    // Persisted source metadata, through the SAME decoder the live chunk uses
+    // (`sourceMetadataEvent`). 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
     // persisted row without a question or without options is not a card the

package/dist/{chunk-AGNG62O2.cjs → chunk-7OFPU7WE.cjs}

@@ -966,13 +966,15 @@ var MESSAGE_TYPE = {
   TEXT: "TEXT",
   THINKING: "THINKING",
   ASK: "ASK",
-  /** Per-answer attachments (cited documents, videos, entity cards).
+  /** Per-answer source metadata (documents, videos, entity cards).
    *
-   *  `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",
+   *  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. */
   GUIDE: "GUIDE",
+  SOURCES: "SOURCES",
   EXECUTING_TOOL: "EXECUTING_TOOL",
   EXECUTED_TOOL: "EXECUTED_TOOL",
   APPROVAL_REQUEST: "APPROVAL_REQUEST",
@@ -18269,16 +18271,6 @@ function sourceMetadataEvent(payload) {
     ...refs.length > 0 ? { refs } : {}
   };
 }
-function withoutNulls(value) {
-  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)])
-  );
-}
-function attachmentsEvent(record) {
-  return sourceMetadataEvent(withoutNulls(record));
-}
 function mergeSourceMetadata(previous, event) {
   const byIndex = /* @__PURE__ */ new Map();
   for (const source of [..._nullishCoalesce(_optionalChain([previous, 'optionalAccess', _538 => _538.sources]), () => ( [])), ..._nullishCoalesce(event.sources, () => ( []))]) {
@@ -21492,14 +21484,13 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
-    // 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: {
+    // 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: {
       const event = sourceMetadataEvent(data.payload);
       return event ? { ...event, ...seq } : null;
     }
@@ -21854,13 +21845,11 @@ function decodeHistoricalMessageData(data) {
         return { type: "thinking-delta", text: data.text };
       }
       return null;
-    // Persisted attachments, through the SAME decoder the live chunk uses
-    // (`attachmentsEvent`). That shared parse is the whole reason a reloaded
+    // Persisted source metadata, through the SAME decoder the live chunk uses
+    // (`sourceMetadataEvent`). 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
     // persisted row without a question or without options is not a card the

package/dist/{chunk-O6WNIA6W.cjs → chunk-7SCNMP2B.cjs}

@@ -4,7 +4,7 @@
 
 
 
-var _chunk7XVBJDH7cjs = require('./chunk-7XVBJDH7.cjs');
+var _chunkGWQEYPYMcjs = require('./chunk-GWQEYPYM.cjs');
 
 
 var _chunkWCVZCGK5cjs = require('./chunk-WCVZCGK5.cjs');
@@ -128,7 +128,7 @@ var ToolBadge = ({
   className,
   iconClassName
 }) => {
-  const text = _nullishCoalesce(label, () => ( (toolType ? _chunk7XVBJDH7cjs.getToolLabel.call(void 0, toolType) : "")));
+  const text = _nullishCoalesce(label, () => ( (toolType ? _chunkGWQEYPYMcjs.getToolLabel.call(void 0, toolType) : "")));
   const mark = _nullishCoalesce(icon, () => ( (toolType ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkUVTD52MDcjs.ToolIcon, { toolType, className: iconClassName, size: 16 }) : null)));
   const linked = (node, linkClassName) => href ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "a", { href, target: "_blank", rel: "noopener noreferrer", title: text || void 0, className: linkClassName, children: node }) : node;
   if (variant === "chip") {
@@ -162,31 +162,31 @@ var ToolBadge = ({
 // src/components/platform/ShellTypeBadge.tsx
 
 var shellIconMap = {
-  [_chunk7XVBJDH7cjs.ShellTypeValues.POWERSHELL]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.POWERSHELL]: {
     icon: _chunkVX4E6YSBcjs.PowershellLogoGreyIcon,
     props: { size: 16, className: "text-ods-text-secondary" }
   },
-  [_chunk7XVBJDH7cjs.ShellTypeValues.CMD]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.CMD]: {
     icon: _chunkLLSUVPQCcjs.CmdIcon,
     props: { size: 16, color: "var(--color-text-secondary)" }
   },
-  [_chunk7XVBJDH7cjs.ShellTypeValues.BASH]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.BASH]: {
     icon: _chunkLLSUVPQCcjs.BashIcon,
     props: { size: 16, color: "var(--color-text-secondary)" }
   },
-  [_chunk7XVBJDH7cjs.ShellTypeValues.PYTHON]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.PYTHON]: {
     icon: _chunkVX4E6YSBcjs.PythonLogoIcon,
     props: { size: 16, className: "text-ods-text-secondary" }
   },
-  [_chunk7XVBJDH7cjs.ShellTypeValues.NUSHELL]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.NUSHELL]: {
     icon: _chunkLLSUVPQCcjs.NushellIcon,
     props: { size: 16, color: "var(--color-text-secondary)" }
   },
-  [_chunk7XVBJDH7cjs.ShellTypeValues.DENO]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.DENO]: {
     icon: _chunkLLSUVPQCcjs.DenoIcon,
     props: { size: 16, color: "var(--color-text-secondary)" }
   },
-  [_chunk7XVBJDH7cjs.ShellTypeValues.SHELL]: {
+  [_chunkGWQEYPYMcjs.ShellTypeValues.SHELL]: {
     icon: _chunkLLSUVPQCcjs.ShellIcon,
     props: { size: 16, color: "var(--color-text-secondary)" }
   }
@@ -197,7 +197,7 @@ var defaultIconConfig = {
 };
 var ShellTypeBadge = ({ shellType, className, iconClassName }) => {
   const normalizedType = _optionalChain([shellType, 'optionalAccess', _ => _.toUpperCase, 'call', _2 => _2()]);
-  const label = _chunk7XVBJDH7cjs.getShellLabel.call(void 0, normalizedType);
+  const label = _chunkGWQEYPYMcjs.getShellLabel.call(void 0, normalizedType);
   const { icon: IconComponent, props: iconProps } = _nullishCoalesce(shellIconMap[normalizedType], () => ( defaultIconConfig));
   const defaultIconClassName = "className" in iconProps ? iconProps.className : void 0;
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunk3ATAYP36cjs.cn.call(void 0, "flex items-center gap-1", className), children: [
@@ -213,7 +213,7 @@ function formatSupportedPlatforms(platforms) {
   if (!platforms || platforms.length === 0) {
     return "All Platforms";
   }
-  return platforms.map((platform) => _chunk7XVBJDH7cjs.getOSLabel.call(void 0, platform)).join(", ");
+  return platforms.map((platform) => _chunkGWQEYPYMcjs.getOSLabel.call(void 0, platform)).join(", ");
 }
 function InfoCell({ label, value, avatar, className }) {
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunk3ATAYP36cjs.cn.call(void 0, "flex min-w-0 items-center gap-2", className), children: [
@@ -233,7 +233,7 @@ var ScriptInfoSection = ({
   author,
   className
 }) => {
-  const shellLabel = _chunk7XVBJDH7cjs.getShellLabel.call(void 0, shellType);
+  const shellLabel = _chunkGWQEYPYMcjs.getShellLabel.call(void 0, shellType);
   const platformsLabel = formatSupportedPlatforms(supportedPlatforms);
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunk3ATAYP36cjs.cn.call(void 0, "overflow-hidden rounded-[6px] border border-ods-border bg-ods-card", className), children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "border-b border-ods-border p-4", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex flex-col gap-1", children: [

package/dist/{chunk-SGJP2WKD.js → chunk-BHI6GVC4.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   useOptionalTicketLive
-} from "./chunk-2YHNQAMU.js";
+} from "./chunk-3EZ4HHAP.js";
 import {
   AppLayoutDrawerContainerContext,
   AppLayoutDrawerCoordinationContext,
@@ -14,7 +14,7 @@ import {
   UnreadDot,
   buildTicketOpenHref,
   useOptionalNotifications
-} from "./chunk-HTBN3XYF.js";
+} from "./chunk-G6UMNAVI.js";
 import {
   resolveActiveSection,
   shortcutLabel,
@@ -28,7 +28,7 @@ import {
 import {
   OVERLAY_BACKDROP_CLASS,
   useIsHydrated
-} from "./chunk-IBQZMRWO.js";
+} from "./chunk-7GEBFJT2.js";
 import {
   useHeaderHeight
 } from "./chunk-CZ7Y7UG4.js";

package/dist/{chunk-56LOCS37.cjs → chunk-DDVBX42E.cjs}

@@ -5,7 +5,7 @@ var _chunkUDFRUKLCcjs = require('./chunk-UDFRUKLC.cjs');
 
 
 
-var _chunk7XVBJDH7cjs = require('./chunk-7XVBJDH7.cjs');
+var _chunkGWQEYPYMcjs = require('./chunk-GWQEYPYM.cjs');
 
 
 var _chunkWCVZCGK5cjs = require('./chunk-WCVZCGK5.cjs');
@@ -16,7 +16,7 @@ var _chunkBIZNSF3Ucjs = require('./chunk-BIZNSF3U.cjs');
 
 
 
-var _chunkAGNG62O2cjs = require('./chunk-AGNG62O2.cjs');
+var _chunk7OFPU7WEcjs = require('./chunk-7OFPU7WE.cjs');
 
 
 
@@ -56,7 +56,7 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
     return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
       "div",
       {
-        id: _chunkAGNG62O2cjs.faqItemAnchor.call(void 0, item.id),
+        id: _chunk7OFPU7WEcjs.faqItemAnchor.call(void 0, item.id),
         className: "scroll-mt-24 transition-colors hover:bg-ods-bg-hover",
         children: [
           /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
@@ -149,7 +149,7 @@ function groupFaqsBySection(faqs) {
     }
     let group = byName.get(name);
     if (!group) {
-      group = { section: name, slug: _chunkAGNG62O2cjs.faqSectionSlug.call(void 0, name), items: [] };
+      group = { section: name, slug: _chunk7OFPU7WEcjs.faqSectionSlug.call(void 0, name), items: [] };
       byName.set(name, group);
     }
     group.items.push(item);
@@ -202,7 +202,7 @@ function GroupedFaqList({
   }, [slugKey]);
   const [hashTarget, setHashTarget] = _react.useState.call(void 0, null);
   _react.useEffect.call(void 0, () => {
-    const refresh = () => setHashTarget(_chunkAGNG62O2cjs.parseFaqHash.call(void 0, window.location.hash));
+    const refresh = () => setHashTarget(_chunk7OFPU7WEcjs.parseFaqHash.call(void 0, window.location.hash));
     refresh();
     window.addEventListener("hashchange", refresh);
     return () => window.removeEventListener("hashchange", refresh);
@@ -336,7 +336,7 @@ function FaqDocumentPage({
     label: _nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _16 => _16.label]), () => ( "Back to home")),
     onClick: () => router.push(_nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _17 => _17.href]), () => ( "/")))
   };
-  const inner = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk7XVBJDH7cjs.PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+  const inner = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGWQEYPYMcjs.PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
     FaqSection,
     {
       initialFaqs,
@@ -349,7 +349,7 @@ function FaqDocumentPage({
       minResults
     }
   ) });
-  return shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk7XVBJDH7cjs.PageShell, { children: inner }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: inner });
+  return shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkGWQEYPYMcjs.PageShell, { children: inner }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: inner });
 }