peachsim 0.1.1641 → 0.1.1653

package/detox/motion-change.cjs

@@ -1,11 +1,9 @@
-// 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,
-})
+const {
+  MOTION_CHANGE_DEFINITION,
+  DISCRETE_FRAME_TIMING_TOLERANCE_MS,
+  parseDiscreteFrameCadence,
+} = require('../../peach-conformance/src/cases/checkpoint-evidence.cjs')
+const { frameTimingRoundingBound } = require('./frame-offset.mjs')
 
 function measureMotionChange(input) {
   if (!input || typeof input !== 'object' || Array.isArray(input)) {
@@ -112,8 +110,10 @@ const PAIRED_MOTION_MINIMUM_CHANGE_PERCENT = 0.3
 const SETTLE_BLIP_MAXIMUM_CHANGE_PERCENT = 0.6
 
 // a present or dismiss records one second (60 transitions); a gesture ladder
-// records four. a gesture jumps at its touch cadence and each capture phases
-// that cadence differently, so a gesture is graded by total travel instead of
+// records four. repeated animation ladders can also exceed that length, but
+// their declared cycles retain frame pairing. a gesture jumps at its touch
+// cadence and each capture phases that cadence differently, so it is graded by
+// total travel instead of
 // by frame. travel is judged over the whole gesture and again over each quarter
 // so one jump or a lagging release cannot pass on its total.
 const GESTURE_MOTION_MIN_TRANSITIONS = 120
@@ -127,7 +127,7 @@ const GESTURE_QUARTER_TRAVEL_RATIO_RANGE = Object.freeze({ min: 0.5, max: 2 })
 // against a moving oracle fails. a gesture needs sootsim's total travel within
 // a range of the oracle's. both lanes hold the same unique stage-label
 // transitions in the same order; every measurement must exist.
-function evaluateMotionTransitions(transitions, oracleTarget) {
+function evaluateMotionTransitions(transitions, oracleTarget, repeating) {
   const key = (transition) => `${transition.fromLabel}\u0000${transition.toLabel}`
   const oracle = transitions.filter((transition) => transition.target === oracleTarget)
   const sootsim = transitions.filter((transition) => transition.target === 'sootsim')
@@ -149,7 +149,9 @@ function evaluateMotionTransitions(transitions, oracleTarget) {
       )
       .reduce((total, transition) => total + transition.changePercent, 0)
   const movesNear = (list, index) =>
-    [index - 1, index, index + 1].some((neighbour) => list[neighbour]?.passedMinimum === true)
+    [index - 1, index, index + 1].some(
+      (neighbour) => list[neighbour]?.passedMinimum === true,
+    )
   const pairedChange = (transition) =>
     transition.changePercent >= PAIRED_MOTION_MINIMUM_CHANGE_PERCENT
   const settleBlip = (list) => {
@@ -175,7 +177,7 @@ function evaluateMotionTransitions(transitions, oracleTarget) {
       Math.floor((list.length * (index + 1)) / 4),
     )
   const follows =
-    oracle.length >= GESTURE_MOTION_MIN_TRANSITIONS
+    !repeating && oracle.length >= GESTURE_MOTION_MIN_TRANSITIONS
       ? within(travel(sootsim), travel(oracle), GESTURE_TRAVEL_RATIO_RANGE) &&
         [0, 1, 2, 3].every((index) =>
           within(
@@ -192,108 +194,17 @@ function evaluateMotionTransitions(transitions, oracleTarget) {
         ) &&
         sootsim.every(
           (transition, index) =>
-            !pairedChange(transition) || index === sootsimBlip || movesNear(oracle, index),
+            !pairedChange(transition) ||
+            index === sootsimBlip ||
+            movesNear(oracle, index),
         )
   return {
     moving: moving.length,
-    passed:
-      measured &&
-      oracle.length > 0 &&
-      paired &&
-      moving.length > 0 &&
-      follows,
+    passed: measured && oracle.length > 0 && paired && moving.length > 0 && follows,
   }
 }
 
 const DISPLAY_LINK_INTERVAL_MS = 1000 / 60
-const DISCRETE_FRAME_TIMING_TOLERANCE_MS = 1000 / 60 + 1000 / 600
-
-function parseDiscreteFrameCadence(value) {
-  const fail = (message) => {
-    throw new Error(`discrete frame cadence ${message}`)
-  }
-  if (!value || value.kind !== 'discrete-frame' || !value.asset || !value.probe)
-    fail('requires an explicit asset and probe')
-  for (const field of ['fixtureSha256', 'encodedSha256', 'calibrationSha256']) {
-    if (!/^[a-f0-9]{64}$/.test(value.asset[field])) fail(`has invalid ${field}`)
-  }
-  for (const field of ['fixturePath', 'calibrationPath']) {
-    if (
-      typeof value.asset[field] !== 'string' ||
-      !value.asset[field] ||
-      value.asset[field].startsWith('/') ||
-      value.asset[field].split('/').includes('..')
-    )
-      fail(`has invalid ${field}`)
-  }
-  if (
-    typeof value.probe.elementName !== 'string' ||
-    !value.probe.elementName ||
-    !Number.isFinite(value.probe.inset) ||
-    value.probe.inset < 0
-  )
-    fail('has invalid probe')
-  if (!Array.isArray(value.asset.frames) || value.asset.frames.length < 2)
-    fail('needs at least two frames')
-  for (const [index, frame] of value.asset.frames.entries()) {
-    if (
-      !frame ||
-      !Number.isFinite(frame.durationMs) ||
-      frame.durationMs <= 2 * DISCRETE_FRAME_TIMING_TOLERANCE_MS
-    )
-      fail(`frame ${index} duration is unresolvable`)
-    if (
-      !Array.isArray(frame.uniformRgba) ||
-      frame.uniformRgba.length !== 4 ||
-      frame.uniformRgba.some(
-        (channel) => !Number.isInteger(channel) || channel < 0 || channel > 255,
-      )
-    )
-      fail(`frame ${index} needs uniform rgba`)
-    const next = value.asset.frames[(index + 1) % value.asset.frames.length]
-    if (
-      next?.uniformRgba &&
-      frame.uniformRgba.every((channel, i) => channel === next.uniformRgba[i])
-    )
-      fail('adjacent phases must differ')
-  }
-  for (let i = 0; i < value.asset.frames.length; i++) {
-    for (let j = i + 1; j < value.asset.frames.length; j++) {
-      if (
-        !value.asset.frames[i].uniformRgba.some(
-          (channel, k) =>
-            Math.abs(channel - value.asset.frames[j].uniformRgba[k]) >
-            MOTION_CHANGE_DEFINITION.channelThreshold,
-        )
-      )
-        fail('phase colors cannot resolve the shared visible-change gate')
-    }
-  }
-  if (value.mode === 'playing') {
-    if (
-      !Number.isInteger(value.entryFrame) ||
-      value.entryFrame < 0 ||
-      value.entryFrame >= value.asset.frames.length ||
-      value.minimumTransitions !== 2
-    )
-      fail('playing mode needs an entry frame and two transitions')
-  } else if (value.mode === 'frozen') {
-    if (
-      !Array.isArray(value.waitIntervalsMs) ||
-      value.waitIntervalsMs.length < 2 ||
-      value.waitIntervalsMs.some((ms) => !Number.isFinite(ms) || ms <= 0)
-    )
-      fail('frozen mode needs two positive waits')
-    if (
-      !Array.isArray(value.captures) ||
-      value.captures.length !== value.waitIntervalsMs.length ||
-      value.captures.some((id) => typeof id !== 'string' || !id) ||
-      new Set(value.captures).size !== value.captures.length
-    )
-      fail('frozen mode needs distinct capture identities')
-  } else fail('has an unknown mode')
-  return value
-}
 
 function classifyDiscreteFrame(input) {
   // self-contained so the exact classifier can be installed inside a page.
@@ -381,8 +292,10 @@ function evaluateDiscreteFrameTrace(input) {
   // media lifetime. a virtual trace must include every tick through its end.
   const last = observations.at(-1)
   if (
-    observations[0].atMs > coverageStartMs ||
-    (clock === 'peach-virtual' && last.atMs < coverageEndMs) ||
+    observations[0].atMs - coverageStartMs >
+      frameTimingRoundingBound(observations[0].atMs, coverageStartMs) ||
+    (clock === 'peach-virtual' &&
+      coverageEndMs - last.atMs > frameTimingRoundingBound(coverageEndMs, last.atMs)) ||
     (clock === 'native-presentation' &&
       (!Number.isFinite(input.mediaDurationMs) ||
         input.mediaDurationMs < coverageEndMs ||
@@ -430,8 +343,17 @@ function evaluateDiscreteFrameTrace(input) {
   if (!before || before.phase === null || before.phase === anchor.phase)
     throw new Error('discrete trace entry did not change from the pre-trigger phase')
   const endMs = anchor.atMs + windowMs
-  if (coverageEndMs < endMs) throw new Error('discrete playing trace is truncated')
-  const rows = observations.filter((row) => row.atMs >= anchor.atMs && row.atMs <= endMs)
+  if (
+    endMs - coverageEndMs >
+    frameTimingRoundingBound(anchor.atMs, windowMs, endMs, coverageEndMs)
+  )
+    throw new Error('discrete playing trace is truncated')
+  const rows = observations.filter(
+    (row) =>
+      row.atMs >= anchor.atMs &&
+      row.atMs - endMs <=
+        frameTimingRoundingBound(row.atMs, anchor.atMs, windowMs, endMs),
+  )
   if (rows.some((row) => row.phase === null))
     throw new Error('discrete playing trace has an unexpected frame')
   const changes = rows.filter((row, i) => i === 0 || row.phase !== rows[i - 1].phase)
@@ -451,7 +373,10 @@ function evaluateDiscreteFrameTrace(input) {
       cadence.asset.frames[previous.phase].durationMs +
       (i === 1 && cadence.entryFrame === 0 ? DISPLAY_LINK_INTERVAL_MS : 0)
     const observedMs = changes[i].atMs - previous.atMs
-    if (Math.abs(observedMs - expectedMs) > DISCRETE_FRAME_TIMING_TOLERANCE_MS)
+    if (
+      Math.abs(observedMs - expectedMs) - DISCRETE_FRAME_TIMING_TOLERANCE_MS >
+      frameTimingRoundingBound(changes[i].atMs, previous.atMs, observedMs, expectedMs)
+    )
       throw new Error(
         `discrete trace wrong cadence: phase ${previous.phase}, expected ${expectedMs}ms, observed ${observedMs}ms`,
       )
@@ -527,9 +452,20 @@ function motionCyclePeriods(reference, sootsim) {
   return reference.slice(1).map((onset, index) => {
     const referenceMs = onset.atMs - reference[index].atMs
     const sootsimMs = sootsim[index + 1].atMs - sootsim[index].atMs
+    const driftMs = Math.abs(referenceMs - sootsimMs)
+    const roundingMs = frameTimingRoundingBound(
+      onset.atMs,
+      reference[index].atMs,
+      sootsim[index + 1].atMs,
+      sootsim[index].atMs,
+      referenceMs,
+      sootsimMs,
+      driftMs,
+      MOTION_CYCLE_PERIOD_TOLERANCE_MS,
+    )
     return {
       id: onset.id,
-      passed: Math.abs(referenceMs - sootsimMs) <= MOTION_CYCLE_PERIOD_TOLERANCE_MS,
+      passed: driftMs - MOTION_CYCLE_PERIOD_TOLERANCE_MS <= roundingMs,
       referenceMs,
       sootsimMs,
     }
@@ -568,7 +504,8 @@ function evaluateMotionPublication(stages, transitions, oracleTarget, cycleOnset
       last.passedThreshold &&
       (!needsIntermediates || movingPassed >= PUBLICATION_MIN_INTERMEDIATE_PASSES) &&
       cyclePeriods.every((period) => period.passed) &&
-      evaluateMotionTransitions(transitions, oracleTarget).passed,
+      evaluateMotionTransitions(transitions, oracleTarget, cyclePeriods.length > 0)
+        .passed,
     cyclePeriods,
     intermediateCount: intermediates.length,
     intermediatePassed,
@@ -577,14 +514,11 @@ function evaluateMotionPublication(stages, transitions, oracleTarget, cycleOnset
 }
 
 module.exports = {
-  MOTION_CHANGE_DEFINITION,
   evaluateMotionPublication,
   motionCycleOnsets,
   measureMotionChange,
   measureProofMotionChange,
   evaluateMotionTransitions,
-  DISCRETE_FRAME_TIMING_TOLERANCE_MS,
-  parseDiscreteFrameCadence,
   classifyDiscreteFrame,
   evaluateDiscreteFrameTrace,
 }

package/detox/motion-change.d.cts

@@ -1,7 +1,8 @@
-export type MotionChangeDefinition = {
-  channelThreshold: number
-  minimumChangePercent: number
-}
+import type {
+  MotionChangeDefinition,
+  DiscreteFrameAsset,
+  DiscreteFrameCadence,
+} from '../../peach-conformance/src/cases/checkpoint-evidence.cjs'
 
 type MotionChangePixels = ArrayLike<number>
 
@@ -24,8 +25,6 @@ export type MotionChangeMeasurement = {
   totalPixels: number
 }
 
-export const MOTION_CHANGE_DEFINITION: Readonly<MotionChangeDefinition>
-
 export function measureMotionChange(
   input: MotionChangeInput,
 ): MotionChangeMeasurement | null
@@ -50,6 +49,7 @@ export type MotionTransitionSample = {
 export function evaluateMotionTransitions(
   transitions: MotionTransitionSample[],
   oracleTarget: string,
+  repeating: boolean,
 ): {
   moving: number
   passed: boolean
@@ -87,25 +87,6 @@ export function evaluateMotionPublication(
   movingPassed: number
 }
 
-export type DiscreteFrameAsset = {
-  fixturePath: string
-  fixtureSha256: string
-  encodedSha256: string
-  calibrationPath: string
-  calibrationSha256: string
-  frames: readonly {
-    durationMs: number
-    uniformRgba: readonly [number, number, number, number]
-  }[]
-}
-export type DiscreteFrameCadence = {
-  kind: 'discrete-frame'
-  asset: DiscreteFrameAsset
-  probe: { elementName: string; inset: number }
-} & (
-  | { mode: 'playing'; entryFrame: number; minimumTransitions: 2 }
-  | { mode: 'frozen'; waitIntervalsMs: readonly number[]; captures: readonly string[] }
-)
 export type DiscreteFrameObservation = {
   frameIndex: number
   atMs: number
@@ -149,8 +130,6 @@ export type DiscreteFrameDecision = {
   holds: { phase: number; expectedMs: number; observedMs: number }[]
   waitIntervals?: { startMs: number; endMs: number }[]
 }
-export const DISCRETE_FRAME_TIMING_TOLERANCE_MS: number
-export function parseDiscreteFrameCadence(value: unknown): DiscreteFrameCadence
 export function classifyDiscreteFrame(input: {
   pixels?: ArrayLike<number>
   frames?: DiscreteFrameAsset['frames']

package/detox/motion-leg-starts.cjs

@@ -0,0 +1,20 @@
+// animation start witnesses are diagnostics; they never replace pixel or cycle grading.
+function animationLegStarts(value) {
+  if (!Array.isArray(value) || value.length === 0)
+    throw new Error('animation leg starts must be a non-empty array')
+  return value.map((row) => {
+    if (
+      !row ||
+      typeof row.track !== 'string' ||
+      !row.track ||
+      typeof row.leg !== 'string' ||
+      !row.leg ||
+      !Number.isFinite(row.atMs) ||
+      !Number.isFinite(row.startValue)
+    )
+      throw new Error('invalid animation leg start witness')
+    return { track: row.track, leg: row.leg, atMs: row.atMs, startValue: row.startValue }
+  })
+}
+
+module.exports = { animationLegStarts }

package/detox/motion-leg-starts.d.cts

@@ -0,0 +1,8 @@
+export type AnimationLegStart = {
+  track: string
+  leg: string
+  atMs: number
+  startValue: number
+}
+
+export function animationLegStarts(value: unknown): AnimationLegStart[]

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -39,7 +39,7 @@ __export(backend_origin_exports, {
   resolveContrastBackendOrigin: () => resolveContrastBackendOrigin
 });
 module.exports = __toCommonJS(backend_origin_exports);
-var DEFAULT_CONTRAST_BACKEND_ORIGIN = "https://contrast.dev";
+var DEFAULT_CONTRAST_BACKEND_ORIGIN = "https://peachsim.com";
 var LOOPBACK_PROBE_HOSTNAMES = ["127.0.0.1", "::1"];
 function normalizeHostname(hostname) {
   return hostname.replace(/^\[|\]$/g, "").toLowerCase();
@@ -100,7 +100,7 @@ function isBrowserAssetProxyUrl(value) {
 var PEACHSIM_NATIVE_HOST = "native.peachsim.com";
 function isContrastBackendHost(hostname) {
   const normalized = normalizeHostname(hostname);
-  return isLoopbackHost(normalized) || normalized === "contrast.dev" || normalized.endsWith(".contrast.dev") || normalized === PEACHSIM_NATIVE_HOST;
+  return isLoopbackHost(normalized) || normalized === "contrast.dev" || normalized.endsWith(".contrast.dev") || normalized === "peachsim.com" || normalized === "www.peachsim.com" || normalized === PEACHSIM_NATIVE_HOST;
 }
 function isContrastBackendOrigin(origin) {
   try {

package/dist-lib/beta.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -25,6 +25,8 @@ __export(bridge_contract_input_exports, {
   BridgeInputError: () => BridgeInputError,
   SEMANTIC_WAIT_MAX_TIMEOUT_MS: () => SEMANTIC_WAIT_MAX_TIMEOUT_MS,
   findInvalidPointerSequence: () => findInvalidPointerSequence,
+  parseDiagnosticsOptions: () => parseDiagnosticsOptions,
+  parseDiagnosticsResult: () => parseDiagnosticsResult,
   parsePerformStep: () => parsePerformStep,
   parseResetOptions: () => parseResetOptions,
   parseScreenshotOptions: () => parseScreenshotOptions,
@@ -314,6 +316,66 @@ function findInvalidPointerSequence(steps) {
     error: `perform.steps[${next.value[1]}] (touchDown) has no matching touchUp or touchCancel for pointer ${next.value[0]}`
   };
 }
+function diagnosticsChannels(value, path) {
+  if (!Array.isArray(value)) validationFailure(path, "must be a list of channel names");
+  return value.map((channel) => stringValue(channel, path));
+}
+function parseDiagnosticsResult(value) {
+  if (!isRecord(value) || !Array.isArray(value.channels) || !value.channels.every((channel) => typeof channel === "string") || !Array.isArray(value.availableChannels) || !value.availableChannels.every((channel) => typeof channel === "string") || !Array.isArray(value.events)) {
+    validationFailure(
+      "remote diagnostics",
+      "returned an incompatible native host response"
+    );
+  }
+  return {
+    channels: value.channels,
+    availableChannels: value.availableChannels,
+    runtime: value.runtime,
+    found: value.found,
+    events: value.events
+  };
+}
+function parseDiagnosticsOptions(value) {
+  const options = recordValue(value, "diagnostics");
+  const channels = options.channels === void 0 ? void 0 : diagnosticsChannels(options.channels, "diagnostics.channels");
+  let channelControl;
+  if (options.channelControl !== void 0) {
+    if (channels !== void 0) {
+      validationFailure("diagnostics.channelControl", "cannot be combined with channels");
+    }
+    const control = recordValue(options.channelControl, "diagnostics.channelControl");
+    const action = control.action;
+    if (action !== "enable" && action !== "disable" && action !== "toggle") {
+      validationFailure(
+        "diagnostics.channelControl.action",
+        "must be enable, disable, or toggle"
+      );
+    }
+    const selected = diagnosticsChannels(
+      control.channels,
+      "diagnostics.channelControl.channels"
+    );
+    if (action === "toggle" && (selected.length !== 1 || selected[0] === "all")) {
+      validationFailure("diagnostics.channelControl", "toggle requires one channel");
+    }
+    channelControl = { action, channels: selected };
+  }
+  const find = options.find;
+  if (find !== void 0 && find !== "sheets" && find !== "portals" && find !== "boundaries") {
+    validationFailure("diagnostics.find", "must be sheets, portals, or boundaries");
+  }
+  return {
+    ...channels === void 0 ? {} : { channels },
+    ...channelControl === void 0 ? {} : { channelControl },
+    ...find === void 0 ? {} : { find },
+    ...options.recentChannel === void 0 ? {} : {
+      recentChannel: stringValue(options.recentChannel, "diagnostics.recentChannel")
+    },
+    ...options.recentLimit === void 0 ? {} : {
+      recentLimit: numberValue(options.recentLimit, "diagnostics.recentLimit")
+    }
+  };
+}
 function parseStateOptions(value) {
   const input = recordValue(value, "state");
   const route = optionalBoolean(input, "route", "state");
@@ -487,6 +549,8 @@ function parseTapTarget(value) {
   BridgeInputError,
   SEMANTIC_WAIT_MAX_TIMEOUT_MS,
   findInvalidPointerSequence,
+  parseDiagnosticsOptions,
+  parseDiagnosticsResult,
   parsePerformStep,
   parseResetOptions,
   parseScreenshotOptions,

package/dist-lib/bridge-contract-input.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/bridge-contract.ts
 var SIM_LONG_PRESS_MAX_MS = 5e3;
@@ -278,6 +278,66 @@ function findInvalidPointerSequence(steps) {
     error: `perform.steps[${next.value[1]}] (touchDown) has no matching touchUp or touchCancel for pointer ${next.value[0]}`
   };
 }
+function diagnosticsChannels(value, path) {
+  if (!Array.isArray(value)) validationFailure(path, "must be a list of channel names");
+  return value.map((channel) => stringValue(channel, path));
+}
+function parseDiagnosticsResult(value) {
+  if (!isRecord(value) || !Array.isArray(value.channels) || !value.channels.every((channel) => typeof channel === "string") || !Array.isArray(value.availableChannels) || !value.availableChannels.every((channel) => typeof channel === "string") || !Array.isArray(value.events)) {
+    validationFailure(
+      "remote diagnostics",
+      "returned an incompatible native host response"
+    );
+  }
+  return {
+    channels: value.channels,
+    availableChannels: value.availableChannels,
+    runtime: value.runtime,
+    found: value.found,
+    events: value.events
+  };
+}
+function parseDiagnosticsOptions(value) {
+  const options = recordValue(value, "diagnostics");
+  const channels = options.channels === void 0 ? void 0 : diagnosticsChannels(options.channels, "diagnostics.channels");
+  let channelControl;
+  if (options.channelControl !== void 0) {
+    if (channels !== void 0) {
+      validationFailure("diagnostics.channelControl", "cannot be combined with channels");
+    }
+    const control = recordValue(options.channelControl, "diagnostics.channelControl");
+    const action = control.action;
+    if (action !== "enable" && action !== "disable" && action !== "toggle") {
+      validationFailure(
+        "diagnostics.channelControl.action",
+        "must be enable, disable, or toggle"
+      );
+    }
+    const selected = diagnosticsChannels(
+      control.channels,
+      "diagnostics.channelControl.channels"
+    );
+    if (action === "toggle" && (selected.length !== 1 || selected[0] === "all")) {
+      validationFailure("diagnostics.channelControl", "toggle requires one channel");
+    }
+    channelControl = { action, channels: selected };
+  }
+  const find = options.find;
+  if (find !== void 0 && find !== "sheets" && find !== "portals" && find !== "boundaries") {
+    validationFailure("diagnostics.find", "must be sheets, portals, or boundaries");
+  }
+  return {
+    ...channels === void 0 ? {} : { channels },
+    ...channelControl === void 0 ? {} : { channelControl },
+    ...find === void 0 ? {} : { find },
+    ...options.recentChannel === void 0 ? {} : {
+      recentChannel: stringValue(options.recentChannel, "diagnostics.recentChannel")
+    },
+    ...options.recentLimit === void 0 ? {} : {
+      recentLimit: numberValue(options.recentLimit, "diagnostics.recentLimit")
+    }
+  };
+}
 function parseStateOptions(value) {
   const input = recordValue(value, "state");
   const route = optionalBoolean(input, "route", "state");
@@ -450,6 +510,8 @@ export {
   BridgeInputError,
   SEMANTIC_WAIT_MAX_TIMEOUT_MS,
   findInvalidPointerSequence,
+  parseDiagnosticsOptions,
+  parseDiagnosticsResult,
   parsePerformStep,
   parseResetOptions,
   parseScreenshotOptions,

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1641 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1653 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -29,6 +29,8 @@ __export(bridge_contract_exports, {
   SEMANTIC_READY_POLL_MS: () => SEMANTIC_READY_POLL_MS,
   SIM_LONG_PRESS_DEFAULT_MS: () => SIM_LONG_PRESS_DEFAULT_MS,
   SIM_LONG_PRESS_MAX_MS: () => SIM_LONG_PRESS_MAX_MS,
+  WRITE_COMMAND_TYPES: () => WRITE_COMMAND_TYPES,
+  commandWritesSim: () => commandWritesSim,
   performStepRefusal: () => performStepRefusal,
   readyProbeContentBasis: () => readyProbeContentBasis,
   readyProbeHasContent: () => readyProbeHasContent,
@@ -122,6 +124,20 @@ function readyProbeHasContent(probe) {
 function readyProbeIsReady(probe) {
   return readyProbeContentBasis(probe) !== "" && probe.externalReady !== false && !probe.externalError && !probe.loadingText;
 }
+var WRITE_COMMAND_TYPES = /* @__PURE__ */ new Set([
+  "tap",
+  "keyboard",
+  "longPress",
+  "perform",
+  "reset",
+  "camera"
+]);
+function commandWritesSim(msg) {
+  if (typeof msg.type !== "string") return false;
+  if (msg.acquireLock === true) return true;
+  if (msg.readOnly === true) return false;
+  return WRITE_COMMAND_TYPES.has(msg.type);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   HEADLESS_TENANT_FETCH_HUNG_MARKER,
@@ -131,6 +147,8 @@ function readyProbeIsReady(probe) {
   SEMANTIC_READY_POLL_MS,
   SIM_LONG_PRESS_DEFAULT_MS,
   SIM_LONG_PRESS_MAX_MS,
+  WRITE_COMMAND_TYPES,
+  commandWritesSim,
   performStepRefusal,
   readyProbeContentBasis,
   readyProbeHasContent,