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

# Información de la sesión y gestión de sesiones locales

> Usa SessionRpc en Laravel Copilot SDK para leer la información de la sesión y gestionar sesiones locales.

## Información de la sesión y gestión de sesiones locales

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

## metadata (experimental: información de la sesión)

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

// Obtener el estado de actividad actual de la sesión
$activity = $session->rpc()->metadata()->activity();
// $activity->abortable - si hay trabajo que se pueda abortar
// $activity->hasActiveWork - si hay trabajo en ejecución, como un turno o una tarea en segundo plano

// Obtener los metadatos propiedad del cliente asociados a esta sesión local
$metadata = $session->rpc()->metadata()->getClientMetadata();

// Actualizar los metadatos de forma atómica (se aplican en el orden clear → remove → set)
$metadata = $session->rpc()->metadata()->updateClientMetadata(new MetadataUpdateClientMetadataRequest(
    set: ['my-app/key' => 'value'],
));
```

## Gestión de sesiones locales (experimental)

Usa `$session->rpc()->management()` para configurar, listar, crear, enviar mensajes y cerrar sesiones locales que aceptaron la gestión en el mismo directorio de configuración. Registra un callback del host con `setSessionCreationHandler()` para recibir la RPC inversa de `create()`. El callback debe crear la sesión hija con `newSessionId`, mantener sus restricciones de permisos y modelo, y devolver un `SessionManagementCreateResult`.

En el siguiente ejemplo, `$sessionCreationHandler` es un closure que recibe un `SessionManagementCreateHostRequest`, crea la sesión hija en el host y devuelve un `SessionManagementCreateResult`.

```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` de `message()` indica que el mensaje se aceptó para su entrega, no que el destino haya respondido o terminado su tarea. Después de confirmar por separado que una sesión hija terminó su trabajo, usa `close()` para cerrar solo las sesiones hijas que creaste. El historial guardado no se elimina.

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


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Eventos del ciclo de vida de sesión](https://kawax.biz/es/packages/laravel-copilot-sdk/session-lifecycle-event.md)
- [Contexto de sesión y filtrado](https://kawax.biz/es/packages/laravel-copilot-sdk/session-context.md)
- [Sesiones, host y entorno](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-sessions.md)
- [Resumen de ServerRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-overview.md)


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