llm-pi-ai 把 upstream_http2_stream_error 归入不可重试的 PI_AI_ERROR，瞬时上游流中断会直接中断整轮

[imneov]

现象

@deepseek-ai/dsh-llm-pi-ai 在网关返回如下终止错误时：

Error Code upstream_http2_stream_error: Upstream HTTP/2 stream failed

会落到 classifyPiAiError 的兜底分支 PI_AI_ERROR。该码不在 provider retryPolicy 的默认可重试集合（EMPTY_RESPONSE / RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT）中，所以这类瞬时的上游流中断不会进入自动重试，而是直接以 turn/end { kind: "error" } 结束整轮，必须由人重新发消息才能继续。

复现

让一条 openai-responses 路由的端点先返回终态错误事件：

{"type":"error","code":"upstream_http2_stream_error","message":"Upstream HTTP/2 stream failed"}

再返回正常 SSE 完成事件。观察会话日志：turn/end 直接是 kind: "error"，且没有 llm/retry 事件。

实际观测（codex/gpt-6.1-sol 路由，网关 sub2api.a2d2.dev）：同一故障窗口内，TRANSPORT 类失败会各自记录 5/5 次重试；而该条 upstream_http2_stream_error 一次都不重试，轮次直接失败。

期望

upstream_http2_stream_error 与 Upstream HTTP/2 stream failed 表示上游连接在流式返回过程中被重置，属于传输类故障，应与既有的 other side closed / HTTP2 request did not get a response / terminated 同等对待，归类为 TRANSPORT，由 provider 的 retryPolicy 决定重试次数。

补丁

fork 分支：imneov/deepseek-harness → fix/http2-stream-recovery-release，基线 master（639ed01539），2 个提交：

• fix(llm-pi-ai): classify upstream HTTP2 resets as transport failures —— src/stream.ts 增加一条传输类匹配；tests/convert.spec.ts（+34）与 tests/loader-composition.spec.ts（+39）覆盖分类结果，以及真实 Loader 组合下经 Responses SSE 的重试路径；README 双语与 README.i18n.yaml 同步。
• test(llm): record bounded HTTP2 stream recovery without partial history —— 新增录制会话 snapshots/session/gateway-http2-stream-retry/，经 dsh --profile headless 回放，确认失败尝试不进入消息历史且恢复后同轮完成。

本地证据：

pnpm exec vitest run packages/llm/llm-pi-ai/tests/convert.spec.ts packages/llm/llm-pi-ai/tests/loader-composition.spec.ts
→ Test Files 2 passed (2) / Tests 94 passed (94)

pnpm run test:snapshot -t gateway-http2-stream-retry
→ 1 passed（replays gateway-http2-stream-retry through dsh --profile headless）

CONTRIBUTING 说明当前不接受外部 PR，因此按该文件指引在 Discussions 报障，并保留一个从 fork 发起的 PR 作为公开记录。若维护者认为该改动本身合适、或有更合适的提交方式，请告知。

[imneov]

补充：由于组织权限限制，当前账号执行 CreatePullRequest 被拒绝（对该仓库仅有 pull: true），无法直接发起 PR。补丁已在 fork 上就绪，维护者可用以下比较链接查看并取用：

https://github.com/deepseek-ai/deepseek-harness/compare/master...imneov:fix/http2-stream-recovery-release?expand=1

• fork：imneov/deepseek-harness
• 分支：fix/http2-stream-recovery-release
• head：6c79f4f6e0，基线：master（639ed01539）

[imneov]

补充（同一处修复的延伸）：除 HTTP/2 流重置外，网关的两类瞬时错误同样会落到兜底 PI_AI_ERROR 并中断整轮：

• gateway_concurrency_limit（Concurrency limit exceeded for user, please retry later）→ 现映射为 RATE_LIMIT
• upstream_error（Upstream service temporarily unavailable）→ 现映射为 SERVER

两者都在 retryPolicy 的默认可重试集合内，因此由既有的指数退避（initialDelayMs × 2^(retry-1)，封顶 maxDelayMs，含抖动）接管，不再第一次就停轮。反向用例（upstream_error_details are unavailable、HTTP 400: upstream_error、Unsupported gateway concurrency configuration）仍保持 PI_AI_ERROR / INVALID_REQUEST，未识别错误依旧不可重试。

分支已更新为 head 38b643c187（基于 639ed01539，共 3 个提交）：

https://github.com/deepseek-ai/deepseek-harness/compare/master...imneov:fix/http2-stream-recovery-release?expand=1