@nylorun/create-agent 0.7.1-beta → 0.8.0-beta

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.8.0-beta
4
+
5
+ ### Minor Changes
6
+
7
+ - b8d822a: Generated projects run `nylorun serve` for `npm start` and plain `nylorun studio`, which
8
+ resolves the active Runtime scope instead of a hardcoded loopback URL. The starter README
9
+ explains that the Runtime keeps running after `npm run dev` stops, that a source edit
10
+ re-registers agents rather than restarting the host, and that `npx nylorun down` stops it.
11
+ Release preparation must update the creator CLI compatibility pin with this release.
12
+
13
+ ### Patch Changes
14
+
15
+ - Update the tested Harness, SDK, Runtime, and Studio compatibility combination.
16
+
3
17
  ## 0.7.1-beta
4
18
 
5
19
  ### Patch Changes
package/README.md CHANGED
@@ -6,17 +6,16 @@ npm create @nylorun/agent@beta my-agent
6
6
 
7
7
  Creates a Node 24 project with `@nylorun/agents`, `@nylorun/cli`, Zod, and optional Studio. The registry in `agents/index.ts` exports agent definitions. The starter includes one ordinary `lookup_order` tool; ask “Look up order demo-123”.
8
8
 
9
- Creation installs dependencies, runs provider configuration, and starts development. Use `-- --no-studio` for headless development or `-- --no-open` to suppress browser opening. Noninteractive creation requires `-- --skip-config`; configure the retained project before running it. Without provider settings startup reports `nylorun configure`. `--yes` affects installation only.
9
+ Creation installs dependencies and starts development. Use `-- --no-studio` for headless development or `-- --no-open` to suppress browser opening. `--yes` affects installation only. The first `nylorun dev` or `nylorun serve` starts the local Runtime and asks for the model provider when the terminal is interactive and stores the credential in the Runtime vault. A non-interactive start without a credential exits and names that setup. `NYLORUN_DEV_MODEL=fixture` skips it.
10
10
 
11
11
  ```sh
12
12
  cd my-agent
13
- npm run configure
14
13
  npm run dev
15
14
  npm run build
16
15
  npm start
17
16
  ```
18
17
 
19
- Development restarts the Runtime and connected executor on source changes. Compiled start uses `dist/agents/index.js` and runs headless. Studio can attach separately. Local Runtime credentials and SQLite are stored in gitignored `.nylorun/`. Model selection remains Runtime configuration in `.env`; definitions have no model provider or `agent.run()`.
18
+ Development restarts the Runtime and connected executor on source changes. `npm start` runs `nylorun serve`, which uses `dist/agents/index.js` and runs headless. Studio can attach separately and can replace an API-key credential. `nylorun configure` replaces the credential against an already running Runtime. Local Runtime credentials, the vault, and SQLite are stored in gitignored `.nylorun/`. Definitions have no model provider or `agent.run()`.
20
19
 
21
20
  `starter/` is the canonical template. `compatibility.json` pins core, harness, SDK, Runtime, Studio and CLI. The examples recipe adds local package dependencies. Run `npm run examples:sync` after template changes, then `npm install --prefix examples`. Sync preserves authored agents, tests, credentials, and local state; it rejects conflicting edits to generated files.
22
21
 
@@ -1,8 +1,8 @@
1
1
  {
2
- "harness": "0.16.0-beta",
3
- "studio": "0.6.1-beta",
4
- "runtime": "0.7.0-beta",
5
- "agents": "0.3.0-beta",
6
- "core": "0.2.0-beta",
7
- "cli": "0.1.2-beta"
2
+ "harness": "0.17.0-beta",
3
+ "studio": "0.7.0-beta",
4
+ "runtime": "0.8.0-beta",
5
+ "agents": "0.4.0-beta",
6
+ "core": "0.3.0-beta",
7
+ "cli": "0.2.0-beta"
8
8
  }
@@ -1,3 +1,3 @@
1
1
  import type { CreateOptions } from "./contracts.js";
2
- export declare const usage = "Usage: npm create @nylorun/agent@beta <directory> [--no-studio] [--no-open] [--skip-config] [--yes]";
2
+ export declare const usage = "Usage: npm create @nylorun/agent@beta <directory> [--no-studio] [--no-open] [--yes]";
3
3
  export declare function parse(argv: readonly string[]): CreateOptions;
