wicked-crew-api-types 0.96.0 → 0.98.0

package/index.d.ts

@@ -227,6 +227,8 @@ export interface HealthCapabilities {
   /**
    * `LaunchRunBody.revisesPr` is accepted (crew#550; crew ≥ 0.7.36). ABSENT on a daemon before
    * the field — read as `false`: do not send `revisesPr` to such a daemon.
+   * NOTE (crew#662): this CAPABILITY flag is a boolean; the LAUNCH field of the same name,
+   * `LaunchRunBody.revisesPr`, is the pull request NUMBER (a positive integer) — never `true`.
    */
   revisesPr?: boolean;
   /**
@@ -246,6 +248,12 @@ export interface HealthCapabilities {
    * as `false`: group such a daemon's runs one session per run.
    */
   runChatId?: boolean;
+  /**
+   * (crew#825; additive) `LaunchRunBody.excludeLinkedIssues` is accepted and
+   * `POST /linked-issues/preview` is served. ABSENT on an older daemon — read as `false`: do not
+   * send the field (its strict launch schema 400s on it) and do not call the preview.
+   */
+  linkedIssuesExclude?: boolean;
   /**
    * Repo-bound runs get an EVIDENCE ROOT for walkthroughs (WT-W1, api-types 0.74.0): the engine
    * addon takes `LaunchOptions.evidenceRoot` (wicked-core-ts ≥ 0.7.35), so a walkthrough step on a
@@ -902,9 +910,46 @@ export interface RosterSeat {
    * fails the seat's ACP governance closed at every spawn.
    */
   version_pin?: SeatVersionPin;
+  /**
+   * (IG1-core-3, wicked-core-ts 0.7.41) The engine's governance class for the seat, derived from
+   * its record — passed through verbatim. `null`/absent on an engine before the field.
+   */
+  governance_class?: EngineGovernanceClass | null;
+  /**
+   * (api-types 0.97.0, IG1-crew-1) The governance mode the seat runs under per scope kind (the
+   * keys of `chat_admission`): what fences its tool calls. A crew reading — never handed to the
+   * engine (`clisJson` strips it).
+   */
+  governance_mode?: Record<GovernanceScopeKind, SeatGovernanceMode>;
   [k: string]: unknown;
 }
 
+/** The engine's governance class names (IG1-core-3). */
+export type EngineGovernanceClass = 'acp_input_governance' | 'os_sandbox' | 'none';
+
+/** `unscoped` — no repository; `scoped` — several repositories or a project (the run binds none);
+ *  `scoped_bound` — one repository (the run is bound to its worktree; every build run). */
+export type GovernanceScopeKind = 'unscoped' | 'scoped' | 'scoped_bound';
+
+/**
+ * (api-types 0.97.0, IG1-crew-1) The governance MODE a seat runs under — what fences its tool
+ * calls. `admitted`: an ACP adapter sends every tool call through the engine's per-call gate (and
+ * a pinned build verified); `os_sandbox`: an OS write floor contains it — `source` names the floor
+ * (`seat_record` = `acp.os_sandbox`, `self` = codex's own `--sandbox`, `repo_boundary` = the
+ * engine's boundary around a run bound to one repository) — not a per-call gate, not a read or
+ * network jail; `none`: only the command-text fences. `reason` says why in the operator's words
+ * (codex: no per-call adapter exists to admit).
+ */
+export interface SeatGovernanceMode {
+  mode: 'admitted' | 'os_sandbox' | 'none';
+  class: EngineGovernanceClass | null;
+  source: 'acp_input_governance' | 'seat_record' | 'self' | 'repo_boundary' | 'none';
+  reason: string;
+  /** The roots the mode holds writes/reads to. On the roster these are labels (`<run worktree>`);
+   *  on a run's record, paths. */
+  fence: { write_roots: string[]; read_roots: string[]; network: 'open' };
+}
+
 /**
  * One pinned seat's `--version` reading (core#581): `RosterSeat.version_pin` and
  * `AcpCliDiagnostics.versionPin`. Read the way the engine's spawn-time check reads it: the pin
@@ -4026,6 +4071,8 @@ export interface LaunchRunBody {
    * `deliver: 'none'` is a 400), and the PR must be OPEN and not from a fork (409 naming why).
    * Send it ONLY when `GET /health.capabilities.revisesPr === true` — an older daemon's strict
    * launch schema rejects the key with a 400.
+   * NOTE (crew#662): a positive integer PR number — not the boolean capability flag
+   * `HealthCapabilities.revisesPr` of the same name. A 400 names the field and what it expected.
    */
   revisesPr?: number;
   /**
@@ -4083,6 +4130,30 @@ export interface LaunchRunBody {
    * guard as `channel` above.
    */
   actor?: string;
+  /**
+   * (crew#825; additive) Issue refs the intent names that the daemon must NOT read and append to
+   * the problem (`"541"`, `"#541"`, `"owner/repo#541"`; at most 50) — a reference in passing is not
+   * a request to inline the issue. Answered as `LaunchRunResponse.linkedIssues[]` entries with
+   * `excluded: true`. Send only when `GET /health.capabilities.linkedIssuesExclude === true`.
+   */
+  excludeLinkedIssues?: string[];
+}
+
+/** `POST /linked-issues/preview` (crew#825): what a workflow launch of `problem` WOULD append. */
+export interface LinkedIssuesPreviewBody {
+  problem: string;
+  repoRef?: string;
+  excludeLinkedIssues?: string[];
+}
+
+/** The `POST /linked-issues/preview` 200 body: the same reading `POST /runs` does, nothing launched. */
+export interface LinkedIssuesPreviewResponse {
+  issues: LinkedIssue[];
+  /** Characters the block would add to the problem; `0` when nothing would be appended. */
+  appendedChars: number;
+  /** Present when the reading itself failed (the repo list or gh unreadable): a launch now runs on
+   *  the intent alone, exactly as `POST /runs` does on the same fault. */
+  error?: string;
 }
 
 /**
@@ -4099,6 +4170,10 @@ export interface LinkedIssue {
   title?: string;
   /** Present when not `resolved`: why, in one line. */
   error?: string;
+  /** (crew#825; additive) Present when `resolved`: characters this issue adds to the problem. */
+  chars?: number;
+  /** (crew#825; additive) `true` when the launch left this ref out (`excludeLinkedIssues`). */
+  excluded?: true;
 }
 
 /** The `POST /runs` 201 body. `linkedIssues` (crew#627, additive) is present when the intent of a
@@ -4112,6 +4187,12 @@ export interface LaunchRunResponse {
    * delivery), and `notice` says so in words a composer can show. ABSENT on every other launch.
    */
   freeText?: { notice: string };
+  /**
+   * (crew#874) PRESENT when the installed wicked-garden is not the one the published skills
+   * generation was built from: the run executes the PUBLISHED generation, and this says so — the
+   * same `skills.installed-ahead` finding `GET /diagnostics.skills.findings` carries.
+   */
+  skillsWarning?: { kind: 'skills.installed-ahead'; severity: 'warning'; message: string };
 }
 
 /**
@@ -5653,6 +5734,12 @@ export interface ChatPathView {
   helpers: string[];
   /** The answer step the last message added (`answer-N`). */
   stepId: string;
+  /**
+   * (api-types 0.97.0, IG1-crew-1) The PA's governance mode for the ask's scope — what fences its
+   * tool calls — derived from the engine's class as the run reports it (`path.started.governance`,
+   * `member.joined.governance_class`). Absent until the PA is known, and on a daemon before it.
+   */
+  governance_mode?: SeatGovernanceMode;
 }
 
 // ── Project code graph (DES-PROJECT-001; the co-located multi-repo graph) ──────
