import { z } from "zod";
import { ExecutableTool, ExtensionDefinition, ExtensionMetadata, ToolDefinition, ToolCallResult, ToolContext, ToolError, ToolErrorType } from "./types";
/**
 * 工具定义辅助函数
 */
export declare function createTool<TParams extends z.ZodTypeAny, TReturns = any, TConfig = any>(config: ToolDefinition<TParams, TReturns, TConfig>): ToolDefinition<TParams, TReturns, TConfig>;
/**
 * 扩展定义辅助函数
 */
export declare function createExtension<TConfig extends z.ZodTypeAny>(config: ExtensionDefinition<TConfig>): ExtensionDefinition<TConfig>;
/**
 * 成功结果辅助函数
 */
export declare function Success<T>(result?: T, metadata?: ToolCallResult["metadata"]): ToolCallResult<T>;
/**
 * 失败结果辅助函数
 */
export declare function Failed(error: string, metadata?: ToolCallResult["metadata"]): ToolCallResult;
/**
 * 将工具定义转换为可执行工具
 */
export declare function defineExecutableTool<TParams extends z.ZodTypeAny, TReturns = any, TConfig = any>(definition: ToolDefinition<TParams, TReturns, TConfig>, baseContext?: Partial<ToolContext<TConfig>>, extensionMetadata?: ExtensionMetadata): ExecutableTool<TParams, TReturns>;
/**
 * 验证工具参数
 */
export declare function validateToolParameters<T extends z.ZodTypeAny>(schema: T, params: unknown): {
    success: boolean;
    data?: z.infer<T>;
    error?: string;
};
/**
 * 创建工具错误
 */
export declare function createToolError(type: ToolErrorType, message: string, toolName?: string, originalError?: Error): ToolError;
/**
 * 常用参数的辅助函数
 */
export declare const CommonParams: {
    INNER_THOUGHTS: z.ZodString;
    REQUEST_HEARTBEAT: z.ZodOptional<z.ZodBoolean>;
};
export declare function withCommonParams<T extends z.ZodRawShape>(params: T): z.ZodObject<{
    inner_thoughts: z.ZodString;
    request_heartbeat: z.ZodOptional<z.ZodBoolean>;
} & T, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
    inner_thoughts: z.ZodString;
    request_heartbeat: z.ZodOptional<z.ZodBoolean>;
} & T>, any> extends infer T_1 ? { [k in keyof T_1]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
    inner_thoughts: z.ZodString;
    request_heartbeat: z.ZodOptional<z.ZodBoolean>;
} & T>, any>[k]; } : never, z.baseObjectInputType<{
    inner_thoughts: z.ZodString;
    request_heartbeat: z.ZodOptional<z.ZodBoolean>;
} & T> extends infer T_2 ? { [k_1 in keyof T_2]: z.baseObjectInputType<{
    inner_thoughts: z.ZodString;
    request_heartbeat: z.ZodOptional<z.ZodBoolean>;
} & T>[k_1]; } : never>;
/**
 * 类型守卫：检查是否为有效的工具定义
 */
export declare function isValidTool(obj: any): obj is ToolDefinition;
/**
 * 类型守卫：检查是否为有效的扩展定义
 */
export declare function isValidExtension(obj: any): obj is ExtensionDefinition;