@compass-ai/nova 1.0.72 → 1.0.74

package/dist/constants/schedule.js

@@ -0,0 +1,110 @@
+/**
+ * Constants for the scheduled task system.
+ *
+ * Defines file names, default values, cron presets, and the default
+ * Schedule.md header template.
+ */
+// =============================================================================
+// File and ID Constants
+// =============================================================================
+/**
+ * Name of the schedule file within the project's .compass directory.
+ */
+export const SCHEDULE_FILE_NAME = 'Schedule.md';
+/**
+ * Prefix for generated task IDs.
+ */
+export const TASK_ID_PREFIX = 'sched-';
+/**
+ * Length of the random suffix in task IDs (after the prefix).
+ */
+export const TASK_ID_RANDOM_LENGTH = 8;
+// =============================================================================
+// Status Values
+// =============================================================================
+/**
+ * All valid task statuses.
+ */
+export const TASK_STATUSES = ['active', 'paused', 'completed'];
+// =============================================================================
+// Default Schedule.md Header
+// =============================================================================
+/**
+ * Default markdown header written to a new Schedule.md file.
+ */
+export const DEFAULT_SCHEDULE_HEADER = `# Scheduled Tasks
+
+> Managed by Nova. Each task below runs on a cron schedule.
+> Edit manually or use the schedule tools to manage tasks.
+`;
+// =============================================================================
+// Cron Presets
+// =============================================================================
+/**
+ * Common natural-language schedule presets mapped to 5-field cron expressions.
+ * Keys are lowercase for case-insensitive matching.
+ */
+export const CRON_PRESETS = {
+    'every minute': { cron: '* * * * *', description: 'Every minute' },
+    'minutely': { cron: '* * * * *', description: 'Every minute' },
+    'every 5 minutes': { cron: '*/5 * * * *', description: 'Every 5 minutes' },
+    'every 10 minutes': { cron: '*/10 * * * *', description: 'Every 10 minutes' },
+    'every 15 minutes': { cron: '*/15 * * * *', description: 'Every 15 minutes' },
+    'every 30 minutes': { cron: '*/30 * * * *', description: 'Every 30 minutes' },
+    'every hour': { cron: '0 * * * *', description: 'Every hour' },
+    'hourly': { cron: '0 * * * *', description: 'Every hour' },
+    'every day': { cron: '0 9 * * *', description: 'Every day at 9:00 AM' },
+    'daily': { cron: '0 9 * * *', description: 'Every day at 9:00 AM' },
+    'every morning': { cron: '0 9 * * *', description: 'Every day at 9:00 AM' },
+    'every night': { cron: '0 21 * * *', description: 'Every day at 9:00 PM' },
+    'every weekday': { cron: '0 9 * * 1-5', description: 'Every weekday at 9:00 AM' },
+    'weekdays': { cron: '0 9 * * 1-5', description: 'Every weekday at 9:00 AM' },
+    'every weekend': { cron: '0 9 * * 0,6', description: 'Every weekend at 9:00 AM' },
+    'weekends': { cron: '0 9 * * 0,6', description: 'Every weekend at 9:00 AM' },
+    'every week': { cron: '0 9 * * 1', description: 'Every Monday at 9:00 AM' },
+    'weekly': { cron: '0 9 * * 1', description: 'Every Monday at 9:00 AM' },
+    'every monday': { cron: '0 9 * * 1', description: 'Every Monday at 9:00 AM' },
+    'every tuesday': { cron: '0 9 * * 2', description: 'Every Tuesday at 9:00 AM' },
+    'every wednesday': { cron: '0 9 * * 3', description: 'Every Wednesday at 9:00 AM' },
+    'every thursday': { cron: '0 9 * * 4', description: 'Every Thursday at 9:00 AM' },
+    'every friday': { cron: '0 9 * * 5', description: 'Every Friday at 9:00 AM' },
+    'every saturday': { cron: '0 9 * * 6', description: 'Every Saturday at 9:00 AM' },
+    'every sunday': { cron: '0 9 * * 0', description: 'Every Sunday at 9:00 AM' },
+    'every month': { cron: '0 9 1 * *', description: 'First day of every month at 9:00 AM' },
+    'monthly': { cron: '0 9 1 * *', description: 'First day of every month at 9:00 AM' },
+    'every year': { cron: '0 9 1 1 *', description: 'January 1st at 9:00 AM' },
+    'yearly': { cron: '0 9 1 1 *', description: 'January 1st at 9:00 AM' },
+    'annually': { cron: '0 9 1 1 *', description: 'January 1st at 9:00 AM' },
+};
+/**
+ * Day name to cron day-of-week number mapping.
+ */
+export const DAY_NAME_TO_CRON = {
+    'sunday': 0,
+    'sun': 0,
+    'monday': 1,
+    'mon': 1,
+    'tuesday': 2,
+    'tue': 2,
+    'wednesday': 3,
+    'wed': 3,
+    'thursday': 4,
+    'thu': 4,
+    'friday': 5,
+    'fri': 5,
+    'saturday': 6,
+    'sat': 6,
+};
+/**
+ * Cron day-of-week number to day name mapping.
+ */
+export const CRON_DAY_NAMES = {
+    0: 'Sunday',
+    1: 'Monday',
+    2: 'Tuesday',
+    3: 'Wednesday',
+    4: 'Thursday',
+    5: 'Friday',
+    6: 'Saturday',
+};
+//# sourceMappingURL=schedule.js.map

