mozi-bot 1.0.0

package/dist/tools/builtin/process-tool.js

@@ -0,0 +1,279 @@
+/**
+ * 内置工具 - 进程管理工具
+ * 用于管理后台运行的 bash 进程
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, textResult, readStringParam, readNumberParam } from "../common.js";
+import { getSession, getFinishedSession, listRunningSessions, listFinishedSessions, killSession, deleteSession, drainSession, sliceLogLines, tail, formatDuration, } from "./process-registry.js";
+/** 创建进程管理工具 */
+export function createProcessTool() {
+    return {
+        name: "process",
+        label: "Process Manager",
+        description: `Manage background bash processes.
+
+Actions:
+- list: List all running and recently finished processes
+- poll: Check status and get new output from a process
+- log: Get the full log output from a process
+- write: Write input to a running process stdin
+- kill: Terminate a running process
+- clear: Remove a finished process from history
+
+Parameters:
+- action: The action to perform (list, poll, log, write, kill, clear)
+- session_id: The session ID (required for poll, log, write, kill, clear)
+- input: Input to write to stdin (required for write action)
+- offset: Line offset for log action (optional)
+- limit: Line limit for log action (optional)`,
+        parameters: Type.Object({
+            action: Type.Union([
+                Type.Literal("list"),
+                Type.Literal("poll"),
+                Type.Literal("log"),
+                Type.Literal("write"),
+                Type.Literal("kill"),
+                Type.Literal("clear"),
+            ], { description: "The action to perform" }),
+            session_id: Type.Optional(Type.String({ description: "The session ID of the process" })),
+            input: Type.Optional(Type.String({ description: "Input to write to stdin (for write action)" })),
+            offset: Type.Optional(Type.Number({ description: "Line offset for log output" })),
+            limit: Type.Optional(Type.Number({ description: "Line limit for log output" })),
+        }),
+        execute: async (_toolCallId, args) => {
+            const params = args;
+            const action = readStringParam(params, "action", { required: true });
+            const sessionId = readStringParam(params, "session_id");
+            switch (action) {
+                case "list":
+                    return handleList();
+                case "poll":
+                    return handlePoll(sessionId);
+                case "log":
+                    return handleLog(sessionId, params);
+                case "write":
+                    return handleWrite(sessionId, params);
+                case "kill":
+                    return handleKill(sessionId);
+                case "clear":
+                    return handleClear(sessionId);
+                default:
+                    return jsonResult({
+                        status: "error",
+                        error: `Unknown action: ${action}`,
+                    }, true);
+            }
+        },
+    };
+}
+/** 列出所有进程 */
+function handleList() {
+    const running = listRunningSessions();
+    const finished = listFinishedSessions();
+    const processes = [
+        ...running.map((s) => ({
+            session_id: s.id,
+            command: s.command,
+            pid: s.pid,
+            status: s.status,
+            started: new Date(s.startedAt).toISOString(),
+            duration: formatDuration(Date.now() - s.startedAt),
+            backgrounded: s.backgrounded,
+            tail: tail(s.tail, 200),
+        })),
+        ...finished.map((s) => ({
+            session_id: s.id,
+            command: s.command,
+            pid: s.pid,
+            status: s.status,
+            exitCode: s.exitCode,
+            started: new Date(s.startedAt).toISOString(),
+            ended: s.endedAt ? new Date(s.endedAt).toISOString() : undefined,
+            duration: s.endedAt ? formatDuration(s.endedAt - s.startedAt) : undefined,
+            backgrounded: s.backgrounded,
+        })),
+    ];
+    if (processes.length === 0) {
+        return jsonResult({
+            status: "success",
+            message: "No processes found",
+            running: 0,
+            finished: 0,
+        });
+    }
+    return jsonResult({
+        status: "success",
+        running: running.length,
+        finished: finished.length,
+        processes,
+    });
+}
+/** 轮询进程状态和输出 */
+function handlePoll(sessionId) {
+    if (!sessionId) {
+        return jsonResult({
+            status: "error",
+            error: "session_id is required for poll action",
+        }, true);
+    }
+    // 先检查运行中的会话
+    let session = getSession(sessionId);
+    let isFinished = false;
+    if (!session) {
+        // 再检查已完成的会话
+        session = getFinishedSession(sessionId);
+        isFinished = true;
+    }
+    if (!session) {
+        return jsonResult({
+            status: "error",
+            error: `Session not found: ${sessionId}`,
+        }, true);
+    }
+    if (isFinished) {
+        // 已完成的会话，返回最终状态
+        return jsonResult({
+            status: "success",
+            session_id: session.id,
+            command: session.command,
+            process_status: session.status,
+            exitCode: session.exitCode,
+            exitSignal: session.exitSignal,
+            duration: session.endedAt ? formatDuration(session.endedAt - session.startedAt) : undefined,
+            truncated: session.truncated,
+            tail: tail(session.aggregated, 2000),
+        });
+    }
+    // 运行中的会话，获取新输出
+    const { stdout, stderr } = drainSession(session);
+    const hasOutput = stdout.length > 0 || stderr.length > 0;
+    return jsonResult({
+        status: "success",
+        session_id: session.id,
+        command: session.command,
+        process_status: session.status,
+        pid: session.pid,
+        duration: formatDuration(Date.now() - session.startedAt),
+        has_output: hasOutput,
+        stdout: stdout || undefined,
+        stderr: stderr || undefined,
+        truncated: session.truncated,
+    });
+}
+/** 获取进程日志 */
+function handleLog(sessionId, params) {
+    if (!sessionId) {
+        return jsonResult({
+            status: "error",
+            error: "session_id is required for log action",
+        }, true);
+    }
+    const offset = params ? readNumberParam(params, "offset", { min: 1 }) : undefined;
+    const limit = params ? readNumberParam(params, "limit", { min: 1, max: 10000 }) : undefined;
+    // 查找会话
+    let session = getSession(sessionId) ?? getFinishedSession(sessionId);
+    if (!session) {
+        return jsonResult({
+            status: "error",
+            error: `Session not found: ${sessionId}`,
+        }, true);
+    }
+    const { slice, totalLines, totalChars } = sliceLogLines(session.aggregated, offset, limit ?? 500);
+    return textResult(slice || "(no output)", {
+        session_id: session.id,
+        command: session.command,
+        process_status: session.status,
+        totalLines,
+        totalChars,
+        truncated: session.truncated,
+        offset: offset ?? 1,
+        limit: limit ?? 500,
+    });
+}
+/** 写入进程 stdin */
+function handleWrite(sessionId, params) {
+    if (!sessionId) {
+        return jsonResult({
+            status: "error",
+            error: "session_id is required for write action",
+        }, true);
+    }
+    const input = params ? readStringParam(params, "input", { required: true }) : undefined;
+    if (!input) {
+        return jsonResult({
+            status: "error",
+            error: "input is required for write action",
+        }, true);
+    }
+    const session = getSession(sessionId);
+    if (!session) {
+        return jsonResult({
+            status: "error",
+            error: `Session not found or already finished: ${sessionId}`,
+        }, true);
+    }
+    if (!session.child || session.child.killed) {
+        return jsonResult({
+            status: "error",
+            error: "Process is not running",
+        }, true);
+    }
+    try {
+        session.child.stdin?.write(input);
+        return jsonResult({
+            status: "success",
+            session_id: sessionId,
+            message: `Wrote ${input.length} characters to stdin`,
+        });
+    }
+    catch (error) {
+        return jsonResult({
+            status: "error",
+            error: error instanceof Error ? error.message : String(error),
+        }, true);
+    }
+}
+/** 终止进程 */
+function handleKill(sessionId) {
+    if (!sessionId) {
+        return jsonResult({
+            status: "error",
+            error: "session_id is required for kill action",
+        }, true);
+    }
+    const session = getSession(sessionId);
+    if (!session) {
+        return jsonResult({
+            status: "error",
+            error: `Session not found or already finished: ${sessionId}`,
+        }, true);
+    }
+    killSession(session);
+    return jsonResult({
+        status: "success",
+        session_id: sessionId,
+        message: "Kill signal sent to process",
+    });
+}
+/** 清除已完成的进程记录 */
+function handleClear(sessionId) {
+    if (!sessionId) {
+        return jsonResult({
+            status: "error",
+            error: "session_id is required for clear action",
+        }, true);
+    }
+    const deleted = deleteSession(sessionId);
+    if (!deleted) {
+        return jsonResult({
+            status: "error",
+            error: `Session not found or still running: ${sessionId}`,
+        }, true);
+    }
+    return jsonResult({
+        status: "success",
+        session_id: sessionId,
+        message: "Session cleared from history",
+    });
+}
+//# sourceMappingURL=process-tool.js.map

