import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import type { VaultMemoryApi } from './cloud.js';
import { skillContextSection } from './skill-context.js';
export { skillContextSection };
export declare const SKILL_TEXT_MAX: number;
export interface SkillToolOptions {
    cwd?: () => string;
    fetch?: typeof fetch;
    userHome?: string;
    maxChars?: number;
}
type Folder = {
    id: string;
    parentId: string | null;
    name: string;
    path: string;
    depth: number;
    skillCount: number;
};
type Summary = {
    id: string;
    name: string;
    description: string;
    folderId: string | null;
    folderPath: string | null;
    projectIds: string[];
    scope?: string;
    latestVersion: {
        id: string;
    } | null;
};
export declare function page(text: string, offset?: number, max?: number): {
    text: string;
    offset: number;
    nextOffset: number | null;
    truncated: boolean;
};
export declare function loadFolders(cloud: VaultMemoryApi): Promise<Folder[]>;
/** Caminho "a/b" → id da pasta ('' ou '/' = raiz → null). */
export declare function folderByPath(folders: Folder[], path: string): Folder | null | undefined;
/** Aceita o id da skill, `pasta/sub/nome` ou só `nome` (quando for único). */
export declare function resolveSkill(cloud: VaultMemoryApi, ref: string): Promise<Summary | {
    id: string;
}>;
export declare function currentProject(cloud: VaultMemoryApi, cwd: string): Promise<{
    id: string;
    name: string;
} | null>;
export declare const SKILL_TARGETS: readonly ["claude", "grok", "agents"];
export type SkillTarget = typeof SKILL_TARGETS[number];
export declare function targetRoot(target: SkillTarget, userHome?: string): string;
export declare function registerSkillTools(server: McpServer, home: string, cloud: VaultMemoryApi, options?: SkillToolOptions): void;