Add support for Responses API

src/Client.php

@@ -21,6 +21,7 @@
 use OpenAI\Resources\Images;
 use OpenAI\Resources\Models;
 use OpenAI\Resources\Moderations;
+use OpenAI\Resources\Responses;
 use OpenAI\Resources\Threads;
 use OpenAI\Resources\VectorStores;
 
@@ -34,6 +35,16 @@ public function __construct(private readonly TransporterContract $transporter)
         // ..
     }
 
+        /**
+     * Manage responses to assist models with tasks.
+     *
+     * @see https://platform.openai.com/docs/api-reference/responses
+     */
+    public function responses(): Responses
+    {
+        return new Responses($this->transporter);
+    }
+
     /**
      * Given a prompt, the model will return one or more predicted completions, and can also return the probabilities
      * of alternative tokens at each position.
@@ -186,4 +197,5 @@ public function vectorStores(): VectorStoresContract
     {
         return new VectorStores($this->transporter);
     }
+
 }

src/CreateResponse.php

@@ -0,0 +1,151 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenAI\Responses\Responses;
+
+use OpenAI\Contracts\ResponseContract;
+use OpenAI\Responses\Concerns\ArrayAccessible;
+use OpenAI\Responses\Concerns\HasMetaInformation;
+use OpenAI\Contracts\ResponseHasMetaInformationContract;
+use OpenAI\Contracts\StringableContract;
+use OpenAI\Testing\Responses\Concerns\Fakeable;
+
+/**
+ * @implements ResponseContract<array{id: string, object: string, created_at: int, status: string, error: ?array<string, mixed>, incomplete_details: ?array<string, mixed>, instructions: ?string, max_output_tokens: ?int, model: string, output: array<int, array{type: string, id: string, status: string, role: string, content: array<int, array{type: string, text: string, annotations: array<mixed>}>}>, parallel_tool_calls: bool, previous_response_id: ?string, reasoning: array<string, mixed>, store: bool, temperature: ?float, text: array{format: array{type: string}},  tools: array<mixed>, top_p: ?float, truncation: string, usage: array{input_tokens: int, input_tokens_details: array<string, int>, output_tokens: int, output_tokens_details: array<string, int>, total_tokens: int}, user: ?string, metadata: array<string, string>}>
+ */
+final class CreateResponse implements ResponseContract, ResponseHasMetaInformationContract, StringableContract
+{
+    use ArrayAccessible;
+
+    use Fakeable;
+    use HasMetaInformation;
+
+    private function __construct(
+        /**
+         * The response id.
+         */
+        public readonly string $id,
+
+        /**
+         * The object type, which is always response.
+         */
+        public readonly string $object,
+
+        /**
+         * The Unix timestamp (in seconds) when the response was created.
+         */
+        public readonly int $createdAt,
+
+        /**
+         * The status of the response.
+         */
+        public readonly string $status,
+
+        /**
+         * The model used for response.
+         */
+        public readonly string $model,
+
+        /**
+         * The output of the response.
+         *
+         * @var array<int, array{type: string, id: string, status: string, role: string, content: array<int, array{type: string, text: string, annotations: array<mixed>}>}>
+         */
+        public readonly array $output,
+
+        /**
+         * Set of 16 key-value pairs that can be attached to the object.
+         * This can be useful for storing additional information about the object in a structured format.
+         */
+        public readonly array $metadata,
+
+        /**
+         * The input for the response.
+         *
+         * @var string|array
+         */
+        public readonly string|array $input = [],
+
+        public readonly ?array $error = null,
+        public readonly ?array $incompleteDetails = null,
+        public readonly ?string $instructions = null,
+        public readonly ?int $maxOutputTokens = null,
+        public readonly bool $parallelToolCalls = false,
+        public readonly ?string $previousResponseId = null,
+    ) {
+    }
+
+    /**
+     * @param array{id: string, object: string, created_at: int, status: string, error: ?array<string, mixed>, incomplete_details: ?array<string, mixed>, instructions: ?string, max_output_tokens: ?int, model: string, output: array<int, array{type: string, id: string, status: string, role: string, content: array<int, array{type: string, text: string, annotations: array<mixed>}>}>, parallel_tool_calls: bool, previous_response_id: ?string, reasoning: array<string, mixed>, store: bool, temperature: ?float, text: array{format: array{type: string}}, tools: array<mixed>, top_p: ?float, truncation: string, usage: array{input_tokens: int, input_tokens_details: array<string, int>, output_tokens: int, output_tokens_details: array<string, int>, total_tokens: int}, user: ?string, metadata: array<string, string>} $attributes
+     */
+    public static function from(array $attributes, array $meta): self
+    {
+
+        return new self(
+            $attributes['id'],
+            $attributes['object'],
+            $attributes['created_at'],
+            $attributes['status'],
+            $attributes['model'],
+            $attributes['output'],
+            $attributes['metadata'] ?? [],
+            $attributes['input'] ?? [],
+            $attributes['error'] ?? null,
+            $attributes['incomplete_details'] ?? null,
+            $attributes['instructions'] ?? null,
+            $attributes['max_output_tokens'] ?? null,
+            $attributes['parallel_tool_calls'] ?? false,
+            $attributes['previous_response_id'] ?? null,
+            $attributes['reasoning'] ?? [],
+            $attributes['store'] ?? false,
+            $attributes['temperature'] ?? null,
+            $attributes['text'] ?? [],
+            $attributes['tools'] ?? [],
+            $attributes['top_p'] ?? null,
+            $attributes['truncation'] ?? 'disabled',
+            $attributes['usage'] ?? null,
+            $attributes['user'] ?? null,
+        );
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toString(): string
+    {
+        return $this->id;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id,
+            'object' => $this->object,
+            'created_at' => $this->createdAt,
+            'status' => $this->status,
+            'model' => $this->model,
+            'output' => $this->output,
+            'metadata' => $this->metadata,
+            'input' => $this->input,
+            'error' => $this->error,
+            'incomplete_details' => $this->incompleteDetails,
+            'instructions' => $this->instructions,
+            'max_output_tokens' => $this->maxOutputTokens,
+            'parallel_tool_calls' => $this->parallelToolCalls,
+            'previous_response_id' => $this->previousResponseId,
+            'reasoning' => $this->reasoning,
+            'store' => $this->store,
+            'temperature' => $this->temperature,
+            'text' => $this->text,
+            'tools' => $this->tools,
+            'top_p' => $this->topP,
+            'truncation' => $this->truncation,
+            'usage' => $this->usage,
+            'user' => $this->user,
+        ];
+    }
+}

