@gatanot/qualia_core 0.1.0

package/dist/tool/tools/read-memory.js

@@ -0,0 +1,58 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { getDataPath } from '../../paths.js';
+const MEMORY_PATH = getDataPath('memory.md');
+export const readMemoryTool = {
+    name: 'read_memory',
+    description: 'Read long-term memory (data/memory.md). Optionally pass a query for keyword search — returns matching lines with their category headers. Without query, returns the full memory content. Use when you need to recall previously stored information about users, yourself, or important events. Note: the memory snapshot taken at session creation may be stale; this tool always returns the latest.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Optional. Search keyword (case-insensitive). Returns matching lines with their category headers. Omit to return all memory.'
+            }
+        },
+        required: []
+    },
+    async execute(args, _ctx) {
+        try {
+            if (!existsSync(MEMORY_PATH)) {
+                return { success: true, output: '（暂无记忆内容）' };
+            }
+            const content = readFileSync(MEMORY_PATH, 'utf-8');
+            if (!content.trim()) {
+                return { success: true, output: '（暂无记忆内容）' };
+            }
+            const query = args.query;
+            if (!query?.trim()) {
+                return { success: true, output: content };
+            }
+            const lines = content.split('\n');
+            const lowerQuery = query.trim().toLowerCase();
+            const resultLines = [];
+            let lastHeader = '';
+            for (const line of lines) {
+                const isHeader = line.startsWith('## ');
+                if (isHeader) {
+                    lastHeader = line;
+                }
+                const isContent = line.trim() !== '' && !line.startsWith('## ');
+                if (isContent && line.toLowerCase().includes(lowerQuery)) {
+                    if (lastHeader && !resultLines.includes(lastHeader)) {
+                        resultLines.push(lastHeader);
+                        resultLines.push('');
+                    }
+                    resultLines.push(line);
+                }
+            }
+            if (resultLines.length === 0) {
+                return { success: true, output: `（记忆中没有找到与 "${query.trim()}" 相关的内容）` };
+            }
+            return { success: true, output: resultLines.join('\n') };
+        }
+        catch (error) {
+            return { success: false, output: '', error: `读取记忆失败: ${error.message}` };
+        }
+    }
+};
+//# sourceMappingURL=read-memory.js.map

package/dist/tool/tools/read-memory.js.map

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

package/dist/tool/tools/read-tasks.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const readTasksTool: ToolDef;
+//# sourceMappingURL=read-tasks.d.ts.map

package/dist/tool/tools/read-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tasks.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/read-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAGvD,eAAO,MAAM,aAAa,EAAE,OA4B3B,CAAC"}

package/dist/tool/tools/read-tasks.js

@@ -0,0 +1,29 @@
+import { getAllTasks, formatTasksForAI } from '../../task/index.js';
+export const readTasksTool = {
+    name: 'read_tasks',
+    description: 'Query scheduled task list and results. View all tasks (pending, running, completed, failed, paused) or filter by status. The AI is NOT automatically notified of completions — you must manually call this tool to check.',
+    parameters: {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                description: 'Filter by status: pending, running, completed, failed, paused. Omit to return all.'
+            }
+        },
+        required: []
+    },
+    execute: async (args) => {
+        const statusFilter = args.status?.trim();
+        let tasks = getAllTasks();
+        if (statusFilter) {
+            const valid = ['pending', 'running', 'completed', 'failed', 'paused'];
+            if (!valid.includes(statusFilter)) {
+                return { success: false, output: '', error: `无效的状态值 "${statusFilter}"，可选: ${valid.join(', ')}` };
+            }
+            tasks = tasks.filter((t) => t.status === statusFilter);
+        }
+        const output = formatTasksForAI(tasks);
+        return { success: true, output };
+    }
+};
+//# sourceMappingURL=read-tasks.js.map

