Skip to content

docs(RFD): Subagents#855

Draft
egor-baranov wants to merge 1 commit intoagentclientprotocol:mainfrom
egor-baranov:codex/subagents-rfd
Draft

docs(RFD): Subagents#855
egor-baranov wants to merge 1 commit intoagentclientprotocol:mainfrom
egor-baranov:codex/subagents-rfd

Conversation

@egor-baranov
Copy link
Copy Markdown
Contributor

No description provided.

* an optional capability:

sessionCapabilities.subagents?: {
promptDelegation?: boolean
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

better to have all capabilities as objects for the future extensibility


* a new `SessionUpdate` variant:

available_subagents_update
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why have both availableSubagents on session response AND available_subagents_update? Can't we just go with update, the same as for commands?

`delegation` controls per-prompt delegation behavior:

* `policy: "auto"` means the agent chooses whether to delegate.
* `policy: "disable"` means the agent MUST NOT spawn a new subagent run for that prompt turn. If the implementation cannot honor that constraint, it MUST reject the request.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is it a thing in existing agents? Why would a user care about disabling delegation?


When an agent spawns a subagent run, it MUST:

* create a child session identifier for the delegated run;
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I call exact subagent using PromptDelegation with require — how many sessions are spawned?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants