import { type Tool } from 'ai';
import type { KnowledgeRetriever } from '@contractspec/lib.knowledge/retriever';
import type { AgentKnowledgeRef } from '../spec/spec';
/**
 * Create a knowledge query tool for dynamic RAG.
 *
 * This tool allows the agent to query optional knowledge spaces
 * at runtime. Required knowledge is injected statically via
 * the knowledge injector.
 *
 * @param retriever - The knowledge retriever to use
 * @param knowledgeRefs - Knowledge references from the agent spec
 * @returns AI SDK CoreTool for knowledge queries
 */
export declare function createKnowledgeQueryTool(retriever: KnowledgeRetriever, knowledgeRefs: AgentKnowledgeRef[], locale?: string): Tool<any, any> | null;
