codex-toys 0.140.2 → 0.140.4

package/dist/cli/index.js

@@ -11,10 +11,12 @@ import { collectRemotePreflight, formatRemotePreflight, } from "./remote-preflig
 import { createTurnAutomationHost, formatTurnAutomationList, formatTurnAutomationRun, listTurnAutomations, resolveTurnAutomationTarget, runTurnAutomationScript, } from "./turn-automation.js";
 import { createLocalToyboxTransport, createSshToyboxTransport, hasSshRemote, withSshRemoteToyboxTransport, } from "./remote-provider.js";
 import { REMOTE_AUTOMATION_LIST_METHOD, REMOTE_AUTOMATION_RUN_METHOD, } from "./remote-automation.js";
+import { HOST_OVERVIEW_METHOD } from "../host-overview.js";
 import { WORKSPACE_FUNCTIONS_CALL_METHOD, WORKSPACE_FUNCTIONS_DESCRIBE_METHOD, WORKSPACE_FUNCTIONS_LIST_METHOD, } from "../functions.js";
+import { WORKSPACE_OVERVIEW_METHOD, } from "../workspace-overview.js";
 import { serveToybox } from "./toybox.js";
 import { formatThreadRolloutInspection, formatThreadRolloutInstallation, formatThreadRolloutLocation, formatThreadRolloutTransplant, installThreadRollout, inspectThreadRollout, locateThreadRollout, transplantThreadRollout, } from "../threads.js";
-import { collectDeferredRuns, collectWorkspaceDoctorInfo, commitActionsWorkspaceState, cancelDeferredRunIntent, createWorkspaceContext, createDeferredRunIntent, listDeferredRunIntents, pruneDeferredRunHistory, readDeferredRun, formatWorkspaceDoctorInfo, runDueDeferredRuns, runWorkspaceTaskById, scaffoldActionsWorkspace, tickWorkspace, } from "./workspace-autonomy.js";
+import { collectDeferredRuns, collectLocalHandoffRuns, collectPromptQueueRuns, collectWorkspaceDoctorInfo, commitActionsWorkspaceState, cancelDeferredRunIntent, createWorkspaceContext, createDeferredRunIntent, drainLocalHandoffQueue, enqueueLocalHandoffIntent, enqueuePromptQueueIntent, listLocalHandoffIntents, listPromptQueueIntents, listDeferredRunIntents, pruneDeferredRunHistory, readDeferredRun, formatWorkspaceDoctorInfo, retryDeferredRunIntent, runDuePromptQueueIntents, runDueDeferredRuns, runWorkspaceTaskById, scaffoldActionsWorkspace, tickWorkspace, } from "./workspace-autonomy.js";
 import { formatWorkspaceDelegationListResult, formatWorkspaceDelegationStartResult, startWorkspaceDelegationWithRequest, } from "./workspace-delegation.js";
 import { serveCodexToysMcp } from "./mcp.js";
 import { parseJsonParamsText, readJsonFile } from "./json.js";
@@ -146,6 +148,10 @@ async function main() {
             : `${JSON.stringify(response.result, null, 2)}\n`);
         return;
     }
