import type { DynamicSkillManifest } from "#context/keys.js";
import type { Announcement } from "#harness/announcements.js";
export interface AvailableSkillDescription {
    readonly description: string;
    readonly name: string;
    /** False when the skill has no sandbox files; its path is omitted. */
    readonly hasFiles?: boolean;
}
/**
 * Formats the "Available skills" section: every skill that isn't deferred,
 * with the instruction to load it. Deferred skills stay out of context until
 * search finds them.
 *
 * A loaded skill's instructions are never injected into the system prompt;
 * the model has them from the result of loading it. The formatter uses the
 * canonical symbolic skill root so supporting files remain discoverable
 * without provisioning a sandbox.
 *
 * Authored skills call this at graph resolution time so the section is part of
 * the turn agent's static instructions. Dynamic skills reuse it for their
 * announcement.
 */
export declare function formatAvailableSkillsSection(skills: readonly AvailableSkillDescription[]): string | null;
/**
 * Announces the dynamic skills that aren't deferred, in full whenever they
 * change. Nothing is announced until the first one resolves. `announced` holds
 * the values announced so far.
 */
export declare function dynamicSkillAnnouncements(manifest: DynamicSkillManifest | undefined, announced: Readonly<Record<string, string>> | undefined): Readonly<Record<string, Announcement>>;
/** Where a skill's `SKILL.md` lives under the model's skill root. */
export declare function skillFilePath(name: string): string;