@nylorun/agents 0.11.0-beta → 0.12.0-beta

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @nylorun/agents
 
+## 0.12.0-beta
+
+### Minor Changes
+
+- 4b9906f: **Breaking: "Tenant" replaces "stack", and `nylorun start` works anywhere.** Each local installation holds one Tenant, and its name is the Tenant's name, so help, output, errors and docs say Tenant. See MIGRATION.md.
+
+  - **Breaking (`nylorun`): selection.** Every command acts on the Tenant `--tenant <name>` names (replaces `--name`, which is removed), else `NYLORUN_TENANT` (replaces `NYLORUN_STACK`), else the Project link's `tenant`; `start` in a project names a new one after the project directory. Outside a project, or with `start --no-link`, commands act on the Tenant `default`. In a project without a link, commands other than `start` exit 2 and list the machine's Tenants. A name starting with `tn_` (a Tenant id) is refused.
+  - **Breaking (`nylorun`): files.** Host roots are under `~/.nylorun/tenants/<name>/` (was `~/.nylorun/stacks/<name>/`) with `tenant.json` (was `stack.json`); the `.env` key is `NYLORUN_TENANT_NAME` (was `NYLORUN_STACK_NAME`); `NYLORUN_COMPOSE_PROJECT` replaces `NYLORUN_STACK_PROJECT`. Compose projects stay `nylorun-<name>`. Every command first moves 0.4 Host roots from `~/.nylorun/stacks/` to `~/.nylorun/tenants/` (renaming `stack.json` and the `.env` key), so they keep their volumes and keys. `nylorun ls` lists only directories with `tenant.json`.
+  - **Breaking (`nylorun`): removed.** `nylorun legacy` and all handling of the single stack of releases before 0.4; the hidden `nylorun stack <cmd>` alias; `nylorun doctor stack|runtime`. Output says Tenant: `ls` prints `TENANT` and JSON `{ "tenants": [...] }`, `status` prints the Tenant id on its own line, and `doctor`'s row is `tenant`.
+  - **Breaking: Project link format 3.** `.nylorun/link.json` is `{ "format": 3, "tenant", "tenantId", "hostUrl", "hostId" }`; `tenant` replaces `stack`. `@nylorun/agents`, `@nylorun/cli` and `@nylorun/admin` refuse an older link and name `npx nylorun start`, which rewrites it. `@nylorun/core`'s `ProjectLinkFileSchema` parses formats 0–3 with `tenant`.
+  - **Breaking (`@nylorun/admin`):** `createAdmin({ tenant })` replaces `{ stack }`, `tenantHostRoot(name)` replaces `stackHostRoot(name)`, and local resolution reads `NYLORUN_TENANT` and the link's `tenant`.
+  - `@nylorun/cli`: `status` and `endpoints` drop the `stack` line and JSON key; messages say Tenant. `@nylorun/agents`: a Runtime too old for the client says "update the Runtime (npx nylorun@latest start)". `@nylorun/studio`: setup hints say Tenant. `@nylorun/create-agent`: the next steps describe `npx nylorun@beta start` as this project's Tenant and its link.
+
+### Patch Changes
+
+- Pin core to the tested release.
+- Updated dependencies [4b9906f]
+  - @nylorun/core@0.11.0-beta
+
 ## 0.11.0-beta
 
 ### Major Changes

package/README.md

@@ -30,7 +30,7 @@ reads the Tenant's public keys. Mark a long tool
 posts the result. `npx @nylorun/cli endpoints` shows each endpoint and how its
 deliveries are doing.
 
-The URL must be one the Runtime can reach: `localhost` on the local stack
+The URL must be one the Runtime can reach: `localhost` on a local Tenant
 (its Runtime runs in Docker and maps `localhost` to this machine), a public URL
 in production, or a tunnel (ngrok, Cloudflare Tunnel) for a remote Runtime.
 
