/**
 * Rule bucketing
 *
 * Single funnel that every discovered rule passes through on its way into a
 * session. It applies the user's disable levers, registers TTSR rules with the
 * manager, and splits the rest into the always-apply and rulebook buckets.
 *
 * Precedence (matches docs/rulebook-matching-pipeline.md §5):
 *   1. disabledRules  — dropped before any bucket assignment
 *   2. builtin drop   — `builtinRules === false` drops `builtin-defaults` rules
 *   3. agents scope   — rules whose `agents` globs do not match `options.agentName` are dropped
 *   4. TTSR           — non-empty `condition`/`astCondition`/`question` the manager already tracks or newly accepts
 *   5. always         — `alwaysApply === true`
 *   6. rulebook       — has a `description`
 */
import type { TtsrManager } from "../export/ttsr.js";
import { type Rule } from "./rule.js";
export interface RuleBuckets {
    rulebookRules: Rule[];
    alwaysApplyRules: Rule[];
}
export interface BucketRulesOptions {
    /** Rule names to drop entirely (bundled defaults and user rules alike). */
    disabledRules?: readonly string[];
    /** When false, drop every rule from the bundled `builtin-defaults` provider. */
    builtinRules?: boolean;
    /**
     * Agent this session runs as: `"main"` for a top-level session, otherwise the
     * agent definition name. Rules whose `agents` globs do not match are dropped
     * from every bucket. Omit to disable agent scoping (CLI inventory listings).
     */
    agentName?: string;
    /** Replace existing TTSR registrations before bucketing this complete rule snapshot. */
    replaceTtsrRules?: boolean;
}
/**
 * Filter and bucket rules, registering TTSR rules on `ttsrManager` as a side
 * effect. Disabled rules are dropped before any bucket assignment, so a
 * disabled rule is neither matched as TTSR nor surfaced via `rule://`.
 */
export declare function bucketRules(rules: readonly Rule[], ttsrManager: TtsrManager, options?: BucketRulesOptions): RuleBuckets;