sootsim 0.1.121 → 0.1.122

package/dist-cli/chunks/{what-happened-GAY54LBV.js → what-happened-JNCZGYUL.js}

@@ -1,5 +1,5 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{B as T,C as A,D as y,O as _,P as b,Q as S}from"./chunk-WHL7FMLG.js";import{c as N,e as F}from"./chunk-NQ4EDJV4.js";import{b as k}from"./chunk-SF6W3FRS.js";import"./chunk-KY6NY6WN.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";function O(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--since"&&e+1<n.length){t.push(e,e+1);let s=n[e+1].trim(),l=/^(\d+(?:\.\d+)?)(ms|s|m)?$/.exec(s);if(l){let r=Number(l[1]),u=l[2]??"ms",v=u==="s"?r*1e3:u==="m"?r*6e4:r;return{since:Date.now()-v,consumed:t}}let i=Number(s);if(Number.isFinite(i)&&i>1e12)return{since:i,consumed:t}}return{consumed:t}}function B(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--kinds"&&e+1<n.length)return t.push(e,e+1),{kinds:n[e+1].split(",").map(s=>s.trim()).filter(Boolean),consumed:t};return{consumed:t}}function D(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--limit"&&e+1<n.length){t.push(e,e+1);let s=Number(n[e+1]);if(Number.isFinite(s)&&s>0)return{limit:s,consumed:t}}return{consumed:t}}function x(n){let t=[],e={label:"initial state",events:[],startedAt:n[0]?.t??null};t.push(e);for(let s of n)if(e.events.push(s),s.kind==="screen"||s.kind==="route"){let l=s.data,i=l?.phase;if(!i||i==="enter"||i==="appear"||i==="active"){let r=l?.name||l?.activeName||l?.path||l?.pathname||s.kind;t.length===1&&e.events.length===1?e.label=`${s.kind}: ${r}`:(e={label:`${s.kind}: ${r}`,events:[],startedAt:s.t},t.push(e))}}return t}async function J(n,t){let e=N(n,{port:t.port,stripBooleanFlags:["--summary","--all","--json","--no-advance","--help","-h","--flow","--noisy"],stripValueFlags:["--since","--kinds","--limit"]});(n.includes("--help")||n.includes("-h"))&&(console.log(`
+/*! sootsim v0.1.122 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{B as T,C as A,D as y,O as _,P as b,Q as S}from"./chunk-RBWDMEWN.js";import{c as N,e as F}from"./chunk-J27RHTWH.js";import{b as k}from"./chunk-366ZIBQX.js";import"./chunk-UQHBJ2L2.js";import"./chunk-T2YYBRII.js";import"./chunk-IBEQOTJK.js";function O(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--since"&&e+1<n.length){t.push(e,e+1);let s=n[e+1].trim(),l=/^(\d+(?:\.\d+)?)(ms|s|m)?$/.exec(s);if(l){let r=Number(l[1]),u=l[2]??"ms",v=u==="s"?r*1e3:u==="m"?r*6e4:r;return{since:Date.now()-v,consumed:t}}let i=Number(s);if(Number.isFinite(i)&&i>1e12)return{since:i,consumed:t}}return{consumed:t}}function B(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--kinds"&&e+1<n.length)return t.push(e,e+1),{kinds:n[e+1].split(",").map(s=>s.trim()).filter(Boolean),consumed:t};return{consumed:t}}function D(n){let t=[];for(let e=0;e<n.length;e++)if(n[e]==="--limit"&&e+1<n.length){t.push(e,e+1);let s=Number(n[e+1]);if(Number.isFinite(s)&&s>0)return{limit:s,consumed:t}}return{consumed:t}}function x(n){let t=[],e={label:"initial state",events:[],startedAt:n[0]?.t??null};t.push(e);for(let s of n)if(e.events.push(s),s.kind==="screen"||s.kind==="route"){let l=s.data,i=l?.phase;if(!i||i==="enter"||i==="appear"||i==="active"){let r=l?.name||l?.activeName||l?.path||l?.pathname||s.kind;t.length===1&&e.events.length===1?e.label=`${s.kind}: ${r}`:(e={label:`${s.kind}: ${r}`,events:[],startedAt:s.t},t.push(e))}}return t}async function J(n,t){let e=N(n,{port:t.port,stripBooleanFlags:["--summary","--all","--json","--no-advance","--help","-h","--flow","--noisy"],stripValueFlags:["--since","--kinds","--limit"]});(n.includes("--help")||n.includes("-h"))&&(console.log(`
 sootsim what-happened \u2014 show recent events from the semantic timeline
 
 usage:

package/dist-cli/chunks/{whoami-C2WULTLS.js → whoami-HYV4EQ5D.js}

@@ -1,2 +1,2 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{d as i}from"./chunk-OEV7EOMC.js";import{d as n}from"./chunk-SA5RP334.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";async function u(){let o=i();if(o||(console.log("  not signed in"),console.log("  set SOOTSIM_API_KEY=sk_sootsim_\u2026 or run `sootsim login`"),process.exit(1)),o.kind==="api-key"){let r=`${o.secret.slice(0,14)}\u2026`,t=o.source==="env"?"SOOTSIM_API_KEY env var":"saved key (~/.config/sootsim/credentials.json)";console.log(`  api key ${r}`),console.log(`  source: ${t}`);return}if(o.kind==="github"){console.log(`  github token (${o.source})`),console.log(`  repo: ${o.repoId}`);return}let e=await n(),s=e?.user;console.log(`  ${s?.email||s?.name||s?.id||"signed in"}`),console.log(`  origin: ${e?.origin??o.origin}`),e?.updatedAt&&console.log(`  updated: ${e.updatedAt}`)}export{u as runWhoami};
+/*! sootsim v0.1.122 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+import{d as i}from"./chunk-7AXDJ2RV.js";import{d as n}from"./chunk-VHPYIZ3U.js";import"./chunk-T2YYBRII.js";import"./chunk-IBEQOTJK.js";async function u(){let o=i();if(o||(console.log("  not signed in"),console.log("  set SOOTSIM_API_KEY=sk_sootsim_\u2026 or run `sootsim login`"),process.exit(1)),o.kind==="api-key"){let r=`${o.secret.slice(0,14)}\u2026`,t=o.source==="env"?"SOOTSIM_API_KEY env var":"saved key (~/.config/sootsim/credentials.json)";console.log(`  api key ${r}`),console.log(`  source: ${t}`);return}if(o.kind==="github"){console.log(`  github token (${o.source})`),console.log(`  repo: ${o.repoId}`);return}let e=await n(),s=e?.user;console.log(`  ${s?.email||s?.name||s?.id||"signed in"}`),console.log(`  origin: ${e?.origin??o.origin}`),e?.updatedAt&&console.log(`  updated: ${e.updatedAt}`)}export{u as runWhoami};

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

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/beta.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/beta.mjs

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

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/config.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/metro.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/demo-app-registry.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.122 | (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.121",
+  "version": "0.1.122",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",

package/src/runtime-delivery.ts

@@ -34,6 +34,51 @@ export interface RuntimeManifest {
   versions: Record<string, RuntimeManifestVersion>
 }
 
+// --- release notes (the sootsim changelog) ----------------------------------
+// written by scripts/changelog/generate.ts (product: sootsim), stored at
+// changelog/sootsim.json in R2 and served at /api/changelog/sootsim. this is
+// the changelog history, kept separate from the install manifest (which pruning
+// trims to a single version). consumed read-only here + on the website.
+
+export interface RuntimeReleaseNoteItem {
+  /** LLM-condensed proper-case one-liner. */
+  summary: string
+  scope?: string
+  hash: string
+  breaking?: boolean
+}
+
+export interface RuntimeReleaseSection {
+  kind: 'breaking' | 'features' | 'fixes' | 'performance' | 'other'
+  title: string
+  items: RuntimeReleaseNoteItem[]
+}
+
+export interface RuntimeReleaseEntry {
+  title: string
+  version: string
+  channel: string
+  commit: string
+  date: string
+  cliVersion?: string
+  sections: RuntimeReleaseSection[]
+  commitCount: number
+}
+
+/** one page of the changelog, as returned by /api/changelog/sootsim. the stored
+ *  R2 file holds the full history; the endpoint paginates it (see
+ *  app/api/changelog/[product]+api.ts), so the CLI drains pages via hasMore. */
+export interface RuntimeReleasesPage {
+  product: string
+  updatedThrough: string | null
+  page: number
+  pageSize: number
+  total: number
+  totalPages: number
+  hasMore: boolean
+  entries: RuntimeReleaseEntry[]
+}
+
 export interface RuntimeInstallOptions {
   version?: string | null
   channel?: string
@@ -111,6 +156,61 @@ export async function fetchRuntimeManifest(cdnOrigin?: string): Promise<RuntimeM
   return (await res.json()) as RuntimeManifest
 }
 
