/**
 * @license
 * Copyright 2025 Vybestack LLC
 * SPDX-License-Identifier: Apache-2.0
 */
import { type PolicyRule, type ApprovalMode } from './types.js';
/**
 * Types of errors that can occur while loading policy files.
 */
export type PolicyFileErrorType = 'file_read' | 'toml_parse' | 'schema_validation' | 'rule_validation' | 'regex_compilation';
/**
 * Detailed error information for policy file loading failures.
 */
export interface PolicyFileError {
    filePath: string;
    fileName: string;
    tier: 'default' | 'user' | 'admin';
    ruleIndex?: number;
    errorType: PolicyFileErrorType;
    message: string;
    details?: string;
    suggestion?: string;
}
/**
 * Result of loading policies from TOML files.
 */
export interface PolicyLoadResult {
    rules: PolicyRule[];
    errors: PolicyFileError[];
}
/**
 * Escapes special regex characters in a string for use in a regex pattern.
 * This is used for commandPrefix to ensure literal string matching.
 *
 * @param str The string to escape
 * @returns The escaped string safe for use in a regex
 */
export declare function escapeRegex(str: string): string;
/**
 * Loads and parses policies from TOML files in the specified directories.
 *
 * This function:
 * 1. Scans directories for .toml files
 * 2. Parses and validates each file
 * 3. Transforms rules (commandPrefix, arrays, mcpName, priorities)
 * 4. Filters rules by approval mode
 * 5. Collects detailed error information for any failures
 *
 * @param approvalMode The current approval mode (for filtering rules by mode)
 * @param policyDirs Array of directory paths to scan for policy files
 * @param getPolicyTier Function to determine tier (1-3) for a directory
 * @returns Object containing successfully parsed rules and any errors encountered
 */
export declare function loadPoliciesFromToml(approvalMode: ApprovalMode, policyDirs: string[], getPolicyTier: (dir: string) => number): Promise<PolicyLoadResult>;
/**
 * Loads policies from a single TOML file.
 * Simplified loader for test use cases that validates priorities and throws on errors.
 *
 * @param filePath Path to the TOML file
 * @param tier Optional tier (defaults to 1 for default tier)
 * @returns Array of PolicyRule objects
 * @throws Error if TOML parsing fails, schema validation fails, or priority is invalid
 */
export declare function loadPolicyFromToml(filePath: string, tier?: number): Promise<PolicyRule[]>;
/**
 * Loads default policies from the built-in policies directory.
 * Uses the ApprovalMode.DEFAULT mode filter.
 *
 * @returns Array of PolicyRule objects from all default TOML files
 */
export declare function loadDefaultPolicies(): Promise<PolicyRule[]>;