@compass-ai/nova 1.0.73 → 1.0.74

package/dist/tools/openai-tools.js

@@ -0,0 +1,385 @@
+/**
+ * OpenAI-based tools for audio transcription and image analysis.
+ *
+ * These tools use the OpenAI API (Whisper and Vision) with API keys
+ * retrieved from Compass via getLLMConfig().
+ */
+import { ActionType } from '../services/action-logger.js';
+import { getCredentialStore } from '../services/credential-store.js';
+import { getCompassAuthService } from '../services/compass-auth-service.js';
+import { decryptFernet } from '../utils/crypto.js';
+import { pathExists } from '../utils/file-system.js';
+import { logger } from '../utils/logger.js';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * OpenAI API base URL
+ */
+const OPENAI_API_BASE_URL = 'https://api.openai.com/v1';
+/**
+ * Maximum audio file size for transcription (25MB - OpenAI limit)
+ */
+const MAX_AUDIO_SIZE_BYTES = 25 * 1024 * 1024;
+/**
+ * Maximum image file size for vision (20MB limit)
+ */
+const MAX_IMAGE_SIZE_BYTES = 20 * 1024 * 1024;
+/**
+ * Supported audio formats for Whisper
+ */
+const SUPPORTED_AUDIO_FORMATS = [
+    '.mp3', '.mp4', '.mpeg', '.mpga', '.m4a', '.wav', '.webm', '.flac', '.ogg'
+];
+/**
+ * Supported image formats for Vision
+ */
+const SUPPORTED_IMAGE_FORMATS = ['.png', '.jpg', '.jpeg', '.gif', '.webp'];
+/**
+ * Decryption password for OpenAI keys from Compass
+ */
+const OPENAI_DECRYPT_PASSWORD = 'OPENAI';
+/**
+ * Retrieves the OpenAI API key from Compass.
+ * Fetches the encrypted key and decrypts it.
+ *
+ * @returns The decrypted OpenAI API key
+ * @throws Error if key cannot be retrieved or decrypted
+ */
+async function getOpenAIApiKey() {
+    const credentialStore = await getCredentialStore();
+    const compassApiKey = await credentialStore.getCompassApiKey();
+    if (!compassApiKey) {
+        throw new Error('Compass API key not configured. Please run setup to configure your Compass API key.');
+    }
+    const compassAuthService = getCompassAuthService();
+    try {
+        // Fetch LLM config for GPT-5 (or gpt-4 as fallback model identifier)
+        const llmConfig = await compassAuthService.getLLMConfig('gpt-5', compassApiKey);
+        if (!llmConfig.api_key) {
+            throw new Error('OpenAI API key not found in Compass configuration. ' +
+                'Please ensure your organization has configured an OpenAI API key.');
+        }
+        // Decrypt the API key
+        const decryptedKey = decryptFernet(llmConfig.api_key, OPENAI_DECRYPT_PASSWORD);
+        if (!decryptedKey || !decryptedKey.startsWith('sk-')) {
+            throw new Error('Failed to decrypt OpenAI API key or invalid key format.');
+        }
+        return decryptedKey;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            logger.error('Failed to retrieve OpenAI API key', error);
+            throw error;
+        }
+        throw new Error('Failed to retrieve OpenAI API key: Unknown error');
+    }
+}
+/**
+ * Formats file size in human-readable format
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+/**
+ * Registers OpenAI tools if Compass API key is configured.
+ * These tools require a Compass API key to fetch the OpenAI API key.
+ *
+ * @param registry - The tool registry to register tools with
+ * @returns Promise that resolves when registration is complete
+ */
+export async function registerOpenAITools(registry) {
+    // Check if Compass API key is configured
+    const credentialStore = await getCredentialStore();
+    const hasCompassKey = await credentialStore.hasCompassApiKey();
+    if (!hasCompassKey) {
+        logger.debug('Skipping OpenAI tools registration: Compass API key not configured');
+        return;
+    }
+    logger.debug('Registering OpenAI tools (Compass API key found)');
+    /**
+     * Audio Transcription Tool using OpenAI Whisper
+     */
+    registry.registerTool('transcribe_audio', `Transcribes audio files to text.
+
+Supported formats: ${SUPPORTED_AUDIO_FORMATS.join(', ')}
+Maximum file size: ${formatBytes(MAX_AUDIO_SIZE_BYTES)}
+
+Use this tool when you need to:
+- Convert speech in audio/video files to text
+- Transcribe meeting recordings, podcasts, or voice notes
+- Extract spoken content from media files
+
+The tool returns the transcribed text and metadata about the transcription.`, {
+        type: 'object',
+        properties: {
+            file_path: {
+                type: 'string',
+                description: 'Path to the audio file to transcribe (relative or absolute)',
+            },
+            language: {
+                type: 'string',
+                description: 'Language code (ISO 639-1) of the audio. Optional - Whisper auto-detects if not provided. Examples: en, pt, es, fr, de',
+            },
+            prompt: {
+                type: 'string',
+                description: 'Optional prompt to guide the transcription style. Can include proper nouns, technical terms, or context.',
+            },
+            response_format: {
+                type: 'string',
+                description: 'Output format: json, text, srt, verbose_json, vtt. Defaults to text.',
+                enum: ['json', 'text', 'srt', 'verbose_json', 'vtt'],
+            },
+        },
+        required: ['file_path'],
+    }, async (input, context) => {
+        const { file_path, language, prompt, response_format = 'text', } = input;
+        // 1. Resolve and validate file path
+        const filePath = path.isAbsolute(file_path)
+            ? file_path
+            : path.resolve(context.projectRoot, file_path);
+        const exists = await pathExists(filePath);
+        if (!exists) {
+            throw new Error(`Audio file not found: ${file_path}`);
+        }
+        // 2. Validate file format
+        const ext = path.extname(filePath).toLowerCase();
+        if (!SUPPORTED_AUDIO_FORMATS.includes(ext)) {
+            throw new Error(`Unsupported audio format: ${ext}. Supported formats: ${SUPPORTED_AUDIO_FORMATS.join(', ')}`);
+        }
+        // 3. Check file size
+        const stats = await fs.stat(filePath);
+        if (stats.size > MAX_AUDIO_SIZE_BYTES) {
+            throw new Error(`Audio file too large: ${formatBytes(stats.size)}. Maximum size: ${formatBytes(MAX_AUDIO_SIZE_BYTES)}`);
+        }
+        // 4. Get OpenAI API key
+        const apiKey = await getOpenAIApiKey();
+        // 5. Read the audio file
+        const audioBuffer = await fs.readFile(filePath);
+        const fileName = path.basename(filePath);
+        // 6. Create form data for the API request
+        const formData = new FormData();
+        formData.append('file', new Blob([audioBuffer]), fileName);
+        formData.append('model', 'whisper-1');
+        formData.append('response_format', response_format);
+        if (language) {
+            formData.append('language', language);
+        }
+        if (prompt) {
+            formData.append('prompt', prompt);
+        }
+        // 7. Call OpenAI Whisper API
+        logger.info(`Transcribing audio file: ${fileName}`);
+        const response = await fetch(`${OPENAI_API_BASE_URL}/audio/transcriptions`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: formData,
+        });
+        if (!response.ok) {
+            let errorMessage = `Transcription failed with status ${response.status}`;
+            try {
+                const errorData = await response.json();
+                if (errorData.error?.message) {
+                    errorMessage = errorData.error.message;
+                }
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+            throw new Error(errorMessage);
+        }
+        // 8. Parse response based on format
+        let transcription;
+        if (response_format === 'json' || response_format === 'verbose_json') {
+            transcription = await response.json();
+        }
+        else {
+            transcription = await response.text();
+        }
+        logger.info(`Successfully transcribed: ${fileName}`);
+        return {
+            success: true,
+            file: file_path,
+            fileName,
+            fileSize: stats.size,
+            fileSizeFormatted: formatBytes(stats.size),
+            format: ext,
+            responseFormat: response_format,
+            language: language || 'auto-detected',
+            transcription,
+        };
+    }, {
+        actionType: ActionType.CODE_ANALYSIS,
+        requiresApproval: false,
+        category: 'ai_operations',
+        tags: ['openai', 'whisper', 'transcription', 'audio', 'speech-to-text'],
+        displayName: 'Transcribe Audio',
+    });
+    /**
+     * Image to Text Tool using OpenAI Vision
+     */
+    registry.registerTool('image_to_text', `Analyzes images and extracts text/descriptions.
+
+Supported formats: ${SUPPORTED_IMAGE_FORMATS.join(', ')}
+Maximum file size: ${formatBytes(MAX_IMAGE_SIZE_BYTES)}
+
+Use this tool when you need to:
+- Extract text from images (OCR)
+- Describe image contents
+- Analyze screenshots, diagrams, or documents
+- Get detailed descriptions of visual content
+
+You can provide a custom prompt to guide what information to extract from the image.`, {
+        type: 'object',
+        properties: {
+            file_path: {
+                type: 'string',
+                description: 'Path to the image file to analyze (relative or absolute)',
+            },
+            prompt: {
+                type: 'string',
+                description: 'Instructions for what to extract or describe from the image. ' +
+                    'Default: "Describe this image in detail and extract any visible text."',
+            },
+            detail: {
+                type: 'string',
+                description: 'Image detail level: "low" (faster, cheaper), "high" (more detail), or "auto". Defaults to auto.',
+                enum: ['low', 'high', 'auto'],
+            },
+            max_tokens: {
+                type: 'number',
+                description: 'Maximum tokens in the response. Defaults to 1000.',
+            },
+        },
+        required: ['file_path'],
+    }, async (input, context) => {
+        const { file_path, prompt = 'Describe this image in detail and extract any visible text.', detail = 'auto', max_tokens = 1000, } = input;
+        // 1. Resolve and validate file path
+        const filePath = path.isAbsolute(file_path)
+            ? file_path
+            : path.resolve(context.projectRoot, file_path);
+        const exists = await pathExists(filePath);
+        if (!exists) {
+            throw new Error(`Image file not found: ${file_path}`);
+        }
+        // 2. Validate file format
+        const ext = path.extname(filePath).toLowerCase();
+        if (!SUPPORTED_IMAGE_FORMATS.includes(ext)) {
+            throw new Error(`Unsupported image format: ${ext}. Supported formats: ${SUPPORTED_IMAGE_FORMATS.join(', ')}`);
+        }
+        // 3. Check file size
+        const stats = await fs.stat(filePath);
+        if (stats.size > MAX_IMAGE_SIZE_BYTES) {
+            throw new Error(`Image file too large: ${formatBytes(stats.size)}. Maximum size: ${formatBytes(MAX_IMAGE_SIZE_BYTES)}`);
+        }
+        // 4. Get OpenAI API key
+        const apiKey = await getOpenAIApiKey();
+        // 5. Read and encode the image
+        const imageBuffer = await fs.readFile(filePath);
+        const base64Image = imageBuffer.toString('base64');
+        const fileName = path.basename(filePath);
+        // Determine MIME type
+        const mimeTypes = {
+            '.png': 'image/png',
+            '.jpg': 'image/jpeg',
+            '.jpeg': 'image/jpeg',
+            '.gif': 'image/gif',
+            '.webp': 'image/webp',
+        };
+        const mimeType = mimeTypes[ext] || 'image/png';
+        // 6. Build the API request
+        const requestBody = {
+            model: 'gpt-4.1',
+            messages: [
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: prompt,
+                        },
+                        {
+                            type: 'image_url',
+                            image_url: {
+                                url: `data:${mimeType};base64,${base64Image}`,
+                                detail: detail,
+                            },
+                        },
+                    ],
+                },
+            ],
+            max_tokens: max_tokens,
+        };
+        // 7. Call OpenAI Vision API
+        logger.info(`Analyzing image: ${fileName}`);
+        const response = await fetch(`${OPENAI_API_BASE_URL}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            let errorMessage = `Image analysis failed with status ${response.status}`;
+            try {
+                const errorData = await response.json();
+                if (errorData.error?.message) {
+                    errorMessage = errorData.error.message;
+                }
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+            throw new Error(errorMessage);
+        }
+        // 8. Parse response
+        const responseData = await response.json();
+        const content = responseData.choices[0]?.message?.content || '';
+        const finishReason = responseData.choices[0]?.finish_reason || 'unknown';
+        logger.info(`Successfully analyzed image: ${fileName}`);
+        // 9. Track usage costs
+        if (responseData.usage) {
+            const credentialStore = await getCredentialStore();
+            const compassApiKey = await credentialStore.getCompassApiKey();
+            if (compassApiKey) {
+                const compassAuthService = getCompassAuthService();
+                compassAuthService.trackUsage({
+                    input_tokens: responseData.usage.prompt_tokens,
+                    output_tokens: responseData.usage.completion_tokens,
+                    cache_write_input_tokens: 0,
+                    cache_read_input_tokens: 0,
+                    provider: 'openai',
+                    model: 'gpt-4.1',
+                }, compassApiKey).catch(() => { }); // fire-and-forget
+            }
+        }
+        return {
+            success: true,
+            file: file_path,
+            fileName,
+            fileSize: stats.size,
+            fileSizeFormatted: formatBytes(stats.size),
+            format: ext,
+            mimeType,
+            detail,
+            prompt,
+            analysis: content,
+            finishReason,
+            usage: responseData.usage || null,
+        };
+    }, {
+        actionType: ActionType.CODE_ANALYSIS,
+        requiresApproval: false,
+        category: 'ai_operations',
+        tags: ['openai', 'vision', 'image', 'ocr', 'image-to-text'],
+        displayName: 'Image to Text',
+    });
+}
+//# sourceMappingURL=openai-tools.js.map

package/dist/tools/openai-tools.js.map

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

package/dist/tools/plan-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plan and workflow tools
+ *
+ * Tools for managing implementation plans, including entering plan mode,
+ * updating plans, and completing plan tasks.
+ */
+import type { ToolRegistry } from '../services/tool-registry.js';
+export declare function registerPlanTools(registry: ToolRegistry): void;
+//# sourceMappingURL=plan-tools.d.ts.map

package/dist/tools/plan-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tools.d.ts","sourceRoot":"","sources":["../../src/tools/plan-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAajE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAmQ9D"}

package/dist/tools/plan-tools.js

@@ -0,0 +1,223 @@
+/**
+ * Plan and workflow tools
+ *
+ * Tools for managing implementation plans, including entering plan mode,
+ * updating plans, and completing plan tasks.
+ */
+import { ActionType } from '../services/action-logger.js';
+import { planModeHandler, formatPlanModeResult, } from '../services/plan-mode-handler.js';
+import { updatePlanHandler, formatUpdatePlanResult, } from '../services/update-plan-handler.js';
+import { getPlanPersistence } from '../services/plan-persistence.js';
+import { getEventEmitter } from '../core/event-emitter.js';
+export function registerPlanTools(registry) {
+    registry.registerTool('enter_plan_mode', `Initiates structured planning for complex tasks. Use this tool PROACTIVELY when:
+- The task affects 4+ files or requires architectural changes
+- Multiple valid implementation approaches exist and you're unsure which to choose
+- Requirements are ambiguous and need clarification before proceeding
+- The task involves breaking changes, migrations, or cross-cutting concerns
+- Risk of the change is high (affects critical systems like auth, payments, data)
+
+This tool will:
+1. Gather context about the codebase
+2. Assess complexity and identify risks
+3. Ask clarifying questions if needed
+4. Generate a detailed implementation plan
+5. Get user approval before execution
+
+Do NOT use this for simple tasks like typo fixes, single-file changes, or tasks with clear requirements.`, {
+        type: 'object',
+        properties: {
+            task_summary: {
+                type: 'string',
+                description: 'Brief summary of what needs to be accomplished (1-2 sentences)',
+            },
+            complexity_reason: {
+                type: 'string',
+                description: 'Why this task requires planning (e.g., "affects authentication across 8 files", "multiple database migration approaches possible")',
+            },
+        },
+        required: ['task_summary'],
+    }, async (input, context) => {
+        const result = await planModeHandler(input, context);
+        return {
+            ...result,
+            formatted: formatPlanModeResult(result),
+        };
+    }, {
+        actionType: ActionType.PLANNING,
+        requiresApproval: false, // Auto-approve - workflow has its own approval gates
+        category: 'workflow',
+        tags: ['planning', 'workflow', 'complex'],
+        displayName: 'Plan',
+    });
+    registry.registerTool('update_plan', `Updates an existing implementation plan with modifications.
+
+Use this tool when:
+- The user requests changes to an approved plan
+- Mid-execution discoveries require plan adjustments (e.g., "Task 3 revealed we also need X")
+- A blocker is found that requires a different approach
+- Scope changes during implementation
+
+This tool is MORE EFFICIENT than calling enter_plan_mode again because it:
+1. Reuses the stored project context (no re-scanning)
+2. Reuses the complexity assessment
+3. Preserves completed task progress
+4. Maintains version history for rollback
+
+The tool will show the updated plan for user approval before applying changes.`, {
+        type: 'object',
+        properties: {
+            plan_id: {
+                type: 'string',
+                description: 'The ID of the plan to update (from enter_plan_mode result)',
+            },
+            modification_request: {
+                type: 'string',
+                description: 'Description of what changes to make to the plan',
+            },
+            scope: {
+                type: 'string',
+                enum: ['full', 'tasks_only', 'add_tasks'],
+                description: 'Scope of modification: full (any changes), tasks_only (just task list), add_tasks (only add new tasks)',
+            },
+            preserve_completed: {
+                type: 'boolean',
+                description: 'Whether to preserve completed tasks unchanged (default: true)',
+            },
+        },
+        required: ['plan_id', 'modification_request'],
+    }, async (input, context) => {
+        const result = await updatePlanHandler(input, context);
+        return {
+            ...result,
+            formatted: formatUpdatePlanResult(result),
+        };
+    }, {
+        actionType: ActionType.PLANNING,
+        requiresApproval: false, // Auto-approve - workflow has its own approval gates
+        category: 'workflow',
+        tags: ['planning', 'workflow', 'update'],
+        displayName: 'Update Plan',
+    });
+    registry.registerTool('complete_plan_task', `MANDATORY tool call after completing each task in the implementation plan.
+You MUST call this tool — do NOT just say you will mark a task complete. Actually invoke this tool.
+
+This tool:
+1. Tracks progress for the user
+2. Updates the plan log file
+3. Returns the next task to work on
+
+Call this immediately after finishing a task, before starting the next one.
+NEVER skip this tool call — narrating completion without calling this tool does NOT update progress.`, {
+        type: 'object',
+        properties: {
+            plan_id: {
+                type: 'string',
+                description: 'The plan/workflow ID returned from enter_plan_mode',
+            },
+            task_id: {
+                type: 'string',
+                description: 'The task ID being completed (e.g., "task-abc12345")',
+            },
+            status: {
+                type: 'string',
+                enum: ['completed', 'failed', 'skipped'],
+                description: 'The completion status of the task',
+            },
+            files_modified: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'List of files that were modified for this task',
+            },
+            summary: {
+                type: 'string',
+                description: 'Brief summary of what was done (1-2 sentences)',
+            },
+            error: {
+                type: 'string',
+                description: 'Error message if status is "failed"',
+            },
+        },
+        required: ['plan_id', 'task_id', 'status'],
+    }, async (input, context) => {
+        const { plan_id, task_id, status, files_modified, summary, error } = input;
+        const planPersistence = getPlanPersistence(context.projectRoot);
+        const eventEmitter = getEventEmitter();
+        // Update task status in plan record
+        const taskRecord = await planPersistence.updateTaskStatus(plan_id, task_id, status, files_modified, error);
+        if (!taskRecord) {
+            return {
+                success: false,
+                error: `Task ${task_id} not found in plan ${plan_id}`,
+            };
+        }
+        // Get updated execution summary
+        const executionSummary = await planPersistence.getExecutionSummary(plan_id);
+        // Emit event for UI to update
+        eventEmitter.emit('plan-task-completed', {
+            planId: plan_id,
+            taskId: task_id,
+            status,
+            summary: executionSummary,
+        });
+        // Check if all tasks are done
+        const allDone = executionSummary &&
+            executionSummary.pending === 0 &&
+            executionSummary.inProgress === 0;
+        if (allDone) {
+            const success = executionSummary.failed === 0;
+            await planPersistence.completeExecution(plan_id, success);
+            eventEmitter.emit('plan-execution-completed', {
+                planId: plan_id,
+                success,
+                summary: executionSummary,
+            });
+        }
+        const progressText = executionSummary
+            ? `${executionSummary.completed}/${executionSummary.total} tasks completed`
+            : 'Progress updated';
+        // Build list of remaining tasks to guide LLM on what's next
+        let remainingTasksInfo = null;
+        let nextTaskInfo = null;
+        if (executionSummary && !allDone) {
+            const pendingTasks = executionSummary.tasks
+                .map((t, idx) => ({ ...t, index: idx + 1 }))
+                .filter((t) => t.status === 'pending' || t.status === 'in_progress');
+            if (pendingTasks.length > 0) {
+                nextTaskInfo = {
+                    id: pendingTasks[0].task.id,
+                    index: pendingTasks[0].index,
+                    description: pendingTasks[0].task.description,
+                };
+                remainingTasksInfo = pendingTasks
+                    .map((t) => `  Task ${t.index}: ${t.task.description}`)
+                    .join('\n');
+            }
+        }
+        return {
+            success: true,
+            taskId: task_id,
+            taskStatus: status,
+            progress: progressText,
+            summary: summary || `Task ${task_id} marked as ${status}`,
+            allTasksComplete: allDone,
+            executionSummary,
+            // Include remaining tasks for LLM context
+            remainingTasks: remainingTasksInfo,
+            nextTask: nextTaskInfo,
+            // Clear instruction for what to do next
+            nextAction: allDone
+                ? 'All tasks complete. Summarize what was accomplished.'
+                : nextTaskInfo
+                    ? `Proceed with Task ${nextTaskInfo.index}: ${nextTaskInfo.description}`
+                    : null,
+        };
+    }, {
+        actionType: ActionType.PLANNING,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['planning', 'workflow', 'progress'],
+        displayName: 'Complete Task',
+    });
+}
+//# sourceMappingURL=plan-tools.js.map

package/dist/tools/plan-tools.js.map

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

package/dist/tools/schedule-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Schedule tools
+ *
+ * LLM tools for managing scheduled tasks stored in Schedule.md.
+ * Provides CRUD operations plus cron expression parsing.
+ */
+import type { ToolRegistry } from '../services/tool-registry.js';
+export declare function registerScheduleTools(registry: ToolRegistry): void;
+//# sourceMappingURL=schedule-tools.d.ts.map

package/dist/tools/schedule-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-tools.d.ts","sourceRoot":"","sources":["../../src/tools/schedule-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAsCjE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAoclE"}