---
[//]: # (BEGIN SAPLING FOOTER)
* openai#1198
* __->__ openai#1185

Made a mistake here - we were ignoring the settings passed into the
Runner init., and only usig the override settings passed to run()

This pull request adds a new script for docs, which generates missing
`ref/**/*.md` files. The script can be executed when you run `make
build-docs` command. The script does not do:
- overwrite the existing ones
- create files for _XXX.py and `__init__.py`

Note that the title part is generated like `tool_context` to `Tool
Context`. `openai_provider` will be `Openai Provider`, so some of them
needs a little manual work to adjust.

The direct need is to add `tool_context.md` for
openai#1043 but it should
be useful for future maintenance.

Following this guide:
https://github.com/openai/codex/tree/main/.github/actions/codex

Used the wrong action 🤦

Action isn't published yet, so gotta do this

1. **Grammar fix**: Remove duplicate "can" in the sentence about
configuring trace names
2. **Correct default value**: Update "Agent trace" to "Agent workflow"
to match the actual default value in the codebase

Automated update of translated documentation

## Summary
- document `agents.realtime.model` so the RealtimeModel link works
- include the new file in the documentation navigation

## Testing
- `make format`
- `make lint`
- `make mypy`
- `make tests`


------
https://chatgpt.com/codex/tasks/task_i_687fadfee88883219240b56e5abba76a

Automated update of translated documentation

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

## Summary
- Added LiteLLM to the acknowledgements section in README.md
- Recognized LiteLLM as a unified interface for 100+ LLMs, which aligns
with the SDK's provider-agnostic approach

## Test plan
- [x] Verify README renders correctly
- [x] Ensure link to LiteLLM repository is functional

The current script gives

```
Traceback (most recent call last):
  File "/Users/xmxd289/code/openai-agents-python/examples/reasoning_content/main.py", line 19, in <module>
    from agents.types import ResponseOutputRefusal, ResponseOutputText  # type: ignore
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'agents.types'
```

because it should be

`from openai.types.responses import ResponseOutputRefusal,
ResponseOutputText`

rather than

`from agents.types import ResponseOutputRefusal, ResponseOutputText`

---------

Co-authored-by: Michelangelo D'Agostino <mda@grainger.com>

Will need this for a followup.

---
[//]: # (BEGIN SAPLING FOOTER)
* openai#1243
* openai#1242
* __->__ openai#1235

… openai 1.97.1+ (openai#1246)

This pull request resolves openai#1227

…behavior (openai#1233)

The Trace class was using @abc.abstractmethod decorators without
inheriting
from abc.ABC, which meant the abstract methods weren't enforced.

This change makes the class properly abstract while maintaining all
existing functionality
since no code directly instantiates Trace() - all usage goes through the
concrete implementations NoOpTrace and TraceImpl.

Adds LangDB AI Gateway to the External tracing processors list so
developers can stream Agent‑SDK traces directly into LangDB’s
dashboards.

## Highlights

- End‑to‑end observability of every agent step, tool invocation, and
guardrail.
- Access to 350+ LLM models through a single OpenAI‑compatible endpoint.

- Quick integration: `pip install "pylangdb[openai]" `
```python
from pylangdb.openai import init
init()

client = AsyncOpenAI(
    api_key=os.environ["LANGDB_API_KEY"],
    base_url=os.environ["LANGDB_API_BASE_URL"],
    default_headers={"x-project-id": os.environ["LANGDB_PROJECT_ID"]},
)
set_default_openai_client(client)     
```
- Live demo Thread:
https://app.langdb.ai/sharing/threads/53b87631-de7f-431a-a049-48556f899b4d
<img width="1636" height="903" alt="image"
src="https://github.com/user-attachments/assets/075538fb-c1af-48e8-95fd-ff3d729ba37d"
/>

Fixes openai#1222

---------

Co-authored-by: mutahirshah11 <158048266+mutahirshah11@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Automated update of translated documentation

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Updated the error message to replace the placeholder `your_type` with
`YourType`, removing the underscore and adopting PascalCase, which
aligns with standard Python type naming conventions.