squidclaw 2.2.0 → 2.4.0

package/lib/tools/router.js

@@ -23,7 +23,9 @@ export class ToolRouter {
   getToolDescriptions() {
     const tools = [
       '## Available Tools',
-      'You can use tools by including special tags in your response:',
+      'You can use tools by including special tags in your response.',
+      'IMPORTANT: You CAN send files, images, voice notes, and documents in this chat. The system handles delivery automatically.',
+      'When asked to create files (PowerPoint, etc), USE THE TOOL — do NOT say you cannot send files.',
       '',
       '### Web Search',
       '---TOOL:search:your search query---',
@@ -59,19 +61,54 @@ export class ToolRouter {
         'Send an email.');
     }
 
-    tools.push('', '### Create PowerPoint',
-      '---TOOL:pptx:Title of Presentation---',
-      'Create a .pptx PowerPoint file. After calling this, generate slides using markdown format:',
-      '## Slide Title',
-      '- Bullet point 1',
-      '- Bullet point 2',
+    tools.push('', '### Create PowerPoint (SENDS AS FILE IN CHAT!)',
+      '---TOOL:pptx_slides:Title|theme|slides content---',
+      'Creates a .pptx file and SENDS IT directly. You MUST use this when asked for PPT/presentation.',
+      'Format: title|theme|slides. Themes: dark, light, blue, green, corporate, red, gradient, minimal, saudi, ocean.',
       '',
-      '## Another Slide',
-      '- More content',
+      'SLIDE TYPES (use tags in ## title):',
+      '- Normal: ## Title then - bullet points',
+      '- Chart: ## Revenue [chart:bar] then - Label: value (types: bar, pie, line, doughnut, area)',
+      '- Table: ## Data [table] then | Col1 | Col2 | rows',
+      '- Stats: ## Metrics [stats] then - 📊 100M — Active users',
+      '- Timeline: ## History [timeline] then - 2020: Event happened',
+      '- Quote: ## [quote] then quote text then — Author Name',
+      '- Compare: ## Comparison [compare] then left items, ---, right items',
+      '- Section: ## New Section [section]',
       '',
-      'Use ---TOOL:pptx_slides:## Slide 1\n- Point 1\n- Point 2\n\n## Slide 2\n- Point 3--- to generate the actual file.',
-      'Theme options after pipe: dark, light, blue, green, corporate, red',
-      'Example: ---TOOL:pptx_slides:title|theme|## Slide 1\n- point---');
+      'Example:',
+      '---TOOL:pptx_slides:AI Report|dark|## Introduction\n- AI is transforming industries\n- Revenue growing 40% YoY\n\n## Growth [chart:bar]\n- 2020: 50\n- 2021: 80\n- 2022: 120\n- 2023: 200\n\n## Key Stats [stats]\n- 🌍 195 — Countries using AI\n- 💰 $500B — Market size\n- 🚀 40% — Annual growth---');
+
+    tools.push('', '### Create Excel Spreadsheet (SENDS AS FILE!)',
+      '---TOOL:excel:Title|theme|sheet content---',
+      'Creates .xlsx file and sends it. Theme: blue, green, dark, red, saudi, corporate.',
+      'Content: use | for columns. First row = headers. Separate sheets with ### SheetName.',
+      'Example: ---TOOL:excel:Sales Report|blue|Product|Revenue|Growth\nWidget A|50000|12%\nWidget B|80000|25%---',
+      '', '### Create PDF Document (SENDS AS FILE!)',
+      '---TOOL:pdf:Title|content in markdown---',
+      'Creates .pdf file and sends it. Use ## for headings, - for bullets, > for quotes, --- for dividers.',
+      'Example: ---TOOL:pdf:Meeting Notes|## Summary\n- Discussed Q1 results\n- Action items assigned---',
+      '', '### Create HTML Page (SENDS AS FILE!)',
+      '---TOOL:html:Title|theme|content in markdown---',
+      'Creates .html file and sends it. Themes: light, dark, ocean.',
+      'Example: ---TOOL:html:Report|dark|## Overview\n- Key findings\n- Recommendations---');
+
+    tools.push('', '### Schedule Cron Job',
+      '---TOOL:cron_add:name|schedule|action|data---',
+      'Create a recurring scheduled job. Schedule formats:',
+      '- every:5m / every:1h / every:24h (interval)',
+      '- daily:09:00 (every day at time UTC)',
+      '- weekly:fri:09:00 (every week on day)',
+      '- monthly:1:09:00 (every month on date)',
+      'Actions: message (send text), briefing (daily brief), remind (reminder), ai (run AI prompt)',
+      'Example: ---TOOL:cron_add:Morning Briefing|daily:06:00|briefing|---',
+      'Example: ---TOOL:cron_add:Weekly Report Reminder|weekly:fri:09:00|remind|Submit the weekly report!---',
+      '', '### List Cron Jobs',
+      '---TOOL:cron_list:all---',
+      'Show all scheduled jobs.',
+      '', '### Remove Cron Job',
+      '---TOOL:cron_remove:job_id---',
+      'Remove a scheduled job by ID.');
 
     tools.push('', '### Allow User',
       '---TOOL:allow:user_id_or_phone---',
@@ -181,9 +218,16 @@ export class ToolRouter {
       'You already have vision — use it to read text from screenshots, documents, signs, etc.');
 
     tools.push('', '### Set Reminder',
-      '---TOOL:remind:YYYY-MM-DDTHH:MM|Your reminder message---',
-      'Set a reminder to message the user at a specific time. Time must be in UTC.',
-      'Example: ---TOOL:remind:2026-03-03T08:30|Wake up! Time to start the day!---',
+      '---TOOL:remind:TIME|Your reminder message---',
+      'Set a reminder. TIME can be:',
+      '- Relative: 5m, 30m, 1h, 2h, 1d (minutes, hours, days from now)',
+      '- Absolute: 2026-03-03T08:30 (UTC)',
+      '- Natural: tomorrow, tonight',
+      'Examples:',
+      '- ---TOOL:remind:30m|Check the oven!---',
+      '- ---TOOL:remind:2h|Call Ahmed---',
+      '- ---TOOL:remind:2026-03-03T15:00|Meeting time!---',
+      'ALWAYS use this tool when user says "remind me". Do NOT just acknowledge — actually set it.',
       'The user will receive a proactive message at that time even if they are not chatting.');
 
     tools.push('', '**Important:** Use tools when needed. The tool result will be injected into the conversation automatically. Only use one tool per response.');
@@ -202,7 +246,7 @@ export class ToolRouter {
   }
 
   async processResponse(response, agentId) {
-    const toolMatch = response.match(/---TOOL:(\w+):(.+?)---/);
+    const toolMatch = response.match(/---TOOL:(\w+):([\s\S]+?)---/);
     if (!toolMatch) return { toolUsed: false, toolResult: null, cleanResponse: response };
 
     const [fullMatch, toolName, toolArg] = toolMatch;
@@ -223,12 +267,31 @@ export class ToolRouter {
           try {
             const pipeIdx = toolArg.indexOf('|');
             if (pipeIdx === -1) {
-              toolResult = 'Invalid reminder format. Use: YYYY-MM-DDTHH:MM|message';
+              toolResult = 'Format: time|message. Example: 30m|Check oven';
               break;
             }
-            const timeStr = toolArg.slice(0, pipeIdx).trim();
+            let timeStr = toolArg.slice(0, pipeIdx).trim();
             const msg = toolArg.slice(pipeIdx + 1).trim();
-            // Store reminder request in result for engine to pick up
+            
+            // Parse relative times
+            const relMatch = timeStr.match(/^(\d+)\s*(m|min|minutes?|h|hr|hours?|d|days?)$/i);
+            if (relMatch) {
+              const num = parseInt(relMatch[1]);
+              const unit = relMatch[2][0].toLowerCase();
+              const ms = unit === 'm' ? num * 60000 : unit === 'h' ? num * 3600000 : num * 86400000;
+              const fireDate = new Date(Date.now() + ms);
+              timeStr = fireDate.toISOString().slice(0, 16);
+            } else if (timeStr.toLowerCase() === 'tomorrow') {
+              const d = new Date(Date.now() + 86400000);
+              d.setUTCHours(9, 0, 0, 0);
+              timeStr = d.toISOString().slice(0, 16);
+            } else if (timeStr.toLowerCase() === 'tonight') {
+              const d = new Date();
+              d.setUTCHours(18, 0, 0, 0);
+              if (d < new Date()) d.setDate(d.getDate() + 1);
+              timeStr = d.toISOString().slice(0, 16);
+            }
+            
             return { toolUsed: true, toolName: 'remind', reminderTime: timeStr, reminderMessage: msg, cleanResponse };
           } catch (err) {
             toolResult = 'Failed to set reminder: ' + err.message;
@@ -285,6 +348,86 @@ export class ToolRouter {
           }
           break;
         }
+        case 'excel':
+        case 'xlsx':
+        case 'spreadsheet': {
+          try {
+            const { ExcelGenerator } = await import('./excel.js');
+            const gen = new ExcelGenerator();
+            const parts = toolArg.split('|');
+            let title, themeName, sheetContent;
+            if (parts.length >= 3) {
+              title = parts[0].trim();
+              themeName = parts[1].trim();
+              sheetContent = parts.slice(2).join('|');
+            } else {
+              title = parts[0]?.trim() || 'Spreadsheet';
+              sheetContent = parts.slice(1).join('|');
+              themeName = 'corporate';
+            }
+            const sheets = ExcelGenerator.parseContent(sheetContent);
+            const result = await gen.create(title, sheets, { theme: themeName });
+            return { toolUsed: true, toolName: 'excel', toolResult: 'Excel created: ' + result.filename, filePath: result.filepath, fileName: result.filename, cleanResponse };
+          } catch (err) { toolResult = 'Excel failed: ' + err.message; }
+          break;
+        }
+        case 'pdf':
+        case 'document': {
+          try {
+            const { PdfGenerator } = await import('./pdf.js');
+            const gen = new PdfGenerator();
+            const pipeIdx = toolArg.indexOf('|');
+            const title = pipeIdx > -1 ? toolArg.slice(0, pipeIdx).trim() : 'Document';
+            const content = pipeIdx > -1 ? toolArg.slice(pipeIdx + 1) : toolArg;
+            const result = await gen.create(title, content);
+            return { toolUsed: true, toolName: 'pdf', toolResult: 'PDF created: ' + result.filename, filePath: result.filepath, fileName: result.filename, cleanResponse };
+          } catch (err) { toolResult = 'PDF failed: ' + err.message; }
+          break;
+        }
+        case 'html':
+        case 'webpage': {
+          try {
+            const { HtmlGenerator } = await import('./html.js');
+            const gen = new HtmlGenerator();
+            const parts = toolArg.split('|');
+            const title = parts[0]?.trim() || 'Page';
+            const themeName = parts.length >= 3 ? parts[1].trim() : 'light';
+            const content = parts.length >= 3 ? parts.slice(2).join('|') : parts.slice(1).join('|');
+            const result = gen.create(title, content, { theme: themeName });
+            return { toolUsed: true, toolName: 'html', toolResult: 'HTML created: ' + result.filename, filePath: result.filepath, fileName: result.filename, cleanResponse };
+          } catch (err) { toolResult = 'HTML failed: ' + err.message; }
+          break;
+        }
+        case 'cron_add': {
+          try {
+            if (!this._engine?.cron) { toolResult = 'Cron not available'; break; }
+            const parts = toolArg.split('|').map(p => p.trim());
+            const [name, schedule, action, ...dataParts] = parts;
+            const data = dataParts.join('|');
+            const result = this._engine.cron.add(agentId, this._currentContactId, name, schedule, action || 'message', data, this._currentPlatform);
+            toolResult = 'Cron job created! ✅\n📋 ' + result.name + '\n⏰ Schedule: ' + result.schedule + '\n🔜 Next run: ' + result.nextRun;
+          } catch (err) { toolResult = 'Failed: ' + err.message; }
+          break;
+        }
+        case 'cron_list': {
+          try {
+            if (!this._engine?.cron) { toolResult = 'Cron not available'; break; }
+            const jobs = this._engine.cron.listAll(agentId);
+            if (jobs.length === 0) { toolResult = 'No scheduled jobs'; break; }
+            toolResult = jobs.map(j => 
+              (j.enabled ? '✅' : '⏸️') + ' ' + j.name + ' (' + j.schedule + ')\n   ID: ' + j.id + '\n   Next: ' + (j.next_run || 'N/A')
+            ).join('\n\n');
+          } catch (err) { toolResult = 'Failed: ' + err.message; }
+          break;
+        }
+        case 'cron_remove': {
+          try {
+            if (!this._engine?.cron) { toolResult = 'Cron not available'; break; }
+            this._engine.cron.remove(toolArg.trim());
+            toolResult = 'Cron job removed ✅';
+          } catch (err) { toolResult = 'Failed: ' + err.message; }
+          break;
+        }
         case 'allow': {
           try {
             const { AllowlistManager } = await import('../features/allowlist-manager.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squidclaw",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "🦑 AI agent platform — human-like agents for WhatsApp, Telegram & more",
   "main": "lib/engine.js",
   "bin": {
@@ -42,12 +42,14 @@
     "commander": "^14.0.3",
     "croner": "^10.0.1",
     "dotenv": "^17.3.1",
+    "exceljs": "^4.4.0",
     "express": "^5.2.1",
     "file-type": "^21.3.0",
     "grammy": "^1.40.1",
     "linkedom": "^0.18.12",
     "node-edge-tts": "^1.2.10",
     "pdfjs-dist": "^5.4.624",
+    "pdfkit": "^0.17.2",
     "pino": "^10.3.1",
     "pptxgenjs": "^4.0.1",
     "puppeteer-core": "^24.37.5",