@tai42/api-client 16.0.0 → 17.0.0

package/dist/schemas/conversations.js

@@ -0,0 +1,208 @@
+/** Conversation route, thread, transcript and config schemas. */
+import { z } from 'zod';
+import { conversationRoute, targetConversationConfig } from './served';
+import { pageWindow } from './shared';
+// The cross-channel conversation monitor's READ side: the stored routing rows
+// (the route picker) from `GET /api/conversations`, a route's threads from
+// `GET /api/conversations/{route}/threads`, and one thread's transcript from
+// `GET /api/conversations/{route}/transcript?thread_id=`. Timestamps are float
+// epoch seconds, not ISO strings, and both paged doors carry the same window
+// fields; the transcript adds the direction it was read in.
+/** The inbound door a route is bound to: the authed API, or a channel medium. */
+export const conversationDoor = z.enum(['api', 'channel']);
+/** What a route's turn runs: a registered agent, or a tool dispatch. */
+export const conversationTargetKind = z.enum(['agent', 'tool']);
+/**
+ * A route's default control mode (`initial_mode`) when a thread carries no
+ * per-thread override: `agent` runs the target turn, `manual` suppresses it for an
+ * operator to answer. The same value vocabulary as a per-thread mode override, but
+ * a distinct concept (the route default vs. one thread's override).
+ */
+export const conversationMode = z.enum(['agent', 'manual']);
+/**
+ * Where a record sits between intake and a terminal outcome. `failed` is the one
+ * the monitor surfaces loudly; `shed` and `silent` are terminal by design and
+ * never send.
+ */
+export const conversationDeliveryStatus = z.enum([
+    'accepted',
+    'pending_delivery',
+    'provisional',
+    'delivered',
+    'failed',
+    'shed',
+    'silent',
+]);
+/** The nature of a turn's outcome, orthogonal to where its delivery stands. */
+export const conversationAnswerStatus = z.enum(['answered', 'error', 'silent']);
+/**
+ * Who authored a record's outgoing side. `client` is the ordinary turn the flow
+ * answered; `operator` is a message a human sent into the thread, whose text
+ * rides `answer` (its `inbound_text` is empty).
+ */
+export const conversationRecordOrigin = z.enum(['client', 'operator']);
+export const conversationRoutes = z.object({
+    items: z.array(conversationRoute),
+    total: z.number(),
+});
+/**
+ * The create/replace reply: whether THIS call created the row (vs. replaced an
+ * existing one), the row itself (its `callback_secret` withheld), and the
+ * `callback_secret` returned ONCE for an `api`-door row (`null` for a `channel`
+ * row). The secret signs delivery callbacks and is never re-read from any door, so
+ * a caller that needs it must capture it from this reply.
+ */
+export const conversationRouteWritten = z.object({
+    created: z.boolean(),
+    route_name: z.string(),
+    route: conversationRoute,
+    callback_secret: z.string().nullable(),
+});
+/**
+ * The delete reply: `removed` says whether THIS call removed the routing row (a
+ * retryable reclamation of orphaned thread indexes answers `false` rather than a
+ * 404).
+ */
+export const conversationRouteDeleted = z.object({
+    removed: z.boolean(),
+    route_name: z.string(),
+});
+/**
+ * One thread of a route, summarized from its newest record. A `thread_id` holds
+ * an api-door address (`{principal}/{end user}`, percent-encoded), so it never
+ * goes back into a URL as a path segment — the transcript door takes it as a
+ * query value.
+ */
+export const conversationThread = z.object({
+    thread_id: z.string(),
+    client_address: z.string(),
+    last_activity_at: z.number(),
+    message_count: z.number(),
+    last_delivery_status: conversationDeliveryStatus,
+});
+export const conversationThreadsPage = z.object({
+    items: z.array(conversationThread),
+    ...pageWindow,
+});
+/**
+ * One exchange: the visitor's `inbound_text` — every record answers a message, so
+ * both projections always carry it — and the agent's `answer`, plus where that
+ * answer's delivery stands. The fields after `updated_at` are ADMIN ONLY —
+ * the same door serves a caller-scoped projection that withholds them — so they
+ * are optional here and absence means "not published to this reader".
+ */
+export const conversationMessage = z.object({
+    message_id: z.string(),
+    route_name: z.string(),
+    door: conversationDoor,
+    thread_id: z.string(),
+    client_address: z.string(),
+    caller_principal: z.string().nullable(),
+    inbound_text: z.string(),
+    answer_status: conversationAnswerStatus.nullable(),
+    answer: z.string().nullable(),
+    origin: conversationRecordOrigin,
+    delivery_status: conversationDeliveryStatus,
+    created_at: z.number(),
+    updated_at: z.number(),
+    channel: z.string().nullable().optional(),
+    our_identity: z.string().nullable().optional(),
+    provider_message_id: z.string().nullable().optional(),
+    callback_url: z.string().nullable().optional(),
+    error: z.string().nullable().optional(),
+    outbound_message_ids: z.array(z.string()).optional(),
+    attempts: z.number().optional(),
+});
+/**
+ * The direction a transcript page reads in. `asc` is the reading order (oldest
+ * first); `desc` is the live-tail order, where page 1 is always the newest page
+ * and paging forward walks BACKWARDS through the thread's history.
+ */
+export const transcriptOrder = z.enum(['asc', 'desc']);
+/** A transcript page, echoing the order it was read in. */
+export const conversationTranscriptPage = z.object({
+    items: z.array(conversationMessage),
+    ...pageWindow,
+    order: transcriptOrder,
+});
+/**
+ * A route-scoped message search (`GET /api/conversations/{route}/messages/search?q`):
+ * every record on the route whose text matches `q`, across threads, newest first.
+ * The record shape is the transcript's exactly, so a hit renders with the same
+ * projection. `truncated` says the match set outran the door's scan cap — surfaced
+ * loudly, never a silent cut.
+ */
+export const conversationMessageSearchPage = z.object({
+    items: z.array(conversationMessage),
+    ...pageWindow,
+});
+/**
+ * Who answers a thread's incoming messages: `agent` lets the flow reply on its
+ * own; `manual` holds the flow back so a human answers. `source` says whether the
+ * setting is the thread's own (`thread`) or inherited from its route (`route`).
+ */
+export const conversationThreadMode = z.enum(['agent', 'manual']);
+export const conversationThreadModeState = z.object({
+    mode: conversationThreadMode,
+    source: z.enum(['thread', 'route']),
+});
+/** The receipt a thread-message write returns: the stored id and its thread. */
+export const conversationThreadMessageSent = z.object({
+    message_id: z.string(),
+    thread_id: z.string(),
+});
+/** Every stored per-target config (`GET /api/conversation-configs`). */
+export const conversationConfigs = z.object({
+    items: z.array(targetConversationConfig),
+    total: z.number(),
+});
+/**
+ * The upsert reply: whether THIS call created the config (vs. replaced an existing
+ * one), its key, and the stored row.
+ */
+export const conversationConfigWritten = z.object({
+    created: z.boolean(),
+    target_kind: conversationTargetKind,
+    target_name: z.string(),
+    config: targetConversationConfig,
+});
+/** The config-delete reply: `removed` is always `true` on success (an unknown key is a 404). */
+export const conversationConfigDeleted = z.object({
+    removed: z.boolean(),
+    target_kind: conversationTargetKind,
+    target_name: z.string(),
+});
+/**
+ * The admin-only failed-delivery listing (`GET /api/conversations/messages/failed`):
+ * every answer record whose delivery ended `failed`, across every route and caller.
+ * The records are the ADMIN projection (delivery bookkeeping and `error` included),
+ * so the row shape is {@link conversationMessage} exactly. It is NOT a paged window —
+ * the door returns `{items, total}` and nothing more.
+ */
+export const conversationFailedMessages = z.object({
+    items: z.array(conversationMessage),
+    total: z.number(),
+});
+/**
+ * The thread-delete reply (`DELETE /api/conversations/{route_name}/thread?thread_id=`).
+ * `removed` is a COUNT of the answer records this call deleted — `0` when a prior
+ * run already cleared them, when they had aged out under retention, or when the id
+ * was never stored (forgetting is absolute, never a 404 on a valid id).
+ */
+export const conversationThreadDeleted = z.object({
+    removed: z.number(),
+    route_name: z.string(),
+    thread_id: z.string(),
+});
+/**
+ * The person-erase reply (`DELETE /api/conversations/persons/{person_id}`).
+ * `removed` counts the answer records deleted across the person's routes; `erased`
+ * says whether THIS call removed the person row (`false` on a retry or an
+ * already-gone person — never a 404).
+ */
+export const conversationPersonDeleted = z.object({
+    person_id: z.string(),
+    removed: z.number(),
+    erased: z.boolean(),
+});
+//# sourceMappingURL=conversations.js.map

