@nylorun/create-agent 0.14.7-beta → 0.15.1-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 +29 -0
- package/README.md +6 -7
- package/compatibility.json +5 -5
- package/dist/compatibility.json +5 -5
- package/dist/starter/README.md +15 -18
- package/dist/starter/environments/scratch.json +7 -0
- package/dist/starter/package.json +1 -1
- package/dist/starter/src/main.ts +12 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,34 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.15.1-beta
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 000ff75: **READMEs and help text match protocol 14.**
|
|
8
|
+
|
|
9
|
+
- `nylorun --help` lists `environments fork`, `manifests` and `delete-version`. The package description no longer offers `nylo` as the Runtime client, and the README says nylorun depends on `@nylorun/agents` too.
|
|
10
|
+
- The READMEs name the current commands: `nylorun tenant keys`, `nylorun tenant mcp inspect`, `nylorun local logs` and `nylorun local reset`. `@nylorun/admin` says it speaks protocol 14.
|
|
11
|
+
- `@nylorun/agents`: a lost MCP or HTTP tool call is sent again with its key, then fails to the model as `tool.interrupted` (it is not left `uncertain`). Every manifest is v7. A2A takes `raw` files. A delegated agent cannot pause.
|
|
12
|
+
- `@nylorun/runtime`: the README describes protocol 14, `PUT /v1/sessions/{id}` says it answers an identical session (vaults are no longer attached), and the database-layout error names `nylorun local reset`.
|
|
13
|
+
- `@nylorun/create-agent`: `nylorun start` writes the project's keys (no key is derived any more).
|
|
14
|
+
|
|
15
|
+
- Update the tested Harness, SDK, Admin and Runtime compatibility combination.
|
|
16
|
+
|
|
17
|
+
## 0.15.0-beta
|
|
18
|
+
|
|
19
|
+
### Minor Changes
|
|
20
|
+
|
|
21
|
+
- 9b07bdd: **Studio and the starter for environment manifests (protocol 14).**
|
|
22
|
+
|
|
23
|
+
- **Studio, Environments page:** lists the environment manifests (each one's latest version, its kind, how many Environments were made from it, and who saved it). It saves a new version from JSON, with Check showing the plan first, under `If-Match`, so a save over someone else's is refused. It also makes an Environment from a version. Studio is one more client: any credential that may write Environments can do the same from the CLI or the SDK.
|
|
24
|
+
- **Studio, Environment page:** shows the manifest version it was made from and whether a newer one exists ("Fork to vN"), the Environment it was forked from, its secret slots set or missing, and its pod's image digest. **Fork** opens the fork with its plan (disk, secrets copied and left behind, slots still missing, changes) before it makes the new Environment.
|
|
25
|
+
- **The starter** ships `environments/scratch.json` (a virtual workspace with no network). `src/main.ts` saves each manifest in `environments/` beside the agents.
|
|
26
|
+
- `@nylorun/agents` exports the manifest and fork contract types (`EnvironmentManifestView`, `EnvironmentManifestPlan`, `EnvironmentForkPlan`, …).
|
|
27
|
+
|
|
28
|
+
### Patch Changes
|
|
29
|
+
|
|
30
|
+
- Update the tested Harness, SDK, Admin and Runtime compatibility combination.
|
|
31
|
+
|
|
3
32
|
## 0.14.7-beta
|
|
4
33
|
|
|
5
34
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -39,15 +39,14 @@ npm start
|
|
|
39
39
|
|
|
40
40
|
`nylorun start` in the project creates and starts the project's own local
|
|
41
41
|
Tenant (Runtime, Studio and their infrastructure in Docker, named after the
|
|
42
|
-
directory; `--tenant` picks or shares another). It writes the Project link and the
|
|
42
|
+
directory; `--tenant` picks or shares another). It writes the Project link and the project's keys (an application and a management key) to
|
|
43
43
|
gitignored `.nylorun/`, and seeds the model provider from `.env`
|
|
44
44
|
(`MODEL_PROVIDER`, `MODEL`, `MODEL_PROVIDER_API_KEY`) into the Tenant vault.
|
|
45
|
-
`
|
|
46
|
-
|
|
47
|
-
`npx -p nylorun nylo configure` sets or replaces the provider.
|
|
45
|
+
`nylorun status` and `nylorun tenant reset` work on the linked Tenant. Studio or
|
|
46
|
+
`npx nylorun tenant models set` sets or replaces the provider.
|
|
48
47
|
`npm start` runs `node dist/src/main.js` with the same entry as development.
|
|
49
|
-
|
|
50
|
-
production start
|
|
48
|
+
Without a Project link, set `NYLORUN_RUNTIME_URL` and `NYLORUN_SERVER_KEY`
|
|
49
|
+
before a production start. Tenant data, including the
|
|
51
50
|
vault, lives in the Tenant's Docker volumes. Definitions have no model provider or
|
|
52
51
|
`agent.run()`.
|
|
53
52
|
|
|
@@ -63,7 +62,7 @@ remain outside that registry for later migration.
|
|
|
63
62
|
|
|
64
63
|
`npm run test:starter` (`cli/create-agent/scripts/smoke-starter.mjs`) packs the
|
|
65
64
|
workspace, scaffolds the starter from the packed creator, installs `nylorun`
|
|
66
|
-
(and the deprecated `@nylorun/cli`, which it checks
|
|
65
|
+
(and the deprecated `@nylorun/cli`, which it checks names the nylorun command that replaced `nylo`)
|
|
67
66
|
beside it (never into it), runs `nylorun start` in it and
|
|
68
67
|
`npm run dev` against a temporary local Tenant, then resets that Tenant,
|
|
69
68
|
seeds the fixture model and runs one turn with the starter's assistant.
|
package/compatibility.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
|
-
"harness": "0.
|
|
3
|
-
"runtime": "0.
|
|
4
|
-
"agents": "0.
|
|
5
|
-
"admin": "0.
|
|
6
|
-
"core": "0.
|
|
2
|
+
"harness": "0.27.1-beta",
|
|
3
|
+
"runtime": "0.26.0-beta",
|
|
4
|
+
"agents": "0.22.0-beta",
|
|
5
|
+
"admin": "0.17.1-beta",
|
|
6
|
+
"core": "0.22.0-beta"
|
|
7
7
|
}
|
package/dist/compatibility.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
|
-
"harness": "0.
|
|
3
|
-
"runtime": "0.
|
|
4
|
-
"agents": "0.
|
|
5
|
-
"admin": "0.
|
|
6
|
-
"core": "0.
|
|
2
|
+
"harness": "0.27.1-beta",
|
|
3
|
+
"runtime": "0.26.0-beta",
|
|
4
|
+
"agents": "0.22.0-beta",
|
|
5
|
+
"admin": "0.17.1-beta",
|
|
6
|
+
"core": "0.22.0-beta"
|
|
7
7
|
}
|
package/dist/starter/README.md
CHANGED
|
@@ -17,15 +17,16 @@ watching works.
|
|
|
17
17
|
Agent definitions live in `agents/`. The **Runtime** runs your agents and
|
|
18
18
|
holds their sessions in its **Tenant**, one per installation; this project
|
|
19
19
|
attaches to its own local Tenant through a **Project link**. `src/main.ts`
|
|
20
|
-
saves each agent in `agents/index.ts` to the Runtime (`client.saveAgent`) and
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
with
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
20
|
+
saves each agent in `agents/index.ts` to the Runtime (`client.saveAgent`), and
|
|
21
|
+
each environment manifest in `environments/` (`environments/scratch.json`, a
|
|
22
|
+
virtual workspace with no network), and exits; from then on the Runtime runs
|
|
23
|
+
them from what was saved. Make an Environment from a manifest with
|
|
24
|
+
`npx nylorun@beta environments put <id> --manifest scratch`; it keeps that
|
|
25
|
+
version for life, and `environments fork` moves it to a newer one. The project
|
|
26
|
+
depends only on `@nylorun/agents`; `nylorun` runs with `npx`. It sets up and
|
|
27
|
+
runs this project's local Tenant (Runtime and Studio), links the project to it,
|
|
28
|
+
and manages the Tenant: its status, reset and model provider
|
|
29
|
+
(`npx nylorun@beta <command>`).
|
|
29
30
|
|
|
30
31
|
```sh
|
|
31
32
|
npx nylorun@beta start # this project's Tenant and the link; the first run pulls the images
|
|
@@ -37,14 +38,14 @@ run (named after the directory, under `~/.nylorun/tenants/<name>/`) and just
|
|
|
37
38
|
starts it after that. It prints the Runtime and Studio URLs; `npx nylorun
|
|
38
39
|
studio` signs your browser in to Studio. The Tenant keeps running after you stop `npm run dev`, so sessions survive a source
|
|
39
40
|
change; `npx nylorun stop` stops it (volumes are kept), `npx nylorun status`
|
|
40
|
-
shows its health, and `npx nylorun logs runtime -f` its logs.
|
|
41
|
+
shows its health, and `npx nylorun local logs runtime -f` its logs.
|
|
41
42
|
|
|
42
43
|
The first `nylorun start` writes `.nylorun/link.json` and
|
|
43
44
|
`.nylorun/credentials.json`, and seeds the Tenant's model provider from
|
|
44
45
|
`MODEL_PROVIDER`, `MODEL` and `MODEL_PROVIDER_API_KEY` in `.env` (see
|
|
45
46
|
`.env.example`). The key is stored in the Tenant vault, never back in `.env`.
|
|
46
47
|
Without them, set the provider in Studio's Model provider screen, or with
|
|
47
|
-
`npx
|
|
48
|
+
`npx nylorun@beta tenant models set`. Model calls use the Tenant's provider and may
|
|
48
49
|
incur its usual charges.
|
|
49
50
|
|
|
50
51
|
`npm run dev` runs `src/main.ts` with `tsx watch`: it saves the agents to the
|
|
@@ -72,12 +73,8 @@ Runtime makes to a service of yours (see the comment in
|
|
|
72
73
|
tool. A code tool (`tool({ run })`) is refused when it is saved: the Runtime
|
|
73
74
|
runs agents from their manifests alone.
|
|
74
75
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
```sh
|
|
78
|
-
eval "$(npx -p nylorun@beta nylo env)"
|
|
79
|
-
# → NYLORUN_RUNTIME_URL, NYLORUN_SERVER_KEY
|
|
80
|
-
```
|
|
76
|
+
The SDK reads the Project link itself; set `NYLORUN_RUNTIME_URL` and
|
|
77
|
+
`NYLORUN_SERVER_KEY` only to run the app outside this project.
|
|
81
78
|
|
|
82
79
|
Project link and credentials live in gitignored `.nylorun/` beside this project.
|
|
83
80
|
The Tenant's Host root (`~/.nylorun/tenants/<name>/`, or `NYLORUN_HOME`) holds
|
|
@@ -88,7 +85,7 @@ links it to this project's Tenant instead.
|
|
|
88
85
|
Keep `.nylorun/` private. The application key is derived from the Tenant's
|
|
89
86
|
admin key when the project is linked. Ordinary
|
|
90
87
|
shutdown/restart preserves completed session history; `npx -p nylorun nylo
|
|
91
|
-
reset --all` empties the Tenant, and `npx nylorun reset` deletes all its data.
|
|
88
|
+
reset --all` empties the Tenant, and `npx nylorun local reset` deletes all its data.
|
|
92
89
|
`NYLORUN_IMPLEMENTATION_VERSION` (default `dev`) labels each saved
|
|
93
90
|
definition.
|
|
94
91
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
},
|
|
9
9
|
"scripts": {
|
|
10
10
|
"dev": "tsx watch --env-file-if-exists=.env src/main.ts",
|
|
11
|
-
"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",
|
|
11
|
+
"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') }); await cp('environments', 'dist/environments', { recursive: true }); })\" && tsc -p tsconfig.json",
|
|
12
12
|
"start": "node dist/src/main.js",
|
|
13
13
|
"check": "tsc --noEmit"
|
|
14
14
|
},
|
package/dist/starter/src/main.ts
CHANGED
|
@@ -1,11 +1,20 @@
|
|
|
1
|
+
import { readdir, readFile } from "node:fs/promises";
|
|
1
2
|
import { createClient } from "@nylorun/agents";
|
|
2
3
|
import { agents } from "../agents/index.js";
|
|
3
4
|
|
|
4
|
-
// Saves each agent's definition to the Runtime, which runs
|
|
5
|
-
// The client finds the Runtime through the Project link, or
|
|
6
|
-
// NYLORUN_SERVER_KEY.
|
|
5
|
+
// Saves each agent's definition and each environment manifest to the Runtime, which runs them;
|
|
6
|
+
// nothing here keeps running. The client finds the Runtime through the Project link, or
|
|
7
|
+
// NYLORUN_RUNTIME_URL and NYLORUN_SERVER_KEY.
|
|
7
8
|
const client = await createClient();
|
|
8
9
|
for (const agent of agents) {
|
|
9
10
|
await client.saveAgent(agent);
|
|
10
11
|
console.log(`Saved agent ${agent.id}`);
|
|
11
12
|
}
|
|
13
|
+
// An Environment is made from one version of a manifest and never changes; a new version
|
|
14
|
+
// reaches it through a fork.
|
|
15
|
+
const environments = new URL("../environments/", import.meta.url);
|
|
16
|
+
for (const file of (await readdir(environments)).filter((name) => name.endsWith(".json"))) {
|
|
17
|
+
const manifest = JSON.parse(await readFile(new URL(file, environments), "utf8"));
|
|
18
|
+
const { manifest: saved, unchanged } = await client.environments.manifests.save(manifest);
|
|
19
|
+
console.log(`${unchanged ? "Unchanged" : "Saved"} environment manifest ${saved.name} v${saved.version}`);
|
|
20
|
+
}
|