protocol models responses

examples/Responses/Example01_SimpleResponse.cs

@@ -13,11 +13,11 @@ public partial class ResponseExamples
     [Test]
     public void Example01_SimpleResponse()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        OpenAIResponse response = client.CreateResponse("Say 'this is a test.'");
+        ResponseResult response = client.CreateResponse(new ([ResponseItem.CreateUserMessageItem("Say 'this is a test.'")]));
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
     }
 }
 

examples/Responses/Example01_SimpleResponseAsync.cs

@@ -14,11 +14,11 @@ public partial class ResponseExamples
     [Test]
     public async Task Example01_SimpleResponseAsync()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        OpenAIResponse response = await client.CreateResponseAsync("Say 'this is a test.'");
+        ResponseResult response = await client.CreateResponseAsync(new ([ResponseItem.CreateUserMessageItem("Say 'this is a test.'")]));
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
     }
 }
 

examples/Responses/Example02_SimpleResponseStreaming.cs

@@ -14,9 +14,9 @@ public partial class ResponseExamples
     [Test]
     public void Example02_SimpleResponseStreaming()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        CollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreaming("Say 'this is a test.'");
+        CollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreaming(new ([ResponseItem.CreateUserMessageItem("Say 'this is a test.'")]));
 
         Console.Write($"[ASSISTANT]: ");
         foreach (StreamingResponseUpdate update in responseUpdates)

examples/Responses/Example02_SimpleResponseStreamingAsync.cs

@@ -16,9 +16,9 @@ public partial class ResponseExamples
     [Test]
     public async Task Example02_SimpleResponseStreamingAsync()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        AsyncCollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreamingAsync("Say 'this is a test.'");
+        AsyncCollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreamingAsync(new ([ResponseItem.CreateUserMessageItem("Say 'this is a test.'")]));
 
         Console.Write($"[ASSISTANT]: ");
         await foreach (StreamingResponseUpdate update in responseUpdates)

examples/Responses/Example03_FunctionCalling.cs

@@ -62,14 +62,14 @@ private static string GetCurrentWeather(string location, string unit = "celsius"
     [Test]
     public void Example03_FunctionCalling()
     {
-        OpenAIResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         List<ResponseItem> inputItems =
         [
             ResponseItem.CreateUserMessageItem("What's the weather like today for my current location?"),
         ];
 
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new(inputItems)
         {
             Tools = { getCurrentLocationTool, getCurrentWeatherTool },
         };
@@ -81,11 +81,11 @@ public void Example03_FunctionCalling()
         do
         {
             requiresAction = false;
-            OpenAIResponse response = client.CreateResponse(inputItems, options);
+            ResponseResult response = client.CreateResponse(options);
 
-            inputItems.AddRange(response.OutputItems);
+            inputItems.AddRange(response.Output);
 
-            foreach (ResponseItem outputItem in response.OutputItems)
+            foreach (ResponseItem outputItem in response.Output)
             {
                 if (outputItem is FunctionCallResponseItem functionCall)
                 {
@@ -132,7 +132,7 @@ public void Example03_FunctionCalling()
                 }
             }
 
-            PrintMessageItems(response.OutputItems.OfType<MessageResponseItem>());
+            PrintMessageItems(response.Output.OfType<MessageResponseItem>());
 
         } while (requiresAction);
     }

examples/Responses/Example03_FunctionCallingAsync.cs

@@ -19,14 +19,14 @@ public partial class ResponseExamples
     [Test]
     public async Task Example03_FunctionCallingAsync()
     {
-        OpenAIResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         List<ResponseItem> inputItems =
         [
             ResponseItem.CreateUserMessageItem("What's the weather like today for my current location?"),
         ];
 
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new(inputItems)
         {
             Tools = { getCurrentLocationTool, getCurrentWeatherTool },
         };
@@ -38,11 +38,11 @@ public async Task Example03_FunctionCallingAsync()
         do
         {
             requiresAction = false;
-            OpenAIResponse response = await client.CreateResponseAsync(inputItems, options);
+            ResponseResult response = await client.CreateResponseAsync(options);
 
-            inputItems.AddRange(response.OutputItems);
+            inputItems.AddRange(response.Output);
 
-            foreach (ResponseItem outputItem in response.OutputItems)
+            foreach (ResponseItem outputItem in response.Output)
             {
                 if (outputItem is FunctionCallResponseItem functionCall)
                 {
@@ -89,7 +89,7 @@ public async Task Example03_FunctionCallingAsync()
                 }
             }
 
-            PrintMessageItems(response.OutputItems.OfType<MessageResponseItem>());
+            PrintMessageItems(response.Output.OfType<MessageResponseItem>());
 
         } while (requiresAction);
     }

examples/Responses/Example04_FunctionCallingStreaming.cs

@@ -19,14 +19,14 @@ public partial class ResponseExamples
     [Test]
     public void Example04_FunctionCallingStreaming()
     {
-        OpenAIResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         List<ResponseItem> inputItems =
         [
             ResponseItem.CreateUserMessageItem("What's the weather like today for my current location?"),
         ];
 
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new(inputItems)
         {
             Tools = { getCurrentLocationTool, getCurrentWeatherTool },
         };
@@ -38,7 +38,7 @@ public void Example04_FunctionCallingStreaming()
         do
         {
             requiresAction = false;
-            CollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreaming(inputItems, options);
+            CollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreaming(options);
 
             foreach (StreamingResponseUpdate update in responseUpdates)
             {

examples/Responses/Example04_FunctionCallingStreamingAsync.cs

@@ -20,14 +20,14 @@ public partial class ResponseExamples
     [Test]
     public async Task Example04_FunctionCallingStreamingAsync()
     {
-        OpenAIResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new("gpt-5", Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         List<ResponseItem> inputItems =
         [
             ResponseItem.CreateUserMessageItem("What's the weather like today for my current location?"),
         ];
 
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new(inputItems)
         {
             Tools = { getCurrentLocationTool, getCurrentWeatherTool },
         };
@@ -39,7 +39,7 @@ public async Task Example04_FunctionCallingStreamingAsync()
         do
         {
             requiresAction = false;
-            AsyncCollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreamingAsync(inputItems, options);
+            AsyncCollectionResult<StreamingResponseUpdate> responseUpdates = client.CreateResponseStreamingAsync(options);
 
             await foreach (StreamingResponseUpdate update in responseUpdates)
             {

examples/Responses/Example05_RemoteMcp.cs

@@ -13,7 +13,9 @@ public partial class ResponseExamples
     [Test]
     public void Example05_RemoteMcp()
     {
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("Roll 2d4+1")
+        ])
         {
             Tools = {
                 new McpTool(serverLabel: "dmcp", serverUri: new Uri("https://dmcp-server.deno.dev/sse"))
@@ -24,11 +26,11 @@ public void Example05_RemoteMcp()
             }
         };
 
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        OpenAIResponse response = client.CreateResponse("Roll 2d4+1", options);
+        ResponseResult response = client.CreateResponse(options);
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
     }
 }
 

examples/Responses/Example05_RemoteMcpAsync.cs

@@ -14,7 +14,9 @@ public partial class ResponseExamples
     [Test]
     public async Task Example05_RemoteMcpAsync()
     {
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("Roll 2d4+1")
+        ])
         {
             Tools = {
                 new McpTool(serverLabel: "dmcp", serverUri: new Uri("https://dmcp-server.deno.dev/sse"))
@@ -25,11 +27,11 @@ public async Task Example05_RemoteMcpAsync()
             }
         };
 
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        OpenAIResponse response = await client.CreateResponseAsync("Roll 2d4+1", options);
+        ResponseResult response = await client.CreateResponseAsync(options);
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
     }
 }
 

examples/Responses/Example06_RemoteMcpAuthentication.cs

@@ -13,7 +13,8 @@ public partial class ResponseExamples
     [Test]
     public void Example06_RemoteMcpAuthentication()
     {
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("Create a payment link for $20")])
         {
             Tools = {
                 new McpTool(serverLabel: "stripe", serverUri: new Uri("https://mcp.stripe.com"))
@@ -23,11 +24,11 @@ public void Example06_RemoteMcpAuthentication()
             }
         };
 
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        OpenAIResponse response = client.CreateResponse("Create a payment link for $20", options);
+        ResponseResult response = client.CreateResponse(options);
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
     }
 }
 

examples/Responses/Example06_RemoteMcpAuthenticationAsync.cs

@@ -14,7 +14,9 @@ public partial class ResponseExamples
     [Test]
     public async Task Example06_RemoteMcpAuthenticationAsync()
     {
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("Create a payment link for $20")
+        ])
         {
             Tools = {
                 new McpTool(serverLabel: "stripe", serverUri: new Uri("https://mcp.stripe.com"))
@@ -24,11 +26,11 @@ public async Task Example06_RemoteMcpAuthenticationAsync()
             }
         };
 
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        OpenAIResponse response = await client.CreateResponseAsync("Create a payment link for $20", options);
+        ResponseResult response = await client.CreateResponseAsync(options);
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
     }
 }
 

examples/Responses/Example07_InputAdditionalProperties.cs

@@ -14,18 +14,20 @@ public partial class ResponseExamples
     [Test]
     public void Example07_InputAdditionalProperties()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         // Add extra request fields using Patch.
