@contextableai/clawg-ui 0.3.1 → 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/index.js

@@ -108,7 +108,8 @@ const plugin = {
                 .command("devices")
                 .description("List approved devices")
                 .action(async () => {
-                const devices = await api.runtime.channel.pairing.readAllowFromStore("clawg-ui");
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK types lag behind runtime
+                const devices = await api.runtime.channel.pairing.readAllowFromStore({ channel: "clawg-ui" });
                 if (devices.length === 0) {
                     console.log("No approved devices.");
                     return;

package/dist/src/http-handler.js

@@ -226,8 +226,8 @@ export function createAguiHttpHandler(api) {
         // ---------------------------------------------------------------------------
         // Pairing check: verify device is approved
         // ---------------------------------------------------------------------------
-        const storeAllowFrom = await runtime.channel.pairing
-            .readAllowFromStore("clawg-ui")
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK types lag behind runtime; object form required in 2026.3.7+
+        const storeAllowFrom = await runtime.channel.pairing.readAllowFromStore({ channel: "clawg-ui" })
             .catch(() => []);
         const normalizedAllowFrom = storeAllowFrom.map((e) => e.replace(/^clawg-ui:/i, "").toLowerCase());
         const allowed = normalizedAllowFrom.includes(deviceId.toLowerCase());
@@ -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.1",
+  "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",