@contextableai/clawg-ui 0.3.3 → 0.4.1

package/README.md

@@ -133,9 +133,30 @@ 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 |
 |---|---|---|---|

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");
@@ -254,6 +254,13 @@ export function createAguiHttpHandler(api) {
             });
             return;
         }
+        // CopilotKit single-transport sends { method: "info" } to the main URL
+        if (body &&
+            typeof body === "object" &&
+            body.method === "info") {
+            sendJson(res, 200, buildAgentsResponse(runtime));
+            return;
+        }
         const input = body;
         const threadId = input.threadId || `clawg-ui-${randomUUID()}`;
         const runId = input.runId || `clawg-ui-run-${randomUUID()}`;
@@ -551,3 +558,31 @@ export function createAguiHttpHandler(api) {
         }
     };
 }
+// ---------------------------------------------------------------------------
+// /info handler — agent discovery for CopilotKit
+// ---------------------------------------------------------------------------
+function buildAgentsResponse(runtime) {
+    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" };
+    }
+    return { agents };
+}
+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;
+        }
+        sendJson(res, 200, buildAgentsResponse(runtime));
+    };
+}

package/package.json

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