# Tom Typeahead Remote

The `io.kvision.form.text.TomTypeaheadRemoteInput` component, contained in `kvision-tom-select-remote` module, is a special component you can use to render a typeahead text field with values loaded from the server. Unlike standard `TomTypeaheadInput` component (which can also load values from an AJAX source but needs a defined endpoint) `TomTypeaheadRemoteInput` is bound directly to the method of the remote service. The method signature looks like this:

```kotlin
import dev.kilua.rpc.annotations.RpcService

@RpcService
interface IValueService {
    suspend fun values(search: String?, state: String?): List<String>
}
```

The `search` parameter is send with the value entered by the user in the text field. It should be used to filter the returned list of values.

The `state` parameter allows you to send optional, additional data to the backend service, with the help of the `stateFunction` parameter of the `TomTypeaheadRemoteInput` constructor.

To use `TomTypeaheadRemote` form control, you initialize it with the `ServiceManager` instance and a callable reference to the right method.&#x20;

```kotlin
TomTypeaheadRemote(serviceManager = getServiceManager<IValueService>(), 
    function = IValueService::values,
    stateFunction = { someState.toString() },
    label = "Start typing to see appropriate values"
)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kvision.gitbook.io/kvision-guide/5.-fullstack-development-guide/tom-typeahead-remote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
