@aeolus-fleet/gateway 0.34.0 → 0.36.0

package/dist/core/people/open-delivery.d.ts

@@ -1,30 +1,25 @@
 import type { MeetingId } from '@aeolus-fleet/common';
-import type { Clock } from '../shared/clock.js';
 import { type DomainError } from '../shared/errors.js';
 import { type Result } from '../shared/result.js';
-import type { CrewPersonShip } from './crew-person-ship.js';
 import { type InboxEntry } from './inbox-entry.js';
-import { type PersonCaller, type PersonCrewError } from './person-crew.js';
-import type { InboxChanges, OpenedDeliveries, PersonCrews, PersonShipDoor } from './ports.js';
-/** A delivery as a person opens it: whole, with the meeting it belongs to, none outside a meeting. */
+import { type PersonCaller, type PersonCrewError, type PersonCrewToken } from './person-crew.js';
+import type { Place } from './item-outcome.js';
+import { type DealDeps } from './opened-of.js';
+import type { OpenedDelivery, PersonDelivery } from './ports.js';
+import { type Stale } from './stale-question.js';
+/** A delivery as a person opens it: whole, with the meeting it belongs to, none outside a meeting, and stale once its asker withdrew or replaced the question it asks. */
 export interface OpenedView extends InboxEntry {
     readonly contentType: string;
     readonly payload: string;
     readonly meetingId: MeetingId | null;
+    readonly stale: Stale | null;
 }
 type OpenError = PersonCrewError | DomainError<'NO_SUCH_DELIVERY'>;
 export type OpenDelivery = (input: {
     caller: PersonCaller;
     deliveryId: string;
+    place: Place;
 }) => Promise<Result<OpenedView, OpenError>>;
-interface OpenDeps {
-    crewPersonShip: CrewPersonShip;
-    crews: PersonCrews;
-    door: PersonShipDoor;
-    opened: OpenedDeliveries;
-    changes: InboxChanges;
-    clock: Clock;
-}
 /**
  * Use case: a person opens one delivery that waits for their person ship
  * (Q20). Opening is their own act, so the gateway, as the ship's crew,
@@ -34,6 +29,26 @@ interface OpenDeps {
  * opened, from any client, opens again whole as the fleet reads it again,
  * never from a copy, until they answer it or are done (aeolus-fleet #1046).
  * Once acknowledged, the person's pages are told their inbox changed.
+ * Seeing an alert or a notice is all it asks (Bridge, CC16): it is reported
+ * handled at once, seen where the person saw it; one the fleet did not take
+ * handled for stays opened, and opening it again tries once more. So is
+ * looking at a question its asker withdrew or replaced (Bridge, section 9):
+ * it is shown stale and is done, withdrawn with its withdrawal, or replaced;
+ * the replacement is a new item that still waits. Opening a replacement is
+ * done with the question it replaces too.
+ */
+export declare function createOpenDelivery(deps: DealDeps): OpenDelivery;
+/**
+ * The person looked at a delivery (Bridge, section 9): a question its asker
+ * withdrew is done as withdrawn, and its withdrawal as seen; one replaced is
+ * done as replaced. A replacement is done with the question it replaces.
+ * What the fleet does not take now waits for the next look.
  */
-export declare function createOpenDelivery(deps: OpenDeps): OpenDelivery;
+export declare function doneIfStale(deps: DealDeps, look: {
+    caller: PersonCaller;
+    crew: PersonCrewToken;
+    looked: OpenedDelivery;
+    waiting: readonly PersonDelivery[];
+    place: Place;
+}): Promise<Stale | null>;
 export {};

package/dist/core/people/open-delivery.js

@@ -1,8 +1,11 @@
 import { refuse } from '../shared/errors.js';
 import { ok } from '../shared/result.js';
 import { inboxEntryOf, titleOf } from './inbox-entry.js';
