@ia-ccun/code-agent-cli 0.0.52 → 0.0.53-beta.1

package/scripts/regression/cases/01-version-and-deps.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+# 01-version-and-deps.sh
+# 验证：aicode 二进制版本 + 内嵌 pi 包版本
+# 这是回归测试的入口，确认我们用的版本符合预期
+
+set -uo pipefail
+CURRENT_CASE="01-version-and-deps"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/common.sh"
+
+header "$CURRENT_CASE" "version & pi dependencies"
+
+# ----- Test 1: aicode -v 输出 -----
+header "$CURRENT_CASE" "aicode binary"
+if ! command -v "$AICODE_BIN" >/dev/null 2>&1; then
+    fail "aicode 二进制存在" "未找到 $AICODE_BIN，设 AICODE_BIN 环境变量"
+    summary
+    exit 1
+fi
+pass "aicode 二进制存在 ($AICODE_BIN)"
+
+VERSION=$("$AICODE_BIN" -v 2>&1 | head -1)
+echo "    version: $VERSION"
+
+if [[ "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-z0-9.]+)?$ ]]; then
+    pass "版本号格式合规 ($VERSION)"
+else
+    fail "版本号格式合规" "got: $VERSION"
+fi
+
+# ----- Test 2: 内嵌 pi 包版本 -----
+header "$CURRENT_CASE" "pi package dependencies"
+
+# 找到 aicode 安装路径里的 package.json
+AICODE_PATH=$(command -v "$AICODE_BIN")
+# 解析 symlink
+if [[ -L "$AICODE_PATH" ]]; then
+    AICODE_PATH=$(readlink "$AICODE_PATH")
+fi
+
+# 找 package.json
+RESOLVED_PATH=$(node -e "
+const path = require('path');
+const fs = require('fs');
+let p = '$AICODE_PATH';
+// aicode -> ../lib/node_modules/@ia-ccun/code-agent-cli/bin/cli.js
+if (p.includes('/lib/node_modules/')) {
+    p = p.split('/lib/node_modules/')[0] + '/lib/node_modules/@ia-ccun/code-agent-cli';
+} else if (p.includes('/.bin/')) {
+    p = path.join(path.dirname(p), '..', 'lib', 'node_modules', '@ia-ccun', 'code-agent-cli');
+}
+try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(p, 'package.json'), 'utf8'));
+    console.log(p);
+    console.log(JSON.stringify(pkg.dependencies || {}));
+} catch (e) { console.error(e.message); process.exit(1); }
+" 2>&1) || {
+    fail "解析 aicode 安装路径" "node 解析失败"
+    summary
+    exit 1
+}
+
+AICODE_ROOT=$(echo "$RESOLVED_PATH" | head -1)
+DEPS_JSON=$(echo "$RESOLVED_PATH" | tail -1)
+echo "    install path: $AICODE_ROOT"
+echo "    declared deps: $DEPS_JSON"
+
+# 检查 4 个核心 pi 包
+for pkg in @earendil-works/pi-agent-core @earendil-works/pi-ai @earendil-works/pi-coding-agent @earendil-works/pi-tui; do
+    declared=$(echo "$DEPS_JSON" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('$pkg','MISSING'))" 2>/dev/null)
+    if [[ "$declared" == "MISSING" || -z "$declared" ]]; then
+        fail "$pkg 已在 dependencies 声明" "declared: $declared"
+        continue
+    fi
+    pass "$pkg declared as $declared"
+
+    # 检查实际安装版本
+    actual=$("$AICODE_ROOT/node_modules/$pkg/package.json" -e "console.log(require('$AICODE_ROOT/node_modules/$pkg/package.json').version)" 2>/dev/null)
+    if [[ -n "$actual" ]]; then
+        # 解析 semver 主要版本
+        declared_major=$(echo "$declared" | sed -E 's/^[^0-9]*([0-9]+).*/\1/')
+        actual_major=$(echo "$actual" | sed -E 's/^[^0-9]*([0-9]+).*/\1/')
+        if [[ "$declared_major" == "$actual_major" ]]; then
+            pass "$pkg 安装版本 $actual 满足 ^$declared_major"
+        else
+            fail "$pkg 主版本一致" "declared major=$declared_major | actual=$actual"
+        fi
+    else
+        fail "$pkg 实际安装版本" "无法读取 $AICODE_ROOT/node_modules/$pkg/package.json"
+    fi
+done
+
+summary
+exit $?