+export function runtimeReleasesUrl(page: number, cdnOrigin?: string): string {
+  const url = new URL(`${resolveRuntimeCdnOrigin(cdnOrigin)}/api/changelog/sootsim`)
+  url.searchParams.set('page', String(page))
+  // bust cdn edge caching so `sootsim runtime notes` always sees the latest.
+  url.searchParams.set('t', String(Date.now()))
+  return url.toString()
+}
+
+async function fetchReleasesPage(
+  page: number,
+  cdnOrigin?: string,
+): Promise<RuntimeReleasesPage> {
+  const url = runtimeReleasesUrl(page, cdnOrigin)
+  const res = await fetch(url, { headers: { Accept: 'application/json' } })
+  // a missing file is a valid state until the first release ships — callers
+  // render "no release notes yet" rather than an error.
+  if (res.status === 404) {
+    return {
+      product: 'sootsim',
+      updatedThrough: null,
+      page,
+      pageSize: 0,
+      total: 0,
+      totalPages: 0,
+      hasMore: false,
+      entries: [],
+    }
+  }
+  if (!res.ok) {
+    throw new Error(`releases fetch failed: ${res.status} ${res.statusText} (${url})`)
+  }
+  return (await res.json()) as RuntimeReleasesPage
+}
+
+/** fetch the full sootsim changelog (newest release first) by draining every
+ *  page of the paginated endpoint. the CLI wants the whole history (notes
+ *  --all, version lookups for any release), so it pages through; the website
+ *  loads one page at a time. throws on network/parse failure so callers can
+ *  surface a clear message. */
+export async function fetchRuntimeReleases(
+  cdnOrigin?: string,
+): Promise<RuntimeReleaseEntry[]> {
+  const entries: RuntimeReleaseEntry[] = []
+  let page = 1
+  // bounded by totalPages from the first response; the guard is a backstop
+  // against a malformed hasMore that never settles.
+  for (let guard = 0; guard < 1000; guard++) {
+    const result = await fetchReleasesPage(page, cdnOrigin)
+    if (Array.isArray(result.entries)) entries.push(...result.entries)
+    if (!result.hasMore || result.entries.length === 0) break
+    page++
+  }
+  return entries
+}
+
 export function resolveRuntimeVersion(
   manifest: RuntimeManifest,
   opts: Pick<RuntimeInstallOptions, 'version' | 'channel'> = {},

package/dist-cli/chunks/auto-bootstrap-IPNK6GF7.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d}from"./chunk-Z47GWZMZ.js";import"./chunk-NQ4EDJV4.js";import"./chunk-SF6W3FRS.js";import"./chunk-KY6NY6WN.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{c as ensureDaemonRunning,a as ensureRuntimeInstalled,d as ensureSootsimReady,b as resolveBootstrapPort};

