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

package/dist/vehicle/previewSeats.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Preview boarding with the CANDIDATE's own seat ids.
+ *
+ * `helix vehicle preview` draws and drives the candidate in the real runtime, but the room that hosts the Try Now car reserved its
+ * entity from the STAND-IN (proxy) car: its seat vars, its module identity, its action table. The client, which runs the candidate's
+ * package, asks for a seat in the candidate's vocabulary (its `seatVars` key, its enter-seat function). The room only knows the
+ * stand-in's, so a candidate whose seat keys differ ("driver" against the stand-in's "seat_dside_f") was refused with
+ * "E pressed, not seated" — the preview then reported it could not board, which is a statement about the stand-in, not the candidate.
+ *
+ * The fix is a translation at the one place the two vocabularies meet — the client's room send — and only for the four seat
+ * intents (enter a seat, enter the driver's seat, exit a seat, exit the driver's seat):
+ *
+ *   candidate cabin seat (read off the candidate GLB's `seat_*` nodes) -> the candidate's seat key (its manifest, as the engine
+ *   resolves it) -> the STAND-IN's key for the same physical seat -> sent under the stand-in's module identity and function.
+ *
+ * What the avatar sits in is still the candidate's seat: the engine adopts the grant against the candidate's cabin, and the summary
+ * records both vocabularies, the seat actually used, and every translated send. When the vocabularies already agree nothing is
+ * rewritten and the summary says so.
+ *
+ * SEATS THE STAND-IN ROOM DOES NOT HAVE (every rear seat, whatever the stand-in car is). The room's seat table is server-owned and
+ * comes from the stand-in's package, so a 2+2 or a four-seater candidate used to be refused at its rear seats ("the stand-in room only
+ * has front seats") and only a hosted run could judge a rear occupant. The room's seat table is synthesised on the CLIENT for those
+ * seats: the hook adds the candidate's own seat key to the Try Now vehicle's replicated seat map in this page's room state and
+ * fills it with this session when the avatar asks for the seat (E), clears it when the avatar asks to leave. From there the engine's
+ * own custody path runs unchanged (the grant is read off the room state, the rig seats the occupant in the candidate's cabin), so the
+ * rear occupant is drawn, measured and judged exactly like a front one. Nothing is sent to the room for such a seat, and nobody else in the
+ * room sees it: a preview is single-client, and the summary says which seats were granted this way.
+ *
+ * Pure parts (vocabularies, bridge table) are here and unit-tested; the page-side hook is `INSTALL_SEAT_BRIDGE`.
+ */
+import type { Json } from '../visualQa/vehiclePreview';
+export declare const isSeatId: (id: string) => boolean;
+/** Only the driver's front seat drives (the engine's `seatRole`). */
+export declare const DRIVER_CABIN_SEAT_ID = "seat_dside_f";
+export interface SeatManifest {
+    /** `module.seatVars`: the manifest's own seat key -> the room's ref var for it. */
+    seatVars: Record<string, string>;
+    /** `module.driverSeat`: which seatVars key is the driver's (absent: the literal key "driver"). */
+    driverSeat: string | null;
+    module: {
+        id: string | null;
+        bundleId: string | null;
+        bundleChecksumSha256: string | null;
+    };
+    /** Declared action functions by control kind (enter-seat, exit-seat, enter-driver, exit-driver). */
+    calls: Partial<Record<'enter-seat' | 'exit-seat' | 'enter-driver' | 'exit-driver', string>>;
+    /** true when the package declares no `specialty` (the platform's default controls apply, which only the engine can spell out). */
+    platformDefault: boolean;
+}
+/** The seat vocabulary a vehicle package declares. A package with no `specialty` has the platform default (reported as such). */
+export declare function seatManifestOf(pkg: Json): SeatManifest;
+/** The manifest key that addresses a cabin seat (the engine's `seatVarsKeyFor`): the id itself, else the legacy driver / passenger role key. */
+export declare function seatKeyFor(m: Pick<SeatManifest, 'seatVars' | 'driverSeat'>, cabinSeatId: string): string | undefined;
+/** The cabin seat a manifest key stands for (the engine's `cabinSeatIdFor`). */
+export declare function cabinSeatOf(m: Pick<SeatManifest, 'seatVars' | 'driverSeat'>, key: string): string | undefined;
+/** `seat_*` node names of a GLB, in canonical order (front row first, driver's side first): the candidate's physical seats. */
+export declare function glbSeatNodes(nodeNames: readonly string[]): string[];
+export interface SeatBridgeTable {
+    /** What the stand-in room understands. Null when the stand-in declares no specialty (its default controls are the engine's, so no table can be built here). */
+    proxy: {
+        moduleId: string;
+        bundleId: string | null;
+        bundleChecksumSha256: string;
+        revision: number;
+        calls: SeatManifest['calls'];
+        seatKeyForCabin: Record<string, string>;
+    } | null;
+    /** Cabin seat -> the candidate's own manifest key (null: the candidate's manifest cannot address that seat). */
+    candidateKeyForCabin: Record<string, string | null>;
+    /** The vocabularies agree for every candidate seat that has a stand-in seat: nothing needs rewriting. */
+    identical: boolean;
+    /** Candidate cabin seats the stand-in room has no seat for (they cannot be granted by this room). */
+    unmapped: string[];
+    problems: string[];
+}
+export interface SeatReport {
+    candidate: {
+        keys: string[];
+        driverKey: string | null;
+        declaredCabinSeats: string[];
+        glbSeatNodes: string[];
+        platformDefault: boolean;
+    };
+    proxy: {
+        keys: string[];
+        driverKey: string | null;
+        cabinSeats: string[];
+        platformDefault: boolean;
+    };
+    table: SeatBridgeTable;
+}
+/**
+ * Build the bridge from the candidate's package (+ the seat nodes of its GLB) and the stand-in's package as the Try Now session
+ * delivered it. `proxyRevision` is the stand-in package artifact's revision (the room's identity pin).
+ */
+export declare function buildSeatBridge(candidatePkg: Json, glbSeatNodeNames: readonly string[], proxyPkg: Json, proxyRevision: number): SeatReport;
+/**
+ * Page-side hook (plain JS string; `table` is `SeatBridgeTable`). Wraps the three seat entry points of every spawned vehicle's
+ * specialty runtime so the seat INTENT is known when the room send happens, and rewrites that one send into the stand-in's
+ * vocabulary. Everything it sends or declines to rewrite is appended to `globalThis.__vqaSeatLog`.
+ */
+export declare const INSTALL_SEAT_BRIDGE = "(table) => {\n  const G = globalThis;\n  if (G.__vqaSeatBridge) return { ok: true, again: true };\n  const mp = G.__assetGym && G.__assetGym.mp;\n  const room = mp && mp.room;\n  if (!room || typeof room.sendModuleAction !== 'function') return { ok: false, why: 'no room.sendModuleAction to wrap' };\n  const log = G.__vqaSeatLog = [];\n  let intent = null;\n  const proxy = table && table.proxy;\n  const orig = room.sendModuleAction.bind(room);\n  const unmapped = (table && table.unmapped) || [];\n  // The Try Now vehicle's replicated seat map (format 7 `vehicleSeats`), where the engine reads who sits where.\n  const seatMap = () => {\n    let found = null;\n    try { room.state.entities.forEach((e) => { if (!found && e && e.kind === 'universal-vehicle' && e.vehicleSeats && typeof e.vehicleSeats.set === 'function') found = e.vehicleSeats; }); } catch (err) { /* no entities */ }\n    return found;\n  };\n  const synthGrant = (key, enter) => {\n    const seats = seatMap();\n    if (!seats) return { ok: false, why: 'the room state has no replicated seat map on the vehicle (a package-var seat table): the rear seat cannot be granted locally' };\n    try {\n      if (enter) {\n        // a session holds one seat: leave any synthetic seat first\n        for (const k of G.__vqaSyntheticSeats || []) if (k !== key) seats.set(k, '');\n        seats.set(key, room.sessionId);\n        G.__vqaSyntheticSeats = Array.from(new Set([...(G.__vqaSyntheticSeats || []), key]));\n      } else seats.set(key, '');\n      return { ok: true };\n    } catch (err) { return { ok: false, why: String(err && err.message || err).slice(0, 160) }; }\n  };\n  room.sendModuleAction = function (req) {\n    if (intent && intent.cabin && unmapped.indexOf(intent.cabin) >= 0 && table.candidateKeyForCabin && table.candidateKeyForCabin[intent.cabin]) {\n      const key = table.candidateKeyForCabin[intent.cabin];\n      const enter = intent.kind === 'enter-seat' || intent.kind === 'enter-driver';\n      const r = synthGrant(key, enter);\n      log.push({ t: Math.round(performance.now()), intent: { kind: intent.kind, cabin: intent.cabin }, candidate: { moduleId: req.identity && req.identity.moduleId, action: req.action, args: req.args }, sent: null, translated: false, synthetic: { key, enter, ok: r.ok }, why: r.ok ? null : r.why });\n      return undefined;\n    }\n    let sent = req, translated = false, why = null;\n    if (intent && proxy && !table.identical) {\n      const call = intent.kind === 'enter-seat' ? proxy.calls['enter-seat'] || (intent.cabin === 'seat_dside_f' ? proxy.calls['enter-driver'] : null)\n        : intent.kind === 'exit-seat' ? proxy.calls['exit-seat'] || (intent.cabin === 'seat_dside_f' ? proxy.calls['exit-driver'] : null)\n        : intent.kind === 'enter-driver' ? proxy.calls['enter-driver'] || proxy.calls['enter-seat'] : proxy.calls['exit-driver'] || proxy.calls['exit-seat'];\n      const key = proxy.seatKeyForCabin[intent.cabin];\n      const generic = call && call === (intent.kind.indexOf('enter') === 0 ? proxy.calls['enter-seat'] : proxy.calls['exit-seat']);\n      if (!call) why = 'the stand-in declares no function for ' + intent.kind;\n      else if (generic && !key) why = 'the stand-in has no seat for ' + intent.cabin;\n      else {\n        // The room's module id is derived from the BUNDLE and the placement (itx.<bundle slug>.<first 12 hex of the placement id>): the placement\n        // is this car's, the bundle is the stand-in's.\n        const cm = String(req.identity && req.identity.moduleId || '');\n        const tail = cm.indexOf('itx.') === 0 ? cm.split('.').pop() : null;\n        const slug = String(proxy.bundleId || '').replace(/[^a-z0-9-]/g, '').slice(0, 13) || 'item';\n        const moduleId = tail && proxy.bundleId ? 'itx.' + slug + '.' + tail : proxy.moduleId;\n        sent = { identity: Object.assign({}, req.identity, { moduleId, bundleChecksumSha256: proxy.bundleChecksumSha256, revision: proxy.revision }), action: call, args: generic ? { seatId: key } : {} };\n        translated = true;\n      }\n    }\n    log.push({ t: Math.round(performance.now()), intent: intent && { kind: intent.kind, cabin: intent.cabin }, candidate: { moduleId: req.identity && req.identity.moduleId, action: req.action, args: req.args }, sent: translated ? { moduleId: sent.identity.moduleId, action: sent.action, args: sent.args } : null, translated, why });\n    return orig(sent);\n  };\n  const wrap = (spec) => {\n    for (const name of ['requestSeatControl', 'requestSeatExit', 'requestDriverControl']) {\n      const f = spec[name];\n      if (typeof f !== 'function' || f.__vqaWrapped) continue;\n      const w = function (a) {\n        const prev = intent;\n        const cabin = name === 'requestDriverControl' ? 'seat_dside_f' : String(a);\n        intent = { kind: name === 'requestSeatControl' ? 'enter-seat' : name === 'requestSeatExit' ? 'exit-seat' : String(a), cabin };\n        try { return f.apply(this, arguments); } finally { intent = prev; }\n      };\n      w.__vqaWrapped = true; spec[name] = w;\n    }\n  };\n  const proto = (() => { try { const e = mp.portableVehicles.presentationRows()[0].entity; return e.specialty ? Object.getPrototypeOf(e.specialty) : null; } catch (err) { return null; } })();\n  if (!proto) return { ok: false, why: 'no vehicle specialty runtime to wrap' };\n  wrap(proto);\n  G.__vqaSeatBridge = true;\n  return { ok: true };\n}";

package/dist/vehicle/previewSeats.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTALL_SEAT_BRIDGE = exports.DRIVER_CABIN_SEAT_ID = exports.isSeatId = void 0;
+exports.seatManifestOf = seatManifestOf;
+exports.seatKeyFor = seatKeyFor;
+exports.cabinSeatOf = cabinSeatOf;
+exports.glbSeatNodes = glbSeatNodes;
+exports.buildSeatBridge = buildSeatBridge;
+const isRecord = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const SEAT_ID = /^seat_(dside|pside)_(f|r(\d+))$/;
+const isSeatId = (id) => SEAT_ID.test(id);
+exports.isSeatId = isSeatId;
+/** Only the driver's front seat drives (the engine's `seatRole`). */
+exports.DRIVER_CABIN_SEAT_ID = 'seat_dside_f';
+/** The seat vocabulary a vehicle package declares. A package with no `specialty` has the platform default (reported as such). */
+function seatManifestOf(pkg) {
+    const specialty = isRecord(pkg.specialty) ? pkg.specialty : null;
+    const mod = specialty && isRecord(specialty.module) ? specialty.module : {};
+    const seatVars = {};
+    if (isRecord(mod.seatVars))
+        for (const [k, v] of Object.entries(mod.seatVars))
+            if (typeof v === 'string')
+                seatVars[k] = v;
+    const calls = {};
+    if (specialty && Array.isArray(specialty.actions)) {
+        for (const a of specialty.actions) {
+            if (!isRecord(a) || typeof a.control !== 'string' || typeof a.call !== 'string')
+                continue;
+            if (a.control === 'enter-seat' || a.control === 'exit-seat' || a.control === 'enter-driver' || a.control === 'exit-driver')
+                calls[a.control] ??= a.call;
+        }
+    }
+    return {
+        seatVars,
+        driverSeat: typeof mod.driverSeat === 'string' ? mod.driverSeat : null,
+        module: { id: typeof mod.id === 'string' ? mod.id : null, bundleId: typeof mod.bundleId === 'string' ? mod.bundleId : null, bundleChecksumSha256: typeof mod.bundleChecksumSha256 === 'string' ? mod.bundleChecksumSha256 : null },
+        calls,
+        platformDefault: !specialty,
+    };
+}
+/** The manifest key that addresses a cabin seat (the engine's `seatVarsKeyFor`): the id itself, else the legacy driver / passenger role key. */
+function seatKeyFor(m, cabinSeatId) {
+    if (Object.hasOwn(m.seatVars, cabinSeatId))
+        return cabinSeatId;
+    if (!(0, exports.isSeatId)(cabinSeatId))
+        return undefined;
+    if (cabinSeatId === exports.DRIVER_CABIN_SEAT_ID) {
+        const key = m.driverSeat ?? 'driver';
+        return Object.hasOwn(m.seatVars, key) ? key : undefined;
+    }
+    return Object.hasOwn(m.seatVars, 'passenger') ? 'passenger' : undefined;
+}
+/** The cabin seat a manifest key stands for (the engine's `cabinSeatIdFor`). */
+function cabinSeatOf(m, key) {
+    if (!Object.hasOwn(m.seatVars, key))
+        return undefined;
+    if ((0, exports.isSeatId)(key))
+        return key;
+    if (key === (m.driverSeat ?? 'driver'))
+        return exports.DRIVER_CABIN_SEAT_ID;
+    return undefined;
+}
+/** `seat_*` node names of a GLB, in canonical order (front row first, driver's side first): the candidate's physical seats. */
+function glbSeatNodes(nodeNames) {
+    const rank = (id) => { const m = SEAT_ID.exec(id); return [m[3] === undefined ? 0 : Number(m[3]), m[1] === 'dside' ? 0 : 1]; };
+    return [...new Set(nodeNames.filter(exports.isSeatId))].sort((a, b) => { const ra = rank(a), rb = rank(b); return ra[0] - rb[0] || ra[1] - rb[1]; });
+}
+/**
+ * Build the bridge from the candidate's package (+ the seat nodes of its GLB) and the stand-in's package as the Try Now session
+ * delivered it. `proxyRevision` is the stand-in package artifact's revision (the room's identity pin).
+ */
+function buildSeatBridge(candidatePkg, glbSeatNodeNames, proxyPkg, proxyRevision) {
+    const cand = seatManifestOf(candidatePkg);
+    const prox = seatManifestOf(proxyPkg);
+    const candCabin = [...new Set([...glbSeatNodeNames, ...Object.keys(cand.seatVars).map((k) => cabinSeatOf(cand, k)).filter((x) => !!x)])];
+    const proxCabin = [...new Set(Object.keys(prox.seatVars).map((k) => cabinSeatOf(prox, k)).filter((x) => !!x))];
+    const problems = [];
+    const candidateKeyForCabin = {};
+    for (const c of candCabin)
+        candidateKeyForCabin[c] = seatKeyFor(cand, c) ?? null;
+    let proxy = null;
+    if (prox.platformDefault || !prox.module.id || !prox.module.bundleChecksumSha256) {
+        problems.push('the stand-in car declares no specialty module, so its room identity is the engine\'s platform default; translation is not possible (pick a stand-in with a specialty: --proxy-item)');
+    }
+    else {
+        const seatKeyForCabin = {};
+        for (const c of new Set([...candCabin, ...proxCabin])) {
+            const k = seatKeyFor(prox, c);
+            if (k)
+                seatKeyForCabin[c] = k;
+        }
+        proxy = { moduleId: prox.module.id, bundleId: prox.module.bundleId, bundleChecksumSha256: prox.module.bundleChecksumSha256, revision: proxyRevision, calls: prox.calls, seatKeyForCabin };
+    }
+    const unmapped = candCabin.filter((c) => candidateKeyForCabin[c] && !(proxy?.seatKeyForCabin[c]));
+    const mappable = candCabin.filter((c) => candidateKeyForCabin[c] && proxy?.seatKeyForCabin[c]);
+    const sameModule = cand.module.id === prox.module.id && cand.module.bundleId === prox.module.bundleId && cand.module.bundleChecksumSha256 === prox.module.bundleChecksumSha256;
+    const sameCalls = ['enter-seat', 'exit-seat', 'enter-driver', 'exit-driver'].every((k) => cand.calls[k] === prox.calls[k]);
+    const identical = !!proxy && sameModule && sameCalls && mappable.every((c) => candidateKeyForCabin[c] === proxy.seatKeyForCabin[c]);
+    return {
+        candidate: { keys: Object.keys(cand.seatVars), driverKey: cand.driverSeat ?? (Object.hasOwn(cand.seatVars, 'driver') ? 'driver' : null), declaredCabinSeats: candCabin, glbSeatNodes: [...glbSeatNodeNames], platformDefault: cand.platformDefault },
+        proxy: { keys: Object.keys(prox.seatVars), driverKey: prox.driverSeat ?? (Object.hasOwn(prox.seatVars, 'driver') ? 'driver' : null), cabinSeats: proxCabin, platformDefault: prox.platformDefault },
+        table: { proxy, candidateKeyForCabin, identical, unmapped, problems },
+    };
+}
+/**
+ * Page-side hook (plain JS string; `table` is `SeatBridgeTable`). Wraps the three seat entry points of every spawned vehicle's
+ * specialty runtime so the seat INTENT is known when the room send happens, and rewrites that one send into the stand-in's
+ * vocabulary. Everything it sends or declines to rewrite is appended to `globalThis.__vqaSeatLog`.
+ */
+exports.INSTALL_SEAT_BRIDGE = `(table) => {
+  const G = globalThis;
+  if (G.__vqaSeatBridge) return { ok: true, again: true };
+  const mp = G.__assetGym && G.__assetGym.mp;
+  const room = mp && mp.room;
+  if (!room || typeof room.sendModuleAction !== 'function') return { ok: false, why: 'no room.sendModuleAction to wrap' };
+  const log = G.__vqaSeatLog = [];
+  let intent = null;
+  const proxy = table && table.proxy;
+  const orig = room.sendModuleAction.bind(room);
+  const unmapped = (table && table.unmapped) || [];
+  // The Try Now vehicle's replicated seat map (format 7 \`vehicleSeats\`), where the engine reads who sits where.
+  const seatMap = () => {
+    let found = null;
+    try { room.state.entities.forEach((e) => { if (!found && e && e.kind === 'universal-vehicle' && e.vehicleSeats && typeof e.vehicleSeats.set === 'function') found = e.vehicleSeats; }); } catch (err) { /* no entities */ }
+    return found;
+  };
+  const synthGrant = (key, enter) => {
+    const seats = seatMap();
+    if (!seats) return { ok: false, why: 'the room state has no replicated seat map on the vehicle (a package-var seat table): the rear seat cannot be granted locally' };
+    try {
+      if (enter) {
+        // a session holds one seat: leave any synthetic seat first
+        for (const k of G.__vqaSyntheticSeats || []) if (k !== key) seats.set(k, '');
+        seats.set(key, room.sessionId);
+        G.__vqaSyntheticSeats = Array.from(new Set([...(G.__vqaSyntheticSeats || []), key]));
+      } else seats.set(key, '');
+      return { ok: true };
+    } catch (err) { return { ok: false, why: String(err && err.message || err).slice(0, 160) }; }
+  };
+  room.sendModuleAction = function (req) {
+    if (intent && intent.cabin && unmapped.indexOf(intent.cabin) >= 0 && table.candidateKeyForCabin && table.candidateKeyForCabin[intent.cabin]) {
+      const key = table.candidateKeyForCabin[intent.cabin];
+      const enter = intent.kind === 'enter-seat' || intent.kind === 'enter-driver';
+      const r = synthGrant(key, enter);
+      log.push({ t: Math.round(performance.now()), intent: { kind: intent.kind, cabin: intent.cabin }, candidate: { moduleId: req.identity && req.identity.moduleId, action: req.action, args: req.args }, sent: null, translated: false, synthetic: { key, enter, ok: r.ok }, why: r.ok ? null : r.why });
+      return undefined;
+    }
+    let sent = req, translated = false, why = null;
+    if (intent && proxy && !table.identical) {
+      const call = intent.kind === 'enter-seat' ? proxy.calls['enter-seat'] || (intent.cabin === 'seat_dside_f' ? proxy.calls['enter-driver'] : null)
+        : intent.kind === 'exit-seat' ? proxy.calls['exit-seat'] || (intent.cabin === 'seat_dside_f' ? proxy.calls['exit-driver'] : null)
+        : intent.kind === 'enter-driver' ? proxy.calls['enter-driver'] || proxy.calls['enter-seat'] : proxy.calls['exit-driver'] || proxy.calls['exit-seat'];
+      const key = proxy.seatKeyForCabin[intent.cabin];
+      const generic = call && call === (intent.kind.indexOf('enter') === 0 ? proxy.calls['enter-seat'] : proxy.calls['exit-seat']);
+      if (!call) why = 'the stand-in declares no function for ' + intent.kind;
+      else if (generic && !key) why = 'the stand-in has no seat for ' + intent.cabin;
+      else {
+        // The room's module id is derived from the BUNDLE and the placement (itx.<bundle slug>.<first 12 hex of the placement id>): the placement
+        // is this car's, the bundle is the stand-in's.
+        const cm = String(req.identity && req.identity.moduleId || '');
+        const tail = cm.indexOf('itx.') === 0 ? cm.split('.').pop() : null;
+        const slug = String(proxy.bundleId || '').replace(/[^a-z0-9-]/g, '').slice(0, 13) || 'item';
+        const moduleId = tail && proxy.bundleId ? 'itx.' + slug + '.' + tail : proxy.moduleId;
+        sent = { identity: Object.assign({}, req.identity, { moduleId, bundleChecksumSha256: proxy.bundleChecksumSha256, revision: proxy.revision }), action: call, args: generic ? { seatId: key } : {} };
+        translated = true;
+      }
+    }
+    log.push({ t: Math.round(performance.now()), intent: intent && { kind: intent.kind, cabin: intent.cabin }, candidate: { moduleId: req.identity && req.identity.moduleId, action: req.action, args: req.args }, sent: translated ? { moduleId: sent.identity.moduleId, action: sent.action, args: sent.args } : null, translated, why });
+    return orig(sent);
+  };
+  const wrap = (spec) => {
+    for (const name of ['requestSeatControl', 'requestSeatExit', 'requestDriverControl']) {
+      const f = spec[name];
+      if (typeof f !== 'function' || f.__vqaWrapped) continue;
+      const w = function (a) {
+        const prev = intent;
+        const cabin = name === 'requestDriverControl' ? 'seat_dside_f' : String(a);
+        intent = { kind: name === 'requestSeatControl' ? 'enter-seat' : name === 'requestSeatExit' ? 'exit-seat' : String(a), cabin };
+        try { return f.apply(this, arguments); } finally { intent = prev; }
+      };
+      w.__vqaWrapped = true; spec[name] = w;
+    }
+  };
+  const proto = (() => { try { const e = mp.portableVehicles.presentationRows()[0].entity; return e.specialty ? Object.getPrototypeOf(e.specialty) : null; } catch (err) { return null; } })();
+  if (!proto) return { ok: false, why: 'no vehicle specialty runtime to wrap' };
+  wrap(proto);
+  G.__vqaSeatBridge = true;
+  return { ok: true };
+}`;
+//# sourceMappingURL=previewSeats.js.map

package/dist/vehicle/previewSeats.js.map

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

package/dist/vehicle/publish.d.ts

@@ -0,0 +1,78 @@
+import { type ProvenanceIssue } from './audioProvenance';
+import { type BytesFetch, type Json } from './platform';
+export declare const VEHICLE_ROOT_MEDIA_TYPE = "application/vnd.helix.vehicle-package+json;version=2";
+export declare const VEHICLE_MODEL_ROLE = "vehicle.model.web.medium";
+export declare const VEHICLE_AUDIO_ROLE = "vehicle.audio.bank.sample";
+export interface VehicleDir {
+    dir: string;
+    packageFile: string;
+    glbFile: string;
+    thumbnailFile?: string;
+    publish: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        slug?: string;
+        version?: string;
+        provenance?: {
+            kind?: string;
+            source?: string;
+        };
+    };
+    pkg: Json;
+}
+/** Find the pieces of a vehicle package directory. Throws with what is missing. */
+export declare function readVehicleDir(dirArg: string, overrides?: {
+    glb?: string;
+    thumbnail?: string;
+}): VehicleDir;
+export interface UploadedAudio {
+    name: string;
+    file: string;
+    sha: string;
+    bytes: number;
+    url: string;
+}
+/**
+ * Vehicle audio is never synthesised: the provenance errors that refuse a publish (AUDIO_SYNTHESISED,
+ * AUDIO_ENGINE_UNSOURCED, AUDIO_SLOT_UNSOURCED, AUDIO_PROVENANCE_MISSING, AUDIO_SLOT_FITMENT_MISMATCH). `vehicle publish`
+ * already refuses on any audio-check error before uploading; this is the same rule at the upload boundary, so nothing
+ * that calls `attachAudioUrls` can seal synthesised or unsourced audio either.
+ */
+export declare function audioSourcingErrors(pkg: unknown): ProvenanceIssue[];
+export declare function assertAudioSourced(pkg: unknown): void;
+/** The slice of the Continuum client this command uses — the specs fake it. */
+export interface ContinuumObjects {
+    putObjectFromFile(input: {
+        path: string;
+        filename: string;
+        mediaType: string;
+        audience?: 'private' | 'public';
+    }): Promise<{
+        cid: string;
+        bytes: number;
+        mediaType: string;
+    }>;
+}
+/** The local WAVs a publish WOULD upload (same rows, same dedupe by sha as `attachAudioUrls`), without uploading. */
+export declare function plannedAudioUploads(pkg: Json, dir: string): Array<{
+    name: string;
+    file: string;
+    sha: string;
+    bytes: number;
+}>;
+/**
+ * Upload every local WAV the package will play and return the package with each row's url/checksum/bytes/cid filled.
+ * Rows that already carry a url and have no local file are left alone (platform generic samples); `checkAudioLocal`
+ * has already fetched and verified them.
+ */
+export declare function attachAudioUrls(pkg: Json, dir: string, deps: {
+    objects: ContinuumObjects;
+    apiUrl: string;
+    fetchBytes?: BytesFetch;
+    origins?: string[];
+    onProgress?: (m: string) => void;
+}): Promise<{
+    pkg: Json;
+    uploaded: UploadedAudio[];
+}>;

package/dist/vehicle/publish.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VEHICLE_AUDIO_ROLE = exports.VEHICLE_MODEL_ROLE = exports.VEHICLE_ROOT_MEDIA_TYPE = void 0;
+exports.readVehicleDir = readVehicleDir;
+exports.audioSourcingErrors = audioSourcingErrors;
+exports.assertAudioSourced = assertAudioSourced;
+exports.plannedAudioUploads = plannedAudioUploads;
+exports.attachAudioUrls = attachAudioUrls;
+/** Read Vehicle Package source files and prepare exact audio object pins before sealing. */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const audio_1 = require("./audio");
+const audioProvenance_1 = require("./audioProvenance");
+const platform_1 = require("./platform");
+exports.VEHICLE_ROOT_MEDIA_TYPE = 'application/vnd.helix.vehicle-package+json;version=2';
+exports.VEHICLE_MODEL_ROLE = 'vehicle.model.web.medium';
+exports.VEHICLE_AUDIO_ROLE = 'vehicle.audio.bank.sample';
+/** Find the pieces of a vehicle package directory. Throws with what is missing. */
+function readVehicleDir(dirArg, overrides = {}) {
+    const dir = (0, node_path_1.resolve)(dirArg);
+    if (!(0, node_fs_1.existsSync)(dir))
+        throw new Error(`${dir} does not exist`);
+    const packageFile = ['vehicle-package.json', 'vehicle.package.json', 'package.vehicle.json'].map((f) => (0, node_path_1.join)(dir, f)).find(node_fs_1.existsSync);
+    if (!packageFile)
+        throw new Error(`${dir} has no vehicle-package.json (the helix.vehicle-package/2 JSON)`);
+    const pkg = JSON.parse((0, node_fs_1.readFileSync)(packageFile, 'utf8'));
+    if (!(0, platform_1.isRecord)(pkg))
+        throw new Error(`${packageFile} is not a JSON object`);
+    let glbFile = overrides.glb ? (0, node_path_1.resolve)(overrides.glb) : undefined;
+    if (!glbFile) {
+        const glbs = (0, node_fs_1.readdirSync)(dir).filter((f) => f.toLowerCase().endsWith('.glb'));
+        if (glbs.includes('model.glb'))
+            glbFile = (0, node_path_1.join)(dir, 'model.glb');
+        else if (glbs.length === 1)
+            glbFile = (0, node_path_1.join)(dir, glbs[0]);
+        else
+            throw new Error(glbs.length === 0 ? `${dir} has no .glb model` : `${dir} has ${glbs.length} .glb files; name the drawn one model.glb or pass --glb`);
+    }
+    const thumbnailFile = overrides.thumbnail ? (0, node_path_1.resolve)(overrides.thumbnail)
+        : ['thumbnail.png', 'thumbnail.jpg', 'thumbnail.jpeg', 'thumbnail.webp'].map((f) => (0, node_path_1.join)(dir, f)).find(node_fs_1.existsSync);
+    const publishFile = (0, node_path_1.join)(dir, 'publish.json');
+    const publish = (0, node_fs_1.existsSync)(publishFile) ? JSON.parse((0, node_fs_1.readFileSync)(publishFile, 'utf8')) : {};
+    return { dir, packageFile, glbFile, thumbnailFile, publish, pkg };
+}
+/**
+ * Vehicle audio is never synthesised: the provenance errors that refuse a publish (AUDIO_SYNTHESISED,
+ * AUDIO_ENGINE_UNSOURCED, AUDIO_SLOT_UNSOURCED, AUDIO_PROVENANCE_MISSING, AUDIO_SLOT_FITMENT_MISMATCH). `vehicle publish`
+ * already refuses on any audio-check error before uploading; this is the same rule at the upload boundary, so nothing
+ * that calls `attachAudioUrls` can seal synthesised or unsourced audio either.
+ */
+function audioSourcingErrors(pkg) {
+    return (0, audioProvenance_1.provenanceReport)(pkg).issues.filter((i) => i.level === 'error');
+}
+function assertAudioSourced(pkg) {
+    const errors = audioSourcingErrors(pkg);
+    if (errors.length === 0)
+        return;
+    const head = errors.slice(0, 6).map((e) => `  [${e.code}] ${e.path}: ${e.message}`).join('\n');
+    throw new Error(`refusing to publish vehicle audio that is synthesised or unsourced (${errors.length} problem${errors.length === 1 ? '' : 's'}):\n${head}${errors.length > 6 ? `\n  … ${errors.length - 6} more (run \`helix vehicle audio-check\`)` : ''}\n  fix: take every sound from the car's sim mod with \`helix vehicle audio-import\``);
+}
+/** The local WAVs a publish WOULD upload (same rows, same dedupe by sha as `attachAudioUrls`), without uploading. */
+function plannedAudioUploads(pkg, dir) {
+    const { rows } = (0, audio_1.collectAudioRows)(JSON.parse(JSON.stringify(pkg)), { includeUnconsumed: true });
+    const bySha = new Map();
+    for (const r of rows) {
+        const file = (0, audio_1.localFileFor)(r.row, dir);
+        if (!file)
+            continue;
+        const bytes = (0, node_fs_1.readFileSync)(file);
+        const sha = (0, platform_1.sha256Hex)(bytes);
+        if (!bySha.has(sha))
+            bySha.set(sha, { name: String(r.row.name), file, sha, bytes: bytes.length });
+    }
+    return [...bySha.values()];
+}
+/**
+ * Upload every local WAV the package will play and return the package with each row's url/checksum/bytes/cid filled.
+ * Rows that already carry a url and have no local file are left alone (platform generic samples); `checkAudioLocal`
+ * has already fetched and verified them.
+ */
+async function attachAudioUrls(pkg, dir, deps) {
+    assertAudioSourced(pkg);
+    const out = JSON.parse(JSON.stringify(pkg));
+    // Every slot asset is in the sealed closure, consumed today or not (the engine validator requires its url).
+    const { rows } = (0, audio_1.collectAudioRows)(out, { includeUnconsumed: true });
+    const bySha = new Map();
+    for (const r of rows) {
+        const file = (0, audio_1.localFileFor)(r.row, dir);
+        if (!file)
+            continue;
+        const bytes = (0, node_fs_1.readFileSync)(file);
+        const sha = (0, platform_1.sha256Hex)(bytes);
+        let uploaded = bySha.get(sha);
+        if (!uploaded) {
+            deps.onProgress?.(`uploading ${(0, node_path_1.basename)(file)} (${(bytes.length / 1024).toFixed(0)} KiB) as a public object`);
+            const record = await deps.objects.putObjectFromFile({ path: file, filename: (0, node_path_1.basename)(file), mediaType: 'audio/wav', audience: 'public' });
+            if (record.cid !== (0, platform_1.cidOf)(sha) || record.bytes !== bytes.length)
+                throw new Error(`upload of ${file} returned ${record.cid}/${record.bytes}, expected ${(0, platform_1.cidOf)(sha)}/${bytes.length}`);
+            const url = await (0, platform_1.publicObjectUrl)(deps.apiUrl, sha, bytes.length, { fetchBytes: deps.fetchBytes, origins: deps.origins });
+            uploaded = { name: String(r.row.name), file, sha, bytes: bytes.length, url };
+            bySha.set(sha, uploaded);
+        }
+        Object.assign(r.row, {
+            url: uploaded.url, checksumSha256: sha, bytes: bytes.length, cid: (0, platform_1.cidOf)(sha), mediaType: 'audio/wav',
+            file: typeof r.row.file === 'string' ? r.row.file : (0, node_path_1.basename)(file),
+            role: typeof r.row.role === 'string' ? r.row.role : r.use === 'bank' ? exports.VEHICLE_AUDIO_ROLE : `vehicle.audio.slot.${r.slot}`,
+        });
+    }
+    return { pkg: out, uploaded: [...bySha.values()] };
+}
+//# sourceMappingURL=publish.js.map

package/dist/vehicle/publish.js.map

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

package/dist/vehicle/recheckListed.d.ts

@@ -0,0 +1,87 @@
+/** Every blocking assert a car's visual QA must have PASSED on today's route. A record without one never ran that gate. */
+export declare const CURRENT_VEHICLE_GATES: readonly string[];
+interface RunRow {
+    id?: string;
+    verdict?: string;
+    createdAt?: string;
+    packageVersionId?: string | null;
+    bundle?: {
+        item?: {
+            packageVersion?: string | null;
+        };
+        asserts?: Array<{
+            id: string;
+            pass: boolean;
+            severity?: string;
+        }>;
+        harness?: {
+            version?: string;
+        };
+    };
+}
+interface VqaStatus {
+    currentVersion?: {
+        packageVersionId?: string | null;
+        passed?: boolean;
+        runId?: string | null;
+    } | null;
+    runs?: RunRow[];
+}
+export interface RecordJudgement {
+    itemId: string;
+    title: string;
+    version: string | null;
+    record: {
+        runId: string | null;
+        createdAt: string | null;
+        harness: string | null;
+        verdict: string | null;
+    } | null;
+    /** current gates the passing record never ran */
+    stale: string[];
+    /** current gates the record ran and failed (blocking) */
+    failed: string[];
+    status: 'current' | 'stale' | 'fail' | 'no-record';
+}
+/** Judge one item's visual-QA status against the current gate list. Pure. */
+export declare function judgeRecord(itemId: string, title: string, version: string | null, st: VqaStatus, gates?: readonly string[]): RecordJudgement;
+export interface RecheckRow extends RecordJudgement {
+    /** --rerun: today's render of the car (vehicle preview --item), its verdict and the failing blocking asserts. */
+    rerun?: {
+        verdict: string;
+        exitCode: number;
+        failing: Array<{
+            id: string;
+            detail: string;
+        }>;
+        inspection: string | null;
+        out: string;
+        error?: string;
+    } | null;
+}
+/** The listed vehicles: the marketplace catalogue's vehicle items (optionally one creator's). */
+export declare function listedVehicles(apiBase: string, creatorId?: string): Promise<Array<{
+    id: string;
+    title: string;
+}>>;
+export interface RecheckOptions {
+    apiBase: string;
+    webBase: string;
+    items?: string[];
+    creatorId?: string;
+    rerun?: boolean;
+    out: string;
+    token?: string | null;
+    storageState?: string;
+    chrome?: string;
+    log?: (m: string) => void;
+}
+export declare function recheckListed(o: RecheckOptions): Promise<RecheckRow[]>;
+export declare function renderRecheckText(rows: RecheckRow[]): string;
+/**
+ * The listing gate for a VEHICLE: before a new Claim/Buy route is created, its current version's passing visual-QA record
+ * must have run, and passed, every blocking gate that exists today. Returns null for an item that is not a vehicle.
+ */
+export declare function vehicleListingGate(apiBase: string, itemId: string): Promise<RecordJudgement | null>;
+export declare function listingRefusal(j: RecordJudgement): string;
+export {};