@@ -49,13 +49,14 @@ for upgrading from `nylorun serve`.
 2. Environment — if `NYLORUN_RUNTIME_URL` or `NYLORUN_SERVER_KEY` is set, both
    must be present
 3. Project link — `.nylorun/link.json` + `credentials.json` (the application
-   key), written by `npx nylorun start`. A link from before one Tenant per
-   installation (format 0 or 1) fails with `connection_missing`: run
-   `npx nylorun start` in the project again.
+   key), written by `npx nylorun start`. A link from an older nylorun
+   (format 0 to 2) fails with `connection_missing`: run `npx nylorun start` in
+   the project again.
 
 Sources never mix. Partial environment fails with `connection_missing`. A
-Runtime serves one Tenant, so nothing names it: the `tenant` option and
-`NYLORUN_TENANT` are gone (protocol 5).
+Runtime serves one Tenant, so nothing names it: the `tenant` option is gone
+(protocol 5), and `NYLORUN_TENANT`, which picks a local Tenant for `nylorun`,
+is ignored.
 
 ```ts
 import { Agent, createActionHandler, createClient, tool } from "@nylorun/agents";

package/dist/a2a/handler.js

@@ -45,7 +45,7 @@ export function createA2aHandler(options) {
             const client = await (options.client ?? createClient());
             const features = await client.hostFeatures();
             if (!features.includes(REQUIRED_FEATURE))
-                throw new Problem(502, `The Runtime does not support ${REQUIRED_FEATURE}; upgrade the stack (nylorun up).`, "runtime_feature_missing");
+                throw new Problem(502, `The Runtime does not support ${REQUIRED_FEATURE}; update the Runtime (npx nylorun@latest start).`, "runtime_feature_missing");
             return client;
         })();
         ready.catch(() => {

package/dist/ag-ui/handler.js

@@ -65,7 +65,7 @@ export function createAgUiHandler(options) {
             const features = await client.hostFeatures();
             const missing = REQUIRED_FEATURES.filter((f) => !features.includes(f));
             if (missing.length > 0)
-                throw new Problem(502, `The Runtime does not support ${missing.join(", ")}; upgrade the stack (nylorun up).`, "runtime_feature_missing");
+                throw new Problem(502, `The Runtime does not support ${missing.join(", ")}; update the Runtime (npx nylorun@latest start).`, "runtime_feature_missing");
             return client;
         })();
         ready.catch(() => {

package/dist/connection.js

@@ -11,7 +11,7 @@ export class ConnectionError extends Error {
 }
 function missing(tried) {
     throw new ConnectionError(`connection_missing: no Runtime connection found (tried ${tried.join(", ")}). ` +
-        `Run "npx nylorun start" in this project to start its stack and link it, ` +
+        `Run "npx nylorun start" in this project to start its Tenant and link it, ` +
         `or set NYLORUN_RUNTIME_URL and NYLORUN_SERVER_KEY.`);
 }
 function stripTrailingSlash(url) {
@@ -37,11 +37,10 @@ async function readProjectLink(startDir) {
             throw error;
         }
         const link = ProjectLinkFileSchema.parse(JSON.parse(linkRaw));
-        // Formats 0 and 1 named a Tenant on a multi-Tenant Host of an older Runtime.
-        if (link.format < 2)
-            throw new ConnectionError(`connection_missing: the Project link at ${linkPath} is for a stack of an older ` +
-                `Runtime, before one Tenant per installation. Run "npx nylorun start" in this project ` +
-                `to start its own stack and link it again.`);
+        // Formats 0 to 2 are from older releases.
+        if (link.format < 3)
+            throw new ConnectionError(`connection_missing: the Project link at ${linkPath} is from an older nylorun. ` +
+                `Run "npx nylorun start" in this project to link it again.`);
         const credentials = ProjectCredentialsFileSchema.parse(JSON.parse(await readFile(join(nylorun, "credentials.json"), "utf8")));
         return {
             url: stripTrailingSlash(link.hostUrl),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nylorun/agents",
-  "version": "0.11.0-beta",
+  "version": "0.12.0-beta",
   "description": "Nylorun agent definitions, session client and Action endpoint",
   "type": "module",
   "license": "Apache-2.0",
@@ -47,7 +47,7 @@
     "test": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@nylorun/core": "0.10.0-beta",
+    "@nylorun/core": "0.11.0-beta",
     "gray-matter": "^4.0.3"
   },
   "peerDependencies": {