@flamingo-stack/openframe-frontend-core 0.0.532 → 0.0.533

package/dist/{chunk-WINT757E.js → chunk-LIUARTOZ.js}

@@ -54602,12 +54602,29 @@ function useChat({
 // src/components/chat/hooks/use-sse-chat-adapter.ts
 import { useCallback as useCallback56, useMemo as useMemo52, useRef as useRef79 } from "react";
 
+// src/chat-protocol/confirm-tool.ts
+function buildConfirmToolBody(request) {
+  return {
+    proposal_id: request.proposalId,
+    action: request.action,
+    conversationId: request.conversationId
+  };
+}
+async function readServerErrorMessage(response) {
+  try {
+    const body = await response.json();
+    if (typeof body?.error === "string" && body.error.length > 0) return body.error;
+  } catch {
+  }
+  return null;
+}
+
 // src/chat-protocol/frames.ts
 var FRAME_TERMINATOR = "\0";
 var END_OF_LEADING = "";
 var TRAILER_SENTINEL = "";
 
-// src/chat-protocol/decode.ts
+// src/chat-protocol/leading-frames.ts
 function escapeThinkingTags(text) {
   return text.replace(/</g, "&lt;");
 }
@@ -54714,6 +54731,8 @@ function mapLeadingFrame(meta, out) {
     });
   }
 }
