fix(amazonq): skip activation if old Toolkit is detected; Q gain focus at first use aws#4711

Problem
Q is not compatible with old toolkit.

Solution
- Prevent Q activation if detected old aws toolkit from the marketplace.
- It will not prevent Q activation if detected toolkit with a dev version.
- Auto installs new toolkit from marketplace and then prompt user to reload.
- Let Q gain focus at first activation.

Author: leigaol

packages/amazonq/src/extensionShared.ts

@@ -4,6 +4,7 @@
  */
 
 import * as vscode from 'vscode'
+import * as semver from 'semver'
 import { join } from 'path'
 import {
     CodeSuggestionsState,
@@ -24,7 +25,7 @@ import {
     globals,
     RegionProvider,
 } from 'aws-core-vscode/shared'
-import { initializeAuth, CredentialsStore, LoginManager } from 'aws-core-vscode/auth'
+import { initializeAuth, CredentialsStore, LoginManager, ExtensionUse } from 'aws-core-vscode/auth'
 import { makeEndpointsProvider, registerCommands } from 'aws-core-vscode'
 import { activate as activateCWChat } from 'aws-core-vscode/amazonq'
 import { activate as activateQGumby } from 'aws-core-vscode/amazonqGumby'
@@ -36,6 +37,32 @@ export async function activateShared(context: vscode.ExtensionContext) {
     const contextPrefix = 'amazonq'
     globals.contextPrefix = 'amazonq.' //todo: disconnect from above line
 
+    // Avoid activation if older toolkit is installed
+    // Amazon Q is only compatible with AWS Toolkit >= 3.0.0
+    // Or AWS Toolkit with a development version. Example: 2.19.0-3413gv
+    const toolkit = vscode.extensions.getExtension(VSCODE_EXTENSION_ID.awstoolkit)
+    if (toolkit) {
+        const toolkitVersion = semver.coerce(toolkit.packageJSON.version)
+        const isDevVersion = toolkit.packageJSON.version.toString().includes('-')
+        if (toolkitVersion && toolkitVersion.major < 3 && !isDevVersion) {
+            await vscode.commands
+                .executeCommand('workbench.extensions.installExtension', VSCODE_EXTENSION_ID.awstoolkit)
+                .then(
+                    void vscode.window
+                        .showInformationMessage(
+                            `The Amazon Q extension is incompatible with AWS Toolkit versions 2.9 and below. Your AWS Toolkit was updated to version 3.0 or later.`,
+                            'Reload Now'
+                        )
+                        .then(async resp => {
+                            if (resp === 'Reload Now') {
+                                await vscode.commands.executeCommand('workbench.action.reloadWindow')
+                            }
+                        })
+                )
+            return
+        }
+    }
+
     await initializeComputeRegion()
     initialize(context)
     const extContext = {
@@ -93,6 +120,10 @@ export async function activateShared(context: vscode.ExtensionContext) {
 
     // enable auto suggestions on activation
     await CodeSuggestionsState.instance.setSuggestionsEnabled(true)
+
+    if (ExtensionUse.instance.isFirstUse()) {
+        await vscode.commands.executeCommand('workbench.view.extension.amazonq')
+    }
 }
 
 export async function deactivateShared() {

packages/core/src/auth/index.ts

@@ -14,3 +14,4 @@ export { Connection, AwsConnection } from './connection'
 export { Auth } from './auth'
 export { CredentialsStore } from './credentials/store'
 export { LoginManager } from './deprecated/loginManager'
+export { ExtensionUse } from './utils'

packages/core/src/codewhisperer/activation.ts

@@ -45,7 +45,7 @@ import { sleep } from '../shared/utilities/timeoutUtils'
 import { ReferenceLogViewProvider } from './service/referenceLogViewProvider'
 import { ReferenceHoverProvider } from './service/referenceHoverProvider'
 import { ReferenceInlineProvider } from './service/referenceInlineProvider'
-import { SecurityPanelViewProvider } from './views/securityPanelViewProvider'
+import { SecurityPanelViewProvider, openEditorAtRange } from './views/securityPanelViewProvider'
 import { disposeSecurityDiagnostic } from './service/diagnosticsProvider'
 import { RecommendationHandler } from './service/recommendationHandler'
 import { Commands, registerCommandsWithVSCode } from '../shared/vscode/commands2'
@@ -266,7 +266,8 @@ export async function activate(context: ExtContext): Promise<void> {
         vscode.languages.registerCodeActionsProvider(
             [...CodeWhispererConstants.platformLanguageIds],
             SecurityIssueCodeActionProvider.instance
-        )
+        ),
+        vscode.commands.registerCommand('aws.amazonq.openEditorAtRange', openEditorAtRange)
     )
 
     await auth.restore()

packages/core/src/codewhisperer/views/securityPanelViewProvider.ts

@@ -11,16 +11,14 @@ function makeUri(...args: Parameters<typeof openEditorAtRange>): vscode.Uri {
     return vscode.Uri.parse(`command:aws.amazonq.openEditorAtRange?${encodeURIComponent(JSON.stringify(args))}`)
 }
 
-async function openEditorAtRange(path: string, startLine: number, endLine: number) {
+export async function openEditorAtRange(path: string, startLine: number, endLine: number) {
     const uri = vscode.Uri.parse(path)
     await vscode.window.showTextDocument(uri, { preview: false, preserveFocus: true }).then(e => {
         e.selection = new vscode.Selection(startLine, 0, endLine, 0)
         e.revealRange(new vscode.Range(startLine, 0, endLine, 0), vscode.TextEditorRevealType.InCenterIfOutsideViewport)
     })
 }
 
-vscode.commands.registerCommand('aws.amazonq.openEditorAtRange', openEditorAtRange)
-
 export class SecurityPanelViewProvider implements vscode.WebviewViewProvider {
     public static readonly viewType = 'aws.codeWhisperer.securityPanel'
     private view?: vscode.WebviewView