@aeolus-fleet/core 0.24.0 → 0.25.0

package/dist/domain/shared/delivery-way.js

@@ -0,0 +1,89 @@
+import { OVERDUE_CLOCKS, } from '@aeolus-fleet/common';
+import { isDeliveryChangeType } from './history.js';
+/**
+ * The part that receives and hands over for a pushed lease's session: its
+ * trierarch, or else the plugin watcher of a session crewed by hand. A pull
+ * lease has none: its agent receives itself.
+ */
+export function computerSideOf(lease) {
+    if (!lease.isPushed) {
+        return null;
+    }
+    return lease.trierarch ? { kind: 'trierarch', trierarch: lease.trierarch } : { kind: 'pluginWatcher' };
+}
+function isOverdueClock(value) {
+    return OVERDUE_CLOCKS.some((clock) => clock === value);
+}
+/**
+ * One step of a delivery's way from its event: the ship it names, where a
+ * hand-over's session ran, the computer side that received it or handed it
+ * over, and what the event's details say of it. No step for an event that is
+ * no delivery change.
+ */
+export function deliveryStepOf(event, read) {
+    const { type, details } = event;
+    if (!isDeliveryChangeType(type)) {
+        return [];
+    }
+    const lease = typeof details.leaseId === 'string' ? read.leases.get(details.leaseId) : undefined;
+    const isTakenBySession = type === 'DeliveryReceived' || type === 'DeliveryHanded';
+    const { attempts, handOverNumber, clock, minutes } = details;
+    return [
+        {
+            seq: event.seq,
+            type,
+            occurredAt: event.occurredAt,
+            ship: type === 'MessageAccepted' || event.shipId === undefined ? null : read.party(event.shipId),
+            location: type === 'DeliveryHanded' && lease ? lease.location : null,
+            harness: type === 'DeliveryHanded' && lease ? lease.harness : null,
+            attempts: typeof attempts === 'number' ? attempts : null,
+            by: isTakenBySession && lease ? computerSideOf(lease) : null,
+            handOverNumber: typeof handOverNumber === 'number' ? handOverNumber : null,
+            isAgain: details.again === true,
+            isOnceMore: details.onceMore === true,
+            overdue: type === 'DeliveryOverdue' && isOverdueClock(clock) && typeof minutes === 'number' ? { clock, minutes } : null,
+            leaseEnd: type === 'DeliveryReturned' ? (lease?.endReason ?? null) : null,
+        },
+    ];
+}
+/** Who holds a delivery in its state: the fleet while pending, the computer side while received, the agent once handed. */
+function holderOf(state, lease) {
+    switch (state) {
+        case 'pending':
+            return { kind: 'fleet' };
+        case 'received':
+            return lease ? computerSideOf(lease) : null;
+        case 'handed':
+        case 'acknowledged':
+            return { kind: 'agent' };
+        case 'handled':
+        case 'notHandled':
+        case 'undeliverable':
+        case 'dismissed':
+        case 'abandoned':
+            return null;
+    }
+}
+/** Whether a step changed the delivery's state: an overdue clock, a receive again and a hand-over once more do not. */
+function isStateChange(step) {
+    return step.type !== 'DeliveryOverdue' && !step.isAgain && !step.isOnceMore;
+}
+/**
+ * Where a delivery stands on its way, from its state, its steps newest first,
+ * the lease that holds it or that it waits for, the overdue clock that stands
+ * and the crew request of that lease's ship.
+ */
+export function deliveryWayOf(read) {
+    const { state, history, lease, overdue, crew } = read;
+    const entered = history.find(isStateChange);
+    const lastHandOver = history.find((step) => step.type === 'DeliveryHanded');
+    return {
+        holder: holderOf(state, lease),
+        since: entered?.occurredAt ?? history.at(-1)?.occurredAt ?? new Date(0),
+        isPulled: lastHandOver?.handOverNumber === null && !lastHandOver.isOnceMore,
+        overdue,
+        lease: lease && { by: computerSideOf(lease), isEnded: lease.isEnded, turn: lease.turn },
+        crew: lease?.trierarch ? crew : null,
+    };
+}
+//# sourceMappingURL=delivery-way.js.map

package/dist/domain/shared/delivery-way.js.map

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

package/dist/domain/shared/errors.d.ts

@@ -1,6 +1,6 @@
 import { type Err } from './result.js';
 /** Every reason the domain refuses a request. */
