@series-inc/rundot-syncplay 5.26.0-beta.9 → 5.27.0

package/dist/physics3d.js

@@ -281,6 +281,104 @@ export function applyDeterministicWorldEdit3D(world, edit) {
             : world.jointCache.filter((entry) => !removeJointIds.has(entry.jointId)),
     };
 }
+/**
+ * Fast batch update of kinematic body transforms and velocities without
+ * allocating Set instances or re-sorting world bodies. Wakes touching dynamic
+ * bodies across active contact pairs. If linear velocity (vx, vy, vz) is omitted
+ * and dtTicks (> 0) is supplied, linear velocity is derived as (newPos - oldPos) / dtTicks.
+ */
+export function setDeterministicKinematicPoses3D(world, poses, options = {}) {
+    if (poses.length === 0) {
+        return world;
+    }
+    const dt = options.dtTicks !== undefined && options.dtTicks > 0 ? options.dtTicks : undefined;
+    const poseById = new Map();
+    for (const pose of poses) {
+        if (!Number.isFinite(pose.x) || !Number.isFinite(pose.y) || !Number.isFinite(pose.z)) {
+            throw new Error(`setDeterministicKinematicPoses3D: body ${pose.id} position must be finite numbers`);
+        }
+        poseById.set(pose.id, pose);
+    }
+    const updatedIds = new Set();
+    const movedBodies = new Map();
+    const newBodies = world.bodies.map((body) => {
+        const pose = poseById.get(body.id);
+        if (pose === undefined) {
+            return body;
+        }
+        if (body.kind !== 'kinematic') {
+            throw new Error(`setDeterministicKinematicPoses3D: body ${body.id} is ${body.kind}, expected kinematic`);
+        }
+        updatedIds.add(body.id);
+        let vx = pose.vx;
+        let vy = pose.vy;
+        let vz = pose.vz;
+        if (vx === undefined || vy === undefined || vz === undefined) {
+            if (dt !== undefined) {
+                vx = vx ?? (pose.x - body.x) / dt;
+                vy = vy ?? (pose.y - body.y) / dt;
+                vz = vz ?? (pose.z - body.z) / dt;
+            }
+            else {
+                vx = vx ?? body.vx;
+                vy = vy ?? body.vy;
+                vz = vz ?? body.vz;
+            }
+        }
+        let angularVel = body.angularVel;
+        if (pose.angularVelX !== undefined || pose.angularVelY !== undefined || pose.angularVelZ !== undefined) {
+            angularVel = {
+                x: pose.angularVelX ?? body.angularVel?.x ?? 0,
+                y: pose.angularVelY ?? body.angularVel?.y ?? 0,
+                z: pose.angularVelZ ?? body.angularVel?.z ?? 0,
+            };
+        }
+        const updated = {
+            ...body,
+            x: pose.x,
+            y: pose.y,
+            z: pose.z,
+            vx,
+            vy,
+            vz,
+            rx: pose.rx ?? body.rx,
+            ry: pose.ry ?? body.ry,
+            rz: pose.rz ?? body.rz,
+            orientation: pose.orientation ?? body.orientation,
+            angularVel,
+        };
+        movedBodies.set(body.id, updated);
+        return updated;
+    });
+    for (const pose of poses) {
+        if (!updatedIds.has(pose.id)) {
+            throw new Error(`setDeterministicKinematicPoses3D: cannot update unknown kinematic body ${pose.id}`);
+        }
+    }
+    // Wake any dynamic bodies that share active pairs with updated kinematics
+    const wokenDynamicIds = new Set();
+    for (const pair of world.activePairMetadata) {
+        if (movedBodies.has(pair.a)) {
+            for (const member of contactIslandFor(world, pair.b)) {
+                wokenDynamicIds.add(member);
+            }
+        }
+        else if (movedBodies.has(pair.b)) {
+            for (const member of contactIslandFor(world, pair.a)) {
+                wokenDynamicIds.add(member);
+            }
+        }
+    }
+    const finalBodies = wokenDynamicIds.size === 0
+        ? newBodies
+        : newBodies.map((body) => (wokenDynamicIds.has(body.id) && body.kind === 'dynamic' && body.sleeping
+            ? { ...body, sleeping: false, lowVelFrames: 0 }
+            : body));
+    return {
+        ...world,
+        bodies: finalBodies,
+    };
+}
 /**
  * Apply a deterministic impulse to a body (linear + angular via lever arm),
  * waking the body and its contact island. Returns a new canonical world.
@@ -3112,6 +3210,27 @@ function rayBodyDistance(body, query) {
     if (body.shape.type === 'hull') {
         return rayHullBodyDistance(body, body.shape, query);
     }
+    if (body.shape.type === 'compound') {
+        let closestDistance;
+        for (let index = 0; index < body.shape.children.length; index += 1) {
+            const child = body.shape.children[index];
+            const childBody = {
+                ...body,
+                x: (body.x ?? 0) + (child.offset?.x ?? 0),
+                y: (body.y ?? 0) + (child.offset?.y ?? 0),
+                z: (body.z ?? 0) + (child.offset?.z ?? 0),
+                shape: child.shape,
+                rx: (body.rx ?? 0) + canonicalQuarterTurns(child.quarterTurns?.x ?? 0) / 4,
+                ry: (body.ry ?? 0) + canonicalQuarterTurns(child.quarterTurns?.y ?? 0) / 4,
+                rz: (body.rz ?? 0) + canonicalQuarterTurns(child.quarterTurns?.z ?? 0) / 4,
+            };
+            const childDistance = rayBodyDistance(childBody, query);
+            if (childDistance !== undefined && (closestDistance === undefined || childDistance < closestDistance)) {
+                closestDistance = childDistance;
+            }
+        }
+        return closestDistance;
+    }
     return rayAabbDistance(toBounds(body), query);
 }
 function rayHullBodyDistance(body, shape, query) {
@@ -3425,13 +3544,61 @@ function countCandidatePairs(bodies) {
     countCandidatePairsCalls += 1;
     return broadphaseCandidatePairs(bodies).length;
 }
+function compoundChildDetailedHit(body, query, distance) {
+    if (body.shape.type !== 'compound') {
+        return undefined;
+    }
+    let bestChildIndex;
+    let bestNormal;
+    let bestDistDiff = Infinity;
+    for (let index = 0; index < body.shape.children.length; index += 1) {
+        const child = body.shape.children[index];
+        const childBody = {
+            ...body,
+            x: (body.x ?? 0) + (child.offset?.x ?? 0),
+            y: (body.y ?? 0) + (child.offset?.y ?? 0),
+            z: (body.z ?? 0) + (child.offset?.z ?? 0),
+            shape: child.shape,
+            rx: (body.rx ?? 0) + canonicalQuarterTurns(child.quarterTurns?.x ?? 0) / 4,
+            ry: (body.ry ?? 0) + canonicalQuarterTurns(child.quarterTurns?.y ?? 0) / 4,
+            rz: (body.rz ?? 0) + canonicalQuarterTurns(child.quarterTurns?.z ?? 0) / 4,
+        };
+        const childDist = 'dx' in query ? rayBodyDistance(childBody, query) : undefined;
+        if (childDist !== undefined) {
+            const diff = Math.abs(childDist - distance);
+            if (diff < bestDistDiff) {
+                bestDistDiff = diff;
+                bestChildIndex = index;
+                const center = quantizePoint({
+                    x: query.x + query.dx * childDist,
+                    y: query.y + query.dy * childDist,
+                    z: query.z + query.dz * childDist,
+                });
+                bestNormal = hitNormalForBody(childBody, center);
+            }
+        }
+    }
+    if (bestChildIndex !== undefined && bestNormal !== undefined) {
+        return { childIndex: bestChildIndex, normal: bestNormal };
+    }
+    return undefined;
+}
 function detailedHitForBody(body, query, distance, castRadius) {
     const center = quantizePoint({
         x: query.x + query.dx * distance,
         y: query.y + query.dy * distance,
         z: query.z + query.dz * distance,
     });
-    const normal = hitNormalForBody(body, center);
+    let normal;
+    let childIndex;
+    if (body.shape.type === 'compound') {
+        const compoundHit = compoundChildDetailedHit(body, query, distance);
+        childIndex = compoundHit?.childIndex;
+        normal = compoundHit?.normal ?? hitNormalForBody(body, center);
+    }
+    else {
+        normal = hitNormalForBody(body, center);
+    }
     const point = quantizePoint({
         x: center.x - normal.x * castRadius,
         y: center.y - normal.y * castRadius,
@@ -3443,6 +3610,7 @@ function detailedHitForBody(body, query, distance, castRadius) {
         point,
         normal,
         penetration: distance === 0 ? penetrationAtPoint(body, center, castRadius) : 0,
+        childIndex,
     };
 }
 function hitNormalForBody(body, point) {
@@ -3453,6 +3621,24 @@ function hitNormalForBody(body, point) {
             z: point.z - body.z,
         });
     }
+    if (body.shape.type === 'capsule') {
+        const halfHeight = body.shape.halfHeight;
+        let localPoint = { x: point.x - body.x, y: point.y - body.y, z: point.z - body.z };
+        if (body.orientation !== undefined) {
+            localPoint = rotatePointByQuatInverse(body.orientation, localPoint);
+        }
+        const clampedY = Math.max(-halfHeight, Math.min(halfHeight, localPoint.y));
+        const localDelta = {
+            x: localPoint.x,
+            y: localPoint.y - clampedY,
+            z: localPoint.z,
+        };
+        const localNormal = normalizePoint(localDelta);
+        if (body.orientation !== undefined) {
+            return normalizePoint(rotatePointByQuat(body.orientation, localNormal));
+        }
+        return localNormal;
+    }
     const bounds = toBounds(body);
     const candidates = [
         { normal: { x: -1, y: 0, z: 0 }, distance: Math.abs(point.x - bounds.minX), axis: 'x-' },

package/dist/runtime-room-metadata.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The runtime a deterministic room simulates: engine identity plus the
+ * canonical session config (the game's rules) it was created with.
+ *
+ * This is the ONE implementation. The build mints a pin with
+ * `createSyncplayRuntimePin`, the publish path validates it, and the room
+ * server validates it again on room create — all through
+ * `parseSyncplayRuntimeRoomMetadata` below. A second copy of these rules is how
+ * a pin could pass one gate and fail another.
+ */
+export declare const MAX_SYNCPLAY_SESSION_CONFIG_BYTES: 65536;
+export interface SyncplayRuntimeIdentity {
+    readonly abiVersion: 1;
+    readonly tickRate: 10 | 20 | 30 | 60;
+    readonly inputSchemaId: string;
+    readonly stateSchemaId: string;
+    readonly deterministicVersion: string;
+    readonly engineIdentityHash: string;
+}
+/** Wire shape: `sessionConfigBytes` is canonical base64. */
+export interface SyncplayRuntimeRoomMetadata {
+    readonly runtimeIdentity: SyncplayRuntimeIdentity;
+    readonly sessionConfigBytes: string;
+    readonly sessionConfigDigest: string;
+}
+/** Parsed shape: `sessionConfigBytes` decoded. */
+export interface ParsedSyncplayRuntimeRoomMetadata {
+    readonly runtimeIdentity: SyncplayRuntimeIdentity;
+    readonly sessionConfigBytes: Uint8Array;
+    readonly sessionConfigDigest: string;
+}
+/** A game's runtime config, as its simulation module exports it. */
+export interface SyncplayRuntimeConfigInput {
+    readonly runtimeIdentity: SyncplayRuntimeIdentity;
+    readonly sessionConfigBytes: Uint8Array;
+    readonly sessionConfigDigest: string;
+}
+export declare function parseSyncplayRuntimeRoomMetadata(value: unknown): ParsedSyncplayRuntimeRoomMetadata;
+/**
+ * Mint the wire-shaped runtime pin a build stamps into its rooms config.
+ *
+ * Validates through `parseSyncplayRuntimeRoomMetadata`, so a pin that mints is
+ * a pin that publishes and loads. Throws rather than returning a bad pin: the
+ * room server treats the pin as authoritative over player-supplied ticket
+ * metadata, so a wrong pin is worse than no pin.
+ */
+export declare function createSyncplayRuntimePin(input: SyncplayRuntimeConfigInput): SyncplayRuntimeRoomMetadata;

