@aeolus-fleet/gateway 0.36.1 → 0.36.3

package/dist/core/slack/edited-post-of.js

@@ -0,0 +1,77 @@
+/**
+ * A post in Slack once something came of its item, in any place (Bridge,
+ * section 7, view sync): an item's post, as views.html draws it answered,
+ * keeps its heading and title, says what was done, when and to whom, and
+ * where it shows, its pick and buttons gone, its side marked done or ended.
+ * A message that is no item keeps its text with a line under it, as Bridge
+ * says what came of it.
+ */
+import { outcomeTextOf } from '../people/item-outcome.js';
+import { escaped, listedOptionOf } from './slack-post-of.js';
+const MS_PER_SECOND = 1_000;
+/** How many characters of an ISO time are its hours and minutes, after its date and T. */
+const CLOCK = { from: 11, to: 16 };
+/** The time as Slack shows it in each reader's own clock, with the time in UTC for a reader it cannot. */
+export function slackTimeOf(at) {
+    return `<!date^${String(Math.floor(at.getTime() / MS_PER_SECOND))}^{time}|${at.toISOString().slice(CLOCK.from, CLOCK.to)} UTC>`;
+}
+/** Whether the item's job ended as asked: answered, done or seen; anything else ended it another way. */
+const TONES = { answered: 'done', done: 'done', seen: 'done', cannot: 'ended', withdrawn: 'ended', replaced: 'ended', notSent: 'ended' };
+/** The option answered with: in full as its post lists it, else as its button named it, or by its number once the button is gone. */
+export function optionTextOf(message, option) {
+    const listed = listedOptionOf(message.item?.body ?? null, option);
+    if (listed !== undefined) {
+        return listed;
+    }
+    const button = message.buttons.find((each) => 'option' in each && each.option === option);
+    return escaped(button?.text ?? `option ${String(option)}`);
+}
+/** What was done, when and to whom, as the edited post says it. */
+function doneLineOf(message, outcome) {
+    const at = slackTimeOf(outcome.at);
+    const asker = escaped(message.item.asker);
+    switch (outcome.kind) {
+        case 'answered':
+            return outcome.option === null ? `✅ You answered at ${at} with your note, sent to ${asker}` : `✅ You answered at ${at}: *${optionTextOf(message, outcome.option)}*, sent to ${asker}`;
+        case 'done':
+            // The gateway's own step is done by what it saw, so nothing is sent for it.
+            return outcome.place === 'gateway' ? `✅ Done at ${at}` : `✅ Done at ${at}, sent to ${asker}`;
+        case 'cannot':
+            return `Marked cannot at ${at}, sent to ${asker}`;
+        case 'seen':
+            return `✅ Seen at ${at}`;
+        case 'withdrawn':
+            return `Withdrawn by ${asker}, seen at ${at}`;
+        case 'replaced':
+            return `Replaced by ${asker}, seen at ${at}`;
+        case 'notSent':
+            return `Not sent: removed from the basket at ${at}`;
+    }
+}
+/** Where it shows as done: in Slack, as views.html says it, the other places; elsewhere, what Bridge says of it. */
+function whereLineOf(outcome, bridgeUrl) {
+    const said = outcomeTextOf({ place: outcome.place, kind: outcome.kind, option: null });
+    const where = outcome.place === 'slack' ? `Bridge and the chat show it ${said.charAt(0).toLowerCase()}${said.slice(1)}` : said;
+    return `${where} · <${bridgeUrl}|Open in Bridge>`;
+}
+/** Whether the item's post says already what came of it, as another gateway edited it. */
+function isEditedAlready(item) {
+    return item.tone === 'done' || item.tone === 'ended';
+}
+/** The post edited to say what came of its item; none when it says so already. */
+export function editedPostOf(message, edit) {
+    const { item } = message;
+    if (item === null) {
+        const line = `_${outcomeTextOf(edit.outcome)}_`;
+        return { text: message.text.endsWith(line) ? message.text : `${message.text}\n\n${line}`, item: null, buttons: [] };
+    }
+    if (isEditedAlready(item)) {
+        return undefined;
+    }
+    return {
+        text: message.text,
+        item: { ...item, body: doneLineOf({ ...message, item }, edit.outcome), aside: null, footer: whereLineOf(edit.outcome, edit.bridgeUrl), tone: TONES[edit.outcome.kind] },
+        buttons: [],
+    };
+}
+//# sourceMappingURL=edited-post-of.js.map

