From Chat Completions to Responses: AI API Bridge notes

I published the first technical note in the AI API Bridge series for VibeAround.

It compares OpenAI Chat Completions and Responses structurally, and explains what has to be preserved when building a bridge between them.

Gist: https://gist.github.com/jazzenchen/46b2a5301fb5b6d6dce312b2272d7d8f

The short version: Chat Completions is message-centered, while Responses is item-centered. Plain text and ordinary function calling can be mapped fairly directly, but server-side state, hosted/internal tools, reasoning items, multi-item outputs, and streaming events need explicit handling. For coding-agent use cases, the practical first step is usually a stateless bridge that carries full context and keeps the function-tool loop intact.