mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-09-02 03:59:12 +02:00
* feat(creator): consolidated character generation (Fast mode) with per-aspect orchestrator * test(creator): consolidated generation unit + baseline template tests; strict anchor extraction for one-shot misses * feat(director): persist_character unified flow - Fast mode branch, generate=False manual mode, pre-generated field params * feat(load): route card import AI extraction through creator consolidated generation in Fast mode * feat(nodes): add agents/creator/GenerateCharacter node; PersistCharacter accepts pre-generated fields * refactor: remove deprecated WorldStateManager.create_character path; world editor manual creation uses persist_character * docs: changelog entries + creator settings docs for Fast character creation * fix(creator): parse consolidated response by section boundaries - real models write open sections without closing tags * fix(creator): drop bare name/header lines from consolidated example dialogue * fix: address PR #139 review - node chain description passthrough, manual-mode template gate, shared attribute parser, fast import error tolerance * fix: address PR #139 review round 2 - late-name renormalization guard, speaker-drop heuristics, cancellation propagation, universal name guard * feat(creator): one-shot token budget setting (1024-8192, default 4096) for Fast character creation * feat: consolidate attribute templates into the one-shot + review round 3 fixes (strict extraction, mixin action, name guards) * fix: address PR #139 review round 4 - conditional template fold, augment folding, response-budget-aware context reservation, budget clamping * fix: address PR #139 review round 5 - augment in fill-miss fallback, fold eligibility vs Consolidate set, clamped history budget, fold precondition docs * fix: clamp one-shot response budget to client context so history + overhead + response always fit * fix: address PR #139 review round 7 - docs-index entries for Character Creation pages, response-budget docstring bound * fix: template fold works with name determination (placeholder formatting); consolidate_templates becomes an 'Attribute templates' entry in the Consolidate flags * test: re-level character-creation test mocking to the client-response layer (#140) (#144) * feat(creator): richer one-shot instructions ported from standalone prompts; quick toggle for Fast mode * feat(creator): label fast mode 'Fast Character Generation' for the quick toggle * fix: propagate GenerationCancelled in split-mode card import helpers (#142) (#145) * refactor: decompose the character-generation flow (#141) (#146) * refactor(creator,director): decompose the character-generation flow (#141) * refactor(creator,director): pydantic request models; generate_character_unified takes the request object (#141) * refactor(creator,director): address PR #146 review - sheet visibility, node None-name guard, request hardening (#141) * refactor(creator,director): PR #146 round 2 - completion status parity, enforcement ordering, test pins (#141) * refactor(director): PR #146 round 3 - completion status placement, cap pins (#141) * fix: address PR #139 review - fold placeholder gated on determine_name, cancel propagation in card import pipeline, dedupe fast/split orchestration, orchestrator-side character detach, docs for Attribute templates fold * fix: address PR #139 review round 2 - sheet prompt gets pre-creation description via explicit context character, detach field-fidelity coverage, aspect type annotations, Fast Character Generation naming, extraction polish * fix: address PR #139 review round 3 - uniform context-character rendering in sheet prompt (skip_characters), augment detour comment restated, Consolidate description rename, test state/fidelity gaps * refactor: move StrictAnchorExtractor to talemate.prompts.response with the other extractors (PR #139 review) * feat(creator): default Consolidate to every aspect incl. example dialogue * feat(creator): render writing style instructions in the consolidated character generation prompt; reword Fast Character Generation description (no upper request limit, less detail as failure mode) * fix: address PR #139 review round 6 - example dialogue guidance reaches the consolidated one-shot, extractor docstring + unit tests, dialogue_examples event caveats, writing-style docs, changelog accuracy
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 | 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. |