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 ShellPromptHandlingOutput, type ShellPromptHandlingRequest, type ShellPromptHandlingResult } from "./core.js";
import { type ShellPromptHandlingDependencies, type ShellPromptHandlingPracticeProviderName, type ShellPromptHandlingProvider, type ShellPromptHandlingProviderPractice } from "./dependencies.js";
export type ShellPromptHandlingBestPracticeRequest = ShellPromptHandlingRequest & {
    executor?: BaseToolExecutorPort;
    preferredProvider?: ShellPromptHandlingPracticeProviderName;
    provider?: ShellPromptHandlingProvider;
};
export type ShellPromptHandlingHandlerInput = Omit<ShellPromptHandlingBestPracticeRequest, "executor">;
export type ShellPromptHandlingPracticeSelection = {
    providerName: ShellPromptHandlingPracticeProviderName;
    practice: ShellPromptHandlingProviderPractice;
    provider?: ShellPromptHandlingProvider;
};
export declare const promptHandlingProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code terminal interaction practice keeps session ownership in the host runtime";
        readonly path: "/home/proview/.claude";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Praxis baseTools shape and audit the request; runtime owns session/process policy and side effects.", "Provider dispatch is only used after context.dryRun is false and runtime governance is affirmative.", "This adapter is host-executor based; it does not claim an SDK-owned prompt loop or hidden shell fallback."];
    readonly createProvider: ({ provider, executor }: ShellPromptHandlingDependencies) => ShellPromptHandlingProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex shell tool routing keeps execution and terminal interaction in a governed host 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 ["Praxis baseTools shape and audit the request; runtime owns session/process policy and side effects.", "Provider dispatch is only used after context.dryRun is false and runtime governance is affirmative.", "This adapter is host-executor based; it does not claim an SDK-owned prompt loop or hidden shell fallback."];
    readonly createProvider: ({ provider, executor }: ShellPromptHandlingDependencies) => ShellPromptHandlingProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI shell interaction practice delegates process/session side effects to the CLI runtime";
        readonly path: "/home/proview/Desktop/three/gemini-cli";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Praxis baseTools shape and audit the request; runtime owns session/process policy and side effects.", "Provider dispatch is only used after context.dryRun is false and runtime governance is affirmative.", "This adapter is host-executor based; it does not claim an SDK-owned prompt loop or hidden shell fallback."];
    readonly createProvider: ({ provider, executor }: ShellPromptHandlingDependencies) => ShellPromptHandlingProvider | undefined;
}];
export declare const promptHandlingBestPracticeDescriptor: {
    readonly toolId: "shell.promptHandling";
    readonly bestPractice: "runtime-execEngine-shellInteraction-handlePrompt";
    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 selectShellPromptHandlingPractice(dependencies?: ShellPromptHandlingDependencies & {
    preferredProvider?: ShellPromptHandlingPracticeProviderName;
}): ShellPromptHandlingPracticeSelection;
export declare function executeShellPromptHandling(request?: ShellPromptHandlingBestPracticeRequest): Promise<ShellPromptHandlingResult>;
export declare const promptHandlingBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellPromptHandlingHandlerInput, ShellPromptHandlingOutput>;
export declare const promptHandlingHandler: BaseToolHandler<ShellPromptHandlingHandlerInput, ShellPromptHandlingOutput>;
