import org.opensearch.transport.client.Client;

/**
 * Builder class for constructing {@link SuggestRequest} instances.
 * This builder provides methods to set various parameters for the suggest request.
 */
public class SuggestRequestBuilder extends RequestBuilder<SuggestRequest, SuggestResponse> {
    /**
     * Constructor for SuggestRequestBuilder.
     * @param client The OpenSearch client.

import org.opensearch.search.SearchHit;

/**
 * Creates SuggestResponse instances from OpenSearch search results.
 *
 * <p>This class encapsulates the response creation logic extracted from SuggestRequest,
 * including duplicate word handling and first-word matching prioritization.</p>
 */
public class SuggestResponseCreator {

    private final String query;
    private final int size;

import org.opensearch.index.query.functionscore.ScoreFunctionBuilders;

/**
 * Builds OpenSearch queries for suggestion requests.
 *
 * <p>This class encapsulates the query building logic extracted from SuggestRequest,
 * including reading conversion, normalization, and function score query construction.</p>
 */
public class SuggestQueryBuilder {

    private final ReadingConverter readingConverter;

---

## Quick Reference

### Essential Files

| File | Purpose |
|------|---------|
| `Suggester.java` | Main entry point, index management |
| `SuggestIndexer.java` | Indexing operations |
| `SuggestRequest.java` | Query building, scoring |
| `SuggestSettings.java` | Configuration |
| `SuggestItem.java` | Domain model |
| `DefaultContentsParser.java` | Text processing pipeline |

### Key Constants

```java