import type { BaseToolHandler } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js";
import type { BaseToolExecutorPort } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolExecutorPort.js";
import { type ShellInvocationConstructionRequest, type ShellInvocationConstructionResult, type ShellInvocationEnvelope } from "./core.js";
import { type ShellInvocationConstructionDependencies, type ShellInvocationConstructionProvider, type ShellInvocationConstructionPracticeProviderName, type ShellInvocationConstructionProviderPractice } from "./dependencies.js";
export type ShellInvocationConstructionBestPracticeRequest = ShellInvocationConstructionRequest & {
    executor?: BaseToolExecutorPort;
    provider?: ShellInvocationConstructionProvider;
    preferredProvider?: ShellInvocationConstructionPracticeProviderName;
};
export type ShellInvocationConstructionHandlerInput = Omit<ShellInvocationConstructionBestPracticeRequest, "executor" | "provider">;
export type ShellInvocationConstructionPracticeSelection = {
    providerName: ShellInvocationConstructionPracticeProviderName;
    practice: ShellInvocationConstructionProviderPractice;
    provider?: ShellInvocationConstructionProvider;
};
export declare const shellInvocationConstructionProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code BashTool invocation envelope before execution";
        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 routes validated BashTool input through a central tool execution path.", "Praxis builds invocation envelopes after command generation and guard classification."];
    readonly createProvider: ({ provider, executor }: ShellInvocationConstructionDependencies) => ShellInvocationConstructionProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex ToolInvocation payload and shell handler ExecParams construction";
        readonly path: "/home/proview/Desktop/three/codex_rust_0_123_0/codex-rs/core/src/tools/handlers/shell.rs";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Codex separates tool invocation payload from runtime ExecParams construction.", "Invocation construction records audit-ready handoff material without executing it."];
    readonly createProvider: ({ provider, executor }: ShellInvocationConstructionDependencies) => ShellInvocationConstructionProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI ShellToolInvocation object before ShellExecutionService call";
        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 holds command params in an invocation object before confirmation and execution.", "Praxis invocation envelopes stay dry-run until a separate execution tool is invoked."];
    readonly createProvider: ({ provider, executor }: ShellInvocationConstructionDependencies) => ShellInvocationConstructionProvider | undefined;
}];
export declare const shellInvocationConstructionBestPracticeDescriptor: {
    readonly toolId: "shell.invocationConstruction";
    readonly bestPractice: "runtime-governed-shell-invocation-construction";
    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: "runtime";
        required: false;
        description: string;
    })[];
};
export declare function selectShellInvocationConstructionPractice(dependencies?: ShellInvocationConstructionDependencies & {
    preferredProvider?: ShellInvocationConstructionPracticeProviderName;
}): ShellInvocationConstructionPracticeSelection;
export declare function constructShellInvocationBestPractice(request?: ShellInvocationConstructionBestPracticeRequest): Promise<ShellInvocationConstructionResult>;
export declare const shellInvocationConstructionBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellInvocationConstructionHandlerInput, ShellInvocationEnvelope>;
export declare const shellInvocationConstructionHandler: BaseToolHandler<ShellInvocationConstructionHandlerInput, ShellInvocationEnvelope>;
