@aeolus-fleet/gateway 0.36.2 → 0.36.3

package/dist/core/argo-inbox/argo-slack-message.js

@@ -0,0 +1,40 @@
+/**
+ * What waits at argo as Slack's post shows it (argo's inbox, AI2 to AI4,
+ * mockups/slack.html): marked Waits at argo, not you, with argo's own colour,
+ * its kind and sender, its headline, who it is for, and one button to the
+ * console as argo, no answer buttons; then, once done at argo, by whom and
+ * when, its button gone.
+ */
+import { isQuestionContentType } from '@aeolus-fleet/common';
+import { slackTimeOf } from '../slack/edited-post-of.js';
+import { escaped } from '../slack/slack-post-of.js';
+import { argoTitleOf } from './argo-inbox.js';
+/** The line under the headline: it is not the person's alone, and acting takes argo's sign-in. */
+const FOR_EVERYONE = 'For everyone allowed as argo. Acting signs you in to the console as argo.';
+const OPEN_AS_ARGO = 'Open in the console as argo';
+/** Slack's post of a message open at argo, its sender named by type and name, its button to the message in the console as argo (A1's link). */
+export function argoSlackMessageOf(message, shown) {
+    const kind = isQuestionContentType(message.contentType) ? 'Question' : 'Report';
+    const title = escaped(argoTitleOf(message));
+    return {
+        text: `Waits at argo, not you: ${title}`,
+        item: { asker: message.sender.name, heading: `*Waits at argo*, not you · ${kind} from ${escaped(shown.senderType)} ${escaped(message.sender.name)}`, title, body: null, aside: FOR_EVERYONE, footer: null, tone: 'argo' },
+        buttons: [{ text: OPEN_AS_ARGO, url: shown.argoMessageUrl, isPlain: true }],
+    };
+}
+/**
+ * The post, as Slack holds it, edited once its message is done at argo:
+ * by whom, the name of the person ship of the account signed in as argo,
+ * and when, each left out when the gateway did not see it. None for a post
+ * that is no item, or says so already.
+ */
+export function doneAtArgoMessageOf(message, done) {
+    const { item } = message;
+    if (item === null || item.tone === 'done') {
+        return undefined;
+    }
+    const by = done.by === undefined ? '' : ` by ${escaped(done.by)}`;
+    const at = done.at === undefined ? '' : `, ${slackTimeOf(done.at)}`;
+    return { text: message.text, item: { ...item, body: `✅ Done at argo${by} in the console${at}`, aside: null, footer: null, tone: 'done' }, buttons: [] };
+}
+//# sourceMappingURL=argo-slack-message.js.map

package/dist/core/argo-inbox/argo-slack-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argo-slack-message.js","sourceRoot":"","sources":["../../../src/core/argo-inbox/argo-slack-message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,kGAAkG;AAClG,MAAM,YAAY,GAAG,2EAA2E,CAAC;AAEjG,MAAM,YAAY,GAAG,6BAA6B,CAAC;AAEnD,+IAA+I;AAC/I,MAAM,UAAU,kBAAkB,CAAC,OAAuB,EAAE,KAAqD;IAC/G,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,2BAA2B,KAAK,EAAE;QACxC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,8BAA8B,IAAI,SAAS,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;QACzN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAqB,EAAE,IAAsD;IAC/G,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAClE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACpE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC1J,CAAC"}

package/dist/core/argo-inbox/argo-slack-post.d.ts

@@ -0,0 +1,21 @@
+import type { FleetId, MessageId, ShipId } from '@aeolus-fleet/common';
+/**
+ * A message open at argo as it is in Slack, for a person ship of an account
+ * allowed as argo (argo's inbox, AI4): posted through the gateway's own bot
+ * into the person's direct messages. It is kept before Slack is asked, then
+ * given its Slack message once Slack took it, so a gateway that stops in
+ * between posts it at most once more; or given up once Slack refused it, so
+ * it is never posted again. It is forgotten once the message is done at
+ * argo and its post edited to say so.
+ */
+export interface ArgoSlackPost {
+    readonly fleetId: FleetId;
+    readonly personShipId: ShipId;
+    /** The message to argo it shows. */
+    readonly messageId: MessageId;
+    readonly appId: string;
+    readonly channel: string;
+    /** The Slack message, once Slack took the post. */
+    readonly ts: string | null;
+    readonly isGivenUp: boolean;
+}

