wicked-crew-api-types 0.119.0 → 0.122.0

package/index.d.ts

@@ -273,6 +273,15 @@ export interface HealthCapabilities {
    * carry `qe`. ABSENT on an older daemon — do not send the fields (its strict schema 400s on them).
    */
   qeAcceptanceOverride?: boolean;
+  /**
+   * (api-types 0.120.0) The daemon's QE acceptance setting ({@link SystemSettings.qeAcceptance}):
+   * `'required'` (the default) or `'off'` — every launch of a workflow that requires QE acceptance,
+   * and that neither skips nor forces it, is skipped with a reason naming the setting (labelled on
+   * the run, every gate and the delivery); launches the engine takes without crew excepted (see the
+   * setting). ABSENT on an
+   * older daemon — read as `'required'`.
+   */
+  qeAcceptance?: 'required' | 'off';
 }
 
 /** One `GET /health.warnings[]` entry (additive; wicked-core#411 / wicked-crew#497). */
@@ -1270,8 +1279,9 @@ export interface SeatIssueCommand {
  */
 export interface RosterResponse {
   roster: RosterSeat[];
-  /** Present on a `?refresh=` read: `probed` — the answer is fresh; `timed_out` — still running
-   *  (the roster shows the last reading; the check keeps going); `not_probed` — the seat has no
+  /** Present on a `?refresh=` read: `probed` — the answer is fresh; `timed_out` — no fresh answer:
+   *  the check is still running (it keeps going), or it finished and could not tell (a status command
+   *  that timed out); either way the roster shows the last reading; `not_probed` — the seat has no
    *  sign-in check (it reads its credential file). */
   refresh?: { key: string; outcome: 'probed' | 'timed_out' | 'not_probed' };
 }
@@ -2155,6 +2165,24 @@ export interface OperatorJudgment {
   reason: string | null;
 }
 
+/**
+ * (api-types 0.121.0, wicked-core judge fallback, operator ruling 2026-10-14) A judge seated IN PLACE
+ * of the run's preferred judge: every preferred judge seat was benched for the run (codex's worktree
+ * bench, a sign-in refusal) or failed as a seat while judging, so a fallback seat (Claude Code, then
+ * Antigravity) distinct from every party to the work (creator, authors, evaluator, validator author,
+ * team) judged instead. With no such seat the gate still holds (`judge_unavailable`).
+ */
+export interface JudgeFallback {
+  /** The seat that judged. */
+  seat: string;
+  /** The preferred judge seats it stood in for, in rotation order. */
+  preferred: string[];
+  /** Why they could not judge, in the engine's words (`codex benched: …` / `copilot unavailable: …`). */
+  reason: string;
+  /** The disclosure line to show as-is: `judge: agy (fallback; codex benched: …)`. */
+  label: string;
+}
+
 /** Why an instrument is absent from a receipt. */
 export type AssuranceSkipReason =
   | 'reduced_assurance'
@@ -2240,6 +2268,10 @@ export interface AssuranceReceipt {
   /** (api-types 0.110.0) Every gate the operator judged ("judged by operator"); ABSENT when none or on
    *  an older engine. A unit receipt carries its own; a delivery receipt lists the run's. */
   operatorJudges?: OperatorJudgment[];
+  /** (api-types 0.121.0) Every judge seated as a FALLBACK for a benched or unavailable preferred judge;
+   *  ABSENT when every judge was the run's own (the routine case) or on an older engine. A unit
+   *  receipt carries at most one; a delivery receipt lists the run's. */
+  judgeFallbacks?: JudgeFallback[];
 }
 
 /**
@@ -4722,6 +4754,10 @@ export interface LaunchRunBody {
    * default and typo fallback). Requires wicked-core-ts ≥ 0.7.24 / crew ≥ 0.7.33 for the gate to
    * exist at all — read `AgentSession.auto_deliver` to learn whether the engine knows it. An
    * older daemon's launch schema rejects the field with a 400 — omit it against such servers.
+   * `'auto'` on a workflow that requires QE acceptance (with no `skipQeAcceptance` and the daemon's
+   * {@link SystemSettings.qeAcceptance} not `'off'`) is refused 400 `{ code: 'qe_acceptance_required',
+   * error }` (crew ≥ 0.12.1; before that, `error` alone). The token is the one a refused delivery's
+   * {@link QeAcceptanceRefusal} carries, but this 400 has no `acceptance` or `assurance`.
    */
   deliverGate?: 'human' | 'auto';
   /**
@@ -4816,7 +4852,9 @@ export interface LaunchRunBody {
    * reason (non-empty, the operator's own words). Persisted on the contract
    * (`assurance.qe.status: 'skipped'`, `basis: 'operator'`) and labelled on the run, every gate and
    * the delivery ("QE acceptance skipped by operator: <reason>"). Omitted: a required QE acceptance
-   * is never skipped. 400 beside `forceQeAcceptance`; the engine refuses it on a run whose workflow
+   * is not skipped — unless the daemon's {@link SystemSettings.qeAcceptance} is `'off'`, which skips it
+   * the same way with a reason naming the setting (a `forceQeAcceptance: true` launch still requires
+   * it). 400 beside `forceQeAcceptance`; the engine refuses it on a run whose workflow
    * does not require QE acceptance. Send only when `GET /health.capabilities.qeAcceptanceOverride`.
    */
   skipQeAcceptance?: { reason: string };
@@ -5370,6 +5408,23 @@ export interface SystemSettings {
    * launches (those are always `'none'`).
    */
   deliverDefault?: 'pr' | 'none';
+  /**
+   * (api-types 0.120.0) QE ACCEPTANCE for this daemon. `'required'` (the shipped default; absent
+   * reads the same): a run whose workflow requires `qe_acceptance` delivers only on an attributed
+   * PASS unless its own launch sends `skipQeAcceptance`. `'off'`: every launch of such a workflow that
+   * neither skips nor forces QE acceptance itself is SKIPPED, through the same skip, with a reason
+   * naming this setting — `assurance.qe.status: 'skipped'`, `basis: 'operator'`, labelled on the run,
+   * every gate and the delivery, and the deliver gate reads a skip, never a refusal. A launch's
+   * `forceQeAcceptance: true` still requires it. `GET /health.capabilities.qeAcceptance` reports it.
+   * (api-types 0.122.0) The launches the engine takes on its own — campaign nodes (as each dispatches) and
+   * `wicked.crew.run.requested` bus requests — follow it too, when the engine addon carries
+   * `setQeAcceptanceOff` (crew hands the setting to the engine with every settings read): such a
+   * launch that gives no QE word of its own (`CampaignRunSpec.skip_qe_acceptance_reason` /
+   * `force_qe_acceptance`, or the same keys on the bus request's `args`) is skipped with the same
+   * reason, only when its contract requires QE acceptance. On an older addon those launches still
+   * require it.
+   */
+  qeAcceptance?: 'required' | 'off';
   /**
    * (crew#552) Whether a completed onboarding run chains a `capture-learnings` run for the same
    * repo (filed in the onboarding run's project; proposals stay human-gated). Absent reads as
@@ -6954,6 +7009,14 @@ export interface CampaignRunSpec {
   /** The registered `WorkflowDef` id this node's Run follows — for a deterministic scenario node,
    *  the per-node composed Tool workflow (`campaign-<campaign>-<node>`). */
   workflow_id?: string | null;
+  /** (api-types 0.122.0; engine wire, QE acceptance) The node's own skip of a required QE acceptance, with its reason
+   *  — labelled on the node's run, gates and delivery. Absent unless the def set it (crew's
+   *  scenarios do not); refused beside `force_qe_acceptance` and on a workflow that does not
+   *  require QE acceptance. With neither set, the daemon's `qeAcceptance: 'off'` applies. */
+  skip_qe_acceptance_reason?: string;
+  /** (api-types 0.122.0; engine wire, QE acceptance) The node's own force: QE acceptance is required whatever the
+   *  run's score says. Absent = `false`. */
+  force_qe_acceptance?: boolean;
 }
 
 /** A schedulable unit of the DAG — one node = one governed core Run. */

package/package.json

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