feat: add complete() method for completion/complete requests

Author: CodeWithKyrian

src/Client/Client.php

@@ -23,7 +23,9 @@
 use Mcp\Schema\JsonRpc\Error;
 use Mcp\Schema\JsonRpc\Request;
 use Mcp\Schema\JsonRpc\Response;
+use Mcp\Schema\PromptReference;
 use Mcp\Schema\Request\CallToolRequest;
+use Mcp\Schema\Request\CompletionCompleteRequest;
 use Mcp\Schema\Request\GetPromptRequest;
 use Mcp\Schema\Request\ListPromptsRequest;
 use Mcp\Schema\Request\ListResourcesRequest;
@@ -32,7 +34,9 @@
 use Mcp\Schema\Request\PingRequest;
 use Mcp\Schema\Request\ReadResourceRequest;
 use Mcp\Schema\Request\SetLogLevelRequest;
+use Mcp\Schema\ResourceReference;
 use Mcp\Schema\Result\CallToolResult;
+use Mcp\Schema\Result\CompletionCompleteResult;
 use Mcp\Schema\Result\GetPromptResult;
 use Mcp\Schema\Result\ListPromptsResult;
 use Mcp\Schema\Result\ListResourcesResult;
@@ -223,6 +227,22 @@ public function setLoggingLevel(LoggingLevel $level): void
         $this->doRequest(new SetLogLevelRequest($level));
     }
 
+    /**
+     * Request completion suggestions for a prompt or resource argument.
+     *
+     * @param PromptReference|ResourceReference $ref      The prompt or resource reference
+     * @param array{name: string, value: string} $argument The argument to complete
+     */
+    public function complete(PromptReference|ResourceReference $ref, array $argument): CompletionCompleteResult
+    {
+        $this->ensureConnected();
+
+        return $this->doRequest(
+            new CompletionCompleteRequest($ref, $argument),
+            CompletionCompleteResult::class,
+        );
+    }
+
     /**
      * Get the server info received during initialization.
      *

src/Schema/Result/CompletionCompleteResult.php

@@ -60,4 +60,18 @@ public function jsonSerialize(): array
 
         return ['completion' => $completion];
     }
+
+    /**
+     * @param array<string, mixed> $data
+     */
+    public static function fromArray(array $data): self
+    {
+        $completion = $data['completion'] ?? [];
+
+        return new self(
+            $completion['values'] ?? [],
+            $completion['total'] ?? null,
+            $completion['hasMore'] ?? null,
+        );
+    }
 }