@geminixiang/mikan 0.3.0-beta.0 → 0.3.1

package/CHANGELOG.md

@@ -9,6 +9,37 @@ any release.
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-06-02
+
+### Added
+
+- Add Slack Block Kit response support and document Block Kit implementation lessons.
+
+### Fixed
+
+- Require explicit mentions before Slack thread replies trigger the bot.
+
+### Tests
+
+- Enforce phase-one strict checks and unused export checks.
+
+## [0.3.0] - 2026-06-01
+
+### Added
+
+- Add source directory README guides for contributors navigating adapters, commands, runtime, sessions, sandbox, tools, login, admin, and session-view code.
+
+### Changed
+
+- Centralize chat session bootstrapping through `ChatSessionManager` so Slack top-level and thread sessions share the same log-based history sync path.
+- Rename Slack branch/fork terminology to thread/anchor terminology across the adapter, session viewer, and documentation.
+- Model session-view related sessions as parent/thread relationships, including fixed-path thread sessions without legacy parent metadata.
+- Remove legacy thread fork and snapshot helpers from session storage.
+
+### Fixed
+
+- Anchor session-view thread links on the root turn instead of earlier bootstrapped context messages.
+
 ## [0.3.0-beta.0]
 
 ### Changed

package/dist/adapter.d.ts

@@ -21,6 +21,10 @@ export interface ChatToolResult {
     isError: boolean;
     durationMs: number;
 }
+export interface ChatResponseBlockKit {
+    text: string;
+    blocks: object[];
+}
 export interface ChatResponseContext {
     respond(text: string): Promise<void>;
     replaceResponse(text: string, options?: {
@@ -30,6 +34,7 @@ export interface ChatResponseContext {
         style?: "muted" | "error";
     }): Promise<void>;
     respondToolResult(result: ChatToolResult): Promise<void>;
+    respondBlockKit?(response: ChatResponseBlockKit): Promise<void>;
     setTyping(isTyping: boolean): Promise<void>;
     setWorking(working: boolean): Promise<void>;
     uploadFile(filePath: string, title?: string): Promise<void>;

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport type PlatformName = \"slack\" | \"discord\" | \"telegram\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatToolResult {\n  toolName: string;\n  label?: string;\n  args?: Record<string, unknown>;\n  result: string;\n  isError: boolean;\n  durationMs: number;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string, options?: { createOverflowLink?: () => string }): Promise<void>;\n  respondDiagnostic(text: string, options?: { style?: \"muted\" | \"error\" }): Promise<void>;\n  respondToolResult(result: ChatToolResult): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n  diagnostics?: {\n    showUsageSummary?: boolean;\n  };\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Optional alternate conversation identity used for vault routing. */\n  vaultConversationId?: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n  /**\n   * Deliver a message visible only to the given user.\n   * Implementations may use ephemeral messages (Slack), DMs (Discord), or\n   * any other private channel. Absent on platforms with no private delivery.\n   */\n  postPrivate?(conversationId: string, userId: string, text: string): Promise<void>;\n  postPrivateDiagnostic?(\n    conversationId: string,\n    userId: string,\n    text: string,\n    options?: { style?: \"muted\" | \"error\" },\n  ): Promise<void>;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNewCommand(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n"]}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport type PlatformName = \"slack\" | \"discord\" | \"telegram\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatToolResult {\n  toolName: string;\n  label?: string;\n  args?: Record<string, unknown>;\n  result: string;\n  isError: boolean;\n  durationMs: number;\n}\n\nexport interface ChatResponseBlockKit {\n  text: string;\n  blocks: object[];\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string, options?: { createOverflowLink?: () => string }): Promise<void>;\n  respondDiagnostic(text: string, options?: { style?: \"muted\" | \"error\" }): Promise<void>;\n  respondToolResult(result: ChatToolResult): Promise<void>;\n  respondBlockKit?(response: ChatResponseBlockKit): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n  diagnostics?: {\n    showUsageSummary?: boolean;\n  };\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Optional alternate conversation identity used for vault routing. */\n  vaultConversationId?: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n  /**\n   * Deliver a message visible only to the given user.\n   * Implementations may use ephemeral messages (Slack), DMs (Discord), or\n   * any other private channel. Absent on platforms with no private delivery.\n   */\n  postPrivate?(conversationId: string, userId: string, text: string): Promise<void>;\n  postPrivateDiagnostic?(\n    conversationId: string,\n    userId: string,\n    text: string,\n    options?: { style?: \"muted\" | \"error\" },\n  ): Promise<void>;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNewCommand(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n"]}

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport type PlatformName = \"slack\" | \"discord\" | \"telegram\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatToolResult {\n  toolName: string;\n  label?: string;\n  args?: Record<string, unknown>;\n  result: string;\n  isError: boolean;\n  durationMs: number;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string, options?: { createOverflowLink?: () => string }): Promise<void>;\n  respondDiagnostic(text: string, options?: { style?: \"muted\" | \"error\" }): Promise<void>;\n  respondToolResult(result: ChatToolResult): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n  diagnostics?: {\n    showUsageSummary?: boolean;\n  };\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Optional alternate conversation identity used for vault routing. */\n  vaultConversationId?: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n  /**\n   * Deliver a message visible only to the given user.\n   * Implementations may use ephemeral messages (Slack), DMs (Discord), or\n   * any other private channel. Absent on platforms with no private delivery.\n   */\n  postPrivate?(conversationId: string, userId: string, text: string): Promise<void>;\n  postPrivateDiagnostic?(\n    conversationId: string,\n    userId: string,\n    text: string,\n    options?: { style?: \"muted\" | \"error\" },\n  ): Promise<void>;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNewCommand(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n"]}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export type ConversationKind = \"direct\" | \"shared\";\n\nexport type PlatformName = \"slack\" | \"discord\" | \"telegram\";\n\nexport interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatToolResult {\n  toolName: string;\n  label?: string;\n  args?: Record<string, unknown>;\n  result: string;\n  isError: boolean;\n  durationMs: number;\n}\n\nexport interface ChatResponseBlockKit {\n  text: string;\n  blocks: object[];\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string, options?: { createOverflowLink?: () => string }): Promise<void>;\n  respondDiagnostic(text: string, options?: { style?: \"muted\" | \"error\" }): Promise<void>;\n  respondToolResult(result: ChatToolResult): Promise<void>;\n  respondBlockKit?(response: ChatResponseBlockKit): Promise<void>;\n  setTyping(isTyping: boolean): Promise<void>;\n  setWorking(working: boolean): Promise<void>;\n  uploadFile(filePath: string, title?: string): Promise<void>;\n  deleteResponse(): Promise<void>;\n}\n\nexport interface PlatformInfo {\n  name: string;\n  formattingGuide: string;\n  channels: { id: string; name: string }[];\n  users: { id: string; userName: string; displayName: string }[];\n  diagnostics?: {\n    showUsageSummary?: boolean;\n  };\n}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Platform-specific raw conversation/channel/chat identifier */\n  conversationId: string;\n  /** Optional alternate conversation identity used for vault routing. */\n  vaultConversationId?: string;\n  /** Cross-platform conversation shape: direct message vs shared space */\n  conversationKind: ConversationKind;\n  /** Message timestamp or ID as string */\n  ts: string;\n  /** Parent message ID for threaded replies (optional) */\n  thread_ts?: string;\n  /** User ID */\n  user: string;\n  /** Message text (already stripped of bot mentions) */\n  text: string;\n  /** Downloaded attachments */\n  attachments?: { name: string; localPath: string }[];\n  /** Platform-computed session key; overrides default conversationId:thread_ts computation */\n  sessionKey?: string;\n}\n\n/**\n * Minimum interface that every platform bot must implement,\n * used by the central handler in main.ts and by EventsWatcher.\n */\nexport interface Bot {\n  start(): Promise<void>;\n  postMessage(channel: string, text: string): Promise<string>;\n  updateMessage(channel: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\n  /**\n   * Deliver a message visible only to the given user.\n   * Implementations may use ephemeral messages (Slack), DMs (Discord), or\n   * any other private channel. Absent on platforms with no private delivery.\n   */\n  postPrivate?(conversationId: string, userId: string, text: string): Promise<void>;\n  postPrivateDiagnostic?(\n    conversationId: string,\n    userId: string,\n    text: string,\n    options?: { style?: \"muted\" | \"error\" },\n  ): Promise<void>;\n}\n\n/** Pre-created platform adapters passed to the handler */\nexport interface BotAdapters {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n}\n\n/**\n * Handler callbacks invoked by each platform bot.\n * Each bot creates platform-specific adapters before calling handleEvent.\n */\nexport interface RunningSession {\n  sessionKey: string;\n  startedAt: number; // Date.now() when run started\n  /** Last activity timestamp (for detecting hung tasks) */\n  lastActivityAt?: number;\n  /** Current tool/step being executed (if any) */\n  currentTool?: string;\n}\n\nexport interface BotHandler {\n  isRunning(sessionKey: string): boolean;\n  getRunningSessions(): RunningSession[];\n  handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters): Promise<void>;\n  handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n  /** Reset a session: abort if running, delete history, remove from cache */\n  handleNewCommand(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n}\n"]}

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

