termux-dev 1.2.2 → 1.4.0

package/README.md

@@ -85,6 +85,20 @@ npm install
 npm link
 ```
 
+### 🗑️ Complete Uninstallation
+
+To completely remove `devx` along with all configuration, saved sessions, and data:
+
+```bash
+# 1. Uninstall the global npm package
+npm uninstall -g termux-dev
+
+# 2. Remove configuration and session history (Linux / macOS / Termux)
+rm -rf ~/.devx ~/.devxrc.json
+
+# (Windows PowerShell)
+Remove-Item -Recurse -Force "$HOME\.devx", "$HOME\.devxrc.json" -ErrorAction SilentlyContinue
+```
 
 ---
 
@@ -101,6 +115,11 @@ devx
   ```bash
   devx --plan
   ```
+* Run in **Headless One-Shot Mode** (scripts, CI/CD, Termux:Widget):
+  ```bash
+  devx -p "review latest git diff and find security bugs"
+  devx -p "fix build errors" --yolo
+  ```
 
 ---
 
@@ -112,6 +131,11 @@ Type `/` in the prompt to open the autocomplete command palette:
 | :--- | :--- |
 | **`/plan`** | Switch to **PLAN** mode (architect & requirements planner) |
 | **`/agent`** | Switch to **AGENT** mode (coder & autonomous executor) |
+| **`/mcp`** | Manage Model Context Protocol (MCP) servers & external tools (`/mcp reload`) |
+| **`/usage`** | View live network bandwidth (KB/MB), token costs, and API request counts |
+| **`/export`** | Export session conversation to a clean GitHub-Flavored Markdown transcript |
+| **`/theme`** | Switch UI color theme (Cyan, Purple, Matrix, Amber, Crimson, Monochrome) |
+| **`/doctor`** | Run environment health diagnostics (Node, Termux, Compilers, API keys) |
 | **`/image`** | Paste image from clipboard as `[1.png 203kb]` |
 | **`/serve [port]`** | Start local HTTP server for web/game preview (`/serve stop` to halt) |
 | **`/memory`** | View, add (`/memory add <fact>`), or clear project memory bank |
@@ -213,6 +237,20 @@ npm install
 npm link
 ```
 
+### 🗑️ Полное удаление
+
+Чтобы полностью удалить `devx` вместе с конфигурацией, историей сессий и сохранёнными данными:
+
+```bash
+# 1. Удаляем глобальный npm-пакет
+npm uninstall -g termux-dev
+
+# 2. Удаляем конфиг и историю сессий (Linux / macOS / Termux)
+rm -rf ~/.devx ~/.devxrc.json
+
+# (Windows PowerShell)
+Remove-Item -Recurse -Force "$HOME\.devx", "$HOME\.devxrc.json" -ErrorAction SilentlyContinue
+```
 
 ---
 
@@ -229,6 +267,11 @@ devx
   ```bash
   devx --plan
   ```
+* Запуск в **Headless One-Shot режиме** (скрипты, CI/CD, Termux:Widget):
+  ```bash
+  devx -p "проверь последний git diff и найди баги"
+  devx -p "исправь ошибки сборки" --yolo
+  ```
 
 ---
 
@@ -240,6 +283,11 @@ devx
 | :--- | :--- |
 | **`/plan`** | Переключиться в режим архитектора (**PLAN**) |
 | **`/agent`** | Переключиться в режим исполнителя (**AGENT**) |
+| **`/mcp`** | Управление MCP-серверами и внешними инструментами (`/mcp reload`) |
+| **`/usage`** | Показать сетевой трафик (КБ/МБ), токены, число запросов и расходы ($) |
+| **`/export`** | Экспортировать сессию диалога в чистый GitHub Markdown файл |
+| **`/theme`** | Сменить цветовую тему (Cyan, Purple, Matrix, Amber, Crimson, Monochrome) |
+| **`/doctor`** | Запустить системную диагностику (Node, Termux, Компиляторы, Ключи) |
 | **`/image`** | Вставить картинку из буфера обмена как `[1.png 203kb]` |
 | **`/serve [порт]`** | Запустить локальный веб-сервер (`/serve stop` для остановки) |
 | **`/memory`** | Посмотреть, добавить (`/memory add <факт>`) или очистить банк памяти |

