Remote Sessions

Al habilitar Remote Sessions puedes acceder a la misma sesión desde la web o el móvil mediante Mission Control de GitHub. Al activarlo, la sesión se conecta a Mission Control y se emite una URL que puedes compartir como enlace o código QR. Si lo que quieres es ejecutar la propia sesión en el entorno hospedado por GitHub en lugar de en local o en un servidor propio, usa Cloud Sessions.

Requisitos previos

El usuario está autenticado (token de GitHub o usuario ya logueado)
workingDirectory es un repositorio de GitHub

Opciones de configuración eliminadas

El SDK oficial 1.0.26 eliminó la opción de cliente remote, la opción de sesión remoteSession y el flag de inicio de la CLI --remote. Para compartir una sesión, habilítala bajo demanda con $session->rpc()->remote()->enable(). Los RPC existentes de sesiones remotas siguen funcionando.

Habilitar por sesión (bajo demanda)

Para compartir una sesión, cambia el acceso remoto vía RPC. Equivale a los comandos /remote on y /remote off del 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;
    }

    // Detener el compartido
    $session->rpc()->remote()->disable();
});

Conectarse a una sesión remota existente (a nivel de servidor)

Para conectar el servidor CLI a una sesión remota existente, llama a $client->rpc()->sessions()->connect(). Pasa el sessionId remoto en ConnectRemoteSessionParams. El resultado contiene el sessionId del lado del SDK y los metadatos de la sesión remota.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\ConnectRemoteSessionParams;

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

$connected = $client->rpc()->sessions()->connect(
    new ConnectRemoteSessionParams(sessionId: 'remote-session-id'),
);

echo $connected->sessionId;
// $connected->metadata - objeto ConnectedRemoteSessionMetadata

Remote Control para todo el runtime (modo TCP)

La propiedad remote de RemoteControlConfig configura el Remote Control para todo el runtime. No tiene relación con la opción de inicio remote del cliente que se eliminó. En modo TCP, usa $client->rpc()->sessions() para gestionar un único Remote Control para todo el runtime. A diferencia de remote()->enable() por sesión, estos métodos te permiten iniciar, detener y transferir Remote Control entre sesiones, y consultar su estado actual.

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;
}

El estado es uno de off, connecting, active o error. Cuando el estado es active, también puedes consultar 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,
]);

Para notificar al runtime que la posibilidad de control remoto de una sesión ha cambiado, usa el RPC con ámbito de sesión.

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

Generar códigos QR

Puedes convertir la URL remota obtenida en un código QR y pasársela al móvil. Puedes usar BaconQrCode, que también usa 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 ?? '');

Consideraciones

Si workingDirectory no es un repositorio de GitHub, remote()->enable() puede devolver un error.
Configura correctamente las credenciales (github_token o use_logged_in_user).

Referencias

Consulta la información más reciente en el repositorio de GitHub.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds y RSS

Middleware

Remote Sessions

Remote Sessions

Requisitos previos

Opciones de configuración eliminadas

Habilitar por sesión (bajo demanda)

Conectarse a una sesión remota existente (a nivel de servidor)

Remote Control para todo el runtime (modo TCP)

Generar códigos QR

Consideraciones

Referencias

​Remote Sessions

​Requisitos previos

​Opciones de configuración eliminadas

​Habilitar por sesión (bajo demanda)

​Conectarse a una sesión remota existente (a nivel de servidor)

​Remote Control para todo el runtime (modo TCP)

​Generar códigos QR

​Consideraciones

​Referencias

Remote Sessions

Requisitos previos

Opciones de configuración eliminadas

Habilitar por sesión (bajo demanda)

Conectarse a una sesión remota existente (a nivel de servidor)

Remote Control para todo el runtime (modo TCP)

Generar códigos QR

Consideraciones

Referencias