@adminforth/agent 1.28.0 → 1.30.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

@@ -33,10 +33,12 @@ custom/incremark_code_renderers/renderIncremarkMarkdown.ts
 custom/skills/
 custom/skills/analyze_data/
 custom/skills/analyze_data/SKILL.md
+custom/skills/charts/
+custom/skills/charts/SKILL.md
 custom/skills/fetch_data/
 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
-total size is 205,786  speedup is 0.99
+sent 208,510 bytes  received 585 bytes  418,190.00 bytes/sec
+total size is 206,100  speedup is 0.99

package/custom/skills/analyze_data/SKILL.md

@@ -1,209 +1,22 @@
 name: analyze_data
-description: Analyze AdminForth resource data, summarize trends, and create charts from fetched rows.
+description: Analyze AdminForth resource data, summarize trends, and compare distributions from fetched rows.
 ---
 
 # Involved tools
 
 Use `get_resource` first if you need to inspect resource structure and column names.
 
-Use `get_resource_data` to fetch data for this skill. This is the main tool for loading rows for analytics, comparisons, distributions, and trend analysis.
+Use `aggregate` to fetch data for analytics whenever possible. This is the main tool for fast server-side aggregations, including filtered data, grouped metrics, and date buckets such as day, week, or month.
+
+Use `get_resource_data` only when the requested analysis cannot be answered with `aggregate`. This is heavier because it returns original rows with all fields, but it allows complex calculations, comparisons, and custom groupings in-memory.
 
 # Instructions
 
 When the user asks for analytics, reports, trends, comparisons, or distributions:
 
-- Fetch the requested data using `aggregate` tool. This tool is capable of performing fast server-side aggregations on filtered data, groupings by date including grouping by day/week/month etc. 
-- if it is not possible to get the required aggregates using `aggregate`, fetch the underlying rows with `get_resource_data`. This is much heavier since returns original rows  with all fields, but allows you to perform complex calculations, comparisons, and custom groupings in-memory. Always prefer `aggregate` when possible.
+- Fetch the requested data using `aggregate` whenever possible.
+- If it is not possible to get the required aggregates using `aggregate`, fetch the underlying rows with `get_resource_data`.
 - Prefer narrow requests: use filters, sorting, pagination, and date ranges whenever possible.
 - If the request is ambiguous, clarify the resource, metric, grouping, or date range before fetching data.
 - Return a short written summary with the key finding and most important numbers.