package/dist-cli/chunks/beta-RG7JT6HD.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d,e}from"./chunk-Y7ZMV3PG.js";import"./chunk-SRA2TVCG.js";export{e as BETA_ASK_HEADLINE,c as BETA_LABEL,d as BETA_TAGLINE,b as BETA_VERSION_TARGET,a as IS_BETA};

package/dist-cli/chunks/chunk-2FTVPI7F.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-var t="http://localhost:5173/";export{t as a};

package/dist-cli/chunks/chunk-BTWXWUDB.js

@@ -1 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */

package/dist-cli/chunks/chunk-KXLYXKMA.js

@@ -1 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */

package/dist-cli/chunks/chunk-QUEATUWT.js

@@ -1 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */

package/dist-cli/chunks/chunk-VJPN6DQU.js

@@ -1,4 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{A as R,C as w,i as p,r as S,t as O,y as v,z as f}from"./chunk-4BXESMZ7.js";import{spawn as I}from"child_process";import C from"crypto";import s from"fs";import l from"path";import{Readable as k}from"stream";import{pipeline as M}from"stream/promises";var N="https://sootbean.com",D="SOOTSIM_CDN_ORIGIN",E="SOOTSIM_RUNTIME_CHANNEL";function $(){try{let e=JSON.parse(s.readFileSync(O(),"utf8"));return e&&typeof e=="object"?e:{}}catch{return{}}}function d(e){let t=$();return(e||process.env[D]||t.cdnOrigin||N).replace(/\/+$/,"")}function x(e){let t=$();return e||process.env[E]||t.runtimeChannel||"stable"}function T(e){let t=new URL(`${d(e)}/runtimes/manifest.json`);return t.searchParams.set("t",String(Date.now())),t.toString()}function P(e,t){return`${d(t)}/runtimes/sootsim-runtime-${e}.tar.gz`}async function y(e){let t=T(e),r=await fetch(t,{headers:{Accept:"application/json"}});if(!r.ok)throw new Error(`manifest fetch failed: ${r.status} ${r.statusText} (${t})`);return await r.json()}function U(e,t={}){let r=x(t.channel),n=t.version||e.channels[r]?.latest;if(!n)throw new Error(`no version specified and channel '${r}' has no latest entry in the manifest`);let i=e.versions[n];if(!i)throw new Error(`version ${n} not found in manifest; available: ${Object.keys(e.versions).slice(-10).join(", ")||"(none)"}`);return{version:n,channel:r,entry:i}}async function V(e={}){v();let t=d(e.cdnOrigin),r=await y(t),{version:n,channel:i,entry:o}=U(r,e),a=p(n),c=e.setActive!==!1;if(!e.force&&s.existsSync(l.join(a,"index.html")))return c&&R(n),{version:n,channel:i,cdnOrigin:t,runtimeDir:a,installed:!1,activated:c,manifest:r};let g=o.tarball||P(n,t),m=l.join(S(),`sootsim-runtime-${n}.tar.gz`);process.stderr.write(`sootsim: downloading runtime ${n}\u2026
-`),await _(g,m),process.stderr.write(`sootsim: extracting runtime ${n}\u2026
-`);let h=await j(m);if(h!==o.sha256)throw s.rmSync(m,{force:!0}),new Error(`sha256 mismatch for runtime ${n}: expected ${o.sha256}, actual ${h}`);let u=l.join(l.dirname(a),`.installing-${n}-${process.pid}`);s.rmSync(u,{recursive:!0,force:!0}),s.mkdirSync(u,{recursive:!0});try{if(await A(m,u),!s.existsSync(l.join(u,"index.html")))throw new Error(`extracted tarball for runtime ${n} is missing index.html`);s.rmSync(a,{recursive:!0,force:!0}),s.renameSync(u,a)}catch(b){throw s.rmSync(u,{recursive:!0,force:!0}),b}return c&&R(n),{version:n,channel:i,cdnOrigin:t,runtimeDir:a,installed:!0,activated:c,manifest:r}}async function q(e={}){v();let t=d(e.cdnOrigin),r=x(e.channel),n=await y(t),i=n.channels[r]?.latest;if(!i)return{checked:!0,updated:!1,reason:`channel '${r}' has no latest runtime`,activeVersion:f()};if(!n.versions[i])return{checked:!0,updated:!1,reason:`manifest is missing version ${i}`,activeVersion:f(),latestVersion:i};let a=f(),c=a?p(a):null,g=c?s.existsSync(l.join(c,"index.html")):!1;if(!(!a||!g||w(i,a)>0))return{checked:!0,updated:!1,reason:"active runtime is current",activeVersion:a,latestVersion:i};let h=await V({version:i,channel:r,cdnOrigin:t,setActive:!1});return{checked:!0,updated:!0,activeVersion:i,latestVersion:i,install:h}}async function B(e={}){let t=f();try{let r=await y(d(e.cdnOrigin)),n=x(e.channel),i=r.channels[n]?.latest??null,o=!!(i&&(!t||w(i,t)>0));return{active:t,latest:i,outdated:o}}catch{return{active:t,latest:null,outdated:!1}}}async function _(e,t){let r=await fetch(e);if(!r.ok||!r.body)throw new Error(`download failed: ${r.status} ${r.statusText} (${e})`);s.mkdirSync(l.dirname(t),{recursive:!0});let n=`${t}.partial`;try{await M(k.fromWeb(r.body),s.createWriteStream(n)),s.renameSync(n,t)}catch(i){try{s.unlinkSync(n)}catch{}throw i}}function j(e){return new Promise((t,r)=>{let n=C.createHash("sha256"),i=s.createReadStream(e);i.on("data",o=>n.update(o)),i.on("error",r),i.on("end",()=>t(n.digest("hex")))})}function A(e,t){return new Promise((r,n)=>{let i=I("tar",["-xzf",e,"-C",t],{stdio:["ignore","inherit","inherit"]});i.on("error",n),i.on("exit",o=>{o===0?r():n(new Error(`tar exited with code ${o}`))})})}export{N as a,D as b,E as c,d,x as e,T as f,P as g,y as h,U as i,V as j,q as k,B as l};

