car-runtime 0.39.1 → 0.42.0

package/index.d.ts

@@ -170,6 +170,27 @@ export class CarRuntime {
     sessionId?: string | null,
   ): Promise<void>;
 
+  /**
+   * Remove a global policy by name. Resolves to how many were removed —
+   * `0` means nothing matched, which is not an error, so cleanup can call
+   * this unconditionally.
+   *
+   * Counterpart to `registerPolicy`, which had none: a policy registered
+   * over the wire could only be cleared by restarting the daemon
+   * (Parslee-ai/car#623). Session-scoped policies stay WS-only, mirroring
+   * `registerPolicy`'s own `sessionId` restriction — close the session to
+   * drop them.
+   */
+  unregisterPolicy(name: string): Promise<number>;
+
+  /**
+   * Global policies in force, as a JSON array of `{ name, description }`.
+   * Without this a caller could register a policy but never ask what was
+   * enforced, so an action rejection could not be explained beyond its own
+   * message.
+   */
+  listPolicies(): Promise<string>;
+
   /**
    * Set replan configuration on this runtime.
    * `maxReplans` = 0 disables replanning (default).
@@ -652,7 +673,15 @@ export class CarRuntime {
 
   // --- Speech ---
 
-  /** Prepare the managed speech runtime and return its root path. */
+  /**
+   * Provision the managed speech runtime and return its root path — the same
+   * root `speechHealth()` / `car speech doctor` report. The first call on a
+   * fresh machine builds a Python venv and can take minutes; afterwards it is
+   * a no-op. The returned path is not a success signal: on Apple Silicon the
+   * runtime is a fallback behind the native MLX backends, so a bootstrap that
+   * cannot run degrades instead of failing. Read
+   * `speechHealth().runtime.installed` for the real state.
+   */
   prepareSpeechRuntime(): Promise<string>;
 
   /** Transcribe a local audio file. Returns JSON `{text, model_used, language, ...}`. */
@@ -804,7 +833,7 @@ export class CarRuntime {
    * Coder — built-in coding agent (`coder.*` daemon namespace). Sessions
    * live in the daemon and are visible in CarHost. Live `coder.event`
    * streaming is WebSocket-only: call `coder.subscribe` on the daemon's
-   * WS directly (same contract as `infer.stream`).
+   * WS directly (same contract as `infer_stream`).
    *
    * Start a session: provisions an isolated git worktree of `repo` and
    * derives a verifiable outcome contract from `intent`. `engine` is
@@ -1375,26 +1404,16 @@ export function executeProposal(
 ): Promise<string>;
 
 /**
- * Stream inference events in real time via a callback.
- * Callback receives event JSON strings:
- *   `{"type":"text","data":"..."}`
- *   `{"type":"tool_start","name":"...","index":N}`
- *   `{"type":"tool_delta","index":N,"data":"..."}`
- *   `{"type":"done","text":"...","tool_calls":[...]}`
- *
- * **Breaking change in 0.5.x:** the prior 9-positional signature
- * has been replaced with an options-object form. Migration: build
- * the request object and `JSON.stringify` it as `requestJson`. The
- * options object exposes every `GenerateRequest` field including
- * `intent` (closes #107). The replacement (rather than addition of
- * a sibling) is forced by napi-rs's 3-standalone-TSF cap — see the
- * project rules for the rationale.
+ * @deprecated Unsupported ABI-compatibility stub. This function always
+ * rejects and never calls `onEvent`. Connect to `car-server` directly and use
+ * the `infer_stream` JSON-RPC method plus `inference.stream.event`
+ * notifications. See `docs/websocket-protocol.md`.
  */
 export function inferStream(
   rt: CarRuntime,
   requestJson: string,
   onEvent: (eventJson: string) => void,
-): Promise<string>;
+): Promise<never>;
 
 // --- Caller-facing routing intent (parslee-ai/car-releases#18) ---
 

package/package.json

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