package/dist/core/argo-inbox/argo-slack-post.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=argo-slack-post.js.map

package/dist/core/argo-inbox/argo-slack-post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argo-slack-post.js","sourceRoot":"","sources":["../../../src/core/argo-inbox/argo-slack-post.ts"],"names":[],"mappings":""}

package/dist/core/argo-inbox/follow-argo-inbox.d.ts

@@ -0,0 +1,33 @@
+import type { FleetId, MessageId } from '@aeolus-fleet/common';
+import type { ConnectionStore } from '../connection/ports.js';
+import { type ArgoInbox, type MessageDoneAtArgo } from './argo-inbox.js';
+import type { ArgoInboxDoor } from './ports.js';
+export interface FollowArgoInbox {
+    /** One round over every fleet the gateway is connected to, each waiting while argo's inbox did not change, until the signal aborts. */
+    readonly round: (signal: AbortSignal) => Promise<void>;
+    /** argo's inbox in the fleet as last read; none before the first round, or for a fleet the gateway is not connected to. */
+    readonly inboxOf: (fleetId: FleetId) => ArgoInbox | undefined;
+    /** When the message was done at argo and by which account, as the ship saw it done; none for one it did not see done, as while the gateway was down. */
+    readonly doneAtArgo: (fleetId: FleetId, messageId: MessageId) => MessageDoneAtArgo | undefined;
+}
+/**
+ * Use case: the gateway's own ship reads argo's open inbox in each fleet it
+ * is connected to, by the read rule argo adds (argo's inbox, AI9; decision
+ * 0034). It reads the inbox whole from the fleet's position at that moment,
+ * then follows each change to a delivery to argo from there, reading that
+ * message again. Its first round, after a restart, reads it whole again.
+ * Without the rule it reads nothing and says so; once the rule is back it
+ * reads it whole again, as it followed nothing meanwhile. While the fleet
+ * does not answer it keeps what it read, and reads it whole again when
+ * following fails. A message it sees leave the open inbox is kept done at
+ * argo, when and by which account, as the change said. argo's inbox stays the
+ * one record: what the ship read lives in memory only, and core sends it
+ * nothing. It keeps the newest message it saw leave the open inbox, and who
+ * did it, and tells each round that changed what it holds, so the pages that
+ * show it read it again.
+ */
+export declare function createFollowArgoInbox(deps: {
+    connections: Pick<ConnectionStore, 'connected'>;
+    door: ArgoInboxDoor;
+    onChanged?: (fleetId: FleetId) => void;
+}): FollowArgoInbox;

package/dist/core/argo-inbox/follow-argo-inbox.js

