@geminixiang/mikan 1.0.0-beta.76 → 1.0.0-beta.78

package/dist/adapters/discord/context.js

@@ -3,16 +3,13 @@ import { resolveChatSessionKey } from "../../sessions/session-key.js";
 import { createProgressiveRenderer, formatMarkdownToolResult } from "../progressive-renderer.js";
 import { DISCORD_V2_TEXT_LIMIT } from "./components.js";
 import { formatDiscordMarkdown } from "./format.js";
-// Components V2 allows 4000 characters across a message's text, against 2000
-// for classic content — the reason for using it at all. The margin leaves room
-// for the working indicator and for the continuation marker on a split.
 const MAX_LENGTH = DISCORD_V2_TEXT_LIMIT - 100;
 const formatDiscordContinuation = (partNum) => `*(continued ${partNum})*`;
 function isDiscordMessageReference(id) {
     return typeof id === "string" && id !== "" && !id.startsWith("event:");
 }
 export function createDiscordAdapters(event, bot) {
-    const conversationId = event.conversationId;
+    const conversationId = event.address.conversationId;
     const channelId = conversationId;
     const threadTargetId = isDiscordMessageReference(event.thread_ts) ? event.thread_ts : undefined;
     const replyTargetId = isDiscordMessageReference(event.ts) ? event.ts : undefined;
@@ -36,7 +33,6 @@ export function createDiscordAdapters(event, bot) {
         attachments: event.attachments,
         threadTs: event.thread_ts,
     });
