@aeolus-fleet/common 0.34.0 → 0.36.0

package/dist/schemas/alert.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+import { idSchema } from '../ids/index.js';
+import { payloadBytes } from '../rules/payload.js';
+import { pageInputOf, pageOutputOf } from './page.js';
+import { reportTaskSchema } from './report.js';
+/**
+ * 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 const ALERT_CONTENT_TYPE = 'application/vnd.aeolus.alert+json';
+/** What parted (4.4): the four distribution signals, then the two expectations. */
+export const ALERT_SIGNALS = ['crew-request-unassigned', 'delivery-unacknowledged', 'delivery-overdue', 'ping-unanswered', 'report-unchanged', 'task-not-done'];
+export const alertSignalSchema = z.enum(ALERT_SIGNALS);
+/** The longest headline an alert message carries: an inbox shows it first (instruction 6). */
+export const ALERT_HEADLINE_MAX_LENGTH = 80;
+/** The most bytes an alert message's markdown body takes. */
+export const ALERT_BODY_MAX_BYTES = 2 * 1024;
+/** The most bytes a whole alert message payload takes, as JSON. */
+export const ALERT_PAYLOAD_MAX_BYTES = 8 * 1024;
+/** The longest occurrence key a raise names (4.4: a delivery id, a version, a time). */
+export const ALERT_OCCURRENCE_KEY_MAX_LENGTH = 200;
+const isoTime = z.iso.datetime({ offset: true });
+const minutesSchema = z.int().min(1);
+/** The facts at raise of each signal (4.9). */
+const crewRequestUnassignedFactsSchema = z.strictObject({ settingsVersion: z.int().min(1), minutes: minutesSchema, reason: z.string().nullable() });
+const deliveryUnacknowledgedFactsSchema = z.strictObject({
+    deliveryId: idSchema('delivery'),
+    messageId: idSchema('message'),
+    state: z.enum(['pending', 'received', 'handed']),
+    awaitingCrew: z.boolean(),
+    minutes: minutesSchema,
+});
+const deliveryOverdueFactsSchema = z.strictObject({ deliveryId: idSchema('delivery'), messageId: idSchema('message'), overdueEventId: idSchema('event') });
+const pingUnansweredFactsSchema = z.strictObject({ deliveryId: idSchema('delivery'), messageId: idSchema('message'), minutes: minutesSchema });
+const reportUnchangedFactsSchema = z.strictObject({ reportChangedAt: isoTime, state: z.enum(['working', 'blocked']), minutes: minutesSchema, setBy: idSchema('ship') });
+const taskNotDoneFactsSchema = z.strictObject({ task: reportTaskSchema, doneBy: isoTime, setBy: idSchema('ship') });
+const alertFactsBySignal = [
+    z.object({ signal: z.literal('crew-request-unassigned'), facts: crewRequestUnassignedFactsSchema }),
+    z.object({ signal: z.literal('delivery-unacknowledged'), facts: deliveryUnacknowledgedFactsSchema }),
+    z.object({ signal: z.literal('delivery-overdue'), facts: deliveryOverdueFactsSchema }),
+    z.object({ signal: z.literal('ping-unanswered'), facts: pingUnansweredFactsSchema }),
+    z.object({ signal: z.literal('report-unchanged'), facts: reportUnchangedFactsSchema }),
+    z.object({ signal: z.literal('task-not-done'), facts: taskNotDoneFactsSchema }),
+];
+/** A signal with its facts at raise. */
+export const alertSignalFactsSchema = z.discriminatedUnion('signal', alertFactsBySignal);
+/**
+ * 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 const alertMessageSchema = z
+    .intersection(z.object({
+    alertId: idSchema('alert'),
+    headline: z.string().min(1).max(ALERT_HEADLINE_MAX_LENGTH),
+    body: z.string().refine((body) => payloadBytes(body) <= ALERT_BODY_MAX_BYTES, `A body is at most ${String(ALERT_BODY_MAX_BYTES)} bytes`),
+    ship: z.object({ id: idSchema('ship'), name: z.string() }),
+    fleetId: idSchema('fleet'),
+    toldAs: z.enum(['owner', 'setter']),
+    since: isoTime,
+    raisedAt: isoTime,
+}), alertSignalFactsSchema)
+    .refine((message) => payloadBytes(JSON.stringify(message)) <= ALERT_PAYLOAD_MAX_BYTES, `An alert message is at most ${String(ALERT_PAYLOAD_MAX_BYTES)} bytes`);
+/**
+ * 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 const raiseAlertInputSchema = z
+    .object({
+    shipId: idSchema('ship'),
+    signal: alertSignalSchema,
+    facts: z.union([
+        crewRequestUnassignedFactsSchema,
+        deliveryUnacknowledgedFactsSchema,
+        deliveryOverdueFactsSchema,
+        pingUnansweredFactsSchema,
+        reportUnchangedFactsSchema,
+        taskNotDoneFactsSchema,
+    ]),
+    occurrenceKey: z.string().min(1).max(ALERT_OCCURRENCE_KEY_MAX_LENGTH),
+    since: isoTime,
+})
+    // One object for the doors' JSON Schema; the facts must be the signal's.
+    .transform(({ shipId, signal, facts, occurrenceKey, since }, context) => {
+    const signalFacts = alertSignalFactsSchema.safeParse({ signal, facts });
+    if (!signalFacts.success) {
+        context.addIssue({ code: 'custom', message: "The facts are not the signal's", path: ['facts'] });
+        return z.NEVER;
+    }
+    return { shipId, occurrenceKey, since, ...signalFacts.data };
+});
+/** Input of `fleet.clearAlert` (fleet:alert): the alert to clear. */
+export const clearAlertInputSchema = z.object({ alertId: idSchema('alert') });
+/** Why an alert cleared: its fact moved back, as the watch saw, or its ship retired. */
+export const ALERT_CLEARED_WHYS = ['cleared', 'retired'];
+export const alertClearedWhySchema = z.enum(ALERT_CLEARED_WHYS);
+/**
+ * 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 const alertSchema = z.intersection(z.object({
+    id: idSchema('alert'),
+    ship: z.object({ id: idSchema('ship'), name: z.string() }),
+    occurrenceKey: z.string(),
+    ownerShipId: idSchema('ship').nullable(),
+    since: z.iso.datetime(),
+    raisedAt: z.iso.datetime(),
+    cleared: z.object({ at: z.iso.datetime(), why: alertClearedWhySchema }).nullable(),
+}), alertSignalFactsSchema);
+/** Output of `fleet.raiseAlert` and `fleet.clearAlert`: the alert as core holds it now. */
+export const alertOutputSchema = alertSchema;
+/** Input of `fleet.openAlerts` (fleet:read): the cursor and size of a page. */
+export const openAlertsInputSchema = pageInputOf(idSchema('alert')).optional();
+/** Output of `fleet.openAlerts`: a page of the fleet's open alerts on the ships the caller reads, newest first. */
+export const openAlertsOutputSchema = pageOutputOf(alertSchema, idSchema('alert'));
+//# sourceMappingURL=alert.js.map

