@ai-zen/agents-sdk 0.4.0 → 0.5.0

package/dist/capabilities/implements/builtin/cwd.js

@@ -1,15 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export const cwdTool = new CallbackTool({
-    function: {
-        name: "cwd",
-        description: "获取当前工作目录 cwd",
-        parameters: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    },
-    async callback() {
-        return process.cwd();
-    },
-});

package/dist/capabilities/implements/builtin/downloadFile.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const downloadFileTool: CallbackTool;

package/dist/capabilities/implements/builtin/edit.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const editTool: CallbackTool;

package/dist/capabilities/implements/builtin/edit.js

@@ -1,79 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-function countOccurrences(content, text) {
-    let count = 0;
-    let pos = 0;
-    while (true) {
-        pos = content.indexOf(text, pos);
-        if (pos === -1)
-            break;
-        count++;
-        pos += text.length;
-    }
-    return count;
-}
-export const editTool = new CallbackTool({
-    function: {
-        name: "edit",
-        description: "编辑文件中的文本，支持精确替换或替换所有匹配项",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "文件路径",
-                },
-                oldText: {
-                    type: "string",
-                    description: "要替换的文本",
-                },
-                newText: {
-                    type: "string",
-                    description: "替换后的文本",
-                },
-                isReplaceAll: {
-                    type: "boolean",
-                    description: "是否替换所有匹配的文本（默认 false，仅替换首次匹配）。使用此功能前应确保你提供的 oldText 足够精确，避免误替换",
-                    default: false,
-                },
-            },
-            required: ["path", "oldText", "newText"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            const path = input.path;
-            const oldText = input.oldText;
-            const newText = input.newText;
-            const isReplaceAll = input.isReplaceAll;
-            const content = await fsp.readFile(path, "utf-8");
-            const count = countOccurrences(content, oldText);
-            if (count === 0) {
-                return JSON.stringify({
-                    result: "文件中未精确匹配到要替换的文本",
-                    matchCount: 0,
-                });
-            }
-            const newContent = isReplaceAll
-                ? content.replaceAll(oldText, newText)
-                : content.replace(oldText, newText);
-            await fsp.writeFile(path, newContent);
-            if (!isReplaceAll && count > 1) {
-                return JSON.stringify({
-                    result: `警告：未开启替换所有（isReplaceAll=false），但文本 "${oldText}" 在文件中出现了 ${count} 次，仅替换了首次匹配。如果希望替换所有匹配，请将 isReplaceAll 设为 true`,
-                    matchCount: count,
-                    replacedCount: 1,
-                });
-            }
-            return JSON.stringify({
-                result: "success",
-                matchCount: count,
-                replacedCount: isReplaceAll ? count : 1,
-            });
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/exec.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const execTool: CallbackTool;

package/dist/capabilities/implements/builtin/exec.js

@@ -1,38 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import { exec } from "child_process";
-export const execTool = new CallbackTool({
-    function: {
-        name: "exec",
-        description: "执行命令",
-        parameters: {
-            type: "object",
-            properties: {
-                command: {
-                    type: "string",
-                    description: "要执行的命令",
-                },
-                timeout: {
-                    type: "number",
-                    description: "超时时间（毫秒），超时后会终止进程。默认无超时。建议长时间运行的命令使用 exec_async 异步执行。",
-                },
-            },
-            required: ["command"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        const command = input.command;
-        const timeout = input.timeout;
-        const result = await new Promise((resolve) => {
-            const child = exec(command, { timeout: timeout && timeout > 0 ? timeout : undefined }, (error, stdout, stderr) => {
-                resolve({
-                    stdout,
-                    stderr,
-                    exitCode: error?.code ?? (error ? 1 : null),
-                    killed: error?.killed ?? false,
-                });
-            });
-        });
-        return JSON.stringify(result);
-    },
-});

package/dist/capabilities/implements/builtin/execAsync.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const execAsyncTool: CallbackTool;

package/dist/capabilities/implements/builtin/exist.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const existTool: CallbackTool;

package/dist/capabilities/implements/builtin/exist.js

@@ -1,25 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const existTool = new CallbackTool({
-    function: {
-        name: "exist",
-        description: "检查文件或目录是否存在",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "文件或目录路径",
-                },
-            },
-            required: ["path"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        return await fsp
-            .access(input.path)
-            .then(() => "true")
-            .catch(() => "false");
-    },
-});

package/dist/capabilities/implements/builtin/findText.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const findTextTool: CallbackTool;

package/dist/capabilities/implements/builtin/generateImage.d.ts

@@ -1,9 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import type { AppConfig } from "../../../types/index.js";
-/**
- * 根据文字描述生成图片。返回图片 URL，可通过 downloadFile 工具保存到本地。
- *
- * 依赖 AppConfig 中的 imageModels 和 defaultImageModel 配置。
- * 如果未配置图片模型，工具会返回错误提示。
- */
-export declare function createGenerateImageTool(config: AppConfig): CallbackTool;

package/dist/capabilities/implements/builtin/generateImage.js

@@ -1,112 +0,0 @@
-import { CallbackTool, OpenAI, ZhipuImage } from "@ai-zen/agents-core";
-/**
- * 根据文字描述生成图片。返回图片 URL，可通过 downloadFile 工具保存到本地。
- *
- * 依赖 AppConfig 中的 imageModels 和 defaultImageModel 配置。
- * 如果未配置图片模型，工具会返回错误提示。
- */
-export function createGenerateImageTool(config) {
-    return new CallbackTool({
-        function: {
-            name: "generateImage",
-            description: "根据文字描述生成图片。返回图片 URL，可通过 downloadFile 工具保存到本地。",
-            parameters: {
-                type: "object",
-                properties: {
-                    prompt: {
-                        type: "string",
-                        description: "所需图像的文本描述，应详细描述画面内容、风格、构图等",
-                    },
-                    model: {
-                        type: "string",
-                        description: "图片模型 ID，不指定则使用配置中的默认图片模型。配置中的图片模型可通过 'aiz config show' 查看。",
-                    },
-                    size: {
-                        type: "string",
-                        description: '图片尺寸。不指定则使用模型的默认尺寸。cogview系列: 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440。glm-image: 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728。',
-                    },
-                    quality: {
-                        type: "string",
-                        description: "图像质量。hd: 精细(约20秒), standard: 快速(约5-10秒)",
-                        enum: ["hd", "standard"],
-                    },
-                },
-                required: ["prompt"],
-                additionalProperties: false,
-            },
-        },
-        async callback(input) {
-            try {
-                const prompt = input.prompt;
-                if (!prompt || !prompt.trim()) {
-                    return JSON.stringify({ success: false, error: "prompt 不能为空" });
-                }
-                const imageModels = config.imageModels;
-                const defaultImageModel = config.defaultImageModel;
-                if (!imageModels || imageModels.length === 0) {
-                    return JSON.stringify({
-                        success: false,
-                        error: "未配置图片生成模型。请在配置中添加 imageModels。",
-                    });
-                }
-                const modelId = input.model || defaultImageModel;
-                const imageModel = modelId
-                    ? imageModels.find((m) => m.id === modelId)
-                    : imageModels[0];
-                if (!imageModel) {
-                    return JSON.stringify({
-                        success: false,
-                        error: `图片模型 "${modelId}" 不存在。可用的图片模型: ${imageModels.map((m) => m.id).join(", ")}`,
-                    });
-                }
-                const endpoint = config.endpoints.find((e) => e.id === imageModel.endpointId);
-                if (!endpoint) {
-                    return JSON.stringify({
-                        success: false,
-                        error: `图片模型 "${imageModel.name}" 对应的端点 "${imageModel.endpointId}" 未配置`,
-                    });
-                }
-                if (!endpoint.apiKey) {
-                    return JSON.stringify({
-                        success: false,
-                        error: `端点 "${endpoint.name}" 的 API Key 未设置`,
-                    });
-                }
-                const ep = new OpenAI({
-                    openai_endpoint: endpoint.baseUrl,
-                    api_key: endpoint.apiKey,
-                });
-                const modelName = input.model || imageModel.modelName;
-                const model = new ZhipuImage({
-                    request_config: await ep.imageGeneration(modelName),
-                });
-                const result = await model.generate({
-                    prompt: prompt.trim(),
-                    model: modelName,
-                    size: input.size || imageModel.defaultSize || undefined,
-                    quality: input.quality || imageModel.defaultQuality || undefined,
-                });
-                const images = result.data.map((img, i) => ({
-                    index: i,
-                    url: img.url,
-                    description: `图片 ${i + 1}`,
-                }));
-                return JSON.stringify({
-                    success: true,
-                    model: imageModel.name,
-                    modelId: imageModel.id,
-                    created: result.created,
-                    images,
-                    content_filter: result.content_filter || [],
-                    note: "图片临时链接有效期为30天，请及时转存图片。",
-                }, null, 2);
-            }
-            catch (error) {
-                return JSON.stringify({
-                    success: false,
-                    error: error instanceof Error ? error.message : "图片生成失败",
-                });
-            }
-        },
-    });
-}

package/dist/capabilities/implements/builtin/glob.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const globTool: CallbackTool;

package/dist/capabilities/implements/builtin/glob.js

@@ -1,45 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const globTool = new CallbackTool({
-    function: {
-        name: "glob",
-        description: "使用 glob 模式递归扫描和查找文件。这是进行文件系统搜索的首选工具，功能远优于简单的 'ls' 列表命令。当你需要查找特定类型的文件、遍历目录树或需要排除特定文件时，请优先使用此函数。",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "glob cwd",
-                },
-                pattern: {
-                    type: "string",
-                    description: "glob pattern",
-                },
-                exclude: {
-                    type: "array",
-                    description: "glob pattern to exclude",
-                    items: {
-                        type: "string",
-                    },
-                },
-            },
-            required: ["pattern"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            const result = [];
-            for await (const file of fsp.glob(input.pattern, {
-                exclude: input.exclude || ["**/node_modules/**"],
-                cwd: input.path,
-            })) {
-                result.push(file);
-            }
-            return JSON.stringify(result);
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/ls.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const lsTool: CallbackTool;

package/dist/capabilities/implements/builtin/ls.js

@@ -1,28 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const lsTool = new CallbackTool({
-    function: {
-        name: "ls",
-        description: "列出目录",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "目录路径",
-                },
-            },
-            required: ["path"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            const result = await fsp.readdir(input.path);
-            return JSON.stringify(result);
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/mkdir.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const mkdirTool: CallbackTool;

package/dist/capabilities/implements/builtin/mkdir.js

@@ -1,34 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const mkdirTool = new CallbackTool({
-    function: {
-        name: "mkdir",
-        description: "创建目录",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "目录路径",
-                },
-                recursive: {
-                    type: "boolean",
-                    description: "是否递归创建子目录",
-                },
-            },
-            required: ["path"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            await fsp.mkdir(input.path, {
-                recursive: input.recursive,
-            });
-            return "success";
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/readFile.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const readFileTool: CallbackTool;

package/dist/capabilities/implements/builtin/readFile.js

@@ -1,31 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const readFileTool = new CallbackTool({
-    function: {
-        name: "readFile",
-        description: "读取文件",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "文件路径",
-                },
-            },
-            required: ["path"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            const stats = await fsp.stat(input.path);
-            if (stats.size > 300 * 1024) {
-                throw new Error(`文件过大，无法读取，当前文件大小 ${stats.size} 字节`);
-            }
-            return await fsp.readFile(input.path, "utf-8");
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/rename.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const renameTool: CallbackTool;

package/dist/capabilities/implements/builtin/rename.js

@@ -1,32 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const renameTool = new CallbackTool({
-    function: {
-        name: "rename",
-        description: "重命名或移动文件/目录（相当于 mv 命令）",
-        parameters: {
-            type: "object",
-            properties: {
-                oldPath: {
-                    type: "string",
-                    description: "原路径",
-                },
-                newPath: {
-                    type: "string",
-                    description: "新路径",
-                },
-            },
-            required: ["oldPath", "newPath"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            await fsp.rename(input.oldPath, input.newPath);
-            return "success";
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/rm.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const rmTool: CallbackTool;

package/dist/capabilities/implements/builtin/rm.js

@@ -1,34 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-export const rmTool = new CallbackTool({
-    function: {
-        name: "rm",
-        description: "删除文件或目录",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "文件或目录路径",
-                },
-                recursive: {
-                    type: "boolean",
-                    description: "是否递归删除子目录",
-                },
-            },
-            required: ["path"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            await fsp.rm(input.path, {
-                recursive: input.recursive ?? false,
-            });
-            return "success";
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/capabilities/implements/builtin/sleep.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const sleepTool: CallbackTool;

package/dist/capabilities/implements/builtin/sleep.js

@@ -1,41 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export const sleepTool = new CallbackTool({
-    function: {
-        name: "sleep",
-        description: "等待指定的时间（毫秒）。用于需要延迟执行的场景，例如等待其他操作完成、操作间隔控制等。注意：过长的等待时间会影响响应速度，建议不超过 30000 毫秒（30 秒）。",
-        parameters: {
-            type: "object",
-            properties: {
-                ms: {
-                    type: "number",
-                    description: "等待的毫秒数（1 秒 = 1000 毫秒）。建议不超过 30000（30 秒）。",
-                },
-            },
-            required: ["ms"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        const ms = input.ms;
-        if (typeof ms !== "number" || !Number.isFinite(ms) || ms < 0) {
-            return JSON.stringify({
-                success: false,
-                error: "ms 必须是正整数",
-            });
-        }
-        if (ms > 300_000) {
-            // 超过 5 分钟给出警告
-            return JSON.stringify({
-                success: false,
-                error: `等待时间 ${ms}ms 过长，建议不超过 300000ms（5 分钟）。如需长时间等待请分段执行。`,
-            });
-        }
-        await new Promise((resolve) => setTimeout(resolve, ms));
-        return JSON.stringify({
-            success: true,
-            waitedMs: ms,
-            waitedSeconds: (ms / 1000).toFixed(1),
-            message: `已等待 ${ms}ms（${(ms / 1000).toFixed(1)} 秒）`,
-        });
-    },
-});

package/dist/capabilities/implements/builtin/writeFile.d.ts

@@ -1,2 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-export declare const writeFileTool: CallbackTool;

package/dist/capabilities/implements/builtin/writeFile.js

@@ -1,34 +0,0 @@
-import { CallbackTool } from "@ai-zen/agents-core";
-import * as fsp from "fs/promises";
-import * as path from "path";
-export const writeFileTool = new CallbackTool({
-    function: {
-        name: "writeFile",
-        description: "写入文件",
-        parameters: {
-            type: "object",
-            properties: {
-                path: {
-                    type: "string",
-                    description: "文件路径",
-                },
-                content: {
-                    type: "string",
-                    description: "文件内容",
-                },
-            },
-            required: ["path", "content"],
-            additionalProperties: false,
-        },
-    },
-    async callback(input) {
-        try {
-            await fsp.mkdir(path.dirname(input.path), { recursive: true });
-            await fsp.writeFile(input.path, input.content);
-            return "success";
-        }
-        catch (error) {
-            return error?.message;
-        }
-    },
-});

package/dist/crud/ConversationRepository.d.ts

@@ -1,9 +0,0 @@
-import type { Conversation } from "../types/index.js";
-import { EntityRepository } from "../shared/EntityRepository.js";
-/**
- * Conversation 仓储。
- * 每个 Conversation 一个 JSON 文件存储在 ${conversationsDir}/${id}.json。
- */
-export declare class ConversationRepository extends EntityRepository<Conversation> {
-    constructor(conversationsDir: string);
-}

package/dist/crud/ConversationRepository.js

@@ -1,10 +0,0 @@
-import { EntityRepository } from "../shared/EntityRepository.js";
-/**
- * Conversation 仓储。
- * 每个 Conversation 一个 JSON 文件存储在 ${conversationsDir}/${id}.json。
- */
-export class ConversationRepository extends EntityRepository {
-    constructor(conversationsDir) {
-        super(conversationsDir);
-    }
-}