codexapi 0.12.7__tar.gz → 0.12.9__tar.gz

{codexapi-0.12.7/src/codexapi.egg-info → codexapi-0.12.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.12.7
+Version: 0.12.9
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -78,6 +78,8 @@ for update in agent.watch(poll_interval=2.0):
 
 Use `backend="cursor"` (or set `CODEXAPI_BACKEND=cursor`) to switch to the
 Cursor agent backend.
+Use `fast=True` in Codex API calls, or `--fast` in the CLI, to opt into Codex
+fast mode. Normal mode is the default.
 
 ## CLI
 
@@ -88,6 +90,7 @@ codexapi --version
 codexapi run "Summarize this repo."
 codexapi run --cwd /path/to/project "Fix the failing tests."
 echo "Say hello." | codexapi run
+codexapi run --fast "Summarize this repo quickly."
 codexapi run --backend cursor "Summarize this repo."
 ```
 
@@ -333,7 +336,7 @@ codexapi foreach list.txt task.yaml --retry-all
 
 ## API
 
-### `agent(prompt, cwd=None, yolo=True, flags=None, include_thinking=False, backend=None) -> str`
+### `agent(prompt, cwd=None, yolo=True, flags=None, include_thinking=False, backend=None, fast=False) -> str`
 
 Runs a single agent turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -344,8 +347,9 @@ items are filtered out.
 - `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`).
+- `fast` (bool): enable Codex fast mode (defaults to normal mode).
 
-### `Agent(cwd=None, yolo=True, thread_id=None, flags=None, welfare=False, include_thinking=False, backend=None)`
+### `Agent(cwd=None, yolo=True, thread_id=None, flags=None, welfare=False, include_thinking=False, backend=None, fast=False)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -358,9 +362,10 @@ the same conversation and returns only the agent's message.
   and raise `WelfareStop` if the agent outputs `MAKE IT STOP`.
 - `include_thinking` (bool): when true, return all agent messages joined.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
+- `fast` (bool): enable Codex fast mode (defaults to normal mode).
 For Cursor, `thread_id` corresponds to the `session_id` returned by the agent.
 
-### `lead(minutes, prompt, cwd=None, yolo=True, flags=None, leadbook=None, backend=None) -> dict`
+### `lead(minutes, prompt, cwd=None, yolo=True, flags=None, leadbook=None, backend=None, fast=False) -> dict`
 
 Runs a long-lived agent session and periodically checks in with the current
 local time and a reminder of `prompt`. Each check-in expects JSON with keys:
@@ -373,7 +378,7 @@ Lead also injects the leadbook content into each prompt. By default it uses
 path string to override the location.
 Set `backend="cursor"` (or `CODEXAPI_BACKEND=cursor`) to use Cursor.
 
-### `task(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None) -> str`
+### `task(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None, fast=False) -> str`
 
 Runs a task with checker-driven retries and returns the success summary.
 Raises `TaskFailed` when the maximum iterations are reached.
@@ -383,14 +388,15 @@ Raises `TaskFailed` when the maximum iterations are reached.
 - `progress` (bool): show a tqdm progress bar with a one-line status after each round.
 - `set_up`/`tear_down`/`on_success`/`on_failure` (str | None): optional hook prompts.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
+- `fast` (bool): enable Codex fast mode (defaults to normal mode).
 
-### `task_result(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None) -> TaskResult`
+### `task_result(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None, fast=False) -> TaskResult`
 
 Runs a task with checker-driven retries and returns a `TaskResult` without
 raising `TaskFailed`.
 Arguments mirror `task()` (including hooks).
 
-### `Task(prompt, max_iterations=10, cwd=None, yolo=True, thread_id=None, flags=None, backend=None)`
+### `Task(prompt, max_iterations=10, cwd=None, yolo=True, thread_id=None, flags=None, backend=None, fast=False)`
 
 Runs an agent task with checker-driven retries. Subclass it and implement
 `check()` to return an error string when the task is incomplete, or return
@@ -423,7 +429,7 @@ Exception raised by `task()` when iterations are exhausted.
 - `iterations` (int | None): iterations made when the task failed.
 - `errors` (str | None): last checker error, if any.
 
-### `foreach(list_file, task_file, n=None, cwd=None, yolo=True, flags=None, backend=None) -> ForeachResult`
+### `foreach(list_file, task_file, n=None, cwd=None, yolo=True, flags=None, backend=None, fast=False) -> ForeachResult`
 
 Runs a task file over a list of items, updating the list file in place.
 
@@ -434,6 +440,7 @@ Runs a task file over a list of items, updating the list file in place.
 - `yolo` (bool): pass `--yolo` when true (defaults to true).
 - `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).
 
 ### `ForeachResult(succeeded, failed, skipped, results)`
 
@@ -448,6 +455,8 @@ Simple result object returned by `foreach()`.
 
 - Codex backend uses `codex exec --json` and parses JSONL `agent_message` items.
 - Codex backend passes `--skip-git-repo-check` so it can run outside a git repo.
+- Codex backend defaults to normal mode and passes `features.fast_mode=false`;
+  `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).

