stan

Author: tymondesigns

.cursor/commands/fix-stan.md

@@ -1 +1 @@
-Use `composer stan --no-progress` to see the PHPStan failures, and then fix them.
+Use `composer stan --no-progress` to see the PHPStan failures, and then fix them. Do not ignore failures unless they are truly impossible to fix.

phpstan.dist.neon

@@ -3,6 +3,5 @@ parameters:
   paths:
     - src
   excludePaths:
-    - src/LLM/Drivers/Anthropic/AnthropicChat.php
     - src/LLM/Streaming
   tmpDir: .phpstan-cache

src/LLM/Drivers/Anthropic/AnthropicChat.php

@@ -207,6 +207,9 @@ protected function buildParams(array $additionalParameters): array
         ];
     }
 
+    /**
+     * @param array<string, mixed> $responses
+     */
     public static function fake(
         array $responses,
         ?string $apiKey = null,

src/LLM/Drivers/Anthropic/Concerns/MapStreamResponse.php

@@ -92,7 +92,7 @@ protected function mapStreamResponse(MessageStream $response): ChatStreamResult
                             usage: $usage,
                         ),
                     ),
-                    createdAt: $meta?->createdAt ?? new DateTimeImmutable(),
+                    createdAt: $meta->createdAt ?? new DateTimeImmutable(),
                     finishReason: $finishReason,
                     usage: $usage,
                     contentSoFar: $contentSoFar,

src/LLM/Drivers/Anthropic/Concerns/MapsResponse.php

@@ -31,8 +31,11 @@ protected function mapResponse(MessageResponse $message): ChatResult
         $finishReason = $this->mapFinishReason($message->stopReason);
         $meta = $message->getMeta();
 
-        $toolCalls = collect($message->content)
-            ->filter(fn(object $content): bool => $content instanceof ToolUseContentBlock)
+        /** @var \Illuminate\Support\Collection<int, \Cortex\SDK\Anthropic\Contracts\ContentBlock> $contentCollection */
+        $contentCollection = collect($message->content);
+        /** @var \Illuminate\Support\Collection<int, ToolUseContentBlock> $toolUseBlocks */
+        $toolUseBlocks = $contentCollection->filter(fn(object $content): bool => $content instanceof ToolUseContentBlock);
+        $toolCalls = $toolUseBlocks
             ->map(function (ToolUseContentBlock $content): ToolCall {
                 return new ToolCall(
                     $content->id,
@@ -56,11 +59,11 @@ protected function mapResponse(MessageResponse $message): ChatResult
                     finishReason: $finishReason,
                     usage: $usage,
                     processingTime: $meta?->processingTime,
-                    providerMetadata: $meta?->raw ?? [],
+                    providerMetadata: $meta->raw ?? [],
                 ),
                 id: $message->id,
             ),
-            createdAt: $meta?->createdAt ?? new DateTimeImmutable(),
+            createdAt: $meta->createdAt ?? new DateTimeImmutable(),
             finishReason: $finishReason,
         );
 
@@ -78,6 +81,11 @@ protected function mapResponse(MessageResponse $message): ChatResult
         );
     }
 
+    /**
+     * @param array<int, \Cortex\SDK\Anthropic\Contracts\ContentBlock> $content
+     *
+     * @return array<int, \Cortex\LLM\Data\Messages\Content\TextContent|\Cortex\LLM\Data\Messages\Content\ReasoningContent>
+     */
     protected function mapContent(array $content): array
     {
         return collect($content)

src/SDK/Anthropic/Contracts/StreamEvent.php

@@ -8,8 +8,14 @@
 
 interface StreamEvent
 {
+    /**
+     * @param array<string, mixed> $payload
+     */
     public static function from(array $payload): self;
 
+    /**
+     * @return array<string, mixed>
+     */
     public function raw(): array;
 
     public function meta(): ?Meta;

src/SDK/Anthropic/Data/Messages/ContentBlocks/ServerToolUseContentBlock.php

@@ -10,6 +10,9 @@ final class ServerToolUseContentBlock implements ContentBlock
 {
     public string $type = 'server_tool_use';
 
+    /**
+     * @param array<string, mixed> $input
+     */
     public function __construct(
         public string $id,
         public string $name,

src/SDK/Anthropic/Data/Messages/ContentBlocks/ToolUseContentBlock.php

@@ -10,6 +10,9 @@ final class ToolUseContentBlock implements ContentBlock
 {
     public string $type = 'tool_use';
 
+    /**
+     * @param array<string, mixed> $input
+     */
     public function __construct(
         public string $id,
         public string $name,

src/SDK/Anthropic/Data/Messages/ContentBlocks/WebSearchToolResultContentBlock.php

@@ -10,6 +10,9 @@ final class WebSearchToolResultContentBlock implements ContentBlock
 {
     public string $type = 'web_search_tool_result';
 
+    /**
+     * @param array<int, mixed> $content
+     */
     public function __construct(
         public string $toolUseId,
         public array $content,

src/SDK/Anthropic/Data/Messages/Message.php

@@ -34,6 +34,9 @@ public function __construct(
         public ?Usage $usage = null,
     ) {}
 
+    /**
+     * @param array<string, mixed> $payload
+     */
     public static function from(array $payload): self
     {
         return new self(