Function searchWeb

packages/agent-runtime/src/llm-api/serper-api.ts:40–193

(options: {
  query: string
  depth?: 'standard' | 'deep'
  logger: Logger
  fetch: typeof globalThis.fetch
  serverEnv: SerperEnv
})

}

export async function searchWeb(options: {
  query: string
  depth?: 'standard' | 'deep'
  logger: Logger
  fetch: typeof globalThis.fetch
  serverEnv: SerperEnv
}): Promise<string | null> {
  const { query, depth = 'standard', logger, fetch, serverEnv } = options
  const apiStartTime = Date.now()

  if (!serverEnv.SERPER_API_KEY) {
    return 'No API key found. Please set SERPER_API_KEY in your environment.'
  }

  const requestBody = {
    q: query,
    num: depth === 'deep' ? 20 : 10,
  }
  const requestUrl = `${SERPER_API_BASE_URL}/search`

  const apiContext = {
    query,
    depth,
    requestUrl,
    queryLength: query.length,
  }

  try {
    const fetchStartTime = Date.now()
    const response = await withTimeout(
      fetch(requestUrl, {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-API-KEY': serverEnv.SERPER_API_KEY,
        },
        body: JSON.stringify(requestBody),
      }),
      FETCH_TIMEOUT_MS,
    )
    const fetchDuration = Date.now() - fetchStartTime

    if (!response.ok) {
      let responseBody = 'Unable to read response body'
      try {
        responseBody = await response.text()
      } catch (bodyError) {
        logger.warn(
          {
            ...apiContext,
            bodyError,
            fetchDuration,
          },
          'Failed to read error response body',
        )
      }

      logger.error(