@@ -0,0 +1,133 @@
+import { argoTitleOf, isOpenAtArgo } from './argo-inbox.js';
+function messageOf(entry) {
+    const { messageId, deliveryId, sender, contentType, sentAt, askedQuestionId, withdrawnQuestionId } = entry;
+    return { messageId, deliveryId, sender, contentType, sentAt, title: argoTitleOf(entry), askedQuestionId, withdrawnQuestionId };
+}
+/** What a fleet's page shows of argo's inbox, to tell whether a round changed it. */
+function shownOf(held) {
+    if (held === undefined || held.kind === 'notLetRead') {
+        return held?.kind ?? 'none';
+    }
+    return JSON.stringify({ messageIds: [...held.messages.keys()], lastDone: held.lastDone });
+}
+/** Who did a message done at argo, by the newest change to it. */
+function doneOf(message, change) {
+    return { title: message.title, at: change.occurredAt, byShipId: change.actorShipId, signedInAccountId: change.signedInAccountId };
+}
+function oldestFirst(messages) {
+    return [...messages].sort((one, other) => one.sentAt.getTime() - other.sentAt.getTime() || one.messageId.localeCompare(other.messageId));
+}
+/**
+ * Use case: the gateway's own ship reads argo's open inbox in each fleet it
+ * is connected to, by the read rule argo adds (argo's inbox, AI9; decision
+ * 0034). It reads the inbox whole from the fleet's position at that moment,
+ * then follows each change to a delivery to argo from there, reading that
+ * message again. Its first round, after a restart, reads it whole again.
+ * Without the rule it reads nothing and says so; once the rule is back it
+ * reads it whole again, as it followed nothing meanwhile. While the fleet
+ * does not answer it keeps what it read, and reads it whole again when
+ * following fails. A message it sees leave the open inbox is kept done at
+ * argo, when and by which account, as the change said. argo's inbox stays the
+ * one record: what the ship read lives in memory only, and core sends it
+ * nothing. It keeps the newest message it saw leave the open inbox, and who
+ * did it, and tells each round that changed what it holds, so the pages that
+ * show it read it again.
+ */
+export function createFollowArgoInbox(deps) {
+    const held = new Map();
+    const done = new Map();
+    const readWhole = async ({ crewToken, argo, lastDone }) => {
+        const position = await deps.door.position(crewToken);
+        const listed = position.isOk ? await deps.door.entries(crewToken, argo) : position;
+        if (!position.isOk || !listed.isOk) {
+            return undefined;
+        }
+        // Only the open messages are read whole, for their titles: argo's done ones may be many.
+        const read = await Promise.all(listed.value.filter(({ deliveryState }) => isOpenAtArgo(deliveryState)).map(({ messageId }) => deps.door.entry(crewToken, { argo, messageId })));
+        const messages = new Map();
+        for (const entry of read) {
+            if (!entry.isOk) {
+                return undefined;
+            }
+            if (entry.value !== null && isOpenAtArgo(entry.value.deliveryState)) {
+                messages.set(entry.value.messageId, messageOf(entry.value));
+            }
+        }
+        return { kind: 'following', argo, afterSeq: position.value, messages, lastDone };
+    };
+    const followOn = async ({ fleetId, crewToken, following, signal }) => {
+        const { argo } = following;
+        const changes = await deps.door.changes(crewToken, { argo, afterSeq: following.afterSeq, signal });
+        if (!changes.isOk) {
+            return undefined;
+        }
+        const messages = new Map(following.messages);
+        let { lastDone } = following;
+        // The last change to each message is the one that left it as it is now.
+        const newest = new Map(changes.value.changes.map((change) => [change.messageId, change]));
+        for (const [messageId, change] of newest) {
+            const entry = await deps.door.entry(crewToken, { argo, messageId });
+            if (!entry.isOk) {
+                return undefined;
+            }
+            const held = messages.get(messageId);
+            if (entry.value !== null && isOpenAtArgo(entry.value.deliveryState)) {
+                messages.set(messageId, messageOf(entry.value));
+            }
+            else {
+                messages.delete(messageId);
+                done.set(fleetId, new Map(done.get(fleetId)).set(messageId, { at: change.occurredAt, accountId: change.signedInAccountId ?? change.actorAccountId }));
+                if (held !== undefined) {
+                    lastDone = lastDone !== null && lastDone.at > change.occurredAt ? lastDone : doneOf(held, change);
+                }
+            }
+        }
+        return { kind: 'following', argo, afterSeq: changes.value.lastSeq, messages, lastDone };
+    };
+    const nextOf = async ({ fleetId, crewToken, before }, signal) => {
+        const argo = await deps.door.argoInReach(crewToken);
+        if (!argo.isOk) {
+            return before;
+        }
+        if (argo.value === null) {
+            return { kind: 'notLetRead' };
+        }
+        if (before?.kind === 'following' && before.argo === argo.value) {
+            return (await followOn({ fleetId, crewToken, following: before, signal })) ?? { kind: 'stale', argo: before.argo, messages: before.messages, lastDone: before.lastDone };
+        }
+        return (await readWhole({ crewToken, argo: argo.value, lastDone: before === undefined || before.kind === 'notLetRead' ? null : before.lastDone })) ?? before;
+    };
+    const roundOf = async ({ fleetId, crewToken }, signal) => {
+        const before = held.get(fleetId);
+        const next = await nextOf({ fleetId, crewToken, before }, signal);
+        if (next === undefined) {
+            return;
+        }
+        held.set(fleetId, next);
+        if (shownOf(next) !== shownOf(before)) {
+            deps.onChanged?.(fleetId);
+        }
+    };
+    return {
+        round: async (signal) => {
+            const connected = await deps.connections.connected();
+            const fleetIds = new Set(connected.map(({ fleetId }) => fleetId));
+            for (const fleetId of held.keys()) {
+                if (!fleetIds.has(fleetId)) {
+                    held.delete(fleetId);
+                    done.delete(fleetId);
+                }
+            }
+            await Promise.all(connected.map((crew) => roundOf(crew, signal)));
+        },
+        inboxOf: (fleetId) => {
+            const inbox = held.get(fleetId);
+            if (inbox === undefined) {
+                return undefined;
+            }
+            return inbox.kind === 'notLetRead' ? { kind: 'notLetRead' } : { kind: 'read', argo: inbox.argo, messages: oldestFirst(inbox.messages.values()), lastDone: inbox.lastDone };
+        },
+        doneAtArgo: (fleetId, messageId) => done.get(fleetId)?.get(messageId),
+    };
+}
+//# sourceMappingURL=follow-argo-inbox.js.map

