import { ToolDefinition } from '@conveniencepro/ctp-core';

/**
 * ConveniencePro Tool Protocol (CTP) - LLMs.txt Generator
 *
 * Generate llms.txt and llms-full.txt files for LLM context injection.
 * These files provide tool information in a format optimized for LLM consumption.
 *
 * @module @conveniencepro/ctp-discovery/llms-txt
 */

/**
 * Options for LLMs.txt generation
 */
interface LLMsTxtGeneratorOptions {
    /** Service name */
    name?: string;
    /** Service description */
    description?: string;
    /** Base URL */
    baseUrl?: string;
    /** Path prefix for tool endpoints */
    pathPrefix?: string;
    /** Include full parameter details */
    fullDetails?: boolean;
    /** Include examples */
    includeExamples?: boolean;
    /** Maximum line width (for wrapping) */
    maxLineWidth?: number;
    /** Group tools by category */
    groupByCategory?: boolean;
}
/**
 * Generate llms.txt content (concise version)
 */
declare function generateLLMsTxt(tools: ToolDefinition[], options?: LLMsTxtGeneratorOptions): string;
/**
 * Generate llms-full.txt content (detailed version)
 */
declare function generateLLMsFullTxt(tools: ToolDefinition[], options?: LLMsTxtGeneratorOptions): string;
/**
 * Generate Markdown documentation for tools
 */
declare function generateToolsMarkdown(tools: ToolDefinition[], options?: LLMsTxtGeneratorOptions): string;

export { type LLMsTxtGeneratorOptions, generateLLMsFullTxt, generateLLMsTxt, generateToolsMarkdown };