@ducci/jarvis 1.0.20 → 1.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ducci/jarvis",
-  "version": "1.0.20",
+  "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

@@ -221,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',