import type { BaseToolHandler } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js";
import { createLspFormatDocumentPlan as createLspFormatDocumentPlanCore, type LspFormatDocumentRequest } from "./core.js";
import { type LspLocateDefinitionRuntimeOptions, type LspRuntimeTextEdit } from "../_shared/runtime.js";
import { type LspFormatDocumentPracticeProviderName } from "./dependencies.js";
export * from "./core.js";
export type LspFormatDocumentRuntimeOutput = {
    kind: "agentCore.basicTool.lsp.formatDocument";
    target: {
        filePath: string;
        languageId?: string;
    };
    edits: readonly LspRuntimeTextEdit[];
    dryRun: boolean;
    providerCalled: boolean;
    appliesChanges: false;
    permissionsRequired: readonly ["workspace:read", "workspace:edit", "lsp:read"];
    unsafeSideEffects: false;
};
export type LspFormatDocumentPreviewOutput = {
    kind: "agentCore.basicTool.lsp.formatDocument.preview";
    preview: ReturnType<typeof createLspFormatDocumentPlanCore> extends infer Result ? Result extends {
        ok: true;
        plan: infer Plan;
    } ? Plan : never : never;
    dryRun: true;
    providerCalled: false;
    unsafeSideEffects: false;
};
export type LspFormatDocumentBestPracticeOutput = LspFormatDocumentRuntimeOutput | LspFormatDocumentPreviewOutput;
export type LspFormatDocumentBestPracticeRequest = LspFormatDocumentRequest & {
    runtime?: LspLocateDefinitionRuntimeOptions;
    preferredProvider?: LspFormatDocumentPracticeProviderName;
};
export declare const lspFormatDocumentProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: "Claude Code LSPTool practice informs code.lsp_formatDocument; Praxis executes through the shared LSP runtime.";
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "preview-only";
}, {
    readonly providerName: "openai";
    readonly source: "Codex CLI tool runtime boundary practice informs code.lsp_formatDocument; Praxis executes through the shared LSP runtime.";
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "preview-only";
}, {
    readonly providerName: "deepmind";
    readonly source: "Gemini CLI tool registry practice informs code.lsp_formatDocument; Praxis executes through the shared LSP runtime.";
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "preview-only";
}];
export declare const lspFormatDocumentBestPracticeDescriptor: {
    readonly toolId: "code.lsp_formatDocument";
    readonly bestPractice: "anthropic-host-executor-or-shared-stdio-lsp-runtime-preview-only";
    readonly sourcePriority: readonly ["cli", "agent-sdk", "api-sdk", "praxis-native"];
    readonly providerPractices: readonly [{
        readonly providerName: "anthropic";
        readonly source: "Claude Code LSPTool practice informs code.lsp_formatDocument; Praxis executes through the shared LSP runtime.";
        readonly directCliSupport: true;
        readonly sideEffectPolicy: "preview-only";
    }, {
        readonly providerName: "openai";
        readonly source: "Codex CLI tool runtime boundary practice informs code.lsp_formatDocument; Praxis executes through the shared LSP runtime.";
        readonly directCliSupport: true;
        readonly sideEffectPolicy: "preview-only";
    }, {
        readonly providerName: "deepmind";
        readonly source: "Gemini CLI tool registry practice informs code.lsp_formatDocument; Praxis executes through the shared LSP runtime.";
        readonly directCliSupport: true;
        readonly sideEffectPolicy: "preview-only";
    }];
    readonly dependencies: readonly ["workspace.read", "lsp.server.forTargetLanguage", "node.child_process.stdioJsonRpc"];
};
export declare const lspFormatDocumentBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<LspFormatDocumentBestPracticeRequest, LspFormatDocumentBestPracticeOutput>;
export declare const lspFormatDocumentHandler: BaseToolHandler<LspFormatDocumentBestPracticeRequest, LspFormatDocumentBestPracticeOutput>;
