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 ShellScriptGenerationOutput, type ShellScriptGenerationRequest, type ShellScriptGenerationResult } from "./core.js";
import { type ShellScriptGenerationDependencies, type ShellScriptGenerationProvider, type ShellScriptGenerationPracticeProviderName, type ShellScriptGenerationProviderPractice } from "./dependencies.js";
export type ShellScriptGenerationBestPracticeRequest = ShellScriptGenerationRequest & {
    executor?: BaseToolExecutorPort;
    provider?: ShellScriptGenerationProvider;
    preferredProvider?: ShellScriptGenerationPracticeProviderName;
};
export type ShellScriptGenerationHandlerInput = Omit<ShellScriptGenerationBestPracticeRequest, "executor" | "provider">;
export type ShellScriptGenerationPracticeSelection = {
    providerName: ShellScriptGenerationPracticeProviderName;
    practice: ShellScriptGenerationProviderPractice;
    provider?: ShellScriptGenerationProvider;
};
export declare const shellScriptGenerationProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code shell script planning before governed BashTool 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 BashTool prompt and helpers treat multi-step shell work as command material requiring review.", "Praxis creates script text only; execution remains a separate runtime-governed primitive."];
    readonly createProvider: ({ provider, executor }: ShellScriptGenerationDependencies) => ShellScriptGenerationProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex shell runtime command construction and approval boundary";
        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 keeps shell runtime construction behind tool handler and approval logic.", "Generated script material is returned as auditable dry-run output."];
    readonly createProvider: ({ provider, executor }: ShellScriptGenerationDependencies) => ShellScriptGenerationProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI shell command wrapping and confirmation boundary";
        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 wraps shell commands for lifecycle handling while keeping confirmation separate.", "Script generation remains pure and declares TAP approval needs in output."];
    readonly createProvider: ({ provider, executor }: ShellScriptGenerationDependencies) => ShellScriptGenerationProvider | undefined;
}];
export declare const shellScriptGenerationBestPracticeDescriptor: {
    readonly toolId: "shell.scriptGeneration";
    readonly bestPractice: "runtime-governed-shell-script-generation";
    readonly sourcePriority: readonly ["cli", "agent-sdk", "api-sdk", "praxis-native"];
    readonly providerOrder: readonly ["anthropic", "openai", "deepmind"];
    readonly dependencies: ({
        dependencyId: string;
        kind: "permission";
        required: true;
        description: string;
    } | {
        dependencyId: string;
        kind: "runtime";
        required: false;
        description: string;
    })[];
};
export declare function selectShellScriptGenerationPractice(dependencies?: ShellScriptGenerationDependencies & {
    preferredProvider?: ShellScriptGenerationPracticeProviderName;
}): ShellScriptGenerationPracticeSelection;
export declare function generateShellScriptPlanBestPractice(request?: ShellScriptGenerationBestPracticeRequest): Promise<ShellScriptGenerationResult>;
export declare const shellScriptGenerationBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellScriptGenerationHandlerInput, ShellScriptGenerationOutput>;
export declare const shellScriptGenerationHandler: BaseToolHandler<ShellScriptGenerationHandlerInput, ShellScriptGenerationOutput>;
