zames_pro 2.14.0 → 2.15.0

package/README.md

@@ -93,6 +93,28 @@ The agent has the same style of tools as Claude Code / Codex CLI:
 All file tools stay inside the working directory (sandbox). `Write`/`Edit` and
 `MultiEdit`/`ApplyPatch` make a backup (undo) before touching a file.
 
+## Slash commands
+
+Type / in the prompt for hints (Tab completes). Besides the session and
+config commands (/new, /chats, /resume, /cd, /status, /config,
+/undo, /transcript, /mcp, /skills, /memory, /init, /reload,
+/debug-dom, /help, /exit) there are a few that mirror Claude Code /
+Codex CLI:
+
+- /diff [--staged] — show the working-tree git diff (--staged for the index).
+- /cost (alias /usage) — session stats: tasks, tool calls, duration
+ (DeepSeek web does not expose token counts).
+- /export [file] — write the session transcript to a Markdown file
+ (zames-export-<stamp>.md by default).
+- /doctor — diagnose node, git, config, browser, clipboard and MCP.
+- /permissions — show the confirmation settings (Write/Edit/Bash + the
+ alwaysConfirm regex list).
+- /add-dir <path> — validate an extra directory (the sandbox is fixed at
+ startup; relaunch with --dir to write there).
+- /review [focus] [--staged] — ask the agent to review uncommitted changes
+ and report findings (no code changes).
+
+
 ## Project context, skills and memory
 
 Like Codex / Claude Code, zames reads project instructions and reusable

package/dist/commands.js