@@ -6268,6 +6355,42 @@ export interface DiagnosticsResponse {
   stateHome?: DiagnosticsStateHome | null;
   /** The studio chat recorder's per-CLI format compliance (api-types 0.84.0, DC-S4b); `null` without the chat host. */
   decisions?: DiagnosticsDecisions | null;
+  /** (api-types 0.97.0, crew#742) Per-seat governance standing before any run. */
+  seatGovernance?: DiagnosticsSeatGovernance;
+  /** (api-types 0.97.0, crew#740) The memory store this daemon reads and writes. */
+  memoryStore?: MemoryStoreInfo;
+}
+
+/** `DiagnosticsResponse.seatGovernance` (crew#742). Paths are for the local operator. */
+export interface DiagnosticsSeatGovernance {
+  /** The engine's user registry overlay (`~/.config/wicked-council/clis.toml`) and whether it exists. */
+  rosterFile: { path: string; present: boolean } | null;
+  /** The OS launcher the repository boundary arms with on this host (`sandbox-exec` | `bwrap`),
+   *  found on PATH; `null` = none, so floor seats resting on it run advisory. */
+  hostBoundary: string | null;
+  seats: DiagnosticsSeatGovernanceEntry[];
+}
+
+export interface DiagnosticsSeatGovernanceEntry {
+  cli: string;
+  enabled_for_council: boolean;
+  transport: 'acp' | 'wrapped';
+  /** The seat record arms the OS sandbox itself (`acp.os_sandbox`). */
+  os_sandbox: boolean;
+  class: EngineGovernanceClass | null;
+  /** `enforced` — admitted and (if pinned) verified; `claimed` — admitted, pin not yet probed;
+   *  `unenforced` — no per-call gate holds the seat. */
+  input_governance: 'enforced' | 'claimed' | 'unenforced';
+  governance_mode: Record<GovernanceScopeKind, SeatGovernanceMode>;
+}
+
+/** (api-types 0.97.0, crew#740) The daemon's memory store: `explicit` (`WICKED_MEMORY_DB`),
+ *  `state-home` (a non-default state home's own store), `global` (the operator-global one).
+ *  `notice` is the isolation notice when this daemon's own store is empty and a global one exists. */
+export interface MemoryStoreInfo {
+  path: string;
+  source: 'explicit' | 'state-home' | 'global';
+  notice: string | null;
 }
 
 // ── Diagnostics — governance store + dead letters (api-types 0.31.0, crew#495 / F-022) ─────────
@@ -6425,7 +6548,12 @@ export interface DiagnosticsSkillsFinding {
    *  generation landed with (a reference the skill's author owns that names nothing in the
    *  snapshot — published as found); `message` names the publish finding's kind, `file:line` and
    *  evidence. Reported while that generation is current, from the publish that found them until the
-   *  daemon restarts (a restart re-verifies `current` without re-scanning it). */
+   *  daemon restarts (a restart re-verifies `current` without re-scanning it);
+   *  `skills.installed-ahead` (`warning`, crew#874) = the installed wicked-garden's content hash is
+   *  not the baseline the published generation was built from — runs use the published (older)
+   *  skills; `message` names both versions and the remedy (refresh-baseline, then publish). A
+   *  daemon boot refreshes and publishes on its own when nothing in the catalog is user-edited
+   *  (`WICKED_CREW_SKILLS_AUTO_REFRESH=0` turns that off); when it did not, the message says why. */
   kind:
     | 'skills.fallback'
     | 'skills.blocked'
@@ -6436,7 +6564,8 @@ export interface DiagnosticsSkillsFinding {
     | 'skills.base-skill'
     | 'skills.phase-skill'
     | 'skills.garden'
-    | 'skills.publish-warning';
+    | 'skills.publish-warning'
+    | 'skills.installed-ahead';
   severity: 'warning' | 'error';
   message: string;
 }
@@ -7220,6 +7349,8 @@ export interface ListMemoriesQuery {
 /** `GET /memory` → 200. */
 export interface ListMemoriesResponse {
   memories: MemoryItem[];
+  /** (api-types 0.97.0, crew#740) The store the list was read from. Absent on a daemon before it. */
+  store?: MemoryStoreInfo;
 }
 
 /** `GET /memory/coverage` query — an optional subtree filter (`""`/omitted = global totals). */

package/package.json

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