docs(subagent): clarify diagnostic-bearing results

This commit is contained in:
pku-xht
2026-08-21 08:52:19 +08:00
parent d5fe4e9307
commit b9cbcf8e2b
4 changed files with 6 additions and 4 deletions
@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/subagent/subagent-dsh-sdk/README.md
README.md: bb2ebd14058b356621f7fbcb559522f4384b2a10
README.zh.md: 8f4372c630ba763e705572797a5e9b9ec0b405cc
README.md: 59f63faffe55dc8c29c08fec5e437379601d44a1
README.zh.md: b6e7f50adf739257b747d208ba361e0b6aeab360
+1 -1
View File
@@ -102,7 +102,7 @@ Independent of the parent request cache. Each SDK child can reuse only prefixes
#### What the model sees
Through `dsh-tool-subagent`, the parent receives only the child's final assistant text (or accumulated partial text) or that consumer's exact stop-reason error, not intermediate messages or tool traffic. A non-completed result presents the safe diagnostic before separately preserved partial assistant output; startup and shutdown errors expose the same fixed facts without raw SDK text.
Through `dsh-tool-subagent`, the parent receives only the child's final assistant text (or accumulated partial text) or that consumer's exact stop-reason error, not intermediate messages or tool traffic. A diagnostic-bearing non-completed result presents the safe diagnostic before separately preserved partial assistant output; startup and shutdown errors expose the same fixed facts without raw SDK text.
#### Token effect
@@ -102,7 +102,7 @@ Provider 不宣告任何启动期能力(`outputSchema`/`depthLimit`/`toolFilte
#### 模型看到的内容
经由 `dsh-tool-subagent`,父级只会收到子运行时最终的 assistant 文本(或累积的部分文本),或该消费方给出的精确停止原因错误;不会收到中间消息或工具流量。非完成结果会先呈现安全诊断,再单独呈现保留的部分 assistant 输出;启动与 shutdown 错误使用同一固定事实,不公开原始 SDK 文本。
经由 `dsh-tool-subagent`,父级只会收到子运行时最终的 assistant 文本(或累积的部分文本),或该消费方给出的精确停止原因错误;不会收到中间消息或工具流量。带诊断的非完成结果会先呈现安全诊断,再单独呈现保留的部分 assistant 输出;启动与 shutdown 错误使用同一固定事实,不公开原始 SDK 文本。
#### Token 影响
@@ -274,6 +274,8 @@ export async function startSdkRun(request: SubagentStartRequest, spec: SdkRunSpe
} catch (cleanupError: unknown) {
reportFailure(spec, cleanupError)
const cleanupFailure = new SdkRunFailure({ stage: 'shutdown', category: 'unknown' }, cleanupError)
// Preserve failed cleanup as a failed Job; settleStart treats only an
// aborted non-AggregateError rejection as a cleanly killed startup.
throw new AggregateError([cleanupFailure], cleanupFailure.message)
}
throw new Error('subagent request was aborted before the SDK child started')