@cats-inc/cats-platform 0.1.10 → 0.2.8

package/.env.example

@@ -29,12 +29,8 @@ CATS_PLATFORM_STARTUP_TRACE=false
 # Advanced desktop escape hatch. Uncomment to force quit-on-close even if the
 # in-app system tray preference is enabled.
 # CATS_DESKTOP_FORCE_QUIT_ON_CLOSE=true
-# Advanced desktop escape hatch. Set false to force packaged startup audits to
-# collect readiness checks serially instead of in parallel.
-CATS_DESKTOP_SETUP_AUDIT_PARALLEL=true
-# Desktop first-run onboarding policy. Default setup_status shows the packaged
-# CLI installer page before /setup when setup is not complete, without blocking
-# on CLI inventory. Use cli_inventory_gate to restore the zero-CLI gate.
+# Desktop first run selects providers before running selected setup checks.
+# A saved empty selection permits continuing without installing a CLI.
 CATS_DESKTOP_BOOTSTRAP_ONBOARDING_MODE=setup_status
 # Mobile pairing is on by default. Set to false to hide Settings > Desktop >
 # Mobile pairing entirely and short-circuit `/api/mobile/*`. For same-LAN
@@ -63,8 +59,9 @@ CATS_AUTH_ENABLED=
 # Cats generates and persists a user-local 256-bit secret when this is empty.
 # Set an explicit value for clustered or ephemeral deployments; it always wins.
 CATS_AUTH_SESSION_SECRET=
-# Browser and Cats Mobile session TTLs in milliseconds.
-CATS_AUTH_SESSION_TTL_MS=
+# Browser and Cats Mobile session TTLs in milliseconds. Browser sessions
+# default to 30 days; this explicit example keeps copied env files aligned.
+CATS_AUTH_SESSION_TTL_MS=2592000000
 CATS_AUTH_MOBILE_SESSION_TTL_MS=
 # Local/Google login throttling. Keep these non-empty only when tuning tests or
 # deployments with unusual LAN threat models.
@@ -104,15 +101,11 @@ CATS_RUNTIME_SESSION_CREATE_TIMEOUT_MS=
 CATS_RUNTIME_SESSION_CREATE_SLOW_WARNING_MS=
 # Idle timeout (ms) for an in-flight runtime stream/turn. Default 120000.
 CATS_RUNTIME_MESSAGE_IDLE_TIMEOUT_MS=
-# Legacy compound setup timeout (ms). When set, becomes the fallback for both
-# CATS_RUNTIME_SETUP_SCAN_PROXY_TIMEOUT_MS and
-# CATS_RUNTIME_SETUP_APPLY_PROXY_TIMEOUT_MS below; explicit per-step values
-# still win. Leave blank for the explicit defaults.
+# Proxy budget (ms) for setup selection writes/reloads and /setup-scan.
+# Default 30000. A scan is started, not awaited -- the runtime answers 202 and
+# progress is read from /setup-state -- so this bounds a wedged runtime, not the
+# length of a provider scan.
 CATS_RUNTIME_SETUP_PROXY_TIMEOUT_MS=
-# Setup wizard proxy scan budget (ms). Default 120000.
-CATS_RUNTIME_SETUP_SCAN_PROXY_TIMEOUT_MS=
-# Setup wizard proxy apply budget (ms). Default 30000.
-CATS_RUNTIME_SETUP_APPLY_PROXY_TIMEOUT_MS=
 
 # Optional override for the provider capability bootstrap YAML path
 # (ADR-082 / PLAN-080). Defaults to

package/README.md

@@ -5,6 +5,19 @@
 
 ## Overview
 
+Official utility Apps (2026-09-10): **Usage** (`cats.usage`) is built in `cats-apps`
+and loaded through this repo's verified renderer host and App SDK v1. Desktop
+packaging accepts `--apps-lock` for exact App versions and SHA-256 hashes; no App
+source checkout is needed. The 0.2.5 preview selection pins published Usage 0.2.0 for
+automatic offline installation on first launch. See the [build/install guide](./docs/app-packages.md).
+SDK 1.2 (2026-09-11) supports explicit native
+Codex/Copilot/Claude/Antigravity quota queries and native quantities through the
+permission-checked Runtime bridge. Usage 0.2.0 passed built-package browser checks;
+the coordinated Desktop 0.2.5 preview selects its published version/hash and the
+merged Runtime quota/skill-root revision. Existing 0.2.4 / Usage 0.1.1 installers
+and the user's installed Desktop are not modified by preparing this release.
+Remote catalog/independent updates and scheduled account polling remain deferred.
+
 This standalone repo hosts the platform host, packaged as `@cats-inc/cats-platform`
 (extracted from the original monorepo in 2026-07 with full history).
 It talks to `cats-runtime` as its execution boundary and keeps its application
@@ -76,6 +89,11 @@ The current slices are:
 
 ## Current Status
 
+- [x] Save Runtime-owned provider selection before Desktop inventory and helpers;
+      scope product provider/model choices by exact target and config revision.
+      Explicit empty selection supports idle mode. Native installer acceptance
+      remains tracked in the shared [bootstrap rollout plan](../cats-runtime/docs/plans/PLAN-039-provider-selection-bootstrap-rollout.md).
+
 - [x] Bootstrap `cats-platform/` from `project-bootstrap`
 - [x] Establish `cats-runtime` as the only runtime boundary
 - [x] Add a minimal Node/TypeScript HTTP entrypoint and smoke tests

