@amical/aiagent-sdk 0.1.11 → 0.1.12

package/dist/{WebMemoryManager-DXxLUDBB.d.ts → WebMemoryManager-BZNjinHF.d.ts}

@@ -2,16 +2,16 @@ import { IMemoryManager, AgentMessage } from './index.js';
 
 /**
  * Web 端 MemoryManager 实现
- * 使用 IndexedDB (通过封装) 或 LocalStorage / SessionStorage 来持久化对话历史。
- * 此处提供一个基于 SessionStorage / 内存 回退的轻量实现。
+ * 使用 SessionStorage / 内存 回退来持久化对话历史。
  */
 declare class WebMemoryManager implements IMemoryManager {
     private storageKey;
     private maxMessages;
     private inMemoryFallback;
+    onCondense?: () => void | Promise<void>;
     /**
      * @param storageKey SessionStorage 中的键名
-     * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
+     * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 200）
      */
     constructor(storageKey?: string, maxMessages?: number);
     private isStorageAvailable;
@@ -19,6 +19,13 @@ declare class WebMemoryManager implements IMemoryManager {
     private writeMessages;
     getHistory(): Promise<AgentMessage[]>;
     appendMessage(message: AgentMessage): Promise<void>;
+    /**
+     * 压缩历史：
+     * - system 消息保持不变
+     * - 以 agent_attempt_completion 为边界切分完整对话，仅合并“后面还有其他完整对话”的旧完整对话
+     * - 其余需要压缩的场景下，对前半段工具调用结果标记为“结果已过期”
+     * - 同时触发 onCondense 回调（宿主可据此清空 dify conversationId 新开窗口）
+     */
     condenseHistory(): Promise<void>;
     clear(): Promise<void>;
 }

package/dist/{WebMemoryManager-Bk19j8i6.d.mts → WebMemoryManager-DpaY-f0l.d.mts}

@@ -2,16 +2,16 @@ import { IMemoryManager, AgentMessage } from './index.mjs';
 
 /**
  * Web 端 MemoryManager 实现
- * 使用 IndexedDB (通过封装) 或 LocalStorage / SessionStorage 来持久化对话历史。
- * 此处提供一个基于 SessionStorage / 内存 回退的轻量实现。
+ * 使用 SessionStorage / 内存 回退来持久化对话历史。
  */
 declare class WebMemoryManager implements IMemoryManager {
     private storageKey;
     private maxMessages;
     private inMemoryFallback;
+    onCondense?: () => void | Promise<void>;
     /**
      * @param storageKey SessionStorage 中的键名
-     * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 150）
+     * @param maxMessages 保留的最大消息数量，用于简单的历史截断（默认 200）
      */
     constructor(storageKey?: string, maxMessages?: number);
     private isStorageAvailable;
@@ -19,6 +19,13 @@ declare class WebMemoryManager implements IMemoryManager {
     private writeMessages;
     getHistory(): Promise<AgentMessage[]>;
     appendMessage(message: AgentMessage): Promise<void>;
+    /**
+     * 压缩历史：
+     * - system 消息保持不变
+     * - 以 agent_attempt_completion 为边界切分完整对话，仅合并“后面还有其他完整对话”的旧完整对话
+     * - 其余需要压缩的场景下，对前半段工具调用结果标记为“结果已过期”
+     * - 同时触发 onCondense 回调（宿主可据此清空 dify conversationId 新开窗口）
+     */
     condenseHistory(): Promise<void>;
     clear(): Promise<void>;
 }

package/dist/index.d.mts

@@ -113,9 +113,11 @@ declare const defaultTools: readonly [{
     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 description: "Read the contents of a specific file. The returned content includes line numbers (e.g. '10|const x = 1;') so you can reference exact lines when editing.";
     readonly params: {
         readonly path: "(required) The absolute or relative file path to read.";
+        readonly start_line: "(optional) The 1-based line number to start reading from (inclusive). Defaults to 1.";
+        readonly end_line: "(optional) The 1-based line number to stop reading at (inclusive). Defaults to the last line.";
     };
 }, {
     readonly name: AgentDefaultTool.FILE_NEW;
@@ -350,6 +352,10 @@ interface IMemoryManager {
      * 截断或压缩过长历史
      */
     condenseHistory?(): Promise<void>;
+    /**
+     * 当历史被压缩时触发（宿主可在此处理例如 dify provider 清空 conversationId 等逻辑）
+     */
+    onCondense?: () => void | Promise<void>;
     /**
      * 清空记忆
      */
@@ -389,6 +395,7 @@ interface IApiHandler {
      * 获取当前配置的模型信息
      */
     getModelInfo(): ApiProviderInfo;
+    clearConversationId(): void;
 }
 
 /**
@@ -541,6 +548,11 @@ declare class ClineAgent {
      * 检查自上次获取 prompt 后是否有工具集被激活，若有则刷新缓存。
      */
     private getCurrentPrompt;
+    /**
+     * 将文件内容格式化为带行号文本（模拟编辑器行号显示），
+     * 支持通过 start_line / end_line 截取读取范围。
+     */
+    private formatFileContentWithLineNumbers;
     /**
      * 简单的 Diff 解析与替换辅助方法
      */

package/dist/index.d.ts

@@ -113,9 +113,11 @@ declare const defaultTools: readonly [{
     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 description: "Read the contents of a specific file. The returned content includes line numbers (e.g. '10|const x = 1;') so you can reference exact lines when editing.";
     readonly params: {
         readonly path: "(required) The absolute or relative file path to read.";
+        readonly start_line: "(optional) The 1-based line number to start reading from (inclusive). Defaults to 1.";
+        readonly end_line: "(optional) The 1-based line number to stop reading at (inclusive). Defaults to the last line.";
     };
 }, {
     readonly name: AgentDefaultTool.FILE_NEW;
@@ -350,6 +352,10 @@ interface IMemoryManager {
      * 截断或压缩过长历史
      */
     condenseHistory?(): Promise<void>;
+    /**
+     * 当历史被压缩时触发（宿主可在此处理例如 dify provider 清空 conversationId 等逻辑）
+     */
+    onCondense?: () => void | Promise<void>;
     /**
      * 清空记忆
      */
@@ -389,6 +395,7 @@ interface IApiHandler {
      * 获取当前配置的模型信息
      */
     getModelInfo(): ApiProviderInfo;
+    clearConversationId(): void;
 }
 
 /**
@@ -541,6 +548,11 @@ declare class ClineAgent {
      * 检查自上次获取 prompt 后是否有工具集被激活，若有则刷新缓存。
      */
     private getCurrentPrompt;
+    /**
+     * 将文件内容格式化为带行号文本（模拟编辑器行号显示），
+     * 支持通过 start_line / end_line 截取读取范围。
+     */
+    private formatFileContentWithLineNumbers;
     /**
      * 简单的 Diff 解析与替换辅助方法
      */

package/dist/index.js

@@ -136,9 +136,11 @@ return (
   },
   {
     name: "agent_read_file" /* FILE_READ */,
-    description: "Read the contents of a specific file.",
+    description: "Read the contents of a specific file. The returned content includes line numbers (e.g. '10|const x = 1;') so you can reference exact lines when editing.",
     params: {
-      path: "(required) The absolute or relative file path to read."
+      path: "(required) The absolute or relative file path to read.",
+      start_line: "(optional) The 1-based line number to start reading from (inclusive). Defaults to 1.",
+      end_line: "(optional) The 1-based line number to stop reading at (inclusive). Defaults to the last line."
     }
   },
   {
@@ -581,7 +583,17 @@ var TEXT_FILE_EXTENSIONS = /* @__PURE__ */ new Set([
   "dockerfile",
   "makefile",
   "properties",
-  "lock"
+  "lock",
+  "node-version",
+  "nvmrc",
+  "editorconfig",
+  "prettierrc",
+  "eslintrc",
+  "babelrc",
+  "stylelintrc",
+  "huskyrc",
+  "commitlintrc",
+  "lintstagedrc"
 ]);
 var AgentState = /* @__PURE__ */ ((AgentState2) => {
   AgentState2["IDLE"] = "idle";
@@ -672,6 +684,13 @@ var ClineAgent = class {
     }
     this.skillDir = this.runtime.path.join(this.runtime.env.cwd(), ".agents/skills");
     this.rulesDir = this.runtime.path.join(this.runtime.env.cwd(), ".agents/rules");
+    const originalOnCondense = this.memory.onCondense;
+    this.memory.onCondense = async () => {
+      this.api.clearConversationId();
+      if (originalOnCondense) {
+        await originalOnCondense();
+      }
+    };
   }
   setState(newState) {
     this.state = newState;
@@ -729,16 +748,6 @@ var ClineAgent = class {
   async getAgentRules() {
     const cwd = this.runtime.env.cwd();
     const rules = [];
-    const agentsMdPath = this.runtime.path.join(cwd, "Agents.md");
-    try {
-      if (await this.runtime.fs.fileExists(agentsMdPath)) {
-        const content = await this.runtime.fs.readFile(agentsMdPath);
-        if (content && content.trim()) {
-          rules.push(content.trim());
-        }
-      }
-    } catch (e) {
-    }
     try {
       if (await this.runtime.fs.fileExists(this.rulesDir)) {
         const files = await this.runtime.fs.readDir(this.rulesDir);
@@ -764,6 +773,28 @@ ${content.trim()}\`\`\``);
       }
     } catch (e) {
     }
+    try {
+      const getAgentsMdPath = async () => {
+        const agentsMdPathList = [
+          this.runtime.path.join(cwd, "AGENTS.md"),
+          this.runtime.path.join(cwd, "Agents.md"),
+          this.runtime.path.join(cwd, "agents.md")
+        ];
+        for (const item of agentsMdPathList) {
+          if (await this.runtime.fs.fileExists(item)) {
+            return item;
+          }
+        }
+      };
+      const agentsMdPath = await getAgentsMdPath();
+      if (agentsMdPath) {
+        const content = await this.runtime.fs.readFile(agentsMdPath);
+        if (content && content.trim()) {
+          rules.push(content.trim());
+        }
+      }
+    } catch (e) {
+    }
     return rules.join("\n---\n");
   }
   async getSkills() {
@@ -901,7 +932,8 @@ ${finalPrompt}` : finalPrompt;
             if (path) {
               try {
                 const content = await this.runtime.fs.readFile(path);
-                toolResults.push({ tool, result: content });
+                const result = this.formatFileContentWithLineNumbers(content, tool.params.start_line, tool.params.end_line);
+                toolResults.push({ tool, result });
               } catch (error) {
                 toolResults.push({ tool, result: `Error: ${error.message}` });
               }
@@ -914,6 +946,8 @@ ${finalPrompt}` : finalPrompt;
               const result = await this.runtime.terminal.execCommand(cmd);
               toolResults.push({ tool, result: `STDOUT: ${result.stdout}
 STDERR: ${result.stderr}` });
+            } else {
+              toolResults.push({ tool, result: "Error: No command provided." });
             }
           } else if (tool.name === "agent_write_to_file" /* FILE_NEW */) {
             const path = tool.params.path;
@@ -925,12 +959,18 @@ STDERR: ${result.stderr}` });
               } catch (error) {
                 toolResults.push({ tool, result: `Error: ${error.message}` });
               }
+            } else {
+              toolResults.push({ tool, result: "Error: Missing path or content." });
             }
           } else if (tool.name === "agent_list_files" /* LIST_FILES */) {
             const path = tool.params.path || this.runtime.env.cwd();
+            const recursive = tool.params.recursive === "true";
             try {
-              const files = await this.runtime.fs.readDir(path);
-              toolResults.push({ tool, result: files.map((f) => f.name + (f.isDirectory() ? "/" : "")).join("\n") });
+              const files = await this.runtime.fs.readDir(path, { recursive });
+              toolResults.push({
+                tool,
+                result: files.map((f) => `${f.isDirectory() ? "[DIR] " : "      "}${f.name}${f.isDirectory() ? "/" : ""}`).join("\n")
+              });
             } catch (e) {
               toolResults.push({ tool, result: `Error: ${e.message}` });
             }
@@ -1070,10 +1110,15 @@ STDERR: ${result.stderr}` });
               try {
                 const res = await fetch(url);
                 const text = await res.text();
-                toolResults.push({ tool, result: text.substring(0, 3e3) });
+                const MAX_LEN = 8e3;
+                const truncated = text.length > MAX_LEN ? `${text.substring(0, MAX_LEN)}
+...[truncated ${text.length - MAX_LEN} chars]` : text;
+                toolResults.push({ tool, result: truncated });
               } catch (e) {
                 toolResults.push({ tool, result: `Error: ${e.message}` });
               }
+            } else {
+              toolResults.push({ tool, result: "Error: No url provided." });
             }
           } else if (tool.name === "agent_focus_chain" /* TODO */) {
             toolResults.push({ tool, result: `Focus chain updated successfully.` });
@@ -1161,6 +1206,44 @@ ${this.promptManager.getUsedToolResultInstructions()}`;
     }
     return this.getPrompt();
   }
+  /**
+   * 将文件内容格式化为带行号文本（模拟编辑器行号显示），
+   * 支持通过 start_line / end_line 截取读取范围。
+   */
+  formatFileContentWithLineNumbers(content, startLineParam, endLineParam) {
+    const lines = content.split(/\r?\n/);
+    const normalized = lines.length > 0 && lines[lines.length - 1] === "" ? lines.slice(0, -1) : lines;
+    const total = normalized.length;
+    if (total === 0) {
+      return "1|(empty file)";
+    }
+    const parseLine = (val, fallback) => {
+      if (val === void 0 || val === null || val.trim() === "") {
+        return fallback;
+      }
+      const num = Number.parseInt(val, 10);
+      if (!Number.isFinite(num) || num <= 0) {
+        return fallback;
+      }
+      return num;
+    };
+    const start = parseLine(startLineParam, 1);
+    const end = parseLine(endLineParam, total);
+    if (start > end) {
+      return `Error: start_line (${start}) cannot be greater than end_line (${end}).`;
+    }
+    if (start > total) {
+      return `Error: start_line (${start}) is out of range. The file has ${total} lines.`;
+    }
+    const from = Math.max(1, start);
+    const to = Math.min(total, end);
+    const width = String(total).length;
+    const selected = normalized.slice(from - 1, to);
+    const numbered = selected.map((line, idx) => `${String(from + idx).padStart(width)}|${line}`).join("\n");
+    const header = from === 1 && to === total ? `1-${total}/${total}` : `${from}-${to}/${total}`;
+    return `${header}
+${numbered}`;
+  }
   /**
    * 简单的 Diff 解析与替换辅助方法
    */