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

package/vscode/src/vs/sessions/contrib/providers/agentHost/browser/agentHostSessionConfigPicker.d.ts

@@ -0,0 +1,174 @@
+import { IActionListItem } from "@codingame/monaco-vscode-api/vscode/vs/platform/actionWidget/browser/actionList";
+import { IActionWidgetService } from "@codingame/monaco-vscode-api/vscode/vs/platform/actionWidget/browser/actionWidget.service";
+import { BaseActionViewItem } from "@codingame/monaco-vscode-api/vscode/vs/base/browser/ui/actionbar/actionViewItems";
+import { Delayer } from "@codingame/monaco-vscode-api/vscode/vs/base/common/async";
+import { Disposable, DisposableStore, IDisposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { IObservable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/observable";
+import { ThemeIcon } from "@codingame/monaco-vscode-api/vscode/vs/base/common/themables";
+import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service";
+import { IContextKeyService } from "@codingame/monaco-vscode-api/vscode/vs/platform/contextkey/common/contextkey.service";
+import { IDialogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/dialogs/common/dialogs.service";
+import { IHoverService } from "@codingame/monaco-vscode-api/vscode/vs/platform/hover/browser/hover.service";
+import { ITelemetryService } from "@codingame/monaco-vscode-api/vscode/vs/platform/telemetry/common/telemetry.service";
+import { IStorageService } from "@codingame/monaco-vscode-api/vscode/vs/platform/storage/common/storage.service";
+import type { SessionConfigPropertySchema } from "@codingame/monaco-vscode-api/vscode/vs/platform/agentHost/common/state/protocol/commands";
+import { IChatInputPickerResponsiveState } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/widget/input/chatInputPickerResponsiveLayout";
+import { IViewsService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/views/common/viewsService.service";
+import { IAgentWorkbenchLayoutService } from "@codingame/monaco-vscode-api/vscode/vs/sessions/browser/workbench.service";
+import { ISessionChangesService } from "@codingame/monaco-vscode-api/vscode/vs/sessions/contrib/changes/browser/sessionChangesService";
+import { ISessionsProvidersService } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/browser/sessionsProvidersService.service";
+import { IActiveSession } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/common/sessionsManagement";
+import { type IAgentHostSessionsProvider } from "@codingame/monaco-vscode-api/vscode/vs/sessions/common/agentHostSessionsProvider";
+import { type ISessionChangeset } from "@codingame/monaco-vscode-api/vscode/vs/sessions/services/sessions/common/session";
+export interface IConfigPickerItem {
+    readonly value: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly checked?: boolean;
+}
+export declare function getConfigIcon(property: string, value: unknown | undefined, hasUncommittedChanges?: boolean): ThemeIcon | undefined;
+export declare class AgentHostSessionConfigPicker extends Disposable {
+    protected readonly _session: IObservable<IActiveSession | undefined>;
+    protected readonly _actionWidgetService: IActionWidgetService;
+    protected readonly _configurationService: IConfigurationService;
+    protected readonly _contextKeyService: IContextKeyService;
+    protected readonly _dialogService: IDialogService;
+    protected readonly _hoverService: IHoverService;
+    protected readonly _sessionsProvidersService: ISessionsProvidersService;
+    protected readonly _telemetryService: ITelemetryService;
+    protected readonly _layoutService: IAgentWorkbenchLayoutService;
+    protected readonly _storageService: IStorageService;
+    private readonly _sessionChangesService;
+    protected readonly _viewsService: IViewsService;
+    protected readonly _renderDisposables: DisposableStore;
+    private readonly _providerListeners;
+    private readonly _isolationCheckbox;
+    private readonly _hostMarker;
+    protected readonly _filterDelayer: Delayer<readonly IActionListItem<IConfigPickerItem>[]>;
+    private readonly _repositoryConfigSequencer;
+    private _container;
+    /**
+     * Session/property-scoped value→label cache for `enumDynamic`
+     * properties (e.g. branch), populated whenever `_getItems` fetches
+     * completions. `enumDynamic` completions are transient protocol
+     * data — only `value` is persisted via `setSessionConfigValue`/
+     * `resolveSessionConfig` — so this is the only place a completion's
+     * `label` for a previously-picked value can be recovered once the
+     * dropdown/sheet closes. Static `enum` properties don't need this:
+     * their label is always derivable from `schema.enum`/`enumLabels`.
+     *
+     * Keyed by session so entries don't leak across sessions: this picker
+     * is only ever created for the new-session composer (`Menus.NewSession-
+     * RepositoryConfig`), and that composer's `_session` tracks the
+     * globally active session — so the *same* picker instance can observe
+     * a sequence of different (not-yet-created) draft sessions as the user
+     * switches between them. `_renderConfigPickers` evicts entries for any
+     * session other than the current one on every render, so the map never
+     * grows beyond the properties of the currently active session.
+     */
+    private readonly _dynamicValueLabels;
+    constructor(_session: IObservable<IActiveSession | undefined>, _actionWidgetService: IActionWidgetService, _configurationService: IConfigurationService, _contextKeyService: IContextKeyService, _dialogService: IDialogService, _hoverService: IHoverService, _sessionsProvidersService: ISessionsProvidersService, _telemetryService: ITelemetryService, _layoutService: IAgentWorkbenchLayoutService, _storageService: IStorageService, _sessionChangesService: ISessionChangesService, _viewsService: IViewsService);
+    private _watchProviders;
+    render(container: HTMLElement): void;
+    private _renderConfigPickers;
+    private _isPickable;
+    /**
+     * Order the schema properties for rendering. The base implementation
+     * enforces a stable visual sequence for well-known properties:
+     * Isolation (worktree/folder) first, then Branch. Any other properties
+     * keep their original schema order after these two. Subclasses can
+     * override to impose a different deterministic visual sequence
+     * (e.g. the mobile chip row groups Approvals | Branch | Worktree).
+     */
+    protected _orderProperties(properties: ReadonlyArray<[
+        string,
+        SessionConfigPropertySchema
+    ]>): ReadonlyArray<[
+        string,
+        SessionConfigPropertySchema
+    ]>;
+    /**
+     * Decide whether a property's chip should be rendered for the current
+     * session. The base implementation hides non-mutable properties in
+     * running sessions (they would render as dead pills). Subclasses can
+     * override to keep specific properties visible as readonly chips —
+     * see {@link _isReadOnlyChip}.
+     */
+    protected _shouldRenderProperty(property: string, schema: SessionConfigPropertySchema, isNewSession: boolean): boolean;
+    /**
+     * Decide whether a property's trigger should render as readonly
+     * (no chevron, no popup). The base implementation defers to the
+     * schema's `readOnly` flag. Subclasses that opt in to rendering
+     * non-mutable chips via {@link _shouldRenderProperty} should
+     * override this to also mark them readonly at runtime.
+     */
+    protected _isReadOnlyChip(property: string, schema: SessionConfigPropertySchema, isNewSession: boolean): boolean;
+    protected _setSessionConfigValue(provider: IAgentHostSessionsProvider, sessionId: string, property: string, value: unknown): Promise<void>;
+    private _invokeCheckoutOperation;
+    protected _requiresBranchCheckout(provider: IAgentHostSessionsProvider, sessionId: string, property: string): boolean;
+    protected _getCheckoutChangeset(sessionId: string): ISessionChangeset | undefined;
+    protected _renderTrigger(trigger: HTMLElement, sessionId: string, property: string, schema: SessionConfigPropertySchema, value: unknown | undefined, isReadOnly: boolean): void;
+    /**
+     * Keeps the Branch chip's glyph, aria label, and hover in sync with the
+     * checked-out branch and uncommitted-changes count reported by the agent host.
+     *
+     * The chip only adopts the dirty state when its selected base branch matches
+     * the repository's checked-out branch. Picker rows apply the same rule.
+     *
+     * The state is patched onto the existing nodes rather than routed through
+     * `_renderConfigPickers`, which tears the whole chip row down: the host
+     * re-probes git whenever it observes a file change, so a flip while the
+     * user has the branch dropdown open would otherwise destroy its anchor.
+     */
+    private _trackBranchRepositoryState;
+    /**
+     * Whether the isolation property should render as a checkbox
+     * (Worktree on/off) rather than a dropdown. Only on non-phone
+     * layouts and only when the schema offers both folder and worktree.
+     */
+    protected _shouldRenderIsolationAsCheckbox(schema: SessionConfigPropertySchema): boolean;
+    private _renderIsolationCheckbox;
+    private _isDevContainerWorktreeEnabled;
+    private _applyIsolationValue;
+    protected _showPicker(provider: IAgentHostSessionsProvider, sessionId: string, property: string, schema: SessionConfigPropertySchema, trigger: HTMLElement): Promise<void>;
+    private _showChanges;
+    protected _getRepositoryBranchState(sessionId: string): {
+        branchName: string | undefined;
+        uncommittedChanges: number | undefined;
+    };
+    protected _getItems(provider: IAgentHostSessionsProvider, sessionId: string, property: string, schema: SessionConfigPropertySchema, query?: string): Promise<readonly IConfigPickerItem[]>;
+    private _fromCompletionItem;
+    private _dynamicValueLabelsKey;
+    private _cacheDynamicValueLabels;
+    /**
+     * Drops cached labels for any session other than `sessionId`. Called on
+     * every render so the cache tracks whichever session the picker is
+     * currently bound to, instead of accumulating entries for every draft
+     * session this (potentially long-lived) picker instance has ever shown.
+     */
+    private _evictDynamicValueLabelsForOtherSessions;
+    private _getLabel;
+    protected _getProvider(providerId: string): IAgentHostSessionsProvider | undefined;
+}
+interface IConfigPickerWidget extends IDisposable {
+    render(container: HTMLElement): HTMLElement | void;
+    focus?(): void;
+    showPicker?(anchor: HTMLElement, onHide?: () => void): boolean | void;
+}
+export declare class PickerActionViewItem extends BaseActionViewItem implements IChatInputPickerResponsiveState {
+    private readonly _picker;
+    private _compact;
+    private _focusableElement;
+    constructor(_picker: IConfigPickerWidget, disposable?: IDisposable);
+    render(container: HTMLElement): void;
+    focus(): void;
+    isFocused(): boolean;
+    blur(): void;
+    setFocusable(_focusable: boolean): void;
+    private _focusFirstTabStop;
+    isCompact(): boolean;
+    setCompact(compact: boolean): void;
+    show(anchor?: HTMLElement): void;
+    dispose(): void;
+}
+export {};