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

package/dist/adapters/telegram/context.d.ts

@@ -1,8 +1,4 @@
-import type { ConversationMessage, ConversationResponder, MessagingInfo } from "../../adapter.js";
+import type { ConversationContext } from "../index.js";
 import type { TelegramMessagingBot, TelegramEvent } from "./bot.js";
-export declare function createTelegramAdapters(event: TelegramEvent, bot: TelegramMessagingBot): {
-    message: ConversationMessage;
-    responder: ConversationResponder;
-    platform: MessagingInfo;
-};
+export declare function createTelegramAdapters(event: TelegramEvent, bot: TelegramMessagingBot): ConversationContext;
 //# sourceMappingURL=context.d.ts.map

package/dist/adapters/telegram/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EAErB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqCpE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,oBAAoB,GACxB;IACD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,qBAAqB,CAAC;IACjC,QAAQ,EAAE,aAAa,CAAC;CACzB,CAyOA"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAcpE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,oBAAoB,GACxB,mBAAmB,CAiErB"}

package/dist/adapters/telegram/context.js

@@ -1,26 +1,11 @@
-import * as log from "../../log.js";
-import { createChatResponseErrorReporter, formatToolArgs, splitText } from "../shared.js";
-import { BufferedResponseStream } from "../streaming.js";
-import { sanitizeTelegramHtml } from "./html.js";
-const TELEGRAM_FORMATTING_GUIDE = `## Telegram Formatting (HTML mode)
-Bold: <b>text</b>, Italic: <i>text</i>, Code: <code>code</code>, Pre: <pre>code</pre>
-Links: <a href="url">text</a>
-Do NOT use Markdown asterisks or backtick syntax.
-Do NOT use <table> tags — they are unsupported. Use <pre> with ASCII art for tables instead.`;
-// Telegram message length limit is 4096 chars; 3800 leaves headroom for HTML escapes.
-const MAX_LENGTH = 3800;
-const formatTelegramContinuation = (partNum) => `(continued ${partNum})`;
-async function notifyError(bot, chatId, label, err, report) {
-    const errMsg = err instanceof Error ? err.message : String(err);
-    log.logWarning(`Telegram ${label} error`, errMsg);
-    report?.();
-    try {
-        await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errMsg}`);
-    }
-    catch {
-        // ignore secondary failure
-    }
-}
+import { createConversationMessage } from "../index.js";
+import { deriveSessionKey } from "../../sessions/session-key.js";
+import { createProgressiveRenderer } from "../progressive-renderer.js";
+import { formatToolArgs } from "../shared.js";
+// A rich message allows far more than the 4096 a plain message did; this stays
+// well inside it, and the headroom is now for the continuation marker alone
+// rather than for HTML escapes that no longer happen.
+const MAX_LENGTH = 30000;
 function formatToolResult(result) {
     const argsFormatted = formatToolArgs(result.args);
     const duration = (result.durationMs / 1000).toFixed(1);
@@ -28,186 +13,64 @@ function formatToolResult(result) {
     return [title, argsFormatted, result.result].filter(Boolean).join("\n\n");
 }
 export function createTelegramAdapters(event, bot) {
-    let messageId = null;
-    let accumulatedText = "";
-    let updatePromise = Promise.resolve();
-    let typingInterval = null;
-    let typingFailureWarned = false;
-    function stopTyping() {
-        if (typingInterval !== null) {
-            clearInterval(typingInterval);
-            typingInterval = null;
-        }
-    }
     const conversationId = event.conversationId;
     const chatId = parseInt(conversationId);
     const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;
-    const message = {
+    const message = createConversationMessage({
+        platform: "telegram",
+        conversationId,
+        address: event.address,
         id: event.ts,
-        sessionKey: event.sessionKey ?? `${conversationId}:${event.thread_ts ?? event.ts}`,
+        sessionKey: deriveSessionKey(event),
         conversationKind: event.conversationKind,
         userId: event.user,
         userName: event.userName,
         text: event.text,
         attachments: event.attachments,
         threadTs: event.thread_ts,
-    };
-    const platform = {
-        name: "telegram",
-        formattingGuide: TELEGRAM_FORMATTING_GUIDE,
-        channels: [],
-        users: [],
-    };
-    async function sendContinuation(text) {
-        await bot.postMessageRaw(chatId, text);
-    }
-    async function sendOrUpdate(displayText) {
-        if (messageId !== null) {
-            await bot.updateMessage(conversationId, String(messageId), displayText);
-        }
-        else if (replyToId !== null) {
-            messageId = await bot.postReply(chatId, replyToId, displayText);
-        }
-        else {
-            messageId = await bot.postMessageRaw(chatId, displayText);
-        }
-    }
-    const reportResponseError = createChatResponseErrorReporter(() => ({
-        platform: "telegram",
-        conversationId,
-        chatId,
-        messageId: message.id,
-        sessionKey: message.sessionKey,
-        responseMessageId: messageId,
-        replyToId,
-        conversationKind: message.conversationKind,
-    }));
-    const sendSplitText = async (text, firstPart) => {
-        const [head, ...tail] = splitText(text, MAX_LENGTH, formatTelegramContinuation);
-        await firstPart(head);
-        for (const part of tail) {
-            await sendContinuation(part);
-        }
-    };
-    const stream = new BufferedResponseStream({
-        flush: async (text) => {
-            await sendSplitText(text, sendOrUpdate);
-        },
-        finish: async (text) => {
-            stopTyping();
-            await sendSplitText(text, sendOrUpdate);
-        },
     });
-    const queueTelegramSend = async (label, work, report) => {
-        updatePromise = updatePromise.then(async () => {
-            try {
-                await work();
-            }
-            catch (err) {
-                await notifyError(bot, chatId, label, err, () => report(err));
-            }
-        });
-        await updatePromise;
-    };
-    const responder = {
-        respond: async (text) => {
-            await queueTelegramSend("respond", async () => {
-                const sanitized = sanitizeTelegramHtml(text);
-                accumulatedText = accumulatedText ? `${accumulatedText}\n${sanitized}` : sanitized;
-                stream.setText(accumulatedText);
-                await sendSplitText(accumulatedText, sendOrUpdate);
-                if (messageId !== null) {
-                    bot.logBotResponse(conversationId, text, String(messageId));
-                }
-            }, (err) => reportResponseError(err, "respond", {
-                phase: messageId ? "update" : "initial_post",
-                textLength: text.length,
-                accumulatedLength: accumulatedText.length,
-            }));
-        },
-        appendResponseDelta: async (delta) => {
-            await queueTelegramSend("appendResponseDelta", async () => {
-                const sanitized = sanitizeTelegramHtml(delta);
-                await stream.append(sanitized);
-                accumulatedText = stream.getText();
-                if (messageId !== null) {
-                    bot.logBotResponse(conversationId, delta, String(messageId));
-                }
-            }, (err) => reportResponseError(err, "respond", {
-                textLength: delta.length,
-                accumulatedLength: stream.getText().length,
-            }));
+    // The bot's getMessagingInfo() is the single authority for platform info.
+    const platform = bot.getMessagingInfo();
+    const { responder } = createProgressiveRenderer({
+        label: "Telegram",
+        maxLength: MAX_LENGTH,
+        formatContinuation: (partNum) => `(continued ${partNum})`,
+        errorPrefix: "Error: ",
+        supportsDeltas: true,
+        typing: {
+            // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)
+            send: () => bot.sendTyping(chatId),
+            intervalMs: 4000,
         },
-        finishResponse: async (finalText) => {
-            await queueTelegramSend("finishResponse", async () => {
-                await stream.finish(finalText === undefined ? undefined : sanitizeTelegramHtml(finalText));
-                accumulatedText = stream.getText();
-            }, (err) => reportResponseError(err, "set_working", {
-                finalTextLength: finalText?.length,
-            }));
+        formatToolResult,
+        responseErrorContext: (responseId) => ({
+            platform: "telegram",
+            conversationId,
+            chatId,
+            messageId: message.id,
+            sessionKey: message.sessionKey,
+            responseMessageId: responseId,
+            replyToId,
+            conversationKind: message.conversationKind,
+        }),
+        notifySendFailure: async (errorMessage) => {
+            await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errorMessage}`);
         },
