import type { FactStore } from "./facts-store.js";
export interface KnowledgeIndexSkill {
    key: string;
    name: string;
    description: string;
}
export interface KnowledgeIndexAsk {
    key: string;
    summary: string;
}
export interface KnowledgeIndex {
    skills: KnowledgeIndexSkill[];
    asks: KnowledgeIndexAsk[];
}
export declare function loadKnowledgeIndexFromFactStore(factStore: FactStore, cap?: number, opts?: {
    includeSkills?: boolean;
}): Promise<KnowledgeIndex>;
export declare function buildKnowledgePromptBlocks(knowledgeIndex: KnowledgeIndex, opts?: {
    includeNamespaceRules?: boolean;
}): {
    askBlock?: string;
    skillBlock?: string;
};
export declare function mergePromptBlocks(parts: Array<string | null | undefined>): string | undefined;
/**
 * Enhanced-retrieval instruction block (enhancedfactstore 07 §1.6). Replaces the
 * capped-50 skills PUSH when the store is an EnhancedFactStore with search: the
 * agent PULLS relevant curated skills with `search_skills` when needed,
 * and can retrieve its own memory with `facts_search` / `facts_similar` instead
 * of only literal-key `read_facts` scans. Intake-writing rules are unchanged.
 *
 * `semantic` reflects whether an embedder is available (capabilities.embedder /
 * durable embedder running). When false, the store still offers enhanced
 * lexical search and HYBRID degrades to lexical — so the block must NOT promise
 * semantic recall (an explicit semantic request would error). The retrieval
 * tools are named either way; only the wording about meaning-based recall is
 * gated.
 */
export declare function buildEnhancedRetrievalPromptBlock(opts?: {
    semantic: boolean;
}): string;
/**
 * Graph-reader instruction block (enhancedfactstore 07 §1.5/§1.6). Lights up
 * whenever a graph store is configured — including base-facts + graph. The
 * semantic-seed sentence is included only when the facts axis is enhanced (so a
 * reader can pivot from semantically-found facts into the graph); base-facts +
 * graph still gets the graph read tools, just without that sentence.
 */
export declare function buildGraphReaderPromptBlock(opts: {
    semanticSeed: boolean;
}): string;
//# sourceMappingURL=knowledge-index.d.ts.map