Method call

explainshell/extraction/llm/providers/codex.py:42–87

(self, user_content: str)

        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():
                raise FatalExtractionError(f"codex usage limit reached: {detail}")
            # If codex produced no response content, the failure is
            # systemic (auth, network, service outage) rather than
            # prompt-specific — abort the entire run instead of failing
            # each remaining file one by one.
            if not content:
                raise FatalExtractionError(
                    f"codex exec failed with no output (exit {result.returncode}): {detail}"
                )
            raise RuntimeError(
                f"codex exec failed (exit {result.returncode}): {detail}"
            )

        return content, usage

    @property
    def retryable_exceptions(self) -> tuple[type[Exception], ...]: