Skip to content

Invite signed-in users to try the version 3 pre-release, once - #2331

Merged
louis-johnston-db merged 3 commits into
mainfrom
louis/prerelease-invitation
Nov 19, 2026
Merged

louis-johnston-db merged 3 commits into
mainfrom
louis/prerelease-invitation

Conversation

@louis-johnston-db

@louis-johnston-db louis-johnston-db commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Changes

Shows a one-time invitation to try the version 3 pre-release of the extension. It uses the same extension ID (databricks.databricks) and appears on the Marketplace pre-release channel.

  • Shown once, to signed-in users, after the bundle connection is up (with a 5 s delay). Whatever the answer, including closing it, it never shows again.
  • Only in local VS Code or VS Code Insiders, on 1.128.0 or later. Not in forks such as Cursor, and not in remote windows.
  • Not offered from 2026-12-03 (UTC).
  • "Switch to Pre-Release Version" runs workbench.extensions.installExtension with installPreReleaseVersion: true. If it succeeds, the prompt "Reload the window to finish switching to version 3." is always offered, with "Reload Window". If the command throws, a generic error is shown and the real error is logged.
  • "Release Notes" opens the version 3.1.0 release notes at the release-v3.1.0 tag.

The reload prompt is not gated on a version check. In a VS Code test, the installed version still read 2.23.1 for at least 6 seconds after the install resolved, so comparing versions would hide the prompt.

Telemetry

The event prereleaseInvitation records shown, switch, switchFailed, releaseNotes and dismissed.

Known limits

  • Two windows that restore together can both show the invitation, costing one extra notification.
  • Only windows with a connected bundle project see it. A user who only uses Unity Gateway chat, with no project, never gets it.
  • Projects that use project.json are not excluded, and the notification does not mention that version 3 no longer migrates them. The release notes do.

Tests

  • PreReleaseInvitationManager.test.ts, run in VS Code 1.138.0 (MOCHA_GREP=PreReleaseInvitation yarn run test:unit): 13 tests covering the host rules, the 5 s delay (not shown before it, cancelled when the connection drops, cancelled by dispose), the fork and remote-window gates through showIfDue, show-once, the end date, each answer and the failed switch (generic error, no raw error text).
  • In real VS Code 1.146.0 and 1.128.0 against a mock Marketplace serving the published 3.1.0: shown once and not again after a restart; Switch to Pre-Release, then Reload Window, runs 3.1.0; Release notes opens the tag; with the Marketplace unreachable, the generic error and no reload prompt. VS Code 1.127.0 doesn't show it.

This pull request and its description were written by Isaac.

Co-authored-by: Isaac <no-reply@databricks.com>
@louis-johnston-db
louis-johnston-db marked this pull request as ready for review November 19, 2026 10:27

@anton-107 anton-107 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few copy suggestions for the invitation, none blocking. I rendered the toast in VS Code 1.147 to check how it reads.

this.record("shown");

const choice = await window.showInformationMessage(
"Try the version 3 pre-release of the Databricks extension? It adds Unity Gateway models in VS Code Chat and a redesigned sidebar. You can switch back to version 2 anytime.",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Try X?" asks a yes/no question, but the buttons don't answer it: "Release notes" isn't a yes or a no, and the only no is closing the toast. VS Code's own notifications state a fact and let the buttons carry the choice ("A new version of VS Code is available. [Update Now] [Release Notes]"). A statement also reads better when the toast ends up in the Notification Center. It also shortens the four-noun opening, and the toast already shows the extension as its source:

Suggested change
"Try the version 3 pre-release of the Databricks extension? It adds Unity Gateway models in VS Code Chat and a redesigned sidebar. You can switch back to version 2 anytime.",
"Version 3 of the Databricks extension is available as a pre-release, with Unity Gateway models in VS Code Chat and a redesigned sidebar. You can switch back to version 2 at any time.",

Comment on lines +24 to +25
const SWITCH = "Switch to Pre-Release";
const RELEASE_NOTES = "Release notes";

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two small things on the buttons:

  • VS Code's Extensions view calls these actions "Switch to Pre-Release Version" and "Switch to Release Version", and the 3.1.0 notes tell users to use "Switch to Release Version" to go back. Using the same words here makes the way back easy to find.
  • VS Code buttons use title case, so "Release Notes" matches the button next to it.
Suggested change
const SWITCH = "Switch to Pre-Release";
const RELEASE_NOTES = "Release notes";
const SWITCH = "Switch to Pre-Release Version";
const RELEASE_NOTES = "Release Notes";

The test file's SWITCH and RELEASE_NOTES constants (lines 20 and 22) would need the same change.

Co-authored-by: Isaac <no-reply@databricks.com>
Co-authored-by: Isaac <no-reply@databricks.com>
@github-actions

Copy link
Copy Markdown
Contributor

If integration tests don't run automatically, an authorized user can run them manually by following the instructions below:

Trigger:
go/deco-tests-run/vscode

Inputs:

  • PR number: 2331
  • Commit SHA: f7b171befa6e86988928b9db69197749835b24e3

Checks will be approved automatically on success.

@louis-johnston-db
louis-johnston-db merged commit 5fc60f8 into main Nov 19, 2026
8 of 9 checks passed
@github-actions github-actions Bot mentioned this pull request Nov 20, 2026
abdelrahmanomar1515 added a commit that referenced this pull request Nov 20, 2026
## packages/databricks-vscode
##  (2026-11-20)

* Handle GitHub Copilot detected only through VS Code's copilot shim
(#2295)
([5e677a5](5e677a5)),
closes
[#2295](#2295)
* Invite signed-in users to try the version 3 pre-release, once (#2331)
([5fc60f8](5fc60f8)),
closes
[#2331](#2331)
* Update Databricks CLI to v1.27.0 (#2333)
([286b4e9](286b4e9)),
closes
[#2333](#2333)



## packages/databricks-vscode-types
##  (2026-11-20)

---------

Co-authored-by: releasebot <noreply@github.com>
Co-authored-by: Abdurrahman Abdulaziz <abdelrahman_omar_1515@yahoo.com>

This branch was successfully deployed

1 active deployment
test-trigger-is — f7b171be Deployed Nov 19, 2026 by louis-johnston-db via Trigger Tests #2582
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants