Address pr comments

Author: edvilme

api/package-lock.json

@@ -35,7 +35,11 @@
     },
     "devDependencies": {
         "@types/node": "^22.0.0",
+        "@types/semver": "^7.5.8",
         "@types/vscode": "^1.99.0",
         "typescript": "^5.1.3"
+    },
+    "dependencies": {
+        "semver": "^7.6.0"
     }
 }

api/package.json

@@ -1,6 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+import type * as semver from 'semver';
 import {
     Disposable,
     Event,
@@ -691,6 +692,22 @@ export interface PackageManager {
      * @returns A promise that resolves when the cache is cleared.
      */
     clearCache?(): Promise<void>;
+
+    /**
+     * Returns the version of the underlying package management tool (e.g., pip, conda).
+     * @param environment - The Python environment context.
+     * @returns A promise that resolves to a SemVer object, or `undefined` if not available.
+     */
+    getVersion?(environment: PythonEnvironment): Promise<semver.SemVer | undefined>;
+
+    /**
+     * Retrieves the list of available versions for a given package.
+     * @param packageName - The name of the package to look up.
+     * @param environment - The Python environment context for the lookup.
+     * @returns A promise that resolves to an array of version strings (newest first),
+     *          or `undefined` if this manager does not support version listing.
+     */
+    getAvailableVersions?(packageName: string, environment: PythonEnvironment): Promise<string[] | undefined>;
 }
 
 /**
@@ -1059,12 +1076,33 @@ export interface PythonPackageManagementApi {
     managePackages(environment: PythonEnvironment, options: PackageManagementOptions): Promise<void>;
 }
 
+export interface PythonPackageVersionApi {
+    /**
+     * Get the version of the package manager tool associated with the given environment.
+     *
+     * @param environment The Python Environment whose package manager version is requested.
+     * @returns The SemVer version of the package manager tool, or `undefined` if not available.
+     */
+    getPackageManagerVersion(environment: PythonEnvironment): Promise<semver.SemVer | undefined>;
+
+    /**
+     * Get the list of available versions for a package from the package manager
+     * associated with the given environment.
+     *
+     * @param packageName The name of the package.
+     * @param environment The Python Environment context for the lookup.
+     * @returns An array of version strings (newest first), or `undefined` if not supported.
+     */
+    getAvailableVersions(packageName: string, environment: PythonEnvironment): Promise<string[] | undefined>;
+}
+
 export interface PythonPackageManagerApi
     extends
         PythonPackageManagerRegistrationApi,
         PythonPackageGetterApi,
         PythonPackageManagementApi,
-        PythonPackageItemApi {}
+        PythonPackageItemApi,
+        PythonPackageVersionApi {}
 
 export interface PythonProjectCreationApi {
     /**

api/src/main.ts

@@ -338,7 +338,7 @@ export async function handlePackageVersionManagement(context: unknown, em: Envir
         if (availableVersions && availableVersions.length > 0) {
             const items = availableVersions.map((v) => ({
                 label: v,
-                description: v === pkg.version ? '$(check)' : undefined,
+                description: v === pkg.version ? `$(check) ${l10n.t('Installed')}` : undefined,
             }));
 
             const selected = await showQuickPick(items, {

src/features/envCommands.ts

@@ -20,7 +20,7 @@ import {
     PythonEnvironment,
     PythonEnvironmentApi,
 } from '../../api';
-import { runPython, runUV, shouldUseUv } from './helpers';
+import { runProcessCaptureAll, runPython, runUV, shouldUseUv } from './helpers';
 import { getWorkspacePackagesToInstall } from './pipUtils';
 import { managePackages, refreshPackages } from './utils';
 import { VenvManager } from './venvManager';
@@ -188,13 +188,12 @@ export class PipPackageManager implements PackageManager, Disposable {
 
             // pip <= 20.3.4 - use `pip install <package>==__invalid__` to get available versions from error message.
             if (pipVersion && semver.lte(pipVersion, '20.3.4')) {
-                const output = await runPython(
+                const result = await runProcessCaptureAll(
                     python,
                     ['-m', 'pip', 'install', `${packageName}==__invalid__`],
-                    undefined,
                     this.log,
                 );
-                return parsePipInstallVersions(output);
+                return parsePipInstallVersions(result.stdout + result.stderr);
             }
         } catch {
             return undefined;