-    // The bot's getMessagingInfo() is the single authority for platform info.
     const platform = bot.getMessagingInfo();
     function postFirst(text) {
         if (threadTargetId)
@@ -53,14 +49,10 @@ export function createDiscordAdapters(event, bot) {
         workingIndicator: " ...",
         supportsDeltas: true,
         typing: {
-            // Send immediately and repeat every 8s (Discord clears indicator after ~10s)
             send: () => bot.sendTyping(channelId),
             intervalMs: 8000,
             stopOnSend: true,
         },
-        // The last step before sending: the model writes standard markdown, and
-        // the parts Discord cannot render are converted here rather than by
-        // constraining what the model may write.
         prepareSource: (text) => formatDiscordMarkdown(text),
         formatToolResult: formatMarkdownToolResult,
         responseErrorContext: (responseId) => ({
@@ -76,8 +68,6 @@ export function createDiscordAdapters(event, bot) {
         }),
         post: postFirst,
         update: (id, text) => bot.updateMessageRaw(channelId, 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: async (text, responseId) => {
             if (threadTargetId)
                 return bot.postInThread(channelId, threadTargetId, text);

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/discord/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAA4B,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,6EAA6E;AAC7E,+EAA+E;AAC/E,wEAAwE;AACxE,MAAM,UAAU,GAAG,qBAAqB,GAAG,GAAG,CAAC;AAE/C,MAAM,yBAAyB,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,eAAe,OAAO,IAAI,CAAC;AAE1F,SAAS,yBAAyB,CAAC,EAAsB;IACvD,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,GAAwB;IAExB,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5C,MAAM,SAAS,GAAG,cAAc,CAAC;IACjC,MAAM,cAAc,GAAG,yBAAyB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,MAAM,aAAa,GAAG,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,MAAM,OAAO,GAAG,yBAAyB,CAAC;QACxC,QAAQ,EAAE,SAAS;QACnB,cAAc;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EACR,KAAK,CAAC,UAAU;YAChB,qBAAqB,CAAC;gBACpB,cAAc;gBACd,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,kBAAkB,EAAE,IAAI;gBACxB,QAAQ,EAAE,KAAK,CAAC,SAAS;aAC1B,CAAC;QACJ,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS;KAC1B,CAAC,CAAC;IAEH,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAExC,SAAS,SAAS,CAAC,IAAY;QAC7B,IAAI,cAAc;YAAE,OAAO,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QAC7E,IAAI,aAAa;YAAE,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QACxE,OAAO,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,GAAG,yBAAyB,CAAC;QAC9C,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,UAAU;QACrB,kBAAkB,EAAE,yBAAyB;QAC7C,WAAW,EAAE,WAAW;QACxB,gBAAgB,EAAE,MAAM;QACxB,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE;YACN,6EAA6E;YAC7E,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;YACrC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;SACjB;QACD,wEAAwE;QACxE,oEAAoE;QACpE,yCAAyC;QACzC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;QACpD,gBAAgB,EAAE,wBAAwB;QAC1C,oBAAoB,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACrC,QAAQ,EAAE,SAAS;YACnB,cAAc;YACd,SAAS;YACT,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,iBAAiB,EAAE,UAAU;YAC7B,QAAQ,EAAE,cAAc;YACxB,aAAa;YACb,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC;QACF,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC;QAC/D,uEAAuE;QACvE,2DAA2D;QAC3D,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;YACpC,IAAI,cAAc;gBAAE,OAAO,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YAC7E,IAAI,aAAa;gBAAE,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;YACxE,IAAI,UAAU,KAAK,IAAI;gBAAE,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YAC3E,OAAO,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;QACnD,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QACrE,UAAU,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC;QAC3E,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;KAC/F,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACpE,CAAC","sourcesContent":["import { createConversationMessage, type ConversationContext } from \"../index.js\";\nimport { resolveChatSessionKey } from \"../../sessions/session-key.js\";\nimport { createProgressiveRenderer, formatMarkdownToolResult } from \"../progressive-renderer.js\";\nimport { DISCORD_V2_TEXT_LIMIT } from \"./components.js\";\nimport { formatDiscordMarkdown } from \"./format.js\";\nimport type { DiscordMessagingBot, DiscordEvent } from \"./bot.js\";\n\n// Components V2 allows 4000 characters across a message's text, against 2000\n// for classic content — the reason for using it at all. The margin leaves room\n// for the working indicator and for the continuation marker on a split.\nconst MAX_LENGTH = DISCORD_V2_TEXT_LIMIT - 100;\n\nconst formatDiscordContinuation = (partNum: number): string => `*(continued ${partNum})*`;\n\nfunction isDiscordMessageReference(id: string | undefined): id is string {\n  return typeof id === \"string\" && id !== \"\" && !id.startsWith(\"event:\");\n}\n\nexport function createDiscordAdapters(\n  event: DiscordEvent,\n  bot: DiscordMessagingBot,\n): ConversationContext {\n  const conversationId = event.conversationId;\n  const channelId = conversationId;\n  const threadTargetId = isDiscordMessageReference(event.thread_ts) ? event.thread_ts : undefined;\n  const replyTargetId = isDiscordMessageReference(event.ts) ? event.ts : undefined;\n\n  const message = createConversationMessage({\n    platform: \"discord\",\n    conversationId,\n    address: event.address,\n    id: event.ts,\n    sessionKey:\n      event.sessionKey ??\n      resolveChatSessionKey({\n        conversationId,\n        conversationKind: event.conversationKind,\n        messageId: event.ts,\n        persistentTopLevel: true,\n        threadTs: event.thread_ts,\n      }),\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  function postFirst(text: string): Promise<string> {\n    if (threadTargetId) return bot.postInThread(channelId, threadTargetId, text);\n    if (replyTargetId) return bot.postReply(channelId, replyTargetId, text);\n    return bot.postMessage(channelId, text);\n  }\n\n  const { responder } = createProgressiveRenderer({\n    label: \"Discord\",\n    maxLength: MAX_LENGTH,\n    formatContinuation: formatDiscordContinuation,\n    errorPrefix: \"*Error:* \",\n    workingIndicator: \" ...\",\n    supportsDeltas: true,\n    typing: {\n      // Send immediately and repeat every 8s (Discord clears indicator after ~10s)\n      send: () => bot.sendTyping(channelId),\n      intervalMs: 8000,\n      stopOnSend: true,\n    },\n    // The last step before sending: the model writes standard markdown, and\n    // the parts Discord cannot render are converted here rather than by\n    // constraining what the model may write.\n    prepareSource: (text) => formatDiscordMarkdown(text),\n    formatToolResult: formatMarkdownToolResult,\n    responseErrorContext: (responseId) => ({\n      platform: \"discord\",\n      conversationId,\n      channelId,\n      messageId: message.id,\n      sessionKey: message.sessionKey,\n      responseMessageId: responseId,\n      threadTs: threadTargetId,\n      replyTargetId,\n      conversationKind: message.conversationKind,\n    }),\n    post: postFirst,\n    update: (id, text) => bot.updateMessageRaw(channelId, 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: async (text, responseId) => {\n      if (threadTargetId) return bot.postInThread(channelId, threadTargetId, text);\n      if (replyTargetId) return bot.postReply(channelId, replyTargetId, text);\n      if (responseId !== null) return bot.postReply(channelId, responseId, text);\n      return bot.postMessage(channelId, text);\n    },\n    delete: (id) => bot.deleteMessageRaw(channelId, id),\n    logBotResponse: (text, id) => bot.logBotResponse(channelId, text, id),\n    uploadFile: (filePath, title) => bot.uploadFile(channelId, filePath, title),\n    react: replyTargetId ? (emoji) => bot.addReaction(channelId, replyTargetId, emoji) : undefined,\n  });\n\n  return { address: message.address, message, responder, platform };\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/discord/context.ts"],"names":[],"mappings":"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","sourcesContent":["import { createConversationMessage, type ConversationContext } from \"../index.js\";\nimport { resolveChatSessionKey } from \"../../sessions/session-key.js\";\nimport { createProgressiveRenderer, formatMarkdownToolResult } from \"../progressive-renderer.js\";\nimport { DISCORD_V2_TEXT_LIMIT } from \"./components.js\";\nimport { formatDiscordMarkdown } from \"./format.js\";\nimport type { DiscordMessagingBot, DiscordEvent } from \"./bot.js\";\n\nconst MAX_LENGTH = DISCORD_V2_TEXT_LIMIT - 100;\n\nconst formatDiscordContinuation = (partNum: number): string => `*(continued ${partNum})*`;\n\nfunction isDiscordMessageReference(id: string | undefined): id is string {\n  return typeof id === \"string\" && id !== \"\" && !id.startsWith(\"event:\");\n}\n\nexport function createDiscordAdapters(\n  event: DiscordEvent,\n  bot: DiscordMessagingBot,\n): ConversationContext {\n  const conversationId = event.address.conversationId;\n  const channelId = conversationId;\n  const threadTargetId = isDiscordMessageReference(event.thread_ts) ? event.thread_ts : undefined;\n  const replyTargetId = isDiscordMessageReference(event.ts) ? event.ts : undefined;\n\n  const message = createConversationMessage({\n    platform: \"discord\",\n    conversationId,\n    address: event.address,\n    id: event.ts,\n    sessionKey:\n      event.sessionKey ??\n      resolveChatSessionKey({\n        conversationId,\n        conversationKind: event.conversationKind,\n        messageId: event.ts,\n        persistentTopLevel: true,\n        threadTs: event.thread_ts,\n      }),\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 = bot.getMessagingInfo();\n\n  function postFirst(text: string): Promise<string> {\n    if (threadTargetId) return bot.postInThread(channelId, threadTargetId, text);\n    if (replyTargetId) return bot.postReply(channelId, replyTargetId, text);\n    return bot.postMessage(channelId, text);\n  }\n\n  const { responder } = createProgressiveRenderer({\n    label: \"Discord\",\n    maxLength: MAX_LENGTH,\n    formatContinuation: formatDiscordContinuation,\n    errorPrefix: \"*Error:* \",\n    workingIndicator: \" ...\",\n    supportsDeltas: true,\n    typing: {\n      send: () => bot.sendTyping(channelId),\n      intervalMs: 8000,\n      stopOnSend: true,\n    },\n    prepareSource: (text) => formatDiscordMarkdown(text),\n    formatToolResult: formatMarkdownToolResult,\n    responseErrorContext: (responseId) => ({\n      platform: \"discord\",\n      conversationId,\n      channelId,\n      messageId: message.id,\n      sessionKey: message.sessionKey,\n      responseMessageId: responseId,\n      threadTs: threadTargetId,\n      replyTargetId,\n      conversationKind: message.conversationKind,\n    }),\n    post: postFirst,\n    update: (id, text) => bot.updateMessageRaw(channelId, id, text),\n    postExtra: async (text, responseId) => {\n      if (threadTargetId) return bot.postInThread(channelId, threadTargetId, text);\n      if (replyTargetId) return bot.postReply(channelId, replyTargetId, text);\n      if (responseId !== null) return bot.postReply(channelId, responseId, text);\n      return bot.postMessage(channelId, text);\n    },\n    delete: (id) => bot.deleteMessageRaw(channelId, id),\n    logBotResponse: (text, id) => bot.logBotResponse(channelId, text, id),\n    uploadFile: (filePath, title) => bot.uploadFile(channelId, filePath, title),\n    react: replyTargetId ? (emoji) => bot.addReaction(channelId, replyTargetId, emoji) : undefined,\n  });\n\n  return { address: message.address, message, responder, platform };\n}\n"]}

package/dist/adapters/discord/format.d.ts

@@ -1,3 +1,2 @@
-/** Everything Discord cannot render, converted to something it can. */
 export declare function formatDiscordMarkdown(source: string): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/adapters/discord/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/format.ts"],"names":[],"mappings":"AA8FA,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/format.ts"],"names":[],"mappings":"AAyDA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/adapters/discord/format.js

@@ -1,27 +1,6 @@
 import { extractMarkdownTables, normalizeMarkdownTables, renderMonospaceTable, } from "../markdown-tables.js";
-/**
- * Discord-side presentation of a response.
- *
- * The model writes standard markdown for every platform; making it write
- * Discord-flavoured markdown instead would trade one platform's rendering for
- * another's, and Discord is the one that renders the least. So the conversion
- * belongs here, at the last step before sending.
- *
- * Discord renders most of what we emit — headings, lists, quotes, fenced code
- * with highlighting, links, spoilers, and its own `-#` subtext. What it does
- * not render is handled below, each verified against the real client rather
- * than against the docs.
- */
-/** Fence tables at this width or less; wider ones wrap and look worse aligned. */
 const MAX_FENCED_TABLE_WIDTH = 120;
-/** Stand-in for a horizontal rule, which Discord has no syntax for. */
 const RULE = "─".repeat(30);
-/**
- * Replace GFM tables with aligned, fenced equivalents.
- *
- * Prose is sliced verbatim around each table rather than re-serialized, so
- * everything Discord already renders correctly passes through untouched.
- */
 function convertTables(source) {
     const normalized = normalizeMarkdownTables(source);
     const tables = extractMarkdownTables(normalized);
@@ -33,8 +12,6 @@ function convertTables(source) {
     for (const table of tables) {
         out.push(...lines.slice(cursor, table.startLine));
         const rendered = renderMonospaceTable(table);
-        // Too wide to align: Discord soft-wraps inside a fence and the columns
-        // scatter, which is worse than the pipes. Leave those as they came.
         if (rendered.split("\n").reduce((max, line) => Math.max(max, line.length), 0) >
             MAX_FENCED_TABLE_WIDTH) {
             out.push(...lines.slice(table.startLine, table.endLine));
@@ -47,13 +24,6 @@ function convertTables(source) {
     out.push(...lines.slice(cursor));
     return out.join("\n");
 }
-/**
- * Line-level rewrites for constructs Discord ignores, applied outside fenced
- * code so a code sample keeps whatever it contains.
- *
- * Runs after table conversion because that step maps source line numbers, and
- * a rewrite that changed the line count first would misplace every table.
- */
 function convertUnsupportedSyntax(source) {
     let inFence = false;
     return source
@@ -65,19 +35,12 @@ function convertUnsupportedSyntax(source) {
         }
         if (inFence)
             return line;
-        // A horizontal rule renders as its own literal dashes. Discord has no
-        // rule syntax, so draw one — dropping the line would lose the section
-        // break the author meant.
         if (/^\s*(-{3,}|\*{3,}|_{3,})\s*$/.test(line))
             return RULE;
-        // Discord does not render markdown images: `![alt](url)` arrives as a
-        // stray "!" followed by a link, and the image never appears. A bare URL
-        // *does* auto-embed, so emit that and keep the alt text above it.
         return line.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_match, alt, url) => alt.trim() ? `${alt}\n${url}` : url);
     })
         .join("\n");
 }
-/** Everything Discord cannot render, converted to something it can. */
 export function formatDiscordMarkdown(source) {
     return convertUnsupportedSyntax(convertTables(source));
 }

package/dist/adapters/discord/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/adapters/discord/format.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  extractMarkdownTables,\n  normalizeMarkdownTables,\n  renderMonospaceTable,\n} from \"../markdown-tables.js\";\n\n/**\n * Discord-side presentation of a response.\n *\n * The model writes standard markdown for every platform; making it write\n * Discord-flavoured markdown instead would trade one platform's rendering for\n * another's, and Discord is the one that renders the least. So the conversion\n * belongs here, at the last step before sending.\n *\n * Discord renders most of what we emit — headings, lists, quotes, fenced code\n * with highlighting, links, spoilers, and its own `-#` subtext. What it does\n * not render is handled below, each verified against the real client rather\n * than against the docs.\n */\n\n/** Fence tables at this width or less; wider ones wrap and look worse aligned. */\nconst MAX_FENCED_TABLE_WIDTH = 120;\n\n/** Stand-in for a horizontal rule, which Discord has no syntax for. */\nconst RULE = \"─\".repeat(30);\n\n/**\n * Replace GFM tables with aligned, fenced equivalents.\n *\n * Prose is sliced verbatim around each table rather than re-serialized, so\n * everything Discord already renders correctly passes through untouched.\n */\nfunction convertTables(source: string): string {\n  const normalized = normalizeMarkdownTables(source);\n  const tables = extractMarkdownTables(normalized);\n  if (tables.length === 0) return source;\n\n  const lines = normalized.split(\"\\n\");\n  const out: string[] = [];\n  let cursor = 0;\n\n  for (const table of tables) {\n    out.push(...lines.slice(cursor, table.startLine));\n    const rendered = renderMonospaceTable(table);\n    // Too wide to align: Discord soft-wraps inside a fence and the columns\n    // scatter, which is worse than the pipes. Leave those as they came.\n    if (\n      rendered.split(\"\\n\").reduce((max, line) => Math.max(max, line.length), 0) >\n      MAX_FENCED_TABLE_WIDTH\n    ) {\n      out.push(...lines.slice(table.startLine, table.endLine));\n    } else {\n      out.push(\"```\", rendered, \"```\");\n    }\n    cursor = table.endLine;\n  }\n  out.push(...lines.slice(cursor));\n\n  return out.join(\"\\n\");\n}\n\n/**\n * Line-level rewrites for constructs Discord ignores, applied outside fenced\n * code so a code sample keeps whatever it contains.\n *\n * Runs after table conversion because that step maps source line numbers, and\n * a rewrite that changed the line count first would misplace every table.\n */\nfunction convertUnsupportedSyntax(source: string): string {\n  let inFence = false;\n  return source\n    .split(\"\\n\")\n    .map((line) => {\n      if (/^\\s*(```|~~~)/.test(line)) {\n        inFence = !inFence;\n        return line;\n      }\n      if (inFence) return line;\n\n      // A horizontal rule renders as its own literal dashes. Discord has no\n      // rule syntax, so draw one — dropping the line would lose the section\n      // break the author meant.\n      if (/^\\s*(-{3,}|\\*{3,}|_{3,})\\s*$/.test(line)) return RULE;\n\n      // Discord does not render markdown images: `![alt](url)` arrives as a\n      // stray \"!\" followed by a link, and the image never appears. A bare URL\n      // *does* auto-embed, so emit that and keep the alt text above it.\n      return line.replace(/!\\[([^\\]]*)\\]\\(([^)\\s]+)\\)/g, (_match, alt: string, url: string) =>\n        alt.trim() ? `${alt}\\n${url}` : url,\n      );\n    })\n    .join(\"\\n\");\n}\n\n/** Everything Discord cannot render, converted to something it can. */\nexport function formatDiscordMarkdown(source: string): string {\n  return convertUnsupportedSyntax(convertTables(source));\n}\n"]}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/adapters/discord/format.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5B,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEvC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC7C,IACE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzE,sBAAsB,EACtB,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc;IAC9C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC,OAAO,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3D,OAAO,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,GAAW,EAAE,EAAE,CACtF,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CACpC,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,wBAAwB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import {\n  extractMarkdownTables,\n  normalizeMarkdownTables,\n  renderMonospaceTable,\n} from \"../markdown-tables.js\";\n\nconst MAX_FENCED_TABLE_WIDTH = 120;\n\nconst RULE = \"─\".repeat(30);\n\nfunction convertTables(source: string): string {\n  const normalized = normalizeMarkdownTables(source);\n  const tables = extractMarkdownTables(normalized);\n  if (tables.length === 0) return source;\n\n  const lines = normalized.split(\"\\n\");\n  const out: string[] = [];\n  let cursor = 0;\n\n  for (const table of tables) {\n    out.push(...lines.slice(cursor, table.startLine));\n    const rendered = renderMonospaceTable(table);\n    if (\n      rendered.split(\"\\n\").reduce((max, line) => Math.max(max, line.length), 0) >\n      MAX_FENCED_TABLE_WIDTH\n    ) {\n      out.push(...lines.slice(table.startLine, table.endLine));\n    } else {\n      out.push(\"```\", rendered, \"```\");\n    }\n    cursor = table.endLine;\n  }\n  out.push(...lines.slice(cursor));\n\n  return out.join(\"\\n\");\n}\n\nfunction convertUnsupportedSyntax(source: string): string {\n  let inFence = false;\n  return source\n    .split(\"\\n\")\n    .map((line) => {\n      if (/^\\s*(```|~~~)/.test(line)) {\n        inFence = !inFence;\n        return line;\n      }\n      if (inFence) return line;\n\n      if (/^\\s*(-{3,}|\\*{3,}|_{3,})\\s*$/.test(line)) return RULE;\n\n      return line.replace(/!\\[([^\\]]*)\\]\\(([^)\\s]+)\\)/g, (_match, alt: string, url: string) =>\n        alt.trim() ? `${alt}\\n${url}` : url,\n      );\n    })\n    .join(\"\\n\");\n}\n\nexport function formatDiscordMarkdown(source: string): string {\n  return convertUnsupportedSyntax(convertTables(source));\n}\n"]}

