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` со всеми возможными полями как опциональные/нулируемые. Для каждого типа события заполнены только поля, указанные в таблицах ниже — остальные будут `None` / `nil`.
>
> \[!TIP]
> **(.NET)** SDK .NET использует отдельные, сильно типированные классы данных для каждого события (например, `AssistantMessageDeltaData`), поэтому для каждого типа существуют только соответствующие поля.
>
> \[!TIP]
> **(TypeScript)** SDK TypeScript использует дискриминированное объединение — при совпадении на `event.type`, `data` полезная нагрузка автоматически сужается до нужной формы.
## Соревнования ассистентов
Эти события отслеживают жизненный цикл реакции агента — от запуска ходов через потоковые фрагменты до финального сообщения.
### `assistant.turn_start`
Излучается, когда агент начинает обрабатывать ход.
| Поле данных | Тип | Обязательный | Description |
| ----------------------------------------------------------- | -------- | ------------ | --------------------------------------------------- |
| `turnId` | `string` | ✅ | Идентификатор поворота (обычно строчный номер хода) |
| `interactionId` | `string` | | |
| Идентификатор взаимодействия CAPI для корреляции телеметрии | | | |
### `assistant.intent`
Эфемерно. Краткое описание того, чем сейчас занимается агент, обновляется по мере работы.
| Поле данных | Тип | Обязательный | Description |
| ----------- | -------- | ------------ | ------------------------------------------------------------------ |
| `intent` | `string` | ✅ | Человекочитаемый намерение (например, «Исследование кодовой базы») |
### `assistant.reasoning`
Полный расширенный размышленный блок из модели. Выпущено после завершения рассуждений.
| Поле данных | Тип | Обязательный | Description |
| ------------- | -------- | ------------ | ---------------------------------------------------- |
| `reasoningId` | `string` | ✅ | Уникальный идентификатор для этого блока рассуждения |
| `content` | `string` | ✅ | Полный расширенный текст мышления |
### `assistant.reasoning_delta`
Эфемерно. Постепенная часть расширенного мышления модели, транслируемая в реальном времени.
| Поле данных | Тип | Обязательный | Description |
| -------------- | -------- | ------------ | ---------------------------------------------------------- |
| `reasoningId` | `string` | ✅ | Совпадает с соответствующим `assistant.reasoning` событием |
| `deltaContent` | `string` | ✅ | Текст для добавления к содержанию рассуждения |
### `assistant.message`
Полный ответ ассистента на этот звонок LLM. Может содержать запросы на вызов инструментов.
| Поле данных | Тип | Обязательный | Description |
| ---------------------------------------------------------------------------- | --------------- | ------------ | -------------------------------------------- |
| `messageId` | `string` | ✅ | Уникальный идентификатор для этого сообщения |
| `content` | `string` | ✅ | Ответ ассистента в тексте |
| `toolRequests` | `ToolRequest[]` | | |
| Вызовы инструментов, которые хочет сделать ассистент (см. ниже) | | | |
| `reasoningOpaque` | `string` | | |
| Зашифрованное расширенное мышление (антропные модели); Привязанный к сеансам | | | |
| `reasoningText` | `string` | | |
| Читаемый текст рассуждений из расширенного мышления | | | |
| `encryptedContent` | `string` | | |
| Зашифрованное рассуждение (модели OpenAI); Привязанный к сеансам | | | |
| `phase` | `string` | | |
| Фаза генерации (например, `"thinking"` против `"response"`) | | | |
| `outputTokens` | `number` | | |
| Фактическое количество токенов вывода из ответа API | | | |
| `interactionId` | `string` | | |
| Идентификатор взаимодействия CAPI для телеметрии | | | |
| `parentToolCallId` | `string` | | |
| Устанавливается, когда это сообщение исходит от субагента | | | |
\*\*
`ToolRequest` Области:\*\*
| Поле | Тип | Обязательный | Description |
| --------------------------------------------------------- | ------------------------ | ------------ | ------------------------------------------------------------- |
| `toolCallId` | `string` | ✅ | Уникальный идентификатор для этого вызова инструмента |
| `name` | `string` | ✅ | Название инструмента (например, `"bash"`, `"edit"`, `"grep"`) |
| `arguments` | `object` | | |
| Проанализированные аргументы в пользу инструмента | | | |
| `type` | `"function" \| "custom"` | | |
| Тип вызова; по `"function"` умолчанию — когда отсутствует | | | |
### `assistant.message_delta`
Эфемерно. Постепенный фрагмент ответа ассистента в реальном времени.
| Поле данных | Тип | Обязательный | Description |
| ---------------------------------- | -------- | ------------ | -------------------------------------------------------- |
| `messageId` | `string` | ✅ | Совпадает с соответствующим `assistant.message` событием |
| `deltaContent` | `string` | ✅ | Текстовый фрагмент для добавления к сообщению |
| `parentToolCallId` | `string` | | |
| Set при возникновении от субагента | | | |
### `assistant.turn_end`
Издаётся после завершения хода агентом (выполнение всех инструментов завершено, финальный ответ получен).
| Поле данных | Тип | Обязательный | Description |
| ----------- | -------- | ------------ | ----------------------------------------------------------- |
| `turnId` | `string` | ✅ | Совпадает с соответствующим `assistant.turn_start` событием |
### `assistant.usage`
Эфемерно. Информация об использовании токена и стоимости для отдельного вызова API.
| Поле данных | Тип | Обязательный | Description |
| ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ------------ | -------------------------------------------- |
| `model` | `string` | ✅ | Идентификатор модели (например, `"gpt-4.1"`) |
| `inputTokens` | `number` | | |
| Расходуемые входные токены | | | |
| `outputTokens` | `number` | | |
| Выпускные токены | | | |
| `cacheReadTokens` | `number` | | |
| Токены, читаемые из кэша prompt | | | |
| `cacheWriteTokens` | `number` | | |
| Токены, записываемые для кэша prompt | | | |
| `cost` | `number` | | |
| Стоимость мультипликатора модели для выставления счетов | | | |
| `duration` | `number` | | |
| Длительность вызова API в миллисекундах | | | |
| `initiator` | `string` | | |
| Что спровоцировало этот вызов (например, `"sub-agent"`); отсутствует для инициированного пользователем | | | |
| `apiCallId` | `string` | | |
| Идентификатор завершения от провайдера (например, `chatcmpl-abc123`) | | | |
| `apiEndpoint` | `"/chat/completions" \| "/v1/messages" \| "/responses" \| "ws:/responses"` | | |
| API-конечная точка, используемая для вызова модели; Полезно для атрибуции наблюдаемости и стоимости. | | | |
| `ws:/responses` является вариантом websocket API ответов | | | |
| `providerCallId` | `string` | | |
| GitHub запросить трассировочный идентификатор (`x-github-request-id`) | | | |
| `parentToolCallId` | `string` | | |
| Устанавливается, когда использование исходит от субагента | | | |
| `quotaSnapshots` | `Record