@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/visualQa/evidenceOverlay.js

@@ -0,0 +1,268 @@
+"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.emptyOverlay = void 0;
+exports.penetrationOverlay = penetrationOverlay;
+exports.wheelSectionOverlay = wheelSectionOverlay;
+exports.overlayPoints = overlayPoints;
+exports.overlaySvg = overlaySvg;
+exports.annotateFrame = annotateFrame;
+// Evidence ANNOTATION: what a measured failure measured, drawn over the captured frame exactly where the geometry is, so
+// a creator sees the clash in the picture itself rather than a caption under an innocent-looking render.
+//
+// Drawn as a 2D layer over the real render (projected through the live camera, `__vqaVeh.project`), not by changing
+// materials in the runtime: a vehicle's parts are drawn by batches whose materials the harness does not own, the
+// renderer may be WebGL2 or WebGPU, and an annotation must show a clash even where it is BURIED (a pedal pad inside a
+// foot draws nothing a camera can see). The layer is exactly the measured geometry:
+//
+//   penetration  the occupant points the measure found inside the cabin (red dots), over the clashing cabin mesh's
+//                triangles around the clash (translucent cyan);
+//   wheel        a cross-section: the tyre's circle (white), the body's section across the tread (yellow), and the
+//                tyre sector the body reaches into, filled red.
+//
+// Pure geometry + SVG here; the browser side is one projection call.
+const sharp_1 = __importDefault(require("sharp"));
+const emptyOverlay = () => ({ polys: [], lines: [], dots: [], legend: [] });
+exports.emptyOverlay = emptyOverlay;
+const sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+const crs = (a, b) => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+const nrm = (a) => { const l = Math.hypot(a[0], a[1], a[2]) || 1; return [a[0] / l, a[1] / l, a[2] / l]; };
+const along = (c, u, w, r, ang) => [
+    c[0] + (u[0] * Math.cos(ang) + w[0] * Math.sin(ang)) * r, c[1] + (u[1] * Math.cos(ang) + w[1] * Math.sin(ang)) * r, c[2] + (u[2] * Math.cos(ang) + w[2] * Math.sin(ang)) * r,
+];
+/** Penetration: the cluster's points red over the clashing mesh's triangles within `reach` of the clash, translucent cyan. */
+function penetrationOverlay(points, centroid, cabin, meshName, legend, reach = 0.3, maxTris = 1500) {
+    const o = (0, exports.emptyOverlay)();
+    if (cabin && meshName) {
+        const mi = new Set();
+        cabin.names.forEach((n, i) => { if (n === meshName)
+            mi.add(i); });
+        const T = cabin.tris;
+        for (let t = 0; t < T.length / 9 && o.polys.length < maxTris; t++) {
+            if (!mi.has(cabin.mesh[t]))
+                continue;
+            const k = t * 9;
+            const tri = [[T[k], T[k + 1], T[k + 2]], [T[k + 3], T[k + 4], T[k + 5]], [T[k + 6], T[k + 7], T[k + 8]]];
+            const cen = [(tri[0][0] + tri[1][0] + tri[2][0]) / 3, (tri[0][1] + tri[1][1] + tri[2][1]) / 3, (tri[0][2] + tri[1][2] + tri[2][2]) / 3];
+            if (Math.hypot(...sub(cen, centroid)) > reach)
+                continue;
+            o.polys.push({ pts: tri, fill: '#28d7ff', opacity: 0.22, stroke: '#28d7ff' });
+        }
+        o.legend.push({ colour: '#28d7ff', text: legend.mesh });
+    }
+    for (const p of points)
+        o.dots.push({ p, r: 3, fill: '#ff2a2a' });
+    o.legend.push({ colour: '#ff2a2a', text: legend.body });
+    return o;
+}
+/**
+ * Wheel cross-section: the tyre circle at its centre plane, the body's section in the plane across the tread where it
+ * reaches deepest into the tyre, and, per 2 degree sector, the part of the tyre the body reaches into in ANY of five
+ * planes across the tread (the arch lip intrudes at the outer shoulder, not at the centre plane), filled red: from the
+ * body's innermost point (outside the rim barrel) out to the tyre's radius. Returns the overlay and the deepest intrusion.
+ */
+function wheelSectionOverlay(centre, axle, radius, bodyTris, hubZoneFraction = 0.72, legend, width = 0) {
+    const o = (0, exports.emptyOverlay)();
+    const a = nrm(axle);
+    const up0 = Math.abs(a[1]) < 0.9 ? [0, 1, 0] : [1, 0, 0];
+    const u = nrm(sub(up0, [a[0] * dot(up0, a), a[1] * dot(up0, a), a[2] * dot(up0, a)]));
+    const w = crs(a, u);
+    const circle = [];
+    for (let i = 0; i <= 120; i++)
+        circle.push(along(centre, u, w, radius, (i / 120) * 2 * Math.PI));
+    const BINS = 180;
+    const minR = new Array(BINS).fill(Infinity);
+    const offsets = width > 0 ? [-0.45, -0.2, 0, 0.2, 0.45].map((k) => k * width) : [0];
+    let bestPlane = { segs: [], depth: -1 };
+    for (const off of offsets) {
+        const pc = [centre[0] + a[0] * off, centre[1] + a[1] * off, centre[2] + a[2] * off];
+        const segs = [];
+        let deepest = 0;
+        for (let t = 0; t < bodyTris.length / 9; t++) {
+            const k = t * 9;
+            const P = [[bodyTris[k], bodyTris[k + 1], bodyTris[k + 2]], [bodyTris[k + 3], bodyTris[k + 4], bodyTris[k + 5]], [bodyTris[k + 6], bodyTris[k + 7], bodyTris[k + 8]]];
+            const d = P.map((p) => dot(sub(p, pc), a));
+            const cut = [];
+            for (let i = 0; i < 3; i++) {
+                const j = (i + 1) % 3;
+                if ((d[i] <= 0 && d[j] > 0) || (d[i] > 0 && d[j] <= 0)) {
+                    const s = d[i] / (d[i] - d[j]);
+                    cut.push([P[i][0] + (P[j][0] - P[i][0]) * s, P[i][1] + (P[j][1] - P[i][1]) * s, P[i][2] + (P[j][2] - P[i][2]) * s]);
+                }
+            }
+            if (cut.length < 2)
+                continue;
+            // the body near the wheel only (a door line a metre away is not the arch)
+            if (!cut.some((p) => Math.hypot(...sub(p, pc)) < radius * 1.3))
+                continue;
+            segs.push(cut);
+            for (let s = 0; s <= 8; s++) {
+                const p = [cut[0][0] + (cut[1][0] - cut[0][0]) * (s / 8), cut[0][1] + (cut[1][1] - cut[0][1]) * (s / 8), cut[0][2] + (cut[1][2] - cut[0][2]) * (s / 8)];
+                const q = sub(p, pc);
+                const r = Math.hypot(...q);
+                if (r < radius * hubZoneFraction || r >= radius)
+                    continue;
+                const ang = Math.atan2(dot(q, w), dot(q, u));
+                const b = Math.floor(((ang + Math.PI) / (2 * Math.PI)) * BINS) % BINS;
+                if (r < minR[b])
+                    minR[b] = r;
+                deepest = Math.max(deepest, radius - r);
+            }
+        }
+        if (deepest > bestPlane.depth)
+            bestPlane = { segs, depth: deepest };
+    }
+    // the section is sampled, so neighbouring sectors can miss a body point the arch certainly has: bridge gaps of up to
+    // 6 degrees between intruding sectors (taking the shallower side), so the overlap reads as one region
+    for (let b = 0; b < BINS; b++) {
+        if (Number.isFinite(minR[b]))
+            continue;
+        let l = -1, r = -1;
+        for (let k = 1; k <= 3; k++) {
+            if (l < 0 && Number.isFinite(minR[(b - k + BINS) % BINS]))
+                l = (b - k + BINS) % BINS;
+            if (r < 0 && Number.isFinite(minR[(b + k) % BINS]))
+                r = (b + k) % BINS;
+        }
+        if (l >= 0 && r >= 0)
+            minR[b] = Math.max(minR[l], minR[r]);
+    }
+    // each sector's body point is a sample of a surface: take the innermost of its +-2 neighbours (4 degrees each way) so
+    // the overlap reads as the band it is, not a comb of sampling noise
+    const smooth = minR.map((v, b) => {
+        if (!Number.isFinite(v))
+            return v;
+        let m = v;
+        for (let k = -2; k <= 2; k++) {
+            const x = minR[(b + k + BINS) % BINS];
+            if (Number.isFinite(x) && x < m)
+                m = x;
+        }
+        return m;
+    });
+    let maxIn = 0, sectors = 0;
+    for (let b = 0; b < BINS; b++) {
+        const r0 = smooth[b];
+        if (!Number.isFinite(r0))
+            continue;
+        sectors++;
+        maxIn = Math.max(maxIn, radius - r0);
+        const a0 = (b / BINS) * 2 * Math.PI - Math.PI, a1 = ((b + 1) / BINS) * 2 * Math.PI - Math.PI;
+        o.polys.push({ pts: [along(centre, u, w, r0, a0), along(centre, u, w, radius, a0), along(centre, u, w, radius, a1), along(centre, u, w, r0, a1)], fill: '#ff1a1a', opacity: 0.85 });
+        // the inner edge of the overlap, so its depth reads against the tyre circle
+        o.lines.push({ pts: [along(centre, u, w, r0, a0), along(centre, u, w, r0, a1)], stroke: '#ff1a1a', width: 3 });
+    }
+    for (const s of bestPlane.segs)
+        o.lines.push({ pts: s, stroke: '#ffd400', width: 2.5 });
+    o.lines.push({ pts: circle, stroke: '#ffffff', width: 3 });
+    o.legend.push({ colour: '#ffffff', text: legend?.tyre ?? 'tyre, at its centre plane' }, { colour: '#ffd400', text: legend?.body ?? 'body, cut across the tread' }, { colour: '#ff1a1a', text: legend?.overlap ?? 'body inside the tyre' });
+    return { overlay: o, maxIntrusionM: Math.round(maxIn * 1e4) / 1e4, sectors };
+}
+/** Every 3D point an overlay needs projected, flat, in a fixed order (see `renderOverlay`). */
+function overlayPoints(o) {
+    const out = [];
+    for (const p of o.polys)
+        for (const q of p.pts)
+            out.push(...q);
+    for (const l of o.lines)
+        for (const q of l.pts)
+            out.push(...q);
+    for (const d of o.dots)
+        out.push(...d.p);
+    return out;
+}
+const escText = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+/** The overlay as an SVG of the captured image's size. Points behind the camera are dropped (and polys touching them). */
+function overlaySvg(o, pr, width, height) {
+    let i = 0;
+    const next = () => {
+        const x = pr.ndc[i * 3], y = pr.ndc[i * 3 + 1], z = pr.ndc[i * 3 + 2];
+        i++;
+        if (!(z > -1 && z < 1))
+            return null;
+        return [(pr.frameOffset.x + pr.rect.left + ((x + 1) / 2) * pr.rect.width) * pr.scale, (pr.frameOffset.y + pr.rect.top + ((1 - y) / 2) * pr.rect.height) * pr.scale];
+    };
+    const parts = [];
+    for (const p of o.polys) {
+        const xy = p.pts.map(next);
+        if (xy.some((v) => !v))
+            continue;
+        parts.push(`<polygon points="${xy.map((v) => `${v[0].toFixed(1)},${v[1].toFixed(1)}`).join(' ')}" fill="${p.fill}" fill-opacity="${p.opacity}"${p.stroke ? ` stroke="${p.stroke}" stroke-opacity="0.6" stroke-width="0.8"` : ''}/>`);
+    }
+    for (const l of o.lines) {
+        const xy = l.pts.map(next).filter((v) => !!v);
+        if (xy.length < 2)
+            continue;
+        parts.push(`<polyline points="${xy.map((v) => `${v[0].toFixed(1)},${v[1].toFixed(1)}`).join(' ')}" fill="none" stroke="#000" stroke-opacity="0.55" stroke-width="${l.width + 2.5}"/>`);
+        parts.push(`<polyline points="${xy.map((v) => `${v[0].toFixed(1)},${v[1].toFixed(1)}`).join(' ')}" fill="none" stroke="${l.stroke}" stroke-width="${l.width}"/>`);
+    }
+    for (const d of o.dots) {
+        const v = next();
+        if (!v)
+            continue;
+        parts.push(`<circle cx="${v[0].toFixed(1)}" cy="${v[1].toFixed(1)}" r="${(d.r * Math.max(1, pr.scale)).toFixed(1)}" fill="${d.fill}" stroke="#600" stroke-width="0.6"/>`);
+    }
+    const fs = Math.round(Math.max(16, width / 60));
+    const lh = Math.round(fs * 1.4);
+    const boxW = Math.min(width - 20, Math.round(fs * 0.58 * Math.max(...o.legend.map((l) => l.text.length), 10) + fs * 3));
+    if (o.legend.length) {
+        parts.push(`<rect x="10" y="10" width="${boxW}" height="${o.legend.length * lh + 14}" rx="6" fill="#000" fill-opacity="0.62"/>`);
+        o.legend.forEach((l, k) => {
+            const y = 10 + 7 + k * lh;
+            parts.push(`<rect x="22" y="${y + lh * 0.2}" width="${fs * 0.9}" height="${fs * 0.9}" fill="${l.colour}"/><text x="${22 + fs * 1.5}" y="${y + lh * 0.8}" font-size="${fs}" fill="#fff" font-family="Helvetica, Arial, DejaVu Sans, sans-serif">${escText(l.text)}</text>`);
+        });
+    }
+    return `<svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">${parts.join('')}</svg>`;
+}
+/** Draw the overlay onto the captured JPEG in place. Returns how many of its points landed in front of the camera. */
+async function annotateFrame(file, o, pr) {
+    const img = (0, sharp_1.default)(file);
+    const meta = await img.metadata();
+    const W = meta.width ?? 0, H = meta.height ?? 0;
+    const svg = overlaySvg(o, pr, W, H);
+    const buf = await (0, sharp_1.default)(file).composite([{ input: Buffer.from(svg), left: 0, top: 0 }]).jpeg({ quality: 88 }).toBuffer();
+    const fsMod = await Promise.resolve().then(() => __importStar(require('node:fs')));
+    fsMod.writeFileSync(file, buf);
+    let drawn = 0;
+    for (let i = 0; i < pr.ndc.length; i += 3)
+        if (pr.ndc[i + 2] > -1 && pr.ndc[i + 2] < 1)
+            drawn++;
+    return { drawn, total: pr.ndc.length / 3 };
+}
+//# sourceMappingURL=evidenceOverlay.js.map

