Packages

codex_sdk

0.4.1
0.17.0 0.16.1 0.16.0 0.14.0 0.13.0 0.12.0 0.11.0 0.10.1 0.10.0 0.9.0 0.8.0 0.7.2 0.7.1 0.7.0 0.6.0 0.5.0 0.4.5 0.4.4 0.4.3 0.4.2 0.4.1 0.4.0 0.3.0 0.2.5 0.2.4 0.2.3 0.2.2 0.2.1 0.2.0 0.1.0

Idiomatic Elixir SDK for OpenAI's Codex agent. Provides a complete, production-ready interface with streaming support, comprehensive event handling, and robust testing utilities.

HexDocs

Current section

Files

Jump to
Readme
30 Versions
6 Dependencies
Dependants
Files
Activity
codex_sdk docs 20251129 auth auth_and_sessions.md
Raw

docs/20251129/auth/auth_and_sessions.md 

# Auth, account, and session handling notes for the Elixir SDK



Upstream changes:

- Enterprises can skip upgrade checks/messages; rollout session initialization errors were clarified.

- Conversations are dropped when invoking `/new`, and early-exit sessions are no longer persisted.

- Regression fixes landed for experimental sandbox command assessment and Azure/OpenAI rate-limit handling.



SDK impact:

- If the SDK mirrors the CLI conversation lifecycle, ensure `/new` semantics and early-exit handling match upstream.

- Auth/storage flows may surface fewer upgrade prompts; document any divergence if the SDK keeps older behavior.

- Rate-limit and sandbox assessment changes may alter error shapes; update parsers accordingly.



Action items:

- Align conversation/session reset behavior with upstream before releasing the next SDK cut.

- Verify auth prompts and rate-limit error parsing in integration tests.

- Note the skipped-upgrade behavior in release notes if it affects embedded CLI usage.



SDK divergence callout:

- The Elixir SDK currently shells out to the embedded `codex` binary without an explicit flag to suppress upgrade prompts. If upstream exposes a stable toggle for enterprise rollouts, thread the option through `Codex.Options`/`Codex.Exec` and update release notes accordingly.