import type { BaseToolHandler } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js";
import { type ShellDetachedExecutionOutput, type ShellDetachedExecutionRequest } from "./core.js";
import type { ShellToolResult } from "../../shellExecution/shell.commandExecution/core.js";
import { type ShellDetachedExecutionDependencies, type ShellDetachedExecutionPracticeProviderName, type ShellDetachedExecutionProvider, type ShellDetachedExecutionProviderPractice } from "./dependencies.js";
export * from "./core.js";
export type ShellDetachedExecutionBestPracticeRequest = ShellDetachedExecutionRequest & {
    executor?: ShellDetachedExecutionDependencies["executor"];
    provider?: ShellDetachedExecutionProvider;
    preferredProvider?: ShellDetachedExecutionPracticeProviderName;
};
export type ShellDetachedExecutionHandlerInput = Omit<ShellDetachedExecutionBestPracticeRequest, "executor" | "provider">;
export type ShellDetachedExecutionPracticeSelection = {
    providerName: ShellDetachedExecutionPracticeProviderName;
    practice: ShellDetachedExecutionProviderPractice;
    provider?: ShellDetachedExecutionProvider;
};
export declare const shellDetachedExecutionProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code shell/process lifecycle practice";
        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 keeps process side effects behind runtime tool governance and permission gates.", "Praxis baseTools keep approval, sandbox, session ownership, and process lifecycle policy in runtime/TAP."];
    readonly createProvider: ({ provider, executor }: ShellDetachedExecutionDependencies) => ShellDetachedExecutionProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex shell/process runtime boundary";
        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 keeps shell/process execution in the host runtime while tool definitions describe call and result envelopes.", "Praxis baseTools keep approval, sandbox, session ownership, and process lifecycle policy in runtime/TAP."];
    readonly createProvider: ({ provider, executor }: ShellDetachedExecutionDependencies) => ShellDetachedExecutionProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI shell/process practice";
        readonly path: "/home/proview/Desktop/three/gemini_cli_0_39_0";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Gemini CLI-style practice keeps long-running shell lifecycle ownership outside model planning.", "Praxis baseTools keep approval, sandbox, session ownership, and process lifecycle policy in runtime/TAP."];
    readonly createProvider: ({ provider, executor }: ShellDetachedExecutionDependencies) => ShellDetachedExecutionProvider | undefined;
}];
export declare const shellDetachedExecutionBestPracticeDescriptor: {
    readonly toolId: "shell.detachedExecution";
    readonly bestPractice: "runtime-governed-process-control";
    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 selectShellDetachedExecutionPractice(dependencies?: ShellDetachedExecutionDependencies & {
    preferredProvider?: ShellDetachedExecutionPracticeProviderName;
}): ShellDetachedExecutionPracticeSelection;
export declare function executeShellDetachedExecution(request?: unknown): Promise<ShellToolResult<ShellDetachedExecutionOutput, string>>;
export declare const shellDetachedExecutionBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellDetachedExecutionHandlerInput, ShellDetachedExecutionOutput>;
export declare const shellDetachedExecutionHandler: BaseToolHandler<ShellDetachedExecutionHandlerInput, ShellDetachedExecutionOutput>;
