@codingame/monaco-vscode-chat-service-override 25.1.2 → 26.0.0

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/utils/promptFilesLocator.d.ts

@@ -2,6 +2,7 @@ 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 { IWorkspaceContextService } from "@codingame/monaco-vscode-api/vscode/vs/platform/workspace/common/workspace.service";
 import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service";
+import { IResolvedPromptFile, IResolvedPromptSourceFolder } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/config/promptFileLocations";
 import { PromptsType } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes";
 import { IWorkbenchEnvironmentService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/environment/common/environmentService.service";
 import { ISearchService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/search/common/search.service";
@@ -31,11 +32,21 @@ export declare class PromptFilesLocator {
      */
     listFiles(type: PromptsType, storage: PromptsStorage, token: CancellationToken): Promise<readonly URI[]>;
     private listFilesInUserData;
+    /**
+     * Gets all user storage folders for the given prompt type.
+     * This includes configured tilde paths and the VS Code user data prompts folder.
+     */
+    private getUserStorageFolders;
+    /**
+     * Gets all source folder URIs for a prompt type (both workspace and user home).
+     * This is used for file watching to detect changes in all relevant locations.
+     */
+    private getSourceFoldersSync;
     createFilesUpdatedEvent(type: PromptsType): {
         readonly event: Event<void>;
         dispose: () => void;
     };
-    getAgentSourceFolder(): readonly URI[];
+    getAgentSourceFolders(): Promise<readonly URI[]>;
     /**
      * Get all possible unambiguous prompt file source folders based on
      * the current workspace folder structure.
@@ -48,7 +59,25 @@ export declare class PromptFilesLocator {
      *
      * @returns List of possible unambiguous prompt file folders.
      */
-    getConfigBasedSourceFolders(type: PromptsType): readonly URI[];
+    getConfigBasedSourceFolders(type: PromptsType): Promise<readonly URI[]>;
+    /**
+     * Gets all resolved source folders for the given prompt type with metadata.
+     * This method merges configured locations with default locations and resolves them
+     * to absolute paths, including displayPath and isDefault information.
+     *
+     * @param type The type of prompt files.
+     * @returns List of resolved source folders with metadata.
+     */
+    getResolvedSourceFolders(type: PromptsType): Promise<readonly IResolvedPromptSourceFolder[]>;
+    /**
+     * Gets all local (workspace) storage folders for the given prompt type.
+     * This merges default folders with configured locations.
+     */
+    private getLocalStorageFolders;
+    /**
+     * Deduplicates source folders by URI.
+     */
+    private dedupeSourceFolders;
     /**
      * Finds all existent prompt files in the configured local source folders.
      *
@@ -57,9 +86,11 @@ export declare class PromptFilesLocator {
     private listFilesInLocal;
     private getLocalParentFolders;
     /**
-     * Converts locations defined in `settings` to absolute filesystem path URIs.
+     * Converts locations defined in `settings` to absolute filesystem path URIs with metadata.
      * This conversion is needed because locations in settings can be relative,
      * hence we need to resolve them based on the current workspace folders.
+     * If userHome is provided, paths starting with `~` will be expanded. Otherwise these paths are ignored.
+     * Preserves the type and location properties from the source folder definitions.
      */
     private toAbsoluteLocations;
     /**
@@ -67,7 +98,8 @@ export declare class PromptFilesLocator {
      */
     private resolveFilesAtLocation;
     /**
-     * Uses the search service to find all files at the provided location
+     * Uses the search service to find all files at the provided location.
+     * Requires a FileSearchProvider to be available for the folder's scheme.
      */
     private searchFilesInLocation;
     findCopilotInstructionsMDsInWorkspace(token: CancellationToken): Promise<URI[]>;
@@ -76,6 +108,11 @@ export declare class PromptFilesLocator {
      */
     findAgentMDsInWorkspace(token: CancellationToken): Promise<URI[]>;
     private findAgentMDsInFolder;
+    /**
+     * Recursively traverses a folder using the file service to find AGENTS.md files.
+     * This is used as a fallback when no FileSearchProvider is available for the scheme.
+     */
+    private findAgentMDsUsingFileService;
     /**
      * Gets list of `AGENTS.md` files only at the root workspace folder(s).
      */
@@ -83,23 +120,47 @@ export declare class PromptFilesLocator {
     getAgentFileURIFromModeFile(oldURI: URI): URI | undefined;
     private findAgentSkillsInFolder;
     /**
-     * Searches for skills in all default directories in the workspace.
-     * Each skill is stored in its own subdirectory with a SKILL.md file.
+     * Searches for skills in all configured locations.
      */
-    findAgentSkillsInWorkspace(token: CancellationToken): Promise<Array<{
-        uri: URI;
-        type: string;
-    }>>;
-    /**
-     * Searches for skills in all default directories in the home folder.
-     * Each skill is stored in its own subdirectory with a SKILL.md file.
-     */
-    findAgentSkillsInUserHome(token: CancellationToken): Promise<Array<{
-        uri: URI;
-        type: string;
-    }>>;
+    findAgentSkills(token: CancellationToken): Promise<IResolvedPromptFile[]>;
 }
+/**
+ * Checks if the provided path contains a glob pattern (* or **).
+ * Used to detect deprecated glob usage in prompt file locations.
+ *
+ * @param path - path to check
+ * @returns `true` if the path contains `*` or `**`, `false` otherwise
+ */
+export declare function hasGlobPattern(path: string): boolean;
 /**
  * Checks if the provided `pattern` could be a valid glob pattern.
  */
 export declare function isValidGlob(pattern: string): boolean;
+/**
+ * Regex pattern string for validating paths for all prompt files.
+ * Paths only support:
+ * - Relative paths: someFolder, ./someFolder
+ * - User home paths: ~/folder (only forward slash, not backslash for cross-platform sharing)
+ * - Parent relative paths for monorepos: ../folder
+ *
+ * NOT supported:
+ * - Absolute paths (portability issue)
+ * - Glob patterns with * or ** (performance issue)
+ * - Backslashes (paths should be shareable in repos across platforms)
+ * - Tilde without forward slash (e.g., ~abc, ~\folder)
+ * - Empty or whitespace-only paths
+ *
+ * The regex validates:
+ * - Not a Windows absolute path (e.g., C:\, C:/)
+ * - Not starting with / (Unix absolute path)
+ * - No backslashes anywhere (use forward slashes only)
+ * - If starts with ~, must be followed by /
+ * - No glob pattern characters: * ? [ ] { }
+ * - At least one non-whitespace character
+ */
+export declare const VALID_PROMPT_FOLDER_PATTERN = "^(?![A-Za-z]:[\\\\/])(?!/)(?!~(?!/))(?!.*\\\\)(?!.*[*?\\[\\]{}]).*\\S.*$";
+/**
+ * Validates if a path is allowed for simplified path configurations.
+ * Only forward slashes are supported to ensure paths are shareable across platforms.
+ */
+export declare function isValidPromptFolderPath(path: string): boolean;