Add comprehensive Response API streaming support and fix conversation continuity

## Summary
- Added full streaming support for Response API with 40+ event types in ResponseStreamEvent
- Fixed conversation state management by adding `id` field to InputMessage for response tracking
- Implemented ResponseStreamProvider demo showing real-time streaming with conversation history
- Updated README with comprehensive streaming documentation and examples

## Changes
- **Response API Streaming**:
  - Added ResponseStreamEvent enum with all streaming event types
  - Implemented stream event parsing for text deltas, function calls, tool usage, etc.
  - Added support for reasoning summaries, web search, file search events

- **Conversation State Fix**:
  - Added `id` field to InputMessage to support response IDs in conversation history
  - Fixed 400 error when sending follow-up messages with previous assistant responses
  - Simplified assistant message handling in conversation arrays

- **Demo Implementation**:
  - Created ResponseStreamProvider with full streaming capabilities
  - Added ResponseStreamDemoView showing real-time UI updates
  - Implemented message accumulation and conversation state management

- **Documentation**:
  - Added comprehensive streaming section to README
  - Documented all new Response API types and structures
  - Included multiple code examples for various streaming scenarios

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: jamesrochabrun

Examples/SwiftOpenAIExample/SwiftOpenAIExample/OptionsListView.swift

@@ -9,7 +9,7 @@ import SwiftOpenAI
 import SwiftUI
 
 struct OptionsListView: View {
-  
+
   /// https://platform.openai.com/docs/api-reference
   enum APIOption: String, CaseIterable, Identifiable {
     case audio = "Audio"
@@ -31,14 +31,14 @@ struct OptionsListView: View {
     case configureAssistant = "Configure Assistant"
     case realTimeAPI = "Real time API"
     case responseStream = "Response Stream Demo"
-    
+
     var id: String { rawValue }
   }
-  
+
   var openAIService: OpenAIService
-  
+
   var options: [APIOption]
-  
+
   var body: some View {
     List(options, id: \.self, selection: $selection) { option in
       Text(option.rawValue)
@@ -91,7 +91,7 @@ struct OptionsListView: View {
       }
     }
   }
-  
+
   @State private var selection: APIOption? = nil
-  
+
 }

Examples/SwiftOpenAIExample/SwiftOpenAIExample/ResponseAPIDemo/ResponseStreamDemoView.swift

@@ -5,25 +5,24 @@
 //  Created by James Rochabrun on 6/7/25.
 //
 
-import SwiftUI
 import SwiftOpenAI
+import SwiftUI
+
+// MARK: - ResponseStreamDemoView
 
 struct ResponseStreamDemoView: View {
-  
-  @State private var provider: ResponseStreamProvider
-  @State private var inputText = ""
-  @FocusState private var isInputFocused: Bool
-  @Environment(\.colorScheme) var colorScheme
-  
+
   init(service: OpenAIService) {
-    self._provider = State(initialValue: ResponseStreamProvider(service: service))
+    _provider = State(initialValue: ResponseStreamProvider(service: service))
   }
-  
+
+  @Environment(\.colorScheme) var colorScheme
+
   var body: some View {
     VStack(spacing: 0) {
       // Header
       headerView
-      
+
       // Messages
       ScrollViewReader { proxy in
         ScrollView {
@@ -32,7 +31,7 @@ struct ResponseStreamDemoView: View {
               MessageBubbleView(message: message)
                 .id(message.id)
             }
-            
+
             if provider.isStreaming {
               HStack {
                 LoadingIndicatorView()
@@ -50,7 +49,7 @@ struct ResponseStreamDemoView: View {
           }
         }
       }
-      
+
       // Error view
       if let error = provider.error {
         Text(error)
@@ -60,7 +59,7 @@ struct ResponseStreamDemoView: View {
           .padding(.vertical, 8)
           .background(Color.red.opacity(0.1))
       }
-      
+
       // Input area
       inputArea
     }
@@ -75,18 +74,22 @@ struct ResponseStreamDemoView: View {
       }
     }
   }
-  
+
+  @State private var provider: ResponseStreamProvider
+  @State private var inputText = ""
+  @FocusState private var isInputFocused: Bool
+
   // MARK: - Subviews
-  
+
   private var headerView: some View {
     VStack(alignment: .leading, spacing: 8) {
       Text("Streaming Responses with Conversation State")
         .font(.headline)
-      
+
       Text("This demo uses the Responses API with streaming to maintain conversation context across multiple turns.")
         .font(.caption)
         .foregroundColor(.secondary)
-      
+
       if provider.messages.isEmpty {
         Label("Start a conversation below", systemImage: "bubble.left.and.bubble.right")
           .font(.caption)
@@ -98,7 +101,7 @@ struct ResponseStreamDemoView: View {
     .padding()
     .background(Color(UIColor.secondarySystemBackground))
   }
-  
+
   private var inputArea: some View {
     HStack(spacing: 12) {
       TextField("Type a message...", text: $inputText, axis: .vertical)
@@ -109,7 +112,7 @@ struct ResponseStreamDemoView: View {
         .onSubmit {
           sendMessage()
         }
-      
+
       Button(action: sendMessage) {
         Image(systemName: provider.isStreaming ? "stop.circle.fill" : "arrow.up.circle.fill")
           .font(.title2)
@@ -123,15 +126,12 @@ struct ResponseStreamDemoView: View {
       Rectangle()
         .frame(height: 1)
         .foregroundColor(Color(UIColor.separator)),
-      alignment: .top
-    )
+      alignment: .top)
   }
-  
-  // MARK: - Actions
-  
+
   private func sendMessage() {
     guard !inputText.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else { return }
-    
+
     if provider.isStreaming {
       provider.stopStreaming()
     } else {
@@ -142,12 +142,12 @@ struct ResponseStreamDemoView: View {
   }
 }
 
-// MARK: - Message Bubble View
+// MARK: - MessageBubbleView
 
 struct MessageBubbleView: View {
   let message: ResponseStreamProvider.ResponseMessage
   @Environment(\.colorScheme) var colorScheme
-  
+
   var body: some View {
     HStack {
       if message.role == .assistant {
@@ -156,8 +156,7 @@ struct MessageBubbleView: View {
           .cornerRadius(16)
           .overlay(
             RoundedRectangle(cornerRadius: 16)
-              .stroke(borderColor, lineWidth: 1)
-          )
+              .stroke(borderColor, lineWidth: 1))
         Spacer(minLength: 60)
       } else {
         Spacer(minLength: 60)
@@ -168,10 +167,10 @@ struct MessageBubbleView: View {
       }
     }
   }
-  
+
   private var messageContent: some View {
     VStack(alignment: .leading, spacing: 4) {
-      if message.role == .assistant && message.isStreaming {
+      if message.role == .assistant, message.isStreaming {
         HStack(spacing: 4) {
           Image(systemName: "dot.radiowaves.left.and.right")
             .font(.caption2)
@@ -181,12 +180,12 @@ struct MessageBubbleView: View {
             .foregroundColor(.secondary)
         }
       }
-      
+
       Text(message.content.isEmpty && message.isStreaming ? " " : message.content)
         .padding(.horizontal, 12)
         .padding(.vertical, 8)
-      
-      if message.role == .assistant && !message.isStreaming && message.responseId != nil {
+
+      if message.role == .assistant, !message.isStreaming, message.responseId != nil {
         Text("Response ID: \(String(message.responseId?.prefix(8) ?? ""))")
           .font(.caption2)
           .foregroundColor(.secondary)
@@ -195,28 +194,25 @@ struct MessageBubbleView: View {
       }
     }
   }
-  
+
   private var backgroundGradient: some View {
     LinearGradient(
       gradient: Gradient(colors: [
         Color(UIColor.secondarySystemBackground),
-        Color(UIColor.tertiarySystemBackground)
+        Color(UIColor.tertiarySystemBackground),
       ]),
       startPoint: .topLeading,
-      endPoint: .bottomTrailing
-    )
+      endPoint: .bottomTrailing)
   }
-  
+
   private var borderColor: Color {
     colorScheme == .dark ? Color.white.opacity(0.1) : Color.black.opacity(0.1)
   }
 }
 
-// MARK: - Loading Indicator
+// MARK: - LoadingIndicatorView
 
 struct LoadingIndicatorView: View {
-  @State private var animationAmount = 0.0
-  
   var body: some View {
     ZStack {
       ForEach(0..<3) { index in
@@ -231,13 +227,15 @@ struct LoadingIndicatorView: View {
     .onAppear {
       withAnimation(
         .easeInOut(duration: 0.8)
-        .repeatForever(autoreverses: true)
-      ) {
+          .repeatForever(autoreverses: true))
+      {
         animationAmount = 1
       }
     }
   }
-  
+
+  @State private var animationAmount = 0.0
+
   private func animationScale(for index: Int) -> Double {
     let delay = Double(index) * 0.1
     let progress = (animationAmount + delay).truncatingRemainder(dividingBy: 1.0)