Contesto e filtraggio della sessione

Da GitHub Copilot SDK v0.1.24 è stato aggiunto un contesto che include working directory e informazioni Git nella sessione, ed è ora possibile filtrare l’elenco delle sessioni.

SessionContext

SessionContext conserva la working directory e le informazioni del repository Git al momento della creazione della sessione.

Proprietà

cwd (string): percorso assoluto della working directory
gitRoot (?string): directory radice del repository Git (null fuori da un repository Git)
repository (?string): repository GitHub (formato owner/repo, ad es. invokable/laravel-copilot-sdk)
branch (?string): nome del branch Git corrente

Esempio d’uso

use Revolution\Copilot\Facades\Copilot;

// Ottieni l'elenco delle sessioni
$sessions = Copilot::client()->listSessions();

foreach ($sessions as $metadata) {
    echo "Session: {$metadata->sessionId}\n";

    if ($metadata->context !== null) {
        echo "  working directory: {$metadata->context->cwd}\n";

        if ($metadata->context->repository !== null) {
            echo "  repository: {$metadata->context->repository}\n";
            echo "  branch: {$metadata->context->branch}\n";
        }
    }
}

SessionListFilter

Con SessionListFilter puoi ottenere solo le sessioni di una specifica working directory o repository.

Proprietà

cwd (?string): filtro con match esatto sulla working directory
gitRoot (?string): filtro sulla directory Git root
repository (?string): filtro sul repository (formato owner/repo)
branch (?string): filtro sul nome del branch

Esempio d’uso

Specificare il filtro come array

use Revolution\Copilot\Facades\Copilot;

// Ottieni solo le sessioni di un repository specifico
$sessions = Copilot::client()->listSessions([
    'repository' => 'invokable/laravel-copilot-sdk',
]);

// Ottieni le sessioni in corso su un branch specifico
$sessions = Copilot::client()->listSessions([
    'repository' => 'owner/repo',
    'branch' => 'feature/new-feature',
]);

// Ottieni le sessioni di una working directory specifica
$sessions = Copilot::client()->listSessions([
    'cwd' => '/home/user/projects/my-app',
]);

Uso della classe SessionListFilter

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\SessionListFilter;

$filter = new SessionListFilter(
    repository: 'owner/repo',
    branch: 'main',
);

$sessions = Copilot::client()->listSessions($filter);

Evento `session.context_changed`

Se durante la sessione la working directory cambia, viene emesso l’evento session.context_changed.

Tipo di evento

use Revolution\Copilot\Enums\SessionEventType;

SessionEventType::SESSION_CONTEXT_CHANGED; // 'session.context_changed'

Dati dell’evento

I dati dell’evento includono le informazioni di contesto aggiornate.

use Revolution\Copilot\Facades\Copilot;

Copilot::start(function ($session) {
    $session->on(function ($event) {
        if ($event->type === 'session.context_changed') {
            $data = $event->data;

            echo "La working directory è cambiata\n";
            echo "  cwd: {$data['cwd']}\n";
            echo "  repository: {$data['repository']}\n";
            echo "  branch: {$data['branch']}\n";
        }
    });

    $response = $session->sendAndWait(
        prompt: 'Change to a different directory and list files',
    );
});

SessionMetadata

A SessionMetadata sono state aggiunte le proprietà context, clientName e lastClientName.

Nuova proprietà

context (?SessionContext): working directory e informazioni Git della sessione
clientName (?string): nome del client che ha creato la sessione (ad esempio github/cli), oppure null se sconosciuto
lastClientName (?string): nome del client che ha eseguito la sessione per ultimo. È il client che l’ha creata o un client che l’ha ripresa ed eseguita. Riprenderla solo per visualizzarla non lo modifica. È null per le sessioni precedenti in cui il valore è sconosciuto

Esempio d’uso

use Revolution\Copilot\Facades\Copilot;

$sessions = Copilot::client()->listSessions();

foreach ($sessions as $metadata) {
    echo "Session ID: {$metadata->sessionId}\n";
    echo "Ora di inizio: {$metadata->startTime}\n";

    // context è opzionale, quindi controlla null
    if ($metadata->context !== null) {
        echo "Contesto:\n";
        echo "  working directory: {$metadata->context->cwd}\n";

        if ($metadata->context->repository !== null) {
            echo "  repository: {$metadata->context->repository}\n";
        }

        if ($metadata->context->branch !== null) {
            echo "  branch: {$metadata->context->branch}\n";
        }
    }

    echo "\n";
}

Esempi pratici

Ottenere le sessioni di un progetto specifico

use Revolution\Copilot\Facades\Copilot;

// Ottieni solo le sessioni del progetto Laravel Copilot SDK
$sessions = Copilot::client()->listSessions([
    'repository' => 'invokable/laravel-copilot-sdk',
]);

// Mostra le sessioni in corso
foreach ($sessions as $metadata) {
    echo "{$metadata->sessionId}: {$metadata->summary}\n";
    echo "  branch: {$metadata->context->branch}\n";
}

Gestire le sessioni di un feature branch

use Revolution\Copilot\Facades\Copilot;

$sessions = Copilot::client()->listSessions();

$featureSessions = array_filter($sessions, function ($metadata) {
    return $metadata->context !== null
        && str_starts_with($metadata->context->branch ?? '', 'feature/');
});

// Raggruppa le sessioni per feature branch
$byBranch = [];
foreach ($featureSessions as $metadata) {
    $branch = $metadata->context->branch;
    $byBranch[$branch][] = $metadata;
}

foreach ($byBranch as $branch => $sessions) {
    echo "{$branch}: " . count($sessions) . " sessioni\n";
}

Organizzare le sessioni per working directory

use Revolution\Copilot\Facades\Copilot;

$sessions = Copilot::client()->listSessions();

// Raggruppa per working directory
$byCwd = [];
foreach ($sessions as $metadata) {
    if ($metadata->context !== null) {
        $cwd = $metadata->context->cwd;
        $byCwd[$cwd][] = $metadata;
    }
}

// Mostra il numero di sessioni per directory
foreach ($byCwd as $cwd => $sessions) {
    echo "{$cwd}: " . count($sessions) . " sessioni\n";
}

Note

context include informazioni Git (gitRoot, repository, branch) solo per sessioni create all’interno di un repository Git.
Il campo context è disponibile da Copilot CLI v0.0.409 in avanti. Nelle versioni precedenti viene restituito null.
Il filtraggio funziona con match esatto. Non sono supportati match parziali o wildcard.
Tutti i campi di SessionListFilter sono opzionali. Senza filtro vengono restituite tutte le sessioni.

Per le informazioni più recenti fai riferimento al repository GitHub.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kit

Feed e RSS

Middleware

Contesto e filtraggio della sessione