{codexapi-0.12.7 → codexapi-0.12.9}/README.md

@@ -63,6 +63,8 @@ for update in agent.watch(poll_interval=2.0):
 
 Use `backend="cursor"` (or set `CODEXAPI_BACKEND=cursor`) to switch to the
 Cursor agent backend.
+Use `fast=True` in Codex API calls, or `--fast` in the CLI, to opt into Codex
+fast mode. Normal mode is the default.
 
 ## CLI
 
@@ -73,6 +75,7 @@ codexapi --version
 codexapi run "Summarize this repo."
 codexapi run --cwd /path/to/project "Fix the failing tests."
 echo "Say hello." | codexapi run
+codexapi run --fast "Summarize this repo quickly."
 codexapi run --backend cursor "Summarize this repo."
 ```
 
@@ -318,7 +321,7 @@ codexapi foreach list.txt task.yaml --retry-all
 
 ## API
 
-### `agent(prompt, cwd=None, yolo=True, flags=None, include_thinking=False, backend=None) -> str`
+### `agent(prompt, cwd=None, yolo=True, flags=None, include_thinking=False, backend=None, fast=False) -> str`
 
 Runs a single agent turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -329,8 +332,9 @@ items are filtered out.
 - `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`).
+- `fast` (bool): enable Codex fast mode (defaults to normal mode).
 
-### `Agent(cwd=None, yolo=True, thread_id=None, flags=None, welfare=False, include_thinking=False, backend=None)`
+### `Agent(cwd=None, yolo=True, thread_id=None, flags=None, welfare=False, include_thinking=False, backend=None, fast=False)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -343,9 +347,10 @@ the same conversation and returns only the agent's message.
   and raise `WelfareStop` if the agent outputs `MAKE IT STOP`.
 - `include_thinking` (bool): when true, return all agent messages joined.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
+- `fast` (bool): enable Codex fast mode (defaults to normal mode).
 For Cursor, `thread_id` corresponds to the `session_id` returned by the agent.
 
-### `lead(minutes, prompt, cwd=None, yolo=True, flags=None, leadbook=None, backend=None) -> dict`
+### `lead(minutes, prompt, cwd=None, yolo=True, flags=None, leadbook=None, backend=None, fast=False) -> dict`
 
 Runs a long-lived agent session and periodically checks in with the current
 local time and a reminder of `prompt`. Each check-in expects JSON with keys:
@@ -358,7 +363,7 @@ Lead also injects the leadbook content into each prompt. By default it uses
 path string to override the location.
 Set `backend="cursor"` (or `CODEXAPI_BACKEND=cursor`) to use Cursor.
 
-### `task(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None) -> str`
+### `task(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None, fast=False) -> str`
 
 Runs a task with checker-driven retries and returns the success summary.
 Raises `TaskFailed` when the maximum iterations are reached.