-export type DomainErrorKind = 'ASSIGNEE_NOT_ACTIVE' | 'CLEAR_REQUEST_LIMIT_REACHED' | 'CLEAR_REQUEST_NOT_FOUND' | 'CREW_REQUEST_ALREADY_ASSIGNED' | 'CREW_REQUEST_NOT_ASSIGNED_TO_CALLER' | 'CREW_REQUEST_NOT_FOUND' | 'CREW_REQUEST_NOT_RELEASING' | 'CREW_REQUEST_RELEASING' | 'CREW_REQUEST_FINAL' | 'CREW_REQUEST_SETTINGS_CHANGED' | 'CREW_REQUEST_SETTINGS_TOO_LARGE' | 'DELIVERY_HELD_BY_ANOTHER_SHIP' | 'DELIVERY_NOT_FOUND' | 'DELIVERY_NOT_A_PING' | 'DELIVERY_NOT_IN_FLIGHT' | 'DELIVERY_NOT_OPEN' | 'DELIVERY_NOT_UNDELIVERABLE' | 'FLEET_ALREADY_EXISTS' | 'FLEET_LIMIT_REACHED' | 'FLEET_NOT_FOUND' | 'FLEET_HAS_NO_VIEWER' | 'NOTICE_NOT_FOUND' | 'NOTICE_NOT_DISMISSIBLE' | 'GUIDE_NOT_FOUND' | 'GUIDE_STEP_NOT_FOUND' | 'IDEMPOTENCY_KEY_REUSED' | 'IN_REPLY_TO_NOT_FOUND' | 'MESSAGE_LIMIT_REACHED' | 'MODEL_REQUIRED' | 'INVALID_HARNESS' | 'MODEL_FROM_ARGO' | 'INVALID_CONTENT_TYPE' | 'INVALID_EMAIL' | 'INVALID_FLEET_NAME' | 'INVALID_FOLLOW_MAX' | 'INVALID_FOLLOW_WAIT' | 'INVALID_IDEMPOTENCY_KEY' | 'INVALID_INBOX_WAIT' | 'INVALID_LABEL_KEY' | 'INVALID_LABEL_VALUE' | 'INVALID_LABEL_VALUES' | 'INVALID_LIMIT' | 'INVALID_LOCATION' | 'INVALID_NETWORK_RULES' | 'INVALID_PASSWORD' | 'INVALID_RECEIVE_MAX' | 'INVALID_CREW_REQUEST_REASON' | 'INVALID_REPORT_DETAILS' | 'INVALID_REPORT_NOTE' | 'INVALID_REPORT_STATE' | 'INVALID_SHIP_NAME' | 'INVALID_SHIP_NOTE' | 'INVALID_SHIP_TYPE' | 'LABEL_CARRIED' | 'LABEL_KEY_TAKEN' | 'LABEL_NOT_FOUND' | 'LABEL_VALUE_CARRIED' | 'LABEL_VALUE_NOT_FOUND' | 'LEASE_ENDED' | 'MESSAGE_NOT_FOUND' | 'NETWORK_PLUGIN_REGISTERED' | 'NOT_A_TRIERARCH' | 'NOT_THE_LABEL_OWNER' | 'NOT_REACHABLE' | 'NOT_THE_NETWORK_PLUGIN' | 'NOT_THE_OPERATOR_SHIP' | 'OPERATOR_EMAIL_TAKEN' | 'OPERATOR_HAS_NO_PASSWORD' | 'OPERATOR_SHIP_GETS_NO_STARTING_PROMPT' | 'OPERATOR_SHIP_HAS_NO_SECRET' | 'OPERATOR_SHIP_IS_NOT_PINGED' | 'OPERATOR_SHIP_IS_PERMANENT' | 'PAYLOAD_TOO_LARGE' | 'PING_NOT_RESENT' | 'REPORT_DETAILS_TOO_LARGE' | 'RESERVED_CONTENT_TYPE' | 'SHIP_ALREADY_RETIRED' | 'SHIP_NAME_RESERVED' | 'SHIP_NAME_TAKEN' | 'SHIP_NOT_AWAITING_CREW' | 'SHIP_NOT_CREWED' | 'SHIP_LABEL_LIMIT_REACHED' | 'SHIP_LIMIT_REACHED' | 'SHIP_NOT_FOUND' | 'SIGN_IN_TICKET_INVALID' | 'UNKNOWN_CREW_TOKEN' | 'UNRESOLVABLE_SELECTOR' | 'WRONG_EMAIL_OR_PASSWORD' | 'WRONG_SHIP_ID_OR_SECRET';
+export type DomainErrorKind = 'ASSIGNEE_NOT_ACTIVE' | 'CLEAR_REQUEST_LIMIT_REACHED' | 'CLEAR_REQUEST_NOT_FOUND' | 'CREW_REQUEST_ALREADY_ASSIGNED' | 'CREW_REQUEST_NOT_ASSIGNED_TO_CALLER' | 'CREW_REQUEST_NOT_FOUND' | 'CREW_REQUEST_NOT_RELEASING' | 'CREW_REQUEST_RELEASING' | 'CREW_REQUEST_FINAL' | 'CREW_REQUEST_SETTINGS_CHANGED' | 'CREW_REQUEST_SETTINGS_TOO_LARGE' | 'DELIVERY_HANDED_ONCE_MORE' | 'DELIVERY_HELD_BY_ANOTHER_SHIP' | 'DELIVERY_NOT_FOUND' | 'DELIVERY_NOT_A_PING' | 'DELIVERY_NOT_ACKNOWLEDGED' | 'DELIVERY_NOT_HANDED_ONCE_MORE' | 'DELIVERY_NOT_IN_FLIGHT' | 'DELIVERY_NOT_OPEN' | 'DELIVERY_NOT_UNDELIVERABLE' | 'FLEET_ALREADY_EXISTS' | 'FLEET_LIMIT_REACHED' | 'FLEET_NOT_FOUND' | 'FLEET_HAS_NO_VIEWER' | 'NOTICE_NOT_FOUND' | 'NOTICE_NOT_DISMISSIBLE' | 'GUIDE_NOT_FOUND' | 'GUIDE_STEP_NOT_FOUND' | 'IDEMPOTENCY_KEY_REUSED' | 'IN_REPLY_TO_NOT_FOUND' | 'MESSAGE_LIMIT_REACHED' | 'MODEL_REQUIRED' | 'INVALID_HARNESS' | 'MODEL_FROM_ARGO' | 'INVALID_CONTENT_TYPE' | 'INVALID_EMAIL' | 'INVALID_FLEET_NAME' | 'INVALID_FOLLOW_MAX' | 'INVALID_FOLLOW_WAIT' | 'INVALID_IDEMPOTENCY_KEY' | 'INVALID_INBOX_WAIT' | 'INVALID_LABEL_KEY' | 'INVALID_LABEL_VALUE' | 'INVALID_LABEL_VALUES' | 'INVALID_LIMIT' | 'INVALID_LOCATION' | 'INVALID_NETWORK_RULES' | 'INVALID_PASSWORD' | 'INVALID_RECEIVE_MAX' | 'INVALID_CREW_REQUEST_REASON' | 'INVALID_REPORT_DETAILS' | 'INVALID_REPORT_NOTE' | 'INVALID_REPORT_STATE' | 'INVALID_SHIP_NAME' | 'INVALID_SHIP_NOTE' | 'INVALID_SHIP_TYPE' | 'LABEL_CARRIED' | 'LABEL_KEY_TAKEN' | 'LABEL_NOT_FOUND' | 'LABEL_VALUE_CARRIED' | 'LABEL_VALUE_NOT_FOUND' | 'LEASE_ENDED' | 'MESSAGE_NOT_FOUND' | 'NETWORK_PLUGIN_REGISTERED' | 'NOT_A_TRIERARCH' | 'NOT_THE_LABEL_OWNER' | 'NOT_REACHABLE' | 'NOT_THE_NETWORK_PLUGIN' | 'NOT_THE_OPERATOR_SHIP' | 'OPERATOR_EMAIL_TAKEN' | 'OPERATOR_HAS_NO_PASSWORD' | 'OPERATOR_SHIP_GETS_NO_STARTING_PROMPT' | 'OPERATOR_SHIP_HAS_NO_SECRET' | 'OPERATOR_SHIP_IS_NOT_PINGED' | 'OPERATOR_SHIP_IS_PERMANENT' | 'PAYLOAD_TOO_LARGE' | 'PING_NOT_RESENT' | 'REPORT_DETAILS_TOO_LARGE' | 'RESERVED_CONTENT_TYPE' | 'SHIP_ALREADY_RETIRED' | 'SHIP_NAME_RESERVED' | 'SHIP_NAME_TAKEN' | 'SHIP_NOT_AWAITING_CREW' | 'SHIP_NOT_CREWED' | 'SHIP_LABEL_LIMIT_REACHED' | 'SHIP_LIMIT_REACHED' | 'SHIP_NOT_FOUND' | 'SIGN_IN_TICKET_INVALID' | 'UNKNOWN_CREW_TOKEN' | 'UNRESOLVABLE_SELECTOR' | 'WRONG_EMAIL_OR_PASSWORD' | 'WRONG_SHIP_ID_OR_SECRET';
 /**
  * Why the domain refused a request. Adapters map the kind to their own error
  * shape (a tRPC code, an exit code); the message is safe to show a caller.

package/dist/domain/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,aAAa,CAAC;AAuG5C,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAA4B,IAAO,EAAE,OAAe;IACxE,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domain/shared/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,aAAa,CAAC;AA0G5C,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAA4B,IAAO,EAAE,OAAe;IACxE,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/domain/shared/history.d.ts

@@ -1,5 +1,7 @@
-import { DELIVERY_HISTORY_TYPES, type InboxFilter, type DeliveryId, type DeliveryState, type EventId, type EventType, type FleetId, type MessageId, type ShipId } from '@aeolus-fleet/common';
+import { DELIVERY_HISTORY_TYPES, type ComputerSide, type LeaseEndReason, type InboxFilter, type DeliveryId, type DeliveryState, type EventId, type EventType, type FleetId, type MessageId, type ShipId } from '@aeolus-fleet/common';
+import type { OverdueClock, WaitingState } from '../messaging/public.js';
 import type { Location } from '../registry/public.js';
+import type { StandingOverdue, WayCrew, WayLease } from './delivery-way.js';
 import type { EventDetails } from './events.js';
 /**
  * What the console reads: a ship's timeline from the event log, its
@@ -52,9 +54,17 @@ export declare function withPing<T extends {
 export type ShownTimelineEntry = Omit<TimelineEntry, 'message'> & {
     message: WithPing<NonNullable<TimelineEntry['message']>> | null;
 };
-/** An undeliverable delivery as Needs attention answers it, its message telling whether it is a ping. */
-export type ShownUndeliverableEntry = Omit<UndeliverableEntry, 'message'> & {
-    message: WithPing<UndeliverableEntry['message']>;
+/** A delivery no ship can take as it is answered, its message telling whether it is a ping. */
+export type ShownNoShipCanTakeEntry = Omit<NoShipCanTakeEntry, 'message'> & {
+    message: WithPing<NoShipCanTakeEntry['message']>;
+};
+/** An overdue delivery as it is answered, its message telling whether it is a ping. */
+export type ShownOverdueEntry = Omit<OverdueEntry, 'message'> & {
+    message: WithPing<OverdueEntry['message']>;
+};
+/** A delivery in Needs attention as it is answered, its message telling whether it is a ping. */
+export type ShownNeedsAttentionEntry = Omit<NeedsAttentionEntry, 'message'> & {
+    message: WithPing<NeedsAttentionEntry['message']>;
 };
 /** One message with its delivery as it stands. */
 export interface HistoryMessage {
@@ -72,33 +82,112 @@ export interface HistoryMessage {
         state: DeliveryState;
         attempts: number;
         claimedBy: HistoryParty | null;
+        /** The number of its last hand-over by a pushed crew's computer side; null when a plain receive or a push receive took it last, or before any. */
+        handOverNumber: number | null;
     };
 }
-/** The events that change a delivery: stored, claimed, returned, acknowledged or undeliverable. */
+/** The events of a delivery's way: stored, received, handed, returned, acknowledged, handled or not, overdue, and its dead ends. */
 export type DeliveryChangeType = (typeof DELIVERY_HISTORY_TYPES)[number];
 export declare function isDeliveryChangeType(type: EventType): type is DeliveryChangeType;
-/** One change to a delivery. */
+/** One step of a delivery's way. */
 export interface DeliveryChange {
     seq: number;
     type: DeliveryChangeType;
     occurredAt: Date;
-    /** The ship that claimed, returned or acknowledged it; null when it was stored. */
+    /** The ship that received, was handed, returned or acknowledged it; null when it was stored. */
     ship: HistoryParty | null;
-    /** Where the claiming session ran, for a claim. */
+    /** Where the claiming session ran, for a hand-over. */
     location: Location | null;
-    /** The harness the claiming session ran in, for a claim. */
+    /** The harness the claiming session ran in, for a hand-over. */
     harness: string | null;
-    /** The claims counted by then, where the event records them. */
+    /** The attempts counted by then, where the event records them. */
     attempts: number | null;
+    /** The computer side that received it or handed it over, on a pushed lease. */
+    by: ComputerSide | null;
+    /** The number of a pushed hand-over; none for a plain receive's. */
+    handOverNumber: number | null;
+    /** A push receive of a delivery its crew already held. */
+    isAgain: boolean;
+    /** A confirmed message handed once more after its turn died. */
+    isOnceMore: boolean;
+    /** Which clock ran out and after how long, for DeliveryOverdue. */
+    overdue: {
+        clock: OverdueClock;
+        minutes: number;
+    } | null;
+    /** Why its lease ended, for DeliveryReturned. */
+    leaseEnd: LeaseEndReason | null;
+}
+/** A reply to a message. */
+export interface HistoryReply {
+    id: MessageId;
+    sender: HistoryParty;
+    sentAt: Date;
 }
-/** An undeliverable delivery, for Needs attention: its claims, since when, and its whole message. */
-export interface UndeliverableEntry {
+/**
+ * One message as the history reads it: its delivery's steps newest first,
+ * its replies oldest first, and what its way is read from: the lease that
+ * holds it or that a pending delivery to one ship waits for, the overdue
+ * clock that stands, and the crew request of that lease's ship.
+ */
+export type MessageRead = HistoryMessage & {
+    history: DeliveryChange[];
+    replies: HistoryReply[];
+    lease: WayLease | null;
+    overdue: StandingOverdue | null;
+    crew: WayCrew | null;
+};
+/**
+ * What a ship's side of the way is read from (#756): the open lease of the
+ * session crewing it, and the messages whose deliveries wait for it, oldest
+ * sent first. A delivery waits for it as the clocks count it: pending for the
+ * ship or for a type it may take, or received or handed with its open lease.
+ * Nothing waits while no session crews it.
+ */
+export interface ShipWayRead {
+    lease: WayLease | null;
+    waiting: MessageId[];
+}
+/**
+ * A delivery in Needs attention: undeliverable, or not handled after its turn
+ * died twice (decision 0040). Its claims, since when, and its whole message.
+ */
+export interface NeedsAttentionEntry {
     deliveryId: DeliveryId;
+    state: NeedsAttentionState;
     attempts: number;
-    /** When it became undeliverable. */
+    /** A pushed crew's computer side handed it over, with numbers; false when plain receives handed it. */
+    isPushed: boolean;
+    /** When it became undeliverable, or was reported not handled. */
     since: Date;
     message: Omit<HistoryMessage, 'delivery'>;
 }
+/** The delivery states Needs attention lists, each waiting for the operator to resend or dismiss it. */
+export type NeedsAttentionState = Extract<DeliveryState, 'undeliverable' | 'notHandled'>;
+/**
+ * A delivery argo was told is overdue (decision 0040): the ship whose clock
+ * ran out, the state it waits in, which clock, when argo was told, and its
+ * whole message. Listed until it clears by itself.
+ */
+export interface OverdueEntry {
+    deliveryId: DeliveryId;
+    ship: HistoryParty;
+    state: WaitingState;
+    clock: OverdueClock;
+    minutes: number;
+    toldAt: Date;
+    message: Omit<HistoryMessage, 'delivery'>;
+}
+/**
+ * A pending delivery to a type no active ship can take (decision 0041): none
+ * of the type is left, or none of the ships its sender may reach (decision
+ * 0034). Its type and its whole message; listed until a ship can take it.
+ */
+export interface NoShipCanTakeEntry {
+    deliveryId: DeliveryId;
+    type: string;
+    message: Omit<HistoryMessage, 'delivery'>;
+}
 /** A reply the inbox's ship sent to a message in its inbox. */
 export interface InboxReply {
     id: MessageId;
@@ -139,12 +228,20 @@ export interface ShipHistory {
         shipId: ShipId;
         limit: number;
     }): Promise<HistoryMessage[] | undefined>;
-    /** The message, with its delivery's changes newest first. */
-    message(fleetId: FleetId, messageId: MessageId): Promise<(HistoryMessage & {
-        history: DeliveryChange[];
-    }) | undefined>;
-    /** Every undeliverable delivery, oldest first by when it became undeliverable. */
-    undeliverable(fleetId: FleetId): Promise<UndeliverableEntry[]>;
+    /** The message, with its delivery's steps newest first and what its way is read from. */
+    message(fleetId: FleetId, messageId: MessageId): Promise<MessageRead | undefined>;
+    /** Every undeliverable or not handled delivery, oldest first by since when. */
+    needsAttention(fleetId: FleetId): Promise<NeedsAttentionEntry[]>;
+    /**
+     * Every delivery argo was told is overdue that still stands, oldest told
+     * first: still in the state it was told in, on the lease it was told on,
+     * which has not ended.
+     */
+    overdue(fleetId: FleetId): Promise<OverdueEntry[]>;
+    /** Every pending delivery to a type no active ship can take, oldest sent first. */
+    noShipCanTake(fleetId: FleetId): Promise<NoShipCanTakeEntry[]>;
+    /** What the ship's side of the way is read from: the open lease of the session crewing it and what waits for it. */
+    shipWay(fleetId: FleetId, shipId: ShipId): Promise<ShipWayRead | undefined>;
     /** The messages addressed to the ship itself that the filter keeps, newest first. */
     inbox(fleetId: FleetId, query: {
         shipId: ShipId;

package/dist/domain/shared/history.js

@@ -9,7 +9,7 @@ export function isDeliveryChangeType(type) {
 export function isKeptBy(filter, state) {
     switch (filter) {
         case 'open':
-            return state === 'pending' || state === 'delivered';
+            return state === 'pending' || state === 'received' || state === 'handed';
         case 'done':
             return state === 'acknowledged';
         case 'all':

package/dist/domain/shared/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/domain/shared/history.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GASlB,MAAM,sBAAsB,CAAC;AAsC9B,MAAM,UAAU,QAAQ,CAAoC,OAAU;IACpE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;AACxE,CAAC;AAyBD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AAiDD,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,KAAoB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,WAAW,CAAC;QACtD,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,cAAc,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/domain/shared/history.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAWlB,MAAM,sBAAsB,CAAC;AAwC9B,MAAM,UAAU,QAAQ,CAAoC,OAAU;IACpE,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;AACxE,CAAC;AAsCD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClE,CAAC;AAiID,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,KAAoB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ,CAAC;QAC3E,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,cAAc,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/domain/shared/read-message.d.ts

@@ -1,10 +1,13 @@
 import type { MessageId } from '@aeolus-fleet/common';
 import type { Caller } from './caller.js';
 import { type DomainError } from './errors.js';
-import type { DeliveryChange, HistoryMessage, ShipHistory } from './history.js';
+import { type DeliveryWay } from './delivery-way.js';
+import type { DeliveryChange, HistoryMessage, HistoryReply, ShipHistory } from './history.js';
 import { type Result } from './result.js';
 export type MessageDetail = HistoryMessage & {
+    replies: HistoryReply[];
     delivery: HistoryMessage['delivery'] & {
+        way: DeliveryWay;
         history: DeliveryChange[];
     };
 };
@@ -13,8 +16,9 @@ export type ReadMessage = (caller: Caller, input: {
 }) => Promise<Result<MessageDetail, DomainError<'MESSAGE_NOT_FOUND'>>>;
 /**
  * Use case: one message of the caller's fleet: its envelope, its whole
- * payload, and its delivery with every change newest first, from the event
- * log. The caller's scope (fleet:read) is checked before this runs.
+ * payload, its replies, and its delivery's way through: who holds it, since
+ * when, the clocks that speak for it and every step newest first, from the
+ * event log. The caller's scope (fleet:read) is checked before this runs.
  */
 export declare function createReadMessage(deps: {
     history: ShipHistory;

package/dist/domain/shared/read-message.js

@@ -1,9 +1,11 @@
 import { refuse } from './errors.js';
+import { deliveryWayOf } from './delivery-way.js';
 import { ok } from './result.js';
 /**
  * Use case: one message of the caller's fleet: its envelope, its whole
- * payload, and its delivery with every change newest first, from the event
- * log. The caller's scope (fleet:read) is checked before this runs.
+ * payload, its replies, and its delivery's way through: who holds it, since
+ * when, the clocks that speak for it and every step newest first, from the
+ * event log. The caller's scope (fleet:read) is checked before this runs.
  */
 export function createReadMessage(deps) {
     return async (caller, { messageId }) => {
@@ -11,8 +13,9 @@ export function createReadMessage(deps) {
         if (!found) {
             return refuse('MESSAGE_NOT_FOUND', `No message ${messageId} in this fleet`);
         }
-        const { history, ...message } = found;
-        return ok({ ...message, delivery: { ...message.delivery, history } });
+        const { history, replies, lease, overdue, crew, ...message } = found;
+        const way = deliveryWayOf({ state: message.delivery.state, history, lease, overdue, crew });
+        return ok({ ...message, replies, delivery: { ...message.delivery, way, history } });
     };
 }
 //# sourceMappingURL=read-message.js.map

package/dist/domain/shared/read-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-message.js","sourceRoot":"","sources":["../../../src/domain/shared/read-message.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAS9C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,mBAAmB,EAAE,cAAc,SAAS,gBAAgB,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;QACtC,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-message.js","sourceRoot":"","sources":["../../../src/domain/shared/read-message.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAoB,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAY9C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,mBAAmB,EAAE,cAAc,SAAS,gBAAgB,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;QACrE,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5F,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/shared/read-needs-attention.d.ts

@@ -1,10 +1,10 @@
 import type { Caller } from './caller.js';
-import { type ShipHistory, type ShownUndeliverableEntry } from './history.js';
-export type ReadNeedsAttention = (caller: Caller) => Promise<ShownUndeliverableEntry[]>;
+import { type ShipHistory, type ShownNeedsAttentionEntry } from './history.js';
+export type ReadNeedsAttention = (caller: Caller) => Promise<ShownNeedsAttentionEntry[]>;
 /**
- * Use case: Needs attention, every undeliverable delivery of the caller's
- * fleet, oldest first, each with its whole message, telling whether it is a
- * ping, for the operator to resend or dismiss. Abandoned deliveries are never listed: they stay in the
+ * Use case: Needs attention, every undeliverable or not handled delivery of
+ * the caller's fleet, oldest first, each with its state and whole message,
+ * telling whether it is a ping, for the operator to resend or dismiss. Abandoned deliveries are never listed: they stay in the
  * timelines only. The caller's scope (fleet:read) is checked before this runs.
  */
 export declare function createReadNeedsAttention(deps: {

package/dist/domain/shared/read-needs-attention.js

@@ -1,11 +1,11 @@
 import { withPing } from './history.js';
 /**
- * Use case: Needs attention, every undeliverable delivery of the caller's
- * fleet, oldest first, each with its whole message, telling whether it is a
- * ping, for the operator to resend or dismiss. Abandoned deliveries are never listed: they stay in the
+ * Use case: Needs attention, every undeliverable or not handled delivery of
+ * the caller's fleet, oldest first, each with its state and whole message,
+ * telling whether it is a ping, for the operator to resend or dismiss. Abandoned deliveries are never listed: they stay in the
  * timelines only. The caller's scope (fleet:read) is checked before this runs.
  */
 export function createReadNeedsAttention(deps) {
-    return async (caller) => (await deps.history.undeliverable(caller.fleetId)).map((entry) => ({ ...entry, message: withPing(entry.message) }));
+    return async (caller) => (await deps.history.needsAttention(caller.fleetId)).map((entry) => ({ ...entry, message: withPing(entry.message) }));
 }
 //# sourceMappingURL=read-needs-attention.js.map

package/dist/domain/shared/read-needs-attention.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-needs-attention.js","sourceRoot":"","sources":["../../../src/domain/shared/read-needs-attention.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAkD,MAAM,cAAc,CAAC;AAIxF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAA8B;IACrE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/I,CAAC"}
+{"version":3,"file":"read-needs-attention.js","sourceRoot":"","sources":["../../../src/domain/shared/read-needs-attention.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAmD,MAAM,cAAc,CAAC;AAIzF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAA8B;IACrE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAChJ,CAAC"}

package/dist/domain/shared/read-no-ship-can-take.d.ts

@@ -0,0 +1,13 @@
+import type { Caller } from './caller.js';
+import { type ShipHistory, type ShownNoShipCanTakeEntry } from './history.js';
+export type ReadNoShipCanTake = (caller: Caller) => Promise<ShownNoShipCanTakeEntry[]>;
+/**
+ * Use case: the pending deliveries of the caller's fleet to a type no active
+ * ship can take (decision 0041), oldest sent first, for Needs attention. Each
+ * clears by itself once a ship of the type can take it; there is nothing to
+ * resend or dismiss. The caller's scope (fleet:read) is checked before this
+ * runs.
+ */
+export declare function createReadNoShipCanTake(deps: {
+    history: ShipHistory;
+}): ReadNoShipCanTake;

package/dist/domain/shared/read-no-ship-can-take.js

@@ -0,0 +1,12 @@
+import { withPing } from './history.js';
+/**
+ * Use case: the pending deliveries of the caller's fleet to a type no active
+ * ship can take (decision 0041), oldest sent first, for Needs attention. Each
+ * clears by itself once a ship of the type can take it; there is nothing to
+ * resend or dismiss. The caller's scope (fleet:read) is checked before this
+ * runs.
+ */
+export function createReadNoShipCanTake(deps) {
+    return async (caller) => (await deps.history.noShipCanTake(caller.fleetId)).map((entry) => ({ ...entry, message: withPing(entry.message) }));
+}
+//# sourceMappingURL=read-no-ship-can-take.js.map

package/dist/domain/shared/read-no-ship-can-take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-no-ship-can-take.js","sourceRoot":"","sources":["../../../src/domain/shared/read-no-ship-can-take.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAkD,MAAM,cAAc,CAAC;AAIxF;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA8B;IACpE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/I,CAAC"}

package/dist/domain/shared/read-overdue.d.ts

@@ -0,0 +1,13 @@
+import type { Caller } from './caller.js';
+import { type ShipHistory, type ShownOverdueEntry } from './history.js';
+export type ReadOverdue = (caller: Caller) => Promise<ShownOverdueEntry[]>;
+/**
+ * Use case: the deliveries of the caller's fleet argo was told are overdue by
+ * the 10 and 60 minute clocks (decision 0040), oldest told first, for Needs
+ * attention. Each clears by itself once its delivery leaves the state it was
+ * told in or its lease ends; there is nothing to resend or dismiss. The
+ * caller's scope (fleet:read) is checked before this runs.
+ */
+export declare function createReadOverdue(deps: {
+    history: ShipHistory;
+}): ReadOverdue;

package/dist/domain/shared/read-overdue.js

@@ -0,0 +1,12 @@
+import { withPing } from './history.js';
+/**
+ * Use case: the deliveries of the caller's fleet argo was told are overdue by
+ * the 10 and 60 minute clocks (decision 0040), oldest told first, for Needs
+ * attention. Each clears by itself once its delivery leaves the state it was
+ * told in or its lease ends; there is nothing to resend or dismiss. The
+ * caller's scope (fleet:read) is checked before this runs.
+ */
+export function createReadOverdue(deps) {
+    return async (caller) => (await deps.history.overdue(caller.fleetId)).map((entry) => ({ ...entry, message: withPing(entry.message) }));
+}
+//# sourceMappingURL=read-overdue.js.map

package/dist/domain/shared/read-overdue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-overdue.js","sourceRoot":"","sources":["../../../src/domain/shared/read-overdue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAA4C,MAAM,cAAc,CAAC;AAIlF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACzI,CAAC"}

package/dist/domain/shared/read-ship-messages.d.ts

@@ -10,7 +10,10 @@ export declare const PREVIEW_LENGTH = 120;
 /** A message as the ship page lists it: its payload cut to a preview. */
 export type ListedMessage = Omit<HistoryMessage, 'payload' | 'delivery'> & {
     preview: string;
-    delivery: Omit<HistoryMessage['delivery'], 'attempts'>;
+    delivery: Omit<HistoryMessage['delivery'], 'attempts' | 'handOverNumber'> & {
+        /** Handed by a plain receive, with no hand-over number: it reads handed (pulled). False in every other state. */
+        isPulled: boolean;
+    };
 };
 export type ReadShipMessages = (caller: Caller, input: {
     shipId: ShipId;

package/dist/domain/shared/read-ship-messages.js

@@ -23,7 +23,12 @@ export function createReadShipMessages(deps) {
         return ok(messages.map(({ payload, delivery, ...message }) => ({
             ...message,
             preview: previewOf(payload),
-            delivery: { id: delivery.id, state: delivery.state, claimedBy: delivery.claimedBy },
+            delivery: {
+                id: delivery.id,
+                state: delivery.state,
+                claimedBy: delivery.claimedBy,
+                isPulled: delivery.state === 'handed' && delivery.handOverNumber === null,
+            },
         })));
     };
 }

package/dist/domain/shared/read-ship-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-ship-messages.js","sourceRoot":"","sources":["../../../src/domain/shared/read-ship-messages.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAalC,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA8B;IACnE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,gBAAgB,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,CACP,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;YAC3B,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE;SACpF,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-ship-messages.js","sourceRoot":"","sources":["../../../src/domain/shared/read-ship-messages.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAgBlC,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA8B;IACnE,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,gBAAgB,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,CACP,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;YAC3B,QAAQ,EAAE;gBACR,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,QAAQ,EAAE,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,cAAc,KAAK,IAAI;aAC1E;SACF,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/shared/read-ship-way.d.ts

@@ -0,0 +1,41 @@
+import type { ComputerSide, DeliveryId, DeliveryState, MessageId, ShipId } from '@aeolus-fleet/common';
+import type { Caller } from './caller.js';
+import { type DeliveryWay, type WayLease } from './delivery-way.js';
+import { type DomainError } from './errors.js';
+import type { ShipHistory } from './history.js';
+import { type Result } from './result.js';
+/** The ship's side of the way (#756): which part serves it, its turn, and what waits for it. */
+export interface ShipWay {
+    /** The open lease's computer side (none: a pull lease) and its turn; null while no session crews the ship. */
+    lease: {
+        by: ComputerSide | null;
+        turn: WayLease['turn'];
+    } | null;
+    /** How many deliveries wait for it. */
+    waiting: number;
+    /** The oldest one waiting, sent first, with its way; null when none waits. */
+    oldest: {
+        messageId: MessageId;
+        sentAt: Date;
+        contentType: string;
+        delivery: {
+            id: DeliveryId;
+            state: DeliveryState;
+            attempts: number;
+            way: DeliveryWay;
+        };
+    } | null;
+}
+export type ReadShipWay = (caller: Caller, input: {
+    shipId: ShipId;
+}) => Promise<Result<ShipWay, DomainError<'SHIP_NOT_FOUND'>>>;
+/**
+ * Use case: one ship's side of the way: the trierarch or plugin watcher that
+ * receives and hands over for its pushed lease, or none on a pull lease, the
+ * turn its hooks reported, and its oldest delivery waiting, with its way, as
+ * the clocks count it. The caller's scope (fleet:read) is checked before this
+ * runs.
+ */
+export declare function createReadShipWay(deps: {
+    history: ShipHistory;
+}): ReadShipWay;

package/dist/domain/shared/read-ship-way.js

@@ -0,0 +1,39 @@
+import { computerSideOf, deliveryWayOf } from './delivery-way.js';
+import { refuse } from './errors.js';
+import { ok } from './result.js';
+/**
+ * Use case: one ship's side of the way: the trierarch or plugin watcher that
+ * receives and hands over for its pushed lease, or none on a pull lease, the
+ * turn its hooks reported, and its oldest delivery waiting, with its way, as
+ * the clocks count it. The caller's scope (fleet:read) is checked before this
+ * runs.
+ */
+export function createReadShipWay(deps) {
+    return async (caller, { shipId }) => {
+        const found = await deps.history.shipWay(caller.fleetId, shipId);
+        if (!found) {
+            return refuse('SHIP_NOT_FOUND', `No ship ${shipId} in this fleet`);
+        }
+        const { lease, waiting } = found;
+        const [oldestId] = waiting;
+        const oldest = oldestId === undefined ? undefined : await deps.history.message(caller.fleetId, oldestId);
+        return ok({
+            lease: lease && { by: computerSideOf(lease), turn: lease.turn },
+            waiting: waiting.length,
+            oldest: oldest
+                ? {
+                    messageId: oldest.id,
+                    sentAt: oldest.sentAt,
+                    contentType: oldest.contentType,
+                    delivery: {
+                        id: oldest.delivery.id,
+                        state: oldest.delivery.state,
+                        attempts: oldest.delivery.attempts,
+                        way: deliveryWayOf({ state: oldest.delivery.state, history: oldest.history, lease: oldest.lease, overdue: oldest.overdue, crew: oldest.crew }),
+                    },
+                }
+                : null,
+        });
+    };
+}
+//# sourceMappingURL=read-ship-way.js.map

package/dist/domain/shared/read-ship-way.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-ship-way.js","sourceRoot":"","sources":["../../../src/domain/shared/read-ship-way.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAmC,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAoB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAmB9C;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,gBAAgB,EAAE,WAAW,MAAM,gBAAgB,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzG,OAAO,EAAE,CAAC;YACR,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;YAC/D,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,MAAM,EAAE,MAAM;gBACZ,CAAC,CAAC;oBACE,SAAS,EAAE,MAAM,CAAC,EAAE;oBACpB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,QAAQ,EAAE;wBACR,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;wBACtB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;wBAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;wBAClC,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;qBAC/I;iBACF;gBACH,CAAC,CAAC,IAAI;SACT,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}