@geminixiang/mama 0.1.7 → 0.1.9

package/README.md

@@ -158,16 +158,44 @@ Create `settings.json` in your working directory to override defaults:
   "provider": "anthropic",
   "model": "claude-sonnet-4-5",
   "thinkingLevel": "off",
-  "sessionScope": "thread"
+  "sessionScope": "thread",
+  "logFormat": "console",
+  "logLevel": "info"
 }
 ```
 
-| Field           | Default             | Description                                    |
-| --------------- | ------------------- | ---------------------------------------------- |
-| `provider`      | `anthropic`         | AI provider (env: `MOM_AI_PROVIDER`)           |
-| `model`         | `claude-sonnet-4-5` | Model name (env: `MOM_AI_MODEL`)               |
-| `thinkingLevel` | `off`               | `off` / `low` / `medium` / `high`              |
-| `sessionScope`  | `thread`            | `thread` (per thread/reply chain) or `channel` |
+| Field           | Default             | Description                                              |
+| --------------- | ------------------- | -------------------------------------------------------- |
+| `provider`      | `anthropic`         | AI provider (env: `MOM_AI_PROVIDER`)                     |
+| `model`         | `claude-sonnet-4-5` | Model name (env: `MOM_AI_MODEL`)                         |
+| `thinkingLevel` | `off`               | `off` / `low` / `medium` / `high`                        |
+| `sessionScope`  | `thread`            | `thread` (per thread/reply chain) or `channel`           |
+| `logFormat`     | `console`           | `console` (colored stdout) or `json` (GCP Cloud Logging) |
+| `logLevel`      | `info`              | `trace` / `debug` / `info` / `warn` / `error`            |
+
+### GCP Cloud Logging (Compute Engine)
+
+Set `logFormat: "json"` to send structured logs directly to Cloud Logging via API — no Ops Agent or log file configuration needed.
+
+**Requirements:**
+
+1. VM service account has `roles/logging.logWriter`
+2. `GOOGLE_CLOUD_PROJECT` env var is set
+
+```bash
+GOOGLE_CLOUD_PROJECT=<your-project-id> mama <working-directory>
+```
+
+`settings.json`:
+
+```json
+{
+  "logFormat": "json",
+  "logLevel": "info"
+}
+```
+
+Logs appear in Cloud Logging under **Log name: `mama`**. Console output (stdout) is unaffected and continues to work alongside Cloud Logging.
 
 ## Working Directory Layout
 

package/dist/adapter.d.ts

@@ -81,12 +81,18 @@ export interface BotAdapters {
 export interface RunningSession {
     sessionKey: string;
     startedAt: number;
+    /** Last activity timestamp (for detecting hung tasks) */
+    lastActivityAt?: number;
+    /** Current tool/step being executed (if any) */
+    currentTool?: string;
 }
 export interface BotHandler {
     isRunning(sessionKey: string): boolean;
     getRunningSessions(): RunningSession[];
     handleEvent(event: BotEvent, bot: Bot, adapters: BotAdapters, isEvent?: boolean): Promise<void>;
     handleStop(sessionKey: string, channelId: string, bot: Bot): Promise<void>;
+    /** Force stop a running session (bypass normal stop mechanism) */
+    forceStop(sessionKey: string): void;
 }
 /** @deprecated Use BotHandler */
 export type MomHandler = BotHandler;

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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string): 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  /** Platform-specific channel/chat identifier */\n  channel: 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}\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\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}\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, channelId: string, bot: Bot): 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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string): 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  /** Platform-specific channel/chat identifier */\n  channel: 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}\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\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, channelId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\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}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string): 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  /** Platform-specific channel/chat identifier */\n  channel: 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}\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\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}\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, channelId: string, bot: Bot): 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 interface ChatMessage {\n  id: string;\n  sessionKey: string;\n  userId: string;\n  userName?: string;\n  text: string;\n  attachments?: { name: string; localPath: string }[];\n}\n\nexport interface ChatResponseContext {\n  respond(text: string): Promise<void>;\n  replaceResponse(text: string): Promise<void>;\n  respondInThread(text: string): 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  /** Platform-specific channel/chat identifier */\n  channel: 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}\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\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, channelId: string, bot: Bot): Promise<void>;\n  /** Force stop a running session (bypass normal stop mechanism) */\n  forceStop(sessionKey: string): void;\n}\n\n/** @deprecated Use BotHandler */\nexport type MomHandler = BotHandler;\n"]}

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

@@ -87,7 +87,7 @@ export declare class SlackBot implements Bot {
     updateMessage(channel: string, ts: string, text: string): Promise<void>;
     deleteMessage(channel: string, ts: string): Promise<void>;
     postInThread(channel: string, threadTs: string, text: string): Promise<string>;
-    uploadFile(channel: string, filePath: string, title?: string): Promise<void>;
+    uploadFile(channel: string, filePath: string, title?: string, threadTs?: string): Promise<void>;
     /**
      * Log a message to log.jsonl (SYNC)
      * This is the ONLY place messages are written to log.jsonl

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

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import { SocketModeClient } from \"@slack/socket-mode\";\nimport { WebClient } from \"@slack/web-api\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { basename, join } from \"path\";\nimport type { Bot, BotEvent, BotHandler, PlatformInfo } from \"../../adapter.js\";\nimport type { EventsWatcher } from \"../../events.js\";\nimport * as log from \"../../log.js\";\nimport type { Attachment, ChannelStore } from \"../../store.js\";\nimport { createSlackAdapters } from \"./context.js\";\n\n// ============================================================================\n// Exponential backoff utility for Slack API calls\n// ============================================================================\n\n/**\n * Retry a function with exponential backoff on rate limit errors.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries: number = 3,\n  baseDelayMs: number = 1000,\n): Promise<T> {\n  let lastError: Error | undefined;\n  for (let attempt = 0; attempt < maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      // Check for rate limit errors\n      let isRateLimited = false;\n\n      // Check for rate_limited error code (Slack SDK)\n      if (\"code\" in lastError && lastError.code === \"rate_limited\") {\n        isRateLimited = true;\n      }\n\n      // Check for rate_limited in error response\n      if (\"data\" in lastError) {\n        const data = (lastError as { data?: { error?: string; response?: { status?: number } } })\n          .data;\n        if (data?.error === \"rate_limited\" || data?.response?.status === 429) {\n          isRateLimited = true;\n        }\n      }\n\n      if (isRateLimited) {\n        const delay = baseDelayMs * Math.pow(2, attempt);\n        log.logWarning(\n          `Rate limited, retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`,\n        );\n        await new Promise((resolve) => setTimeout(resolve, delay));\n        continue;\n      }\n\n      // Non-retryable error\n      throw lastError;\n    }\n  }\n  throw lastError;\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SlackEvent {\n  type: \"mention\" | \"dm\";\n  channel: string;\n  ts: string;\n  thread_ts?: string;\n  user: string;\n  text: string;\n  files?: Array<{ name?: string; url_private_download?: string; url_private?: string }>;\n  /** Processed attachments with local paths (populated after logUserMessage) */\n  attachments?: Attachment[];\n}\n\nexport interface SlackUser {\n  id: string;\n  userName: string;\n  displayName: string;\n}\n\nexport interface SlackChannel {\n  id: string;\n  name: string;\n}\n\n// Types used by agent.ts\nexport interface ChannelInfo {\n  id: string;\n  name: string;\n}\n\nexport interface UserInfo {\n  id: string;\n  userName: string;\n  displayName: string;\n}\n\nexport interface SlackContext {\n  message: {\n    text: string;\n    rawText: string;\n    user: string;\n    userName?: string;\n    channel: string;\n    ts: string;\n    attachments: Array<{ local: string }>;\n  };\n  channelName?: string;\n  channels: ChannelInfo[];\n  users: UserInfo[];\n  respond: (text: string, shouldLog?: boolean) => Promise<void>;\n  replaceMessage: (text: string) => Promise<void>;\n  respondInThread: (text: string) => Promise<void>;\n  setTyping: (isTyping: boolean) => Promise<void>;\n  uploadFile: (filePath: string, title?: string) => Promise<void>;\n  setWorking: (working: boolean) => Promise<void>;\n  deleteMessage: () => Promise<void>;\n}\n\n/** @deprecated Use BotHandler from adapter.ts instead */\nexport type MomHandler = BotHandler;\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(\"Queue error\", err instanceof Error ? err.message : String(err));\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\n// ============================================================================\n// SlackBot\n// ============================================================================\n\nexport class SlackBot implements Bot {\n  private socketClient: SocketModeClient;\n  private webClient: WebClient;\n  private handler: BotHandler;\n  private workingDir: string;\n  private store: ChannelStore;\n  private botUserId: string | null = null;\n  private startupTs: string | null = null; // Messages older than this are just logged, not processed\n\n  private users = new Map<string, SlackUser>();\n  private channels = new Map<string, SlackChannel>();\n  private queues = new Map<string, ChannelQueue>();\n  private eventsWatcher: EventsWatcher | null = null;\n\n  constructor(\n    handler: BotHandler,\n    config: { appToken: string; botToken: string; workingDir: string; store: ChannelStore },\n  ) {\n    this.handler = handler;\n    this.workingDir = config.workingDir;\n    this.store = config.store;\n    this.socketClient = new SocketModeClient({ appToken: config.appToken });\n    this.webClient = new WebClient(config.botToken);\n  }\n\n  setEventsWatcher(watcher: EventsWatcher): void {\n    this.eventsWatcher = watcher;\n  }\n\n  // ==========================================================================\n  // Public API\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    const auth = await this.webClient.auth.test();\n    this.botUserId = auth.user_id as string;\n\n    await Promise.all([this.fetchUsers(), this.fetchChannels()]);\n    log.logInfo(`Loaded ${this.channels.size} channels, ${this.users.size} users`);\n\n    await this.backfillAllChannels();\n\n    this.setupEventHandlers();\n    await this.socketClient.start();\n\n    // Record startup time - messages older than this are just logged, not processed\n    this.startupTs = (Date.now() / 1000).toFixed(6);\n\n    log.logConnected();\n  }\n\n  getUser(userId: string): SlackUser | undefined {\n    return this.users.get(userId);\n  }\n\n  getChannel(channelId: string): SlackChannel | undefined {\n    return this.channels.get(channelId);\n  }\n\n  getAllUsers(): SlackUser[] {\n    return Array.from(this.users.values());\n  }\n\n  getAllChannels(): SlackChannel[] {\n    return Array.from(this.channels.values());\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    return withRetry(async () => {\n      const result = await this.webClient.chat.postMessage({ channel, text });\n      return result.ts as string;\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return withRetry(async () => {\n      await this.webClient.chat.update({ channel, ts, text });\n    });\n  }\n\n  async deleteMessage(channel: string, ts: string): Promise<void> {\n    return withRetry(async () => {\n      await this.webClient.chat.delete({ channel, ts });\n    });\n  }\n\n  async postInThread(channel: string, threadTs: string, text: string): Promise<string> {\n    return withRetry(async () => {\n      const result = await this.webClient.chat.postMessage({ channel, thread_ts: threadTs, text });\n      return result.ts as string;\n    });\n  }\n\n  async uploadFile(channel: string, filePath: string, title?: string): Promise<void> {\n    return withRetry(async () => {\n      const fileName = title || basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await this.webClient.files.uploadV2({\n        channel_id: channel,\n        file: fileContent,\n        filename: fileName,\n        title: fileName,\n      });\n    });\n  }\n\n  /**\n   * Log a message to log.jsonl (SYNC)\n   * This is the ONLY place messages are written to log.jsonl\n   */\n  logToFile(channel: string, entry: object): void {\n    const dir = join(this.workingDir, channel);\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n    appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n  }\n\n  /**\n   * Log a bot response to log.jsonl\n   */\n  logBotResponse(channel: string, text: string, ts: string, threadTs?: string): void {\n    this.logToFile(channel, {\n      date: new Date().toISOString(),\n      ts,\n      threadTs,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"slack\",\n      formattingGuide:\n        \"## Slack Formatting (mrkdwn, NOT Markdown)\\nBold: *text*, Italic: _text_, Code: `code`, Block: ```code```, Links: <url|text>\\nDo NOT use **double asterisks** or [markdown](links).\",\n      channels: this.getAllChannels().map((c) => ({ id: c.id, name: c.name })),\n      users: this.getAllUsers().map((u) => ({\n        id: u.id,\n        userName: u.userName,\n        displayName: u.displayName,\n      })),\n    };\n  }\n\n  // ==========================================================================\n  // Events Integration\n  // ==========================================================================\n\n  /**\n   * Enqueue an event for processing. Always queues (no \"already working\" rejection).\n   * Returns true if enqueued, false if queue is full (max 5).\n   */\n  enqueueEvent(event: BotEvent): boolean {\n    const queue = this.getQueue(event.channel);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${event.channel}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${event.channel}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const adapters = createSlackAdapters(event as unknown as SlackEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private buildHomeView(): { type: \"home\"; blocks: any[] } {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const blocks: any[] = [\n      {\n        type: \"section\",\n        text: {\n          type: \"mrkdwn\",\n          text: \"*Pi Agent*\\nWelcome back! Start a new task or check on running work.\",\n        },\n        accessory: {\n          type: \"image\",\n          image_url: \"https://media1.tenor.com/m/lfDATg4Bhc0AAAAC/happy-cat.gif\",\n          alt_text: \"Pi Agent\",\n        },\n      },\n    ];\n\n    // --- Running tasks ---\n    const runningSessions = this.handler.getRunningSessions();\n\n    blocks.push(\n      { type: \"divider\" },\n      {\n        type: \"header\",\n        text: {\n          type: \"plain_text\",\n          text: `Running Tasks (${runningSessions.length})`,\n          emoji: true,\n        },\n      },\n    );\n\n    if (runningSessions.length === 0) {\n      blocks.push({\n        type: \"context\",\n        elements: [{ type: \"mrkdwn\", text: \"_No tasks running right now._\" }],\n      });\n    } else {\n      for (const session of runningSessions) {\n        const channelId = session.sessionKey.split(\":\")[0];\n        const channel = this.channels.get(channelId);\n        const channelName = channel ? `#${channel.name}` : channelId;\n        const elapsed = Math.floor((Date.now() - session.startedAt) / 60000);\n        const elapsedStr = elapsed < 1 ? \"<1 min\" : `${elapsed} min`;\n        blocks.push({\n          type: \"section\",\n          text: {\n            type: \"mrkdwn\",\n            text: `*${channelName}*\\n└ 🟢 Running · ${elapsedStr} elapsed`,\n          },\n        });\n      }\n    }\n\n    // --- Cron jobs ---\n    const periodicEvents = this.eventsWatcher?.getPeriodicEvents() ?? [];\n\n    blocks.push(\n      { type: \"divider\" },\n      {\n        type: \"header\",\n        text: {\n          type: \"plain_text\",\n          text: `Scheduled Jobs (${periodicEvents.length})`,\n          emoji: true,\n        },\n      },\n    );\n\n    if (periodicEvents.length === 0) {\n      blocks.push({\n        type: \"context\",\n        elements: [{ type: \"mrkdwn\", text: \"_No scheduled jobs._\" }],\n      });\n    } else {\n      for (const ev of periodicEvents) {\n        const channel = this.channels.get(ev.channelId);\n        const channelName = channel ? `#${channel.name}` : ev.channelId;\n        const nextStr = ev.nextRun\n          ? new Date(ev.nextRun).toLocaleString(\"en-US\", {\n              month: \"short\",\n              day: \"numeric\",\n              hour: \"2-digit\",\n              minute: \"2-digit\",\n            })\n          : \"—\";\n        blocks.push({\n          type: \"section\",\n          text: {\n            type: \"mrkdwn\",\n            text: `*${ev.text}*\\n└ \\`${ev.schedule}\\` · ${channelName} · Next: ${nextStr}`,\n          },\n        });\n      }\n    }\n\n    // --- Footer ---\n    blocks.push(\n      { type: \"divider\" },\n      {\n        type: \"context\",\n        elements: [\n          { type: \"mrkdwn\", text: \"💡 @mention in a channel or send a DM to start a new task\" },\n        ],\n      },\n    );\n\n    return { type: \"home\", blocks };\n  }\n\n  private setupEventHandlers(): void {\n    // Channel @mentions\n    this.socketClient.on(\"app_mention\", ({ event, ack }) => {\n      const e = event as {\n        text: string;\n        channel: string;\n        user: string;\n        ts: string;\n        thread_ts?: string;\n        files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n      };\n\n      // Skip DMs (handled by message event)\n      if (e.channel.startsWith(\"D\")) {\n        ack();\n        return;\n      }\n\n      // Derive session key from thread context\n      const rootTs = e.thread_ts ?? e.ts;\n      const sessionKey = `${e.channel}:${rootTs}`;\n\n      const slackEvent: SlackEvent = {\n        type: \"mention\",\n        channel: e.channel,\n        ts: e.ts,\n        thread_ts: e.thread_ts,\n        user: e.user,\n        text: e.text.replace(/<@[A-Z0-9]+>/gi, \"\").trim(),\n        files: e.files,\n      };\n\n      // SYNC: Log to log.jsonl (ALWAYS, even for old messages)\n      // Also downloads attachments in background and stores local paths\n      slackEvent.attachments = this.logUserMessage(slackEvent);\n\n      // Only trigger processing for messages AFTER startup (not replayed old messages)\n      if (this.startupTs && e.ts < this.startupTs) {\n        log.logInfo(\n          `[${e.channel}] Logged old message (pre-startup), not triggering: ${slackEvent.text.substring(0, 30)}`,\n        );\n        ack();\n        return;\n      }\n\n      // Check for stop command - execute immediately, don't queue!\n      if (slackEvent.text.toLowerCase().trim() === \"stop\") {\n        if (this.handler.isRunning(sessionKey)) {\n          this.handler.handleStop(sessionKey, e.channel, this); // Don't await, don't queue\n        } else {\n          this.postMessage(e.channel, \"_Nothing running_\");\n        }\n        ack();\n        return;\n      }\n\n      // SYNC: Check if busy (per-thread)\n      if (this.handler.isRunning(sessionKey)) {\n        this.postMessage(\n          e.channel,\n          \"_Already working in this thread. Say `@mama stop` to cancel._\",\n        );\n      } else {\n        this.getQueue(sessionKey).enqueue(() => {\n          const adapters = createSlackAdapters(slackEvent, this, false);\n          return this.handler.handleEvent(\n            slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n            this,\n            adapters,\n            false,\n          );\n        });\n      }\n\n      ack();\n    });\n\n    // All messages (for logging) + DMs (for triggering)\n    this.socketClient.on(\"message\", ({ event, ack }) => {\n      const e = event as {\n        text?: string;\n        channel: string;\n        user?: string;\n        ts: string;\n        thread_ts?: string;\n        channel_type?: string;\n        subtype?: string;\n        bot_id?: string;\n        files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n      };\n\n      // Skip bot messages, edits, etc.\n      if (e.bot_id || !e.user || e.user === this.botUserId) {\n        ack();\n        return;\n      }\n      if (e.subtype !== undefined && e.subtype !== \"file_share\") {\n        ack();\n        return;\n      }\n      if (!e.text && (!e.files || e.files.length === 0)) {\n        ack();\n        return;\n      }\n\n      const isDM = e.channel_type === \"im\";\n      const isBotMention = e.text?.includes(`<@${this.botUserId}>`);\n\n      // Skip channel @mentions - already handled by app_mention event\n      if (!isDM && isBotMention) {\n        ack();\n        return;\n      }\n\n      const slackEvent: SlackEvent = {\n        type: isDM ? \"dm\" : \"mention\",\n        channel: e.channel,\n        ts: e.ts,\n        thread_ts: e.thread_ts,\n        user: e.user,\n        text: (e.text || \"\").replace(/<@[A-Z0-9]+>/gi, \"\").trim(),\n        files: e.files,\n      };\n\n      // SYNC: Log to log.jsonl (ALL messages - channel chatter and DMs)\n      // Also downloads attachments in background and stores local paths\n      slackEvent.attachments = this.logUserMessage(slackEvent);\n\n      // Only trigger processing for messages AFTER startup (not replayed old messages)\n      if (this.startupTs && e.ts < this.startupTs) {\n        log.logInfo(\n          `[${e.channel}] Skipping old message (pre-startup): ${slackEvent.text.substring(0, 30)}`,\n        );\n        ack();\n        return;\n      }\n\n      // Only trigger handler for DMs\n      if (isDM) {\n        const dmRootTs = e.thread_ts ?? e.ts;\n        const dmSessionKey = `${e.channel}:${dmRootTs}`;\n\n        // Check for stop command - execute immediately, don't queue!\n        if (slackEvent.text.toLowerCase().trim() === \"stop\") {\n          if (this.handler.isRunning(dmSessionKey)) {\n            this.handler.handleStop(dmSessionKey, e.channel, this); // Don't await, don't queue\n          } else {\n            this.postMessage(e.channel, \"_Nothing running_\");\n          }\n          ack();\n          return;\n        }\n\n        if (this.handler.isRunning(dmSessionKey)) {\n          this.postMessage(e.channel, \"_Already working. Say `stop` to cancel._\");\n        } else {\n          this.getQueue(dmSessionKey).enqueue(() => {\n            const adapters = createSlackAdapters(slackEvent, this, false);\n            return this.handler.handleEvent(\n              slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n              this,\n              adapters,\n              false,\n            );\n          });\n        }\n      }\n\n      ack();\n    });\n\n    // App Home tab\n    this.socketClient.on(\"app_home_opened\", ({ event, ack }) => {\n      const e = event as { user: string; tab: string };\n      ack();\n      if (e.tab !== \"home\") return;\n\n      this.webClient.views\n        .publish({\n          user_id: e.user,\n          view: this.buildHomeView(),\n        })\n        .catch((err) => {\n          log.logWarning(`Failed to publish App Home view`, String(err));\n        });\n    });\n  }\n\n  /**\n   * Log a user message to log.jsonl (SYNC)\n   * Downloads attachments in background via store\n   */\n  private logUserMessage(event: SlackEvent): Attachment[] {\n    const user = this.users.get(event.user);\n    // Process attachments - queues downloads in background\n    const attachments = event.files\n      ? this.store.processAttachments(event.channel, event.files, event.ts)\n      : [];\n    this.logToFile(event.channel, {\n      date: new Date(parseFloat(event.ts) * 1000).toISOString(),\n      ts: event.ts,\n      threadTs: event.thread_ts,\n      user: event.user,\n      userName: user?.userName,\n      displayName: user?.displayName,\n      text: event.text,\n      attachments,\n      isBot: false,\n    });\n    return attachments;\n  }\n\n  // ==========================================================================\n  // Private - Backfill\n  // ==========================================================================\n\n  private async getExistingTimestamps(channelId: string): Promise<Set<string>> {\n    const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n    const timestamps = new Set<string>();\n    if (!existsSync(logPath)) return timestamps;\n\n    const content = await readFile(logPath, \"utf-8\");\n    const lines = content.trim().split(\"\\n\").filter(Boolean);\n    for (const line of lines) {\n      try {\n        const entry = JSON.parse(line);\n        if (entry.ts) timestamps.add(entry.ts);\n      } catch {}\n    }\n    return timestamps;\n  }\n\n  private async backfillChannel(channelId: string): Promise<number> {\n    const existingTs = await this.getExistingTimestamps(channelId);\n\n    // Find the biggest ts in log.jsonl\n    let latestTs: string | undefined;\n    for (const ts of existingTs) {\n      if (!latestTs || parseFloat(ts) > parseFloat(latestTs)) latestTs = ts;\n    }\n\n    type Message = {\n      user?: string;\n      bot_id?: string;\n      text?: string;\n      ts?: string;\n      subtype?: string;\n      files?: Array<{ name: string }>;\n    };\n    const allMessages: Message[] = [];\n\n    let cursor: string | undefined;\n    let pageCount = 0;\n    const maxPages = 3;\n\n    do {\n      const result = await this.webClient.conversations.history({\n        channel: channelId,\n        oldest: latestTs, // Only fetch messages newer than what we have\n        inclusive: false,\n        limit: 1000,\n        cursor,\n      });\n      if (result.messages) {\n        allMessages.push(...(result.messages as Message[]));\n      }\n      cursor = result.response_metadata?.next_cursor;\n      pageCount++;\n    } while (cursor && pageCount < maxPages);\n\n    // Filter: include mama's messages, exclude other bots, skip already logged\n    const relevantMessages = allMessages.filter((msg) => {\n      if (!msg.ts || existingTs.has(msg.ts)) return false; // Skip duplicates\n      if (msg.user === this.botUserId) return true;\n      if (msg.bot_id) return false;\n      if (msg.subtype !== undefined && msg.subtype !== \"file_share\") return false;\n      if (!msg.user) return false;\n      if (!msg.text && (!msg.files || msg.files.length === 0)) return false;\n      return true;\n    });\n\n    // Reverse to chronological order\n    relevantMessages.reverse();\n\n    // Log each message to log.jsonl\n    for (const msg of relevantMessages) {\n      const isMamaMessage = msg.user === this.botUserId;\n      const user = this.users.get(msg.user!);\n      // Strip @mentions from text (same as live messages)\n      const text = (msg.text || \"\").replace(/<@[A-Z0-9]+>/gi, \"\").trim();\n      // Process attachments - queues downloads in background\n      const attachments = msg.files\n        ? this.store.processAttachments(channelId, msg.files, msg.ts!)\n        : [];\n\n      this.logToFile(channelId, {\n        date: new Date(parseFloat(msg.ts!) * 1000).toISOString(),\n        ts: msg.ts!,\n        user: isMamaMessage ? \"bot\" : msg.user!,\n        userName: isMamaMessage ? undefined : user?.userName,\n        displayName: isMamaMessage ? undefined : user?.displayName,\n        text,\n        attachments,\n        isBot: isMamaMessage,\n      });\n    }\n\n    return relevantMessages.length;\n  }\n\n  private async backfillAllChannels(): Promise<void> {\n    const startTime = Date.now();\n\n    // Only backfill channels that already have a log.jsonl (mama has interacted with them before)\n    const channelsToBackfill: Array<[string, SlackChannel]> = [];\n    for (const [channelId, channel] of this.channels) {\n      const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n      if (existsSync(logPath)) {\n        channelsToBackfill.push([channelId, channel]);\n      }\n    }\n\n    log.logBackfillStart(channelsToBackfill.length);\n\n    let totalMessages = 0;\n    for (const [channelId, channel] of channelsToBackfill) {\n      try {\n        const count = await this.backfillChannel(channelId);\n        if (count > 0) log.logBackfillChannel(channel.name, count);\n        totalMessages += count;\n      } catch (error) {\n        log.logWarning(`Failed to backfill #${channel.name}`, String(error));\n      }\n\n      // Add delay between channels to avoid hitting Slack rate limits\n      if (channelId !== channelsToBackfill[channelsToBackfill.length - 1][0]) {\n        await new Promise((resolve) => setTimeout(resolve, 500));\n      }\n    }\n\n    const durationMs = Date.now() - startTime;\n    log.logBackfillComplete(totalMessages, durationMs);\n  }\n\n  // ==========================================================================\n  // Private - Fetch Users/Channels\n  // ==========================================================================\n\n  private async fetchUsers(): Promise<void> {\n    let cursor: string | undefined;\n    do {\n      const result = await this.webClient.users.list({ limit: 200, cursor });\n      const members = result.members as\n        | Array<{ id?: string; name?: string; real_name?: string; deleted?: boolean }>\n        | undefined;\n      if (members) {\n        for (const u of members) {\n          if (u.id && u.name && !u.deleted) {\n            this.users.set(u.id, {\n              id: u.id,\n              userName: u.name,\n              displayName: u.real_name || u.name,\n            });\n          }\n        }\n      }\n      cursor = result.response_metadata?.next_cursor;\n    } while (cursor);\n  }\n\n  private async fetchChannels(): Promise<void> {\n    // Fetch public/private channels\n    let cursor: string | undefined;\n    do {\n      const result = await this.webClient.conversations.list({\n        types: \"public_channel,private_channel\",\n        exclude_archived: true,\n        limit: 200,\n        cursor,\n      });\n      const channels = result.channels as\n        | Array<{ id?: string; name?: string; is_member?: boolean }>\n        | undefined;\n      if (channels) {\n        for (const c of channels) {\n          if (c.id && c.name && c.is_member) {\n            this.channels.set(c.id, { id: c.id, name: c.name });\n          }\n        }\n      }\n      cursor = result.response_metadata?.next_cursor;\n    } while (cursor);\n\n    // Also fetch DM channels (IMs)\n    cursor = undefined;\n    do {\n      const result = await this.webClient.conversations.list({\n        types: \"im\",\n        limit: 200,\n        cursor,\n      });\n      const ims = result.channels as Array<{ id?: string; user?: string }> | undefined;\n      if (ims) {\n        for (const im of ims) {\n          if (im.id) {\n            // Use user's name as channel name for DMs\n            const user = im.user ? this.users.get(im.user) : undefined;\n            const name = user ? `DM:${user.userName}` : `DM:${im.id}`;\n            this.channels.set(im.id, { id: im.id, name });\n          }\n        }\n      }\n      cursor = result.response_metadata?.next_cursor;\n    } while (cursor);\n  }\n}\n"]}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import { SocketModeClient } from \"@slack/socket-mode\";\nimport { WebClient } from \"@slack/web-api\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { basename, join } from \"path\";\nimport type { Bot, BotEvent, BotHandler, PlatformInfo } from \"../../adapter.js\";\nimport type { EventsWatcher } from \"../../events.js\";\nimport * as log from \"../../log.js\";\nimport type { Attachment, ChannelStore } from \"../../store.js\";\nimport { createSlackAdapters } from \"./context.js\";\n\n// ============================================================================\n// Exponential backoff utility for Slack API calls\n// ============================================================================\n\n/**\n * Retry a function with exponential backoff on rate limit errors.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries: number = 3,\n  baseDelayMs: number = 1000,\n): Promise<T> {\n  let lastError: Error | undefined;\n  for (let attempt = 0; attempt < maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      // Check for rate limit errors\n      let isRateLimited = false;\n\n      // Check for rate_limited error code (Slack SDK)\n      if (\"code\" in lastError && lastError.code === \"rate_limited\") {\n        isRateLimited = true;\n      }\n\n      // Check for rate_limited in error response\n      if (\"data\" in lastError) {\n        const data = (lastError as { data?: { error?: string; response?: { status?: number } } })\n          .data;\n        if (data?.error === \"rate_limited\" || data?.response?.status === 429) {\n          isRateLimited = true;\n        }\n      }\n\n      if (isRateLimited) {\n        const delay = baseDelayMs * Math.pow(2, attempt);\n        log.logWarning(\n          `Rate limited, retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`,\n        );\n        await new Promise((resolve) => setTimeout(resolve, delay));\n        continue;\n      }\n\n      // Non-retryable error\n      throw lastError;\n    }\n  }\n  throw lastError;\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SlackEvent {\n  type: \"mention\" | \"dm\";\n  channel: string;\n  ts: string;\n  thread_ts?: string;\n  user: string;\n  text: string;\n  files?: Array<{ name?: string; url_private_download?: string; url_private?: string }>;\n  /** Processed attachments with local paths (populated after logUserMessage) */\n  attachments?: Attachment[];\n}\n\nexport interface SlackUser {\n  id: string;\n  userName: string;\n  displayName: string;\n}\n\nexport interface SlackChannel {\n  id: string;\n  name: string;\n}\n\n// Types used by agent.ts\nexport interface ChannelInfo {\n  id: string;\n  name: string;\n}\n\nexport interface UserInfo {\n  id: string;\n  userName: string;\n  displayName: string;\n}\n\nexport interface SlackContext {\n  message: {\n    text: string;\n    rawText: string;\n    user: string;\n    userName?: string;\n    channel: string;\n    ts: string;\n    attachments: Array<{ local: string }>;\n  };\n  channelName?: string;\n  channels: ChannelInfo[];\n  users: UserInfo[];\n  respond: (text: string, shouldLog?: boolean) => Promise<void>;\n  replaceMessage: (text: string) => Promise<void>;\n  respondInThread: (text: string) => Promise<void>;\n  setTyping: (isTyping: boolean) => Promise<void>;\n  uploadFile: (filePath: string, title?: string) => Promise<void>;\n  setWorking: (working: boolean) => Promise<void>;\n  deleteMessage: () => Promise<void>;\n}\n\n/** @deprecated Use BotHandler from adapter.ts instead */\nexport type MomHandler = BotHandler;\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(\"Queue error\", err instanceof Error ? err.message : String(err));\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\n// ============================================================================\n// SlackBot\n// ============================================================================\n\nexport class SlackBot implements Bot {\n  private socketClient: SocketModeClient;\n  private webClient: WebClient;\n  private handler: BotHandler;\n  private workingDir: string;\n  private store: ChannelStore;\n  private botUserId: string | null = null;\n  private startupTs: string | null = null; // Messages older than this are just logged, not processed\n\n  private users = new Map<string, SlackUser>();\n  private channels = new Map<string, SlackChannel>();\n  private queues = new Map<string, ChannelQueue>();\n  private eventsWatcher: EventsWatcher | null = null;\n\n  constructor(\n    handler: BotHandler,\n    config: { appToken: string; botToken: string; workingDir: string; store: ChannelStore },\n  ) {\n    this.handler = handler;\n    this.workingDir = config.workingDir;\n    this.store = config.store;\n    this.socketClient = new SocketModeClient({ appToken: config.appToken });\n    this.webClient = new WebClient(config.botToken);\n  }\n\n  setEventsWatcher(watcher: EventsWatcher): void {\n    this.eventsWatcher = watcher;\n  }\n\n  // ==========================================================================\n  // Public API\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    const auth = await this.webClient.auth.test();\n    this.botUserId = auth.user_id as string;\n\n    await Promise.all([this.fetchUsers(), this.fetchChannels()]);\n    log.logInfo(`Loaded ${this.channels.size} channels, ${this.users.size} users`);\n\n    await this.backfillAllChannels();\n\n    this.setupEventHandlers();\n    await this.socketClient.start();\n\n    // Record startup time - messages older than this are just logged, not processed\n    this.startupTs = (Date.now() / 1000).toFixed(6);\n\n    log.logConnected();\n  }\n\n  getUser(userId: string): SlackUser | undefined {\n    return this.users.get(userId);\n  }\n\n  getChannel(channelId: string): SlackChannel | undefined {\n    return this.channels.get(channelId);\n  }\n\n  getAllUsers(): SlackUser[] {\n    return Array.from(this.users.values());\n  }\n\n  getAllChannels(): SlackChannel[] {\n    return Array.from(this.channels.values());\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    return withRetry(async () => {\n      const result = await this.webClient.chat.postMessage({ channel, text });\n      return result.ts as string;\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return withRetry(async () => {\n      await this.webClient.chat.update({ channel, ts, text });\n    });\n  }\n\n  async deleteMessage(channel: string, ts: string): Promise<void> {\n    return withRetry(async () => {\n      await this.webClient.chat.delete({ channel, ts });\n    });\n  }\n\n  async postInThread(channel: string, threadTs: string, text: string): Promise<string> {\n    return withRetry(async () => {\n      const result = await this.webClient.chat.postMessage({ channel, thread_ts: threadTs, text });\n      return result.ts as string;\n    });\n  }\n\n  async uploadFile(\n    channel: string,\n    filePath: string,\n    title?: string,\n    threadTs?: string,\n  ): Promise<void> {\n    return withRetry(async () => {\n      const fileName = title || basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await this.webClient.files.uploadV2({\n        channel_id: channel,\n        file: fileContent,\n        filename: fileName,\n        title: fileName,\n        ...(threadTs ? { thread_ts: threadTs } : {}),\n      } as Parameters<typeof this.webClient.files.uploadV2>[0]);\n    });\n  }\n\n  /**\n   * Log a message to log.jsonl (SYNC)\n   * This is the ONLY place messages are written to log.jsonl\n   */\n  logToFile(channel: string, entry: object): void {\n    const dir = join(this.workingDir, channel);\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n    appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n  }\n\n  /**\n   * Log a bot response to log.jsonl\n   */\n  logBotResponse(channel: string, text: string, ts: string, threadTs?: string): void {\n    this.logToFile(channel, {\n      date: new Date().toISOString(),\n      ts,\n      threadTs,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"slack\",\n      formattingGuide:\n        \"## Slack Formatting (mrkdwn, NOT Markdown)\\nBold: *text*, Italic: _text_, Code: `code`, Block: ```code```, Links: <url|text>\\nDo NOT use **double asterisks** or [markdown](links).\",\n      channels: this.getAllChannels().map((c) => ({ id: c.id, name: c.name })),\n      users: this.getAllUsers().map((u) => ({\n        id: u.id,\n        userName: u.userName,\n        displayName: u.displayName,\n      })),\n    };\n  }\n\n  // ==========================================================================\n  // Events Integration\n  // ==========================================================================\n\n  /**\n   * Enqueue an event for processing. Always queues (no \"already working\" rejection).\n   * Returns true if enqueued, false if queue is full (max 5).\n   */\n  enqueueEvent(event: BotEvent): boolean {\n    const queue = this.getQueue(event.channel);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${event.channel}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${event.channel}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const adapters = createSlackAdapters(event as unknown as SlackEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private buildHomeView(): { type: \"home\"; blocks: any[] } {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const blocks: any[] = [\n      {\n        type: \"section\",\n        text: {\n          type: \"mrkdwn\",\n          text: \"*Pi Agent*\\nWelcome back! Start a new task or check on running work.\",\n        },\n        accessory: {\n          type: \"image\",\n          image_url: \"https://media1.tenor.com/m/lfDATg4Bhc0AAAAC/happy-cat.gif\",\n          alt_text: \"Pi Agent\",\n        },\n      },\n    ];\n\n    // --- Running tasks ---\n    const runningSessions = this.handler.getRunningSessions();\n\n    blocks.push(\n      { type: \"divider\" },\n      {\n        type: \"header\",\n        text: {\n          type: \"plain_text\",\n          text: `Running Tasks (${runningSessions.length})`,\n          emoji: true,\n        },\n      },\n    );\n\n    if (runningSessions.length === 0) {\n      blocks.push({\n        type: \"context\",\n        elements: [{ type: \"mrkdwn\", text: \"_No tasks running right now._\" }],\n      });\n    } else {\n      // Threshold for \"stuck\" detection (10 minutes)\n      const STUCK_THRESHOLD_MS = 10 * 60 * 1000;\n\n      for (const session of runningSessions) {\n        const channelId = session.sessionKey.split(\":\")[0];\n        const channel = this.channels.get(channelId);\n        const channelName = channel ? `#${channel.name}` : channelId;\n        const elapsed = Math.floor((Date.now() - session.startedAt) / 60000);\n        const elapsedStr = elapsed < 1 ? \"<1 min\" : `${elapsed} min`;\n\n        // Check if task might be stuck\n        const lastActivity = session.lastActivityAt ? Date.now() - session.lastActivityAt : 0;\n        const isStuck = lastActivity > STUCK_THRESHOLD_MS;\n        const statusText = isStuck ? \"_stuck_\" : \"_running_\";\n\n        // Build status line: channel · status · time · step\n        let statusLine = `${statusText} · ${elapsedStr}`;\n        if (session.currentTool) {\n          statusLine += ` · ${session.currentTool}`;\n        }\n        if (isStuck && lastActivity > 0) {\n          const inactiveMin = Math.floor(lastActivity / 60000);\n          statusLine += ` · idle ${inactiveMin}m`;\n        }\n\n        // Use context block for gray small text (like \"No scheduled jobs.\")\n        blocks.push({\n          type: \"context\",\n          elements: [\n            {\n              type: \"mrkdwn\",\n              text: `*${channelName}* · ${statusLine}`,\n            },\n          ],\n        });\n\n        // Add Force Stop button as separate element if stuck\n        if (isStuck) {\n          blocks.push({\n            type: \"context\",\n            elements: [\n              {\n                type: \"mrkdwn\",\n                text: \" \",\n              },\n              {\n                type: \"button\",\n                text: { type: \"plain_text\", text: \"Force Stop\", emoji: true },\n                action_id: `force_stop_${session.sessionKey.replace(/:/g, \"_\")}`,\n                style: \"danger\",\n              },\n            ],\n          });\n        }\n      }\n    }\n\n    // --- Cron jobs ---\n    const periodicEvents = this.eventsWatcher?.getPeriodicEvents() ?? [];\n\n    blocks.push(\n      { type: \"divider\" },\n      {\n        type: \"header\",\n        text: {\n          type: \"plain_text\",\n          text: `Scheduled Jobs (${periodicEvents.length})`,\n          emoji: true,\n        },\n      },\n    );\n\n    if (periodicEvents.length === 0) {\n      blocks.push({\n        type: \"context\",\n        elements: [{ type: \"mrkdwn\", text: \"_No scheduled jobs._\" }],\n      });\n    } else {\n      for (const ev of periodicEvents) {\n        const channel = this.channels.get(ev.channelId);\n        const channelName = channel ? `#${channel.name}` : ev.channelId;\n        const nextStr = ev.nextRun\n          ? new Date(ev.nextRun).toLocaleString(\"en-US\", {\n              month: \"short\",\n              day: \"numeric\",\n              hour: \"2-digit\",\n              minute: \"2-digit\",\n            })\n          : \"—\";\n        blocks.push({\n          type: \"section\",\n          text: {\n            type: \"mrkdwn\",\n            text: `*${ev.text}*\\n└ \\`${ev.schedule}\\` · ${channelName} · Next: ${nextStr}`,\n          },\n        });\n      }\n    }\n\n    // --- Footer ---\n    blocks.push(\n      { type: \"divider\" },\n      {\n        type: \"context\",\n        elements: [\n          { type: \"mrkdwn\", text: \"💡 @mention in a channel or send a DM to start a new task\" },\n        ],\n      },\n    );\n\n    return { type: \"home\", blocks };\n  }\n\n  private setupEventHandlers(): void {\n    // Channel @mentions\n    this.socketClient.on(\"app_mention\", ({ event, ack }) => {\n      const e = event as {\n        text: string;\n        channel: string;\n        user: string;\n        ts: string;\n        thread_ts?: string;\n        files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n      };\n\n      // Skip DMs (handled by message event)\n      if (e.channel.startsWith(\"D\")) {\n        ack();\n        return;\n      }\n\n      // Derive session key from thread context\n      const rootTs = e.thread_ts ?? e.ts;\n      const sessionKey = `${e.channel}:${rootTs}`;\n\n      const slackEvent: SlackEvent = {\n        type: \"mention\",\n        channel: e.channel,\n        ts: e.ts,\n        thread_ts: e.thread_ts,\n        user: e.user,\n        text: e.text.replace(/<@[A-Z0-9]+>/gi, \"\").trim(),\n        files: e.files,\n      };\n\n      // SYNC: Log to log.jsonl (ALWAYS, even for old messages)\n      // Also downloads attachments in background and stores local paths\n      slackEvent.attachments = this.logUserMessage(slackEvent);\n\n      // Only trigger processing for messages AFTER startup (not replayed old messages)\n      if (this.startupTs && e.ts < this.startupTs) {\n        log.logInfo(\n          `[${e.channel}] Logged old message (pre-startup), not triggering: ${slackEvent.text.substring(0, 30)}`,\n        );\n        ack();\n        return;\n      }\n\n      // Check for stop command - execute immediately, don't queue!\n      if (slackEvent.text.toLowerCase().trim() === \"stop\") {\n        if (this.handler.isRunning(sessionKey)) {\n          this.handler.handleStop(sessionKey, e.channel, this); // Don't await, don't queue\n        } else {\n          this.postMessage(e.channel, \"_Nothing running_\");\n        }\n        ack();\n        return;\n      }\n\n      // SYNC: Check if busy (per-thread)\n      if (this.handler.isRunning(sessionKey)) {\n        this.postMessage(\n          e.channel,\n          \"_Already working in this thread. Say `@mama stop` to cancel._\",\n        );\n      } else {\n        this.getQueue(sessionKey).enqueue(() => {\n          const adapters = createSlackAdapters(slackEvent, this, false);\n          return this.handler.handleEvent(\n            slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n            this,\n            adapters,\n            false,\n          );\n        });\n      }\n\n      ack();\n    });\n\n    // All messages (for logging) + DMs (for triggering)\n    this.socketClient.on(\"message\", ({ event, ack }) => {\n      const e = event as {\n        text?: string;\n        channel: string;\n        user?: string;\n        ts: string;\n        thread_ts?: string;\n        channel_type?: string;\n        subtype?: string;\n        bot_id?: string;\n        files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n      };\n\n      // Skip bot messages, edits, etc.\n      if (e.bot_id || !e.user || e.user === this.botUserId) {\n        ack();\n        return;\n      }\n      if (e.subtype !== undefined && e.subtype !== \"file_share\") {\n        ack();\n        return;\n      }\n      if (!e.text && (!e.files || e.files.length === 0)) {\n        ack();\n        return;\n      }\n\n      const isDM = e.channel_type === \"im\";\n      const isBotMention = e.text?.includes(`<@${this.botUserId}>`);\n\n      // Skip channel @mentions - already handled by app_mention event\n      if (!isDM && isBotMention) {\n        ack();\n        return;\n      }\n\n      const slackEvent: SlackEvent = {\n        type: isDM ? \"dm\" : \"mention\",\n        channel: e.channel,\n        ts: e.ts,\n        thread_ts: e.thread_ts,\n        user: e.user,\n        text: (e.text || \"\").replace(/<@[A-Z0-9]+>/gi, \"\").trim(),\n        files: e.files,\n      };\n\n      // SYNC: Log to log.jsonl (ALL messages - channel chatter and DMs)\n      // Also downloads attachments in background and stores local paths\n      slackEvent.attachments = this.logUserMessage(slackEvent);\n\n      // Only trigger processing for messages AFTER startup (not replayed old messages)\n      if (this.startupTs && e.ts < this.startupTs) {\n        log.logInfo(\n          `[${e.channel}] Skipping old message (pre-startup): ${slackEvent.text.substring(0, 30)}`,\n        );\n        ack();\n        return;\n      }\n\n      // Only trigger handler for DMs\n      if (isDM) {\n        const dmRootTs = e.thread_ts ?? e.ts;\n        const dmSessionKey = `${e.channel}:${dmRootTs}`;\n\n        // Check for stop command - execute immediately, don't queue!\n        if (slackEvent.text.toLowerCase().trim() === \"stop\") {\n          if (this.handler.isRunning(dmSessionKey)) {\n            this.handler.handleStop(dmSessionKey, e.channel, this); // Don't await, don't queue\n          } else {\n            this.postMessage(e.channel, \"_Nothing running_\");\n          }\n          ack();\n          return;\n        }\n\n        if (this.handler.isRunning(dmSessionKey)) {\n          this.postMessage(e.channel, \"_Already working. Say `stop` to cancel._\");\n        } else {\n          this.getQueue(dmSessionKey).enqueue(() => {\n            const adapters = createSlackAdapters(slackEvent, this, false);\n            return this.handler.handleEvent(\n              slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n              this,\n              adapters,\n              false,\n            );\n          });\n        }\n      }\n\n      ack();\n    });\n\n    // App Home tab\n    this.socketClient.on(\"app_home_opened\", ({ event, ack }) => {\n      const e = event as { user: string; tab: string };\n      ack();\n      if (e.tab !== \"home\") return;\n\n      this.webClient.views\n        .publish({\n          user_id: e.user,\n          view: this.buildHomeView(),\n        })\n        .catch((err) => {\n          log.logWarning(`Failed to publish App Home view`, String(err));\n        });\n    });\n\n    // Handle button clicks (Force Stop)\n    this.socketClient.on(\"block_actions\", async ({ body, ack }) => {\n      const action = body.actions?.[0];\n      if (!action || !action.action_id?.startsWith(\"force_stop_\")) {\n        ack();\n        return;\n      }\n\n      ack();\n      const sessionKey = action.action_id.replace(\"force_stop_\", \"\").replace(/_/g, \":\");\n      const userId = body.user?.id;\n      const channelId = body.container?.channel_id || sessionKey.split(\":\")[0];\n\n      log.logInfo(`[Force Stop] User ${userId} requested force stop for ${sessionKey}`);\n\n      // Use handler's forceStop method\n      this.handler.forceStop(sessionKey);\n\n      // Notify in channel\n      await this.postMessage(channelId, `_🔴 Force stopped by ${userId}_`);\n\n      // Refresh home tab\n      if (userId) {\n        this.webClient.views\n          .publish({\n            user_id: userId,\n            view: this.buildHomeView(),\n          })\n          .catch((err) => {\n            log.logWarning(`Failed to refresh App Home view`, String(err));\n          });\n      }\n    });\n  }\n\n  /**\n   * Log a user message to log.jsonl (SYNC)\n   * Downloads attachments in background via store\n   */\n  private logUserMessage(event: SlackEvent): Attachment[] {\n    const user = this.users.get(event.user);\n    // Process attachments - queues downloads in background\n    const attachments = event.files\n      ? this.store.processAttachments(event.channel, event.files, event.ts)\n      : [];\n    this.logToFile(event.channel, {\n      date: new Date(parseFloat(event.ts) * 1000).toISOString(),\n      ts: event.ts,\n      threadTs: event.thread_ts,\n      user: event.user,\n      userName: user?.userName,\n      displayName: user?.displayName,\n      text: event.text,\n      attachments,\n      isBot: false,\n    });\n    return attachments;\n  }\n\n  // ==========================================================================\n  // Private - Backfill\n  // ==========================================================================\n\n  private async getExistingTimestamps(channelId: string): Promise<Set<string>> {\n    const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n    const timestamps = new Set<string>();\n    if (!existsSync(logPath)) return timestamps;\n\n    const content = await readFile(logPath, \"utf-8\");\n    const lines = content.trim().split(\"\\n\").filter(Boolean);\n    for (const line of lines) {\n      try {\n        const entry = JSON.parse(line);\n        if (entry.ts) timestamps.add(entry.ts);\n      } catch {}\n    }\n    return timestamps;\n  }\n\n  private async backfillChannel(channelId: string): Promise<number> {\n    const existingTs = await this.getExistingTimestamps(channelId);\n\n    // Find the biggest ts in log.jsonl\n    let latestTs: string | undefined;\n    for (const ts of existingTs) {\n      if (!latestTs || parseFloat(ts) > parseFloat(latestTs)) latestTs = ts;\n    }\n\n    type Message = {\n      user?: string;\n      bot_id?: string;\n      text?: string;\n      ts?: string;\n      subtype?: string;\n      files?: Array<{ name: string }>;\n    };\n    const allMessages: Message[] = [];\n\n    let cursor: string | undefined;\n    let pageCount = 0;\n    const maxPages = 3;\n\n    do {\n      const result = await this.webClient.conversations.history({\n        channel: channelId,\n        oldest: latestTs, // Only fetch messages newer than what we have\n        inclusive: false,\n        limit: 1000,\n        cursor,\n      });\n      if (result.messages) {\n        allMessages.push(...(result.messages as Message[]));\n      }\n      cursor = result.response_metadata?.next_cursor;\n      pageCount++;\n    } while (cursor && pageCount < maxPages);\n\n    // Filter: include mama's messages, exclude other bots, skip already logged\n    const relevantMessages = allMessages.filter((msg) => {\n      if (!msg.ts || existingTs.has(msg.ts)) return false; // Skip duplicates\n      if (msg.user === this.botUserId) return true;\n      if (msg.bot_id) return false;\n      if (msg.subtype !== undefined && msg.subtype !== \"file_share\") return false;\n      if (!msg.user) return false;\n      if (!msg.text && (!msg.files || msg.files.length === 0)) return false;\n      return true;\n    });\n\n    // Reverse to chronological order\n    relevantMessages.reverse();\n\n    // Log each message to log.jsonl\n    for (const msg of relevantMessages) {\n      const isMamaMessage = msg.user === this.botUserId;\n      const user = this.users.get(msg.user!);\n      // Strip @mentions from text (same as live messages)\n      const text = (msg.text || \"\").replace(/<@[A-Z0-9]+>/gi, \"\").trim();\n      // Process attachments - queues downloads in background\n      const attachments = msg.files\n        ? this.store.processAttachments(channelId, msg.files, msg.ts!)\n        : [];\n\n      this.logToFile(channelId, {\n        date: new Date(parseFloat(msg.ts!) * 1000).toISOString(),\n        ts: msg.ts!,\n        user: isMamaMessage ? \"bot\" : msg.user!,\n        userName: isMamaMessage ? undefined : user?.userName,\n        displayName: isMamaMessage ? undefined : user?.displayName,\n        text,\n        attachments,\n        isBot: isMamaMessage,\n      });\n    }\n\n    return relevantMessages.length;\n  }\n\n  private async backfillAllChannels(): Promise<void> {\n    const startTime = Date.now();\n\n    // Only backfill channels that already have a log.jsonl (mama has interacted with them before)\n    const channelsToBackfill: Array<[string, SlackChannel]> = [];\n    for (const [channelId, channel] of this.channels) {\n      const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n      if (existsSync(logPath)) {\n        channelsToBackfill.push([channelId, channel]);\n      }\n    }\n\n    log.logBackfillStart(channelsToBackfill.length);\n\n    let totalMessages = 0;\n    for (const [channelId, channel] of channelsToBackfill) {\n      try {\n        const count = await this.backfillChannel(channelId);\n        if (count > 0) log.logBackfillChannel(channel.name, count);\n        totalMessages += count;\n      } catch (error) {\n        log.logWarning(`Failed to backfill #${channel.name}`, String(error));\n      }\n\n      // Add delay between channels to avoid hitting Slack rate limits\n      if (channelId !== channelsToBackfill[channelsToBackfill.length - 1][0]) {\n        await new Promise((resolve) => setTimeout(resolve, 500));\n      }\n    }\n\n    const durationMs = Date.now() - startTime;\n    log.logBackfillComplete(totalMessages, durationMs);\n  }\n\n  // ==========================================================================\n  // Private - Fetch Users/Channels\n  // ==========================================================================\n\n  private async fetchUsers(): Promise<void> {\n    let cursor: string | undefined;\n    do {\n      const result = await this.webClient.users.list({ limit: 200, cursor });\n      const members = result.members as\n        | Array<{ id?: string; name?: string; real_name?: string; deleted?: boolean }>\n        | undefined;\n      if (members) {\n        for (const u of members) {\n          if (u.id && u.name && !u.deleted) {\n            this.users.set(u.id, {\n              id: u.id,\n              userName: u.name,\n              displayName: u.real_name || u.name,\n            });\n          }\n        }\n      }\n      cursor = result.response_metadata?.next_cursor;\n    } while (cursor);\n  }\n\n  private async fetchChannels(): Promise<void> {\n    // Fetch public/private channels\n    let cursor: string | undefined;\n    do {\n      const result = await this.webClient.conversations.list({\n        types: \"public_channel,private_channel\",\n        exclude_archived: true,\n        limit: 200,\n        cursor,\n      });\n      const channels = result.channels as\n        | Array<{ id?: string; name?: string; is_member?: boolean }>\n        | undefined;\n      if (channels) {\n        for (const c of channels) {\n          if (c.id && c.name && c.is_member) {\n            this.channels.set(c.id, { id: c.id, name: c.name });\n          }\n        }\n      }\n      cursor = result.response_metadata?.next_cursor;\n    } while (cursor);\n\n    // Also fetch DM channels (IMs)\n    cursor = undefined;\n    do {\n      const result = await this.webClient.conversations.list({\n        types: \"im\",\n        limit: 200,\n        cursor,\n      });\n      const ims = result.channels as Array<{ id?: string; user?: string }> | undefined;\n      if (ims) {\n        for (const im of ims) {\n          if (im.id) {\n            // Use user's name as channel name for DMs\n            const user = im.user ? this.users.get(im.user) : undefined;\n            const name = user ? `DM:${user.userName}` : `DM:${im.id}`;\n            this.channels.set(im.id, { id: im.id, name });\n          }\n        }\n      }\n      cursor = result.response_metadata?.next_cursor;\n    } while (cursor);\n  }\n}\n"]}

