/**
* Unified Command Parser
*
* Robust multi-strategy command parsing system that replaces fragile regex-based parsing
* with intelligent format detection, fallback strategies, and comprehensive validation.
*
* Features:
* - Multi-format detection (simple >>prompt, JSON objects, structured commands)
* - Fallback parsing strategies with confidence scoring
* - Comprehensive error messages with suggestions
* - Command validation and sanitization
*/
import { Logger } from '../../logging/index.js';
import type { ConvertedPrompt } from '../../types/index.js';
import type { CommandParseResultBase } from './types/command-parse-types.js';
import type { ExecutionPlan, OperatorDetectionResult } from './types/operator-types.js';
export type CommandParseResult = CommandParseResultBase<OperatorDetectionResult, ExecutionPlan>;
/**
* Unified Command Parser Class
*/
export declare class UnifiedCommandParser {
private logger;
private strategies;
private symbolicParser;
private stats;
constructor(logger: Logger);
/**
* Normalize >> prefixes in symbolic commands for consistent parsing.
*
* The >> prefix serves as a hint to LLMs that this is an MCP tool command,
* but it should not interfere with symbolic operator detection.
*
* Normalization rules:
* - Strips >> after chain operators: `--> >>prompt` → `--> prompt`
* - Strips >> after parallel operators: `+ >>prompt` → `+ prompt`
* - Strips >> after conditional operators: `: >>branch` → `: branch`
* - Strips >> before @ framework operator: `>> @framework` → `@framework`
*
* Note: >> at the start of simple commands is handled by individual strategies.
*
* @param command - The raw command string
* @returns Normalized command, original command, and normalization flag
*/
private normalizeSymbolicPrefixes;
/**
* Extracts a single execution modifier prefix (e.g., %clean) from the command.
* Returns the command with the modifier stripped and the normalized modifier value.
*/
private extractModifier;
private buildModifiers;
/**
* Parse command string using multi-strategy approach
*/
parseCommand(command: string, availablePrompts: ConvertedPrompt[]): Promise<CommandParseResult>;
private applyCommandType;
/**
* Initialize parsing strategies (STREAMLINED: 2 core strategies)
*/
private initializeStrategies;
private createSymbolicCommandStrategy;
/**
* Simple command strategy: >>prompt_name arguments (ENHANCED: More AI-friendly)
*/
private createSimpleCommandStrategy;
/**
* JSON command strategy: {"command": ">>prompt", "args": {...}}
*/
private createJsonCommandStrategy;
/**
* Validate that the prompt ID exists in available prompts
*/
private validatePromptExists;
/**
* Check if command is a built-in system command
*/
private isBuiltinCommand;
/**
* Generate hint for built-in commands that might have been mistyped
*/
private getBuiltinCommandHint;
/**
* Generate helpful prompt suggestions for typos
*/
private generatePromptSuggestions;
/**
* Simple Levenshtein distance calculation
*/
private levenshteinDistance;
/**
* Generate helpful error message for parsing failures
*/
private generateHelpfulError;
/**
* Update strategy usage statistics
*/
private updateStrategyStats;
/**
* Update confidence statistics
*/
private updateConfidenceStats;
/**
* Get parsing statistics for monitoring
*/
getStats(): typeof this.stats;
/**
* Reset statistics (useful for testing or fresh starts)
*/
resetStats(): void;
}
/**
* Factory function to create unified command parser
*/
export declare function createUnifiedCommandParser(logger: Logger): UnifiedCommandParser;
