@contextableai/clawg-ui 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.3 (2026-02-06)
+
+### Fixed
+- Append `\n\n` paragraph joiner to streamed text deltas so chunks render with proper spacing
+- Include `runId` in all `TEXT_MESSAGE_START`, `TEXT_MESSAGE_CONTENT`, and `TEXT_MESSAGE_END` events for AG-UI protocol compliance
+
+### Changed
+- Set channel defaults to `blockStreaming: true` and `chunkMode: "newline"` for correct paragraph-based streaming out of the box
+- Clean up multi-run logic for tool-call-then-text flows (single run per request)
+
 ## 0.2.2 (2026-02-05)
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextableai/clawg-ui",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "AG-UI protocol channel plugin for OpenClaw — connect CopilotKit and AG-UI clients to your OpenClaw gateway",
   "type": "module",
   "license": "MIT",
@@ -39,7 +39,11 @@
       "docsPath": "/channels/clawg-ui",
       "docsLabel": "clawg-ui",
       "blurb": "AG-UI protocol endpoint for CopilotKit and HttpAgent clients.",
-      "order": 90
+      "order": 90,
+      "defaults": {
+        "blockStreaming": true,
+        "chunkMode": "newline"
+      }
     },
     "install": {
       "npmSpec": "@contextableai/clawg-ui",

package/src/http-handler.ts

@@ -368,8 +368,9 @@ export function createAguiHttpHandler(api: OpenClawPluginApi) {
     res.flushHeaders?.();
 
     let closed = false;
-    const messageId = `msg-${randomUUID()}`;
+    let currentMessageId = `msg-${randomUUID()}`;
     let messageStarted = false;
+    let currentRunId = runId;
 
     const writeEvent = (event: { type: EventType } & Record<string, unknown>) => {
       if (closed) {
@@ -408,7 +409,7 @@ export function createAguiHttpHandler(api: OpenClawPluginApi) {
     }
 
     // Register SSE writer so before/after_tool_call hooks can emit AG-UI events
-    setWriter(sessionKey, writeEvent, messageId);
+    setWriter(sessionKey, writeEvent, currentMessageId);
     const storePath = runtime.channel.session.resolveStorePath(cfg.session?.store, {
       agentId: route.agentId,
     });
@@ -473,18 +474,23 @@ export function createAguiHttpHandler(api: OpenClawPluginApi) {
         if (!text) {
           return false;
         }
+
         if (!messageStarted) {
           messageStarted = true;
           writeEvent({
             type: EventType.TEXT_MESSAGE_START,
-            messageId,
+            messageId: currentMessageId,
+            runId: currentRunId,
             role: "assistant",
           });
         }
+
+        // Join chunks with \n\n (breakPreference: paragraph uses double-newline joiner)
         writeEvent({
           type: EventType.TEXT_MESSAGE_CONTENT,
-          messageId,
-          delta: text,
+          messageId: currentMessageId,
+          runId: currentRunId,
+          delta: text + "\n\n",
         });
         return true;
       },
@@ -493,32 +499,37 @@ export function createAguiHttpHandler(api: OpenClawPluginApi) {
           return false;
         }
         const text = wasClientToolCalled(sessionKey) ? "" : payload.text?.trim();
+
         if (text) {
           if (!messageStarted) {
             messageStarted = true;
             writeEvent({
               type: EventType.TEXT_MESSAGE_START,
-              messageId,
+              messageId: currentMessageId,
+              runId: currentRunId,
               role: "assistant",
             });
           }
+          // Join chunks with \n\n (breakPreference: paragraph uses double-newline joiner)
           writeEvent({
             type: EventType.TEXT_MESSAGE_CONTENT,
-            messageId,
-            delta: text,
+            messageId: currentMessageId,
+            runId: currentRunId,
+            delta: text + "\n\n",
           });
         }
         // End the message and run
         if (messageStarted) {
           writeEvent({
             type: EventType.TEXT_MESSAGE_END,
-            messageId,
+            messageId: currentMessageId,
+            runId: currentRunId,
           });
         }
         writeEvent({
           type: EventType.RUN_FINISHED,
           threadId,
-          runId,
+          runId: currentRunId,
         });
         closed = true;
         res.end();
@@ -550,13 +561,14 @@ export function createAguiHttpHandler(api: OpenClawPluginApi) {
         if (messageStarted) {
           writeEvent({
             type: EventType.TEXT_MESSAGE_END,
-            messageId,
+            messageId: currentMessageId,
+            runId: currentRunId,
           });
         }
         writeEvent({
           type: EventType.RUN_FINISHED,
           threadId,
-          runId,
+          runId: currentRunId,
         });
         closed = true;
         res.end();

package/src/tool-store.ts

@@ -129,3 +129,4 @@ export function clearClientToolCalled(sessionKey: string): void {
   console.log(`[clawg-ui] clearClientToolCalled: sessionKey=${sessionKey}`);
   clientToolCalledFlags.delete(sessionKey);
 }
+