package/dist/schemas/alert.js.map

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

package/dist/schemas/content-type.d.ts

@@ -0,0 +1,2 @@
+/** A content type's essence: media types compare without case and without their parameters (RFC 9110). */
+export declare function essenceOf(contentType: string): string;

package/dist/schemas/content-type.js

@@ -0,0 +1,6 @@
+/** A content type's essence: media types compare without case and without their parameters (RFC 9110). */
+export function essenceOf(contentType) {
+    const [essence = ''] = contentType.split(';');
+    return essence.trim().toLowerCase();
+}
+//# sourceMappingURL=content-type.js.map

package/dist/schemas/content-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.js","sourceRoot":"","sources":["../../src/schemas/content-type.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC"}

package/dist/schemas/delivery.d.ts

@@ -9,7 +9,7 @@ import { z } from 'zod';
 export declare const RECEIVE_MAX_DEFAULT = 1;
 /**
  * The most deliveries one receive returns. The ship chooses up to this many
- * (ADR 0016); the bound keeps one answer at ten 64 KB payloads.
+ * (ADR 0016); the bound keeps one answer at ten 256 KB payloads.
  */
 export declare const RECEIVE_MAX_UPPER_BOUND = 10;
 /** Input of `ship.receive`: at most how many deliveries to return, 1 to 10. Without it, one. */
