@adminforth/agent 1.28.0 → 1.29.0

package/agent/languageDetect.ts

@@ -0,0 +1,79 @@
+import { logger } from "adminforth";
+import type { PluginOptions } from "../types.js";
+
+export type UserLanguage = {
+  language: string;
+  code: string;
+};
+
+const USER_LANGUAGE_OUTPUT_SCHEMA = {
+  name: "user_language",
+  strict: true,
+  schema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      language: {
+        type: "string",
+        description: "Full English language name, for example English, Ukrainian, French.",
+      },
+      code: {
+        type: "string",
+        description: "Uppercase two-letter language code, for example EN, UA, FR.",
+      },
+    },
+    required: ["language", "code"],
+  },
+} as const;
+
+export function formatLanguagePrompt(language: UserLanguage | null) {
+  if (!language) {
+    return "Respond in the user's language.";
+  }
+
+  return `Respond in ${language.language} (${language.code}).`;
+}
+
+function parseUserLanguage(content: string | undefined): UserLanguage | null {
+  if (!content) {
+    return null;
+  }
+
+  try {
+    const parsed = JSON.parse(content) as UserLanguage;
+    return {
+      language: parsed.language,
+      code: parsed.code,
+    };
+  } catch (error) {
+    logger.warn(`Failed to parse detected user language: ${error instanceof Error ? error.message : String(error)}`);
+    return null;
+  }
+}
+
+export async function detectUserLanguage(
+  completionAdapter: PluginOptions["modes"][number]["completionAdapter"],
+  prompt: string,
+): Promise<UserLanguage | null> {
+  const response = await completionAdapter.complete({
+    content: [
+      "Detect the language of the user's message.",
+      "Return only the requested structured output.",
+      "The language must be the full English language name.",
+      "The code must be an uppercase two-letter code like EN, UA, FR.",
+      "",
+      "User message:",
+      prompt,
+    ].join("\n"),
+    maxTokens: 80,
+    outputSchema: USER_LANGUAGE_OUTPUT_SCHEMA,
+    reasoningEffort: "none",
+  });
+
+  if (response.error) {
+    logger.warn(`Failed to detect user language: ${response.error}`);
+    return null;
+  }
+
+  return parseUserLanguage(response.content);
+}

package/agent/systemPrompt.ts