package/dist/arguments.js CHANGED
@@ -1,15 +1,14 @@
1
- export const usage = "Usage: npm create @nylorun/agent@beta <directory> [--no-studio] [--no-open] [--skip-config] [--yes]";
1
+ export const usage = "Usage: npm create @nylorun/agent@beta <directory> [--no-studio] [--no-open] [--yes]";
2
2
  export function parse(argv) {
3
3
  const [directory, ...flags] = argv;
4
4
  if (!directory || directory.startsWith("-"))
5
5
  throw new Error(usage);
6
- if (flags.some((flag) => !["--no-studio", "--no-open", "--skip-config", "--yes"].includes(flag)))
6
+ if (flags.some((flag) => !["--no-studio", "--no-open", "--yes"].includes(flag)))
7
7
  throw new Error(usage);
8
8
  return Object.freeze({
9
9
  directory,
10
10
  studio: !flags.includes("--no-studio"),
11
11
  open: !flags.includes("--no-open"),
12
12
  yes: flags.includes("--yes"),
13
- skipConfig: flags.includes("--skip-config"),
14
13
  });
15
14
  }
@@ -1,8 +1,8 @@
1
1
  {
2
- "harness": "0.16.0-beta",
3
- "studio": "0.6.1-beta",
4
- "runtime": "0.7.0-beta",
5
- "agents": "0.3.0-beta",
6
- "core": "0.2.0-beta",
7
- "cli": "0.1.2-beta"
2
+ "harness": "0.17.0-beta",
3
+ "studio": "0.7.0-beta",
4
+ "runtime": "0.8.0-beta",
5
+ "agents": "0.4.0-beta",
6
+ "core": "0.3.0-beta",
7
+ "cli": "0.2.0-beta"
8
8
  }
@@ -11,7 +11,6 @@ export type CreateOptions = Readonly<{
11
11
  studio: boolean;
12
12
  open: boolean;
13
13
  yes: boolean;
14
- skipConfig?: boolean;
15
14
  }>;
