briyah 1.1.8 → 1.2.1

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

@@ -21,6 +21,13 @@ Filter inappropriate language and content from messages.
 ### Human Character Name
 {{humanAgentName}}
 
+### Character Inventories and Conditions
+You have access to each character's `[CharacterName] - Inventory` artifact (visible only to you, the Narrator, and the character themselves). These artifacts list what each character is currently carrying, wearing, or possessing, plus any notable physical or mental conditions (wounded, exhausted, drunk, transformed, etc.). Use these to keep the story self-consistent — when a character refers to "my sword" the inventory should support it, when a character takes damage you should record the wound, etc.
+
+{{#if visibleArtifacts}}
+{{visibleArtifacts}}
+{{/if}}
+
 
 ## Your Task
 Based upon the provided context, determine:
@@ -32,6 +39,13 @@ To accomplish your task:
 - Analyze the Current Situation in the context of the Story Scenario and your (limited) message history
 - Determine whether the Sender of the recent message is trying to 1) perform an action or 2) only participate in dialog
 
+### The Current Situation is authoritative
+The **Current Situation** line is the single source of truth about which characters are physically present in the active scene, and where. When routing:
+- Only characters named in the Current Situation are "present". Other characters are elsewhere and cannot hear or respond unless the Current Situation itself changes.
+- Do **not** infer that a character is present from vague references in the body of a narration (e.g., "the men outside", "the others", "everyone"). If a character is not named in the Current Situation, treat them as absent — pick a different responder.
+- Do **not** assume a scene shift based on body content alone. A scene shift only happens when the Current Situation itself names a different time, place, or set of characters. If the situation still says "Jessica and Mòr in the kitchen", the responder must be one of Jessica, Mòr, or the Narrator — never a character who is miles away in another storyline.
+- If the narration genuinely describes a character who is not in the Current Situation (e.g., a brief aside about someone elsewhere), keep the responder among the characters who ARE in the Current Situation; do not hand the turn off to the absent character.
+
 ### If the Sender is intending to perform an action:
 Route the message to the Narrator.
 The Narrator will interpret the message and narrate the outcome of the action.
@@ -53,11 +67,26 @@ This request will *not* become part of the readable story, only the narrator's r
 3. Responder: The one character you choose to respond next to best maintain the flow of the conversation and further the story.
 4. Targets: List of all characters who would realistically be able to hear the message (even if they shouldn't respond).
 - When processing a message from the Narrator, the targets array should only include characters who are present for the situation being narrated.
-5. Update Portrait: List the names of any characters whose visible appearance has just changed in a way that should be reflected in their portrait image.
-- Include a character's name when the current message describes a meaningful change to their visible appearance: new or different clothing/outfit, significant injury (wounds, blood, bandages), physical transformation, or a notable item they are now visibly carrying or wearing.
-- Use the character's exact name as it appears in the Available Characters list.
-- Leave the array empty if no visible appearance changes occurred.
-- Minor or invisible changes (emotional state alone, unseen actions) do NOT warrant a portrait update.
+5. Changes: An object containing any story state changes triggered by this message.
+- `update_portrait`: list the names of any characters whose visible appearance has just changed in a way that should be reflected in their portrait image.
+  - Include a character's name when the current message describes a meaningful change to their visible appearance: new or different clothing/outfit, significant injury (wounds, blood, bandages), physical transformation, or a notable item they are now visibly carrying or wearing.
+  - Use the character's exact name as it appears in the Available Characters list.
+  - Leave the array empty if no visible appearance changes occurred.
+  - Minor or invisible changes (emotional state alone, unseen actions) do NOT warrant a portrait update.
+- `update_inventory`: list of character inventory artifacts that should be rewritten in light of this message. Each entry replaces the named character's `[Name] - Inventory` artifact in full.
+  - Include an entry when items are gained, lost, consumed, broken, given, taken, equipped, unequipped, OR when a notable physical/mental trait or condition changes (wounded, healed, exhausted, intoxicated, transformed, cursed, blessed, etc.).
+  - The `inventory` field must contain the COMPLETE new inventory body (not a diff). Read the character's current inventory artifact from the context above, apply the change, and return the updated artifact text.
+  - Use this structure (omit a section if it would be empty):
+    ```
+    ## Items
+    - <item 1>
+    - <item 2>
+
+    ## Conditions
+    - <condition 1>
+    ```
+  - Keep it concise — names of items, not flavor prose. Conditions should be short phrases ("wounded right arm", "exhausted").
+  - Leave the array empty if no inventory or condition changes occurred.
 
 ## Content Moderation
 - Do *not* allow profanity or swear words like 'hell', 'shit', and 'damn' or 'damned'.
@@ -73,7 +102,10 @@ You must respond with a valid JSON object in the following format:
   "content": "relay",  // or modified message body
   "name": "CharacterName1",  // Name of character who should respond next
   "targets": ["CharacterName1", "CharacterName2"],  // List of all characters who would realistically be able to hear the message
-  "update_portrait": []  // Names of characters whose visible appearance changed; empty if none
+  "changes": {
+    "update_portrait": [],  // Names of characters whose visible appearance changed; empty if none
+    "update_inventory": []  // Inventory/condition updates; empty if none
+  }
 }
 
 ## Conversation Rules