package/dist/core/argo-inbox/follow-argo-inbox.js.map

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

package/dist/core/argo-inbox/note-argo-account.d.ts

@@ -0,0 +1,19 @@
+import type { FleetId, ShipId } from '@aeolus-fleet/common';
+import type { ArgoAccounts } from './ports.js';
+/** What an account token names that tells whether its account is reached as argo. */
+export interface ArgoAccountToken {
+    readonly accountId: string;
+    readonly personShipId: ShipId | null;
+    readonly isArgoAllowed: boolean;
+}
+export type NoteArgoAccount = (fleetId: FleetId, token: ArgoAccountToken) => Promise<void>;
+/**
+ * Use case: an account token the gateway is given, at a sign-in, an
+ * exchange or a refresh, is the account's latest word on whether it is
+ * allowed as argo (argo's inbox, AI9). Allowed with a person ship, the
+ * account is kept, with that person ship; otherwise it is dropped, so an
+ * account no longer allowed is dropped at its next token.
+ */
+export declare function createNoteArgoAccount(deps: {
+    accounts: ArgoAccounts;
+}): NoteArgoAccount;

package/dist/core/argo-inbox/note-argo-account.js

@@ -0,0 +1,18 @@
+/**
+ * Use case: an account token the gateway is given, at a sign-in, an
+ * exchange or a refresh, is the account's latest word on whether it is
+ * allowed as argo (argo's inbox, AI9). Allowed with a person ship, the
+ * account is kept, with that person ship; otherwise it is dropped, so an
+ * account no longer allowed is dropped at its next token.
+ */
+export function createNoteArgoAccount(deps) {
+    return async (fleetId, { accountId, personShipId, isArgoAllowed }) => {
+        if (isArgoAllowed && personShipId !== null) {
+            await deps.accounts.keep(fleetId, { accountId, personShipId });
+        }
+        else {
+            await deps.accounts.drop(fleetId, accountId);
+        }
+    };
+}
+//# sourceMappingURL=note-argo-account.js.map

package/dist/core/argo-inbox/note-argo-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-argo-account.js","sourceRoot":"","sources":["../../../src/core/argo-inbox/note-argo-account.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAgC;IACpE,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE;QACnE,IAAI,aAAa,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/argo-inbox/ports.d.ts

