zames_pro 2.55.0 → 2.59.0

package/dist/index.js

@@ -11,14 +11,14 @@ import { createTodoStore, getTodos, setTodos, resetTodos, renderTodos, } from '.
 import { runAgentLoop } from './agent-loop.js';
 import { createSpinner } from './spinner.js';
 import { LineEditor, expandPastes, pasteReplacement, formatCompactTokens, } from './input.js';
-import { parseImagePaste, extForMime, saveToTemp, guessMime, isImageName, formatSize, looksLikeFilePath, readClipboardImageDetailed, sniffMime, readWindowsClipboardFiles, hasClipboardTool, contentHash, } from './attachments.js';
+import { parseImagePaste, extForMime, saveToTemp, guessMime, isImageName, formatSize, looksLikeFilePath, readClipboardImageDetailed, sniffMime, readWindowsClipboardFiles, hasClipboardTool, writeClipboardText, contentHash, } from './attachments.js';
 import { loadConfig, DEFAULTS, CONFIG_PATHS, ZAMES_HOME, CONFIG_SCHEMA, getByPath, validateConfigValue, writeConfigValue, resetConfigValue, } from './config.js';
 import { runConfigMenu } from './config-menu.js';
 import { translate, normalizeLocale, localeDisplayName, isLocale, } from './i18n.js';
 import { Transcript } from './transcript.js';
 import { UndoStore } from './undo.js';
 import { selfReview, selfDiff, selfApply, selfList } from './self-review.js';
-import { formatDiff, diffGitArgs, parseTranscript, summarizeTranscript, renderCost, formatExport, defaultExportPath, renderDoctor, resolveExtraDir, buildReviewPrompt, formatDuration, formatRelativeTime, trimRestoredMessages, RESTORED_HISTORY_LIMIT, mergeMessages, hasQueuedJob, isSlashCommand, parseQueueCommand, parseLiveToggle, parseGoalCommand, isLiveConfigCommand, withGoal, formatQueueList, ctrlCEscalation, } from './commands.js';
+import { formatDiff, formatDiffStat, formatContextSources, diffGitArgs, parseTranscript, summarizeTranscript, renderCost, formatExport, defaultExportPath, renderDoctor, resolveExtraDir, buildReviewPrompt, parseBacklogItems, nextBacklogItem, buildImprovePrompt, formatDuration, formatRelativeTime, trimRestoredMessages, RESTORED_HISTORY_LIMIT, mergeMessages, hasQueuedJob, isSlashCommand, parseQueueCommand, parseLiveToggle, parseGoalCommand, isLiveConfigCommand, withGoal, formatQueueList, ctrlCEscalation, } from './commands.js';
 import { performCompact } from './compact.js';
 import { Scheduler, parseInterval, formatInterval, formatJobLine, parseCron, } from './scheduler.js';
 import { renderMarkdown, setAnswerWidth } from './markdown.js';
@@ -27,6 +27,10 @@ import { assertCommandInsideRoot, runShell } from './shell.js';
 import { saveSession, loadLastSession, readSession, listSessions, sessionsDir, loadHistory, saveHistory, } from './sessions.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const NL = String.fromCharCode(10);
+// The last final assistant message, for the /copy command. Module-level
+// because runTask() (which sees the answers) and the main loop (which handles
+// /copy) are separate functions.
+let lastAssistantMessage = '';
 // Floor for a /loop interval. A loop faster than the send throttle (15s)
 // cannot do anything useful and would just hammer the rate limit, so we refuse
 // it. It does NOT touch the throttle itself.
