@hasna/terminal 3.7.1 → 3.7.3

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,8 +492,9 @@ 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) {
             // AI-native file summary — ask directly what the file does
@@ -560,19 +570,22 @@ 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}` }) }] };
         }
         // AI extracts symbols — works for ANY language
-        const provider = getOutputProvider();
-        const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
-        const content = result.content.length > 6000 ? result.content.slice(0, 6000) : result.content;
-        const summary = await provider.complete(`File: ${filePath}\n\n${content}`, {
-            model: outputModel,
-            system: `Extract all symbols from this source file. Return ONLY a JSON array, no explanation.
+        let symbols = [];
+        try {
+            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: ${filePath}\n\n${content}`, {
+                model: outputModel,
+                system: `Extract all symbols from this source file. Return ONLY a JSON array, no explanation.
 
 Each symbol: {"name": "symbolName", "kind": "function|class|method|interface|type|variable|export", "line": lineNumber, "signature": "brief signature"}
 
@@ -580,17 +593,17 @@ For class methods, use "ClassName.methodName" as name with kind "method".
 Include: functions, classes, methods, interfaces, types, exported constants.
 Exclude: imports, local variables, comments.
 Line numbers must be accurate (count from 1).`,
-            maxTokens: 1000,
-            temperature: 0,
-        });
-        // Parse AI response
-        let symbols = [];
-        try {
+                maxTokens: 2000,
+                temperature: 0,
+            });
             const jsonMatch = summary.match(/\[[\s\S]*\]/);
             if (jsonMatch)
                 symbols = JSON.parse(jsonMatch[0]);
         }
-        catch { }
+        catch (err) {
+            // Surface the error instead of silently returning []
+            return { content: [{ type: "text", text: JSON.stringify({ error: `AI symbol extraction failed: ${err.message?.slice(0, 200)}`, file: filePath }) }] };
+        }
         const outputTokens = estimateTokens(result.content);
         const symbolTokens = estimateTokens(JSON.stringify(symbols));
         logCall("symbols", { command: filePath, outputTokens, tokensSaved: Math.max(0, outputTokens - symbolTokens), durationMs: Date.now() - start, aiProcessed: true });
@@ -602,8 +615,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}` }) }] };
@@ -711,8 +725,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");
@@ -738,8 +753,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.1",
+  "version": "3.7.3",
   "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,8 +693,9 @@ 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) {
@@ -782,22 +791,25 @@ 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}` }) }] };
       }
 
       // AI extracts symbols — works for ANY language
-      const provider = getOutputProvider();
-      const outputModel = provider.name === "groq" ? "llama-3.1-8b-instant" : undefined;
-      const content = result.content.length > 6000 ? result.content.slice(0, 6000) : result.content;
-      const summary = await provider.complete(
-        `File: ${filePath}\n\n${content}`,
-        {
-          model: outputModel,
-          system: `Extract all symbols from this source file. Return ONLY a JSON array, no explanation.
+      let symbols: any[] = [];
+      try {
+        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: ${filePath}\n\n${content}`,
+          {
+            model: outputModel,
+            system: `Extract all symbols from this source file. Return ONLY a JSON array, no explanation.
 
 Each symbol: {"name": "symbolName", "kind": "function|class|method|interface|type|variable|export", "line": lineNumber, "signature": "brief signature"}
 
@@ -805,17 +817,17 @@ For class methods, use "ClassName.methodName" as name with kind "method".
 Include: functions, classes, methods, interfaces, types, exported constants.
 Exclude: imports, local variables, comments.
 Line numbers must be accurate (count from 1).`,
-          maxTokens: 1000,
-          temperature: 0,
-        }
-      );
+            maxTokens: 2000,
+            temperature: 0,
+          }
+        );
 
-      // Parse AI response
-      let symbols: any[] = [];
-      try {
         const jsonMatch = summary.match(/\[[\s\S]*\]/);
         if (jsonMatch) symbols = JSON.parse(jsonMatch[0]);
-      } catch {}
+      } catch (err: any) {
+        // Surface the error instead of silently returning []
+        return { content: [{ type: "text" as const, text: JSON.stringify({ error: `AI symbol extraction failed: ${err.message?.slice(0, 200)}`, file: filePath }) }] };
+      }
 
       const outputTokens = estimateTokens(result.content);
       const symbolTokens = estimateTokens(JSON.stringify(symbols));
@@ -836,8 +848,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}` }) }] };
@@ -966,8 +979,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");
@@ -997,8 +1011,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");