/**
 * Packaged skill helpers.
 *
 * Packaged skills advertise supporting files that are not loaded into
 * context until the model explicitly calls `read` with a packaged-skill
 * path.  This keeps the context window small while still making rich
 * resources available on demand.
 */
import type { PackagedSkillDirectory } from './types.js';
/**
 * Format a canonical read path for a file inside a packaged skill.
 */
export declare function formatPackagedSkillFilePath(skillId: string, filePath: string): string;
/**
 * Read a packaged skill file by its full advertised path.
 * Returns `undefined` when the path does not belong to any registered
 * packaged skill.
 *
 * - Text files are returned as plain UTF-8.
 * - Binary files are returned as base64 wrapped with line breaks.
 */
export declare function readPackagedSkillFile(packagedSkills: Record<string, PackagedSkillDirectory>, path: string): string | undefined;
/**
 * Check whether a path is a packaged skill path.
 */
export declare function isPackagedSkillPath(path: string): boolean;
/**
 * Build the resource-list footer appended to a skill activation when the
 * skill carries a packaged directory.  The model can read individual files
 * via the `read` tool using the advertised paths.
 */
export declare function formatPackagedSkillResourceList(packaged: PackagedSkillDirectory): string;
//# sourceMappingURL=skills.d.ts.map