> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loom.teamecho.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Input Converters

> Loom accepts various input formats through built-in converters.

Loom can process multiple input formats, automatically converting them into text suitable for the CM agent.

## Auto-Detection

The simplest approach — `auto_convert()` handles format detection:

```python theme={null}
from loom.converters import auto_convert

text = auto_convert(any_data)  # handles str, list[dict], dict, JSON strings
```

## Available Converters

| Converter              | Input Type   | Description               |
| ---------------------- | ------------ | ------------------------- |
| `PlainTextConverter`   | `str`        | Pass-through with cleanup |
| `MarkdownConverter`    | `str`        | Markdown content / files  |
| `ChatHistoryConverter` | `list[dict]` | OpenAI message format     |
| `RAGConverter`         | `list[dict]` | RAG chunks with metadata  |
| `JSONConverter`        | `dict / str` | Arbitrary JSON data       |
| `auto_convert()`       | `any`        | Auto-detects format       |

## Chat History

Convert OpenAI-compatible message arrays:

```python theme={null}
from loom.converters import ChatHistoryConverter

messages = [
    {"role": "user", "content": "Hi, I'm Alice"},
    {"role": "assistant", "content": "Hello Alice!"},
]
text = ChatHistoryConverter().convert(messages)
```

## RAG Chunks

Convert retrieval-augmented generation chunks with metadata:

```python theme={null}
from loom.converters import RAGConverter

chunks = [
    {"text": "Important fact.", "metadata": {"source": "doc.md"}},
]
text = RAGConverter().convert(chunks)
```

## Custom Converters

Subclass `InputConverter` and implement `convert()`:

```python theme={null}
from loom.converters import InputConverter

class MyConverter(InputConverter):
    def can_handle(self, data) -> bool:
        return isinstance(data, MyCustomType)

    def convert(self, data) -> str:
        return str(data)
```