@@ -302,6 +302,97 @@ export declare const deliveryOutputSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export type DeliveryOutput = z.infer<typeof deliveryOutputSchema>;
+/**
+ * Input of `ship.record`: the cursor the last page answered, none for the
+ * newest, and the page size, at most RECORD_PAGE_SIZE_MAX (Bridge, CC12).
+ */
+export declare const recordInputSchema: z.ZodOptional<z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>>;
+    limit: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>>;
+export type RecordInput = z.infer<typeof recordInputSchema>;
+/**
+ * One delivery of `ship.record`: as a receive hands one, with its state; in a
+ * sealed fleet a payload whose data key cannot be had is empty and marked
+ * unreadable (decision 0068, B9).
+ */
+export declare const recordEntrySchema: 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>>;
+    senderShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    senderName: z.ZodString;
+    senderType: z.ZodString;
+    recipient: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"ship">;
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"type">;
+        type: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    payload: z.ZodString;
+    contentType: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+    inReplyTo: z.ZodNullable<z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>>;
+    sentAt: z.ZodISODateTime;
+    isForced: z.ZodBoolean;
+    meetingId: z.ZodNullable<z.ZodType<`mtg_${string}`, unknown, z.core.$ZodTypeInternals<`mtg_${string}`, unknown>>>;
+    scheduleId: z.ZodNullable<z.ZodType<`sch_${string}`, unknown, z.core.$ZodTypeInternals<`sch_${string}`, unknown>>>;
+    sendTime: z.ZodNullable<z.ZodISODateTime>;
+    attempts: z.ZodInt;
+    state: z.ZodEnum<{
+        pending: "pending";
+        received: "received";
+        handed: "handed";
+        acknowledged: "acknowledged";
+        handled: "handled";
+        notHandled: "notHandled";
+        undeliverable: "undeliverable";
+        dismissed: "dismissed";
+        abandoned: "abandoned";
+    }>;
+    isPayloadUnreadable: z.ZodBoolean;
+}, z.core.$strip>;
+/** Output of `ship.record`: a page of the crew's ship's deliveries, newest first, and the cursor of the next; null on the last. */
+export declare const recordOutputSchema: z.ZodObject<{
+    items: z.ZodArray<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>>;
+        senderShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        senderName: z.ZodString;
+        senderType: z.ZodString;
+        recipient: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"ship">;
+            shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"type">;
+            type: z.ZodString;
+        }, z.core.$strip>], "kind">;
+        payload: z.ZodString;
+        contentType: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        inReplyTo: z.ZodNullable<z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>>;
+        sentAt: z.ZodISODateTime;
+        isForced: z.ZodBoolean;
+        meetingId: z.ZodNullable<z.ZodType<`mtg_${string}`, unknown, z.core.$ZodTypeInternals<`mtg_${string}`, unknown>>>;
+        scheduleId: z.ZodNullable<z.ZodType<`sch_${string}`, unknown, z.core.$ZodTypeInternals<`sch_${string}`, unknown>>>;
+        sendTime: z.ZodNullable<z.ZodISODateTime>;
+        attempts: z.ZodInt;
+        state: z.ZodEnum<{
+            pending: "pending";
+            received: "received";
+            handed: "handed";
+            acknowledged: "acknowledged";
+            handled: "handled";
+            notHandled: "notHandled";
+            undeliverable: "undeliverable";
+            dismissed: "dismissed";
+            abandoned: "abandoned";
+        }>;
+        isPayloadUnreadable: z.ZodBoolean;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodType<`dlv_${string}`, unknown, z.core.$ZodTypeInternals<`dlv_${string}`, unknown>>>;
+}, z.core.$strip>;
+export type RecordOutput = z.infer<typeof recordOutputSchema>;
 /** Input of `ship.sentMessage`: a message the caller sent. */
 export declare const sentMessageInputSchema: z.ZodObject<{
     messageId: z.ZodType<`msg_${string}`, unknown, z.core.$ZodTypeInternals<`msg_${string}`, unknown>>;

package/dist/schemas/delivery.js

@@ -2,6 +2,8 @@ import { z } from 'zod';
 import { deliveryStateSchema } from '../fleet/index.js';
 import { idSchema } from '../ids/index.js';
 import { leaseWakerSchema, partySchema } from './history.js';
+import { pageOutputOf } from './page.js';
+import { RECORD_PAGE_SIZE_MAX } from '../rules/page-size.js';
 import { isOneLine } from './report.js';
 /**
  * Inputs and outputs of receiving and acknowledging deliveries (`ship.receive`
@@ -13,7 +15,7 @@ import { isOneLine } from './report.js';
 export const RECEIVE_MAX_DEFAULT = 1;
 /**
  * The most deliveries one receive returns. The ship chooses up to this many
- * (ADR 0016); the bound keeps one answer at ten 64 KB payloads.
+ * (ADR 0016); the bound keeps one answer at ten 256 KB payloads.
  */
 export const RECEIVE_MAX_UPPER_BOUND = 10;
 /** Input of `ship.receive`: at most how many deliveries to return, 1 to 10. Without it, one. */
@@ -163,6 +165,21 @@ export const deliveryOutputSchema = receivedDeliverySchema.extend({
     attempts: z.int().min(0),
     state: deliveryStateSchema,
 });
+/**
+ * Input of `ship.record`: the cursor the last page answered, none for the
+ * newest, and the page size, at most RECORD_PAGE_SIZE_MAX (Bridge, CC12).
+ */
+export const recordInputSchema = z
+    .object({ cursor: idSchema('delivery').optional(), limit: z.int().min(1).max(RECORD_PAGE_SIZE_MAX).optional() })
+    .optional();
+/**
+ * One delivery of `ship.record`: as a receive hands one, with its state; in a
+ * sealed fleet a payload whose data key cannot be had is empty and marked
+ * unreadable (decision 0068, B9).
+ */
+export const recordEntrySchema = deliveryOutputSchema.extend({ isPayloadUnreadable: z.boolean() });
+/** Output of `ship.record`: a page of the crew's ship's deliveries, newest first, and the cursor of the next; null on the last. */
+export const recordOutputSchema = pageOutputOf(recordEntrySchema, idSchema('delivery'));
 /** Input of `ship.sentMessage`: a message the caller sent. */
 export const sentMessageInputSchema = z.object({ messageId: idSchema('message') });
 /**

package/dist/schemas/delivery.js.map

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

package/dist/schemas/expectations.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+/**
+ * Expectations on a ship (decision 0071, docs/design/monitoring 4.7): what
+ * its owner, or a ship the fleet's rules let manage it, expects of it,
+ * standing, at most one of each. Core holds them and compares nothing; the
+ * watch compares them with the ship's report and tells.
+ */
+/** The fewest minutes "report changes within" may expect. */
+export declare const REPORT_CHANGES_WITHIN_MIN_MINUTES = 5;
+/** The most minutes "report changes within" may expect: a week. */
+export declare const REPORT_CHANGES_WITHIN_MAX_MINUTES = 10080;
+/** Minutes within which the report is expected to change, while it says working or blocked. */
+export declare const reportChangesWithinMinutesSchema: z.ZodInt;
+/**
+ * Input of `fleet.setExpectations` (fleet:manage, manage reach on the ship):
+ * `reportChangesWithin` in minutes, and `taskDoneBy`, the task it is set for
+ * and the time it is expected done by. Left out, one stays as it is; null
+ * clears it.
+ */
+export declare const setExpectationsInputSchema: z.ZodObject<{
+    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    reportChangesWithin: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    taskDoneBy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SetExpectationsInput = z.infer<typeof setExpectationsInputSchema>;
+/** Output of `fleet.setExpectations`: nothing; read them back with the ship (`fleet.ship`). */
+export declare const setExpectationsOutputSchema: z.ZodObject<{}, z.core.$strict>;
+/** Who set an expectation, as decision 0057 names an actor: an account by its id only. */
+export declare const expectationSetterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"ship">;
+    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"account">;
+    accountId: z.core.$ZodBranded<z.ZodString, "AccountId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"installation">;
+}, z.core.$strip>], "kind">;
+export type ExpectationSetter = z.infer<typeof expectationSetterSchema>;
+/** A ship's expectations as `fleet.ship` reads them back (ISO 8601 in UTC): each with who set it and when; null while not set. */
+export declare const expectationsSchema: z.ZodObject<{
+    reportChangesWithin: z.ZodNullable<z.ZodObject<{
+        minutes: z.ZodInt;
+        setBy: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"ship">;
+            shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"account">;
+            accountId: z.core.$ZodBranded<z.ZodString, "AccountId", "out">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"installation">;
+        }, z.core.$strip>], "kind">;
+        setAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    taskDoneBy: z.ZodNullable<z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>;
+        doneBy: z.ZodISODateTime;
+        setBy: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"ship">;
+            shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"account">;
+            accountId: z.core.$ZodBranded<z.ZodString, "AccountId", "out">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"installation">;
+        }, z.core.$strip>], "kind">;
+        setAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExpectationsOutput = z.infer<typeof expectationsSchema>;

