import { type RouteIndex, type BuildRoutesOpts } from "./agent-router.js";
/**
 * v0.6 §10.5 — reload policy for fs-watcher events.
 *
 * The fs-watcher emits change events; this module decides what to do with
 * them based on `workspace.yaml.fs_watch.mode`:
 *
 *   auto   — call `rebuildRoutes()` immediately + notify user.
 *   prompt — ask the user `🔄 N개 SKILL 변경 감지 — 적용? [y/N]` and wait
 *            for `y`/`n`/timeout. Only `y` triggers rebuild.
 *   manual — emit a notice but do NOT rebuild. User must run
 *            `solosquad agent reload`.
 *
 * Additional safety: when `gitOnly: true`, the policy refuses to apply
 * unless the workspace just had `origin/main` merged into the local branch.
 * The implementation compares the current HEAD to a tracking ref recorded
 * the last time the policy applied — if HEAD advanced AND the most recent
 * commit's parent line includes the previously-tracked origin/main SHA,
 * we consider it a merge boundary.
 */
export type ReloadMode = "auto" | "prompt" | "manual";
export interface ReloadPolicyDecision {
    /** What the policy did: ran reload, deferred to user, or skipped. */
    outcome: "auto" | "prompt" | "manual";
    /** True iff `rebuildRoutes()` actually ran. */
    reloaded: boolean;
    /** Caller can post this to PM channel. Empty when nothing to say. */
    notice: string;
    /** When prompt mode fired, the question text we asked. */
    prompt?: string;
    /** Set when reloaded — the # of triggers after the rebuild. */
    triggerCount?: number;
}
export interface ApplyReloadPolicyOpts {
    mode: ReloadMode;
    /** Absolute paths reported by `startSkillWatcher`. */
    changes: string[];
    /**
     * Only used in `prompt` mode. Caller drives the back-and-forth (ask the
     * user, await answer) and returns `true` for yes / `false` for no/timeout.
     * If omitted in prompt mode, the policy treats it as deferred (`reloaded:
     * false`, `outcome: "prompt"`) and the caller can prompt later.
     */
    onConfirm?: (prompt: string) => Promise<boolean>;
    /** When true, only apply when origin/main has just been merged. */
    gitOnly?: boolean;
    /**
     * `git rev-parse`-style root used for the gitOnly check. Defaults to the
     * workspace from `buildOpts.workspace_root` or `process.cwd()`. Tests
     * inject a fixture path.
     */
    gitRoot?: string;
    /**
     * Forwarded to `rebuildRoutes()` so the router scans the same tiers the
     * watcher did. The bot wires this from its known org slug.
     */
    buildOpts?: BuildRoutesOpts;
    /**
     * Test hook — replace the git probe. Returns whether we consider the
     * current HEAD a "just merged origin/main" state.
     */
    gitProbe?: (root: string) => boolean;
    /** Test hook — replace `rebuildRoutes()`. */
    rebuild?: (opts: BuildRoutesOpts) => RouteIndex;
}
/**
 * Apply the configured reload policy. Pure with respect to the messenger —
 * the caller posts `decision.notice` and (in prompt mode) drives the
 * `onConfirm` callback.
 */
export declare function applyReloadPolicy(opts: ApplyReloadPolicyOpts): Promise<ReloadPolicyDecision>;
export declare function triggerCount(idx: RouteIndex): number;
/**
 * Convenience for callers that just want the "🔄 N개 SKILL 변경" prefix
 * outside the policy decision flow.
 */
export declare function summarizeChanges(changes: string[]): string;