import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
/**
 * Skills reference module — tells the agent how to discover and use skills.
 *
 * Consolidates skill references, role-based capability descriptions,
 * and catalog location into a single module. Capabilities are scoped
 * per-role to avoid blanket authorization (#225).
 *
 * Sources: Path A Step 1+6, Path B Section 8, Path C skill instructions.
 */
export declare class SkillsReferenceModule implements PromptModule {
    name: string;
    priority: number;
    maxTokens: number;
    compactable: boolean;
    /**
     * Always included — agents need to know how to use skills.
     */
    shouldInclude(_config: ModuleConfig): boolean;
    /**
     * Build the skills reference section with catalog location,
     * role-scoped capabilities, and memory tool instructions.
     *
     * @param config - Module configuration with skill paths and role
     * @returns Formatted markdown skills reference section
     */
    build(config: ModuleConfig): Promise<string>;
    /**
     * Build the core skills list — available to all roles.
     */
    private buildCoreSkills;
    /**
     * Build role-scoped capabilities section (#225).
     * Workers get narrow read+execute scope; orchestrators get broader coordination scope.
     */
    private buildCapabilities;
    /**
     * Build safe skill calling guide for runtimes with shell escaping issues.
     *
     * Gemini CLI's run_shell_command mangles JSON arguments containing quotes,
     * backticks, and parentheses, causing "unexpected EOF" shell errors.
     * This guide instructs the agent to write JSON to a temp file using heredoc
     * with a single-quoted delimiter, then pass --file <path>.
     *
     * Uses `<< 'CREWLY_EOF'` instead of `printf '%s' '...'` because:
     * - Single-quoted heredoc delimiter prevents ALL shell interpretation
     * - Single quotes, double quotes, backticks, $, () all pass through literally
     * - The previous printf approach broke when JSON contained single quotes
     *   (e.g., "it's working" or "don't forget")
     *
     * Only included for gemini-cli runtime type.
     *
     * @param config - Module configuration with runtime type
     * @returns Safe calling guide markdown, or null if not needed
     */
    private buildSafeCallGuide;
    /**
     * Build communication and memory tool instructions.
     */
    private buildCommunication;
}
//# sourceMappingURL=skills-reference.module.d.ts.map