wicked-crew-api-types 0.3.0 → 0.5.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,42 @@ 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;
+  /**
+   * The shell invocation that runs this seat's own interactive login flow (seat sign-in;
+   * wicked-core PR#278 `AgenticCli.login_invocation`). Passed through from the engine roster
+   * VERBATIM — the daemon never synthesizes one. The studio hosts it in a PTY terminal
+   * (`POST /terminals`) so every CLI's native sign-in gets one uniform surface. Absent on an
+   * engine predating the field (serde omits `None`) and on seats with no known login flow.
+   */
+  login_invocation?: string;
+  /**
+   * Whether the seat LOOKS signed in — a cheap file/env-presence HEURISTIC computed by the
+   * daemon (`seat-signin.ts`), never a spawned probe and never proof the credential still
+   * works. Three-valued on purpose: `true`/`false` when the seat's auth state is observable
+   * from files or env, `null`/absent when it is unknowable cheaply (keychain-backed seats,
+   * unknown seat keys, or a daemon predating the field).
+   */
+  signed_in?: boolean | null;
   [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;
@@ -998,6 +1051,14 @@ export interface GitContributor {
 export interface SystemSettings {
   /** Max nodes returned by wicked-estate graph-view (default 150). */
   graphNodeLimit: number;
+  /**
+   * Base directory for the ENGINE-OWNED worker CLI config homes (the claude worker home is
+   * `<root>/claude`). The daemon applies it as env `WICKED_WORKER_HOME` at boot and on every
+   * settings change; the engine reads that env per worker spawn (acp_runner.rs), so a change
+   * takes effect on the next spawn with no restart. Absolute path when set; `""` or absent =
+   * the engine default `~/.wicked-worker`.
+   */
+  worker_config_root?: string;
 }
 
 // ── Requirements management (server-side search + overrides; crew api/requirements.ts) ──

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.3.0",
+  "version": "0.5.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",