mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-01 11:23:33 +00:00
72 lines
2.6 KiB
TypeScript
72 lines
2.6 KiB
TypeScript
/**
|
|
* Registers the `/codex` plugin command and lazy-loads the app-server command
|
|
* handler implementation.
|
|
*/
|
|
import type {
|
|
OpenClawPluginCommandDefinition,
|
|
PluginCommandContext,
|
|
PluginCommandResult,
|
|
} from "openclaw/plugin-sdk/plugin-entry";
|
|
import { describeControlFailure } from "./app-server/capabilities.js";
|
|
import { formatCodexDisplayText } from "./command-formatters.js";
|
|
import type { CodexCommandDeps } from "./command-handlers.js";
|
|
|
|
type CodexCommandOptions = {
|
|
pluginConfig?: unknown;
|
|
deps?: Partial<CodexCommandDeps>;
|
|
};
|
|
|
|
type CodexSubcommandHandler = (
|
|
ctx: PluginCommandContext,
|
|
options: CodexCommandOptions,
|
|
) => Promise<PluginCommandResult>;
|
|
|
|
type CodexCommandInternalOptions = CodexCommandOptions & {
|
|
loadSubcommandHandler?: () => Promise<CodexSubcommandHandler>;
|
|
};
|
|
|
|
/** Creates the reserved `/codex` command definition exposed by the plugin. */
|
|
export function createCodexCommand(options: CodexCommandOptions): OpenClawPluginCommandDefinition {
|
|
return {
|
|
name: "codex",
|
|
description: "Inspect and control the Codex app-server harness",
|
|
ownership: "reserved",
|
|
agentPromptGuidance: [
|
|
{
|
|
text: "Native Codex app-server plugin is available (`/codex ...`). For Codex bind/control/thread/resume/steer/stop requests, prefer `/codex bind`, `/codex threads`, `/codex resume`, `/codex steer`, and `/codex stop` over ACP. When OpenClaw sandboxing is active, native Codex execution modes are unavailable; use normal Codex harness turns.",
|
|
surfaces: ["openclaw_main"],
|
|
},
|
|
{
|
|
text: "Use ACP for Codex only when the user explicitly asks for ACP/acpx or wants to test the ACP path.",
|
|
surfaces: ["openclaw_main"],
|
|
},
|
|
],
|
|
acceptsArgs: true,
|
|
requireAuth: true,
|
|
handler: (ctx) => handleCodexCommand(ctx, options),
|
|
};
|
|
}
|
|
|
|
/** Dispatches a `/codex` command to the subcommand handler and formats failures for chat. */
|
|
export async function handleCodexCommand(
|
|
ctx: PluginCommandContext,
|
|
options: CodexCommandInternalOptions = {},
|
|
): Promise<PluginCommandResult> {
|
|
const { loadSubcommandHandler, ...subcommandOptions } = options;
|
|
try {
|
|
const handleCodexSubcommand = loadSubcommandHandler
|
|
? await loadSubcommandHandler()
|
|
: await loadDefaultCodexSubcommandHandler();
|
|
return await handleCodexSubcommand(ctx, subcommandOptions);
|
|
} catch (error) {
|
|
return {
|
|
text: `Codex command failed: ${formatCodexDisplayText(describeControlFailure(error))}`,
|
|
};
|
|
}
|
|
}
|
|
|
|
async function loadDefaultCodexSubcommandHandler(): Promise<CodexSubcommandHandler> {
|
|
const { handleCodexSubcommand } = await import("./command-handlers.js");
|
|
return handleCodexSubcommand;
|
|
}
|