package/dist/schemas/expectations.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { idSchema } from '../ids/index.js';
+import { accountIdSchema } from './account-token.js';
+import { reportTaskSchema } from './report.js';
+/**
+ * Expectations on a ship (decision 0071, docs/design/monitoring 4.7): what
+ * its owner, or a ship the fleet's rules let manage it, expects of it,
+ * standing, at most one of each. Core holds them and compares nothing; the
+ * watch compares them with the ship's report and tells.
+ */
+/** The fewest minutes "report changes within" may expect. */
+export const REPORT_CHANGES_WITHIN_MIN_MINUTES = 5;
+/** The most minutes "report changes within" may expect: a week. */
+export const REPORT_CHANGES_WITHIN_MAX_MINUTES = 10_080;
+/** Minutes within which the report is expected to change, while it says working or blocked. */
+export const reportChangesWithinMinutesSchema = z.int().min(REPORT_CHANGES_WITHIN_MIN_MINUTES).max(REPORT_CHANGES_WITHIN_MAX_MINUTES);
+/**
+ * Input of `fleet.setExpectations` (fleet:manage, manage reach on the ship):
+ * `reportChangesWithin` in minutes, and `taskDoneBy`, the task it is set for
+ * and the time it is expected done by. Left out, one stays as it is; null
+ * clears it.
+ */
+export const setExpectationsInputSchema = z.object({
+    shipId: idSchema('ship'),
+    reportChangesWithin: reportChangesWithinMinutesSchema.nullable().optional(),
+    taskDoneBy: z.object({ task: reportTaskSchema, doneBy: z.iso.datetime({ offset: true }) }).nullable().optional(),
+});
+/** Output of `fleet.setExpectations`: nothing; read them back with the ship (`fleet.ship`). */
+export const setExpectationsOutputSchema = z.strictObject({});
+/** Who set an expectation, as decision 0057 names an actor: an account by its id only. */
+export const expectationSetterSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('ship'), shipId: idSchema('ship') }),
+    z.object({ kind: z.literal('account'), accountId: accountIdSchema }),
+    z.object({ kind: z.literal('installation') }),
+]);
+/** A ship's expectations as `fleet.ship` reads them back (ISO 8601 in UTC): each with who set it and when; null while not set. */
+export const expectationsSchema = z.object({
+    reportChangesWithin: z.object({ minutes: z.int(), setBy: expectationSetterSchema, setAt: z.iso.datetime() }).nullable(),
+    taskDoneBy: z.object({ task: reportTaskSchema, doneBy: z.iso.datetime(), setBy: expectationSetterSchema, setAt: z.iso.datetime() }).nullable(),
+});
+//# sourceMappingURL=expectations.js.map

