20e789d402* Change return type of abstract request methods * Change return type of `fromParams` method to `static` in request classes (cherry picked from commit 94799ab66ff60d4b2305aadb6b73aaa4c805221e) * Make request classes final and update `getParams` return types for improved type safety (cherry picked from commit d6be496f89cc0e6d30f519792d0dc902685c4178)
73 lines
2.2 KiB
PHP
73 lines
2.2 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the official PHP MCP SDK.
|
|
*
|
|
* A collaboration between Symfony and the PHP Foundation.
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Mcp\Schema\Request;
|
|
|
|
use Mcp\Exception\InvalidArgumentException;
|
|
use Mcp\Schema\JsonRpc\Request;
|
|
use Mcp\Schema\PromptReference;
|
|
use Mcp\Schema\ResourceReference;
|
|
|
|
/**
|
|
* A request from the client to the server, to ask for completion options.
|
|
*
|
|
* @author Kyrian Obikwelu <koshnawaza@gmail.com>
|
|
*/
|
|
final class CompletionCompleteRequest extends Request
|
|
{
|
|
/**
|
|
* @param PromptReference|ResourceReference $ref the prompt or resource to complete
|
|
* @param array{ name: string, value: string } $argument the argument to complete
|
|
*/
|
|
public function __construct(
|
|
public readonly PromptReference|ResourceReference $ref,
|
|
public readonly array $argument,
|
|
) {
|
|
}
|
|
|
|
public static function getMethod(): string
|
|
{
|
|
return 'completion/complete';
|
|
}
|
|
|
|
protected static function fromParams(?array $params): static
|
|
{
|
|
if (!isset($params['ref']) || !\is_array($params['ref'])) {
|
|
throw new InvalidArgumentException('Missing or invalid "ref" parameter for completion/complete.');
|
|
}
|
|
|
|
$ref = match ($params['ref']['type'] ?? null) {
|
|
'ref/prompt' => new PromptReference($params['ref']['name']),
|
|
'ref/resource' => new ResourceReference($params['ref']['uri']),
|
|
default => throw new InvalidArgumentException('Invalid "ref" parameter for completion/complete.'),
|
|
};
|
|
|
|
if (!isset($params['argument']) || !\is_array($params['argument'])) {
|
|
throw new InvalidArgumentException('Missing or invalid "argument" parameter for completion/complete.');
|
|
}
|
|
|
|
return new self($ref, $params['argument']);
|
|
}
|
|
|
|
/**
|
|
* @return array{
|
|
* ref: PromptReference|ResourceReference,
|
|
* argument: array{ name: string, value: string }
|
|
* }
|
|
*/
|
|
protected function getParams(): array
|
|
{
|
|
return [
|
|
'ref' => $this->ref,
|
|
'argument' => $this->argument,
|
|
];
|
|
}
|
|
}
|