peachsim 0.1.2207 → 0.1.2209

package/cli/commands/inspect.ts

@@ -711,8 +711,8 @@ async function getKeyboardState(bridge: WsBridge) {
     .send({
       type: 'evaluate',
       code: `(async () => {
-      const kb = window.__sootsimKeyboard
-      const test = window.__sootsimTest
+      const kb = globalThis.__sootsimKeyboard
+      const test = globalThis.__sootsimTest
       if (!kb) return { error: 'keyboard bridge not available' }
       const layout = typeof kb.getLayout === 'function' ? kb.getLayout() : null
       const secureTextEntry =
@@ -818,11 +818,11 @@ async function runShellVisualCommand(
         // documentElement '#333333' sniff is never set in embedded / shell-chrome
         // contexts, so 'toggle' read 'light' forever and stuck on the boot scheme.
         window.postMessage({ type: 'contrast-action', action: 'set-appearance', value: requested }, '*')
-        // let the engine's message handler apply + publish window.__sootsimColorScheme
+        // let the engine's message handler apply + publish globalThis.__sootsimColorScheme
         await new Promise((r) => setTimeout(r, 60))
-        const applied = window.__sootsimColorScheme?.resolved
+        const applied = globalThis.__sootsimColorScheme?.resolved
           ?? (window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ? 'dark' : 'light')
-        const setting = window.__sootsimColorScheme?.setting ?? requested
+        const setting = globalThis.__sootsimColorScheme?.setting ?? requested
         return { ok: true, requested, setting, applied }
       })()`,
     })
@@ -832,7 +832,7 @@ async function runShellVisualCommand(
     return bridge.send({
       type: 'evaluate',
       code: `(async () => {
-        const toggleLock = window.SootSim?.bridges?.mainShell?.toggleLock
+        const toggleLock = globalThis.SootSim?.bridges?.mainShell?.toggleLock
         if (typeof toggleLock !== 'function') {
           throw new Error('peach mainShell.toggleLock bridge unavailable')
         }
@@ -1294,7 +1294,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         // merged console count (see MERGED_CONSOLE_COUNT_EVAL) so the notice agrees with `get errors`.
         code: `(async () => ({
           console: ${MERGED_CONSOLE_COUNT_EVAL},
-          requests: (await window.__sootsimTest?.getRequestCounts?.()) || null,
+          requests: (await globalThis.__sootsimTest?.getRequestCounts?.()) || null,
         }))()`,
       })
       return (raw as SummaryCounts) || { console: null, requests: null }
@@ -1439,7 +1439,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       payload = await evalInBridge<FooterPayload>(
         b,
         `(() => {
-          const tl = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.timeline
+          const tl = globalThis.SootSim && globalThis.SootSim.bridges && globalThis.SootSim.bridges.timeline
           if (!tl || typeof tl.summary !== 'function') return null
           const cursorKey = ${JSON.stringify(cliKey)}
           const summary = tl.summary({ sinceCursor: cursorKey })
@@ -2273,7 +2273,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const tiPayload = await bridge.send({
           type: 'evaluate',
           code: `(async () => {
-            const t = window.__sootsimTest
+            const t = globalThis.__sootsimTest
             if (!t) return null
             const n = await (t.findByTestId(${tiArg}) || t.findById(${tiArg}))
             if (!n || !n.absolutePosition || !n.layout) return null
@@ -2857,7 +2857,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             result = await bridge.send({
               type: 'evaluate',
               code: `(() => {
-                const h = window.__sootsimRenderHost
+                const h = globalThis.__sootsimRenderHost
                 if (!h || typeof h.getOwnershipSnapshot !== 'function') {
                   return { error: 'getOwnershipSnapshot not available' }
                 }
@@ -2869,8 +2869,8 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             result = await bridge.send({
               type: 'evaluate',
               code: `(async () => {
-                const kb = window.__sootsimKeyboard
-                const test = window.__sootsimTest
+                const kb = globalThis.__sootsimKeyboard
+                const test = globalThis.__sootsimTest
                 if (!kb) return { error: 'keyboard bridge not available' }
                 const layout = typeof kb.getLayout === 'function' ? kb.getLayout() : null
                 const secureTextEntry =
@@ -3206,7 +3206,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         let issuedReload = false
         let inPlaceReload = false
         // a reload rewrites the running app, so it takes the cli lease like any other write; a foreign lease refusal must not be swallowed by the reconnect handling below.
-        await evalInBridge(bridge, 'window.__sootsimConsole?.clear()', {
+        await evalInBridge(bridge, 'globalThis.__sootsimConsole?.clear()', {
           acquireLock: true,
         })
         try {
@@ -3231,7 +3231,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
                   if (m && m[1] !== loaded) engineStale = true
                 }
               } catch {}
-              const reloadExternalApp = window.SootSim?.bridges?.hotRemount?.reloadExternalApp
+              const reloadExternalApp = globalThis.SootSim?.bridges?.hotRemount?.reloadExternalApp
               // the restart can first finish work the running app owns, such
               // as suspending a recording, while the old app still answers
               // ready. resolve with it so the ready poll reads the new app.
@@ -3338,7 +3338,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       }
 
       case 'storage-clear': {
-        await evalInBridge(bridge, 'window.__sootsimConsole?.clear()', {
+        await evalInBridge(bridge, 'globalThis.__sootsimConsole?.clear()', {
           acquireLock: true,
         })
         const cleared = await evalInBridge(bridge, resetGuestAppStateEval(true), {
@@ -3504,18 +3504,18 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             globals['test (→ __sootsimTest)'] = testMethods
 
             // debug
-            if (window.__sootsimDebug) {
-              globals['debug (→ __sootsimDebug)'] = Object.keys(window.__sootsimDebug)
+            if (globalThis.__sootsimDebug) {
+              globals['debug (→ __sootsimDebug)'] = Object.keys(globalThis.__sootsimDebug)
             }
 
             // interact
-            if (window.__sootsimInteract) {
-              globals['interact (→ __sootsimInteract)'] = Object.keys(window.__sootsimInteract)
+            if (globalThis.__sootsimInteract) {
+              globals['interact (→ __sootsimInteract)'] = Object.keys(globalThis.__sootsimInteract)
             }
 
             // keyboard
-            if (window.__sootsimKeyboard) {
-              globals['keyboard (→ __sootsimKeyboard)'] = Object.keys(window.__sootsimKeyboard)
+            if (globalThis.__sootsimKeyboard) {
+              globals['keyboard (→ __sootsimKeyboard)'] = Object.keys(globalThis.__sootsimKeyboard)
             }
 
             // other globals
@@ -3588,7 +3588,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const result = await bridge.send({
               type: 'evaluate',
               code: `(async () => {
-                const perf = window.SootSim?.bridges?.scrollPerf
+                const perf = globalThis.SootSim?.bridges?.scrollPerf
                 if (!perf) return { error: 'scroll performance profile unavailable' }
                 await perf.start(${Math.floor(parsedLimit)}, ${JSON.stringify(pressTestID)})
                 return { started: true }
@@ -3607,7 +3607,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const result = await bridge.send({
               type: 'evaluate',
               code: `(async () => {
-                const perf = window.SootSim?.bridges?.scrollPerf
+                const perf = globalThis.SootSim?.bridges?.scrollPerf
                 if (!perf) return { error: 'scroll performance profile unavailable' }
                 return await perf.stop()
               })()`,
@@ -3689,10 +3689,10 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const result = await bridge.send({
               type: 'evaluate',
               code: `(async () => {
-                if (!window.__sootsimShellPerf) {
+                if (!globalThis.__sootsimShellPerf) {
                   return { error: 'shell frame profile unavailable (__sootsimShellPerf missing on the page)' }
                 }
-                await window.__sootsimShellPerf.start()
+                await globalThis.__sootsimShellPerf.start()
                 return { started: true }
               })()`,
             })
@@ -3710,10 +3710,10 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const result = await bridge.send({
               type: 'evaluate',
               code: `(async () => {
-                if (!window.__sootsimShellPerf) {
+                if (!globalThis.__sootsimShellPerf) {
                   return { error: 'shell frame profile unavailable (__sootsimShellPerf missing on the page)' }
                 }
-                return await window.__sootsimShellPerf.stop()
+                return await globalThis.__sootsimShellPerf.stop()
               })()`,
             })
             if (result?.error) {
@@ -3761,17 +3761,17 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const result = await bridge.send({
               type: 'evaluate',
               code: `(async () => {
-                if (!window.__sootsimShellPerf) {
+                if (!globalThis.__sootsimShellPerf) {
                   return { error: 'shell frame profile unavailable (__sootsimShellPerf missing on the page)' }
                 }
-                await window.__sootsimShellPerf.start()
+                await globalThis.__sootsimShellPerf.start()
                 // give a frame for profiling to engage before the event
                 await new Promise(r => requestAnimationFrame(() => r(undefined)))
                 window.dispatchEvent(new Event('${eventName}'))
                 // shell animations are ~300-500ms; fixed timing avoids complex
                 // animation-end detection
                 await new Promise(r => setTimeout(r, 600))
-                return await window.__sootsimShellPerf.stop()
+                return await globalThis.__sootsimShellPerf.stop()
               })()`,
             })
             if (result?.error) {
@@ -4006,7 +4006,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         if (sub === 'clear') {
           await bridge.send({
             type: 'evaluate',
-            code: 'window.__sootsimObservability?.network.clear(); "cleared"',
+            code: 'globalThis.__sootsimObservability?.network.clear(); "cleared"',
           })
           console.log('  network buffer cleared')
           break
@@ -4021,7 +4021,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           const entry = (await bridge.send({
             type: 'evaluate',
             code: `(() => {
-              const obs = window.__sootsimObservability;
+              const obs = globalThis.__sootsimObservability;
               if (!obs) return null;
               return obs.network.getSnapshot().find(e => e.id === ${JSON.stringify(id)}) || null;
             })()`,
@@ -4051,7 +4051,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           const entries = (await bridge.send({
             type: 'evaluate',
             code: `(() => {
-              const obs = window.__sootsimObservability;
+              const obs = globalThis.__sootsimObservability;
               if (!obs) return { ok: false };
               return { ok: true, entries: obs.network.getSnapshot() };
             })()`,

package/cli/commands/record-three.ts

@@ -138,7 +138,7 @@ examples:
     // remember the shell state we mutate so a plain run is side-effect free
     const before = await evalInPage<{ threeMode?: boolean; editor?: boolean }>(
       bridge,
-      `(() => { const s = window.SootSim?.bridges?.settings?.get?.() || {}
+      `(() => { const s = globalThis.SootSim?.bridges?.settings?.get?.() || {}
          return { threeMode: s.threeMode === true, editor: s.threeRecordingEditor === true } })()`,
     )
 
@@ -157,13 +157,13 @@ examples:
         // by the flow's open), and this phase records the flat canvas
         await evalInPage(
           bridge,
-          `(() => { const s = window.SootSim?.bridges?.settings
+          `(() => { const s = globalThis.SootSim?.bridges?.settings
              s?.set?.('threeRecordingEditor', false)
              s?.set?.('threeMode', false) })()`,
         )
         const started = await evalInPage<boolean>(
           bridge,
-          `(async () => !!(await window.SootSim?.bridges?.startRecording?.('video', undefined, { skipEntitlement: true })))()`,
+          `(async () => !!(await globalThis.SootSim?.bridges?.startRecording?.('video', undefined, { skipEntitlement: true })))()`,
         )
         if (!started) {
           throw new Error(
@@ -176,7 +176,7 @@ examples:
     })
     await sleep(400)
     const durationMs = Math.min(Date.now() - t0, MAX_FILM_MS)
-    await evalInPage(bridge, `window.SootSim?.bridges?.stopRecording?.()`)
+    await evalInPage(bridge, `globalThis.SootSim?.bridges?.stopRecording?.()`)
     if (flowCode !== 0) {
       console.error(
         `  record --three: flow failed (exit ${flowCode}) — not filming a broken take`,
@@ -189,7 +189,7 @@ examples:
       await sleep(400)
       const st = await evalInPage<{ state?: string; hasBlob?: boolean }>(
         bridge,
-        `(() => { const s = window.SootSim?.bridges?.getRecordingState?.()
+        `(() => { const s = globalThis.SootSim?.bridges?.getRecordingState?.()
            return { state: s?.state, hasBlob: !!s?.lastVideoBlob } })()`,
       )
       if (st?.state === 'idle' && st.hasBlob) {
@@ -206,20 +206,20 @@ examples:
     // -- phase 2: bring up the 3d stage + recording editor -----------------
     await evalInPage(
       bridge,
-      `window.SootSim?.bridges?.settings?.set?.('threeMode', true)`,
+      `globalThis.SootSim?.bridges?.settings?.set?.('threeMode', true)`,
     )
     await waitForThreeModeRuntimeReadyOnBridge(bridge)
     await sleep(1400)
     await evalInPage(
       bridge,
-      `window.SootSim?.bridges?.settings?.set?.('threeRecordingEditor', true)`,
+      `globalThis.SootSim?.bridges?.settings?.set?.('threeRecordingEditor', true)`,
     )
     let replaySeeded = false
     for (let i = 0; i < 60; i++) {
       await sleep(250)
       const seeded = await evalInPage<boolean>(
         bridge,
-        `(() => { const rs = window.SootSim?.replayStore
+        `(() => { const rs = globalThis.SootSim?.replayStore
            return rs?.value?.preview?.surface === 'video' && !!rs?.value?.preview?.flowVideoUrl })()`,
       )
       if (seeded) {
@@ -243,7 +243,7 @@ examples:
     const rec = await evalInPage<{ ok: boolean; error?: string }>(
       bridge,
       `(() => {
-        const c = window.SootSim?.bridges?.threeMode?.getCanvas?.()
+        const c = globalThis.SootSim?.bridges?.threeMode?.getCanvas?.()
         if (!c || !c.captureStream) return { ok: false, error: 'no stage canvas' }
         let mime = 'video/webm;codecs=vp9'
         if (!('MediaRecorder' in window) || !MediaRecorder.isTypeSupported(mime)) mime = 'video/webm'
@@ -257,7 +257,7 @@ examples:
           fr.onload = () => { st.b64 = String(fr.result).split(',')[1] || '' }
           fr.readAsDataURL(blob)
         }
-        window.__sootsimFilm = st
+        globalThis.__sootsimFilm = st
         mr.start(200)
         return { ok: true }
       })()`,
@@ -270,7 +270,7 @@ examples:
     await evalInPage(
       bridge,
       `((dur) => {
-        const rs = window.SootSim?.replayStore
+        const rs = globalThis.SootSim?.replayStore
         if (!rs) return false
         const probed = rs.value?.playback?.durationMs
         const total = probed && probed > 500 ? probed : dur
@@ -291,14 +291,14 @@ examples:
 
     await evalInPage(
       bridge,
-      `(() => { const s = window.__sootsimFilm; if (s?.mr?.state === 'recording') s.mr.stop(); return true })()`,
+      `(() => { const s = globalThis.__sootsimFilm; if (s?.mr?.state === 'recording') s.mr.stop(); return true })()`,
     )
     let b64Size = 0
     for (let i = 0; i < 60; i++) {
       await sleep(500)
       const probe = await evalInPage<{ ready: boolean; size: number }>(
         bridge,
-        `(() => { const s = window.__sootsimFilm; return { ready: !!(s && s.b64), size: s && s.b64 ? s.b64.length : 0 } })()`,
+        `(() => { const s = globalThis.__sootsimFilm; return { ready: !!(s && s.b64), size: s && s.b64 ? s.b64.length : 0 } })()`,
       )
       if (probe?.ready && probe.size > 0) {
         b64Size = probe.size
@@ -317,13 +317,13 @@ examples:
     for (let offset = 0; offset < b64Size; offset += CHUNK) {
       const part = await evalInPage<{ data: string }>(
         bridge,
-        `(() => ({ data: window.__sootsimFilm.b64.substr(${offset}, ${CHUNK}) }))()`,
+        `(() => ({ data: globalThis.__sootsimFilm.b64.substr(${offset}, ${CHUNK}) }))()`,
       )
       b64 += part.data
     }
     await evalInPage(
       bridge,
-      `(() => { try { delete window.__sootsimFilm } catch {} return true })()`,
+      `(() => { try { delete globalThis.__sootsimFilm } catch {} return true })()`,
     )
 
     const webmBytes = Buffer.from(b64, 'base64')
@@ -372,13 +372,13 @@ examples:
       if (!before?.editor) {
         await evalInPage(
           bridge,
-          `window.SootSim?.bridges?.settings?.set?.('threeRecordingEditor', false)`,
+          `globalThis.SootSim?.bridges?.settings?.set?.('threeRecordingEditor', false)`,
         )
       }
       if (!before?.threeMode) {
         await evalInPage(
           bridge,
-          `window.SootSim?.bridges?.settings?.set?.('threeMode', false)`,
+          `globalThis.SootSim?.bridges?.settings?.set?.('threeMode', false)`,
         )
       }
     }

package/cli/commands/record.ts

@@ -709,7 +709,7 @@ async function assertRecorderAvailable(bridge: WsBridge) {
   )
   if (!ok) {
     console.error(
-      '  window.__sootsimRecorder missing — is peach engine running in this sim?',
+      '  globalThis.__sootsimRecorder missing — is peach engine running in this sim?',
     )
     peachExit(1)
   }
@@ -840,7 +840,7 @@ async function renderStoreScene(
   const requestId: string | null = await bridge.send(
     {
       type: 'evaluate',
-      code: 'window.__sootsimRecorder.waitSceneVideoRequest()',
+      code: 'globalThis.__sootsimRecorder.waitSceneVideoRequest()',
     },
     { timeoutMs: UPLOAD_TIMEOUT_MS },
   )
@@ -852,7 +852,7 @@ async function renderStoreScene(
     for (;;) {
       const chunk: { data: string; offset: number; done: boolean } = await bridge.send({
         type: 'evaluate',
-        code: `window.__sootsimRecorder.getSceneVideoChunk(${JSON.stringify(requestId)}, ${offset})`,
+        code: `globalThis.__sootsimRecorder.getSceneVideoChunk(${JSON.stringify(requestId)}, ${offset})`,
       })
       chunks.push(Buffer.from(chunk.data, 'base64'))
       offset = chunk.offset
@@ -877,19 +877,19 @@ async function renderStoreScene(
       const data = bytes.subarray(start, start + 1024 * 1024).toString('base64')
       await bridge.send({
         type: 'evaluate',
-        code: `window.__sootsimRecorder.appendSceneVideoChunk(${JSON.stringify(requestId)}, ${JSON.stringify(data)})`,
+        code: `globalThis.__sootsimRecorder.appendSceneVideoChunk(${JSON.stringify(requestId)}, ${JSON.stringify(data)})`,
       })
     }
     await bridge.send({
       type: 'evaluate',
-      code: `window.__sootsimRecorder.finishSceneVideo(${JSON.stringify(requestId)}, ${JSON.stringify({ durationMs: result.durationMs, format: video.format })})`,
+      code: `globalThis.__sootsimRecorder.finishSceneVideo(${JSON.stringify(requestId)}, ${JSON.stringify({ durationMs: result.durationMs, format: video.format })})`,
     })
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
     await bridge
       .send({
         type: 'evaluate',
-        code: `window.__sootsimRecorder.finishSceneVideo(${JSON.stringify(requestId)}, ${JSON.stringify({ error: message })})`,
+        code: `globalThis.__sootsimRecorder.finishSceneVideo(${JSON.stringify(requestId)}, ${JSON.stringify({ error: message })})`,
       })
       .catch(() => {})
     throw error
@@ -1151,41 +1151,45 @@ async function recordStart(args: string[], opts: RecordOptions) {
         peachExit(1)
       }
     } else {
+      // a format the caller named; otherwise the recorder records its own default and says which
       const startOpts: {
-        format: string
+        format?: string
         fps: number
         layers?: string
         scene: boolean
         sceneWithVideo: boolean
         lockstep?: boolean
       } = {
-        format,
         fps,
         scene: session.sceneOnly === true,
         sceneWithVideo: !lockstep && !session.sceneOnly,
       }
+      if (formatArg) startOpts.format = format
       if (lockstep) startOpts.lockstep = true
       if (layers) startOpts.layers = layers
       writeRecordingState(session)
-      const result: { ok: boolean; error?: string; scene?: boolean } = await bridge.send({
-        type: 'evaluate',
-        code: `(() => {
-          if (!window.__sootsimRecorder) return { ok: false, error: 'recorder unavailable in this sim' };
-          if (document.hidden) return { ok: false, error: 'the peach tab is hidden; bring it to the foreground before recording' };
-          return window.__sootsimRecorder.start(${JSON.stringify(startOpts)});
+      const result: { ok: boolean; error?: string; scene?: boolean; format?: string } =
+        await bridge.send({
+          type: 'evaluate',
+          code: `(() => {
+          if (!globalThis.__sootsimRecorder) return { ok: false, error: 'recorder unavailable in this sim' };
+          if (globalThis.document?.hidden) return { ok: false, error: 'the peach tab is hidden; bring it to the foreground before recording' };
+          return globalThis.__sootsimRecorder.start(${JSON.stringify(startOpts)});
         })()`,
-      })
+        })
       if (!result.ok) {
         clearRecordingState()
         console.error(`  start failed: ${result.error ?? 'unknown error'}`)
         peachExit(1)
       }
       session.scene = session.sceneOnly || result.scene === true
+      if (result.format === 'mp4' || result.format === 'webm')
+        session.format = result.format
       writeRecordingState(session)
     }
     if (mode === 'video') {
       console.log(
-        `  recording ${format} @ ${fps}fps${layers ? ` (${layers})` : ''} — run \`peach record stop --output <path>\` when done`,
+        `  recording ${session.format} @ ${fps}fps${layers ? ` (${layers})` : ''} — run \`peach record stop --output <path>\` when done`,
       )
     } else {
       console.log(
@@ -1211,7 +1215,7 @@ async function recordPreludeStart(args: string[], opts: RecordOptions) {
     const ok: boolean = await bridge.send({
       type: 'evaluate',
       code: `(() => {
-        const start = window.SootSim?.bridges?.startRecordingPrelude
+        const start = globalThis.SootSim?.bridges?.startRecordingPrelude
         if (typeof start !== 'function') return false
         return Promise.resolve(start()).then((value) => value === true)
       })()`,
@@ -1221,7 +1225,7 @@ async function recordPreludeStart(args: string[], opts: RecordOptions) {
         .send({
           type: 'evaluate',
           code: `(() => {
-            const getError = window.SootSim?.bridges?.getRecordingStartError
+            const getError = globalThis.SootSim?.bridges?.getRecordingStartError
             return typeof getError === 'function' ? getError() : null
           })()`,
         })
@@ -1274,9 +1278,9 @@ async function probeEngineRecordingState(
     } | null = await bridge.send({
       type: 'evaluate',
       code: `(() => {
-        const store = window.SootSim?.bridges?.getRecordingState?.();
-        const headless = window.__sootsimRecorder?.state?.();
-        const eventRecorder = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder;
+        const store = globalThis.SootSim?.bridges?.getRecordingState?.();
+        const headless = globalThis.__sootsimRecorder?.state?.();
+        const eventRecorder = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder;
         const eventRecording =
           typeof eventRecorder?.isRecording === 'function'
             ? eventRecorder.isRecording() === true
@@ -1305,14 +1309,14 @@ async function cancelEngineRecording(bridge: WsBridge): Promise<{
     .send({
       type: 'evaluate',
       code: `(() => {
-        const store = window.SootSim?.bridges?.getRecordingState?.();
-        const eventRecorder = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder;
+        const store = globalThis.SootSim?.bridges?.getRecordingState?.();
+        const eventRecorder = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder;
         const hadStoreRecording = store && store.state !== 'idle';
         const hadEventRecording =
           typeof eventRecorder?.isRecording === 'function'
             ? eventRecorder.isRecording() === true
             : false;
-        const cancel = window.SootSim?.bridges?.cancelRecording;
+        const cancel = globalThis.SootSim?.bridges?.cancelRecording;
         if (typeof cancel === 'function') cancel();
         return Boolean(hadStoreRecording || hadEventRecording);
       })()`,
@@ -1322,7 +1326,7 @@ async function cancelEngineRecording(bridge: WsBridge): Promise<{
     .send({
       type: 'evaluate',
       code: `(async () => {
-        const r = window.__sootsimRecorder;
+        const r = globalThis.__sootsimRecorder;
         if (r && typeof r.forceRelease === 'function') return await r.forceRelease();
         return false;
       })()`,
@@ -1462,13 +1466,13 @@ async function recordCancel(args: string[], opts: RecordOptions) {
     if (state.mode === 'live' || state.mode === 'combined') {
       await bridge.send({
         type: 'evaluate',
-        code: `void window.SootSim?.bridges?.cancelRecording?.()`,
+        code: `void globalThis.SootSim?.bridges?.cancelRecording?.()`,
       })
     } else {
       await bridge.send({
         type: 'evaluate',
         code: `(async () => {
-          const recorder = window.__sootsimRecorder;
+          const recorder = globalThis.__sootsimRecorder;
           await recorder.stop();
           return recorder.forceRelease();
         })()`,
@@ -1574,7 +1578,7 @@ async function recordStop(args: string[], opts: RecordOptions) {
       frameCount?: number
     } = await bridge.send({
       type: 'evaluate',
-      code: `window.__sootsimRecorder.stop({ sceneOnly: ${sceneOnly} })`,
+      code: `globalThis.__sootsimRecorder.stop({ sceneOnly: ${sceneOnly} })`,
     })
     if (!stopResult.ok) {
       console.error(`  stop failed: ${stopResult.error ?? 'unknown error'}`)
@@ -1619,7 +1623,7 @@ async function recordStop(args: string[], opts: RecordOptions) {
 async function assertStoreBridgesAvailable(bridge: WsBridge) {
   const ok = await probeSim(bridge, {
     type: 'evaluate',
-    code: 'typeof window.SootSim?.bridges?.startRecording === "function" && typeof window.SootSim?.bridges?.stopRecording === "function"',
+    code: 'typeof globalThis.SootSim?.bridges?.startRecording === "function" && typeof globalThis.SootSim?.bridges?.stopRecording === "function"',
   })
   if (!ok) {
     console.error(
@@ -1646,7 +1650,7 @@ async function assertGuestBundleLoaded(bridge: WsBridge, mode: RecordMode) {
   const hasBundle = await probeSim(bridge, {
     type: 'evaluate',
     code: `(() => {
-      const fn = window.__sootsimCaptureBundle
+      const fn = globalThis.__sootsimCaptureBundle
       if (typeof fn !== 'function') return false
       const snap = fn()
       return !!(snap && snap.bundleUrl)
@@ -1701,15 +1705,15 @@ async function injectPreviewSessionAuth(
   const ok: boolean = await bridge.send({
     type: 'evaluate',
     code: `(() => {
-      const set = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.setSession
+      const set = globalThis.SootSim && globalThis.SootSim.bridges && globalThis.SootSim.bridges.setSession
       if (typeof set !== 'function') return false
       set({ token: ${JSON.stringify(token)}, user: null })
-      window.__sootsimPreviewUploadIdentity = ${JSON.stringify(uploadIdentity)}
-      window.__sootsimPreviewUseInjectedBearer = true
+      globalThis.__sootsimPreviewUploadIdentity = ${JSON.stringify(uploadIdentity)}
+      globalThis.__sootsimPreviewUseInjectedBearer = true
       ${
         uploadOrigin
-          ? `window.__sootsimUploadOrigin = ${JSON.stringify(uploadOrigin)}`
-          : 'delete window.__sootsimUploadOrigin'
+          ? `globalThis.__sootsimUploadOrigin = ${JSON.stringify(uploadOrigin)}`
+          : 'delete globalThis.__sootsimUploadOrigin'
       }
       return true
     })()`,
@@ -1739,7 +1743,7 @@ async function evalStoreStart(
   const layersArg = layers ? JSON.stringify(layers) : 'undefined'
   const ok: boolean = await bridge.send({
     type: 'evaluate',
-    code: `window.SootSim.bridges.startRecording(${JSON.stringify(mode)}, ${layersArg}, { skipEntitlement: true, capture: ${JSON.stringify(capture)}, externalSceneVideo: ${mode === 'combined'} })`,
+    code: `globalThis.SootSim.bridges.startRecording(${JSON.stringify(mode)}, ${layersArg}, { skipEntitlement: true, capture: ${JSON.stringify(capture)}, externalSceneVideo: ${mode === 'combined'} })`,
   })
   if (ok === true) return { ok: true, error: null }
   // the engine knows exactly why it refused — read the structured reason
@@ -1748,7 +1752,7 @@ async function evalStoreStart(
   const error: string | null = await bridge
     .send({
       type: 'evaluate',
-      code: `(window.SootSim?.bridges?.getRecordingStartError?.() ?? null)`,
+      code: `(globalThis.SootSim?.bridges?.getRecordingStartError?.() ?? null)`,
     })
     .catch(() => null)
   return { ok: false, error: error ?? null }
@@ -1762,7 +1766,7 @@ async function injectGitHubWorkflowIdentity(bridge: WsBridge): Promise<void> {
       : null
   await bridge.send({
     type: 'evaluate',
-    code: `window.__peachGithubJobIdentity = ${JSON.stringify(identity)}`,
+    code: `globalThis.__peachGithubJobIdentity = ${JSON.stringify(identity)}`,
   })
 }
 
@@ -1774,7 +1778,7 @@ async function evalStoreStop(bridge: WsBridge): Promise<boolean | 'pending'> {
   await injectGitHubWorkflowIdentity(bridge)
   const stopped: boolean | 'pending' | null = await bridge.send({
     type: 'evaluate',
-    code: `window.SootSim.bridges.stopRecording()`,
+    code: `globalThis.SootSim.bridges.stopRecording()`,
   })
   return stopped === 'pending' ? stopped : stopped !== false
 }
@@ -1805,7 +1809,7 @@ async function pollStoreUpload(bridge: WsBridge): Promise<StoreUploadResult> {
     } | null = await bridge.send({
       type: 'evaluate',
       // remaining time is computed in the page, so the two clocks never mix.
-      code: `(() => { const s = window.SootSim?.bridges?.getRecordingState?.(); return s ? { state: s.state, lastUpload: s.lastUpload, uploadError: s.uploadError, uploadRemainingMs: s.uploadDeadlineAtMs == null ? null : s.uploadDeadlineAtMs - Date.now() } : null })()`,
+      code: `(() => { const s = globalThis.SootSim?.bridges?.getRecordingState?.(); return s ? { state: s.state, lastUpload: s.lastUpload, uploadError: s.uploadError, uploadRemainingMs: s.uploadDeadlineAtMs == null ? null : s.uploadDeadlineAtMs - Date.now() } : null })()`,
     })
     if (snap && snap.state === 'processing' && snap.uploadRemainingMs != null) {
       deadline = Math.max(

package/cli/commands/shell-boolean-mode.ts

@@ -63,7 +63,7 @@ export async function runShellBooleanMode(
         }))
         const deadline = Date.now() + 1200
         while (Date.now() < deadline) {
-          if (Boolean(window.SootSim?.bridges?.settings?.get?.()?.[modeKey]) === target) {
+          if (Boolean(globalThis.SootSim?.bridges?.settings?.get?.()?.[modeKey]) === target) {
             return true
           }
           await new Promise((resolve) => setTimeout(resolve, 40))