@@ -0,0 +1,123 @@
+/**
+ * argo's inbox, read by the gateway's own ship for the people who may act as
+ * argo (aeolus-fleet docs/design/argo-inbox, AI1 and AI9): the accounts
+ * allowed as argo, and what the gateway reads of argo's inbox.
+ */
+import type { DeliveryId, DeliveryState, FleetId, MessageId, ShipId } from '@aeolus-fleet/common';
+import type { FleetRefusal } from '../connection/ports.js';
+import type { PersonShip, WakeChannelName } from '../people/person-wakes.js';
+import type { Result } from '../shared/result.js';
+import type { ArgoSlackPost } from './argo-slack-post.js';
+/** An account allowed as argo in a fleet, as its latest account token said, and the person ship it is reached at. */
+export interface ArgoAccount {
+    readonly accountId: string;
+    readonly personShipId: ShipId;
+}
+/** Outbound port: each fleet's accounts allowed as argo, from each account's latest account token. */
+export interface ArgoAccounts {
+    keep(fleetId: FleetId, account: ArgoAccount): Promise<void>;
+    drop(fleetId: FleetId, accountId: string): Promise<void>;
+    list(fleetId: FleetId): Promise<readonly ArgoAccount[]>;
+}
+/** A message to argo as the fleet lists it: who sent it, when, and its delivery, with the delivery's state. */
+export interface ArgoInboxListed {
+    readonly messageId: MessageId;
+    readonly deliveryId: DeliveryId;
+    readonly sender: {
+        readonly shipId: ShipId;
+        readonly name: string;
+    };
+    readonly contentType: string;
+    readonly sentAt: Date;
+    readonly deliveryState: DeliveryState;
+}
+/** A message to argo read whole: listed, with its payload, its headline, and the question it asks or withdraws, read from it. */
+export interface ArgoInboxEntry extends ArgoInboxListed {
+    readonly payload: string;
+    /** A question's title, or a step's, an alert's or a notice's headline; none for any other message. */
+    readonly headline: string | null;
+    readonly askedQuestionId: string | null;
+    readonly withdrawnQuestionId: string | null;
+}
+/** A message to argo as the gateway holds it: listed, titled as an inbox lists it, and the question it asks or withdraws. */
+export interface ArgoMessage extends Omit<ArgoInboxListed, 'deliveryState'> {
+    readonly title: string;
+    readonly askedQuestionId: string | null;
+    readonly withdrawnQuestionId: string | null;
+}
+/** A change to a delivery to argo, as the fleet's event says it: when, and who caused it, the account signed in to the console as argo included (decision 0054). */
+export interface ArgoInboxChange {
+    readonly messageId: MessageId;
+    readonly occurredAt: Date;
+    /** The ship that caused it; none for any other actor. */
+    readonly actorShipId: ShipId | null;
+    /** The account signed in to the console as argo when argo caused it; none otherwise. */
+    readonly signedInAccountId: string | null;
+    /** The account that caused it, signed in to the console as argo or itself; none for a ship's or the system's. */
+    readonly actorAccountId: string | null;
+}
+/**
+ * Outbound port: what the gateway's own ship reads of argo's inbox, by its
+ * crew token, within its read reach (decision 0034): nothing of argo's
+ * outside it.
+ */
+export interface ArgoInboxDoor {
+    /** argo's ship, when it is in the ship's read reach; null while argo has not let it read. */
+    argoInReach(crewToken: string): Promise<Result<ShipId | null, FleetRefusal>>;
+    /** The position of the fleet's last event: a follow from there misses nothing after it. */
+    position(crewToken: string): Promise<Result<number, FleetRefusal>>;
+    /** Every message to argo, listed with its delivery's state. */
+    entries(crewToken: string, argo: ShipId): Promise<Result<readonly ArgoInboxListed[], FleetRefusal>>;
+    /** One message to argo read whole, with its delivery's state; null when it is no message to argo the ship reads. */
+    entry(crewToken: string, read: {
+        argo: ShipId;
+        messageId: MessageId;
+    }): Promise<Result<ArgoInboxEntry | null, FleetRefusal>>;
+    /** A ship's type, as the fleet answers it even of a ship outside the read reach. */
+    shipType(crewToken: string, shipId: ShipId): Promise<Result<string, FleetRefusal>>;
+    /** Each change to a delivery to argo after the position, oldest first, waiting while none came until the signal aborts, and the position to follow from next. */
+    changes(crewToken: string, follow: {
+        argo: ShipId;
+        afterSeq: number;
+        signal: AbortSignal;
+    }): Promise<Result<{
+        changes: readonly ArgoInboxChange[];
+        lastSeq: number;
+    }, FleetRefusal>>;
+}
+/** Outbound port: the messages open at argo in Slack, by fleet, person ship and message, in the gateway's database. */
+export interface ArgoSlackPosts {
+    /** Every post kept in the fleet. */
+    list(fleetId: FleetId): Promise<ArgoSlackPost[]>;
+    /** Keeps a new post; none when one is kept for the person ship and the message already, as two rounds at once find. */
+    keep(post: ArgoSlackPost): Promise<'kept' | 'known'>;
+    /** Keeps it as it is now: given its Slack message, or given up. */
+    save(post: ArgoSlackPost): Promise<void>;
+    remove(fleetId: FleetId, post: {
+        personShipId: ShipId;
+        messageId: MessageId;
+    }): Promise<void>;
+}
+/**
+ * Outbound port: argo's wakes of each person ship, apart from its own (argo's
+ * inbox, AI4, AI5): the messages to argo a wake or a page in focus already
+ * covered, so each is woken once per person, and when each channel last woke
+ * the person ship for argo, so the window holds across restarts and instances.
+ * Each read and write names the messages it concerns, so it reads in pages of
+ * those, never every message covered.
+ */
+export interface ArgoWakes {
+    /** Which of these messages were covered for the person ship. */
+    coveredAmong(ship: PersonShip, messageIds: readonly MessageId[]): Promise<ReadonlySet<MessageId>>;
+    cover(ship: PersonShip, messageIds: readonly MessageId[]): Promise<void>;
+    /** Forgets these messages, done at argo: they never open again. */
+    forget(ship: PersonShip, messageIds: readonly MessageId[]): Promise<void>;
+    /** Forgets every covered message but the ones open now, as at a start, when what was done meanwhile is not known. */
+    forgetAllBut(ship: PersonShip, open: readonly MessageId[]): Promise<void>;
+    lastSentAt(ship: PersonShip, channel: WakeChannelName): Promise<Date | undefined>;
+    record(wake: {
+        ship: PersonShip;
+        channel: WakeChannelName;
+        sentAt: Date;
+    }): Promise<void>;
+}

