codexapi 0.12.10__tar.gz → 0.12.11__tar.gz

{codexapi-0.12.10/src/codexapi.egg-info → codexapi-0.12.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.12.10
+Version: 0.12.11
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -157,7 +157,8 @@ Resume a session and print the thread/session id to stderr:
 codexapi run --thread-id THREAD_ID --print-thread-id "Continue where we left off."
 ```
 
-Use `--no-yolo` to disable `--yolo` (Codex uses `--full-auto`).
+Use `--no-yolo` to keep unattended operation with Codex auto approvals, without
+forcing a sandbox policy.
 Use `--include-thinking` to return all agent messages joined together for `codexapi run` (Codex only).
 
 Lead mode periodically checks in on a long-running agent session with the
@@ -305,7 +306,8 @@ codexapi ralph --cancel --cwd /path/to/project
 ```
 
 Science mode wraps a short task in a science prompt and runs it through the
-Ralph loop. It defaults to `--yolo` and expects progress notes in `SCIENCE.md`.
+Ralph loop. It defaults to dangerous no-sandbox automation and expects progress
+notes in `SCIENCE.md`.
 Each iteration appends the agent output to `LOGBOOK.md` and the runner extracts
 any improved figures of merit for optional notifications. You can also set
 `--max-duration` to stop after the current iteration once a time limit is hit.
@@ -345,7 +347,9 @@ items are filtered out.
 
 - `prompt` (str): prompt to send to the agent backend.
 - `cwd` (str | PathLike | None): working directory for the agent session.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `include_thinking` (bool): when true, return all agent messages joined.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
@@ -360,7 +364,9 @@ the same conversation and returns only the agent's message.
 
 - `__call__(prompt) -> str`: send a prompt to the agent backend and return the message.
 - `thread_id -> str | None`: expose the underlying session id once created.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `welfare` (bool): when true, append welfare stop instructions to each prompt
   and raise `WelfareStop` if the agent outputs `MAKE IT STOP`.
@@ -443,7 +449,9 @@ Runs a task file over a list of items, updating the list file in place.
 - `task_file` (str | PathLike): YAML task file (must include `prompt`).
 - `n` (int | None): limit parallelism to N (default: run all items in parallel).
 - `cwd` (str | PathLike | None): working directory for the agent session.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
 - `fast` (bool): enable Codex fast mode (defaults to normal mode).
@@ -465,7 +473,8 @@ Simple result object returned by `foreach()`.
   `fast=True` / `--fast` also passes `service_tier=fast` and `features.fast_mode=true`.
 - Cursor backend uses `cursor agent --print --output-format json --trust` and parses the JSON result.
 - `include_thinking=True` only affects Codex; Cursor returns a single result string.
-- Passes `--yolo` by default (Codex uses `--full-auto` when disabled).
+- Uses dangerous no-sandbox automation by default. For Codex, `yolo=False`
+  uses auto approvals without forcing a sandbox policy.
 - Raises `RuntimeError` if the backend exits non-zero or returns no agent message.
 
 ## Configuration

{codexapi-0.12.10 → codexapi-0.12.11}/README.md

@@ -142,7 +142,8 @@ Resume a session and print the thread/session id to stderr:
 codexapi run --thread-id THREAD_ID --print-thread-id "Continue where we left off."
 ```
 
-Use `--no-yolo` to disable `--yolo` (Codex uses `--full-auto`).
+Use `--no-yolo` to keep unattended operation with Codex auto approvals, without
+forcing a sandbox policy.
 Use `--include-thinking` to return all agent messages joined together for `codexapi run` (Codex only).
 
 Lead mode periodically checks in on a long-running agent session with the
@@ -290,7 +291,8 @@ codexapi ralph --cancel --cwd /path/to/project
 ```
 
 Science mode wraps a short task in a science prompt and runs it through the
-Ralph loop. It defaults to `--yolo` and expects progress notes in `SCIENCE.md`.
+Ralph loop. It defaults to dangerous no-sandbox automation and expects progress
+notes in `SCIENCE.md`.
 Each iteration appends the agent output to `LOGBOOK.md` and the runner extracts
 any improved figures of merit for optional notifications. You can also set
 `--max-duration` to stop after the current iteration once a time limit is hit.
@@ -330,7 +332,9 @@ items are filtered out.
 
 - `prompt` (str): prompt to send to the agent backend.
 - `cwd` (str | PathLike | None): working directory for the agent session.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `include_thinking` (bool): when true, return all agent messages joined.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
@@ -345,7 +349,9 @@ the same conversation and returns only the agent's message.
 
 - `__call__(prompt) -> str`: send a prompt to the agent backend and return the message.
 - `thread_id -> str | None`: expose the underlying session id once created.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `welfare` (bool): when true, append welfare stop instructions to each prompt
   and raise `WelfareStop` if the agent outputs `MAKE IT STOP`.
@@ -428,7 +434,9 @@ Runs a task file over a list of items, updating the list file in place.
 - `task_file` (str | PathLike): YAML task file (must include `prompt`).
 - `n` (int | None): limit parallelism to N (default: run all items in parallel).
 - `cwd` (str | PathLike | None): working directory for the agent session.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
 - `fast` (bool): enable Codex fast mode (defaults to normal mode).
@@ -450,7 +458,8 @@ Simple result object returned by `foreach()`.
   `fast=True` / `--fast` also passes `service_tier=fast` and `features.fast_mode=true`.
 - Cursor backend uses `cursor agent --print --output-format json --trust` and parses the JSON result.
 - `include_thinking=True` only affects Codex; Cursor returns a single result string.
-- Passes `--yolo` by default (Codex uses `--full-auto` when disabled).
+- Uses dangerous no-sandbox automation by default. For Codex, `yolo=False`
+  uses auto approvals without forcing a sandbox policy.
 - Raises `RuntimeError` if the backend exits non-zero or returns no agent message.
 
 ## Configuration

{codexapi-0.12.10 → codexapi-0.12.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codexapi"
-version = "0.12.10"
+version = "0.12.11"
 description = "Minimal Python API for running the Codex CLI."
 readme = "README.md"
 requires-python = ">=3.8"

{codexapi-0.12.10 → codexapi-0.12.11}/src/codexapi/__init__.py

@@ -30,4 +30,4 @@ __all__ = [
     "task_result",
     "lead",
 ]
-__version__ = "0.12.10"
+__version__ = "0.12.11"

{codexapi-0.12.10 → codexapi-0.12.11}/src/codexapi/agent.py

@@ -67,7 +67,7 @@ def agent(
     Args:
         prompt: The user prompt to send to the agent backend.
         cwd: Optional working directory for the agent session.
-        yolo: Whether to pass --yolo to the agent backend.
+        yolo: Whether to use the backend's most permissive unattended mode.
         flags: Additional raw CLI flags to pass to the agent backend.
         include_thinking: When true, return all agent messages joined together.
         backend: Agent backend to use ("codex" or "cursor").
@@ -131,7 +131,7 @@ class Agent:
 
         Args:
             cwd: Optional working directory for the agent session.
-            yolo: Whether to pass --yolo to the agent backend.
+            yolo: Whether to use the backend's most permissive unattended mode.
             thread_id: Optional thread/session id to resume from the first call.
             flags: Additional raw CLI flags to pass to the agent backend.
             welfare: When true, append welfare stop instructions to each prompt
@@ -235,18 +235,13 @@ def _run_codex(
     thinking=None,
 ):
     """Invoke the Codex CLI and return the message plus thread id (if any)."""
-    command = [
-        _CODEX_BIN,
+    command = [_CODEX_BIN] + _codex_automation_flags(yolo) + [
         "exec",
         "--json",
         "--color",
         "never",
         "--skip-git-repo-check",
     ]
-    if yolo:
-        command.append("--yolo")
-    else:
-        command.append("--full-auto")
     command.extend(_codex_fast_config(fast))
     command.extend(_agent_config_flag_parts("codex", model, thinking))
     if flags:
@@ -276,6 +271,13 @@ def _run_codex(
     return _parse_jsonl(result.stdout, include_thinking)
 
 
+def _codex_automation_flags(yolo):
+    """Return current Codex CLI flags for unattended operation."""
+    if yolo:
+        return ["--dangerously-bypass-approvals-and-sandbox"]
+    return ["--ask-for-approval", "never"]
+
+
 def _codex_fast_config(fast):
     """Return Codex config flags for normal or fast mode."""
     if fast:

{codexapi-0.12.10 → codexapi-0.12.11}/src/codexapi/async_agent.py

@@ -13,6 +13,7 @@ import uuid
 from .agent import (
     _CODEX_BIN,
     _agent_config_flag_parts,
+    _codex_automation_flags,
     _codex_fast_config,
     _cursor_command_prefix,
     _ensure_backend_available,
@@ -386,18 +387,13 @@ def _build_command(backend, cwd, yolo, flags, fast=False, model=None, thinking=N
 
 
 def _build_codex_command(cwd, yolo, flags, fast=False, model=None, thinking=None):
-    command = [
-        _CODEX_BIN,
+    command = [_CODEX_BIN] + _codex_automation_flags(yolo) + [
         "exec",
         "--json",
         "--color",
         "never",
         "--skip-git-repo-check",
     ]
-    if yolo:
-        command.append("--yolo")
-    else:
-        command.append("--full-auto")
     command.extend(_codex_fast_config(fast))
     command.extend(_agent_config_flag_parts("codex", model, thinking))
     if flags:

{codexapi-0.12.10 → codexapi-0.12.11}/src/codexapi/cli.py

@@ -1439,7 +1439,8 @@ def main(argv=None):
     science_help = (
         "Science mode (science command):\n"
         "  Wraps your short task in a science prompt and runs it via the Ralph loop.\n"
-        "  Default uses --yolo. Use --no-yolo to disable it.\n"
+        "  Default uses dangerous no-sandbox automation. "
+        "Use --no-yolo for auto approvals without forcing sandbox policy.\n"
         "  Optional --max-duration stops before starting the next iteration once\n"
         "  the duration limit is reached (e.g. 90m, 2h, 45s; default unit is minutes).\n"
     )
@@ -1479,7 +1480,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     run_parser.add_argument(
         "--flags",
@@ -1535,7 +1536,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     lead_parser.add_argument(
         "--flags",
@@ -1604,7 +1605,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     agent_start.add_argument(
         "--flags",
@@ -1837,7 +1838,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     task_parser.add_argument(
         "--flags",
@@ -1911,7 +1912,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     ralph_parser.add_argument(
         "--flags",
@@ -1982,7 +1983,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     science_parser.add_argument(
         "--flags",
@@ -2033,7 +2034,7 @@ def main(argv=None):
         "--no-yolo",
         action="store_false",
         dest="yolo",
-        help="Disable --yolo (Codex uses --full-auto).",
+        help="Use auto approvals instead of dangerous no-sandbox automation.",
     )
     foreach_parser.add_argument(
         "--flags",

{codexapi-0.12.10 → codexapi-0.12.11}/src/codexapi/lead.py

@@ -91,7 +91,7 @@ def lead(
         minutes: Check-in interval in whole minutes (>= 0).
         prompt: The original instruction prompt.
         cwd: Optional working directory for the agent session.
-        yolo: Whether to pass --yolo to the agent backend.
+        yolo: Whether to use the backend's most permissive unattended mode.
         flags: Additional raw CLI flags to pass to the agent backend.
         leadbook: Optional path to the leadbook file. Set to False to disable.
         backend: Agent backend to use ("codex" or "cursor").

{codexapi-0.12.10 → codexapi-0.12.11}/src/codexapi/task.py

@@ -275,7 +275,7 @@ def task(
             a string check prompt. The string "None" skips verification.
         max_iterations: Maximum number of task iterations (0 means unlimited).
         cwd: Optional working directory for the agent session.
-        yolo: Whether to pass --yolo to the agent backend.
+        yolo: Whether to use the backend's most permissive unattended mode.
         flags: Additional raw CLI flags to pass to the agent backend.
         progress: Whether to show a tqdm progress bar with status updates.
         set_up: Optional setup prompt to run before the task.

{codexapi-0.12.10 → codexapi-0.12.11/src/codexapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.12.10
+Version: 0.12.11
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -157,7 +157,8 @@ Resume a session and print the thread/session id to stderr:
 codexapi run --thread-id THREAD_ID --print-thread-id "Continue where we left off."
 ```
 
-Use `--no-yolo` to disable `--yolo` (Codex uses `--full-auto`).
+Use `--no-yolo` to keep unattended operation with Codex auto approvals, without
+forcing a sandbox policy.
 Use `--include-thinking` to return all agent messages joined together for `codexapi run` (Codex only).
 
 Lead mode periodically checks in on a long-running agent session with the
@@ -305,7 +306,8 @@ codexapi ralph --cancel --cwd /path/to/project
 ```
 
 Science mode wraps a short task in a science prompt and runs it through the
-Ralph loop. It defaults to `--yolo` and expects progress notes in `SCIENCE.md`.
+Ralph loop. It defaults to dangerous no-sandbox automation and expects progress
+notes in `SCIENCE.md`.
 Each iteration appends the agent output to `LOGBOOK.md` and the runner extracts
 any improved figures of merit for optional notifications. You can also set
 `--max-duration` to stop after the current iteration once a time limit is hit.
@@ -345,7 +347,9 @@ items are filtered out.
 
 - `prompt` (str): prompt to send to the agent backend.
 - `cwd` (str | PathLike | None): working directory for the agent session.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `include_thinking` (bool): when true, return all agent messages joined.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
@@ -360,7 +364,9 @@ the same conversation and returns only the agent's message.
 
 - `__call__(prompt) -> str`: send a prompt to the agent backend and return the message.
 - `thread_id -> str | None`: expose the underlying session id once created.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `welfare` (bool): when true, append welfare stop instructions to each prompt
   and raise `WelfareStop` if the agent outputs `MAKE IT STOP`.
@@ -443,7 +449,9 @@ Runs a task file over a list of items, updating the list file in place.
 - `task_file` (str | PathLike): YAML task file (must include `prompt`).
 - `n` (int | None): limit parallelism to N (default: run all items in parallel).
 - `cwd` (str | PathLike | None): working directory for the agent session.
-- `yolo` (bool): pass `--yolo` when true (defaults to true).
+- `yolo` (bool): use the backend's most permissive unattended mode when true
+  (defaults to true). For Codex, `False` uses auto approvals without forcing a
+  sandbox policy.
 - `flags` (str | None): extra CLI flags to pass to the agent backend.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
 - `fast` (bool): enable Codex fast mode (defaults to normal mode).
@@ -465,7 +473,8 @@ Simple result object returned by `foreach()`.
   `fast=True` / `--fast` also passes `service_tier=fast` and `features.fast_mode=true`.
 - Cursor backend uses `cursor agent --print --output-format json --trust` and parses the JSON result.
 - `include_thinking=True` only affects Codex; Cursor returns a single result string.
-- Passes `--yolo` by default (Codex uses `--full-auto` when disabled).
+- Uses dangerous no-sandbox automation by default. For Codex, `yolo=False`
+  uses auto approvals without forcing a sandbox policy.
 - Raises `RuntimeError` if the backend exits non-zero or returns no agent message.
 
 ## Configuration

{codexapi-0.12.10 → codexapi-0.12.11}/tests/test_agent_backend.py

@@ -30,6 +30,25 @@ class AgentBackendTests(unittest.TestCase):
         self.assertIn("features.fast_mode=false", command)
         self.assertNotIn("service_tier=fast", command)
 
+    def test_async_codex_command_uses_documented_yolo_flags(self):
+        command = _build_codex_command(None, True, None)
+        exec_index = command.index("exec")
+        self.assertIn("--dangerously-bypass-approvals-and-sandbox", command)
+        self.assertLess(
+            command.index("--dangerously-bypass-approvals-and-sandbox"),
+            exec_index,
+        )
+        self.assertGreater(command.index("--json"), exec_index)
+        self.assertNotIn("--yolo", command)
+
+    def test_async_codex_command_no_yolo_uses_auto_approval_mode(self):
+        command = _build_codex_command(None, False, None)
+        exec_index = command.index("exec")
+        self.assertLess(command.index("--ask-for-approval"), exec_index)
+        self.assertIn("never", command)
+        self.assertNotIn("--sandbox", command)
+        self.assertNotIn("--full-auto", command)
+
     def test_async_codex_command_can_enable_fast_mode(self):
         command = _build_codex_command(None, True, None, fast=True)
         self.assertIn("service_tier=fast", command)