Files
veguAI cc28def7c6 0.39.0 (#274)
- **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.
2026-08-29 13:21:22 +03:00

7.4 KiB

Node Reference

Complete reference of every node available in the node editor, grouped by category.

Every node has a registry path (like scene/GetCharacter) that identifies it uniquely — it is what you see when searching for a node in the editor (double-click the canvas) and what node module JSON files store. The first path segment groups related nodes and maps to the pages below. Each entry documents the node's input and output sockets and its properties.

If you are new to the node editor, start with the core concepts section — the reference pages assume you know how graphs, sockets and properties work.

Every node available in the node editor, grouped by category. Each page lists the node's registry path, inputs, outputs and properties.

Page Nodes Description
Agent Nodes 9 Generic agent interaction: get an agent, call agent functions, read and count agent state variables.
AI Function Nodes (Focal) 7 AI function calling: define callable functions and arguments, unpack calls and collect results.
Asset Meta And Selection Nodes 6 Asset metadata, search, selection and attachment context for passing assets to generation.
Asset Nodes 9 Scene asset CRUD: add, get, list, remove and update assets, cover and avatar images.
Context ID Nodes 11 Context IDs: build, convert, compress, read and write context-addressable values and pins.
Conversation Agent Nodes 2 Generate character dialogue through the conversation agent.
Core Nodes 7 Graph plumbing: module Input/Output/Property, Route, Watch, Null and Stage.
Creator Agent Nodes 9 Contextual content generation: character attributes, dialogue instructions, content context and thematic lists.
Data Nodes 11 General value handling: get/set, conditionals, sorting, selection, UUIDs, JSON, object updates and length/capping helpers.
Dict And List Nodes 14 Dictionaries and lists: make, get, set, update, pop, append, combine and collect.
Director Agent Nodes 15 Director operations: scene direction, character persistence, voice assignment, dice rolls, narrator/actor direction functions and websocket handlers.
Director Auto-Direction Nodes 6 Automatic scene direction: candidates, scene intent, instruction cadence and auto-direction generation.
Director Chat Actions 10 The director chat's action modules: direct the scene, update context/gamestate/story arc, create images, query, prompt or yield to the user.
Director Chat Instructors 10 The director chat's instructor modules: instruct characters, the narrator, world/history/story updates and character creation.
Director Chat Nodes 13 Director chat plumbing: chat context, action arguments, confirmation and sub-actions, plus context/query modules.
Director Planning Nodes 13 Director plans: create, update, advance and complete plans and their tasks.
Editor Agent Nodes 4 Clean up user input, narration and character messages through the editor agent.
Event Nodes 7 Emit agent/system/status messages and listen to scene events.
Flow Exception Nodes 3 Stop graph execution or raise errors: Stop, input value errors and acted-as-character signals.
Function Nodes 11 Callable node modules: define, get and call functions, for-each calls, returns, error handlers, breakpoints and scoped API functions.
Input Nodes 2 Process and wait for player input in the scene loop.
Logic Nodes 12 Branching and comparison: switches, routers, boolean logic and conditional routing.
Memory Agent Nodes 2 Query the long-term memory context database and unpack memory documents.
Narrator Agent Nodes 12 Generate narration messages: progress, scene, environment, query, character entry/exit and time narration.
Number Nodes 9 Numeric values: conversion, arithmetic, comparison and random numbers.
Packaging Nodes 4 Node module packaging: define, install and configure scene packages.
Prompt Nodes 7 Build prompts and control generation: prompt construction, defaults and inference settings.
Response Parsing Nodes 9 Parse LLM responses: extractors for anchors, lists, movie-script dialogue and structured data.
Scene Character Nodes 18 Characters in the scene: get, make, activate/deactivate, remove and read/write attributes, details and descriptions.
Scene History Nodes 11 Scene message history: query, summarize and manage archive entries and character activity.
Scene Intent Nodes 10 Scene intention: read and set the scene intent, scene phase and scene types.
Scene Message Nodes 6 Scene messages: create, version, hide and manipulate messages in the scene log.
Scene Nodes 18 Scene lifecycle and metadata: title, description, introduction, content classification, scene loop and storyline modules.
State Nodes 14 Graph state variables: get/set/unset across scopes (local, parent, shared, scene loop, game), counters and path variants.
String Nodes 16 Strings: formatting, templates, joining, splitting, cleanup and excerpts.
Summarizer Agent Nodes 5 Summarization: scene progression summaries, tag generation and message avatar hooks.
Utility Nodes 5 Miscellaneous helpers: counters, diffs, list extraction, ISO date durations and module styling.
UX Nodes 5 User-facing interface elements: choice elements, status displays and interactive prompts.
Validation Nodes 7 Validate values: characters, asset IDs, context IDs, containment and set/unset checks.
Visualizer Agent Generation Nodes 7 Visual generation: generation requests, image generation, backend selection/status and image analysis.
Visualizer Agent Modules 10 Ready-made visual generation flows: generate visual assets, avatars, portraits, image edits and regenerations.
Visualizer Agent Prompt Nodes 8 Visual prompt building: prompt parts, styles, finalization and unpacking.
Voice Agent Nodes 5 Text-to-speech: get and unpack voices and generate speech through the voice agent.
Websocket Nodes 4 Websocket plumbing: routers, responses and operation done/failed signals.
World Entry Nodes 8 World entries (get, save, unpack, remove) and generation options: spices and writing styles.
World State Agent Nodes 13 World state operations: time advancement, character progression, world state emission and extraction.