Feature: Strongly type Python events

未关闭

#1,016 创建于 2026年4月6日 0 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 5/5
预计耗时: 一周以上
新手友好度: 45/100

Issue 类型: 功能
描述清晰度: 基本清楚
活跃度: 冷清
技术栈: python
领域: api, developer-experience

调研方向

从 python/copilot/generated/session_events.py 中的 Python Data 和 SessionEvent 定义开始，然后将 dotnet/src/Generated/SessionEvents.cs 中的强类型事件结构与对应的 Claude Agent SDK 类型进行比较。定义每个事件如何映射到其 payload 类型，并验证 Python 类型检查器能够为每个事件公开正确的 payload，而不依赖 union。

由索引模型根据 Issue 内容生成。

描述

enhancement

Hi,

I was trying to build against the SDK in Python, and I got confused about which events carried what payloads. The Data class is a union of all possible data fields:

https://github.com/github/copilot-sdk/blob/f7fd7577109d64e261456b16c49baa56258eae4e/python/copilot/generated/session_events.py#L1773

SessionEvent largely a pair of enum and Data with a long docstring:

https://github.com/github/copilot-sdk/blob/f7fd7577109d64e261456b16c49baa56258eae4e/python/copilot/generated/session_events.py#L3229

Other bindings in dotnet, for example, strongly type the events, so you know what events carry what payloads:

https://github.com/github/copilot-sdk/blob/f7fd7577109d64e261456b16c49baa56258eae4e/dotnet/src/Generated/SessionEvents.cs#L134

I think stronger type hinting on the Python side would help make the SDK easier to consume by catching classes of bugs at IDE/Pyright/agent coding time. It has precedent on the Claude Agent SDK, which does adopt this pattern for its message type:

https://github.com/anthropics/claude-agent-sdk-python/blob/13f65c81e2bec2a5d1f1e1efdd45aa061c4ec43f/src/claude_agent_sdk/types.py#L1071

It's a breaking change to people using type hints, but I suspect we could do it in such a way that the only breaks would be people genuinely looking in the wrong place for payloads (i.e. silent bugs).

主要语言: Java
星标: 10.5k
派生: 1.5k
平均合并: 1 天 9 小时
30 天内合并 PR: 131

贡献指南

打开贡献指南

从这里开始

先读完整个 Issue，再读项目的贡献指南。
在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
Fork 仓库，在一个分支上完成修改。
提交 Pull Request，并在描述里引用这个 Issue 编号。

github/copilot-sdk 的其他 Issue

[aw] Issue Classification Agent timed out 未关闭

agentic-workflows

难度 2/5 1-3 小时新手友好度 68/100

github/copilot-sdk#2709 · 1 条评论 · 2026年9月17日创建
_connect_via_tcp notification handler reads self._sessions without _sessions_lock 未关闭

难度 1/5 1 小时以内新手友好度 78/100

github/copilot-sdk#2673 · 2026年9月15日创建
Replay catalog omits the image capacity required by saved histories 未关闭

bug testing

难度 2/5 1-3 小时新手友好度 75/100

github/copilot-sdk#2628 · 2026年9月11日创建
[aw] Issue Classification Agent timed out 未关闭

agentic-workflows

难度 2/5 1-3 小时新手友好度 68/100

github/copilot-sdk#2627 · 1 条评论 · 2026年9月11日创建
[aw] Issue Classification Agent failed 未关闭

agentic-workflows

难度 2/5 1-3 小时新手友好度 74/100

github/copilot-sdk#2493 · 2026年9月2日创建

查看 github/copilot-sdk 的全部 Issue

相似的 Issue

[Bug]: JavaScript dialog is complaining about changes when there were none 未关闭

awaiting triage bug Causes friction Hop Gui P1 P2 Transforms

难度 2/5 1-3 小时新手友好度 75/100

apache/hop#8564 · 2026年9月23日创建
[Bug][api] MemoryRef equality ignores the memory type 未关闭

难度 2/5 1-3 小时新手友好度 75/100

apache/flink-agents#1152 · 2026年9月23日创建
Gauntlet loot not showing up in boss section 未关闭

难度 2/5 1-3 小时新手友好度 75/100

TheStonedTurtle/Loot-Logger#97 · 2026年9月23日创建
TryBlueOceanMenu allocates a per-FlowNode URL object trio, retaining ~21 GiB on large pipeline graphs 未关闭

难度 2/5 1-3 小时新手友好度 70/100

jenkinsci/blueocean-plugin#5417 · 2026年9月23日创建
Dijkstra entry point crashes with ArrayIndexOutOfBoundsException when a vertex id exceeds the argument count 未关闭

难度 2/5 1-3 小时新手友好度 75/100

objectionary/eo-graphs#75 · 2026年9月23日创建

更多 Java Issue