@flamingo-stack/openframe-frontend-core 0.0.583 → 0.0.584-1973.5420.1

package/dist/chat-protocol/index.js

@@ -284,6 +284,8 @@ function createSseFrameDecoder() {
 var MESSAGE_TYPE = {
   TEXT: "TEXT",
   THINKING: "THINKING",
+  GUIDE: "GUIDE",
+  SOURCES: "SOURCES",
   ASK: "ASK",
   EXECUTING_TOOL: "EXECUTING_TOOL",
   EXECUTED_TOOL: "EXECUTED_TOOL",
@@ -305,6 +307,176 @@ var MESSAGE_TYPE = {
   DIALOG_CLOSED: "DIALOG_CLOSED"
 };
 
+// src/chat-protocol/source-metadata.ts
+var CARD_REFERENCE = /^\[card:\/\/([a-zA-Z0-9_-]+):([a-zA-Z0-9_-]+)\]$/;
+function requiredString(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim();
+  return normalized ? normalized : null;
+}
+function optionalString(value) {
+  return requiredString(value) ?? void 0;
+}
+function httpsUrl(value) {
+  const candidate = optionalString(value);
+  if (!candidate) return void 0;
+  try {
+    return new URL(candidate).protocol === "https:" ? candidate : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function youtubeId(value) {
+  const candidate = optionalString(value);
+  if (!candidate) return void 0;
+  if (/^[A-Za-z0-9_-]{11}$/.test(candidate)) return candidate;
+  const url = httpsUrl(candidate);
+  if (!url) return void 0;
+  const parsed = new URL(url);
+  const hostname = parsed.hostname.toLowerCase();
+  const youtubeHost = hostname === "youtu.be" || hostname === "youtube.com" || hostname.endsWith(".youtube.com");
+  if (!youtubeHost) return void 0;
+  const pathId = hostname === "youtu.be" ? parsed.pathname.split("/").filter(Boolean)[0] : parsed.pathname.match(/^\/(?:embed|v|shorts)\/([A-Za-z0-9_-]{11})(?:\/|$)/)?.[1];
+  const id = pathId ?? parsed.searchParams.get("v") ?? void 0;
+  return id && /^[A-Za-z0-9_-]{11}$/.test(id) ? id : void 0;
+}
+function nullableString(value) {
+  return value === null ? null : optionalString(value);
+}
+function normalizeSourceItems(value) {
+  if (!Array.isArray(value)) return void 0;
+  const items = value.flatMap((candidate) => {
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return [];
+    const item = candidate;
+    const id = requiredString(item.id);
+    const documentType = requiredString(item.documentType);
+    const name = requiredString(item.name);
+    if (!id || !documentType || !name) return [];
+    const externalUrl = httpsUrl(item.externalUrl);
+    const targetPlatform = nullableString(item.targetPlatform);
+    const path = nullableString(item.path);
+    return [
+      {
+        id,
+        documentType,
+        name,
+        ...externalUrl ? { externalUrl } : {},
+        ...targetPlatform !== void 0 ? { targetPlatform } : {},
+        ...path !== void 0 ? { path } : {}
+      }
+    ];
+  });
+  return items.length > 0 ? items : void 0;
+}
+function normalizeSources(value) {
+  if (!Array.isArray(value)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const sources = [];
+  for (const candidate of value) {
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) continue;
+    const source = candidate;
+    const index = source.index;
+    const name = requiredString(source.name);
+    const path = requiredString(source.path);
+    const documentType = requiredString(source.documentType);
+    const validIndex = typeof index === "number" && Number.isFinite(index) && Number.isInteger(index) && index > 0 && !seen.has(index);
+    if (!validIndex || !name || !path || !documentType) continue;
+    seen.add(index);
+    const externalUrl = httpsUrl(source.externalUrl);
+    const targetPlatform = nullableString(source.targetPlatform);
+    const id = optionalString(source.id);
+    const sourceRepo = optionalString(source.sourceRepo);
+    const label = optionalString(source.label);
+    const items = normalizeSourceItems(source.items);
+    sources.push({
+      index,
+      name,
+      path,
+      documentType,
+      ...externalUrl ? { externalUrl } : {},
+      ...targetPlatform !== void 0 ? { targetPlatform } : {},
+      ...id ? { id } : {},
+      ...sourceRepo ? { sourceRepo } : {},
+      ...label ? { label } : {},
+      ...items ? { items } : {}
+    });
+  }
+  return sources;
+}
+function normalizeVideoMetadata(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  const input = value;
+  const metadata = {};
+  for (const key of ["videoUrl", "highlightVideoUrl", "videoPoster", "highlightVideoPoster"]) {
+    const url = httpsUrl(input[key]);
+    if (url) metadata[key] = url;
+  }
+  const id = youtubeId(input.youtubeUrl);
+  if (id) metadata.youtubeUrl = id;
+  return metadata;
+}
+function normalizeVideos(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((candidate) => {
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return [];
+    const video = candidate;
+    const match = typeof video.ref === "string" ? CARD_REFERENCE.exec(video.ref) : null;
+    if (!match || match[1] !== "video") return [];
+    const id = match[2];
+    const title = optionalString(video.title) ?? id;
+    const url = httpsUrl(video.url) ?? null;
+    const sourceRepo = optionalString(video.sourceRepo);
+    const metadata = normalizeVideoMetadata(video.metadata);
+    if (url) {
+      const idFromUrl = youtubeId(url);
+      if (idFromUrl) {
+        metadata.youtubeUrl = idFromUrl;
+        delete metadata.videoUrl;
+      } else {
+        metadata.videoUrl = url;
+        delete metadata.youtubeUrl;
+      }
+    }
+    return [
+      {
+        type: "video",
+        id,
+        title,
+        url,
+        ...sourceRepo ? { sourceRepo } : {},
+        ...Object.keys(metadata).length > 0 ? { metadata } : {}
+      }
+    ];
+  });
+}
+function normalizeCards(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((candidate) => {
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return [];
+    const card = candidate;
+    const match = typeof card.ref === "string" ? CARD_REFERENCE.exec(card.ref) : null;
+    if (!match || match[1] === "video") return [];
+    const type = requiredString(card.entityType);
+    const id = requiredString(card.entityId);
+    if (!type || !id || type !== match[1] || id !== match[2]) return [];
+    return [{ type, id, title: id, url: null }];
+  });
+}
+function sourceMetadataEvent(payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return null;
+  const metadata = payload;
+  const sources = normalizeSources(metadata.sources);
+  const refs = [...normalizeVideos(metadata.videos), ...normalizeCards(metadata.cards)];
+  const refsByIdentity = /* @__PURE__ */ new Map();
+  refs.forEach((ref) => {
+    const identity = `${ref.type}:${ref.id}`;
+    if (!refsByIdentity.has(identity)) refsByIdentity.set(identity, ref);
+  });
+  const uniqueRefs = Array.from(refsByIdentity.values());
+  if (sources.length === 0 && uniqueRefs.length === 0) return null;
+  return { type: "sources", sources, ...uniqueRefs.length > 0 ? { refs: uniqueRefs } : {} };
+}
+
 // src/chat-protocol/nats-decoder.ts
 function isRecord(value) {
   return typeof value === "object" && value !== null;
@@ -373,6 +545,11 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
+    case MESSAGE_TYPE.GUIDE:
+    case MESSAGE_TYPE.SOURCES: {
+      const event = sourceMetadataEvent(data.payload);
+      return event ? { ...event, ...seq } : null;
+    }
     // An ask card is only an ask card with something to pick: a question and at
     // least one option. Anything less is dropped rather than rendered as an
     // empty card the user can't answer — the backend already falls back to a