DevFlow/src/composables/ai/useToolCardHeader.ts

/**
 * ToolCard 头部显示逻辑(从 ToolCard.vue 抽离)。
 *
 * 职责:工具显示名 + 审批参数值的「语义化回显」(裸 id → 项目名/任务标题),
 * 以及 http url → host 精简。这些依赖 project store(响应式),故以 composable 形式封装,
 * 传入 tc 即得 { toolDisplayName, displayArgValue }。
 *
 * 不含响应式状态(纯函数 + store 读),逻辑与原 ToolCard.vue 内联实现一字等价。
 */
import { useProjectStore } from '@/stores/project'
import { useI18n } from 'vue-i18n'
import {
  formatToolName,
  shortCmd,
  toolArgsEntries,
  formatArgValue,
  shortPath,
  argString,
} from '@/composables/ai/useToolCard'
import type { AiToolCallInfo } from '@/api/types'

/** 工具名 → 该工具中代表项目 id 的参数 key(仅项目类工具特化;delete_task 的 id 是任务 id,不在此列) */
const PROJECT_ID_TOOL_ARG: Record<string, 'id' | 'project_id'> = {
  delete_project: 'id',
  restore_project: 'id',
  purge_project: 'id',
  update_project: 'id',
  bind_directory: 'id',
  create_task: 'project_id',
}

/**
 * 工具名 → 该工具中代表任务 id 的参数 key(任务类工具特化)。
 * advance_task 的任务 id 在 "id" key,run_workflow 在 "task_id" key。
 */
const TASK_ID_TOOL_ARG: Record<string, 'id' | 'task_id'> = {
  advance_task: 'id',
  run_workflow: 'task_id',
}

/**
 * ToolCard 头部/审批参数显示辅助。
 * @param getTc 取当前 tc 的函数(避免 props.tc 在 composable 调用时机脱节,由调用方透传)
 */
export function useToolCardHeader(getTc: () => AiToolCallInfo) {
  const t = useI18n().t
  const projectStore = useProjectStore()

  /**
   * 按 id 查项目名(覆盖活跃 + 回收站):审批 delete/restore/purge 各阶段都可能引用项目,
   * 故先查 projects 再查 deletedProjects,找到即返回(提前退出),无则返回 undefined(调用方走 fallback)。
   * 复用 project store 已加载列表,不新增网络请求;响应式由 store 数组保证。
   */
  function projectNameById(id: string): string | undefined {
    return projectStore.projects.find(p => p.id === id)?.name
      ?? projectStore.deletedProjects.find(p => p.id === id)?.name
  }

  /**
   * 按 id 查任务标题:审批 advance_task/run_workflow 的 task_id 时,把裸 UUID 转标题。
   * 复用 project store 已加载的 state.tasks(仅当前项目范围),不新增网络请求。
   */
  function taskNameById(id: string): string | undefined {
    return projectStore.tasks.find(tk => tk.id === id)?.title
  }

  /**
   * 审批参数值展示(AR-3):对项目类工具的 id/project_id 特化——优先回显项目名,查不到则显示
   * 「项目已不存在」提示 + 原 id。非项目工具或其他 key 走通用 formatArgValue。
   */
  function displayArgValue(arg: { key: string; val: unknown }): string {
    const tc = getTc()
    const projectArgKey = PROJECT_ID_TOOL_ARG[tc.name]
    if (projectArgKey && arg.key === projectArgKey) {
      const id = typeof arg.val === 'string' ? arg.val : ''
      if (id) {
        const name = projectNameById(id)
        if (name) return t('aiTool.projectLabel', { name })
        return t('aiTool.projectIdNotFound', { id })
      }
    }
    // UX-260618-14:advance_task/run_workflow 的 task_id → 任务标题
    const taskArgKey = TASK_ID_TOOL_ARG[tc.name]
    if (taskArgKey && arg.key === taskArgKey) {
      const id = typeof arg.val === 'string' ? arg.val : ''
      if (id) {
        const name = taskNameById(id)
        if (name) return t('aiTool.taskLabel', { name })
        return t('aiTool.taskIdNotFound', { id })
      }
    }
    return formatArgValue(arg.val)
  }

  /**
   * 工具显示名称(含目标摘要);文件类按 path,项目类按 id 解析项目名,create_* 用固定文案。
   */
  function toolDisplayName(tc: AiToolCallInfo): string {
    const p = argString(tc.args, 'path')
    switch (tc.name) {
      case 'read_file': return p ? `${t('aiTool.readPrefix')} ${shortPath(p)}` : t('aiTool.readFallback')
      case 'list_directory': return p ? `${t('aiTool.dirPrefix')} ${shortPath(p)}` : t('aiTool.dirFallback')
      case 'write_file': return p ? `${t('aiTool.writePrefix')} ${shortPath(p)}` : t('aiTool.writeFallback')
      case 'grep': {
        // grep 头部:搜索根 + pattern(折叠态可见搜索什么)
        const pat = argString(tc.args, 'pattern')
        const head = p ? `${t('aiTool.grepPrefix')} ${shortPath(p)}` : t('aiTool.grepFallback')
        return pat ? `${head} 「${pat}」` : head
      }
      case 'delete_project':
      case 'restore_project':
      case 'purge_project':
      case 'update_project': {
        const idKey = PROJECT_ID_TOOL_ARG[tc.name]
        const id = idKey ? argString(tc.args, idKey) : ''
        const name = id ? projectNameById(id) : ''
        const prefixKey = `${tc.name.replace('_project', '')}Prefix` as 'deletePrefix' | 'restorePrefix' | 'purgePrefix' | 'updatePrefix'
        const fallbackKey = `${tc.name.replace('_project', '')}Fallback` as 'deleteFallback' | 'restoreFallback' | 'purgeFallback' | 'updateFallback'
        return name ? `${t('aiTool.' + prefixKey)}「${name}」` : t('aiTool.' + fallbackKey)
      }
      case 'create_task': return t('aiTool.createTask')
      case 'create_project': return t('aiTool.createProject')
      case 'run_command': {
        const cmd = argString(tc.args, 'command')
        return cmd ? `$ ${shortCmd(cmd)}` : formatToolName(tc.name)
      }
      case 'http_request': {
        const method = argString(tc.args, 'method') || 'GET'
        const url = argString(tc.args, 'url')
        const host = httpHost(url)
        return host ? `${method} ${host}` : t('aiTool.httpRequestFallback')
      }
      default: return formatToolName(tc.name)
    }
  }

  /** 审批参数键值对(头部 toolArgsEntries 透传,本 composable 仅暴露便于复用) */
  function argsEntries() {
    return toolArgsEntries(getTc().args)
  }

  return { toolDisplayName, displayArgValue, argsEntries }
}

/**
 * http_request url → host 显示用(折叠态头部精简,不全显 url)。
 * 取 scheme://host[:port],剥 path/query;非 http(s) url 返回空串回退通用名。
 * 注:用 URL 构造器容错,非法 url 抛错时回退原 url 截断。
 */
export function httpHost(raw: string): string {
  if (!raw) return ''
  try {
    const u = new URL(raw)
    if (u.protocol !== 'http:' && u.protocol !== 'https:') return ''
    const portPart = u.port ? `:${u.port}` : ''
    return `${u.hostname}${portPart}`
  } catch {
    return raw.length > 40 ? raw.slice(0, 40) + '…' : raw
  }
}