package/scripts/regression/cases/02-extension-loading.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# 02-extension-loading.sh
+# 验证：aicode-cli 自带的 20 个 TypeScript 扩展在 RPC 启动时全部成功加载
+#
+# 这是 aicode-cli 的核心差异化能力：
+#   - aicode-btw / aicode-plan / aicode-advisor / aicode-cd / aicode-grillMe
+#   - aicode-safety-guard / aicode-todo-progress / aicode-tips / aicode-pets
+#   - context-monitor / context / error-monitor / working-msg / tps
+#   - goal / review / ponytail / custom / custom-footer / msg-debug
+#
+# 升级 pi 后扩展 API 可能微调，必须验证：
+#   1. 启动时没有任何 "Failed to load extension" 错误
+#   2. 没有任何工具名冲突（conflict error）
+#   3. 至少 N 个 aicode-* 扩展在 .agents.md 或 get_commands 中可见
+
+set -uo pipefail
+CURRENT_CASE="02-extension-loading"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/common.sh"
+
+header "$CURRENT_CASE" "aicode custom extensions"
+
+if ! spawn_rpc; then
+    fail "spawn aicode RPC（带扩展）" "进程启动失败"
+    summary
+    exit 1
+fi
+pass "spawn aicode RPC (pid=$REGRESSION_PID)"
+
+# ----- Test 1: 启动日志中无扩展加载失败 -----
+header "$CURRENT_CASE" "extension load errors"
+
+# 把 stderr/stdout 全捕获到 log（-ne 关闭扩展 → 我们用普通模式）
+cleanup_rpc
+
+# 重启：不用 -ne，让所有扩展都加载
+WORKDIR=$(mktemp -d -t aicode-ext.XXXXXX)
+cat >"$WORKDIR/config.json" <<EOF
+{"name":"aicode-test","banner":"","themeColor":"#49bccf","configDir":"$(basename "$WORKDIR")"}
+EOF
+
+LOG="$RESULTS_DIR/${CURRENT_CASE}.log"
+: >"$LOG"
+
+"$AICODE_BIN" --config "$WORKDIR" --mode rpc --no-session \
+    < /dev/null >"$LOG" 2>&1 &
+EXT_PID=$!
+
+# 等启动完成（5s 应该够）
+sleep 5
+kill "$EXT_PID" 2>/dev/null
+wait "$EXT_PID" 2>/dev/null
+
+# 错误关键字扫描
+echo "    scanning log for extension errors..."
+
+fail_count=0
+for pattern in "Failed to load extension" "Tool.*conflicts with" "Cannot find module" "SyntaxError" "TypeError.*Extension"; do
+    matches=$(grep -cE "$pattern" "$LOG" 2>/dev/null || echo 0)
+    if [[ "$matches" -gt 0 ]]; then
+        fail "无 $pattern 错误" "found $matches matches"
+        grep -E "$pattern" "$LOG" | head -3 | sed 's/^/      /'
+        fail_count=$((fail_count + matches))
+    else
+        pass "无 '$pattern' 错误"
+    fi
+done
+
+# ----- Test 2: get_commands 包含 aicode- 自定义命令 -----
+# 不带 -ne 启动，确认扩展注册的 slash commands 也可见
+header "$CURRENT_CASE" "aicode custom slash commands"
+
+spawn_rpc 2>/dev/null || {
+    fail "second spawn" "进程启动失败"
+    summary; exit 1
+}
+
+send '{"type":"get_commands","id":"e1"}'
+sleep 1
+
+cmds_json=$(jq -c 'select(.id=="e1" and .type=="response") | .data.commands' "$REGRESSION_LOG" 2>/dev/null | head -1)
+cmd_count=$(echo "$cmds_json" | jq -c 'length' 2>/dev/null)
+echo "    registered commands: $cmd_count"
+
+if [[ -z "$cmd_count" || "$cmd_count" == "null" || "$cmd_count" -lt 5 ]]; then
+    fail "至少注册 5 个命令" "got: $cmd_count"
+else
+    pass "注册 $cmd_count 个 slash commands"
+fi
+
+# 关键 aicode 自定义命令（在 /llama /model /settings 等内置之外的 aicode-*）
+AICODE_CMDS=("/aicode-cd" "/grill-me" "/bugs" "/goal" "/plan" "/workflow" "/git-commit" "/feat" "/init-project" "/code-simplifier")
+for cmd in "${AICODE_CMDS[@]}"; do
+    if echo "$cmds_json" | jq -e --arg c "$cmd" '.[] | select(.name == $c)' >/dev/null 2>&1; then
+        pass "扩展命令 $cmd 已注册"
+    else
+        # 可能该命令需要其他条件才注册，标记 skip
+        skip "扩展命令 $cmd 已注册" "未在 get_commands 中找到"
+    fi
+done
+
+# ----- Test 3: get_state 反映扩展注册的工具 -----
+header "$CURRENT_CASE" "tools registered by extensions"
+
+send '{"type":"get_state","id":"e2"}'
+sleep 1
+
+# 通过发 prompt 让模型思考，看 tool_execution_start 是否包含 aicode 扩展工具
+# （aicode-safety-guard 注册的 safety_check / aicode-plan 注册的 todo_update 等）
+
+send '{"type":"prompt","message":"just say hi","id":"e3"}'
+sleep 8
+
+# 收集所有出现过的 tool_name
+all_tools=$(jq -r 'select(.type=="tool_execution_start") | .toolName // empty' "$REGRESSION_LOG" 2>/dev/null | sort -u)
+echo "    observed tools: $(echo "$all_tools" | tr '\n' ' ')"
+
+# 内置工具一定在
+for tool in read bash write edit; do
+    if echo "$all_tools" | grep -qx "$tool"; then
+        pass "内置工具 $tool 可调用"
+    else
+        # 单次 prompt 可能不调用
+        skip "内置工具 $tool 可调用" "本次 prompt 未触发"
+    fi
+done
+
+cleanup_rpc
+summary
+exit $?