@@ -0,0 +1,201 @@
+import path from 'path';
+// Helpers for the extra slash commands (/diff, /cost, /export, /doctor,
+// /permissions, /review, /add-dir). Pure functions, unit-tested without a
+// live agent/browser. index.ts only renders their output.
+const NL = String.fromCharCode(10);
+const CR = String.fromCharCode(13);
+// ---------- /diff ----------
+export function formatDiff(diffText, opts = {}) {
+    const maxLines = opts.maxLines ?? 200;
+    const trimmed = String(diffText ?? '').split(CR + NL).join(NL).trimEnd();
+    if (!trimmed)
+        return '(no changes)';
+    const lines = trimmed.split(NL);
+    if (lines.length <= maxLines)
+        return trimmed;
+    const head = lines.slice(0, maxLines).join(NL);
+    const rest = lines.length - maxLines;
+    return (head +
+        NL +
+        '... [' + rest + ' more lines, use Bash git diff for the full output]');
+}
+export function diffGitArgs(staged = false) {
+    return staged ? 'git diff --staged' : 'git diff';
+}
+export function summarizeTranscript(entries) {
+    const stats = {
+        turns: 0,
+        toolCalls: 0,
+        toolCounts: {},
+        durationMs: 0,
+        startedAt: null,
+    };
+    for (const e of entries) {
+        if (!e || typeof e !== 'object')
+            continue;
+        if (e.type === 'user_task')
+            stats.turns++;
+        if (e.type === 'tool_call') {
+            stats.toolCalls++;
+            const tool = String(e.tool ?? '?');
+            stats.toolCounts[tool] = (stats.toolCounts[tool] || 0) + 1;
+        }
+        if (typeof e.elapsed === 'number' && e.elapsed > stats.durationMs) {
+            stats.durationMs = e.elapsed;
+        }
+        if (!stats.startedAt && typeof e.ts === 'string')
+            stats.startedAt = e.ts;
+    }
+    return stats;
+}
+export function parseTranscript(body) {
+    const out = [];
+    for (const line of String(body ?? '').split(NL)) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            const v = JSON.parse(t);
+            if (v && typeof v === 'object')
+                out.push(v);
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return out;
+}
+export function formatDuration(ms) {
+    const total = Math.max(0, Math.round(ms / 1000));
+    const h = Math.floor(total / 3600);
+    const m = Math.floor((total % 3600) / 60);
+    const s = total % 60;
+    const pad = (n) => String(n).padStart(2, '0');
+    if (h > 0)
+        return h + 'h ' + pad(m) + 'm ' + pad(s) + 's';
+    if (m > 0)
+        return m + 'm ' + pad(s) + 's';
+    return s + 's';
+}
+export function renderCost(stats, transcriptFile) {
+    const lines = [];
+    lines.push('Session stats (DeepSeek web does not expose token counts):');
+    lines.push(' tasks: ' + stats.turns);
+    lines.push(' tool calls: ' + stats.toolCalls);
+    const top = Object.entries(stats.toolCounts).sort((a, b) => b[1] - a[1]);
+    if (top.length) {
+        lines.push(' by tool:');
+        for (const [name, n] of top)
+            lines.push(' ' + name + ': ' + n);
+    }
+    lines.push(' duration: ' + formatDuration(stats.durationMs));
+    if (stats.startedAt)
+        lines.push(' started: ' + stats.startedAt);
+    lines.push(' transcript: ' + (transcriptFile || '(off)'));
+    return lines.join(NL);
+}
+// ---------- /export ----------
+export function formatExport(entries, meta = {}) {
+    const out = [];
+    out.push('# zames session export');
+    out.push('');
+    if (meta.workdir)
+        out.push('- workdir: ' + meta.workdir);
+    if (meta.chatId)
+        out.push('- chat: ' + meta.chatId);
+    out.push('- exported: ' + new Date().toISOString());
+    out.push('');
+    for (const e of entries) {
+        const type = String(e.type ?? '?');
+        if (type === 'user_task') {
+            out.push('## Task');
+            out.push('');
+            out.push(String(e.task ?? ''));
+            out.push('');
+        }
+        else if (type === 'tool_call') {
+            out.push('- tool ' +
+                String(e.tool ?? '?') +
+                ' ' +
+                JSON.stringify(e.args ?? {}));
+        }
+        else if (type === 'tool_result') {
+            out.push(' -> ' +
+                String(e.tool ?? '?') +
+                ': ' +
+                String(e.result ?? '').slice(0, 500));
+        }
+        else if (type === 'assistant_final') {
+            out.push('## Answer');
+            out.push('');
+            out.push(String(e.message ?? ''));
+            out.push('');
+        }
+    }
+    return out.join(NL);
+}
+export function defaultExportPath(workdir, now = new Date()) {
+    const stamp = now
+        .toISOString()
+        .replace(/[:.]/g, '-')
+        .replace('T', '_')
+        .replace('Z', '');
+    return path.join(workdir, 'zames-export-' + stamp + '.md');
+}
+export function renderDoctor(d) {
+    const rows = [];
+    const row = (ok, label, value) => {
+        rows.push(' ' + (ok ? '[OK] ' : '[WARN]') + ' ' + label.padEnd(16) + ' ' + value);
+    };
+    row(true, 'node', d.nodeVersion);
+    row(true, 'platform', d.platform);
+    row(true, 'workdir', d.workdir);
+    row(d.gitOk, 'git', d.gitOk ? 'repo (' + (d.gitBranch || 'detached') + ')' : 'not a repository');
+    row(d.configOk, 'config', d.configOk ? 'loaded' : 'error: ' + (d.configError || 'unknown'));
+    row(true, 'browser', d.browserChannel ? d.browserChannel : 'bundled chromium');
+    row(!!d.clipboardTool, 'clipboard', d.clipboardTool || 'no tool found (image paste disabled)');
+    row(true, 'mcp', d.mcpServers + ' server(s), ' + d.mcpTools + ' tool(s)');
+    row(d.transcriptOk, 'transcript', d.transcriptOk ? 'on' : 'off');
+    return 'Doctor:' + NL + rows.join(NL);
+}
+export function renderPermissions(p) {
+    const onoff = (b) => (b ? 'ask' : 'allow');
+    const lines = [];
+    lines.push('Tool permissions (confirmation settings):');
+    lines.push(' Write: ' + onoff(p.write));
+    lines.push(' Edit: ' + onoff(p.edit));
+    lines.push(' Bash: ' + onoff(p.bash));
+    if (p.alwaysConfirm.length) {
+        lines.push(' Always confirm (regex):');
+        for (const re of p.alwaysConfirm)
+            lines.push(' ' + re);
+    }
+    lines.push('');
+    lines.push('Change with: /config set confirmation.write false (and .edit / .bash)');
+    return lines.join(NL);
+}
+// ---------- /add-dir ----------
+export function resolveExtraDir(input, workdir) {
+    const raw = String(input ?? '').trim();
+    if (!raw)
+        return { error: 'Usage: /add-dir <path>' };
+    const abs = path.resolve(workdir, raw);
+    if (abs === path.resolve(workdir)) {
+        return { error: 'This is already the working directory.' };
+    }
+    return { path: abs };
+}
+// ---------- /review ----------
+export function buildReviewPrompt(focus, hasStaged = false) {
+    const scope = hasStaged ? 'staged' : 'uncommitted';
+    const f = String(focus ?? '').trim();
+    let s = 'Review the ' +
+        scope +
+        ' changes in this repository (use GitDiff). ' +
+        'Focus on real bugs: correctness, race conditions, error handling, ' +
+        'security, and missing tests. Do NOT invent problems and do NOT change ' +
+        'code: only report findings with file:line and a short rationale.';
+    if (f)
+        s += NL + 'Extra focus: ' + f;
+    return s;
+}

package/dist/i18n.js

