sootsim 0.1.296 → 0.1.298

package/detox/index.ts

@@ -15,6 +15,12 @@ import {
   waitForSootsimGestureHandler,
 } from './gestures'
 import { by, type Matcher } from './matchers'
+import {
+  MOTION_CHANGE_DEFINITION,
+  measureMotionChange,
+  type MotionChangeDefinition,
+  type MotionChangeMeasurement,
+} from './motion-change.cjs'
 import type { SootSimElement } from './element-types'
 import type { Browser, BrowserContext, Page } from 'playwright'
 import type { SootsimEventMap, SootsimEventName } from 'sootsim-engine/sootsim-event'
@@ -554,6 +560,32 @@ function decodePngDataUrl(dataUrl: string): Buffer {
   return Buffer.from(match[1], 'base64')
 }
 
+type FastScreenshotData = {
+  label: string
+  offsetMs: number
+  actualMs: number
+  dataUrl: string
+  frameIndex?: number
+  virtualTimestampMs?: number
+}
+
+function writeFastScreenshotFrames<T extends FastScreenshotData>(
+  namePrefix: string,
+  frames: T[],
+): Array<Omit<T, 'dataUrl'> & { path: string }> {
+  ensureScreenshotDir()
+  return frames.map((frame) => {
+    const safeName = `${namePrefix}-${frame.label}`.replace(/[^a-zA-Z0-9._-]+/g, '-')
+    const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`)
+    fs.writeFileSync(filePath, decodePngDataUrl(frame.dataUrl))
+    const { dataUrl: _dataUrl, ...metadata } = frame
+    return {
+      ...metadata,
+      path: filePath,
+    }
+  })
+}
+
 // single-shot canvas capture — no frame-stability poll. used for multi-stage
 // animation captures where we explicitly want to sample mid-transition. the
 // usual captureSootsimPng polls until two consecutive frames are byte-equal
@@ -1347,10 +1379,352 @@ export const device = {
     await dispatchSootsimEventInPage('sootsim:menuAnimOverride', { value: progress })
   },
 
-  async setBottomTabAnimOverride(
-    value: { elapsedMs: number; fromIndex: number; toIndex: number } | null,
-  ): Promise<void> {
-    await dispatchSootsimEventInPage('sootsim:bottomTabAnimOverride', { value })
+  // park every render clock before the interaction, detect the first changed
+  // stepped frame inside the named component, then advance exact 60fps frames
+  // to each requested offset. native extraction also chooses the first frame
+  // at or after an offset, so both sides use the same rounding convention.
+  async takeScreenshotStagesFromVisibleChangeFast(
+    namePrefix: string,
+    stages: Array<{ label: string; offsetMs: number }>,
+    options: {
+      detectionTimeoutMs?: number
+      frame?: { height: number; width: number; x: number; y: number } | null
+      rootFrame?: { height: number; width: number; x: number; y: number } | null
+      trigger: () => unknown
+    },
+  ): Promise<{
+    frames: Array<{
+      label: string
+      offsetMs: number
+      actualMs: number
+      path: string
+      frameIndex: number
+      virtualTimestampMs: number
+    }>
+    triggerCompletedMs: number
+    triggerStartMs: number
+    visibleChangeDetection: {
+      actualMs: number
+      changedPixelPercent: number
+      changedPixels: number
+      channelThreshold: number
+      frame: { height: number; width: number; x: number; y: number } | null
+      minimumChangePercent: number
+      rootFrame: { height: number; width: number; x: number; y: number } | null
+      totalPixels: number
+      frameIndex: number
+      virtualTimestampMs: number
+    }
+  }> {
+    const page = getPage()
+    const token = `motion-${process.pid}-${Date.now()}-${Math.random()}`
+    await page.evaluate(measureMotionChange, {
+      definition: MOTION_CHANGE_DEFINITION,
+      installGlobal: true,
+    })
+    const capturePromise: Promise<{
+      frames: Array<
+        FastScreenshotData & {
+          frameIndex: number
+          virtualTimestampMs: number
+        }
+      >
+      visibleChangeDetection: {
+        actualMs: number
+        changedPixelPercent: number
+        changedPixels: number
+        channelThreshold: number
+        frameIndex: number
+        minimumChangePercent: number
+        totalPixels: number
+        virtualTimestampMs: number
+      }
+    }> = page.evaluate(
+      async (input) => {
+        type FrameReceipt = { frameIndex: number; virtualTimestampMs: number }
+        type CaptureState = {
+          cancelled: boolean
+          ready: boolean
+          triggerCompleted: boolean
+        }
+        type CaptureWindow = Window & {
+          __sootsimMeasureMotionChange?: (input: {
+            baseline: Uint8ClampedArray
+            candidate: Uint8ClampedArray
+            definition: MotionChangeDefinition
+            height: number
+            label: string
+            width: number
+          }) => MotionChangeMeasurement
+          __sootsimVisibleChangeCaptures?: Record<string, CaptureState>
+          SootSim?: {
+            bridges?: {
+              liveComposite?: {
+                captureFresh: () => Promise<{
+                  canvas: HTMLCanvasElement | null
+                  frameToken: number
+                }>
+              }
+              lockstepCapture?: {
+                begin: (fps: number) => Promise<{
+                  stepFrame: () => Promise<FrameReceipt>
+                  stepToOffset: (
+                    anchor: FrameReceipt,
+                    offsetMs: number,
+                  ) => Promise<FrameReceipt>
+                  end: () => void
+                }>
+              }
+            }
+          }
+        }
+        type Snapshot = {
+          actualMs: number
+          bitmap: ImageBitmap
+          label: string
+          offsetMs: number
+          frameIndex: number
+          virtualTimestampMs: number
+        }
+
+        const captureWindow = window as unknown as CaptureWindow
+        const live = captureWindow.SootSim?.bridges?.liveComposite
+        const lockstep = captureWindow.SootSim?.bridges?.lockstepCapture
+        if (!live || typeof live.captureFresh !== 'function') {
+          throw new Error('SootSim live composite bridge is not installed')
+        }
+        if (!lockstep || typeof lockstep.begin !== 'function') {
+          throw new Error('SootSim lockstep capture bridge is not installed')
+        }
+        const registry =
+          captureWindow.__sootsimVisibleChangeCaptures ??
+          (captureWindow.__sootsimVisibleChangeCaptures = {})
+        const state: CaptureState = {
+          cancelled: false,
+          ready: false,
+          triggerCompleted: false,
+        }
+        registry[input.token] = state
+        const measureChange = captureWindow.__sootsimMeasureMotionChange
+        if (!measureChange) {
+          throw new Error('SootSim motion change definition is not installed')
+        }
+
+        const captureBitmap = async () => {
+          const { canvas } = await live.captureFresh()
+          if (!canvas) throw new Error('SootSim live composite produced no canvas')
+          return createImageBitmap(canvas)
+        }
+        const boundsFor = (bitmap: ImageBitmap) => {
+          const scale =
+            input.rootFrame && input.rootFrame.width > 0
+              ? bitmap.width / input.rootFrame.width
+              : 1
+          return {
+            height: input.frame
+              ? Math.max(
+                  1,
+                  Math.min(
+                    bitmap.height,
+                    Math.ceil((input.frame.y + input.frame.height) * scale),
+                  ) - Math.max(0, Math.floor(input.frame.y * scale)),
+                )
+              : bitmap.height,
+            left: input.frame ? Math.max(0, Math.floor(input.frame.x * scale)) : 0,
+            top: input.frame ? Math.max(0, Math.floor(input.frame.y * scale)) : 0,
+            width: input.frame
+              ? Math.max(
+                  1,
+                  Math.min(
+                    bitmap.width,
+                    Math.ceil((input.frame.x + input.frame.width) * scale),
+                  ) - Math.max(0, Math.floor(input.frame.x * scale)),
+                )
+              : bitmap.width,
+          }
+        }
+        const regionPixels = (bitmap: ImageBitmap) => {
+          const bounds = boundsFor(bitmap)
+          const canvas = document.createElement('canvas')
+          canvas.width = bounds.width
+          canvas.height = bounds.height
+          const context = canvas.getContext('2d', { willReadFrequently: true })
+          if (!context) throw new Error('SootSim motion detector needs a 2d canvas')
+          context.drawImage(
+            bitmap,
+            bounds.left,
+            bounds.top,
+            bounds.width,
+            bounds.height,
+            0,
+            0,
+            bounds.width,
+            bounds.height,
+          )
+          return context.getImageData(0, 0, bounds.width, bounds.height).data
+        }
+        const encode = (snapshot: Snapshot) => {
+          const canvas = document.createElement('canvas')
+          canvas.width = snapshot.bitmap.width
+          canvas.height = snapshot.bitmap.height
+          const context = canvas.getContext('2d')
+          if (!context) throw new Error('SootSim motion capture needs a 2d canvas')
+          context.drawImage(snapshot.bitmap, 0, 0)
+          snapshot.bitmap.close()
+          return {
+            actualMs: snapshot.actualMs,
+            dataUrl: canvas.toDataURL('image/png'),
+            label: snapshot.label,
+            offsetMs: snapshot.offsetMs,
+            frameIndex: snapshot.frameIndex,
+            virtualTimestampMs: snapshot.virtualTimestampMs,
+          }
+        }
+
+        const controller = await lockstep.begin(60)
+        try {
+          const baselineBitmap = await captureBitmap()
+          const baseline = regionPixels(baselineBitmap)
+          baselineBitmap.close()
+          state.ready = true
+          while (!state.triggerCompleted) {
+            if (state.cancelled) throw new Error('SootSim motion capture was cancelled')
+            await new Promise((resolve) => setTimeout(resolve, 0))
+          }
+
+          let visibleStart: FrameReceipt | null = null
+          let detectedMeasurement: MotionChangeMeasurement | null = null
+          const detectionFrameLimit = Math.ceil((input.detectionTimeoutMs * 60) / 1000)
+          for (let frame = 0; frame < detectionFrameLimit; frame++) {
+            if (state.cancelled) throw new Error('SootSim motion capture was cancelled')
+            const receipt = await controller.stepFrame()
+            const candidateBitmap = await captureBitmap()
+            const bounds = boundsFor(candidateBitmap)
+            const measurement = measureChange({
+              baseline,
+              candidate: regionPixels(candidateBitmap),
+              definition: input.motionChangeDefinition,
+              height: bounds.height,
+              label: 'SootSim visible-change detector',
+              width: bounds.width,
+            })
+            candidateBitmap.close()
+            if (measurement.passedMinimum) {
+              visibleStart = receipt
+              detectedMeasurement = measurement
+              break
+            }
+          }
+          if (!visibleStart || !detectedMeasurement) {
+            throw new Error(
+              `SootSim motion had no visible change before ${input.detectionTimeoutMs}ms`,
+            )
+          }
+
+          const snapshots: Snapshot[] = []
+          for (const stage of input.stages) {
+            if (state.cancelled) throw new Error('SootSim motion capture was cancelled')
+            const receipt = await controller.stepToOffset(visibleStart, stage.offsetMs)
+            snapshots.push({
+              actualMs: receipt.virtualTimestampMs - visibleStart.virtualTimestampMs,
+              bitmap: await captureBitmap(),
+              frameIndex: receipt.frameIndex,
+              label: stage.label,
+              offsetMs: stage.offsetMs,
+              virtualTimestampMs: receipt.virtualTimestampMs,
+            })
+          }
+          return {
+            frames: snapshots.map(encode),
+            visibleChangeDetection: {
+              actualMs: (visibleStart.frameIndex * 1000) / 60,
+              changedPixelPercent: detectedMeasurement.changePercent,
+              changedPixels: detectedMeasurement.changePixels,
+              channelThreshold: input.motionChangeDefinition.channelThreshold,
+              minimumChangePercent: input.motionChangeDefinition.minimumChangePercent,
+              totalPixels: detectedMeasurement.totalPixels,
+              frameIndex: visibleStart.frameIndex,
+              virtualTimestampMs: visibleStart.virtualTimestampMs,
+            },
+          }
+        } finally {
+          controller.end()
+          delete registry[input.token]
+        }
+      },
+      {
+        detectionTimeoutMs: options.detectionTimeoutMs ?? 3000,
+        frame: options.frame ?? null,
+        motionChangeDefinition: MOTION_CHANGE_DEFINITION,
+        rootFrame: options.rootFrame ?? null,
+        stages,
+        token,
+      },
+    )
+
+    await page.waitForFunction(
+      (captureToken) => {
+        const registry = (
+          window as Window & {
+            __sootsimVisibleChangeCaptures?: Record<
+              string,
+              { cancelled: boolean; ready: boolean; triggerCompleted: boolean }
+            >
+          }
+        ).__sootsimVisibleChangeCaptures
+        return registry?.[captureToken]?.ready === true
+      },
+      token,
+      { timeout: 5000 },
+    )
+
+    const triggerStartMs = Date.now()
+    let triggerCompletedMs = 0
+    try {
+      await Promise.resolve(options.trigger())
+      triggerCompletedMs = Date.now()
+      await page.evaluate((captureToken) => {
+        const registry = (
+          window as Window & {
+            __sootsimVisibleChangeCaptures?: Record<
+              string,
+              { cancelled: boolean; ready: boolean; triggerCompleted: boolean }
+            >
+          }
+        ).__sootsimVisibleChangeCaptures
+        const capture = registry?.[captureToken]
+        if (!capture) throw new Error('SootSim motion capture disarmed before trigger')
+        capture.triggerCompleted = true
+      }, token)
+      const capture = await capturePromise
+      return {
+        frames: writeFastScreenshotFrames(namePrefix, capture.frames),
+        triggerCompletedMs,
+        triggerStartMs,
+        visibleChangeDetection: {
+          ...capture.visibleChangeDetection,
+          frame: options.frame ?? null,
+          rootFrame: options.rootFrame ?? null,
+        },
+      }
+    } catch (error) {
+      await page
+        .evaluate((captureToken) => {
+          const registry = (
+            window as Window & {
+              __sootsimVisibleChangeCaptures?: Record<
+                string,
+                { cancelled: boolean; ready: boolean; triggerCompleted: boolean }
+              >
+            }
+          ).__sootsimVisibleChangeCaptures
+          const capture = registry?.[captureToken]
+          if (capture) capture.cancelled = true
+        }, token)
+        .catch(() => {})
+      await capturePromise.catch(() => {})
+      throw error
+    }
   },
 
   // FAST multi-stage capture for sub-second animation diffs. each stage
@@ -1490,18 +1864,7 @@ export const device = {
       },
       { stages, skipWarmup: options?.skipWarmup === true },
     )
-    ensureScreenshotDir()
-    return frames.map((f) => {
-      const safeName = `${namePrefix}-${f.label}`.replace(/[^a-zA-Z0-9._-]+/g, '-')
-      const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`)
-      fs.writeFileSync(filePath, decodePngDataUrl(f.dataUrl))
-      return {
-        label: f.label,
-        offsetMs: f.offsetMs,
-        actualMs: f.actualMs,
-        path: filePath,
-      }
-    })
+    return writeFastScreenshotFrames(namePrefix, frames)
   },
 
   // batched multi-stage capture for animation diffs. all N captures happen
