@stratusagent/channel-slack 0.14.1 → 0.14.2

package/dist/texts.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A reply as a few short messages, the way a person texts (card 951).
+ *
+ * The `texts` reply mode posts each paragraph of a finished reply as a
+ * message of its own instead of one block of paragraphs. This file decides
+ * only where those cuts go; sizing each piece to Slack's limit and
+ * converting it to mrkdwn stay with the send path (`messageChunks`).
+ *
+ * It reads the Markdown the model wrote, before conversion, so a heading
+ * and a list item still look like what they are. Code is found with the
+ * same scanner the conversion uses (`codeRunsOf`), so a blank line inside
+ * a fence, or inside a span Slack would pair across paragraphs, is never a
+ * cut: converting each piece on its own then gives the text converting the
+ * whole would have, since nothing else in the conversion crosses a line.
+ */
+/**
+ * The most messages one reply becomes. A reply longer than that is a
+ * document rather than a few texts, and a dozen posts in a row would buzz
+ * a phone a dozen times and run into Slack's posting rate. The paragraphs
+ * past the limit stay together in the last message.
+ */
+export declare const TEXTS_MAX_MESSAGES = 5;
+/**
+ * `text` as the messages it is sent as in `texts` mode, in order: cut at
+ * blank lines outside code, the pieces that belong together rejoined, at
+ * most `TEXTS_MAX_MESSAGES` of them. Text with nothing in it comes back
+ * as it is, for the caller's ordinary handling of an empty reply.
+ */
+export declare const textingParts: (text: string) => string[];
+//# sourceMappingURL=texts.d.ts.map

package/dist/texts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texts.d.ts","sourceRoot":"","sources":["../src/texts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAyCpC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAAM,EAmCjD,CAAC"}

package/dist/texts.js

@@ -0,0 +1,101 @@
+/**
+ * A reply as a few short messages, the way a person texts (card 951).
+ *
+ * The `texts` reply mode posts each paragraph of a finished reply as a
+ * message of its own instead of one block of paragraphs. This file decides
+ * only where those cuts go; sizing each piece to Slack's limit and
+ * converting it to mrkdwn stay with the send path (`messageChunks`).
+ *
+ * It reads the Markdown the model wrote, before conversion, so a heading
+ * and a list item still look like what they are. Code is found with the
+ * same scanner the conversion uses (`codeRunsOf`), so a blank line inside
+ * a fence, or inside a span Slack would pair across paragraphs, is never a
+ * cut: converting each piece on its own then gives the text converting the
+ * whole would have, since nothing else in the conversion crosses a line.
+ */
+import { codeRunsOf } from "./mrkdwn.js";
+/**
+ * The most messages one reply becomes. A reply longer than that is a
+ * document rather than a few texts, and a dozen posts in a row would buzz
+ * a phone a dozen times and run into Slack's posting rate. The paragraphs
+ * past the limit stay together in the last message.
+ */
+export const TEXTS_MAX_MESSAGES = 5;
+/**
+ * One or more blank lines (whitespace-only counts), with the line break
+ * before them. A `\r` is whitespace here, so a reply with Windows line
+ * endings splits where its blank lines are rather than not at all.
+ */
+const BLANK_LINES = /\n[ \t\r]*\n(?:[ \t\r]*\n)*/g;
+/** A Markdown heading line. */
+const HEADING = /^ {0,3}#{1,6}(?:[ \t]|$)/;
+/** A list item: a bullet or a number, then air. */
+const LIST_ITEM = /^ {0,3}(?:[-*+]|\d{1,9}[.)])[ \t]/;
+/** A block indented under the one above it: a list item's continuation, or indented code. */
+const INDENTED = /^(?: {2,}|\t)/;
+const isList = (block) => block.split('\n').some((line) => LIST_ITEM.test(line));
+/** The rules that read only the block just before. */
+const continuesAfter = (previous, block) => 
+// A heading on its own line leads the paragraph under it.
+(HEADING.test(previous) && !previous.includes('\n'))
+    // "Here is what changed:" leads what it introduces; a closing `:tada:`
+    // introduces nothing.
+    || (/:[ \t]*$/.test(previous) && !/:[\w+-]+:[ \t]*$/.test(previous))
+    // An indented block hangs off the one above it.
+    || INDENTED.test(block);
+/**
+ * Whether `block` belongs in the same message as `group`, the blocks
+ * gathered so far for the current one. Each rule keeps together what reads
+ * wrong apart.
+ */
+const continues = (group, block) => {
+    const previous = group.at(-1) ?? '';
+    return continuesAfter(previous, block)
+        // A loose list, its items apart by blank lines, is still one list,
+        // including past an item's indented continuation: the list is the
+        // message's, not only the block just before.
+        || (LIST_ITEM.test(block) && group.some(isList));
+};
+/**
+ * `text` as the messages it is sent as in `texts` mode, in order: cut at
+ * blank lines outside code, the pieces that belong together rejoined, at
+ * most `TEXTS_MAX_MESSAGES` of them. Text with nothing in it comes back
+ * as it is, for the caller's ordinary handling of an empty reply.
+ */
+export const textingParts = (text) => {
+    const code = codeRunsOf(text);
+    const blocks = [];
+    let start = 0;
+    for (const gap of text.matchAll(BLANK_LINES)) {
+        const from = gap.index;
+        const to = from + gap[0].length;
+        if (code.some((run) => run.start < to && from < run.end)) {
+            continue;
+        }
+        blocks.push(text.slice(start, from));
+        start = to;
+    }
+    blocks.push(text.slice(start));
+    const groups = [];
+    for (const raw of blocks) {
+        const block = raw.trimEnd();
+        if (block.trim().length === 0) {
+            continue;
+        }
+        const last = groups.at(-1);
+        if (last !== undefined && continues(last, block)) {
+            last.push(block);
+        }
+        else {
+            groups.push([block]);
+        }
+    }
+    if (groups.length === 0) {
+        return [text];
+    }
+    if (groups.length > TEXTS_MAX_MESSAGES) {
+        groups.splice(TEXTS_MAX_MESSAGES - 1, groups.length, groups.slice(TEXTS_MAX_MESSAGES - 1).flat());
+    }
+    return groups.map((group) => group.join('\n\n'));
+};
+//# sourceMappingURL=texts.js.map

package/dist/texts.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratusagent/channel-slack",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,7 +21,7 @@
     "@slack/socket-mode": "^3.1.0",
     "@slack/web-api": "^8.2.0",
     "undici": "^7.29.0",
-    "@stratusagent/core": "0.14.1"
+    "@stratusagent/core": "0.14.2"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",