Remote Sessions

Abilitando le Remote Sessions, puoi accedere alla stessa sessione da web e mobile tramite Mission Control di GitHub. Una volta abilitate, ogni sessione si connette a Mission Control e viene emesso un URL condivisibile come link o codice QR. Se vuoi che la sessione stessa venga eseguita nell’ambiente hostato da GitHub anziché in locale o su un tuo server, usa le Cloud Sessions.

Prerequisiti

L’utente deve essere autenticato (token GitHub o utente loggato)
La workingDirectory deve essere un repository GitHub

Attivazione a livello di client (sempre ON)

Abilitando remote: true, per tutte le sessioni all’interno di un repository GitHub viene automaticamente emesso un URL remoto. Piuttosto che aggiungerla in modo fisso a config/copilot.php, è più pratico abilitare remote: true con useStdio() solo dove serve.

L’opzione remote è valida solo quando è l’SDK ad avviare il processo CLI. In altre parole, è esclusiva della modalità stdio. In caso di connessione a server esterni come useTcp(), viene ignorata.

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Enums\SessionEventType;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\SessionEvent;

$config = new SessionConfig(
    workingDirectory: '/path/to/github-repo',
    onPermissionRequest: PermissionHandler::approveAll(),
);

$stdioConfig = config('copilot');
$stdioConfig['remote'] = true;

Copilot::useStdio($stdioConfig)->start(function (CopilotSession $session): void {
    $session->on(SessionEventType::SESSION_INFO, function (SessionEvent $event): void {
        if ($event->data('infoType') === 'remote') {
            echo 'Remote URL: '.$event->data('url').PHP_EOL;
        }
    });
}, config: $config);

Attivazione per sessione (on-demand)

Se vuoi iniziare la condivisione remota in corso di sessione, usa l’RPC. È equivalente ai comandi /remote on e /remote off della CLI.

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;

Copilot::start(function (CopilotSession $session): void {
    $result = $session->rpc()->remote()->enable();

    if ($result->url !== null) {
        echo 'Remote URL: '.$result->url.PHP_EOL;
    }

    // Interrompi la condivisione
    $session->rpc()->remote()->disable();
});

Remote Control a livello di runtime (modalità TCP)

L’opzione remote: true si applica quando l’SDK avvia il processo CLI, quindi funziona solo in modalità stdio. Quando ti connetti a un server CLI esistente in modalità TCP, questa opzione viene ignorata. In modalità TCP, usa $client->rpc()->sessions() per gestire un unico Remote Control per l’intero runtime. A differenza di remote()->enable() per sessione, questi metodi ti permettono di avviare, fermare e trasferire il Remote Control tra sessioni, e di leggerne lo stato attuale.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\RemoteControlConfig;
use Revolution\Copilot\Types\Rpc\SessionsStartRemoteControlRequest;

$client = Copilot::useTcp(url: 'tcp://127.0.0.1:12345')->client();

$result = $client->rpc()->sessions()->startRemoteControl(
    new SessionsStartRemoteControlRequest(
        sessionId: $sessionId,
        config: new RemoteControlConfig(
            remote: true,
            steerable: true,
            explicit: true,
            silent: false,
        ),
    ),
);

if ($result->status->frontendUrl !== null) {
    echo 'Remote URL: '.$result->status->frontendUrl.PHP_EOL;
}

Lo stato è uno tra off, connecting, active o error. Quando lo stato è active, puoi leggere anche frontendUrl e isSteerable.

$status = $client->rpc()->sessions()->getRemoteControlStatus();

$client->rpc()->sessions()->setRemoteControlSteering(['enabled' => true]);
$client->rpc()->sessions()->transferRemoteControl([
    'toSessionId' => $nextSessionId,
    'expectedFromSessionId' => $sessionId,
]);
$client->rpc()->sessions()->stopRemoteControl([
    'expectedSessionId' => $nextSessionId,
]);

Per comunicare al runtime che la controllabilità remota di una sessione è cambiata, usa l’RPC con ambito di sessione.

$session->rpc()->remote()->notifySteerableChanged(['remoteSteerable' => true]);

Generazione codice QR

L’URL remoto ottenuto può essere trasformato in un codice QR da passare al mobile. Puoi usare BaconQrCode, utilizzato anche in Laravel Fortify.

use BaconQrCode\Renderer\Image\SvgImageBackEnd;
use BaconQrCode\Renderer\ImageRenderer;
use BaconQrCode\Renderer\RendererStyle\RendererStyle;
use BaconQrCode\Writer;

$writer = new Writer(
    new ImageRenderer(
        new RendererStyle(256),
        new SvgImageBackEnd(),
    ),
);

$svg = $writer->writeString($result->url ?? '');

Considerazioni

L’opzione remote è valida solo quando è l’SDK ad avviare il processo CLI. Con connessioni a server esterni tramite useTcp() è ignorata.
Se workingDirectory non è un repository GitHub, in modalità sempre ON la configurazione remota viene saltata. Con l’attivazione on-demand (remote()->enable()) può generare un errore.
Configura correttamente le credenziali di autenticazione (github_token o use_logged_in_user).

Riferimenti

Per le informazioni più recenti fai riferimento al repository GitHub.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kit

Feed e RSS

Middleware

Remote Sessions

Remote Sessions

Prerequisiti

Attivazione a livello di client (sempre ON)

Attivazione per sessione (on-demand)

Remote Control a livello di runtime (modalità TCP)

Generazione codice QR

Considerazioni

Riferimenti

​Remote Sessions

​Prerequisiti

​Attivazione a livello di client (sempre ON)

​Attivazione per sessione (on-demand)

​Remote Control a livello di runtime (modalità TCP)

​Generazione codice QR

​Considerazioni

​Riferimenti

Remote Sessions

Prerequisiti

Attivazione a livello di client (sempre ON)

Attivazione per sessione (on-demand)

Remote Control a livello di runtime (modalità TCP)

Generazione codice QR

Considerazioni

Riferimenti