/**
 * LLMs.txt document generator for CLEO attachments.
 *
 * Reads all attachments on a target owner (task, session, etc.) and
 * produces an llms.txt-format document per the llmstxt.org spec:
 *   https://llmstxt.org
 *
 * Strategy:
 *   1. Try `llmtxt` npm package `generateOverview()` for per-attachment summaries.
 *   2. Fall back to a built-in minimal generator if llmtxt is unavailable:
 *      concat description + first N bytes of content, sectioned per attachment.
 *
 * The generated output is returned as a string.  The caller decides whether
 * to print it, write it to disk, or store it back as an llms-txt attachment.
 *
 * @epic T760
 * @task T798
 */
/** Options for {@link generateDocsLlmsTxt}. */
export interface GenerateDocsOptions {
    /** Owner entity ID (e.g. `"T798"`, `"ses_..."`). */
    ownerId: string;
    /**
     * Maximum number of bytes to inline per attachment when using the built-in
     * fallback generator.
     *
     * @defaultValue 4000
     */
    maxInlineBytes?: number;
    /** Optional working directory for path resolution. */
    cwd?: string;
}
/** Result from {@link generateDocsLlmsTxt}. */
export interface GenerateDocsResult {
    /** Generated llms.txt-format markdown string. */
    content: string;
    /** Number of attachments processed. */
    attachmentCount: number;
    /** Whether the llmtxt package was used (`true`) or the fallback (`false`). */
    usedLlmtxtPackage: boolean;
    /** Per-attachment summaries used to build the document. */
    sections: Array<{
        attachmentId: string;
        sha256Prefix: string;
        description: string;
        summary: string;
    }>;
}
/**
 * Generate an llms.txt-format document summarising all attachments on `ownerId`.
 *
 * Internally uses the `llmtxt` npm package's `generateOverview()` function for
 * structural section analysis. Falls back to a minimal built-in generator when
 * the package is unavailable.
 *
 * @param options - Generation options.
 * @returns Generated document and metadata.
 *
 * @example
 * ```ts
 * const result = await generateDocsLlmsTxt({ ownerId: 'T798' });
 * console.log(result.content); // llms.txt markdown
 * ```
 *
 * @epic T760
 * @task T798
 */
export declare function generateDocsLlmsTxt(options: GenerateDocsOptions): Promise<GenerateDocsResult>;
//# sourceMappingURL=docs-generator.d.ts.map