@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/visualQa/hosted.js

@@ -0,0 +1,367 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_NOT_FETCHED_RE = exports.failJob = exports.heartbeatJob = exports.isTerminal = exports.HostedApiError = void 0;
+exports.requestHostedRun = requestHostedRun;
+exports.requestHostedRequeue = requestHostedRequeue;
+exports.getItemVisualQaStatus = getItemVisualQaStatus;
+exports.describeJob = describeJob;
+exports.waitForHostedJob = waitForHostedJob;
+exports.exitCodeForJob = exitCodeForJob;
+exports.botLogin = botLogin;
+exports.claimJob = claimJob;
+exports.runHostedWorker = runHostedWorker;
+// Hosted visual QA: the backend queues a render of one exact (item, Package Version, manifest); a dedicated GPU runner
+// claims it under a lease, renders with the SAME harness `helix item visual-qa` uses locally, and submits the bundle
+// against the lease. The server still owns the verdict. Wire contract: helix-backend-api
+// src/continuum/visual-qa/hosted-job.types.ts (field names are copied here; the backend may extend them, never break).
+//
+// Two audiences:
+//   - publishers: `helix item visual-qa <id> --hosted` (request + wait) and `--status` (read only);
+//   - the runner:  `helix item visual-qa --hosted-worker` (claim -> heartbeat while rendering -> submit | fail).
+const node_os_1 = __importDefault(require("node:os"));
+const browser_1 = require("./browser");
+const command_1 = require("./command");
+const mirror_1 = require("./mirror");
+class HostedApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+exports.HostedApiError = HostedApiError;
+const TERMINAL = ['passed', 'failed', 'error'];
+const isTerminal = (s) => TERMINAL.includes(s);
+exports.isTerminal = isTerminal;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function call(apiBase, token, method, route, body) {
+    const res = await fetch(`${apiBase.replace(/\/$/, '')}${route}`, {
+        method,
+        headers: { accept: 'application/json', ...(body !== undefined ? { 'content-type': 'application/json' } : {}), ...(token ? { authorization: `Bearer ${token}` } : {}) },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+        signal: AbortSignal.timeout(60_000),
+    });
+    const text = await res.text();
+    let data = {};
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch {
+        data = { raw: text.slice(0, 300) };
+    }
+    if (!res.ok) {
+        const msg = data?.message;
+        throw new HostedApiError(res.status, `${method} ${route} → ${res.status}: ${typeof msg === 'string' ? msg : JSON.stringify(msg ?? data).slice(0, 400)}`);
+    }
+    return { status: res.status, data: data };
+}
+// ---------------------------------------------------------------------------------------------------------------
+// Publisher side
+// ---------------------------------------------------------------------------------------------------------------
+async function requestHostedRun(apiBase, token, itemId, retry = false) {
+    return (await call(apiBase, token, 'POST', `/api/v1/universal-items/${itemId}/visual-qa/request`, retry ? { retry: true } : {})).data;
+}
+/**
+ * `--retry` (requeue): ask for another render of a version whose hosted job ended failed/error (an exhausted job included:
+ * the new job starts again at attempt 1). The backend allows one requeue per cooldown after the last job finished and
+ * answers `skipped: retry_too_soon` + `retryAfter` inside it; this waits that out (bounded by `maxWaitMs`) and asks again
+ * instead of leaving the caller looking at the old, finished job.
+ */
+async function requestHostedRequeue(apiBase, token, itemId, opts = {}) {
+    const sleepFn = opts.sleepFn ?? sleep;
+    const nowFn = opts.nowFn ?? Date.now;
+    let req = await requestHostedRun(apiBase, token, itemId, true);
+    if (req.skipped === 'retry_too_soon' && req.retryAfter) {
+        const waitMs = Math.max(0, Date.parse(req.retryAfter) - nowFn()) + 1_000;
+        if (Number.isFinite(waitMs) && waitMs <= (opts.maxWaitMs ?? 15 * 60_000)) {
+            opts.onWait?.(`requeue cooldown: the last render finished recently; asking again at ${req.retryAfter} (in ${Math.ceil(waitMs / 1000)} s)`);
+            await sleepFn(waitMs);
+            req = await requestHostedRun(apiBase, token, itemId, true);
+        }
+    }
+    return req;
+}
+async function getItemVisualQaStatus(apiBase, itemId) {
+    const { data } = await call(apiBase, null, 'GET', `/api/v1/universal-items/${itemId}/visual-qa`);
+    return { hostedJob: data.hostedJob ?? null, currentVersion: data.currentVersion ?? null, runs: data.runs ?? [], pendingVersions: Array.isArray(data.pendingVersions) ? data.pendingVersions : [] };
+}
+/** One human line for a job, e.g. `rendering (attempt 1/3) — claimed 42 s ago`. */
+function describeJob(job, now = Date.now()) {
+    if (!job)
+        return 'no hosted job';
+    const parts = [job.status];
+    if (job.status === 'queued' && job.queuedAt)
+        parts.push(`waiting ${Math.max(0, Math.round((now - Date.parse(job.queuedAt)) / 1000))} s`);
+    if (job.status === 'rendering' && job.startedAt)
+        parts.push(`started ${Math.max(0, Math.round((now - Date.parse(job.startedAt)) / 1000))} s ago`);
+    if (job.attempts)
+        parts.push(`attempt ${job.attempts}${job.maxAttempts ? `/${job.maxAttempts}` : ''}`);
+    if (job.verdict)
+        parts.push(`verdict ${job.verdict}`);
+    return parts.join(' · ');
+}
+/** Poll `GET .../visual-qa` until the job for the item's current version is terminal (or the timeout passes). */
+async function waitForHostedJob(apiBase, itemId, jobId, opts = {}) {
+    const interval = opts.intervalMs ?? 5000;
+    const deadline = Date.now() + (opts.timeoutMs ?? 30 * 60_000);
+    let last = '';
+    let job = null;
+    while (Date.now() < deadline) {
+        const status = await getItemVisualQaStatus(apiBase, itemId).catch((e) => { if (e instanceof HostedApiError && e.status < 500)
+            throw e; return null; });
+        job = status?.hostedJob ?? job;
+        if (job && (!jobId || job.id === jobId)) {
+            const key = `${job.status}/${job.attempts}`;
+            if (key !== last) {
+                last = key;
+                opts.onUpdate?.(job);
+            }
+            if ((0, exports.isTerminal)(job.status))
+                return { job, timedOut: false };
+        }
+        await sleep(interval);
+    }
+    return { job, timedOut: true };
+}
+/** 0 pass, 1 fail, 2 error / anything that is not a judged pass or fail. */
+function exitCodeForJob(job, timedOut = false) {
+    if (timedOut || !job)
+        return 2;
+    if (job.status === 'passed')
+        return 0;
+    if (job.status === 'failed')
+        return 1;
+    return 2;
+}
+// ---------------------------------------------------------------------------------------------------------------
+// Runner side
+// ---------------------------------------------------------------------------------------------------------------
+/** Sign in as the bot account exactly as the website's login does: POST /auth/login -> access_token. */
+async function botLogin(apiBase, email, password) {
+    const { data } = await call(apiBase, null, 'POST', '/auth/login', { email, password });
+    if (!data.access_token)
+        throw new Error('login returned no access token');
+    return data.access_token;
+}
+async function claimJob(apiBase, token, worker, leaseSeconds) {
+    const { status, data } = await call(apiBase, token, 'POST', '/api/v1/visual-qa/jobs/claim', { worker, ...(leaseSeconds ? { leaseSeconds } : {}) });
+    if (status === 204 || !data?.job)
+        return null;
+    return data;
+}
+const heartbeatJob = (apiBase, token, id, leaseToken, leaseSeconds) => call(apiBase, token, 'POST', `/api/v1/visual-qa/jobs/${id}/heartbeat`, { leaseToken, ...(leaseSeconds ? { leaseSeconds } : {}) });
+exports.heartbeatJob = heartbeatJob;
+/** `kind: 'mirror_lag'` tells the backend the render never started because the CDN mirror did not serve the model yet: the
+ *  attempt is handed back (it says nothing about the item). Any other failure uses an attempt, as before. */
+const failJob = (apiBase, token, id, leaseToken, error, kind) => call(apiBase, token, 'POST', `/api/v1/visual-qa/jobs/${id}/fail`, { leaseToken, error: error.slice(0, 2000) || 'unknown error', ...(kind ? { kind } : {}) });
+exports.failJob = failJob;
+/** The signature of a render that could not fetch the pinned model (the mirror had not caught up). */
+exports.MODEL_NOT_FETCHED_RE = /no fetched asset URL contains|rendered bytes are not the pinned model|never presented/i;
+const TOKEN_MAX_AGE_MS = 40 * 60_000; // access tokens last an hour
+async function runHostedWorker(opts) {
+    const log = opts.log ?? ((l) => console.error(`[vqa-worker] ${l}`));
+    const worker = opts.worker ?? `${node_os_1.default.hostname()}-${process.pid}`;
+    const poll = Math.max(1, opts.pollSeconds ?? 10) * 1000;
+    const startedAt = Date.now();
+    const results = [];
+    let token = '';
+    let tokenAt = 0;
+    const ensureToken = async (force = false) => {
+        if (force || !token || Date.now() - tokenAt > TOKEN_MAX_AGE_MS) {
+            token = await botLogin(opts.apiBase, opts.email, opts.password);
+            tokenAt = Date.now();
+            log('signed in as the runner account');
+        }
+        return token;
+    };
+    try {
+        const { sweepStaleWindowsChromes, windowsInteropAvailable } = await Promise.resolve().then(() => __importStar(require('./winChrome')));
+        if (windowsInteropAvailable()) {
+            const reaped = sweepStaleWindowsChromes(); // a previous worker that died mid-render may have left a Chrome behind
+            if (reaped)
+                log(`reaped ${reaped} Windows Chrome left by a dead worker`);
+        }
+    }
+    catch { /* best effort */ }
+    // Preflight: launch the render browser once and run its WebGPU self-test BEFORE claiming anything. A host on a build
+    // with a broken shader compiler then exits here with the reason, instead of burning every job's attempts on errors.
+    const browser = await (0, browser_1.preflightVqaBrowser)({ executablePath: opts.chrome });
+    log(`render browser ${browser.name} ${browser.version ?? '?'} (${browser.channel}${browser.executablePath ? `, ${browser.executablePath}` : ''}); WebGPU self-test ${browser.webgpu?.selfTest ?? '?'}${browser.webgpu?.adapter ? ` on ${browser.webgpu.adapter}` : ''}`);
+    let idleSince = null;
+    for (;;) {
+        if (opts.maxJobs && results.length >= opts.maxJobs)
+            return { jobs: results, exit: 'max_jobs' };
+        if (opts.maxMinutes && Date.now() - startedAt > opts.maxMinutes * 60_000)
+            return { jobs: results, exit: 'max_minutes' };
+        let claim;
+        try {
+            claim = await claimJob(opts.apiBase, await ensureToken(), worker, opts.leaseSeconds);
+        }
+        catch (e) {
+            if (e instanceof HostedApiError && e.status === 401) {
+                token = '';
+                await sleep(1000);
+                continue;
+            }
+            if (e instanceof HostedApiError && e.status < 500 && e.status !== 429)
+                throw e; // 403 = not a runner account: do not spin
+            log(`claim failed (${e.message.slice(0, 160)}); retrying`);
+            await sleep(poll);
+            continue;
+        }
+        if (!claim) {
+            idleSince ??= Date.now();
+            if (Date.now() - idleSince >= (opts.idleExitMinutes ?? 0) * 60_000)
+                return { jobs: results, exit: 'idle' };
+            await sleep(poll);
+            continue;
+        }
+        idleSince = null;
+        const done = await processClaim(opts, claim, ensureToken, log);
+        results.push(done);
+        if (done.outcome !== 'submitted') {
+            const wait = opts.failBackoffSeconds ?? 60;
+            if (wait > 0) {
+                log(`backing off ${wait} s after a failed render`);
+                await sleep(wait * 1000);
+            }
+        }
+    }
+}
+async function processClaim(opts, claim, ensureToken, log) {
+    const { job, leaseToken } = claim;
+    const t0 = Date.now();
+    const seconds = () => Math.round((Date.now() - t0) / 1000);
+    log(`claimed job ${job.id} item ${job.itemId} (attempt ${job.attempts}${job.maxAttempts ? `/${job.maxAttempts}` : ''}${claim.target?.title ? `, ${claim.target.title}` : ''})`);
+    const leaseSeconds = opts.leaseSeconds ?? 900;
+    let leaseLost = false;
+    const hb = setInterval(() => {
+        void (async () => {
+            try {
+                await (0, exports.heartbeatJob)(opts.apiBase, await ensureToken(), job.id, leaseToken, leaseSeconds);
+            }
+            catch (e) {
+                if (e instanceof HostedApiError && (e.status === 403 || e.status === 404 || e.status === 409 || e.status === 410))
+                    leaseLost = true;
+                log(`heartbeat failed (${e.message.slice(0, 120)})`);
+            }
+        })();
+    }, Math.max(15, Math.floor(leaseSeconds / 4)) * 1000);
+    let modelCid = null;
+    const report = async (error, kind) => {
+        // A render that could not fetch the pinned model is a mirror problem, not a verdict on the item, when the model is
+        // public on the API but the CDN still does not serve it: hand the attempt back instead of burning it.
+        if (!kind && modelCid && exports.MODEL_NOT_FETCHED_RE.test(error)) {
+            try {
+                const { state } = await (0, mirror_1.probeMirror)(opts.apiBase, modelCid);
+                if (state === 'lagging')
+                    kind = 'mirror_lag';
+                // Say what was checked, so the next reader does not have to guess whether this was the mirror.
+                else if (state === 'served')
+                    error = `${error} | mirror check after the failure: the CDN serves the pinned model, so this is not mirror lag`;
+            }
+            catch { /* a normal failure */ }
+        }
+        log(`job ${job.id} failed${kind ? ' (mirror lag: attempt handed back)' : ''}: ${error.slice(0, 200)}`);
+        if (leaseLost)
+            return { jobId: job.id, itemId: job.itemId, outcome: 'abandoned', error, seconds: seconds() };
+        try {
+            await (0, exports.failJob)(opts.apiBase, await ensureToken(), job.id, leaseToken, error, kind);
+            return { jobId: job.id, itemId: job.itemId, outcome: 'failed_reported', error, seconds: seconds() };
+        }
+        catch (e) {
+            return { jobId: job.id, itemId: job.itemId, outcome: 'abandoned', error: `${error} (and /fail failed: ${e.message.slice(0, 120)})`, seconds: seconds() };
+        }
+    };
+    const limitMs = (opts.renderTimeoutSeconds ?? 900) * 1000;
+    let timer;
+    (0, browser_1.resetBrowserAbort)();
+    try {
+        const run = {
+            apiBase: opts.apiBase,
+            webBase: opts.webBase,
+            token: await ensureToken(),
+            submit: true,
+            out: opts.out ? `${opts.out}/${job.id}` : undefined,
+            chrome: opts.chrome,
+            cliVersion: opts.cliVersion,
+            lease: { jobId: job.id, leaseToken },
+            // The job names the version to judge. When the item already points at it this is the normal run; when it does not
+            // (a refused version move), the harness asks Try Now / the customiser for that exact sealed version.
+            packageVersion: claim.target?.packageVersion ?? null,
+            vehiclePackage: claim.target?.vehiclePackage ?? null,
+            onResolved: (resolved) => {
+                modelCid = resolved.modelCid;
+                // Same version the job was queued for? The manifest CID is the exact-content identity (the item JSON does not
+                // always carry the Package Version row id, so never gate on that being present).
+                const id = resolved.identity;
+                const hex = (cid) => (cid ? (/([0-9a-f]{64})$/i.exec(cid)?.[1]?.toLowerCase() ?? cid) : null);
+                const want = hex(job.manifestCid);
+                const have = hex(id.manifestCid);
+                const versionMoved = (want && have && want !== have)
+                    || (claim.target?.packageVersion && id.packageVersion && claim.target.packageVersion !== id.packageVersion)
+                    || (job.packageVersionId && id.packageVersionId && job.packageVersionId !== id.packageVersionId);
+                if (versionMoved) {
+                    throw new Error(`the item moved to a newer Package Version since the job was queued (job ${claim.target?.packageVersion ?? job.packageVersionId} ${job.manifestCid}, item now ${id.packageVersion ?? id.packageVersionId} ${id.manifestCid}); nothing rendered`);
+                }
+            },
+        };
+        const watchdog = new Promise((_, reject) => {
+            timer = setTimeout(() => { void (0, browser_1.abortAllBrowsers)().finally(() => reject(new Error(`render exceeded the ${Math.round(limitMs / 1000)} s watchdog`))); }, limitMs);
+        });
+        const outcome = await Promise.race([(0, command_1.runVisualQa)(job.itemId, run), watchdog]);
+        if (outcome.submitSkipped) {
+            const why = outcome.bundle.errors.length ? outcome.bundle.errors.join(' | ') : outcome.submitSkipped === 'exempt' ? 'item is exempt (nothing to render)' : 'the harness produced no frames';
+            return await report(`${outcome.submitSkipped}: ${why}`);
+        }
+        const server = outcome.server;
+        log(`job ${job.id} recorded: ${outcome.verdict}${server?.contactSheetUrl ? ` ${server.contactSheetUrl}` : ''} (${seconds()} s, renderer ${outcome.bundle.harness.renderer ?? '?'}, browser ${outcome.bundle.harness.browser?.version ?? '?'})`);
+        return { jobId: job.id, itemId: job.itemId, outcome: 'submitted', verdict: outcome.verdict, contactSheetUrl: server?.contactSheetUrl, seconds: seconds() };
+    }
+    catch (e) {
+        return await report(String(e?.message ?? e), e instanceof mirror_1.MirrorLagError ? 'mirror_lag' : undefined);
+    }
+    finally {
+        clearInterval(hb);
+        if (timer)
+            clearTimeout(timer);
+        await (0, browser_1.abortAllBrowsers)().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=hosted.js.map

package/dist/visualQa/hosted.js.map

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

package/dist/visualQa/labelLimit.d.ts

@@ -0,0 +1,12 @@
+export declare const FRAME_LABEL_MAX = 300;
+/**
+ * Truncate a frame caption to the backend's limit, deterministically.
+ * A cut is marked with a trailing ellipsis; the result is 298 characters
+ * (`FRAME_LABEL_MAX - 3` kept + the ellipsis), safely under the cap and never
+ * left looking like the caption simply ended.
+ */
+export declare function capFrameLabel(label: string): string;
+/** Cap every frame's `label` in place-free fashion, leaving all other fields untouched. */
+export declare function capFrameLabels<T extends {
+    label: string;
+}>(frames: readonly T[]): T[];

package/dist/visualQa/labelLimit.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRAME_LABEL_MAX = void 0;
+exports.capFrameLabel = capFrameLabel;
+exports.capFrameLabels = capFrameLabels;
+// One frame caption, capped so it can never fail the whole visual-QA submit.
+//
+// The backend validates every frame with `str(raw.label, 'frames[i].label', 300)` and rejects a longer
+// one with a 422, which discards the ENTIRE submission — no verdict is ever recorded, so a finished
+// item can never be listed. Authored captions interpolate the item and host titles (e.g.
+// "<item> fitted to <host> — rear three-quarter"), so a long pair of titles pushes a label past the
+// limit. Rather than police every authoring site, cap once here, where the bundle is assembled — before
+// it is written to disk, handed to the critic, drawn on the contact sheet, or submitted (local CLI and
+// the hosted worker both render through `runVisualQa`, so this is the single choke point).
+exports.FRAME_LABEL_MAX = 300;
+/**
+ * Truncate a frame caption to the backend's limit, deterministically.
+ * A cut is marked with a trailing ellipsis; the result is 298 characters
+ * (`FRAME_LABEL_MAX - 3` kept + the ellipsis), safely under the cap and never
+ * left looking like the caption simply ended.
+ */
+function capFrameLabel(label) {
+    if (label.length <= exports.FRAME_LABEL_MAX)
+        return label;
+    return `${label.slice(0, exports.FRAME_LABEL_MAX - 3)}…`;
+}
+/** Cap every frame's `label` in place-free fashion, leaving all other fields untouched. */
+function capFrameLabels(frames) {
+    return frames.map((frame) => frame.label.length <= exports.FRAME_LABEL_MAX ? frame : { ...frame, label: capFrameLabel(frame.label) });
+}
+//# sourceMappingURL=labelLimit.js.map

package/dist/visualQa/labelLimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labelLimit.js","sourceRoot":"","sources":["../../src/visualQa/labelLimit.ts"],"names":[],"mappings":";;;AAiBA,sCAGC;AAGD,wCAIC;AA3BD,6EAA6E;AAC7E,EAAE;AACF,uGAAuG;AACvG,oGAAoG;AACpG,yFAAyF;AACzF,oGAAoG;AACpG,wGAAwG;AACxG,uGAAuG;AACvG,2FAA2F;AAC9E,QAAA,eAAe,GAAG,GAAG,CAAC;AAEnC;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,CAAC,MAAM,IAAI,uBAAe;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAe,GAAG,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,2FAA2F;AAC3F,SAAgB,cAAc,CAA8B,MAAoB;IAC9E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,uBAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAChG,CAAC;AACJ,CAAC"}

package/dist/visualQa/mirror.d.ts

@@ -0,0 +1,36 @@
+export declare const MIRROR_WAIT_DEFAULT_MS: number;
+export declare class MirrorLagError extends Error {
+    readonly sha: string;
+    readonly waitedMs: number;
+    readonly origins: string[];
+    readonly code = "mirror_lag";
+    constructor(sha: string, waitedMs: number, origins: string[]);
+}
+export interface MirrorDeps {
+    /** HEAD/GET probe; returns the HTTP status (0 on a network error). */
+    probe?: (url: string) => Promise<number>;
+    origins?: (apiBase: string) => Promise<string[]>;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+export declare const mirrorUrl: (origin: string, sha: string) => string;
+export declare const publicApiObjectUrl: (apiBase: string, sha: string) => string;
+export type MirrorState = 'served' | 'lagging' | 'not-public' | 'no-mirror';
+/** One look: does any CDN origin serve the model (`served`), or is it public on the API but not yet mirrored (`lagging`)? */
+export declare function probeMirror(apiBase: string, cidOrSha: string, deps?: MirrorDeps): Promise<{
+    state: MirrorState;
+    origins: string[];
+}>;
+/**
+ * Wait until the CDN mirror serves `cidOrSha`, up to `timeoutMs`. Returns when served, when there is nothing to wait for
+ * (`not-public`, `no-mirror`), and throws `MirrorLagError` when the mirror never caught up.
+ */
+export declare function waitForMirror(apiBase: string, cidOrSha: string, opts?: {
+    timeoutMs?: number;
+    log?: (line: string) => void;
+} & MirrorDeps): Promise<{
+    state: MirrorState;
+    waitedMs: number;
+}>;
+/** Categories whose model is a public, CDN-served GLB (a private avatar's is read through a signed URL, never the mirror). */
+export declare const MIRROR_WAIT_CATEGORIES: Set<string>;

package/dist/visualQa/mirror.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIRROR_WAIT_CATEGORIES = exports.publicApiObjectUrl = exports.mirrorUrl = exports.MirrorLagError = exports.MIRROR_WAIT_DEFAULT_MS = void 0;
+exports.probeMirror = probeMirror;
+exports.waitForMirror = waitForMirror;
+/**
+ * CDN mirror readiness for a visual-QA render.
+ *
+ * A freshly sealed model is public on the API's own object route at once, but the runtime fetches it from the uni-items
+ * CDN mirror (`<origin>/content/sha256/<2hex>/<sha>`), which can lag the seal by minutes. A render that starts before the
+ * mirror serves the bytes never presents the item and reports "no fetched asset URL contains <sha>" - and a hosted job
+ * used to burn one of its three attempts on that. So before a render spends anything, wait (bounded, with backoff) until
+ * the mirror actually serves the pinned model, and report a mirror that never caught up as its own failure class
+ * (`MirrorLagError`, wire kind `mirror_lag`) that the backend does not count as an attempt.
+ *
+ * Only a PUBLIC object can be waited for: when the API's public object route does not serve the sha either, the Package
+ * is private (a private avatar, a held item) and the mirror was never going to; nothing is waited for.
+ */
+const platform_1 = require("../vehicle/platform");
+exports.MIRROR_WAIT_DEFAULT_MS = 10 * 60_000;
+const BACKOFF_MS = [2_000, 4_000, 8_000, 15_000, 30_000];
+class MirrorLagError extends Error {
+    sha;
+    waitedMs;
+    origins;
+    code = 'mirror_lag';
+    constructor(sha, waitedMs, origins) {
+        super(`mirror_lag: the CDN mirror (${origins.join(', ') || 'none'}) still does not serve sha256:${sha} after ${Math.round(waitedMs / 1000)} s although the API serves it publicly; nothing was rendered, so no attempt is used. Re-run in a few minutes.`);
+        this.sha = sha;
+        this.waitedMs = waitedMs;
+        this.origins = origins;
+    }
+}
+exports.MirrorLagError = MirrorLagError;
+const realProbe = async (url) => {
+    try {
+        const head = await fetch(url, { method: 'HEAD', redirect: 'follow', signal: AbortSignal.timeout(20_000), headers: { 'user-agent': 'helix-cli vqa-mirror' } });
+        if (head.status !== 405 && head.status !== 501)
+            return head.status;
+        const ranged = await fetch(url, { method: 'GET', redirect: 'follow', signal: AbortSignal.timeout(20_000), headers: { range: 'bytes=0-0', 'user-agent': 'helix-cli vqa-mirror' } });
+        await ranged.body?.cancel().catch(() => undefined);
+        return ranged.status === 206 ? 200 : ranged.status;
+    }
+    catch {
+        return 0;
+    }
+};
+const sleepReal = (ms) => new Promise((r) => setTimeout(r, ms));
+const sha256Of = (cidOrSha) => /([0-9a-f]{64})$/i.exec(cidOrSha)?.[1]?.toLowerCase() ?? null;
+const mirrorUrl = (origin, sha) => `${origin.replace(/\/$/, '')}/content/sha256/${sha.slice(0, 2)}/${sha}`;
+exports.mirrorUrl = mirrorUrl;
+const publicApiObjectUrl = (apiBase, sha) => `${apiBase.replace(/\/$/, '')}/api/v1/continuum/public/objects/${encodeURIComponent(`cid:sha256:${sha}`)}`;
+exports.publicApiObjectUrl = publicApiObjectUrl;
+/** One look: does any CDN origin serve the model (`served`), or is it public on the API but not yet mirrored (`lagging`)? */
+async function probeMirror(apiBase, cidOrSha, deps = {}) {
+    const sha = sha256Of(cidOrSha);
+    if (!sha)
+        return { state: 'not-public', origins: [] };
+    const probe = deps.probe ?? realProbe;
+    const origins = await (deps.origins ?? ((b) => (0, platform_1.contentOrigins)(b)))(apiBase).catch(() => []);
+    if (!origins.length)
+        return { state: 'no-mirror', origins };
+    for (const origin of origins)
+        if (await probe((0, exports.mirrorUrl)(origin, sha)) === 200)
+            return { state: 'served', origins };
+    return { state: (await probe((0, exports.publicApiObjectUrl)(apiBase, sha))) === 200 ? 'lagging' : 'not-public', origins };
+}
+/**
+ * Wait until the CDN mirror serves `cidOrSha`, up to `timeoutMs`. Returns when served, when there is nothing to wait for
+ * (`not-public`, `no-mirror`), and throws `MirrorLagError` when the mirror never caught up.
+ */
+async function waitForMirror(apiBase, cidOrSha, opts = {}) {
+    const now = opts.now ?? Date.now;
+    const sleep = opts.sleep ?? sleepReal;
+    const timeoutMs = opts.timeoutMs ?? (Number(process.env.HELIX_VQA_MIRROR_WAIT_SECONDS) > 0 ? Number(process.env.HELIX_VQA_MIRROR_WAIT_SECONDS) * 1000 : exports.MIRROR_WAIT_DEFAULT_MS);
+    const sha = sha256Of(cidOrSha);
+    const started = now();
+    let announcedAt = -Infinity;
+    for (let attempt = 0;; attempt += 1) {
+        const { state, origins } = await probeMirror(apiBase, cidOrSha, opts);
+        const waitedMs = now() - started;
+        if (state !== 'lagging') {
+            if (attempt > 0 && state === 'served')
+                opts.log?.(`mirror: the CDN now serves sha256:${sha?.slice(0, 12)}… (waited ${Math.round(waitedMs / 1000)} s)`);
+            return { state, waitedMs };
+        }
+        if (waitedMs >= timeoutMs)
+            throw new MirrorLagError(sha ?? cidOrSha, waitedMs, origins);
+        if (waitedMs - announcedAt >= 60_000 || attempt === 0) {
+            announcedAt = waitedMs;
+            opts.log?.(`mirror: waiting for the CDN mirror (${origins.join(', ')}) to serve sha256:${sha?.slice(0, 12)}…; it is public on the API but not mirrored yet (${Math.round(waitedMs / 1000)} s of ${Math.round(timeoutMs / 1000)} s)`);
+        }
+        await sleep(Math.min(BACKOFF_MS[Math.min(attempt, BACKOFF_MS.length - 1)], Math.max(1, timeoutMs - waitedMs)));
+    }
+}
+/** Categories whose model is a public, CDN-served GLB (a private avatar's is read through a signed URL, never the mirror). */
+exports.MIRROR_WAIT_CATEGORIES = new Set(['vehicle', 'vehicle-addon', 'character-addon', 'wearable', 'prop']);
+//# sourceMappingURL=mirror.js.map

package/dist/visualQa/mirror.js.map

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

package/dist/visualQa/moveUx.d.ts

@@ -0,0 +1,44 @@
+export declare const VISUAL_QA_CANDIDATE_FORBIDDEN = "VISUAL_QA_CANDIDATE_FORBIDDEN";
+/** The one paragraph `item visual-qa --help`, `item set-version --help` and `item publish-version --help` carry. */
+export declare const VERSION_MOVE_FLOW_HELP: string;
+/** `helix item set-version …` for a version that just passed, ready to paste. */
+export declare function setVersionCommand(itemId: string, packageVersion: string): string;
+/** What to print after a candidate run that was submitted and passed. Empty when there is nothing to say. */
+export declare function nextStepAfterPass(input: {
+    itemId: string;
+    packageVersion?: string | null;
+    candidate: boolean;
+    submitted: boolean;
+    verdict: string;
+    vehiclePackageFile?: string | null;
+}): string[];
+export declare function candidateForbiddenMessage(itemId: string, version: string): string;
+/** The 403 the backend answers a non-owner's candidate request with, as seen by the browser routes (`{status, body}`). */
+export declare function isCandidateForbidden(raw: unknown): boolean;
+/** Put the forbidden refusal first: it explains every other symptom (the page's vague "ITEM TRIAL UNAVAILABLE", missing frames). */
+export declare function orderCandidateErrors(routeErrors: string[], candidateErrors: string[]): string[];
+export declare function versionNotFoundMessage(input: {
+    packageId: string;
+    version: string;
+    sealed: string[] | null;
+}): string;
+/** Sealed (or superseded) version strings from the owner's package-version listing, newest first as served. */
+export declare function sealedVersionsFrom(body: unknown): string[] | null;
+export interface PendingVersion {
+    packageVersion: string;
+    packageVersionId?: string;
+    manifestCid?: string | null;
+    latestRun?: {
+        runId?: string | null;
+        verdict?: string | null;
+        contactSheetUrl?: string | null;
+        createdAt?: string | null;
+    } | null;
+    hostedJob?: {
+        id?: string;
+        status?: string;
+        attempts?: number;
+    } | null;
+}
+/** `--status` lines for the backend's `pendingVersions` (sealed versions of the item's package that are not current). */
+export declare function describePendingVersions(itemId: string, pending: PendingVersion[] | null | undefined): string[];