@nylorun/create-agent 0.2.1-beta → 0.3.1-beta

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.3.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.
+- Update the tested Harness, Runtime, and Studio compatibility combination.
+
+## 0.3.0-beta
+
+### Minor Changes
+
+- 4badb5b: Move model execution to session startup, provide Runtime as a mountable Hono router, and generate Hono-first projects with supervised application and Studio development. Studio now resolves root-relative Runtime endpoints correctly for custom mount paths.
+
+### Patch Changes
+
+- Update the tested Harness, Runtime, and Studio compatibility combination.
+
 ## 0.2.1-beta
 
 ### Patch Changes

package/README.md

@@ -4,9 +4,9 @@
 npm create @nylorun/agent@beta my-agent
 ```
 
-Creates a project that directly installs Harness and Runtime, with Studio as a development dependency. The project owns its ordinary `agent/` code and composes the packages in `nylorun.config.ts`. No server or provider implementation is copied into the project.
+Creates a project that directly installs Harness and Runtime, with Studio as a development dependency. The project owns its Hono application in `src/index.ts`; Runtime supplies the agent router and lifecycle only.
 
-Creation installs dependencies, runs Runtime’s provider/model configuration wizard in the same terminal, then starts development. Pass `-- --no-studio` for a headless project or `-- --no-open` to suppress the browser. `nylorun configure` connects a provider without importing the agent graph.
+Creation installs dependencies, runs Runtime’s provider/model configuration wizard in the same terminal, then starts the application and Studio. Pass `-- --no-studio` for a headless project or `-- --no-open` to start Studio without opening a browser. `nylorun configure` connects a provider without importing the agent graph.
 
 ## Configuration and recovery
 
@@ -38,7 +38,7 @@ model request to validate connectivity.
 
 ## Maintaining examples
 
-`starter/` is the canonical project template. `compatibility.json` pins tested Harness, Runtime, and Studio versions. `examples.recipe.json` explicitly adds the eleven-agent registry, local package references, persistence/media configuration, and test dependencies.
+`starter/` is the canonical project template. `compatibility.json` pins tested Harness, Runtime, and Studio versions. `examples.recipe.json` explicitly adds local package references and test dependencies. Persistence and media stay in the authored examples catalog.
 
 From the repository root:
 
@@ -48,7 +48,7 @@ npm install --prefix examples
 npm run examples:check
 ```
 
-The renderer is shared by project creation, the isolated starter development runner, and examples synchronization. Sync owns shell files listed in `examples/.scaffold-manifest.json`; it never edits `agent/`, tests, local model selection, credentials, or `.data/`. Edit generated configuration in the recipe or template. Conflicts with manual generated-file edits fail before any writes. CI checks the rendered shell and runs examples against the current stack. Package changes can require explicit adaptations in authored code; sync does not rewrite TypeScript imports.
+The renderer is shared by project creation, the isolated starter development runner, and examples synchronization. Sync owns shell files listed in `examples/.scaffold-manifest.json`, including the generated `scripts/dev.mjs` supervisor; it never edits `agents/`, tests, other scripts, local model selection, credentials, or `.data/`. Edit generated configuration in the recipe or template. Conflicts with manual generated-file edits fail before any writes. CI checks the rendered shell and runs examples against the current stack. Package changes can require explicit adaptations in authored code; sync does not rewrite TypeScript imports.
 
 `npm run dev:starter` from the repository root previews a fresh project using local packages, including unpublished changes. Each preview has its own retained directory and provider configuration.
 

package/compatibility.json

@@ -1,5 +1,5 @@
 {
-  "harness": "0.11.1-beta",
-  "studio": "0.4.1-beta",
-  "runtime": "0.1.2-beta"
+  "harness": "0.12.0-beta",
+  "studio": "0.4.2-beta",
+  "runtime": "0.2.1-beta"
 }

package/dist/arguments.js

