A delegation asks the person first only for an agent they opted into, through delegation.ask in a config file or delegation ask in the agent's definition, at the session's approval gate with five answers, and orchestrate is a primary nobody gets unless they choose it¶
Decision 850 · accepted · 2026-10-11 · issue #554
- The opt-in is both a config key and a definition key, and either is enough.
delegation.ask: [general, implementer]in aconfig.yamlis the person's: it names built-ins without copying their definitions, it is on the ladder every other setting is (user file, a trusted project's files,config.local.yaml, the command line), and it is inmix troupe.config.schema, sotroupe config --explain delegation.asksays which file set it.delegation: askin an agent's frontmatter is the definition's: it is what a pod's session follows, because a pod has no config file of its own and its profile's configuration is its bundle, whose agents carry the key; it is also how a repository makes its own agents ask. Not one or the other: a config key alone would leave a pod no way to ask short of new plane terms, and a definition key alone would have a person copygeneral.mdwhole to see its briefs. The two are a union and neither can take back the other: asking is what someone opted into. delegationis a trusted key. A project's.troupe/config.yamlsets it only in a trusted workspace and a pod never reads it from a repository, asapprovalsandauto_approve: it changes approvals, and a repository's file replacing the list could quietly turn off the briefs a person asked to see. A repository that wants its agents to ask writesdelegation: askin its own definitions, which only ever narrows.auto_approvedoes not answer the gate. The person asked to see this agent's briefs, and a switch that says "do not ask me about tool calls" did not take that back, as it does not answer a call Decision 823 says must be asked. Turningauto_approveon mid-session leaves a delegation waiting.allow_sessiondoes answer it, scoped to the agent: "always forgeneral" letsgeneralrun unasked for the session, not every agent; it is remembered in the log, so it holds after a restart, and undermanaged_permission_rules_onlyit is a plain allow, as for any tool.- It is the approval flow, not a new one. The delegate call waits in a task under the agent, as an asking tool's call does, so the agent collects its other calls meanwhile and a cancel ends the wait with the task.
- Headless. With
approvals: denythe gate is denied at once, as any request with nobody to ask; the TUI's headless run denies what asks, as it always has, and its line says this one asks because ofdelegation.askand that--auto-approvedoes not answer it. orchestrate. A built-in primary besidebuild, choosable wherever primaries are listed (command mode's chooser and both agents managers listagents.list's primaries), neverdefault_agentand offered by nothing. Two profiles rather thanworkflowwith a free plan, as #554's comment weighed:workflowruns a repository's declared step list and its instruction is built around it,orchestrateis the same contract with no list, and the two share the brief, the finish and this gate.
Governs: apps/troupe_core/lib/troupe/tools/delegate.ex, apps/troupe_core/lib/troupe/session/approvals.ex, apps/troupe_core/lib/troupe/agent/definition.ex, apps/troupe_core/lib/troupe/agent/validate.ex, apps/troupe_protocol/lib/troupe/protocol/agent_definition.ex