@contextableai/clawg-ui 0.3.2 → 0.3.3

package/README.md

@@ -141,7 +141,7 @@ The endpoint accepts a POST with a JSON body matching the AG-UI `RunAgentInput`
 |---|---|---|---|
 | `threadId` | string | no | Conversation thread ID. Auto-generated if omitted. |
 | `runId` | string | no | Unique run ID. Auto-generated if omitted. |
-| `messages` | Message[] | yes | Array of messages. At least one `user` message required. |
+| `messages` | Message[] | yes | Array of messages. May be empty (returns an empty run). For agent execution, at least one `user` or `tool` message should be present. |
 | `tools` | Tool[] | no | Client-side tool definitions. The agent can invoke these; see [Tool call events](#tool-call-events). |
 | `state` | object | no | Client state (reserved for future use). |
 

package/dist/src/http-handler.js

@@ -264,13 +264,21 @@ export function createAguiHttpHandler(api) {
         const hasUserMessage = messages.some((m) => m.role === "user");
         const hasToolMessage = messages.some((m) => m.role === "tool");
         if (!hasUserMessage && !hasToolMessage) {
-            console.log(`[clawg-ui] 400: no user/tool message, roles=[${messages.map((m) => m.role).join(",")}], messageCount=${messages.length}`);
-            sendJson(res, 400, {
-                error: {
-                    message: "At least one user or tool message is required in `messages`.",
-                    type: "invalid_request_error",
-                },
-            });
+            // AG-UI protocol allows empty messages (used for session init/sync).
+            // Return a valid empty run instead of 400.
+            const accept = typeof req.headers.accept === "string"
+                ? req.headers.accept
+                : "text/event-stream";
+            const encoder = new EventEncoder({ accept });
+            res.statusCode = 200;
+            res.setHeader("Content-Type", encoder.getContentType());
+            res.setHeader("Cache-Control", "no-cache");
+            res.setHeader("Connection", "keep-alive");
+            res.setHeader("X-Accel-Buffering", "no");
+            res.flushHeaders?.();
+            res.write(encoder.encode({ type: EventType.RUN_STARTED, threadId, runId }));
+            res.write(encoder.encode({ type: EventType.RUN_FINISHED, threadId, runId }));
+            res.end();
             return;
         }
         // Build body from messages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextableai/clawg-ui",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "AG-UI protocol channel plugin for OpenClaw — connect CopilotKit and AG-UI clients to your OpenClaw gateway",
   "type": "module",
   "license": "MIT",