mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-09-02 12:09:31 +02:00
108 lines
3.2 KiB
Markdown
108 lines
3.2 KiB
Markdown
|
|
# 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.
|