@@ -368,14 +373,15 @@ Raises `TaskFailed` when the maximum iterations are reached.
 - `progress` (bool): show a tqdm progress bar with a one-line status after each round.
 - `set_up`/`tear_down`/`on_success`/`on_failure` (str | None): optional hook prompts.
 - `backend` (str | None): `codex` or `cursor` (defaults to `CODEXAPI_BACKEND` or `codex`).
+- `fast` (bool): enable Codex fast mode (defaults to normal mode).
 
-### `task_result(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None) -> TaskResult`
+### `task_result(prompt, check=None, max_iterations=10, cwd=None, yolo=True, flags=None, progress=False, set_up=None, tear_down=None, on_success=None, on_failure=None, backend=None, fast=False) -> TaskResult`
 
 Runs a task with checker-driven retries and returns a `TaskResult` without
 raising `TaskFailed`.
 Arguments mirror `task()` (including hooks).
 
-### `Task(prompt, max_iterations=10, cwd=None, yolo=True, thread_id=None, flags=None, backend=None)`
+### `Task(prompt, max_iterations=10, cwd=None, yolo=True, thread_id=None, flags=None, backend=None, fast=False)`
 
 Runs an agent task with checker-driven retries. Subclass it and implement
 `check()` to return an error string when the task is incomplete, or return
@@ -408,7 +414,7 @@ Exception raised by `task()` when iterations are exhausted.
 - `iterations` (int | None): iterations made when the task failed.
 - `errors` (str | None): last checker error, if any.
 
-### `foreach(list_file, task_file, n=None, cwd=None, yolo=True, flags=None, backend=None) -> ForeachResult`
+### `foreach(list_file, task_file, n=None, cwd=None, yolo=True, flags=None, backend=None, fast=False) -> ForeachResult`
 
 Runs a task file over a list of items, updating the list file in place.
 
@@ -419,6 +425,7 @@ Runs a task file over a list of items, updating the list file in place.
 - `yolo` (bool): pass `--yolo` when true (defaults to true).
 - `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).
 
 ### `ForeachResult(succeeded, failed, skipped, results)`
 
@@ -433,6 +440,8 @@ Simple result object returned by `foreach()`.
 
 - Codex backend uses `codex exec --json` and parses JSONL `agent_message` items.
 - Codex backend passes `--skip-git-repo-check` so it can run outside a git repo.
+- Codex backend defaults to normal mode and passes `features.fast_mode=false`;
+  `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).

{codexapi-0.12.7 → codexapi-0.12.9}/pyproject.toml

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

{codexapi-0.12.7 → codexapi-0.12.9}/src/codexapi/__init__.py

@@ -29,4 +29,4 @@ __all__ = [
     "task_result",
     "lead",
 ]
-__version__ = "0.12.7"
+__version__ = "0.12.9"

{codexapi-0.12.7 → codexapi-0.12.9}/src/codexapi/agent.py

@@ -54,6 +54,7 @@ def agent(
     include_thinking=False,
     backend=None,
     env=None,
+    fast=False,
 ):
     """Run a single agent turn and return only the agent's message.
 
@@ -65,12 +66,13 @@ def agent(
         include_thinking: When true, return all agent messages joined together.
         backend: Agent backend to use ("codex" or "cursor").
         env: Optional environment variables for the backend subprocess.
+        fast: Enable Codex fast mode. Defaults to normal mode.
 
     Returns:
         The agent's visible response text with reasoning traces removed.
     """
     message, _thread_id, _usage = _run_agent(
-        prompt, cwd, None, yolo, flags, include_thinking, backend, env
+        prompt, cwd, None, yolo, flags, include_thinking, backend, env, fast
     )
     return message
 
@@ -103,6 +105,7 @@ class Agent:
         include_thinking=False,
         backend=None,
         env=None,
+        fast=False,
     ):
         """Create a new session wrapper.
 
@@ -116,6 +119,7 @@ class Agent:
             include_thinking: When true, return all agent messages joined together.
             backend: Agent backend to use ("codex" or "cursor").
             env: Optional environment variables for the backend subprocess.
+            fast: Enable Codex fast mode. Defaults to normal mode.
         """
         self.cwd = cwd
         self._yolo = yolo
