openclaw/dist/register.agent-turn-DS3dYZlx.js

Multi-channel AI gateway with extensible messaging integrations

import { o as normalizeLowercaseStringOrEmpty } from "./string-coerce-CIXf7egm.js";
import { n as THINKING_LEVELS_HELP } from "./thinking.shared-bHYuuc1L.js";
import { t as formatDocsLink } from "./links-ClIwBcy4.js";
import { r as theme } from "./theme-vjDs9tao.js";
import { n as inheritOptionFromParent } from "./command-options-BDuSHeWG.js";
import { t as measureCliCommandStartup } from "./command-startup-timing-BgLkSqND.js";
import { t as formatHelpExamples } from "./help-format-CAcwboTs.js";
//#region src/cli/program/register.agent-turn.ts
function collectFallback(value, previous) {
	return [...previous, value];
}
/** Register `openclaw agent` for one Gateway-backed agent turn. */
function registerAgentTurnCommand(program, args) {
	program.command("agent").description("Run an agent turn via the Gateway (use --local for embedded)").option("-m, --message <text>", "Message body for the agent").option("--message-file <path>", "Read the agent message body from a UTF-8 file (max 4 MiB)").option("-t, --to <number>", "Recipient number in E.164 used to derive the session key").option("--session-key <key>", "Explicit session key (agent:<id>:<key>, or scoped to --agent)").option("--session-id <id>", "Use an explicit session id").option("--agent <id>", "Agent id (overrides routing bindings)").option("--model <id>", "Model override for this run (provider/model or model id)").option("--thinking <level>", `Thinking level: ${THINKING_LEVELS_HELP.replaceAll("|", " | ")} where supported`).option("--verbose <on|off>", "Persist agent verbose level for the session").option("--channel <channel>", `Delivery channel: ${args.agentChannelOptions} (omit to use the main session channel)`).option("--reply-to <target>", "Delivery target override (separate from session routing)").option("--reply-channel <channel>", "Delivery channel override (separate from routing)").option("--reply-account <id>", "Delivery account id override").option("--local", "Run the embedded agent locally using configured provider credentials or local CLI logins", false).option("--deliver", "Send the agent's reply back to the selected channel", false).option("--json", "Output result as JSON", false).option("--timeout <seconds>", "Override agent command timeout (seconds, default 600 or config value)").addHelpText("after", () => `
${theme.heading("Examples:")}
${formatHelpExamples([
		["openclaw agent --to +15555550123 --message \"status update\"", "Start a new session."],
		["openclaw agent --agent ops --message \"Summarize logs\"", "Use a specific agent."],
		["openclaw agent --agent ops --message-file ./task.md", "Read a multiline message file."],
		["openclaw agent --session-key agent:ops:incident-42 --message \"Summarize status\"", "Target an exact session key."],
		["openclaw agent --session-id 1234 --message \"Summarize inbox\" --thinking medium", "Target a session with explicit thinking level."],
		["openclaw agent --to +15555550123 --message \"Trace logs\" --verbose on --json", "Enable verbose logging and JSON output."],
		["openclaw agent --to +15555550123 --message \"Summon reply\" --deliver", "Deliver reply."],
		["openclaw agent --agent ops --message \"Generate report\" --deliver --reply-channel slack --reply-to \"#reports\"", "Send reply to a different channel/target."]
	])}

${theme.muted("Docs:")} ${formatDocsLink("/cli/agent", "docs.openclaw.ai/cli/agent")}`).action(async (opts) => {
		const verboseLevel = typeof opts.verbose === "string" ? normalizeLowercaseStringOrEmpty(opts.verbose) : "";
		const [{ defaultRuntime }, { runCommandWithRuntime }, { setVerbose }, { agentCliCommand }, { requestExitAfterOneShotOutput }] = await measureCliCommandStartup("agent-action-imports", () => Promise.all([
			import("./runtime-DixL8FcQ.js"),
			import("./cli-utils-Cw4KfHBn.js"),
			import("./global-state-Cv4PpGw4.js"),
			import("./agent-via-gateway-DrJADcA8.js"),
			import("./one-shot-exit-B_krMBPI.js")
		]));
		await runCommandWithRuntime(defaultRuntime, async () => {
			setVerbose(verboseLevel === "on");
			await agentCliCommand(opts, defaultRuntime);
			requestExitAfterOneShotOutput(defaultRuntime);
		});
	}).command("exec [message]").description("Run one isolated headless embedded agent turn").option("--message-file <path>", "Read the UTF-8 prompt from a file; use - for stdin").option("--cwd <dir>", "Set both the agent workspace and tool working directory").option("--state-dir <dir>", "Use an existing state directory without deleting it").option("--config <path>", "Run against this config file instead of the ambient config (pins a reproducible run)").option("--isolated", "Ignore the ambient config and run against exec defaults only", false).option("--model <provider/model>", "Use an explicit primary model for this run").option("--code-mode <mode>", "Tool mode: direct | auto | code").option("--local-model-lean", "Use the reduced local-model tool surface").option("--thinking <level>", `Thinking level: ${THINKING_LEVELS_HELP.replaceAll("|", " | ")} where supported`).option("--fallback <provider/model>", "Add an ordered fallback model (repeatable; requires --model)", collectFallback, []).option("--auth-env-only", "Use provider credentials from environment variables only", false).option("--no-auth-env-only", "Allow stored and external CLI credential discovery").option("--timeout <seconds>", "Agent deadline in seconds", "600").option("--json", "Emit the stable agent-exec JSON envelope", false).addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
		["openclaw agent exec \"Fix the failing test\"", "Run in the current directory."],
		["openclaw agent exec --message-file task.md --cwd ./repo", "Read a prompt file and set the workspace."],
		["openclaw agent exec \"Summarize this repo\" --model openai/gpt-5.6-sol --fallback anthropic/claude-sonnet-4-6 --json", "Use an explicit fallback chain and JSON output."],
		["openclaw agent exec \"Inspect this repo\" --model ollama/qwen3.5:9b --code-mode code --local-model-lean --json", "Force Code Mode with the lean local-model tool surface."]
	])}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/agent#agent-exec", "docs.openclaw.ai/cli/agent#agent-exec")}`).action(async (message, opts, command) => {
		const parentOpts = command.parent?.opts();
		const execOpts = {
			...opts,
			messageFile: opts.messageFile ?? parentOpts?.messageFile,
			model: opts.model ?? parentOpts?.model,
			thinking: opts.thinking ?? parentOpts?.thinking,
			timeout: inheritOptionFromParent(command, "timeout") ?? opts.timeout,
			json: opts.json === true || parentOpts?.json === true
		};
		const [{ defaultRuntime }, { runCommandWithRuntime }, { agentExecCommand }, { requestExitAfterOneShotOutput }] = await Promise.all([
			import("./runtime-DixL8FcQ.js"),
			import("./cli-utils-Cw4KfHBn.js"),
			import("./agent-exec-BfFiu5Oa.js"),
			import("./one-shot-exit-B_krMBPI.js")
		]);
		await runCommandWithRuntime(defaultRuntime, async () => {
			const result = await agentExecCommand(message, execOpts, defaultRuntime);
			if (result.exitCode !== 0) {
				defaultRuntime.exit(result.exitCode, { resetStream: process.stderr });
				return;
			}
			requestExitAfterOneShotOutput(defaultRuntime, result.exitCode);
		});
	});
}
//#endregion
export { registerAgentTurnCommand };