mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-09-02 12:09:31 +02:00
cc28def7c6
- **Help Agent** — A new agent that answers questions about Talemate itself — settings, agents, clients, the world editor — grounded in the bundled documentation, and able to change agent and application settings on request. - **Timeline Rollback** — Scrub a slider across a scene's automatic version history, preview the message history at any revision, then roll the scene back in place or fork the revision into a new save. - **Pi Bridge Client** — A new client type that drives generations through the pi coding agent's headless RPC mode, making any model pi can reach usable in Talemate. - **Application Settings** — Settings move out of their modal into an always-available Settings tab, with a single topic-grouped sidebar, a settings search, all API keys on one page, and unsaved-change tracking. - **Scene Library** — The home screen is rebuilt as a full-page landing view with a file-tree scene library, cover thumbnails and per-save metadata, scene and save deletion, and a drag-and-drop import dropzone. - **Fast Character Creation** — Generate a character in a single request instead of one prompt per aspect, with a Consolidate multi-select, a token budget, and a Fill in misses pass. Off by default. - **Scene Backdrop** — Set any scene illustration as a backdrop filling the scene view behind the messages, saved with the scene, with configurable text legibility and an Immersive quick-toggle. - **Scene Visual Manager** — World Editor → Scene gains a Visuals tab to browse, upload, generate and delete the scene's backgrounds and illustrations, and set the cover image and backdrop. - **Visual Prompt Finalization** — Post-processing actions — match and replace, or a free-form AI instruction — rewrite image prompts right before they reach the image backend, with per-scene and per-character overrides and reusable template sets. - fixes #271 - fixes #275 Plus 25 improvements and 39 bug fixes — see [CHANGELOG.md](https://github.com/vegu-ai/talemate/blob/prep-0.39.0/CHANGELOG.md#0390) for the full list.
12 KiB
12 KiB
Scene Character Nodes
Everything about characters in the scene: fetch them (by name or player status), create and persist new ones, activate/deactivate them for the current scene, and read or write their attributes, details and descriptions.
18 nodes.
| Node | Registry path |
|---|---|
| Activate Character | scene/ActivateCharacter |
| Deactivate Character | scene/DeactivateCharacter |
| Get Character | scene/GetCharacter |
| Get Character Attribute | scene/GetCharacterAttribute |
| Get Character Description | scene/GetCharacterDescription |
| Get Character Detail | scene/GetCharacterDetail |
| Get Player Character | scene/GetPlayerCharacter |
| Is Active Character | scene/IsActiveCharacter |
| Is Player Character | scene/IsPlayerCharacter |
| List Characters | scene/ListCharacters |
| Make Character | scene/MakeCharacter |
| Remove All Characters | scene/RemoveAllCharacters |
| Remove Character | scene/RemoveCharacter |
| Set Character Attribute | scene/SetCharacterAttribute |
| Set Character Description | scene/SetCharacterDescription |
| Set Character Detail | scene/SetCharacterDetail |
| Unpack Character | scene/UnpackCharacter |
| Update Character Data | scene/UpdateCharacterData |
Activate Character
scene/ActivateCharacter
Activate a character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character to activate |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The activated character |
Deactivate Character
scene/DeactivateCharacter
Deactivate a character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character to deactivate |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The deactivated character |
Get Character
scene/GetCharacter
Returns a character object from the scene by name
Inputs
| Input | Type | Description |
|---|---|---|
character_name |
str |
The name of the character |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The character object |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
partial |
bool |
False |
Whether to match on partial name |
Get Character Attribute
scene/GetCharacterAttribute
Get a base attribute from a character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character object |
name |
str |
(optional) The name of the attribute |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The character object, passed through |
name |
str |
The attribute name, passed through |
value |
str |
The attribute value (None if the attribute does not exist) |
context_id |
context_id |
The context ID of the attribute (None if the attribute does not exist) |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name |
str |
"" |
The name of the attribute |
Get Character Description
scene/GetCharacterDescription
Get the description of a character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
|
description |
str |
Get Character Detail
scene/GetCharacterDetail
Get a detail from a character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character object |
name |
str |
(optional) The name of the detail |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The character object, passed through |
name |
str |
The detail name, passed through |
detail |
str |
The detail value (None if the detail does not exist) |
context_id |
context_id |
The context ID of the detail (None if the detail does not exist) |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name |
str |
"" |
name |
detail |
str |
"" |
The name of the detail |
Get Player Character
scene/GetPlayerCharacter
Get the main player character from the scene
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The player character |
Is Active Character
scene/IsActiveCharacter
Returns whether a character is active
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
Outputs
| Output | Type | Description |
|---|---|---|
active |
bool |
Is Player Character
scene/IsPlayerCharacter
Returns whether a character is the player character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character object |
Outputs
| Output | Type | Description |
|---|---|---|
yes |
bool |
True if the character is the player character |
no |
bool |
True if the character is not the player character |
character |
character |
The character object |
List Characters
scene/ListCharacters
Returns a list of characters in the scene, filtered by status
Inputs
| Input | Type | Description |
|---|---|---|
character_status |
str |
(optional) Which characters to include - "active", "inactive" or "all" |
Outputs
| Output | Type | Description |
|---|---|---|
characters |
list |
The list of matching character objects |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
character_status |
str |
"all" |
Which characters to list (active, inactive or all). Choices: active, inactive, all. |
Make Character
scene/MakeCharacter
Make a character
Inputs
| Input | Type | Description |
|---|---|---|
name |
str |
The name of the character |
description |
text |
(optional) The description of the character |
color |
color |
(optional) The color of the character name |
base_attributes |
dict |
(optional) The base attributes of the character |
is_player |
bool |
(optional) Whether the character is the player character |
add_to_scene |
bool |
(optional) Whether to add the character to the scene |
is_active |
bool |
(optional) Whether the character is active |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The character object |
actor |
actor |
The actor object |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name |
str |
unset |
The name of the character |
description |
text |
"" |
The description of the character |
color |
color |
unset |
The color of the character name |
base_attributes |
dict |
unset |
The base attributes of the character |
is_player |
bool |
False |
Whether the character is the player character |
add_to_scene |
bool |
True |
Whether to add the character to the scene |
is_active |
bool |
True |
Whether the character is active |
Remove All Characters
scene/RemoveAllCharacters
Remove all active characters from the scene (inactive characters are not affected)
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The graph state |
Remove Character
scene/RemoveCharacter
Remove a character from the scene
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
character |
character |
The character to remove |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The graph state |
Set Character Attribute
scene/SetCharacterAttribute
Set an attribute on a character
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
name |
str |
(optional) |
value |
str |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
name |
str |
|
value |
str |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name |
str |
"" |
The name of the attribute |
value |
str |
unset |
The value of the attribute |
Set Character Description
scene/SetCharacterDescription
Set the description of a character
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
description |
str |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
description |
str |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
description |
text |
"" |
The description of the character |
Set Character Detail
scene/SetCharacterDetail
Set the details of a character
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
name |
str |
(optional) |
value |
str |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
name |
str |
|
value |
str |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name |
str |
"" |
The name of the detail |
value |
text |
unset |
The content of the detail |
Unpack Character
scene/UnpackCharacter
Unpack a character into its individual fields
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character object |
Outputs
| Output | Type | Description |
|---|---|---|
name |
str |
The name of the character |
is_player |
bool |
Whether the character is the player character |
description |
str |
The character description |
base_attributes |
dict |
The character base attributes dictionary |
details |
dict |
The character details dictionary |
color |
str |
The character name color |
actor |
actor |
The actor instance tied to the character |
Update Character Data
scene/UpdateCharacterData
Update the data of a character
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character object |
base_attributes |
dict |
(optional) The base attributes dictionary |
details |
dict |
(optional) The details dictionary |
description |
str |
(optional) The description string |
name |
str |
(optional) A new name for the character (renames the character) |
color |
str |
(optional) The color of the character name |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The updated character object |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
description |
str |
unset |
The character description |
name |
str |
unset |
The character name |
color |
str |
unset |
The color of the character name |