Sesiones, host y entorno
Ámbito: ServerRpc (operaciones de todo el servidor vinculadas al Client)
Para una visión general de RPC y la lista de todas las páginas de RPC, consulta RPC.
Ciclo de vida de Runtime y Host (experimental)
host.unpublishSession() retira la application publication de un host en ejecución del que se es propietario. Retirar la publicación no elimina ni detiene el historial de la sesión original, el worktree ni el trabajo en curso. Si ya no estaba publicada, unpublished es false, y las publication que no son application producen un error.
host.dispose() destruye el listener del host indicando hostId.
host.setSessionCreationPolicy() cambia si un host en ejecución acepta nuevas sesiones remotas. El cambio no desconecta a los clientes existentes y solo se aplica a las admisiones posteriores.
En los runtimes stdio arrancados por el SDK, Client::stop() llama a runtime.shutdown después de desconectar las sesiones y antes de cerrar la conexión JSON-RPC y el proceso. La desconexión de sesiones (session.detach) comparte un único plazo total de 10 segundos para todas las sesiones. Una desconexión que supera el plazo se incluye como error en el valor de retorno y el proceso de parada continúa. También espera hasta 10 segundos a que termine la limpieza del runtime y, si falla, incluye el error en el valor de retorno y continúa con el resto del proceso de parada. En conexiones a runtimes externos como cli_url, no llama a esta RPC para no terminar un runtime compartido.
Si la CLI no puede identificar la petición correspondiente y devuelve un error JSON-RPC con id: null, todas las peticiones en curso fallan con una JsonRpcException. La excepción incluye un mensaje de diagnóstico sin los valores entre comillas y con la longitud limitada. La conexión se mantiene abierta. Como es posible que la CLI ya haya procesado la petición, no reintentes automáticamente sin confirmar que es seguro hacerlo. El SDK rechaza antes de enviarlas las peticiones salientes con más de 127 niveles de anidamiento, que la CLI no puede leer, y sustituye por un error JSON-RPC las respuestas de handlers con un anidamiento demasiado profundo.
cloudTasks (experimental: tareas del agente en la nube)
cloudTasks() crea, elimina y obtiene tareas del agente de codificación en la nube, recupera los logs y replays de sesión, cambia el estado de uso compartido y resuelve la sesión que se debe abrir a partir de un ID de tarea. Cada método acepta el tipo Params correspondiente o un array y devuelve un DTO tipado. Cuando ok del resultado de creación es false, consulta reason y message para ver por qué el servicio rechazó la solicitud, y statusCode, errorMessage y errorPayloadJson para la información de fallo de la solicitud HTTP realizada.
taskAnalytics (experimental: clasificar trayectorias grabadas)
taskAnalytics()->classifyTrajectory() clasifica eventos de Copilot grabados o datos ATIF sin crear una sesión. Las herramientas archivadas no se ejecutan y no se añade nada al historial de conversación ni a la telemetría de clasificación. Pasa events en su orden original. También puedes indicar classifiers, maxConcurrentRequests, judge y previousResult. Con validateOnly: true, el runtime omite la inferencia y devuelve solo el resultado de la validación local.
Una clasificación normal envía el contenido de los eventos al procesamiento del modelo, que usa tus credenciales de GitHub CAPI. No hay redacción automática ni protección frente a prompt injection. Aprueba la subida, verifica el origen del archivo y elimina antes los datos sensibles. Los resultados de clasificación no son hechos fiables, así que no los uses para decisiones de autorización o de seguridad.
Para abrir una URL de autenticación en el navegador, usa runtime()->openBrowser().
Para obtener el aviso de concesión de rutas del sandbox, usa sandbox()->getPathGrantWarning().
sessions connect y Remote Control (modo TCP)
Para conectar el servidor del CLI a una sesión remota existente, usa sessions()->connect(). Pasa el sessionId remoto y el resultado contendrá el sessionId del lado del SDK y los metadatos de la sesión remota.
En modo TCP, también puedes usar sessions() para gestionar un único Remote Control para todo el runtime. A diferencia de remote()->enable(), que actúa por sesión, estos métodos te permiten iniciar, detener y transferir Remote Control entre sesiones, y leer su estado actual.
Para más detalles, consulta Sesiones remotas.Última modificación el 20 de noviembre de 2026