@nexus-cortex/core 4.26.0

package/dist/agents/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent Management Module
+ *
+ * Exports for managing Task Agent profiles
+ */
+export { AgentStore, createAgentStore, type AgentStoreConfig, type CreateAgentOptions, } from './AgentStore.js';
+export { resolveProjectAgentsDir } from './projectRoot.js';
+export type { AgentDefinition } from '../orchestrator/SubAgentTypes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Management Module
+ *
+ * Exports for managing Task Agent profiles
+ */
+export { AgentStore, createAgentStore, } from './AgentStore.js';
+export { resolveProjectAgentsDir } from './projectRoot.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/agents/projectRoot.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveProjectAgentsDir(startDir: string, homeDir?: string): string;
+//# sourceMappingURL=projectRoot.d.ts.map

package/dist/agents/projectRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRoot.d.ts","sourceRoot":"","sources":["../../src/agents/projectRoot.ts"],"names":[],"mappings":"AAgBA,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAqB,GAC7B,MAAM,CAmBR"}

package/dist/agents/projectRoot.js

@@ -0,0 +1,37 @@
+/**
+ * Project-root resolution for agent discovery.
+ *
+ * Agents declared in a project's `.cortex/agents/` should be discoverable when
+ * the tool is launched from any subdirectory of that project — not only from
+ * the project root. This walks up from a starting directory to the nearest
+ * ancestor that actually contains a `.cortex/agents` directory.
+ *
+ * Bounded so it never treats `$HOME` (or anything above it) as a project root —
+ * `~/.cortex/agents` is the personal tier, not the project tier. Falls back to
+ * `<startDir>/.cortex/agents` when no ancestor project root is found.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+export function resolveProjectAgentsDir(startDir, homeDir = os.homedir()) {
+    const home = path.resolve(homeDir);
+    const fallback = path.join(path.resolve(startDir), '.cortex', 'agents');
+    let dir = path.resolve(startDir);
+    // Walk up, but stop before reaching $HOME (personal tier) or the FS root.
+    while (dir !== home) {
+        const candidate = path.join(dir, '.cortex', 'agents');
+        try {
+            if (fs.existsSync(candidate))
+                return candidate;
+        }
+        catch {
+            // ignore fs errors and keep walking
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // filesystem root
+        dir = parent;
+    }
+    return fallback;
+}
+//# sourceMappingURL=projectRoot.js.map

package/dist/agents/projectRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRoot.js","sourceRoot":"","sources":["../../src/agents/projectRoot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,UAAkB,EAAE,CAAC,OAAO,EAAE;IAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxE,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEjC,0EAA0E;IAC1E,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,CAAC,kBAAkB;QAC7C,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/commands/SlashCommandCompleter.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Slash Command Completer
+ *
+ * Provides intelligent autocomplete suggestions for slash commands
+ * based on the command registry and current input state.
+ *
+ * @module commands/SlashCommandCompleter
+ */
+import { CompletionSuggestion, CompletionState, CommandContext, CommandDefinition } from './types.js';
+import { SlashCommandRegistry } from './SlashCommandRegistry.js';
+/**
+ * Configuration for the completer
+ */
+export interface CompleterConfig {
+    /** Maximum suggestions to show */
+    maxSuggestions?: number;
+    /** Enable fuzzy matching (default: false, prefix matching only) */
+    fuzzyMatch?: boolean;
+    /** Minimum characters before showing suggestions */
+    minChars?: number;
+}
+/**
+ * Slash Command Completer
+ *
+ * Handles autocomplete logic for slash commands including:
+ * - Command name completion
+ * - Subcommand completion
+ * - Dynamic argument completion (via registered callbacks)
+ * - Keyboard navigation state management
+ */
+export declare class SlashCommandCompleter {
+    private registry;
+    private config;
+    private state;
+    constructor(registry: SlashCommandRegistry, config?: CompleterConfig);
+    /**
+     * Create initial completion state
+     */
+    private createInitialState;
+    /**
+     * Get current completion state
+     */
+    getState(): CompletionState;
+    /**
+     * Reset completion state
+     */
+    reset(): void;
+    /**
+     * Update suggestions based on current input
+     *
+     * @param input - Current user input
+     * @param context - Optional command context for dynamic completions
+     * @returns Updated completion state
+     */
+    updateSuggestions(input: string, context?: Partial<CommandContext>): Promise<CompletionState>;
+    /**
+     * Get command name suggestions
+     */
+    private getCommandSuggestions;
+    /**
+     * Get subcommand suggestions for a command
+     */
+    private getSubcommandSuggestions;
+    /**
+     * Get argument suggestions (dynamic completion via registered callbacks)
+     */
+    private getArgumentSuggestions;
+    /**
+     * Filter suggestions by partial match
+     */
+    private filterSuggestions;
+    /**
+     * Move selection up in the suggestion list
+     */
+    moveUp(): CompletionState;
+    /**
+     * Move selection down in the suggestion list
+     */
+    moveDown(): CompletionState;
+    /**
+     * Get the currently selected suggestion
+     */
+    getSelected(): CompletionSuggestion | null;
+    /**
+     * Accept the currently selected suggestion
+     *
+     * @param currentInput - Current user input
+     * @returns New input with suggestion applied
+     */
+    acceptSuggestion(currentInput: string): string;
+    /**
+     * Hide the suggestion popup
+     */
+    hideSuggestions(): void;
+    /**
+     * Show the suggestion popup (if there are suggestions)
+     */
+    showSuggestions(): void;
+    /**
+     * Check if suggestions are currently visible
+     */
+    isVisible(): boolean;
+    /**
+     * Get all commands grouped by category (for command palette)
+     */
+    getCommandPalette(): Map<string, CommandDefinition[]>;
+    /**
+     * Get flat list of all commands (for simple displays)
+     */
+    getAllCommands(): CommandDefinition[];
+}
+/**
+ * Create a completer with a new registry
+ */
+export declare function createCompleter(config?: CompleterConfig): SlashCommandCompleter;
+//# sourceMappingURL=SlashCommandCompleter.d.ts.map

