# Editor Agent Nodes

Clean up user input, narration and character messages through the editor agent's revision passes.

<!-- glossary:generated - everything below this line is generated by `python -m talemate.game.engine.nodes.tools glossary --write` - do not edit -->


_4 nodes._

| Node | Registry path |
| --- | --- |
| [Clean Up Character Message](#clean-up-character-message) | `agents/editor/CleanUpCharacterMessage` |
| [Clean Up Narration](#clean-up-narration) | `agents/editor/CleanUpNarration` |
| [Clean Up User Input](#clean-up-user-input) | `agents/editor/CleanUpUserInput` |
| [Editor Settings](#editor-settings) | `agents/editor/Settings` |

## Clean Up Character Message

`agents/editor/CleanUpCharacterMessage`

Cleans up a character's dialogue text via the editor agent: fixes
exposition formatting (per the editor's formatting settings), cleans
up stray dialogue from other characters, strips partial sentences and
balances quotation marks.

**Inputs**

| Input | Type | Description |
| --- | --- | --- |
| `text` | `str` | The character message text to clean up |
| `character` | `character` | The character the message belongs to |

**Outputs**

| Output | Type | Description |
| --- | --- | --- |
| `cleaned_character_message` | `str` | The cleaned up character message |

**Properties**

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `force` | `bool` | `False` | Force clean up |

## Clean Up Narration

`agents/editor/CleanUpNarration`

Cleans up narration text via the editor agent, stripping partial
sentences and fixing exposition formatting according to the editor's
formatting settings (skipped unless the narrator fix-exposition
setting is enabled or force is set).

**Inputs**

| Input | Type | Description |
| --- | --- | --- |
| `narration` | `str` | The narration text to clean up |

**Outputs**

| Output | Type | Description |
| --- | --- | --- |
| `cleaned_narration` | `str` | The cleaned up narration |

**Properties**

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `force` | `bool` | `False` | Force clean up |

## Clean Up User Input

`agents/editor/CleanUpUserInput`

Cleans up user input via the editor agent, fixing exposition
formatting (quotes for speech, asterisks for narration) according to
the editor's formatting settings. Input starting with a command prefix
(!, @, /) is never edited, and cleanup is skipped entirely when the
editor's fix-user-input setting is disabled - unless force is set.

**Inputs**

| Input | Type | Description |
| --- | --- | --- |
| `user_input` | `str` | The user input text to clean up |
| `as_narration` | `bool` | Whether to treat the input as narration instead of speech |

**Outputs**

| Output | Type | Description |
| --- | --- | --- |
| `cleaned_user_input` | `str` | The cleaned up user input |

**Properties**

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `force` | `bool` | `False` | Force clean up |

## Editor Settings

`agents/editor/Settings`

Base node to render editor agent settings.

Every setting of the editor agent is exposed as an output socket named after the setting - see the agent's documentation under [Agents](../../../agents/index.md) for what each setting does.