package/dist/visualQa/evidenceOverlay.js.map

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

package/dist/visualQa/harness.d.ts

@@ -0,0 +1,57 @@
+import type { ResolvedItem } from './resolve';
+import type { VisualQaAssert, VisualQaFrame } from './types';
+import type { PreviewCandidate } from './vehiclePreview';
+export interface RenderContext {
+    resolved: ResolvedItem;
+    /** Backend API origin, e.g. https://helix-backend-api-helix3.up.railway.app */
+    apiBase: string;
+    /** Website origin, e.g. https://new.helixgame.com */
+    webBase: string;
+    /** Directory frames are written to (bundle directory). Frame `file` paths are relative to it. */
+    outDir: string;
+    /** Playwright storageState of a signed-in QA account (Try Now and the customiser need one). */
+    storageState?: string;
+    executablePath?: string;
+    /** Restrict to these host/base item ids (add-ons, wearables). Default: every declared host/base. */
+    hostIds?: string[];
+    /** The signed-in account's own copy of the item, when the item is not Published (held for visual QA, delisted): Try Now
+     *  serves such an item only to its owner, from their copy (`&tryInstance=`). */
+    ownedInstanceId?: string | null;
+    /** The world-walk stage (wearables, character add-ons, avatars): false = skipped (`--no-world-walk`). Default on. */
+    worldWalk?: boolean;
+    log: (key: string, value: unknown) => void;
+    /** `helix vehicle preview`: render this on-disk candidate (package + GLB) through the proxy item named by `resolved`
+     *  instead of the proxy's own car. Vehicles only; changes nothing about the published route. */
+    preview?: {
+        candidate: PreviewCandidate;
+        /** Route phases to run (exterior, poses, articulation, steering, cabin, drive, occupants). Default: everything but occupants. */
+        phases?: string[];
+        /** Also render the daylight paint-sample frames (paint/paint.*.jpg: body paint only, lit as Try Now lights it) for the paint gate. */
+        paint?: boolean;
+        /** Also render the candidate's front-left wheel face square-on (wheelface/candidate.jpg: the tyre centred, filling WHEEL_FACE_FILL of the half-height) for the wheel-design gate. */
+        wheelFace?: boolean;
+        /** `--addon`: measure the fitted add-ons only (no boarding, no stance); `baselineOnly` is the stock car's tuning pass
+         *  that the tune-op judgement compares against. */
+        baselineOnly?: boolean;
+        stockTuning?: Record<string, unknown> | null;
+        toleranceCm?: number;
+    };
+}
+export interface RenderResult {
+    route: 'test-grounds' | 'customizer' | 'item-viewer' | 'emote-preview' | 'home-preview';
+    url: string;
+    frames: VisualQaFrame[];
+    asserts: VisualQaAssert[];
+    facts: Record<string, unknown>;
+    subjects: Array<{
+        id: string;
+        title: string;
+        role: 'host' | 'base' | 'addon';
+    }>;
+    /** Anything that prevented a complete, trustworthy render. Non-empty => the run fails closed. */
+    errors: string[];
+    renderer: string | null;
+    engineVersion: string | null;
+    fetchedAssets: string[];
+}
+export type RenderRoute = (ctx: RenderContext) => Promise<RenderResult>;