16
15
  export type Process = Readonly<{
17
16
  status: number | null;
package/dist/project.js CHANGED
@@ -20,9 +20,6 @@ export async function createProject(options, compatibility, dependencies) {
20
20
  throw new Error("Target directory must be a new child of the current directory.");
21
21
  if (await dependencies.exists(destination))
22
22
  throw new Error(`Target directory already exists: ${destination}`);
23
- if (!options.skipConfig && !dependencies.isInteractive())
24
- throw new Error("Provider configuration requires interactive stdin and stdout. " +
25
- `To configure later, run: npm create @nylorun/agent@beta ${quote(options.directory)} -- --skip-config`);
26
23
  dependencies.signal?.throwIfAborted();
27
24
  const temporary = join(dirname(destination), `.${basename(destination)}-${randomUUID()}`);
28
25
  await dependencies.makeDirectory(temporary);
@@ -49,14 +46,7 @@ export async function createProject(options, compatibility, dependencies) {
49
46
  }
50
47
  dependencies.log("Installing dependencies...");
51
48
  await stage("Installation", ["install", ...(options.yes ? ["--yes"] : [])]);
52
- if (options.skipConfig) {
53
- dependencies.log(`Provider configuration skipped. Configure later in another terminal:\ncd ${quote(destination)}\nnpm run configure`);
54
- }
55
- else {
56
- dependencies.log("Configuring your provider and model...");
57
- await stage("Provider configuration", ["run", "configure"]);
58
- }
59
- dependencies.log("Starting development...");
49
+ dependencies.log("Starting development. The first start sets up the model provider in the Runtime vault.");
60
50
  await stage("Development", [
61
51
  "run",
62
52
  "dev",
@@ -76,11 +66,9 @@ export async function createProject(options, compatibility, dependencies) {
76
66
  }
77
67
  catch (error) {
78
68
  const cancelled = error instanceof CreationCancelled;
79
- const configured = name === "Development" && !options.skipConfig;
80
69
  const recovery = [
81
70
  `cd ${quote(destination)}`,
82
71
  ...(name === "Installation" ? ["npm install"] : []),
83
- ...(configured ? [] : ["npm run configure"]),
84
72
  "npm run dev",
85
73
  ].join("\n");
86
74
  throw new CreationError(`${cancelled ? error.message : `${name} failed.`} The generated project was kept.\n${name === "Development" ? "Restart" : "Resume"} with:\n${recovery}`, cancelled ? error.exitCode : 1);
@@ -1,4 +1,5 @@
1
- # Prefer npm run configure; model configuration belongs to the Runtime.
1
+ # Model provider credentials are stored in the Runtime vault (.nylorun/), not here.
2
+ # The first nylorun dev / nylorun serve prompts for them, or seeds them once from:
2
3
  # MODEL_PROVIDER=...
3
4
  # MODEL=...
4
5
  # MODEL_PROVIDER_API_KEY=...
@@ -1,23 +1,22 @@
1
1
  # My Nylorun agent
2
2
 
3
- Requires Node 24 and npm 11. Agent and tool definitions live in `agents/`. The CLI runs a separate SQLite Runtime and connects your tools through the SDK's authenticated SSE executor.
3
+ Requires Node 24 and npm 11. Agent and tool definitions live in `agents/`. A separate SQLite Runtime holds your sessions; this project attaches to it and connects your tools through the SDK's authenticated SSE executor.
4
4
 
5
5
  ```sh
6
- npm run configure
7
6
  npm run dev
8
7
  ```
9
8
 
10
- Open Studio and ask **Look up order demo-123**. The local tool returns `shipped`; Studio shows the tool call and assistant response. Model calls use your configured provider and may incur its usual charges.
9
+ The first run starts the Runtime for you and asks for a model provider, storing the credential in the Runtime vault. **The Runtime keeps running after you stop `dev`, so sessions survive a source change.** `npx nylorun down` stops it; `npx nylorun runtime status` shows where it is. Later runs reuse it. Open Studio and ask **Look up order demo-123**. The local tool returns `shipped`; Studio shows the tool call and assistant response. Model calls use the Runtime's saved provider and may incur its usual charges. Studio's Model provider screen can replace an API key. `npx nylorun configure` does the same from a terminal while the Runtime is running.
11
10
 
12
- `npm run dev -- --no-open` avoids opening a browser. `--no-studio` runs headless. Use `npm run studio` to attach separately. Runtime defaults to `http://127.0.0.1:8787`; `PORT` changes it. Studio chooses a free port starting at 4161.
11
+ `npm run dev -- --no-open` avoids opening a browser. `--no-studio` runs headless. `--no-autostart` fails instead of starting a Runtime, which is what CI wants. Use `npm run studio` to attach separately. Runtime defaults to `http://127.0.0.1:8787`; `--port` or `PORT` changes it. Studio chooses a free port starting at 4161.
13
12
 
14
13
  ```sh
15
14
  npm run build
16
15
  npm start
17
16
  ```
18
17
 
19
- Compiled start runs Runtime and executor without Studio or watching. Studio can attach in a separate terminal. `agents/index.ts` exports the registry; there is no Hono app to maintain. Source edits restart the local development stack. Start a new session after changing definitions or implementations; active-session upgrades are not supported.
18
+ `npm start` runs `nylorun serve`, which attaches the compiled build without Studio or watching, starting the Runtime first if none is up. Studio can attach in a separate terminal. `agents/index.ts` exports the registry; there is no Hono app to maintain. A source edit re-registers agents and reconnects executors; the Runtime process is untouched. Start a new session after changing definitions or implementations; active-session upgrades are not supported.
20
19
 
21
- Local credentials and SQLite live in gitignored `.nylorun/`. Keep this directory private. Credentials are generated automatically and kept out of browser configuration. Ordinary shutdown/restart preserves completed session history. `NYLORUN_IMPLEMENTATION_VERSION` defaults to `dev`; assign an explicit version when changing a versioned implementation.
20
+ Local Runtime credentials, the model provider vault, SQLite, and the Runtime log live in gitignored `.nylorun/` beside this project. Each project gets its own Runtime; `nylorun up --global` shares one in `~/.nylorun` instead. Keep this directory private. Server and executor credentials are generated automatically. The model provider key is encrypted in the vault and kept out of browser configuration and `.env`. Ordinary shutdown/restart preserves completed session history. `NYLORUN_IMPLEMENTATION_VERSION` defaults to `dev`; assign an explicit version when changing a versioned implementation.
22
21
 
23
22
  This beta supports local text and ordinary tools. Advanced waits, media, MCP, subagents, deployment, reconciliation and broad recovery guarantees are deferred. `NYLORUN_DEV_MODEL=fixture` is a credential-free release-check fixture for this starter; it is not a general model.
@@ -7,11 +7,10 @@
7
7
  "node": ">=24.0.0"
8
8
  },
9
9
  "scripts": {
10
- "configure": "nylorun configure",
11
10
  "dev": "nylorun dev",
12
- "studio": "nylorun studio --runtime-url http://127.0.0.1:8787",
11
+ "studio": "nylorun studio",
13
12
  "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",
14
- "start": "nylorun start",
13
+ "start": "nylorun serve",
15
14
  "check": "tsc --noEmit"
16
15
  },
17
16
  "dependencies": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nylorun/create-agent",
3
- "version": "0.7.1-beta",
3
+ "version": "0.8.0-beta",
4
4
  "description": "Create a local Nylorun Harness agent project.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",