wicked-crew-api-types 0.3.0 → 0.4.0

package/index.d.ts

@@ -221,6 +221,26 @@ export interface OnboardRef {
   runId: string | null;
 }
 
+/**
+ * Runtime health of one council seat (crew#274).
+ *
+ * Derived by the daemon from the live CoreEvent stream — NEVER from config. The roster is
+ * declarative: every configured CLI stays listed and enabled in `clis.toml`; quota/auth/runtime
+ * errors are runtime state the platform detects and displays as `inactive` + the error excerpt.
+ * Recovery is automatic: a captured-ok unit output for the seat, or an exit-0 `version_probe`
+ * from the daemon's low-frequency recovery probe, flips the seat back to `active` and clears
+ * the message — no operator hand-edit involved.
+ */
+export interface SeatHealth {
+  status: 'active' | 'inactive';
+  /** Bounded excerpt of the last seat-level error; present while `inactive`. */
+  message?: string;
+  /** When the seat entered its current status (ISO-8601). */
+  since: string;
+  /** When the last seat-level error was observed (ISO-8601), if any was. */
+  lastErrorAt?: string;
+}
+
 /**
  * A council seat (`AgenticCli`) as returned by `GET /roster`. Only the fields
  * the launch form uses are named; the index signature keeps the (large) rest of
@@ -232,9 +252,26 @@ export interface RosterSeat {
   binary: string;
   enabled_for_council: boolean;
   category?: string;
+  /**
+   * Runtime health (crew#274). Additive: absent on a daemon predating the field, and safe to
+   * round-trip into `clisJson` (the engine's `AgenticCli` deserializer ignores unknown fields).
+   * Absent-or-default reads as `active` with no message.
+   */
+  health?: SeatHealth;
   [k: string]: unknown;
 }
 
+/** Body for `POST /open` — open a file/folder with the OS default application (crew#273). */
+export interface OpenPathBody {
+  /**
+   * ABSOLUTE path to open. Validated daemon-side: it must resolve inside the run's workdir /
+   * extra write roots (when `runId` is given) or a registered repo root — never an arbitrary path.
+   */
+  path: string;
+  /** Widen validation to this run's workdir + extra write roots. Unknown id ⇒ 404. */
+  runId?: string;
+}
+
 /** The daemon's cached open-gate record (`GET /runs/:id/gate`, DES-STUDIO-001 §3.3). */
 export interface GateInfo {
   runId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames — types only, zero runtime",
   "type": "module",
   "types": "./index.d.ts",