dominds 0.1.0

package/dist/tools/mcp.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Module: tools/mcp
+ *
+ * Local MCP supervisor control tools for testing and operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpLeaseReminderOwner = exports.mcpReleaseTool = exports.mcpRestartTool = void 0;
+const log_1 = require("../log");
+const supervisor_1 = require("../mcp/supervisor");
+const log = (0, log_1.createLogger)('tools/mcp');
+function parseMcpRestartArgs(args) {
+    const serverId = args.serverId;
+    if (typeof serverId !== 'string' || !serverId.trim()) {
+        throw new Error(`mcp_restart.serverId must be a non-empty string`);
+    }
+    return { serverId };
+}
+function parseMcpReleaseArgs(args) {
+    const serverId = args.serverId;
+    if (typeof serverId !== 'string' || !serverId.trim()) {
+        throw new Error(`mcp_release.serverId must be a non-empty string`);
+    }
+    return { serverId };
+}
+function isMcpLeaseReminderMeta(value) {
+    if (!isRecord(value) || Array.isArray(value))
+        return false;
+    if (value.kind !== 'mcp_lease')
+        return false;
+    return typeof value.serverId === 'string' && value.serverId.trim().length > 0;
+}
+const mcpRestartSchema = {
+    type: 'object',
+    properties: {
+        serverId: {
+            type: 'string',
+            description: "MCP server id from `.minds/mcp.yaml` (e.g., 'sdk_stdio'). Restarts this server only.",
+        },
+    },
+    required: ['serverId'],
+    additionalProperties: false,
+};
+const mcpReleaseSchema = {
+    type: 'object',
+    properties: {
+        serverId: {
+            type: 'string',
+            description: "MCP server id from `.minds/mcp.yaml` (e.g., 'playwright'). Releases the leased MCP client for this dialog.",
+        },
+    },
+    required: ['serverId'],
+    additionalProperties: false,
+};
+exports.mcpRestartTool = {
+    type: 'func',
+    name: 'mcp_restart',
+    description: 'Restart a configured MCP server using the current `.minds/mcp.yaml` config (best-effort).',
+    descriptionI18n: {
+        en: 'Restart a configured MCP server using the current `.minds/mcp.yaml` config (best-effort).',
+        zh: '使用当前的 `.minds/mcp.yaml` 配置重启指定的 MCP 服务器（尽力而为）。',
+    },
+    parameters: mcpRestartSchema,
+    argsValidation: 'dominds',
+    call: async (_dlg, caller, args) => {
+        const parsed = parseMcpRestartArgs(args);
+        const res = await (0, supervisor_1.requestMcpServerRestart)(parsed.serverId);
+        log.warn('mcp_restart', { caller: caller.id, serverId: parsed.serverId, ok: res.ok });
+        if (!res.ok)
+            return `error: ${res.errorText}`;
+        return `ok: restarted ${parsed.serverId}`;
+    },
+};
+exports.mcpReleaseTool = {
+    type: 'func',
+    name: 'mcp_release',
+    description: 'Release a leased MCP toolset client for this dialog (stops the underlying process/connection).',
+    descriptionI18n: {
+        en: 'Release a leased MCP toolset client for this dialog (stops the underlying process/connection).',
+        zh: '释放当前对话租用的 MCP toolset client（停止底层进程/连接）。',
+    },
+    parameters: mcpReleaseSchema,
+    argsValidation: 'dominds',
+    call: async (dlg, caller, args) => {
+        const parsed = parseMcpReleaseArgs(args);
+        const dialogKey = dlg.id.key();
+        const res = (0, supervisor_1.releaseMcpToolsetLeaseForDialog)(parsed.serverId, dialogKey);
+        log.warn('mcp_release', {
+            caller: caller.id,
+            serverId: parsed.serverId,
+            ok: res.ok,
+            released: res.ok ? res.released : undefined,
+        });
+        if (!res.ok)
+            return `error: ${res.errorText}`;
+        if (!res.released) {
+            return `ok: no active lease for ${parsed.serverId} (or server is truely-stateless)`;
+        }
+        return `ok: released ${parsed.serverId} for dialog ${dialogKey}`;
+    },
+};
+exports.mcpLeaseReminderOwner = {
+    name: 'mcpLease',
+    async updateReminder(dlg, reminder) {
+        if (reminder.owner !== exports.mcpLeaseReminderOwner)
+            return { treatment: 'keep' };
+        if (!isMcpLeaseReminderMeta(reminder.meta))
+            return { treatment: 'keep' };
+        const dialogKey = dlg.id.key();
+        const leased = (0, supervisor_1.isMcpToolsetLeasedToDialog)(reminder.meta.serverId, dialogKey);
+        if (!leased) {
+            return { treatment: 'drop' };
+        }
+        return { treatment: 'keep' };
+    },
+    async renderReminder(dlg, reminder, index) {
+        if (reminder.owner !== exports.mcpLeaseReminderOwner || !isMcpLeaseReminderMeta(reminder.meta)) {
+            return {
+                type: 'transient_guide_msg',
+                role: 'assistant',
+                content: `System Reminder #${index + 1}\n\n${reminder.content}`,
+            };
+        }
+        const serverId = reminder.meta.serverId;
+        return {
+            type: 'transient_guide_msg',
+            role: 'assistant',
+            content: `MCP toolset lease #${index + 1}: \`${serverId}\`\n\n` +
+                `This MCP server is treated as non-stateless. A dedicated MCP client instance is leased to this dialog.\n\n` +
+                `When you are confident you won't need this toolset in the near future, release it to stop the underlying MCP process/connection:\n` +
+                `- \`mcp_release({\"serverId\":\"${serverId}\"})\`\n\n` +
+                `If another dialog uses the same MCP toolset concurrently, Dominds will spawn a separate MCP client instance for that dialog.`,
+        };
+    },
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}

