@compass-ai/nova 1.0.73 → 1.0.74

package/dist/services/prompt-preprocessor.js

@@ -0,0 +1,146 @@
+/**
+ * Prompt Preprocessor Service.
+ *
+ * Preprocesses user prompts to detect references to the active IDE file
+ * and inject file content into the context when appropriate.
+ *
+ * This enables users to say things like "explain this file" or
+ * "what does this file do?" and have the CLI automatically include
+ * the content of the file they have open in their IDE.
+ */
+import { logger } from '../utils/logger.js';
+import { getIdeStateService } from './ide-state-service.js';
+/**
+ * Patterns that indicate the user is referencing the active IDE file.
+ * These are case-insensitive.
+ */
+const FILE_REFERENCE_PATTERNS = [
+    /\bthis file\b/i,
+    /\bthe (open|active|current|selected) file\b/i,
+    /\bopen file\b/i,
+    /\bcurrent file\b/i,
+    /\bactive file\b/i,
+    /\bselected file\b/i,
+    /\bfile I('m| am) (looking at|viewing|editing|working on)\b/i,
+    /\bwhat('s| is) (in )?this file\b/i,
+    /\bexplain this file\b/i,
+    /\banalyze this file\b/i,
+    /\breview this file\b/i,
+];
+/**
+ * Prompt Preprocessor class.
+ * Detects file references in user input and injects IDE context when appropriate.
+ */
+class PromptPreprocessor {
+    ideStateService;
+    constructor() {
+        this.ideStateService = getIdeStateService();
+    }
+    /**
+     * Process user input, potentially injecting IDE context.
+     *
+     * @param userInput - The raw user input
+     * @returns Processed result with potentially modified input
+     */
+    async process(userInput) {
+        // Check if input references the active file
+        if (!this.detectFileReference(userInput)) {
+            return {
+                processedInput: userInput,
+                contextInjected: false,
+            };
+        }
+        // Check if IDE is connected
+        if (!this.ideStateService.isConnected()) {
+            logger.debug('File reference detected but IDE not connected');
+            return {
+                processedInput: userInput,
+                contextInjected: false,
+            };
+        }
+        // Check if there's an active file
+        if (!this.ideStateService.hasActiveFile()) {
+            logger.debug('File reference detected but no active file');
+            return {
+                processedInput: userInput,
+                contextInjected: false,
+            };
+        }
+        // Get file content
+        const fileContent = await this.ideStateService.getActiveFileContent();
+        if (!fileContent) {
+            logger.debug('File reference detected but could not read file content');
+            return {
+                processedInput: userInput,
+                contextInjected: false,
+            };
+        }
+        // Inject context
+        const contextBlock = this.formatContext(fileContent);
+        const processedInput = `${contextBlock}\n\n${userInput}`;
+        logger.info('Injected IDE file context', {
+            filePath: fileContent.path,
+            lineCount: fileContent.lineCount,
+            truncated: fileContent.truncated,
+        });
+        return {
+            processedInput,
+            contextInjected: true,
+            injectionDetails: {
+                filePath: fileContent.path,
+                lineCount: fileContent.lineCount,
+                truncated: fileContent.truncated,
+            },
+        };
+    }
+    /**
+     * Check if user input contains patterns that reference the active file.
+     *
+     * @param input - The user input to check
+     * @returns True if a file reference pattern is detected
+     */
+    detectFileReference(input) {
+        return FILE_REFERENCE_PATTERNS.some(pattern => pattern.test(input));
+    }
+    /**
+     * Format the file content for injection into the prompt.
+     *
+     * @param file - The file content result
+     * @returns Formatted context block
+     */
+    formatContext(file) {
+        const truncatedAttr = file.truncated ? ' truncated="true"' : '';
+        return `<ide-context>
+<active-file path="${file.path}" lines="1-${file.lineCount}"${truncatedAttr}>
+${file.content}
+</active-file>
+</ide-context>
+
+The user is asking about the file shown above.`;
+    }
+}
+// Singleton instance
+let promptPreprocessorInstance = null;
+/**
+ * Get the singleton PromptPreprocessor instance.
+ * Creates the instance on first call.
+ *
+ * @returns The PromptPreprocessor singleton instance
+ */
+export function getPromptPreprocessor() {
+    if (!promptPreprocessorInstance) {
+        promptPreprocessorInstance = new PromptPreprocessor();
+    }
+    return promptPreprocessorInstance;
+}
+/**
+ * Create a new PromptPreprocessor instance.
+ * Use this when you need a separate instance from the singleton (e.g., for testing).
+ *
+ * @returns A new PromptPreprocessor instance
+ */
+export function createPromptPreprocessor() {
+    return new PromptPreprocessor();
+}
+export { PromptPreprocessor };
+//# sourceMappingURL=prompt-preprocessor.js.map

package/dist/services/prompt-preprocessor.js.map

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

package/dist/services/rating-service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Rating submission service for the Compass API.
+ *
+ * This service handles submitting user ratings to the Compass backend.
+ * It requires a valid Compass API key for authentication.
+ */
+import type { RatingSubmitResponse } from '../types/rating.js';
+/**
+ * RatingService class handles rating submissions to the Compass API.
+ */
+declare class RatingService {
+    private apiEndpoint;
+    private apiKey;
+    /**
+     * Creates a new RatingService instance.
+     *
+     * @param apiEndpoint - Optional custom API endpoint
+     * @param apiKey - Optional API key for authentication
+     */
+    constructor(apiEndpoint?: string, apiKey?: string);
+    /**
+     * Configures the service with a new endpoint and optional API key.
+     * Automatically extracts the base API URL from full endpoint paths.
+     *
+     * @param endpoint - The API endpoint URL
+     * @param apiKey - Optional API key for authentication
+     *
+     * @example
+     * // Input: http://localhost:8000/api/ai/excel
+     * // Extracted: http://localhost:8000/api
+     */
+    configure(endpoint: string, apiKey?: string): void;
+    /**
+     * Sets the API key for authentication.
+     *
+     * @param apiKey - The Compass API key
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Gets the current API endpoint.
+     *
+     * @returns The configured API endpoint
+     */
+    getEndpoint(): string;
+    /**
+     * Checks if the service has an API key configured.
+     *
+     * @returns True if an API key is set
+     */
+    hasApiKey(): boolean;
+    /**
+     * Submits a rating to the Compass API.
+     *
+     * @param rating - Integer rating between 1-5
+     * @param teamId - Optional team identifier
+     * @returns Promise resolving to the API response
+     * @throws Error if rating is not between 1-5 or if submission fails
+     */
+    submitRating(rating: number, teamId?: string): Promise<RatingSubmitResponse>;
+}
+/**
+ * Gets the singleton RatingService instance.
+ *
+ * @returns The RatingService instance
+ *
+ * @example
+ * ```typescript
+ * const ratingService = getRatingService();
+ * ratingService.setApiKey('your-api-key');
+ * const result = await ratingService.submitRating(5);
+ * ```
+ */
+export declare function getRatingService(): RatingService;
+/**
+ * Creates a new RatingService instance.
+ * Use this when you need a separate instance from the singleton.
+ *
+ * @param apiEndpoint - Optional custom API endpoint
+ * @param apiKey - Optional API key
+ * @returns A new RatingService instance
+ */
+export declare function createRatingService(apiEndpoint?: string, apiKey?: string): RatingService;
+export { RatingService };
+//# sourceMappingURL=rating-service.d.ts.map

package/dist/services/rating-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating-service.d.ts","sourceRoot":"","sources":["../../src/services/rating-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAC;AAOpF;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAuB;IAErC;;;;;OAKG;gBACS,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAOjD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAYlD;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;;OAOG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAiEnF;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAExF;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/services/rating-service.js

@@ -0,0 +1,171 @@
+/**
+ * Rating submission service for the Compass API.
+ *
+ * This service handles submitting user ratings to the Compass backend.
+ * It requires a valid Compass API key for authentication.
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * Default base URL for the Compass API.
+ */
+const DEFAULT_API_BASE_URL = 'https://api.compassap.ai/api';
+/**
+ * RatingService class handles rating submissions to the Compass API.
+ */
+class RatingService {
+    apiEndpoint;
+    apiKey = null;
+    /**
+     * Creates a new RatingService instance.
+     *
+     * @param apiEndpoint - Optional custom API endpoint
+     * @param apiKey - Optional API key for authentication
+     */
+    constructor(apiEndpoint, apiKey) {
+        this.apiEndpoint = apiEndpoint || DEFAULT_API_BASE_URL;
+        if (apiKey) {
+            this.apiKey = apiKey;
+        }
+    }
+    /**
+     * Configures the service with a new endpoint and optional API key.
+     * Automatically extracts the base API URL from full endpoint paths.
+     *
+     * @param endpoint - The API endpoint URL
+     * @param apiKey - Optional API key for authentication
+     *
+     * @example
+     * // Input: http://localhost:8000/api/ai/excel
+     * // Extracted: http://localhost:8000/api
+     */
+    configure(endpoint, apiKey) {
+        // Extract base API URL if a full path is provided
+        const apiMatch = endpoint.match(/^(https?:\/\/[^/]+\/api)/);
+        this.apiEndpoint = apiMatch ? apiMatch[1] : endpoint;
+        if (apiKey) {
+            this.apiKey = apiKey;
+        }
+        logger.debug('[Rating] Configured with endpoint:', { endpoint: this.apiEndpoint });
+    }
+    /**
+     * Sets the API key for authentication.
+     *
+     * @param apiKey - The Compass API key
+     */
+    setApiKey(apiKey) {
+        this.apiKey = apiKey;
+    }
+    /**
+     * Gets the current API endpoint.
+     *
+     * @returns The configured API endpoint
+     */
+    getEndpoint() {
+        return this.apiEndpoint;
+    }
+    /**
+     * Checks if the service has an API key configured.
+     *
+     * @returns True if an API key is set
+     */
+    hasApiKey() {
+        return this.apiKey !== null && this.apiKey.length > 0;
+    }
+    /**
+     * Submits a rating to the Compass API.
+     *
+     * @param rating - Integer rating between 1-5
+     * @param teamId - Optional team identifier
+     * @returns Promise resolving to the API response
+     * @throws Error if rating is not between 1-5 or if submission fails
+     */
+    async submitRating(rating, teamId) {
+        // Validate rating
+        if (!Number.isInteger(rating) || rating < 1 || rating > 5) {
+            throw new Error('Rating must be an integer between 1 and 5');
+        }
+        const url = `${this.apiEndpoint}/tenant/rating`;
+        const body = {
+            rating,
+        };
+        if (teamId) {
+            body.team_id = teamId;
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.apiKey) {
+            headers['x-api-key'] = this.apiKey;
+        }
+        logger.debug('[Rating] Submitting rating:', { rating, teamId, url });
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                let errorMessage = `Rating submission failed with status ${response.status}`;
+                try {
+                    const errorData = await response.json();
+                    if (errorData.detail) {
+                        errorMessage = errorData.detail;
+                    }
+                    else if (errorData.message) {
+                        errorMessage = errorData.message;
+                    }
+                }
+                catch {
+                    // Ignore JSON parse errors
+                }
+                logger.error('[Rating] Submission failed:', { status: response.status, error: errorMessage });
+                return { success: false, message: errorMessage };
+            }
+            const data = await response.json();
+            logger.debug('[Rating] Rating submitted successfully:', data);
+            return {
+                success: true,
+                message: data.message || 'Rating submitted successfully',
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.error('[Rating] Failed to submit rating:', { error: errorMessage });
+            // Return failure instead of throwing to avoid blocking user workflow
+            return { success: false, message: errorMessage };
+        }
+    }
+}
+// Singleton instance
+let ratingServiceInstance = null;
+/**
+ * Gets the singleton RatingService instance.
+ *
+ * @returns The RatingService instance
+ *
+ * @example
+ * ```typescript
+ * const ratingService = getRatingService();
+ * ratingService.setApiKey('your-api-key');
+ * const result = await ratingService.submitRating(5);
+ * ```
+ */
+export function getRatingService() {
+    if (!ratingServiceInstance) {
+        ratingServiceInstance = new RatingService();
+    }
+    return ratingServiceInstance;
+}
+/**
+ * Creates a new RatingService instance.
+ * Use this when you need a separate instance from the singleton.
+ *
+ * @param apiEndpoint - Optional custom API endpoint
+ * @param apiKey - Optional API key
+ * @returns A new RatingService instance
+ */
+export function createRatingService(apiEndpoint, apiKey) {
+    return new RatingService(apiEndpoint, apiKey);
+}
+export { RatingService };
+//# sourceMappingURL=rating-service.js.map

package/dist/services/rating-service.js.map

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

package/dist/services/rating-state-manager.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Rating state management service.
+ *
+ * This service tracks user activity and determines when to display
+ * the rating dialog. It implements a smart frequency algorithm that
+ * reduces rating prompts for returning users who have already provided feedback.
+ *
+ * Key features:
+ * - Tracks active usage time across sessions
+ * - Implements progressive cooldown based on rating history
+ * - Persists state to ~/.compass/rating-state.json
+ */
+import { RatingState, RatingConfig } from '../types/rating.js';
+/**
+ * RatingStateManager class tracks user activity and determines
+ * when to show the rating dialog.
+ */
+declare class RatingStateManager {
+    private state;
+    private config;
+    private loaded;
+    private lastActivityTime;
+    private lastUsageCheckTime;
+    constructor(config?: Partial<RatingConfig>);
+    /**
+     * Gets the path to the rating state file.
+     */
+    private getStateFilePath;
+    /**
+     * Loads the rating state from disk.
+     */
+    load(): Promise<void>;
+    /**
+     * Saves the current state to disk.
+     */
+    save(): Promise<void>;
+    /**
+     * Records user activity. Call this when the user interacts
+     * with the CLI (e.g., sends a message, executes a command).
+     */
+    recordActivity(): void;
+    /**
+     * Updates usage time based on activity.
+     * This should be called periodically (e.g., every 10 seconds).
+     *
+     * @returns The updated total usage time in milliseconds
+     */
+    updateUsageTime(): number;
+    /**
+     * Calculates the effective cooldown period based on rating history.
+     * The cooldown increases with each rating submitted to reduce frequency
+     * for returning users.
+     *
+     * @returns The cooldown period in milliseconds
+     */
+    private getEffectiveCooldown;
+    /**
+     * Checks if the rating dialog should be shown.
+     *
+     * Conditions:
+     * 1. Total usage time >= threshold (2 minutes by default)
+     * 2. Either never shown before OR cooldown period has passed
+     *
+     * @returns True if the rating dialog should be shown
+     */
+    shouldShowRating(): boolean;
+    /**
+     * Records that the rating dialog was shown.
+     * This updates the lastRatingShownAt timestamp.
+     */
+    recordRatingShown(): Promise<void>;
+    /**
+     * Records that a rating was submitted.
+     * This resets the usage time and updates the cooldown period.
+     */
+    recordRatingSubmitted(): Promise<void>;
+    /**
+     * Gets the current state for debugging purposes.
+     */
+    getDebugStatus(): {
+        usageTimeSeconds: number;
+        thresholdSeconds: number;
+        secondsUntilEligible: number;
+        lastRatingShown: string;
+        hoursUntilNextEligible: number;
+        canShowNow: boolean;
+        totalRatingsSubmitted: number;
+        totalSessions: number;
+        effectiveCooldownHours: number;
+    };
+    /**
+     * Gets the current rating state.
+     */
+    getState(): RatingState;
+    /**
+     * Resets all rating state (for testing or user request).
+     */
+    reset(): Promise<void>;
+    /**
+     * Force shows the rating by setting usage time above threshold.
+     * For testing/debugging purposes.
+     */
+    forceEligible(): Promise<void>;
+}
+/**
+ * Gets the singleton RatingStateManager instance.
+ * Automatically loads state from disk on first call.
+ *
+ * @returns Promise resolving to the RatingStateManager instance
+ *
+ * @example
+ * ```typescript
+ * const ratingStateManager = await getRatingStateManager();
+ * ratingStateManager.recordActivity();
+ *
+ * if (ratingStateManager.shouldShowRating()) {
+ *   // Show rating dialog
+ * }
+ * ```
+ */
+export declare function getRatingStateManager(): Promise<RatingStateManager>;
+/**
+ * Creates a new RatingStateManager instance with custom configuration.
+ * Use this for testing or when you need separate state management.
+ *
+ * @param config - Optional partial configuration to override defaults
+ * @returns A new RatingStateManager instance
+ */
+export declare function createRatingStateManager(config?: Partial<RatingConfig>): RatingStateManager;
+export { RatingStateManager };
+//# sourceMappingURL=rating-state-manager.d.ts.map

package/dist/services/rating-state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating-state-manager.d.ts","sourceRoot":"","sources":["../../src/services/rating-state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EAIb,MAAM,oBAAoB,CAAC;AAU5B;;;GAGG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAO1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;;OAGG;IACH,cAAc,IAAI,IAAI;IAKtB;;;;;OAKG;IACH,eAAe,IAAI,MAAM;IAczB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;;;OAQG;IACH,gBAAgB,IAAI,OAAO;IAsB3B;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5C;;OAEG;IACH,cAAc,IAAI;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,UAAU,EAAE,OAAO,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,sBAAsB,EAAE,MAAM,CAAC;KAChC;IA8BD;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAMzE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAE3F;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}