@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
text/typescript
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;