UNPKG

@bitkyc08/opencodex

Version:

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

98 lines (93 loc) • 7.08 kB
import { SUBAGENT_SURFACE_GUIDE_URL } from "../config/multi-agent-surface"; import { printCatalogResult, runCatalogAction } from "./catalog-command-result"; import { serializeManagementJson } from "./json-input"; import { RuntimeApiError, printData, runtimeBaseUrl, runtimeRequest, type RuntimeApiDeps } from "./runtime-api"; import type { V2ParsedCommand } from "./v2-input"; function record(value: unknown): value is Record<string, unknown> { return value !== null && typeof value === "object" && !Array.isArray(value); } function mode(value: unknown): value is "v1" | "default" | "v2" | "v2-plaintext" { return value === "v1" || value === "default" || value === "v2" || value === "v2-plaintext"; } function nullableString(value: unknown): value is string | null { return value === null || typeof value === "string"; } /** Allowlisted task fields only: neither helper errors nor arbitrary response spreads. */ function stateDto(value: unknown): Record<string, unknown> { if (!record(value) || !mode(value.multiAgentMode)) throw new Error("Invalid v2 state"); const result: Record<string, unknown> = { multiAgentMode: value.multiAgentMode }; for (const key of ["supportsPlaintextV2Mode", "plaintextAgentMessagesEnabled"] as const) { if (value[key] !== undefined && typeof value[key] !== "boolean") throw new Error("Invalid plaintext capability"); if (value[key] !== undefined) result[key] = value[key]; } if (value.multiAgentMode === "v2-plaintext" && (value.supportsPlaintextV2Mode !== true || value.plaintextAgentMessagesEnabled !== true || value.enabled !== false)) throw new Error("Unverified plaintext V2 state"); for (const key of ["enabled", "agentsMaxThreadsConflict", "keepNativeChatGptOnV1", "agentsMaxDepthAppliesWhenV2Disabled"] as const) { if (typeof value[key] !== "boolean") throw new Error("Invalid v2 boolean"); result[key] = value[key]; } if (value.agentsEnabled !== null && typeof value.agentsEnabled !== "boolean") throw new Error("Invalid agents state"); if (value.maxConcurrentThreadsPerSession !== null && !(typeof value.maxConcurrentThreadsPerSession === "number" && Number.isSafeInteger(value.maxConcurrentThreadsPerSession) && value.maxConcurrentThreadsPerSession >= 1)) throw new Error("Invalid thread state"); if (value.agentsMaxDepth !== null && !(typeof value.agentsMaxDepth === "number" && Number.isInteger(value.agentsMaxDepth) && value.agentsMaxDepth >= -2147483648 && value.agentsMaxDepth <= 2147483647)) throw new Error("Invalid depth state"); for (const key of ["subagentDeveloperInstructions", "multiAgentModeHintText"] as const) { if (!nullableString(value[key])) throw new Error("Invalid text state"); result[key] = value[key]; } const recommendation = value.multiAgentModeHintRecommendation; if (!record(recommendation) || typeof recommendation.revision !== "string" || typeof recommendation.text !== "string") throw new Error("Invalid hint recommendation"); const advisory = value.multiAgentSurfaceAdvisory; if (!record(advisory) || typeof advisory.required !== "boolean" || advisory.mode !== value.multiAgentMode || advisory.recommended !== "v1" || typeof advisory.version !== "number" || !Number.isSafeInteger(advisory.version) || advisory.version < 1 || advisory.docsUrl !== SUBAGENT_SURFACE_GUIDE_URL) throw new Error("Invalid surface advisory"); return { ...result, agentsEnabled: value.agentsEnabled, agentsMaxDepth: value.agentsMaxDepth, maxConcurrentThreadsPerSession: value.maxConcurrentThreadsPerSession, multiAgentModeHintRecommendation: { revision: recommendation.revision, text: recommendation.text }, multiAgentSurfaceAdvisory: { required: advisory.required, mode: advisory.mode, recommended: "v1", version: advisory.version, docsUrl: advisory.docsUrl } }; } function bodyFor(parsed: V2ParsedCommand): Record<string, unknown> { switch (parsed.verb) { case "on": case "off": return { enabled: parsed.verb === "on" }; case "mode": return { multiAgentMode: parsed.value, ...(parsed.plaintextAcknowledged ? { plaintextAgentMessagesAcknowledged: true } : {}), ...(parsed.acknowledge ? { multiAgentSurfaceAdvisoryAcknowledged: true } : {}) }; case "keep-native-v1": return { keepNativeChatGptOnV1: parsed.value }; case "threads": return { maxConcurrentThreadsPerSession: parsed.value }; case "mode-hint": return { multiAgentModeHintText: parsed.value }; case "status": return {}; } } export async function handleV2RuntimeCommand(parsed: V2ParsedCommand, deps: RuntimeApiDeps = {}): Promise<number> { return runCatalogAction(async () => { const read = parsed.verb === "status"; const body = read ? undefined : serializeManagementJson(bodyFor(parsed)); const pinned = { ...deps, baseUrl: await runtimeBaseUrl(deps) }; let response: unknown; try { response = await runtimeRequest("/api/v2", { method: read ? "GET" : "PUT", redirect: "error", ...(body ? { body } : {}) }, pinned); } catch (error) { if (error instanceof RuntimeApiError && error.status === 502) { console.error("Error: Native V2 settings may be partially applied. Read ocx v2 status --live before retrying; no rollback is implied."); return 1; } throw error; } const state = stateDto(response); if (parsed.verb === "mode" && parsed.value === "v2-plaintext" && state.multiAgentMode !== "v2-plaintext") throw new Error("Plaintext V2 mode was not confirmed by the selected runtime"); const lines = [`multi_agent_v2: ${state.enabled ? "ON" : "OFF"}`, `multi_agent_mode: ${state.multiAgentMode}`, `keep_native_chatgpt_on_v1: ${state.keepNativeChatGptOnV1 ? "ON" : "OFF"}`, `max_threads: ${state.maxConcurrentThreadsPerSession ?? "unset"}`, `agents.enabled: ${state.agentsEnabled ?? "unset (upstream default)"}`, `agents.max_depth: ${state.agentsMaxDepth ?? "unset"}${state.enabled || state.multiAgentMode === "v2-plaintext" ? " (V1-only — ignored by V2 sessions)" : ""}`, `subagent_developer_instructions: ${JSON.stringify(state.subagentDeveloperInstructions)}`, `multi_agent_mode_hint_text: ${JSON.stringify(state.multiAgentModeHintText)}`]; if (state.agentsMaxThreadsConflict) lines.push("Native thread-limit conflict: inspect the selected target's Codex configuration before starting Codex."); if (state.enabled && state.agentsEnabled === false) lines.push("agents.enabled=false does not disable multi-agent while the global V2 feature is enabled."); if (record(state.multiAgentSurfaceAdvisory) && state.multiAgentSurfaceAdvisory.required) { lines.push(`Surface advisory: v1 is recommended. ${SUBAGENT_SURFACE_GUIDE_URL}`); } if (read) { printData({ target: "live", ...state }, parsed.json, lines); return 0; } if (!record(response) || response.ok !== true) throw new Error("Invalid write receipt"); return printCatalogResult({ ok: true, target: "live", ...state }, response.catalogRefresh, parsed.json, [...lines, "V2 settings saved. Applies to new sessions."]); }); }