package/dist/core/slack/edited-post-of.js.map

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

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

@@ -190,6 +190,27 @@ export interface SlackLinks {
         at: Date;
     }): Promise<void>;
 }
+/** A person's ask to link Slack (Bridge, CC14): its step's uuid, whether the step was sent, and its message, none until sent or when the fleet refused it. */
+export interface SlackLinkStep {
+    readonly stepId: string;
+    readonly isTold: boolean;
+    readonly stepMessageId: MessageId | null;
+}
+/** Outbound port: each person's open ask to link Slack, in the gateway's database. */
+export interface SlackLinkSteps {
+    /** The person's open ask, opened under this uuid unless one is open already, as two reads at once find. */
+    open(fleetId: FleetId, step: {
+        personShipId: ShipId;
+        stepId: string;
+    }): Promise<SlackLinkStep>;
+    /** Marks it told, with the message of the step, none when the fleet refused it. */
+    markTold(fleetId: FleetId, step: {
+        personShipId: ShipId;
+        stepMessageId: MessageId | null;
+    }): Promise<void>;
+    /** Closes it at a link, so a later unlinked read asks again: the ask closed, none when none was open. */
+    close(fleetId: FleetId, personShipId: ShipId): Promise<SlackLinkStep | undefined>;
+}
 /** Outbound port: a bot's posts and reactions in Slack, with its bot token. */
 export interface SlackMessages {
     /** A message only one person sees, in a conversation (chat.postEphemeral), with a button that opens an address. */
@@ -203,8 +224,9 @@ export interface SlackMessages {
         };
     }): Promise<Result<undefined, SlackRefusal>>;
     /**
-     * A message in a conversation, or a thread of it, with a button per option
-     * to answer (chat.postMessage): the Slack message it is. A press of a
+     * A message in a conversation, or a thread of it, an item framed as
+     * views.html draws it, with its buttons (chat.postMessage): the Slack
+     * message it is. A press of a
      * button names the fleet message it shows, so a press is matched before
      * the gateway keeps the Slack message.
      */
@@ -212,8 +234,7 @@ export interface SlackMessages {
         messageId: MessageId;
         channel: string;
         threadTs: string | null;
-        text: string;
-        buttons: readonly SlackButton[];
+        message: SlackMessage;
     }): Promise<Result<{
         channel: string;
         ts: string;
@@ -230,17 +251,18 @@ export interface SlackMessages {
         ts: string;
         name: string;
     }): Promise<Result<undefined, SlackRefusal>>;
