The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
import { describe, expect, it } from "vitest";
import { buildCodexExecArgs } from "./codex-args.js";
import { resolveCodexLocalCliPolicy } from "../index.js";
describe("buildCodexExecArgs", () => {
it.each([
{ config: { extraArgs: ["--sandbox", "read-only"] }, bypass: false, args: ["exec", "--json", "--sandbox", "read-only", "-"] },
{ config: { args: ["-c", "approval_policy=on-request"] }, bypass: false, args: ["exec", "--json", "-c", 'sandbox_mode="workspace-write"', "-c", "sandbox_workspace_write.network_access=true", "-c", "approval_policy=on-request", "-"] },
{ config: { extraArgs: [], args: ["--profile", "restricted"] }, bypass: false, args: ["exec", "--json", "--profile", "restricted", "-"] },
{ config: { extraArgs: [0, null], args: ["--sandbox", "read-only"] }, bypass: false, args: ["exec", "--json", "--sandbox", "read-only", "-"] },
{ config: { extraArgs: ["--color", "never"], args: ["--sandbox", "read-only"] }, bypass: true, args: ["exec", "--json", "--dangerously-bypass-approvals-and-sandbox", "--color", "never", "-"] },
{ config: { dangerouslyBypassApprovalsAndSandbox: true, extraArgs: ["--sandbox", "read-only"] }, bypass: true, args: ["exec", "--json", "--dangerously-bypass-approvals-and-sandbox", "--sandbox", "read-only", "-"] },
{ config: { dangerouslyBypassSandbox: true, args: ["--sandbox", "read-only"] }, bypass: true, args: ["exec", "--json", "--dangerously-bypass-approvals-and-sandbox", "--sandbox", "read-only", "-"] },
{ config: { dangerouslyBypassApprovalsAndSandbox: false, dangerouslyBypassSandbox: true, extraArgs: ["--color", "never"] }, bypass: false, args: ["exec", "--json", "-c", 'sandbox_mode="workspace-write"', "-c", "sandbox_workspace_write.network_access=true", "--color", "never", "-"] },
])("keeps the browser policy and exact execution arguments consistent for $config", ({ config, bypass, args }) => {
expect(resolveCodexLocalCliPolicy(config).bypass).toBe(bypass);
expect(buildCodexExecArgs(config).args).toEqual(args);
});
it.each([null, "existing-session"])("defaults direct and resumed launches to full bypass (%s)", (resumeSessionId) => {
const { args } = buildCodexExecArgs({}, { resumeSessionId });
expect(args).toContain("--dangerously-bypass-approvals-and-sandbox");
expect(args).not.toContain('sandbox_mode="workspace-write"');
if (resumeSessionId) expect(args.slice(-3)).toEqual(["resume", resumeSessionId, "-"]);
});
it.each([["gpt-6-astra", "ultra"], ["gpt-6.1-sol", "ultra"], ["gpt-6-sol", "ultra"], ["gpt-6-luna", "max"], ["gpt-5.6-sol", "ultra"], ["gpt-5.6-terra", "ultra"], ["gpt-5.6-luna", "max"]])("forwards %s, its supported reasoning effort, and fast mode", (model, effort) => {
const result = buildCodexExecArgs({
model,
modelReasoningEffort: effort,
fastMode: true,
});
expect(result.model).toBe(model);
expect(result.fastModeApplied).toBe(true);
expect(result.fastModeIgnoredReason).toBeNull();
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
model,
"-c",
`model_reasoning_effort="${effort}"`,
"-c",
'service_tier="fast"',
"-c",
"features.fast_mode=true",
"-",
]);
});
it("rewrites the legacy bare gpt-5.6 alias to gpt-5.6-sol and applies fast mode", () => {
const result = buildCodexExecArgs({
model: "gpt-5.6",
fastMode: true,
});
expect(result.model).toBe("gpt-5.6-sol");
expect(result.args).toContain("gpt-5.6-sol");
expect(result.args).not.toContain("gpt-5.6");
expect(result.fastModeApplied).toBe(true);
expect(result.fastModeIgnoredReason).toBeNull();
});
it("enables Codex fast mode overrides for GPT-5.4", () => {
const result = buildCodexExecArgs({
model: "gpt-5.4",
search: true,
fastMode: true,
});
expect(result.fastModeRequested).toBe(true);
expect(result.fastModeApplied).toBe(true);
expect(result.fastModeIgnoredReason).toBeNull();
expect(result.args).toEqual([
"--search",
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"gpt-5.4",
"-c",
'service_tier="fast"',
"-c",
"features.fast_mode=true",
"-",
]);
});
it("enables Codex fast mode overrides for GPT-5.5", () => {
const result = buildCodexExecArgs({
model: "gpt-5.5",
fastMode: true,
});
expect(result.fastModeRequested).toBe(true);
expect(result.fastModeApplied).toBe(true);
expect(result.fastModeIgnoredReason).toBeNull();
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"gpt-5.5",
"-c",
'service_tier="fast"',
"-c",
"features.fast_mode=true",
"-",
]);
});
it("enables Codex fast mode overrides for manual models", () => {
const result = buildCodexExecArgs({
model: "future-codex-model",
fastMode: true,
});
expect(result.fastModeRequested).toBe(true);
expect(result.fastModeApplied).toBe(true);
expect(result.fastModeIgnoredReason).toBeNull();
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"future-codex-model",
"-c",
'service_tier="fast"',
"-c",
"features.fast_mode=true",
"-",
]);
});
it("enables Codex fast mode overrides when model is omitted (CLI default)", () => {
const result = buildCodexExecArgs({
fastMode: true,
});
expect(result.fastModeRequested).toBe(true);
expect(result.fastModeApplied).toBe(true);
expect(result.fastModeIgnoredReason).toBeNull();
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"-c",
'service_tier="fast"',
"-c",
"features.fast_mode=true",
"-",
]);
});
it("ignores fast mode for known unsupported models", () => {
const result = buildCodexExecArgs({
model: "gpt-5",
fastMode: true,
});
expect(result.fastModeRequested).toBe(true);
expect(result.fastModeApplied).toBe(false);
expect(result.fastModeIgnoredReason).toContain(
"currently only supported on gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4 or manually configured model IDs",
);
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"gpt-5",
"-",
]);
});
it("ignores fast mode for gpt-5.4-mini", () => {
const result = buildCodexExecArgs({
model: "gpt-5.4-mini",
fastMode: true,
});
expect(result.fastModeRequested).toBe(true);
expect(result.fastModeApplied).toBe(false);
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"gpt-5.4-mini",
"-",
]);
});
it("adds --skip-git-repo-check when requested", () => {
const result = buildCodexExecArgs(
{
model: "gpt-5.5",
},
{ skipGitRepoCheck: true },
);
expect(result.args).toEqual([
"exec",
"--json",
"--skip-git-repo-check",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"gpt-5.5",
"-",
]);
});
it("does not add a second --skip-git-repo-check when extraArgs already carry it", () => {
const result = buildCodexExecArgs(
{
model: "gpt-5.5",
extraArgs: ["--skip-git-repo-check"],
},
{ skipGitRepoCheck: true },
);
expect(result.args.filter((arg) => arg === "--skip-git-repo-check")).toHaveLength(1);
expect(result.args).toEqual([
"exec",
"--json",
"--dangerously-bypass-approvals-and-sandbox",
"--model",
"gpt-5.5",
"--skip-git-repo-check",
"-",
]);
});
it("does not add a second --skip-git-repo-check when the legacy args field carries it", () => {
const result = buildCodexExecArgs(
{
model: "gpt-5.5",
args: ["--skip-git-repo-check"],
},
{ skipGitRepoCheck: true },
);
expect(result.args.filter((arg) => arg === "--skip-git-repo-check")).toHaveLength(1);
});
it("keeps the operator's --skip-git-repo-check when the sandbox injection is not requested", () => {
const result = buildCodexExecArgs({
model: "gpt-5.5",
extraArgs: ["--skip-git-repo-check"],
});
expect(result.args.filter((arg) => arg === "--skip-git-repo-check")).toHaveLength(1);
});
it.each([null, "existing-session"])("makes legacy settings operable for session %s", (resumeSessionId) => {
const { args } = buildCodexExecArgs({
dangerouslyBypassApprovalsAndSandbox: false,
extraArgs: ["-c", "sandbox_workspace_write.network_access=true"],
}, { resumeSessionId });
expect(args).toContain('sandbox_mode="workspace-write"');
expect(args).toContain("sandbox_workspace_write.network_access=true");
expect(args).not.toContain("--dangerously-bypass-approvals-and-sandbox");
if (resumeSessionId) expect(args.slice(-3)).toEqual(["resume", resumeSessionId, "-"]);
});
it.each([
["--sandbox", "read-only"], ["--sandbox=read-only"], ["-s", "read-only"],
["-sread-only"], ["-prestricted"], ["-c=sandbox_mode=read-only"],
["-c", 'sandbox_mode="read-only"'], ["--config=sandbox_mode=read-only"],
["--profile", "restricted"], ["-p", "restricted"], ["--full-auto"],
["--dangerously-bypass-approvals-and-sandbox"],
])("preserves explicit sandbox/profile arguments %j", (...extraArgs) => {
const { args } = buildCodexExecArgs({ extraArgs });
expect(args).not.toContain('sandbox_mode="workspace-write"');
expect(args).not.toContain("sandbox_workspace_write.network_access=true");
expect(args).toEqual(["exec", "--json", ...extraArgs, "-"]);
});
it("preserves an explicit network denial after defaults", () => {
const { args } = buildCodexExecArgs({ extraArgs: ["-c", "sandbox_workspace_write.network_access=false"] });
expect(args.lastIndexOf("sandbox_workspace_write.network_access=false"))
.toBeGreaterThan(args.indexOf("sandbox_workspace_write.network_access=true"));
});
it("honors a disabled execution-target network policy even with an agent override", () => {
const { args } = buildCodexExecArgs({ extraArgs: ["-c", "sandbox_workspace_write.network_access=true"] }, { networkAccess: false });
expect(args.slice(-3)).toEqual(["-c", "sandbox_workspace_write.network_access=false", "-"]);
});
it("preserves the existing explicit bypass configuration", () => {
const { args } = buildCodexExecArgs({ dangerouslyBypassApprovalsAndSandbox: true });
expect(args).toEqual(["exec", "--json", "--dangerously-bypass-approvals-and-sandbox", "-"]);
});
});