49 lines
2.2 KiB
PHP
49 lines
2.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Chatbot\Mcp\TripsOnly;
|
|
|
|
use App\Chatbot\Mcp\ToolCallRunner;
|
|
use App\Chatbot\TripCatalog;
|
|
use Mcp\Capability\Attribute\McpTool;
|
|
use Mcp\Capability\Attribute\Schema;
|
|
use Mcp\Exception\ToolCallException;
|
|
use Mcp\Schema\Result\CallToolResult;
|
|
use Mcp\Schema\ToolAnnotations;
|
|
|
|
/**
|
|
* get_trip of the trips-only server (/mcp/trips): the same trip without the product and
|
|
* hotel page texts, whose prices and inclusions can contradict the booking system.
|
|
*/
|
|
#[McpTool(
|
|
name: 'get_trip',
|
|
description: 'Full details of one trip: destination, hotels with their facts, all upcoming dates with rooms, prices per person in EUR and availability, pickup points and departure times. Pickup surcharges are per person and per direction: surchargeOutbound for the way there, surchargeReturn for the way back, surchargeRoundTrip for both; quote the round trip unless the user travels one way only. Use after search_trips, or when the user names a specific trip or a booked date (date codes such as SSLMP061226 narrow the answer to that date). Prices and availability are a snapshot as of dataAsOf; the booking page is binding. For anything this does not answer, refer the user to the trip\'s url.',
|
|
annotations: new ToolAnnotations(readOnlyHint: true, openWorldHint: false),
|
|
)]
|
|
final class GetTripTool
|
|
{
|
|
public function __construct(
|
|
private readonly TripCatalog $catalog,
|
|
private readonly ToolCallRunner $runner,
|
|
) {
|
|
}
|
|
|
|
public function __invoke(
|
|
#[Schema(description: 'Trip code as returned by search_trips, or a date code (dateCode) for one date of a trip.', minLength: 1)]
|
|
string $code,
|
|
#[Schema(description: 'Narrows the dates to one hotel when a trip has several.')]
|
|
?string $hotelCode = null,
|
|
): CallToolResult {
|
|
return $this->runner->run('get_trip', get_defined_vars(), function () use ($code, $hotelCode): array {
|
|
$trip = $this->catalog->get(trim($code), $hotelCode, editorial: false);
|
|
|
|
if (null === $trip) {
|
|
throw new ToolCallException(sprintf('No trip or date with code "%s". Use search_trips to find trip codes.', $code));
|
|
}
|
|
|
|
return $trip;
|
|
});
|
|
}
|
|
}
|