> ## Documentation Index
> Fetch the complete documentation index at: https://prismeai-legacy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Text Module

> Pure-JS text processing utilities for automations

The **text** module provides pure-JS text processing utilities, with no external dependencies.

## splitText

Split text into chunks using a recursive character splitting strategy. The splitter tries separators in order, splits on the first one found, merges small pieces back up to `chunkSize`, maintains `chunkOverlap` between consecutive chunks, and recurses with finer separators for pieces still too large.

```yaml theme={null}
- run:
    module: text
    function: splitText
    parameters:
      content: "{{document.text}}"
      chunkSize: 1000
      chunkOverlap: 200
    output: chunks
```

| Parameter       | Type                            | Required | Default                   | Description                                                                                                                                                                                                |
| --------------- | ------------------------------- | -------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content`       | string \| string\[]             | yes      |                           | Text or array of texts to split                                                                                                                                                                            |
| `chunkSize`     | number                          | yes      |                           | Maximum size of each chunk (in characters)                                                                                                                                                                 |
| `chunkOverlap`  | number                          | yes      |                           | Number of overlapping characters between consecutive chunks                                                                                                                                                |
| `separators`    | string\[]                       | no       | `["\n\n", "\n", " ", ""]` | Ordered list of separators to try, from coarsest to finest                                                                                                                                                 |
| `keepSeparator` | boolean \| `"start"` \| `"end"` | no       | `false`                   | Attach the separator to the chunk. `true` or `"end"` appends it to the preceding chunk, `"start"` prepends it to the following chunk. Only visible with non-whitespace separators (whitespace is trimmed). |

Returns an array of `{ content, size }` objects:

```json theme={null}
[
  { "content": "First chunk text...", "size": 253 },
  { "content": "Second chunk text...", "size": 241 }
]
```

### Split with custom separators (e.g. Markdown headings)

```yaml theme={null}
- run:
    module: text
    function: splitText
    parameters:
      content: "{{document.text}}"
      chunkSize: 1500
      chunkOverlap: 100
      separators:
        - "\n## "
        - "\n### "
        - "\n\n"
        - "\n"
        - " "
        - ""
      keepSeparator: start
    output: chunks
```

### Iterate over chunks

```yaml theme={null}
- run:
    module: text
    function: splitText
    parameters:
      content: "{{document.text}}"
      chunkSize: 500
      chunkOverlap: 50
    output: chunks
- repeat:
    on: "{{chunks}}"
    do:
      - emit:
          event: chunk-ready
          payload:
            text: "{{item.content}}"
            size: "{{item.size}}"
```