import type { JsonObject } from '../../hub/types/json.js';
import type { AdapterContext } from '../../hub/types/chat-envelope.js';
/**
 * IFlow web_search 请求适配（作用于 openai-chat 兼容 payload）：
 *
 * - 仅在 routeId 以 `web_search` 或 `search` 开头时生效（来自 AdapterContext.routeId）；
 * - 读取顶层的 `web_search` helper 对象 `{ query, recency, count, engine }`；
 * - 当 query 为空或无效时：删除 helper，原样透传；
 * - 当 query 有效时：构造一个标准的 OpenAI function tool：
 *   - name 固定为 `web_search`；
 *   - parameters 包含 query/recency/count 三个字段；
 * - 将生成的 function tool 写入 `tools` 数组，并删除顶层 `web_search`。
 *
 * 注意：
 * - 顶层 `web_search` 只在 servertool 的二跳请求中出现，用于驱动后端搜索；
 * - 用户侧的工具调用仍然使用统一的 `web_search` function tool schema。
 */
export declare function applyIflowWebSearchRequestTransform(payload: JsonObject, adapterContext?: AdapterContext): JsonObject;
