@radaros/transport 0.3.14 → 0.3.15

package/README.md

@@ -29,8 +29,9 @@ app.listen(3000);
 
 ## Features
 
-- **Express Router** — REST API with streaming support
-- **Socket.IO Gateway** — Real-time WebSocket communication
+- **Auto-Discovery** — Reads from the global `Registry` at request time; agents created after server start are immediately available
+- **Express Router** — REST API with streaming support and list endpoints (`GET /agents`, `/teams`, `/workflows`, `/tools`)
+- **Socket.IO Gateway** — Real-time WebSocket communication with dynamic agent/team lookup and tool discovery
 - **A2A Server** — Agent-to-Agent protocol support
 - **CORS & Rate Limiting** — Built-in security middleware
 - **Swagger** — Auto-generated API documentation

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Agent, A2AAgentCard, Registry, Servable, Team, Workflow, EventBus, VoiceAgent } from '@radaros/core';
+import { Agent, A2AAgentCard, Registry, Servable, Team, Workflow, ToolDef, Toolkit, EventBus, VoiceAgent } from '@radaros/core';
 
 interface A2AServerOptions {
     agents: Record<string, Agent>;
@@ -104,6 +104,10 @@ interface RouterOptions {
         windowMs?: number;
         max?: number;
     } | boolean;
+    /** Named tool library exposed via GET /tools. Tools from toolkits are auto-collected. */
+    toolLibrary?: Record<string, ToolDef>;
+    /** Toolkit instances whose tools are exposed via GET /tools. Merged with toolLibrary. */
+    toolkits?: Toolkit[];
 }
 
 declare function createAgentRouter(opts: RouterOptions): any;
@@ -218,6 +222,10 @@ interface GatewayOptions {
     authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
     /** Max requests per minute per socket. Default: 60 */
     maxRequestsPerMinute?: number;
+    /** Named tool library exposed via tools.list event. */
+    toolLibrary?: Record<string, ToolDef>;
+    /** Toolkit instances whose tools are exposed via tools.list. Merged with toolLibrary. */
+    toolkits?: Toolkit[];
 }
 
 declare function createAgentGateway(opts: GatewayOptions): void;

package/dist/index.js

@@ -431,7 +431,7 @@ function requestLogger(options) {
 
 // src/express/router-factory.ts
 import { createRequire as createRequire4 } from "module";
-import { classifyServables, registry as globalRegistry } from "@radaros/core";
+import { classifyServables, collectToolkitTools, describeToolLibrary, registry as globalRegistry } from "@radaros/core";
 
 // src/express/swagger.ts
 import { createRequire as createRequire3 } from "module";
@@ -1287,6 +1287,22 @@ function createAgentRouter(opts) {
       res.json(reg.list());
     });
   }
+  const fromToolkits = opts.toolkits ? collectToolkitTools(opts.toolkits) : {};
+  const mergedTools = { ...fromToolkits, ...opts.toolLibrary ?? {} };
+  if (Object.keys(mergedTools).length > 0) {
+    router.get("/tools", (_req, res) => {
+      res.json(describeToolLibrary(mergedTools));
+    });
+    router.get("/tools/:name", (req, res) => {
+      const tool = mergedTools[req.params.name];
+      if (!tool) return res.status(404).json({ error: `Tool "${req.params.name}" not found` });
+      res.json({
+        name: tool.name,
+        description: tool.description,
+        parameters: Object.keys(tool.parameters.shape ?? {})
+      });
+    });
+  }
   return router;
 }
 
@@ -1404,7 +1420,7 @@ function createBrowserGateway(opts) {
 }
 
 // src/socketio/gateway.ts
-import { classifyServables as classifyServables2, registry as globalRegistry2 } from "@radaros/core";
+import { classifyServables as classifyServables2, collectToolkitTools as collectToolkitTools2, describeToolLibrary as describeToolLibrary2, registry as globalRegistry2 } from "@radaros/core";
 function createSocketRateLimiter(maxPerMinute = 60) {
   return () => {
     let count = 0;
@@ -1482,6 +1498,54 @@ function createAgentGateway(opts) {
         socket.emit("agent.error", { error: error.message });
       }
     });
+    socket.on("agents.list", (_data, ack) => {
+      if (reg) {
+        ack?.(reg.describeAgents());
+      } else {
+        const names = Object.keys(opts.agents ?? {});
+        ack?.(names.map((n) => ({ name: n })));
+      }
+    });
+    socket.on("teams.list", (_data, ack) => {
+      if (reg) {
+        ack?.(reg.describeTeams());
+      } else {
+        const names = Object.keys(opts.teams ?? {});
+        ack?.(names.map((n) => ({ name: n })));
+      }
+    });
+    socket.on("workflows.list", (_data, ack) => {
+      if (reg) {
+        ack?.(reg.describeWorkflows());
+      } else {
+        ack?.([]);
+      }
+    });
+    socket.on("registry.list", (_data, ack) => {
+      if (reg) {
+        ack?.(reg.list());
+      } else {
+        ack?.({
+          agents: Object.keys(opts.agents ?? {}),
+          teams: Object.keys(opts.teams ?? {}),
+          workflows: []
+        });
+      }
+    });
+    const fromToolkits = opts.toolkits ? collectToolkitTools2(opts.toolkits) : {};
+    const mergedTools = { ...fromToolkits, ...opts.toolLibrary ?? {} };
+    socket.on("tools.list", (_data, ack) => {
+      ack?.(describeToolLibrary2(mergedTools));
+    });
+    socket.on("tools.get", (data, ack) => {
+      const tool = mergedTools[data?.name];
+      if (!tool) return ack?.({ error: `Tool "${data?.name}" not found` });
+      ack?.({
+        name: tool.name,
+        description: tool.description,
+        parameters: Object.keys(tool.parameters.shape ?? {})
+      });
+    });
     socket.on("disconnect", () => {
     });
     socket.on("team.run", async (data) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radaros/transport",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "description": "HTTP and WebSocket transport layer for RadarOS agents",
   "license": "MIT",
   "repository": {
@@ -39,7 +39,7 @@
     "typescript": "^5.6.0"
   },
   "peerDependencies": {
-    "@radaros/core": "^0.3.14",
+    "@radaros/core": "^0.3.15",
     "@types/express": "^4.0.0 || ^5.0.0",
     "express": "^4.0.0 || ^5.0.0",
     "multer": ">=2.0.0",