codexapi 0.12.7__tar.gz → 0.12.10__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.12.7
+Version: 0.12.10
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -78,6 +78,10 @@ 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.
+Use `model="..."` and `thinking="..."` in Codex API calls to override the
+backend model and reasoning effort for a run.
 
 ## CLI
 
@@ -88,6 +92,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 +338,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, model=None, thinking=None) -> str`
 
 Runs a single agent turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -344,8 +349,11 @@ 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).
+- `model` (str | None): backend model override. Codex maps this to `-c model=...`; Cursor maps it to `--model ...`.
+- `thinking` (str | None): Codex reasoning effort override, mapped to `-c model_reasoning_effort=...`.
 
-### `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, model=None, thinking=None)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -358,9 +366,12 @@ 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).
+- `model` (str | None): backend model override.
+- `thinking` (str | None): Codex reasoning effort override.
 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 +384,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 +394,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 +435,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 +446,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 +461,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.10}/README.md

@@ -63,6 +63,10 @@ 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.
+Use `model="..."` and `thinking="..."` in Codex API calls to override the
+backend model and reasoning effort for a run.
 
 ## CLI
 
@@ -73,6 +77,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 +323,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, model=None, thinking=None) -> str`
 
 Runs a single agent turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -329,8 +334,11 @@ 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).
+- `model` (str | None): backend model override. Codex maps this to `-c model=...`; Cursor maps it to `--model ...`.
+- `thinking` (str | None): Codex reasoning effort override, mapped to `-c model_reasoning_effort=...`.
 
-### `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, model=None, thinking=None)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -343,9 +351,12 @@ 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).
+- `model` (str | None): backend model override.
+- `thinking` (str | None): Codex reasoning effort override.
 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 +369,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 +379,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 +420,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 +431,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 +446,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.10}/pyproject.toml

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

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

@@ -1,6 +1,6 @@
 """Minimal Python API for running agent CLIs."""
 
-from .agent import Agent, WelfareStop, agent
+from .agent import Agent, WelfareStop, agent, build_agent_flags
 from .async_agent import AsyncAgent
 from .foreach import ForeachResult, foreach
 from .pushover import Pushover
