mirrors/pikasTech-agentrun
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 固化 command result 长 trace 合同

Browse Source
This commit is contained in:
Codex
2026-06-09 21:56:31 +08:00
parent 17918cda0a
commit 5ff882005b
3 changed files with 10 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/spec-v01-hwlab-manual-dispatch.md
+1 -1
View File
@@ -112,7 +112,7 @@ AgentRun 标准 events 必须稳定到足以被 HWLAB 转换：
- `error`：`failureKind`、message、retryable、provider/infra/backend 分类和 redacted details。
- `terminal_status`：`completed`、`failed`、`blocked` 或 `cancelled`，是 completed 的唯一终态来源。
面向 HWLAB 的 result envelope 至少应能回答：`status`、`terminalStatus`、`reply`、`failureKind`、`blocker`、`lastSeq`、`eventCount`、`artifactSummary`、`runId`、`commandId` 和 `attemptId`。partial assistant 文本、transport close、idle timeout 或 stdout 存在都不能单独升级为 `completed`。
面向 HWLAB 的 result envelope 权威规则见 [spec-v01-agentrun-mgr.md](spec-v01-agentrun-mgr.md#result-envelope)。HWLAB 至少应消费 `status`、`terminalStatus`、`reply/finalResponse`、`failureKind`、`blocker`、`lastSeq`、`eventCount`、`eventsCapped`、`nextAfterSeq`、`finalAssistantSeq`、`artifactSummary`、`runId`、`commandId` 和 `attemptId`。partial assistant 文本、transport close、idle timeout 或 stdout 存在都不能单独升级为 `completed`；当 `eventsCapped=true` 或 final assistant 标记截断时，HWLAB 应继续读取 AgentRun events/trace，而不是把当前摘要当作完整归档。
command terminal 与 run terminal 必须分离。普通 turn completed 只终结对应 command，并更新 SessionRef/thread 摘要；同一 run 保持可继续接收 command，已启动 runner Job 在 idle timeout 内继续 poll。只有显式 run cancel、runner 级不可恢复失败或未来 scheduler/retention 策略要求时，run 才进入 terminal。