@@ -1549,18 +1912,7 @@ export const device = {
       },
       { stages },
     )
-    ensureScreenshotDir()
-    return frames.map((f) => {
-      const safeName = `${namePrefix}-${f.label}`.replace(/[^a-zA-Z0-9._-]+/g, '-')
-      const filePath = path.join(SCREENSHOT_DIR, `${safeName}.png`)
-      fs.writeFileSync(filePath, decodePngDataUrl(f.dataUrl))
-      return {
-        label: f.label,
-        offsetMs: f.offsetMs,
-        actualMs: f.actualMs,
-        path: filePath,
-      }
-    })
+    return writeFastScreenshotFrames(namePrefix, frames)
   },
 
   async shake() {

package/detox/motion-change.cjs

@@ -0,0 +1,109 @@
+// native recordings and SootSim live frames must use this exact definition.
+// retained static Android crops measured as high as 0.0331% after the channel
+// filter. the smallest corrected component transition with visible motion was
+// 0.1748%, so a 0.1% floor separates every measured static and moving frame.
+const MOTION_CHANGE_DEFINITION = Object.freeze({
+  channelThreshold: 24,
+  minimumChangePercent: 0.1,
+})
+
+function measureMotionChange(input) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) {
+    throw new Error('motion change measurement requires an input object')
+  }
+  if (input.installGlobal === true) {
+    globalThis.__sootsimMeasureMotionChange = measureMotionChange
+    return null
+  }
+
+  const definition = input.definition
+  if (
+    !definition ||
+    typeof definition !== 'object' ||
+    !Number.isInteger(definition.channelThreshold) ||
+    definition.channelThreshold < 0 ||
+    definition.channelThreshold > 255 ||
+    !Number.isFinite(definition.minimumChangePercent) ||
+    definition.minimumChangePercent <= 0 ||
+    definition.minimumChangePercent >= 100
+  ) {
+    throw new Error(
+      'motion change definition needs a channel threshold from 0 to 255 and a minimum greater than 0% and less than 100%',
+    )
+  }
+
+  const label =
+    typeof input.label === 'string' && input.label.length > 0
+      ? input.label
+      : 'motion change'
+  let changePixels = input.changePixels
+  let totalPixels = input.totalPixels
+  if (input.baseline !== undefined || input.candidate !== undefined) {
+    const baseline = input.baseline
+    const candidate = input.candidate
+    const width = input.width
+    const height = input.height
+    if (
+      !baseline ||
+      !candidate ||
+      typeof baseline.length !== 'number' ||
+      typeof candidate.length !== 'number' ||
+      !Number.isInteger(width) ||
+      !Number.isInteger(height) ||
+      width <= 0 ||
+      height <= 0
+    ) {
+      throw new Error(`${label} needs two RGBA pixel arrays and positive dimensions`)
+    }
+    totalPixels = width * height
+    const expectedBytes = totalPixels * 4
+    if (baseline.length !== expectedBytes || candidate.length !== expectedBytes) {
+      throw new Error(
+        `${label} pixel data has ${baseline.length}/${candidate.length} bytes; expected ${expectedBytes}`,
+      )
+    }
+    changePixels = 0
+    for (let offset = 0; offset < expectedBytes; offset += 4) {
+      if (
+        Math.abs(baseline[offset] - candidate[offset]) > definition.channelThreshold ||
+        Math.abs(baseline[offset + 1] - candidate[offset + 1]) >
+          definition.channelThreshold ||
+        Math.abs(baseline[offset + 2] - candidate[offset + 2]) >
+          definition.channelThreshold ||
+        Math.abs(baseline[offset + 3] - candidate[offset + 3]) >
+          definition.channelThreshold
+      ) {
+        changePixels++
+      }
+    }
+  }
+
+  if (!Number.isInteger(totalPixels) || totalPixels <= 0) {
+    throw new Error(`${label} has no positive measured region area`)
+  }
+  if (!Number.isInteger(changePixels) || changePixels < 0 || changePixels > totalPixels) {
+    throw new Error(
+      `${label} changed pixel count ${changePixels} is outside its ${totalPixels}px measured region`,
+    )
+  }
+  const changePercent = (changePixels / totalPixels) * 100
+  return {
+    changePercent,
+    changePixels,
+    passedMinimum: changePercent >= definition.minimumChangePercent,
+    totalPixels,
+  }
+}
+
+function measureProofMotionChange(input) {
+  return measureMotionChange({
+    ...input,
+    definition: MOTION_CHANGE_DEFINITION,
+  })
+}
+
+module.exports = {
+  MOTION_CHANGE_DEFINITION,
+  measureMotionChange,
+  measureProofMotionChange,
+}

