feat: add prompt suggest tool for contextual suggestions

- Add prompt_suggest tool for providing contextual next step suggestions
- Add PromptSuggest UI component to display suggestions
- Update capabilities and rules with prompt suggest documentation
- Add XML utils for processing prompt suggestions
- Add prompt_suggest to experiment flags
- Update tool groups to include prompt suggest
- Install fast-xml-parser for XML handling

Author: samhvw8

package-lock.json

@@ -325,6 +325,7 @@
 		"diff": "^5.2.0",
 		"diff-match-patch": "^1.0.5",
 		"fast-deep-equal": "^3.1.3",
+		"fast-xml-parser": "^4.5.1",
 		"fastest-levenshtein": "^1.0.16",
 		"get-folder-size": "^5.0.0",
 		"globby": "^14.0.2",

package.json

@@ -64,6 +64,7 @@ import { McpHub } from "../services/mcp/McpHub"
 import crypto from "crypto"
 import { insertGroups } from "./diff/insert-groups"
 import { EXPERIMENT_IDS, experiments as Experiments } from "../shared/experiments"
+import { parseXml } from "../utils/xml"
 
 const cwd =
 	vscode.workspace.workspaceFolders?.map((folder) => folder.uri.fsPath).at(0) ?? path.join(os.homedir(), "Desktop") // may or may not exist but fs checking existence would immediately ask for permission which would be bad UX, need to come up with a better solution
@@ -1136,6 +1137,9 @@ export class Cline {
 							const modeName = getModeBySlug(mode, customModes)?.name ?? mode
 							return `[${block.name} in ${modeName} mode: '${message}']`
 						}
+						case "prompt_suggest": {
+							return `[${block.name}`
+						}
 					}
 				}
 
@@ -2434,6 +2438,64 @@ export class Cline {
 							break
 						}
 					}
+					case "prompt_suggest": {
+						const result: string | undefined = block.params.result
+						try {
+							if (block.partial) {
+								await this.ask(
+									"prompt_suggest",
+									removeClosingTag("result", result),
+									block.partial,
+								).catch(() => {})
+								break
+							} else {
+								if (!result) {
+									this.consecutiveMistakeCount++
+									pushToolResult(await this.sayAndCreateMissingParamError("prompt_suggest", "result"))
+									break
+								}
+
+								type Suggest = {
+									suggest: string
+								}
+
+								let parsedSuggest: {
+									suggest: Suggest[] | Suggest
+								}
+
+								try {
+									parsedSuggest = parseXml(result, ["result.suggest"]) as {
+										suggest: Suggest[] | Suggest
+									}
+								} catch (error) {
+									this.consecutiveMistakeCount++
+									await this.say("error", `Failed to parse operations: ${error.message}`)
+									pushToolResult(formatResponse.toolError("Invalid operations xml format"))
+									break
+								}
+
+								this.consecutiveMistakeCount = 0
+
+								const normalizedSuggest = Array.isArray(parsedSuggest?.suggest)
+									? parsedSuggest.suggest
+									: [parsedSuggest?.suggest].filter((sug): sug is Suggest => sug !== undefined)
+
+								const { text, images } = await this.ask(
+									"prompt_suggest",
+									JSON.stringify(normalizedSuggest),
+									false,
+								)
+								await this.say("user_feedback", text ?? "", images)
+								pushToolResult(
+									formatResponse.toolResult(`<user_feedback>\n${text}\n</user_feedback>`, images),
+								)
+								break
+							}
+						} catch (error) {
+							await handleError("prompt suggest", error)
+							break
+						}
+					}
 					case "switch_mode": {
 						const mode_slug: string | undefined = block.params.mode_slug
 						const reason: string | undefined = block.params.reason

src/core/Cline.ts

@@ -25,6 +25,7 @@ export const toolUseNames = [
 	"attempt_completion",
 	"switch_mode",
 	"new_task",
+	"prompt_suggest",
 ] as const
 
 // Converts array of tool call names into a union type ("execute_command" | "read_file" | ...)
@@ -138,3 +139,8 @@ export interface NewTaskToolUse extends ToolUse {
 	name: "new_task"
 	params: Partial<Pick<Record<ToolParamName, string>, "mode" | "message">>
 }
+
+export interface PromptSuggestToolUse extends ToolUse {
+	name: "prompt_suggest"
+	params: Partial<Pick<Record<ToolParamName, string>, "result">>
+}