-    /** A message's text as Slack holds it, in a conversation or a thread of it (conversations.history, conversations.replies). */
-    textOf(botToken: string, message: {
+    /** A message as Slack holds it, in a conversation or a thread of it (conversations.history, conversations.replies): the item it frames as the gateway posted or edited it, or its text alone. */
+    messageOf(botToken: string, message: {
         channel: string;
         ts: string;
         threadTs: string | null;
-    }): Promise<Result<string, SlackRefusal>>;
-    /** Gives a message the text given, its buttons gone (chat.update). */
+    }): Promise<Result<SlackMessage, SlackRefusal>>;
+    /** Gives a message the item or text given, with an item's buttons given, naming the fleet message as its post's do; none once something came of it (chat.update). */
     update(botToken: string, message: {
         channel: string;
         ts: string;
-        text: string;
+        messageId: MessageId;
+        message: SlackMessage;
     }): Promise<Result<undefined, SlackRefusal>>;
 }
 /**
@@ -265,14 +287,52 @@ export interface SlackEvents {
     untakenSince(before: Date): Promise<KeptSlackEvent[]>;
     remove(fleetId: FleetId, eventId: string): Promise<void>;
 }
-/** A button under a post: under a question, its option's label and the option it answers; or Seen, under an item with no other (Bridge, section 6). */
+/**
+ * A button under a post: under a question, its option's number and label,
+ * the option it answers, and whether it is the asker's pick, filled; under a
+ * step, Open on its link and Done, Open filled; under what waits at argo,
+ * Open in the console as argo, plain (argo's inbox, AI2); or Seen, under an
+ * item with no other (Bridge, section 6).
+ */
 export type SlackButton = {
     readonly text: string;
     readonly option: number;
+    readonly isPicked: boolean;
+} | {
+    readonly text: string;
+    readonly url: string;
+    readonly isPlain?: true;
+} | {
+    readonly text: string;
+    readonly isDone: true;
 } | {
     readonly text: string;
     readonly isSeen: true;
 };
