car-runtime 0.27.0 → 0.28.0

package/index.d.ts

@@ -644,7 +644,15 @@ export class CarRuntime {
    * invoked }` JSON. `maxSubtasks` caps the split (clamped to [1, 10]; null =
    * default 5). With `invoke: true`, each subtask's chosen agent runs.
    */
-  declagentRouteSplit(need: string, invoke: boolean, maxSubtasks?: number | undefined | null): Promise<string>;
+  declagentRouteSplit(
+    need: string,
+    invoke: boolean,
+    maxSubtasks?: number | undefined | null,
+    decompositionMode?: "vanilla" | "sad" | string | undefined | null,
+    sadHints?: number | undefined | null,
+    sadIterations?: number | undefined | null,
+    sadConvergenceJaccard?: number | undefined | null
+  ): Promise<string>;
   /**
    * Read-only view of the learned routing topology: per-agent success stats
    * and directed agent→agent edge weights. Returns `{ agents, edges }` JSON.
@@ -658,6 +666,21 @@ export class CarRuntime {
    * null = default 5).
    */
   discoveryResolve(need: string, limit?: number | undefined | null): Promise<string>;
+  /**
+   * Compose a decompose/retrieve/plan route over all discoverable services.
+   * Returns `{ plan, decomposition, candidates, metadata }` JSON. Planning only;
+   * callers invoke returned targets through existing governed surfaces.
+   */
+  discoveryRouteCompose(
+    need: string,
+    maxSubtasks?: number | undefined | null,
+    decompositionMode?: "vanilla" | "sad" | string | undefined | null,
+    sadHints?: number | undefined | null,
+    sadIterations?: number | undefined | null,
+    sadConvergenceJaccard?: number | undefined | null,
+    candidatesPerStep?: number | undefined | null,
+    rerank?: boolean
+  ): Promise<string>;
 
   /**
    * Build a concrete onboarding plan (machine summary, top pick, alternatives,
@@ -832,6 +855,14 @@ export class CarRuntime {
   /** Returns JSON `{exists: boolean, key, service}` without exposing the value. */
   secretStatus(key: string, service?: string | null): string;
 
+  /**
+   * List the NAMES of secrets stored through this surface. Returns JSON
+   * `{secrets: [{service, key, exists}]}` — never the values. Backed by the
+   * `~/.car/secret_index.json` name index, joined with a live existence check
+   * (`exists` is `null` if the backend couldn't be probed).
+   */
+  secretList(): string;
+
   // -------------------------------------------------------------------------
   // OS permission preflight
   // -------------------------------------------------------------------------

package/package.json

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