@zenera/cli 1.1.36 → 1.1.39

package/dist/archive.js

@@ -1,10 +1,10 @@
+import { ENV_FILE } from '@zenera/engine';
 import { createWriteStream, lstatSync, mkdirSync, readdirSync, statSync } from 'node:fs';
 import { mkdir } from 'node:fs/promises';
 import { dirname, join, relative, resolve, sep } from 'node:path';
 import { pipeline } from 'node:stream/promises';
 import * as yauzl from 'yauzl';
 import * as yazl from 'yazl';
-import { ENV_FILE } from "./env.js";
 import { invalidError, usageError } from "./term.js";
 // ---------------------------------------------------------------------------
 // Archives

package/dist/batch.js

@@ -1,14 +1,13 @@
+import { display, stamp } from '@zenera/engine';
 import { addUsage, lockHolder, MANIFEST_FILE as MEMORY_MANIFEST, memoryDir, MemoryStore, mergeModelUsage, readProjectConfig, SANDBOX_GROUP, selectTools, usageByModel, zeroUsage, } from '@zenera/neo';
 import { existsSync } from 'node:fs';
 import { cp, mkdir, rm, writeFile } from 'node:fs/promises';
 import { basename, join, resolve } from 'node:path';
 import * as Engine from "./engine.js";
-import { stamp } from "./ids.js";
 import { duration } from "./narrate.js";
-import { BatchProgress } from "./progress.js";
 import { assertLocks } from "./podman.js";
+import { BatchProgress } from "./progress.js";
 import { project as resolveProject, target } from "./resolve.js";
-import { display } from "./session.js";
 import { CliError, count, cyan, dim, EXIT, invalidError, json, jsonText, note, usageError, write, } from "./term.js";
 import { appendUsage } from "./usage.js";
 import { availableTools } from "./validate.js";

package/dist/cache.js

@@ -1,7 +1,7 @@
+import { paths, writeJson } from '@zenera/engine';
 import { createHash } from 'node:crypto';
 import { readdirSync, readFileSync, rmdirSync, rmSync, statSync, utimesSync } from 'node:fs';
 import { join } from 'node:path';
-import { paths, writeJson } from "./home.js";
 // ---------------------------------------------------------------------------
 // One place for work already done
 //

package/dist/candidates.js

@@ -1,5 +1,5 @@
+import * as Projects from '@zenera/engine';
 import { existsSync } from 'node:fs';
-import * as Projects from "./projects.js";
 /** Candidates the word being typed is a prefix of. */
 export const matching = (found, prefix) => found.filter((c) => c.value.startsWith(prefix));
 /** Registered projects whose directory is still there. */

package/dist/catalog.d.ts

@@ -1,5 +1,5 @@
 import { type Gateway } from '@zenera/neo';
-import { type KeyCheck, type Provider } from './keys.ts';
+import { type KeyCheck, type Provider } from '@zenera/engine';
 /**
  * What a model is *for*. A model can hold more than one — Gemini's embedding
  * endpoint and its chat endpoint are the same catalog row on some providers —

package/dist/catalog.js

@@ -17,8 +17,8 @@
 // the vendor's own word.
 // ---------------------------------------------------------------------------
 import { GATEWAY_KEY_HEADER, GATEWAY_NAME, GATEWAY_UPSTREAMS, gatewayOf, ModelRegistry, vertexEndpoint, } from '@zenera/neo';
+import { PROVIDERS } from '@zenera/engine';
 import { Cache, cacheKey } from "./cache.js";
-import { PROVIDERS } from "./keys.js";
 import { classify } from "./liveness.js";
 import { compareModels } from "./rank.js";
 /** A day. Model lists change on the scale of weeks; a stale row costs a retry. */

package/dist/commands/cache.js

@@ -1,6 +1,6 @@
+import { paths } from '@zenera/engine';
 import { parse } from "../args.js";
 import { clear, items, kinds, sweep } from "../cache.js";
-import { paths } from "../home.js";
 import { ago, bold, bytes, confirm, count, cyan, dim, green, isInteractive, json, note, table, usageError, writeAll, } from "../term.js";
 const USAGE = 'zen cache [ls|prune|clear] [options]';
 /** Enough to see what is in there; the rest is a number. */

package/dist/commands/check.js

@@ -1,10 +1,8 @@
+import { KeyStore, loadProjectEnv, Registry } from '@zenera/engine';
 import { existsSync, statSync } from 'node:fs';
 import { basename, dirname, resolve } from 'node:path';
 import { one, parse } from "../args.js";
