@standardagents/spec 0.36.3 → 0.37.0

package/dist/index.d.ts

@@ -3774,6 +3774,20 @@ interface PromptToolConfig {
  * a non-empty human-readable `name` argument and runtimes SHOULD persist it as
  * a child thread display name.
  *
+ * ### Pull-based child visibility
+ *
+ * Whenever resumable subagent configs exist, runtimes MUST also inject a
+ * `subagents` query tool that returns the model-visible registry snapshot
+ * (reference id, name, status, working-status text, initial arguments) as a
+ * tool result on demand. Runtimes MUST NOT additionally inject an ambient
+ * registry system message into request context when the query tool is
+ * available: child state is pull-based (plus completion messages), because a
+ * registry block that mutates between requests both invalidates provider
+ * prefix caches and reads as out-of-dialogue state to agentic-tuned models.
+ * The injected tool descriptions SHOULD direct the model to call `subagents`
+ * before `subagent_create` so existing instances are reused instead of
+ * duplicated.
+ *
  * ### Persistent invocation arguments
  *
  * The child side that receives parent messages dictates initial invocation