Skip to content

.NET: Bump up GitHub.Copilot.SDK to 0.3.0 version #5575

Closed

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

  1. Reference Microsoft.Agents.AI.GitHub.Copilot 1.3.0-preview.260423.1 in a .NET 10 project.
  2. Pin GitHub.Copilot.SDK to 0.3.0 (required for per-session SessionConfig.GitHubToken).
  3. Construct GitHubCopilotAgent against a started CopilotClient and call RunAsync / 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.SDK from 0.1.29 → 0.3.0
  • Fixes all renamed types across source and tests
  • Forwards all new SDK 0.3.0 SessionConfig/ResumeSessionConfig properties through the copy helpers
  • Threads OnPermissionRequest through the tools/instructions constructor so callers can provide a handler without needing to construct a SessionConfig manually
  • Updates integration tests for the new SDK requirements
    PR Link - [BREAKING] .NET: Bump up GitHub.Copilot.SDK to 0.3.0 version #5574

Activity

  1. added
    .NETUsage: [Issues, PRs], Target: .Net
    triageUsage: [Issues], Target: All issues that still need to be triaged
    on Apr 29, 2026
  2. changed the title [-]Bump up GitHub.Copilot.SDK to 0.3.0 version[/-] [+].NET: Bump up GitHub.Copilot.SDK to 0.3.0 version[/+] on Apr 29, 2026
  3. removed
    triageUsage: [Issues], Target: All issues that still need to be triaged
    on May 3, 2026
  4. saikir1994 commented on May 4, 2026

    @saikir1994
    ContributorAuthor

    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

  5. moved this from Planned to In Progress in Agent Frameworkon May 4, 2026
  6. moved this from In Progress to In Review in Agent Frameworkon May 4, 2026
  7. moved this from In Review to Done in Agent Frameworkon May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

.NETUsage: [Issues, PRs], Target: .Net

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions