mirror of
https://github.com/vegu-ai/talemate.git
synced 2026-09-02 03:59:12 +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
Input Nodes
Receive and process player input inside the scene loop.
2 nodes.
| Node | Registry path |
|---|---|
| Process Input | input/ProcessInput |
| Get Input | input/WaitForInput |
Process Input
input/ProcessInput
Node module (base type core/Graph) defined in src/talemate/game/engine/nodes/modules/scene/process-input.json.
Inputs
| Input | Type | Description |
|---|---|---|
text |
str |
|
interaction_state |
interaction_state |
|
character |
character |
(optional) |
Outputs
| Output | Type | Description |
|---|---|---|
text |
str |
|
interaction_state |
interaction_state |
|
cleaned_input |
str |
Get Input
input/WaitForInput
Get input from the user to interact with the scene.
This node will wait for the user to input a message, and then return the message for processing.
Properties
- allow_commands: Allow commands to be executed, using the ! prefix
Abort Conditions:
The chain of nodes connected to the abort_condition socket will be executed on each iteration of the input loop. If the chain resolves to a boolean value, the input loop will be aborted.
You can use this to check for conditions that should abort the input loop.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The current graph state |
player_character |
character |
(optional) The player character |
reason |
str |
(optional) The reason for the input |
prefix |
str |
(optional) The prefix for the input message (similar to a cli prompt) |
abort_condition |
any |
(optional) A condition to abort the input loop |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
input |
str |
The input message |
interaction_state |
interaction_state |
The interaction state |
character |
character |
The character object |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
reason |
str |
"talk" |
The reason for the input |
prefix |
str |
"" |
The prefix for the input message (similar to a cli prompt) |
allow_commands |
bool |
True |
Allow commands to be executed, using the ! prefix |