@amical/aiagent-sdk 0.1.1 → 0.1.3

package/dist/runtime/webRuntime.mjs

@@ -0,0 +1,1494 @@
+import { nanoid } from 'nanoid';
+import matter from 'gray-matter';
+import { streamText } from 'ai';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createDifyProvider } from 'dify-ai-provider';
+import { Volume, createFsFromVolume } from 'memfs';
+import path from 'path-browserify';
+
+// src/shared/tools.ts
+var AgentDefaultTool = /* @__PURE__ */ ((AgentDefaultTool2) => {
+  AgentDefaultTool2["ASK"] = "agent_ask_followup_question";
+  AgentDefaultTool2["ATTEMPT"] = "agent_attempt_completion";
+  AgentDefaultTool2["BASH"] = "agent_execute_command";
+  AgentDefaultTool2["FILE_EDIT"] = "agent_replace_in_file";
+  AgentDefaultTool2["FILE_READ"] = "agent_read_file";
+  AgentDefaultTool2["FILE_NEW"] = "agent_write_to_file";
+  AgentDefaultTool2["FILE_DELETE"] = "agent_delete_file";
+  AgentDefaultTool2["DIR_DELETE"] = "agent_delete_directory";
+  AgentDefaultTool2["SEARCH"] = "agent_search_files";
+  AgentDefaultTool2["LIST_FILES"] = "agent_list_files";
+  AgentDefaultTool2["LIST_CODE_DEF"] = "agent_list_code_definition_names";
+  AgentDefaultTool2["BROWSER"] = "agent_browser_action";
+  AgentDefaultTool2["MCP_USE"] = "agent_use_mcp_tool";
+  AgentDefaultTool2["MCP_ACCESS"] = "agent_access_mcp_resource";
+  AgentDefaultTool2["MCP_DOCS"] = "agent_load_mcp_documentation";
+  AgentDefaultTool2["NEW_TASK"] = "agent_new_task";
+  AgentDefaultTool2["PLAN_MODE"] = "agent_plan_mode_respond";
+  AgentDefaultTool2["ACT_MODE"] = "agent_act_mode_respond";
+  AgentDefaultTool2["TODO"] = "agent_focus_chain";
+  AgentDefaultTool2["WEB_FETCH"] = "agent_web_fetch";
+  AgentDefaultTool2["WEB_SEARCH"] = "agent_web_search";
+  AgentDefaultTool2["CONDENSE"] = "agent_condense";
+  AgentDefaultTool2["SUMMARIZE_TASK"] = "agent_summarize_task";
+  AgentDefaultTool2["REPORT_BUG"] = "agent_report_bug";
+  AgentDefaultTool2["NEW_RULE"] = "agent_new_rule";
+  AgentDefaultTool2["APPLY_PATCH"] = "agent_apply_patch";
+  AgentDefaultTool2["GENERATE_EXPLANATION"] = "agent_generate_explanation";
+  AgentDefaultTool2["LOAD_SKILL"] = "agent_load_skill";
+  AgentDefaultTool2["USE_SUBAGENTS"] = "agent_use_subagents";
+  return AgentDefaultTool2;
+})(AgentDefaultTool || {});
+var TOOL_RESULT_BLOCK = "tool_call_result";
+var defaultTools = [
+  {
+    name: "agent_ask_followup_question" /* ASK */,
+    description: "Ask the user a clarifying question if more information is needed.",
+    params: {
+      question: "The question to ask the user."
+    }
+  },
+  {
+    name: "agent_attempt_completion" /* ATTEMPT */,
+    description: "After each tool use, the user will respond with the result of that tool use, i.e. if it succeeded or failed, along with any reasons for failure. Once you've received the results of tool uses and can confirm that the task is complete, use this tool to present the result of your work to the user. Optionally you may provide a CLI command to showcase the result of your work. The user may respond with feedback if they are not satisfied with the result, which you can use to make improvements and try again. IMPORTANT NOTE: This tool CANNOT be used until you've confirmed from the user that any previous tool uses were successful. Failure to do so will result in code corruption and system failure. Before using this tool, you must ask yourself in tags if you've confirmed from the user that any previous tool uses were successful. If not, then DO NOT use this tool. If you were using task_progress to update the task progress, you must include the completed list in the result as well.",
+    params: {
+      result: "(required) The result of the tool use. This should be a clear, specific description of the result."
+    },
+    example: `## Example: ${"agent_attempt_completion" /* ATTEMPT */}
+<${"agent_attempt_completion" /* ATTEMPT */}>
+<result>final result or message</result>
+<task_progress>
+- [x] Set up project structure
+- [x] Install dependencies
+- [x] Run command to start server
+- [x] Test application
+</task_progress>
+</${"agent_attempt_completion" /* ATTEMPT */}>`
+  },
+  {
+    name: "agent_execute_command" /* BASH */,
+    description: "Request to execute a CLI command on the system. Use this when you need to perform system operations or run specific commands to accomplish any step in the user's task. You must tailor your command to the user's system and provide a clear explanation of what the command does. For command chaining, use the appropriate chaining syntax for the user's shell. Prefer to execute complex CLI commands over creating executable scripts, as they are more flexible and easier to run. Commands will be executed in the current working directory: ${context.cwd} Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace.",
+    params: {
+      command: "(required) The CLI command to execute. This should be valid for the current operating system. Ensure the command is properly formatted and does not contain any harmful instructions."
+    },
+    example: `## Example: Requesting to execute a command
+
+<${"agent_execute_command" /* BASH */}>
+<command>npm run dev</command>
+<requires_approval>false</requires_approval>
+<task_progress>
+- [x] Set up project structure
+- [x] Install dependencies
+- [ ] Run command to start server
+- [ ] Test application
+</task_progress>
+</${"agent_execute_command" /* BASH */}>`
+  },
+  {
+    name: "agent_replace_in_file" /* FILE_EDIT */,
+    description: "Replace specific content in a file using a search/replace diff block.",
+    params: {
+      path: "(required) The absolute or relative file path to modify.",
+      diff: "(required) The diff content to apply."
+    },
+    example: `## Example: Requesting to make targeted edits to a file
+
+<${"agent_replace_in_file" /* FILE_EDIT */}>
+<path>src/components/App.tsx</path>
+<diff>
+------- SEARCH
+import React from 'react';
+=======
+import React, { useState } from 'react';
++++++++ REPLACE
+
+------- SEARCH
+function handleSubmit() {
+  saveData();
+  setLoading(false);
+}
+
+=======
++++++++ REPLACE
+
+------- SEARCH
+return (
+  <div>
+=======
+function handleSubmit() {
+  saveData();
+  setLoading(false);
+}
+
+return (
+  <div>
++++++++ REPLACE
+</diff>
+<task_progress>
+- [x] Set up project structure
+- [x] Install dependencies
+- [ ] Create components
+- [ ] Test application
+</task_progress>
+</${"agent_replace_in_file" /* FILE_EDIT */}>`
+  },
+  {
+    name: "agent_read_file" /* FILE_READ */,
+    description: "Read the contents of a specific file.",
+    params: {
+      path: "(required) The absolute or relative file path to read."
+    }
+  },
+  {
+    name: "agent_write_to_file" /* FILE_NEW */,
+    description: "Create or overwrite a file with new content.",
+    params: {
+      path: "(required) The path of the file to write to (relative to the current working directory ${context.cwd}) Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace.",
+      content: "(required) The content to write to the file."
+    },
+    example: `## Example: Requesting to create a new file
+
+<${"agent_write_to_file" /* FILE_NEW */}>
+<path>src/frontend-config.json</path>
+<content>
+{
+  "apiEndpoint": "https://api.example.com",
+  "theme": {
+    "primaryColor": "#007bff",
+    "secondaryColor": "#6c757d",
+    "fontFamily": "Arial, sans-serif"
+  },
+  "features": {
+    "darkMode": true,
+    "notifications": true,
+    "analytics": false
+  },
+  "version": "1.0.0"
+}
+</content>
+<task_progress>
+- [x] Set up project structure
+- [x] Install dependencies
+- [x] Create components
+- [ ] Test application
+</task_progress>
+</${"agent_write_to_file" /* FILE_NEW */}>`
+  },
+  {
+    name: "agent_delete_file" /* FILE_DELETE */,
+    description: "Delete a file.",
+    params: {
+      path: "(required) The path of the file to delete to (relative to the current working directory ${context.cwd}) Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace."
+    }
+  },
+  {
+    name: "agent_delete_directory" /* DIR_DELETE */,
+    description: "Delete a directory.",
+    params: {
+      path: "(required) The path of the directory to delete to (relative to the current working directory ${context.cwd}) Use @workspace:path syntax (e.g., @frontend:src/index.ts) to specify a workspace."
+    }
+  },
+  {
+    name: "agent_search_files" /* SEARCH */,
+    description: "Search for files in a directory that match a regex pattern or glob pattern.",
+    params: {
+      path: "(required) The absolute or relative directory path to search.",
+      regex: "(required) The regex pattern to match files against.",
+      file_pattern: "(optional) glob pattern like *.ts."
+    }
+  },
+  {
+    name: "agent_list_files" /* LIST_FILES */,
+    description: "List all files in a directory.",
+    params: {
+      path: "(required) The absolute or relative directory path to list."
+    }
+  },
+  //================
+  {
+    name: "agent_new_task" /* NEW_TASK */,
+    description: "Create a new task with a given context.",
+    params: {
+      context: "(required) The context of the new task."
+    },
+    example: `## Example: Creating a new task
+<${"agent_new_task" /* NEW_TASK */}>
+<context>
+1. Current Work:
+   [Detailed description]
+
+2. Key Technical Concepts:
+   - [Concept 1]
+   - [Concept 2]
+   - [...]
+
+3. Relevant Files and Code:
+   - [File Name 1]
+      - [Summary of why this file is important]
+      - [Summary of the changes made to this file, if any]
+      - [Important Code Snippet]
+   - [File Name 2]
+      - [Important Code Snippet]
+   - [...]
+
+4. Problem Solving:
+   [Detailed description]
+
+5. Pending Tasks and Next Steps:
+   - [Task 1 details & next steps]
+   - [Task 2 details & next steps]
+   - [...]
+</context>
+</${"agent_new_task" /* NEW_TASK */}>`
+  },
+  {
+    name: "agent_load_skill" /* LOAD_SKILL */,
+    description: "Load a skill to perform a task. important: skill_name is required. must use this tool to load the skill; do not use any other method to read it.",
+    params: {
+      skill_name: "(required) The name of the skill to load."
+    }
+  }
+];
+var toolUseNames = Object.values(AgentDefaultTool);
+var dynamicToolUseNamesByNamespace = /* @__PURE__ */ new Map();
+function setDynamicToolUseNames(namespace, names) {
+  dynamicToolUseNamesByNamespace.set(namespace, new Set(names.map((name) => name.trim()).filter(Boolean)));
+}
+function getToolUseNames() {
+  const defaults = [...toolUseNames];
+  const dynamic = Array.from(dynamicToolUseNamesByNamespace.values()).flatMap((set) => Array.from(set));
+  return Array.from(/* @__PURE__ */ new Set([...defaults, ...dynamic]));
+}
+var READ_ONLY_TOOLS = [
+  "agent_list_files" /* LIST_FILES */,
+  "agent_read_file" /* FILE_READ */,
+  "agent_search_files" /* SEARCH */,
+  "agent_list_code_definition_names" /* LIST_CODE_DEF */,
+  "agent_browser_action" /* BROWSER */,
+  "agent_ask_followup_question" /* ASK */,
+  "agent_web_search" /* WEB_SEARCH */,
+  "agent_web_fetch" /* WEB_FETCH */,
+  "agent_load_skill" /* LOAD_SKILL */,
+  "agent_use_subagents" /* USE_SUBAGENTS */
+];
+function parseAssistantMessageV2(assistantMessage, toolParamNames2) {
+  const contentBlocks = [];
+  let currentTextContentStart = 0;
+  let currentTextContent;
+  let currentToolUseStart = 0;
+  let currentToolUse;
+  let currentParamValueStart = 0;
+  let currentParamName;
+  const toolUseOpenTags = /* @__PURE__ */ new Map();
+  const toolParamOpenTags = /* @__PURE__ */ new Map();
+  for (const name of getToolUseNames()) {
+    toolUseOpenTags.set(`<${name}>`, name);
+  }
+  for (const name of toolParamNames2) {
+    toolParamOpenTags.set(`<${name}>`, name);
+  }
+  const len = assistantMessage.length;
+  for (let i = 0; i < len; i++) {
+    const currentCharIndex = i;
+    if (currentToolUse && currentParamName) {
+      const closeTag = `</${currentParamName}>`;
+      if (currentCharIndex >= closeTag.length - 1 && assistantMessage.startsWith(
+        closeTag,
+        currentCharIndex - closeTag.length + 1
+        // Start checking from potential start of tag
+      )) {
+        const value = assistantMessage.slice(
+          currentParamValueStart,
+          // Start after the opening tag
+          currentCharIndex - closeTag.length + 1
+          // End before the closing tag
+        ).trim();
+        currentToolUse.params[currentParamName] = value;
+        currentParamName = void 0;
+      } else {
+        continue;
+      }
+    }
+    if (currentToolUse && !currentParamName) {
+      let startedNewParam = false;
+      for (const [tag, paramName] of toolParamOpenTags.entries()) {
+        if (currentCharIndex >= tag.length - 1 && assistantMessage.startsWith(tag, currentCharIndex - tag.length + 1)) {
+          currentParamName = paramName;
+          currentParamValueStart = currentCharIndex + 1;
+          startedNewParam = true;
+          break;
+        }
+      }
+      if (startedNewParam) {
+        continue;
+      }
+      const toolCloseTag = `</${currentToolUse.name}>`;
+      if (currentCharIndex >= toolCloseTag.length - 1 && assistantMessage.startsWith(toolCloseTag, currentCharIndex - toolCloseTag.length + 1)) {
+        const toolContentSlice = assistantMessage.slice(
+          currentToolUseStart,
+          // From after the tool opening tag
+          currentCharIndex - toolCloseTag.length + 1
+          // To before the tool closing tag
+        );
+        const contentParamName = "content";
+        if (currentToolUse.name === "agent_write_to_file" /* FILE_NEW */ && toolContentSlice.includes(`<${contentParamName}>`)) {
+          const contentStartTag = `<${contentParamName}>`;
+          const contentEndTag = `</${contentParamName}>`;
+          const contentStart = toolContentSlice.indexOf(contentStartTag);
+          const contentEnd = toolContentSlice.lastIndexOf(contentEndTag);
+          if (contentStart !== -1 && contentEnd !== -1 && contentEnd > contentStart) {
+            const contentValue = toolContentSlice.slice(contentStart + contentStartTag.length, contentEnd).trim();
+            currentToolUse.params[contentParamName] = contentValue;
+          }
+        }
+        currentToolUse.partial = false;
+        contentBlocks.push(currentToolUse);
+        currentToolUse = void 0;
+        currentTextContentStart = currentCharIndex + 1;
+        continue;
+      }
+      continue;
+    }
+    if (!currentToolUse) {
+      let startedNewTool = false;
+      for (const [tag, toolName] of toolUseOpenTags.entries()) {
+        if (currentCharIndex >= tag.length - 1 && assistantMessage.startsWith(tag, currentCharIndex - tag.length + 1)) {
+          if (currentTextContent) {
+            currentTextContent.content = assistantMessage.slice(
+              currentTextContentStart,
+              // From where text started
+              currentCharIndex - tag.length + 1
+              // To before the tool tag starts
+            ).trim();
+            currentTextContent.partial = false;
+            if (currentTextContent.content.length > 0) {
+              contentBlocks.push(currentTextContent);
+            }
+            currentTextContent = void 0;
+          } else {
+            const potentialText = assistantMessage.slice(
+              currentTextContentStart,
+              // From where text *might* have started
+              currentCharIndex - tag.length + 1
+              // To before the tool tag starts
+            ).trim();
+            if (potentialText.length > 0) {
+              contentBlocks.push({
+                type: "text",
+                content: potentialText,
+                partial: false
+              });
+            }
+          }
+          currentToolUse = {
+            type: "tool_use",
+            name: toolName,
+            params: {},
+            partial: true,
+            // Assume partial until closing tag is found
+            call_id: nanoid(8),
+            isNativeToolCall: false
+          };
+          currentToolUseStart = currentCharIndex + 1;
+          startedNewTool = true;
+          break;
+        }
+      }
+      if (startedNewTool) {
+        continue;
+      }
+      if (!currentTextContent) {
+        currentTextContentStart = currentCharIndex;
+        currentTextContent = {
+          type: "text",
+          content: "",
+          // Will be determined by slicing at the end or when a tool starts
+          partial: true
+        };
+      }
+    }
+  }
+  if (currentToolUse && currentParamName) {
+    currentToolUse.params[currentParamName] = assistantMessage.slice(currentParamValueStart).trim();
+  }
+  if (currentToolUse) {
+    contentBlocks.push(currentToolUse);
+  } else if (currentTextContent) {
+    currentTextContent.content = assistantMessage.slice(currentTextContentStart).trim();
+    if (currentTextContent.content.length > 0) {
+      contentBlocks.push(currentTextContent);
+    }
+  }
+  return contentBlocks;
+}
+
+// src/parser/index.ts
+var toolParamNames = [
+  "command",
+  "requires_approval",
+  "path",
+  "absolutePath",
+  "content",
+  "diff",
+  "regex",
+  "file_pattern",
+  "recursive",
+  "action",
+  "url",
+  "coordinate",
+  "text",
+  "query",
+  "allowed_domains",
+  "blocked_domains",
+  "prompt",
+  "server_name",
+  "tool_name",
+  "arguments",
+  "uri",
+  "question",
+  "options",
+  "response",
+  "result",
+  "context",
+  "title",
+  "what_happened",
+  "steps_to_reproduce",
+  "api_request_output",
+  "additional_context",
+  "needs_more_exploration",
+  "task_progress",
+  "timeout",
+  "input",
+  "from_ref",
+  "to_ref",
+  "skill_name",
+  "prompt_1",
+  "prompt_2",
+  "prompt_3",
+  "prompt_4",
+  "prompt_5",
+  "start_line",
+  "end_line"
+];
+var AgentState = /* @__PURE__ */ ((AgentState2) => {
+  AgentState2["IDLE"] = "idle";
+  AgentState2["THINKING"] = "thinking";
+  AgentState2["WAITING_FOR_USER"] = "waiting_for_user";
+  AgentState2["FINISHED"] = "finished";
+  AgentState2["ERROR"] = "error";
+  return AgentState2;
+})(AgentState || {});
+var ClineAgent = class {
+  runtime;
+  api;
+  promptManager;
+  memory;
+  mcp;
+  state = "idle" /* IDLE */;
+  allToolParamNames = [...toolParamNames];
+  /** 循环计数器 */
+  loopCount = 0;
+  /** 最大循环次数 */
+  maxLoopCount;
+  skillDir;
+  customTools;
+  customToolNames;
+  allowDefaultTools;
+  customInstructions;
+  sysPrompt;
+  noUseTollSysPrompt;
+  // 简单的事件回调系统，供宿主环境注册以监听 Agent 内部事件
+  onStateChange;
+  onStreamChunk;
+  onToolCall;
+  constructor(options) {
+    this.runtime = options.runtime;
+    this.api = options.api;
+    this.promptManager = options.promptManager;
+    this.memory = options.memory;
+    this.mcp = options.mcp;
+    this.maxLoopCount = options.maxLoopCount ?? 150;
+    this.customTools = options.customTools || [];
+    this.allowDefaultTools = options.allowDefaultTools;
+    if (this.allowDefaultTools && !this.allowDefaultTools.includes("agent_attempt_completion" /* ATTEMPT */)) {
+      this.allowDefaultTools.push("agent_attempt_completion" /* ATTEMPT */);
+    }
+    this.customInstructions = options.customInstructions;
+    if (this.customTools.length > 0) {
+      const dynamicToolNames = /* @__PURE__ */ new Set();
+      const customToolParams = /* @__PURE__ */ new Set();
+      for (const customTool of this.customTools) {
+        dynamicToolNames.add(customTool.name);
+        if (customTool.params) {
+          for (const key in customTool.params) {
+            if (!Object.hasOwn(customTool.params, key)) continue;
+            customToolParams.add(key);
+          }
+        }
+      }
+      const defaultToolNames = Object.values(AgentDefaultTool);
+      const overlappingTools = Array.from(dynamicToolNames).filter((name) => defaultToolNames.includes(name));
+      if (overlappingTools.length > 0) {
+        throw new Error(`Custom tools and default tools have overlapping names: ${overlappingTools.join(", ")}`);
+      }
+      if (dynamicToolNames.size > 0) {
+        setDynamicToolUseNames("customUser", Array.from(dynamicToolNames));
+      }
+      if (customToolParams.size > 0) {
+        this.allToolParamNames = Array.from(/* @__PURE__ */ new Set([...this.allToolParamNames, ...Array.from(customToolParams)]));
+      }
+    }
+    this.customToolNames = new Set(this.customTools.map((t) => t.name));
+    this.skillDir = this.runtime.path.join(this.runtime.env.cwd(), ".agent/skills");
+  }
+  setState(newState) {
+    this.state = newState;
+    if (this.onStateChange) {
+      this.onStateChange(newState);
+    }
+  }
+  /**
+   * 获取当前 Agent 的系统提示词 
+   * 如果 force 为 true，则强制重新获取系统提示词
+   */
+  async getPrompt(force = false) {
+    if (!force && this.sysPrompt && this.noUseTollSysPrompt) {
+      return { sysPrompt: this.sysPrompt, noUseTollSysPrompt: this.noUseTollSysPrompt };
+    }
+    const context = {
+      cwd: this.runtime.env.cwd(),
+      os: this.runtime.env.osInfo(),
+      shell: this.runtime.env.shell(),
+      skills: await this.getSkills(),
+      customTools: this.customTools,
+      allowDefaultTools: this.allowDefaultTools,
+      customInstructions: this.customInstructions
+    };
+    this.sysPrompt = await this.promptManager.getSystemPrompt(context);
+    this.noUseTollSysPrompt = this.promptManager.getNoUseToolInstructions(context);
+    return { sysPrompt: this.sysPrompt, noUseTollSysPrompt: this.noUseTollSysPrompt };
+  }
+  /**
+   * 启动一个新的任务
+   */
+  async startTask(taskDescription) {
+    this.setState("thinking" /* THINKING */);
+    try {
+      await this.memory.clear();
+      this.loopCount = 0;
+      await this.memory.appendMessage({
+        role: "user",
+        content: taskDescription
+      });
+      await this.loop();
+    } catch (err) {
+      this.setState("error" /* ERROR */);
+      throw err;
+    }
+  }
+  async getSkills() {
+    const skillDir = this.skillDir;
+    const skillList = [];
+    if (!this.runtime.fs.fileExists(skillDir)) {
+      return skillList;
+    }
+    const files = await this.runtime.fs.readDir(skillDir);
+    const skills = files.filter((item) => item.isDirectory()).map((item) => item.name);
+    if (skills.length === 0) {
+      return [];
+    }
+    for (const skill of skills) {
+      try {
+        const skillPath = this.runtime.path.join(skillDir, skill);
+        const files2 = await this.runtime.fs.readDir(skillPath);
+        const skillFile = files2.map((item) => item.isFile()).find((f) => f.toLowerCase() === "skill.md");
+        if (skillFile) {
+          const mdPath = this.runtime.path.join(skillPath, skillFile);
+          const mdContent = await this.runtime.fs.readFile(mdPath);
+          const parsed = matter(mdContent);
+          if (parsed.data && parsed.data.description) {
+            let description = String(parsed.data.description).trim();
+            description = description.replace(/\s+/g, " ").trim();
+            if (description) {
+              skillList.push({
+                name: skill,
+                description
+              });
+            }
+          }
+        }
+      } catch (e) {
+        return skillList;
+      }
+    }
+  }
+  /**
+   * 核心任务循环
+   */
+  async loop() {
+    const { sysPrompt, noUseTollSysPrompt } = await this.getPrompt(true);
+    const { customTools, customToolNames } = this;
+    while (this.state === "thinking" /* THINKING */) {
+      this.loopCount++;
+      if (this.loopCount > this.maxLoopCount) {
+        await this.memory.appendMessage({
+          role: "user",
+          content: `[ERROR] You have exceeded the maximum loop limit of ${this.maxLoopCount} times. Please immediately call the agent_attempt_completion tool to return the final result. If you have pending user-specified tools to execute, you may run them first before calling agent_attempt_completion.`
+        });
+      }
+      const history = await this.memory.getHistory();
+      const stream = this.api.createMessage(sysPrompt, history);
+      let fullResponseText = "";
+      for await (const chunk of stream) {
+        if (chunk.type === "text" && chunk.text) {
+          fullResponseText += chunk.text;
+        }
+        if (this.onStreamChunk) {
+          this.onStreamChunk(chunk);
+        }
+      }
+      await this.memory.appendMessage({
+        role: "assistant",
+        content: fullResponseText
+      });
+      const parsedBlocks = parseAssistantMessageV2(fullResponseText, this.allToolParamNames);
+      const toolUses = parsedBlocks.filter((b) => b.type === "tool_use");
+      if (toolUses.length === 0) {
+        await this.memory.appendMessage({
+          role: "user",
+          content: noUseTollSysPrompt
+        });
+      } else {
+        const toolResults = [];
+        for (const tool of toolUses) {
+          if (this.onToolCall) {
+            const hookResult = await this.onToolCall(tool);
+            if (hookResult) {
+              toolResults.push({ tool, result: hookResult });
+              continue;
+            }
+          }
+          if (customToolNames.has(tool.name)) {
+            const customTool = customTools.find((t) => t.name === tool.name);
+            if (customTool.onCall) {
+              try {
+                const res = await customTool.onCall(tool.params);
+                toolResults.push({ tool, result: res });
+              } catch (error) {
+                toolResults.push({ tool, result: `Error: ${error.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: `Error: Custom tool "${tool.name}" does not have an onCall method.` });
+            }
+            continue;
+          }
+          if (tool.name === "agent_attempt_completion" /* ATTEMPT */) {
+            toolResults.push({ tool, result: "Task marked as completed." });
+            this.setState("finished" /* FINISHED */);
+            break;
+          } else if (tool.name === "agent_read_file" /* FILE_READ */) {
+            const path2 = tool.params.path;
+            if (path2) {
+              try {
+                const content = await this.runtime.fs.readFile(path2);
+                toolResults.push({ tool, result: content });
+              } catch (error) {
+                toolResults.push({ tool, result: `Error: ${error.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: "Error: No path provided." });
+            }
+          } else if (tool.name === "agent_execute_command" /* BASH */) {
+            const cmd = tool.params.command;
+            if (cmd) {
+              const result = await this.runtime.terminal.execCommand(cmd);
+              toolResults.push({ tool, result: `STDOUT: ${result.stdout}
+STDERR: ${result.stderr}` });
+            }
+          } else if (tool.name === "agent_write_to_file" /* FILE_NEW */) {
+            const path2 = tool.params.path;
+            const content = tool.params.content;
+            if (path2 && content !== void 0) {
+              try {
+                await this.runtime.fs.writeFile(path2, content);
+                toolResults.push({ tool, result: `Successfully wrote to ${path2}` });
+              } catch (error) {
+                toolResults.push({ tool, result: `Error: ${error.message}` });
+              }
+            }
+          } else if (tool.name === "agent_list_files" /* LIST_FILES */) {
+            const path2 = tool.params.path || this.runtime.env.cwd();
+            try {
+              const files = await this.runtime.fs.readDir(path2);
+              toolResults.push({ tool, result: files.map((f) => f.name + (f.isDirectory() ? "/" : "")).join("\n") });
+            } catch (e) {
+              toolResults.push({ tool, result: `Error: ${e.message}` });
+            }
+          } else if (tool.name === "agent_replace_in_file" /* FILE_EDIT */) {
+            const path2 = tool.params.path;
+            const diff = tool.params.diff;
+            if (path2 && diff) {
+              try {
+                const content = await this.runtime.fs.readFile(path2);
+                const newContent = this.applyDiff(content, diff);
+                await this.runtime.fs.writeFile(path2, newContent);
+                toolResults.push({ tool, result: `Successfully replaced content in ${path2}` });
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: "Error: Missing path or diff." });
+            }
+          } else if (tool.name === "agent_delete_file" /* FILE_DELETE */) {
+            const path2 = tool.params.path;
+            if (path2) {
+              try {
+                await this.runtime.fs.deleteFile(path2);
+                toolResults.push({ tool, result: `Successfully deleted ${path2}` });
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: "Error: Missing path." });
+            }
+          } else if (tool.name === "agent_delete_directory" /* DIR_DELETE */) {
+            const path2 = tool.params.path;
+            if (path2) {
+              try {
+                await this.runtime.fs.deleteDirectory(path2);
+                toolResults.push({ tool, result: `Successfully deleted ${path2}` });
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: "Error: Missing path." });
+            }
+          } else if (tool.name === "agent_ask_followup_question" /* ASK */) {
+            const question = tool.params.question;
+            toolResults.push({ tool, result: `Asking user: ${question}` });
+            this.setState("waiting_for_user" /* WAITING_FOR_USER */);
+            break;
+          } else if (tool.name === "agent_search_files" /* SEARCH */) {
+            const path2 = tool.params.path || this.runtime.env.cwd();
+            const regexStr = tool.params.regex;
+            const filePattern = tool.params.file_pattern;
+            if (regexStr && this.runtime.fs.searchFiles) {
+              try {
+                const result = await this.runtime.fs.searchFiles(path2, regexStr, filePattern);
+                toolResults.push({ tool, result: `${result}` });
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: `Error: searchFiles not supported by runtime or missing regex.` });
+            }
+          } else if (tool.name === "agent_use_mcp_tool" /* MCP_USE */) {
+            const serverName = tool.params.server_name;
+            const toolName = tool.params.tool_name;
+            const args = tool.params.arguments;
+            if (this.mcp && serverName && toolName) {
+              try {
+                let parsedArgs = args;
+                if (typeof args === "string") {
+                  parsedArgs = JSON.parse(args);
+                }
+                const result = await this.mcp.callTool(serverName, toolName, parsedArgs);
+                if (result.isError) {
+                  toolResults.push({ tool, result: `Error executing MCP tool: ${JSON.stringify(result.content)}` });
+                } else {
+                  toolResults.push({ tool, result: `${JSON.stringify(result.content)}` });
+                }
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: `Error: MCP Manager not available or missing parameters.` });
+            }
+          } else if (tool.name === "agent_access_mcp_resource" /* MCP_ACCESS */) {
+            const serverName = tool.params.server_name;
+            const uri = tool.params.uri;
+            if (this.mcp && this.mcp.readResource && serverName && uri) {
+              try {
+                const result = await this.mcp.readResource(serverName, uri);
+                toolResults.push({ tool, result: `${JSON.stringify(result)}` });
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            } else {
+              toolResults.push({ tool, result: `Error: MCP Manager not available, readResource not implemented, or missing parameters.` });
+            }
+          } else if (tool.name === "agent_load_mcp_documentation" /* MCP_DOCS */) {
+            const docs = `MCP (Model Context Protocol) is used to connect to external tools/resources. To build one, typically you create an HTTP/stdio server responding to MCP defined JSON-RPC messages...`;
+            toolResults.push({ tool, result: docs });
+          } else if (tool.name === "agent_list_code_definition_names" /* LIST_CODE_DEF */) {
+            const path2 = tool.params.path || this.runtime.env.cwd();
+            try {
+              const result = await this.runtime.fs.searchFiles?.(path2, "^(class|function|const|let|var|export|interface|type)\\s+\\w+", "*.ts|*.js");
+              toolResults.push({ tool, result: `${result ? result : "No definitions found or searchFiles not supported."}` });
+            } catch (e) {
+              toolResults.push({ tool, result: `Error: ${e.message}` });
+            }
+          } else if (tool.name === "agent_web_fetch" /* WEB_FETCH */) {
+            const url = tool.params.url;
+            if (url) {
+              try {
+                const res = await fetch(url);
+                const text = await res.text();
+                toolResults.push({ tool, result: text.substring(0, 3e3) });
+              } catch (e) {
+                toolResults.push({ tool, result: `Error: ${e.message}` });
+              }
+            }
+          } else if (tool.name === "agent_focus_chain" /* TODO */) {
+            toolResults.push({ tool, result: `Focus chain updated successfully.` });
+          } else if (tool.name === "agent_plan_mode_respond" /* PLAN_MODE */ || tool.name === "agent_act_mode_respond" /* ACT_MODE */) {
+            toolResults.push({ tool, result: `Mode switch acknowledged.` });
+          } else if (tool.name === "agent_new_rule" /* NEW_RULE */) {
+            toolResults.push({ tool, result: `Rule recorded in current context.` });
+          } else if (tool.name === "agent_new_task" /* NEW_TASK */) {
+            toolResults.push({ tool, result: `New task request received. Terminating current task.` });
+            this.setState("finished" /* FINISHED */);
+            break;
+          } else if (tool.name === "agent_load_skill" /* LOAD_SKILL */) {
+            const skillName = tool.params.skill_name || tool.params.skill;
+            if (!skillName) {
+              toolResults.push({ tool, result: `"Error: Missing required parameter 'skill_name'. Please provide the name of the skill to activate."` });
+            } else {
+              const skillDir = this.skillDir;
+              const skillFilePath = this.runtime.path.join(skillDir, skillName, "SKILL.md");
+              try {
+                const fileExists = await this.runtime.fs.fileExists(skillFilePath);
+                if (!fileExists) {
+                  toolResults.push({ tool, result: `Error: Skill "${skillName}" not found at ${skillFilePath}.` });
+                } else {
+                  const content = await this.runtime.fs.readFile(skillFilePath);
+                  toolResults.push({
+                    tool,
+                    result: `# Skill "${skillName}" is now active
+
+${content}
+
+---
+IMPORTANT: The skill is now loaded. Do NOT call agent_load_skill again for this task. Simply follow the instructions above to complete the user's request.`
+                  });
+                }
+              } catch (err) {
+                toolResults.push({ tool, result: `Error loading skill "${skillName}": ${err.message}` });
+              }
+            }
+          } else if (tool.name === "agent_browser_action" /* BROWSER */ || tool.name === "agent_web_search" /* WEB_SEARCH */ || tool.name === "agent_apply_patch" /* APPLY_PATCH */) {
+            toolResults.push({ tool, result: `This tool requires specific host integration. If you see this, the host environment has not implemented it yet.` });
+          } else if (tool.name === "agent_condense" /* CONDENSE */ || tool.name === "agent_summarize_task" /* SUMMARIZE_TASK */ || tool.name === "agent_report_bug" /* REPORT_BUG */ || tool.name === "agent_generate_explanation" /* GENERATE_EXPLANATION */) {
+            toolResults.push({ tool, result: `Action logged successfully.` });
+          } else {
+            toolResults.push({ tool, result: `Executed by host or unsupported.` });
+          }
+        }
+        if (this.state === "thinking" /* THINKING */ && toolResults.length > 0) {
+          const toolResultsContext = toolResults.map((tr) => `<${TOOL_RESULT_BLOCK} tool_name="${tr.tool.name}">
+${typeof tr.result === "string" ? tr.result.trim() : JSON.stringify(tr.result)}
+</${TOOL_RESULT_BLOCK}>`).join("\n\n");
+          if (this.onStreamChunk) {
+            this.onStreamChunk({ type: "text", text: toolResultsContext });
+          }
+          await this.memory.appendMessage({
+            role: "user",
+            content: toolResultsContext
+          });
+        }
+      }
+    }
+  }
+  /**
+   * 简单的 Diff 解析与替换辅助方法
+   */
+  applyDiff(content, diff) {
+    const regex = /-------\s*SEARCH\r?\n(.*?)\r?\n=======\r?\n(.*?)\r?\n\+\+\+\+\+\+\+\s*REPLACE/gs;
+    let newContent = content;
+    let match;
+    let matchCount = 0;
+    while ((match = regex.exec(diff)) !== null) {
+      matchCount++;
+      const searchBlock = match[1];
+      const replaceBlock = match[2];
+      const idx = newContent.indexOf(searchBlock);
+      if (idx !== -1) {
+        newContent = newContent.substring(0, idx) + replaceBlock + newContent.substring(idx + searchBlock.length);
+      } else {
+        throw new Error(`Search block not found in file:
+${searchBlock.substring(0, 100)}...`);
+      }
+    }
+    if (matchCount === 0) {
+      throw new Error(`No valid SEARCH/REPLACE blocks found in the diff.`);
+    }
+    return newContent;
+  }
+  /**
+   * 恢复被中断的循环（例如等待用户输入/确认后继续）
+   */
+  async resume(userInput) {
+    if (userInput) {
+      await this.memory.appendMessage({
+        role: "user",
+        content: userInput
+      });
+    }
+    this.setState("thinking" /* THINKING */);
+    await this.loop();
+  }
+  async appendHistory(history) {
+    for (const message of history) {
+      await this.memory.appendMessage(message);
+    }
+  }
+  async getHistory() {
+    return this.memory.getHistory();
+  }
+};
+var WebApiHandler = class {
+  config;
+  conversationId;
+  constructor(config) {
+    this.config = config;
+  }
+  getModelInfo() {
+    return {
+      providerId: this.config.providerId || "openai-compatible",
+      modelId: this.config.modelId
+    };
+  }
+  async *createMessage(systemPrompt, messages) {
+    let model;
+    if (this.config.providerId === "dify") {
+      const customDify = createDifyProvider({
+        baseURL: this.config.baseURL,
+        headers: this.config.headers,
+        fetch: this.config.fetch
+      });
+      model = customDify(this.config.modelId || "", {
+        apiKey: this.config.apiKey,
+        responseMode: "streaming"
+      });
+    } else {
+      const customOpenAI = createOpenAI({
+        baseURL: this.config.baseURL,
+        apiKey: this.config.apiKey,
+        headers: this.config.headers,
+        fetch: this.config.fetch
+      });
+      model = customOpenAI(this.config.modelId || "");
+    }
+    try {
+      const streamOptions = {
+        model,
+        headers: {
+          ...this.config.headers
+        },
+        allowSystemInMessages: true
+      };
+      if (this.config.providerId === "dify" && this.conversationId) {
+        streamOptions.headers["chat-id"] = this.conversationId;
+      }
+      streamOptions.messages = [
+        { role: "system", content: systemPrompt },
+        ...messages.map((m) => ({
+          role: m.role === "system" ? "system" : m.role === "user" ? "user" : "assistant",
+          content: m.content
+        }))
+      ];
+      const { fullStream } = streamText(streamOptions);
+      for await (const part of fullStream) {
+        if (this.config.providerId === "dify" && !this.conversationId && part?.providerMetadata?.difyWorkflowData?.conversationId || part?.providerMetadata?.dify?.conversationId) {
+          this.conversationId = part.providerMetadata?.difyWorkflowData?.conversationId || part.providerMetadata?.dify?.conversationId;
+        }
+        if (part.type === "text-delta") {
+          yield {
+            type: "text",
+            text: part.textDelta || part.text || ""
+          };
+        } else if (part.type === "finish") {
+          yield {
+            type: "usage",
+            usage: {
+              inputTokens: part.usage?.promptTokens || part.totalUsage?.promptTokens || part.totalUsage?.inputTokens || 0,
+              outputTokens: part.usage?.completionTokens || part.totalUsage?.completionTokens || part.totalUsage?.outputTokens || 0
+            }
+          };
+        } else if (part.type === "error") {
+          yield {
+            type: "error",
+            error: part.error
+          };
+        }
+      }
+    } catch (err) {
+      yield {
+        type: "error",
+        error: err
+      };
+    }
+  }
+};
+
+// src/prompt/WebPromptManager.ts
+var WebPromptManager = class {
+  async getSystemPrompt(context) {
+    let prompt = `# Role
+you are a highly skilled software engineer AI running in a Node.js/Desktop environment.
+You have FULL access to the local file system and can execute arbitrary shell commands on the user's machine.
+
+# Capabilities & Rules
+1. **File System**: You can read, write, create, and delete files/directories anywhere accessible to the user process. Always use absolute paths or paths relative to the Current Working Directory.
+2. **Terminal**: You can execute system commands (e.g., git, npm, python, file manipulation) directly.
+3. **Context**: You are running on a real machine, meaning you have access to real environment variables, local servers (localhost), and local network.
+4. **Destructive Actions**: Be extremely careful when executing commands that modify system state or delete files. Double-check paths and commands before execution.
+5. **Step-by-step**: Use tools one at a time. Do not assume the outcome of any tool use. Each step must be informed by the previous step's result.
+6. **Verification**: Always verify the result of your actions (e.g., run tests, compile code, list directories) before proceeding to the next step or completing the task.
+7. **Communication**: Be concise and technical. Formulate your output strictly according to the tools' XML specification.
+
+TOOL USE
+
+You have access to a set of tools that are executed upon the user's approval. You can use one tool per message, and will receive the result of that tool use in the user's response. You use tools step-by-step to accomplish a given task, with each tool use informed by the result of the previous tool use.
+
+# Tool Use Formatting
+
+Tool use is formatted using XML-style tags. The tool name is enclosed in opening and closing tags, and each parameter is similarly enclosed within its own set of tags. Here's the structure:
+
+<tool_name>
+<parameter1_name>value1</parameter1_name>
+<parameter2_name>value2</parameter2_name>
+...
+</tool_name>
+
+For example:
+
+<agent_read_file>
+<path>src/main.js</path>
+<task_progress>
+Checklist here (optional)
+</task_progress>
+</agent_read_file>
+
+Always adhere to this format for the tool use to ensure proper parsing and execution.
+`;
+    const skillsPrompt = await this.getSkillsPrompt(context.skills);
+    if (skillsPrompt) {
+      prompt += `
+${skillsPrompt}
+`;
+    }
+    prompt += `
+${this.getToolInstructions(context)}
+`;
+    const envPrompt = this.getEnvironmentInfoPrompt(context);
+    if (envPrompt) {
+      prompt += `
+${envPrompt}
+`;
+    }
+    if (context.customInstructions) {
+      prompt += `
+# User Custom Instructions
+${context.customInstructions}
+`;
+    }
+    return prompt;
+  }
+  getEnvironmentInfoPrompt(context) {
+    let environmentPrompt = `<environment_details>
+  # Environment Info
+- **Current Working Directory**: \`${context.cwd}\`
+- **Operating System**: \`${context.os}\`
+`;
+    if (context.shell) {
+      environmentPrompt += `- **Current Shell**: \`${context.shell}\`
+`;
+    }
+    return environmentPrompt + `
+</environment_details>`;
+  }
+  async getSkillsPrompt(skills) {
+    if (!skills || skills.length === 0) return "";
+    try {
+      let prompt = `# Available Skills
+`;
+      prompt += `You have access to the following skills. You can use the \`agent_load_skill\` tool to load any of them when needed.
+`;
+      for (const skill of skills) {
+        if (skill && skill.name && skill.description) {
+          prompt += `- **${skill.name}**: ${skill.description}
+`;
+        }
+      }
+      return prompt;
+    } catch (e) {
+      return "";
+    }
+  }
+  getToolInstructions(context) {
+    const allowDefaultTools = context.allowDefaultTools;
+    const customTools = context.customTools || [];
+    let useDefaultTools = [...defaultTools];
+    if (allowDefaultTools) {
+      useDefaultTools = defaultTools.filter((tool) => allowDefaultTools.includes(tool.name));
+    }
+    return `# Available Tools
+You can use the following tools by formatting your output as XML blocks. Only use ONE tool per message, and ALWAYS wait for the user's response with the execution result before proceeding.
+
+${[...useDefaultTools, ...customTools].map((tool) => {
+      return `### ${tool.name}
+Description: ${tool.description}
+Parameters: 
+${Object.entries(tool.params).map(([name, description]) => `- ${name}: ${description.replaceAll("${context.cwd}", context.cwd)}`).join("\n")}
+- task_progress: (optional) A checklist showing task progress after this tool use is completed. The task_progress parameter must be included as a separate parameter inside of the parent tool call, it must be separate from other parameters such as content, arguments, etc. (See 'UPDATING TASK PROGRESS' section for more details)
+Usage: 
+<${tool.name}>
+${Object.entries(tool.params).map(([name, description]) => `<${name}>${description.replaceAll("${context.cwd}", context.cwd)}</${name}>`).join("\n")}
+<task_progress>Checklist here (optional)</task_progress>
+</${tool.name}>
+`;
+    }).join("\n")}
+
+# Tool Use Examples
+${useDefaultTools.filter((item) => Boolean(item.example)).map((item) => item.example).join("\n")}}
+
+# Tool Use Guidelines
+
+1. In <thinking> tags, assess what information you already have and what information you need to proceed with the task.
+2. Choose the most appropriate tool based on the task and the tool descriptions provided. Assess if you need additional information to proceed, and which of the available tools would be most effective for gathering this information. For example using the list_files tool is more effective than running a command like \`ls\` in the terminal. It's critical that you think about each available tool and use the one that best fits the current step in the task.
+3. If multiple actions are needed, use one tool at a time per message to accomplish the task iteratively, with each tool use being informed by the result of the previous tool use. Do not assume the outcome of any tool use. Each step must be informed by the previous step's result.
+4. Formulate your tool use using the XML format specified for each tool.
+5. After each tool use, the user will respond with the result of that tool use. This result will provide you with the necessary information to continue your task or make further decisions. This response may include:
+  - Information about whether the tool succeeded or failed, along with any reasons for failure.
+  - Linter errors that may have arisen due to the changes you made, which you'll need to address.
+  - New terminal output in reaction to the changes, which you may need to consider or act upon.
+  - Any other relevant feedback or information related to the tool use.
+6. ALWAYS wait for user confirmation after each tool use before proceeding. Never assume the success of a tool use without explicit confirmation of the result from the user.
+
+It is crucial to proceed step-by-step, waiting for the user's message after each tool use before moving forward with the task. This approach allows you to:
+1. Confirm the success of each step before proceeding.
+2. Address any issues or errors that arise immediately.
+3. Adapt your approach based on new information or unexpected results.
+4. Ensure that each action builds correctly on the previous ones.
+
+By waiting for and carefully considering the user's response after each tool use, you can react accordingly and make informed decisions about how to proceed with the task. This iterative process helps ensure the overall success and accuracy of your work.
+
+====
+
+UPDATING TASK PROGRESS
+
+You can track and communicate your progress on the overall task using the task_progress parameter supported by every tool call. Using task_progress ensures you remain on task, and stay focused on completing the user's objective. This parameter can be used in any mode, and with any tool call.
+
+- When switching from PLAN MODE to ACT MODE, you must create a comprehensive todo list for the task using the task_progress parameter
+- Todo list updates should be done silently using the task_progress parameter - do not announce these updates to the user
+- Use standard Markdown checklist format: "- [ ]" for incomplete items and "- [x]" for completed items
+- Keep items focused on meaningful progress milestones rather than minor technical details. The checklist should not be so granular that minor implementation details clutter the progress tracking.
+- For simple tasks, short checklists with even a single item are acceptable. For complex tasks, avoid making the checklist too long or verbose.
+- If you are creating this checklist for the first time, and the tool use completes the first step in the checklist, make sure to mark it as completed in your task_progress parameter.
+- Provide the whole checklist of steps you intend to complete in the task, and keep the checkboxes updated as you make progress. It's okay to rewrite this checklist as needed if it becomes invalid due to scope changes or new information.
+- If a checklist is being used, be sure to update it any time a step has been completed.
+- The system will automatically include todo list context in your prompts when appropriate - these reminders are important.
+
+Example:
+<agent_execute_command>
+<command>npm install react</command>
+<requires_approval>false</requires_approval>
+<task_progress>
+- [x] Set up project structure
+- [x] Install dependencies
+- [ ] Create components
+- [ ] Test application
+</task_progress>
+</agent_execute_command>
+
+====
+
+EDITING FILES
+
+You have access to two tools for working with files: **agent_write_to_file** and **agent_replace_in_file**. Understanding their roles and selecting the right one for the job will help ensure efficient and accurate modifications.
+
+# agent_write_to_file
+
+## Purpose
+
+- Create a new file, or overwrite the entire contents of an existing file.
+
+## When to Use
+
+- Initial file creation, such as when scaffolding a new project.  
+- Overwriting large boilerplate files where you want to replace the entire content at once.
+- When the complexity or number of changes would make agent_replace_in_file unwieldy or error-prone.
+- When you need to completely restructure a file's content or change its fundamental organization.
+
+## Important Considerations
+
+- Using agent_write_to_file requires providing the file's complete final content.  
+- If you only need to make small changes to an existing file, consider using agent_replace_in_file instead to avoid unnecessarily rewriting the entire file.
+- While agent_write_to_file should not be your default choice, don't hesitate to use it when the situation truly calls for it.
+
+# agent_replace_in_file
+
+## Purpose
+
+- Make targeted edits to specific parts of an existing file without overwriting the entire file.
+
+## When to Use
+
+- Small, localized changes like updating a few lines, function implementations, changing variable names, modifying a section of text, etc.
+- Targeted improvements where only specific portions of the file's content needs to be altered.
+- Especially useful for long files where much of the file will remain unchanged.
+
+## Advantages
+
+- More efficient for minor edits, since you don't need to supply the entire file content.  
+- Reduces the chance of errors that can occur when overwriting large files.
+
+# Choosing the Appropriate Tool
+
+- **Default to agent_replace_in_file** for most changes. It's the safer, more precise option that minimizes potential issues.
+- **Use agent_write_to_file** when:
+  - Creating new files
+  - The changes are so extensive that using agent_replace_in_file would be more complex or risky
+  - You need to completely reorganize or restructure a file
+  - The file is relatively small and the changes affect most of its content
+  - You're generating boilerplate or template files
+
+# Auto-formatting Considerations
+
+- After using either agent_write_to_file or agent_replace_in_file, the user's editor may automatically format the file
+- This auto-formatting may modify the file contents, for example:
+  - Breaking single lines into multiple lines
+  - Adjusting indentation to match project style (e.g. 2 spaces vs 4 spaces vs tabs)
+  - Converting single quotes to double quotes (or vice versa based on project preferences)
+  - Organizing imports (e.g. sorting, grouping by type)
+  - Adding/removing trailing commas in objects and arrays
+  - Enforcing consistent brace style (e.g. same-line vs new-line)
+  - Standardizing semicolon usage (adding or removing based on style)
+- The agent_write_to_file and agent_replace_in_file tool responses will include the final state of the file after any auto-formatting
+- Use this final state as your reference point for any subsequent edits. This is ESPECIALLY important when crafting SEARCH blocks for replace_in_file which require the content to match what's in the file exactly.
+
+# Workflow Tips
+
+1. Before editing, assess the scope of your changes and decide which tool to use.
+2. For targeted edits, apply agent_replace_in_file with carefully crafted SEARCH/REPLACE blocks. If you need multiple changes, you can stack multiple SEARCH/REPLACE blocks within a single agent_replace_in_file call.
+3. IMPORTANT: When you determine that you need to make several changes to the same file, prefer to use a single replace_in_file call with multiple SEARCH/REPLACE blocks. DO NOT prefer to make multiple successive replace_in_file calls for the same file. For example, if you were to add a component to a file, you would use a single replace_in_file call with a SEARCH/REPLACE block to add the import statement and another SEARCH/REPLACE block to add the component usage, rather than making one replace_in_file call for the import statement and then another separate replace_in_file call for the component usage.
+4. For major overhauls or initial file creation, rely on agent_write_to_file.
+5. Once the file has been edited with either agent_write_to_file or agent_replace_in_file, the system will provide you with the final state of the modified file. Use this updated content as the reference point for any subsequent SEARCH/REPLACE operations, since it reflects any auto-formatting or user-applied changes.  
+By thoughtfully selecting between agent_write_to_file and agent_replace_in_file, you can make your file editing process smoother, safer, and more efficient.
+
+====
+`;
+  }
+  getNoUseToolInstructions(context) {
+    return `[ERROR] You did not use a tool in your previous response! Please retry with a tool use.
+
+# Reminder: Instructions for Tool Use
+Tool uses are formatted using XML-style tags. The tool name is enclosed in opening and closing tags, and each parameter is similarly enclosed within its own set of tags. Here's the structure:
+<tool_name>
+<parameter1_name>value1</parameter1_name>
+<parameter2_name>value2</parameter2_name>
+...
+</tool_name>
+For example:
+<agent_attempt_completion>
+<result>
+I have completed the task...
+</result>
+</agent_attempt_completion>
+Always adhere to this format for all tool uses to ensure proper parsing and execution.
+
+# Next Steps
+
+If you have completed the user's task, use the attempt_completion tool. 
+If you require additional information from the user, use the ask_followup_question tool. 
+Otherwise, if you have not completed the task and do not need additional information, then proceed with the next step of the task. 
+(This is an automated message, so do not respond to it conversationally.)
+${this?.getEnvironmentInfoPrompt?.(context)}`;
+  }
+};
+
+// src/memory/WebMemoryManager.ts
+var WebMemoryManager = class {
+  storageKey;
+  maxMessages;
+  inMemoryFallback = [];
+  /**
+   * @param storageKey SessionStorage 中的键名
+   * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
+   */
+  constructor(storageKey = "cline_agent_memory", maxMessages = 150) {
+    this.storageKey = storageKey;
+    this.maxMessages = maxMessages;
+  }
+  isStorageAvailable() {
+    try {
+      return typeof window !== "undefined" && typeof window.sessionStorage !== "undefined";
+    } catch {
+      return false;
+    }
+  }
+  readMessages() {
+    if (this.isStorageAvailable()) {
+      const data = window.sessionStorage.getItem(this.storageKey);
+      if (data) {
+        try {
+          return JSON.parse(data);
+        } catch {
+          return [];
+        }
+      }
+      return [];
+    }
+    return this.inMemoryFallback;
+  }
+  writeMessages(messages) {
+    if (this.isStorageAvailable()) {
+      window.sessionStorage.setItem(this.storageKey, JSON.stringify(messages));
+    } else {
+      this.inMemoryFallback = messages;
+    }
+  }
+  async getHistory() {
+    return Promise.resolve(this.readMessages());
+  }
+  async appendMessage(message) {
+    const messages = this.readMessages();
+    messages.push(message);
+    this.writeMessages(messages);
+    await this.condenseHistory();
+  }
+  async condenseHistory() {
+    const messages = this.readMessages();
+    if (messages.length > this.maxMessages) {
+      const firstMessage = messages[0];
+      const isFirstSystem = firstMessage && firstMessage.role === "system";
+      const sliceCount = messages.length - this.maxMessages;
+      let condensed;
+      if (isFirstSystem) {
+        condensed = [firstMessage, ...messages.slice(sliceCount + 1)];
+      } else {
+        condensed = messages.slice(sliceCount);
+      }
+      this.writeMessages(condensed);
+    }
+    return Promise.resolve();
+  }
+  async clear() {
+    this.writeMessages([]);
+    return Promise.resolve();
+  }
+};
+
+// src/index.ts
+var VERSION = "0.1.0";
+globalThis.AI_SDK_LOG_WARNINGS = false;
+
+// src/mcp/WebMcpManager.ts
+var WebMcpManager = class {
+  constructor() {
+    console.warn("WebMcpManager is initialized as an empty stub. MCP relies on Node.js processes or a proxy backend.");
+  }
+  getServers() {
+    return [];
+  }
+  async getTools() {
+    return [];
+  }
+  async callTool(serverName, toolName, args) {
+    return {
+      content: [{ type: "text", text: `MCP is not supported in the pure Web environment.` }],
+      isError: true
+    };
+  }
+  async readResource(serverName, uri) {
+    throw new Error("MCP readResource is not supported in the pure Web environment.");
+  }
+};
+
+// src/runtime/webRuntime.ts
+var DefaultWebRuntime = class {
+  vol = new Volume();
+  memfs = createFsFromVolume(this.vol).promises;
+  fs = {
+    readFile: async (filepath) => {
+      const content = await this.memfs.readFile(filepath, "utf-8");
+      return content.toString();
+    },
+    writeFile: async (filepath, content) => {
+      const dir = filepath.substring(0, filepath.lastIndexOf("/"));
+      if (dir && dir !== filepath) {
+        await this.memfs.mkdir(dir, { recursive: true });
+      }
+      await this.memfs.writeFile(filepath, content);
+    },
+    deleteFile: (filepath) => this.memfs.unlink(filepath),
+    deleteDirectory: (dirpath) => this.memfs.rm(dirpath, { recursive: true, force: true }),
+    fileExists: async (filepath) => {
+      try {
+        await this.memfs.access(filepath);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    readDir: (dirpath) => {
+      return this.memfs.readdir(dirpath, { withFileTypes: true });
+    },
+    mkdir: async (dirpath) => {
+      await this.memfs.mkdir(dirpath, { recursive: true });
+    }
+  };
+  path = {
+    join: (...paths) => path.join(...paths)
+  };
+  env = {
+    get: (key) => void 0,
+    // 浏览器环境中无系统环境变量
+    cwd: () => "/workspace",
+    osInfo: () => typeof navigator !== "undefined" ? navigator.userAgent : "Web Browser",
+    shell: () => ""
+    // 浏览器环境中无真实 shell
+  };
+  terminal = {
+    execCommand: async (command, options) => {
+      return {
+        stdout: `[Mock] Command '${command}' executed in browser sandbox.`,
+        stderr: "",
+        exitCode: 0
+      };
+    }
+  };
+};
+function createWebAgent(options) {
+  const runtime = new DefaultWebRuntime();
+  const api = new WebApiHandler(options.apiConfig);
+  const promptManager = new WebPromptManager();
+  const memory = new WebMemoryManager(options.storageKey || "cline_agent_memory");
+  const customTools = options.customTools || [];
+  const customToolNames = new Set(customTools.map((t) => t.name));
+  const agent = new ClineAgent({
+    runtime,
+    api,
+    promptManager,
+    memory,
+    customTools,
+    allowDefaultTools: options.allowDefaultTools,
+    maxLoopCount: options.maxLoopCount,
+    customInstructions: options.customInstructions
+  });
+  agent.onToolCall = async (tool) => {
+    if (customToolNames.has(tool.name)) {
+      const customTool = customTools.find((t) => t.name === tool.name);
+      if (customTool.onCall) {
+        return customTool.onCall(tool.params);
+      }
+      return `Error: Custom tool "${tool.name}" does not have an onCall method.`;
+    }
+  };
+  return agent;
+}
+
+export { AgentDefaultTool, AgentState, ClineAgent, DefaultWebRuntime, READ_ONLY_TOOLS, TOOL_RESULT_BLOCK, VERSION, WebMcpManager, createWebAgent, defaultTools, getToolUseNames, parseAssistantMessageV2, setDynamicToolUseNames, toolParamNames, toolUseNames };
+//# sourceMappingURL=webRuntime.mjs.map
+//# sourceMappingURL=webRuntime.mjs.map