wicked-crew-api-types 0.127.0 → 0.130.0

package/index.d.ts

@@ -282,6 +282,11 @@ export interface HealthCapabilities {
    * older daemon — read as `'required'`.
    */
   qeAcceptance?: 'required' | 'off';
+  /**
+   * (api-types 0.128.0) `LaunchRunBody.primary` is accepted: a launch may name the seat that leads
+   * the run. ABSENT on an older daemon — do not send the field (its strict schema 400s on it).
+   */
+  launchPrimary?: boolean;
 }
 
 /** One `GET /health.warnings[]` entry (additive; wicked-core#411 / wicked-crew#497). */
@@ -1024,7 +1029,11 @@ export interface RosterSeat {
   key: string;
   display_name: string;
   binary: string;
+  /** wicked-core#572: may cast a council ballot — and nothing more (see `work_eligible`). */
   enabled_for_council: boolean;
+  /** (api-types 0.129.0) wicked-core#572: may be seated for work; absent means true. The engine's
+   *  registry field, passed through verbatim. */
+  seat_eligible_for_work?: boolean;
   category?: string;
   /**
    * Runtime health (crew#274). Additive: absent on a daemon predating the field, and safe to
@@ -1119,6 +1128,18 @@ export interface RosterSeat {
   council_eligible?: boolean;
   /** Present when `council_eligible` is false: the one reason, in the operator's words. */
   council_ineligible_reason?: string;
+  /**
+   * (api-types 0.129.0, crew#916, wicked-core#572) Whether the seat may be seated for WORK as far as
+   * the daemon can tell: `seat_eligible_for_work` not false, `auth` not `signed_out`, no active
+   * engine bench, login check answered. Independent of `council_eligible` — `enabled_for_council`
+   * covers the ballot only, so a work-only seat reads `council_eligible: false, work_eligible: true`
+   * and a reviewer-only seat the reverse. Neither false alone benches the seat: a launch benches it
+   * only when both are false. Never handed to the engine (`clisJson` strips it). ABSENT on a daemon
+   * before 0.129.0.
+   */
+  work_eligible?: boolean;
+  /** (api-types 0.129.0) Present when `work_eligible` is false: the one reason, in the operator's words. */
+  work_ineligible_reason?: string;
   /**
    * Present when THIS daemon's recent councils benched the seat: the engine's own
    * `councilSeatFailed` evidence (`non_zero_exit` / `timed_out`, the derivative `benched` kind
@@ -4746,6 +4767,15 @@ export interface LaunchRunBody {
   problem: string;
   sessionId?: string;
   clisJson?: string;
+  /**
+   * (api-types 0.128.0; DES-TEAMING-002 §8.1) The seat that LEADS the run (the primary agent, PA):
+   * a seat key from the launch roster (`clisJson`, else the daemon's default roster). The PA owns
+   * every step not marked `owner: "team"`. Omitted: the engine picks one at random among the
+   * eligible seats; either way the choice is recorded as `wicked.team.path.started.selection`
+   * (`"chosen"` | `"random"`). A key that is not in the roster, or names a signed-out seat, is a 400.
+   * Send only when `GET /health.capabilities.launchPrimary === true`.
+   */
+  primary?: string;
   entityMode?: EntityMode;
   humanConfirm?: string;
   repoRef?: string;
@@ -7446,6 +7476,24 @@ export interface DiagnosticsResponse {
   seatGovernance?: DiagnosticsSeatGovernance;
   /** (api-types 0.97.0, crew#740) The memory store this daemon reads and writes. */
   memoryStore?: MemoryStoreInfo;
+  /** (api-types 0.130.0, crew#1068) The wicked-vault CLI the engine records held team findings with
+   *  — see `DiagnosticsVault`. `null` on a route set booted without an engine adapter; ABSENT on an
+   *  older daemon. */
+  vault?: DiagnosticsVault | null;
+}
+
+/**
+ * (api-types 0.130.0, crew#1068) `DiagnosticsResponse.vault`: what the daemon exported to the engine
+ * as `WICKED_VAULT_BIN` at boot. `shipped` = crew's own `wicked-vault` dependency's bin (an absolute
+ * path); `operator` = the operator's own value, kept; `off` = the operator set it empty (the vault is
+ * switched off on purpose); `unresolvable` = crew's bin could not be resolved, so nothing was
+ * exported. `finding` is non-null exactly for `off` and `unresolvable` — the same entry
+ * `GET /health.warnings[]` carries (`vault.off` / `vault.unresolvable`) — and names the remedy.
+ */
+export interface DiagnosticsVault {
+  bin: string | null;
+  source: 'shipped' | 'operator' | 'off' | 'unresolvable';
+  finding: { kind: 'vault.off' | 'vault.unresolvable'; severity: 'warning'; message: string; remedy: string } | null;
 }
 
 /** `DiagnosticsResponse.seatGovernance` (crew#742). Paths are for the local operator. */
@@ -10081,7 +10129,11 @@ export interface McpSecretResponse {
 /** `POST /mcp/call`: what the garden shim sends. `token` is the worker's `WICKED_MCP_TOKEN`. */
 export interface McpCallBody {
   token: string;
-  /** `mcp:<server>/<tool>`. */
+  /**
+   * `mcp:<server>/<tool>`. The server name `estate` is reserved (wicked-core#1018): `mcp:estate/<tool>`
+   * is the estate relay, a container seat's way to its run's estate (the read-only graph, memory,
+   * knowledge and rules lookups, and `proposal.submit`), scoped by the daemon to the token's run.
+   */
   subject: string;
   /** The tool's arguments (a JSON object); absent = `{}`. */
   args?: Record<string, unknown>;
@@ -10118,7 +10170,11 @@ export interface McpCallResponse {
   subject: string;
   /** The call record's span id (`GET /mcp/usage` and the run's Governance panel resolve it). */
   callId: string | null;
-  /** The scrubbed `tools/call` result — only when `outcome` is `ok`. */
+  /**
+   * The scrubbed `tools/call` result — only when `outcome` is `ok`. For `mcp:estate/<tool>`, a
+   * JSON-RPC error estate answered (e.g. `-32602`, fix the arguments) is a tool error that keeps
+   * its code: `{ content, isError: true, rpcError: { code, message } }`.
+   */
   result?: Record<string, unknown>;
   /** The rules or gates that decided (deny, ask, withheld). */
   ruleIds: string[];

package/package.json

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