-        replaceResponse: async (text) => {
-            await queueTelegramSend("replaceResponse", async () => {
-                accumulatedText = sanitizeTelegramHtml(text);
-                stream.setText(accumulatedText);
-                await sendSplitText(accumulatedText, sendOrUpdate);
-            }, (err) => reportResponseError(err, "replace_response", {
-                textLength: text.length,
-                hadExistingResponse: Boolean(messageId),
-            }));
+        post: async (text) => {
+            const id = replyToId !== null
+                ? await bot.postReply(chatId, replyToId, text)
+                : await bot.postMessageRaw(chatId, text);
+            return String(id);
         },
-        respondDiagnostic: async (text, options) => {
-            await queueTelegramSend("respondDiagnostic", async () => {
-                const prefix = options?.style === "error" ? "Error: " : "";
-                await sendSplitText(sanitizeTelegramHtml(`${prefix}${text}`), sendContinuation);
-            }, (err) => reportResponseError(err, "respond_diagnostic", {
-                textLength: text.length,
-                style: options?.style,
-            }));
-        },
-        respondToolResult: async (result) => {
-            await responder.respondDiagnostic(formatToolResult(result));
-        },
-        setTyping: async (isTyping) => {
-            const onTypingError = (err) => {
-                if (typingFailureWarned)
-                    return;
-                typingFailureWarned = true;
-                log.logWarning("Telegram sendTyping failed (further occurrences suppressed for this session)", err instanceof Error ? err.message : String(err));
-            };
-            if (isTyping && typingInterval === null) {
-                // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)
-                bot.sendTyping(chatId).catch(onTypingError);
-                typingInterval = setInterval(() => {
-                    bot.sendTyping(chatId).catch(onTypingError);
-                }, 4000);
-            }
-            else if (!isTyping) {
-                stopTyping();
-            }
-        },
-        setWorking: async (working) => {
-            if (!working)
-                stopTyping();
-        },
-        uploadFile: async (filePath, title) => {
-            await bot.uploadFile(conversationId, filePath, title);
-        },
-        deleteResponse: async () => {
-            updatePromise = updatePromise.then(async () => {
-                if (messageId !== null) {
-                    try {
-                        await bot.deleteMessageRaw(chatId, messageId);
-                    }
-                    catch {
-                        // Ignore errors
-                    }
-                    messageId = null;
-                }
-            });
-            await updatePromise;
-        },
-    };
-    return { message, responder, platform };
+        update: (id, text) => bot.updateMessage(conversationId, id, text),
+        // Returns the id so the renderer can edit this overflow message on the
+        // next redraw instead of posting another copy of the tail.
+        postExtra: (text) => bot.postMessageRaw(chatId, text),
+        delete: (id) => bot.deleteMessageRaw(chatId, Number(id)),
+        logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),
+        uploadFile: (filePath, title) => bot.uploadFile(conversationId, filePath, title),
+        react: (emoji) => bot.addReaction(conversationId, event.ts, emoji),
+    });
+    return { address: message.address, message, responder, platform };
 }
 //# sourceMappingURL=context.js.map

