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

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.4.0-beta
+
+### Minor Changes
+
+- 9c350be: Provide `nylorun dev` with optional Studio and browser opening, automatic development loopback CORS, and inferred Hono mount paths. Move local model selection to `.env/model.json` with legacy fallback and migration. Generate starters without copied launcher scripts, a top-level config directory, or a separate TypeScript build config. Release preparation must update the creator's Runtime compatibility pin together with these changes.
+
+### Patch Changes
+
+- Update the tested Harness, Runtime, and Studio compatibility combination.
+
 ## 0.3.1-beta
 
 ### Patch Changes

package/README.md

@@ -48,8 +48,12 @@ 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`, 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.
+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 `src/index.ts`, `package.json`, and TypeScript configuration; 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.
 
 Repository development: [contributing](../CONTRIBUTING.md). Package publication: [releasing](../RELEASING.md).
+
+Generated projects use `nylorun dev`, with `--no-studio` and `--no-open` options, rather than a copied supervisor script. They contain one `tsconfig.json`; `npm run check` checks without emitting and `npm run build` emits to `dist/`. Repository examples add their own build configuration to exclude tests. Provider/model selection lives in `.env/model.json`, so configuration creates no top-level `config/` directory.
+
+To verify the packed starter after building all packages, run `node create-agent/scripts/smoke-starter.mjs` from the repository root. It installs candidate tarballs into a disposable project and checks type checking, production output, agent assets, development CORS, streaming, watch reload, and shutdown. Add `--serve` to keep the fixture Studio running for browser verification; stop it with Ctrl-C. It uses a deterministic model adapter and makes no provider calls.

package/compatibility.json

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

package/dist/compatibility.json

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

package/dist/scaffold.js

@@ -33,10 +33,8 @@ export async function starterFiles(compatibility, studio) {
     if (!studio) {
         const manifest = JSON.parse(files["package.json"]);
         delete manifest.devDependencies["@nylorun/studio"];
-        manifest.scripts.dev = manifest.scripts["dev:app"];
-        delete manifest.scripts["dev:app"];
+        manifest.scripts.dev = "nylorun dev --no-studio";
         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.");
     }

package/dist/starter/.env/README.md

@@ -1,4 +1,4 @@
 # Project credentials
 
-Run `npm run configure`. Provider credentials are stored in `auth.json`.
+Run `npm run configure`. Provider credentials are stored in `auth.json`, and provider/model selection in `model.json`.
 Do not commit credentials. Optional integration environment variables belong in `integrations.env`.

package/dist/starter/README.md

@@ -4,3 +4,5 @@ The creator configures a provider before starting development. For later session
 Edit agents under `agents/` and compose your Hono app in `src/index.ts`.
 
 `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`.
+
+Development orchestration is provided by the installed `nylorun` CLI. Use `npm run dev -- --no-studio` for the application alone. Local provider/model selection is stored in `.env/model.json`. The single `tsconfig.json` builds your sources; `npm run check` checks types without emitting files.

package/dist/starter/_gitignore

@@ -4,4 +4,6 @@ dist/
 .env/*
 !.env/.gitignore
 !.env/README.md
+
+# Legacy local settings remain private until migrated.
 config/model.json

package/dist/starter/package.json

@@ -8,10 +8,9 @@
   },
   "scripts": {
     "configure": "nylorun configure",
-    "dev": "node scripts/dev.mjs",
-    "dev:app": "tsx watch src/index.ts",
+    "dev": "nylorun dev",
     "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",
+    "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.json",
     "start": "node dist/src/index.js",
     "check": "tsc --noEmit"
   },

package/dist/starter/src/index.ts

@@ -18,7 +18,7 @@ app.get("/", (c) =>
 const runtime = new Runtime();
 app.route(
   "/agents",
-  serveAgents({ agents, runtime, basePath: "/agents" })
+  serveAgents({ agents, runtime })
 );
 
 serve(

package/dist/starter/tsconfig.json

@@ -6,8 +6,14 @@
     "strict": true,
     "verbatimModuleSyntax": true,
     "skipLibCheck": true,
-    "noEmit": true,
-    "types": ["node"]
+    "types": [
+      "node"
+    ],
+    "outDir": "dist",
+    "rootDir": "."
   },
-  "include": ["agents/**/*.ts", "src/**/*.ts"]
+  "include": [
+    "agents/**/*.ts",
+    "src/**/*.ts"
+  ]
 }

package/dist/sync.js

@@ -25,9 +25,19 @@ export async function examplesFiles(compatibility, recipe) {
         return index < 0 ? scriptOrder.length : index;
     };
     manifest.scripts = Object.fromEntries(Object.entries(manifest.scripts).sort(([left], [right]) => rank(left) - rank(right) || left.localeCompare(right)));
+    manifest.scripts.build = manifest.scripts.build.replace("tsc -p tsconfig.json", "tsc -p tsconfig.build.json");
+    files["tsconfig.build.json"] =
+        JSON.stringify({
+            extends: "./tsconfig.json",
+            compilerOptions: { noEmit: false, rootDir: ".", outDir: "dist" },
+            include: ["agents/**/*.ts", "src/**/*.ts"],
+        }, null, 2) + "\n";
     files["package.json"] = JSON.stringify(manifest, null, 2) + "\n";
     files["src/index.ts"] = recipe.index;
     const tsconfig = JSON.parse(files["tsconfig.json"]);
+    tsconfig.compilerOptions.noEmit = true;
+    delete tsconfig.compilerOptions.rootDir;
+    delete tsconfig.compilerOptions.outDir;
     tsconfig.include.push("test/**/*.ts");
     files["tsconfig.json"] = JSON.stringify(tsconfig, null, 2) + "\n";
     return files;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nylorun/create-agent",
-  "version": "0.3.1-beta",
+  "version": "0.4.0-beta",
   "description": "Create a local Nylorun Harness agent project.",
   "type": "module",
   "license": "Apache-2.0",

package/dist/starter/scripts/dev.mjs

@@ -1,82 +0,0 @@
-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/tsconfig.build.json

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