@butlerbot/sdk 0.0.44 → 0.0.45

package/dist/link/protocol.d.ts

@@ -120,6 +120,8 @@ export type LinkClientPayloads = {
         model?: string;
         instructions?: string;
         personality?: string;
+        /** Why Alfred is speaking on this one turn: a line for its system prompt, at most 500 characters. */
+        wake?: string;
     };
     "conversation.end": {
         sessionId: string;

package/dist/modules/conversation.d.ts

@@ -27,6 +27,14 @@ export type DialogueRequestParams = {
     address?: ConversationAddress;
     /** Custom personality configuration for the AI */
     personality?: string;
+    /**
+     * Why Alfred is speaking on this turn, when something other than the message is the
+     * reason — for example "You are joining because a rule of the user's matched: ...".
+     * A line added to this one turn's system prompt and never written to the conversation,
+     * so it is passed per `send()`/`ask()` rather than set on the conversation. At most
+     * 500 characters; the server refuses a longer one. Left off when blank.
+     */
+    wake?: string;
 };
 export type DialogueRequestOptions = Omit<Omit<DialogueRequestParams, "message">, "chatId">;
 export interface RequestResponseByVersion {

package/dist/modules/transport.d.ts

@@ -58,6 +58,8 @@ export type TransportTurnRequest = {
     /** Where on the platform the conversation is: on Discord, the channel and thread. */
     address?: ConversationAddress;
     personality?: string;
+    /** Why Alfred is speaking on this one turn: a line for its system prompt, at most 500 characters. */
+    wake?: string;
 };
 export type TransportHandlers = {
     /** One payload of the stream, already in the shape callers expect. */

package/dist/modules/transport_link.js

@@ -184,6 +184,8 @@ class LinkConversationTransport {
                 ...(request.model ? { model: request.model } : {}),
                 ...(request.instructions ? { instructions: request.instructions } : {}),
                 ...(request.personality ? { personality: request.personality } : {}),
+                // Per turn, never on the session: it says why Alfred was woken for this one.
+                ...(request.wake?.trim() ? { wake: request.wake.trim() } : {}),
             }, {
                 // A turn takes as long as it takes; only the transport dying ends it early.
                 timeoutMs: 0,

package/dist/modules/transport_sse.js

@@ -120,5 +120,8 @@ function asQuery(request) {
         query.address = JSON.stringify(request.address);
     if (request.personality)
         query.personality = request.personality;
+    const wake = request.wake?.trim();
+    if (wake)
+        query.wake = wake;
     return query;
 }

package/package.json

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