@@ -1,6 +1,5 @@
 import type { ChatMessage, ChatResponseContext, PlatformInfo } from "../../adapter.js";
 import type { DiscordBot, DiscordEvent } from "./bot.js";
-export declare const DISCORD_FORMATTING_GUIDE = "## Discord Formatting (Markdown)\nBold: **text**, Italic: *text*, Code: `code`, Block: ```language\ncode```\nLinks: [text](url), Spoiler: ||text||\nKeep messages under 2000 characters. Use code blocks for code.";
 export declare function createDiscordAdapters(event: DiscordEvent, bot: DiscordBot): {
     message: ChatMessage;
     responseCtx: ChatResponseContext;

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EAEnB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEzD,eAAO,MAAM,wBAAwB,uNAG0B,CAAC;AAsBhE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,UAAU,GACd;IACD,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;CACxB,CAuPA","sourcesContent":["import type {\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/policy.js\";\nimport { createChatResponseErrorReporter, formatToolArgs, splitText } from \"../shared.js\";\nimport type { DiscordBot, DiscordEvent } from \"./bot.js\";\n\nexport const DISCORD_FORMATTING_GUIDE = `## Discord Formatting (Markdown)\nBold: **text**, Italic: *text*, Code: \\`code\\`, Block: \\`\\`\\`language\\ncode\\`\\`\\`\nLinks: [text](url), Spoiler: ||text||\nKeep messages under 2000 characters. Use code blocks for code.`;\n\n// Discord hard limit is 2000 chars; 1900 leaves headroom for working indicator.\nconst MAX_LENGTH = 1900;\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\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  let text = `**${result.isError ? \"Error\" : \"Done\"} ${result.toolName}**`;\n  if (result.label) text += `: ${result.label}`;\n  text += ` (${duration}s)\\n`;\n  if (argsFormatted) text += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n  text += `**Result:**\\n\\`\\`\\`\\n${result.result}\\n\\`\\`\\``;\n  return text;\n}\n\nexport function createDiscordAdapters(\n  event: DiscordEvent,\n  bot: DiscordBot,\n): {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n} {\n  let messageId: string | null = null;\n  let accumulatedText = \"\";\n  let isWorking = true;\n  const workingIndicator = \" ...\";\n  let updatePromise = Promise.resolve();\n  let typingInterval: ReturnType<typeof setInterval> | null = null;\n  let typingFailureWarned = false;\n\n  function stopTyping(): void {\n    if (typingInterval !== null) {\n      clearInterval(typingInterval);\n      typingInterval = null;\n    }\n  }\n\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: ChatMessage = {\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: PlatformInfo = {\n    name: \"discord\",\n    formattingGuide: DISCORD_FORMATTING_GUIDE,\n    channels: bot.getAllChannels(),\n    users: bot.getAllUsers(),\n    diagnostics: {\n      showUsageSummary: false,\n    },\n  };\n\n  async function postDiagnosticMessage(text: string): Promise<string> {\n    stopTyping();\n    if (threadTargetId) {\n      return bot.postInThread(channelId, threadTargetId, text);\n    }\n    if (replyTargetId) {\n      return bot.postReply(channelId, replyTargetId, text);\n    }\n    if (messageId !== null) {\n      return bot.postReply(channelId, messageId, text);\n    }\n    return bot.postMessage(channelId, text);\n  }\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"discord\",\n    conversationId,\n    channelId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: messageId,\n    threadTs: threadTargetId,\n    replyTargetId,\n    conversationKind: message.conversationKind,\n  }));\n\n  const responseCtx: ChatResponseContext = {\n    respond: async (text: string) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${text}` : text;\n          const [displayText, ...extraParts] = splitText(\n            isWorking ? accumulatedText + workingIndicator : accumulatedText,\n            MAX_LENGTH,\n            formatDiscordContinuation,\n          );\n\n          if (messageId !== null) {\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          } else {\n            stopTyping();\n            if (threadTargetId) {\n              messageId = await bot.postInThread(channelId, threadTargetId, displayText);\n            } else if (replyTargetId) {\n              messageId = await bot.postReply(channelId, replyTargetId, displayText);\n            } else {\n              messageId = await bot.postMessage(channelId, displayText);\n            }\n          }\n          for (const part of extraParts) {\n            await postDiagnosticMessage(part);\n          }\n\n          if (messageId !== null) {\n            bot.logBotResponse(channelId, text, messageId);\n          }\n        } catch (err) {\n          log.logWarning(\"Discord respond error\", err instanceof Error ? err.message : String(err));\n          reportResponseError(err, \"respond\", {\n            phase: messageId ? \"update\" : \"initial_post\",\n            textLength: text.length,\n            accumulatedLength: accumulatedText.length,\n          });\n        }\n      });\n      await updatePromise;\n    },\n\n    replaceResponse: async (text: string) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          accumulatedText = text;\n          const [displayText, ...extraParts] = splitText(\n            accumulatedText,\n            MAX_LENGTH,\n            formatDiscordContinuation,\n          );\n\n          if (messageId !== null) {\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          } else {\n            stopTyping();\n            if (threadTargetId) {\n              messageId = await bot.postInThread(channelId, threadTargetId, displayText);\n            } else if (replyTargetId) {\n              messageId = await bot.postReply(channelId, replyTargetId, displayText);\n            } else {\n              messageId = await bot.postMessage(channelId, displayText);\n            }\n          }\n          for (const part of extraParts) {\n            await postDiagnosticMessage(part);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord replaceResponse error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"replace_response\", {\n            textLength: text.length,\n            hadExistingResponse: Boolean(messageId),\n          });\n        }\n      });\n      await updatePromise;\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          const prefix = options?.style === \"error\" ? \"*Error:* \" : \"\";\n          for (const part of splitText(`${prefix}${text}`, MAX_LENGTH, formatDiscordContinuation)) {\n            await postDiagnosticMessage(part);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord respondDiagnostic error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"respond_diagnostic\", {\n            textLength: text.length,\n            style: options?.style,\n          });\n        }\n      });\n      await updatePromise;\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responseCtx.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          \"Discord 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 8s (Discord clears indicator after ~10s)\n        bot.sendTyping(channelId).catch(onTypingError);\n        typingInterval = setInterval(() => {\n          bot.sendTyping(channelId).catch(onTypingError);\n        }, 8000);\n      } else if (!isTyping) {\n        stopTyping();\n      }\n    },\n\n    setWorking: async (working: boolean) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          isWorking = working;\n          if (!working) stopTyping();\n          if (messageId !== null) {\n            const [displayText] = splitText(\n              isWorking ? accumulatedText + workingIndicator : accumulatedText,\n              MAX_LENGTH,\n              formatDiscordContinuation,\n            );\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord setWorking error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"set_working\", { working });\n        }\n      });\n      await updatePromise;\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      await bot.uploadFile(channelId, filePath, title);\n    },\n\n    deleteResponse: async () => {\n      updatePromise = updatePromise.then(async () => {\n        stopTyping();\n        if (messageId !== null) {\n          try {\n            await bot.deleteMessageRaw(channelId, messageId);\n          } catch {\n            // Ignore errors\n          }\n          messageId = null;\n        }\n      });\n      await updatePromise;\n    },\n  };\n\n  return { message, responseCtx, platform };\n}\n"]}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EAEnB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAS1B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA2BzD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,UAAU,GACd;IACD,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;CACxB,CA6OA","sourcesContent":["import type {\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/policy.js\";\nimport {\n  createChatResponseErrorReporter,\n  formatToolArgs,\n  splitText,\n  type ChatResponseErrorOperation,\n} from \"../shared.js\";\nimport type { DiscordBot, DiscordEvent } from \"./bot.js\";\n\nconst DISCORD_FORMATTING_GUIDE = `## Discord Formatting (Markdown)\nBold: **text**, Italic: *text*, Code: \\`code\\`, Block: \\`\\`\\`language\\ncode\\`\\`\\`\nLinks: [text](url), Spoiler: ||text||\nKeep messages under 2000 characters. Use code blocks for code.`;\n\n// Discord hard limit is 2000 chars; 1900 leaves headroom for working indicator.\nconst MAX_LENGTH = 1900;\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\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  let text = `**${result.isError ? \"Error\" : \"Done\"} ${result.toolName}**`;\n  if (result.label) text += `: ${result.label}`;\n  text += ` (${duration}s)\\n`;\n  if (argsFormatted) text += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n  text += `**Result:**\\n\\`\\`\\`\\n${result.result}\\n\\`\\`\\``;\n  return text;\n}\n\nexport function createDiscordAdapters(\n  event: DiscordEvent,\n  bot: DiscordBot,\n): {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n} {\n  let messageId: string | null = null;\n  let accumulatedText = \"\";\n  let isWorking = true;\n  const workingIndicator = \" ...\";\n  let updatePromise = Promise.resolve();\n  let typingInterval: ReturnType<typeof setInterval> | null = null;\n  let typingFailureWarned = false;\n\n  function stopTyping(): void {\n    if (typingInterval !== null) {\n      clearInterval(typingInterval);\n      typingInterval = null;\n    }\n  }\n\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: ChatMessage = {\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: PlatformInfo = {\n    name: \"discord\",\n    formattingGuide: DISCORD_FORMATTING_GUIDE,\n    channels: bot.getAllChannels(),\n    users: bot.getAllUsers(),\n    diagnostics: {\n      showUsageSummary: false,\n    },\n  };\n\n  async function postDiagnosticMessage(text: string): Promise<string> {\n    stopTyping();\n    if (threadTargetId) {\n      return bot.postInThread(channelId, threadTargetId, text);\n    }\n    if (replyTargetId) {\n      return bot.postReply(channelId, replyTargetId, text);\n    }\n    if (messageId !== null) {\n      return bot.postReply(channelId, messageId, text);\n    }\n    return bot.postMessage(channelId, text);\n  }\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"discord\",\n    conversationId,\n    channelId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: messageId,\n    threadTs: threadTargetId,\n    replyTargetId,\n    conversationKind: message.conversationKind,\n  }));\n\n  async function postOrUpdateResponse(displayText: string): Promise<void> {\n    if (messageId !== null) {\n      await bot.updateMessageRaw(channelId, messageId, displayText);\n      return;\n    }\n    stopTyping();\n    if (threadTargetId) {\n      messageId = await bot.postInThread(channelId, threadTargetId, displayText);\n    } else if (replyTargetId) {\n      messageId = await bot.postReply(channelId, replyTargetId, displayText);\n    } else {\n      messageId = await bot.postMessage(channelId, displayText);\n    }\n  }\n\n  async function postSplitResponse(text: string): Promise<void> {\n    const [displayText, ...extraParts] = splitText(text, MAX_LENGTH, formatDiscordContinuation);\n    await postOrUpdateResponse(displayText);\n    for (const part of extraParts) {\n      await postDiagnosticMessage(part);\n    }\n  }\n\n  async function queueDiscordResponse(\n    label: string,\n    operation: ChatResponseErrorOperation,\n    work: () => Promise<void>,\n    report: (err: unknown) => Record<string, unknown>,\n  ): Promise<void> {\n    updatePromise = updatePromise.then(async () => {\n      try {\n        await work();\n      } catch (err) {\n        log.logWarning(`Discord ${label} error`, err instanceof Error ? err.message : String(err));\n        reportResponseError(err, operation, report(err));\n      }\n    });\n    await updatePromise;\n  }\n\n  const responseCtx: ChatResponseContext = {\n    respond: async (text: string) => {\n      await queueDiscordResponse(\n        \"respond\",\n        \"respond\",\n        async () => {\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${text}` : text;\n          await postSplitResponse(isWorking ? accumulatedText + workingIndicator : accumulatedText);\n          if (messageId !== null) {\n            bot.logBotResponse(channelId, text, messageId);\n          }\n        },\n        () => ({\n          phase: messageId ? \"update\" : \"initial_post\",\n          textLength: text.length,\n          accumulatedLength: accumulatedText.length,\n        }),\n      );\n    },\n\n    replaceResponse: async (text: string) => {\n      await queueDiscordResponse(\n        \"replaceResponse\",\n        \"replace_response\",\n        async () => {\n          accumulatedText = text;\n          await postSplitResponse(accumulatedText);\n        },\n        () => ({\n          textLength: text.length,\n          hadExistingResponse: Boolean(messageId),\n        }),\n      );\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      await queueDiscordResponse(\n        \"respondDiagnostic\",\n        \"respond_diagnostic\",\n        async () => {\n          const prefix = options?.style === \"error\" ? \"*Error:* \" : \"\";\n          for (const part of splitText(`${prefix}${text}`, MAX_LENGTH, formatDiscordContinuation)) {\n            await postDiagnosticMessage(part);\n          }\n        },\n        () => ({\n          textLength: text.length,\n          style: options?.style,\n        }),\n      );\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responseCtx.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          \"Discord 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 8s (Discord clears indicator after ~10s)\n        bot.sendTyping(channelId).catch(onTypingError);\n        typingInterval = setInterval(() => {\n          bot.sendTyping(channelId).catch(onTypingError);\n        }, 8000);\n      } else if (!isTyping) {\n        stopTyping();\n      }\n    },\n\n    setWorking: async (working: boolean) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          isWorking = working;\n          if (!working) stopTyping();\n          if (messageId !== null) {\n            const [displayText] = splitText(\n              isWorking ? accumulatedText + workingIndicator : accumulatedText,\n              MAX_LENGTH,\n              formatDiscordContinuation,\n            );\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord setWorking error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"set_working\", { working });\n        }\n      });\n      await updatePromise;\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      await bot.uploadFile(channelId, filePath, title);\n    },\n\n    deleteResponse: async () => {\n      updatePromise = updatePromise.then(async () => {\n        stopTyping();\n        if (messageId !== null) {\n          try {\n            await bot.deleteMessageRaw(channelId, messageId);\n          } catch {\n            // Ignore errors\n          }\n          messageId = null;\n        }\n      });\n      await updatePromise;\n    },\n  };\n\n  return { message, responseCtx, platform };\n}\n"]}

