Update PET command to include submenu for find and resolve operations (#702)

This PR updates the "Python: Run Python Environment Tool (PET) in
Terminal" command to provide a better user experience by adding a
submenu that allows users to choose between different PET operations.

## Changes

### Before
The command would directly run the PET executable without any options,
requiring users to manually add arguments in the terminal.

### After
The command now presents a QuickPick menu with two options:

1. **Find All Environments** - Runs `pet find --verbose` to discover and
list all Python environments
2. **Resolve Environment...** - Prompts for a Python executable path,
then runs `pet resolve <path>` to get detailed environment information

## User Experience Flow

1. User runs "Python: Run Python Environment Tool (PET) in Terminal..."
2. A menu appears with clear descriptions of each operation:
- "Find All Environments": Finds all environments and reports them to
standard output
- "Resolve Environment...": Resolves & reports details of a specific
environment
3. For "Find All Environments": Terminal opens and immediately runs the
find command
4. For "Resolve Environment...": User enters a path to a Python
executable, then the resolve command runs
5. All interactions support cancellation and include proper error
handling

## Technical Details

- Updated command title to include ellipsis ("...") to indicate
additional user interaction
- Implemented using VS Code's native QuickPick and InputBox APIs
- Added input validation for the resolve path option
- Maintained existing terminal creation and error handling patterns
- All existing functionality preserved with no breaking changes

The implementation follows the existing codebase patterns and includes
comprehensive error handling for a smooth user experience.

Fixes #701.

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/microsoft/vscode-python-environments/issues/new?title=✨Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eleanorjboyd <26030610+eleanorjboyd@users.noreply.github.com>

Author: Copilot

package.nls.json

@@ -36,5 +36,5 @@
     "python-envs.terminal.deactivate.title": "Deactivate Environment in Current Terminal",
     "python-envs.uninstallPackage.title": "Uninstall Package",
     "python-envs.revealProjectInExplorer.title": "Reveal Project in Explorer",
-    "python-envs.runPetInTerminal.title": "Run Python Environment Tool (PET) in Terminal"
+    "python-envs.runPetInTerminal.title": "Run Python Environment Tool (PET) in Terminal..."
 }

src/extension.ts

@@ -9,6 +9,7 @@ import { EventNames } from './common/telemetry/constants';
 import { sendManagerSelectionTelemetry } from './common/telemetry/helpers';
 import { sendTelemetryEvent } from './common/telemetry/sender';
 import { createDeferred } from './common/utils/deferred';
+import { isWindows } from './common/utils/platformUtils';
 import {
     activeTerminal,
     createLogOutputChannel,
@@ -57,8 +58,8 @@ import {
 import { ShellStartupActivationVariablesManagerImpl } from './features/terminal/shellStartupActivationVariablesManager';
 import { cleanupStartupScripts } from './features/terminal/shellStartupSetupHandlers';
 import { TerminalActivationImpl } from './features/terminal/terminalActivationState';
-import { TerminalManager, TerminalManagerImpl } from './features/terminal/terminalManager';
 import { TerminalEnvVarInjector } from './features/terminal/terminalEnvVarInjector';
+import { TerminalManager, TerminalManagerImpl } from './features/terminal/terminalManager';
 import { getAutoActivationType, getEnvironmentForTerminal } from './features/terminal/utils';
 import { EnvManagerView } from './features/views/envManagersView';
 import { ProjectView } from './features/views/projectView';
@@ -241,10 +242,7 @@ export async function activate(context: ExtensionContext): Promise<PythonEnviron
     );
 
     // Initialize terminal environment variable injection
-    const terminalEnvVarInjector = new TerminalEnvVarInjector(
-        context.environmentVariableCollection,
-        envVarManager,
-    );
+    const terminalEnvVarInjector = new TerminalEnvVarInjector(context.environmentVariableCollection, envVarManager);
     context.subscriptions.push(terminalEnvVarInjector);
 
     context.subscriptions.push(
@@ -450,12 +448,63 @@ export async function activate(context: ExtensionContext): Promise<PythonEnviron
         commands.registerCommand('python-envs.runPetInTerminal', async () => {
             try {
                 const petPath = await getNativePythonToolsPath();
+
+                // Show quick pick menu for PET operation selection
+                const selectedOption = await window.showQuickPick(
+                    [
+                        {
+                            label: 'Find All Environments',
+                            description: 'Finds all environments and reports them to the standard output',
+                            detail: 'Runs: pet find --verbose',
+                        },
+                        {
+                            label: 'Resolve Environment...',
+                            description: 'Resolves & reports the details of the environment to the standard output',
+                            detail: 'Runs: pet resolve <path>',
+                        },
+                    ],
+                    {
+                        placeHolder: 'Select a Python Environment Tool (PET) operation',
+                        ignoreFocusOut: true,
+                    },
+                );
+
+                if (!selectedOption) {
+                    return; // User cancelled
+                }
+
                 const terminal = createTerminal({
                     name: 'Python Environment Tool (PET)',
                 });
                 terminal.show();
-                terminal.sendText(`"${petPath}"`, true);
-                traceInfo(`Running PET in terminal: ${petPath}`);
+
+                if (selectedOption.label === 'Find All Environments') {
+                    // Run pet find --verbose
+                    terminal.sendText(`"${petPath}" find --verbose`, true);
+                    traceInfo(`Running PET find command: ${petPath} find --verbose`);
+                } else if (selectedOption.label === 'Resolve Environment...') {
+                    // Show input box for path
+                    const placeholder = isWindows() ? 'C:\\path\\to\\python\\executable' : '/path/to/python/executable';
+                    const inputPath = await window.showInputBox({
+                        prompt: 'Enter the path to the Python executable to resolve',
+                        placeHolder: placeholder,
+                        ignoreFocusOut: true,
+                        validateInput: (value) => {
+                            if (!value || value.trim().length === 0) {
+                                return 'Please enter a valid path';
+                            }
+                            return null;
+                        },
+                    });
+
+                    if (!inputPath) {
+                        return; // User cancelled
+                    }
+
+                    // Run pet resolve with the provided path
+                    terminal.sendText(`"${petPath}" resolve "${inputPath.trim()}"`, true);
+                    traceInfo(`Running PET resolve command: ${petPath} resolve "${inputPath.trim()}"`);
+                }
             } catch (error) {
                 traceError('Error running PET in terminal', error);
                 window.showErrorMessage(`Failed to run Python Environment Tool: ${error}`);