@hasna/terminal 3.3.5 → 3.3.7

package/dist/compression.js

@@ -64,6 +64,12 @@ function smartTruncate(text, maxTokens) {
 export function compress(command, output, options = {}) {
     const { maxTokens, stripAnsi: doStrip = true } = options;
     const originalTokens = estimateTokens(output);
+    // Short output — no-op, skip all processing
+    if (output.split("\n").length <= 20 && !maxTokens) {
+        const clean = doStrip ? stripAnsi(output) : output;
+        const cleanTokens = estimateTokens(clean);
+        return { content: clean, originalTokens, compressedTokens: cleanTokens, tokensSaved: Math.max(0, originalTokens - cleanTokens), savingsPercent: 0 };
+    }
     // Step 1: Strip ANSI codes
     let text = doStrip ? stripAnsi(output) : output;
     // Step 2: Deduplicate similar lines

package/dist/mcp/server.js

@@ -232,8 +232,8 @@ export function createServer() {
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
     });
     // ── search_semantic: AST-powered code search ───────────────────────────────
-    server.tool("search_semantic", "Semantic code search — find functions, classes, components, hooks, types by meaning. Uses AST parsing, not string matching. Much more precise than grep for code navigation.", {
-        query: z.string().describe("What to search for (e.g., 'auth functions', 'React components', 'database hooks')"),
+    server.tool("search_semantic", "Find functions, classes, components, hooks, types by NAME or SIGNATURE. Searches symbol declarations, NOT code behavior or content. Use search_content (grep) instead for pattern matching inside code (e.g., security audits, string searches, imports).", {
+        query: z.string().describe("Symbol name to search for (e.g., 'auth', 'login', 'UserService'). Matches function/class/type names, not code content."),
         path: z.string().optional().describe("Search root (default: cwd)"),
         kinds: z.array(z.enum(["function", "class", "interface", "type", "variable", "export", "import", "component", "hook"])).optional().describe("Filter by symbol kind"),
         exportedOnly: z.boolean().optional().describe("Only show exported symbols (default: false)"),

package/package.json

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

package/src/compression.ts

@@ -89,6 +89,13 @@ export function compress(command: string, output: string, options: CompressOptio
   const { maxTokens, stripAnsi: doStrip = true } = options;
   const originalTokens = estimateTokens(output);
 
+  // Short output — no-op, skip all processing
+  if (output.split("\n").length <= 20 && !maxTokens) {
+    const clean = doStrip ? stripAnsi(output) : output;
+    const cleanTokens = estimateTokens(clean);
+    return { content: clean, originalTokens, compressedTokens: cleanTokens, tokensSaved: Math.max(0, originalTokens - cleanTokens), savingsPercent: 0 };
+  }
+
   // Step 1: Strip ANSI codes
   let text = doStrip ? stripAnsi(output) : output;
 

package/src/mcp/server.ts

@@ -301,9 +301,9 @@ export function createServer(): McpServer {
 
   server.tool(
     "search_semantic",
-    "Semantic code search — find functions, classes, components, hooks, types by meaning. Uses AST parsing, not string matching. Much more precise than grep for code navigation.",
+    "Find functions, classes, components, hooks, types by NAME or SIGNATURE. Searches symbol declarations, NOT code behavior or content. Use search_content (grep) instead for pattern matching inside code (e.g., security audits, string searches, imports).",
     {
-      query: z.string().describe("What to search for (e.g., 'auth functions', 'React components', 'database hooks')"),
+      query: z.string().describe("Symbol name to search for (e.g., 'auth', 'login', 'UserService'). Matches function/class/type names, not code content."),
       path: z.string().optional().describe("Search root (default: cwd)"),
       kinds: z.array(z.enum(["function", "class", "interface", "type", "variable", "export", "import", "component", "hook"])).optional().describe("Filter by symbol kind"),
       exportedOnly: z.boolean().optional().describe("Only show exported symbols (default: false)"),