/**
 * Skill discovery for pi-skills-mention.
 *
 * pi's own discovery covers many roots: `~/.pi/agent/skills`, `<cwd>/.pi/skills`,
 * `~/.agents/skills`, ancestor `.agents/skills`, plus package-provided skills and
 * Claude/Codex legacy dirs. Rather than reimplement all of that, we cache the
 * skills pi itself loaded into the current session (from `before_agent_start`
 * -> `systemPromptOptions.skills`), and fall back to `loadSkills` (the exported
 * discovery helper) seeded with the standard `.agents/skills` roots for the
 * very first turn when the cache is still empty.
 */
import { type Skill } from "@earendil-works/pi-coding-agent";
import { type MentionSkill } from "./skill-registry.js";
/** Called from `before_agent_start` to capture pi's authoritative skill set. */
export declare function captureSessionSkills(skills: readonly Skill[] | undefined): void;
/**
 * Resolve the current mention-addressable skills. Prefers the cached session
 * set; on the first turn falls back to fresh discovery.
 */
export declare function getMentionSkills(cwd: string): Map<string, MentionSkill>;
/** Discover skills via pi's own loader, adding standard `.agents/skills` roots. */
export declare function discoverMentionSkills(cwd: string): Map<string, MentionSkill>;