@vgai/live 0.5.39 → 0.5.41

package/dist/game-client/client.d.ts

@@ -226,6 +226,15 @@ export declare class GameClient {
     providers(): Promise<ProviderInfo[]>;
     commands(): Promise<DebugCommandInfo[]>;
     snapshot(sinceSeq?: number): Promise<DebugSnapshot>;
+    /**
+     * Read only the simulation clock for a predicate-free wait.
+     *
+     * `snapshot()` intentionally batches every declared provider for `waitFor`, whose predicate may
+     * read any of them. `waitSimTime` has no predicate: serializing a large `unity` provider every
+     * 150ms can itself consume multiple frames and corrupt the performance window it is advancing.
+     * Keep the two hardening observers fed exactly as an ordinary snapshot does.
+     */
+    private readTime;
     /** Fixture-teardown perf read: p50/p95 effective ticks-per-second over all
      *  the snapshot polls this test performed. */
     tpsStats(): TpsStats;

package/dist/game-client/client.js

@@ -504,6 +504,20 @@ export class GameClient {
         await this.#hiddenRecovery.observeTick(snap.time.tick);
         return snap;
     }
+    /**
+     * Read only the simulation clock for a predicate-free wait.
+     *
+     * `snapshot()` intentionally batches every declared provider for `waitFor`, whose predicate may
+     * read any of them. `waitSimTime` has no predicate: serializing a large `unity` provider every
+     * 150ms can itself consume multiple frames and corrupt the performance window it is advancing.
+     * Keep the two hardening observers fed exactly as an ordinary snapshot does.
+     */
+    async readTime() {
+        const time = await this.callBridge('state', 'time');
+        this.#tps.record(time.tick, Date.now());
+        await this.#hiddenRecovery.observeTick(time.tick);
+        return time;
+    }
     /** Fixture-teardown perf read: p50/p95 effective ticks-per-second over all
      *  the snapshot polls this test performed. */
     tpsStats() {
@@ -622,12 +636,15 @@ export class GameClient {
         // goes heartbeat-silent well before this loop's own guard ever needs to.
         let heartbeat = { lastEmitWallMs: startWall, lastEmitTick: start.time.tick };
         for (;;) {
-            const current = await this.snapshot();
-            if (current.time.simSeconds - start.time.simSeconds >= budget.simSeconds)
+            const currentTime = await this.readTime();
+            if (currentTime.simSeconds - start.time.simSeconds >= budget.simSeconds)
                 return;
-            stalledPolls = lastTick !== null && current.time.tick === lastTick ? stalledPolls + 1 : 0;
-            lastTick = current.time.tick;
+            stalledPolls = lastTick !== null && currentTime.tick === lastTick ? stalledPolls + 1 : 0;
+            lastTick = currentTime.tick;
             if (stalledPolls >= WAIT_FOR_STALL_POLL_LIMIT) {
+                // Failure diagnostics still carry one honest complete terminal snapshot. The hot path above
+                // stays clock-only; the expensive provider batch is paid only when it will be printed.
+                const current = await this.snapshot();
                 throw await this.toSessionFailure(new WaitForTimeoutError({
                     budget,
                     startSnapshot: start,
@@ -639,8 +656,8 @@ export class GameClient {
             }
             const heartbeatResult = maybeHeartbeat({
                 nowMs: Date.now(),
-                tick: current.time.tick,
-                simSeconds: current.time.simSeconds,
+                tick: currentTime.tick,
+                simSeconds: currentTime.simSeconds,
                 testTitle: this.#testTitle,
                 state: heartbeat,
             });

package/dist/game-client/relay-transport.js

@@ -171,7 +171,10 @@ export class RelayTransport {
     }
     async call(method, callArgs) {
         const hidden = await this.preflightHidden();
-        if (method === 'snapshot') {
+        // A predicate-free `waitSimTime` poll reads only the `time` provider. It needs the same hidden
+        // tab deterministic driver as a full snapshot or a hidden editor would freeze that lighter
+        // clock read forever.
+        if (method === 'snapshot' || (method === 'state' && callArgs[0] === 'time')) {
             if (hidden) {
                 const now = Date.now();
                 const elapsed = this.hiddenDriveLastWallMs === null ? 1000 / 60 : now - this.hiddenDriveLastWallMs;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/live",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.39",
+  "version": "0.5.41",
   "type": "module",
   "repository": {
     "type": "git",
@@ -32,8 +32,8 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@vgai/editor-sdk": "0.5.39",
-    "@vgai/sdk": "0.5.39"
+    "@vgai/editor-sdk": "0.5.41",
+    "@vgai/sdk": "0.5.41"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.58.2 <2"

package/src/game-client/client.ts

@@ -628,6 +628,21 @@ export class GameClient {
     return snap;
   }
 
+  /**
+   * Read only the simulation clock for a predicate-free wait.
+   *
+   * `snapshot()` intentionally batches every declared provider for `waitFor`, whose predicate may
+   * read any of them. `waitSimTime` has no predicate: serializing a large `unity` provider every
+   * 150ms can itself consume multiple frames and corrupt the performance window it is advancing.
+   * Keep the two hardening observers fed exactly as an ordinary snapshot does.
+   */
+  private async readTime(): Promise<DebugSnapshot['time']> {
+    const time = await this.callBridge<DebugSnapshot['time']>('state', 'time');
+    this.#tps.record(time.tick, Date.now());
+    await this.#hiddenRecovery.observeTick(time.tick);
+    return time;
+  }
+
   /** Fixture-teardown perf read: p50/p95 effective ticks-per-second over all
    *  the snapshot polls this test performed. */
   tpsStats(): TpsStats {
@@ -755,11 +770,14 @@ export class GameClient {
     // goes heartbeat-silent well before this loop's own guard ever needs to.
     let heartbeat: HeartbeatState = { lastEmitWallMs: startWall, lastEmitTick: start.time.tick };
     for (;;) {
-      const current = await this.snapshot();
-      if (current.time.simSeconds - start.time.simSeconds >= budget.simSeconds) return;
-      stalledPolls = lastTick !== null && current.time.tick === lastTick ? stalledPolls + 1 : 0;
-      lastTick = current.time.tick;
+      const currentTime = await this.readTime();
+      if (currentTime.simSeconds - start.time.simSeconds >= budget.simSeconds) return;
+      stalledPolls = lastTick !== null && currentTime.tick === lastTick ? stalledPolls + 1 : 0;
+      lastTick = currentTime.tick;
       if (stalledPolls >= WAIT_FOR_STALL_POLL_LIMIT) {
+        // Failure diagnostics still carry one honest complete terminal snapshot. The hot path above
+        // stays clock-only; the expensive provider batch is paid only when it will be printed.
+        const current = await this.snapshot();
         throw await this.toSessionFailure(
           new WaitForTimeoutError({
             budget,
@@ -774,8 +792,8 @@ export class GameClient {
       }
       const heartbeatResult = maybeHeartbeat({
         nowMs: Date.now(),
-        tick: current.time.tick,
-        simSeconds: current.time.simSeconds,
+        tick: currentTime.tick,
+        simSeconds: currentTime.simSeconds,
         testTitle: this.#testTitle,
         state: heartbeat,
       });

package/src/game-client/relay-transport.ts

@@ -232,7 +232,10 @@ export class RelayTransport implements BridgeTransport {
 
   async call(method: string, callArgs: unknown[]): Promise<BridgeCallOutcome> {
     const hidden = await this.preflightHidden();
-    if (method === 'snapshot') {
+    // A predicate-free `waitSimTime` poll reads only the `time` provider. It needs the same hidden
+    // tab deterministic driver as a full snapshot or a hidden editor would freeze that lighter
+    // clock read forever.
+    if (method === 'snapshot' || (method === 'state' && callArgs[0] === 'time')) {
       if (hidden) {
         const now = Date.now();
         const elapsed =