package/scripts/regression/cases/03-rpc-protocol.sh

@@ -0,0 +1,259 @@
+#!/usr/bin/env bash
+# 03-rpc-protocol.sh
+# 验证：AicodeRpcClient.kt 实际用到的所有 RPC 命令 + 事件类型兼容性矩阵
+#
+# 这是 RPC 协议层的回归保护伞 — 任何 RPC 命令的字段格式变化都会在这里失败
+#
+# RPC 命令清单（来源：aicode-idea-plugin-swing/src/main/kotlin/com/nu/aicode/rpc/AicodeRpcClient.kt）
+#   状态控制:  prompt / steer / follow_up / abort / compact
+#   查询:      get_state / get_session_stats / get_commands
+#              get_available_models / get_available_thinking_levels
+#              get_messages / get_entries / get_tree
+#   模型控制:  set_model / cycle_model / set_model_provider
+#              set_thinking_level / cycle_thinking_level
+#   工具:      set_tools / bash
+#   会话:      new_session / switch_session / fork
+#   扩展钩子:  extension_ui_response
+#   新增 (0.84.4+): clear_queue
+#
+# 事件类型清单（同上文件 AicodeStreamItem sealed class）
+#   message_update(assistantMessageEvent: text_delta/thinking_delta/thinking)
+#   turn_start / turn_end / message_start / message_end
+#   agent_start / agent_end / agent_settled
+#   tool_execution_start / tool_execution_update / tool_execution_end
+#   queue_update / auto_retry_end
+
+set -uo pipefail
+CURRENT_CASE="03-rpc-protocol"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/common.sh"
+
+header "$CURRENT_CASE" "RPC protocol compatibility matrix"
+
+if ! spawn_rpc 90; then
+    fail "spawn aicode RPC" "进程启动失败"
+    summary
+    exit 1
+fi
+pass "spawn aicode RPC (pid=$REGRESSION_PID)"
+
+# ----- Part 1: 所有 RPC 命令的兼容性 -----
+header "$CURRENT_CASE" "part 1: RPC command compatibility"
+
+# 每个命令: "type|payload|必需 response.success 字段|期望字段"
+# 简化版：只验证 type 字段能被识别（success=true 即视为兼容）
+# 失败类型：响应错误、字段缺失、命令不存在
+# RPC 命令兼容性测试 — 格式: "type|extra_fields_json_object"
+# extra_fields 是 type 之外的字段，会拼到 {"type":"X","id":"rpcN", extra_fields}
+#
+# 注意：只测 pi 核心协议命令。aicode-cli 自定义命令（set_model_provider、set_tools）
+# 是在 extensions 里实现的，跳过 -ne 时不生效，单独在 case 02 中测试。
+#
+# set_thinking_level / cycle_thinking_level 在并发发送场景下响应时序不稳定
+# （0.85.1 表现），交给 case 07 单独验证。
+RPC_COMMANDS=(
+    # 类型查询（pi 核心，必现）
+    "get_state|"
+    "get_session_stats|"
+    "get_commands|"
+    "get_available_models|"
+    "get_available_thinking_levels|"
+
+    # 会话管理
+    "new_session|"
+    "get_messages|"
+    "get_entries|"
+    "get_tree|"
+
+    # 新功能（0.84.4+）
+    "clear_queue|"
+)
+
+cmd_pass=0
+cmd_fail=0
+cmd_skip=0
+idx=0
+for spec in "${RPC_COMMANDS[@]}"; do
+    IFS='|' read -r cmd_type payload <<<"$spec"
+    idx=$((idx + 1))
+
+    req_id="rpc${idx}"
+    # 拼接合法 JSON：{"type":"X","id":"rpcN",<extra>}
+    if [[ -n "$payload" ]]; then
+        send "{\"type\":\"$cmd_type\",\"id\":\"$req_id\",$payload}"
+    else
+        send "{\"type\":\"$cmd_type\",\"id\":\"$req_id\"}"
+    fi
+
+    # 等最多 10 秒响应（set_tools/set_thinking_level 可能需要时间）
+    local_log="$REGRESSION_LOG"
+    waited=0
+    while [[ $waited -lt 20 ]]; do
+        if jq -e "select(.id==\"$req_id\" and .type==\"response\")" "$local_log" >/dev/null 2>&1; then
+            break
+        fi
+        sleep 0.5
+        waited=$((waited + 1))
+    done
+
+    resp=$(jq -c "select(.id==\"$req_id\" and .type==\"response\")" "$local_log" 2>/dev/null | head -1)
+    if [[ -z "$resp" ]]; then
+        fail "RPC $cmd_type 返回 response" "10s 内无响应"
+        cmd_fail=$((cmd_fail + 1))
+        continue
+    fi
+
+    success=$(echo "$resp" | jq -c '.success // false' 2>/dev/null)
+    if [[ "$success" == "true" ]]; then
+        pass "RPC $cmd_type success=true"
+        cmd_pass=$((cmd_pass + 1))
+    else
+        err=$(echo "$resp" | jq -c '.error // ""' 2>/dev/null)
+        # 区分"协议错误"和"业务错误"
+        if [[ -n "$err" ]] && echo "$err" | grep -qiE "Unknown command|not implemented|unsupported"; then
+            skip "RPC $cmd_type success=true" "pi 不支持: $err"
+            cmd_skip=$((cmd_skip + 1))
+        else
+            # 业务错误（如 fork 没 entryId）但协议 OK
+            if [[ "$success" == "false" ]] && [[ -n "$err" ]]; then
+                pass "RPC $cmd_type 协议 OK（业务错误: $err）"
+                cmd_pass=$((cmd_pass + 1))
+            else
+                fail "RPC $cmd_type 协议响应异常" "resp: $resp"
+                cmd_fail=$((cmd_fail + 1))
+            fi
+        fi
+    fi
+done
+
+echo ""
+echo "  RPC 命令小计: $cmd_pass pass / $cmd_fail fail / $cmd_skip skip"
+
+# ----- Part 2: 事件类型 + 字段格式（通过实际 prompt 触发）-----
+header "$CURRENT_CASE" "part 2: event type + field schema"
+
+# 发 prompt 触发完整事件流
+send '{"type":"prompt","message":"just say hi","id":"ev1"}'
+
+# 等 LLM 完成（以 agent_end 为信号，最长 120s）
+waited=0
+while [[ $waited -lt 120 ]]; do
+    # 检查两种结束信号：agent_end 或 agent_settled
+    if jq -e 'select(.type=="agent_end" or .type=="agent_settled")' "$REGRESSION_LOG" >/dev/null 2>&1; then
+        break
+    fi
+    sleep 1
+    waited=$((waited + 1))
+done
+
+if [[ $waited -ge 120 ]]; then
+    fail "LLM 在 120s 内完成" "超时"
+else
+    echo "    LLM 在 ${waited}s 内完成"
+fi
+
+# 事件类型清单（每个都要出现至少 1 次）
+EVENT_TYPES=(
+    "agent_start"
+    "turn_start"
+    "message_start"
+    "message_end"
+    "message_update"
+    "turn_end"
+    "agent_end"
+)
+
+ev_pass=0
+ev_fail=0
+for ev in "${EVENT_TYPES[@]}"; do
+    if jq -e "select(.type==\"$ev\")" "$REGRESSION_LOG" >/dev/null 2>&1; then
+        pass "事件 $ev 出现"
+        ev_pass=$((ev_pass + 1))
+    else
+        fail "事件 $ev 出现" "60s 内未观察到"
+        ev_fail=$((ev_fail + 1))
+    fi
+done
+
+echo ""
+echo "  事件类型小计: $ev_pass pass / $ev_fail fail"
+
+# ----- Part 3: 关键字段 schema 兼容性 -----
+header "$CURRENT_CASE" "part 3: event field schema"
+
+# message_start.message.role 必须是 "user" 或 "assistant"
+role_check=$(jq -c 'select(.type=="message_start") | .message.role // "missing"' "$REGRESSION_LOG" 2>/dev/null | sort -u | tr '\n' ' ')
+echo "    观察到的 roles: $role_check"
+if [[ "$role_check" == *"user"* && "$role_check" == *"assistant"* ]]; then
+    pass "message_start.message.role 包含 user + assistant"
+else
+    fail "message_start.message.role 字段" "got: $role_check"
+fi
+
+# turn_end.message.usage 字段
+usage_keys=$(jq -c 'select(.type=="turn_end") | .message.usage | keys | join(",")' "$REGRESSION_LOG" 2>/dev/null | head -1)
+echo "    turn_end.message.usage keys: $usage_keys"
+for key in input output cost; do
+    if [[ "$usage_keys" == *"$key"* ]]; then
+        pass "turn_end.usage.$key 存在"
+    else
+        fail "turn_end.usage.$key 存在" "got: $usage_keys"
+    fi
+done
+
+# message_update.assistantMessageEvent 子类型必须出现
+ame_subtypes=$(jq -r 'select(.type=="message_update") | .assistantMessageEvent.type // ""' "$REGRESSION_LOG" 2>/dev/null | sort -u | grep -v '^$' | tr '\n' ' ')
+echo "    assistantMessageEvent 子类型: $ame_subtypes"
+for subtype in thinking_delta text_delta; do
+    if [[ "$ame_subtypes" == *"$subtype"* ]]; then
+        pass "assistantMessageEvent.$subtype 出现"
+    else
+        fail "assistantMessageEvent.$subtype 出现" "got: $ame_subtypes"
+    fi
+done
+
+# message_update.assistantMessageEvent.delta 字段
+delta_check=$(jq -c 'select(.type=="message_update" and .assistantMessageEvent.type=="text_delta") | .assistantMessageEvent.delta // "missing"' "$REGRESSION_LOG" 2>/dev/null | head -1)
+if [[ "$delta_check" != '"missing"' && -n "$delta_check" ]]; then
+    pass "assistantMessageEvent.delta 字段存在"
+else
+    fail "assistantMessageEvent.delta 字段存在" "got: $delta_check"
+fi
+
+# turn_end 必须有 message 字段（不是 top-level usage）
+turn_end_schema=$(jq -c 'select(.type=="turn_end") | has("message") and (.message | has("usage"))' "$REGRESSION_LOG" 2>/dev/null | sort -u | head -1)
+if [[ "$turn_end_schema" == "true" ]]; then
+    pass "turn_end.message.usage 嵌套结构"
+else
+    fail "turn_end.message.usage 嵌套结构" "可能 schema 漂移：$turn_end_schema"
+fi
+
+# ----- Part 4: 计时关键字段（与 aicode-plugin-swing 状态计算相关）-----
+header "$CURRENT_CASE" "part 4: timing fields"
+
+# agent_end 可能含 willRetry 字段（aicode-plugin-swing 用它判断是否重试中）
+agent_end_keys=$(jq -c 'select(.type=="agent_end") | keys | join(",")' "$REGRESSION_LOG" 2>/dev/null | head -1)
+echo "    agent_end keys: $agent_end_keys"
+if [[ "$agent_end_keys" == *"willRetry"* ]]; then
+    pass "agent_end.willRetry 字段存在"
+else
+    skip "agent_end.willRetry 字段存在" "未出现（可能本轮不重试）"
+fi
+
+# message_end.stopReason 必须是已知值（0.85+ 新增 "stop" 通用值 + rawStopReason 保留 provider 原值）
+stop_reason=$(jq -c 'select(.type=="message_end" and .message.role=="assistant") | .message.stopReason // "missing"' "$REGRESSION_LOG" 2>/dev/null | sort -u | head -1)
+case "$stop_reason" in
+    '"end_turn"'|'"tool_use"'|'"error"'|'"max_tokens"'|'"stop_sequence"'|'"aborted"'|'"stop"')
+        pass "stopReason 合法 ($stop_reason)"
+        ;;
+    '"missing"')
+        fail "stopReason 字段" "未出现"
+        ;;
+    *)
+        skip "stopReason 已知值" "新值: $stop_reason（需人工确认是否要更新 AicodeRpcClient.kt）"
+        ;;
+esac
+
+cleanup_rpc
+summary
+exit $?