@@ -54,7 +58,7 @@ function getPositional() {
     const positional = [];
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
-        if (['--dir', '--task', '--max-iter', '--project', '--chat'].includes(a)) {
+        if (['--dir', '--task', '--max-iter', '--chat', '--output-format'].includes(a)) {
             i++;
             continue;
         }
@@ -88,7 +92,6 @@ const headless = hasFlag('--headed')
     ? false
     : hasFlag('--headless') || config.headless;
 const debug = hasFlag('--debug') || config.debug;
-const calibrate = hasFlag('--calibrate');
 const maxIterArg = getArg('--max-iter', null);
 const maxIter = maxIterArg !== null ? Number(maxIterArg) : config.maxIterations;
 const positional = getPositional();
@@ -103,6 +106,23 @@ const resendPrompt = hasFlag('--resend-prompt');
 // --new-chat: kept for compatibility — this is the default behavior anyway.
 const newChatFlag = hasFlag('--new-chat');
 const resumeLastFlag = hasFlag('--resume-last');
+// Plan mode (read-only): start with it ON via --plan, toggle with /plan. When
+// on, mutating tools are filtered out of the tool set entirely (see
+// filterToolsForReadOnly). Declared here because tool creation happens before
+// the main loop.
+let planMode = hasFlag('--plan');
+// Machine-readable output for scripts/CI. 'text' (default) is the normal
+// human UI; 'json'/'jsonl' stream the transcript events as JSON lines on
+// stdout, while all human text is pushed to stderr so the stream stays clean.
+// Meant for one-shot mode (--task).
+const outputFormat = (getArg('--output-format', 'text') || 'text').toLowerCase();
+const jsonMode = outputFormat === 'json' || outputFormat === 'jsonl';
+if (jsonMode) {
+    // Keep stdout for the event stream only.
+    console.log = ((...a) => {
+        console.error(...a);
+    });
+}
 // ---------- session persistence ----------
 // We store sessions (DeepSeek chats) in ~/.zames/.sessions so they survive
 // a restart and are available for explicit restore (--resume-last,
@@ -171,6 +191,7 @@ const RELOADABLE = [
     'transcript',
     'spinner',
     'config',
+    'fsutil',
 ];
 const mod = {
     createTools,
@@ -289,8 +310,9 @@ ${theme.bold(t('help.options'))}
   --max-iter <n>     ${t('help.opt.max_iter', { n: config.maxIterations })}
   --headless         ${t('help.opt.headless')}
   --headed           ${t('help.opt.headed')}
+  --plan             ${t('help.opt.plan')}
+  --output-format <f> ${t('help.opt.output_format')}
   --debug            ${t('help.opt.debug')}
-  --calibrate        ${t('help.opt.calibrate')}
   --dev              ${t('help.opt.dev')}
   --no-color         ${t('help.opt.no_color')}
   --version, -v      ${t('help.opt.version')}
@@ -312,42 +334,61 @@ ${theme.bold(t('help.while_working'))}
   ${t('help.key.bang')}
 
 ${theme.bold(t('help.commands'))}
+
+${theme.bold(t('help.sec.session'))}
   ${t('help.cmd.new')}
   ${t('help.cmd.sessions')}
-  ${t('help.cmd.resume_id')}
   ${t('help.cmd.chats')}
   ${t('help.cmd.resume')}
+  ${t('help.cmd.resume_id')}
   ${t('help.cmd.last')}
+  ${t('help.cmd.retry')}
+  ${t('help.cmd.rename')}
+
+${theme.bold(t('help.sec.workspace'))}
   ${t('help.cmd.chat')}
   ${t('help.cmd.cd')}
   ${t('help.cmd.pwd')}
   ${t('help.cmd.status')}
   ${t('help.cmd.reload')}
-  ${t('help.cmd.undo')}
-  ${t('help.cmd.undo_list')}
-  ${t('help.cmd.transcript')}
+
+${theme.bold(t('help.sec.git'))}
   ${t('help.cmd.diff')}
-  ${t('help.cmd.cost')}
-  ${t('help.cmd.export')}
-  ${t('help.cmd.doctor')}
-  ${t('help.cmd.add_dir')}
-  ${t('help.cmd.review')}
+  ${t('help.cmd.diffstat')}
+
+${theme.bold(t('help.sec.agent'))}
   ${t('help.cmd.goal')}
   ${t('help.cmd.loop')}
   ${t('help.cmd.cron')}
   ${t('help.cmd.jobs')}
   ${t('help.cmd.thinking')}
   ${t('help.cmd.web')}
+  ${t('help.cmd.plan')}
   ${t('help.cmd.compact')}
   ${t('help.cmd.queue')}
   ${t('help.cmd.tasks')}
-  ${t('help.cmd.config')}
-  ${t('help.cmd.lang')}
+
+${theme.bold(t('help.sec.context'))}
+  ${t('help.cmd.context')}
   ${t('help.cmd.skills')}
   ${t('help.cmd.memory')}
   ${t('help.cmd.remember')}
   ${t('help.cmd.init')}
   ${t('help.cmd.mcp')}
+  ${t('help.cmd.config')}
+  ${t('help.cmd.lang')}
+
+${theme.bold(t('help.sec.files'))}
+  ${t('help.cmd.transcript')}
+  ${t('help.cmd.undo')}
+  ${t('help.cmd.undo_list')}
+  ${t('help.cmd.export')}
+  ${t('help.cmd.cost')}
+  ${t('help.cmd.copy')}
+  ${t('help.cmd.doctor')}
+  ${t('help.cmd.add_dir')}
+  ${t('help.cmd.review')}
+  ${t('help.cmd.improve')}
   ${t('help.cmd.debug_dom')}
   ${t('help.cmd.help')}
   ${t('help.cmd.exit')}
@@ -389,6 +430,10 @@ const SLASH_COMMANDS = [
     { name: '/resume', key: 'help.cmd.resume' },
     { name: '/resume-id', key: 'help.cmd.resume_id' },
     { name: '/last', key: 'help.cmd.last' },
+    { name: '/retry', key: 'help.cmd.retry' },
+    { name: '/rename', key: 'help.cmd.rename' },
+    { name: '/context', key: 'help.cmd.context' },
+    { name: '/copy', key: 'help.cmd.copy' },
     { name: '/chat', key: 'help.cmd.chat' },
     { name: '/cd', key: 'help.cmd.cd' },
     { name: '/pwd', key: 'help.cmd.pwd' },
@@ -398,17 +443,20 @@ const SLASH_COMMANDS = [
     { name: '/undo-list', key: 'help.cmd.undo_list' },
     { name: '/transcript', key: 'help.cmd.transcript' },
     { name: '/diff', key: 'help.cmd.diff' },
+    { name: '/diffstat', key: 'help.cmd.diffstat' },
     { name: '/cost', key: 'help.cmd.cost' },
     { name: '/export', key: 'help.cmd.export' },
     { name: '/doctor', key: 'help.cmd.doctor' },
     { name: '/add-dir', key: 'help.cmd.add_dir' },
     { name: '/review', key: 'help.cmd.review' },
+    { name: '/improve', key: 'help.cmd.improve' },
     { name: '/goal', key: 'help.cmd.goal' },
     { name: '/loop', key: 'help.cmd.loop' },
     { name: '/cron', key: 'help.cmd.cron' },
     { name: '/jobs', key: 'help.cmd.jobs' },
     { name: '/thinking', key: 'help.cmd.thinking' },
     { name: '/web', key: 'help.cmd.web' },
+    { name: '/plan', key: 'help.cmd.plan' },
     { name: '/compact', key: 'help.cmd.compact' },
     { name: '/queue', key: 'help.cmd.queue' },
     { name: '/tasks', key: 'help.cmd.tasks' },
@@ -1008,7 +1056,7 @@ async function printRestoredHistory(browser, ui, chatId = null) {
 }
 // ---------- task runner ----------
 async function runTask(browser, tools, taskText, workdir, opts, attachments = []) {
-    const { transcript, freshChat, sendSystemPrompt, queue = [], ui: editor, onChatReady, onAutoCompact = null, autoCompactPct = 95, contextLimit = 1_000_000, getTokenUsage = null, goal = null, } = opts;
+    const { transcript, freshChat, sendSystemPrompt, queue = [], ui: editor, onChatReady, onAutoCompact = null, autoCompactPct = 95, contextLimit = 1_000_000, getTokenUsage = null, goal = null, todosQuery = null, } = opts;
     // In TTY mode the UI is a LineEditor: it owns the input (queue, Esc,
     // Ctrl+C) and draws the status ABOVE the permanent input line. In non-TTY
     // mode (pipes) — a regular spinner + watchInput.
@@ -1016,6 +1064,12 @@ async function runTask(browser, tools, taskText, workdir, opts, attachments = []
     browser._stopped = false;
     browser._abort = false;
     const ui = editor || mod.createSpinner(currentLocale);
+    // Non-TTY parity: the ora spinner shows the same "tasks: 2/5" badge the
+    // LineEditor shows (the editor gets it via onTasksQuery in main()).
+    if (!editor && todosQuery && 'onTasksQuery' in ui) {
+        ;
+        ui.onTasksQuery = todosQuery;
+    }
     // Mark the editor busy for the WHOLE task, not only for /init and /self-fix.
     // Esc / Ctrl+C abort the current generation only while busy; without this a
     // long-running tool (Bash, npm, MCP) could not be interrupted — Esc did
@@ -1089,7 +1143,14 @@ async function runTask(browser, tools, taskText, workdir, opts, attachments = []
                     ui.toolCall(name, toolArgs);
                 },
                 onToolResult: (result) => ui.toolResult(result),
-                onAssistantMessage: (msg) => ui.assistant(msg),
+                onAssistantMessage: (msg) => {
+                    // Remember the last answer so /copy can put it on the clipboard
+                    // without re-reading the chat. Wrapped: a UI failure is swallowed
+                    // by agent-loop anyway.
+                    lastAssistantMessage = msg;
+                    opts.onAssistantFinal?.(msg);
+                    ui.assistant(msg);
+                },
                 onWarning: (msg) => ui.warning(msg),
                 onChatReady,
                 debugLog: debug,
@@ -1221,9 +1282,6 @@ async function main() {
         printHelp();
         return;
     }
-    if (calibrate) {
-        console.log(theme.warn(t('calibrate')));
-    }
     await cleanTmpDir();
     let currentWorkdir;
     let sandboxRoot;
@@ -1242,6 +1300,9 @@ async function main() {
         dir: config.transcript.dir,
         enabled: config.transcript.enabled,
         sessionName: dirLabel(currentWorkdir),
+        // In json/jsonl mode mirror every event to stdout as a JSON line, even
+        // when the transcript FILE is disabled.
+        onLine: jsonMode ? (line) => process.stdout.write(line) : null,
     });
     if (transcript.file) {
         console.log(theme.system(t('msg.transcript', { v: transcript.file })));
@@ -1263,6 +1324,8 @@ async function main() {
             if (srv.error)
                 console.error(theme.warn(t('mcp.server_error', { name: srv.name, error: srv.error })));
         }
+        for (const w of st.warnings)
+            console.error(theme.warn(w));
     }
     catch (e) {
         console.error(theme.warn(t('mcp.load_failed', { v: e.message })));
@@ -1303,7 +1366,10 @@ async function main() {
     }
     // One-shot mode
     if (task) {
-        const tools = mod.createTools(currentWorkdir, { undo });
+        const tools = mod.createTools(currentWorkdir, {
+            undo,
+            readOnly: planMode,
+        });
         if (mcpPool)
             tools.push(...mcpPool.tools);
         let freshChat = true;
@@ -1366,6 +1432,8 @@ async function main() {
     const promptOnResume = () => resendPrompt || config.browser.resendPromptOnResume === true;
     let lastChats = [];
     let currentChatId = null;
+    // The last task the operator sent (used by /retry). Plain text only.
+    let lastTaskText = '';
     let running = true;
     // The agent's TodoWrite checklist, shared with the tool factory and
     // persisted in the session JSON. A store (not module state) so /reload does
@@ -2746,6 +2814,28 @@ async function main() {
                 continue;
             }
         }
+        if (lower === '/plan' || lower.startsWith('/plan ')) {
+            const arg = trimmed.slice('/plan'.length).trim().toLowerCase();
+            if (arg === '' || arg === 'toggle')
+                planMode = !planMode;
+            else if (arg === 'on' || arg === '1' || arg === 'true' || arg === 'вкл')
+                planMode = true;
+            else if (arg === 'off' ||
+                arg === '0' ||
+                arg === 'false' ||
+                arg === 'выкл')
+                planMode = false;
+            else {
+                console.error(theme.warn(t('msg.unknown_cmd', { v: trimmed })));
+                continue;
+            }
+            const line = t(planMode ? 'plan.on' : 'plan.off');
+            if (editor)
+                editor.printAbove(theme.system(line));
+            else
+                console.log(theme.system(line));
+            continue;
+        }
         if (lower === '/mcp') {
             if (!mcpPool) {
                 console.log(theme.dim(t('mcp.none')));
@@ -2768,6 +2858,8 @@ async function main() {
                         theme.dim('(' + String(srv.tools.length) + ')'));
                 }
             }
+            for (const w of st.warnings)
+                console.log(theme.warn('  ' + w));
             continue;
         }
         if (lower === '/skills') {
@@ -2999,6 +3091,98 @@ async function main() {
             console.log(theme.system(transcript.file || t('common.off')));
             continue;
         }
+        if (lower === '/context') {
+            // Show what buildSystemPrompt() injects (AGENTS/MEMORY/skills/commands)
+            // so the operator can see why the context is large. Best-effort: a broken
+            // file must not break the command.
+            try {
+                const { loadProjectContext } = await import('./context.js');
+                const ctx = await loadProjectContext(currentWorkdir);
+                const sysLen = mod.buildSystemPrompt({
+                    workdir: currentWorkdir,
+                    tools: mod.createTools(currentWorkdir, { undo, todos: todoStore }),
+                    locale: currentLocale,
+                    context: ctx,
+                }).length;
+                console.log(theme.system(formatContextSources(ctx.agents, ctx.memory, ctx.skills, ctx.commands, { systemPromptChars: sysLen }, t)));
+            }
+            catch (e) {
+                console.error(theme.error(e.message));
+            }
+            continue;
+        }
+        if (lower === '/rename' || lower.startsWith('/rename ')) {
+            const title = trimmed.slice('/rename'.length).trim();
+            if (!title) {
+                console.log(theme.dim(t('rename.usage')));
+                continue;
+            }
+            if (!currentChatId) {
+                currentChatId = await browser.getCurrentChatId();
+            }
+            if (!currentChatId) {
+                console.error(theme.error(t('chats.not_created')));
+                continue;
+            }
+            saveLastChat(currentChatId, currentWorkdir, title);
+            console.log(theme.assistant(t('rename.done', { v: title })));
+            continue;
+        }
+        if (lower === '/copy') {
+            if (!lastAssistantMessage) {
+                console.log(theme.dim(t('copy.none')));
+                continue;
+            }
+            const res = writeClipboardText(lastAssistantMessage);
+            if (res.ok) {
+                console.log(theme.assistant(t('copy.done', { tool: res.via })));
+            }
+            else {
+                console.error(theme.warn(t('copy.failed', { tool: res.via })));
+            }
+            continue;
+        }
+        if (lower === '/retry') {
+            if (!lastTaskText) {
+                console.log(theme.dim(t('retry.none')));
+                continue;
+            }
+            console.log(theme.system(t('retry.running')));
+            // Re-send the last task into the SAME chat (no new chat, no system
+            // prompt), so a truncated/empty answer can be retried cheaply.
+            const tools = mod.createTools(currentWorkdir, {
+                undo,
+                todos: todoStore,
+                readOnly: planMode,
+            });
+            if (mcpPool)
+                tools.push(...mcpPool.tools);
+            if (editor)
+                editor.busy = true;
+            try {
+                await runTask(browser, tools, lastTaskText, currentWorkdir, {
+                    transcript,
+                    freshChat: false,
+                    sendSystemPrompt: false,
+                    queue: pendingQueue,
+                    ui: editor || null,
+                    onChatReady: (chatId) => {
+                        if (chatId) {
+                            currentChatId = chatId;
+                            saveLastChat(chatId, currentWorkdir);
+                        }
+                    },
+                    contextLimit: config.ui.contextLimit,
+                    getTokenUsage: () => browser.getLastTokenUsage(),
+                    goal: sessionGoal,
+                });
+            }
+            finally {
+                if (editor)
+                    editor.busy = false;
+            }
+            continue;
+        }
         if (lower === '/diff' || lower.startsWith('/diff ')) {
             const staged = lower.indexOf('--staged') !== -1;
             const { runGit } = await import('./gitTools.js');
@@ -3011,6 +3195,17 @@ async function main() {
             console.log(theme.system(formatDiff(out, { maxLines: 400 }, t)));
             continue;
         }
+        if (lower === '/diffstat') {
+            const { runGit } = await import('./gitTools.js');
+            const probe = await runGit('git rev-parse --is-inside-work-tree', currentWorkdir, 5000);
+            if (probe.trim() !== 'true') {
+                console.error(theme.error(t('diff.not_repo')));
+                continue;
+            }
+            const out = await runGit('git diff --stat', currentWorkdir, 20_000);
+            console.log(theme.system(formatDiffStat(out, { maxLines: 60 }, t)));
+            continue;
+        }
         if (lower === '/cost' || lower === '/usage') {
             let stats = summarizeTranscript([]);
             if (transcript.file) {
@@ -3143,6 +3338,58 @@ async function main() {
             }
             continue;
         }
+        if (lower === '/improve' || lower.startsWith('/improve ')) {
+            // Backlog-driven self-improvement: pick the next open BACKLOG item (or a
+            // specific id) and run the standard task loop on it. The agent reads
+            // BACKLOG.md itself for the details, so a FRESH agent needs no external
+            // context — this is the reproducible hand-off path.
+            const arg = trimmed.slice('/improve'.length).trim();
+            let backlogText;
+            try {
+                backlogText = await fs.readFile(path.join(currentWorkdir, 'BACKLOG.md'), 'utf-8');
+            }
+            catch {
+                console.error(theme.warn(t('improve.no_backlog')));
+                continue;
+            }
+            const items = parseBacklogItems(backlogText);
+            const item = nextBacklogItem(items, arg || undefined);
+            if (!item) {
+                console.log(theme.dim(arg ? t('improve.not_found', { v: arg }) : t('improve.all_done')));
+                continue;
+            }
+            console.log(theme.system(t('improve.start', { id: item.id, title: item.title })));
+            const improveTools = mod.createTools(currentWorkdir, {
+                undo,
+                todos: todoStore,
+                readOnly: planMode,
+            });
+            if (mcpPool)
+                improveTools.push(...mcpPool.tools);
+            if (editor)
+                editor.busy = true;
+            try {
+                await runTask(browser, improveTools, buildImprovePrompt(item), currentWorkdir, {
+                    transcript,
+                    freshChat: false,
+                    sendSystemPrompt: false,
+                    queue: pendingQueue,
+                    ui: editor || null,
+                    onChatReady: (chatId) => {
+                        if (chatId) {
+                            currentChatId = chatId;
+                            saveLastChat(chatId, currentWorkdir);
+                        }
+                    },
+                    getTokenUsage: () => browser.getLastTokenUsage(),
+                });
+            }
+            finally {
+                if (editor)
+                    editor.busy = false;
+            }
+            continue;
+        }
         if (lower === '/review' || lower.startsWith('/review ')) {
             const rest = trimmed.slice('/review'.length).trim();
             const staged = rest.indexOf('--staged') !== -1;
@@ -3182,7 +3429,15 @@ async function main() {
                 transcript.log('undo', { path: result.record.originalPath });
             }
             else {
-                console.error(theme.error(t('undo.failed', { v: String(result.reason ?? '') })));
+                // undo.ts returns machine codes ('empty'/'disabled') — localize here so
+                // an English UI never shows a Russian reason.
+                const reasonKey = result.reason === 'empty'
+                    ? 'undo.reason_empty'
+                    : result.reason === 'disabled'
+                        ? 'undo.reason_disabled'
+                        : null;
+                const reason = reasonKey ? t(reasonKey) : String(result.reason ?? '');
+                console.error(theme.error(t('undo.failed', { v: reason })));
             }
             continue;
         }
@@ -3266,6 +3521,7 @@ async function main() {
         }
         // ---- Regular task (including in review mode) ----
         const taskText = expandedTask !== null ? expandedTask : trimmed;
+        lastTaskText = taskText;
         // Dev mode: pick up fresh logic modules before the task.
         await autoReload();
         // Re-scan skills/custom commands before every task: a SKILL.md or a
@@ -3275,7 +3531,11 @@ async function main() {
         if (editor)
             editor.setCommands(buildSlashCommands());
         transcript.log('user_task', { task: taskText, workdir: currentWorkdir });
-        const tools = mod.createTools(currentWorkdir, { undo, todos: todoStore });
+        const tools = mod.createTools(currentWorkdir, {
+            undo,
+            todos: todoStore,
+            readOnly: planMode,
+        });
         if (mcpPool)
             tools.push(...mcpPool.tools);
         if (editor)
@@ -3330,6 +3590,7 @@ async function main() {
                 contextLimit: config.ui.contextLimit,
                 getTokenUsage: () => browser.getLastTokenUsage(),
                 goal: sessionGoal,
+                todosQuery: () => todosSummary(),
             }, inputAttachments);
         }
         finally {

package/dist/mcp.js

@@ -16,6 +16,24 @@ function packageVersion() {
     }
     return '0.0.0';
 }
+/**
+ * Flag stdio servers pinned to a floating version (`@latest` / `@next`).
+ * A floating version can change between runs and silently alter the tools the
+ * agent sees, so the operator is warned and told to pin an exact version.
+ * Pure; exported for tests.
+ */
+export function floatingVersionWarnings(servers) {
+    const out = [];
+    for (const [name, cfg] of Object.entries(servers)) {
+        if (cfg.disabled)
+            continue;
+        const args = [String(cfg.command || ''), ...(cfg.args || [])].join(' ');
+        if (/@(latest|next)\b/.test(args)) {
+            out.push(name);
+        }
+    }
+    return out;
+}
 /** Names of the servers found in a config, before any connection. */
 export async function listConfiguredServers(workdir) {
     const files = await discoverConfigFiles(workdir);
@@ -298,6 +316,7 @@ export async function createMcpPool(opts) {
     const config = await loadConfigFiles(files);
     const servers = config.mcpServers || {};
     const names = Object.keys(servers).filter((n) => !servers[n].disabled);
+    const floating = floatingVersionWarnings(servers);
     const infos = [];
     const connections = [];
     const tools = [];
@@ -339,6 +358,7 @@ export async function createMcpPool(opts) {
         status: () => ({
             servers: infos,
             toolCount: tools.length,
+            warnings: floating.map((n) => `MCP server "${n}" uses a floating version (@latest/@next); pin an exact version so the tool set does not change between runs.`),
         }),
         close: async () => {
             if (closed)

package/dist/sessions.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { writeJsonAtomic } from './fsutil.js';
 // We store sessions (DeepSeek chats) in a separate folder so they aren't lost
 // after a process restart. Each session is a separate JSON file
 // <id>.json in ~/.zames/.sessions. last.json points to the last
@@ -8,11 +9,6 @@ import os from 'os';
 const SESSIONS_DIR = path.join(os.homedir(), '.zames', '.sessions');
 const INDEX_FILE = path.join(SESSIONS_DIR, 'last.json');
 export const SESSIONS_FORMAT_VERSION = 1;
-function atomicWriteJson(file, value) {
-    const tmp = file + '.tmp-' + process.pid;
-    fs.writeFileSync(tmp, JSON.stringify(value, null, 2), 'utf-8');
-    fs.renameSync(tmp, file);
-}
 function ensureDir() {
     fs.mkdirSync(SESSIONS_DIR, { recursive: true });
 }
@@ -46,7 +42,7 @@ export function saveSession({ id, title = '', workdir = '', todos, }) {
         const nextTodos = todos !== undefined ? todos : prev.todos;
         if (nextTodos !== undefined)
             data.todos = nextTodos;
-        atomicWriteJson(file, data);
+        writeJsonAtomic(file, data);
         writeIndex({ id, workdir: data.workdir });
         return data;
     }
@@ -71,7 +67,7 @@ function writeIndex({ id, workdir }) {
         index.byWorkdir[key] = id;
         index.last = id;
         index.updatedAt = new Date().toISOString();
-        atomicWriteJson(INDEX_FILE, index);
+        writeJsonAtomic(INDEX_FILE, index);
     }
     catch { }
 }
@@ -154,7 +150,7 @@ export function saveHistory(history) {
     try {
         ensureDir();
         const trimmed = history.slice(-HISTORY_LIMIT);
-        atomicWriteJson(HISTORY_FILE, trimmed);
+        writeJsonAtomic(HISTORY_FILE, trimmed);
     }
     catch { }
 }