-        // Patch lets you set fields like `reasoning.effort` and `text.verbosity` that aren’t modeled on ResponseCreationOptions in the request payload.
+        // Patch lets you set fields like `reasoning.effort` and `text.verbosity` that aren’t modeled on CreateResponseOptions in the request payload.
         // See the API docs https://platform.openai.com/docs/api-reference/responses/create for supported additional fields.
-        ResponseCreationOptions options = new();
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("What is the answer to the ultimate question of life, the universe, and everything?")
+        ]);
         options.Patch.Set("$.reasoning.effort"u8, "high");
         options.Patch.Set("$.text.verbosity"u8, "medium");
 
-        OpenAIResponse response = client.CreateResponse("What is the answer to the ultimate question of life, the universe, and everything?", options);
+        ResponseResult response = client.CreateResponse(options);
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
 
         // Read extra fields from the response via Patch.
         // The service returns fields like `reasoning.effort` and `text.verbosity` that aren’t modeled on OpenAIResponse.

examples/Responses/Example07_InputAdditionalPropertiesAsync.cs

@@ -15,18 +15,20 @@ public partial class ResponseExamples
     [Test]
     public async Task Example07_InputAdditionalPropertiesAsync()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
         // Add extra request fields using Patch.
-        // Patch lets you set fields like `reasoning.effort` and `text.verbosity` that aren’t modeled on ResponseCreationOptions in the request payload.
+        // Patch lets you set fields like `reasoning.effort` and `text.verbosity` that aren’t modeled on CreateResponseOptions in the request payload.
         // See the API docs https://platform.openai.com/docs/api-reference/responses/create for supported additional fields.
-        ResponseCreationOptions options = new();
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("What is the answer to the ultimate question of life, the universe, and everything?")
+        ]);
         options.Patch.Set("$.reasoning.effort"u8, "high");
         options.Patch.Set("$.text.verbosity"u8, "medium");
 
-        OpenAIResponse response = await client.CreateResponseAsync("What is the answer to the ultimate question of life, the universe, and everything?", options);
+        ResponseResult response = await client.CreateResponseAsync(options);
 
-        Console.WriteLine($"[ASSISTANT]: {response.GetOutputText()}");
+        Console.WriteLine($"[ASSISTANT]: {response.OutputText}");
 
         // Read extra fields from the response via Patch.
         // The service returns fields like `reasoning.effort` and `text.verbosity` that aren’t modeled on OpenAIResponse.

examples/Responses/Example08_OutputAdditionalProperties.cs

@@ -15,9 +15,11 @@ public partial class ResponseExamples
     [Test]
     public void Example08_OutputAdditionalProperties()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("Generate an image of gray tabby cat hugging an otter with an orange scarf")
+        ])
         {
             Tools =
             {
@@ -28,8 +30,8 @@ public void Example08_OutputAdditionalProperties()
             }
         };
 
-        OpenAIResponse response = client.CreateResponse("Generate an image of gray tabby cat hugging an otter with an orange scarf", options);
-        ImageGenerationCallResponseItem imageGenResponse = (ImageGenerationCallResponseItem)response.OutputItems[1];
+        ResponseResult response = client.CreateResponse(options);
+        ImageGenerationCallResponseItem imageGenResponse = (ImageGenerationCallResponseItem)response.Output[1];
         BinaryData bytes = imageGenResponse.ImageResultBytes;
 
         using FileStream stream = File.OpenWrite($"{Guid.NewGuid()}.png");

examples/Responses/Example08_OutputAdditionalPropertiesAsync.cs

@@ -16,9 +16,11 @@ public partial class ResponseExamples
     [Test]
     public async Task Example08_OutputAdditionalPropertiesAsync()
     {
-        OpenAIResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
+        ResponseClient client = new(model: "gpt-5", apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY"));
 
-        ResponseCreationOptions options = new()
+        CreateResponseOptions options = new([
+            ResponseItem.CreateUserMessageItem("Generate an image of gray tabby cat hugging an otter with an orange scarf")
+        ])
         {
             Tools =
             {
@@ -29,8 +31,8 @@ public async Task Example08_OutputAdditionalPropertiesAsync()
             }
         };
 
-        OpenAIResponse response = await client.CreateResponseAsync("Generate an image of gray tabby cat hugging an otter with an orange scarf", options);
-        ImageGenerationCallResponseItem imageGenResponse = (ImageGenerationCallResponseItem)response.OutputItems[1];
+        ResponseResult response = await client.CreateResponseAsync(options);
+        ImageGenerationCallResponseItem imageGenResponse = (ImageGenerationCallResponseItem)response.Output[1];
         BinaryData bytes = imageGenResponse.ImageResultBytes;
 
         using FileStream stream = File.OpenWrite($"{Guid.NewGuid()}.png");