package/dist/adapters/slack/bot.js

@@ -141,7 +141,7 @@ export class SlackBot {
             return result.ts;
         });
     }
-    async uploadFile(channel, filePath, title) {
+    async uploadFile(channel, filePath, title, threadTs) {
         return withRetry(async () => {
             const fileName = title || basename(filePath);
             const fileContent = readFileSync(filePath);
@@ -150,6 +150,7 @@ export class SlackBot {
                 file: fileContent,
                 filename: fileName,
                 title: fileName,
+                ...(threadTs ? { thread_ts: threadTs } : {}),
             });
         });
     }
@@ -254,19 +255,55 @@ export class SlackBot {
             });
         }
         else {
+            // Threshold for "stuck" detection (10 minutes)
+            const STUCK_THRESHOLD_MS = 10 * 60 * 1000;
             for (const session of runningSessions) {
                 const channelId = session.sessionKey.split(":")[0];
                 const channel = this.channels.get(channelId);
                 const channelName = channel ? `#${channel.name}` : channelId;
                 const elapsed = Math.floor((Date.now() - session.startedAt) / 60000);
                 const elapsedStr = elapsed < 1 ? "<1 min" : `${elapsed} min`;
+                // Check if task might be stuck
+                const lastActivity = session.lastActivityAt ? Date.now() - session.lastActivityAt : 0;
+                const isStuck = lastActivity > STUCK_THRESHOLD_MS;
+                const statusText = isStuck ? "_stuck_" : "_running_";
+                // Build status line: channel · status · time · step
+                let statusLine = `${statusText} · ${elapsedStr}`;
+                if (session.currentTool) {
+                    statusLine += ` · ${session.currentTool}`;
+                }
+                if (isStuck && lastActivity > 0) {
+                    const inactiveMin = Math.floor(lastActivity / 60000);
+                    statusLine += ` · idle ${inactiveMin}m`;
+                }
+                // Use context block for gray small text (like "No scheduled jobs.")
                 blocks.push({
-                    type: "section",
-                    text: {
-                        type: "mrkdwn",
-                        text: `*${channelName}*\n└ 🟢 Running · ${elapsedStr} elapsed`,
-                    },
+                    type: "context",
+                    elements: [
+                        {
+                            type: "mrkdwn",
+                            text: `*${channelName}* · ${statusLine}`,
+                        },
+                    ],
                 });
+                // Add Force Stop button as separate element if stuck
+                if (isStuck) {
+                    blocks.push({
+                        type: "context",
+                        elements: [
+                            {
+                                type: "mrkdwn",
+                                text: " ",
+                            },
+                            {
+                                type: "button",
+                                text: { type: "plain_text", text: "Force Stop", emoji: true },
+                                action_id: `force_stop_${session.sessionKey.replace(/:/g, "_")}`,
+                                style: "danger",
+                            },
+                        ],
+                    });
+                }
             }
         }
         // --- Cron jobs ---
