Read the access token stored by the official Codex CLI. Supports the ``~/.codex/auth.json`` format:: { "auth_mode": "chatgpt",

Clear read-only flag and retry.

Return True if the pause flag file exists.

Conditionally inject Codex OAuth credentials based on EurekaClaw settings. Reads ``settings.codex_auth_mode``. When auth mode is ``"oauth"``:

Claim a per-session rewrite slot. Returns True iff claim succeeded. The /rewrite handler's status-based guard is not atomic with thread spawn

Create a fake cloned repo structure at dest/seed_skills/seedskills/.

Optional async cleanup hook for clients with network transports.

Release a claim made by _claim_rewrite_slot. No-op if not held.

Temporarily align settings/env for auth checks, then restore them.

Reconstruct a KnowledgeBus from a persisted session directory.

Serialise *state* and pipeline position to disk. Args: state: Current TheoryState to persist. next_stag

Register a callback to fire whenever an artifact is updated.

Return the path to the ccproxy binary, or None if not found. Checks PATH first, then the current Python environment's bin directory (handles

Re-run agents with feedback. Returns new LaTeX or None. Args: revision_prompt: If provided (UI mode), skip the CLI prompt.

Return the run's live bus/pipeline/brief, hydrating from disk if needed. Raises ValueError / FileNotFoundError on corrupt or missing state. C

Run Divergent-Convergent planner before the direction gate. Re-reads the brief from the bus so that survey-updated open_problems and

Return a valid access token, preferring the Codex CLI's live credentials. Order matters here: the official Codex CLI refreshes OAuth tokens in

Flip theory/experiment/writer to FAILED if they were left mid-rewrite. Called from the background-rewrite exception handler so the pipeline s

Mirrors the JSONL parser in the GET /api/runs/<id>/paper-qa/history handler in server.py. Keep in sync.

Very rough token estimate used only for compaction heuristics.

Return a snapshot copy of cumulative token usage across all LLM calls.

Write all artifacts to session_dir as JSON files.

Persist the current Rich console transcript as an HTML artifact. Returns the written file path on success, otherwise ``None``.