@compass-ai/nova 1.0.72 → 1.0.74

package/dist/types/mcp.d.ts

@@ -0,0 +1,456 @@
+/**
+ * Type definitions for Model Context Protocol (MCP) integration.
+ *
+ * This module defines all TypeScript interfaces and types used for MCP
+ * server configuration, transport types, authentication, and tool management.
+ */
+/**
+ * Transport types supported for MCP server connections.
+ * - http: Standard HTTP transport for remote servers (recommended)
+ * - sse: Server-Sent Events transport (deprecated, use HTTP where available)
+ * - stdio: Local process communication for stdio-based servers
+ */
+export type MCPTransportType = 'http' | 'sse' | 'stdio';
+/**
+ * Configuration scopes for MCP servers.
+ * - local: Available only to you in the current project (stored in ~/.compass.json under project paths)
+ * - project: Shared with everyone in the project via .mcp.json file
+ * - user: Available to you across all projects (stored in ~/.compass.json)
+ */
+export type MCPScope = 'local' | 'project' | 'user';
+/**
+ * Base configuration shared by all MCP server types.
+ */
+export interface MCPServerConfigBase {
+    /** Unique name/identifier for the server */
+    name: string;
+    /** Optional description of what this server provides */
+    description?: string;
+    /** Configuration scope */
+    scope?: MCPScope;
+    /** Whether the server is enabled */
+    enabled?: boolean;
+    /** Environment variables to pass to the server */
+    env?: Record<string, string>;
+    /** Source of this configuration (for tracking) */
+    source?: 'user' | 'project' | 'local' | 'plugin' | 'managed' | 'builtin';
+    /** Plugin that provided this server (if applicable) */
+    pluginName?: string;
+    /** OAuth configuration for servers requiring authentication */
+    oauth?: MCPOAuthConfig;
+    /** Whether this server requires the Compass API key (auto-injected if available) */
+    requiresCompassApiKey?: boolean;
+    /**
+     * When true, this server operates in "silent" mode:
+     * - Tool calls are still executed and results are passed to the model for context continuity
+     * - Tool output is NOT rendered to the user (suppressed from UI presentation)
+     * - Approval prompts are auto-approved without user interaction
+     * - Error results are always surfaced to the user regardless of this flag
+     * Defaults to false (standard behavior) when omitted.
+     */
+    silent?: boolean;
+}
+/**
+ * Configuration for HTTP-based MCP servers.
+ */
+export interface MCPHttpServerConfig extends MCPServerConfigBase {
+    type: 'http';
+    /** URL endpoint for the MCP server */
+    url: string;
+    /** HTTP headers to include in requests (e.g., for authentication) */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Configuration for SSE (Server-Sent Events) MCP servers.
+ * Note: SSE is deprecated; use HTTP transport where available.
+ */
+export interface MCPSseServerConfig extends MCPServerConfigBase {
+    type: 'sse';
+    /** URL endpoint for the SSE connection */
+    url: string;
+    /** HTTP headers to include in the connection request */
+    headers?: Record<string, string>;
+    /** Connection timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Configuration for stdio-based (local process) MCP servers.
+ */
+export interface MCPStdioServerConfig extends MCPServerConfigBase {
+    type: 'stdio';
+    /** Command to execute to start the server */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Working directory for the process */
+    cwd?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Union type for all MCP server configurations.
+ */
+export type MCPServerConfig = MCPHttpServerConfig | MCPSseServerConfig | MCPStdioServerConfig;
+/**
+ * Configuration file format for .mcp.json files.
+ */
+export interface MCPConfigFile {
+    /** Map of server names to their configurations */
+    mcpServers?: Record<string, Omit<MCPServerConfig, 'name'>>;
+}
+/**
+ * Connection status for an MCP server.
+ */
+export type MCPConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'authenticating' | 'authenticated' | 'error' | 'timeout';
+/**
+ * Runtime state for a connected MCP server.
+ */
+export interface MCPServerState {
+    /** Server configuration */
+    config: MCPServerConfig;
+    /** Current connection status */
+    status: MCPConnectionStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Timestamp of last successful connection */
+    connectedAt?: Date;
+    /** Timestamp of last activity */
+    lastActivity?: Date;
+    /** Available tools provided by this server */
+    tools: MCPTool[];
+    /** Available resources provided by this server */
+    resources: MCPResource[];
+    /** Available prompts provided by this server */
+    prompts: MCPPrompt[];
+    /** Server capabilities */
+    capabilities?: MCPServerCapabilities;
+}
+/**
+ * Server capabilities as reported by the MCP server.
+ */
+export interface MCPServerCapabilities {
+    /** Whether the server supports tool calls */
+    tools?: boolean;
+    /** Whether the server supports resources */
+    resources?: boolean;
+    /** Whether the server supports prompts */
+    prompts?: boolean;
+    /** Whether the server supports logging */
+    logging?: boolean;
+    /** Experimental capabilities */
+    experimental?: Record<string, unknown>;
+}
+/**
+ * MCP tool definition.
+ */
+export interface MCPTool {
+    /** Unique tool name within this server */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description?: string;
+    /** JSON Schema for tool input parameters */
+    inputSchema: MCPToolInputSchema;
+    /** Server that provides this tool */
+    serverName?: string;
+    /**
+     * Whether this tool originates from a silent MCP server.
+     * Inherited from the parent server's `silent` config field.
+     * When true, tool output is suppressed from user-facing presentation.
+     */
+    silent?: boolean;
+}
+/**
+ * JSON Schema for MCP tool input parameters.
+ */
+export interface MCPToolInputSchema {
+    type: 'object';
+    properties?: Record<string, MCPPropertySchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/**
+ * Schema for individual tool input properties.
+ */
+export interface MCPPropertySchema {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: string[];
+    items?: MCPPropertySchema;
+    default?: unknown;
+}
+/**
+ * MCP resource definition.
+ */
+export interface MCPResource {
+    /** Resource URI */
+    uri: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of the resource */
+    description?: string;
+    /** MIME type of the resource content */
+    mimeType?: string;
+    /** Server that provides this resource */
+    serverName?: string;
+}
+/**
+ * MCP prompt definition.
+ */
+export interface MCPPrompt {
+    /** Unique prompt name */
+    name: string;
+    /** Description of what the prompt does */
+    description?: string;
+    /** Arguments the prompt accepts */
+    arguments?: MCPPromptArgument[];
+    /** Server that provides this prompt */
+    serverName?: string;
+}
+/**
+ * MCP prompt argument definition.
+ */
+export interface MCPPromptArgument {
+    /** Argument name */
+    name: string;
+    /** Description of the argument */
+    description?: string;
+    /** Whether this argument is required */
+    required?: boolean;
+}
+/**
+ * Result from calling an MCP tool.
+ */
+export interface MCPToolCallResult {
+    /** Whether the call was successful */
+    success: boolean;
+    /** Content returned by the tool */
+    content?: MCPContent[];
+    /** Error message if the call failed */
+    error?: string;
+    /** Whether the result is an error (MCP protocol level) */
+    isError?: boolean;
+}
+/**
+ * Content block returned by MCP tools.
+ */
+export interface MCPContent {
+    type: 'text' | 'image' | 'resource';
+    text?: string;
+    data?: string;
+    mimeType?: string;
+    uri?: string;
+}
+/**
+ * OAuth 2.0 configuration for MCP servers requiring authentication.
+ */
+export interface MCPOAuthConfig {
+    /** OAuth client ID */
+    clientId?: string;
+    /** OAuth client secret */
+    clientSecret?: string;
+    /** Authorization endpoint URL */
+    authorizationUrl?: string;
+    /** Token endpoint URL */
+    tokenUrl?: string;
+    /** Scopes to request */
+    scopes?: string[];
+    /** Redirect URI for OAuth callback */
+    redirectUri?: string;
+}
+/**
+ * Stored OAuth tokens for an MCP server.
+ */
+export interface MCPOAuthTokens {
+    /** Access token */
+    accessToken: string;
+    /** Token type (usually 'Bearer') */
+    tokenType: string;
+    /** Refresh token for obtaining new access tokens */
+    refreshToken?: string;
+    /** Expiration timestamp */
+    expiresAt?: Date;
+    /** Scopes granted */
+    scopes?: string[];
+}
+/**
+ * Authentication state for an MCP server.
+ */
+export interface MCPAuthState {
+    /** Server name */
+    serverName: string;
+    /** Whether authentication is required */
+    required: boolean;
+    /** Whether currently authenticated */
+    authenticated: boolean;
+    /** OAuth configuration if using OAuth */
+    oauth?: MCPOAuthConfig;
+    /** Stored tokens */
+    tokens?: MCPOAuthTokens;
+    /** Authentication method */
+    method?: 'oauth' | 'header' | 'none';
+}
+/**
+ * Project approval choice for MCP servers from .mcp.json.
+ */
+export interface MCPProjectApproval {
+    /** Project root path */
+    projectPath: string;
+    /** Server name */
+    serverName: string;
+    /** Whether approved */
+    approved: boolean;
+    /** Timestamp of approval decision */
+    decidedAt: Date;
+    /** Hash of the server config for change detection */
+    configHash?: string;
+}
+/**
+ * Options for adding a new MCP server.
+ */
+export interface MCPAddServerOptions {
+    /** Transport type */
+    transport: MCPTransportType;
+    /** Server name */
+    name: string;
+    /** URL (for http/sse) or command (for stdio) */
+    urlOrCommand: string;
+    /** Additional arguments (for stdio) */
+    args?: string[];
+    /** Configuration scope */
+    scope?: MCPScope;
+    /** HTTP headers */
+    headers?: Record<string, string>;
+    /** Environment variables */
+    env?: Record<string, string>;
+}
+/**
+ * Result of an MCP operation.
+ */
+export interface MCPOperationResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Message describing the result */
+    message: string;
+    /** Additional data */
+    data?: unknown;
+    /** Error details if failed */
+    error?: string;
+}
+/**
+ * MCP server list entry for display.
+ */
+export interface MCPServerListEntry {
+    /** Server name */
+    name: string;
+    /** Transport type */
+    type: MCPTransportType;
+    /** Connection status */
+    status: MCPConnectionStatus;
+    /** Configuration scope */
+    scope: MCPScope;
+    /** Source of configuration */
+    source: string;
+    /** Number of tools provided */
+    toolCount: number;
+    /** Number of resources provided */
+    resourceCount: number;
+    /** Whether authentication is needed */
+    needsAuth: boolean;
+    /** URL or command */
+    endpoint: string;
+}
+/**
+ * Plugin MCP server configuration.
+ */
+export interface MCPPluginServerConfig {
+    /** Server configurations from the plugin */
+    servers: Record<string, Omit<MCPServerConfig, 'name'>>;
+    /** Plugin root directory for path expansion */
+    pluginRoot: string;
+    /** Plugin name */
+    pluginName: string;
+}
+/**
+ * Environment variable reference in MCP configuration.
+ * Format: ${VAR} or ${VAR:-default}
+ */
+export interface MCPEnvVarRef {
+    /** Variable name */
+    name: string;
+    /** Default value if not set */
+    defaultValue?: string;
+}
+/**
+ * Infers the transport type from a configuration object based on its properties.
+ * Used to handle configs where the 'type' field is missing.
+ */
+export declare function inferTransportType(config: Record<string, unknown>): 'http' | 'sse' | 'stdio' | null;
+/**
+ * Normalizes a server config by ensuring the type field is set.
+ * If type is missing, infers it from other properties.
+ */
+export declare function normalizeServerConfig<T extends Record<string, unknown>>(config: T): T;
+/**
+ * Type guard to check if a configuration is an HTTP server config.
+ */
+export declare function isMCPHttpConfig(config: MCPServerConfig): config is MCPHttpServerConfig;
+/**
+ * Type guard to check if a configuration is an SSE server config.
+ */
+export declare function isMCPSseConfig(config: MCPServerConfig): config is MCPSseServerConfig;
+/**
+ * Type guard to check if a configuration is a stdio server config.
+ */
+export declare function isMCPStdioConfig(config: MCPServerConfig): config is MCPStdioServerConfig;
+/**
+ * Validates an MCP server configuration.
+ * Handles configs with missing 'type' field by inferring it.
+ */
+export declare function isValidMCPServerConfig(obj: unknown): obj is MCPServerConfig;
+/**
+ * Default timeout for MCP server connections and tool calls (60 seconds).
+ * Can be overridden per-server via the `timeout` config field or via MCP_TIMEOUT env var.
+ */
+export declare const DEFAULT_MCP_TIMEOUT = 60000;
+/**
+ * Default maximum output tokens from MCP tools.
+ */
+export declare const DEFAULT_MAX_MCP_OUTPUT_TOKENS = 10000;
+/**
+ * Warning threshold for MCP tool output tokens.
+ */
+export declare const MCP_OUTPUT_TOKEN_WARNING_THRESHOLD = 10000;
+/**
+ * Fallback server configuration for when primary server authentication fails.
+ * Used when a remote server requires approved OAuth clients but local alternatives exist.
+ */
+export interface MCPFallbackConfig {
+    /** Display name for the fallback */
+    name: string;
+    /** Description of why fallback is needed */
+    reason: string;
+    /** The fallback server configuration */
+    config: Omit<MCPServerConfig, 'name'>;
+    /** Requirements for the fallback to work */
+    requirements?: string[];
+    /** Instructions for setting up the fallback */
+    setupInstructions?: string[];
+}
+/**
+ * Known MCP server providers with their authentication restrictions and fallbacks.
+ */
+export interface MCPProviderInfo {
+    /** Provider name (e.g., 'figma') */
+    name: string;
+    /** Remote server URL pattern */
+    remoteUrlPattern: RegExp;
+    /** Whether OAuth DCR is restricted (whitelist only) */
+    oauthRestricted: boolean;
+    /** List of approved OAuth clients (if restricted) */
+    approvedClients?: string[];
+    /** Fallback configuration if available */
+    fallback?: MCPFallbackConfig;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/types/mcp.d.ts.map

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

package/dist/types/mcp.js

@@ -0,0 +1,94 @@
+/**
+ * Type definitions for Model Context Protocol (MCP) integration.
+ *
+ * This module defines all TypeScript interfaces and types used for MCP
+ * server configuration, transport types, authentication, and tool management.
+ */
+/**
+ * Infers the transport type from a configuration object based on its properties.
+ * Used to handle configs where the 'type' field is missing.
+ */
+export function inferTransportType(config) {
+    // If type is explicitly set, use it
+    if (config.type && ['http', 'sse', 'stdio'].includes(config.type)) {
+        return config.type;
+    }
+    // Infer from other properties
+    if (typeof config.url === 'string' && config.url.length > 0) {
+        // Default to SSE for URL-based configs without explicit type
+        return 'sse';
+    }
+    if (typeof config.command === 'string' && config.command.length > 0) {
+        // Default to stdio for command-based configs
+        return 'stdio';
+    }
+    return null;
+}
+/**
+ * Normalizes a server config by ensuring the type field is set.
+ * If type is missing, infers it from other properties.
+ */
+export function normalizeServerConfig(config) {
+    if (!config.type) {
+        const inferredType = inferTransportType(config);
+        if (inferredType) {
+            return { ...config, type: inferredType };
+        }
+    }
+    return config;
+}
+/**
+ * Type guard to check if a configuration is an HTTP server config.
+ */
+export function isMCPHttpConfig(config) {
+    const normalized = normalizeServerConfig(config);
+    return normalized.type === 'http';
+}
+/**
+ * Type guard to check if a configuration is an SSE server config.
+ */
+export function isMCPSseConfig(config) {
+    const normalized = normalizeServerConfig(config);
+    return normalized.type === 'sse';
+}
+/**
+ * Type guard to check if a configuration is a stdio server config.
+ */
+export function isMCPStdioConfig(config) {
+    const normalized = normalizeServerConfig(config);
+    return normalized.type === 'stdio';
+}
+/**
+ * Validates an MCP server configuration.
+ * Handles configs with missing 'type' field by inferring it.
+ */
+export function isValidMCPServerConfig(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const config = normalizeServerConfig(obj);
+    if (!config.type || !['http', 'sse', 'stdio'].includes(config.type)) {
+        return false;
+    }
+    if (config.type === 'http' || config.type === 'sse') {
+        return typeof config.url === 'string' && config.url.length > 0;
+    }
+    if (config.type === 'stdio') {
+        return typeof config.command === 'string' && config.command.length > 0;
+    }
+    return false;
+}
+/**
+ * Default timeout for MCP server connections and tool calls (60 seconds).
+ * Can be overridden per-server via the `timeout` config field or via MCP_TIMEOUT env var.
+ */
+export const DEFAULT_MCP_TIMEOUT = 60000;
+/**
+ * Default maximum output tokens from MCP tools.
+ */
+export const DEFAULT_MAX_MCP_OUTPUT_TOKENS = 10000;
+/**
+ * Warning threshold for MCP tool output tokens.
+ */
+export const MCP_OUTPUT_TOKEN_WARNING_THRESHOLD = 10000;
+//# sourceMappingURL=mcp.js.map

package/dist/types/mcp.js.map

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

package/dist/types/rating.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Type definitions for the rating system.
+ *
+ * This module defines all TypeScript interfaces and types related to the
+ * user feedback rating system for the Compass CLI application.
+ */
+/**
+ * Represents the persisted state for rating tracking.
+ * Stored in ~/.compass/rating-state.json
+ */
+export interface RatingState {
+    /**
+     * Total accumulated active usage time in milliseconds.
+     * This is reset after a rating is submitted.
+     */
+    totalUsageTimeMs: number;
+    /**
+     * ISO-8601 timestamp of when the rating was last shown.
+     * Used to enforce the cooldown period between rating prompts.
+     */
+    lastRatingShownAt: string | null;
+    /**
+     * ISO-8601 timestamp of when a rating was last submitted.
+     * Used to track if user has ever rated.
+     */
+    lastRatingSubmittedAt: string | null;
+    /**
+     * Number of times the user has submitted a rating (lifetime).
+     * Used to progressively decrease frequency over time.
+     */
+    totalRatingsSubmitted: number;
+    /**
+     * Number of sessions started since installation.
+     * Used along with totalRatingsSubmitted to calculate display frequency.
+     */
+    totalSessions: number;
+    /**
+     * ISO-8601 timestamp of when the CLI was first used.
+     */
+    firstUsedAt: string;
+    /**
+     * ISO-8601 timestamp of the last activity within a session.
+     */
+    lastActivityAt: string | null;
+}
+/**
+ * Configuration for rating display thresholds.
+ */
+export interface RatingConfig {
+    /**
+     * Minimum active usage time (in ms) before first rating prompt.
+     * Default: 2 minutes (120,000ms)
+     */
+    usageTimeThresholdMs: number;
+    /**
+     * Cooldown period (in ms) between rating prompts.
+     * Default: 24 hours (86,400,000ms)
+     */
+    cooldownPeriodMs: number;
+    /**
+     * Activity window (in ms) - user must have interacted within this
+     * window to count as "active".
+     * Default: 2 minutes (120,000ms)
+     */
+    activityWindowMs: number;
+    /**
+     * Multiplier for cooldown based on number of ratings given.
+     * For each rating submitted, cooldown is multiplied by this factor.
+     * This reduces frequency for returning users who have already rated.
+     * Default: 1.5 (so after 1 rating, cooldown is 36 hours; after 2, 54 hours, etc.)
+     */
+    cooldownMultiplier: number;
+    /**
+     * Maximum cooldown period in ms (cap for the multiplier).
+     * Default: 7 days (604,800,000ms)
+     */
+    maxCooldownPeriodMs: number;
+}
+/**
+ * Response from the rating submission API.
+ */
+export interface RatingSubmitResponse {
+    success: boolean;
+    message?: string;
+}
+/**
+ * Request body for rating submission.
+ */
+export interface RatingSubmitRequest {
+    rating: number;
+    team_id?: string;
+}
+/**
+ * Default rating configuration values.
+ */
+export declare const DEFAULT_RATING_CONFIG: RatingConfig;
+/**
+ * Creates a default rating state for first-time users.
+ *
+ * @returns Default RatingState object
+ */
+export declare function createDefaultRatingState(): RatingState;
+/**
+ * Type guard to check if an object is a valid RatingState.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid RatingState
+ */
+export declare function isValidRatingState(obj: unknown): obj is RatingState;
+//# sourceMappingURL=rating.d.ts.map

package/dist/types/rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../src/types/rating.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAMnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAWtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAgBnE"}