+/** How an item's post is marked at its side (views.html): asking while it waits on the person, aware for what only tells, argo for what waits at argo (argo's inbox, AI4), done once answered, done or seen, ended for any other outcome. */
+export type SlackTone = 'asking' | 'aware' | 'argo' | 'done' | 'ended';
+/**
+ * An item as its post in Slack shows it (Bridge, views.html): headed by its
+ * asker and job, such as Question from orchestrator-1 · Decide; its title;
+ * what it asks with, or once something came of it, what and where; a quiet
+ * line under that, such as the asker's pick; and the line under its
+ * buttons, such as Open in Bridge. Each is in Slack's markup.
+ */
+export interface SlackItem {
+    readonly asker: string;
+    readonly heading: string;
+    readonly title: string;
+    readonly body: string | null;
+    readonly aside: string | null;
+    readonly footer: string | null;
+    readonly tone: SlackTone;
+}
+/** A post as the gateway gives it to Slack and reads it back: what a notification of it says, the item it frames, none for a message that is no item, and its buttons. */
+export interface SlackMessage {
+    readonly text: string;
+    readonly item: SlackItem | null;
+    readonly buttons: readonly SlackButton[];
+}
 /** Outbound port: the fleet messages in Slack, by person ship. */
 export interface SlackPosts {
     /** Keeps the post by its fleet, person ship and message, as it is now. */

package/dist/core/slack/pressed-post-of.d.ts

@@ -0,0 +1,9 @@
+import type { SlackItem, SlackMessage } from './ports.js';
+/** A post that frames an item, as a question's does. */
+export type ItemPost = SlackMessage & {
+    readonly item: SlackItem;
+};
+/** The post while the option pressed, named in full, is sent to the asker. */
+export declare function sendingPostOf(post: ItemPost, option: number): SlackMessage;
+/** The post once the fleet did not take the answer, with the reason it gave. */
+export declare function notSentPostOf(post: ItemPost, reason: string): SlackMessage;

package/dist/core/slack/pressed-post-of.js

@@ -0,0 +1,18 @@
+/**
+ * A question's post as a press in Slack sends its answer
+ * (aeolus-fleet#1573): while it is sent, the option and to whom, its
+ * buttons gone so it is not pressed twice; once the fleet did not take it,
+ * why, its buttons back to press again. Both keep the post's heading, title
+ * and context; the line under them says it, in place of the asker's pick.
+ */
+import { optionTextOf } from './edited-post-of.js';
+import { escaped } from './slack-post-of.js';
+/** The post while the option pressed, named in full, is sent to the asker. */
+export function sendingPostOf(post, option) {
+    return { ...post, item: { ...post.item, aside: `Sending *${optionTextOf(post, option)}* to ${escaped(post.item.asker)}…` }, buttons: [] };
+}
+/** The post once the fleet did not take the answer, with the reason it gave. */
+export function notSentPostOf(post, reason) {
+    return { ...post, item: { ...post.item, aside: `⚠️ Not sent: ${escaped(reason)}. Press an option to try again.` } };
+}
+//# sourceMappingURL=pressed-post-of.js.map

package/dist/core/slack/pressed-post-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressed-post-of.js","sourceRoot":"","sources":["../../../src/core/slack/pressed-post-of.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,MAAc;IAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC5I,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,MAAc;IAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,gBAAgB,OAAO,CAAC,MAAM,CAAC,iCAAiC,EAAE,EAAE,CAAC;AACtH,CAAC"}

package/dist/core/slack/read-slack-dropped-out.d.ts

@@ -0,0 +1,23 @@
+import type { Actor } from '../actors/authenticate-actor.js';
+import { type RoutingDefaults, type Routes } from '../people/routing.js';
+import type { SlackApps, SlackLinks } from './ports.js';
+/** Why Slack shows a person nothing now: the fleet's own bot, by its name, was removed in Slack. */
+export interface SlackDroppedOut {
+    readonly botName: string;
+}
+export type ReadSlackDroppedOut = (input: {
+    actor: Actor;
+}) => Promise<SlackDroppedOut | null>;
+/**
+ * Use case: whether Slack dropped out for the person (Bridge, section 9: a
+ * place fails, it drops out and Bridge says why). It did when the fleet's
+ * own bot was removed in Slack (app_uninstalled, tokens_revoked) while it
+ * showed the person something: they linked Slack and turned it on, or left
+ * it on, for a job. Nothing to an account with no person ship in the fleet.
+ */
+export declare function createReadSlackDroppedOut(deps: {
+    apps: Pick<SlackApps, 'gatewayBot'>;
+    links: Pick<SlackLinks, 'ofAccount'>;
+    routes: Routes;
+    defaults: RoutingDefaults;
+}): ReadSlackDroppedOut;

package/dist/core/slack/read-slack-dropped-out.js

@@ -0,0 +1,24 @@
+import { ITEM_JOBS, routingOf } from '../people/routing.js';
+import { botStateOf } from './slack-app.js';
+/**
+ * Use case: whether Slack dropped out for the person (Bridge, section 9: a
+ * place fails, it drops out and Bridge says why). It did when the fleet's
+ * own bot was removed in Slack (app_uninstalled, tokens_revoked) while it
+ * showed the person something: they linked Slack and turned it on, or left
+ * it on, for a job. Nothing to an account with no person ship in the fleet.
+ */
+export function createReadSlackDroppedOut(deps) {
+    return async ({ actor }) => {
+        if (actor.kind !== 'account' || actor.personShipId === null) {
+            return null;
+        }
+        const bot = await deps.apps.gatewayBot(actor.fleetId);
+        if (bot === undefined || botStateOf(bot) !== 'removedInSlack') {
+            return null;
+        }
+        const [link, routes] = await Promise.all([deps.links.ofAccount(actor.fleetId, actor.accountId), deps.routes.list({ fleetId: actor.fleetId, shipId: actor.personShipId })]);
+        const routing = routingOf(routes, deps.defaults);
+        return link !== undefined && ITEM_JOBS.some((job) => routing.isOn(job, 'slack')) ? { botName: bot.name } : null;
+    };
+}
+//# sourceMappingURL=read-slack-dropped-out.js.map

package/dist/core/slack/read-slack-dropped-out.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-slack-dropped-out.js","sourceRoot":"","sources":["../../../src/core/slack/read-slack-dropped-out.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAqC,MAAM,sBAAsB,CAAC;AAE/F,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAS5C;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA8H;IACtK,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,GAAG,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,gBAAgB,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3K,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/slack/read-slack-link.d.ts

@@ -1,4 +1,5 @@
 import type { Actor } from '../actors/authenticate-actor.js';
+import type { AsksToLinkSlack } from './ask-to-link-slack.js';
 import type { SlackApps, SlackLinks, SlackWorkspaces } from './ports.js';
 /** A person's Slack link as Bridge's settings show it: the workspace, and the Slack name linked, none while unlinked. */
 export interface ShownSlackLink {
@@ -14,9 +15,12 @@ export type ReadSlackLink = (input: {
  * Use case: the person's Slack link in Bridge's settings (gateway scopes 9.6),
  * offered once the fleet's own bot is in the fleet's workspace, which then
  * has its name; nothing to an account with no person ship in the fleet.
+ * A person it offers Link Slack to is asked to link Slack by a step
+ * (Bridge, BG7).
  */
 export declare function createReadSlackLink(deps: {
     workspaces: Pick<SlackWorkspaces, 'find'>;
     apps: Pick<SlackApps, 'gatewayBot'>;
     links: Pick<SlackLinks, 'ofAccount'>;
+    askToLink: AsksToLinkSlack;
 }): ReadSlackLink;

package/dist/core/slack/read-slack-link.js

@@ -2,6 +2,8 @@
  * Use case: the person's Slack link in Bridge's settings (gateway scopes 9.6),
  * offered once the fleet's own bot is in the fleet's workspace, which then
  * has its name; nothing to an account with no person ship in the fleet.
+ * A person it offers Link Slack to is asked to link Slack by a step
+ * (Bridge, BG7).
  */
 export function createReadSlackLink(deps) {
     return async ({ actor }) => {
@@ -14,6 +16,9 @@ export function createReadSlackLink(deps) {
             return null;
         }
         const link = await deps.links.ofAccount(actor.fleetId, actor.accountId);
+        if (link === undefined) {
+            await deps.askToLink({ fleetId: actor.fleetId, personShipId: actor.personShipId, workspaceName: workspace.teamName });
+        }
         return { workspaceName: workspace.teamName, link: link === undefined ? null : { slackName: link.slackName } };
     };
 }

package/dist/core/slack/read-slack-link.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-slack-link.js","sourceRoot":"","sources":["../../../src/core/slack/read-slack-link.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA8H;IAChK,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpG,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxE,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;IAChH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-slack-link.js","sourceRoot":"","sources":["../../../src/core/slack/read-slack-link.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA0J;IAC5L,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpG,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxH,CAAC;QACD,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;IAChH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/slack/show-in-slack.js

@@ -47,12 +47,12 @@ export function createShowInSlack(deps) {
         const gatewayBot = isOn ? await deps.apps.gatewayBot(fleetId) : undefined;
         return isInSlack(gatewayBot) ? { app: gatewayBot, channel: slackUserId, threadTs: null } : undefined;
     };
-    /** Posts it, waiting out Slack's rate limits: the Slack message, or none when Slack refused it. */
+    /** Posts it, waiting out Slack's rate limits: the conversation Slack answered it is in and its Slack message, or none when Slack refused it. */
     const posted = async (where, shown) => {
         for (let tried = 1;; tried += 1) {
-            const answered = await deps.slack.post(where.app.bot.token, { messageId: shown.messageId, channel: where.channel, threadTs: where.threadTs, text: shown.text, buttons: shown.buttons });
+            const answered = await deps.slack.post(where.app.bot.token, { messageId: shown.messageId, channel: where.channel, threadTs: where.threadTs, message: shown.message });
             if (answered.isOk) {
-                return answered.value.ts;
+                return answered.value;
             }
             if (answered.error.kind !== 'rateLimited' || tried >= RATE_LIMITED_TRIES) {
                 return undefined;
@@ -77,13 +77,14 @@ export function createShowInSlack(deps) {
                 return 'notShown';
             }
             const app = await deps.apps.find(post.fleetId, post.appId);
-            const shown = slackPostOf(delivery, { bridgeUrl: deps.bridgeUrlOf(post.fleetId), isHeadedBySender: app?.shipId === null });
-            const ts = isInSlack(app) ? await posted({ app, channel: post.channel, threadTs: post.threadTs }, { messageId: post.messageId, text: shown.text, buttons: shown.buttons }) : undefined;
-            if (ts === undefined) {
+            const { text, item, buttons } = slackPostOf(delivery, { bridgeUrl: deps.bridgeUrlOf(post.fleetId), isHeadedBySender: app?.shipId === null });
+            const inSlack = isInSlack(app) ? await posted({ app, channel: post.channel, threadTs: post.threadTs }, { messageId: post.messageId, message: { text, item, buttons } }) : undefined;
+            if (inSlack === undefined) {
                 await deps.posts.remove(post.fleetId, post);
                 return 'notShown';
             }
-            await deps.posts.save({ ...post, ts });
+            // Kept in the conversation Slack answered: a post to a person's user id is in their direct messages, which Slack names by an id of its own.
+            await deps.posts.save({ ...post, ...inSlack });
         }
         return 'shown';
     };

package/dist/core/slack/show-in-slack.js.map

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

package/dist/core/slack/slack-post-of.d.ts

@@ -1,25 +1,37 @@
 import type { PersonDelivery } from '../people/ports.js';
-import type { SlackButton } from './ports.js';
+import type { SlackButton, SlackMessage } from './ports.js';
 /** The most a Slack message shows in full. */
 export declare const MESSAGE_MAX_LENGTH = 40000;
 /** The most one block of a Slack message shows. */
 export declare const BLOCK_MAX_LENGTH = 3000;
-/** What a delivery shows as in Slack: its text in Slack's markup, or a link to the gateway for what Slack does not show in full; with a button per option, or Seen. */
-export interface SlackShown {
+/** The most characters Slack takes in a button's text: it refuses the whole post for one longer. */
+export declare const BUTTON_TEXT_MAX_LENGTH = 75;
+/**
+ * The option as its question's post lists it in full, in Slack's markup,
+ * numbered as its button is: so an edit names it whole from the post alone,
+ * though its button cut it. None when the post lists no options: then every
+ * button's text is short enough to be whole.
+ */
+export declare function listedOptionOf(body: string | null, key: number): string | undefined;
+/** What a delivery shows as in Slack: an item framed as views.html draws it, its text in Slack's markup, or a link to the gateway for what Slack does not show in full; with its buttons. */
+export interface SlackShown extends SlackMessage {
     readonly kind: 'shown' | 'link';
-    readonly text: string;
-    readonly buttons: readonly SlackButton[];
 }
 /** The button under an item with no other: seeing it is what it asks, or all the person does with it in Slack (Bridge, section 6). */
 export declare const SEEN: SlackButton;
+/** The button under a step that marks it done (Bridge, CC14). */
+export declare const DONE: SlackButton;
+/** Text as Slack shows it as it is: its control characters escaped. */
+export declare function escaped(text: string): string;
 /**
- * What a delivery shows as in Slack (gateway scopes 9.5 step 2): text and
- * Markdown as text, Markdown in Slack's markup; a question as its title and
- * context, one button per option; JSON as a code block. Another content
- * type, or more than Slack shows in full (40,000 characters, a block 3,000),
- * goes as a link to the gateway's pages. The gateway's own bot heads it
- * with the sender's name. An item with no other button, an alert, a notice
- * or any other message, gets Seen.
+ * What a delivery shows as in Slack (gateway scopes 9.5 step 2): an item,
+ * a question, a step, an alert or a notice, as views.html draws it; text and
+ * Markdown as text, Markdown in Slack's markup; JSON as a code block.
+ * Another content type, or more than Slack shows in full (40,000
+ * characters, a block 3,000), goes as a link to the gateway's pages. The
+ * gateway's own bot heads a message that is no item with the sender's name.
+ * An item with no other button, an alert, a notice or any other message,
+ * gets Seen.
  */
 export declare function slackPostOf(delivery: PersonDelivery, shown: {
     bridgeUrl: string;