From d3b59880616e1f054d961216001bb5800422acdc Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Sat, 25 Jul 2026 15:25:52 +0800
Subject: [PATCH] docs(subagent): restore refusal contract comment

---
 docs/core-data-structures/subagent.i18n.yaml | 4 ++--
 docs/core-data-structures/subagent.md        | 1 +
 docs/core-data-structures/subagent.zh.md     | 1 +
 packages/subagent/subagent/src/types.ts      | 1 +
 4 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/core-data-structures/subagent.i18n.yaml b/docs/core-data-structures/subagent.i18n.yaml
index f0dd732459..af4b1decda 100644
--- a/docs/core-data-structures/subagent.i18n.yaml
+++ b/docs/core-data-structures/subagent.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
-subagent.md: 8a134b7be641323057135bcf772bf4cccec5c9a3
-subagent.zh.md: a66ad6b6c3b503b81fac97387577a689848edad2
+subagent.md: 2497dbab9cfc8304eb7aaeba7109404ac614bbff
+subagent.zh.md: 2d96e9bc635951746e72ed58a7c3638dc2598cc2
diff --git a/docs/core-data-structures/subagent.md b/docs/core-data-structures/subagent.md
index 8a134b7be6..2497dbab9c 100644
--- a/docs/core-data-structures/subagent.md
+++ b/docs/core-data-structures/subagent.md
@@ -135,6 +135,7 @@ interface SubagentStopReasonMap {
   error: 'error'
   /** The child hit its token ceiling before finishing. */
   'max-tokens': 'max-tokens'
+  /** The child declined the task. */
   refusal: 'refusal'
 }
 ```
diff --git a/docs/core-data-structures/subagent.zh.md b/docs/core-data-structures/subagent.zh.md
index a66ad6b6c3..2d96e9bc63 100644
--- a/docs/core-data-structures/subagent.zh.md
+++ b/docs/core-data-structures/subagent.zh.md
@@ -135,6 +135,7 @@ interface SubagentStopReasonMap {
   error: 'error'
   /** The child hit its token ceiling before finishing. */
   'max-tokens': 'max-tokens'
+  /** The child declined the task. */
   refusal: 'refusal'
 }
 ```
diff --git a/packages/subagent/subagent/src/types.ts b/packages/subagent/subagent/src/types.ts
index fdb3527ebd..527d93c8e1 100644
--- a/packages/subagent/subagent/src/types.ts
+++ b/packages/subagent/subagent/src/types.ts
@@ -108,6 +108,7 @@ export interface SubagentStopReasonMap {
   error: 'error'
   /** The child hit its token ceiling before finishing. */
   'max-tokens': 'max-tokens'
+  /** The child declined the task. */
   refusal: 'refusal'
 }