package/dist/adapters/github/bot.d.ts

@@ -8,7 +8,6 @@ export declare class GithubMessagingBot implements MessagingBot {
     private readonly client;
     private readonly handler;
     private readonly config;
-    /** Host-side backend for the github_* tool pack; standalone from polling. */
     readonly ops: GithubOps;
     private appSlug;
     private botEmail;
@@ -35,68 +34,25 @@ export declare class GithubMessagingBot implements MessagingBot {
     logToFile(conversationId: string, entry: object): void;
     logBotResponse(conversationId: string, text: string, ts: string): void;
     private getQueue;
-    /**
-     * Webhook poke: run a poll soon. Debounced so a burst of deliveries costs
-     * one tick; a poke landing mid-poll marks it pending and the tick re-runs,
-     * because the in-flight pass may already be past the poked repo's feeds.
-     */
     requestPoll(debounceMs?: number): void;
-    /** One poll tick over every watched repo. Public for tests. */
     poll(): Promise<void>;
     private pollWatchedRepos;
     private pollRepo;
-    /**
-     * One feed's watermark advance — the same discipline for all three feeds:
-     * bump the cursor on any fresher updated_at, then let the id watermark plus
-     * the creation baseline decide what actually triggers (edits re-surface old
-     * items with a fresh updated_at). Bot-authored items advance the watermark
-     * without triggering.
-     */
     private advanceFeed;
     private loadSyncState;
-    /** The persisted form of the current watermarks; the test/inspection surface. */
     syncStateSnapshot(): GithubSyncState;
     private persistSyncState;
-    /** Fresh regex per call: the `g` flag makes `test`/`replace` stateful. */
     private mentionPattern;
     private isMentioned;
     private stripMention;
-    /** The Conversation office for a GitHub conversation id (one PR/issue). */
     private office;
     private isParticipating;
-    /**
-     * True when `user` holds at least write permission on the repo. Fails
-     * closed: a failed lookup denies the trigger (and logs) rather than
-     * letting an unverified commenter drive the agent.
-     */
     private hasTriggerPermission;
     private handleIncoming;
-    /**
-     * First contact: log the issue title/body ahead of the comment so the
-     * session history starts with what the thread is about. The clone is
-     * (re)attempted on every trigger while ./repo is missing — a no-op once
-     * it exists — so a failed first clone (e.g. App permissions granted
-     * later) heals on the next mention instead of wedging the conversation.
-     */
     private prepareConversation;
-    /**
-     * Decorates an inline review comment with its diff anchor and (for replies)
-     * the thread's earlier turns, so the agent knows which code the feedback is
-     * about without hunting through the PR. The rc-<id> in the header is what
-     * github_review_reply takes to answer in-thread.
-     */
     private formatReviewMessage;
-    /**
-     * Earlier turns of one review thread (root + replies before the trigger),
-     * newest-truncated. Fail-soft: context is a nicety, the trigger is not.
-     */
     private reviewThreadContext;
     private logIssueContext;
-    /**
-     * Clone the conversation's repo into its dir (bind-mounted into the
-     * sandbox) using an ephemeral contents:read token that never leaves the
-     * host. Non-fatal: a failed clone degrades to the pre-clone experience.
-     */
     private ensureRepoClone;
 }
 //# sourceMappingURL=bot.d.ts.map

package/dist/adapters/github/bot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/bot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/bot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAY9E,OAAO,EAAE,YAAY,EAA0C,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAgC,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU1E,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAKrB,eAAe,EAChB,MAAM,YAAY,CAAC;AA8CpB,eAAO,MAAM,wBAAwB,YAAa,MAAM,KAAG,MAAoC,CAAC;AAwEhG,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,eAAe,CAA0D;IACjF,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,gBAAgB,CAA+B;IAEvD,YAAY,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,YAAY,EAWzF;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA0D3B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAa1B;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhE;IAEK,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBlF;IAED,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAe9C;IAED,gBAAgB,IAAI,aAAa,CAWhC;IAEK,WAAW,CAAC,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3E;IAEK,aAAa,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;IAED,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErD;IAED,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAErE;IAED,OAAO,CAAC,QAAQ;IAShB,WAAW,CAAC,UAAU,SAA2B,GAAG,IAAI,CAYvD;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB1B;YAEa,gBAAgB;YAehB,QAAQ;YAqDR,WAAW;IA4BzB,OAAO,CAAC,aAAa;IAgBrB,iBAAiB,IAAI,eAAe,CAYnC;IAED,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,eAAe;YAIT,oBAAoB;YA0BpB,cAAc;YAkEd,mBAAmB;YAgBnB,mBAAmB;YAqBnB,mBAAmB;YA+BnB,eAAe;YA6Bf,eAAe;CAiC9B"}

package/dist/adapters/github/bot.js

@@ -20,21 +20,12 @@ const SyncStateSchema = Type.Object({
         cursor: Type.String(),
         seenComments: Type.Array(Type.Number()),
         seenIssues: Type.Array(Type.Number()),
-        // Optional: state files written before review-comment polling must keep
-        // loading — a schema failure re-baselines and silently drops dedup state.
         seenReviewComments: Type.Optional(Type.Array(Type.Number())),
     })),
 });
