@zenera/cli 1.1.37 → 1.1.40

package/dist/commands/index.js

@@ -56,19 +56,18 @@ export const ALIASES = {
     mem: 'memory',
     edit: 'open',
     code: 'open',
-    mock: 'faker',
     pack: 'export',
     archive: 'export',
     unpack: 'import',
     share: 'export',
 };
 export const EXTERNAL = {
-    faker: {
-        package: '@zenera/faker',
-        summary: 'A mock API from an openapi/swagger document.',
-        usage: 'zen faker <serve|build|cache> [spec...]',
-        install: 'npm i -g @zenera/faker',
-        banner: { head: 'Zenera', accent: 'Faker', subtitle: 'Mock API Server', hue: 'mint' },
+    gym: {
+        package: '@zenera/gym',
+        summary: 'Simulated API environments for agent training and evaluation.',
+        usage: 'zen gym <serve|build|cache|model> [spec...]',
+        install: 'npm i -g @zenera/gym',
+        banner: { head: 'Zenera', accent: 'Gym', subtitle: 'Agent Environments', hue: 'mint' },
     },
     rag: {
         package: '@zenera/rag',

package/dist/commands/sandbox.js

@@ -136,7 +136,7 @@ async function status(project, image, asJson) {
     const found = await podmanStatus({ image });
     const all = found.ready ? await ownedContainers(found.engine) : [];
     // A container belongs to a session, and a session belongs to a project, so
-    // a report about one project must not list another's — or the faker's,
+    // a report about one project must not list another's — or the gym's,
     // which wears the same label and belongs to no project at all.
     const containers = project ? ofProject(project.dir, all) : all;
     const idle = all.length > 0 ? idleContainers(all, await sessionOwners()) : [];
@@ -507,18 +507,18 @@ function projectRows(projects, loose) {
         ]);
     }
     if (loose.length > 0) {
-        // Containers whose session directory is gone, and faker's, which are
+        // Containers whose session directory is gone, and gym's, which are
         // labelled the same way and belong to no project at all.
         const size = loose.reduce((n, c) => n + (c.size ?? 0), 0);
-        const fakers = loose.filter((c) => c.key?.startsWith('faker-')).length;
+        const gyms = loose.filter((c) => c.key?.startsWith('gym-')).length;
         rows.push([
             dim('(unclaimed)'),
             dim('—'),
             dim('—'),
             dim(String(loose.length)),
             dim(bytes(size)),
-            dim(fakers === loose.length
-                ? `zen faker ${fakers === 1 ? 'server' : 'servers'}, no project`
+            dim(gyms === loose.length
+                ? `zen gym ${gyms === 1 ? 'server' : 'servers'}, no project`
                 : 'no session owns these'),
         ]);
     }

package/dist/external.js

@@ -11,7 +11,7 @@ import { CliError, EXIT, bold } from "./term.js";
 // Loading a command out of a sibling package
 //
 // The specifier is built rather than written, and that is the whole mechanism:
-// a literal `import('@zenera/faker/command')` would make the sibling a
+// a literal `import('@zenera/gym/command')` would make the sibling a
 // compile-time dependency of `zen` — a project reference, a package.json entry,
 // and a cycle, since the sibling already depends on `zen`. Built, it is
 // resolved by Node at the moment the user asks for it and by nobody before.

package/dist/podman.js

@@ -485,9 +485,9 @@ export function idleContainers(containers, owners) {
         if (c.state !== 'running') {
             return true;
         }
-        const faker = /^faker-(\d+)$/.exec(c.key ?? '');
-        if (faker) {
-            return !pidAlive(Number(faker[1]));
+        const gym = /^gym-(\d+)$/.exec(c.key ?? '');
+        if (gym) {
+            return !pidAlive(Number(gym[1]));
         }
         const dir = c.key === undefined ? undefined : owners.get(c.key);
         return dir !== undefined && !isBusy(dir);

package/dist/resources.d.ts

@@ -91,7 +91,7 @@ export interface MachineView {
 export interface ContainerView {
     name: string;
     id: string;
-    kind: 'zen' | 'faker' | 'other';
+    kind: 'zen' | 'gym' | 'other';
     project?: string;
     orphaned: boolean;
     /** percent of one core */
@@ -128,7 +128,7 @@ export interface ResourceView {
     totals: {
         running: number;
         zen: number;
-        faker: number;
+        gym: number;
         other: number;
         orphaned: number;
         memory: number;

package/dist/resources.js

@@ -352,7 +352,7 @@ export function viewOf(now, before) {
         const prior = before?.stats.find((p) => p.id === s.id);
         const span = prior ? s.systemNano - prior.systemNano : 0;
         const measured = prior !== undefined && span > 0;
-        const kind = !own ? 'other' : own.key?.startsWith('faker-') ? 'faker' : 'zen';
+        const kind = !own ? 'other' : own.key?.startsWith('gym-') ? 'gym' : 'zen';
         return {
             name: s.name,
             id: s.id,
@@ -393,7 +393,7 @@ export function viewOf(now, before) {
         totals: {
             running: containers.length,
             zen: containers.filter((c) => c.kind === 'zen').length,
-            faker: containers.filter((c) => c.kind === 'faker').length,
+            gym: containers.filter((c) => c.kind === 'gym').length,
             other: containers.filter((c) => c.kind === 'other').length,
             orphaned: containers.filter((c) => c.orphaned).length,
             memory: containers.reduce((n, c) => n + c.memory, 0),
@@ -684,7 +684,7 @@ function containerHead(l, v, o) {
     const t = v.totals;
     const kinds = [
         t.zen ? `${t.zen} zen` : '',
-        t.faker ? `${t.faker} faker` : '',
+        t.gym ? `${t.gym} gym` : '',
         t.other ? `${t.other} other` : '',
     ]
         .filter(Boolean)
@@ -700,7 +700,7 @@ function containerHead(l, v, o) {
             .filter(Boolean)
             .join(' · '));
     l.intro('Running ones only: a stopped container keeps its files but uses no memory or cpu. ' +
-        'zen makes one per session; zen faker servers and anything else in podman are listed too.');
+        'zen makes one per session; zen gym servers and anything else in podman are listed too.');
     if (t.running === 0) {
         return;
     }
@@ -796,7 +796,7 @@ const COLUMNS = [
         width: 14,
         align: 'left',
         keep: 5,
-        cell: (c) => [sp(clipTo(c.project ?? (c.kind === 'faker' ? '(faker)' : '—'), 14))],
+        cell: (c) => [sp(clipTo(c.project ?? (c.kind === 'gym' ? '(gym)' : '—'), 14))],
     },
 ];
 /** The columns that fit, in order, dropping the least needed until the name has room. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zenera/cli",
-    "version": "1.1.37",
+    "version": "1.1.40",
     "description": "Command-line front end for @zenera/neo: agentic projects you can run, share and commit.",
     "keywords": [
         "agents",
@@ -15,13 +15,13 @@
         "access": "public"
     },
     "author": "Andrey Ryabov",
-    "homepage": "https://github.com/andreyryabov/ZeneraNeo#readme",
+    "homepage": "https://github.com/zenera-ai/ZeneraNeo#readme",
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/andreyryabov/ZeneraNeo.git",
+        "url": "git+https://github.com/zenera-ai/ZeneraNeo.git",
         "directory": "packages/cli"
     },
-    "bugs": "https://github.com/andreyryabov/ZeneraNeo/issues",
+    "bugs": "https://github.com/zenera-ai/ZeneraNeo/issues",
     "type": "module",
     "bin": {
         "zen": "./dist/main.js",
@@ -54,9 +54,9 @@
         "@google/genai": "^2.30.0",
         "@inkjs/ui": "^2.0.0",
         "@openrouter/sdk": "^1.4.25",
-        "@zenera/engine": "^1.1.37",
-        "@zenera/neo": "^1.1.37",
-        "@zenera/view": "^1.1.37",
+        "@zenera/engine": "^1.1.40",
+        "@zenera/neo": "^1.1.40",
+        "@zenera/view": "^1.1.40",
         "google-auth-library": "^10.0.0",
         "ink": "^7.1.1",
         "openai": "^6.0.0",

package/templates/editor/.github/skills/zen-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: zen-cli
-description: How to drive this project from the terminal with `zen` - running it, validating it, credentials, the sandbox, run reports, and the `faker` and `rag` modules.
+description: How to drive this project from the terminal with `zen` - running it, validating it, credentials, the sandbox, run reports, and the `gym` and `rag` modules.
 ---
 
 # The `zen` command line
@@ -33,7 +33,7 @@ zen version
 
 zen meta     <run|prompts|resume|model|dataset> [project] [args]
 
-zen faker    <serve|build|cache> [spec...]
+zen gym      <serve|build|cache|model> [spec...]
 zen rag      schema <index|restore|ready|search|list|grep|trace|show|stats> [spec...]
 zen rag      docs <index|restore|ready|search|list|grep|show|stats> [path...]
 ```
@@ -61,7 +61,7 @@ guess a flag, and do not read them all.
 | The evaluation dataset: cases, drift, notes, drawing a sample       | [dataset.md](./references/dataset.md) (and `zen-dataset` skill) |
 | Tuning the prose on the dataset: workers, applies, STATUS.md        | [finetune.md](./references/finetune.md)                         |
 | Sharing a project: archives, what travels, importing one safely     | [export.md](./references/export.md)                             |
-| `zen faker` - a mock API from an OpenAPI/Swagger document           | [faker.md](./references/faker.md)                               |
+| `zen gym` - a mock API from an OpenAPI/Swagger document             | [gym.md](./references/gym.md)                                   |
 | `zen rag` - searching an API description, or a pile of markdown     | [rag.md](./references/rag.md)                                   |
 
 ## The short version

package/templates/editor/.github/skills/zen-cli/references/frame.md

@@ -37,7 +37,7 @@ Not listed in help, but they work.
 | `validate`, `doctor` | `check`   |
 | `report`             | `inspect` |
 | `edit`, `code`       | `open`    |
-| `mock`               | `faker`   |
+| `mock`               | `gym`     |
 
 ## stdout is the answer, stderr is the narration
 
@@ -103,7 +103,7 @@ A real environment variable always beats the keyring.
     projects.json         the registry: name -> directory
     keys.json             credentials (0600)
     keys/                 key files, for providers that hold a file
-    faker/                generator cache for `zen faker`
+    gym/                generator cache for `zen gym`
 
 <project>/
     zenera.json           { version, name }

package/templates/editor/.github/skills/zen-cli/references/{faker.md → gym.md}

@@ -1,11 +1,11 @@
-# Mock APIs - `zen faker`
+# Agent API environments - `zen gym`
 
 ```
-zen faker <serve|build|cache> [spec...]
+zen gym <serve|build|cache|model> [spec...]
 ```
 
-Alias: `zen mock`. Provided by `@zenera/faker` - `npm i -g @zenera/faker` if
-`zen faker` says it is not installed.
+Provided by `@zenera/gym` - `npm i -g @zenera/gym` if
+`zen gym` says it is not installed.
 
 Serves a mock API from one or more OpenAPI/Swagger documents. For each
 operation a **model writes a Python generator**, which is self-tested inside a
@@ -14,17 +14,18 @@ plausible, not `"string"` repeated.
 
 ## Subcommands
 
-| Command           | What it does                                          |
-| ----------------- | ----------------------------------------------------- |
-| `serve <spec...>` | Serve the documents. Generators are written on demand |
-| `build <spec...>` | Write every generator now and exit                    |
-| `cache ls\|clear` | What has been generated, or throw it away             |
+| Command           | What it does                                               |
+| ----------------- | ---------------------------------------------------------- |
+| `serve <spec...>` | Serve the documents. Generators are written on demand      |
+| `build <spec...>` | Write every generator now and exit                         |
+| `cache ls\|clear` | What has been generated, or throw it away                  |
+| `model [ref]`     | Show or set the model; `--clear` forgets the stored choice |
 
 ```
-zen faker serve openapi.yaml
-zen faker serve api/*.yaml --port 9000 --seed 7
-zen faker build openapi.yaml --concurrency 8
-zen faker cache clear
+zen gym serve openapi.yaml
+zen gym serve api/*.yaml --port 9000 --seed 7
+zen gym build openapi.yaml --concurrency 8
+zen gym cache clear
 ```
 
 `build` is the one to run in CI or before a demo: it pays for every generator up
@@ -32,23 +33,25 @@ front and exits non-zero, with a table, if any could not be written.
 
 ## Options
 
-| Flag                | Default               | Meaning                                         |
-| ------------------- | --------------------- | ----------------------------------------------- |
-| `--port <n>`        | `8787`                | Port to listen on                               |
-| `--host <h>`        | `127.0.0.1`           | Anything else is reachable off-machine          |
-| `--model <ref>`     | project default       | Which model writes the generators               |
-| `--image <ref>`     | a baked image         | Skip the baked image and use this one           |
-| `--cache <dir>`     | `~/.zenera/neo/faker` | Where generators live                           |
-| `--seed <n>`        | -                     | Answer the same request the same way every time |
-| `--attempts <n>`    | `3`                   | Tries per generator before giving up            |
-| `--concurrency <n>` | `4`                   | Generators written at once                      |
-| `--timeout <s>`     | `30`                  | Seconds one generator may take                  |
-| `--max-body <n>`    | 1 MB                  | Largest request body accepted, in bytes         |
-| `--rebuild`         | -                     | Ignore what is cached and write it again        |
-| `--no-cache`        | -                     | Do not record what is written                   |
-| `--quiet`           | -                     | No narration                                    |
+| Flag                | Default             | Meaning                                         |
+| ------------------- | ------------------- | ----------------------------------------------- |
+| `--port <n>`        | `8787`              | Port to listen on                               |
+| `--host <h>`        | `127.0.0.1`         | Anything else is reachable off-machine          |
+| `--model <ref>`     | project default     | Which model writes the generators               |
+| `--image <ref>`     | a baked image       | Skip the baked image and use this one           |
+| `--cache <dir>`     | `~/.zenera/neo/gym` | Where generators live                           |
+| `--seed <n>`        | -                   | Answer the same request the same way every time |
+| `--attempts <n>`    | `3`                 | Tries per generator before giving up            |
+| `--concurrency <n>` | `4`                 | Generators written at once                      |
+| `--timeout <s>`     | `30`                | Seconds one generator may take                  |
+| `--max-body <n>`    | 1 MB                | Largest request body accepted, in bytes         |
+| `--rebuild`         | -                   | Ignore what is cached and write it again        |
+| `--no-cache`        | -                   | Do not record what is written                   |
+| `--quiet`           | -                   | No narration                                    |
 
 Credentials come from the `zen` keyring - see [keys.md](keys.md).
+Model selection: `--model`, `ZENERA_GYM_MODEL`, `~/.zenera/neo/gym.json`,
+then the best model the available keys support.
 
 ## Serving
 
@@ -56,17 +59,19 @@ Binds the loopback address by default. On start it prints a table per document:
 paths, methods, and how many operations have a response schema and therefore get
 a generator.
 
-| Endpoint          | Answers                   |
-| ----------------- | ------------------------- |
-| `/__faker/routes` | Every route it will serve |
-| `/__faker/health` | Whether it is up          |
+| Endpoint        | Answers                   |
+| --------------- | ------------------------- |
+| `/__gym/routes` | Every route it will serve |
+| `/__gym/health` | Whether it is up          |
 
 Response headers:
 
-| Header              | Meaning                                               |
-| ------------------- | ----------------------------------------------------- |
-| `x-faker-operation` | The `operationId` that answered                       |
-| `x-faker-cache`     | `hit` or `miss` - whether this call cost a model turn |
+| Header            | Meaning                                               |
+| ----------------- | ----------------------------------------------------- |
+| `x-gym-operation` | The `operationId` that answered                       |
+| `x-gym-cache`     | `hit` or `miss` - whether this call cost a model turn |
+
+Gym provides simulation, not task scoring, rewards, or a training loop.
 
 Incoming headers are filtered: `authorization`, `cookie` and anything matching
 `key|token|secret|password|credential` never reach a generator.
@@ -91,7 +96,7 @@ Probes are synthetic on purpose - real request bodies never reach a prompt.
 
 ## The cache
 
-Generators live in the machine's shared cache, `~/.zenera/neo/cache/faker-generator/`,
+Generators live in the machine's shared cache, `~/.zenera/neo/cache/gym-generator/`,
 keyed by the operation's shape - so the same spec served from two directories is
 written once, and a spec edit produces a new key rather than a stale answer. A
 generator that a model gave up on is remembered for the life of the process, so
@@ -99,17 +104,17 @@ a hopeless operation is not re-asked on every request; a _transient_ failure - a
 429, a dropped socket - is not, because it is about this minute rather than this
 operation.
 
-`~/.zenera/neo/faker/` is the container's workspace, and scratch: a cache hit is
+`~/.zenera/neo/gym/` is the container's workspace, and scratch: a cache hit is
 copied into it, because the container can only run what is under its mount.
 
-`zen faker cache ls` lists what has been generated. `zen faker cache clear`
+`zen gym cache ls` lists what has been generated. `zen gym cache clear`
 removes the generators, the workspace and the container together. They have to
 go together: the container's name is a hash of its configuration, so deleting
 the workspace alone would leave a stopped container bind-mounted onto a
 directory that no longer exists, and every generator would fail with
 `python3: can't open file '/workspace/generators/…/gen.py'`.
 
-`zen cache ls --kind faker-generator` reaches the same entries from the other
+`zen cache ls --kind gym-generator` reaches the same entries from the other
 side, along with everything else this machine has cached.
 
 ## Documents it accepts

package/templates/editor/.github/skills/zen-cli/references/keys.md

@@ -77,7 +77,7 @@ turns gateway mode on without the keyring - and `zen key mode`/`ls`/`check`
 report and probe it (`bifrost/$BIFROST_API_KEY`), with nothing stored. In this
 mode `zen models` lists only
 what the gateway serves - see `models.md`. The full guide is
-[docs/gateway.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/gateway.md).
+[docs/gateway.md](https://github.com/zenera-ai/ZeneraNeo/blob/main/docs/gateway.md).
 
 ### Vertex takes either shape
 
@@ -141,6 +141,6 @@ The frame does **not** materialise the keyring for you - each command that needs
 a credential opens the store itself. If `zen key ls` shows a key as live and a
 command still says `provider "openai": no api key - set OPENAI_API_KEY`, the
 credential is fine and the command is at fault. Everything that runs a model
-(`run`, `check`, `models`, `faker`, `rag`) already does this.
+(`run`, `check`, `models`, `gym`, `rag`) already does this.
 
 Exit code `4` means no usable credential for what was asked.

package/templates/editor/.github/skills/zen-cli/references/models.md

@@ -58,7 +58,7 @@ stderr with a `⇄ bifrost mode` line, `browse` carries the same badge on every
 screen, and `--json` adds a `gateway` field. `zen models` then does go to the
 network, since one request covers every provider; `test` asks through the
 gateway too. The full guide is
-[docs/gateway.md](https://github.com/andreyryabov/ZeneraNeo/blob/main/docs/gateway.md).
+[docs/gateway.md](https://github.com/zenera-ai/ZeneraNeo/blob/main/docs/gateway.md).
 
 ## Testing a model
 

package/templates/editor/.github/skills/zen-cli/references/rag.md

@@ -34,7 +34,7 @@ zen rag schema index <spec...> [--embedding <ref>] [-o <dir>] [--batch <n>]
 zen rag schema index openapi.yaml --embedding openai:text-embedding-3-small
 ```
 
-Unlike the faker, `$ref`s are **bundled, not dereferenced**: component names are
+Unlike the gym, `$ref`s are **bundled, not dereferenced**: component names are
 the node ids and the cycles between them are the edges. `discriminator` is kept -
 it is what turns a `oneOf` into a tagged union a compiler can narrow.
 

package/templates/editor/.vscode/agents.schema.json

@@ -1,6 +1,6 @@
 {
     "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "https://raw.githubusercontent.com/andreyryabov/ZeneraNeo/main/packages/cli/templates/editor/.vscode/agents.schema.json",
+    "$id": "https://raw.githubusercontent.com/zenera-ai/ZeneraNeo/main/packages/cli/templates/editor/.vscode/agents.schema.json",
     "title": "Zenera Neo agents.yaml",
     "description": "Who exists in this project, what they may reach for, and which model answers for them. Written by `zen init` and replaced by every `zen init` and `zen open`, so it describes the version of `zen` in hand. The runtime is the authority: `zen check` reads the project the way a run does.",
     "type": "object",