@codingame/monaco-vscode-workbench-service-override 37.3.3 → 37.3.4

package/vscode/src/vs/sessions/contrib/terminal/browser/sessionsTerminalContribution.d.ts

@@ -0,0 +1,120 @@
+import { Disposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
+import { IFileService } from "@codingame/monaco-vscode-api/vscode/vs/platform/files/common/files.service";
+import { ILogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/log/common/log.service";
+import { IWorkbenchContribution } from "@codingame/monaco-vscode-api/vscode/vs/workbench/common/contributions";
+import { IAgentHostTerminalService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/browser/agentHostTerminalService.service";
+import { ITerminalInstance } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/browser/terminal";
+import { ITerminalService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/browser/terminal.service";
+import { IPathService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/path/common/pathService.service";
+import { ISessionsManagementService } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/common/sessionsManagement.service";
+import { ISessionsService } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/browser/sessionsService.service";
+import { ISession } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/common/session";
+import { ISessionsProvidersService } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/browser/sessionsProvidersService.service";
+import { ITerminalProfileService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/common/terminal.service";
+/**
+ * Manages terminal instances in the sessions window, ensuring:
+ * - A terminal exists for the active session's worktree (or repository if no worktree).
+ * - Terminals are tracked per session id and shown/hidden based on that association.
+ * - Terminals created before session-id tracking fall back to initial cwd matching
+ *   until they are associated with a session in this window.
+ * - Terminals for archived/removed sessions are closed using their tracked
+ *   session id association.
+ */
+export declare class SessionsTerminalContribution extends Disposable implements IWorkbenchContribution {
+    private readonly _sessionsManagementService;
+    private readonly _sessionsService;
+    private readonly _sessionsProvidersService;
+    private readonly _terminalService;
+    private readonly _agentHostTerminalService;
+    private readonly _logService;
+    private readonly _pathService;
+    private readonly _fileService;
+    private readonly _terminalProfileService;
+    static readonly ID = "workbench.contrib.sessionsTerminal";
+    private _activeKey;
+    private _activeSessionId;
+    private readonly _sessionTerminals;
+    private readonly _standaloneTerminalIds;
+    /** In-flight terminal work for drafts, retained only until each operation settles. */
+    private readonly _pendingTerminalOperations;
+    private readonly _sessionTerminalGenerations;
+    /**
+     * Session ids already processed as archived. The archive cleanup runs only
+     * on the not-archived → archived transition: the provider keeps archived
+     * sessions cached and re-emits them in `changed` on every sync, so acting on
+     * the current archived state would re-run the cwd cleanup each time and sweep
+     * terminals the user opened afterwards. See #313510, #318645.
+     */
+    private readonly _archivedSessionIds;
+    constructor(_sessionsManagementService: ISessionsManagementService, _sessionsService: ISessionsService, _sessionsProvidersService: ISessionsProvidersService, _terminalService: ITerminalService, _agentHostTerminalService: IAgentHostTerminalService, _logService: ILogService, _pathService: IPathService, _fileService: IFileService, _terminalProfileService: ITerminalProfileService);
+    /**
+     * Ensures a terminal exists for the given cwd. When a session is provided,
+     * tracked terminals for that session id are preferred; otherwise the method
+     * falls back to matching untracked terminals by initial cwd for backward
+     * compatibility before creating a new terminal. Sets newly created terminals
+     * as active and optionally focuses them.
+     *
+     * When {@link session} is provided and the session is backed by an agent
+     * host, the terminal is created on the agent host instead of locally.
+     */
+    ensureTerminal(cwd: URI, focus: boolean, session?: ISession): Promise<ITerminalInstance[]>;
+    private _ensureTerminal;
+    private _isTerminalOperationCancelled;
+    private _isSessionRemoteHostAvailable;
+    private _getTerminalOperationGeneration;
+    private _invalidateTerminalOperations;
+    /**
+     * Creates a terminal for the given cwd. If the session is backed by an
+     * agent host, creates an agent host terminal; otherwise creates a local one.
+     */
+    private _createTerminalForSession;
+    /**
+     * Returns the agent host address for the given session's provider,
+     * or `undefined` if the session is not backed by an agent host.
+     */
+    private _getSessionAgentHostAddress;
+    private _onActiveSessionChanged;
+    /**
+     * Finds all terminal instances whose initial cwd (lower-cased) matches
+     * the given key.
+     */
+    private _findTerminalsForKey;
+    private _trackTerminalsForSession;
+    private _beginTerminalOperation;
+    private _endTerminalOperation;
+    private _onDidReplaceNewDraftSession;
+    private _rehomeTerminals;
+    private _transferTerminals;
+    private _getTrackedTerminalsForSession;
+    private _isTerminalTracked;
+    private _removeTerminalFromTrackedSessions;
+    private _getAvailableTerminal;
+    /**
+     * Shows background terminals that belong to the active session and hides
+     * foreground terminals that belong to other sessions. When the active
+     * session has no tracked terminals yet, falls back to initial cwd matching
+     * for compatibility with restored terminals from previous sessions.
+     */
+    private _updateTerminalVisibility;
+    /**
+     * Disposes (kills) terminals associated with the given session id. Used
+     * when a session is removed: removal is an explicit user action, so the pty
+     * is torn down.
+     *
+     * Never disposes the terminal the user is currently working in. Removal also
+     * covers session *graduation* (untitled → committed via `onDidReplaceSession`,
+     * which surfaces the skeleton in `removed`): the focused (active) instance is
+     * therefore always protected.
+     *
+     * {@link reason} is logged for each killed terminal so unexpected disposals in
+     * the agents window can be diagnosed from the logs. See #313510, #318645.
+     */
+    private _closeTerminalsForSession;
+    private _closeArchivedSessionTerminals;
+    private _isArchiveCleanupCurrent;
+    private _ensureActiveSessionTerminalAfterLateArchiveCleanup;
+    private _findUntrackedTerminalsForResource;
+    dumpTracking(): Promise<void>;
+    showAllTerminals(): Promise<void>;
+}