editor: show session homes in breadcrumbs (#333404)

editor: use session homes in breadcrumbs

Add URI home formatting so internal agent session paths render with stable provider labels instead of exposing session IDs. Register homes for Agent Host and Copilot CLI sessions, including resumed SDK artifact paths and pending Quick Chats.\n\nFixes #330410\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: sandy081

src/vs/editor/standalone/browser/standaloneServices.ts

@@ -982,6 +982,10 @@ class StandaloneUriLabelService implements ILabelService {
 		throw new Error('Not implemented');
 	}
 
+	public getUriHome(): undefined {
+		return undefined;
+	}
+
 	public registerCachedFormatter(formatter: ResourceLabelFormatter): IDisposable {
 		return this.registerFormatter(formatter);
 	}

src/vs/platform/agentHost/common/workspacelessScratchDir.ts

@@ -0,0 +1,11 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { joinPath } from '../../../base/common/resources.js';
+import { URI } from '../../../base/common/uri.js';
+
+export function workspacelessScratchDir(userHome: URI, sessionId: string): URI {
+	return joinPath(userHome, '.copilot', 'chats', sessionId);
+}

src/vs/platform/agentHost/node/copilot/copilotAgent.ts

@@ -31,7 +31,7 @@ import { IInstantiationService } from '../../../instantiation/common/instantiati
 import { ILogService, LogLevel } from '../../../log/common/log.js';
 import { ITelemetryService } from '../../../telemetry/common/telemetry.js';
 import { INativeEnvironmentService } from '../../../../platform/environment/common/environment.js';
-import { workspacelessScratchDir } from '../workspacelessScratchDir.js';
+import { workspacelessScratchDir } from '../../common/workspacelessScratchDir.js';
 import { IAgentHostCheckpointService } from '../../common/agentHostCheckpointService.js';
 import type { IAgentHostClientTelemetryContext } from '../../common/agentHostTelemetry.js';
 import { IAgentHostReviewService } from '../../common/agentHostReviewService.js';

src/vs/platform/agentHost/node/workspacelessScratchDir.ts

@@ -4,19 +4,15 @@
  *--------------------------------------------------------------------------------------------*/
 
 import * as fs from 'fs/promises';
-import { joinPath } from '../../../base/common/resources.js';
 import { URI } from '../../../base/common/uri.js';
+import { workspacelessScratchDir } from '../common/workspacelessScratchDir.js';
 
 /**
  * Stable, deterministic per-session scratch directory for a workspace-less
  * (workspace-less chat) session: `<userHome>/.copilot/chats/<sessionId>`. Shared by the
  * Copilot and Claude agents so both resolve the same cwd for a session that was
  * created with no `workingDirectory`.
  */
-export function workspacelessScratchDir(userHome: URI, sessionId: string): URI {
-	return joinPath(userHome, '.copilot', 'chats', sessionId);
-}
-
 /** Ensures the workspace-less scratch dir exists (mkdir -p), returning it. */
 export async function ensureWorkspacelessScratchDir(userHome: URI, sessionId: string): Promise<URI> {
 	const dir = workspacelessScratchDir(userHome, sessionId);

src/vs/platform/label/common/label.ts

@@ -28,6 +28,8 @@ export interface ILabelService {
 	getHostLabel(scheme: string, authority?: string): string;
 	getHostTooltip(scheme: string, authority?: string): string | undefined;
 	getSeparator(scheme: string, authority?: string): '/' | '\\';
+	/** Returns the display home containing `resource`. */
+	getUriHome(resource: URI): URI | undefined;
 
 	registerFormatter(formatter: ResourceLabelFormatter): IDisposable;
 	readonly onDidChangeFormatters: Event<IFormatterChangeEvent>;
@@ -53,6 +55,8 @@ export interface IFormatterChangeEvent {
 export interface ResourceLabelFormatter {
 	scheme: string;
 	authority?: string;
+	/** URI path used as a display home. Runtime registrations only. */
+	home?: string;
 	priority?: boolean;
 	formatting: ResourceLabelFormatting;
 }

src/vs/sessions/LAYOUT.md

@@ -76,6 +76,8 @@ The durable state and transition catalog lives in [SINGLE_PANE_SCENARIOS.md](SIN
 
 Editors must be opened through `IEditorService`. Sessions-specific presentation must not bypass editor service behavior by opening directly on an editor group.
 
+Session providers register internal per-session directories as resource label homes. URI labels render as `<home label>/<relative path>`, and breadcrumbs render the same home label as their root segment. Without a matching home formatter, existing URI-label and breadcrumb behavior is unchanged.
+
 ## Custom views
 
 `ICustomViewService` owns the active contributed full-surface view.

src/vs/sessions/contrib/providers/agentHost/browser/baseAgentHostSessionsProvider.ts

@@ -2536,8 +2536,9 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 
 	protected readonly _onDidChangeSessions = this._register(new Emitter<ISessionChangeEvent>());
 	private readonly _onDidChangeSessionsFromNotifications = this._register(new Emitter<ISessionChangeEvent>());
-	private readonly _onDidChangeSessionsImmediately = Event.any(this._onDidChangeSessions.event, this._onDidChangeSessionsFromNotifications.event);
+	protected readonly _onDidChangeSessionsImmediately = Event.any(this._onDidChangeSessions.event, this._onDidChangeSessionsFromNotifications.event);
 	readonly onDidChangeSessions = debounceSessionChangeEvents(this._onDidChangeSessionsFromNotifications.event, this._onDidChangeSessions.event, this._store);
+	protected readonly _onDidChangeDraftSessions = this._register(new Emitter<void>());
 
 	protected readonly _onDidReplaceSession = this._register(new Emitter<{ readonly from: ISession; readonly to: ISession }>());
 	readonly onDidReplaceSession: Event<{ readonly from: ISession; readonly to: ISession }> = this._onDidReplaceSession.event;
@@ -2668,11 +2669,13 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 	 */
 	protected _disposeAllNewSessions(): void {
 		this._newSessions.clearAndDisposeAll();
+		this._onDidChangeDraftSessions.fire();
 	}
 
 	deleteNewSession(sessionId: string): void {
 		if (this._newSessions.has(sessionId)) {
 			this._newSessions.deleteAndDispose(sessionId);
+			this._onDidChangeDraftSessions.fire();
 		}
 	}
 
@@ -3135,6 +3138,37 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 		return sessions;
 	}
 
+	getResourceLabelHomes(): { readonly uri: URI; readonly label: string }[] {
+		const homes: { readonly uri: URI; readonly label: string }[] = [];
+		for (const session of this.getKnownSessions()) {
+			if (session.isQuickChat?.get()) {
+				const adapter = session instanceof AgentHostSessionAdapter ? session : undefined;
+				const label = this.getResourceLabelHomeLabel(session);
+				homes.push(...(adapter?.workingDirectories ?? []).map(uri => ({ uri, label })));
+			}
+		}
+		return homes;
+	}
+
+	protected getResourceLabelHomeLabel(session: ISession): string {
+		const providerLabel = this.sessionTypes.find(type => type.id === session.sessionType)?.label ?? session.sessionType;
+		return `${providerLabel}/${localize('sessionHome', "Session")}`;
+	}
+
+	protected getKnownSessions(): ISession[] {
+		const sessions = new Map<string, ISession>();
+		for (const session of this._sessionCache.values()) {
+			sessions.set(session.resource.toString(), session);
+		}
+		for (const newSession of this._newSessions.values()) {
+			sessions.set(newSession.session.resource.toString(), newSession.session);
+		}
+		if (this._pendingSession) {
+			sessions.set(this._pendingSession.resource.toString(), this._pendingSession);
+		}
+		return [...sessions.values()];
+	}
+
 	getSessionByResource(resource: URI): ISession | undefined {
 		for (const newSession of this._newSessions.values()) {
 			if (newSession.session.resource.toString() === resource.toString()) {
@@ -3258,6 +3292,7 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 			throw err;
 		}
 		this._newSessions.set(newSession.sessionId, newSession);
+		this._onDidChangeDraftSessions.fire();
 		newSession.observeClientCustomAgents(activeClientScope.customAgents, () => {
 			this._onDidChangeCustomAgents.fire();
 			this._onDidChangeCustomizations.fire();
@@ -3787,6 +3822,7 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 	clearSessionConfig(sessionId: string): void {
 		if (this._newSessions.has(sessionId)) {
 			this._newSessions.deleteAndDispose(sessionId);
+			this._onDidChangeDraftSessions.fire();
 		}
 	}
 
@@ -4723,6 +4759,7 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 				newSession.graduate();
 				if (this._newSessions.get(newSession.sessionId) === newSession) {
 					this._newSessions.deleteAndDispose(newSession.sessionId);
+					this._onDidChangeDraftSessions.fire();
 				}
 				// Clear the pending session before firing the replace event so
 				// that any synchronous listener calling getSessions() sees only
@@ -4753,6 +4790,7 @@ export abstract class BaseAgentHostSessionsProvider extends Disposable implement
 		newSession.graduate();
 		if (this._newSessions.get(newSession.sessionId) === newSession) {
 			this._newSessions.deleteAndDispose(newSession.sessionId);
+			this._onDidChangeDraftSessions.fire();
 		}
 		this._onDidChangeSessions.fire({ added: [], removed: [skeleton], changed: [] });
 		throw new Error(localize('sessionNotCommitted', "Agent host session was not committed."));

src/vs/sessions/contrib/providers/agentHost/browser/localAgentHostSessionsProvider.ts

@@ -12,13 +12,14 @@ import { DisposableStore, IDisposable } from '../../../../../base/common/lifecyc
 import { ResourceSet } from '../../../../../base/common/map.js';
 import { Schemas } from '../../../../../base/common/network.js';
 import { autorun, constObservable, IObservable } from '../../../../../base/common/observable.js';
-import { basename, dirname, isEqualOrParent, relativePath } from '../../../../../base/common/resources.js';
+import { basename, dirname, isEqualOrParent, joinPath, relativePath } from '../../../../../base/common/resources.js';
 import { ThemeIcon } from '../../../../../base/common/themables.js';
 import { URI } from '../../../../../base/common/uri.js';
 import { localize } from '../../../../../nls.js';
 import { type AgentHostUriMapper, LOCAL_AGENT_HOST_AUTHORITY, toAgentHostContentUri, toAgentHostUri } from '../../../../../platform/agentHost/common/agentHostUri.js';
-import { type IAgentSessionMetadata } from '../../../../../platform/agentHost/common/agent.js';
+import { AgentSession, type IAgentSessionMetadata } from '../../../../../platform/agentHost/common/agent.js';
 import { affectsAgentHostProviderPreference, IAgentConnection, IAgentHostService, shouldSurfaceLocalAgentHostProvider } from '../../../../../platform/agentHost/common/agentService.js';
+import { workspacelessScratchDir } from '../../../../../platform/agentHost/common/workspacelessScratchDir.js';
 import type { AgentCustomization, ISessionGitState } from '../../../../../platform/agentHost/common/state/sessionState.js';
 import { IConfigurationService } from '../../../../../platform/configuration/common/configuration.js';
 import { IInstantiationService } from '../../../../../platform/instantiation/common/instantiation.js';
@@ -34,13 +35,15 @@ import { IPreparedNewSession, ISessionsProviderAutomations, type ISessionsProvid
 import { WorkspaceNotTrustedError } from '../../../../services/sessions/common/sessionsManagement.js';
 import { IAgentHostActiveClientService } from '../../../../../workbench/contrib/chat/browser/agentSessions/agentHost/agentHostActiveClientService.js';
 import { IChatWidgetService } from '../../../../../workbench/contrib/chat/browser/chat.js';
-import { getCopilotCliSessionRawId, migratedCopilotCliResource } from '../../../../../workbench/contrib/chat/browser/copilotCliEventsUri.js';
+import { buildLocalSessionStateUri, getCopilotCliSessionRawId, migratedCopilotCliResource } from '../../../../../workbench/contrib/chat/browser/copilotCliEventsUri.js';
 import { adoptLegacyCopilotCliResource, isLegacyMigrationEnabledAtStartup, LEGACY_MIGRATION_RESTORE_TIMEOUT_MS, LEGACY_MIGRATION_TIMEOUT_MS } from '../../../../../workbench/contrib/chat/browser/agentSessions/agentHost/agentHostLegacyMigration.js';
 import { IChatService } from '../../../../../workbench/contrib/chat/common/chatService/chatService.js';
 import { IChatSessionsService } from '../../../../../workbench/contrib/chat/common/chatSessionsService.js';
 import { ILanguageModelsService, type ILanguageModelChatMetadata } from '../../../../../workbench/contrib/chat/common/languageModels.js';
 import { IWorkbenchEnvironmentService } from '../../../../../workbench/services/environment/common/environmentService.js';
 import { isAgentHostProvider, LOCAL_AGENT_HOST_PROVIDER_ID, type IAgentHostSessionsProvider } from '../../../../common/agentHostSessionsProvider.js';
+import { IPathService } from '../../../../../workbench/services/path/common/pathService.js';
+import { ResourceLabelHomeStore } from '../../../../../workbench/services/label/common/resourceLabelHomeStore.js';
 import { buildAgentHostSessionWorkspace, readBranchProtectionPatterns } from '../../../../common/agentHostSessionWorkspace.js';
 import { IDevContainerAgentHostService } from '../../../../common/devContainerAgentHostService.js';
 import { ChatModelSource, IGitHubInfo, ISession, ISessionWorkspace, ISessionWorkspaceBrowseAction, SESSION_WORKSPACE_GROUP_LOCAL } from '../../../../services/sessions/common/session.js';
@@ -118,6 +121,7 @@ export class LocalAgentHostSessionsProvider extends BaseAgentHostSessionsProvide
 	private _automationSessionResources = new ResourceSet();
 	private readonly _devContainerAvailableDrafts = new Set<string>();
 	private readonly _devContainerDrafts = new Set<string>();
+	private readonly _resourceLabelHomes: ResourceLabelHomeStore;
 
 	override get order(): number {
 		return -1;
@@ -172,8 +176,10 @@ export class LocalAgentHostSessionsProvider extends BaseAgentHostSessionsProvide
 		@IWorkspaceTrustRequestService private readonly _workspaceTrustRequestService: IWorkspaceTrustRequestService,
 		@IDevContainerAgentHostService private readonly _devContainerAgentHostService: IDevContainerAgentHostService,
 		@ISessionsProvidersService private readonly _sessionsProvidersService: ISessionsProvidersService,
+		@IPathService pathService: IPathService,
 	) {
 		super(chatSessionsService, chatService, chatWidgetService, languageModelsService, _configurationService, logService, gitHubService, instantiationService, sessionsService, activeClientService, storageService, dialogService, workspaceTrustManagementService);
+		this._resourceLabelHomes = this._register(instantiationService.createInstance(ResourceLabelHomeStore));
 		const legacyAutomations = this._register(instantiationService.createInstance(AutomationStore, providerAutomationStorageKey(this.id)));
 		const automations = this._register(instantiationService.createInstance(ReconnectableAgentHostAutomationStore, this.id, legacyAutomations, {
 			toHost: resource => resource,
@@ -194,6 +200,35 @@ export class LocalAgentHostSessionsProvider extends BaseAgentHostSessionsProvide
 		// started and the first `listSessions()` round-trip (gated on
 		// authentication settling below) reconciles them.
 		this._enableSessionCachePersistence(LOCAL_AGENT_HOST_CACHED_SESSIONS_STORAGE_KEY, LOCAL_AGENT_HOST_CACHED_SESSIONS_STORAGE_KEY_LEGACY);
+
+		const updateResourceLabelHomes = () => {
+			const homes = this.getResourceLabelHomes();
+			const userHome = pathService.userHome({ preferLocal: true });
+			const sessionStateRoot = buildLocalSessionStateUri(userHome);
+			for (const session of this.getKnownSessions()) {
+				const rawId = AgentSession.id(session.resource);
+				const label = this.getResourceLabelHomeLabel(session);
+				if (session.isQuickChat?.get() && (session.sessionType === 'copilotcli' || session.sessionType === 'claude')) {
+					homes.push({ uri: workspacelessScratchDir(userHome, rawId), label });
+				}
+				if (session.sessionType === 'copilotcli') {
+					homes.push({ uri: joinPath(sessionStateRoot, rawId), label });
+					for (const artifact of session.artifacts?.get() ?? []) {
+						if (!artifact.uri || !isEqualOrParent(artifact.uri, sessionStateRoot)) {
+							continue;
+						}
+						const artifactSessionId = relativePath(sessionStateRoot, artifact.uri)?.split('/')[0];
+						if (artifactSessionId) {
+							homes.push({ uri: joinPath(sessionStateRoot, artifactSessionId), label });
+						}
+					}
+				}
+			}
+			this._resourceLabelHomes.set(homes);
+		};
+		this._register(this._onDidChangeSessionsImmediately(updateResourceLabelHomes));
+		this._register(this._onDidChangeDraftSessions.event(updateResourceLabelHomes));
+		updateResourceLabelHomes();
 		this._register(autorun(reader => {
 			this._automationSessionResources = new ResourceSet(this.automations.runs.read(reader).flatMap(run => run.sessionResource ? [run.sessionResource] : []));
 			const changed = this.syncAutomationSessionMarkers(this._sessionCache.values());