# ============================================================
# AgentDock 适配器 · Warp Agent CLI（Wave 3）
# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3
# 注意：只管 Agent CLI（命令 warp），不管 Warp 终端本体；设备码+浏览器+API Key 三授权。
# ============================================================
id: warp
name: Warp Agent CLI
name_zh: Warp Agent CLI
vendor: Warp
status: available
adapter_version: 1.1.0
license: 专有（仅官方渠道安装、不重打包）

platforms:
  windows:
    architectures: [x64]
    notes: 官方 agent-cli.ps1 脚本渠道
  linux:
    distributions: [ubuntu]
    architectures: [x64]

official:
  homepage: https://www.warp.dev
  docs: https://docs.warp.dev/agent-mode
  allowed_hosts: [warp.dev, app.warp.dev, www.warp.dev]

runtime_deps: []

install:
  preferred: official_script
  channels:
    - id: official_script
      platforms: [windows]
      script:
        url: https://app.warp.dev/download/agent-cli.ps1
        kind: powershell_irm
      elevate: never
      post_checks: [detect]
    - id: official_script
      platforms: [linux]
      script:
        url: https://app.warp.dev/download/agent-cli
        kind: bash_pipe
      elevate: never
      post_checks: [detect]

detect:
  executable: warp
  version_args: ["--version"]

update:
  method: self_update_cmd
  command: [warp, update]

uninstall:
  method: manual_delete
  command: []
  keep_config_default: true

authorization:
  modes:
    - mode: browser_oauth
      command: [warp, login]
      notes_zh: 浏览器登录 Warp 账号
    - mode: device_code
      command: [warp, login]
      notes_zh: 设备码登录（不弹浏览器）
    - mode: api_key
      env_keys: [WARP_API_KEY]
      notes_zh: WARP_API_KEY 环境变量（API Key 授权）

# 配置机制（调研底稿 Warp 章节）：Warp 账户体系为主，API Key 经 WARP_API_KEY 环境变量。
configuration:
  files: []
  environment:
    - key: WARP_API_KEY
      sensitive: true
      maps_to_field: api_key
  fields:
    - id: api_key
      label_zh: API Key
      group: auth
      help_zh: 存入系统密钥库（对应 WARP_API_KEY 环境变量）；一般用账号登录即可
      required: false
      sensitive: true
      type: string
      storage: keyring
      docs_url: https://docs.warp.dev/agent-mode

diagnostics:
  - rule_id: path.not_installed
  - rule_id: path.not_in_path
  - rule_id: version_conflict.multiple_copies

documentation:
  quickstart_zh: 安装后运行 `warp login` 登录 Warp 账号，或用 `warp -p "提示词"` 无头执行。
  install_zh: 仅官方脚本渠道：Windows agent-cli.ps1 / Linux curl 脚本。只管 Agent CLI，不管 Warp 终端本体。
  auth_zh: 三授权：① 浏览器登录（`warp login`）；② 设备码（`warp login`，不弹浏览器）；③ API Key（WARP_API_KEY 环境变量）。
  commands:
    - cmd: warp
      desc_zh: 启动交互式会话
    - cmd: warp -p "提示词"
      desc_zh: 无头单次执行
    - cmd: warp login
      desc_zh: 登录 Warp 账号
    - cmd: warp logout
      desc_zh: 退出登录
    - cmd: warp --version
      desc_zh: 显示版本号
  params:
    - param: -p / --print
      desc_zh: 无头模式执行后退出
    - param: --model
      desc_zh: 指定模型
    - param: --output-format
      desc_zh: 输出格式
    - param: --version
      desc_zh: 显示版本号
  updated_at: "2026-08-25"
  risks_zh:
    - 只管 Agent CLI（命令 warp），不管 Warp 终端本体
    - 官方脚本 URL 以 docs.warp.dev/agent-mode 为准，安装前请核对