{"meta":{"title":"ストリーミング セッション イベント","intro":"Copilot エージェントが実行するすべてのアクション (思考、コードの記述、ツールの実行) は、サブスクライブできるセッション イベントとして出力されます。 このガイドは、SDK ソースを読み取らずに予想されるデータを正確に把握できるように、各イベントの種類のフィールド レベルのリファレンスです。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos","title":"方法"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk","title":"Copilot SDK"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features","title":"機能"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/streaming-events","title":"ストリーミング イベント"}],"documentType":"article"},"body":"# ストリーミング セッション イベント\n\nCopilot エージェントが実行するすべてのアクション (思考、コードの記述、ツールの実行) は、サブスクライブできるセッション イベントとして出力されます。 このガイドは、SDK ソースを読み取らずに予想されるデータを正確に把握できるように、各イベントの種類のフィールド レベルのリファレンスです。\n\n<!-- markdownlint-disable GHD046 GHD005 -->\n\n<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->\n\n## Overview\n\nセッションで`streaming: true`が設定されると、SDK は、**一時的な**イベント (デルタ、進行状況の更新) をリアルタイムで、**永続的な**イベント (完全なメッセージ、ツールの結果) と共に出力します。 すべてのイベントは共通のエンベロープを共有し、その形状がイベント `data`に依存する`type`ペイロードを運びます。\n\n![図: 説明されたプロセスを示すシーケンス図。](/assets/images/help/copilot/copilot-sdk/features-streaming-events-diagram-0.png)\n\n| 概念                  | Description                                                         |\n| ------------------- | ------------------------------------------------------------------- |\n| **エフェメラル イベント**     | 過渡;はリアルタイムでストリーミングされますが、セッション ログには保持 **されません** 。 セッションの再開時に再生されません。 |\n| **永続化されたイベント**      | ディスク上のセッション イベント ログに保存されます。 セッションの再開時に再生されます。                       |\n| **Delta イベント**      | 一時的なストリーミングデータチャンク（テキストまたは推論） 差分を蓄積して完全なコンテンツを構築します。                |\n| **`parentId` チェーン** | 各イベントの `parentId` は前のイベントを指し示し、ウォーク可能なリンクリストを形成します。                 |\n\n## イベント エンベロープ\n\n種類に関係なく、すべてのセッション イベントには次のフィールドが含まれます。\n\n| フィールド               | タイプ              | Description                                                                 |\n| ------------------- | ---------------- | --------------------------------------------------------------------------- |\n| `id`                |                  |                                                                             |\n| `string` (UUID v4)  | 一意のイベント識別子       |                                                                             |\n| `timestamp`         |                  |                                                                             |\n| `string` (ISO 8601) | イベントが作成されたとき     |                                                                             |\n| `parentId`          | `string \\| null` | チェーン内の前のイベントの ID。最初のイベントの`null`                                             |\n| `agentId`           | `string?`        | サブエージェントから発生したイベントのサブエージェント インスタンス ID。ルート/メイン エージェントとセッション レベルのイベントには存在しません |\n| `ephemeral`         | `boolean?`       | 一時的なイベントの場合`true`。永続化されたイベントの場合は不在または`false`                                |\n| `type`              | `string`         | イベント型識別子 (以下の表を参照)                                                          |\n| `data`              | `object`         | イベント固有のペイロード                                                                |\n\n## イベントに登録する\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\n// All events\nsession.on((event) => {\n    console.log(event.type, event.data);\n});\n\n// Specific event type — data is narrowed automatically\nsession.on(\"assistant.message_delta\", (event) => {\n    process.stdout.write(event.data.deltaContent);\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nfrom copilot.session_events import SessionEventType\n\ndef handle(event):\n    if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA:\n        print(event.data.delta_content, end=\"\", flush=True)\n\nsession.on(handle)\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nsession.On(func(event copilot.SessionEvent) {\n    if d, ok := event.Data.(*copilot.AssistantMessageDeltaData); ok {\n        fmt.Print(d.DeltaContent)\n    }\n})\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nsession.On<SessionEvent>(evt =>\n{\n    if (evt is AssistantMessageDeltaEvent delta)\n    {\n        Console.Write(delta.Data.DeltaContent);\n    }\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\n// All events\nsession.on(event -> System.out.println(event.getType()));\n\n// Specific event type — data is narrowed to the matching class\nsession.on(AssistantMessageDeltaEvent.class, event ->\n    System.out.print(event.getData().deltaContent())\n);\n```\n\n</div>\n\n</div>\n\n> \\[!TIP]\n> **(Python/Go)** これらの SDK では、個別のイベントごとのデータ型 (たとえば、`AssistantMessageDeltaData`) が使用されるため、各種類に関連するフィールドのみが存在します。\n>\n> \\[!TIP]\n> **(.NET)** .NET SDK では、イベントごとに個別の厳密に型指定されたデータ クラス (`AssistantMessageDeltaData` など) が使用されるため、各型に関連するフィールドのみが存在します。\n>\n> \\[!TIP]\n> **(TypeScript)** TypeScript SDK では判別共用体が使用されます。 `event.type`で一致すると、 `data` ペイロードは自動的に正しい図形に絞り込まれます。\n\n## 親エージェントの応答のみをレンダリングする\n\nサブエージェント イベントは親セッション ストリームを共有し、エンベロープ レベルの `agentId`を含めます。 ルート/メイン エージェント イベントとセッション レベルのイベントでは `agentId`が省略されるため、メイン チャット レンダラーは、 `agentId` が設定されているアシスタント イベントを無視し、代わりにそれらのイベントをトレースまたは進行状況 UI にルーティングできます。\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nimport type { CopilotSession } from \"@github/copilot-sdk\";\n\nexport function subscribeParentResponse(session: CopilotSession): void {\n    session.on(\"assistant.message_delta\", (event) => {\n        if (!event.agentId) {\n            process.stdout.write(event.data.deltaContent);\n        }\n    });\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nfrom copilot import CopilotSession, SessionEvent, SessionEventType\nfrom copilot.session_events import AssistantMessageDeltaData\n\ndef subscribe_parent_response(session: CopilotSession) -> None:\n    def handle(event: SessionEvent) -> None:\n        if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA and event.agent_id is None:\n            data = event.data\n            if isinstance(data, AssistantMessageDeltaData):\n                print(data.delta_content, end=\"\", flush=True)\n\n    session.on(handle)\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\npackage example\n\nimport (\n    \"fmt\"\n\n    copilot \"github.com/github/copilot-sdk/go\"\n)\n\nfunc subscribeParentResponse(session *copilot.Session) {\n    session.On(func(event copilot.SessionEvent) {\n        if event.AgentID != nil {\n            return\n        }\n\n        if d, ok := event.Data.(*copilot.AssistantMessageDeltaData); ok {\n            fmt.Print(d.DeltaContent)\n        }\n    })\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nusing System;\nusing GitHub.Copilot;\n\nstatic class ParentAgentResponseExample\n{\n    public static void SubscribeParentResponse(CopilotSession session)\n    {\n        session.On<AssistantMessageDeltaEvent>(evt =>\n        {\n            if (evt.AgentId is null)\n            {\n                Console.Write(evt.Data.DeltaContent);\n            }\n        });\n    }\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n```java\nimport com.github.copilot.CopilotSession;\nimport com.github.copilot.generated.AssistantMessageDeltaEvent;\n\nfinal class ParentAgentResponseExample {\n    static void subscribeParentResponse(CopilotSession session) {\n        session.on(AssistantMessageDeltaEvent.class, event -> {\n            if (event.getAgentId() == null) {\n                System.out.print(event.getData().deltaContent());\n            }\n        });\n    }\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"rust\" data-label=\"Rust\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Rust</div>\n\n```rust\nuse github_copilot_sdk::session::Session;\n\nasync fn subscribe_parent_response(session: &Session) {\n    let mut events = session.subscribe();\n\n    while let Ok(event) = events.recv().await {\n        if event.event_type == \"assistant.message_delta\" && event.agent_id.is_none() {\n            if let Some(delta) = event.data.get(\"deltaContent\").and_then(|v| v.as_str()) {\n                print!(\"{delta}\");\n            }\n        }\n    }\n}\n```\n\n</div>\n\n</div>\n\n## アシスタント イベント\n\nこれらのイベントは、ターン スタートからストリーミング チャンク、最後のメッセージまで、エージェントの応答ライフサイクルを追跡します。\n\n### `assistant.turn_start`\n\nエージェントがターンの処理を開始したときに出力されます。\n\n| データ フィールド                  | タイプ      | 必須 | Description               |\n| -------------------------- | -------- | -- | ------------------------- |\n| `turnId`                   | `string` | ✅  | ターン識別子 (通常は、文字列化されたターン番号) |\n| `interactionId`            | `string` |    |                           |\n| テレメトリ相関用の CAPI インタラクション ID |          |    |                           |\n\n### `assistant.intent`\n\n儚い。 エージェントが現在行っていることの簡単な説明。動作に応じて更新されます。\n\n| データ フィールド | タイプ      | 必須 | Description                 |\n| --------- | -------- | -- | --------------------------- |\n| `intent`  | `string` | ✅  | 人間が判読できる意図 (例: \"コードベースの探索\") |\n\n### `assistant.reasoning`\n\nモデルから拡張思考ブロックを完成させます。 推論が完了した後に出力されます。\n\n| データ フィールド     | タイプ      | 必須 | Description    |\n| ------------- | -------- | -- | -------------- |\n| `reasoningId` | `string` | ✅  | この推論ブロックの一意識別子 |\n| `content`     | `string` | ✅  | 完全な拡張思考テキスト    |\n\n### `assistant.reasoning_delta`\n\n儚い。 リアルタイムでストリーミングされる、モデルの拡張思考の増分チャンク。\n\n| データ フィールド      | タイプ      | 必須 | Description                           |\n| -------------- | -------- | -- | ------------------------------------- |\n| `reasoningId`  | `string` | ✅  | 対応する `assistant.reasoning` イベントと一致します |\n| `deltaContent` | `string` | ✅  | 推論コンテンツに追加するテキストの一部                   |\n\n### `assistant.message`\n\nこの LLM 呼び出しに対するアシスタントの完全な応答。 ツール呼び出し要求を含めることができます。\n\n| データ フィールド                                           | タイプ             | 必須 | Description     |\n| --------------------------------------------------- | --------------- | -- | --------------- |\n| `messageId`                                         | `string`        | ✅  | このメッセージのユニーク識別子 |\n| `content`                                           | `string`        | ✅  | アシスタントのテキスト応答   |\n| `toolRequests`                                      | `ToolRequest[]` |    |                 |\n| アシスタントが行いたいと思うツール呼び出し (下記参照)                        |                 |    |                 |\n| `reasoningOpaque`                                   | `string`        |    |                 |\n| 暗号化された拡張思考（アントロピックモデル）、セッションにバインドされた                |                 |    |                 |\n| `reasoningText`                                     | `string`        |    |                 |\n| 拡張思考から読み取り可能な推論テキスト                                 |                 |    |                 |\n| `encryptedContent`                                  | `string`        |    |                 |\n| 暗号化された推論コンテンツ (OpenAI モデル);session-bound            |                 |    |                 |\n| `phase`                                             | `string`        |    |                 |\n| 生成フェーズ (例: `\"thinking\"` と `\"response\"`)             |                 |    |                 |\n| `outputTokens`                                      | `number`        |    |                 |\n| API 応答からの実際の出力トークン数                                 |                 |    |                 |\n| `interactionId`                                     | `string`        |    |                 |\n| テレメトリ用の CAPI インタラクション ID                            |                 |    |                 |\n| `parentToolCallId`                                  | `string`        |    |                 |\n| Deprecated. サブエージェントの属性にエンベロープ レベルの `agentId` を使用する |                 |    |                 |\n\n\\*\\*\n`ToolRequest` フィールド：\\*\\*\n\n| フィールド                                  | タイプ                      | 必須 | Description                            |\n| -------------------------------------- | ------------------------ | -- | -------------------------------------- |\n| `toolCallId`                           | `string`                 | ✅  | このツール呼び出しの一意の ID                       |\n| `name`                                 | `string`                 | ✅  | ツール名 (例: `\"bash\"`、 `\"edit\"`、 `\"grep\"`) |\n| `arguments`                            | `object`                 |    |                                        |\n| ツールの解析された引数                            |                          |    |                                        |\n| `type`                                 | `\"function\" \\| \"custom\"` |    |                                        |\n| 呼び出しの種類。存在しない場合は`\"function\"`が既定値となります。 |                          |    |                                        |\n\n### `assistant.message_delta`\n\n儚い。 リアルタイムでストリーミングされる、アシスタントのテキスト応答の増分チャンク。\n\n| データ フィールド                                           | タイプ      | 必須 | Description                         |\n| --------------------------------------------------- | -------- | -- | ----------------------------------- |\n| `messageId`                                         | `string` | ✅  | 対応する `assistant.message` イベントと一致します |\n| `deltaContent`                                      | `string` | ✅  | メッセージに追加するテキスト チャンク                 |\n| `parentToolCallId`                                  | `string` |    |                                     |\n| Deprecated. サブエージェントの属性にエンベロープ レベルの `agentId` を使用する |          |    |                                     |\n\n### `assistant.turn_end`\n\nエージェントがターンを完了したときに生成されます (すべてのツールの実行が完了し、最終的な応答が配信されます)。\n\n| データ フィールド | タイプ      | 必須 | Description                            |\n| --------- | -------- | -- | -------------------------------------- |\n| `turnId`  | `string` | ✅  | 対応する `assistant.turn_start` イベントと一致します |\n\n### `assistant.usage`\n\n儚い。 個々の API 呼び出しのトークンの使用状況とコストに関する情報。\n\n| データ フィールド                                                                  | タイプ                                                                        | 必須 | Description             |\n| -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -- | ----------------------- |\n| `model`                                                                    | `string`                                                                   | ✅  | モデル識別子 (例: `\"gpt-5.4\"`) |\n| `inputTokens`                                                              | `number`                                                                   |    |                         |\n| 使用された入力トークン                                                                |                                                                            |    |                         |\n| `outputTokens`                                                             | `number`                                                                   |    |                         |\n| 生成された出力トークン                                                                |                                                                            |    |                         |\n| `reasoningTokens`                                                          | `number`                                                                   |    |                         |\n| 推論/考え方のチェーンに使用される出力トークン ( `outputTokens`のサブセット)                            |                                                                            |    |                         |\n| `cacheReadTokens`                                                          | `number`                                                                   |    |                         |\n| プロンプト キャッシュから読み取られたトークン                                                    |                                                                            |    |                         |\n| `cacheWriteTokens`                                                         | `number`                                                                   |    |                         |\n| プロンプト キャッシュに書き込まれたトークン                                                     |                                                                            |    |                         |\n| `cacheExpiresAt`                                                           | `string`                                                                   |    |                         |\n| このモデル呼び出しのプロンプトキャッシュが期限切れとなる日時の ISO 8601 タイムスタンプ                           |                                                                            |    |                         |\n| `contentFilterTriggered`                                                   | `boolean`                                                                  |    |                         |\n| 応答がブロックされたか、コンテンツ フィルターによって切り捨てられたか (`finish_reason === 'content_filter'`) |                                                                            |    |                         |\n| `finishReason`                                                             | `string`                                                                   |    |                         |\n| モデルの終了理由 (例: `\"stop\"`、 `\"length\"`、 `\"tool_calls\"`、 `\"content_filter\"`)     |                                                                            |    |                         |\n| `cost`                                                                     | `number`                                                                   |    |                         |\n| 請求のためのモデル乗算コスト                                                             |                                                                            |    |                         |\n| `duration`                                                                 | `number`                                                                   |    |                         |\n| API 呼び出し時間 (ミリ秒単位)                                                         |                                                                            |    |                         |\n| `timeToFirstTokenMs`                                                       | `number`                                                                   |    |                         |\n| 要求ディスパッチから最初に受信したトークンまでの時間 (ストリーミング待機時間)                                   |                                                                            |    |                         |\n| `interTokenLatencyMs`                                                      | `number`                                                                   |    |                         |\n| 連続するトークン間の平均待機時間 (ストリーミング スループット)                                          |                                                                            |    |                         |\n| `reasoningEffort`                                                          | `string`                                                                   |    |                         |\n| この呼び出しに使用される推論作業レベル (例: `\"low\"`、 `\"medium\"`、 `\"high\"`)                     |                                                                            |    |                         |\n| `initiator`                                                                | `string`                                                                   |    |                         |\n| この呼び出しをトリガーした内容 (例: `\"sub-agent\"`)、ユーザーが開始した場合は存在しない                       |                                                                            |    |                         |\n| `apiCallId`                                                                | `string`                                                                   |    |                         |\n| プロバイダーからの完了 ID (例: `chatcmpl-abc123`)                                      |                                                                            |    |                         |\n| `serviceRequestId`                                                         | `string`                                                                   |    |                         |\n| CAPI ログの関連付け用の Copilot サービス リクエスト ID (`x-copilot-service-request-id`)      |                                                                            |    |                         |\n| `apiEndpoint`                                                              | `\"/chat/completions\" \\| \"/v1/messages\" \\| \"/responses\" \\| \"ws:/responses\"` |    |                         |\n| モデル呼び出しに使用される API エンドポイント。は、可観測性とコストの属性に役立ちます。                             |                                                                            |    |                         |\n| `ws:/responses` は、応答 API の Websocket バリアントです                               |                                                                            |    |                         |\n| `providerCallId`                                                           | `string`                                                                   |    |                         |\n| GitHub要求トレース ID (`x-github-request-id`)                                    |                                                                            |    |                         |\n| `parentToolCallId`                                                         | `string`                                                                   |    |                         |\n| Deprecated. サブエージェントの属性にエンベロープ レベルの `agentId` を使用する                        |                                                                            |    |                         |\n| `quotaSnapshots`                                                           | `Record<string, QuotaSnapshot>`                                            |    |                         |\n| クォータ識別子でキー付けされたクォータごとのリソース使用量                                              |                                                                            |    |                         |\n| `copilotUsage`                                                             | `CopilotUsage`                                                             |    |                         |\n| API からの明細化されたトークン コストの内訳                                                   |                                                                            |    |                         |\n\n### `assistant.streaming_delta`\n\n儚い。 低レベルのネットワーク進行状況インジケーター - ストリーミング API 応答から受信した合計バイト数。\n\n| データ フィールド                | タイプ      | 必須 | Description     |\n| ------------------------ | -------- | -- | --------------- |\n| `totalResponseSizeBytes` | `number` | ✅  | これまでに受信した累積バイト数 |\n\n## ツールの実行イベント\n\nこれらのイベントは、ツール呼び出しを要求するモデルから実行から完了までの、各ツール呼び出しの完全なライフサイクルを追跡します。\n\n### `tool.execution_start`\n\nツールの実行が開始されたときに出力されます。\n\n| データ フィールド                                           | タイプ      | 必須 | Description                              |\n| --------------------------------------------------- | -------- | -- | ---------------------------------------- |\n| `toolCallId`                                        | `string` | ✅  | この呼び出しツールの一意の識別子                         |\n| `toolName`                                          | `string` | ✅  | ツールの名前 (例: `\"bash\"`、 `\"edit\"`、 `\"grep\"`) |\n| `arguments`                                         | `object` |    |                                          |\n| ツールに渡される解析された引数                                     |          |    |                                          |\n| `mcpServerName`                                     | `string` |    |                                          |\n| MCP サーバー名 (ツールが MCP サーバーによって提供される場合)                |          |    |                                          |\n| `mcpToolName`                                       | `string` |    |                                          |\n| MCP サーバー上の元のツール名                                    |          |    |                                          |\n| `parentToolCallId`                                  | `string` |    |                                          |\n| Deprecated. サブエージェントの属性にエンベロープ レベルの `agentId` を使用する |          |    |                                          |\n\n### `tool.execution_partial_result`\n\n儚い。 実行中のツールからの逐次出力（例: bash のストリーミング出力）。\n\n| データ フィールド       | タイプ      | 必須 | Description                      |\n| --------------- | -------- | -- | -------------------------------- |\n| `toolCallId`    | `string` | ✅  | 対応する`tool.execution_start`に一致します |\n| `partialOutput` | `string` | ✅  | 増分出力チャンク                         |\n\n### `tool.execution_progress`\n\n儚い。 実行中のツール (MCP サーバーの進行状況通知など) から人間が判読できる進行状況の状態。\n\n| データ フィールド         | タイプ      | 必須 | Description                      |\n| ----------------- | -------- | -- | -------------------------------- |\n| `toolCallId`      | `string` | ✅  | 対応する`tool.execution_start`に一致します |\n| `progressMessage` | `string` | ✅  | 進捗状況メッセージ                        |\n\n### `tool.execution_complete`\n\nツールの実行が正常に終了したとき、またはエラーが発生したときに生成されます。\n\n| データ フィールド                                           | タイプ                  | 必須 | Description                      |\n| --------------------------------------------------- | -------------------- | -- | -------------------------------- |\n| `toolCallId`                                        | `string`             | ✅  | 対応する`tool.execution_start`に一致します |\n| `success`                                           | `boolean`            | ✅  | 実行が成功したかどうか                      |\n| `model`                                             | `string`             |    |                                  |\n| このツール呼び出しを生成したモデル                                   |                      |    |                                  |\n| `interactionId`                                     | `string`             |    |                                  |\n| CAPI インタラクション ID                                    |                      |    |                                  |\n| `isUserRequested`                                   | `boolean`            |    |                                  |\n|                                                     |                      |    |                                  |\n| `true` ユーザーがこのツール呼び出しを明示的に要求したとき                    |                      |    |                                  |\n| `result`                                            | `Result`             |    |                                  |\n| 成功時に含まれる (下記参照)                                     |                      |    |                                  |\n| `error`                                             | `{ message, code? }` |    |                                  |\n| エラー発生時に含まれる                                         |                      |    |                                  |\n| `toolTelemetry`                                     | `object`             |    |                                  |\n| ツール固有のテレメトリ (CodeQL チェック数など)                        |                      |    |                                  |\n| `parentToolCallId`                                  | `string`             |    |                                  |\n| Deprecated. サブエージェントの属性にエンベロープ レベルの `agentId` を使用する |                      |    |                                  |\n\n\\*\\*\n`Result` フィールド：\\*\\*\n\n| フィールド                                      | タイプ              | 必須 | Description                                 |\n| ------------------------------------------ | ---------------- | -- | ------------------------------------------- |\n| `content`                                  | `string`         | ✅  | LLM に送信される簡潔な結果 (トークン効率のために切り捨てられる可能性があります) |\n| `detailedContent`                          | `string`         |    |                                             |\n| 表示用の完全な結果。差分などの完全なコンテンツを保持する               |                  |    |                                             |\n| `contents`                                 | `ContentBlock[]` |    |                                             |\n| 構造化コンテンツ ブロック (テキスト、ターミナル、イメージ、オーディオ、リソース) |                  |    |                                             |\n\n### `tool.user_requested`\n\nユーザーが明示的にツールの呼び出しを要求したときに生成されます (呼び出しを選択したモデルではなく)。\n\n| データ フィールド    | タイプ      | 必須 | Description      |\n| ------------ | -------- | -- | ---------------- |\n| `toolCallId` | `string` | ✅  | この呼び出しツールの一意の識別子 |\n| `toolName`   | `string` | ✅  | ユーザーが呼び出すツールの名前  |\n| `arguments`  | `object` |    |                  |\n| 呼び出しの引数      |          |    |                  |\n\n## セッション ライフサイクル イベント\n\n### `session.idle`\n\n儚い。 エージェントはすべての処理を完了し、次のメッセージの準備が整いました。 これはターンが完全に完了したことを示すシグナルです。\n\n| データ フィールド                      | タイプ       | 必須 | Description |\n| ------------------------------ | --------- | -- | ----------- |\n| `aborted`                      | `boolean` |    |             |\n| 前のターンが中止シグナルによって取り消された場合は True |           |    |             |\n\n### `session.error`\n\nセッション処理中にエラーが発生しました。\n\n| データ フィールド                       | タイプ      | 必須 | Description                                                 |\n| ------------------------------- | -------- | -- | ----------------------------------------------------------- |\n| `errorType`                     | `string` | ✅  | エラー カテゴリ (例: `\"authentication\"`、 `\"quota\"`、 `\"rate_limit\"`) |\n| `message`                       | `string` | ✅  | 人間が読みやすいエラーメッセージ                                            |\n| `stack`                         | `string` |    |                                                             |\n| エラースタックトレース                     |          |    |                                                             |\n| `statusCode`                    | `number` |    |                                                             |\n| アップストリーム要求からの HTTP 状態コード        |          |    |                                                             |\n| `providerCallId`                | `string` |    |                                                             |\n| サーバー側ログの関連付け用 GitHub リクエスト追跡 ID |          |    |                                                             |\n\n### `session.compaction_start`\n\nコンテキスト ウィンドウの圧縮が開始されました。\n**データ ペイロードが空 (`{}`) です**。\n\n### `session.compaction_complete`\n\nコンテキスト ウィンドウの圧縮が完了しました。\n\n| データ フィールド                          | タイプ                              | 必須 | Description |\n| ---------------------------------- | -------------------------------- | -- | ----------- |\n| `success`                          | `boolean`                        | ✅  | 圧縮に成功したかどうか |\n| `error`                            | `string`                         |    |             |\n| 圧縮に失敗した場合のエラー メッセージ                |                                  |    |             |\n| `preCompactionTokens`              | `number`                         |    |             |\n| 圧縮前のトークン                           |                                  |    |             |\n| `postCompactionTokens`             | `number`                         |    |             |\n| 圧縮後のトークン                           |                                  |    |             |\n| `preCompactionMessagesLength`      | `number`                         |    |             |\n| 圧縮前のメッセージ数                         |                                  |    |             |\n| `messagesRemoved`                  | `number`                         |    |             |\n| 削除されたメッセージ                         |                                  |    |             |\n| `tokensRemoved`                    | `number`                         |    |             |\n| トークンが削除されました                       |                                  |    |             |\n| `summaryContent`                   | `string`                         |    |             |\n| LLM によって生成されたコンパクトな履歴の概要           |                                  |    |             |\n| `checkpointNumber`                 | `number`                         |    |             |\n| 復旧用に作成されたチェックポイント スナップショット番号       |                                  |    |             |\n| `checkpointPath`                   | `string`                         |    |             |\n| チェックポイントが格納されたファイル パス              |                                  |    |             |\n| `compactionTokensUsed`             | `{ input, output, cachedInput }` |    |             |\n| 圧縮 LLM 呼び出しのトークンの使用                |                                  |    |             |\n| `requestId`                        | `string`                         |    |             |\n| GitHub のコンパクション呼び出し用リクエストトレーシング ID |                                  |    |             |\n\n### `session.title_changed`\n\n儚い。 セッションの自動生成されたタイトルが更新されました。\n\n| データ フィールド | タイプ      | 必須 | Description   |\n| --------- | -------- | -- | ------------- |\n| `title`   | `string` | ✅  | 新しいセッション タイトル |\n\n### `session.context_changed`\n\nセッションの作業ディレクトリまたはリポジトリ コンテキストが変更されました。\n\n| データ フィールド              | タイプ      | 必須 | Description |\n| ---------------------- | -------- | -- | ----------- |\n| `cwd`                  | `string` | ✅  | 現在の作業ディレクトリ |\n| `gitRoot`              | `string` |    |             |\n| Git リポジトリのルート          |          |    |             |\n| `repository`           | `string` |    |             |\n|                        |          |    |             |\n| `\"owner/name\"`形式のリポジトリ |          |    |             |\n| `branch`               | `string` |    |             |\n| 現在の Git ブランチ           |          |    |             |\n\n### `session.usage_info`\n\n儚い。 コンテキスト ウィンドウ使用率スナップショット。\n\n| データ フィールド        | タイプ      | 必須 | Description              |\n| ---------------- | -------- | -- | ------------------------ |\n| `tokenLimit`     | `number` | ✅  | モデルのコンテキスト ウィンドウの最大トークン数 |\n| `currentTokens`  | `number` | ✅  | コンテキスト ウィンドウ内の現在のトークン    |\n| `messagesLength` | `number` | ✅  | 会話の現在のメッセージ数             |\n\n### `session.session_limits_changed`\n\n現在の会計期間のセッション制限が変更されました。\n`null`\n`sessionLimits`値は、制限がアクティブでないことを意味します。\n\n| データ フィールド                        | タイプ                           | 必須 | Description                       |\n| -------------------------------- | ----------------------------- | -- | --------------------------------- |\n| `sessionLimits`                  | `SessionLimitsConfig \\| null` | ✅  | 現在のセッションの制限、または制限が有効でない場合は `null` |\n| `sessionLimits.maxAiCredits`     | `number`                      |    |                                   |\n| セッションの現在の会計期間で許可される AI クレジットの最大数 |                               |    |                                   |\n\n### `session.usage_checkpoint`\n\nセッションの再開時にアカウンティングを再構築するために使用される永続集計使用チェックポイント。\n\n| データ フィールド                          | タイプ      | 必須 | Description                               |\n| ---------------------------------- | -------- | -- | ----------------------------------------- |\n| `totalNanoAiu`                     | `number` | ✅  | チェックポイント時点におけるセッション全体の nano-AI ユニットの累積コスト |\n| `totalPremiumRequests`             | `number` |    |                                           |\n| チェックポイント時に使用された Premium API 要求の合計数 |          |    |                                           |\n\n### `session.task_complete`\n\nエージェントは、割り当てられたタスクを完了しました。\n\n| データ フィールド  | タイプ      | 必須 | Description |\n| ---------- | -------- | -- | ----------- |\n| `summary`  | `string` |    |             |\n| 完了したタスクの概要 |          |    |             |\n\n### `session.shutdown`\n\nセッションが終了しました。\n\n| データ フィールド                              | タイプ                                           | 必須 | Description                   |\n| -------------------------------------- | --------------------------------------------- | -- | ----------------------------- |\n| `shutdownType`                         | `\"routine\" \\| \"error\"`                        | ✅  | 通常のシャットダウンまたはクラッシュ            |\n| `errorReason`                          | `string`                                      |    |                               |\n|                                        |                                               |    |                               |\n| `shutdownType` が `\"error\"` である場合のエラー説明 |                                               |    |                               |\n| `totalPremiumRequests`                 | `number`                                      | ✅  | 使用された Premium API 要求の合計数      |\n| `totalApiDurationMs`                   | `number`                                      | ✅  | API 呼び出しの累積時間 (ミリ秒単位)         |\n| `sessionStartTime`                     | `number`                                      | ✅  | セッションの開始時の Unix タイムスタンプ (ミリ秒) |\n| `codeChanges`                          | `{ linesAdded, linesRemoved, filesModified }` | ✅  | コード変更メトリックの集計                 |\n| `modelMetrics`                         | `Record<string, ModelMetric>`                 | ✅  | モデルごとの使用状況の内訳                 |\n| `currentModel`                         | `string`                                      |    |                               |\n| シャットダウン時に選択されたモデル                      |                                               |    |                               |\n\n## アクセス許可とユーザー入力イベント\n\nこれらのイベントは、エージェントが続行する前にユーザーからの承認または入力を必要とする場合に生成されます。\n\n### `permission.requested`\n\nエージェントには、アクション (コマンドの実行、ファイルの書き込みなど) を実行するためのアクセス許可が必要です。\n\n| データ フィールド           | タイプ                 | 必須 | Description                                         |\n| ------------------- | ------------------- | -- | --------------------------------------------------- |\n| `requestId`         | `string`            | ✅  | これを使用して、次の方法で応答します。 `session.respondToPermission()` |\n| `permissionRequest` | `PermissionRequest` | ✅  | 要求されているアクセス許可の詳細                                    |\n\n`permissionRequest`は、`kind`の判別共用体です。\n\n| `kind`                                                       | キー フィールド           | Description |\n| ------------------------------------------------------------ | ------------------ | ----------- |\n| `\"shell\"`                                                    |                    |             |\n| `fullCommandText`、`intention`、`commands[]`、`possiblePaths[]` | シェル コマンドを実行する      |             |\n| `\"write\"`                                                    |                    |             |\n| `fileName`、`diff`、`intention`、`newFileContents?`             | ファイルの書き込み/変更       |             |\n| `\"read\"`                                                     |                    |             |\n| `path`、`intention`                                           | ファイルまたはディレクトリの読み取り |             |\n| `\"mcp\"`                                                      |                    |             |\n| `serverName`、`toolName`、`toolTitle`、`args?`、`readOnly`       | MCP ツールを呼び出す       |             |\n| `\"url\"`                                                      |                    |             |\n| `url`、`intention`                                            | URL を取得する          |             |\n| `\"memory\"`                                                   |                    |             |\n| `subject`、`fact`、`citations`                                 | メモリを格納する           |             |\n| `\"custom-tool\"`                                              |                    |             |\n| `toolName`、`toolDescription`、`args?`                         | カスタム ツールを呼び出す      |             |\n\nすべての `kind` バリアントには、要求をトリガーしたツール呼び出しにリンクバックするオプションの `toolCallId` も含まれています。\n\n### `permission.completed`\n\nアクセス許可要求が解決されました。\n\n| データ フィールド     | タイプ      | 必須 | Description                                                                                                                                                                      |\n| ------------- | -------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `requestId`   | `string` | ✅  | 対応する`permission.requested`に一致します                                                                                                                                                 |\n| `result.kind` | `string` | ✅  | 次のいずれか: `\"approved\"`、 `\"denied-by-rules\"`、 `\"denied-interactively-by-user\"`、 `\"denied-no-approval-rule-and-could-not-request-from-user\"`、 `\"denied-by-content-exclusion-policy\"` |\n\n### `user_input.requested`\n\n儚い。 エージェントがユーザーに質問しています。\n\n| データ フィールド             | タイプ        | 必須 | Description                                        |\n| --------------------- | ---------- | -- | -------------------------------------------------- |\n| `requestId`           | `string`   | ✅  | これを使用して、次の方法で応答します。 `session.respondToUserInput()` |\n| `question`            | `string`   | ✅  | ユーザーに提示する質問                                        |\n| `choices`             | `string[]` |    |                                                    |\n| ユーザーの定義済みの選択肢         |            |    |                                                    |\n| `allowFreeform`       | `boolean`  |    |                                                    |\n| 自由形式のテキスト入力が許可されるかどうか |            |    |                                                    |\n\n### `user_input.completed`\n\n儚い。 ユーザー入力要求が解決されました。\n\n| データ フィールド   | タイプ      | 必須 | Description                      |\n| ----------- | -------- | -- | -------------------------------- |\n| `requestId` | `string` | ✅  | 対応する`user_input.requested`に一致します |\n\n### `elicitation.requested`\n\n儚い。 エージェントには、ユーザーからの構造化されたフォーム入力 (MCP 引き出しプロトコル) が必要です。\n\n| データ フィールド                | タイプ                                         | 必須 | Description                                          |\n| ------------------------ | ------------------------------------------- | -- | ---------------------------------------------------- |\n| `requestId`              | `string`                                    | ✅  | これを使用して、次の方法で応答します。 `session.respondToElicitation()` |\n| `message`                | `string`                                    | ✅  | 必要な情報の説明                                             |\n| `mode`                   | `\"form\"`                                    |    |                                                      |\n| 現在、引き出しモードは`\"form\"`のみです。 |                                             |    |                                                      |\n| `requestedSchema`        | `{ type: \"object\", properties, required? }` | ✅  | フォーム フィールドを記述する JSON スキーマ                            |\n\n### `elicitation.completed`\n\n儚い。 引き出し要請が解決されました。\n\n| データ フィールド   | タイプ      | 必須 | Description                       |\n| ----------- | -------- | -- | --------------------------------- |\n| `requestId` | `string` | ✅  | 対応する`elicitation.requested`に一致します |\n\n## サブエージェントとスキル イベント\n\n### `subagent.started`\n\nカスタム エージェントがサブエージェントとして呼び出されました。\n\n| データ フィールド                      | タイプ      | 必須 | Description             |\n| ------------------------------ | -------- | -- | ----------------------- |\n| `toolCallId`                   | `string` | ✅  | このサブエージェントを生成した親ツール呼び出し |\n| `agentName`                    | `string` | ✅  | サブエージェントの内部名            |\n| `agentDisplayName`             | `string` | ✅  | 人間が判読できる表示名             |\n| `agentDescription`             | `string` | ✅  | サブエージェントの機能の説明          |\n| `model`                        | `string` |    |                         |\n| 開始時に判明している場合に、サブエージェントが使用するモデル |          |    |                         |\n\n### `subagent.completed`\n\nサブエージェントが正常に完了しました。\n\n| データ フィールド             | タイプ      | 必須 | Description                  |\n| --------------------- | -------- | -- | ---------------------------- |\n| `toolCallId`          | `string` | ✅  | 対応する`subagent.started`に一致します |\n| `agentName`           | `string` | ✅  | 内部名                          |\n| `agentDisplayName`    | `string` | ✅  | 表示名                          |\n| `model`               | `string` |    |                              |\n| サブエージェントで使用されるモデル     |          |    |                              |\n| `durationMs`          | `number` |    |                              |\n| ウォール クロックの実行時間 (ミリ秒)  |          |    |                              |\n| `totalTokens`         | `number` |    |                              |\n| 使用された入力トークンと出力トークンの合計 |          |    |                              |\n| `totalToolCalls`      | `number` |    |                              |\n| 作成されたツール呼び出しの合計数      |          |    |                              |\n\n### `subagent.failed`\n\nサブエージェントでエラーが発生しました。\n\n| データ フィールド                    | タイプ      | 必須 | Description                  |\n| ---------------------------- | -------- | -- | ---------------------------- |\n| `toolCallId`                 | `string` | ✅  | 対応する`subagent.started`に一致します |\n| `agentName`                  | `string` | ✅  | 内部名                          |\n| `agentDisplayName`           | `string` | ✅  | 表示名                          |\n| `error`                      | `string` | ✅  | エラー メッセージ                    |\n| `model`                      | `string` |    |                              |\n| サブエージェントに対して選択されたモデル (既知の場合) |          |    |                              |\n| `durationMs`                 | `number` |    |                              |\n| ウォール クロックの実行時間 (ミリ秒)         |          |    |                              |\n| `totalTokens`                | `number` |    |                              |\n| 失敗前に使用された入力トークンと出力トークンの合計    |          |    |                              |\n| `totalToolCalls`             | `number` |    |                              |\n| 失敗前に行われたツール呼び出しの合計数          |          |    |                              |\n\n### `subagent.selected`\n\n現在の要求を処理するために、カスタム エージェントが選択 (推論) されました。\n\n| データ フィールド          | タイプ                | 必須 | Description                        |\n| ------------------ | ------------------ | -- | ---------------------------------- |\n| `agentName`        | `string`           | ✅  | 選択したエージェントの内部名                     |\n| `agentDisplayName` | `string`           | ✅  | 表示名                                |\n| `tools`            | `string[] \\| null` | ✅  | このエージェントで使用可能なツール名。すべてのツールには`null` |\n\n### `subagent.deselected`\n\nカスタム エージェントの選択が解除され、既定のエージェントに戻りました。\n**データ ペイロードが空 (`{}`) です**。\n\n### `skill.invoked`\n\n現在の会話に対してスキルがアクティブ化されました。\n\n| データ フィールド                | タイプ        | 必須 | Description              |\n| ------------------------ | ---------- | -- | ------------------------ |\n| `name`                   | `string`   | ✅  | スキル名                     |\n| `path`                   | `string`   | ✅  | SKILL.md 定義へのファイル パス     |\n| `content`                | `string`   | ✅  | 会話にすべてのスキルコンテンツが挿入されました。 |\n| `allowedTools`           | `string[]` |    |                          |\n| このスキルがアクティブな間に自動承認されたツール |            |    |                          |\n| `pluginName`             | `string`   |    |                          |\n| スキルの元のプラグイン              |            |    |                          |\n| `pluginVersion`          | `string`   |    |                          |\n| プラグインのバージョン              |            |    |                          |\n\n## その他のイベント\n\n### `abort`\n\n現在のターンは中止されました。\n\n| データ フィールド | タイプ      | 必須 | Description                         |\n| --------- | -------- | -- | ----------------------------------- |\n| `reason`  | `string` | ✅  | ターンが中止された理由 (例: `\"user initiated\"`) |\n\n### `user.message`\n\nユーザーがメッセージを送信しました。 セッション タイムライン用に記録されます。\n\n| データ フィールド                                                          | タイプ            | 必須 | Description     |\n| ------------------------------------------------------------------ | -------------- | -- | --------------- |\n| `content`                                                          | `string`       | ✅  | ユーザーのメッセージ テキスト |\n| `transformedContent`                                               | `string`       |    |                 |\n| 前処理後に変換されたバージョン                                                    |                |    |                 |\n| `attachments`                                                      | `Attachment[]` |    |                 |\n| ファイル、ディレクトリ、選択項目、blob、または GitHub 参照の添付ファイル                         |                |    |                 |\n| `source`                                                           | `string`       |    |                 |\n| メッセージ ソース識別子                                                       |                |    |                 |\n| `agentMode`                                                        | `string`       |    |                 |\n| エージェント モード: `\"interactive\"`、 `\"plan\"`、 `\"autopilot\"`、または `\"shell\"` |                |    |                 |\n| `interactionId`                                                    | `string`       |    |                 |\n| CAPI インタラクション ID                                                   |                |    |                 |\n\n### `system.message`\n\nシステムまたは開発者のプロンプトが会話に挿入されました。\n\n| データ フィールド          | タイプ                              | 必須 | Description |\n| ------------------ | -------------------------------- | -- | ----------- |\n| `content`          | `string`                         | ✅  | プロンプトの内容    |\n| `role`             | `\"system\" \\| \"developer\"`        | ✅  | メッセージ 役割    |\n| `name`             | `string`                         |    |             |\n| ソース識別子             |                                  |    |             |\n| `metadata`         | `{ promptVersion?, variables? }` |    |             |\n| プロンプト テンプレートのメタデータ |                                  |    |             |\n\n### `external_tool.requested`\n\nエージェントは、外部ツール (SDK コンシューマーによって提供されるツール) を呼び出したいと考えています。\n\n| データ フィールド    | タイプ      | 必須 | Description                                           |\n| ------------ | -------- | -- | ----------------------------------------------------- |\n| `requestId`  | `string` | ✅  | これを使用して、次の方法で応答します。 `session.respondToExternalTool()` |\n| `sessionId`  | `string` | ✅  | この要求が属するセッション                                         |\n| `toolCallId` | `string` | ✅  | この呼び出しのツール呼び出し ID                                     |\n| `toolName`   | `string` | ✅  | 外部ツールの名前                                              |\n| `arguments`  | `object` |    |                                                       |\n| ツールの引数       |          |    |                                                       |\n\n### `external_tool.completed`\n\n外部ツール要求が解決されました。\n\n| データ フィールド   | タイプ      | 必須 | Description                         |\n| ----------- | -------- | -- | ----------------------------------- |\n| `requestId` | `string` | ✅  | 対応する`external_tool.requested`に一致します |\n\n### `exit_plan_mode.requested`\n\n儚い。 エージェントによってプランが作成され、プラン モードを終了する必要があります。\n\n| データ フィールド           | タイプ        | 必須 | Description                                           |\n| ------------------- | ---------- | -- | ----------------------------------------------------- |\n| `requestId`         | `string`   | ✅  | これを使用して、次の方法で応答します。 `session.respondToExitPlanMode()` |\n| `summary`           | `string`   | ✅  | プランの概要                                                |\n| `planContent`       | `string`   | ✅  | プランファイルの全内容                                           |\n| `actions`           | `string[]` | ✅  | 使用可能なユーザー アクション (承認、編集、拒否など)                          |\n| `recommendedAction` | `string`   | ✅  | 推奨されるアクション                                            |\n\n### `exit_plan_mode.completed`\n\n儚い。 終了プラン モード要求が解決されました。\n\n| データ フィールド   | タイプ      | 必須 | Description                          |\n| ----------- | -------- | -- | ------------------------------------ |\n| `requestId` | `string` | ✅  | 対応する`exit_plan_mode.requested`に一致します |\n\n### `command.queued`\n\n儚い。 スラッシュ コマンドがキューに登録され、実行されました。\n\n| データ フィールド   | タイプ      | 必須 | Description                                            |\n| ----------- | -------- | -- | ------------------------------------------------------ |\n| `requestId` | `string` | ✅  | これを使用して、次の方法で応答します。 `session.respondToQueuedCommand()` |\n| `command`   | `string` | ✅  | スラッシュ コマンド テキスト (例: `/help`、 `/clear`)                 |\n\n### `command.completed`\n\n儚い。 キューに登録されたコマンドが解決されました。\n\n| データ フィールド   | タイプ      | 必須 | Description                |\n| ----------- | -------- | -- | -------------------------- |\n| `requestId` | `string` | ✅  | 対応する`command.queued`に一致します |\n\n### `session_limits_exhausted.requested`\n\n儚い。 現在のセッション予算が使い果たされ、ランタイムは続行する前にユーザーの決定を必要とします。\n\n| データ フィールド       | タイプ      | 必須 | Description                          |\n| --------------- | -------- | -- | ------------------------------------ |\n| `requestId`     | `string` | ✅  | 保留中の上限を超える要求に応答するときにこの ID を使用します     |\n| `maxAiCredits`  | `number` | ✅  | 現在のアカウンティング ウィンドウ用に構成された最大 AI クレジット数 |\n| `usedAiCredits` | `number` | ✅  | 現在の会計ウィンドウで既に使用されている AI クレジット        |\n\n### `session_limits_exhausted.completed`\n\n儚い。 保留中の上限超過リクエストが解消されました。\n\n| データ フィールド                                      | タイプ                                     | 必須 | Description                                          |\n| ---------------------------------------------- | --------------------------------------- | -- | ---------------------------------------------------- |\n| `requestId`                                    | `string`                                | ✅  | 対応する `session_limits_exhausted.requested` イベントと一致します |\n| `response.action`                              | `\"add\" \\| \"set\" \\| \"unset\" \\| \"cancel\"` | ✅  | 上限到達時のリクエストに対して選択されたアクション                            |\n| `response.additionalAiCredits`                 | `number`                                |    |                                                      |\n|                                                |                                         |    |                                                      |\n| `response.action` が `\"add\"`に現在の最大値に加算するAIクレジット |                                         |    |                                                      |\n| `response.maxAiCredits`                        | `number`                                |    |                                                      |\n|                                                |                                         |    |                                                      |\n| `response.action` が `\"set\"`の AI クレジットの新しい絶対最大値 |                                         |    |                                                      |\n\n## クイックリファレンス: エージェンティックターンフロー\n\n一般的なエージェント ターンでは、次の順序でイベントが出力されます。\n\n```text\nassistant.turn_start          → Turn begins\n├── assistant.intent          → What the agent plans to do (ephemeral)\n├── assistant.reasoning_delta → Streaming thinking chunks (ephemeral, repeated)\n├── assistant.reasoning       → Complete thinking block\n├── assistant.message_delta   → Streaming response chunks (ephemeral, repeated)\n├── assistant.message         → Complete response (may include toolRequests)\n├── assistant.usage           → Token usage for this API call (ephemeral)\n│\n├── [If tools were requested:]\n│   ├── permission.requested  → Needs user approval\n│   ├── permission.completed  → Approval result\n│   ├── tool.execution_start  → Tool begins\n│   ├── tool.execution_partial_result  → Streaming tool output (ephemeral, repeated)\n│   ├── tool.execution_progress        → Progress updates (ephemeral, repeated)\n│   ├── tool.execution_complete        → Tool finished\n│   │\n│   └── [Agent loops: more reasoning → message → tool calls...]\n│\nassistant.turn_end            → Turn complete\nsession.idle                  → Ready for next message (ephemeral)\n```\n\n## すべてのイベントの種類の概要\n\nこの表に、主要な `data` ペイロード フィールドを示します。 共通のエンベロープ フィールドについては、上記で説明しています。\n\n| イベントの種類                                                                                             | エフェメラル          | Category | キー データ フィールド             |\n| --------------------------------------------------------------------------------------------------- | --------------- | -------- | ------------------------ |\n| `assistant.turn_start`                                                                              |                 |          |                          |\n| 助手                                                                                                  |                 |          |                          |\n| `turnId`、`interactionId?`                                                                           |                 |          |                          |\n| `assistant.intent`                                                                                  | ✅               | 助手       | `intent`                 |\n| `assistant.reasoning`                                                                               |                 |          |                          |\n| 助手                                                                                                  |                 |          |                          |\n| `reasoningId`、`content`                                                                             |                 |          |                          |\n| `assistant.reasoning_delta`                                                                         | ✅               | 助手       |                          |\n| `reasoningId`、`deltaContent`                                                                        |                 |          |                          |\n| `assistant.streaming_delta`                                                                         | ✅               | 助手       | `totalResponseSizeBytes` |\n| `assistant.message`                                                                                 |                 |          |                          |\n| 助手                                                                                                  |                 |          |                          |\n| `messageId`、`content`、`toolRequests?`、`outputTokens?`、`phase?`                                      |                 |          |                          |\n| `assistant.message_delta`                                                                           | ✅               | 助手       |                          |\n| `messageId`、`deltaContent`                                                                          |                 |          |                          |\n| `assistant.turn_end`                                                                                |                 |          |                          |\n| 助手                                                                                                  | `turnId`        |          |                          |\n| `assistant.usage`                                                                                   | ✅               | 助手       |                          |\n| `model`、 `apiEndpoint?`、 `inputTokens?`、 `outputTokens?`、 `cost?`、 `duration?`                      |                 |          |                          |\n| `tool.user_requested`                                                                               |                 |          |                          |\n| ツール                                                                                                 |                 |          |                          |\n| `toolCallId`、`toolName`、`arguments?`                                                                |                 |          |                          |\n| `tool.execution_start`                                                                              |                 |          |                          |\n| ツール                                                                                                 |                 |          |                          |\n| `toolCallId`、`toolName`、`arguments?`、`mcpServerName?`                                               |                 |          |                          |\n| `tool.execution_partial_result`                                                                     | ✅               | ツール      |                          |\n| `toolCallId`、`partialOutput`                                                                        |                 |          |                          |\n| `tool.execution_progress`                                                                           | ✅               | ツール      |                          |\n| `toolCallId`、`progressMessage`                                                                      |                 |          |                          |\n| `tool.execution_complete`                                                                           |                 |          |                          |\n| ツール                                                                                                 |                 |          |                          |\n| `toolCallId`、`success`、`result?`、`error?`                                                           |                 |          |                          |\n| `session.idle`                                                                                      | ✅               | Session  | `aborted?`               |\n| `session.error`                                                                                     |                 |          |                          |\n| Session                                                                                             |                 |          |                          |\n| `errorType`、`message`、`statusCode?`                                                                 |                 |          |                          |\n| `session.compaction_start`                                                                          |                 |          |                          |\n| Session                                                                                             |                 |          |                          |\n| *(空)*                                                                                               |                 |          |                          |\n| `session.compaction_complete`                                                                       |                 |          |                          |\n| Session                                                                                             |                 |          |                          |\n| `success`、`preCompactionTokens?`、`summaryContent?`                                                  |                 |          |                          |\n| `session.title_changed`                                                                             | ✅               | Session  | `title`                  |\n| `session.context_changed`                                                                           |                 |          |                          |\n| Session                                                                                             |                 |          |                          |\n| `cwd`、`gitRoot?`、`repository?`、`branch?`                                                            |                 |          |                          |\n| `session.usage_info`                                                                                | ✅               | Session  |                          |\n| `tokenLimit`、`currentTokens`、`messagesLength`                                                       |                 |          |                          |\n| `session.session_limits_changed`                                                                    |                 |          |                          |\n| Session                                                                                             | `sessionLimits` |          |                          |\n| `session.usage_checkpoint`                                                                          |                 |          |                          |\n| Session                                                                                             |                 |          |                          |\n| `totalNanoAiu`、`totalPremiumRequests?`                                                              |                 |          |                          |\n| `session.task_complete`                                                                             |                 |          |                          |\n| Session                                                                                             | `summary?`      |          |                          |\n| `session.shutdown`                                                                                  |                 |          |                          |\n| Session                                                                                             |                 |          |                          |\n| `shutdownType`、`codeChanges`、`modelMetrics`                                                         |                 |          |                          |\n| `permission.requested`                                                                              |                 |          |                          |\n| 許可                                                                                                  |                 |          |                          |\n| `requestId`、`permissionRequest`                                                                     |                 |          |                          |\n| `permission.completed`                                                                              |                 |          |                          |\n| 許可                                                                                                  |                 |          |                          |\n| `requestId`、`result.kind`                                                                           |                 |          |                          |\n| `user_input.requested`                                                                              | ✅               | ユーザー入力   |                          |\n| `requestId`、`question`、`choices?`                                                                   |                 |          |                          |\n| `user_input.completed`                                                                              | ✅               | ユーザー入力   | `requestId`              |\n| `elicitation.requested`                                                                             | ✅               | ユーザー入力   |                          |\n| `requestId`、`message`、`requestedSchema`                                                             |                 |          |                          |\n| `elicitation.completed`                                                                             | ✅               | ユーザー入力   | `requestId`              |\n| `subagent.started`                                                                                  |                 |          |                          |\n| サブエージェント                                                                                            |                 |          |                          |\n| `toolCallId`、`agentName`、`agentDisplayName`、`model?`                                                |                 |          |                          |\n| `subagent.completed`                                                                                |                 |          |                          |\n| サブエージェント                                                                                            |                 |          |                          |\n| `toolCallId`､`agentName`、`agentDisplayName`、`model?`、`durationMs?`、`totalTokens?`、`totalToolCalls?` |                 |          |                          |\n| `subagent.failed`                                                                                   |                 |          |                          |\n| サブエージェント                                                                                            |                 |          |                          |\n| `toolCallId`､`agentName`、`error`、`model?`、`durationMs?`、`totalTokens?`、`totalToolCalls?`            |                 |          |                          |\n| `subagent.selected`                                                                                 |                 |          |                          |\n| サブエージェント                                                                                            |                 |          |                          |\n| `agentName`、`agentDisplayName`、`tools`                                                              |                 |          |                          |\n| `subagent.deselected`                                                                               |                 |          |                          |\n| サブエージェント                                                                                            |                 |          |                          |\n| *(空)*                                                                                               |                 |          |                          |\n| `skill.invoked`                                                                                     |                 |          |                          |\n| Skill                                                                                               |                 |          |                          |\n| `name`、`path`、`content`、`allowedTools?`                                                             |                 |          |                          |\n| `abort`                                                                                             |                 |          |                          |\n| コントロール                                                                                              | `reason`        |          |                          |\n| `user.message`                                                                                      |                 |          |                          |\n| ユーザー                                                                                                |                 |          |                          |\n| `content`、`attachments?`、`agentMode?`                                                               |                 |          |                          |\n| `system.message`                                                                                    |                 |          |                          |\n| System                                                                                              |                 |          |                          |\n| `content`、`role`                                                                                    |                 |          |                          |\n| `external_tool.requested`                                                                           |                 |          |                          |\n| 外部ツール                                                                                               |                 |          |                          |\n| `requestId`、`toolName`、`arguments?`                                                                 |                 |          |                          |\n| `external_tool.completed`                                                                           |                 |          |                          |\n| 外部ツール                                                                                               | `requestId`     |          |                          |\n| `command.queued`                                                                                    | ✅               | 命令       |                          |\n| `requestId`、`command`                                                                               |                 |          |                          |\n| `command.completed`                                                                                 | ✅               | 命令       | `requestId`              |\n| `session_limits_exhausted.requested`                                                                | ✅               | Session  |                          |\n| `requestId`、`maxAiCredits`、`usedAiCredits`                                                          |                 |          |                          |\n| `session_limits_exhausted.completed`                                                                | ✅               | Session  |                          |\n| `requestId`、`response.action`                                                                       |                 |          |                          |\n| `exit_plan_mode.requested`                                                                          | ✅               | プラン モード  |                          |\n| `requestId`、`summary`、`planContent`、`actions`                                                       |                 |          |                          |\n| `exit_plan_mode.completed`                                                                          | ✅               | プラン モード  | `requestId`              |"}