Vijay Upadya

This commit introduces a **new capability** to the **telemetry system** by adding `copilotTrackingId` as a common property. It implements a `setCommonProperty` method across various `ITelemetryService` implementations, including browser, Electron, and standalone environments, to allow dynamic setting of common telemetry properties. This **enhancement** enables the **Copilot feature**, specifically within the chat contribution, to consistently track user interactions by associating a unique ID with all subsequent telemetry events. The change also updates the ESLint configuration to permit this new common property, ensuring proper usage and improved data collection for **Copilot-related analytics**.

This commit introduces a **new capability** to configure the maximum number of debug session logs retained by the **Copilot extension's chat debug logging** feature. It defines a new configuration key, `ChatDebugFileLoggingMaxRetainedSessionLogs`, and adds corresponding localization for this setting. The `cleanupOldLogs` function within `chatDebugFileLoggerService.ts` is updated to utilize this configurable value, replacing a previously hardcoded limit. This enhancement provides users with greater control over log retention, improving disk space management and overall system maintainability.

This commit introduces **new capabilities** to the **Copilot extension**, significantly enhancing its **troubleshooting and debugging features**. It adds robust **support for session references** within the **troubleshoot skill**, enabling users to specify and compare multiple chat session logs by handling special URI schemes and passing these references through the request pipeline to tools like `ReadFileTool`. Concurrently, this change implements the **logging of `models.json` snapshots** to the debug log directory for each chat session, providing crucial context about the available models at the time of interaction. These updates improve the **diagnosability and analysis** of Copilot chat behavior by offering more comprehensive session data and comparison tools.

This commit introduces a **new feature** that enables users to attach references to previous chat sessions as context for their queries, significantly improving **chat troubleshooting**. It enhances the **chat input** experience by providing dynamic completions for session references and integrates a new picker via `src/vs/workbench/contrib/chat/browser/actions/chatContext.ts` for selecting these references. Furthermore, it defines `IChatRequestSessionReferenceVariableEntry` within the **chat variable entries** to formally support these attachments. This allows users to provide more comprehensive and relevant historical context when interacting with the chat system.

This commit introduces a **bug fix** to the **Copilot extension's tool calling and summarization logic**, specifically addressing the handling of **orphaned tool calls**. It refines the identification of tool results within `extensions/copilot/src/extension/intents/node/toolCallingLoop.ts` by explicitly checking for `undefined` `toolCallId`, preventing incorrect stripping of valid tool results. Additionally, the `summarize` function in `extensions/copilot/src/extension/prompts/node/agent/summarizedConversationHistory.tsx` now includes logic to **strip orphaned tool calls** from summarization prompts for **Gemini models**, which prevents `INVALID_ARGUMENT` errors and adds telemetry. This **maintenance** effort improves the stability of AI interactions and includes a new test case to validate correct `toolCallId` handling.

This commit introduces a **new feature** to the **Copilot extension**, enabling the collection and transmission of **repository metadata telemetry** to GitHub. It modifies `extensions/copilot/src/extension/prompt/node/repoInfoTelemetry.ts` to implement the `sendTelemetry` function, which now sends relevant repository data. This telemetry is collected for **all users**, with a specific provision to retain full telemetry for internal users, aiming to enhance product understanding and improve the Copilot experience.

This commit introduces **OpenTelemetry (OTel) instrumentation** to the **Claude agent SDK hooks** within CLI sessions, providing a **new capability** for enhanced observability. It adds a `withHookOTelSpan` utility in `claudeHookRegistry.ts` to wrap hook callbacks, which is then integrated across various **logging, session, subagent, and tool-related hooks**. This enables **detailed tracing** for critical operations such as user prompt submission, tool execution (including failures), and session lifecycle events. The instrumentation will significantly improve the ability to **monitor, debug, and understand the performance** and flow of Claude CLI interactions.

This commit introduces **OpenTelemetry instrumentation** to track the execution of hooks within **Copilot CLI sessions**. It implements the core telemetry capture in `CopilotCLISession`, recording start, end, and associated data for each hook execution. The **debug logging service** is extended via `chatDebugFileLoggerService.ts` to process and log these new 'hook' event types with their OpenTelemetry attributes, enhancing observability. This **new capability** provides richer diagnostic data for monitoring and debugging the behavior of Copilot CLI hooks, with new tests verifying the correct emission of `execute_hook` spans.

This commit delivers a **bug fix** for the **Chat Agent Debug panel**, resolving an issue where **Copilot CLI sessions** failed to appear immediately. Previously, users would only see these sessions in the debug panel after sending a second message, hindering the debugging workflow. The change in `src/vs/workbench/api/browser/mainThreadChatSessions.ts` introduces an **eager invocation of debug providers**, ensuring that **Copilot CLI sessions** are displayed instantly upon creation or session swap. This significantly improves the responsiveness and user experience for developers utilizing the **Copilot CLI** with the debug panel.

This commit introduces an **enhancement** to the **Chat Agent Debug Panel's log export functionality**. It modifies the export process to **include the chat session ID in the exported filename**, significantly improving the traceability of specific debug logs. Upon successful export, a **success notification** is now displayed, offering a convenient option to directly open the generated file. This change, affecting the `chatOpenAgentDebugPanelAction`, streamlines the workflow for **debugging chat agent interactions** by providing clearer file organization and immediate user feedback.