@@ -3,13 +3,7 @@ export function parse(argv) {
     const [directory, ...flags] = argv;
     if (!directory || directory.startsWith("-"))
         throw new Error(usage);
-    if (flags.some((flag) => ![
-        "--studio",
-        "--no-studio",
-        "--no-open",
-        "--skip-config",
-        "--yes",
-    ].includes(flag)))
+    if (flags.some((flag) => !["--no-studio", "--no-open", "--skip-config", "--yes"].includes(flag)))
         throw new Error(usage);
     return Object.freeze({
         directory,

package/dist/compatibility.json

@@ -1,5 +1,5 @@
 {
-  "harness": "0.11.1-beta",
-  "studio": "0.4.1-beta",
-  "runtime": "0.1.2-beta"
+  "harness": "0.12.0-beta",
+  "studio": "0.4.2-beta",
+  "runtime": "0.2.1-beta"
 }

package/dist/project.js

@@ -27,7 +27,15 @@ export async function createProject(options, compatibility, dependencies) {
     const temporary = join(dirname(destination), `.${basename(destination)}-${randomUUID()}`);
     await dependencies.makeDirectory(temporary);
     try {
-        for (const [relative, content] of Object.entries(await starterFiles(compatibility, options.studio))) {
+        const files = {
+            ...(await starterFiles(compatibility, options.studio)),
+        };
+        const name = packageName(basename(destination));
+        const manifest = JSON.parse(files["package.json"]);
+        manifest.name = name;
+        files["package.json"] = JSON.stringify(manifest, null, 2) + "\n";
+        files["README.md"] = files["README.md"].replace(/^# .+\n/u, `# ${name}\n`);
+        for (const [relative, content] of Object.entries(files)) {
             const file = join(temporary, relative);
             await dependencies.makeDirectory(dirname(file));
             await dependencies.write(file, content);
@@ -79,6 +87,14 @@ export async function createProject(options, compatibility, dependencies) {
         }
     }
 }
+function packageName(directory) {
+    const name = directory
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/gu, "-")
+        .replace(/^[-.]+|[-.]+$/gu, "")
+        .replace(/-+/gu, "-");
+    return name || "my-nylorun-agent";
+}
 function quote(value) {
     if (/^[a-zA-Z0-9_./-]+$/.test(value))
         return value;

package/dist/scaffold.js

@@ -33,8 +33,12 @@ export async function starterFiles(compatibility, studio) {
     if (!studio) {
         const manifest = JSON.parse(files["package.json"]);
         delete manifest.devDependencies["@nylorun/studio"];
-        manifest.scripts.dev = "nylorun dev --no-studio";
+        manifest.scripts.dev = manifest.scripts["dev:app"];
+        delete manifest.scripts["dev:app"];
+        delete manifest.scripts.studio;
+        delete files["scripts/dev.mjs"];
         files["package.json"] = JSON.stringify(manifest, null, 2) + "\n";
+        files["README.md"] = files["README.md"].replace("`npm run dev` starts your app on port 3000, waits until its agent endpoint is ready, then starts Studio and opens it in your browser. Use `npm run dev -- --no-open` to start Studio without opening a browser. Run `npm run studio` in another terminal to attach Studio separately.", "`npm run dev` starts your app on port 3000.");
     }
     return Object.freeze(files);
 }

package/dist/starter/README.md

@@ -1,6 +1,6 @@
 # My agent
 
 The creator configures a provider before starting development. For later sessions, run `npm run dev`. If setup was skipped with `--skip-config` or interrupted, run `npm run configure` first, then `npm run dev`.
-Edit agents under `agent/` and compose Runtime in `nylorun.config.ts`.
+Edit agents under `agents/` and compose your Hono app in `src/index.ts`.
 
-`npm run dev -- --no-studio` starts without Studio. `npm run build` creates `dist/`; deploy it alongside `package.json`, installed production dependencies, and private project configuration, then run `npm start`.
+`npm run dev` starts your app on port 3000, waits until its agent endpoint is ready, then starts Studio and opens it in your browser. Use `npm run dev -- --no-open` to start Studio without opening a browser. Run `npm run studio` in another terminal to attach Studio separately. `npm run build` creates `dist/`; deploy it alongside `package.json`, installed production dependencies, and private project configuration, then run `npm start`.

package/dist/starter/{agent → agents}/assistant/agent.ts

@@ -1,10 +1,7 @@
 import { Agent } from "@nylorun/harness";
-import { piModel } from "@nylorun/runtime";
 
 export const assistant = Agent({
   id: "assistant",
   name: "Assistant",
   instructions: ["You are helpful."],
-})
-  .with(piModel())
-  .build();
+}).build();

package/dist/starter/package.json

@@ -8,20 +8,24 @@
   },
   "scripts": {
     "configure": "nylorun configure",
-    "dev": "nylorun dev",
-    "inspect": "nylorun inspect",
-    "build": "nylorun build",
-    "start": "nylorun start",
+    "dev": "node scripts/dev.mjs",
+    "dev:app": "tsx watch src/index.ts",
+    "studio": "nylorun studio --agent-url http://localhost:3000/agents",
+    "build": "node -e \"import('node:fs/promises').then(async ({rm,cp}) => { await rm('dist', { recursive: true, force: true }); await cp('agents', 'dist/agents', { recursive: true, filter: (source) => !source.endsWith('.ts') }); })\" && tsc -p tsconfig.build.json",
+    "start": "node dist/src/index.js",
     "check": "tsc --noEmit"
   },
   "dependencies": {
     "@nylorun/harness": "{{HARNESS_VERSION}}",
     "@nylorun/runtime": "{{RUNTIME_VERSION}}",
+    "@hono/node-server": "^2.1.1",
+    "hono": "^4.13.7",
     "zod": "^4.1.12"
   },
   "devDependencies": {
     "@nylorun/studio": "{{STUDIO_VERSION}}",
     "@types/node": "^22.18.0",
-    "typescript": "^5.9.3"
+    "tsx": "^4.20.6",
+    "typescript": "^7.0.2"
   }
 }

package/dist/starter/scripts/dev.mjs

@@ -0,0 +1,82 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+
+const args = process.argv.slice(2);
+if (
+  args.some((arg) => arg !== "--no-open") ||
+  args.filter((arg) => arg === "--no-open").length > 1
+)
+  throw new Error("Usage: npm run dev [-- --no-open]");
+
+const port = Number(process.env.PORT ?? "3000");
+if (!Number.isInteger(port) || port < 1 || port > 65535)
+  throw new Error("PORT must be an integer between 1 and 65535.");
+
+const bin = (name) =>
+  join(
+    process.cwd(),
+    "node_modules",
+    ".bin",
+    process.platform === "win32" ? `${name}.cmd` : name
+  );
+const spawnOptions = { stdio: "inherit", shell: process.platform === "win32" };
+const app = spawn(bin("tsx"), ["watch", "src/index.ts"], spawnOptions);
+let studio;
+let stopping = false;
+
+const exitCode = (code, signal) =>
+  code ?? (signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 1);
+const stop = (signal) => {
+  if (stopping) return;
+  stopping = true;
+  for (const child of [app, studio]) child?.kill(signal);
+};
+
+process.once("SIGINT", () => stop("SIGINT"));
+process.once("SIGTERM", () => stop("SIGTERM"));
+
+app.once("exit", (code, signal) => {
+  if (!stopping) {
+    process.exitCode = exitCode(code, signal);
+    stop("SIGTERM");
+  }
+});
+
+try {
+  await waitForReady(`http://127.0.0.1:${port}/agents/v1/agents`);
+  if (stopping) process.exitCode ??= 0;
+  else {
+    studio = spawn(
+      bin("nylorun"),
+      [
+        "studio",
+        "--agent-url",
+        `http://localhost:${port}/agents`,
+        ...(args.includes("--no-open") ? ["--no-open"] : []),
+      ],
+      spawnOptions
+    );
+    studio.once("exit", (code, signal) => {
+      if (!stopping) {
+        process.exitCode = exitCode(code, signal);
+        stop("SIGTERM");
+      }
+    });
+  }
+} catch (error) {
+  process.exitCode = 1;
+  console.error(error instanceof Error ? error.message : String(error));
+  stop("SIGTERM");
+}
+
+async function waitForReady(url) {
+  const deadline = Date.now() + 20_000;
+  while (!stopping && Date.now() < deadline) {
+    try {
+      const response = await fetch(url);
+      if (response.ok) return;
+    } catch {}
+    await new Promise((resolve) => setTimeout(resolve, 50));
+  }
+  if (!stopping) throw new Error(`Application did not become ready at ${url}.`);
+}

package/dist/starter/src/index.ts

@@ -0,0 +1,32 @@
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { Runtime, serveAgents } from "@nylorun/runtime";
+import { agents } from "../agents/index.js";
+
+const app = new Hono();
+
+app.get("/", (c) =>
+  c.json({
+    agents: agents.map((agent) => ({
+      id: agent.id,
+      name: agent.name,
+      manifest: agent.manifest,
+    })),
+  }),
+);
+
+const runtime = new Runtime();
+app.route(
+  "/agents",
+  serveAgents({ agents, runtime, basePath: "/agents" })
+);
+
+serve(
+  {
+    fetch: app.fetch,
+    port: Number(process.env.PORT ?? "3000"),
+  },
+  (info) => {
+    console.log(`Server is running on http://localhost:${info.port}`);
+  },
+);

package/dist/starter/tsconfig.build.json

@@ -0,0 +1,5 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": { "noEmit": false, "outDir": "dist", "rootDir": "." },
+  "include": ["agents/**/*.ts", "src/**/*.ts"]
+}

package/dist/starter/tsconfig.json

@@ -9,5 +9,5 @@
     "noEmit": true,
     "types": ["node"]
   },
