@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.71

package/dist/adapters/intake.js

@@ -1,42 +1,111 @@
-import { evaluateAutoReplyPolicy } from "../trigger.js";
+import { assertSessionKeyBelongsToConversation, assertConversationId, } from "../sessions/session-key.js";
+import { formatAlreadyWorking, formatNothingRunning } from "./messages.js";
+import { resolveOnlyScopedStopTarget, resolveStopTarget } from "./shared.js";
+/**
+ * Recognize a magic word: a highest-priority chat control phrase that bypasses
+ * trigger policy and queueing (see CONTEXT.md). One grammar for every
+ * platform: optional leading slash, optional `@botname` suffix, any case.
+ */
+export function matchMagicWord(text) {
+    return /^\/?stop(?:@\w+)?$/i.test(text.trim()) ? "stop" : null;
+}
 /**
  * Shared message ingress pipeline for platform adapters.
  *
- * Platform adapters still normalize SDK events and handle platform-specific stop
- * semantics. This module owns the common trigger/log/attachment/queue/handler
- * ordering for messages that may start an agent run.
+ * Platform adapters normalize SDK events; this module owns the ordering for
+ * messages that may start an agent run:
+ *
+ *   magic word → trigger policy → attachments → log → busy policy → queue → dispatch
+ *
+ * Magic words are matched before the trigger gate — `stop` must never wait on
+ * trigger filtering or queue behind a running agent turn. Adapters state
+ * platform policy as data (`magicWord`, `busyPolicy`) instead of callbacks.
  */
 export async function processMessageIntake(options) {
-    const triggerResult = options.isAutoReplyCandidate
-        ? await evaluateAutoReplyPolicy({ event: options.eventBase, workingDir: options.workingDir })
-        : { trigger: true, reason: "addressed" };
-    if (!triggerResult.trigger) {
+    assertConversationId(options.eventBase.conversationId);
+    if (options.eventBase.sessionKey !== undefined) {
+        assertSessionKeyBelongsToConversation(options.eventBase.sessionKey, options.eventBase.conversationId);
+    }
+    if (matchMagicWord(options.magicWord.text ?? options.eventBase.text) === "stop") {
         options.log?.({ ...options.logEntryBase, attachments: [] });
-        options.onNotTriggered?.();
-        return;
+        await handleStopMagicWord(options);
+        return "magic-word";
+    }
+    if (!options.addressed) {
+        options.log?.({ ...options.logEntryBase, attachments: [] });
+        return "not-triggered";
+    }
+    function prepareEvent(attachments) {
+        const event = { ...options.eventBase, attachments };
+        options.log?.({ ...options.logEntryBase, attachments });
+        return event;
+    }
+    async function rejectedWhileBusy() {
+        const sessionKey = options.eventBase.sessionKey ?? options.eventBase.conversationId;
+        if (!options.handler.isRunning(options.eventBase.address, sessionKey))
+            return false;
+        await options.bot.postMessage(options.eventBase.conversationId, formatAlreadyWorking(options.bot, "/stop"));
+        return true;
+    }
+    function dispatch(event) {
+        const context = options.createContext(event);
+        return options.handler.handleEvent(event, options.bot, context);
     }
     if (options.deferAttachmentsUntilRun) {
+        // Busy rejection happens inside the queued work here, so the outcome is
+        // already "enqueued" by the time it is evaluated.
         options.enqueue(options.queueKey, async () => {
-            const attachments = await options.processAttachments();
-            const event = { ...options.eventBase, attachments };
-            options.log?.({ ...options.logEntryBase, attachments });
-            if (options.beforeEnqueue && !(await options.beforeEnqueue(event))) {
+            const event = prepareEvent(await options.processAttachments());
+            if (options.busyPolicy === "reject" && (await rejectedWhileBusy()))
                 return;
-            }
-            const context = options.createContext(event);
-            return options.handler.handleEvent(event, options.bot, context);
+            return dispatch(event);
         });
-        return;
+        return "enqueued";
+    }
+    const event = prepareEvent(await options.processAttachments());
+    if (options.busyPolicy === "reject" && (await rejectedWhileBusy()))
+        return "rejected-busy";
+    options.enqueue(options.queueKey, () => dispatch(event));
+    return "enqueued";
+}
+/**
+ * Resolve and stop the session a magic-word `stop` targets. When nothing is
+ * running, reply only if the message addressed the bot — an unaddressed
+ * "stop" in a busy channel should never make the bot pipe up.
+ */
+async function handleStopMagicWord(options) {
+    const { handler, bot, eventBase, magicWord } = options;
+    const address = eventBase.address;
+    const conversationId = eventBase.conversationId;
+    const sessionKey = eventBase.sessionKey;
+    let target = resolveStopTarget({ handler, address, sessionKey });
+    if (!target && widensToScopedSession(magicWord.scopeFallback, sessionKey, conversationId)) {
+        target = resolveOnlyScopedStopTarget(handler, address);
     }
-    const attachments = await options.processAttachments();
-    const event = { ...options.eventBase, attachments };
-    options.log?.({ ...options.logEntryBase, attachments });
-    if (options.beforeEnqueue && !(await options.beforeEnqueue(event))) {
-        return;
+    if (target) {
+        if (eventBase.thread_ts) {
+            await handler.handleStop(address, target, bot, eventBase.thread_ts);
+        }
+        else {
+            await handler.handleStop(address, target, bot);
+        }
     }
-    options.enqueue(options.queueKey, () => {
-        const context = options.createContext(event);
-        return options.handler.handleEvent(event, options.bot, context);
-    });
+    else if (magicWord.addressed) {
+        if (eventBase.thread_ts && bot.postInThread) {
+            await bot.postInThread(conversationId, eventBase.thread_ts, formatNothingRunning(bot));
+        }
+        else {
+            await bot.postMessage(conversationId, formatNothingRunning(bot));
+        }
+    }
+}
+function widensToScopedSession(scopeFallback, sessionKey, conversationId) {
+    if (scopeFallback === "never")
+        return false;
+    if (scopeFallback === "always")
+        return true;
+    // "top-level": only a message aimed at the persistent conversation session
+    // may widen to the single running scoped session; thread messages stay put.
+    return sessionKey === undefined || sessionKey === conversationId;
 }
 //# sourceMappingURL=intake.js.map

package/dist/adapters/intake.js.map

@@ -1 +1 @@
-{"version":3,"file":"intake.js","sourceRoot":"","sources":["../../src/adapters/intake.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGxD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqC;IAErC,MAAM,aAAa,GAAG,OAAO,CAAC,oBAAoB;QAChD,CAAC,CAAC,MAAM,uBAAuB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7F,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAY,CAAC;IAEtD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;QACrC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,WAAW,EAAY,CAAC;YAC9D,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;YACxD,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnE,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,WAAW,EAAY,CAAC;IAC9D,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;IAExD,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { ConversationEvent } from \"../adapter.js\";\nimport { evaluateAutoReplyPolicy } from \"../trigger.js\";\nimport type { MessageIntakeOptions } from \"./types.js\";\n\n/**\n * Shared message ingress pipeline for platform adapters.\n *\n * Platform adapters still normalize SDK events and handle platform-specific stop\n * semantics. This module owns the common trigger/log/attachment/queue/handler\n * ordering for messages that may start an agent run.\n */\nexport async function processMessageIntake<TEvent extends ConversationEvent>(\n  options: MessageIntakeOptions<TEvent>,\n): Promise<void> {\n  const triggerResult = options.isAutoReplyCandidate\n    ? await evaluateAutoReplyPolicy({ event: options.eventBase, workingDir: options.workingDir })\n    : ({ trigger: true, reason: \"addressed\" } as const);\n\n  if (!triggerResult.trigger) {\n    options.log?.({ ...options.logEntryBase, attachments: [] });\n    options.onNotTriggered?.();\n    return;\n  }\n\n  if (options.deferAttachmentsUntilRun) {\n    options.enqueue(options.queueKey, async () => {\n      const attachments = await options.processAttachments();\n      const event = { ...options.eventBase, attachments } as TEvent;\n      options.log?.({ ...options.logEntryBase, attachments });\n      if (options.beforeEnqueue && !(await options.beforeEnqueue(event))) {\n        return;\n      }\n      const context = options.createContext(event);\n      return options.handler.handleEvent(event, options.bot, context);\n    });\n    return;\n  }\n\n  const attachments = await options.processAttachments();\n  const event = { ...options.eventBase, attachments } as TEvent;\n  options.log?.({ ...options.logEntryBase, attachments });\n\n  if (options.beforeEnqueue && !(await options.beforeEnqueue(event))) {\n    return;\n  }\n\n  options.enqueue(options.queueKey, () => {\n    const context = options.createContext(event);\n    return options.handler.handleEvent(event, options.bot, context);\n  });\n}\n"]}
+{"version":3,"file":"intake.js","sourceRoot":"","sources":["../../src/adapters/intake.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assertSessionKeyBelongsToConversation,\n  assertConversationId,\n} from \"../sessions/session-key.js\";\nimport type { ConversationEvent } from \"./index.js\";\nimport { formatAlreadyWorking, formatNothingRunning } from \"./messages.js\";\nimport { resolveOnlyScopedStopTarget, resolveStopTarget } from \"./shared.js\";\nimport type { MessageIntakeOptions, MessageIntakeOutcome } from \"./types.js\";\n\n/**\n * Recognize a magic word: a highest-priority chat control phrase that bypasses\n * trigger policy and queueing (see CONTEXT.md). One grammar for every\n * platform: optional leading slash, optional `@botname` suffix, any case.\n */\nexport function matchMagicWord(text: string): \"stop\" | null {\n  return /^\\/?stop(?:@\\w+)?$/i.test(text.trim()) ? \"stop\" : null;\n}\n\n/**\n * Shared message ingress pipeline for platform adapters.\n *\n * Platform adapters normalize SDK events; this module owns the ordering for\n * messages that may start an agent run:\n *\n *   magic word → trigger policy → attachments → log → busy policy → queue → dispatch\n *\n * Magic words are matched before the trigger gate — `stop` must never wait on\n * trigger filtering or queue behind a running agent turn. Adapters state\n * platform policy as data (`magicWord`, `busyPolicy`) instead of callbacks.\n */\nexport async function processMessageIntake<TEvent extends ConversationEvent>(\n  options: MessageIntakeOptions<TEvent>,\n): Promise<MessageIntakeOutcome> {\n  assertConversationId(options.eventBase.conversationId);\n  if (options.eventBase.sessionKey !== undefined) {\n    assertSessionKeyBelongsToConversation(\n      options.eventBase.sessionKey,\n      options.eventBase.conversationId,\n    );\n  }\n  if (matchMagicWord(options.magicWord.text ?? options.eventBase.text) === \"stop\") {\n    options.log?.({ ...options.logEntryBase, attachments: [] });\n    await handleStopMagicWord(options);\n    return \"magic-word\";\n  }\n\n  if (!options.addressed) {\n    options.log?.({ ...options.logEntryBase, attachments: [] });\n    return \"not-triggered\";\n  }\n\n  function prepareEvent(attachments: unknown[]): TEvent {\n    const event = { ...options.eventBase, attachments } as TEvent;\n    options.log?.({ ...options.logEntryBase, attachments });\n    return event;\n  }\n\n  async function rejectedWhileBusy(): Promise<boolean> {\n    const sessionKey = options.eventBase.sessionKey ?? options.eventBase.conversationId;\n    if (!options.handler.isRunning(options.eventBase.address, sessionKey)) return false;\n    await options.bot.postMessage(\n      options.eventBase.conversationId,\n      formatAlreadyWorking(options.bot, \"/stop\"),\n    );\n    return true;\n  }\n\n  function dispatch(event: TEvent): Promise<void> {\n    const context = options.createContext(event);\n    return options.handler.handleEvent(event, options.bot, context);\n  }\n\n  if (options.deferAttachmentsUntilRun) {\n    // Busy rejection happens inside the queued work here, so the outcome is\n    // already \"enqueued\" by the time it is evaluated.\n    options.enqueue(options.queueKey, async () => {\n      const event = prepareEvent(await options.processAttachments());\n      if (options.busyPolicy === \"reject\" && (await rejectedWhileBusy())) return;\n      return dispatch(event);\n    });\n    return \"enqueued\";\n  }\n\n  const event = prepareEvent(await options.processAttachments());\n  if (options.busyPolicy === \"reject\" && (await rejectedWhileBusy())) return \"rejected-busy\";\n  options.enqueue(options.queueKey, () => dispatch(event));\n  return \"enqueued\";\n}\n\n/**\n * Resolve and stop the session a magic-word `stop` targets. When nothing is\n * running, reply only if the message addressed the bot — an unaddressed\n * \"stop\" in a busy channel should never make the bot pipe up.\n */\nasync function handleStopMagicWord<TEvent extends ConversationEvent>(\n  options: MessageIntakeOptions<TEvent>,\n): Promise<void> {\n  const { handler, bot, eventBase, magicWord } = options;\n  const address = eventBase.address;\n  const conversationId = eventBase.conversationId;\n  const sessionKey = eventBase.sessionKey;\n\n  let target = resolveStopTarget({ handler, address, sessionKey });\n  if (!target && widensToScopedSession(magicWord.scopeFallback, sessionKey, conversationId)) {\n    target = resolveOnlyScopedStopTarget(handler, address);\n  }\n\n  if (target) {\n    if (eventBase.thread_ts) {\n      await handler.handleStop(address, target, bot, eventBase.thread_ts);\n    } else {\n      await handler.handleStop(address, target, bot);\n    }\n  } else if (magicWord.addressed) {\n    if (eventBase.thread_ts && bot.postInThread) {\n      await bot.postInThread(conversationId, eventBase.thread_ts, formatNothingRunning(bot));\n    } else {\n      await bot.postMessage(conversationId, formatNothingRunning(bot));\n    }\n  }\n}\n\nfunction widensToScopedSession(\n  scopeFallback: \"top-level\" | \"always\" | \"never\",\n  sessionKey: string | undefined,\n  conversationId: string,\n): boolean {\n  if (scopeFallback === \"never\") return false;\n  if (scopeFallback === \"always\") return true;\n  // \"top-level\": only a message aimed at the persistent conversation session\n  // may widen to the single running scoped session; thread messages stay put.\n  return sessionKey === undefined || sessionKey === conversationId;\n}\n"]}

package/dist/adapters/markdown-tables.d.ts

@@ -0,0 +1,19 @@
+import type Token from "markdown-it/lib/token.mjs";
+import type { MarkdownTable } from "./types.js";
+export type { MarkdownTable } from "./types.js";
+/**
+ * Models sometimes draw the separator row in ASCII-art style (`+---+---+`),
+ * which GFM does not recognise. Rewriting those pluses is enough to make the
+ * table parse; every other line is left exactly as written.
+ */
+export declare function normalizeMarkdownTables(source: string): string;
+export declare function inlinePlainText(tokens: Token[] | null | undefined): string;
+/** Every table in `source`, in document order, with its line span. */
+export declare function extractMarkdownTables(source: string): MarkdownTable[];
+export declare function displayWidth(text: string): number;
+/**
+ * Render a table as aligned monospace rows, for a platform with no table
+ * support of its own. The caller decides whether to fence it.
+ */
+export declare function renderMonospaceTable(table: MarkdownTable): string;
+//# sourceMappingURL=markdown-tables.d.ts.map

package/dist/adapters/markdown-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-tables.d.ts","sourceRoot":"","sources":["../../src/adapters/markdown-tables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkBhD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS1E;AA8CD,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAUrE;AAoBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAsBjE"}

package/dist/adapters/markdown-tables.js

@@ -0,0 +1,152 @@
+import MarkdownIt from "markdown-it";
+/**
+ * Locating GFM tables in a response, as plain data.
+ *
+ * Every platform needs the same thing from a markdown table and renders it
+ * differently: Slack has a native table block, Discord has no table support at
+ * all and needs monospace alignment. Only the *finding* is common, so that is
+ * what lives here — callers keep their own rendering, and neither has to carry
+ * a second markdown parser to get at the cells.
+ *
+ * Prose is deliberately not re-serialized from tokens anywhere: callers slice
+ * it verbatim from the source using the line span reported here, so the
+ * platform's own renderer stays responsible for everything that is not a table.
+ */
+const markdown = new MarkdownIt({ html: false });
+/**
+ * Models sometimes draw the separator row in ASCII-art style (`+---+---+`),
+ * which GFM does not recognise. Rewriting those pluses is enough to make the
+ * table parse; every other line is left exactly as written.
+ */
+export function normalizeMarkdownTables(source) {
+    return source
+        .split("\n")
+        .map((line) => {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("|") || !trimmed.endsWith("|"))
+            return line;
+        if (!/^[|+\-:\s]+$/.test(trimmed) || !trimmed.includes("+"))
+            return line;
+        return line.replaceAll("+", "|");
+    })
+        .join("\n");
+}
+export function inlinePlainText(tokens) {
+    if (!tokens)
+        return "";
+    let text = "";
+    for (const token of tokens) {
+        if (token.type === "text" || token.type === "code_inline")
+            text += token.content;
+        else if (token.type === "softbreak" || token.type === "hardbreak")
+            text += "\n";
+        else if (token.children)
+            text += inlinePlainText(token.children);
+    }
+    return text;
+}
+function parseOne(tokens, index) {
+    const open = tokens[index];
+    if (open?.type !== "table_open" || !open.map)
+        return null;
+    const headers = [];
+    const rows = [];
+    let currentRow = null;
+    let inHead = false;
+    let i = index + 1;
+    for (; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === undefined || token.type === "table_close")
+            break;
+        switch (token.type) {
+            case "thead_open":
+                inHead = true;
+                break;
+            case "thead_close":
+                inHead = false;
+                break;
+            case "tr_open":
+                currentRow = [];
+                break;
+            case "tr_close":
+                if (!currentRow)
+                    break;
+                if (inHead)
+                    headers.push(...currentRow);
+                else
+                    rows.push(currentRow);
+                currentRow = null;
+                break;
+            case "inline":
+                currentRow?.push(inlinePlainText(token.children) || token.content);
+                break;
+        }
+    }
+    // A header with no body is not a table anyone wants rendered as one.
+    if (!headers.length || !rows.length)
+        return null;
+    return {
+        table: { headers, rows, startLine: open.map[0], endLine: tokens[i]?.map?.[1] ?? open.map[1] },
+        next: i,
+    };
+}
+/** Every table in `source`, in document order, with its line span. */
+export function extractMarkdownTables(source) {
+    const tokens = markdown.parse(normalizeMarkdownTables(source), {});
+    const tables = [];
+    for (let index = 0; index < tokens.length; index++) {
+        const found = parseOne(tokens, index);
+        if (!found)
+            continue;
+        tables.push(found.table);
+        index = found.next;
+    }
+    return tables;
+}
+/**
+ * Display width in monospace cells, by the East Asian Width convention.
+ *
+ * Padding by code-point count misaligns a Chinese table so badly that the
+ * result reads worse than the raw pipes it replaced, so this is a large
+ * improvement — but it is an approximation, not a guarantee. Verified against
+ * Discord's rendering: its code-block CJK fallback font is *not* exactly twice
+ * the Latin advance, so a column mixing `USB-C Hub` with `無線藍牙耳機` still
+ * ends up a little ragged. No amount of space padding fixes that, because the
+ * ratio is not an integer; the only exact answers are giving up columns for
+ * CJK tables entirely, and that trade was considered and declined — close
+ * alignment reads better than no table.
+ */
+// Fixed ranges preserve our width approximation (not all Unicode emoji are wide).
+// Hangul, CJK/Yi, compatibility/full-width forms, emoji, and wide dingbats.
+const WIDE_CHARACTER = /[\u1100-\u115f\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6\u{1f300}-\u{1faff}\u2705\u270a-\u270b\u2728\u274c\u274e\u2753-\u2755\u2757\u2795-\u2797\u27b0\u27bf]/u;
+export function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += WIDE_CHARACTER.test(char) ? 2 : 1;
+    }
+    return width;
+}
+function pad(text, width) {
+    return text + " ".repeat(Math.max(0, width - displayWidth(text)));
+}
+/**
+ * Render a table as aligned monospace rows, for a platform with no table
+ * support of its own. The caller decides whether to fence it.
+ */
+export function renderMonospaceTable(table) {
+    const columns = table.headers.length;
+    const rows = table.rows.map((row) => 
+    // Ragged rows are common in generated markdown; pad rather than drop them.
+    Array.from({ length: columns }, (_, index) => row[index] ?? ""));
+    const widths = Array.from({ length: columns }, (_, index) => Math.max(displayWidth(table.headers[index] ?? ""), ...rows.map((row) => displayWidth(row[index] ?? ""))));
+    const line = (cells) => cells
+        .map((cell, index) => pad(cell, widths[index] ?? 0))
+        .join("  ")
+        .trimEnd();
+    return [
+        line(table.headers),
+        widths.map((width) => "─".repeat(width)).join("  "),
+        ...rows.map(line),
+    ].join("\n");
+}
+//# sourceMappingURL=markdown-tables.js.map

