mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-09-02 12:09:31 +02:00
89e01ac138
* docs: complete node editor node reference glossary (#107) - generated by new nodes.tools glossary subcommand, 47 categorized pages covering all 403 nodes, docstring gap fixes, help-agent docs-index entries * docs: fix Jinja2 Format discoverability - document dynamic-input template variables, move node to string page, link key inference from dynamic-input notes, strip links from index summaries * help agent: keep node reference out of the chat prompt - collapse glossary entries to one pointer line (~19k chars saved), agent retrieves node info via search_docs/read_doc tool calls * help agent: replace in-prompt docs index with find_docs lookup tool - prompt carries a 13-line section overview (~1.5k chars vs ~66k), pages located via keyword-scored find_docs at runtime * changelog: help agent prompt slimming + find_docs lookup * docs: sort node reference index and nav alphabetically by page title * review: move module constants into top-of-file constant blocks (glossary MAX_DEFAULT_LENGTH; docs SECTION_DESCRIPTIONS, _FIND_STOPWORDS, FIND_DOCS_LIMIT) * review: word-boundary find_docs scoring with plural/-ing folds, find_docs+section_overview unit tests, jinja2 template field description override * docs: help agent overview no longer claims an in-prompt index of all documentation pages * docs: full node docstring audit pass - 335 classes audited by 5 agents, ~89 accuracy fixes (nonexistent/misnamed sockets, wrong behavior claims), ~94 expansions, 5 factually-wrong PropertyField descriptions corrected, glossary regenerated
7.4 KiB
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 | 8 | 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. |