@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/adapters/shared.js

@@ -6,10 +6,10 @@
  * The split/normalize logic itself doesn't differ across platforms — only the
  * markup wrappers — so it lives here once.
  */
-import { appendFileSync } from "fs";
-import { mkdir, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-import { ensureDirExists } from "../utils/file-guards.js";
+import { appendFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { sameOffice } from "../office/index.js";
 import * as log from "../log.js";
 import { reportUserFacingError } from "../observability/sentry.js";
 export function createChatResponseErrorReporter(resolve) {
@@ -120,18 +120,54 @@ export function splitText(text, limit, formatContinuation) {
     return parts;
 }
 /**
- * Append a JSON-serializable entry to `${workingDir}/${channel}/log.jsonl`,
- * creating the directory on first use. This is the single write path every
+ * Append a JSON-serializable entry to the office's `log.jsonl`,
+ * materializing the office on first use. This is the single write path every
  * adapter uses for human-readable message history.
  */
-export function appendChannelLog(workingDir, channel, entry) {
-    const dir = join(workingDir, channel);
-    ensureDirExists(dir);
-    appendFileSync(join(dir, "log.jsonl"), `${JSON.stringify(entry)}\n`);
+export function appendChannelLog(office, entry) {
+    office.ensure();
+    appendFileSync(office.logPath, `${JSON.stringify(entry)}\n`);
+}
+/**
+ * Save incoming platform files under the office's attachments directory.
+ *
+ * The one owner of the attachment convention: sanitized
+ * `<timestamp>_<name>` filenames, the `<office key>/attachments/<file>`
+ * workspace-relative localPath the agent reads, and office materialization
+ * before the first write. Download mechanics and failure policy stay with
+ * the adapter — failures come back in `failed` for the caller to throw or
+ * warn about, matching its platform's behavior.
+ */
+export async function saveIncomingAttachments(office, items) {
+    if (items.length === 0)
+        return { saved: [], failed: [] };
+    // Attachment downloads can be the office's first write; materialize (and
+    // register) it before composing office-relative attachment paths.
+    office.ensure();
+    await mkdir(office.attachmentsDir, { recursive: true });
+    // Results keep the caller's item order regardless of download completion
+    // order — platform message logs list attachments as the platform sent them.
+    const results = await Promise.all(items.map(async (item) => {
+        const sanitized = item.name.replace(/[^a-zA-Z0-9._-]/g, "_");
+        const filename = `${item.timestampMs ?? Date.now()}_${sanitized}`;
+        try {
+            await item.download(join(office.attachmentsDir, filename));
+            return {
+                saved: { original: item.name, localPath: `${office.key}/attachments/${filename}` },
+            };
+        }
+        catch (error) {
+            return { failed: { name: item.name, error } };
+        }
+    }));
+    return {
+        saved: results.flatMap((result) => (result.saved ? [result.saved] : [])),
+        failed: results.flatMap((result) => (result.failed ? [result.failed] : [])),
+    };
 }
 /** Convenience for appending the bot's own outbound message. */
-export function appendBotResponseLog(workingDir, channel, text, ts, threadTs, extraFields = {}) {
-    appendChannelLog(workingDir, channel, {
+export function appendBotResponseLog(office, text, ts, threadTs, extraFields = {}) {
+    appendChannelLog(office, {
         date: new Date().toISOString(),
         ts,
         ...(threadTs ? { threadTs } : {}),
@@ -150,23 +186,25 @@ export function appendBotResponseLog(workingDir, channel, text, ts, threadTs, ex
  *   2. The bare conversationId, if running.
  */
 export function resolveStopTarget(input) {
-    const { handler, conversationId, sessionKey } = input;
-    if (sessionKey && handler.isRunning(sessionKey))
+    const { handler, address, sessionKey } = input;
+    if (sessionKey && handler.isRunning(address, sessionKey))
         return sessionKey;
-    if (handler.isRunning(conversationId))
-        return conversationId;
+    if (handler.isRunning(address, address.conversationId))
+        return address.conversationId;
     return null;
 }
 /**
- * Return the single running scoped session for this conversation, or null when
- * there are zero or multiple matches.
+ * Return the single running scoped session for this office, or null when there
+ * are zero or multiple matches. Another platform's identically named
+ * conversation is a different office and is never a stop target.
  */
-export function resolveOnlyScopedStopTarget(handler, conversationId) {
+export function resolveOnlyScopedStopTarget(handler, address) {
     const runningScopes = handler
         .getRunningSessions()
-        .map((s) => s.sessionKey)
-        .filter((k) => k.startsWith(`${conversationId}:`));
-    return runningScopes.length === 1 ? runningScopes[0] : null;
+        .filter((session) => sameOffice(session.address, address))
+        .map((session) => session.sessionKey)
+        .filter((key) => key.startsWith(`${address.conversationId}:`));
+    return runningScopes.length === 1 ? (runningScopes[0] ?? null) : null;
 }
 /**
  * Render tool-call args for human display. Drops `label` (already in the

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 { mkdir, writeFile } from \"fs/promises\";\nimport { dirname, join } from \"path\";\nimport type { MessagingEventHandler } 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  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 MessagingEventQueue {\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    isMessagingBot: 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: MessagingEventHandler,\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(dirname(destPath), { recursive: true });\n  await writeFile(destPath, Buffer.from(buffer));\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 \"node:fs\";\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport type { MessagingEventHandler, OfficeAddress } from \"../adapter.js\";\nimport { sameOffice, type Office } from \"../office/index.js\";\nimport * as log from \"../log.js\";\nimport { reportUserFacingError } from \"../observability/sentry.js\";\nexport type {\n  ChatResponseErrorContext,\n  ChatResponseErrorOperation,\n  ChatResponseErrorReporter,\n  IncomingAttachment,\n  ResolveStopTargetInput,\n  RetryOptions,\n  SavedAttachments,\n} from \"./types.js\";\nimport type {\n  ChatResponseErrorContext,\n  ChatResponseErrorReporter,\n  IncomingAttachment,\n  RetryOptions,\n  ResolveStopTargetInput,\n  SavedAttachments,\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 MessagingEventQueue {\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 the office's `log.jsonl`,\n * materializing the office on first use. This is the single write path every\n * adapter uses for human-readable message history.\n */\nexport function appendChannelLog(office: Office, entry: object): void {\n  office.ensure();\n  appendFileSync(office.logPath, `${JSON.stringify(entry)}\\n`);\n}\n\n/**\n * Save incoming platform files under the office's attachments directory.\n *\n * The one owner of the attachment convention: sanitized\n * `<timestamp>_<name>` filenames, the `<office key>/attachments/<file>`\n * workspace-relative localPath the agent reads, and office materialization\n * before the first write. Download mechanics and failure policy stay with\n * the adapter — failures come back in `failed` for the caller to throw or\n * warn about, matching its platform's behavior.\n */\nexport async function saveIncomingAttachments(\n  office: Office,\n  items: readonly IncomingAttachment[],\n): Promise<SavedAttachments> {\n  if (items.length === 0) return { saved: [], failed: [] };\n  // Attachment downloads can be the office's first write; materialize (and\n  // register) it before composing office-relative attachment paths.\n  office.ensure();\n  await mkdir(office.attachmentsDir, { recursive: true });\n\n  // Results keep the caller's item order regardless of download completion\n  // order — platform message logs list attachments as the platform sent them.\n  const results = await Promise.all(\n    items.map(async (item) => {\n      const sanitized = item.name.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${item.timestampMs ?? Date.now()}_${sanitized}`;\n      try {\n        await item.download(join(office.attachmentsDir, filename));\n        return {\n          saved: { original: item.name, localPath: `${office.key}/attachments/${filename}` },\n        };\n      } catch (error) {\n        return { failed: { name: item.name, error } };\n      }\n    }),\n  );\n  return {\n    saved: results.flatMap((result) => (result.saved ? [result.saved] : [])),\n    failed: results.flatMap((result) => (result.failed ? [result.failed] : [])),\n  };\n}\n\n/** Convenience for appending the bot's own outbound message. */\nexport function appendBotResponseLog(\n  office: Office,\n  text: string,\n  ts: string,\n  threadTs?: string,\n  extraFields: Record<string, unknown> = {},\n): void {\n  appendChannelLog(office, {\n    date: new Date().toISOString(),\n    ts,\n    ...(threadTs ? { threadTs } : {}),\n    user: \"bot\",\n    text,\n    attachments: [],\n    isMessagingBot: 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, address, sessionKey } = input;\n\n  if (sessionKey && handler.isRunning(address, sessionKey)) return sessionKey;\n  if (handler.isRunning(address, address.conversationId)) return address.conversationId;\n  return null;\n}\n\n/**\n * Return the single running scoped session for this office, or null when there\n * are zero or multiple matches. Another platform's identically named\n * conversation is a different office and is never a stop target.\n */\nexport function resolveOnlyScopedStopTarget(\n  handler: MessagingEventHandler,\n  address: OfficeAddress,\n): string | null {\n  const runningScopes = handler\n    .getRunningSessions()\n    .filter((session) => sameOffice(session.address, address))\n    .map((session) => session.sessionKey)\n    .filter((key) => key.startsWith(`${address.conversationId}:`));\n\n  return runningScopes.length === 1 ? (runningScopes[0] ?? null) : 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(dirname(destPath), { recursive: true });\n  await writeFile(destPath, Buffer.from(buffer));\n}\n"]}

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

@@ -0,0 +1,101 @@
+/** The `assistant_thread` payload on the `assistant_view` lifecycle events. */
+export interface AssistantThreadPayload {
+    user_id?: string;
+    channel_id?: string;
+    thread_ts?: string;
+    context?: AgentContext;
+}
+/**
+ * Which channel the person is viewing beside the pane. Slack spells this
+ * `context` on `app_home_opened` and `app_context_changed`, and `app_context`
+ * on `message.im` — the asymmetry is Slack's, normalized here.
+ */
+export interface AgentContext {
+    channel_id?: string;
+    team_id?: string;
+    enterprise_id?: string | null;
+}
+export interface SuggestedPrompt {
+    title: string;
+    message: string;
+}
+/** What the adapter needs from the bot to serve this surface. */
+export interface AssistantSurfaceOps {
+    postInThread(channel: string, threadTs: string, text: string): Promise<string>;
+    /** `threadTs` omitted pins the prompts to the DM instead of one thread. */
+    setSuggestedPrompts(channel: string, threadTs: string | undefined, prompts: SuggestedPrompt[]): Promise<void>;
+    setTitle(channel: string, threadTs: string, title: string): Promise<void>;
+    /** Human-readable channel name for context, when the bot knows it. */
+    channelName(channelId: string): string | undefined;
+}
+/**
+ * Which conversations belong to this surface, and the context Slack last
+ * reported for each.
+ *
+ * Two levels, because the two manifest keys register at different grains: an
+ * `agent_view` DM is known before any thread exists, while an
+ * `assistant_view` thread is known individually.
+ *
+ * In memory on purpose: transient UI state that Slack re-sends on open and on
+ * every change, so a restart self-heals on the next interaction. Persisting it
+ * would add a store to keep consistent for nothing that survives the trip.
+ */
+export declare class AssistantThreadRegistry {
+    private threads;
+    private channels;
+    private titled;
+    private key;
+    /** An `assistant_view` thread. */
+    remember(channelId: string, threadTs: string, context?: AgentContext): void;
+    /** An `agent_view` DM, which has no thread yet. */
+    rememberChannel(channelId: string, context?: AgentContext): void;
+    /** Thread context, falling back to the channel's. */
+    contextFor(channelId: string, threadTs: string): AgentContext | undefined;
+    channelContext(channelId: string): AgentContext | undefined;
+    /**
+     * Whether this thread is part of the pane — either registered individually,
+     * or living in a DM known to be the agent surface. The second case is what
+     * makes titles work under `agent_view`, where Slack opens threads itself and
+     * never announces them.
+     */
+    isAgentSurface(channelId: string, threadTs: string): boolean;
+    /** True the first time a thread is seen, so a title is set exactly once. */
+    claimTitle(channelId: string, threadTs: string): boolean;
+}
+/**
+ * `assistant_view`: a new conversation opened. Greet, and offer prompts for
+ * that thread.
+ *
+ * Failures are logged, never thrown. A greeting that did not post is a worse
+ * pane, not a broken conversation, and taking the socket handler down over it
+ * would break the surface entirely.
+ */
+export declare function handleAssistantThreadStarted(ops: AssistantSurfaceOps, registry: AssistantThreadRegistry, thread: AssistantThreadPayload): Promise<void>;
+/**
+ * `agent_view`: the person opened the app's DM. Refresh the prompts pinned to
+ * it — and deliberately do not greet, because Slack sends this on *every*
+ * open, so a greeting here would arrive again and again.
+ */
+export declare function handleAgentDmOpened(ops: AssistantSurfaceOps, registry: AssistantThreadRegistry, channelId: string, context?: AgentContext): Promise<void>;
+/**
+ * The person navigated elsewhere. Recorded at both grains so the next turn —
+ * and the next prompt refresh — knows where they are, whichever manifest key
+ * this app uses.
+ */
+export declare function handleAgentContextChanged(registry: AssistantThreadRegistry, payload: {
+    channel_id?: string;
+    thread_ts?: string;
+    context?: AgentContext;
+}): void;
+/**
+ * Title a conversation from the first thing the person said, so the pane's
+ * sidebar is navigable. Without it every past conversation looks the same.
+ */
+export declare function titleAssistantThread(ops: AssistantSurfaceOps, registry: AssistantThreadRegistry, channelId: string, threadTs: string, firstMessage: string): Promise<void>;
+/**
+ * First line, trimmed to something a sidebar can show. Deliberately not a
+ * model call: a title is worth having immediately and cheaply, and the
+ * person's own words label the conversation better than a paraphrase.
+ */
+export declare function summarizeTitle(message: string): string;
+//# sourceMappingURL=assistant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/assistant.ts"],"names":[],"mappings":"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"}

package/dist/adapters/slack/assistant.js

@@ -0,0 +1,204 @@
+/**
+ * Slack's agent / assistant surface — the app's own pane, separate from
+ * channels and ordinary DMs.
+ *
+ * There are two of these, not one, and they differ in which events signal
+ * "someone opened a conversation":
+ *
+ * | Manifest key      | Opened signal                        | Prompts       |
+ * | ----------------- | ------------------------------------ | ------------- |
+ * | `agent_view`      | `app_home_opened` with tab=`messages` | pinned to the DM |
+ * | `assistant_view`  | `assistant_thread_started`           | per thread    |
+ *
+ * Slack's own words for the newer one: "rely on the `app_home_opened` event to
+ * know when a user has actively opened a DM with your app", and
+ * "the `assistant_thread_started` event no longer indicates this". What the
+ * docs do *not* say is whether `assistant_thread_started` still fires for an
+ * `agent_view` app — so both paths are handled rather than guessed at, which
+ * also means an app on either manifest key works without a migration.
+ *
+ * The two signals need different behaviour, and conflating them would be a
+ * bug: `assistant_thread_started` fires once per new conversation, so greeting
+ * is right; `app_home_opened` fires **every time the pane is opened**, so
+ * greeting there would nag. The agent path therefore only refreshes the
+ * pinned prompts, which is idempotent.
+ *
+ * Session semantics are deliberately unchanged. Each conversation is a thread
+ * and mikan already scopes a thread to its own session — the right shape,
+ * because the pane's sidebar is a list of separate conversations rather than
+ * one transcript. Continuity across them comes from the office's memory.
+ *
+ * Suggested prompts are deterministic, varying only with the channel Slack
+ * says the person is viewing. Enough to feel aware without spending a model
+ * call before they have typed anything.
+ */
+import * as log from "../../log.js";
+const GREETING = "有什麼我可以幫忙的？";
+const GREETING_WITH_CHANNEL = (channel) => `有什麼我可以幫忙的？我看得到你正在 #${channel}。`;
+/** Prompts offered with no channel context — general-purpose starting points. */
+const DEFAULT_PROMPTS = [
+    { title: "看看工作區", message: "這個工作區裡有什麼？先給我一個概覽。" },
+    { title: "最近的變更", message: "最近的程式碼變更有哪些？挑重要的說。" },
+    { title: "排一個提醒", message: "幫我排一個每天早上的提醒。" },
+];
+/**
+ * Prompts when Slack tells us which channel the person is looking at. Naming
+ * the channel is the cheap half of "context-aware": it costs nothing and it is
+ * what makes the suggestions feel addressed to the moment.
+ */
+function promptsFor(channel) {
+    if (!channel)
+        return DEFAULT_PROMPTS;
+    return [
+        { title: `#${channel} 在討論什麼`, message: `幫我摘要 #${channel} 最近的討論。` },
+        { title: "有什麼要我接手", message: `#${channel} 裡有沒有需要我處理或追蹤的事？` },
+        { title: "看看工作區", message: "這個工作區裡有什麼？先給我一個概覽。" },
+    ];
+}
+/**
+ * Which conversations belong to this surface, and the context Slack last
+ * reported for each.
+ *
+ * Two levels, because the two manifest keys register at different grains: an
+ * `agent_view` DM is known before any thread exists, while an
+ * `assistant_view` thread is known individually.
+ *
+ * In memory on purpose: transient UI state that Slack re-sends on open and on
+ * every change, so a restart self-heals on the next interaction. Persisting it
+ * would add a store to keep consistent for nothing that survives the trip.
+ */
+export class AssistantThreadRegistry {
+    constructor() {
+        this.threads = new Map();
+        this.channels = new Map();
+        this.titled = new Set();
+    }
+    key(channelId, threadTs) {
+        return `${channelId}\n${threadTs}`;
+    }
+    /** An `assistant_view` thread. */
+    remember(channelId, threadTs, context) {
+        this.threads.set(this.key(channelId, threadTs), context ?? {});
+    }
+    /** An `agent_view` DM, which has no thread yet. */
+    rememberChannel(channelId, context) {
+        this.channels.set(channelId, context ?? {});
+    }
+    /** Thread context, falling back to the channel's. */
+    contextFor(channelId, threadTs) {
+        return this.threads.get(this.key(channelId, threadTs)) ?? this.channels.get(channelId);
+    }
+    channelContext(channelId) {
+        return this.channels.get(channelId);
+    }
+    /**
+     * Whether this thread is part of the pane — either registered individually,
+     * or living in a DM known to be the agent surface. The second case is what
+     * makes titles work under `agent_view`, where Slack opens threads itself and
+     * never announces them.
+     */
+    isAgentSurface(channelId, threadTs) {
+        return this.threads.has(this.key(channelId, threadTs)) || this.channels.has(channelId);
+    }
+    /** True the first time a thread is seen, so a title is set exactly once. */
+    claimTitle(channelId, threadTs) {
+        const key = this.key(channelId, threadTs);
+        if (this.titled.has(key))
+            return false;
+        this.titled.add(key);
+        return true;
+    }
+}
+/**
+ * `assistant_view`: a new conversation opened. Greet, and offer prompts for
+ * that thread.
+ *
+ * Failures are logged, never thrown. A greeting that did not post is a worse
+ * pane, not a broken conversation, and taking the socket handler down over it
+ * would break the surface entirely.
+ */
+export async function handleAssistantThreadStarted(ops, registry, thread) {
+    const channelId = thread.channel_id;
+    const threadTs = thread.thread_ts;
+    if (!channelId || !threadTs)
+        return;
+    registry.remember(channelId, threadTs, thread.context);
+    const channel = thread.context?.channel_id
+        ? ops.channelName(thread.context.channel_id)
+        : undefined;
+    await swallow("greeting", () => ops.postInThread(channelId, threadTs, channel ? GREETING_WITH_CHANNEL(channel) : GREETING));
+    await swallow("setSuggestedPrompts", () => ops.setSuggestedPrompts(channelId, threadTs, promptsFor(channel)));
+}
+/**
+ * `agent_view`: the person opened the app's DM. Refresh the prompts pinned to
+ * it — and deliberately do not greet, because Slack sends this on *every*
+ * open, so a greeting here would arrive again and again.
+ */
+export async function handleAgentDmOpened(ops, registry, channelId, context) {
+    if (!channelId)
+        return;
+    registry.rememberChannel(channelId, context);
+    const channel = context?.channel_id ? ops.channelName(context.channel_id) : undefined;
+    // The agent surface is otherwise silent, and its failure mode — no prompts,
+    // untitled conversations — looks identical from the outside to Slack simply
+    // not sending the event. This line is the difference between the two, and
+    // is the first thing to look for when the pane seems inert.
+    log.logInfo(`[${channelId}] Slack agent DM opened${channel ? ` (viewing #${channel})` : ""}; refreshing suggested prompts`);
+    await swallow("setSuggestedPrompts", () => ops.setSuggestedPrompts(channelId, undefined, promptsFor(channel)));
+}
+/**
+ * The person navigated elsewhere. Recorded at both grains so the next turn —
+ * and the next prompt refresh — knows where they are, whichever manifest key
+ * this app uses.
+ */
+export function handleAgentContextChanged(registry, payload) {
+    if (!payload.channel_id)
+        return;
+    // Logged for the same reason as the open event: these two are the whole
+    // agent surface, and whether either is subscribed is otherwise invisible
+    // from inside mikan.
+    log.logInfo(`[${payload.channel_id}] Slack agent context changed${payload.context?.channel_id ? ` (viewing ${payload.context.channel_id})` : ""}`);
+    if (payload.thread_ts) {
+        registry.remember(payload.channel_id, payload.thread_ts, payload.context);
+        return;
+    }
+    registry.rememberChannel(payload.channel_id, payload.context);
+}
+/**
+ * Title a conversation from the first thing the person said, so the pane's
+ * sidebar is navigable. Without it every past conversation looks the same.
+ */
+export async function titleAssistantThread(ops, registry, channelId, threadTs, firstMessage) {
+    if (!registry.isAgentSurface(channelId, threadTs))
+        return;
+    if (!registry.claimTitle(channelId, threadTs))
+        return;
+    const title = summarizeTitle(firstMessage);
+    if (!title)
+        return;
+    await swallow("setTitle", () => ops.setTitle(channelId, threadTs, title));
+}
+/**
+ * First line, trimmed to something a sidebar can show. Deliberately not a
+ * model call: a title is worth having immediately and cheaply, and the
+ * person's own words label the conversation better than a paraphrase.
+ */
+export function summarizeTitle(message) {
+    const firstLine = message
+        .replace(/<@[^>]+>/g, "")
+        .split("\n")
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (!firstLine)
+        return "";
+    return firstLine.length <= 50 ? firstLine : `${firstLine.slice(0, 49)}…`;
+}
+async function swallow(label, run) {
+    try {
+        await run();
+    }
+    catch (err) {
+        log.logWarning(`Slack agent surface ${label} failed`, err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=assistant.js.map

package/dist/adapters/slack/assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.js","sourceRoot":"","sources":["../../../src/adapters/slack/assistant.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Slack's agent / assistant surface — the app's own pane, separate from\n * channels and ordinary DMs.\n *\n * There are two of these, not one, and they differ in which events signal\n * \"someone opened a conversation\":\n *\n * | Manifest key      | Opened signal                        | Prompts       |\n * | ----------------- | ------------------------------------ | ------------- |\n * | `agent_view`      | `app_home_opened` with tab=`messages` | pinned to the DM |\n * | `assistant_view`  | `assistant_thread_started`           | per thread    |\n *\n * Slack's own words for the newer one: \"rely on the `app_home_opened` event to\n * know when a user has actively opened a DM with your app\", and\n * \"the `assistant_thread_started` event no longer indicates this\". What the\n * docs do *not* say is whether `assistant_thread_started` still fires for an\n * `agent_view` app — so both paths are handled rather than guessed at, which\n * also means an app on either manifest key works without a migration.\n *\n * The two signals need different behaviour, and conflating them would be a\n * bug: `assistant_thread_started` fires once per new conversation, so greeting\n * is right; `app_home_opened` fires **every time the pane is opened**, so\n * greeting there would nag. The agent path therefore only refreshes the\n * pinned prompts, which is idempotent.\n *\n * Session semantics are deliberately unchanged. Each conversation is a thread\n * and mikan already scopes a thread to its own session — the right shape,\n * because the pane's sidebar is a list of separate conversations rather than\n * one transcript. Continuity across them comes from the office's memory.\n *\n * Suggested prompts are deterministic, varying only with the channel Slack\n * says the person is viewing. Enough to feel aware without spending a model\n * call before they have typed anything.\n */\nimport * as log from \"../../log.js\";\n\n/** The `assistant_thread` payload on the `assistant_view` lifecycle events. */\nexport interface AssistantThreadPayload {\n  user_id?: string;\n  channel_id?: string;\n  thread_ts?: string;\n  context?: AgentContext;\n}\n\n/**\n * Which channel the person is viewing beside the pane. Slack spells this\n * `context` on `app_home_opened` and `app_context_changed`, and `app_context`\n * on `message.im` — the asymmetry is Slack's, normalized here.\n */\nexport interface AgentContext {\n  channel_id?: string;\n  team_id?: string;\n  enterprise_id?: string | null;\n}\n\nexport interface SuggestedPrompt {\n  title: string;\n  message: string;\n}\n\n/** What the adapter needs from the bot to serve this surface. */\nexport interface AssistantSurfaceOps {\n  postInThread(channel: string, threadTs: string, text: string): Promise<string>;\n  /** `threadTs` omitted pins the prompts to the DM instead of one thread. */\n  setSuggestedPrompts(\n    channel: string,\n    threadTs: string | undefined,\n    prompts: SuggestedPrompt[],\n  ): Promise<void>;\n  setTitle(channel: string, threadTs: string, title: string): Promise<void>;\n  /** Human-readable channel name for context, when the bot knows it. */\n  channelName(channelId: string): string | undefined;\n}\n\nconst GREETING = \"有什麼我可以幫忙的？\";\nconst GREETING_WITH_CHANNEL = (channel: string) =>\n  `有什麼我可以幫忙的？我看得到你正在 #${channel}。`;\n\n/** Prompts offered with no channel context — general-purpose starting points. */\nconst DEFAULT_PROMPTS: SuggestedPrompt[] = [\n  { title: \"看看工作區\", message: \"這個工作區裡有什麼？先給我一個概覽。\" },\n  { title: \"最近的變更\", message: \"最近的程式碼變更有哪些？挑重要的說。\" },\n  { title: \"排一個提醒\", message: \"幫我排一個每天早上的提醒。\" },\n];\n\n/**\n * Prompts when Slack tells us which channel the person is looking at. Naming\n * the channel is the cheap half of \"context-aware\": it costs nothing and it is\n * what makes the suggestions feel addressed to the moment.\n */\nfunction promptsFor(channel: string | undefined): SuggestedPrompt[] {\n  if (!channel) return DEFAULT_PROMPTS;\n  return [\n    { title: `#${channel} 在討論什麼`, message: `幫我摘要 #${channel} 最近的討論。` },\n    { title: \"有什麼要我接手\", message: `#${channel} 裡有沒有需要我處理或追蹤的事？` },\n    { title: \"看看工作區\", message: \"這個工作區裡有什麼？先給我一個概覽。\" },\n  ];\n}\n\n/**\n * Which conversations belong to this surface, and the context Slack last\n * reported for each.\n *\n * Two levels, because the two manifest keys register at different grains: an\n * `agent_view` DM is known before any thread exists, while an\n * `assistant_view` thread is known individually.\n *\n * In memory on purpose: transient UI state that Slack re-sends on open and on\n * every change, so a restart self-heals on the next interaction. Persisting it\n * would add a store to keep consistent for nothing that survives the trip.\n */\nexport class AssistantThreadRegistry {\n  private threads = new Map<string, AgentContext>();\n  private channels = new Map<string, AgentContext>();\n  private titled = new Set<string>();\n\n  private key(channelId: string, threadTs: string): string {\n    return `${channelId}\\n${threadTs}`;\n  }\n\n  /** An `assistant_view` thread. */\n  remember(channelId: string, threadTs: string, context?: AgentContext): void {\n    this.threads.set(this.key(channelId, threadTs), context ?? {});\n  }\n\n  /** An `agent_view` DM, which has no thread yet. */\n  rememberChannel(channelId: string, context?: AgentContext): void {\n    this.channels.set(channelId, context ?? {});\n  }\n\n  /** Thread context, falling back to the channel's. */\n  contextFor(channelId: string, threadTs: string): AgentContext | undefined {\n    return this.threads.get(this.key(channelId, threadTs)) ?? this.channels.get(channelId);\n  }\n\n  channelContext(channelId: string): AgentContext | undefined {\n    return this.channels.get(channelId);\n  }\n\n  /**\n   * Whether this thread is part of the pane — either registered individually,\n   * or living in a DM known to be the agent surface. The second case is what\n   * makes titles work under `agent_view`, where Slack opens threads itself and\n   * never announces them.\n   */\n  isAgentSurface(channelId: string, threadTs: string): boolean {\n    return this.threads.has(this.key(channelId, threadTs)) || this.channels.has(channelId);\n  }\n\n  /** True the first time a thread is seen, so a title is set exactly once. */\n  claimTitle(channelId: string, threadTs: string): boolean {\n    const key = this.key(channelId, threadTs);\n    if (this.titled.has(key)) return false;\n    this.titled.add(key);\n    return true;\n  }\n}\n\n/**\n * `assistant_view`: a new conversation opened. Greet, and offer prompts for\n * that thread.\n *\n * Failures are logged, never thrown. A greeting that did not post is a worse\n * pane, not a broken conversation, and taking the socket handler down over it\n * would break the surface entirely.\n */\nexport async function handleAssistantThreadStarted(\n  ops: AssistantSurfaceOps,\n  registry: AssistantThreadRegistry,\n  thread: AssistantThreadPayload,\n): Promise<void> {\n  const channelId = thread.channel_id;\n  const threadTs = thread.thread_ts;\n  if (!channelId || !threadTs) return;\n\n  registry.remember(channelId, threadTs, thread.context);\n  const channel = thread.context?.channel_id\n    ? ops.channelName(thread.context.channel_id)\n    : undefined;\n\n  await swallow(\"greeting\", () =>\n    ops.postInThread(channelId, threadTs, channel ? GREETING_WITH_CHANNEL(channel) : GREETING),\n  );\n  await swallow(\"setSuggestedPrompts\", () =>\n    ops.setSuggestedPrompts(channelId, threadTs, promptsFor(channel)),\n  );\n}\n\n/**\n * `agent_view`: the person opened the app's DM. Refresh the prompts pinned to\n * it — and deliberately do not greet, because Slack sends this on *every*\n * open, so a greeting here would arrive again and again.\n */\nexport async function handleAgentDmOpened(\n  ops: AssistantSurfaceOps,\n  registry: AssistantThreadRegistry,\n  channelId: string,\n  context?: AgentContext,\n): Promise<void> {\n  if (!channelId) return;\n  registry.rememberChannel(channelId, context);\n  const channel = context?.channel_id ? ops.channelName(context.channel_id) : undefined;\n  // The agent surface is otherwise silent, and its failure mode — no prompts,\n  // untitled conversations — looks identical from the outside to Slack simply\n  // not sending the event. This line is the difference between the two, and\n  // is the first thing to look for when the pane seems inert.\n  log.logInfo(\n    `[${channelId}] Slack agent DM opened${channel ? ` (viewing #${channel})` : \"\"}; refreshing suggested prompts`,\n  );\n  await swallow(\"setSuggestedPrompts\", () =>\n    ops.setSuggestedPrompts(channelId, undefined, promptsFor(channel)),\n  );\n}\n\n/**\n * The person navigated elsewhere. Recorded at both grains so the next turn —\n * and the next prompt refresh — knows where they are, whichever manifest key\n * this app uses.\n */\nexport function handleAgentContextChanged(\n  registry: AssistantThreadRegistry,\n  payload: { channel_id?: string; thread_ts?: string; context?: AgentContext },\n): void {\n  if (!payload.channel_id) return;\n  // Logged for the same reason as the open event: these two are the whole\n  // agent surface, and whether either is subscribed is otherwise invisible\n  // from inside mikan.\n  log.logInfo(\n    `[${payload.channel_id}] Slack agent context changed${payload.context?.channel_id ? ` (viewing ${payload.context.channel_id})` : \"\"}`,\n  );\n  if (payload.thread_ts) {\n    registry.remember(payload.channel_id, payload.thread_ts, payload.context);\n    return;\n  }\n  registry.rememberChannel(payload.channel_id, payload.context);\n}\n\n/**\n * Title a conversation from the first thing the person said, so the pane's\n * sidebar is navigable. Without it every past conversation looks the same.\n */\nexport async function titleAssistantThread(\n  ops: AssistantSurfaceOps,\n  registry: AssistantThreadRegistry,\n  channelId: string,\n  threadTs: string,\n  firstMessage: string,\n): Promise<void> {\n  if (!registry.isAgentSurface(channelId, threadTs)) return;\n  if (!registry.claimTitle(channelId, threadTs)) return;\n  const title = summarizeTitle(firstMessage);\n  if (!title) return;\n  await swallow(\"setTitle\", () => ops.setTitle(channelId, threadTs, title));\n}\n\n/**\n * First line, trimmed to something a sidebar can show. Deliberately not a\n * model call: a title is worth having immediately and cheaply, and the\n * person's own words label the conversation better than a paraphrase.\n */\nexport function summarizeTitle(message: string): string {\n  const firstLine = message\n    .replace(/<@[^>]+>/g, \"\")\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .find((line) => line.length > 0);\n  if (!firstLine) return \"\";\n  return firstLine.length <= 50 ? firstLine : `${firstLine.slice(0, 49)}…`;\n}\n\nasync function swallow(label: string, run: () => Promise<unknown>): Promise<void> {\n  try {\n    await run();\n  } catch (err) {\n    log.logWarning(\n      `Slack agent surface ${label} failed`,\n      err instanceof Error ? err.message : String(err),\n    );\n  }\n}\n"]}

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

@@ -1,4 +1,18 @@
 import type { KnownBlock } from "@slack/types";
+/**
+ * Resolve response-source mentions to Slack's native form.
+ *
+ * The response source is platform-neutral: the model writes `<@userName>`
+ * from the prompt's Users table, and the adapter owns the conversion to
+ * `<@U…>` — Slack only links and notifies on the raw user id. Lookup covers
+ * userName and displayName case-insensitively; native-id mentions pass
+ * through, and unknown names stay verbatim rather than guessing.
+ */
+export declare function resolveSlackMentions(source: string, users: Iterable<{
+    id: string;
+    userName: string;
+    displayName: string;
+}>): string;
 export declare function renderSlackBlocks(source: string): {
     text: string;
     blocks: KnownBlock[];

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

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/blocks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA4H/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAwDxF"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/blocks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8B/C;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,MAAM,CAiBR;AAuDD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CA6BxF"}