apex-dev 2.0.0 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apex-dev",
-  "version": "2.0.0",
+  "version": "2.1.3",
   "description": "Apex AI - a friendly agentic coding assistant for the terminal",
   "main": "index.js",
   "bin": {

package/src/toolExecutors.js

@@ -2,6 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const https = require('https');
 const { execSync } = require('child_process');
 const {
   PROJECT_ROOT,
@@ -215,6 +216,64 @@ async function executeTool(name, args) {
         return truncateOutput(`Task: ${args.description}\n${'─'.repeat(40)}\n${results.join('\n\n')}`);
       }
 
+      case 'WebSearch': {
+        const apiKey = process.env.EXA_API_KEY;
+        if (!apiKey) return 'Error: EXA_API_KEY environment variable is not set. Get one at https://dashboard.exa.ai/api-keys';
+
+        const body = JSON.stringify({
+          query: args.query,
+          numResults: Math.min(args.num_results || 5, 10),
+          type: args.type || 'auto',
+          ...(args.include_domains && { includeDomains: args.include_domains }),
+          ...(args.category && { category: args.category }),
+          contents: { highlights: { maxCharacters: 300 }, text: { maxCharacters: 1000 } },
+        });
+
+        const result = await new Promise((resolve) => {
+          const req = https.request({
+            hostname: 'api.exa.ai',
+            path: '/search',
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              'x-api-key': apiKey,
+            },
+          }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => data += chunk);
+            res.on('end', () => {
+              if (res.statusCode !== 200) {
+                resolve(`Error: Exa API returned ${res.statusCode}: ${data}`);
+                return;
+              }
+              try {
+                const json = JSON.parse(data);
+                if (!json.results || json.results.length === 0) {
+                  resolve('No results found.');
+                  return;
+                }
+                const formatted = json.results.map((r, i) => {
+                  let entry = `${i + 1}. **${r.title || 'Untitled'}**\n   ${r.url}`;
+                  if (r.publishedDate) entry += `\n   Published: ${r.publishedDate.split('T')[0]}`;
+                  if (r.author) entry += `\n   Author: ${r.author}`;
+                  if (r.text) entry += `\n   ${r.text.trim().slice(0, 500)}`;
+                  else if (r.highlights && r.highlights.length) entry += `\n   ${r.highlights[0].trim().slice(0, 300)}`;
+                  return entry;
+                }).join('\n\n');
+                resolve(truncateOutput(`Web Search Results (${json.results.length}):\n${'─'.repeat(40)}\n${formatted}`));
+              } catch (e) {
+                resolve(`Error: Failed to parse Exa response: ${e.message}`);
+              }
+            });
+          });
+          req.on('error', (e) => resolve(`Error: Exa request failed: ${e.message}`));
+          req.setTimeout(15000, () => { req.destroy(); resolve('Error: Exa search timed out.'); });
+          req.write(body);
+          req.end();
+        });
+        return result;
+      }
+
       case 'CodeReview': {
         // Auto-collect all modified files from this session
         const allFiles = new Set([...session.filesModified]);

package/src/tools.js

@@ -169,6 +169,28 @@ const toolDefs = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'WebSearch',
+      description: 'Search the web using Exa AI. Returns relevant results with titles, URLs, and text snippets. Use this to find up-to-date information, documentation, or answers from the internet.',
+      parameters: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: 'The search query to execute.' },
+          num_results: { type: 'number', description: 'Number of results to return (default: 5, max: 10).' },
+          type: { type: 'string', description: 'Search type: "auto" (default), "neural", or "keyword".' },
+          include_domains: {
+            type: 'array',
+            description: 'Only return results from these domains, e.g. ["github.com", "stackoverflow.com"].',
+            items: { type: 'string' },
+          },
+          category: { type: 'string', description: 'Filter by category: "news", "research paper", "tweet", "company", "personal site", etc.' },
+        },
+        required: ['query'],
+      },
+    },
+  },
   {
     type: 'function',
     function: {