@geminixiang/mikan 0.3.1 → 0.4.0-beta.0

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helpers shared across platform adapters.\n *\n * The agent runner is platform-agnostic: it hands strings and structured tool\n * results to each adapter, which decides how to split, format, and route them.\n * The split/normalize logic itself doesn't differ across platforms — only the\n * markup wrappers — so it lives here once.\n */\n\nimport { appendFileSync } from \"fs\";\nimport { join } from \"path\";\nimport type { BotHandler } from \"../adapter.js\";\nimport { ensureDirExists } from \"../file-guards.js\";\nimport * as log from \"../log.js\";\nimport { reportUserFacingError } from \"../sentry.js\";\n\nexport type ChatResponseErrorOperation =\n  | \"respond\"\n  | \"replace_response\"\n  | \"respond_diagnostic\"\n  | \"set_working\";\n\nexport interface ChatResponseErrorContext {\n  platform: string;\n  conversationId: string;\n  messageId: string;\n  sessionKey: string;\n  conversationKind: string;\n  operation: ChatResponseErrorOperation;\n  channelId?: string;\n  chatId?: number;\n  responseMessageId?: string | number | null;\n  threadTs?: string;\n  replyTargetId?: string;\n  replyToId?: number | null;\n  isThreaded?: boolean;\n  extra?: Record<string, unknown>;\n}\n\nexport type ChatResponseErrorReporter = (\n  err: unknown,\n  operation: ChatResponseErrorOperation,\n  extra?: Record<string, unknown>,\n) => void;\n\nexport function createChatResponseErrorReporter(\n  resolve: () => Omit<ChatResponseErrorContext, \"operation\" | \"extra\">,\n): ChatResponseErrorReporter {\n  return (err, operation, extra) => {\n    reportChatResponseError(err, { ...resolve(), operation, extra });\n  };\n}\n\nfunction reportChatResponseError(err: unknown, context: ChatResponseErrorContext): void {\n  reportUserFacingError(err, {\n    domain: \"chat_platform\",\n    surface: \"chat_response\",\n    operation: context.operation,\n    severity: context.operation === \"set_working\" ? \"warning\" : \"error\",\n    platform: context.platform,\n    context: {\n      conversationId: context.conversationId,\n      channelId: context.channelId,\n      chatId: context.chatId,\n      messageId: context.messageId,\n      sessionKey: context.sessionKey,\n      responseMessageId: context.responseMessageId,\n      threadTs: context.threadTs,\n      replyTargetId: context.replyTargetId,\n      replyToId: context.replyToId,\n      conversationKind: context.conversationKind,\n      isThreaded: context.isThreaded,\n      ...context.extra,\n    },\n  });\n}\n\nexport class ChannelQueue {\n  private queue: Array<() => Promise<void>> = [];\n  private processing = false;\n\n  constructor(private readonly name: string = \"\") {}\n\n  enqueue(work: () => Promise<void>): void {\n    this.queue.push(work);\n    this.processNext();\n  }\n\n  size(): number {\n    return this.queue.length;\n  }\n\n  private async processNext(): Promise<void> {\n    if (this.processing || this.queue.length === 0) return;\n    this.processing = true;\n    const work = this.queue.shift()!;\n    try {\n      await work();\n    } catch (err) {\n      log.logWarning(\n        `${this.name ? this.name + \" \" : \"\"}queue error`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\nexport interface RetryOptions {\n  /** Predicate that returns true when an error is worth retrying (rate limit, transient 5xx, etc.). */\n  isRateLimited: (err: Error) => boolean;\n  /** Total attempts including the first call. */\n  maxAttempts?: number;\n  baseDelayMs?: number;\n}\n\n/**\n * Run `fn` and retry with exponential backoff when its error matches\n * `isRateLimited`. Other errors propagate immediately. Each platform supplies\n * its own predicate so we don't have to know every SDK's error shape here.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions): Promise<T> {\n  const maxAttempts = opts.maxAttempts ?? 3;\n  const baseDelayMs = opts.baseDelayMs ?? 1000;\n  let lastError: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      const isLastAttempt = attempt === maxAttempts - 1;\n      if (isLastAttempt || !opts.isRateLimited(lastError)) {\n        throw lastError;\n      }\n\n      const delay = baseDelayMs * Math.pow(2, attempt);\n      log.logWarning(\n        `Retrying after error in ${delay}ms (attempt ${attempt + 1}/${maxAttempts}): ${lastError.message}`,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Split `text` into chunks no larger than `limit`, appending a continuation\n * marker (e.g. `_(continued 1)_`) at the end of every part except the last.\n *\n * Each adapter passes its own `formatContinuation` so the marker uses the\n * platform's italic / emphasis convention.\n */\nexport function splitText(\n  text: string,\n  limit: number,\n  formatContinuation: (partNum: number) => string,\n): string[] {\n  if (text.length <= limit) return [text];\n  const parts: string[] = [];\n  let remaining = text;\n  let partNum = 1;\n  while (remaining.length > 0) {\n    const suffixReserve = formatContinuation(partNum).length + 8;\n    const chunkLimit = Math.max(1, limit - suffixReserve);\n    const chunk = remaining.slice(0, chunkLimit);\n    remaining = remaining.slice(chunkLimit);\n    const suffix = remaining.length > 0 ? `\\n${formatContinuation(partNum)}` : \"\";\n    parts.push(chunk + suffix);\n    partNum++;\n  }\n  return parts;\n}\n\n/**\n * Append a JSON-serializable entry to `${workingDir}/${channel}/log.jsonl`,\n * creating the directory on first use. This is the single write path every\n * adapter uses for human-readable message history.\n */\nexport function appendChannelLog(workingDir: string, channel: string, entry: object): void {\n  const dir = join(workingDir, channel);\n  ensureDirExists(dir);\n  appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n}\n\n/** Convenience for appending the bot's own outbound message. */\nexport function appendBotResponseLog(\n  workingDir: string,\n  channel: string,\n  text: string,\n  ts: string,\n  threadTs?: string,\n  extraFields: Record<string, unknown> = {},\n): void {\n  appendChannelLog(workingDir, channel, {\n    date: new Date().toISOString(),\n    ts,\n    ...(threadTs ? { threadTs } : {}),\n    user: \"bot\",\n    text,\n    attachments: [],\n    isBot: true,\n    ...extraFields,\n  });\n}\n\nexport interface ResolveStopTargetInput {\n  handler: BotHandler;\n  conversationId: string;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\n/**\n * Pick which session key a `/stop` should target without applying any\n * platform-specific fallback policy. Order:\n *   1. The provided sessionKey, if running.\n *   2. The bare conversationId, if running.\n */\nexport function resolveStopTarget(input: ResolveStopTargetInput): string | null {\n  const { handler, conversationId, sessionKey } = input;\n\n  if (sessionKey && handler.isRunning(sessionKey)) return sessionKey;\n  if (handler.isRunning(conversationId)) return conversationId;\n  return null;\n}\n\n/**\n * Return the single running scoped session for this conversation, or null when\n * there are zero or multiple matches.\n */\nexport function resolveOnlyScopedStopTarget(\n  handler: BotHandler,\n  conversationId: string,\n): string | null {\n  const runningScopes = handler\n    .getRunningSessions()\n    .map((s) => s.sessionKey)\n    .filter((k) => k.startsWith(`${conversationId}:`));\n\n  return runningScopes.length === 1 ? runningScopes[0] : null;\n}\n\n/**\n * Render tool-call args for human display. Drops `label` (already in the\n * heading) and folds `path` + `offset`/`limit` into a single `path:start-end`\n * line. Pure data normalization with no platform-specific markup.\n */\nexport function formatToolArgs(args: Record<string, unknown> | undefined): string {\n  if (!args) return \"\";\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(args)) {\n    if (key === \"label\" || key === \"offset\" || key === \"limit\") continue;\n\n    if (key === \"path\" && typeof value === \"string\") {\n      const offset = args.offset as number | undefined;\n      const limit = args.limit as number | undefined;\n      lines.push(\n        offset !== undefined && limit !== undefined\n          ? `${value}:${offset}-${offset + limit}`\n          : value,\n      );\n      continue;\n    }\n\n    lines.push(typeof value === \"string\" ? value : JSON.stringify(value));\n  }\n\n  return lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,wBAAwB,EAExB,yBAAyB,EACzB,YAAY,EACZ,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,OAAO,CAAC,GACnE,yBAAyB,CAI3B;AA0BD,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAS;IAE3B,YAA6B,IAAI,GAAE,MAAW,EAAI;IAElD,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAGvC;IAED,IAAI,IAAI,MAAM,CAEb;YAEa,WAAW;CAe1B;AAID;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBvF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAC9C,MAAM,EAAE,CAeV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzF;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,IAAI,CAWN;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAM9E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAOf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAsBhF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF","sourcesContent":["/**\n * Helpers shared across platform adapters.\n *\n * The agent runner is platform-agnostic: it hands strings and structured tool\n * results to each adapter, which decides how to split, format, and route them.\n * The split/normalize logic itself doesn't differ across platforms — only the\n * markup wrappers — so it lives here once.\n */\n\nimport { appendFileSync } from \"fs\";\nimport { mkdir, writeFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport type { BotHandler } from \"../adapter.js\";\nimport { ensureDirExists } from \"../utils/file-guards.js\";\nimport * as log from \"../log.js\";\nimport { reportUserFacingError } from \"../observability/sentry.js\";\nexport type {\n  ChatResponseErrorContext,\n  ChatResponseErrorOperation,\n  ChatResponseErrorReporter,\n  ResolveStopTargetInput,\n  RetryOptions,\n} from \"./types.js\";\nimport type {\n  ChatResponseErrorContext,\n  ChatResponseErrorOperation,\n  ChatResponseErrorReporter,\n  RetryOptions,\n  ResolveStopTargetInput,\n} from \"./types.js\";\n\nexport function createChatResponseErrorReporter(\n  resolve: () => Omit<ChatResponseErrorContext, \"operation\" | \"extra\">,\n): ChatResponseErrorReporter {\n  return (err, operation, extra) => {\n    reportChatResponseError(err, { ...resolve(), operation, extra });\n  };\n}\n\nfunction reportChatResponseError(err: unknown, context: ChatResponseErrorContext): void {\n  reportUserFacingError(err, {\n    domain: \"chat_platform\",\n    surface: \"chat_response\",\n    operation: context.operation,\n    severity: context.operation === \"set_working\" ? \"warning\" : \"error\",\n    platform: context.platform,\n    context: {\n      conversationId: context.conversationId,\n      channelId: context.channelId,\n      chatId: context.chatId,\n      messageId: context.messageId,\n      sessionKey: context.sessionKey,\n      responseMessageId: context.responseMessageId,\n      threadTs: context.threadTs,\n      replyTargetId: context.replyTargetId,\n      replyToId: context.replyToId,\n      conversationKind: context.conversationKind,\n      isThreaded: context.isThreaded,\n      ...context.extra,\n    },\n  });\n}\n\nexport class ChannelQueue {\n  private queue: Array<() => Promise<void>> = [];\n  private processing = false;\n\n  constructor(private readonly name: string = \"\") {}\n\n  enqueue(work: () => Promise<void>): void {\n    this.queue.push(work);\n    this.processNext();\n  }\n\n  size(): number {\n    return this.queue.length;\n  }\n\n  private async processNext(): Promise<void> {\n    if (this.processing || this.queue.length === 0) return;\n    this.processing = true;\n    const work = this.queue.shift()!;\n    try {\n      await work();\n    } catch (err) {\n      log.logWarning(\n        `${this.name ? this.name + \" \" : \"\"}queue error`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\n// RetryOptions is defined in ./types.ts and re-exported from the top of this file.\n\n/**\n * Run `fn` and retry with exponential backoff when its error matches\n * `isRateLimited`. Other errors propagate immediately. Each platform supplies\n * its own predicate so we don't have to know every SDK's error shape here.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions): Promise<T> {\n  const maxAttempts = opts.maxAttempts ?? 3;\n  const baseDelayMs = opts.baseDelayMs ?? 1000;\n  let lastError: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      const isLastAttempt = attempt === maxAttempts - 1;\n      if (isLastAttempt || !opts.isRateLimited(lastError)) {\n        throw lastError;\n      }\n\n      const delay = baseDelayMs * Math.pow(2, attempt);\n      log.logWarning(\n        `Retrying after error in ${delay}ms (attempt ${attempt + 1}/${maxAttempts}): ${lastError.message}`,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Split `text` into chunks no larger than `limit`, appending a continuation\n * marker (e.g. `_(continued 1)_`) at the end of every part except the last.\n *\n * Each adapter passes its own `formatContinuation` so the marker uses the\n * platform's italic / emphasis convention.\n */\nexport function splitText(\n  text: string,\n  limit: number,\n  formatContinuation: (partNum: number) => string,\n): string[] {\n  if (text.length <= limit) return [text];\n  const parts: string[] = [];\n  let remaining = text;\n  let partNum = 1;\n  while (remaining.length > 0) {\n    const suffixReserve = formatContinuation(partNum).length + 8;\n    const chunkLimit = Math.max(1, limit - suffixReserve);\n    const chunk = remaining.slice(0, chunkLimit);\n    remaining = remaining.slice(chunkLimit);\n    const suffix = remaining.length > 0 ? `\\n${formatContinuation(partNum)}` : \"\";\n    parts.push(chunk + suffix);\n    partNum++;\n  }\n  return parts;\n}\n\n/**\n * Append a JSON-serializable entry to `${workingDir}/${channel}/log.jsonl`,\n * creating the directory on first use. This is the single write path every\n * adapter uses for human-readable message history.\n */\nexport function appendChannelLog(workingDir: string, channel: string, entry: object): void {\n  const dir = join(workingDir, channel);\n  ensureDirExists(dir);\n  appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n}\n\n/** Convenience for appending the bot's own outbound message. */\nexport function appendBotResponseLog(\n  workingDir: string,\n  channel: string,\n  text: string,\n  ts: string,\n  threadTs?: string,\n  extraFields: Record<string, unknown> = {},\n): void {\n  appendChannelLog(workingDir, channel, {\n    date: new Date().toISOString(),\n    ts,\n    ...(threadTs ? { threadTs } : {}),\n    user: \"bot\",\n    text,\n    attachments: [],\n    isBot: true,\n    ...extraFields,\n  });\n}\n\n// ResolveStopTargetInput is defined in ./types.ts and re-exported from the top of this file.\n\n/**\n * Pick which session key a `/stop` should target without applying any\n * platform-specific fallback policy. Order:\n *   1. The provided sessionKey, if running.\n *   2. The bare conversationId, if running.\n */\nexport function resolveStopTarget(input: ResolveStopTargetInput): string | null {\n  const { handler, conversationId, sessionKey } = input;\n\n  if (sessionKey && handler.isRunning(sessionKey)) return sessionKey;\n  if (handler.isRunning(conversationId)) return conversationId;\n  return null;\n}\n\n/**\n * Return the single running scoped session for this conversation, or null when\n * there are zero or multiple matches.\n */\nexport function resolveOnlyScopedStopTarget(\n  handler: BotHandler,\n  conversationId: string,\n): string | null {\n  const runningScopes = handler\n    .getRunningSessions()\n    .map((s) => s.sessionKey)\n    .filter((k) => k.startsWith(`${conversationId}:`));\n\n  return runningScopes.length === 1 ? runningScopes[0] : null;\n}\n\n/**\n * Render tool-call args for human display. Drops `label` (already in the\n * heading) and folds `path` + `offset`/`limit` into a single `path:start-end`\n * line. Pure data normalization with no platform-specific markup.\n */\nexport function formatToolArgs(args: Record<string, unknown> | undefined): string {\n  if (!args) return \"\";\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(args)) {\n    if (key === \"label\" || key === \"offset\" || key === \"limit\") continue;\n\n    if (key === \"path\" && typeof value === \"string\") {\n      const offset = args.offset as number | undefined;\n      const limit = args.limit as number | undefined;\n      lines.push(\n        offset !== undefined && limit !== undefined\n          ? `${value}:${offset}-${offset + limit}`\n          : value,\n      );\n      continue;\n    }\n\n    lines.push(typeof value === \"string\" ? value : JSON.stringify(value));\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Fetch `url` and write the response body to `destPath`, creating parent\n * directories as needed. Throws on non-2xx responses or write failures.\n */\nexport async function downloadUrlToFile(url: string, destPath: string): Promise<void> {\n  const response = await fetch(url);\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n  }\n  const buffer = await response.arrayBuffer();\n  await mkdir(join(destPath, \"..\"), { recursive: true });\n  await writeFile(destPath, Buffer.from(buffer));\n}\n"]}

package/dist/adapters/shared.js

@@ -7,10 +7,11 @@
  * markup wrappers — so it lives here once.
  */
 import { appendFileSync } from "fs";
+import { mkdir, writeFile } from "fs/promises";
 import { join } from "path";
-import { ensureDirExists } from "../file-guards.js";
+import { ensureDirExists } from "../utils/file-guards.js";
 import * as log from "../log.js";
-import { reportUserFacingError } from "../sentry.js";
+import { reportUserFacingError } from "../observability/sentry.js";
 export function createChatResponseErrorReporter(resolve) {
     return (err, operation, extra) => {
         reportChatResponseError(err, { ...resolve(), operation, extra });
@@ -67,6 +68,7 @@ export class ChannelQueue {
         this.processNext();
     }
 }
+// RetryOptions is defined in ./types.ts and re-exported from the top of this file.
 /**
  * Run `fn` and retry with exponential backoff when its error matches
  * `isRateLimited`. Other errors propagate immediately. Each platform supplies
@@ -140,6 +142,7 @@ export function appendBotResponseLog(workingDir, channel, text, ts, threadTs, ex
         ...extraFields,
     });
 }
+// ResolveStopTargetInput is defined in ./types.ts and re-exported from the top of this file.
 /**
  * Pick which session key a `/stop` should target without applying any
  * platform-specific fallback policy. Order:
@@ -189,4 +192,17 @@ export function formatToolArgs(args) {
     }
     return lines.join("\n");
 }
+/**
+ * Fetch `url` and write the response body to `destPath`, creating parent
+ * directories as needed. Throws on non-2xx responses or write failures.
+ */
+export async function downloadUrlToFile(url, destPath) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const buffer = await response.arrayBuffer();
+    await mkdir(join(destPath, ".."), { recursive: true });
+    await writeFile(destPath, Buffer.from(buffer));
+}
 //# sourceMappingURL=shared.js.map

package/dist/adapters/shared.js.map

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

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

@@ -1,34 +1,13 @@
-import type { Bot, BotEvent, BotHandler, ConversationKind, PlatformInfo } from "../../adapter.js";
+import type { Bot, BotEvent, BotHandler, PlatformInfo } from "../../adapter.js";
 import type { EventsWatcher } from "../../events.js";
-import type { Attachment, ChannelStore } from "../../store.js";
-export interface SlackEvent {
-    type: "mention" | "dm";
-    conversationId: string;
-    conversationKind: ConversationKind;
-    channel: string;
-    ts: string;
-    thread_ts?: string;
-    user: string;
-    text: string;
-    files?: Array<{
-        name?: string;
-        url_private_download?: string;
-        url_private?: string;
-    }>;
-    /** Processed attachments with local paths (populated after logUserMessage) */
-    attachments?: Attachment[];
-    /** Session key passed through to BotEvent so handleEvent uses the correct persistent session */
-    sessionKey?: string;
-}
-export interface SlackUser {
-    id: string;
-    userName: string;
-    displayName: string;
-}
-export interface SlackChannel {
-    id: string;
-    name: string;
-}
+import type { ChannelStore } from "../../store.js";
+import type { SlackChannel, SlackUser } from "./types.js";
+/**
+ * Build a Slack context block whose text is capped at the mrkdwn limit.
+ * Used for muted diagnostics and ephemeral command responses.
+ */
+export declare function buildMrkdwnContextBlock(text: string): object;
+export type { SlackChannel, SlackEvent, SlackUser } from "./types.js";
 export declare class SlackBot implements Bot {
     private socketClient;
     private webClient;
@@ -43,6 +22,7 @@ export declare class SlackBot implements Bot {
     private channels;
     private queues;
     private eventsWatcher;
+    private createAdapters;
     constructor(handler: BotHandler, config: {
         appToken: string;
         botToken: string;
@@ -66,6 +46,9 @@ export declare class SlackBot implements Bot {
     }): Promise<void>;
     openDirectMessage(userId: string): Promise<string>;
     updateMessage(channel: string, ts: string, text: string): Promise<void>;
+    startMessageStream(channel: string, text: string, threadTs?: string): Promise<string>;
+    appendMessageStream(channel: string, ts: string, text: string): Promise<void>;
+    stopMessageStream(channel: string, ts: string): Promise<void>;
     deleteMessage(channel: string, ts: string): Promise<void>;
     /** Set the status for an assistant thread (shows "thinking" state) */
     setAssistantStatus(channel: string, threadTs: string, status: string): Promise<void>;
@@ -84,17 +67,15 @@ export declare class SlackBot implements Bot {
     private getQueue;
     private resolveQueueKey;
     private hasKnownThreadSession;
+    private processSlackMessageIntake;
     private buildHomeView;
     private resolveStopTarget;
     private isStopText;
     private createCommandAdapters;
     private buildSlashCommandEvent;
-    private createSlashCommandBot;
     private routeSlashLoginCommand;
     private routeSlashNewCommand;
     private routeSlashModelCommand;
-    private routeSlashSandboxCommand;
-    private routeSlashAutoReplyCommand;
     private routeSlashSessionCommand;
     private routeSlashAdminCommand;
     private setupEventHandlers;

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 type { KnownBlock } from \"@slack/types\";\nimport { WebClient } from \"@slack/web-api\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { basename, join } from \"path\";\nimport type {\n  Bot,\n  BotAdapters,\n  BotEvent,\n  BotHandler,\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  ConversationKind,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport type { EventsWatcher } from \"../../events.js\";\nimport * as log from \"../../log.js\";\nimport type { Attachment, ChannelStore } from \"../../store.js\";\nimport { PRODUCT_NAME, formatForceStopped, formatNothingRunning } from \"../../ui-copy.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  ChannelQueue,\n  resolveOnlyScopedStopTarget,\n  resolveStopTarget,\n  withRetry,\n} from \"../shared.js\";\nimport { evaluateAutoReplyPolicy } from \"../../trigger.js\";\nimport { createSlackAdapters } from \"./context.js\";\nimport {\n  hasMaterializedChatSession,\n  registerThreadSession,\n} from \"../../sessions/chat-session-manager.js\";\nimport {\n  isSlackThreadSessionKey,\n  planSlackAdapterSession,\n  planSlackEventAnchorRun,\n  resolveSlackSessionKey,\n} from \"./session.js\";\nimport { reportUserFacingError } from \"../../sentry.js\";\n\nconst SLACK_EVENT_ANCHOR_TEXT = \"Working on it...\";\n\n// Slack WebClient errors carry either `code: \"rate_limited\"` (retry-after) or\n// the legacy `data.error === \"rate_limited\"` / 429 status shape.\nfunction slackIsRateLimited(err: Error): boolean {\n  if ((err as { code?: unknown }).code === \"rate_limited\") return true;\n  const data = (err as { data?: { error?: string; response?: { status?: number } } }).data;\n  return data?.error === \"rate_limited\" || data?.response?.status === 429;\n}\n\nconst slackRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: slackIsRateLimited });\n\nfunction collectSlackText(value: unknown, parts: string[]): void {\n  if (value === null || value === undefined) return;\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed) parts.push(trimmed);\n    return;\n  }\n  if (Array.isArray(value)) {\n    for (const item of value) collectSlackText(item, parts);\n    return;\n  }\n  if (typeof value !== \"object\") return;\n\n  const obj = value as Record<string, unknown>;\n  for (const key of [\"text\", \"fallback\", \"title\", \"value\"] as const) {\n    collectSlackText(obj[key], parts);\n  }\n  collectSlackText(obj.fields, parts);\n  collectSlackText(obj.elements, parts);\n  collectSlackText(obj.blocks, parts);\n}\n\nfunction buildSlackAppMessageText(event: {\n  text?: string;\n  blocks?: unknown[];\n  attachments?: unknown[];\n}): string {\n  const parts: string[] = [];\n  collectSlackText(event.text, parts);\n  collectSlackText(event.blocks, parts);\n  collectSlackText(event.attachments, parts);\n  const deduped = parts.filter((part, index) => parts.indexOf(part) === index);\n  return deduped.join(\"\\n\");\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SlackEvent {\n  type: \"mention\" | \"dm\";\n  conversationId: string;\n  conversationKind: ConversationKind;\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  /** Session key passed through to BotEvent so handleEvent uses the correct persistent session */\n  sessionKey?: string;\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// ============================================================================\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 botId: string | null = null;\n  private ownMentionRegex: RegExp | 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({\n      appToken: config.appToken,\n      // Default 5s is too tight: brief event-loop stalls (e.g. backfill, sync fs)\n      // cause false pong timeouts; 4 in a row makes Slack drop the socket.\n      clientPingTimeout: 12_000,\n    });\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    this.botId = typeof auth.bot_id === \"string\" ? auth.bot_id : null;\n\n    await Promise.all([this.fetchUsers(), this.fetchChannels()]);\n    log.logInfo(`Loaded ${this.channels.size} channels, ${this.users.size} users`);\n\n    // Record startup time before opening the socket. Slack may replay older events;\n    // those should be logged but not processed. Backfill runs in the background up\n    // to this timestamp so startup is not blocked by one history call per channel.\n    this.startupTs = (Date.now() / 1000).toFixed(6);\n\n    this.setupEventHandlers();\n    await this.socketClient.start();\n\n    log.logConnected(\"Slack\");\n\n    void this.backfillAllChannels(this.startupTs).catch((error) => {\n      log.logWarning(\"Slack backfill failed\", String(error));\n    });\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  private stripOwnMention(text: string | undefined): string {\n    const source = text ?? \"\";\n    if (!this.botUserId) return source.trim();\n    if (!this.ownMentionRegex || !this.ownMentionRegex.source.includes(this.botUserId)) {\n      this.ownMentionRegex = new RegExp(`<@${this.botUserId}>`, \"gi\");\n    }\n    return source.replace(this.ownMentionRegex, \"\").trim();\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({ channel, text });\n      return result.ts as string;\n    });\n  }\n\n  async postEphemeral(\n    channel: string,\n    user: string,\n    text: string,\n    threadTs?: string,\n  ): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.postEphemeral({\n        channel,\n        user,\n        text,\n        ...(threadTs ? { thread_ts: threadTs } : {}),\n      });\n    });\n  }\n\n  async postEphemeralBlocks(\n    channel: string,\n    user: string,\n    text: string,\n    blocks: object[],\n    threadTs?: string,\n  ): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.postEphemeral({\n        channel,\n        user,\n        text,\n        blocks: blocks as KnownBlock[],\n        ...(threadTs ? { thread_ts: threadTs } : {}),\n      });\n    });\n  }\n\n  async postMessageBlocks(channel: string, text: string, blocks: object[]): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({\n        channel,\n        text,\n        blocks: blocks as KnownBlock[],\n      });\n      return result.ts as string;\n    });\n  }\n\n  async postPrivate(conversationId: string, userId: string, text: string): Promise<void> {\n    await this.postEphemeral(conversationId, userId, text);\n  }\n\n  async postPrivateDiagnostic(\n    conversationId: string,\n    userId: string,\n    text: string,\n    options?: { style?: \"muted\" | \"error\" },\n  ): Promise<void> {\n    if (options?.style !== \"muted\") {\n      await this.postPrivate(\n        conversationId,\n        userId,\n        options?.style === \"error\" ? `_${text}_` : text,\n      );\n      return;\n    }\n    const CONTEXT_TEXT_LIMIT = 3000;\n    const blockText =\n      text.length > CONTEXT_TEXT_LIMIT\n        ? text.substring(0, CONTEXT_TEXT_LIMIT - 20) + \"\\n_(truncated)_\"\n        : text;\n    await this.postEphemeralBlocks(conversationId, userId, text, [\n      { type: \"context\", elements: [{ type: \"mrkdwn\", text: blockText }] },\n    ]);\n  }\n\n  async openDirectMessage(userId: string): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.conversations.open({ users: userId });\n      const channelId = result.channel?.id;\n      if (!channelId) {\n        throw new Error(`Failed to open DM for user ${userId}`);\n      }\n      return channelId;\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.update({ channel, ts, text });\n    });\n  }\n\n  async deleteMessage(channel: string, ts: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.delete({ channel, ts });\n    });\n  }\n\n  // ==========================================================================\n  // Slack Assistant API (AI assistant experience)\n  // ==========================================================================\n\n  /** Set the status for an assistant thread (shows \"thinking\" state) */\n  async setAssistantStatus(channel: string, threadTs: string, status: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.assistant.threads.setStatus({\n        channel_id: channel,\n        thread_ts: threadTs,\n        status,\n      });\n    });\n  }\n\n  async postInThread(channel: string, threadTs: string, text: string): Promise<string> {\n    return slackRetry(async () => {\n      // Use Block Kit section for long messages to trigger Slack's \"Show more\" collapsing (~700 chars)\n      const SECTION_TEXT_LIMIT = 3000;\n      if (text.length > 500) {\n        const blockText =\n          text.length > SECTION_TEXT_LIMIT\n            ? text.substring(0, SECTION_TEXT_LIMIT - 20) + \"\\n_(truncated)_\"\n            : text;\n        const result = await this.webClient.chat.postMessage({\n          channel,\n          thread_ts: threadTs,\n          text, // full text as notification fallback\n          blocks: [{ type: \"section\", text: { type: \"mrkdwn\", text: blockText } }],\n        });\n        return result.ts as string;\n      }\n      const result = await this.webClient.chat.postMessage({ channel, thread_ts: threadTs, text });\n      return result.ts as string;\n    });\n  }\n\n  async postInThreadBlocks(\n    channel: string,\n    threadTs: string,\n    text: string,\n    blocks: object[],\n  ): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({\n        channel,\n        thread_ts: threadTs,\n        text, // fallback for notifications\n        blocks: blocks as KnownBlock[],\n      });\n      return result.ts as string;\n    });\n  }\n\n  async postBlocks(channel: string, text: string, blocks: object[]): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({\n        channel,\n        text,\n        blocks: blocks as KnownBlock[],\n      });\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 slackRetry(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  logToFile(channel: string, entry: object): void {\n    appendChannelLog(this.workingDir, channel, entry);\n  }\n\n  logBotResponse(\n    channel: string,\n    text: string,\n    ts: string,\n    threadTs?: string,\n    slackBlocks?: object[],\n  ): void {\n    appendBotResponseLog(this.workingDir, channel, text, ts, threadTs, {\n      platform: \"slack\",\n      ...(slackBlocks ? { slackBlocks } : {}),\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      diagnostics: {\n        showUsageSummary: true,\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 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(async () => {\n      let anchorTs: string | undefined;\n      if (!event.thread_ts) {\n        try {\n          anchorTs = await this.postMessage(conversationId, SLACK_EVENT_ANCHOR_TEXT);\n        } catch (err) {\n          log.logWarning(\n            `Failed to post Slack event anchor for ${conversationId}`,\n            err instanceof Error ? err.message : String(err),\n          );\n          reportUserFacingError(err, {\n            domain: \"events\",\n            surface: \"event_delivery\",\n            operation: \"slack_anchor_post\",\n            severity: \"error\",\n            platform: \"slack\",\n            context: {\n              conversationId,\n              conversationKind: event.conversationKind,\n              eventTs: event.ts,\n              textLength: event.text.length,\n            },\n          });\n          throw err;\n        }\n      }\n      const eventPlan = planSlackEventAnchorRun(event, anchorTs);\n      const eventForRun = eventPlan.event;\n      if (eventPlan.initialMessageTs && eventForRun.sessionKey) {\n        registerThreadSession({\n          conversationDir: join(this.workingDir, conversationId),\n          sessionKey: eventForRun.sessionKey,\n        });\n      }\n\n      const runQueueKey = planSlackAdapterSession(eventForRun, {\n        initialMessageTs: eventPlan.initialMessageTs,\n      }).sessionKey;\n      this.getQueue(runQueueKey).enqueue(async () => {\n        const slackEvent: SlackEvent = {\n          type: eventForRun.type as SlackEvent[\"type\"],\n          conversationId,\n          conversationKind: eventForRun.conversationKind,\n          channel: conversationId,\n          ts: eventForRun.ts,\n          thread_ts: eventForRun.thread_ts,\n          user: eventForRun.user,\n          text: eventForRun.text,\n          attachments: eventForRun.attachments?.map((attachment) => ({\n            original: attachment.name,\n            localPath: attachment.localPath,\n          })),\n          sessionKey: eventForRun.sessionKey,\n        };\n        const adapters = createSlackAdapters(slackEvent, this, {\n          initialMessageTs: eventPlan.initialMessageTs,\n        });\n        return this.handler.handleEvent(eventForRun, this, adapters);\n      });\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(\"Slack\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private resolveQueueKey(conversationId: string, sessionKey: string): string {\n    if (!isSlackThreadSessionKey(sessionKey)) return sessionKey;\n    if (this.handler.isRunning(sessionKey)) return sessionKey;\n    return this.hasKnownThreadSession(conversationId, sessionKey) ? sessionKey : conversationId;\n  }\n\n  private hasKnownThreadSession(conversationId: string, sessionKey: string): boolean {\n    return hasMaterializedChatSession({\n      conversationDir: join(this.workingDir, conversationId),\n      sessionKey,\n    });\n  }\n\n  private buildHomeView(): { type: \"home\"; blocks: KnownBlock[] } {\n    const blocks: object[] = [\n      {\n        type: \"section\",\n        text: {\n          type: \"mrkdwn\",\n          text: `*${PRODUCT_NAME}*\\nStart 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: PRODUCT_NAME,\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 channelLabel =\n          ev.platform === \"slack\"\n            ? (() => {\n                const channel = this.channels.get(ev.conversationId);\n                const channelName = channel ? `#${channel.name}` : ev.conversationId;\n                return `${ev.platform}:${channelName}`;\n              })()\n            : `${ev.platform}:${ev.conversationId}`;\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}\\` · ${channelLabel} · 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: blocks as KnownBlock[] };\n  }\n\n  private resolveStopTarget(channelId: string, threadTs?: string): string | null {\n    const directTarget = resolveStopTarget({\n      handler: this.handler,\n      conversationId: channelId,\n      sessionKey: resolveSlackSessionKey(channelId, threadTs),\n    });\n    if (directTarget) return directTarget;\n    if (threadTs) return null;\n    return resolveOnlyScopedStopTarget(this.handler, channelId);\n  }\n\n  private isStopText(text: string): boolean {\n    const normalized = text.trim().toLowerCase();\n    return normalized === \"stop\" || normalized === \"/stop\";\n  }\n\n  private createCommandAdapters(\n    conversationId: string,\n    userId: string,\n    userName: string | undefined,\n    text: string,\n    ts: string,\n    options: { ephemeralChannelId?: string; threadTs?: string } = {},\n  ): BotAdapters {\n    const message: ChatMessage = {\n      id: ts,\n      sessionKey: conversationId,\n      conversationKind: options.ephemeralChannelId ? \"shared\" : \"direct\",\n      userId,\n      userName,\n      text,\n      attachments: [],\n    };\n\n    const respond = async (responseText: string) => {\n      if (options.ephemeralChannelId) {\n        await this.postEphemeral(\n          options.ephemeralChannelId,\n          userId,\n          responseText,\n          options.threadTs,\n        );\n        return;\n      }\n      const messageTs = await this.postMessage(conversationId, responseText);\n      this.logBotResponse(conversationId, responseText, messageTs);\n    };\n\n    const respondMuted = async (responseText: string) => {\n      const CONTEXT_TEXT_LIMIT = 3000;\n      const blockText =\n        responseText.length > CONTEXT_TEXT_LIMIT\n          ? responseText.substring(0, CONTEXT_TEXT_LIMIT - 20) + \"\\n_(truncated)_\"\n          : responseText;\n      const blocks = [{ type: \"context\", elements: [{ type: \"mrkdwn\", text: blockText }] }];\n      if (options.ephemeralChannelId) {\n        await this.postEphemeralBlocks(\n          options.ephemeralChannelId,\n          userId,\n          responseText,\n          blocks,\n          options.threadTs,\n        );\n        return;\n      }\n      const messageTs = await this.postMessageBlocks(conversationId, responseText, blocks);\n      this.logBotResponse(conversationId, responseText, messageTs);\n    };\n\n    const responseCtx: ChatResponseContext = {\n      respond,\n      replaceResponse: respond,\n      respondDiagnostic: async (\n        responseText: string,\n        responseOptions?: { style?: \"muted\" | \"error\" },\n      ) => {\n        if (responseOptions?.style === \"muted\") {\n          await respondMuted(responseText);\n          return;\n        }\n        await respond(responseOptions?.style === \"error\" ? `_${responseText}_` : responseText);\n      },\n      respondToolResult: async (result: ChatToolResult) => {\n        const duration = (result.durationMs / 1000).toFixed(1);\n        await respond(\n          `${result.isError ? \"Error\" : \"Done\"} ${result.toolName} (${duration}s)\\n${result.result}`,\n        );\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 {\n      message,\n      responseCtx,\n      platform: this.getPlatformInfo(),\n    };\n  }\n\n  private buildSlashCommandEvent(\n    payload: {\n      command: string;\n      text?: string;\n      channel_id: string;\n      user_id: string;\n      user_name?: string;\n      thread_ts?: string;\n    },\n    options: { type?: BotEvent[\"type\"]; includeText?: boolean; thread?: boolean } = {},\n  ): { event: BotEvent; adapters: BotAdapters } {\n    const conversationId = payload.channel_id;\n    const isDirectMessage = conversationId.startsWith(\"D\");\n    const createdAt = new Date();\n    const eventTs = (createdAt.getTime() / 1000).toFixed(6);\n    const userName = payload.user_name ?? this.getUser(payload.user_id)?.userName;\n    const commandSuffix = options.includeText ? payload.text?.trim() : undefined;\n    const commandText = commandSuffix ? `${payload.command} ${commandSuffix}` : payload.command;\n    const threadTs = options.thread ? payload.thread_ts : undefined;\n    const sessionKey = options.thread\n      ? resolveSlackSessionKey(conversationId, threadTs)\n      : conversationId;\n\n    this.logToFile(conversationId, {\n      date: createdAt.toISOString(),\n      ts: eventTs,\n      user: payload.user_id,\n      userName,\n      text: commandText,\n      attachments: [],\n      isBot: false,\n      ...(threadTs ? { threadTs } : {}),\n    });\n\n    const event: BotEvent = {\n      type: options.type ?? (isDirectMessage ? \"dm\" : \"mention\"),\n      conversationId,\n      conversationKind: isDirectMessage ? \"direct\" : \"shared\",\n      ts: eventTs,\n      user: payload.user_id,\n      text: commandText,\n      attachments: [],\n      ...(threadTs ? { thread_ts: threadTs } : {}),\n      sessionKey,\n    };\n\n    const adapters = this.createCommandAdapters(\n      conversationId,\n      payload.user_id,\n      userName,\n      commandText,\n      eventTs,\n      isDirectMessage ? { threadTs } : { ephemeralChannelId: conversationId, threadTs },\n    );\n\n    return { event, adapters };\n  }\n\n  private createSlashCommandBot(conversationId: string, threadTs?: string): Bot {\n    return {\n      start: async () => {},\n      postMessage: async (_channel: string, text: string) => {\n        if (threadTs) {\n          return this.postInThread(conversationId, threadTs, text);\n        }\n        return this.postMessage(conversationId, text);\n      },\n      updateMessage: async (channel: string, ts: string, text: string) => {\n        await this.updateMessage(channel, ts, text);\n      },\n      enqueueEvent: (event: BotEvent) => this.enqueueEvent(event),\n      getPlatformInfo: () => this.getPlatformInfo(),\n    };\n  }\n\n  private async routeSlashLoginCommand(payload: {\n    command: string;\n    text?: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, {\n      type: payload.channel_id.startsWith(\"D\") ? \"dm\" : \"private_command\",\n      includeText: true,\n    });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private async routeSlashNewCommand(payload: {\n    command: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    const conversationId = payload.channel_id;\n    if (!conversationId.startsWith(\"D\")) {\n      await this.postEphemeral(\n        conversationId,\n        payload.user_id,\n        `為了避免誤清除共享上下文，${payload.command} 目前只能在與 ${PRODUCT_NAME} 的私訊中使用。`,\n      );\n      return;\n    }\n\n    const createdAt = new Date();\n    const eventTs = (createdAt.getTime() / 1000).toFixed(6);\n    const userName = payload.user_name ?? this.getUser(payload.user_id)?.userName;\n\n    this.logToFile(conversationId, {\n      date: createdAt.toISOString(),\n      ts: eventTs,\n      user: payload.user_id,\n      userName,\n      text: payload.command,\n      attachments: [],\n      isBot: false,\n    });\n\n    const commandBot = this.createSlashCommandBot(conversationId);\n    await this.handler.handleNewCommand(conversationId, conversationId, commandBot);\n  }\n\n  private async routeSlashModelCommand(payload: {\n    command: string;\n    text?: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, { includeText: true });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private async routeSlashSandboxCommand(payload: {\n    command: string;\n    text?: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    await this.routeSlashModelCommand(payload);\n  }\n\n  private async routeSlashAutoReplyCommand(payload: {\n    command: string;\n    text?: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    await this.routeSlashModelCommand(payload);\n  }\n\n  private async routeSlashSessionCommand(payload: {\n    command: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n    thread_ts?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, { thread: true });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private async routeSlashAdminCommand(payload: {\n    command: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n    thread_ts?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, { thread: true });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private setupEventHandlers(): void {\n    this.socketClient.on(\"disconnect\", (err: unknown) => {\n      log.logWarning(\"Slack socket disconnect\", err ? String(err) : \"\");\n    });\n    this.socketClient.on(\"error\", (err: unknown) => {\n      log.logWarning(\"Slack socket error\", err ? String(err) : \"\");\n    });\n    this.socketClient.on(\"unable_to_socket_mode_start\", (err: unknown) => {\n      log.logWarning(\"Slack socket unable_to_start\", err ? String(err) : \"\");\n    });\n\n    this.socketClient.on(\"app_mention\", (payload) => this.handleAppMention(payload));\n    this.socketClient.on(\"message\", (payload) => this.handleMessageEvent(payload));\n    this.socketClient.on(\"slash_commands\", (payload) => void this.handleSlashCommand(payload));\n    this.socketClient.on(\"app_home_opened\", (payload) => this.handleAppHomeOpened(payload));\n    this.socketClient.on(\"block_actions\", (payload) => void this.handleBlockAction(payload));\n    this.socketClient.on(\n      \"interactive\",\n      (payload) => void this.handleBlockAction(payload as { body: unknown; ack: () => void }),\n    );\n  }\n\n  private handleAppMention({ event, ack }: { event: unknown; ack: () => void }): void {\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    // Top-level mentions use a persistent channel session.\n    // Thread replies get their own isolated session (channelId:thread_ts).\n    const sessionKey = resolveSlackSessionKey(e.channel, e.thread_ts);\n\n    const mentionText = this.stripOwnMention(e.text);\n    const slackEvent: SlackEvent = {\n      type: \"mention\",\n      conversationId: e.channel,\n      conversationKind: \"shared\",\n      channel: e.channel,\n      ts: e.ts,\n      thread_ts: e.thread_ts,\n      user: e.user,\n      text: mentionText || \"Please respond to the recent conversation context.\",\n      files: e.files,\n      sessionKey,\n    };\n\n    const attachmentsPromise = 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      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    // Check for stop command - execute immediately, don't queue!\n    if (this.isStopText(slackEvent.text)) {\n      const stopTarget = this.resolveStopTarget(e.channel, e.thread_ts);\n      if (stopTarget) {\n        this.handler.handleStop(stopTarget, e.channel, this);\n      } else {\n        this.postMessage(e.channel, formatNothingRunning(\"slack\"));\n      }\n      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    this.getQueue(this.resolveQueueKey(e.channel, sessionKey)).enqueue(async () => {\n      slackEvent.attachments = await attachmentsPromise;\n      const adapters = createSlackAdapters(slackEvent, this);\n      return this.handler.handleEvent(\n        slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n        this,\n        adapters,\n      );\n    });\n\n    ack();\n  }\n\n  private handleMessageEvent({ event, ack }: { event: unknown; ack: () => void }): void {\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      app_id?: string;\n      username?: string;\n      bot_profile?: { id?: string; app_id?: string; name?: string; real_name?: string };\n      blocks?: unknown[];\n      attachments?: unknown[];\n      files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n    };\n\n    const hasFiles = !!e.files && e.files.length > 0;\n    const hasSlackContent = !!e.text || hasFiles || !!e.blocks?.length || !!e.attachments?.length;\n    const isOwnBotMessage =\n      (!!e.user && e.user === this.botUserId) || (!!this.botId && e.bot_id === this.botId);\n    if (isOwnBotMessage) {\n      ack();\n      return;\n    }\n\n    const isExternalBotMessage = !!e.bot_id || e.subtype === \"bot_message\";\n    if (isExternalBotMessage) {\n      if (e.subtype !== undefined && e.subtype !== \"bot_message\" && e.subtype !== \"file_share\") {\n        ack();\n        return;\n      }\n      if (!hasSlackContent) {\n        ack();\n        return;\n      }\n      void this.logExternalBotMessage(e).catch((err) => {\n        log.logWarning(\"Failed to log Slack bot message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    if (!e.user) {\n      ack();\n      return;\n    }\n    if (e.subtype !== undefined && e.subtype !== \"file_share\") {\n      ack();\n      return;\n    }\n    if (!hasSlackContent) {\n      ack();\n      return;\n    }\n\n    const isDM = e.channel_type === \"im\";\n    const conversationKind: ConversationKind = isDM ? \"direct\" : \"shared\";\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 isThreadReply = !!e.thread_ts;\n    const sessionKey = isDM ? resolveSlackSessionKey(e.channel, e.thread_ts) : undefined;\n\n    const slackEvent: SlackEvent = {\n      type: isDM ? \"dm\" : \"mention\",\n      conversationId: e.channel,\n      conversationKind,\n      channel: e.channel,\n      ts: e.ts,\n      thread_ts: e.thread_ts,\n      user: e.user,\n      text: this.stripOwnMention(e.text),\n      files: e.files,\n      sessionKey,\n    };\n\n    const attachmentsPromise = 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      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    // Stop command for DM only (app_mention handles shared-channel \"@mikan stop\").\n    if (isDM && this.isStopText(slackEvent.text)) {\n      const stopTarget = this.resolveStopTarget(e.channel, e.thread_ts);\n      if (stopTarget) {\n        this.handler.handleStop(stopTarget, e.channel, this);\n      } else {\n        this.postMessage(e.channel, formatNothingRunning(\"slack\"));\n      }\n      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    const enqueueTriggered = () => {\n      const activeSessionKey =\n        slackEvent.sessionKey ?? resolveSlackSessionKey(e.channel, e.thread_ts);\n      // Auto-reply top-level channel messages start with no sessionKey because\n      // they are only candidates until the policy allows them. Once triggered,\n      // persist the resolved key on the event; otherwise the runtime fallback\n      // treats the message ts as a thread session (`channel:ts`) instead of the\n      // persistent top-level channel session.\n      slackEvent.sessionKey = activeSessionKey;\n      this.getQueue(this.resolveQueueKey(e.channel, activeSessionKey)).enqueue(async () => {\n        slackEvent.attachments = await attachmentsPromise;\n        const adapters = createSlackAdapters(slackEvent, this);\n        return this.handler.handleEvent(\n          slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n          this,\n          adapters,\n        );\n      });\n    };\n\n    const logOnly = () => {\n      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n    };\n\n    if (isDM) {\n      enqueueTriggered();\n      ack();\n      return;\n    }\n\n    if (isThreadReply) {\n      logOnly();\n      ack();\n      return;\n    }\n\n    // Shared-channel non-mention top-level messages: gate via auto-reply policy.\n    // evaluateAutoReplyPolicy never throws — judge errors/timeouts surface as\n    // trigger:false with a distinct reason, and the user message has already\n    // been queued for logging via logUserMessage above.\n    evaluateAutoReplyPolicy({\n      event: slackEvent as unknown as import(\"../../adapter.js\").BotEvent,\n      workingDir: this.workingDir,\n    }).then((triggerResult) => {\n      if (triggerResult.trigger) enqueueTriggered();\n      else logOnly();\n    });\n\n    ack();\n  }\n\n  private async handleSlashCommand({\n    body,\n    ack,\n  }: {\n    body: unknown;\n    ack: () => Promise<void>;\n  }): Promise<void> {\n    const payload = body as {\n      command?: string;\n      text?: string;\n      channel_id?: string;\n      user_id?: string;\n      user_name?: string;\n      thread_ts?: string;\n    };\n\n    await ack();\n\n    if (!payload.command || !payload.channel_id || !payload.user_id) {\n      return;\n    }\n\n    const handlerPromise =\n      payload.command === \"/pi-login\"\n        ? this.routeSlashLoginCommand({\n            command: payload.command,\n            text: payload.text,\n            channel_id: payload.channel_id,\n            user_id: payload.user_id,\n            user_name: payload.user_name,\n          })\n        : payload.command === \"/pi-new\"\n          ? this.routeSlashNewCommand({\n              command: payload.command,\n              channel_id: payload.channel_id,\n              user_id: payload.user_id,\n              user_name: payload.user_name,\n            })\n          : payload.command === \"/pi-session\"\n            ? this.routeSlashSessionCommand({\n                command: payload.command,\n                channel_id: payload.channel_id,\n                user_id: payload.user_id,\n                user_name: payload.user_name,\n                thread_ts: payload.thread_ts,\n              })\n            : payload.command === \"/pi-model\"\n              ? this.routeSlashModelCommand({\n                  command: payload.command,\n                  text: payload.text,\n                  channel_id: payload.channel_id,\n                  user_id: payload.user_id,\n                  user_name: payload.user_name,\n                })\n              : payload.command === \"/pi-sandbox\"\n                ? this.routeSlashSandboxCommand({\n                    command: payload.command,\n                    text: payload.text,\n                    channel_id: payload.channel_id,\n                    user_id: payload.user_id,\n                    user_name: payload.user_name,\n                  })\n                : payload.command === \"/pi-auto-reply\"\n                  ? this.routeSlashAutoReplyCommand({\n                      command: payload.command,\n                      text: payload.text,\n                      channel_id: payload.channel_id,\n                      user_id: payload.user_id,\n                      user_name: payload.user_name,\n                    })\n                  : payload.command === \"/pi-admin\"\n                    ? this.routeSlashAdminCommand({\n                        command: payload.command,\n                        channel_id: payload.channel_id,\n                        user_id: payload.user_id,\n                        user_name: payload.user_name,\n                        thread_ts: payload.thread_ts,\n                      })\n                    : null;\n\n    if (!handlerPromise) {\n      return;\n    }\n\n    handlerPromise.catch((err) => {\n      log.logWarning(\"Slack slash command error\", err instanceof Error ? err.message : String(err));\n    });\n  }\n\n  private handleAppHomeOpened({ event, ack }: { event: unknown; ack: () => void }): void {\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  private async handleBlockAction({ body, ack }: { body: any; ack: () => void }): Promise<void> {\n    const action = body.actions?.[0];\n    if (!action) {\n      ack();\n      return;\n    }\n\n    if (!action.action_id?.startsWith(\"force_stop_\")) {\n      ack();\n      this.handleSlackInteraction(body, action);\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, formatForceStopped(\"slack\", userId ?? \"unknown\"));\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  private handleSlackInteraction(body: any, action: any): void {\n    const container = body.container ?? {};\n    const channelId = container.channel_id;\n    const userId = body.user?.id;\n    if (!channelId || !userId) return;\n\n    const selectedOption = action.selected_option;\n    const selectedOptions = Array.isArray(action.selected_options)\n      ? action.selected_options\n      : undefined;\n    const selectedText = selectedOption?.text?.text ?? selectedOption?.value;\n    const selectedTexts = selectedOptions?.map((option: any) => option.text?.text ?? option.value);\n    const valueText = selectedTexts?.length\n      ? selectedTexts.join(\", \")\n      : (selectedText ?? action.value ?? action.action_id);\n    const text = `[Slack action] ${action.action_id}: ${valueText}`;\n    const ts = `action:${Date.now()}`;\n    const threadTs = container.thread_ts;\n    const sessionKey = resolveSlackSessionKey(channelId, threadTs);\n\n    this.logToFile(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      ...(threadTs ? { threadTs } : {}),\n      user: userId,\n      userName: body.user?.username ?? body.user?.name,\n      text,\n      attachments: [],\n      isBot: false,\n      platform: \"slack\",\n      slackInteraction: {\n        type: \"block_actions\",\n        actionId: action.action_id,\n        blockId: action.block_id,\n        actionType: action.type,\n        value: action.value,\n        selectedOption: selectedOption\n          ? { text: selectedOption.text?.text, value: selectedOption.value }\n          : undefined,\n        selectedOptions: selectedOptions?.map((option: any) => ({\n          text: option.text?.text,\n          value: option.value,\n        })),\n        messageTs: container.message_ts,\n      },\n    });\n\n    const event: import(\"../../adapter.js\").BotEvent = {\n      type: \"slack_action\",\n      conversationId: channelId,\n      conversationKind: channelId.startsWith(\"D\") ? \"direct\" : \"shared\",\n      ts,\n      user: userId,\n      text,\n      attachments: [],\n      ...(threadTs ? { thread_ts: threadTs } : {}),\n      sessionKey,\n    };\n\n    this.getQueue(this.resolveQueueKey(channelId, sessionKey)).enqueue(async () => {\n      const slackEvent: SlackEvent = {\n        type: event.conversationKind === \"direct\" ? \"dm\" : \"mention\",\n        conversationId: channelId,\n        conversationKind: event.conversationKind,\n        channel: channelId,\n        ts,\n        thread_ts: threadTs,\n        user: userId,\n        text,\n        attachments: [],\n        sessionKey,\n      };\n      return this.handler.handleEvent(event, this, createSlackAdapters(slackEvent, this));\n    });\n  }\n\n  /**\n   * Log a user message to log.jsonl after attachments are ready.\n   */\n  private async logUserMessage(event: SlackEvent): Promise<Attachment[]> {\n    const user = this.users.get(event.user);\n    let attachments: Attachment[] = [];\n    let attachmentError: unknown;\n    if (event.files) {\n      try {\n        attachments = await this.store.processAttachments(event.channel, event.files, event.ts);\n      } catch (err) {\n        attachmentError = err;\n      }\n    }\n    // Always write the text log, even if attachment processing failed — we want\n    // a record of the user message regardless of file-handling errors.\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    if (attachmentError) throw attachmentError;\n    return attachments;\n  }\n\n  private async logExternalBotMessage(event: {\n    channel: string;\n    ts: string;\n    thread_ts?: string;\n    text?: string;\n    subtype?: string;\n    bot_id?: string;\n    app_id?: string;\n    username?: string;\n    bot_profile?: { app_id?: string; name?: string; real_name?: string };\n    blocks?: unknown[];\n    attachments?: unknown[];\n    files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n  }): Promise<Attachment[]> {\n    const attachments = event.files\n      ? await this.store.processAttachments(event.channel, event.files, event.ts)\n      : [];\n    const botName =\n      event.username ?? event.bot_profile?.name ?? event.bot_profile?.real_name ?? event.bot_id;\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.bot_id ? `bot:${event.bot_id}` : \"external-bot\",\n      userName: botName,\n      displayName: botName,\n      text: buildSlackAppMessageText(event),\n      attachments,\n      isBot: true,\n      botId: event.bot_id,\n      appId: event.app_id ?? event.bot_profile?.app_id,\n      subtype: event.subtype,\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 (let i = 0; i < lines.length; i++) {\n      try {\n        const entry = JSON.parse(lines[i]);\n        if (entry.ts) timestamps.add(entry.ts);\n      } catch (err) {\n        log.logWarning(\n          `Skipping malformed log entry at ${logPath}:${i + 1}`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return timestamps;\n  }\n\n  private async backfillChannel(channelId: string, upperBoundTs?: string): Promise<number> {\n    const existingTs = await this.getExistingTimestamps(channelId);\n\n    // Find the biggest ts in log.jsonl\n    let lastLoggedTs: string | undefined;\n    for (const ts of existingTs) {\n      if (!lastLoggedTs || parseFloat(ts) > parseFloat(lastLoggedTs)) lastLoggedTs = ts;\n    }\n\n    type Message = {\n      user?: string;\n      bot_id?: string;\n      app_id?: string;\n      username?: string;\n      bot_profile?: { app_id?: string; name?: string; real_name?: string };\n      blocks?: unknown[];\n      attachments?: unknown[];\n      text?: string;\n      ts?: string;\n      thread_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: lastLoggedTs, // Only fetch messages newer than what we have\n        latest: upperBoundTs, // Do not race live socket events after startup\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 mikan's messages, external app/bot messages, and user messages.\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      const isExternalBotMessage = !!msg.bot_id || msg.subtype === \"bot_message\";\n      if (isExternalBotMessage) {\n        if (this.botId && msg.bot_id === this.botId) return false;\n        if (\n          msg.subtype !== undefined &&\n          msg.subtype !== \"bot_message\" &&\n          msg.subtype !== \"file_share\"\n        ) {\n          return false;\n        }\n        return (\n          !!msg.text ||\n          !!(msg.files && msg.files.length > 0) ||\n          !!msg.blocks?.length ||\n          !!msg.attachments?.length\n        );\n      }\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 isMikanMessage = msg.user === this.botUserId;\n      const isExternalBotMessage =\n        !isMikanMessage && (!!msg.bot_id || msg.subtype === \"bot_message\");\n      if (isExternalBotMessage) {\n        await this.logExternalBotMessage({ ...msg, channel: channelId, ts: msg.ts! });\n        continue;\n      }\n\n      const user = this.users.get(msg.user!);\n      const text = this.stripOwnMention(msg.text);\n      const attachments = msg.files\n        ? await 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        threadTs: msg.thread_ts,\n        user: isMikanMessage ? \"bot\" : msg.user!,\n        userName: isMikanMessage ? undefined : user?.userName,\n        displayName: isMikanMessage ? undefined : user?.displayName,\n        text,\n        attachments,\n        isBot: isMikanMessage,\n      });\n    }\n\n    return relevantMessages.length;\n  }\n\n  private async backfillAllChannels(upperBoundTs?: string): Promise<void> {\n    const startTime = Date.now();\n\n    // Only backfill channels that already have a log.jsonl (mikan 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, upperBoundTs);\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 type { KnownBlock } from \"@slack/types\";\nimport { WebClient } from \"@slack/web-api\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { basename, join } from \"path\";\nimport type {\n  Bot,\n  BotAdapters,\n  BotEvent,\n  BotHandler,\n  ChatMessage,\n  ChatResponseContext,\n  ChatToolResult,\n  ConversationKind,\n  PlatformInfo,\n} from \"../../adapter.js\";\nimport { resolveConversationSettings } from \"../../config.js\";\nimport type { EventsWatcher } from \"../../events.js\";\nimport * as log from \"../../log.js\";\nimport type { Attachment, ChannelStore } from \"../../store.js\";\nimport type {\n  SlackBlockAction,\n  SlackBlockActionBody,\n  SlackChannel,\n  SlackEvent,\n  SlackUser,\n} from \"./types.js\";\nimport { PRODUCT_NAME, formatForceStopped, formatNothingRunning } from \"../../platform-messages.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  ChannelQueue,\n  resolveOnlyScopedStopTarget,\n  resolveStopTarget,\n  withRetry,\n} from \"../shared.js\";\nimport { processMessageIntake } from \"../intake.js\";\nimport { createSlackAdapters } from \"./context.js\";\nimport {\n  hasMaterializedChatSession,\n  registerThreadSession,\n} from \"../../sessions/chat-session-manager.js\";\nimport {\n  isSlackThreadSessionKey,\n  planSlackAdapterSession,\n  planSlackEventAnchorRun,\n  resolveSlackSessionKey,\n} from \"./session.js\";\nimport { reportUserFacingError } from \"../../observability/sentry.js\";\n\nconst SLACK_EVENT_ANCHOR_TEXT = \"Working on it...\";\n\n// Slack WebClient errors carry either `code: \"rate_limited\"` (retry-after) or\n// the legacy `data.error === \"rate_limited\"` / 429 status shape.\nfunction slackIsRateLimited(err: Error): boolean {\n  if ((err as { code?: unknown }).code === \"rate_limited\") return true;\n  const data = (err as { data?: { error?: string; response?: { status?: number } } }).data;\n  return data?.error === \"rate_limited\" || data?.response?.status === 429;\n}\n\nconst slackRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: slackIsRateLimited });\n\nfunction collectSlackText(value: unknown, parts: string[]): void {\n  if (value === null || value === undefined) return;\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed) parts.push(trimmed);\n    return;\n  }\n  if (Array.isArray(value)) {\n    for (const item of value) collectSlackText(item, parts);\n    return;\n  }\n  if (typeof value !== \"object\") return;\n\n  const obj = value as Record<string, unknown>;\n  for (const key of [\"text\", \"fallback\", \"title\", \"value\"] as const) {\n    collectSlackText(obj[key], parts);\n  }\n  collectSlackText(obj.fields, parts);\n  collectSlackText(obj.elements, parts);\n  collectSlackText(obj.blocks, parts);\n}\n\nfunction buildSlackAppMessageText(event: {\n  text?: string;\n  blocks?: unknown[];\n  attachments?: unknown[];\n}): string {\n  const parts: string[] = [];\n  collectSlackText(event.text, parts);\n  collectSlackText(event.blocks, parts);\n  collectSlackText(event.attachments, parts);\n  const deduped = parts.filter((part, index) => parts.indexOf(part) === index);\n  return deduped.join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// Shared mrkdwn truncation helper\n// ---------------------------------------------------------------------------\n\nconst MRKDWN_CONTEXT_TEXT_LIMIT = 3000;\n\n/**\n * Build a Slack context block whose text is capped at the mrkdwn limit.\n * Used for muted diagnostics and ephemeral command responses.\n */\nexport function buildMrkdwnContextBlock(text: string): object {\n  const blockText =\n    text.length > MRKDWN_CONTEXT_TEXT_LIMIT\n      ? text.substring(0, MRKDWN_CONTEXT_TEXT_LIMIT - 20) + \"\\n_(truncated)_\"\n      : text;\n  return { type: \"context\", elements: [{ type: \"mrkdwn\", text: blockText }] };\n}\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type { SlackChannel, SlackEvent, SlackUser } from \"./types.js\";\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 botId: string | null = null;\n  private ownMentionRegex: RegExp | 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  private createAdapters(event: SlackEvent): BotAdapters {\n    return createSlackAdapters(event, this, {\n      replyMode:\n        resolveConversationSettings(join(this.workingDir, event.conversationId)).slack?.replyMode ??\n        \"top-level\",\n    });\n  }\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({\n      appToken: config.appToken,\n      // Default 5s is too tight: brief event-loop stalls (e.g. backfill, sync fs)\n      // cause false pong timeouts; 4 in a row makes Slack drop the socket.\n      clientPingTimeout: 12_000,\n    });\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    this.botId = typeof auth.bot_id === \"string\" ? auth.bot_id : null;\n\n    await Promise.all([this.fetchUsers(), this.fetchChannels()]);\n    log.logInfo(`Loaded ${this.channels.size} channels, ${this.users.size} users`);\n\n    // Record startup time before opening the socket. Slack may replay older events;\n    // those should be logged but not processed. Backfill runs in the background up\n    // to this timestamp so startup is not blocked by one history call per channel.\n    this.startupTs = (Date.now() / 1000).toFixed(6);\n\n    this.setupEventHandlers();\n    await this.socketClient.start();\n\n    log.logConnected(\"Slack\");\n\n    void this.backfillAllChannels(this.startupTs).catch((error) => {\n      log.logWarning(\"Slack backfill failed\", String(error));\n    });\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  private stripOwnMention(text: string | undefined): string {\n    const source = text ?? \"\";\n    if (!this.botUserId) return source.trim();\n    if (!this.ownMentionRegex || !this.ownMentionRegex.source.includes(this.botUserId)) {\n      this.ownMentionRegex = new RegExp(`<@${this.botUserId}>`, \"gi\");\n    }\n    return source.replace(this.ownMentionRegex, \"\").trim();\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({ channel, text });\n      return result.ts as string;\n    });\n  }\n\n  async postEphemeral(\n    channel: string,\n    user: string,\n    text: string,\n    threadTs?: string,\n  ): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.postEphemeral({\n        channel,\n        user,\n        text,\n        ...(threadTs ? { thread_ts: threadTs } : {}),\n      });\n    });\n  }\n\n  async postEphemeralBlocks(\n    channel: string,\n    user: string,\n    text: string,\n    blocks: object[],\n    threadTs?: string,\n  ): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.postEphemeral({\n        channel,\n        user,\n        text,\n        blocks: blocks as KnownBlock[],\n        ...(threadTs ? { thread_ts: threadTs } : {}),\n      });\n    });\n  }\n\n  async postMessageBlocks(channel: string, text: string, blocks: object[]): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({\n        channel,\n        text,\n        blocks: blocks as KnownBlock[],\n      });\n      return result.ts as string;\n    });\n  }\n\n  async postPrivate(conversationId: string, userId: string, text: string): Promise<void> {\n    await this.postEphemeral(conversationId, userId, text);\n  }\n\n  async postPrivateDiagnostic(\n    conversationId: string,\n    userId: string,\n    text: string,\n    options?: { style?: \"muted\" | \"error\" },\n  ): Promise<void> {\n    if (options?.style !== \"muted\") {\n      await this.postEphemeral(\n        conversationId,\n        userId,\n        options?.style === \"error\" ? `_${text}_` : text,\n      );\n      return;\n    }\n    await this.postEphemeralBlocks(conversationId, userId, text, [buildMrkdwnContextBlock(text)]);\n  }\n\n  async openDirectMessage(userId: string): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.conversations.open({ users: userId });\n      const channelId = result.channel?.id;\n      if (!channelId) {\n        throw new Error(`Failed to open DM for user ${userId}`);\n      }\n      return channelId;\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.update({ channel, ts, text });\n    });\n  }\n\n  async startMessageStream(channel: string, text: string, threadTs?: string): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.apiCall(\"chat.startStream\", {\n        channel,\n        markdown_text: text,\n        ...(threadTs ? { thread_ts: threadTs } : {}),\n      });\n      const ts = (result as { ts?: string }).ts;\n      if (!ts) throw new Error(\"Slack chat.startStream did not return ts\");\n      return ts;\n    });\n  }\n\n  async appendMessageStream(channel: string, ts: string, text: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.apiCall(\"chat.appendStream\", {\n        channel,\n        ts,\n        markdown_text: text,\n      });\n    });\n  }\n\n  async stopMessageStream(channel: string, ts: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.apiCall(\"chat.stopStream\", { channel, ts });\n    });\n  }\n\n  async deleteMessage(channel: string, ts: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.chat.delete({ channel, ts });\n    });\n  }\n\n  // ==========================================================================\n  // Slack Assistant API (AI assistant experience)\n  // ==========================================================================\n\n  /** Set the status for an assistant thread (shows \"thinking\" state) */\n  async setAssistantStatus(channel: string, threadTs: string, status: string): Promise<void> {\n    return slackRetry(async () => {\n      await this.webClient.assistant.threads.setStatus({\n        channel_id: channel,\n        thread_ts: threadTs,\n        status,\n      });\n    });\n  }\n\n  async postInThread(channel: string, threadTs: string, text: string): Promise<string> {\n    return slackRetry(async () => {\n      // Use Block Kit section for long messages to trigger Slack's \"Show more\" collapsing (~700 chars)\n      const SECTION_TEXT_LIMIT = 3000;\n      if (text.length > 500) {\n        const blockText =\n          text.length > SECTION_TEXT_LIMIT\n            ? text.substring(0, SECTION_TEXT_LIMIT - 20) + \"\\n_(truncated)_\"\n            : text;\n        const result = await this.webClient.chat.postMessage({\n          channel,\n          thread_ts: threadTs,\n          text, // full text as notification fallback\n          blocks: [{ type: \"section\", text: { type: \"mrkdwn\", text: blockText } }],\n        });\n        return result.ts as string;\n      }\n      const result = await this.webClient.chat.postMessage({ channel, thread_ts: threadTs, text });\n      return result.ts as string;\n    });\n  }\n\n  async postInThreadBlocks(\n    channel: string,\n    threadTs: string,\n    text: string,\n    blocks: object[],\n  ): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({\n        channel,\n        thread_ts: threadTs,\n        text, // fallback for notifications\n        blocks: blocks as KnownBlock[],\n      });\n      return result.ts as string;\n    });\n  }\n\n  async postBlocks(channel: string, text: string, blocks: object[]): Promise<string> {\n    return slackRetry(async () => {\n      const result = await this.webClient.chat.postMessage({\n        channel,\n        text,\n        blocks: blocks as KnownBlock[],\n      });\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 slackRetry(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  logToFile(channel: string, entry: object): void {\n    appendChannelLog(this.workingDir, channel, entry);\n  }\n\n  logBotResponse(\n    channel: string,\n    text: string,\n    ts: string,\n    threadTs?: string,\n    slackBlocks?: object[],\n  ): void {\n    appendBotResponseLog(this.workingDir, channel, text, ts, threadTs, {\n      platform: \"slack\",\n      ...(slackBlocks ? { slackBlocks } : {}),\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      diagnostics: {\n        showUsageSummary: true,\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 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(async () => {\n      let anchorTs: string | undefined;\n      if (!event.thread_ts) {\n        try {\n          anchorTs = await this.postMessage(conversationId, SLACK_EVENT_ANCHOR_TEXT);\n        } catch (err) {\n          log.logWarning(\n            `Failed to post Slack event anchor for ${conversationId}`,\n            err instanceof Error ? err.message : String(err),\n          );\n          reportUserFacingError(err, {\n            domain: \"events\",\n            surface: \"event_delivery\",\n            operation: \"slack_anchor_post\",\n            severity: \"error\",\n            platform: \"slack\",\n            context: {\n              conversationId,\n              conversationKind: event.conversationKind,\n              eventTs: event.ts,\n              textLength: event.text.length,\n            },\n          });\n          throw err;\n        }\n      }\n      const eventPlan = planSlackEventAnchorRun(event, anchorTs);\n      const eventForRun = eventPlan.event;\n      if (eventPlan.initialMessageTs && eventForRun.sessionKey) {\n        registerThreadSession({\n          conversationDir: join(this.workingDir, conversationId),\n          sessionKey: eventForRun.sessionKey,\n        });\n      }\n\n      const runQueueKey = planSlackAdapterSession(eventForRun, {\n        initialMessageTs: eventPlan.initialMessageTs,\n      }).sessionKey;\n      this.getQueue(runQueueKey).enqueue(async () => {\n        const slackEvent: SlackEvent = {\n          type: eventForRun.type as SlackEvent[\"type\"],\n          conversationId,\n          conversationKind: eventForRun.conversationKind,\n          channel: conversationId,\n          ts: eventForRun.ts,\n          thread_ts: eventForRun.thread_ts,\n          user: eventForRun.user,\n          text: eventForRun.text,\n          attachments: eventForRun.attachments?.map((attachment) => ({\n            original: attachment.name,\n            localPath: attachment.localPath,\n          })),\n          sessionKey: eventForRun.sessionKey,\n        };\n        const adapters = createSlackAdapters(slackEvent, this, {\n          initialMessageTs: eventPlan.initialMessageTs,\n          replyMode:\n            resolveConversationSettings(join(this.workingDir, eventForRun.conversationId)).slack\n              ?.replyMode ?? \"top-level\",\n        });\n        return this.handler.handleEvent(eventForRun, this, adapters);\n      });\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(\"Slack\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private resolveQueueKey(conversationId: string, sessionKey: string): string {\n    if (!isSlackThreadSessionKey(sessionKey)) return sessionKey;\n    if (this.handler.isRunning(sessionKey)) return sessionKey;\n    return this.hasKnownThreadSession(conversationId, sessionKey) ? sessionKey : conversationId;\n  }\n\n  private hasKnownThreadSession(conversationId: string, sessionKey: string): boolean {\n    return hasMaterializedChatSession({\n      conversationDir: join(this.workingDir, conversationId),\n      sessionKey,\n    });\n  }\n\n  private processSlackMessageIntake(options: {\n    event: SlackEvent;\n    attachmentsPromise: Promise<Attachment[]>;\n    queueKey: string;\n    isAutoReplyCandidate: boolean;\n    onNotTriggered?: () => void;\n  }): void {\n    void processMessageIntake({\n      eventBase: options.event as unknown as BotEvent,\n      workingDir: this.workingDir,\n      isAutoReplyCandidate: options.isAutoReplyCandidate,\n      logEntryBase: {},\n      processAttachments: () => options.attachmentsPromise,\n      queueKey: options.queueKey,\n      enqueue: (queueKey, work) => this.getQueue(queueKey).enqueue(work),\n      handler: this.handler,\n      bot: this,\n      createAdapters: (event) => this.createAdapters(event as SlackEvent),\n      onNotTriggered: options.onNotTriggered,\n      deferAttachmentsUntilRun: true,\n    });\n  }\n\n  private buildHomeView(): { type: \"home\"; blocks: KnownBlock[] } {\n    const blocks: object[] = [\n      {\n        type: \"section\",\n        text: {\n          type: \"mrkdwn\",\n          text: `*${PRODUCT_NAME}*\\nStart 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: PRODUCT_NAME,\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 channelLabel =\n          ev.platform === \"slack\"\n            ? (() => {\n                const channel = this.channels.get(ev.conversationId);\n                const channelName = channel ? `#${channel.name}` : ev.conversationId;\n                return `${ev.platform}:${channelName}`;\n              })()\n            : `${ev.platform}:${ev.conversationId}`;\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}\\` · ${channelLabel} · 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: blocks as KnownBlock[] };\n  }\n\n  private resolveStopTarget(channelId: string, threadTs?: string): string | null {\n    const directTarget = resolveStopTarget({\n      handler: this.handler,\n      conversationId: channelId,\n      sessionKey: resolveSlackSessionKey(channelId, threadTs),\n    });\n    if (directTarget) return directTarget;\n    if (threadTs) return null;\n    return resolveOnlyScopedStopTarget(this.handler, channelId);\n  }\n\n  private isStopText(text: string): boolean {\n    const normalized = text.trim().toLowerCase();\n    return normalized === \"stop\" || normalized === \"/stop\";\n  }\n\n  private createCommandAdapters(\n    conversationId: string,\n    userId: string,\n    userName: string | undefined,\n    text: string,\n    ts: string,\n    options: { ephemeralChannelId?: string; threadTs?: string } = {},\n  ): BotAdapters {\n    const message: ChatMessage = {\n      id: ts,\n      sessionKey: conversationId,\n      conversationKind: options.ephemeralChannelId ? \"shared\" : \"direct\",\n      userId,\n      userName,\n      text,\n      attachments: [],\n    };\n\n    const respond = async (responseText: string) => {\n      if (options.ephemeralChannelId) {\n        await this.postEphemeral(\n          options.ephemeralChannelId,\n          userId,\n          responseText,\n          options.threadTs,\n        );\n        return;\n      }\n      const messageTs = await this.postMessage(conversationId, responseText);\n      this.logBotResponse(conversationId, responseText, messageTs);\n    };\n\n    const respondMuted = async (responseText: string) => {\n      const blocks = [buildMrkdwnContextBlock(responseText)];\n      if (options.ephemeralChannelId) {\n        await this.postEphemeralBlocks(\n          options.ephemeralChannelId,\n          userId,\n          responseText,\n          blocks,\n          options.threadTs,\n        );\n        return;\n      }\n      const messageTs = await this.postMessageBlocks(conversationId, responseText, blocks);\n      this.logBotResponse(conversationId, responseText, messageTs);\n    };\n\n    const responseCtx: ChatResponseContext = {\n      respond,\n      replaceResponse: respond,\n      respondDiagnostic: async (\n        responseText: string,\n        responseOptions?: { style?: \"muted\" | \"error\" },\n      ) => {\n        if (responseOptions?.style === \"muted\") {\n          await respondMuted(responseText);\n          return;\n        }\n        await respond(responseOptions?.style === \"error\" ? `_${responseText}_` : responseText);\n      },\n      respondToolResult: async (result: ChatToolResult) => {\n        const duration = (result.durationMs / 1000).toFixed(1);\n        await respond(\n          `${result.isError ? \"Error\" : \"Done\"} ${result.toolName} (${duration}s)\\n${result.result}`,\n        );\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 {\n      message,\n      responseCtx,\n      platform: this.getPlatformInfo(),\n    };\n  }\n\n  private buildSlashCommandEvent(\n    payload: {\n      command: string;\n      text?: string;\n      channel_id: string;\n      user_id: string;\n      user_name?: string;\n      thread_ts?: string;\n    },\n    options: { type?: BotEvent[\"type\"]; includeText?: boolean; thread?: boolean } = {},\n  ): { event: BotEvent; adapters: BotAdapters } {\n    const conversationId = payload.channel_id;\n    const isDirectMessage = conversationId.startsWith(\"D\");\n    const createdAt = new Date();\n    const eventTs = (createdAt.getTime() / 1000).toFixed(6);\n    const userName = payload.user_name ?? this.getUser(payload.user_id)?.userName;\n    const commandSuffix = options.includeText ? payload.text?.trim() : undefined;\n    const commandText = commandSuffix ? `${payload.command} ${commandSuffix}` : payload.command;\n    const threadTs = options.thread ? payload.thread_ts : undefined;\n    const sessionKey = options.thread\n      ? resolveSlackSessionKey(conversationId, threadTs)\n      : conversationId;\n\n    this.logToFile(conversationId, {\n      date: createdAt.toISOString(),\n      ts: eventTs,\n      user: payload.user_id,\n      userName,\n      text: commandText,\n      attachments: [],\n      isBot: false,\n      ...(threadTs ? { threadTs } : {}),\n    });\n\n    const event: BotEvent = {\n      type: options.type ?? (isDirectMessage ? \"dm\" : \"mention\"),\n      conversationId,\n      conversationKind: isDirectMessage ? \"direct\" : \"shared\",\n      ts: eventTs,\n      user: payload.user_id,\n      text: commandText,\n      attachments: [],\n      ...(threadTs ? { thread_ts: threadTs } : {}),\n      sessionKey,\n    };\n\n    const adapters = this.createCommandAdapters(\n      conversationId,\n      payload.user_id,\n      userName,\n      commandText,\n      eventTs,\n      isDirectMessage ? { threadTs } : { ephemeralChannelId: conversationId, threadTs },\n    );\n\n    return { event, adapters };\n  }\n\n  private async routeSlashLoginCommand(payload: {\n    command: string;\n    text?: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, {\n      type: payload.channel_id.startsWith(\"D\") ? \"dm\" : \"private_command\",\n      includeText: true,\n    });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private async routeSlashNewCommand(payload: {\n    command: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    const conversationId = payload.channel_id;\n    if (!conversationId.startsWith(\"D\")) {\n      await this.postEphemeral(\n        conversationId,\n        payload.user_id,\n        `為了避免誤清除共享上下文，${payload.command} 目前只能在與 ${PRODUCT_NAME} 的私訊中使用。`,\n      );\n      return;\n    }\n\n    const createdAt = new Date();\n    const eventTs = (createdAt.getTime() / 1000).toFixed(6);\n    const userName = payload.user_name ?? this.getUser(payload.user_id)?.userName;\n\n    this.logToFile(conversationId, {\n      date: createdAt.toISOString(),\n      ts: eventTs,\n      user: payload.user_id,\n      userName,\n      text: payload.command,\n      attachments: [],\n      isBot: false,\n    });\n\n    const commandBot: Bot = {\n      start: async () => {},\n      postMessage: async (_channel: string, text: string) => this.postMessage(conversationId, text),\n      updateMessage: async (channel: string, ts: string, text: string) =>\n        this.updateMessage(channel, ts, text),\n      enqueueEvent: (event: BotEvent) => this.enqueueEvent(event),\n      getPlatformInfo: () => this.getPlatformInfo(),\n    };\n    await this.handler.handleNewCommand(conversationId, conversationId, commandBot);\n  }\n\n  private async routeSlashModelCommand(payload: {\n    command: string;\n    text?: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, { includeText: true });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private async routeSlashSessionCommand(payload: {\n    command: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n    thread_ts?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, { thread: true });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private async routeSlashAdminCommand(payload: {\n    command: string;\n    channel_id: string;\n    user_id: string;\n    user_name?: string;\n    thread_ts?: string;\n  }): Promise<void> {\n    const { event, adapters } = this.buildSlashCommandEvent(payload, { thread: true });\n    await this.handler.handleEvent(event, this, adapters);\n  }\n\n  private setupEventHandlers(): void {\n    this.socketClient.on(\"disconnect\", (err: unknown) => {\n      log.logWarning(\"Slack socket disconnect\", err ? String(err) : \"\");\n    });\n    this.socketClient.on(\"error\", (err: unknown) => {\n      log.logWarning(\"Slack socket error\", err ? String(err) : \"\");\n    });\n    this.socketClient.on(\"unable_to_socket_mode_start\", (err: unknown) => {\n      log.logWarning(\"Slack socket unable_to_start\", err ? String(err) : \"\");\n    });\n\n    this.socketClient.on(\"app_mention\", (payload) => this.handleAppMention(payload));\n    this.socketClient.on(\"message\", (payload) => this.handleMessageEvent(payload));\n    this.socketClient.on(\"slash_commands\", (payload) => void this.handleSlashCommand(payload));\n    this.socketClient.on(\"app_home_opened\", (payload) => this.handleAppHomeOpened(payload));\n    this.socketClient.on(\"block_actions\", (payload) => void this.handleBlockAction(payload));\n    this.socketClient.on(\n      \"interactive\",\n      (payload) =>\n        void this.handleBlockAction(payload as { body: SlackBlockActionBody; ack: () => void }),\n    );\n  }\n\n  private handleAppMention({ event, ack }: { event: unknown; ack: () => void }): void {\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    // Top-level mentions use a persistent channel session.\n    // Thread replies get their own isolated session (channelId:thread_ts).\n    const sessionKey = resolveSlackSessionKey(e.channel, e.thread_ts);\n\n    const mentionText = this.stripOwnMention(e.text);\n    const slackEvent: SlackEvent = {\n      type: \"mention\",\n      conversationId: e.channel,\n      conversationKind: \"shared\",\n      channel: e.channel,\n      ts: e.ts,\n      thread_ts: e.thread_ts,\n      user: e.user,\n      text: mentionText || \"Please respond to the recent conversation context.\",\n      files: e.files,\n      sessionKey,\n    };\n\n    const attachmentsPromise = 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      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    // Check for stop command - execute immediately, don't queue!\n    if (this.isStopText(slackEvent.text)) {\n      const stopTarget = this.resolveStopTarget(e.channel, e.thread_ts);\n      if (stopTarget) {\n        this.handler.handleStop(stopTarget, e.channel, this);\n      } else {\n        this.postMessage(e.channel, formatNothingRunning(\"slack\"));\n      }\n      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    this.processSlackMessageIntake({\n      event: slackEvent,\n      attachmentsPromise,\n      queueKey: this.resolveQueueKey(e.channel, sessionKey),\n      isAutoReplyCandidate: false,\n    });\n\n    ack();\n  }\n\n  private handleMessageEvent({ event, ack }: { event: unknown; ack: () => void }): void {\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      app_id?: string;\n      username?: string;\n      bot_profile?: { id?: string; app_id?: string; name?: string; real_name?: string };\n      blocks?: unknown[];\n      attachments?: unknown[];\n      files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n    };\n\n    const hasFiles = !!e.files && e.files.length > 0;\n    const hasSlackContent = !!e.text || hasFiles || !!e.blocks?.length || !!e.attachments?.length;\n    const isOwnBotMessage =\n      (!!e.user && e.user === this.botUserId) || (!!this.botId && e.bot_id === this.botId);\n    if (isOwnBotMessage) {\n      ack();\n      return;\n    }\n\n    const isExternalBotMessage = !!e.bot_id || e.subtype === \"bot_message\";\n    if (isExternalBotMessage) {\n      if (e.subtype !== undefined && e.subtype !== \"bot_message\" && e.subtype !== \"file_share\") {\n        ack();\n        return;\n      }\n      if (!hasSlackContent) {\n        ack();\n        return;\n      }\n      void this.logExternalBotMessage(e).catch((err) => {\n        log.logWarning(\"Failed to log Slack bot message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    if (!e.user) {\n      ack();\n      return;\n    }\n    if (e.subtype !== undefined && e.subtype !== \"file_share\") {\n      ack();\n      return;\n    }\n    if (!hasSlackContent) {\n      ack();\n      return;\n    }\n\n    const isDM = e.channel_type === \"im\";\n    const conversationKind: ConversationKind = isDM ? \"direct\" : \"shared\";\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 isThreadReply = !!e.thread_ts;\n    const sessionKey = isDM ? resolveSlackSessionKey(e.channel, e.thread_ts) : undefined;\n\n    const slackEvent: SlackEvent = {\n      type: isDM ? \"dm\" : \"mention\",\n      conversationId: e.channel,\n      conversationKind,\n      channel: e.channel,\n      ts: e.ts,\n      thread_ts: e.thread_ts,\n      user: e.user,\n      text: this.stripOwnMention(e.text),\n      files: e.files,\n      sessionKey,\n    };\n\n    const attachmentsPromise = 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      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    // Stop command for DM only (app_mention handles shared-channel \"@mikan stop\").\n    if (isDM && this.isStopText(slackEvent.text)) {\n      const stopTarget = this.resolveStopTarget(e.channel, e.thread_ts);\n      if (stopTarget) {\n        this.handler.handleStop(stopTarget, e.channel, this);\n      } else {\n        this.postMessage(e.channel, formatNothingRunning(\"slack\"));\n      }\n      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n      ack();\n      return;\n    }\n\n    const enqueueTriggered = () => {\n      const activeSessionKey =\n        slackEvent.sessionKey ?? resolveSlackSessionKey(e.channel, e.thread_ts);\n      // Auto-reply top-level channel messages start with no sessionKey because\n      // they are only candidates until the policy allows them. Once triggered,\n      // persist the resolved key on the event; otherwise the runtime fallback\n      // treats the message ts as a thread session (`channel:ts`) instead of the\n      // persistent top-level channel session.\n      slackEvent.sessionKey = activeSessionKey;\n      this.processSlackMessageIntake({\n        event: slackEvent,\n        attachmentsPromise,\n        queueKey: this.resolveQueueKey(e.channel, activeSessionKey),\n        isAutoReplyCandidate: false,\n      });\n    };\n\n    const logOnly = () => {\n      void attachmentsPromise.catch((err) => {\n        log.logWarning(\"Failed to log Slack message\", String(err));\n      });\n    };\n\n    if (isDM) {\n      enqueueTriggered();\n      ack();\n      return;\n    }\n\n    if (isThreadReply) {\n      logOnly();\n      ack();\n      return;\n    }\n\n    const activeSessionKey = resolveSlackSessionKey(e.channel, e.thread_ts);\n    slackEvent.sessionKey = activeSessionKey;\n    this.processSlackMessageIntake({\n      event: slackEvent,\n      attachmentsPromise,\n      queueKey: this.resolveQueueKey(e.channel, activeSessionKey),\n      isAutoReplyCandidate: true,\n      onNotTriggered: logOnly,\n    });\n\n    ack();\n  }\n\n  private async handleSlashCommand({\n    body,\n    ack,\n  }: {\n    body: unknown;\n    ack: () => Promise<void>;\n  }): Promise<void> {\n    const payload = body as {\n      command?: string;\n      text?: string;\n      channel_id?: string;\n      user_id?: string;\n      user_name?: string;\n      thread_ts?: string;\n    };\n\n    await ack();\n\n    if (!payload.command || !payload.channel_id || !payload.user_id) {\n      return;\n    }\n\n    const { command, text, channel_id, user_id, user_name, thread_ts } = payload;\n\n    let handlerPromise: Promise<void> | null = null;\n    if (command === \"/pi-login\") {\n      handlerPromise = this.routeSlashLoginCommand({\n        command,\n        text,\n        channel_id,\n        user_id,\n        user_name,\n      });\n    } else if (command === \"/pi-new\") {\n      handlerPromise = this.routeSlashNewCommand({ command, channel_id, user_id, user_name });\n    } else if (command === \"/pi-session\") {\n      handlerPromise = this.routeSlashSessionCommand({\n        command,\n        channel_id,\n        user_id,\n        user_name,\n        thread_ts,\n      });\n    } else if (command === \"/pi-model\") {\n      handlerPromise = this.routeSlashModelCommand({\n        command,\n        text,\n        channel_id,\n        user_id,\n        user_name,\n      });\n    } else if (command === \"/pi-sandbox\" || command === \"/pi-auto-reply\") {\n      handlerPromise = this.routeSlashModelCommand({\n        command,\n        text,\n        channel_id,\n        user_id,\n        user_name,\n      });\n    } else if (command === \"/pi-admin\") {\n      handlerPromise = this.routeSlashAdminCommand({\n        command,\n        channel_id,\n        user_id,\n        user_name,\n        thread_ts,\n      });\n    }\n\n    if (!handlerPromise) {\n      return;\n    }\n\n    handlerPromise.catch((err) => {\n      log.logWarning(\"Slack slash command error\", err instanceof Error ? err.message : String(err));\n    });\n  }\n\n  private handleAppHomeOpened({ event, ack }: { event: unknown; ack: () => void }): void {\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  private async handleBlockAction({\n    body,\n    ack,\n  }: {\n    body: SlackBlockActionBody;\n    ack: () => void;\n  }): Promise<void> {\n    const action = body.actions?.[0];\n    if (!action) {\n      ack();\n      return;\n    }\n\n    if (!action.action_id?.startsWith(\"force_stop_\")) {\n      ack();\n      this.handleSlackInteraction(body, action);\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, formatForceStopped(\"slack\", userId ?? \"unknown\"));\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  private handleSlackInteraction(body: SlackBlockActionBody, action: SlackBlockAction): void {\n    const container = body.container ?? {};\n    const channelId = container.channel_id;\n    const userId = body.user?.id;\n    if (!channelId || !userId) return;\n\n    const selectedOption = action.selected_option;\n    const selectedOptions = Array.isArray(action.selected_options)\n      ? action.selected_options\n      : undefined;\n    const selectedText = selectedOption?.text?.text ?? selectedOption?.value;\n    const selectedTexts = selectedOptions?.map((option) => option.text?.text ?? option.value);\n    const valueText = selectedTexts?.length\n      ? selectedTexts.join(\", \")\n      : (selectedText ?? action.value ?? action.action_id);\n    const text = `[Slack action] ${action.action_id}: ${valueText}`;\n    const ts = `action:${Date.now()}`;\n    const threadTs = container.thread_ts;\n    const sessionKey = resolveSlackSessionKey(channelId, threadTs);\n\n    this.logToFile(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      ...(threadTs ? { threadTs } : {}),\n      user: userId,\n      userName: body.user?.username ?? body.user?.name,\n      text,\n      attachments: [],\n      isBot: false,\n      platform: \"slack\",\n      slackInteraction: {\n        type: \"block_actions\",\n        actionId: action.action_id,\n        blockId: action.block_id,\n        actionType: action.type,\n        value: action.value,\n        selectedOption: selectedOption\n          ? { text: selectedOption.text?.text, value: selectedOption.value }\n          : undefined,\n        selectedOptions: selectedOptions?.map((option) => ({\n          text: option.text?.text,\n          value: option.value,\n        })),\n        messageTs: container.message_ts,\n      },\n    });\n\n    const event: BotEvent = {\n      type: \"slack_action\",\n      conversationId: channelId,\n      conversationKind: channelId.startsWith(\"D\") ? \"direct\" : \"shared\",\n      ts,\n      user: userId,\n      text,\n      attachments: [],\n      ...(threadTs ? { thread_ts: threadTs } : {}),\n      sessionKey,\n    };\n\n    this.getQueue(this.resolveQueueKey(channelId, sessionKey)).enqueue(async () => {\n      const slackEvent: SlackEvent = {\n        type: event.conversationKind === \"direct\" ? \"dm\" : \"mention\",\n        conversationId: channelId,\n        conversationKind: event.conversationKind,\n        channel: channelId,\n        ts,\n        thread_ts: threadTs,\n        user: userId,\n        text,\n        attachments: [],\n        sessionKey,\n      };\n      return this.handler.handleEvent(event, this, this.createAdapters(slackEvent));\n    });\n  }\n\n  /**\n   * Log a user message to log.jsonl after attachments are ready.\n   */\n  private async logUserMessage(event: SlackEvent): Promise<Attachment[]> {\n    const user = this.users.get(event.user);\n    let attachments: Attachment[] = [];\n    let attachmentError: unknown;\n    if (event.files) {\n      try {\n        attachments = await this.store.processAttachments(event.channel, event.files, event.ts);\n      } catch (err) {\n        attachmentError = err;\n      }\n    }\n    // Always write the text log, even if attachment processing failed — we want\n    // a record of the user message regardless of file-handling errors.\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    if (attachmentError) throw attachmentError;\n    return attachments;\n  }\n\n  private async logExternalBotMessage(event: {\n    channel: string;\n    ts: string;\n    thread_ts?: string;\n    text?: string;\n    subtype?: string;\n    bot_id?: string;\n    app_id?: string;\n    username?: string;\n    bot_profile?: { app_id?: string; name?: string; real_name?: string };\n    blocks?: unknown[];\n    attachments?: unknown[];\n    files?: Array<{ name: string; url_private_download?: string; url_private?: string }>;\n  }): Promise<Attachment[]> {\n    const attachments = event.files\n      ? await this.store.processAttachments(event.channel, event.files, event.ts)\n      : [];\n    const botName =\n      event.username ?? event.bot_profile?.name ?? event.bot_profile?.real_name ?? event.bot_id;\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.bot_id ? `bot:${event.bot_id}` : \"external-bot\",\n      userName: botName,\n      displayName: botName,\n      text: buildSlackAppMessageText(event),\n      attachments,\n      isBot: true,\n      botId: event.bot_id,\n      appId: event.app_id ?? event.bot_profile?.app_id,\n      subtype: event.subtype,\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 (let i = 0; i < lines.length; i++) {\n      try {\n        const entry = JSON.parse(lines[i]);\n        if (entry.ts) timestamps.add(entry.ts);\n      } catch (err) {\n        log.logWarning(\n          `Skipping malformed log entry at ${logPath}:${i + 1}`,\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n    }\n    return timestamps;\n  }\n\n  private async backfillChannel(channelId: string, upperBoundTs?: string): Promise<number> {\n    const existingTs = await this.getExistingTimestamps(channelId);\n\n    // Find the biggest ts in log.jsonl\n    let lastLoggedTs: string | undefined;\n    for (const ts of existingTs) {\n      if (!lastLoggedTs || parseFloat(ts) > parseFloat(lastLoggedTs)) lastLoggedTs = ts;\n    }\n\n    type Message = {\n      user?: string;\n      bot_id?: string;\n      app_id?: string;\n      username?: string;\n      bot_profile?: { app_id?: string; name?: string; real_name?: string };\n      blocks?: unknown[];\n      attachments?: unknown[];\n      text?: string;\n      ts?: string;\n      thread_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: lastLoggedTs, // Only fetch messages newer than what we have\n        latest: upperBoundTs, // Do not race live socket events after startup\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 mikan's messages, external app/bot messages, and user messages.\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      const isExternalBotMessage = !!msg.bot_id || msg.subtype === \"bot_message\";\n      if (isExternalBotMessage) {\n        if (this.botId && msg.bot_id === this.botId) return false;\n        if (\n          msg.subtype !== undefined &&\n          msg.subtype !== \"bot_message\" &&\n          msg.subtype !== \"file_share\"\n        ) {\n          return false;\n        }\n        return (\n          !!msg.text ||\n          !!(msg.files && msg.files.length > 0) ||\n          !!msg.blocks?.length ||\n          !!msg.attachments?.length\n        );\n      }\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 isMikanMessage = msg.user === this.botUserId;\n      const isExternalBotMessage =\n        !isMikanMessage && (!!msg.bot_id || msg.subtype === \"bot_message\");\n      if (isExternalBotMessage) {\n        await this.logExternalBotMessage({ ...msg, channel: channelId, ts: msg.ts! });\n        continue;\n      }\n\n      const user = this.users.get(msg.user!);\n      const text = this.stripOwnMention(msg.text);\n      const attachments = msg.files\n        ? await 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        threadTs: msg.thread_ts,\n        user: isMikanMessage ? \"bot\" : msg.user!,\n        userName: isMikanMessage ? undefined : user?.userName,\n        displayName: isMikanMessage ? undefined : user?.displayName,\n        text,\n        attachments,\n        isBot: isMikanMessage,\n      });\n    }\n\n    return relevantMessages.length;\n  }\n\n  private async backfillAllChannels(upperBoundTs?: string): Promise<void> {\n    const startTime = Date.now();\n\n    // Only backfill channels that already have a log.jsonl (mikan 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, upperBoundTs);\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"]}