@arbidocs/sdk 0.3.132 → 0.3.134

package/dist/{browser-B1XvwSa9.d.cts → browser-BSWvYcjS.d.cts}

@@ -309,6 +309,7 @@ type ResponseOutputItemDoneEvent = components['schemas']['ResponseOutputItemDone
 type ResponseContentPartAddedEvent = components['schemas']['ResponseContentPartAddedEvent'];
 type AgentStepEvent = components['schemas']['AgentStepEvent'];
 type AgentStepDeltaEvent = components['schemas']['AgentStepDeltaEvent'];
+type GeneratingEvent = components['schemas']['GeneratingEvent'];
 type UserInputRequestEvent = components['schemas']['UserInputRequestEvent'];
 type ProbeAnswerEvent = components['schemas']['ProbeAnswerEvent'];
 type DeferredInterjectionEvent = components['schemas']['DeferredInterjectionEvent'];
@@ -404,6 +405,13 @@ interface SSEStreamCallbacks {
     onAgentStep?: (data: AgentStepEvent) => void;
     /** Live narration delta — append `delta` to the focus of the step with the matching `index`. */
     onAgentStepDelta?: (data: AgentStepDeltaEvent) => void;
+    /**
+     * The model has started generating free text. Open the token channel here.
+     * It does NOT mean the text is the answer — a preamble before a tool call
+     * looks identical at this point. Only the absence of a tool call proves it
+     * was the answer, which is not known until the turn resolves.
+     */
+    onGenerating?: (data: GeneratingEvent) => void;
     onError?: (message: string) => void;
     /**
      * Fired when the server emits a structured `arbi.error` event mid-stream.

package/dist/{browser-B1XvwSa9.d.ts → browser-BSWvYcjS.d.ts}

@@ -309,6 +309,7 @@ type ResponseOutputItemDoneEvent = components['schemas']['ResponseOutputItemDone
 type ResponseContentPartAddedEvent = components['schemas']['ResponseContentPartAddedEvent'];
 type AgentStepEvent = components['schemas']['AgentStepEvent'];
 type AgentStepDeltaEvent = components['schemas']['AgentStepDeltaEvent'];
+type GeneratingEvent = components['schemas']['GeneratingEvent'];
 type UserInputRequestEvent = components['schemas']['UserInputRequestEvent'];
 type ProbeAnswerEvent = components['schemas']['ProbeAnswerEvent'];
 type DeferredInterjectionEvent = components['schemas']['DeferredInterjectionEvent'];
@@ -404,6 +405,13 @@ interface SSEStreamCallbacks {
     onAgentStep?: (data: AgentStepEvent) => void;
     /** Live narration delta — append `delta` to the focus of the step with the matching `index`. */
     onAgentStepDelta?: (data: AgentStepDeltaEvent) => void;
+    /**
+     * The model has started generating free text. Open the token channel here.
+     * It does NOT mean the text is the answer — a preamble before a tool call
+     * looks identical at this point. Only the absence of a tool call proves it
+     * was the answer, which is not known until the turn resolves.
+     */
+    onGenerating?: (data: GeneratingEvent) => void;
     onError?: (message: string) => void;
     /**
      * Fired when the server emits a structured `arbi.error` event mid-stream.

package/dist/browser.cjs

@@ -3786,14 +3786,10 @@ async function resolveWorkspace(store, workspaceOpt) {
 }
 
 // src/sse.ts
-var LIFECYCLE_LABELS_FALLBACK = {
-  goal: "Thinking\u2026",
-  evaluation: "Evaluating results",
-  answering: "Answered",
-  interjection: "Your message",
-  planning: "Planning",
-  tool_progress: "Working"
-};
+function humanizeStep(identifier) {
+  const spaced = identifier.replace(/[_-]+/g, " ").trim();
+  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
 function resolveDocRefs(text, docNames) {
   if (!docNames) return text;
   return text.replace(/\{(doc-[^}]+)\}/g, (_match, id) => docNames[id] ?? id);
@@ -3837,13 +3833,13 @@ function formatAgentStepLabel(step, docNames) {
   if (step.label) return `${step.label}${suffix}`;
   const detail = step.detail;
   if (step.step === "tool_progress" && detail && detail.length > 0) {
-    const label = detail[0].label || LIFECYCLE_LABELS_FALLBACK.tool_progress;
+    const label = detail[0].label || detail[0].tool && humanizeStep(detail[0].tool) || humanizeStep(step.step);
     if (suffix) return `${label}${suffix}`;
     const message = detail[0].message;
     return message ? `${label}: ${resolveDocRefs(message, docNames)}` : label;
   }
   if (step.step) {
-    return LIFECYCLE_LABELS_FALLBACK[step.step] || step.step;
+    return humanizeStep(step.step);
   }
   if (detail && detail.length > 0) {
     if (detail[0].label) return `${detail[0].label}${suffix}`;
@@ -3966,6 +3962,11 @@ async function streamSSE(response, callbacks = {}) {
       callbacks.onAgentStep?.(data);
       if (data.t != null) callbacks.onElapsedTime?.(data.t);
     },
+    "arbi.generating": (raw) => {
+      const data = JSON.parse(raw);
+      callbacks.onGenerating?.(data);
+      if (data.t != null) callbacks.onElapsedTime?.(data.t);
+    },
     "arbi.agent_step_delta": (raw) => {
       const data = JSON.parse(raw);
       callbacks.onAgentStepDelta?.(data);