UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

169 lines (156 loc) • 7.17 kB
import { ADVISOR_CONTEXT_SHARING_CONSENT_VERSION, ADVISOR_CONTEXT_SHARING_DISCLOSURE } from "../advisor/disclosure"; import { CliUsageError, printData, rejectArgs, runCliAction, runtimeRequest, takeFlag, type RuntimeApiDeps } from "./runtime-api"; const USAGE = `Usage: ocx advisor status [--json] ocx advisor activity [--json] ocx advisor on [--ack-context-sharing] [--json] ocx advisor off [--json] ocx advisor consent [--revoke] [--json] ocx advisor set [--model <model>] [--effort <effort>] [--policy <manual|preflight|adaptive>] [--context-mode <context|question-only>] [--max-consultations <1-3>] [--timeout-ms <ms>] [--json]`; const VALUED_FLAGS = new Set(["--model", "--effort", "--policy", "--context-mode", "--timeout-ms", "--max-consultations"]); interface SetOptions { model?: string; effort?: string; policy?: string; contextMode?: string; timeoutMs?: string; maxConsultations?: string; } function parseSetArgs(args: string[]): SetOptions { const options: SetOptions = {}; for (let index = 0; index < args.length; index += 1) { const arg = args[index]!; if (!VALUED_FLAGS.has(arg)) throw new CliUsageError(`unknown advisor set option ${arg}`, USAGE); const value = args[++index]; if (value === undefined || value.startsWith("--")) throw new CliUsageError(`${arg} requires a value`, USAGE); // An explicitly supplied empty value is meaningful for --model alone: the settings route // treats "" as the supported "clear the model" state. Every other valued flag still needs one. if (value === "" && arg !== "--model") throw new CliUsageError(`${arg} requires a value`, USAGE); if (arg === "--model") options.model = value; else if (arg === "--effort") options.effort = value; else if (arg === "--policy") options.policy = value; else if (arg === "--context-mode") options.contextMode = value; else if (arg === "--max-consultations") options.maxConsultations = value; else options.timeoutMs = value; } if (Object.keys(options).length === 0) { throw new CliUsageError("advisor set requires a model, effort, policy, context mode, task limit, or timeout option", USAGE); } return options; } async function status(argv: string[], deps: RuntimeApiDeps): Promise<void> { const args = [...argv]; const wantsJson = takeFlag(args, "--json"); rejectArgs(args, USAGE); printData(await runtimeRequest("/api/advisor/settings", {}, deps), wantsJson); } function printDisclosure(): void { console.error(ADVISOR_CONTEXT_SHARING_DISCLOSURE); } async function readConsent(deps: RuntimeApiDeps): Promise<unknown> { const current = await runtimeRequest("/api/advisor/settings", {}, deps) as { settings?: { contextSharingConsent?: unknown }; }; return current.settings?.contextSharingConsent; } async function setEnabled(enabled: boolean, argv: string[], deps: RuntimeApiDeps): Promise<void> { const args = [...argv]; const wantsJson = takeFlag(args, "--json"); const acknowledge = takeFlag(args, "--ack-context-sharing"); rejectArgs(args, USAGE); if (!enabled) { if (acknowledge) { throw new CliUsageError( "--ack-context-sharing has no effect with `ocx advisor off`; it never records consent.", USAGE, ); } printData(await runtimeRequest("/api/advisor/settings", { method: "PUT", body: JSON.stringify({ enabled: false }), }, deps), wantsJson, ["Advisor disabled."]); return; } const consent = await readConsent(deps); if (acknowledge) { printDisclosure(); printData(await runtimeRequest("/api/advisor/settings", { method: "PUT", body: JSON.stringify({ enabled: true, contextSharingConsent: ADVISOR_CONTEXT_SHARING_CONSENT_VERSION, }), }, deps), wantsJson, ["Advisor enabled with context-sharing consent v1."]); return; } if (consent !== ADVISOR_CONTEXT_SHARING_CONSENT_VERSION) { printDisclosure(); throw new CliUsageError( "Advisor context-sharing consent is required before consultations can send task content. " + "Re-run `ocx advisor on --ack-context-sharing` after reading the disclosure, or run `ocx advisor consent`.", USAGE, ); } printData(await runtimeRequest("/api/advisor/settings", { method: "PUT", body: JSON.stringify({ enabled: true }), }, deps), wantsJson, ["Advisor enabled."]); } async function consent(argv: string[], deps: RuntimeApiDeps): Promise<void> { const args = [...argv]; const wantsJson = takeFlag(args, "--json"); const revoke = takeFlag(args, "--revoke"); rejectArgs(args, USAGE); if (!revoke) printDisclosure(); printData(await runtimeRequest("/api/advisor/settings", { method: "PUT", body: JSON.stringify({ contextSharingConsent: revoke ? null : ADVISOR_CONTEXT_SHARING_CONSENT_VERSION, }), }, deps), wantsJson, [revoke ? "Advisor context-sharing consent removed. Consultations not yet dispatched will not send task content; a dispatched consultation cannot be cancelled and task content already sent cannot be retracted." : "Advisor context-sharing consent v1 recorded.", ]); } async function set(argv: string[], deps: RuntimeApiDeps): Promise<void> { const args = [...argv]; const wantsJson = takeFlag(args, "--json"); const options = parseSetArgs(args); const patch: Record<string, unknown> = {}; if (options.model !== undefined) patch.model = options.model; if (options.effort !== undefined) patch.effort = options.effort; if (options.policy !== undefined) patch.policy = options.policy; if (options.contextMode !== undefined) patch.contextMode = options.contextMode; if (options.maxConsultations !== undefined) { const limit = Number(options.maxConsultations); if (!Number.isInteger(limit) || limit < 1 || limit > 3) throw new CliUsageError("--max-consultations must be an integer between 1 and 3", USAGE); patch.maxConsultationsPerTask = limit; } if (options.timeoutMs !== undefined) { const parsed = Number(options.timeoutMs); if (!Number.isFinite(parsed)) throw new CliUsageError("--timeout-ms must be a number", USAGE); patch.timeoutMs = parsed; } printData(await runtimeRequest("/api/advisor/settings", { method: "PUT", body: JSON.stringify(patch), }, deps), wantsJson, ["Advisor settings saved."]); } export async function handleAdvisorCommand(argv: string[], deps: RuntimeApiDeps = {}): Promise<number> { return runCliAction(async () => { const [sub = "status", ...rest] = argv; if (sub === "status") await status(rest, deps); else if (sub === "activity") { const args = [...rest]; const wantsJson = takeFlag(args, "--json"); rejectArgs(args, USAGE); printData(await runtimeRequest("/api/advisor/activity", {}, deps), wantsJson); } else if (sub === "on") await setEnabled(true, rest, deps); else if (sub === "off") await setEnabled(false, rest, deps); else if (sub === "consent") await consent(rest, deps); else if (sub === "set") await set(rest, deps); else throw new CliUsageError(`unknown advisor command ${sub}`, USAGE); }); } export const ADVISOR_USAGE = USAGE;