car-runtime 0.29.0 → 0.31.0

package/index.d.ts

@@ -554,6 +554,74 @@ 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>;
+
+  /**
+   * `messaging.status` — the real runtime liveness of one channel's approval
+   * transport, computed daemon-side so a host UI can render a SINGLE readiness
+   * state (enabled · watcher running · FDA · paired) plus last-delivered +
+   * last-error. Host/local-auth gated. `requestJson` is an optional
+   * `{ channel? }` selector (`"imessage"` | `"slack"`, default `"imessage"`).
+   * Returns `MessagingStatusView` JSON.
+   */
+  messagingStatus(requestJson?: string): Promise<string>;
+
+  /**
+   * `messaging.test_send` — send a fixed, clearly-labeled self-test message to
+   * one channel's paired handle and return `{ ok, error }` synchronously. A
+   * pure send probe: it mints NO approval/pairing mapping and resolves nothing.
+   * Host/local-auth gated. `requestJson` is an optional `{ channel? }` selector
+   * (`"imessage"` | `"slack"`, default `"imessage"`). Returns
+   * `MessagingTestSendResponse` JSON.
+   */
+  messagingTestSend(requestJson?: string): Promise<string>;
+
   /**
    * Recommend models for this machine + intent. `useCase`/`tier` are
    * snake_case enum values (e.g. "coding", "most_capable"); `cloudOk` lets

package/package.json

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