wicked-crew-api-types 0.39.0 → 0.40.0

package/index.d.ts

@@ -111,7 +111,15 @@ export type EntityMode = 'shared' | 'isolated';
 /** Human-confirm gate policy. serde: `None`→"none", `All`→"all", `Before(n)`→{ before: n }. */
 export type HumanConfirm = 'none' | 'all' | { before: number };
 
-/** Why a CLI was assigned to a unit (`RoutingInfo`, internally tagged on `method`). */
+/**
+ * Why a CLI was assigned to a unit (`RoutingInfo`, internally tagged on `method`).
+ *
+ * `teamed` (wicked-core#590 S5) is what every seated unit of a new run carries: the engine no
+ * longer convenes a council to route, it picks the first eligible seat the unit's skills admit, in
+ * roster order (`winner`), and the evaluator ≠ creator fence then moves a review/test unit off a
+ * builder seat (`evaluator_distinct`, whose `was` is the teamed pick). `council` and `degraded` are
+ * no longer produced; they stay because a recorded run's units carry them.
+ */
 export type RoutingInfo =
   /**
    * `seated` is the seats CONVENED — the denominator `returned` must be read against.
@@ -135,7 +143,8 @@ export type RoutingInfo =
     }
   | { method: 'degraded'; reason: string }
   | { method: 'evaluator_distinct'; winner: string; was: string }
-  | { method: 'tool' };
+  | { method: 'tool' }
+  | { method: 'teamed'; winner: string };
 
 /**
  * `GET /health` (api-types 0.37.0 — the shape was previously undeclared here; `status`,
@@ -1012,7 +1021,9 @@ export interface CoreEvent {
   library?: string;
   transform?: string;
   known?: boolean;
-  detail?: string;
+  /** `adviceDelivered` (wicked-core#602, api-types 0.40.0) spells an absent detail `null`, never an
+   *  absent key — widened to admit that `null`; every other producer still sends a string. */
+  detail?: string | null;
   [k: string]: unknown;
 }
 
@@ -1900,6 +1911,58 @@ export type WorkerToolCallDeniedEvent = {
   remedy: string;
 };
 
+/**
+ * DES-TEAMING-001 §5.2 / §7 (wicked-core#602, S3; api-types 0.40.0) — what became of HIGH monitor
+ * advice for one attempt of a unit. The one mid-turn carrier is the ACP adapter's
+ * `_session/steering` request, always sent with `idleBehavior: "promptRequired"` so a steer that
+ * lands after the turn settled never starts a detached turn.
+ *
+ * - `carrier: 'acp_steering'` + `outcome: 'injected'` — the steer reached the running turn.
+ * - `outcome: 'turn_ended'` — the adapter answered `promptRequired` (the turn had settled; nothing
+ *   was started), or the turn ended with the steer unanswered. The advice goes to the gate.
+ * - `outcome: 'refused'` — the adapter answered a JSON-RPC error (in `detail`); the turn continues.
+ * - `outcome: 'not_delivered'` — the advice never rode a steer: `carrier: 'none'` when the unit's
+ *   carrier has no mid-turn channel (wrapped, PTY, an ACP adapter not advertising steering), or
+ *   `'acp_steering'` when the turn ended before the next tool-call boundary. `detail` says which.
+ *
+ * Every key is always present; `detail` is `null` when there is nothing to add. Spelled exactly as
+ * wicked-core's `CoreEvent::to_json` emits it. `type` alias on purpose (relays through the
+ * `CoreEvent`-typed seams unchanged).
+ */
+export type AdviceDeliveredEvent = {
+  type: 'adviceDelivered';
+  session: string;
+  ord: number;
+  attempt: number;
+  /** `f-` + 16 lowercase hex per finding; one steer may carry several. */
+  findingIds: string[];
+  carrier: 'acp_steering' | 'none' | (string & {});
+  outcome: 'injected' | 'turn_ended' | 'refused' | 'not_delivered' | (string & {});
+  detail: string | null;
+};
+
+/**
+ * DES-TEAMING-001 §5.3 / §7 (wicked-core#602, S3; api-types 0.40.0) — the worker's answer to one
+ * DELIVERED finding, read from its final output line `ADVICE <id>: ACCEPT|DECLINE — <reason>` (the
+ * last line per id wins). The worker may decline and must say why: `reason` (≤2 KB) is its
+ * evidence, and may be `""` — a refusal with no evidence is recorded as exactly that. A delivered
+ * finding with no line emits nothing here and is `unanswered` in the team ledger. The gate, not the
+ * monitor, decides.
+ */
+export type WorkerAdviceResponseEvent = {
+  type: 'workerAdviceResponse';
+  session: string;
+  ord: number;
+  attempt: number;
+  findingId: string;
+  disposition: 'accepted' | 'declined' | (string & {});
+  reason: string;
+};
+
+/** The S3 team-advice events as a discriminated union for consumers that narrow on `type`; they
+ *  also flow through the permissive {@link CoreEvent}. */
+export type TeamAdviceEvent = AdviceDeliveredEvent | WorkerAdviceResponseEvent;
+
 export type GateEvidenceEvent =
   | EvaluatorMutatedWorktreeEvent
   | RepoChecksEvaluatedEvent
@@ -2006,9 +2069,12 @@ export interface UnitDistributedEvent {
   ord: number;
   /** The roster key of the assigned seat. */
   cli: string;
-  /** How the seat was chosen: the council verdict, a degrade to the first candidate, an
-   *  evaluator ≠ creator reassignment, or a deterministic tool execution. */
-  routingMethod: 'council' | 'degraded' | 'evaluator_distinct' | 'tool';
+  /** How the seat was chosen: `'teamed'` — the deterministic pick, no council (wicked-core#590 S5;
+   *  every seated unit of a new run) — an evaluator ≠ creator reassignment, or a deterministic tool
+   *  execution. `'council'` / `'degraded'` are no longer emitted by a new run and stay for recorded
+   *  frames. On `'teamed'` the council-only fields (`agreementPct`, `returned`, `seated`, `dissent`)
+   *  are `null`. Consumers must render an unrecognised method as "routed", never as a council. */
+  routingMethod: 'council' | 'degraded' | 'evaluator_distinct' | 'tool' | 'teamed';
   agreementPct: number | null;
   /** Ballots that came back. Read against `seated`. */
   returned: number | null;
@@ -2046,7 +2112,7 @@ export interface UnitDistributedEvent {
    */
   distinctnessFallback?: 'creator_seat' | 'same_cli_instance' | null;
   /** @deprecated api-types 0.36.0 — the engine emits `routingMethod`; removed in 0.37. */
-  routing_method?: 'council' | 'degraded' | 'evaluator_distinct' | 'tool';
+  routing_method?: 'council' | 'degraded' | 'evaluator_distinct' | 'tool' | 'teamed';
   /** @deprecated api-types 0.36.0 — the engine emits `agreementPct`; removed in 0.37. */
   agreement_pct?: number | null;
   /** @deprecated api-types 0.36.0 — the engine emits `degradedReason`; removed in 0.37. */

package/package.json

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