Packages

codex_sdk

0.2.4
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 tools mcp_and_shell_tooling.prompt.md
Raw

docs/20251129/tools/mcp_and_shell_tooling.prompt.md 

# Prompt: Update MCP and shell tooling support (TDD)



Required reading:

- docs/20251129/tools/mcp_and_shell_tooling.md

- docs/06-examples.md (tooling examples), docs/05-api-reference.md (tool call schemas)

- lib/codex/tools.ex, lib/codex/tools/registry.ex, lib/codex/exec.ex (tool call execution/registration)

- test/codex/tools_test.exs, test/codex/thread_test.exs (tool call streaming)



Context to carry:

- MCP elicitations are supported; shell-tool-mcp declares capabilities and publishing is fixed.

- Tool calls can include richer arguments/results with streamed output.

- Git branch context and env overrides may be surfaced alongside unified exec.



Instructions (TDD):

1) Read the docs to understand new MCP capability metadata and elicitation handling.

2) Add failing tests for elicitation parsing, capability propagation, and streamed argument/result payloads.

3) Implement registry/protocol updates so tool calls preserve new fields and streams; ensure backwards compatibility.

4) Decide and document whether git branch/env wiring is exposed in SDK APIs; add tests if surfaced.

5) Run targeted tests then `mix test`; keep scope to SDK-facing tooling.