@@ -78,6 +78,18 @@ const CATALOG = {
     'help.cmd.undo': { ru: '/undo                    откатить последнюю запись/правку', en: '/undo                    revert the last write/edit' },
     'help.cmd.undo_list': { ru: '/undo-list               список того, что можно откатить', en: '/undo-list               list revertable changes' },
     'help.cmd.transcript': { ru: '/transcript              путь к файлу транскрипта', en: '/transcript              transcript file path' },
+    'help.cmd.diff': { ru: '/diff [--staged] показать git diff', en: '/diff [--staged] show working tree git diff' },
+    'help.cmd.cost': { ru: '/cost статистика сессии', en: '/cost session stats' },
+    'help.cmd.export': { ru: '/export [file] выгрузить сессию в Markdown', en: '/export [file] export the session to Markdown' },
+    'help.cmd.doctor': { ru: '/doctor диагностика установки и конфига', en: '/doctor diagnose install and config' },
+    'help.cmd.permissions': { ru: '/permissions настройки подтверждений', en: '/permissions confirmation settings' },
+    'help.cmd.add_dir': { ru: '/add-dir <path> проверить директорию', en: '/add-dir <path> validate a directory' },
+    'help.cmd.review': { ru: '/review [focus] ревью незакоммиченных изменений', en: '/review [focus] review uncommitted changes' },
+    'diff.not_repo': { ru: 'Не git-репозиторий.', en: 'Not a git repository.' },
+    'export.done': { ru: 'Сессия выгружена: {v}', en: 'Session exported: {v}' },
+    'export.outside': { ru: 'Путь вне рабочей директории.', en: 'Path is outside the working directory.' },
+    'adddir.not_dir': { ru: 'Нет такой директории: {v}', en: 'No such directory: {v}' },
+    'adddir.note': { ru: 'Директория существует: {v}. Песочница фиксируется при запуске.', en: 'Directory exists: {v}. The sandbox is fixed at startup.' },
     'help.cmd.config': { ru: '/config                  настройки: показать и изменить', en: '/config                  settings: view and edit' },
     'help.cmd.lang': { ru: '/config lang <ru|en>     сменить язык интерфейса и агента', en: '/config lang <ru|en>     switch UI and agent language' },
     'help.cmd.debug_dom': { ru: '/debug-dom               сохранить HTML страницы (для отладки)', en: '/debug-dom               dump page HTML (debug)' },

package/dist/index.js

@@ -15,6 +15,7 @@ import { translate, normalizeLocale, localeDisplayName, isLocale, } from './i18n
 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, renderPermissions, resolveExtraDir, buildReviewPrompt, } from './commands.js';
 import { closeWeb } from './web.js';
 import { saveSession, loadLastSession, listSessions, sessionsDir, } from './sessions.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -218,6 +219,13 @@ ${theme.bold(t('help.commands'))}
   ${t('help.cmd.undo')}
   ${t('help.cmd.undo_list')}
   ${t('help.cmd.transcript')}
+ ${t('help.cmd.diff')}
+ ${t('help.cmd.cost')}
+ ${t('help.cmd.export')}
+ ${t('help.cmd.doctor')}
+ ${t('help.cmd.permissions')}
+ ${t('help.cmd.add_dir')}
+ ${t('help.cmd.review')}
   ${t('help.cmd.config')}
   ${t('help.cmd.lang')}
   ${t('help.cmd.debug_dom')}
