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

package/dist/chat-protocol/index.cjs

@@ -308,15 +308,13 @@ var 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",
@@ -544,6 +542,16 @@ 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) {
@@ -610,13 +618,14 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       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/dist/chat-protocol/index.js

@@ -306,15 +306,13 @@ var 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",
@@ -542,6 +540,16 @@ 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) {
@@ -608,13 +616,14 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       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/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,CAuStE"}
+{"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"}

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 `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.
@@ -46,6 +46,15 @@ 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;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;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"}

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

@@ -1,13 +1,13 @@
 "use client";
 import {
   createSseSubscription
-} from "./chunk-FCGC42TS.js";
+} from "./chunk-HTBN3XYF.js";
 import {
   useChatIdentity
-} from "./chunk-7VVFKJY5.js";
+} from "./chunk-IBQZMRWO.js";
 import {
   embedAuthedFetch
-} from "./chunk-NDESEPW5.js";
+} from "./chunk-FXJ3WWUB.js";
 import {
   useChatRuntime
 } from "./chunk-E4ABZWTJ.js";

package/dist/{chunk-YHM5AWTT.js → chunk-3FZP73R4.js}

@@ -3,16 +3,16 @@ import {
   FileDownloadCard,
   GoogleSheetsViewer,
   PdfViewer
-} from "./chunk-RBDP4WDE.js";
+} from "./chunk-U6BWEKJC.js";
 import {
   MobileNavigationDropdown,
   MultiLevelNavigation,
   StickySectionNav
-} from "./chunk-DENB2XJC.js";
+} from "./chunk-YQWTGQG5.js";
 import {
   DocSearchBar,
   useDocSearch
-} from "./chunk-F6I6XZMN.js";
+} from "./chunk-E2TQZIOJ.js";
 import {
   CategorySidebarSkeleton,
   DEFAULT_FOLDER_INDEX_FILE,
@@ -22,17 +22,17 @@ import {
   findDocNodeByPath,
   getDocAncestorNodeIds,
   stripFolderIndexFromPath
-} from "./chunk-FCGC42TS.js";
+} from "./chunk-HTBN3XYF.js";
 import {
   contentFetch
-} from "./chunk-MP2C3LJ4.js";
+} from "./chunk-CUME3VTQ.js";
 import {
   HUB_HEADER_OFFSET_PX,
   apiErrorMessage,
   getScrollableAncestor,
   navigateSamePageHash,
   scrollElementIntoView
-} from "./chunk-PDWVPI3S.js";
+} from "./chunk-CZ7Y7UG4.js";
 import {
   useRouter
 } from "./chunk-GY4IZG22.js";

package/dist/{chunk-VR2ZLFCP.js → chunk-4IBPRIQH.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   contentFetch
-} from "./chunk-MP2C3LJ4.js";
+} from "./chunk-CUME3VTQ.js";
 
 // src/hooks/use-self-fetch.ts
 import { useEffect, useRef, useState } from "react";

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

@@ -8,21 +8,21 @@ import {
   SelectTrigger,
   SelectValue,
   Textarea
-} from "./chunk-FCGC42TS.js";
+} from "./chunk-HTBN3XYF.js";
 import {
   useContactSubmission,
   useHumanitySignals,
   useRescuedForm
-} from "./chunk-MKXO4Q5P.js";
+} from "./chunk-KUC673HM.js";
 import {
   ChatAttachmentAddButton,
   ChatAttachmentChipStrip,
   useChatAttachments
-} from "./chunk-7VVFKJY5.js";
+} from "./chunk-IBQZMRWO.js";
 import {
   SECTION_HEADING_CLASS,
   accentSentenceMarks
-} from "./chunk-CH5232HV.js";
+} from "./chunk-FI6GMDO7.js";
 import {
   Input,
   Label,