@aeolus-fleet/core 0.24.1 → 0.25.1

package/dist/domain/registry/request-crew.js

@@ -1,12 +1,15 @@
 import { refuse } from '../shared/errors.js';
 import { recordEvent, shipActor } from '../shared/events.js';
 import { ok } from '../shared/result.js';
-import { requestCrew } from './crew-request.js';
+import { machineLabelsOf, requestCrew } from './crew-request.js';
 /**
  * Use case: a requester asks that a ship be kept crewed, with these settings,
  * replacing any request the ship holds. Its scope (fleet:manage) is checked
  * before this runs. In one unit of work, locking the ship first, as a retire
- * does, so a retire and a request never cross: the request and CrewRequested.
+ * does, so a retire and a request never cross; then holding the label of
+ * each machine label, as an assignment does, so a change of its values waits
+ * and the request never names a value it removed: the request and
+ * CrewRequested.
  */
 export function createRequestCrew(deps) {
     return (caller, input) => deps.uow.run(async (tx) => {
@@ -15,7 +18,15 @@ export function createRequestCrew(deps) {
             return refuse('SHIP_NOT_FOUND', `Ship ${input.shipId} does not exist`);
         }
         const current = await tx.crewRequests.find(caller.fleetId, ship.id);
-        const requested = requestCrew({ ship, current }, { settings: input.settings, at: deps.clock.now(), actor: shipActor(caller.shipId) });
+        const labelValues = new Set();
+        for (const valueId of machineLabelsOf(input.settings)) {
+            const label = await tx.labels.findByValueForShare(caller.fleetId, valueId);
+            // Read after the lock: a change of values that came first may have removed the value.
+            if (label?.values.some((value) => value.id === valueId)) {
+                labelValues.add(valueId);
+            }
+        }
+        const requested = requestCrew({ ship, current, labelValues }, { settings: input.settings, at: deps.clock.now(), actor: shipActor(caller.shipId) });
         if (!requested.isOk) {
             return requested;
         }

package/dist/domain/registry/request-crew.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-crew.js","sourceRoot":"","sources":["../../../src/domain/registry/request-crew.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AAezE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAwE;IACxG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CACvB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAoG,EAAE;QAC1H,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,gBAAgB,EAAE,QAAQ,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"request-crew.js","sourceRoot":"","sources":["../../../src/domain/registry/request-crew.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AAgB1F;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAwE;IACxG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CACvB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAoG,EAAE;QAC1H,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,gBAAgB,EAAE,QAAQ,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAgB,CAAC;QAC5C,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3E,sFAAsF;YACtF,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;gBACxD,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnJ,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/domain/registry/turn.d.ts

@@ -0,0 +1,25 @@
+import type { TurnState } from '@aeolus-fleet/common';
+import type { Crew } from '../shared/caller.js';
+import { type NewEvent } from '../shared/events.js';
+/** The turn a lease holds: idle or busy, since the time the hooks saw it change. */
+export interface Turn {
+    state: TurnState;
+    at: Date;
+}
+/**
+ * The hooks report the turn with the time they saw it (decision 0040): the
+ * lease keeps it at that time, and TurnReported is written then, so a report
+ * the fleet refused and that is sent again later keeps its own time. The same
+ * turn again changes nothing, so the turn keeps the time it changed. A report
+ * older than the turn held changes nothing either: a late report never undoes
+ * a newer one. A time later than now is taken as now.
+ */
+export declare function reportTurn(held: Turn | null, report: {
+    crew: Crew;
+    turn: TurnState;
+    at: Date;
+    now: Date;
+}): {
+    turn: Turn;
+    events: NewEvent[];
+};

package/dist/domain/registry/turn.js

@@ -0,0 +1,30 @@
+import { shipActor } from '../shared/events.js';
+/**
+ * The hooks report the turn with the time they saw it (decision 0040): the
+ * lease keeps it at that time, and TurnReported is written then, so a report
+ * the fleet refused and that is sent again later keeps its own time. The same
+ * turn again changes nothing, so the turn keeps the time it changed. A report
+ * older than the turn held changes nothing either: a late report never undoes
+ * a newer one. A time later than now is taken as now.
+ */
+export function reportTurn(held, report) {
+    const { crew, turn, now } = report;
+    const at = report.at > now ? now : report.at;
+    if (held !== null && (held.state === turn || at < held.at)) {
+        return { turn: held, events: [] };
+    }
+    return {
+        turn: { state: turn, at },
+        events: [
+            {
+                fleetId: crew.fleetId,
+                type: 'TurnReported',
+                occurredAt: at,
+                actor: shipActor(crew.shipId),
+                shipId: crew.shipId,
+                details: { leaseId: crew.leaseId, turn },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=turn.js.map

package/dist/domain/registry/turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.js","sourceRoot":"","sources":["../../../src/domain/registry/turn.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAQ/D;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAiB,EACjB,MAA4D;IAE5D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IACnC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7C,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpC,CAAC;IACD,OAAO;QACL,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QACzB,MAAM,EAAE;YACN;gBACE,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,cAAc;gBACpB,UAAU,EAAE,EAAE;gBACd,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;aACzC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/domain/shared/delivery-way.d.ts

@@ -0,0 +1,83 @@
+import { type ComputerSide, type CrewStatus, type DeliveryHolder, type DeliveryState, type LeaseEndReason, type OverdueClock, type ShipId, type TurnState } from '@aeolus-fleet/common';
+import type { Location } from '../registry/public.js';
+import type { SequencedEvent } from './events.js';
+import { type DeliveryChange, type HistoryParty } from './history.js';
+/**
+ * A message's way through (decision 0040, #756): who holds its delivery, the
+ * part each step was taken by, and the clocks that speak for it. Read models
+ * only, from the event log and the leases its steps name.
+ */
+/** What the history reads of a lease on a delivery's way. */
+export interface WayLease {
+    location: Location;
+    harness: string | null;
+    /** The ship other than argo whose starting prompt its crew claimed with: its trierarch; null crewed by hand. */
+    trierarch: HistoryParty | null;
+    /** From its first push receive until it ends. */
+    isPushed: boolean;
+    isEnded: boolean;
+    /** Why it ended, as its LeaseRevoked says; null while open. */
+    endReason: LeaseEndReason | null;
+    /** Its session's turn as its hooks last reported it; null until they report. */
+    turn: {
+        state: TurnState;
+        at: Date;
+    } | null;
+}
+/** An overdue clock argo was told of that still stands: the delivery is still in the state it was told in, on that open lease. */
+export interface StandingOverdue {
+    clock: OverdueClock;
+    minutes: number;
+    toldAt: Date;
+}
+/** How a trierarch says the crew of a ship stands, from its crew request. */
+export interface WayCrew {
+    status: CrewStatus;
+    attempt: number;
+    startedAt: Date | null;
+}
+/** Where a delivery stands on its way. */
+export interface DeliveryWay {
+    holder: DeliveryHolder | null;
+    /** When it entered its state. */
+    since: Date;
+    /** A plain receive handed it last, with no hand-over number. */
+    isPulled: boolean;
+    overdue: StandingOverdue | null;
+    /** The lease that holds it, or a pending delivery to one ship waits for. */
+    lease: {
+        by: ComputerSide | null;
+        isEnded: boolean;
+        turn: WayLease['turn'];
+    } | null;
+    /** The crew the lease's trierarch runs; none for a session crewed by hand. */
+    crew: WayCrew | null;
+}
+/**
+ * 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 declare function computerSideOf(lease: Pick<WayLease, 'isPushed' | 'trierarch'>): ComputerSide | null;
+/**
+ * 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 declare function deliveryStepOf(event: SequencedEvent, read: {
+    party: (id: ShipId) => HistoryParty;
+    leases: ReadonlyMap<string, WayLease>;
+}): DeliveryChange[];
+/**
+ * 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 declare function deliveryWayOf(read: {
+    state: DeliveryState;
+    history: readonly DeliveryChange[];
+    lease: WayLease | null;
+    overdue: StandingOverdue | null;
+    crew: WayCrew | null;
+}): DeliveryWay;

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_INVALID' | '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;AA2G5C,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;