package/dist/adapters/discord/context.js

@@ -1,7 +1,7 @@
 import * as log from "../../log.js";
 import { resolveChatSessionKey } from "../../sessions/policy.js";
-import { createChatResponseErrorReporter, formatToolArgs, splitText } from "../shared.js";
-export const DISCORD_FORMATTING_GUIDE = `## Discord Formatting (Markdown)
+import { createChatResponseErrorReporter, formatToolArgs, splitText, } from "../shared.js";
+const DISCORD_FORMATTING_GUIDE = `## Discord Formatting (Markdown)
 Bold: **text**, Italic: *text*, Code: \`code\`, Block: \`\`\`language\ncode\`\`\`
 Links: [text](url), Spoiler: ||text||
 Keep messages under 2000 characters. Use code blocks for code.`;
@@ -91,96 +91,74 @@ export function createDiscordAdapters(event, bot) {
         replyTargetId,
         conversationKind: message.conversationKind,
     }));
+    async function postOrUpdateResponse(displayText) {
+        if (messageId !== null) {
+            await bot.updateMessageRaw(channelId, messageId, displayText);
+            return;
+        }
+        stopTyping();
+        if (threadTargetId) {
+            messageId = await bot.postInThread(channelId, threadTargetId, displayText);
+        }
+        else if (replyTargetId) {
+            messageId = await bot.postReply(channelId, replyTargetId, displayText);
+        }
+        else {
+            messageId = await bot.postMessage(channelId, displayText);
+        }
+    }
+    async function postSplitResponse(text) {
+        const [displayText, ...extraParts] = splitText(text, MAX_LENGTH, formatDiscordContinuation);
+        await postOrUpdateResponse(displayText);
+        for (const part of extraParts) {
+            await postDiagnosticMessage(part);
+        }
+    }
+    async function queueDiscordResponse(label, operation, work, report) {
+        updatePromise = updatePromise.then(async () => {
+            try {
+                await work();
+            }
+            catch (err) {
+                log.logWarning(`Discord ${label} error`, err instanceof Error ? err.message : String(err));
+                reportResponseError(err, operation, report(err));
+            }
+        });
+        await updatePromise;
+    }
     const responseCtx = {
         respond: async (text) => {
-            updatePromise = updatePromise.then(async () => {
-                try {
-                    accumulatedText = accumulatedText ? `${accumulatedText}\n${text}` : text;
-                    const [displayText, ...extraParts] = splitText(isWorking ? accumulatedText + workingIndicator : accumulatedText, MAX_LENGTH, formatDiscordContinuation);
-                    if (messageId !== null) {
-                        await bot.updateMessageRaw(channelId, messageId, displayText);
-                    }
-                    else {
-                        stopTyping();
-                        if (threadTargetId) {
-                            messageId = await bot.postInThread(channelId, threadTargetId, displayText);
-                        }
-                        else if (replyTargetId) {
-                            messageId = await bot.postReply(channelId, replyTargetId, displayText);
-                        }
-                        else {
-                            messageId = await bot.postMessage(channelId, displayText);
-                        }
-                    }
-                    for (const part of extraParts) {
-                        await postDiagnosticMessage(part);
-                    }
-                    if (messageId !== null) {
-                        bot.logBotResponse(channelId, text, messageId);
-                    }
-                }
-                catch (err) {
-                    log.logWarning("Discord respond error", err instanceof Error ? err.message : String(err));
-                    reportResponseError(err, "respond", {
-                        phase: messageId ? "update" : "initial_post",
-                        textLength: text.length,
-                        accumulatedLength: accumulatedText.length,
-                    });
+            await queueDiscordResponse("respond", "respond", async () => {
+                accumulatedText = accumulatedText ? `${accumulatedText}\n${text}` : text;
+                await postSplitResponse(isWorking ? accumulatedText + workingIndicator : accumulatedText);
+                if (messageId !== null) {
+                    bot.logBotResponse(channelId, text, messageId);
                 }
-            });
-            await updatePromise;
+            }, () => ({
+                phase: messageId ? "update" : "initial_post",
+                textLength: text.length,
+                accumulatedLength: accumulatedText.length,
+            }));
         },
         replaceResponse: async (text) => {
-            updatePromise = updatePromise.then(async () => {
-                try {
-                    accumulatedText = text;
-                    const [displayText, ...extraParts] = splitText(accumulatedText, MAX_LENGTH, formatDiscordContinuation);
-                    if (messageId !== null) {
-                        await bot.updateMessageRaw(channelId, messageId, displayText);
-                    }
-                    else {
-                        stopTyping();
-                        if (threadTargetId) {
-                            messageId = await bot.postInThread(channelId, threadTargetId, displayText);
-                        }
-                        else if (replyTargetId) {
-                            messageId = await bot.postReply(channelId, replyTargetId, displayText);
-                        }
-                        else {
-                            messageId = await bot.postMessage(channelId, displayText);
-                        }
-                    }
-                    for (const part of extraParts) {
-                        await postDiagnosticMessage(part);
-                    }
-                }
-                catch (err) {
-                    log.logWarning("Discord replaceResponse error", err instanceof Error ? err.message : String(err));
-                    reportResponseError(err, "replace_response", {
-                        textLength: text.length,
-                        hadExistingResponse: Boolean(messageId),
-                    });
-                }
-            });
-            await updatePromise;
+            await queueDiscordResponse("replaceResponse", "replace_response", async () => {
+                accumulatedText = text;
+                await postSplitResponse(accumulatedText);
+            }, () => ({
+                textLength: text.length,
+                hadExistingResponse: Boolean(messageId),
+            }));
         },
         respondDiagnostic: async (text, options) => {
-            updatePromise = updatePromise.then(async () => {
-                try {
-                    const prefix = options?.style === "error" ? "*Error:* " : "";
-                    for (const part of splitText(`${prefix}${text}`, MAX_LENGTH, formatDiscordContinuation)) {
-                        await postDiagnosticMessage(part);
-                    }
-                }
-                catch (err) {
-                    log.logWarning("Discord respondDiagnostic error", err instanceof Error ? err.message : String(err));
-                    reportResponseError(err, "respond_diagnostic", {
-                        textLength: text.length,
-                        style: options?.style,
-                    });
+            await queueDiscordResponse("respondDiagnostic", "respond_diagnostic", async () => {
+                const prefix = options?.style === "error" ? "*Error:* " : "";
+                for (const part of splitText(`${prefix}${text}`, MAX_LENGTH, formatDiscordContinuation)) {
+                    await postDiagnosticMessage(part);
                 }
-            });
-            await updatePromise;
+            }, () => ({
+                textLength: text.length,
+                style: options?.style,
+            }));
         },
         respondToolResult: async (result) => {
             await responseCtx.respondDiagnostic(formatToolResult(result));

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/discord/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/policy.js\";\nimport { createChatResponseErrorReporter, formatToolArgs, splitText } from \"../shared.js\";\nimport type { DiscordBot, DiscordEvent } from \"./bot.js\";\n\nexport const DISCORD_FORMATTING_GUIDE = `## Discord Formatting (Markdown)\nBold: **text**, Italic: *text*, Code: \\`code\\`, Block: \\`\\`\\`language\\ncode\\`\\`\\`\nLinks: [text](url), Spoiler: ||text||\nKeep messages under 2000 characters. Use code blocks for code.`;\n\n// Discord hard limit is 2000 chars; 1900 leaves headroom for working indicator.\nconst MAX_LENGTH = 1900;\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\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  let text = `**${result.isError ? \"Error\" : \"Done\"} ${result.toolName}**`;\n  if (result.label) text += `: ${result.label}`;\n  text += ` (${duration}s)\\n`;\n  if (argsFormatted) text += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n  text += `**Result:**\\n\\`\\`\\`\\n${result.result}\\n\\`\\`\\``;\n  return text;\n}\n\nexport function createDiscordAdapters(\n  event: DiscordEvent,\n  bot: DiscordBot,\n): {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n} {\n  let messageId: string | null = null;\n  let accumulatedText = \"\";\n  let isWorking = true;\n  const workingIndicator = \" ...\";\n  let updatePromise = Promise.resolve();\n  let typingInterval: ReturnType<typeof setInterval> | null = null;\n  let typingFailureWarned = false;\n\n  function stopTyping(): void {\n    if (typingInterval !== null) {\n      clearInterval(typingInterval);\n      typingInterval = null;\n    }\n  }\n\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: ChatMessage = {\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: PlatformInfo = {\n    name: \"discord\",\n    formattingGuide: DISCORD_FORMATTING_GUIDE,\n    channels: bot.getAllChannels(),\n    users: bot.getAllUsers(),\n    diagnostics: {\n      showUsageSummary: false,\n    },\n  };\n\n  async function postDiagnosticMessage(text: string): Promise<string> {\n    stopTyping();\n    if (threadTargetId) {\n      return bot.postInThread(channelId, threadTargetId, text);\n    }\n    if (replyTargetId) {\n      return bot.postReply(channelId, replyTargetId, text);\n    }\n    if (messageId !== null) {\n      return bot.postReply(channelId, messageId, text);\n    }\n    return bot.postMessage(channelId, text);\n  }\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"discord\",\n    conversationId,\n    channelId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: messageId,\n    threadTs: threadTargetId,\n    replyTargetId,\n    conversationKind: message.conversationKind,\n  }));\n\n  const responseCtx: ChatResponseContext = {\n    respond: async (text: string) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${text}` : text;\n          const [displayText, ...extraParts] = splitText(\n            isWorking ? accumulatedText + workingIndicator : accumulatedText,\n            MAX_LENGTH,\n            formatDiscordContinuation,\n          );\n\n          if (messageId !== null) {\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          } else {\n            stopTyping();\n            if (threadTargetId) {\n              messageId = await bot.postInThread(channelId, threadTargetId, displayText);\n            } else if (replyTargetId) {\n              messageId = await bot.postReply(channelId, replyTargetId, displayText);\n            } else {\n              messageId = await bot.postMessage(channelId, displayText);\n            }\n          }\n          for (const part of extraParts) {\n            await postDiagnosticMessage(part);\n          }\n\n          if (messageId !== null) {\n            bot.logBotResponse(channelId, text, messageId);\n          }\n        } catch (err) {\n          log.logWarning(\"Discord respond error\", err instanceof Error ? err.message : String(err));\n          reportResponseError(err, \"respond\", {\n            phase: messageId ? \"update\" : \"initial_post\",\n            textLength: text.length,\n            accumulatedLength: accumulatedText.length,\n          });\n        }\n      });\n      await updatePromise;\n    },\n\n    replaceResponse: async (text: string) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          accumulatedText = text;\n          const [displayText, ...extraParts] = splitText(\n            accumulatedText,\n            MAX_LENGTH,\n            formatDiscordContinuation,\n          );\n\n          if (messageId !== null) {\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          } else {\n            stopTyping();\n            if (threadTargetId) {\n              messageId = await bot.postInThread(channelId, threadTargetId, displayText);\n            } else if (replyTargetId) {\n              messageId = await bot.postReply(channelId, replyTargetId, displayText);\n            } else {\n              messageId = await bot.postMessage(channelId, displayText);\n            }\n          }\n          for (const part of extraParts) {\n            await postDiagnosticMessage(part);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord replaceResponse error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"replace_response\", {\n            textLength: text.length,\n            hadExistingResponse: Boolean(messageId),\n          });\n        }\n      });\n      await updatePromise;\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          const prefix = options?.style === \"error\" ? \"*Error:* \" : \"\";\n          for (const part of splitText(`${prefix}${text}`, MAX_LENGTH, formatDiscordContinuation)) {\n            await postDiagnosticMessage(part);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord respondDiagnostic error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"respond_diagnostic\", {\n            textLength: text.length,\n            style: options?.style,\n          });\n        }\n      });\n      await updatePromise;\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responseCtx.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          \"Discord 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 8s (Discord clears indicator after ~10s)\n        bot.sendTyping(channelId).catch(onTypingError);\n        typingInterval = setInterval(() => {\n          bot.sendTyping(channelId).catch(onTypingError);\n        }, 8000);\n      } else if (!isTyping) {\n        stopTyping();\n      }\n    },\n\n    setWorking: async (working: boolean) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          isWorking = working;\n          if (!working) stopTyping();\n          if (messageId !== null) {\n            const [displayText] = splitText(\n              isWorking ? accumulatedText + workingIndicator : accumulatedText,\n              MAX_LENGTH,\n              formatDiscordContinuation,\n            );\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord setWorking error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"set_working\", { working });\n        }\n      });\n      await updatePromise;\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      await bot.uploadFile(channelId, filePath, title);\n    },\n\n    deleteResponse: async () => {\n      updatePromise = updatePromise.then(async () => {\n        stopTyping();\n        if (messageId !== null) {\n          try {\n            await bot.deleteMessageRaw(channelId, messageId);\n          } catch {\n            // Ignore errors\n          }\n          messageId = null;\n        }\n      });\n      await updatePromise;\n    },\n  };\n\n  return { message, responseCtx, platform };\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/discord/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/policy.js\";\nimport {\n  createChatResponseErrorReporter,\n  formatToolArgs,\n  splitText,\n  type ChatResponseErrorOperation,\n} from \"../shared.js\";\nimport type { DiscordBot, DiscordEvent } from \"./bot.js\";\n\nconst DISCORD_FORMATTING_GUIDE = `## Discord Formatting (Markdown)\nBold: **text**, Italic: *text*, Code: \\`code\\`, Block: \\`\\`\\`language\\ncode\\`\\`\\`\nLinks: [text](url), Spoiler: ||text||\nKeep messages under 2000 characters. Use code blocks for code.`;\n\n// Discord hard limit is 2000 chars; 1900 leaves headroom for working indicator.\nconst MAX_LENGTH = 1900;\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\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  let text = `**${result.isError ? \"Error\" : \"Done\"} ${result.toolName}**`;\n  if (result.label) text += `: ${result.label}`;\n  text += ` (${duration}s)\\n`;\n  if (argsFormatted) text += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n  text += `**Result:**\\n\\`\\`\\`\\n${result.result}\\n\\`\\`\\``;\n  return text;\n}\n\nexport function createDiscordAdapters(\n  event: DiscordEvent,\n  bot: DiscordBot,\n): {\n  message: ChatMessage;\n  responseCtx: ChatResponseContext;\n  platform: PlatformInfo;\n} {\n  let messageId: string | null = null;\n  let accumulatedText = \"\";\n  let isWorking = true;\n  const workingIndicator = \" ...\";\n  let updatePromise = Promise.resolve();\n  let typingInterval: ReturnType<typeof setInterval> | null = null;\n  let typingFailureWarned = false;\n\n  function stopTyping(): void {\n    if (typingInterval !== null) {\n      clearInterval(typingInterval);\n      typingInterval = null;\n    }\n  }\n\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: ChatMessage = {\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: PlatformInfo = {\n    name: \"discord\",\n    formattingGuide: DISCORD_FORMATTING_GUIDE,\n    channels: bot.getAllChannels(),\n    users: bot.getAllUsers(),\n    diagnostics: {\n      showUsageSummary: false,\n    },\n  };\n\n  async function postDiagnosticMessage(text: string): Promise<string> {\n    stopTyping();\n    if (threadTargetId) {\n      return bot.postInThread(channelId, threadTargetId, text);\n    }\n    if (replyTargetId) {\n      return bot.postReply(channelId, replyTargetId, text);\n    }\n    if (messageId !== null) {\n      return bot.postReply(channelId, messageId, text);\n    }\n    return bot.postMessage(channelId, text);\n  }\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"discord\",\n    conversationId,\n    channelId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: messageId,\n    threadTs: threadTargetId,\n    replyTargetId,\n    conversationKind: message.conversationKind,\n  }));\n\n  async function postOrUpdateResponse(displayText: string): Promise<void> {\n    if (messageId !== null) {\n      await bot.updateMessageRaw(channelId, messageId, displayText);\n      return;\n    }\n    stopTyping();\n    if (threadTargetId) {\n      messageId = await bot.postInThread(channelId, threadTargetId, displayText);\n    } else if (replyTargetId) {\n      messageId = await bot.postReply(channelId, replyTargetId, displayText);\n    } else {\n      messageId = await bot.postMessage(channelId, displayText);\n    }\n  }\n\n  async function postSplitResponse(text: string): Promise<void> {\n    const [displayText, ...extraParts] = splitText(text, MAX_LENGTH, formatDiscordContinuation);\n    await postOrUpdateResponse(displayText);\n    for (const part of extraParts) {\n      await postDiagnosticMessage(part);\n    }\n  }\n\n  async function queueDiscordResponse(\n    label: string,\n    operation: ChatResponseErrorOperation,\n    work: () => Promise<void>,\n    report: (err: unknown) => Record<string, unknown>,\n  ): Promise<void> {\n    updatePromise = updatePromise.then(async () => {\n      try {\n        await work();\n      } catch (err) {\n        log.logWarning(`Discord ${label} error`, err instanceof Error ? err.message : String(err));\n        reportResponseError(err, operation, report(err));\n      }\n    });\n    await updatePromise;\n  }\n\n  const responseCtx: ChatResponseContext = {\n    respond: async (text: string) => {\n      await queueDiscordResponse(\n        \"respond\",\n        \"respond\",\n        async () => {\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${text}` : text;\n          await postSplitResponse(isWorking ? accumulatedText + workingIndicator : accumulatedText);\n          if (messageId !== null) {\n            bot.logBotResponse(channelId, text, messageId);\n          }\n        },\n        () => ({\n          phase: messageId ? \"update\" : \"initial_post\",\n          textLength: text.length,\n          accumulatedLength: accumulatedText.length,\n        }),\n      );\n    },\n\n    replaceResponse: async (text: string) => {\n      await queueDiscordResponse(\n        \"replaceResponse\",\n        \"replace_response\",\n        async () => {\n          accumulatedText = text;\n          await postSplitResponse(accumulatedText);\n        },\n        () => ({\n          textLength: text.length,\n          hadExistingResponse: Boolean(messageId),\n        }),\n      );\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      await queueDiscordResponse(\n        \"respondDiagnostic\",\n        \"respond_diagnostic\",\n        async () => {\n          const prefix = options?.style === \"error\" ? \"*Error:* \" : \"\";\n          for (const part of splitText(`${prefix}${text}`, MAX_LENGTH, formatDiscordContinuation)) {\n            await postDiagnosticMessage(part);\n          }\n        },\n        () => ({\n          textLength: text.length,\n          style: options?.style,\n        }),\n      );\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responseCtx.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          \"Discord 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 8s (Discord clears indicator after ~10s)\n        bot.sendTyping(channelId).catch(onTypingError);\n        typingInterval = setInterval(() => {\n          bot.sendTyping(channelId).catch(onTypingError);\n        }, 8000);\n      } else if (!isTyping) {\n        stopTyping();\n      }\n    },\n\n    setWorking: async (working: boolean) => {\n      updatePromise = updatePromise.then(async () => {\n        try {\n          isWorking = working;\n          if (!working) stopTyping();\n          if (messageId !== null) {\n            const [displayText] = splitText(\n              isWorking ? accumulatedText + workingIndicator : accumulatedText,\n              MAX_LENGTH,\n              formatDiscordContinuation,\n            );\n            await bot.updateMessageRaw(channelId, messageId, displayText);\n          }\n        } catch (err) {\n          log.logWarning(\n            \"Discord setWorking error\",\n            err instanceof Error ? err.message : String(err),\n          );\n          reportResponseError(err, \"set_working\", { working });\n        }\n      });\n      await updatePromise;\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      await bot.uploadFile(channelId, filePath, title);\n    },\n\n    deleteResponse: async () => {\n      updatePromise = updatePromise.then(async () => {\n        stopTyping();\n        if (messageId !== null) {\n          try {\n            await bot.deleteMessageRaw(channelId, messageId);\n          } catch {\n            // Ignore errors\n          }\n          messageId = null;\n        }\n      });\n      await updatePromise;\n    },\n  };\n\n  return { message, responseCtx, platform };\n}\n"]}

package/dist/adapters/shared.d.ts

@@ -26,7 +26,6 @@ export interface ChatResponseErrorContext {
 }
 export type ChatResponseErrorReporter = (err: unknown, operation: ChatResponseErrorOperation, extra?: Record<string, unknown>) => void;
 export declare function createChatResponseErrorReporter(resolve: () => Omit<ChatResponseErrorContext, "operation" | "extra">): ChatResponseErrorReporter;
-export declare function reportChatResponseError(err: unknown, context: ChatResponseErrorContext): void;
 export declare class ChannelQueue {
     private readonly name;
     private queue;
@@ -64,7 +63,7 @@ export declare function splitText(text: string, limit: number, formatContinuatio
  */
 export declare function appendChannelLog(workingDir: string, channel: string, entry: object): void;
 /** Convenience for appending the bot's own outbound message. */
-export declare function appendBotResponseLog(workingDir: string, channel: string, text: string, ts: string, threadTs?: string): void;
+export declare function appendBotResponseLog(workingDir: string, channel: string, text: string, ts: string, threadTs?: string, extraFields?: Record<string, unknown>): void;
 export interface ResolveStopTargetInput {
     handler: BotHandler;
     conversationId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helpers shared across platform adapters.\n *\n * The agent runner is platform-agnostic: it hands strings and structured tool\n * results to each adapter, which decides how to split, format, and route them.\n * The split/normalize logic itself doesn't differ across platforms — only the\n * markup wrappers — so it lives here once.\n */\n\nimport { appendFileSync } from \"fs\";\nimport { join } from \"path\";\nimport type { BotHandler } from \"../adapter.js\";\nimport { ensureDirExists } from \"../file-guards.js\";\nimport * as log from \"../log.js\";\nimport { reportUserFacingError } from \"../sentry.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 function createChatResponseErrorReporter(\n  resolve: () => Omit<ChatResponseErrorContext, \"operation\" | \"extra\">,\n): ChatResponseErrorReporter {\n  return (err, operation, extra) => {\n    reportChatResponseError(err, { ...resolve(), operation, extra });\n  };\n}\n\nexport function reportChatResponseError(err: unknown, context: ChatResponseErrorContext): void {\n  reportUserFacingError(err, {\n    domain: \"chat_platform\",\n    surface: \"chat_response\",\n    operation: context.operation,\n    severity: context.operation === \"set_working\" ? \"warning\" : \"error\",\n    platform: context.platform,\n    context: {\n      conversationId: context.conversationId,\n      channelId: context.channelId,\n      chatId: context.chatId,\n      messageId: context.messageId,\n      sessionKey: context.sessionKey,\n      responseMessageId: context.responseMessageId,\n      threadTs: context.threadTs,\n      replyTargetId: context.replyTargetId,\n      replyToId: context.replyToId,\n      conversationKind: context.conversationKind,\n      isThreaded: context.isThreaded,\n      ...context.extra,\n    },\n  });\n}\n\nexport class ChannelQueue {\n  private queue: Array<() => Promise<void>> = [];\n  private processing = false;\n\n  constructor(private readonly name: string = \"\") {}\n\n  enqueue(work: () => Promise<void>): void {\n    this.queue.push(work);\n    this.processNext();\n  }\n\n  size(): number {\n    return this.queue.length;\n  }\n\n  private async processNext(): Promise<void> {\n    if (this.processing || this.queue.length === 0) return;\n    this.processing = true;\n    const work = this.queue.shift()!;\n    try {\n      await work();\n    } catch (err) {\n      log.logWarning(\n        `${this.name ? this.name + \" \" : \"\"}queue error`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\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\n/**\n * Run `fn` and retry with exponential backoff when its error matches\n * `isRateLimited`. Other errors propagate immediately. Each platform supplies\n * its own predicate so we don't have to know every SDK's error shape here.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions): Promise<T> {\n  const maxAttempts = opts.maxAttempts ?? 3;\n  const baseDelayMs = opts.baseDelayMs ?? 1000;\n  let lastError: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      const isLastAttempt = attempt === maxAttempts - 1;\n      if (isLastAttempt || !opts.isRateLimited(lastError)) {\n        throw lastError;\n      }\n\n      const delay = baseDelayMs * Math.pow(2, attempt);\n      log.logWarning(\n        `Retrying after error in ${delay}ms (attempt ${attempt + 1}/${maxAttempts}): ${lastError.message}`,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Split `text` into chunks no larger than `limit`, appending a continuation\n * marker (e.g. `_(continued 1)_`) at the end of every part except the last.\n *\n * Each adapter passes its own `formatContinuation` so the marker uses the\n * platform's italic / emphasis convention.\n */\nexport function splitText(\n  text: string,\n  limit: number,\n  formatContinuation: (partNum: number) => string,\n): string[] {\n  if (text.length <= limit) return [text];\n  const parts: string[] = [];\n  let remaining = text;\n  let partNum = 1;\n  while (remaining.length > 0) {\n    const suffixReserve = formatContinuation(partNum).length + 8;\n    const chunkLimit = Math.max(1, limit - suffixReserve);\n    const chunk = remaining.slice(0, chunkLimit);\n    remaining = remaining.slice(chunkLimit);\n    const suffix = remaining.length > 0 ? `\\n${formatContinuation(partNum)}` : \"\";\n    parts.push(chunk + suffix);\n    partNum++;\n  }\n  return parts;\n}\n\n/**\n * Append a JSON-serializable entry to `${workingDir}/${channel}/log.jsonl`,\n * creating the directory on first use. This is the single write path every\n * adapter uses for human-readable message history.\n */\nexport function appendChannelLog(workingDir: string, channel: string, entry: object): void {\n  const dir = join(workingDir, channel);\n  ensureDirExists(dir);\n  appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n}\n\n/** Convenience for appending the bot's own outbound message. */\nexport function appendBotResponseLog(\n  workingDir: string,\n  channel: string,\n  text: string,\n  ts: string,\n  threadTs?: string,\n): void {\n  appendChannelLog(workingDir, channel, {\n    date: new Date().toISOString(),\n    ts,\n    ...(threadTs ? { threadTs } : {}),\n    user: \"bot\",\n    text,\n    attachments: [],\n    isBot: true,\n  });\n}\n\nexport interface ResolveStopTargetInput {\n  handler: BotHandler;\n  conversationId: string;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\n/**\n * Pick which session key a `/stop` should target without applying any\n * platform-specific fallback policy. Order:\n *   1. The provided sessionKey, if running.\n *   2. The bare conversationId, if running.\n */\nexport function resolveStopTarget(input: ResolveStopTargetInput): string | null {\n  const { handler, conversationId, sessionKey } = input;\n\n  if (sessionKey && handler.isRunning(sessionKey)) return sessionKey;\n  if (handler.isRunning(conversationId)) return conversationId;\n  return null;\n}\n\n/**\n * Return the single running scoped session for this conversation, or null when\n * there are zero or multiple matches.\n */\nexport function resolveOnlyScopedStopTarget(\n  handler: BotHandler,\n  conversationId: string,\n): string | null {\n  const runningScopes = handler\n    .getRunningSessions()\n    .map((s) => s.sessionKey)\n    .filter((k) => k.startsWith(`${conversationId}:`));\n\n  return runningScopes.length === 1 ? runningScopes[0] : null;\n}\n\n/**\n * Render tool-call args for human display. Drops `label` (already in the\n * heading) and folds `path` + `offset`/`limit` into a single `path:start-end`\n * line. Pure data normalization with no platform-specific markup.\n */\nexport function formatToolArgs(args: Record<string, unknown> | undefined): string {\n  if (!args) return \"\";\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(args)) {\n    if (key === \"label\" || key === \"offset\" || key === \"limit\") continue;\n\n    if (key === \"path\" && typeof value === \"string\") {\n      const offset = args.offset as number | undefined;\n      const limit = args.limit as number | undefined;\n      lines.push(\n        offset !== undefined && limit !== undefined\n          ? `${value}:${offset}-${offset + limit}`\n          : value,\n      );\n      continue;\n    }\n\n    lines.push(typeof value === \"string\" ? value : JSON.stringify(value));\n  }\n\n  return lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helpers shared across platform adapters.\n *\n * The agent runner is platform-agnostic: it hands strings and structured tool\n * results to each adapter, which decides how to split, format, and route them.\n * The split/normalize logic itself doesn't differ across platforms — only the\n * markup wrappers — so it lives here once.\n */\n\nimport { appendFileSync } from \"fs\";\nimport { join } from \"path\";\nimport type { BotHandler } from \"../adapter.js\";\nimport { ensureDirExists } from \"../file-guards.js\";\nimport * as log from \"../log.js\";\nimport { reportUserFacingError } from \"../sentry.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 function createChatResponseErrorReporter(\n  resolve: () => Omit<ChatResponseErrorContext, \"operation\" | \"extra\">,\n): ChatResponseErrorReporter {\n  return (err, operation, extra) => {\n    reportChatResponseError(err, { ...resolve(), operation, extra });\n  };\n}\n\nfunction reportChatResponseError(err: unknown, context: ChatResponseErrorContext): void {\n  reportUserFacingError(err, {\n    domain: \"chat_platform\",\n    surface: \"chat_response\",\n    operation: context.operation,\n    severity: context.operation === \"set_working\" ? \"warning\" : \"error\",\n    platform: context.platform,\n    context: {\n      conversationId: context.conversationId,\n      channelId: context.channelId,\n      chatId: context.chatId,\n      messageId: context.messageId,\n      sessionKey: context.sessionKey,\n      responseMessageId: context.responseMessageId,\n      threadTs: context.threadTs,\n      replyTargetId: context.replyTargetId,\n      replyToId: context.replyToId,\n      conversationKind: context.conversationKind,\n      isThreaded: context.isThreaded,\n      ...context.extra,\n    },\n  });\n}\n\nexport class ChannelQueue {\n  private queue: Array<() => Promise<void>> = [];\n  private processing = false;\n\n  constructor(private readonly name: string = \"\") {}\n\n  enqueue(work: () => Promise<void>): void {\n    this.queue.push(work);\n    this.processNext();\n  }\n\n  size(): number {\n    return this.queue.length;\n  }\n\n  private async processNext(): Promise<void> {\n    if (this.processing || this.queue.length === 0) return;\n    this.processing = true;\n    const work = this.queue.shift()!;\n    try {\n      await work();\n    } catch (err) {\n      log.logWarning(\n        `${this.name ? this.name + \" \" : \"\"}queue error`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\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\n/**\n * Run `fn` and retry with exponential backoff when its error matches\n * `isRateLimited`. Other errors propagate immediately. Each platform supplies\n * its own predicate so we don't have to know every SDK's error shape here.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions): Promise<T> {\n  const maxAttempts = opts.maxAttempts ?? 3;\n  const baseDelayMs = opts.baseDelayMs ?? 1000;\n  let lastError: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      const isLastAttempt = attempt === maxAttempts - 1;\n      if (isLastAttempt || !opts.isRateLimited(lastError)) {\n        throw lastError;\n      }\n\n      const delay = baseDelayMs * Math.pow(2, attempt);\n      log.logWarning(\n        `Retrying after error in ${delay}ms (attempt ${attempt + 1}/${maxAttempts}): ${lastError.message}`,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Split `text` into chunks no larger than `limit`, appending a continuation\n * marker (e.g. `_(continued 1)_`) at the end of every part except the last.\n *\n * Each adapter passes its own `formatContinuation` so the marker uses the\n * platform's italic / emphasis convention.\n */\nexport function splitText(\n  text: string,\n  limit: number,\n  formatContinuation: (partNum: number) => string,\n): string[] {\n  if (text.length <= limit) return [text];\n  const parts: string[] = [];\n  let remaining = text;\n  let partNum = 1;\n  while (remaining.length > 0) {\n    const suffixReserve = formatContinuation(partNum).length + 8;\n    const chunkLimit = Math.max(1, limit - suffixReserve);\n    const chunk = remaining.slice(0, chunkLimit);\n    remaining = remaining.slice(chunkLimit);\n    const suffix = remaining.length > 0 ? `\\n${formatContinuation(partNum)}` : \"\";\n    parts.push(chunk + suffix);\n    partNum++;\n  }\n  return parts;\n}\n\n/**\n * Append a JSON-serializable entry to `${workingDir}/${channel}/log.jsonl`,\n * creating the directory on first use. This is the single write path every\n * adapter uses for human-readable message history.\n */\nexport function appendChannelLog(workingDir: string, channel: string, entry: object): void {\n  const dir = join(workingDir, channel);\n  ensureDirExists(dir);\n  appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n}\n\n/** Convenience for appending the bot's own outbound message. */\nexport function appendBotResponseLog(\n  workingDir: string,\n  channel: string,\n  text: string,\n  ts: string,\n  threadTs?: string,\n  extraFields: Record<string, unknown> = {},\n): void {\n  appendChannelLog(workingDir, channel, {\n    date: new Date().toISOString(),\n    ts,\n    ...(threadTs ? { threadTs } : {}),\n    user: \"bot\",\n    text,\n    attachments: [],\n    isBot: true,\n    ...extraFields,\n  });\n}\n\nexport interface ResolveStopTargetInput {\n  handler: BotHandler;\n  conversationId: string;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\n/**\n * Pick which session key a `/stop` should target without applying any\n * platform-specific fallback policy. Order:\n *   1. The provided sessionKey, if running.\n *   2. The bare conversationId, if running.\n */\nexport function resolveStopTarget(input: ResolveStopTargetInput): string | null {\n  const { handler, conversationId, sessionKey } = input;\n\n  if (sessionKey && handler.isRunning(sessionKey)) return sessionKey;\n  if (handler.isRunning(conversationId)) return conversationId;\n  return null;\n}\n\n/**\n * Return the single running scoped session for this conversation, or null when\n * there are zero or multiple matches.\n */\nexport function resolveOnlyScopedStopTarget(\n  handler: BotHandler,\n  conversationId: string,\n): string | null {\n  const runningScopes = handler\n    .getRunningSessions()\n    .map((s) => s.sessionKey)\n    .filter((k) => k.startsWith(`${conversationId}:`));\n\n  return runningScopes.length === 1 ? runningScopes[0] : null;\n}\n\n/**\n * Render tool-call args for human display. Drops `label` (already in the\n * heading) and folds `path` + `offset`/`limit` into a single `path:start-end`\n * line. Pure data normalization with no platform-specific markup.\n */\nexport function formatToolArgs(args: Record<string, unknown> | undefined): string {\n  if (!args) return \"\";\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(args)) {\n    if (key === \"label\" || key === \"offset\" || key === \"limit\") continue;\n\n    if (key === \"path\" && typeof value === \"string\") {\n      const offset = args.offset as number | undefined;\n      const limit = args.limit as number | undefined;\n      lines.push(\n        offset !== undefined && limit !== undefined\n          ? `${value}:${offset}-${offset + limit}`\n          : value,\n      );\n      continue;\n    }\n\n    lines.push(typeof value === \"string\" ? value : JSON.stringify(value));\n  }\n\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/adapters/shared.js

@@ -16,7 +16,7 @@ export function createChatResponseErrorReporter(resolve) {
         reportChatResponseError(err, { ...resolve(), operation, extra });
     };
 }
-export function reportChatResponseError(err, context) {
+function reportChatResponseError(err, context) {
     reportUserFacingError(err, {
         domain: "chat_platform",
         surface: "chat_response",
@@ -128,7 +128,7 @@ export function appendChannelLog(workingDir, channel, entry) {
     appendFileSync(join(dir, "log.jsonl"), `${JSON.stringify(entry)}\n`);
 }
 /** Convenience for appending the bot's own outbound message. */
-export function appendBotResponseLog(workingDir, channel, text, ts, threadTs) {
+export function appendBotResponseLog(workingDir, channel, text, ts, threadTs, extraFields = {}) {
     appendChannelLog(workingDir, channel, {
         date: new Date().toISOString(),
         ts,
@@ -137,6 +137,7 @@ export function appendBotResponseLog(workingDir, channel, text, ts, threadTs) {
         text,
         attachments: [],
         isBot: true,
+        ...extraFields,
     });
 }
 /**