package/dist/schemas/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/schemas/conversations.ts"],"names":[],"mappings":"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"}

package/dist/schemas/extensions.d.ts

@@ -0,0 +1,44 @@
+/** Extension element/combo and per-tool extension response schemas. */
+import { z } from 'zod';
+export declare const extension: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodString;
+}, z.core.$strip>;
+export declare const extensions: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodString;
+}, z.core.$strip>>;
+export type Extension = z.infer<typeof extension>;
+/**
+ * One element of an extension combo: a bare extension NAME, or a
+ * `{ name, config }` mapping binding author config (e.g. an `output_schema` JSON
+ * Schema, or an `ask_external` verifier). Both wire forms are admitted so a
+ * config-bearing combo parses without dropping server data. A drift throws
+ * `ApiSchemaError`.
+ */
+export declare const presetExtensionElement: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>]>;
+export type PresetExtensionElement = z.infer<typeof presetExtensionElement>;
+/**
+ * `GET /api/tools/{name}/extensions` — a tool's FULL lossless list-of-combos plus
+ * the extension catalog. `combos` is a list of combos, each an ordered list of
+ * extension ELEMENTS (a bare name or a config-bearing `{ name, config }` mapping —
+ * `output_schema` carries its schema this way); `[]` when the tool has no map entry.
+ * It carries EVERY combo mapped to the base tool (the union across every `tools`/`mcp`
+ * config), never a single flattened one. `available` is the same flat catalog
+ * `GET /api/extensions` returns. A drift throws `ApiSchemaError`.
+ */
+export declare const toolExtensions: z.ZodObject<{
+    combos: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>]>>>;
+    available: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ToolExtensions = z.infer<typeof toolExtensions>;
+//# sourceMappingURL=extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/schemas/extensions.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS;;;iBAAmD,CAAC;AAC1E,eAAO,MAAM,UAAU;;;kBAAqB,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;mBAGjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;iBAGzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/extensions.js