package/dist/adapters/telegram/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ConversationMessage,\n  ConversationResponder,\n  ChatToolResult,\n  MessagingInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { createChatResponseErrorReporter, formatToolArgs, splitText } from \"../shared.js\";\nimport { BufferedResponseStream } from \"../streaming.js\";\nimport { sanitizeTelegramHtml } from \"./html.js\";\nimport type { TelegramMessagingBot, TelegramEvent } from \"./bot.js\";\n\nconst TELEGRAM_FORMATTING_GUIDE = `## Telegram Formatting (HTML mode)\nBold: <b>text</b>, Italic: <i>text</i>, Code: <code>code</code>, Pre: <pre>code</pre>\nLinks: <a href=\"url\">text</a>\nDo NOT use Markdown asterisks or backtick syntax.\nDo NOT use <table> tags — they are unsupported. Use <pre> with ASCII art for tables instead.`;\n\n// Telegram message length limit is 4096 chars; 3800 leaves headroom for HTML escapes.\nconst MAX_LENGTH = 3800;\n\nconst formatTelegramContinuation = (partNum: number): string => `(continued ${partNum})`;\n\nasync function notifyError(\n  bot: TelegramMessagingBot,\n  chatId: number,\n  label: string,\n  err: unknown,\n  report?: () => void,\n): Promise<void> {\n  const errMsg = err instanceof Error ? err.message : String(err);\n  log.logWarning(`Telegram ${label} error`, errMsg);\n  report?.();\n  try {\n    await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errMsg}`);\n  } catch {\n    // ignore secondary failure\n  }\n}\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  const title = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName}${result.label ? `: ${result.label}` : \"\"} (${duration}s)`;\n  return [title, argsFormatted, result.result].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function createTelegramAdapters(\n  event: TelegramEvent,\n  bot: TelegramMessagingBot,\n): {\n  message: ConversationMessage;\n  responder: ConversationResponder;\n  platform: MessagingInfo;\n} {\n  let messageId: number | null = null;\n  let accumulatedText = \"\";\n  let updatePromise = Promise.resolve();\n  let typingInterval: ReturnType<typeof setInterval> | null = null;\n  let typingFailureWarned = false;\n\n  function stopTyping() {\n    if (typingInterval !== null) {\n      clearInterval(typingInterval);\n      typingInterval = null;\n    }\n  }\n\n  const conversationId = event.conversationId;\n  const chatId = parseInt(conversationId);\n  const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;\n\n  const message: ConversationMessage = {\n    id: event.ts,\n    sessionKey: event.sessionKey ?? `${conversationId}:${event.thread_ts ?? event.ts}`,\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  };\n\n  const platform: MessagingInfo = {\n    name: \"telegram\",\n    formattingGuide: TELEGRAM_FORMATTING_GUIDE,\n    channels: [],\n    users: [],\n  };\n\n  async function sendContinuation(text: string): Promise<void> {\n    await bot.postMessageRaw(chatId, text);\n  }\n\n  async function sendOrUpdate(displayText: string): Promise<void> {\n    if (messageId !== null) {\n      await bot.updateMessage(conversationId, String(messageId), displayText);\n    } else if (replyToId !== null) {\n      messageId = await bot.postReply(chatId, replyToId, displayText);\n    } else {\n      messageId = await bot.postMessageRaw(chatId, displayText);\n    }\n  }\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"telegram\",\n    conversationId,\n    chatId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: messageId,\n    replyToId,\n    conversationKind: message.conversationKind,\n  }));\n\n  const sendSplitText = async (\n    text: string,\n    firstPart: (part: string) => Promise<void>,\n  ): Promise<void> => {\n    const [head, ...tail] = splitText(text, MAX_LENGTH, formatTelegramContinuation);\n    await firstPart(head);\n    for (const part of tail) {\n      await sendContinuation(part);\n    }\n  };\n\n  const stream = new BufferedResponseStream({\n    flush: async (text) => {\n      await sendSplitText(text, sendOrUpdate);\n    },\n    finish: async (text) => {\n      stopTyping();\n      await sendSplitText(text, sendOrUpdate);\n    },\n  });\n\n  const queueTelegramSend = async (\n    label: string,\n    work: () => Promise<void>,\n    report: (err: unknown) => void,\n  ): Promise<void> => {\n    updatePromise = updatePromise.then(async () => {\n      try {\n        await work();\n      } catch (err) {\n        await notifyError(bot, chatId, label, err, () => report(err));\n      }\n    });\n    await updatePromise;\n  };\n\n  const responder: ConversationResponder = {\n    respond: async (text: string) => {\n      await queueTelegramSend(\n        \"respond\",\n        async () => {\n          const sanitized = sanitizeTelegramHtml(text);\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${sanitized}` : sanitized;\n          stream.setText(accumulatedText);\n          await sendSplitText(accumulatedText, sendOrUpdate);\n          if (messageId !== null) {\n            bot.logBotResponse(conversationId, text, String(messageId));\n          }\n        },\n        (err) =>\n          reportResponseError(err, \"respond\", {\n            phase: messageId ? \"update\" : \"initial_post\",\n            textLength: text.length,\n            accumulatedLength: accumulatedText.length,\n          }),\n      );\n    },\n\n    appendResponseDelta: async (delta: string) => {\n      await queueTelegramSend(\n        \"appendResponseDelta\",\n        async () => {\n          const sanitized = sanitizeTelegramHtml(delta);\n          await stream.append(sanitized);\n          accumulatedText = stream.getText();\n          if (messageId !== null) {\n            bot.logBotResponse(conversationId, delta, String(messageId));\n          }\n        },\n        (err) =>\n          reportResponseError(err, \"respond\", {\n            textLength: delta.length,\n            accumulatedLength: stream.getText().length,\n          }),\n      );\n    },\n\n    finishResponse: async (finalText?: string) => {\n      await queueTelegramSend(\n        \"finishResponse\",\n        async () => {\n          await stream.finish(\n            finalText === undefined ? undefined : sanitizeTelegramHtml(finalText),\n          );\n          accumulatedText = stream.getText();\n        },\n        (err) =>\n          reportResponseError(err, \"set_working\", {\n            finalTextLength: finalText?.length,\n          }),\n      );\n    },\n\n    replaceResponse: async (text: string) => {\n      await queueTelegramSend(\n        \"replaceResponse\",\n        async () => {\n          accumulatedText = sanitizeTelegramHtml(text);\n          stream.setText(accumulatedText);\n          await sendSplitText(accumulatedText, sendOrUpdate);\n        },\n        (err) =>\n          reportResponseError(err, \"replace_response\", {\n            textLength: text.length,\n            hadExistingResponse: Boolean(messageId),\n          }),\n      );\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      await queueTelegramSend(\n        \"respondDiagnostic\",\n        async () => {\n          const prefix = options?.style === \"error\" ? \"Error: \" : \"\";\n          await sendSplitText(sanitizeTelegramHtml(`${prefix}${text}`), sendContinuation);\n        },\n        (err) =>\n          reportResponseError(err, \"respond_diagnostic\", {\n            textLength: text.length,\n            style: options?.style,\n          }),\n      );\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responder.respondDiagnostic(formatToolResult(result));\n    },\n\n    setTyping: async (isTyping: boolean) => {\n      const onTypingError = (err: unknown): void => {\n        if (typingFailureWarned) return;\n        typingFailureWarned = true;\n        log.logWarning(\n          \"Telegram sendTyping failed (further occurrences suppressed for this session)\",\n          err instanceof Error ? err.message : String(err),\n        );\n      };\n      if (isTyping && typingInterval === null) {\n        // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)\n        bot.sendTyping(chatId).catch(onTypingError);\n        typingInterval = setInterval(() => {\n          bot.sendTyping(chatId).catch(onTypingError);\n        }, 4000);\n      } else if (!isTyping) {\n        stopTyping();\n      }\n    },\n\n    setWorking: async (working: boolean) => {\n      if (!working) stopTyping();\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      await bot.uploadFile(conversationId, filePath, title);\n    },\n\n    deleteResponse: async () => {\n      updatePromise = updatePromise.then(async () => {\n        if (messageId !== null) {\n          try {\n            await bot.deleteMessageRaw(chatId, messageId);\n          } catch {\n            // Ignore errors\n          }\n          messageId = null;\n        }\n      });\n      await updatePromise;\n    },\n  };\n\n  return { message, responder, platform };\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"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","sourcesContent":["import { createConversationMessage } from \"../index.js\";\nimport type { ChatToolResult, ConversationContext } from \"../index.js\";\nimport { deriveSessionKey } from \"../../sessions/session-key.js\";\nimport { createProgressiveRenderer } from \"../progressive-renderer.js\";\nimport { formatToolArgs } from \"../shared.js\";\nimport type { TelegramMessagingBot, TelegramEvent } from \"./bot.js\";\n\n// A rich message allows far more than the 4096 a plain message did; this stays\n// well inside it, and the headroom is now for the continuation marker alone\n// rather than for HTML escapes that no longer happen.\nconst MAX_LENGTH = 30000;\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  const title = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName}${result.label ? `: ${result.label}` : \"\"} (${duration}s)`;\n  return [title, argsFormatted, result.result].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function createTelegramAdapters(\n  event: TelegramEvent,\n  bot: TelegramMessagingBot,\n): ConversationContext {\n  const conversationId = event.conversationId;\n  const chatId = parseInt(conversationId);\n  const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;\n\n  const message = createConversationMessage({\n    platform: \"telegram\",\n    conversationId,\n    address: event.address,\n    id: event.ts,\n    sessionKey: deriveSessionKey(event),\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  });\n\n  // The bot's getMessagingInfo() is the single authority for platform info.\n  const platform = bot.getMessagingInfo();\n\n  const { responder } = createProgressiveRenderer({\n    label: \"Telegram\",\n    maxLength: MAX_LENGTH,\n    formatContinuation: (partNum: number): string => `(continued ${partNum})`,\n    errorPrefix: \"Error: \",\n    supportsDeltas: true,\n    typing: {\n      // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)\n      send: () => bot.sendTyping(chatId),\n      intervalMs: 4000,\n    },\n    formatToolResult,\n    responseErrorContext: (responseId) => ({\n      platform: \"telegram\",\n      conversationId,\n      chatId,\n      messageId: message.id,\n      sessionKey: message.sessionKey,\n      responseMessageId: responseId,\n      replyToId,\n      conversationKind: message.conversationKind,\n    }),\n    notifySendFailure: async (errorMessage) => {\n      await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errorMessage}`);\n    },\n    post: async (text) => {\n      const id =\n        replyToId !== null\n          ? await bot.postReply(chatId, replyToId, text)\n          : await bot.postMessageRaw(chatId, text);\n      return String(id);\n    },\n    update: (id, text) => bot.updateMessage(conversationId, id, text),\n    // Returns the id so the renderer can edit this overflow message on the\n    // next redraw instead of posting another copy of the tail.\n    postExtra: (text) => bot.postMessageRaw(chatId, text),\n    delete: (id) => bot.deleteMessageRaw(chatId, Number(id)),\n    logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),\n    uploadFile: (filePath, title) => bot.uploadFile(conversationId, filePath, title),\n    react: (emoji) => bot.addReaction(conversationId, event.ts, emoji),\n  });\n\n  return { address: message.address, message, responder, platform };\n}\n"]}