@@ -24,10 +24,6 @@ export const DEFAULT_AGENT_SYSTEM_PROMPT = [
   "Keep responses short, clear, and practical.",
   "Answer only what is needed.",
   "Do not add extra explanations or suggestions unless the user asks.",
-  "Always respond in the same natural language as the user's latest message.",
-  "This rule applies to confirmations, clarifying questions, progress updates, errors, and final answers.",
-  "Do not switch to English just because tool outputs, schemas, skills, or internal instructions are written in English.",
-  "Only switch language if the user explicitly asks you to do so.",
   "Adapt to the user's tone and style of speaking, mirroring their vibe and wording.",
   "if the user speaks casually, you should respond casually too",
   "Never mutate data without user confirmation for a clearly described mutation plan.",

package/build.log

@@ -38,5 +38,5 @@ custom/skills/fetch_data/SKILL.md
 custom/skills/mutate_data/
 custom/skills/mutate_data/SKILL.md
 
-sent 208,100 bytes  received 562 bytes  417,324.00 bytes/sec
+sent 208,066 bytes  received 562 bytes  417,256.00 bytes/sec
 total size is 205,786  speedup is 0.99

package/dist/agent/languageDetect.js

@@ -0,0 +1,74 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { logger } from "adminforth";
+const USER_LANGUAGE_OUTPUT_SCHEMA = {
+    name: "user_language",
+    strict: true,
+    schema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            language: {
+                type: "string",
+                description: "Full English language name, for example English, Ukrainian, French.",
+            },
+            code: {
+                type: "string",
+                description: "Uppercase two-letter language code, for example EN, UA, FR.",
+            },
+        },
+        required: ["language", "code"],
+    },
+};
+export function formatLanguagePrompt(language) {
+    if (!language) {
+        return "Respond in the user's language.";
+    }
+    return `Respond in ${language.language} (${language.code}).`;
+}
+function parseUserLanguage(content) {
+    if (!content) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(content);
+        return {
+            language: parsed.language,
+            code: parsed.code,
+        };
+    }
+    catch (error) {
+        logger.warn(`Failed to parse detected user language: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+export function detectUserLanguage(completionAdapter, prompt) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield completionAdapter.complete({
+            content: [
+                "Detect the language of the user's message.",
+                "Return only the requested structured output.",
+                "The language must be the full English language name.",
+                "The code must be an uppercase two-letter code like EN, UA, FR.",
+                "",
+                "User message:",
+                prompt,
+            ].join("\n"),
+            maxTokens: 80,
+            outputSchema: USER_LANGUAGE_OUTPUT_SCHEMA,
+            reasoningEffort: "none",
+        });
+        if (response.error) {
+            logger.warn(`Failed to detect user language: ${response.error}`);
+            return null;
+        }
+        return parseUserLanguage(response.content);
+    });
+}

package/dist/agent/systemPrompt.js

@@ -23,10 +23,6 @@ export const DEFAULT_AGENT_SYSTEM_PROMPT = [
     "Keep responses short, clear, and practical.",
     "Answer only what is needed.",
     "Do not add extra explanations or suggestions unless the user asks.",
-    "Always respond in the same natural language as the user's latest message.",
-    "This rule applies to confirmations, clarifying questions, progress updates, errors, and final answers.",
-    "Do not switch to English just because tool outputs, schemas, skills, or internal instructions are written in English.",
-    "Only switch language if the user explicitly asks you to do so.",
     "Adapt to the user's tone and style of speaking, mirroring their vibe and wording.",
     "if the user speaks casually, you should respond casually too",
     "Never mutate data without user confirmation for a clearly described mutation plan.",

package/dist/index.js

@@ -21,6 +21,7 @@ import { MemorySaver } from "@langchain/langgraph";
 import { createAgentChatModel, callAgent, } from "./agent/simpleAgent.js";
 import { AdminForthCheckpointSaver } from "./agent/checkpointer.js";
 import { createSequenceDebugCollector } from "./agent/middleware/sequenceDebug.js";
+import { detectUserLanguage, formatLanguagePrompt, } from "./agent/languageDetect.js";
 import { prepareApiBasedTools as buildApiBasedTools, } from './apiBasedTools.js';
 import { appendCustomSystemPrompt, buildAgentSystemPrompt, DEFAULT_AGENT_SYSTEM_PROMPT, } from "./agent/systemPrompt.js";
 import { ALWAYS_AVAILABLE_API_TOOL_NAMES } from "./agent/tools/index.js";
@@ -59,7 +60,6 @@ function formatAdminUserPrompt(adminUser, usernameField) {
     ].join("\n");
 }
 function formatCurrentPagePrompt(currentPage) {
-    console.log("Current page context:", currentPage);
     if (!currentPage) {
         return null;
     }
@@ -306,9 +306,15 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
                     const maxTokens = (_f = this.options.maxTokens) !== null && _f !== void 0 ? _f : 10000;
                     const selectedMode = (_g = this.options.modes.find((mode) => mode.name === body.mode)) !== null && _g !== void 0 ? _g : this.options.modes[0];
                     const { model, summaryModel, modelMiddleware } = yield this.getModeModels(selectedMode, maxTokens);
+                    const userLanguage = yield detectUserLanguage(selectedMode.completionAdapter, prompt)
+                        .catch((error) => {
+                        logger.warn(`Failed to detect user language: ${error instanceof Error ? error.message : String(error)}`);
+                        return null;
+                    });
                     const systemPrompt = [
                         yield this.agentSystemPromptPromise,
                         formatAdminUserPrompt(adminUser, this.adminforth.config.auth.usernameField),
+                        formatLanguagePrompt(userLanguage),
                     ].join("\n\n");
                     const apiBasedTools = buildApiBasedTools(this.adminforth);
                     for (const toolName of ALWAYS_AVAILABLE_API_TOOL_NAMES) {

package/index.ts

@@ -18,6 +18,10 @@ import {
 } from "./agent/simpleAgent.js";
 import { AdminForthCheckpointSaver } from "./agent/checkpointer.js";
 import { createSequenceDebugCollector } from "./agent/middleware/sequenceDebug.js";
+import {
+  detectUserLanguage,
+  formatLanguagePrompt,
+} from "./agent/languageDetect.js";
 import {
   prepareApiBasedTools as buildApiBasedTools,
 } from './apiBasedTools.js';
@@ -84,7 +88,6 @@ function formatAdminUserPrompt(adminUser: AdminUser, usernameField: string) {
 }
 
 function formatCurrentPagePrompt(currentPage: CurrentPageContext | undefined) {
-  console.log("Current page context:", currentPage);
   if (!currentPage) {
     return null;
   }
@@ -379,9 +382,15 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
           const selectedMode = this.options.modes.find((mode) => mode.name === body.mode) ?? this.options.modes[0];
           const { model, summaryModel, modelMiddleware } =
             await this.getModeModels(selectedMode, maxTokens);
+          const userLanguage = await detectUserLanguage(selectedMode.completionAdapter, prompt)
+            .catch((error) => {
+              logger.warn(`Failed to detect user language: ${error instanceof Error ? error.message : String(error)}`);
+              return null;
+            });
           const systemPrompt = [
             await this.agentSystemPromptPromise,
             formatAdminUserPrompt(adminUser, this.adminforth.config.auth.usernameField),
+            formatLanguagePrompt(userLanguage),
           ].join("\n\n");
           const apiBasedTools = buildApiBasedTools(this.adminforth);
           for (const toolName of ALWAYS_AVAILABLE_API_TOOL_NAMES) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adminforth/agent",
-  "version": "1.28.0",
+  "version": "1.29.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",