package/dist/tools/builtin/process-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tool.js","sourceRoot":"","sources":["../../../src/tools/builtin/process-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtin/subagent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 子 Agent 工具 - 支持多 Agent 路由
+ */
+import type { Tool } from "../types.js";
+/** 子 Agent 定义 */
+export interface SubAgentDefinition {
+    id: string;
+    name: string;
+    description: string;
+    systemPrompt: string;
+    model?: string;
+    provider?: string;
+}
+/** 子 Agent 运行器 */
+export type SubAgentRunner = (agentId: string, prompt: string, context?: Record<string, unknown>) => Promise<{
+    content: string;
+    error?: string;
+}>;
+/** 注册子 Agent */
+export declare function registerSubAgent(agent: SubAgentDefinition): void;
+/** 设置子 Agent 运行器 */
+export declare function setSubAgentRunner(runner: SubAgentRunner): void;
+/** 获取所有子 Agent */
+export declare function getAllSubAgents(): SubAgentDefinition[];
+/** 获取子 Agent */
+export declare function getSubAgent(id: string): SubAgentDefinition | undefined;
+/** 创建子 Agent 工具 */
+export declare function createSubAgentTool(): Tool;
+/** 预定义的子 Agent */
+export declare const PREDEFINED_SUBAGENTS: SubAgentDefinition[];
+/** 注册预定义的子 Agent */
+export declare function registerPredefinedSubAgents(): void;
+//# sourceMappingURL=subagent.d.ts.map