+    if (parsed.type === "host-overview") {
+        writeJson(await callToybox(HOST_OVERVIEW_METHOD, {}, parsed), parsed.pretty);
+        return;
+    }
     if (parsed.type === "turn-run") {
         const result = await startRemoteTurn({
             prompt: parsed.prompt,
@@ -246,6 +252,16 @@ async function main() {
             : `${formatWorkspaceDoctorInfo(info)}toybox             ${toyboxLabelForDoctor(toybox)}\n`);
         return;
     }
+    if (parsed.type === "workspace-overview") {
+        const overview = await callToybox(WORKSPACE_OVERVIEW_METHOD, compactUndefined({
+            mode: parsed.mode,
+            workspaceRoot: parsed.workspaceRoot,
+        }), parsed);
+        write(parsed.json
+            ? `${JSON.stringify(overview, null, parsed.pretty ? 2 : 0)}\n`
+            : formatWorkspaceOverview(overview));
+        return;
+    }
     if (parsed.type === "workspace-tick") {
         const context = await createWorkspaceContext({
             workspaceRoot: parsed.workspaceRoot,
@@ -278,6 +294,324 @@ async function main() {
         }, parsed.pretty);
         return;
     }
+    if (parsed.type === "workspace-prompt-enqueue") {
+        validateAutomationTurnOptions(parsed);
+        const params = compactUndefined({
+            prompt: parsed.prompt,
+            title: parsed.title,
+            queue: parsed.queue,
+            labels: parsed.labels.length > 0 ? parsed.labels : undefined,
+            runAt: parsed.runAt,
+            afterIntentId: parsed.afterIntentId,
+            afterStatus: parsed.afterStatus,
+            threadId: parsed.threadId,
+            cwd: parsed.cwd,
+            model: parsed.model,
+            serviceTier: parsed.serviceTier,
+            effort: parsed.effort,
+            sandbox: parsed.sandbox,
+            approvalPolicy: parsed.approvalPolicy,
+            permissions: parsed.permissions,
+        });
+        const result = hasSshRemote(parsed)
+            ? await callToybox("promptQueue.enqueue", compactUndefined({
+                ...params,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : {
+                intent: await enqueuePromptQueueIntent(await createWorkspaceContext({
+                    workspaceRoot: parsed.workspaceRoot,
+                    mode: parsed.mode,
+                }), params),
+            };
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-prompt-list") {
+        if (hasSshRemote(parsed)) {
+            const result = await callToybox("promptQueue.list", compactUndefined({
+                status: parsed.status,
+                queue: parsed.queue,
+                limit: parsed.limit,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed);
+            write(parsed.json
+                ? `${JSON.stringify(result, null, parsed.pretty ? 2 : 0)}\n`
+                : formatPromptQueueList((record(result).intents ?? [])));
+            return;
+        }
+        const context = await createWorkspaceContext({
+            workspaceRoot: parsed.workspaceRoot,
+            mode: parsed.mode,
+        });
+        const intents = await listPromptQueueIntents(context, {
+            status: parsed.status,
+            queue: parsed.queue,
+            limit: parsed.limit,
+        });
+        write(parsed.json
+            ? `${JSON.stringify({ intents }, null, parsed.pretty ? 2 : 0)}\n`
+            : formatPromptQueueList(intents));
+        return;
+    }
+    if (parsed.type === "workspace-prompt-read") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("promptQueue.read", compactUndefined({
+                id: parsed.intentId,
+                includeOutput: parsed.includeOutput,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await readDeferredRun(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), parsed.intentId, { includeOutput: parsed.includeOutput });
+        write(parsed.json
+            ? `${JSON.stringify(result, null, parsed.pretty ? 2 : 0)}\n`
+            : `${JSON.stringify(result, null, 2)}\n`);
+        return;
+    }
+    if (parsed.type === "workspace-prompt-collect") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("promptQueue.collect", compactUndefined({
+                cursor: parsed.cursor,
+                queue: parsed.queue,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await collectPromptQueueRuns(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), { cursor: parsed.cursor, queue: parsed.queue });
+        write(parsed.json
+            ? `${JSON.stringify(result, null, parsed.pretty ? 2 : 0)}\n`
+            : `${JSON.stringify(result, null, 2)}\n`);
+        return;
+    }
+    if (parsed.type === "workspace-prompt-cancel") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("promptQueue.cancel", compactUndefined({
+                id: parsed.intentId,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : {
+                intent: await cancelDeferredRunIntent(await createWorkspaceContext({
+                    workspaceRoot: parsed.workspaceRoot,
+                    mode: parsed.mode,
+                }), parsed.intentId),
+            };
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-prompt-retry") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("promptQueue.retry", compactUndefined({
+                id: parsed.intentId,
+                runAt: parsed.runAt,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await retryDeferredRunIntent(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), parsed.intentId, compactUndefined({
+                runAt: parsed.runAt,
+            }));
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-prompt-run-due") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("promptQueue.runDue", compactUndefined({
+                queue: parsed.queue,
+                limit: parsed.limit,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await withToyboxRequest(parsed, async (request) => await runDuePromptQueueIntents(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), {
+                queue: parsed.queue,
+                limit: parsed.limit,
+                callToybox: request,
+                automationCwd: parsed.cwd,
+            }));
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-handoff-enqueue") {
+        validateAutomationTurnOptions(parsed);
+        const params = compactUndefined({
+            prompt: parsed.prompt,
+            title: parsed.title,
+            queue: parsed.queue,
+            labels: parsed.labels.length > 0 ? parsed.labels : undefined,
+            runAt: parsed.runAt,
+            afterIntentId: parsed.afterIntentId,
+            afterStatus: parsed.afterStatus,
+            targetHost: parsed.targetHost,
+            requiredCapabilities: parsed.requiredCapabilities.length > 0 ? parsed.requiredCapabilities : undefined,
+            requesterHost: parsed.requesterHost,
+            requesterThreadId: parsed.requesterThreadId,
+            threadId: parsed.threadId,
+            cwd: parsed.cwd,
+            model: parsed.model,
+            serviceTier: parsed.serviceTier,
+            effort: parsed.effort,
+            sandbox: parsed.sandbox,
+            approvalPolicy: parsed.approvalPolicy,
+            permissions: parsed.permissions,
+        });
+        const result = hasSshRemote(parsed)
+            ? await callToybox("localHandoff.enqueue", compactUndefined({
+                ...params,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : {
+                intent: await enqueueLocalHandoffIntent(await createWorkspaceContext({
+                    workspaceRoot: parsed.workspaceRoot,
+                    mode: parsed.mode,
+                }), params),
+            };
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-handoff-list") {
+        if (hasSshRemote(parsed)) {
+            const result = await callToybox("localHandoff.list", compactUndefined({
+                status: parsed.status,
+                queue: parsed.queue,
+                targetHost: parsed.targetHost,
+                capabilities: parsed.capabilities.length > 0 ? parsed.capabilities : undefined,
+                limit: parsed.limit,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed);
+            write(parsed.json
+                ? `${JSON.stringify(result, null, parsed.pretty ? 2 : 0)}\n`
+                : formatLocalHandoffList((record(result).intents ?? [])));
+            return;
+        }
+        const context = await createWorkspaceContext({
+            workspaceRoot: parsed.workspaceRoot,
+            mode: parsed.mode,
+        });
+        const intents = await listLocalHandoffIntents(context, {
+            status: parsed.status,
+            queue: parsed.queue,
+            targetHost: parsed.targetHost,
+            capabilities: parsed.capabilities.length > 0 ? parsed.capabilities : undefined,
+            limit: parsed.limit,
+        });
+        write(parsed.json
+            ? `${JSON.stringify({ intents }, null, parsed.pretty ? 2 : 0)}\n`
+            : formatLocalHandoffList(intents));
+        return;
+    }
+    if (parsed.type === "workspace-handoff-read") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("localHandoff.read", compactUndefined({
+                id: parsed.intentId,
+                includeOutput: parsed.includeOutput,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await readDeferredRun(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), parsed.intentId, { includeOutput: parsed.includeOutput });
+        write(parsed.json
+            ? `${JSON.stringify(result, null, parsed.pretty ? 2 : 0)}\n`
+            : `${JSON.stringify(result, null, 2)}\n`);
+        return;
+    }
+    if (parsed.type === "workspace-handoff-collect") {
+        const options = compactUndefined({
+            cursor: parsed.cursor,
+            queue: parsed.queue,
+            targetHost: parsed.targetHost,
+            capabilities: parsed.capabilities.length > 0 ? parsed.capabilities : undefined,
+        });
+        const result = hasSshRemote(parsed)
+            ? await callToybox("localHandoff.collect", compactUndefined({
+                ...options,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await collectLocalHandoffRuns(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), options);
+        write(parsed.json
+            ? `${JSON.stringify(result, null, parsed.pretty ? 2 : 0)}\n`
+            : `${JSON.stringify(result, null, 2)}\n`);
+        return;
+    }
+    if (parsed.type === "workspace-handoff-cancel") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("localHandoff.cancel", compactUndefined({
+                id: parsed.intentId,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : {
+                intent: await cancelDeferredRunIntent(await createWorkspaceContext({
+                    workspaceRoot: parsed.workspaceRoot,
+                    mode: parsed.mode,
+                }), parsed.intentId),
+            };
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-handoff-retry") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("localHandoff.retry", compactUndefined({
+                id: parsed.intentId,
+                runAt: parsed.runAt,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await retryDeferredRunIntent(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), parsed.intentId, compactUndefined({
+                runAt: parsed.runAt,
+            }));
+        writeJson(result, parsed.pretty);
+        return;
+    }
+    if (parsed.type === "workspace-handoff-drain") {
+        const action = parsed.materialize ? "materialize" : "run";
+        const drainParams = compactUndefined({
+            queue: parsed.queue,
+            hostId: parsed.hostId,
+            capabilities: parsed.capabilities.length > 0 ? parsed.capabilities : undefined,
+            limit: parsed.limit,
+            action,
+            promptQueue: parsed.promptQueue,
+        });
+        const result = hasSshRemote(parsed)
+            ? await callToybox("localHandoff.drain", compactUndefined({
+                ...drainParams,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await withToyboxRequest(parsed, async (request) => await drainLocalHandoffQueue(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), {
+                ...drainParams,
+                callToybox: request,
+                automationCwd: parsed.cwd,
+            }));
+        writeJson(result, parsed.pretty);
+        return;
+    }
     if (parsed.type === "workspace-deferred-create") {
         const params = await readParams(parsed.paramsText, parsed.paramsFile);
         const result = hasSshRemote(parsed)
@@ -365,6 +699,23 @@ async function main() {
         writeJson(result, parsed.pretty);
         return;
     }
+    if (parsed.type === "workspace-deferred-retry") {
+        const result = hasSshRemote(parsed)
+            ? await callToybox("deferred.retry", compactUndefined({
+                id: parsed.intentId,
+                runAt: parsed.runAt,
+                mode: parsed.mode,
+                workspaceRoot: parsed.workspaceRoot,
+            }), parsed)
+            : await retryDeferredRunIntent(await createWorkspaceContext({
+                workspaceRoot: parsed.workspaceRoot,
+                mode: parsed.mode,
+            }), parsed.intentId, compactUndefined({
+                runAt: parsed.runAt,
+            }));
+        writeJson(result, parsed.pretty);
+        return;
+    }
     if (parsed.type === "workspace-deferred-run-due") {
         const result = hasSshRemote(parsed)
             ? await callToybox("deferred.runDue", compactUndefined({
@@ -510,6 +861,26 @@ function toyboxLabelForDoctor(toybox) {
     }
     return toybox.error ? `unavailable (${toybox.error})` : "unavailable";
 }
+function formatWorkspaceOverview(overview) {
+    const lines = [
+        `workspace          ${overview.workspace.repoRoot}`,
+        `mode               ${overview.workspace.mode}`,
+        `config             ${overview.workspace.config.exists ? "found" : "missing"} ${overview.workspace.config.path}`,
+        `health             ${overview.health.ok ? "ok" : "attention"}`,
+        `deferred           ${overview.deferred.summary.total} total, ${overview.deferred.summary.due} due, ${overview.deferred.summary.running} running, ${overview.deferred.summary.failed} failed`,
+        `automations        ${overview.automations.ok ? overview.automations.total : `error: ${overview.automations.error}`}`,
+        `functions          ${overview.functions.ok ? overview.functions.total : `error: ${overview.functions.error}`}`,
+        `threads            ${overview.threads.ok ? `${overview.threads.total} recent for cwd` : `error: ${overview.threads.error}`}`,
+        `git                ${overview.git.ok && overview.git.isRepo ? `${overview.git.branch ?? "unknown"} ${overview.git.commit ?? ""}${overview.git.dirty ? " dirty" : ""}` : overview.git.error ?? "not a git repo"}`,
+    ];
+    if (overview.deferred.latest) {
+        lines.push(`latest deferred    ${overview.deferred.latest.status} ${overview.deferred.latest.id} ${overview.deferred.latest.updatedAt}`);
+    }
+    for (const check of overview.health.checks.filter((item) => !item.ok)) {
+        lines.push(`check              ${check.name} ${check.status}${check.error ? `: ${check.error}` : ""}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
 async function callAppServer(method, params, options) {
     return await callToybox(APP_CALL_METHOD, { method, params }, options);
 }
@@ -919,6 +1290,47 @@ function deferredTargetLabel(target) {
     }
     return "turn";
 }
+function formatPromptQueueList(intents) {
+    if (intents.length === 0) {
+        return "No queued prompts found.\n";
+    }
+    return intents.map((intent) => [
+        intent.id,
+        intent.status,
+        intent.runAt,
+        promptQueueLabel(intent),
+    ].join("  ")).join("\n") + "\n";
+}
+function promptQueueLabel(intent) {
+    const source = record(intent.source);
+    const queue = stringValue(source.queue) ?? "default";
+    const title = stringValue(source.title);
+    if (title) {
+        return `${queue}:${title}`;
+    }
+    return queue;
+}
+function formatLocalHandoffList(intents) {
+    if (intents.length === 0) {
+        return "No local handoffs found.\n";
+    }
+    return intents.map((intent) => [
+        intent.id,
+        intent.status,
+        intent.runAt,
+        localHandoffLabel(intent),
+    ].join("  ")).join("\n") + "\n";
+}
+function localHandoffLabel(intent) {
+    const source = record(intent.source);
+    const queue = stringValue(source.queue) ?? "local";
+    const targetHost = stringValue(source.targetHost) ?? "local-controller";
+    const title = stringValue(source.title);
+    if (title) {
+        return `${queue}:${targetHost}:${title}`;
+    }
+    return `${queue}:${targetHost}`;
+}
 function record(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value)
         ? value
@@ -979,6 +1391,8 @@ Usage:
   codex-toys mcp serve
 
   codex-toys --ssh <target> --cwd <remote-workspace> remote preflight [--json]
+  codex-toys host overview --json
+  codex-toys --ssh <target> --cwd <remote-workspace> remote host-overview --json
 
   codex-toys turn run <prompt> [--wait] [--thread-id <id>]
   codex-toys --ssh <target> --cwd <remote-workspace> turn run <prompt> --wait
@@ -1006,17 +1420,27 @@ Usage:
   codex-toys workspace call <method> [params-json]
   codex-toys workspace app <method> [params-json]
   codex-toys workspace methods
+  codex-toys workspace overview [--json]
   codex-toys workspace delegate list [--json]
   codex-toys workspace delegate start --cwd @/workspaces/name --prompt <text> [--wait]
-  codex-toys workspace doctor [--mode auto|local|actions] [--json]
-  codex-toys workspace tick [--mode auto|local|actions]
-  codex-toys workspace run <task-id> [--mode auto|local|actions]
-  codex-toys workspace deferred create --params-json <json>
+	  codex-toys workspace doctor [--mode auto|local|actions] [--json]
+	  codex-toys workspace tick [--mode auto|local|actions]
+	  codex-toys workspace run <task-id> [--mode auto|local|actions]
+	  codex-toys workspace prompt enqueue <prompt> [--run-at <iso>] [--after <intent-id>]
+	  codex-toys workspace prompt list [--queue <name>] [--status <status>] [--json]
+	  codex-toys workspace prompt pull <intent-id> [--json]
+	  codex-toys workspace prompt collect [--cursor <name>] [--queue <name>] [--json]
+	  codex-toys workspace prompt run-due [--queue <name>] [--limit <n>]
+	  codex-toys workspace handoff enqueue <prompt> [--target-host <host>] [--capability <name>]
+	  codex-toys workspace handoff list [--queue <name>] [--status <status>] [--json]
+	  codex-toys workspace handoff drain [--host-id <host>] [--capability <name>] [--materialize]
+	  codex-toys workspace deferred create --params-json <json>
   codex-toys workspace deferred list [--mode auto|local|actions] [--json]
   codex-toys workspace deferred read <intent-id> [--include-output] [--json]
   codex-toys workspace deferred pull <intent-id> [--json]
   codex-toys workspace deferred collect [--cursor <name>] [--json]
   codex-toys workspace deferred cancel <intent-id>
+  codex-toys workspace deferred retry <intent-id> [--run-at <iso>]
   codex-toys workspace deferred run-due [--mode auto|local|actions]
   codex-toys workspace deferred prune --older-than-days <days> [--dry-run]
   codex-toys workspace init actions [--forgejo|--github]
@@ -1067,9 +1491,20 @@ Options:
                                              or workspace tasks.
   --forgejo                                  Generate a Forgejo Actions workflow.
   --github                                   Generate a GitHub Actions workflow.
-  --prompt <text>                            Prompt text for automation script context.
-  --title <text>                             Delegation thread title.
-  --group-id <id>                            Delegation group id.
+	  --prompt <text>                            Prompt text for automation script context.
+	  --title <text>                             Delegation thread title or queued prompt title.
+	  --queue <name>                             Prompt queue name.
+	  --label <label>                            Prompt queue label. Repeatable.
+	  --after <intent-id>                        Hold queued prompt until another intent finishes.
+	  --after-status <status>                    Dependency status: completed, failed,
+	                                             canceled, or terminal.
+	  --status <status>                          Deferred/prompt status filter.
+	  --limit <n>                                Limit listed or due queued work.
+	  --run-at <iso>                             Future run time for deferred or queued work.
+	  --service-tier <tier>                      Turn service tier for queued prompts.
+	  --effort <effort>                          Reasoning effort: none, minimal, low,
+	                                             medium, high, or xhigh.
+	  --group-id <id>                            Delegation group id.
   --return-mode <mode>                       Delegation return mode: detached,
                                              record_only, wake_on_done,
                                              wake_on_group, or manual.
@@ -1108,6 +1543,8 @@ Examples:
   codex-toys mcp serve
   codex-toys toybox serve --cwd /repo
   codex-toys --ssh devbox --cwd /repo fetch
+  codex-toys host overview --json
+  codex-toys --ssh devbox --cwd /repo remote host-overview --json
   codex-toys --ssh devbox --cwd /repo turn run "Scan current folder" --wait
   codex-toys automation list
   codex-toys automation run check-release --event event.json
@@ -1120,6 +1557,7 @@ Examples:
   codex-toys app thread/list '{"limit":20,"sourceKinds":[]}'
   codex-toys workspace app thread/list '{"limit":20,"sourceKinds":[]}'
   codex-toys workspace delegation.list
+  codex-toys workspace overview --json
   codex-toys workspace delegate start --cwd @/workspaces/trading --prompt "Inspect status"
   codex-toys workspace doctor --mode actions
   codex-toys workspace deferred create --params-json '{"runAt":"2026-01-01T14:00:00.000Z","target":{"kind":"turn","prompt":"Review the workspace."}}'