package/dist/adapters/markdown-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-tables.js","sourceRoot":"","sources":["../../src/adapters/markdown-tables.ts"],"names":[],"mappings":"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","sourcesContent":["import MarkdownIt from \"markdown-it\";\nimport type Token from \"markdown-it/lib/token.mjs\";\nimport type { MarkdownTable } from \"./types.js\";\n\nexport type { MarkdownTable } from \"./types.js\";\n\n/**\n * Locating GFM tables in a response, as plain data.\n *\n * Every platform needs the same thing from a markdown table and renders it\n * differently: Slack has a native table block, Discord has no table support at\n * all and needs monospace alignment. Only the *finding* is common, so that is\n * what lives here — callers keep their own rendering, and neither has to carry\n * a second markdown parser to get at the cells.\n *\n * Prose is deliberately not re-serialized from tokens anywhere: callers slice\n * it verbatim from the source using the line span reported here, so the\n * platform's own renderer stays responsible for everything that is not a table.\n */\n\nconst markdown = new MarkdownIt({ html: false });\n\n/**\n * Models sometimes draw the separator row in ASCII-art style (`+---+---+`),\n * which GFM does not recognise. Rewriting those pluses is enough to make the\n * table parse; every other line is left exactly as written.\n */\nexport function normalizeMarkdownTables(source: string): string {\n  return source\n    .split(\"\\n\")\n    .map((line) => {\n      const trimmed = line.trim();\n      if (!trimmed.startsWith(\"|\") || !trimmed.endsWith(\"|\")) return line;\n      if (!/^[|+\\-:\\s]+$/.test(trimmed) || !trimmed.includes(\"+\")) return line;\n      return line.replaceAll(\"+\", \"|\");\n    })\n    .join(\"\\n\");\n}\n\nexport function inlinePlainText(tokens: Token[] | null | undefined): string {\n  if (!tokens) return \"\";\n  let text = \"\";\n  for (const token of tokens) {\n    if (token.type === \"text\" || token.type === \"code_inline\") text += token.content;\n    else if (token.type === \"softbreak\" || token.type === \"hardbreak\") text += \"\\n\";\n    else if (token.children) text += inlinePlainText(token.children);\n  }\n  return text;\n}\n\nfunction parseOne(tokens: Token[], index: number): { table: MarkdownTable; next: number } | null {\n  const open = tokens[index];\n  if (open?.type !== \"table_open\" || !open.map) return null;\n\n  const headers: string[] = [];\n  const rows: string[][] = [];\n  let currentRow: string[] | null = null;\n  let inHead = false;\n  let i = index + 1;\n\n  for (; i < tokens.length; i++) {\n    const token = tokens[i];\n    if (token === undefined || token.type === \"table_close\") break;\n    switch (token.type) {\n      case \"thead_open\":\n        inHead = true;\n        break;\n      case \"thead_close\":\n        inHead = false;\n        break;\n      case \"tr_open\":\n        currentRow = [];\n        break;\n      case \"tr_close\":\n        if (!currentRow) break;\n        if (inHead) headers.push(...currentRow);\n        else rows.push(currentRow);\n        currentRow = null;\n        break;\n      case \"inline\":\n        currentRow?.push(inlinePlainText(token.children) || token.content);\n        break;\n    }\n  }\n\n  // A header with no body is not a table anyone wants rendered as one.\n  if (!headers.length || !rows.length) return null;\n\n  return {\n    table: { headers, rows, startLine: open.map[0], endLine: tokens[i]?.map?.[1] ?? open.map[1] },\n    next: i,\n  };\n}\n\n/** Every table in `source`, in document order, with its line span. */\nexport function extractMarkdownTables(source: string): MarkdownTable[] {\n  const tokens = markdown.parse(normalizeMarkdownTables(source), {});\n  const tables: MarkdownTable[] = [];\n  for (let index = 0; index < tokens.length; index++) {\n    const found = parseOne(tokens, index);\n    if (!found) continue;\n    tables.push(found.table);\n    index = found.next;\n  }\n  return tables;\n}\n\n/**\n * Display width in monospace cells, by the East Asian Width convention.\n *\n * Padding by code-point count misaligns a Chinese table so badly that the\n * result reads worse than the raw pipes it replaced, so this is a large\n * improvement — but it is an approximation, not a guarantee. Verified against\n * Discord's rendering: its code-block CJK fallback font is *not* exactly twice\n * the Latin advance, so a column mixing `USB-C Hub` with `無線藍牙耳機` still\n * ends up a little ragged. No amount of space padding fixes that, because the\n * ratio is not an integer; the only exact answers are giving up columns for\n * CJK tables entirely, and that trade was considered and declined — close\n * alignment reads better than no table.\n */\n// Fixed ranges preserve our width approximation (not all Unicode emoji are wide).\n// Hangul, CJK/Yi, compatibility/full-width forms, emoji, and wide dingbats.\nconst WIDE_CHARACTER =\n  /[\\u1100-\\u115f\\u2e80-\\ua4cf\\uac00-\\ud7a3\\uf900-\\ufaff\\ufe30-\\ufe6f\\uff00-\\uff60\\uffe0-\\uffe6\\u{1f300}-\\u{1faff}\\u2705\\u270a-\\u270b\\u2728\\u274c\\u274e\\u2753-\\u2755\\u2757\\u2795-\\u2797\\u27b0\\u27bf]/u;\n\nexport function displayWidth(text: string): number {\n  let width = 0;\n  for (const char of text) {\n    width += WIDE_CHARACTER.test(char) ? 2 : 1;\n  }\n  return width;\n}\n\nfunction pad(text: string, width: number): string {\n  return text + \" \".repeat(Math.max(0, width - displayWidth(text)));\n}\n\n/**\n * Render a table as aligned monospace rows, for a platform with no table\n * support of its own. The caller decides whether to fence it.\n */\nexport function renderMonospaceTable(table: MarkdownTable): string {\n  const columns = table.headers.length;\n  const rows = table.rows.map((row) =>\n    // Ragged rows are common in generated markdown; pad rather than drop them.\n    Array.from({ length: columns }, (_, index) => row[index] ?? \"\"),\n  );\n  const widths = Array.from({ length: columns }, (_, index) =>\n    Math.max(\n      displayWidth(table.headers[index] ?? \"\"),\n      ...rows.map((row) => displayWidth(row[index] ?? \"\")),\n    ),\n  );\n  const line = (cells: string[]): string =>\n    cells\n      .map((cell, index) => pad(cell, widths[index] ?? 0))\n      .join(\"  \")\n      .trimEnd();\n  return [\n    line(table.headers),\n    widths.map((width) => \"─\".repeat(width)).join(\"  \"),\n    ...rows.map(line),\n  ].join(\"\\n\");\n}\n"]}