-/**
- * Re-fetch this far behind the cursor each poll. Dedup is by id (the
- * watermark), so the overlap only costs bandwidth and closes the boundary
- * races of a bare `since` timestamp (DESIGN.md § Event source).
- */
 const POLL_OVERLAP_MS = 5 * 60 * 1000;
 const MAX_SEEN_IDS = 5000;
-/** Webhook pokes within this window collapse into one poll tick. */
 const REQUEST_POLL_DEBOUNCE_MS = 1500;
-/** Effective role → rank, for the trigger-permission gate. */
 const PERMISSION_RANK = {
     none: 0,
     read: 1,
@@ -43,20 +34,12 @@ const PERMISSION_RANK = {
     maintain: 4,
     admin: 5,
 };
-/**
- * Commenters need write or better to trigger the agent. Fixed, not a config
- * knob: it guards public repos (anyone can comment there), and the people who
- * ask an agent to change code are exactly the people with push access.
- */
 const REQUIRED_TRIGGER_RANK = PERMISSION_RANK.write;
-/** Rank for an arbitrary API-reported permission name; unknown names rank 0. */
 function rankOfPermission(name) {
     return PERMISSION_RANK[name] ?? 0;
 }
-/** Permission lookups are cached this long per repo+user. */
 const PERMISSION_CACHE_TTL_MS = 5 * 60 * 1000;
 export const formatGithubContinuation = (partNum) => `*(continued ${partNum})*`;
-/** Slack-style emoji short names → GitHub reaction content values. */
 const GITHUB_REACTIONS = {
     "+1": "+1",
     thumbsup: "+1",
@@ -71,9 +54,6 @@ const GITHUB_REACTIONS = {
     rocket: "rocket",
     eyes: "eyes",
 };
-// Repo refs are lowercased at every entry point (env config here, the
-// installation API in start()) so conversation ids and sync-state keys never
-// depend on how a repo's name was spelled — GitHub is case-insensitive.
 function parseRepoList(repos) {
     return repos.map((entry) => {
         const [owner, repo, ...rest] = entry.split("/");
@@ -83,7 +63,6 @@ function parseRepoList(repos) {
         return { owner: owner.toLowerCase(), repo: repo.toLowerCase() };
     });
 }
-/** Sets iterate in insertion order; drop the oldest ids once over the cap. */
 function pruneSeen(seen) {
     if (seen.size <= MAX_SEEN_IDS)
         return;
@@ -94,7 +73,6 @@ function pruneSeen(seen) {
         seen.delete(id);
     }
 }
-/** Issue number from a comment's `issue_url` (…/repos/o/r/issues/42). */
 function issueNumberFromUrl(issueUrl) {
     const match = /\/issues\/(\d+)$/.exec(issueUrl);
     if (!match) {
@@ -102,7 +80,6 @@ function issueNumberFromUrl(issueUrl) {
     }
     return Number(match[1]);
 }
-/** PR number from a review comment's `pull_request_url` (…/repos/o/r/pulls/42). */
 function prNumberFromUrl(pullRequestUrl) {
     const match = /\/pulls\/(\d+)$/.exec(pullRequestUrl);
     if (!match) {
@@ -110,7 +87,6 @@ function prNumberFromUrl(pullRequestUrl) {
     }
     return Number(match[1]);
 }
-/** Keep the tail: a review comment anchors to the hunk's final lines. */
 const MAX_DIFF_HUNK_CHARS = 1500;
 const MAX_THREAD_TURNS = 10;
 const MAX_THREAD_TURN_CHARS = 500;
@@ -139,16 +115,10 @@ export class GithubMessagingBot {
                 });
         this.ops = new GithubOps(this.client, { workspace: config.workspace });
     }
-    // ==========================================================================
-    // Public API (implements MessagingBot)
-    // ==========================================================================
     async start() {
         this.stopped = false;
         this.stopping = false;
         this.appSlug = await this.client.getAppSlug();
-        // Canonical noreply author email (<user-id>+<login>@users.noreply.github.com)
-        // so the bot's commits link to its avatar/profile; degrade to a plain
-        // noreply spelling when the lookup fails.
         try {
             const botUserId = await this.client.getUserId(`${this.appSlug}[bot]`);
             this.botEmail = `${botUserId}+${this.appSlug}[bot]@users.noreply.github.com`;
@@ -166,8 +136,6 @@ export class GithubMessagingBot {
         if (this.watchedRepos.length === 0) {
             log.logWarning("GitHub: installation has no repositories; nothing to poll");
         }
-        // Restore persisted watermarks; a repo watched for the first time gets a
-        // baseline of "now" so history never triggers (DESIGN.md § Event source).
         const persisted = this.loadSyncState();
         const now = new Date().toISOString();
         for (const repo of this.watchedRepos) {
@@ -251,7 +219,7 @@ export class GithubMessagingBot {
     enqueueEvent(event) {
         if (this.stopped)
             return false;
-        const conversationId = event.conversationId;
+        const conversationId = event.address.conversationId;
         const queue = this.getQueue(conversationId);
         if (queue.size() >= 5) {
             log.logWarning(`Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`);
@@ -274,9 +242,6 @@ export class GithubMessagingBot {
             users: [],
         };
     }
-    // ==========================================================================
-    // Internal helpers (used by context.ts)
-    // ==========================================================================
     async postComment(ref, text) {
         const comment = await githubRetry(() => this.client.createIssueComment(ref.owner, ref.repo, ref.number, text));
         return comment.id;
@@ -290,9 +255,6 @@ export class GithubMessagingBot {
     logBotResponse(conversationId, text, ts) {
         appendBotResponseLog(this.office(conversationId), text, ts);
     }
-    // ==========================================================================
-    // Private - polling
-    // ==========================================================================
     getQueue(conversationId) {
         let queue = this.queues.get(conversationId);
         if (!queue) {
@@ -301,11 +263,6 @@ export class GithubMessagingBot {
         }
         return queue;
     }
-    /**
-     * Webhook poke: run a poll soon. Debounced so a burst of deliveries costs
-     * one tick; a poke landing mid-poll marks it pending and the tick re-runs,
-     * because the in-flight pass may already be past the poked repo's feeds.
-     */
     requestPoll(debounceMs = REQUEST_POLL_DEBOUNCE_MS) {
         if (this.stopped || this.stopping)
             return;
@@ -321,7 +278,6 @@ export class GithubMessagingBot {
         }, debounceMs);
         this.requestPollTimer.unref();
     }
-    /** One poll tick over every watched repo. Public for tests. */
     async poll() {
         if (this.stopped || this.stopping)
             return;
@@ -362,9 +318,6 @@ export class GithubMessagingBot {
             return false;
         const since = new Date(Date.parse(state.cursor) - POLL_OVERLAP_MS).toISOString();
         let changed = false;
-        // Comment activity also bumps the parent issue's updated_at, so the issues
-        // list mostly echoes the comments list; only issues *created* since the
-        // baseline are new conversations (their body is the first message).
         const issues = (await this.client.listIssuesSince(repo.owner, repo.repo, since)) ?? [];
         changed =
             (await this.advanceFeed(state, state.seenIssues, issues, (issue) => ({
@@ -384,9 +337,6 @@ export class GithubMessagingBot {
                 text: comment.body,
                 createdAt: comment.created_at,
             }))) || changed;
-        // Inline PR review comments live in their own endpoint and id space; the
-        // same watermark discipline applies. The bot's own thread replies (the
-        // github_review_reply tool) re-surface here and are dropped as Bot-authored.
         const reviewComments = (await this.client.listPullReviewCommentsSince(repo.owner, repo.repo, since)) ?? [];
         changed =
             (await this.advanceFeed(state, state.seenReviewComments, reviewComments, (comment) => ({
@@ -409,13 +359,6 @@ export class GithubMessagingBot {
         pruneSeen(state.seenReviewComments);
         return changed;
     }
-    /**
-     * One feed's watermark advance — the same discipline for all three feeds:
-     * bump the cursor on any fresher updated_at, then let the id watermark plus
-     * the creation baseline decide what actually triggers (edits re-surface old
-     * items with a fresh updated_at). Bot-authored items advance the watermark
-     * without triggering.
-     */
     async advanceFeed(state, seen, items, toIncoming) {
         let changed = false;
         for (const item of items) {
@@ -433,21 +376,15 @@ export class GithubMessagingBot {
         }
         return changed;
     }
-    // ==========================================================================
-    // Private - watermark persistence
-    // ==========================================================================
     loadSyncState() {
         try {
             return readJsonSchemaFileIfExists(this.config.syncStatePath, SyncStateSchema, (detail) => `Malformed GitHub sync state at ${this.config.syncStatePath}: ${detail}`);
         }
         catch (err) {
-            // A bad state file re-baselines (history won't trigger) rather than
-            // blocking startup; the next persist overwrites it.
             log.logWarning("GitHub: ignoring unreadable sync state", err instanceof Error ? err.message : String(err));
             return undefined;
         }
     }
-    /** The persisted form of the current watermarks; the test/inspection surface. */
     syncStateSnapshot() {
         const state = { repos: {} };
         for (const [repoKey, watermark] of this.repoState) {
@@ -465,10 +402,6 @@ export class GithubMessagingBot {
         ensureDirExists(dirname(this.config.syncStatePath));
         atomicWritePrivateFile(this.config.syncStatePath, JSON.stringify(this.syncStateSnapshot()));
     }
-    // ==========================================================================
-    // Private - triggering
-    // ==========================================================================
-    /** Fresh regex per call: the `g` flag makes `test`/`replace` stateful. */
     mentionPattern() {
         return this.appSlug ? new RegExp(`@${this.appSlug}(?![\\w-])`, "gi") : null;
     }
@@ -480,18 +413,12 @@ export class GithubMessagingBot {
         const pattern = this.mentionPattern();
         return (pattern ? text.replace(pattern, "") : text).trim();
     }
-    /** The Conversation office for a GitHub conversation id (one PR/issue). */
     office(conversationId) {
         return this.config.workspace.office(createOfficeAddress("github", conversationId));
     }
     isParticipating(conversationId) {
         return existsSync(this.office(conversationId).logPath);
     }
-    /**
-     * True when `user` holds at least write permission on the repo. Fails
-     * closed: a failed lookup denies the trigger (and logs) rather than
-     * letting an unverified commenter drive the agent.
-     */
     async hasTriggerPermission(ref, user) {
         const cacheKey = `${ref.owner}/${ref.repo}#${user}`;
         const cached = this.permissionCache.get(cacheKey);
@@ -501,8 +428,6 @@ export class GithubMessagingBot {
         let rank;
         try {
             const role = await githubRetry(() => this.client.getCollaboratorPermission(ref.owner, ref.repo, user));
-            // Custom role_name values are unrankable; the legacy permission field
-            // still carries their closest standard mapping, so take the stronger.
             rank = Math.max(rankOfPermission(role.role_name ?? ""), rankOfPermission(role.permission));
         }
         catch (err) {
@@ -519,13 +444,8 @@ export class GithubMessagingBot {
         const conversationId = buildGithubConversationId(item.ref);
         const mentioned = this.isMentioned(item.text);
         const participating = this.isParticipating(conversationId);
-        // Narrow trigger (DESIGN.md): only threads the bot is mentioned in or
-        // already participates in. Everything else is ignored without logging so
-        // busy repos don't grow conversation dirs for untouched issues.
         if (!mentioned && !participating)
             return;
-        // Permission gate: on public repos anyone can comment, so a mention from
-        // anyone below write permission is ignored entirely (no log, no state).
         if (!(await this.hasTriggerPermission(item.ref, item.user))) {
             log.logInfo(`GitHub: ignoring ${conversationId} comment from ${item.user} (below write permission)`);
             return;
@@ -554,7 +474,6 @@ export class GithubMessagingBot {
         await processMessageIntake({
             eventBase,
             addressed: true,
-            // Match on the user-typed text, not the review-decorated messageText.
             magicWord: { text: cleanedText, addressed: mentioned, scopeFallback: "never" },
             busyPolicy: "queue",
             logEntryBase: {
@@ -565,18 +484,11 @@ export class GithubMessagingBot {
                 text: messageText,
                 isMessagingBot: false,
             },
-            // log.jsonl existence is the participation authority for this adapter:
-            // a first-contact magic word ("@bot stop" on an untouched issue) must
-            // not materialize the log, or every later comment from any writer
-            // would be treated as addressed to a conversation the bot never joined.
             log: (entry) => {
                 if (!participating && matchMagicWord(cleanedText) === "stop")
                     return;
                 this.logToFile(conversationId, entry);
             },
-            // GitHub has no attachments; the prep hook is used to lay down the
-            // issue context and repo clone only for messages that will dispatch,
-            // and before the comment itself is logged.
             processAttachments: async () => {
                 await this.prepareConversation(item, conversationId, participating);
                 return [];
@@ -588,19 +500,10 @@ export class GithubMessagingBot {
             createContext: (event) => createGithubAdapters(event, this),
         });
     }
-    /**
-     * First contact: log the issue title/body ahead of the comment so the
-     * session history starts with what the thread is about. The clone is
-     * (re)attempted on every trigger while ./repo is missing — a no-op once
-     * it exists — so a failed first clone (e.g. App permissions granted
-     * later) heals on the next mention instead of wedging the conversation.
-     */
     async prepareConversation(item, conversationId, participating) {
         let isPrHint = item.isPr;
         if (!participating && item.ts !== GITHUB_ISSUE_BODY_TS) {
             const issue = await this.logIssueContext(item.ref, conversationId, item.createdAt);
-            // Only comments arrive without the PR-ness hint; review comments carry
-            // isPr: true (they only exist on PRs) and that knowledge is authoritative.
             if (issue && isPrHint === undefined)
                 isPrHint = Boolean(issue.pull_request);
         }
@@ -609,12 +512,6 @@ export class GithubMessagingBot {
             await this.ensureRepoClone(item.ref, conversationId, isPr);
         }
     }
-    /**
-     * Decorates an inline review comment with its diff anchor and (for replies)
-     * the thread's earlier turns, so the agent knows which code the feedback is
-     * about without hunting through the PR. The rc-<id> in the header is what
-     * github_review_reply takes to answer in-thread.
-     */
     async formatReviewMessage(item, cleanedText) {
         const review = item.review;
         const location = review.line !== null ? `${review.path}:${review.line}` : review.path;
@@ -634,10 +531,6 @@ export class GithubMessagingBot {
         parts.push(cleanedText);
         return parts.join("\n");
     }
-    /**
-     * Earlier turns of one review thread (root + replies before the trigger),
-     * newest-truncated. Fail-soft: context is a nicety, the trigger is not.
-     */
     async reviewThreadContext(ref, rootId, beforeId) {
         try {
             const all = await githubRetry(() => this.client.listPullReviewComments(ref.owner, ref.repo, ref.number));
@@ -665,10 +558,6 @@ export class GithubMessagingBot {
             log.logWarning(`GitHub: could not fetch issue context for ${conversationId}`, err instanceof Error ? err.message : String(err));
             return null;
         }
-        // Dated just before the triggering comment, NOT issue.created_at: history
-        // sync date-sorts entries and drops anything older than its recency
-        // window, so an old issue's real creation date would silently evict the
-        // one message that says what the thread is about.
         const triggerMs = Date.parse(triggerCreatedAt);
         const contextDate = new Date((Number.isFinite(triggerMs) ? triggerMs : Date.now()) - 1000);
         this.logToFile(conversationId, {
@@ -682,14 +571,6 @@ export class GithubMessagingBot {
         });
         return issue;
     }
-    // ==========================================================================
-    // Repo clone
-    // ==========================================================================
-    /**
-     * Clone the conversation's repo into its dir (bind-mounted into the
-     * sandbox) using an ephemeral contents:read token that never leaves the
-     * host. Non-fatal: a failed clone degrades to the pre-clone experience.
-     */
     async ensureRepoClone(ref, conversationId, isPr) {
         const office = this.office(conversationId);
         const dir = conversationRepoDir(office);