TypeScript
```typescript
// All events
session.on((event) => {
console.log(event.type, event.data);
});
// Specific event type — data is narrowed automatically
session.on("assistant.message_delta", (event) => {
process.stdout.write(event.data.deltaContent);
});
```
Python
```python
from copilot import CopilotClient
from copilot.generated.session_events import SessionEventType
client = CopilotClient()
session = None # assume session is created elsewhere
def handle(event):
if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA:
print(event.data.delta_content, end="", flush=True)
# session.on(handle)
```
```python
from copilot.generated.session_events import SessionEventType
def handle(event):
if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA:
print(event.data.delta_content, end="", flush=True)
session.on(handle)
```
Go
```golang
package main
import (
"context"
"fmt"
copilot "github.com/github/copilot-sdk/go"
"github.com/github/copilot-sdk/go/rpc"
)
func main() {
ctx := context.Background()
client := copilot.NewClient(nil)
session, _ := client.CreateSession(ctx, &copilot.SessionConfig{
Model: "gpt-4.1",
Streaming: copilot.Bool(true),
OnPermissionRequest: func(req copilot.PermissionRequest, inv copilot.PermissionInvocation) (rpc.PermissionDecision, error) {
return &rpc.PermissionDecisionApproveOnce{}, nil
},
})
session.On(func(event copilot.SessionEvent) {
if d, ok := event.Data.(*copilot.AssistantMessageDeltaData); ok {
fmt.Print(d.DeltaContent)
}
})
_ = session
}
```
```golang
session.On(func(event copilot.SessionEvent) {
if d, ok := event.Data.(*copilot.AssistantMessageDeltaData); ok {
fmt.Print(d.DeltaContent)
}
})
```
.NET
```csharp
using GitHub.Copilot;
public static class StreamingEventsExample
{
public static async Task Example(CopilotSession session)
{
session.On
(evt =>
{
if (evt is AssistantMessageDeltaEvent delta)
{
Console.Write(delta.Data.DeltaContent);
}
});
}
}
```
```csharp
session.On(evt =>
{
if (evt is AssistantMessageDeltaEvent delta)
{
Console.Write(delta.Data.DeltaContent);
}
});
```
Java
```java
// All events
session.on(event -> System.out.println(event.getType()));
// Specific event type — data is narrowed to the matching class
session.on(AssistantMessageDeltaEvent.class, event ->
System.out.print(event.getData().deltaContent())
);
```
> \[!TIP]
> **(Python/Go)** 이러한 SDK는 가능한 모든 필드와 함께 단일 `Data` 클래스/구조체를 선택적/nullable로 사용합니다. 아래 표에 나열된 필드만 각 이벤트 유형에 대해 채워집니다. 나머지는 다음과 같습니다 `None` / `nil`.
>
> \[!TIP]
> **(.NET)** .NET SDK는 이벤트당 강력한 형식의 별도의 데이터 클래스(예: `AssistantMessageDeltaData`)를 사용하므로 각 형식에 관련 필드만 존재합니다.
>
> \[!TIP]
> **(TypeScript)** TypeScript SDK는 태그된 유니온을 사용합니다. `event.type`을 기준으로 매칭하면 `data` 페이로드가 자동으로 올바른 형태로 좁혀집니다.
## 도우미 이벤트
이러한 이벤트는 턴 시작부터 스트리밍 청크를 거쳐 최종 메시지까지 에이전트의 응답 수명 주기를 추적합니다.
### `assistant.turn_start`
에이전트가 턴 처리를 시작할 때 내보내집니다.
| 데이터 필드 | Type | Required | Description |
| ----------------------------- | -------- | -------- | ----------------------- |
| `turnId` | `string` | ✅ | 턴 식별자(일반적으로 문자열화된 턴 번호) |
| `interactionId` | `string` | | |
| 원격 분석 상관 관계에 대한 CAPI 상호 작용 ID | | | |
### `assistant.intent`
임시. 에이전트가 현재 수행하는 작업에 대한 간단한 설명이며 작동하면서 업데이트됩니다.
| 데이터 필드 | Type | Required | Description |
| -------- | -------- | -------- | ----------------------------- |
| `intent` | `string` | ✅ | 사람이 읽을 수 있는 의도(예: "코드베이스 탐색") |
### `assistant.reasoning`
모델에서 확장된 사고 블록을 완성합니다. 추론이 완료된 후 내보냅니다.
| 데이터 필드 | Type | Required | Description |
| ------------- | -------- | -------- | --------------- |
| `reasoningId` | `string` | ✅ | 이 추론 블록의 고유 식별자 |
| `content` | `string` | ✅ | 확장된 사고 전체 텍스트 |
### `assistant.reasoning_delta`
임시. 실시간으로 스트리밍되는 모델의 확장된 사고의 증분 조각.
| 데이터 필드 | Type | Required | Description |
| -------------- | -------- | -------- | -------------------------------- |
| `reasoningId` | `string` | ✅ | 해당 이벤트와 일치 `assistant.reasoning` |
| `deltaContent` | `string` | ✅ | 추론 콘텐츠에 추가할 텍스트 청크 |
### `assistant.message`
이 LLM 호출에 대한 도우미의 전체 응답입니다. 도구 호출 요청을 포함할 수 있습니다.
| 데이터 필드 | Type | Required | Description |
| ------------------------------------- | --------------- | -------- | ------------- |
| `messageId` | `string` | ✅ | 이 메시지의 고유 식별자 |
| `content` | `string` | ✅ | 도우미의 텍스트 응답 |
| `toolRequests` | `ToolRequest[]` | | |
| 도우미가 수행하려는 도구 호출(아래 참조) | | | |
| `reasoningOpaque` | `string` | | |
| 암호화된 확장 사고(인류 모델); 세션 바인딩 | | | |
| `reasoningText` | `string` | | |
| 확장된 사고에서 읽을 수 있는 추론 텍스트 | | | |
| `encryptedContent` | `string` | | |
| 암호화된 추론 콘텐츠(OpenAI 모델); 세션 바인딩 | | | |
| `phase` | `string` | | |
| 생성 단계(예: `"thinking"` 대 `"response"`) | | | |
| `outputTokens` | `number` | | |
| API 응답의 실제 출력 토큰 수 | | | |
| `interactionId` | `string` | | |
| 원격 분석에 대한 CAPI 상호 작용 ID | | | |
| `parentToolCallId` | `string` | | |
| 이 메시지가 하위 에이전트에서 시작되는 경우 설정 | | | |
\*\*
`ToolRequest` 필드:\*\*
| Field | Type | Required | Description |
| ----------------------------------- | ------------------------ | -------- | -------------------------------------- |
| `toolCallId` | `string` | ✅ | 이 도구 호출의 고유 ID |
| `name` | `string` | ✅ | 도구 이름(예: , `"bash"`, `"edit"``"grep"`) |
| `arguments` | `object` | | |
| 구문 분석된 도구의 인수 | | | |
| `type` | `"function" \| "custom"` | | |
| 호출 유형; 없는 경우 기본값은 `"function"` 입니다. | | | |
### `assistant.message_delta`
임시. 실시간으로 스트리밍되는 도우미 텍스트 응답의 증분 조각.
| 데이터 필드 | Type | Required | Description |
| ------------------ | -------- | -------- | ------------------------------ |
| `messageId` | `string` | ✅ | 해당 이벤트와 일치 `assistant.message` |
| `deltaContent` | `string` | ✅ | 메시지에 추가할 텍스트 청크 |
| `parentToolCallId` | `string` | | |
| 하위 에이전트에서 시작될 때 설정 | | | |
### `assistant.turn_end`
에이전트가 턴을 완료할 때 내보내집니다(모든 도구 실행이 완료되고 최종 응답이 전달됨).
| 데이터 필드 | Type | Required | Description |
| -------- | -------- | -------- | --------------------------------- |
| `turnId` | `string` | ✅ | 해당 이벤트와 일치 `assistant.turn_start` |
### `assistant.usage`
임시. 개별 API 호출에 대한 토큰 사용량 및 비용 정보입니다.
| 데이터 필드 | Type | Required | Description |
| ------------------------------------------------- | ------------------------------- | -------- | ---------------------- |
| `model` | `string` | ✅ | 모델 식별자(예: `"gpt-4.1"`) |
| `inputTokens` | `number` | | |
| 사용된 입력 토큰 | | | |
| `outputTokens` | `number` | | |
| 생성된 출력 토큰 | | | |
| `cacheReadTokens` | `number` | | |
| 프롬프트 캐시에서 읽은 토큰 | | | |
| `cacheWriteTokens` | `number` | | |
| 프롬프트 캐시에 기록된 토큰 | | | |
| `cost` | `number` | | |
| 비용 청구를 위한 모델 승수 비용 | | | |
| `duration` | `number` | | |
| API 호출 기간(밀리초) | | | |
| `initiator` | `string` | | |
| 이 호출을 발생시킨 항목(예: `"sub-agent"`); 사용자가 시작한 경우에는 없음 | | | |
| `apiCallId` | `string` | | |
| 공급자의 완료 ID(예: `chatcmpl-abc123`) | | | |
| `providerCallId` | `string` | | |
| GitHub 요청 추적 ID(`x-github-request-id`) | | | |
| `parentToolCallId` | `string` | | |
| 하위 에이전트에서 사용이 시작되는 경우 설정 | | | |
| `quotaSnapshots` | `Record