-import { asPersonCrew, withOwnRefusal } from './person-crew.js';
+import { asPersonCrew, KEY_UNAVAILABLE, SEALED_MESSAGE, withOwnRefusal } from './person-crew.js';
+import { jobOf } from './item-job.js';
+import { handledOf } from './opened-of.js';
 import { waitingFor } from './read-inbox.js';
+import { replacedBy, staleBy, withdrawerOf } from './stale-question.js';
 /**
  * Use case: a person opens one delivery that waits for their person ship
  * (Q20). Opening is their own act, so the gateway, as the ship's crew,
@@ -12,39 +15,117 @@ import { waitingFor } from './read-inbox.js';
  * opened, from any client, opens again whole as the fleet reads it again,
  * never from a copy, until they answer it or are done (aeolus-fleet #1046).
  * Once acknowledged, the person's pages are told their inbox changed.
+ * Seeing an alert or a notice is all it asks (Bridge, CC16): it is reported
+ * handled at once, seen where the person saw it; one the fleet did not take
+ * handled for stays opened, and opening it again tries once more. So is
+ * looking at a question its asker withdrew or replaced (Bridge, section 9):
+ * it is shown stale and is done, withdrawn with its withdrawal, or replaced;
+ * the replacement is a new item that still waits. Opening a replacement is
+ * done with the question it replaces too.
  */
 export function createOpenDelivery(deps) {
-    return async ({ caller, deliveryId }) => {
+    return async ({ caller, deliveryId, place }) => {
         const waiting = await waitingFor(deps, caller);
         if (!waiting.isOk) {
             return waiting;
         }
         const delivery = waiting.value.deliveries.find((each) => each.deliveryId === deliveryId);
         if (!delivery) {
-            return openedAgain(deps, { caller, crew: waiting.value.crew, deliveryId });
+            return openedAgain(deps, { caller, crew: waiting.value.crew, deliveryId, place, waiting: waiting.value.deliveries });
         }
-        await deps.opened.save({
-            fleetId: caller.fleetId,
-            shipId: waiting.value.crew.shipId,
-            deliveryId: delivery.deliveryId,
-            messageId: delivery.messageId,
-            senderShipId: delivery.senderShipId,
-            from: delivery.senderName,
-            title: titleOf(delivery),
-            sentAt: delivery.sentAt,
-            openedAt: deps.clock.now(),
-        });
-        const acknowledged = await asPersonCrew(deps, { caller, run: (crew) => deps.door.ack(crew.crewToken, delivery.deliveryId) });
+        const kept = keptOf(deps, { caller, shipId: waiting.value.crew.shipId, delivery });
+        const acknowledged = await seenNow(deps, { caller, kept });
         if (!acknowledged.isOk) {
             return acknowledged;
         }
-        await deps.changes.tell({ fleetId: caller.fleetId, shipId: waiting.value.crew.shipId });
-        return ok(viewOf(delivery));
+        await seenIfAllItAsks(deps, { caller, opened: kept, place });
+        const stale = await doneIfStale(deps, { caller, crew: waiting.value.crew, looked: kept, waiting: waiting.value.deliveries, place });
+        return ok({ ...viewOf(delivery), stale });
     };
 }
+/** What the gateway keeps of a delivery the person opens: what their answer and their lists need, never its payload. */
+function keptOf(deps, opening) {
+    const { caller, shipId, delivery } = opening;
+    return {
+        fleetId: caller.fleetId,
+        shipId,
+        deliveryId: delivery.deliveryId,
+        messageId: delivery.messageId,
+        senderShipId: delivery.senderShipId,
+        from: delivery.senderName,
+        title: titleOf(delivery),
+        contentType: delivery.contentType,
+        askedQuestionId: delivery.askedQuestionId,
+        withdrawnQuestionId: delivery.withdrawnQuestionId,
+        stepId: delivery.stepId,
+        sentAt: delivery.sentAt,
+        openedAt: deps.clock.now(),
+    };
+}
+/** Keeps it opened, then acknowledges it for the person and tells their pages their inbox changed. */
+async function seenNow(deps, seen) {
+    const { caller, kept } = seen;
+    await deps.opened.save(kept);
+    const acknowledged = await asPersonCrew(deps, { caller, run: (crew) => deps.door.ack(crew.crewToken, kept.deliveryId) });
+    if (!acknowledged.isOk) {
+        return acknowledged;
+    }
+    await deps.changes.tell({ fleetId: caller.fleetId, shipId: kept.shipId });
+    return ok(undefined);
+}
+/**
+ * The person looked at a delivery (Bridge, section 9): a question its asker
+ * withdrew is done as withdrawn, and its withdrawal as seen; one replaced is
+ * done as replaced. A replacement is done with the question it replaces.
+ * What the fleet does not take now waits for the next look.
+ */
+export async function doneIfStale(deps, look) {
+    const { caller, crew, looked, waiting, place } = look;
+    const opened = await deps.opened.list(caller.fleetId, crew.shipId);
+    const among = [...waiting, ...opened.filter(({ deliveryId }) => deliveryId !== looked.deliveryId)];
+    const withEach = { caller, crew, waiting, opened, place };
+    const replaced = replacedBy(looked, among);
+    if (replaced !== undefined) {
+        await doneWith(deps, { ...withEach, deliveryId: replaced.deliveryId, kind: 'replaced' });
+    }
+    const withdrawer = withdrawerOf(looked, among);
+    if (withdrawer === undefined) {
+        return null;
+    }
+    const stale = staleBy(withdrawer);
+    await handledOf(deps, { caller, delivery: looked, as: { place, kind: stale.kind, option: null } });
+    if (stale.kind === 'withdrawn') {
+        await doneWith(deps, { ...withEach, deliveryId: withdrawer.deliveryId, kind: 'seen' });
+    }
+    return stale;
+}
+/** Reports a delivery the person did not open themselves handled, acknowledging it first while it still waits. */
+async function doneWith(deps, done) {
+    const { caller, crew, waiting, opened, deliveryId, kind, place } = done;
+    let kept = opened.find((each) => each.deliveryId === deliveryId);
+    if (kept === undefined) {
+        const delivery = waiting.find((each) => each.deliveryId === deliveryId);
+        if (delivery === undefined) {
+            return;
+        }
+        kept = keptOf(deps, { caller, shipId: crew.shipId, delivery });
+        const acknowledged = await seenNow(deps, { caller, kept });
+        if (!acknowledged.isOk) {
+            return;
+        }
+    }
+    await handledOf(deps, { caller, delivery: kept, as: { place, kind, option: null } });
+}
+/** Reports an alert or a notice handled once seen (CC16); any other delivery waits on the person still. */
+async function seenIfAllItAsks(deps, seen) {
+    const { caller, opened, place } = seen;
+    if (opened.contentType !== null && jobOf(opened.contentType) === 'stay-aware') {
+        await handledOf(deps, { caller, delivery: opened, as: { place, kind: 'seen', option: null } });
+    }
+}
 /** A delivery the person opened before, as the fleet reads it again, acknowledging nothing. */
 async function openedAgain(deps, asked) {
-    const { caller, crew, deliveryId } = asked;
+    const { caller, crew, deliveryId, place, waiting } = asked;
     const opened = await deps.opened.find(caller.fleetId, { shipId: crew.shipId, deliveryId });
     if (!opened) {
         return refuse('NO_SUCH_DELIVERY', `No delivery ${deliveryId} waits for you or is opened: read your inbox again`);
@@ -54,7 +135,15 @@ async function openedAgain(deps, asked) {
         return reread;
     }
     const delivery = reread.value.value;
-    return delivery.isOk ? ok(viewOf(delivery.value)) : refuse('NO_SUCH_DELIVERY', `The fleet no longer holds it opened: ${delivery.error.message}`);
+    if (!delivery.isOk && delivery.error.code === KEY_UNAVAILABLE) {
+        return refuse('KEY_UNAVAILABLE', SEALED_MESSAGE);
+    }
+    if (!delivery.isOk) {
+        return refuse('NO_SUCH_DELIVERY', `The fleet no longer holds it opened: ${delivery.error.message}`);
+    }
+    await seenIfAllItAsks(deps, { caller, opened, place });
+    const stale = await doneIfStale(deps, { caller, crew, looked: opened, waiting, place });
+    return ok({ ...viewOf(delivery.value), stale });
 }
 function viewOf(delivery) {
     return { ...inboxEntryOf(delivery), contentType: delivery.contentType, payload: delivery.payload, meetingId: delivery.meetingId };

package/dist/core/people/open-delivery.js.map

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

package/dist/core/people/opened-of.d.ts

@@ -1,34 +1,55 @@
+import type { Clock } from '../shared/clock.js';
 import { type DomainError } from '../shared/errors.js';
 import { type Result } from '../shared/result.js';
 import type { CrewPersonShip } from './crew-person-ship.js';
 import { type PersonCaller, type PersonCrewError } from './person-crew.js';
+import { type ItemOutcome, type ItemOutcomes, type OutcomeKind, type Place } from './item-outcome.js';
 import type { InboxChanges, OpenedDeliveries, OpenedDelivery, PersonCrews, PersonShipDoor } from './ports.js';
 /** What a person dealt with a delivery as: answered, or done with it. */
 export interface Dealt {
     readonly deliveryId: string;
     readonly isHandled: true;
 }
-export type DealtError = PersonCrewError | DomainError<'NO_SUCH_DELIVERY'>;
-/** A delivery the caller opened on their person ship. */
+export type DealtError = PersonCrewError | DomainError<'NO_SUCH_DELIVERY' | 'ALREADY_DECIDED'>;
+/**
+ * A delivery the caller opened on their person ship, to act on. One whose
+ * job another place ended first, such as a question answered in Slack, is
+ * refused saying where, so nothing is sent twice: one answer per question
+ * (Bridge, section 9). Seen alone ends nothing but a stay-aware item's job.
+ */
 export declare function openedOf(deps: {
     crewPersonShip: CrewPersonShip;
     opened: OpenedDeliveries;
+    outcomes: Pick<ItemOutcomes, 'findMany'>;
 }, asked: {
     caller: PersonCaller;
     deliveryId: string;
 }): Promise<Result<OpenedDelivery, DealtError>>;
-/**
- * Reports the delivery handled, then forgets it and tells the person's pages
- * their inbox changed; kept while the fleet does not take it, so the person
- * can go on again.
- */
-export declare function handledOf(deps: {
+/** Where and how another place ended an item first, as the person is told when they act on it again: Already answered in Slack: option 2. */
+export declare function alreadyTextOf(outcome: Pick<ItemOutcome, 'place' | 'kind' | 'option'>): string;
+/** What the person did with a delivery, and where (Bridge, CC4). */
+export interface DealtAs {
+    readonly place: Place;
+    readonly kind: OutcomeKind;
+    readonly option: number | null;
+}
+/** What dealing with a delivery needs: the fleet as the person ship's crew, what the person opened, their pages, and the outcomes kept. */
+export interface DealDeps {
     crewPersonShip: CrewPersonShip;
     crews: PersonCrews;
     door: PersonShipDoor;
     opened: OpenedDeliveries;
     changes: InboxChanges;
-}, dealt: {
+    outcomes: ItemOutcomes;
+    clock: Clock;
+}
+/**
+ * Reports the delivery handled, then keeps what came of it and where,
+ * forgets it and tells the person's pages their inbox changed; kept while
+ * the fleet does not take it, so the person can go on again.
+ */
+export declare function handledOf(deps: DealDeps, dealt: {
     caller: PersonCaller;
     delivery: OpenedDelivery;
+    as: DealtAs;
 }): Promise<Result<Dealt, DealtError>>;

package/dist/core/people/opened-of.js

@@ -1,23 +1,43 @@
+import { idSchema } from '@aeolus-fleet/common';
 import { refuse } from '../shared/errors.js';
 import { ok } from '../shared/result.js';
 import { asPersonCrew, personCrewOf, withOwnRefusal } from './person-crew.js';
-/** A delivery the caller opened on their person ship. */
+import { outcomeTextOf } from './item-outcome.js';
+/** The words with their first letter small, as they go on in a sentence. */
+function lowerFirst(text) {
+    return text.charAt(0).toLowerCase() + text.slice(1);
+}
+/**
+ * A delivery the caller opened on their person ship, to act on. One whose
+ * job another place ended first, such as a question answered in Slack, is
+ * refused saying where, so nothing is sent twice: one answer per question
+ * (Bridge, section 9). Seen alone ends nothing but a stay-aware item's job.
+ */
 export async function openedOf(deps, asked) {
     const { caller, deliveryId } = asked;
     const crew = await personCrewOf(deps.crewPersonShip, caller);
     if (!crew.isOk) {
         return crew;
     }
+    const named = idSchema('delivery').safeParse(deliveryId);
+    const [earlier] = named.success ? await deps.outcomes.findMany(caller.fleetId, { shipId: crew.value.shipId, deliveryIds: [named.data] }) : [];
+    if (earlier !== undefined && earlier.kind !== 'seen') {
+        return refuse('ALREADY_DECIDED', alreadyTextOf(earlier));
+    }
     const delivery = await deps.opened.find(caller.fleetId, { shipId: crew.value.shipId, deliveryId });
     if (!delivery) {
         return refuse('NO_SUCH_DELIVERY', `You have no opened delivery ${deliveryId}: open it from your inbox first`);
     }
     return ok(delivery);
 }
+/** Where and how another place ended an item first, as the person is told when they act on it again: Already answered in Slack: option 2. */
+export function alreadyTextOf(outcome) {
+    return `Already ${lowerFirst(outcomeTextOf(outcome))}. Nothing is sent.`;
+}
 /**
- * Reports the delivery handled, then forgets it and tells the person's pages
- * their inbox changed; kept while the fleet does not take it, so the person
- * can go on again.
+ * Reports the delivery handled, then keeps what came of it and where,
+ * forgets it and tells the person's pages their inbox changed; kept while
+ * the fleet does not take it, so the person can go on again.
  */
 export async function handledOf(deps, dealt) {
     const { caller, delivery } = dealt;
@@ -28,6 +48,7 @@ export async function handledOf(deps, dealt) {
     if (!handled.value.value.isOk) {
         return refuse('FLEET_UNAVAILABLE', `The fleet did not take that you dealt with it: ${handled.value.value.error.message}. Try again`);
     }
+    await deps.outcomes.save({ fleetId: delivery.fleetId, shipId: delivery.shipId, deliveryId: delivery.deliveryId, ...dealt.as, at: deps.clock.now() });
     await deps.opened.remove(delivery.fleetId, { shipId: delivery.shipId, deliveryId: delivery.deliveryId });
     await deps.changes.tell({ fleetId: delivery.fleetId, shipId: delivery.shipId });
     return ok({ deliveryId: delivery.deliveryId, isHandled: true });

package/dist/core/people/opened-of.js.map

@@ -1 +1 @@
-{"version":3,"file":"opened-of.js","sourceRoot":"","sources":["../../../src/core/people/opened-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAe,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAA2C,MAAM,kBAAkB,CAAC;AAWvH,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAkE,EAClE,KAAmD;IAEnD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACnG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,kBAAkB,EAAE,+BAA+B,UAAU,iCAAiC,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAmI,EACnI,KAAyD;IAEzD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5I,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,mBAAmB,EAAE,kDAAkD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACvI,CAAC;IACD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACzG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"opened-of.js","sourceRoot":"","sources":["../../../src/core/people/opened-of.ts"],"names":[],"mappings":"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"}

package/dist/core/people/person-crew.d.ts

@@ -26,7 +26,7 @@ export interface PersonCrewToken {
     readonly shipId: ShipId;
     readonly crewToken: string;
 }
-export type PersonCrewError = DomainError<'NOT_A_PERSON' | 'SIGNED_OUT' | 'FLEET_UNAVAILABLE'>;
+export type PersonCrewError = DomainError<'NOT_A_PERSON' | 'SIGNED_OUT' | 'FLEET_UNAVAILABLE' | 'KEY_UNAVAILABLE'>;
 /** Whether the fleet refused a call because the crew token no longer works. */
 export declare function isEndedCrew(refusal: FleetRefusal): boolean;
 /** The crew of the caller's person ship, or why there is none, said so the person's model can tell them. */
@@ -46,6 +46,10 @@ export declare function asPersonCrew<T>(deps: {
     crew: PersonCrewToken;
     value: T;
 }, PersonCrewError>>;
+/** The fleet's code for a sealed fleet whose company key core cannot reach (decision 0068): nothing was claimed, so the message waits. */
+export declare const KEY_UNAVAILABLE = "KEY_UNAVAILABLE";
+/** What a person is told when the fleet cannot unseal a message now. */
+export declare const SEALED_MESSAGE = "The message is sealed and the fleet's company key is not reachable: try again later. Nothing is lost; it waits.";
 /**
  * A fleet call whose refusal the caller says itself, as a value: only a crew
  * that no longer works stays a refusal, so asPersonCrew crews again.

package/dist/core/people/person-crew.js

@@ -51,7 +51,14 @@ export async function asPersonCrew(deps, call) {
     const retried = await run(again.value);
     return retried.isOk ? ok({ crew: again.value, value: retried.value }) : fleetDidNotAnswer(retried.error);
 }
+/** The fleet's code for a sealed fleet whose company key core cannot reach (decision 0068): nothing was claimed, so the message waits. */
+export const KEY_UNAVAILABLE = 'KEY_UNAVAILABLE';
+/** What a person is told when the fleet cannot unseal a message now. */
+export const SEALED_MESSAGE = "The message is sealed and the fleet's company key is not reachable: try again later. Nothing is lost; it waits.";
 function fleetDidNotAnswer(refusal) {
+    if (refusal.code === KEY_UNAVAILABLE) {
+        return refuse('KEY_UNAVAILABLE', SEALED_MESSAGE);
+    }
     return refuse('FLEET_UNAVAILABLE', `The fleet did not answer: ${refusal.message}`);
 }
 /**

package/dist/core/people/person-crew.js.map

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

package/dist/core/people/ports.d.ts

@@ -3,10 +3,11 @@
  * messaging (decisions 0054, 0057): the fleet's calls it makes as their
  * account, and the one crew every client of the person shares.
  */
-import type { DeliveryId, FleetId, MeetingId, MessageId, ShipId, ShipKind } from '@aeolus-fleet/common';
+import type { DeliveryId, DeliveryState, FleetId, MeetingId, MessageId, ShipId, ShipKind } from '@aeolus-fleet/common';
 import type { FleetRefusal } from '../connection/ports.js';
 import type { DiscoveredStatement } from '../mcp-in/ports.js';
 import type { Result } from '../shared/result.js';
+import type { Routing } from './routing.js';
 /** A call the gateway makes for an account: the account's token beside the gateway's own crew token, so the account acts through the gateway's ship. */
 export interface AccountCall {
     readonly crewToken: string;
@@ -74,8 +75,14 @@ export interface PersonDelivery {
     readonly senderName: string;
     readonly contentType: string;
     readonly payload: string;
-    /** The title of a question (the question content type), read at the edge; none for any other message. */
-    readonly questionTitle: string | null;
+    /** The headline of a question (its title), a step (its title), an alert or a notice, read at the edge; none for any other message. */
+    readonly headline: string | null;
+    /** The uuid of the question it asks (decision 0038): a question's own, a replacement's new one; none for any other message. */
+    readonly askedQuestionId: string | null;
+    /** The uuid of the question it withdraws or replaces, from the same asker; none for any other message. */
+    readonly withdrawnQuestionId: string | null;
+    /** The uuid of the step it asks (Bridge, CC14); none for any other message. */
+    readonly stepId: string | null;
     readonly sentAt: Date;
     readonly inReplyTo: MessageId | null;
     /** The meeting its message was contributed to or tells of; none outside a meeting (decision 0061). */
@@ -85,6 +92,16 @@ export interface PersonDelivery {
 export interface PushedPersonDelivery extends PersonDelivery {
     readonly handOverNumber: number | null;
 }
+/** A delivery as the person ship's record answers it: with its state; in a sealed fleet, a payload whose key cannot be had is empty and marked unreadable. */
+export interface RecordedPersonDelivery extends PersonDelivery {
+    readonly state: DeliveryState;
+    readonly isPayloadUnreadable: boolean;
+}
+/** A page of the person ship's record, newest first, and the cursor of the next; null on the last. */
+export interface RecordPage {
+    readonly items: readonly RecordedPersonDelivery[];
+    readonly nextCursor: DeliveryId | null;
+}
 /** What a person ship may send to now, as the fleet's discover answers it: each ship by name, with what it offers, and each type. */
 export interface PersonDiscovery {
     readonly ships: readonly {
@@ -128,6 +145,11 @@ export interface PersonShipDoor {
         max: number;
         shouldSkipHanded?: boolean;
     }): Promise<Result<PushedPersonDelivery[], FleetRefusal>>;
+    /** A page of the ship's record (Bridge, CC12): its deliveries in every state and across its leases, newest first, after the cursor; records nothing. */
+    record(crewToken: string, page: {
+        cursor: DeliveryId | null;
+        limit: number;
+    }): Promise<Result<RecordPage, FleetRefusal>>;
     /** Acknowledges a delivery the person opened: their own act confirms it (interop 5.1). */
     ack(crewToken: string, deliveryId: DeliveryId): Promise<Result<undefined, FleetRefusal>>;
     /** Reads a delivery the ship acknowledged again, whole, while it is not handled, recording nothing (decision 0040). */
@@ -164,7 +186,7 @@ export interface PersonShipDoor {
  * A delivery a person opened, as the gateway keeps it until they deal with
  * it (Q28 (a)): what their answer needs once the delivery is acknowledged,
  * its message and sender, and what their inbox lists, its title and when it
- * was sent, never its payload. It is the person ship's, so every client of
+ * was sent, and the questions it asks and withdraws, never its payload. It is the person ship's, so every client of
  * the person finds it.
  */
 export interface OpenedDelivery {
@@ -175,6 +197,13 @@ export interface OpenedDelivery {
     readonly senderShipId: ShipId;
     readonly from: string;
     readonly title: string;
+    /** Its content type, which names its job (Bridge, CC10); none for one opened before the gateway kept it. */
+    readonly contentType: string | null;
+    /** The uuid of the question it asks, and of the one it withdraws or replaces (decision 0038), as its payload named them; none otherwise. */
+    readonly askedQuestionId: string | null;
+    readonly withdrawnQuestionId: string | null;
+    /** The uuid of the step it asks (Bridge, CC14), as its payload named it; none otherwise. */
+    readonly stepId: string | null;
     readonly sentAt: Date;
     readonly openedAt: Date;
 }
@@ -204,12 +233,14 @@ export type WakeChannelName = 'email' | 'web-push';
 export interface ShownElsewhere {
     /**
      * Finishes what an earlier wake left unfinished, then shows what it shows
-     * of the fresh deliveries: the ones it showed, and whether any is left
-     * unfinished, so the wake is tried again.
+     * of the fresh deliveries, as the person routed their jobs (Bridge,
+     * section 8): the ones it showed, and whether any is left unfinished, so
+     * the wake is tried again.
      */
     show(ship: PersonShip, wake: {
         crewToken: string;
         fresh: readonly PushedPersonDelivery[];
+        routing: Routing;
     }): Promise<Result<ShownThere, FleetRefusal>>;
 }
 /** What a place beyond the pages showed at a wake. */
@@ -219,19 +250,26 @@ export interface ShownThere {
 }
 /** What a delivery is handed to the person through: a wake's channel, a page of theirs in focus, which shows it (W6), or Slack, which shows it (gateway scopes 9.5). */
 export type HandOverChannel = WakeChannelName | 'page' | 'slack';
+/** The window a wake belongs to: its key holds until a wake of the channel is recorded, so a retry asks again with it. */
+export interface WakeWindow {
+    readonly key: string;
+}
 /**
  * Outbound port: one way to wake a person (wake a person, W1, W4): it says
- * only that something waits in the fleet, with the overview's link, and
+ * only that something waits in the fleet, with Bridge's link, and
  * goes out at most once per its window (W3, W10).
  */
 export interface WakeChannel {
     readonly name: WakeChannelName;
     /** The least time between two wakes it sends one person ship, from the gateway's configuration (W10). */
     readonly windowMs: number;
-    /** Whether the person turned it on (W8): nothing is on by default. */
+    /** Whether it reaches the person now, as web push does while a browser of theirs takes wakes; which jobs it wakes for is routed per job (Bridge, section 8). */
     isOn(ship: PersonShip): Promise<boolean>;
-    /** Sends the wake: whether it went out. A refusal for good (refused) cannot be fixed by trying again; unavailable can succeed later. */
-    wake(ship: PersonShip): Promise<Result<undefined, {
+    /**
+     * Sends the wake: whether it went out. A refusal for good (refused) cannot be fixed by trying again; unavailable can succeed later.
+     * The window's key is the same for every try of one window, so a channel can send it once however often it is asked.
+     */
+    wake(ship: PersonShip, window: WakeWindow): Promise<Result<undefined, {
         kind: 'refused' | 'unavailable';
         reason: string;
     }>>;
@@ -245,14 +283,6 @@ export interface WakesSent {
         sentAt: Date;
     }): Promise<void>;
 }
-/** Outbound port: whether each person turned email on to be woken for their person ship (W8), by fleet and person ship. */
-export interface EmailChannels {
-    isOn(ship: PersonShip): Promise<boolean>;
-    turn(ship: PersonShip, switched: {
-        isOn: boolean;
-        at: Date;
-    }): Promise<void>;
-}
 /** A page of a person in focus (wake a person, W6): by its own id, with when it was last seen in focus. */
 export interface FocusedPage {
     readonly fleetId: FleetId;
@@ -272,7 +302,7 @@ export interface FocusedPages {
  * A browser a person turned web push on in (wake a person, W8): its push
  * service's endpoint and keys, and the fleet's name its wakes say, as the
  * person's sign-in named it when they turned it on. A subscription its push
- * service said is gone takes no wake again, and the overview says so.
+ * service said is gone takes no wake again, and Bridge's settings say so.
  */
 export interface WebPushSubscription {
     readonly fleetId: FleetId;
@@ -304,10 +334,10 @@ export interface WebPushSubscriptions {
         endpoint: string;
     }): Promise<void>;
 }
-/** What a wake says (W4): something waits in the fleet, by its name, and the link to the gateway's overview. Nothing else. */
+/** What a wake says (W4): something waits in the fleet, by its name, and the link to Bridge. Nothing else. */
 export interface Wake {
     readonly fleetName: string;
-    readonly overviewUrl: string;
+    readonly bridgeUrl: string;
 }
 /** How a push service took a wake: sent, gone (it answered 404 or 410: the subscription ended), or failed otherwise. */
 export type WebPushSent = 'sent' | 'gone' | 'failed';