package/build/desktop/bootstrapNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrapNavigation.d.ts","sourceRoot":"","sources":["../../desktop/host/bootstrapNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,KAAK,WAAW,GAAG,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,KAAK,GAAG,eAAe,CAAC,CAAC;AAyBrF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,GACA,MAAM,GAAG,IAAI,CA4Bf;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAEV;AAED,wBAAgB,2CAA2C,CAAC,OAAO,EAAE;IACnE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAEV;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE;IACP,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GACA,OAAO,CAST;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,WAAW,GAAG,IAAI,EAC5B,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GACA,MAAM,GAAG,IAAI,CASf"}
+{"version":3,"file":"bootstrapNavigation.d.ts","sourceRoot":"","sources":["../../desktop/host/bootstrapNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,KAAK,WAAW,GAAG,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,KAAK,GAAG,eAAe,CAAC,CAAC;AAmBrF,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,GACA,MAAM,GAAG,IAAI,CAyBf;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAEV;AAED,wBAAgB,2CAA2C,CAAC,OAAO,EAAE;IACnE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAEV;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE;IACP,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;CAChC,GACA,OAAO,CAST;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,WAAW,GAAG,IAAI,EAC5B,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GACA,MAAM,GAAG,IAAI,CASf"}

package/build/desktop/bootstrapNavigation.js

@@ -1,10 +1,6 @@
-function isCliMissing(snapshot) {
-    return Boolean(snapshot.phase === 'needs_prerequisites'
-        && snapshot.app.onboardingMode === 'cli_inventory_gate'
-        && snapshot.prerequisites
-        && snapshot.prerequisites.cliInventory
-        && snapshot.prerequisites.cliInventory.source === 'runtime'
-        && snapshot.prerequisites.cliInventory.total === 0);
+function isSelectionRequired(snapshot) {
+    const selection = snapshot.prerequisites?.providerSelection;
+    return selection?.state === 'missing' || selection?.state === 'invalid';
 }
 function isSetupComplete(snapshot) {
     return Boolean(snapshot.app.setupCompleted || snapshot.app.setupCompleteAt);
@@ -12,7 +8,7 @@ function isSetupComplete(snapshot) {
 function shouldShowSetupStatusOnboarding(snapshot) {
     return Boolean(snapshot.phase === 'ready_for_setup'
         && snapshot.app.onboardingMode === 'setup_status'
-        && !isSetupComplete(snapshot));
+        && (!isSetupComplete(snapshot) || isSelectionRequired(snapshot)));
 }
 export function resolveDesktopBootstrapNavigation(snapshot, options) {
     if (!options.showWindowOnStartup) {
@@ -27,10 +23,7 @@ export function resolveDesktopBootstrapNavigation(snapshot, options) {
     if (snapshot.phase === 'ready_for_chat') {
         return `${options.appBaseUrl}${snapshot.app.entryPath}`;
     }
-    // CLI missing is a hard gate: stay on bootstrap page regardless of
-    // setupCompleteAt so the user lands on the install UI instead of an
-    // empty-shell chat (or, post-setup, on a chat that can't reach any CLI).
-    if (snapshot.phase === 'needs_prerequisites' && isCliMissing(snapshot)) {
+    if (isSelectionRequired(snapshot)) {
         return null;
     }
     if (snapshot.phase === 'needs_prerequisites' && isSetupComplete(snapshot)) {
@@ -51,7 +44,7 @@ export function shouldRevealDesktopBootstrapRecovery(snapshot, options) {
     return snapshot.phase === 'failed'
         || shouldShowSetupStatusOnboarding(snapshot)
         || (snapshot.phase === 'needs_prerequisites'
-            && (!isSetupComplete(snapshot) || isCliMissing(snapshot)));
+            && (!isSetupComplete(snapshot) || isSelectionRequired(snapshot)));
 }
 export function resolveDesktopWindowRevealNavigation(snapshot, options) {
     if (!options.bootstrapPageVisible || !snapshot) {

package/build/desktop/bootstrapNavigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrapNavigation.js","sourceRoot":"","sources":["../../desktop/host/bootstrapNavigation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrapNavigation.js","sourceRoot":"","sources":["../../desktop/host/bootstrapNavigation.ts"],"names":[],"mappings":"AAIA,SAAS,mBAAmB,CAAC,QAAqB;IAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC5D,OAAO,SAAS,EAAE,KAAK,KAAK,SAAS,IAAI,SAAS,EAAE,KAAK,KAAK,SAAS,CAAC;AAC1E,CAAC;AAED,SAAS,eAAe,CAAC,QAAqB;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,+BAA+B,CAAC,QAAqB;IAC5D,OAAO,OAAO,CACZ,QAAQ,CAAC,KAAK,KAAK,iBAAiB;WAC/B,QAAQ,CAAC,GAAG,CAAC,cAAc,KAAK,cAAc;WAC9C,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,QAAqB,EACrB,OAGC;IAED,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,iBAAiB,EAAE,CAAC;QACzC,IAAI,+BAA+B,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,UAAU,QAAQ,CAAC;IACvC,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,gBAAgB,EAAE,CAAC;QACxC,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,KAAK,qBAAqB,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1E,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAG9C;IACC,OAAO,OAAO,CAAC,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,2CAA2C,CAAC,OAG3D;IACC,OAAO,OAAO,CAAC,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAAqB,EACrB,OAGC;IAED,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;WAC7B,+BAA+B,CAAC,QAAQ,CAAC;WACzC,CAAC,QAAQ,CAAC,KAAK,KAAK,qBAAqB;eACvC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAA4B,EAC5B,OAGC;IAED,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,iCAAiC,CAAC,QAAQ,EAAE;QACjD,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/build/desktop/bootstrapPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrapPage.d.ts","sourceRoot":"","sources":["../../desktop/host/bootstrapPage.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,IAAI,MAAM,CAmsFlD"}
+{"version":3,"file":"bootstrapPage.d.ts","sourceRoot":"","sources":["../../desktop/host/bootstrapPage.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,IAAI,MAAM,CA83FlD"}