wicked-crew-api-types 0.36.0 → 0.37.0

package/index.d.ts

@@ -137,6 +137,24 @@ export type RoutingInfo =
   | { method: 'evaluator_distinct'; winner: string; was: string }
   | { method: 'tool' };
 
+/**
+ * `GET /health` (api-types 0.37.0 — the shape was previously undeclared here; `status`,
+ * `version` and `ping` are unchanged since 0.1). `capabilities` (additive) names what the
+ * running daemon + its engine addon can actually do, so a client never promises a behaviour the
+ * deployment cannot keep:
+ *   - `deliverGate` — the engine pauses before the composed `deliver` phase pushes and opens the
+ *     PR unless the launch said `deliverGate: 'auto'` (F-E2E-030; wicked-core-ts ≥ 0.7.24).
+ *     `false` (or the whole object absent — a daemon before 0.7.33) ⇒ delivery follows verify
+ *     UNATTENDED; a composer must say so instead of promising a gate, and must not send
+ *     `deliverGate` (an older daemon's launch schema rejects it).
+ */
+export interface HealthResponse {
+  status: string;
+  version: string;
+  ping: string;
+  capabilities?: { deliverGate: boolean };
+}
+
 /** A run (`AgentSession`). */
 export interface AgentSession {
   id: string;
@@ -147,6 +165,14 @@ export interface AgentSession {
   clis: string[];
   status: SessionStatus;
   human_confirm: HumanConfirm;
+  /**
+   * Whether the run's deliver phase may push and open its PR WITHOUT a human confirming it
+   * first (F-E2E-030; api-types 0.37.0, additive). `false` — the engine pauses before the `deliver` Tool unit
+   * whatever `human_confirm` says; `true` — the launch opted out explicitly (`deliverGate:
+   * 'auto'`). ABSENT on runs from an engine that predates the deliver gate (wicked-core-ts <
+   * 0.7.24): such an engine delivers unattended — render no gate promise for it.
+   */
+  auto_deliver?: boolean;
   unit_ix: number;
   attempt: number;
   workdir: string | null;
@@ -3000,6 +3026,18 @@ export interface LaunchRunBody {
    * omit the field entirely against pre-0.18 servers.
    */
   deliver?: 'pr' | 'none';
+  /**
+   * Who confirms the deliver phase (F-E2E-030; api-types 0.37.0, additive). `'human'` — the default when omitted:
+   * the ENGINE pauses before the composed `deliver` Tool unit pushes the run branch and opens the
+   * PR, whatever `humanConfirm` says (the push leaves the machine under the daemon's active gh
+   * account, so it is confirmed unless the caller opts out). `'auto'` — the caller's EXPLICIT
+   * opt-out: the push and PR follow verify unattended; a client sending it must name the posture
+   * "auto-deliver" to its operator. `humanConfirm: 'none'` is NOT an opt-out (it is that field's
+   * 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.
+   */
+  deliverGate?: 'human' | 'auto';
   /**
    * Retry lineage (DES-UX-001 §8.3, CREW-UX-3; api-types 0.8.0): the id of the run this
    * launch retries. Must name an EXISTING run id — an unknown id fails the launch (400 with

package/package.json

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