wicked-crew-api-types 0.131.0 → 0.133.0

package/index.d.ts

@@ -291,7 +291,8 @@ export interface HealthCapabilities {
 
 /** One `GET /health.warnings[]` entry (additive; wicked-core#411 / wicked-crew#497). */
 export interface HealthWarning {
-  /** `state-home.unregistered` today; open for later kinds. */
+  /** `state-home.unregistered` today; open for later kinds (e.g. `seat.work_default`,
+   *  api-types 0.133.0 — see `DiagnosticsSeatGovernance.roleFindings`). */
   kind: string;
   severity: 'warning' | 'error';
   message: string;
@@ -1557,7 +1558,15 @@ export interface RunDiff {
   base?: string;
 }
 
-/** The daemon's cached open-gate record (`GET /runs/:id/gate`, DES-STUDIO-001 §3.3). */
+/**
+ * The daemon's cached open-gate record (`GET /runs/:id/gate`, DES-STUDIO-001 §3.3).
+ *
+ * (api-types 0.132.0) The read answers **503** `{ error, code: 'gate_unstable' }` when live gate
+ * events kept landing while the daemon read the run's record and nothing could be verified — retry
+ * — and **409** `{ error, code: 'gate_unknown' }` when the engine's open gate rows disagree on the
+ * ord. It serves the newest of the agreeing rows: the one a decision is judged by.
+ * A decision is never authorized from this record: see {@link GateDecision.ord}.
+ */
 export interface GateInfo {
   runId: string;
   ord: number;
@@ -1578,6 +1587,20 @@ export interface GateInfo {
    * kind, never infer it from the unit. ABSENT on an older daemon and when the engine did not say.
    */
   gateKind?: string;
+  /**
+   * (api-types 0.132.0; issue #969) The answer tokens the engine offered on this gate — mirrors the
+   * opening `awaitingHuman.choices` (e.g. a `team_dispute` gate's
+   * `['approve', 'request_changes', 'reject']`), so a client that missed the live frame (reload,
+   * late join, second tab) renders the same answers. ABSENT on an older daemon and when the engine
+   * offered none; never empty.
+   */
+  choices?: string[];
+  /**
+   * (api-types 0.132.0; issue #969) The index into {@link GateInfo.choices} of the engine's
+   * recommended answer — mirrors `awaitingHuman.recommended`. ABSENT on an older daemon, when the
+   * engine recommended none, and whenever `choices` is absent.
+   */
+  recommended?: number;
   /** (crew ≥ 0.9.0) The gated unit's persisted receipt (`WorkUnit.assurance`) — what assured the
    *  work this gate asks about. `null` when the unit carries none (no gate evaluated it yet, or an
    *  older engine); ABSENT on an older daemon. */
@@ -1674,7 +1697,16 @@ export interface GateDecision {
    * mismatch, confirming nothing: the gate was answered elsewhere or replaced while the decision
    * waited (a skin's undo window). When the daemon cannot tell which gate is open it answers
    * **409** `{ error, code: 'gate_unknown' }` — refresh the gate and decide again. Absent = today's
-   * behaviour (no gate check).
+   * behaviour (no gate check). (api-types 0.132.0) The comparison is made against the engine's
+   * durable open gate rows, read under the run's decision lock immediately before the confirm —
+   * never the daemon's gate cache — and judged by ORD AGREEMENT, not row count:
+   * - no open gate row → **409** `gate_unknown`;
+   * - open rows that disagree on the ord (the record is ambiguous) → **409** `gate_unknown`;
+   * - the rows agree on an ord other than this one → **409** `gate_changed` with `openOrd`;
+   * - the rows agree on this ord — one row or several (a keyed plan gate plus its recovery row) →
+   *   authorized.
+   * The same reading judges a decision without `ord` (ambiguous rows → `gate_unknown`) and a gated
+   * `POST /runs/:id/resume` or `/reassign`.
    */
   ord?: number;
 }
@@ -7531,6 +7563,14 @@ export interface DiagnosticsSeatGovernance {
    *  found on PATH; `null` = none, so floor seats resting on it run advisory. */
   hostBoundary: string | null;
   seats: DiagnosticsSeatGovernanceEntry[];
+  /**
+   * (api-types 0.133.0) Seat-role findings read from the overlay above — the same objects
+   * `GET /health.warnings[]` carries. Today one kind: `seat.work_default`, one per CUSTOM seat the
+   * overlay writes `enabled_for_council = false` with no `seat_eligible_for_work` key, which since
+   * crew 0.15.2 (#916) is eligible for work by the engine default. Built-in seats never appear; an
+   * explicit `seat_eligible_for_work` (true or false) silences it. ABSENT on an older daemon.
+   */
+  roleFindings?: HealthWarning[];
 }
 
 export interface DiagnosticsSeatGovernanceEntry {

package/package.json

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