Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.3.0] - 2025-12-14

Multi-transport refactor: exec JSONL remains the default, and a new app-server JSON-RPC (stdio) transport is available via transport: {:app_server, conn}
Codex.AppServer connection API plus v2 request wrappers (threads, turns, skills, models, config, review, command exec, feedback, account, MCP)
Stateful approval handling for app-server server-initiated requests (item/*/requestApproval) with both hook-based auto-approval and manual respond/3
Typed event/item adapters for core app-server notifications, with lossless passthrough for unknown methods/items

turn/diff/updated now surfaces diff as a unified diff string (app-server v2)

Quieted mix test output by default (test log capture + console logger level) while keeping logs available on failures
Fixed an ETS race in tool registry resets that could intermittently fail in async tests

examples/run_all.sh defaults to gpt-5.1-codex-mini for consistent runs and reports failures without stopping the whole suite

Exec subprocess env inheritance so codex can use CLI-login auth when no env overrides are provided
Structured output example schema compatibility with codex exec --output-schema, plus clearer example error output
Concurrency example progress output and timeouts to avoid “stuck” runs

Forwarded Codex CLI execution options via Codex.Thread.Options: sandbox mode, working directory, additional writable directories, skip-git-repo-check, web search toggle, approval policy, and workspace-write network access
turn_opts[:clear_env?] to optionally clear inherited subprocess environment when spawning codex

OPENAI_BASE_URL is now set for the codex subprocess from Codex.Options.base_url
Port gap analysis docs updated to reflect the wired Codex CLI surface and erlexec hardening option

auto_previous_response_id run option via Codex.RunConfig (forward-compatible; requires backend response_id support)
last_response_id on Codex.Turn.Result when the backend surfaces a response identifier

README/docs now distinguish Elixir-side OTLP exporting from codex-rs [otel] config.toml exporting

Tool metadata is loaded before registration so hosted tools register under their declared names (e.g. file_search)
Exec CLI arg compatibility: image attachments now use --image, and unsupported --tool-output/--tool-failure flags are no longer emitted

App-server event coverage for token usage deltas, turn diffs, and compaction notices, plus explicit thread/turn IDs on item and error notifications
Streaming example updates to surface live usage and diff events alongside item progress
Automatic auth fallback to Codex CLI login when API keys are absent; live two-turn walkthrough example
Regression tests and fixtures for /new resets, early-exit session non-persistence, and rate-limit/sandbox error normalization
Live usage/compaction streaming example aligned with new model defaults and reasoning effort handling
Live exec controls example (env injection, cancellation tokens, timeout tuning) plus README/docs updates covering safe-command approval bypass
Sandbox warning normalization updates (Windows read-only .git detection, world-writable dedup) and runnable example sandbox_warnings_and_approval_bypass.exs
README/docs refresh covering policy-approved bypass flags and normalized sandbox warning strings
Added examples/live_tooling_stream.exs to showcase streamed MCP/shell events and fallback handling when turn.completed omits a final response
Live telemetry stream example (thread/turn IDs, source metadata, usage deltas, diffs, compaction savings) with README/docs references
Live telemetry stream defaults tuned for fast runs (minimal reasoning, short prompt)

Thread resumption now uses codex exec … resume <thread_id> (no --thread-id flag)
/new clears conversations and early-exit turns do not persist thread IDs, matching upstream CLI
Turn failures normalize rate-limit and sandbox assessment errors into %Codex.Error{}
Telemetry now propagates source info, thread/turn IDs, OTLP mTLS options, and richer token/diff/compaction signals through emitters and OTEL spans

Core Codex thread lifecycle with streaming, resumption, and structured output decoding (Codex.Thread, Codex.Turn.Result, Codex.Events, Codex.Items)
GenServer-backed Codex.Exec process supervision, error handling, and tool invocation pipeline
Approval policies, hook behaviour, registry support, and telemetry events for tooling approvals
File staging registry, attachment helpers, parity fixtures, and harvesting script for Python SDK alignment
Comprehensive telemetry module with OTLP exporter gating, metrics, and approval instrumentation
Mix tasks (mix codex.verify, mix codex.parity), integration tests, and Supertester-powered contract suite
Rich examples and documentation covering approvals, streaming, concurrency, observability, and design dossiers

Refreshed README.md with 0.2.0 usage guide, testing workflow, and observability configuration
Expanded HexDocs configuration to include new guides, design notes, and release documentation
Updated package metadata to ship changelog, examples, and assets with the Hex release

Initial design release.