governor_acquire_slot
Acquires a concurrency slot before launching a sub-agent, enforcing a maximum of three active sub-agents per AI model across instances. Use it to prevent model overload and control queued access.
Instructions
Acquire a sub-agent concurrency slot. Strictly enforces a limit of no more than 3 active sub-agents per AI model (cross-instance safe).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"modelId": "<modelId>",
"subAgentName": "<subAgentName>"
},
"name": "governor_acquire_slot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| modelId | Yes | Identifier of the AI model being used (e.g. "gemini-3.8-flash", "gemini-2.5-pro", "o3", "claude-3-7-sonnet"). | |
| priority | No | Queue priority (low, normal, high, critical). Defaults to normal. | |
| timeoutMs | No | Max milliseconds to wait in priority queue if capacity is full (default: 0 = immediate reject). | |
| subAgentName | Yes | Role or title of the sub-agent (e.g. "Codebase Researcher", "Unit Tester"). | |
| idempotencyKey | No | Optional unique key to prevent duplicate lease grants on client retries. | |
| leaseTtlSeconds | No | Safety TTL for this lease in seconds before automatic release (default: 600s). |