wicked-crew-api-types 0.98.0 → 0.100.0

package/index.d.ts

@@ -711,6 +711,110 @@ export interface WorkUnit {
    * marker was MISSING (that denies; the denial is the record), and on an older engine.
    */
   capture_report?: CaptureReport;
+  /**
+   * TRUE when the worktree guard governs this unit (a def-driven, agent-executed
+   * `executes_code: false` phase — a READ-ONLY phase; wicked-core `WorkUnit.worktree_guarded`,
+   * derived at plan time). Skip-if-false on the wire: ABSENT on every other unit and on an older
+   * engine. Typed here for crew#891 (the floor-fix gate is a read-only phase's).
+   */
+  worktree_guarded?: boolean;
+  /**
+   * TRUE when this unit runs the repository's own checks as its floor (wicked-core
+   * `WorkUnit.repo_checks_floor`). Skip-if-false on the wire: ABSENT otherwise.
+   */
+  repo_checks_floor?: boolean;
+  /**
+   * The repo-checks evidence the fold attached to this unit (wicked-core `RepoChecksReport`),
+   * typed only as far as a skin reads it (crew#891); the rest of the report rides the index
+   * signature. ABSENT until the unit's gate folds, and when the floor does not apply.
+   */
+  repo_checks?: WorkUnitRepoChecks;
+  /**
+   * Every human gate note that amended this unit, oldest first (wicked-core#760
+   * `WorkUnit.operator_rulings`) — the record the evaluator reviewing it reads. ABSENT when empty.
+   */
+  operator_rulings?: OperatorRuling[];
+  /** (crew#894, wicked-core#810) The phase's worker pool (one creator plus monitors). ABSENT = 1. */
+  pool?: number;
+  /** (crew#894) How that pool was seated, once distributed (see {@link UnitPoolSeating}). ABSENT
+   *  for a pool of 1 and before distribution. */
+  pool_seating?: UnitPoolSeating;
+}
+
+/**
+ * How an operator's floor-only re-run ran (wicked-core `FloorRerunMode`, snake_case on the wire):
+ * `extend` | `targeted` | `accept_partial` (wicked-core#469, the escalation arms of a floor that did
+ * not finish) and `floor_fix` (crew#891, wicked-core#782 / #811 — a seat distinct from the
+ * read-only phase made the operator's fix first; reached only through an approve with a note at
+ * that phase's floor gate, never as its own `GateDecision.action`).
+ */
+export type FloorRerunMode = 'extend' | 'targeted' | 'accept_partial' | 'floor_fix';
+
+/** (crew#891, wicked-core#782) The fix a `floor_fix` re-run makes before its floor runs. */
+export interface FloorFix {
+  /** The operator's note, verbatim — the fixing seat's whole task. */
+  note: string;
+  /** The seat that makes the fix: distinct from the read-only phase's own (evaluator ≠ fixer). */
+  seat: string;
+}
+
+/** (wicked-core#469) A floor-only re-run the escalation gate armed on a unit, read by its next dispatch. */
+export interface FloorRerun {
+  mode: FloorRerunMode;
+  /** `accept_partial`: the checks waived. Absent when empty. */
+  waive?: string[];
+  /** The seat's output from the attempt the gate reviewed (the fold reads it; the seat does not re-run).
+   *  Always serialised (`""` when none). */
+  output: string;
+  /** `floor_fix` only (crew#891): the note and the distinct seat that makes it. */
+  fix?: FloorFix;
+}
+
+/** {@link WorkUnit.repo_checks}: the parts of wicked-core's `RepoChecksReport` a skin reads. */
+export interface WorkUnitRepoChecks {
+  /** Whether the floor passed (vacuously true when nothing was detected). The engine always sends
+   *  it; optional here because this type is a partial reading, and consumers (fixtures included)
+   *  already hold units whose report they only partly know. */
+  passed?: boolean;
+  /** The operator's re-run this report answers; absent for the ordinary floor. */
+  rerun?: FloorRerunMode;
+  /** Checks the operator waived for this unit. Absent when empty. */
+  waived?: string[];
+  /** The re-run armed at the gate and not yet consumed. Absent otherwise. */
+  requested_rerun?: FloorRerun;
+  [k: string]: unknown;
+}
+
+/**
+ * One human gate note on a unit (wicked-core#760 `OperatorRuling`): `request_changes` | `amend`,
+ * and `floor_fix` (crew#891, wicked-core#782) for an approve-with-note a distinct seat made as a
+ * floor fix. Read an unknown token as a note, never as an error.
+ */
+export interface OperatorRuling {
+  action: 'request_changes' | 'amend' | 'floor_fix' | (string & {});
+  /** The operator's own words. */
+  text: string;
+  /** The amended unit's attempt when the ruling was given. */
+  attempt: number;
+  /** Unix millis. */
+  at: number;
+}
+
+/**
+ * (crew#894, wicked-core#810) A unit's worker-pool fill — `unitDistributed.pool` and
+ * `WorkUnit.pool_seating` (the same keys; core-ts `UnitPoolSeatingJson`).
+ */
+export interface UnitPoolSeating {
+  /** The phase's `pool` (after any plan step lowered it). */
+  requested: number;
+  /** Seats filled: the creator plus `monitors.length`. */
+  seated: number;
+  /** The monitor seat instances (`claude#2`), in the order the team supervisor summons them. */
+  monitors: string[];
+  /** Configured instances that could have filled the shortfall but are not signed in. */
+  missing: string[];
+  /** Why `seated < requested`; `null` when the pool was filled. */
+  shortfall: string | null;
 }
 
 /** The counts a capture phase reported (`WorkUnit.capture_report`; wicked-core#535). */
@@ -826,6 +930,15 @@ export interface RosterSeat {
    * engine predating the field (serde omits `None`) and on seats with no known login flow.
    */
   login_invocation?: string;
+  /**
+   * The shell invocation that signs this seat OUT of its own configuration root (crew#615;
+   * wicked-core#807 `AgenticCli.logout_invocation`, core-ts >= 0.7.43): the CLI's own documented
+   * logout (`claude auth logout`, `codex logout`, `opencode auth logout`), prefixed with the seat's
+   * root exactly like {@link login_invocation}. Passed through VERBATIM; absent for a seat whose CLI
+   * documents no logout (copilot, pi, agy) and on an engine predating the field. `POST
+   * /seats/:cli/logout` runs it.
+   */
+  logout_invocation?: string;
   /**
    * Whether the seat LOOKS signed in — a cheap file/env-presence HEURISTIC computed by the
    * daemon (`seat-signin.ts`), never a spawned probe and never proof the credential still
@@ -2523,10 +2636,14 @@ export interface UnitReworkAmendedEvent {
    * (`amendScope: 'creator'`); `'request_changes'` — the creator phase the gate rewound to, and
    * `amendment` then carries the evaluator's full findings + the operator's note;
    * `'accept_suggestion'` (wicked-core#467) — the same rewind after the operator adopted the
-   * evaluator's pinned edit, and `amendment` names it. ABSENT on an engine before the field — read
-   * as `'cursor'`.
+   * evaluator's pinned edit, and `amendment` names it. `'floor_fix'` (crew#891, wicked-core#782 /
+   * #811) — an approve WITH A NOTE at the escalation gate of a READ-ONLY phase (worktree-guarded,
+   * `executes_code: false`) whose own repo-checks floor denied it: a seat DISTINCT from that phase
+   * makes the note's fix in the worktree, then only the floor re-runs (the phase does not run again;
+   * its verdict stands and the floor decides). ABSENT on an engine before the field — read as
+   * `'cursor'`.
    */
-  scope?: 'cursor' | 'creator' | 'request_changes' | 'accept_suggestion';
+  scope?: 'cursor' | 'creator' | 'request_changes' | 'accept_suggestion' | 'floor_fix';
 }
 
 /** P2 — a worker's ApplyStepResult arrived and output is ready to be gated. Fires before GateDecided.
@@ -2569,7 +2686,8 @@ export interface UnitPlannedEvent {
   description: string;
   stage: StageKind;
   role: PhaseRole;
-  gate: 'auto' | 'human_confirm' | 'human_confirm_if';
+  /** `consent_before` from wicked-core-ts 0.7.43 (core#801, crew#888). */
+  gate: 'auto' | 'human_confirm' | 'human_confirm_if' | 'consent_before';
   skill_ref: string | null;
   has_validator_pin: boolean;
   executor_type: 'agent' | 'tool';
@@ -2636,6 +2754,13 @@ export interface UnitDistributedEvent {
    * unrecognised value as a disclosure too, never as "distinct".
    */
   distinctnessFallback?: 'creator_seat' | 'same_cli_instance' | null;
+  /**
+   * (crew#894, wicked-core#810 / #813; core-ts >= 0.7.44) How the unit's WORKER POOL was filled:
+   * one creator plus monitors. `null` for a pool of 1 (the default) and a tool unit; ABSENT on an
+   * older engine. A pool larger than the signed-in instances is seated SHORT and disclosed here
+   * (`seated < requested`, `missing`, `shortfall`), never refused. Guard with `== null`.
+   */
+  pool?: UnitPoolSeating | null;
   /** @deprecated api-types 0.36.0 — the engine emits `routingMethod`; removed in 0.37. */
   routing_method?: 'council' | 'degraded' | 'evaluator_distinct' | 'tool' | 'teamed';
   /** @deprecated api-types 0.36.0 — the engine emits `agreementPct`; removed in 0.37. */
@@ -4301,9 +4426,17 @@ export interface GraphKind {
 /** Gate position in the value→strategy→execution ladder. */
 export type GateType = 'value' | 'strategy' | 'execution';
 
-/** Human-confirm spec for a phase gate (serde flattened from Rust enum). */
+/**
+ * Human-confirm spec for a phase gate (serde flattened from Rust enum).
+ *
+ * `'consent_before'` (wicked-core#805 / core#801, core-ts >= 0.7.43; crew#888): the engine pauses
+ * BEFORE the phase runs, with `awaitingHuman{gateKind: 'consent'}`, whatever the run-level
+ * `humanConfirm` policy, and nothing pauses after it. Approve runs the phase; reject cancels the run
+ * with nothing in the phase run. A standing order never answers a `consent` gate.
+ */
 export type GateSpec =
   | 'auto'
+  | 'consent_before'
   | { human_confirm: { unconditional: boolean } }
   | { human_confirm_if: 'verdict_not_pass' };
 
@@ -4322,6 +4455,12 @@ export type PhaseExecutor =
 export interface PhaseDef {
   id: string;
   kind: StageKindPhase;
+  /**
+   * (crew#894, wicked-core#810) The phase's worker pool, `1..=4` (absent = 1): one creator plus
+   * `pool - 1` monitors, inside a TEAM run only. A user workflow declaring `pool > 1` is refused at
+   * registration (`pool outside a team run`), and so is a value outside `1..=4` (`pool out of range`).
+   */
+  pool?: number;
   /** How the phase executes. Omitted = Agent (engine default). Tool phases bypass the council and
    *  run `cmd` directly. */
   executor?: PhaseExecutor;
@@ -4422,6 +4561,28 @@ export interface DomainCoverage {
   resolved: number;
 }
 
+/**
+ * `POST /seats/:cli/login` and `POST /seats/:cli/logout` (crew#615): the PTY size for the terminal
+ * the daemon opens running the seat's own `login_invocation` / `logout_invocation`. Both optional
+ * (default 100 x 30).
+ */
+export interface SeatSessionBody {
+  cols?: number;
+  rows?: number;
+}
+
+/**
+ * The answer to {@link SeatSessionBody}: the terminal running the seat's sign-in / sign-out
+ * command. Drive and read it over `/ws/terminals/:id` (a device URL streams there). 404 when the
+ * seat is unknown or its CLI documents no such command.
+ */
+export interface SeatSessionResponse {
+  terminalId: string;
+  /** The seat key the command was run for. */
+  cli: string;
+  action: 'login' | 'logout';
+}
+
 /** The open-terminal request body (`POST /terminals`, DES-TERMINAL-001 §6). */
 export interface OpenTerminalBody {
   /** Working directory the PTY opens in. */
@@ -5332,7 +5493,12 @@ export interface InteractionRequest {
   reviewing_ord: number | null;
   prompt: string;
   status: 'open' | 'answered' | 'expired' | 'cancelled';
-  /** The decision payload (JSON text, e.g. `{"approve":true,"amend":null}`) once resolved. */
+  /**
+   * The decision payload (JSON text, e.g. `{"approve":true,"amend":null}`) once resolved. Its
+   * `action` names the arm; `"floor_fix"` (crew#891, wicked-core#782) replaces `"approve"` when an
+   * approve with a note at a read-only phase's floor gate was taken as a floor fix — it IS an
+   * approve.
+   */
   answer: string | null;
   /** Unix millis. */
   created_at: number;
@@ -7461,6 +7627,10 @@ export interface TeamPlanStep {
   added_by?: 'plan' | 'floor' | (string & {});
   floor_reason?: string;
   late?: boolean;
+  /** (crew#894, wicked-core#810) The step's worker pool. A plan step may only LOWER the catalog
+   *  phase's pool; a raise is refused (`wicked.team.plan.refused`, reason `pool_raised`). Omitted
+   *  when unset. */
+  pool?: number;
 }
 
 export interface TeamPlanOverride {
@@ -7545,6 +7715,8 @@ export type TeamPlanAcceptedPayload = TeamEnvelope & {
 export type TeamPlanRefusedPayload = TeamEnvelope & {
   proposal_id: string;
   base_rev: number | null;
+  /** The engine's refusal reason, verbatim — e.g. `pool_raised` (crew#894, wicked-core#810: a plan
+   *  step raised a phase's `pool`; a step may only lower it). */
   reason: string;
 };
 
@@ -7581,6 +7753,9 @@ export type TeamStepClaimedPayload = TeamEnvelope & {
   baseline_tree: string | null;
   repo: { workdir: string; git_dir: string } | null;
   code_graph_db: string | null;
+  /** (crew#894, wicked-core#810) The monitor seat instances summoned beside the claiming creator
+   *  (a pool > 1). Omitted when empty. */
+  monitors?: string[];
 };
 
 export type TeamCheckpointReachedPayload = TeamEnvelope & {

package/package.json

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