import type { SkillFmToolResult } from '../_vendored-contracts/beacon-mcp-tools-v1.js';
interface ExplainProviderKeyInput {
    provider: string;
}
export interface ProviderKeyExplanation {
    provider: string;
    display_name: string;
    /** 给用户看的 key 类型名称 (中文友好) */
    key_label: string;
    /** 该 provider 是否有专用 admin/usage key (vs 跟普通调用 key 共用) */
    has_dedicated_admin_key: boolean;
    /** 推荐 scope (如 OpenAI/Anthropic), 没有 scope 概念时 null */
    scope_recommended: string[] | null;
    scope_warning: string | null;
    /** 为什么 SkillFM 需要这个 key */
    why_needed: string;
    /** 一步一步的获取流程 (含真链接) */
    steps: string[];
    /** 'LOW' / 'MEDIUM' / 'HIGH' */
    risk_level: 'LOW' | 'MEDIUM' | 'HIGH';
    /** 风险解释 — 此 key 能干啥, 不能干啥 */
    risk_explain: string;
    /** 撤销 / 删除 key 的链接 */
    revoke_url: string;
    /** BYOK 保护承诺 (固定文案) */
    byok_safety: string;
    /** key 格式 hint, 帮 agent 验证用户给的是不是对的 key */
    key_format_hint: string;
    /** 中高风险 provider 的额外建议 (建议建独立 key / 充小额 / 设限额) */
    extra_recommendations: string[];
}
export declare function handleExplainProviderKey(input: ExplainProviderKeyInput): Promise<SkillFmToolResult<ProviderKeyExplanation>>;
/** Exposed for testing — list of all supported providers */
export declare const SUPPORTED_PROVIDERS: string[];
export {};
//# sourceMappingURL=explain-provider-key.d.ts.map