@geminixiang/mama 0.2.0-beta.1 → 0.2.0-beta.10

package/dist/adapter.d.ts

@@ -1,6 +1,9 @@
+export type ConversationKind = "direct" | "shared";
+export type PlatformName = "slack" | "discord" | "telegram";
 export interface ChatMessage {
     id: string;
     sessionKey: string;
+    conversationKind: ConversationKind;
     userId: string;
     userName?: string;
     text: string;
@@ -10,12 +13,21 @@ export interface ChatMessage {
     }[];
     threadTs?: string;
 }
+export interface ChatToolResult {
+    toolName: string;
+    label?: string;
+    args?: Record<string, unknown>;
+    result: string;
+    isError: boolean;
+    durationMs: number;
+}
 export interface ChatResponseContext {
     respond(text: string): Promise<void>;
     replaceResponse(text: string): Promise<void>;
-    respondInThread(text: string, options?: {
-        style?: "muted";
+    respondDiagnostic(text: string, options?: {
+        style?: "muted" | "error";
     }): Promise<void>;
+    respondToolResult(result: ChatToolResult): Promise<void>;
     setTyping(isTyping: boolean): Promise<void>;
     setWorking(working: boolean): Promise<void>;
     uploadFile(filePath: string, title?: string): Promise<void>;
@@ -33,6 +45,9 @@ export interface PlatformInfo {
         userName: string;
         displayName: string;
     }[];
+    diagnostics?: {
+        showUsageSummary?: boolean;
+    };
 }
 export interface ChatAdapter {
     start(): Promise<void>;
@@ -44,8 +59,12 @@ export interface ChatAdapter {
  */
 export interface BotEvent {
     type: string;
-    /** Internal conversation identifier used by the shared runtime */
+    /** Platform-specific raw conversation/channel/chat identifier */
     conversationId: string;
+    /** Optional alternate conversation identity used for vault routing. */
+    vaultConversationId?: string;
+    /** Cross-platform conversation shape: direct message vs shared space */
+    conversationKind: ConversationKind;
     /** Message timestamp or ID as string */
     ts: string;
     /** Parent message ID for threaded replies (optional) */
@@ -59,7 +78,7 @@ export interface BotEvent {
         name: string;
         localPath: string;
     }[];
-    /** Platform-computed session key; overrides default conversation:thread_ts computation */
+    /** Platform-computed session key; overrides default conversationId:thread_ts computation */
     sessionKey?: string;
 }
 /**
@@ -68,10 +87,19 @@ export interface BotEvent {
  */
 export interface Bot {
     start(): Promise<void>;
-    postMessage(conversationId: string, text: string): Promise<string>;
-    updateMessage(conversationId: string, ts: string, text: string): Promise<void>;
+    postMessage(channel: string, text: string): Promise<string>;
+    updateMessage(channel: string, ts: string, text: string): Promise<void>;
     enqueueEvent(event: BotEvent): boolean;
     getPlatformInfo(): PlatformInfo;
+    /**
+     * Deliver a message visible only to the given user.
+     * Implementations may use ephemeral messages (Slack), DMs (Discord), or
+     * any other private channel. Absent on platforms with no private delivery.
+     */
+    postPrivate?(conversationId: string, userId: string, text: string): Promise<void>;
+    postPrivateDiagnostic?(conversationId: string, userId: string, text: string, options?: {
+        style?: "muted" | "error";
+    }): Promise<void>;
 }
 /** Pre-created platform adapters passed to the handler */
 export interface BotAdapters {
@@ -94,15 +122,11 @@ export interface RunningSession {
 export interface BotHandler {
     isRunning(sessionKey: string): boolean;
     getRunningSessions(): RunningSession[];
-    handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;
+    handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isSyntheticEvent?: boolean): Promise<void>;
     handleStop(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;
     /** Force stop a running session (bypass normal stop mechanism) */
     forceStop(sessionKey: string): void;
     /** Reset a session: abort if running, delete history, remove from cache */
-    handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;
-    /** Handle credential onboarding for a user login command. */
-    handleLogin(platform: string, platformUserId: string, conversationId: string, bot: Bot, commandText: string, isPrivateConversation: boolean): Promise<void>;
+    handleNewCommand(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;
 }
-/** @deprecated Use BotHandler */
-export type MomHandler = BotHandler;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,eAAe,IAAI,YAAY,CAAC;CACjC;AAMD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,eAAe,IAAI,YAAY,CAAC;CACjC;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,cAAc,EAAE,CAAC;IACvC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,kEAAkE;IAClE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,2EAA2E;IAC3E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,6DAA6D;IAC7D,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,OAAO,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC","sourcesContent":["export interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string, options?: { style?: \"muted\" }): 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}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n// ============================================================================\n// Generic cross-platform event and bot interfaces\n// ============================================================================\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Internal conversation identifier used by the shared runtime */\n  conversationId: string;\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 conversation: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(conversationId: string, text: string): Promise<string>;\n  updateMessage(conversationId: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\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, isEvent?: boolean): 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  handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Handle credential onboarding for a user login command. */\n  handleLogin(\n    platform: string,\n    platformUserId: string,\n    conversationId: string,\n    bot: Bot,\n    commandText: string,\n    isPrivateConversation: boolean,\n  ): Promise<void>;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\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 ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: 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// Generic cross-platform event and bot interfaces\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(\n    event: BotEvent,\n    bot: Bot,\n    adapters: BotAdapters,\n    isSyntheticEvent?: boolean,\n  ): 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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n  threadTs?: string;\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string, options?: { style?: \"muted\" }): 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}\n\nexport interface ChatAdapter {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getPlatformInfo(): PlatformInfo;\n}\n\n// ============================================================================\n// Generic cross-platform event and bot interfaces\n// ============================================================================\n\n/**\n * A platform-agnostic event (message/mention) that triggers the agent.\n */\nexport interface BotEvent {\n  type: string;\n  /** Internal conversation identifier used by the shared runtime */\n  conversationId: string;\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 conversation: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(conversationId: string, text: string): Promise<string>;\n  updateMessage(conversationId: string, ts: string, text: string): Promise<void>;\n  enqueueEvent(event: BotEvent): boolean;\n  getPlatformInfo(): PlatformInfo;\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, isEvent?: boolean): 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  handleNew(sessionKey: string, conversationId: string, bot: Bot): Promise<void>;\n  /** Handle credential onboarding for a user login command. */\n  handleLogin(\n    platform: string,\n    platformUserId: string,\n    conversationId: string,\n    bot: Bot,\n    commandText: string,\n    isPrivateConversation: boolean,\n  ): Promise<void>;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\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 ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: 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// Generic cross-platform event and bot interfaces\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(\n    event: BotEvent,\n    bot: Bot,\n    adapters: BotAdapters,\n    isSyntheticEvent?: boolean,\n  ): 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/bot.d.ts

@@ -7,6 +7,7 @@ export interface DiscordEvent extends BotEvent {
 export declare class DiscordBot implements Bot {
     private client;
     private handler;
+    private token;
     private workingDir;
     private botUserId;
     private queues;
@@ -18,8 +19,8 @@ export declare class DiscordBot implements Bot {
         workingDir: string;
     });
     start(): Promise<void>;
-    postMessage(conversationId: string, text: string): Promise<string>;
-    updateMessage(conversationId: string, ts: string, text: string): Promise<void>;
+    postMessage(channel: string, text: string): Promise<string>;
+    updateMessage(channel: string, ts: string, text: string): Promise<void>;
     enqueueEvent(event: BotEvent): boolean;
     getPlatformInfo(): PlatformInfo;
     updateMessageRaw(channelId: string, messageId: string, text: string): Promise<void>;
@@ -28,6 +29,8 @@ export declare class DiscordBot implements Bot {
     deleteMessageRaw(channelId: string, messageId: string): Promise<void>;
     sendTyping(channelId: string): Promise<void>;
     uploadFile(channelId: string, filePath: string, title?: string): Promise<void>;
+    sendDirectMessage(userId: string, text: string): Promise<string>;
+    postPrivate(_conversationId: string, userId: string, text: string): Promise<void>;
     getAllChannels(): {
         id: string;
         name: string;
@@ -40,18 +43,20 @@ export declare class DiscordBot implements Bot {
     logToFile(channelId: string, entry: object): void;
     logBotResponse(channelId: string, text: string, ts: string): void;
     /**
-     * Process attachments from a Discord message
-     * Downloads files in background and returns metadata
-     * Returns format compatible with ChatMessage: { name: string, localPath: string }[]
+     * Process attachments from a Discord message.
+     * Downloads files before returning so the agent can read them immediately.
      */
-    processAttachments(channelId: string, attachments: Collection<string, Attachment>, _messageId: string): {
+    processAttachments(channelId: string, attachments: Collection<string, Attachment>, _messageId: string): Promise<{
         name: string;
         localPath: string;
-    }[];
+    }[]>;
     private downloadAttachment;
     private getQueue;
+    private resolveStopTarget;
     private loadCachedGuildData;
     private stripBotMention;
+    private resolveConversationContext;
+    private createSlashCommandAdapters;
     private setupEventHandlers;
     private fetchTextChannel;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Client,\n  Events,\n  GatewayIntentBits,\n  Partials,\n  type Collection,\n  type Message,\n  type Attachment,\n  type TextChannel,\n  type DMChannel,\n  type NewsChannel,\n  type ThreadChannel,\n} from \"discord.js\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, join } from \"path\";\n\nimport type { Bot, BotEvent, BotHandler, PlatformInfo } from \"../../adapter.js\";\nimport { parseLoginCommand } from \"../../login.js\";\nimport * as log from \"../../log.js\";\nimport { formatAlreadyWorking, formatNothingRunning } from \"../../ui-copy.js\";\nimport { createDiscordAdapters } from \"./context.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface DiscordEvent extends BotEvent {\n  type: \"mention\" | \"dm\";\n  userName?: string;\n}\n\n// ============================================================================\n// Per-channel queue for sequential processing\n// ============================================================================\n\ntype QueuedWork = () => Promise<void>;\n\nclass ChannelQueue {\n  private queue: QueuedWork[] = [];\n  private processing = false;\n\n  enqueue(work: QueuedWork): 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(\"Discord queue error\", err instanceof Error ? err.message : String(err));\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\n// ============================================================================\n// DiscordBot\n// ============================================================================\n\nexport class DiscordBot implements Bot {\n  private client: Client;\n  private handler: BotHandler;\n  private workingDir: string;\n  private botUserId: string | null = null;\n  private queues = new Map<string, ChannelQueue>();\n  private startupTime: number = 0;\n  private channels = new Map<string, { id: string; name: string }>();\n  private users = new Map<string, { id: string; userName: string; displayName: string }>();\n\n  constructor(handler: BotHandler, config: { token: string; workingDir: string }) {\n    this.handler = handler;\n    this.workingDir = config.workingDir;\n    this.client = new Client({\n      intents: [\n        GatewayIntentBits.Guilds,\n        GatewayIntentBits.GuildMessages,\n        GatewayIntentBits.MessageContent,\n        GatewayIntentBits.DirectMessages,\n      ],\n      partials: [Partials.Channel, Partials.Message],\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements Bot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.client.once(Events.ClientReady, (readyClient) => {\n        this.botUserId = readyClient.user.id;\n        this.startupTime = Date.now();\n        log.logConnected();\n        log.logInfo(`Discord bot started as ${readyClient.user.tag}`);\n        this.loadCachedGuildData();\n        this.setupEventHandlers();\n        resolve();\n      });\n      this.client.once(Events.Error, reject);\n      this.client.login(process.env.MOM_DISCORD_BOT_TOKEN!).catch(reject);\n    });\n  }\n\n  async postMessage(conversationId: string, text: string): Promise<string> {\n    const ch = await this.fetchTextChannel(conversationId);\n    const msg = await ch.send(text);\n    return msg.id;\n  }\n\n  async updateMessage(conversationId: string, ts: string, text: string): Promise<void> {\n    await this.updateMessageRaw(conversationId, ts, text);\n  }\n\n  enqueueEvent(event: BotEvent): boolean {\n    const queue = this.getQueue(event.conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${event.conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${event.conversationId}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const discordEvent: DiscordEvent = {\n        ...event,\n        type: \"mention\",\n        conversationId: event.conversationId,\n      };\n      const adapters = createDiscordAdapters(discordEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"discord\",\n      formattingGuide:\n        \"## Discord Formatting (Markdown)\\nBold: **text**, Italic: *text*, Code: `code`, Block: ```language\\ncode```\\nLinks: [text](url)\",\n      channels: this.getAllChannels(),\n      users: this.getAllUsers(),\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async updateMessageRaw(channelId: string, messageId: string, text: string): Promise<void> {\n    const ch = await this.fetchTextChannel(channelId);\n    const msg = await ch.messages.fetch(messageId);\n    await msg.edit(text);\n  }\n\n  async postReply(channelId: string, replyToId: string, text: string): Promise<string> {\n    const ch = await this.fetchTextChannel(channelId);\n    const replyTarget = await ch.messages.fetch(replyToId);\n    const sent = await replyTarget.reply(text);\n    return sent.id;\n  }\n\n  async postInThread(channelId: string, threadOrMessageId: string, text: string): Promise<string> {\n    // Try as a thread channel first, then fall back to posting in the channel\n    try {\n      const thread = await this.client.channels.fetch(threadOrMessageId);\n      if (thread && (thread.isThread() || thread.isTextBased())) {\n        const msg = await (thread as ThreadChannel).send(text);\n        return msg.id;\n      }\n    } catch {\n      // Not a thread channel, treat as message ID for reply\n    }\n    return this.postReply(channelId, threadOrMessageId, text);\n  }\n\n  async deleteMessageRaw(channelId: string, messageId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      const msg = await ch.messages.fetch(messageId);\n      await msg.delete();\n    } catch {\n      // Ignore if already deleted\n    }\n  }\n\n  async sendTyping(channelId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      await ch.sendTyping();\n    } catch {\n      // Non-fatal\n    }\n  }\n\n  async uploadFile(channelId: string, filePath: string, title?: string): Promise<void> {\n    const ch = await this.fetchTextChannel(channelId);\n    const fileName = title ?? basename(filePath);\n    const fileContent = readFileSync(filePath);\n    await ch.send({ files: [{ attachment: fileContent, name: fileName }] });\n  }\n\n  getAllChannels(): { id: string; name: string }[] {\n    return Array.from(this.channels.values());\n  }\n\n  getAllUsers(): { id: string; userName: string; displayName: string }[] {\n    return Array.from(this.users.values());\n  }\n\n  logToFile(channelId: string, entry: object): void {\n    const channelDir = join(this.workingDir, channelId);\n    if (!existsSync(channelDir)) mkdirSync(channelDir, { recursive: true });\n    appendFileSync(join(channelDir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n  }\n\n  logBotResponse(channelId: string, text: string, ts: string): void {\n    this.logToFile(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  /**\n   * Process attachments from a Discord message\n   * Downloads files in background and returns metadata\n   * Returns format compatible with ChatMessage: { name: string, localPath: string }[]\n   */\n  processAttachments(\n    channelId: string,\n    attachments: Collection<string, Attachment>,\n    _messageId: string,\n  ): { name: string; localPath: string }[] {\n    const result: { name: string; localPath: string }[] = [];\n\n    // Discord attachments Collection - iterate over values\n    for (const attachment of attachments.values()) {\n      if (!attachment.name) {\n        log.logWarning(\"Discord attachment missing name, skipping\", attachment.url);\n        continue;\n      }\n\n      // Generate local filename\n      const ts = Date.now();\n      const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${ts}_${sanitizedName}`;\n      const localPath = `${channelId}/attachments/${filename}`;\n      const attachmentsDir = join(this.workingDir, channelId, \"attachments\");\n\n      result.push({\n        name: attachment.name,\n        localPath: localPath,\n      });\n\n      // Download in background (fire and forget)\n      this.downloadAttachment(attachmentsDir, filename, attachment.url).catch((err) => {\n        log.logWarning(`Failed to download Discord attachment`, `${filename}: ${err}`);\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Download an attachment from URL to local file\n   */\n  private async downloadAttachment(\n    attachmentsDir: string,\n    filename: string,\n    url: string,\n  ): Promise<void> {\n    if (!existsSync(attachmentsDir)) mkdirSync(attachmentsDir, { recursive: true });\n\n    try {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      writeFileSync(join(attachmentsDir, filename), Buffer.from(buffer));\n    } catch (err) {\n      throw new Error(`Download failed: ${err instanceof Error ? err.message : String(err)}`);\n    }\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): ChannelQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new ChannelQueue();\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private loadCachedGuildData(): void {\n    for (const guild of this.client.guilds.cache.values()) {\n      for (const channel of guild.channels.cache.values()) {\n        if (channel.isTextBased() && \"name\" in channel) {\n          this.channels.set(channel.id, { id: channel.id, name: channel.name ?? channel.id });\n        }\n      }\n      for (const member of guild.members.cache.values()) {\n        this.users.set(member.id, {\n          id: member.id,\n          userName: member.user.username,\n          displayName: member.displayName,\n        });\n      }\n    }\n  }\n\n  private stripBotMention(text: string): string {\n    if (!this.botUserId) return text;\n    return text.replace(new RegExp(`<@!?${this.botUserId}>`, \"g\"), \"\").trim();\n  }\n\n  private setupEventHandlers(): void {\n    this.client.on(Events.MessageCreate, async (msg: Message) => {\n      // Skip messages from before startup\n      if (msg.createdTimestamp < this.startupTime) return;\n      // Skip bot messages\n      if (msg.author.bot) return;\n      // Skip if bot isn't mentioned and it's not a DM\n      const isDM = msg.channel.type === 1; // ChannelType.DM = 1\n      const isMentioned = msg.mentions.users.has(this.botUserId ?? \"\");\n      if (!isDM && !isMentioned) return;\n\n      const channelId = msg.channelId;\n      const userId = msg.author.id;\n      const userName = msg.author.username;\n      const msgId = msg.id;\n\n      // Track user\n      this.users.set(userId, {\n        id: userId,\n        userName,\n        displayName: msg.member?.displayName ?? userName,\n      });\n\n      // Track channel\n      if (!this.channels.has(channelId) && \"name\" in msg.channel) {\n        const ch = msg.channel as TextChannel | NewsChannel;\n        this.channels.set(channelId, { id: channelId, name: ch.name });\n      }\n\n      // Thread: if this message is in a thread (has parentId) or is a reply\n      const isInThread = msg.channel.isThread();\n      const referencedMsgId = msg.reference?.messageId;\n      const threadTs = isInThread ? msg.channelId : referencedMsgId;\n      const sessionKey = `${channelId}:${threadTs ?? msgId}`;\n\n      const cleanedText = this.stripBotMention(msg.content);\n\n      // Process attachments (download in background)\n      const processedAttachments = this.processAttachments(channelId, msg.attachments, msgId);\n\n      const event: DiscordEvent = {\n        type: isDM ? \"dm\" : \"mention\",\n        conversationId: channelId,\n        ts: msgId,\n        thread_ts: threadTs,\n        user: userId,\n        userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n      };\n\n      // Log message\n      this.logToFile(channelId, {\n        date: msg.createdAt.toISOString(),\n        ts: msgId,\n        user: userId,\n        userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n        isBot: false,\n      });\n\n      // Handle stop command\n      if (cleanedText.toLowerCase() === \"stop\" || cleanedText.toLowerCase() === \"/stop\") {\n        if (this.handler.isRunning(sessionKey)) {\n          this.handler.handleStop(sessionKey, channelId, this);\n        } else {\n          await this.postMessage(channelId, formatNothingRunning(\"discord\"));\n        }\n        return;\n      }\n\n      // Handle login command\n      if (parseLoginCommand(cleanedText)) {\n        await this.handler.handleLogin(\"discord\", userId, channelId, this, cleanedText, isDM);\n        return;\n      }\n\n      if (this.handler.isRunning(sessionKey)) {\n        await this.postMessage(channelId, formatAlreadyWorking(\"discord\", \"stop\"));\n      } else {\n        this.getQueue(sessionKey).enqueue(() => {\n          const adapters = createDiscordAdapters(event, this, false);\n          return this.handler.handleEvent(event, this, adapters, false);\n        });\n      }\n    });\n  }\n\n  private async fetchTextChannel(\n    channelId: string,\n  ): Promise<TextChannel | DMChannel | NewsChannel | ThreadChannel> {\n    const ch = await this.client.channels.fetch(channelId);\n    if (!ch || !ch.isTextBased()) {\n      throw new Error(`Channel ${channelId} is not a text channel`);\n    }\n    return ch as TextChannel | DMChannel | NewsChannel | ThreadChannel;\n  }\n}\n"]}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/discord/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ApplicationCommandOptionType,\n  Client,\n  Events,\n  GatewayIntentBits,\n  Partials,\n  type ChatInputCommandInteraction,\n  type Collection,\n  type Message,\n  type Attachment,\n  type TextChannel,\n  type DMChannel,\n  type NewsChannel,\n  type ThreadChannel,\n} from \"discord.js\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, join } from \"path\";\n\nimport type {\n  Bot,\n  BotAdapters,\n  BotEvent,\n  BotHandler,\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../session-policy.js\";\nimport { evaluateAutoReplyPolicy } from \"../../trigger.js\";\nimport { formatNothingRunning } from \"../../ui-copy.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  ChannelQueue,\n  resolveOnlyScopedStopTarget,\n  resolveStopTarget,\n  withRetry,\n} from \"../shared.js\";\nimport { createDiscordAdapters } from \"./context.js\";\n\n// discord.js: DiscordAPIError exposes `.status` (HTTP status) and a `.code`.\n// RateLimitError fires when the internal queue gives up. Both should retry.\nfunction discordIsRateLimited(err: Error): boolean {\n  if ((err as { status?: number }).status === 429) return true;\n  if ((err as { httpStatus?: number }).httpStatus === 429) return true;\n  if (err.name === \"RateLimitError\") return true;\n  return false;\n}\n\nconst discordRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: discordIsRateLimited });\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface DiscordEvent extends BotEvent {\n  type: \"mention\" | \"dm\";\n  userName?: string;\n}\n\n// ============================================================================\n// DiscordBot\n// ============================================================================\n\nexport class DiscordBot implements Bot {\n  private client: Client;\n  private handler: BotHandler;\n  private token: string;\n  private workingDir: string;\n  private botUserId: string | null = null;\n  private queues = new Map<string, ChannelQueue>();\n  private startupTime: number = 0;\n  private channels = new Map<string, { id: string; name: string }>();\n  private users = new Map<string, { id: string; userName: string; displayName: string }>();\n\n  constructor(handler: BotHandler, config: { token: string; workingDir: string }) {\n    this.handler = handler;\n    this.token = config.token;\n    this.workingDir = config.workingDir;\n    this.client = new Client({\n      intents: [\n        GatewayIntentBits.Guilds,\n        GatewayIntentBits.GuildMessages,\n        GatewayIntentBits.MessageContent,\n        GatewayIntentBits.DirectMessages,\n      ],\n      partials: [Partials.Channel, Partials.Message],\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements Bot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      this.client.once(Events.ClientReady, async (readyClient) => {\n        this.botUserId = readyClient.user.id;\n        this.startupTime = Date.now();\n        log.logConnected(\"Discord\");\n        log.logInfo(`Discord bot started as ${readyClient.user.tag}`);\n        this.loadCachedGuildData();\n        this.setupEventHandlers();\n        try {\n          await readyClient.application.commands.set([\n            {\n              name: \"login\",\n              description: \"Store credentials in your private vault\",\n            },\n            {\n              name: \"session\",\n              description: \"Open the current session in the web viewer\",\n            },\n            {\n              name: \"new\",\n              description: \"Reset conversation history and start fresh\",\n            },\n            {\n              name: \"stop\",\n              description: \"Stop the current conversation\",\n            },\n            {\n              name: \"model\",\n              description: \"Switch this conversation's LLM model\",\n              options: [\n                {\n                  name: \"model\",\n                  description: \"provider/model[:thinking], e.g. anthropic/claude-sonnet-4-6:off\",\n                  type: ApplicationCommandOptionType.String,\n                  required: false,\n                },\n              ],\n            },\n            {\n              name: \"sandbox\",\n              description: \"Show or temporarily boost this conversation's sandbox limits\",\n              options: [\n                {\n                  name: \"action\",\n                  description: \"Use 'boost' to temporarily apply the configured boost limits\",\n                  type: ApplicationCommandOptionType.String,\n                  required: false,\n                },\n              ],\n            },\n          ]);\n        } catch (err) {\n          log.logWarning(\n            \"Failed to register Discord slash commands\",\n            err instanceof Error ? err.message : String(err),\n          );\n        }\n        resolve();\n      });\n      this.client.once(Events.Error, reject);\n      this.client.login(this.token).catch(reject);\n    });\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channel);\n      const msg = await ch.send(text);\n      return msg.id;\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    await this.updateMessageRaw(channel, ts, text);\n  }\n\n  enqueueEvent(event: BotEvent): boolean {\n    const conversationId = event.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const adapters = createDiscordAdapters(event as DiscordEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"discord\",\n      formattingGuide:\n        \"## Discord Formatting (Markdown)\\nBold: **text**, Italic: *text*, Code: `code`, Block: ```language\\ncode```\\nLinks: [text](url)\",\n      channels: this.getAllChannels(),\n      users: this.getAllUsers(),\n      diagnostics: {\n        showUsageSummary: false,\n      },\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async updateMessageRaw(channelId: string, messageId: string, text: string): Promise<void> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channelId);\n      const msg = await ch.messages.fetch(messageId);\n      await msg.edit(text);\n    });\n  }\n\n  async postReply(channelId: string, replyToId: string, text: string): Promise<string> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channelId);\n      const replyTarget = await ch.messages.fetch(replyToId);\n      const sent = await replyTarget.reply(text);\n      return sent.id;\n    });\n  }\n\n  async postInThread(channelId: string, threadOrMessageId: string, text: string): Promise<string> {\n    // Try as a thread channel first, then fall back to posting in the channel\n    try {\n      const thread = await this.client.channels.fetch(threadOrMessageId);\n      if (thread && (thread.isThread() || thread.isTextBased())) {\n        return discordRetry(async () => {\n          const msg = await (thread as ThreadChannel).send(text);\n          return msg.id;\n        });\n      }\n    } catch {\n      // Not a thread channel, treat as message ID for reply\n    }\n    return this.postReply(channelId, threadOrMessageId, text);\n  }\n\n  async deleteMessageRaw(channelId: string, messageId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      const msg = await ch.messages.fetch(messageId);\n      await msg.delete();\n    } catch {\n      // Ignore if already deleted\n    }\n  }\n\n  async sendTyping(channelId: string): Promise<void> {\n    try {\n      const ch = await this.fetchTextChannel(channelId);\n      await ch.sendTyping();\n    } catch {\n      // Non-fatal\n    }\n  }\n\n  async uploadFile(channelId: string, filePath: string, title?: string): Promise<void> {\n    return discordRetry(async () => {\n      const ch = await this.fetchTextChannel(channelId);\n      const fileName = title ?? basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await ch.send({ files: [{ attachment: fileContent, name: fileName }] });\n    });\n  }\n\n  async sendDirectMessage(userId: string, text: string): Promise<string> {\n    return discordRetry(async () => {\n      const user = await this.client.users.fetch(userId);\n      const msg = await user.send(text);\n      return msg.id;\n    });\n  }\n\n  async postPrivate(_conversationId: string, userId: string, text: string): Promise<void> {\n    await this.sendDirectMessage(userId, text);\n  }\n\n  getAllChannels(): { id: string; name: string }[] {\n    return Array.from(this.channels.values());\n  }\n\n  getAllUsers(): { id: string; userName: string; displayName: string }[] {\n    return Array.from(this.users.values());\n  }\n\n  logToFile(channelId: string, entry: object): void {\n    appendChannelLog(this.workingDir, channelId, entry);\n  }\n\n  logBotResponse(channelId: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workingDir, channelId, text, ts);\n  }\n\n  /**\n   * Process attachments from a Discord message.\n   * Downloads files before returning so the agent can read them immediately.\n   */\n  async processAttachments(\n    channelId: string,\n    attachments: Collection<string, Attachment>,\n    _messageId: string,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const downloads: Array<Promise<{ name: string; localPath: string } | null>> = [];\n\n    // Discord attachments Collection - iterate over values\n    for (const attachment of attachments.values()) {\n      if (!attachment.name) {\n        log.logWarning(\"Discord attachment missing name, skipping\", attachment.url);\n        continue;\n      }\n\n      const ts = Date.now();\n      const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${ts}_${sanitizedName}`;\n      const localPath = `${channelId}/attachments/${filename}`;\n      const fullDir = join(this.workingDir, channelId, \"attachments\");\n      const result = {\n        name: attachment.name,\n        localPath,\n      };\n\n      downloads.push(\n        this.downloadAttachment(fullDir, filename, attachment.url)\n          .then(() => result)\n          .catch((err) => {\n            log.logWarning(`Failed to download Discord attachment`, `${filename}: ${err}`);\n            return null;\n          }),\n      );\n    }\n\n    const results = await Promise.all(downloads);\n    return results.filter(\n      (attachment): attachment is { name: string; localPath: string } => attachment !== null,\n    );\n  }\n\n  /**\n   * Download an attachment from URL to local file\n   */\n  private async downloadAttachment(dir: string, filename: string, url: string): Promise<void> {\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n\n    try {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      writeFileSync(join(dir, filename), Buffer.from(buffer));\n    } catch (err) {\n      throw new Error(`Download failed: ${err instanceof Error ? err.message : String(err)}`, {\n        cause: err,\n      });\n    }\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): ChannelQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new ChannelQueue(\"Discord\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private resolveStopTarget(channelId: string, sessionKey: string): string | null {\n    const directTarget = resolveStopTarget({\n      handler: this.handler,\n      conversationId: channelId,\n      sessionKey,\n    });\n    if (directTarget) return directTarget;\n    if (sessionKey !== channelId) return null;\n    return resolveOnlyScopedStopTarget(this.handler, channelId);\n  }\n\n  private loadCachedGuildData(): void {\n    for (const guild of this.client.guilds.cache.values()) {\n      for (const channel of guild.channels.cache.values()) {\n        if (channel.isTextBased() && \"name\" in channel) {\n          this.channels.set(channel.id, { id: channel.id, name: channel.name ?? channel.id });\n        }\n      }\n      for (const member of guild.members.cache.values()) {\n        this.users.set(member.id, {\n          id: member.id,\n          userName: member.user.username,\n          displayName: member.displayName,\n        });\n      }\n    }\n  }\n\n  private stripBotMention(text: string): string {\n    if (!this.botUserId) return text;\n    return text.replace(new RegExp(`<@!?${this.botUserId}>`, \"g\"), \"\").trim();\n  }\n\n  private resolveConversationContext(input: {\n    channelId: string;\n    inGuild: boolean;\n    isThread: boolean;\n    parentChannelId?: string | null;\n    referencedMsgId?: string;\n  }): { conversationId: string; threadTs?: string } {\n    if (!input.inGuild) {\n      return {\n        conversationId: input.channelId,\n        threadTs: input.referencedMsgId,\n      };\n    }\n\n    if (input.isThread) {\n      return {\n        conversationId: input.parentChannelId ?? input.channelId,\n        threadTs: input.channelId,\n      };\n    }\n\n    return {\n      conversationId: input.channelId,\n      threadTs: input.referencedMsgId,\n    };\n  }\n\n  private createSlashCommandAdapters(\n    interaction: ChatInputCommandInteraction,\n    commandText: string,\n    sessionKey: string,\n    conversationId: string,\n  ): BotAdapters {\n    const isDM = !interaction.inGuild();\n    const userId = interaction.user.id;\n    const userName = interaction.user.username;\n    const platform = this.getPlatformInfo();\n    const shouldUseEphemeral = !isDM;\n\n    const message: ChatMessage = {\n      id: interaction.id,\n      sessionKey,\n      conversationKind: isDM ? \"direct\" : \"shared\",\n      userId,\n      userName,\n      text: commandText,\n      attachments: [],\n    };\n\n    const respondPrivately = async (text: string, replace = false): Promise<void> => {\n      if (interaction.replied || interaction.deferred) {\n        if (replace) {\n          await interaction.editReply({ content: text });\n        } else {\n          await interaction.followUp({ content: text, ephemeral: shouldUseEphemeral });\n        }\n        return;\n      }\n\n      await interaction.reply({ content: text, ephemeral: shouldUseEphemeral });\n    };\n\n    const responseCtx: ChatResponseContext = {\n      respond: async (text: string) => {\n        await respondPrivately(text);\n      },\n      replaceResponse: async (text: string) => {\n        await respondPrivately(text, true);\n      },\n      respondDiagnostic: async (text: string) => {\n        await respondPrivately(text);\n      },\n      respondToolResult: async (result: ChatToolResult) => {\n        const duration = (result.durationMs / 1000).toFixed(1);\n        const formatted = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName} (${duration}s)\\n${result.result}`;\n        await respondPrivately(formatted);\n      },\n      setTyping: async () => {},\n      setWorking: async () => {},\n      uploadFile: async (filePath: string, title?: string) => {\n        await this.uploadFile(conversationId, filePath, title);\n      },\n      deleteResponse: async () => {},\n    };\n\n    return { message, responseCtx, platform };\n  }\n\n  private setupEventHandlers(): void {\n    this.client.on(Events.InteractionCreate, async (interaction) => {\n      if (!interaction.isChatInputCommand()) return;\n      if (\n        interaction.commandName !== \"login\" &&\n        interaction.commandName !== \"session\" &&\n        interaction.commandName !== \"new\" &&\n        interaction.commandName !== \"stop\" &&\n        interaction.commandName !== \"model\" &&\n        interaction.commandName !== \"sandbox\"\n      ) {\n        return;\n      }\n\n      const isDM = !interaction.inGuild();\n      const { conversationId, threadTs } = this.resolveConversationContext({\n        channelId: interaction.channelId,\n        inGuild: interaction.inGuild(),\n        isThread: interaction.channel?.isThread() ?? false,\n        parentChannelId:\n          interaction.channel && \"parentId\" in interaction.channel\n            ? interaction.channel.parentId\n            : null,\n      });\n      const sessionKey = resolveChatSessionKey({\n        conversationId,\n        conversationKind: isDM ? \"direct\" : \"shared\",\n        messageId: interaction.id,\n        persistentTopLevel: true,\n        threadTs,\n      });\n      const modelOption =\n        interaction.commandName === \"model\"\n          ? interaction.options.getString(\"model\")?.trim()\n          : undefined;\n      const sandboxAction =\n        interaction.commandName === \"sandbox\"\n          ? interaction.options.getString(\"action\")?.trim()\n          : undefined;\n      const commandArg = modelOption ?? sandboxAction;\n      const commandText = commandArg\n        ? `/${interaction.commandName} ${commandArg}`\n        : `/${interaction.commandName}`;\n\n      this.logToFile(conversationId, {\n        date: new Date(interaction.createdTimestamp).toISOString(),\n        ts: interaction.id,\n        ...(threadTs ? { threadTs } : {}),\n        user: interaction.user.id,\n        userName: interaction.user.username,\n        text: commandText,\n        attachments: [],\n        isBot: false,\n      });\n\n      const adapters = this.createSlashCommandAdapters(\n        interaction,\n        commandText,\n        sessionKey,\n        conversationId,\n      );\n      try {\n        if (interaction.commandName === \"new\") {\n          await this.handler.handleNewCommand(sessionKey, conversationId, this);\n          return;\n        }\n\n        if (interaction.commandName === \"stop\") {\n          const stopTarget = this.resolveStopTarget(conversationId, sessionKey);\n          if (stopTarget) {\n            await this.handler.handleStop(stopTarget, conversationId, this);\n          } else {\n            await adapters.responseCtx.respond(formatNothingRunning(\"discord\"));\n          }\n          return;\n        }\n\n        const event: BotEvent = {\n          type: \"dm\",\n          conversationId,\n          conversationKind: isDM ? \"direct\" : \"shared\",\n          ts: interaction.id,\n          thread_ts: threadTs,\n          sessionKey,\n          user: interaction.user.id,\n          text: commandText,\n          attachments: [],\n        };\n\n        await this.handler.handleEvent(event, this, adapters, false);\n      } catch (err) {\n        log.logWarning(\n          \"Discord slash command error\",\n          err instanceof Error ? err.message : String(err),\n        );\n        if (!interaction.replied && !interaction.deferred) {\n          await interaction.reply({\n            content: `${interaction.commandName} command failed. Please try again later.`,\n            ephemeral: !isDM,\n          });\n        }\n      }\n    });\n\n    this.client.on(Events.MessageCreate, async (msg: Message) => {\n      // Skip messages from before startup\n      if (msg.createdTimestamp < this.startupTime) return;\n      // Skip bot messages\n      if (msg.author.bot) return;\n      const isDM = msg.channel.type === 1; // ChannelType.DM = 1\n      const isInThread = msg.channel.isThread();\n      const referencedMsgId = msg.reference?.messageId;\n      const isThreadReply = isInThread || !!referencedMsgId;\n      const isMentioned = msg.mentions.users.has(this.botUserId ?? \"\");\n      const isAutoReplyCandidate = !isDM && !isMentioned && !isThreadReply;\n\n      const { conversationId, threadTs } = this.resolveConversationContext({\n        channelId: msg.channelId,\n        inGuild: !isDM,\n        isThread: isInThread,\n        parentChannelId: \"parentId\" in msg.channel ? msg.channel.parentId : null,\n        referencedMsgId,\n      });\n      const userId = msg.author.id;\n      const userName = msg.author.username;\n      const msgId = msg.id;\n\n      // Track user\n      this.users.set(userId, {\n        id: userId,\n        userName,\n        displayName: msg.member?.displayName ?? userName,\n      });\n\n      // Track channel\n      if (!this.channels.has(conversationId) && \"name\" in msg.channel) {\n        const ch = msg.channel as TextChannel | NewsChannel;\n        this.channels.set(conversationId, { id: conversationId, name: ch.name });\n      }\n\n      const conversationKind = isDM ? \"direct\" : \"shared\";\n      const sessionKey = resolveChatSessionKey({\n        conversationId,\n        conversationKind,\n        messageId: msgId,\n        persistentTopLevel: true,\n        threadTs,\n      });\n\n      const cleanedText = this.stripBotMention(msg.content);\n\n      const eventBase: DiscordEvent = {\n        type: isDM ? \"dm\" : \"mention\",\n        conversationId,\n        conversationKind,\n        ts: msgId,\n        thread_ts: threadTs,\n        sessionKey,\n        user: userId,\n        userName,\n        text: cleanedText,\n      };\n\n      // Handle stop before trigger gate — \"stop\" should never be auto-reply judged.\n      if (cleanedText.toLowerCase() === \"stop\" || cleanedText.toLowerCase() === \"/stop\") {\n        const stopTarget = this.resolveStopTarget(conversationId, sessionKey);\n        if (stopTarget) {\n          this.handler.handleStop(stopTarget, conversationId, this);\n        } else if (!isAutoReplyCandidate) {\n          await this.postMessage(conversationId, formatNothingRunning(\"discord\"));\n        }\n        return;\n      }\n\n      const triggerResult = isAutoReplyCandidate\n        ? await evaluateAutoReplyPolicy({ event: eventBase, workingDir: this.workingDir })\n        : ({ trigger: true, reason: \"addressed\" } as const);\n\n      const logEntryBase = {\n        date: msg.createdAt.toISOString(),\n        ts: msgId,\n        ...(!isDM && threadTs ? { threadTs } : {}),\n        user: userId,\n        userName,\n        text: cleanedText,\n        isBot: false,\n      };\n\n      if (!triggerResult.trigger) {\n        this.logToFile(conversationId, { ...logEntryBase, attachments: [] });\n        return;\n      }\n\n      const processedAttachments = await this.processAttachments(\n        conversationId,\n        msg.attachments,\n        msgId,\n      );\n      const event: DiscordEvent = { ...eventBase, attachments: processedAttachments };\n\n      this.logToFile(conversationId, { ...logEntryBase, attachments: processedAttachments });\n\n      this.getQueue(sessionKey).enqueue(() => {\n        const adapters = createDiscordAdapters(event, this, false);\n        return this.handler.handleEvent(event, this, adapters, false);\n      });\n    });\n  }\n\n  private async fetchTextChannel(\n    channelId: string,\n  ): Promise<TextChannel | DMChannel | NewsChannel | ThreadChannel> {\n    const ch = await this.client.channels.fetch(channelId);\n    if (!ch || !ch.isTextBased()) {\n      throw new Error(`Channel ${channelId} is not a text channel`);\n    }\n    return ch as TextChannel | DMChannel | NewsChannel | ThreadChannel;\n  }\n}\n"]}