package/dist/commands/SlashCommandCompleter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandCompleter.d.ts","sourceRoot":"","sources":["../../src/commands/SlashCommandCompleter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAQD;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,KAAK,CAAkB;gBAEnB,QAAQ,EAAE,oBAAoB,EAAE,MAAM,GAAE,eAAoB;IAMxE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,eAAe,CAAC;IAwD3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;OAEG;YACW,sBAAsB;IA2DpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,MAAM,IAAI,eAAe;IAkBzB;;OAEG;IACH,QAAQ,IAAI,eAAe;IAsB3B;;OAEG;IACH,WAAW,IAAI,oBAAoB,GAAG,IAAI;IAQ1C;;;;;OAKG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAyB9C;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAarD;;OAEG;IACH,cAAc,IAAI,iBAAiB,EAAE;CAGtC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,qBAAqB,CAG/E"}

package/dist/commands/SlashCommandCompleter.js

@@ -0,0 +1,321 @@
+/**
+ * Slash Command Completer
+ *
+ * Provides intelligent autocomplete suggestions for slash commands
+ * based on the command registry and current input state.
+ *
+ * @module commands/SlashCommandCompleter
+ */
+import { SlashCommandRegistry } from './SlashCommandRegistry.js';
+import { SlashCommandParser } from './SlashCommandParser.js';
+const DEFAULT_CONFIG = {
+    maxSuggestions: 10,
+    fuzzyMatch: false,
+    minChars: 0,
+};
+/**
+ * Slash Command Completer
+ *
+ * Handles autocomplete logic for slash commands including:
+ * - Command name completion
+ * - Subcommand completion
+ * - Dynamic argument completion (via registered callbacks)
+ * - Keyboard navigation state management
+ */
+export class SlashCommandCompleter {
+    registry;
+    config;
+    state;
+    constructor(registry, config = {}) {
+        this.registry = registry;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.state = this.createInitialState();
+    }
+    /**
+     * Create initial completion state
+     */
+    createInitialState() {
+        return {
+            suggestions: [],
+            activeIndex: 0,
+            showSuggestions: false,
+            isLoading: false,
+            scrollOffset: 0,
+        };
+    }
+    /**
+     * Get current completion state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Reset completion state
+     */
+    reset() {
+        this.state = this.createInitialState();
+    }
+    /**
+     * Update suggestions based on current input
+     *
+     * @param input - Current user input
+     * @param context - Optional command context for dynamic completions
+     * @returns Updated completion state
+     */
+    async updateSuggestions(input, context) {
+        // Hide suggestions if not a slash command
+        if (!SlashCommandParser.isSlashCommand(input)) {
+            this.state = {
+                ...this.createInitialState(),
+                showSuggestions: false,
+            };
+            return this.getState();
+        }
+        // Get the partial token being typed
+        const { path, partial } = SlashCommandParser.getPartialToken(input);
+        let suggestions = [];
+        if (path.length === 0) {
+            // Completing the root command name
+            suggestions = this.getCommandSuggestions(partial);
+        }
+        else if (path.length === 1) {
+            // Completing a subcommand
+            const commandName = path[0];
+            suggestions = this.getSubcommandSuggestions(commandName, partial);
+            // If no subcommand suggestions, try argument completion
+            if (suggestions.length === 0) {
+                suggestions = await this.getArgumentSuggestions(commandName, undefined, partial, context);
+            }
+        }
+        else {
+            // Completing arguments for a command with subcommand
+            const commandName = path[0];
+            const subcommandName = path[1];
+            suggestions = await this.getArgumentSuggestions(commandName, subcommandName, partial, context);
+        }
+        // Apply max suggestions limit
+        if (suggestions.length > this.config.maxSuggestions) {
+            suggestions = suggestions.slice(0, this.config.maxSuggestions);
+        }
+        // Update state
+        this.state = {
+            suggestions,
+            activeIndex: 0,
+            showSuggestions: suggestions.length > 0,
+            isLoading: false,
+            scrollOffset: 0,
+        };
+        return this.getState();
+    }
+    /**
+     * Get command name suggestions
+     */
+    getCommandSuggestions(partial) {
+        const lowerPartial = partial.toLowerCase();
+        if (this.config.fuzzyMatch) {
+            return this.registry
+                .search(lowerPartial)
+                .map((cmd) => ({
+                label: cmd.name,
+                value: cmd.name,
+                description: cmd.description,
+                type: 'command',
+            }))
+                .slice(0, this.config.maxSuggestions);
+        }
+        return this.registry.getSuggestions(lowerPartial);
+    }
+    /**
+     * Get subcommand suggestions for a command
+     */
+    getSubcommandSuggestions(commandName, partial) {
+        return this.registry.getSubcommandSuggestions(commandName, partial);
+    }
+    /**
+     * Get argument suggestions (dynamic completion via registered callbacks)
+     */
+    async getArgumentSuggestions(commandName, subcommandName, partial, context) {
+        const command = this.registry.getCommand(commandName);
+        if (!command) {
+            return [];
+        }
+        // Build completion context
+        const completionContext = {
+            projectPath: context?.projectPath ?? process.cwd(),
+            args: [partial],
+            options: context?.options ?? {},
+            sessionId: context?.sessionId,
+            modelId: context?.modelId,
+        };
+        // Try subcommand completion first
+        if (subcommandName && command.subcommands) {
+            const subcommand = command.subcommands.find((sub) => sub.name.toLowerCase() === subcommandName.toLowerCase() ||
+                sub.altName?.toLowerCase() === subcommandName.toLowerCase());
+            if (subcommand?.completion) {
+                try {
+                    this.state.isLoading = true;
+                    const suggestions = await subcommand.completion(completionContext);
+                    return this.filterSuggestions(suggestions, partial);
+                }
+                catch (error) {
+                    console.error(`Error getting completions for ${commandName} ${subcommandName}:`, error);
+                    return [];
+                }
+                finally {
+                    this.state.isLoading = false;
+                }
+            }
+        }
+        // Try command-level completion
+        if (command.completion) {
+            try {
+                this.state.isLoading = true;
+                const suggestions = await command.completion(completionContext);
+                return this.filterSuggestions(suggestions, partial);
+            }
+            catch (error) {
+                console.error(`Error getting completions for ${commandName}:`, error);
+                return [];
+            }
+            finally {
+                this.state.isLoading = false;
+            }
+        }
+        return [];
+    }
+    /**
+     * Filter suggestions by partial match
+     */
+    filterSuggestions(suggestions, partial) {
+        if (!partial) {
+            return suggestions;
+        }
+        const lowerPartial = partial.toLowerCase();
+        if (this.config.fuzzyMatch) {
+            return suggestions.filter((s) => s.label.toLowerCase().includes(lowerPartial) ||
+                s.value.toLowerCase().includes(lowerPartial));
+        }
+        return suggestions.filter((s) => s.label.toLowerCase().startsWith(lowerPartial) ||
+            s.value.toLowerCase().startsWith(lowerPartial));
+    }
+    /**
+     * Move selection up in the suggestion list
+     */
+    moveUp() {
+        if (!this.state.showSuggestions || this.state.suggestions.length === 0) {
+            return this.getState();
+        }
+        this.state.activeIndex =
+            this.state.activeIndex > 0
+                ? this.state.activeIndex - 1
+                : this.state.suggestions.length - 1;
+        // Adjust scroll offset if needed
+        if (this.state.activeIndex < this.state.scrollOffset) {
+            this.state.scrollOffset = this.state.activeIndex;
+        }
+        return this.getState();
+    }
+    /**
+     * Move selection down in the suggestion list
+     */
+    moveDown() {
+        if (!this.state.showSuggestions || this.state.suggestions.length === 0) {
+            return this.getState();
+        }
+        this.state.activeIndex =
+            this.state.activeIndex < this.state.suggestions.length - 1
+                ? this.state.activeIndex + 1
+                : 0;
+        // Adjust scroll offset if needed (assuming visible window of 5 items)
+        const visibleWindow = 5;
+        if (this.state.activeIndex >= this.state.scrollOffset + visibleWindow) {
+            this.state.scrollOffset = this.state.activeIndex - visibleWindow + 1;
+        }
+        if (this.state.activeIndex < this.state.scrollOffset) {
+            this.state.scrollOffset = this.state.activeIndex;
+        }
+        return this.getState();
+    }
+    /**
+     * Get the currently selected suggestion
+     */
+    getSelected() {
+        if (!this.state.showSuggestions || this.state.suggestions.length === 0) {
+            return null;
+        }
+        return this.state.suggestions[this.state.activeIndex] ?? null;
+    }
+    /**
+     * Accept the currently selected suggestion
+     *
+     * @param currentInput - Current user input
+     * @returns New input with suggestion applied
+     */
+    acceptSuggestion(currentInput) {
+        const selected = this.getSelected();
+        if (!selected) {
+            return currentInput;
+        }
+        const { path } = SlashCommandParser.getPartialToken(currentInput);
+        // Build the new input with the selected value
+        let newInput = '/';
+        if (path.length === 0) {
+            // Completing root command
+            newInput += selected.value;
+        }
+        else {
+            // Completing subcommand or argument
+            newInput += path.join(' ') + ' ' + selected.value;
+        }
+        // Hide suggestions after accepting
+        this.state.showSuggestions = false;
+        return newInput;
+    }
+    /**
+     * Hide the suggestion popup
+     */
+    hideSuggestions() {
+        this.state.showSuggestions = false;
+    }
+    /**
+     * Show the suggestion popup (if there are suggestions)
+     */
+    showSuggestions() {
+        if (this.state.suggestions.length > 0) {
+            this.state.showSuggestions = true;
+        }
+    }
+    /**
+     * Check if suggestions are currently visible
+     */
+    isVisible() {
+        return this.state.showSuggestions;
+    }
+    /**
+     * Get all commands grouped by category (for command palette)
+     */
+    getCommandPalette() {
+        const palette = new Map();
+        for (const category of this.registry.getCategories()) {
+            const commands = this.registry.getCommandsByCategory(category.name);
+            if (commands.length > 0) {
+                palette.set(category.label, commands);
+            }
+        }
+        return palette;
+    }
+    /**
+     * Get flat list of all commands (for simple displays)
+     */
+    getAllCommands() {
+        return this.registry.getAllCommands();
+    }
+}
+/**
+ * Create a completer with a new registry
+ */
+export function createCompleter(config) {
+    const registry = new SlashCommandRegistry();
+    return new SlashCommandCompleter(registry, config);
+}
+//# sourceMappingURL=SlashCommandCompleter.js.map

