@paymanai/payman-typescript-ask-sdk 4.0.25 → 4.0.26

package/dist/index.d.mts

@@ -201,6 +201,14 @@ type MessageDisplay = {
     isStreaming?: boolean;
     streamingContent?: string;
     currentMessage?: string;
+    /**
+     * True while work events (tool calls, LLM-call boundaries, keep-alive
+     * heartbeats) are arriving AFTER answer text already started streaming —
+     * e.g. the agent-builder streams an instant acknowledgment and then does
+     * its real work. Tells the UI to keep a live status line below the
+     * already-rendered text instead of showing just a frozen cursor.
+     */
+    hasTrailingActivity?: boolean;
     streamProgress?: StreamProgress;
     steps?: StreamingStep[];
     isCancelled?: boolean;
@@ -558,6 +566,16 @@ type V2EventProcessorState = {
     currentExecutingStepId?: string;
     /** Server-computed wall-clock duration captured from RUN_COMPLETED's `totalTimeMs`. */
     totalElapsedMs?: number;
+    /**
+     * True once work events (tool calls, LLM-call boundaries, keep-alive
+     * heartbeats) arrive AFTER answer text has started streaming. The
+     * agent-builder streams an instant acknowledgment first and then does
+     * its real work — this tells the UI to keep a live status line below
+     * the already-rendered text. Plain answer streaming (formatter deltas
+     * with no trailing work) never sets it. Sticky until the run ends so
+     * the status line doesn't flicker during think-gaps between tools.
+     */
+    trailingActivity: boolean;
 };
 declare function createInitialV2State(): V2EventProcessorState;
 declare function processStreamEventV2(rawEvent: StreamEvent, state: V2EventProcessorState): V2EventProcessorState;

package/dist/index.d.ts

@@ -201,6 +201,14 @@ type MessageDisplay = {
     isStreaming?: boolean;
     streamingContent?: string;
     currentMessage?: string;
+    /**
+     * True while work events (tool calls, LLM-call boundaries, keep-alive
+     * heartbeats) are arriving AFTER answer text already started streaming —
+     * e.g. the agent-builder streams an instant acknowledgment and then does
+     * its real work. Tells the UI to keep a live status line below the
+     * already-rendered text instead of showing just a frozen cursor.
+     */
+    hasTrailingActivity?: boolean;
     streamProgress?: StreamProgress;
     steps?: StreamingStep[];
     isCancelled?: boolean;
@@ -558,6 +566,16 @@ type V2EventProcessorState = {
     currentExecutingStepId?: string;
     /** Server-computed wall-clock duration captured from RUN_COMPLETED's `totalTimeMs`. */
     totalElapsedMs?: number;
+    /**
+     * True once work events (tool calls, LLM-call boundaries, keep-alive
+     * heartbeats) arrive AFTER answer text has started streaming. The
+     * agent-builder streams an instant acknowledgment first and then does
+     * its real work — this tells the UI to keep a live status line below
+     * the already-rendered text. Plain answer streaming (formatter deltas
+     * with no trailing work) never sets it. Sticky until the run ends so
+     * the status line doesn't flicker during think-gaps between tools.
+     */
+    trailingActivity: boolean;
 };
 declare function createInitialV2State(): V2EventProcessorState;
 declare function processStreamEventV2(rawEvent: StreamEvent, state: V2EventProcessorState): V2EventProcessorState;

package/dist/index.js

@@ -276,6 +276,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":
@@ -413,7 +415,8 @@ function createInitialV2State() {
     finalData: void 0,
     steps: [],
     stepCounter: 0,
-    currentExecutingStepId: void 0
+    currentExecutingStepId: void 0,
+    trailingActivity: false
   };
 }
 function upsertUserAction(state, req) {
@@ -435,6 +438,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--) {
@@ -469,7 +473,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,
@@ -485,6 +494,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";
@@ -516,6 +526,7 @@ function processStreamEventV2(rawEvent, state) {
           step.status = "completed";
         }
       });
+      state.trailingActivity = false;
       state.lastEventType = eventType;
       break;
     }
@@ -587,6 +598,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 ----
@@ -881,7 +893,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);
@@ -906,6 +920,7 @@ function useStreamManagerV2(config, callbacks, setMessages, setIsWaitingForRespo
                 streamingContent: state.finalResponse,
                 content: "",
                 currentMessage,
+                hasTrailingActivity: state.trailingActivity,
                 streamProgress: "processing",
                 isError: false,
                 steps: [...state.steps],