World State Agent Nodes

World state operations through the world state agent: advance time, run character progression, evaluate queries, extract character sheets and emit the world state to the frontend.

13 nodes.

Node	Registry path
Advance Time	agents/world_state/AdvanceTime
Character Progression	agents/world_state/CharacterProgression
Deactivate Character	agents/world_state/DeactivateCharacter
Determine Character Avatar	agents/world_state/determineCharacterAvatar
Determine Character Presence	agents/world_state/DetermineCharacterPresence
Emit World State	agents/world_state/EmitWorldState
Evaluate Query	agents/world_state/EvaluateQuery
Extract Character Sheet	agents/world_state/ExtractCharacterSheet
Request World State	agents/world_state/RequestWorldState
Worldstate Settings	agents/world_state/Settings
State Reinforcement	agents/world_state/StateReinforcement
Wsh Advance Time	agents/world_state/wshAdvanceTime
Wsh Determine Avatar	agents/world_state/wshDetermineAvatar

Advance Time

agents/world_state/AdvanceTime

Advances the scene time by the given ISO 8601 duration. Pushes a TimePassageMessage to the scene history, emits it to the UI and fires the time passage signal (which other agents may react to, e.g. to narrate the time passage using the narration instructions).

Inputs

Input	Type	Description
state	any	The graph state
duration	str	The duration to advance as an ISO 8601 duration (e.g. "PT1H")
narration_instructions	str	Instructions for narrating the time passage (optional)

Outputs

Output	Type	Description
state	any	The state input, passed through
duration	str	The duration of the emitted message
narration_instructions	str	The narration instructions, passed through
message	message	The TimePassageMessage that was added to the history

Properties

Property	Type	Default	Description
narration_instructions	str	""	The instructions for the narration
duration	str	"P0T1S"	The duration to advance

Character Progression

agents/world_state/CharacterProgression

Determines character development (new, updated or removed attributes, description updates) via the world_state agent and processes the resulting proposals. With as_suggestions enabled the proposals are added to the world state manager as suggestions for the user to review; otherwise they are applied to the character directly.

Inputs

Input	Type	Description
state	any	The graph state
character	character	The character to progress
instructions	str	(optional) Instructions guiding the development (required at runtime despite the optional socket)

Outputs

Output	Type	Description
state	any	The state input, passed through
calls	list	The list of proposal calls that were generated

Properties

Property	Type	Default	Description
as_suggestions	bool	False	Whether to return the result as suggestions
instructions	text	""	Instructions for the character progression

Deactivate Character

agents/world_state/DeactivateCharacter

Deactivates a character from the world state.

Inputs

Input	Type	Description
state	any	The current state of the graph
character	character	The character to deactivate

Outputs

Output	Type	Description
state	any	The updated state

Determine Character Avatar

agents/world_state/determineCharacterAvatar

Node module (base type core/Graph) defined in src/talemate/agents/world_state/modules/determine-character-avatar.json.

Inputs

Input	Type	Description
state	any
character	character
content	str
force_regenerate	bool	(optional)
force_determine	bool	(optional)
asset_ctx	asset_attachment_context	(optional)

Outputs

Output	Type	Description
state	any
character	character
content	str
force_regenerate	bool
asset_id	str
force_determine	bool
asset_ctx	asset_attachment_context

Determine Character Presence

agents/world_state/DetermineCharacterPresence

Determines whether a character is present (and active) or leaving the current scene.

Mode is controlled via the check property: - present: calls world_state.is_character_present(character.name) - leaving: calls world_state.is_character_leaving(character.name)

Inputs

Input	Type	Description
state	any	The current graph state
character	character	The character to check

Outputs

Output	Type	Description
yes	bool	True if the condition is met
no	bool	True if the condition is not met

Properties

Property	Type	Default	Description
check	str	"present"	Which condition to check. Choices: present, leaving.

Emit World State

agents/world_state/EmitWorldState

Re-emits the scene's current world state to the frontend so the world state UI refreshes. Does not regenerate or update the world state.

Inputs

Input	Type	Description
state	any	The graph state

Outputs

Output	Type	Description
state	any	The state input, passed through

Evaluate Query

agents/world_state/EvaluateQuery

Evaluates a query on the world state.

Inputs

Input	Type	Description
state	any	The current state of the graph
query	str	The query to evaluate
context	str	The context to evaluate the query in

Outputs

Output	Type	Description
state	any	The current state
result	bool	The result of the query

Properties

Property	Type	Default	Description
query	str	unset	The query to evaluate

Extract Character Sheet

agents/world_state/ExtractCharacterSheet

Attempts to extract an attribute based character sheet from a given context for a specific character.

Additionally alteration instructions can be given to modify the character's existing sheet.

Inputs

Input	Type	Description
state	any	The current state of the graph
character_name	str	The name of the character to extract the sheet for
context	str	The context to extract the sheet from
alteration_instructions	str	(optional) Instructions to alter the character's sheet

Outputs

Output	Type	Description
character_sheet	dict	The extracted character sheet (dict, empty if the model produced nothing)

Request World State

agents/world_state/RequestWorldState

Requests the current world state.

Inputs

Input	Type	Description
state	any	The current state of the graph

Outputs

Output	Type	Description
state	any	The current state
world_state	dict	The current world state

Worldstate Settings

agents/world_state/Settings

Base node to render world_state agent settings.

Every setting of the world_state agent is exposed as an output socket named after the setting - see the agent's documentation under Agents for what each setting does.

State Reinforcement

agents/world_state/StateReinforcement

Sets up (or updates) a tracked state reinforcement for a character or the world in general. Adds the reinforcement to the scene's world state, then immediately runs an update, producing a reinforcement message.

Inputs

Input	Type	Description
state	any	The current state of the graph
query_or_detail	str	The question or detail to track
character	character	(optional) The character to track the state for (optional; when omitted the state is tracked for the world in general)
instructions	str	Additional instructions for the reinforcement (optional)

Outputs

Output	Type	Description
state	any	graph state
message	message	state reinforcement message
reinforcement	world_state/reinforcement	the reinforcement that was added or updated

Properties

Property	Type	Default	Description
query_or_detail	str	""	Query or detail to reinforce
instructions	text	""	Instructions for the reinforcement
interval	int	10	Interval for reinforcement. Min: 1.
insert_method	str	"sequential"	Method to insert reinforcement. Choices: sequential, conversation-context, all-context, never.
reset	bool	False	If the state should be reset

Wsh Advance Time

agents/world_state/wshAdvanceTime

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/world_state/modules/wsh-advance-time.json.

Outputs

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

Properties

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

Wsh Determine Avatar

agents/world_state/wshDetermineAvatar

Node module (base type agents/AgentWebsocketHandler) defined in src/talemate/agents/world_state/modules/wsh-determine-avatar.json.

Outputs

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

Properties

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