- **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.
4.2 KiB
Director Auto-Direction Nodes
The director's automatic direction loop: pick candidates, determine scene intent, decide when an instruction is due and generate the auto-direction itself.
6 nodes.
| Node | Registry path |
|---|---|
| Auto Direction | agents/director/auto-direct/AutoDirection |
| Auto Direct Candidates [DEPRECATED] | agents/director/auto-direct/Candidates |
| Determine Scene Intent | agents/director/auto-direct/DetermineSceneIntent |
| Generate Auto Direction | agents/director/auto-direct/generateAutoDirection |
| Generate Scene Types | agents/director/auto-direct/GenerateSceneTypes |
| Is Due For Instruction [DEPRECATED] | agents/director/auto-direct/IsDueForInstruction |
Auto Direction
agents/director/auto-direct/AutoDirection
Node module (base type core/Graph) defined in src/talemate/agents/director/modules/auto-direction.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
Outputs
| Output | Type | Description |
|---|---|---|
state |
`` |
Auto Direct Candidates [DEPRECATED]
agents/director/auto-direct/Candidates
Returns a list of characters that are valid for doing the next action, based on the director's auto-direct settings and the recent scene history.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
Outputs
| Output | Type | Description |
|---|---|---|
characters |
list |
Determine Scene Intent
agents/director/auto-direct/DetermineSceneIntent
Has the director determine the current scene intent and set it on the scene's intent state (the director may also decide to leave the current intent unchanged).
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
scene_phase |
scene_intent/scene_phase |
The scene's phase after the determination (None if the director decided not to set one) |
Generate Auto Direction
agents/director/auto-direct/generateAutoDirection
Node module (base type core/Graph) defined in src/talemate/agents/director/modules/generate-auto-direction.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
characters |
list |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
actor_direction |
any |
|
narrator_direction |
any |
Generate Scene Types
agents/director/auto-direct/GenerateSceneTypes
Has the director generate scene types (or pick them from the scene type templates) and register them on the scene's intent state.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
instructions |
str |
Instructions guiding the scene type generation (optional) |
max_scene_types |
int |
The maximum number of scene types to generate (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
scene_types |
list |
The generated scene types |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
instructions |
text |
"" |
The instructions for the scene types |
max_scene_types |
int |
1 |
The maximum number of scene types to generate |
Is Due For Instruction [DEPRECATED]
agents/director/auto-direct/IsDueForInstruction
Checks if the actor is due for instruction based on the auto-direct settings.
Inputs
| Input | Type | Description |
|---|---|---|
actor_name |
str |
Outputs
| Output | Type | Description |
|---|---|---|
is_due |
bool |
|
actor_name |
str |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
actor_name |
str |
"" |
The name of the actor to check instruction timing for |