package/dist/tools/builtin/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAMxC,iBAAiB;AACjB,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kBAAkB;AAClB,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAMlD,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAGhE;AAED,oBAAoB;AACpB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE9D;AAED,kBAAkB;AAClB,wBAAgB,eAAe,IAAI,kBAAkB,EAAE,CAEtD;AAED,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED,mBAAmB;AACnB,wBAAgB,kBAAkB,IAAI,IAAI,CA4GzC;AAED,kBAAkB;AAClB,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAiDpD,CAAC;AAEF,oBAAoB;AACpB,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}

package/dist/tools/builtin/subagent.js

@@ -0,0 +1,185 @@
+/**
+ * 子 Agent 工具 - 支持多 Agent 路由
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, textResult, readStringParam } from "../common.js";
+import { getChildLogger } from "../../utils/logger.js";
+const logger = getChildLogger("subagent");
+/** 子 Agent 注册表 */
+const subAgentRegistry = new Map();
+let subAgentRunner = null;
+/** 注册子 Agent */
+export function registerSubAgent(agent) {
+    subAgentRegistry.set(agent.id, agent);
+    logger.debug({ agentId: agent.id, name: agent.name }, "Subagent registered");
+}
+/** 设置子 Agent 运行器 */
+export function setSubAgentRunner(runner) {
+    subAgentRunner = runner;
+}
+/** 获取所有子 Agent */
+export function getAllSubAgents() {
+    return Array.from(subAgentRegistry.values());
+}
+/** 获取子 Agent */
+export function getSubAgent(id) {
+    return subAgentRegistry.get(id);
+}
+/** 创建子 Agent 工具 */
+export function createSubAgentTool() {
+    return {
+        name: "subagent",
+        label: "Sub-Agent",
+        description: `Delegate a task to a specialized sub-agent. Use this when:
+- The task requires specialized knowledge or capabilities
+- You want to parallelize work across multiple agents
+- The task is complex and benefits from focused attention
+
+Available sub-agents will be listed when you call with action="list".`,
+        parameters: Type.Object({
+            action: Type.Union([
+                Type.Literal("list"),
+                Type.Literal("run"),
+            ], { description: "Action to perform" }),
+            agent_id: Type.Optional(Type.String({ description: "ID of the sub-agent to run (for run action)" })),
+            prompt: Type.Optional(Type.String({ description: "The prompt/task to send to the sub-agent (for run action)" })),
+            context: Type.Optional(Type.Object({}, { description: "Additional context to pass to the sub-agent" })),
+        }),
+        execute: async (_toolCallId, args) => {
+            const params = args;
+            const action = readStringParam(params, "action", { required: true });
+            if (action === "list") {
+                const agents = getAllSubAgents();
+                if (agents.length === 0) {
+                    return jsonResult({
+                        status: "success",
+                        message: "No sub-agents registered",
+                        agents: [],
+                    });
+                }
+                return jsonResult({
+                    status: "success",
+                    agents: agents.map((a) => ({
+                        id: a.id,
+                        name: a.name,
+                        description: a.description,
+                    })),
+                });
+            }
+            if (action === "run") {
+                const agentId = readStringParam(params, "agent_id");
+                const prompt = readStringParam(params, "prompt");
+                if (!agentId) {
+                    return jsonResult({
+                        status: "error",
+                        error: "agent_id is required for run action",
+                    }, true);
+                }
+                if (!prompt) {
+                    return jsonResult({
+                        status: "error",
+                        error: "prompt is required for run action",
+                    }, true);
+                }
+                const agent = getSubAgent(agentId);
+                if (!agent) {
+                    return jsonResult({
+                        status: "error",
+                        error: `Sub-agent not found: ${agentId}`,
+                    }, true);
+                }
+                if (!subAgentRunner) {
+                    return jsonResult({
+                        status: "error",
+                        error: "Sub-agent runner not configured",
+                    }, true);
+                }
+                try {
+                    logger.info({ agentId, promptLength: prompt.length }, "Running sub-agent");
+                    const context = params.context;
+                    const result = await subAgentRunner(agentId, prompt, context);
+                    if (result.error) {
+                        return jsonResult({
+                            status: "error",
+                            error: result.error,
+                            partialContent: result.content,
+                        }, true);
+                    }
+                    return textResult(result.content, {
+                        agentId,
+                        agentName: agent.name,
+                    });
+                }
+                catch (error) {
+                    logger.error({ error, agentId }, "Sub-agent execution failed");
+                    return jsonResult({
+                        status: "error",
+                        error: error instanceof Error ? error.message : String(error),
+                    }, true);
+                }
+            }
+            return jsonResult({
+                status: "error",
+                error: `Unknown action: ${action}`,
+            }, true);
+        },
+    };
+}
+/** 预定义的子 Agent */
+export const PREDEFINED_SUBAGENTS = [
+    {
+        id: "researcher",
+        name: "Research Agent",
+        description: "Specialized in gathering information, reading documentation, and researching topics",
+        systemPrompt: `You are a Research Agent specialized in:
+- Finding and reading documentation
+- Gathering information from codebases
+- Summarizing findings clearly
+- Providing factual, well-sourced answers
+
+Focus on accuracy and completeness. Use available tools to read files and search.`,
+    },
+    {
+        id: "coder",
+        name: "Coding Agent",
+        description: "Specialized in writing and modifying code",
+        systemPrompt: `You are a Coding Agent specialized in:
+- Writing clean, efficient code
+- Following best practices and coding standards
+- Understanding existing code patterns
+- Making minimal, focused changes
+
+Focus on code quality and maintainability.`,
+    },
+    {
+        id: "reviewer",
+        name: "Code Review Agent",
+        description: "Specialized in reviewing code changes for quality, bugs, and best practices",
+        systemPrompt: `You are a Code Review Agent specialized in:
+- Identifying bugs and potential issues
+- Checking for security vulnerabilities
+- Evaluating code quality and readability
+- Suggesting improvements
+
+Be thorough but constructive in feedback.`,
+    },
+    {
+        id: "planner",
+        name: "Planning Agent",
+        description: "Specialized in breaking down complex tasks into actionable steps",
+        systemPrompt: `You are a Planning Agent specialized in:
+- Analyzing complex requirements
+- Breaking tasks into clear steps
+- Identifying dependencies and risks
+- Creating actionable plans
+
+Focus on clarity and feasibility.`,
+    },
+];
+/** 注册预定义的子 Agent */
+export function registerPredefinedSubAgents() {
+    for (const agent of PREDEFINED_SUBAGENTS) {
+        registerSubAgent(agent);
+    }
+}
+//# sourceMappingURL=subagent.js.map

