@nylorun/runtime 0.2.0-beta → 0.2.1-beta

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.1-beta
+
+### Patch Changes
+
+- fd24b00: Flatten Runtime agent routes to `/:id/...` and pass matching `basePath` from the Hono mount so discovery, manifests, and AG-UI resolve at `/agents/:id/...` for Studio.
+
 ## 0.2.0-beta
 
 ### Minor Changes

package/README.md

@@ -6,14 +6,17 @@ Portable agent lifecycle, a mountable Hono protocol router, pi-ai model provider
 import { Runtime, serveAgents } from "@nylorun/runtime";
 
 const runtime = new Runtime();
-app.route("/agents", serveAgents({ agents, runtime }));
+app.route(
+  "/agents",
+  serveAgents({ agents, runtime, basePath: "/agents" })
+);
 ```
 
 `Runtime` is the primitive stack: model adapter (`piModel` by default), observer (`jsonlObserver` per session by default), and durability (`localJsonl` by default). Session files live together under `.data/sessions/<agent>/<session>/` as `events.jsonl` and `observe.jsonl`. Agents bind only when served.
 
 The application owns Hono composition, authentication, CORS, logging, process lifecycle, and deployment. Runtime owns agent sessions, durability, media, and AG-UI/session protocol routes. Graceful shutdown is optional: if the application installs signal handlers and wants to drain live sessions, flush pending journal writes, and run optional agent cleanup, it should await `runtime.close()`. An application that does not install handlers exits normally on its host's shutdown policy; `runtime.close()` does not run on crash, OOM, or SIGKILL.
 
-Runtime publishes root-relative discovery and endpoint URLs. Mounting below root requires the matching public prefix, so Studio and other clients can resolve those URLs against any configured agent-server URL:
+Runtime publishes root-relative discovery and endpoint URLs. `basePath` must match the Hono mount path so advertised manifests and AG-UI endpoints resolve. Agent-scoped routes are `/:id/...` inside the router, so mounting at `/agents` with `basePath: "/agents"` yields `/agents/:id/...`. Pass the same prefix for other mounts:
 
 ```ts
 app.route(

package/dist/server/host.js

@@ -57,16 +57,16 @@ export class Runtime {
             protocolVersion: 2,
             agents: agents.map((agent) => ({
                 id: agent.id,
-                manifestUrl: publicPath(`/agents/${agent.id}/manifest.json`),
+                manifestUrl: publicPath(`/${agent.id}/manifest.json`),
             })),
         }));
-        app.get("/agents/:agentId/manifest.json", (context) => {
+        app.get("/:agentId/manifest.json", (context) => {
             const agent = byId.get(context.req.param("agentId"));
             return agent === undefined
                 ? context.json({ error: "unknown agent" }, 404)
                 : context.json(manifest(agent, media !== undefined, publicPath));
         });
-        app.get("/agents/:agentId/v1/media/:session/:assetId", async (context) => {
+        app.get("/:agentId/v1/media/:session/:assetId", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (!agent)
                 return context.json({ error: "unknown agent" }, 404);
@@ -78,7 +78,7 @@ export class Runtime {
                 "content-type": asset.asset.mediaType,
             });
         });
-        app.get("/agents/:agentId/v1/sessions", async (context) => {
+        app.get("/:agentId/v1/sessions", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (agent === undefined)
                 return context.json({ error: "unknown agent" }, 404);
@@ -94,7 +94,7 @@ export class Runtime {
                 }),
             });
         });
-        app.get("/agents/:agentId/v1/sessions/:session", async (context) => {
+        app.get("/:agentId/v1/sessions/:session", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (!agent)
                 return context.json({ error: "unknown agent" }, 404);
@@ -110,7 +110,7 @@ export class Runtime {
                 pending_interaction: pending(events),
             });
         });
-        app.post("/agents/:agentId/v1/sessions/:session", async (context) => {
+        app.post("/:agentId/v1/sessions/:session", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (!agent)
                 return context.json({ error: "unknown agent" }, 404);
@@ -152,7 +152,7 @@ export class Runtime {
             }
             return context.json({ error: "expected approval or respond interaction" }, 400);
         });
-        app.get("/agents/:agentId/v1/sessions/:session/events", async (context) => {
+        app.get("/:agentId/v1/sessions/:session/events", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (!agent)
                 return context.json({ error: "unknown agent" }, 404);
@@ -165,7 +165,7 @@ export class Runtime {
                 next_cursor: events.at(-1)?.seq ?? after,
             });
         });
-        app.get("/agents/:agentId/v1/ag-ui/sessions/:session", async (context) => {
+        app.get("/:agentId/v1/ag-ui/sessions/:session", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (!agent)
                 return context.json({ error: "unknown agent" }, 404);
@@ -175,7 +175,7 @@ export class Runtime {
                     messages(agent.id, await journal.events(agent.id, context.req.param("session"))),
             });
         });
-        app.post("/agents/:agentId/v1/ag-ui", async (context) => {
+        app.post("/:agentId/v1/ag-ui", async (context) => {
             const agent = requireAgent(context.req.param("agentId"));
             if (!agent)
                 return context.json({ error: "unknown agent" }, 404);
@@ -368,8 +368,8 @@ function manifest(agent, media, publicPath) {
         name: agent.manifest.name,
         manifest: agent.manifest,
         endpoints: {
-            agUi: publicPath(`/agents/${agent.id}/v1/ag-ui`),
-            sessions: publicPath(`/agents/${agent.id}/v1/sessions`),
+            agUi: publicPath(`/${agent.id}/v1/ag-ui`),
+            sessions: publicPath(`/${agent.id}/v1/sessions`),
         },
         ...(media
             ? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nylorun/runtime",
-  "version": "0.2.0-beta",
+  "version": "0.2.1-beta",
   "description": "Portable agent runtime, Hono protocol router, model providers, and the Nylorun CLI.",
   "type": "module",
   "license": "Apache-2.0",