Track official SDK PR #427: Add session context, filtering, and context_changed event

[Copilot]

Ports changes from official SDK PR #427 adding session context tracking and filtering capabilities.

Changes

New Types

• SessionContext - Working directory and Git metadata (cwd, gitRoot, repository, branch)
• SessionListFilter - Filter criteria for session listing

Updated Types

• SessionMetadata.context - Optional session context field
• SessionEventType::SESSION_CONTEXT_CHANGED - Event for directory changes during session

API Changes

• Client::listSessions() - Now accepts optional SessionListFilter|array|null parameter
• CopilotClient interface updated to match

Usage

use Revolution\Copilot\Facades\Copilot;

// Filter sessions by repository
$sessions = Copilot::client()->listSessions(['repository' => 'owner/repo']);

// Access context information
foreach ($sessions as $metadata) {
    if ($metadata->context) {
        echo "{$metadata->context->repository} @ {$metadata->context->branch}\n";
    }
}

// Handle context changes
$session->on(function ($event) {
    if ($event->type === 'session.context_changed') {
        // Context changed during session
    }
});

Compatibility

• Requires Copilot CLI v0.0.409+ for context fields
• Fully backward compatible - filter parameter and context field are optional
• Maintains parity with official SDK implementations (Node.js, Python, Go, .NET)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/copilot_internal/user
  • Triggering command: /home/REDACTED/.local/bin/copilot copilot --headless --stdio --log-level info /usr/lib/git-core/git-submodule stty /bin/stty (http block)
  • Triggering command: /home/REDACTED/.local/bin/copilot copilot --headless --stdio --log-level info (http block)
  • Triggering command: /home/REDACTED/.local/bin/copilot copilot --headless --stdio --log-level info /bin/stty stty de/node/bin/stty (http block)
• https://api.github.com/repos/github/copilot-sdk/pulls/427
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.