@hasna/terminal 3.3.7 → 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/dist/search/content-search.js

@@ -54,9 +54,11 @@ export async function searchContent(pattern, cwd, options = {}) {
     const totalMatches = [...fileMap.values()].reduce((sum, m) => sum + m.length, 0);
     const filtered = filteredCount > 0 ? [{ count: filteredCount, reason: "excluded directories" }] : [];
     const rawTokens = Math.ceil(raw.length / 4);
+    const truncated = totalMatches > files.reduce((s, f) => s + f.matches.length, 0);
     const result = { query: pattern, totalMatches, files, filtered };
     const resultTokens = Math.ceil(JSON.stringify(result).length / 4);
     result.tokensSaved = Math.max(0, rawTokens - resultTokens);
+    result.truncated = truncated;
     // Overflow guard — warn when results are truncated
     if (totalMatches > maxResults * 3) {
         result.overflow = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "3.3.7",
+  "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 } : {}),
           }) }],
         };
       }

package/src/search/content-search.ts

@@ -89,9 +89,11 @@ export async function searchContent(
   const filtered = filteredCount > 0 ? [{ count: filteredCount, reason: "excluded directories" }] : [];
 
   const rawTokens = Math.ceil(raw.length / 4);
+  const truncated = totalMatches > files.reduce((s, f) => s + f.matches.length, 0);
   const result: ContentSearchResult = { query: pattern, totalMatches, files, filtered };
   const resultTokens = Math.ceil(JSON.stringify(result).length / 4);
   result.tokensSaved = Math.max(0, rawTokens - resultTokens);
+  (result as any).truncated = truncated;
 
   // Overflow guard — warn when results are truncated
   if (totalMatches > maxResults * 3) {