@compass-ai/nova 1.0.72 → 1.0.74

package/dist/core/history-manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Command history management for navigation and persistence
+ */
+declare class HistoryManager {
+    private entries;
+    private position;
+    private currentInput;
+    /**
+     * Loads history from disk
+     */
+    load(): Promise<void>;
+    /**
+     * Saves history to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Adds an entry to history
+     */
+    add(entry: string): void;
+    /**
+     * Navigates to the previous entry
+     */
+    previous(currentInput: string): string | null;
+    /**
+     * Navigates to the next entry
+     */
+    next(): string | null;
+    /**
+     * Resets navigation position
+     */
+    resetPosition(): void;
+    /**
+     * Searches history for entries matching a pattern
+     */
+    search(pattern: string): string[];
+    /**
+     * Performs reverse search (Ctrl+R style)
+     */
+    reverseSearch(pattern: string, startIndex?: number): {
+        entry: string;
+        index: number;
+    } | null;
+    /**
+     * Gets all history entries
+     */
+    getAll(): string[];
+    /**
+     * Gets recent entries
+     */
+    getRecent(count?: number): string[];
+    /**
+     * Clears all history
+     */
+    clear(): void;
+    /**
+     * Gets the number of entries
+     */
+    get length(): number;
+}
+export declare function getHistoryManager(): Promise<HistoryManager>;
+export { HistoryManager };
+//# sourceMappingURL=history-manager.d.ts.map

package/dist/core/history-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-manager.d.ts","sourceRoot":"","sources":["../../src/core/history-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,cAAM,cAAc;IAClB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,YAAY,CAAc;IAElC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAwBxB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkB7C;;OAEG;IACH,IAAI,IAAI,MAAM,GAAG,IAAI;IAUrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAOjC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAa5F;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;OAEG;IACH,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,EAAE;IAIvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAKD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAMjE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/history-manager.js

@@ -0,0 +1,151 @@
+/**
+ * Command history management for navigation and persistence
+ */
+import path from 'path';
+import { getGlobalCompassDir } from '../utils/path.js';
+import { safeReadJson, safeWriteJson, pathExists } from '../utils/file-system.js';
+const HISTORY_FILE = 'command-history.json';
+const MAX_HISTORY_SIZE = 1000;
+class HistoryManager {
+    entries = [];
+    position = -1;
+    currentInput = '';
+    /**
+     * Loads history from disk
+     */
+    async load() {
+        const filePath = path.join(getGlobalCompassDir(), HISTORY_FILE);
+        if (await pathExists(filePath)) {
+            const data = await safeReadJson(filePath);
+            if (data?.entries) {
+                this.entries = data.entries;
+            }
+        }
+    }
+    /**
+     * Saves history to disk
+     */
+    async save() {
+        const filePath = path.join(getGlobalCompassDir(), HISTORY_FILE);
+        const data = {
+            entries: this.entries,
+            lastUpdated: new Date().toISOString(),
+        };
+        await safeWriteJson(filePath, data);
+    }
+    /**
+     * Adds an entry to history
+     */
+    add(entry) {
+        const trimmed = entry.trim();
+        if (!trimmed) {
+            return;
+        }
+        // Don't add duplicates of the last entry
+        if (this.entries.length > 0 && this.entries[this.entries.length - 1] === trimmed) {
+            return;
+        }
+        this.entries.push(trimmed);
+        // Trim to max size
+        if (this.entries.length > MAX_HISTORY_SIZE) {
+            this.entries = this.entries.slice(-MAX_HISTORY_SIZE);
+        }
+        // Reset position
+        this.position = -1;
+        this.currentInput = '';
+    }
+    /**
+     * Navigates to the previous entry
+     */
+    previous(currentInput) {
+        if (this.entries.length === 0) {
+            return null;
+        }
+        // Save current input if at the end
+        if (this.position === -1) {
+            this.currentInput = currentInput;
+        }
+        // Move up in history
+        if (this.position < this.entries.length - 1) {
+            this.position++;
+        }
+        return this.entries[this.entries.length - 1 - this.position];
+    }
+    /**
+     * Navigates to the next entry
+     */
+    next() {
+        if (this.position <= 0) {
+            this.position = -1;
+            return this.currentInput;
+        }
+        this.position--;
+        return this.entries[this.entries.length - 1 - this.position];
+    }
+    /**
+     * Resets navigation position
+     */
+    resetPosition() {
+        this.position = -1;
+        this.currentInput = '';
+    }
+    /**
+     * Searches history for entries matching a pattern
+     */
+    search(pattern) {
+        const lowerPattern = pattern.toLowerCase();
+        return this.entries
+            .filter(entry => entry.toLowerCase().includes(lowerPattern))
+            .reverse();
+    }
+    /**
+     * Performs reverse search (Ctrl+R style)
+     */
+    reverseSearch(pattern, startIndex) {
+        const start = startIndex ?? this.entries.length - 1;
+        const lowerPattern = pattern.toLowerCase();
+        for (let i = start; i >= 0; i--) {
+            if (this.entries[i].toLowerCase().includes(lowerPattern)) {
+                return { entry: this.entries[i], index: i };
+            }
+        }
+        return null;
+    }
+    /**
+     * Gets all history entries
+     */
+    getAll() {
+        return [...this.entries];
+    }
+    /**
+     * Gets recent entries
+     */
+    getRecent(count = 10) {
+        return this.entries.slice(-count).reverse();
+    }
+    /**
+     * Clears all history
+     */
+    clear() {
+        this.entries = [];
+        this.position = -1;
+        this.currentInput = '';
+    }
+    /**
+     * Gets the number of entries
+     */
+    get length() {
+        return this.entries.length;
+    }
+}
+// Singleton instance
+let historyManagerInstance = null;
+export async function getHistoryManager() {
+    if (!historyManagerInstance) {
+        historyManagerInstance = new HistoryManager();
+        await historyManagerInstance.load();
+    }
+    return historyManagerInstance;
+}
+export { HistoryManager };
+//# sourceMappingURL=history-manager.js.map

