/**
 * Builtin tools catalog for `aiActionWithTools` steps.
 *
 * Canonical source: the `Tool.builtinType` union in
 * `shared/types/pipeline/PipelineTypes.ts`. This file is the
 * CLI-distributable mirror — drift is guarded by
 * `agentled-mcp-server/__tests__/builtin-tools-catalog.test.ts`.
 *
 * When a new builtin is added to the runtime:
 *   1. Extend the `Tool.builtinType` union in PipelineTypes.ts
 *   2. Append the same value to this catalog with a description + config
 *   3. The drift test enforces (1) ⊆ (2) and vice versa
 */
export interface BuiltinToolDoc {
    /** Wire value — goes into `tools[].builtinType`. */
    value: string;
    /** One-line description of what the tool does at runtime. */
    description: string;
    /** Extra config keys the tool reads beyond `builtinType`. */
    extraKeys?: string[];
    /**
     * Providers that surface this tool. `all` means any AI provider we support
     * (via a shim if needed). `anthropic` / `openai` means the tool is a native
     * tool for that provider and may be a no-op elsewhere.
     */
    providers: Array<'all' | 'anthropic' | 'openai' | 'moonshot'>;
    /** Typical credit cost per invocation (best-effort; see live registry for exact). */
    typicalCreditsPerCall?: number;
    /** Minimal JSON fragment for the `tools[]` array. */
    example: Record<string, unknown>;
}
export declare const BUILTIN_TOOLS_CATALOG: BuiltinToolDoc[];
export declare const VALID_BUILTIN_TOOL_VALUES: Set<string>;
/**
 * Heuristic "did you mean" for the most common invented / typo'd builtinType values.
 */
export declare function suggestBuiltinToolFix(invalid: string): string | undefined;