dominds 0.1.0

package/dist/tools/builtins.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Module: tools/builtins
+ *
+ * Registers built-in tools, toolsets, and reminder owners.
+ *
+ * Entry points (server/cli) must import this module once to populate registries.
+ */
+const apply_patch_1 = require("./apply-patch");
+const ctrl_1 = require("./ctrl");
+const diag_1 = require("./diag");
+const env_1 = require("./env");
+const fs_1 = require("./fs");
+const mcp_1 = require("./mcp");
+const mem_1 = require("./mem");
+const os_1 = require("./os");
+const registry_1 = require("./registry");
+const ripgrep_1 = require("./ripgrep");
+const team_mgmt_1 = require("./team-mgmt");
+const txt_1 = require("./txt");
+(0, registry_1.registerTool)(fs_1.listDirTool);
+(0, registry_1.registerTool)(fs_1.rmDirTool);
+(0, registry_1.registerTool)(fs_1.rmFileTool);
+(0, registry_1.registerTool)(fs_1.mkDirTool);
+(0, registry_1.registerTool)(fs_1.moveFileTool);
+(0, registry_1.registerTool)(fs_1.moveDirTool);
+(0, registry_1.registerTool)(txt_1.readFileTool);
+(0, registry_1.registerTool)(txt_1.createNewFileTool);
+(0, registry_1.registerTool)(txt_1.overwriteEntireFileTool);
+(0, registry_1.registerTool)(txt_1.prepareFileRangeEditTool);
+(0, registry_1.registerTool)(txt_1.applyFileModificationTool);
+(0, registry_1.registerTool)(txt_1.prepareFileAppendTool);
+(0, registry_1.registerTool)(txt_1.prepareFileInsertAfterTool);
+(0, registry_1.registerTool)(txt_1.prepareFileInsertBeforeTool);
+(0, registry_1.registerTool)(txt_1.prepareFileBlockReplaceTool);
+// Ripgrep tools
+(0, registry_1.registerTool)(ripgrep_1.ripgrepFilesTool);
+(0, registry_1.registerTool)(ripgrep_1.ripgrepSnippetsTool);
+(0, registry_1.registerTool)(ripgrep_1.ripgrepCountTool);
+(0, registry_1.registerTool)(ripgrep_1.ripgrepFixedTool);
+(0, registry_1.registerTool)(ripgrep_1.ripgrepSearchTool);
+// OS tools
+(0, registry_1.registerTool)(os_1.shellCmdTool);
+(0, registry_1.registerTool)(os_1.readonlyShellTool);
+(0, registry_1.registerTool)(os_1.stopDaemonTool);
+(0, registry_1.registerTool)(os_1.getDaemonOutputTool);
+// Codex-style compatibility tools
+(0, registry_1.registerTool)(apply_patch_1.applyPatchTool);
+// Env tools (local testing)
+(0, registry_1.registerTool)(env_1.envGetTool);
+(0, registry_1.registerTool)(env_1.envSetTool);
+(0, registry_1.registerTool)(env_1.envUnsetTool);
+// MCP tools (local testing/ops)
+(0, registry_1.registerTool)(mcp_1.mcpRestartTool);
+(0, registry_1.registerTool)(mcp_1.mcpReleaseTool);
+// Memory tools
+(0, registry_1.registerTool)(mem_1.addMemoryTool);
+(0, registry_1.registerTool)(mem_1.dropMemoryTool);
+(0, registry_1.registerTool)(mem_1.replaceMemoryTool);
+(0, registry_1.registerTool)(mem_1.clearMemoryTool);
+(0, registry_1.registerTool)(mem_1.addSharedMemoryTool);
+(0, registry_1.registerTool)(mem_1.dropSharedMemoryTool);
+(0, registry_1.registerTool)(mem_1.replaceSharedMemoryTool);
+(0, registry_1.registerTool)(mem_1.clearSharedMemoryTool);
+// Control tools
+(0, registry_1.registerTool)(ctrl_1.addReminderTool);
+(0, registry_1.registerTool)(ctrl_1.deleteReminderTool);
+(0, registry_1.registerTool)(ctrl_1.updateReminderTool);
+(0, registry_1.registerTool)(ctrl_1.clearMindTool);
+(0, registry_1.registerTool)(ctrl_1.changeMindTool);
+(0, registry_1.registerTool)(ctrl_1.recallTaskdocTool);
+// Team management tools (scoped to `.minds/**`)
+for (const tool of team_mgmt_1.teamMgmtTools) {
+    (0, registry_1.registerTool)(tool);
+}
+// Diag tools
+(0, registry_1.registerTool)(diag_1.verifyTellaskParsingTool);
+// Register well-known toolsets
+(0, registry_1.registerToolset)('memory', [mem_1.addMemoryTool, mem_1.dropMemoryTool, mem_1.replaceMemoryTool, mem_1.clearMemoryTool]);
+(0, registry_1.setToolsetMeta)('memory', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Personal memory tools', zh: '个人记忆工具' },
+});
+(0, registry_1.registerToolset)('team_memory', [
+    mem_1.addSharedMemoryTool,
+    mem_1.dropSharedMemoryTool,
+    mem_1.replaceSharedMemoryTool,
+    mem_1.clearSharedMemoryTool,
+]);
+(0, registry_1.setToolsetMeta)('team_memory', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Shared team memory tools', zh: '团队共享记忆工具' },
+});
+(0, registry_1.registerToolset)('control', [
+    ctrl_1.addReminderTool,
+    ctrl_1.deleteReminderTool,
+    ctrl_1.updateReminderTool,
+    ctrl_1.clearMindTool,
+    ctrl_1.changeMindTool,
+    ctrl_1.recallTaskdocTool,
+]);
+(0, registry_1.setToolsetMeta)('control', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Dialog control tools', zh: '对话控制工具' },
+});
+(0, registry_1.registerToolset)('os', [
+    os_1.shellCmdTool,
+    os_1.stopDaemonTool,
+    os_1.getDaemonOutputTool,
+    env_1.envGetTool,
+    env_1.envSetTool,
+    env_1.envUnsetTool,
+]);
+(0, registry_1.setToolsetMeta)('os', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Shell and process tools', zh: '命令行与进程工具' },
+});
+(0, registry_1.registerToolset)('mcp_admin', [
+    mcp_1.mcpRestartTool,
+    mcp_1.mcpReleaseTool,
+    env_1.envGetTool,
+    env_1.envSetTool,
+    env_1.envUnsetTool,
+]);
+(0, registry_1.setToolsetMeta)('mcp_admin', {
+    source: 'dominds',
+    descriptionI18n: { en: 'MCP administration tools', zh: 'MCP 管理工具' },
+});
+(0, registry_1.registerToolset)('ws_read', [
+    fs_1.listDirTool,
+    txt_1.readFileTool,
+    ripgrep_1.ripgrepFilesTool,
+    ripgrep_1.ripgrepSnippetsTool,
+    ripgrep_1.ripgrepCountTool,
+    ripgrep_1.ripgrepFixedTool,
+    ripgrep_1.ripgrepSearchTool,
+]);
+(0, registry_1.setToolsetMeta)('ws_read', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Workspace read-only tools', zh: '工作区只读工具' },
+});
+(0, registry_1.registerToolset)('ws_mod', [
+    fs_1.listDirTool,
+    fs_1.rmDirTool,
+    fs_1.rmFileTool,
+    fs_1.mkDirTool,
+    fs_1.moveFileTool,
+    fs_1.moveDirTool,
+    txt_1.readFileTool,
+    txt_1.createNewFileTool,
+    txt_1.overwriteEntireFileTool,
+    txt_1.prepareFileAppendTool,
+    txt_1.prepareFileInsertAfterTool,
+    txt_1.prepareFileInsertBeforeTool,
+    txt_1.prepareFileBlockReplaceTool,
+    txt_1.prepareFileRangeEditTool,
+    txt_1.applyFileModificationTool,
+    ripgrep_1.ripgrepFilesTool,
+    ripgrep_1.ripgrepSnippetsTool,
+    ripgrep_1.ripgrepCountTool,
+    ripgrep_1.ripgrepFixedTool,
+    ripgrep_1.ripgrepSearchTool,
+]);
+(0, registry_1.setToolsetMeta)('ws_mod', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Workspace read/write tools', zh: '工作区读写工具' },
+    promptFilesI18n: { en: './prompts/ws_mod.en.md', zh: './prompts/ws_mod.zh.md' },
+});
+// Codex-focused toolsets (function tools only; suitable for Codex provider)
+(0, registry_1.registerToolset)('codex_style_tools', [apply_patch_1.applyPatchTool, os_1.readonlyShellTool]);
+(0, registry_1.setToolsetMeta)('codex_style_tools', {
+    source: 'dominds',
+    descriptionI18n: {
+        en: 'Codex-style tools (apply_patch + readonly_shell)',
+        zh: 'Codex 风格工具（apply_patch + readonly_shell）',
+    },
+    promptI18n: {
+        en: 'Use `apply_patch` (Codex-style patch format) to modify files. Use `readonly_shell` for simple workspace inspection via a small allowlist (cat/rg/sed/ls/nl/wc/git show). You are explicitly authorized to call `readonly_shell` yourself; do not delegate it to a shell specialist. Paths must be relative to the workspace. `apply_patch` enforces Dominds directory allow/deny lists.',
+        zh: '使用 `apply_patch`（Codex 风格 patch 格式）修改文件；使用 `readonly_shell` 做少量只读命令行检查（仅允许 cat/rg/sed/ls/nl/wc/git show）。你已被明确授权自行调用 `readonly_shell`，不要把它委派给 shell 专员。路径必须相对工作区根目录。`apply_patch` 会按成员的目录权限（allow/deny）做访问控制。',
+    },
+});
+(0, registry_1.registerToolset)('team-mgmt', [...team_mgmt_1.teamMgmtTools]);
+(0, registry_1.setToolsetMeta)('team-mgmt', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Team management tools', zh: '团队管理工具' },
+    promptFilesI18n: { en: './prompts/team_mgmt.en.md', zh: './prompts/team_mgmt.zh.md' },
+});
+(0, registry_1.registerToolset)('diag', [diag_1.verifyTellaskParsingTool]);
+(0, registry_1.setToolsetMeta)('diag', {
+    source: 'dominds',
+    descriptionI18n: { en: 'Diagnostics tools', zh: '诊断工具' },
+});
+// Register ReminderOwners
+(0, registry_1.registerReminderOwner)(os_1.shellCmdReminderOwner);
+(0, registry_1.registerReminderOwner)(mcp_1.mcpLeaseReminderOwner);

