@paymanai/payman-ask-sdk 4.0.25 → 4.0.26

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { createContext, forwardRef, useCallback, useRef, useState, useMemo, useEffect, useImperativeHandle, useLayoutEffect, useContext } from 'react';
 import { AnimatePresence, motion } from 'framer-motion';
 import { clsx } from 'clsx';
@@ -273,6 +274,8 @@ function getEventMessage(event) {
     }
     case "RUN_IN_PROGRESS":
       return event.partialText || "Thinking...";
+    case "LLM_CALL_STARTED":
+      return event.description || "";
     case "RUN_COMPLETED":
       return "Agent run completed";
     case "RUN_FAILED":
@@ -410,7 +413,8 @@ function createInitialV2State() {
     finalData: void 0,
     steps: [],
     stepCounter: 0,
-    currentExecutingStepId: void 0
+    currentExecutingStepId: void 0,
+    trailingActivity: false
   };
 }
 function upsertUserAction(state, req) {
@@ -432,6 +436,7 @@ function processStreamEventV2(rawEvent, state) {
   if (typeof eventType === "string" && eventType.toUpperCase() === "KEEP_ALIVE") {
     if (event.executionId) state.executionId = event.executionId;
     if (event.sessionId) state.sessionId = event.sessionId;
+    if (state.finalResponse) state.trailingActivity = true;
     const description = typeof event.description === "string" ? event.description : "";
     if (description) {
       for (let i = state.steps.length - 1; i >= 0; i--) {
@@ -466,7 +471,12 @@ function processStreamEventV2(rawEvent, state) {
       state.lastEventType = eventType;
       break;
     }
+    case "LLM_CALL_STARTED":
+      if (state.finalResponse) state.trailingActivity = true;
+      state.lastEventType = eventType;
+      break;
     case "INTENT_STARTED": {
+      if (state.finalResponse) state.trailingActivity = true;
       const stepId = `step-${state.stepCounter++}`;
       state.steps.push({
         id: stepId,
@@ -482,6 +492,7 @@ function processStreamEventV2(rawEvent, state) {
       break;
     }
     case "INTENT_COMPLETED": {
+      if (state.finalResponse) state.trailingActivity = true;
       const intentStep = state.steps.find((s) => s.eventType === "INTENT_STARTED" && s.status === "in_progress");
       if (intentStep) {
         intentStep.status = "completed";
@@ -513,6 +524,7 @@ function processStreamEventV2(rawEvent, state) {
           step2.status = "completed";
         }
       });
+      state.trailingActivity = false;
       state.lastEventType = eventType;
       break;
     }
@@ -584,6 +596,7 @@ function processStreamEventV2(rawEvent, state) {
     case "WORKFLOW_ERROR":
       state.hasError = true;
       state.errorMessage = event.errorMessage || event.message || "Workflow error";
+      state.trailingActivity = false;
       state.lastEventType = eventType;
       break;
     // ---- K2 pipeline stage lifecycle events ----
@@ -872,7 +885,9 @@ function useStreamManagerV2(config, callbacks, setMessages, setIsWaitingForRespo
             const latestUsefulStep = [...state.steps].reverse().find(
               (s) => s.message && !isBlandStatus(s.message)
             );
-            const currentMessage = useful(activeStep?.message) ?? useful(lastInProgressStep?.message) ?? latestUsefulStep?.message ?? useful(getEventMessage(event)) ?? // Last-resort: every candidate is bland (very first event,
+            const eventTypeUpper = typeof event.eventType === "string" ? event.eventType.toUpperCase() : "";
+            const liveEventLabel = eventTypeUpper === "KEEP_ALIVE" || eventTypeUpper === "LLM_CALL_STARTED" ? useful(getEventMessage(event)) : void 0;
+            const currentMessage = useful(activeStep?.message) ?? useful(lastInProgressStep?.message) ?? liveEventLabel ?? latestUsefulStep?.message ?? useful(getEventMessage(event)) ?? // Last-resort: every candidate is bland (very first event,
             // nothing useful seen yet). Render the bland label so the
             // bubble isn't blank.
             activeStep?.message ?? lastInProgressStep?.message ?? getEventMessage(event);
@@ -897,6 +912,7 @@ function useStreamManagerV2(config, callbacks, setMessages, setIsWaitingForRespo
                 streamingContent: state.finalResponse,
                 content: "",
                 currentMessage,
+                hasTrailingActivity: state.trailingActivity,
                 streamProgress: "processing",
                 isError: false,
                 steps: [...state.steps],
@@ -2055,6 +2071,9 @@ function getConflictErrorMessage(errorDetails) {
 }
 function initSentryIfNeeded(dsn) {
   if (!dsn) return;
+  if (typeof window !== "undefined" && (window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1")) {
+    return;
+  }
   if (Sentry.getClient()) return;
   Sentry.init({
     dsn,
@@ -3436,9 +3455,88 @@ function MarkdownImageV2({
     }
   ) });
 }
-function buildComponents(onImageClick, isResolvingRef) {
+var RAG_SOURCE_CLASS = "payman-v2-rag-source";
+var RAG_FOLLOW_UP_CLASS = "payman-v2-rag-follow-up";
+var SOURCE_PATTERN = /^Sources?:\s*\S/i;
+var MAX_FOLLOW_UP_LENGTH = 320;
+var HR_PATTERN = /^-{3,}$|^_{3,}$|^\*{3,}$/;
+function normalizeRagParagraphText(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+function isRagSourceParagraph(text) {
+  return SOURCE_PATTERN.test(normalizeRagParagraphText(text));
+}
+function isRagFollowUpCandidate(text) {
+  const normalized = normalizeRagParagraphText(text);
+  return normalized.length > 0 && normalized.length <= MAX_FOLLOW_UP_LENGTH && normalized.endsWith("?");
+}
+function extractRagParagraphTexts(content) {
+  const paragraphs = [];
+  const currentParagraph = [];
+  const flushParagraph = () => {
+    const paragraph = normalizeRagParagraphText(currentParagraph.join(" "));
+    currentParagraph.length = 0;
+    if (paragraph) paragraphs.push(paragraph);
+  };
+  content.replace(/\\n/g, "\n").split(/\r?\n/).forEach((line) => {
+    const trimmedLine = line.trim();
+    if (!trimmedLine) {
+      flushParagraph();
+      return;
+    }
+    if (HR_PATTERN.test(trimmedLine)) {
+      flushParagraph();
+      return;
+    }
+    currentParagraph.push(trimmedLine);
+  });
+  flushParagraph();
+  return paragraphs;
+}
+function getRagAnswerParagraphRoles(paragraphs) {
+  const normalized = paragraphs.map(normalizeRagParagraphText);
+  const roles = normalized.map(() => null);
+  const sourceIndexes = normalized.map((paragraph, index) => isRagSourceParagraph(paragraph) ? index : -1).filter((index) => index >= 0);
+  for (const sourceIndex of sourceIndexes) {
+    roles[sourceIndex] = "source";
+    for (const candidateIndex of [sourceIndex - 1, sourceIndex + 1]) {
+      if (candidateIndex >= 0 && candidateIndex < normalized.length && roles[candidateIndex] == null && isRagFollowUpCandidate(normalized[candidateIndex] ?? "")) {
+        roles[candidateIndex] = "follow-up";
+      }
+    }
+  }
+  return roles;
+}
+function getRagAnswerParagraphRole(paragraph, paragraphs) {
+  const normalizedParagraph = normalizeRagParagraphText(paragraph);
+  if (isRagSourceParagraph(normalizedParagraph)) return "source";
+  const roles = getRagAnswerParagraphRoles(paragraphs);
+  return paragraphs.map(normalizeRagParagraphText).some((candidate, index) => {
+    return candidate === normalizedParagraph && roles[index] === "follow-up";
+  }) ? "follow-up" : null;
+}
+function ragAnswerRoleClassName(role) {
+  if (role === "source") return RAG_SOURCE_CLASS;
+  if (role === "follow-up") return RAG_FOLLOW_UP_CLASS;
+  return void 0;
+}
+function reactNodeText(node) {
+  if (typeof node === "string" || typeof node === "number") return String(node);
+  if (Array.isArray(node)) return node.map(reactNodeText).join("");
+  if (React.isValidElement(node)) {
+    return reactNodeText(node.props.children);
+  }
+  return "";
+}
+function buildComponents(onImageClick, isResolvingRef, ragParagraphsRef) {
   return {
-    p: ({ children }) => /* @__PURE__ */ jsx("p", { children }),
+    p: ({ children }) => {
+      const role = getRagAnswerParagraphRole(
+        reactNodeText(children),
+        ragParagraphsRef?.current ?? []
+      );
+      return /* @__PURE__ */ jsx("p", { className: ragAnswerRoleClassName(role), children });
+    },
     code: ({ children }) => /* @__PURE__ */ jsx("code", { children }),
     pre: ({ children }) => /* @__PURE__ */ jsx("div", { className: "payman-v2-markdown-pre", children: /* @__PURE__ */ jsx("pre", { children }) }),
     ul: ({ children }) => /* @__PURE__ */ jsx("ul", { children }),
@@ -3476,8 +3574,13 @@ function MarkdownRendererV2({
 }) {
   const isResolvingRef = useRef(isResolvingImages);
   isResolvingRef.current = isResolvingImages;
+  const ragParagraphsRef = useRef([]);
+  ragParagraphsRef.current = useMemo(
+    () => extractRagParagraphTexts(content),
+    [content]
+  );
   const components = useMemo(
-    () => buildComponents(onImageClick, isResolvingRef),
+    () => buildComponents(onImageClick, isResolvingRef, ragParagraphsRef),
     [onImageClick]
   );
   return /* @__PURE__ */ jsx(
@@ -3970,6 +4073,7 @@ function AssistantMessageV2({
     return message.isStreaming ? stripIncompleteImageToken(normalized) : normalized;
   })();
   const isThinkingStreaming = !!message.isStreaming && !rawResponseContent && !message.isError;
+  const showTrailingProgress = !!message.isStreaming && !!rawResponseContent && !message.isError && !message.isCancelled && !!message.hasTrailingActivity;
   const responseTypingEnabled = hasEverStreamed.current && Boolean(rawResponseContent) && !message.isError;
   const { displayedText: displayContent, isTyping: isResponseTyping } = useTypingEffect(
     rawResponseContent,
@@ -4128,7 +4232,7 @@ function AssistantMessageV2({
             {
               isStreaming: isThinkingStreaming,
               stickyLabel,
-              currentStepLabel
+              currentStepLabel: currentStepLabel ?? message.currentMessage
             }
           )
         },
@@ -4143,6 +4247,27 @@ function AssistantMessageV2({
           onImageClick
         }
       ) : !isThinkingStreaming ? /* @__PURE__ */ jsx("span", { className: "payman-v2-assistant-msg-placeholder", children: "..." }) : null }),
+      /* @__PURE__ */ jsx(AnimatePresence, { children: showTrailingProgress && /* @__PURE__ */ jsx(
+        motion.div,
+        {
+          initial: { opacity: 0, height: 0 },
+          animate: { opacity: 1, height: "auto" },
+          exit: { opacity: 0, height: 0 },
+          transition: {
+            duration: 0.32,
+            ease: [0.2, 0, 0, 1]
+          },
+          style: { overflow: "hidden" },
+          children: /* @__PURE__ */ jsx(
+            ThinkingBlockV2,
+            {
+              isStreaming: true,
+              currentStepLabel: message.currentMessage ?? currentStepLabel
+            }
+          )
+        },
+        "trailing-progress"
+      ) }),
       isCancelled && message.isStreaming && /* @__PURE__ */ jsxs("div", { className: "payman-v2-assistant-msg-paused", children: [
         /* @__PURE__ */ jsx(
           WifiOff,
@@ -4437,7 +4562,10 @@ function VerificationInline({
     if (busy) return;
     void onCancel(prompt.userActionId);
   }, [busy, onCancel, prompt.userActionId]);
-  const description = prompt.message?.trim() || (isNumeric ? `Enter the ${codeLen}-digit code to continue` : "Enter the verification code to continue");
+  const promptMessage = prompt.message?.trim();
+  const description = promptMessage || (isNumeric ? `Enter the ${codeLen}-digit code to continue` : "Enter the verification code to continue");
+  const messageFormat = prompt.metadata?.["payman/messageFormat"];
+  const renderMarkdown = !!promptMessage && messageFormat === "markdown";
   if (hiddenAfterResend) return null;
   return /* @__PURE__ */ jsxs("div", { className: "payman-v2-ua", role: "group", "aria-label": "Verification required", children: [
     /* @__PURE__ */ jsxs("div", { className: "payman-v2-ua-head", children: [
@@ -4445,7 +4573,7 @@ function VerificationInline({
       /* @__PURE__ */ jsx("span", { className: "payman-v2-ua-title", children: "Verification required" }),
       typeof secondsLeft === "number" && !stale && /* @__PURE__ */ jsx("span", { className: "payman-v2-ua-timer", children: expired ? "Expired" : `${secondsLeft}s` })
     ] }),
-    /* @__PURE__ */ jsx("p", { className: "payman-v2-ua-desc", children: description }),
+    renderMarkdown ? /* @__PURE__ */ jsx("div", { className: "payman-v2-ua-markdown", children: /* @__PURE__ */ jsx(MarkdownRendererV2, { content: description }) }) : /* @__PURE__ */ jsx("p", { className: "payman-v2-ua-desc", children: description }),
     stale ? /* @__PURE__ */ jsx("p", { className: "payman-v2-ua-stale", children: "This request is no longer available." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
       isNumeric ? /* @__PURE__ */ jsx("div", { className: "payman-v2-ua-field", children: /* @__PURE__ */ jsx(
         OtpInputV2,