-- If a chart would help, produce a Vega-Lite spec.
-
-# Charts
-
-Use Vega-Lite syntax for charts.
-
-Return every chart as valid JSON inside a `vega-lite` fenced code block.
-
-Every chart spec should include:
-- `title.text`
-- `title.subtitle`
-- explicit axis titles when axes are used
-- tooltips for the key fields
-
-### Line chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Orders by Day",
-    "subtitle": "Daily order count for the selected date range"
-  },
-  "data": {
-    "values": [
-      { "date": "2026-04-01", "orders": 18 },
-      { "date": "2026-04-02", "orders": 25 },
-      { "date": "2026-04-03", "orders": 21 },
-      { "date": "2026-04-04", "orders": 29 }
-    ]
-  },
-  "mark": { "type": "line", "point": true },
-  "encoding": {
-    "x": { "field": "date", "type": "temporal", "title": "Date" },
-    "y": { "field": "orders", "type": "quantitative", "title": "Orders" },
-    "tooltip": [
-      { "field": "date", "type": "temporal", "title": "Date" },
-      { "field": "orders", "type": "quantitative", "title": "Orders" }
-    ]
-  }
-}
-```
-
-### Bar chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Revenue by Category",
-    "subtitle": "Top categories in the current filtered dataset"
-  },
-  "data": {
-    "values": [
-      { "category": "Hardware", "revenue": 42000 },
-      { "category": "Software", "revenue": 31500 },
-      { "category": "Services", "revenue": 22750 }
-    ]
-  },
-  "mark": "bar",
-  "encoding": {
-    "x": { "field": "category", "type": "nominal", "title": "Category", "sort": "-y" },
-    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
-    "tooltip": [
-      { "field": "category", "type": "nominal", "title": "Category" },
-      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
-    ]
-  }
-}
-```
-
-### Area chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Monthly Signups",
-    "subtitle": "New users accumulated across the last six months"
-  },
-  "data": {
-    "values": [
-      { "month": "2025-11-01", "signups": 120 },
-      { "month": "2025-12-01", "signups": 155 },
-      { "month": "2026-01-01", "signups": 168 },
-      { "month": "2026-02-01", "signups": 190 },
-      { "month": "2026-03-01", "signups": 214 },
-      { "month": "2026-04-01", "signups": 238 }
-    ]
-  },
-  "mark": { "type": "area", "line": true, "point": true },
-  "encoding": {
-    "x": { "field": "month", "type": "temporal", "title": "Month" },
-    "y": { "field": "signups", "type": "quantitative", "title": "Signups" },
-    "tooltip": [
-      { "field": "month", "type": "temporal", "title": "Month" },
-      { "field": "signups", "type": "quantitative", "title": "Signups" }
-    ]
-  }
-}
-```
-
-### Scatter plot
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Ad Spend vs Revenue",
-    "subtitle": "Campaign-level correlation for the selected month"
-  },
-  "data": {
-    "values": [
-      { "campaign": "Search", "spend": 1200, "revenue": 5400 },
-      { "campaign": "Social", "spend": 900, "revenue": 3100 },
-      { "campaign": "Email", "spend": 350, "revenue": 2200 },
-      { "campaign": "Affiliates", "spend": 700, "revenue": 3600 }
-    ]
-  },
-  "mark": { "type": "point", "filled": true, "size": 120 },
-  "encoding": {
-    "x": { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
-    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
-    "tooltip": [
-      { "field": "campaign", "type": "nominal", "title": "Campaign" },
-      { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
-      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
-    ]
-  }
-}
-```
-
-### Pie chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Tickets by Status",
-    "subtitle": "Share of tickets in each workflow state"
-  },
-  "data": {
-    "values": [
-      { "status": "Open", "count": 42 },
-      { "status": "In Progress", "count": 27 },
-      { "status": "Resolved", "count": 58 }
-    ]
-  },
-  "mark": { "type": "arc", "innerRadius": 40 },
-  "encoding": {
-    "theta": { "field": "count", "type": "quantitative", "title": "Tickets" },
-    "color": { "field": "status", "type": "nominal", "title": "Status" },
-    "tooltip": [
-      { "field": "status", "type": "nominal", "title": "Status" },
-      { "field": "count", "type": "quantitative", "title": "Tickets" }
-    ]
-  }
-}
-```
-
-### Histogram
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Order Value Distribution",
-    "subtitle": "Histogram of order totals in the filtered result set"
-  },
-  "data": {
-    "values": [
-      { "order_total": 24 },
-      { "order_total": 31 },
-      { "order_total": 39 },
-      { "order_total": 42 },
-      { "order_total": 63 },
-      { "order_total": 78 },
-      { "order_total": 95 }
-    ]
-  },
-  "mark": "bar",
-  "encoding": {
-    "x": { "bin": true, "field": "order_total", "type": "quantitative", "title": "Order Total" },
-    "y": { "aggregate": "count", "type": "quantitative", "title": "Count" },
-    "tooltip": [
-      { "aggregate": "count", "type": "quantitative", "title": "Count" }
-    ]
-  }
-}
-```
+- If the user asks for a chart, or if a chart would help and you decide to produce one, invoke the `charts` skill for chart formatting and Vega-Lite requirements.

package/custom/skills/charts/SKILL.md