@@ -0,0 +1,29 @@
+/** Extension element/combo and per-tool extension response schemas. */
+import { z } from 'zod';
+export const extension = z.object({ name: z.string(), kind: z.string() });
+export const extensions = z.array(extension);
+/**
+ * One element of an extension combo: a bare extension NAME, or a
+ * `{ name, config }` mapping binding author config (e.g. an `output_schema` JSON
+ * Schema, or an `ask_external` verifier). Both wire forms are admitted so a
+ * config-bearing combo parses without dropping server data. A drift throws
+ * `ApiSchemaError`.
+ */
+export const presetExtensionElement = z.union([
+    z.string(),
+    z.object({ name: z.string(), config: z.record(z.string(), z.unknown()) }),
+]);
+/**
+ * `GET /api/tools/{name}/extensions` — a tool's FULL lossless list-of-combos plus
+ * the extension catalog. `combos` is a list of combos, each an ordered list of
+ * extension ELEMENTS (a bare name or a config-bearing `{ name, config }` mapping —
+ * `output_schema` carries its schema this way); `[]` when the tool has no map entry.
+ * It carries EVERY combo mapped to the base tool (the union across every `tools`/`mcp`
+ * config), never a single flattened one. `available` is the same flat catalog
+ * `GET /api/extensions` returns. A drift throws `ApiSchemaError`.
+ */
+export const toolExtensions = z.object({
+    combos: z.array(z.array(presetExtensionElement)),
+    available: extensions,
+});
+//# sourceMappingURL=extensions.js.map

package/dist/schemas/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/schemas/extensions.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAG7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC5C,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;CAC1E,CAAC,CAAC;AAGH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,SAAS,EAAE,UAAU;CACtB,CAAC,CAAC"}

package/dist/schemas/fleet.d.ts

