Telemetry

use Revolution\Copilot\Enums\SessionEventType;

if ($event->type === SessionEventType::ASSISTANT_USAGE) {
    $customCalls = $event->customToolCallCount();
    $orphanCalls = $event->orphanToolCallCount();
    $unmatchedResults = $event->unmatchedToolResultCount();
}

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\GitHubTelemetryNotification;

Copilot::useStdio([
    'onGitHubTelemetry' => function (GitHubTelemetryNotification $notification): void {
        if ($notification->restricted) {
            // Restricted events must only be sent to first-party Microsoft stores.
            return;
        }

        logger()->info('Copilot telemetry event', [
            'session_id' => $notification->sessionId,
            'kind' => $notification->event->kind,
        ]);
    },
]);

// config/copilot.php
'telemetry' => [
    'otlpEndpoint' => 'http://localhost:4318',
],

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\TelemetryConfig;

Copilot::useStdio([
    'telemetry' => new TelemetryConfig(
        otlpEndpoint: 'http://localhost:4318',
    )
]);

$response = Copilot::run(prompt: 'Hello');

use Revolution\Copilot\Client;
use Revolution\Copilot\Types\TelemetryConfig;

$client = new Client([
    'telemetry' => new TelemetryConfig(
        otlpEndpoint: 'http://localhost:4318',
    ),
]);

composer require open-telemetry/api open-telemetry/sdk

use Revolution\Copilot\Support\TraceContext;

TraceContext::useProvider(function (): array {
    return [
        'traceparent' => '00-traceid-spanid-01',
        'tracestate' => 'vendor=value',
    ];
});

$session->registerTools([
    [
        'name' => 'my-tool',
        'description' => 'My custom tool',
        'handler' => function (array $args, array $invocation) {
            // 來自 CLI 的 span 追蹤 context
            $traceparent = $invocation['traceparent'] ?? null;
            $tracestate = $invocation['tracestate'] ?? null;

            // 若安裝了 open-telemetry/api,
            // context 會自動恢復,
            // 在此建立的 span 會成為 CLI span 的子 span

            return 'result';
        },
    ],
]);