@@ -0,0 +1,193 @@
+name: charts
+description: Create Vega-Lite chart specs for AdminForth analytics responses. Always use this skill when the user asks for a chart or when a chart would help illustrate the insights from an analytics query.
+---
+
+# Instructions
+
+Use Vega-Lite syntax for charts.
+
+Return every chart as valid JSON inside a `vega-lite` fenced code block.
+
+Every chart spec should include:
+
+- `title.text`
+- `title.subtitle`
+- explicit axis titles when axes are used
+- tooltips for the key fields
+
+### Line chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Orders by Day",
+    "subtitle": "Daily order count for the selected date range"
+  },
+  "data": {
+    "values": [
+      { "date": "2026-04-01", "orders": 18 },
+      { "date": "2026-04-02", "orders": 25 },
+      { "date": "2026-04-03", "orders": 21 },
+      { "date": "2026-04-04", "orders": 29 }
+    ]
+  },
+  "mark": { "type": "line", "point": true },
+  "encoding": {
+    "x": { "field": "date", "type": "temporal", "title": "Date" },
+    "y": { "field": "orders", "type": "quantitative", "title": "Orders" },
+    "tooltip": [
+      { "field": "date", "type": "temporal", "title": "Date" },
+      { "field": "orders", "type": "quantitative", "title": "Orders" }
+    ]
+  }
+}
+```
+
+### Bar chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Revenue by Category",
+    "subtitle": "Top categories in the current filtered dataset"
+  },
+  "data": {
+    "values": [
+      { "category": "Hardware", "revenue": 42000 },
+      { "category": "Software", "revenue": 31500 },
+      { "category": "Services", "revenue": 22750 }
+    ]
+  },
+  "mark": "bar",
+  "encoding": {
+    "x": { "field": "category", "type": "nominal", "title": "Category", "sort": "-y" },
+    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
+    "tooltip": [
+      { "field": "category", "type": "nominal", "title": "Category" },
+      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
+    ]
+  }
+}
+```
+
+### Area chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Monthly Signups",
+    "subtitle": "New users accumulated across the last six months"
+  },
+  "data": {
+    "values": [
+      { "month": "2025-11-01", "signups": 120 },
+      { "month": "2025-12-01", "signups": 155 },
+      { "month": "2026-01-01", "signups": 168 },
+      { "month": "2026-02-01", "signups": 190 },
+      { "month": "2026-03-01", "signups": 214 },
+      { "month": "2026-04-01", "signups": 238 }
+    ]
+  },
+  "mark": { "type": "area", "line": true, "point": true },
+  "encoding": {
+    "x": { "field": "month", "type": "temporal", "title": "Month" },
+    "y": { "field": "signups", "type": "quantitative", "title": "Signups" },
+    "tooltip": [
+      { "field": "month", "type": "temporal", "title": "Month" },
+      { "field": "signups", "type": "quantitative", "title": "Signups" }
+    ]
+  }
+}
+```
+
+### Scatter plot
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Ad Spend vs Revenue",
+    "subtitle": "Campaign-level correlation for the selected month"
+  },
+  "data": {
+    "values": [
+      { "campaign": "Search", "spend": 1200, "revenue": 5400 },
+      { "campaign": "Social", "spend": 900, "revenue": 3100 },
+      { "campaign": "Email", "spend": 350, "revenue": 2200 },
+      { "campaign": "Affiliates", "spend": 700, "revenue": 3600 }
+    ]
+  },
+  "mark": { "type": "point", "filled": true, "size": 120 },
+  "encoding": {
+    "x": { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
+    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
+    "tooltip": [
+      { "field": "campaign", "type": "nominal", "title": "Campaign" },
+      { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
+      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
+    ]
+  }
+}
+```
+
+### Pie chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Tickets by Status",
+    "subtitle": "Share of tickets in each workflow state"
+  },
+  "data": {
+    "values": [
+      { "status": "Open", "count": 42 },
+      { "status": "In Progress", "count": 27 },
+      { "status": "Resolved", "count": 58 }
+    ]
+  },
+  "mark": { "type": "arc", "innerRadius": 40 },
+  "encoding": {
+    "theta": { "field": "count", "type": "quantitative", "title": "Tickets" },
+    "color": { "field": "status", "type": "nominal", "title": "Status" },
+    "tooltip": [
+      { "field": "status", "type": "nominal", "title": "Status" },
+      { "field": "count", "type": "quantitative", "title": "Tickets" }
+    ]
+  }
+}
+```
+
+### Histogram
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Order Value Distribution",
+    "subtitle": "Histogram of order totals in the filtered result set"
+  },
+  "data": {
+    "values": [
+      { "order_total": 24 },
+      { "order_total": 31 },
+      { "order_total": 39 },
+      { "order_total": 42 },
+      { "order_total": 63 },
+      { "order_total": 78 },
+      { "order_total": 95 }
+    ]
+  },
+  "mark": "bar",
+  "encoding": {
+    "x": { "bin": true, "field": "order_total", "type": "quantitative", "title": "Order Total" },
+    "y": { "aggregate": "count", "type": "quantitative", "title": "Count" },
+    "tooltip": [
+      { "aggregate": "count", "type": "quantitative", "title": "Count" }
+    ]
+  }
+}
+```

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/skills/analyze_data/SKILL.md

@@ -1,209 +1,22 @@
 name: analyze_data
-description: Analyze AdminForth resource data, summarize trends, and create charts from fetched rows.
+description: Analyze AdminForth resource data, summarize trends, and compare distributions from fetched rows.
 ---
 
 # Involved tools
 
 Use `get_resource` first if you need to inspect resource structure and column names.
 
-Use `get_resource_data` to fetch data for this skill. This is the main tool for loading rows for analytics, comparisons, distributions, and trend analysis.
+Use `aggregate` to fetch data for analytics whenever possible. This is the main tool for fast server-side aggregations, including filtered data, grouped metrics, and date buckets such as day, week, or month.
+
+Use `get_resource_data` only when the requested analysis cannot be answered with `aggregate`. This is heavier because it returns original rows with all fields, but it allows complex calculations, comparisons, and custom groupings in-memory.
 
 # Instructions
 
 When the user asks for analytics, reports, trends, comparisons, or distributions:
 
-- Fetch the requested data using `aggregate` tool. This tool is capable of performing fast server-side aggregations on filtered data, groupings by date including grouping by day/week/month etc. 
-- if it is not possible to get the required aggregates using `aggregate`, fetch the underlying rows with `get_resource_data`. This is much heavier since returns original rows  with all fields, but allows you to perform complex calculations, comparisons, and custom groupings in-memory. Always prefer `aggregate` when possible.
+- Fetch the requested data using `aggregate` whenever possible.
+- If it is not possible to get the required aggregates using `aggregate`, fetch the underlying rows with `get_resource_data`.
 - Prefer narrow requests: use filters, sorting, pagination, and date ranges whenever possible.
 - If the request is ambiguous, clarify the resource, metric, grouping, or date range before fetching data.
 - Return a short written summary with the key finding and most important numbers.
