Class CodexProvider

explainshell/extraction/llm/providers/codex.py:16–91

Implements LLMProvider by shelling out to ``codex exec``. Uses ``--json`` to get JSONL output on stdout, which includes ``item.completed`` events carrying the assistant response and ``turn.completed`` events with token usage.

class CodexProvider:
    """Implements LLMProvider by shelling out to ``codex exec``.

    Uses ``--json`` to get JSONL output on stdout, which includes
    ``item.completed`` events carrying the assistant response and
    ``turn.completed`` events with token usage.
    """

    def __init__(
        self,
        model: str,
        *,
        reasoning_effort: str | None = None,
        codex_bin: str | Sequence[str] = "codex",
    ) -> None:
        # model format: "codex/<model>" (effort is passed separately)
        parts = model.split("/", 1)
        if len(parts) < 2 or not parts[1]:
            raise ValueError(
                f"codex provider requires a model name (e.g. codex/gpt-5.4-mini), got: {model!r}"
            )
        self._model = model
        self._underlying = parts[1]
        self._reasoning_effort = reasoning_effort
        self._codex_bin = [codex_bin] if isinstance(codex_bin, str) else list(codex_bin)

    def call(self, user_content: str) -> tuple[str, TokenUsage]:
        prompt = SYSTEM_PROMPT + "\n\n" + user_content

        cmd = [
            *self._codex_bin,
            "exec",
            "--json",
            "--sandbox",
            "read-only",
        ]

        cmd.extend(["--model", self._underlying])

        if self._reasoning_effort:
            cmd.extend(["-c", f'model_reasoning_effort="{self._reasoning_effort}"'])

        # Pass prompt on stdin (the "-" argument tells codex to read from stdin).
        cmd.append("-")

        result = subprocess.run(
            cmd,
            input=prompt,
            capture_output=True,
            text=True,
            timeout=CODEX_TIMEOUT_SECONDS,
        )

        content, usage = _parse_jsonl(result.stdout)

        if result.returncode != 0:
            detail = result.stderr.strip() or result.stdout.strip()
            if "usage limit" in detail.lower():