coding-cli-runtime 0.1.0__tar.gz

coding_cli_runtime-0.1.0/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [Unreleased]
+
+### Changed
+- Consolidated `shared_cli_runtime` into `coding_cli_runtime`. The package now
+  ships a single top-level package; the `shared_cli_runtime` directory is removed.
+- `MANIFEST.in` and docs updated to reference `coding_cli_runtime` paths.
+- Minimum Python version remains `>=3.10`.
+- `run_interactive_session()` observability kwargs (`provider_label`, `job_name`,
+  `phase_tag`, `process_label`, `timeout_seconds`) now have sensible defaults so
+  external callers don't need to supply internal batch-system labels.
+- Provider model catalogs are now resolved with a three-tier fallback:
+  user override file > live CLI discovery > hardcoded fallback.
+  - **Codex**: reads `~/.codex/models_cache.json` (auto-refreshed by the CLI)
+    when present; falls back to the hardcoded catalog on any parse failure.
+  - **All providers**: place a JSON file at
+    `~/.config/coding-cli-runtime/providers/<provider>.json` (or set
+    `CODING_CLI_RUNTIME_CONFIG_DIR`) to override the model list and default
+    model without waiting for a package update.
+
+### Added
+- `__version__` attribute in both `coding_cli_runtime` and `shared_cli_runtime`.
+- `CONTRIBUTING.md`, `MANIFEST.in`, `.pre-commit-config.yaml`.
+- PyPI / Python / Build / License badges in `README.md`.
+- `bump-my-version` configuration syncing `pyproject.toml` and both `__init__.py` files.
+- `ruff`, `mypy` (strict), and `pytest-cov` added to dev dependencies.
+- CI quality gates: ruff check, ruff format, mypy, pytest-cov.
+
+### Changed
+- `CliRunResult.command` type widened from `tuple[str, ...]` to `Sequence[str]`.
+- Publish workflow path corrected (`shared-cli-runtime` → `coding-cli-runtime`).
+
+### Fixed
+- mypy strict compliance: return-type annotations, per-module overrides, targeted type-ignore comments.
+- ruff lint and format compliance across all source and test files.
+
+## [0.1.0] - 2026-04-07
+
+### Added
+- Initial extraction from `llm-eval` monorepo.
+- Provider metadata and controls for Claude, Codex, Copilot, and Gemini CLIs.
+- Shared request/result contracts (`CliRunRequest`, `CliRunResult`, `CliLaunchSpec`).
+- Schema loading and payload validation (`load_schema`, `validate_payload`).
+- Synchronous and asynchronous subprocess execution helpers.
+- Interactive session execution with transcript mirroring.
+- Session log discovery and parsing utilities.
+- Claude reasoning policy resolution.
+- Log redaction helpers.
+- Copilot reasoning log parsing and classification.
+- PEP 561 `py.typed` markers for both `coding_cli_runtime` and `shared_cli_runtime`.
+- Packaged JSON schemas and Copilot reasoning baseline data.
+- Playground knowledge base with probing guides and experiment templates.