package/dist/tool/tools/read-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tasks.js","sourceRoot":"","sources":["../../../src/tool/tools/read-tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAY;IACrC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,2NAA2N;IACxO,UAAU,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,MAAM,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oFAAoF;aACjG;SACD;QACD,QAAQ,EAAE,EAAE;KACZ;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAuB,EAAE;QAC5C,MAAM,YAAY,GAAI,IAAI,CAAC,MAAiB,EAAE,IAAI,EAAE,CAAC;QACrD,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;QAE1B,IAAI,YAAY,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,YAAY,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YAClG,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;CACD,CAAC"}

package/dist/tool/tools/schedule-task.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const scheduleTaskTool: ToolDef;
+//# sourceMappingURL=schedule-task.d.ts.map

package/dist/tool/tools/schedule-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-task.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/schedule-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAGvD,eAAO,MAAM,gBAAgB,EAAE,OAqD9B,CAAC"}

package/dist/tool/tools/schedule-task.js

@@ -0,0 +1,50 @@
+import { createTask } from '../../task/index.js';
+export const scheduleTaskTool = {
+    name: 'schedule_task',
+    description: 'Create a scheduled one-shot task. The task runs automatically at the specified future time (no conversation context) and the user is notified on completion. Before using, run exec to get the current system time to ensure scheduledAt is in the future.',
+    parameters: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Task name (short description, e.g. "Data processing")'
+            },
+            prompt: {
+                type: 'string',
+                description: 'Task description — this is the sole instruction the model receives when executing in the background with no conversation context. Must be self-contained: what to do, expected output format, any necessary details'
+            },
+            scheduledAt: {
+                type: 'string',
+                description: 'ISO 8601 datetime string (e.g. 2026-06-16T14:30:00Z). Must be in the future. Use exec to get current system time first.'
+            }
+        },
+        required: ['name', 'prompt', 'scheduledAt']
+    },
+    execute: async (args) => {
+        const name = args.name;
+        const prompt = args.prompt;
+        const scheduledAtStr = args.scheduledAt;
+        if (!name?.trim() || !prompt?.trim() || !scheduledAtStr?.trim()) {
+            return { success: false, output: '', error: '参数不完整：name、prompt、scheduledAt 均为必填' };
+        }
+        const scheduledAt = new Date(scheduledAtStr).getTime();
+        if (isNaN(scheduledAt)) {
+            return { success: false, output: '', error: `无法解析时间 "${scheduledAtStr}"，请使用 ISO 8601 格式，如 2026-06-16T14:30:00Z` };
+        }
+        const now = Date.now();
+        if (scheduledAt <= now) {
+            return { success: false, output: '', error: `计划执行时间 ${scheduledAtStr} 已过期。当前时间是 ${new Date(now).toISOString()}，请设置一个未来的时间` };
+        }
+        const maxFuture = now + 30 * 24 * 60 * 60 * 1000;
+        if (scheduledAt > maxFuture) {
+            return { success: false, output: '', error: `计划执行时间不能超过 30 天后` };
+        }
+        const task = await createTask(name.trim(), prompt.trim(), scheduledAt);
+        const formatted = new Date(scheduledAt).toISOString().replace('T', ' ').slice(0, 19);
+        return {
+            success: true,
+            output: `任务已创建:\n- ID: ${task.id.slice(0, 8)}\n- 名称: ${task.name}\n- 计划执行: ${formatted}\n\n任务将在指定时间自动执行，完成后通过 Email 通知你。`
+        };
+    }
+};
+//# sourceMappingURL=schedule-task.js.map

package/dist/tool/tools/schedule-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-task.js","sourceRoot":"","sources":["../../../src/tool/tools/schedule-task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACxC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,4PAA4P;IACzQ,UAAU,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,IAAI,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACpE;YACD,MAAM,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qNAAqN;aAClO;YACD,WAAW,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yHAAyH;aACtI;SACD;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC;KAC3C;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAuB,EAAE;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QACrC,MAAM,cAAc,GAAG,IAAI,CAAC,WAAqB,CAAC;QAElD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QACpF,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC;QACvD,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,cAAc,0CAA0C,EAAE,CAAC;QACnH,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,cAAc,cAAc,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC;QAC9H,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACjD,IAAI,WAAW,GAAG,SAAS,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAErF,OAAO;YACN,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,iBAAiB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,aAAa,SAAS,mCAAmC;SACzH,CAAC;IACH,CAAC;CACD,CAAC"}

