diff --git a/docs/features/streaming-events.md b/docs/features/streaming-events.md index f359dd606..3e7a5b35d 100644 --- a/docs/features/streaming-events.md +++ b/docs/features/streaming-events.md @@ -443,12 +443,20 @@ Ephemeral. Token usage and cost information for an individual API call. | `model` | `string` | ✅ | Model identifier (e.g., `"gpt-5.4"`) | | `inputTokens` | `number` | | Input tokens consumed | | `outputTokens` | `number` | | Output tokens produced | +| `reasoningTokens` | `number` | | Output tokens used for reasoning/chain-of-thought (subset of `outputTokens`) | | `cacheReadTokens` | `number` | | Tokens read from prompt cache | | `cacheWriteTokens` | `number` | | Tokens written to prompt cache | +| `cacheExpiresAt` | `string` | | ISO 8601 timestamp when the prompt cache for this model call expires | +| `contentFilterTriggered` | `boolean` | | Whether the response was blocked or truncated by content filtering (`finish_reason === 'content_filter'`) | +| `finishReason` | `string` | | Model finish reason (e.g., `"stop"`, `"length"`, `"tool_calls"`, `"content_filter"`) | | `cost` | `number` | | Model multiplier cost for billing | | `duration` | `number` | | API call duration in milliseconds | +| `timeToFirstTokenMs` | `number` | | Time from request dispatch to first token received (streaming latency) | +| `interTokenLatencyMs` | `number` | | Average latency between consecutive tokens (streaming throughput) | +| `reasoningEffort` | `string` | | Reasoning effort level used for this call (e.g., `"low"`, `"medium"`, `"high"`) | | `initiator` | `string` | | What triggered this call (e.g., `"sub-agent"`); absent for user-initiated | | `apiCallId` | `string` | | Completion ID from the provider (e.g., `chatcmpl-abc123`) | +| `serviceRequestId` | `string` | | Copilot service request ID (`x-copilot-service-request-id`) for CAPI log correlation | | `apiEndpoint` | `"/chat/completions" \| "/v1/messages" \| "/responses" \| "ws:/responses"` | | API endpoint used for the model call; useful for observability and cost attribution. `ws:/responses` is the websocket variant of the responses API | | `providerCallId` | `string` | | GitHub request tracing ID (`x-github-request-id`) | | `parentToolCallId` | `string` | | Deprecated. Use envelope-level `agentId` for sub-agent attribution |