@butlerbot/sdk 0.0.30 → 0.0.32

package/dist/modules/transport_sse.js

@@ -52,9 +52,16 @@ class SSEConversationTransport {
         if (!endpoint)
             return undefined;
         const response = await this.post(endpoint, { chatId: request.chatId, mode: request.mode });
+        if (!response)
+            return undefined;
         // 404 is "nothing was running", which is the ordinary answer to stopping a moment late.
-        if (!response || response.status === 404)
+        // Anything else is the server refusing or failing, and a stop button that quietly does
+        // nothing is the hardest kind of bug to report — so it is said out loud.
+        if (!response.ok) {
+            if (response.status !== 404)
+                console.warn(`[Stop failed: ${response.status}]`, await response.text().catch(() => ""));
             return undefined;
+        }
         const body = await response.json().catch(() => undefined);
         return body?.stop;
     }
@@ -69,7 +76,13 @@ class SSEConversationTransport {
             return { ok: true };
         // 409: the turn is no longer accepting messages. The caller still has something the
         // user typed and must send it as an ordinary turn.
-        return { ok: false, reason: response.status === 409 ? "too_late" : "no_turn" };
+        if (response.status === 409)
+            return { ok: false, reason: "too_late" };
+        // Anything other than "no turn" means the message did not land for a reason the caller
+        // cannot see: it still falls back to sending, but not in silence.
+        if (response.status !== 404)
+            console.warn(`[Steer failed: ${response.status}]`, await response.text().catch(() => ""));
+        return { ok: false, reason: "no_turn" };
     }
     async post(endpoint, body) {
         const url = (0, url_formatter_1.formatURL)(endpoint, undefined, { apiKey: this.config.apiKey, debug: this.config.debug });
@@ -82,9 +95,10 @@ class SSEConversationTransport {
         }
         catch (error) {
             // A stop that cannot reach the server is not worth throwing over: the turn is
-            // ending on its own soon enough, and the caller has no better move to make.
-            if (this.config.debug)
-                console.warn(`[Interrupt failed: ${endpoint}]`, error);
+            // ending on its own soon enough, and the caller has no better move to make. It is
+            // still worth saying, and not only in debug — an interruption that vanishes without
+            // a trace is indistinguishable from one the UI forgot to wire up.
+            console.warn(`[Interrupt failed: ${endpoint}]`, error);
             return undefined;
         }
     }

package/dist/types/conversation/v3/conversation_v3.d.ts

@@ -197,6 +197,26 @@ export type ConvoStatusPayload = {
 };
 export type ResponseStatusPayload = {
     completed: boolean;
+    /** Present when the turn was stopped rather than finished on its own.
+     *  `mode` is what was applied and `requestedMode` what was asked for: they differ when a
+     *  hard stop was downgraded because the model's provider ignores a cancelled stream. */
+    stop?: {
+        mode: "soft" | "hard";
+        requestedMode: "soft" | "hard";
+        by: "user" | "system";
+        /** When the stop was requested. */
+        at: number;
+    };
+    /**
+     * Messages steered into the turn that never reached the model, in the order they were sent.
+     *
+     * Steering only lands at a step boundary, and a turn does not always have another one: it
+     * stops, it fails, or the model answers without needing a further step. The text is not in
+     * the conversation's history — it was never said to anyone — so it is handed back here and
+     * the client decides what to do with it. Send it as an ordinary message when the turn
+     * merely ended; put it back in front of the user when they are the one who stopped it.
+     */
+    undeliveredSteer?: string[];
     /** Rich response metadata — only present on the final `completed: true` event.
      *  Populated by the caller (e.g. gateway) after the response finishes and usage is available. */
     metadata?: ResponseMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@butlerbot/sdk",
-	"version": "0.0.30",
+	"version": "0.0.32",
 	"description": "The official ButlerBot SDK",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",