Feature: Strongly type Python events

オープン

#1,016 2026年4月6日に作成コメント 0 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 5/5
見積もり時間: 1週間以上
初心者へのやさしさ: 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 type に対応するかを定義し、Python の型チェッカーが union に依存せず、各イベントに対して正しい payload を公開することを確認します。

索引モデルが 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時間
マージ済み PR（30日）: 131

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
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][UI] Change the method of opening the Action Detail オープン

難易度 2/5 1〜3時間初心者へのやさしさ 65/100

Netcracker/qubership-integration-platform#913 · 2026年9月23日に作成
SEC-CORS-006 declares MEDIUM but can only emit HIGH or LOW オープン

bug

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

jdubois/boot-ui#1100 · 2026年9月23日に作成
build-scan-xunit: accept ISO offset timestamps in test reports オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

elastic/gradle-plugins#157 · 2026年9月23日に作成
OpenAPI document marks optional request body of `PUT /api/users/me` as required オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

cryptomator/hub#497 · 2026年9月23日に作成
No test covers the claim that only the last command's state is checked オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

johanhaleby/occurrent#1120 · 2026年9月23日に作成

Java の issue をもっと見る