package/dist/core/history-manager.js.map

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

package/dist/core/slash-command-handler.d.ts

@@ -0,0 +1,352 @@
+/**
+ * Slash command routing and execution handler.
+ * This module provides the infrastructure for registering, managing, and executing
+ * slash commands within the interactive Compass CLI session.
+ */
+import { ParsedCommand } from './command-parser.js';
+import type { SlashCommandResult } from '../types/custom-command.js';
+/**
+ * Type definition for slash command handler functions.
+ * Handlers receive parsed arguments and can be synchronous or asynchronous.
+ * Custom command handlers may return SlashCommandResult to trigger LLM flow.
+ */
+export type SlashCommandHandler = (args: string[]) => Promise<SlashCommandResult | void> | SlashCommandResult | void;
+/**
+ * Command categories for organizing slash commands
+ */
+export declare enum CommandCategory {
+    /** Session management commands (clear, reset, save, load) */
+    SESSION = "session",
+    /** Help and information commands (help, tokens, context) */
+    INFO = "info",
+    /** Model configuration commands (model, approve) */
+    MODEL = "model",
+    /** File operations commands (files, index, undo) */
+    FILES = "files",
+    /** Export and output commands */
+    EXPORT = "export",
+    /** System commands (exit, quit) */
+    SYSTEM = "system",
+    /** Authentication commands (login, logout) */
+    AUTH = "auth"
+}
+/**
+ * Definition for a slash command including metadata and handler.
+ */
+export interface SlashCommandDefinition {
+    /** The primary command name (without leading slash) */
+    name: string;
+    /** Optional alternative names for the command */
+    aliases?: string[];
+    /** Human-readable description of what the command does */
+    description: string;
+    /** Usage syntax string (e.g., '/command [arg1] [arg2]') */
+    usage?: string;
+    /** Example usages of the command */
+    examples?: string[];
+    /** The function to execute when the command is invoked */
+    handler: SlashCommandHandler;
+    /** Whether this command requires LLM interaction (default: false) */
+    requiresLLM?: boolean;
+    /** Category for organizing and filtering commands */
+    category?: CommandCategory;
+    /** Whether this command can run offline (default: true if requiresLLM is false) */
+    canRunOffline?: boolean;
+    /** Whether to execute immediately when selected from autocomplete (default: false) */
+    executeOnComplete?: boolean;
+}
+/**
+ * Result of executing a slash command
+ */
+export interface CommandExecutionResult {
+    /** Whether the command was found and executed */
+    success: boolean;
+    /** The command that was executed (if found) */
+    command?: string;
+    /** Error message if execution failed */
+    error?: string;
+    /** Duration of execution in milliseconds */
+    duration?: number;
+}
+/**
+ * Registry class for managing slash command definitions.
+ * Provides methods for registering, unregistering, and looking up commands.
+ */
+declare class SlashCommandRegistry {
+    /** Map of command names to their definitions */
+    private commands;
+    /** Map of aliases to their primary command names */
+    private aliases;
+    /**
+     * Registers a new slash command with the registry.
+     * If a command with the same name already exists, it will be overwritten.
+     *
+     * @param definition - The command definition to register
+     *
+     * @example
+     * ```typescript
+     * registry.register({
+     *   name: 'help',
+     *   aliases: ['h', '?'],
+     *   description: 'Show help menu',
+     *   usage: '/help [topic]',
+     *   handler: async (args) => { ... }
+     * });
+     * ```
+     */
+    register(definition: SlashCommandDefinition): void;
+    /**
+     * Unregisters a command from the registry.
+     * Also removes any associated aliases.
+     *
+     * @param name - The name of the command to unregister
+     * @returns True if the command was found and removed, false otherwise
+     */
+    unregister(name: string): boolean;
+    /**
+     * Gets a command definition by name or alias.
+     *
+     * @param nameOrAlias - The command name or alias to look up
+     * @returns The command definition if found, undefined otherwise
+     */
+    get(nameOrAlias: string): SlashCommandDefinition | undefined;
+    /**
+     * Checks if a command exists in the registry.
+     *
+     * @param nameOrAlias - The command name or alias to check
+     * @returns True if the command exists, false otherwise
+     */
+    has(nameOrAlias: string): boolean;
+    /**
+     * Gets all registered command definitions.
+     *
+     * @returns An array of all command definitions
+     */
+    getAll(): SlashCommandDefinition[];
+    /**
+     * Gets all command names including aliases for autocomplete.
+     *
+     * @returns A sorted array of all command names and aliases
+     */
+    getCommandNames(): string[];
+    /**
+     * Gets commands grouped by category based on their names.
+     * Useful for organizing help output.
+     *
+     * @returns A map of category names to command definitions
+     */
+    getCommandsByCategory(): Map<string, SlashCommandDefinition[]>;
+    /**
+     * Clears all registered commands from the registry.
+     */
+    clear(): void;
+    /**
+     * Gets the number of registered commands.
+     *
+     * @returns The count of registered commands (not including aliases)
+     */
+    get size(): number;
+    /**
+     * Gets all commands that require LLM interaction.
+     *
+     * @returns An array of command definitions that require LLM
+     */
+    getCommandsRequiringLLM(): SlashCommandDefinition[];
+    /**
+     * Gets all commands that are local-only (don't require LLM).
+     *
+     * @returns An array of local-only command definitions
+     */
+    getLocalOnlyCommands(): SlashCommandDefinition[];
+    /**
+     * Gets all commands in a specific category.
+     *
+     * @param category - The category to filter by
+     * @returns An array of command definitions in that category
+     */
+    getCommandsInCategory(category: CommandCategory): SlashCommandDefinition[];
+    /**
+     * Gets all commands that can run offline.
+     *
+     * @returns An array of commands that can run offline
+     */
+    getOfflineCommands(): SlashCommandDefinition[];
+    /**
+     * Checks if a command requires LLM interaction.
+     *
+     * @param nameOrAlias - The command name or alias to check
+     * @returns True if the command requires LLM, false otherwise
+     */
+    requiresLLM(nameOrAlias: string): boolean;
+    /**
+     * Checks if a command can run offline.
+     *
+     * @param nameOrAlias - The command name or alias to check
+     * @returns True if the command can run offline, false otherwise
+     */
+    canRunOffline(nameOrAlias: string): boolean;
+}
+/**
+ * Executes a parsed slash command.
+ * Looks up the command in the registry and invokes its handler.
+ *
+ * @param parsed - The parsed command from the command parser
+ * @returns A promise resolving to the execution result
+ *
+ * @example
+ * ```typescript
+ * const parsed = parseInput('/help model');
+ * const result = await executeSlashCommand(parsed);
+ * if (result.handled) {
+ *   console.log(`Executed: ${parsed.command}`);
+ * } else {
+ *   console.error(`Error: ${result.error}`);
+ * }
+ * ```
+ */
+export declare function executeSlashCommand(parsed: ParsedCommand): Promise<SlashCommandResult>;
+/**
+ * Executes a slash command and returns detailed result information.
+ * Unlike executeSlashCommand, this function catches errors and returns them in the result.
+ *
+ * @param parsed - The parsed command from the command parser
+ * @returns A promise resolving to the detailed execution result
+ */
+export declare function executeSlashCommandWithResult(parsed: ParsedCommand): Promise<CommandExecutionResult>;
+/**
+ * Registers a slash command with the global registry.
+ *
+ * @param definition - The command definition to register
+ *
+ * @example
+ * ```typescript
+ * registerSlashCommand({
+ *   name: 'greet',
+ *   aliases: ['hello', 'hi'],
+ *   description: 'Greet the user',
+ *   usage: '/greet [name]',
+ *   examples: ['/greet', '/greet World'],
+ *   handler: async (args) => {
+ *     const name = args[0] || 'User';
+ *     console.log(`Hello, ${name}!`);
+ *   }
+ * });
+ * ```
+ */
+export declare function registerSlashCommand(definition: SlashCommandDefinition): void;
+/**
+ * Unregisters a slash command from the global registry.
+ *
+ * @param name - The name of the command to unregister
+ * @returns True if the command was found and removed
+ */
+export declare function unregisterSlashCommand(name: string): boolean;
+/**
+ * Gets the global slash command registry instance.
+ * Use this for advanced operations like iterating over all commands.
+ *
+ * @returns The singleton SlashCommandRegistry instance
+ */
+export declare function getSlashCommandRegistry(): SlashCommandRegistry;
+/**
+ * Checks if a slash command is registered.
+ *
+ * @param nameOrAlias - The command name or alias to check
+ * @returns True if the command exists
+ */
+export declare function hasSlashCommand(nameOrAlias: string): boolean;
+/**
+ * Gets a slash command definition by name or alias.
+ *
+ * @param nameOrAlias - The command name or alias to look up
+ * @returns The command definition if found, undefined otherwise
+ */
+export declare function getSlashCommand(nameOrAlias: string): SlashCommandDefinition | undefined;
+/**
+ * Gets all registered slash command names for autocomplete.
+ *
+ * @returns A sorted array of all command names and aliases
+ */
+export declare function getSlashCommandNames(): string[];
+/**
+ * Registers multiple slash commands at once.
+ *
+ * @param definitions - An array of command definitions to register
+ */
+export declare function registerSlashCommands(definitions: SlashCommandDefinition[]): void;
+/**
+ * Creates a simple slash command definition with minimal configuration.
+ * Useful for quick command registration.
+ *
+ * @param name - The command name
+ * @param description - The command description
+ * @param handler - The command handler function
+ * @returns A SlashCommandDefinition object
+ */
+export declare function createSlashCommand(name: string, description: string, handler: SlashCommandHandler): SlashCommandDefinition;
+/**
+ * Validates a slash command definition.
+ * Throws an error if the definition is invalid.
+ *
+ * @param definition - The definition to validate
+ * @throws Error if the definition is invalid
+ */
+export declare function validateSlashCommandDefinition(definition: SlashCommandDefinition): void;
+/**
+ * Gets help text for a specific command.
+ *
+ * @param nameOrAlias - The command name or alias
+ * @returns Formatted help text or null if command not found
+ */
+export declare function getSlashCommandHelp(nameOrAlias: string): string | null;
+/**
+ * Gets a summary of all registered commands.
+ *
+ * @returns An array of objects containing command name and description
+ */
+export declare function getSlashCommandSummary(): Array<{
+    name: string;
+    description: string;
+}>;
+/**
+ * Gets all commands that require LLM interaction.
+ *
+ * @returns An array of command definitions that require LLM
+ */
+export declare function getCommandsRequiringLLM(): SlashCommandDefinition[];
+/**
+ * Gets all commands that are local-only (don't require LLM).
+ *
+ * @returns An array of local-only command definitions
+ */
+export declare function getLocalOnlyCommands(): SlashCommandDefinition[];
+/**
+ * Gets all commands in a specific category.
+ *
+ * @param category - The category to filter by
+ * @returns An array of command definitions in that category
+ */
+export declare function getCommandsInCategory(category: CommandCategory): SlashCommandDefinition[];
+/**
+ * Gets all commands that can run offline.
+ *
+ * @returns An array of commands that can run offline
+ */
+export declare function getOfflineCommands(): SlashCommandDefinition[];
+/**
+ * Checks if a command requires LLM interaction.
+ *
+ * @param nameOrAlias - The command name or alias to check
+ * @returns True if the command requires LLM, false otherwise
+ */
+export declare function commandRequiresLLM(nameOrAlias: string): boolean;
+/**
+ * Checks if a command can run offline.
+ *
+ * @param nameOrAlias - The command name or alias to check
+ * @returns True if the command can run offline, false otherwise
+ */
+export declare function commandCanRunOffline(nameOrAlias: string): boolean;
+export { SlashCommandRegistry };
+export type { SlashCommandResult } from '../types/custom-command.js';
+//# sourceMappingURL=slash-command-handler.d.ts.map

package/dist/core/slash-command-handler.d.ts.map

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