@compass-ai/nova 1.0.72 → 1.0.74

package/dist/services/rating-state-manager.js

@@ -0,0 +1,270 @@
+/**
+ * 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 path from 'path';
+import { DEFAULT_RATING_CONFIG, createDefaultRatingState, isValidRatingState, } from '../types/rating.js';
+import { getGlobalCompassDir } from '../utils/path.js';
+import { safeReadJson, safeWriteJson, pathExists, ensureDir } from '../utils/file-system.js';
+import { logger } from '../utils/logger.js';
+/**
+ * File name for persisted rating state.
+ */
+const RATING_STATE_FILE_NAME = 'rating-state.json';
+/**
+ * RatingStateManager class tracks user activity and determines
+ * when to show the rating dialog.
+ */
+class RatingStateManager {
+    state;
+    config;
+    loaded = false;
+    lastActivityTime;
+    lastUsageCheckTime;
+    constructor(config) {
+        this.state = createDefaultRatingState();
+        this.config = { ...DEFAULT_RATING_CONFIG, ...config };
+        this.lastActivityTime = Date.now();
+        this.lastUsageCheckTime = Date.now();
+    }
+    /**
+     * Gets the path to the rating state file.
+     */
+    getStateFilePath() {
+        return path.join(getGlobalCompassDir(), RATING_STATE_FILE_NAME);
+    }
+    /**
+     * Loads the rating state from disk.
+     */
+    async load() {
+        if (this.loaded) {
+            return;
+        }
+        const filePath = this.getStateFilePath();
+        try {
+            if (await pathExists(filePath)) {
+                const data = await safeReadJson(filePath);
+                if (data && isValidRatingState(data)) {
+                    this.state = data;
+                    logger.debug('[Rating] State loaded:', {
+                        totalUsageTimeMs: this.state.totalUsageTimeMs,
+                        totalRatingsSubmitted: this.state.totalRatingsSubmitted,
+                        totalSessions: this.state.totalSessions,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            logger.debug('[Rating] Failed to load rating state, using defaults:', error);
+            this.state = createDefaultRatingState();
+        }
+        // Increment session count
+        this.state.totalSessions++;
+        this.loaded = true;
+        // Save the updated session count
+        await this.save();
+    }
+    /**
+     * Saves the current state to disk.
+     */
+    async save() {
+        const filePath = this.getStateFilePath();
+        try {
+            await ensureDir(path.dirname(filePath));
+            await safeWriteJson(filePath, this.state);
+            logger.debug('[Rating] State saved');
+        }
+        catch (error) {
+            logger.debug('[Rating] Failed to save rating state:', error);
+        }
+    }
+    /**
+     * Records user activity. Call this when the user interacts
+     * with the CLI (e.g., sends a message, executes a command).
+     */
+    recordActivity() {
+        this.lastActivityTime = Date.now();
+        this.state.lastActivityAt = new Date().toISOString();
+    }
+    /**
+     * 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() {
+        const now = Date.now();
+        const timeSinceLastCheck = now - this.lastUsageCheckTime;
+        const timeSinceLastActivity = now - this.lastActivityTime;
+        // Only count time if user was active within the activity window
+        if (timeSinceLastActivity <= this.config.activityWindowMs) {
+            this.state.totalUsageTimeMs += timeSinceLastCheck;
+        }
+        this.lastUsageCheckTime = now;
+        return this.state.totalUsageTimeMs;
+    }
+    /**
+     * 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
+     */
+    getEffectiveCooldown() {
+        const { cooldownPeriodMs, cooldownMultiplier, maxCooldownPeriodMs } = this.config;
+        const { totalRatingsSubmitted } = this.state;
+        // Calculate multiplied cooldown
+        const multipliedCooldown = cooldownPeriodMs * Math.pow(cooldownMultiplier, totalRatingsSubmitted);
+        // Cap at maximum cooldown
+        return Math.min(multipliedCooldown, maxCooldownPeriodMs);
+    }
+    /**
+     * 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() {
+        const { totalUsageTimeMs, lastRatingShownAt } = this.state;
+        const { usageTimeThresholdMs } = this.config;
+        // Check if we've accumulated enough usage time
+        if (totalUsageTimeMs < usageTimeThresholdMs) {
+            return false;
+        }
+        // If never shown before, show it
+        if (!lastRatingShownAt) {
+            return true;
+        }
+        // Check if cooldown period has passed
+        const lastShownTime = new Date(lastRatingShownAt).getTime();
+        const effectiveCooldown = this.getEffectiveCooldown();
+        const timeSinceLastShown = Date.now() - lastShownTime;
+        return timeSinceLastShown >= effectiveCooldown;
+    }
+    /**
+     * Records that the rating dialog was shown.
+     * This updates the lastRatingShownAt timestamp.
+     */
+    async recordRatingShown() {
+        this.state.lastRatingShownAt = new Date().toISOString();
+        await this.save();
+    }
+    /**
+     * Records that a rating was submitted.
+     * This resets the usage time and updates the cooldown period.
+     */
+    async recordRatingSubmitted() {
+        this.state.lastRatingSubmittedAt = new Date().toISOString();
+        this.state.lastRatingShownAt = new Date().toISOString();
+        this.state.totalRatingsSubmitted++;
+        // Reset usage time after rating
+        this.state.totalUsageTimeMs = 0;
+        await this.save();
+        logger.debug('[Rating] Rating submitted, usage time reset', {
+            totalRatingsSubmitted: this.state.totalRatingsSubmitted,
+            nextCooldownMs: this.getEffectiveCooldown(),
+        });
+    }
+    /**
+     * Gets the current state for debugging purposes.
+     */
+    getDebugStatus() {
+        const { totalUsageTimeMs, lastRatingShownAt } = this.state;
+        const { usageTimeThresholdMs } = this.config;
+        const usageTimeSeconds = Math.floor(totalUsageTimeMs / 1000);
+        const thresholdSeconds = Math.floor(usageTimeThresholdMs / 1000);
+        const secondsUntilEligible = Math.max(0, thresholdSeconds - usageTimeSeconds);
+        let hoursUntilNextEligible = 0;
+        if (lastRatingShownAt) {
+            const lastShownTime = new Date(lastRatingShownAt).getTime();
+            const effectiveCooldown = this.getEffectiveCooldown();
+            const timeSinceLastShown = Date.now() - lastShownTime;
+            const remainingCooldown = effectiveCooldown - timeSinceLastShown;
+            hoursUntilNextEligible = Math.max(0, remainingCooldown / (1000 * 60 * 60));
+        }
+        return {
+            usageTimeSeconds,
+            thresholdSeconds,
+            secondsUntilEligible,
+            lastRatingShown: lastRatingShownAt || 'Never',
+            hoursUntilNextEligible,
+            canShowNow: this.shouldShowRating(),
+            totalRatingsSubmitted: this.state.totalRatingsSubmitted,
+            totalSessions: this.state.totalSessions,
+            effectiveCooldownHours: this.getEffectiveCooldown() / (1000 * 60 * 60),
+        };
+    }
+    /**
+     * Gets the current rating state.
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Resets all rating state (for testing or user request).
+     */
+    async reset() {
+        this.state = createDefaultRatingState();
+        this.lastActivityTime = Date.now();
+        this.lastUsageCheckTime = Date.now();
+        await this.save();
+        logger.debug('[Rating] State reset');
+    }
+    /**
+     * Force shows the rating by setting usage time above threshold.
+     * For testing/debugging purposes.
+     */
+    async forceEligible() {
+        this.state.totalUsageTimeMs = this.config.usageTimeThresholdMs + 1000;
+        this.state.lastRatingShownAt = null;
+        await this.save();
+    }
+}
+// Singleton instance
+let ratingStateManagerInstance = null;
+/**
+ * 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 async function getRatingStateManager() {
+    if (!ratingStateManagerInstance) {
+        ratingStateManagerInstance = new RatingStateManager();
+        await ratingStateManagerInstance.load();
+    }
+    return ratingStateManagerInstance;
+}
+/**
+ * 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 function createRatingStateManager(config) {
+    return new RatingStateManager(config);
+}
+export { RatingStateManager };
+//# sourceMappingURL=rating-state-manager.js.map

package/dist/services/rating-state-manager.js.map

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

package/dist/services/sdk-runner.d.ts

@@ -0,0 +1,113 @@
+/**
+ * SDK Runner Service for non-interactive CLI mode
+ *
+ * This service handles the -p flag functionality where the CLI runs a single
+ * query and exits. It provides the full agentic experience (tools, MCP, etc.)
+ * with output suitable for programmatic consumption.
+ *
+ * Key features:
+ * - Full agentic loop with tool execution
+ * - MCP tool integration
+ * - Streaming output to stdout
+ * - Auto-approval mode for non-interactive use
+ * - Piped input support with size limits
+ */
+import type { Attachment } from '../types/session.js';
+import { TokenUsage, CostEstimate } from '../types/token.js';
+/**
+ * Callbacks for SDK runner events - enables integration with ACP and other consumers
+ */
+export interface SDKRunnerCallbacks {
+    /** Called when a text chunk is streamed from the LLM */
+    onTextChunk?: (chunk: string) => void;
+    /** Called when a tool starts execution */
+    onToolStart?: (toolName: string, toolId: string, input: Record<string, unknown>) => void;
+    /** Called when a tool completes execution */
+    onToolComplete?: (toolName: string, toolId: string, result: unknown, success: boolean, error?: string) => void;
+    /** Called for status updates (e.g., "Initializing", "Processing", "Running tool X") */
+    onStatusUpdate?: (status: string) => void;
+    /** Called when the response is complete */
+    onComplete?: (response: string, usage: TokenUsage, cost: CostEstimate) => void;
+    /** Called when an error occurs */
+    onError?: (error: string) => void;
+    /** Called at the start of each agentic iteration */
+    onIterationStart?: (iteration: number, maxIterations: number) => void;
+}
+/**
+ * Model configuration for SDK runner (used by ACP)
+ */
+export interface SDKRunnerModelConfig {
+    /** Provider identifier (e.g., 'anthropic', 'openai', 'ollama') */
+    providerId: string;
+    /** Model identifier (e.g., 'claude-sonnet-4-20250514') */
+    modelId: string;
+}
+/**
+ * Options for the SDK runner
+ */
+export interface SDKRunnerOptions {
+    /** The query to execute */
+    query: string;
+    /** Optional piped input content */
+    pipedInput?: string;
+    /** Optional file attachments (images/PDFs) */
+    attachments?: Attachment[];
+    /** Project root directory */
+    projectRoot: string;
+    /** Whether to continue from previous conversation */
+    continueSession: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Auto-approve all tool operations (use with caution) */
+    autoApprove?: boolean;
+    /** CLI agents JSON string for initialization */
+    cliAgentsJson?: string;
+    /** Agent configuration for specialized execution */
+    agentConfig?: import('../types/agent.js').AgentDefinition;
+    /** If true, use only the agent's system prompt without the default CLI prompt */
+    standaloneAgent?: boolean;
+    /** Per-agent budget for token and turn limits (optional) */
+    budget?: import('../types/agent-process.js').AgentBudget;
+    /** Process ID for tracking (optional) */
+    processId?: string;
+    /** Callback when budget is exceeded */
+    onBudgetExceeded?: (reason: 'tokens' | 'turns') => void;
+    /** Event callbacks for streaming and tool events */
+    callbacks?: SDKRunnerCallbacks;
+    /** If true, suppress stdout/stderr output (use callbacks instead) */
+    silent?: boolean;
+    /** Additional content to append to the system prompt (for mode-specific instructions) */
+    systemPromptAddition?: string;
+    /** If true, add plan mode instructions to encourage planning before execution */
+    forcePlanMode?: boolean;
+    /** Model configuration to use (overrides default). Used by ACP to propagate session model. */
+    model?: SDKRunnerModelConfig;
+    /** If true, skip singleton re-initialization to avoid corrupting parent process state */
+    isSubagent?: boolean;
+    /** If true, enable unguarded (unleash) mode for this execution — bypasses the singleton SessionManager */
+    unguardedMode?: boolean;
+}
+/**
+ * Result from SDK runner execution
+ */
+export interface SDKRunnerResult {
+    /** Whether the execution was successful */
+    success: boolean;
+    /** The response content */
+    content: string;
+    /** Error message if failed */
+    error?: string;
+    /** Exit code to use */
+    exitCode: number;
+}
+/**
+ * Reads piped input from stdin with size limit and timeout
+ * @returns The piped content or undefined if no pipe or empty
+ */
+export declare function readStdin(): Promise<string | undefined>;
+/**
+ * Runs a single query in non-interactive mode with full agentic capabilities
+ * Outputs response to stdout for programmatic consumption
+ */
+export declare function runSDKQuery(options: SDKRunnerOptions): Promise<SDKRunnerResult>;
+//# sourceMappingURL=sdk-runner.d.ts.map

package/dist/services/sdk-runner.d.ts.map

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