dominds 1.2.4 → 1.2.6

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('- 优先动作：change_mind(progress) → clear_mind');
+            return lines.join('\n');
+        }
+        if (snapshot.kind !== 'available') {
+            lines.push('- 状态：未知（token 统计不可用）');
+            lines.push('- 优先动作：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('- 优先动作：change_mind(progress) → clear_mind');
+                return lines.join('\n');
+            }
+            case 'critical': {
+                lines.push('- 状态：🔴 红（危险）');
+                if (remainingGenTurns !== undefined) {
+                    lines.push(`- 倒数：剩余 ${remainingGenTurns} 次生成机会；到 0 系统将自动开启新一轮以保持稳定性`);
+                }
+                lines.push('- 立刻：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,
+        };
+    },
+};