> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Remoto y sandbox

> Usa SessionRpc en Laravel Copilot SDK para controlar las sesiones remotas y el sandbox.

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

## remote (experimental: soporte de sesiones remotas)

```php theme={null}
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
```

Para indicar al runtime que ha cambiado la posibilidad de dirigir en remoto una sesión, usa `notifySteerableChanged()`.

```php theme={null}
$session->rpc()->remote()->notifySteerableChanged(['remoteSteerable' => true]);
```

Para más detalles, consulta [Sesiones remotas](https://kawax.biz/es/packages/laravel-copilot-sdk/remote-sessions.md).

## sandbox (experimental: control del sandbox)

```php theme={null}
// 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.
```

En el handler de permisos, llámalo con el `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.

```php theme={null}
if (isset($request['sandboxPathGrant'])) {
    $result = $session->rpc()->sandbox()->grantPathForRequest([
        'requestId' => $requestId,
    ]);

    return $result->success
        ? PermissionDecision::noResult()
        : PermissionDecision::reject();
}
```


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Resumen de SessionRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [Resumen de ServerRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [MCP](https://kawax.biz/es/packages/laravel-copilot-sdk/mcp.md)
- [SessionConfig](https://kawax.biz/es/packages/laravel-copilot-sdk/session-config.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.