packfs-core/dist/cjs/semantic/intent-processor.d.ts

Semantic filesystem operations for LLM agent frameworks with natural language understanding. See LLM_AGENT_GUIDE.md for copy-paste examples.

/**
 * Intent processing utilities for semantic filesystem operations
 * Handles intent parsing, optimization, and traditional operation conversion
 */
import { FileAccessIntent, ContentUpdateIntent, OrganizationIntent, DiscoveryIntent, RemovalIntent, FileTarget, WorkflowStep } from './types.js';
/**
 * Converts traditional filesystem method calls to semantic intents
 * Enables backward compatibility by translating old-style calls
 */
export declare class TraditionalToSemanticConverter {
    /**
     * Convert readFile() call to FileAccessIntent
     */
    static readFileToIntent(path: string, options?: {
        encoding?: BufferEncoding;
    }): FileAccessIntent;
    /**
     * Convert writeFile() call to ContentUpdateIntent
     */
    static writeFileToIntent(path: string, data: string | Buffer, options?: {
        createDirs?: boolean;
        mode?: number;
    }): ContentUpdateIntent;
    /**
     * Convert stat() call to FileAccessIntent
     */
    static statToIntent(path: string): FileAccessIntent;
    /**
     * Convert exists() call to FileAccessIntent
     */
    static existsToIntent(path: string): FileAccessIntent;
    /**
     * Convert mkdir() call to OrganizationIntent
     */
    static mkdirToIntent(path: string, options?: {
        recursive?: boolean;
    }): OrganizationIntent;
    /**
     * Convert readdir() call to DiscoveryIntent
     */
    static readdirToIntent(path: string, options?: {
        recursive?: boolean;
    }): DiscoveryIntent;
    /**
     * Convert unlink() call to RemovalIntent
     */
    static unlinkToIntent(path: string): RemovalIntent;
}
/**
 * Optimizes and enhances semantic intents based on context and patterns
 */
export declare class SemanticIntentOptimizer {
    /**
     * Optimize FileAccessIntent based on usage patterns
     */
    static optimizeAccessIntent(intent: FileAccessIntent, context?: {
        recentFiles?: string[];
        workingDirectory?: string;
    }): FileAccessIntent;
    /**
     * Optimize DiscoveryIntent to improve search efficiency
     */
    static optimizeDiscoveryIntent(intent: DiscoveryIntent): DiscoveryIntent;
}
/**
 * Analyzes and validates file targets for semantic operations
 */
export declare class FileTargetProcessor {
    /**
     * Resolve FileTarget to concrete file paths
     */
    static resolveTarget(target: FileTarget, basePath?: string): Promise<string[]>;
    /**
     * Validate FileTarget has at least one targeting method
     */
    static validateTarget(target: FileTarget): boolean;
    /**
     * Get target type for optimization decisions
     */
    static getTargetType(target: FileTarget): 'path' | 'pattern' | 'semantic' | 'criteria' | 'mixed';
    private static resolvePath;
}
/**
 * Natural language processing for intent extraction
 */
export declare class NaturalLanguageProcessor {
    /**
     * Parse natural language queries into structured intents
     * This is a simplified implementation - real version would use NLP models
     */
    static parseQuery(query: string): {
        intent: FileAccessIntent | ContentUpdateIntent | OrganizationIntent | DiscoveryIntent | RemovalIntent;
        confidence: number;
    };
    private static extractFileTarget;
    private static extractContent;
}
/**
 * Workflow builder for complex multi-step operations
 */
export declare class WorkflowBuilder {
    private steps;
    private stepCounter;
    /**
     * Add a file access step to the workflow
     */
    addAccess(intent: FileAccessIntent, dependencies?: string[]): string;
    /**
     * Add a content update step to the workflow
     */
    addUpdate(intent: ContentUpdateIntent, dependencies?: string[]): string;
    /**
     * Add an organization step to the workflow
     */
    addOrganize(intent: OrganizationIntent, dependencies?: string[]): string;
    /**
     * Add a discovery step to the workflow
     */
    addDiscover(intent: DiscoveryIntent, dependencies?: string[]): string;
    /**
     * Add a removal step to the workflow
     */
    addRemove(intent: RemovalIntent, dependencies?: string[]): string;
    /**
     * Build the final workflow intent
     */
    build(_options?: {
        atomic?: boolean;
        continueOnError?: boolean;
    }): WorkflowStep[];
    /**
     * Clear all steps and start over
     */
    clear(): void;
}
//# sourceMappingURL=intent-processor.d.ts.map