@adminforth/agent 1.27.6 → 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 207,807 bytes  received 562 bytes  416,738.00 bytes/sec
-total size is 205,493  speedup is 0.99
+sent 208,066 bytes  received 562 bytes  417,256.00 bytes/sec
+total size is 205,786  speedup is 0.99

package/custom/composables/useAgentStore.ts

@@ -14,6 +14,15 @@ type AgentMode = {
   name: string;
 };
 
+function getCurrentPageContext() {
+  return {
+    path: window.location.pathname,
+    fullPath: `${window.location.pathname}${window.location.search}${window.location.hash}`,
+    title: document.title,
+    url: window.location.href,
+  };
+}
+
 const DEFAULT_TEXTAREA_PLACEHOLDER = 'Type a message...';
 const PLACEHOLDER_TYPING_DELAY_MS = 60;
 const PLACEHOLDER_DELETING_DELAY_MS = 35;
@@ -206,6 +215,7 @@ export const useAgentStore = defineStore('agent', () => {
               sessionId,
               timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
               mode: activeModeName.value,
+              currentPage: getCurrentPageContext(),
             };
 
             return {

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/custom/composables/useAgentStore.ts

@@ -14,6 +14,15 @@ type AgentMode = {
   name: string;
 };
 
+function getCurrentPageContext() {
+  return {
+    path: window.location.pathname,
+    fullPath: `${window.location.pathname}${window.location.search}${window.location.hash}`,
+    title: document.title,
+    url: window.location.href,
+  };
+}
+
 const DEFAULT_TEXTAREA_PLACEHOLDER = 'Type a message...';
 const PLACEHOLDER_TYPING_DELAY_MS = 60;
 const PLACEHOLDER_DELETING_DELAY_MS = 35;
@@ -206,6 +215,7 @@ export const useAgentStore = defineStore('agent', () => {
               sessionId,
               timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
               mode: activeModeName.value,
+              currentPage: getCurrentPageContext(),
             };
 
             return {

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";
@@ -46,6 +47,28 @@ function formatAgentError(error) {
     }
     return String(error);
 }
+function formatAdminUserPrompt(adminUser, usernameField) {
+    const dbUser = adminUser.dbUser;
+    const adminUserContext = {
+        id: adminUser.pk,
+        email: dbUser[usernameField],
+    };
+    return [
+        "Current admin user context:",
+        JSON.stringify(adminUserContext, null, 2),
+        "Use this admin user email when the user asks to send information to themselves, the current admin, or the logged-in user.",
+    ].join("\n");
+}
+function formatCurrentPagePrompt(currentPage) {
+    if (!currentPage) {
+        return null;
+    }
+    return [
+        "Current user page context for the latest message:",
+        JSON.stringify(currentPage, null, 2),
+        "When the user says here, this page, current page, or opened page, treat it as this page.",
+    ].join("\n");
+}
 function assertRequiredApiTool(apiBasedTools, toolName) {
     if (toolName in apiBasedTools) {
         return;
@@ -210,6 +233,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
                 const messageId = randomUUID();
                 const prompt = body.message;
                 const userTimeZone = (_e = body.timeZone) !== null && _e !== void 0 ? _e : 'UTC';
+                const currentPage = body.currentPage;
                 const sessionId = body.sessionId || (adminUser === null || adminUser === void 0 ? void 0 : adminUser.pk) || (adminUser === null || adminUser === void 0 ? void 0 : adminUser.username) || 'default';
                 const turnId = yield this.createNewTurn(sessionId, prompt);
                 yield this.updateSessionDate(sessionId);
@@ -282,13 +306,23 @@ 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 systemPrompt = yield this.agentSystemPromptPromise;
+                    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) {
                         assertRequiredApiTool(apiBasedTools, toolName);
                     }
                     assertRequiredApiTool(apiBasedTools, "update_record");
                     this.apiBasedTools = apiBasedTools;
+                    const currentPagePrompt = formatCurrentPagePrompt(currentPage);
                     const stream = yield callAgent({
                         name: `adminforth-agent-${this.pluginInstanceId}`,
                         model,
@@ -297,6 +331,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
                         checkpointer: this.getCheckpointer(),
                         messages: [
                             new SystemMessage(systemPrompt),
+                            ...(currentPagePrompt ? [new SystemMessage(currentPagePrompt)] : []),
                             new HumanMessage(prompt),
                         ],
                         adminUser,

package/index.ts

@@ -1,4 +1,5 @@
 import type {
+  AdminUser,
   AdminForthResource,
   IAdminForth,
   IHttpServer
@@ -14,10 +15,13 @@ import {
   createAgentChatModel,
   callAgent,
   type AgentChatModel,
-  type AgentModeCompletionAdapter,
 } 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';
@@ -30,6 +34,17 @@ import {
 import { ALWAYS_AVAILABLE_API_TOOL_NAMES } from "./agent/tools/index.js";
 import type { ToolCallEvent } from "./agent/toolCallEvents.js";
 
+type CurrentPageRequestBody = {
+  currentPage?: CurrentPageContext;
+};
+
+type CurrentPageContext = {
+  path: string;
+  fullPath: string;
+  title: string;
+  url: string;
+};
+
 function isAggregateErrorLike(
   error: unknown,
 ): error is { errors: unknown[]; message?: string; stack?: string } {
@@ -58,6 +73,32 @@ function formatAgentError(error: unknown) {
   return String(error);
 }
 
+function formatAdminUserPrompt(adminUser: AdminUser, usernameField: string) {
+  const dbUser = adminUser.dbUser as Record<string, unknown>;
+  const adminUserContext = {
+    id: adminUser.pk,
+    email: dbUser[usernameField],
+  };
+
+  return [
+    "Current admin user context:",
+    JSON.stringify(adminUserContext, null, 2),
+    "Use this admin user email when the user asks to send information to themselves, the current admin, or the logged-in user.",
+  ].join("\n");
+}
+
+function formatCurrentPagePrompt(currentPage: CurrentPageContext | undefined) {
+  if (!currentPage) {
+    return null;
+  }
+
+  return [
+    "Current user page context for the latest message:",
+    JSON.stringify(currentPage, null, 2),
+    "When the user says here, this page, current page, or opened page, treat it as this page.",
+  ].join("\n");
+}
+
 function assertRequiredApiTool(
   apiBasedTools: Record<string, ApiBasedTool>,
   toolName: string,
@@ -248,6 +289,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
         const messageId = randomUUID();
         const prompt = body.message;
         const userTimeZone = (body.timeZone as string | undefined) ?? 'UTC';
+        const currentPage = (body as CurrentPageRequestBody).currentPage;
         const sessionId = body.sessionId || adminUser?.pk || adminUser?.username || 'default';
         const turnId = await this.createNewTurn(sessionId, prompt);
         await this.updateSessionDate(sessionId);
@@ -340,13 +382,23 @@ 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 systemPrompt = await this.agentSystemPromptPromise;
+          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) {
             assertRequiredApiTool(apiBasedTools, toolName);
           }
           assertRequiredApiTool(apiBasedTools, "update_record");
           this.apiBasedTools = apiBasedTools;
+          const currentPagePrompt = formatCurrentPagePrompt(currentPage);
           const stream = await callAgent({
             name: `adminforth-agent-${this.pluginInstanceId}`,
             model,
@@ -355,6 +407,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
             checkpointer: this.getCheckpointer(),
             messages: [
               new SystemMessage(systemPrompt),
+              ...(currentPagePrompt ? [new SystemMessage(currentPagePrompt)] : []),
               new HumanMessage(prompt),
             ],
             adminUser,

package/package.json

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