import type { BaseToolHandler } from "../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js";
import { planLspSymbolExplanation as planLspSymbolExplanationCore, type LspExplainSymbolRequest } from "./core.js";
import { type LspLocateDefinitionRuntimeOptions, type LspRuntimeHover } from "../_shared/runtime.js";
import type { LspLocation } from "../code.lsp_locateDefinition/core.js";
import { type LspExplainSymbolPracticeProviderName } from "./dependencies.js";
export * from "./core.js";
export type LspExplainSymbolRuntimeOutput = {
    kind: "agentCore.basicTool.lsp.explainSymbol";
    target: {
        filePath: string;
        line: number;
        character: number;
        languageId?: string;
    };
    hover?: LspRuntimeHover;
    definitions: readonly LspLocation[];
    references: readonly LspLocation[];
    dryRun: boolean;
    providerCalled: boolean;
    permissionsRequired: readonly ["workspace:read", "lsp:read"];
    unsafeSideEffects: false;
};
export type LspExplainSymbolPreviewOutput = {
    kind: "agentCore.basicTool.lsp.explainSymbol.preview";
    preview: ReturnType<typeof planLspSymbolExplanationCore> extends infer Result ? Result extends {
        ok: true;
        plan: infer Plan;
    } ? Plan : never : never;
    dryRun: true;
    providerCalled: false;
    unsafeSideEffects: false;
};
export type LspExplainSymbolBestPracticeOutput = LspExplainSymbolRuntimeOutput | LspExplainSymbolPreviewOutput;
export type LspExplainSymbolBestPracticeRequest = LspExplainSymbolRequest & {
    runtime?: LspLocateDefinitionRuntimeOptions;
    preferredProvider?: LspExplainSymbolPracticeProviderName;
};
export declare const lspExplainSymbolProviderPractices: readonly [{
    readonly providerName: "anthropic";
    readonly source: "Claude Code LSPTool practice informs code.lsp_explainSymbol; Praxis executes through the shared LSP runtime.";
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "read-only";
}, {
    readonly providerName: "openai";
    readonly source: "Codex CLI tool runtime boundary practice informs code.lsp_explainSymbol; Praxis executes through the shared LSP runtime.";
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "read-only";
}, {
    readonly providerName: "deepmind";
    readonly source: "Gemini CLI tool registry practice informs code.lsp_explainSymbol; Praxis executes through the shared LSP runtime.";
    readonly directCliSupport: true;
    readonly sideEffectPolicy: "read-only";
}];
export declare const lspExplainSymbolBestPracticeDescriptor: {
    readonly toolId: "code.lsp_explainSymbol";
    readonly bestPractice: "anthropic-host-executor-or-shared-stdio-lsp-runtime";
    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_explainSymbol; Praxis executes through the shared LSP runtime.";
        readonly directCliSupport: true;
        readonly sideEffectPolicy: "read-only";
    }, {
        readonly providerName: "openai";
        readonly source: "Codex CLI tool runtime boundary practice informs code.lsp_explainSymbol; Praxis executes through the shared LSP runtime.";
        readonly directCliSupport: true;
        readonly sideEffectPolicy: "read-only";
    }, {
        readonly providerName: "deepmind";
        readonly source: "Gemini CLI tool registry practice informs code.lsp_explainSymbol; Praxis executes through the shared LSP runtime.";
        readonly directCliSupport: true;
        readonly sideEffectPolicy: "read-only";
    }];
    readonly dependencies: readonly ["workspace.read", "lsp.server.forTargetLanguage", "node.child_process.stdioJsonRpc"];
};
export declare const lspExplainSymbolBaseToolDefinition: import("../../../../../agentCore/agent_executionEngine/basic_toolLayer/baseTools/baseToolDefinition.js").BaseToolDefinition<LspExplainSymbolBestPracticeRequest, LspExplainSymbolBestPracticeOutput>;
export declare const lspExplainSymbolHandler: BaseToolHandler<LspExplainSymbolBestPracticeRequest, LspExplainSymbolBestPracticeOutput>;