package/dist-cli/chunks/chunk-YQIFU3PB.js

@@ -1,25 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as d}from"./chunk-NQ4EDJV4.js";import{a as p,d as w,h as $,j as y}from"./chunk-VJPN6DQU.js";import{A as g,B as f,i as h,y as m,z as a}from"./chunk-4BXESMZ7.js";import b from"fs";import{WebSocket as D}from"ws";async function P(n,e={}){let[o,...t]=n;if(!o||o==="--help"||o==="-h"){R();return}switch(o){case"install":return O(t,e);case"list":case"ls":return S(t);case"use":return T(t);case"remove":case"rm":return N(t);case"which":case"active":return F();default:console.error(`  unknown runtime subcommand: ${o}`),R(),process.exit(1)}}function R(){console.log(`
-sootsim runtime \u2014 manage engine runtimes under ~/.sootsim/runtimes/
-
-usage:
-  sootsim runtime install [version]   install a version (default: channel latest)
-  sootsim runtime list                show installed + available versions
-  sootsim runtime use <version>       switch active runtime
-  sootsim runtime remove <version>    delete an installed runtime
-  sootsim runtime which               print active runtime version
-
-flags:
-  --channel <name>    channel to resolve 'latest' from (default: stable)
-  --force             reinstall even if the version is already on disk
-  --set-active=false  do not switch active runtime after install
-
-environment:
-  SOOTSIM_CDN_ORIGIN  override the CDN base URL (default: ${p})
-
-examples:
-  sootsim runtime install
-  sootsim runtime install 1.2.3
-  sootsim runtime install --channel beta
-  sootsim runtime use 1.2.3
-`)}async function O(n,e){let{version:o,flags:t}=_(n),s=t.channel??e.channel??"stable",l=t.force===!0,c=t.setActive!==!1;m(),console.log("sootsim runtime install"),console.log(`  cdn:     ${w()}`);try{let i=await y({version:o,channel:s,force:l,setActive:c});console.log(`  version: ${i.version} (channel: ${i.channel})`),i.installed?console.log(`  installed ${i.version}`):console.log(`  already installed at ${i.runtimeDir}`),c&&await k(i.version)}catch(i){console.error(`  ${I(i)}`),process.exit(1)}}async function k(n){g(n),console.log(`  active:  ${n}`),await A(n)||console.log(`  (no daemon running \u2014 next sootsim/electron launch will pick up ${n})`)}async function A(n){let{isDaemonLockfileFresh:e,readDaemonLockfile:o}=await import("./home-paths-P5GMZADH.js"),t=o();if(!e(t))return!1;let s=d();return new Promise(l=>{let c=!1,i=!1,u=x=>{c||(c=!0,l(x))},r=new D(`ws://127.0.0.1:${s}`,{handshakeTimeout:800}),v=setTimeout(()=>{try{r.close()}catch{}u(i)},1500);r.on("open",()=>{try{r.send(JSON.stringify({type:"runtime:use",version:n,id:0})),i=!0}catch{}setTimeout(()=>{try{r.close()}catch{}},100)}),r.on("close",()=>{clearTimeout(v),u(i)}),r.on("error",()=>{clearTimeout(v),u(!1)})})}async function S(n){m();let e=f(),o=a();if(console.log("installed:"),e.length===0)console.log("  (none)");else for(let t of e)console.log(`  ${t===o?"*":" "} ${t}`);try{let t=await $();console.log("available (latest per channel):");for(let[s,l]of Object.entries(t.channels))console.log(`  ${s.padEnd(8)} ${l.latest}`)}catch(t){console.log(`available: (could not fetch manifest: ${I(t)})`)}}async function T(n){let e=n[0];e||(console.error("  usage: sootsim runtime use <version>"),process.exit(1));let o=f();o.includes(e)||(console.error(`  version ${e} is not installed`),console.error(`  installed: ${o.join(", ")||"(none)"}`),console.error(`  run \`sootsim runtime install ${e}\` first`),process.exit(1)),await k(e)}async function N(n){let e=n[0];e||(console.error("  usage: sootsim runtime remove <version>"),process.exit(1)),a()===e&&(console.error(`  cannot remove active runtime ${e}`),console.error("  switch with `sootsim runtime use <other>` first, or install another version"),process.exit(1));let t=h(e);if(!b.existsSync(t)){console.error(`  ${e} is not installed`);return}b.rmSync(t,{recursive:!0,force:!0}),console.log(`  removed ${e}`)}async function F(){let n=a();if(!n){console.log("  no active runtime");return}console.log(n)}function _(n){let e={},o=[];for(let t=0;t<n.length;t++){let s=n[t];if(s==="--channel"&&t+1<n.length){e.channel=n[t+1],t++;continue}if(s.startsWith("--channel=")){e.channel=s.slice(10);continue}if(s==="--force"){e.force=!0;continue}if(s==="--set-active=false"||s==="--no-set-active"){e.setActive=!1;continue}o.push(s)}return{version:o[0]??null,flags:e}}function I(n){return n instanceof Error?n.message:String(n)}export{P as a};

package/dist-cli/chunks/cli-version-DPV7EKFK.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-GU3MWKJY.js";import"./chunk-SRA2TVCG.js";export{a as getCliVersion};

package/dist-cli/chunks/control-IAHPU5HD.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{d as a,e as b,f as c,g as d,h as e,i as f,j as g,k as h,l as i,m as j,n as k,o as l,p as m,q as n,r as o,s as p,t as q,u as r,v as s}from"./chunk-MSU27JEW.js";import"./chunk-RVWJ3TAE.js";import"./chunk-QNQO5VHO.js";import"./chunk-WHL7FMLG.js";import"./chunk-4UQMPWDA.js";import"./chunk-NQ4EDJV4.js";import"./chunk-LT2X5ISU.js";import"./chunk-VALW4SKE.js";import"./chunk-QUEATUWT.js";import"./chunk-3A7SRWSQ.js";import"./chunk-VSRV5LFU.js";import"./chunk-SF6W3FRS.js";import"./chunk-2FTVPI7F.js";import"./chunk-KY6NY6WN.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{e as buildOpenUrl,d as buildShellUrl,q as closeSimsBulk,r as planBulkCloseTargets,i as playwrightHostPidForSim,g as printConnectedSims,b as resolveBundleTarget,c as resolveDefaultShellBaseUrl,a as resolveDriverConnectWaitOptions,p as runClaimCommand,s as runCloseCommand,o as runFocusCommand,l as runListCommand,m as runOpenCommand,n as runUseCommand,j as signalDriverLaunchConnected,f as summarizeSimUrl,k as terminatePlaywrightHostsForSims,h as waitForSimMatch};

