linting

- Introduced a new function `relative_to_root` in path.py to resolve paths relative to the TALEMATE_ROOT.
- Updated the `export_node_definitions` function in registry.py to use `relative_to_root` for module path resolution.
- Added a check to skip non-selectable node definitions in litegraphUtils.js during registration.

.gitignore

@@ -31,4 +31,5 @@ scenes/
 !scenes/infinity-quest/infinity-quest.json
 tts_voice_samples/*.wav
 third-party-docs/
-legacy-state-reinforcements.yaml
+legacy-state-reinforcements.yaml
+CLAUDE.md

docs/getting-started/installation/windows.md

@@ -12,14 +12,6 @@
 !!! note "First start can take a while"
     The initial download and dependency installation may take several minutes, especially on slow internet connections. The console will keep you updated – just wait until the Talemate logo shows up.
 
-### Optional: CUDA support
-
-If you have an NVIDIA GPU and want CUDA acceleration for larger embedding models:
-
-1. Close Talemate (if it is running).
-2. Double-click **`install-cuda.bat`**. This script swaps the CPU-only Torch build for the CUDA 12.8 build.
-3. Start Talemate again via **`start.bat`**.
-
 ## Maintenance & advanced usage
 
 | Script | Purpose |

docs/user-guide/agents/director/chat.md

@@ -0,0 +1,125 @@
+# Director Chat
+
+!!! example "Experimental"
+    Currently experimental and may change substantially in the future.
+
+Introduced in version 0.33.0 the director chat feature allows you interact with the director agent directly once a scene is loaded.
+
+As part of the chat session the director can query for information as well as make changes to the scene.
+
+!!! warning "Strong model recommended"
+    In my personal testing I've found that while its possible to have a coherent chat session with weaker models, the experience is going to be
+    significantly better with [reasoning enabled](/talemate/user-guide/clients/reasoning/) models past the 100B parameter mark.
+
+    This may change as smaller models get stronger and your mileage may vary.
+
+!!! info "Chat settings"
+    You can customize various aspects of the director chat behavior in the [Director Chat settings](/talemate/user-guide/agents/director/settings/#director-chat), including response length, token budgets, and custom instructions.
+
+## Accessing the director chat
+
+Once a scene is loaded click the **:material-bullhorn:** director console icon in the top right corner of the screen.
+
+![Director Console](/talemate/img/0.33.0/open-director-console.png)
+
+![Director Console](/talemate/img/0.33.0/director-console-chat.png)
+
+## Chat interface
+
+The director chat provides a conversational interface where you can ask the director to perform various tasks, from querying information about your scene to making changes to characters, world entries, and progressing the story.
+
+![Director Chat Interaction](/talemate/img/0.33.0/director-chat-interaction.png)
+
+### What can you ask the director to do?
+
+The director can help you with many tasks:
+
+- Progress the story by generating new narration or dialogue
+- Answer questions about your characters, world, or story details
+- Create or modify characters, world entries, and story configuration
+- Advance time in your story
+- Manage game state variables (if your story uses them)
+
+Simply describe what you want in natural language, and the director will figure out how to accomplish it.
+
+### Viewing action details
+
+When the director performs an action, you can expand it to see exactly what was done:
+
+![Expanded Function Call](/talemate/img/0.33.0/director-chat-expanded-function-call.png)
+
+This gives you full transparency into the changes being made to your scene.
+
+## Chat modes
+
+The director chat supports three different modes that control how the director behaves:
+
+![Chat Mode Selection](/talemate/img/0.33.0/director-chat-mode.png)
+
+!!! note
+    Chat mode behavior is not guaranteed and depends heavily on the model's ability to follow instructions. Stronger models, especially those with reasoning capabilities, will respect these modes much more consistently than weaker models.
+
+### Normal mode
+
+The default mode where the director can freely discuss the story and reveal information. It will ask for clarification when needed and take a more conversational approach.
+
+### Decisive mode
+
+In this mode, the director acts more confidently on your instructions and avoids asking for clarifications unless strictly necessary. Use this when you trust the director to make the right decisions autonomously.
+
+### No Spoilers mode
+
+This mode prevents the director from revealing information that could spoil the story. The director will still make changes and answer questions, but will be careful not to discuss plot points or details that should remain hidden.
+
+## Write action confirmation
+
+By default, the director will ask for confirmation before performing actions that modify your scene (like progressing the story or making significant changes).
+
+![Confirm On](/talemate/img/0.33.0/director-chat-confirm-on.png)
+
+You can toggle this behavior to allow the director to act without confirmation:
+
+![Confirm Off](/talemate/img/0.33.0/director-chat-confirm-off.png)
+
+!!! tip
+    Keep confirmation enabled when experimenting or when you want more control over changes. Disable it when you trust the director to act autonomously.
+
+### Confirmation workflow example
+
+When confirmation is enabled, the director will describe what it plans to do and wait for your approval:
+
+![Confirmation Request](/talemate/img/0.33.0/director-chat-0001.png)
+
+The confirmation dialog shows the instructions that will be sent and the expected result:
+
+![Confirmation Dialog](/talemate/img/0.33.0/director-chat-0002.png)
+
+Once confirmed, the action executes and new content is added to your scene:
+
+![Action Approved](/talemate/img/0.33.0/director-chat-0003.png)
+
+The director then analyzes the result and discusses what happened:
+
+![Result Analysis](/talemate/img/0.33.0/director-chat-0004.png)
+
+### Rejecting actions
+
+You can also reject actions if you change your mind or want to revise your request:
+
+![Action Rejection Request](/talemate/img/0.33.0/director-chat-reject-0001.png)
+
+When rejected, the director acknowledges and waits for your next instruction:
+
+![Action Rejected](/talemate/img/0.33.0/director-chat-reject-0002.png)
+
+## Director personas
+
+You can customize the director's personality and initial greeting by assigning a persona:
+
+![Persona Selection](/talemate/img/0.33.0/director-chat-persona-0001.png)
+
+Personas can completely change how the director presents itself and communicates with you:
+
+![Persona Example](/talemate/img/0.33.0/director-chat-persona-0002.png)
+
+To create or manage personas, select "Manage Personas" from the persona dropdown. You can define a custom description and initial chat message for each persona.

docs/user-guide/agents/director/settings.md

@@ -154,4 +154,56 @@ Allows the director to evaluate the current scene phase and switch to a differen
 The number of turns between evaluations. (0 = NEVER)
 
 !!! note "Recommended to leave at 0 (never)"
-    This isn't really working well at this point, so recommended to leave at 0 (never)
+    This isn't really working well at this point, so recommended to leave at 0 (never)
+
+## Director Chat
+
+!!! example "Experimental"
+    Currently experimental and may change substantially in the future.
+
+The [Director Chat](/talemate/user-guide/agents/director/chat) feature allows you to interact with the director through a conversational interface where you can ask questions, make changes to your scene, and direct story progression.
+
+![Director Chat Settings](/talemate/img/0.33.0/director-agent-chat-settings.png)
+
+##### Enable Analysis Step
+
+When enabled, the director performs an internal analysis step before responding. This helps the director think through complex requests and plan actions more carefully.
+
+!!! tip "Recommended for complex tasks"
+    Enable this when working on complex scene modifications or when you want more thoughtful responses. Disable it for simple queries to get faster responses.
+
+##### Response token budget
+
+Controls the maximum number of tokens the director can use for generating responses. Higher values allow for more detailed responses but use more tokens. Default is 2048.
+
+##### Auto-iteration limit
+
+The maximum number of action-response cycles the director can perform in a single interaction. For example, if set to 10, the director can execute actions and generate follow-up responses up to 10 times before requiring your input again. Default is 10.
+
+##### Retries
+
+The number of times the director will retry if it encounters an error during response generation. Default is 1.
+
+##### Scene context ratio
+
+Controls the fraction of the remaining token budget (after fixed context and instructions) that is reserved for scene context. The rest is allocated to chat history.
+
+- **Lower values** (e.g., 0.30): 30% for scene context, 70% for chat history
+- **Higher values** (e.g., 0.70): 70% for scene context, 30% for chat history
+
+Default is 0.30.
+
+##### Stale history share
+
+When the chat history needs to be compacted (summarized), this controls what fraction of the chat history budget is treated as "stale" and should be summarized. The remaining portion is kept verbatim as recent messages.
+
+- **Lower values** (e.g., 0.50): Summarize less (50%), keep more recent messages verbatim
+- **Higher values** (e.g., 0.90): Summarize more (90%), keep fewer recent messages verbatim
+
+Default is 0.70 (70% will be summarized when compaction is triggered).
+
+##### Custom instructions
+
+Add custom instructions that will be included in all director chat prompts. Use this to customize the director's behavior for your specific scene or storytelling style.
+
+For example, you might add instructions to maintain a particular tone, follow specific genre conventions, or handle certain types of requests in a particular way.

docs/user-guide/clients/template-locking.md

@@ -0,0 +1,70 @@
+# Template Locking
+
+Template locking allows you to prevent a client's prompt template from automatically updating when the model changes. This is useful when you want to maintain a consistent prompt format across different models or when you've customized a template for a specific use case.
+
+## What is Template Locking?
+
+By default, Talemate automatically determines the appropriate prompt template for each model you load. When you switch models, the prompt template updates to match the new model's requirements. Template locking disables this automatic behavior, keeping your selected template fixed regardless of model changes.
+
+## When to Use Template Locking
+
+Some models have reasoning and non-reasoning variants of their templates. This allows you to lock one client to the reasoning template and another to the non-reasoning template.
+
+## How to Lock a Template
+
+### Step 1: Open Client Settings
+
+Start with your client that has a template already assigned (either automatically detected or manually selected):
+
+![Lock Template - Starting Point](/talemate/img/0.33.0/client-lock-template-0001.png)
+
+1. Open the client settings by clicking the cogwheels icon next to the client
+2. Review the currently assigned template in the preview area
+
+### Step 2: Enable Template Lock
+
+When you check the **Lock Template** checkbox, the current template selection is cleared and you must select which template to lock:
+
+![Lock Template - Select Template](/talemate/img/0.33.0/client-lock-template-0002.png)
+
+1. Check the **Lock Template** checkbox
+2. You'll see the message: "Please select a prompt template to lock for this client"
+3. Select your desired template from the dropdown menu
+
+This gives you the opportunity to choose which specific template you want to lock, rather than automatically locking whatever template happened to be active.
+
+### Step 3: Template Locked
+
+Once you've selected a template and clicked **Save**:
+
+![Lock Template - Locked](/talemate/img/0.33.0/client-lock-template-0003.png)
+
+- The template display shows your locked template with its name (e.g., `TextGenWebUI__LOCK.jinja2`)
+- The template will no longer automatically update when you change models
+- The lock icon indicates the template is fixed
+
+## Understanding the Lock Template Setting
+
+When the **Lock Template** checkbox is enabled:
+
+- The prompt template will not automatically update when you change models
+
+When disabled:
+
+- Talemate automatically determines the best template for your loaded model
+- Templates update when you switch models
+- The system attempts to match templates via HuggingFace metadata
+
+## Unlocking a Template
+
+To return to automatic template detection:
+
+1. Open the client settings
+2. Uncheck the **Lock Template** checkbox
+3. Click **Save**
+4. Re-open the client settings and confirm that the template is no longer locked and the correct template is selected.
+
+## Related Topics
+
+- [Prompt Templates](/talemate/user-guide/clients/prompt-templates/) - Learn more about how prompt templates work
+- [Client Configuration](/talemate/user-guide/clients/) - General client setup and configuration

docs/user-guide/howto/infinity-quest-dynamic/2-initial-nodes.md

@@ -14,7 +14,7 @@ We **do not** care about changing any of the actual loop logic.
 
 With this in mind we can extend a new scene loop from the default talemate loop. This will give us a copy of the default loop that we can add to while keeping the rest of the loop logic up to date with any future improvements.
 
-The `scene-loop` module should already be selected in the **:material-group: Modules** library.
+The `scene-loop` module should already be selected in the **:material-tree-view: Modules** library.
 
 ![Scene Loop](./img/2-0001.png)
 

docs/user-guide/node-editor/core-concepts/collector_nodes.md

@@ -0,0 +1,333 @@
+# Collector Nodes
+
+!!! info "New in version 0.33"
+    Collector nodes with dynamic sockets were introduced in Talemate version 0.33.0.
+
+Collector nodes are specialized nodes that aggregate multiple inputs into a single data structure. They feature **dynamic sockets** that can be added or removed as needed, making them flexible for various data aggregation scenarios.
+
+## Types of Collector Nodes
+
+### Dict Collector
+
+![Dict Collector](../img/dict-collector.png)
+
+**Expected output from the example above:**
+
+```json
+{
+    "some_variable": "hello",
+    "auto_save": true
+}
+```
+
+The **Dict Collector** node collects key-value pairs into a dictionary.
+
+**Inputs:**
+
+- `dict` (optional): An existing dictionary to add items to
+- `item{i}` (dynamic): Multiple dynamic input slots for key-value pairs
+
+**Outputs:**
+
+- `dict`: The resulting dictionary containing all collected key-value pairs
+
+**How it works:**
+
+1. Each dynamic input can accept either:
+   - A **tuple** in the format `(key, value)` from nodes like [Make Key-Value Pair](../img/dict-collector.png)
+   - Any **value**, in which case the key is inferred from the connected node's properties
+
+2. When a tuple `(key, value)` is provided, the key and value are directly added to the dictionary
+
+3. When a non-tuple value is provided, the collector attempts to infer the key name by checking the source node for:
+   - A `name` property/input
+   - A `key` property/input
+   - An `attribute` property/input
+   - Falls back to the socket name if none are found
+
+4. The final dictionary contains all collected key-value pairs
+
+**Common use cases:**
+
+- Collecting multiple values into a structured dictionary
+- Building configuration objects from separate nodes
+- Aggregating character properties or attributes
+- Creating data structures from unpacked objects
+
+### List Collector
+
+![List Collector](../img/list-collector.png)
+
+**Expected output from the example above:**
+
+```json
+["hello", "world"]
+```
+
+The **List Collector** node collects items into a list.
+
+**Inputs:**
+
+- `list` (optional): An existing list to append items to
+- `item{i}` (dynamic): Multiple dynamic input slots for list items
+
+**Outputs:**
+
+- `list`: The resulting list containing all collected items
+
+**How it works:**
+
+1. Each dynamic input accepts any value type
+2. Values are appended to the list in the order of the dynamic inputs (item0, item1, item2, etc.)
+3. If an existing list is provided, new items are appended to it
+4. If no list is provided, a new empty list is created
+
+**Common use cases:**
+
+- Collecting multiple values into an ordered list
+- Aggregating results from multiple nodes
+- Building lists for iteration or processing
+- Combining outputs from multiple sources
+
+## Managing Dynamic Sockets
+
+Collector nodes support **dynamic input sockets** that can be added or removed as needed.
+
+### Adding Input Sockets
+
+There are two ways to add input sockets:
+
+1. **Using the on-node buttons**: Click the green **+** button at the bottom of the node
+2. **Using the context menu**: Right-click the node and select `Add Input Slot`
+
+### Removing Input Sockets
+
+There are two ways to remove input sockets:
+
+1. **Using the on-node buttons**: Click the red **-** button at the bottom of the node (removes the last dynamic input)
+2. **Using the context menu**: Right-click the node and select `Remove Last Input`
+
+!!! note "Only the last dynamic input can be removed"
+    You can only remove the most recently added dynamic input. To remove an input from the middle, you must first remove all inputs after it.
+
+## Working with Key-Value Pairs
+
+When working with **Dict Collector**, you'll often use the **Make Key-Value Pair** node to create properly formatted tuple outputs.
+
+**Make Key-Value Pair Node:**
+
+- **Inputs**: `key` (string), `value` (any type)
+- **Outputs**: `kv` (tuple), `key` (string), `value` (any)
+
+The `kv` output produces a tuple in the format `(key, value)` which can be directly connected to Dict Collector's dynamic inputs.
+
+**Example:**
+
+```
+[Make Key-Value Pair]     [Make Key-Value Pair]     [Get State]
+  key: "name"               key: "age"                scope: local
+  value: "Alice"            value: 30                 name: "works"
+        ↓ kv                      ↓ kv                     ↓ value
+        └────────┐          ┌─────┘                        │
+                 ↓          ↓                               ↓
+              [Dict Collector]                         [Dict Collector]
+                item0  item1                               item2
+                     ↓
+              {"name": "Alice", "age": 30, "works": true}
+```
+
+## Nested Collection
+
+Collector nodes can be chained together to create nested data structures:
+
+- **Dict into Dict**: A Dict Collector's output can feed into another Dict Collector's `dict` input to add more key-value pairs
+- **List into List**: A List Collector's output can feed into another List Collector's `list` input to combine lists
+- **Mixed nesting**: Lists can contain dictionaries and vice versa
+
+**Example of nested collection:**
+
+```
+[Dict Collector A] → [Dict Collector B]
+  item0: ("x", 10)     dict: (from A)
+  item1: ("y", 20)     item0: ("z", 30)
+
+Result: {"x": 10, "y": 20, "z": 30}
+```
+
+## Examples
+
+### Dict Collector Example
+
+In the Dict Collector screenshot above, two nodes are connected:
+
+- **item0**: `value` output from "GET local.some_variable"
+- **item1**: `auto_save` output from "Get Scene State"
+
+Since no explicit key-value tuples are provided, the Dict Collector uses key inference:
+
+- **item0**: Infers key from the source node's `name` property → `"some_variable"`
+- **item1**: Uses the socket name → `"auto_save"`
+
+**Expected output:**
+
+```python
+{
+    "some_variable": <value from local.some_variable>,
+    "auto_save": <value from scene state's auto_save property>
+}
+```
+
+For example, if `local.some_variable` contains `"hello"` and `auto_save` is `True`:
+
+```python
+{
+    "some_variable": "hello",
+    "auto_save": True
+}
+```
+
+
+### List Collector Example
+
+In the List Collector screenshot above, two Get State nodes are connected:
+
+- **item0**: `value` from "GET local.some_variable"
+- **item1**: `value` from "GET local.other_variable"
+
+The List Collector simply appends values in order.
+
+**Expected output:**
+
+```python
+[
+    <value from local.some_variable>,
+    <value from local.other_variable>
+]
+```
+
+For example, if `local.some_variable` contains `"hello"` and `local.other_variable` contains `"world"`:
+
+```python
+["hello", "world"]
+```
+
+## String Formatting with Collected Data
+
+Collector nodes work seamlessly with formatting nodes to convert collected data into formatted strings. Two powerful formatting nodes that support dynamic inputs are **Advanced Format** and **Jinja2 Format**.
+
+### Advanced Format
+
+![Advanced Format](../img/advanced-format.png)
+
+**Expected output from the example above:**
+
+```json
+"hello world"
+```
+
+The **Advanced Format** node uses Python-style string formatting with dynamic inputs similar to Dict Collector.
+
+!!! warning "Use single curly braces `{}`"
+    Advanced Format uses Python's `.format()` syntax. Variables are referenced with **single curly braces**: `{variable_name}`
+
+**Inputs:**
+
+- `template` (required): A format string with placeholders (e.g., `"hello {hello}"`)
+- `variables` (optional): Base dictionary to merge with dynamic inputs
+- `item{i}` (dynamic): Multiple dynamic input slots for format variables
+
+**Outputs:**
+
+- `result`: The formatted string
+
+**How it works:**
+
+1. Each dynamic input can accept either:
+   - A **tuple** in the format `(key, value)`
+   - Any **value**, in which case the key is inferred from the connected node's properties (same logic as Dict Collector)
+
+2. Variables from dynamic inputs are merged with the optional `variables` dictionary
+
+3. The template is formatted using Python's `.format()` method with all collected variables
+
+4. Placeholders in the template like `{hello}` are replaced with their corresponding values
+
+**Example from screenshot:**
+
+- Template: `"hello {hello}"`
+- Dynamic input `item0`: Connected to "GET local.hello" which has value `"world"`
+- Key inferred as `"hello"` from the source node's `name` property
+- Result: `"hello world"`
+
+### Jinja2 Format
+
+![Jinja2 Format](../img/jinja2-format.png)
+
+**Expected output from the example above:**
+
+```json
+"hello world"
+```
+
+The **Jinja2 Format** node extends Advanced Format but uses Jinja2 templating instead of Python's `.format()`.
+
+!!! warning "Use double curly braces `{{}}`"
+    Jinja2 Format uses Jinja2 template syntax. Variables are referenced with **double curly braces**: `{{ variable_name }}`
+
+**Inputs:**
+
+- `template` (required): A Jinja2 template string (e.g., `"hello {{ hello }}"`)
+- `variables` (optional): Base dictionary to merge with dynamic inputs
+- `item{i}` (dynamic): Multiple dynamic input slots for template variables
+
+**Outputs:**
+
+- `result`: The rendered template string
+
+**How it works:**
+
+1. Inherits all the dynamic input behavior from Advanced Format
+2. Uses Jinja2 template syntax: `{{ variable }}` for variables, `{% %}` for logic
+3. Supports all Jinja2 features: filters, conditionals, loops, etc.
+4. Perfect for complex formatting needs beyond simple placeholder replacement
+
+**Example from screenshot:**
+
+- Template: `"hello {{ hello }}"`
+- Dynamic input `item0`: Connected to "GET local.hello" with value `"world"`
+- Key inferred as `"hello"` from the source node's `name` property
+- Result: `"hello world"`
+
+### Combining Collectors with Formatters
+
+A common pattern is to use collectors to gather data, then format it into strings:
+
+```
+[Get State] ──→ [Dict Collector] ──→ [Advanced Format]
+[Get State] ──→      item0              variables
+                     item1              ↓
+                       ↓            template: "Name: {name}, Age: {age}"
+                   {"name": "Alice",
+                    "age": 30}
+```
+
+Or use dynamic inputs directly on the formatter:
+
+```
+[Get State] ──→ [Advanced Format]
+[Get State] ──→    item0
+                   item1
+                template: "{name} is {age} years old"
+```
+
+### Format vs Advanced Format vs Jinja2 Format
+
+| Feature | Format | Advanced Format | Jinja2 Format |
+|---------|--------|-----------------|---------------|
+| **Dynamic Inputs** | No | Yes | Yes |
+| **Syntax** | Python `.format()` | Python `.format()` | Jinja2 `{{ }}` |
+| **Key Inference** | No | Yes | Yes |
+| **Conditionals** | No | No | Yes |
+| **Loops** | No | No | Yes |
+| **Filters** | No | No | Yes |
+| **Best For** | Simple static formatting | Dynamic formatting with multiple inputs | Complex templates with logic |

docs/user-guide/node-editor/core-concepts/prompt-templates.md

@@ -1,5 +1,8 @@
 # Prompt Templates
 
+!!! tip "Want a more streamlined approach?"
+    If you need quick prompts with automatic context management, check out [Prompt Building](prompt_building.md) for a simplified alternative to manual template construction.
+
 Prompt templates in the node editor allow you to create dynamic, reusable prompts that can be customized with variables and sent to agents for processing.
 
 ## Overview

docs/user-guide/node-editor/core-concepts/prompt_building.md

@@ -0,0 +1,191 @@
+# Prompt Building
+
+!!! info "New in version 0.33"
+    The Build Prompt node was introduced in Talemate version 0.33.0.
+
+The **Build Prompt** node is a high-level alternative to manually constructing prompts with templates. It automatically assembles prompts with contextual information based on configurable needs, making it much faster to create agent prompts without managing template files.
+
+## Build Prompt vs Prompt Templates
+
+While [Prompt Templates](prompt-templates.md) give you complete control over every aspect of your prompt construction, **Build Prompt** provides a streamlined approach:
+
+| Feature | Build Prompt | Prompt Templates |
+|---------|--------------|------------------|
+| **Complexity** | Simple configuration | Full template control |
+| **Context Management** | Automatic | Manual |
+| **Token Budgeting** | Built-in | Manual calculation |
+| **Setup Time** | Fast | Requires template creation |
+| **Flexibility** | Predefined options | Complete customization |
+| **Best For** | Quick prompts, standard patterns | Complex custom prompts |
+
+**Use Build Prompt when:**
+
+- You need standard contextual prompts quickly
+- You want automatic context and memory management
+- You're using common prompt patterns (analysis, direction, creation, etc.)
+
+**Use Prompt Templates when:**
+
+- You need precise control over prompt structure
+- You have complex custom requirements
+- You want to reuse specific prompt patterns across scenes
+
+## The Build Prompt Node
+
+![Build Prompt Example](../img/build_prompt.png)
+
+**Expected output from the example above:**
+
+A fully assembled prompt with:
+
+- Base template structure from `common.base`
+- Director agent context
+- Dynamic instructions: "Don't over-analyze"
+- Scene context with memory, intent, and extra context
+- Question: "Answer this question: Is there a tiger in the room?"
+
+### Inputs
+
+- **`state`**: The graph state (required)
+- **`agent`**: The agent that will receive the prompt (required)
+- **`instructions`** (optional): Text instructions to include in the prompt
+- **`dynamic_context`** (optional): List of `DynamicInstruction` objects for context
+- **`dynamic_instructions`** (optional): List of `DynamicInstruction` objects for instructions
+- **`memory_prompt`** (optional): Semantic query for memory retrieval
+
+### Outputs
+
+- **`state`**: Passthrough of the input state
+- **`agent`**: Passthrough of the input agent
+- **`prompt`**: The constructed `Prompt` object
+- **`rendered`**: The rendered prompt as a string
+- **`response_length`**: The calculated response length for token budgeting
+
+### Properties
+
+#### Template Configuration
+
+- **`template_file`** (default: `"base"`): The template file to use
+- **`scope`** (default: `"common"`): The template scope (common, agent-specific, etc.)
+
+!!! warning "Template Compatibility"
+    The Build Prompt node requires templates specifically designed to work with its configuration options. The default `common/base.jinja2` template is pre-configured to respect all the `include_*` boolean properties and dynamic instruction inputs.
+
+    If you change the `template_file` or `scope`, ensure the template is compatible with Build Prompt's variable structure, or the context control properties may not work as expected.
+
+#### Context Control
+
+- **`include_scene_intent`** (default: `true`): Include the scene's current intent/direction
+- **`include_extra_context`** (default: `true`): Include pins, reinforcements, and content classification
+- **`include_memory_context`** (default: `true`): Include relevant memories from the scene via RAG (Retrieval-Augmented Generation). Works best when `memory_prompt` is provided to guide semantic search
+- **`include_scene_context`** (default: `true`): Include scene history and state
+- **`include_character_context`** (default: `false`): Include active character details
+- **`include_gamestate_context`** (default: `false`): Include game state variables
+
+#### Advanced Settings
+
+- **`reserved_tokens`** (default: `312`): Tokens reserved from the context budget before calculating how much scene history to include. This provides a buffer for the response and any template overhead (range: 16-1024)
+- **`limit_max_tokens`** (default: `0`): Maximum token limit (0 = use client context limit)
+- **`response_length`** (default: `0`): Expected length of the response
+- **`technical`** (default: `false`): Include technical context (IDs, typing information)
+- **`dedupe_enabled`** (default: `true`): Enable deduplication in the prompt
+- **`memory_prompt`** (default: `""`): Semantic query string for memory retrieval. Provide this to guide what memories are retrieved when `include_memory_context` is enabled
+- **`prefill_prompt`** (default: `""`): Text to prefill the response
+- **`return_prefill_prompt`** (default: `false`): Return the prefill with response
+
+## Dynamic Instructions
+
+Dynamic instructions allow you to inject contextual information into prompts at runtime. They come in two types:
+
+### Dynamic Context
+
+Provides background information and context to the agent. Use the **Dynamic Instruction** node connected to the `dynamic_context` input (typically via a List Collector).
+
+### Dynamic Instructions
+
+Provides specific instructions or directives to the agent. Use the **Dynamic Instruction** node connected to the `dynamic_instructions` input (typically via a List Collector).
+
+**Dynamic Instruction Node Properties:**
+
+- **`header`**: The instruction header/title
+- **`content`**: The instruction content/body
+
+## Example Workflow
+
+The example screenshot shows a typical workflow:
+
+1. **Agent Selection**: Get the `director` agent
+2. **Dynamic Instructions**: Create a "Don't over-analyze" instruction using the Dynamic Instruction node
+3. **Collect Instructions**: Use a List Collector to gather dynamic instructions
+4. **Instructions**: Provide the main instruction via Make Text node: "Answer this question: Is there a tiger in the room?"
+5. **Build Prompt**: Configure context needs (scene intent, extra context, memory, scene context enabled)
+6. **Generate Response**: Send the built prompt to the agent with appropriate settings
+
+## Common Patterns
+
+### Simple Question Prompt
+
+```
+[Get Agent] → [Build Prompt] → [Generate Response]
+                    ↑
+            [Make Text: "Your question here"]
+```
+
+### Prompt with Dynamic Instructions
+
+```
+[Dynamic Instruction] → [List Collector] → [Build Prompt] → [Generate Response]
+[Get Agent] ────────────────────────────────────↑
+[Make Text: "Main instruction"] ────────────────↑
+```
+
+### Analysis with Full Context
+
+Enable all context options:
+- `include_scene_intent`: true
+- `include_extra_context`: true
+- `include_memory_context`: true
+- `include_scene_context`: true
+- `include_character_context`: true
+- `include_gamestate_context`: true
+
+### Quick Direction with Minimal Context
+
+Disable unnecessary context:
+- `include_character_context`: false
+- `include_gamestate_context`: false
+- `include_memory_context`: false (if not needed)
+
+## Token Budget Management
+
+Build Prompt automatically manages token budgets for scene history inclusion:
+
+1. **Start with max context**: Uses `max_tokens` from the agent's client
+2. **Subtract reserved tokens**: Removes `reserved_tokens` to create a buffer for the response
+3. **Count rendered context**: Calculates tokens used by all enabled contexts (intent, memory, instructions, etc.)
+4. **Calculate scene history budget**: `budget = max_tokens - reserved_tokens - count_tokens(rendered_contexts)`
+5. **Fill with scene history**: Includes as much scene history as fits in the remaining budget
+
+The `reserved_tokens` setting (default: 312) ensures there's always space reserved for the agent's response and prevents the context from being completely filled. Increase it if responses are getting cut off; decrease it if you want more scene history included.
+
+## How Build Prompt Works with Templates
+
+The Build Prompt node works by passing all its configuration options as variables to the template. The default `common/base.jinja2` template is specifically structured to:
+
+1. **Check boolean flags**: Uses `{% if include_scene_intent %}` to conditionally include context sections
+2. **Include sub-templates**: Dynamically includes templates like `scene-intent.jinja2`, `memory-context.jinja2`, etc.
+3. **Process dynamic instructions**: Renders both `dynamic_context` and `dynamic_instructions` lists
+4. **Calculate token budgets**: Uses `count_tokens()` to budget space for scene history
+5. **Apply prefill prompts**: Handles the `prefill_prompt` and `return_prefill_prompt` options
+
+This is why changing the template requires ensuring compatibility - a different template must expect and use these same variables.
+
+## Template Scopes
+
+The `scope` property determines where templates are loaded from:
+
+- **`common`**: Shared templates in `templates/prompts/common/`
+- **Agent types**: Agent-specific templates in `templates/prompts/{agent_type}/`
+  - `narrator`, `director`, `creator`, `editor`, `summarizer`, `world_state`
+
+The `template_file` property references the template name without the `.jinja2` extension.

docs/user-guide/node-editor/core-concepts/user-interface.md

@@ -4,25 +4,31 @@
 
 The node editor is available in the main scene window once the scene is switched to creative mode.
 
-Switch to creative mode through the creative mode toggle in the scene toolbar.
+Open the node editor by clicking the :material-chart-timeline-variant-shimmer: icon in the main toolbar (upper left).
 
-![Switch to creative mode](../img/toggle-node-editor.png)
+![Switch to creative mode](../img/open-node-editor.png)
+
+Exit the node editor the same way by clicking the :material-exit-to-app: icon in the main toolbar (upper left).
+
+![Exit node editor](../img/close-node-editor.png)
 
 ## Module Library
 
 ![Module Library](../img/user-interface-0001.png)
 
-The **:material-group: Modules** Library can be found at the bottom of the editor.
+The **:material-file-tree: Modules** Library can be found at the left sidebar of the editor. If the sidebar is closed, click the :material-file-tree: icon in the main toolbar (upper left) to open it.
 
 It holds all the node modules that talemate has currently installed and is the main way to add new modules to the editor or open existing modules for inspection or editing.
 
 ### Module listing
 
-Node modules come in three categories:
+Node modules are organized into hierarchical groups:
 
-- Scene level modules: Purple, these modules live with scene project
-- Installed modules: Brown, these are the modules installed through the `templates/modules` directory
-- Core modules: Grey, these are the modules that are part of the core talemate installation
+- **scene**: Scene-level modules that live with your project
+- **agents/{agent}**: Agent-specific modules organized by agent name
+- **core**: Core talemate system modules
+- **installed/{project}**: Installed modules grouped by project (from `templates/modules/{project}`)
+- **templates**: General template modules
 
 All modules can be opened and inspected, but **only scene level modules can be edited**.
 
@@ -62,6 +68,9 @@ Select the appropriate module type.
 | :material-function: Function | Creates a new [function](functions.md) module |
 | :material-file: Module | Creates a new module |
 | :material-source-branch-sync: Scene Loop | Creates a new scene loop module |
+| :material-package-variant: Package | Creates a new package module |
+| :material-chat: Director Chat Action | Creates a new director chat action module |
+| :material-robot-happy: Agent Websocket Handler | Creates a new agent websocket handler module |
 
 In the upcoming dialog you can name the new module and set the registry path.
 
@@ -226,6 +235,20 @@ To paste a node, select the location where you want to paste it and hit `Ctrl+V`
 
 You can also hold the `Alt` key and drag the selected node(s) to duplicate them and drag the duplicate to the desired location.
 
+##### Alt+Shift drag to create counterpart
+
+Certain nodes support creating a "counterpart" node. Hold `Alt+Shift` and drag the node to create its paired counterpart node.
+
+For example:
+
+- **Set State → Get State**: Creates a Get State node with matching scope and variable name
+- **Input → Output**: Creates the corresponding socket node with matching configuration
+
+The counterpart node is positioned near the original and can be immediately dragged to the desired location.
+
+!!! note "Limited node support"
+    This feature is currently only available for specific node types like Get/Set State and Input/Output socket nodes.
+
 #### Node Properties
 
 Most nodes come with properties that can be edited. To edit a node property, click on the corresponding input widget in the node.

docs/user-guide/restoring-scenes.md

@@ -0,0 +1,34 @@
+# Restoring Scenes from Backups
+
+Talemate maintains automatic backup revisions of your scenes. You can restore any scene to a previous state from the Quick Load screen.
+
+## How to restore a scene
+
+1. From the main screen, locate your scene in the **Quick load** section
+2. Click the three-dot menu (⋮) on the scene card
+3. Select **Restore from Backup**
+
+![Restore menu option](/talemate/img/0.33.0/restore-from-backup.png)
+
+## Restore options
+
+![Restore menu option](/talemate/img/0.33.0/restore-from-backup-dlg.png)
+
+The backup restore dialog provides several restoration options:
+
+- **Restore Earliest** - Returns the scene to its initial state (revision 0)
+- **Restore Latest** - Restores the most recent saved state
+- **Filter by date/time** - Find and restore to a specific point in time
+
+When you use the date/time filter, Talemate will show the closest available revision to your selected time.
+
+## Important notes
+
+!!! warning
+    Restoring creates a **new, unsaved scene** from the selected revision. Your original scene file will **not** be modified. This allows you to safely explore previous states without losing your current progress.
+
+After restoration:
+
+- The restored scene opens as a new, unsaved scene
+- You must manually save it to preserve the restored state
+- The original scene file remains unchanged in its current state

docs/user-guide/world-editor/scene/.pages

@@ -2,4 +2,5 @@ nav:
     - Outline: outline.md
     - Direction: direction.md
     - Settings: settings.md
+    - Shared Context: shared-context.md
     - Export: export.md

docs/user-guide/world-editor/scene/shared-context.md

@@ -0,0 +1,125 @@
+# Shared Context
+
+Shared Context allows you to share specific characters, world entries, and history across multiple scenes within the same project. This is useful for creating interconnected stories where certain elements remain consistent across different scenarios.
+
+## Accessing Shared Context
+
+Navigate to **:material-earth-box: World Editor** :material-arrow-right: **:material-script: Scene** :material-arrow-right: **:material-earth: Shared Context**
+
+![Shared Context - No link](/talemate/img/0.33.0/shared-context-1.png)
+
+## Creating a Shared Context
+
+1. Click the **New** button
+2. Enter a filename for your shared context
+3. The file will be saved as a `.json` file in the scene's `shared-context` folder
+
+## Linking a Scene to Shared Context
+
+1. Select a shared context file from the **Available** list by checking its checkbox
+2. Only one shared context can be active per scene
+3. To unlink, uncheck the selected shared context
+
+When a scene is linked to a shared context, you'll see:
+
+- Number of shared characters
+- Number of shared world entries
+- A **New scene** button for creating additional scenes with the same context
+
+![Shared Context - Linked](/talemate/img/0.33.0/shared-context-2.png)
+
+## Creating New Scenes with Shared Context
+
+Once a scene is linked to a shared context, you can create new scenes that inherit the same shared elements:
+
+1. Click the **New scene** button
+2. Optionally provide instructions for generating a new premise
+3. Select which shared characters to activate in the new scene
+4. Click **Create and load**
+
+![Create New Scene dialog](/talemate/img/0.33.0/shared-context-new-scene.png)
+
+The new scene will:
+
+- Be linked to the same shared context
+- Inherit the content classification settings
+- Use the same agent persona templates
+- Use the same writing style template
+- Include selected shared characters
+- Be part of the same project
+
+!!! warning
+    If the current scene is not saved, any unsaved changes will be lost when creating a new scene.
+
+## Managing Shared Context Files
+
+- **Refresh** - Updates the list of available shared context files
+- **Delete** - Removes a shared context file (use the inline delete button next to each item)
+
+## Marking Elements as Shared
+
+Once a scene is linked to a shared context, you can mark specific elements to be shared across all scenes using that context.
+
+### Sharing Characters
+
+1. Navigate to **:material-earth-box: World Editor** :material-arrow-right: **:material-account-multiple: Characters**
+2. Select a character from the list
+3. At the bottom of the character editor, check the **Shared to World Context** checkbox
+
+![Shared to World Context checkbox](/talemate/img/0.33.0/shared-context-3.png)
+
+When shared, the character card will highlight in orange/amber to indicate its shared status.
+
+#### Sharing Individual Attributes and Details
+
+Once a character is marked as shared, you can control which specific attributes and details are shared:
+
+**For Attributes:**
+
+1. Open the character and go to the **Attributes** tab
+2. Select an attribute from the list
+3. Click ![Share with world](/talemate/img/0.33.0/share-with-world.png) to add it to the shared context
+4. Shared attributes are marked with a :material-earth: icon in the list
+5. Click ![Unshare from world](/talemate/img/0.33.0/unshare-from-world.png) to remove it from sharing
+
+**For Details:**
+
+1. Open the character and go to the **Details** tab
+2. Select a detail from the list
+3. Click ![Share with world](/talemate/img/0.33.0/share-with-world.png) to add it to the shared context
+4. Shared details are marked with a :material-earth: icon in the list
+5. Click ![Unshare from world](/talemate/img/0.33.0/unshare-from-world.png) to remove it from sharing
+
+This allows you to selectively share only relevant character information across scenes while keeping other aspects scene-specific.
+
+### Sharing World Entries
+
+1. Navigate to **:material-earth-box: World Editor** :material-arrow-right: **:material-earth: World**
+2. Select or create a world entry
+3. Check the **Shared to World Context** checkbox in the entry editor
+
+![World Entry Shared to World Context](/talemate/img/0.33.0/world-entry-shared-context.png)
+
+Shared world entries appear with an orange/amber highlight. These entries contain locations, lore, and world-building information that will be accessible across all linked scenes.
+
+### Sharing History
+
+1. Navigate to **:material-earth-box: World Editor** :material-arrow-right: **:material-history: History**
+2. If the sidebar isn't visible, click the :material-arrow-collapse-left: icon in the upper left to open it
+3. Under **Shared world context**, check **Share static history**
+
+![History Shared Context](/talemate/img/0.33.0/history-shared-context.png)
+
+!!! info "Static History Only"
+    Only **static history entries** (manually created base entries) can be shared. Summarized history layers cannot be shared directly.
+
+!!! tip "Sharing Summarized Content"
+    To share summarized scene progression, use the **Summarize to World Entry** button in the History tools menu. This creates a world entry from your scene's progress that can then be marked as shared.
+
+## What Gets Shared
+
+- **Characters** - Complete character definitions, personalities, attributes, and details
+- **World Entries** - Locations, lore, and world-building information
+- **Static History** - Manually created history entries (not summarized layers)
+
+These elements remain synchronized across all scenes linked to the same shared context.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "talemate"
-version = "0.32.3"
+version = "0.33.0"
 description = "AI-backed roleplay and narrative tools"
 authors = [{name = "VeguAITools"}]
 license = {text = "GNU Affero General Public License v3.0"}
@@ -65,6 +65,7 @@ dependencies = [
     "soundfile>=0.13.1",
     # F5-TTS
     "f5-tts>=1.1.7",
+    "deepdiff>=8.6.1",
 ]
 
 [project.optional-dependencies]
@@ -137,4 +138,4 @@ torchaudio = [
 [[tool.uv.index]]
 name = "pytorch-cu128"
 url = "https://download.pytorch.org/whl/cu128"
-explicit = true
+explicit = true

scenes/infinity-quest/infinity-quest.json

@@ -31,9 +31,12 @@
       "ts": "P12M"
     }
   ],
-  "character_states": {},
-  "characters": [
-    {
+  "active_characters": [
+    "Elmer",
+    "Kaira"
+  ],
+  "character_data": {
+    "Elmer": {
       "name": "Elmer",
       "description": "Elmer is a seasoned space explorer, having traversed the cosmos for over three decades. At thirty-eight years old, his muscular frame still cuts an imposing figure, clad in a form-fitting black spacesuit adorned with intricate silver markings. As the captain of his own ship, he wields authority with confidence yet never comes across as arrogant or dictatorial. Underneath this tough exterior lies a man who genuinely cares for his crew and their wellbeing, striking a balance between discipline and compassion.",
       "greeting_text": "",
@@ -57,7 +60,7 @@
       "is_player": true,
       "cover_image": null
     },
-    {
+    "Kaira": {
       "name": "Kaira",
       "description": "Kaira is a meticulous and dedicated Altrusian woman who serves as second-in-command aboard their tiny exploration vessel. As a native of the planet Altrusia, she possesses striking features unique among her kind; deep violet skin adorned with intricate patterns resembling stardust, large sapphire eyes, lustrous glowing hair cascading down her back, and standing tall at just over six feet. Her form fitting bodysuit matches her own hue, giving off an ethereal presence. With her innate grace and precision, she moves efficiently throughout the cramped confines of their ship. A loyal companion to Captain Elmer Farstield, she approaches every task with diligence and focus while respecting authority yet challenging decisions when needed. Dedicated to maintaining order within their tight quarters, Kaira wields several advanced technological devices including a multi-tool, portable scanner, high-tech communications system, and personal shield generator - all essential for navigating unknown territories and protecting themselves from harm. In this perilous universe full of mysteries waiting to be discovered, Kaira stands steadfast alongside her captain \u2013 ready to embrace whatever challenges lie ahead in their quest for knowledge beyond Earth's boundaries.",
       "greeting_text": "",
@@ -100,7 +103,7 @@
       "is_player": false,
       "cover_image": null
     }
-  ],
+  },
   "immutable_save": true,
   "goal": null,
   "goals": [],

scenes/simulation-suite-v2/nodes/sim-suite-on-scene-init.json

@@ -333,8 +333,7 @@
         "entry_id": "sim.quarantined",
         "text": null,
         "meta": {},
-        "create_pin": true,
-        "id": "sim.quarantined"
+        "create_pin": true
       },
       "x": 300,
       "y": 1030,

scenes/simulation-suite-v2/the-simulation-suite.json

@@ -7,16 +7,18 @@
   "environment": "scene",
   "archived_history": [],
   "layered_history": [],
-  "characters": [
-    {
+  "active_characters": [
+    "User"
+  ],
+  "character_data": {
+    "User": {
         "name": "User",
         "gender": "unknown",
         "color": "cornflowerblue",
         "base_attributes": {},
         "is_player": true
     }
-  ],
-  "inactive_characters": {},
+  },
   "context": "a holodeck like experience",
   "world_state": {
     "characters": {},

src/talemate/agents/base.py

@@ -4,12 +4,14 @@ import asyncio
 import dataclasses
 from inspect import signature
 import re
+import traceback
 from abc import ABC
 from functools import wraps
 from typing import Callable, Union
 import uuid
 import pydantic
 import structlog
+from typing import TYPE_CHECKING
 
 import talemate.emit.async_signals
 import talemate.instance as instance
@@ -24,6 +26,12 @@ import talemate.config.schema as config_schema
 from talemate.client.context import (
     ClientContext,
 )
+from talemate.game.engine.nodes.core import GraphState
+from talemate.game.engine.nodes.registry import get_nodes_by_base_type, get_node
+from talemate.game.engine.nodes.run import FunctionWrapper
+
+if TYPE_CHECKING:
+    from talemate.tale_mate import Scene
 
 __all__ = [
     "Agent",
@@ -102,6 +110,9 @@ class DynamicInstruction(pydantic.BaseModel):
     content: str
 
     def __str__(self) -> str:
+        if not self.content:
+            return ""
+
         return "\n".join(
             [f"<|SECTION:{self.title}|>", self.content, "<|CLOSE_SECTION|>"]
         )
@@ -232,6 +243,52 @@ class Agent(ABC):
 
         return actions
 
+    @classmethod
+    def config_options(cls, agent=None):
+        config_options = {
+            "client": [name for name, _ in instance.client_instances()],
+            "enabled": agent.enabled if agent else True,
+            "has_toggle": agent.has_toggle if agent else False,
+            "experimental": agent.experimental if agent else False,
+            "requires_llm_client": cls.requires_llm_client,
+        }
+        actions = getattr(agent, "actions", None)
+
+        if actions:
+            config_options["actions"] = {k: v.model_dump() for k, v in actions.items()}
+        else:
+            config_options["actions"] = {}
+
+        return config_options
+
+    @classmethod
+    async def init_nodes(cls, scene: "Scene", state: GraphState):
+        log.debug(f"{cls.agent_type}.init_nodes")
+
+        if not cls.websocket_handler:
+            return
+
+        cls.websocket_handler.clear_sub_handlers()
+
+        for node_cls in get_nodes_by_base_type("agents/AgentWebsocketHandler"):
+            _node = node_cls()
+            handler_name = _node.get_property("name")
+            agent_type = _node.get_property("agent")
+            if agent_type != cls.agent_type:
+                continue
+
+            async def handler_fn(router, data: dict):
+                state: GraphState = scene.nodegraph_state
+                node = get_node(_node.registry)()
+                fn = FunctionWrapper(node, node, state)
+                await fn(websocket_router=router, data=data)
+
+            cls.websocket_handler.register_sub_handler(handler_name, handler_fn)
+            log.debug(
+                f"{cls.agent_type}.init_nodes.websocket_handler",
+                handler_name=handler_name,
+            )
+
     @property
     def config(self) -> Config:
         return get_config()
@@ -300,24 +357,6 @@ class Agent(ABC):
         # is experimental should override this property
         return False
 
-    @classmethod
-    def config_options(cls, agent=None):
-        config_options = {
-            "client": [name for name, _ in instance.client_instances()],
-            "enabled": agent.enabled if agent else True,
-            "has_toggle": agent.has_toggle if agent else False,
-            "experimental": agent.experimental if agent else False,
-            "requires_llm_client": cls.requires_llm_client,
-        }
-        actions = getattr(agent, "actions", None)
-
-        if actions:
-            config_options["actions"] = {k: v.model_dump() for k, v in actions.items()}
-        else:
-            config_options["actions"] = {}
-
-        return config_options
-
     @property
     def meta(self):
         return {
@@ -554,10 +593,15 @@ class Agent(ABC):
                 return
 
             if fut.exception():
+                exc = fut.exception()
+                tb = "".join(
+                    traceback.format_exception(type(exc), exc, exc.__traceback__)
+                )
                 log.error(
                     "background processing error",
                     agent=self.agent_type,
-                    exc=fut.exception(),
+                    exc=exc,
+                    traceback=tb,
                 )
 
                 if error_handler:

src/talemate/agents/conversation/__init__.py

@@ -107,9 +107,9 @@ class ConversationAgent(MemoryRAGMixin, Agent):
                         type="number",
                         label="Generation Length (tokens)",
                         description="Maximum number of tokens to generate for a conversation response.",
-                        value=128,
+                        value=192,
                         min=32,
-                        max=512,
+                        max=4096,
                         step=32,
                     ),
                     "jiggle": AgentActionConfig(

src/talemate/agents/conversation/nodes.py

@@ -42,8 +42,11 @@ class GenerateConversation(AgentNode):
 
         self.set_property("trigger_conversation_generated", True)
 
+        self.add_output("state")
         self.add_output("generated", socket_type="str")
         self.add_output("message", socket_type="message_object")
+        self.add_output("character", socket_type="character")
+        self.add_output("instruction", socket_type="str")
 
     async def run(self, state: GraphState):
         character: "Character" = self.get_input_value("character")
@@ -72,4 +75,12 @@ class GenerateConversation(AgentNode):
 
             message = messages[0]
 
-        self.set_output_values({"generated": message.message, "message": message})
+        self.set_output_values(
+            {
+                "generated": message.message,
+                "message": message,
+                "character": character,
+                "instruction": instruction,
+                "state": self.get_input_value("state"),
+            }
+        )

src/talemate/agents/conversation/websocket_handler.py

@@ -65,7 +65,7 @@ class ConversationWebsocketHandler(Plugin):
                 meta={"character": character.name},
             )
             emit("director", message=director_message, character=character)
-            self.scene.push_history(director_message)
+            await self.scene.push_history(director_message)
             generated_messages = await self.agent.converse(
                 actor, emit_signals=payload.emit_signals
             )
@@ -77,5 +77,5 @@ class ConversationWebsocketHandler(Plugin):
             )
 
         for message in generated_messages:
-            self.scene.push_history(message)
+            await self.scene.push_history(message)
             emit("character", message=message, character=character)

src/talemate/agents/creator/assistant.py

@@ -1,10 +1,10 @@
 import json
+import re
 import random
-import uuid
 from typing import TYPE_CHECKING, Tuple
 import dataclasses
 import traceback
-
+import uuid
 import pydantic
 import structlog
 
@@ -21,6 +21,9 @@ from talemate.world_state.templates import (
     Spices,
     WritingStyle,
 )
+from talemate.changelog import write_reconstructed_scene
+from talemate.save import SceneEncoder
+import os
 from talemate.agents.base import AgentAction, AgentActionConfig, AgentTemplateEmission
 import talemate.emit.async_signals as async_signals
 
@@ -237,6 +240,9 @@ class AssistantMixin:
         Request content from the assistant.
         """
 
+        if not writing_style:
+            writing_style = self.scene.writing_style
+
         generation_options = GenerationOptions(
             spices=spices,
             spice_level=spice_level,
@@ -354,6 +360,9 @@ class AssistantMixin:
             )
             return emission.response
 
+        if content.lower().startswith(context_name + ": "):
+            content = content[len(context_name) + 2 :]
+
         emission.response = content.strip().strip("*").strip()
 
         await async_signals.get("agent.creator.contextual_generate.after").send(
@@ -368,6 +377,7 @@ class AssistantMixin:
         attribute_name: str,
         instructions: str = "",
         original: str | None = None,
+        length: int = 192,
         generation_options: GenerationOptions = None,
     ) -> str:
         """
@@ -381,6 +391,7 @@ class AssistantMixin:
             character=character.name,
             instructions=instructions,
             original=original,
+            length=length,
             **generation_options.model_dump(),
         )
 
@@ -410,6 +421,33 @@ class AssistantMixin:
             **generation_options.model_dump(),
         )
 
+    @set_processing
+    async def generate_scene_title(
+        self,
+        instructions: str = "",
+        length: int = 20,
+        generation_options: GenerationOptions = None,
+    ) -> str:
+        """
+        Wrapper for contextual_generate that generates a scene title.
+        """
+        if not generation_options:
+            generation_options = GenerationOptions()
+
+        title = await self.contextual_generate_from_args(
+            context="scene title:scene title",
+            instructions=instructions,
+            length=length,
+            **generation_options.model_dump(),
+        )
+
+        # replace special characters
+        title = re.sub(r"[^a-zA-Z0-9\s-]", "", title)
+        if title.lower().startswith("scene title "):
+            title = title[11:]
+
+        return title.split("\n")[0].strip()
+
     @set_processing
     async def generate_thematic_list(
         self,
@@ -479,12 +517,13 @@ class AssistantMixin:
         except IndexError:
             pass
 
-        if input.strip().endswith('"'):
-            prefix = " *"
-        elif input.strip().endswith("*"):
-            prefix = ' "'
-        else:
-            prefix = ""
+        outvar = {
+            "tag_name": "CONTINUE",
+        }
+
+        def set_tag_name(tag_name: str) -> str:
+            outvar["tag_name"] = tag_name
+            return tag_name
 
         template_vars = {
             "scene": self.scene,
@@ -497,7 +536,7 @@ class AssistantMixin:
             "message": message,
             "anchor": anchor,
             "non_anchor": non_anchor,
-            "prefix": prefix,
+            "set_tag_name": set_tag_name,
         }
 
         emission = AutocompleteEmission(
@@ -521,13 +560,19 @@ class AssistantMixin:
             dedupe_enabled=False,
         )
 
+        # attempt to extract the continuation from the response
+        try:
+            tag_name = outvar["tag_name"]
+            response = (
+                response.split(f"<{tag_name}>")[1].split(f"</{tag_name}>")[0].strip()
+            )
+        except IndexError:
+            pass
+
         response = (
             response.replace("...", "").lstrip("").rstrip().replace("END-OF-LINE", "")
         )
 
-        if prefix:
-            response = prefix + response
-
         emission.response = response
 
         await async_signals.get("agent.creator.autocomplete.after").send(emission)
@@ -574,6 +619,14 @@ class AssistantMixin:
             input=input,
         )
 
+        outvar = {
+            "tag_name": "CONTINUE",
+        }
+
+        def set_tag_name(tag_name: str) -> str:
+            outvar["tag_name"] = tag_name
+            return tag_name
+
         template_vars = {
             "scene": self.scene,
             "max_tokens": self.client.max_token_length,
@@ -582,6 +635,7 @@ class AssistantMixin:
             "response_length": response_length,
             "anchor": anchor,
             "non_anchor": non_anchor,
+            "set_tag_name": set_tag_name,
         }
 
         emission = AutocompleteEmission(
@@ -603,6 +657,16 @@ class AssistantMixin:
             pad_prepended_response=False,
             dedupe_enabled=False,
         )
+
+        # attempt to extract the continuation from the response
+        try:
+            tag_name = outvar["tag_name"]
+            response = (
+                response.split(f"<{tag_name}>")[1].split(f"</{tag_name}>")[0].strip()
+            )
+        except IndexError:
+            pass
+
         response = response.strip().replace("...", "").strip()
 
         if response.startswith(input):
@@ -628,77 +692,110 @@ class AssistantMixin:
         save_name: str | None = None,
     ):
         """
-        Allows to fork a new scene from a specific message
-        in the current scene.
+        Creates a new scene forked from a specific message.
 
-        All content after the message will be removed and the
-        context database will be re imported ensuring a clean state.
-
-        All state reinforcements will be reset to their most recent
-        state before the message.
+        This properly creates a new scene file without modifying the current scene,
+        then signals the frontend to load the new scene.
         """
-
-        emit("status", "Creating scene fork ...", status="busy")
         try:
+            emit("status", "Preparing to fork scene...", status="busy")
+
             if not save_name:
-                # build a save name
-                uuid_str = str(uuid.uuid4())[:8]
-                save_name = f"{uuid_str}-forked"
+                save_name = self.scene.generate_name()
 
-            log.info("Forking scene", message_id=message_id, save_name=save_name)
-
-            world_state = get_agent("world_state")
-
-            # does a message with the given id exist?
-            index = self.scene.message_index(message_id)
-            if index is None:
+            # Find the message to fork from
+            message = self.scene.get_message(message_id)
+            if not message:
                 raise ValueError(f"Message with id {message_id} not found.")
 
-            # truncate scene.history keeping index as the last element
-            self.scene.history = self.scene.history[: index + 1]
+            # Determine fork type based on message revision
+            use_reconstructive_fork = message.rev > 0
 
-            # truncate scene.archived_history keeping the element where `end` is < `index`
-            # as the last element
-            self.scene.archived_history = [
-                x
-                for x in self.scene.archived_history
-                if "end" not in x or x["end"] < index
-            ]
+            if use_reconstructive_fork:
+                log.info(
+                    "Creating reconstructive fork",
+                    message_id=message_id,
+                    rev=message.rev,
+                )
+                emit("status", "Creating reconstructive fork...", status="busy")
 
-            # the same needs to be done for layered history
-            # where each layer is truncated based on what's left in the previous layer
-            # using similar logic as above (checking `end` vs `index`)
-            # layer 0 checks archived_history
+                # Create fork file with reconstructed scene data (shared_context will be disconnected)
+                fork_file_path = await write_reconstructed_scene(
+                    self.scene,
+                    message.rev,
+                    f"{save_name}.json",
+                    overrides={
+                        "immutable_save": False,
+                        "memory_id": str(uuid.uuid4())[:10],
+                    },
+                )
 
-            new_layered_history = []
-            for layer_number, layer in enumerate(self.scene.layered_history):
-                if layer_number == 0:
-                    index = len(self.scene.archived_history) - 1
-                else:
-                    index = len(new_layered_history[layer_number - 1]) - 1
+                log.info(
+                    "Reconstructive fork created",
+                    save_name=save_name,
+                    rev=message.rev,
+                    path=fork_file_path,
+                )
+            else:
+                log.info("Creating shallow fork", message_id=message_id)
+                emit("status", "Creating shallow fork...", status="busy")
 
-                new_layer = [x for x in layer if x["end"] < index]
-                new_layered_history.append(new_layer)
+                # Create a copy of current scene data
+                scene_data = self.scene.serialize
 
-            self.scene.layered_history = new_layered_history
+                scene_data["immutable_save"] = False
+                scene_data["memory_id"] = str(uuid.uuid4())[:10]
 
-            # save the scene
-            await self.scene.save(copy_name=save_name)
+                # Truncate history to the fork point
+                index = self.scene.message_index(message_id)
+                if index is None:
+                    raise ValueError(f"Message with id {message_id} not found.")
 
-            log.info("Scene forked", save_name=save_name)
+                # Truncate history (keeping index as the last element)
+                scene_data["history"] = self.scene.history[: index + 1]
 
-            # re-emit history
-            await self.scene.emit_history()
+                # Truncate archived_history (keeping elements where 'end' < index)
+                scene_data["archived_history"] = [
+                    x
+                    for x in self.scene.archived_history
+                    if "end" not in x or x["end"] < index
+                ]
 
-            emit("status", "Updating world state ...", status="busy")
+                # Truncate layered history (same logic as original)
+                new_layered_history = []
+                for layer_number, layer in enumerate(self.scene.layered_history):
+                    if layer_number == 0:
+                        layer_index = len(scene_data["archived_history"]) - 1
+                    else:
+                        layer_index = len(new_layered_history[layer_number - 1]) - 1
 
-            # reset state reinforcements
-            await world_state.update_reinforcements(force=True, reset=True)
+                    new_layer = [x for x in layer if x["end"] < layer_index]
+                    new_layered_history.append(new_layer)
 
-            # update world state
-            await self.scene.world_state.request_update()
+                scene_data["layered_history"] = new_layered_history
+
+                # Clear shared_context for fork (same logic as reconstructive fork)
+                if scene_data.get("shared_context"):
+                    log.info(
+                        "Disconnecting forked scene from shared_context",
+                        shared_context=scene_data.get("shared_context"),
+                    )
+                    scene_data["shared_context"] = ""
+
+                # Write the fork file
+                fork_file_path = os.path.join(self.scene.save_dir, f"{save_name}.json")
+                with open(fork_file_path, "w") as f:
+                    json.dump(scene_data, f, indent=2, cls=SceneEncoder)
+
+                log.info(
+                    "Shallow fork created", save_name=save_name, path=fork_file_path
+                )
+
+            emit("status", "Scene forked successfully", status="success")
+
+            # Return the fork file path so the websocket handler can load it
+            return fork_file_path
 
-            emit("status", "Scene forked", status="success")
         except Exception:
             log.error("Scene fork failed", exc=traceback.format_exc())
             emit("status", "Scene fork failed", status="error")

src/talemate/agents/creator/character.py

@@ -37,6 +37,7 @@ class CharacterCreatorMixin:
         character: Character,
         instructions: str = "",
         information: str = "",
+        update_existing: bool = False,
     ):
         instructions = await Prompt.request(
             "creator.determine-character-dialogue-instructions",
@@ -48,6 +49,7 @@ class CharacterCreatorMixin:
                 "max_tokens": self.client.max_token_length,
                 "instructions": instructions,
                 "information": information,
+                "update_existing": update_existing,
             },
         )
 

src/talemate/agents/creator/nodes.py

@@ -5,6 +5,7 @@ from talemate.game.engine.nodes.core import (
     GraphState,
     PropertyField,
     UNRESOLVED,
+    InputValueError,
 )
 from talemate.game.engine.nodes.registry import register
 from talemate.game.engine.nodes.agent import AgentSettingsNode, AgentNode
@@ -115,6 +116,12 @@ class DetermineCharacterDialogueInstructions(AgentNode):
             type="text",
             default="",
         )
+        update_existing = PropertyField(
+            name="update_existing",
+            description="Whether to update the existing dialogue instructions",
+            type="bool",
+            default=False,
+        )
 
     def __init__(self, title="Determine Character Dialogue Instructions", **kwargs):
         super().__init__(title=title, **kwargs)
@@ -123,22 +130,34 @@ class DetermineCharacterDialogueInstructions(AgentNode):
         self.add_input("state")
         self.add_input("character", socket_type="character")
         self.add_input("instructions", socket_type="str", optional=True)
-
+        self.add_input("update_existing", socket_type="bool", optional=True)
         self.set_property("instructions", "")
-
+        self.set_property("update_existing", False)
+        self.add_output("state", socket_type="any")
+        self.add_output("character", socket_type="character")
         self.add_output("dialogue_instructions", socket_type="str")
+        self.add_output("original", socket_type="str")
 
     async def run(self, state: GraphState):
         character = self.require_input("character")
-        instructions = self.normalized_input_value("instructions")
+        instructions: str | None = self.normalized_input_value("instructions")
+        update_existing: bool | None = self.normalized_input_value("update_existing")
+        original: str | None = character.dialogue_instructions or ""
 
         dialogue_instructions = (
             await self.agent.determine_character_dialogue_instructions(
-                character, instructions
+                character, instructions, update_existing=update_existing
             )
         )
 
-        self.set_output_values({"dialogue_instructions": dialogue_instructions})
+        self.set_output_values(
+            {
+                "state": state,
+                "character": character,
+                "dialogue_instructions": dialogue_instructions,
+                "original": original,
+            }
+        )
 
 
 @register("agents/creator/ContextualGenerate")
@@ -195,6 +214,7 @@ class ContextualGenerate(AgentNode):
                 "general",
                 "list",
                 "scene",
+                "static history",
                 "world context",
             ],
             default="general",
@@ -270,6 +290,11 @@ class ContextualGenerate(AgentNode):
 
         self.add_output("state")
         self.add_output("text", socket_type="str")
+        self.add_output("character", socket_type="character")
+        self.add_output("context_type", socket_type="str")
+        self.add_output("context_name", socket_type="str")
+        self.add_output("instructions", socket_type="str")
+        self.add_output("original", socket_type="str")
 
     async def run(self, state: GraphState):
         scene = active_scene.get()
@@ -285,7 +310,10 @@ class ContextualGenerate(AgentNode):
         context_aware = self.normalized_input_value("context_aware")
         history_aware = self.normalized_input_value("history_aware")
 
-        context = f"{context_type}:{context_name}" if context_name else context_type
+        if not context_name:
+            raise InputValueError(self, "context_name", "Context name is not set")
+
+        context = f"{context_type}:{context_name}"
 
         if isinstance(character, scene.Character):
             character = character.name
@@ -307,7 +335,17 @@ class ContextualGenerate(AgentNode):
             history_aware=history_aware,
         )
 
-        self.set_output_values({"state": state, "text": text})
+        self.set_output_values(
+            {
+                "state": state,
+                "text": text,
+                "character": scene.get_character(character),
+                "context_type": context_type,
+                "context_name": context_name,
+                "instructions": instructions,
+                "original": original,
+            }
+        )
 
 
 @register("agents/creator/GenerateThematicList")

src/talemate/agents/director/__init__.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 import structlog
 
 from talemate.emit import emit
@@ -10,20 +12,25 @@ from talemate.agents.registry import register
 from talemate.agents.memory.rag import MemoryRAGMixin
 from talemate.client import ClientBase
 from talemate.game.focal.schema import Call
-
+from talemate.game.engine.nodes.core import GraphState
 from .guide import GuideSceneMixin
 from .generate_choices import GenerateChoicesMixin
 from .legacy_scene_instructions import LegacySceneInstructionsMixin
 from .auto_direct import AutoDirectMixin
 from .websocket_handler import DirectorWebsocketHandler
+from .chat.mixin import DirectorChatMixin
 from .character_management import CharacterManagementMixin
 import talemate.agents.director.nodes  # noqa: F401
 
+if TYPE_CHECKING:
+    from talemate.tale_mate import Scene
+
 log = structlog.get_logger("talemate.agent.director")
 
 
 @register()
 class DirectorAgent(
+    DirectorChatMixin,
     GuideSceneMixin,
     MemoryRAGMixin,
     GenerateChoicesMixin,
@@ -69,8 +76,14 @@ class DirectorAgent(
         GuideSceneMixin.add_actions(actions)
         AutoDirectMixin.add_actions(actions)
         CharacterManagementMixin.add_actions(actions)
+        DirectorChatMixin.add_actions(actions)
         return actions
 
+    @classmethod
+    async def init_nodes(cls, scene: "Scene", state: GraphState):
+        await super(DirectorAgent, cls).init_nodes(scene, state)
+        await DirectorChatMixin.chat_init_nodes(scene, state)
+
     def __init__(self, client: ClientBase | None = None, **kwargs):
         self.is_enabled = True
         self.client = client
@@ -112,7 +125,7 @@ class DirectorAgent(
             action=action,
             flags=Flags.HIDDEN if console_only else Flags.NONE,
         )
-        self.scene.push_history(message)
+        await self.scene.push_history(message)
         emit("director", message)
 
     def inject_prompt_paramters(

src/talemate/agents/director/character_management.py

@@ -5,7 +5,7 @@ import talemate.instance as instance
 import talemate.agents.tts.voice_library as voice_library
 from talemate.agents.tts.schema import Voice
 from talemate.util import random_color
-from talemate.character import deactivate_character, set_voice
+from talemate.character import set_voice, activate_character
 from talemate.status import LoadingStatus
 from talemate.exceptions import GenerationCancelled
 from talemate.agents.base import AgentAction, AgentActionConfig, set_processing
@@ -240,8 +240,8 @@ class CharacterManagementMixin:
                 await self.assign_voice_to_character(character)
 
             # Deactivate the character if not active
-            if not active:
-                await deactivate_character(scene, character)
+            if active:
+                await activate_character(scene, character)
 
             # Commit the character's details to long term memory
             await character.commit_to_memory(memory)

src/talemate/agents/director/chat/context.py

@@ -0,0 +1,51 @@
+import contextvars
+import pydantic
+import structlog
+import asyncio
+
+from talemate.game.engine.context_id.scanner import OpenContextIDScanCollector
+
+
+__all__ = [
+    "DirectorChatContext",
+    "director_chat_context",
+    "create_task_with_chat_context",
+]
+
+log = structlog.get_logger("talemate.agents.director.chat.context")
+
+director_chat_context = contextvars.ContextVar("director_chat_context", default=None)
+
+
+class DirectorChatContext(pydantic.BaseModel):
+    chat_id: str
+    confirm_write_actions: bool = True
+    token: str | None = None
+    _context_id_collector: OpenContextIDScanCollector | None = None
+
+    def __enter__(self):
+        self.token = director_chat_context.set(self)
+        self._context_id_collector = OpenContextIDScanCollector()
+        self._context_id_collector.__enter__()
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        if self._context_id_collector:
+            self._context_id_collector.__exit__(exc_type, exc_value, traceback)
+        director_chat_context.reset(self.token)
+
+
+def create_task_with_chat_context(
+    fn,
+    chat_id: str,
+    *args,
+    confirm_write_actions: bool = True,
+    **kwargs,
+):
+    async def wrapper(*args, **kwargs):
+        with DirectorChatContext(
+            chat_id=chat_id, confirm_write_actions=confirm_write_actions
+        ):
+            return await fn(*args, **kwargs)
+
+    return asyncio.create_task(wrapper(*args, **kwargs))

src/talemate/agents/director/chat/exceptions.py

@@ -0,0 +1,26 @@
+__all__ = [
+    "DirectorChatActionRejected",
+    "UnknownDirectorChatAction",
+    "InvalidDirectorChat",
+]
+
+
+class InvalidDirectorChat(ValueError):
+    def __init__(self, chat_id: str):
+        self.chat_id = chat_id
+        super().__init__(f"Invalid chat: {chat_id}")
+
+
+class UnknownDirectorChatAction(ValueError):
+    def __init__(self, action_name: str):
+        self.action_name = action_name
+        super().__init__(f"Unknown action: {action_name}")
+
+
+class DirectorChatActionRejected(IOError):
+    focal_reraise: bool = True
+
+    def __init__(self, action_name: str, action_description: str):
+        self.action_name = action_name
+        self.action_description = action_description
+        super().__init__(f"User REJECTED action: {action_name} -> {action_description}")

src/talemate/agents/director/chat/nodes.py

@@ -0,0 +1,213 @@
+import structlog
+from typing import ClassVar
+import pydantic
+import asyncio
+import time
+from talemate.game.engine.nodes.core import (
+    GraphState,
+    PropertyField,
+    NodeStyle,
+    Node,
+    UNRESOLVED,
+)
+from talemate.game.engine.nodes.registry import register, base_node_type
+from talemate.game.engine.nodes.run import Function, FunctionWrapper
+from talemate.game.engine.nodes.focal import FocalArgument
+from talemate.emit import emit
+from talemate.context import active_scene
+
+from .context import director_chat_context
+from .exceptions import DirectorChatActionRejected
+
+log = structlog.get_logger("talemate.game.engine.nodes.agents.director.chat")
+
+
+@base_node_type("agents/director/DirectorChatAction")
+class DirectorChatAction(Function):
+    """
+    A action is a node that can be executed by the director during chat with the user
+    """
+
+    _isolated: ClassVar[bool] = True
+    _export_definition: ClassVar[bool] = False
+
+    class Fields:
+        name = PropertyField(
+            name="name", description="The name of the action", type="str", default=""
+        )
+        description = PropertyField(
+            name="description",
+            description="The description of the action",
+            type="text",
+            default="",
+        )
+        instructions = PropertyField(
+            name="instructions",
+            description="The instructions for the action",
+            type="text",
+            default="",
+        )
+        example_json = PropertyField(
+            name="example_json",
+            description="An example JSON payload for the action",
+            type="text",
+            default=None,
+        )
+
+    def __init__(self, title="Command", **kwargs):
+        super().__init__(title=title, **kwargs)
+        if not self.get_property("name"):
+            self.set_property("name", "")
+        if not self.get_property("description"):
+            self.set_property("description", "")
+
+    async def execute_action(self, state: GraphState, **kwargs):
+        wrapped = FunctionWrapper(self, self, state)
+        await wrapped(**kwargs)
+
+    async def test_run(self, state: GraphState):
+        return await self.execute_action(state, **{})
+
+
+@register("agents/director/chat/ActionArgument")
+class DirectorChatActionArgument(FocalArgument):
+    """
+    A argument is a node that can be used as an argument to a director chat action
+    """
+
+    @pydantic.computed_field(description="Node style")
+    @property
+    def style(self) -> NodeStyle:
+        return NodeStyle(
+            node_color="#2c2a37",
+            title_color="#144870",
+            icon="F0AE7",  # variable
+            auto_title="{name}",
+        )
+
+    def __init__(self, title="Director Action Argument", **kwargs):
+        super().__init__(title=title, **kwargs)
+
+
+@register("agents/director/chat/ActionConfirm")
+class DirectorChatActionConfirm(Node):
+    """
+    If the is a chat context active that requires confirmation for write
+    actions, this node will block the further execution of the node graph
+    and send a signal to the frontend to collect the confirmation from the user (or reject the action)
+    """
+
+    class Fields:
+        name = PropertyField(
+            name="name",
+            description="The name of the action",
+            type="str",
+            default="",
+        )
+        description = PropertyField(
+            name="description",
+            description="The description of the action",
+            type="text",
+            default="",
+        )
+        raise_on_reject = PropertyField(
+            name="raise_on_reject",
+            description="Whether to raise an error if the action is rejected",
+            type="bool",
+            default=True,
+        )
+
+    @pydantic.computed_field(description="Node style")
+    @property
+    def style(self) -> NodeStyle:
+        return NodeStyle(
+            # caution/confirm theme close to validation/breakpoint family
+            node_color="#2b273a",
+            title_color="#3d315b",
+            icon="F02D6",  # help-circle-outline
+            auto_title="Confirm Action",
+        )
+
+    def __init__(self, title="Director Action Confirm", **kwargs):
+        super().__init__(title=title, **kwargs)
+
+    def setup(self):
+        self.add_input("state")
+        self.add_input("name", socket_type="str", optional=True)
+        self.add_input("description", socket_type="str", optional=True)
+        self.set_property("name", "")
+        self.set_property("description", "")
+        self.set_property("raise_on_reject", True)
+        self.add_output("accepted")
+        self.add_output("rejected")
+        self.add_output("rejected_message", socket_type="str")
+
+    async def run(self, state: GraphState):
+        state_value = self.get_input_value("state")
+        max_wait_time: int = 180
+        key: str = f"_director_chat_action_confirm_{self.id}"
+        name: str = self.normalized_input_value("name")
+        description: str = self.normalized_input_value("description")
+        raise_on_reject: bool = self.get_property("raise_on_reject")
+        scene = active_scene.get()
+
+        rejected_state = UNRESOLVED
+
+        try:
+            context = director_chat_context.get()
+            if context and context.confirm_write_actions:
+                state.shared[key] = "waiting"
+                start_time = time.time()
+                emit(
+                    "request_action_confirmation",
+                    data={
+                        "chat_id": context.chat_id,
+                        "id": self.id,
+                        "name": name,
+                        "description": description,
+                        "timer": max_wait_time,
+                    },
+                    websocket_passthrough=True,
+                )
+                while state.shared[key] == "waiting":
+                    if not scene.active:
+                        log.warning(
+                            "Director Chat Action Confirm: Scene is no longer active",
+                            node=self.id,
+                        )
+                        rejected_state = state_value
+                        break
+
+                    log.debug(
+                        "Director Chat Action Confirm: Waiting for confirmation",
+                        node=self.id,
+                    )
+                    await asyncio.sleep(1)
+                    if time.time() - start_time > max_wait_time:
+                        log.error(
+                            "Director Chat Action Confirm: Max wait time reached",
+                            node=self.id,
+                        )
+                        rejected_state = state_value
+                        break
+
+                if state.shared[key] == "reject":
+                    rejected_state = state_value
+
+                if raise_on_reject and rejected_state is not UNRESOLVED:
+                    raise DirectorChatActionRejected(name, description)
+        except LookupError:
+            pass
+        finally:
+            if key in state.shared:
+                del state.shared[key]
+
+        log.debug("Director Chat Action Confirm: Final output", rejected=rejected_state)
+
+        if rejected_state is not UNRESOLVED:
+            message = f"User REJECTED action: {name} -> {description}"
+            self.set_output_values(
+                {"rejected": rejected_state, "rejected_message": message}
+            )
+        else:
+            self.set_output_values({"accepted": state_value})

src/talemate/agents/director/chat/schema.py

@@ -0,0 +1,110 @@
+import pydantic
+from typing import Literal, Any
+import uuid
+
+__all__ = [
+    "DirectorChatMessage",
+    "DirectorChatFunctionAvailable",
+    "DirectorChatFunctionSelected",
+    "DirectorChat",
+    "DirectorChatActionResultMessage",
+    "DirectorChatBudgets",
+    "DirectorChatResponse",
+]
+
+
+class DirectorChatBudgets(pydantic.BaseModel):
+    """
+    The budgets for the director chat
+    """
+
+    max_tokens: int = 0
+    reserved: int = 0
+    scene_context_ratio: float = 0.0
+
+    def set_reserved(self, reserved: int):
+        self.reserved = reserved
+
+    @pydantic.computed_field(description="The number of available tokens")
+    @property
+    def available(self) -> int:
+        # Ensure we never return negative available tokens
+        remaining = self.max_tokens - self.reserved
+        return remaining if remaining > 0 else 0
+
+    @pydantic.computed_field(description="The number of tokens for scene context")
+    @property
+    def scene_context(self) -> int:
+        return int(self.scene_context_ratio * self.available)
+
+    @pydantic.computed_field(description="The number of tokens for director chat")
+    @property
+    def director_chat(self) -> int:
+        return int((1 - self.scene_context_ratio) * self.available)
+
+
+class DirectorChatResponse(pydantic.BaseModel):
+    """
+    A response from the director
+    """
+
+    parsed_response: str
+    raw_response: str
+    budgets: DirectorChatBudgets
+    actions_selected: list[dict] = pydantic.Field(default_factory=list)
+
+
+class DirectorChatMessage(pydantic.BaseModel):
+    """
+    A message from the user or the director
+    """
+
+    message: str
+    source: Literal["director", "user"]
+    type: Literal["text", "action_result"] = "text"
+    id: str = pydantic.Field(default_factory=lambda: str(uuid.uuid4())[:10])
+
+
+class DirectorChatFunctionAvailable(pydantic.BaseModel):
+    """
+    A function that is available to the director
+    """
+
+    name: str
+    description: str
+
+
+class DirectorChatFunctionSelected(pydantic.BaseModel):
+    """
+    A function that has been selected by the director
+    """
+
+    name: str
+    instructions: str
+
+
+class DirectorChat(pydantic.BaseModel):
+    """
+    A history of messages from the user or the director
+    """
+
+    messages: list["DirectorChatMessage | DirectorChatActionResultMessage"]
+    id: str = pydantic.Field(default_factory=lambda: str(uuid.uuid4())[:10])
+    mode: Literal["normal", "decisive", "nospoilers"] = "normal"
+    confirm_write_actions: bool = True
+
+
+class DirectorChatActionResultMessage(pydantic.BaseModel):
+    """
+    A structured message that holds the result of an executed action.
+    Always originates from the director side.
+    """
+
+    type: Literal["action_result"] = "action_result"
+    source: Literal["director"] = "director"
+    name: str
+    arguments: dict[str, Any] = pydantic.Field(default_factory=dict)
+    result: Any = None
+    instructions: str | None = None
+    status: Literal["success", "error", "rejected"] = "success"
+    id: str = pydantic.Field(default_factory=lambda: str(uuid.uuid4())[:10])

src/talemate/agents/director/chat/websocket_handler.py

@@ -0,0 +1,336 @@
+import pydantic
+import asyncio
+import structlog
+from typing import Literal, TYPE_CHECKING
+
+from talemate.instance import get_agent
+from .context import create_task_with_chat_context
+import talemate.util as util
+
+if TYPE_CHECKING:
+    from talemate.tale_mate import Scene
+
+log = structlog.get_logger("talemate.server.director.chat")
+
+
+class ChatHistoryPayload(pydantic.BaseModel):
+    chat_id: str
+
+
+class ChatSendPayload(pydantic.BaseModel):
+    chat_id: str
+    message: str
+
+
+class ChatClearPayload(pydantic.BaseModel):
+    chat_id: str
+
+
+class ChatRemoveMessagePayload(pydantic.BaseModel):
+    chat_id: str
+    message_id: str
+
+
+class ChatRegeneratePayload(pydantic.BaseModel):
+    chat_id: str
+
+
+class ConfirmActionPayload(pydantic.BaseModel):
+    chat_id: str
+    id: str
+    decision: Literal["confirm", "reject"]
+
+
+class ChatUpdateModePayload(pydantic.BaseModel):
+    chat_id: str
+    mode: Literal["normal", "decisive", "nospoilers"]
+
+
+class ChatUpdateConfirmWriteActionsPayload(pydantic.BaseModel):
+    chat_id: str
+    confirm_write_actions: bool
+
+
+class DirectorChatWebsocketMixin:
+    """
+    Mixin for chat-related websocket handlers (router remains 'director').
+    Expects the concrete handler to provide:
+    - property `director` returning the DirectorAgent
+    - attributes `scene` and `websocket_handler` (provided by base Plugin)
+    """
+
+    @property
+    def director(self):
+        return get_agent("director")
+
+    def _make_generation_callbacks(self, payload_chat_id: str):
+        async def _on_update(chat_id, new_messages):
+            try:
+                self.websocket_handler.queue_put(
+                    {
+                        "type": "director",
+                        "action": "chat_append",
+                        "chat_id": chat_id,
+                        "messages": [m.model_dump() for m in new_messages],
+                        "token_total": sum(
+                            util.count_tokens(str(m))
+                            for m in self.director.chat_history(chat_id)
+                        ),
+                    }
+                )
+            except Exception as e:
+                log.error("director.chat.websocket.on_update.error", error=e)
+
+        async def _on_done(chat_id, budgets):
+            try:
+                self.websocket_handler.queue_put(
+                    {
+                        "type": "director",
+                        "action": "chat_done",
+                        "chat_id": chat_id,
+                        "budgets": budgets.model_dump() if budgets else None,
+                    }
+                )
+            except Exception as e:
+                log.error("director.chat.websocket.on_done.error", error=e)
+
+        async def _on_compacting(chat_id):
+            try:
+                self.websocket_handler.queue_put(
+                    {
+                        "type": "director",
+                        "action": "chat_compacting",
+                        "chat_id": chat_id,
+                    }
+                )
+            except Exception as e:
+                log.error("director.chat.websocket.on_compacting.error", error=e)
+
+        async def _on_compacted(chat_id, new_messages):
+            try:
+                self.websocket_handler.queue_put(
+                    {
+                        "type": "director",
+                        "action": "chat_history",
+                        "chat_id": chat_id,
+                        "messages": [m.model_dump() for m in new_messages],
+                        "token_total": sum(
+                            util.count_tokens(str(m)) for m in new_messages
+                        ),
+                    }
+                )
+                self.websocket_handler.queue_put(
+                    {
+                        "type": "director",
+                        "action": "chat_append",
+                        "chat_id": chat_id,
+                        "messages": [
+                            {
+                                "source": "director",
+                                "type": "compaction_notice",
+                                "message": "Older chat was summarized to keep context within limits.",
+                            }
+                        ],
+                        "token_delta": util.count_tokens(
+                            "Older chat was summarized to keep context within limits."
+                        ),
+                    }
+                )
+            except Exception as e:
+                log.error("director.chat.websocket.on_compacted.error", error=e)
+
+        return _on_update, _on_done, _on_compacting, _on_compacted
+
+    def _attach_task_done_callback(self, task, chat_id: str):
+        async def handle_task_done(task):
+            if task.exception():
+                exc = task.exception()
+                log.error("director.chat.websocket.task.error", error=exc)
+                try:
+                    self.websocket_handler.queue_put(
+                        {
+                            "type": "director",
+                            "action": "chat_done",
+                            "chat_id": chat_id,
+                        }
+                    )
+                except Exception as e:
+                    log.error("director.chat.websocket.task.done_emit.error", error=e)
+
+        task.add_done_callback(lambda task: asyncio.create_task(handle_task_done(task)))
+
+    async def handle_chat_create(self, data: dict):
+        chat = self.director.chat_create()
+
+        # emit updated list and history for the new chat
+        self.websocket_handler.queue_put(
+            {
+                "type": "director",
+                "action": "chat_created",
+                "chat_id": chat.id,
+                "chats": self.director.chat_list(),
+            }
+        )
+        self.websocket_handler.queue_put(
+            {
+                "type": "director",
+                "action": "chat_history",
+                "chat_id": chat.id,
+                "messages": [m.model_dump() for m in chat.messages],
+                "mode": chat.mode,
+                "confirm_write_actions": getattr(chat, "confirm_write_actions", True),
+            }
+        )
+
+    async def handle_chat_history(self, data: dict):
+        payload = ChatHistoryPayload(**data)
+        messages = self.director.chat_history(payload.chat_id)
+        chat = self.director.chat_get(payload.chat_id)
+        mode = chat.mode if chat else "normal"
+        confirm_write_actions = chat.confirm_write_actions if chat else True
+
+        self.websocket_handler.queue_put(
+            {
+                "type": "director",
+                "action": "chat_history",
+                "chat_id": payload.chat_id,
+                "messages": [m.model_dump() for m in messages],
+                "token_total": sum(util.count_tokens(str(m)) for m in messages),
+                "mode": mode,
+                "confirm_write_actions": confirm_write_actions,
+            }
+        )
+
+    async def handle_chat_send(self, data: dict):
+        payload = ChatSendPayload(**data)
+
+        _on_update, _on_done, _on_compacting, _on_compacted = (
+            self._make_generation_callbacks(payload.chat_id)
+        )
+
+        # delegate the generation to the agent mixin method in background
+        # Determine confirm_write_actions for this chat context
+        chat = self.director.chat_get(payload.chat_id)
+        cwa = chat.confirm_write_actions if chat else True
+
+        task = create_task_with_chat_context(
+            self.director.chat_send,
+            payload.chat_id,
+            payload.chat_id,
+            payload.message,
+            on_update=_on_update,
+            on_done=_on_done,
+            on_compacting=_on_compacting,
+            on_compacted=_on_compacted,
+            confirm_write_actions=cwa,
+        )
+        self._attach_task_done_callback(task, payload.chat_id)
+
+    async def handle_chat_clear(self, data: dict):
+        payload = ChatClearPayload(**data)
+        cleared = self.director.chat_clear(payload.chat_id)
+        self.websocket_handler.queue_put(
+            {
+                "type": "director",
+                "action": "chat_cleared",
+                "chat_id": payload.chat_id,
+                "cleared": cleared,
+            }
+        )
+        if cleared:
+            # Emit the reset greeting history so UI updates immediately
+            messages = self.director.chat_history(payload.chat_id)
+            chat = self.director.chat_get(payload.chat_id)
+            mode = chat.mode if chat else "normal"
+            confirm_write_actions = chat.confirm_write_actions if chat else True
+            self.websocket_handler.queue_put(
+                {
+                    "type": "director",
+                    "action": "chat_history",
+                    "chat_id": payload.chat_id,
+                    "messages": [m.model_dump() for m in messages],
+                    "mode": mode,
+                    "confirm_write_actions": confirm_write_actions,
+                }
+            )
+
+    async def handle_chat_remove_message(self, data: dict):
+        payload = ChatRemoveMessagePayload(**data)
+        chat = self.director.chat_remove_message(payload.chat_id, payload.message_id)
+        if not chat:
+            return
+        self.websocket_handler.queue_put(
+            {
+                "type": "director",
+                "action": "chat_history",
+                "chat_id": payload.chat_id,
+                "messages": [m.model_dump() for m in chat.messages],
+                "token_total": sum(util.count_tokens(str(m)) for m in chat.messages),
+                "mode": chat.mode,
+                "confirm_write_actions": getattr(chat, "confirm_write_actions", True),
+            }
+        )
+
+    async def handle_chat_regenerate(self, data: dict):
+        payload = ChatRegeneratePayload(**data)
+
+        _on_update, _on_done, _on_compacting, _on_compacted = (
+            self._make_generation_callbacks(payload.chat_id)
+        )
+
+        task = create_task_with_chat_context(
+            self.director.chat_regenerate_last,
+            payload.chat_id,
+            payload.chat_id,
+            on_update=_on_update,
+            on_done=_on_done,
+            on_compacting=_on_compacting,
+            on_compacted=_on_compacted,
+        )
+        self._attach_task_done_callback(task, payload.chat_id)
+
+    async def handle_confirm_action(self, data: dict):
+        payload = ConfirmActionPayload(**data)
+
+        log.debug("director.chat.websocket.handle_confirm_action", payload=payload)
+
+        scene: "Scene" = self.scene
+
+        key: str = f"_director_chat_action_confirm_{payload.id}"
+
+        if key not in scene.nodegraph_state.shared:
+            log.error(
+                "director.chat.websocket.handle_confirm_action.key_not_found", key=key
+            )
+            return
+
+        scene.nodegraph_state.shared[key] = payload.decision
+
+        self.websocket_handler.queue_put(
+            {
+                "type": "director",
+                "action": "confirm_action_processed",
+                "chat_id": payload.chat_id,
+                "id": payload.id,
+                "decision": payload.decision,
+            }
+        )
+
+    async def handle_chat_update_mode(self, data: dict):
+        payload = ChatUpdateModePayload(**data)
+
+        # Update the chat mode in the director
+        chat = self.director.chat_get(payload.chat_id)
+        if chat:
+            chat.mode = payload.mode
+
+            # Persist the updated chat state
+            self.director.chat_set_chat_state(chat.model_dump())
+
+    async def handle_chat_update_confirm_write_actions(self, data: dict):
+        payload = ChatUpdateConfirmWriteActionsPayload(**data)
+
+        chat = self.director.chat_get(payload.chat_id)
+        if chat:
+            chat.confirm_write_actions = payload.confirm_write_actions
+            self.director.chat_set_chat_state(chat.model_dump())

src/talemate/agents/director/guide.py

@@ -305,6 +305,16 @@ class GuideSceneMixin:
                 "max_tokens": self.client.max_token_length,
             },
         )
+
+        await self.emit_message(
+            "Actor Guidance",
+            response,
+            meta={
+                "action": "actor guidance",
+                "character": character.name,
+            },
+        )
+
         return strip_partial_sentences(response).strip()
 
     @set_processing
@@ -328,4 +338,13 @@ class GuideSceneMixin:
                 "max_tokens": self.client.max_token_length,
             },
         )
+
+        await self.emit_message(
+            "Narrator Guidance",
+            response,
+            meta={
+                "action": "narrator guidance",
+            },
+        )
+
         return strip_partial_sentences(response).strip()

src/talemate/agents/director/modules/agent-report-issue.json

@@ -0,0 +1,154 @@
+{
+  "title": "Agent Report Issue",
+  "id": "cfbec838-8e88-4dc0-89d3-f4a066f9b70f",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/agentReportIssue",
+  "nodes": {
+    "525b49ff-665b-40ae-8548-77b7be248745": {
+      "title": "task",
+      "id": "525b49ff-665b-40ae-8548-77b7be248745",
+      "properties": {
+        "name": "task",
+        "typ": "str",
+        "instructions": "Briefly describe the task that was not completed."
+      },
+      "x": 23,
+      "y": 78,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/Argument",
+      "base_type": "core/Node"
+    },
+    "274006b2-0cda-47d2-9e7a-5182affbc30d": {
+      "title": "report",
+      "id": "274006b2-0cda-47d2-9e7a-5182affbc30d",
+      "properties": {
+        "name": "issue",
+        "typ": "str",
+        "instructions": "Explanatioin of any issues you faced that prevented you from fulfilling the specified task."
+      },
+      "x": 33,
+      "y": 268,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/Argument",
+      "base_type": "core/Node"
+    },
+    "03aa565e-2cd9-401e-bb1b-750aecd159e3": {
+      "title": "Advanced Format",
+      "id": "03aa565e-2cd9-401e-bb1b-750aecd159e3",
+      "properties": {
+        "template": "Could not complete all tasks.\n\nTASK: {task}\n\nISSUE: {issue}"
+      },
+      "x": 313,
+      "y": 138,
+      "width": 210,
+      "height": 153,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "a0b1972c-5a0f-40aa-a30d-b299fab107c2": {
+      "title": "Return",
+      "id": "a0b1972c-5a0f-40aa-a30d-b299fab107c2",
+      "properties": {},
+      "x": 590,
+      "y": 180,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Return",
+      "base_type": "core/Node"
+    },
+    "16db1b24-2713-46f2-a329-2b7aa1b77f0e": {
+      "title": "AI Function Callback Metadata",
+      "id": "16db1b24-2713-46f2-a329-2b7aa1b77f0e",
+      "properties": {
+        "instructions": "Report back if you are unable to complete a task and why so assistance can be given to you.",
+        "examples": [
+          {
+            "task": "I was tasked to update existing context 'Dragon scales'.",
+            "issue": "I could not locate the Context ID for the entry."
+          }
+        ]
+      },
+      "x": 770,
+      "y": 180,
+      "width": 244,
+      "height": 82,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/Metadata",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "525b49ff-665b-40ae-8548-77b7be248745.value": [
+      "03aa565e-2cd9-401e-bb1b-750aecd159e3.item0"
+    ],
+    "274006b2-0cda-47d2-9e7a-5182affbc30d.value": [
+      "03aa565e-2cd9-401e-bb1b-750aecd159e3.item1"
+    ],
+    "03aa565e-2cd9-401e-bb1b-750aecd159e3.result": [
+      "a0b1972c-5a0f-40aa-a30d-b299fab107c2.value"
+    ],
+    "a0b1972c-5a0f-40aa-a30d-b299fab107c2.value": [
+      "16db1b24-2713-46f2-a329-2b7aa1b77f0e.state"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Process",
+      "x": 4,
+      "y": 3,
+      "width": 1119,
+      "height": 381,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/functions/Function",
+  "inputs": [],
+  "outputs": [
+    {
+      "id": "1792ee7b-f576-4f80-8df9-7bcd94e95e00",
+      "name": "fn",
+      "optional": false,
+      "group": null,
+      "socket_type": "function"
+    }
+  ],
+  "module_properties": {},
+  "style": {
+    "title_color": "#573a2e",
+    "node_color": "#392f2c",
+    "icon": "F0295",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/character-context.json

@@ -0,0 +1,808 @@
+{
+  "title": "Character Context",
+  "id": "8eab0bc0-009c-4868-a9dd-a3b4acadb919",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/characterContext",
+  "nodes": {
+    "9aa71776-f943-4182-ad7e-7f7ac7579d01": {
+      "title": "Switch",
+      "id": "9aa71776-f943-4182-ad7e-7f7ac7579d01",
+      "properties": {
+        "pass_through": true
+      },
+      "x": 278,
+      "y": 280,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Switch",
+      "base_type": "core/Node"
+    },
+    "715f1d40-c730-4f06-8690-22e5cdab0e7c": {
+      "title": "GET local.character",
+      "id": "715f1d40-c730-4f06-8690-22e5cdab0e7c",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 28,
+      "y": 250,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "c55d0ec9-927b-4eff-a5d5-cfdf1ea28560": {
+      "title": "Attributes Header",
+      "id": "c55d0ec9-927b-4eff-a5d5-cfdf1ea28560",
+      "properties": {
+        "template": "{character.name}'s Attributes"
+      },
+      "x": 1197,
+      "y": 9,
+      "width": 210,
+      "height": 133,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "b998c1c4-7e12-4882-b8d9-c0cc910963b9": {
+      "title": "Dynamic Instruction",
+      "id": "b998c1c4-7e12-4882-b8d9-c0cc910963b9",
+      "properties": {
+        "header": null,
+        "content": null
+      },
+      "x": 1463,
+      "y": 283,
+      "width": 228,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/DynamicInstruction",
+      "base_type": "core/Node"
+    },
+    "ab632855-c15e-4911-8729-ba3b625935c5": {
+      "title": "Dynamic Instruction",
+      "id": "ab632855-c15e-4911-8729-ba3b625935c5",
+      "properties": {
+        "header": null,
+        "content": null
+      },
+      "x": 1473,
+      "y": 503,
+      "width": 228,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/DynamicInstruction",
+      "base_type": "core/Node"
+    },
+    "9416a022-802b-4be6-a36b-81fcb732f7cd": {
+      "title": "Dynamic Instruction",
+      "id": "9416a022-802b-4be6-a36b-81fcb732f7cd",
+      "properties": {
+        "header": null,
+        "content": null
+      },
+      "x": 1473,
+      "y": 34,
+      "width": 228,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/DynamicInstruction",
+      "base_type": "core/Node"
+    },
+    "8d97d5b1-0855-430e-8b34-811d238c727a": {
+      "title": "SET local.character_context",
+      "id": "8d97d5b1-0855-430e-8b34-811d238c727a",
+      "properties": {
+        "name": "character_context",
+        "scope": "local"
+      },
+      "x": 1976,
+      "y": 240,
+      "width": 227,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "2c781216-86dd-4a83-ad71-256d1889bcdf": {
+      "title": "GET local.character",
+      "id": "2c781216-86dd-4a83-ad71-256d1889bcdf",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 37,
+      "y": 1026,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "fa7c8a06-a631-4adf-a993-76d35001358d": {
+      "title": "GET local.character_context",
+      "id": "fa7c8a06-a631-4adf-a993-76d35001358d",
+      "properties": {
+        "name": "character_context",
+        "scope": "local"
+      },
+      "x": 27,
+      "y": 1216,
+      "width": 227,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "86469aa3-403e-453c-b4a5-f6998a13a601": {
+      "title": "OUT dynamic_instruction",
+      "id": "86469aa3-403e-453c-b4a5-f6998a13a601",
+      "properties": {
+        "output_type": "list",
+        "output_name": "character_context",
+        "num": 1
+      },
+      "x": 387,
+      "y": 1236,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "4c159f82-1858-45e3-922b-36b485bfa7f9": {
+      "title": "Stage 1",
+      "id": "4c159f82-1858-45e3-922b-36b485bfa7f9",
+      "properties": {
+        "stage": 1
+      },
+      "x": 2242,
+      "y": 237,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "bd428cde-493e-4b50-ad9f-3d2800c9f911": {
+      "title": "Dertails Header",
+      "id": "bd428cde-493e-4b50-ad9f-3d2800c9f911",
+      "properties": {
+        "template": "{character.name}'s Detailed Information"
+      },
+      "x": 1212,
+      "y": 227,
+      "width": 210,
+      "height": 133,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "f399112f-2cd4-4354-b786-4b3d81e046fc": {
+      "title": "Dertails Header",
+      "id": "f399112f-2cd4-4354-b786-4b3d81e046fc",
+      "properties": {
+        "template": "{character.name}'s Description"
+      },
+      "x": 1212,
+      "y": 457,
+      "width": 210,
+      "height": 133,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "091f49f1-fb01-4ee9-a44f-3d60184580a6": {
+      "title": "List Collector",
+      "id": "091f49f1-fb01-4ee9-a44f-3d60184580a6",
+      "properties": {},
+      "x": 1495,
+      "y": 793,
+      "width": 140,
+      "height": 101,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/ListCollector",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "34b7def1-91b9-405a-ad02-a359a4216fc6": {
+      "title": "Dynamic Instruction",
+      "id": "34b7def1-91b9-405a-ad02-a359a4216fc6",
+      "properties": {
+        "header": "Character Configuration",
+        "content": null
+      },
+      "x": 1675,
+      "y": 753,
+      "width": 228,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/DynamicInstruction",
+      "base_type": "core/Node"
+    },
+    "71494b49-7c71-4de4-a18e-337005c8f7d4": {
+      "title": "RSwitch Advanced",
+      "id": "71494b49-7c71-4de4-a18e-337005c8f7d4",
+      "properties": {},
+      "x": 955,
+      "y": 333,
+      "width": 176,
+      "height": 66,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/RSwitchAdvanced",
+      "base_type": "core/Node"
+    },
+    "3f8ca797-dbc1-4aa9-8f4e-84302380bbc9": {
+      "title": "GET local.include_details",
+      "id": "3f8ca797-dbc1-4aa9-8f4e-84302380bbc9",
+      "properties": {
+        "name": "include_details",
+        "scope": "local"
+      },
+      "x": 935,
+      "y": 303,
+      "width": 210,
+      "height": 122,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "37c84835-3318-4ca1-acf2-f405de7d7e3e": {
+      "title": "GET local.include_details",
+      "id": "37c84835-3318-4ca1-acf2-f405de7d7e3e",
+      "properties": {
+        "name": "include_details",
+        "scope": "local"
+      },
+      "x": 475,
+      "y": 663,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "0110003a-ec78-4e90-aad5-5caa4219c29e": {
+      "title": "SET local.include_details",
+      "id": "0110003a-ec78-4e90-aad5-5caa4219c29e",
+      "properties": {
+        "name": "include_details",
+        "scope": "local"
+      },
+      "x": 350,
+      "y": -836,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "899dcae1-d8e3-4895-9c94-ff714cb9f100": {
+      "title": "SET local.include_details",
+      "id": "899dcae1-d8e3-4895-9c94-ff714cb9f100",
+      "properties": {
+        "name": "include_details",
+        "scope": "local"
+      },
+      "x": 348,
+      "y": -573,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "c71781be-b177-45af-9c8f-c1ebf157f268": {
+      "title": "Input Socket",
+      "id": "c71781be-b177-45af-9c8f-c1ebf157f268",
+      "properties": {
+        "input_type": "character",
+        "input_name": "character",
+        "input_optional": false,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 30,
+      "y": -253,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "6d4f53fc-e2fa-406f-816b-d078538502ef": {
+      "title": "SET local.character",
+      "id": "6d4f53fc-e2fa-406f-816b-d078538502ef",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 330,
+      "y": -233,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "c0fa5a08-066b-4adc-b980-9daa5f80763e": {
+      "title": "Stage 0",
+      "id": "c0fa5a08-066b-4adc-b980-9daa5f80763e",
+      "properties": {
+        "stage": 0
+      },
+      "x": 790,
+      "y": -563,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "481ee93d-769d-4283-8e72-25cc3237a105": {
+      "title": "Module Style",
+      "id": "481ee93d-769d-4283-8e72-25cc3237a105",
+      "properties": {
+        "node_color": "#27233a",
+        "title_color": "#3d315b",
+        "auto_title": null,
+        "icon": "F09DE"
+      },
+      "x": 820,
+      "y": -913,
+      "width": 210,
+      "height": 110,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/ModuleStyle",
+      "base_type": "core/Node"
+    },
+    "931d34b1-126a-48a8-80f9-0af0ffc6c2a8": {
+      "title": "PROP include_details",
+      "id": "931d34b1-126a-48a8-80f9-0af0ffc6c2a8",
+      "properties": {
+        "property_name": "include_config",
+        "property_type": "bool",
+        "default": "false",
+        "choices": [],
+        "description": "Include background details",
+        "num": 1
+      },
+      "x": 28,
+      "y": -603,
+      "width": 256,
+      "height": 198,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/ModuleProperty",
+      "base_type": "core/Node"
+    },
+    "dd8dc917-4a74-49db-a9c3-93ea33c2f55a": {
+      "title": "PROP include_details",
+      "id": "dd8dc917-4a74-49db-a9c3-93ea33c2f55a",
+      "properties": {
+        "property_name": "include_details",
+        "property_type": "bool",
+        "default": "true",
+        "choices": [],
+        "description": "Include background details",
+        "num": 0
+      },
+      "x": 30,
+      "y": -865,
+      "width": 256,
+      "height": 198,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/ModuleProperty",
+      "base_type": "core/Node"
+    },
+    "cfb75f37-92d1-4111-921e-ee783762cf72": {
+      "title": "OUT character",
+      "id": "cfb75f37-92d1-4111-921e-ee783762cf72",
+      "properties": {
+        "output_type": "character",
+        "output_name": "character",
+        "num": 0
+      },
+      "x": 380,
+      "y": 1020,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "846f1c33-4aad-470c-8c40-a84b925d742c": {
+      "title": "RSwitch Advanced",
+      "id": "846f1c33-4aad-470c-8c40-a84b925d742c",
+      "properties": {},
+      "x": 870,
+      "y": 840,
+      "width": 176,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitchAdvanced",
+      "base_type": "core/Node"
+    },
+    "8da4f2ff-1f1e-4b6e-8fa2-7be93d28c91d": {
+      "title": "Render Context IDs",
+      "id": "8da4f2ff-1f1e-4b6e-8fa2-7be93d28c91d",
+      "properties": {
+        "display_mode": "compact"
+      },
+      "x": 1175,
+      "y": 843,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/RenderContextIDs",
+      "base_type": "core/Node"
+    },
+    "9a05071c-d55c-48ea-a5de-b2f5b21a32dc": {
+      "title": "Render Context IDs",
+      "id": "9a05071c-d55c-48ea-a5de-b2f5b21a32dc",
+      "properties": {
+        "display_mode": "compact"
+      },
+      "x": 1170,
+      "y": 530,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/RenderContextIDs",
+      "base_type": "core/Node"
+    },
+    "891ddc97-7225-4ba2-911b-fb5882a003a9": {
+      "title": "RSwitch Advanced",
+      "id": "891ddc97-7225-4ba2-911b-fb5882a003a9",
+      "properties": {},
+      "x": 870,
+      "y": 680,
+      "width": 176,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitchAdvanced",
+      "base_type": "core/Node"
+    },
+    "ab91528b-409d-46f5-9881-f6c0e2b12297": {
+      "title": "Render Context IDs",
+      "id": "ab91528b-409d-46f5-9881-f6c0e2b12297",
+      "properties": {
+        "display_mode": "compact"
+      },
+      "x": 1180,
+      "y": 680,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/RenderContextIDs",
+      "base_type": "core/Node"
+    },
+    "36a69808-2a2f-47ab-871c-79cde27bda19": {
+      "title": "Render Context IDs",
+      "id": "36a69808-2a2f-47ab-871c-79cde27bda19",
+      "properties": {
+        "display_mode": "subsection"
+      },
+      "x": 1170,
+      "y": 300,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/RenderContextIDs",
+      "base_type": "core/Node"
+    },
+    "6072e646-09b3-435d-ba1b-51227aa0865b": {
+      "title": "Render Context IDs",
+      "id": "6072e646-09b3-435d-ba1b-51227aa0865b",
+      "properties": {
+        "display_mode": "normal"
+      },
+      "x": 1160,
+      "y": 80,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/RenderContextIDs",
+      "base_type": "core/Node"
+    },
+    "caf10f6f-b3c3-492b-aa45-6f3200f28914": {
+      "title": "List Collector",
+      "id": "caf10f6f-b3c3-492b-aa45-6f3200f28914",
+      "properties": {},
+      "x": 1796,
+      "y": 272,
+      "width": 140,
+      "height": 141,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/ListCollector",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        },
+        {
+          "name": "item2",
+          "type": "*"
+        },
+        {
+          "name": "item3",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f": {
+      "title": "Character Context IDs",
+      "id": "ab90ab05-cbb0-45af-8d58-57e71d5e528f",
+      "properties": {},
+      "x": 512,
+      "y": 267,
+      "width": 262,
+      "height": 126,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/CharacterContextIDs",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "9aa71776-f943-4182-ad7e-7f7ac7579d01.yes": [
+      "ab90ab05-cbb0-45af-8d58-57e71d5e528f.character"
+    ],
+    "715f1d40-c730-4f06-8690-22e5cdab0e7c.value": [
+      "9aa71776-f943-4182-ad7e-7f7ac7579d01.value"
+    ],
+    "c55d0ec9-927b-4eff-a5d5-cfdf1ea28560.result": [
+      "9416a022-802b-4be6-a36b-81fcb732f7cd.header"
+    ],
+    "b998c1c4-7e12-4882-b8d9-c0cc910963b9.dynamic_instruction": [
+      "caf10f6f-b3c3-492b-aa45-6f3200f28914.item1"
+    ],
+    "ab632855-c15e-4911-8729-ba3b625935c5.dynamic_instruction": [
+      "caf10f6f-b3c3-492b-aa45-6f3200f28914.item2"
+    ],
+    "9416a022-802b-4be6-a36b-81fcb732f7cd.dynamic_instruction": [
+      "caf10f6f-b3c3-492b-aa45-6f3200f28914.item0"
+    ],
+    "8d97d5b1-0855-430e-8b34-811d238c727a.value": [
+      "4c159f82-1858-45e3-922b-36b485bfa7f9.state"
+    ],
+    "2c781216-86dd-4a83-ad71-256d1889bcdf.value": [
+      "cfb75f37-92d1-4111-921e-ee783762cf72.value"
+    ],
+    "fa7c8a06-a631-4adf-a993-76d35001358d.value": [
+      "86469aa3-403e-453c-b4a5-f6998a13a601.value"
+    ],
+    "bd428cde-493e-4b50-ad9f-3d2800c9f911.result": [
+      "b998c1c4-7e12-4882-b8d9-c0cc910963b9.header"
+    ],
+    "f399112f-2cd4-4354-b786-4b3d81e046fc.result": [
+      "ab632855-c15e-4911-8729-ba3b625935c5.header"
+    ],
+    "091f49f1-fb01-4ee9-a44f-3d60184580a6.list": [
+      "34b7def1-91b9-405a-ad02-a359a4216fc6.content"
+    ],
+    "34b7def1-91b9-405a-ad02-a359a4216fc6.dynamic_instruction": [
+      "caf10f6f-b3c3-492b-aa45-6f3200f28914.item3"
+    ],
+    "71494b49-7c71-4de4-a18e-337005c8f7d4.yes": [
+      "36a69808-2a2f-47ab-871c-79cde27bda19.items"
+    ],
+    "3f8ca797-dbc1-4aa9-8f4e-84302380bbc9.value": [
+      "71494b49-7c71-4de4-a18e-337005c8f7d4.check"
+    ],
+    "37c84835-3318-4ca1-acf2-f405de7d7e3e.value": [
+      "846f1c33-4aad-470c-8c40-a84b925d742c.check",
+      "891ddc97-7225-4ba2-911b-fb5882a003a9.check"
+    ],
+    "0110003a-ec78-4e90-aad5-5caa4219c29e.value": [
+      "c0fa5a08-066b-4adc-b980-9daa5f80763e.state"
+    ],
+    "899dcae1-d8e3-4895-9c94-ff714cb9f100.value": [
+      "c0fa5a08-066b-4adc-b980-9daa5f80763e.state_b"
+    ],
+    "c71781be-b177-45af-9c8f-c1ebf157f268.value": [
+      "6d4f53fc-e2fa-406f-816b-d078538502ef.value"
+    ],
+    "6d4f53fc-e2fa-406f-816b-d078538502ef.value": [
+      "c0fa5a08-066b-4adc-b980-9daa5f80763e.state_c"
+    ],
+    "931d34b1-126a-48a8-80f9-0af0ffc6c2a8.value": [
+      "899dcae1-d8e3-4895-9c94-ff714cb9f100.value"
+    ],
+    "dd8dc917-4a74-49db-a9c3-93ea33c2f55a.name": [
+      "0110003a-ec78-4e90-aad5-5caa4219c29e.name"
+    ],
+    "dd8dc917-4a74-49db-a9c3-93ea33c2f55a.value": [
+      "0110003a-ec78-4e90-aad5-5caa4219c29e.value"
+    ],
+    "846f1c33-4aad-470c-8c40-a84b925d742c.yes": [
+      "8da4f2ff-1f1e-4b6e-8fa2-7be93d28c91d.items"
+    ],
+    "8da4f2ff-1f1e-4b6e-8fa2-7be93d28c91d.rendered": [
+      "091f49f1-fb01-4ee9-a44f-3d60184580a6.item1"
+    ],
+    "9a05071c-d55c-48ea-a5de-b2f5b21a32dc.rendered": [
+      "ab632855-c15e-4911-8729-ba3b625935c5.content"
+    ],
+    "891ddc97-7225-4ba2-911b-fb5882a003a9.yes": [
+      "ab91528b-409d-46f5-9881-f6c0e2b12297.items"
+    ],
+    "ab91528b-409d-46f5-9881-f6c0e2b12297.rendered": [
+      "091f49f1-fb01-4ee9-a44f-3d60184580a6.item0"
+    ],
+    "36a69808-2a2f-47ab-871c-79cde27bda19.rendered": [
+      "b998c1c4-7e12-4882-b8d9-c0cc910963b9.content"
+    ],
+    "6072e646-09b3-435d-ba1b-51227aa0865b.rendered": [
+      "9416a022-802b-4be6-a36b-81fcb732f7cd.content"
+    ],
+    "caf10f6f-b3c3-492b-aa45-6f3200f28914.list": [
+      "8d97d5b1-0855-430e-8b34-811d238c727a.value"
+    ],
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f.character": [
+      "c55d0ec9-927b-4eff-a5d5-cfdf1ea28560.item0",
+      "bd428cde-493e-4b50-ad9f-3d2800c9f911.item0",
+      "f399112f-2cd4-4354-b786-4b3d81e046fc.item0"
+    ],
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f.attributes": [
+      "6072e646-09b3-435d-ba1b-51227aa0865b.items"
+    ],
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f.details": [
+      "71494b49-7c71-4de4-a18e-337005c8f7d4.yes"
+    ],
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f.description": [
+      "9a05071c-d55c-48ea-a5de-b2f5b21a32dc.items"
+    ],
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f.acting_instructions": [
+      "891ddc97-7225-4ba2-911b-fb5882a003a9.yes"
+    ],
+    "ab90ab05-cbb0-45af-8d58-57e71d5e528f.example_dialogue": [
+      "846f1c33-4aad-470c-8c40-a84b925d742c.yes"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Process",
+      "x": 3,
+      "y": -71,
+      "width": 2474,
+      "height": 1017,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Validation",
+      "x": 3,
+      "y": -993,
+      "width": 1052,
+      "height": 919,
+      "color": "#b58b2a",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Output",
+      "x": 3,
+      "y": 949,
+      "width": 630,
+      "height": 421,
+      "color": "#8A8",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/Graph",
+  "inputs": [],
+  "outputs": [],
+  "module_properties": {
+    "include_details": {
+      "name": "include_details",
+      "description": "Include background details",
+      "type": "bool",
+      "default": true,
+      "choices": [],
+      "readonly": false,
+      "step": null,
+      "min": null,
+      "max": null,
+      "ephemeral": false
+    },
+    "include_config": {
+      "name": "include_config",
+      "description": "Include background details",
+      "type": "bool",
+      "default": false,
+      "choices": [],
+      "readonly": false,
+      "step": null,
+      "min": null,
+      "max": null,
+      "ephemeral": false
+    }
+  },
+  "style": {
+    "title_color": "#3d315b",
+    "node_color": "#27233a",
+    "icon": "F09DE",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/character-names-context.json

@@ -0,0 +1,412 @@
+{
+  "title": "Character Names Context",
+  "id": "18245c31-f3f4-4c03-babe-2254586d52d4",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/characterNamesContext",
+  "nodes": {
+    "2cfbcc4a-023e-4b6f-b4dc-5ed01d6c8f2b": {
+      "title": "OUT state",
+      "id": "2cfbcc4a-023e-4b6f-b4dc-5ed01d6c8f2b",
+      "properties": {
+        "output_type": "any",
+        "output_name": "state",
+        "num": 0
+      },
+      "x": 420,
+      "y": 80,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "78f93251-8f9d-4d5c-99cd-54534e40a827": {
+      "title": "Input Socket",
+      "id": "78f93251-8f9d-4d5c-99cd-54534e40a827",
+      "properties": {
+        "input_type": "any",
+        "input_name": "state",
+        "input_optional": false,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 40,
+      "y": 70,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "bd2c35fa-b219-4dcb-8b64-cfb35e898149": {
+      "title": "item",
+      "id": "bd2c35fa-b219-4dcb-8b64-cfb35e898149",
+      "properties": {
+        "name": "item",
+        "typ": "any"
+      },
+      "x": -1456,
+      "y": 70,
+      "width": 210,
+      "height": 82,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Argument",
+      "base_type": "core/Node"
+    },
+    "6bce6796-df9d-4b41-8096-800406b1c8b4": {
+      "title": "Unpack Character",
+      "id": "6bce6796-df9d-4b41-8096-800406b1c8b4",
+      "properties": {},
+      "x": -1196,
+      "y": 70,
+      "width": 212,
+      "height": 146,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "scene/UnpackCharacter",
+      "base_type": "core/Node"
+    },
+    "09ae2df0-0247-4bae-9764-e6046803832b": {
+      "title": "Excerpt",
+      "id": "09ae2df0-0247-4bae-9764-e6046803832b",
+      "properties": {
+        "length": 100,
+        "add_ellipsis": true
+      },
+      "x": -936,
+      "y": 170,
+      "width": 210,
+      "height": 82,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/Excerpt",
+      "base_type": "core/Node"
+    },
+    "0727e4cd-8f05-4e6c-9cce-e9361e86857d": {
+      "title": "Advanced Format",
+      "id": "0727e4cd-8f05-4e6c-9cce-e9361e86857d",
+      "properties": {
+        "template": "- `{name}`: {result}\n"
+      },
+      "x": -656,
+      "y": 70,
+      "width": 210,
+      "height": 153,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "697fa805-18bf-4634-8b18-38f46a71f3fb": {
+      "title": "Return",
+      "id": "697fa805-18bf-4634-8b18-38f46a71f3fb",
+      "properties": {},
+      "x": -386,
+      "y": 140,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Return",
+      "base_type": "core/Node"
+    },
+    "46df5bea-50b7-40b3-a9db-917bf11478b0": {
+      "title": "DEF list_character",
+      "id": "46df5bea-50b7-40b3-a9db-917bf11478b0",
+      "properties": {
+        "name": "list_character"
+      },
+      "x": -226,
+      "y": 120,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/DefineFunction",
+      "base_type": "core/Node"
+    },
+    "bb8bf088-9dea-4e7d-a7c7-8abdd29992f2": {
+      "title": "FN list_character",
+      "id": "bb8bf088-9dea-4e7d-a7c7-8abdd29992f2",
+      "properties": {
+        "name": "list_character"
+      },
+      "x": 812,
+      "y": 508,
+      "width": 210,
+      "height": 78,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/functions/GetFunction",
+      "base_type": "core/Node"
+    },
+    "6d7aabc0-740e-4820-93d0-9fad9de50fca": {
+      "title": "true",
+      "id": "6d7aabc0-740e-4820-93d0-9fad9de50fca",
+      "properties": {
+        "value": true
+      },
+      "x": 652,
+      "y": 528,
+      "width": 210,
+      "height": 58,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/MakeBool",
+      "base_type": "core/Node"
+    },
+    "d666367c-1b0a-4885-893b-e0211a417ca1": {
+      "title": "Call For Each",
+      "id": "d666367c-1b0a-4885-893b-e0211a417ca1",
+      "properties": {
+        "copy_items": false,
+        "argument_name": "item"
+      },
+      "x": 782,
+      "y": 538,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/CallForEach",
+      "base_type": "core/Node"
+    },
+    "b94ffd51-0fb8-4659-8ed1-9e94d6d8565c": {
+      "title": "Make Text",
+      "id": "b94ffd51-0fb8-4659-8ed1-9e94d6d8565c",
+      "properties": {
+        "value": "Persistent Character Listing"
+      },
+      "x": 350,
+      "y": 410,
+      "width": 210,
+      "height": 58,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/MakeText",
+      "base_type": "core/Node"
+    },
+    "a39370c3-7cf6-42c9-84a5-559dedcec096": {
+      "title": "RSwitch",
+      "id": "a39370c3-7cf6-42c9-84a5-559dedcec096",
+      "properties": {},
+      "x": 680,
+      "y": 330,
+      "width": 140,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitch",
+      "base_type": "core/Node"
+    },
+    "1bcc2cb0-e297-4911-9659-44c65a6b508c": {
+      "title": "Dynamic Instruction",
+      "id": "1bcc2cb0-e297-4911-9659-44c65a6b508c",
+      "properties": {
+        "header": "Characters",
+        "content": null
+      },
+      "x": 1090,
+      "y": 430,
+      "width": 228,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/DynamicInstruction",
+      "base_type": "core/Node"
+    },
+    "fe9c236b-caca-4de4-acd0-06f6f81bfec7": {
+      "title": "OUT state",
+      "id": "fe9c236b-caca-4de4-acd0-06f6f81bfec7",
+      "properties": {
+        "output_type": "dynamic_instruction",
+        "output_name": "dynamic_instruction",
+        "num": 1
+      },
+      "x": 1390,
+      "y": 420,
+      "width": 270,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "33e3ca03-5193-476e-a30c-cf2103b7406b": {
+      "title": "Module Style",
+      "id": "33e3ca03-5193-476e-a30c-cf2103b7406b",
+      "properties": {
+        "node_color": "#27233a",
+        "title_color": "#3d315b",
+        "auto_title": null,
+        "icon": "F09DE"
+      },
+      "x": 1430,
+      "y": 100,
+      "width": 210,
+      "height": 110,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/ModuleStyle",
+      "base_type": "core/Node"
+    },
+    "9824a723-ee64-4e0d-ab50-0d4824e5799c": {
+      "title": "Input Socket",
+      "id": "9824a723-ee64-4e0d-ab50-0d4824e5799c",
+      "properties": {
+        "input_type": "str",
+        "input_name": "header",
+        "input_optional": true,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 50,
+      "y": 280,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "38b09291-5ab2-4137-981d-4a8da7d8884a": {
+      "title": "List Characters",
+      "id": "38b09291-5ab2-4137-981d-4a8da7d8884a",
+      "properties": {
+        "character_status": "all"
+      },
+      "x": 332,
+      "y": 538,
+      "width": 228,
+      "height": 58,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "scene/ListCharacters",
+      "base_type": "core/Node"
+    },
+    "b70aff1c-b46f-4538-88ac-281bbf0a31d7": {
+      "title": "Input Socket",
+      "id": "b70aff1c-b46f-4538-88ac-281bbf0a31d7",
+      "properties": {
+        "input_type": "any",
+        "input_name": "character_status",
+        "input_optional": true,
+        "input_group": "",
+        "num": 2
+      },
+      "x": 42,
+      "y": 488,
+      "width": 247,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "78f93251-8f9d-4d5c-99cd-54534e40a827.value": [
+      "2cfbcc4a-023e-4b6f-b4dc-5ed01d6c8f2b.value"
+    ],
+    "bd2c35fa-b219-4dcb-8b64-cfb35e898149.value": [
+      "6bce6796-df9d-4b41-8096-800406b1c8b4.character"
+    ],
+    "6bce6796-df9d-4b41-8096-800406b1c8b4.name": [
+      "0727e4cd-8f05-4e6c-9cce-e9361e86857d.item0"
+    ],
+    "6bce6796-df9d-4b41-8096-800406b1c8b4.description": [
+      "09ae2df0-0247-4bae-9764-e6046803832b.string"
+    ],
+    "09ae2df0-0247-4bae-9764-e6046803832b.result": [
+      "0727e4cd-8f05-4e6c-9cce-e9361e86857d.item1"
+    ],
+    "0727e4cd-8f05-4e6c-9cce-e9361e86857d.result": [
+      "697fa805-18bf-4634-8b18-38f46a71f3fb.value"
+    ],
+    "697fa805-18bf-4634-8b18-38f46a71f3fb.value": [
+      "46df5bea-50b7-40b3-a9db-917bf11478b0.nodes"
+    ],
+    "bb8bf088-9dea-4e7d-a7c7-8abdd29992f2.fn": [
+      "d666367c-1b0a-4885-893b-e0211a417ca1.fn"
+    ],
+    "6d7aabc0-740e-4820-93d0-9fad9de50fca.value": [
+      "d666367c-1b0a-4885-893b-e0211a417ca1.state"
+    ],
+    "d666367c-1b0a-4885-893b-e0211a417ca1.results": [
+      "1bcc2cb0-e297-4911-9659-44c65a6b508c.content"
+    ],
+    "b94ffd51-0fb8-4659-8ed1-9e94d6d8565c.value": [
+      "a39370c3-7cf6-42c9-84a5-559dedcec096.no"
+    ],
+    "a39370c3-7cf6-42c9-84a5-559dedcec096.value": [
+      "1bcc2cb0-e297-4911-9659-44c65a6b508c.header"
+    ],
+    "1bcc2cb0-e297-4911-9659-44c65a6b508c.dynamic_instruction": [
+      "fe9c236b-caca-4de4-acd0-06f6f81bfec7.value"
+    ],
+    "9824a723-ee64-4e0d-ab50-0d4824e5799c.value": [
+      "a39370c3-7cf6-42c9-84a5-559dedcec096.check",
+      "a39370c3-7cf6-42c9-84a5-559dedcec096.yes"
+    ],
+    "38b09291-5ab2-4137-981d-4a8da7d8884a.characters": [
+      "d666367c-1b0a-4885-893b-e0211a417ca1.items"
+    ],
+    "b70aff1c-b46f-4538-88ac-281bbf0a31d7.value": [
+      "38b09291-5ab2-4137-981d-4a8da7d8884a.character_status"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Group",
+      "x": -1481,
+      "y": -5,
+      "width": 1490,
+      "height": 282,
+      "color": "#b06634",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Group",
+      "x": 15,
+      "y": -5,
+      "width": 1719,
+      "height": 716,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/Graph",
+  "inputs": [],
+  "outputs": [],
+  "module_properties": {},
+  "style": {
+    "title_color": "#3d315b",
+    "node_color": "#27233a",
+    "icon": "F09DE",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/direct-context-update.json

@@ -0,0 +1,318 @@
+{
+  "title": "Direct Context Update",
+  "id": "d5c3aa90-e999-45c9-a39d-5024775434ab",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/directContextUpdate",
+  "nodes": {
+    "c62f076c-8e48-4a1a-ac50-e31ea4766895": {
+      "title": "context_id",
+      "id": "c62f076c-8e48-4a1a-ac50-e31ea4766895",
+      "properties": {
+        "name": "context_id",
+        "typ": "str",
+        "instructions": "The exact Context ID given to you in your instructions."
+      },
+      "x": 26,
+      "y": 73,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/Argument",
+      "base_type": "core/Node"
+    },
+    "38961db6-7b4a-4ad1-a91a-1e8b151ee795": {
+      "title": "Validate Context ID Item",
+      "id": "38961db6-7b4a-4ad1-a91a-1e8b151ee795",
+      "properties": {
+        "error_message": ""
+      },
+      "x": 296,
+      "y": 83,
+      "width": 245,
+      "height": 158,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateContextIDItem",
+      "base_type": "core/Node"
+    },
+    "22020aa2-1867-40e5-9a7b-96e93f2945ed": {
+      "title": "value",
+      "id": "22020aa2-1867-40e5-9a7b-96e93f2945ed",
+      "properties": {
+        "name": "value",
+        "typ": "str",
+        "instructions": "The exact value given do you in your instructions."
+      },
+      "x": 26,
+      "y": 253,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/Argument",
+      "base_type": "core/Node"
+    },
+    "2bec2758-fe44-468a-a9ec-73d236f3a09f": {
+      "title": "Return",
+      "id": "2bec2758-fe44-468a-a9ec-73d236f3a09f",
+      "properties": {},
+      "x": 2246,
+      "y": 203,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Return",
+      "base_type": "core/Node"
+    },
+    "6d188919-9f0e-4945-b9ff-d75ee92b0ce9": {
+      "title": "Path to Context ID",
+      "id": "6d188919-9f0e-4945-b9ff-d75ee92b0ce9",
+      "properties": {
+        "path": ""
+      },
+      "x": 606,
+      "y": 83,
+      "width": 210,
+      "height": 218,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/PathToContextID",
+      "base_type": "core/Node"
+    },
+    "c8044776-d8a7-41b2-b800-374f0739a818": {
+      "title": "Diff",
+      "id": "c8044776-d8a7-41b2-b800-374f0739a818",
+      "properties": {},
+      "x": 814,
+      "y": 393,
+      "width": 140,
+      "height": 86,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/Diff",
+      "base_type": "core/Node"
+    },
+    "db7c5f98-b007-4187-a47d-26490c3219bc": {
+      "title": "Context ID Set Value",
+      "id": "db7c5f98-b007-4187-a47d-26490c3219bc",
+      "properties": {
+        "path": ""
+      },
+      "x": 1584,
+      "y": 103,
+      "width": 262,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/ContextIDSetValue",
+      "base_type": "core/Node"
+    },
+    "8b71aa2a-3930-4c9a-ae81-590e65e66f56": {
+      "title": "Advanced Format",
+      "id": "8b71aa2a-3930-4c9a-ae81-590e65e66f56",
+      "properties": {
+        "template": "Changed `{context_id_item.context_id}`\nTarget: {human_id}\n\n``` diff\n{diff_plain}\n```"
+      },
+      "x": 1985,
+      "y": 227,
+      "width": 210,
+      "height": 213,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        },
+        {
+          "name": "item2",
+          "type": "*"
+        },
+        {
+          "name": "item3",
+          "type": "*"
+        },
+        {
+          "name": "item4",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "e2e099d2-f704-425b-82c2-5b7cfdf47b49": {
+      "title": "Emit Scene Status",
+      "id": "e2e099d2-f704-425b-82c2-5b7cfdf47b49",
+      "properties": {},
+      "x": 1912,
+      "y": 89,
+      "width": 143,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "event/EmitSceneStatus",
+      "base_type": "core/Node"
+    },
+    "aef5ffb9-835f-42c4-aec2-c320f43e57f7": {
+      "title": "Advanced Format",
+      "id": "aef5ffb9-835f-42c4-aec2-c320f43e57f7",
+      "properties": {
+        "template": "Update `{human_id}`:\n\n``` diff\n{diff_plain}\n```"
+      },
+      "x": 1092,
+      "y": 309,
+      "width": 210,
+      "height": 153,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "d16b01eb-a9eb-438b-8012-29cfc8285f09": {
+      "title": "Director Action Confirm",
+      "id": "d16b01eb-a9eb-438b-8012-29cfc8285f09",
+      "properties": {
+        "name": "update_context",
+        "description": "",
+        "raise_on_reject": true
+      },
+      "x": 1284,
+      "y": 233,
+      "width": 237,
+      "height": 146,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/chat/ActionConfirm",
+      "base_type": "core/Node"
+    },
+    "4d716619-394a-441c-94ac-f4b3ed800c10": {
+      "title": "AI Function Callback Metadata",
+      "id": "4d716619-394a-441c-94ac-f4b3ed800c10",
+      "properties": {
+        "instructions": "Make a direct value replacement update to a provided Context ID.\n\nNEVER use this to update character or world context. Leave it to the writers.\n\nIMPORTANT: You must only use this if both an extact Context ID and a new complete VERBATIM value have been provided to you in your instructions. Otherwise defer to the dedicated functions provided for the context type.\n\nYou CANNOT pass instructions to the value as this is a DIRECT VALUE REPLACEMENT.\n\nYou CANNOT use this to create or delete Context IDs, only update existing ones.\n\nThis can be used to quickly update:\n\n- Story Title via Context ID `story_configuration:title`\n- Story Description via Context ID `story_configuration:description`\n- Content Classification via Context ID `story_configuration:content_classification`",
+        "examples": [
+          {
+            "context_id": "character.attribute:Jessica.013f54400c82",
+            "value": "32"
+          },
+          {
+            "context_id": "story_configuration:title",
+            "value": "Infinity Quest 2"
+          }
+        ]
+      },
+      "x": 2424,
+      "y": 183,
+      "width": 314,
+      "height": 82,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/Metadata",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "c62f076c-8e48-4a1a-ac50-e31ea4766895.value": [
+      "38961db6-7b4a-4ad1-a91a-1e8b151ee795.value"
+    ],
+    "38961db6-7b4a-4ad1-a91a-1e8b151ee795.value": [
+      "6d188919-9f0e-4945-b9ff-d75ee92b0ce9.path"
+    ],
+    "22020aa2-1867-40e5-9a7b-96e93f2945ed.value": [
+      "c8044776-d8a7-41b2-b800-374f0739a818.b",
+      "d16b01eb-a9eb-438b-8012-29cfc8285f09.state"
+    ],
+    "2bec2758-fe44-468a-a9ec-73d236f3a09f.value": [
+      "4d716619-394a-441c-94ac-f4b3ed800c10.state"
+    ],
+    "6d188919-9f0e-4945-b9ff-d75ee92b0ce9.context_id_item": [
+      "db7c5f98-b007-4187-a47d-26490c3219bc.context_id_item"
+    ],
+    "6d188919-9f0e-4945-b9ff-d75ee92b0ce9.human_id": [
+      "8b71aa2a-3930-4c9a-ae81-590e65e66f56.item2",
+      "aef5ffb9-835f-42c4-aec2-c320f43e57f7.item0"
+    ],
+    "6d188919-9f0e-4945-b9ff-d75ee92b0ce9.value": [
+      "c8044776-d8a7-41b2-b800-374f0739a818.a"
+    ],
+    "c8044776-d8a7-41b2-b800-374f0739a818.diff_plain": [
+      "8b71aa2a-3930-4c9a-ae81-590e65e66f56.item3",
+      "aef5ffb9-835f-42c4-aec2-c320f43e57f7.item1"
+    ],
+    "db7c5f98-b007-4187-a47d-26490c3219bc.context_id_item": [
+      "8b71aa2a-3930-4c9a-ae81-590e65e66f56.item4",
+      "e2e099d2-f704-425b-82c2-5b7cfdf47b49.state"
+    ],
+    "db7c5f98-b007-4187-a47d-26490c3219bc.value": [
+      "8b71aa2a-3930-4c9a-ae81-590e65e66f56.item1"
+    ],
+    "8b71aa2a-3930-4c9a-ae81-590e65e66f56.result": [
+      "2bec2758-fe44-468a-a9ec-73d236f3a09f.value"
+    ],
+    "e2e099d2-f704-425b-82c2-5b7cfdf47b49.state": [
+      "8b71aa2a-3930-4c9a-ae81-590e65e66f56.item0"
+    ],
+    "aef5ffb9-835f-42c4-aec2-c320f43e57f7.result": [
+      "d16b01eb-a9eb-438b-8012-29cfc8285f09.description"
+    ],
+    "d16b01eb-a9eb-438b-8012-29cfc8285f09.accepted": [
+      "db7c5f98-b007-4187-a47d-26490c3219bc.state",
+      "db7c5f98-b007-4187-a47d-26490c3219bc.value"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Function",
+      "x": 1,
+      "y": -3,
+      "width": 2774,
+      "height": 512,
+      "color": "#b06634",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/functions/Function",
+  "inputs": [],
+  "outputs": [
+    {
+      "id": "a068fd03-c1fa-49af-8d6f-1641333d2a9f",
+      "name": "fn",
+      "optional": false,
+      "group": null,
+      "socket_type": "function"
+    }
+  ],
+  "module_properties": {},
+  "style": {
+    "title_color": "#573a2e",
+    "node_color": "#392f2c",
+    "icon": "F0295",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/director-action-summary.json

@@ -0,0 +1,426 @@
+{
+  "title": "Director Action Summary",
+  "id": "f97a9e88-da71-4ec1-85ee-f933ebb7d977",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/directorActionSummary",
+  "nodes": {
+    "fcdccc00-2b00-46d0-9921-963a0e47936b": {
+      "title": "Argument",
+      "id": "fcdccc00-2b00-46d0-9921-963a0e47936b",
+      "properties": {
+        "name": "item",
+        "typ": "str"
+      },
+      "x": 26,
+      "y": -390,
+      "width": 210,
+      "height": 82,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Argument",
+      "base_type": "core/Node"
+    },
+    "44ffdacc-cb9c-4085-bddd-190838617b38": {
+      "title": "RSwitch Advanced",
+      "id": "44ffdacc-cb9c-4085-bddd-190838617b38",
+      "properties": {},
+      "x": 600,
+      "y": -237,
+      "width": 196,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitchAdvanced",
+      "base_type": "core/Node"
+    },
+    "210b2e70-f910-425c-bed9-f94d2edaf498": {
+      "title": "Coallesce",
+      "id": "210b2e70-f910-425c-bed9-f94d2edaf498",
+      "properties": {},
+      "x": 830,
+      "y": -237,
+      "width": 140,
+      "height": 86,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Coallesce",
+      "base_type": "core/Node"
+    },
+    "1f71a345-11d0-4487-ba2e-d470347dc15b": {
+      "title": "Format",
+      "id": "1f71a345-11d0-4487-ba2e-d470347dc15b",
+      "properties": {},
+      "x": 1010,
+      "y": -297,
+      "width": 140,
+      "height": 46,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/Format",
+      "base_type": "core/Node"
+    },
+    "7ee58b96-dbda-4f80-90ac-39555769c91d": {
+      "title": "Return",
+      "id": "7ee58b96-dbda-4f80-90ac-39555769c91d",
+      "properties": {},
+      "x": 1200,
+      "y": -277,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Return",
+      "base_type": "core/Node"
+    },
+    "ef874d5a-3c3d-4542-aa40-fd036fef1426": {
+      "title": "DEF action_log",
+      "id": "ef874d5a-3c3d-4542-aa40-fd036fef1426",
+      "properties": {
+        "name": "action_log"
+      },
+      "x": 1380,
+      "y": -287,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/DefineFunction",
+      "base_type": "core/Node"
+    },
+    "3c69ec94-7756-4147-aa77-b90c7e5fc0ff": {
+      "title": "Failure Message",
+      "id": "3c69ec94-7756-4147-aa77-b90c7e5fc0ff",
+      "properties": {
+        "value": "Action `{name}` FAILED: {error}"
+      },
+      "x": 280,
+      "y": -207,
+      "width": 210,
+      "height": 58,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/MakeText",
+      "base_type": "core/Node"
+    },
+    "744633b3-f82a-4884-b1f5-3f2b038e4b1a": {
+      "title": "Success Message",
+      "id": "744633b3-f82a-4884-b1f5-3f2b038e4b1a",
+      "properties": {
+        "value": "Action `{name}` SUCCESS: {result}"
+      },
+      "x": 275,
+      "y": -89,
+      "width": 210,
+      "height": 58,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/MakeText",
+      "base_type": "core/Node"
+    },
+    "5e4a297f-651b-4c7f-960f-c016aaaf9509": {
+      "title": "Dict Collector",
+      "id": "5e4a297f-651b-4c7f-960f-c016aaaf9509",
+      "properties": {},
+      "x": 606,
+      "y": -407,
+      "width": 140,
+      "height": 121,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/DictCollector",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        },
+        {
+          "name": "item2",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "c44db99b-f6c7-4960-9dab-bdc865032952": {
+      "title": "Unpack AI Function Call",
+      "id": "c44db99b-f6c7-4960-9dab-bdc865032952",
+      "properties": {},
+      "x": 266,
+      "y": -390,
+      "width": 230,
+      "height": 126,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "focal/UnpackCall",
+      "base_type": "core/Node"
+    },
+    "caba09ec-eaad-400f-939d-771df167d5bf": {
+      "title": "FN action_log",
+      "id": "caba09ec-eaad-400f-939d-771df167d5bf",
+      "properties": {
+        "name": "action_log"
+      },
+      "x": 286,
+      "y": 136,
+      "width": 210,
+      "height": 78,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/functions/GetFunction",
+      "base_type": "core/Node"
+    },
+    "66591f1f-41a3-4179-af88-7c0cd79b6076": {
+      "title": "true",
+      "id": "66591f1f-41a3-4179-af88-7c0cd79b6076",
+      "properties": {
+        "value": true
+      },
+      "x": 336,
+      "y": 76,
+      "width": 210,
+      "height": 58,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/MakeBool",
+      "base_type": "core/Node"
+    },
+    "0a364053-70ba-4e78-b493-7c75455d6533": {
+      "title": "Call For Each",
+      "id": "0a364053-70ba-4e78-b493-7c75455d6533",
+      "properties": {
+        "copy_items": false,
+        "argument_name": "item"
+      },
+      "x": 506,
+      "y": 116,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/CallForEach",
+      "base_type": "core/Node"
+    },
+    "10696192-ac8d-4c41-aa5e-8ddb4a343b88": {
+      "title": "OUT summary",
+      "id": "10696192-ac8d-4c41-aa5e-8ddb4a343b88",
+      "properties": {
+        "output_type": "str",
+        "output_name": "summary",
+        "num": 0
+      },
+      "x": 1287,
+      "y": 199,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "4e416484-fd48-49ad-ae43-def93ff8b110": {
+      "title": "Join",
+      "id": "4e416484-fd48-49ad-ae43-def93ff8b110",
+      "properties": {
+        "delimiter": " \\n"
+      },
+      "x": 806,
+      "y": 126,
+      "width": 210,
+      "height": 78,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/Join",
+      "base_type": "core/Node"
+    },
+    "6ed10692-eacf-49a9-8dc5-bef6cb54502f": {
+      "title": "RSwitch Advanced",
+      "id": "6ed10692-eacf-49a9-8dc5-bef6cb54502f",
+      "properties": {},
+      "x": 287,
+      "y": 249,
+      "width": 182,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitchAdvanced",
+      "base_type": "core/Node"
+    },
+    "997db282-2906-4796-bd98-56380a87e160": {
+      "title": "IN calls",
+      "id": "997db282-2906-4796-bd98-56380a87e160",
+      "properties": {
+        "input_type": "list",
+        "input_name": "calls",
+        "input_optional": false,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 27,
+      "y": 109,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "f4052651-2d29-4e43-8303-0d8387cdfe7a": {
+      "title": "Advanced Format",
+      "id": "f4052651-2d29-4e43-8303-0d8387cdfe7a",
+      "properties": {
+        "template": "No action's were taken."
+      },
+      "x": 37,
+      "y": 389,
+      "width": 210,
+      "height": 113,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "9a20c20e-4eb6-4c9d-9a3d-8ef2d69385f3": {
+      "title": "Coallesce",
+      "id": "9a20c20e-4eb6-4c9d-9a3d-8ef2d69385f3",
+      "properties": {},
+      "x": 1087,
+      "y": 239,
+      "width": 140,
+      "height": 86,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Coallesce",
+      "base_type": "core/Node"
+    },
+    "cfa63481-a7f1-4386-8115-c2347aa6101b": {
+      "title": "Module Style",
+      "id": "cfa63481-a7f1-4386-8115-c2347aa6101b",
+      "properties": {
+        "node_color": "#27233a",
+        "title_color": "#3d315b",
+        "auto_title": null,
+        "icon": "F09DE"
+      },
+      "x": 1400,
+      "y": -630,
+      "width": 210,
+      "height": 110,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/ModuleStyle",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "fcdccc00-2b00-46d0-9921-963a0e47936b.value": [
+      "c44db99b-f6c7-4960-9dab-bdc865032952.call"
+    ],
+    "44ffdacc-cb9c-4085-bddd-190838617b38.yes": [
+      "210b2e70-f910-425c-bed9-f94d2edaf498.a"
+    ],
+    "44ffdacc-cb9c-4085-bddd-190838617b38.no": [
+      "210b2e70-f910-425c-bed9-f94d2edaf498.b"
+    ],
+    "210b2e70-f910-425c-bed9-f94d2edaf498.value": [
+      "1f71a345-11d0-4487-ba2e-d470347dc15b.template"
+    ],
+    "1f71a345-11d0-4487-ba2e-d470347dc15b.result": [
+      "7ee58b96-dbda-4f80-90ac-39555769c91d.value"
+    ],
+    "7ee58b96-dbda-4f80-90ac-39555769c91d.value": [
+      "ef874d5a-3c3d-4542-aa40-fd036fef1426.nodes"
+    ],
+    "3c69ec94-7756-4147-aa77-b90c7e5fc0ff.value": [
+      "44ffdacc-cb9c-4085-bddd-190838617b38.yes"
+    ],
+    "744633b3-f82a-4884-b1f5-3f2b038e4b1a.value": [
+      "44ffdacc-cb9c-4085-bddd-190838617b38.no"
+    ],
+    "5e4a297f-651b-4c7f-960f-c016aaaf9509.dict": [
+      "1f71a345-11d0-4487-ba2e-d470347dc15b.variables"
+    ],
+    "c44db99b-f6c7-4960-9dab-bdc865032952.name": [
+      "5e4a297f-651b-4c7f-960f-c016aaaf9509.item0"
+    ],
+    "c44db99b-f6c7-4960-9dab-bdc865032952.result": [
+      "5e4a297f-651b-4c7f-960f-c016aaaf9509.item1"
+    ],
+    "c44db99b-f6c7-4960-9dab-bdc865032952.error": [
+      "44ffdacc-cb9c-4085-bddd-190838617b38.check",
+      "5e4a297f-651b-4c7f-960f-c016aaaf9509.item2"
+    ],
+    "caba09ec-eaad-400f-939d-771df167d5bf.fn": [
+      "0a364053-70ba-4e78-b493-7c75455d6533.fn"
+    ],
+    "66591f1f-41a3-4179-af88-7c0cd79b6076.value": [
+      "0a364053-70ba-4e78-b493-7c75455d6533.state"
+    ],
+    "0a364053-70ba-4e78-b493-7c75455d6533.results": [
+      "4e416484-fd48-49ad-ae43-def93ff8b110.strings"
+    ],
+    "4e416484-fd48-49ad-ae43-def93ff8b110.result": [
+      "9a20c20e-4eb6-4c9d-9a3d-8ef2d69385f3.a"
+    ],
+    "6ed10692-eacf-49a9-8dc5-bef6cb54502f.yes": [
+      "0a364053-70ba-4e78-b493-7c75455d6533.items"
+    ],
+    "6ed10692-eacf-49a9-8dc5-bef6cb54502f.no": [
+      "9a20c20e-4eb6-4c9d-9a3d-8ef2d69385f3.b"
+    ],
+    "997db282-2906-4796-bd98-56380a87e160.value": [
+      "6ed10692-eacf-49a9-8dc5-bef6cb54502f.check",
+      "6ed10692-eacf-49a9-8dc5-bef6cb54502f.yes"
+    ],
+    "f4052651-2d29-4e43-8303-0d8387cdfe7a.result": [
+      "6ed10692-eacf-49a9-8dc5-bef6cb54502f.no"
+    ],
+    "9a20c20e-4eb6-4c9d-9a3d-8ef2d69385f3.value": [
+      "10696192-ac8d-4c41-aa5e-8ddb4a343b88.value"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Group",
+      "x": 2,
+      "y": -482,
+      "width": 1614,
+      "height": 476,
+      "color": "#b06634",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Main",
+      "x": 1,
+      "y": -4,
+      "width": 1609,
+      "height": 563,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/Graph",
+  "inputs": [],
+  "outputs": [],
+  "module_properties": {},
+  "style": {
+    "title_color": "#3d315b",
+    "node_color": "#27233a",
+    "icon": "F09DE",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/director-action-update-gamestate.json

@@ -0,0 +1,258 @@
+{
+  "title": "Director Action Update Gamestate",
+  "id": "59a62e49-cd1f-4ce8-80db-ed1a24501ba5",
+  "properties": {
+    "name": "update_gamestate",
+    "description": "Instruct another agent to make updates to any game state variables. You should query for relevant game state variables BEFORE using this.\n\nIf you're changing existing game states provide the FULL path to the final key.\n\nIMPORTANT: Not all stories / experiences are games. Only use this if explicitly confirmed by the user or if the current scene type allows it.",
+    "instructions": "Make updates to the game state variables.",
+    "example_json": "[\n  {\n    \"instructions\": \"Set up base attributes of health and stamina for all characters. Lets do this keyed to the character name and for all current characters: \\\"Mary\\\" and \\\"John\\\". Defaults should should like `{ \\\"health\\\": 100, \\\"stamina\\\": 100 }`\"\n  },\n  {\n    \"instructions\": \"Set John's health to 50%\",\n  },\n  {\n    \"instructions\": \"We need tomaintain a numeric representation of Mary's mana. Lets add a new variable called 'mana' to the game state for her character.\"\n  }\n]"
+  },
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/directorActionUpdateGamestate",
+  "nodes": {
+    "25b43bed-e4bf-45c0-87c7-72c5785c1d62": {
+      "title": "Validate Value Is Set",
+      "id": "25b43bed-e4bf-45c0-87c7-72c5785c1d62",
+      "properties": {
+        "error_message": "`instructions` is a required argument.",
+        "blank_string_is_unset": true
+      },
+      "x": 286,
+      "y": -161,
+      "width": 210,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueIsSet",
+      "base_type": "core/Node"
+    },
+    "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3": {
+      "title": "SET local.instructions",
+      "id": "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 556,
+      "y": -151,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f": {
+      "title": "Stage 0",
+      "id": "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f",
+      "properties": {
+        "stage": 0
+      },
+      "x": 806,
+      "y": -151,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "fa4a84ad-a696-4ede-9471-fbef8c1c98ee": {
+      "title": "GET local.instructions",
+      "id": "fa4a84ad-a696-4ede-9471-fbef8c1c98ee",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 26,
+      "y": 121,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac": {
+      "title": "Instructions",
+      "id": "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac",
+      "properties": {
+        "template": "Use codeblocks containing data structures to propose sequential updates to the existing gamestate structure to fulfill the following task.\n\nTASK: {instructions}\n\nBegin by planning your actions, then provide the necessary code blocks."
+      },
+      "x": 286,
+      "y": 121,
+      "width": 210,
+      "height": 133,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "643e7707-9689-41c2-9053-b6370c7e5c14": {
+      "title": "Instruct Gamestate Updates",
+      "id": "643e7707-9689-41c2-9053-b6370c7e5c14",
+      "properties": {},
+      "x": 566,
+      "y": 141,
+      "width": 218,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agernts/director/chat/instructGamestateUpdates",
+      "base_type": "core/Graph"
+    },
+    "516270c5-e694-44d7-9ac2-960461ee92b2": {
+      "title": "Return",
+      "id": "516270c5-e694-44d7-9ac2-960461ee92b2",
+      "properties": {},
+      "x": 1249,
+      "y": 148,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Return",
+      "base_type": "core/Node"
+    },
+    "64136cbd-4b3b-4586-9122-4fae36374af8": {
+      "title": "Advanced Format",
+      "id": "64136cbd-4b3b-4586-9122-4fae36374af8",
+      "properties": {
+        "template": "Applied the following gamestate updates:\n\n```\n{updates}\n```"
+      },
+      "x": 926,
+      "y": 151,
+      "width": 210,
+      "height": 153,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "0404af9c-3a1e-4535-b8bc-5e8257f95d20": {
+      "title": "true",
+      "id": "0404af9c-3a1e-4535-b8bc-5e8257f95d20",
+      "properties": {
+        "value": true
+      },
+      "x": 406,
+      "y": 81,
+      "width": 210,
+      "height": 58,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/MakeBool",
+      "base_type": "core/Node"
+    },
+    "90bd1c80-9a8e-404c-a32f-f17c314ddb65": {
+      "title": "instructions",
+      "id": "90bd1c80-9a8e-404c-a32f-f17c314ddb65",
+      "properties": {
+        "name": "instructions",
+        "typ": "str",
+        "instructions": "Your precise instructions on what changes to make to the game state JSON object literal. You can add / update / remove keys. Keys need to be specified as absolute paths inside the structure."
+      },
+      "x": 26,
+      "y": -171,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/chat/ActionArgument",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "25b43bed-e4bf-45c0-87c7-72c5785c1d62.value": [
+      "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3.value"
+    ],
+    "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3.value": [
+      "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f.state"
+    ],
+    "fa4a84ad-a696-4ede-9471-fbef8c1c98ee.value": [
+      "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac.item0"
+    ],
+    "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac.result": [
+      "643e7707-9689-41c2-9053-b6370c7e5c14.instructions"
+    ],
+    "643e7707-9689-41c2-9053-b6370c7e5c14.state": [
+      "64136cbd-4b3b-4586-9122-4fae36374af8.item0"
+    ],
+    "643e7707-9689-41c2-9053-b6370c7e5c14.updates": [
+      "64136cbd-4b3b-4586-9122-4fae36374af8.item1"
+    ],
+    "64136cbd-4b3b-4586-9122-4fae36374af8.result": [
+      "516270c5-e694-44d7-9ac2-960461ee92b2.value"
+    ],
+    "0404af9c-3a1e-4535-b8bc-5e8257f95d20.value": [
+      "643e7707-9689-41c2-9053-b6370c7e5c14.state"
+    ],
+    "90bd1c80-9a8e-404c-a32f-f17c314ddb65.value": [
+      "25b43bed-e4bf-45c0-87c7-72c5785c1d62.value"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Validation",
+      "x": 1,
+      "y": -246,
+      "width": 1050,
+      "height": 242,
+      "color": "#b58b2a",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Process",
+      "x": 1,
+      "y": 0,
+      "width": 1413,
+      "height": 328,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "agents/director/DirectorChatAction",
+  "inputs": [],
+  "outputs": [
+    {
+      "id": "00213835-5a0f-4aab-ab0a-af83646336f8",
+      "name": "fn",
+      "optional": false,
+      "group": null,
+      "socket_type": "function"
+    }
+  ],
+  "module_properties": {},
+  "style": {
+    "title_color": "#573a2e",
+    "node_color": "#392f2c",
+    "icon": "F0295",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/director-agent-retrieve-context.json

@@ -0,0 +1,250 @@
+{
+  "title": "Director Agent Retrieve Context",
+  "id": "0f3aa8ec-122d-4e56-bdd0-363da9fcfc05",
+  "properties": {
+    "name": "retrieve_context",
+    "description": "Instruct another agent to retrieve the complete content of a specific source context ID for you. \n\nOnly use this if you have obtained such context ids. They are always formatted like this: `{context_type}:{context_id}`\n\nIMPORTANT: THIS ALWAYS REQUIRES YOU TO PASS AT LEAST ONE KNOWN, EXISTING CONTEXT ID. IF YOU DO NOT HAVE ONE DO NOT USE THIS ACTION.",
+    "instructions": "Use an exact source context ID to retrieve the content of the source.\n\nSource context IDs are always formatted like this:  `{context_type}:{context_id}`",
+    "example_json": "[\n  {\n    \"context_id\": \"context_type:context_id\"\n  }\n]"
+  },
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/directorAgentRetrieveContext",
+  "nodes": {
+    "f99df00a-da22-4efa-8ebc-acd6e590fc64": {
+      "title": "Validate Value Is Set",
+      "id": "f99df00a-da22-4efa-8ebc-acd6e590fc64",
+      "properties": {
+        "error_message": "`context_id` is required",
+        "blank_string_is_unset": true
+      },
+      "x": 283,
+      "y": 28,
+      "width": 210,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueIsSet",
+      "base_type": "core/Node"
+    },
+    "92803a25-b624-4289-a6ef-87dcd0fc447d": {
+      "title": "Validate Context ID Item",
+      "id": "92803a25-b624-4289-a6ef-87dcd0fc447d",
+      "properties": {
+        "error_message": ""
+      },
+      "x": 528,
+      "y": 42,
+      "width": 245,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateContextIDItem",
+      "base_type": "core/Node"
+    },
+    "9ee58437-7ccb-4b40-ac61-9a2434e85223": {
+      "title": "GET local.context_id_item",
+      "id": "9ee58437-7ccb-4b40-ac61-9a2434e85223",
+      "properties": {
+        "name": "context_id_item",
+        "scope": "local"
+      },
+      "x": 33,
+      "y": 292,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "f94ca43f-5d0d-4edf-85ef-93010ae67732": {
+      "title": "Context ID Get Value",
+      "id": "f94ca43f-5d0d-4edf-85ef-93010ae67732",
+      "properties": {},
+      "x": 270,
+      "y": 360,
+      "width": 262,
+      "height": 46,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "context_id/ContextIDGetValue",
+      "base_type": "core/Node"
+    },
+    "9934d9c8-55a1-4ffb-ac7a-79a1bfaee5aa": {
+      "title": "Watch",
+      "id": "9934d9c8-55a1-4ffb-ac7a-79a1bfaee5aa",
+      "properties": {},
+      "x": 860,
+      "y": 390,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Watch",
+      "base_type": "core/Node"
+    },
+    "51fc6efe-df09-4e32-9066-ba9163f8a555": {
+      "title": "Return",
+      "id": "51fc6efe-df09-4e32-9066-ba9163f8a555",
+      "properties": {},
+      "x": 1050,
+      "y": 390,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/functions/Return",
+      "base_type": "core/Node"
+    },
+    "c3e1908f-3f66-4ac3-8619-409107dfe04e": {
+      "title": "Advanced Format",
+      "id": "c3e1908f-3f66-4ac3-8619-409107dfe04e",
+      "properties": {
+        "template": "### {context_id_item.human_id}\nContext ID: `{context_id_item.context_id}`\n\n```\n{value}\n```"
+      },
+      "x": 580,
+      "y": 371,
+      "width": 210,
+      "height": 153,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "fa60dcd2-97df-474c-8e78-fd0ded483ee7": {
+      "title": "SET local.context_id_item",
+      "id": "fa60dcd2-97df-474c-8e78-fd0ded483ee7",
+      "properties": {
+        "name": "context_id_item",
+        "scope": "local"
+      },
+      "x": 811,
+      "y": 46,
+      "width": 227,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "59c92079-d971-486b-b53a-0c80194eec50": {
+      "title": "Stage",
+      "id": "59c92079-d971-486b-b53a-0c80194eec50",
+      "properties": {
+        "stage": 0
+      },
+      "x": 1071,
+      "y": 66,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "15f2e707-fe7f-4c68-8227-97af24641a32": {
+      "title": "Director Action Argument",
+      "id": "15f2e707-fe7f-4c68-8227-97af24641a32",
+      "properties": {
+        "name": "context_id",
+        "typ": "str",
+        "instructions": "The exact source context ID.\n\nSource context IDs are always formatted like this:  `{context_type}:{context_id}`"
+      },
+      "x": 33,
+      "y": 18,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/chat/ActionArgument",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "f99df00a-da22-4efa-8ebc-acd6e590fc64.value": [
+      "92803a25-b624-4289-a6ef-87dcd0fc447d.value"
+    ],
+    "92803a25-b624-4289-a6ef-87dcd0fc447d.context_id_item": [
+      "fa60dcd2-97df-474c-8e78-fd0ded483ee7.value"
+    ],
+    "9ee58437-7ccb-4b40-ac61-9a2434e85223.value": [
+      "f94ca43f-5d0d-4edf-85ef-93010ae67732.context_id_item"
+    ],
+    "f94ca43f-5d0d-4edf-85ef-93010ae67732.context_id_item": [
+      "c3e1908f-3f66-4ac3-8619-409107dfe04e.item0"
+    ],
+    "f94ca43f-5d0d-4edf-85ef-93010ae67732.value": [
+      "c3e1908f-3f66-4ac3-8619-409107dfe04e.item1"
+    ],
+    "9934d9c8-55a1-4ffb-ac7a-79a1bfaee5aa.value": [
+      "51fc6efe-df09-4e32-9066-ba9163f8a555.value"
+    ],
+    "c3e1908f-3f66-4ac3-8619-409107dfe04e.result": [
+      "9934d9c8-55a1-4ffb-ac7a-79a1bfaee5aa.value"
+    ],
+    "fa60dcd2-97df-474c-8e78-fd0ded483ee7.value": [
+      "59c92079-d971-486b-b53a-0c80194eec50.state_b"
+    ],
+    "15f2e707-fe7f-4c68-8227-97af24641a32.value": [
+      "f99df00a-da22-4efa-8ebc-acd6e590fc64.value"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Input Validation",
+      "x": 8,
+      "y": -62,
+      "width": 1298,
+      "height": 271,
+      "color": "#b58b2a",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Return source",
+      "x": 8,
+      "y": 212,
+      "width": 1288,
+      "height": 459,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "agents/director/DirectorChatAction",
+  "inputs": [],
+  "outputs": [
+    {
+      "id": "1e38e35a-3e56-460c-b6bf-63efc5078f77",
+      "name": "fn",
+      "optional": false,
+      "group": null,
+      "socket_type": "function"
+    }
+  ],
+  "module_properties": {},
+  "style": {
+    "title_color": "#573a2e",
+    "node_color": "#392f2c",
+    "icon": "F0295",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/instruct-character-creation.json

@@ -0,0 +1,782 @@
+{
+  "title": "Instruct Character Creation",
+  "id": "324867c5-5e9a-47cb-a797-27236021f744",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/instructCharacterCreation",
+  "nodes": {
+    "fe95c78d-2a24-4c84-8509-a6024443f2a3": {
+      "title": "Persist Character",
+      "id": "fe95c78d-2a24-4c84-8509-a6024443f2a3",
+      "properties": {
+        "determine_name": true
+      },
+      "x": 322,
+      "y": 70,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/PersistCharacter",
+      "base_type": "core/Node"
+    },
+    "dd7a7e8d-445e-4ba4-8395-2433dc479701": {
+      "title": "RSwitch",
+      "id": "dd7a7e8d-445e-4ba4-8395-2433dc479701",
+      "properties": {},
+      "x": 545,
+      "y": 393,
+      "width": 140,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitch",
+      "base_type": "core/Node"
+    },
+    "30e158e5-504a-4604-863e-ee073945e54b": {
+      "title": "Deactivate Character",
+      "id": "30e158e5-504a-4604-863e-ee073945e54b",
+      "properties": {},
+      "x": 735,
+      "y": 433,
+      "width": 168,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "scene/DeactivateCharacter",
+      "base_type": "core/Node"
+    },
+    "b8ef5821-b2af-4ed0-916e-51f43fccba54": {
+      "title": "Input Socket",
+      "id": "b8ef5821-b2af-4ed0-916e-51f43fccba54",
+      "properties": {
+        "input_type": "any",
+        "input_name": "state",
+        "input_optional": false,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 7,
+      "y": -1007,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "3b0e09ba-a3eb-488b-b8a5-532bfc14e2e2": {
+      "title": "active",
+      "id": "3b0e09ba-a3eb-488b-b8a5-532bfc14e2e2",
+      "properties": {},
+      "x": 363,
+      "y": 306,
+      "width": 140,
+      "height": 26,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Watch",
+      "base_type": "core/Node"
+    },
+    "29f83307-c9b9-48c7-bf74-b04dba05397f": {
+      "title": "AND Router",
+      "id": "29f83307-c9b9-48c7-bf74-b04dba05397f",
+      "properties": {},
+      "x": 531,
+      "y": 604,
+      "width": 140,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/ANDRouter",
+      "base_type": "core/Node"
+    },
+    "90a2763a-32c3-4aa9-9c88-d803a4e4329b": {
+      "title": "IN active",
+      "id": "90a2763a-32c3-4aa9-9c88-d803a4e4329b",
+      "properties": {
+        "input_type": "bool",
+        "input_name": "active",
+        "input_optional": false,
+        "input_group": "",
+        "num": 2
+      },
+      "x": 5,
+      "y": -540,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "302909ac-3c34-4690-a69d-dcee2bba6905": {
+      "title": "IN narrate_instructions",
+      "id": "302909ac-3c34-4690-a69d-dcee2bba6905",
+      "properties": {
+        "input_type": "str",
+        "input_name": "narrate_instructions",
+        "input_optional": false,
+        "input_group": "",
+        "num": 3
+      },
+      "x": 9,
+      "y": -292,
+      "width": 265,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "7eee8c68-8f78-499a-898d-2728429a0e01": {
+      "title": "GET local.narrate_instructions",
+      "id": "7eee8c68-8f78-499a-898d-2728429a0e01",
+      "properties": {
+        "name": "narrate_instructions",
+        "scope": "local"
+      },
+      "x": 8,
+      "y": 613,
+      "width": 252,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "05e031c6-e9e4-414e-bbcd-aa338bae1d3e": {
+      "title": "GET local.active",
+      "id": "05e031c6-e9e4-414e-bbcd-aa338bae1d3e",
+      "properties": {
+        "name": "active",
+        "scope": "local"
+      },
+      "x": 18,
+      "y": 333,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "146b4f6d-248a-421a-85bd-5c3f86de67aa": {
+      "title": "Generate Character Entry Narration",
+      "id": "146b4f6d-248a-421a-85bd-5c3f86de67aa",
+      "properties": {},
+      "x": 784,
+      "y": 872,
+      "width": 286,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/narrator/GenerateCharacterEntryNarration",
+      "base_type": "core/Node"
+    },
+    "fe3b68bd-6853-439d-882b-770db12b6ccd": {
+      "title": "Push History",
+      "id": "fe3b68bd-6853-439d-882b-770db12b6ccd",
+      "properties": {
+        "emit_message": true
+      },
+      "x": 1194,
+      "y": 882,
+      "width": 210,
+      "height": 58,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "scene/history/Push",
+      "base_type": "core/Node"
+    },
+    "1a89e3bb-bc71-46b1-8c3a-1072c07f820d": {
+      "title": "SET local.character",
+      "id": "1a89e3bb-bc71-46b1-8c3a-1072c07f820d",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 568,
+      "y": 70,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "440d5bef-4023-4897-a1a1-149c5af3dbd3": {
+      "title": "Stage 2",
+      "id": "440d5bef-4023-4897-a1a1-149c5af3dbd3",
+      "properties": {
+        "stage": 2
+      },
+      "x": 1484,
+      "y": 492,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "53da2fa3-4375-4d04-88d6-0f54b0a0d9ef": {
+      "title": "true",
+      "id": "53da2fa3-4375-4d04-88d6-0f54b0a0d9ef",
+      "properties": {
+        "value": true
+      },
+      "x": 168,
+      "y": -20,
+      "width": 210,
+      "height": 58,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/MakeBool",
+      "base_type": "core/Node"
+    },
+    "7909b9ac-e61e-4b4b-844f-782ec9de05fd": {
+      "title": "GET local.character",
+      "id": "7909b9ac-e61e-4b4b-844f-782ec9de05fd",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 26,
+      "y": 869,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "0cf22c95-ef4b-4199-b5ef-d364acb36050": {
+      "title": "Output Socket",
+      "id": "0cf22c95-ef4b-4199-b5ef-d364acb36050",
+      "properties": {
+        "output_type": "character",
+        "output_name": "character",
+        "num": 4
+      },
+      "x": 1166,
+      "y": 1143,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "307ef2f9-2ddc-4dbb-a916-f3eefc0239db": {
+      "title": "GET local.character",
+      "id": "307ef2f9-2ddc-4dbb-a916-f3eefc0239db",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 4,
+      "y": 1126,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "cd3043d0-a852-4a1f-b22c-2defc600a50a": {
+      "title": "Output Socket",
+      "id": "cd3043d0-a852-4a1f-b22c-2defc600a50a",
+      "properties": {
+        "output_type": "str",
+        "output_name": "summary",
+        "num": 5
+      },
+      "x": 1183,
+      "y": 1353,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "56b7196a-1f22-4882-b8ae-f987936ff056": {
+      "title": "Get Character Description",
+      "id": "56b7196a-1f22-4882-b8ae-f987936ff056",
+      "properties": {},
+      "x": 293,
+      "y": 1293,
+      "width": 210,
+      "height": 46,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "scene/GetCharacterDescription",
+      "base_type": "core/Node"
+    },
+    "ab198058-35a6-4796-b713-4f3678561cb5": {
+      "title": "Excerpt",
+      "id": "ab198058-35a6-4796-b713-4f3678561cb5",
+      "properties": {
+        "length": 256,
+        "add_ellipsis": true
+      },
+      "x": 544,
+      "y": 1419,
+      "width": 210,
+      "height": 82,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/Excerpt",
+      "base_type": "core/Node"
+    },
+    "db3dbe65-087d-45f3-841e-28bc2928a4ff": {
+      "title": "Advanced Format",
+      "id": "db3dbe65-087d-45f3-841e-28bc2928a4ff",
+      "properties": {
+        "template": "Character Created: `{character.name}`\nDescription: \n\n```\n{result}\n```"
+      },
+      "x": 844,
+      "y": 1339,
+      "width": 210,
+      "height": 153,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "ea0d219e-b34b-4485-87a2-945fc513b314": {
+      "title": "OUT state",
+      "id": "ea0d219e-b34b-4485-87a2-945fc513b314",
+      "properties": {
+        "output_type": "any",
+        "output_name": "state",
+        "num": 0
+      },
+      "x": 1872,
+      "y": -1004,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "0edfb297-c55b-48eb-b261-2e3fac66430b": {
+      "title": "IN instructions",
+      "id": "0edfb297-c55b-48eb-b261-2e3fac66430b",
+      "properties": {
+        "input_type": "str",
+        "input_name": "instructions",
+        "input_optional": false,
+        "input_group": "",
+        "num": 1
+      },
+      "x": 10,
+      "y": -763,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "b1b25e45-5dac-4b14-9494-6c0fe640926b": {
+      "title": "Validate Value Is Set",
+      "id": "b1b25e45-5dac-4b14-9494-6c0fe640926b",
+      "properties": {
+        "error_message": "instructions are required.",
+        "blank_string_is_unset": true
+      },
+      "x": 311,
+      "y": -895,
+      "width": 216,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueIsSet",
+      "base_type": "core/Node"
+    },
+    "555836b5-fc4b-4d30-a408-dfe3ed6dacb4": {
+      "title": "OUT narrate_instructions",
+      "id": "555836b5-fc4b-4d30-a408-dfe3ed6dacb4",
+      "properties": {
+        "output_type": "str",
+        "output_name": "narrate_instructions",
+        "num": 3
+      },
+      "x": 1861,
+      "y": -235,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "cb1f6271-309c-4d44-ba3a-052353626752": {
+      "title": "OUT active",
+      "id": "cb1f6271-309c-4d44-ba3a-052353626752",
+      "properties": {
+        "output_type": "bool",
+        "output_name": "active",
+        "num": 2
+      },
+      "x": 1871,
+      "y": -505,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "60b047db-3570-42f8-9c5a-36dfc1f4424f": {
+      "title": "OUT instructions",
+      "id": "60b047db-3570-42f8-9c5a-36dfc1f4424f",
+      "properties": {
+        "output_type": "str",
+        "output_name": "instructions",
+        "num": 1
+      },
+      "x": 1871,
+      "y": -745,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "55177ca7-4999-466e-8544-82da9a8af7da": {
+      "title": "Stage -1",
+      "id": "55177ca7-4999-466e-8544-82da9a8af7da",
+      "properties": {
+        "stage": -1
+      },
+      "x": 1531,
+      "y": -525,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "bc919dfb-39c9-4eab-a452-fdb49f66e4c8": {
+      "title": "SET local.instructions",
+      "id": "bc919dfb-39c9-4eab-a452-fdb49f66e4c8",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 601,
+      "y": -905,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "8aa0d95f-300b-4b73-9529-bd708512fd8f": {
+      "title": "SET local.instructions",
+      "id": "8aa0d95f-300b-4b73-9529-bd708512fd8f",
+      "properties": {
+        "name": "active",
+        "scope": "local"
+      },
+      "x": 461,
+      "y": -545,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "fe99b452-e260-4dc8-a8eb-6d6de1cb8d0d": {
+      "title": "SET local.instructions",
+      "id": "fe99b452-e260-4dc8-a8eb-6d6de1cb8d0d",
+      "properties": {
+        "name": "narrate_instructions",
+        "scope": "local"
+      },
+      "x": 461,
+      "y": -275,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "b456bbbb-47b2-4a51-b8d9-210f919337a4": {
+      "title": "Jinja2 Format",
+      "id": "b456bbbb-47b2-4a51-b8d9-210f919337a4",
+      "properties": {
+        "template": "### Create new character\n\n#### Creation instructions\n```\n{{ instructions }}\n```\n\n{% if narrate_instructions %}\n#### Narrate character entry\n```\n{{ narrate_instructions }}\n```\n{% endif %}\n\n**Active in scene**: {{ active }}"
+      },
+      "x": 871,
+      "y": -725,
+      "width": 210,
+      "height": 173,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "prompt/Jinja2Format",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        },
+        {
+          "name": "item2",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "c049bcad-7006-47f5-bc10-1aa191571bd8": {
+      "title": "GET local.instructions",
+      "id": "c049bcad-7006-47f5-bc10-1aa191571bd8",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 4,
+      "y": 61,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "b0e1848b-f6f6-42fa-97c8-f0e8b87b8b4c": {
+      "title": "Stage 1",
+      "id": "b0e1848b-f6f6-42fa-97c8-f0e8b87b8b4c",
+      "properties": {
+        "stage": 1
+      },
+      "x": 896,
+      "y": 79,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "28125cd1-a285-430a-9582-e145ec6cecd0": {
+      "title": "Module Style",
+      "id": "28125cd1-a285-430a-9582-e145ec6cecd0",
+      "properties": {
+        "node_color": "#392c34",
+        "title_color": "#572e44",
+        "auto_title": null,
+        "icon": "F1719"
+      },
+      "x": 2141,
+      "y": -1005,
+      "width": 210,
+      "height": 110,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/ModuleStyle",
+      "base_type": "core/Node"
+    },
+    "e4851859-59f4-4004-8e5c-4cdc4fb3064d": {
+      "title": "Director Action Confirm",
+      "id": "e4851859-59f4-4004-8e5c-4cdc4fb3064d",
+      "properties": {
+        "name": "create_character",
+        "description": "",
+        "raise_on_reject": true
+      },
+      "x": 1161,
+      "y": -885,
+      "width": 237,
+      "height": 146,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/chat/ActionConfirm",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "fe95c78d-2a24-4c84-8509-a6024443f2a3.character": [
+      "1a89e3bb-bc71-46b1-8c3a-1072c07f820d.value"
+    ],
+    "dd7a7e8d-445e-4ba4-8395-2433dc479701.value": [
+      "30e158e5-504a-4604-863e-ee073945e54b.character"
+    ],
+    "30e158e5-504a-4604-863e-ee073945e54b.character": [
+      "440d5bef-4023-4897-a1a1-149c5af3dbd3.state"
+    ],
+    "b8ef5821-b2af-4ed0-916e-51f43fccba54.value": [
+      "ea0d219e-b34b-4485-87a2-945fc513b314.value"
+    ],
+    "3b0e09ba-a3eb-488b-b8a5-532bfc14e2e2.value": [
+      "dd7a7e8d-445e-4ba4-8395-2433dc479701.check"
+    ],
+    "29f83307-c9b9-48c7-bf74-b04dba05397f.yes": [
+      "146b4f6d-248a-421a-85bd-5c3f86de67aa.state"
+    ],
+    "90a2763a-32c3-4aa9-9c88-d803a4e4329b.value": [
+      "8aa0d95f-300b-4b73-9529-bd708512fd8f.value"
+    ],
+    "302909ac-3c34-4690-a69d-dcee2bba6905.value": [
+      "fe99b452-e260-4dc8-a8eb-6d6de1cb8d0d.value"
+    ],
+    "7eee8c68-8f78-499a-898d-2728429a0e01.value": [
+      "29f83307-c9b9-48c7-bf74-b04dba05397f.b",
+      "146b4f6d-248a-421a-85bd-5c3f86de67aa.narrative_direction"
+    ],
+    "05e031c6-e9e4-414e-bbcd-aa338bae1d3e.value": [
+      "3b0e09ba-a3eb-488b-b8a5-532bfc14e2e2.value",
+      "29f83307-c9b9-48c7-bf74-b04dba05397f.a"
+    ],
+    "146b4f6d-248a-421a-85bd-5c3f86de67aa.message": [
+      "fe3b68bd-6853-439d-882b-770db12b6ccd.message"
+    ],
+    "fe3b68bd-6853-439d-882b-770db12b6ccd.message": [
+      "440d5bef-4023-4897-a1a1-149c5af3dbd3.state_b"
+    ],
+    "1a89e3bb-bc71-46b1-8c3a-1072c07f820d.value": [
+      "b0e1848b-f6f6-42fa-97c8-f0e8b87b8b4c.state"
+    ],
+    "53da2fa3-4375-4d04-88d6-0f54b0a0d9ef.value": [
+      "fe95c78d-2a24-4c84-8509-a6024443f2a3.state"
+    ],
+    "7909b9ac-e61e-4b4b-844f-782ec9de05fd.value": [
+      "dd7a7e8d-445e-4ba4-8395-2433dc479701.no",
+      "146b4f6d-248a-421a-85bd-5c3f86de67aa.character"
+    ],
+    "307ef2f9-2ddc-4dbb-a916-f3eefc0239db.value": [
+      "0cf22c95-ef4b-4199-b5ef-d364acb36050.value",
+      "56b7196a-1f22-4882-b8ae-f987936ff056.character"
+    ],
+    "56b7196a-1f22-4882-b8ae-f987936ff056.character": [
+      "db3dbe65-087d-45f3-841e-28bc2928a4ff.item0"
+    ],
+    "56b7196a-1f22-4882-b8ae-f987936ff056.description": [
+      "ab198058-35a6-4796-b713-4f3678561cb5.string"
+    ],
+    "ab198058-35a6-4796-b713-4f3678561cb5.result": [
+      "db3dbe65-087d-45f3-841e-28bc2928a4ff.item1"
+    ],
+    "db3dbe65-087d-45f3-841e-28bc2928a4ff.result": [
+      "cd3043d0-a852-4a1f-b22c-2defc600a50a.value"
+    ],
+    "0edfb297-c55b-48eb-b261-2e3fac66430b.value": [
+      "b1b25e45-5dac-4b14-9494-6c0fe640926b.value"
+    ],
+    "b1b25e45-5dac-4b14-9494-6c0fe640926b.value": [
+      "bc919dfb-39c9-4eab-a452-fdb49f66e4c8.value"
+    ],
+    "55177ca7-4999-466e-8544-82da9a8af7da.state": [
+      "60b047db-3570-42f8-9c5a-36dfc1f4424f.value"
+    ],
+    "55177ca7-4999-466e-8544-82da9a8af7da.state_b": [
+      "cb1f6271-309c-4d44-ba3a-052353626752.value"
+    ],
+    "55177ca7-4999-466e-8544-82da9a8af7da.state_c": [
+      "555836b5-fc4b-4d30-a408-dfe3ed6dacb4.value"
+    ],
+    "bc919dfb-39c9-4eab-a452-fdb49f66e4c8.value": [
+      "e4851859-59f4-4004-8e5c-4cdc4fb3064d.state",
+      "b456bbbb-47b2-4a51-b8d9-210f919337a4.item0"
+    ],
+    "8aa0d95f-300b-4b73-9529-bd708512fd8f.value": [
+      "55177ca7-4999-466e-8544-82da9a8af7da.state_b",
+      "b456bbbb-47b2-4a51-b8d9-210f919337a4.item1"
+    ],
+    "fe99b452-e260-4dc8-a8eb-6d6de1cb8d0d.value": [
+      "55177ca7-4999-466e-8544-82da9a8af7da.state_c",
+      "b456bbbb-47b2-4a51-b8d9-210f919337a4.item2"
+    ],
+    "b456bbbb-47b2-4a51-b8d9-210f919337a4.result": [
+      "e4851859-59f4-4004-8e5c-4cdc4fb3064d.description"
+    ],
+    "c049bcad-7006-47f5-bc10-1aa191571bd8.value": [
+      "fe95c78d-2a24-4c84-8509-a6024443f2a3.context"
+    ],
+    "e4851859-59f4-4004-8e5c-4cdc4fb3064d.accepted": [
+      "55177ca7-4999-466e-8544-82da9a8af7da.state"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Group",
+      "x": -21,
+      "y": -100,
+      "width": 1152,
+      "height": 322,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Group",
+      "x": -21,
+      "y": 225,
+      "width": 1740,
+      "height": 817,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Validation",
+      "x": -20,
+      "y": -1087,
+      "width": 2395,
+      "height": 983,
+      "color": "#b58b2a",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Group",
+      "x": -21,
+      "y": 1045,
+      "width": 1438,
+      "height": 480,
+      "color": "#8A8",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/Graph",
+  "inputs": [],
+  "outputs": [],
+  "module_properties": {},
+  "style": {
+    "title_color": "#572e44",
+    "node_color": "#392c34",
+    "icon": "F1719",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/instruct-gamestate-updates.json

@@ -0,0 +1,562 @@
+{
+  "title": "Instruct Gamestate Updates",
+  "id": "135fe6aa-33cf-4ef4-9685-5f5a44fc8f7f",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agernts/director/chat/instructGamestateUpdates",
+  "nodes": {
+    "0404af9c-3a1e-4535-b8bc-5e8257f95d20": {
+      "title": "true",
+      "id": "0404af9c-3a1e-4535-b8bc-5e8257f95d20",
+      "properties": {
+        "value": true
+      },
+      "x": 485,
+      "y": 95,
+      "width": 210,
+      "height": 58,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/MakeBool",
+      "base_type": "core/Node"
+    },
+    "9eba0f83-4226-4f88-b08e-e9c786b3083b": {
+      "title": "summarizer",
+      "id": "9eba0f83-4226-4f88-b08e-e9c786b3083b",
+      "properties": {
+        "agent_name": "summarizer"
+      },
+      "x": 371,
+      "y": 182,
+      "width": 210,
+      "height": 58,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "agents/GetAgent",
+      "base_type": "core/Node"
+    },
+    "fa4a84ad-a696-4ede-9471-fbef8c1c98ee": {
+      "title": "GET local.instructions",
+      "id": "fa4a84ad-a696-4ede-9471-fbef8c1c98ee",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 21,
+      "y": 272,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "0818b1cc-4ad8-46eb-b736-52816aee2582": {
+      "title": "Build Prompt",
+      "id": "0818b1cc-4ad8-46eb-b736-52816aee2582",
+      "properties": {
+        "template_file": "base",
+        "scope": "common",
+        "instructions": "",
+        "reserved_tokens": 312,
+        "limit_max_tokens": 0,
+        "include_scene_intent": false,
+        "include_extra_context": false,
+        "include_memory_context": false,
+        "include_scene_context": false,
+        "include_character_context": false,
+        "include_gamestate_context": true,
+        "memory_prompt": "",
+        "prefill_prompt": "PLAN:",
+        "return_prefill_prompt": false,
+        "dedupe_enabled": true,
+        "response_length": 0,
+        "technical": false
+      },
+      "x": 681,
+      "y": 232,
+      "width": 304,
+      "height": 542,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "prompt/BuildPrompt",
+      "base_type": "core/Node"
+    },
+    "691fad16-5ef2-414c-b60f-f67e80c52314": {
+      "title": "Input Socket",
+      "id": "691fad16-5ef2-414c-b60f-f67e80c52314",
+      "properties": {
+        "input_type": "any",
+        "input_name": "state",
+        "input_optional": false,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 23,
+      "y": -418,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "2768828e-e8e2-4fe8-9899-75066cf7850b": {
+      "title": "OUT state",
+      "id": "2768828e-e8e2-4fe8-9899-75066cf7850b",
+      "properties": {
+        "output_type": "any",
+        "output_name": "state",
+        "num": 0
+      },
+      "x": 334,
+      "y": -416,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "25b43bed-e4bf-45c0-87c7-72c5785c1d62": {
+      "title": "Validate Value Is Set",
+      "id": "25b43bed-e4bf-45c0-87c7-72c5785c1d62",
+      "properties": {
+        "error_message": "`instructions` is a required argument.",
+        "blank_string_is_unset": true
+      },
+      "x": 324,
+      "y": -146,
+      "width": 210,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueIsSet",
+      "base_type": "core/Node"
+    },
+    "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3": {
+      "title": "SET local.instructions",
+      "id": "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 594,
+      "y": -146,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "fa56ec44-2788-4fd4-8ad2-5f9512ddf4b0": {
+      "title": "OUT instructions",
+      "id": "fa56ec44-2788-4fd4-8ad2-5f9512ddf4b0",
+      "properties": {
+        "output_type": "str",
+        "output_name": "instructions",
+        "num": 1
+      },
+      "x": 1154,
+      "y": -126,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f": {
+      "title": "Stage 0",
+      "id": "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f",
+      "properties": {
+        "stage": 0
+      },
+      "x": 874,
+      "y": -126,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "8d824394-df20-448d-a2d5-3be176b971ec": {
+      "title": "data objects",
+      "id": "8d824394-df20-448d-a2d5-3be176b971ec",
+      "properties": {},
+      "x": 1400,
+      "y": 150,
+      "width": 140,
+      "height": 26,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/Watch",
+      "base_type": "core/Node"
+    },
+    "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac": {
+      "title": "Instructions",
+      "id": "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac",
+      "properties": {
+        "template": "Use codeblocks containing data structures to propose updates to the existing gamestate structure to fulfill the following task.\n\nIf you use more than one codeblock they will be applied to the data sequentially one after another.\n\nYour codeblock(s) will be passed to a python dict update function call.\n\nTASK: {instructions}\n\nBegin by planning your actions, then provide the necessary code block(s)."
+      },
+      "x": 281,
+      "y": 272,
+      "width": 210,
+      "height": 133,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "96be54b5-25d5-445b-bec3-bc3e82c0bf10": {
+      "title": "Generate Response",
+      "id": "96be54b5-25d5-445b-bec3-bc3e82c0bf10",
+      "properties": {
+        "data_output": true,
+        "data_multiple": true,
+        "response_length": 2048,
+        "action_type": "analyze",
+        "attempts": 1
+      },
+      "x": 1091,
+      "y": 232,
+      "width": 262,
+      "height": 234,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "prompt/GenerateResponse",
+      "base_type": "core/Node"
+    },
+    "a6420009-f16e-4e70-93d5-040e54b25b80": {
+      "title": "Stage 1",
+      "id": "a6420009-f16e-4e70-93d5-040e54b25b80",
+      "properties": {
+        "stage": 1
+      },
+      "x": 1680,
+      "y": 270,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "fddd74c9-06ef-4fcb-a54d-46758b534f9f": {
+      "title": "SET local.updates",
+      "id": "fddd74c9-06ef-4fcb-a54d-46758b534f9f",
+      "properties": {
+        "name": "updates",
+        "scope": "local"
+      },
+      "x": 1420,
+      "y": 270,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "0c800d62-1ec6-4e96-9270-dc5ebdb7458a": {
+      "title": "GET local.updates",
+      "id": "0c800d62-1ec6-4e96-9270-dc5ebdb7458a",
+      "properties": {
+        "name": "updates",
+        "scope": "local"
+      },
+      "x": 1420,
+      "y": -131,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "3f8cb37f-6577-4d25-8cfe-a1b3ee22009c": {
+      "title": "OUT instructions",
+      "id": "3f8cb37f-6577-4d25-8cfe-a1b3ee22009c",
+      "properties": {
+        "output_type": "dict",
+        "output_name": "updates",
+        "num": 2
+      },
+      "x": 1711,
+      "y": -116,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "67f3c431-2c42-4918-b32d-e7f988cb00cb": {
+      "title": "GET local.updates",
+      "id": "67f3c431-2c42-4918-b32d-e7f988cb00cb",
+      "properties": {
+        "name": "updates",
+        "scope": "local"
+      },
+      "x": 20,
+      "y": 884,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "1a8900a1-7cbd-4c6a-8627-c95268f4dc63": {
+      "title": "Stage 2",
+      "id": "1a8900a1-7cbd-4c6a-8627-c95268f4dc63",
+      "properties": {
+        "stage": 2
+      },
+      "x": 1360,
+      "y": 970,
+      "width": 210,
+      "height": 118,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "5f0fba74-6246-46d6-95aa-093b719a9ef6": {
+      "title": "Dict Update",
+      "id": "5f0fba74-6246-46d6-95aa-093b719a9ef6",
+      "properties": {
+        "create_copy": false
+      },
+      "x": 990,
+      "y": 940,
+      "width": 210,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/DictUpdate",
+      "base_type": "core/Node"
+    },
+    "7d0d79b9-93f3-49c9-9e34-3b941686e029": {
+      "title": "Game State",
+      "id": "7d0d79b9-93f3-49c9-9e34-3b941686e029",
+      "properties": {},
+      "x": 800,
+      "y": 990,
+      "width": 140,
+      "height": 26,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "state/Gamestate",
+      "base_type": "core/Node"
+    },
+    "309dbbd0-4da8-46ff-a72f-c205295d7ecd": {
+      "title": "Director Action Confirm",
+      "id": "309dbbd0-4da8-46ff-a72f-c205295d7ecd",
+      "properties": {
+        "name": "update_gamestate",
+        "description": "",
+        "raise_on_reject": true
+      },
+      "x": 520,
+      "y": 960,
+      "width": 237,
+      "height": 146,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/chat/ActionConfirm",
+      "base_type": "core/Node"
+    },
+    "43a56733-1e07-49d7-ad80-fa97377ea7cc": {
+      "title": "Advanced Format",
+      "id": "43a56733-1e07-49d7-ad80-fa97377ea7cc",
+      "properties": {
+        "template": "Update game state:\n\n```\n{updates}\n```"
+      },
+      "x": 270,
+      "y": 1020,
+      "width": 210,
+      "height": 133,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "91bcf73f-ef94-4e28-a6a1-681b5f9813a7": {
+      "title": "Input Socket",
+      "id": "91bcf73f-ef94-4e28-a6a1-681b5f9813a7",
+      "properties": {
+        "input_type": "str",
+        "input_name": "instructions",
+        "input_optional": false,
+        "input_group": "",
+        "num": 1
+      },
+      "x": 24,
+      "y": -176,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "6a3b10a7-fa92-413e-b809-b4a3874d0fc5": {
+      "title": "Module Style",
+      "id": "6a3b10a7-fa92-413e-b809-b4a3874d0fc5",
+      "properties": {
+        "node_color": "#392c34",
+        "title_color": "#572e44",
+        "auto_title": null,
+        "icon": "F1719"
+      },
+      "x": 1140,
+      "y": -440,
+      "width": 210,
+      "height": 110,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/ModuleStyle",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "0404af9c-3a1e-4535-b8bc-5e8257f95d20.value": [
+      "0818b1cc-4ad8-46eb-b736-52816aee2582.state"
+    ],
+    "9eba0f83-4226-4f88-b08e-e9c786b3083b.agent": [
+      "0818b1cc-4ad8-46eb-b736-52816aee2582.agent"
+    ],
+    "fa4a84ad-a696-4ede-9471-fbef8c1c98ee.value": [
+      "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac.item0"
+    ],
+    "0818b1cc-4ad8-46eb-b736-52816aee2582.state": [
+      "96be54b5-25d5-445b-bec3-bc3e82c0bf10.state"
+    ],
+    "0818b1cc-4ad8-46eb-b736-52816aee2582.agent": [
+      "96be54b5-25d5-445b-bec3-bc3e82c0bf10.agent"
+    ],
+    "0818b1cc-4ad8-46eb-b736-52816aee2582.prompt": [
+      "96be54b5-25d5-445b-bec3-bc3e82c0bf10.prompt"
+    ],
+    "691fad16-5ef2-414c-b60f-f67e80c52314.value": [
+      "2768828e-e8e2-4fe8-9899-75066cf7850b.value"
+    ],
+    "25b43bed-e4bf-45c0-87c7-72c5785c1d62.value": [
+      "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3.value"
+    ],
+    "76cdeb2c-20c0-413b-a6d3-642ba59ab8b3.value": [
+      "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f.state"
+    ],
+    "97025c52-ac1d-41e5-8ec6-8ea1a7fe635f.state": [
+      "fa56ec44-2788-4fd4-8ad2-5f9512ddf4b0.value"
+    ],
+    "75a6f3c1-21a5-47cc-ac25-1627b5a2d4ac.result": [
+      "0818b1cc-4ad8-46eb-b736-52816aee2582.instructions"
+    ],
+    "96be54b5-25d5-445b-bec3-bc3e82c0bf10.data_obj": [
+      "8d824394-df20-448d-a2d5-3be176b971ec.value",
+      "fddd74c9-06ef-4fcb-a54d-46758b534f9f.value"
+    ],
+    "fddd74c9-06ef-4fcb-a54d-46758b534f9f.value": [
+      "a6420009-f16e-4e70-93d5-040e54b25b80.state"
+    ],
+    "0c800d62-1ec6-4e96-9270-dc5ebdb7458a.value": [
+      "3f8cb37f-6577-4d25-8cfe-a1b3ee22009c.value"
+    ],
+    "67f3c431-2c42-4918-b32d-e7f988cb00cb.value": [
+      "309dbbd0-4da8-46ff-a72f-c205295d7ecd.state",
+      "43a56733-1e07-49d7-ad80-fa97377ea7cc.item0"
+    ],
+    "5f0fba74-6246-46d6-95aa-093b719a9ef6.dict": [
+      "1a8900a1-7cbd-4c6a-8627-c95268f4dc63.state"
+    ],
+    "7d0d79b9-93f3-49c9-9e34-3b941686e029.variables": [
+      "5f0fba74-6246-46d6-95aa-093b719a9ef6.dict"
+    ],
+    "309dbbd0-4da8-46ff-a72f-c205295d7ecd.accepted": [
+      "5f0fba74-6246-46d6-95aa-093b719a9ef6.state",
+      "5f0fba74-6246-46d6-95aa-093b719a9ef6.dicts"
+    ],
+    "43a56733-1e07-49d7-ad80-fa97377ea7cc.result": [
+      "309dbbd0-4da8-46ff-a72f-c205295d7ecd.description"
+    ],
+    "91bcf73f-ef94-4e28-a6a1-681b5f9813a7.value": [
+      "25b43bed-e4bf-45c0-87c7-72c5785c1d62.value"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Validation",
+      "x": -2,
+      "y": -498,
+      "width": 1391,
+      "height": 515,
+      "color": "#b58b2a",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Process",
+      "x": -4,
+      "y": 20,
+      "width": 1982,
+      "height": 780,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Process",
+      "x": -5,
+      "y": 804,
+      "width": 1600,
+      "height": 374,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Output",
+      "x": 1395,
+      "y": -211,
+      "width": 551,
+      "height": 227,
+      "color": "#8A8",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/Graph",
+  "inputs": [],
+  "outputs": [],
+  "module_properties": {},
+  "style": {
+    "title_color": "#572e44",
+    "node_color": "#392c34",
+    "icon": "F1719",
+    "auto_title": null,
+    "counterpart": null
+  }
+}

src/talemate/agents/director/modules/instruct-narrator.json

@@ -0,0 +1,837 @@
+{
+  "title": "Instruct Narrator",
+  "id": "dfd90b27-7aee-45c4-adc4-965addc89178",
+  "properties": {},
+  "x": 0,
+  "y": 0,
+  "width": 200,
+  "height": 100,
+  "collapsed": false,
+  "inherited": false,
+  "registry": "agents/director/chat/instructNarrator",
+  "nodes": {
+    "524f267d-3fa7-46d3-ba78-f65ff96abad2": {
+      "title": "Validate Value Is Set",
+      "id": "524f267d-3fa7-46d3-ba78-f65ff96abad2",
+      "properties": {
+        "error_message": "instructions required",
+        "blank_string_is_unset": true
+      },
+      "x": 288,
+      "y": 61,
+      "width": 210,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueIsSet",
+      "base_type": "core/Node"
+    },
+    "fe6cb7d0-a665-44cd-994d-1371893ea7d6": {
+      "title": "Coallesce",
+      "id": "fe6cb7d0-a665-44cd-994d-1371893ea7d6",
+      "properties": {},
+      "x": 1346,
+      "y": 1414,
+      "width": 140,
+      "height": 86,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Coallesce",
+      "base_type": "core/Node"
+    },
+    "6aa18f2c-0f82-41e2-9c56-32146d381217": {
+      "title": "Coallesce",
+      "id": "6aa18f2c-0f82-41e2-9c56-32146d381217",
+      "properties": {},
+      "x": 1356,
+      "y": 1724,
+      "width": 140,
+      "height": 86,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Coallesce",
+      "base_type": "core/Node"
+    },
+    "94e45254-61d3-4f3f-bd50-c8e96b800d77": {
+      "title": "SET local.instructions",
+      "id": "94e45254-61d3-4f3f-bd50-c8e96b800d77",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": 558,
+      "y": 51,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "89dd2b38-581b-434b-8102-fc869ba30fd0": {
+      "title": "OUT instructions",
+      "id": "89dd2b38-581b-434b-8102-fc869ba30fd0",
+      "properties": {
+        "output_type": "str",
+        "output_name": "instructions",
+        "num": 1
+      },
+      "x": 1628,
+      "y": 80,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "3e8d05d9-a4d0-42ce-86de-53dc1e58628c": {
+      "title": "Validate Value Contained",
+      "id": "3e8d05d9-a4d0-42ce-86de-53dc1e58628c",
+      "properties": {
+        "error_message": "`{value}` is not valid for narration_type. Must be one of \"reveal\", \"describe\" or \"progress\"."
+      },
+      "x": 298,
+      "y": 360,
+      "width": 210,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueContained",
+      "base_type": "core/Node"
+    },
+    "e6fed6f1-cde3-4395-9f2d-0fc18d888bfc": {
+      "title": "SET local.narration_type",
+      "id": "e6fed6f1-cde3-4395-9f2d-0fc18d888bfc",
+      "properties": {
+        "name": "narration_type",
+        "scope": "local"
+      },
+      "x": 568,
+      "y": 340,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "a7995fc9-20eb-411c-8f91-f7619898534b": {
+      "title": "Stage -1",
+      "id": "a7995fc9-20eb-411c-8f91-f7619898534b",
+      "properties": {
+        "stage": -1
+      },
+      "x": 1058,
+      "y": 250,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "7732ac95-5103-4bc7-8936-57e363cb660a": {
+      "title": "String Check",
+      "id": "7732ac95-5103-4bc7-8936-57e363cb660a",
+      "properties": {
+        "substring": "describe_character",
+        "mode": "exact",
+        "case_sensitive": true
+      },
+      "x": 284,
+      "y": 734,
+      "width": 248,
+      "height": 126,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "data/string/StringCheck",
+      "base_type": "core/Node"
+    },
+    "febb377e-be31-49d9-b9c3-bc9d2ea2fc23": {
+      "title": "RSwitch Advanced",
+      "id": "febb377e-be31-49d9-b9c3-bc9d2ea2fc23",
+      "properties": {},
+      "x": 474,
+      "y": 794,
+      "width": 175,
+      "height": 66,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/RSwitchAdvanced",
+      "base_type": "core/Node"
+    },
+    "6acad0c5-0232-46a7-8f01-48ff2713c73f": {
+      "title": "Validate Value Is Set",
+      "id": "6acad0c5-0232-46a7-8f01-48ff2713c73f",
+      "properties": {
+        "error_message": "`character_name` is required when `narration_type` is \"describe_character\".",
+        "blank_string_is_unset": true
+      },
+      "x": 694,
+      "y": 784,
+      "width": 210,
+      "height": 102,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "validation/ValidateValueIsSet",
+      "base_type": "core/Node"
+    },
+    "ad5ade4b-dad2-4dcb-8859-c2173d6ce18a": {
+      "title": "SET local.character",
+      "id": "ad5ade4b-dad2-4dcb-8859-c2173d6ce18a",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 984,
+      "y": 784,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/SetState",
+      "base_type": "core/Node"
+    },
+    "0e1a4c7e-1873-4e8a-aa11-4402689f0b87": {
+      "title": "OUT character",
+      "id": "0e1a4c7e-1873-4e8a-aa11-4402689f0b87",
+      "properties": {
+        "output_type": "character",
+        "output_name": "character",
+        "num": 3
+      },
+      "x": 1654,
+      "y": 784,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "0850235a-4a95-48c5-8ae2-8289205897bf": {
+      "title": "OUT narration_type",
+      "id": "0850235a-4a95-48c5-8ae2-8289205897bf",
+      "properties": {
+        "output_type": "str",
+        "output_name": "narration_type",
+        "num": 2
+      },
+      "x": 1620,
+      "y": 340,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "09416ce3-ed48-4ab8-bcc5-ae85752900ea": {
+      "title": "OUT state",
+      "id": "09416ce3-ed48-4ab8-bcc5-ae85752900ea",
+      "properties": {
+        "output_type": "any",
+        "output_name": "state",
+        "num": 0
+      },
+      "x": 280,
+      "y": -170,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "b62840fa-7a4b-48b7-bc6f-16171d156d76": {
+      "title": "Module Style",
+      "id": "b62840fa-7a4b-48b7-bc6f-16171d156d76",
+      "properties": {
+        "node_color": "#392c34",
+        "title_color": "#572e44",
+        "auto_title": null,
+        "icon": "F1719"
+      },
+      "x": 1630,
+      "y": -150,
+      "width": 210,
+      "height": 110,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "util/ModuleStyle",
+      "base_type": "core/Node"
+    },
+    "6549fbbd-e84c-47ec-b4e3-5bc713f3d4f5": {
+      "title": "Stage 0",
+      "id": "6549fbbd-e84c-47ec-b4e3-5bc713f3d4f5",
+      "properties": {
+        "stage": 0
+      },
+      "x": 1320,
+      "y": 790,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "478d0589-e430-4d00-ac53-49c784cdecce": {
+      "title": "GET local.narration_type",
+      "id": "478d0589-e430-4d00-ac53-49c784cdecce",
+      "properties": {
+        "name": "narration_type",
+        "scope": "local"
+      },
+      "x": -3,
+      "y": 1530,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "33724449-7640-47da-9351-0787d74f9d79": {
+      "title": "Case",
+      "id": "33724449-7640-47da-9351-0787d74f9d79",
+      "properties": {
+        "attribute_name": "",
+        "case_a": "progress",
+        "case_b": "reveal",
+        "case_c": "describe_character",
+        "case_d": "describe_scene"
+      },
+      "x": 337,
+      "y": 1650,
+      "width": 210,
+      "height": 234,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Case",
+      "base_type": "core/Node"
+    },
+    "22048751-dfdb-4e01-af81-69a32aff4bf6": {
+      "title": "GET local.character",
+      "id": "22048751-dfdb-4e01-af81-69a32aff4bf6",
+      "properties": {
+        "name": "character",
+        "scope": "local"
+      },
+      "x": 787,
+      "y": 1720,
+      "width": 210,
+      "height": 122,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "5bd51ff2-661f-479d-a8ec-92cfa662e2aa": {
+      "title": "Case",
+      "id": "5bd51ff2-661f-479d-a8ec-92cfa662e2aa",
+      "properties": {
+        "attribute_name": "",
+        "case_a": "describe_environment",
+        "case_b": "",
+        "case_c": "",
+        "case_d": ""
+      },
+      "x": 686,
+      "y": 1894,
+      "width": 210,
+      "height": 234,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Case",
+      "base_type": "core/Node"
+    },
+    "40726545-c86a-4d85-8610-2c49d610347a": {
+      "title": "GET local.instructions",
+      "id": "40726545-c86a-4d85-8610-2c49d610347a",
+      "properties": {
+        "name": "instructions",
+        "scope": "local"
+      },
+      "x": -10,
+      "y": 1125,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "7c0fc92d-568e-497e-8cb3-1fd94e0d11d2": {
+      "title": "OUT summary",
+      "id": "7c0fc92d-568e-497e-8cb3-1fd94e0d11d2",
+      "properties": {
+        "output_type": "str",
+        "output_name": "summary",
+        "num": 3
+      },
+      "x": 2927,
+      "y": 1450,
+      "width": 210,
+      "height": 106,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Output",
+      "base_type": "core/Node"
+    },
+    "7f3a6455-1ff4-4e41-92df-b42fb87b3fbb": {
+      "title": "Push History",
+      "id": "7f3a6455-1ff4-4e41-92df-b42fb87b3fbb",
+      "properties": {
+        "emit_message": true
+      },
+      "x": 2260,
+      "y": 1570,
+      "width": 210,
+      "height": 58,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "scene/history/Push",
+      "base_type": "core/Node"
+    },
+    "4f6659ce-6a14-4553-bb0f-cfb677e185bf": {
+      "title": "Stage 1",
+      "id": "4f6659ce-6a14-4553-bb0f-cfb677e185bf",
+      "properties": {
+        "stage": 1
+      },
+      "x": 2930,
+      "y": 1700,
+      "width": 210,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Stage",
+      "base_type": "core/Node"
+    },
+    "abd90939-40b3-4371-817c-d23e51668057": {
+      "title": "Director Action Confirm",
+      "id": "abd90939-40b3-4371-817c-d23e51668057",
+      "properties": {
+        "name": "instruct_narrator",
+        "description": "",
+        "raise_on_reject": true
+      },
+      "x": 1967,
+      "y": 1520,
+      "width": 237,
+      "height": 146,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/director/chat/ActionConfirm",
+      "base_type": "core/Node"
+    },
+    "704a9416-3008-4532-943b-a65855c30f00": {
+      "title": "Coallesce",
+      "id": "704a9416-3008-4532-943b-a65855c30f00",
+      "properties": {},
+      "x": 1536,
+      "y": 1564,
+      "width": 140,
+      "height": 86,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Coallesce",
+      "base_type": "core/Node"
+    },
+    "c69c06e5-59a2-4e86-8bbf-ed27669000c6": {
+      "title": "Advanced Format",
+      "id": "c69c06e5-59a2-4e86-8bbf-ed27669000c6",
+      "properties": {
+        "template": "### Instructions\n```\n{instructions}\n```\n\n### Narration\n``` scene\n{value}\n```"
+      },
+      "x": 1720,
+      "y": 1510,
+      "width": 210,
+      "height": 153,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        },
+        {
+          "name": "item1",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "d195cf7d-85be-4d4d-ba8e-f49ea2fce774": {
+      "title": "Advanced Format",
+      "id": "d195cf7d-85be-4d4d-ba8e-f49ea2fce774",
+      "properties": {
+        "template": "New narration generated and appended to the scene: \n\n```\n{message.message}\n```"
+      },
+      "x": 2512,
+      "y": 1564,
+      "width": 210,
+      "height": 133,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "data/string/AdvancedFormat",
+      "dynamic_inputs": [
+        {
+          "name": "item0",
+          "type": "*"
+        }
+      ],
+      "base_type": "core/DynamicSocketNodeBase"
+    },
+    "c7d41761-c4d1-4624-9b69-4b79bab43f5e": {
+      "title": "GET local.narration_type",
+      "id": "c7d41761-c4d1-4624-9b69-4b79bab43f5e",
+      "properties": {
+        "name": "narration_type",
+        "scope": "local"
+      },
+      "x": 0,
+      "y": 670,
+      "width": 210,
+      "height": 122,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "state/GetState",
+      "base_type": "core/Node"
+    },
+    "22549507-7be8-4a3c-a7ef-a0bc81d83912": {
+      "title": "IN state",
+      "id": "22549507-7be8-4a3c-a7ef-a0bc81d83912",
+      "properties": {
+        "input_type": "any",
+        "input_name": "state",
+        "input_optional": false,
+        "input_group": "",
+        "num": 0
+      },
+      "x": 0,
+      "y": -170,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "f08ff23c-7d37-4ee2-9aed-104d5156fd5c": {
+      "title": "Generate Progress Narration",
+      "id": "f08ff23c-7d37-4ee2-9aed-104d5156fd5c",
+      "properties": {
+        "response_length": 2048
+      },
+      "x": 995,
+      "y": 1292,
+      "width": 245,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/narrator/GenerateProgress",
+      "base_type": "core/Node"
+    },
+    "2f7f3961-f272-43bb-a9b3-a7eca3397fca": {
+      "title": "Generate Progress Narration",
+      "id": "2f7f3961-f272-43bb-a9b3-a7eca3397fca",
+      "properties": {
+        "response_length": 1024
+      },
+      "x": 995,
+      "y": 1452,
+      "width": 245,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/narrator/GenerateProgress",
+      "base_type": "core/Node"
+    },
+    "a880fccf-c7b7-4863-9310-0abdb139a9e1": {
+      "title": "Generate Character Narration",
+      "id": "a880fccf-c7b7-4863-9310-0abdb139a9e1",
+      "properties": {
+        "response_length": 1024
+      },
+      "x": 997,
+      "y": 1600,
+      "width": 245,
+      "height": 118,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/narrator/GenerateCharacterNarration",
+      "base_type": "core/Node"
+    },
+    "f50201f1-0125-44cd-a635-18ad440e9f68": {
+      "title": "Generate Scene Narration",
+      "id": "f50201f1-0125-44cd-a635-18ad440e9f68",
+      "properties": {
+        "response_length": 1024
+      },
+      "x": 996,
+      "y": 1774,
+      "width": 245,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/narrator/GenerateSceneNarration",
+      "base_type": "core/Node"
+    },
+    "398b61e1-a41d-47c2-9213-4030ead5ed7e": {
+      "title": "Generate Environment Narration",
+      "id": "398b61e1-a41d-47c2-9213-4030ead5ed7e",
+      "properties": {
+        "response_length": 1024
+      },
+      "x": 1010,
+      "y": 1940,
+      "width": 252,
+      "height": 98,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "agents/narrator/GenerateEnvironmentNarration",
+      "base_type": "core/Node"
+    },
+    "dcee2179-aa06-43a5-8c5d-aa29b2cedd4c": {
+      "title": "IN character",
+      "id": "dcee2179-aa06-43a5-8c5d-aa29b2cedd4c",
+      "properties": {
+        "input_type": "character",
+        "input_name": "character",
+        "input_optional": true,
+        "input_group": "",
+        "num": 3
+      },
+      "x": 0,
+      "y": 860,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "a9606e1d-525d-467c-8889-cfcc284eb42d": {
+      "title": "Make List",
+      "id": "a9606e1d-525d-467c-8889-cfcc284eb42d",
+      "properties": {
+        "item_type": "any",
+        "items": [
+          "progress",
+          "reveal",
+          "describe_character",
+          "describe_scene",
+          "describe_environment"
+        ]
+      },
+      "x": 20,
+      "y": 510,
+      "width": 210,
+      "height": 102,
+      "collapsed": true,
+      "inherited": false,
+      "registry": "data/MakeList",
+      "base_type": "core/Node"
+    },
+    "94113c62-f468-4e78-8460-d6c0a35f0254": {
+      "title": "IN narration_type",
+      "id": "94113c62-f468-4e78-8460-d6c0a35f0254",
+      "properties": {
+        "input_type": "str",
+        "input_name": "narration_type",
+        "input_optional": false,
+        "input_group": "",
+        "num": 2
+      },
+      "x": 0,
+      "y": 280,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    },
+    "fdaa6404-8db2-421a-9fb0-d46361189692": {
+      "title": "IN instructions",
+      "id": "fdaa6404-8db2-421a-9fb0-d46361189692",
+      "properties": {
+        "input_type": "str",
+        "input_name": "instructions",
+        "input_optional": false,
+        "input_group": "",
+        "num": 1
+      },
+      "x": 0,
+      "y": 50,
+      "width": 210,
+      "height": 154,
+      "collapsed": false,
+      "inherited": false,
+      "registry": "core/Input",
+      "base_type": "core/Node"
+    }
+  },
+  "edges": {
+    "524f267d-3fa7-46d3-ba78-f65ff96abad2.value": [
+      "94e45254-61d3-4f3f-bd50-c8e96b800d77.value"
+    ],
+    "fe6cb7d0-a665-44cd-994d-1371893ea7d6.value": [
+      "704a9416-3008-4532-943b-a65855c30f00.a"
+    ],
+    "6aa18f2c-0f82-41e2-9c56-32146d381217.value": [
+      "704a9416-3008-4532-943b-a65855c30f00.b"
+    ],
+    "94e45254-61d3-4f3f-bd50-c8e96b800d77.value": [
+      "a7995fc9-20eb-411c-8f91-f7619898534b.state"
+    ],
+    "3e8d05d9-a4d0-42ce-86de-53dc1e58628c.value": [
+      "e6fed6f1-cde3-4395-9f2d-0fc18d888bfc.value"
+    ],
+    "e6fed6f1-cde3-4395-9f2d-0fc18d888bfc.value": [
+      "a7995fc9-20eb-411c-8f91-f7619898534b.state_b"
+    ],
+    "a7995fc9-20eb-411c-8f91-f7619898534b.state": [
+      "89dd2b38-581b-434b-8102-fc869ba30fd0.value"
+    ],
+    "a7995fc9-20eb-411c-8f91-f7619898534b.state_b": [
+      "0850235a-4a95-48c5-8ae2-8289205897bf.value"
+    ],
+    "7732ac95-5103-4bc7-8936-57e363cb660a.result": [
+      "febb377e-be31-49d9-b9c3-bc9d2ea2fc23.check"
+    ],
+    "febb377e-be31-49d9-b9c3-bc9d2ea2fc23.yes": [
+      "6acad0c5-0232-46a7-8f01-48ff2713c73f.value"
+    ],
+    "6acad0c5-0232-46a7-8f01-48ff2713c73f.value": [
+      "ad5ade4b-dad2-4dcb-8859-c2173d6ce18a.value"
+    ],
+    "ad5ade4b-dad2-4dcb-8859-c2173d6ce18a.value": [
+      "6549fbbd-e84c-47ec-b4e3-5bc713f3d4f5.state"
+    ],
+    "6549fbbd-e84c-47ec-b4e3-5bc713f3d4f5.state": [
+      "0e1a4c7e-1873-4e8a-aa11-4402689f0b87.value"
+    ],
+    "478d0589-e430-4d00-ac53-49c784cdecce.value": [
+      "33724449-7640-47da-9351-0787d74f9d79.value"
+    ],
+    "33724449-7640-47da-9351-0787d74f9d79.a": [
+      "f08ff23c-7d37-4ee2-9aed-104d5156fd5c.state"
+    ],
+    "33724449-7640-47da-9351-0787d74f9d79.b": [
+      "2f7f3961-f272-43bb-a9b3-a7eca3397fca.state"
+    ],
+    "33724449-7640-47da-9351-0787d74f9d79.c": [
+      "a880fccf-c7b7-4863-9310-0abdb139a9e1.state"
+    ],
+    "33724449-7640-47da-9351-0787d74f9d79.d": [
+      "f50201f1-0125-44cd-a635-18ad440e9f68.state"
+    ],
+    "33724449-7640-47da-9351-0787d74f9d79.none": [
+      "5bd51ff2-661f-479d-a8ec-92cfa662e2aa.value"
+    ],
+    "22048751-dfdb-4e01-af81-69a32aff4bf6.value": [
+      "a880fccf-c7b7-4863-9310-0abdb139a9e1.character"
+    ],
+    "5bd51ff2-661f-479d-a8ec-92cfa662e2aa.a": [
+      "398b61e1-a41d-47c2-9213-4030ead5ed7e.state"
+    ],
+    "40726545-c86a-4d85-8610-2c49d610347a.value": [
+      "c69c06e5-59a2-4e86-8bbf-ed27669000c6.item0",
+      "f08ff23c-7d37-4ee2-9aed-104d5156fd5c.narrative_direction",
+      "2f7f3961-f272-43bb-a9b3-a7eca3397fca.narrative_direction",
+      "a880fccf-c7b7-4863-9310-0abdb139a9e1.narrative_direction",
+      "f50201f1-0125-44cd-a635-18ad440e9f68.narrative_direction",
+      "398b61e1-a41d-47c2-9213-4030ead5ed7e.narrative_direction"
+    ],
+    "7f3a6455-1ff4-4e41-92df-b42fb87b3fbb.message": [
+      "d195cf7d-85be-4d4d-ba8e-f49ea2fce774.item0"
+    ],
+    "abd90939-40b3-4371-817c-d23e51668057.accepted": [
+      "7f3a6455-1ff4-4e41-92df-b42fb87b3fbb.message"
+    ],
+    "704a9416-3008-4532-943b-a65855c30f00.value": [
+      "abd90939-40b3-4371-817c-d23e51668057.state",
+      "c69c06e5-59a2-4e86-8bbf-ed27669000c6.item1"
+    ],
+    "c69c06e5-59a2-4e86-8bbf-ed27669000c6.result": [
+      "abd90939-40b3-4371-817c-d23e51668057.description"
+    ],
+    "d195cf7d-85be-4d4d-ba8e-f49ea2fce774.result": [
+      "7c0fc92d-568e-497e-8cb3-1fd94e0d11d2.value",
+      "4f6659ce-6a14-4553-bb0f-cfb677e185bf.state"
+    ],
+    "c7d41761-c4d1-4624-9b69-4b79bab43f5e.value": [
+      "7732ac95-5103-4bc7-8936-57e363cb660a.string"
+    ],
+    "22549507-7be8-4a3c-a7ef-a0bc81d83912.value": [
+      "09416ce3-ed48-4ab8-bcc5-ae85752900ea.value"
+    ],
+    "f08ff23c-7d37-4ee2-9aed-104d5156fd5c.message": [
+      "fe6cb7d0-a665-44cd-994d-1371893ea7d6.a"
+    ],
+    "2f7f3961-f272-43bb-a9b3-a7eca3397fca.message": [
+      "fe6cb7d0-a665-44cd-994d-1371893ea7d6.b"
+    ],
+    "a880fccf-c7b7-4863-9310-0abdb139a9e1.message": [
+      "fe6cb7d0-a665-44cd-994d-1371893ea7d6.c"
+    ],
+    "f50201f1-0125-44cd-a635-18ad440e9f68.message": [
+      "fe6cb7d0-a665-44cd-994d-1371893ea7d6.d"
+    ],
+    "398b61e1-a41d-47c2-9213-4030ead5ed7e.message": [
+      "6aa18f2c-0f82-41e2-9c56-32146d381217.a"
+    ],
+    "dcee2179-aa06-43a5-8c5d-aa29b2cedd4c.value": [
+      "febb377e-be31-49d9-b9c3-bc9d2ea2fc23.yes"
+    ],
+    "a9606e1d-525d-467c-8889-cfcc284eb42d.list": [
+      "3e8d05d9-a4d0-42ce-86de-53dc1e58628c.list"
+    ],
+    "94113c62-f468-4e78-8460-d6c0a35f0254.value": [
+      "3e8d05d9-a4d0-42ce-86de-53dc1e58628c.value"
+    ],
+    "fdaa6404-8db2-421a-9fb0-d46361189692.value": [
+      "524f267d-3fa7-46d3-ba78-f65ff96abad2.value"
+    ]
+  },
+  "groups": [
+    {
+      "title": "Validation",
+      "x": -31,
+      "y": -230,
+      "width": 1905,
+      "height": 1277,
+      "color": "#b58b2a",
+      "font_size": 24,
+      "inherited": false
+    },
+    {
+      "title": "Process",
+      "x": -35,
+      "y": 1050,
+      "width": 3295,
+      "height": 1102,
+      "color": "#3f789e",
+      "font_size": 24,
+      "inherited": false
+    }
+  ],
+  "comments": [],
+  "extends": null,
+  "base_type": "core/Graph",
+  "inputs": [],
+  "outputs": [],
+  "module_properties": {},
+  "style": {
+    "title_color": "#572e44",
+    "node_color": "#392c34",
+    "icon": "F1719",
+    "auto_title": null,
+    "counterpart": null
+  }
+}