test(subagent): sync wait guidance across SDK and Web snapshots

snapshots/sdk/background-wait-steer/tool-schemas.expected.json

@@ -699,7 +699,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/bash-tool/tool-schemas.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/command-attachments/tool-schemas.expected.json

@@ -776,7 +776,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -811,7 +811,7 @@
         "properties": {
           "queries": {
             "type": "array",
-            "description": "1–4 search queries; their results are merged.",
+            "description": "1–10 search queries; their results are merged.",
             "items": {
               "type": "string"
             }

snapshots/sdk/desktop-context/tool-schemas.expected.json

@@ -760,7 +760,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/desktop-ptc-context/system-prompt.expected.md

@@ -311,7 +311,7 @@ interface ToolArgsMap {
     /** Required only with action blocked: the concrete condition that persisted across rounds and blocks progress. */
     blocked_reason?: string;
   } & Record<string, JsonValue>;
-  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending. */
+  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop. */
   wait_agent: {
     /** Wait duration in milliseconds, from 10000 through 3600000. Defaults to 30000. */
     timeout_ms?: number;

snapshots/sdk/plan-review/tool-schemas.expected.json

@@ -760,7 +760,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -795,7 +795,7 @@
         "properties": {
           "queries": {
             "type": "array",
-            "description": "1–4 search queries; their results are merged.",
+            "description": "1–10 search queries; their results are merged.",
             "items": {
               "type": "string"
             }
@@ -1709,7 +1709,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -1744,7 +1744,7 @@
           "properties": {
             "queries": {
               "type": "array",
-              "description": "1–4 search queries; their results are merged.",
+              "description": "1–10 search queries; their results are merged.",
               "items": {
                 "type": "string"
               }
@@ -2657,7 +2657,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -2692,7 +2692,7 @@
           "properties": {
             "queries": {
               "type": "array",
-              "description": "1–4 search queries; their results are merged.",
+              "description": "1–10 search queries; their results are merged.",
               "items": {
                 "type": "string"
               }
@@ -3605,7 +3605,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -3640,7 +3640,7 @@
           "properties": {
             "queries": {
               "type": "array",
-              "description": "1–4 search queries; their results are merged.",
+              "description": "1–10 search queries; their results are merged.",
               "items": {
                 "type": "string"
               }
@@ -4553,7 +4553,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -4588,7 +4588,7 @@
           "properties": {
             "queries": {
               "type": "array",
-              "description": "1–4 search queries; their results are merged.",
+              "description": "1–10 search queries; their results are merged.",
               "items": {
                 "type": "string"
               }

snapshots/sdk/session-resume/tool-schemas.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -511,7 +511,7 @@
         "properties": {
           "queries": {
             "type": "array",
-            "description": "1–4 search queries; their results are merged.",
+            "description": "1–10 search queries; their results are merged.",
             "items": {
               "type": "string"
             }
@@ -1125,7 +1125,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -1160,7 +1160,7 @@
           "properties": {
             "queries": {
               "type": "array",
-              "description": "1–4 search queries; their results are merged.",
+              "description": "1–10 search queries; their results are merged.",
               "items": {
                 "type": "string"
               }

snapshots/sdk/subagent-activation-limit/tool-schemas.1.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-continuable-inheritance/tool-schemas.1.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-continuable/tool-schemas.1.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-dsh-sdk-diagnostic/tool-schemas.expected.json

@@ -526,7 +526,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-dsh-sdk-dynamic-route/tool-schemas.1.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-dsh-sdk-dynamic-route/tool-schemas.expected.json

@@ -505,7 +505,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-list-agents/tool-schemas.1.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/subagent-send-message/tool-schemas.1.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/text-turn/tool-schemas.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/sdk/tool-error-details/system-prompt.expected.md

@@ -251,7 +251,7 @@ interface ToolArgsMap {
     /** Required only with action blocked: the concrete condition that persisted across rounds and blocks progress. */
     blocked_reason?: string;
   } & Record<string, JsonValue>;
-  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending. */
+  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop. */
   wait_agent: {
     /** Wait duration in milliseconds, from 10000 through 3600000. Defaults to 30000. */
     timeout_ms?: number;

snapshots/sdk/tool-error-details/tool-schemas.expected.json

@@ -476,7 +476,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/web/creation-recommendations/tool-schemas.expected.json

@@ -789,7 +789,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -1783,7 +1783,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {

snapshots/web/fresh-round-trip/tool-schemas.expected.json

@@ -789,7 +789,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {

snapshots/web/official-subagent-bundle/system-prompt.expected.md

@@ -299,7 +299,7 @@ interface ToolArgsMap {
     /** Required only with action blocked: the concrete condition that persisted across rounds and blocks progress. */
     blocked_reason?: string;
   } & Record<string, JsonValue>;
-  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending. */
+  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop. */
   wait_agent: {
     /** Wait duration in milliseconds, from 10000 through 3600000. Defaults to 30000. */
     timeout_ms?: number;

snapshots/web/optional-string-editor/system-prompt.expected.md

@@ -307,7 +307,7 @@ interface ToolArgsMap {
     /** Required only with action blocked: the concrete condition that persisted across rounds and blocks progress. */
     blocked_reason?: string;
   } & Record<string, JsonValue>;
-  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending. */
+  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop. */
   wait_agent: {
     /** Wait duration in milliseconds, from 10000 through 3600000. Defaults to 30000. */
     timeout_ms?: number;

snapshots/web/plugin-recommendations/tool-schemas.expected.json

@@ -789,7 +789,7 @@
     },
     {
       "name": "wait_agent",
-      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+      "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -1783,7 +1783,7 @@
       },
       {
         "name": "wait_agent",
-        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending.",
+        "description": "Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop.",
         "parameters": {
           "type": "object",
           "properties": {

snapshots/web/ptc-round/system-prompt.expected.md

@@ -290,7 +290,7 @@ interface ToolArgsMap {
     /** Required only with action blocked: the concrete condition that persisted across rounds and blocks progress. */
     blocked_reason?: string;
   } & Record<string, JsonValue>;
-  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately when that input is already pending. */
+  /** Wait for input at your next step, including agent messages, completion notifications, and user steering. Returns immediately if input is pending. When called from code, wait once, then finish execution so messages can be delivered. Do not loop. */
   wait_agent: {
     /** Wait duration in milliseconds, from 10000 through 3600000. Defaults to 30000. */
     timeout_ms?: number;