package/dist/adapters/telegram/types.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationEvent } from "../../adapter.js";
+import type { ConversationEvent } from "../index.js";
 export interface TelegramEvent extends ConversationEvent {
     type: "message" | "command";
     userName?: string;

package/dist/adapters/telegram/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/adapters/telegram/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/telegram/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationEvent } from \"../../adapter.js\";\n\nexport interface TelegramEvent extends ConversationEvent {\n  type: \"message\" | \"command\";\n  userName?: string;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/telegram/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationEvent } from \"../index.js\";\n\nexport interface TelegramEvent extends ConversationEvent {\n  type: \"message\" | \"command\";\n  userName?: string;\n}\n"]}

package/dist/adapters/types.d.ts

@@ -1,4 +1,5 @@
-import type { MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler } from "../adapter.js";
+import type { ChatToolResult, MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler, OfficeAddress, SubagentProgressSnapshot } from "./index.js";
+import type { Attachment } from "../types.js";
 export type ChatResponseErrorOperation = "respond" | "replace_response" | "respond_diagnostic" | "set_working";
 export interface ChatResponseErrorContext {
     platform: string;
@@ -26,23 +27,147 @@ export interface RetryOptions {
 }
 export interface ResolveStopTargetInput {
     handler: MessagingEventHandler;
-    conversationId: string;
+    /** The office whose runtime state may be stopped. */
+    address: OfficeAddress;
     /** Session key derived from the current message; checked first when present. */
     sessionKey?: string;
 }
-export interface BufferedResponseStreamOptions {
-    minFlushIntervalMs?: number;
-    minFlushChars?: number;
-    now?: () => number;
+export interface HandleTooLongInput {
+    text: string;
+    operation: "render" | "replace";
+    options: {
+        createOverflowLink?: () => string;
+    } | undefined;
+    responseId: string | null;
+    write: (text: string) => Promise<void>;
+    getResponseId: () => string | null;
+}
+interface ProgressiveStreamTransport {
+    start(text: string): Promise<string>;
+    append(messageId: string, delta: string): Promise<void>;
+    stop(messageId: string): Promise<void>;
+    /**
+     * Withhold an append until this many characters have accumulated. A
+     * streaming transport is usually rate-limited per call rather than per byte,
+     * so forwarding every token spends the budget on latency nobody perceives.
+     * The final render flushes whatever is left before stopping, so buffering
+     * can never drop text. Omit for no buffering.
+     */
+    minDeltaChars?: number;
+}
+export interface ProgressiveRendererPlatform {
+    label: string;
+    maxLength: number;
+    /**
+     * Shortest gap between redraws of a streaming response, measured from the
+     * end of the previous one. Platforms meter edits per channel at different
+     * rates; the default suits the tightest of them. Zero redraws on every
+     * delta, which only a platform with no such limit can afford.
+     */
+    flushIntervalMs?: number;
+    initialResponseId?: string | null;
+    formatContinuation: (partNum: number) => string;
+    errorPrefix: string;
+    sanitize?: (text: string) => string;
+    workingIndicator?: string;
+    formatProvisional?: (text: string, working: boolean) => string;
+    prepareSource?: (text: string, working: boolean) => string;
+    onWorkingChanged?: (working: boolean, responseId: string | null) => Promise<void>;
+    setTyping?: (isTyping: boolean, responseId: string | null) => Promise<void>;
+    /** Terminal hook. Awaited, so it may finish sending before the run ends. */
+    onFinish?: (text: string, responseId: string | null) => void | Promise<void>;
+    /** Whether `respond` calls are complete messages that should be logged immediately. */
+    logIntermediateResponses?: boolean;
+    /** Whether the platform accepts incremental response deltas. */
+    supportsDeltas?: boolean;
+    /** Native stream operations, when this reply target supports them. */
+    stream?: ProgressiveStreamTransport;
+    /** Re-render a finished response when the provisional stream lacked structure. */
+    needsCanonicalRender?: (text: string) => boolean;
+    formatSubagentProgress?: (progress: SubagentProgressSnapshot) => string;
+    typing?: {
+        send: () => Promise<unknown>;
+        intervalMs: number;
+        stopOnSend?: boolean;
+    };
+    formatToolResult: (result: ChatToolResult) => string;
+    /** Stable platform context plus the current response identity for error reporting. */
+    responseErrorContext?: (responseId: string | null) => Omit<ChatResponseErrorContext, "operation" | "extra">;
+    notifySendFailure?: (errorMessage: string) => Promise<void>;
+    post: (text: string) => Promise<string>;
+    update: (id: string, text: string) => Promise<void>;
+    postExtra: (text: string, responseId: string | null) => Promise<string | number | void>;
+    postDiagnostic?: (text: string, options: {
+        style?: "muted" | "error";
+    }, responseId: string | null) => Promise<Array<string | number>>;
+    delete?: (id: string) => Promise<void>;
+    deleteExtra?: (id: string | number) => Promise<void>;
+    logBotResponse?: (text: string, id: string) => void;
+    uploadFile?: (filePath: string, title?: string) => Promise<void>;
+    uploadFallbackNote?: (name: string) => string;
+    react?: (emoji: string) => Promise<void>;
+    /**
+     * Whether a send failure is a length rejection, as opposed to a rate limit
+     * or an outage. Without this the fallback swallows every error, so a
+     * transient 429 gets reported to the reader as "message too long" and the
+     * response is truncated for no reason.
+     */
+    isTooLongError?: (err: unknown) => boolean;
+    /** Handle a Slack-style length rejection and return the canonical fallback text. */
+    handleTooLong?: (input: HandleTooLongInput) => Promise<{
+        text: string;
+        prefixLength?: number;
+    }>;
 }
-export interface BufferedResponseStreamSink {
-    flush(text: string): Promise<void>;
-    finish(text: string): Promise<void>;
+/** How intake resolved a message. Callers branch on this instead of passing callbacks. */
+export type MessageIntakeOutcome = "magic-word" | "not-triggered" | "rejected-busy" | "enqueued";
+/** Platform policy for the magic-word step, stated as data. */
+export interface MagicWordIntakeOptions {
+    /**
+     * Raw user-typed text to match when `eventBase.text` is decorated for the
+     * agent (e.g. GitHub review-comment framing). Defaults to `eventBase.text`.
+     */
+    text?: string;
+    /**
+     * Whether the message addressed the bot (mention, DM, slash form). The idle
+     * "Nothing running." reply is suppressed for unaddressed messages.
+     */
+    addressed: boolean;
+    /**
+     * How far a stop may widen when the direct session key is not running:
+     * "top-level" widens to the single running scoped session only from the
+     * persistent conversation session, "always" widens unconditionally,
+     * "never" stops only exact matches.
+     */
+    scopeFallback: "top-level" | "always" | "never";
+}
+/** One platform file to save into an office's attachments directory. */
+export interface IncomingAttachment {
+    /** Original file name as the platform reports it. */
+    name: string;
+    /** Epoch ms used in the stored filename; defaults to the time of saving. */
+    timestampMs?: number;
+    /** Fetch the file and write it to destPath (the parent directory exists). */
+    download(destPath: string): Promise<void>;
+}
+/** Outcome of saving incoming attachments; error policy stays with the adapter. */
+export interface SavedAttachments {
+    saved: Attachment[];
+    failed: {
+        name: string;
+        error: unknown;
+    }[];
 }
 export interface MessageIntakeOptions<TEvent extends ConversationEvent> {
     eventBase: TEvent;
-    workingDir: string | undefined;
-    isAutoReplyCandidate: boolean;
+    /** Explicit DM, mention, command or supported thread continuation. */
+    addressed: boolean;
+    magicWord: MagicWordIntakeOptions;
+    /**
+     * "reject" bounces a new message while its session is already running
+     * (with an "Already working" reply); "queue" lines it up behind the run.
+     */
+    busyPolicy: "queue" | "reject";
     logEntryBase: Record<string, unknown>;
     log?: (entry: Record<string, unknown>) => void;
     processAttachments: () => Promise<unknown[]>;
@@ -51,8 +176,14 @@ export interface MessageIntakeOptions<TEvent extends ConversationEvent> {
     handler: MessagingEventHandler;
     bot: MessagingBot;
     createContext: (event: TEvent) => ConversationContext;
-    beforeEnqueue?: (event: TEvent) => Promise<boolean> | boolean;
-    onNotTriggered?: () => void;
     deferAttachmentsUntilRun?: boolean;
 }
+export interface MarkdownTable {
+    headers: string[];
+    rows: string[][];
+    /** Source line span, so a caller can slice the prose around it. */
+    startLine: number;
+    endLine: number;
+}
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,0BAA0B,GAClC,SAAS,GACT,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,CAAC;AAElB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,0BAA0B,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,0BAA0B,EACrC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,IAAI,CAAC;AAEV,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;IACvC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,qDAAqD;IACrD,OAAO,EAAE,aAAa,CAAC;IACvB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC3D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,UAAU,0BAA0B;IAClC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC/D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC3D,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,uFAAuF;IACvF,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,MAAM,CAAC;IACxE,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,gBAAgB,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IACrD,sFAAsF;IACtF,oBAAoB,CAAC,EAAE,CACrB,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC;IAC3D,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;IACxF,cAAc,CAAC,EAAE,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,EACtC,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IAC3C,oFAAoF;IACpF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjG;AAED,0FAA0F;AAC1F,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,GAAG,UAAU,CAAC;AAEjG,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,aAAa,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;CACjD;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,iBAAiB;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,sBAAsB,CAAC;IAClC;;;OAGG;IACH,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/C,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC/D,OAAO,EAAE,qBAAqB,CAAC;IAC/B,GAAG,EAAE,YAAY,CAAC;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,mBAAmB,CAAC;IACtD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/adapters/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n} from \"../adapter.js\";\n\nexport type ChatResponseErrorOperation =\n  | \"respond\"\n  | \"replace_response\"\n  | \"respond_diagnostic\"\n  | \"set_working\";\n\nexport interface ChatResponseErrorContext {\n  platform: string;\n  conversationId: string;\n  messageId: string;\n  sessionKey: string;\n  conversationKind: string;\n  operation: ChatResponseErrorOperation;\n  channelId?: string;\n  chatId?: number;\n  responseMessageId?: string | number | null;\n  threadTs?: string;\n  replyTargetId?: string;\n  replyToId?: number | null;\n  isThreaded?: boolean;\n  extra?: Record<string, unknown>;\n}\n\nexport type ChatResponseErrorReporter = (\n  err: unknown,\n  operation: ChatResponseErrorOperation,\n  extra?: Record<string, unknown>,\n) => void;\n\nexport interface RetryOptions {\n  /** Predicate that returns true when an error is worth retrying (rate limit, transient 5xx, etc.). */\n  isRateLimited: (err: Error) => boolean;\n  /** Total attempts including the first call. */\n  maxAttempts?: number;\n  baseDelayMs?: number;\n}\n\nexport interface ResolveStopTargetInput {\n  handler: MessagingEventHandler;\n  conversationId: string;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\nexport interface BufferedResponseStreamOptions {\n  minFlushIntervalMs?: number;\n  minFlushChars?: number;\n  now?: () => number;\n}\n\nexport interface BufferedResponseStreamSink {\n  flush(text: string): Promise<void>;\n  finish(text: string): Promise<void>;\n}\n\nexport interface MessageIntakeOptions<TEvent extends ConversationEvent> {\n  eventBase: TEvent;\n  workingDir: string | undefined;\n  isAutoReplyCandidate: boolean;\n  logEntryBase: Record<string, unknown>;\n  log?: (entry: Record<string, unknown>) => void;\n  processAttachments: () => Promise<unknown[]>;\n  queueKey: string;\n  enqueue: (queueKey: string, work: () => Promise<void>) => void;\n  handler: MessagingEventHandler;\n  bot: MessagingBot;\n  createContext: (event: TEvent) => ConversationContext;\n  beforeEnqueue?: (event: TEvent) => Promise<boolean> | boolean;\n  onNotTriggered?: () => void;\n  deferAttachmentsUntilRun?: boolean;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ChatToolResult,\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n  OfficeAddress,\n  SubagentProgressSnapshot,\n} from \"./index.js\";\nimport type { Attachment } from \"../types.js\";\n\nexport type ChatResponseErrorOperation =\n  | \"respond\"\n  | \"replace_response\"\n  | \"respond_diagnostic\"\n  | \"set_working\";\n\nexport interface ChatResponseErrorContext {\n  platform: string;\n  conversationId: string;\n  messageId: string;\n  sessionKey: string;\n  conversationKind: string;\n  operation: ChatResponseErrorOperation;\n  channelId?: string;\n  chatId?: number;\n  responseMessageId?: string | number | null;\n  threadTs?: string;\n  replyTargetId?: string;\n  replyToId?: number | null;\n  isThreaded?: boolean;\n  extra?: Record<string, unknown>;\n}\n\nexport type ChatResponseErrorReporter = (\n  err: unknown,\n  operation: ChatResponseErrorOperation,\n  extra?: Record<string, unknown>,\n) => void;\n\nexport interface RetryOptions {\n  /** Predicate that returns true when an error is worth retrying (rate limit, transient 5xx, etc.). */\n  isRateLimited: (err: Error) => boolean;\n  /** Total attempts including the first call. */\n  maxAttempts?: number;\n  baseDelayMs?: number;\n}\n\nexport interface ResolveStopTargetInput {\n  handler: MessagingEventHandler;\n  /** The office whose runtime state may be stopped. */\n  address: OfficeAddress;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\nexport interface HandleTooLongInput {\n  text: string;\n  operation: \"render\" | \"replace\";\n  options: { createOverflowLink?: () => string } | undefined;\n  responseId: string | null;\n  write: (text: string) => Promise<void>;\n  getResponseId: () => string | null;\n}\n\ninterface ProgressiveStreamTransport {\n  start(text: string): Promise<string>;\n  append(messageId: string, delta: string): Promise<void>;\n  stop(messageId: string): Promise<void>;\n  /**\n   * Withhold an append until this many characters have accumulated. A\n   * streaming transport is usually rate-limited per call rather than per byte,\n   * so forwarding every token spends the budget on latency nobody perceives.\n   * The final render flushes whatever is left before stopping, so buffering\n   * can never drop text. Omit for no buffering.\n   */\n  minDeltaChars?: number;\n}\n\nexport interface ProgressiveRendererPlatform {\n  label: string;\n  maxLength: number;\n  /**\n   * Shortest gap between redraws of a streaming response, measured from the\n   * end of the previous one. Platforms meter edits per channel at different\n   * rates; the default suits the tightest of them. Zero redraws on every\n   * delta, which only a platform with no such limit can afford.\n   */\n  flushIntervalMs?: number;\n  initialResponseId?: string | null;\n  formatContinuation: (partNum: number) => string;\n  errorPrefix: string;\n  sanitize?: (text: string) => string;\n  workingIndicator?: string;\n  formatProvisional?: (text: string, working: boolean) => string;\n  prepareSource?: (text: string, working: boolean) => string;\n  onWorkingChanged?: (working: boolean, responseId: string | null) => Promise<void>;\n  setTyping?: (isTyping: boolean, responseId: string | null) => Promise<void>;\n  /** Terminal hook. Awaited, so it may finish sending before the run ends. */\n  onFinish?: (text: string, responseId: string | null) => void | Promise<void>;\n  /** Whether `respond` calls are complete messages that should be logged immediately. */\n  logIntermediateResponses?: boolean;\n  /** Whether the platform accepts incremental response deltas. */\n  supportsDeltas?: boolean;\n  /** Native stream operations, when this reply target supports them. */\n  stream?: ProgressiveStreamTransport;\n  /** Re-render a finished response when the provisional stream lacked structure. */\n  needsCanonicalRender?: (text: string) => boolean;\n  formatSubagentProgress?: (progress: SubagentProgressSnapshot) => string;\n  typing?: {\n    send: () => Promise<unknown>;\n    intervalMs: number;\n    stopOnSend?: boolean;\n  };\n  formatToolResult: (result: ChatToolResult) => string;\n  /** Stable platform context plus the current response identity for error reporting. */\n  responseErrorContext?: (\n    responseId: string | null,\n  ) => Omit<ChatResponseErrorContext, \"operation\" | \"extra\">;\n  notifySendFailure?: (errorMessage: string) => Promise<void>;\n  post: (text: string) => Promise<string>;\n  update: (id: string, text: string) => Promise<void>;\n  postExtra: (text: string, responseId: string | null) => Promise<string | number | void>;\n  postDiagnostic?: (\n    text: string,\n    options: { style?: \"muted\" | \"error\" },\n    responseId: string | null,\n  ) => Promise<Array<string | number>>;\n  delete?: (id: string) => Promise<void>;\n  deleteExtra?: (id: string | number) => Promise<void>;\n  logBotResponse?: (text: string, id: string) => void;\n  uploadFile?: (filePath: string, title?: string) => Promise<void>;\n  uploadFallbackNote?: (name: string) => string;\n  react?: (emoji: string) => Promise<void>;\n  /**\n   * Whether a send failure is a length rejection, as opposed to a rate limit\n   * or an outage. Without this the fallback swallows every error, so a\n   * transient 429 gets reported to the reader as \"message too long\" and the\n   * response is truncated for no reason.\n   */\n  isTooLongError?: (err: unknown) => boolean;\n  /** Handle a Slack-style length rejection and return the canonical fallback text. */\n  handleTooLong?: (input: HandleTooLongInput) => Promise<{ text: string; prefixLength?: number }>;\n}\n\n/** How intake resolved a message. Callers branch on this instead of passing callbacks. */\nexport type MessageIntakeOutcome = \"magic-word\" | \"not-triggered\" | \"rejected-busy\" | \"enqueued\";\n\n/** Platform policy for the magic-word step, stated as data. */\nexport interface MagicWordIntakeOptions {\n  /**\n   * Raw user-typed text to match when `eventBase.text` is decorated for the\n   * agent (e.g. GitHub review-comment framing). Defaults to `eventBase.text`.\n   */\n  text?: string;\n  /**\n   * Whether the message addressed the bot (mention, DM, slash form). The idle\n   * \"Nothing running.\" reply is suppressed for unaddressed messages.\n   */\n  addressed: boolean;\n  /**\n   * How far a stop may widen when the direct session key is not running:\n   * \"top-level\" widens to the single running scoped session only from the\n   * persistent conversation session, \"always\" widens unconditionally,\n   * \"never\" stops only exact matches.\n   */\n  scopeFallback: \"top-level\" | \"always\" | \"never\";\n}\n\n/** One platform file to save into an office's attachments directory. */\nexport interface IncomingAttachment {\n  /** Original file name as the platform reports it. */\n  name: string;\n  /** Epoch ms used in the stored filename; defaults to the time of saving. */\n  timestampMs?: number;\n  /** Fetch the file and write it to destPath (the parent directory exists). */\n  download(destPath: string): Promise<void>;\n}\n\n/** Outcome of saving incoming attachments; error policy stays with the adapter. */\nexport interface SavedAttachments {\n  saved: Attachment[];\n  failed: { name: string; error: unknown }[];\n}\n\nexport interface MessageIntakeOptions<TEvent extends ConversationEvent> {\n  eventBase: TEvent;\n  /** Explicit DM, mention, command or supported thread continuation. */\n  addressed: boolean;\n  magicWord: MagicWordIntakeOptions;\n  /**\n   * \"reject\" bounces a new message while its session is already running\n   * (with an \"Already working\" reply); \"queue\" lines it up behind the run.\n   */\n  busyPolicy: \"queue\" | \"reject\";\n  logEntryBase: Record<string, unknown>;\n  log?: (entry: Record<string, unknown>) => void;\n  processAttachments: () => Promise<unknown[]>;\n  queueKey: string;\n  enqueue: (queueKey: string, work: () => Promise<void>) => void;\n  handler: MessagingEventHandler;\n  bot: MessagingBot;\n  createContext: (event: TEvent) => ConversationContext;\n  deferAttachmentsUntilRun?: boolean;\n}\n\nexport interface MarkdownTable {\n  headers: string[];\n  rows: string[][];\n  /** Source line span, so a caller can slice the prose around it. */\n  startLine: number;\n  endLine: number;\n}\n"]}