@hasna/terminal 3.7.0 → 3.7.2

package/dist/mcp/server.js

@@ -54,6 +54,15 @@ function exec(command, cwd, timeout, allowRewrite = false) {
         });
     });
 }
+/** Resolve a path — supports relative paths against cwd, just like a shell */
+function resolvePath(p, cwd) {
+    if (!p)
+        return cwd ?? process.cwd();
+    if (p.startsWith("/") || p.startsWith("~"))
+        return p;
+    const { join } = require("path");
+    return join(cwd ?? process.cwd(), p);
+}
 // ── server ───────────────────────────────────────────────────────────────────
 export function createServer() {
     const server = new McpServer({
@@ -483,17 +492,30 @@ export function createServer() {
         offset: z.number().optional().describe("Start line (0-indexed)"),
         limit: z.number().optional().describe("Max lines to return"),
         summarize: z.boolean().optional().describe("Return AI summary instead of full content (saves ~90% tokens)"),
-    }, async ({ path, offset, limit, summarize }) => {
+    }, async ({ path: rawPath, offset, limit, summarize }) => {
         const start = Date.now();
+        const path = resolvePath(rawPath);
         const result = cachedRead(path, { offset, limit });
         if (summarize && result.content.length > 500) {
-            const processed = await processOutput(`cat ${path}`, result.content);
-            logCall("read_file", { command: path, outputTokens: estimateTokens(result.content), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, aiProcessed: true });
+            // AI-native file summary — ask directly what the file does
+            const provider = getOutputProvider();
+            const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+            const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+            const summary = await provider.complete(`File: ${path}\n\n${content}`, {
+                model: outputModel,
+                system: `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose. Be specific — name the actual functions and what they do. Never just say "N lines of code."`,
+                maxTokens: 300,
+                temperature: 0.2,
+            });
+            const outputTokens = estimateTokens(result.content);
+            const summaryTokens = estimateTokens(summary);
+            const saved = Math.max(0, outputTokens - summaryTokens);
+            logCall("read_file", { command: path, outputTokens, tokensSaved: saved, durationMs: Date.now() - start, aiProcessed: true });
             return {
                 content: [{ type: "text", text: JSON.stringify({
-                            summary: processed.summary,
+                            summary,
                             lines: result.content.split("\n").length,
-                            tokensSaved: processed.tokensSaved,
+                            tokensSaved: saved,
                             cached: result.cached,
                         }) }],
             };
@@ -548,8 +570,9 @@ export function createServer() {
     // ── symbols: file structure outline ───────────────────────────────────────
     server.tool("symbols", "Get a structured outline of any source file — functions, classes, methods, interfaces, exports with line numbers. Works for ALL languages (TypeScript, Python, Go, Rust, Java, C#, Ruby, PHP, etc.). AI-powered, not regex.", {
         path: z.string().describe("File path to extract symbols from"),
-    }, async ({ path: filePath }) => {
+    }, async ({ path: rawPath }) => {
         const start = Date.now();
+        const filePath = resolvePath(rawPath);
         const result = cachedRead(filePath, {});
         if (!result.content || result.content.startsWith("Error:")) {
             return { content: [{ type: "text", text: JSON.stringify({ error: `Cannot read ${filePath}` }) }] };
@@ -590,8 +613,9 @@ Line numbers must be accurate (count from 1).`,
     server.tool("read_symbol", "Read a specific function, class, or interface by name from a source file. Returns only the code block — not the entire file. Saves 70-85% tokens vs reading the whole file.", {
         path: z.string().describe("Source file path"),
         name: z.string().describe("Symbol name (function, class, interface)"),
-    }, async ({ path: filePath, name }) => {
+    }, async ({ path: rawPath, name }) => {
         const start = Date.now();
+        const filePath = resolvePath(rawPath);
         const result = cachedRead(filePath, {});
         if (!result.content || result.content.startsWith("Error:")) {
             return { content: [{ type: "text", text: JSON.stringify({ error: `Cannot read ${filePath}` }) }] };
@@ -699,8 +723,9 @@ Match by function name, class name, method name (including ClassName.method), in
         find: z.string().describe("Text to find (exact match)"),
         replace: z.string().describe("Replacement text"),
         all: z.boolean().optional().describe("Replace all occurrences (default: first only)"),
-    }, async ({ file, find, replace, all }) => {
+    }, async ({ file: rawFile, find, replace, all }) => {
         const start = Date.now();
+        const file = resolvePath(rawFile);
         const { readFileSync, writeFileSync } = await import("fs");
         try {
             let content = readFileSync(file, "utf8");
@@ -726,8 +751,9 @@ Match by function name, class name, method name (including ClassName.method), in
         file: z.string().describe("File path to search in"),
         items: z.array(z.string()).describe("Names or patterns to look up"),
         context: z.number().optional().describe("Lines of context around each match (default: 3)"),
-    }, async ({ file, items, context }) => {
+    }, async ({ file: rawFile, items, context }) => {
         const start = Date.now();
+        const file = resolvePath(rawFile);
         const { readFileSync } = await import("fs");
         try {
             const content = readFileSync(file, "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "3.7.0",
+  "version": "3.7.2",
   "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

@@ -58,6 +58,14 @@ function exec(command: string, cwd?: string, timeout?: number, allowRewrite: boo
   });
 }
 
+/** Resolve a path — supports relative paths against cwd, just like a shell */
+function resolvePath(p: string, cwd?: string): string {
+  if (!p) return cwd ?? process.cwd();
+  if (p.startsWith("/") || p.startsWith("~")) return p;
+  const { join } = require("path");
+  return join(cwd ?? process.cwd(), p);
+}
+
 // ── server ───────────────────────────────────────────────────────────────────
 
 export function createServer(): McpServer {
@@ -685,18 +693,34 @@ export function createServer(): McpServer {
       limit: z.number().optional().describe("Max lines to return"),
       summarize: z.boolean().optional().describe("Return AI summary instead of full content (saves ~90% tokens)"),
     },
-    async ({ path, offset, limit, summarize }) => {
+    async ({ path: rawPath, offset, limit, summarize }) => {
       const start = Date.now();
+      const path = resolvePath(rawPath);
       const result = cachedRead(path, { offset, limit });
 
       if (summarize && result.content.length > 500) {
-        const processed = await processOutput(`cat ${path}`, result.content);
-        logCall("read_file", { command: path, outputTokens: estimateTokens(result.content), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, aiProcessed: true });
+        // AI-native file summary — ask directly what the file does
+        const provider = getOutputProvider();
+        const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
+        const content = result.content.length > 8000 ? result.content.slice(0, 8000) : result.content;
+        const summary = await provider.complete(
+          `File: ${path}\n\n${content}`,
+          {
+            model: outputModel,
+            system: `Describe what this source file does in 2-4 lines. Include: main class/module name, key methods/functions, what it exports, and its purpose. Be specific — name the actual functions and what they do. Never just say "N lines of code."`,
+            maxTokens: 300,
+            temperature: 0.2,
+          }
+        );
+        const outputTokens = estimateTokens(result.content);
+        const summaryTokens = estimateTokens(summary);
+        const saved = Math.max(0, outputTokens - summaryTokens);
+        logCall("read_file", { command: path, outputTokens, tokensSaved: saved, durationMs: Date.now() - start, aiProcessed: true });
         return {
           content: [{ type: "text" as const, text: JSON.stringify({
-            summary: processed.summary,
+            summary,
             lines: result.content.split("\n").length,
-            tokensSaved: processed.tokensSaved,
+            tokensSaved: saved,
             cached: result.cached,
           }) }],
         };
@@ -767,8 +791,9 @@ export function createServer(): McpServer {
     {
       path: z.string().describe("File path to extract symbols from"),
     },
-    async ({ path: filePath }) => {
+    async ({ path: rawPath }) => {
       const start = Date.now();
+      const filePath = resolvePath(rawPath);
       const result = cachedRead(filePath, {});
       if (!result.content || result.content.startsWith("Error:")) {
         return { content: [{ type: "text" as const, text: JSON.stringify({ error: `Cannot read ${filePath}` }) }] };
@@ -821,8 +846,9 @@ Line numbers must be accurate (count from 1).`,
       path: z.string().describe("Source file path"),
       name: z.string().describe("Symbol name (function, class, interface)"),
     },
-    async ({ path: filePath, name }) => {
+    async ({ path: rawPath, name }) => {
       const start = Date.now();
+      const filePath = resolvePath(rawPath);
       const result = cachedRead(filePath, {});
       if (!result.content || result.content.startsWith("Error:")) {
         return { content: [{ type: "text" as const, text: JSON.stringify({ error: `Cannot read ${filePath}` }) }] };
@@ -951,8 +977,9 @@ Match by function name, class name, method name (including ClassName.method), in
       replace: z.string().describe("Replacement text"),
       all: z.boolean().optional().describe("Replace all occurrences (default: first only)"),
     },
-    async ({ file, find, replace, all }) => {
+    async ({ file: rawFile, find, replace, all }) => {
       const start = Date.now();
+      const file = resolvePath(rawFile);
       const { readFileSync, writeFileSync } = await import("fs");
       try {
         let content = readFileSync(file, "utf8");
@@ -982,8 +1009,9 @@ Match by function name, class name, method name (including ClassName.method), in
       items: z.array(z.string()).describe("Names or patterns to look up"),
       context: z.number().optional().describe("Lines of context around each match (default: 3)"),
     },
-    async ({ file, items, context }) => {
+    async ({ file: rawFile, items, context }) => {
       const start = Date.now();
+      const file = resolvePath(rawFile);
       const { readFileSync } = await import("fs");
       try {
         const content = readFileSync(file, "utf8");