package/dist/tools/mem.js

@@ -0,0 +1,349 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearSharedMemoryTool = exports.replaceSharedMemoryTool = exports.dropSharedMemoryTool = exports.addSharedMemoryTool = exports.clearMemoryTool = exports.replaceMemoryTool = exports.dropMemoryTool = exports.addMemoryTool = void 0;
+/**
+ * Module: tools/mem
+ *
+ * Memory management tools for personal and shared memory under `.minds/memory`.
+ * Add, drop, replace, clear operations with strict path validation.
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const tool_result_messages_1 = require("../shared/i18n/tool-result-messages");
+const runtime_language_1 = require("../shared/runtime-language");
+function getMemoryPath(params) {
+    if (path_1.default.isAbsolute(params.filePath)) {
+        return {
+            kind: 'invalid_path',
+            message: params.language === 'zh'
+                ? '❌ **错误**\n\n记忆路径必须是相对路径（不允许以 `/` 开头）。'
+                : '❌ **Error**\n\nMemory paths must be relative (absolute paths are not allowed).',
+        };
+    }
+    // Prevent path traversal by rejecting paths with '..'
+    if (params.filePath.includes('..')) {
+        return {
+            kind: 'invalid_path',
+            message: params.language === 'zh'
+                ? '❌ **错误**\n\n记忆路径不允许包含 `..`（禁止路径穿越）。'
+                : '❌ **Error**\n\nPath traversal is not allowed in memory paths (`..` is forbidden).',
+        };
+    }
+    const mindsDir = '.minds/memory';
+    const isShared = params.isShared === true;
+    const rel = isShared
+        ? path_1.default.join(mindsDir, 'team_shared', params.filePath)
+        : path_1.default.join(mindsDir, 'individual', params.caller.id, params.filePath);
+    return { kind: 'ok', rel };
+}
+exports.addMemoryTool = {
+    type: 'func',
+    name: 'add_memory',
+    description: 'Add a new memory file to the personal memory store.',
+    descriptionI18n: {
+        en: 'Add a new memory file to the personal memory store.',
+        zh: '向个人记忆库新增一个记忆文件。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path', 'content'],
+        properties: {
+            path: { type: 'string', description: 'Relative path inside your personal memory store.' },
+            content: { type: 'string', description: 'Memory content (written as-is).' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const pathValue = args['path'];
+        const contentValue = args['content'];
+        const filePath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        const content = typeof contentValue === 'string' ? contentValue : '';
+        if (!filePath) {
+            return language === 'zh' ? '错误：需要提供文件路径。' : 'Error: File path is required.';
+        }
+        if (content.length === 0) {
+            return language === 'zh'
+                ? '错误：需要提供记忆内容（content）。'
+                : 'Error: Memory content is required (content).';
+        }
+        const memoryPath = getMemoryPath({ language, caller, filePath });
+        if (memoryPath.kind === 'invalid_path') {
+            return memoryPath.message;
+        }
+        const fullPath = path_1.default.resolve(process.cwd(), memoryPath.rel);
+        if (fs_1.default.existsSync(fullPath)) {
+            return language === 'zh'
+                ? `错误：记忆文件 '${filePath}' 已存在。请使用 replace_memory 更新它。`
+                : `Error: Memory file '${filePath}' already exists. Use replace_memory to update it.`;
+        }
+        const dir = path_1.default.dirname(fullPath);
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(fullPath, content, 'utf8');
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'added');
+    },
+};
+exports.dropMemoryTool = {
+    type: 'func',
+    name: 'drop_memory',
+    description: 'Remove a memory file from the personal memory store.',
+    descriptionI18n: {
+        en: 'Remove a memory file from the personal memory store.',
+        zh: '从个人记忆库删除一个记忆文件。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Relative path inside your personal memory store.' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const pathValue = args['path'];
+        const filePath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        if (!filePath) {
+            return language === 'zh' ? '错误：需要提供文件路径。' : 'Error: File path is required.';
+        }
+        const memoryPath = getMemoryPath({ language, caller, filePath });
+        if (memoryPath.kind === 'invalid_path') {
+            return memoryPath.message;
+        }
+        const fullPath = path_1.default.resolve(process.cwd(), memoryPath.rel);
+        if (!fs_1.default.existsSync(fullPath)) {
+            return language === 'zh'
+                ? `错误：记忆文件 '${filePath}' 不存在。`
+                : `Error: Memory file '${filePath}' does not exist.`;
+        }
+        fs_1.default.unlinkSync(fullPath);
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'deleted');
+    },
+};
+exports.replaceMemoryTool = {
+    type: 'func',
+    name: 'replace_memory',
+    description: 'Replace the content of an existing memory file in the personal memory store.',
+    descriptionI18n: {
+        en: 'Replace the content of an existing memory file in the personal memory store.',
+        zh: '替换个人记忆库中已存在记忆文件的内容。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path', 'content'],
+        properties: {
+            path: { type: 'string', description: 'Relative path inside your personal memory store.' },
+            content: { type: 'string', description: 'New memory content (written as-is).' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const pathValue = args['path'];
+        const contentValue = args['content'];
+        const filePath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        const content = typeof contentValue === 'string' ? contentValue : '';
+        if (!filePath) {
+            return language === 'zh' ? '错误：需要提供文件路径。' : 'Error: File path is required.';
+        }
+        if (content.length === 0) {
+            return language === 'zh'
+                ? '错误：需要提供记忆内容（content）。'
+                : 'Error: Memory content is required (content).';
+        }
+        const memoryPath = getMemoryPath({ language, caller, filePath });
+        if (memoryPath.kind === 'invalid_path') {
+            return memoryPath.message;
+        }
+        const fullPath = path_1.default.resolve(process.cwd(), memoryPath.rel);
+        if (!fs_1.default.existsSync(fullPath)) {
+            return language === 'zh'
+                ? `错误：记忆文件 '${filePath}' 不存在。请使用 add_memory 创建它。`
+                : `Error: Memory file '${filePath}' does not exist. Use add_memory to create it.`;
+        }
+        fs_1.default.writeFileSync(fullPath, content, 'utf8');
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'updated');
+    },
+};
+exports.clearMemoryTool = {
+    type: 'func',
+    name: 'clear_memory',
+    description: 'Clear all memory files from the personal memory store.',
+    descriptionI18n: {
+        en: 'Clear all memory files from the personal memory store.',
+        zh: '清空个人记忆库中的所有记忆文件。',
+    },
+    parameters: { type: 'object', additionalProperties: false, properties: {} },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, _args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const memoryDir = path_1.default.join('.minds/memory/individual', caller.id);
+        const fullPath = path_1.default.resolve(process.cwd(), memoryDir);
+        if (!fs_1.default.existsSync(fullPath)) {
+            return language === 'zh' ? '没有可清空的个人记忆。' : 'No personal memory to clear.';
+        }
+        fs_1.default.rmSync(fullPath, { recursive: true, force: true });
+        fs_1.default.mkdirSync(fullPath, { recursive: true });
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'cleared');
+    },
+};
+exports.addSharedMemoryTool = {
+    type: 'func',
+    name: 'add_team_memory',
+    description: 'Add a new memory file to the shared team memory store.',
+    descriptionI18n: {
+        en: 'Add a new memory file to the shared team memory store.',
+        zh: '向团队共享记忆库新增一个记忆文件。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path', 'content'],
+        properties: {
+            path: { type: 'string', description: 'Relative path inside the shared team memory store.' },
+            content: { type: 'string', description: 'Shared memory content (written as-is).' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const pathValue = args['path'];
+        const contentValue = args['content'];
+        const filePath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        const content = typeof contentValue === 'string' ? contentValue : '';
+        if (!filePath) {
+            return language === 'zh' ? '错误：需要提供文件路径。' : 'Error: File path is required.';
+        }
+        if (content.length === 0) {
+            return language === 'zh'
+                ? '错误：需要提供共享记忆内容（content）。'
+                : 'Error: Shared memory content is required (content).';
+        }
+        const memoryPath = getMemoryPath({ language, caller, filePath, isShared: true });
+        if (memoryPath.kind === 'invalid_path') {
+            return memoryPath.message;
+        }
+        const fullPath = path_1.default.resolve(process.cwd(), memoryPath.rel);
+        if (fs_1.default.existsSync(fullPath)) {
+            return language === 'zh'
+                ? `错误：共享记忆文件 '${filePath}' 已存在。请使用 replace_team_memory 更新它。`
+                : `Error: Shared memory file '${filePath}' already exists. Use replace_team_memory to update it.`;
+        }
+        const dir = path_1.default.dirname(fullPath);
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(fullPath, content, 'utf8');
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'added');
+    },
+};
+exports.dropSharedMemoryTool = {
+    type: 'func',
+    name: 'drop_team_memory',
+    description: 'Remove a memory file from the shared team memory store.',
+    descriptionI18n: {
+        en: 'Remove a memory file from the shared team memory store.',
+        zh: '从团队共享记忆库删除一个记忆文件。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path'],
+        properties: {
+            path: { type: 'string', description: 'Relative path inside the shared team memory store.' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const pathValue = args['path'];
+        const filePath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        if (!filePath) {
+            return language === 'zh' ? '错误：需要提供文件路径。' : 'Error: File path is required.';
+        }
+        const memoryPath = getMemoryPath({ language, caller, filePath, isShared: true });
+        if (memoryPath.kind === 'invalid_path') {
+            return memoryPath.message;
+        }
+        const fullPath = path_1.default.resolve(process.cwd(), memoryPath.rel);
+        if (!fs_1.default.existsSync(fullPath)) {
+            return language === 'zh'
+                ? `错误：共享记忆文件 '${filePath}' 不存在。`
+                : `Error: Shared memory file '${filePath}' does not exist.`;
+        }
+        fs_1.default.unlinkSync(fullPath);
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'deleted');
+    },
+};
+exports.replaceSharedMemoryTool = {
+    type: 'func',
+    name: 'replace_team_memory',
+    description: 'Replace the content of an existing memory file in the shared team memory store.',
+    descriptionI18n: {
+        en: 'Replace the content of an existing memory file in the shared team memory store.',
+        zh: '替换团队共享记忆库中已存在记忆文件的内容。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path', 'content'],
+        properties: {
+            path: { type: 'string', description: 'Relative path inside the shared team memory store.' },
+            content: { type: 'string', description: 'New shared memory content (written as-is).' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(_dlg, caller, args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const pathValue = args['path'];
+        const contentValue = args['content'];
+        const filePath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        const content = typeof contentValue === 'string' ? contentValue : '';
+        if (!filePath) {
+            return language === 'zh' ? '错误：需要提供文件路径。' : 'Error: File path is required.';
+        }
+        if (content.length === 0) {
+            return language === 'zh'
+                ? '错误：需要提供共享记忆内容（content）。'
+                : 'Error: Shared memory content is required (content).';
+        }
+        const memoryPath = getMemoryPath({ language, caller, filePath, isShared: true });
+        if (memoryPath.kind === 'invalid_path') {
+            return memoryPath.message;
+        }
+        const fullPath = path_1.default.resolve(process.cwd(), memoryPath.rel);
+        if (!fs_1.default.existsSync(fullPath)) {
+            return language === 'zh'
+                ? `错误：共享记忆文件 '${filePath}' 不存在。请使用 add_team_memory 创建它。`
+                : `Error: Shared memory file '${filePath}' does not exist. Use add_team_memory to create it.`;
+        }
+        fs_1.default.writeFileSync(fullPath, content, 'utf8');
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'updated');
+    },
+};
+exports.clearSharedMemoryTool = {
+    type: 'func',
+    name: 'clear_team_memory',
+    description: 'Clear all files from the shared team memory store.',
+    descriptionI18n: {
+        en: 'Clear all files from the shared team memory store.',
+        zh: '清空团队共享记忆库中的所有文件。',
+    },
+    parameters: { type: 'object', additionalProperties: false, properties: {} },
+    argsValidation: 'dominds',
+    async call(_dlg, _caller, _args) {
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const memoryDir = '.minds/memory/team_shared';
+        const fullPath = path_1.default.resolve(process.cwd(), memoryDir);
+        if (!fs_1.default.existsSync(fullPath)) {
+            return language === 'zh' ? '没有可清空的共享记忆。' : 'No shared memory to clear.';
+        }
+        fs_1.default.rmSync(fullPath, { recursive: true, force: true });
+        fs_1.default.mkdirSync(fullPath, { recursive: true });
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'cleared');
+    },
+};