package/dist/runtime-room-metadata.js

@@ -0,0 +1,84 @@
+/**
+ * The runtime a deterministic room simulates: engine identity plus the
+ * canonical session config (the game's rules) it was created with.
+ *
+ * This is the ONE implementation. The build mints a pin with
+ * `createSyncplayRuntimePin`, the publish path validates it, and the room
+ * server validates it again on room create — all through
+ * `parseSyncplayRuntimeRoomMetadata` below. A second copy of these rules is how
+ * a pin could pass one gate and fail another.
+ */
+import { kinetixSessionConfigDigest, MAX_KINETIX_SESSION_CONFIG_BYTES, } from '@series-inc/rundot-syncplay/core/runtime';
+export const MAX_SYNCPLAY_SESSION_CONFIG_BYTES = MAX_KINETIX_SESSION_CONFIG_BYTES;
+export function parseSyncplayRuntimeRoomMetadata(value) {
+    if (!isRecord(value) || !hasExactKeys(value, ['runtimeIdentity', 'sessionConfigBytes', 'sessionConfigDigest'])) {
+        throw new Error('syncplay runtime metadata is missing or malformed');
+    }
+    const identity = value.runtimeIdentity;
+    if (!isRecord(identity)
+        || !hasExactKeys(identity, ['abiVersion', 'tickRate', 'inputSchemaId', 'stateSchemaId', 'deterministicVersion', 'engineIdentityHash'])
+        || identity.abiVersion !== 1
+        || ![10, 20, 30, 60].includes(identity.tickRate)
+        || !isNonEmptyString(identity.inputSchemaId)
+        || !isNonEmptyString(identity.stateSchemaId)
+        || !isNonEmptyString(identity.deterministicVersion)
+        || !isNonEmptyString(identity.engineIdentityHash)) {
+        throw new Error('syncplay runtime identity is malformed');
+    }
+    if (typeof value.sessionConfigBytes !== 'string' || !isCanonicalBase64(value.sessionConfigBytes)) {
+        throw new Error('syncplay session config bytes are not canonical base64');
+    }
+    const bytes = Uint8Array.from(Buffer.from(value.sessionConfigBytes, 'base64'));
+    if (bytes.byteLength < 1 || bytes.byteLength > MAX_SYNCPLAY_SESSION_CONFIG_BYTES) {
+        throw new Error('syncplay session config bytes are empty or oversized');
+    }
+    if (typeof value.sessionConfigDigest !== 'string'
+        || value.sessionConfigDigest !== kinetixSessionConfigDigest(bytes)) {
+        throw new Error('syncplay session config digest mismatch');
+    }
+    return {
+        runtimeIdentity: identity,
+        sessionConfigBytes: bytes,
+        sessionConfigDigest: value.sessionConfigDigest,
+    };
+}
+/**
+ * Mint the wire-shaped runtime pin a build stamps into its rooms config.
+ *
+ * Validates through `parseSyncplayRuntimeRoomMetadata`, so a pin that mints is
+ * a pin that publishes and loads. Throws rather than returning a bad pin: the
+ * room server treats the pin as authoritative over player-supplied ticket
+ * metadata, so a wrong pin is worse than no pin.
+ */
+export function createSyncplayRuntimePin(input) {
+    // Check the caller's own keys before re-shaping: building a fresh object
+    // would silently drop a stray top-level key instead of rejecting it.
+    if (!isRecord(input)
+        || !hasExactKeys(input, ['runtimeIdentity', 'sessionConfigBytes', 'sessionConfigDigest'])) {
+        throw new Error('syncplay runtime config must carry exactly runtimeIdentity, sessionConfigBytes, sessionConfigDigest');
+    }
+    if (!(input.sessionConfigBytes instanceof Uint8Array)) {
+        throw new Error('syncplay runtime config sessionConfigBytes must be a Uint8Array');
+    }
+    const pin = {
+        runtimeIdentity: input.runtimeIdentity,
+        sessionConfigBytes: Buffer.from(input.sessionConfigBytes).toString('base64'),
+        sessionConfigDigest: input.sessionConfigDigest,
+    };
+    parseSyncplayRuntimeRoomMetadata(pin);
+    return pin;
+}
+function hasExactKeys(value, expected) {
+    return Object.keys(value).sort().join('\0') === [...expected].sort().join('\0');
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isCanonicalBase64(value) {
+    if (value.length === 0 || value.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/u.test(value))
+        return false;
+    return Buffer.from(value, 'base64').toString('base64') === value;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/session-snapshot.d.ts

@@ -51,6 +51,30 @@ export declare function encodeDeterministicStateSnapshot(snapshot: Deterministic
 export declare function decodeDeterministicStateSnapshot(text: string): DeterministicStateSnapshotDecodeResult;
 export declare function bytesToBase64(bytes: Uint8Array): string;
 export declare function base64ToBytes(text: string): Uint8Array;
+/**
+ * Fixed bytes the wire framing adds around a chunk: 225 B for the
+ * `snapshot-chunk` envelope plus 76 B for the SDK transport's outer
+ * {type,msgType,data} wrapper. Held at 512 B for headroom on transferId and
+ * checksum length changes.
+ */
+export declare const SNAPSHOT_CHUNK_ENVELOPE_OVERHEAD_BYTES = 512;
+/**
+ * Worst-case multiplicative growth of a chunk string on its way to the wire.
+ * `snapshotBytes` is JSON (`encodeDeterministicStateSnapshot` -> canonicalStringify),
+ * NOT base64, so it is quote-dense — and it is JSON-escaped TWICE: into the
+ * `snapshot-chunk` envelope, then again when the SDK transport stringifies the
+ * outer message (run-room-transport `sendRaw` -> RundotServerRoom
+ * {type,msgType,data} -> ServerWebSocket `JSON.stringify`). A `"` becomes `\"`
+ * becomes `\\\"`. Measured at exactly 4.001x for all-quote and all-backslash
+ * payloads; a realistic base64-dominated snapshot lands at ~1.001x.
+ *
+ * The room server's boot guard requires
+ * WS_MAX_MESSAGE_SIZE >= DEFAULT_SNAPSHOT_CHUNK_SIZE * this + the fixed overhead.
+ * A cap below that makes `ws` raise "Max payload size exceeded" and close the
+ * socket 1006, failing every snapshot transfer for that room — the 2026-08-25
+ * lattice incident. See .plans/syncplay-snapshot-cap-and-observability.md.
+ */
+export declare const MAX_JSON_ESCAPE_EXPANSION = 4;
 export declare const DEFAULT_SNAPSHOT_CHUNK_SIZE = 262144;
 export declare const DEFAULT_MAX_SNAPSHOT_BYTES = 4194304;
 export interface CreateSnapshotTransferOptions {

package/dist/session-snapshot.js

@@ -155,6 +155,30 @@ export function base64ToBytes(text) {
     return bytes;
 }
 // ── transfer builder (raw bytes → frozen wire transfer shape) ──
+/**
+ * Fixed bytes the wire framing adds around a chunk: 225 B for the
+ * `snapshot-chunk` envelope plus 76 B for the SDK transport's outer
+ * {type,msgType,data} wrapper. Held at 512 B for headroom on transferId and
+ * checksum length changes.
+ */
+export const SNAPSHOT_CHUNK_ENVELOPE_OVERHEAD_BYTES = 512;
+/**
+ * Worst-case multiplicative growth of a chunk string on its way to the wire.
+ * `snapshotBytes` is JSON (`encodeDeterministicStateSnapshot` -> canonicalStringify),
+ * NOT base64, so it is quote-dense — and it is JSON-escaped TWICE: into the
+ * `snapshot-chunk` envelope, then again when the SDK transport stringifies the
+ * outer message (run-room-transport `sendRaw` -> RundotServerRoom
+ * {type,msgType,data} -> ServerWebSocket `JSON.stringify`). A `"` becomes `\"`
+ * becomes `\\\"`. Measured at exactly 4.001x for all-quote and all-backslash
+ * payloads; a realistic base64-dominated snapshot lands at ~1.001x.
+ *
+ * The room server's boot guard requires
+ * WS_MAX_MESSAGE_SIZE >= DEFAULT_SNAPSHOT_CHUNK_SIZE * this + the fixed overhead.
+ * A cap below that makes `ws` raise "Max payload size exceeded" and close the
+ * socket 1006, failing every snapshot transfer for that room — the 2026-08-25
+ * lattice incident. See .plans/syncplay-snapshot-cap-and-observability.md.
+ */
+export const MAX_JSON_ESCAPE_EXPANSION = 4;
 export const DEFAULT_SNAPSHOT_CHUNK_SIZE = 262_144;
 export const DEFAULT_MAX_SNAPSHOT_BYTES = 4_194_304;
 export function createSnapshotTransferFromBytes(snapshotBytes, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/rundot-syncplay",
-  "version": "5.26.0-beta.9",
+  "version": "5.27.0",
   "description": "Kinetix orchestration, rollback, replay, late-join, and deterministic networking for RUN.game",
   "repository": {
     "type": "git",
@@ -160,9 +160,10 @@
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
     "test": "npm run test:core && npm run test:unit-control && npm run test:entity-registry",
     "test:module-promotion": "node --expose-gc --import tsx --test tests/module-promotion.test.ts tests/module-docs.test.ts tests/module-bundle-budget.test.ts scripts/prove-module-promotion.test.mjs",
-    "test:core": "node --expose-gc --import tsx --test --test-concurrency=1 tests/canonical.test.ts tests/canonical-portability.test.ts tests/runtime-session.test.ts tests/kinetix-runtime-session.test.ts tests/runtime-support.test.ts tests/runtime-guards.test.ts tests/r3f-render-adapter.test.ts tests/snapshot-cost.test.ts tests/sdkSession.test.ts tests/input-authority.test.ts tests/session-wire.test.ts tests/session-snapshot.test.ts tests/authority-room.test.ts tests/networked-client-snapshot.test.ts tests/runner.test.ts tests/testing.test.ts tests/browser-session.test.ts tests/secret-config.test.ts tests/secret-protocol.test.ts tests/secret-authority.test.ts tests/secret-client.test.ts tests/late-join-checksum.test.ts tests/late-join-input-backfill.test.ts tests/replay-scoring.test.ts tests/bot-backfill.test.ts tests/latency-simulation.test.ts tests/production-input-budget.test.ts tests/time-sync.test.ts tests/match-log.test.ts tests/spectator.test.ts tests/synctest.test.ts tests/instant-replay.test.ts tests/session-promotion.test.ts tests/physics3d-broadphase-stats.test.ts tests/entrypoints.test.ts tests/export-surface.test.ts tests/module-seam.test.ts tests/module-contract-portability.test.ts tests/module-identity.test.ts tests/module-corpus.test.ts tests/component-model.test.ts tests/component-model-rollback.test.ts tests/component-model-integration.test.ts tests/actors-ai.test.ts tests/character-3d.test.ts tests/character-3d-certification.test.ts tests/combat-modules.test.ts tests/combat-modules-integration.test.ts tests/firearm.test.ts tests/gameplay-effects.test.ts tests/spatial-interaction.test.ts tests/stats-abilities.test.ts tests/inventory-equipment.test.ts tests/inventory-equipment-certification.test.ts tests/platformer-2d.test.ts tests/platformer-2d-certification.test.ts tests/module-promotion.test.ts tests/module-docs.test.ts tests/module-bundle-budget.test.ts tests/published-side-effects.test.ts tests/host-timing.test.ts tests/test-manifest.test.ts tests/coarse-region.test.ts tests/input-codec.test.ts tests/command-ingress.test.ts tests/session-reconfigure.test.ts tests/prediction-mode.test.ts tests/ephemeral-channel.test.ts tests/runner-surface.test.ts tests/runner-harness.test.ts tests/effects-adapter-bounds.test.ts tests/simulated-match-secrets.test.ts tests/run-glue-surface.test.mjs core/tests/core-boundary.test.mjs tests/math-core-parity.test.ts tests/math-profile.test.ts tests/movement3d-kcc-unit-contract.test.ts tests/movement3d-static-ground.test.ts",
+    "test:core": "node --expose-gc --import tsx --test --test-concurrency=1 tests/canonical.test.ts tests/canonical-portability.test.ts tests/runtime-session.test.ts tests/kinetix-runtime-session.test.ts tests/runtime-support.test.ts tests/runtime-guards.test.ts tests/r3f-render-adapter.test.ts tests/snapshot-cost.test.ts tests/sdkSession.test.ts tests/input-authority.test.ts tests/session-wire.test.ts tests/runtime-room-metadata.test.ts tests/session-snapshot.test.ts tests/authority-room.test.ts tests/networked-client-snapshot.test.ts tests/runner.test.ts tests/testing.test.ts tests/browser-session.test.ts tests/secret-config.test.ts tests/secret-protocol.test.ts tests/secret-authority.test.ts tests/secret-client.test.ts tests/late-join-checksum.test.ts tests/late-join-input-backfill.test.ts tests/replay-scoring.test.ts tests/bot-backfill.test.ts tests/latency-simulation.test.ts tests/production-input-budget.test.ts tests/time-sync.test.ts tests/match-log.test.ts tests/spectator.test.ts tests/synctest.test.ts tests/instant-replay.test.ts tests/session-promotion.test.ts tests/physics3d-broadphase-stats.test.ts tests/entrypoints.test.ts tests/export-surface.test.ts tests/module-seam.test.ts tests/module-contract-portability.test.ts tests/module-identity.test.ts tests/module-corpus.test.ts tests/component-model.test.ts tests/component-model-rollback.test.ts tests/component-model-integration.test.ts tests/actors-ai.test.ts tests/character-3d.test.ts tests/character-3d-certification.test.ts tests/combat-modules.test.ts tests/combat-modules-integration.test.ts tests/firearm.test.ts tests/gameplay-effects.test.ts tests/spatial-interaction.test.ts tests/stats-abilities.test.ts tests/inventory-equipment.test.ts tests/inventory-equipment-certification.test.ts tests/platformer-2d.test.ts tests/platformer-2d-certification.test.ts tests/module-promotion.test.ts tests/module-docs.test.ts tests/module-bundle-budget.test.ts tests/published-side-effects.test.ts tests/host-timing.test.ts tests/test-manifest.test.ts tests/coarse-region.test.ts tests/input-codec.test.ts tests/command-ingress.test.ts tests/session-reconfigure.test.ts tests/prediction-mode.test.ts tests/ephemeral-channel.test.ts tests/runner-surface.test.ts tests/runner-harness.test.ts tests/effects-adapter-bounds.test.ts tests/simulated-match-secrets.test.ts tests/run-glue-surface.test.mjs core/tests/core-boundary.test.mjs tests/math-core-parity.test.ts tests/math-profile.test.ts tests/movement3d-kcc-unit-contract.test.ts tests/movement3d-static-ground.test.ts",
+    "test:sdk-contract": "node --import tsx --test tests/sdk-runtime-contract.test.ts",
     "test:soak": "tsx --test tests/runtime-soak.test.ts",
-    "test:extended": "tsx --test tests/kcc-vehicle-characterization.test.ts tests/animation.test.ts tests/asset-cooking.test.ts tests/backend-proof-checksum-vectors.test.ts tests/bot-documents.test.ts tests/bot-primitives.test.ts tests/collider-cooking.test.ts tests/collision.test.ts tests/command-timeline.test.ts tests/config-bundle.test.ts tests/cosmetic-physics3d.test.ts tests/deterministic-primitives.test.ts tests/ecs-lite.test.ts tests/effects-adapter.test.ts tests/engine-runtime.test.ts tests/errors.test.ts tests/events.test.ts tests/input-button.test.ts tests/load-128-players.test.ts tests/math.test.ts tests/movement.test.ts tests/movement3d.test.ts tests/multiclient-authority.test.ts tests/navigation.test.ts tests/noise.test.ts tests/physics-cert.test.ts tests/physics2d.test.ts tests/physics3d-ccd.test.ts tests/physics3d-coverage.test.ts tests/physics3d-destruction-cert.test.ts tests/physics3d-geometry-limits.test.ts tests/physics3d-heightfield.test.ts tests/physics3d-hull.test.ts tests/physics3d-joints.test.ts tests/physics3d-kinematic-mesh.test.ts tests/physics3d-mass.test.ts tests/physics3d-materials.test.ts tests/physics3d-mesh-onesided.test.ts tests/physics3d-query-index.test.ts tests/physics3d-recipes.test.ts tests/physics3d-rotation-convention.test.ts tests/physics3d-shared.test.ts tests/physics3d-sleeping-manifold-reuse.test.ts tests/physics3d-solver.test.ts tests/physics3d-static-memoization.test.ts tests/physics3d-static-overlap-memo.test.ts tests/physics3d-cylinder-hull.test.ts tests/physics3d-stacking.test.ts tests/physics3d-toi.test.ts tests/physics3d-vehicle.test.ts tests/physics3d-voxel.test.ts tests/physics3d-world-edit.test.ts tests/physics3d.test.ts tests/physics-vector-generator.test.ts tests/random.test.ts tests/rollback-history.test.ts tests/schema-artifacts.test.ts tests/schema-codegen.test.ts tests/schema-dsl-binary.test.ts tests/schema.test.ts tests/signals.test.ts tests/sparse-set.test.ts tests/static-checker.test.ts tests/system-lifecycle.test.ts tests/wire-canonical-sentinels.test.ts tests/ws-frame.test.ts",
+    "test:extended": "tsx --test tests/kcc-vehicle-characterization.test.ts tests/animation.test.ts tests/asset-cooking.test.ts tests/backend-proof-checksum-vectors.test.ts tests/bot-documents.test.ts tests/bot-primitives.test.ts tests/collider-cooking.test.ts tests/collision.test.ts tests/command-timeline.test.ts tests/config-bundle.test.ts tests/cosmetic-physics3d.test.ts tests/deterministic-primitives.test.ts tests/ecs-lite.test.ts tests/effects-adapter.test.ts tests/engine-runtime.test.ts tests/errors.test.ts tests/events.test.ts tests/input-button.test.ts tests/load-128-players.test.ts tests/math.test.ts tests/movement.test.ts tests/movement3d.test.ts tests/multiclient-authority.test.ts tests/navigation.test.ts tests/noise.test.ts tests/physics-cert.test.ts tests/physics2d.test.ts tests/physics3d-ccd.test.ts tests/physics3d-coverage.test.ts tests/physics3d-destruction-cert.test.ts tests/physics3d-geometry-limits.test.ts tests/physics3d-heightfield.test.ts tests/physics3d-hull.test.ts tests/physics3d-joints.test.ts tests/physics3d-kinematic-mesh.test.ts tests/physics3d-kinematic-poses.test.ts tests/physics3d-mass.test.ts tests/physics3d-materials.test.ts tests/physics3d-mesh-onesided.test.ts tests/physics3d-queries-capsule-childindex.test.ts tests/physics3d-query-index.test.ts tests/physics3d-recipes.test.ts tests/physics3d-rotation-convention.test.ts tests/physics3d-shared.test.ts tests/physics3d-sleeping-manifold-reuse.test.ts tests/physics3d-solver.test.ts tests/physics3d-static-memoization.test.ts tests/physics3d-static-overlap-memo.test.ts tests/physics3d-cylinder-hull.test.ts tests/physics3d-stacking.test.ts tests/physics3d-toi.test.ts tests/physics3d-vehicle.test.ts tests/physics3d-voxel-dda.test.ts tests/physics3d-voxel.test.ts tests/physics3d-world-edit.test.ts tests/physics3d.test.ts tests/physics-vector-generator.test.ts tests/random.test.ts tests/rollback-history.test.ts tests/schema-artifacts.test.ts tests/schema-codegen.test.ts tests/schema-dsl-binary.test.ts tests/schema.test.ts tests/signals.test.ts tests/sparse-set.test.ts tests/static-checker.test.ts tests/system-lifecycle.test.ts tests/wire-canonical-sentinels.test.ts tests/ws-frame.test.ts",
     "test:ci": "npm run build && npm run test",
     "build:native": "node core/scripts/build-native.mjs",
     "build:mobile-native": "node core/scripts/build-mobile-native.mjs",