Skip to content

Fix 8 Responses API references in unified-llm-spec.md + add Rust exemplar#6

Open
bkrabach wants to merge 1 commit intostrongdm:mainfrom
bkrabach:rust-exemplar-spec-fixes
Open

Fix 8 Responses API references in unified-llm-spec.md + add Rust exemplar#6
bkrabach wants to merge 1 commit intostrongdm:mainfrom
bkrabach:rust-exemplar-spec-fixes

Conversation

@bkrabach
Copy link

Summary

8 places in unified-llm-spec.md where reference tables use Chat Completions API field names but §2.7 mandates the Responses API. The prose sections are already correct — only the reference tables needed updating.

Also adds an Implementations section to README linking to a Rust exemplar.

Spec Fixes

# Section Change
S-1 §7.3 Tool call item: "id""call_id"
S-2 §7.4 Tool definition: nested → flat format
S-3 §3.9 Usage: prompt_tokensinput_tokens, etc.
S-4 §7.8 Tool result: "tool role messages" → function_call_output items
S-5 §7.8 Stream termination: data: [DONE]response.completed event
S-6 §3.8 Finish reasons: Chat Completions → Responses API status field
S-7 §5.3 Named tool choice: nested → flat format
S-8 §7.8 Gemini auth: both query param and header supported

How found

Built a Rust implementation (bkrabach/unified-llm-client-rust) — 12 rounds of adversarial audit, 141/141 DoD, 925 tests (54 live API). Implementation correctly targets the Responses API in all cases; spec tables were the discrepancy.

README

Added Implementations section with link to the Rust exemplar.

…ust exemplar

Spec fixes — 8 places where reference tables used Chat Completions API
field names but §2.7 mandates the Responses API:

S-1: §7.3 tool call item 'id' → 'call_id'
S-2: §7.4 tool definition: nested → flat format
S-3: §3.9 usage fields: prompt_tokens → input_tokens, etc.
S-4: §7.8 tool result: 'tool role messages' → function_call_output items
S-5: §7.8 stream termination: 'data: [DONE]' → response.completed event
S-6: §3.8 finish reasons: Chat Completions → Responses API status field
S-7: §5.3 named tool choice: nested → flat format
S-8: §7.8 Gemini auth: note both query param and header supported

README: Added Implementations section with Rust exemplar link
jaytaylor added a commit to jaytaylor/attractor-tcl that referenced this pull request Mar 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant