@radaros/transport 0.3.31 → 0.3.33

package/dist/index.cjs

@@ -1606,6 +1606,99 @@ function createAgentRouter(opts) {
     router.get("/registry", (_req, res) => {
       res.json(reg.list());
     });
+    router.get("/agents/:name/card", (req, res) => {
+      const r = reg;
+      if (typeof r.getAgentCard !== "function") return res.status(501).json({ error: "Discovery cards not available" });
+      const card = r.getAgentCard(req.params.name);
+      if (!card) return res.status(404).json({ error: `Agent "${req.params.name}" not found` });
+      res.json(card);
+    });
+    router.get("/.well-known/agent-cards.json", (_req, res) => {
+      const r = reg;
+      if (typeof r.getAllAgentCards !== "function") return res.json([]);
+      res.json(r.getAllAgentCards());
+    });
+    router.get("/approvals/pending", (_req, res) => {
+      const pending = [];
+      for (const agent of reg.agents.values()) {
+        const mgr = agent.approvalManager;
+        if (mgr && typeof mgr.listPending === "function") {
+          pending.push(...mgr.listPending());
+        }
+      }
+      res.json(pending);
+    });
+    router.post("/approvals/:requestId/approve", (req, res) => {
+      const { requestId } = req.params;
+      const { reason } = req.body ?? {};
+      for (const agent of reg.agents.values()) {
+        const mgr = agent.approvalManager;
+        if (mgr && typeof mgr.approve === "function") {
+          mgr.approve(requestId, reason);
+        }
+      }
+      res.json({ status: "approved", requestId });
+    });
+    router.post("/approvals/:requestId/deny", (req, res) => {
+      const { requestId } = req.params;
+      const { reason } = req.body ?? {};
+      for (const agent of reg.agents.values()) {
+        const mgr = agent.approvalManager;
+        if (mgr && typeof mgr.deny === "function") {
+          mgr.deny(requestId, reason);
+        }
+      }
+      res.json({ status: "denied", requestId });
+    });
+    router.get("/agents/:name/checkpoints", async (req, res) => {
+      const agent = reg.getAgent(req.params.name);
+      if (!agent) return res.status(404).json({ error: `Agent "${req.params.name}" not found` });
+      const config = agent.config;
+      const checkpointMgr = config?._checkpointManager;
+      if (!checkpointMgr) return res.json([]);
+      const runId = req.query.runId;
+      if (!runId) return res.status(400).json({ error: "runId query param required" });
+      try {
+        const checkpoints = await checkpointMgr.list(runId);
+        res.json(checkpoints);
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+    router.post("/agents/:name/rollback/:checkpointId", async (req, res) => {
+      const agent = reg.getAgent(req.params.name);
+      if (!agent) return res.status(404).json({ error: `Agent "${req.params.name}" not found` });
+      const config = agent.config;
+      const checkpointMgr = config?._checkpointManager;
+      if (!checkpointMgr) return res.status(400).json({ error: "Checkpointing not enabled for this agent" });
+      try {
+        const checkpoint = await checkpointMgr.rollback(req.params.checkpointId);
+        if (!checkpoint) return res.status(404).json({ error: "Checkpoint not found" });
+        res.json(checkpoint);
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+    router.get("/approvals/stream", (req, res) => {
+      res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      });
+      const listener = (data) => {
+        res.write(`data: ${JSON.stringify(data)}
+
+`);
+      };
+      for (const agent of reg.agents.values()) {
+        agent.eventBus.on("tool.approval.request", listener);
+      }
+      req.on("close", () => {
+        for (const agent of reg.agents.values()) {
+          agent.eventBus.off("tool.approval.request", listener);
+        }
+      });
+    });
   }
   if (opts.scheduler) {
     const queue = opts.scheduler;
@@ -1636,6 +1729,38 @@ function createAgentRouter(opts) {
       }
     });
   }
+  if (opts.metricsExporter) {
+    const exporter = opts.metricsExporter;
+    router.get("/metrics", (_req, res) => {
+      res.set("Content-Type", "text/plain; version=0.0.4; charset=utf-8");
+      res.send(exporter.toPrometheus());
+    });
+    router.get("/metrics/json", (req, res) => {
+      const agent = req.query.agent;
+      if (agent) {
+        res.json(exporter.getMetrics(agent));
+      } else {
+        res.json(exporter.toJSON());
+      }
+    });
+    router.get("/metrics/stream", (req, res) => {
+      res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      });
+      const handler = (event) => {
+        res.write(`data: ${JSON.stringify(event)}
+
+`);
+      };
+      const subscribers = exporter.subscribers;
+      subscribers.add(handler);
+      req.on("close", () => {
+        subscribers.delete(handler);
+      });
+    });
+  }
   if (opts.admin) {
     const adminOpts = typeof opts.admin === "object" ? opts.admin : {};
     const { router: adminRouter } = createAdminRouter({

package/dist/index.d.cts

@@ -206,6 +206,10 @@ interface RouterOptions {
      * Pass an AgentQueue instance from `@radaros/queue`.
      */
     scheduler?: any;
+    /**
+     * MetricsExporter instance from `@radaros/observability` for `/metrics` endpoints.
+     */
+    metricsExporter?: any;
 }
 
 declare function createAgentRouter(opts: RouterOptions): any;

package/dist/index.d.ts

@@ -206,6 +206,10 @@ interface RouterOptions {
      * Pass an AgentQueue instance from `@radaros/queue`.
      */
     scheduler?: any;
+    /**
+     * MetricsExporter instance from `@radaros/observability` for `/metrics` endpoints.
+     */
+    metricsExporter?: any;
 }
 
 declare function createAgentRouter(opts: RouterOptions): any;

package/dist/index.js

@@ -1563,6 +1563,99 @@ function createAgentRouter(opts) {
     router.get("/registry", (_req, res) => {
       res.json(reg.list());
     });
+    router.get("/agents/:name/card", (req, res) => {
+      const r = reg;
+      if (typeof r.getAgentCard !== "function") return res.status(501).json({ error: "Discovery cards not available" });
+      const card = r.getAgentCard(req.params.name);
+      if (!card) return res.status(404).json({ error: `Agent "${req.params.name}" not found` });
+      res.json(card);
+    });
+    router.get("/.well-known/agent-cards.json", (_req, res) => {
+      const r = reg;
+      if (typeof r.getAllAgentCards !== "function") return res.json([]);
+      res.json(r.getAllAgentCards());
+    });
+    router.get("/approvals/pending", (_req, res) => {
+      const pending = [];
+      for (const agent of reg.agents.values()) {
+        const mgr = agent.approvalManager;
+        if (mgr && typeof mgr.listPending === "function") {
+          pending.push(...mgr.listPending());
+        }
+      }
+      res.json(pending);
+    });
+    router.post("/approvals/:requestId/approve", (req, res) => {
+      const { requestId } = req.params;
+      const { reason } = req.body ?? {};
+      for (const agent of reg.agents.values()) {
+        const mgr = agent.approvalManager;
+        if (mgr && typeof mgr.approve === "function") {
+          mgr.approve(requestId, reason);
+        }
+      }
+      res.json({ status: "approved", requestId });
+    });
+    router.post("/approvals/:requestId/deny", (req, res) => {
+      const { requestId } = req.params;
+      const { reason } = req.body ?? {};
+      for (const agent of reg.agents.values()) {
+        const mgr = agent.approvalManager;
+        if (mgr && typeof mgr.deny === "function") {
+          mgr.deny(requestId, reason);
+        }
+      }
+      res.json({ status: "denied", requestId });
+    });
+    router.get("/agents/:name/checkpoints", async (req, res) => {
+      const agent = reg.getAgent(req.params.name);
+      if (!agent) return res.status(404).json({ error: `Agent "${req.params.name}" not found` });
+      const config = agent.config;
+      const checkpointMgr = config?._checkpointManager;
+      if (!checkpointMgr) return res.json([]);
+      const runId = req.query.runId;
+      if (!runId) return res.status(400).json({ error: "runId query param required" });
+      try {
+        const checkpoints = await checkpointMgr.list(runId);
+        res.json(checkpoints);
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+    router.post("/agents/:name/rollback/:checkpointId", async (req, res) => {
+      const agent = reg.getAgent(req.params.name);
+      if (!agent) return res.status(404).json({ error: `Agent "${req.params.name}" not found` });
+      const config = agent.config;
+      const checkpointMgr = config?._checkpointManager;
+      if (!checkpointMgr) return res.status(400).json({ error: "Checkpointing not enabled for this agent" });
+      try {
+        const checkpoint = await checkpointMgr.rollback(req.params.checkpointId);
+        if (!checkpoint) return res.status(404).json({ error: "Checkpoint not found" });
+        res.json(checkpoint);
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+    router.get("/approvals/stream", (req, res) => {
+      res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      });
+      const listener = (data) => {
+        res.write(`data: ${JSON.stringify(data)}
+
+`);
+      };
+      for (const agent of reg.agents.values()) {
+        agent.eventBus.on("tool.approval.request", listener);
+      }
+      req.on("close", () => {
+        for (const agent of reg.agents.values()) {
+          agent.eventBus.off("tool.approval.request", listener);
+        }
+      });
+    });
   }
   if (opts.scheduler) {
     const queue = opts.scheduler;
@@ -1593,6 +1686,38 @@ function createAgentRouter(opts) {
       }
     });
   }
+  if (opts.metricsExporter) {
+    const exporter = opts.metricsExporter;
+    router.get("/metrics", (_req, res) => {
+      res.set("Content-Type", "text/plain; version=0.0.4; charset=utf-8");
+      res.send(exporter.toPrometheus());
+    });
+    router.get("/metrics/json", (req, res) => {
+      const agent = req.query.agent;
+      if (agent) {
+        res.json(exporter.getMetrics(agent));
+      } else {
+        res.json(exporter.toJSON());
+      }
+    });
+    router.get("/metrics/stream", (req, res) => {
+      res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      });
+      const handler = (event) => {
+        res.write(`data: ${JSON.stringify(event)}
+
+`);
+      };
+      const subscribers = exporter.subscribers;
+      subscribers.add(handler);
+      req.on("close", () => {
+        subscribers.delete(handler);
+      });
+    });
+  }
   if (opts.admin) {
     const adminOpts = typeof opts.admin === "object" ? opts.admin : {};
     const { router: adminRouter } = createAdminRouter({

package/package.json

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