@siduri-x/brain 2.0.7 → 2.0.10

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BrainOrgan, BrainContext, ResponsePlan } from '@siduri-x/core';
+import { BrainOrgan, BrainContext, ResponsePlan, RetrievalPlan, RequestContext } from '@siduri-x/core';
 export interface OpenAICompatibleBrainConfig {
     apiKey?: string;
     apiKeyEnv?: string;
@@ -24,6 +24,10 @@ export declare class OpenAICompatibleBrain implements BrainOrgan {
     protected resolvedApiKey: string;
     constructor(config: OpenAICompatibleBrainConfig);
     generatePlan(context: BrainContext): Promise<ResponsePlan>;
+    planRetrieval(text: string, context?: RequestContext, recentHistory?: {
+        role: string;
+        content: string;
+    }[]): Promise<RetrievalPlan>;
 }
 export declare class OpenRouterBrain extends OpenAICompatibleBrain {
     constructor(config: OpenRouterBrainConfig);

package/dist/index.js

@@ -312,6 +312,75 @@ class OpenAICompatibleBrain {
             clearTimeout(overallTimer);
         }
     }
+    async planRetrieval(text, context, recentHistory) {
+        const defaultResponse = {
+            shouldQueryKnowledge: undefined,
+            knowledgeQueries: [],
+            shouldQueryMemory: undefined,
+            memoryQueries: [],
+        };
+        if (!text || !text.trim() || !this.resolvedApiKey) {
+            return defaultResponse;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 6000);
+        let historyContext = '';
+        if (recentHistory && recentHistory.length > 0) {
+            const recentTurns = recentHistory
+                .slice(-4)
+                .map((m) => `${m.role}: ${m.content}`)
+                .join('\n');
+            historyContext = `\n\nRecent conversation context:\n${recentTurns}\nIf the current user message uses pronouns (she, he, it, they) or refers to previously mentioned entities (e.g. 'where is she coming to banner?'), resolve the pronoun to the specific entity name from context (e.g. ['Sandrone banner']).`;
+        }
+        try {
+            const response = await fetch(`${this.config.baseUrl.replace(/\/+$/, '')}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Authorization": `Bearer ${this.resolvedApiKey || this.config.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    model: this.config.model,
+                    messages: [
+                        {
+                            role: "system",
+                            content: `You are an agentic query planning module for a companion. Analyze the user message.\nDecide:\n1. shouldQueryKnowledge (boolean): does this message ask about external world facts, domain documentation, fictional/real universe entities, lore, timelines, or specifications? (False if greeting, self-identity of the companion, or personal small talk).\n2. knowledgeQueries (string[]): 1-2 focused keyword queries of the specific entity, topic, or subject name (e.g. 'Sandrone', or with topic qualifier like 'Sandrone banner'; strictly remove companion mentions, greetings, and conversational fluff like 'who is', 'tell me about', 'what is').\n3. shouldQueryMemory (boolean): does this message ask about user identity, past conversation history, or shared facts?\n4. memoryQueries (string[]): 1-2 focused query keywords for episodic memory.${historyContext}\nRespond strictly in JSON format: {"shouldQueryKnowledge": boolean, "knowledgeQueries": string[], "shouldQueryMemory": boolean, "memoryQueries": string[]}`,
+                        },
+                        {
+                            role: "user",
+                            content: text,
+                        },
+                    ],
+                    response_format: { type: "json_object" },
+                    max_tokens: 150,
+                    temperature: 0,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                return defaultResponse;
+            }
+            const data = await response.json();
+            const content = data?.choices?.[0]?.message?.content;
+            if (content) {
+                const parsed = JSON.parse(content);
+                return {
+                    shouldQueryKnowledge: typeof parsed.shouldQueryKnowledge === 'boolean' ? parsed.shouldQueryKnowledge : undefined,
+                    knowledgeQueries: Array.isArray(parsed.knowledgeQueries) ? parsed.knowledgeQueries.filter((q) => typeof q === 'string' && q.trim()) : [],
+                    shouldQueryMemory: typeof parsed.shouldQueryMemory === 'boolean' ? parsed.shouldQueryMemory : undefined,
+                    memoryQueries: Array.isArray(parsed.memoryQueries) ? parsed.memoryQueries.filter((q) => typeof q === 'string' && q.trim()) : [],
+                    reasoning: parsed.reasoning,
+                };
+            }
+        }
+        catch {
+            // Fallback to heuristic extraction
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        return defaultResponse;
+    }
 }
 exports.OpenAICompatibleBrain = OpenAICompatibleBrain;
 class OpenRouterBrain extends OpenAICompatibleBrain {

package/dist/index.test.js

@@ -171,7 +171,7 @@ describe('PromptAssembler', () => {
             contextPrompt: "Memories: none",
             recentMessages: []
         });
-        expect(res.messages[0].content).toContain("[SIDURI TRUSTED SYSTEM CONTEXT]");
+        expect(res.messages[0].content).toContain("[COMPANION TRUSTED SYSTEM CONTEXT]");
         expect(res.messages[0].content).toContain("I am Ganyu");
         expect(res.messages[1].content).toContain("[CONTEXTUAL AWARENESS]");
         expect(res.messages[1].content).toContain("Memories: none");

package/dist/prompt-matrix.test.js

@@ -13,7 +13,7 @@ describe('T3 Prompt Section Matrix Contract Suite', () => {
         const ctx = assembler.contextPrompt(context);
         const assembled = assembler.assemble(context);
         // Assertions of required sections
-        expect(sys).toContain('[SIDURI TRUSTED SYSTEM CONTEXT]');
+        expect(sys).toContain('[COMPANION TRUSTED SYSTEM CONTEXT]');
         expect(sys).toContain('[IDENTITY NUCLEUS]');
         expect(sys).toContain('You are NeutralCompanion.');
         expect(sys).toContain('[IMMUTABLE RUNTIME RULES]');
@@ -31,7 +31,7 @@ describe('T3 Prompt Section Matrix Contract Suite', () => {
         };
         const sys = assembler.systemPrompt(context);
         const ctx = assembler.contextPrompt(context);
-        const idxSysCtx = sys.indexOf('[SIDURI TRUSTED SYSTEM CONTEXT]');
+        const idxSysCtx = sys.indexOf('[COMPANION TRUSTED SYSTEM CONTEXT]');
         const idxIdentity = sys.indexOf('[IDENTITY NUCLEUS]');
         const idxRules = sys.indexOf('[IMMUTABLE RUNTIME RULES]');
         expect(idxSysCtx).toBeLessThan(idxIdentity);

package/dist/prompt.js

@@ -4,7 +4,7 @@ exports.PromptAssembler = void 0;
 class PromptAssembler {
     systemPrompt(context) {
         const parts = [
-            "[SIDURI TRUSTED SYSTEM CONTEXT]",
+            "[COMPANION TRUSTED SYSTEM CONTEXT]",
             "[IDENTITY NUCLEUS]",
             context.systemPrompt, // Core neutral identity config and compiled active self
             "[IMMUTABLE RUNTIME RULES]",

package/organ-manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "@siduri-x/brain",
   "organType": "brain",
-  "version": "2.0.5",
+  "version": "2.0.10",
   "displayName": "Brain (Cognition & Planning)",
   "description": "Provider-neutral LLM reasoning, response planning, and proposal generation",
   "entrypoint": "./dist/index.js",

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@siduri-x/brain",
-  "version": "2.0.7",
+  "version": "2.0.10",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
     "zod": "^4.6.2",
-    "@siduri-x/core": "2.0.11"
+    "@siduri-x/core": "2.0.13"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",