stan

Author: tymondesigns

src/Agents/Registry.php

@@ -91,6 +91,9 @@ public function ids(): array
         return array_keys($this->agents);
     }
 
+    /**
+     * @return array<int, array{id: string, name: string, description: string}>
+     */
     public function toArray(): array
     {
         return collect($this->agents)

src/SDK/OpenAI/Data/Responses/Message/OutputText.php

@@ -8,12 +8,19 @@ final class OutputText
 {
     public string $type = 'output_text';
 
+    /**
+     * @param array<string, mixed> $annotations
+     * @param array<string, mixed> $logProbs
+     */
     public function __construct(
         public string $text,
         public array $annotations = [],
         public array $logProbs = [],
     ) {}
 
+    /**
+     * @param array<string, mixed> $payload
+     */
     public static function from(array $payload): self
     {
         return new self(

src/SDK/OpenAI/Data/Responses/Message/Refusal.php

@@ -12,6 +12,9 @@ public function __construct(
         public string $reason,
     ) {}
 
+    /**
+     * @param array<string, mixed> $payload
+     */
     public static function from(array $payload): self
     {
         return new self(

src/SDK/OpenAI/Data/Responses/OutputItems/FunctionToolCallOutputItem.php

@@ -12,6 +12,7 @@ final class FunctionToolCallOutputItem implements OutputItem
 
     /**
      * @param 'in_progress'|'completed'|'incomplete' $status
+     * @param array<string, mixed> $arguments
      */
     public function __construct(
         public string $id,

src/SDK/OpenAI/Data/Responses/OutputItems/MessageOutputItem.php

@@ -16,6 +16,7 @@ final class MessageOutputItem implements OutputItem
 
     /**
      * @param 'in_progress'|'completed'|'incomplete' $status
+     * @param array<int, OutputText|Refusal|ReasoningText> $content
      */
     public function __construct(
         public string $id,
@@ -34,6 +35,9 @@ public static function from(array $payload): self
         );
     }
 
+    /**
+     * @param array<string, mixed> $content
+     */
     public static function mapContent(array $content): OutputText|Refusal
     {
         return match ($content['type']) {

src/SDK/OpenAI/Data/Responses/Reasoning/ReasoningSummaryText.php

@@ -12,6 +12,9 @@ public function __construct(
         public string $text,
     ) {}
 
+    /**
+     * @param array<string, mixed> $payload
+     */
     public static function from(array $payload): self
     {
         return new self(

src/SDK/OpenAI/Data/Responses/Reasoning/ReasoningText.php

@@ -12,6 +12,9 @@ public function __construct(
         public string $text,
     ) {}
 
+    /**
+     * @param array<string, mixed> $payload
+     */
     public static function from(array $payload): self
     {
         return new self(

src/SDK/OpenAI/Data/Responses/Response.php

@@ -21,6 +21,15 @@ final class Response
 
     /**
      * @param array<OutputItem> $output
+     * @param array<string, mixed>|null $error
+     * @param array<string, mixed>|null $incompleteDetails
+     * @param string|array<string, mixed> $instructions
+     * @param array<string, mixed>|null $reasoning
+     * @param array<string, mixed>|null $text
+     * @param string|array<string, mixed>|null $toolChoice
+     * @param array<string, mixed>|null $usage
+     * @param array<string, mixed>|null $metadata
+     * @param array<int|string, mixed> $tools
      */
     public function __construct(
         public string $id,
@@ -99,7 +108,7 @@ public function setMeta(Meta $meta): self
         return $this;
     }
 
-    public function getResponse(): ?self
+    public function getResponse(): ?SaloonResponse
     {
         return $this->response;
     }

src/SDK/OpenAI/Data/Responses/Streaming/Events/Error.php

@@ -8,6 +8,9 @@
 
 final class Error extends AbstractStreamEvent implements StreamEvent
 {
+    /**
+     * @param array<string, mixed> $error
+     */
     public function __construct(
         public array $error,
     ) {}

src/SDK/OpenAI/Data/Responses/Streaming/Events/ResponseCodeInterpreterCallCompleted.php

@@ -8,6 +8,9 @@
 
 final class ResponseCodeInterpreterCallCompleted extends AbstractStreamEvent implements StreamEvent
 {
+    /**
+     * @param array<int|string, mixed> $outputs
+     */
     public function __construct(
         public string $itemId,
         public int $outputIndex,