62 lines
1.6 KiB
PHP
62 lines
1.6 KiB
PHP
<?php
|
|
|
|
/*
|
|
* Core PHP Framework
|
|
*
|
|
* Licensed under the European Union Public Licence (EUPL) v1.2.
|
|
* See LICENSE file for details.
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Core\Mod\Agentic\Actions\Session;
|
|
|
|
use Core\Actions\Action;
|
|
use Core\Mod\Agentic\Models\AgentSession;
|
|
use Core\Mod\Agentic\Services\AgentSessionService;
|
|
|
|
/**
|
|
* End an agent session with a final status, summary, and optional handoff notes.
|
|
*
|
|
* Usage:
|
|
* $session = EndSession::run('ses_abc123', 'completed', 'All phases done');
|
|
* $session = EndSession::run('ses_abc123', 'handed_off', 'Ready for review', ['summary' => 'Ready for review']);
|
|
*/
|
|
class EndSession
|
|
{
|
|
use Action;
|
|
|
|
public function __construct(
|
|
private AgentSessionService $sessionService,
|
|
) {}
|
|
|
|
/**
|
|
* @throws \InvalidArgumentException
|
|
*/
|
|
public function handle(
|
|
string $sessionId,
|
|
string $status,
|
|
?string $summary = null,
|
|
?array $handoffNotes = null,
|
|
): AgentSession
|
|
{
|
|
if ($sessionId === '') {
|
|
throw new \InvalidArgumentException('session_id is required');
|
|
}
|
|
|
|
$valid = ['completed', 'handed_off', 'paused', 'failed'];
|
|
if (! in_array($status, $valid, true)) {
|
|
throw new \InvalidArgumentException(
|
|
sprintf('status must be one of: %s', implode(', ', $valid))
|
|
);
|
|
}
|
|
|
|
$session = $this->sessionService->end($sessionId, $status, $summary, $handoffNotes);
|
|
|
|
if (! $session) {
|
|
throw new \InvalidArgumentException("Session not found: {$sessionId}");
|
|
}
|
|
|
|
return $session;
|
|
}
|
|
}
|