File Server/Handler/Request/CompleteRequestHandler.php

1:	<?php
2:
3:	declare(strict_types=1);
4:
5:	/**
6:	* This file is part of the Nexus MCP SDK package.
7:	*
8:	* (c) 2026 John Paul E. Balandan, CPA <paulbalandan@gmail.com>
9:	*
10:	* For the full copyright and license information, please view
11:	* the LICENSE file that was distributed with this source code.
12:	*/
13:
14:	namespace Nexus\Mcp\Server\Handler\Request;
15:
16:	use Nexus\Mcp\Core\Handler\AbstractContext;
17:	use Nexus\Mcp\Core\Handler\RequestHandlerInterface;
18:	use Nexus\Mcp\Core\Schema\JsonRpc\JsonRpcRequest;
19:	use Nexus\Mcp\Core\Schema\Request\CompleteRequest;
20:	use Nexus\Mcp\Core\Schema\Result\CompleteResult;
21:	use Nexus\Mcp\Server\Completion\CompletionStoreInterface;
22:	use Nexus\Mcp\Server\ServerContext;
23:
24:	/**
25:	* Handles the `completion/complete` request by delegating to a `CompletionStoreInterface`.
26:	*
27:	* @implements RequestHandlerInterface<'completion/complete', CompleteResult, ServerContext>
28:	*/
29:	final readonly class CompleteRequestHandler implements RequestHandlerInterface
30:	{
31:	/**
32:	* CompleteResult schema on `values`: "Must not exceed 100 items.".
33:	*/
34:	private const int MAX_VALUES = 100;
35:
36:	public function __construct(private CompletionStoreInterface $store)
37:	{
38:	}
39:
40:	#[\Override]
41:	public function handle(JsonRpcRequest $request, AbstractContext $context): CompleteResult
42:	{
43:	\assert($request instanceof CompleteRequest);
44:	\assert($context instanceof ServerContext);
45:
46:	$params = $request->params;
47:
48:	$result = $this->store->complete(
49:	$params->ref,
50:	$params->argument['name'],
51:	$params->argument['value'],
52:	$params->context['arguments'] ?? null,
53:	$context,
54:	);
55:
56:	$values = $result->completion['values'];
57:
58:	if (\count($values) <= self::MAX_VALUES) {
59:	return $result;
60:	}
61:
62:	return new CompleteResult(
63:	completion: [
64:	'values' => \array_slice($values, 0, self::MAX_VALUES),
65:	'total' => $result->completion['total'] ?? \count($values),
66:	'hasMore' => true,
67:	],
68:	meta: $result->meta,
69:	);
70:	}
71:	}
72:

Namespaces

Classes