package/dist-cli/chunks/drivers-L6UY2JC6.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import"./chunk-BTWXWUDB.js";import{a,b,c,d,e,f,g,h,i}from"./chunk-LT2X5ISU.js";import"./chunk-VALW4SKE.js";import"./chunk-QUEATUWT.js";import"./chunk-3A7SRWSQ.js";import"./chunk-VSRV5LFU.js";import"./chunk-SF6W3FRS.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{e as ALL_DRIVERS,i as buildDriverListRows,a as chromiumDriver,b as electronDriver,f as getAllDrivers,g as getDriver,c as playwrightDriver,h as resolveDriver,d as systemDriver};

package/dist-cli/chunks/flow-QSDMMKNZ.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as c,b as d,c as e,d as f}from"./chunk-KTE2VIXH.js";import"./chunk-VX5CAWLC.js";import"./chunk-KXLYXKMA.js";import"./chunk-MUTDER75.js";import"./chunk-5OA35LZX.js";import"./chunk-OEV7EOMC.js";import{d as a,e as b}from"./chunk-CGB6KRKN.js";import"./chunk-MSU27JEW.js";import"./chunk-RVWJ3TAE.js";import"./chunk-QNQO5VHO.js";import"./chunk-WHL7FMLG.js";import"./chunk-4UQMPWDA.js";import"./chunk-NQ4EDJV4.js";import"./chunk-LT2X5ISU.js";import"./chunk-VALW4SKE.js";import"./chunk-QUEATUWT.js";import"./chunk-3A7SRWSQ.js";import"./chunk-VSRV5LFU.js";import"./chunk-SF6W3FRS.js";import"./chunk-OBYYAT4F.js";import"./chunk-SA5RP334.js";import"./chunk-W3FBNBTX.js";import"./chunk-2FTVPI7F.js";import"./chunk-KY6NY6WN.js";import"./chunk-PMAKUYYK.js";import"./chunk-X4LYRBLZ.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{c as discoverSootsimUrl,e as hoistLeadingSimFlag,a as parseFlowFile,f as runFlow,d as runFlowPlayback,b as validateFlowFile};