package/dist/core/argo-inbox/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/core/argo-inbox/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/core/argo-inbox/ports.ts"],"names":[],"mappings":""}

package/dist/core/argo-inbox/read-argo-inbox-notice.d.ts

@@ -0,0 +1,34 @@
+import type { FleetId, ShipId } from '@aeolus-fleet/common';
+import type { ConnectionStore } from '../connection/ports.js';
+import type { FollowArgoInbox } from './follow-argo-inbox.js';
+import type { ArgoAccounts } from './ports.js';
+/**
+ * What the gateway's overview tells an account of argo's inbox: nothing, or
+ * that argo has not let the gateway's ship read it, naming that ship, which
+ * the read rule argo adds lets read argo.
+ */
+export type ArgoInboxNotice = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'notLetRead';
+    readonly gatewayShip: {
+        readonly shipId: ShipId;
+        readonly name: string;
+    };
+};
+export type ReadArgoInboxNotice = (caller: {
+    fleetId: FleetId;
+    accountId: string;
+}) => Promise<ArgoInboxNotice>;
+/**
+ * Use case: while argo has not added the read rule, or removed it, nothing
+ * of argo's reaches the people allowed as argo, so the gateway's overview
+ * tells an account allowed as argo so, and where argo adds the rule (argo's
+ * inbox, section 4). Any other account, and any fleet whose inbox the
+ * gateway reads or has not asked about yet, is told nothing.
+ */
+export declare function createReadArgoInboxNotice(deps: {
+    accounts: Pick<ArgoAccounts, 'list'>;
+    inboxOf: FollowArgoInbox['inboxOf'];
+    connections: Pick<ConnectionStore, 'find'>;
+}): ReadArgoInboxNotice;

