sootsim 0.1.292 → 0.1.294

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.292 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.294 | (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,9 +1,14 @@
 {
   "name": "sootsim",
-  "version": "0.1.292",
+  "version": "0.1.294",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sootbean/soot.git",
+    "directory": "packages/sootsim"
+  },
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -163,6 +168,7 @@
     "preuninstall": "node ./scripts/preuninstall.cjs"
   },
   "dependencies": {
+    "@expo/plist": "^0.5.4",
     "ws": "^8.18.0"
   },
   "peerDependencies": {

package/scripts/dev-server-scanner.ts

@@ -17,10 +17,15 @@ import { exec } from 'child_process'
 import http from 'http'
 import net from 'net'
 import { promisify } from 'util'
+import type { AppSettingsSpecifier } from '@sootsim/globals'
 
 const execP = promisify(exec)
 import { applySootSimConfigToUrl } from '../src/config.ts'
 import { normalizeNativeDevBundleUrl } from '../src/native-dev-bundle-url.ts'
+import {
+  __resetAppSettingsBundleCacheForTests,
+  readAppSettingsBundle,
+} from '../src/settings-bundle.ts'
 import { loadOptionalDemoApps, optionalDemoAppsSync } from './optional-demo-registry.ts'
 
 // pre-warm the optional internal demo registry once at module load. in-repo
@@ -41,6 +46,8 @@ export interface DiscoveredServer {
   iconUrl?: string
   iconPath?: string
   bundleId?: string
+  settingsBundle?: readonly AppSettingsSpecifier[]
+  settingsStorageScopeUrl?: string
   patched?: boolean
   /** absolute cwd of the owning node/bun process — resolved from `lsof -d cwd`
    *  when the scanner can see the pid. used to auto-attach the project for
@@ -709,8 +716,25 @@ export function __resetScannerCache() {
   knownOne.clear()
   enrichmentCache.clear()
   enrichmentInFlight.clear()
+  __resetAppSettingsBundleCacheForTests()
 }
 
+async function attachAppSettingsBundle(
+  result: DiscoveredServer,
+  projectRoot: string,
+): Promise<void> {
+  const settingsBundle = await readAppSettingsBundle(projectRoot)
+  if (settingsBundle) {
+    result.settingsBundle = settingsBundle
+    result.settingsStorageScopeUrl = result.bundleUrl
+  } else {
+    delete result.settingsBundle
+    delete result.settingsStorageScopeUrl
+  }
+}
+
+export const __attachAppSettingsBundleForTests = attachAppSettingsBundle
+
 export async function scanDevServers(
   opts: ScanOptions = {},
 ): Promise<DiscoveredServer[]> {
@@ -796,7 +820,9 @@ export async function scanDevServers(
       if (!pid) return
       result.pid = pid
       const cwd = await resolveProcessCwd(pid)
-      if (cwd) result.cwd = cwd
+      if (!cwd) return
+      result.cwd = cwd
+      await attachAppSettingsBundle(result, cwd)
     }),
   )
   // evict stale cwd cache entries for pids no longer listening

package/scripts/postinstall.cjs

@@ -42,13 +42,22 @@ if (existingActiveRuntime) {
   process.exit(0)
 }
 
+const RUNTIME_INSTALL_TIMEOUT_MS = 60_000
+
 const bin = path.join(__dirname, '..', 'dist-cli', 'bin.js')
 const res = spawnSync(process.execPath, [bin, 'runtime', 'install'], {
   stdio: 'inherit',
-  timeout: 60_000,
+  timeout: RUNTIME_INSTALL_TIMEOUT_MS,
 })
 
-if (res.status !== 0) {
+if (res.error && res.error.code === 'ETIMEDOUT') {
+  // the runtime tarball is ~48MB; on a slow link it does not finish inside the
+  // npm-install budget above. say that plainly instead of implying we chose to
+  // defer — the user has to run the install themselves for it to complete.
+  console.log(
+    `sootsim: runtime download did not finish within ${RUNTIME_INSTALL_TIMEOUT_MS / 1000}s, so npm install could return — run \`sootsim upgrade\` to finish it`,
+  )
+} else if (res.status !== 0) {
   console.log('sootsim: runtime install deferred to first run')
 }
 process.exit(0)

package/skills/contrast/SKILL.md

@@ -25,6 +25,7 @@ automation, inspecting the render tree, and managing sims.
 | `sootsim record` | capture the live sim as webm/mp4/gif, or sample N png frames (--frames) |
 | `sootsim film` | record a flow on the flat canvas, replay it on the 3d device stage under a camera cinematic, save a clip |
 | `sootsim storage` | manage guest app storage and launch profiles |
+| `sootsim permissions` | inspect and change simulated operating-system permissions |
 | `sootsim perf` | CPU, React render, shell frame, and scroll-layer profiling |
 | `sootsim describe` | curated human-readable UI summary (default inspection tool) |
 | `sootsim find` | locate nodes by text / testID / role / type / predicate |

package/src/agent-identity.ts

@@ -12,8 +12,8 @@ export function agentSessionIdFromCliIdentity(identity: string | null): string |
 export function teamMachineSessionIdFromCliIdentity(
   identity: string | null,
 ): string | null {
-  if (!identity?.startsWith('AGENTBUS_SESSION:')) return null
-  const sessionId = identity.slice('AGENTBUS_SESSION:'.length).trim()
+  if (!identity?.startsWith('TM_SESSION:')) return null
+  const sessionId = identity.slice('TM_SESSION:'.length).trim()
   if (!TEAM_MACHINE_SESSION_RE.test(sessionId)) return null
   return sessionId
 }

package/src/menu.ts

@@ -7,6 +7,26 @@ export const SOOTSIM_SHELL_COMMAND_NAME = 'sootsim:shell-command'
 export type SootSimMenuPlatform = 'browser' | 'electron'
 export type SootSimScaleMode = 'physical' | 'point' | 'pixel' | 'fit'
 
+// ambient glow strength. one setting with three states rather than an on/off
+// pair plus a separate strength: every host that carries the preference (the
+// menus, the persisted setting, the ?ambientGlow= boot seed, the live
+// set-ambient-glow push, electron's shared config) then carries exactly one
+// value and cannot end up half-configured.
+export type SootSimAmbientGlowLevel = 'off' | 'soft' | 'full'
+export const SOOTSIM_AMBIENT_GLOW_LEVELS = ['off', 'soft', 'full'] as const
+
+export function isSootSimAmbientGlowLevel(
+  value: unknown,
+): value is SootSimAmbientGlowLevel {
+  return value === 'off' || value === 'soft' || value === 'full'
+}
+
+export const SOOTSIM_AMBIENT_GLOW_LABELS: Record<SootSimAmbientGlowLevel, string> = {
+  off: 'Off',
+  soft: 'Soft',
+  full: 'Full',
+}
+
 export type SootSimMenuItemDef =
   | { type: 'separator' }
   | {
@@ -35,8 +55,10 @@ export type SootSimMenuDef = {
 export interface SootSimMenuState {
   currentDevice: string
   showBezels: boolean
-  showTopBar: boolean
+  showMenuBar: boolean
   showRail: boolean
+  solidWindow: boolean
+  ambientGlow: SootSimAmbientGlowLevel
   screenshotMode: boolean
   threeMode: boolean
   inspectMode: boolean
@@ -73,6 +95,7 @@ export interface SootSimShortcutDocSection {
 export type MenuItemDef = SootSimMenuItemDef
 export type MenuDef = SootSimMenuDef
 export type MenuState = SootSimMenuState
+export type AmbientGlowLevel = SootSimAmbientGlowLevel
 export type ShortcutPlatform = SootSimMenuPlatform
 export type MenuShortcutEntry = SootSimMenuShortcutEntry
 export type ShortcutDocEntry = SootSimShortcutDocEntry
@@ -108,6 +131,36 @@ function appMenu(): SootSimMenuDef {
         shortcutLabel: 'settings',
         showInShortcutDocs: true,
       },
+      {
+        label: 'Settings Pages',
+        items: [
+          {
+            label: 'Accessibility',
+            action: 'open-settings-page',
+            actionPayload: 'accessibility',
+          },
+          {
+            label: 'Display & Text Size',
+            action: 'open-settings-page',
+            actionPayload: 'display-and-text-size',
+          },
+          {
+            label: 'Notifications',
+            action: 'open-settings-page',
+            actionPayload: 'notifications',
+          },
+          {
+            label: 'Apps',
+            action: 'open-settings-page',
+            actionPayload: 'apps',
+          },
+          {
+            label: 'Privacy & Security',
+            action: 'open-settings-page',
+            actionPayload: 'privacy',
+          },
+        ],
+      },
       { type: 'separator' },
       {
         label: 'Hide SootSim',
@@ -336,10 +389,11 @@ function windowMenu(state: SootSimMenuState): SootSimMenuDef {
         action: 'toggle-bezels',
       },
       {
-        label: 'Show Top Bar',
+        label: 'Show Menu Bar',
         type: 'checkbox',
-        checked: state.showTopBar,
-        action: 'toggle-topbar',
+        checked: state.showMenuBar,
+        action: 'toggle-menubar',
+        hiddenIn: 'electron',
       },
       {
         label: 'Show Rail',
@@ -348,6 +402,31 @@ function windowMenu(state: SootSimMenuState): SootSimMenuDef {
         action: 'toggle-rail',
         hiddenIn: 'electron',
       },
+      {
+        // desktop only. the device window is frameless and transparent, which
+        // is right for a phone floating on the desktop and wrong for the
+        // full-window modes; this pins the solid style on all the time. 3d
+        // mode switches to it on its own either way.
+        label: 'Solid Window',
+        type: 'checkbox',
+        checked: state.solidWindow,
+        action: 'toggle-solid-window',
+        hiddenIn: 'browser',
+      },
+      {
+        // browser only: the wash needs several glow radii of stage around the
+        // device to fade out in, and electron's transparent window is sized to
+        // the device, so there it can only paint a clipped rectangle.
+        label: 'Ambient Glow',
+        hiddenIn: 'electron',
+        items: SOOTSIM_AMBIENT_GLOW_LEVELS.map((level) => ({
+          label: SOOTSIM_AMBIENT_GLOW_LABELS[level],
+          type: 'radio' as const,
+          checked: state.ambientGlow === level,
+          action: 'set-ambient-glow',
+          actionPayload: level,
+        })),
+      },
       {
         label: 'Screenshot',
         type: 'checkbox',