adds Response::json

Author: nunomaduro

src/Response.php

@@ -4,6 +4,7 @@
 
 namespace Laravel\Mcp;
 
+use JsonException;
 use Laravel\Mcp\Enums\Role;
 use Laravel\Mcp\Exceptions\NotImplementedException;
 use Laravel\Mcp\Server\Content\Blob;
@@ -34,6 +35,21 @@ public static function text(string $text): static
         return new static(new Text($text));
     }
 
+    /**
+     * @internal
+     *
+     * @param  array<string, mixed>  $content
+     *
+     * @throws JsonException
+     */
+    public static function json(array $content): static
+    {
+        return static::text(json_encode(
+            $content,
+            JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT,
+        ));
+    }
+
     public static function blob(string $content): static
     {
         return new static(new Blob($content));

tests/Unit/ResponseTest.php

@@ -74,3 +74,51 @@
     expect($assistantResponse->role())->toBe(Role::ASSISTANT);
     expect($assistantResponse->isError())->toBeTrue();
 });
+
+it('creates a json response', function (): void {
+    $data = ['key' => 'value', 'number' => 123];
+    $response = Response::json($data);
+
+    expect($response->content())->toBeInstanceOf(Text::class);
+    expect($response->isNotification())->toBeFalse();
+    expect($response->isError())->toBeFalse();
+    expect($response->role())->toBe(Role::USER);
+
+    $content = $response->content();
+    expect((string) $content)->toBe(json_encode($data, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT));
+});
+
+it('handles nested arrays in json response', function (): void {
+    $data = [
+        'user' => [
+            'name' => 'John Doe',
+            'email' => '[email protected]',
+            'roles' => ['admin', 'developer']
+        ],
+        'active' => true
+    ];
+    $response = Response::json($data);
+
+    expect($response->content())->toBeInstanceOf(Text::class);
+
+    $content = $response->content();
+    expect((string) $content)->toBe(json_encode($data, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT));
+});
+
+it('throws JsonException for invalid json data', function (): void {
+    $data = ['invalid' => INF];
+
+    expect(function () use ($data): void {
+        Response::json($data);
+    })->toThrow(JsonException::class);
+});
+
+it('handles empty array in json response', function (): void {
+    $data = [];
+    $response = Response::json($data);
+
+    expect($response->content())->toBeInstanceOf(Text::class);
+
+    $content = $response->content();
+    expect((string) $content)->toBe(json_encode($data, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT));
+});