-  "include": ["agent/**/*.ts", "nylorun.config.ts"]
+  "include": ["agents/**/*.ts", "src/**/*.ts"]
 }

package/dist/sync.d.ts

@@ -4,7 +4,7 @@ export interface ExamplesRecipe {
     dependencies: Record<string, string>;
     devDependencies: Record<string, string>;
     scripts: Record<string, string>;
-    configuration: string;
+    index: string;
 }
 export declare function examplesFiles(compatibility: Compatibility, recipe: ExamplesRecipe): Promise<{
     [k: string]: string;

package/dist/sync.js

@@ -26,14 +26,14 @@ export async function examplesFiles(compatibility, recipe) {
     };
     manifest.scripts = Object.fromEntries(Object.entries(manifest.scripts).sort(([left], [right]) => rank(left) - rank(right) || left.localeCompare(right)));
     files["package.json"] = JSON.stringify(manifest, null, 2) + "\n";
-    files["nylorun.config.ts"] = recipe.configuration;
+    files["src/index.ts"] = recipe.index;
     const tsconfig = JSON.parse(files["tsconfig.json"]);
     tsconfig.include.push("test/**/*.ts");
     files["tsconfig.json"] = JSON.stringify(tsconfig, null, 2) + "\n";
     return files;
 }
 function managed(path) {
-    return (!path.startsWith("agent/") &&
+    return (!path.startsWith("agents/") &&
         !path.startsWith("config/") &&
         path !== "README.md");
 }
@@ -48,7 +48,7 @@ export async function synchronize(root, files, compatibility, options) {
             path.split("/").some((part) => !part || part === "." || part === "..") ||
             !managed(path) ||
             path.startsWith("test/") ||
-            path.startsWith("scripts/") ||
+            (path.startsWith("scripts/") && path !== "scripts/dev.mjs") ||
             path.startsWith(".data/") ||
             path.startsWith("node_modules/") ||
             (path.startsWith(".env/") &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nylorun/create-agent",
-  "version": "0.2.1-beta",
+  "version": "0.3.1-beta",
   "description": "Create a local Nylorun Harness agent project.",
   "type": "module",
   "license": "Apache-2.0",
@@ -41,10 +41,10 @@
   "devDependencies": {
     "@nylorun/harness": "file:../harness",
     "@nylorun/runtime": "file:../runtime",
-    "@types/node": "^22.18.0",
+    "@types/node": "^26.5.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vitest": "^4.1.11",
+    "vitest": "^5.0.0",
     "zod": "^4.1.12"
   }
 }

package/dist/starter/nylorun.config.ts

@@ -1,4 +0,0 @@
-import { defineRuntime } from "@nylorun/runtime";
-import { agents } from "./agent/registry.js";
-
-export default defineRuntime({ agents });