package/dist-cli/chunks/help-OC7HYZ5F.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-IQNZPHGD.js";import"./chunk-W3FBNBTX.js";import"./chunk-2U4CGOD6.js";import"./chunk-2FTVPI7F.js";import"./chunk-KY6NY6WN.js";import"./chunk-GU3MWKJY.js";import"./chunk-Y7ZMV3PG.js";import"./chunk-X4LYRBLZ.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{c as printCommandHelp,b as printGroupHelp,a as printHelp};

package/dist-cli/chunks/install-3UWGXX6F.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a as o}from"./chunk-DORQQNP4.js";import"./chunk-I26R4PE2.js";import"./chunk-Z47GWZMZ.js";import"./chunk-NQ4EDJV4.js";import"./chunk-SF6W3FRS.js";import"./chunk-OBYYAT4F.js";import"./chunk-SA5RP334.js";import"./chunk-KY6NY6WN.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";async function t(n){console.error("  note: `sootsim install` is now `sootsim setup-repo`. forwarding\u2026\n"),await o(n)}export{t as runInstall};

package/dist-cli/chunks/runtime-5MJPHLRZ.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-YQIFU3PB.js";import"./chunk-NQ4EDJV4.js";import"./chunk-SF6W3FRS.js";import"./chunk-KY6NY6WN.js";import"./chunk-VJPN6DQU.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{a as runRuntime};

package/dist-cli/chunks/runtime-delivery-NWSDCFAI.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c,d,e,f,g,h,i,j,k,l}from"./chunk-VJPN6DQU.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{a as DEFAULT_RUNTIME_CDN_ORIGIN,b as RUNTIME_CDN_ORIGIN_ENV,c as RUNTIME_CHANNEL_ENV,l as checkRuntimeUpToDate,h as fetchRuntimeManifest,j as installRuntime,d as resolveRuntimeCdnOrigin,e as resolveRuntimeChannel,i as resolveRuntimeVersion,f as runtimeManifestUrl,g as runtimeTarballUrl,k as updateRuntimeToLatest};

package/dist-cli/chunks/setup-repo-OUMNEC36.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-DORQQNP4.js";import"./chunk-I26R4PE2.js";import"./chunk-Z47GWZMZ.js";import"./chunk-NQ4EDJV4.js";import"./chunk-SF6W3FRS.js";import"./chunk-OBYYAT4F.js";import"./chunk-SA5RP334.js";import"./chunk-KY6NY6WN.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{a as runSetupRepo};

package/dist-cli/chunks/store-JVV7G7VY.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a}from"./chunk-PMAKUYYK.js";import"./chunk-X4LYRBLZ.js";import"./chunk-SRA2TVCG.js";export{a as settingsStore};

package/dist-cli/chunks/telemetry-BMJNBZT6.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b}from"./chunk-OBYYAT4F.js";import"./chunk-SA5RP334.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{b as flushCliTelemetry,a as trackCliEvent};

package/dist-cli/chunks/upload-XQLVCUKI.js

@@ -1,2 +0,0 @@
-/*! sootsim v0.1.121 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import{a,b,c}from"./chunk-5OA35LZX.js";import"./chunk-OEV7EOMC.js";import"./chunk-4UQMPWDA.js";import"./chunk-NQ4EDJV4.js";import"./chunk-QUEATUWT.js";import"./chunk-VSRV5LFU.js";import"./chunk-SF6W3FRS.js";import"./chunk-OBYYAT4F.js";import"./chunk-SA5RP334.js";import"./chunk-KY6NY6WN.js";import"./chunk-4BXESMZ7.js";import"./chunk-SRA2TVCG.js";export{a as resolveDefaultUploadOrigin,b as resolvePublicPreviewOrigin,c as runUpload};