@codingame/monaco-vscode-chat-service-override 27.0.0 → 28.0.1

package/vscode/src/vs/workbench/contrib/chat/browser/chatTipService.d.ts

@@ -1,5 +1,4 @@
 import { MarkdownString } from "@codingame/monaco-vscode-api/vscode/vs/base/common/htmlContent";
-import { ContextKeyExpression } from "@codingame/monaco-vscode-api/vscode/vs/platform/contextkey/common/contextkey";
 import { IContextKeyService } from "@codingame/monaco-vscode-api/vscode/vs/platform/contextkey/common/contextkey.service";
 import { IInstantiationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
 import { IProductService } from "@codingame/monaco-vscode-api/vscode/vs/platform/product/common/productService.service";
@@ -7,132 +6,33 @@ import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/pl
 import { Disposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
 import { ICommandService } from "@codingame/monaco-vscode-api/vscode/vs/platform/commands/common/commands.service";
 import { IStorageService } from "@codingame/monaco-vscode-api/vscode/vs/platform/storage/common/storage.service";
-import { AgentFileType } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService";
-import { IPromptsService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService.service";
-import { PromptsType } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes";
 import { ILogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/log/common/log.service";
-import { ILanguageModelToolsService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/languageModelToolsService.service";
 import { IChatService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatService/chatService.service";
 import { IChatEntitlementService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/chat/common/chatEntitlementService.service";
 import { ITelemetryService } from "@codingame/monaco-vscode-api/vscode/vs/platform/telemetry/common/telemetry.service";
+import { IKeybindingService } from "@codingame/monaco-vscode-api/vscode/vs/platform/keybinding/common/keybinding.service";
+import { TipTrackingCommands } from "./chatTipStorageKeys.js";
 import { IChatTipService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/chatTipService.service";
-export declare const ATTACH_FILES_REFERENCE_TRACKING_COMMAND = "chat.tips.attachFiles.referenceUsed";
-export declare const CREATE_AGENT_INSTRUCTIONS_TRACKING_COMMAND = "chat.tips.createAgentInstructions.commandUsed";
-export declare const CREATE_PROMPT_TRACKING_COMMAND = "chat.tips.createPrompt.commandUsed";
-export declare const CREATE_AGENT_TRACKING_COMMAND = "chat.tips.createAgent.commandUsed";
-export declare const CREATE_SKILL_TRACKING_COMMAND = "chat.tips.createSkill.commandUsed";
+export { TipTrackingCommands };
+/** @deprecated Use TipTrackingCommands.AttachFilesReferenceUsed */
+export declare const ATTACH_FILES_REFERENCE_TRACKING_COMMAND: "chat.tips.attachFiles.referenceUsed";
+/** @deprecated Use TipTrackingCommands.CreateAgentInstructionsUsed */
+export declare const CREATE_AGENT_INSTRUCTIONS_TRACKING_COMMAND: "chat.tips.createAgentInstructions.commandUsed";
+/** @deprecated Use TipTrackingCommands.CreatePromptUsed */
+export declare const CREATE_PROMPT_TRACKING_COMMAND: "chat.tips.createPrompt.commandUsed";
+/** @deprecated Use TipTrackingCommands.CreateAgentUsed */
+export declare const CREATE_AGENT_TRACKING_COMMAND: "chat.tips.createAgent.commandUsed";
+/** @deprecated Use TipTrackingCommands.CreateSkillUsed */
+export declare const CREATE_SKILL_TRACKING_COMMAND: "chat.tips.createSkill.commandUsed";
+/** @deprecated Use TipTrackingCommands.ForkConversationUsed */
+export declare const FORK_CONVERSATION_TRACKING_COMMAND: "chat.tips.forkConversation.commandUsed";
 export interface IChatTip {
     readonly id: string;
     readonly content: MarkdownString;
     readonly enabledCommands?: readonly string[];
 }
-export interface ITipDefinition {
-    readonly id: string;
-    readonly message: string;
-    /**
-     * When clause expression that determines if this tip is eligible to be shown.
-     * If undefined, the tip is always eligible.
-     */
-    readonly when?: ContextKeyExpression;
-    /**
-     * Command IDs that are allowed to be executed from this tip's markdown.
-     */
-    readonly enabledCommands?: string[];
-    /**
-     * Chat model IDs for which this tip is eligible.
-     * Compared against the lowercased `chatModelId` context key.
-     */
-    readonly onlyWhenModelIds?: readonly string[];
-    /**
-     * Command IDs that, if ever executed in this workspace, make this tip ineligible.
-     * The tip won't be shown if the user has already performed the action it suggests.
-     */
-    readonly excludeWhenCommandsExecuted?: string[];
-    /**
-     * Chat mode names that, if ever used in this workspace, make this tip ineligible.
-     * The tip won't be shown if the user has already used the mode it suggests.
-     * Matches against both mode kind (e.g. 'agent') and mode name (e.g. 'Plan').
-     */
-    readonly excludeWhenModesUsed?: string[];
-    /**
-     * Tool IDs that, if ever invoked in this workspace, make this tip ineligible.
-     * The tip won't be shown if the tool it describes has already been used.
-     */
-    readonly excludeWhenToolsInvoked?: string[];
-    /**
-     * If set, exclude this tip when prompt files of the specified type exist in the workspace.
-     */
-    readonly excludeWhenPromptFilesExist?: {
-        readonly promptType: PromptsType;
-        /** Also check for this specific agent instruction file type. */
-        readonly agentFileType?: AgentFileType;
-        /** If true, exclude the tip until the async file check completes. Default: false. */
-        readonly excludeUntilChecked?: boolean;
-    };
-    /**
-     * Setting keys that, if changed from their default value, make this tip ineligible.
-     * The tip won't be shown if the user has already customized the setting it describes.
-     */
-    readonly excludeWhenSettingsChanged?: string[];
-    /**
-     * Command IDs that dismiss this tip when clicked from the tip markdown
-     * while the tip is currently shown.
-     */
-    readonly dismissWhenCommandsClicked?: string[];
-}
-/**
- * Tracks user-level signals that determine whether certain tips should be
- * excluded. Persists state to application storage and disposes listeners once all
- * signals of interest have been observed.
- */
-export declare class TipEligibilityTracker extends Disposable {
-    private readonly _storageService;
-    private readonly _promptsService;
-    private readonly _languageModelToolsService;
-    private readonly _logService;
-    private static readonly _COMMANDS_STORAGE_KEY;
-    private static readonly _MODES_STORAGE_KEY;
-    private static readonly _TOOLS_STORAGE_KEY;
-    private readonly _executedCommands;
-    private readonly _usedModes;
-    private readonly _invokedTools;
-    private readonly _pendingCommands;
-    private readonly _pendingModes;
-    private readonly _pendingTools;
-    private readonly _commandListener;
-    private readonly _toolListener;
-    /**
-     * Tip IDs excluded because prompt files of the required type exist in the workspace.
-     * Tips with `excludeUntilChecked` are pre-added and removed if no files are found.
-     */
-    private readonly _excludedByFiles;
-    /** Tips that have file-based exclusions, kept for re-checks. */
-    private readonly _tipsWithFileExclusions;
-    /** Generation counter per tip ID to discard stale async file-check results. */
-    private readonly _fileCheckGeneration;
-    private readonly _fileChecksInFlight;
-    constructor(tips: readonly ITipDefinition[], commandService: ICommandService, _storageService: IStorageService, _promptsService: IPromptsService, _languageModelToolsService: ILanguageModelToolsService, _logService: ILogService);
-    recordCommandExecuted(commandId: string): void;
-    /**
-     * Records the current chat mode (kind + name) so future tip eligibility
-     * checks can exclude mode-related tips. No-ops once all tracked modes
-     * have been observed.
-     */
-    recordCurrentMode(contextKeyService: IContextKeyService): void;
-    /**
-     * Returns `true` when the tip should be **excluded** from the eligible set.
-     */
-    isExcluded(tip: ITipDefinition): boolean;
-    /**
-     * Revalidates all file-based tip exclusions. Tips with `excludeUntilChecked`
-     * are conservatively hidden until the re-check completes.
-     */
-    refreshPromptFileExclusions(): void;
-    private _checkForPromptFiles;
-    private _doCheckForPromptFiles;
-    private _persistSet;
-    private _readApplicationWithProfileFallback;
-}
+export type { ITipDefinition } from "./chatTipCatalog.js";
+export { TipEligibilityTracker } from "./chatTipEligibilityTracker.js";
 export declare class ChatTipService extends Disposable implements IChatTipService {
     private readonly _productService;
     private readonly _configurationService;
@@ -142,6 +42,7 @@ export declare class ChatTipService extends Disposable implements IChatTipServic
     private readonly _chatEntitlementService;
     private readonly _commandService;
     private readonly _telemetryService;
+    private readonly _keybindingService;
     readonly _serviceBrand: undefined;
     private readonly _onDidDismissTip;
     readonly onDidDismissTip: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<void>;
@@ -165,34 +66,38 @@ export declare class ChatTipService extends Disposable implements IChatTipServic
      * can evaluate when-clause eligibility against the correct context.
      */
     private _contextKeyService;
-    private static readonly _DISMISSED_TIP_KEY;
-    private static readonly _LAST_TIP_ID_KEY;
-    private static readonly _YOLO_EVER_ENABLED_KEY;
-    private static readonly _THINKING_PHRASES_EVER_MODIFIED_KEY;
     private readonly _tracker;
     private readonly _createSlashCommandsUsageTracker;
-    private _yoloModeEverEnabled;
     private _thinkingPhrasesEverModified;
+    private _tipsHiddenForSession;
     private readonly _tipCommandListener;
-    constructor(_productService: IProductService, _configurationService: IConfigurationService, _storageService: IStorageService, _chatService: IChatService, instantiationService: IInstantiationService, _logService: ILogService, _chatEntitlementService: IChatEntitlementService, _commandService: ICommandService, _telemetryService: ITelemetryService);
+    constructor(_productService: IProductService, _configurationService: IConfigurationService, _storageService: IStorageService, _chatService: IChatService, instantiationService: IInstantiationService, _logService: ILogService, _chatEntitlementService: IChatEntitlementService, _commandService: ICommandService, _telemetryService: ITelemetryService, _keybindingService: IKeybindingService);
     private _hasFileOrFolderReference;
-    private _getCreateSlashCommandTrackingId;
-    private _toCreateSlashCommandTrackingId;
+    private _getSlashCommandTrackingId;
+    private _toSlashCommandTrackingId;
+    recordSlashCommandUsage(command: string): void;
     resetSession(): void;
     dismissTip(): void;
+    dismissTipForSession(): void;
     clearDismissedTips(): void;
     private _getDismissedTipIds;
     hideTip(): void;
+    hideTipsForSession(): void;
     disableTips(): Promise<void>;
     getWelcomeTip(contextKeyService: IContextKeyService): IChatTip | undefined;
     private _findNextEligibleTip;
+    private _hideShownTipIfNowIneligible;
     private _pickTip;
+    private _selectTipByTier;
     navigateToNextTip(): IChatTip | undefined;
     navigateToPreviousTip(): IChatTip | undefined;
+    getNextEligibleTip(): IChatTip | undefined;
+    private _getNextTipFromOrderedList;
     hasMultipleTips(): boolean;
     private _navigateTip;
     private _hasNavigableTip;
-    private _getNavigableTip;
+    private _getOrderedEligibleTips;
+    private _sortByPriorityAndCatalogOrder;
     private _isEligible;
     private _isSettingModified;
     private _getCurrentChatModelId;