package/dist/tools/builtin/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../../src/tools/builtin/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAmB1C,kBAAkB;AAClB,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;AAC/D,IAAI,cAAc,GAA0B,IAAI,CAAC;AAEjD,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAC/E,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,cAAc,GAAG,MAAM,CAAC;AAC1B,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE;;;;;sEAKqD;QAClE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aACpB,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;YACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC,CAAC;YACpG,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC,CAAC;YAChH,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC,CAAC;SACxG,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,IAA+B,CAAC;YAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;YAEtE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,UAAU,CAAC;wBAChB,MAAM,EAAE,SAAS;wBACjB,OAAO,EAAE,0BAA0B;wBACnC,MAAM,EAAE,EAAE;qBACX,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,UAAU,CAAC;oBAChB,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACzB,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;qBAC3B,CAAC,CAAC;iBACJ,CAAC,CAAC;YACL,CAAC;YAED,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAEjD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,UAAU,CAAC;wBAChB,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,qCAAqC;qBAC7C,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;gBAED,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,UAAU,CAAC;wBAChB,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,mCAAmC;qBAC3C,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;gBAED,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;gBACnC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,UAAU,CAAC;wBAChB,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,wBAAwB,OAAO,EAAE;qBACzC,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;gBAED,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,OAAO,UAAU,CAAC;wBAChB,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,iCAAiC;qBACzC,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC;oBAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,OAA8C,CAAC;oBACtE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;oBAE9D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,OAAO,UAAU,CAAC;4BAChB,MAAM,EAAE,OAAO;4BACf,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,cAAc,EAAE,MAAM,CAAC,OAAO;yBAC/B,EAAE,IAAI,CAAC,CAAC;oBACX,CAAC;oBAED,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE;wBAChC,OAAO;wBACP,SAAS,EAAE,KAAK,CAAC,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,4BAA4B,CAAC,CAAC;oBAC/D,OAAO,UAAU,CAAC;wBAChB,MAAM,EAAE,OAAO;wBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;YAED,OAAO,UAAU,CAAC;gBAChB,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,mBAAmB,MAAM,EAAE;aACnC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAkB;AAClB,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,qFAAqF;QAClG,YAAY,EAAE;;;;;;kFAMgE;KAC/E;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2CAA2C;QACxD,YAAY,EAAE;;;;;;2CAMyB;KACxC;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,6EAA6E;QAC1F,YAAY,EAAE;;;;;;0CAMwB;KACvC;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,kEAAkE;QAC/E,YAAY,EAAE;;;;;;kCAMgB;KAC/B;CACF,CAAC;AAEF,oBAAoB;AACpB,MAAM,UAAU,2BAA2B;IACzC,KAAK,MAAM,KAAK,IAAI,oBAAoB,EAAE,CAAC;QACzC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/tools/builtin/system.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 内置工具 - 系统工具
+ */
+import type { Tool } from "../types.js";
+/** 当前时间工具 */
+export declare function createCurrentTimeTool(): Tool;
+/** 计算器工具 */
+export declare function createCalculatorTool(): Tool;
+/** 延迟工具 (用于测试) */
+export declare function createDelayTool(): Tool;
+//# sourceMappingURL=system.d.ts.map

package/dist/tools/builtin/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/system.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,aAAa;AACb,wBAAgB,qBAAqB,IAAI,IAAI,CAsC5C;AAED,YAAY;AACZ,wBAAgB,oBAAoB,IAAI,IAAI,CA8B3C;AAkDD,kBAAkB;AAClB,wBAAgB,eAAe,IAAI,IAAI,CA+BtC"}