-- If a chart would help, produce a Vega-Lite spec.
-
-# Charts
-
-Use Vega-Lite syntax for charts.
-
-Return every chart as valid JSON inside a `vega-lite` fenced code block.
-
-Every chart spec should include:
-- `title.text`
-- `title.subtitle`
-- explicit axis titles when axes are used
-- tooltips for the key fields
-
-### Line chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Orders by Day",
-    "subtitle": "Daily order count for the selected date range"
-  },
-  "data": {
-    "values": [
-      { "date": "2026-04-01", "orders": 18 },
-      { "date": "2026-04-02", "orders": 25 },
-      { "date": "2026-04-03", "orders": 21 },
-      { "date": "2026-04-04", "orders": 29 }
-    ]
-  },
-  "mark": { "type": "line", "point": true },
-  "encoding": {
-    "x": { "field": "date", "type": "temporal", "title": "Date" },
-    "y": { "field": "orders", "type": "quantitative", "title": "Orders" },
-    "tooltip": [
-      { "field": "date", "type": "temporal", "title": "Date" },
-      { "field": "orders", "type": "quantitative", "title": "Orders" }
-    ]
-  }
-}
-```
-
-### Bar chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Revenue by Category",
-    "subtitle": "Top categories in the current filtered dataset"
-  },
-  "data": {
-    "values": [
-      { "category": "Hardware", "revenue": 42000 },
-      { "category": "Software", "revenue": 31500 },
-      { "category": "Services", "revenue": 22750 }
-    ]
-  },
-  "mark": "bar",
-  "encoding": {
-    "x": { "field": "category", "type": "nominal", "title": "Category", "sort": "-y" },
-    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
-    "tooltip": [
-      { "field": "category", "type": "nominal", "title": "Category" },
-      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
-    ]
-  }
-}
-```
-
-### Area chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Monthly Signups",
-    "subtitle": "New users accumulated across the last six months"
-  },
-  "data": {
-    "values": [
-      { "month": "2025-11-01", "signups": 120 },
-      { "month": "2025-12-01", "signups": 155 },
-      { "month": "2026-01-01", "signups": 168 },
-      { "month": "2026-02-01", "signups": 190 },
-      { "month": "2026-03-01", "signups": 214 },
-      { "month": "2026-04-01", "signups": 238 }
-    ]
-  },
-  "mark": { "type": "area", "line": true, "point": true },
-  "encoding": {
-    "x": { "field": "month", "type": "temporal", "title": "Month" },
-    "y": { "field": "signups", "type": "quantitative", "title": "Signups" },
-    "tooltip": [
-      { "field": "month", "type": "temporal", "title": "Month" },
-      { "field": "signups", "type": "quantitative", "title": "Signups" }
-    ]
-  }
-}
-```
-
-### Scatter plot
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Ad Spend vs Revenue",
-    "subtitle": "Campaign-level correlation for the selected month"
-  },
-  "data": {
-    "values": [
-      { "campaign": "Search", "spend": 1200, "revenue": 5400 },
-      { "campaign": "Social", "spend": 900, "revenue": 3100 },
-      { "campaign": "Email", "spend": 350, "revenue": 2200 },
-      { "campaign": "Affiliates", "spend": 700, "revenue": 3600 }
-    ]
-  },
-  "mark": { "type": "point", "filled": true, "size": 120 },
-  "encoding": {
-    "x": { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
-    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
-    "tooltip": [
-      { "field": "campaign", "type": "nominal", "title": "Campaign" },
-      { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
-      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
-    ]
-  }
-}
-```
-
-### Pie chart
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Tickets by Status",
-    "subtitle": "Share of tickets in each workflow state"
-  },
-  "data": {
-    "values": [
-      { "status": "Open", "count": 42 },
-      { "status": "In Progress", "count": 27 },
-      { "status": "Resolved", "count": 58 }
-    ]
-  },
-  "mark": { "type": "arc", "innerRadius": 40 },
-  "encoding": {
-    "theta": { "field": "count", "type": "quantitative", "title": "Tickets" },
-    "color": { "field": "status", "type": "nominal", "title": "Status" },
-    "tooltip": [
-      { "field": "status", "type": "nominal", "title": "Status" },
-      { "field": "count", "type": "quantitative", "title": "Tickets" }
-    ]
-  }
-}
-```
-
-### Histogram
-
-```vega-lite
-{
-  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
-  "title": {
-    "text": "Order Value Distribution",
-    "subtitle": "Histogram of order totals in the filtered result set"
-  },
-  "data": {
-    "values": [
-      { "order_total": 24 },
-      { "order_total": 31 },
-      { "order_total": 39 },
-      { "order_total": 42 },
-      { "order_total": 63 },
-      { "order_total": 78 },
-      { "order_total": 95 }
-    ]
-  },
-  "mark": "bar",
-  "encoding": {
-    "x": { "bin": true, "field": "order_total", "type": "quantitative", "title": "Order Total" },
-    "y": { "aggregate": "count", "type": "quantitative", "title": "Count" },
-    "tooltip": [
-      { "aggregate": "count", "type": "quantitative", "title": "Count" }
-    ]
-  }
-}
-```
+- If the user asks for a chart, or if a chart would help and you decide to produce one, invoke the `charts` skill for chart formatting and Vega-Lite requirements.

package/dist/custom/skills/charts/SKILL.md

@@ -0,0 +1,193 @@
+name: charts
+description: Create Vega-Lite chart specs for AdminForth analytics responses. Always use this skill when the user asks for a chart or when a chart would help illustrate the insights from an analytics query.
+---
+
+# Instructions
+
+Use Vega-Lite syntax for charts.
+
+Return every chart as valid JSON inside a `vega-lite` fenced code block.
+
+Every chart spec should include:
+
+- `title.text`
+- `title.subtitle`
+- explicit axis titles when axes are used
+- tooltips for the key fields
+
+### Line chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Orders by Day",
+    "subtitle": "Daily order count for the selected date range"
+  },
+  "data": {
+    "values": [
+      { "date": "2026-04-01", "orders": 18 },
+      { "date": "2026-04-02", "orders": 25 },
+      { "date": "2026-04-03", "orders": 21 },
+      { "date": "2026-04-04", "orders": 29 }
+    ]
+  },
+  "mark": { "type": "line", "point": true },
+  "encoding": {
+    "x": { "field": "date", "type": "temporal", "title": "Date" },
+    "y": { "field": "orders", "type": "quantitative", "title": "Orders" },
+    "tooltip": [
+      { "field": "date", "type": "temporal", "title": "Date" },
+      { "field": "orders", "type": "quantitative", "title": "Orders" }
+    ]
+  }
+}
+```
+
+### Bar chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Revenue by Category",
+    "subtitle": "Top categories in the current filtered dataset"
+  },
+  "data": {
+    "values": [
+      { "category": "Hardware", "revenue": 42000 },
+      { "category": "Software", "revenue": 31500 },
+      { "category": "Services", "revenue": 22750 }
+    ]
+  },
+  "mark": "bar",
+  "encoding": {
+    "x": { "field": "category", "type": "nominal", "title": "Category", "sort": "-y" },
+    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
+    "tooltip": [
+      { "field": "category", "type": "nominal", "title": "Category" },
+      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
+    ]
+  }
+}
+```
+
+### Area chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Monthly Signups",
+    "subtitle": "New users accumulated across the last six months"
+  },
+  "data": {
+    "values": [
+      { "month": "2025-11-01", "signups": 120 },
+      { "month": "2025-12-01", "signups": 155 },
+      { "month": "2026-01-01", "signups": 168 },
+      { "month": "2026-02-01", "signups": 190 },
+      { "month": "2026-03-01", "signups": 214 },
+      { "month": "2026-04-01", "signups": 238 }
+    ]
+  },
+  "mark": { "type": "area", "line": true, "point": true },
+  "encoding": {
+    "x": { "field": "month", "type": "temporal", "title": "Month" },
+    "y": { "field": "signups", "type": "quantitative", "title": "Signups" },
+    "tooltip": [
+      { "field": "month", "type": "temporal", "title": "Month" },
+      { "field": "signups", "type": "quantitative", "title": "Signups" }
+    ]
+  }
+}
+```
+
+### Scatter plot
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Ad Spend vs Revenue",
+    "subtitle": "Campaign-level correlation for the selected month"
+  },
+  "data": {
+    "values": [
+      { "campaign": "Search", "spend": 1200, "revenue": 5400 },
+      { "campaign": "Social", "spend": 900, "revenue": 3100 },
+      { "campaign": "Email", "spend": 350, "revenue": 2200 },
+      { "campaign": "Affiliates", "spend": 700, "revenue": 3600 }
+    ]
+  },
+  "mark": { "type": "point", "filled": true, "size": 120 },
+  "encoding": {
+    "x": { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
+    "y": { "field": "revenue", "type": "quantitative", "title": "Revenue" },
+    "tooltip": [
+      { "field": "campaign", "type": "nominal", "title": "Campaign" },
+      { "field": "spend", "type": "quantitative", "title": "Ad Spend" },
+      { "field": "revenue", "type": "quantitative", "title": "Revenue" }
+    ]
+  }
+}
+```
+
+### Pie chart
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Tickets by Status",
+    "subtitle": "Share of tickets in each workflow state"
+  },
+  "data": {
+    "values": [
+      { "status": "Open", "count": 42 },
+      { "status": "In Progress", "count": 27 },
+      { "status": "Resolved", "count": 58 }
+    ]
+  },
+  "mark": { "type": "arc", "innerRadius": 40 },
+  "encoding": {
+    "theta": { "field": "count", "type": "quantitative", "title": "Tickets" },
+    "color": { "field": "status", "type": "nominal", "title": "Status" },
+    "tooltip": [
+      { "field": "status", "type": "nominal", "title": "Status" },
+      { "field": "count", "type": "quantitative", "title": "Tickets" }
+    ]
+  }
+}
+```
+
+### Histogram
+
+```vega-lite
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "title": {
+    "text": "Order Value Distribution",
+    "subtitle": "Histogram of order totals in the filtered result set"
+  },
+  "data": {
+    "values": [
+      { "order_total": 24 },
+      { "order_total": 31 },
+      { "order_total": 39 },
+      { "order_total": 42 },
+      { "order_total": 63 },
+      { "order_total": 78 },
+      { "order_total": 95 }
+    ]
+  },
+  "mark": "bar",
+  "encoding": {
+    "x": { "bin": true, "field": "order_total", "type": "quantitative", "title": "Order Total" },
+    "y": { "aggregate": "count", "type": "quantitative", "title": "Count" },
+    "tooltip": [
+      { "aggregate": "count", "type": "quantitative", "title": "Count" }
+    ]
+  }
+}
+```

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.30.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",