@ducci/jarvis 1.0.19 → 1.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ducci/jarvis",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "A fully automated agent system that lives on a server.",
   "main": "./src/index.js",
   "type": "module",

package/src/scripts/onboarding.js

@@ -300,6 +300,44 @@ async function run() {
     }
   }
 
+  // --- PERPLEXITY STEP (OPTIONAL) ---
+  const existingPerplexityKey = loadEnvVar('PERPLEXITY_API_KEY');
+  const { configurePerplexity } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'configurePerplexity',
+      message: 'Do you want to configure Perplexity web search?',
+      default: !!existingPerplexityKey
+    }
+  ]);
+
+  if (configurePerplexity) {
+    let keepPerplexityKey = false;
+    if (existingPerplexityKey) {
+      const { keep } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'keep',
+          message: 'A PERPLEXITY_API_KEY is already configured. Do you want to keep it?',
+          default: true
+        }
+      ]);
+      keepPerplexityKey = keep;
+    }
+    if (!keepPerplexityKey) {
+      const { perplexityKey } = await inquirer.prompt([
+        {
+          type: 'password',
+          name: 'perplexityKey',
+          message: 'Enter your Perplexity API key (from perplexity.ai/settings/api):',
+          validate: (input) => input.trim().length > 0 || 'API key cannot be empty.'
+        }
+      ]);
+      saveEnvVar('PERPLEXITY_API_KEY', perplexityKey.trim());
+      console.log(chalk.green('Perplexity API key saved.'));
+    }
+  }
+
   console.log(chalk.green.bold('\nSetup complete!'));
 }
 

package/src/server/tools.js

@@ -124,7 +124,7 @@ const SEED_TOOLS = {
       type: 'function',
       function: {
         name: 'save_tool',
-        description: 'Create or update a custom tool and make it available immediately in this session. Use this to build reusable JS tools for tasks you repeat. The tool code runs in Node.js and has access to: args, fs, path, process, require, __jarvisDir.',
+        description: 'Create or update a custom tool and make it available immediately in this session. Use this to build reusable JS tools for tasks you repeat. The tool code runs in Node.js and has access to: args, fs, path, process, require, __jarvisDir. To update an existing tool, first call get_tool to read its current code and parameters, then call save_tool with your modifications.',
         parameters: {
           type: 'object',
           properties: {
@@ -151,6 +151,26 @@ const SEED_TOOLS = {
     },
     code: `const toolsFile = path.join(process.env.HOME, '.jarvis/data/tools/tools.json'); const raw = await fs.promises.readFile(toolsFile, 'utf8').catch(() => '{}'); const tools = JSON.parse(raw); tools[args.name] = { definition: { type: 'function', function: { name: args.name, description: args.description, parameters: args.parameters } }, code: args.code }; await fs.promises.writeFile(toolsFile, JSON.stringify(tools, null, 2), 'utf8'); return { status: 'ok', saved: args.name };`,
   },
+  get_tool: {
+    definition: {
+      type: 'function',
+      function: {
+        name: 'get_tool',
+        description: 'Read the full definition and code of a single tool by name. Use this before updating an existing tool so you understand its current implementation.',
+        parameters: {
+          type: 'object',
+          properties: {
+            name: {
+              type: 'string',
+              description: 'The tool name to retrieve.',
+            },
+          },
+          required: ['name'],
+        },
+      },
+    },
+    code: `const toolsFile = path.join(process.env.HOME, '.jarvis/data/tools/tools.json'); const raw = await fs.promises.readFile(toolsFile, 'utf8').catch(() => '{}'); const tools = JSON.parse(raw); const tool = tools[args.name]; if (!tool) return { status: 'not_found', name: args.name }; return { status: 'ok', name: args.name, definition: tool.definition, code: tool.code };`,
+  },
   list_tools: {
     definition: {
       type: 'function',
@@ -201,6 +221,51 @@ const SEED_TOOLS = {
       }
     `,
   },
+  perplexity_search: {
+    definition: {
+      type: 'function',
+      function: {
+        name: 'perplexity_search',
+        description: 'Search the web using Perplexity AI. Returns an answer grounded in real-time web results with citations. Use this for current events, factual lookups, or research questions.',
+        parameters: {
+          type: 'object',
+          properties: {
+            query: {
+              type: 'string',
+              description: 'The search query or question.',
+            },
+            model: {
+              type: 'string',
+              enum: ['sonar', 'sonar-pro', 'sonar-deep-research'],
+              description: 'Search model to use. sonar: fast and cheap, good for simple lookups. sonar-pro: deeper multi-step search, more citations, better for complex questions. sonar-deep-research: long-form research reports. Defaults to sonar.',
+            },
+            search_recency_filter: {
+              type: 'string',
+              enum: ['hour', 'day', 'week', 'month', 'year'],
+              description: 'Optional time filter to restrict results to recent content.',
+            },
+          },
+          required: ['query'],
+        },
+      },
+    },
+    code: `
+      const OpenAI = require('openai');
+      const client = new OpenAI({
+        apiKey: process.env.PERPLEXITY_API_KEY,
+        baseURL: 'https://api.perplexity.ai',
+      });
+      const params = {
+        model: args.model || 'sonar',
+        messages: [{ role: 'user', content: args.query }],
+      };
+      if (args.search_recency_filter) params.search_recency_filter = args.search_recency_filter;
+      const response = await client.chat.completions.create(params);
+      const answer = response.choices[0].message.content;
+      const citations = response.citations || [];
+      return { answer, citations };
+    `,
+  },
   get_recent_sessions: {
     definition: {
       type: 'function',