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

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.5.0-beta
+
+### Minor Changes
+
+- fa1860a: Use standard MODEL_PROVIDER, MODEL, MODEL_PROVIDER_API_KEY, and MODEL_PROVIDER_BASE_URL environment configuration. Export starter Hono apps and provide CLI development and production Node launchers. Existing starters require manual migration. Release preparation must update the creator Runtime compatibility pin with this release.
+
+### Patch Changes
+
+- Update the tested Harness, Runtime, and Studio compatibility combination.
+
+## 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 and API keys use a conventional `.env` file (`MODEL_PROVIDER`, `MODEL`, `MODEL_PROVIDER_API_KEY`, and optional `MODEL_PROVIDER_BASE_URL`). The starter exports its Hono app; `nylorun start` supplies the production Node launcher. OAuth state is optional in `.nylorun/auth.json`. See [Runtime migration instructions](../runtime/README.md#upgrading-an-existing-starter).
+
+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.4.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.4.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.example

@@ -0,0 +1,6 @@
+# Copy to .env and fill in a provider and model, or run npm run configure.
+MODEL_PROVIDER=
+MODEL=
+MODEL_PROVIDER_API_KEY=
+# For MODEL_PROVIDER=custom only:
+# MODEL_PROVIDER_BASE_URL=https://your-provider.example/v1

package/dist/starter/README.md

@@ -3,4 +3,8 @@
 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 `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`.
+`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 environment variables, then run `npm start`.
+
+Development orchestration is provided by the installed `nylorun` CLI. Use `npm run dev -- --no-studio` for the application alone. Copy `.env.example` to `.env` and fill in `MODEL_PROVIDER`, `MODEL`, and `MODEL_PROVIDER_API_KEY`, or run `npm run configure`. Custom OpenAI-compatible providers also use `MODEL_PROVIDER_BASE_URL`. Hosting providers can supply these variables directly; no credential files are required for API keys. The single `tsconfig.json` builds your sources; `npm run check` checks types without emitting files.
+
+`src/index.ts` exports the Hono app. `nylorun dev` and `nylorun start` supply the Node server and load `.env` without overriding process variables. OAuth state, when used, lives in ignored `.nylorun/auth.json`. Serverless session behavior and Workers compatibility require separate validation.

package/dist/starter/_gitignore

@@ -1,7 +1,9 @@
 node_modules/
 dist/
 .data/
-.env/*
-!.env/.gitignore
-!.env/README.md
+.env
+.env.local
+.nylorun/
+
+# Legacy local settings remain private until migrated.
 config/model.json

package/dist/starter/package.json

@@ -8,17 +8,15 @@
   },
   "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",
-    "start": "node dist/src/index.js",
+    "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": "nylorun start",
     "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"
   },

package/dist/starter/src/index.ts

@@ -1,4 +1,3 @@
-import { serve } from "@hono/node-server";
 import { Hono } from "hono";
 import { Runtime, serveAgents } from "@nylorun/runtime";
 import { agents } from "../agents/index.js";
@@ -18,15 +17,7 @@ app.get("/", (c) =>
 const runtime = new Runtime();
 app.route(
   "/agents",
-  serveAgents({ agents, runtime, basePath: "/agents" })
+  serveAgents({ agents, runtime })
 );
 
-serve(
-  {
-    fetch: app.fetch,
-    port: Number(process.env.PORT ?? "3000"),
-  },
-  (info) => {
-    console.log(`Server is running on http://localhost:${info.port}`);
-  },
-);
+export default app;

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;
@@ -49,6 +59,10 @@ export async function synchronize(root, files, compatibility, options) {
             !managed(path) ||
             path.startsWith("test/") ||
             (path.startsWith("scripts/") && path !== "scripts/dev.mjs") ||
+            path === ".env" ||
+            path === ".env.local" ||
+            path === ".nylorun" ||
+            path.startsWith(".nylorun/") ||
             path.startsWith(".data/") ||
             path.startsWith("node_modules/") ||
             (path.startsWith(".env/") &&

package/package.json

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

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

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

package/dist/starter/.env/_gitignore

@@ -1,3 +0,0 @@
-*
-!.gitignore
-!README.md

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"]
-}