@aeolus-fleet/common 0.34.0 → 0.35.0

package/dist/schemas/alert.d.ts

@@ -0,0 +1,564 @@
+import { z } from 'zod';
+/**
+ * Alerts (decision 0071, docs/design/monitoring 4.4, 4.5 and 4.9): the watch
+ * raises one in core per occurrence of a signal on a ship, then sends the
+ * owner's ship the alert message. Core holds the alert and never speaks for
+ * a ship; the message is the watch's. Both read the signal and its facts
+ * from here.
+ */
+/** The content type of the alert message the watch sends (4.9). */
+export declare const ALERT_CONTENT_TYPE = "application/vnd.aeolus.alert+json";
+/** What parted (4.4): the four distribution signals, then the two expectations. */
+export declare const ALERT_SIGNALS: readonly ["crew-request-unassigned", "delivery-unacknowledged", "delivery-overdue", "ping-unanswered", "report-unchanged", "task-not-done"];
+export declare const alertSignalSchema: z.ZodEnum<{
+    "crew-request-unassigned": "crew-request-unassigned";
+    "delivery-unacknowledged": "delivery-unacknowledged";
+    "delivery-overdue": "delivery-overdue";
+    "ping-unanswered": "ping-unanswered";
+    "report-unchanged": "report-unchanged";
+    "task-not-done": "task-not-done";
+}>;
+export type AlertSignal = z.infer<typeof alertSignalSchema>;
+/** The longest headline an alert message carries: an inbox shows it first (instruction 6). */
+export declare const ALERT_HEADLINE_MAX_LENGTH = 80;
+/** The most bytes an alert message's markdown body takes. */
+export declare const ALERT_BODY_MAX_BYTES: number;
+/** The most bytes a whole alert message payload takes, as JSON. */
+export declare const ALERT_PAYLOAD_MAX_BYTES: number;
+/** The longest occurrence key a raise names (4.4: a delivery id, a version, a time). */
+export declare const ALERT_OCCURRENCE_KEY_MAX_LENGTH = 200;
+/** A signal with its facts at raise. */
+export declare const alertSignalFactsSchema: z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    signal: z.ZodLiteral<"crew-request-unassigned">;
+    facts: z.ZodObject<{
+        settingsVersion: z.ZodInt;
+        minutes: z.ZodInt;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-unacknowledged">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            received: "received";
+            handed: "handed";
+        }>;
+        awaitingCrew: z.ZodBoolean;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-overdue">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        overdueEventId: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"ping-unanswered">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"report-unchanged">;
+    facts: z.ZodObject<{
+        reportChangedAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+        }>;
+        minutes: z.ZodInt;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"task-not-done">;
+    facts: z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>], "signal">;
+export type AlertSignalFacts = z.infer<typeof alertSignalFactsSchema>;
+/**
+ * The alert message's payload (4.9): the alert in core, the line an inbox
+ * shows first and the facts in words, the signal with its facts at raise,
+ * the ship, its fleet, and why this recipient is told.
+ */
+export declare const alertMessageSchema: z.ZodIntersection<z.ZodObject<{
+    alertId: z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>;
+    headline: z.ZodString;
+    body: z.ZodString;
+    ship: z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    fleetId: z.ZodType<`flt_${string}`, unknown, z.core.$ZodTypeInternals<`flt_${string}`, unknown>>;
+    toldAs: z.ZodEnum<{
+        owner: "owner";
+        setter: "setter";
+    }>;
+    since: z.ZodISODateTime;
+    raisedAt: z.ZodISODateTime;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    signal: z.ZodLiteral<"crew-request-unassigned">;
+    facts: z.ZodObject<{
+        settingsVersion: z.ZodInt;
+        minutes: z.ZodInt;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-unacknowledged">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            received: "received";
+            handed: "handed";
+        }>;
+        awaitingCrew: z.ZodBoolean;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-overdue">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        overdueEventId: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"ping-unanswered">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"report-unchanged">;
+    facts: z.ZodObject<{
+        reportChangedAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+        }>;
+        minutes: z.ZodInt;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"task-not-done">;
+    facts: z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>], "signal">>;
+export type AlertMessage = z.infer<typeof alertMessageSchema>;
+/**
+ * Input of `fleet.raiseAlert` (fleet:alert, 4.5): the ship, the signal and
+ * its facts at raise, the occurrence key the alert is unique by, and since
+ * when the fact parted.
+ */
+export declare const raiseAlertInputSchema: z.ZodPipe<z.ZodObject<{
+    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    signal: z.ZodEnum<{
+        "crew-request-unassigned": "crew-request-unassigned";
+        "delivery-unacknowledged": "delivery-unacknowledged";
+        "delivery-overdue": "delivery-overdue";
+        "ping-unanswered": "ping-unanswered";
+        "report-unchanged": "report-unchanged";
+        "task-not-done": "task-not-done";
+    }>;
+    facts: z.ZodUnion<readonly [z.ZodObject<{
+        settingsVersion: z.ZodInt;
+        minutes: z.ZodInt;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            received: "received";
+            handed: "handed";
+        }>;
+        awaitingCrew: z.ZodBoolean;
+        minutes: z.ZodInt;
+    }, z.core.$strict>, z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        overdueEventId: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        minutes: z.ZodInt;
+    }, z.core.$strict>, z.ZodObject<{
+        reportChangedAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+        }>;
+        minutes: z.ZodInt;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>]>;
+    occurrenceKey: z.ZodString;
+    since: z.ZodISODateTime;
+}, z.core.$strip>, z.ZodTransform<{
+    signal: "crew-request-unassigned";
+    facts: {
+        settingsVersion: number;
+        minutes: number;
+        reason: string | null;
+    };
+    shipId: `shp_${string}`;
+    occurrenceKey: string;
+    since: string;
+} | {
+    signal: "delivery-unacknowledged";
+    facts: {
+        deliveryId: `dlv_${string}`;
+        messageId: `msg_${string}`;
+        state: "pending" | "received" | "handed";
+        awaitingCrew: boolean;
+        minutes: number;
+    };
+    shipId: `shp_${string}`;
+    occurrenceKey: string;
+    since: string;
+} | {
+    signal: "delivery-overdue";
+    facts: {
+        deliveryId: `dlv_${string}`;
+        messageId: `msg_${string}`;
+        overdueEventId: `evt_${string}`;
+    };
+    shipId: `shp_${string}`;
+    occurrenceKey: string;
+    since: string;
+} | {
+    signal: "ping-unanswered";
+    facts: {
+        deliveryId: `dlv_${string}`;
+        messageId: `msg_${string}`;
+        minutes: number;
+    };
+    shipId: `shp_${string}`;
+    occurrenceKey: string;
+    since: string;
+} | {
+    signal: "report-unchanged";
+    facts: {
+        reportChangedAt: string;
+        state: "working" | "blocked";
+        minutes: number;
+        setBy: `shp_${string}`;
+    };
+    shipId: `shp_${string}`;
+    occurrenceKey: string;
+    since: string;
+} | {
+    signal: "task-not-done";
+    facts: {
+        task: {
+            [x: string]: z.core.util.JSONType;
+            kind: string;
+        };
+        doneBy: string;
+        setBy: `shp_${string}`;
+    };
+    shipId: `shp_${string}`;
+    occurrenceKey: string;
+    since: string;
+}, {
+    shipId: `shp_${string}`;
+    signal: "crew-request-unassigned" | "delivery-unacknowledged" | "delivery-overdue" | "ping-unanswered" | "report-unchanged" | "task-not-done";
+    facts: {
+        settingsVersion: number;
+        minutes: number;
+        reason: string | null;
+    } | {
+        deliveryId: `dlv_${string}`;
+        messageId: `msg_${string}`;
+        state: "pending" | "received" | "handed";
+        awaitingCrew: boolean;
+        minutes: number;
+    } | {
+        deliveryId: `dlv_${string}`;
+        messageId: `msg_${string}`;
+        overdueEventId: `evt_${string}`;
+    } | {
+        deliveryId: `dlv_${string}`;
+        messageId: `msg_${string}`;
+        minutes: number;
+    } | {
+        reportChangedAt: string;
+        state: "working" | "blocked";
+        minutes: number;
+        setBy: `shp_${string}`;
+    } | {
+        task: {
+            [x: string]: z.core.util.JSONType;
+            kind: string;
+        };
+        doneBy: string;
+        setBy: `shp_${string}`;
+    };
+    occurrenceKey: string;
+    since: string;
+}>>;
+export type RaiseAlertInput = z.infer<typeof raiseAlertInputSchema>;
+/** Input of `fleet.clearAlert` (fleet:alert): the alert to clear. */
+export declare const clearAlertInputSchema: z.ZodObject<{
+    alertId: z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>;
+}, z.core.$strip>;
+/** Why an alert cleared: its fact moved back, as the watch saw, or its ship retired. */
+export declare const ALERT_CLEARED_WHYS: readonly ["cleared", "retired"];
+export declare const alertClearedWhySchema: z.ZodEnum<{
+    retired: "retired";
+    cleared: "cleared";
+}>;
+export type AlertClearedWhy = z.infer<typeof alertClearedWhySchema>;
+/**
+ * An alert as core holds it: the ship, the signal and its facts at raise,
+ * the occurrence key, the owner told (the ship's owner at raise), since when
+ * the fact parted, when it was raised, and when and why it cleared, null
+ * while it is open.
+ */
+export declare const alertSchema: z.ZodIntersection<z.ZodObject<{
+    id: z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>;
+    ship: z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    occurrenceKey: z.ZodString;
+    ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    since: z.ZodISODateTime;
+    raisedAt: z.ZodISODateTime;
+    cleared: z.ZodNullable<z.ZodObject<{
+        at: z.ZodISODateTime;
+        why: z.ZodEnum<{
+            retired: "retired";
+            cleared: "cleared";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    signal: z.ZodLiteral<"crew-request-unassigned">;
+    facts: z.ZodObject<{
+        settingsVersion: z.ZodInt;
+        minutes: z.ZodInt;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-unacknowledged">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            received: "received";
+            handed: "handed";
+        }>;
+        awaitingCrew: z.ZodBoolean;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-overdue">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        overdueEventId: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"ping-unanswered">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"report-unchanged">;
+    facts: z.ZodObject<{
+        reportChangedAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+        }>;
+        minutes: z.ZodInt;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"task-not-done">;
+    facts: z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>], "signal">>;
+export type AlertOutput = z.infer<typeof alertSchema>;
+/** Output of `fleet.raiseAlert` and `fleet.clearAlert`: the alert as core holds it now. */
+export declare const alertOutputSchema: z.ZodIntersection<z.ZodObject<{
+    id: z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>;
+    ship: z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    occurrenceKey: z.ZodString;
+    ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    since: z.ZodISODateTime;
+    raisedAt: z.ZodISODateTime;
+    cleared: z.ZodNullable<z.ZodObject<{
+        at: z.ZodISODateTime;
+        why: z.ZodEnum<{
+            retired: "retired";
+            cleared: "cleared";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    signal: z.ZodLiteral<"crew-request-unassigned">;
+    facts: z.ZodObject<{
+        settingsVersion: z.ZodInt;
+        minutes: z.ZodInt;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-unacknowledged">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        state: z.ZodEnum<{
+            pending: "pending";
+            received: "received";
+            handed: "handed";
+        }>;
+        awaitingCrew: z.ZodBoolean;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"delivery-overdue">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        overdueEventId: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"ping-unanswered">;
+    facts: z.ZodObject<{
+        deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+        messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+        minutes: z.ZodInt;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"report-unchanged">;
+    facts: z.ZodObject<{
+        reportChangedAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            working: "working";
+            blocked: "blocked";
+        }>;
+        minutes: z.ZodInt;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    signal: z.ZodLiteral<"task-not-done">;
+    facts: z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+        setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strict>;
+}, z.core.$strip>], "signal">>;
+/** Input of `fleet.openAlerts` (fleet:read): the cursor and size of a page. */
+export declare const openAlertsInputSchema: z.ZodOptional<z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>>;
+    limit: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>>;
+/** Output of `fleet.openAlerts`: a page of the fleet's open alerts on the ships the caller reads, newest first. */
+export declare const openAlertsOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodIntersection<z.ZodObject<{
+        id: z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>;
+        ship: z.ZodObject<{
+            id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        occurrenceKey: z.ZodString;
+        ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+        since: z.ZodISODateTime;
+        raisedAt: z.ZodISODateTime;
+        cleared: z.ZodNullable<z.ZodObject<{
+            at: z.ZodISODateTime;
+            why: z.ZodEnum<{
+                retired: "retired";
+                cleared: "cleared";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+        signal: z.ZodLiteral<"crew-request-unassigned">;
+        facts: z.ZodObject<{
+            settingsVersion: z.ZodInt;
+            minutes: z.ZodInt;
+            reason: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        signal: z.ZodLiteral<"delivery-unacknowledged">;
+        facts: z.ZodObject<{
+            deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+            messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+            state: z.ZodEnum<{
+                pending: "pending";
+                received: "received";
+                handed: "handed";
+            }>;
+            awaitingCrew: z.ZodBoolean;
+            minutes: z.ZodInt;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        signal: z.ZodLiteral<"delivery-overdue">;
+        facts: z.ZodObject<{
+            deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+            messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+            overdueEventId: z.ZodType<`evt_${string}`, unknown, z.core.$ZodTypeInternals<`evt_${string}`, unknown>>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        signal: z.ZodLiteral<"ping-unanswered">;
+        facts: z.ZodObject<{
+            deliveryId: z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>;
+            messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;
+            minutes: z.ZodInt;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        signal: z.ZodLiteral<"report-unchanged">;
+        facts: z.ZodObject<{
+            reportChangedAt: z.ZodISODateTime;
+            state: z.ZodEnum<{
+                working: "working";
+                blocked: "blocked";
+            }>;
+            minutes: z.ZodInt;
+            setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        signal: z.ZodLiteral<"task-not-done">;
+        facts: z.ZodObject<{
+            task: z.ZodObject<{
+                kind: z.ZodString;
+            }, z.core.$catchall<z.ZodJSONSchema>>;
+            doneBy: z.ZodISODateTime;
+            setBy: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        }, z.core.$strict>;
+    }, z.core.$strip>], "signal">>>;
+    nextCursor: z.ZodNullable<z.ZodType<`alt_${string}`, unknown, z.core.$ZodTypeInternals<`alt_${string}`, unknown>>>;
+}, z.core.$strip>;