package/scripts/regression/cases/04-prompt-stream.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# 03-prompt-stream.sh
+# 验证：prompt RPC 触发完整 message_update 事件流
+# 核心回归项 — AicodeRpcClient.kt 的 streamPrompt() 完全依赖这套事件序列
+#
+# 关键事件序列（与 aicode-plugin-swing AicodeStreamItem 映射）：
+#   1. {"type":"response","command":"prompt","success":true}   <- RPC 响应
+#   2. {"type":"agent_start"}
+#   3. {"type":"turn_start"}
+#   4. {"type":"message_start",message:{role:"user",...}}
+#   5. {"type":"message_end",message:{role:"user",...}}
+#   6. {"type":"message_start",message:{role:"assistant",api,provider,...}}
+#   7. N × {"type":"message_update",assistantMessageEvent:{type:"thinking_delta",delta:"..."}}
+#   8. {"type":"message_update",assistantMessageEvent:{type:"thinking_end",content:"..."}}
+#   9. {"type":"message_update",assistantMessageEvent:{type:"text_start",contentIndex:N}}
+#  10. N × {"type":"message_update",assistantMessageEvent:{type:"text_delta",delta:"..."}}
+#  11. {"type":"message_update",assistantMessageEvent:{type:"text_end",...}}  (可能)
+#  12. {"type":"message_end",message:{role:"assistant",stopReason:"end_turn"|"tool_use"|...}}
+#  13. {"type":"turn_end",message:{...usage:{input,output,cost,...}}}
+#  14. {"type":"agent_end"}
+
+set -uo pipefail
+CURRENT_CASE="03-prompt-stream"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/common.sh"
+
+header "$CURRENT_CASE" "prompt → message_update stream"
+
+if ! spawn_rpc 60; then
+    fail "spawn aicode RPC" "进程启动失败"
+    summary
+    exit 1
+fi
+pass "spawn aicode RPC (pid=$REGRESSION_PID)"
+
+# 发 prompt
+send '{"type":"prompt","message":"reply with just: ok","id":"p1"}'
+
+# 等 LLM 完成（agent_end 作为信号，最长 120s）
+waited=0
+while [[ $waited -lt 120 ]]; do
+    if jq -e 'select(.type=="agent_end" or .type=="agent_settled")' "$REGRESSION_LOG" >/dev/null 2>&1; then
+        break
+    fi
+    sleep 0.5
+    waited=$((waited + 1))
+done
+
+if [[ $waited -ge 120 ]]; then
+    fail "LLM 在 120s 内完成" "超时"
+else
+    echo "    LLM 在 ${waited}.0s 内完成"
+fi
+
+# 验证事件序列
+header "$CURRENT_CASE" "event sequence"
+
+assert_event_count "agent_start 事件出现" \
+    'select(.type=="agent_start")' 1
+
+assert_event_count "turn_start 事件出现" \
+    'select(.type=="turn_start")' 1
+
+# user message_start / message_end 配对
+assert_event_count "user message_start 出现" \
+    'select(.type=="message_start" and .message.role=="user")' 1
+assert_event_count "user message_end 出现" \
+    'select(.type=="message_end" and .message.role=="user")' 1
+
+# assistant message_start
+assert_event_count "assistant message_start 出现" \
+    'select(.type=="message_start" and .message.role=="assistant")' 1
+
+# assistantMessageEvent 子类型
+header "$CURRENT_CASE" "assistantMessageEvent subtypes"
+
+# 至少 1 个 thinking_start
+assert_event_count "thinking_start 出现" \
+    'select(.type=="message_update" and .assistantMessageEvent.type=="thinking_start")' 1
+
+# 至少 1 个 thinking_delta (流式)
+assert_event_count "thinking_delta 至少 1 个" \
+    'select(.type=="message_update" and .assistantMessageEvent.type=="thinking_delta")' 1
+
+# 至少 1 个 text_start
+assert_event_count "text_start 出现" \
+    'select(.type=="message_update" and .assistantMessageEvent.type=="text_start")' 1
+
+# 至少 1 个 text_delta
+assert_event_count "text_delta 至少 1 个" \
+    'select(.type=="message_update" and .assistantMessageEvent.type=="text_delta")' 1
+
+# assistant message_end
+header "$CURRENT_CASE" "completion events"
+assert_event_count "assistant message_end 出现" \
+    'select(.type=="message_end" and .message.role=="assistant")' 1
+
+# stopReason 字段（end_turn / tool_use / error / stop 0.85+）
+stop_reason=$(jq -c 'select(.type=="message_end" and .message.role=="assistant") | .message.stopReason // "missing"' "$REGRESSION_LOG" 2>/dev/null | head -1)
+case "$stop_reason" in
+    '"end_turn"'|'"tool_use"'|'"error"'|'"max_tokens"'|'"stop_sequence"'|'"aborted"'|'"stop"')
+        pass "assistant stopReason 是 $stop_reason"
+        ;;
+    '"missing"')
+        fail "assistant stopReason 字段" "未出现"
+        ;;
+    *)
+        fail "assistant stopReason 合法" "未知值: $stop_reason"
+        ;;
+esac
+
+# turn_end 带 usage
+assert_event_count "turn_end 事件出现" \
+    'select(.type=="turn_end")' 1
+
+# usage 字段
+usage_input=$(jq -c 'select(.type=="turn_end") | .message.usage.input // "missing"' "$REGRESSION_LOG" 2>/dev/null | head -1)
+if [[ "$usage_input" != '"missing"' && "$usage_input" =~ ^[0-9]+$ ]]; then
+    pass "turn_end.usage.input 是数字 ($usage_input)"
+else
+    fail "turn_end.usage.input 是数字" "got: $usage_input"
+fi
+
+# agent_end 收尾
+assert_event_count "agent_end 事件出现" \
+    'select(.type=="agent_end")' 1
+
+cleanup_rpc
+summary
+exit $?