coding_cli_runtime-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to coding-cli-runtime
+
+## Development setup
+
+```bash
+cd packages/coding-cli-runtime
+
+# Install dependencies with uv (recommended)
+uv sync --group dev
+
+# Or use pip
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Quality checks
+
+```bash
+# Run all checks (same as CI)
+uv run --project . --group dev python -m ruff check src tests
+uv run --project . --group dev python -m ruff format --check src tests
+uv run --project . --group dev python -m mypy src
+uv run --project . --group dev python -m pytest -v
+
+# Pre-commit (if installed)
+uv run --project . --group dev pre-commit run --all-files
+
+# Build and validate
+uv run --project . --group dev python -m build --no-isolation --sdist --wheel
+uv run --project . --group dev python -m twine check dist/*
+```
+
+## Pull request process
+
+1. Run all quality checks locally before pushing.
+2. Update `CHANGELOG.md` under `[Unreleased]` for any user-visible changes.
+3. CI enforces the same checks — PRs must pass before merge.

coding_cli_runtime-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LLM Eval contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

coding_cli_runtime-0.1.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include CHANGELOG.md
+include LICENSE
+include README.md
+include CONTRIBUTING.md
+
+recursive-include src/coding_cli_runtime/schemas *.json
+include src/coding_cli_runtime/copilot_reasoning_baseline.json
+
+global-exclude __pycache__ *.py[cod]

coding_cli_runtime-0.1.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: coding-cli-runtime
+Version: 0.1.0
+Summary: Reusable CLI runtime primitives for provider-backed automation workflows
+Author-email: LLM Eval maintainers <llm-eval-maintainers@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pj-ms/llm-eval/tree/main/packages/coding-cli-runtime
+Project-URL: Repository, https://github.com/pj-ms/llm-eval
+Project-URL: Issues, https://github.com/pj-ms/llm-eval/issues
+Project-URL: Changelog, https://github.com/pj-ms/llm-eval/blob/main/packages/coding-cli-runtime/CHANGELOG.md
+Keywords: cli,runtime,llm,automation,schema-validation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# coding-cli-runtime
+
+[![PyPI](https://img.shields.io/pypi/v/coding-cli-runtime)](https://pypi.org/project/coding-cli-runtime/)
+[![Python](https://img.shields.io/pypi/pyversions/coding-cli-runtime)](https://pypi.org/project/coding-cli-runtime/)
+[![Build](https://github.com/pj-ms/llm-eval/actions/workflows/ci.yml/badge.svg)](https://github.com/pj-ms/llm-eval/actions/workflows/ci.yml)
+[![License](https://img.shields.io/pypi/l/coding-cli-runtime)](LICENSE)
+
+A Python library for orchestrating LLM coding agent CLIs — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), and [GitHub Copilot](https://docs.github.com/en/copilot).
+
+These CLIs each have different invocation patterns, output formats, error
+shapes, and timeout behaviors. This library normalizes all of that behind
+a common `CliRunRequest` → `CliRunResult` contract, so your automation
+code doesn't need provider-specific subprocess handling.
+
+**What it does (and why not just `subprocess.run`):**
+
+- Unified request/result types across all four CLIs
+- Timeout enforcement with graceful process termination
+- Provider-aware failure classification (retryable vs fatal)
+- Built-in model catalog with defaults, reasoning levels, and capabilities
+- Interactive session management for long-running generation tasks
+- Zero runtime dependencies
+
+## Installation
+
+```bash
+pip install coding-cli-runtime
+```
+
+Requires Python 3.10+.
+
+## Examples
+
+### Execute a provider CLI
+
+```python
+import asyncio
+from pathlib import Path
+from coding_cli_runtime import CliRunRequest, run_cli_command
+
+request = CliRunRequest(
+    cmd_parts=("codex", "--model", "o4-mini", "--quiet", "exec", "fix the tests"),
+    cwd=Path("/tmp/my-project"),
+    timeout_seconds=120,
+)
+result = asyncio.run(run_cli_command(request))
+
+print(result.returncode)        # 0
+print(result.error_code)        # "none"
+print(result.duration_seconds)  # 14.2
+print(result.stdout_text[:200])
+```
+
+Swap `codex` for `claude`, `gemini`, or `copilot` — the request/result
+shape stays the same. A synchronous variant `run_cli_command_sync` is also
+available.
+
+### Pick a model from the provider catalog
+
+```python
+from coding_cli_runtime import get_provider_spec
+
+codex = get_provider_spec("codex")
+print(codex.default_model)   # "gpt-5.3-codex"
+print(codex.model_source)    # "codex_cli_cache", "override", or "code"
+
+for model in codex.models:
+    print(f"  {model.name}: {model.description}")
+```
+
+The catalog covers all four providers — each with model names, reasoning
+levels, default settings, and visibility flags.
+
+Model lists are resolved with a three-tier fallback:
+
+1. **User override** — drop a JSON file at
+   `~/.config/coding-cli-runtime/providers/<provider>.json` to use your own
+   model list immediately, without waiting for a package update.
+2. **Live CLI cache** — for Codex, the library reads
+   `~/.codex/models_cache.json` (auto-refreshed by the Codex CLI) when
+   present. Other providers fall through because their CLIs don't expose a
+   machine-readable model list.
+3. **Hardcoded fallback** — the model list shipped with the package.
+
+Override file format:
+
+```json
+{
+  "default_model": "claude-sonnet-4-7",
+  "models": [
+    "claude-sonnet-4-7",
+    {
+      "name": "claude-opus-5",
+      "description": "Latest opus model",
+      "controls": [
+        { "name": "effort", "kind": "choice", "choices": ["low", "high"], "default": "low" }
+      ]
+    }
+  ]
+}
+```
+
+Set `CODING_CLI_RUNTIME_CONFIG_DIR` to change the config directory
+(default: `~/.config/coding-cli-runtime`).
+
+### Decide whether to retry a failed run
+
+```python
+from coding_cli_runtime import classify_provider_failure
+
+classification = classify_provider_failure(
+    provider="gemini",
+    stderr_text="429 Resource exhausted: rate limit exceeded",
+)
+
+if classification.retryable:
+    print(f"Retryable ({classification.category}) — will retry")
+else:
+    print(f"Fatal ({classification.category}) — giving up")
+```
+
+Works for all four providers. Recognizes auth failures, rate limits,
+network transients, and other provider-specific error patterns.
+
+## Key types
+
+| Type | Purpose |
+|------|---------|
+| `CliRunRequest` | Command spec: cmd, cwd, env, timeout, stream paths |
+| `CliRunResult` | Result: returncode, stdout/stderr, duration, error code |
+| `ErrorCode` | `none` · `spawn_failed` · `timed_out` · `non_zero_exit` |
+| `ProviderSpec` | Provider catalog entry with models, controls, defaults |
+| `FailureClassification` | Classified error with retryable flag and category |
+
+`run_interactive_session()` manages long-running CLI processes with
+timeout enforcement, process-group cleanup, transcript mirroring, and
+automatic retries. Only `cmd_parts`, `cwd`, `stdin_text`, and `logger` are
+required — observability labels like `job_name` and `phase_tag` default to
+sensible values so external callers don't need to invent them.
+
+## Prerequisites
+
+This package does **not** bundle any CLI binaries or credentials. You must
+install and authenticate the relevant provider CLI yourself before using the
+execution helpers.
+
+## Status
+
+Pre-1.0. API may change between minor versions.
+
+## License
+
+MIT

coding_cli_runtime-0.1.0/README.md

@@ -0,0 +1,153 @@
+# coding-cli-runtime
+
+[![PyPI](https://img.shields.io/pypi/v/coding-cli-runtime)](https://pypi.org/project/coding-cli-runtime/)
+[![Python](https://img.shields.io/pypi/pyversions/coding-cli-runtime)](https://pypi.org/project/coding-cli-runtime/)
+[![Build](https://github.com/pj-ms/llm-eval/actions/workflows/ci.yml/badge.svg)](https://github.com/pj-ms/llm-eval/actions/workflows/ci.yml)
+[![License](https://img.shields.io/pypi/l/coding-cli-runtime)](LICENSE)
+
+A Python library for orchestrating LLM coding agent CLIs — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), and [GitHub Copilot](https://docs.github.com/en/copilot).
+
+These CLIs each have different invocation patterns, output formats, error
+shapes, and timeout behaviors. This library normalizes all of that behind
+a common `CliRunRequest` → `CliRunResult` contract, so your automation
+code doesn't need provider-specific subprocess handling.
+
+**What it does (and why not just `subprocess.run`):**
+
+- Unified request/result types across all four CLIs
+- Timeout enforcement with graceful process termination
+- Provider-aware failure classification (retryable vs fatal)
+- Built-in model catalog with defaults, reasoning levels, and capabilities
+- Interactive session management for long-running generation tasks
+- Zero runtime dependencies
+
+## Installation
+
+```bash
+pip install coding-cli-runtime
+```
+
+Requires Python 3.10+.
+
+## Examples
+
+### Execute a provider CLI
+
+```python
+import asyncio
+from pathlib import Path
+from coding_cli_runtime import CliRunRequest, run_cli_command
+
+request = CliRunRequest(
+    cmd_parts=("codex", "--model", "o4-mini", "--quiet", "exec", "fix the tests"),
+    cwd=Path("/tmp/my-project"),
+    timeout_seconds=120,
+)
+result = asyncio.run(run_cli_command(request))
+
+print(result.returncode)        # 0
+print(result.error_code)        # "none"
+print(result.duration_seconds)  # 14.2
+print(result.stdout_text[:200])
+```
+
+Swap `codex` for `claude`, `gemini`, or `copilot` — the request/result
+shape stays the same. A synchronous variant `run_cli_command_sync` is also
+available.
+
+### Pick a model from the provider catalog
+
+```python
+from coding_cli_runtime import get_provider_spec
+
+codex = get_provider_spec("codex")
+print(codex.default_model)   # "gpt-5.3-codex"
+print(codex.model_source)    # "codex_cli_cache", "override", or "code"
+
+for model in codex.models:
+    print(f"  {model.name}: {model.description}")
+```
+
+The catalog covers all four providers — each with model names, reasoning
+levels, default settings, and visibility flags.
+
+Model lists are resolved with a three-tier fallback:
+
+1. **User override** — drop a JSON file at
+   `~/.config/coding-cli-runtime/providers/<provider>.json` to use your own
+   model list immediately, without waiting for a package update.
+2. **Live CLI cache** — for Codex, the library reads
+   `~/.codex/models_cache.json` (auto-refreshed by the Codex CLI) when
+   present. Other providers fall through because their CLIs don't expose a
+   machine-readable model list.
+3. **Hardcoded fallback** — the model list shipped with the package.
+
+Override file format:
+
+```json
+{
+  "default_model": "claude-sonnet-4-7",
+  "models": [
+    "claude-sonnet-4-7",
+    {
+      "name": "claude-opus-5",
+      "description": "Latest opus model",
+      "controls": [
+        { "name": "effort", "kind": "choice", "choices": ["low", "high"], "default": "low" }
+      ]
+    }
+  ]
+}
+```
+
+Set `CODING_CLI_RUNTIME_CONFIG_DIR` to change the config directory
+(default: `~/.config/coding-cli-runtime`).
+
+### Decide whether to retry a failed run
+
+```python
+from coding_cli_runtime import classify_provider_failure
+
+classification = classify_provider_failure(
+    provider="gemini",
+    stderr_text="429 Resource exhausted: rate limit exceeded",
+)
+
+if classification.retryable:
+    print(f"Retryable ({classification.category}) — will retry")
+else:
+    print(f"Fatal ({classification.category}) — giving up")
+```
+
+Works for all four providers. Recognizes auth failures, rate limits,
+network transients, and other provider-specific error patterns.
+
+## Key types
+
+| Type | Purpose |
+|------|---------|
+| `CliRunRequest` | Command spec: cmd, cwd, env, timeout, stream paths |
+| `CliRunResult` | Result: returncode, stdout/stderr, duration, error code |
+| `ErrorCode` | `none` · `spawn_failed` · `timed_out` · `non_zero_exit` |
+| `ProviderSpec` | Provider catalog entry with models, controls, defaults |
+| `FailureClassification` | Classified error with retryable flag and category |
+
+`run_interactive_session()` manages long-running CLI processes with
+timeout enforcement, process-group cleanup, transcript mirroring, and
+automatic retries. Only `cmd_parts`, `cwd`, `stdin_text`, and `logger` are
+required — observability labels like `job_name` and `phase_tag` default to
+sensible values so external callers don't need to invent them.
+
+## Prerequisites
+
+This package does **not** bundle any CLI binaries or credentials. You must
+install and authenticate the relevant provider CLI yourself before using the
+execution helpers.
+
+## Status
+
+Pre-1.0. API may change between minor versions.
+
+## License
+
+MIT

coding_cli_runtime-0.1.0/pyproject.toml

@@ -0,0 +1,112 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]  # >=77.0.3 required for SPDX license + license-files
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "coding-cli-runtime"
+version = "0.1.0"
+description = "Reusable CLI runtime primitives for provider-backed automation workflows"
+readme = {file = "README.md", content-type = "text/markdown"}
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [
+    {name = "LLM Eval maintainers", email = "llm-eval-maintainers@users.noreply.github.com"},
+]
+dependencies = []
+keywords = [
+    "cli",
+    "runtime",
+    "llm",
+    "automation",
+    "schema-validation",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/pj-ms/llm-eval/tree/main/packages/coding-cli-runtime"
+Repository = "https://github.com/pj-ms/llm-eval"
+Issues = "https://github.com/pj-ms/llm-eval/issues"
+Changelog = "https://github.com/pj-ms/llm-eval/blob/main/packages/coding-cli-runtime/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "build>=1.2.2",
+    "bump-my-version>=0.26.0",
+    "mypy>=1.13.0",
+    "pre-commit>=4.0.0",
+    "pytest==8.3.3",
+    "pytest-cov>=4.0",
+    "ruff>=0.8.0",
+    "setuptools>=77.0.3",
+    "twine>=5.1.1",
+    "wheel",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+coding_cli_runtime = [
+    "py.typed",
+    "copilot_reasoning_baseline.json",
+    "schemas/*.json",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["coding_cli_runtime"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+
+[[tool.mypy.overrides]]
+module = [
+    "coding_cli_runtime.subprocess_runner",
+    "coding_cli_runtime.session_execution",
+]
+disallow_any_generics = false
+disallow_untyped_defs = false
+warn_return_any = false
+
+[tool.bumpversion]
+current_version = "0.1.0"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+commit = true
+tag = true
+tag_name = "coding-cli-runtime-v{new_version}"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "src/coding_cli_runtime/__init__.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'

coding_cli_runtime-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

coding_cli_runtime-0.1.0/src/coding_cli_runtime/__init__.py

@@ -0,0 +1,108 @@
+"""Runtime primitives for orchestrating LLM provider CLIs."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+from .auth import AuthResolution, resolve_auth
+from .codex_cli import CodexExecSpec, build_codex_exec_spec
+from .contracts import (
+    AuthMode,
+    ClaudeReasoningPolicy,
+    CliLaunchSpec,
+    CliRunRequest,
+    CliRunResult,
+    ErrorCode,
+)
+from .failure_classification import FailureClassification, classify_provider_failure
+from .provider_controls import build_model_id, resolve_provider_model_controls
+from .provider_specs import (
+    ChoiceSpec,
+    ControlSpec,
+    ModelSpec,
+    ProviderSpec,
+    get_claude_default_model,
+    get_claude_effort_levels,
+    get_claude_model_candidates,
+    get_claude_output_suffixes,
+    get_claude_permission_modes,
+    get_codex_supported_models,
+    get_copilot_default_model,
+    get_copilot_model_catalog,
+    get_gemini_default_model,
+    get_gemini_model_options,
+    get_provider_spec,
+    list_provider_specs,
+    serialize_provider_specs,
+)
+from .reasoning import resolve_claude_reasoning_policy
+from .redaction import redact_text
+from .schema_validation import SchemaValidationError, load_schema, validate_payload
+from .session_execution import (
+    InteractiveCliRunResult,
+    SessionExecutionTimeoutError,
+    SessionProgressEvent,
+    SessionRetryDecision,
+    TranscriptMirrorStrategy,
+    mirror_session_transcript,
+    run_interactive_session,
+)
+from .session_logs import (
+    claude_project_key,
+    find_claude_session,
+    find_codex_session,
+    normalize_path_str,
+)
+from .subprocess_runner import run_cli_command, run_cli_command_sync
+
+__all__ = [
+    "AuthMode",
+    "AuthResolution",
+    "CliRunRequest",
+    "CliRunResult",
+    "CodexExecSpec",
+    "ChoiceSpec",
+    "ClaudeReasoningPolicy",
+    "CliLaunchSpec",
+    "ControlSpec",
+    "ErrorCode",
+    "FailureClassification",
+    "ModelSpec",
+    "ProviderSpec",
+    "SchemaValidationError",
+    "InteractiveCliRunResult",
+    "SessionProgressEvent",
+    "SessionRetryDecision",
+    "SessionExecutionTimeoutError",
+    "TranscriptMirrorStrategy",
+    "get_claude_default_model",
+    "get_claude_effort_levels",
+    "get_claude_model_candidates",
+    "get_claude_output_suffixes",
+    "get_claude_permission_modes",
+    "get_codex_supported_models",
+    "get_copilot_default_model",
+    "get_copilot_model_catalog",
+    "get_gemini_default_model",
+    "get_gemini_model_options",
+    "get_provider_spec",
+    "list_provider_specs",
+    "build_model_id",
+    "build_codex_exec_spec",
+    "classify_provider_failure",
+    "load_schema",
+    "resolve_auth",
+    "resolve_claude_reasoning_policy",
+    "resolve_provider_model_controls",
+    "redact_text",
+    "claude_project_key",
+    "find_claude_session",
+    "find_codex_session",
+    "normalize_path_str",
+    "mirror_session_transcript",
+    "run_cli_command",
+    "run_cli_command_sync",
+    "run_interactive_session",
+    "serialize_provider_specs",
+    "validate_payload",
+]