wicked-crew-api-types 0.127.0 → 0.128.0

package/index.d.ts

@@ -282,6 +282,11 @@ export interface HealthCapabilities {
    * older daemon — read as `'required'`.
    */
   qeAcceptance?: 'required' | 'off';
+  /**
+   * (api-types 0.128.0) `LaunchRunBody.primary` is accepted: a launch may name the seat that leads
+   * the run. ABSENT on an older daemon — do not send the field (its strict schema 400s on it).
+   */
+  launchPrimary?: boolean;
 }
 
 /** One `GET /health.warnings[]` entry (additive; wicked-core#411 / wicked-crew#497). */
@@ -4746,6 +4751,15 @@ export interface LaunchRunBody {
   problem: string;
   sessionId?: string;
   clisJson?: string;
+  /**
+   * (api-types 0.128.0; DES-TEAMING-002 §8.1) The seat that LEADS the run (the primary agent, PA):
+   * a seat key from the launch roster (`clisJson`, else the daemon's default roster). The PA owns
+   * every step not marked `owner: "team"`. Omitted: the engine picks one at random among the
+   * eligible seats; either way the choice is recorded as `wicked.team.path.started.selection`
+   * (`"chosen"` | `"random"`). A key that is not in the roster, or names a signed-out seat, is a 400.
+   * Send only when `GET /health.capabilities.launchPrimary === true`.
+   */
+  primary?: string;
   entityMode?: EntityMode;
   humanConfirm?: string;
   repoRef?: string;
@@ -10081,7 +10095,11 @@ export interface McpSecretResponse {
 /** `POST /mcp/call`: what the garden shim sends. `token` is the worker's `WICKED_MCP_TOKEN`. */
 export interface McpCallBody {
   token: string;
-  /** `mcp:<server>/<tool>`. */
+  /**
+   * `mcp:<server>/<tool>`. The server name `estate` is reserved (wicked-core#1018): `mcp:estate/<tool>`
+   * is the estate relay, a container seat's way to its run's estate (the read-only graph, memory,
+   * knowledge and rules lookups, and `proposal.submit`), scoped by the daemon to the token's run.
+   */
   subject: string;
   /** The tool's arguments (a JSON object); absent = `{}`. */
   args?: Record<string, unknown>;
@@ -10118,7 +10136,11 @@ export interface McpCallResponse {
   subject: string;
   /** The call record's span id (`GET /mcp/usage` and the run's Governance panel resolve it). */
   callId: string | null;
-  /** The scrubbed `tools/call` result — only when `outcome` is `ok`. */
+  /**
+   * The scrubbed `tools/call` result — only when `outcome` is `ok`. For `mcp:estate/<tool>`, a
+   * JSON-RPC error estate answered (e.g. `-32602`, fix the arguments) is a tool error that keeps
+   * its code: `{ content, isError: true, rpcError: { code, message } }`.
+   */
   result?: Record<string, unknown>;
   /** The rules or gates that decided (deny, ask, withheld). */
   ruleIds: string[];

package/package.json

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