package/assets/banner.svg

@@ -25,7 +25,7 @@
 
   <!-- Tagline & Badge -->
   <text x="425" y="142" font-family="system-ui, -apple-system, sans-serif" font-size="14" font-weight="600" fill="#8b949e" text-anchor="middle" letter-spacing="3">
-    THE TERMINAL-NATIVE AI CODING AGENT <tspan fill="#00f2fe" font-weight="bold">v1.2.2</tspan>
+    THE TERMINAL-NATIVE AI CODING AGENT <tspan fill="#00f2fe" font-weight="bold">v1.4.0</tspan>
   </text>
 
   <!-- Top Accent Line -->

package/dist/cli/doctor.js

@@ -15,8 +15,14 @@ function checkCmd(cmd) {
 }
 async function pingUrl(url) {
     return new Promise((resolve) => {
-        const req = https.get(url, { timeout: 3000 }, (res) => {
-            resolve(res.statusCode !== undefined);
+        const req = https.get(url, {
+            timeout: 3000,
+            headers: {
+                'User-Agent': 'devx-doctor/1.4.0'
+            }
+        }, (res) => {
+            res.resume(); // consume response data to free up memory and release socket
+            resolve(res.statusCode !== undefined && res.statusCode < 500);
         });
         req.on('error', () => resolve(false));
         req.on('timeout', () => {

package/dist/cli/export.js

@@ -0,0 +1,62 @@
+import fs from 'fs/promises';
+import path from 'path';
+export class SessionExporter {
+    static async exportToMarkdown(messages, model, targetFilename) {
+        try {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            let fileName = targetFilename?.trim() || `devx-session-${timestamp.slice(0, 19)}.md`;
+            if (!fileName.endsWith('.md'))
+                fileName += '.md';
+            const filePath = path.resolve(process.cwd(), fileName);
+            const lines = [
+                `# 📝 devx Session Transcript`,
+                ``,
+                `- **Date:** ${new Date().toLocaleString()}`,
+                `- **Model:** \`${model}\``,
+                `- **Total Messages:** ${messages.length}`,
+                `- **Working Directory:** \`${process.cwd()}\``,
+                ``,
+                `---`,
+                ``
+            ];
+            for (const msg of messages) {
+                if (msg.role === 'system')
+                    continue; // Skip raw system prompt
+                if (msg.role === 'user') {
+                    lines.push(`## 👤 User\n`);
+                    lines.push(msg.content || '');
+                    if (msg.images && msg.images.length > 0) {
+                        lines.push(`\n*Attached Images: ${msg.images.map(i => i.path).join(', ')}*`);
+                    }
+                    lines.push(`\n---\n`);
+                }
+                else if (msg.role === 'assistant') {
+                    lines.push(`## 🤖 Assistant\n`);
+                    if (msg.content) {
+                        lines.push(msg.content);
+                    }
+                    if (msg.tool_calls && msg.tool_calls.length > 0) {
+                        lines.push(`\n**Executed Tools:**`);
+                        for (const tc of msg.tool_calls) {
+                            lines.push(`- \`${tc.name}\`: \`\`\`json\n${JSON.stringify(tc.arguments, null, 2)}\n\`\`\``);
+                        }
+                    }
+                    lines.push(`\n---\n`);
+                }
+                else if (msg.role === 'tool') {
+                    lines.push(`> **Tool Result (${msg.name || 'tool'}):**\n`);
+                    let displayContent = msg.content || '';
+                    if (displayContent.length > 2000) {
+                        displayContent = displayContent.slice(0, 2000) + '\n... [truncated]';
+                    }
+                    lines.push('```\n' + displayContent + '\n```\n');
+                }
+            }
+            await fs.writeFile(filePath, lines.join('\n'), 'utf8');
+            return { success: true, filePath };
+        }
+        catch (err) {
+            return { success: false, filePath: '', error: err.message };
+        }
+    }
+}

package/dist/cli/headless.js

@@ -0,0 +1,110 @@
+import pc from 'picocolors';
+import { History } from '../core/history.js';
+import { Agent } from '../core/loop.js';
+import { buildSystemPrompt } from '../prompts/builder.js';
+import { createProvider } from '../providers/index.js';
+import { getTools } from '../tools/index.js';
+import { CLIConsoleGuard } from '../permissions/guard.js';
+import { globalSnapshotManager } from '../core/snapshot.js';
+import { UsageTracker } from '../core/usage.js';
+export async function runHeadlessMode(userPrompt, config, options = {}) {
+    const planMode = !!options.planMode;
+    const isYolo = !!options.yolo || !!config.autoApprove;
+    const isQuiet = !!options.quiet;
+    const isJson = !!options.json;
+    let history = new History();
+    const sysPrompt = await buildSystemPrompt(planMode);
+    history.addMessage({ role: 'system', content: sysPrompt });
+    history.addMessage({ role: 'user', content: userPrompt });
+    const provider = createProvider(config);
+    const tools = getTools(planMode);
+    const guard = new CLIConsoleGuard(isYolo, config.bashAllowlist || []);
+    const agent = new Agent(config, provider, tools, history, guard);
+    const executedTools = [];
+    let accumulatedText = '';
+    let accumulatedReasoning = '';
+    let isFatalError = false;
+    let errorMessage = '';
+    const abortController = new AbortController();
+    process.on('SIGINT', () => {
+        abortController.abort();
+        if (!isJson) {
+            console.error(pc.yellow('\n[devx headless] Aborted by user (SIGINT)'));
+        }
+        process.exit(130);
+    });
+    try {
+        if (!isQuiet && !isJson) {
+            console.log(pc.bold(pc.cyan(`⚡ devx v1.4.0 (headless) | ${planMode ? 'PLAN' : 'AGENT'} | ${config.model}`)));
+            console.log(pc.dim(`Task: ${userPrompt}\n`));
+        }
+        for await (const event of agent.run(abortController.signal)) {
+            if (event.type === 'reasoning_delta') {
+                accumulatedReasoning += event.delta;
+                if (!isQuiet && !isJson) {
+                    process.stdout.write(pc.dim(event.delta));
+                }
+            }
+            else if (event.type === 'text_delta') {
+                accumulatedText += event.delta;
+                if (!isJson) {
+                    process.stdout.write(event.delta);
+                }
+            }
+            else if (event.type === 'tool_start') {
+                if (!isQuiet && !isJson) {
+                    console.log('\n' + pc.bold(pc.white(`› ${event.actionDesc}`)));
+                }
+            }
+            else if (event.type === 'tool_end') {
+                executedTools.push({ id: event.id, name: event.name, result: event.result });
+            }
+            else if (event.type === 'error') {
+                errorMessage = event.message;
+                if (event.isFatal) {
+                    isFatalError = true;
+                    break;
+                }
+            }
+        }
+        globalSnapshotManager.finishTurn();
+        if (isJson) {
+            const summary = UsageTracker.getInstance().getSummary();
+            const output = {
+                success: !isFatalError,
+                model: config.model,
+                prompt: userPrompt,
+                result: accumulatedText,
+                reasoning: accumulatedReasoning || undefined,
+                executedTools,
+                usage: {
+                    requests: summary.requestsCount,
+                    totalTokens: summary.totalTokens,
+                    cost: summary.totalCost,
+                    totalBytes: summary.totalBytes
+                },
+                error: isFatalError ? errorMessage : undefined
+            };
+            console.log(JSON.stringify(output, null, 2));
+        }
+        else {
+            if (accumulatedText && !accumulatedText.endsWith('\n')) {
+                process.stdout.write('\n');
+            }
+            if (isFatalError) {
+                console.error(pc.red(`\n❌ Error: ${errorMessage}`));
+                return 1;
+            }
+        }
+        return isFatalError ? 1 : 0;
+    }
+    catch (err) {
+        if (isJson) {
+            console.log(JSON.stringify({ success: false, error: err.message }, null, 2));
+        }
+        else {
+            console.error(pc.red(`\n❌ Fatal Headless Execution Error: ${err.message}`));
+        }
+        return 1;
+    }
+}