sootsim 0.1.301 → 0.1.303

package/dist-lib/home-paths.cjs

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

package/dist-lib/host/bridge-host.cjs

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

package/dist-lib/host/fetch-proxy-handler.cjs

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

package/dist-lib/host/fetch-proxy-overrides.cjs

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

package/dist-lib/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.301 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.303 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

package/dist-lib/host/websocket-proxy.cjs

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

package/dist-lib/index.cjs

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

package/dist-lib/jump-to-source-babel.cjs

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

package/dist-lib/menu.cjs

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

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.301 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.303 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/menu.ts
 var SOOTSIM_ENGINE_EVENT_NAME = "sootsim:engine-event";

package/dist-lib/metro.cjs

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

package/dist-lib/profiles.cjs

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

package/dist-lib/render-mode.cjs

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

package/dist-lib/scripts/dev-server-scanner.cjs

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

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.301 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.303 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -175,9 +175,14 @@ async function inspectDescribe(bridge, dumpOpts) {
         const body = escaped.replace(/\\*/g, '.*').replace(/\\?/g, '.')
         return new RegExp('^' + body + '$', 'i')
       }
-      const truncate = (value, max) => {
+      // clipping a describe line is a DISPLAY decision. opts.fullText (set by
+      // \`describe --json\`) keeps the real string, so a bundle-eval stack or a
+      // red-box message reaches the caller whole instead of ending in an
+      // ellipsis nothing downstream can undo.
+      const clipForDisplay = (value, max) => {
         const text = typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim() : ''
-        return text.length > max ? text.slice(0, max - 1).trimEnd() + '\u2026' : text
+        if (opts.fullText || text.length <= max) return text
+        return text.slice(0, max - 1).trimEnd() + '\u2026'
       }
       const formatInspectableTree = async () => {
         if (typeof t.listInspectable !== 'function') return null
@@ -205,10 +210,12 @@ async function inspectDescribe(bridge, dumpOpts) {
           if (role) parts.push('[' + role + ']')
           else if (handlers.length > 0) parts.push('[tap]')
           else parts.push('<' + type + '>')
-          const visibleText = truncate(text, 50)
+          const visibleText = clipForDisplay(text, 50)
           if (visibleText) parts.push(JSON.stringify(visibleText))
           if (testID) parts.push('#' + testID)
-          if (label && label !== text) parts.push('label=' + JSON.stringify(truncate(label, 50)))
+          if (label && label !== text) {
+            parts.push('label=' + JSON.stringify(clipForDisplay(label, 50)))
+          }
           if (!opts.hideXy) {
             const abs = node?.absolute || {}
             const layout = node?.layout || {}
@@ -960,7 +967,11 @@ var WAIT_READY_PROBE = `(async () => {
         const suppressed = external.entryErrors.find((item) => isReal(item) && item.suppressed === true)
         if (suppressed) suppressedEntryError = suppressed.message
       }
-      if (externalReady === false && externalStatus) loadingText = externalStatus
+      // once the app has errored its last status ("injecting sootsim
+      // modules...") is stale \u2014 reporting it makes a dead app read as one that
+      // is still booting.
+      if (externalError) loadingText = ''
+      else if (externalReady === false && externalStatus) loadingText = externalStatus
     } catch {}
     let errors = 0
     try { errors = window.__sootsimConsole?.count?.()?.errors ?? 0 } catch {}
@@ -1062,6 +1073,7 @@ async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
         };
       }
     }
+    if (last.externalError) return status;
     if (options.onProgress && progressIntervalMs > 0 && now >= nextProgressAt) {
       options.onProgress(status);
       do {

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.301 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.303 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {
@@ -83,9 +83,14 @@ async function inspectDescribe(bridge, dumpOpts) {
         const body = escaped.replace(/\\*/g, '.*').replace(/\\?/g, '.')
         return new RegExp('^' + body + '$', 'i')
       }
-      const truncate = (value, max) => {
+      // clipping a describe line is a DISPLAY decision. opts.fullText (set by
+      // \`describe --json\`) keeps the real string, so a bundle-eval stack or a
+      // red-box message reaches the caller whole instead of ending in an
+      // ellipsis nothing downstream can undo.
+      const clipForDisplay = (value, max) => {
         const text = typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim() : ''
-        return text.length > max ? text.slice(0, max - 1).trimEnd() + '\u2026' : text
+        if (opts.fullText || text.length <= max) return text
+        return text.slice(0, max - 1).trimEnd() + '\u2026'
       }
       const formatInspectableTree = async () => {
         if (typeof t.listInspectable !== 'function') return null
@@ -113,10 +118,12 @@ async function inspectDescribe(bridge, dumpOpts) {
           if (role) parts.push('[' + role + ']')
           else if (handlers.length > 0) parts.push('[tap]')
           else parts.push('<' + type + '>')
-          const visibleText = truncate(text, 50)
+          const visibleText = clipForDisplay(text, 50)
           if (visibleText) parts.push(JSON.stringify(visibleText))
           if (testID) parts.push('#' + testID)
-          if (label && label !== text) parts.push('label=' + JSON.stringify(truncate(label, 50)))
+          if (label && label !== text) {
+            parts.push('label=' + JSON.stringify(clipForDisplay(label, 50)))
+          }
           if (!opts.hideXy) {
             const abs = node?.absolute || {}
             const layout = node?.layout || {}
@@ -868,7 +875,11 @@ var WAIT_READY_PROBE = `(async () => {
         const suppressed = external.entryErrors.find((item) => isReal(item) && item.suppressed === true)
         if (suppressed) suppressedEntryError = suppressed.message
       }
-      if (externalReady === false && externalStatus) loadingText = externalStatus
+      // once the app has errored its last status ("injecting sootsim
+      // modules...") is stale \u2014 reporting it makes a dead app read as one that
+      // is still booting.
+      if (externalError) loadingText = ''
+      else if (externalReady === false && externalStatus) loadingText = externalStatus
     } catch {}
     let errors = 0
     try { errors = window.__sootsimConsole?.count?.()?.errors ?? 0 } catch {}
@@ -970,6 +981,7 @@ async function inspectWaitReady(bridge, timeoutMs = 2e4, options = {}) {
         };
       }
     }
+    if (last.externalError) return status;
     if (options.onProgress && progressIntervalMs > 0 && now >= nextProgressAt) {
       options.onProgress(status);
       do {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.301 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.303 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -18044,7 +18044,11 @@ var init_core = __esm({
         const suppressed = external.entryErrors.find((item) => isReal(item) && item.suppressed === true)
         if (suppressed) suppressedEntryError = suppressed.message
       }
-      if (externalReady === false && externalStatus) loadingText = externalStatus
+      // once the app has errored its last status ("injecting sootsim
+      // modules...") is stale \u2014 reporting it makes a dead app read as one that
+      // is still booting.
+      if (externalError) loadingText = ''
+      else if (externalReady === false && externalStatus) loadingText = externalStatus
     } catch {}
     let errors = 0
     try { errors = window.__sootsimConsole?.count?.()?.errors ?? 0 } catch {}

package/dist-lib/vite.cjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sootsim",
-  "version": "0.1.301",
+  "version": "0.1.303",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",
@@ -189,7 +189,7 @@
     "esbuild": "^0.25.0",
     "sootsim-engine": "workspace:*",
     "typescript": "^5.7.0",
-    "vite": "^8.0.14",
+    "vite": "^8.2.2",
     "yaml": "^2.8.3"
   }
 }

package/skills/sootsim-debug/SKILL.md

@@ -63,6 +63,12 @@ regression test. a pile of ad-hoc logs helps no one and gets deleted.
   query against it.
 - **pin a sim once.** if more than one is live, an unpinned command
   refuses to choose. run `sootsim use <id>` at the start of the workflow.
+- **keep one sim and reuse its browser tab.** before `sootsim open`, run
+  `sootsim list --all`. if the target is already connected, pin it and use
+  `sootsim do reload`; do not open another tab to reload or retry a capture.
+  re-run `list --all` after each reload or reconnect; when another entry appears,
+  run `sootsim close --others` against the pinned sim immediately.
+  if the current sim must be replaced, close it before opening the replacement.
 - **`debug eval` is an escape hatch.** if a top-level command feels
   broken or missing, file an issue — every agent after you benefits from
   a better CLI, not a pile of ad-hoc scripts.

package/skills/sootsim-setup/SKILL.md

@@ -23,6 +23,32 @@ debugging or `/sootsim-test` for writing tests.
 - **an empty `sootsim list` is not "broken sootsim"** — it usually means the
   daemon is down, the dev server port is wrong, or the runtime is missing.
   walk the recovery checklist before reinstalling.
+- **one sim per investigation. `--new` is an escape hatch, not the normal
+  invocation.** plain `sootsim open <port>` loads the target into the sim you
+  already have, `sootsim reload` reloads it in place, and `sootsim close`
+  disposes it when you are done. reach for `--new` only when the current sim is
+  held by another CLI, and close it afterwards. passing `--new` on every command
+  leaves a trail of abandoned browser tabs on whatever machine you are running
+  on, which is somebody's actual desktop.
+- **sharing a machine with other agents? open ONE sim with `--new`, pin it, and
+  pass `--sim <id>` from then on.** this is the case `--new` exists for. an
+  unpinned command has no sim of its own, so it falls back to whatever sim is
+  currently PRIMARY — and that can be another agent's live sim, mid-run. a plain
+  `sootsim open <port>` from an unpinned CLI will happily retarget somebody
+  else's sim to your port and take over their session; the warning it prints is
+  easy to miss in a transcript. the current-sim pin is stored per CLI identity
+  (`sootsim-current-sim-<identity>.json`, keyed by your process-tree root), so
+  pinning is genuinely per-agent and does not fight anyone else:
+
+  ```sh
+  sootsim open --new 8086          # your own sim; also records it as yours
+  sootsim list                     # read back its id
+  sootsim use <id>                 # pin it explicitly
+  sootsim describe --sim <id>      # name it on every command after that
+  ```
+
+  still close it when you are done. the reason not to pass `--new` on every
+  command is unchanged: each one spawns another browser tree.
 - **never retry-loop `sootsim open` against a wedged or slow stack.** a
   connect-timeout ("timed out waiting for opened sim to connect") means STOP and
   diagnose — not retry. each retried open spawns a new browser tree (a

package/src/attached-projects.ts

@@ -10,7 +10,7 @@
 import { randomBytes, createHash } from 'node:crypto'
 import fs from 'node:fs'
 import path from 'node:path'
-import { electronUserDataDir } from './home-paths'
+import { electronUserDataDir } from './home-paths.ts'
 
 // plan → attached-projects-and-agents.md §data model
 export interface AttachedProject {
@@ -510,7 +510,7 @@ export async function seedFromDemoAppRegistry(): Promise<void> {
   // optional internal-only registry — resolves to [] on a published install
   // (the registry is not shipped), so this seed is a no-op for real users and
   // never pins their ports to internal demo apps.
-  const { loadOptionalDemoApps } = await import('../scripts/optional-demo-registry')
+  const { loadOptionalDemoApps } = await import('../scripts/optional-demo-registry.ts')
   const apps = await loadOptionalDemoApps()
   if (apps.length === 0) return
   mutateStore((store) => {

package/src/host/bridge-host.ts

@@ -44,9 +44,9 @@ import {
   handleFetchProxyRequest,
   isAppApiRequestUrl,
   isFetchProxyRequestUrl,
-} from './fetch-proxy-handler'
+} from './fetch-proxy-handler.ts'
 import { openUrl as openUrlInBrowser, type OpenUrlOptions } from './open-url.ts'
-import { handleWebSocketProxyUpgrade } from './websocket-proxy'
+import { handleWebSocketProxyUpgrade } from './websocket-proxy.ts'
 
 const SOOTSIM_CROSS_ORIGIN_EMBEDDER_POLICY = 'require-corp'
 

package/src/runtime-assets.ts

@@ -6,7 +6,7 @@ import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
 import { isValidRuntimeVersion } from '@contrast/runtime-delivery'
-import { readActiveRuntime, runtimeDir } from './home-paths'
+import { readActiveRuntime, runtimeDir } from './home-paths.ts'
 
 export const SOOTSIM_RUNTIME_MISSING_MESSAGE =
   '[sootsim] no engine runtime installed — run `sootsim setup`, or `sootsim runtime install`'

package/src/runtime-delivery.ts

@@ -19,7 +19,7 @@ import {
   runtimeDir,
   runtimesDir,
   writeActiveRuntime,
-} from './home-paths'
+} from './home-paths.ts'
 
 export const DEFAULT_RUNTIME_CDN_ORIGIN = 'https://contrast.dev'
 

package/src/vite-plugin.ts

@@ -661,7 +661,7 @@ export function reanimatedNativeSeamRedirect(): Plugin {
 // the reanimated plugin above stays separate because it has package-specific
 // edge cases (fabricUtils, validate-worklets-version). new migrations should
 // use the manifest path unless they need similar special handling.
-import { NATIVE_SEAM_MANIFEST } from './native-seam-manifest'
+import { NATIVE_SEAM_MANIFEST } from './native-seam-manifest.ts'
 export function manifestNativeSeamRedirect(): Plugin {
   // build a fast lookup: pkg → { basenames, target }
   const byPkg = new Map<