@@ -266,6 +274,13 @@ const SLASH_COMMANDS = [
     { name: '/undo', key: 'help.cmd.undo' },
     { name: '/undo-list', key: 'help.cmd.undo_list' },
     { name: '/transcript', key: 'help.cmd.transcript' },
+    { name: '/diff', key: 'help.cmd.diff' },
+    { name: '/cost', key: 'help.cmd.cost' },
+    { name: '/export', key: 'help.cmd.export' },
+    { name: '/doctor', key: 'help.cmd.doctor' },
+    { name: '/permissions', key: 'help.cmd.permissions' },
+    { name: '/add-dir', key: 'help.cmd.add_dir' },
+    { name: '/review', key: 'help.cmd.review' },
     { name: '/config', key: 'help.cmd.config' },
     { name: '/skills', key: 'help.cmd.skills' },
     { name: '/memory', key: 'help.cmd.memory' },
@@ -1986,6 +2001,150 @@ async function main() {
             console.log(theme.system(transcript.file || t('common.off')));
             continue;
         }
+        if (lower === '/diff' || lower.startsWith('/diff ')) {
+            const staged = lower.indexOf("--staged") !== -1;
+            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(diffGitArgs(staged), currentWorkdir, 20_000);
+            console.log(theme.system(formatDiff(out, { maxLines: 400 })));
+            continue;
+        }
+        if (lower === '/cost' || lower === '/usage') {
+            let stats = summarizeTranscript([]);
+            if (transcript.file) {
+                try {
+                    const body = await fs.readFile(transcript.file, 'utf-8');
+                    stats = summarizeTranscript(parseTranscript(body));
+                }
+                catch {
+                    // best-effort
+                }
+            }
+            console.log(theme.system(renderCost(stats, transcript.file)));
+            continue;
+        }
+        if (lower === '/export' || lower.startsWith('/export ')) {
+            const arg = trimmed.slice('/export'.length).trim();
+            const target = arg
+                ? path.resolve(currentWorkdir, arg)
+                : defaultExportPath(currentWorkdir);
+            const rel = path.relative(sandboxRoot, target);
+            if (rel.startsWith('..') || path.isAbsolute(rel)) {
+                console.error(theme.error(t('export.outside')));
+                continue;
+            }
+            let entries = [];
+            if (transcript.file) {
+                try {
+                    entries = parseTranscript(await fs.readFile(transcript.file, 'utf-8'));
+                }
+                catch {
+                    entries = [];
+                }
+            }
+            const md = formatExport(entries, {
+                chatId: currentChatId,
+                workdir: currentWorkdir,
+            });
+            await fs.writeFile(target, md, 'utf-8');
+            console.log(theme.assistant(t('export.done', { v: target })));
+            continue;
+        }
+        if (lower === '/doctor') {
+            const { runGit } = await import('./gitTools.js');
+            let gitOk = false;
+            let gitBranch = null;
+            try {
+                const probe = await runGit('git rev-parse --is-inside-work-tree', currentWorkdir, 5000);
+                gitOk = probe.trim() === 'true';
+                if (gitOk) {
+                    gitBranch = (await runGit('git branch --show-current', currentWorkdir, 5000)).trim();
+                }
+            }
+            catch {
+                gitOk = false;
+            }
+            let clipboardTool = null;
+            try {
+                clipboardTool = hasClipboardTool() ? 'available' : null;
+            }
+            catch {
+                clipboardTool = null;
+            }
+            const mcpStatus = mcpPool
+                ? mcpPool.status()
+                : { servers: [], toolCount: 0 };
+            console.log(theme.system(renderDoctor({
+                nodeVersion: process.version,
+                platform: process.platform,
+                workdir: currentWorkdir,
+                gitOk,
+                gitBranch,
+                configOk: true,
+                browserChannel: config.browserChannel,
+                clipboardTool,
+                mcpServers: mcpStatus.servers.length,
+                mcpTools: mcpStatus.toolCount,
+                transcriptOk: !!transcript.file,
+            })));
+            continue;
+        }
+        if (lower === '/permissions' || lower === '/allowed-tools') {
+            console.log(theme.system(renderPermissions({
+                write: config.confirmation.write,
+                edit: config.confirmation.edit,
+                bash: config.confirmation.bash,
+                alwaysConfirm: config.confirmation.alwaysConfirm,
+            })));
+            continue;
+        }
+        if (lower === '/add-dir' || lower.startsWith('/add-dir ')) {
+            const arg = trimmed.slice('/add-dir'.length).trim();
+            const res = resolveExtraDir(arg, currentWorkdir);
+            if ('error' in res) {
+                console.error(theme.warn(res.error));
+                continue;
+            }
+            const stat = await fs.stat(res.path).catch(() => null);
+            if (!stat || !stat.isDirectory()) {
+                console.error(theme.error(t('adddir.not_dir', { v: res.path })));
+                continue;
+            }
+            console.log(theme.system(t('adddir.note', { v: res.path })));
+            continue;
+        }
+        if (lower === '/review' || lower.startsWith('/review ')) {
+            const rest = trimmed.slice('/review'.length).trim();
+            const staged = rest.indexOf("--staged") !== -1;
+            const focus = rest.replace(/--staged/g, '').trim();
+            const reviewTask = buildReviewPrompt(focus, staged);
+            const reviewTools = mod.createTools(currentWorkdir, { undo });
+            if (editor)
+                editor.busy = true;
+            try {
+                await runTask(browser, reviewTools, reviewTask, currentWorkdir, {
+                    transcript,
+                    freshChat: false,
+                    sendSystemPrompt: false,
+                    ui: editor || null,
+                    onChatReady: (chatId) => {
+                        if (chatId) {
+                            currentChatId = chatId;
+                            saveLastChat(chatId, currentWorkdir);
+                        }
+                    },
+                });
+            }
+            finally {
+                if (editor)
+                    editor.busy = false;
+            }
+            continue;
+        }
         if (lower === '/undo') {
             const result = await undo.undoLast();
             if (result.ok && result.record) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "Terminal coding agent over chat.deepseek.com via Playwright",
   "type": "module",
   "bin": {