@@ -0,0 +1,166 @@
1+package provider
2+
3+import (
4+ "encoding/json"
5+ "strings"
6+
7+ "github.com/rs/zerolog/log"
8+ openai "github.com/sashabaranov/go-openai"
9+)
10+
11+// OpenAI-compliant response types for providers that follow OpenAI Chat Completions API spec.
12+// These types should NOT include provider-specific extensions.
13+
14+type openaiChatResponse struct {
15+ Choices []openaiChatChoice `json:"choices"`
16+}
17+
18+type openaiChatChoice struct {
19+ Message openaiChatMessage `json:"message"`
20+}
21+
22+type openaiChatMessage struct {
23+ Role string `json:"role"`
24+ Content string `json:"content"`
25+ ToolCalls []openaiChatToolCall `json:"tool_calls,omitempty"`
26+}
27+
28+type openaiChatToolCall struct {
29+ ID string `json:"id"`
30+ Type string `json:"type"`
31+ Function openaiChatFunction `json:"function"`
32+}
33+
34+type openaiChatFunction struct {
35+ Name string `json:"name"`
36+ Arguments string `json:"arguments"`
37+}
38+
39+// toOpenAIMessages converts provider-agnostic messages to OpenAI SDK message format.
40+// This function enforces OpenAI Chat Completions API requirements:
41+// - System messages must be first
42+// - User and assistant messages must alternate (as much as possible)
43+// - Tool messages must have tool_call_id and follow assistant messages with tool calls
44+func toOpenAIMessages(messages []Message) []openai.ChatCompletionMessage {
45+ result := make([]openai.ChatCompletionMessage, len(messages))
46+ for i, m := range messages {
47+ msg := openai.ChatCompletionMessage{
48+ Role: m.Role,
49+ Content: m.Content,
50+ }
51+
52+ // Handle tool call results
53+ if m.ToolCallID != "" {
54+ msg.ToolCallID = m.ToolCallID
55+ }
56+
57+ // Handle assistant messages with tool calls
58+ if len(m.ToolCalls) > 0 {
59+ msg.ToolCalls = make([]openai.ToolCall, len(m.ToolCalls))
60+ for j, tc := range m.ToolCalls {
61+ msg.ToolCalls[j] = openai.ToolCall{
62+ ID: tc.ID,
63+ Type: openai.ToolTypeFunction,
64+ Function: openai.FunctionCall{
65+ Name: tc.Name,
66+ Arguments: string(tc.Arguments),
67+ },
68+ }
69+ }
70+ }
71+
72+ result[i] = msg
73+ }
74+ return result
75+}
76+
77+// mergeSystemMessagesOpenAI merges all system messages into a single message at the start.
78+// OpenAI Chat Completions API requires:
79+// 1. System messages must be first
80+// 2. At least one non-system message must follow
81+//
82+// This function collects ALL system messages regardless of position and places them
83+// at the start as a single merged message. If only system messages exist, it adds
84+// a minimal "Begin." user message to meet OpenAI requirements.
85+func mergeSystemMessagesOpenAI(messages []openai.ChatCompletionMessage) []openai.ChatCompletionMessage {
86+ if len(messages) == 0 {
87+ return messages
88+ }
89+
90+ // Separate system messages from others
91+ var systemBuffer strings.Builder
92+ nonSystemMessages := make([]openai.ChatCompletionMessage, 0, len(messages))
93+
94+ for _, msg := range messages {
95+ if msg.Role == "system" {
96+ if systemBuffer.Len() > 0 {
97+ systemBuffer.WriteString("\n\n")
98+ }
99+ systemBuffer.WriteString(msg.Content)
100+ } else {
101+ nonSystemMessages = append(nonSystemMessages, msg)
102+ }
103+ }
104+
105+ // Build result: system first, then non-system
106+ result := make([]openai.ChatCompletionMessage, 0, len(messages))
107+
108+ if systemBuffer.Len() > 0 {
109+ result = append(result, openai.ChatCompletionMessage{
110+ Role: "system",
111+ Content: systemBuffer.String(),
112+ })
113+ }
114+
115+ result = append(result, nonSystemMessages...)
116+
117+ // OpenAI requires at least one non-system message
118+ // If we only have system messages, add a minimal user message
119+ if len(nonSystemMessages) == 0 && len(result) > 0 {
120+ log.Debug().
121+ Msg("OpenAI: Only system messages present, adding minimal user message")
122+ result = append(result, openai.ChatCompletionMessage{
123+ Role: "user",
124+ Content: "Begin.",
125+ })
126+ }
127+
128+ log.Debug().
129+ Int("original_count", len(messages)).
130+ Int("merged_count", len(result)).
131+ Bool("added_user_msg", len(nonSystemMessages) == 0 && len(result) > 0).
132+ Msg("OpenAI: Merged system messages")
133+
134+ return result
135+}
136+
137+// toOpenAITools converts provider-agnostic tools to OpenAI SDK tool format.
138+// Returns error if any tool has invalid JSON schema.
139+func toOpenAITools(tools []Tool) ([]openai.Tool, error) {
140+ result := make([]openai.Tool, len(tools))
141+ for i, t := range tools {
142+ var params map[string]interface{}
143+ if len(t.Parameters) > 0 {
144+ if err := json.Unmarshal(t.Parameters, ¶ms); err != nil {
145+ // Invalid JSON schema - return error instead of silently failing
146+ return nil, err
147+ }
148+ }
149+ if params == nil {
150+ params = map[string]interface{}{
151+ "type": "object",
152+ "properties": map[string]interface{}{},
153+ }
154+ }
155+
156+ result[i] = openai.Tool{
157+ Type: openai.ToolTypeFunction,
158+ Function: &openai.FunctionDefinition{
159+ Name: t.Name,
160+ Description: t.Description,
161+ Parameters: params,
162+ },
163+ }
164+ }
165+ return result, nil
166+}