package/dist/schemas/expectations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expectations.js","sourceRoot":"","sources":["../../src/schemas/expectations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AAEnD,mEAAmE;AACnE,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC;AAExD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAEtI;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,mBAAmB,EAAE,gCAAgC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjH,CAAC,CAAC;AAIH,+FAA+F;AAC/F,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAE9D,0FAA0F;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAClE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/D,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;IACpE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;CAC9C,CAAC,CAAC;AAIH,kIAAkI;AAClI,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC/I,CAAC,CAAC"}

package/dist/schemas/fleet.d.ts

@@ -200,9 +200,33 @@ export declare const listedShipSchema: z.ZodObject<{
             idle: "idle";
         }>;
         note: z.ZodNullable<z.ZodString>;
+        task: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>>;
+        taskView: z.ZodOptional<z.ZodObject<{
+            canOpen: z.ZodBoolean;
+            fleetName: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        step: z.ZodNullable<z.ZodObject<{
+            at: z.ZodNumber;
+            of: z.ZodNumber;
+        }, z.core.$strip>>;
         reportedAt: z.ZodISODateTime;
+        reportChangedAt: z.ZodISODateTime;
         detailsVersion: z.ZodInt;
     }, z.core.$strip>>;
+    activity: z.ZodNullable<z.ZodObject<{
+        at: z.ZodISODateTime;
+        kind: z.ZodEnum<{
+            error: "error";
+            text: "text";
+            tool: "tool";
+            result: "result";
+        }>;
+        tool: z.ZodNullable<z.ZodString>;
+        reportedAt: z.ZodISODateTime;
+        intervalSeconds: z.ZodInt;
+    }, z.core.$strip>>;
     crewRequest: z.ZodNullable<z.ZodObject<{
         settingsVersion: z.ZodInt;
         requestedAt: z.ZodISODateTime;
@@ -243,6 +267,7 @@ export declare const listedShipSchema: z.ZodObject<{
     awaitingCrewSince: z.ZodNullable<z.ZodISODateTime>;
     retiredAt: z.ZodNullable<z.ZodISODateTime>;
     ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    openAlertCount: z.ZodInt;
 }, z.core.$strip>;
 export type ListedShip = z.infer<typeof listedShipSchema>;
 /** A ship outside the caller's read reach (decision 0034): its name, type and status only. */
@@ -320,9 +345,33 @@ export declare const fleetListOutputSchema: z.ZodObject<{
                 idle: "idle";
             }>;
             note: z.ZodNullable<z.ZodString>;
+            task: z.ZodNullable<z.ZodObject<{
+                kind: z.ZodString;
+            }, z.core.$catchall<z.ZodJSONSchema>>>;
+            taskView: z.ZodOptional<z.ZodObject<{
+                canOpen: z.ZodBoolean;
+                fleetName: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            step: z.ZodNullable<z.ZodObject<{
+                at: z.ZodNumber;
+                of: z.ZodNumber;
+            }, z.core.$strip>>;
             reportedAt: z.ZodISODateTime;
+            reportChangedAt: z.ZodISODateTime;
             detailsVersion: z.ZodInt;
         }, z.core.$strip>>;
+        activity: z.ZodNullable<z.ZodObject<{
+            at: z.ZodISODateTime;
+            kind: z.ZodEnum<{
+                error: "error";
+                text: "text";
+                tool: "tool";
+                result: "result";
+            }>;
+            tool: z.ZodNullable<z.ZodString>;
+            reportedAt: z.ZodISODateTime;
+            intervalSeconds: z.ZodInt;
+        }, z.core.$strip>>;
         crewRequest: z.ZodNullable<z.ZodObject<{
             settingsVersion: z.ZodInt;
             requestedAt: z.ZodISODateTime;
@@ -363,6 +412,7 @@ export declare const fleetListOutputSchema: z.ZodObject<{
         awaitingCrewSince: z.ZodNullable<z.ZodISODateTime>;
         retiredAt: z.ZodNullable<z.ZodISODateTime>;
         ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+        openAlertCount: z.ZodInt;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         name: z.ZodString;
@@ -431,9 +481,33 @@ export declare const listedShipOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
             idle: "idle";
         }>;
         note: z.ZodNullable<z.ZodString>;
+        task: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodJSONSchema>>>;
+        taskView: z.ZodOptional<z.ZodObject<{
+            canOpen: z.ZodBoolean;
+            fleetName: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        step: z.ZodNullable<z.ZodObject<{
+            at: z.ZodNumber;
+            of: z.ZodNumber;
+        }, z.core.$strip>>;
         reportedAt: z.ZodISODateTime;
+        reportChangedAt: z.ZodISODateTime;
         detailsVersion: z.ZodInt;
     }, z.core.$strip>>;
+    activity: z.ZodNullable<z.ZodObject<{
+        at: z.ZodISODateTime;
+        kind: z.ZodEnum<{
+            error: "error";
+            text: "text";
+            tool: "tool";
+            result: "result";
+        }>;
+        tool: z.ZodNullable<z.ZodString>;
+        reportedAt: z.ZodISODateTime;
+        intervalSeconds: z.ZodInt;
+    }, z.core.$strip>>;
     crewRequest: z.ZodNullable<z.ZodObject<{
         settingsVersion: z.ZodInt;
         requestedAt: z.ZodISODateTime;
@@ -474,6 +548,7 @@ export declare const listedShipOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
     awaitingCrewSince: z.ZodNullable<z.ZodISODateTime>;
     retiredAt: z.ZodNullable<z.ZodISODateTime>;
     ownerShipId: z.ZodNullable<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    openAlertCount: z.ZodInt;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
     name: z.ZodString;
@@ -626,6 +701,9 @@ export declare const liveFleetEventSchema: z.ZodObject<{
         FleetKeysRecovered: "FleetKeysRecovered";
         FeatureFlagTurnedOn: "FeatureFlagTurnedOn";
         FeatureFlagTurnedOff: "FeatureFlagTurnedOff";
+        AlertRaised: "AlertRaised";
+        AlertCleared: "AlertCleared";
+        ExpectationsSet: "ExpectationsSet";
     }>;
     occurredAt: z.ZodISODateTime;
     actorKind: z.ZodEnum<{
@@ -745,6 +823,9 @@ export declare const fleetStreamItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             FleetKeysRecovered: "FleetKeysRecovered";
             FeatureFlagTurnedOn: "FeatureFlagTurnedOn";
             FeatureFlagTurnedOff: "FeatureFlagTurnedOff";
+            AlertRaised: "AlertRaised";
+            AlertCleared: "AlertCleared";
+            ExpectationsSet: "ExpectationsSet";
         }>;
         occurredAt: z.ZodISODateTime;
         actorKind: z.ZodEnum<{

package/dist/schemas/fleet.js

@@ -7,6 +7,7 @@ import { idempotencyKeySchema } from './idempotency-key.js';
 import { listedCrewRequestSchema } from './crew-request.js';
 import { carriedLabelSchema, SHIP_LABELS_MAX } from './label.js';
 import { pageOutputOf } from './page.js';
+import { listedActivitySchema } from './activity.js';
 import { listedReportSchema } from './report.js';
 /**
  * Inputs and outputs of the fleet procedures: commission a ship, get its
@@ -171,6 +172,11 @@ export const listedShipSchema = z.object({
      * themselves. Null until the crew reports, and for a ship no session crews.
      */
     report: listedReportSchema.nullable(),
+    /**
+     * What its trierarch last observed of the crewing session (docs/design/monitoring, 4.3):
+     * null for a ship crewed by hand, before its trierarch writes any, and for a ship no session crews.
+     */
+    activity: listedActivitySchema.nullable(),
     /** The ship's crew request (decision 0029); null when it holds none. */
     crewRequest: listedCrewRequestSchema.nullable(),
     /** The label values the ship carries, with their labels, by key then value (decision 0031). */
@@ -181,6 +187,8 @@ export const listedShipSchema = z.object({
     retiredAt: z.iso.datetime().nullable(),
     /** The ship that owns it (decision 0045); null for argo and the viewer, which no ship owns. */
     ownerShipId: idSchema('ship').nullable(),
+    /** How many open alerts the ship has (decision 0071); `fleet.openAlerts` lists them. */
+    openAlertCount: z.int().min(0),
 });
 /** A ship outside the caller's read reach (decision 0034): its name, type and status only. */
 export const shipOutsideReadReachSchema = z.object({