Remoto y sandbox
Ámbito: SessionRpc (operaciones por sesión vinculadas a una Session) Para una visión general de RPC y la lista de todas las páginas de RPC, consulta RPC.remote (experimental: soporte de sesiones remotas)
use Revolution\Copilot\Enums\RemoteSessionMode;
use Revolution\Copilot\Types\Rpc\RemoteEnableRequest;
use Revolution\Copilot\Types\Rpc\RemoteEnableResult;
// Activar la sesión remota
// Si se ejecuta en el directorio de trabajo de un repositorio de GitHub,
// devuelve una URL para acceder a la sesión desde GitHub Web o el móvil
$result = $session->rpc()->remote()->enable();
// $result->remoteSteerable - si el steering remoto está activado
// $result->url - URL del frontend de GitHub (puede ser null)
// Activar indicando el modo
// RemoteSessionMode::Off - solo local (por defecto)
// RemoteSessionMode::Export - exporta los eventos de la sesión a GitHub (sin steering remoto)
// RemoteSessionMode::On - activa tanto la exportación como el steering remoto
$result = $session->rpc()->remote()->enable(new RemoteEnableRequest(
mode: RemoteSessionMode::Export,
));
// Desactivar la sesión remota
$session->rpc()->remote()->disable();
// Conectarse a una sesión remota (experimental)
use Revolution\Copilot\Types\Rpc\ConnectRemoteSessionParams;
$connected = $session->rpc()->remote()->connectRemoteSession(new ConnectRemoteSessionParams(
sessionId: 'remote-session-id',
));
// $connected->sessionId - ID de la sesión conectada
// $connected->metadata - Objeto ConnectedRemoteSessionMetadata
notifySteerableChanged().
$session->rpc()->remote()->notifySteerableChanged(['remoteSteerable' => true]);
sandbox (experimental: control del sandbox)
// Comprobar el soporte de sandbox del host antes de crear una sesión
$hostSupport = $client->rpc()->sandbox()->getHostSupport();
// $hostSupport->supported, $hostSupport->reason, $hostSupport->capabilities
// Comprobar si se necesita el Proxy CA y el soporte de instalación
$proxyCa = $client->rpc()->sandboxProxyCa();
$relevant = $proxyCa->checkRelevance(['enabled' => true]);
$installable = $proxyCa->checkInstallationSupport();
use Revolution\Copilot\Types\Rpc\SandboxDisableForSessionRequest;
use Revolution\Copilot\Types\Rpc\SandboxGrantPathForRequestRequest;
use Revolution\Copilot\Types\Rpc\SessionSandboxGetRemoteMcpEgressRequest;
// Obtener el estado de aplicación de políticas del sandbox
$status = $session->rpc()->sandbox()->getEnforcementStatus();
// Comprobar si la aplicación de políticas puede aplicarse a las nuevas admisiones del sandbox
$session->rpc()->sandbox()->ensureEnforcementAvailable();
// Decidir el egress de un endpoint MCP remoto
$egress = $session->rpc()->sandbox()->getRemoteMcpEgress(
new SessionSandboxGetRemoteMcpEgressRequest(
secretConfigDir: '/path/to/mcp-secrets',
url: 'https://mcp.example.com',
),
);
// deniedReason solo se establece cuando se deniega, y proxyUrl solo cuando se enruta a través de un proxy permitido
// Credenciales que pueden usarse en nuevas shells del sandbox (no se devuelven los valores)
$credentials = $session->rpc()->sandbox()->getCredentialSuggestions();
// $credentials->suggestions es un array de SandboxCredentialSuggestion
// Si el sandbox está desactivado o no hay candidatos, es un array vacío. No se modifican la configuración ni los permisos de red.
// Aprobar una solicitud pendiente de permiso de bypass del sandbox y desactivar el sandbox en toda la sesión
$result = $session->rpc()->sandbox()->disableForSession(new SandboxDisableForSessionRequest(requestId: $requestId));
// $result->success, $result->enabled
// Aprueba el permiso de ruta (sandboxPathGrant) presentado por una solicitud pendiente de permiso de escalado del sandbox,
// añade esa ruta a la política de sandbox de la sesión y vuelve a ejecutar la operación bloqueada
// dentro del sandbox
$result = $session->rpc()->sandbox()->grantPathForRequest(new SandboxGrantPathForRequestRequest(requestId: $requestId));
// También admite un array: ->grantPathForRequest(['requestId' => $requestId])
// $result->success
// Falla si la solicitud ya no está pendiente, si no incluía sandboxPathGrant
// o si el permiso no es válido con la política gestionada actual.
// Es un mecanismo de mínimo privilegio que solo permite una ruta concreta, y se recomienda frente a disableForSession(), que desactiva toda la sesión.
// Esta ruta no se persiste (solo vale para esta sesión y no se traslada a sesiones posteriores).
// Los hosts que guardan la configuración del sandbox deben guardar la ruta por su cuenta si lo necesitan.
requestId de la solicitud pendiente cuando exista $request['sandboxPathGrant']. Como esta RPC responde por sí misma a la solicitud de permiso, si tiene éxito devuelve PermissionDecision::noResult() para no enviar la respuesta normal.
if (isset($request['sandboxPathGrant'])) {
$result = $session->rpc()->sandbox()->grantPathForRequest([
'requestId' => $requestId,
]);
return $result->success
? PermissionDecision::noResult()
: PermissionDecision::reject();
}