mirror of https://github.com/vegu-ai/talemate.git synced 2026-09-01 19:48:52 +02:00

Files

veguAI 89e01ac138 Node editor node reference glossary (#107 ) (#111 )

* 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

2026-07-20 01:49:33 +03:00

8.2 KiB

Raw Blame History

Visualizer Agent Modules

Ready-made visual generation flows built on the visualizer prompt and generation nodes: generate visual assets, avatars, portraits, image edits and regenerations, plus the visualizer's websocket handlers.

10 nodes.

Node	Registry path
Determine Visual References	`agents/visual/determineVisualReferences`
Generate Avatar	`agents/visual/generateAvatar`
Generate Character Portrait Legacy	`agents/visual/GenerateCharacterPortrait`
Generate Image Edit	`agents/visual/generateImageEdit`
Generate Visual Asset	`agents/visual/generateVisualAsset`
Regenerate Visual Asset	`agents/visual/regenerateVisualAsset`
Set Cover Image From Generation	`agents/visual/setCoverImageFromGeneration`
Wsh Generate Visual Asset Tags	`agents/visual/wshGenerateVisualAssetTags`
Wsh Regenerate Visual Asset	`agents/visual/wshRegenerateVisualAsset`
Wsh Visualize	`agents/visual/wshVisualize`

Determine Visual References

agents/visual/determineVisualReferences

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/determine-visual-references.json.

Inputs

Input	Type	Description
`state`	`any`
`prompt`	`str`
`vis_type`	`str`

Outputs

Output	Type	Description
`state`	`any`
`prompt`	`str`
`references`	`list`
`vis_type`	`str`
`asset_ids`	`list`

Generate Avatar

agents/visual/generateAvatar

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-avatar.json.

Inputs

Input	Type	Description
`state`	`any`
`character`	`character`
`instructions`	`str`
`set_current_avatar`	`bool`
`set_default_avatar`	`bool`
`tags`	`list`	(optional)
`asset_name`	`str`	(optional)
`asset_ctx`	`asset_attachment_context`	(optional)

Outputs

Output	Type	Description
`state`	`any`
`character`	`character`
`instructions`	`str`
`set_current_avatar`	`bool`
`set_default_avatar`	`bool`
`tags`	`list`
`asset_name`	`str`
`asset_ctx`	`asset_attachment_context`
`generation_request`	`visual/generation_request`

Generate Character Portrait Legacy

agents/visual/GenerateCharacterPortrait

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-character-portrait-legacy.json.

Inputs

Input	Type	Description
`state`	`any`
`character`	`any`
`instructions`	`str`	(optional)

Outputs

Output	Type	Description
`state`	`any`
`character`	`any`
`instructions`	`str`

Generate Image Edit

agents/visual/generateImageEdit

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-image-edit.json.

Inputs

Input	Type	Description
`state`	`any`
`instructions`	`str`
`asset_id`	`str`
`callback`	`function`	(optional)
`asset_ctx`	`asset_attachment_context`	(optional)
`vis_type`	`str`	(optional)
`format`	`str`	(optional)

Outputs

Output	Type	Description
`state`	`any`
`instructions`	`str`
`asset_id`	`str`
`asset_ctx`	`asset_attachment_context`
`vis_type`	`str`
`format`	`str`
`generation_request`	`visual/generation_request`
`generation_response`	`visual/generation_response`

Generate Visual Asset

agents/visual/generateVisualAsset

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/generate-visual-asset.json.

Inputs

Input	Type	Description
`state`	`any`
`character`	`character`	(optional)
`vis_type`	`str`
`instructions`	`str`	(optional)
`prompt_only`	`bool`	(optional)
`callback`	`function`	(optional)
`asset_ctx`	`asset_attachment_context`	(optional)

Outputs

Output	Type	Description
`state`	`any`
`character`	`character`
`vis_type`	`str`
`instructions`	`str`
`prompt_only`	`bool`
`callback`	`function`
`asset_ctx`	`asset_attachment_context`
`prompt`	`str`
`visual_prompt`	`visual/prompt`
`generation_request`	`visual/generation_request`

Regenerate Visual Asset

agents/visual/regenerateVisualAsset

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/regenerate-visual-asset.json.

Inputs

Input	Type	Description
`state`	`any`
`asset_id`	`str`
`asset_ctx`	`asset_attachment_context`	(optional)
`instructions`	`str`	(optional)
`callback`	`function`	(optional)

Outputs

Output	Type	Description
`state`	`any`
`asset_id`	`str`
`asset_ctx`	`asset_attachment_context`
`instructions`	`str`
`callback`	`function`

Set Cover Image From Generation

agents/visual/setCoverImageFromGeneration

Node module (base type core/Graph) defined in src/talemate/agents/visual/modules/set-cover-image-from-generation.json.

Inputs

Input	Type	Description
`state`	`any`
`generation_response`	`visual/generation_response`
`reference_for`	`list`	(optional)

Outputs

Output	Type	Description
`state`	`any`
`generation_response`	`visual/generation_response`
`asset_id`	`str`
`reference_for`	`list`

Wsh Generate Visual Asset Tags

agents/visual/wshGenerateVisualAssetTags

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-generate-visual-asset-tags.json.

Outputs

Output	Type	Description
`fn`	`function`
`name`	`str`
`allow_multiple_calls`	`bool`
`ai_callback`	`focal/callback`

Properties

Property	Type	Default	Description
`agent`	`str`	`"visual"`	The agent to register the handler on. Choices are generated at runtime.
`name`	`str`	`"generate_tags"`	The name of the handler

Wsh Regenerate Visual Asset

agents/visual/wshRegenerateVisualAsset

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-regenerate-visual-asset.json.

Outputs

Output	Type	Description
`fn`	`function`
`name`	`str`
`allow_multiple_calls`	`bool`
`ai_callback`	`focal/callback`

Properties

Property	Type	Default	Description
`name`	`str`	`"revisualize"`	The name of the handler
`agent`	`str`	`"visual"`	The agent to register the handler on. Choices are generated at runtime.

Wsh Visualize

agents/visual/wshVisualize

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/visual/modules/wsh-visualize.json.

Outputs

Output	Type	Description
`fn`	`function`
`name`	`str`
`allow_multiple_calls`	`bool`
`ai_callback`	`focal/callback`

Properties

Property	Type	Default	Description
`agent`	`str`	`"visual"`	The agent to register the handler on. Choices are generated at runtime.
`name`	`str`	`"visualize"`	The name of the handler

8.2 KiB Raw Blame History

Visualizer Agent Modules

Determine Visual References

Generate Avatar

Generate Character Portrait Legacy

Generate Image Edit

Generate Visual Asset

Regenerate Visual Asset

Set Cover Image From Generation

Wsh Generate Visual Asset Tags

Wsh Regenerate Visual Asset

Wsh Visualize

8.2 KiB

Raw Blame History