Extender retry

[jace-roell]

Proposed changes

FileSystem calls allow users to correct invalid credentials and continue with the function call.

1. This enables a retry functionality for FileSystem calls and will reprompt users indefinitely until a prompt is cancelled or valid credentials are entered.
2. Extension activation will no longer await virtual workspace fetching
3. Fixes race conditions with authentication for parallel FS calls.
   - FS calls will run in sequence until valid authentication is provided, then FS calls for that profile will be released to run in parallel
4. Fixes duplicate prompting on SSO login/logout when multiple virtual workspaces are open.

Steps to Test:

1. Install the .vsix linked to this PR

2. Clone the vscode-extension-samples repo

3. cd into helloworld-sample

4. Navigate to helloworld-sample/src/extension.ts

5. Place this sample script into extension.ts

import * as vscode from 'vscode';

export function activate(context: vscode.ExtensionContext) {
	// Place an existing profile name with invalid credentials (recommended invalid user to avoid lockout)
	const profile = 'zosmf';
	async function testDS(): Promise<void> {
                 // Ensure is PDS
		const dsn = 'ZOWEUSER.TEST.FILE';

		try {
			const statResult = await vscode.workspace.fs.stat(
				vscode.Uri.parse(`zowe-ds:/${profile}/${dsn}?fetch=true`)
			);
			console.info(`stat success ${JSON.stringify(statResult)}`);
		} catch (err) {
			console.error(`stat error ${JSON.stringify(err)}`);
		}

		try {
			const readResult = await vscode.workspace.fs.readDirectory(
				vscode.Uri.parse(`zowe-ds:/${profile}/${dsn}`)
			);
			console.info(`read success ${JSON.stringify(readResult)}`);
		} catch (err) {
			console.error(`read error ${JSON.stringify(err)}`);
		}
	}
	async function testUSS(): Promise<void> {
		const ussFile = 'u/users/zoweuser/testDir';

		try {
			const statResult = await vscode.workspace.fs.stat(
				vscode.Uri.parse(`zowe-uss:/${profile}/${ussFile}?fetch=true`)
			);
			console.info(`stat success ${JSON.stringify(statResult)}`);
		} catch (err) {
			console.error(`stat error ${JSON.stringify(err)}`);
		}

		try {
			const readResult = await vscode.workspace.fs.readDirectory(
				vscode.Uri.parse(`zowe-uss:/${profile}/${ussFile}`)
			);
			console.info(`read success ${JSON.stringify(readResult)}`);
		} catch (err) {
			console.error(`read error ${JSON.stringify(err)}`);
		}
	}

	async function testJobs(): Promise<void> {
		const joburi = 'TSU01234';
		try {
			const statResult = await vscode.workspace.fs.stat(
				vscode.Uri.parse(`zowe-jobs:/${profile}/${joburi}`)
			);
			console.info(`stat success ${JSON.stringify(statResult)}`);
		} catch (err) {
			console.error(`stat error ${JSON.stringify(err)}`);
		}

		try {
			const readResult = await vscode.workspace.fs.readDirectory(
				vscode.Uri.parse(`zowe-jobs:/${profile}/${joburi}`)
			);
			console.info(`read success ${JSON.stringify(readResult)}`);
		} catch (err) {
			console.error(`read error ${JSON.stringify(err)}`);
		}
	}
	// Register the command
	const disposable = vscode.commands.registerCommand('extension.helloWorld', async () => {
		await testDS();
		// await testUSS();

		// Jobs does not support remote lookup
		// await testJobs();
	});

	context.subscriptions.push(disposable);
}

// this method is called when your extension is deactivated
export function deactivate() {}

ensure the proper modifications are made in the script for uri and target profile

7. Run npm install

• Ensure the profile in the test script has invalid credentials

