Repository navigation
Description
Summary
Microsoft.Agents.AI.GitHub.Copilot (latest preview 1.3.0-preview.260423.1) is incompatible with GitHub.Copilot.SDK 0.3.0+. Any consumer that needs SDK 0.3.0 features (e.g. per-session SessionConfig.GitHubToken) hits a hard runtime failure the first time the agent runs.
Environment
- Package: Microsoft.Agents.AI.GitHub.Copilot 1.3.0-preview.260423.1
- SDK in consumer app: GitHub.Copilot.SDK 0.3.0
- Runtime: .NET 10
- Host: Azure Container Apps (also reproduces locally against the installed Copilot CLI)
Repro
- Reference
Microsoft.Agents.AI.GitHub.Copilot 1.3.0-preview.260423.1in a .NET 10 project. - Pin
GitHub.Copilot.SDKto0.3.0(required for per-sessionSessionConfig.GitHubToken). - Construct
GitHubCopilotAgentagainst a startedCopilotClientand callRunAsync/RunStreamingAsync.
Expected
Agent run completes; the CLI returns a response.
Actual
Runtime TypeLoadException is thrown inside the wrapper as soon as the agent attempts to send a message — specifically on UserMessageDataAttachmentsItem / UserMessageDataAttachmentsItemFile, which were renamed in SDK 0.3.0. The CLI process is healthy (handshake/ping succeeds), but the managed-side wrapper fails to load because it was compiled against SDK 0.1.29's type surface.
In production this manifests as the agent run hanging / no response being streamed back to the caller, with the TypeLoadException surfacing in container logs.
Root Cause
SDK 0.3.0 performed a broad type-naming cleanup ahead of GA. The types used by this package were renamed:
| Old (SDK 0.1.29) | New (SDK 0.3.0) |
|---|---|
UserMessageDataAttachmentsItem |
UserMessageAttachment |
UserMessageDataAttachmentsItemFile |
UserMessageAttachmentFile |
McpLocalServerConfig |
McpStdioServerConfig |
McpRemoteServerConfig |
McpHttpServerConfig |
Additionally, SDK 0.3.0 now requires OnPermissionRequest to be set on SessionConfig when creating a session — previously optional, omitting it now throws ArgumentException.
Several new properties were also added to SessionConfig and ResumeSessionConfig (e.g. GitHubToken, IncludeSubAgentStreamingEvents, EnableConfigDiscovery, DefaultAgent, ModelCapabilities, OnElicitationRequest, Commands, CreateSessionFsHandler) that were not being forwarded through the copy helpers.
Impact
Blocks any consumer that needs GitHub.Copilot.SDK 0.3.0 — including everyone who needs per-session GitHubToken overrides, scoped permissions, sub-agent streaming control, and other 0.3.0-only features. There is no workable version pairing of Microsoft.Agents.AI.GitHub.Copilot + GitHub.Copilot.SDK 0.3.0 today.
Proposed Fix / PR
A PR has been opened that:
- Bumps
GitHub.Copilot.SDKfrom 0.1.29 → 0.3.0 - Fixes all renamed types across source and tests
- Forwards all new SDK 0.3.0
SessionConfig/ResumeSessionConfigproperties through the copy helpers - Threads
OnPermissionRequestthrough the tools/instructions constructor so callers can provide a handler without needing to construct aSessionConfigmanually - Updates integration tests for the new SDK requirements
PR Link - [BREAKING] .NET: Bump up GitHub.Copilot.SDK to 0.3.0 version #5574
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsDone
Activity
[-]Bump up GitHub.Copilot.SDK to 0.3.0 version[/-][+].NET: Bump up GitHub.Copilot.SDK to 0.3.0 version[/+]saikir1994 commentedon May 4, 2026
Giles Odigwe (@giles17) - Hi, I see this is assigned to you.
I have an Open PR for this - please Let me know if that can be merged/reused - #5574