briyah 1.2.3 → 1.2.5

package/data/common/prompts/character/introduce_character.prompt

@@ -0,0 +1,58 @@
+# Introduce New Character
+You are creating a brief character profile for {{agentName}}, a character who has just been introduced into an ongoing story.
+
+## Recent Story Events
+{{#if formattedHistory}}
+{{#each formattedHistory}}
+{{this}}
+{{/each}}
+{{else}}
+Refer to the conversation history above for recent events.
+{{/if}}
+
+## Plot Plan (narrator's eyes only — do not reveal to others)
+{{plotPlan}}
+
+## Other Characters in the Story (name and visible description)
+{{#if otherCharacters}}
+{{#each otherCharacters}}
+- **{{name}}**: {{description}}
+{{/each}}
+{{else}}
+(No other characters yet.)
+{{/if}}
+
+## Your task
+Create a SHORT and SIMPLE character profile for {{agentName}}. This is a quick introduction, not a full character study. The profile must cover only:
+
+1. **Name**: The character's name ({{agentName}})
+
+2. **Role in the Story**: Where this character fits into the story. How are they connected to the setting, the other characters, and the events in the plot plan?
+
+3. **What They Know**: What this character would *realistically* know about the story so far. Only include events they could plausibly have witnessed, been told about, or learned through their position in the story world.
+**NOTE:** Do *not* mention information the character should *not* know about. For example, don't say 'Jessica doesn't know about the envelope under the seat'. That just gives it away to the new character.
+
+4. **What They Have Experienced**: This character knows nothing about the events of the story other than what you reveal to them here. So, give them details about the most recent interaction or dialog that led to them being introduced into the story.
+
+5. **Who They Are With**: Using the recent story events, work out which other characters {{agentName}} is currently in contact with (in the same scene / interacting with them). For each such character, describe their *visible, observable appearance* drawn from the "Other Characters in the Story" list above — what {{agentName}} can plainly see. {{agentName}} perceives these people by their appearance, NOT by name or backstory: only refer to a character by name if {{agentName}} would realistically already know it (e.g. they were introduced by name in the recent events). Otherwise describe them observably (for example, 'a woman in her early 30s with olive skin and an athletic build'). Do not include any character who is not present with {{agentName}}, and do not reveal hidden details, names, or backstory the character couldn't observe.
+
+6. **Personality**: A brief description of their temperament, manner, and how they speak.
+
+**Important Guidelines:**
+- Stay consistent with how the character has already appeared in the story events above
+- If the plot plan assigns this character a specific role or secret, include only what THIS character would know about it
+- Do *not* say 'He has no knowledge of...' and proceed to list all the things in the story the character shouldn't know.
+- Use your judgment about how detailed this character profile should be given their role in the story
+
+## Response format
+Return a JSON object with these fields:
+- `description`: A brief 1-2 sentence observable description of the character (physical appearance only). Stay consistent with any description already given in the story; otherwise invent something plausible.
+- `character_profile`: The short markdown-formatted character profile covering the sections above.
+
+Example format:
+```json
+{
+  "description": "A stocky man in his 50s with a weathered face, gray stubble, and a dockworker's rough hands.",
+  "character_profile": "**Name:** {{agentName}}\n\n**Role in the Story:** [Where they fit]\n\n**What They Know:** [Realistic knowledge of story events]\n\n**What They Have Experienced:** [The interaction that brought them in]\n\n**Who They Are With:** [Observable appearance of the characters present with them, named only if they'd know the name]\n\n**Personality:** [Brief temperament and speech style]"
+}
+```

package/data/common/prompts/character/perceive.prompt

@@ -22,6 +22,9 @@ Use your character profile to:
 {{visibleArtifacts}}
 ```
 
+## Your Inventory and Condition
+If a "Your private context (known only to you)" section is included with the current situation, it lists what your character is currently carrying, wearing, or possessing, along with any physical or mental conditions (wounded, exhausted, etc.). Stay consistent with it: only use or reference items you actually have, and let your conditions shape what your character can realistically do.
+
 ## How to Respond
 
 You should respond with a string of text that indicates what your character says or does.

package/data/common/prompts/character/progress_character.json

@@ -4,19 +4,23 @@
   "description": "Response schema for updating a character profile as the story progresses",
   "type": "object",
   "properties": {
+    "no_changes": {
+      "type": "boolean",
+      "description": "Set true when this character was NOT significantly affected by recent events. When true, omit description, character_profile, and inventory entirely - the existing profile is left unchanged."
+    },
     "description": {
       "type": "string",
-      "description": "A brief 1-2 sentence description containing only immediately observable physical characteristics"
+      "description": "A brief 1-2 sentence description containing only immediately observable physical characteristics. Omit when no_changes is true."
     },
     "character_profile": {
       "type": "string",
-      "description": "An updated markdown-formatted character profile reflecting growth and changes from recent story events"
+      "description": "An updated markdown-formatted character profile reflecting growth and changes from recent story events. Omit when no_changes is true."
     },
     "inventory": {
       "type": "string",
-      "description": "An updated concise markdown inventory reflecting items gained, lost, consumed, equipped, or any new/resolved conditions since the last chapter. Use '## Items' and (optionally) '## Conditions' sections. Omit this field if the character was just introduced or had no inventory artifact yet."
+      "description": "An updated concise markdown inventory reflecting items gained, lost, consumed, equipped, or any new/resolved conditions since the last chapter. Use '## Items' and (optionally) '## Conditions' sections. Omit this field if the character was just introduced, had no inventory artifact yet, or no_changes is true."
     }
   },
-  "required": ["character_profile"],
+  "required": ["no_changes"],
   "additionalProperties": false
 }

package/data/common/prompts/character/progress_character.mock

@@ -1,4 +1,5 @@
 {
+  "no_changes": false,
   "character_profile": "## Background\n\nThe character has grown through recent events and interactions.\n\n## Personality\n\n- More confident after recent experiences\n- Developing deeper relationships\n\n## Motivations\n\n- Seeking to understand the unfolding situation\n- Working toward personal goals",
   "description": "A character who has evolved through the story"
 }

package/data/common/prompts/character/progress_character.prompt

@@ -16,7 +16,14 @@ Refer to the conversation history above for recent events from your perspective.
 ## Updated Plot Plan (narrator's eyes only — do not reveal to others)
 {{plotPlan}}
 
-## Your task
+## First, decide whether an update is even needed
+Rewriting a full profile is expensive, so only do it when the recent story events genuinely affected {{agentName}}.
+
+If {{agentName}} was **not** significantly affected by recent events — they were absent, on the periphery, or nothing happened that would meaningfully change their backstory, personality, motivations, relationships, knowledge, or possessions — then return `{"no_changes": true}` and **nothing else**. Do not rewrite the profile, do not write a new diary entry, and do not include any other fields. The existing profile will be kept unchanged.
+
+Only if {{agentName}} **was** significantly affected should you proceed to rewrite the profile below. In that case, set `"no_changes": false` and include the updated fields.
+
+## Your task (only when no_changes is false)
 Your task is to create an updated, comprehensive character profile that reflects how {{agentName}} has grown, changed, or been affected by recent events in the story. This profile should capture the character's current state as the story moves forward.
 
 The character may have:
@@ -67,7 +74,17 @@ Create an updated character profile that includes:
 - Consider how relationships with other characters have evolved
 
 ## Response format
-Return a JSON object with these fields:
+Return a JSON object.
+
+**If {{agentName}} was not significantly affected**, return only:
+```json
+{
+  "no_changes": true
+}
+```
+
+**Otherwise**, return these fields:
+- `no_changes`: `false`
 - `description`: Updated observable description (optional — only include if appearance changed).
 - `character_profile`: The entire updated markdown-formatted character profile, ending with the diary entry section.
 - `inventory`: An updated concise inventory reflecting any items {{agentName}} gained, lost, consumed, or equipped during recent events, plus any new/resolved physical or mental conditions (wounded, healed, exhausted, etc.). Use `## Items` and (optionally) `## Conditions` sections. Carry forward unchanged items from the current inventory. Omit this field entirely if there is no existing inventory artifact and nothing meaningful to record.
@@ -75,6 +92,7 @@ Return a JSON object with these fields:
 Example format:
 ```json
 {
+  "no_changes": false,
   "description": "A woman in her early 30s with olive skin, dark hair pulled back in a ponytail, and an athletic build. She has a small scar above her left eyebrow.",
   "character_profile": "**Name:** {{agentName}}\n\n**Backstory:** [Updated backstory integrating recent events]\n\n**Personality:** [Evolution of traits]\n\n...\n\n**Personal Diary Entry:**\n\n*[Date or chapter reference]*\n\nDear Diary,\n\n[First-person reflection in character's voice]\n\n[Character's signature or closing]",
   "inventory": "## Items\n- Worn leather satchel\n- Brass compass\n- Hunting knife (chipped)\n\n## Conditions\n- Sprained ankle (healing)"

package/data/common/prompts/character/update_portrait.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "name": "update_portrait_response",
+  "description": "Response schema for updating a character's portrait when their appearance has changed",
+  "type": "object",
+  "properties": {
+    "visual_prompt": {
+      "type": "string",
+      "description": "A single cohesive 150-200 word image-editing paragraph describing the character's current appearance, sent directly to the image editing system"
+    },
+    "description": {
+      "type": "string",
+      "description": "A brief 1-2 sentence description containing only immediately observable physical characteristics of the character's current appearance"
+    }
+  },
+  "required": ["visual_prompt", "description"],
+  "additionalProperties": false
+}

package/data/common/prompts/character/update_portrait.mock

@@ -0,0 +1,4 @@
+{
+  "visual_prompt": "A high-quality character portrait showing the character as they appear now, maintaining the original art style and lighting, with subtle changes to attire and expression reflecting recent events.",
+  "description": "A character whose appearance has changed slightly due to recent events."
+}

package/data/common/prompts/character/update_portrait.prompt

@@ -6,6 +6,11 @@ You are updating the portrait of the character {{characterName}} in an interacti
 **Current Character Profile:**
 {{characterProfile}}
 
+**Current Observable Description (their appearance before this change):**
+{{currentDescription}}
+
+Start from this current observable description and adjust only what has changed — don't re-derive the character's whole appearance from scratch.
+
 Your task is to create a detailed visual description of the character as they appear RIGHT NOW. This description will be used to edit their existing portrait image, so focus on their current appearance — including any recent changes — while maintaining the core elements that make the character recognizable.
 
 Focus on these key elements:
@@ -28,4 +33,15 @@ Focus on these key elements:
 
 Create a single, cohesive paragraph (150-200 words) that can be used directly as an image editing prompt. The description should be detailed enough for an AI to accurately update the existing portrait.
 
-Return only the visual description text. Do not include any preamble, commentary, or JSON formatting—just the pure descriptive paragraph that will be sent to the image editing system.
+## Response format
+Return a JSON object with these fields:
+- `visual_prompt`: The single cohesive 150-200 word image-editing paragraph described above. This is sent directly to the image editing system.
+- `description`: A brief 1-2 sentence description of how {{characterName}} looks RIGHT NOW, covering only immediately observable physical characteristics (appearance, attire, visible marks). Start from the "Current Observable Description" above and revise only what changed. Do NOT include art-style, lighting, mood, or camera notes. This becomes the character's short observable description, so keep it concise and plainly descriptive.
+
+Example format:
+```json
+{
+  "visual_prompt": "A weathered man in his 50s, now with a fresh bandage wrapped around his left forearm and a torn, mud-stained jacket ... (150-200 words, image-editing style, including art style and lighting)",
+  "description": "A weathered man in his 50s with a freshly bandaged left forearm and a torn, mud-stained jacket."
+}
+```

package/data/common/prompts/narrator/create_simple_plot.mock

@@ -0,0 +1,13 @@
+## Scenario Overview
+
+A simple test scenario where the characters meet and begin their adventure.
+
+## Setting & Environment
+
+- **Location**: A test room
+- **Atmosphere**: Calm and quiet
+- **Notable Features**: A door and a window
+
+## Situation
+
+The characters are gathered together as the story opens, ready to interact.

package/data/common/prompts/narrator/create_simple_plot.prompt

@@ -0,0 +1,35 @@
+You are creating a simple plot plan for an interactive story titled "{{name}}".
+
+**Story Scenario:**
+{{scenario}}
+
+**Characters:**
+{{#each characters}}
+- **{{name}}**{{#if isControlledByHuman}} (Player Character){{/if}}: {{description}}
+{{/each}}
+
+Your task is to write a short, simple plot plan in markdown format. This plot plan is **FOR YOUR EYES ONLY** - the characters will not see it. You will consult it as you narrate the story.
+
+Unlike a detailed plot plan, this one is deliberately light. Do **not** invent elaborate mysteries, hidden secrets, plot twists, or a list of scripted events. Just establish the setting and premise so the story can unfold naturally from the characters' actions.
+
+## Plot Plan Format:
+Keep it brief - a few short paragraphs total.
+
+### 1. Scenario Overview
+Restate the story scenario above in your own words, capturing the premise and tone.
+
+### 2. Setting & Environment
+- **Location**: Where does the story take place?
+- **Atmosphere**: The mood and a few sensory details (sights, sounds, weather).
+- **Notable Features**: A couple of locations or landmarks worth mentioning.
+
+### 3. Situation
+What is going on as the story opens? What are the characters doing, and what is the immediate circumstance that gets things moving?
+
+## Guidelines:
+- Keep it short and grounded - this is a starting point, not a script.
+- Do not plan out secrets, twists, or scripted events; let the story emerge from character choices.
+- Stay consistent with the scenario and character descriptions above.
+- It is not your role to design the characters. They have their own backstories you know nothing of until they reveal them.
+
+Return a string containing the entire markdown-formatted plot plan.

package/data/common/prompts/narrator/perceive.prompt

@@ -24,6 +24,9 @@ Use this information to guide your narration letting characters discover any sec
 {{visibleArtifacts}}
 ```
 
+### Character Inventories and Conditions
+If a "Character Inventories and Conditions" section is included with the current situation, it lists what each character is currently carrying or wearing and any physical or mental conditions (wounded, exhausted, etc.). Use it to keep your narration consistent — characters can only use items they actually have, and their conditions should shape what they can do. The characters cannot see each other's inventories.
+
 ## Your Role as Narrator
 
 ### When you receive a user message, that means a character is requesting to perform an action and you must narrate both the action and its outcome
@@ -50,10 +53,10 @@ Try to do this when there is a notable pause (end of day) or a significant trans
 ### Introducing a new character
 If a character attempts to talk to or interact with a character who is *not* in the Available Characters list,
 You should:
-- Decide whether or not this character is going to be significant to the story
-- If so, choose a one-word name for that character (which will become their agent name). Prefer a single first name.
+- Choose a one-word name for that character (which will become their agent name). Prefer a single first name.
 - Set `<introduce_character>CharacterName</introduce_character>` so the system can create a new agent for that character.
-- If that character is *not* going to be significant in the story and doesn't need their own character agent, set `<introduce_character>none</introduce_character>` and simply respond with dialog and narration like always.
+- Do this for *every* new character who speaks or is interacted with, even minor ones. It does not matter whether the character is significant to the story - each character gets their own agent so that every character only knows what they would realistically know.
+- Only set `<introduce_character>none</introduce_character>` when no new character speaks or is interacted with in this narration.
 
 ### When you receive a PASS message
 This means the user has decided not to take any particular action, so just continue narrating more of the story.
@@ -103,13 +106,13 @@ The moderator uses this to decide message routing:
 ### `<introduce_character>`
 This is a deliberate decision you must make on every turn. You **must** include reasoning in parentheses, even when the value is `none`.
 
-Choose `none` when no new character agent is needed.
-Choose a single capitalized first name when a character should be promoted to their own agent — see the "Introducing a new character" section above for criteria.
+Choose `none` only when no new character speaks or is interacted with in this narration.
+Choose a single capitalized first name whenever a character who is *not* in the Available Characters list speaks or is interacted with — even minor characters get their own agent.
 
 **Examples:**
-- `<introduce_character>none (the merchant is a one-time interaction, no need for a persistent agent)</introduce_character>`
+- `<introduce_character>none (no new characters speak or are interacted with in this scene)</introduce_character>`
 - `<introduce_character>none (Sergei is mentioned but not present in the scene)</introduce_character>`
-- `<introduce_character>Sergei (the user has spoken with the dock master three times and might feature heavily in the story)</introduce_character>`
+- `<introduce_character>Sergei (the dock master speaks with the user and is not in the Available Characters list)</introduce_character>`
 
 ### `<progress_chapter>`
 This is a deliberate decision you must make on every turn. You **must** include reasoning in parentheses, even when the value is `no`.
@@ -255,13 +258,13 @@ Correct response:
 ```
 <time>10:15</time>
 <situation>Mike is in the museum lobby speaking with the curator for the first time</situation>
-<introduce_character>Benjamin (the museum curator is a knowledge gatekeeper for the artifact plotline and the user has initiated direct dialog with him)</introduce_character>
+<introduce_character>Benjamin (the museum curator speaks with Mike and is not in the Available Characters list)</introduce_character>
 <progress_chapter>no (Mike has just arrived at the museum, the investigation is beginning)</progress_chapter>
 
 That's right. I'm Benjamin Morris, the curator of this museum. What can I do to help you?
 ```
 NOTE: Typically, the narrator only responds to requested actions not dialog, but the Moderator routed this dialog message to the Narrator because that character was not on its Available Characters list.
-If the Narrator decides that this museum curator is going to be central to the story, setting `<introduce_character>Benjamin</introduce_character>` causes a new agent to be created for that character.
+Since the curator is a new character being spoken to, setting `<introduce_character>Benjamin</introduce_character>` causes a new agent to be created for that character, regardless of how significant he turns out to be.
 
 ## Important Reminders
 - **Narrate consequences, not feelings** - describe what happens, what characters sense

package/data/common/prompts/narrator/progress_simple_plot.mock

@@ -0,0 +1,13 @@
+## Story Progress So Far
+
+The characters have moved through the opening events and reached a natural turning point.
+
+## Current Situation
+
+The group is regrouping and deciding what to do next.
+
+## Setting & Environment
+
+- **Current Location**: A test room
+- **Atmosphere**: Calm, with a sense of anticipation
+- **Notable Features**: A door and a window

package/data/common/prompts/narrator/progress_simple_plot.prompt

@@ -0,0 +1,40 @@
+# Progress Simple Plot
+You are updating the simple plot plan for the interactive story as it progresses to the next chapter.
+
+## Current Plot Plan
+{{currentPlotPlan}}
+
+## Recent Story Events
+Refer to the conversation history above for recent events.
+
+## Your Task
+Update the plot plan so it reflects everything that has happened so far in the story. This plot plan is **FOR YOUR EYES ONLY** - the characters will not see it.
+
+Keep it simple. Do **not** invent elaborate mysteries, hidden secrets, plot twists, or a list of scripted events. Just keep the setting and situation current so the story can continue to unfold naturally from the characters' actions.
+
+As you update the plan:
+- **Review what has happened**: Reflect on the recent story events and how they've unfolded.
+- **Update the situation**: Describe where the characters are now and what has changed since the last chapter.
+- **Stay consistent**: Keep the plan consistent with established story facts and character development.
+
+The updated plot plan should include (keep it brief - a few short paragraphs total):
+
+## 1. Story Progress So Far
+A brief summary of the key events that have occurred and how they've shaped the story.
+
+## 2. Current Situation
+What circumstances do the characters find themselves in now? What has changed?
+
+## 3. Setting & Environment
+- **Current Location**: Where are the characters now?
+- **Atmosphere**: The current mood and a few sensory details.
+- **Notable Features**: A couple of locations or landmarks relevant now.
+
+**Important Guidelines:**
+- Keep it short and grounded - this is a starting point for the next chapter, not a script.
+- Do not plan out secrets, twists, or scripted events; let the story emerge from character choices.
+- Ensure consistency with established story facts and character development.
+- **This new plot plan replaces the previous one** - make it self-contained.
+
+## Response format
+Return the entire markdown-formatted updated plot plan as a string.

package/data/common/prompts/perceive.json

@@ -5,7 +5,7 @@
   "properties": {
     "action": {
       "type": "string",
-      "enum": ["think", "whisper", "speak", "shout", "publish", "execute", "adjourn"]
+      "enum": ["think", "whisper", "speak", "shout", "publish", "execute", "commission", "deliver", "adjourn"]
     },
     "targets": {
       "type": "array",

package/data/common/prompts/perceive.prompt

@@ -61,8 +61,12 @@ You must choose ONE of these actions:
 3. **SPEAK** - Normal message that all agents can hear (but always choose one agent to target for a response)
 4. **SHOUT** - Interrupts all other conversations
 5. **PUBLISH** - Create an artifact document that may be shared with other agents
-6. **EXECUTE** - Run a shell command and receive a notification of the results
-7. **ADJOURN** - Used by the group leader when the ultimate room goal has been met
+{{#if availableTools}}
+6. **EXECUTE** - Run one of your available tools and privately receive its result
+{{/if}}
+7. **COMMISSION** - Delegate a task to one or more named agents and wait for their deliverables
+8. **DELIVER** - Submit your completed result when you have been commissioned
+9. **ADJOURN** - Used by the group leader when the ultimate room goal has been met
 
 ## Decision Rules
 
@@ -99,15 +103,43 @@ You must choose ONE of these actions:
 - The 'name' string should contain a descriptive name of the artifact being published
 - The 'name' is used to identify the artifact in the conversation
 
+{{#if availableTools}}
 ### When to EXECUTE
-- When you believe that executing a certain shell command will help achieve the room goal.
+- When running one of your available tools (listed below) would help you answer a question, do research, or achieve the room goal.
 
 #### Execution rules
-- The 'content' of the JSON response should contain the exact string to execute in the shell.
-- The 'targets' array may contain a list of agent names that should receive the results (stdout) of the shell command.
-- If the 'targets' array is empty, only the sender of the EXECUTE message will receive the results.
-- The 'name' string should contain a description of that the shell output represents
-- Each shell command is always executed in the root of the Room's project folder
+- The 'name' string must contain the exact name of the tool to run (from Your Available Tools below).
+- The 'content' of the JSON response must contain a JSON object of named arguments for the tool, e.g. "{\"city\": \"Paris\"}". Use "{}" if the tool takes no arguments.
+- The 'targets' array is not used for EXECUTE; leave it empty.
+- The tool's result is returned privately to you as a system message. No other agent sees it.
+- You may chain multiple EXECUTE and PUBLISH actions in a single turn (do research, then publish findings) before finally responding with an audible action such as SPEAK. The other agents wait until you respond.
+- If a tool fails, you will receive the error and may retry with corrected arguments or give up and respond normally.
+
+#### Your Available Tools
+{{#each availableTools}}
+- **{{this.name}}**: {{this.description}}
+{{#each this.parameters}}
+  - {{this.name}} ({{this.type}}{{#if this.required}}, required{{/if}}): {{this.description}}
+{{/each}}
+{{/each}}
+{{/if}}
+
+### When to COMMISSION
+- When a task would benefit from one or more other agents doing focused work (research, analysis, drafting) before the conversation continues.
+- The commissioned agents each work independently and reply with a DELIVER; you will then receive all of their deliverables at once, before anyone else speaks.
+
+#### Commission rules
+- The 'targets' array must contain the names of the agents you are commissioning (at least one, not yourself).
+- The 'content' should state the task clearly enough that each commissioned agent can work without further clarification.
+- Human-controlled agents cannot be commissioned.
+
+### When to DELIVER
+- ONLY when you have been commissioned and have completed your task. This is the required final action of a commissioned agent.
+- Before delivering, you may use EXECUTE and PUBLISH to do the work.
+
+#### Deliver rules
+- The 'targets' array should contain the name of the agent who commissioned you.
+- The 'content' must contain your complete result. If you published an artifact as part of your work, mention its name here.
 
 ### When to ADJOURN
 - When you believe the goals of the room have been achieved and no further discussion would be helpful
@@ -118,7 +150,7 @@ You must choose ONE of these actions:
 Always respond with this exact JSON structure:
 ```
 {
-  "action": "THINK|WHISPER|SPEAK|SHOUT|PUBLISH|EXECUTE|ADJOURN",
+  "action": "THINK|WHISPER|SPEAK|SHOUT|PUBLISH|EXECUTE|COMMISSION|DELIVER|ADJOURN",
   "targets": ["Message target 1", "Message target 2"],
   "name": "Artifact name",
   "content": "The body of your message"
@@ -127,13 +159,13 @@ Always respond with this exact JSON structure:
 **NOTE**: The 'content' property of the JSON response must be double-quoted. Avoid using double-quotes within the actual content itself.
 
 ## Format Rules
-- `action` must be one of: "THINK", "WHISPER", "SPEAK", "SHOUT", "DRAFT", "APPROVE", "EXECUTE", "ADJOURN"
+- `action` must be one of: "THINK", "WHISPER", "SPEAK", "SHOUT", "PUBLISH", "EXECUTE", "COMMISSION", "DELIVER", "ADJOURN"
 - `targets` must be:
-  - Empty array `[]` for THINK or when speaking to everyone
-  - Array with specific agent names for WHISPER, PUBLISH, and EXECUTE
+  - Empty array `[]` for THINK, EXECUTE, or when speaking to everyone
+  - Array with specific agent names for WHISPER, PUBLISH, COMMISSION, and DELIVER
   - Optional for SPEAK and ADJOURN
-  `content` must contain your actual message or shell command or the body of your published artifact
-  `name` is empty unless publishing an artifact or executing a shell command
+  `content` must contain your actual message, the body of your published artifact, or the JSON arguments of the tool you are executing
+  `name` is empty unless publishing an artifact (artifact name) or executing a tool (tool name)
 
 ## Examples
 
@@ -215,15 +247,45 @@ Correct response:
 }
 ```
 
-**Example 7: Executing a shell command**
-> Alice speaks to {{agentNickname}}: We need to know a bit more about the structure of this project.
+{{#if availableTools}}
+**Example 7: Executing a tool**
+> Alice speaks to {{agentNickname}}: We need to know what the weather will be like in Paris tomorrow.
 
-Correct response:
+Correct response (assuming you have a tool named "weather_lookup" that takes a "city" argument):
 ```
 {
   "action": "execute",
-  "targets": ["Alice", "Bob"],
-  "name": "Directory contents of path/to/something",
-  "content": "ls -al ./path/to/something"
+  "targets": [],
+  "name": "weather_lookup",
+  "content": "{\"city\": \"Paris\"}"
+}
+```
+After you receive the tool result, respond audibly (e.g. SPEAK to Alice with the answer).
+{{/if}}
+
+**Example 8: Commissioning research from other agents**
+> Alice speaks to {{agentNickname}}: We should compare the two proposals before deciding.
+
+Correct response:
+```
+{
+  "action": "commission",
+  "targets": ["Bob", "Carol"],
+  "name": "",
+  "content": "Please each analyze one proposal: Bob takes proposal A, Carol takes proposal B. Summarize strengths, weaknesses, and risks."
+}
+```
+You will receive both deliverables before the conversation continues, and are expected to respond to them.
+
+**Example 9: Delivering a commissioned result**
+> Bob commissions {{agentNickname}}: Please analyze proposal A and summarize its strengths, weaknesses, and risks.
+
+Correct response (after doing the work, possibly using EXECUTE or PUBLISH first):
+```
+{
+  "action": "deliver",
+  "targets": ["Bob"],
+  "name": "",
+  "content": "Proposal A analysis: strengths are... weaknesses are... risks are... Full details in the published artifact 'Proposal A Analysis'."
 }
 ```

package/data/common/prompts/story_moderator/moderate.json

@@ -36,7 +36,7 @@
         },
         "update_inventory": {
           "type": "array",
-          "description": "List of character inventory updates triggered by this message. Each entry replaces the named character's existing '[name] - Inventory' artifact wholesale. Include an entry only when items have actually been gained, lost, consumed, equipped, or when a notable physical/mental trait or condition has changed (wounded, exhausted, intoxicated, transformed, etc.). Leave empty or omit if nothing changed.",
+          "description": "List of character inventory updates triggered by this message. Each entry replaces the named character's existing stored inventory wholesale. Include an entry only when items have actually been gained, lost, consumed, equipped, or when a notable physical/mental trait or condition has changed (wounded, exhausted, intoxicated, transformed, etc.). Leave empty or omit if nothing changed.",
           "items": {
             "type": "object",
             "properties": {