@@ -0,0 +1,271 @@
+/** Backend identity and worker-bus fleet/fan-out response schemas. */
+import { z } from 'zod';
+/** `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 declare const backendInfo: z.ZodObject<{
+    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
+ * `backend` runtime process. A drift throws `ApiSchemaError`. */
+export declare const workerKind: z.ZodEnum<{
+    backend: "backend";
+    serve: "serve";
+}>;
+export type WorkerKind = z.infer<typeof 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 declare const workerState: z.ZodEnum<{
+    ready: "ready";
+    resyncing: "resyncing";
+    recycling: "recycling";
+}>;
+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<{
+    op: z.ZodString;
+    outcome: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strip>;
+export type WorkerLastOp = z.infer<typeof workerLastOp>;
+/**
+ * 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
+ * counter minted with the worker's claim; `kind` tells the two worker kinds apart;
+ * `pid` is the process id. `joined_at`/`beat_at` are ISO instants (first-seen and last
+ * heartbeat) for the cosmetic seen-since display; `state` is the advertised lifecycle
+ * state; `stale` is SERVER-computed from the row's remaining presence TTL against the
+ * bus cadence (a quiet row past the freshness bound — reconnecting or dead) and is the
+ * 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 declare const fleetWorker: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        backend: "backend";
+        serve: "serve";
+    }>;
+    pid: z.ZodNumber;
+    generation: z.ZodNumber;
+    joined_at: z.ZodString;
+    beat_at: z.ZodString;
+    state: z.ZodEnum<{
+        ready: "ready";
+        resyncing: "resyncing";
+        recycling: "recycling";
+    }>;
+    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>;
+/**
+ * `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 declare const fleetWorkers: z.ZodObject<{
+    workers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            backend: "backend";
+            serve: "serve";
+        }>;
+        pid: z.ZodNumber;
+        generation: z.ZodNumber;
+        joined_at: z.ZodString;
+        beat_at: z.ZodString;
+        state: z.ZodEnum<{
+            ready: "ready";
+            resyncing: "resyncing";
+            recycling: "recycling";
+        }>;
+        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>;
+/**
+ * One worker's outcome within a fleet broadcast. `applied`/`failed` are terminal wire
+ * replies from a subscriber; `missing`/`departed`/`timed_out` are publisher-computed
+ * from the presence census (a silent worker never sends them); `resyncing`/`recycling`/
+ * `stale` are the gap outcomes for a row that failed the ready+fresh gate — reported as
+ * its own actual condition rather than dropped (`resyncing` converges on its resync,
+ * `recycling` is departing, `stale` is a quiet row past the freshness bound carrying no
+ * convergence promise).
+ */
+export declare const fleetOutcome: z.ZodEnum<{
+    failed: "failed";
+    resyncing: "resyncing";
+    recycling: "recycling";
+    stale: "stale";
+    applied: "applied";
+    missing: "missing";
+    departed: "departed";
+    timed_out: "timed_out";
+}>;
+export type FleetOutcome = z.infer<typeof fleetOutcome>;
+/**
+ * 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 declare const fleetWorkerResult: z.ZodObject<{
+    name: z.ZodString;
+    outcome: z.ZodEnum<{
+        failed: "failed";
+        resyncing: "resyncing";
+        recycling: "recycling";
+        stale: "stale";
+        applied: "applied";
+        missing: "missing";
+        departed: "departed";
+        timed_out: "timed_out";
+    }>;
+    payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    error: z.ZodNullable<z.ZodString>;
+    detail: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type FleetWorkerResult = z.infer<typeof fleetWorkerResult>;
+/**
+ * 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
+ * worker (the serving worker's own entry included) plus the gap rows, so an unconfirmed
+ * sibling is a visible `failed`/`missing`/`departed`/`timed_out`/`resyncing`/`recycling`/
+ * `stale` entry, never a silent stale worker. Bus-unreachable (`reachable: false`): the
+ * transport failed before any worker could reply, so `results` is empty and only `error`
+ * is carried. This is the bare body of `POST /api/fleet/reload-config` and the single-MCP
+ * reload; it is also the body the mode-wrapped {@link fleetReportFanout} carries under its
+ * `fleet` / `unreachable` modes.
+ */
+export declare const fleetResult: z.ZodObject<{
+    op: z.ZodString;
+    reachable: z.ZodBoolean;
+    local_only: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
+            applied: "applied";
+            missing: "missing";
+            departed: "departed";
+            timed_out: "timed_out";
+        }>;
+        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>;
+}, z.core.$strip>;
+export type FleetResult = z.infer<typeof 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
+ * names every worker's outcome. A failed local apply does not abort the broadcast, so
+ * the report is embedded even on the convergence-failure path.
+ */
+export declare const fleetReloadResult: z.ZodObject<{
+    op: z.ZodString;
+    reachable: z.ZodBoolean;
+    local_only: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
+            applied: "applied";
+            missing: "missing";
+            departed: "departed";
+            timed_out: "timed_out";
+        }>;
+        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>;
+}, 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<{
+    op: z.ZodString;
+    reachable: z.ZodBoolean;
+    local_only: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
+            applied: "applied";
+            missing: "missing";
+            departed: "departed";
+            timed_out: "timed_out";
+        }>;
+        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>;
+    mode: z.ZodLiteral<"fleet">;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodString;
+    reachable: z.ZodBoolean;
+    local_only: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            resyncing: "resyncing";
+            recycling: "recycling";
+            stale: "stale";
+            applied: "applied";
+            missing: "missing";
+            departed: "departed";
+            timed_out: "timed_out";
+        }>;
+        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>;
+    mode: z.ZodLiteral<"unreachable">;
+}, z.core.$strip>], "mode">;
+export type FleetReportFanout = z.infer<typeof fleetReportFanout>;
+//# sourceMappingURL=fleet.d.ts.map

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

@@ -0,0 +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"}