import type { LoadedApi } from '../../types.js';
import type { ToolContext } from '../context.js';
import { z } from 'zod';
export interface ToolResult {
    isError?: boolean;
    content: {
        type: 'text';
        text: string;
    }[];
    structuredContent?: unknown;
}
export interface ToolDefinition<TInput extends {
    fields?: string[];
}, TOutput> {
    name: string;
    description: string;
    inputSchema: z.ZodType<TInput>;
    outputSchema: z.ZodType<TOutput>;
    execute: (context: ToolContext, input: Omit<TInput, 'fields'>) => Promise<TOutput>;
}
export declare function ok(data: unknown): ToolResult;
export declare function fail(error: unknown): ToolResult;
export declare function requireApi(context: ToolContext, apiName: string): LoadedApi;
export declare function parseInput<T>(args: unknown, schema: z.ZodType<T>): T;
export declare function validateOutput<T>(data: unknown, schema: z.ZodType<T>): T;
export declare function executeToolData<TInput extends {
    fields?: string[];
}, TOutput>(definition: ToolDefinition<TInput, TOutput>, context: ToolContext, args: unknown): Promise<TOutput>;
export declare function runMcpTool<TInput extends {
    fields?: string[];
}, TOutput>(definition: ToolDefinition<TInput, TOutput>, context: ToolContext, args: unknown): Promise<ToolResult>;
export declare function toToolDescriptor<TInput extends {
    fields?: string[];
}, TOutput>(definition: ToolDefinition<TInput, TOutput>): {
    name: string;
    description: string;
    inputSchema: Record<string, unknown>;
    outputSchema: Record<string, unknown>;
};
export declare function withFields<T extends z.AnyZodObject>(schema: T): z.ZodType<z.infer<T> & {
    fields?: string[];
}>;
export declare function toStringMap(value: Record<string, unknown> | undefined | null): Record<string, string>;