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 { executeShellEnvironmentInspection as executeShellEnvironmentInspectionCore, type ShellEnvironmentInspectionOutput, type ShellEnvironmentInspectionProvider, type ShellEnvironmentInspectionRequest } from "./core.js";
import { type ShellEnvironmentInspectionDependencies, type ShellEnvironmentInspectionPracticeProviderName, type ShellEnvironmentInspectionProviderPractice } from "./dependencies.js";
export * from "./core.js";
export type ShellEnvironmentInspectionBestPracticeRequest = ShellEnvironmentInspectionRequest & {
    executor?: BaseToolExecutorPort;
    preferredProvider?: ShellEnvironmentInspectionPracticeProviderName;
};
export type ShellEnvironmentInspectionHandlerInput = Omit<ShellEnvironmentInspectionBestPracticeRequest, "executor">;
export type ShellEnvironmentInspectionPracticeSelection = {
    providerName: ShellEnvironmentInspectionPracticeProviderName;
    practice: ShellEnvironmentInspectionProviderPractice;
    provider?: ShellEnvironmentInspectionProvider;
};
export declare const shellEnvironmentInspectionProviderPractices: readonly [{
    providerName: "anthropic";
    source: {
        kind: "cli";
        label: string;
        path: string;
    };
    directCliSupport: true;
    sideEffectPolicy: "runtime-governed";
    notes: string[];
    createProvider: ({ provider, executor }: ShellEnvironmentInspectionDependencies) => ShellEnvironmentInspectionProvider | undefined;
}, {
    providerName: "openai";
    source: {
        kind: "cli";
        label: string;
        path: string;
    };
    directCliSupport: true;
    sideEffectPolicy: "runtime-governed";
    notes: string[];
    createProvider: ({ provider, executor }: ShellEnvironmentInspectionDependencies) => ShellEnvironmentInspectionProvider | undefined;
}, {
    providerName: "deepmind";
    source: {
        kind: "cli";
        label: string;
        path: string;
    };
    directCliSupport: true;
    sideEffectPolicy: "runtime-governed";
    notes: string[];
    createProvider: ({ provider, executor }: ShellEnvironmentInspectionDependencies) => ShellEnvironmentInspectionProvider | undefined;
}];
export declare function selectShellEnvironmentInspectionPractice(dependencies?: ShellEnvironmentInspectionDependencies & {
    preferredProvider?: ShellEnvironmentInspectionPracticeProviderName;
}): ShellEnvironmentInspectionPracticeSelection;
export declare function executeShellEnvironmentInspection(request?: ShellEnvironmentInspectionBestPracticeRequest): ReturnType<typeof executeShellEnvironmentInspectionCore>;
export declare const shellEnvironmentInspectionBestPracticeDescriptor: {
    readonly toolId: "shell.environmentInspection";
    readonly bestPractice: "runtime-execEngine-shellEnvironmentProvider";
    readonly sourcePriority: readonly ["cli", "agent-sdk", "api-sdk", "praxis-native"];
    readonly providerOrder: readonly ["anthropic", "openai", "deepmind"];
    readonly dependencies: ({
        dependencyId: string;
        kind: "runtime";
        required: true;
        description: string;
    } | {
        dependencyId: string;
        kind: "permission";
        required: true;
        description: string;
    })[];
};
export declare const shellEnvironmentInspectionBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellEnvironmentInspectionHandlerInput, ShellEnvironmentInspectionOutput>;
export declare const shellEnvironmentInspectionHandler: BaseToolHandler<ShellEnvironmentInspectionHandlerInput, ShellEnvironmentInspectionOutput>;
