litellm/docs/adrs/AGENTS.md
devin-ai-integration[bot] b1b5d16f0b
docs(adrs): add ADRs for the Python SDK and proxy, starting with provider usage extras (#36668)
* docs(adr): add architecture decision records, starting with provider usage extras transport

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* docs(adrs): correct where provider usage extras survive and scope the live proof bar to runtime changes

* docs(adrs): say which chat transforms keep unknown usage keys and where a new field is passed

* docs(adrs): correct ADR 001's account of the xAI billing PR, date its code facts, and move the billing recipe to CONTRIBUTING.md

* docs(adrs): say the stream builder carries Anthropic's inference_geo by name and drops other extras

* docs(adrs): cover /v1/messages, the cost_per_token arm, and the Gemini tier side channel in the usage-field ADR and contribution guide

* docs(adrs): decide that usage extras reach callers and shared paths copy them, scope out provider-reported cost, and fix the proof steps

---------

Co-authored-by: mateo <mateo@berri.ai>
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: mateo-berri <277851410+mateo-berri@users.noreply.github.com>
2026-10-28 21:09:04 -07:00

833 B

Architecture decision records for the Python SDK and proxy

This folder records decisions about the Python SDK and proxy the way litellm-rust/docs/adrs/ records them for the Rust core, and that file's process applies here unchanged: one short adr_NNN_short_title.md per decision that is hard to reverse or that a new contributor would reasonably question, with Context, Decision, Alternatives Considered, and Consequences, superseded by a new ADR instead of edited once accepted. Each folder numbers its own ADRs, so a reference to an ADR in the other folder names its path

Read the ADRs here before you build a new way to move data between the endpoints, the provider transformations, and cost tracking or logging. A PR that makes a decision of that kind adds its ADR in the same PR