@aui.io/apollo 0.1.60 → 0.1.66

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,GAQhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,eAAe,GAYhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,GAMZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,GAOV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,GASjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,GAajB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,SAAS,GAKV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,UAAU,EACV,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,mBAAmB,GAWpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,UAAU,EACV,OAAO,EACP,YAAY,EACZ,aAAa,GAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GAKjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GAGf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,WAAW,EACX,cAAc,EACd,cAAc,GAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAEhB,MAAM,mBAAmB,CAAC;AAa3B,OAAO,EACL,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,UAAU,GAGX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,MAAM,EACN,aAAa,EACb,eAAe,GAIhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,MAAM,EACN,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,GAQtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAIlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,UAAU,GAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAgB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,gBAAgB,EAChB,cAAc,GAGf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,6BAA6B,EAC7B,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,GACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,QAAQ,EACR,wBAAwB,EACxB,iBAAiB,GAKlB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GAGvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,GACN,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAUjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,GAIf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,UAAU,GAGX,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,aAAa,EACb,cAAc,EACd,UAAU,EACV,oBAAoB,GAErB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,SAAS,GAMV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,SAAS,GAGV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,UAAU,GAIX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,GAMjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GAEd,MAAM,yBAAyB,CAAC"}

package/node_modules/@aui.io/apollo-core/dist/src/output/index.d.ts

@@ -1,9 +1,17 @@
 import type { CliError } from "../errors/index.js";
+import type { UpdateNotice } from "../services/update-check.js";
 export interface OutputOptions {
     json: boolean;
     quiet: boolean;
     verbose: boolean;
 }
