/** Bounded, read-only context tools exposed to the compiler agent. */
import type { ProjectProfileV1, WorkspaceProfileV1 } from "../tools/analysis/analyzer-types.ts";
import { ContextRequestSession, type ContextCandidateV1, type OfficialDocumentationCandidateV1 } from "./context.ts";
export declare class CompilerToolError extends Error {
    readonly code: string;
    constructor(code: string, message: string);
}
export interface CompilerToolExecutorOptions {
    maximumRequests?: number;
    maximumFiles?: number;
    maximumFileBytes?: number;
    /** Project-relative files/directories forbidden by operator privacy policy. */
    excludedPaths?: readonly string[];
    /** Path-segment names omitted from ordinary project context searches. */
    ignoredNames?: readonly string[];
    /** Restrict requests to workspaces targeted by the current run. */
    allowedWorkspaceIds?: readonly string[];
    officialDocumentation?: (request: {
        workspace: WorkspaceProfileV1;
        dependency: string;
        version: string;
        reason: string;
    }) => Promise<OfficialDocumentationCandidateV1 | undefined>;
}
export declare class CompilerToolExecutor {
    #private;
    readonly session: ContextRequestSession;
    constructor(root: string, profile: ProjectProfileV1, options?: CompilerToolExecutorOptions);
    execute(value: unknown): Promise<ContextCandidateV1[]>;
}
export declare function compilerToolPolicy(): ReadonlyArray<{
    name: string;
    authority: string;
}>;
//# sourceMappingURL=compiler-tools.d.ts.map