@@ -15,6 +15,7 @@ __all__ = [
     "AsyncAgent",
     "ForeachResult",
     "Pushover",
+    "build_agent_flags",
     "quota_line",
     "rate_limits",
     "Ralph",
@@ -29,4 +30,4 @@ __all__ = [
     "task_result",
     "lead",
 ]
-__version__ = "0.12.7"
+__version__ = "0.12.10"

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

@@ -11,6 +11,7 @@ from . import welfare
 _CODEX_BIN = os.environ.get("CODEX_BIN", "codex")
 _CURSOR_BIN = os.environ.get("CURSOR_BIN", "cursor")
 _SUPPORTED_BACKENDS = {"codex", "cursor"}
+_CURSOR_AGENT_BIN = os.path.expanduser("~/.local/bin/cursor-agent")
 
 
 def _resolve_backend(backend):
@@ -33,12 +34,15 @@ def _ensure_backend_available(backend, env=None):
         env_var = "CODEX_BIN"
         label = "Codex CLI"
     else:
-        command = _CURSOR_BIN
+        command = _cursor_bin(env)
         env_var = "CURSOR_BIN"
         label = "Cursor agent CLI"
     merged = _merged_env(env)
     path_value = None if merged is None else merged.get("PATH")
-    resolved = shutil.which(command, path=path_value)
+    if os.path.isabs(command):
+        resolved = command if os.path.exists(command) else None
+    else:
+        resolved = shutil.which(command, path=path_value)
     if resolved:
         return resolved
     raise RuntimeError(
@@ -54,6 +58,9 @@ def agent(
     include_thinking=False,
     backend=None,
     env=None,
+    fast=False,
+    model=None,
+    thinking=None,
 ):
     """Run a single agent turn and return only the agent's message.
 
@@ -65,12 +72,25 @@ 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.
+        model: Optional backend model override.
+        thinking: Optional backend reasoning/thinking effort override.
 
     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,
+        model,
+        thinking,
     )
     return message
 
@@ -103,6 +123,9 @@ class Agent:
         include_thinking=False,
         backend=None,
         env=None,
+        fast=False,
+        model=None,
+        thinking=None,
     ):
         """Create a new session wrapper.
 
@@ -116,6 +139,9 @@ 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.
+            model: Optional backend model override.
+            thinking: Optional backend reasoning/thinking effort override.
         """
         self.cwd = cwd
         self._yolo = yolo
@@ -125,6 +151,9 @@ class Agent:
         self.thread_id = thread_id
         self._backend = backend
         self._env = env
+        self._fast = fast
+        self._model = model
+        self._thinking = thinking
         self.last_usage = {}
 
     def __call__(self, prompt):
@@ -140,6 +169,9 @@ class Agent:
             self._include_thinking,
             self._backend,
             self._env,
+            self._fast,
+            self._model,
+            self._thinking,
         )
         if thread_id:
             self.thread_id = thread_id
@@ -149,15 +181,59 @@ 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,
+    model=None,
+    thinking=None,
+):
     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_cursor(prompt, cwd, thread_id, yolo, flags, include_thinking, env)
+        return _run_codex(
+            prompt,
+            cwd,
+            thread_id,
+            yolo,
+            flags,
+            include_thinking,
+            env,
+            fast,
+            model,
+            thinking,
+        )
+    return _run_cursor(
+        prompt,
+        cwd,
+        thread_id,
+        yolo,
+        flags,
+        include_thinking,
+        env,
+        model,
+        thinking,
+    )
 
 
-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,
+    model=None,
+    thinking=None,
+):
     """Invoke the Codex CLI and return the message plus thread id (if any)."""
     command = [
         _CODEX_BIN,
@@ -171,6 +247,8 @@ 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))
+    command.extend(_agent_config_flag_parts("codex", model, thinking))
     if flags:
         command.extend(shlex.split(flags))
     if cwd:
@@ -198,11 +276,94 @@ def _run_codex(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
     return _parse_jsonl(result.stdout, include_thinking)
 
 
-def _run_cursor(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
+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 _cursor_bin(env=None):
+    merged = _merged_env(env)
+    env_source = merged or os.environ
+    override = env_source.get("CURSOR_BIN", "").strip()
+    if override:
+        return os.path.expanduser(override)
+
+    path_value = None if merged is None else merged.get("PATH")
+    direct = shutil.which("cursor-agent", path=path_value)
+    if direct:
+        return direct
+    if os.path.exists(_CURSOR_AGENT_BIN):
+        return _CURSOR_AGENT_BIN
+    return _CURSOR_BIN
+
+
+def _cursor_command_prefix(env=None):
+    command = _cursor_bin(env)
+    if os.path.basename(command) == "cursor-agent":
+        return [command]
+    return [command, "agent"]
+
+
+def build_agent_flags(*, backend=None, model=None, thinking=None, flags=None):
+    """Return raw backend flags for a model/thinking configuration.
+
+    The returned string is suitable for APIs that accept the existing ``flags``
+    parameter.
+    """
+    backend = _resolve_backend(backend)
+    parts = _agent_config_flag_parts(backend, model, thinking)
+    if flags:
+        parts.extend(shlex.split(flags))
+    return shlex.join(parts)
+
+
+def _agent_config_flag_parts(backend, model=None, thinking=None):
+    backend = _resolve_backend(backend)
+    parts = []
+    model = _clean_optional_text(model)
+    thinking = _clean_optional_text(thinking)
+
+    if backend == "codex":
+        if model:
+            parts.extend(["-c", f"model={model}"])
+        if thinking:
+            parts.extend(["-c", f"model_reasoning_effort={thinking}"])
+        return parts
+
+    if model:
+        parts.extend(["--model", model])
+    if thinking:
+        raise ValueError("thinking is only supported by the codex backend")
+    return parts
+
+
+def _clean_optional_text(value):
+    if value is None:
+        return None
+    text = str(value).strip()
+    return text or None
+
+
+def _run_cursor(
+    prompt,
+    cwd,
+    thread_id,
+    yolo,
+    flags,
+    include_thinking,
+    env,
+    model=None,
+    thinking=None,
+):
     """Invoke the Cursor agent CLI and return the message plus session id (if any)."""
-    command = [
-        _CURSOR_BIN,
-        "agent",
+    command = _cursor_command_prefix(env) + [
         "--trust",
     ]
     if cwd:
@@ -211,6 +372,7 @@ def _run_cursor(prompt, cwd, thread_id, yolo, flags, include_thinking, env):
         command.extend(["--resume", thread_id])
     if yolo:
         command.append("--yolo")
+    command.extend(_agent_config_flag_parts("cursor", model, thinking))
     if flags:
         command.extend(shlex.split(flags))
     command.extend(["--print", "--output-format", "json"])

{codexapi-0.12.7 → codexapi-0.12.10}/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 = ""