import type { BaseToolExecutorPort } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolExecutorPort.js";
import type { BaseToolHandler } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js";
import { executeCodeScan as executeCodeScanCore, type CodeScanOutput, type CodeScanProvider, type CodeScanRequest } from "./core.js";
import { type CodeScanDependencies, type CodeScanPracticeProviderName, type CodeScanProviderPractice } from "./dependencies.js";
export * from "./core.js";
export type CodeScanBestPracticeRequest = CodeScanRequest & {
    executor?: BaseToolExecutorPort;
    preferredProvider?: CodeScanPracticeProviderName;
};
export type CodeScanHandlerInput = Omit<CodeScanBestPracticeRequest, "executor">;
export type CodeScanPracticeSelection = {
    providerName: CodeScanPracticeProviderName;
    practice: CodeScanProviderPractice;
    provider?: CodeScanProvider;
};
export declare const codeScanProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code 2.1.88 Glob and directory-discovery practice";
        readonly path: "/home/proview/Desktop/three/claude_code_2_1_88/tools/GlobTool";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "read-only";
    readonly notes: readonly ["Claude Code separates file discovery into named tools rather than requiring shell directory commands.", "Praxis keeps scan semantics in storage and only asks runtime for directory listing support."];
    readonly createProvider: ({ provider, executor }: CodeScanDependencies) => CodeScanProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex Rust list_dir handler with depth, offset, and limit";
        readonly path: "/home/proview/Desktop/three/codex_rust_0_125_0/codex-rs/core/src/tools/handlers/list_dir.rs";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "read-only";
    readonly notes: readonly ["Codex contributes depth, pagination, sorting, symlink marking, and sandbox-aware listing boundaries.", "Praxis keeps depth/pagination semantics in code.scan core and uses runtime filesystem.list as support."];
    readonly createProvider: ({ provider, executor }: CodeScanDependencies) => CodeScanProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI 0.39.0 ls and glob tools";
        readonly path: "/home/proview/Desktop/three/gemini_cli_0_39_0/packages/core/src/tools/ls.ts";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "read-only";
    readonly notes: readonly ["Gemini contributes workspace-aware listing, ignore filtering, and glob discovery behavior.", "Praxis keeps scan result shaping in storage while runtime provides concrete list operations."];
    readonly createProvider: ({ provider, executor }: CodeScanDependencies) => CodeScanProvider | undefined;
}];
export declare const codeScanBestPracticeDescriptor: {
    readonly toolId: "code.scan";
    readonly bestPractice: "storage-owned-code-scan-with-runtime-filesystem-support";
    readonly sourcePriority: readonly ["cli", "agent-sdk", "api-sdk", "praxis-native"];
    readonly providerOrder: readonly ["anthropic", "openai", "deepmind"];
    readonly dependencies: ({
        dependencyId: string;
        kind: "filesystem";
        required: true;
        description: string;
    } | {
        dependencyId: string;
        kind: "permission";
        required: true;
        description: string;
    } | {
        dependencyId: string;
        kind: "runtime";
        required: true;
        description: string;
    })[];
};
export declare function selectCodeScanPractice(dependencies?: CodeScanDependencies & {
    preferredProvider?: CodeScanPracticeProviderName;
}): CodeScanPracticeSelection;
export declare function executeCodeScan(request?: CodeScanBestPracticeRequest): ReturnType<typeof executeCodeScanCore>;
export declare const codeScanBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<CodeScanHandlerInput, CodeScanOutput>;
export declare const codeScanHandler: BaseToolHandler<CodeScanHandlerInput, CodeScanOutput>;