package/dist/{platform-messages.d.ts → adapters/messages.d.ts}

@@ -1,12 +1,13 @@
-import type { MessagingBot, MessagingInfo } from "./adapter.js";
+import type { MessagingBot, MessagingInfo } from "./index.js";
 export declare const PRODUCT_NAME = "mikan";
 type PlatformSource = MessagingBot | MessagingInfo | string;
 export declare function formatNothingRunning(source: PlatformSource): string;
 export declare function formatStopping(source: PlatformSource): string;
 export declare function formatStopped(source: PlatformSource): string;
+export declare function formatRestarting(source: PlatformSource): string;
 export declare function formatAlreadyWorking(source: PlatformSource, stopCommand: string, options?: {
     scope?: "thread";
 }): string;
 export declare function formatForceStopped(source: PlatformSource, actorLabel: string): string;
 export {};
-//# sourceMappingURL=platform-messages.d.ts.map
+//# sourceMappingURL=messages.d.ts.map

package/dist/adapters/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/adapters/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,KAAK,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AAoB5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEnE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE7D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAK/D;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GAC7B,MAAM,CAMR;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF"}

package/dist/{platform-messages.js → adapters/messages.js}

@@ -24,6 +24,9 @@ export function formatStopping(source) {
 export function formatStopped(source) {
     return formatItalic(resolvePlatformName(source), "Stopped.");
 }
+export function formatRestarting(source) {
+    return formatItalic(resolvePlatformName(source), "Restarting for an update; this reply was interrupted. Please send your message again.");
+}
 export function formatAlreadyWorking(source, stopCommand, options) {
     const platformName = resolvePlatformName(source);
     const command = formatCode(platformName, stopCommand);
@@ -33,4 +36,4 @@ export function formatAlreadyWorking(source, stopCommand, options) {
 export function formatForceStopped(source, actorLabel) {
     return formatItalic(resolvePlatformName(source), `Force stopped by ${actorLabel}.`);
 }
-//# sourceMappingURL=platform-messages.js.map
+//# sourceMappingURL=messages.js.map

package/dist/adapters/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/adapters/messages.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAIpC,SAAS,mBAAmB,CAAC,MAAsB;IACjD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,kBAAkB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC;IACxE,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAoB;IAClD,OAAO,YAAY,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,SAAS,YAAY,CAAC,YAAoB,EAAE,IAAY;IACtD,OAAO,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;AACnE,CAAC;AAED,SAAS,UAAU,CAAC,YAAoB,EAAE,IAAY;IACpD,OAAO,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACzD,OAAO,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,OAAO,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,OAAO,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,OAAO,YAAY,CACjB,mBAAmB,CAAC,MAAM,CAAC,EAC3B,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,WAAmB,EACnB,OAA8B;IAE9B,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,OAAO,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACvF,OAAO,YAAY,CAAC,YAAY,EAAE,GAAG,MAAM,SAAS,OAAO,aAAa,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsB,EAAE,UAAkB;IAC3E,OAAO,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,oBAAoB,UAAU,GAAG,CAAC,CAAC;AACtF,CAAC","sourcesContent":["import type { MessagingBot, MessagingInfo } from \"./index.js\";\n\nexport const PRODUCT_NAME = \"mikan\";\n\ntype PlatformSource = MessagingBot | MessagingInfo | string;\n\nfunction resolvePlatformName(source: PlatformSource): string {\n  if (typeof source === \"string\") return source;\n  if (\"getMessagingInfo\" in source) return source.getMessagingInfo().name;\n  return source.name;\n}\n\nfunction supportsHtmlFormatting(platformName: string): boolean {\n  return platformName === \"telegram\";\n}\n\nfunction formatItalic(platformName: string, text: string): string {\n  return supportsHtmlFormatting(platformName) ? text : `_${text}_`;\n}\n\nfunction formatCode(platformName: string, text: string): string {\n  return supportsHtmlFormatting(platformName) ? `<code>${text}</code>` : `\\`${text}\\``;\n}\n\nexport function formatNothingRunning(source: PlatformSource): string {\n  return formatItalic(resolvePlatformName(source), \"Nothing running.\");\n}\n\nexport function formatStopping(source: PlatformSource): string {\n  return formatItalic(resolvePlatformName(source), \"Stopping…\");\n}\n\nexport function formatStopped(source: PlatformSource): string {\n  return formatItalic(resolvePlatformName(source), \"Stopped.\");\n}\n\nexport function formatRestarting(source: PlatformSource): string {\n  return formatItalic(\n    resolvePlatformName(source),\n    \"Restarting for an update; this reply was interrupted. Please send your message again.\",\n  );\n}\n\nexport function formatAlreadyWorking(\n  source: PlatformSource,\n  stopCommand: string,\n  options?: { scope?: \"thread\" },\n): string {\n  const platformName = resolvePlatformName(source);\n  const command = formatCode(platformName, stopCommand);\n  const prefix =\n    options?.scope === \"thread\" ? \"Already working in this thread.\" : \"Already working.\";\n  return formatItalic(platformName, `${prefix} Send ${command} to cancel.`);\n}\n\nexport function formatForceStopped(source: PlatformSource, actorLabel: string): string {\n  return formatItalic(resolvePlatformName(source), `Force stopped by ${actorLabel}.`);\n}\n"]}

package/dist/adapters/progressive-renderer.d.ts

@@ -0,0 +1,7 @@
+import type { ChatToolResult, ConversationResponder } from "./index.js";
+import type { ProgressiveRendererPlatform } from "./types.js";
+export declare function formatMarkdownToolResult(result: ChatToolResult): string;
+export declare function createProgressiveRenderer(platform: ProgressiveRendererPlatform): {
+    responder: ConversationResponder;
+};
+//# sourceMappingURL=progressive-renderer.d.ts.map

package/dist/adapters/progressive-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-renderer.d.ts","sourceRoot":"","sources":["../../src/adapters/progressive-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAA4B,MAAM,YAAY,CAAC;AAQlG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CASvE;AA6hBD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,2BAA2B,GAAG;IAChF,SAAS,EAAE,qBAAqB,CAAC;CAClC,CAEA"}