import type { Skill } from "@earendil-works/pi-coding-agent";
import type { ActionGuardConfig } from "./config.js";
export interface SkillReadRequest {
    skill: Skill;
    cwd: string;
    action: ActionGuardConfig;
    maxBytes: number;
    signal: AbortSignal;
    disclosed: string;
}
export type SkillReadResult = {
    ok: true;
    body: string;
    bytes: number;
    digest: string;
    notice: boolean;
} | {
    ok: false;
    reason: "load_denied" | "load_too_large" | "load_changed" | "load_failed" | "metadata_unsafe" | "timeout";
};
export declare function skillPathPolicy(skill: Skill, cwd: string, action: ActionGuardConfig, resolved?: string): {
    allowed: boolean;
    notice: boolean;
};
/** Narrow catalog read, not an agent tool call and not a filesystem sandbox. */
export declare function readTrustedSkill(request: SkillReadRequest): Promise<SkillReadResult>;