@amical/aiagent-sdk 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,640 @@
+/**
+ * IAgentRuntime 抽象了所有与特定宿主环境（Node.js, Web, VS Code 等）相关的能力。
+ * 通过注入 IAgentRuntime，Agent 的核心逻辑可以运行在任何平台上。
+ */
+interface IAgentRuntime {
+    /**
+     * 文件系统相关操作
+     */
+    fs: {
+        readFile(path: string): Promise<string>;
+        writeFile(path: string, content: string): Promise<void>;
+        deleteFile(path: string): Promise<void>;
+        deleteDirectory(path: string): Promise<void>;
+        fileExists(path: string): Promise<boolean>;
+        readDir(path: string): Promise<any[]>;
+        mkdir(path: string): Promise<void>;
+        /**
+         * 跨文件正则搜索
+         * @param path 搜索目录
+         * @param regex 正则表达式字符串
+         * @param filePattern (可选) 文件名匹配模式，比如 '*.ts'
+         * @returns 返回格式化后的包含上下文的搜索结果字符串
+         */
+        searchFiles?(path: string, regex: string, filePattern?: string): Promise<string>;
+    };
+    path: {
+        join(...paths: string[]): string;
+    };
+    /**
+     * 环境变量和系统信息
+     */
+    env: {
+        get(key: string): string | undefined;
+        cwd(): string;
+        osInfo(): string;
+        shell(): string;
+    };
+    /**
+     * 终端/命令行相关操作
+     */
+    terminal: {
+        execCommand(command: string, options?: {
+            cwd?: string;
+        }): Promise<{
+            stdout: string;
+            stderr: string;
+            exitCode: number;
+        }>;
+    };
+}
+
+declare enum AgentDefaultTool {
+    ASK = "agent_ask_followup_question",
+    ATTEMPT = "agent_attempt_completion",
+    BASH = "agent_execute_command",
+    FILE_EDIT = "agent_replace_in_file",
+    FILE_READ = "agent_read_file",
+    FILE_NEW = "agent_write_to_file",
+    FILE_DELETE = "agent_delete_file",
+    DIR_DELETE = "agent_delete_directory",
+    SEARCH = "agent_search_files",
+    LIST_FILES = "agent_list_files",
+    LIST_CODE_DEF = "agent_list_code_definition_names",
+    BROWSER = "agent_browser_action",
+    MCP_USE = "agent_use_mcp_tool",
+    MCP_ACCESS = "agent_access_mcp_resource",
+    MCP_DOCS = "agent_load_mcp_documentation",
+    NEW_TASK = "agent_new_task",
+    PLAN_MODE = "agent_plan_mode_respond",
+    ACT_MODE = "agent_act_mode_respond",
+    TODO = "agent_focus_chain",
+    WEB_FETCH = "agent_web_fetch",
+    WEB_SEARCH = "agent_web_search",
+    CONDENSE = "agent_condense",
+    SUMMARIZE_TASK = "agent_summarize_task",
+    REPORT_BUG = "agent_report_bug",
+    NEW_RULE = "agent_new_rule",
+    APPLY_PATCH = "agent_apply_patch",
+    GENERATE_EXPLANATION = "agent_generate_explanation",
+    LOAD_SKILL = "agent_load_skill",
+    USE_SUBAGENTS = "agent_use_subagents"
+}
+declare const TOOL_RESULT_BLOCK = "tool_call_result";
+declare const defaultTools: readonly [{
+    readonly name: AgentDefaultTool.ASK;
+    readonly description: "Ask the user a clarifying question if more information is needed.";
+    readonly params: {
+        readonly question: "The question to ask the user.";
+    };
+}, {
+    readonly name: AgentDefaultTool.ATTEMPT;
+    readonly 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.";
+    readonly params: {
+        readonly result: "(required) The result of the tool use. This should be a clear, specific description of the result.";
+    };
+    readonly example: "## Example: agent_attempt_completion\n<agent_attempt_completion>\n<result>final result or message</result>\n<task_progress>\n- [x] Set up project structure\n- [x] Install dependencies\n- [x] Run command to start server\n- [x] Test application\n</task_progress>\n</agent_attempt_completion>";
+}, {
+    readonly name: AgentDefaultTool.BASH;
+    readonly 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.";
+    readonly params: {
+        readonly 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.";
+    };
+    readonly example: "## Example: Requesting to execute a command\n\n<agent_execute_command>\n<command>npm run dev</command>\n<requires_approval>false</requires_approval>\n<task_progress>\n- [x] Set up project structure\n- [x] Install dependencies\n- [ ] Run command to start server\n- [ ] Test application\n</task_progress>\n</agent_execute_command>";
+}, {
+    readonly name: AgentDefaultTool.FILE_EDIT;
+    readonly description: "Replace specific content in a file using a search/replace diff block.";
+    readonly params: {
+        readonly path: "(required) The absolute or relative file path to modify.";
+        readonly diff: "(required) The diff content to apply.";
+    };
+    readonly example: "## Example: Requesting to make targeted edits to a file\n\n<agent_replace_in_file>\n<path>src/components/App.tsx</path>\n<diff>\n------- SEARCH\nimport React from 'react';\n=======\nimport React, { useState } from 'react';\n+++++++ REPLACE\n\n------- SEARCH\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\n=======\n+++++++ REPLACE\n\n------- SEARCH\nreturn (\n  <div>\n=======\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\nreturn (\n  <div>\n+++++++ REPLACE\n</diff>\n<task_progress>\n- [x] Set up project structure\n- [x] Install dependencies\n- [ ] Create components\n- [ ] Test application\n</task_progress>\n</agent_replace_in_file>";
+}, {
+    readonly name: AgentDefaultTool.FILE_READ;
+    readonly description: "Read the contents of a specific file.";
+    readonly params: {
+        readonly path: "(required) The absolute or relative file path to read.";
+    };
+}, {
+    readonly name: AgentDefaultTool.FILE_NEW;
+    readonly description: "Create or overwrite a file with new content.";
+    readonly params: {
+        readonly 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.";
+        readonly content: "(required) The content to write to the file.";
+    };
+    readonly example: "## Example: Requesting to create a new file\n\n<agent_write_to_file>\n<path>src/frontend-config.json</path>\n<content>\n{\n  \"apiEndpoint\": \"https://api.example.com\",\n  \"theme\": {\n    \"primaryColor\": \"#007bff\",\n    \"secondaryColor\": \"#6c757d\",\n    \"fontFamily\": \"Arial, sans-serif\"\n  },\n  \"features\": {\n    \"darkMode\": true,\n    \"notifications\": true,\n    \"analytics\": false\n  },\n  \"version\": \"1.0.0\"\n}\n</content>\n<task_progress>\n- [x] Set up project structure\n- [x] Install dependencies\n- [x] Create components\n- [ ] Test application\n</task_progress>\n</agent_write_to_file>";
+}, {
+    readonly name: AgentDefaultTool.FILE_DELETE;
+    readonly description: "Delete a file.";
+    readonly params: {
+        readonly 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.";
+    };
+}, {
+    readonly name: AgentDefaultTool.DIR_DELETE;
+    readonly description: "Delete a directory.";
+    readonly params: {
+        readonly 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.";
+    };
+}, {
+    readonly name: AgentDefaultTool.SEARCH;
+    readonly description: "Search for files in a directory that match a regex pattern or glob pattern.";
+    readonly params: {
+        readonly path: "(required) The absolute or relative directory path to search.";
+        readonly regex: "(required) The regex pattern to match files against.";
+        readonly file_pattern: "(optional) glob pattern like *.ts.";
+    };
+}, {
+    readonly name: AgentDefaultTool.LIST_FILES;
+    readonly description: "List all files in a directory.";
+    readonly params: {
+        readonly path: "(required) The absolute or relative directory path to list.";
+    };
+}, {
+    readonly name: AgentDefaultTool.NEW_TASK;
+    readonly description: "Create a new task with a given context.";
+    readonly params: {
+        readonly context: "(required) The context of the new task.";
+    };
+    readonly example: "## Example: Creating a new task\n<agent_new_task>\n<context>\n1. Current Work:\n   [Detailed description]\n\n2. Key Technical Concepts:\n   - [Concept 1]\n   - [Concept 2]\n   - [...]\n\n3. Relevant Files and Code:\n   - [File Name 1]\n      - [Summary of why this file is important]\n      - [Summary of the changes made to this file, if any]\n      - [Important Code Snippet]\n   - [File Name 2]\n      - [Important Code Snippet]\n   - [...]\n\n4. Problem Solving:\n   [Detailed description]\n\n5. Pending Tasks and Next Steps:\n   - [Task 1 details & next steps]\n   - [Task 2 details & next steps]\n   - [...]\n</context>\n</agent_new_task>";
+}, {
+    readonly name: AgentDefaultTool.LOAD_SKILL;
+    readonly 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.";
+    readonly params: {
+        readonly skill_name: "(required) The name of the skill to load.";
+    };
+}];
+declare const toolUseNames: AgentDefaultTool[];
+declare function setDynamicToolUseNames(namespace: string, names: string[]): void;
+declare function getToolUseNames(): string[];
+declare const READ_ONLY_TOOLS: readonly [AgentDefaultTool.LIST_FILES, AgentDefaultTool.FILE_READ, AgentDefaultTool.SEARCH, AgentDefaultTool.LIST_CODE_DEF, AgentDefaultTool.BROWSER, AgentDefaultTool.ASK, AgentDefaultTool.WEB_SEARCH, AgentDefaultTool.WEB_FETCH, AgentDefaultTool.LOAD_SKILL, AgentDefaultTool.USE_SUBAGENTS];
+
+/**
+ * @description **Version 2**
+ * Parses an assistant message string potentially containing mixed text and tool usage blocks
+ * marked with XML-like tags into an array of structured content objects.
+ *
+ * This version aims for efficiency by avoiding the character-by-character accumulator of V1.
+ * It iterates through the string using an index `i`. At each position, it checks if the substring
+ * *ending* at `i` matches any known opening or closing tags for tools or parameters using `startsWith`
+ * with an offset.
+ * It uses pre-computed Maps (`toolUseOpenTags`, `toolParamOpenTags`) for quick tag lookups.
+ * State is managed using indices (`currentTextContentStart`, `currentToolUseStart`, `currentParamValueStart`)
+ * pointing to the start of the current block within the original `assistantMessage` string.
+ * Slicing is used to extract content only when a block (text, parameter, or tool use) is completed.
+ * Special handling for `write_to_file` and `new_rule` content parameters is included, using `indexOf`
+ * and `lastIndexOf` on the relevant slice to handle potentially nested closing tags.
+ * If the input string ends mid-block, the last open block is added and marked as partial.
+ *
+ * @param assistantMessage The raw string output from the assistant.
+ * @returns An array of `AssistantMessageContent` objects, which can be `TextContent` or `ToolUse`.
+ *          Blocks that were not fully closed by the end of the input string will have their `partial` flag set to `true`.
+ */
+declare function parseAssistantMessageV2(assistantMessage: string, toolParamNames: any): AssistantMessageContent[];
+
+type AssistantMessageContent = TextStreamContent | ToolUse | ReasoningStreamContent;
+
+interface TextStreamContent {
+    type: "text";
+    content: string;
+    partial: boolean;
+}
+declare const toolParamNames: readonly ["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"];
+type ToolParamName = (typeof toolParamNames)[number];
+interface ToolUse {
+    type: "tool_use";
+    name: AgentDefaultTool | string;
+    params: Partial<Record<ToolParamName, string>>;
+    partial: boolean;
+    /**
+     * Whether this tool use was initiated by a native tool call
+     */
+    isNativeToolCall?: boolean;
+    /**
+     * The call / response ID this tool use is associated with.
+     */
+    call_id?: string;
+    /**
+     * Thought signature associated with this tool use, used by Gemini
+     */
+    signature?: string;
+}
+interface ReasoningStreamContent {
+    type: "reasoning";
+    /**
+     * The reasoning text generated by the model.
+     * Redacted reasoning block will have this field set to "[REDACTED]" or an empty string.
+     */
+    reasoning: string;
+    /**
+     * openrouter has various properties that we can pass back unmodified in api requests to preserve reasoning traces
+     */
+    details?: any;
+    /**
+     * It's used when sending the thinking block back to the  API.
+     * API expects this in completed form, not as array of deltas.
+     */
+    signature?: string;
+    /**
+     * whether this reasoning block has been redacted
+     */
+    redacted?: boolean;
+    /**
+     * redacted data
+     */
+    data?: string;
+    /**
+     * Indicates whether this is a partial reasoning block
+     */
+    partial: boolean;
+}
+
+declare class NodePromptManager implements IPromptManager {
+    getSystemPrompt(context: {
+        cwd: string;
+        os: string;
+        shell: string;
+        skills: any;
+        customInstructions?: string;
+        allowDefaultTools?: string[];
+        customTools?: any[];
+    }): Promise<string>;
+    getEnvironmentInfoPrompt(context: {
+        cwd: string;
+        os: string;
+        shell: string;
+    }): string;
+    getSkillsPrompt(skills: any[]): Promise<string>;
+    getToolInstructions(context: {
+        cwd: string;
+        os: string;
+        allowDefaultTools?: string[];
+        customTools?: any[];
+    }): string;
+    getNoUseToolInstructions(context: any): string;
+}
+
+declare class WebPromptManager implements IPromptManager {
+    getSystemPrompt(context: {
+        cwd: string;
+        os: string;
+        shell: string;
+        skills: any;
+        customInstructions?: string;
+        allowDefaultTools?: string[];
+        customTools?: any[];
+    }): Promise<string>;
+    getEnvironmentInfoPrompt(context: {
+        cwd: string;
+        os: string;
+        shell: string;
+    }): string;
+    getSkillsPrompt(skills: any[]): Promise<string>;
+    getToolInstructions(context: {
+        cwd: string;
+        os: string;
+        allowDefaultTools?: string[];
+        customTools?: any[];
+    }): string;
+    getNoUseToolInstructions(context: any): string;
+}
+
+/**
+ * 抽象的 System Prompt 管理器。
+ * 替代原始项目中复杂的 templates/variants，交由宿主自行提供或使用默认简单实现。
+ */
+interface IPromptManager {
+    /**
+     * 根据当前运行环境与动态参数，获取最终的系统提示词
+     */
+    getSystemPrompt(context: any): Promise<string>;
+    /**
+     * 获取特定工具或技能的指令文本
+     */
+    getToolInstructions?(context: any): string;
+    /**
+     * 获取环境信息提示词
+     */
+    getEnvironmentInfoPrompt?(context: any): string;
+    /**
+     * 获取未使用工具的错误提示词
+     */
+    getNoUseToolInstructions(context: any): string;
+}
+
+/**
+ * Node 端 MemoryManager 实现
+ * 将对话历史持久化到本地文件系统（JSON 格式）。
+ */
+declare class NodeMemoryManager implements IMemoryManager {
+    private filePath;
+    private maxMessages;
+    /**
+     * @param dbPath 存储历史记录的本地文件路径（例如：'./.cline_memory.json'）
+     * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
+     */
+    constructor(dbPath: string, maxMessages?: number);
+    private ensureFile;
+    private readMessages;
+    private writeMessages;
+    getHistory(): Promise<AgentMessage[]>;
+    appendMessage(message: AgentMessage): Promise<void>;
+    condenseHistory(): Promise<void>;
+    clear(): Promise<void>;
+}
+
+/**
+ * Web 端 MemoryManager 实现
+ * 使用 IndexedDB (通过封装) 或 LocalStorage / SessionStorage 来持久化对话历史。
+ * 此处提供一个基于 SessionStorage / 内存 回退的轻量实现。
+ */
+declare class WebMemoryManager implements IMemoryManager {
+    private storageKey;
+    private maxMessages;
+    private inMemoryFallback;
+    /**
+     * @param storageKey SessionStorage 中的键名
+     * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
+     */
+    constructor(storageKey?: string, maxMessages?: number);
+    private isStorageAvailable;
+    private readMessages;
+    private writeMessages;
+    getHistory(): Promise<AgentMessage[]>;
+    appendMessage(message: AgentMessage): Promise<void>;
+    condenseHistory(): Promise<void>;
+    clear(): Promise<void>;
+}
+
+/**
+ * 统一的消息结构（这里做简单抽象，实际使用可对齐 LLM API 标准结构）
+ */
+interface AgentMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string | any[];
+}
+/**
+ * 抽象的 Memory 管理器。
+ * 负责记录和截断对话历史，确保不超过 LLM Token 限制。
+ */
+interface IMemoryManager {
+    /**
+     * 获取当前所有对话历史
+     */
+    getHistory(): Promise<AgentMessage[]>;
+    /**
+     * 追加一条消息到历史中
+     */
+    appendMessage(message: AgentMessage): Promise<void>;
+    /**
+     * 截断或压缩过长历史
+     */
+    condenseHistory?(): Promise<void>;
+    /**
+     * 清空记忆
+     */
+    clear(): Promise<void>;
+}
+
+interface NodeApiHandlerConfig {
+    providerId?: string;
+    modelId?: string;
+    apiKey: string;
+    baseURL?: string;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+}
+/**
+ * Node 端的 LLM API 处理器 (已通过 Vercel AI SDK 重构)
+ * 支持灵活对接 OpenAI 及各类兼容 OpenAI 规范的平台 (DeepSeek, Dify 等)
+ */
+declare class NodeApiHandler implements IApiHandler {
+    private config;
+    private conversationId?;
+    constructor(config: NodeApiHandlerConfig);
+    getModelInfo(): ApiProviderInfo;
+    createMessage(systemPrompt: string, messages: AgentMessage[]): AsyncGenerator<ApiStreamChunk, void, unknown>;
+}
+
+interface WebApiHandlerConfig {
+    providerId?: string;
+    modelId?: string;
+    apiKey: string;
+    baseURL?: string;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+}
+/**
+ * Web 端的 LLM API 处理器 (已通过 Vercel AI SDK 重构)
+ * 支持灵活对接 OpenAI 及各类兼容 OpenAI 规范的平台 (DeepSeek, Dify 等)
+ * 由于 Vercel AI SDK 底层统一使用标准的 Web Fetch API，Web 端的逻辑可以做到与 Node 端完全一致。
+ */
+declare class WebApiHandler implements IApiHandler {
+    private config;
+    private conversationId?;
+    constructor(config: WebApiHandlerConfig);
+    getModelInfo(): ApiProviderInfo;
+    createMessage(systemPrompt: string, messages: AgentMessage[]): AsyncGenerator<ApiStreamChunk, void, unknown>;
+}
+
+/**
+ * 统一的 API 响应流数据块
+ */
+interface ApiStreamChunk {
+    type: "text" | "usage" | "error";
+    text?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    error?: Error;
+}
+/**
+ * 通用的 LLM 提供者信息
+ */
+interface ApiProviderInfo {
+    providerId: string;
+    modelId?: string;
+}
+/**
+ * 抽象的 LLM API 处理器接口。
+ * 宿主环境（VSCode/Web/Node CLI）可以选择注入 AnthropicSDK、OpenAISDK 或是 Fetch 调用实现。
+ */
+interface IApiHandler {
+    /**
+     * 发起一次到大模型的请求，返回一个可异步迭代的流。
+     */
+    createMessage(systemPrompt: string, messages: AgentMessage[]): AsyncGenerator<ApiStreamChunk, void, unknown>;
+    /**
+     * 获取当前配置的模型信息
+     */
+    getModelInfo(): ApiProviderInfo;
+}
+
+/**
+ * MCP Server 描述信息
+ */
+interface McpServerInfo {
+    name: string;
+    status: "connected" | "disconnected" | "connecting";
+    error?: string;
+}
+/**
+ * MCP 工具定义
+ */
+interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema: any;
+}
+/**
+ * MCP 工具调用结果
+ */
+interface McpToolCallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: any;
+    }>;
+    isError?: boolean;
+}
+/**
+ * 抽象的 MCP 管理器接口。
+ * 宿主环境（VSCode/Node）使用基于 StdIO 的 MCP SDK 实现，Web 环境可能使用 SSE 或其他代理机制实现。
+ * 通过注入 IMcpManager，Agent 可以无缝使用 MCP 提供的拓展工具。
+ */
+interface IMcpManager {
+    /**
+     * 获取所有连接的 MCP 服务器状态
+     */
+    getServers(): McpServerInfo[];
+    /**
+     * 获取所有可用的 MCP 工具
+     */
+    getTools(): Promise<McpTool[]>;
+    /**
+     * 调用特定的 MCP 工具
+     * @param serverName 提供该工具的服务器名称
+     * @param toolName 工具名称
+     * @param args 工具参数
+     */
+    callTool(serverName: string, toolName: string, args: any): Promise<McpToolCallResult>;
+    /**
+     * 读取 MCP 资源
+     */
+    readResource?(serverName: string, uri: string): Promise<any>;
+}
+
+/**
+ * Agent 初始化配置依赖
+ */
+interface AgentOptions {
+    runtime: IAgentRuntime;
+    api: IApiHandler;
+    promptManager: IPromptManager;
+    memory: IMemoryManager;
+    mcp?: IMcpManager;
+    customTools?: any[];
+    allowDefaultTools?: string[];
+    customInstructions?: string;
+    /** 最大循环次数，默认150 */
+    maxLoopCount?: number;
+}
+/**
+ * Agent 状态
+ */
+declare enum AgentState {
+    IDLE = "idle",
+    THINKING = "thinking",
+    WAITING_FOR_USER = "waiting_for_user",
+    FINISHED = "finished",
+    ERROR = "error"
+}
+/**
+ * ClineAgent 核心逻辑循环状态机
+ * 它独立于 VS Code 或 Node 环境，纯粹通过依赖注入的方式执行工作流。
+ */
+declare class ClineAgent {
+    private runtime;
+    private api;
+    private promptManager;
+    private memory;
+    private mcp?;
+    state: AgentState;
+    allToolParamNames: string[];
+    /** 循环计数器 */
+    private loopCount;
+    /** 最大循环次数 */
+    private maxLoopCount;
+    skillDir: string;
+    customTools: any[];
+    customToolNames: Set<string>;
+    allowDefaultTools?: string[];
+    customInstructions?: string;
+    sysPrompt?: string;
+    noUseTollSysPrompt?: string;
+    onStateChange?: (state: AgentState) => void;
+    onStreamChunk?: (chunk: ApiStreamChunk) => void;
+    onToolCall?: (tool: ToolUse) => Promise<any | void>;
+    constructor(options: AgentOptions);
+    private setState;
+    /**
+     * 获取当前 Agent 的系统提示词
+     * 如果 force 为 true，则强制重新获取系统提示词
+     */
+    getPrompt(force?: boolean): Promise<{
+        sysPrompt: string;
+        noUseTollSysPrompt: string;
+    }>;
+    /**
+     * 启动一个新的任务
+     */
+    startTask(taskDescription: AgentMessage['content']): Promise<void>;
+    private getSkills;
+    /**
+     * 核心任务循环
+     */
+    private loop;
+    /**
+     * 简单的 Diff 解析与替换辅助方法
+     */
+    private applyDiff;
+    /**
+     * 恢复被中断的循环（例如等待用户输入/确认后继续）
+     */
+    resume(userInput?: string): Promise<void>;
+    appendHistory(history: AgentMessage[]): Promise<void>;
+    getHistory(): Promise<AgentMessage[]>;
+}
+
+interface NodeAgentOptions {
+    apiConfig: NodeApiHandlerConfig;
+    dbPath?: string;
+    customInstructions?: string;
+    customTools?: any[];
+    allowDefaultTools?: string[];
+    memory?: NodeMemoryManager | WebMemoryManager;
+    maxLoopCount?: number;
+}
+/**
+ * 快速创建 Node 端 Agent 的工厂方法
+ */
+declare function createNodeAgent(options: NodeAgentOptions): ClineAgent;
+
+interface WebAgentOptions {
+    apiConfig: WebApiHandlerConfig;
+    dbPath?: string;
+    customInstructions?: string;
+    customTools?: any[];
+    allowDefaultTools?: string[];
+    memory?: WebMemoryManager;
+    maxLoopCount?: number;
+    storageKey?: string;
+}
+/**
+ * 快速创建 Web 端 Agent 的工厂方法
+ */
+declare function createWebAgent(options: WebAgentOptions): ClineAgent;
+
+declare const VERSION = "0.1.0";
+
+export { AgentDefaultTool, type AgentMessage, type AgentOptions, AgentState, type ApiProviderInfo, type ApiStreamChunk, type AssistantMessageContent, ClineAgent, type IAgentRuntime, type IApiHandler, type IMcpManager, type IMemoryManager, type IPromptManager, type McpServerInfo, type McpTool, type McpToolCallResult, NodeApiHandler, type NodeApiHandlerConfig, NodeMemoryManager, NodePromptManager, READ_ONLY_TOOLS, type ReasoningStreamContent, TOOL_RESULT_BLOCK, type TextStreamContent, type ToolParamName, type ToolUse, VERSION, WebApiHandler, type WebApiHandlerConfig, WebMemoryManager, WebPromptManager, createNodeAgent, createWebAgent, defaultTools, getToolUseNames, parseAssistantMessageV2, setDynamicToolUseNames, toolParamNames, toolUseNames };