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

# Session-Informationen und lokale Session-Verwaltung

> Mit SessionRpc des Laravel Copilot SDK lesen Sie Session-Informationen und verwalten lokale Sessions.

## Session-Informationen und lokale Session-Verwaltung

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).

## metadata (experimental: Session-Informationen)

```php theme={null}
use Revolution\Copilot\Types\Rpc\MetadataUpdateClientMetadataRequest;

// Aktuellen Aktivitätsstatus der Session abrufen
$activity = $session->rpc()->metadata()->activity();
// $activity->abortable - Ob abbrechbare Arbeit vorhanden ist
// $activity->hasActiveWork - Ob Arbeit wie ein Turn oder eine Hintergrundaufgabe läuft

// Clientseitige Metadaten dieser lokalen Session abrufen
$metadata = $session->rpc()->metadata()->getClientMetadata();

// Metadaten atomar aktualisieren (Anwendung in der Reihenfolge clear → remove → set)
$metadata = $session->rpc()->metadata()->updateClientMetadata(new MetadataUpdateClientMetadataRequest(
    set: ['my-app/key' => 'value'],
));
```

## Lokale Session-Verwaltung (experimental)

Mit `$session->rpc()->management()` konfigurieren, listen, erstellen, benachrichtigen und schließen Sie lokale Sessions, die im selben Konfigurationsverzeichnis der Verwaltung zugestimmt haben. Registrieren Sie mit `setSessionCreationHandler()` einen Host-Callback, um das Reverse-RPC von `create()` zu empfangen. Der Callback muss die Child-Session mit `newSessionId` erstellen, ihre Berechtigungs- und Modellbeschränkungen beibehalten und ein `SessionManagementCreateResult` zurückgeben.

Im folgenden Beispiel ist `$sessionCreationHandler` eine Closure, die ein `SessionManagementCreateHostRequest` empfängt, die Child-Session auf dem Host erstellt und ein `SessionManagementCreateResult` zurückgibt.

```php theme={null}
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Enums\SessionManagementScope;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\SessionManagementCloseRequest;
use Revolution\Copilot\Types\Rpc\SessionManagementConfigureRequest;
use Revolution\Copilot\Types\Rpc\SessionManagementCreateRequest;
use Revolution\Copilot\Types\Rpc\SessionManagementListRequest;
use Revolution\Copilot\Types\Rpc\SessionManagementMessageRequest;
use Revolution\Copilot\Types\Rpc\SessionManagementToolOverrides;

Copilot::start(function (CopilotSession $session) use ($sessionCreationHandler): void {
    $session->setSessionCreationHandler($sessionCreationHandler);
    $management = $session->rpc()->management();

    $policy = $management->configure(new SessionManagementConfigureRequest(
        cwd: base_path(),
        enabled: true,
        scope: SessionManagementScope::All,
        tools: new SessionManagementToolOverrides(
            create: true,
            list: true,
            message: true,
            close: true,
        ),
    ));

    $peers = $management->list(new SessionManagementListRequest());
    $peer = $peers->sessions[0] ?? null;

    $child = $management->create(new SessionManagementCreateRequest(
        prompt: 'Review the current implementation.',
    ));

    if ($peer !== null) {
        $message = $management->message(new SessionManagementMessageRequest(
            targetSessionId: $peer->sessionId,
            message: 'Please report your progress.',
        ));
    }
});
```

`accepted` von `message()` bedeutet, dass die Nachricht zur Zustellung angenommen wurde, nicht dass das Ziel geantwortet oder seine Aufgabe abgeschlossen hat. Nachdem Sie separat geprüft haben, dass eine Child-Session ihre Arbeit abgeschlossen hat, schließen Sie mit `close()` nur die von Ihnen erstellten Children. Der gespeicherte Verlauf wird nicht gelöscht.

```php theme={null}
$management->close(new SessionManagementCloseRequest(
    targetSessionId: 'child-session-id',
));
```


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)
- [Session](https://kawax.biz/de/session.md)
- [Session fortsetzen](https://kawax.biz/de/packages/laravel-copilot-sdk/resume.md)
- [Session-Kontext und Filterung](https://kawax.biz/de/packages/laravel-copilot-sdk/session-context.md)
- [ServerRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-overview.md)


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