Function handler

packages/tools/src/definitions/chat-overview.ts:15–50

(params: Record<string, unknown>, context: ToolExecutionContext)

}

async function handler(params: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult> {
  const { locale } = context
  const topN = (params.top_n as number) || 10

  const result = await context.dataProvider!.getChatOverview(topN)
  if (!result) {
    const msg = isChineseLocale(locale) ? '无法获取聊天概览' : 'Unable to get chat overview'
    return { content: msg, data: { error: msg } }
  }

  const msgSuffix = isChineseLocale(locale) ? '条' : ''
  const lines: string[] = [
    `name: ${result.name}`,
    `platform: ${result.platform}`,
    `type: ${result.type}`,
    `totalMessages: ${result.totalMessages}`,
    `totalMembers: ${result.totalMembers}`,
  ]

  if (result.firstMessageTs != null && result.lastMessageTs != null) {
    const start = new Date(result.firstMessageTs * 1000).toLocaleDateString()
    const end = new Date(result.lastMessageTs * 1000).toLocaleDateString()
    lines.push(`timeRange: ${start} ~ ${end}`)
  }

  if (result.topMembers.length > 0) {
    lines.push(`topMembers:`)
    for (let i = 0; i < result.topMembers.length; i++) {
      const m = result.topMembers[i]
      const pct = result.totalMessages > 0 ? ((m.count / result.totalMessages) * 100).toFixed(1) : '0'
      lines.push(`${i + 1}. ${m.name} ${m.count}${msgSuffix}(${pct}%)`)
    }
  }

  return { content: lines.join('\n'), data: result }
}

export const chatOverviewTool: ToolDefinition = {
  name: 'get_chat_overview',