docs(subagent): clarify diagnostic-bearing results

packages/subagent/subagent-dsh-sdk/README.i18n.yaml

@@ -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

packages/subagent/subagent-dsh-sdk/README.md

@@ -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
 

packages/subagent/subagent-dsh-sdk/README.zh.md

@@ -102,7 +102,7 @@ Provider 不宣告任何启动期能力（`outputSchema`/`depthLimit`/`toolFilte
 
 #### 模型看到的内容
 
-经由 `dsh-tool-subagent`，父级只会收到子运行时最终的 assistant 文本（或累积的部分文本），或该消费方给出的精确停止原因错误；不会收到中间消息或工具流量。非完成结果会先呈现安全诊断，再单独呈现保留的部分 assistant 输出；启动与 shutdown 错误使用同一固定事实，不公开原始 SDK 文本。
+经由 `dsh-tool-subagent`，父级只会收到子运行时最终的 assistant 文本（或累积的部分文本），或该消费方给出的精确停止原因错误；不会收到中间消息或工具流量。带诊断的非完成结果会先呈现安全诊断，再单独呈现保留的部分 assistant 输出；启动与 shutdown 错误使用同一固定事实，不公开原始 SDK 文本。
 
 #### Token 影响
 

packages/subagent/subagent-dsh-sdk/src/run.ts

@@ -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')