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 { type ShellPermissionControlOutput, type ShellPermissionControlRequest, type ShellPermissionControlResult } from "./core.js";
import { type ShellPermissionControlDependencies, type ShellPermissionControlProvider, type ShellPermissionControlProviderPractice, type ShellPermissionControlPracticeProviderName } from "./dependencies.js";
export * from "./core.js";
export type ShellPermissionControlBestPracticeRequest = ShellPermissionControlRequest & {
    executor?: BaseToolExecutorPort;
    preferredProvider?: ShellPermissionControlPracticeProviderName;
    provider?: ShellPermissionControlProvider;
};
export type ShellPermissionControlHandlerInput = Omit<ShellPermissionControlBestPracticeRequest, "executor">;
export type ShellPermissionControlPracticeSelection = {
    providerName: ShellPermissionControlPracticeProviderName;
    practice: ShellPermissionControlProviderPractice;
    provider?: ShellPermissionControlProvider;
};
export declare const shellPermissionControlProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Claude Code BashTool permission and approval gating";
        readonly path: "/home/proview/Desktop/three/claude_code_2_1_88/tools/BashTool";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Praxis records permission decisions; TAP/runtime owns final approval and policy enforcement."];
    readonly createProvider: ({ provider, executor }: ShellPermissionControlDependencies) => ShellPermissionControlProvider | undefined;
}, {
    readonly providerName: "openai";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Codex shell permission prompt and approval boundary";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Permission control emits a dry-run decision envelope and does not dispatch shell execution."];
    readonly createProvider: ({ provider, executor }: ShellPermissionControlDependencies) => ShellPermissionControlProvider | undefined;
}, {
    readonly providerName: "deepmind";
    readonly source: {
        readonly kind: "cli";
        readonly label: "Gemini CLI command confirmation and permission practice";
    };
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "runtime-governed";
    readonly notes: readonly ["Provider practice metadata is audit context; permission evaluation stays Praxis-native."];
    readonly createProvider: ({ provider, executor }: ShellPermissionControlDependencies) => ShellPermissionControlProvider | undefined;
}];
export declare const shellPermissionControlBestPracticeDescriptor: {
    readonly toolId: "shell.permissionControl";
    readonly bestPractice: "runtime-governed-shell-permission-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 selectShellPermissionControlPractice(dependencies?: ShellPermissionControlDependencies & {
    preferredProvider?: ShellPermissionControlPracticeProviderName;
}): ShellPermissionControlPracticeSelection;
export declare function executeShellPermissionControl(request?: ShellPermissionControlBestPracticeRequest): Promise<ShellPermissionControlResult>;
export declare function buildShellPermissionControlBestPractice(request?: ShellPermissionControlBestPracticeRequest): ShellPermissionControlResult;
export declare const shellPermissionControlBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<ShellPermissionControlHandlerInput, ShellPermissionControlOutput>;
export declare const shellPermissionControlHandler: BaseToolHandler<ShellPermissionControlHandlerInput, ShellPermissionControlOutput>;
