[Error] chatagenterror-Open a GitHub repository to use the cloud agent.

[vs-code-engineering]

Error Message

chatagenterror-Open a GitHub repository to use the cloud agent.

Stack Trace

    at rv.delegate (/extensions/copilot/dist/extension.js:2695:1256) [not deminified]
    at async rv.chatParticipantImpl (/extensions/copilot/dist/extension.js:2711:1892) [not deminified]
    at async JE._requestHandler (/extensions/copilot/dist/extension.js:2689:1362) [not deminified]
    at async i.$invokeAgent (./src/vs/workbench/api/common/extHostChatAgents2.ts:1009:10)

Raw Stack Trace (minified)

Error: Open a GitHub repository to use the cloud agent. 	at rv.delegate (/extensions/copilot/dist/extension.js:2695:1256) 	at async rv.chatParticipantImpl (/extensions/copilot/dist/extension.js:2711:1892) 	at async JE._requestHandler (/extensions/copilot/dist/extension.js:2689:1362) 	at async i.$invokeAgent (out/vs/workbench/api/node/extensionHostProcess.js:529:20550)

Details

Property	Value
Bucket ID	1b27df08-4e77-5f8b-80f3-935642ed2c8e
Version	1.117.0-insider
Commit	98b4d3e2
Last Seen	Thu Apr 16 2026 15:58:41 GMT+0000 (Coordinated Universal Time)
Platforms	Linux, Mac, Windows
Product	Agents

---

This issue was automatically created from the VS Code Errors Dashboard

[vs-code-engineering]

🔍 Error Investigation

Summary

The Copilot extension (GitHub.copilot) deliberately throws Error("Open a GitHub repository to use the cloud agent.") from its delegate handler when a user invokes the cloud agent without a GitHub repository open. This is a user-facing validation message, not a crash. It appears in error telemetry because VS Code's chatAgentError telemetry pipeline (introduced in PR #307451) now captures all extension-thrown errors with callstacks — including intentional validation errors that were previously unreported.

Culprit Commit

No VS Code core regression was identified. The error is thrown by the Copilot extension (bundled at /extensions/copilot/dist/extension.js), not by VS Code core code. The chatAgentError telemetry event that surfaces this error was introduced in PR #307451 (merged April 3, milestone 1.115.0) — this PR made previously invisible extension errors visible in telemetry. No commit range was available from the regression scan to narrow further.

Code Flow

sequenceDiagram
    participant User as User Action
    participant ExtHost as extHostChatAgents2.ts<br/>$invokeAgent()
    participant Copilot as copilot/extension.js<br/>rv.delegate()
    participant MainThread as mainThreadChatAgents2.ts
    participant Telemetry as Error Dashboard

    User->>ExtHost: Invoke cloud agent
    ExtHost->>Copilot: agent.invoke(request)
    Note over Copilot: ⚠️ Validation check:<br/>No GitHub repo open
    Copilot-->>ExtHost: throws Error("Open a GitHub<br/>repository to use the cloud agent.")
    Note over ExtHost: catch(e) → packErrorForTelemetry(e)<br/>returns { errorCallstack, errorName }
    ExtHost->>MainThread: IChatAgentInvokeResult
    MainThread->>Telemetry: publicLogError2("chatAgentError", ...)
    Note over Telemetry: 💥 Error bucket created:<br/>1b27df08-4e77-5f8b-80f3-935642ed2c8e

Loading

Affected Files

File	Role
/extensions/copilot/dist/extension.js → rv.delegate()	Error origin — throws the validation error
src/vs/workbench/api/common/extHostChatAgents2.ts → $invokeAgent()	Catches extension errors, packs callstack for telemetry
src/vs/workbench/api/browser/mainThreadChatAgents2.ts	Emits chatAgentError telemetry event

Repro Steps

1. Open VS Code Insiders (Agents product, v1.117.0+)
2. Do not open a GitHub repository (e.g., open a local-only folder or no folder)
3. Invoke the Copilot cloud agent via the chat panel
4. The extension throws the validation error "Open a GitHub repository to use the cloud agent."

Fix Proposal

Option A (Copilot extension fix — preferred): The Copilot extension should return a response with errorDetails (e.g., { errorDetails: { message: "Open a GitHub repository..." } }) instead of throwing an Error. Returning error details shows the message to the user without triggering the chatAgentError telemetry pipeline. This is the standard pattern for user-facing validation messages in chat agents.

Fix location: Copilot extension → rv.delegate() method
Approach: Replace throw new Error("Open a GitHub repository...") with return { errorDetails: { message: "Open a GitHub repository..." } }

Option B (VS Code core — filtering): Add filtering in extHostChatAgents2.ts or mainThreadChatAgents2.ts to skip telemetry for known non-error conditions (e.g., errors with specific names or message patterns that represent expected validation states). This is less desirable as it requires maintaining a filter list.

Recommended Owner

@roblourens — current assignee, owns the chat agents API layer where extension errors are captured. This is fundamentally a Copilot extension issue (the extension throws an error for a validation check instead of returning error details), but the chat agents team can coordinate with the Copilot team on the appropriate fix pattern.

Generated by errors-investigate · ● 4.9M · ◷