peachsim 0.1.2206 → 0.1.2208

package/cli/bridge-diagnostics.ts

@@ -150,8 +150,8 @@ export async function printBridgeStateSummary(bridge: WsBridge) {
   const state = (await bridge.send({
     type: 'evaluate',
     code: `(async () => {
-      const test = window.__sootsimTest
-      const mainShell = window.SootSim?.bridges?.mainShell
+      const test = globalThis.__sootsimTest
+      const mainShell = globalThis.SootSim?.bridges?.mainShell
       let shell = null
       try {
         shell = typeof mainShell?.getState === 'function' ? await mainShell.getState() : null
@@ -162,9 +162,9 @@ export async function printBridgeStateSummary(bridge: WsBridge) {
       } catch {}
       return {
         url: window.location.href,
-        simId: window.__sootsimSimId || null,
+        simId: globalThis.__sootsimSimId || null,
         nodeCount,
-        mode: window.__sootsimRenderHost ? 'render-worker' : 'main-thread',
+        mode: globalThis.__sootsimRenderHost ? 'render-worker' : 'main-thread',
         shell: shell
           ? {
               state: shell.state || null,

package/cli/bridge-flow-runner.ts

@@ -523,7 +523,7 @@ type FocusedTextInputInfo = {
 }
 type ShellState = Record<string, unknown>
 
-// shape of window.__sootsimShellPerf.stop() — the shell worker frame profile
+// shape of globalThis.__sootsimShellPerf.stop() — the shell worker frame profile
 // (the worker that paints app pixels) merged with the render-profile counters.
 // see sootsim-engine shell-worker.ts stopShellFrameProfile.
 export interface SootSimFlowProfileResult {
@@ -1291,7 +1291,7 @@ export class SootSimBridgeFlowRunner {
       format?: string
       startedAtMs?: number
     }>(`(() => {
-      const rec = window.__sootsimRecorder
+      const rec = globalThis.__sootsimRecorder
       if (!rec) return { ok: false, error: 'recorder unavailable on this page' }
       const format = ${JSON.stringify(this.opts.recordingFormat ?? 'webm')}
       if (rec.state() === 'recording') return { ok: true, format }
@@ -1312,12 +1312,12 @@ export class SootSimBridgeFlowRunner {
       // stops the recorder and leaves no half-started state to skip past.
       try {
         await this.evaluate(`(() => {
-          const recorder = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+          const recorder = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder
           if (!recorder?.isRecording?.()) return
           return recorder.markVisibleStart(${JSON.stringify(startedAtMs)})
         })()`)
       } catch (error) {
-        await this.evaluate(`window.__sootsimRecorder.stop()`).catch(() => {})
+        await this.evaluate(`globalThis.__sootsimRecorder.stop()`).catch(() => {})
         throw error
       }
       this.recordingStartedAtMs = startedAtMs
@@ -1432,7 +1432,7 @@ export class SootSimBridgeFlowRunner {
       mime?: string
       durationMs: number
       profile?: ProfileFile | null
-    }>(`window.__sootsimRecorder.stop()`)
+    }>(`globalThis.__sootsimRecorder.stop()`)
     if (!stopped?.ok) {
       this.recordingStartedAtMs = null
       this.lastRecordingProfile = null
@@ -1457,7 +1457,7 @@ export class SootSimBridgeFlowRunner {
         done: boolean
         mime: string
       } | null>(
-        `window.__sootsimRecorder.getBlobBase64({ offset: ${offset}, chunk: ${
+        `globalThis.__sootsimRecorder.getBlobBase64({ offset: ${offset}, chunk: ${
           2 * 1024 * 1024
         } })`,
       )
@@ -1517,7 +1517,7 @@ export class SootSimBridgeFlowRunner {
 
   private async captureAccessibilityTree(): Promise<PeachAccessibilityNode[]> {
     const tree = await this.evaluate(`(async () => {
-      const test = window.__sootsimTest
+      const test = globalThis.__sootsimTest
       if (!test || typeof test.captureAccessibilityTree !== 'function') throw new Error('engine accessibility snapshot is unavailable')
       return await test.captureAccessibilityTree()
     })()`)
@@ -1593,7 +1593,7 @@ export class SootSimBridgeFlowRunner {
   private async findElementScoped(opts: FlowTargetSelector, preferHittable = false) {
     const screen = await this.screenBounds()
     const candidates = await this.evaluate<any[]>(`(async () => {
-      const test = window.__sootsimTest
+      const test = globalThis.__sootsimTest
       if (!test || !test.queryAll) return null
       const selector = ${JSON.stringify(opts)}
       const compile = ${accessibilityTextMatcher.toString()}
@@ -1774,7 +1774,7 @@ export class SootSimBridgeFlowRunner {
     if (candidates.length < 2) return candidates[0] ?? null
     const nodeIds = candidates.map((node) => node.nodeId)
     const index = await this.evaluate<number>(`(async () => {
-      const test = window.__sootsimTest
+      const test = globalThis.__sootsimTest
       for (const [index, nodeId] of ${JSON.stringify(nodeIds)}.entries()) {
         if (typeof nodeId !== 'number') continue
         const resolved = await test.resolveTapTarget(nodeId)
@@ -1791,7 +1791,7 @@ export class SootSimBridgeFlowRunner {
 
   private async resolveTapTarget(nodeId: number) {
     return this.evaluate<any>(`(async () => {
-      const test = window.__sootsimTest
+      const test = globalThis.__sootsimTest
       if (!test?.resolveTapTarget) return null
       return await test.resolveTapTarget(${nodeId})
     })()`)
@@ -1807,7 +1807,7 @@ export class SootSimBridgeFlowRunner {
       ? { id: opts.id, testID: opts.id, text: null }
       : { id: null, testID: null, text: opts.text ?? null }
     return this.evaluate<any>(`(async () => {
-      const test = window.__sootsimTest
+      const test = globalThis.__sootsimTest
       if (!test) return null
       let point = { x: ${x}, y: ${y} }
       const resolved = await test.resolveTapTarget(${nodeId})
@@ -1830,7 +1830,7 @@ export class SootSimBridgeFlowRunner {
 
   private async activatePressAt(x: number, y: number) {
     return this.evaluate<any>(`(async () => {
-      const test = window.__sootsimTest
+      const test = globalThis.__sootsimTest
       if (!test?.activatePressAt) return null
       const direct = await test.activatePressAt(${x}, ${y})
       if (direct?.ok) {
@@ -1878,7 +1878,7 @@ export class SootSimBridgeFlowRunner {
   // which no tree, layout, scroll or prop write could move any element.
   private async geometryRevision(): Promise<string | null> {
     const revision = await this.evaluate(
-      `(async () => window.__sootsimTest?.getGeometryRevision?.())()`,
+      `(async () => globalThis.__sootsimTest?.getGeometryRevision?.())()`,
     )
     return typeof revision === 'string' ? revision : null
   }
@@ -2345,7 +2345,7 @@ export class SootSimBridgeFlowRunner {
   private async isKeyboardVisible(): Promise<boolean> {
     const visible = await this.evaluate<boolean>(`(() => {
       const keyboard =
-        window.__sootsimKeyboard ?? window.SootSim?.bridges?.keyboard ?? null
+        globalThis.__sootsimKeyboard ?? globalThis.SootSim?.bridges?.keyboard ?? null
       return !!keyboard?.isVisible?.()
     })()`)
     return visible === true
@@ -2480,11 +2480,11 @@ export class SootSimBridgeFlowRunner {
       type: 'evaluate',
       simId: this.opts.simId,
       code: `(() => {
-        const c = window.__sootsimConsole
+        const c = globalThis.__sootsimConsole
         return {
           errors: c?.getErrors?.() ?? [],
           warnings: c?.getWarnings?.() ?? [],
-          requests: (window.__sootsimGetFailedRequests?.() ?? []),
+          requests: (globalThis.__sootsimGetFailedRequests?.() ?? []),
         }
       })()`,
     })) as SootSimFlowConsole
@@ -2542,7 +2542,7 @@ export class SootSimBridgeFlowRunner {
       manifest?: unknown
     }>(`(async () => {
       const out = {
-        simId: window.__sootsimBridge?.id ?? window.SootSim?.state?.simId ?? null,
+        simId: globalThis.__sootsimBridge?.id ?? globalThis.SootSim?.state?.simId ?? null,
         url: location.href,
         title: document.title,
         hidden: document.hidden,
@@ -2596,8 +2596,8 @@ export class SootSimBridgeFlowRunner {
     // full layout, style, a11y, transforms. the `--json` describe output
     // shape; inlined here so we don't depend on the cli reentering.
     const describeJson = await safeEval<any>(`(async () => {
-      const t = window.__sootsimTest
-      const mainShell = window.SootSim?.bridges?.mainShell
+      const t = globalThis.__sootsimTest
+      const mainShell = globalThis.SootSim?.bridges?.mainShell
       if (!t) return { error: 'no test bridge' }
       let shell = null
       try {
@@ -2610,19 +2610,19 @@ export class SootSimBridgeFlowRunner {
 
     // every animation the settle check can name, with its kind, priority and visibility
     const animations = await safeEval<unknown>(
-      `(async () => await window.__sootsimTest?.listAnimations?.())()`,
+      `(async () => await globalThis.__sootsimTest?.listAnimations?.())()`,
     )
     if (animations) write('animations.json', JSON.stringify(animations, null, 2))
 
     // 4. accessibility tree (flat text — what voiceover would read)
     const a11y = await safeEval<string>(
-      `(async () => await window.__sootsimTest?.dumpAccessibilityTree?.(20))()`,
+      `(async () => await globalThis.__sootsimTest?.dumpAccessibilityTree?.(20))()`,
     )
     if (typeof a11y === 'string') write('a11y.txt', a11y)
 
     // 5. tree dump (nested — useful for layout bugs)
     const tree = await safeEval<string>(
-      `(async () => await window.__sootsimTest?.dumpTree?.(15))()`,
+      `(async () => await globalThis.__sootsimTest?.dumpTree?.(15))()`,
     )
     if (typeof tree === 'string') write('tree.txt', tree)
 
@@ -2816,14 +2816,14 @@ export class SootSimBridgeFlowRunner {
       frameIndex?: number
     }>(
       `(async () => {
-        const lockstep = window.SootSim?.bridges?.lockstepCapture
+        const lockstep = globalThis.SootSim?.bridges?.lockstepCapture
         if (!lockstep || typeof lockstep.begin !== 'function') {
           return { ok: false, error: 'lockstep capture bridge unavailable' }
         }
-        let controller = window.__peachFlowAnimationClockController
+        let controller = globalThis.__peachFlowAnimationClockController
         if (!controller) {
           controller = await lockstep.begin(${JSON.stringify(fps)})
-          window.__peachFlowAnimationClockController = controller
+          globalThis.__peachFlowAnimationClockController = controller
         }
         let receipt = controller.initialFrame
         for (const ms of ${JSON.stringify(steps)}) {
@@ -2847,13 +2847,13 @@ export class SootSimBridgeFlowRunner {
     if (!this.animationClockLocked) return
     this.animationClockLocked = false
     await this.evaluate(`(() => {
-      const controller = window.__peachFlowAnimationClockController
-      window.__peachFlowAnimationClockController = null
+      const controller = globalThis.__peachFlowAnimationClockController
+      globalThis.__peachFlowAnimationClockController = null
       if (controller && typeof controller.end === 'function') {
         controller.end()
         return
       }
-      window.SootSim?.bridges?.lockstepCapture?.end?.()
+      globalThis.SootSim?.bridges?.lockstepCapture?.end?.()
     })()`).catch(() => {})
   }
 
@@ -3235,10 +3235,10 @@ export class SootSimBridgeFlowRunner {
 
   async startProfile() {
     const result = await this.evaluate<any>(`(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 }
     })()`)
     if (result?.error) {
@@ -3249,10 +3249,10 @@ export class SootSimBridgeFlowRunner {
 
   async stopProfile(): Promise<SootSimFlowProfileResult> {
     const result = await this.evaluate<any>(`(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()
     })()`)
 
     this.profilingEnabled = false
@@ -3454,7 +3454,7 @@ export class SootSimBridgeFlowRunner {
       const dataUrl = `data:${mimeType};base64,${bytes.toString('base64')}`
       const added = await this.evaluate<{ ok: boolean; error?: string }>(
         `(async () => {
-          const add = window.__sootsimAddPhotoDataUrl
+          const add = globalThis.__sootsimAddPhotoDataUrl
           if (typeof add !== 'function') {
             return { ok: false, error: 'photo library bridge unavailable' }
           }

package/cli/browser-evals.ts

@@ -19,7 +19,7 @@ export interface SampleRect {
 // returns null on miss so the caller can report a clear not-found error.
 export function buildResolveRectEval(matcher: { id?: string; text?: string }): string {
   return `(async () => {
-    const __t = window.__sootsimTest
+    const __t = globalThis.__sootsimTest
     if (!__t) throw new Error('__sootsimTest not available')
     const __id = ${JSON.stringify(matcher.id || '')}
     const __text = ${JSON.stringify(matcher.text || '')}
@@ -48,7 +48,7 @@ export function buildResolveRectEval(matcher: { id?: string; text?: string }): s
 export function buildSampleColorEval(rect: SampleRect): string {
   return `(async () => {
     const __rect = ${JSON.stringify(rect)}
-    const __screenshot = window.__sootsimScreenshot
+    const __screenshot = globalThis.__sootsimScreenshot
     if (typeof __screenshot !== 'function') {
       throw new Error('screenshot bridge not installed')
     }

package/cli/commands/control.ts

@@ -1307,7 +1307,7 @@ async function waitForTreeStable(
   opts: { stableMs: number; maxMs: number },
 ): Promise<void> {
   const deadline = Date.now() + opts.maxMs
-  const probeCode = `(async () => (await window.__sootsimTest?.getNodeCount?.()) || 0)()`
+  const probeCode = `(async () => (await globalThis.__sootsimTest?.getNodeCount?.()) || 0)()`
   const bridge = createBridge(wsPort, {
     commandTimeoutMs: 2000,
     simId,

package/cli/commands/cpu-profile.ts

@@ -701,13 +701,14 @@ Writes a page profile, worker profiles, and a manifest alongside the output.
     // with the native host attached, the engine's workers are realm threads in the host, reached
     // through the page; they record over the same window as the browser targets
     const hostRealms =
-      (await evaluatePage(`typeof window.__peachNative?.cpuProfile === 'function'`)) ===
-      true
+      (await evaluatePage(
+        `typeof globalThis.__peachNative?.cpuProfile === 'function'`,
+      )) === true
     const hostTargets: AttachedTarget[] = []
     if (hostRealms) {
       const startedAtMs = performance.now()
       const realms = await evaluatePage(
-        `window.__peachNative.cpuProfile('start', ${sampleInterval * 1000})`,
+        `globalThis.__peachNative.cpuProfile('start', ${sampleInterval * 1000})`,
       )
       for (const realm of Array.isArray(realms) ? realms : []) {
         hostTargets.push({
@@ -768,7 +769,7 @@ Writes a page profile, worker profiles, and a manifest alongside the output.
       }),
     )
     if (hostRealms) {
-      const stopped = await evaluatePage(`window.__peachNative.cpuProfile('stop', 0)`)
+      const stopped = await evaluatePage(`globalThis.__peachNative.cpuProfile('stop', 0)`)
       const stoppedAtMs = performance.now()
       for (const realm of Array.isArray(stopped) ? stopped : []) {
         const target = hostTargets.find(

package/cli/commands/debug.ts

@@ -311,7 +311,7 @@ function readNumberFlag(args: string[], flag: string): number | null {
 async function runImageAudit(bridge: WsBridge): Promise<ImageAuditReport> {
   await call(
     bridge,
-    "window.__sootsimCompositor.getStats(false, false, undefined, 'enable').then(() => 'enabled')",
+    "globalThis.__sootsimCompositor.getStats(false, false, undefined, 'enable').then(() => 'enabled')",
   )
   let stats: { imageAudit?: ImageAuditReport | null }
   try {
@@ -319,7 +319,7 @@ async function runImageAudit(bridge: WsBridge): Promise<ImageAuditReport> {
   } finally {
     stats = await call(
       bridge,
-      "window.__sootsimCompositor.getStats(false, false, undefined, 'disable').then((s) => ({ imageAudit: s.imageAudit }))",
+      "globalThis.__sootsimCompositor.getStats(false, false, undefined, 'disable').then((s) => ({ imageAudit: s.imageAudit }))",
     )
   }
   const report = stats?.imageAudit
@@ -347,7 +347,7 @@ async function runTargetedImageAudit(
     bridge,
     `(async () => {
     const input = ${JSON.stringify(targets)};
-    const compositor = window.__sootsimCompositor;
+    const compositor = globalThis.__sootsimCompositor;
     let capture;
     let receipt;
     let audit;

package/cli/commands/diagnose.ts

@@ -229,7 +229,7 @@ async function fetchNetwork(
   const result = (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() };
     })()`,
@@ -296,7 +296,7 @@ async function fetchConsoleErrors(
   const result = (await bridge.send({
     type: 'evaluate',
     code: `(() => {
-      const obs = window.__sootsimObservability;
+      const obs = globalThis.__sootsimObservability;
       if (!obs) return { ok: false };
       return { ok: true, entries: obs.logs.getSnapshot() };
     })()`,

package/cli/commands/flow.ts

@@ -811,7 +811,7 @@ flow extension:
           type: 'evaluate',
           simId: driver.simId,
           code: `(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+          const r = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder
           return r?.start?.() ?? false
         })()`,
         })
@@ -909,13 +909,13 @@ flow extension:
       if (preview) {
         // start the preview event recorder on the tab so agent-driven taps
         // (via sootsim:agentAction) land in the capture stream for replay.
-        // some shells expose the recorder via window.SootSim, others via
+        // some shells expose the recorder via globalThis.SootSim, others via
         // the legacy alias only — try both.
         const started = await bridge.send({
           type: 'evaluate',
           simId: driver.simId,
           code: `(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+          const r = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder
           const startedAtMs = Date.now()
           return r?.start?.(startedAtMs) ? startedAtMs : null
         })()`,
@@ -945,7 +945,7 @@ flow extension:
           type: 'evaluate',
           simId: driver.simId,
           code: `(() => {
-          const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+          const r = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder
           return r?.stop?.() ?? []
         })()`,
         })) as Array<Record<string, any>>
@@ -1000,7 +1000,7 @@ flow extension:
             type: 'evaluate',
             simId: driver.simId,
             code: `(() => {
-            const r = window.SootSim?.bridges?.eventRecorder ?? window.__sootsimEventRecorder
+            const r = globalThis.SootSim?.bridges?.eventRecorder ?? globalThis.__sootsimEventRecorder
             return r?.stop?.() ?? []
           })()`,
           })) as Array<Record<string, any>>
@@ -1294,7 +1294,7 @@ async function startPreviewSceneRecording(
     await bridge.send({
       type: 'evaluate',
       simId,
-      code: `window.SootSim.bridges.sceneStream.run({ action: 'recordStart' })`,
+      code: `globalThis.SootSim.bridges.sceneStream.run({ action: 'recordStart' })`,
     })
     return true
   } catch (err) {
@@ -1315,7 +1315,7 @@ async function stopPreviewSceneRecording(
       type: 'evaluate',
       simId,
       code: `(async () => {
-        const { bytes } = await window.SootSim.bridges.sceneStream.run({ action: 'recordStop' })
+        const { bytes } = await globalThis.SootSim.bridges.sceneStream.run({ action: 'recordStop' })
         let text = ''
         for (let i = 0; i < bytes.length; i += 0x8000)
           text += String.fromCharCode(...bytes.subarray(i, i + 0x8000))

package/cli/commands/inspect/core.ts

@@ -90,7 +90,7 @@ export function isInspectPickCommand(subcommand: string | null | undefined): boo
 export async function isInspectModeActive(bridge: InspectBridge): Promise<boolean> {
   const active = await bridge.send({
     type: 'evaluate',
-    code: 'window.__sootsimEngineState?.inspectActive === true',
+    code: 'globalThis.__sootsimEngineState?.inspectActive === true',
   })
   return active === true
 }
@@ -587,7 +587,7 @@ export function layoutGetNativeEval(opts: LayoutExtractionOptions = {}): string
   const includeStyle = opts.styling === true
   const filter = opts.filter?.trim().toLowerCase() ?? ''
   return `(async () => {
-      const t = window.__sootsimTest
+      const t = globalThis.__sootsimTest
       if (!t || typeof t.listInspectable !== 'function') return []
       const list = await t.listInspectable({})
       if (!Array.isArray(list)) return []
@@ -751,7 +751,7 @@ export function layoutGetNativeEval(opts: LayoutExtractionOptions = {}): string
       const textElements = elements.filter((element) => element.text && element.fontSize > 0)
       if (!includeStyle || textElements.length === 0) return elements
 
-      const screenshot = window.SootSim && window.SootSim.bridges && window.SootSim.bridges.screenshot
+      const screenshot = globalThis.SootSim && globalThis.SootSim.bridges && globalThis.SootSim.bridges.screenshot
       if (typeof screenshot !== 'function') {
         throw new Error('styled native layout requires the peach capture bridge')
       }
@@ -1714,10 +1714,10 @@ export function consoleEntriesEval(level: 'error' | 'warn', limit: number): stri
       out.push({ timestamp: ts, args: Array.isArray(e.args) ? e.args : [e.args], stack: e.stack || undefined, source: e.source || undefined })
     }
     // page-realm ws-bridge buffer first (richest stacks for page-origin errors)
-    try { for (const e of (window.__sootsimConsole?.${getter}(${limit}) || [])) push(e) } catch {}
+    try { for (const e of (globalThis.__sootsimConsole?.${getter}(${limit}) || [])) push(e) } catch {}
     // engine observability store — the always-on render-worker / forwarded path
     try {
-      const obs = window.__sootsimObservability
+      const obs = globalThis.__sootsimObservability
       const snap = obs && obs.logs && typeof obs.logs.getSnapshot === 'function' ? obs.logs.getSnapshot() : []
       for (const e of snap) if (e && e.level === ${JSON.stringify(level)}) push(e)
     } catch {}
@@ -1772,12 +1772,12 @@ export const MERGED_CONSOLE_COUNT_EVAL = `(() => {
       else warnings++
     }
     try {
-      const c = window.__sootsimConsole
+      const c = globalThis.__sootsimConsole
       for (const e of (c?.getErrors?.(200) || [])) add('error', e?.timestamp ?? e?.ts, e?.args)
       for (const e of (c?.getWarnings?.(200) || [])) add('warn', e?.timestamp ?? e?.ts, e?.args)
     } catch {}
     try {
-      const obs = window.__sootsimObservability
+      const obs = globalThis.__sootsimObservability
       const snap = obs && obs.logs && typeof obs.logs.getSnapshot === 'function' ? obs.logs.getSnapshot() : []
       for (const e of snap) if (e) add(e.level, e.ts, e.args)
     } catch {}
@@ -1789,7 +1789,7 @@ export const MERGED_CONSOLE_COUNT_EVAL = `(() => {
 export async function clearConsole(bridge: InspectBridge): Promise<void> {
   await bridge.send({
     type: 'evaluate',
-    code: 'window.__sootsimConsole?.clear(); window.__sootsimObservability?.logs?.clear?.(); "cleared"',
+    code: 'globalThis.__sootsimConsole?.clear(); globalThis.__sootsimObservability?.logs?.clear?.(); "cleared"',
   })
 }
 
@@ -1924,7 +1924,7 @@ export async function inspectLogs(bridge: InspectBridge): Promise<LogEntry[]> {
   const res = (await bridge.send({
     type: 'evaluate',
     code: `(() => {
-      const obs = window.__sootsimObservability;
+      const obs = globalThis.__sootsimObservability;
       if (!obs) return { ok: false };
       return { ok: true, entries: obs.logs.getSnapshot() };
     })()`,
@@ -1937,7 +1937,7 @@ export async function inspectLogs(bridge: InspectBridge): Promise<LogEntry[]> {
 export async function clearLogs(bridge: InspectBridge): Promise<void> {
   await bridge.send({
     type: 'evaluate',
-    code: 'window.__sootsimObservability?.logs.clear(); "cleared"',
+    code: 'globalThis.__sootsimObservability?.logs.clear(); "cleared"',
   })
 }
 
@@ -2085,7 +2085,7 @@ export async function inspectKeyboard(
   const result = (await bridge.send({
     type: 'evaluate',
     code: `(() => {
-      const kb = window.__sootsimKeyboard
+      const kb = globalThis.__sootsimKeyboard
       if (!kb || typeof kb.getLayout !== 'function') {
         return { error: 'keyboard bridge getLayout() not available' }
       }
@@ -2165,8 +2165,8 @@ export async function inspectScreens(bridge: InspectBridge): Promise<ScreensRepo
   const payload = (await bridge.send({
     type: 'evaluate',
     code: `(async () => {
-      const test = window.__sootsimTest
-      const kb = window.__sootsimKeyboard
+      const test = globalThis.__sootsimTest
+      const kb = globalThis.__sootsimKeyboard
       const navSnap =
         test && typeof test.getNavigationSnapshot === 'function'
           ? await test.getNavigationSnapshot()
@@ -2226,7 +2226,7 @@ export async function inspectDebugStatus(
   if (bridge.plane === 'cloud' && !host) {
     return (await inspectCloudDiagnostics(bridge)).channels
   }
-  return bridge.send({ type: 'evaluate', code: 'window.__sootsimDebug.status()' })
+  return bridge.send({ type: 'evaluate', code: 'globalThis.__sootsimDebug.status()' })
 }
 
 // `debug flags` — the engine's debug feature flags.
@@ -2240,7 +2240,7 @@ export async function inspectDebugFlags(
       availableChannels.map((channel) => [channel, channels.includes(channel)]),
     )
   }
-  return bridge.send({ type: 'evaluate', code: 'window.__sootsimDebug.flags()' })
+  return bridge.send({ type: 'evaluate', code: 'globalThis.__sootsimDebug.flags()' })
 }
 
 export async function inspectDebugChannels(
@@ -2250,7 +2250,7 @@ export async function inspectDebugChannels(
   if (bridge.plane === 'cloud' && !host) {
     return (await inspectCloudDiagnostics(bridge)).availableChannels
   }
-  return bridge.send({ type: 'evaluate', code: 'window.__sootsimDebug.channels()' })
+  return bridge.send({ type: 'evaluate', code: 'globalThis.__sootsimDebug.channels()' })
 }
 
 // `debug find sheets|portals` — locate all live sheet / portal nodes.
@@ -2267,7 +2267,7 @@ export async function inspectDebugFind(
   }
   return bridge.send({
     type: 'evaluate',
-    code: `window.__sootsimTest.debugFind(${JSON.stringify(target)})`,
+    code: `globalThis.__sootsimTest.debugFind(${JSON.stringify(target)})`,
   })
 }
 
@@ -2286,7 +2286,7 @@ export async function callDebugBridge(
   return bridge.send({
     type: 'evaluate',
     code: `(async () => {
-      const result = await window.__sootsimTest.evalInTenant(${JSON.stringify(code)})
+      const result = await globalThis.__sootsimTest.evalInTenant(${JSON.stringify(code)})
       if (!result.ok) throw new Error(result.error)
       return result.value
     })()`,
@@ -2450,17 +2450,17 @@ export async function inspectMemory(bridge: InspectBridge): Promise<MemoryReport
   const result = (await bridge.send({
     type: 'evaluate',
     code: `(async () => {
-      const host = window.__sootsimRenderHost
+      const host = globalThis.__sootsimRenderHost
       const stats = host?.queryStats ? await host.queryStats() : null
-      const shellRaw = window.__sootsimShellMemory
-        ? await window.__sootsimShellMemory()
+      const shellRaw = globalThis.__sootsimShellMemory
+        ? await globalThis.__sootsimShellMemory()
         : null
       const shell = shellRaw && !shellRaw.error ? shellRaw : null
       // the compositor paints home + app:one + app:two, so every app-surface
       // picture and raster image is counted here and nowhere else.
       let compositor = null
       try {
-        const cs = await window.__sootsimCompositor?.getStats?.(false, true)
+        const cs = await globalThis.__sootsimCompositor?.getStats?.(false, true)
         compositor = cs?.memory ?? null
       } catch {}
       const normalize = (m) =>

package/cli/commands/inspect/get-node.ts

@@ -7,7 +7,7 @@
 
 export function buildGetNodeEval(matcher: string): string {
   return `(async () => {
-            const t = window.__sootsimTest
+            const t = globalThis.__sootsimTest
             const q = ${JSON.stringify(matcher)}
             let node = null
             let via = null
@@ -30,7 +30,7 @@ export function buildGetNodeEval(matcher: string): string {
             // parent chain — walk up from the node so the JSON dump is
             // self-describing.
             const parentChain = []
-            const root = window.__sootsimRoot
+            const root = globalThis.__sootsimRoot
             if (root && typeof node.nodeId === 'number') {
               const findPath = (n, targetId, path) => {
                 if (!n) return null

package/cli/commands/inspect/shared.ts

@@ -178,7 +178,7 @@ export async function waitForSimReady(
       const count = await Promise.race([
         bridge.send({
           type: 'evaluate',
-          code: '(async () => (await window.__sootsimTest?.getNodeCount()) ?? null)()',
+          code: '(async () => (await globalThis.__sootsimTest?.getNodeCount()) ?? null)()',
         }),
         new Promise<never>((_, reject) => {
           timer = setTimeout(
@@ -210,7 +210,7 @@ export async function waitForSimReady(
   const observed = lastError
     ? `last bridge error: ${lastError}`
     : lastCount === null
-      ? 'guest never installed window.__sootsimTest'
+      ? 'guest never installed globalThis.__sootsimTest'
       : `last node count: ${String(lastCount)} (needs > ${minNodeCount})`
   return {
     bridge: null,

package/cli/commands/inspect/wait-event.ts

@@ -162,7 +162,7 @@ export async function runWaitEventSubcommand(opts: WaitEventOptions): Promise<vo
       // but evaluate is the universally available shape and the cost
       // of a string-baked function is negligible at 5Hz.
       code: `(async () => {
-        const t = window.SootSim?.bridges?.timeline
+        const t = globalThis.SootSim?.bridges?.timeline
         if (!t) return { ok: false, error: 'timeline bridge missing' }
         return { ok: true, result: await t.recent(${JSON.stringify(query)}) }
       })()`,