package/detox/motion-change.d.cts

@@ -0,0 +1,35 @@
+export type MotionChangeDefinition = {
+  channelThreshold: number
+  minimumChangePercent: number
+}
+
+type MotionChangePixels = ArrayLike<number>
+
+export type MotionChangeInput = {
+  baseline?: MotionChangePixels
+  candidate?: MotionChangePixels
+  changePixels?: number
+  definition: MotionChangeDefinition
+  height?: number
+  installGlobal?: boolean
+  label?: string
+  totalPixels?: number
+  width?: number
+}
+
+export type MotionChangeMeasurement = {
+  changePercent: number
+  changePixels: number
+  passedMinimum: boolean
+  totalPixels: number
+}
+
+export const MOTION_CHANGE_DEFINITION: Readonly<MotionChangeDefinition>
+
+export function measureMotionChange(
+  input: MotionChangeInput,
+): MotionChangeMeasurement | null
+
+export function measureProofMotionChange(
+  input: Omit<MotionChangeInput, 'definition' | 'installGlobal'>,
+): MotionChangeMeasurement

package/dist-cli/bin.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-/*! sootsim v0.1.296 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.298 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 import { createRequire as __sootsimCreateRequire } from 'node:module'
 var require = __sootsimCreateRequire(import.meta.url)
-import{a as w,b as g}from"./chunks/chunk-DUYKBCM7.js";import"./chunks/chunk-X7B5KJ6N.js";function b(t){let a=t instanceof Error?t.message:String(t);(/^command timed out after \d+s$/.test(a)||a.startsWith("sim disconnected:")||a.startsWith("bridge never reconnected")||a.startsWith("multiple sims are connected:")||a.startsWith("saved sim ")||a.startsWith("no sim connected with id ")||a.startsWith("could not connect to ws://")||a.startsWith("sootsim bridge daemon is not running")||a.startsWith("sootsim bridge lockfile is fresh")||a.startsWith("sootsim bridge exited before becoming ready")||a.startsWith("background daemon setup is unavailable")||a.startsWith("sootsim bridge did not start within"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(`  ${a}
+import{a as w,b as g}from"./chunks/chunk-MHCSRMK4.js";import"./chunks/chunk-4H3Y3TGT.js";function b(t){let a=t instanceof Error?t.message:String(t);(/^command timed out after \d+s$/.test(a)||a.startsWith("sim disconnected:")||a.startsWith("bridge never reconnected")||a.startsWith("multiple sims are connected:")||a.startsWith("saved sim ")||a.startsWith("no sim connected with id ")||a.startsWith("could not connect to ws://")||a.startsWith("sootsim bridge daemon is not running")||a.startsWith("sootsim bridge lockfile is fresh")||a.startsWith("sootsim bridge exited before becoming ready")||a.startsWith("background daemon setup is unavailable")||a.startsWith("sootsim bridge did not start within"))&&!process.env.SOOTSIM_VERBOSE&&(process.stderr.write(`  ${a}
 `),process.exit(1)),t instanceof Error&&t.stack?process.stderr.write(`${t.stack}
 `):process.stderr.write(`${a}
 `),process.exit(1)}process.on("unhandledRejection",b);process.on("uncaughtException",b);var A=typeof __SOOTSIM_STANDALONE__<"u"&&__SOOTSIM_STANDALONE__,k=new Set(["desktop"]);function S(t){!A||!k.has(t)||(process.stderr.write(`  sootsim ${t} isn't available in the standalone binary \u2014
   it needs vite / electron / playwright from a project's node_modules.
   run the npm package instead:
     sootsim ${t}
-`),process.exit(1))}var e=g(process.argv);if(!e.command&&e.commandArgs.length>0){let{resolveHiddenRuntimeAlias:t}=await import("./chunks/hidden-runtime-alias-NSLIK6XT.js");e=t(e)}var _=e.command==="cleanup"&&e.commandArgs.length===1&&e.commandArgs[0]==="--automatic-worker";if(!_){let{trackCliEvent:t}=await import("./chunks/telemetry-GPNHSYFF.js");t({event:"cli_command_invoked",properties:{command:e.command||(e.version?"version":e.help?"help":"none"),arg_count:e.commandArgs.length,platform:process.platform,arch:process.arch,node_version:process.versions.node}})}if(e.command!=="serve"&&e.command!=="daemon"){let{consumeRuntimeUpgradeNotice:t}=await import("./chunks/home-paths-OC6JZXIM.js"),a=t();a&&process.stderr.write(`  SootSim engine upgraded to v${a.to}`+(a.from?` (from v${a.from})`:"")+` \xB7 what's new: https://sootsim.com/changelog
-`)}var f=!1;async function v(){if(!f&&(f=!0,!(e.command==="cleanup"||e.command==="serve"||e.command==="agent-wrapper"||e.command==="daemon"&&e.commandArgs[0]==="uninstall")))try{let{isAutomaticSootsimCleanupComplete:t}=await import("./chunks/disk-cleanup-GZSUZJ6Y.js");if(t())return;let{spawn:a}=await import("node:child_process"),s=["cleanup","--automatic-worker"],m=process.argv[1],d=A?a(process.execPath,s,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):m?a(process.execPath,[m,...s],{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):a("sootsim",s,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env});d.once("error",p=>{process.stderr.write(`  SootSim automatic cleanup will retry on the next run: ${p.message}
+`),process.exit(1))}var e=g(process.argv);if(!e.command&&e.commandArgs.length>0){let{resolveHiddenRuntimeAlias:t}=await import("./chunks/hidden-runtime-alias-4ZUCLCVJ.js");e=t(e)}var _=e.command==="cleanup"&&e.commandArgs.length===1&&e.commandArgs[0]==="--automatic-worker";if(!_){let{trackCliEvent:t}=await import("./chunks/telemetry-2UMKQXU7.js");t({event:"cli_command_invoked",properties:{command:e.command||(e.version?"version":e.help?"help":"none"),arg_count:e.commandArgs.length,platform:process.platform,arch:process.arch,node_version:process.versions.node}})}if(e.command!=="serve"&&e.command!=="daemon"){let{consumeRuntimeUpgradeNotice:t}=await import("./chunks/home-paths-PVZPREN7.js"),a=t();a&&process.stderr.write(`  SootSim engine upgraded to v${a.to}`+(a.from?` (from v${a.from})`:"")+` \xB7 what's new: https://sootsim.com/changelog
+`)}var f=!1;async function v(){if(!f&&(f=!0,!(e.command==="cleanup"||e.command==="serve"||e.command==="agent-wrapper"||e.command==="daemon"&&e.commandArgs[0]==="uninstall")))try{let{isAutomaticSootsimCleanupComplete:t}=await import("./chunks/disk-cleanup-3E7GYLGW.js");if(t())return;let{spawn:a}=await import("node:child_process"),s=["cleanup","--automatic-worker"],m=process.argv[1],d=A?a(process.execPath,s,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):m?a(process.execPath,[m,...s],{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env}):a("sootsim",s,{detached:!0,stdio:["ignore","ignore","inherit"],env:process.env});d.once("error",p=>{process.stderr.write(`  SootSim automatic cleanup will retry on the next run: ${p.message}
 `)}),d.unref()}catch(t){process.stderr.write(`  SootSim automatic cleanup will retry on the next run: ${t instanceof Error?t.message:String(t)}
-`)}}async function n(t){let{flushCliTelemetry:a}=await import("./chunks/telemetry-GPNHSYFF.js");await a(),await v(),process.exit(t)}if(e.version){let{getCliVersion:t}=await import("./chunks/cli-version-VZFF7GGM.js"),{IS_BETA:a,BETA_LABEL:s}=await import("./chunks/beta-4AXSOQLU.js"),m=a?` \xB7 ${s}`:"";console.log(`sootsim v${t()}${m}`);let{readActiveRuntime:d}=await import("./chunks/home-paths-OC6JZXIM.js"),p=d();console.log(p?`runtime v${p}`:"runtime not installed"),await n(0)}if(e.help&&!e.command){let{printHelp:t}=await import("./chunks/help-GEVJF2DA.js");t(),await n(0)}var o=e.globalFlags.port,c=e.verbose,u=e.globalFlags.device,l=e.globalFlags.theme,C=e.globalFlags.driver,O=e.globalFlags.headless===!0,h=e.globalFlags.sim??e.globalFlags.session??e.globalFlags.tab,i=h?["--sim",h,...e.commandArgs]:e.commandArgs;if(u||l){let{settingsStore:t}=await import("./chunks/store-VNSTKYBQ.js"),a={};u&&(a.deviceModel=u),l&&(a.colorScheme=l),t.apply(a)}if(!e.command&&e.commandArgs.length===0){let{runSetup:t,shouldRunSetupForBareCommand:a}=await import("./chunks/setup-MFYGYR2F.js");a()&&(await t(["--from-welcome"]),await n(0));let{printHelp:s}=await import("./chunks/help-GEVJF2DA.js");s(),await n(0)}var r=e.command??"";if(!r){if(e.commandArgs.length>0){let a=e.commandArgs.find(s=>!s.startsWith("-"))??e.commandArgs[0];console.error(`  unknown command: ${a}`),console.error("  run `sootsim --help` to see the full surface."),await n(1)}let{printHelp:t}=await import("./chunks/help-GEVJF2DA.js");t(),await n(0)}if(e.help||e.commandArgs.includes("--help")||e.commandArgs.includes("-h")){if(r==="skill"){let{runSkill:s}=await import("./chunks/skills-TD35LDKK.js");await s(e.commandArgs),await n(0)}let t=r==="do"||r==="get"||r==="debug"||r==="shell"||r==="perf"||r==="wait",a=e.commandArgs.find(s=>!s.startsWith("-"));if(!(r==="shell"||r==="perf"))if(t&&!a){let{printGroupHelp:s}=await import("./chunks/help-GEVJF2DA.js");s(r)&&await n(0)}else{let{printCommandHelp:s}=await import("./chunks/help-GEVJF2DA.js");s(t&&a?a:r,{prefer:t&&a?"verb":"command",group:t&&a?r:void 0}),await n(0)}}S(r);if(w.has(r)){let{runInspect:t}=await import("./chunks/inspect-KXJNI7CU.js");await t([r,...i],{port:o,verbose:c})}else switch(r){case"assert":{let{runAssert:t}=await import("./chunks/assert-R2ZUXEMS.js");await t(e.commandArgs);break}case"detox":{let{runDetox:t}=await import("./chunks/detox-QXJ3L2ZI.js");await t(e.commandArgs,{port:o,verbose:c});break}case"maestro":{let{runMaestro:t}=await import("./chunks/maestro-EEVXX536.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"record":{let{runRecord:t}=await import("./chunks/record-MJR5ELHE.js");await t(i,{port:o,verbose:c});break}case"film":{let{runFilm:t}=await import("./chunks/film-C25VRUNC.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"storage":{let{runStorage:t}=await import("./chunks/storage-VCFXDJNO.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"perf":{let{runPerf:t}=await import("./chunks/perf-CTTJSAIJ.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"screenshot":{let{runScreenshotCommand:t}=await import("./chunks/screenshot-command-MGNASAXR.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"mode":{let{runMode:t}=await import("./chunks/mode-6IXOZDK3.js");await t(i,{port:o,verbose:c});break}case"permissions":{let{runPermissions:t}=await import("./chunks/permissions-BFQS4DIY.js"),a=await t(i,{port:o,verbose:c});await n(a)}case"inspect":{let{runInspect:t}=await import("./chunks/inspect-KXJNI7CU.js");await t(i,{port:o,verbose:c});break}case"debug":{let{runDebug:t}=await import("./chunks/debug-AOYA2CLR.js");await t(i,{port:o,verbose:c});break}case"timeline":{let{runTimeline:t}=await import("./chunks/timeline-UJCZAWJV.js");await t(i,{port:o,verbose:c});break}case"what-happened":{let{runWhatHappened:t}=await import("./chunks/what-happened-HRHB6ETL.js");await t(i,{port:o,verbose:c});break}case"open":{let{runOpenCommand:t}=await import("./chunks/control-VBK32Y7F.js");await t(i,{port:o});break}case"use":{let{runUseCommand:t}=await import("./chunks/control-VBK32Y7F.js");await t(i,{port:o});break}case"claim":{let{runClaimCommand:t}=await import("./chunks/control-VBK32Y7F.js");await t(i,{port:o});break}case"close":{let{runCloseCommand:t}=await import("./chunks/control-VBK32Y7F.js");await t(i,{port:o});break}case"device":{let{runDeviceCommand:t}=await import("./chunks/device-NZZ5ZT3Q.js");await t(i,{port:o});break}case"compat":{let{runCompat:t}=await import("./chunks/compat-FABLN4UI.js");await t(e.commandArgs);break}case"report-issue":{let{runReportIssue:t}=await import("./chunks/report-issue-FMJRNDKH.js"),a=await t(e.commandArgs);await n(a)}case"desktop":{let{runDesktop:t}=await import("./chunks/desktop-G7XWDCTM.js");await t(e.commandArgs,{port:o,device:u,driver:C});break}case"login":{let{runLogin:t}=await import("./chunks/login-LB4TMM4T.js");await t(e.commandArgs);break}case"logout":{let{runLogout:t}=await import("./chunks/logout-33IOBD4X.js");await t();break}case"auth":{let{runAuth:t}=await import("./chunks/auth-CA62Q6IS.js");await t(e.commandArgs);break}case"setup":{let{runSetup:t}=await import("./chunks/setup-MFYGYR2F.js");await t(e.commandArgs);break}case"serve":{let{runServe:t}=await import("./chunks/serve-RS6TIO7U.js");await t(e.commandArgs,{port:o});break}case"daemon":{let{runDaemon:t}=await import("./chunks/daemon-VFO7LRR4.js");await t(e.commandArgs,{port:o});break}case"runtime":{let{runRuntime:t}=await import("./chunks/runtime-PV4HH2OB.js");await t(e.commandArgs);break}case"upgrade":case"update":{let{runUpgrade:t}=await import("./chunks/upgrade-S24NH4YG.js");await t(e.commandArgs);break}case"version":{let{runVersion:t}=await import("./chunks/version-IVPWT2ZQ.js");await t(e.commandArgs);break}case"agent":{let{runAgentCommand:t}=await import("./chunks/agent-3F4K6MQK.js"),a=await t(e.commandArgs);await n(a)}case"agent-wrapper":{let{runAgentWrapper:t}=await import("./chunks/agent-wrapper-5LLVCQRZ.js"),a=await t(e.commandArgs);await n(a)}case"skill":{let{runSkill:t}=await import("./chunks/skills-TD35LDKK.js");await t(e.commandArgs);break}case"app-fonts":{let{runAppFonts:t}=await import("./chunks/app-fonts-LPTY7A5G.js");await t(e.commandArgs);break}case"config":{let{runConfig:t}=await import("./chunks/config-74J37LKC.js");await t(e.commandArgs);break}case"cleanup":{let{runCleanup:t}=await import("./chunks/cleanup-4RSKYPQ7.js"),a=await t(e.commandArgs);await n(a)}default:console.error(`  unknown command: ${r}`),console.error("  run `sootsim --help` to see the full surface."),await n(1)}await v();
+`)}}async function n(t){let{flushCliTelemetry:a}=await import("./chunks/telemetry-2UMKQXU7.js");await a(),await v(),process.exit(t)}if(e.version){let{getCliVersion:t}=await import("./chunks/cli-version-ECA6G6JQ.js"),{IS_BETA:a,BETA_LABEL:s}=await import("./chunks/beta-SCLWNOHI.js"),m=a?` \xB7 ${s}`:"";console.log(`sootsim v${t()}${m}`);let{readActiveRuntime:d}=await import("./chunks/home-paths-PVZPREN7.js"),p=d();console.log(p?`runtime v${p}`:"runtime not installed"),await n(0)}if(e.help&&!e.command){let{printHelp:t}=await import("./chunks/help-UE32FDEY.js");t(),await n(0)}var o=e.globalFlags.port,c=e.verbose,u=e.globalFlags.device,l=e.globalFlags.theme,C=e.globalFlags.driver,O=e.globalFlags.headless===!0,h=e.globalFlags.sim??e.globalFlags.session??e.globalFlags.tab,i=h?["--sim",h,...e.commandArgs]:e.commandArgs;if(u||l){let{settingsStore:t}=await import("./chunks/store-3Z2GSFGY.js"),a={};u&&(a.deviceModel=u),l&&(a.colorScheme=l),t.apply(a)}if(!e.command&&e.commandArgs.length===0){let{runSetup:t,shouldRunSetupForBareCommand:a}=await import("./chunks/setup-2CUXSDQH.js");a()&&(await t(["--from-welcome"]),await n(0));let{printHelp:s}=await import("./chunks/help-UE32FDEY.js");s(),await n(0)}var r=e.command??"";if(!r){if(e.commandArgs.length>0){let a=e.commandArgs.find(s=>!s.startsWith("-"))??e.commandArgs[0];console.error(`  unknown command: ${a}`),console.error("  run `sootsim --help` to see the full surface."),await n(1)}let{printHelp:t}=await import("./chunks/help-UE32FDEY.js");t(),await n(0)}if(e.help||e.commandArgs.includes("--help")||e.commandArgs.includes("-h")){if(r==="skill"){let{runSkill:s}=await import("./chunks/skills-IILJVUMS.js");await s(e.commandArgs),await n(0)}let t=r==="do"||r==="get"||r==="debug"||r==="shell"||r==="perf"||r==="wait",a=e.commandArgs.find(s=>!s.startsWith("-"));if(!(r==="shell"||r==="perf"))if(t&&!a){let{printGroupHelp:s}=await import("./chunks/help-UE32FDEY.js");s(r)&&await n(0)}else{let{printCommandHelp:s}=await import("./chunks/help-UE32FDEY.js");s(t&&a?a:r,{prefer:t&&a?"verb":"command",group:t&&a?r:void 0}),await n(0)}}S(r);if(w.has(r)){let{runInspect:t}=await import("./chunks/inspect-QWR2U3DK.js");await t([r,...i],{port:o,verbose:c})}else switch(r){case"assert":{let{runAssert:t}=await import("./chunks/assert-NNKBTEO7.js");await t(e.commandArgs);break}case"detox":{let{runDetox:t}=await import("./chunks/detox-4RZ5UER3.js");await t(e.commandArgs,{port:o,verbose:c});break}case"maestro":{let{runMaestro:t}=await import("./chunks/maestro-33RGEXP4.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"record":{let{runRecord:t}=await import("./chunks/record-A4MRKJ2E.js");await t(i,{port:o,verbose:c});break}case"film":{let{runFilm:t}=await import("./chunks/film-Q7KZIGBH.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"storage":{let{runStorage:t}=await import("./chunks/storage-BUQQJAMD.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"perf":{let{runPerf:t}=await import("./chunks/perf-VW3UTYCK.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"screenshot":{let{runScreenshotCommand:t}=await import("./chunks/screenshot-command-6LROQJPJ.js"),a=await t(i,{port:o,verbose:c});await n(typeof a=="number"?a:0)}case"mode":{let{runMode:t}=await import("./chunks/mode-LZORZYWP.js");await t(i,{port:o,verbose:c});break}case"permissions":{let{runPermissions:t}=await import("./chunks/permissions-7JIR6QPO.js"),a=await t(i,{port:o,verbose:c});await n(a)}case"inspect":{let{runInspect:t}=await import("./chunks/inspect-QWR2U3DK.js");await t(i,{port:o,verbose:c});break}case"debug":{let{runDebug:t}=await import("./chunks/debug-MVPFRIQA.js");await t(i,{port:o,verbose:c});break}case"timeline":{let{runTimeline:t}=await import("./chunks/timeline-62RWUHSF.js");await t(i,{port:o,verbose:c});break}case"what-happened":{let{runWhatHappened:t}=await import("./chunks/what-happened-UKBSKIGA.js");await t(i,{port:o,verbose:c});break}case"open":{let{runOpenCommand:t}=await import("./chunks/control-BY6UAMKN.js");await t(i,{port:o});break}case"use":{let{runUseCommand:t}=await import("./chunks/control-BY6UAMKN.js");await t(i,{port:o});break}case"claim":{let{runClaimCommand:t}=await import("./chunks/control-BY6UAMKN.js");await t(i,{port:o});break}case"close":{let{runCloseCommand:t}=await import("./chunks/control-BY6UAMKN.js");await t(i,{port:o});break}case"device":{let{runDeviceCommand:t}=await import("./chunks/device-7R4BSFMS.js");await t(i,{port:o});break}case"compat":{let{runCompat:t}=await import("./chunks/compat-OM7ODBMO.js");await t(e.commandArgs);break}case"report-issue":{let{runReportIssue:t}=await import("./chunks/report-issue-JUWTB66Z.js"),a=await t(e.commandArgs);await n(a)}case"desktop":{let{runDesktop:t}=await import("./chunks/desktop-ZXH7NRHW.js");await t(e.commandArgs,{port:o,device:u,driver:C});break}case"login":{let{runLogin:t}=await import("./chunks/login-UMP65DJG.js");await t(e.commandArgs);break}case"logout":{let{runLogout:t}=await import("./chunks/logout-F45WBVJV.js");await t();break}case"auth":{let{runAuth:t}=await import("./chunks/auth-SF2WR2K2.js");await t(e.commandArgs);break}case"setup":{let{runSetup:t}=await import("./chunks/setup-2CUXSDQH.js");await t(e.commandArgs);break}case"serve":{let{runServe:t}=await import("./chunks/serve-64SRDCU5.js");await t(e.commandArgs,{port:o});break}case"daemon":{let{runDaemon:t}=await import("./chunks/daemon-BQ2T53ZA.js");await t(e.commandArgs,{port:o});break}case"runtime":{let{runRuntime:t}=await import("./chunks/runtime-7LSOODXL.js");await t(e.commandArgs);break}case"upgrade":case"update":{let{runUpgrade:t}=await import("./chunks/upgrade-GHXDTO2A.js");await t(e.commandArgs);break}case"version":{let{runVersion:t}=await import("./chunks/version-F4CKBMB6.js");await t(e.commandArgs);break}case"agent":{let{runAgentCommand:t}=await import("./chunks/agent-U3HXOT6B.js"),a=await t(e.commandArgs);await n(a)}case"agent-wrapper":{let{runAgentWrapper:t}=await import("./chunks/agent-wrapper-LJOPJUAN.js"),a=await t(e.commandArgs);await n(a)}case"skill":{let{runSkill:t}=await import("./chunks/skills-IILJVUMS.js");await t(e.commandArgs);break}case"app-fonts":{let{runAppFonts:t}=await import("./chunks/app-fonts-4EVLV2BX.js");await t(e.commandArgs);break}case"config":{let{runConfig:t}=await import("./chunks/config-ZIX6LPFG.js");await t(e.commandArgs);break}case"cleanup":{let{runCleanup:t}=await import("./chunks/cleanup-YZPCNPWE.js"),a=await t(e.commandArgs);await n(a)}default:console.error(`  unknown command: ${r}`),console.error("  run `sootsim --help` to see the full surface."),await n(1)}await v();