@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 +14 -0
- package/README.md +2 -3
- package/compatibility.json +6 -6
- package/dist/arguments.d.ts +1 -1
- package/dist/arguments.js +2 -3
- package/dist/compatibility.json +6 -6
- package/dist/contracts.d.ts +0 -1
- package/dist/project.js +1 -13
- package/dist/starter/.env.example +2 -1
- package/dist/starter/README.md +5 -6
- package/dist/starter/package.json +2 -3
- package/package.json +1 -1
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
|
|
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.
|
|
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
|
|
package/compatibility.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
|
-
"harness": "0.
|
|
3
|
-
"studio": "0.
|
|
4
|
-
"runtime": "0.
|
|
5
|
-
"agents": "0.
|
|
6
|
-
"core": "0.
|
|
7
|
-
"cli": "0.
|
|
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
|
}
|
package/dist/arguments.d.ts
CHANGED
|
@@ -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] [--
|
|
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] [--
|
|
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", "--
|
|
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
|
}
|
package/dist/compatibility.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
|
-
"harness": "0.
|
|
3
|
-
"studio": "0.
|
|
4
|
-
"runtime": "0.
|
|
5
|
-
"agents": "0.
|
|
6
|
-
"core": "0.
|
|
7
|
-
"cli": "0.
|
|
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
|
}
|
package/dist/contracts.d.ts
CHANGED
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
|
-
|
|
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
|
-
#
|
|
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=...
|
package/dist/starter/README.md
CHANGED
|
@@ -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/`.
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
13
|
+
"start": "nylorun serve",
|
|
15
14
|
"check": "tsc --noEmit"
|
|
16
15
|
},
|
|
17
16
|
"dependencies": {
|