package/dist/commands/SlashCommandCompleter.js.map

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

package/dist/commands/SlashCommandParser.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Slash Command Parser
+ *
+ * Parses slash commands from user input with quote-aware tokenization
+ * and option/flag extraction.
+ *
+ * @module commands/SlashCommandParser
+ */
+import { ParsedCommand } from './types.js';
+/**
+ * Slash Command Parser
+ *
+ * Handles parsing of slash commands with support for:
+ * - Quote-aware argument tokenization (single and double quotes)
+ * - Flag/option parsing (--flag, --key=value, -v)
+ * - Hierarchical command/subcommand structure
+ */
+export declare class SlashCommandParser {
+    /**
+     * Parse user input to extract slash command components
+     *
+     * @param input - Raw user input
+     * @returns ParsedCommand with command, subcommand, args, and options
+     *
+     * @example
+     * ```typescript
+     * parse('/models list --provider anthropic')
+     * // => { isCommand: true, command: 'models', subcommand: 'list',
+     * //      args: [], options: { provider: 'anthropic' } }
+     *
+     * parse('/session checkpoint "my save"')
+     * // => { isCommand: true, command: 'session', subcommand: 'checkpoint',
+     * //      args: ['my save'], options: {} }
+     * ```
+     */
+    static parse(input: string): ParsedCommand;
+    /**
+     * Tokenize command line respecting quoted strings
+     *
+     * Handles:
+     * - Single quotes: 'my value'
+     * - Double quotes: "my value"
+     * - Escaped quotes within strings
+     * - Multiple consecutive spaces
+     *
+     * @param line - Command line without leading /
+     * @returns Array of tokens
+     *
+     * @example
+     * ```typescript
+     * tokenize('models list')
+     * // => ['models', 'list']
+     *
+     * tokenize('session checkpoint "my checkpoint"')
+     * // => ['session', 'checkpoint', 'my checkpoint']
+     *
+     * tokenize("config set theme 'tokyo night'")
+     * // => ['config', 'set', 'theme', 'tokyo night']
+     * ```
+     */
+    static tokenize(line: string): string[];
+    /**
+     * Extract options/flags from token array
+     *
+     * Supports:
+     * - Long flags: --flag (boolean true)
+     * - Long options: --key=value or --key value
+     * - Short flags: -v (boolean true)
+     * - Negated flags: --no-flag (boolean false)
+     *
+     * @param tokens - Array of tokens
+     * @returns Object with positional args and options map
+     */
+    private static extractOptions;
+    /**
+     * Check if input is a slash command
+     *
+     * @param input - User input
+     * @returns True if input starts with /
+     */
+    static isSlashCommand(input: string): boolean;
+    /**
+     * Check if input is a partial slash command (for autocomplete)
+     *
+     * @param input - User input
+     * @returns True if input starts with / and has no spaces (partial command)
+     */
+    static isPartialCommand(input: string): boolean;
+    /**
+     * Get the current partial token being typed (for autocomplete)
+     *
+     * @param input - User input
+     * @returns Object with command path and current partial token
+     *
+     * @example
+     * ```typescript
+     * getPartialToken('/mod')
+     * // => { path: [], partial: 'mod' }
+     *
+     * getPartialToken('/models li')
+     * // => { path: ['models'], partial: 'li' }
+     *
+     * getPartialToken('/models list ')
+     * // => { path: ['models', 'list'], partial: '' }
+     * ```
+     */
+    static getPartialToken(input: string): {
+        path: string[];
+        partial: string;
+    };
+    /**
+     * Format a parsed command back to string
+     *
+     * @param parsed - Parsed command object
+     * @returns Formatted command string
+     */
+    static format(parsed: ParsedCommand): string;
+    /**
+     * Split input into command path for tree traversal
+     *
+     * @param input - User input (with or without leading /)
+     * @returns Array of command path segments
+     *
+     * @example
+     * ```typescript
+     * toPath('/models list --verbose')
+     * // => ['models', 'list']
+     *
+     * toPath('session checkpoint')
+     * // => ['session', 'checkpoint']
+     * ```
+     */
+    static toPath(input: string): string[];
+}
+/**
+ * Convenience function for parsing commands
+ */
+export declare function parseSlashCommand(input: string): ParsedCommand;
+//# sourceMappingURL=SlashCommandParser.d.ts.map

package/dist/commands/SlashCommandParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandParser.d.ts","sourceRoot":"","sources":["../../src/commands/SlashCommandParser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAmD1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAmDvC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAsD7B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAK/C;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;QACrC,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;IA8BD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAqC5C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAMvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAE9D"}