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

# Logs, shell, uso, telemetría y autenticación

> Usa SessionRpc en Laravel Copilot SDK para logs, shell, uso, telemetría, autenticación y selección de cuenta.

## Logs, shell, uso, telemetría y autenticación

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

```php theme={null}
// log: registrar mensajes en la línea de tiempo de la sesión
$session->rpc()->log()->log(new LogRequest(message: 'Processing started'));
$session->rpc()->log()->log(new LogRequest(message: 'Disk usage is high', level: LogLevel::WARNING));
$session->rpc()->log()->log(new LogRequest(message: 'An error occurred', level: LogLevel::ERROR));
$session->rpc()->log()->log(new LogRequest(message: 'Debug info', ephemeral: true));

// shell: ejecutar comandos de shell en la sesión
$result = $session->rpc()->shell()->exec(new ShellExecRequest(command: 'ls -la'));
// Obtén el ID del proceso con $result->processId para usarlo en kill o en el seguimiento de la salida

$session->rpc()->shell()->exec(new ShellExecRequest(
    command: 'npm test',
    cwd: '/path/to/project',
    timeout: 60000, // Milisegundos
));

// Detener un proceso de shell en ejecución
$session->rpc()->shell()->kill(new ShellKillRequest(
    processId: $result->processId,
    signal: 'SIGTERM', // SIGTERM (por defecto), SIGKILL, SIGINT
));

// Cancelar un comando de shell solicitado por el usuario
use Revolution\Copilot\Types\Rpc\ShellExecuteUserRequestedRequest;
use Revolution\Copilot\Types\Rpc\ShellCancelUserRequestedRequest;

$execution = $session->rpc()->shell()->executeUserRequested(new ShellExecuteUserRequestedRequest(
    requestId: 'req-123',
    command: 'pwd',
), timeout: 120.0); // Tiempo de espera de la respuesta del CLI (segundos). Por defecto, 30 segundos
// $execution->toolCallId / success / output / exitCode / error
// Para cancelar desde otro proceso mientras se ejecuta, indica el mismo requestId

$cancelled = $session->rpc()->shell()->cancelUserRequested(
    new ShellCancelUserRequestedRequest(requestId: 'req-123')
);
// $cancelled->cancelled - si la cancelación tuvo éxito

// usage (experimental: métricas de uso de la sesión)
$metrics = $session->rpc()->usage()->getMetrics();
// $metrics->totalPremiumRequestCost - Coste total de las peticiones premium
// $metrics->totalUserRequests - Número total de peticiones del usuario
// $metrics->codeChanges - Métricas de cambios de código (líneas añadidas, líneas eliminadas, archivos modificados)
// $metrics->modelMetrics - Uso de tokens y número de peticiones por modelo
// $metrics->currentModel - Identificador del modelo actual

// telemetry (experimental: telemetría de la sesión)
use Revolution\Copilot\Types\Rpc\TelemetrySetFeatureOverridesRequest;

$telemetry = $session->rpc()->telemetry();
$engagement = $telemetry->getEngagementId();
// $engagement->engagementId - ID de engagement si está disponible; si no, null

$telemetry->setFeatureOverrides(new TelemetrySetFeatureOverridesRequest(
    features: ['feature-key' => 'override-value'],
));
// Las sobrescrituras se adjuntan a los eventos de telemetría posteriores y reemplazan las anteriores.
// Es independiente de SessionConfig::$enableSessionTelemetry (que activa la telemetría interna).

// auth: obtener el estado de autenticación de la sesión
$status = $session->rpc()->gitHubAuth()->getStatus();
// $status->isAuthenticated - Si está autenticado
// $status->authType - Tipo de autenticación (enum AuthInfoType: gh-cli, token, env, etc.)
// $status->login - Nombre de login de GitHub
// $status->host - Host de GitHub
// $status->copilotPlan - Plan de Copilot (individual, business, etc.)
// $status->statusMessage - Mensaje del estado de autenticación
```

## accounts (selección de cuenta para el inicio de sesión interactivo)

Usa `accounts()` para enumerar las cuentas guardadas disponibles para iniciar sesión y para iniciar un inicio de sesión interactivo. El `label` de cada elemento sirve para mostrarlo, y `active` indica si la identidad coincide con la cuenta activa de la sesión actual. `accountId` es un ID opaco propiedad del proveedor. Pásalo tal cual a la petición de inicio de sesión, sin analizarlo ni modificarlo.

```php theme={null}
use Revolution\Copilot\Enums\AuthLoginMode;
use Revolution\Copilot\Enums\LoginProviderKind;
use Revolution\Copilot\Types\Rpc\AuthLoginBeginRequest;

$accounts = $session->rpc()->accounts();
$identities = $accounts->enumerate(
    'loginAccounts',
    provider: LoginProviderKind::ENTRA,
);

if (isset($identities[0])) {
    $accounts->begin(new AuthLoginBeginRequest(
        kind: LoginProviderKind::ENTRA,
        mode: AuthLoginMode::Default,
        accountId: $identities[0]->accountId,
    ));
}
```

Usa `mode: 'default'` para reutilizar una identidad guardada con el comportamiento normal del proveedor. Usa `mode: 'selectAccount'` para mostrar explícitamente el selector de cuentas del proveedor. En ese caso, no pases `accountId`. Para más detalles, consulta [Autenticación](https://kawax.biz/es/packages/laravel-copilot-sdk/auth.md).


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Socialite (LINE Login) - LINE SDK for Laravel](https://kawax.biz/es/packages/laravel-line-sdk/socialite.md)
- [Laravel Cloud CLI — Operar Laravel Cloud desde la terminal](https://kawax.biz/es/blog/laravel-cloud-cli.md)
- [Context (contexto)](https://kawax.biz/es/context.md)
- [Laravel Sanctum (autenticación con API tokens)](https://kawax.biz/es/sanctum.md)


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