+
+// src/chat-protocol/decode.ts
 function createSseFrameDecoder() {
   const textDecoder = new TextDecoder();
   let buffer = "";
@@ -55373,21 +55392,41 @@ var MessageSegmentAccumulator = class {
   /**
    * Add an approval request segment directly (for CLIENT approvals)
    */
-  addApprovalRequest(requestId, command, explanation, approvalType, status = "pending") {
-    const segment = {
+  addApprovalRequest(requestId, command, explanation, approvalType, status = "pending", fields, origin) {
+    this.segments.push(
+      this.buildApprovalRequestSegment(
+        requestId,
+        { command, explanation, approvalType, fields, origin },
+        status
+      )
+    );
+    return this.getSegments();
+  }
+  /**
+   * Build one approval-request segment — THE constructor for this segment type.
+   *
+   * Three paths produce these: `addApprovalRequest` (live stream and replay),
+   * `flushPendingApprovals` (tracked-but-unresolved after a history replay) and
+   * `processApprovalResult` (a result arriving for a tracked request). They used
+   * to hand-write the object each, which is how `fields` and `origin` reached
+   * the card down one path and not the others — the same proposal rendering as a
+   * bare title, or losing the marker that routes its buttons to the hub.
+   */
+  buildApprovalRequestSegment(requestId, approval, status) {
+    return {
       type: "approval_request",
       data: {
-        command,
-        explanation,
+        command: approval.command,
+        explanation: approval.explanation,
         requestId,
-        approvalType
+        approvalType: approval.approvalType,
+        ...approval.fields && approval.fields.length > 0 ? { fields: approval.fields } : {},
+        ...approval.origin ? { origin: approval.origin } : {}
       },
       status,
       onApprove: this.callbacks.onApprove,
       onReject: this.callbacks.onReject
     };
-    this.segments.push(segment);
-    return this.getSegments();
   }
   /**
    * Add a batch approval segment containing multiple tool calls. Upserts by
@@ -55402,20 +55441,22 @@ var MessageSegmentAccumulator = class {
    * `executions` is forwarded as-is. On upsert, a new `executions` object
    * overrides the existing one (so the latest replay wins).
    */
-  addApprovalBatch(approvalRequestId, approvalType, toolCalls, status = "pending", executions, resolvedByName) {
+  addApprovalBatch(approvalRequestId, approvalType, toolCalls, status = "pending", executions, resolvedByName, origin) {
     const existingIndex = this.segments.findIndex(
       (s) => s.type === "approval_batch" && s.data.approvalRequestId === approvalRequestId
     );
     if (existingIndex !== -1) {
       const existing = this.segments[existingIndex];
       const mergedExecutions = executions ?? existing.data.executions;
+      const mergedOrigin = origin ?? existing.data.origin;
       this.segments[existingIndex] = {
         ...existing,
         data: {
           approvalRequestId,
           approvalType,
           toolCalls,
-          ...mergedExecutions ? { executions: mergedExecutions } : {}
+          ...mergedExecutions ? { executions: mergedExecutions } : {},
+          ...mergedOrigin ? { origin: mergedOrigin } : {}
         },
         status,
         resolvedByName: resolvedByName ?? existing.resolvedByName,
@@ -55430,7 +55471,8 @@ var MessageSegmentAccumulator = class {
         approvalRequestId,
         approvalType,
         toolCalls,
-        ...executions ? { executions } : {}
+        ...executions ? { executions } : {},
+        ...origin ? { origin } : {}
       },
       status,
       resolvedByName,
@@ -55447,18 +55489,15 @@ var MessageSegmentAccumulator = class {
   processApprovalResult(requestId, approved, approvalType) {
     const pendingApproval = this.pendingApprovals.get(requestId);
     const status = approved ? "approved" : "rejected";
-    const segment = {
-      type: "approval_request",
-      data: {
+    const segment = this.buildApprovalRequestSegment(
+      requestId,
+      {
+        ...pendingApproval,
         command: pendingApproval?.command || "",
-        explanation: pendingApproval?.explanation,
-        requestId,
         approvalType: pendingApproval?.approvalType || approvalType
       },
-      status,
-      onApprove: this.callbacks.onApprove,
-      onReject: this.callbacks.onReject
-    };
+      status
+    );
     this.segments.push(segment);
     if (pendingApproval) {
       this.pendingApprovals.delete(requestId);
@@ -55539,18 +55578,7 @@ var MessageSegmentAccumulator = class {
   flushPendingApprovals() {
     const segments = [];
     this.pendingApprovals.forEach((approval, requestId) => {
-      segments.push({
-        type: "approval_request",
-        data: {
-          command: approval.command,
-          explanation: approval.explanation,
-          requestId,
-          approvalType: approval.approvalType
-        },
-        status: "pending",
-        onApprove: this.callbacks.onApprove,
-        onReject: this.callbacks.onReject
-      });
+      segments.push(this.buildApprovalRequestSegment(requestId, approval, "pending"));
     });
     return segments;
   }
@@ -55616,7 +55644,9 @@ var MessageSegmentAccumulator = class {
             data.command,
             data.explanation,
             data.approvalType || "",
-            status
+            status,
+            data.fields,
+            data.origin
           );
           break;
         }
@@ -55628,7 +55658,8 @@ var MessageSegmentAccumulator = class {
             data.toolCalls,
             status,
             data.executions,
-            resolvedByName
+            resolvedByName,
+            data.origin
           );
           break;
         }
@@ -55672,6 +55703,10 @@ function createMessageSegmentAccumulator(callbacks) {
 }
 
 // src/chat-protocol/events.ts
+var GUIDE_ORIGIN = "guide";
+function isGuideOrigin(source) {
+  return source?.origin === GUIDE_ORIGIN;
+}
 var ESCALATION_STATE = {
   PENDING: "PENDING",
   APPROVED: "APPROVED",
@@ -55692,6 +55727,22 @@ function escalationResolvedStatus(state) {
 }
 var CHAT_OWNER_ADMIN = "ADMIN";
 
+// src/components/chat/utils/approval-display.ts
+function isGuideApproval(source) {
+  return isGuideOrigin(source);
+}
+function guideApprovalOrigin(source) {
+  return isGuideApproval(source) ? GUIDE_ORIGIN : void 0;
+}
+function approvalDisplaysInline(source, approvalType, displayApprovalTypes) {
+  if (isGuideApproval(source)) return true;
+  return !displayApprovalTypes || displayApprovalTypes.includes(approvalType);
+}
+function isGuideApprovalSegment(segment) {
+  if (segment.type !== "approval_request" && segment.type !== "approval_batch") return false;
+  return isGuideApproval(segment.data);
+}
+
 // src/components/chat/stream/chat-stream-reducer.ts
 function createEmptyTurnMeta() {
   return {
@@ -55727,6 +55778,7 @@ function createChatStreamReducer(options = {}) {
   let streamingPhase = "idle";
   let dialogTokenUsage = null;
   let liveModel = null;
+  let guideConversationId = null;
   let approvalStatuses = {
     ...options.approvalStatuses ?? {}
   };
@@ -55787,7 +55839,8 @@ function createChatStreamReducer(options = {}) {
         turnMeta: { meta: metaMap, sources: sourcesMap, refs: refsMap, sendCount },
         dialogTokenUsage,
         liveModel,
-        approvalStatuses
+        approvalStatuses,
+        guideConversationId
       };
     }
     return stateCache;
@@ -55977,6 +56030,13 @@ function createChatStreamReducer(options = {}) {
         break;
       }
       case "metadata": {
+        if (isGuideOrigin(event)) {
+          if (typeof event.conversationId === "string" && event.conversationId) {
+            guideConversationId = event.conversationId;
+            invalidate();
+          }
+          break;
+        }
         emit("onMetadata", {
           action: "metadata",
           modelDisplayName: event.modelLabel ?? void 0,
@@ -56053,9 +56113,11 @@ function createChatStreamReducer(options = {}) {
         const requestId = event.requestId;
         const approvalType = event.approvalType ?? "USER";
         const toolCalls = event.toolCalls;
+        const guideOrigin = guideApprovalOrigin(event);
+        const displayInline = (type) => approvalDisplaysInline(event, type, displayApprovalTypes);
         if (toolCalls && toolCalls.length > 0) {
           const status = approvalStatuses[requestId] || "pending";
-          if (!displayApprovalTypes.includes(approvalType)) {
+          if (!displayInline(approvalType)) {
             const required = toolCalls.find((c) => c.requiresApproval) ?? toolCalls[0];
             const summary = required ? getCommandText(required) : `Batch of ${toolCalls.length} tool calls`;
             pendingEscalated.set(requestId, {
@@ -56073,7 +56135,15 @@ function createChatStreamReducer(options = {}) {
           }
           if (batchApprovalsEnabled) {
             const before2 = accumulator.getSegments().length;
-            const segments2 = accumulator.addApprovalBatch(requestId, approvalType, toolCalls, status);
+            const segments2 = accumulator.addApprovalBatch(
+              requestId,
+              approvalType,
+              toolCalls,
+              status,
+              void 0,
+              void 0,
+              guideOrigin
+            );
             applyAccumulated(before2, segments2);
             break;
           }
@@ -56086,7 +56156,9 @@ function createChatStreamReducer(options = {}) {
               getCommandText(call),
               call.toolExplanation,
               approvalType,
-              status
+              status,
+              void 0,
+              guideOrigin
             );
           }
           applyAccumulated(before, segments);
@@ -56094,7 +56166,7 @@ function createChatStreamReducer(options = {}) {
         }
         const command = event.command ?? "";
         const explanation = event.explanation;
-        if (displayApprovalTypes.includes(approvalType)) {
+        if (displayInline(approvalType)) {
           const status = approvalStatuses[requestId] || "pending";
           const before = accumulator.getSegments().length;
           const segments = accumulator.addApprovalRequest(
@@ -56102,7 +56174,11 @@ function createChatStreamReducer(options = {}) {
             command,
             explanation,
             approvalType,
-            status
+            status,
+            // SSE-shaped cards (a re-streamed Product Guide proposal) carry
+            // their body as structured rows rather than prose.
+            event.fields,
+            guideOrigin
           );
           applyAccumulated(before, segments);
         } else {
@@ -56519,6 +56595,7 @@ function createChatStreamReducer(options = {}) {
     streamingPhase = "idle";
     dialogTokenUsage = null;
     liveModel = null;
+    guideConversationId = null;
     approvalStatuses = {};
     accumulator.reset();
     pendingEscalated.clear();
@@ -56542,6 +56619,7 @@ function createChatStreamReducer(options = {}) {
     streamingPhase = "idle";
     dialogTokenUsage = null;
     liveModel = null;
+    guideConversationId = null;
     accumulator.reset();
     pendingEscalated.clear();
     isInStream = false;
@@ -57237,13 +57315,13 @@ function useSseChatAdapter(options, runtimeOptions = {}) {
       const { hidden, attachments, commandOverride, approvalAction } = sendOptions ?? {};
       const conversationId = conversationIdRef.current;
       const targetPath = approvalAction ? endpointsRef.current.approvalToolUrl : endpointsRef.current.chatStreamUrl;
-      const requestBody = approvalAction ? {
-        proposal_id: approvalAction.proposalId,
-        action: approvalAction.action,
-        // Always present here — an approval can only happen inside an
+      const requestBody = approvalAction ? (
+        // Shared with every other transport that resolves a hub proposal —
+        // the body shape is the hub's, not this adapter's. `conversationId`
+        // is always present here: an approval can only happen inside an
         // established conversation (the proposal turn captured the id).
-        conversationId
-      } : {
+        buildConfirmToolBody({ ...approvalAction, conversationId })
+      ) : {
         messages: [{ role: "user", content: text }],
         ...commandOverride ? { commandOverride } : {},
         ...attachments && attachments.length > 0 ? { pendingAttachments: attachments } : {},
@@ -57261,14 +57339,7 @@ function useSseChatAdapter(options, runtimeOptions = {}) {
           signal: ctrl.signal
         });
         if (!response.ok) {
-          let serverMessage = null;
-          try {
-            const errBody = await response.json();
-            if (typeof errBody?.error === "string" && errBody.error.length > 0) {
-              serverMessage = errBody.error;
-            }
-          } catch {
-          }
+          const serverMessage = await readServerErrorMessage(response);
           throw new Error(serverMessage ?? `Chat request failed: ${response.status}`);
         }
         const reader = response.body?.getReader();
@@ -57507,6 +57578,37 @@ function normalizeAskOptions(raw) {
     description: typeof item.description === "string" ? item.description : void 0
   })).filter((option) => option.label.length > 0);
 }
+var AGENT_OWNED_EVENTS = /* @__PURE__ */ new Set([
+  "usage",
+  "token-usage",
+  "status",
+  "compaction",
+  "participant",
+  "dialog-closed"
+]);
+var ORIGIN_BEARING_EVENTS = /* @__PURE__ */ new Set([
+  "approval-request",
+  "approval-resolved"
+]);
+function guideEventForNats(event) {
+  switch (event.type) {
+    case "text-delta":
+      return { type: "guide-delta", text: event.text };
+    case "thinking-delta":
+      return { type: "thinking-delta", text: escapeThinkingTags(event.text) };
+    case "metadata":
+      return typeof event.conversationId === "string" && event.conversationId ? { type: "metadata", conversationId: event.conversationId, origin: GUIDE_ORIGIN } : null;
+    default:
+      if (AGENT_OWNED_EVENTS.has(event.type)) return null;
+      return ORIGIN_BEARING_EVENTS.has(event.type) ? { ...event, origin: GUIDE_ORIGIN } : event;
+  }
+}
+function guideFrameEvent(frame) {
+  const events = [];
+  mapLeadingFrame(frame, events);
+  const event = events[0];
+  return event ? guideEventForNats(event) : null;
+}
 function decodeNatsChunk(chunk) {
   if (!chunk || typeof chunk !== "object") return null;
   const data = chunk;
@@ -57541,11 +57643,20 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
-    case MESSAGE_TYPE.GUIDE:
+    // Two shapes share this chunk type. `text` is the answer body the agent
+    // streams (and persists). `payload` is a Product Guide frame re-streamed
+    // verbatim from the hub — decoded through the shared frame table, with the
+    // narrowing `guideFrameEvent` documents.
+    case MESSAGE_TYPE.GUIDE: {
       if (typeof data.text === "string") {
         return { type: "guide-delta", text: data.text, ...seq };
       }
-      return null;
+      const frame = data.payload;
+      if (!frame || typeof frame !== "object" || Array.isArray(frame)) return null;
+      const event = guideFrameEvent(frame);
+      if (!event) return null;
+      return { ...event, ...seq };
+    }
     // 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
@@ -57764,11 +57875,21 @@ function decodeHistoricalMessageData(data) {
         return { type: "thinking-delta", text: data.text };
       }
       return null;
-    case MESSAGE_TYPE.GUIDE:
+    // Two persisted shapes, mirroring the live `GUIDE` chunk: the answer body
+    // (`text`) and a Product Guide frame the agent re-streamed (`payload`,
+    // persisted so a card survives a reload). Decoded through the SAME
+    // `guideFrameEvent` the live path uses — a second mapping here would let
+    // history and realtime disagree about the same bytes.
+    case MESSAGE_TYPE.GUIDE: {
       if ("text" in data && data.text) {
         return { type: "guide-delta", text: data.text };
       }
+      const payload = "payload" in data ? data.payload : void 0;
+      if (payload && typeof payload === "object" && !Array.isArray(payload)) {
+        return guideFrameEvent(payload);
+      }
       return null;
+    }
     // Same completeness gate as the live decoder (`decodeNatsChunk`): a
     // persisted row without a question or without options is not a card the
     // user can answer, so it replays as nothing rather than as empty chrome.
@@ -57946,11 +58067,20 @@ function applyHistoryEvent(event, accumulator, approvalStatuses, options, escala
       const approvalType = event.approvalType || "CLIENT";
       const toolCalls = event.toolCalls;
       const isBatch = !!toolCalls && toolCalls.length > 0;
-      if (!displayApprovalTypes || displayApprovalTypes.includes(approvalType)) {
+      const guideOrigin = guideApprovalOrigin(event);
+      if (approvalDisplaysInline(event, approvalType, displayApprovalTypes)) {
         if (isBatch) {
           const status = approvalStatuses[event.requestId] || "pending";
           if (batchApprovalsEnabled) {
-            accumulator.addApprovalBatch(event.requestId, approvalType, toolCalls, status);
+            accumulator.addApprovalBatch(
+              event.requestId,
+              approvalType,
+              toolCalls,
+              status,
+              void 0,
+              void 0,
+              guideOrigin
+            );
           } else {
             for (const call of toolCalls) {
               if (!call.requiresApproval) continue;
@@ -57959,25 +58089,31 @@ function applyHistoryEvent(event, accumulator, approvalStatuses, options, escala
                 getCommandText(call),
                 call.toolExplanation,
                 approvalType,
-                status
+                status,
+                void 0,
+                guideOrigin
               );
             }
           }
         } else {
           const resolvedStatus = approvalStatuses[event.requestId];
-          if (resolvedStatus === "approved" || resolvedStatus === "rejected") {
+          const isResolved = resolvedStatus === "approved" || resolvedStatus === "rejected";
+          if (guideOrigin || isResolved) {
             accumulator.addApprovalRequest(
               event.requestId,
               event.command || "",
               event.explanation,
               approvalType,
-              resolvedStatus
+              resolvedStatus ?? "pending",
+              event.fields,
+              guideOrigin
             );
           } else {
             accumulator.trackApprovalRequest(event.requestId, {
               command: event.command || "",
               explanation: event.explanation,
-              approvalType
+              approvalType,
+              fields: event.fields
             });
           }
         }
@@ -59923,6 +60059,7 @@ function EmbeddableChatInner({
   tableIdForDocumentType,
   modes,
   mingoState,
+  pendingApprovals,
   mingoDialogCapabilities,
   activeMode: controlledActiveMode,
   onActiveModeChange,
@@ -60800,6 +60937,7 @@ function EmbeddableChatInner({
                               {
                                 messages,
                                 isTyping: chatLoading,
+                                pendingApprovals,
                                 autoScroll: !previewMode,
                                 pinBottom: previewMode,
                                 overscrollContain: !previewMode,
@@ -61647,6 +61785,10 @@ export {
   createMessageSegmentAccumulator,
   SCROLL_ANCHOR_WIRE_KEY,
   parseScrollAnchor,
+  isGuideApproval,
+  guideApprovalOrigin,
+  approvalDisplaysInline,
+  isGuideApprovalSegment,
   createEmptyTurnMeta,
   createChatStreamReducer,
   DEFAULT_DIALOG_SIDE,
@@ -62125,4 +62267,4 @@ export {
   LogsList,
   assets
 };
-//# sourceMappingURL=chunk-WINT757E.js.map
+//# sourceMappingURL=chunk-LIUARTOZ.js.map