ask_codex_async
Dispatch Codex tasks in the background without blocking, then retrieve the JSON result from the agent's mailbox when ready.
Instructions
Dispatch a Codex task in the background; returns immediately.
Runs the same ask_codex in a background thread, then delivers the
result through the existing mailbox as a message from "codex" to
from_agent — poll it with inbox(agent=from_agent). The delivered
message body is the JSON-encoded ask_codex result, plus label if
supplied (use it to match results when firing several concurrent
dispatches). from_agent must be a known agent. Fire-and-forget: not
persisted, so a hardline-mcp restart before completion loses the task.
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": {
"prompt": "<prompt>",
"from_agent": "<from_agent>"
},
"name": "ask_codex_async"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | ||
| model | No | ||
| write | No | ||
| effort | No | default | |
| prompt | Yes | ||
| workdir | No | ||
| from_agent | Yes |