package/dist/core/argo-inbox/read-argo-inbox-notice.js

@@ -0,0 +1,20 @@
+/**
+ * Use case: while argo has not added the read rule, or removed it, nothing
+ * of argo's reaches the people allowed as argo, so the gateway's overview
+ * tells an account allowed as argo so, and where argo adds the rule (argo's
+ * inbox, section 4). Any other account, and any fleet whose inbox the
+ * gateway reads or has not asked about yet, is told nothing.
+ */
+export function createReadArgoInboxNotice(deps) {
+    return async ({ fleetId, accountId }) => {
+        if (deps.inboxOf(fleetId)?.kind !== 'notLetRead') {
+            return { kind: 'none' };
+        }
+        const [accounts, gateway] = await Promise.all([deps.accounts.list(fleetId), deps.connections.find(fleetId)]);
+        if (gateway === undefined || !accounts.some((account) => account.accountId === accountId)) {
+            return { kind: 'none' };
+        }
+        return { kind: 'notLetRead', gatewayShip: { shipId: gateway.shipId, name: gateway.name } };
+    };
+}
+//# sourceMappingURL=read-argo-inbox-notice.js.map

package/dist/core/argo-inbox/read-argo-inbox-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-argo-inbox-notice.js","sourceRoot":"","sources":["../../../src/core/argo-inbox/read-argo-inbox-notice.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA+H;IACvK,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QACtC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;YACjD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7G,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE,CAAC;YAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7F,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/argo-inbox/read-argo-section.d.ts

@@ -0,0 +1,54 @@
+import type { DeliveryId, FleetId, ShipId } from '@aeolus-fleet/common';
+import { type Stale } from '../people/stale-item.js';
+import type { Clock } from '../shared/clock.js';
+import type { FollowArgoInbox } from './follow-argo-inbox.js';
+import type { ArgoAccounts } from './ports.js';
+/** A message open at argo as Bridge's argo section lists it: by its title, a question or a report, in its job's look, new or not, stale once its asker withdrew or replaced it, and where to act on it. */
+export interface ArgoItem {
+    readonly deliveryId: DeliveryId;
+    readonly title: string;
+    readonly from: string;
+    readonly sentAt: string;
+    readonly kind: 'question' | 'report';
+    readonly look: 'decide' | 'alert' | 'notice';
+    readonly isNew: boolean;
+    readonly stale: Stale | null;
+    /** The message in the console, opened through the sign-in as argo (argo's inbox, AI2). */
+    readonly consoleUrl: string;
+}
+/** The newest message done at argo: its title, when, by whose person ship's name if an account allowed as argo did it, and whether in the console, signed in as argo. */
+export interface ArgoDone {
+    readonly title: string;
+    readonly at: string;
+    readonly by: string | null;
+    readonly isInConsole: boolean;
+}
+/** Bridge's argo section: what waits at argo, newest first, its own count, a stale question outside it, and the newest done at argo within the hour. */
+export interface ArgoSection {
+    readonly count: number;
+    readonly items: readonly ArgoItem[];
+    readonly done: ArgoDone | null;
+}
+/** None for an account not allowed as argo, or while the gateway's ship does not read argo's inbox. */
+export type ReadArgoSection = (caller: {
+    fleetId: FleetId;
+    accountId: string;
+}) => Promise<ArgoSection | null>;
+/**
+ * Use case: an account allowed as argo reads Bridge's argo section (argo's
+ * inbox, AI2 to AI4): every message open at argo as the gateway's ship
+ * reads it, questions included, each sender by its own name, apart from
+ * what waits on the person and with a count of its own. A question its
+ * asker withdrew or replaced is stale and out of the count, as in the
+ * console. Once a message is done at argo it leaves the section for every
+ * account at once, and the section says who did it and where for an hour.
+ */
+export declare function createReadArgoSection(deps: {
+    accounts: Pick<ArgoAccounts, 'list'>;
+    inboxOf: FollowArgoInbox['inboxOf'];
+    shipNames: {
+        nameOf: (fleetId: FleetId, shipId: ShipId) => Promise<string | undefined>;
+    };
+    clock: Clock;
+    consoleUrlOf: (deliveryId: DeliveryId) => string;
+}): ReadArgoSection;

package/dist/core/argo-inbox/read-argo-section.js

@@ -0,0 +1,67 @@
+import { essenceOf, NOTICE_CONTENT_TYPE } from '../people/item-job.js';
+import { staleOf } from '../people/stale-item.js';
+/** How long a message to argo shows as new after it was sent: argo's read state is argo's alone, so the gateway cannot tell it. */
+const NEW_FOR_MS = 60 * 60 * 1000;
+/** How long the line saying a message was done at argo shows after it was done. */
+const DONE_SHOWN_FOR_MS = 60 * 60 * 1000;
+function askingOf({ deliveryId, sender, sentAt, title, askedQuestionId, withdrawnQuestionId }) {
+    return { deliveryId, senderShipId: sender.shipId, sentAt, title, askedQuestionId, withdrawnQuestionId, stepId: null, withdrawnStepId: null };
+}
+/** A withdrawal alone asks nothing: it makes what it withdraws stale and is listed nowhere, as on Bridge home. */
+function isWithdrawalOnly({ askedQuestionId, withdrawnQuestionId }) {
+    return withdrawnQuestionId !== null && askedQuestionId === null;
+}
+function lookOf({ askedQuestionId, contentType }) {
+    if (askedQuestionId !== null) {
+        return 'decide';
+    }
+    return essenceOf(contentType) === NOTICE_CONTENT_TYPE ? 'notice' : 'alert';
+}
+/**
+ * Use case: an account allowed as argo reads Bridge's argo section (argo's
+ * inbox, AI2 to AI4): every message open at argo as the gateway's ship
+ * reads it, questions included, each sender by its own name, apart from
+ * what waits on the person and with a count of its own. A question its
+ * asker withdrew or replaced is stale and out of the count, as in the
+ * console. Once a message is done at argo it leaves the section for every
+ * account at once, and the section says who did it and where for an hour.
+ */
+export function createReadArgoSection(deps) {
+    const doneOf = async (fleetId, { lastDone, now }) => {
+        if (lastDone === null || now.getTime() - lastDone.at.getTime() > DONE_SHOWN_FOR_MS) {
+            return null;
+        }
+        const { title, at, signedInAccountId } = lastDone;
+        const account = signedInAccountId === null ? undefined : (await deps.accounts.list(fleetId)).find(({ accountId }) => accountId === signedInAccountId);
+        const by = account === undefined ? null : ((await deps.shipNames.nameOf(fleetId, account.personShipId)) ?? null);
+        return { title, at: at.toISOString(), by, isInConsole: signedInAccountId !== null };
+    };
+    return async ({ fleetId, accountId }) => {
+        const inbox = deps.inboxOf(fleetId);
+        if (inbox?.kind !== 'read') {
+            return null;
+        }
+        const accounts = await deps.accounts.list(fleetId);
+        if (!accounts.some((account) => account.accountId === accountId)) {
+            return null;
+        }
+        const now = deps.clock.now();
+        const asking = inbox.messages.map(askingOf);
+        const items = inbox.messages
+            .filter((message) => !isWithdrawalOnly(message))
+            .map((message) => ({
+            deliveryId: message.deliveryId,
+            title: message.title,
+            from: message.sender.name,
+            sentAt: message.sentAt.toISOString(),
+            kind: message.askedQuestionId === null ? 'report' : 'question',
+            look: lookOf(message),
+            isNew: now.getTime() - message.sentAt.getTime() < NEW_FOR_MS,
+            stale: staleOf(askingOf(message), asking),
+            consoleUrl: deps.consoleUrlOf(message.deliveryId),
+        }))
+            .reverse();
+        return { count: items.filter(({ stale }) => stale === null).length, items, done: await doneOf(fleetId, { lastDone: inbox.lastDone, now }) };
+    };
+}
+//# sourceMappingURL=read-argo-section.js.map

package/dist/core/argo-inbox/read-argo-section.js.map

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