/**
 * 工具返回结果按 token 估算截断：超过 maxTokens 时从尾部裁剪并打日志。
 * 用于 MCP、web_search 等单次返回可能过大的场景。
 */
/** 粗略按字符估算 token（中英混合约 1/3） */
export declare function estTokensFromChars(chars: number): number;
/**
 * 若 text 估算 token 超过 maxTokens，则保留前 maxTokens 对应字符并打日志，否则返回原 text。
 * @param text 原始文本
 * @param maxTokens 最大保留 token 数（仅当 > 0 时生效）
 * @param toolLabel 工具标识，用于日志
 * @returns 截断后的文本（可能为原 text）
 */
export declare function truncateTextToMaxTokens(text: string, maxTokens: number, toolLabel: string): string;