car-runtime 0.19.0 → 0.20.0

package/index.d.ts

@@ -391,6 +391,35 @@ export class CarRuntime {
    */
   registerModel(schemaJson: string): Promise<string>;
 
+  /**
+   * Recommend models for this machine + intent. `useCase`/`tier` are
+   * snake_case enum values (e.g. "coding", "most_capable"); `cloudOk` lets
+   * cloud models compete. Returns the `RecommendationSet` JSON
+   * (`{ picks, notEnoughMemory, note }`).
+   */
+  recommend(useCase: string, tier: string, cloudOk: boolean): Promise<string>;
+
+  /**
+   * Build a concrete onboarding plan (machine summary, top pick, alternatives,
+   * needs-more-memory, note) as JSON.
+   */
+  setupPlan(useCase: string, tier: string, cloudOk: boolean): Promise<string>;
+
+  /** Detect upgrades (curated + upstream, channel-gated). Returns JSON. */
+  detectUpgrades(): Promise<string>;
+
+  /** Current proactive-upgrade decision (poll form). Returns JSON. */
+  checkUpgradeNudge(inferenceActive: boolean): Promise<string>;
+
+  /** Dismiss an upgrade nudge by its `dismissKey` so it never re-fires. */
+  dismissUpgrade(dismissKey: string): Promise<string>;
+
+  /** Get update preferences as JSON. */
+  updatePrefsGet(): Promise<string>;
+
+  /** Set update preferences (JSON `UpdatePreferences` shape). Returns stored prefs JSON. */
+  updatePrefsSet(prefsJson: string): Promise<string>;
+
   /** Route a prompt. Returns the routing decision as JSON. */
   routeModel(prompt: string): Promise<string>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "car-runtime",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Common Agent Runtime — a deterministic execution layer for AI agents",
   "main": "index.js",
   "types": "index.d.ts",