import { AstroIntegration } from 'astro';

interface MarkdownForAgentsOptions {
    /**
     * Additional User-Agent substrings to recognise as AI agents.
     * These are appended to the built-in list in `src/utils.ts`.
     *
     * @example
     * markdownForAgents({ additionalAgents: ['MyCustomBot'] })
     */
    additionalAgents?: string[];
    /**
     * Automatically generate an `llms.txt` index file in the build directory.
     * Defaults to `true`.
     */
    generateLlmsTxt?: boolean;
    /**
     * Title for the `llms.txt` file. Defaults to "Website Documentation".
     */
    siteTitle?: string;
    /**
     * Description for the `llms.txt` file. Defaults to "Markdown documentation for AI agents."
     */
    siteDescription?: string;
}
/**
 * Astro integration: `astro-markdown-for-agents`
 *
 * Adds middleware that detects AI-agent requests and automatically returns
 * a Markdown version of the page — no Cloudflare paid plan required.
 *
 * @example
 * ```js
 * // astro.config.mjs
 * import { defineConfig } from 'astro/config';
 * import cloudflare from '@astrojs/cloudflare';
 * import markdownForAgents from '@puralex/astro-markdown-for-agents';
 *
 * export default defineConfig({
 *   adapter: cloudflare(),
 *   integrations: [markdownForAgents()],
 * });
 * ```
 */
declare function markdownForAgents(options?: MarkdownForAgentsOptions): AstroIntegration;

export { type MarkdownForAgentsOptions, markdownForAgents as default, markdownForAgents };