8. Run Extension Development Host
   Test Scenarios
   1. Reprompt Loop
      a. Run the "Hello World" command palette command
      b. If invalid credentials are entered, new prompts will appear indefinitely. You can escape this loop at any point by cancelling the request
   2. Valid credentials
      a. Run the "Hello World" command palette command
      b. If valid credentials are entered, the command that invoked the prompt will be properly retried and succeed.
      The previous behavior is that the initial request would fail but the subsequent would pass
   3. Virtual workspaces [Block file system requests until extensions are activated #3880]
      a. Open multiple virtual workspace entries.
      b. Reload vscode
      c. The extension activation will no longer await fetching the virtual workspaces
      Note: virtual workspace fetching now runs in parallel

Resolves #3864

1. Add multiple data sets (ideally 10+) to your virtual workspace via a profile using API ML
2. Log out of SSO and reload vscode
3. Log in via SSO and a duplicate SSO login prompt would transiently appear

Resolves #3858

1. Add multiple data sets (ideally 10+) to your virtual workspace via a profile using API ML
2. Log out of SSO and reload vscode
3. Login then Logout of SSO, it should prompt to update credentials in an infinite loop.

Both scenarios should remove the duplicate authentication prompts

Release Notes

Milestone:

Changelog:

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• Enhancement (non-breaking change which adds or improves functionality)
• Breaking change (a change that would cause existing functionality to not work as expected)
• Documentation (Markdown, README updates)
• Other (please specify above in "Proposed changes" section)

Checklist

General

• I have read the CONTRIBUTOR GUIDANCE wiki
• All PR dependencies have been merged and published (if applicable)
• A GIF or screenshot is included in the PR for visual changes
• The pre-publish command has been executed:
  • v2 and below: yarn workspace vscode-extension-for-zowe vscode:prepublish
  • v3: pnpm --filter vscode-extension-for-zowe vscode:prepublish

Code coverage

• There is coverage for the code that I have added
• I have added new test cases and they are passing
• I have manually tested the changes

Deployment

• I have tested new functionality with the FTP extension and profile verifying no extender profile type breakages introduced
• I have added developer documentation (if applicable)
• Documentation should be added to Zowe Docs
  • If you're an outside contributor, please post in the #zowe-doc Slack channel to coordinate documentation.
  • Otherwise, please check with the rest of the squad about any needed documentation before merging.
• These changes may need ported to the appropriate branches (list here):

Further comments

[github-actions]

Build Details

Name	Information
PR Commit	425f14f
Merge Commit	f5371d3
Size	3.7 MB
Last Updated By	jace-roell
Last Updated	Oct 21, 25, 5:42:49 PM UTC
Expires At	Jan 19, 26, 5:41:02 PM UTC

[codecov]

Codecov Report

❌ Patch coverage is 91.37380% with 27 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.04%. Comparing base (22c38d5) to head (d5ed520).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
...we-explorer/src/trees/dataset/DatasetFSProvider.ts	88.76%	10 Missing ⚠️
...kages/zowe-explorer/src/trees/uss/UssFSProvider.ts	93.05%	5 Missing ⚠️
...ages/zowe-explorer-api/src/profiles/AuthHandler.ts	94.93%	4 Missing ⚠️
packages/zowe-explorer/src/utils/AuthUtils.ts	91.42%	3 Missing ⚠️
...ckages/zowe-explorer/src/configuration/Profiles.ts	60.00%	2 Missing ⚠️
.../zowe-explorer/src/management/ProfileManagement.ts	60.00%	2 Missing ⚠️
...kages/zowe-explorer/src/trees/shared/SharedInit.ts	94.44%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##             main    #3830    +/-   ##
========================================
  Coverage   94.04%   94.04%            
========================================
  Files         129      129            
  Lines       15472    15589   +117     
  Branches     3721     3562   -159     
========================================
+ Hits        14550    14661   +111     
- Misses        920      926     +6     
  Partials        2        2            

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

📅 Suggested merge-by date: 11/3/2025

[zFernand0]

LGTM! 😋

Thanks for implementing retries 🙏

[anaxceron]

Left a comment re: minor edit

[anaxceron]

this is my review comment