car-runtime 0.27.0 → 0.29.0

package/index.d.ts

@@ -394,6 +394,24 @@ export class CarRuntime {
    */
   inferTrackedWithRequest(requestJson: string): Promise<string>;
 
+  /**
+   * Generate an image from a text prompt via the daemon's installed Flux/MLX
+   * models. `requestJson` is a JSON-stringified `GenerateImageRequest`
+   * (`{ prompt, model?, width?, height?, steps?, guidance?, seed?,
+   * output_path?, ... }`). Returns `GenerateImageResult` JSON
+   * (`{ image_path, model_used, latency_ms, ... }`). The FFI analogue of the
+   * `image.generate` WS method (car-releases#70).
+   */
+  generateImage(requestJson: string): Promise<string>;
+
+  /**
+   * Generate a video from a text/image prompt via the daemon's installed
+   * LTX/MLX models. `requestJson` is a JSON-stringified `GenerateVideoRequest`;
+   * returns `GenerateVideoResult` JSON. FFI analogue of the `video.generate` WS
+   * method (car-releases#70).
+   */
+  generateVideo(requestJson: string): Promise<string>;
+
   /**
    * Build a runnable workflow from a natural-language goal via the daemon's
    * builder. `requestJson` is `{ goal, existing?, max_attempts? }`; on the
@@ -644,7 +662,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.
@@ -653,11 +679,28 @@ export class CarRuntime {
   /**
    * AgentDNS-style discovery: resolve a natural-language need into ranked
    * CAR-local services, each named under `agentdns://org/category/name`.
-   * Returns `{ services: [{ identifier, name, kind, protocol, score,
-   * similarity }], count }` JSON. `limit` caps results (clamped to [1, 50];
-   * null = default 5).
+   * Providers: declarative agents, observe-only registry services
+   * (`~/.car/registry/`, kind `registry`), MCP connector tools, external
+   * CLIs, A2A peers, and an opt-in remote root. Returns `{ services: [{
+   * identifier, name, kind, protocol, score, similarity }], count }` JSON.
+   * `limit` caps results (clamped to [1, 50]; 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 +875,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
   // -------------------------------------------------------------------------
@@ -839,7 +890,13 @@ export class CarRuntime {
   /** Returns JSON `{domains: [...]}` listing every permission domain CAR knows. */
   permissionDomains(): string;
 
-  /** Returns JSON `{status: "granted"|"denied"|"prompt"|"unsupported", ...}`. */
+  /**
+   * Returns JSON `{ domain, status, target_bundle_id }`. `status` is one of
+   * `granted` | `denied` | `not_determined` | `restricted` | `not_applicable` |
+   * `restart_required` | `signature_changed` | `unknown`. The `calendar` domain
+   * additionally reports a real, non-prompting EventKit query and can return
+   * `write_only` (macOS-14 write-only calendar grant).
+   */
   permissionStatus(domain: string, targetBundleId?: string | null): string;
 
   /** Triggers the OS permission prompt; returns the resulting status. */
@@ -866,8 +923,15 @@ export class CarRuntime {
   calendarList(): string;
 
   /**
-   * Returns JSON array of events in the [start, end] window. Times are
-   * RFC3339; `calendarIdsCsv` is an optional comma-separated filter.
+   * Returns JSON for events in the [start, end] window. Times are RFC3339;
+   * `calendarIdsCsv` is an optional comma-separated filter.
+   *
+   * Each event carries `status` (`confirmed`|`tentative`|`canceled`|`none`,
+   * from `EKEvent.status`) and `attendees` as objects (not bare names):
+   * `{ name?, email?, status?, role?, is_current_user }` where `status` is
+   * `accepted`|`declined`|`tentative`|`pending`|… (`EKParticipant.participantStatus`)
+   * and `role` is `required`|`optional`|`chair`|`non_participant`|`unknown` — so a
+   * consumer can tell a firm commitment from a tentative RSVP.
    */
   calendarEvents(
     startRfc3339: string,
@@ -878,7 +942,9 @@ export class CarRuntime {
   /**
    * Create a calendar event. `inputJson` is JSON-encoded
    * `{ calendar_id, title, start, end, all_day?, notes?, location?, url? }`
-   * with RFC3339 timestamps. Returns JSON-encoded EventMutationResult.
+   * with RFC3339 timestamps. Returns JSON-encoded EventMutationResult; its
+   * embedded `event` carries the same enriched shape as `calendarEvents`
+   * (attendee objects with RSVP status + event `status`).
    */
   calendarCreateEvent(inputJson: string): string;
 
@@ -1513,11 +1579,15 @@ export function getMeeting(
  *   "dashboard_url": "http://127.0.0.1:8731",
  *   "status": "running",
  *   "display_name": "Trader (paper)",
+ *   "capability": "places stock trades through Alpaca",
  *   "port": 8731,
  *   "pid": 12345
  * }
  * ```
  * `name` and `dashboard_url` are required; the rest are optional.
+ * `capability` is a natural-language description that lets
+ * `discoveryResolve` rank this service against a need — without it the
+ * service still resolves but ranks on its label alone.
  * Returns `"null"` on success.
  */
 export function registerAgent(

package/package.json

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