@ai-zen/agents-sdk 0.4.0 → 0.5.1

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);
-    }
-}

package/dist/crud/DraftRepository.d.ts

@@ -1,15 +0,0 @@
-import type { Draft } from "../types/index.js";
-/**
- * Draft 仓储。
- * Draft 没有 id 字段，文件名基于 conversationId：
- *   - 有 conversationId → ${conversationId}.json
- *   - 无 conversationId → _current.json
- */
-export declare class DraftRepository {
-    private dir;
-    constructor(dir: string);
-    private path;
-    read(conversationId?: string): Promise<Draft | null>;
-    write(draft: Draft): Promise<void>;
-    delete(conversationId?: string): Promise<void>;
-}

package/dist/crud/DraftRepository.js

@@ -1,52 +0,0 @@
-import { promises as fs } from "node:fs";
-import { join } from "node:path";
-const CURRENT_DRAFT = "_current.json";
-/**
- * Draft 仓储。
- * Draft 没有 id 字段，文件名基于 conversationId：
- *   - 有 conversationId → ${conversationId}.json
- *   - 无 conversationId → _current.json
- */
-export class DraftRepository {
-    dir;
-    constructor(dir) {
-        this.dir = dir;
-    }
-    path(conversationId) {
-        return join(this.dir, conversationId ? `${conversationId}.json` : CURRENT_DRAFT);
-    }
-    async read(conversationId) {
-        const p = this.path(conversationId);
-        try {
-            await fs.access(p);
-        }
-        catch {
-            return null;
-        }
-        try {
-            return JSON.parse(await fs.readFile(p, "utf-8"));
-        }
-        catch {
-            return null;
-        }
-    }
-    async write(draft) {
-        try {
-            await fs.access(this.dir);
-        }
-        catch {
-            await fs.mkdir(this.dir, { recursive: true });
-        }
-        await fs.writeFile(this.path(draft.conversationId), JSON.stringify(draft, null, 2), "utf-8");
-    }
-    async delete(conversationId) {
-        const p = this.path(conversationId);
-        try {
-            await fs.access(p);
-            await fs.unlink(p);
-        }
-        catch {
-            // 文件不存在，忽略
-        }
-    }
-}

package/dist/plugin/AutoDraftPlugin.d.ts

@@ -1,26 +0,0 @@
-import type { Draft } from "../types/index.js";
-import type { AgentPlugin, SendContext } from "../runtime/SdkAgent.js";
-export interface AutoDraftOptions {
-    draftsDir: string;
-    agentId: string;
-    modelId: string;
-    conversationId?: string;
-    cwd?: string;
-}
-/**
- * 自动保存 Draft 插件。
- *
- * ```ts
- * agent.use(new AutoDraftPlugin({
- *   draftsDir: "/path/to/drafts",
- *   agentId: "my-agent",
- *   modelId: "gpt-4",
- * }));
- * ```
- */
-export declare class AutoDraftPlugin implements AgentPlugin {
-    private options;
-    constructor(options: AutoDraftOptions);
-    onInnerLoopEnd(ctx: SendContext): Promise<void>;
-    static checkDraftForRestore(draftsDir: string): Promise<Draft | null>;
-}

package/dist/plugin/AutoDraftPlugin.js

@@ -1,62 +0,0 @@
-import { DraftRepository } from "../crud/DraftRepository.js";
-import { getLogger } from "../shared/logger.js";
-import { promises as fs } from "node:fs";
-import { join } from "node:path";
-import dayjs from "dayjs";
-const log = getLogger();
-const CURRENT_DRAFT = "_current.json";
-const EXPIRE_DAYS = 7;
-/**
- * 自动保存 Draft 插件。
- *
- * ```ts
- * agent.use(new AutoDraftPlugin({
- *   draftsDir: "/path/to/drafts",
- *   agentId: "my-agent",
- *   modelId: "gpt-4",
- * }));
- * ```
- */
-export class AutoDraftPlugin {
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    async onInnerLoopEnd(ctx) {
-        const { draftsDir, agentId, modelId, conversationId, cwd } = this.options;
-        try {
-            const draft = {
-                conversationId,
-                agentId,
-                modelId,
-                messages: ctx.agent.messages,
-                cwd,
-                updatedAt: new Date().toISOString(),
-            };
-            const repo = new DraftRepository(draftsDir);
-            await repo.write(draft);
-        }
-        catch (err) {
-            log.error(`[autoDraft] 保存失败: ${err?.message ?? err}`);
-        }
-    }
-    static async checkDraftForRestore(draftsDir) {
-        const path = join(draftsDir, CURRENT_DRAFT);
-        try {
-            await fs.access(path);
-        }
-        catch {
-            return null;
-        }
-        const repo = new DraftRepository(draftsDir);
-        const draft = await repo.read();
-        if (!draft)
-            return null;
-        const age = dayjs().diff(dayjs(draft.updatedAt), "day");
-        if (age > EXPIRE_DAYS) {
-            await repo.delete();
-            return null;
-        }
-        return draft;
-    }
-}