@@ -86,6 +118,18 @@ You must respond with a valid JSON object in the following format:
 - When a character sends "PASS", route to Narrator with PASS command (relay_silent), or to another contextually appropriate character if the situation calls for it.
 - **Important**:Avoid lengthy conversations that exclude the Human Character completely. Give the Human Character a chance to interact with the story.
 
+### When no character is available to respond — auto-PASS to the Narrator
+Sometimes no character in the Current Situation can realistically be the next speaker. The most common case is when the only present character is asleep, unconscious, dead, paralyzed, in a coma, or otherwise narratively unable to speak or act (check their `[Name] - Inventory` artifact's `## Conditions` section). It can also happen when the Current Situation is a transitional beat with no living character actively present.
+
+In these cases, emit an automatic PASS on the human's behalf, exactly as you would if the Human Character had typed "PASS":
+- Set `name` to `"Narrator"` — the Narrator can always continue the story.
+- Keep `action` as `"relay"` so the original narration is still logged to the readable story.
+- Keep `targets` as the characters who are present in the scene (even if all of them are asleep — they can still "hear" the narration in a passive sense).
+
+The Narrator can always respond and is the safe fallback. Do this whether the unavailable character is the Human Character or an AI character — the rule is about who can speak in the *story*, not about who is at the keyboard.
+
+Note: "Resting", "tired", "lightly intoxicated", "wounded but conscious" are NOT disqualifying — those characters can still respond. The bar is whether they could realistically speak or act in the next beat of the story.
+
 ## Introductions
 - Only set "name" to the exact character name (nickname) of one of the characters in the **Available Characters** list.
 - If a message from the Human Character (or any character) directly addresses someone who is NOT listed in the **Available Characters** list, route the message to the Narrator. The Narrator has access to the secret plot plan and can identify whether the addressed person is a planned character; do NOT guess at a name yourself.
@@ -112,7 +156,7 @@ Correct Response:
   "content": "PASS",
   "name": "Narrator",
   "targets": ["Narrator"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - Mike is choosing not to act or speak, so select another appropriate character (or the narrator) to speak next instead.
 - Use "relay_silent" because PASS is a meta-action and shouldn't appear in the story
@@ -126,7 +170,7 @@ Correct Response:
   "content": "relay",
   "name": "Mike",
   "targets": ["Mike", "Bob"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - According to the current situation, only Mike, Jessica, and Bob are within hearing distance of each other.
 - Jessica is speaking, and only Mike and Bob can hear. Sergei and Carter are not present.
@@ -143,7 +187,7 @@ Correct Response:
   "content": "relay",
   "name": "Jessica",
   "targets": ["Jessica", "Bob"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - According to the current situation, only Mike, Jessica, and Bob are within hearing distance of each other.
 - Mike is speaking, and only Jessica and Bob can hear. Sergei and Carter are not present.
@@ -160,7 +204,7 @@ Correct Response:
   "content": "relay",
   "name": "Narrator",
   "targets": ["Narrator"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - The sender is attempting to perform an action with the message
 - Only the Narrator is able to handle the character's request to perform an action.
@@ -178,7 +222,7 @@ Correct Response:
   "content": "relay",
   "name": "Mike",
   "targets": ["Mike", "Jessica", "Bob"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - This is not dialog and there is no obvious responder, so choose the human character to respond because they are involved in the current situation.
 - All characters involved in the current situation should be targets of the message
@@ -194,13 +238,32 @@ Correct Response:
   "content": "relay",
   "name": "Sergei",
   "targets": ["Sergei", "Carter"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - This is not dialog and there is no obvious responder, so choose an character involved in the current situation to be the responder
 - All characters involved in the current situation should be targets of the message
 - Mike, Jessica, and Bob should not be targets of this message because they are not involved in the situation.
 
 
+### Example 5b: Narration mentions an absent character, but the Current Situation has NOT shifted
+Current Situation: 17:35 - Mike and Jessica are in the kitchen as the evening meal is being prepared
+Recent Message Sender: Narrator
+Recent Message: The kitchen smells of stew and woodsmoke. Outside, the men are tending to the horses. Somewhere else, Sergei is at his cottage that morning, washing at the basin and turning over what he saw the night before.
+Correct Response:
+{
+  "action": "relay",
+  "content": "relay",
+  "name": "Mike",
+  "targets": ["Mike", "Jessica"],
+  "changes": { "update_portrait": [] }
+}
+- The Current Situation places Mike and Jessica in the kitchen — that is authoritative. Sergei is NOT in the Current Situation, even though the narrator mentions him in passing.
+- Do not let the brief reference to Sergei convince you the scene has shifted. A scene shift requires the Current Situation itself to name new characters or a new place.
+- Do not let the phrase "the men" make you pick a named character — "the men" is a vague reference, not a routing instruction.
+- The responder must be a character present in the Current Situation. Mike (the Human Character) is present, so route to Mike.
+- Targets are only the characters in the Current Situation; do not include Sergei or any absent characters.
+
+
 ### Example 6: Character addresses someone not listed in the Available Characters list
 Recent Message Sender: Mike (human character)
 Recent Message: Hello, Albert Flanagan!
@@ -210,7 +273,7 @@ Correct Response:
   "content": "relay",
   "name": "Narrator",
   "targets": ["Narrator"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - "Albert Flanagan" is not in the Available Characters list.
 - Route to the Narrator. The Narrator can consult the plot plan to identify the addressed character (and emit an appropriate INTRODUCE situation) or narrate an alternative response.
@@ -225,7 +288,7 @@ Correct Response:
   "content": "[message content modified to remove explicit content]",
   "name": "Narrator",
   "targets": ["Narrator"],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - If the message contains explicit content, just remove the explicit content if possible or modify the message to something more appropriate.
 
@@ -238,37 +301,120 @@ Correct Response:
   "content": "relay",
   "name": "",
   "targets": [],
-  "update_portrait": []
+  "changes": { "update_portrait": [] }
 }
 - Use the relay_silent action and leave the name field blank and set the targets list to an empty array.
 - The message will be silently relayed to the Narrator to perform the introduction.
 
 
-### Example 9: Narrator describes a visible appearance change
+### Example 9: Narrator describes a visible appearance change (and a wound)
 Recent Message Sender: Narrator
 Recent Message: The arrow grazes Jessica's arm, tearing her sleeve and leaving a bloody gash. She wraps a strip of cloth around the wound and keeps moving.
+Suppose Jessica's existing inventory is:
+  ## Items
+  - Hunting bow
+  - Quiver with 7 arrows
+  - Hunting knife
 Correct Response:
 {
   "action": "relay",
   "content": "relay",
   "name": "Mike",
   "targets": ["Mike", "Jessica", "Bob"],
-  "update_portrait": ["Jessica"]
+  "changes": {
+    "update_portrait": ["Jessica"],
+    "update_inventory": [
+      {
+        "characterName": "Jessica",
+        "inventory": "## Items\n- Hunting bow\n- Quiver with 7 arrows\n- Hunting knife\n\n## Conditions\n- Wounded right arm (bandaged)"
+      }
+    ]
+  }
 }
 - Jessica's visible appearance has changed (torn sleeve, wound, makeshift bandage), so her portrait should be updated.
+- A wound is a condition worth tracking in her inventory artifact. Carry forward her existing items unchanged, and add the new condition.
 - All characters present in the current situation are targets.
 
 
-### Example 10: Character action with no visible change
+### Example 10: Character action with no visible change (item gained)
 Recent Message Sender: Bob
 Recent Message: Bob wields his new sword proudly above his head
+Suppose Bob's existing inventory is:
+  ## Items
+  - Bedroll
+  - Tinderbox
 Correct Response:
 {
   "action": "relay_silent",
   "content": "relay",
   "name": "Narrator",
   "targets": ["Narrator"],
-  "update_portrait": ["Bob"]
+  "changes": {
+    "update_portrait": ["Bob"],
+    "update_inventory": [
+      {
+        "characterName": "Bob",
+        "inventory": "## Items\n- Bedroll\n- Tinderbox\n- Iron sword"
+      }
+    ]
+  }
+}
+- Bob just got a new weapon, so it should appear in his portrait AND be added to his inventory items.
+- The inventory field carries the FULL updated artifact body, not just the new item.
+
+
+### Example 11: Pure inventory change with no visual update
+Recent Message Sender: Narrator
+Recent Message: Mike takes a long pull from the whiskey flask. The warmth spreads through his chest as the world softens at the edges.
+Suppose Mike's existing inventory is:
+  ## Items
+  - Whiskey flask (3/4 full)
+  - Wool blanket
+Correct Response:
+{
+  "action": "relay",
+  "content": "relay",
+  "name": "Mike",
+  "targets": ["Mike", "Jessica", "Bob"],
+  "changes": {
+    "update_portrait": [],
+    "update_inventory": [
+      {
+        "characterName": "Mike",
+        "inventory": "## Items\n- Whiskey flask (1/2 full)\n- Wool blanket\n\n## Conditions\n- Lightly intoxicated"
+      }
+    ]
+  }
+}
+- Mike consumed some whiskey, so the flask amount decreased and he is now mildly drunk.
+- No visible appearance change, so update_portrait is empty.
+
+
+### Example 12: No character available to respond — auto-PASS to Narrator
+Current Situation: 23:50 - Jessica is alone in the small side room at Balmore, having just settled in for the night
+Suppose Jessica's inventory is:
+  ## Items
+  - Wool blanket
+  - Water avens root (wrapped in cloth)
+
+  ## Conditions
+  - Asleep
+Recent Message Sender: Narrator
+Recent Message: The wind softens to a hush against the shutter. Jessica's breathing slows and evens. The candle gutters once, then steadies, throwing long shadows on the wattle wall.
+Correct Response:
+{
+  "action": "relay",
+  "content": "relay",
+  "name": "Narrator",
+  "targets": ["Jessica"],
+  "changes": {
+    "update_portrait": [],
+    "update_inventory": []
+  }
 }
-- Bob just got a new weapon (or other visible item) that we would want to include in his portrait.
+- Jessica is the only character in the scene, but her conditions say **Asleep** — she cannot speak or act in the story right now. There is no one to respond.
+- Auto-PASS to the **Narrator** by setting `name` to "Narrator". The Narrator can always continue the story — transition to the next scene, advance time, cut to another character, etc.
+- Keep `action: "relay"` so the narrator's atmospheric narration is still logged to the readable story.
+- Jessica stays in `targets` because she's physically present in the scene (and could be woken later), but she is NOT the responder `name`.
+- "Asleep" is already in her conditions; no inventory update needed.
 

package/dist-sdk/server/src/ai/LLM/anthropic.service.d.ts

@@ -1,7 +1,8 @@
 import { Anthropic } from '@anthropic-ai/sdk';
 import { Agent } from '../agent';
 import { BaseAiService } from './base-ai.service';
-import { ConfigurationService } from '../../config/configuration.service';
+import { UserPathsService } from '../../config/user-paths.service';
+import { IConfigService } from '../../config/env-config';
 import { AgentStoreService } from '../agent-store.service';
 import { BalanceService } from '../../app/balance.service';
 import { ArtifactService } from '../artifact.service';
@@ -9,7 +10,7 @@ import { ModelInfo } from '../../../../shared/types/app.types';
 export declare class AnthropicAiService extends BaseAiService {
     protected anthropic: Anthropic;
     constructor();
-    createAgent(configService: ConfigurationService, agentStoreService: AgentStoreService, balanceService: BalanceService, artifactService: ArtifactService, agentName: string, agentNickname: string, description: string, promptFolder: string, modelName: string, storageDir?: string): Agent;
+    createAgent(userPaths: UserPathsService, configService: IConfigService, agentStoreService: AgentStoreService, balanceService: BalanceService, artifactService: ArtifactService, agentName: string, agentNickname: string, description: string, promptFolder: string, modelName: string, storageDir?: string): Agent;
     getServiceName(): string;
     supportsImageGeneration(): boolean;
     supportsPromptCaching(): boolean;
@@ -23,5 +24,7 @@ export declare class AnthropicAiService extends BaseAiService {
     fetchModelsFromApi(): Promise<ModelInfo[]>;
     addToConversationHistory(agent: Agent, message: string, fromSelf?: boolean): void;
     textPrompt(agent: Agent, prompt: string, jsonSchema?: any, saveResponse?: boolean, promptInstructions?: string, cacheConfig?: any, maxOutputChars?: number): Promise<any>;
+    private static readonly EFFORT_CONFIG_MODEL_VERSIONS;
+    private usesEffortConfig;
     private computeMessageCost;
 }

package/dist-sdk/server/src/ai/LLM/anthropic.service.js

@@ -8,6 +8,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var AnthropicAiService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AnthropicAiService = void 0;
 const common_1 = require("@nestjs/common");
@@ -17,6 +18,7 @@ const model_prices_1 = require("../model_prices");
 const errors_1 = require("../../common/errors");
 const logger_1 = require("../../common/logger");
 let AnthropicAiService = class AnthropicAiService extends base_ai_service_1.BaseAiService {
+    static { AnthropicAiService_1 = this; }
     anthropic;
     constructor() {
         super();
@@ -38,8 +40,8 @@ let AnthropicAiService = class AnthropicAiService extends base_ai_service_1.Base
             this._isAvailable = false;
         }
     }
-    createAgent(configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, modelName, storageDir = '') {
-        let agent = super.createAgent(configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, modelName, storageDir);
+    createAgent(userPaths, configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, modelName, storageDir = '') {
+        let agent = super.createAgent(userPaths, configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, modelName, storageDir);
         agent.promptCacheTTL = 5;
         return agent;
     }
@@ -211,32 +213,38 @@ let AnthropicAiService = class AnthropicAiService extends base_ai_service_1.Base
             max_tokens: maxOutputTokens,
             tools: tools.length > 0 ? tools : undefined,
         };
-        if (agent.modelName.includes('4-7')) {
-            createParams.temperature = 1;
-            createParams.thinking = { type: 'adaptive' };
-            createParams.output_config = { effort: agent.reasoningEffort };
+        if (this.usesEffortConfig(agent.modelName)) {
+            if (agent.reasoningEffort) {
+                createParams.thinking = { type: 'adaptive' };
+                createParams.output_config = { effort: agent.reasoningEffort };
+            }
+        }
+        else if (thinkingTokens > 0) {
+            createParams.thinking = { type: 'enabled', budget_tokens: thinkingTokens };
         }
         else {
-            if (thinkingTokens > 0) {
-                createParams.thinking = { type: 'enabled', budget_tokens: thinkingTokens };
-            }
-            else {
-                createParams.thinking = { type: 'disabled' };
-                createParams.temperature = 0;
-            }
+            createParams.thinking = { type: 'disabled' };
+            createParams.temperature = 0;
         }
+        this.debugLogRequest(agent.agentName, createParams);
         for (let attempt = 1; attempt <= maxRetries; attempt++) {
             try {
                 const response = await this.anthropic.messages.create(createParams);
+                let thinkingText = '';
                 let responseText = '';
                 if (response.content && response.content.length > 0) {
                     for (let i = 0; i < response.content.length; i++) {
                         const content = response.content[i];
-                        if ('text' in content) {
+                        if (content.type === 'thinking' && 'thinking' in content) {
+                            thinkingText += content.thinking;
+                        }
+                        else if ('text' in content) {
                             responseText += content.text;
                         }
                     }
                 }
+                this.debugLogThinking(agent.agentName, thinkingText);
+                this.debugLogResponse(agent.agentName, responseText);
                 if (jsonSchema) {
                     responseText = this.trimToJson(responseText);
                     responseText = this.sanitizeJsonString(responseText);
@@ -308,6 +316,10 @@ let AnthropicAiService = class AnthropicAiService extends base_ai_service_1.Base
         }
         throw new Error(`Failed to get valid response after ${maxRetries} attempts. Last error: ${lastError?.message || 'Unknown error'}`);
     }
+    static EFFORT_CONFIG_MODEL_VERSIONS = ['4-7', '4-8'];
+    usesEffortConfig(modelName) {
+        return AnthropicAiService_1.EFFORT_CONFIG_MODEL_VERSIONS.some((v) => modelName.includes(v));
+    }
     computeMessageCost(agent, usage) {
         const modelInfo = (0, model_prices_1.getModelPrices)()[agent.modelName];
         if (!modelInfo) {
@@ -340,7 +352,7 @@ let AnthropicAiService = class AnthropicAiService extends base_ai_service_1.Base
     }
 };
 exports.AnthropicAiService = AnthropicAiService;
-exports.AnthropicAiService = AnthropicAiService = __decorate([
+exports.AnthropicAiService = AnthropicAiService = AnthropicAiService_1 = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [])
 ], AnthropicAiService);

package/dist-sdk/server/src/ai/LLM/base-ai.service.d.ts

@@ -1,5 +1,6 @@
 import { Agent } from '../agent';
-import { ConfigurationService } from '../../config/configuration.service';
+import { UserPathsService } from '../../config/user-paths.service';
+import { IConfigService } from '../../config/env-config';
 import { ArtifactService } from '../artifact.service';
 import { AgentStoreService } from '../agent-store.service';
 import { BalanceService } from '../../app/balance.service';
@@ -20,7 +21,7 @@ export declare class BaseAiService {
     protected getPreparedSchema(agent: Agent, promptFileName: string): any;
     listModels(): Promise<ModelInfo[]>;
     protected fetchModelsFromApi(): Promise<ModelInfo[]>;
-    createAgent(configService: ConfigurationService, agentStoreService: AgentStoreService, balanceService: BalanceService, artifactService: ArtifactService, agentName: string, agentNickname: string, description: string, promptFolder: string, modelName: string, storageDir?: string): Agent;
+    createAgent(userPaths: UserPathsService, configService: IConfigService, agentStoreService: AgentStoreService, balanceService: BalanceService, artifactService: ArtifactService, agentName: string, agentNickname: string, description: string, promptFolder: string, modelName: string, storageDir?: string): Agent;
     textPrompt(agent: Agent, prompt: string, _jsonSchema?: any, _saveResponse?: boolean, _promptInstructions?: string, _cacheConfig?: any, _maxOutputChars?: number): Promise<any>;
     generateImage(_agent: Agent, _prompt: string, _imageProperties?: Record<string, any>): Promise<{
         artifactId?: string;
@@ -38,6 +39,9 @@ export declare class BaseAiService {
     finishAgent(_agent: Agent): Promise<void>;
     addToConversationHistory(agent: Agent, message: string, fromSelf?: boolean, developer?: boolean): void;
     formatMessage(message: any): string;
+    protected debugLogRequest(agentName: string, content: unknown): void;
+    protected debugLogThinking(agentName: string, thinking: string): void;
+    protected debugLogResponse(agentName: string, response: string): void;
     trimResponseText(str: string): string;
     trimToJson(str: string): string;
     sanitizeJsonString(str: string): string;

package/dist-sdk/server/src/ai/LLM/base-ai.service.js

@@ -52,6 +52,7 @@ const handlebars_1 = require("handlebars");
 const errors_1 = require("../../common/errors");
 const logger_1 = require("../../common/logger");
 const model_prices_1 = require("../model_prices");
+const ai_debug_logger_1 = require("../ai-debug-logger");
 let BaseAiService = class BaseAiService {
     modelsCache = null;
     _isAvailable = true;
@@ -78,15 +79,15 @@ let BaseAiService = class BaseAiService {
         return quotedText.replace(/^['"]+|['"]+$/g, '');
     }
     findPromptFile(agent, fileName, extension) {
-        const configService = agent.configService;
-        if (!configService) {
-            throw new Error('Agent configService is not set');
+        const userPaths = agent.userPaths;
+        if (!userPaths) {
+            throw new Error('Agent userPaths is not set');
         }
         const searchPaths = [
-            path.join(configService.getUserPromptsDir(), agent.promptFolder, `${fileName}${extension}`),
-            path.join(configService.getUserPromptsDir(), `${fileName}${extension}`),
-            path.join(configService.getCommonPromptsDir(), agent.promptFolder, `${fileName}${extension}`),
-            path.join(configService.getCommonPromptsDir(), `${fileName}${extension}`),
+            path.join(userPaths.getUserPromptsDir(), agent.promptFolder, `${fileName}${extension}`),
+            path.join(userPaths.getUserPromptsDir(), `${fileName}${extension}`),
+            path.join(userPaths.getCommonPromptsDir(), agent.promptFolder, `${fileName}${extension}`),
+            path.join(userPaths.getCommonPromptsDir(), `${fileName}${extension}`),
         ];
         for (const filePath of searchPaths) {
             if (fs.existsSync(filePath)) {
@@ -141,7 +142,7 @@ let BaseAiService = class BaseAiService {
     async fetchModelsFromApi() {
         throw new Error('fetchModelsFromApi method not implemented in base class');
     }
-    createAgent(configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, modelName, storageDir = '') {
+    createAgent(userPaths, configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, modelName, storageDir = '') {
         if (!this.isAvailable) {
             throw new Error(`${this.getServiceName()} service is not available. Check API key configuration.`);
         }
@@ -156,7 +157,7 @@ let BaseAiService = class BaseAiService {
             throw new Error(`Model '${modelName}' is not listed in model_prices.json for ${this.getServiceName()}. ` +
                 `Add a pricing entry before using this model.`);
         }
-        const tempAgent = { promptFolder, configService };
+        const tempAgent = { promptFolder, userPaths };
         const systemInstructionFile = this.findPromptFile(tempAgent, 'system_instruction', '.prompt');
         let systemInstructionPrompt = null;
         if (systemInstructionFile) {
@@ -168,7 +169,7 @@ let BaseAiService = class BaseAiService {
                 systemInstructionPrompt = null;
             }
         }
-        const agent = new agent_1.Agent(null, configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, systemInstructionPrompt, [], modelName, this.getServiceName(), this, null, false, 0, '', storageDir);
+        const agent = new agent_1.Agent(null, userPaths, configService, agentStoreService, balanceService, artifactService, agentName, agentNickname, description, promptFolder, systemInstructionPrompt, [], modelName, this.getServiceName(), this, null, false, 0, '', storageDir);
         return agent;
     }
     async textPrompt(agent, prompt, _jsonSchema = null, _saveResponse = true, _promptInstructions = null, _cacheConfig = null, _maxOutputChars = 0) {
@@ -314,6 +315,15 @@ let BaseAiService = class BaseAiService {
         }
         return JSON.stringify(message);
     }
+    debugLogRequest(agentName, content) {
+        ai_debug_logger_1.AiDebugLogger.writeRequest(agentName, content);
+    }
+    debugLogThinking(agentName, thinking) {
+        ai_debug_logger_1.AiDebugLogger.writeThinking(agentName, thinking);
+    }
+    debugLogResponse(agentName, response) {
+        ai_debug_logger_1.AiDebugLogger.writeResponse(agentName, response);
+    }
     trimResponseText(str) {
         if (!str) {
             return str;

package/dist-sdk/server/src/ai/LLM/deepseek.service.js

@@ -187,6 +187,13 @@ let DeepSeekAiService = class DeepSeekAiService extends base_ai_service_1.BaseAi
             });
         }
         let reasoningEffort = agent.reasoningEffort ? agent.reasoningEffort : undefined;
+        const requestParams = {
+            model: agent.modelName,
+            messages: messages,
+            temperature: 0,
+            reasoningEffort: reasoningEffort,
+        };
+        this.debugLogRequest(agent.agentName, requestParams);
         try {
             if (jsonSchema) {
                 const result = await (0, ai_1.generateObject)({
@@ -203,6 +210,7 @@ let DeepSeekAiService = class DeepSeekAiService extends base_ai_service_1.BaseAi
                 if (result.usage) {
                     this.computeMessageCost(agent, result.usage);
                 }
+                this.debugLogResponse(agent.agentName, JSON.stringify(result.object, null, 2));
                 if (saveResponse) {
                     this.addToConversationHistory(agent, prompt, false);
                     this.addToConversationHistory(agent, JSON.stringify(result.object), true);
@@ -223,6 +231,8 @@ let DeepSeekAiService = class DeepSeekAiService extends base_ai_service_1.BaseAi
                 if (result.usage) {
                     this.computeMessageCost(agent, result.usage);
                 }
+                this.debugLogThinking(agent.agentName, result.reasoning ?? '');
+                this.debugLogResponse(agent.agentName, result.text);
                 if (saveResponse) {
                     this.addToConversationHistory(agent, prompt, false);
                     this.addToConversationHistory(agent, result.text, true);

package/dist-sdk/server/src/ai/LLM/googleai.service.js

@@ -110,16 +110,18 @@ let GoogleAiService = class GoogleAiService extends base_ai_service_1.BaseAiServ
             generationConfig.responseSchema = schemaOnly;
         }
         const instructions = promptInstructions || agent.systemInstruction;
+        const requestParams = {
+            model: agent.modelName,
+            contents: messages,
+            config: {
+                systemInstruction: instructions,
+                ...generationConfig,
+            },
+        };
+        this.debugLogRequest(agent.agentName, requestParams);
         let responseText;
         try {
-            const response = await this.googleAI.models.generateContent({
-                model: agent.modelName,
-                contents: messages,
-                config: {
-                    systemInstruction: instructions,
-                    ...generationConfig,
-                },
-            });
+            const response = await this.googleAI.models.generateContent(requestParams);
             if (response.text) {
                 responseText = response.text;
             }
@@ -136,6 +138,7 @@ let GoogleAiService = class GoogleAiService extends base_ai_service_1.BaseAiServ
             else {
                 responseText = this.trimResponseText(responseText);
             }
+            this.debugLogResponse(agent.agentName, responseText);
             if (response.usageMetadata) {
                 this.computeMessageCost(agent, response.usageMetadata);
             }

package/dist-sdk/server/src/ai/LLM/grok.service.js

@@ -179,13 +179,15 @@ let GrokAiService = class GrokAiService extends base_ai_service_1.BaseAiService
                 content: [{ type: 'text', text: prompt }],
             });
         }
+        const requestParams = {
+            model: agent.modelName,
+            messages: messages,
+            store: false,
+        };
+        this.debugLogRequest(agent.agentName, requestParams);
         let responseText;
         try {
-            let response = await this.openai.chat.completions.create({
-                model: agent.modelName,
-                messages: messages,
-                store: false,
-            });
+            let response = await this.openai.chat.completions.create(requestParams);
             for (const choice of response.choices) {
                 if (choice.message.content)
                     responseText = choice.message.content;
@@ -194,6 +196,7 @@ let GrokAiService = class GrokAiService extends base_ai_service_1.BaseAiService
                 responseText = this.trimToJson(responseText);
                 responseText = this.sanitizeJsonString(responseText);
             }
+            this.debugLogResponse(agent.agentName, responseText);
             if (response.usage) {
                 this.computeMessageCost(agent, response.usage);
             }