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
2.4 KiB
2.4 KiB
Flow Exception Nodes
Stop or redirect graph execution by raising exceptions: Stop ends the current run, Input Value Error reports invalid socket input, and Acted As Character signals that a character turn happened. See Error Handling.
3 nodes.
| Node | Registry path |
|---|---|
| Acted As Character | raise/ActedAsCharacter |
| Input Value Error | raise/InputValueError |
| Stop | raise/Stop |
Acted As Character
raise/ActedAsCharacter
Raises an ActedAsCharacter exception.
This is used to communicate to the main scene loop that the user has performed an action as a specific character.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current graph state |
character_name |
str |
The name of the character the user acted as |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
Input Value Error
raise/InputValueError
Raises an InputValueError exception.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state |
message |
str |
The message to raise the exception with |
field |
str |
The field that caused the error |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
message |
str |
"" |
The message to raise the exception with |
field |
str |
"" |
The field that caused the error |
Stop
raise/Stop
Raises the specified node / scene loop exception to stop execution of the current graph
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current state |
exception |
any |
(optional) The exception to raise |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The current state |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
exception |
str |
"StopGraphExecution" |
Exception. Choices: StopGraphExecution, StopModule, LoopBreak, LoopContinue, LoopExit, ExitScene, RestartSceneLoop, ResetScene, StageExit. |