+export interface SuccessEnvelope {
+    success: true;
+    data: unknown;
+    /** A newer console is published. Additive: absent unless one is known,
+     *  so consumers that never look for it see the envelope they always did. */
+    update?: UpdateNotice;
+}
 export interface ErrorEnvelope {
     success: false;
     error: {
@@ -13,19 +21,37 @@ export interface ErrorEnvelope {
         /** The upstream response body (or other context) behind the failure. */
         detail?: unknown;
     };
+    /** Same as on success — a failing run is exactly when the fix may be
+     *  "upgrade", so the notice rides the error envelope too. */
+    update?: UpdateNotice;
 }
-export declare function successEnvelope(data: unknown): {
-    success: true;
-    data: unknown;
-};
-export declare function errorEnvelope(error: CliError): ErrorEnvelope;
+export declare function successEnvelope(data: unknown, update?: UpdateNotice): SuccessEnvelope;
+export declare function errorEnvelope(error: CliError, update?: UpdateNotice): ErrorEnvelope;
 export declare class Output {
     readonly options: OutputOptions;
     private readonly stdout;
     private readonly stderr;
+    private update;
     constructor(options: OutputOptions, stdout?: NodeJS.WritableStream, stderr?: NodeJS.WritableStream);
+    /** The newer-version notice every envelope this Output emits will carry
+     *  (and the trailing stderr line reports). Undefined clears it — the
+     *  `upgrade` command does that, being the update surface itself. */
+    setUpdateNotice(update: UpdateNotice | undefined): void;
+    get updateNotice(): UpdateNotice | undefined;
     result(data: unknown, renderHuman: (value: unknown) => string): void;
     error(error: CliError): void;
+    /** A non-fatal caution — the command went through, but something the user
+     *  should know about did not hold. Stderr in every mode (stdout stays the
+     *  result envelope), silenced only by `--quiet`. */
+    warn(message: string): void;
+    /**
+     * A one-line advisory on stderr — the update banner. Unlike `progress()`
+     * it does not need a TTY: a coding agent driving plain commands reads
+     * stderr and must see it. JSON runs stay silent here because the
+     * envelope's `update` field already carries the same fact; `--quiet`
+     * mutes it like every other advisory.
+     */
+    notice(message: string): void;
     progress(message: string): void;
     debug(message: string): void;
 }

package/node_modules/@aui.io/apollo-core/dist/src/output/index.js

@@ -1,8 +1,8 @@
 import pc from "picocolors";
-export function successEnvelope(data) {
-    return { success: true, data };
+export function successEnvelope(data, update) {
+    return { success: true, data, ...(update === undefined ? {} : { update }) };
 }
-export function errorEnvelope(error) {
+export function errorEnvelope(error, update) {
     return {
         success: false,
         error: {
@@ -11,6 +11,7 @@ export function errorEnvelope(error) {
             ...(error.suggestion === undefined ? {} : { suggestion: error.suggestion }),
             ...(error.detail === undefined ? {} : { detail: error.detail }),
         },
+        ...(update === undefined ? {} : { update }),
     };
 }
 /** How much of an upstream error body the default (non-verbose) human
@@ -26,26 +27,56 @@ export class Output {
     options;
     stdout;
     stderr;
+    update;
     constructor(options, stdout = process.stdout, stderr = process.stderr) {
         this.options = options;
         this.stdout = stdout;
         this.stderr = stderr;
     }
+    /** The newer-version notice every envelope this Output emits will carry
+     *  (and the trailing stderr line reports). Undefined clears it — the
+     *  `upgrade` command does that, being the update surface itself. */
+    setUpdateNotice(update) {
+        this.update = update;
+    }
+    get updateNotice() {
+        return this.update;
+    }
     result(data, renderHuman) {
         const value = this.options.json
-            ? JSON.stringify(successEnvelope(data))
+            ? JSON.stringify(successEnvelope(data, this.update))
             : renderHuman(data);
         this.stdout.write(`${value}\n`);
     }
     error(error) {
         const value = this.options.json
-            ? JSON.stringify(errorEnvelope(error))
+            ? JSON.stringify(errorEnvelope(error, this.update))
             : `${pc.red("Error:")} ${error.message}${error.detail === undefined
                 ? ""
                 : `\n${pc.dim(renderDetail(error.detail, this.options.verbose))}`}${error.suggestion === undefined ? "" : `\n${pc.dim(error.suggestion)}`}`;
         const target = this.options.json ? this.stdout : this.stderr;
         target.write(`${value}\n`);
     }
+    /** A non-fatal caution — the command went through, but something the user
+     *  should know about did not hold. Stderr in every mode (stdout stays the
+     *  result envelope), silenced only by `--quiet`. */
+    warn(message) {
+        if (!this.options.quiet) {
+            this.stderr.write(`${pc.yellow("Warning:")} ${message}\n`);
+        }
+    }
+    /**
+     * A one-line advisory on stderr — the update banner. Unlike `progress()`
+     * it does not need a TTY: a coding agent driving plain commands reads
+     * stderr and must see it. JSON runs stay silent here because the
+     * envelope's `update` field already carries the same fact; `--quiet`
+     * mutes it like every other advisory.
+     */
+    notice(message) {
+        if (this.options.quiet || this.options.json)
+            return;
+        this.stderr.write(`${pc.yellow(message)}\n`);
+    }
     progress(message) {
         const isTTY = "isTTY" in this.stderr && this.stderr.isTTY === true;
         if (!this.options.quiet && !this.options.json && isTTY) {

package/node_modules/@aui.io/apollo-core/dist/src/output/index.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/availability.d.ts

@@ -0,0 +1,81 @@
+import type { AgentSettingsClient } from "../api/agent-settings.js";
+import type { Context } from "../config/types.js";
+import { type RuntimeUnavailableReason } from "../errors/index.js";
+import { familyOf, type RuntimeVersionOption } from "./index.js";
+export { familyOf };
+/** One try of the health probe. */
+export declare const PROBE_TIMEOUT_MS = 5000;
+export declare const PROBE_ATTEMPTS = 3;
+/** Waits between tries — 1 s after the first failure, 2 s after the second. */
+export declare const PROBE_BACKOFF_MS: readonly number[];
+export declare const AVAILABILITY_CACHE_TTL_MS: number;
+export declare const AVAILABILITY_CACHE_FILE = "runtime-availability.json";
+export interface RuntimeAvailability {
+    available: boolean;
+    reason?: RuntimeUnavailableReason;
+    /** The engine the deployment reported, when it answered. */
+    engine?: string;
+}
+/** What `/health` says — only `engine` matters here. */
+export interface RuntimeHealth {
+    status?: string;
+    build?: string;
+    engine?: string;
+}
+/**
+ * The verdict for one health answer. Pure: status code + parsed body in,
+ * verdict out. Retryable failures (5xx, no answer) come back `unreachable` —
+ * the probe loop decides whether to try again.
+ */
+export declare function verdictFromHealth(option: RuntimeVersionOption, status: number, body: unknown): RuntimeAvailability;
+/**
+ * Probe the deployment behind one catalog entry. Published entries go
+ * through the gateway with the routed build as the header; custom entries
+ * are probed at their own link. Unauthenticated: `/health` is public.
+ */
+export declare function probeRuntimeAvailability(context: Pick<Context, "baseUrls">, option: RuntimeVersionOption, fetchImpl?: typeof globalThis.fetch): Promise<RuntimeAvailability>;
+export declare function availabilityCachePath(homeDir: string): string;
+export interface RuntimePinCheck {
+    /** The pin as the context carries it (flag, env, or `.apollorc`). */
+    version: string;
+    available: boolean;
+    reason?: RuntimeUnavailableReason;
+    /** The engine the deployment reported, when it answered. */
+    engine?: string;
+    /** Catalog display name of the pinned family, when the catalog knows it. */
+    label?: string;
+    /** The catalog's newest published build — the re-pin target. */
+    latest?: string;
+    /** The catalog could not be read; see `withoutCatalog`. */
+    catalogError?: string;
+    /** The verdict came from the on-disk cache, not a fresh probe. */
+    cached?: boolean;
+}
+export interface AvailabilityOptions {
+    fetch?: typeof globalThis.fetch;
+    /** `false` bypasses the on-disk verdict cache (neither read nor written). */
+    cache?: boolean;
+    homeDir?: string;
+    /**
+     * With the catalog unreachable: `skip` (default) trusts the pin — a
+     * catalog outage must never fail a command; `probe` still probes the pin
+     * as-is so a report can say what is served.
+     */
+    withoutCatalog?: "skip" | "probe";
+}
+/**
+ * The full rule for the context's pin, as a report. `undefined` when the
+ * checkout is unpinned (the gateway default is always served).
+ */
+export declare function checkRuntimeAvailability(context: Context, clients: {
+    agentSettings: Pick<AgentSettingsClient, "listRuntimeVersions">;
+}, options?: AvailabilityOptions): Promise<RuntimePinCheck | undefined>;
+/**
+ * The gate every engine-needing verb runs first. Throws
+ * `RuntimeUnavailableError` (code `RUNTIME_UNAVAILABLE`) when the pin is no
+ * longer served; returns quietly when unpinned, when the pin is served, or
+ * when the catalog cannot be read.
+ */
+export declare function assertRuntimeAvailable(context: Context, clients: {
+    agentSettings: Pick<AgentSettingsClient, "listRuntimeVersions">;
+}, options?: AvailabilityOptions): Promise<void>;

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/availability.js

@@ -0,0 +1,260 @@
+/**
+ * Is the runtime a checkout is pinned to still SERVED?
+ *
+ * A pin names a family whose deployment can be retired: the catalog record
+ * disappears, the gateway route is deleted, or the route falls through to
+ * the default deployment — which answers 200 with an engine that is NOT the
+ * one asked for. None of that surfaces on its own; chat, builds and runs
+ * simply fail or, worse, run on the wrong engine. So every engine-needing
+ * verb asks here first, and `status --check` / `doctor` report the answer.
+ *
+ * The rule (shared with the playground and admin apps — keep them aligned):
+ *   1. No pin → nothing to check; the gateway default is always served.
+ *   2. A pin the catalog cannot match → unavailable (`not-in-catalog`).
+ *   3. Otherwise probe `GET {runtime}/health` with the pin's routed build as
+ *      the `runtime-version` header (a custom build: its own link, no header).
+ *      2xx whose `engine` shares the pin's major.minor → available; a
+ *      different (or missing) engine → `routed-elsewhere`. 4xx means the
+ *      deployment exists but refused → available (never block on auth).
+ *      Connection failures, timeouts and 5xx retry 3× with 1 s / 2 s backoff;
+ *      exhausted → `unreachable`.
+ *   4. `available` verdicts are cached on disk for five minutes; an
+ *      unavailable verdict is never cached, so recovery is immediate.
+ *
+ * A catalog outage never fails a command (the existing rule for everything
+ * runtime-version): the gate lets the command through.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { Transport } from "../api/transport.js";
+import { apolloDir } from "../config/store.js";
+import { ApiError, RuntimeUnavailableError, } from "../errors/index.js";
+import { familyOf, matchRuntimeVersion, resolveRuntimeVersion, RUNTIME_VERSION_HEADER, } from "./index.js";
+export { familyOf };
+/** One try of the health probe. */
+export const PROBE_TIMEOUT_MS = 5_000;
+export const PROBE_ATTEMPTS = 3;
+/** Waits between tries — 1 s after the first failure, 2 s after the second. */
+export const PROBE_BACKOFF_MS = [1_000, 2_000];
+export const AVAILABILITY_CACHE_TTL_MS = 5 * 60_000;
+export const AVAILABILITY_CACHE_FILE = "runtime-availability.json";
+/**
+ * The verdict for one health answer. Pure: status code + parsed body in,
+ * verdict out. Retryable failures (5xx, no answer) come back `unreachable` —
+ * the probe loop decides whether to try again.
+ */
+export function verdictFromHealth(option, status, body) {
+    const engine = engineOf(body);
+    if (status >= 200 && status < 300) {
+        const wanted = familyOf(option.runtime_version);
+        // A custom build carries whatever version string its branch has — a
+        // 2xx from its own deployment is the whole answer. Same for a published
+        // record whose id is not semver: there is no family to compare.
+        if (option.type === "custom" || wanted === undefined) {
+            return { available: true, ...(engine ? { engine } : {}) };
+        }
+        if (engine !== undefined && familyOf(engine) === wanted) {
+            return { available: true, engine };
+        }
+        // The gateway answered from another deployment (or a deployment that
+        // does not report its engine — a real one always does).
+        return {
+            available: false,
+            reason: "routed-elsewhere",
+            ...(engine ? { engine } : {}),
+        };
+    }
+    if (status >= 400 && status < 500) {
+        // The deployment exists but refused or does not serve /health — not a
+        // reason to block. A custom link that 404s has nothing behind it.
+        if (option.type === "custom" && status === 404) {
+            return { available: false, reason: "unreachable" };
+        }
+        return { available: true };
+    }
+    return { available: false, reason: "unreachable" };
+}
+function engineOf(body) {
+    if (typeof body !== "object" || body === null)
+        return undefined;
+    const engine = body.engine;
+    return typeof engine === "string" && engine.trim() !== ""
+        ? engine.trim()
+        : undefined;
+}
+/** 5xx and "no answer at all" are worth another try; anything else is final. */
+function retryable(status) {
+    return status === 0 || status >= 500;
+}
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Probe the deployment behind one catalog entry. Published entries go
+ * through the gateway with the routed build as the header; custom entries
+ * are probed at their own link. Unauthenticated: `/health` is public.
+ */
+export async function probeRuntimeAvailability(context, option, fetchImpl) {
+    const custom = option.type === "custom" && option.custom_link;
+    const transport = new Transport({
+        service: "runtime-api",
+        baseUrl: custom ? option.custom_link : context.baseUrls.runtime,
+        timeoutMs: PROBE_TIMEOUT_MS,
+        ...(custom
+            ? {}
+            : { headers: { [RUNTIME_VERSION_HEADER]: option.latest_version } }),
+        ...(fetchImpl ? { fetch: fetchImpl } : {}),
+    });
+    let verdict = { available: false, reason: "unreachable" };
+    for (let attempt = 0; attempt < PROBE_ATTEMPTS; attempt += 1) {
+        if (attempt > 0) {
+            await wait(PROBE_BACKOFF_MS[attempt - 1] ?? PROBE_BACKOFF_MS.at(-1) ?? 0);
+        }
+        try {
+            const body = await transport.request("/health", {
+                authenticated: false,
+            });
+            return verdictFromHealth(option, 200, body);
+        }
+        catch (error) {
+            if (error instanceof ApiError) {
+                if (!retryable(error.status)) {
+                    return verdictFromHealth(option, error.status, error.detail);
+                }
+                verdict = verdictFromHealth(option, error.status, error.detail);
+                continue;
+            }
+            // Timeout or connection failure — no status to judge; try again.
+            verdict = { available: false, reason: "unreachable" };
+        }
+    }
+    return verdict;
+}
+export function availabilityCachePath(homeDir) {
+    return join(apolloDir(homeDir), AVAILABILITY_CACHE_FILE);
+}
+async function readCache(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        // Missing or corrupt — a cache miss either way.
+        return {};
+    }
+}
+async function writeCache(path, file) {
+    try {
+        await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+        const temporary = `${path}.${process.pid}.tmp`;
+        await writeFile(temporary, `${JSON.stringify(file, null, 2)}\n`, {
+            mode: 0o644,
+        });
+        await rename(temporary, path);
+    }
+    catch {
+        // The cache is an optimisation; a read-only home must not fail a command.
+    }
+}
+function cacheKey(option) {
+    return option.type === "custom" && option.custom_link
+        ? option.custom_link
+        : option.latest_version;
+}
+function fresh(entry, now) {
+    if (entry?.verdict !== "available")
+        return false;
+    const at = Date.parse(entry.at);
+    return !Number.isNaN(at) && now - at < AVAILABILITY_CACHE_TTL_MS;
+}
+/**
+ * The full rule for the context's pin, as a report. `undefined` when the
+ * checkout is unpinned (the gateway default is always served).
+ */
+export async function checkRuntimeAvailability(context, clients, options = {}) {
+    const pin = context.runtimeVersion;
+    if (!pin)
+        return undefined;
+    const resolved = await resolveRuntimeVersion(clients.agentSettings);
+    let option;
+    if (resolved.error !== undefined) {
+        if (options.withoutCatalog !== "probe") {
+            return { version: pin, available: true, catalogError: resolved.error };
+        }
+        // No catalog to translate the pin; probe it as the header value it is.
+        option = {
+            runtime_version: pin,
+            latest_version: pin,
+            display_name: pin,
+            type: familyOf(pin) ? "published" : "custom",
+        };
+    }
+    else {
+        option = matchRuntimeVersion(resolved.options, pin);
+        if (!option) {
+            return {
+                version: pin,
+                available: false,
+                reason: "not-in-catalog",
+                ...(resolved.version ? { latest: resolved.version } : {}),
+            };
+        }
+    }
+    const summary = {
+        version: pin,
+        available: false,
+        ...(resolved.error === undefined ? { label: option.display_name } : {}),
+        ...(resolved.version ? { latest: resolved.version } : {}),
+        ...(resolved.error === undefined ? {} : { catalogError: resolved.error }),
+    };
+    const useCache = options.cache !== false;
+    const cachePath = availabilityCachePath(options.homeDir ?? homedir());
+    const key = cacheKey(option);
+    if (useCache) {
+        const entry = (await readCache(cachePath))[key];
+        if (fresh(entry, Date.now())) {
+            return {
+                ...summary,
+                available: true,
+                cached: true,
+                ...(entry?.engine ? { engine: entry.engine } : {}),
+            };
+        }
+    }
+    const verdict = await probeRuntimeAvailability(context, option, options.fetch);
+    if (verdict.available && useCache) {
+        const file = await readCache(cachePath);
+        file[key] = {
+            verdict: "available",
+            at: new Date().toISOString(),
+            ...(verdict.engine ? { engine: verdict.engine } : {}),
+        };
+        await writeCache(cachePath, file);
+    }
+    return { ...summary, ...verdict };
+}
+/**
+ * The gate every engine-needing verb runs first. Throws
+ * `RuntimeUnavailableError` (code `RUNTIME_UNAVAILABLE`) when the pin is no
+ * longer served; returns quietly when unpinned, when the pin is served, or
+ * when the catalog cannot be read.
+ */
+export async function assertRuntimeAvailable(context, clients, options = {}) {
+    const check = await checkRuntimeAvailability(context, clients, {
+        ...options,
+        withoutCatalog: "skip",
+    });
+    if (check === undefined || check.available)
+        return;
+    throw new RuntimeUnavailableError({
+        pinned: check.version,
+        reason: check.reason ?? "unreachable",
+        ...(check.label !== undefined ? { label: check.label } : {}),
+        ...(check.latest !== undefined ? { latest: check.latest } : {}),
+        ...(check.engine !== undefined
+            ? { detail: `The gateway is serving engine ${check.engine} for this pin.` }
+            : {}),
+    });
+}
+//# sourceMappingURL=availability.js.map

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../../src/runtime-version/availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EACL,QAAQ,EACR,uBAAuB,GAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,MAAM,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAgBnE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA4B,EAC5B,MAAc,EACd,IAAa;IAEb,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAChD,oEAAoE;QACpE,wEAAwE;QACxE,gEAAgE;QAChE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACrD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;YACxD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACrC,CAAC;QACD,qEAAqE;QACrE,wDAAwD;QACxD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,kBAAkB;YAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAClC,sEAAsE;QACtE,kEAAkE;QAClE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YAC/C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAa;IAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,MAAM,GAAI,IAAsB,CAAC,MAAM,CAAC;IAC9C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QACvD,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;QACf,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,MAAM,KAAK,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC;AACvC,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,EAAU,EAAiB,EAAE,CACzC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAkC,EAClC,MAA4B,EAC5B,SAAmC;IAEnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAY,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO;QAChE,SAAS,EAAE,gBAAgB;QAC3B,GAAG,CAAC,MAAM;YACR,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QACrE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3C,CAAC,CAAC;IAEH,IAAI,OAAO,GAAwB,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAC/E,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,cAAc,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC7D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAU,SAAS,EAAE;gBACvD,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YACH,OAAO,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC7B,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC/D,CAAC;gBACD,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,iEAAiE;YACjE,OAAO,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAaD,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;QACnE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5E,CAAC,CAAE,MAAoB;YACvB,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAe;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QAC/C,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAC/D,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,MAA4B;IAC5C,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW;QACnD,CAAC,CAAC,MAAM,CAAC,WAAW;QACpB,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;AAC5B,CAAC;AAED,SAAS,KAAK,CAAC,KAA6B,EAAE,GAAW;IACvD,IAAI,KAAK,EAAE,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,GAAG,EAAE,GAAG,yBAAyB,CAAC;AACnE,CAAC;AAkCD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAgB,EAChB,OAA4E,EAC5E,UAA+B,EAAE;IAEjC,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACpE,IAAI,MAAwC,CAAC;IAC7C,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QACzE,CAAC;QACD,uEAAuE;QACvE,MAAM,GAAG;YACP,eAAe,EAAE,GAAG;YACpB,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,GAAG;YACjB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;SAC7C,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,GAAG;gBACZ,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,gBAAgB;gBACxB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAoB;QAC/B,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,KAAK;QAChB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;KAC1E,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;IACzC,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,GAAG,OAAO;gBACV,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,IAAI;gBACZ,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/E,IAAI,OAAO,CAAC,SAAS,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG;YACV,OAAO,EAAE,WAAW;YACpB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;QACF,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgB,EAChB,OAA4E,EAC5E,UAA+B,EAAE;IAEjC,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC7D,GAAG,OAAO;QACV,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO;IACnD,MAAM,IAAI,uBAAuB,CAAC;QAChC,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,aAAa;QACrC,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE,MAAM,EAAE,iCAAiC,KAAK,CAAC,MAAM,gBAAgB,EAAE;YAC3E,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/index.d.ts

@@ -25,7 +25,14 @@ export interface RuntimeVersionOption {
     latest_version: string;
     display_name: string;
     type: "published" | "custom";
+    /** A custom build's own deployment — probed directly, never via the gateway. */
+    custom_link?: string;
 }
+/**
+ * A semantic version's family — major.minor with the patch dropped
+ * ("0.2.5" → "0.2"). Undefined for non-semver values (custom runtime names).
+ */
+export declare function familyOf(value: string): string | undefined;
 /**
  * True when the record names the LEGACY (schema-1) engine — the 1.x family,
  * labelled "v1.0". It only ever serves schema-1 agent versions, so a

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/index.js

@@ -4,7 +4,7 @@ export const RUNTIME_VERSION_HEADER = "runtime-version";
  * A semantic version's family — major.minor with the patch dropped
  * ("0.2.5" → "0.2"). Undefined for non-semver values (custom runtime names).
  */
-function familyOf(value) {
+export function familyOf(value) {
     const match = /^(\d+)\.(\d+)(?:\.\S*)?$/.exec(value.trim());
     return match ? `${match[1]}.${match[2]}` : undefined;
 }
@@ -28,6 +28,7 @@ export function runtimeVersionOptions(records) {
         latest_version: record.latest_version,
         display_name: record.display_name,
         type: record.type,
+        ...(record.custom_link ? { custom_link: record.custom_link } : {}),
     }));
 }
 /**

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/index.js.map

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

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

@@ -3,12 +3,11 @@ import type { Context } from "../config/index.js";
 /**
  * The shipping lane's console half (docs/headless-authoring-design.md §4.5):
  * one instruction against the checkout's PUSHED agent — no files travel, the
- * service pulls the bundle itself — then poll the whole story (turn, certify,
- * optional evaluation, push, optional publish) to its terminal verdict.
+ * service pulls the bundle itself — then poll the whole story (turn, push,
+ * optional publish) to its terminal verdict.
  */
-/** A build turn edits, validates and repairs; certify replays the suite; an
- *  evaluation runs real conversations. Hours-scale, so the poll loop's own
- *  deadline is generous — each poll request stays cheap. */
+/** A build turn edits, validates, repairs and pushes. Hours-scale, so the
+ *  poll loop's own deadline is generous — each poll request stays cheap. */
 export declare const BUILD_DEADLINE_MS: number;
 export interface BuildOptions {
     /** The base to build from — a pushed version's tag (defaults to the pin). */
@@ -17,8 +16,6 @@ export interface BuildOptions {
     message?: string;
     model?: string;
     maxUsd?: number;
-    /** Run the evaluation suite on the settled tree before approving. */
-    evaluate?: boolean;
     /** Flip the agent's active pointer to the pushed revision. */
     publish?: boolean;
     pollIntervalMs?: number;
@@ -30,7 +27,7 @@ export interface BuildOptions {
  * Run one build to its verdict. The POST rides a fresh idempotency key, so a
  * retried request replays the SAME build; the returned view is terminal —
  * `completed` (pushed), `refused` (a gate said no: the turn answered instead
- * of completing, or certify came back red) or `failed` (infra story). The
+ * of completing) or `failed` (infra story). The
  * caller decides what each verdict is worth; this function only refuses to
  * return a non-terminal view.
  */