@@ -125,6 +129,7 @@ class Agent:
         self.thread_id = thread_id
         self._backend = backend
         self._env = env
+        self._fast = fast
         self.last_usage = {}
 
     def __call__(self, prompt):
@@ -140,6 +145,7 @@ class Agent:
             self._include_thinking,
             self._backend,
             self._env,
+            self._fast,
         )
         if thread_id:
             self.thread_id = thread_id
@@ -149,15 +155,25 @@ class Agent:
         return message
 
 
-def _run_agent(prompt, cwd, thread_id, yolo, flags, include_thinking, backend, env):
+def _run_agent(
+    prompt,
+    cwd,
+    thread_id,
+    yolo,
+    flags,
+    include_thinking,
+    backend,
+    env,
+    fast=False,
+):
     backend = _resolve_backend(backend)
     _ensure_backend_available(backend, env)
     if backend == "codex":
-        return _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env)
+        return _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env, fast)
     return _run_cursor(prompt, cwd, thread_id, yolo, flags, include_thinking, env)
 
 
-def _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
+def _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env, fast=False):
     """Invoke the Codex CLI and return the message plus thread id (if any)."""
     command = [
         _CODEX_BIN,
@@ -171,6 +187,7 @@ def _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
         command.append("--yolo")
     else:
         command.append("--full-auto")
+    command.extend(_codex_fast_config(fast))
     if flags:
         command.extend(shlex.split(flags))
     if cwd:
@@ -198,6 +215,18 @@ def _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
     return _parse_jsonl(result.stdout, include_thinking)
 
 
+def _codex_fast_config(fast):
+    """Return Codex config flags for normal or fast mode."""
+    if fast:
+        return [
+            "-c",
+            "service_tier=fast",
+            "-c",
+            "features.fast_mode=true",
+        ]
+    return ["-c", "features.fast_mode=false"]
+
+
 def _run_cursor(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
     """Invoke the Cursor agent CLI and return the message plus session id (if any)."""
     command = [

{codexapi-0.12.7 → codexapi-0.12.9}/src/codexapi/agents.py

@@ -210,6 +210,7 @@ def start_agent(
     home=None,
     hostname=None,
     now=None,
+    fast=False,
 ):
     """Create a durable agent and return its current snapshot."""
     if not isinstance(prompt, str) or not prompt.strip():
@@ -250,6 +251,7 @@ def start_agent(
         "backend": backend_name,
         "yolo": bool(yolo),
         "flags": flags or "",
+        "fast": bool(fast),
         "cwd": cwd,
         "env": session_env,
         "pending_messages": [],
@@ -1053,15 +1055,27 @@ def _run_agent_turn(meta, session, prompt, runner=None):
             raise TypeError("runner must return a dict")
         return outcome
     started = utc_now()
-    worker = Agent(
-        session.get("cwd") or meta.get("cwd"),
-        session.get("yolo", True),
-        session.get("thread_id") or None,
-        session.get("flags") or None,
-        include_thinking=False,
-        backend=session.get("backend") or None,
-        env=_agent_env(meta, session),
-    )
+    if session.get("fast", False):
+        worker = Agent(
+            session.get("cwd") or meta.get("cwd"),
+            session.get("yolo", True),
+            session.get("thread_id") or None,
+            session.get("flags") or None,
+            include_thinking=False,
+            backend=session.get("backend") or None,
+            env=_agent_env(meta, session),
+            fast=True,
+        )
+    else:
+        worker = Agent(
+            session.get("cwd") or meta.get("cwd"),
+            session.get("yolo", True),
+            session.get("thread_id") or None,
+            session.get("flags") or None,
+            include_thinking=False,
+            backend=session.get("backend") or None,
+            env=_agent_env(meta, session),
+        )
     message = worker(prompt)
     usage = worker.last_usage or {}
     rollout_path = ""

{codexapi-0.12.7 → codexapi-0.12.9}/src/codexapi/async_agent.py

@@ -13,6 +13,7 @@ import uuid
 from .agent import (
     _CODEX_BIN,
     _CURSOR_BIN,
+    _codex_fast_config,
     _ensure_backend_available,
     _event_usage,
     _merged_env,
@@ -48,6 +49,7 @@ class AsyncAgent:
         self._lock = threading.Lock()
         self._stdout_lines: list[str] = []
         self._stderr_lines: list[str] = []
+        self._errors: list[str] = []
         self._messages: list[str] = []
         self._thread_id = ""
         self._rollout_path = ""
@@ -85,6 +87,7 @@ class AsyncAgent:
         backend=None,
         env=None,
         name=None,
+        fast=False,
     ):
         """Start a backend subprocess and return an async handle immediately."""
         if not isinstance(prompt, str) or not prompt.strip():
@@ -92,7 +95,7 @@ class AsyncAgent:
 
         backend = _resolve_backend(backend)
         _ensure_backend_available(backend, env)
-        command = _build_command(backend, cwd, yolo, flags)
+        command = _build_command(backend, cwd, yolo, flags, fast)
         process = subprocess.Popen(
             command,
             stdin=subprocess.PIPE,
@@ -157,6 +160,7 @@ class AsyncAgent:
             progress = list(self._progress)
             tools = list(self._tools) if include_actions else []
             stderr_lines = list(self._stderr_lines)
+            error_lines = list(self._errors)
             thread_id = self._thread_id
             rollout_path = self._rollout_path
             last_event_at = self._last_event_at
@@ -168,7 +172,9 @@ class AsyncAgent:
             progress=progress,
             final_output=final_output,
             stderr_lines=stderr_lines,
+            error_lines=error_lines,
         )
+        last_error = error_lines[-1] if error_lines else stderr_lines[-1] if stderr_lines else ""
         return {
             "id": self.id,
             "name": self.name,
@@ -184,8 +190,9 @@ class AsyncAgent:
             "final_output": final_output,
             "last_event_at": last_event_at,
             "returncode": returncode,
-            "last_error": stderr_lines[-1] if stderr_lines else "",
+            "last_error": last_error,
             "stderr": "\n".join(stderr_lines),
+            "errors": error_lines,
             "messages": messages,
             "usage": last_usage,
         }
@@ -310,6 +317,16 @@ class AsyncAgent:
                     text = item.get("text")
                     if isinstance(text, str):
                         self._messages.append(text)
+            elif event.get("type") == "error":
+                message = event.get("message")
+                if isinstance(message, str) and message.strip():
+                    self._errors.append(message.strip())
+            elif event.get("type") == "turn.failed":
+                error = event.get("error") or {}
+                if isinstance(error, dict):
+                    message = error.get("message")
+                    if isinstance(message, str) and message.strip():
+                        self._errors.append(message.strip())
 
     def _refresh_rollout(self) -> None:
         if self.backend != "codex":
@@ -359,13 +376,13 @@ class AsyncAgent:
         return self._rollout_final_output
 
 
-def _build_command(backend, cwd, yolo, flags):
+def _build_command(backend, cwd, yolo, flags, fast=False):
     if backend == "codex":
-        return _build_codex_command(cwd, yolo, flags)
+        return _build_codex_command(cwd, yolo, flags, fast)
     return _build_cursor_command(cwd, yolo, flags)
 
 
-def _build_codex_command(cwd, yolo, flags):
+def _build_codex_command(cwd, yolo, flags, fast=False):
     command = [
         _CODEX_BIN,
         "exec",
@@ -378,6 +395,7 @@ def _build_codex_command(cwd, yolo, flags):
         command.append("--yolo")
     else:
         command.append("--full-auto")
+    command.extend(_codex_fast_config(fast))
     if flags:
         command.extend(shlex.split(flags))
     if cwd:
@@ -425,9 +443,11 @@ def _status_text(returncode, canceled):
     return "error"
 
 
-def _activity_text(status, progress, final_output, stderr_lines):
+def _activity_text(status, progress, final_output, stderr_lines, error_lines=None):
     if progress:
         return progress[-1]
+    if status == "error" and error_lines:
+        return error_lines[-1]
     if status == "error" and stderr_lines:
         return stderr_lines[-1]
     if final_output: