- **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.
8.2 KiB
Visualizer Agent Modules
Ready-made visual generation flows built on the visualizer prompt and generation nodes: generate visual assets, avatars, portraits, image edits and regenerations, plus the visualizer's websocket handlers.
10 nodes.
| Node | Registry path |
|---|---|
| Determine Visual References | agents/visual/determineVisualReferences |
| Generate Avatar | agents/visual/generateAvatar |
| Generate Character Portrait Legacy | agents/visual/GenerateCharacterPortrait |
| Generate Image Edit | agents/visual/generateImageEdit |
| Generate Visual Asset | agents/visual/generateVisualAsset |
| Regenerate Visual Asset | agents/visual/regenerateVisualAsset |
| Set Cover Image From Generation | agents/visual/setCoverImageFromGeneration |
| Wsh Generate Visual Asset Tags | agents/visual/wshGenerateVisualAssetTags |
| Wsh Regenerate Visual Asset | agents/visual/wshRegenerateVisualAsset |
| Wsh Visualize | agents/visual/wshVisualize |
Determine Visual References
agents/visual/determineVisualReferences
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/determine-visual-references.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
prompt |
str |
|
vis_type |
str |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
prompt |
str |
|
references |
list |
|
vis_type |
str |
|
asset_ids |
list |
Generate Avatar
agents/visual/generateAvatar
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-avatar.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
instructions |
str |
|
set_current_avatar |
bool |
|
set_default_avatar |
bool |
|
tags |
list |
(optional) |
asset_name |
str |
(optional) |
asset_ctx |
asset_attachment_context |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
instructions |
str |
|
set_current_avatar |
bool |
|
set_default_avatar |
bool |
|
tags |
list |
|
asset_name |
str |
|
asset_ctx |
asset_attachment_context |
|
generation_request |
visual/generation_request |
Generate Character Portrait Legacy
agents/visual/GenerateCharacterPortrait
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-character-portrait-legacy.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
character |
any |
|
instructions |
str |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
character |
any |
|
instructions |
str |
Generate Image Edit
agents/visual/generateImageEdit
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-image-edit.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
instructions |
str |
|
asset_id |
str |
|
callback |
function |
(optional) |
asset_ctx |
asset_attachment_context |
(optional) |
vis_type |
str |
(optional) |
format |
str |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
instructions |
str |
|
asset_id |
str |
|
asset_ctx |
asset_attachment_context |
|
vis_type |
str |
|
format |
str |
|
generation_request |
visual/generation_request |
|
generation_response |
visual/generation_response |
Generate Visual Asset
agents/visual/generateVisualAsset
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-visual-asset.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
(optional) |
vis_type |
str |
|
instructions |
str |
(optional) |
prompt_only |
bool |
(optional) |
callback |
function |
(optional) |
asset_ctx |
asset_attachment_context |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
character |
character |
|
vis_type |
str |
|
instructions |
str |
|
prompt_only |
bool |
|
callback |
function |
|
asset_ctx |
asset_attachment_context |
|
prompt |
str |
|
visual_prompt |
visual/prompt |
|
generation_request |
visual/generation_request |
Regenerate Visual Asset
agents/visual/regenerateVisualAsset
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/regenerate-visual-asset.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
asset_id |
str |
|
asset_ctx |
asset_attachment_context |
(optional) |
instructions |
str |
(optional) |
callback |
function |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
asset_id |
str |
|
asset_ctx |
asset_attachment_context |
|
instructions |
str |
|
callback |
function |
Set Cover Image From Generation
agents/visual/setCoverImageFromGeneration
Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/set-cover-image-from-generation.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
generation_response |
visual/generation_response |
|
reference_for |
list |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
generation_response |
visual/generation_response |
|
asset_id |
str |
|
reference_for |
list |
Wsh Generate Visual Asset Tags
agents/visual/wshGenerateVisualAssetTags
Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-generate-visual-asset-tags.json.
Outputs
| Output | Type | Description |
|---|---|---|
fn |
function |
|
name |
str |
|
allow_multiple_calls |
bool |
|
ai_callback |
focal/callback |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
agent |
str |
"visual" |
The agent to register the handler on. Choices are generated at runtime. |
name |
str |
"generate_tags" |
The name of the handler |
Wsh Regenerate Visual Asset
agents/visual/wshRegenerateVisualAsset
Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-regenerate-visual-asset.json.
Outputs
| Output | Type | Description |
|---|---|---|
fn |
function |
|
name |
str |
|
allow_multiple_calls |
bool |
|
ai_callback |
focal/callback |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name |
str |
"revisualize" |
The name of the handler |
agent |
str |
"visual" |
The agent to register the handler on. Choices are generated at runtime. |
Wsh Visualize
agents/visual/wshVisualize
Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-visualize.json.
Outputs
| Output | Type | Description |
|---|---|---|
fn |
function |
|
name |
str |
|
allow_multiple_calls |
bool |
|
ai_callback |
focal/callback |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
agent |
str |
"visual" |
The agent to register the handler on. Choices are generated at runtime. |
name |
str |
"visualize" |
The name of the handler |