package/dist/tools/context-health.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextHealthReminderOwner = void 0;
+const driver_messages_1 = require("../shared/i18n/driver-messages");
+const runtime_language_1 = require("../shared/runtime-language");
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// Reminder meta is persisted as JSON and may come from disk; runtime validation is required.
+function isContextHealthReminderMeta(value) {
+    if (!isRecord(value))
+        return false;
+    if (value['kind'] !== 'critical_countdown')
+        return false;
+    const remaining = value['remainingGenTurns'];
+    return typeof remaining === 'number' && Number.isFinite(remaining);
+}
+function clampRemainingGenTurns(n) {
+    const floored = Math.floor(n);
+    if (floored < 0)
+        return 0;
+    if (floored > 5)
+        return 5;
+    return floored;
+}
+function isLastContextHealthFromCurrentGeneration(dlg) {
+    const active = dlg.activeGenSeqOrUndefined;
+    const snapSeq = dlg.getLastContextHealthGenseq();
+    return active !== undefined && snapSeq !== undefined && active === snapSeq;
+}
+function formatContextHealthOwnerHeader(args) {
+    const { language, indexHuman, snapshot } = args;
+    const remainingGenTurns = typeof args.remainingGenTurns === 'number' ? args.remainingGenTurns : undefined;
+    if (language === 'zh') {
+        const lines = [
+            '📋',
+            `【系统托管提醒项 #${indexHuman}：上下文健康 / owner=context_health】`,
+            '- 自动更新/自动消失；不要手工 delete_reminder',
+        ];
+        if (!snapshot) {
+            lines.push('- 状态：未知（尚未获取上下文统计）');
+            lines.push('- 现在就做：用提醒项收敛关键细节（update_reminder）→ change_mind(progress) → clear_mind');
+            return lines.join('\n');
+        }
+        if (snapshot.kind !== 'available') {
+            lines.push('- 状态：未知（token 统计不可用）');
+            lines.push('- 现在就做：用提醒项收敛关键细节（update_reminder）→ change_mind(progress) → clear_mind');
+            return lines.join('\n');
+        }
+        switch (snapshot.level) {
+            case 'healthy': {
+                lines.push('- 状态：🟢 绿（健康）');
+                return lines.join('\n');
+            }
+            case 'caution': {
+                lines.push('- 状态：🟡 黄（必须尽快清理）');
+                lines.push('- 硬规程：先 update_reminder 收敛工作集 → 再 change_mind(progress) → 然后 clear_mind');
+                return lines.join('\n');
+            }
+            case 'critical': {
+                lines.push('- 状态：🔴 红（硬闸门）');
+                if (remainingGenTurns !== undefined) {
+                    lines.push(`- 倒数：剩余 ${remainingGenTurns} 次生成机会；到 0 系统将被动开启新一轮/新回合以保持稳定性`);
+                }
+                lines.push('- 禁止继续推进实现：先 update_reminder 收敛工作集 → 再 change_mind(progress) → 然后 clear_mind');
+                return lines.join('\n');
+            }
+            default: {
+                const _exhaustive = snapshot.level;
+                return _exhaustive;
+            }
+        }
+    }
+    const lines = [
+        '📋',
+        `【System-managed reminder item #${indexHuman}: context health / owner=context_health】`,
+        '- Auto-updating/auto-dropping; do not manually delete_reminder',
+    ];
+    if (!snapshot) {
+        lines.push('- Status: unknown (no context stats yet)');
+        lines.push('- Priority: change_mind(progress) → clear_mind');
+        return lines.join('\n');
+    }
+    if (snapshot.kind !== 'available') {
+        lines.push('- Status: unknown (token usage unavailable)');
+        lines.push('- Priority: change_mind(progress) → clear_mind');
+        return lines.join('\n');
+    }
+    switch (snapshot.level) {
+        case 'healthy': {
+            lines.push('- Status: 🟢 green (healthy)');
+            return lines.join('\n');
+        }
+        case 'caution': {
+            lines.push('- Status: 🟡 yellow (caution)');
+            lines.push('- Priority: change_mind(progress) → clear_mind');
+            return lines.join('\n');
+        }
+        case 'critical': {
+            lines.push('- Status: 🔴 red (critical)');
+            if (remainingGenTurns !== undefined) {
+                lines.push(`- Countdown: ${remainingGenTurns} generations left; at 0 auto-start new round`);
+            }
+            lines.push('- Must: change_mind(progress) → clear_mind');
+            return lines.join('\n');
+        }
+        default: {
+            const _exhaustive = snapshot.level;
+            return _exhaustive;
+        }
+    }
+}
+exports.contextHealthReminderOwner = {
+    name: 'context_health',
+    async updateReminder(dlg, reminder) {
+        if (reminder.owner !== exports.contextHealthReminderOwner) {
+            return { treatment: 'keep' };
+        }
+        const snapshot = dlg.getLastContextHealth();
+        if (!snapshot) {
+            return { treatment: 'keep' };
+        }
+        if (snapshot.kind !== 'available') {
+            return {
+                treatment: 'update',
+                updatedContent: (0, driver_messages_1.formatContextHealthReminderText)((0, runtime_language_1.getWorkLanguage)(), {
+                    kind: 'usage_unknown',
+                }),
+                updatedMeta: undefined,
+            };
+        }
+        if (snapshot.level === 'healthy') {
+            return { treatment: 'drop' };
+        }
+        if (snapshot.level === 'caution') {
+            return {
+                treatment: 'update',
+                updatedContent: (0, driver_messages_1.formatContextHealthReminderText)((0, runtime_language_1.getWorkLanguage)(), {
+                    kind: 'over_optimal',
+                }),
+                updatedMeta: undefined,
+            };
+        }
+        const meta = isContextHealthReminderMeta(reminder.meta) ? reminder.meta : undefined;
+        const initialized = meta !== undefined;
+        let remainingGenTurns = meta ? clampRemainingGenTurns(meta.remainingGenTurns) : 5;
+        if (initialized && isLastContextHealthFromCurrentGeneration(dlg) && remainingGenTurns > 0) {
+            remainingGenTurns -= 1;
+        }
+        const content = (0, driver_messages_1.formatContextHealthReminderText)((0, runtime_language_1.getWorkLanguage)(), {
+            kind: 'over_critical',
+            remainingGenTurns,
+        });
+        return {
+            treatment: 'update',
+            updatedContent: content,
+            updatedMeta: { kind: 'critical_countdown', remainingGenTurns },
+        };
+    },
+    async renderReminder(dlg, reminder, index) {
+        const snapshot = dlg.getLastContextHealth();
+        const meta = isContextHealthReminderMeta(reminder.meta) ? reminder.meta : undefined;
+        const language = (0, runtime_language_1.getWorkLanguage)();
+        const header = formatContextHealthOwnerHeader({
+            language,
+            indexHuman: index + 1,
+            snapshot,
+            remainingGenTurns: meta ? clampRemainingGenTurns(meta.remainingGenTurns) : undefined,
+        });
+        const rendered = `${header}\n---\n${reminder.content}`;
+        return {
+            type: 'transient_guide_msg',
+            role: 'assistant',
+            content: rendered,
+        };
+    },
+};