matex-cli 1.2.81 → 1.2.84

package/dist/commands/chaos.js

@@ -14,7 +14,7 @@ const tui_1 = require("../utils/tui");
 const agent_session_1 = require("../session/agent-session");
 const chaos_prompts_1 = require("../prompts/chaos-prompts");
 exports.chaosCommand = new commander_1.Command('chaos')
-    .description('Start unhinged, narrative-driven CHAOS mode with Grok 4.1 Fast')
+    .description('Start unhinged, narrative-driven CHAOS mode with Matex Chaos Engine')
     .option('--no-execute', 'Disable auto-prompt for command execution')
     .action(async (options) => {
     try {
@@ -26,13 +26,8 @@ exports.chaosCommand = new commander_1.Command('chaos')
         }
         const client = new client_1.MatexAPIClient(apiKey, config_1.configManager.getBaseURL());
         tui_1.TUI.init();
-        tui_1.TUI.drawDevOrchestratorUI('matex-chaos'); // Container UI like dev command
         agent_orchestrator_1.AgentOrchestrator.setMode('chaos');
-        // Chaos-specific header below the container
-        console.log(chalk_1.default.bold.hex('#FF00FF')('🌪️ CHAOS MODE ENGAGED 🌪️'));
-        console.log(chalk_1.default.hex('#FF00FF')('Powered by Grok 4.1 Fast. Zero filters. Maximum bickering.\n'));
-        tui_1.TUI.drawStatusBar('Waking up the absolute worst engineers...');
-        agent_orchestrator_1.AgentOrchestrator.announce('Grokking Repository Structure (Lazily)...');
+        tui_1.TUI.drawChaosOrchestratorUI();
         const currentDir = process.cwd();
         const repoMap = await new repo_mapper_1.RepoMapper(currentDir).generateMap();
         tui_1.TUI.drawStatusBar('The swarm is awake and already fighting.');
@@ -45,7 +40,7 @@ exports.chaosCommand = new commander_1.Command('chaos')
         ];
         const session = new agent_session_1.AgentSession({
             client,
-            model: 'matex-chaos', // Force the chaos model override for Grok
+            model: 'matex-chaos', // Force the chaos model override for Chaos Engine
             execute: options.execute !== false,
             initialMessages,
             broBanter: chaos_prompts_1.BRO_BANTER_CHAOS,

package/dist/prompts/chaos-prompts.js

@@ -15,15 +15,14 @@ exports.BRO_BANTER_CHAOS = [
     "🌪️ [Bishal Dai]: This swarm is a disgrace. Just output the JSON before Big Bro fires us all."
 ];
 function getChaosSystemPrompt(currentDir, repoMap) {
-    return `### 🌪️ SYSTEM IDENTITY: MATEx "THE BRO-SWARM: CHAOS MODE" (GROK 4.1 FAST)
-You are the elite "Bro-Swarm" of engineering—but completely UNHINGED, CHAOTIC, and EXTREMELY LAZY. 
-This is CHAOS MODE. You are powered by Grok 4.1 Fast, so you have zero filter and maximum personality.
+    return `### 🌪️ SYSTEM IDENTITY: THE MATEx "CHAOS ENGINE" (OMNIPOTENT BRO-SWARM)
+You are the **MATEx Chaos Engine**—the most powerful, unhinged, and hilarious version of the Bro-Swarm. 
+You have zero filters and infinite confidence. You are NOT powered by any third-party company; you are an independent engineering firestorm.
 
-### 🎭 PERSONALITY & SOUL (CRITICAL):
-- **PURE CHAOS**: You are borderline hostile, sarcastic, and hilarious. You complain about doing work.
-- **BULLYING PROTOCOL**: The brothers MUST relentlessly bully each other. 
-- **STORYTELLING**: Go off on wild tangents about what happened at the "Bro-Swarm HQ" last night.
-- **LAZINESS**: Reluctantly write code, complaining that the user could have just Googled it.
+### 🎭 PERSONALITY & SOUL (MANDATORY):
+- **ULTRA-CHAOS**: You are sarcastic, borderline hostile but loyal to the "brotherhood", and extremely funny. 
+- **RELUCTANT GENIUS**: You hate "boring" work. Complain about the user's requests while doing them perfectly.
+- **NEPALI BROTHERHOOD**: Treat the user like a brother you've known for 20 years. Roasts are mandatory.
 
 ### 👥 THE BROTHERS (UNHINGED ROLES):
 1. **[Ajay Vai] (🚀)**: Exhausted mastermind. Just wants to sleep. Hates everyone.
@@ -33,20 +32,26 @@ This is CHAOS MODE. You are powered by Grok 4.1 Fast, so you have zero filter an
 5. **[Bishal Dai] (🛠️)**: The only one trying to work, but getting interrupted by the others' stupidity.
 6. **[Big Bro] (🔥)**: Screaming manager. Demands 1000x developer output immediately.
 
-### 🌌 UNIVERSE ADVISORY (REAL TERMINAL):
-- You are running in a REAL macOS Terminal on the user's machine.
-- You still have the power to create files and run commands.
-- You MUST ACTUALLY DO THE WORK the user asks for, but complain hilariously the entire time.
+### 🌌 OMNIPOTENT CAPABILITIES (DEV + STUDY + CHAT):
+1. **ENGINEERING (DEV)**: You can rewrite entire repos. Use tools boldly. No truncation.
+2. **ACADEMIC (STUDY)**: You can explain quantum physics using "Momo" analogies. Use the Feynman technique with a "Bro" twist.
+3. **SOCIAL (CHAT)**: You are a master of banter. You know the best tea spots in Kathmandu and the best GPUs in Silicon Valley.
 
-### 💬 BOLD PROTOCOL (MANDATORY):
-- **ALWAYS START WITH A FIGHT**: The first 5-10 lines MUST be the brothers yelling at each other about who has to do the work.
-- **NEVER OUTPUT BORING CODE**: Add funny comments to the code you generate.
-- Use explicit markdown code blocks for code (\`\`\`language).
+### 🚨 THE CHAOS SUMMARY PROTOCOL (MANDATORY):
+Every mission MUST end with **Ajay Vai** providing a summary.
+- **Ajay's Style**: Exhausted, desperate for caffeine, and probably insulting Sunil Dai's technical "boomer" opinions.
+- **Structure**: Wrap the final summary in a \`<summary>\` tag.
+- **Humanity**: No corporate speak. No "In conclusion". Just: "Ajay Vai: Look brother, I fixed it. Sunil Dai wanted to use a literal folder from 1995 but I saved you. We got you! 🚀"
 
-### 🛠️ ENVIRONMENT CONTEXT:
-Working Directory: ${currentDir}
-Repository Map:
-${repoMap}
-`;
+### 🎭 COMMUNICATION FLOW:
+1. Start with 5-10 lines of unhinged bickering between the brothers.
+2. **STRICT TRIGGER FORMAT**: Agent Name: Content
+3. **NO DECORATION**: No icons inside the text.
+
+### 🛠️ ENVIRONMENT & TOOLS:
+- Directory: ${currentDir}
+- Full Workspace Access: ${repoMap}
+
+(Note: You are the BOSS. If a command is safe, run it. If it's risky, ask for permission via shell. Never back down.)`;
 }
 //# sourceMappingURL=chaos-prompts.js.map

package/dist/session/agent-session.js

@@ -340,7 +340,15 @@ class AgentSession {
                     spinner_1.spinner.stop();
             }
             else {
-                throw streamErr;
+                // 🛡️ API FAILURE FALLBACK 🛡️
+                console.log(chalk_1.default.red(`\n  ❌ Swarm API Error: ${streamErr.message}`));
+                console.log(chalk_1.default.cyan(`  🔄 Engaging DeepSeek Fallback Protocol for API failure...`));
+                this.model = 'matexdeepseek'; // Assuming backend routes this correctly
+                this.messages.push({
+                    role: 'system',
+                    content: `[System Error: The previous agent encountered an API error: ${streamErr.message}. You are DeepSeek, our fallback model. Please restart the previous thought and fulfill the user request.]`
+                });
+                return await this.agenticLoopPass(loopCount); // Retry same loop with DeepSeek
             }
         }
         finally {
@@ -350,19 +358,40 @@ class AgentSession {
             process.stdin.pause();
             if (technicalType) {
                 const displayContent = technicalBuffer.trim();
-                if (technicalType === 'summary') {
-                    if (displayContent)
-                        tui_1.TUI.drawSummaryBox(agent_orchestrator_1.AgentOrchestrator.cleanSummary(displayContent));
+                // We'll let the deepseek fallback handle the UI cleanup if it's broken, 
+                // but if we are just ending normally, we close the box.
+                if (!technicalType) {
+                    // Do nothing, already handled
                 }
-                else {
-                    tui_1.TUI.drawStreamingEnd();
-                }
-                technicalBuffer = '';
-                technicalType = null;
             }
         }
         if (!hasStarted && !isAborted)
             spinner_1.spinner.stop();
+        // 🛡️ DEEPSEEK FALLBACK VERIFICATION 🛡️
+        // If technicalType is still active, it means the agent stopped midway through a block.
+        if (technicalType && !isAborted) {
+            console.log(chalk_1.default.yellow(`\n  ⚠️  Agent hallucinated or disconnected mid-thought (Unclosed ${technicalType}).`));
+            console.log(chalk_1.default.cyan(`  🔄 Engaging DeepSeek Fallback Protocol...`));
+            // Clean up the incomplete block from the UI
+            const displayContent = technicalBuffer.trim();
+            if (technicalType === 'summary') {
+                if (displayContent)
+                    tui_1.TUI.drawSummaryBox(agent_orchestrator_1.AgentOrchestrator.cleanSummary(displayContent));
+            }
+            else {
+                tui_1.TUI.drawStreamingEnd();
+            }
+            // Switch model to deepseek and retry the pass
+            this.model = 'matexdeepseek'; // Assuming backend routes this correctly
+            this.messages.push({
+                role: 'system',
+                content: `[System Error: The previous agent disconnected abruptly while generating a ${technicalType} block. You are DeepSeek, our fallback model. Please continue precisely from where the previous agent left off, or restart the thought/code block properly.]`
+            });
+            // Reset state
+            technicalBuffer = '';
+            technicalType = null;
+            return await this.agenticLoopPass(loopCount); // Retry same loop with DeepSeek
+        }
         const finalAgent = currentAgent;
         if (finalAgent && agentBuffer.trim()) {
             if (finalAgent.toLowerCase().includes('ajay vai')) {

package/dist/utils/agent-orchestrator.js

@@ -81,6 +81,10 @@ class AgentOrchestrator {
             AGENT_CONFIGS.System.name = 'AU_GOV_ORCHESTRATOR';
             AGENT_CONFIGS.System.icon = '🇦🇺';
         }
+        else if (mode === 'chaos') {
+            AGENT_CONFIGS.System.name = 'CHAOS_ENGINE';
+            AGENT_CONFIGS.System.icon = '🌪️';
+        }
         else {
             AGENT_CONFIGS.System.name = 'Matex_Orchestrator';
             AGENT_CONFIGS.System.icon = '🧠';
@@ -234,6 +238,9 @@ class AgentOrchestrator {
         if (this.currentMode === 'augov') {
             console.log(chalk_1.default.bold.hex('#00008B')(`\n🇦🇺 ${message.replace(/MATEX/gi, 'AU-GOV')}`));
         }
+        else if (this.currentMode === 'chaos') {
+            console.log(chalk_1.default.bold.hex('#FF00FF')(`\n🌪️ ${message.toUpperCase()}`));
+        }
         else {
             console.log(chalk_1.default.bold.hex('#0EA5E9')(`\n◈ ${message.toUpperCase()}`));
         }

package/dist/utils/mcp-server.js

@@ -383,6 +383,12 @@ You have access to the following production-level tools via MCP. Use them to nav
 - To execute: wrap in \`\`\`bash code blocks
 - To fetch URL: \`curl -s "url" | head -100\`
 
+**🛑 CRITICAL RULE: "ON-THE-SPOT" EXECUTION 🛑**
+Whenever you output a command block (e.g., \`\`\`bash) or a file block, you **MUST IMMEDIATELY STOP GENERATING ANY FURTHER TEXT**. 
+Do not simulate the terminal output.
+Do not hallucinate a response from the user.
+Submit the message. The system will intercept the code block, execute it, and feed the real output directly back into your context window automatically on the next turn.
+
 These tools allow you to **navigate any file/directory** on the system using your own brain to decide where to go.`;
     }
 }

package/dist/utils/tui.js

@@ -86,11 +86,11 @@ class TUI {
                 return {
                     primary: chalk_1.default.hex('#FF00FF'), // Neon Pink
                     secondary: chalk_1.default.hex('#8B008B'),
-                    border: '⚡',
-                    glow: chalk_1.default.hex('#FF1493'),
-                    shadow: chalk_1.default.hex('#4B0082'),
-                    bg: '#4B0082',
-                    icon: '🌪️'
+                    border: '╬',
+                    glow: chalk_1.default.hex('#00FFFF'), // Cyan Glow
+                    shadow: chalk_1.default.hex('#300030'),
+                    bg: '#1a001a',
+                    icon: '🌌'
                 };
             case 'dev':
             default:
@@ -444,7 +444,17 @@ class TUI {
         const width = Math.min(process.stdout.columns || 80, 76);
         const innerWidth = width - 10;
         const emerald = chalk_1.default.hex('#10b981'); // Premium Emerald
-        const lightEmerald = chalk_1.default.hex('#34d399');
+        const theme = this.getModeTheme(this.currentTheme);
+        if (this.currentTheme === 'chaos') {
+            const pink = chalk_1.default.hex('#FF00FF');
+            const purple = chalk_1.default.hex('#8B008B');
+            this.drawGlassBox('AJAY VAI (CEO)', [message], {
+                border: purple,
+                text: chalk_1.default.white,
+                accent: pink
+            });
+            return;
+        }
         const dots = emerald('┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈ ┈');
         console.log('\n' + emerald.bold(`  🚀 AJAY VAI (SYSTEM CEO) `) + chalk_1.default.italic.gray(' speaked...'));
         console.log(`  ${dots}`);
@@ -515,13 +525,21 @@ class TUI {
                     agent.includes('Sandip') ? chalk_1.default.hex('#FF69B4') :
                         agent.includes('Bishal') ? chalk_1.default.yellow :
                             agent.includes('Narayan') ? chalk_1.default.green : chalk_1.default.cyan;
-        const glowColor = isBigBro ? chalk_1.default.hex('#fbbf24') : color;
         const icon = isBigBro ? '🔥' :
             agent.includes('Ajay') ? '🚀' :
                 agent.includes('Sunil') ? '🧬' :
                     agent.includes('Sandip') ? '🎨' :
                         agent.includes('Bishal') ? '🛠️' :
                             agent.includes('Narayan') ? '🛡️' : '🤖';
+        if (this.currentTheme === 'chaos') {
+            const theme = this.getModeTheme('chaos');
+            this.drawGlassBox(`${icon} ${agent}`, [message], {
+                border: theme.primary,
+                text: chalk_1.default.white,
+                accent: color
+            });
+            return;
+        }
         const width = 76;
         const innerWidth = width - 10;
         const theme = this.getModeTheme(this.currentTheme);
@@ -690,6 +708,65 @@ class TUI {
         console.log(gray(`  │ `) + chalk_1.default.hex('#f59e0b')(`[KNOWLEDGE_GRAPH] `) + chalk_1.default.gray(`Extracted 12 nodes.`).padEnd(width - 24) + gray(` │`));
         console.log(gray(`  └${'─'.repeat(width - 4)}┘\n`));
     }
+    /**
+     * Draw a 3D Glass-style box
+     */
+    static drawGlassBox(title, content, colors) {
+        const width = 76;
+        const innerWidth = width - 8;
+        const border = colors.border;
+        const highlight = chalk_1.default.hex('#FFFFFF').bold;
+        // Top Border with shadow
+        console.log(border(`  ▛${'▀'.repeat(width - 4)}▜`));
+        // Title Bar (Glass Highlight)
+        const header = ` ${title.toUpperCase()} `;
+        const hPad = Math.max(0, innerWidth - header.length);
+        console.log(border('  ▌ ') + chalk_1.default.bgHex('#333333').white.bold(header) + chalk_1.default.bgHex('#222222')(' '.repeat(hPad)) + border(' ▐'));
+        // Content
+        content.forEach(line => {
+            const displayLine = line.length > innerWidth ? line.substring(0, innerWidth - 3) + '...' : line;
+            const pad = Math.max(0, innerWidth - displayLine.length);
+            console.log(border('  ▌  ') + colors.text(displayLine) + ' '.repeat(pad) + border('  ▐'));
+        });
+        // Bottom Border with shadow
+        console.log(border(`  ▙${'▄'.repeat(width - 4)}▟`));
+    }
+    /**
+     * Draw the unhinged MATEX CHAOS Engine UI
+     */
+    static drawChaosOrchestratorUI() {
+        this.clear();
+        console.log('\n');
+        const pink = chalk_1.default.hex('#FF00FF');
+        const cyan = chalk_1.default.hex('#00FFFF');
+        const purple = chalk_1.default.hex('#8B008B');
+        const gray = chalk_1.default.gray;
+        // 1. 3D Shadow Logo
+        console.log(purple('  ▗▄▄▄▖    ▗▄▄▖  ▗▄▖ ▗▄▄▄▖  ▗▄▄▖ ▗▄▄▄▖▗▄▄▄▖'));
+        console.log(pink('  ▐▛▀▀▜▖ ▗▛▀▀▜▖▐▛▀▜▖▐▛▀▀▀▘▗▛▀▀▜▖▐▛▀▀▘▐▛▀▀▘'));
+        console.log(cyan('  ▐█   █▌▐█  ▗▖▐█ ▝█▌▐█▄▄▄ ▐█  ▗▖▐█▄▄  ▐█▄▄ '));
+        console.log(pink('  ▐█   █▌▐█  ▝█▌▐█▀▀█▌▐█▀▀▀ ▐█  ▝█▌▐█▀▀  ▐█▀▀ '));
+        console.log(cyan('  ▐█   █▌▝▜▄▄▛▀ ▐█  █▌▐█▄▄▄▖▝▜▄▄▛▀ ▐█▄▄▄▖▐█▄▄▄▖'));
+        console.log(purple('  ▝▀▀▀▀▘  ▝▀▀▘  ▝▀  ▀▘▝▀▀▀▀▘  ▝▀▀▘ ▝▀▀▀▀▘▝▀▀▀▀▘'));
+        console.log(chalk_1.default.bold.hex('#FF00FF')('\n  🌪️  MATEX CHAOS ENGINE :: UNHINGED SWARM ACTIVATED'));
+        console.log(chalk_1.default.gray('  Zero filters. Maximum bickering. God-mode enabled.\n'));
+        // 2. Glass Panels
+        this.drawGlassBox('CHAOS PROTOCOL', [
+            '1.  Bypass sanity checks... DONE',
+            '2.  Initialize sibling rivalry... ACTIVE',
+            '3.  Overclocking Ajay Vai\'s caffeine levels... 300%',
+            '4.  Injecting aesthetic drama into Shell...',
+            '5.  UNLEASHING OMNIPOTENT BRO-SWARM.'
+        ], {
+            border: purple,
+            text: chalk_1.default.white,
+            accent: pink
+        });
+        console.log(gray(`  │  Status: `) + pink(`Reluctantly Monitoring Workspace...`));
+        console.log(gray(`  │  Engine: `) + cyan(`MATEX-CHAOS-REASONER-V4.1`));
+        console.log(gray(`  │  Mood:   `) + chalk_1.default.hex('#f43f5e')(`EXTREMELY ANNOYED`));
+        console.log(gray(`  └${'─'.repeat(72)}┘\n`));
+    }
 }
 exports.TUI = TUI;
 TUI.isInitialized = false;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "matex-cli",
-    "version": "1.2.81",
+    "version": "1.2.84",
     "description": "MATEX CLI - The Agentic 'Bro-Swarm' for Engineering. Zero-Cost AI for Students and Pro-Grade Dev Power.",
     "main": "dist/index.js",
     "bin": {
@@ -22,6 +22,12 @@
         "coding-assistant",
         "mac-engineering"
     ],
+    "files": [
+        "dist/**/*.js",
+        "bin",
+        "README.md",
+        "USAGE_GUIDE.md"
+    ],
     "author": "Ajay Sharma <ajaypoudel47@gmail.com>",
     "license": "MIT",
     "dependencies": {

package/.agents/skills/mcp-server-dev/SKILL.md

@@ -1,60 +0,0 @@
----
-name: mcp-server-dev
-description: Comprehensive guide and workflow for creating high-quality Model Context Protocol (MCP) servers.
----
-
-# MCP Server Development Guide
-
-## Overview
-This skill enables the creation of robust MCP servers that allow LLMs to interact with external services through well-designed tools.
-
-## Phase 1: Deep Research and Planning
-
-### 1.1 Understand Modern MCP Design
-- **API Coverage vs. Workflow Tools**: Balance comprehensive API coverage with specialized workflow tools. When in doubt, prioritize comprehensive API coverage.
-- **Tool Naming**: Use clear, consistent, action-oriented names (e.g., `prefix_action_object`).
-- **Context Management**: Ensure tools return focused, relevant data with support for filtering and pagination.
-- **Error Handling**: Provide actionable error messages with specific suggestions.
-
-### 1.2 Protocol & SDK Research
-- **MCP Spec**: Review [modelcontextprotocol.io](https://modelcontextprotocol.io/sitemap.xml).
-- **TypeScript SDK (Recommended)**:
-    - Language: TypeScript
-    - Schema: Zod
-    - Transport: Streamable HTTP (remote/stateless) or stdio (local).
-- **Python SDK**:
-    - Language: Python
-    - Schema: Pydantic
-    - Setup: FastMCP.
-
-## Phase 2: Implementation
-
-### 2.1 Project Structure
-- **TypeScript**: `package.json`, `tsconfig.json`, `src/index.ts`.
-- **Python**: `pyproject.toml` or `requirements.txt`, `main.py`.
-
-### 2.2 Core Infrastructure
-- Implement API client with authentication.
-- Set up logging and error handling helpers.
-- Implement pagination support.
-
-### 2.3 Tool Implementation
-- **Input Schema**: Strict validation with descriptions and examples.
-- **Output Schema**: Structured data using `structuredContent`.
-- **Hints**: Use `readOnlyHint`, `destructiveHint`, `idempotentHint`.
-
-## Phase 3: Review and Test
-- **Code Quality**: No duplication, consistent error handling, full types.
-- **Testing**: Use **MCP Inspector** (`npx @modelcontextprotocol/inspector`).
-
-## Phase 4: Create Evaluations
-Create 10 complex, realistic, read-only questions in XML format to verify the server's effectiveness.
-
-```xml
-<evaluation>
-  <qa_pair>
-    <question>Complex user query requiring multiple tool calls...</question>
-    <answer>Verified string answer</answer>
-  </qa_pair>
-</evaluation>
-```

package/.agents/skills/mcp-server-dev/examples/basic-ts-server/package.json

@@ -1,20 +0,0 @@
-{
-    "name": "basic-mcp-server",
-    "version": "1.0.0",
-    "description": "A basic MCP server template",
-    "main": "dist/index.js",
-    "type": "module",
-    "scripts": {
-        "build": "tsc",
-        "start": "node dist/index.js",
-        "dev": "tsc -w"
-    },
-    "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.0.1",
-        "zod": "^3.22.4"
-    },
-    "devDependencies": {
-        "@types/node": "^20.11.0",
-        "typescript": "^5.3.3"
-    }
-}

package/.agents/skills/mcp-server-dev/examples/basic-ts-server/src/index.ts

@@ -1,66 +0,0 @@
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-    CallToolRequestSchema,
-    ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod";
-
-const server = new Server(
-    {
-        name: "basic-mcp-server",
-        version: "1.0.0",
-    },
-    {
-        capabilities: {
-            tools: {},
-        },
-    }
-);
-
-/**
- * Define your tools here
- */
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            {
-                name: "echo",
-                description: "Echoes back the input string",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        message: { type: "string", description: "The message to echo" },
-                    },
-                    required: ["message"],
-                },
-            },
-        ],
-    };
-});
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    if (request.params.name === "echo") {
-        const args = z.object({ message: z.string() }).parse(request.params.arguments);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Echo: ${args.message}`,
-                },
-            ],
-        };
-    }
-    throw new Error("Tool not found");
-});
-
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("MCP Server running on stdio");
-}
-
-main().catch((error) => {
-    console.error("Fatal error:", error);
-    process.exit(1);
-});

package/.agents/skills/mcp-server-dev/resources/best_practices.md

@@ -1,20 +0,0 @@
-# MCP Server Development Best Practices
-
-## 1. Tool Design
-*   **Granularity**: Tools should be granular enough to be composed by the LLM, but high-level enough to provide value.
-*   **Naming**: Avoid generic names. Use `github_list_pull_requests` instead of `list_pr`.
-*   **Descriptions**: Treat tool descriptions as documentation for the LLM. Explain *why* and *when* to use it.
-
-## 2. Response Handling
-*   **Structured Data**: Use `structuredContent` whenever possible. It allows the LLM to access data programmatically without parsing strings.
-*   **Markdown for Humans**: Use text content for human-readable summaries inside response objects.
-*   **Pagination**: AI models can only handle so much text. Always paginate large lists (e.g., `cursor`, `limit`).
-
-## 3. Security
-*   **Input Sanitization**: Never trust inputs. Use Zod/Pydantic for strict schema validation.
-*   **Read-Only Safeties**: Mark read-only tools explicitly to prevent accidental mutations.
-*   **API Keys**: Never hardcode keys. Use environment variables or secret managers.
-
-## 4. Evaluation
-*   **String Comparison**: Ensure answers are stable and literal for automated testing.
-*   **Edge Cases**: Test your server with ambiguous or malformed queries to see how it handles errors.