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.
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.
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.
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.
Última modificación el 20 de noviembre de 2026