package/dist/constants/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/constants/schedule.ts"],"names":[],"mappings":"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"}

package/dist/constants/system-utilities.d.ts

@@ -0,0 +1,57 @@
+/**
+ * System utility registry for unguarded mode.
+ *
+ * Defines ~30 system utilities across 7 categories that the LLM can use
+ * via the execute tool when detected on the system.
+ *
+ * Purpose: Inform the LLM which system utilities are available for direct
+ * execution, enabling it to run commands like `curl`, `ffmpeg`, `jq` instead
+ * of suggesting web searches or manual installations.
+ */
+/**
+ * Categories for system utilities
+ */
+export type UtilityCategory = 'network' | 'media' | 'development' | 'compression' | 'text' | 'file' | 'system';
+/**
+ * Definition for a system utility
+ */
+export interface UtilityDefinition {
+    /** Command to detect (e.g., 'curl', 'ffmpeg') */
+    command: string;
+    /** Display name */
+    name: string;
+    /** Category for grouping */
+    category: UtilityCategory;
+    /** Brief description of what the utility does */
+    description: string;
+    /** When to use this tool vs web search */
+    decisionRule: string;
+    /** Example use cases */
+    useCases: string[];
+}
+/**
+ * Category metadata for display and priority ordering
+ */
+export declare const CATEGORY_INFO: Record<UtilityCategory, {
+    label: string;
+    priority: number;
+}>;
+/**
+ * Cache TTL for utility detection results (1 hour)
+ */
+export declare const UTILITY_DETECTION_CACHE_TTL = 3600000;
+/**
+ * Detection timeout in milliseconds.
+ * Set to 3 seconds to allow `where` commands on Windows to complete.
+ * Results are cached for 1 hour, so initial detection latency is acceptable.
+ */
+export declare const UTILITY_DETECTION_TIMEOUT = 3000;
+/**
+ * Registry of system utilities to detect
+ */
+export declare const SYSTEM_UTILITIES: UtilityDefinition[];
+/**
+ * Gets utilities grouped by category
+ */
+export declare function getUtilitiesByCategory(): Map<UtilityCategory, UtilityDefinition[]>;
+//# sourceMappingURL=system-utilities.d.ts.map

package/dist/constants/system-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-utilities.d.ts","sourceRoot":"","sources":["../../src/constants/system-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/G;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,eAAe,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,UAAU,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EA0X/C,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAC,CAUlF"}

package/dist/constants/system-utilities.js

