mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-09-03 04:30:14 +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
9.2 KiB
9.2 KiB
Creator Agent Nodes
Content creation through the creator agent: contextual generation, character creation and per-character derivations (name, description, dialogue instructions) plus thematic lists.
8 nodes.
| Node | Registry path |
|---|---|
| Contextual Generate | agents/creator/ContextualGenerate |
| Create Character | agents/creator/CreateCharacter |
| Determine Character Description | agents/creator/DetermineCharacterDescription |
| Determine Character Dialogue Instructions | agents/creator/DetermineCharacterDialogueInstructions |
| Determine Character Name | agents/creator/DetermineCharacterName |
| Determine Content Context | agents/creator/DetermineContentContext |
| Generate Thematic List | agents/creator/GenerateThematicList |
| Creator Settings | agents/creator/Settings |
Contextual Generate
agents/creator/ContextualGenerate
Generates text based on the given context.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state of the graph |
context_type |
str |
(optional) The type of context to use in generating the text |
context_name |
str |
(optional) The name of the context to use in generating the text |
instructions |
str |
(optional) The instructions to use in generating the text |
length |
int |
(optional) The length of the text to generate |
character |
character,str |
(optional) The character to generate the text for |
original |
str |
(optional) The original text to use in generating the text |
partial |
str |
(optional) The partial text to use in generating the text |
uid |
str |
(optional) The uid to use in generating the text |
generation_options |
generation_options |
(optional) The generation options to use in generating the text |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The updated state of the graph |
text |
str |
The generated text |
character |
character |
The character object resolved from the character input |
context_type |
str |
The context type, passed through |
context_name |
str |
The context name, passed through |
instructions |
str |
The instructions, passed through |
original |
str |
The original text, passed through |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
context_type |
str |
"general" |
The type of context to use in generating the text. Choices: character attribute, character detail, character dialogue, scene intro, scene intent, scene phase intent, scene type description, scene type instructions, general, list, scene, static history, …. |
context_name |
str |
unset |
The name of the context to use in generating the text |
instructions |
str |
unset |
The instructions to use in generating the text |
length |
int |
100 |
The length of the text to generate |
character |
str |
unset |
The character to generate the text for |
uid |
str |
unset |
The uid to use in generating the text |
context_aware |
bool |
True |
Whether to use the context in generating the text |
history_aware |
bool |
True |
Whether to use the history in generating the text |
Create Character
agents/creator/CreateCharacter
Node module (base type core/Graph) defined in src/talemate/agents/creator/modules/create-character.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
instructions |
str |
|
character_name |
str |
(optional) |
description |
str |
(optional) |
generate |
bool |
(optional) |
generate_attributes |
bool |
(optional) |
generation_options |
generation_options |
(optional) |
is_active |
bool |
(optional) |
is_player |
bool |
(optional) |
assign_voice |
bool |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
`` | |
character |
character |
|
actor |
actor |
Determine Character Description
agents/creator/DetermineCharacterDescription
Determines the description for a character.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state of the graph |
character |
character |
The character to determine the description for |
extra_context |
str |
(optional) Extra context to use in determining the description |
Outputs
| Output | Type | Description |
|---|---|---|
description |
str |
The determined description |
Determine Character Dialogue Instructions
agents/creator/DetermineCharacterDialogueInstructions
Determines dialogue (acting) instructions for a character, via the creator agent. The result is returned but not stored on the character by this node.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state of the graph |
character |
character |
The character to determine dialogue instructions for |
instructions |
str |
Additional instructions to guide the generation (optional) |
update_existing |
bool |
Whether to base the result on the character's existing dialogue instructions (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
character |
character |
The character, passed through |
dialogue_instructions |
str |
The determined dialogue instructions |
original |
str |
The character's dialogue instructions before generation |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
instructions |
text |
"" |
Any additional instructions to use in determining the dialogue instructions |
update_existing |
bool |
False |
Whether to update the existing dialogue instructions |
Determine Character Name
agents/creator/DetermineCharacterName
Determines (or clarifies) a character name from an existing or descriptive name.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state of the graph |
character_name |
str |
(optional) The current or descriptive character name |
allowed_names |
list |
(optional) Optional list of allowed names to select from |
is_group |
bool |
(optional) Whether the name describes a group of characters |
instructions |
str |
(optional) Additional instructions to guide name generation |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The current state of the graph (pass-through) |
character_name |
str |
The determined name |
original |
str |
The original character_name input |
allowed_names |
list |
The allowed_names input (pass-through) |
is_group |
bool |
The is_group input (pass-through) |
instructions |
str |
The instructions input (pass-through) |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
character_name |
str |
"" |
The current or descriptive character name |
allowed_names |
list |
[] |
Optional list of allowed names to select from |
is_group |
bool |
False |
Whether the name describes a group of characters |
instructions |
text |
"" |
Additional instructions to guide name generation |
Determine Content Context
agents/creator/DetermineContentContext
Determines a fitting content context label (genre / style descriptor) for the given description, via the creator agent.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state of the graph |
description |
str |
(optional) The description to determine the content context for (required at runtime despite the optional socket) |
Outputs
| Output | Type | Description |
|---|---|---|
content_context |
str |
The determined content context |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
description |
str |
unset |
Description of the context |
Generate Thematic List
agents/creator/GenerateThematicList
Generates a list of thematic items based on the instructions.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
instructions |
str |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
list |
list |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
instructions |
str |
unset |
The instructions to use in generating the list |
iterations |
int |
1 |
The number of iterations to use in generating the list - 1 iteration will generate 20 items. Range: 1 – 10. |
Creator Settings
agents/creator/Settings
Base node to render creator agent settings.
Every setting of the creator agent is exposed as an output socket named after the setting - see the agent's documentation under Agents for what each setting does.