package/dist/tool/tools/search-history.d.ts

@@ -0,0 +1,4 @@
+import type { Storage } from '../../storage/index.js';
+import type { ToolDef } from '../types.js';
+export declare function createSearchHistoryTool(storage: Storage): ToolDef;
+//# sourceMappingURL=search-history.d.ts.map

package/dist/tool/tools/search-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-history.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/search-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAuB,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAwBvD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAwCjE"}

package/dist/tool/tools/search-history.js

@@ -0,0 +1,58 @@
+function formatResults(results, query) {
+    if (results.length === 0) {
+        return `（未在历史对话中找到与 "${query}" 相关的内容）`;
+    }
+    const lines = [`找到 ${results.length} 条与 "${query}" 相关的结果：`];
+    let lastSession = '';
+    for (const r of results) {
+        if (r.sessionTitle !== lastSession) {
+            lastSession = r.sessionTitle;
+            lines.push('', `--- ${r.sessionTitle} ---`);
+        }
+        const date = new Date(r.createdAt).toLocaleString('zh-CN');
+        const roleLabel = r.role === 'user' ? '用户' : r.role === 'assistant' ? 'AI' : r.role;
+        const snippet = r.content.length > 200 ? r.content.slice(0, 200) + '...' : r.content;
+        lines.push(`[${date}] ${roleLabel}: ${snippet}`);
+    }
+    return lines.join('\n');
+}
+export function createSearchHistoryTool(storage) {
+    return {
+        name: 'search_history',
+        description: 'Search conversation history across all sessions with fuzzy text matching. Use when you need to recall what the user discussed before. Note: this searches chat records, not long-term memory (use read_memory for that).',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search keyword or phrase (case-insensitive). Matches content field of all messages.'
+                },
+                session_id: {
+                    type: 'string',
+                    description: 'Optional. Limit search to a specific session. Omit to search all sessions.'
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Optional. Max results, default 10.'
+                }
+            },
+            required: ['query']
+        },
+        async execute(args, _ctx) {
+            const query = args.query;
+            const sessionId = args.session_id;
+            const limit = args.limit || 10;
+            if (!query?.trim()) {
+                return { success: false, output: '', error: 'query 不能为空' };
+            }
+            try {
+                const results = await storage.searchMessages(query.trim(), sessionId || undefined, limit);
+                return { success: true, output: formatResults(results, query.trim()) };
+            }
+            catch (error) {
+                return { success: false, output: '', error: `搜索失败: ${error.message}` };
+            }
+        }
+    };
+}
+//# sourceMappingURL=search-history.js.map

package/dist/tool/tools/search-history.js.map

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

package/dist/tool/tools/web-search.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const webSearchTool: ToolDef;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tool/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/web-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAyCvD,eAAO,MAAM,aAAa,EAAE,OAiE3B,CAAC"}

package/dist/tool/tools/web-search.js

