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

# Remote und Sandbox

> Mit SessionRpc des Laravel Copilot SDK steuern Sie Remote-Sessions und die Sandbox.

## Remote und Sandbox

Geltungsbereich: SessionRpc (sessionbezogene Operationen, die an eine Session gebunden sind)

Eine Übersicht über RPC und die Liste aller RPC-Seiten finden Sie unter [RPC](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md).

## remote (experimental: Unterstützung für Remote-Sessions)

```php theme={null}
use Revolution\Copilot\Enums\RemoteSessionMode;
use Revolution\Copilot\Types\Rpc\RemoteEnableRequest;
use Revolution\Copilot\Types\Rpc\RemoteEnableResult;

// Remote-Session aktivieren
// Bei Ausführung im Arbeitsverzeichnis eines GitHub-Repositorys wird eine URL zurückgegeben,
// über die die Session aus GitHub Web oder von Mobilgeräten erreichbar ist
$result = $session->rpc()->remote()->enable();
// $result->remoteSteerable - Ob Remote-Steering aktiviert ist
// $result->url - GitHub-Frontend-URL (kann null sein)

// Mit Angabe eines Modus aktivieren
// RemoteSessionMode::Off - Nur lokal (Standard)
// RemoteSessionMode::Export - Session-Events nach GitHub exportieren (ohne Remote-Steering)
// RemoteSessionMode::On - Export und Remote-Steering beide aktivieren
$result = $session->rpc()->remote()->enable(new RemoteEnableRequest(
    mode: RemoteSessionMode::Export,
));

// Remote-Session deaktivieren
$session->rpc()->remote()->disable();

// Mit einer Remote-Session verbinden (experimental)
use Revolution\Copilot\Types\Rpc\ConnectRemoteSessionParams;

$connected = $session->rpc()->remote()->connectRemoteSession(new ConnectRemoteSessionParams(
    sessionId: 'remote-session-id',
));
// $connected->sessionId - ID der verbundenen Session
// $connected->metadata - ConnectedRemoteSessionMetadata-Objekt
```

Um der Runtime mitzuteilen, dass sich die Remote-Steuerbarkeit einer Session geändert hat, verwenden Sie `notifySteerableChanged()`.

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

Details finden Sie unter [Remote Sessions](https://kawax.biz/de/packages/laravel-copilot-sdk/remote-sessions.md).

## sandbox (experimental: Sandbox-Steuerung)

```php theme={null}
// Vor dem Erstellen einer Session die Sandbox-Unterstützung des Hosts prüfen
$hostSupport = $client->rpc()->sandbox()->getHostSupport();
// $hostSupport->supported, $hostSupport->reason, $hostSupport->capabilities

// Prüfen, ob eine Proxy-CA erforderlich ist und ob ihre Installation unterstützt wird
$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;

// Durchsetzungsstatus der Sandbox abrufen
$status = $session->rpc()->sandbox()->getEnforcementStatus();

// Prüfen, ob die Durchsetzung auf neue Sandbox-Zulassungen angewendet werden kann
$session->rpc()->sandbox()->ensureEnforcementAvailable();

// Egress für einen Remote-MCP-Endpunkt entscheiden
$egress = $session->rpc()->sandbox()->getRemoteMcpEgress(
    new SessionSandboxGetRemoteMcpEgressRequest(
        secretConfigDir: '/path/to/mcp-secrets',
        url: 'https://mcp.example.com',
    ),
);
// deniedReason ist nur bei Ablehnung gesetzt, proxyUrl nur bei Weiterleitung über einen erlaubten Proxy

// Anmeldeinformationen, die in neuen Shells der Sandbox verfügbar sein könnten (Werte werden nicht zurückgegeben)
$credentials = $session->rpc()->sandbox()->getCredentialSuggestions();
// $credentials->suggestions ist ein Array von SandboxCredentialSuggestion
// Bei deaktivierter Sandbox oder ohne Kandidaten ein leeres Array. Einstellungen und Netzwerkberechtigungen werden nicht geändert.

// Ausstehende Anfrage zur Sandbox-Umgehung genehmigen und die Sandbox für die gesamte Session deaktivieren
$result = $session->rpc()->sandbox()->disableForSession(new SandboxDisableForSessionRequest(requestId: $requestId));
// $result->success, $result->enabled

// Die von einer ausstehenden Sandbox-Eskalationsanfrage vorgeschlagene Pfadfreigabe (sandboxPathGrant)
// genehmigen, den Pfad zur Sandbox-Richtlinie der Session hinzufügen und den blockierten Vorgang
// innerhalb der Sandbox erneut ausführen lassen
$result = $session->rpc()->sandbox()->grantPathForRequest(new SandboxGrantPathForRequestRequest(requestId: $requestId));
// Array-Eingabe ist ebenfalls möglich: ->grantPathForRequest(['requestId' => $requestId])
// $result->success
// Schlägt fehl, wenn die betreffende Anfrage nicht mehr aussteht, kein sandboxPathGrant enthält
// oder die Freigabe unter der aktuellen verwalteten Richtlinie ungültig ist.
// Dies ist das Mittel mit minimalen Rechten, das nur bestimmte Pfade erlaubt, und ist disableForSession() vorzuziehen, das die gesamte Session deaktiviert.
// Der Pfad wird nicht persistiert (er gilt nur für diese Session und wird nicht in spätere Sessions übernommen).
// Hosts, die Sandbox-Einstellungen speichern, speichern den Pfad bei Bedarf selbst.
```

Rufen Sie dies im Berechtigungs-Handler auf, wenn `$request['sandboxPathGrant']` vorhanden ist, und zwar mit der `requestId` der betreffenden ausstehenden Anfrage. Da dieser RPC selbst auf die Berechtigungsanfrage antwortet, geben Sie bei Erfolg `PermissionDecision::noResult()` zurück, damit keine normale Antwort gesendet wird.

```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/de/packages/laravel-copilot-sdk/rpc.md)
- [SessionRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [Sessions, Host und Umgebung](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-sessions.md)
- [ServerRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [Remote Sessions](https://kawax.biz/de/packages/laravel-copilot-sdk/remote-sessions.md)


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