f38d330ba1
* fix: node code bugs from docstring audit (#115) - runtime crashes, phantom/duplicate sockets, registry typo aliases, property default mismatches * fix: address PR #122 review - register template scene types on intent_state, StageExit node_state_pop, annotations, shared graph-test helpers, migration round-trip test * docs: correct the circular-import chain named in apply_to_scene's deferral comment * fix: SetScenePhase defaults to the shipped roleplay scene type instead of an empty string that errors on run
11 KiB
Context ID Nodes
Context IDs address pieces of scene context (character attributes, world entries, etc.) with a uniform string format so they can be read, written, pinned and rendered generically.
11 nodes.
| Node | Registry path |
|---|---|
| Character Context IDs | context_id/CharacterContextIDs |
| Compress Context ID Part | context_id/CompressContextIDPart |
| Context ID Get Value | context_id/ContextIDGetValue |
| Context ID Meta Entries | context_id/ContextIDMetaEntries |
| Context ID Set Value | context_id/ContextIDSetValue |
| Is Pin Active | context_id/IsPinActive |
| Path to Context ID | context_id/PathToContextID |
| Remove Pin | context_id/RemovePin |
| Render Context IDs | context_id/RenderContextIDs |
| Scan Context IDs | context_id/ScanContextIDs |
| Set Pin | context_id/SetPin |
Character Context IDs
context_id/CharacterContextIDs
Unpack a character into context ID items for its various context entries (attributes, details, description, acting instructions and example dialogue).
Inputs
| Input | Type | Description |
|---|---|---|
character |
character |
The character to get context ID items for |
Outputs
| Output | Type | Description |
|---|---|---|
character |
character |
The character input, passed through |
attributes |
list |
List of context ID items for the character's attributes |
details |
list |
List of context ID items for the character's details |
description |
context_id_item |
Context ID item for the character's description |
acting_instructions |
context_id_item |
Context ID item for the character's acting instructions |
example_dialogue |
list |
List of context ID items for the character's example dialogue |
Compress Context ID Part
context_id/CompressContextIDPart
Compress a context ID part name into the short hash identifier used inside context IDs (truncated SHA256).
Inputs
| Input | Type | Description |
|---|---|---|
part |
str |
The part name to compress |
Outputs
| Output | Type | Description |
|---|---|---|
uncompressed |
str |
The original part, passed through |
compressed |
str |
The compressed part |
Context ID Get Value
context_id/ContextIDGetValue
Get the value of a context ID
Inputs
| Input | Type | Description |
|---|---|---|
context_id_item |
context_id_item |
Outputs
| Output | Type | Description |
|---|---|---|
context_id_item |
context_id_item |
|
value |
any |
Context ID Meta Entries
context_id/ContextIDMetaEntries
Get all defined context ID meta entries for the active scene, sorted by context ID.
Outputs
| Output | Type | Description |
|---|---|---|
meta_entries |
list |
List of context ID meta entries |
context_id_types |
list |
List of unique context ID types found in the entries |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
filter_creative |
bool |
False |
Filter creative context ID meta entries |
Context ID Set Value
context_id/ContextIDSetValue
Set the value of a context ID entry in the active scene.
The target entry can be given either as a context ID item or as a path string (one of the two must be set). Raises an error if the entry cannot be resolved.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
context_id_item |
context_id_item |
The context ID item to set the value for (optional) |
path |
str |
The context ID path to set the value for (optional) |
value |
any |
The value to set |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
context_id_item |
context_id_item |
The context ID item that was set |
path |
str |
The path input, passed through |
value |
any |
The value that was set |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
path |
str |
"" |
The path to set the value for |
Is Pin Active
context_id/IsPinActive
Check whether the world state pin for a context entry is currently active.
The target entry can be given either as a context ID item or as a path string (one of the two must be set).
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
context_id_item |
context_id_item |
The context ID item to check (optional) |
path |
str |
The context ID path to check (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
context_id_item |
context_id_item |
The context ID item that was checked |
path |
str |
The path input, passed through |
active |
bool |
Whether the pin is active |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
path |
str |
"" |
The path to the context ID item |
Path to Context ID
context_id/PathToContextID
Resolve a context ID path string into a context ID item and retrieve its current value from the active scene.
Inputs
| Input | Type | Description |
|---|---|---|
path |
str |
The context ID path to resolve |
Outputs
| Output | Type | Description |
|---|---|---|
context_id |
context_id |
The resolved context ID (None if the path could not be resolved) |
context_id_item |
context_id_item |
The resolved context ID item (None if the path could not be resolved) |
human_id |
str |
Human readable identifier of the resolved item |
as_dict |
dict |
The resolved item as a dictionary (empty if not resolved) |
name |
str |
The name of the resolved item |
value |
any |
The current value stored at the context ID |
exists |
bool |
Whether the path resolved to an existing context ID item |
context_type |
str |
The context type of the resolved item |
path |
str |
The path input, passed through |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
path |
str |
"" |
The path to convert to a context ID |
Remove Pin
context_id/RemovePin
Remove the world state pin for a context entry and reload the scene's active pins.
The target entry can be given either as a context ID item or as a path string (one of the two must be set).
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
context_id_item |
context_id_item |
The context ID item to unpin (optional) |
path |
str |
The context ID path to unpin (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
context_id_item |
context_id_item |
The context ID item that was unpinned |
path |
str |
The path input, passed through |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
path |
str |
"" |
The path to the context ID item |
Render Context IDs
context_id/RenderContextIDs
Render a list of context ID items to prompt-ready text using the
common.context_id_items prompt template.
A single item may be passed instead of a list and will be wrapped automatically.
Inputs
| Input | Type | Description |
|---|---|---|
items |
list,context_id_item |
List of context ID items to render (a single item is also accepted) |
Outputs
| Output | Type | Description |
|---|---|---|
items |
list |
The list of items that was rendered |
rendered |
str |
The rendered text |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
display_mode |
str |
"compact" |
Display mode. Choices: compact, subsection, normal. |
Scan Context IDs
context_id/ScanContextIDs
Scan text for context ID references, resolve them against the active scene and return the results in various formats.
Resolved items are rendered through the common.context_id_items prompt
template and also wrapped in a dynamic instruction that can be injected
into agent prompts.
Inputs
| Input | Type | Description |
|---|---|---|
text |
str |
The text to scan for context IDs |
Outputs
| Output | Type | Description |
|---|---|---|
dynamic_instruction |
dynamic_instruction |
Dynamic instruction containing the rendered context items |
rendered |
str |
The rendered text of the resolved items |
context_id_items |
list |
List of resolved context ID items |
unresolved |
list |
List of context ID references that could not be resolved |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
header |
str |
"Relevant Context" |
The header of the dynamic instruction |
display_mode |
str |
"compact" |
The display mode of the dynamic instruction. Choices: compact, subsection, normal. |
Set Pin
context_id/SetPin
Create or update a world state pin for a context entry, pinning it into the AI context. The target entry can be given either as a context ID item or as a path (one of the two must be set).
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
context_id_item |
context_id_item |
The context ID item to pin (optional) |
path |
str |
The context ID path to pin (optional) |
condition |
str |
AI-evaluated condition that determines whether the pin is active (optional) |
condition_state |
bool |
The current evaluation state of the condition (optional) |
active |
bool |
Whether the pin is active (optional) |
decay |
int |
Number of cycles the pin remains active once set, 0 for no decay (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
context_id_item |
context_id_item |
The context ID item that was pinned |
path |
str |
The path input, passed through |
condition |
str |
The condition that was set |
condition_state |
bool |
The condition state that was set |
active |
bool |
The active state that was set |
decay |
int |
The decay that was set |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
path |
str |
"" |
The path to the context ID item |
condition |
str |
"" |
The condition to set the pin |
condition_state |
bool |
False |
The condition state to set the pin |
active |
bool |
False |
The active state to set the pin |
decay |
int |
0 |
Number of cycles the pin remains active once set |