-import { loadProjectEnv } from "../env.js";
-import { KeyStore } from "../keys.js";
 import { duration } from "../narrate.js";
-import { Registry } from "../projects.js";
 import { project as resolveProject } from "../resolve.js";
 import { refreshShared } from "../scaffold.js";
 import { bold, count, cyan, dim, green, invalidError, json, progress, red, table, usageError, write, writeAll, yellow, } from "../term.js";

package/dist/commands/export.js

@@ -1,11 +1,9 @@
+import { ENV_FILE, isBusy, Registry, sessionIds, sessionsDir, stamp } from '@zenera/engine';
 import { lockHolder, memoryDir, readProjectConfig } from '@zenera/neo';
 import { existsSync, readFileSync } from 'node:fs';
 import { isAbsolute, join, resolve } from 'node:path';
 import { ARCHIVE_FORMAT, collect, ENV_EXAMPLE, envExample, MANIFEST_FILE, safeName, writeArchive, } from "../archive.js";
 import { one, parse } from "../args.js";
-import { ENV_FILE } from "../env.js";
-import { stamp } from "../ids.js";
-import { isBusy, Registry, sessionIds, sessionsDir } from "../projects.js";
 import { project as resolveProject } from "../resolve.js";
 import { ownVersion } from "../scaffold.js";
 import { bold, count, cyan, dim, green, bytes as human, invalidError, json, note, progress, table, usageError, warn, writeAll, } from "../term.js";

package/dist/commands/import.js

@@ -1,9 +1,8 @@
+import { ENV_FILE, isProjectDir, Registry } from '@zenera/engine';
 import { existsSync, readdirSync } from 'node:fs';
 import { isAbsolute, join, resolve } from 'node:path';
 import { ENV_EXAMPLE, extractArchive, readManifest, safeName, } from "../archive.js";
 import { parse } from "../args.js";
-import { ENV_FILE } from "../env.js";
-import { isProjectDir, Registry } from "../projects.js";
 import { bold, count, cyan, dim, green, bytes as human, invalidError, json, note, progress, usageError, warn, } from "../term.js";
 const USAGE = 'zen import <file.zip> [dir] [--name <name>] [--force] [--no-register]';
 // ---------------------------------------------------------------------------

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/init.js

@@ -1,14 +1,11 @@
+import { ensureHome, envNames, isProjectDir, isProvider, keyId, KeyStore, PROVIDERS, Registry, resolveBuild, } from '@zenera/engine';
 import { readProjectConfig } from '@zenera/neo';
 import { existsSync, readdirSync } from 'node:fs';
 import { basename, resolve } from 'node:path';
 import { one, parse } from "../args.js";
 import { PREFERRED } from "../catalog.js";
-import { ensureHome } from "../home.js";
-import { resolveBuild } from "../image.js";
-import { envNames, isProvider, keyId, KeyStore, PROVIDERS } from "../keys.js";
 import { probeAll } from "../liveness.js";
 import { ensurePodmanReady } from "../podman.js";
-import { isProjectDir, Registry } from "../projects.js";
 import { scaffold } from "../scaffold.js";
 import { bold, cyan, dim, green, json, note, progress, usageError, write, yellow, } from "../term.js";
 const USAGE = 'zen init [dir] [--name <name>] [--model <ref>] [--force]';

package/dist/commands/inspect.d.ts

@@ -1,5 +1,5 @@
+import { type RunPaths, type SessionPaths } from '@zenera/engine';
 import type { Command } from '../command.ts';
-import { type RunPaths, type SessionPaths } from '../session.ts';
 import { type NodeDetail, type Trace, type TraceEntry } from '../trace.ts';
 interface Flags {
     project?: string;

package/dist/commands/inspect.js

@@ -1,3 +1,4 @@
+import { display, KeyStore, listRuns, listSessions, loadProjectEnv, newestRun, readRunMeta, requireSession, runPaths, runPathsAt, sessionIds, sessionPaths, } from '@zenera/engine';
 import { assertState, buildRunReport, FilePayloadStore, memoryDir, MemoryStore, PayloadResolver, projectRegistry, readProjectConfig, renderReportHtml, SANDBOX_MOUNT, text, } from '@zenera/neo';
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
@@ -6,11 +7,7 @@ import { join, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { parse } from "../args.js";
 import { buildDiagnostic, parseRecordedRequest, pickModel } from "../ask.js";
-import { loadProjectEnv } from "../env.js";
-import { KeyStore } from "../keys.js";
-import { sessionIds } from "../projects.js";
 import { project as resolveProject } from "../resolve.js";
-import { display, listRuns, listSessions, newestRun, readRunMeta, requireSession, runPaths, runPathsAt, sessionPaths, } from "../session.js";
 import { nodeDetail, parseNodeIds, traceIndex, traceMermaid, traceOf, } from "../trace.js";
 import { formatMarkdown } from "../tui/markdown.js";
 import { boxWidth } from "../tui/wrap.js";

package/dist/commands/key.js

@@ -1,8 +1,7 @@
+import { ambient, ambientId, assertNotEmpty, checkRegion, describe, ensureHome, envNames, envOf, formOf, GATEWAYS, isGateway, keyId, KeyStore, mask, MODES, OWNERS, parseRef, SHAPES, } from '@zenera/engine';
 import { GATEWAY_URL_ENV } from '@zenera/neo';
 import { existsSync } from 'node:fs';
 import { parse } from "../args.js";
-import { ensureHome } from "../home.js";
-import { ambient, ambientId, assertNotEmpty, checkRegion, describe, envNames, envOf, formOf, GATEWAYS, isGateway, keyId, KeyStore, mask, MODES, OWNERS, parseRef, SHAPES, } from "../keys.js";
 import { probe, probeAll } from "../liveness.js";
 import { ago, ask, askSecret, badge, bold, confirm, credentialError, cyan, dim, green, isInteractive, json, note, progress, readStdin, red, table, usageError, warn, write, writeAll, yellow, } from "../term.js";
 const USAGE = 'zen key <ls|add|use|mode|check|rm|show|env> [ref] [options]';

package/dist/commands/list.js

@@ -1,10 +1,9 @@
-import { join } from 'node:path';
-import { parse } from "../args.js";
+import { listSessions, openDir, readRunMeta, Registry, runIds, runPaths, sessionIds, sessionPaths, sessionsDir, 
 // Run ids are timestamps by construction, so the newest id *is* the last-run
 // time — no file has to be opened to learn it.
-import { stampInstant } from "../ids.js";
-import { openDir, Registry, runIds, sessionIds, sessionsDir, summarize, } from "../projects.js";
-import { listSessions, readRunMeta, runPaths, sessionPaths } from "../session.js";
+stampInstant, summarize, } from '@zenera/engine';
+import { join } from 'node:path';
+import { parse } from "../args.js";
 import { ago, bold, count, cyan, dim, json, note, red, table, usageError, write, writeAll, yellow, } from "../term.js";
 const USAGE = 'zen list [--sessions] [--runs] [--limit <n>] [--prune]';
 /** Recent runs shown before `--limit` is asked for. */

package/dist/commands/memory.js

@@ -1,11 +1,10 @@
+import { KeyStore, loadProjectEnv } from '@zenera/engine';
 import { ALL_AGENTS, buildMemoryReport, createEmbedder, diffMemories, GREP_FIELDS, grepMemory, hostPath, memoryDir, MemoryError, MemoryIndex, MemoryStore, MergeConflicts, mergeMemories, readProjectConfig, renderMemoryHtml, renderRecollection, } from '@zenera/neo';
 import { spawn } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { writeFile } from 'node:fs/promises';
 import { basename, isAbsolute, join, resolve } from 'node:path';
 import { parse } from "../args.js";
-import { loadProjectEnv } from "../env.js";
-import { KeyStore } from "../keys.js";
 import { project as resolveProject } from "../resolve.js";
 import { ago, bold, bytes, CliError, confirm, count, cyan, dim, EXIT, green, isInteractive, json, note, plain, table, usageError, write, writeAll, yellow, } from "../term.js";
 const USAGE = 'zen memory [stats|ls|search|grep|show|diff|export|merge|forget] [args] [options]';

package/dist/commands/meta.js

@@ -1,3 +1,5 @@
+import * as Projects from '@zenera/engine';
+import { assertOwner, ensureHome, isProvider, KeyStore, loadProjectEnv, PROVIDERS, } from '@zenera/engine';
 import { gatewayOf, readProjectConfig } from '@zenera/neo';
 import { spawn } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
@@ -6,15 +8,11 @@ import { join, resolve } from 'node:path';
 import { setTimeout as sleep } from 'node:timers/promises';
 import { parse } from "../args.js";
 import { matching, projectNames } from "../candidates.js";
-import { loadProjectEnv } from "../env.js";
 import { copilotEventLog } from "../eventlog.js";
-import { ensureHome } from "../home.js";
-import { assertOwner, isProvider, KeyStore, PROVIDERS } from "../keys.js";
 import { probeChat, probeModel } from "../liveness.js";
 import { answerBox, chooseModel, DATASET_DETAILS, DATASET_SUMMARY, DATASET_USAGE, datasetProjectFlag, DEFAULT_RESUMES, editorFiles, fallbackRef, FINETUNE_DETAILS, FINETUNE_SUMMARY, FINETUNE_USAGE, finetuneProjectFlag, lastSession, launch, listPrompts, loadPrompt, locate, masked, metaCompatible, misspelledProvider, MODEL_ENV, openLog, ORDER, PROMPT_DIR, providersWarning, readMeta, recordSession, RESUME_PROMPT, resumeDelayMs, runDataset, runFinetune, sameModel, sessionModel, sessionTotals, SOURCE_LABELS, startVertexRelay, tailSpans, Tally, terminalSink, transient, wire, wireGateway, writeMeta, } from "../meta/index.js";
 import { splitRef } from "../modelref.js";
 import { duration } from "../narrate.js";
-import * as Projects from "../projects.js";
 import { project as resolveProject } from "../resolve.js";
 import { TEMPLATES } from "../scaffold.js";
 import { bold, choose, CliError, credentialError, cyan, dim, EXIT, green, isInteractive, json, note, pad, progress, readStdin, table, usageError, warn, write, writeAll, } from "../term.js";

package/dist/commands/models.d.ts

@@ -1,6 +1,6 @@
+import { type Provider } from '@zenera/engine';
 import { type CatalogEntry, type Role } from '../catalog.ts';
 import type { Command } from '../command.ts';
-import { type Provider } from '../keys.ts';
 export interface BrowseRequest {
     /** opens straight into this provider's listing */
     initial?: Provider;

package/dist/commands/models.js

@@ -12,10 +12,9 @@
 // agents.yaml.
 // ---------------------------------------------------------------------------
 import { createEmbedder, GATEWAY_NAME, gatewayOf, ModelRegistry } from '@zenera/neo';
+import { ensureHome, envNames, form, isProvider, KeyStore, PROVIDERS, } from '@zenera/engine';
 import { parse } from "../args.js";
 import { byGroup, groupOf, isPartner, loadCatalog, loadCatalogs, matches, routerBalance, sampleByProvider, } from "../catalog.js";
-import { ensureHome } from "../home.js";
-import { envNames, form, isProvider, KeyStore, PROVIDERS } from "../keys.js";
 import { probeChat, probeModel } from "../liveness.js";
 import { compareModels } from "../rank.js";
 import { ago, bold, CliError, credentialError, cut, cyan, dim, EXIT, green, isInteractive, json, note, plain, progress, red, table, usageError, write, writeAll, yellow, } from "../term.js";

package/dist/commands/run.js

@@ -1,3 +1,5 @@
+import * as Projects from '@zenera/engine';
+import { display } from '@zenera/engine';
 import { usageByModel } from '@zenera/neo';
 import { writeFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
@@ -6,10 +8,8 @@ import { concurrency, runBatch } from "../batch.js";
 import * as Engine from "../engine.js";
 import { agentEventLog } from "../eventlog.js";
 import { duration, Narrator, stopMark, summary } from "../narrate.js";
-import * as Projects from "../projects.js";
 import { readBatch, readRequest } from "../request.js";
 import { target } from "../resolve.js";
-import { display } from "../session.js";
 import { bold, cyan, dim, drivenByAgent, json, jsonText, note, readStdin, usageError, write, } from "../term.js";
 import { parseChoice } from "../tui/theme.js";
 import { appendUsage } from "../usage.js";

package/dist/commands/sandbox.js

@@ -1,8 +1,7 @@
+import { current as currentProject, dirSize, isProjectDir, open as openProject, Registry, resolveBuild, sessionIds, } from '@zenera/engine';
 import { readProjectConfig, sandboxLimits, } from '@zenera/neo';
 import { parse } from "../args.js";
-import { resolveBuild } from "../image.js";
 import { engineDisk, ensurePodmanReady, idleContainers, ownedContainers, podmanStatus, removeContainers, sessionOwners, } from "../podman.js";
-import { current as currentProject, dirSize, isProjectDir, open as openProject, Registry, sessionIds, } from "../projects.js";
 import { layout, ResourceSampler } from "../resources.js";
 import { ago, bold, bytes, count, cyan, dim, green, json, note, red, table, usageError, write, writeAll, yellow, } from "../term.js";
 const USAGE = 'zen sandbox [status|top|up|pull|clean|disk] [options]';
@@ -137,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()) : [];
@@ -508,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/engine.d.ts

@@ -1,92 +1,5 @@
-import { AgentRunner, Workspace, type AgentEvent, type AgentProject, type AgentState, type Input, type RunResult } from '@zenera/neo';
-import { type Project } from './projects.ts';
-import { type SandboxSetup } from './sandbox.ts';
-import { type Held, type RunPaths, type SessionPaths } from './session.ts';
-export interface EngineOptions {
-    project: Project;
-    session: SessionPaths;
-    readOnly?: boolean;
-    /** default model override — `--model` */
-    model?: string;
-    /** sandbox image override — `--image` */
-    image?: string;
-    /** another directory to remember into — `--memory` */
-    memoryDir?: string;
-    /** recall only: nothing is written and several runs may share one graph */
-    memoryReadOnly?: boolean;
-    /** whether credentials reach the sandbox — `--no-keys` sets this false */
-    keys?: boolean;
-    /** answer the sandbox's install question without asking — `--yes` */
-    yes?: boolean;
-    /**
-     * Hold back the warnings about the project rather than the run. A batch
-     * opens one project a hundred times, and a hundred copies of the same
-     * complaint is a worse report than one.
-     */
-    quiet?: boolean;
-    /**
-     * The session will never be resumed, so its containers are removed on close
-     * whatever `persist:` says. A stopped one would only hold an engine lock.
-     */
-    disposable?: boolean;
-}
-export interface Engine {
-    project: AgentProject;
-    runner: AgentRunner;
-    name: string;
-    workspace: string;
-    /** where the workspace appears inside the container */
-    workspaceMount: string;
-    /** every tree the file tools reach, and the names they reach them by */
-    files: Workspace;
-    /** whether the agent was denied every writing tool */
-    readOnly: boolean;
-    session: SessionPaths;
-    /** the graph this session remembers into, when any agent has one */
-    memory?: string;
-    /** the session's accumulated state, when it has one */
-    state?: AgentState;
-    /** the containers this session may start; present whether or not it does */
-    sandbox: SandboxSetup;
-    lock: Held;
-    close(): Promise<void>;
-}
-/**
- * Wires the library to a session directory. Every store is file-backed and
- * rooted inside `.data/`, so a session is self-contained: copy the directory
- * and the whole conversation, its memory and its blobs travel with it.
- */
+import { runEngine, type Engine, type EngineOptions } from '@zenera/engine';
+export { envelope, mounts, type Engine, type EngineOptions, type Mount, type RunOutcome, } from '@zenera/engine';
 export declare function open(opts: EngineOptions): Promise<Engine>;
-export interface Mount {
-    /** the directory on this machine */
-    host: string;
-    /** where it appears to the agent */
-    at: string;
-    readOnly: boolean;
-}
-/** Every tree the agent can see, the workspace first. */
-export declare function mounts(engine: Engine): Mount[];
-export interface RunOutcome {
-    run: RunPaths;
-    result: RunResult<string>;
-    text: string;
-    durationMs: number;
-    /** where the report landed, when one could be rendered */
-    report?: string;
-    /** where the Mermaid graph landed, when one could be emitted */
-    graph?: string;
-}
-/**
- * What one finished run looks like to a program: `zen run --json` prints it,
- * and a batch writes one beside every item. The same function on purpose — a
- * batch whose items were shaped differently would make every consumer of a
- * single run a special case.
- */
-export declare function envelope(engine: Engine, outcome: RunOutcome): Record<string, unknown>;
-/**
- * One turn. The session's state decides whether this starts a run or continues
- * one — which is the whole of what `resume` used to be, and why it is not a
- * command.
- */
-export declare function run(engine: Engine, input: Input, onEvent?: (event: AgentEvent) => void, signal?: AbortSignal): Promise<RunOutcome>;
+export declare const run: typeof runEngine;
 //# sourceMappingURL=engine.d.ts.map