import type { KlawConfig } from "../../config/types.klaw.js";
import { type Skill } from "./skill-contract.js";
import type { SkillEligibilityContext, SkillEntry, SkillSnapshot } from "./types.js";
declare function compactHomePath(filePath: string, homes: readonly string[]): string;
/**
 * Compact skill catalog: name + location only (no description).
 * Used as a fallback when the full format exceeds the char budget,
 * preserving awareness of all skills before resorting to dropping.
 */
export declare function formatSkillsCompact(skills: Skill[]): string;
export declare function buildWorkspaceSkillSnapshot(workspaceDir: string, opts?: WorkspaceSkillBuildOptions & {
    snapshotVersion?: number;
}): SkillSnapshot;
export declare function buildWorkspaceSkillsPrompt(workspaceDir: string, opts?: WorkspaceSkillBuildOptions): string;
export declare const testing: {
    compactHomePath: typeof compactHomePath;
};
type WorkspaceSkillBuildOptions = {
    config?: KlawConfig;
    managedSkillsDir?: string;
    bundledSkillsDir?: string;
    entries?: SkillEntry[];
    agentId?: string;
    /** If provided, only include skills with these names */
    skillFilter?: string[];
    eligibility?: SkillEligibilityContext;
};
export declare function resolveSkillsPromptForRun(params: {
    skillsSnapshot?: SkillSnapshot;
    entries?: SkillEntry[];
    config?: KlawConfig;
    workspaceDir: string;
    agentId?: string;
}): string;
export declare function loadWorkspaceSkillEntries(workspaceDir: string, opts?: {
    config?: KlawConfig;
    managedSkillsDir?: string;
    bundledSkillsDir?: string;
    pluginSkillsDir?: string;
    skillFilter?: string[];
    agentId?: string;
    eligibility?: SkillEligibilityContext;
}): SkillEntry[];
export declare function loadVisibleWorkspaceSkillEntries(workspaceDir: string, opts?: {
    config?: KlawConfig;
    managedSkillsDir?: string;
    bundledSkillsDir?: string;
    skillFilter?: string[];
    agentId?: string;
    eligibility?: SkillEligibilityContext;
}): SkillEntry[];
export declare function syncSkillsToWorkspace(params: {
    sourceWorkspaceDir: string;
    targetWorkspaceDir: string;
    config?: KlawConfig;
    skillFilter?: string[];
    agentId?: string;
    eligibility?: SkillEligibilityContext;
    managedSkillsDir?: string;
    bundledSkillsDir?: string;
}): Promise<void>;
export declare function filterWorkspaceSkillEntries(entries: SkillEntry[], config?: KlawConfig): SkillEntry[];
export declare function filterWorkspaceSkillEntriesWithOptions(entries: SkillEntry[], opts?: {
    config?: KlawConfig;
    skillFilter?: string[];
    eligibility?: SkillEligibilityContext;
}): SkillEntry[];
export { testing as __testing };