src/CreateStreamedResponse.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenAI\Responses\Responses;
+
+use OpenAI\Contracts\ResponseStreamContract;
+use OpenAI\Responses\StreamResponse;
+use OpenAI\Testing\Resources\Responses;
+use Psr\Http\Message\ResponseInterface;
+use OpenAI\Responses\Responses\PartialResponses\CreatedPartialResponse;
+
+/**
+ * @implements ResponseStreamContract<CreatedPartialResponse>
+ */
+final class CreateStreamedResponse extends StreamResponse implements ResponseStreamContract
+{
+    protected static function partialResponseClass(): string
+    {
+        return CreatedPartialResponse::class;
+    }
+
+    /**
+     * @return \Generator<CreatedPartialResponse>
+     */
+    public static function fromResponse(ResponseInterface $response): \Generator
+    {
+        foreach (self::decodeStream($response) as $line) {
+            yield CreatedPartialResponse::from(json_decode($line, true, 512, JSON_THROW_ON_ERROR), []);
+        }
+    }
+
+    /**
+     * @param  callable(CreatedPartialResponse): void  $callback
+     */
+    public static function stream(ResponseInterface $response, callable $callback): void
+    {
+        foreach (self::decodeStream($response) as $line) {
+            $callback(CreatedPartialResponse::from(json_decode($line, true, 512, JSON_THROW_ON_ERROR), []));
+        }
+    }
+}

src/Data.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenAI\Responses\Responses\Input;
+
+use OpenAI\Contracts\ResponseContract;
+use OpenAI\Responses\Concerns\ArrayAccessible;
+use OpenAI\Responses\Concerns\HasMetaInformation;
+use OpenAI\Contracts\ResponseHasMetaInformationContract;
+use OpenAI\Contracts\StringableContract;
+
+/**
+ * @implements ResponseContract<array{id: string, object: string, content: string}>
+ */
+final class Data implements ResponseContract, ResponseHasMetaInformationContract, StringableContract
+{
+    use ArrayAccessible;
+    use HasMetaInformation;
+
+    private function __construct(
+        /**
+         * The input id.
+         */
+        public readonly string $id,
+
+        /**
+         * The object type, which is always input.
+         */
+        public readonly string $object,
+
+        /**
+         * The content of the input.
+         */
+        public readonly string $content,
+    ) {
+    }
+
+    /**
+     * @param  array{id: string, object: string, content: string}  $attributes
+     */
+    public static function from(array $attributes, array $meta): self
+    {
+        return new self(
+            $attributes['id'],
+            $attributes['object'],
+            $attributes['content'],
+        );
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toString(): string
+    {
+        return $this->id;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id,
+            'object' => $this->object,
+            'content' => $this->content,
+        ];
+    }
+}

src/DeleteResponse.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenAI\Responses\Responses;
+
+use OpenAI\Contracts\ResponseContract;
+use OpenAI\Responses\Concerns\ArrayAccessible;
+use OpenAI\Responses\Concerns\HasMetaInformation;
+use OpenAI\Contracts\ResponseHasMetaInformationContract;
+use OpenAI\Contracts\StringableContract;
+
+/**
+ * @implements ResponseContract<array{id: string, object: string, deleted: bool}>
+ */
+final class DeleteResponse implements ResponseContract, ResponseHasMetaInformationContract, StringableContract
+{
+    use ArrayAccessible;
+    use HasMetaInformation;
+
+    private function __construct(
+        /**
+         * The response id.
+         */
+        public readonly string $id,
+
+        /**
+         * The object type, which is always response.
+         */
+        public readonly string $object,
+
+        /**
+         * Whether the response was successfully deleted.
+         */
+        public readonly bool $deleted,
+    ) {
+    }
+
+    /**
+     * @param array{id: string, object: string, deleted: bool} $attributes
+     */
+    public static function from(array $attributes, array $meta): self
+    {
+        return new self(
+            $attributes['id'],
+            $attributes['object'],
+            $attributes['deleted'],
+            $meta,
+        );
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toString(): string
+    {
+        return $this->id;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toArray(): array
+    {
+        return [
+            'id' => $this->id,
+            'object' => $this->object,
+            'deleted' => $this->deleted,
+        ];
+    }
+}