Session lifecycle events

use Revolution\Copilot\Enums\SessionLifecycleEventType;

// Get the event type's value
echo SessionLifecycleEventType::SESSION_CREATED->value; // 'session.created'

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\SessionLifecycleEvent;

// Get the client and subscribe to lifecycle events
$client = Copilot::client();

// Subscribe to every lifecycle event
$unsubscribe = $client->onLifecycle(function (SessionLifecycleEvent $event) {
    match ($event->type) {
        SessionLifecycleEventType::SESSION_CREATED => info("Session created: {$event->sessionId}"),
        SessionLifecycleEventType::SESSION_DELETED => info("Session deleted: {$event->sessionId}"),
        SessionLifecycleEventType::SESSION_FOREGROUND => info("Foreground: {$event->sessionId}"),
        SessionLifecycleEventType::SESSION_BACKGROUND => info("Background: {$event->sessionId}"),
        default => null,
    };
});

// Unsubscribe
$unsubscribe();

use Revolution\Copilot\Types\SessionLifecycleEvent;
use Revolution\Copilot\Types\SessionLifecycleEventMetadata;

readonly class SessionLifecycleEvent implements Arrayable
{
    public function __construct(
        public SessionLifecycleEventType $type,  // Event type
        public string $sessionId,                 // Session ID
        public ?SessionLifecycleEventMetadata $metadata = null,  // Metadata (not included on delete)
    ) {}
}

readonly class SessionLifecycleEventMetadata implements Arrayable
{
    public function __construct(
        public string $startTime,      // Session start time
        public string $modifiedTime,   // Last modified time
        public ?string $summary = null, // Session summary
    ) {}
}

use Revolution\Copilot\Facades\Copilot;

$client = Copilot::client();

// Get the session ID currently displayed in the TUI
$sessionId = $client->getForegroundSessionId();

if ($sessionId !== null) {
    echo "Current foreground session: {$sessionId}";
}

use Revolution\Copilot\Facades\Copilot;

$client = Copilot::client();

// Display a specific session in the TUI
$client->setForegroundSessionId('session-123');

use Revolution\Copilot\Types\ForegroundSessionInfo;

readonly class ForegroundSessionInfo implements Arrayable
{
    public function __construct(
        public ?string $sessionId = null,      // Foreground session ID
        public ?string $workspacePath = null,  // Workspace path
    ) {}
}

# Launch the Copilot CLI in TUI + server mode
copilot --ui-server --port 8080

use Revolution\Copilot\Facades\Copilot;

// Connect to the server in TCP mode
$client = Copilot::useTcp('tcp://127.0.0.1:8080')->client();

// Subscribe to lifecycle events
$client->onLifecycle(function (SessionLifecycleEvent $event) {
    // Handle the event
});