@hasna/terminal 3.7.2 → 3.7.4

package/dist/mcp/server.js

@@ -436,7 +436,13 @@ export function createServer() {
     // ── boot: session start context (replaces first 5 agent commands) ──────────
     server.tool("boot", "Get everything an agent needs on session start in ONE call — git state, project info, source structure. Replaces: git status + git log + cat package.json + ls src/. Cached for the session.", async () => {
         const ctx = await getBootContext(process.cwd());
-        return { content: [{ type: "text", text: JSON.stringify(ctx) }] };
+        return { content: [{ type: "text", text: JSON.stringify({
+                        ...ctx,
+                        hints: {
+                            cwd: process.cwd(),
+                            tip: "All terminal tools support relative paths. Use 'src/foo.ts' not the full absolute path. Use commit({message, push:true}) instead of raw git commands. Use run({task:'test'}) instead of bun/npm test. Use lookup({file, items}) instead of grep pipelines.",
+                        },
+                    }) }] };
     });
     // ── project_overview: orient agent in one call ─────────────────────────────
     server.tool("project_overview", "Get project overview in one call — package.json info, source structure, config files. Replaces: cat package.json + ls src/ + cat tsconfig.json.", {
@@ -578,12 +584,14 @@ export function createServer() {
             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"}
 
@@ -591,17 +599,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 });

package/package.json

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

@@ -615,7 +615,13 @@ export function createServer(): McpServer {
     "Get everything an agent needs on session start in ONE call — git state, project info, source structure. Replaces: git status + git log + cat package.json + ls src/. Cached for the session.",
     async () => {
       const ctx = await getBootContext(process.cwd());
-      return { content: [{ type: "text" as const, text: JSON.stringify(ctx) }] };
+      return { content: [{ type: "text" as const, text: JSON.stringify({
+        ...ctx,
+        hints: {
+          cwd: process.cwd(),
+          tip: "All terminal tools support relative paths. Use 'src/foo.ts' not the full absolute path. Use commit({message, push:true}) instead of raw git commands. Use run({task:'test'}) instead of bun/npm test. Use lookup({file, items}) instead of grep pipelines.",
+        },
+      }) }] };
     }
   );
 
@@ -800,14 +806,16 @@ export function createServer(): McpServer {
       }
 
       // 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"}
 
@@ -815,17 +823,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));