termux-dev 1.6.0 → 1.8.0

package/dist/core/locales/zh.js

@@ -0,0 +1,210 @@
+export const zh = {
+    'net.unknown': '未知网络错误',
+    'net.rateLimit': '已超出 API 请求频率限制 (429)',
+    'net.badGateway': '服务商网关暂时不可用 (502)',
+    'net.unavailable': '服务商服务器过载 (503)',
+    'net.gatewayTimeout': '服务商网关超时 (504)',
+    'net.offline': '无网络连接或 DNS 故障（离线）',
+    'net.reset': '与服务器的连接被重置',
+    'net.timeout': '网络连接超时',
+    'net.refused': '服务器拒绝了连接',
+    'net.fetchFailed': '网络请求失败（连接中断）',
+    'net.generic': '互联网连接故障',
+    'net.failedAfter': '网络错误：尝试 {n} 次后仍无法恢复连接（{reason}）。',
+    'conn.unstable': '连接不稳定（{reason}）',
+    'conn.reconnecting': '正在重连 {attempt}/{max} · {delay} 秒后重试',
+    'conn.restored': '连接已恢复',
+    'conn.classicUnstable': '连接不稳定（{reason}）',
+    'conn.classicRetry': '正在重连 [{attempt}/{max}]（暂停 {delay} 秒）...',
+    'conn.classicWaiting': '等待网络 [{attempt}/{max}]...',
+    'conn.classicRestored': '✓ 连接已恢复！继续生成...',
+    'stop.connection': '连接已取消',
+    'stop.stopped': '已停止',
+    'stop.interrupted': '已中断，正在发送你的消息',
+    'stop.classicConnection': '连接已取消 (Ctrl+C)。',
+    'stop.classicStopped': '生成已停止 (Ctrl+C)。',
+    'stop.classicInterrupted': '已中断：正在发送你的消息。',
+    'status.waiting': '等待模型',
+    'status.thinking': '思考中',
+    'status.writing': '撰写中',
+    'status.running': '运行中',
+    'status.reconnecting': '重连中',
+    'status.stop': 'ctrl+c 停止',
+    'status.thinkingLine': '思考',
+    'status.thoughtFor': '思考了 {sec} 秒',
+    'composer.placeholder': '描述任务或提出问题…',
+    'composer.queued': '已排队',
+    'composer.queuedMany': '{n} 条已排队',
+    'composer.queuedHint': 'ctrl+enter 立即发送 · ↓ 编辑',
+    'composer.hint1': 'enter 排队 · ctrl+c 停止',
+    'composer.hint2': 'enter 排队',
+    'composer.hint3': 'enter 排队 · ctrl+c 停止',
+    'composer.hint4': 'enter 排队',
+    'summary.toolOne': '{n} 个工具',
+    'summary.toolMany': '{n} 个工具',
+    'summary.in': '输入 {n}',
+    'summary.out': '输出 {n}',
+    'summary.stopped': '已停止',
+    'settings.title': '设置',
+    'settings.section.appearance': '外观',
+    'settings.section.agent': '智能体',
+    'settings.section.general': '通用',
+    'settings.section.about': '关于',
+    'settings.row.theme': '主题',
+    'settings.row.layout': '界面',
+    'settings.row.pureBlack': '黑色背景',
+    'settings.row.autoApprove': '自动批准 (YOLO)',
+    'settings.row.maxIterations': '最大步数',
+    'settings.row.memory': '项目记忆',
+    'settings.row.updates': '检查更新',
+    'settings.row.language': '语言',
+    'settings.row.about': '关于 devx',
+    'settings.short.theme': '主题',
+    'settings.short.layout': '界面',
+    'settings.short.pureBlack': '黑背景',
+    'settings.short.autoApprove': 'YOLO',
+    'settings.short.maxIterations': '步数',
+    'settings.short.memory': '记忆',
+    'settings.short.updates': '更新',
+    'settings.short.language': '语言',
+    'settings.short.about': '关于',
+    'settings.value.on': '开',
+    'settings.value.off': '关',
+    'settings.value.clean': '简洁',
+    'settings.value.classic': '经典',
+    'settings.value.unlimited': '不限',
+    'settings.value.steps': '{n} 步',
+    'settings.hint.theme': '整个界面的配色。左右键切换主题，面板会立即变色。',
+    'settings.hint.layout': '简洁：带边框的输入框、卡片和安静的工具行。经典：原来的 ASCII 布局。',
+    'settings.hint.pureBlack': '将终端背景设为深邃的 OLED 黑 (#0a0a0c)。关闭则保留你自己的背景。',
+    'settings.hint.autoApprove': '跳过常规的权限确认。危险命令和凭据文件仍会先询问。仅在本次会话有效：下次启动 devx 时会重新关闭。',
+    'settings.hint.maxIterations': '智能体处理一次请求最多可执行多少个工具步骤（编辑文件、运行命令）。',
+    'settings.hint.memory': '每次会话都会加载 .devx/memory.md 中的规则。',
+    'settings.hint.updates': '启动时在 GitHub 上查找 devx 新版本。无论开关，/update 都可用。',
+    'settings.hint.language': '界面语言：消息、设置和提示。代码和工具名称保持英文。',
+    'settings.hint.about': 'ApvCode 出品的终端原生 AI 编程智能体。MIT 许可证。github.com/apvcode/Termux-Dev',
+    'settings.warnYolo': '已开启：智能体将不经询问直接运行命令并编辑文件。',
+    'settings.keys.move': '移动',
+    'settings.keys.change': '更改',
+    'settings.keys.toggle': '切换',
+    'settings.keys.close': '关闭',
+    // ── /mcp panel
+    'mcp.title': 'MCP 服务器',
+    'mcp.count': '服务器：{n}',
+    'mcp.scope.user': '用户服务器',
+    'mcp.scope.project': '项目服务器',
+    'mcp.toolsCount': '工具：{n}',
+    'mcp.status.connected': '已连接',
+    'mcp.status.connecting': '连接中…',
+    'mcp.status.failed': '失败',
+    'mcp.status.disabled': '已禁用',
+    'mcp.empty': '尚未配置 MCP 服务器。',
+    'mcp.emptyHint': '运行 /mcp import 导入 Claude Code 的服务器，或用 /mcp add <名称> <命令> [参数] 添加。',
+    'mcp.detail.status': '状态',
+    'mcp.detail.command': '命令',
+    'mcp.detail.config': '配置',
+    'mcp.detail.capabilities': '能力',
+    'mcp.detail.tools': '工具',
+    'mcp.detail.error': '错误',
+    'mcp.action.tools': '查看工具',
+    'mcp.action.reconnect': '重新连接',
+    'mcp.action.disable': '禁用',
+    'mcp.action.enable': '启用',
+    'mcp.toolsTitle': '{name} 的工具',
+    'mcp.noTools': '该服务器没有提供工具。',
+    'mcp.tag.readOnly': '只读',
+    'mcp.tag.destructive': '破坏性',
+    'mcp.tag.openWorld': '开放世界',
+    'mcp.params': '参数',
+    'mcp.noParams': '没有参数。',
+    'mcp.required': '必填',
+    'mcp.more': '还有 {n} 个',
+    'mcp.keys.open': '打开',
+    'mcp.keys.back': '返回',
+    'mcp.keys.reload': '全部重载',
+    'mcp.keys.close': '关闭',
+    // ── questions from the agent
+    'questions.title': '问题',
+    'questions.custom': '输入自己的答案…',
+    'questions.skip': '跳过',
+    'questions.skipped': '（已跳过）',
+    'questions.yourAnswer': '你的答案：',
+    'questions.empty': '答案不能为空',
+    // ── confirmations
+    'confirm.yes': '是',
+    'confirm.no': '否',
+    'confirm.exitTitle': '退出',
+    'confirm.exit': '退出 devx？',
+    'confirm.goodbye': '再见',
+    'confirm.deleteAll': '删除全部 {n} 个已保存的会话？',
+    'confirm.update': '现在将 devx 更新到 v{version}？',
+    'confirm.commit': '用此信息提交更改？',
+    'trust.title': '工作区信任',
+    'trust.question': '首次进入此文件夹。信任它并允许智能体在这里工作吗？',
+    'trust.yes': '是，信任此文件夹',
+    'trust.no': '否，退出',
+    'trust.wantsYolo': '项目配置要求自动批准 (YOLO)',
+    'trust.wantsAllowlist': '项目配置允许这些命令：{list}',
+    'trust.exiting': '未信任该文件夹，devx 将退出',
+    'trust.mcpQuestion': '此项目想启动 MCP 服务器（本地程序，见上方列表）。允许吗？',
+    // ── view switches
+    'view.expandThought': 'ctrl+p 展开',
+    'view.expandOutput': 'ctrl+o 展开',
+    'view.moreLines': '… 还有 {n} 行',
+    // ── plan approval
+    'plan.cardTitle': '计划',
+    'plan.files': '文件',
+    'plan.ready': '计划已就绪。开始执行吗？',
+    'plan.go': 'Go：切换到 AGENT 模式并开始',
+    'plan.edit': '修改计划（留在 PLAN 模式）',
+    'plan.editHint': '说明要改什么：计划保持在 PLAN 模式并会重做。',
+    'plan.started': 'AGENT 模式：按已批准的计划执行',
+    // ── undo
+    'undo.question': '将 {n} 个文件恢复到上一轮之前的状态？',
+    'undo.note': '包括 shell 命令所做的更改。被 git 忽略的文件不受影响。',
+    'undo.done': '已恢复 {n} 个文件',
+    // ── permissions
+    'permissions.title': '无需询问即可执行',
+    'permissions.none': '目前没有无需询问的项目：在批准卡片上选择 Session 或 Always 即可添加。',
+    'permissions.hint': '/permissions clear 会清除全部（包括仅本次会话的）。',
+    'permissions.cleared': '已清除所有无需询问的许可',
+    // ── cost limit
+    'settings.row.costLimit': '费用上限',
+    'settings.short.costLimit': '费用上限',
+    'settings.hint.costLimit': '单次会话最多可花费的金额。达到 80% 时 devx 会提醒，达到上限时会停止任务，并在继续花费前询问。',
+    'cost.title': '费用上限',
+    'cost.warn': '已花费 {spent}：本次会话 {limit} 上限的 80%',
+    'cost.stopped': '已达到 {limit} 的费用上限：任务已停止',
+    'cost.reached': '本次会话已花费 {spent}，上限为 {limit}。继续花费吗？',
+    'cost.raise': '继续将把本次会话的上限提高到 {limit}。',
+    'cost.continue': '是，继续',
+    'cost.cancel': '否，暂不',
+    'cost.cancelled': '未发送任何内容。你的消息已回到输入行。',
+    // ── /copy and /rename
+    'copy.none': '还没有可复制的回答。',
+    'copy.done': '已复制最后一条回答（{n} 个字符）',
+    'copy.failed': '无法访问剪贴板（没有 wl-copy、xclip、xsel，且回答对终端来说太长）。',
+    'rename.done': '聊天已重命名：{name}',
+    'rename.usage': '用法：/rename <名称>。不带名称时，有了第一条回答后由 AI 重新命名。',
+    'rename.failed': 'AI 没有想出名称。请重试或自己指定：/rename <名称>。',
+    // ── memory
+    'memory.capped': '记忆太长：最旧的 {n} 条不会发送给模型（只能放下最新的）。请从 .devx/memory.md 中删除旧的。',
+    'mcp.removeUsage': '用法：/mcp remove <名称>',
+    'mcp.removeNotFound': '"{name}" 不在 ~/.devx/mcp.json 中。其他文件（项目、~/.devxrc.json）里的服务器需要手动从该文件删除。',
+    'mcp.removed': '已删除服务器 "{name}"',
+    // ── /rewind
+    'rewind.title': '回退',
+    'rewind.count': '{n} 条消息',
+    'rewind.current': '（当前：留在这里）',
+    'rewind.none': '还没有可以回到的你的消息。',
+    'rewind.later': '之后 {n} 条',
+    'rewind.ago.now': '刚刚',
+    'rewind.ago.min': '{n} 分钟前',
+    'rewind.ago.hour': '{n} 小时前',
+    'rewind.ago.day': '{n} 天前',
+    'rewind.filesQuestion': '也把文件（{n} 个）恢复到当时的样子吗？',
+    'rewind.filesYes': '是，文件也恢复',
+    'rewind.filesNo': '否，只回退对话',
+    'rewind.done': '已回到你的消息。之后的内容已被清除，模型也看不到了。修改消息后发送。',
+    'rewind.doneImages': '已回到你的消息（其中的图片未保留，请重新添加）。之后的内容已被清除，模型也看不到了。',
+};