@@ -451,6 +488,34 @@ export class SlackBot {
                 log.logWarning(`Failed to publish App Home view`, String(err));
             });
         });
+        // Handle button clicks (Force Stop)
+        this.socketClient.on("block_actions", async ({ body, ack }) => {
+            const action = body.actions?.[0];
+            if (!action || !action.action_id?.startsWith("force_stop_")) {
+                ack();
+                return;
+            }
+            ack();
+            const sessionKey = action.action_id.replace("force_stop_", "").replace(/_/g, ":");
+            const userId = body.user?.id;
+            const channelId = body.container?.channel_id || sessionKey.split(":")[0];
+            log.logInfo(`[Force Stop] User ${userId} requested force stop for ${sessionKey}`);
+            // Use handler's forceStop method
+            this.handler.forceStop(sessionKey);
+            // Notify in channel
+            await this.postMessage(channelId, `_🔴 Force stopped by ${userId}_`);
+            // Refresh home tab
+            if (userId) {
+                this.webClient.views
+                    .publish({
+                    user_id: userId,
+                    view: this.buildHomeView(),
+                })
+                    .catch((err) => {
+                    log.logWarning(`Failed to refresh App Home view`, String(err));
+                });
+            }
+        });
     }
     /**
      * Log a user message to log.jsonl (SYNC)