car-runtime 0.28.0 → 0.30.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
@@ -536,6 +554,54 @@ export class CarRuntime {
    */
   registerModel(schemaJson: string): Promise<string>;
 
+  /**
+   * `messaging.config.get` — read the multi-channel approval-transport config
+   * for one channel (enabled flag, allowlisted handles, whether a pairing is
+   * in flight). Host/local-auth gated on the daemon.
+   *
+   * `requestJson` is an optional `{ channel? }` selector — `channel` is
+   * `"imessage"` | `"slack"`, default `"imessage"`. Pass `"{}"` or omit it for
+   * the iMessage (back-compat) channel.
+   *
+   * Returns `MessagingConfigView` JSON. The view always carries a `channel`
+   * key naming which channel it describes (`"imessage"` | `"slack"`).
+   */
+  messagingConfigGet(requestJson?: string): Promise<string>;
+
+  /**
+   * `messaging.config.set` — mutate one channel's approval-transport config.
+   * The ONLY allowlist/config-mutation path; host/local-auth gated.
+   * `requestJson` is a `MessagingConfigSetRequest`
+   * (`{ channel?, enabled?, allowlisted_handles?, add_handles?, remove_handles?,
+   * bot_token?, app_token? }`).
+   * `channel` is `"imessage"` | `"slack"`, default `"imessage"` when absent
+   * (back-compat). For `channel: "slack"`, supplying BOTH `bot_token` (`xoxb-`)
+   * and `app_token` (`xapp-`) provisions them into the OS keychain (MC-9) and
+   * persists only a keychain reference into the config — the bearer values are
+   * never stored on disk nor echoed back.
+   * Returns the updated `MessagingConfigView` JSON (with its `channel` key).
+   */
+  messagingConfigSet(requestJson: string): Promise<string>;
+
+  /**
+   * `messaging.pairing.start` — mint a fresh high-entropy pairing code for one
+   * channel to display ONLY in the local UI; the paired device sends it back
+   * to bind its handle. Host/local-auth gated.
+   *
+   * `requestJson` is an optional `{ channel? }` selector (`"imessage"` |
+   * `"slack"`, default `"imessage"`). Returns `MessagingPairingStartResponse`
+   * JSON (`{ pairing_code, config }`).
+   */
+  messagingPairingStart(requestJson?: string): Promise<string>;
+
+  /**
+   * `messaging.pairing.status` — whether a pairing is in flight on one channel
+   * and (host gated) the active code. `requestJson` is an optional
+   * `{ channel? }` selector (`"imessage"` | `"slack"`, default `"imessage"`).
+   * Returns `MessagingPairingStatusResponse` JSON.
+   */
+  messagingPairingStatus(requestJson?: string): Promise<string>;
+
   /**
    * Recommend models for this machine + intent. `useCase`/`tier` are
    * snake_case enum values (e.g. "coding", "most_capable"); `cloudOk` lets
@@ -661,9 +727,11 @@ 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>;
   /**
@@ -870,7 +938,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. */
@@ -897,8 +971,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,
@@ -909,7 +990,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;
 
@@ -1544,11 +1627,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.28.0",
+  "version": "0.30.0",
   "description": "Common Agent Runtime — a deterministic execution layer for AI agents",
   "main": "index.js",
   "types": "index.d.ts",