@@ -0,0 +1,421 @@
+/**
+ * System utility registry for unguarded mode.
+ *
+ * Defines ~30 system utilities across 7 categories that the LLM can use
+ * via the execute tool when detected on the system.
+ *
+ * Purpose: Inform the LLM which system utilities are available for direct
+ * execution, enabling it to run commands like `curl`, `ffmpeg`, `jq` instead
+ * of suggesting web searches or manual installations.
+ */
+/**
+ * Category metadata for display and priority ordering
+ */
+export const CATEGORY_INFO = {
+    network: { label: 'Network Tools', priority: 1 },
+    media: { label: 'Media Tools', priority: 2 },
+    development: { label: 'Development Tools', priority: 3 },
+    compression: { label: 'Compression Tools', priority: 4 },
+    text: { label: 'Text Processing Tools', priority: 5 },
+    file: { label: 'File Tools', priority: 6 },
+    system: { label: 'System Tools', priority: 7 },
+};
+/**
+ * Cache TTL for utility detection results (1 hour)
+ */
+export const UTILITY_DETECTION_CACHE_TTL = 3600000;
+/**
+ * Detection timeout in milliseconds.
+ * Set to 3 seconds to allow `where` commands on Windows to complete.
+ * Results are cached for 1 hour, so initial detection latency is acceptable.
+ */
+export const UTILITY_DETECTION_TIMEOUT = 3000;
+/**
+ * Registry of system utilities to detect
+ */
+export const SYSTEM_UTILITIES = [
+    // ==================== Network Tools ====================
+    {
+        command: 'curl',
+        name: 'cURL',
+        category: 'network',
+        description: 'Transfer data with URLs',
+        decisionRule: 'Use for downloading files, making HTTP requests, testing APIs',
+        useCases: [
+            'curl -O https://example.com/file.zip',
+            'curl -X POST -d "data" https://api.example.com',
+            'curl -I https://example.com (headers only)',
+        ],
+    },
+    {
+        command: 'wget',
+        name: 'wget',
+        category: 'network',
+        description: 'Non-interactive network downloader',
+        decisionRule: 'Use for downloading files, especially recursive downloads',
+        useCases: [
+            'wget https://example.com/file.zip',
+            'wget -r https://example.com/docs/',
+            'wget -c https://example.com/large.zip (resume)',
+        ],
+    },
+    {
+        command: 'ssh',
+        name: 'SSH',
+        category: 'network',
+        description: 'Secure shell remote login',
+        decisionRule: 'Use for remote server access and secure connections',
+        useCases: [
+            'ssh user@host',
+            'ssh -L 8080:localhost:80 user@host (tunnel)',
+        ],
+    },
+    {
+        command: 'ping',
+        name: 'Ping',
+        category: 'network',
+        description: 'Test network connectivity',
+        decisionRule: 'Use to check if a host is reachable',
+        useCases: [
+            'ping example.com',
+            'ping -c 4 example.com (4 packets)',
+        ],
+    },
+    {
+        command: 'nslookup',
+        name: 'nslookup',
+        category: 'network',
+        description: 'Query DNS records',
+        decisionRule: 'Use for DNS lookups and troubleshooting',
+        useCases: [
+            'nslookup example.com',
+            'nslookup -type=MX example.com',
+        ],
+    },
+    {
+        command: 'dig',
+        name: 'dig',
+        category: 'network',
+        description: 'DNS lookup utility',
+        decisionRule: 'Use for detailed DNS queries',
+        useCases: [
+            'dig example.com',
+            'dig +short example.com',
+            'dig example.com MX',
+        ],
+    },
+    {
+        command: 'netstat',
+        name: 'netstat',
+        category: 'network',
+        description: 'Network statistics',
+        decisionRule: 'Use to view network connections and listening ports',
+        useCases: [
+            'netstat -an (all connections)',
+            'netstat -tlnp (listening TCP ports)',
+        ],
+    },
+    // ==================== Media Tools ====================
+    {
+        command: 'ffmpeg',
+        name: 'FFmpeg',
+        category: 'media',
+        description: 'Audio/video conversion and processing',
+        decisionRule: 'Use for any audio/video conversion, extraction, or manipulation',
+        useCases: [
+            'ffmpeg -i input.mp4 output.mp3 (extract audio)',
+            'ffmpeg -i input.mp4 -vn -acodec copy output.aac',
+            'ffmpeg -i input.mp4 -ss 00:01:00 -t 30 clip.mp4 (trim)',
+        ],
+    },
+    {
+        command: 'convert',
+        name: 'ImageMagick',
+        category: 'media',
+        description: 'Image conversion and manipulation',
+        decisionRule: 'Use for image format conversion, resizing, effects',
+        useCases: [
+            'convert input.png output.jpg',
+            'convert input.png -resize 50% output.png',
+            'convert *.png output.pdf (combine to PDF)',
+        ],
+    },
+    {
+        command: 'yt-dlp',
+        name: 'yt-dlp',
+        category: 'media',
+        description: 'Video/audio downloader',
+        decisionRule: 'Use for downloading videos from YouTube and other sites',
+        useCases: [
+            'yt-dlp https://youtube.com/watch?v=...',
+            'yt-dlp -x --audio-format mp3 URL (audio only)',
+        ],
+    },
+    // ==================== Development Tools ====================
+    {
+        command: 'git',
+        name: 'Git',
+        category: 'development',
+        description: 'Version control system',
+        decisionRule: 'Use for all version control operations',
+        useCases: [
+            'git status',
+            'git diff',
+            'git log --oneline -10',
+        ],
+    },
+    {
+        command: 'node',
+        name: 'Node.js',
+        category: 'development',
+        description: 'JavaScript runtime',
+        decisionRule: 'Use for running JavaScript files or REPL',
+        useCases: [
+            'node script.js',
+            'node -e "console.log(1+1)"',
+        ],
+    },
+    {
+        command: 'npm',
+        name: 'npm',
+        category: 'development',
+        description: 'Node.js package manager',
+        decisionRule: 'Use for JavaScript package management',
+        useCases: [
+            'npm install package',
+            'npm run script',
+            'npm init -y',
+        ],
+    },
+    {
+        command: 'python',
+        name: 'Python',
+        category: 'development',
+        description: 'Python interpreter',
+        decisionRule: 'Use for running Python scripts or quick computations',
+        useCases: [
+            'python script.py',
+            'python -c "print(2**10)"',
+        ],
+    },
+    {
+        command: 'pip',
+        name: 'pip',
+        category: 'development',
+        description: 'Python package manager',
+        decisionRule: 'Use for Python package installation',
+        useCases: [
+            'pip install package',
+            'pip list',
+            'pip freeze > requirements.txt',
+        ],
+    },
+    {
+        command: 'docker',
+        name: 'Docker',
+        category: 'development',
+        description: 'Container platform',
+        decisionRule: 'Use for container operations',
+        useCases: [
+            'docker ps',
+            'docker run -it ubuntu bash',
+            'docker build -t myapp .',
+        ],
+    },
+    {
+        command: 'code',
+        name: 'VS Code',
+        category: 'development',
+        description: 'Visual Studio Code editor',
+        decisionRule: 'Use to open files/folders in VS Code',
+        useCases: [
+            'code .',
+            'code file.js',
+        ],
+    },
+    {
+        command: 'jq',
+        name: 'jq',
+        category: 'development',
+        description: 'JSON processor',
+        decisionRule: 'Use for parsing, filtering, and transforming JSON',
+        useCases: [
+            "cat data.json | jq '.field'",
+            "jq '.items[] | .name' data.json",
+            "curl api.example.com | jq '.'",
+        ],
+    },
+    // ==================== Compression Tools ====================
+    {
+        command: '7z',
+        name: '7-Zip',
+        category: 'compression',
+        description: 'High compression archiver',
+        decisionRule: 'Use for creating/extracting archives, especially 7z format',
+        useCases: [
+            '7z x archive.7z',
+            '7z a archive.7z folder/',
+        ],
+    },
+    {
+        command: 'tar',
+        name: 'tar',
+        category: 'compression',
+        description: 'Archive utility',
+        decisionRule: 'Use for tar archives, common on Unix systems',
+        useCases: [
+            'tar -xzf archive.tar.gz',
+            'tar -czf archive.tar.gz folder/',
+            'tar -tvf archive.tar (list contents)',
+        ],
+    },
+    {
+        command: 'zip',
+        name: 'zip',
+        category: 'compression',
+        description: 'Compress files into ZIP format',
+        decisionRule: 'Use for creating ZIP archives',
+        useCases: [
+            'zip archive.zip file1 file2',
+            'zip -r archive.zip folder/',
+        ],
+    },
+    {
+        command: 'unzip',
+        name: 'unzip',
+        category: 'compression',
+        description: 'Extract ZIP archives',
+        decisionRule: 'Use for extracting ZIP files',
+        useCases: [
+            'unzip archive.zip',
+            'unzip -l archive.zip (list contents)',
+            'unzip archive.zip -d destination/',
+        ],
+    },
+    {
+        command: 'gzip',
+        name: 'gzip',
+        category: 'compression',
+        description: 'GNU compression utility',
+        decisionRule: 'Use for gzip compression/decompression',
+        useCases: [
+            'gzip file',
+            'gzip -d file.gz',
+            'gzip -k file (keep original)',
+        ],
+    },
+    // ==================== Text Processing Tools ====================
+    {
+        command: 'grep',
+        name: 'grep',
+        category: 'text',
+        description: 'Search text patterns',
+        decisionRule: 'Use for searching patterns in files',
+        useCases: [
+            'grep "pattern" file',
+            'grep -r "pattern" folder/',
+            'grep -i "pattern" file (case insensitive)',
+        ],
+    },
+    {
+        command: 'sed',
+        name: 'sed',
+        category: 'text',
+        description: 'Stream editor',
+        decisionRule: 'Use for text transformations and substitutions',
+        useCases: [
+            "sed 's/old/new/g' file",
+            "sed -i 's/old/new/g' file (in-place)",
+        ],
+    },
+    {
+        command: 'awk',
+        name: 'awk',
+        category: 'text',
+        description: 'Pattern scanning and processing',
+        decisionRule: 'Use for column-based text processing',
+        useCases: [
+            "awk '{print $1}' file",
+            "awk -F: '{print $1}' /etc/passwd",
+        ],
+    },
+    // ==================== File Tools ====================
+    {
+        command: 'find',
+        name: 'find',
+        category: 'file',
+        description: 'Search for files',
+        decisionRule: 'Use for finding files by name, type, date, etc.',
+        useCases: [
+            'find . -name "*.js"',
+            'find . -type f -mtime -7 (modified last 7 days)',
+        ],
+    },
+    {
+        command: 'rsync',
+        name: 'rsync',
+        category: 'file',
+        description: 'Fast file synchronization',
+        decisionRule: 'Use for copying/syncing files with progress and resume',
+        useCases: [
+            'rsync -av source/ dest/',
+            'rsync -avz source/ user@host:dest/',
+        ],
+    },
+    // ==================== System Tools ====================
+    {
+        command: 'pandoc',
+        name: 'Pandoc',
+        category: 'system',
+        description: 'Universal document converter',
+        decisionRule: 'Use for converting between document formats',
+        useCases: [
+            'pandoc input.md -o output.pdf',
+            'pandoc input.docx -o output.html',
+        ],
+    },
+    {
+        command: 'htop',
+        name: 'htop',
+        category: 'system',
+        description: 'Interactive process viewer',
+        decisionRule: 'Use for monitoring system resources',
+        useCases: [
+            'htop',
+        ],
+    },
+    {
+        command: 'btop',
+        name: 'btop',
+        category: 'system',
+        description: 'Resource monitor',
+        decisionRule: 'Use for monitoring system resources with better UI',
+        useCases: [
+            'btop',
+        ],
+    },
+    {
+        command: 'lsof',
+        name: 'lsof',
+        category: 'system',
+        description: 'List open files',
+        decisionRule: 'Use to find which process is using a file or port',
+        useCases: [
+            'lsof -i :8080 (what is using port 8080)',
+            'lsof /path/to/file',
+        ],
+    },
+];
+/**
+ * Gets utilities grouped by category
+ */
+export function getUtilitiesByCategory() {
+    const grouped = new Map();
+    for (const utility of SYSTEM_UTILITIES) {
+        const existing = grouped.get(utility.category) || [];
+        existing.push(utility);
+        grouped.set(utility.category, existing);
+    }
+    return grouped;
+}
+//# sourceMappingURL=system-utilities.js.map

package/dist/constants/system-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-utilities.js","sourceRoot":"","sources":["../../src/constants/system-utilities.ts"],"names":[],"mappings":"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"}