This commit **fixes a critical bug** in the **Copilot debug panel** where events from incorrect chat sessions were being displayed. The **fix** ensures that debug events are correctly attributed and filtered by implementing logic to inherit chat session IDs from parent spans for child spans and events within `chatDebugFileLoggerService.ts` and `otelChatDebugLogProvider.ts`. Additionally, `user_message` span events in `copilotcliSession.ts` and `toolCallingLoop.ts` now explicitly include the chat session ID, preventing misattribution. This change significantly improves the reliability of the **Copilot chat debugging experience** by providing accurate, session-specific logs.

This commit provides a **bug fix** to resolve a **regression** affecting **skill loading** within the **chat widget**. It modifies the `_autoAttachInstructions` logic in `src/vs/workbench/contrib/chat/browser/widget/chatWidget.ts` to correctly handle `autoAttachReferences` for **contributed chat session types**. By defaulting `autoAttachReferences` to `false` for these sessions, this change ensures that skills are loaded properly, making the behavior **opt-in** rather than automatic. This restores expected functionality for chat interactions relying on contributed sessions and prevents previous loading failures.

This commit introduces **OpenTelemetry (OTel) instrumentation** to the **Claude code agent** (`ClaudeCodeAgent`), enabling detailed tracing of chat sessions and tool executions. This **new capability** significantly enhances **debugging and observability** for **Claude CLI sessions** by providing granular span events for operations like `invoke` and `processToolResult`. Supporting changes include updating the `chatDebugFileLoggerService` to route span events by session ID and modifying the `otelChatDebugLogProvider` to filter events specifically for `claude-code` sessions. This allows developers to better understand the internal flow and performance of agent interactions. A new test suite, `claudeCodeAgentOTel.spec.ts`, was also added to validate the OTel tool span instrumentation.

This commit introduces **OpenTelemetry instrumentation** and debug file logging for **Copilot CLI sessions**, specifically within the `CopilotCLISession` module. This **new feature** allows for detailed tracking of chat interactions and tool executions, including user messages, tool calls, and error handling. It enhances the `otelChatDebugLogProvider` to support `copilotcli://` URIs, enabling the **Agent Debug panel** to display comprehensive diagnostic information. This significantly improves the ability to **debug and analyze Copilot CLI agent behavior** by providing rich, observable data.

This commit **enhances the chat debugging experience** by specifically enabling support for **Claude Code agent sessions**. It **registers 'claude-code' as a debug-eligible session scheme** within the `chatDebugServiceImpl.ts`, allowing the system to recognize and process these sessions. The **Chat Debug Home View** (`chatDebugHomeView.ts`) is updated to **display Claude Code session URLs** and **filter out untitled CLI sessions**, providing a more organized and informative debug interface. This **new capability** significantly improves the user's ability to manage and debug agent interactions by offering better visibility into specific session types.

This commit introduces a **feature enhancement** to the **Agent Debug Panel**, specifically adding support for **Copilot CLI sessions**. It modifies the `ChatDebugServiceImpl` to recognize `'copilotcli'` as a debug-eligible scheme, ensuring these sessions are properly logged and their providers invoked. The `ChatDebugHomeView` is updated to display appropriate titles for these new session types, and the `registerChatOpenAgentDebugPanelAction` now ensures the debug panel is always accessible when chat is enabled. This work significantly improves the **debugging experience for Copilot CLI interactions** by integrating them seamlessly into the existing agent debug infrastructure.

This commit **enhances the Chat Debug Logs View** within the **VS Code Workbench's Chat contribution** by changing the default display mode for agent debug logs. Previously a flat list, the `logsViewMode` in `src/vs/workbench/contrib/chat/browser/chatDebug/chatDebugLogsView.ts` is now set to `Tree`, making the hierarchical treeview the initial and default presentation. This **feature enhancement** provides a more structured and intuitive way for users to navigate and understand **chat agent debug logs**.

This commit **fixes** and **enhances** the **debug panel's trajectory visualization** within the **Copilot extension**. It **corrects the mapping of OpenTelemetry span statuses** to their string representations, ensuring accurate display of operation outcomes in the debug view. Furthermore, it **enriches the `runSubagent` tool name** by incorporating the specific agent's name, providing clearer context for developers inspecting agent execution. This work is a **bug fix** and **minor enhancement** that significantly improves the diagnostic utility and readability of the debug panel for agent interactions.

This commit performs a **maintenance refactoring** by **renaming** the "Agent Debug Panel" to "Agent Debug Logs" across the **Chat Debugging UI**. This change updates various UI elements within the `src/vs/workbench/contrib/chat/browser/chatDebug/` module, including breadcrumb titles, view titles, editor input names, and comments. Additionally, action labels such as `Open Agent Debug Panel` are updated to `Open Agent Debug Logs` to reflect the new terminology. The primary goal is to improve clarity and consistency in the user-facing language and internal references for the **agent debugging features** within the workbench chat contribution, without altering any underlying functionality.

This commit performs **maintenance** and **refactoring** within the **Copilot extension's chat debug logging system**. It **removes dead code** and **migrates configuration keys** related to chat debug file logging, renaming them to use the `agentDebugLog` prefix in `package.nls.json` and `configurationService.ts`. Crucially, this change **defaults chat debug file logging to off**, meaning users will no longer generate debug log files unless explicitly enabled. This improves privacy and reduces unnecessary disk writes, with tests in `chatDebugFileLoggerService.spec.ts` updated to accommodate the new default behavior.