@aui.io/apollo 0.1.60 → 0.1.65

package/node_modules/@aui.io/apollo-core/dist/src/services/runs.js

@@ -0,0 +1,186 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { readBuildFiles } from "../bundle/build-area.js";
+import { CliError, ConfigError } from "../errors/index.js";
+import { agentRoot, readCheckoutTree, requireAgent } from "./bundles.js";
+/**
+ * The two proving lanes' console half
+ * (builder/flow/regressions-and-evaluations-plan.md phase 5): ship the
+ * checkout's current tree — the program under `src/**`, the records under
+ * `build/**` — and the server runs it against the shipped snapshot. A
+ * REGRESSION drives `build/scenarios.yaml` through the simulator, nobody
+ * improvising; an EVALUATION plans improvising callers from guidelines and
+ * ends on a macro verdict. No session exists; polling IS the progress
+ * surface. The last run's id per lane is a LOCAL fact in the checkout's
+ * `.apollo/<kind>.json`, so `--status`, `--cancel`, `--pull` and
+ * `--annotate` name nothing and still find their run.
+ */
+/** Run statuses that are still moving — everything else is the verdict. */
+const RUN_LIVE = new Set(["queued", "running", "cancelling"]);
+/** A run is real conversations plus judge calls — hours-scale like a
+ *  build, so the poll loop's own deadline is generous; each poll request
+ *  stays cheap. */
+export const RUN_DEADLINE_MS = 2 * 3600_000;
+const RUN_POLL_MS = 5_000;
+function runStateFile(root, kind) {
+    return path.join(root, ".apollo", `${kind}.json`);
+}
+/** The saved run handle, or nothing — a missing or corrupt file simply
+ *  means there is no run to name. The pre-phase-5 evaluation file carried
+ *  `evaluation_id`; it still reads. */
+export async function readRunState(root, kind) {
+    try {
+        const parsed = JSON.parse(await readFile(runStateFile(root, kind), "utf8"));
+        const id = typeof parsed.run_id === "string" ? parsed.run_id : parsed.evaluation_id;
+        return typeof id === "string" ? { run_id: id, kind } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function writeRunState(root, state) {
+    const file = runStateFile(root, state.kind);
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+/** The id a receipt carries — an evaluation's `evaluation_id`, a
+ *  regression's `regression_id`. */
+export function receiptId(receipt) {
+    const id = receipt.regression_id ?? receipt.evaluation_id;
+    if (!id)
+        throw new CliError("The server's receipt named no run.");
+    return id;
+}
+/** Every file under `<root>/bundle/build/**` as `build/**` wire paths.
+ *  Absent directory reads as an empty map: the server names the missing
+ *  file (422), which teaches more than a local guess. */
+async function readBuildTree(buildDir) {
+    const { files } = await readBuildFiles(buildDir);
+    return Object.fromEntries(Object.entries(files).map(([relativePath, content]) => [
+        `build/${relativePath}`,
+        content.toString("utf8"),
+    ]));
+}
+async function checkoutTree(root) {
+    return {
+        ...(await readCheckoutTree(path.join(root, "bundle", "src"))),
+        ...(await readBuildTree(path.join(root, "bundle", "build"))),
+    };
+}
+/**
+ * Start one detached evaluation over this checkout and save its id. The
+ * tree is frozen at accept — keep editing, the run's bytes do not move.
+ */
+export async function startEvaluation(context, builder, options) {
+    const root = options.root ?? agentRoot(context);
+    const guidelines = options.guidelines.trim();
+    if (!guidelines) {
+        throw new ConfigError("An evaluation needs guidelines — what to evaluate, in plain words.", 'Example: apollo evaluate "the refund refusal path after this change".');
+    }
+    const versionTag = options.versionTag ?? context.versionTag;
+    const receipt = await builder.startEvaluation({
+        agent_id: requireAgent(context),
+        files: await checkoutTree(root),
+        guidelines,
+        ...(options.config && Object.keys(options.config).length ? { config: options.config } : {}),
+        ...(options.message ? { message: options.message } : {}),
+        ...(versionTag ? { version_tag: versionTag } : {}),
+    });
+    await writeRunState(root, { run_id: receiptId(receipt), kind: "evaluation" });
+    return receipt;
+}
+/** Start one detached regression over this checkout and save its id. */
+export async function startRegression(context, builder, options = {}) {
+    const root = options.root ?? agentRoot(context);
+    const versionTag = options.versionTag ?? context.versionTag;
+    const receipt = await builder.startRegression({
+        agent_id: requireAgent(context),
+        files: await checkoutTree(root),
+        ...(options.scenarios?.length ? { scenarios: options.scenarios } : {}),
+        ...(options.judge ? { judge: true } : {}),
+        ...(options.message ? { message: options.message } : {}),
+        ...(versionTag ? { version_tag: versionTag } : {}),
+    });
+    await writeRunState(root, { run_id: receiptId(receipt), kind: "regression" });
+    return receipt;
+}
+/** Poll one run to its terminal view (completed, failed or cancelled). */
+export async function awaitRun(builder, kind, runId, options = {}) {
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const interval = options.pollIntervalMs ?? RUN_POLL_MS;
+    const deadline = Date.now() + (options.deadlineMs ?? RUN_DEADLINE_MS);
+    for (;;) {
+        const view = await builder.runView(kind, runId);
+        if (!RUN_LIVE.has(view.status))
+            return view;
+        if (Date.now() >= deadline) {
+            // The run keeps executing server-side; the saved id still names it.
+            throw new CliError(`The ${kind} is still running (${runId}).`, {
+                suggestion: `\`apollo ${verb(kind)} --status\` picks the report up later.`,
+            });
+        }
+        await sleep(interval);
+    }
+}
+/** The CLI verb per lane. */
+export function verb(kind) {
+    return kind === "regression" ? "regress" : "evaluate";
+}
+/** The run the caller means: the explicit id, else the checkout's saved
+ *  last run of that lane — no run at all is a config story, not a 404. */
+export async function resolveRunId(context, kind, explicit, root) {
+    if (explicit)
+        return explicit;
+    const saved = await readRunState(root ?? agentRoot(context), kind);
+    if (!saved) {
+        throw new ConfigError(`No ${kind} to name — this checkout has not started one.`, `Run \`apollo ${verb(kind)}\` first, or pass --id.`);
+    }
+    return saved.run_id;
+}
+/**
+ * Fetch a settled run's evidence and write it under the checkout —
+ * `tmp/regressions/<id>/` or `tmp/evaluations/<id>/`, the layout the
+ * builder writes in a session, so a CLI author and a builder session read
+ * the same files. `tmp/**` never ships; a re-pull overwrites.
+ */
+export async function pullRun(context, builder, kind, runId, options = {}) {
+    const root = path.resolve(options.root ?? agentRoot(context));
+    const artifacts = await builder.runArtifacts(kind, runId, options.all ?? true);
+    const written = [];
+    for (const [relativePath, content] of Object.entries(artifacts.files)) {
+        const target = insideTmp(root, relativePath);
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, content, "utf8");
+        written.push(relativePath);
+    }
+    return {
+        directory: insideTmp(root, artifacts.root),
+        files: written.sort(),
+        note: artifacts.note,
+    };
+}
+/** A server-named artifact path must live under `tmp/` inside the
+ *  checkout — anything else is refused before a byte is written. */
+function insideTmp(root, relativePath) {
+    const normalized = relativePath.split("\\").join("/");
+    if (!normalized.startsWith("tmp/") || normalized.split("/").includes("..")) {
+        throw new CliError(`Refusing to write outside tmp/: ${relativePath}`);
+    }
+    const target = path.resolve(root, normalized);
+    if (!target.startsWith(`${path.join(root, "tmp")}${path.sep}`)) {
+        throw new CliError(`Refusing to write outside tmp/: ${relativePath}`);
+    }
+    return target;
+}
+/** Append one reading to a settled run; the server answers the run as it
+ *  now reads. */
+export function annotateRun(builder, kind, runId, annotation) {
+    const text = annotation.text.trim();
+    if (!text)
+        throw new ConfigError("An annotation needs some text.");
+    return builder.annotateRun(kind, runId, {
+        text,
+        ...(annotation.verdict ? { verdict: annotation.verdict } : {}),
+    });
+}
+//# sourceMappingURL=runs.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../../src/services/runs.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/services/status.service.d.ts

@@ -1,4 +1,5 @@
 import type { Context } from "../config/index.js";
+import { type RuntimePinCheck } from "../runtime-version/availability.js";
 export interface ServiceCheck {
     service: "identity" | "management" | "runtime";
     reachable: boolean;
@@ -20,8 +21,15 @@ export interface StatusResult {
     bindingPath: string | null;
     agentRoot: string | null;
     checks?: ServiceCheck[];
+    /**
+     * With `--check` on a pinned checkout: whether the pinned runtime is still
+     * served (the family may be retired, or the gateway may route the pin to
+     * a different engine). Absent when unpinned or without `--check`.
+     */
+    runtimePinned?: RuntimePinCheck;
 }
 export declare function getStatus(context: Context, options?: {
     check?: boolean;
     fetch?: typeof globalThis.fetch;
+    homeDir?: string;
 }): Promise<StatusResult>;

package/node_modules/@aui.io/apollo-core/dist/src/services/status.service.js

@@ -1,6 +1,8 @@
 import { Transport } from "../api/transport.js";
 import { ApiError, AuthError } from "../errors/index.js";
+import { checkRuntimeAvailability, } from "../runtime-version/availability.js";
 import { RUNTIME_VERSION_HEADER } from "../runtime-version/index.js";
+import { createClients } from "./clients.js";
 export async function getStatus(context, options = {}) {
     const result = {
         environment: context.environment,
@@ -22,6 +24,19 @@ export async function getStatus(context, options = {}) {
             checkManagement(context, options.fetch),
             checkRuntime(context, options.fetch),
         ]);
+        if (context.runtimeVersion) {
+            const clients = createClients(context, {
+                ...(options.homeDir ? { homeDir: options.homeDir } : {}),
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+            });
+            const pinned = await checkRuntimeAvailability(context, clients, {
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+                ...(options.homeDir ? { homeDir: options.homeDir } : {}),
+                withoutCatalog: "probe",
+            });
+            if (pinned)
+                result.runtimePinned = pinned;
+        }
     }
     return result;
 }

package/node_modules/@aui.io/apollo-core/dist/src/services/status.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.service.js","sourceRoot":"","sources":["../../../src/services/status.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status.service.js","sourceRoot":"","sources":["../../../src/services/status.service.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aui.io/apollo-core",
-  "version": "0.1.60",
+  "version": "0.1.65",
   "description": "Shared Apollo console core — API clients, config, and services",
   "type": "module",
   "engines": {

package/node_modules/@aui.io/apollo-tui/dist/src/lib/actions.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, type AgentVersion } from "@aui.io/apollo-core/api/management.js";
+import { type Agent, type AgentVersion, type ManagementClient } from "@aui.io/apollo-core/api/management.js";
 import { type Context } from "@aui.io/apollo-core/config/index.js";
 import type { CommandField } from "./commands.js";
 import type { PickerItem } from "./picker.js";
@@ -51,6 +51,15 @@ export interface ActionResult {
 }
 /** Label prefix for the live row in the import version picker (UI keys off it). */
 export declare const IMPORT_LIVE_PREFIX = "live \u2014 ";
+/**
+ * The pull sheet's tag row → what `pullCheckout` is asked for. "bound" (the
+ * default) is a bare `apollo pull`: no tag, so core pulls the checkout's
+ * `.apollorc` pin and follows it to the tip of its major line. "latest
+ * (live)" is the published version, resolved to its real tag the way
+ * version-use does — the literal word used to fall through to the bound
+ * pin, so the row did not do what it said. Anything else is a tag as typed.
+ */
+export declare function pullTagFor(selected: string, context: Context, management: Pick<ManagementClient, "getAgent" | "listVersions">): Promise<string | undefined>;
 /**
  * Version rows for the import picker: the live version first (row 0 = the
  * picker default) when one exists, else just the tags — the caller shows

package/node_modules/@aui.io/apollo-tui/dist/src/lib/actions.js

@@ -70,6 +70,27 @@ function orgIdOf(org) {
 }
 /** Label prefix for the live row in the import version picker (UI keys off it). */
 export const IMPORT_LIVE_PREFIX = "live — ";
+/**
+ * The pull sheet's tag row → what `pullCheckout` is asked for. "bound" (the
+ * default) is a bare `apollo pull`: no tag, so core pulls the checkout's
+ * `.apollorc` pin and follows it to the tip of its major line. "latest
+ * (live)" is the published version, resolved to its real tag the way
+ * version-use does — the literal word used to fall through to the bound
+ * pin, so the row did not do what it said. Anything else is a tag as typed.
+ */
+export async function pullTagFor(selected, context, management) {
+    if (!selected || selected === "bound")
+        return undefined;
+    if (selected !== "latest")
+        return selected;
+    if (!context.agentId)
+        throw new ConfigError("Select an agent first.");
+    const agent = await management.getAgent(context.agentId);
+    const live = findLiveVersion(agent, (await management.listVersions(context.agentId)).results);
+    if (!live)
+        throw new ConfigError("No live version — pick a tag.");
+    return live.version_tag;
+}
 /**
  * Version rows for the import picker: the live version first (row 0 = the
  * picker default) when one exists, else just the tags — the caller shows
@@ -174,6 +195,20 @@ export async function loadPickerCatalog(kind, context) {
                 ...page.results.map((v) => item(v.version_tag, v.version_tag, v.status)),
             ];
         }
+        case "pull-version": {
+            // What a bare `apollo pull` does, spelled out: the checkout's pin,
+            // which core follows to the tip of its major line when it is stale.
+            // The bound tag is what the CLI would print in `status`; the row's
+            // detail says where the pull actually lands.
+            const rows = [];
+            if (context.versionTag) {
+                rows.push(item("bound", `bound · ${context.versionTag}`, "follows .apollorc · default"));
+            }
+            rows.push(item("latest", "latest (live)", "the published version"));
+            const page = await listVersions(context, clients.management);
+            rows.push(...page.results.map((v) => item(v.version_tag, v.version_tag, v.status)));
+            return rows;
+        }
         case "runtime": {
             const resolved = await resolveRuntimeVersion(clients.agentSettings);
             return resolved.options.map((option) => item(option.latest_version, `${option.display_name} · ${option.latest_version}`, option.latest_version === context.runtimeVersion
@@ -880,12 +915,12 @@ export async function runSheetAction(commandName, values, context) {
             };
         }
         case "pull": {
-            const tag = text("tag");
+            const tag = await pullTagFor(text("tag"), context, clients.management);
             const dir = text("dir");
             const force = values.force === true;
             try {
                 const result = await pullCheckout(context, clients, {
-                    ...(tag && tag !== "latest" ? { tag } : {}),
+                    ...(tag ? { tag } : {}),
                     ...(dir ? { destination: dir } : {}),
                     force,
                 });
@@ -895,7 +930,7 @@ export async function runSheetAction(commandName, values, context) {
                 const on = result.runtimeVersion ? ` on ${result.runtimeVersion}` : "";
                 return {
                     jumpTab: "bundle",
-                    toast: `Pulled ${Object.keys(result.files).length} file(s)${on}${removed}`,
+                    toast: `Pulled ${Object.keys(result.files).length} file(s) @ ${result.pull.version_tag}${on}${removed}`,
                     refreshScope: true,
                 };
             }
@@ -1284,10 +1319,12 @@ export async function runDestructive(action, context, args = {}) {
             return { jumpTab: "mockdb", toast: "Deleted mock DB" };
         }
         case "pull-force": {
+            // `args.tag` is the tag the pull sheet already resolved (a picked row
+            // or the live tag); absent means the bound pin, as in the first try.
             const tag = args.tag ?? "";
             const dir = args.dir ?? "";
             const result = await pullCheckout(context, clients, {
-                ...(tag && tag !== "latest" ? { tag } : {}),
+                ...(tag ? { tag } : {}),
                 ...(dir ? { destination: dir } : {}),
                 force: true,
             });
@@ -1297,7 +1334,7 @@ export async function runDestructive(action, context, args = {}) {
             const on = result.runtimeVersion ? ` on ${result.runtimeVersion}` : "";
             return {
                 jumpTab: "bundle",
-                toast: `Force-pulled ${Object.keys(result.files).length} file(s)${on}${removed}`,
+                toast: `Force-pulled ${Object.keys(result.files).length} file(s) @ ${result.pull.version_tag}${on}${removed}`,
                 refreshScope: true,
             };
         }