Session-Kontext und Filterung

Ab GitHub Copilot SDK v0.1.24 enthält jede Session einen Kontext mit Arbeitsverzeichnis und Git-Informationen, und Sie können die Session-Liste danach filtern.

SessionContext

SessionContext enthält Arbeitsverzeichnis und Git-Repository-Informationen zum Zeitpunkt der Session-Erstellung.

Eigenschaften

cwd (string): Absoluter Pfad des Arbeitsverzeichnisses
gitRoot (?string): Wurzelverzeichnis des Git-Repositorys (außerhalb eines Git-Repos null)
repository (?string): GitHub-Repository (Format owner/repo, z. B. invokable/laravel-copilot-sdk)
branch (?string): Aktueller Git-Branch-Name

Anwendungsbeispiel

use Revolution\Copilot\Facades\Copilot;

// Session-Liste abrufen
$sessions = Copilot::client()->listSessions();

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

    if ($metadata->context !== null) {
        echo "  作業ディレクトリ: {$metadata->context->cwd}\n";

        if ($metadata->context->repository !== null) {
            echo "  リポジトリ: {$metadata->context->repository}\n";
            echo "  ブランチ: {$metadata->context->branch}\n";
        }
    }
}

SessionListFilter

Mit SessionListFilter können Sie nur Sessions eines bestimmten Arbeitsverzeichnisses oder Repositorys abrufen.

Eigenschaften

cwd (?string): Exakter Filter auf das Arbeitsverzeichnis
gitRoot (?string): Filter auf das Git-Wurzelverzeichnis
repository (?string): Filter auf das Repository (Format owner/repo)
branch (?string): Filter auf den Branch-Namen

Anwendungsbeispiele

Filter als Array angeben

use Revolution\Copilot\Facades\Copilot;

// Nur Sessions eines bestimmten Repositorys abrufen
$sessions = Copilot::client()->listSessions([
    'repository' => 'invokable/laravel-copilot-sdk',
]);

// Sessions abrufen, die in einem bestimmten Branch arbeiten
$sessions = Copilot::client()->listSessions([
    'repository' => 'owner/repo',
    'branch' => 'feature/new-feature',
]);

// Sessions eines bestimmten Arbeitsverzeichnisses abrufen
$sessions = Copilot::client()->listSessions([
    'cwd' => '/home/user/projects/my-app',
]);

Verwendung der Klasse SessionListFilter

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

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

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

Event `session.context_changed`

Wenn sich das Arbeitsverzeichnis während einer Session ändert, wird das Event session.context_changed ausgelöst.

Event-Typ

use Revolution\Copilot\Enums\SessionEventType;

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

Event-Daten

Die Event-Daten enthalten die aktualisierten Kontextinformationen.

use Revolution\Copilot\Facades\Copilot;

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

            echo "作業ディレクトリが変更されました\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

SessionMetadata wurde um die Eigenschaften context, clientName und lastClientName erweitert.

Neue Eigenschaft

context (?SessionContext): Arbeitsverzeichnis und Git-Informationen der Session
clientName (?string): Name des Clients, der die Session erstellt hat (zum Beispiel github/cli), oder null, wenn unbekannt
lastClientName (?string): Name des Clients, der die Session zuletzt ausgeführt hat. Das ist der erstellende Client oder ein Client, der sie fortgesetzt und ausgeführt hat. Bloßes Fortsetzen zum Ansehen ändert den Wert nicht. Bei älteren Sessions ist der Wert unbekannt und daher null

Anwendungsbeispiel

use Revolution\Copilot\Facades\Copilot;

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

foreach ($sessions as $metadata) {
    echo "Session ID: {$metadata->sessionId}\n";
    echo "開始時刻: {$metadata->startTime}\n";

    // context ist optional, daher ist eine null-Prüfung nötig
    if ($metadata->context !== null) {
        echo "コンテキスト:\n";
        echo "  作業ディレクトリ: {$metadata->context->cwd}\n";

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

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

    echo "\n";
}

Praxisbeispiele

Sessions eines bestimmten Projekts abrufen

use Revolution\Copilot\Facades\Copilot;

// Nur Sessions des Projekts Laravel Copilot SDK abrufen
$sessions = Copilot::client()->listSessions([
    'repository' => 'invokable/laravel-copilot-sdk',
]);

// Laufende Sessions anzeigen
foreach ($sessions as $metadata) {
    echo "{$metadata->sessionId}: {$metadata->summary}\n";
    echo "  ブランチ: {$metadata->context->branch}\n";
}

Sessions von Feature-Branches verwalten

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/');
});

// Sessions je Feature-Branch gruppieren
$byBranch = [];
foreach ($featureSessions as $metadata) {
    $branch = $metadata->context->branch;
    $byBranch[$branch][] = $metadata;
}

foreach ($byBranch as $branch => $sessions) {
    echo "{$branch}: " . count($sessions) . " セッション\n";
}

Sessions nach Arbeitsverzeichnis organisieren

use Revolution\Copilot\Facades\Copilot;

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

// Nach Arbeitsverzeichnis gruppieren
$byCwd = [];
foreach ($sessions as $metadata) {
    if ($metadata->context !== null) {
        $cwd = $metadata->context->cwd;
        $byCwd[$cwd][] = $metadata;
    }
}

// Anzahl der Sessions pro Verzeichnis anzeigen
foreach ($byCwd as $cwd => $sessions) {
    echo "{$cwd}: " . count($sessions) . " セッション\n";
}

Hinweise

context enthält Git-Informationen (gitRoot, repository, branch) nur für Sessions, die innerhalb eines Git-Repos erstellt wurden.
Das Feld context ist ab Copilot CLI v0.0.409 verfügbar. In älteren Versionen wird null zurückgegeben.
Die Filterung funktioniert per exakter Übereinstimmung. Teilstring-Matching und Wildcards werden nicht unterstützt.
Alle Felder von SessionListFilter sind optional. Ohne Filterangabe werden alle Sessions zurückgegeben.

Aktuelle Informationen finden Sie im GitHub-Repository.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter Kits

Feeds und RSS

Middleware

Session-Kontext und Filterung