@siduri-x/brain 2.0.0 → 2.0.2

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { BrainOrgan, BrainContext, ResponsePlan } from '@siduri-x/core';
 export interface OpenAICompatibleBrainConfig {
-    apiKey: string;
+    apiKey?: string;
+    apiKeyEnv?: string;
     model: string;
     baseUrl: string;
     timeoutMs?: number;
@@ -9,7 +10,8 @@ export interface OpenAICompatibleBrainConfig {
     maxBackoffMs?: number;
 }
 export interface OpenRouterBrainConfig {
-    apiKey: string;
+    apiKey?: string;
+    apiKeyEnv?: string;
     model: string;
     timeoutMs?: number;
     maxRetries?: number;
@@ -19,6 +21,7 @@ export interface OpenRouterBrainConfig {
 export declare class OpenAICompatibleBrain implements BrainOrgan {
     private config;
     private assembler;
+    protected resolvedApiKey: string;
     constructor(config: OpenAICompatibleBrainConfig);
     generatePlan(context: BrainContext): Promise<ResponsePlan>;
 }

package/dist/index.js

@@ -25,7 +25,10 @@ const MemoryProposalSchema = zod_1.z.object({
 });
 const BehaviorProposalSchema = zod_1.z.object({
     directive: zod_1.z.string(),
-    priority: zod_1.z.number(),
+    category: zod_1.z.enum(['guardrail', 'relational', 'behavioral']).optional(),
+    scopeActor: zod_1.z.string().optional(),
+    supersedesId: zod_1.z.string().optional(),
+    priority: zod_1.z.number().optional(),
 });
 const ActionIntentSchema = zod_1.z.object({
     actionId: zod_1.z.string(),
@@ -36,6 +39,8 @@ const ActionIntentSchema = zod_1.z.object({
 const ResponsePlanSchema = zod_1.z.object({
     speech: zod_1.z.string(),
     language: zod_1.z.string(),
+    subtitle: zod_1.z.string().optional(),
+    subtitles: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
     internalMonologue: zod_1.z.string().optional(),
     memoryProposals: zod_1.z.array(MemoryProposalSchema).optional(),
     behaviorProposals: zod_1.z.array(BehaviorProposalSchema).optional(),
@@ -44,9 +49,18 @@ const ResponsePlanSchema = zod_1.z.object({
 class OpenAICompatibleBrain {
     config;
     assembler;
+    resolvedApiKey;
     constructor(config) {
         this.config = config;
         this.assembler = new prompt_1.PromptAssembler();
+        const defaultEnv = config.baseUrl && !config.baseUrl.includes('openrouter.ai')
+            ? 'OPENAI_COMPATIBLE_API_KEY'
+            : 'OPENROUTER_API_KEY';
+        const envKey = config.apiKeyEnv || defaultEnv;
+        this.resolvedApiKey = config.apiKey || (typeof process !== 'undefined' && process.env ? (process.env[envKey] || '') : '') || '';
+        if (!this.config.apiKey && this.resolvedApiKey) {
+            this.config = { ...this.config, apiKey: this.resolvedApiKey };
+        }
     }
     async generatePlan(context) {
         const { messages } = this.assembler.assemble(context);
@@ -61,6 +75,7 @@ class OpenAICompatibleBrain {
                         properties: {
                             speech: { type: "string", description: "The text that the companion will speak." },
                             language: { type: "string", description: "The primary language of the speech (e.g., 'en', 'ja', 'id')." },
+                            subtitle: { type: "string", description: "Optional translation or subtitle of speech in the requested subtitle language." },
                             internalMonologue: { type: "string", description: "Internal reasoning before responding." },
                             memoryProposals: {
                                 type: "array",
@@ -79,10 +94,13 @@ class OpenAICompatibleBrain {
                                 items: {
                                     type: "object",
                                     properties: {
-                                        directive: { type: "string" },
-                                        priority: { type: "number" }
+                                        directive: { type: "string", description: "The natural language behavioral, guardrail, or relational rule." },
+                                        category: { type: "string", enum: ["guardrail", "relational", "behavioral"], description: "Category tier of the directive." },
+                                        scopeActor: { type: "string", description: "Optional specific actor this rule applies to (e.g. 'actor:zagin')." },
+                                        supersedesId: { type: "string", description: "Optional ID of an older directive this rule replaces." },
+                                        priority: { type: "number", description: "Optional legacy priority rank." }
                                     },
-                                    required: ["directive", "priority"]
+                                    required: ["directive"]
                                 }
                             },
                             actionIntents: {
@@ -125,7 +143,7 @@ class OpenAICompatibleBrain {
                     const response = await fetch(`${this.config.baseUrl.replace(/\/+$/, '')}/chat/completions`, {
                         method: "POST",
                         headers: {
-                            "Authorization": `Bearer ${this.config.apiKey}`,
+                            "Authorization": `Bearer ${this.resolvedApiKey || this.config.apiKey}`,
                             "Content-Type": "application/json",
                         },
                         body: JSON.stringify({
@@ -196,7 +214,9 @@ class OpenAICompatibleBrain {
 exports.OpenAICompatibleBrain = OpenAICompatibleBrain;
 class OpenRouterBrain extends OpenAICompatibleBrain {
     constructor(config) {
-        super({ ...config, baseUrl: 'https://openrouter.ai/api/v1' });
+        const apiKeyEnv = config.apiKeyEnv || 'OPENROUTER_API_KEY';
+        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env ? (process.env[apiKeyEnv] || process.env.OPENROUTER_API_KEY || '') : '') || '';
+        super({ ...config, baseUrl: 'https://openrouter.ai/api/v1', apiKey, apiKeyEnv });
     }
 }
 exports.OpenRouterBrain = OpenRouterBrain;

package/organ-manifest.json

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

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@siduri-x/brain",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "zod": "^4.4.3",
-    "@siduri-x/core": "2.0.0"
+    "zod": "^4.6.2",
+    "@siduri-x/core": "2.0.4"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.19.43",
-    "jest": "^29.7.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.20.2",
+    "jest": "^30.5.1",
     "ts-jest": "^29.4.12",
-    "typescript": "^5.3.3"
+    "typescript": "^5.9.3"
   },
   "description": "Brain organ for LLM reasoning, response planning, and proposal generation",
   "license": "Apache-2.0",
@@ -25,7 +25,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.16.0"
   },
   "files": [
     "dist",