Director Chat Actions

The actions the director chat AI can take. Each module defines one callable action — its name, description and instructions (shown in the properties below) are what the director AI sees when deciding what to do. Director Action Summary formats the results of several calls on separate lines before the director continues.

10 nodes.

Node	Registry path
Director Action Create Image	agents/director/chat/directorActionCreateImage
Director Action Direct Scene	agents/director/chat/directorActionDirectScene
Director Action Direct Story Arc	agents/director/chat/directorActionDirectStoryArc
Director Action Gameplay	agents/director/chat/directorActionGameplay
Director Action Prompt User	agents/director/chat/directorActionPromptUser
Director Action Query	agents/director/chat/directorActionQuery
Director Action Summary	agents/director/chat/directorActionSummary
Director Action Update Context	agents/director/chat/directorActionUpdateContext
Director Action Update Gamestate	agents/director/chat/directorActionUpdateGamestate
Director Action Yield To User	agents/director/chat/directorActionYieldToUser

Director Action Create Image

agents/director/chat/directorActionCreateImage

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-create-image.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"create_image"	The name of the action
description	text	""	The description of the action
example_json	text	"[]"	An example JSON payload for the action
instructions	text	"Instruct the artist to generate an image for you. Be detailed and specific as the artist's contextual understanding may be more limited than yours."	The instructions for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Direct Scene

agents/director/chat/directorActionDirectScene

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-direct-scene.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"direct_scene"	The name of the action
description	text	"Instruct the writer to produce the next segment of narration or dialogue. IMPORTANT: Do NOT provide verbatim narration or dialogue. Just instruct the writer w…	The description of the action
instructions	text	"Instruct the writer to progress the scene either through narration or writing the next character segment. IMPORTANT: When the instructions include direction f…	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Direct Story Arc

agents/director/chat/directorActionDirectStoryArc

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-direct-story-arc.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"direct_story_arc"	The name of the action
description	text	"Generate a complete story arc from the active plan's beats. All beats are expanded into prose in chunks and pushed to scene history automatically. Use this ins…	The description of the action
instructions	text	""	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Gameplay

agents/director/chat/directorActionGameplay

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-gameplay.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"gameplay"	The name of the action
description	text	"Available gameplay utilities that can help you solve game mechanics."	The description of the action
instructions	text	"Pass a clear natural-language description of what you want to do."	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Prompt User

agents/director/chat/directorActionPromptUser

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-prompt-user.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"ooc"	The name of the action
description	text	"Interface for out of character communication with the user while remaining within the context of the scene."	The description of the action
instructions	text	""	The instructions for the action
example_json	text	None	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Query

agents/director/chat/directorActionQuery

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-query.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"query"	The name of the action
description	text	"Your main way to learn information. Avoid generic queries and try to be specific. The following topics are available for investigation:"	The description of the action
instructions	text	"Instruct another agent to retrieve information about the scene, world and its characters. When looking to retrieve character specific information for a specifi…	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	True	Whether the action can be called concurrently

Director Action Summary

agents/director/chat/directorActionSummary

Node module (base type core/Graph) defined in src/talemate/agents/director/modules/director-action-summary.json.

Inputs

Input	Type	Description
calls	list
batch	list	(optional)

Outputs

Output	Type	Description
summary	str

Director Action Update Context

agents/director/chat/directorActionUpdateContext

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-update-context.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"update_context"	The name of the action
description	text	"Instruct another agent to make changes to the story context. IMPORTANT: - Changes to existing context: you MUST ALWAYS provide the specific Context ID of the…	The description of the action
instructions	text	"Instruct another agent to make changes to the World, Characters, History or Story configuration. Changes can mean updates, creations or removals."	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Update Gamestate

agents/director/chat/directorActionUpdateGamestate

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-update-gamestate.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"update_gamestate"	The name of the action
description	text	"Instruct another agent to make updates to any game state variables. You should query for relevant game state variables BEFORE using this. If you're changing e…	The description of the action
instructions	text	"Make updates to the game state variables."	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently

Director Action Yield To User

agents/director/chat/directorActionYieldToUser

Node module (base type agents/director/DirectorChatAction) defined in src/talemate/agents/director/modules/director-action-yield-to-user.json.

Outputs

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

Properties

Property	Type	Default	Description
name	str	"yield_to_user"	The name of the action
description	text	"Yield the turn to the user. You do not need to pass any instructions to this action."	The description of the action
instructions	text	"Yield the turn to the user"	The instructions for the action
example_json	text	"[]"	An example JSON payload for the action
allow_concurrent	bool	False	Whether the action can be called concurrently