Python: Migrate GitHub Copilot package to SDK 0.2.x

[droideronline]

Fixes #5106

Summary

Scoped to SDK 0.2.x compatibility fixes only. OTel/telemetry integration will follow in a separate PR.

• Replace all imports from the non-existent copilot.types module with correct SDK 0.2.x module paths across _agent.py, the test file, all 7 samples, and the sample validation script
• Fix PermissionRequest.get("kind") dict-style access to .kind attribute access (PermissionRequest is a dataclass in 0.2.x, not a TypedDict)
• Update start() to use SubprocessConfig instead of the removed CopilotClientOptions dict; only pass log_level when explicitly set to preserve SDK default behavior
• Update _create_session and _resume_session to call the SDK with direct keyword arguments instead of the removed SessionConfig / ResumeSessionConfig TypedDicts; add _deny_all_permissions fallback since on_permission_request is now required
• Update pyproject.toml dependency constraint to github-copilot-sdk>=0.2.0,<0.3.0
• Update tests to match new SDK API shapes

Root Cause

copilot.types does not exist in SDK 0.2.x. Types were reorganised:

Type	0.2.x module
PermissionRequest, SessionEvent, SessionEventType	copilot.generated.session_events
PermissionRequestResult, MCPServerConfig, SystemMessageConfig	copilot.session
Tool, ToolInvocation, ToolResult	copilot.tools

Additionally the following APIs changed:

• CopilotClientOptions dict removed; CopilotClient now takes SubprocessConfig
• SessionConfig / ResumeSessionConfig TypedDicts removed; create_session / resume_session now take keyword arguments
• send / send_and_wait now take a plain str prompt instead of a MessageOptions dict
• on_permission_request is now a required parameter for create_session / resume_session

Test Plan

• uv run poe test passes (77 tests, 0 failures)
• uv run poe lint passes (ruff, pyright, mypy)
• All 7 samples import without ModuleNotFoundError

[Copilot]

Pull request overview

This PR updates the agent-framework-github-copilot Python integration to be compatible with github-copilot-sdk 0.2.x by migrating type imports away from the removed copilot.types module, updating session/tool invocation call shapes, and adding sample-level OpenTelemetry enablement plus new Copilot CLI telemetry environment variables.

Changes:

• Bump dependency constraints to github-copilot-sdk>=0.2.0,<0.3.0 (and update uv.lock accordingly).
• Migrate Copilot SDK imports and API usage (e.g., create_session(**kwargs), send(prompt)/send_and_wait(prompt)), and update tests/samples to match.
• Add OTel instrumentation wrapper (GitHubCopilotAgent via AgentTelemetryLayer) and document Copilot CLI telemetry env vars in the samples README.

Reviewed changes

Copilot reviewed 14 out of 15 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
python/uv.lock	Locks github-copilot-sdk to 0.2.1 and updates resolver markers.
python/packages/github_copilot/pyproject.toml	Bumps github-copilot-sdk dependency range to 0.2.x.
python/packages/github_copilot/agent_framework_github_copilot/_agent.py	Migrates SDK imports/APIs, adds telemetry layer wrapper, adds default permission handler + CLI telemetry wiring.
python/packages/github_copilot/agent_framework_github_copilot/init.py	Exports RawGitHubCopilotAgent alongside the instrumented agent.
python/packages/core/agent_framework/github/init.py / init.pyi	Re-exports RawGitHubCopilotAgent from the core agent_framework.github shim.
python/packages/github_copilot/tests/test_github_copilot_agent.py	Updates mocks/assertions to reflect SDK 0.2.x API shapes and dataclass access.
python/samples/README.md	Documents new Copilot CLI telemetry environment variables.
python/samples/02-agents/providers/github_copilot/*.py	Updates import paths; enables OTel providers in select samples.

[droideronline]

@dmytrostruk @eavanvalkenburg @moonbox3 @TaoChenOSU - requesting your review on this PR. Thanks!

[moonbox3]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/github_copilot/agent_framework_github_copilot
_agent.py	314	20	93%	39–40, 46, 65, 291, 294–296, 333, 335, 337, 340, 433–434, 709–710, 725, 728, 795, 826
TOTAL	27092	3197	88%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
5373	20 💤	0 ❌	0 🔥	1m 30s ⏱️

[eavanvalkenburg]

we prefer to have smaller increments allowed when dealing with pre-release packages like this, could we make it so that we allow:

Suggested change

	"github-copilot-sdk>=0.2.0,<0.3.0; python_version >= '3.11'",
	"github-copilot-sdk>=0.1.31,<=0.2.0; python_version >= '3.11'",

That way existing users are not broken, and we don't go too far up to the latest and potentially pull in breaking packages, I noticed in the 0.2.1 release notes that that has breaking changes compared to 0.2.0 so the proposed range is too broad already.

[droideronline]

Good point - fixed in the latest commit. Applied <=0.2.0 as the upper bound to avoid pulling in 0.2.1+ breaking changes. I kept >=0.2.0 as the lower bound (rather than >=0.1.31) because this migration changes all import paths to 0.2.x-only modules (copilot.generated.session_events, copilot.session, copilot.tools) - installing 0.1.31 would satisfy the constraint but fail at import time. So the effective range is pinned to exactly 0.2.0 for now. uv.lock updated alongside.