@letta-ai/letta-code 0.28.8 → 0.28.10

package/dist/channels-slack.js.map

@@ -0,0 +1,15 @@
+{
+  "version": 3,
+  "sources": ["../src/channels/slack/public-utils.ts", "../src/channels/slack/ingress-policy.ts", "../src/channels/progress-formatting.ts", "../src/channels/slack/progress.ts", "../src/channels/slack/sender.ts", "../src/channels/slack/status-controller.ts"],
+  "sourcesContent": [
+    "import type {\n  ChannelTurnSource,\n  OutboundChannelMessage,\n} from \"@/channels/types\";\n\nexport function isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nexport function firstNonEmptyString(...values: unknown[]): string | undefined {\n  return values.find(isNonEmptyString);\n}\n\nexport function normalizeSlackText(text: string): string {\n  return text.replace(/^(?:\\s*<@[A-Z0-9]+>\\s*)+/, \"\").trim();\n}\n\nexport function resolveSlackChatType(chatId: string): \"direct\" | \"channel\" {\n  return chatId.startsWith(\"D\") ? \"direct\" : \"channel\";\n}\n\nexport function resolveSlackSourceThreadTs(\n  source: ChannelTurnSource,\n): string | undefined {\n  if (\n    source.chatType === \"direct\" ||\n    resolveSlackChatType(source.chatId) === \"direct\"\n  ) {\n    return firstNonEmptyString(source.threadId);\n  }\n  return firstNonEmptyString(source.threadId, source.messageId);\n}\n\nexport function resolveSlackProgressThreadTs(\n  source: ChannelTurnSource,\n): string | undefined {\n  if (\n    source.chatType === \"direct\" ||\n    resolveSlackChatType(source.chatId) === \"direct\"\n  ) {\n    return firstNonEmptyString(source.threadId, source.messageId);\n  }\n  return resolveSlackSourceThreadTs(source);\n}\n\nexport function resolveSlackOutboundThreadTs(\n  msg: Pick<OutboundChannelMessage, \"chatId\" | \"threadId\" | \"replyToMessageId\">,\n): string | undefined {\n  if (resolveSlackChatType(msg.chatId) === \"direct\") {\n    return firstNonEmptyString(msg.threadId);\n  }\n  return firstNonEmptyString(msg.threadId, msg.replyToMessageId);\n}\n\nexport function normalizeSlackReactionName(value: string): string {\n  return value.trim().replace(/^:+|:+$/g, \"\");\n}\n\nexport function slackTimestampToMillis(value: string): number {\n  return Math.round(Number.parseFloat(value) * 1000);\n}\n",
+    "import {\n  firstNonEmptyString,\n  isNonEmptyString,\n  normalizeSlackText,\n  resolveSlackChatType,\n} from \"./public-utils\";\n\nconst IGNORED_SLACK_MESSAGE_SUBTYPES = new Set([\n  \"assistant_app_thread\",\n  \"channel_archive\",\n  \"channel_convert_to_private\",\n  \"channel_convert_to_public\",\n  \"channel_join\",\n  \"channel_leave\",\n  \"channel_name\",\n  \"channel_posting_permissions\",\n  \"channel_purpose\",\n  \"channel_topic\",\n  \"channel_unarchive\",\n  \"document_mention\",\n  \"ekm_access_denied\",\n  \"file_comment\",\n  \"group_archive\",\n  \"group_join\",\n  \"group_leave\",\n  \"group_name\",\n  \"group_purpose\",\n  \"group_topic\",\n  \"group_unarchive\",\n  \"pinned_item\",\n  \"reminder_add\",\n  \"unpinned_item\",\n]);\n\nconst WRAPPER_SLACK_MESSAGE_SUBTYPES = new Set([\n  \"message_changed\",\n  \"message_deleted\",\n  \"message_replied\",\n]);\n\nexport interface SlackInboundMessageEventLike {\n  channel?: unknown;\n  user?: unknown;\n  bot_id?: unknown;\n  ts?: unknown;\n  text?: unknown;\n  thread_ts?: unknown;\n  subtype?: unknown;\n  hidden?: boolean;\n  message?: unknown;\n}\n\nexport interface SlackAppMentionEventLike {\n  channel?: unknown;\n  user?: unknown;\n  bot_id?: unknown;\n  ts?: unknown;\n  text?: unknown;\n  thread_ts?: unknown;\n}\n\nexport interface ResolveSlackMessageIngressPolicyParams {\n  message: SlackInboundMessageEventLike;\n  botUserId?: string | null;\n  isAgentThread?: boolean;\n}\n\nexport interface ResolveSlackAppMentionIngressPolicyParams {\n  event: SlackAppMentionEventLike;\n}\n\nexport interface SlackMessageIngressAccepted {\n  shouldRoute: true;\n  channelId: string;\n  senderId: string;\n  senderUserId?: string;\n  senderBotId?: string;\n  messageId: string;\n  threadId: string | null;\n  chatType: \"direct\" | \"channel\";\n  text: string;\n  rawText: string;\n  wasMentioned: boolean;\n  effectiveMention: boolean;\n  isAgentThread: boolean;\n}\n\nexport interface SlackAppMentionIngressAccepted {\n  shouldRoute: true;\n  channelId: string;\n  senderId: string;\n  senderUserId?: string;\n  senderBotId?: string;\n  messageId: string;\n  threadId: string;\n  chatType: \"channel\";\n  text: string;\n  rawText: string;\n  wasMentioned: true;\n  effectiveMention: true;\n  isAgentThread: false;\n}\n\nexport type SlackIngressIgnoreReason =\n  | \"missing_channel\"\n  | \"missing_sender\"\n  | \"missing_timestamp\"\n  | \"hidden_message\"\n  | \"ignored_subtype\"\n  | \"wrapper_message\"\n  | \"top_level_channel_message\";\n\nexport interface SlackIngressIgnored {\n  shouldRoute: false;\n  reason: SlackIngressIgnoreReason;\n}\n\nexport type SlackMessageIngressPolicy =\n  | SlackMessageIngressAccepted\n  | SlackIngressIgnored;\n\nexport type SlackAppMentionIngressPolicy =\n  | SlackAppMentionIngressAccepted\n  | SlackIngressIgnored;\n\nfunction hasRecordValue(value: unknown): boolean {\n  return value !== null && typeof value === \"object\";\n}\n\nfunction hasSlackMention(\n  text: string,\n  userId: string | null | undefined,\n): boolean {\n  return (\n    isNonEmptyString(text) &&\n    isNonEmptyString(userId) &&\n    (text.includes(`<@${userId}>`) || text.includes(`<@${userId}|`))\n  );\n}\n\nfunction isBotAuthoredMessage(message: SlackInboundMessageEventLike): boolean {\n  return isNonEmptyString(message.bot_id) || message.subtype === \"bot_message\";\n}\n\nfunction resolveMessageSubtypeIgnoreReason(\n  message: SlackInboundMessageEventLike,\n): SlackIngressIgnoreReason | null {\n  const subtype = isNonEmptyString(message.subtype) ? message.subtype : null;\n  if (!subtype) {\n    return null;\n  }\n  if (IGNORED_SLACK_MESSAGE_SUBTYPES.has(subtype)) {\n    return \"ignored_subtype\";\n  }\n  if (\n    WRAPPER_SLACK_MESSAGE_SUBTYPES.has(subtype) &&\n    hasRecordValue(message.message)\n  ) {\n    return \"wrapper_message\";\n  }\n  return null;\n}\n\nexport function isProcessableSlackInboundMessage(\n  message: SlackInboundMessageEventLike,\n): boolean {\n  return resolveSlackMessageIngressPolicy({ message }).shouldRoute;\n}\n\nexport function shouldSkipSlackMessageByLastSeen(params: {\n  lastSeenMessageTs?: string | null;\n  messageTs: string;\n}): boolean {\n  return Boolean(\n    params.lastSeenMessageTs && params.lastSeenMessageTs >= params.messageTs,\n  );\n}\n\nexport function resolveSlackMessageIngressPolicy(\n  params: ResolveSlackMessageIngressPolicyParams,\n): SlackMessageIngressPolicy {\n  const { message } = params;\n  if (!isNonEmptyString(message.channel)) {\n    return { shouldRoute: false, reason: \"missing_channel\" };\n  }\n  const senderId = firstNonEmptyString(message.user, message.bot_id);\n  if (!senderId) {\n    return { shouldRoute: false, reason: \"missing_sender\" };\n  }\n  if (!isNonEmptyString(message.ts)) {\n    return { shouldRoute: false, reason: \"missing_timestamp\" };\n  }\n  if (message.hidden === true) {\n    return { shouldRoute: false, reason: \"hidden_message\" };\n  }\n\n  const subtypeIgnoreReason = resolveMessageSubtypeIgnoreReason(message);\n  if (subtypeIgnoreReason) {\n    return { shouldRoute: false, reason: subtypeIgnoreReason };\n  }\n\n  const chatType = resolveSlackChatType(message.channel);\n  const threadId =\n    chatType === \"direct\"\n      ? (firstNonEmptyString(message.thread_ts) ?? null)\n      : (firstNonEmptyString(message.thread_ts, message.ts) ?? null);\n\n  if (chatType === \"channel\" && !isNonEmptyString(message.thread_ts)) {\n    return { shouldRoute: false, reason: \"top_level_channel_message\" };\n  }\n\n  const rawText = isNonEmptyString(message.text) ? message.text : \"\";\n  const wasMentioned = hasSlackMention(rawText, params.botUserId);\n  const isAgentThread = params.isAgentThread === true;\n  const effectiveMention = isBotAuthoredMessage(message)\n    ? wasMentioned\n    : wasMentioned || isAgentThread;\n\n  return {\n    shouldRoute: true,\n    channelId: message.channel,\n    senderId,\n    ...(isNonEmptyString(message.user) ? { senderUserId: message.user } : {}),\n    ...(isNonEmptyString(message.bot_id)\n      ? { senderBotId: message.bot_id }\n      : {}),\n    messageId: message.ts,\n    threadId,\n    chatType,\n    text: wasMentioned ? normalizeSlackText(rawText) : rawText,\n    rawText,\n    wasMentioned,\n    effectiveMention,\n    isAgentThread,\n  };\n}\n\nexport function resolveSlackAppMentionIngressPolicy(\n  params: ResolveSlackAppMentionIngressPolicyParams,\n): SlackAppMentionIngressPolicy {\n  const { event } = params;\n  if (!isNonEmptyString(event.channel)) {\n    return { shouldRoute: false, reason: \"missing_channel\" };\n  }\n  const senderId = firstNonEmptyString(event.user, event.bot_id);\n  if (!senderId) {\n    return { shouldRoute: false, reason: \"missing_sender\" };\n  }\n  if (!isNonEmptyString(event.ts)) {\n    return { shouldRoute: false, reason: \"missing_timestamp\" };\n  }\n\n  const rawText = isNonEmptyString(event.text) ? event.text : \"\";\n  return {\n    shouldRoute: true,\n    channelId: event.channel,\n    senderId,\n    ...(isNonEmptyString(event.user) ? { senderUserId: event.user } : {}),\n    ...(isNonEmptyString(event.bot_id) ? { senderBotId: event.bot_id } : {}),\n    messageId: event.ts,\n    threadId: firstNonEmptyString(event.thread_ts, event.ts) ?? event.ts,\n    chatType: \"channel\",\n    text: normalizeSlackText(rawText),\n    rawText,\n    wasMentioned: true,\n    effectiveMention: true,\n    isAgentThread: false,\n  };\n}\n",
+    "const MAX_PROGRESS_TEXT_LENGTH = 140;\nexport const MAX_PROGRESS_DETAILS_LENGTH = 180;\nconst MAX_SHELL_PROGRESS_DETAILS_LENGTH = 64;\nconst MAX_SUBAGENT_PROGRESS_DETAILS_LENGTH = 180;\nconst ESCAPE_CODE = String.fromCharCode(27);\nconst ANSI_ESCAPE_RE = new RegExp(`${ESCAPE_CODE}\\\\[[0-9;?]*[ -/]*[@-~]`, \"g\");\nconst SECRET_ASSIGNMENT_RE =\n  /\\b([A-Z0-9_]*(?:TOKEN|SECRET|PASSWORD|PASS|API[_-]?KEY|ACCESS[_-]?KEY)[A-Z0-9_]*)\\s*=\\s*(\"[^\"]*\"|'[^']*'|\\S+)/gi;\nconst SECRET_JSON_RE =\n  /([\"']?(?:token|secret|password|api[_-]?key|access[_-]?key)[\"']?\\s*[:=]\\s*)(\"[^\"]*\"|'[^']*'|\\S+)/gi;\n\nfunction isTaskTool(name: string): boolean {\n  return (\n    name === \"Task\" || name === \"task\" || name === \"Agent\" || name === \"agent\"\n  );\n}\n\nfunction isShellTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return (\n    normalized === \"bash\" ||\n    normalized === \"exec_command\" ||\n    normalized === \"shell_command\" ||\n    normalized === \"shell\" ||\n    normalized === \"runshellcommand\"\n  );\n}\n\nfunction isWebSearchTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return normalized === \"web_search\" || normalized === \"websearch\";\n}\n\nfunction isSearchTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return (\n    normalized === \"grep\" ||\n    normalized === \"grep_files\" ||\n    normalized === \"grepfiles\" ||\n    normalized === \"search_file_content\" ||\n    normalized === \"searchfilecontent\"\n  );\n}\n\nfunction isGlobTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return normalized === \"glob\" || normalized === \"glob_gemini\";\n}\n\nfunction isFileReadTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return (\n    normalized === \"read\" ||\n    normalized === \"read_file\" ||\n    normalized === \"readfile\" ||\n    normalized === \"read_file_gemini\" ||\n    normalized === \"readfilegemini\"\n  );\n}\n\nfunction isFileWriteTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return (\n    normalized === \"write\" ||\n    normalized === \"write_file\" ||\n    normalized === \"writefile\" ||\n    normalized === \"write_file_gemini\" ||\n    normalized === \"writefilegemini\"\n  );\n}\n\nfunction isFileEditTool(name: string): boolean {\n  const normalized = name.toLowerCase();\n  return (\n    normalized === \"edit\" ||\n    normalized === \"multi_edit\" ||\n    normalized === \"multiedit\" ||\n    normalized === \"replace\" ||\n    normalized === \"apply_patch\" ||\n    normalized === \"applypatch\"\n  );\n}\n\nfunction getPathBaseName(filePath: string): string {\n  return filePath.split(/[\\\\/]/).filter(Boolean).pop() ?? filePath;\n}\n\nexport function asRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\"\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nexport function firstNonEmptyString(...values: unknown[]): string | undefined {\n  for (const value of values) {\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      return value;\n    }\n  }\n  return undefined;\n}\n\nexport function truncateChannelProgressText(\n  value: string,\n  maxLength: number,\n  marker = \"...\",\n): string {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  if (maxLength <= marker.length) {\n    return marker.slice(0, Math.max(0, maxLength));\n  }\n  return `${value.slice(0, maxLength - marker.length).trimEnd()}${marker}`;\n}\n\nfunction replaceControlCharacters(value: string): string {\n  let result = \"\";\n  for (let index = 0; index < value.length; index += 1) {\n    const character = value[index] ?? \"\";\n    const code = character.charCodeAt(0);\n    result +=\n      code <= 8 ||\n      code === 11 ||\n      code === 12 ||\n      (code >= 14 && code <= 31) ||\n      code === 127\n        ? \" \"\n        : character;\n  }\n  return result;\n}\n\n/**\n * Shared sanitization core for channel-facing progress text: strips ANSI\n * escapes and control characters, redacts secret-looking assignments, and\n * neutralizes platform mentions. Platform adapters layer their own escaping\n * (and truncation marker) on top of this instead of maintaining parallel\n * redaction rules.\n */\nexport function sanitizeChannelProgressCore(value: unknown): string {\n  const raw = typeof value === \"string\" ? value : String(value ?? \"\");\n  const redacted = raw\n    .replace(ANSI_ESCAPE_RE, \"\")\n    .replace(SECRET_ASSIGNMENT_RE, \"$1=[redacted]\")\n    .replace(SECRET_JSON_RE, \"$1[redacted]\");\n  return replaceControlCharacters(redacted)\n    .replace(/[\\r\\n\\t]+/g, \" \")\n    .replace(/@(?=channel|here|everyone|[A-Za-z0-9._-]+)/gi, \"@\\u200b\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\nexport function sanitizeChannelProgressText(\n  value: unknown,\n  maxLength: number = MAX_PROGRESS_TEXT_LENGTH,\n): string {\n  return truncateChannelProgressText(\n    sanitizeChannelProgressCore(value),\n    maxLength,\n  );\n}\n\nexport function sanitizeChannelProgressIdentifier(\n  value: unknown,\n  fallback: string,\n): string {\n  const text = sanitizeChannelProgressText(value, 64);\n  if (!text) {\n    return fallback;\n  }\n  const cleaned = text.replace(/[^A-Za-z0-9_.:/ -]/g, \"\").trim();\n  return cleaned || fallback;\n}\n\nfunction summarizeShellCommand(command: string): string {\n  const normalized = sanitizeChannelProgressText(command, 10_000);\n  if (!normalized) {\n    return \"\";\n  }\n\n  // Preview the first command segment (or two short ones) and drop pipelines\n  // so multi-step shell invocations stay readable at Slack-row lengths.\n  const segments = normalized\n    .split(/\\s*;\\s*/)\n    .map((segment) => segment.trim())\n    .filter(Boolean);\n  const firstTwoSegments = segments.slice(0, 2).join(\"; \");\n  const previewSource =\n    firstTwoSegments.length > 0 && firstTwoSegments.length <= 70\n      ? firstTwoSegments\n      : (segments[0] ?? normalized);\n  const withoutPipeline = previewSource.split(/\\s*\\|\\s*/)[0] ?? previewSource;\n\n  return sanitizeChannelProgressText(\n    withoutPipeline.trim() || normalized,\n    MAX_SHELL_PROGRESS_DETAILS_LENGTH,\n  );\n}\n\ntype SkillDescriptionLookup =\n  | ReadonlyMap<string, string>\n  | Readonly<Record<string, string | undefined>>;\n\nexport type ChannelTurnProgressBuilderOptions = {\n  skillDescriptionsByName?: SkillDescriptionLookup;\n};\n\nexport type ToolCallSummary = {\n  id?: string;\n  name?: string;\n  argumentsText?: string;\n};\n\nfunction getSkillNameFromArguments(\n  parsedArguments: Record<string, unknown>,\n): string | undefined {\n  return firstNonEmptyString(parsedArguments.skill, parsedArguments.skillName);\n}\n\nfunction getFragmentedSkillName(summary: ToolCallSummary): string | undefined {\n  const skillMatch = summary.argumentsText?.match(\n    /\"(?:skill|skillName)\"\\s*:\\s*\"([^\"]+)\"/,\n  );\n  return skillMatch?.[1];\n}\n\nfunction resolveSkillDescription(\n  skillName: string | undefined,\n  options: ChannelTurnProgressBuilderOptions | undefined,\n): string | undefined {\n  const lookup = options?.skillDescriptionsByName;\n  if (!skillName || !lookup) {\n    return undefined;\n  }\n  if (\"get\" in lookup && typeof lookup.get === \"function\") {\n    return firstNonEmptyString(lookup.get(skillName));\n  }\n  return firstNonEmptyString(\n    (lookup as Readonly<Record<string, string | undefined>>)[skillName],\n  );\n}\n\nfunction formatSkillProgressTitleFromName(\n  skillName: string | undefined,\n): string | undefined {\n  const sanitized = sanitizeChannelProgressText(\n    skillName,\n    MAX_PROGRESS_DETAILS_LENGTH,\n  );\n  return sanitized ? `Skill: ${sanitized}` : undefined;\n}\n\nfunction formatShellProgressDetailsFromArguments(\n  parsedArguments: Record<string, unknown>,\n): string | undefined {\n  const description = firstNonEmptyString(parsedArguments.description);\n  if (description) {\n    return (\n      sanitizeChannelProgressText(description, MAX_PROGRESS_DETAILS_LENGTH) ||\n      undefined\n    );\n  }\n\n  const commandPreview = firstNonEmptyString(\n    parsedArguments.command,\n    parsedArguments.cmd,\n  );\n  return summarizeShellCommand(commandPreview ?? \"\") || undefined;\n}\n\nfunction formatFragmentedShellProgressDetails(\n  summary: ToolCallSummary,\n): string | undefined {\n  const descriptionMatch = summary.argumentsText?.match(\n    /\"description\"\\s*:\\s*\"([^\"]+)\"/,\n  );\n  if (descriptionMatch?.[1]) {\n    return (\n      sanitizeChannelProgressText(\n        descriptionMatch[1],\n        MAX_PROGRESS_DETAILS_LENGTH,\n      ) || undefined\n    );\n  }\n\n  // Do not expose command previews from incomplete shell-tool JSON. Slack's\n  // task stream appends, rather than replaces, changed details for the same\n  // task id; sending a provisional command before the streamed description\n  // arrives leaves both strings glued together in the preview.\n  return undefined;\n}\n\nfunction formatSubagentProgressDetailsFromArguments(\n  parsedArguments: Record<string, unknown>,\n): string | undefined {\n  const preview = firstNonEmptyString(\n    parsedArguments.prompt,\n    parsedArguments.description,\n    parsedArguments.subject,\n  );\n  const sanitized = sanitizeChannelProgressText(\n    preview,\n    MAX_SUBAGENT_PROGRESS_DETAILS_LENGTH,\n  );\n  return sanitized || undefined;\n}\n\nfunction formatFragmentedSubagentProgressDetails(\n  summary: ToolCallSummary,\n): string | undefined {\n  const previewMatch = summary.argumentsText?.match(\n    /\"(?:prompt|description|subject)\"\\s*:\\s*\"([^\"]+)\"/,\n  );\n  if (!previewMatch?.[1]) {\n    return undefined;\n  }\n  const sanitized = sanitizeChannelProgressText(\n    previewMatch[1],\n    MAX_SUBAGENT_PROGRESS_DETAILS_LENGTH,\n  );\n  return sanitized || undefined;\n}\n\nexport type ToolReturnSummary = {\n  summary: ToolCallSummary;\n  status: \"completed\" | \"error\";\n  errorDetails?: string;\n};\n\nexport function parseToolArguments(\n  value: string | undefined,\n): Record<string, unknown> | null {\n  if (!value) {\n    return null;\n  }\n  try {\n    return asRecord(JSON.parse(value));\n  } catch {\n    return null;\n  }\n}\n\nfunction isFetchWebpageToolName(name: string | undefined): boolean {\n  return (\n    name === \"fetch_webpage\" ||\n    name === \"FetchWebpage\" ||\n    name === \"fetchWebpage\"\n  );\n}\n\nexport function isSkillToolName(name: string | undefined): boolean {\n  if (!name) {\n    return false;\n  }\n  const normalized = name.includes(\".\")\n    ? name.slice(name.lastIndexOf(\".\") + 1)\n    : name;\n  return normalized === \"Skill\" || normalized === \"skill\";\n}\n\nfunction isFilePathToolName(name: string): boolean {\n  return isFileReadTool(name) || isFileWriteTool(name) || isFileEditTool(name);\n}\n\nfunction getFileToolKind(name: string): \"read\" | \"write\" | \"update\" | null {\n  if (isFileReadTool(name)) {\n    return \"read\";\n  }\n  if (isFileWriteTool(name)) {\n    return \"write\";\n  }\n  if (isFileEditTool(name)) {\n    return \"update\";\n  }\n  return null;\n}\n\nfunction countProgressLines(value: string | undefined): number {\n  return value ? value.split(\"\\n\").length : 0;\n}\n\ntype LineChangeSummary = {\n  additions?: number;\n  deletions?: number;\n};\n\nfunction formatLineChangeSummary(summary: LineChangeSummary | null): string {\n  if (!summary) {\n    return \"\";\n  }\n  const parts: string[] = [];\n  if (summary.additions !== undefined) {\n    parts.push(`+${summary.additions}`);\n  }\n  if (summary.deletions !== undefined) {\n    parts.push(`-${summary.deletions}`);\n  }\n  return parts.length > 0 ? ` ${parts.join(\" \")}` : \"\";\n}\n\nfunction extractFilePathFromArguments(\n  parsedArguments: Record<string, unknown>,\n): string | undefined {\n  return firstNonEmptyString(\n    parsedArguments.file_path,\n    parsedArguments.filePath,\n    parsedArguments.path,\n  );\n}\n\nfunction formatProgressFileName(\n  filePath: string | undefined,\n): string | undefined {\n  if (!filePath) {\n    return undefined;\n  }\n  const fileName = getPathBaseName(filePath) || filePath;\n  return (\n    sanitizeChannelProgressText(fileName, MAX_PROGRESS_DETAILS_LENGTH) ||\n    undefined\n  );\n}\n\nfunction getEditLineChangeSummary(\n  parsedArguments: Record<string, unknown>,\n): LineChangeSummary | null {\n  const oldString = firstNonEmptyString(parsedArguments.old_string);\n  const newString = firstNonEmptyString(parsedArguments.new_string);\n  if (oldString === undefined || newString === undefined) {\n    return null;\n  }\n  return {\n    additions: countProgressLines(newString),\n    deletions: countProgressLines(oldString),\n  };\n}\n\nfunction getMultiEditLineChangeSummary(\n  parsedArguments: Record<string, unknown>,\n): LineChangeSummary | null {\n  if (!Array.isArray(parsedArguments.edits)) {\n    return null;\n  }\n  let additions = 0;\n  let deletions = 0;\n  let counted = false;\n  for (const edit of parsedArguments.edits) {\n    const record = asRecord(edit);\n    if (!record) {\n      continue;\n    }\n    const oldString = firstNonEmptyString(record.old_string);\n    const newString = firstNonEmptyString(record.new_string);\n    if (oldString === undefined || newString === undefined) {\n      continue;\n    }\n    additions += countProgressLines(newString);\n    deletions += countProgressLines(oldString);\n    counted = true;\n  }\n  return counted ? { additions, deletions } : null;\n}\n\nfunction getWriteLineChangeSummary(\n  parsedArguments: Record<string, unknown>,\n): LineChangeSummary | null {\n  const content = firstNonEmptyString(parsedArguments.content);\n  if (content === undefined) {\n    return null;\n  }\n  return {\n    additions: countProgressLines(content),\n  };\n}\n\nfunction getFileLineChangeSummary(\n  name: string,\n  parsedArguments: Record<string, unknown>,\n): LineChangeSummary | null {\n  if (isFileWriteTool(name)) {\n    return getWriteLineChangeSummary(parsedArguments);\n  }\n  if (name === \"MultiEdit\" || name === \"multi_edit\") {\n    return getMultiEditLineChangeSummary(parsedArguments);\n  }\n  if (isFileEditTool(name)) {\n    return getEditLineChangeSummary(parsedArguments);\n  }\n  return null;\n}\n\nfunction getFileToolVerb(\n  kind: \"read\" | \"write\" | \"update\",\n  status: \"started\" | \"completed\" | \"error\",\n): string {\n  if (status === \"error\") {\n    if (kind === \"read\") {\n      return \"Tried to read\";\n    }\n    if (kind === \"write\") {\n      return \"Tried to write\";\n    }\n    return \"Tried to update\";\n  }\n  if (status === \"started\") {\n    if (kind === \"read\") {\n      return \"Reading\";\n    }\n    if (kind === \"write\") {\n      return \"Writing\";\n    }\n    return \"Updating\";\n  }\n  if (kind === \"read\") {\n    return \"Read\";\n  }\n  if (kind === \"write\") {\n    return \"Wrote\";\n  }\n  return \"Updated\";\n}\n\nfunction formatFileToolProgressTitle(\n  name: string,\n  parsedArguments: Record<string, unknown>,\n  status: \"started\" | \"completed\" | \"error\",\n): string | undefined {\n  const kind = getFileToolKind(name);\n  if (!kind) {\n    return undefined;\n  }\n  const fileName = formatProgressFileName(\n    extractFilePathFromArguments(parsedArguments),\n  );\n  if (!fileName) {\n    return undefined;\n  }\n  const stats =\n    status === \"completed\"\n      ? formatLineChangeSummary(getFileLineChangeSummary(name, parsedArguments))\n      : \"\";\n  return `${getFileToolVerb(kind, status)} ${fileName}${stats}`;\n}\n\nfunction formatFragmentedFileToolProgressTitle(\n  summary: ToolCallSummary,\n  status: \"started\" | \"completed\" | \"error\",\n): string | undefined {\n  if (!summary.name || !summary.argumentsText) {\n    return undefined;\n  }\n  const kind = getFileToolKind(summary.name);\n  if (!kind) {\n    return undefined;\n  }\n  const filePathMatch = summary.argumentsText.match(\n    /\"(?:file_path|filePath|path)\"\\s*:\\s*\"([^\"]+)\"/,\n  );\n  const fileName = formatProgressFileName(filePathMatch?.[1]);\n  if (!fileName) {\n    return undefined;\n  }\n  return `${getFileToolVerb(kind, status)} ${fileName}`;\n}\n\nexport function formatToolProgressTitle(\n  summary: ToolCallSummary,\n  status: \"started\" | \"completed\" | \"error\",\n): string | undefined {\n  if (!summary.name || !summary.argumentsText) {\n    return undefined;\n  }\n\n  const parsedArguments = parseToolArguments(summary.argumentsText);\n  if (parsedArguments) {\n    if (isSkillToolName(summary.name)) {\n      return formatSkillProgressTitleFromName(\n        getSkillNameFromArguments(parsedArguments),\n      );\n    }\n    if (isFilePathToolName(summary.name)) {\n      return formatFileToolProgressTitle(summary.name, parsedArguments, status);\n    }\n    return undefined;\n  }\n\n  if (isSkillToolName(summary.name)) {\n    return formatSkillProgressTitleFromName(getFragmentedSkillName(summary));\n  }\n  if (isFilePathToolName(summary.name)) {\n    return formatFragmentedFileToolProgressTitle(summary, status);\n  }\n  return undefined;\n}\n\nfunction formatSkillProgressDetailsFromArguments(\n  parsedArguments: Record<string, unknown>,\n  options: ChannelTurnProgressBuilderOptions | undefined,\n): string | undefined {\n  const skillName = getSkillNameFromArguments(parsedArguments);\n  const detail = resolveSkillDescription(skillName, options) ?? skillName;\n  const sanitized = sanitizeChannelProgressText(\n    detail,\n    MAX_PROGRESS_DETAILS_LENGTH,\n  );\n  return sanitized || undefined;\n}\n\nfunction formatFragmentedSkillProgressDetails(\n  summary: ToolCallSummary,\n  options: ChannelTurnProgressBuilderOptions | undefined,\n): string | undefined {\n  const skillName = getFragmentedSkillName(summary);\n  const detail = resolveSkillDescription(skillName, options) ?? skillName;\n  const sanitized = sanitizeChannelProgressText(\n    detail,\n    MAX_PROGRESS_DETAILS_LENGTH,\n  );\n  return sanitized || undefined;\n}\n\nexport function formatToolProgressDetails(\n  summary: ToolCallSummary,\n  options?: ChannelTurnProgressBuilderOptions,\n): string | undefined {\n  if (!summary.name || !summary.argumentsText) {\n    return undefined;\n  }\n\n  // Try JSON parse first (complete arguments)\n  const parsedArguments = parseToolArguments(summary.argumentsText);\n  if (parsedArguments) {\n    if (isWebSearchTool(summary.name)) {\n      const query = firstNonEmptyString(parsedArguments.query);\n      const sanitized = sanitizeChannelProgressText(\n        query,\n        MAX_PROGRESS_DETAILS_LENGTH,\n      );\n      return sanitized || undefined;\n    }\n\n    if (isFetchWebpageToolName(summary.name)) {\n      const url = firstNonEmptyString(parsedArguments.url);\n      const sanitized = sanitizeChannelProgressText(\n        url,\n        MAX_PROGRESS_DETAILS_LENGTH,\n      );\n      return sanitized || undefined;\n    }\n\n    if (isSkillToolName(summary.name)) {\n      return formatSkillProgressDetailsFromArguments(parsedArguments, options);\n    }\n\n    if (isTaskTool(summary.name)) {\n      return formatSubagentProgressDetailsFromArguments(parsedArguments);\n    }\n\n    if (isShellTool(summary.name)) {\n      return formatShellProgressDetailsFromArguments(parsedArguments);\n    }\n\n    if (isFilePathToolName(summary.name)) {\n      const filePath = firstNonEmptyString(\n        parsedArguments.file_path,\n        parsedArguments.filePath,\n        parsedArguments.path,\n      );\n      const sanitized = sanitizeChannelProgressText(\n        filePath,\n        MAX_PROGRESS_DETAILS_LENGTH,\n      );\n      return sanitized || undefined;\n    }\n\n    if (isGlobTool(summary.name) || isSearchTool(summary.name)) {\n      const pattern = firstNonEmptyString(parsedArguments.pattern);\n      const sanitized = sanitizeChannelProgressText(\n        pattern,\n        MAX_PROGRESS_DETAILS_LENGTH,\n      );\n      return sanitized || undefined;\n    }\n\n    return undefined;\n  }\n\n  // Fallback: extract known preview fields from fragmented/incomplete JSON.\n  if (isShellTool(summary.name)) {\n    return formatFragmentedShellProgressDetails(summary);\n  }\n\n  if (isSkillToolName(summary.name)) {\n    return formatFragmentedSkillProgressDetails(summary, options);\n  }\n\n  if (isTaskTool(summary.name)) {\n    return formatFragmentedSubagentProgressDetails(summary);\n  }\n\n  if (isFilePathToolName(summary.name)) {\n    const filePathMatch = summary.argumentsText.match(\n      /\"file_path\"\\s*:\\s*\"([^\"]+)\"/,\n    );\n    if (filePathMatch?.[1]) {\n      const sanitized = sanitizeChannelProgressText(\n        filePathMatch[1],\n        MAX_PROGRESS_DETAILS_LENGTH,\n      );\n      return sanitized || undefined;\n    }\n  }\n\n  return undefined;\n}\n",
+    "import {\n  sanitizeChannelProgressCore,\n  truncateChannelProgressText,\n} from \"@/channels/progress-formatting\";\nimport type { ChannelTurnProgressEvent } from \"@/channels/types\";\nimport { isNonEmptyString } from \"./public-utils\";\n\nexport const SLACK_ASSISTANT_STARTUP_STATUS = \"is thinking...\";\nexport const SLACK_ASSISTANT_WORKING_STATUS = \"is working...\";\n\nconst SLACK_STATUS_TEXT_MAX = 300;\n\nexport function sanitizeSlackStatusText(\n  text: string,\n  maxLength: number,\n): string {\n  const normalized = sanitizeChannelProgressCore(text)\n    .replace(/[<>]/g, \"\")\n    .replace(/&/g, \"and\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n  return truncateChannelProgressText(normalized, maxLength, \"...\");\n}\n\nexport function formatSlackToolNameForDisplay(toolName: string): string {\n  if (toolName === \"Task\" || toolName === \"task\" || toolName === \"Agent\") {\n    return \"Subagent\";\n  }\n  if (\n    toolName === \"Bash\" ||\n    toolName === \"bash\" ||\n    toolName === \"exec_command\" ||\n    toolName === \"shell_command\" ||\n    toolName === \"ShellCommand\"\n  ) {\n    return \"Bash\";\n  }\n  return toolName;\n}\n\nfunction isSlackShellTool(toolName: string): boolean {\n  const normalized = toolName.toLowerCase();\n  return (\n    normalized === \"bash\" ||\n    normalized === \"exec_command\" ||\n    normalized === \"shell_command\" ||\n    normalized === \"shell\"\n  );\n}\n\nexport function resolveSlackConcreteActivity(\n  event: ChannelTurnProgressEvent,\n): string | null {\n  if (event.kind === \"command\" && isNonEmptyString(event.command)) {\n    return sanitizeSlackStatusText(\n      formatSlackToolNameForDisplay(event.command),\n      SLACK_STATUS_TEXT_MAX,\n    );\n  }\n  if (\n    event.kind !== \"tool\" ||\n    !isNonEmptyString(event.toolName) ||\n    event.toolName.toLowerCase() === \"messagechannel\"\n  ) {\n    return null;\n  }\n\n  for (const description of [\n    event.toolTitle,\n    event.toolDetails,\n    isSlackShellTool(event.toolName) ? event.message : undefined,\n    formatSlackToolNameForDisplay(event.toolName),\n  ]) {\n    if (!isNonEmptyString(description)) {\n      continue;\n    }\n    const sanitized = sanitizeSlackStatusText(\n      description,\n      SLACK_STATUS_TEXT_MAX,\n    );\n    if (sanitized) {\n      return sanitized;\n    }\n  }\n  return null;\n}\n",
+    "import type { OutboundChannelMessage } from \"@/channels/types\";\nimport {\n  normalizeSlackReactionName,\n  resolveSlackOutboundThreadTs,\n} from \"./public-utils\";\n\nexport interface SlackSenderPostMessageParams {\n  channel: string;\n  text: string;\n  threadTs?: string;\n  blocks?: unknown[];\n}\n\nexport interface SlackSenderPostMessageResult {\n  messageId: string;\n}\n\nexport interface SlackSenderMessageResult {\n  messageId: string;\n}\n\nexport interface SlackSenderReactionParams {\n  channel: string;\n  timestamp: string;\n  name: string;\n}\n\nexport interface SlackSenderClient {\n  postMessage(\n    params: SlackSenderPostMessageParams,\n  ): Promise<SlackSenderPostMessageResult>;\n  addReaction?(params: SlackSenderReactionParams): Promise<void>;\n  removeReaction?(params: SlackSenderReactionParams): Promise<void>;\n}\n\nexport interface SlackChannelSender {\n  sendMessage(\n    message: OutboundChannelMessage,\n  ): Promise<SlackSenderMessageResult>;\n  sendDirectReply(params: SlackDirectReplyParams): Promise<void>;\n}\n\nexport interface SlackDirectReplyParams {\n  chatId: string;\n  text: string;\n  replyToMessageId?: string;\n  threadId?: string | null;\n  blocks?: unknown[];\n}\n\nexport interface CreateSlackChannelSenderParams {\n  client: SlackSenderClient;\n}\n\nasync function sendSlackReaction(\n  client: SlackSenderClient,\n  message: OutboundChannelMessage,\n): Promise<SlackSenderMessageResult> {\n  const targetMessageId = message.targetMessageId ?? message.replyToMessageId;\n  if (!targetMessageId) {\n    throw new Error(\n      \"Slack reactions require message_id (or reply_to_message_id) to identify the target message.\",\n    );\n  }\n  const name = normalizeSlackReactionName(message.reaction ?? \"\");\n  if (!name) {\n    throw new Error(\"Slack reaction emoji cannot be empty.\");\n  }\n  const params: SlackSenderReactionParams = {\n    channel: message.chatId,\n    timestamp: targetMessageId,\n    name,\n  };\n  if (message.removeReaction) {\n    if (!client.removeReaction) {\n      throw new Error(\n        \"Slack sender client does not support removing reactions.\",\n      );\n    }\n    await client.removeReaction(params);\n  } else {\n    if (!client.addReaction) {\n      throw new Error(\"Slack sender client does not support adding reactions.\");\n    }\n    await client.addReaction(params);\n  }\n  return { messageId: targetMessageId };\n}\n\nexport function createSlackChannelSender(\n  params: CreateSlackChannelSenderParams,\n): SlackChannelSender {\n  const { client } = params;\n  return {\n    async sendMessage(\n      message: OutboundChannelMessage,\n    ): Promise<SlackSenderMessageResult> {\n      if (message.reaction) {\n        return await sendSlackReaction(client, message);\n      }\n      const threadTs = resolveSlackOutboundThreadTs({\n        chatId: message.chatId,\n        threadId: message.threadId,\n        replyToMessageId: message.replyToMessageId,\n      });\n      return await client.postMessage({\n        channel: message.chatId,\n        text: message.text,\n        ...(threadTs ? { threadTs } : {}),\n      });\n    },\n\n    async sendDirectReply(params: SlackDirectReplyParams): Promise<void> {\n      const threadTs = resolveSlackOutboundThreadTs({\n        chatId: params.chatId,\n        threadId: params.threadId,\n        replyToMessageId: params.replyToMessageId,\n      });\n      await client.postMessage({\n        channel: params.chatId,\n        text: params.text,\n        ...(params.blocks ? { blocks: params.blocks } : {}),\n        ...(threadTs ? { threadTs } : {}),\n      });\n    },\n  };\n}\n",
+    "import type {\n  ChannelTurnSource,\n  OutboundChannelMessage,\n} from \"@/channels/types\";\nimport {\n  firstNonEmptyString,\n  isNonEmptyString,\n  resolveSlackChatType,\n  resolveSlackProgressThreadTs,\n  resolveSlackSourceThreadTs,\n} from \"./public-utils\";\n\nconst SLACK_ASSISTANT_STATUS_KEEPALIVE_MS = 90_000;\n\nexport interface SlackStatusWriteClient {\n  assistant?: {\n    threads?: {\n      setStatus?: (args: {\n        channel_id: string;\n        thread_ts: string;\n        status: string;\n        loading_messages?: string[];\n      }) => Promise<unknown>;\n    };\n  };\n}\n\nexport type AgentConvSlackState = {\n  isThinkingActive: boolean;\n  thinkingText: string;\n  typingFooterText: string;\n};\n\nexport type SlackStatusController = {\n  getUniqueSources: (sources: ChannelTurnSource[]) => ChannelTurnSource[];\n  getLifecycleErrorReplyKey: (source: ChannelTurnSource) => string | null;\n  activate: (\n    source: ChannelTurnSource,\n    footerText: string,\n    loadingText: string,\n  ) => Promise<void>;\n  deactivate: (source: ChannelTurnSource) => Promise<void>;\n  clearStale: (source: ChannelTurnSource) => Promise<void>;\n  markAutoCleared: (source: ChannelTurnSource) => void;\n  markAutoClearedForMessage: (\n    msg: Pick<\n      OutboundChannelMessage,\n      \"agentId\" | \"conversationId\" | \"chatId\" | \"threadId\" | \"replyToMessageId\"\n    >,\n  ) => void;\n  activeSources: () => ChannelTurnSource[];\n  clear: () => void;\n};\n\nexport function createSlackStatusController(params: {\n  ensureApp: () => Promise<unknown>;\n  ensureWriteClient: () => Promise<SlackStatusWriteClient>;\n  resolveKnownThreadRoot: (messageId: string) => string;\n}): SlackStatusController {\n  const stateByConversation = new Map<string, AgentConvSlackState>();\n  const sourceByConversation = new Map<string, ChannelTurnSource>();\n  const signatureByConversation = new Map<string, string>();\n  const writePromiseByConversation = new Map<string, Promise<void>>();\n  const keepaliveByConversation = new Map<\n    string,\n    ReturnType<typeof setTimeout>\n  >();\n  const clearedStaleReplyKeys = new Set<string>();\n\n  function getConversationKey(source: ChannelTurnSource): string | null {\n    return source.channel === \"slack\" &&\n      isNonEmptyString(source.agentId) &&\n      isNonEmptyString(source.conversationId)\n      ? `${source.agentId}:${source.conversationId}`\n      : null;\n  }\n\n  function getLifecycleReplyKey(source: ChannelTurnSource): string | null {\n    if (source.channel !== \"slack\" || !isNonEmptyString(source.chatId)) {\n      return null;\n    }\n    const replyToMessageId = resolveSlackProgressThreadTs(source);\n    return isNonEmptyString(replyToMessageId)\n      ? `${source.chatId}:${replyToMessageId}`\n      : null;\n  }\n\n  function getLifecycleErrorReplyKey(source: ChannelTurnSource): string | null {\n    if (source.channel !== \"slack\" || !isNonEmptyString(source.chatId)) {\n      return null;\n    }\n    if (\n      source.chatType === \"direct\" ||\n      resolveSlackChatType(source.chatId) === \"direct\"\n    ) {\n      const replyToMessageId = resolveSlackSourceThreadTs(source);\n      return isNonEmptyString(replyToMessageId)\n        ? `${source.chatId}:${replyToMessageId}`\n        : `${source.chatId}:direct`;\n    }\n    return getLifecycleReplyKey(source);\n  }\n\n  function getUniqueSources(sources: ChannelTurnSource[]): ChannelTurnSource[] {\n    const seen = new Set<string>();\n    const unique: ChannelTurnSource[] = [];\n    for (const source of sources) {\n      const key = getConversationKey(source);\n      if (!key || seen.has(key) || !getLifecycleReplyKey(source)) continue;\n      seen.add(key);\n      unique.push(source);\n    }\n    return unique;\n  }\n\n  function clearKeepalive(key: string): void {\n    const timer = keepaliveByConversation.get(key);\n    if (timer) {\n      clearTimeout(timer);\n      keepaliveByConversation.delete(key);\n    }\n  }\n\n  async function writeStatus(\n    source: ChannelTurnSource,\n    footerText: string,\n    loadingText: string,\n    options: { force?: boolean } = {},\n  ): Promise<boolean> {\n    const stateKey = getConversationKey(source);\n    const replyKey = getLifecycleReplyKey(source);\n    const threadTs = resolveSlackProgressThreadTs(source);\n    if (!stateKey || !replyKey || !threadTs) return false;\n\n    const signature = `${footerText}\\n${loadingText}`;\n    if (!options.force && signatureByConversation.get(stateKey) === signature) {\n      return true;\n    }\n\n    await params.ensureApp();\n    const slackClient = await params.ensureWriteClient();\n    const setStatus = slackClient.assistant?.threads?.setStatus;\n    if (!setStatus) return false;\n\n    signatureByConversation.set(stateKey, signature);\n    const previous =\n      writePromiseByConversation.get(stateKey) ?? Promise.resolve();\n    const operation = previous.then(async () => {\n      try {\n        await setStatus.call(slackClient.assistant?.threads, {\n          channel_id: source.chatId,\n          thread_ts: threadTs,\n          status: footerText,\n          ...(footerText ? { loading_messages: [loadingText] } : {}),\n        });\n        if (footerText) clearedStaleReplyKeys.delete(replyKey);\n        else clearedStaleReplyKeys.add(replyKey);\n        return true;\n      } catch (error) {\n        if (signatureByConversation.get(stateKey) === signature) {\n          signatureByConversation.delete(stateKey);\n        }\n        console.warn(\n          \"[Slack] Failed to update assistant thread status:\",\n          error instanceof Error ? error.message : error,\n        );\n        return false;\n      }\n    });\n    const settled = operation.then(() => undefined);\n    writePromiseByConversation.set(stateKey, settled);\n    void settled.then(() => {\n      if (writePromiseByConversation.get(stateKey) === settled) {\n        writePromiseByConversation.delete(stateKey);\n      }\n    });\n    return operation;\n  }\n\n  function scheduleKeepalive(key: string): void {\n    clearKeepalive(key);\n    const timer = setTimeout(() => {\n      keepaliveByConversation.delete(key);\n      void (async () => {\n        const state = stateByConversation.get(key);\n        const source = sourceByConversation.get(key);\n        if (!state?.isThinkingActive || !source) return;\n        await writeStatus(source, state.typingFooterText, state.thinkingText, {\n          force: true,\n        });\n        if (state.isThinkingActive) scheduleKeepalive(key);\n      })();\n    }, SLACK_ASSISTANT_STATUS_KEEPALIVE_MS);\n    timer.unref?.();\n    keepaliveByConversation.set(key, timer);\n  }\n\n  async function activate(\n    source: ChannelTurnSource,\n    footerText: string,\n    loadingText: string,\n  ): Promise<void> {\n    const key = getConversationKey(source);\n    if (!key || !getLifecycleReplyKey(source)) return;\n    const state = stateByConversation.get(key) ?? {\n      isThinkingActive: false,\n      thinkingText: \"\",\n      typingFooterText: \"\",\n    };\n    if (\n      state.isThinkingActive &&\n      state.thinkingText === loadingText &&\n      state.typingFooterText === footerText\n    ) {\n      sourceByConversation.set(key, source);\n      return;\n    }\n    state.isThinkingActive = true;\n    state.thinkingText = loadingText;\n    state.typingFooterText = footerText;\n    stateByConversation.set(key, state);\n    sourceByConversation.set(key, source);\n    const sent = await writeStatus(source, footerText, loadingText);\n    if (sent && state.isThinkingActive) scheduleKeepalive(key);\n    else if (!sent) state.isThinkingActive = false;\n  }\n\n  function markAutoClearedByKey(key: string): void {\n    clearKeepalive(key);\n    const state = stateByConversation.get(key);\n    if (state) state.isThinkingActive = false;\n    signatureByConversation.delete(key);\n    sourceByConversation.delete(key);\n  }\n\n  async function deactivate(source: ChannelTurnSource): Promise<void> {\n    const key = getConversationKey(source);\n    if (!key) return;\n    clearKeepalive(key);\n    const state = stateByConversation.get(key);\n    if (state) state.isThinkingActive = false;\n    signatureByConversation.delete(key);\n    sourceByConversation.delete(key);\n    await writeStatus(source, \"\", \"\", { force: true });\n    signatureByConversation.delete(key);\n    stateByConversation.delete(key);\n  }\n\n  async function clearStale(source: ChannelTurnSource): Promise<void> {\n    const key = getConversationKey(source);\n    const replyKey = getLifecycleReplyKey(source);\n    if (\n      !key ||\n      !replyKey ||\n      stateByConversation.get(key)?.isThinkingActive ||\n      clearedStaleReplyKeys.has(replyKey)\n    ) {\n      return;\n    }\n    await writeStatus(source, \"\", \"\", { force: true });\n    signatureByConversation.delete(key);\n  }\n\n  return {\n    getUniqueSources,\n    getLifecycleErrorReplyKey,\n    activate,\n    deactivate,\n    clearStale,\n    markAutoCleared(source): void {\n      const key = getConversationKey(source);\n      if (key) markAutoClearedByKey(key);\n    },\n    markAutoClearedForMessage(msg): void {\n      if (\n        isNonEmptyString(msg.agentId) &&\n        isNonEmptyString(msg.conversationId)\n      ) {\n        markAutoClearedByKey(`${msg.agentId}:${msg.conversationId}`);\n        return;\n      }\n      const anchor = firstNonEmptyString(msg.threadId, msg.replyToMessageId);\n      if (!anchor) return;\n      const root = params.resolveKnownThreadRoot(anchor);\n      for (const [key, source] of sourceByConversation) {\n        if (\n          source.chatId === msg.chatId &&\n          resolveSlackProgressThreadTs(source) === root\n        ) {\n          markAutoClearedByKey(key);\n        }\n      }\n    },\n    activeSources: () => Array.from(sourceByConversation.values()),\n    clear(): void {\n      for (const timer of keepaliveByConversation.values()) clearTimeout(timer);\n      stateByConversation.clear();\n      sourceByConversation.clear();\n      signatureByConversation.clear();\n      writePromiseByConversation.clear();\n      keepaliveByConversation.clear();\n      clearedStaleReplyKeys.clear();\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "29806D7E9D547F5664756E2164756E21",
+  "names": []
+}

package/dist/types/agent/model-catalog.d.ts

@@ -272,6 +272,44 @@ export declare const models: ({
     isDefault?: undefined;
     isFeatured?: undefined;
     shortLabel?: undefined;
+} | {
+    id: string;
+    handle: string;
+    label: string;
+    description: string;
+    isFeatured: boolean;
+    updateArgs: {
+        context_window: number;
+        max_output_tokens: number;
+        reasoning_effort: string;
+        parallel_tool_calls: boolean;
+        verbosity?: undefined;
+        enable_reasoner?: undefined;
+        max_reasoning_tokens?: undefined;
+        temperature?: undefined;
+    };
+    isDefault?: undefined;
+    free?: undefined;
+    shortLabel?: undefined;
+} | {
+    id: string;
+    handle: string;
+    label: string;
+    description: string;
+    updateArgs: {
+        context_window: number;
+        max_output_tokens: number;
+        reasoning_effort: string;
+        parallel_tool_calls: boolean;
+        verbosity?: undefined;
+        enable_reasoner?: undefined;
+        max_reasoning_tokens?: undefined;
+        temperature?: undefined;
+    };
+    isDefault?: undefined;
+    free?: undefined;
+    isFeatured?: undefined;
+    shortLabel?: undefined;
 } | {
     id: string;
     handle: string;

package/dist/types/agent/model-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../src/agent/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAoB,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAAW,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAaxC"}
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../src/agent/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAoB,CAAC;AAExC;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAAW,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAaxC"}

package/dist/types/channels/core-stream.d.ts

@@ -0,0 +1,35 @@
+import type { ChannelTurnProgressUpdate } from "./types";
+export interface LettaStreamErrorParams {
+    errorType?: string;
+    message: string;
+    detail?: string;
+    runId?: string;
+}
+export interface CollectLettaSseAssistantTextResult {
+    text: string;
+    chunkCount: number;
+    stopReason?: string;
+}
+export interface CollectLettaSseAssistantTextOptions {
+    onDelta?: (delta: unknown) => void | Promise<void>;
+    onProgressUpdate?: (update: ChannelTurnProgressUpdate) => void | Promise<void>;
+    progressBuilder?: {
+        buildUpdates(delta: unknown): ChannelTurnProgressUpdate[];
+    };
+}
+export interface FormatLettaStreamCoreErrorOptions {
+    includeDetail?: boolean;
+}
+export declare const LETTA_STREAM_NO_ASSISTANT_MESSAGE_ERROR = "No assistant message received in stream";
+export declare class LettaStreamCoreError extends Error {
+    readonly errorType?: string;
+    readonly detail?: string;
+    readonly runId?: string;
+    constructor(params: LettaStreamErrorParams);
+}
+export declare class LettaStreamNoAssistantMessageError extends Error {
+    constructor();
+}
+export declare function formatLettaStreamCoreErrorForChannel(error: LettaStreamCoreError, options?: FormatLettaStreamCoreErrorOptions): string;
+export declare function collectLettaSseAssistantText(body: ReadableStream<Uint8Array>, options?: CollectLettaSseAssistantTextOptions): Promise<CollectLettaSseAssistantTextResult>;
+//# sourceMappingURL=core-stream.d.ts.map

package/dist/types/channels/core-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-stream.d.ts","sourceRoot":"","sources":["../../../src/channels/core-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,yBAAyB,KAC9B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,eAAe,CAAC,EAAE;QAChB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,EAAE,CAAC;KAC3D,CAAC;CACH;AAED,MAAM,WAAW,iCAAiC;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA0BD,eAAO,MAAM,uCAAuC,4CACT,CAAC;AAE5C,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,sBAAsB;CAO3C;AAED,qBAAa,kCAAmC,SAAQ,KAAK;;CAK5D;AAOD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,iCAAsC,GAC9C,MAAM,CAUR;AA+ED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,kCAAkC,CAAC,CA4E7C"}

package/dist/types/channels/plugin-types.d.ts

@@ -0,0 +1,226 @@
+import type { ChannelAccount, ChannelAdapter, ChannelChatType, ChannelDefaultPermissionMode, ChannelRoute, DiscordChannelMode, DmPolicy, OutboundChannelMessage, SignalGroupMode, SlackAllowBotsMode, SlackChannelMode, TelegramGroupMode, WhatsAppGroupMode } from "./types";
+export interface ChannelPluginMetadata {
+    id: string;
+    displayName: string;
+    runtimePackages: string[];
+    runtimeModules: string[];
+    source?: "first-party" | "user";
+    firstParty?: boolean;
+    /**
+     * Optional declarative description of the plugin's account-config fields.
+     * When present, clients can render a dynamic settings form instead of
+     * relying on free-form JSON textareas. Surfaced to clients via
+     * `channels_list_response.channels[*].config_schema`.
+     */
+    configSchema?: ChannelConfigSchema;
+}
+export type ChannelConfigFieldType = "text" | "secret" | "select" | "boolean" | "number" | "string-array" | "key-value-map";
+export interface ChannelConfigFieldBase {
+    /** Snake-case key used in the plugin's stored config payload. */
+    key: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    /**
+     * Advisory UI hint: when true the dialog renders a "restart required"
+     * chip near the field. Does not yet enforce restart semantics — that's
+     * future work. Plugins should still document which fields they hot-read
+     * vs. read once at startup.
+     */
+    restartRequired?: boolean;
+    /**
+     * Where this field lives in the storage model:
+     *   - 'app' (default): stored on the app's plugin config, shared across
+     *     all accounts. Rendered in the App settings tab.
+     *   - 'account': stored on each individual account (e.g. credentials,
+     *     per-handle identifiers). Rendered in the Accounts tab. The App
+     *     settings form omits these fields entirely.
+     * If unspecified, treat as 'app' to preserve backwards compatibility.
+     */
+    scope?: "app" | "account";
+}
+export interface ChannelConfigTextField extends ChannelConfigFieldBase {
+    type: "text";
+    default?: string;
+    placeholder?: string;
+}
+export interface ChannelConfigSecretField extends ChannelConfigFieldBase {
+    type: "secret";
+    placeholder?: string;
+}
+export interface ChannelConfigSelectOption {
+    value: string;
+    label: string;
+}
+export interface ChannelConfigSelectField extends ChannelConfigFieldBase {
+    type: "select";
+    options: ChannelConfigSelectOption[];
+    default?: string;
+}
+export interface ChannelConfigBooleanField extends ChannelConfigFieldBase {
+    type: "boolean";
+    default?: boolean;
+}
+export interface ChannelConfigNumberField extends ChannelConfigFieldBase {
+    type: "number";
+    default?: number;
+    /** Inclusive lower bound (validated server-side + UI-rendered). */
+    min?: number;
+    /** Inclusive upper bound. */
+    max?: number;
+    /** Step granularity for the UI input (e.g. 0.05). */
+    step?: number;
+    /** Trailing adornment text rendered after the input (e.g. "ms", "%"). */
+    suffix?: string;
+    placeholder?: string;
+}
+export interface ChannelConfigStringArrayField extends ChannelConfigFieldBase {
+    type: "string-array";
+    default?: string[];
+    /** Placeholder shown inside each row's input. */
+    placeholder?: string;
+}
+export interface ChannelConfigKeyValueMapField extends ChannelConfigFieldBase {
+    type: "key-value-map";
+    /** Whether row values are typed strings or numbers. */
+    valueType: "string" | "number";
+    default?: Record<string, string | number>;
+    /** Column-header labels for the key/value columns. */
+    keyLabel?: string;
+    valueLabel?: string;
+    keyPlaceholder?: string;
+    valuePlaceholder?: string;
+}
+export type ChannelConfigField = ChannelConfigTextField | ChannelConfigSecretField | ChannelConfigSelectField | ChannelConfigBooleanField | ChannelConfigNumberField | ChannelConfigStringArrayField | ChannelConfigKeyValueMapField;
+export interface ChannelConfigSchema {
+    version: 1;
+    fields: ChannelConfigField[];
+}
+export type ChannelProtocolConfig = Record<string, unknown>;
+export interface ChannelCommonAccountPatch {
+    displayName?: string;
+    enabled?: boolean;
+    dmPolicy?: DmPolicy;
+    allowedUsers?: string[];
+}
+export interface ChannelPluginAccountPatch {
+    token?: string;
+    botToken?: string;
+    appToken?: string;
+    mode?: SlackChannelMode;
+    groupMode?: TelegramGroupMode | WhatsAppGroupMode | SignalGroupMode;
+    agentId?: string | null;
+    baseUrl?: string;
+    account?: string;
+    accountUuid?: string;
+    defaultPermissionMode?: ChannelDefaultPermissionMode;
+    allowedChannels?: string[] | Record<string, DiscordChannelMode>;
+    autoThreadOnMention?: boolean;
+    threadPolicyByChannel?: Record<string, boolean>;
+    acknowledgeMessageReaction?: boolean;
+    listenMode?: boolean;
+    allowBots?: SlackAllowBotsMode;
+    removeStaleRoutes?: boolean;
+    inboundDebounceMs?: number;
+    selfChatMode?: boolean;
+    allowedGroups?: string[];
+    mentionPatterns?: string[];
+    /** Signal UUID/identity -> replyable recipient aliases, e.g. UUID to E.164 phone. */
+    recipientAliases?: Record<string, string>;
+    transcribeVoice?: boolean;
+    richPrivateChatDefault?: boolean;
+    richDraftStreaming?: boolean;
+    downloadMedia?: boolean;
+    mediaMaxBytes?: number;
+}
+export type ChannelAccountPatch = ChannelCommonAccountPatch & ChannelPluginAccountPatch & {
+    /** Plugin-owned snake_case config accepted from the websocket protocol. */
+    config?: ChannelProtocolConfig;
+};
+export type ChannelConfigPatch = Pick<ChannelCommonAccountPatch, "dmPolicy" | "allowedUsers"> & ChannelPluginAccountPatch & {
+    /** Plugin-owned snake_case config accepted from the websocket protocol. */
+    config?: ChannelProtocolConfig;
+};
+export interface ChannelAccountConfigAdapter<TAccount extends ChannelAccount> {
+    /** Validate plugin-owned config payloads. */
+    isValidConfig(config: ChannelProtocolConfig): boolean;
+    /** Convert protocol snake_case config into the internal account patch shape. */
+    toAccountPatch(config: ChannelProtocolConfig): ChannelPluginAccountPatch;
+    /** Redacted/safe plugin config included in account list/get responses. */
+    toAccountConfig(account: TAccount): ChannelProtocolConfig;
+    /** Redacted/safe plugin config included in channel_get_config responses. */
+    toConfigSnapshotConfig(account: TAccount): ChannelProtocolConfig;
+    /** Whether this plugin config patch changes credentials/display identity. */
+    shouldRefreshDisplayName(patch: ChannelPluginAccountPatch): boolean;
+}
+export type ChannelMessageActionName = string;
+export interface ChannelMessageToolSchemaContribution {
+    properties: Record<string, unknown>;
+    visibility?: "all-configured";
+}
+/**
+ * Plugin-owned discovery for the shared MessageChannel tool.
+ * Channel plugins advertise their supported actions and any extra schema
+ * fragments here so the public tool surface stays singular while the
+ * capabilities remain channel-specific.
+ */
+export interface ChannelMessageToolDiscovery {
+    actions?: readonly ChannelMessageActionName[] | null;
+    schema?: ChannelMessageToolSchemaContribution | ChannelMessageToolSchemaContribution[] | null;
+}
+export interface ChannelMessageActionRequest {
+    action: ChannelMessageActionName;
+    channel: string;
+    chatId: string;
+    message?: string;
+    replyToMessageId?: string;
+    threadId?: string | null;
+    messageId?: string;
+    attachmentId?: string;
+    emoji?: string;
+    remove?: boolean;
+    mediaPath?: string;
+    filename?: string;
+    title?: string;
+}
+export interface ChannelResolvedMessageTarget {
+    chatId: string;
+    chatType?: ChannelChatType;
+    threadId?: string | null;
+    label?: string;
+}
+export interface ChannelMessageActionContext {
+    request: ChannelMessageActionRequest;
+    route: ChannelRoute;
+    adapter: ChannelAdapter;
+    /**
+     * Format user-authored markdown/plain text for the target channel before the
+     * plugin sends it. The shared MessageChannel tool owns cross-channel text
+     * normalization, while action adapters decide how to pass the result to their
+     * concrete ChannelAdapter (e.g. Telegram HTML, Slack mrkdwn, Signal styles).
+     */
+    formatText: (text: string) => Pick<OutboundChannelMessage, "text" | "parseMode" | "textStyle">;
+}
+/**
+ * Channel-owned action surface for the shared MessageChannel tool.
+ * This mirrors the OpenClaw pattern: one top-level tool, with each channel
+ * plugin owning action discovery and execution underneath it.
+ */
+export interface ChannelMessageActionAdapter {
+    describeMessageTool(params: {
+        accountId?: string | null;
+    }): ChannelMessageToolDiscovery;
+    resolveMessageTarget?(params: {
+        account: ChannelAccount;
+        target: string;
+    }): Promise<ChannelResolvedMessageTarget>;
+    handleAction(ctx: ChannelMessageActionContext): Promise<string>;
+}
+export interface ChannelPlugin {
+    metadata: ChannelPluginMetadata;
+    createAdapter(account: ChannelAccount): Promise<ChannelAdapter> | ChannelAdapter;
+    runSetup?(): Promise<boolean>;
+    resolveAccountDisplayName?(account: ChannelAccount): Promise<string | undefined> | string | undefined;
+    messageActions?: ChannelMessageActionAdapter;
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/types/channels/plugin-types.d.ts.map

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

package/dist/types/channels/processor.d.ts

@@ -0,0 +1,27 @@
+import type { ChannelRoute, ChannelTurnSource, InboundChannelMessage, OutboundChannelMessage } from "./types";
+export interface BuildChannelTurnSourceParams {
+    message: InboundChannelMessage;
+    route: ChannelRoute;
+}
+export interface FormatInboundChannelMessageParams {
+    message: InboundChannelMessage;
+}
+export interface ChannelBatchMessage {
+    text: string;
+    senderId?: string;
+    senderName?: string;
+    timestamp?: string | number;
+    channelTurnSource?: ChannelTurnSource;
+}
+export interface FormatBatchedChannelMessagesParams {
+    messages: ChannelBatchMessage[];
+}
+export interface BuildOutboundChannelMessageFromTurnSourceParams {
+    turnSource: ChannelTurnSource;
+    text: string;
+}
+export declare function buildChannelTurnSource(params: BuildChannelTurnSourceParams): ChannelTurnSource;
+export declare function formatInboundChannelMessageForAgent(params: FormatInboundChannelMessageParams): string;
+export declare function formatBatchedChannelMessagesForAgent(params: FormatBatchedChannelMessagesParams): string;
+export declare function buildOutboundChannelMessageFromTurnSource(params: BuildOutboundChannelMessageFromTurnSourceParams): OutboundChannelMessage;
+//# sourceMappingURL=processor.d.ts.map

package/dist/types/channels/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../../src/channels/processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGZ,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,+CAA+C;IAC9D,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AA4CD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,4BAA4B,GACnC,iBAAiB,CAcnB;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,iCAAiC,GACxC,MAAM,CAWR;AAWD,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,kCAAkC,GACzC,MAAM,CAuBR;AAED,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,+CAA+C,GACtD,sBAAsB,CAWxB"}

package/dist/types/channels/progress-builder.d.ts

@@ -0,0 +1,13 @@
+import { type ChannelTurnProgressBuilderOptions } from "./progress-formatting";
+import type { ChannelTurnProgressUpdate } from "./types";
+/**
+ * Builds sanitized channel progress updates from stream deltas for a single
+ * turn. Instances accumulate fragmented tool-call arguments across deltas,
+ * so they must be scoped to one conversation turn (create one per turn and
+ * drop it when the turn finishes) rather than shared across conversations.
+ */
+export type ChannelTurnProgressBuilder = {
+    buildUpdates(delta: unknown): ChannelTurnProgressUpdate[];
+};
+export declare function createChannelTurnProgressBuilder(options?: ChannelTurnProgressBuilderOptions): ChannelTurnProgressBuilder;
+//# sourceMappingURL=progress-builder.d.ts.map

package/dist/types/channels/progress-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-builder.d.ts","sourceRoot":"","sources":["../../../src/channels/progress-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iCAAiC,EAUvC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AA4EzD;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,EAAE,CAAC;CAC3D,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,0BAA0B,CAge5B"}

package/dist/types/channels/progress-formatting.d.ts

@@ -0,0 +1,34 @@
+export declare const MAX_PROGRESS_DETAILS_LENGTH = 180;
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+export declare function firstNonEmptyString(...values: unknown[]): string | undefined;
+export declare function truncateChannelProgressText(value: string, maxLength: number, marker?: string): string;
+/**
+ * Shared sanitization core for channel-facing progress text: strips ANSI
+ * escapes and control characters, redacts secret-looking assignments, and
+ * neutralizes platform mentions. Platform adapters layer their own escaping
+ * (and truncation marker) on top of this instead of maintaining parallel
+ * redaction rules.
+ */
+export declare function sanitizeChannelProgressCore(value: unknown): string;
+export declare function sanitizeChannelProgressText(value: unknown, maxLength?: number): string;
+export declare function sanitizeChannelProgressIdentifier(value: unknown, fallback: string): string;
+type SkillDescriptionLookup = ReadonlyMap<string, string> | Readonly<Record<string, string | undefined>>;
+export type ChannelTurnProgressBuilderOptions = {
+    skillDescriptionsByName?: SkillDescriptionLookup;
+};
+export type ToolCallSummary = {
+    id?: string;
+    name?: string;
+    argumentsText?: string;
+};
+export type ToolReturnSummary = {
+    summary: ToolCallSummary;
+    status: "completed" | "error";
+    errorDetails?: string;
+};
+export declare function parseToolArguments(value: string | undefined): Record<string, unknown> | null;
+export declare function isSkillToolName(name: string | undefined): boolean;
+export declare function formatToolProgressTitle(summary: ToolCallSummary, status: "started" | "completed" | "error"): string | undefined;
+export declare function formatToolProgressDetails(summary: ToolCallSummary, options?: ChannelTurnProgressBuilderOptions): string | undefined;
+export {};
+//# sourceMappingURL=progress-formatting.d.ts.map

package/dist/types/channels/progress-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-formatting.d.ts","sourceRoot":"","sources":["../../../src/channels/progress-formatting.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAsF/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIvE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAO5E;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,SAAQ,GACb,MAAM,CAQR;AAmBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWlE;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,SAAS,GAAE,MAAiC,GAC3C,MAAM,CAKR;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AA2BD,KAAK,sBAAsB,GACvB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAEjD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,uBAAuB,CAAC,EAAE,sBAAsB,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAgHF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAShC;AAUD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQjE;AA+MD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GACxC,MAAM,GAAG,SAAS,CAyBpB;AA4BD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,iCAAiC,GAC1C,MAAM,GAAG,SAAS,CA0FpB"}