package/dist/visualQa/harness.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=harness.js.map

package/dist/visualQa/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/visualQa/harness.ts"],"names":[],"mappings":""}

package/dist/visualQa/hosted.d.ts

@@ -0,0 +1,152 @@
+import type { PendingVersion } from './moveUx';
+export type HostedJobStatus = 'queued' | 'rendering' | 'passed' | 'failed' | 'error';
+export interface HostedJob {
+    id: string;
+    itemId: string;
+    packageVersionId: string;
+    manifestCid: string;
+    status: HostedJobStatus;
+    attempts: number;
+    maxAttempts?: number;
+    requestedBy?: string;
+    trigger?: string;
+    queuedAt?: string;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+    leaseExpiresAt?: string | null;
+    runId: string | null;
+    verdict: 'pass' | 'fail' | 'error' | null;
+    contactSheetUrl: string | null;
+    reasons: string[];
+    error: string | null;
+}
+export interface HostedRenderTarget {
+    itemId: string;
+    title: string | null;
+    packageVersionId: string;
+    packageId: string;
+    packageVersion: string;
+    manifestCid: string;
+    category: string;
+    vehicleChecksum: string | null;
+    /** A version move's job: the vehicle package the refused move carried (vehicles), or null. */
+    vehiclePackage?: Record<string, unknown> | null;
+}
+export interface HostedClaim {
+    job: HostedJob;
+    leaseToken: string;
+    target?: HostedRenderTarget;
+}
+export interface HostedRequestResult {
+    alreadyPassed: boolean;
+    exempt: boolean;
+    job: HostedJob | null;
+    skipped?: string;
+    message?: string;
+    retryAfter?: string;
+}
+export declare class HostedApiError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+export declare const isTerminal: (s: HostedJobStatus) => boolean;
+export declare function requestHostedRun(apiBase: string, token: string, itemId: string, retry?: boolean): Promise<HostedRequestResult>;
+/**
+ * `--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.
+ */
+export declare function requestHostedRequeue(apiBase: string, token: string, itemId: string, opts?: {
+    maxWaitMs?: number;
+    onWait?: (line: string) => void;
+    sleepFn?: (ms: number) => Promise<void>;
+    nowFn?: () => number;
+}): Promise<HostedRequestResult>;
+export interface ItemVisualQaStatus {
+    hostedJob: HostedJob | null;
+    currentVersion: {
+        packageVersionId: string;
+        manifestCid: string | null;
+        passed: boolean;
+        runId: string | null;
+    } | null;
+    runs: Array<{
+        id?: string;
+        verdict?: string;
+        createdAt?: string;
+        contactSheetUrl?: string | null;
+        reasons?: string[];
+        packageVersion?: string | null;
+    }>;
+    /** Sealed versions of the item's package that are not current, each with its latest run and hosted job. Absent on a
+     *  backend that does not report them yet. */
+    pendingVersions: PendingVersion[];
+}
+export declare function getItemVisualQaStatus(apiBase: string, itemId: string): Promise<ItemVisualQaStatus>;
+/** One human line for a job, e.g. `rendering (attempt 1/3) — claimed 42 s ago`. */
+export declare function describeJob(job: HostedJob | null, now?: number): string;
+export interface PollOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    onUpdate?: (job: HostedJob) => void;
+}
+/** Poll `GET .../visual-qa` until the job for the item's current version is terminal (or the timeout passes). */
+export declare function waitForHostedJob(apiBase: string, itemId: string, jobId: string | null, opts?: PollOptions): Promise<{
+    job: HostedJob | null;
+    timedOut: boolean;
+}>;
+/** 0 pass, 1 fail, 2 error / anything that is not a judged pass or fail. */
+export declare function exitCodeForJob(job: HostedJob | null, timedOut?: boolean): number;
+/** Sign in as the bot account exactly as the website's login does: POST /auth/login -> access_token. */
+export declare function botLogin(apiBase: string, email: string, password: string): Promise<string>;
+export declare function claimJob(apiBase: string, token: string, worker: string, leaseSeconds?: number): Promise<HostedClaim | null>;
+export declare const heartbeatJob: (apiBase: string, token: string, id: string, leaseToken: string, leaseSeconds?: number) => Promise<{
+    status: number;
+    data: unknown;
+}>;
+/** `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. */
+export declare const failJob: (apiBase: string, token: string, id: string, leaseToken: string, error: string, kind?: "mirror_lag") => Promise<{
+    status: number;
+    data: unknown;
+}>;
+/** The signature of a render that could not fetch the pinned model (the mirror had not caught up). */
+export declare const MODEL_NOT_FETCHED_RE: RegExp;
+export interface WorkerOptions {
+    apiBase: string;
+    webBase: string;
+    email: string;
+    password: string;
+    worker?: string;
+    /** Stop after this many jobs (default: unlimited). */
+    maxJobs?: number;
+    /** Stop claiming new jobs after this long (default: unlimited). */
+    maxMinutes?: number;
+    /** Keep polling an empty queue this long before exiting (0 = exit as soon as the queue is empty). */
+    idleExitMinutes?: number;
+    pollSeconds?: number;
+    /** Pause after reporting a failed render before claiming again, so a persistent failure does not burn every attempt at once (default 60). */
+    failBackoffSeconds?: number;
+    leaseSeconds?: number;
+    /** Hard limit for one render. */
+    renderTimeoutSeconds?: number;
+    out?: string;
+    chrome?: string;
+    cliVersion: string;
+    log?: (line: string) => void;
+}
+export interface WorkerJobResult {
+    jobId: string;
+    itemId: string;
+    outcome: 'submitted' | 'failed_reported' | 'abandoned';
+    verdict?: string;
+    contactSheetUrl?: string;
+    error?: string;
+    seconds: number;
+}
+export interface WorkerSummary {
+    jobs: WorkerJobResult[];
+    exit: 'idle' | 'max_jobs' | 'max_minutes';
+}
+export declare function runHostedWorker(opts: WorkerOptions): Promise<WorkerSummary>;