@zhin.js/agent 0.1.14 → 0.1.16

package/lib/builtin/write-memory-tool.js

@@ -0,0 +1,50 @@
+/**
+ * write_memory — 写入持久化记忆（AGENTS.md）
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { errMsg } from '../discovery/utils.js';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export const WRITE_MEMORY_PARAMETERS = {
+    type: 'object',
+    properties: {
+        content: { type: 'string', description: '要保存的记忆内容（Markdown）' },
+        scope: {
+            type: 'string',
+            description: "'global' 或 'chat'（默认 chat）",
+            enum: ['global', 'chat'],
+        },
+        chat_id: { type: 'string', description: '聊天 ID' },
+    },
+    required: ['content'],
+};
+export class WriteMemoryBuiltinTool extends BuiltinBaseTool {
+    dataDir;
+    name = 'write_memory';
+    description = '写入持久化记忆。当用户说"记住…"、"记录…"时使用此工具';
+    parameters = WRITE_MEMORY_PARAMETERS;
+    kind = 'memory';
+    constructor(dataDir) {
+        super();
+        this.dataDir = dataDir;
+        this.tags.push('memory', 'agents');
+        this.keywords.push('记住', '保存', 'remember', '记录');
+    }
+    async run(args, _context) {
+        try {
+            const memPath = args.scope === 'global'
+                ? path.join(this.dataDir, 'AGENTS.md')
+                : path.join(this.dataDir, 'groups', args.chat_id || 'default', 'AGENTS.md');
+            await fs.mkdir(path.dirname(memPath), { recursive: true });
+            await fs.writeFile(memPath, String(args.content), 'utf-8');
+            return `✅ Memory saved (${args.scope || 'chat'} scope)`;
+        }
+        catch (e) {
+            return `Error: ${errMsg(e)}`;
+        }
+    }
+}
+export function createWriteMemoryTool(dataDir) {
+    return new WriteMemoryBuiltinTool(dataDir).toTool();
+}
+//# sourceMappingURL=write-memory-tool.js.map

package/lib/builtin/write-memory-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-memory-tool.js","sourceRoot":"","sources":["../../src/builtin/write-memory-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC3D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QAC9D,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;SACzB;QACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE;KAClD;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IAM5B;IALpB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,+BAA+B,CAAC;IAC9C,UAAU,GAAG,uBAAuB,CAAC;IACrC,IAAI,GAAG,QAAQ,CAAC;IAEzB,YAA6B,OAAe;QAC1C,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAQ;QAE1C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,QAAsB;QAC7D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,KAAK,QAAQ;gBACrC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;gBACtC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAG,IAAI,CAAC,OAAkB,IAAI,SAAS,EAAE,WAAW,CAAC,CAAC;YAC1F,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,OAAO,mBAAoB,IAAI,CAAC,KAAgB,IAAI,MAAM,SAAS,CAAC;QACtE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,UAAU,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;AACtD,CAAC"}

package/lib/builtin-tools.d.ts

@@ -1,21 +1,20 @@
 /**
  * AI 内置系统工具
  *
- * 文件工具:  read_file, write_file, edit_file, list_dir, glob, grep
- * Shell:     bash
- * 网络:      web_search, web_fetch
- * 计划:      todo_read, todo_write
- * 记忆:      read_memory, write_memory (AGENTS.md)
- * 技能:      activate_skill, install_skill
- * 交互:      ask_user（基于 Prompt 类的用户确认/提问工具）
+ * 文件工具:  read_file / write_file / edit_file / list_dir / glob / grep（builtin/* + BuiltinBaseTool）
+ * Shell:     bash（builtin/bash-tool）
+ * 网络:      web_search, web_fetch（builtin/web-*-tool）
+ * 计划:      todo_read, todo_write（builtin/todo-*-tool）
+ * 记忆:      read_memory, write_memory（builtin/read-memory-tool, write-memory-tool）
+ * 技能:      activate_skill, install_skill（builtin/activate-skill-tool, install-skill-tool）
+ * 交互:      ask_user（builtin/ask-user-tool）
  *
  * 发现逻辑已拆分到 discovery/skills.ts、agents.ts、tools.ts
  */
-import { type Plugin } from '@zhin.js/core';
-import { ZhinTool } from '@zhin.js/core';
+import type { Plugin, ToolInput } from '@zhin.js/core';
 export interface BuiltinToolsOptions {
     /** 插件实例，用于 ask_user 工具创建 Prompt 交互 */
-    plugin?: Plugin;
+    plugin: Plugin;
     /** Max chars for skill instruction extraction (model-size-aware) */
     skillInstructionMaxChars?: number;
     /**
@@ -31,5 +30,5 @@ export interface BuiltinToolsOptions {
 /**
  * 创建所有内置系统工具
  */
-export declare function createBuiltinTools(options?: BuiltinToolsOptions): ZhinTool[];
+export declare function createBuiltinTools(options: BuiltinToolsOptions): ToolInput[];
 //# sourceMappingURL=builtin-tools.d.ts.map

package/lib/builtin-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAA2B,KAAK,MAAM,EAAiE,MAAM,eAAe,CAAC;AACpI,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAkMzC,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,QAAQ,EAAE,CAqtB5E"}
+{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAmBvD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE,CAoC5E"}