/**
 * Copyright 2025 Vybestack LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/**
 * Shared utility functions for tool name validation and normalization
 *
 * This module provides common tool name handling logic extracted from:
 * - SubAgent's normalizeToolName function (lines 1666-1685)
 * - ToolNameValidator class
 * - Various OpenAI provider implementations
 *
 * Purpose: Eliminate code duplication across turn.ts, OpenAIProvider.ts,
 * and ToolNameValidator.ts while maintaining the proven logic from SubAgent.
 */
/**
 * Normalize tool name using SubAgent's proven logic
 * Based on subagent.ts:1666-1685
 */
export declare function normalizeToolName(rawName: string): string | null;
/**
 * Convert string to snake_case (from SubAgent)
 */
export declare function toSnakeCase(value: string): string;
/**
 * Validate if a tool name follows proper naming conventions
 */
export declare function isValidToolName(name: string): boolean;
/**
 * Find matching tool from available tools with fuzzy matching
 */
export declare function findMatchingTool(normalizedName: string, availableTools: string[]): string | null;
