oz0 tenant tasks
For: Operators and developers looking up a command.
A remote MCP server may answer a tool call with a task (MCP's Tasks extension) instead of holding the call open while it works: the node's activity then ends at once and gives its slot back, and the job looks at the task from timers in its own history, at the server's poll interval (at least 2 s, at most 60 s, doubling after ten looks), until it ends.
Its result then goes through everything a call's answer does: labels, scrubbing, files and usage. A task that asks something waits for a person, as a question; the job's cancel and a kill switch cancel it at its server; one still running at the tool's time limit is cancelled and its outcome is unknown. The runtime declares the extension only for the remote tools of the connections named here, so with none every call waits for its answer, as before.
--connections names them (a plugin's connection names), --all allows every connection, and --off allows none. Without flags it shows the setting. It is part of the tenant's tool policy, so a change takes --reason (or $OZ0_REASON) as any tool-policy change does; jobs that are running read it at their next call.
Usage
oz0 tenant tasks <tenant> [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--all | bool | allow tasks for every connection's remote tools | |
--connections | strings | the connections whose remote tools may run calls as tasks, by name | |
--decision-ref | string | the decision or case the change follows, such as a case number (at most 200 characters) | |
--json | bool | print JSON instead of a table | |
--off | bool | allow tasks for no connection: every call waits for its answer | |
--reason | string | why, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--context | string | $OZ0_CONTEXT or <config dir>/orchestrator-zero/context.json | CLI context file written by server init |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0 commands and the global flags.