@hasna/terminal 3.3.8 → 3.3.9

package/dist/mcp/server.js

@@ -60,7 +60,7 @@ export function createServer() {
         version: "0.2.0",
     });
     // ── execute: run a command, return structured result ──────────────────────
-    server.tool("execute", "Run a shell command and return raw output. Prefer execute_smart for most tasks — it AI-summarizes output, saving 80% tokens. Use execute only when you need the full unprocessed output (e.g., to parse it yourself).", {
+    server.tool("execute", "Run a shell command. Format guide: no format/raw for git commit/push (<50 tokens). format=compressed for long build output (CPU-only, no AI). format=json or format=summary for AI-summarized output (234ms, saves 80% tokens). Prefer execute_smart for most tasks.", {
         command: z.string().describe("Shell command to execute"),
         cwd: z.string().optional().describe("Working directory (default: server cwd)"),
         timeout: z.number().optional().describe("Timeout in ms (default: 30000)"),
@@ -123,7 +123,7 @@ export function createServer() {
             return {
                 content: [{ type: "text", text: JSON.stringify({
                             exitCode: result.exitCode, output: compressed.content, duration: result.duration,
-                            tokensSaved: compressed.tokensSaved, savingsPercent: compressed.savingsPercent,
+                            ...(compressed.tokensSaved > 0 ? { tokensSaved: compressed.tokensSaved, savingsPercent: compressed.savingsPercent } : {}),
                         }) }],
             };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "3.3.8",
+  "version": "3.3.9",
   "description": "Smart terminal wrapper for AI agents and humans — structured output, token compression, MCP server, natural language",
   "type": "module",
   "files": [

package/src/mcp/server.ts

@@ -69,7 +69,7 @@ export function createServer(): McpServer {
 
   server.tool(
     "execute",
-    "Run a shell command and return raw output. Prefer execute_smart for most tasks — it AI-summarizes output, saving 80% tokens. Use execute only when you need the full unprocessed output (e.g., to parse it yourself).",
+    "Run a shell command. Format guide: no format/raw for git commit/push (<50 tokens). format=compressed for long build output (CPU-only, no AI). format=json or format=summary for AI-summarized output (234ms, saves 80% tokens). Prefer execute_smart for most tasks.",
     {
       command: z.string().describe("Shell command to execute"),
       cwd: z.string().optional().describe("Working directory (default: server cwd)"),
@@ -136,7 +136,7 @@ export function createServer(): McpServer {
         return {
           content: [{ type: "text" as const, text: JSON.stringify({
             exitCode: result.exitCode, output: compressed.content, duration: result.duration,
-            tokensSaved: compressed.tokensSaved, savingsPercent: compressed.savingsPercent,
+            ...(compressed.tokensSaved > 0 ? { tokensSaved: compressed.tokensSaved, savingsPercent: compressed.savingsPercent } : {}),
           }) }],
         };
       }