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

# Configuración gestionada, debug e historial

> Usa SessionRpc en Laravel Copilot SDK para trabajar con la configuración gestionada, debug, contentExclusion y el historial.

## Configuración gestionada, debug e historial

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

## debug (experimental)

Con `debug()->collectLogs()` puedes recopilar el log de eventos, el log de procesos y el log de shell de la sesión en un archivo `.tgz` o en un directorio. Por defecto, la información sensible de los logs se redacta. Con `additionalEntries` puedes añadir ficheros o directorios, y en `redaction` puedes indicar `plain-text`, `events-jsonl` o `none`. Con `none` no se redacta nada, así que ten cuidado con el contenido que añades.

```php theme={null}
use Revolution\Copilot\Enums\DebugCollectLogsEntryKind;
use Revolution\Copilot\Enums\DebugCollectLogsRedaction;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsDestination;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsEntry;
use Revolution\Copilot\Types\Rpc\DebugCollectLogsRequest;

$result = $session->rpc()->debug()->collectLogs(new DebugCollectLogsRequest(
    destination: DebugCollectLogsDestination::archive('/tmp/copilot-debug.tgz', noOverwrite: true),
    additionalEntries: [
        new DebugCollectLogsEntry(
            kind: DebugCollectLogsEntryKind::File,
            path: '/var/log/my-app.log',
            bundlePath: 'application/my-app.log',
            redaction: DebugCollectLogsRedaction::PlainText,
            required: true,
        ),
    ],
));
```

Si indicas `DebugCollectLogsDestination::directory('/tmp/copilot-debug')`, la salida se escribe en un directorio de staging. Con `include` puedes indicar individualmente los logs y las rutas de referencia que se recopilan, y comprobar lo recopilado en `entries` y `skippedEntries` del resultado. Las rutas del destino y de las entradas adicionales son rutas del lado del servidor CLI. En la configuración estándar, que arranca la CLI por stdio, es el mismo host que la aplicación, pero si te conectas por TCP a un servidor CLI en otro host, indica rutas del servidor y no de la máquina que hace la llamada.

## contentExclusion (experimental)

Puedes comprobar si una ruta absoluta local dentro del directorio de trabajo de la sesión está sujeta a la política de exclusión de contenido. Llámalo antes de leer o adjuntar el contenido de un fichero.

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

$result = $session->rpc()->contentExclusion()->checkPaths(
    new ContentExclusionCheckPathsRequest(paths: [
        '/workspace/private.txt',
        '/workspace/public.txt',
    ]),
);

if ($result->isExcluded('/workspace/private.txt')) {
    // Está excluida o no se puede determinar con seguridad.
}
```

`checkPaths()` solo acepta rutas absolutas, y las rutas deben estar dentro del directorio de trabajo de la sesión. `checks` se devuelve en el mismo orden que la entrada y conserva tal cual las rutas duplicadas. Si la ruta, el sistema de ficheros o la evaluación de políticas no están soportados o disponibles, se devuelve `available: false` con `checks` vacío. En ese caso, `isExcluded()` siempre devuelve `true`, así que trata todas las rutas como excluidas. Incluso con `available: true`, las rutas que no aparecen en el resultado se consideran excluidas por precaución.

```php theme={null}
// managedSettings (experimental: configuración gestionada de la sesión)
// Obtener el snapshot actual (no espera a la aplicación ni vuelve a obtenerlo)
$snapshot = $session->rpc()->managedSettings()->getCurrentSnapshot(); // ManagedSettingsResolvedData|null
// Esperar hasta que se aplique la política actual / esperar solo hasta que se publique la política
$session->rpc()->managedSettings()->awaitApplied();
$session->rpc()->managedSettings()->awaitPublished();
// Reevaluar el Policy Helper y devolver la configuración efectiva resultante
$settings = $session->rpc()->managedSettings()->recheckPolicyHelper(); // ManagedSettingsResolvedData

// compaction → renombrado a history
$session->rpc()->history()->compact();
// Configurar el modelo, las instrucciones y el esfuerzo de razonamiento usados para la compactación (experimental). Cada llamada reemplaza los tres valores y los omitidos vuelven al valor predeterminado
$session->rpc()->history()->setCompactionConfig(new HistorySetCompactionConfigRequest(
    model: 'gpt-5', // Opcional. En sesiones BYOK/provider, el resumen lo hace el modelo de la sesión
    prompt: 'Keep decisions only', // Opcional. Reemplaza el prompt integrado
    reasoningEffort: ReasoningEffort::LOW, // Opcional
));
// Interrumpir la compactación manual / cancelar la compactación en segundo plano
$session->rpc()->history()->abortManualCompaction();
$session->rpc()->history()->cancelBackgroundCompaction();
// Obtener un resumen para el traspaso a otra sesión
$summary = $session->rpc()->history()->summarizeForHandoff()->summary;
// Truncar el historial a partir de un evento concreto
$session->rpc()->history()->truncate(new HistoryTruncateRequest(
    eventId: 'evt-123', // Se eliminan este evento y todos los posteriores
));
```


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Configuración y configuración gestionada](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-settings.md)
- [Configuración](https://kawax.biz/es/configuration.md)
- [Manejo de errores](https://kawax.biz/es/error-handling.md)
- [Illuminate\Support\Manager — anatomía del sistema de drivers](https://kawax.biz/es/advanced/manager.md)


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