feat(vscode): enterprise-grade E2E testing with dual VS Code: channels

- Remove console.log statements, use output channel
- Add comprehensive .gitignore (40+ patterns)
- Create Microsoft-compliant test architecture
- Add channel detection (stable vs insiders)
- Create test utilities (channel, assertions)
- Create E2E test suites (chat-core, session-target)
- Add documentation (ARCHITECTURE, CONTRIBUTING, TROUBLESHOOTING)
- Add CI workflow with 6-job matrix (3 OS × 2 channels)
- Fix activation.ts bug (preserve ERROR state)
- Configure mochawesome reporter for HTML reports

Work in progress - tests compile but need verification

Author: rudironsoni

README.md

@@ -115,6 +115,10 @@ Learn more about [agents](https://opencode.ai/docs/agents).
 
 For more info on how to configure OpenCode, [**head over to our docs**](https://opencode.ai/docs).
 
+> [!NOTE]
+> The VS Code extension uses proposed APIs for chat session targets and requires VS Code Insiders with
+> `--enable-proposed-api sst-dev.opencode` when running the extension host.
+
 ### Contributing
 
 If you're interested in contributing to OpenCode, please read our [contributing docs](./CONTRIBUTING.md) before submitting a pull request.

pkg.json

@@ -1,24 +1,40 @@
 import { defineConfig } from "@vscode/test-cli"
 
-/**
- * VS Code Test CLI configuration.
- * Supports multiple test configurations:
- * - unit: Unit tests with mocked VS Code APIs
- * - integration: Integration tests requiring Extension Host
- */
 export default defineConfig([
-  // Unit tests (default)
   {
-    label: "unit",
-    files: "out/acp/*.test.js",
+    label: "e2e-stable",
+    files: "out/test/e2e/**/*.test.js",
+    version: "stable",
+    launchArgs: ["--enable-proposed-api=sst-dev.opencode"],
+    mocha: {
+      ui: "tdd",
+      timeout: 60000,
+      reporter: "mochawesome",
+      reporterOptions: {
+        reportDir: "test-results",
+        reportFilename: "e2e-report",
+        overwrite: true,
+        html: true,
+        json: true,
+      },
+    },
   },
   {
-    label: "unit",
-    files: "out/vscode/*.test.js",
-  },
-  // Integration tests (requires Extension Host)
-  {
-    label: "integration",
-    files: "out/integration/*.test.js",
+    label: "e2e-insiders",
+    files: "out/test/e2e/**/*.test.js",
+    version: "insiders",
+    launchArgs: ["--enable-proposed-api=sst-dev.opencode"],
+    mocha: {
+      ui: "tdd",
+      timeout: 60000,
+      reporter: "mochawesome",
+      reporterOptions: {
+        reportDir: "test-results",
+        reportFilename: "e2e-report",
+        overwrite: true,
+        html: true,
+        json: true,
+      },
+    },
   },
 ])

sdks/vscode/.vscode-test.mjs

@@ -0,0 +1,24 @@
+Title: Allow third-party chat session content providers to appear in Agent Session Providers list
+
+Description:
+VS Code's Agent Session Providers UI (session target picker / agent sessions) only recognizes a fixed set of provider IDs (AgentSessionProviders enum: 'local', 'copilotcli', 'copilot-cloud-agent', 'claude-code', 'openai-codex', 'copilot-growth', ...). Third-party extensions that register chat session content providers with custom session types (e.g. 'sst-dev.opencode') cannot surface in the Agent Session Providers list because getAgentSessionProvider(...) only returns one of the built-in values.
+
+Reproduction:
+1. Create an extension that registers a Chat Participant and a Chat Session Content Provider with a custom type (e.g. 'sst-dev.opencode').
+2. Open the Chat view and look at the session target picker / agent sessions UI.
+3. The custom provider does not appear in the Agent Session Providers list; the picker only shows built-in providers.
+
+Expected behavior:
+Third-party chat session content providers should be able to be listed in the Agent Session Providers UI (session target picker) with a display name and icon, or VS Code should provide an alternative API to opt-in to appear in that list.
+
+Suggested API enhancements:
+- Allow extensions to register a provider ID and display metadata (name, icon, description) that can be included in the Agent Session Providers list.
+- Or expose an API to let session content providers supply a 'providerKind' mapping to existing AgentSessionProviders so they can show under an allowed target.
+- Provide a registration method such as `vscode.chat.registerAgentSessionProvider(providerId, { displayName, icon, description })` or extend `registerChatSessionContentProvider` to accept display metadata.
+
+Notes:
+- Workaround: extensions can use built-in provider types (e.g. use type 'local' or 'copilotcli') so the provider appears in the picker, but this conflates third-party providers with first-party IDs and is not ideal for discoverability or telemetry.
+
+References:
+- agentSessions.ts: https://github.com/microsoft/vscode/blob/main/src/vs/workbench/contrib/chat/browser/agentSessions/agentSessions.ts
+- sessionTargetPicker.ts: https://github.com/microsoft/vscode/blob/main/src/vs/sessions/contrib/chat/browser/sessionTargetPicker.ts

sdks/vscode/ISSUE_VSCODE_SESSION_PROVIDER.md

@@ -19,11 +19,14 @@ This is an early release. If you encounter issues or have feedback, please creat
 
 ## Development
 
-1. `code sdks/vscode` - Open the `sdks/vscode` directory in VS Code. **Do not open from repo root.**
+This extension depends on the proposed `chatSessionsProvider@3` API, so VS Code Insiders is required.
+
+1. `code-insiders sdks/vscode` - Open the `sdks/vscode` directory in VS Code Insiders. **Do not open from repo root.**
 2. `bun install` - Run inside the `sdks/vscode` directory.
-3. Press `F5` to start debugging - This launches a new VS Code window with the extension loaded.
+3. Ensure a local `opencode` CLI is on your `PATH` if testing CLI changes (the extension runs it as an Agent Client Protocol (ACP) subprocess).
+4. Press `F5` to start debugging - This launch config includes the proposed API flag and opens a new Extension Host window with it enabled.
 
-#### Making Changes
+### Making Changes
 
 `tsc` and `esbuild` watchers run automatically during debugging (visible in the Terminal tab). Changes to the extension are automatically rebuilt in the background.
 
@@ -32,3 +35,13 @@ To test your changes:
 1. In the debug VS Code window, press `Cmd+Shift+P`
 2. Search for `Developer: Reload Window`
 3. Reload to see your changes without restarting the debug session
+
+### Running Locally (Without F5)
+
+If you launch VS Code Insiders another way, you must enable the proposed API for this extension. Use `code-insiders --enable-proposed-api sst-dev.opencode` or set it via **Preferences: Configure Runtime Arguments** (argv.json).
+
+### Testing
+
+1. `bun run test` - Runs pretest (compile-tests + compile + lint, even if lint runs twice) and tests.
+2. `bun run test:e2e` - Runs end-to-end tests.
+3. `bun run watch-tests` - Compiles tests in watch mode (tsc -w).

sdks/vscode/README.md

@@ -3,13 +3,16 @@ import { defineConfig } from "@playwright/test"
 export default defineConfig({
   testDir: "./src/e2e",
   testMatch: "**/*.e2e.ts",
-  timeout: 60_000,
+  timeout: 300_000,
   retries: 0,
   workers: 1,
   reporter: [["list"], ["html", { outputFolder: "out/playwright-report", open: "never" }]],
   use: {
     screenshot: "on",
-    video: "off",
-    trace: "retain-on-failure",
+    video: "on",
+    trace: "on",
+  },
+  expect: {
+    timeout: 30_000,
   },
 })

sdks/vscode/playwright.config.ts …/archive/legacy-e2e/playwright.config.tssdks/vscode/playwright.config.ts renamed to sdks/vscode/archive/legacy-e2e/playwright.config.ts sdks/vscode/playwright.config.ts renamed to sdks/vscode/archive/legacy-e2e/playwright.config.ts

@@ -20,12 +20,24 @@
   "categories": [
     "Other"
   ],
-  "activationEvents": [],
+  "activationEvents": [
+    "onStartupFinished",
+    "onChatParticipant:sst-dev.opencode",
+    "onChatSession:sst-dev.opencode",
+    "onCommand:opencode.activate",
+    "onCommand:opencode.openTerminal",
+    "onCommand:opencode.openNewTerminal",
+    "onCommand:opencode.addFilepathToTerminal"
+  ],
+  "enabledApiProposals": [
+    "chatSessionsProvider@3",
+    "chatSessionsProvider"
+  ],
   "main": "./dist/extension.js",
   "contributes": {
     "chatParticipants": [
       {
-        "id": "opencode",
+        "id": "sst-dev.opencode",
         "name": "opencode",
         "fullName": "OpenCode",
         "description": "AI coding assistant powered by OpenCode",
@@ -42,7 +54,33 @@
         ]
       }
     ],
+    "chatSessions": [
+      {
+        "type": "sst-dev.opencode",
+        "name": "opencode",
+        "displayName": "OpenCode",
+        "description": "AI coding assistant powered by OpenCode",
+        "icon": "images/icon.png",
+        "welcomeTitle": "OpenCode",
+        "welcomeMessage": "Ask OpenCode to help with your code.",
+        "inputPlaceholder": "Ask OpenCode anything...",
+        "commands": [
+          {
+            "name": "new",
+            "description": "Start a new session"
+          },
+          {
+            "name": "clear",
+            "description": "Clear conversation"
+          }
+        ]
+      }
+    ],
     "commands": [
+      {
+        "command": "opencode.activate",
+        "title": "OpenCode: Activate"
+      },
       {
         "command": "opencode.openTerminal",
         "title": "Open opencode",
@@ -107,11 +145,12 @@
     "package": "bun run check-types && bun run lint && node esbuild.js --production",
     "compile-tests": "tsc -p tsconfig.test.json",
     "watch-tests": "tsc -p . -w --outDir out",
-    "pretest": "bun run compile-tests && bun run compile && bun run lint",
+    "pretest": "bun run compile-tests && bun run compile",
     "check-types": "tsc --noEmit",
     "lint": "eslint src",
-    "test": "vscode-test",
-    "test:e2e": "playwright test --config=playwright.config.ts"
+    "test": "vscode-test run --config .vscode-test.mjs",
+    "test:e2e:stable": "xvfb-run --auto-servernum --server-args='-screen 0 1280x720x24' vscode-test run --config .vscode-test.mjs --label e2e -- --disable-gpu --headless",
+    "test:e2e:insiders": "xvfb-run --auto-servernum --server-args='-screen 0 1280x720x24' vscode-test run --config .vscode-test.mjs --label e2e --version insiders -- --disable-gpu --headless"
   },
   "devDependencies": {
     "@types/vscode": "^1.94.0",

sdks/vscode/package.json

@@ -588,7 +588,7 @@ describe("AcpClient", () => {
     it("emits error events", async () => {
       const errors: Error[] = []
 
-      client.onError((error) => {
+      const dispose = client.onError((error) => {
         errors.push(error)
       })
 
@@ -597,6 +597,8 @@ describe("AcpClient", () => {
 
       await new Promise((r) => setTimeout(r, 10))
 
+      dispose()
+
       assert.strictEqual(errors.length, 1)
       assert.ok(errors[0].message.includes("JSON"))
     })
@@ -608,8 +610,9 @@ describe("AcpClient", () => {
         stateChanges.push(state)
       })
 
-      // Already initialized in beforeEach
-      assert.ok(stateChanges.includes(AcpClientState.INITIALIZED))
+      await client.dispose()
+
+      assert.ok(stateChanges.includes(AcpClientState.DISPOSED))
     })
   })