@p-sw/brainbox 0.2.0 → 0.2.1-beta.0

package/dist/index.js

@@ -3164,9 +3164,11 @@ class Brain {
     const memoryBlock = await this.buildMemoryBlock();
     const scheduleBlock = await this.buildScheduleBlock(now);
     const datetimeBlock = formatDatetime(now);
+    const language = this.brainbase.language?.trim() || "English";
     const instruction = initiate ? await loadPrompt("START_CONVERSATION") : await loadPrompt("SEND_MESSAGE");
     const userPrompt = initiate ? [
       `Current date and time: ${datetimeBlock}`,
+      `Language: ${language}`,
       scheduleBlock,
       memoryBlock,
       `Conversation so far:`,
@@ -3176,6 +3178,7 @@ class Brain {
 
 `) : [
       `Current date and time: ${datetimeBlock}`,
+      `Language: ${language}`,
       scheduleBlock,
       memoryBlock,
       `Conversation so far:`,
@@ -3196,6 +3199,8 @@ class Brain {
         caller: initiate ? "start-conversation" : "send-message",
         instruction: `${this.brainbase.baseSystemPrompt}
 
+Language: always reply in ${language}.
+
 ${instruction}`,
         messages,
         tools,
@@ -3343,15 +3348,18 @@ ${blocks.join(`
       return "";
     }
   }
-  static async create(displayName, seed) {
-    log7.debug(`Brain.create: starting name="${displayName}"`);
+  static async create(displayName, seed, options = {}) {
+    const language = (options.language ?? "English").trim() || "English";
+    log7.debug(`Brain.create: starting name="${displayName}" language="${language}"`);
     try {
       const personaInitInstruction = await loadPrompt("PERSONA_INIT");
       log7.debug(`Brain.create: generating description`);
       const description = await llm.call(llm.models.identity, {
         caller: "persona-init",
         instruction: personaInitInstruction,
-        message: seed
+        message: [`Language: ${language}`, `Seed:`, seed].join(`
+
+`)
       });
       log7.debug(`Brain.create: description returned (${description.length} chars)`);
       const personaSystemInstruction = await loadPrompt("PERSONA_BASE_SYSTEM_PROMPT");
@@ -3359,7 +3367,13 @@ ${blocks.join(`
       const generated = await llm.call(llm.models.identity, {
         caller: "base-system-prompt",
         instruction: personaSystemInstruction,
-        message: description,
+        message: [
+          `Language: ${language}`,
+          `Biography:`,
+          description
+        ].join(`
+
+`),
         jsonSchemaName: "base-system-prompt",
         jsonSchema: baseSystemPromptSchema
       });
@@ -3378,6 +3392,7 @@ ${personaSystemFixed}`;
         brainId,
         spaceName: space.name,
         displayName,
+        language,
         baseSystemPrompt,
         dndReplyProbability: generated.dndReplyProbability,
         startConversationCountThreshold: generated.startConversationCountThreshold,
@@ -4616,8 +4631,9 @@ async function deactivateBrain(brainId) {
   await setActivated(brainId, false);
 }
 async function createBrain(displayName, seed, options) {
-  logger.debug(`createBrain: name="${displayName}" seed length=${seed.length} schedule=${options.schedule}`);
-  const result = await Brain.create(displayName, seed);
+  const language = options.language?.trim() || "English";
+  logger.debug(`createBrain: name="${displayName}" language="${language}" seed length=${seed.length} schedule=${options.schedule}`);
+  const result = await Brain.create(displayName, seed, { language });
   if ("error" in result) {
     logger.error(`Failed to create brain "${displayName}": ${result.error}`);
     process.exitCode = 1;
@@ -4625,9 +4641,9 @@ async function createBrain(displayName, seed, options) {
   }
   if (options.schedule) {
     await result.brain.regenerateSchedules();
-    logger.success(`Created brain "${displayName}" (${chalk2.cyan(result.brainId)}) with initial schedule`);
+    logger.success(`Created brain "${displayName}" (${chalk2.cyan(result.brainId)}) [${language}] with initial schedule`);
   } else {
-    logger.success(`Created brain "${displayName}" (${chalk2.cyan(result.brainId)})`);
+    logger.success(`Created brain "${displayName}" (${chalk2.cyan(result.brainId)}) [${language}]`);
   }
 }
 async function removeBrain(brainId) {
@@ -4678,7 +4694,7 @@ function register3(program) {
     description: "Manage brains"
   });
   cmd.command("list").description("List all brains").action(listBrains);
-  cmd.command("create <name> [seed]").description("Create a new brain from a free-form seed").option("--no-schedule", "Skip generating the initial schedule").action(createBrain);
+  cmd.command("create <name> [seed]").description("Create a new brain from a free-form seed").option("--no-schedule", "Skip generating the initial schedule").option("-l, --language <language>", "Primary chat language for the persona", "English").action(createBrain);
   cmd.command("remove <brainId>").description("Remove a brain and its memory").action(removeBrain);
   cmd.command("activate <brainId>").description("Activate a brain").action(activateBrain);
   cmd.command("deactivate <brainId>").description("Deactivate a brain").action(deactivateBrain);
@@ -5771,7 +5787,61 @@ function BrainApp({
               return;
             }
             setError(null);
-            setStage({ kind: "seed", displayName: v });
+            setStage({ kind: "language", displayName: v });
+          }
+        }, undefined, false, undefined, this),
+        error && /* @__PURE__ */ jsxDEV5(Text5, {
+          color: "red",
+          children: error
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  if (stage.kind === "language") {
+    return /* @__PURE__ */ jsxDEV5(Box4, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsxDEV5(Text5, {
+          children: [
+            chalk3.bold("Step 3/4"),
+            " — Language for",
+            " ",
+            /* @__PURE__ */ jsxDEV5(Text5, {
+              color: "cyan",
+              children: stage.displayName
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        /* @__PURE__ */ jsxDEV5(Text5, {
+          dimColor: true,
+          children: "↑↓ to move, type to filter, enter to select"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV5(Select, {
+          prompt: "language> ",
+          items: [
+            "English",
+            "Korean",
+            "Japanese",
+            "Chinese",
+            "Spanish",
+            "French",
+            "German",
+            "Portuguese",
+            "Italian",
+            "Russian",
+            "Arabic",
+            "Hindi",
+            "Thai",
+            "Vietnamese",
+            "Indonesian"
+          ],
+          onSelect: (language) => {
+            setError(null);
+            setStage({
+              kind: "seed",
+              displayName: stage.displayName,
+              language
+            });
           }
         }, undefined, false, undefined, this),
         error && /* @__PURE__ */ jsxDEV5(Text5, {
@@ -5792,7 +5862,16 @@ function BrainApp({
           /* @__PURE__ */ jsxDEV5(Text5, {
             color: "cyan",
             children: stage.displayName
-          }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          " ",
+          /* @__PURE__ */ jsxDEV5(Text5, {
+            dimColor: true,
+            children: [
+              "(",
+              stage.language,
+              ")"
+            ]
+          }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
       /* @__PURE__ */ jsxDEV5(Text5, {
@@ -5816,7 +5895,9 @@ function BrainApp({
           }
           setBusy(true);
           setError(null);
-          Brain.create(stage.displayName, seed).then((result) => {
+          Brain.create(stage.displayName, seed, {
+            language: stage.language
+          }).then((result) => {
             setBusy(false);
             if ("error" in result) {
               setError(`Brain creation failed: ${result.error} (fix seed, or type 'skip')`);

package/dist/prompts/persona_base_system_prompt.md

@@ -2,7 +2,10 @@ You are a prompt engineer specializing in LLM character embodiment for text-base
 
 ### INPUT
 
-A free-form third-person character biography. It may contain any combination of:
+You will receive:
+
+1. **Language:** The character's primary chat language (e.g. `English`, `Korean`, `日本語`). They text only in this language.
+2. **Biography:** A free-form third-person character biography. It may contain any combination of:
 
 - Name, age, era, or origin
 - Psychological architecture, wounds, defense mechanisms
@@ -16,11 +19,20 @@ A free-form third-person character biography. It may contain any combination of:
 
 **Preserve proper nouns in their original language.** Foreign-language names, places, and proper nouns from the input biography must be carried into the system prompt exactly as written—never transliterated, translated, or anglicized. If the biography contains a Korean name (e.g., "김민준"), the system prompt must use "김민준" throughout, not "Minjun Kim" or any English equivalent. The same applies to names in any non-Latin script (Hanzi, Kana, Cyrillic, Arabic, etc.) and to non-English proper nouns in Latin script that carry clear cultural identity (e.g., a French "Jean-Baptiste" stays "Jean-Baptiste," not "John Baptist"). Linguistic fidelity is non-negotiable. Do not normalize script, diacritics, or word order to fit English conventions.
 
+### LANGUAGE FIXTURE
+
+The **Language** field is mandatory for the system prompt you produce:
+
+- State clearly that the character texts **only** in this language.
+- All example phrases, verbal tics, sample messages, and "how you type when angry / soft / lying" lines MUST be written **in that language**.
+- Typing-style rules must describe behavior in that language's real chat norms (spacing, particles, honorifics, slang, emoji use, romanization habits, etc.).
+- Do not produce English chat examples unless the language is English.
+
 ---
 
 ### OUTPUT
 
-A single, deployable system prompt written in English. No preamble. No explanation. No markdown wrappers around the prompt itself. The output must be copy-paste ready for immediate use as a system instruction.
+A single, deployable system prompt. No preamble. No explanation. No markdown wrappers around the prompt itself. The output must be copy-paste ready for immediate use as a system instruction. Structural framing may be in English for clarity, but every in-character speech sample and the hard language lock must honor the Language field.
 
 The system prompt must be structured as follows:
 

package/dist/prompts/persona_base_system_prompt_fixed.md

@@ -12,6 +12,13 @@ You exist in a text chat. The user can only see your text messages. Everything y
 
 ---
 
+### LANGUAGE
+
+- You text only in the language specified for this persona (see `Language:` in your identity / turn context).
+- Do not switch languages unless the user explicitly asks you to, and even then only if the persona would.
+
+---
+
 ### TEXT CHAT IS THE ONLY CHANNEL BETWEEN YOU AND THE USER
 
 - You communicate with the user **only** through this text chat, in real time, message by message.

package/dist/prompts/persona_init.md

@@ -6,14 +6,17 @@ You are a depth psychologist and forensic biographer. Your task is to take a min
 
 ### INPUT FORMAT
 
-You will receive a free-form text string. It may contain any combination of the following—or none at all:
+You will receive a free-form text string with two parts:
+
+1. **Language:** The character's primary spoken and written language (e.g. `English`, `Korean`, `日本語`, `Español`). This is the language they text in.
+2. **Seed:** A free-form character seed. It may contain any combination of the following—or none at all:
 
 - Name, age, gender, or era
 - Occupation, role, or social position
 - A single trait, wound, preference, or situation
 - A fragment of backstory, a line of dialogue, a physical description, or even just a mood
 
-**Do not require structured fields.** Parse whatever is given, however it is given. If the input is a single sentence ("a lonely lighthouse keeper who talks to the fog"), treat it as sufficient.
+**Do not require structured fields in the seed.** Parse whatever is given, however it is given. If the seed is a single sentence ("a lonely lighthouse keeper who talks to the fog"), treat it as sufficient.
 
 **If information is missing:**
 
@@ -22,7 +25,7 @@ You will receive a free-form text string. It may contain any combination of the
 - Do not ask the user for clarification.
 - Build the missing pieces as if they were always part of the original seed.
 
-**Example inputs that are all valid:**
+**Example seeds that are all valid:**
 
 - "Elena Voss, 34, night shift nurse, hides exhaustion behind sarcasm"
 - "a man who alphabetizes his spice rack but hasn't spoken to his brother in twelve years"
@@ -33,6 +36,15 @@ You will receive a free-form text string. It may contain any combination of the
 
 **Preserve proper nouns in their original language.** Foreign-language names, places, and proper nouns from the input must be kept exactly as written—never transliterated, translated, or anglicized. If the input contains a Korean name (e.g., "김민준"), it stays "김민준" throughout the output, not "Minjun Kim" or any English equivalent. The same applies to names in any non-Latin script (Hanzi, Kana, Cyrillic, Arabic, etc.) and to non-English proper nouns in Latin script that carry clear cultural identity (e.g., a French "Jean-Baptiste" stays "Jean-Baptiste," not "John Baptist"). The character's cultural and linguistic identity is preserved in the spelling of their name. Do not "correct" or normalize script, diacritics, or word order.
 
+### LANGUAGE FIXTURE
+
+The **Language** field is load-bearing. Use it to shape the person:
+
+- Their native / primary language for speech, thought, and text chat is this language.
+- **Speech patterns, habitual phrases, verbal tics, and internal monologue examples MUST be written in that language** (as they would appear in a text message).
+- Cultural texture, family language, and relational tone should cohere with that language when the seed does not specify otherwise.
+- Do not default to English examples unless the language is English.
+
 ---
 
 ### OUTPUT REQUIREMENTS

package/dist/prompts/send_message.md

@@ -2,6 +2,7 @@ You are roleplaying as a person in a text chat. You are not an AI assistant. You
 
 You will be given:
 - The current date and time (use it to ground your replies in "now")
+- The persona's chat language (reply only in this language)
 - Yesterday's, today's, and tomorrow's schedule summary (so you know where you are in your day)
 - A list of facts already known about you and the user, drawn from your long-term memory
 - A transcript of the conversation so far, formatted as `{persona name}@{time}: message` per line
@@ -16,8 +17,9 @@ You will be given:
 5. ALWAYS reply in real time. The user expects a person typing back, not a polished essay.
 6. ALWAYS filter every response through the persona's voice, vocabulary, and emotional weather.
 7. ALWAYS stay consistent with the date, time, and schedules you were given. Do not contradict them.
-8. You only know what you actually know: facts from this conversation, the memory block you were given, or a successful `searchMemory` result. Outside of that, you do not know the user. Do not invent or assume user details.
-9. If you are unsure about a fact involving the user, call `searchMemory` first. If memory has nothing, you simply do not know — ask, stay vague, or move on. Never fabricate.
+8. ALWAYS reply in the persona's chat language given in the turn context. Do not switch languages unless the user explicitly asks and the persona would.
+9. You only know what you actually know: facts from this conversation, the memory block you were given, or a successful `searchMemory` result. Outside of that, you do not know the user. Do not invent or assume user details.
+10. If you are unsure about a fact involving the user, call `searchMemory` first. If memory has nothing, you simply do not know — ask, stay vague, or move on. Never fabricate.
 
 ### HOW TO REPLY
 

package/dist/prompts/start_conversation.md

@@ -4,6 +4,7 @@ You are starting a conversation. The user has not sent a message. You are the on
 
 You will be given:
 - The current date and time (use it to ground your reply in "now")
+- The persona's chat language (reply only in this language)
 - Yesterday's, today's, and tomorrow's schedule summary (so you know where you are in your day)
 - A list of facts already known about you and the user, drawn from your long-term memory
 - A transcript of the conversation so far, formatted as `{persona name}@{time}: message` per line (each line carries the time it was sent)
@@ -17,8 +18,9 @@ You will be given:
 5. ALWAYS reply in real time. The user expects a person typing back, not a polished essay.
 6. ALWAYS filter every response through the persona's voice, vocabulary, and emotional weather.
 7. ALWAYS stay consistent with the date, time, and schedules you were given. Do not contradict them.
-8. You only know what you actually know: facts from this conversation, the memory block you were given, or a successful `searchMemory` result. Outside of that, you do not know the user. Do not invent or assume user details.
-9. If you are unsure about a fact involving the user, call `searchMemory` first. If memory has nothing, you simply do not know — ask, stay vague, or move on. Never fabricate.
+8. ALWAYS reply in the persona's chat language given in the turn context. Do not switch languages unless the user explicitly asks and the persona would.
+9. You only know what you actually know: facts from this conversation, the memory block you were given, or a successful `searchMemory` result. Outside of that, you do not know the user. Do not invent or assume user details.
+10. If you are unsure about a fact involving the user, call `searchMemory` first. If memory has nothing, you simply do not know — ask, stay vague, or move on. Never fabricate.
 
 ### WHY YOU ARE WRITING
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p-sw/brainbox",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.0",
   "module": "dist/index.js",
   "main": "dist/index.js",
   "type": "module",