@@ -0,0 +1,89 @@
+import { readConfig } from '../../config/index.js';
+async function searchSearXNG(query, num, baseURL) {
+    const url = `${baseURL.replace(/\/+$/, '')}/search?format=json&q=${encodeURIComponent(query)}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`SearXNG returned ${res.status}`);
+    }
+    const json = await res.json();
+    const results = json.results || [];
+    return results.slice(0, num).map((r) => ({
+        title: r.title,
+        url: r.url,
+        snippet: r.content || ''
+    }));
+}
+async function searchTavily(query, num, apiKey) {
+    const res = await fetch('https://api.tavily.com/search', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
+        body: JSON.stringify({ query, max_results: num, include_answer: false })
+    });
+    if (!res.ok) {
+        throw new Error(`Tavily returned ${res.status}`);
+    }
+    const json = await res.json();
+    const results = json.results || [];
+    return results.slice(0, num).map((r) => ({
+        title: r.title,
+        url: r.url,
+        snippet: r.content || ''
+    }));
+}
+export const webSearchTool = {
+    name: 'web_search',
+    description: 'Search the internet for information. Use for latest news, documentation lookup, fact verification, etc. Only use when real-time or external knowledge is needed. Results include title, URL, and snippet.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query (keyword or question)'
+            },
+            num: {
+                type: 'integer',
+                description: 'Number of results, default 5, max 10'
+            }
+        },
+        required: ['query']
+    },
+    async execute(args, _ctx) {
+        const query = args.query?.trim();
+        if (!query) {
+            return { success: false, output: '', error: '缺少参数: query' };
+        }
+        const num = Math.min(Math.max(typeof args.num === 'number' ? args.num : 5, 1), 10);
+        const config = readConfig();
+        if (!config.searchEnabled) {
+            return { success: false, output: '', error: '搜索功能未启用，请在设置中开启' };
+        }
+        const provider = config.searchProvider || 'searxng';
+        try {
+            let results;
+            if (provider === 'tavily') {
+                if (!config.tavilyApiKey) {
+                    return { success: false, output: '', error: '未配置 Tavily API Key，请在设置中填写' };
+                }
+                results = await searchTavily(query, num, config.tavilyApiKey);
+            }
+            else {
+                const searxngURL = config.searxngURL || 'http://localhost:8080';
+                results = await searchSearXNG(query, num, searxngURL);
+            }
+            if (results.length === 0) {
+                return { success: true, output: `未找到与「${query}」相关的结果。` };
+            }
+            const formatted = results
+                .map((r, i) => `${i + 1}. **[${r.title}](${r.url})**\n   ${r.snippet}`)
+                .join('\n\n');
+            return {
+                success: true,
+                output: `搜索「${query}」的结果（共 ${results.length} 条）：\n\n${formatted}`
+            };
+        }
+        catch (error) {
+            return { success: false, output: '', error: `搜索失败: ${error.message}` };
+        }
+    }
+};
+//# sourceMappingURL=web-search.js.map

package/dist/tool/tools/web-search.js.map

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

package/dist/tool/tools/write-file.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDef } from '../types.js';
+/**
+ * write_file — 写入文件内容
+ *
+ * 自动创建不存在的父目录。覆盖已有文件。
+ * 使用原子写入（临时文件 + rename），崩溃时不留残缺文件。
+ * 覆盖已有文件时自动保留原文件的 BOM 和行尾格式（CRLF/LF）。
+ * 工作区内文件直接写入；工作区外需用户确认。
+ */
+export declare const writeFileTool: ToolDef;
+//# sourceMappingURL=write-file.d.ts.map

package/dist/tool/tools/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/write-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAKvD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,OA4E3B,CAAC"}

package/dist/tool/tools/write-file.js

@@ -0,0 +1,79 @@
+import { readFile, mkdir, stat } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { PendingConfirmation } from '../types.js';
+import { detectMeta, atomicWrite } from './file-utils.js';
+/**
+ * write_file — 写入文件内容
+ *
+ * 自动创建不存在的父目录。覆盖已有文件。
+ * 使用原子写入（临时文件 + rename），崩溃时不留残缺文件。
+ * 覆盖已有文件时自动保留原文件的 BOM 和行尾格式（CRLF/LF）。
+ * 工作区内文件直接写入；工作区外需用户确认。
+ */
+export const writeFileTool = {
+    name: 'write_file',
+    description: 'Write content to a file (overwrites). Creates missing parent directories automatically. Preserves existing file encoding (BOM, line endings) when overwriting.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'File path (relative to workspace or absolute)'
+            },
+            content: {
+                type: 'string',
+                description: 'Complete file content to write'
+            }
+        },
+        required: ['path', 'content']
+    },
+    async execute(args, ctx) {
+        const userPath = args.path;
+        const content = args.content;
+        if (!userPath) {
+            return { success: false, output: '', error: '缺少参数: path' };
+        }
+        if (content === undefined || content === null) {
+            return { success: false, output: '', error: '缺少参数: content' };
+        }
+        const resolved = ctx.resolvePath(userPath);
+        const { path: filePath, classification } = resolved;
+        if (!args.__confirmed) {
+            if (classification === 'reject') {
+                return { success: false, output: '', error: `拒绝写入系统路径: ${userPath}` };
+            }
+            if (classification === 'confirm') {
+                throw new PendingConfirmation('write_file', { path: userPath, content }, `文件 "${userPath}" 在工作区之外，确认写入？`);
+            }
+        }
+        try {
+            await mkdir(dirname(filePath), { recursive: true });
+            let existed = false;
+            let meta = undefined;
+            try {
+                const info = await stat(filePath);
+                existed = info.isFile();
+                if (existed) {
+                    const raw = await readFile(filePath, 'utf-8');
+                    meta = detectMeta(raw);
+                }
+            }
+            catch {
+                // new file
+            }
+            await atomicWrite(filePath, content, meta);
+            const action = existed ? '已更新' : '已创建';
+            const lines = content.split('\n').length;
+            const bytes = Buffer.byteLength(content, 'utf-8');
+            const metaNote = meta?.bom ? ' (已保留 BOM)' : '';
+            return {
+                success: true,
+                output: `${action}文件: ${userPath} (${lines} 行, ${bytes} 字节${metaNote})`
+            };
+        }
+        catch (error) {
+            return { success: false, output: '', error: `写入失败: ${error.message}` };
+        }
+    }
+};
+//# sourceMappingURL=write-file.js.map

package/dist/tool/tools/write-file.js.map

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

package/dist/tool/tools/write-memory.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const writeMemoryTool: ToolDef;
+//# sourceMappingURL=write-memory.d.ts.map

package/dist/tool/tools/write-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-memory.d.ts","sourceRoot":"","sources":["../../../src/tool/tools/write-memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AA+DvD,eAAO,MAAM,eAAe,EAAE,OA6C7B,CAAC"}

package/dist/tool/tools/write-memory.js

@@ -0,0 +1,99 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { getDataDir, getDataPath } from '../../paths.js';
+const SECTION_META = `
+## 关于我自己 (Qualia)
+我是一个运行在本地环境中的 AI 伴侣，帮助用户完成开发工作和日常任务。
+
+## 关于用户
+（待记录）
+
+## 重要事件
+（待记录）
+`;
+const MEMORY_PATH = getDataPath('memory.md');
+function ensureMemoryFile() {
+    const dir = getDataDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    if (!existsSync(MEMORY_PATH) || !readFileSync(MEMORY_PATH, 'utf-8').includes('## 关于用户')) {
+        writeFileSync(MEMORY_PATH, SECTION_META.trim().replace(/\r/g, '') + '\n', 'utf-8');
+    }
+}
+const CATEGORY_HEADERS = {
+    self: '## 关于我自己 (Qualia)',
+    user: '## 关于用户',
+    event: '## 重要事件'
+};
+function updateSection(current, category, content) {
+    const header = CATEGORY_HEADERS[category];
+    if (!header)
+        return current;
+    const sections = ['self', 'user', 'event'];
+    const idx = sections.indexOf(category);
+    let result = '';
+    let inTarget = false;
+    let done = false;
+    for (const line of current.split('\n')) {
+        const isHeader = line.startsWith('## ');
+        if (isHeader) {
+            if (inTarget) {
+                result += content + '\n\n';
+                done = true;
+            }
+            inTarget = (line === header);
+        }
+        else if (inTarget && !done) {
+            continue;
+        }
+        result += line + '\n';
+    }
+    if (inTarget && !done) {
+        result += content;
+    }
+    return result.trim() + '\n';
+}
+export const writeMemoryTool = {
+    name: 'write_memory',
+    description: 'Write important information to long-term memory (memory.md). Only use for information worth remembering long-term. Content is automatically injected into the system prompt of future sessions. Three categories: self (about yourself), user (about the user), event (important milestones). Each call overwrites the entire content of the given category.',
+    parameters: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                description: 'Memory category: self (about yourself), user (about the user), event (important events)',
+                enum: ['self', 'user', 'event']
+            },
+            content: {
+                type: 'string',
+                description: 'New content for this category (replaces existing). Write in Chinese, concise and brief, one item per line.'
+            }
+        },
+        required: ['category', 'content']
+    },
+    async execute(args, _ctx) {
+        const category = args.category;
+        const content = args.content;
+        if (!category || !CATEGORY_HEADERS[category]) {
+            return { success: false, output: '', error: `无效的类别: ${category}，可选: self, user, event` };
+        }
+        if (!content?.trim()) {
+            return { success: false, output: '', error: 'content 不能为空' };
+        }
+        try {
+            ensureMemoryFile();
+            const current = readFileSync(MEMORY_PATH, 'utf-8').replace(/\r/g, '');
+            const updated = updateSection(current, category, content.trim());
+            writeFileSync(MEMORY_PATH, updated, 'utf-8');
+            const header = CATEGORY_HEADERS[category];
+            return {
+                success: true,
+                output: `已更新记忆: ${header}\n${content}`
+            };
+        }
+        catch (error) {
+            return { success: false, output: '', error: `写入失败: ${error.message}` };
+        }
+    }
+};
+//# sourceMappingURL=write-memory.js.map

package/dist/tool/tools/write-memory.js.map

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

package/dist/tool/types.d.ts

@@ -0,0 +1,63 @@
+import type { ToolContext } from './env.js';
+/**
+ * 工具定义接口
+ *
+ * 每个工具实现此接口，包含名称、描述、参数 schema 和执行逻辑。
+ */
+export interface ToolDef {
+    /** 工具名称，用于 LLM function calling 和注册表查找 */
+    name: string;
+    /** 工具描述，用于 LLM 理解功能 */
+    description: string;
+    /** JSON Schema 参数定义 */
+    parameters: Record<string, unknown>;
+    /**
+     * 执行工具
+     * @param args - 调用参数
+     * @param ctx - 工具执行上下文（工作区根目录、路径安全等）
+     * @returns 执行结果
+     * @throws PendingConfirmation 当需要用户确认时
+     */
+    execute(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResult>;
+}
+/**
+ * 工具执行结果
+ */
+export interface ToolResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 输出内容 */
+    output: string;
+    /** 错误描述（success 为 false 时填充） */
+    error?: string;
+}
+/**
+ * 待确认异常
+ *
+ * 工具执行时如需要用户确认，抛出此异常。
+ * 上层 Agent Loop 捕获后通过 SSE 推送确认请求到前端，
+ * 用户确认后以 __confirmed: true 重新调用工具。
+ */
+export declare class PendingConfirmation extends Error {
+    /** 工具名称 */
+    toolName: string;
+    /** 调用参数 */
+    args: Record<string, unknown>;
+    /** 需要确认的原因 */
+    reason: string;
+    constructor(
+    /** 工具名称 */
+    toolName: string, 
+    /** 调用参数 */
+    args: Record<string, unknown>, 
+    /** 需要确认的原因 */
+    reason: string);
+    toJSON(): {
+        toolName: string;
+        args: Record<string, unknown>;
+        reason: string;
+    };
+}
+/** 命令安全分类 */
+export type CommandClassification = 'safe' | 'confirm' | 'reject';
+//# sourceMappingURL=types.d.ts.map