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 { executeShellInvocation as executeShellInvocationCore, type ShellInvocationExecutionOutput, type ShellInvocationExecutionProvider, type ShellInvocationExecutionRequest } from "./core.js";
import { type ShellInvocationExecutionDependencies, type ShellInvocationExecutionPracticeProviderName, type ShellInvocationExecutionProviderPractice } from "./dependencies.js";
export * from "./core.js";
export type ShellInvocationExecutionBestPracticeRequest = ShellInvocationExecutionRequest & {
    executor?: BaseToolExecutorPort;
    preferredProvider?: ShellInvocationExecutionPracticeProviderName;
};
export type ShellInvocationExecutionHandlerInput = Omit<ShellInvocationExecutionBestPracticeRequest, "executor">;
export type ShellInvocationExecutionPracticeSelection = {
    providerName: ShellInvocationExecutionPracticeProviderName;
    practice: ShellInvocationExecutionProviderPractice;
    provider?: ShellInvocationExecutionProvider;
};
export declare const shellInvocationExecutionProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code 2.1.88 BashTool invocation-to-shell execution boundary";
        readonly path: "/home/proview/Desktop/three/claude_code_2_1_88/tools/BashTool";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Claude Code models shell work as governed tool invocations rather than raw process calls.", "Praxis keeps invocation object normalization in baseTools and delegates actual execution to runtime."];
    readonly createProvider: ({ provider, executor }: ShellInvocationExecutionDependencies) => ShellInvocationExecutionProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex Rust 0.123.0 exec request routing into a governed shell backend";
        readonly path: "/home/proview/Desktop/three/codex_rust_0_123_0/codex-rs/core/src/tools";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Codex separates model-visible tool requests from the host-side command executor.", "Praxis uses the same split: invocation objects are shaped here, while runtime owns execution policy."];
    readonly createProvider: ({ provider, executor }: ShellInvocationExecutionDependencies) => ShellInvocationExecutionProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI 0.39.0 shell tool request and confirmation pattern";
        readonly path: "/home/proview/Desktop/three/gemini_cli_0_39_0/packages/core/src/tools/shell.ts";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Gemini CLI contributes confirmation and shell-tool routing practice.", "Praxis adapts that practice through a shared runtime shell executor instead of embedding policy locally."];
    readonly createProvider: ({ provider, executor }: ShellInvocationExecutionDependencies) => ShellInvocationExecutionProvider | undefined;
}];
export declare const shellInvocationExecutionBestPracticeDescriptor: {
    readonly toolId: "shell.invocationExecution";
    readonly bestPractice: "runtime-execEngine-shellExecutor";
    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 function selectShellInvocationExecutionPractice(dependencies?: ShellInvocationExecutionDependencies & {
    preferredProvider?: ShellInvocationExecutionPracticeProviderName;
}): ShellInvocationExecutionPracticeSelection;
export declare function executeShellInvocation(request?: ShellInvocationExecutionBestPracticeRequest): ReturnType<typeof executeShellInvocationCore>;
export declare const shellInvocationExecutionBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellInvocationExecutionHandlerInput, ShellInvocationExecutionOutput>;
export declare const shellInvocationExecutionHandler: BaseToolHandler<ShellInvocationExecutionHandlerInput, ShellInvocationExecutionOutput>;
