@tai42/api-client 20.0.0 → 21.0.0

package/dist/schemas/fleet.d.ts

@@ -5,9 +5,9 @@ import { z } from 'zod';
  * is kept distinct from the fleet: the fleet doors ride the app's worker bus and
  * need no backend at all. */
 export declare const backendInfo: z.ZodObject<{
+    backend: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    module: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     present: z.ZodBoolean;
-    backend: z.ZodNullable<z.ZodString>;
-    module: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type BackendInfo = z.infer<typeof backendInfo>;
 /** The two worker kinds that join the bus: an ASGI `serve` worker or a
@@ -21,17 +21,17 @@ export type WorkerKind = z.infer<typeof workerKind>;
  * resync has converged, `resyncing` while a boot/reconnect resync runs, `recycling`
  * once it has begun a graceful self-exit. A drift throws `ApiSchemaError`. */
 export declare const workerState: z.ZodEnum<{
-    ready: "ready";
     resyncing: "resyncing";
     recycling: "recycling";
+    ready: "ready";
 }>;
 export type WorkerState = z.infer<typeof workerState>;
 /** The last op a worker applied, stamped onto its presence row after the terminal
  * reply. `outcome` is the free op-outcome string; `at` is the ISO instant it landed. */
 export declare const workerLastOp: z.ZodObject<{
+    at: z.ZodString;
     op: z.ZodString;
     outcome: z.ZodString;
-    at: z.ZodString;
 }, z.core.$strip>;
 export type WorkerLastOp = z.infer<typeof workerLastOp>;
 /**
@@ -46,26 +46,26 @@ export type WorkerLastOp = z.infer<typeof workerLastOp>;
  * worker's last applied op, or `null` before it has applied one.
  */
 export declare const fleetWorker: z.ZodObject<{
-    name: z.ZodString;
+    beat_at: z.ZodString;
+    generation: z.ZodNumber;
+    joined_at: z.ZodString;
     kind: z.ZodEnum<{
         backend: "backend";
         serve: "serve";
     }>;
+    last_op: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        at: z.ZodString;
+        op: z.ZodString;
+        outcome: z.ZodString;
+    }, z.core.$strip>>>;
+    name: z.ZodString;
     pid: z.ZodNumber;
-    generation: z.ZodNumber;
-    joined_at: z.ZodString;
-    beat_at: z.ZodString;
+    stale: z.ZodBoolean;
     state: z.ZodEnum<{
-        ready: "ready";
         resyncing: "resyncing";
         recycling: "recycling";
+        ready: "ready";
     }>;
-    stale: z.ZodBoolean;
-    last_op: z.ZodNullable<z.ZodObject<{
-        op: z.ZodString;
-        outcome: z.ZodString;
-        at: z.ZodString;
-    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FleetWorker = z.infer<typeof fleetWorker>;
 /**
@@ -76,26 +76,26 @@ export type FleetWorker = z.infer<typeof fleetWorker>;
  */
 export declare const fleetWorkers: z.ZodObject<{
     workers: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
+        beat_at: z.ZodString;
+        generation: z.ZodNumber;
+        joined_at: z.ZodString;
         kind: z.ZodEnum<{
             backend: "backend";
             serve: "serve";
         }>;
+        last_op: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            at: z.ZodString;
+            op: z.ZodString;
+            outcome: z.ZodString;
+        }, z.core.$strip>>>;
+        name: z.ZodString;
         pid: z.ZodNumber;
-        generation: z.ZodNumber;
-        joined_at: z.ZodString;
-        beat_at: z.ZodString;
+        stale: z.ZodBoolean;
         state: z.ZodEnum<{
-            ready: "ready";
             resyncing: "resyncing";
             recycling: "recycling";
+            ready: "ready";
         }>;
-        stale: z.ZodBoolean;
-        last_op: z.ZodNullable<z.ZodObject<{
-            op: z.ZodString;
-            outcome: z.ZodString;
-            at: z.ZodString;
-        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type FleetWorkers = z.infer<typeof fleetWorkers>;
@@ -109,14 +109,14 @@ export type FleetWorkers = z.infer<typeof fleetWorkers>;
  * convergence promise).
  */
 export declare const fleetOutcome: z.ZodEnum<{
-    failed: "failed";
     applied: "applied";
-    resyncing: "resyncing";
-    recycling: "recycling";
-    stale: "stale";
+    failed: "failed";
     missing: "missing";
     departed: "departed";
     timed_out: "timed_out";
+    resyncing: "resyncing";
+    recycling: "recycling";
+    stale: "stale";
 }>;
 export type FleetOutcome = z.infer<typeof fleetOutcome>;
 /**
@@ -126,20 +126,20 @@ export type FleetOutcome = z.infer<typeof fleetOutcome>;
  * `resyncing`/`recycling`/`stale`). A drift throws `ApiSchemaError`.
  */
 export declare const fleetWorkerResult: z.ZodObject<{
+    detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     outcome: z.ZodEnum<{
-        failed: "failed";
         applied: "applied";
-        resyncing: "resyncing";
-        recycling: "recycling";
-        stale: "stale";
+        failed: "failed";
         missing: "missing";
         departed: "departed";
         timed_out: "timed_out";
+        resyncing: "resyncing";
+        recycling: "recycling";
+        stale: "stale";
     }>;
-    payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    error: z.ZodNullable<z.ZodString>;
-    detail: z.ZodNullable<z.ZodString>;
+    payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
 }, z.core.$strip>;
 export type FleetWorkerResult = z.infer<typeof fleetWorkerResult>;
 /**
@@ -154,26 +154,27 @@ export type FleetWorkerResult = z.infer<typeof fleetWorkerResult>;
  * `fleet` / `unreachable` modes.
  */
 export declare const fleetResult: z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    local_only: z.ZodDefault<z.ZodBoolean>;
+    ok: z.ZodReadonly<z.ZodBoolean>;
     op: z.ZodString;
-    reachable: z.ZodBoolean;
-    local_only: z.ZodBoolean;
-    results: z.ZodArray<z.ZodObject<{
+    reachable: z.ZodDefault<z.ZodBoolean>;
+    results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         outcome: z.ZodEnum<{
-            failed: "failed";
             applied: "applied";
-            resyncing: "resyncing";
-            recycling: "recycling";
-            stale: "stale";
+            failed: "failed";
             missing: "missing";
             departed: "departed";
             timed_out: "timed_out";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
         }>;
-        payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        error: z.ZodNullable<z.ZodString>;
-        detail: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-    error: z.ZodNullable<z.ZodString>;
+        payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type FleetResult = z.infer<typeof fleetResult>;
 /**
@@ -183,89 +184,142 @@ export type FleetResult = z.infer<typeof fleetResult>;
  * the report is embedded even on the convergence-failure path.
  */
 export declare const fleetReloadResult: z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    local_only: z.ZodDefault<z.ZodBoolean>;
+    ok: z.ZodReadonly<z.ZodBoolean>;
     op: z.ZodString;
-    reachable: z.ZodBoolean;
-    local_only: z.ZodBoolean;
-    results: z.ZodArray<z.ZodObject<{
+    reachable: z.ZodDefault<z.ZodBoolean>;
+    results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         outcome: z.ZodEnum<{
-            failed: "failed";
             applied: "applied";
-            resyncing: "resyncing";
-            recycling: "recycling";
-            stale: "stale";
+            failed: "failed";
             missing: "missing";
             departed: "departed";
             timed_out: "timed_out";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
         }>;
-        payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        error: z.ZodNullable<z.ZodString>;
-        detail: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-    error: z.ZodNullable<z.ZodString>;
+        payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type FleetReloadResult = z.infer<typeof fleetReloadResult>;
-/**
- * The mode-wrapped fan-out summary a mutation embeds under its `fanout` field. Three
- * honest modes, discriminated on `mode`:
- *   - `local-only` — the broadcast reached no sibling (a lone worker / no bus), a
- *     benign single-process note.
- *   - `fleet` — a reachable multi-worker broadcast; carries the full {@link
- *     fleetResult} so an unconfirmed sibling is visible.
- *   - `unreachable` — the bus itself could not be reached; carries the
- *     bus-unreachable {@link fleetResult} (no worker list, only `error`).
- *
- * Every mutation whose response embeds this parses it EXPLICITLY: zod's default
- * unknown-key stripping would otherwise silently drop the field, hiding a failed
- * propagation from the shared fleet-report handler. A drift throws `ApiSchemaError`.
- */
 export declare const fleetReportFanout: z.ZodDiscriminatedUnion<[z.ZodObject<{
     mode: z.ZodLiteral<"local-only">;
     note: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    local_only: z.ZodDefault<z.ZodBoolean>;
     op: z.ZodString;
-    reachable: z.ZodBoolean;
-    local_only: z.ZodBoolean;
-    results: z.ZodArray<z.ZodObject<{
+    reachable: z.ZodDefault<z.ZodBoolean>;
+    results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         outcome: z.ZodEnum<{
-            failed: "failed";
             applied: "applied";
-            resyncing: "resyncing";
-            recycling: "recycling";
-            stale: "stale";
+            failed: "failed";
             missing: "missing";
             departed: "departed";
             timed_out: "timed_out";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
         }>;
-        payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        error: z.ZodNullable<z.ZodString>;
-        detail: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-    error: z.ZodNullable<z.ZodString>;
+        payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
     mode: z.ZodLiteral<"fleet">;
 }, z.core.$strip>, z.ZodObject<{
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    local_only: z.ZodDefault<z.ZodBoolean>;
     op: z.ZodString;
-    reachable: z.ZodBoolean;
-    local_only: z.ZodBoolean;
-    results: z.ZodArray<z.ZodObject<{
+    reachable: z.ZodDefault<z.ZodBoolean>;
+    results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         outcome: z.ZodEnum<{
-            failed: "failed";
             applied: "applied";
-            resyncing: "resyncing";
-            recycling: "recycling";
-            stale: "stale";
+            failed: "failed";
             missing: "missing";
             departed: "departed";
             timed_out: "timed_out";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
         }>;
-        payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-        error: z.ZodNullable<z.ZodString>;
-        detail: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-    error: z.ZodNullable<z.ZodString>;
+        payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
     mode: z.ZodLiteral<"unreachable">;
 }, z.core.$strip>], "mode">;
 export type FleetReportFanout = z.infer<typeof fleetReportFanout>;
+/**
+ * One worker line of a fleet recycle roll. `status` is `recycled` (confirmed on
+ * reality), `timed-out` or `failed` (the target the roll stopped at — `detail` names
+ * why), or `self-deferred` (the worker that took the change recycles itself after
+ * replying). `generation_before` is the life that was recycled.
+ */
+export declare const recycleEntry: z.ZodObject<{
+    detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    generation_before: z.ZodNumber;
+    kind: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodString;
+}, z.core.$strip>;
+export type RecycleEntry = z.infer<typeof recycleEntry>;
+/** One newly-ready worker life observed since the change began — capacity evidence. */
+export declare const freshLife: z.ZodObject<{
+    generation: z.ZodNumber;
+    kind: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type FreshLife = z.infer<typeof freshLife>;
+/**
+ * Where a recycle roll stopped and why: `name` is the target it stopped at, or `null`
+ * when the bus could not be read before a target was reached.
+ */
+export declare const recycleStop: z.ZodObject<{
+    detail: z.ZodString;
+    kind: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type RecycleStop = z.infer<typeof recycleStop>;
+/**
+ * The report of a fleet recycle roll an env change carrying a recycle-class key ran:
+ * the worker lines, the fresh lives, and where the roll stopped (`null` when it ran to
+ * its end). Names only — never an env value.
+ */
+export declare const recycleRoll: z.ZodObject<{
+    fresh: z.ZodArray<z.ZodObject<{
+        generation: z.ZodNumber;
+        kind: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    recycle: z.ZodArray<z.ZodObject<{
+        detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        generation_before: z.ZodNumber;
+        kind: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+    }, z.core.$strip>>;
+    recycle_stopped: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        detail: z.ZodString;
+        kind: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RecycleRoll = z.infer<typeof recycleRoll>;
+/**
+ * One worker an operation names as still awaiting a respawn: its recycle-class `keys`
+ * changed in the stored env since its process bound them (at boot, or when the plugin that
+ * declares them was loaded), and nothing in the operation respawns it.
+ */
+export declare const awaitingWorker: z.ZodObject<{
+    keys: z.ZodArray<z.ZodString>;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type AwaitingWorker = z.infer<typeof awaitingWorker>;
 //# sourceMappingURL=fleet.d.ts.map

package/dist/schemas/fleet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fleet.d.ts","sourceRoot":"","sources":["../../src/schemas/fleet.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;6BAG6B;AAC7B,eAAO,MAAM,WAAW;;;;iBAItB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;iEACiE;AACjE,eAAO,MAAM,UAAU;;;EAA+B,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;8EAE8E;AAC9E,eAAO,MAAM,WAAW;;;;EAA8C,CAAC;AACvE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;wFACwF;AACxF,eAAO,MAAM,YAAY;;;;iBAIvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;iBAUtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;iBAA8C,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;EASvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;iBAMtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;iBAAc,CAAC;AAC7C,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAI5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"fleet.d.ts","sourceRoot":"","sources":["../../src/schemas/fleet.ts"],"names":[],"mappings":"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"}

package/dist/schemas/fleet.js

@@ -1,29 +1,21 @@
 /** Backend identity and worker-bus fleet/fan-out response schemas. */
 import { z } from 'zod';
-import { jsonValue } from './shared';
+import * as openapi from '../generated/openapi-schemas';
 /** `GET /api/backend` — the execution-backend identity, or the absent sentinel
  * (`present: false`, a 200) when no backend plugin is registered. Backend identity
  * is kept distinct from the fleet: the fleet doors ride the app's worker bus and
  * need no backend at all. */
-export const backendInfo = z.object({
-    present: z.boolean(),
-    backend: z.string().nullable(),
-    module: z.string().nullable(),
-});
+export const backendInfo = openapi.backendInfo;
 /** The two worker kinds that join the bus: an ASGI `serve` worker or a
  * `backend` runtime process. A drift throws `ApiSchemaError`. */
-export const workerKind = z.enum(['serve', 'backend']);
+export const workerKind = openapi.workerKind;
 /** The lifecycle state a worker advertises in its presence value: `ready` once its
  * resync has converged, `resyncing` while a boot/reconnect resync runs, `recycling`
  * once it has begun a graceful self-exit. A drift throws `ApiSchemaError`. */
-export const workerState = z.enum(['ready', 'resyncing', 'recycling']);
+export const workerState = openapi.workerState;
 /** The last op a worker applied, stamped onto its presence row after the terminal
  * reply. `outcome` is the free op-outcome string; `at` is the ISO instant it landed. */
-export const workerLastOp = z.object({
-    op: z.string(),
-    outcome: z.string(),
-    at: z.string(),
-});
+export const workerLastOp = openapi.lastOp;
 /**
  * One live worker on the bus — a presence-census row. `name` is the stable slot
  * (`{kind}-{n}`) that doubles as a reload target; `generation` is the monotonic life
@@ -35,24 +27,14 @@ export const workerLastOp = z.object({
  * only freshness signal a client reads, never a client-side threshold; `last_op` is the
  * worker's last applied op, or `null` before it has applied one.
  */
-export const fleetWorker = z.object({
-    name: z.string(),
-    kind: workerKind,
-    pid: z.number(),
-    generation: z.number(),
-    joined_at: z.string(),
-    beat_at: z.string(),
-    state: workerState,
-    stale: z.boolean(),
-    last_op: workerLastOp.nullable(),
-});
+export const fleetWorker = openapi.workerListingRow;
 /**
  * `GET /api/fleet/workers` — the live worker fleet from the bus presence census.
  * The census lists ALL subscribed workers (ASGI `serve` workers and backend-runtime
  * processes alike), not only backend workers. A census read that fails surfaces as a
  * loud 500, never a fabricated empty fleet.
  */
-export const fleetWorkers = z.object({ workers: z.array(fleetWorker) });
+export const fleetWorkers = openapi.workerListing;
 /**
  * One worker's outcome within a fleet broadcast. `applied`/`failed` are terminal wire
  * replies from a subscriber; `missing`/`departed`/`timed_out` are publisher-computed
@@ -62,29 +44,14 @@ export const fleetWorkers = z.object({ workers: z.array(fleetWorker) });
  * `recycling` is departing, `stale` is a quiet row past the freshness bound carrying no
  * convergence promise).
  */
-export const fleetOutcome = z.enum([
-    'applied',
-    'failed',
-    'missing',
-    'departed',
-    'timed_out',
-    'resyncing',
-    'recycling',
-    'stale',
-]);
+export const fleetOutcome = openapi.opOutcome;
 /**
  * One worker's result within a {@link fleetResult}. `payload` carries query-op data
  * (opaque to the UI); `error` carries a failed apply's message; `detail` carries the
  * publisher's report text for a computed gap outcome (`missing`/`departed`/`timed_out`/
  * `resyncing`/`recycling`/`stale`). A drift throws `ApiSchemaError`.
  */
-export const fleetWorkerResult = z.object({
-    name: z.string(),
-    outcome: fleetOutcome,
-    payload: jsonValue,
-    error: z.string().nullable(),
-    detail: z.string().nullable(),
-});
+export const fleetWorkerResult = openapi.workerResult;
 /**
  * The awaited per-worker report of one fleet broadcast. Two honest shapes ride the
  * same schema. Reachable (`reachable: true`): `results` holds one entry per expected
@@ -96,13 +63,7 @@ export const fleetWorkerResult = z.object({
  * reload; it is also the body the mode-wrapped {@link fleetReportFanout} carries under its
  * `fleet` / `unreachable` modes.
  */
-export const fleetResult = z.object({
-    op: z.string(),
-    reachable: z.boolean(),
-    local_only: z.boolean(),
-    results: z.array(fleetWorkerResult),
-    error: z.string().nullable(),
-});
+export const fleetResult = openapi.fleetResult;
 /**
  * `POST /api/fleet/reload-config` — soft-restart the fleet and report per-worker. The
  * serving worker applies its own reload first, then broadcasts; the returned report
@@ -124,9 +85,38 @@ export const fleetReloadResult = fleetResult;
  * unknown-key stripping would otherwise silently drop the field, hiding a failed
  * propagation from the shared fleet-report handler. A drift throws `ApiSchemaError`.
  */
+// Hand-written: the spec publishes a fan-out as one object with optional fields; the client
+// discriminates its three modes.
+const fanoutFleetResult = openapi.fleetResult.omit({ ok: true });
 export const fleetReportFanout = z.discriminatedUnion('mode', [
     z.object({ mode: z.literal('local-only'), note: z.string() }),
-    fleetResult.extend({ mode: z.literal('fleet') }),
-    fleetResult.extend({ mode: z.literal('unreachable') }),
+    fanoutFleetResult.extend({ mode: z.literal('fleet') }),
+    fanoutFleetResult.extend({ mode: z.literal('unreachable') }),
 ]);
+/**
+ * One worker line of a fleet recycle roll. `status` is `recycled` (confirmed on
+ * reality), `timed-out` or `failed` (the target the roll stopped at — `detail` names
+ * why), or `self-deferred` (the worker that took the change recycles itself after
+ * replying). `generation_before` is the life that was recycled.
+ */
+export const recycleEntry = openapi.recycleEntry;
+/** One newly-ready worker life observed since the change began — capacity evidence. */
+export const freshLife = openapi.freshLife;
+/**
+ * Where a recycle roll stopped and why: `name` is the target it stopped at, or `null`
+ * when the bus could not be read before a target was reached.
+ */
+export const recycleStop = openapi.recycleStop;
+/**
+ * The report of a fleet recycle roll an env change carrying a recycle-class key ran:
+ * the worker lines, the fresh lives, and where the roll stopped (`null` when it ran to
+ * its end). Names only — never an env value.
+ */
+export const recycleRoll = openapi.recycleRoll;
+/**
+ * One worker an operation names as still awaiting a respawn: its recycle-class `keys`
+ * changed in the stored env since its process bound them (at boot, or when the plugin that
+ * declares them was loaded), and nothing in the operation respawns it.
+ */
+export const awaitingWorker = openapi.awaitingWorker;
 //# sourceMappingURL=fleet.js.map

package/dist/schemas/fleet.js.map

@@ -1 +1 @@
-{"version":3,"file":"fleet.js","sourceRoot":"","sources":["../../src/schemas/fleet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fleet.js","sourceRoot":"","sources":["../../src/schemas/fleet.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAExD;;;6BAG6B;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAG/C;iEACiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAG7C;;8EAE8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAG/C;wFACwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;AAG3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;AAG9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;AAGtD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAG/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAG7C;;;;;;;;;;;;;GAaG;AACH,4FAA4F;AAC5F,iCAAiC;AACjC,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC5D,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC7D,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;CAC7D,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAGjD,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAG3C;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAG/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAG/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC"}