@contextableai/clawg-ui 0.3.2 → 0.4.0

package/README.md

@@ -133,15 +133,36 @@ function App() {
 }
 ```
 
+## Agent discovery (`/info`)
+
+The plugin registers a `/v1/clawg-ui/info` endpoint that CopilotKit and other AG-UI clients use to discover available agents. Accepts GET or POST.
+
+```bash
+curl http://localhost:18789/v1/clawg-ui/info \
+  -H "Authorization: Bearer <device-token>"
+```
+
+Response:
+
+```json
+{
+  "agents": {
+    "main": { "name": "main", "description": "Default agent" }
+  }
+}
+```
+
+The response reflects the agents configured in OpenClaw's `agents.list` config. If no agents are configured, a default `"main"` agent is returned.
+
 ## Request format
 
-The endpoint accepts a POST with a JSON body matching the AG-UI `RunAgentInput` schema:
+The run endpoint accepts a POST with a JSON body matching the AG-UI `RunAgentInput` schema:
 
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `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

@@ -2,7 +2,7 @@ import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { randomUUID } from "node:crypto";
 import { EventType } from "@ag-ui/core";
 import { aguiChannelPlugin } from "./src/channel.js";
-import { createAguiHttpHandler } from "./src/http-handler.js";
+import { createAguiHttpHandler, createAguiInfoHandler } from "./src/http-handler.js";
 import { clawgUiToolFactory } from "./src/client-tools.js";
 import { getWriter, getMessageId, pushToolCallId, popToolCallId, isClientTool, setClientToolCalled, setToolFiredInRun, } from "./src/tool-store.js";
 /**
@@ -97,6 +97,11 @@ const plugin = {
             auth: "plugin",
             handler: createAguiHttpHandler(api),
         });
+        api.registerHttpRoute({
+            path: "/v1/clawg-ui/info",
+            auth: "plugin",
+            handler: createAguiInfoHandler(api),
+        });
         api.on("before_tool_call", handleBeforeToolCall);
         api.on("tool_result_persist", handleToolResultPersist);
         // CLI commands for device management

package/dist/src/http-handler.d.ts

@@ -1,3 +1,4 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 export declare function createAguiHttpHandler(api: OpenClawPluginApi): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export declare function createAguiInfoHandler(api: OpenClawPluginApi): (_req: IncomingMessage, res: ServerResponse) => Promise<void>;

package/dist/src/http-handler.js

@@ -12,8 +12,8 @@ function sendJson(res, status, body) {
     res.setHeader("Content-Type", "application/json; charset=utf-8");
     res.end(JSON.stringify(body));
 }
-function sendMethodNotAllowed(res) {
-    res.setHeader("Allow", "POST");
+function sendMethodNotAllowed(res, allow = "POST") {
+    res.setHeader("Allow", allow);
     res.statusCode = 405;
     res.setHeader("Content-Type", "text/plain; charset=utf-8");
     res.end("Method Not Allowed");
@@ -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
@@ -543,3 +551,28 @@ export function createAguiHttpHandler(api) {
         }
     };
 }
+// ---------------------------------------------------------------------------
+// /info handler — agent discovery for CopilotKit
+// ---------------------------------------------------------------------------
+export function createAguiInfoHandler(api) {
+    const runtime = api.runtime;
+    return async function handleAguiInfo(_req, res) {
+        if (_req.method !== "GET" && _req.method !== "POST") {
+            sendMethodNotAllowed(res, "GET, POST");
+            return;
+        }
+        const cfg = runtime.config.loadConfig();
+        const agentList = cfg
+            .agents?.list ?? [];
+        const agents = {};
+        for (const agent of agentList) {
+            const name = agent.name ?? agent.id;
+            agents[agent.id] = { name, description: name };
+        }
+        // If no agents configured, expose a default "main" agent
+        if (Object.keys(agents).length === 0) {
+            agents["main"] = { name: "main", description: "Default agent" };
+        }
+        sendJson(res, 200, { agents });
+    };
+}

package/package.json

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