package/dist/core/loop.js

@@ -1,5 +1,9 @@
+import { CONTEXT_USAGE_RATIO, toolSchemaTokens } from './context-stats.js';
+import { t } from './i18n.js';
+import { redactSecrets } from './redact.js';
+import { runHooks } from './hooks.js';
 import { isNetworkOrRetryableError, getHumanReadableNetworkError, waitDelay } from './network.js';
-function getActionDescription(toolName, args) {
+export function getActionDescription(toolName, args) {
     const t = toolName.toLowerCase();
     if (t === 'read_file' || t === 'view_file' || t === 'read') {
         return `→ Read ${args.path || args.filePath || args.targetFile || ''}`;
@@ -31,11 +35,27 @@ function getActionDescription(toolName, args) {
     if (t === 'todo_list' || t === 'update_todos') {
         return `→ Update Plan & Tasks`;
     }
+    if (t.startsWith('mcp__')) {
+        const [, server = 'mcp', ...rest] = toolName.split('__');
+        let brief = '';
+        try {
+            brief = args && Object.keys(args).length ? JSON.stringify(args) : '';
+        }
+        catch { }
+        return `→ MCP: ${server} · ${rest.join('__')}${brief ? ' ' + (brief.length > 120 ? brief.slice(0, 117) + '...' : brief) : ''}`;
+    }
     if (t === 'plan_ready') {
         return `→ Finalize Plan`;
     }
     return `→ Executing ${toolName}...`;
 }
+const CONTEXT_LENGTH_ERROR = /context[_ ]length|maximum context|context window|too many tokens|prompt is too long|reduce the length|input is too long|exceeds? the (?:model|maximum|max)/i;
+function isContextLengthError(err) {
+    const status = err?.status;
+    if (status !== undefined && status !== 400 && status !== 413 && status !== 422)
+        return false;
+    return CONTEXT_LENGTH_ERROR.test(String(err?.message || ''));
+}
 export class Agent {
     config;
     provider;
@@ -49,19 +69,31 @@ export class Agent {
         this.history = history;
         this.guard = guard;
     }
-    async *run(signal) {
+    async *run(signal, hooks) {
         let iterations = 0;
-        while (iterations < this.config.maxIterations) {
+        // A config without maxIterations used to make the loop exit immediately and silently.
+        const maxIterations = this.config.maxIterations > 0 ? this.config.maxIterations : 100;
+        while (iterations < maxIterations) {
             if (signal?.aborted) {
                 return;
             }
-            const wasCompacted = this.history.pruneToLimit(this.config.maxContextTokens);
+            // Messages the user typed while the previous step ran join the conversation here, between
+            // the tool results and the next request, so the model sees them before it decides what to do.
+            for (const message of (await hooks?.takePending?.()) ?? []) {
+                this.history.addMessage(message);
+                yield { type: 'user_message', content: message.content };
+            }
+            const toolDefinitions = Array.from(this.tools.values()).map((t) => t.definition);
+            // Tool schemas are sent with every request and count against the context window.
+            const schemaTokens = toolSchemaTokens(toolDefinitions);
+            const promptBudget = Math.max(1000, Math.floor(this.config.maxContextTokens * CONTEXT_USAGE_RATIO) - schemaTokens);
+            const wasCompacted = this.history.pruneToLimit(promptBudget);
             if (wasCompacted) {
                 yield { type: 'system', message: 'Context compacted to fit model context window.' };
             }
             const request = {
                 messages: this.history.getMessages(),
-                tools: Array.from(this.tools.values()).map((t) => t.definition),
+                tools: toolDefinitions,
                 signal,
             };
             if (request.tools.length === 0) {
@@ -69,6 +101,7 @@ export class Agent {
             }
             let response;
             let attempt = 0;
+            let contextRetries = 0;
             const maxRetries = 4;
             while (true) {
                 if (signal?.aborted)
@@ -111,6 +144,16 @@ export class Agent {
                     if (signal?.aborted || err.name === 'AbortError' || err.message?.includes('aborted')) {
                         return;
                     }
+                    // The provider says the prompt is too long (our estimate was too optimistic):
+                    // shrink the history harder and retry instead of failing the whole session.
+                    if (contextRetries < 2 && isContextLengthError(err)) {
+                        contextRetries++;
+                        const target = Math.floor(this.history.getTotalTokens() * (contextRetries === 1 ? 0.6 : 0.35));
+                        this.history.pruneToLimit(Math.max(500, target));
+                        request.messages = this.history.getMessages();
+                        yield { type: 'system', message: 'Provider reported the context is too long. Compacted history, retrying.' };
+                        continue;
+                    }
                     const isNetwork = isNetworkOrRetryableError(err);
                     if (isNetwork && attempt < maxRetries) {
                         attempt++;
@@ -129,7 +172,7 @@ export class Agent {
                         continue;
                     }
                     const errMsg = isNetwork
-                        ? `Ошибка сети: Не удалось восстановить интернет-соединение после ${attempt} попыток (${err.message}).`
+                        ? t('net.failedAfter', { n: attempt, reason: err.message })
                         : `API Error: ${err.message}`;
                     yield { type: 'error', message: errMsg, isFatal: true };
                     return;
@@ -138,6 +181,9 @@ export class Agent {
             if (signal?.aborted) {
                 return;
             }
+            for (const notice of this.provider.drainNotices?.() ?? []) {
+                yield { type: 'system', message: notice };
+            }
             if (!response) {
                 response = { content: '' };
             }
@@ -148,6 +194,9 @@ export class Agent {
             if (response.toolCalls && response.toolCalls.length > 0) {
                 assistantMsg.tool_calls = response.toolCalls;
             }
+            if (response.thinkingBlocks && response.thinkingBlocks.length > 0) {
+                assistantMsg.thinking_blocks = response.thinkingBlocks;
+            }
             this.history.addMessage(assistantMsg);
             if (response.usage) {
                 yield { type: 'usage', usage: response.usage };
@@ -157,64 +206,91 @@ export class Agent {
                 yield { type: 'text', content: assistantMsg.content };
             }
             if (!response.toolCalls || response.toolCalls.length === 0) {
+                // The user wrote something while the model was finishing: answer it instead of stopping.
+                if (hooks?.hasPending?.()) {
+                    iterations++;
+                    continue;
+                }
                 break;
             }
             const executedToolCallIds = new Set();
-            for (const call of response.toolCalls) {
-                if (signal?.aborted) {
-                    // Add synthetic responses for ALL remaining unexecuted tool calls
-                    for (const remaining of response.toolCalls) {
-                        if (!executedToolCallIds.has(remaining.id)) {
-                            this.history.addMessage({
-                                role: 'tool',
-                                content: '[Operation cancelled by user]',
-                                tool_call_id: remaining.id,
-                                name: remaining.name,
-                            });
-                        }
+            try {
+                for (const call of response.toolCalls) {
+                    if (signal?.aborted)
+                        return;
+                    const actionDesc = getActionDescription(call.name, call.arguments);
+                    yield { type: 'tool_start', id: call.id, name: call.name, argsRaw: JSON.stringify(call.arguments), actionDesc };
+                    if (signal?.aborted)
+                        return;
+                    let result = '';
+                    const tool = this.tools.get(call.name);
+                    if (!tool) {
+                        result = `Error: Tool '${call.name}' not found.`;
                     }
-                    return;
-                }
-                const actionDesc = getActionDescription(call.name, call.arguments);
-                yield { type: 'tool_start', id: call.id, name: call.name, argsRaw: JSON.stringify(call.arguments), actionDesc };
-                let result = '';
-                const tool = this.tools.get(call.name);
-                if (!tool) {
-                    result = `Error: Tool '${call.name}' not found.`;
-                }
-                else {
-                    try {
-                        tool.validateArgs(call.arguments);
-                        if (this.guard.check(tool.name, call.arguments)) {
-                            const allowed = await this.guard.askUser(tool.name, call.arguments);
-                            if (allowed) {
-                                result = await tool.execute(call.arguments, this.config);
+                    else if (call.argsError) {
+                        // Never run a tool with arguments we could not parse ({} could mean something else).
+                        result = `Error: ${call.argsError}`;
+                    }
+                    else {
+                        try {
+                            tool.validateArgs(call.arguments);
+                            // A hook of the user may say no before the user is even asked.
+                            const pre = await runHooks(this.config.hooks, 'PreToolUse', tool.name, call.arguments);
+                            if (pre.blocked) {
+                                result = `Blocked by a hook: ${pre.blocked}`;
                             }
                             else {
-                                result = 'Action denied by user.';
+                                const allowed = !this.guard.check(tool.name, call.arguments)
+                                    || await this.guard.askUser(tool.name, call.arguments);
+                                // Cancellation may arrive while waiting for confirmation.
+                                if (signal?.aborted)
+                                    return;
+                                result = allowed
+                                    ? await tool.execute(call.arguments, this.config, { signal })
+                                    : 'Action denied by user.';
+                                if (allowed) {
+                                    const post = await runHooks(this.config.hooks, 'PostToolUse', tool.name, call.arguments, result);
+                                    if (post.notes.length > 0)
+                                        result += `\n[hook] ${post.notes.join('\n[hook] ')}`;
+                                }
                             }
                         }
-                        else {
-                            result = await tool.execute(call.arguments, this.config);
+                        catch (err) {
+                            result = signal?.aborted
+                                ? '[Operation cancelled by user]'
+                                : `Error executing tool: ${err.message}`;
                         }
                     }
-                    catch (err) {
-                        result = `Error executing tool: ${err.message}`;
+                    // Keys and tokens in the output must not reach the model, the chat or the saved session.
+                    result = redactSecrets(result);
+                    // Save the result before yielding: the UI can stop consuming at any event.
+                    this.history.addMessage({
+                        role: 'tool',
+                        content: result,
+                        tool_call_id: call.id,
+                        name: call.name,
+                    });
+                    executedToolCallIds.add(call.id);
+                    yield { type: 'tool_end', id: call.id, name: call.name, result };
+                }
+            }
+            finally {
+                // Keep every tool call paired with a response, even if the consumer exits early.
+                for (const call of response.toolCalls) {
+                    if (!executedToolCallIds.has(call.id)) {
+                        this.history.addMessage({
+                            role: 'tool',
+                            content: '[Operation cancelled by user]',
+                            tool_call_id: call.id,
+                            name: call.name,
+                        });
                     }
                 }
-                yield { type: 'tool_end', id: call.id, name: call.name, result };
-                this.history.addMessage({
-                    role: 'tool',
-                    content: result,
-                    tool_call_id: call.id,
-                    name: call.name,
-                });
-                executedToolCallIds.add(call.id);
             }
             iterations++;
         }
-        if (iterations >= this.config.maxIterations) {
-            yield { type: 'system', message: `Reached max iterations (${this.config.maxIterations}).` };
+        if (iterations >= maxIterations) {
+            yield { type: 'system', message: `Reached max iterations (${maxIterations}).` };
         }
     }
 }

package/dist/core/memory.js

@@ -1,27 +1,54 @@
 import fs from 'fs/promises';
 import fsSync from 'fs';
 import path from 'path';
-const MEMORY_DIR = path.join(process.cwd(), '.devx');
-const MEMORY_FILE = path.join(MEMORY_DIR, 'memory.md');
+// Looked up when used, not when the module loads: the memory belongs to the folder devx works in.
+const memoryDir = () => path.join(process.cwd(), '.devx');
+const memoryFile = () => path.join(memoryDir(), 'memory.md');
+export const MEMORY_PROMPT_MAX_CHARS = 4000;
+/**
+ * The memory for the system prompt: all of it when it is small, else the newest facts that fit
+ * (facts are appended, so the end is the newest) and a line that says how many were left out.
+ */
+export function memoryForPrompt(text, max = MEMORY_PROMPT_MAX_CHARS) {
+    if (text.length <= max)
+        return { text, omitted: 0 };
+    const lines = text.split('\n');
+    const firstFact = lines.findIndex((l) => l.startsWith('•'));
+    const header = firstFact === -1 ? [] : lines.slice(0, firstFact);
+    const facts = (firstFact === -1 ? lines : lines.slice(firstFact)).filter((l) => l.trim().length > 0);
+    const note = (n) => `(${n} older facts left out: /memory shows all of them)`;
+    const kept = [];
+    let used = header.join('\n').length + note(facts.length).length + 2;
+    for (let i = facts.length - 1; i >= 0; i--) {
+        if (used + facts[i].length + 1 > max && kept.length > 0)
+            break;
+        kept.unshift(facts[i]);
+        used += facts[i].length + 1;
+    }
+    const omitted = facts.length - kept.length;
+    return { text: [...header, ...(omitted > 0 ? [note(omitted)] : []), ...kept].join('\n'), omitted };
+}
 export class MemoryManager {
+    /** The `Project memory` switch of the settings: off means the bank is not put into the prompt. */
+    static enabled = true;
     static async loadMemory() {
-        if (!fsSync.existsSync(MEMORY_FILE)) {
+        if (!fsSync.existsSync(memoryFile())) {
             return '';
         }
         try {
-            return await fs.readFile(MEMORY_FILE, 'utf8');
+            return await fs.readFile(memoryFile(), 'utf8');
         }
         catch {
             return '';
         }
     }
     static async addFact(fact) {
-        if (!fsSync.existsSync(MEMORY_DIR)) {
-            await fs.mkdir(MEMORY_DIR, { recursive: true });
+        if (!fsSync.existsSync(memoryDir())) {
+            await fs.mkdir(memoryDir(), { recursive: true });
         }
         let current = '';
-        if (fsSync.existsSync(MEMORY_FILE)) {
-            current = await fs.readFile(MEMORY_FILE, 'utf8');
+        if (fsSync.existsSync(memoryFile())) {
+            current = await fs.readFile(memoryFile(), 'utf8');
         }
         const trimmedFact = fact.trim();
         if (!trimmedFact)
@@ -32,16 +59,16 @@ export class MemoryManager {
                 current = `# Project Memory Bank\n\n## Established Rules & Architecture\n`;
             }
             current += entry;
-            await fs.writeFile(MEMORY_FILE, current, 'utf8');
+            await fs.writeFile(memoryFile(), current, 'utf8');
         }
     }
     static async clearMemory() {
-        if (fsSync.existsSync(MEMORY_FILE)) {
-            await fs.unlink(MEMORY_FILE);
+        if (fsSync.existsSync(memoryFile())) {
+            await fs.unlink(memoryFile());
         }
     }
     static isMemoryPresent() {
-        return fsSync.existsSync(MEMORY_FILE);
+        return fsSync.existsSync(memoryFile());
     }
 }
 export const saveMemoryTool = {

package/dist/core/models.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { catalogContextWindow } from './vision.js';
 const FALLBACK_LIMITS = {
     'claude-3.5-sonnet': 200000,
     'claude-3-opus': 200000,
@@ -38,47 +39,59 @@ function loadLimits() {
     return limitsCache;
 }
 export function getModelContextLimit(modelName) {
+    return getModelContextInfo(modelName).limit;
+}
+/**
+ * The context window of a model and how sure we are. The models.dev catalogue is asked first
+ * (it knows the maker's own number for thousands of models and is refreshed with /effort refresh),
+ * then devx's table, then rules by name, and only then a default of 128k.
+ */
+export function getModelContextInfo(modelName) {
+    const fromCatalogue = catalogContextWindow(modelName || '');
+    if (fromCatalogue)
+        return { limit: fromCatalogue, source: 'catalogue' };
+    const rule = (limit) => ({ limit, source: 'rule' });
     const cache = loadLimits();
     const clean = (modelName || '').trim().toLowerCase();
     const short = clean.split('/').pop() || clean;
     if (cache[clean])
-        return cache[clean];
+        return { limit: cache[clean], source: 'table' };
     if (cache[short])
-        return cache[short];
+        return { limit: cache[short], source: 'table' };
     const baseName = short.replace(/-\d{4,8}$/, '').replace(/:latest$/, '');
     if (cache[baseName])
-        return cache[baseName];
+        return { limit: cache[baseName], source: 'table' };
     if (clean.includes('kimi-k2') || clean.includes('kimi'))
-        return 256000;
+        return rule(256000);
     if (clean.includes('ox-alpha') || clean.includes('stealth'))
-        return 1048576;
+        return rule(1048576);
     if (clean.includes('gemini-3') || clean.includes('gemini-2') || clean.includes('gemini-1.5') || clean.includes('gemini'))
-        return 1048576;
+        return rule(1048576);
     if (clean.includes('claude-opus-4') || clean.includes('claude-4'))
-        return 1000000;
+        return rule(1000000);
     if (clean.includes('claude-3-5') || clean.includes('claude-3.5') || clean.includes('claude-3-7') || clean.includes('claude-3.7') || clean.includes('claude'))
-        return 200000;
+        return rule(200000);
     if (clean.includes('gpt-5'))
-        return 1050000;
+        return rule(1050000);
     if (clean.includes('gpt-4o') || clean.includes('gpt-4-turbo') || clean.includes('o1') || clean.includes('o3'))
-        return 128000;
+        return rule(128000);
     if (clean.includes('deepseek-v4') || clean.includes('deepseek-v3') || clean.includes('deepseek-r1') || clean.includes('deepseek'))
-        return 128000;
+        return rule(128000);
     if (clean.includes('qwen3.5') || clean.includes('qwen-3.5'))
-        return 262144;
+        return rule(262144);
     if (clean.includes('qwen2.5') || clean.includes('qwen-2.5') || clean.includes('qwen'))
-        return 131072;
+        return rule(131072);
     if (clean.includes('glm-5') || clean.includes('glm-4.7') || clean.includes('glm-4.6'))
-        return 200000;
+        return rule(200000);
     if (clean.includes('glm-4'))
-        return 128000;
+        return rule(128000);
     if (clean.includes('minimax-m1') || clean.includes('minimax'))
-        return 1000000;
+        return rule(1000000);
     if (clean.includes('doubao'))
-        return 256000;
+        return rule(256000);
     if (clean.includes('llama-3.3') || clean.includes('llama-3.1') || clean.includes('llama-3'))
-        return 128000;
+        return rule(128000);
     if (clean.includes('mistral-large') || clean.includes('codestral'))
-        return 128000;
-    return 128000;
+        return rule(128000);
+    return { limit: 128000, source: 'default' };
 }