@adminforth/agent 1.1.0 → 1.2.0

package/custom/skills/data-analytics/SKILL.md

@@ -0,0 +1,209 @@
+name: data-analytics
+description: Analyze AdminForth resource data, summarize trends, and create charts 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.
+
+# Instructions
+
+When the user asks for analytics, reports, trends, comparisons, or distributions:
+
+- Fetch the underlying rows with `get_resource_data`.
+- Prefer narrow requests: request only the columns you need and 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.
+- Compute aggregates from the returned rows yourself: sums, counts, averages, min/max, grouped totals, ratios, and trend deltas.
+- 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" }
+    ]
+  }
+}
+```

package/custom/useAgentStore.ts

@@ -120,6 +120,10 @@ export const useAgentStore = defineStore('agent', () => {
   });
   const blockCloseOfChat = ref(false);
 
+  function sortSessionsListByTimestamp(sessionsList: ISessionsListItem[]) {
+    return [...sessionsList].sort((a: ISessionsListItem, b: ISessionsListItem) => b.timestamp.localeCompare(a.timestamp));
+  }
+
   async function sendMessage() {
     const message = trimmedUserMessage.value;
     if (!message || isResponseInProgress.value) {
@@ -128,6 +132,11 @@ export const useAgentStore = defineStore('agent', () => {
     if (!currentSession.value || currentSession.value.sessionId === 'pre-session') {
       await createNewSession(message);
     }
+    currentSession.value.timestamp = new Date().toISOString();
+    sessionList.value = sortSessionsListByTimestamp(sessionList.value.map((s: ISessionsListItem) => s.sessionId === currentSession.value?.sessionId ? {
+      ...s,
+      timestamp: currentSession.value?.timestamp || s.timestamp,
+    } : s));
     lastMessage.value = message;
     currentChat.value?.sendMessage({
       text: message,

package/dist/agent/middleware/openAiResponsesContinuation.js

@@ -0,0 +1,66 @@
+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 { AIMessage } from "@langchain/core/messages";
+import { createMiddleware } from "langchain";
+function getTurnKey(context) {
+    return `${context.sessionId}:${context.turnId}`;
+}
+function getResponseId(message) {
+    var _a;
+    const metadata = message.response_metadata;
+    return (_a = metadata === null || metadata === void 0 ? void 0 : metadata.id) !== null && _a !== void 0 ? _a : null;
+}
+function getPreviousResponseId(modelSettings) {
+    return modelSettings === null || modelSettings === void 0 ? void 0 : modelSettings.previous_response_id;
+}
+function getContinuationMessages(messages, previousResponseId) {
+    var _a;
+    let continuationStartIndex = null;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (AIMessage.isInstance(message) &&
+            ((_a = message.response_metadata) === null || _a === void 0 ? void 0 : _a.id) ===
+                previousResponseId) {
+            continuationStartIndex = index + 1;
+            break;
+        }
+    }
+    if (continuationStartIndex === null) {
+        return null;
+    }
+    return messages.slice(continuationStartIndex);
+}
+export function createOpenAiResponsesContinuationMiddleware() {
+    const responseIdsByTurn = new Map();
+    return createMiddleware({
+        name: "OpenAiResponsesContinuationMiddleware",
+        wrapModelCall(request, handler) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                const context = request.runtime.context;
+                const turnKey = getTurnKey(context);
+                const previousResponseId = (_a = getPreviousResponseId(request.modelSettings)) !== null && _a !== void 0 ? _a : responseIdsByTurn.get(turnKey);
+                const continuationMessages = previousResponseId
+                    ? getContinuationMessages(request.messages, previousResponseId)
+                    : null;
+                const response = yield handler(previousResponseId && continuationMessages
+                    ? Object.assign(Object.assign({}, request), { messages: continuationMessages, modelSettings: Object.assign(Object.assign({}, request.modelSettings), { previous_response_id: previousResponseId }) }) : request);
+                const responseId = getResponseId(response);
+                if (responseId) {
+                    responseIdsByTurn.set(turnKey, responseId);
+                }
+                else {
+                    responseIdsByTurn.delete(turnKey);
+                }
+                return response;
+            });
+        },
+    });
+}

package/dist/agent/middleware/sequenceDebug.js

@@ -27,6 +27,8 @@ function createPendingSequenceDebug(sequenceId) {
         prompt: "",
         reasoning: "",
         text: "",
+        cachedTokens: 0,
+        responseId: null,
         toolCalls: [],
         pendingToolCalls: 0,
         resultType: null,
@@ -47,6 +49,8 @@ function finalizeSequenceDebug(sequence) {
         prompt: sequence.prompt,
         reasoning: sequence.reasoning,
         text: sequence.text,
+        cachedTokens: sequence.cachedTokens,
+        responseId: sequence.responseId,
         toolCalls: sequence.toolCalls.map((_a) => {
             var { completed: _completed } = _a, toolCall = __rest(_a, ["completed"]);
             return toolCall;
@@ -95,6 +99,7 @@ function hasToolCallSignal(message) {
             message.additional_kwargs.tool_calls.length > 0));
 }
 function extractSequenceResponseDebug(message) {
+    var _a, _b, _c, _d, _e;
     const blocks = getMessageBlocks(message);
     const reasoning = blocks
         .filter((block) => (block === null || block === void 0 ? void 0 : block.type) === "reasoning")
@@ -107,6 +112,8 @@ function extractSequenceResponseDebug(message) {
     return {
         reasoning,
         text: textFromBlocks || (typeof message.content === "string" ? message.content : ""),
+        cachedTokens: (_c = (_b = (_a = message.usage_metadata) === null || _a === void 0 ? void 0 : _a.input_token_details) === null || _b === void 0 ? void 0 : _b.cache_read) !== null && _c !== void 0 ? _c : 0,
+        responseId: (_e = (_d = message.response_metadata) === null || _d === void 0 ? void 0 : _d.id) !== null && _e !== void 0 ? _e : null,
         resultType: hasToolCallSignal(message) ? "tool_calls" : "final_text",
     };
 }
@@ -142,6 +149,8 @@ export function createSequenceDebugCollector() {
             const sequenceDebug = ensureSequenceDebug();
             sequenceDebug.reasoning = params.reasoning;
             sequenceDebug.text = params.text;
+            sequenceDebug.cachedTokens = params.cachedTokens;
+            sequenceDebug.responseId = params.responseId;
             sequenceDebug.resultType = params.resultType;
             if (sequenceDebug.resultType === "final_text" &&
                 sequenceDebug.pendingToolCalls === 0) {

package/dist/agent/simpleAgent.js

@@ -16,6 +16,7 @@ import { ChatOpenAI } from "@langchain/openai";
 import { createAgentTools } from "./tools/index.js";
 import { createApiBasedToolsMiddleware } from "./middleware/apiBasedTools.js";
 import { createSequenceDebugMiddleware, } from "./middleware/sequenceDebug.js";
+import { createOpenAiResponsesContinuationMiddleware } from "./middleware/openAiResponsesContinuation.js";
 const checkpointer = new MemorySaver();
 export const contextSchema = z.object({
     adminUser: z.custom(),
@@ -121,7 +122,8 @@ export function createAgentChatModel(params) {
     const model = (_c = (_b = params.modelName) !== null && _b !== void 0 ? _b : options.model) !== null && _c !== void 0 ? _c : "gpt-5-nano";
     const baseURL = (_d = options.baseURL) !== null && _d !== void 0 ? _d : options.baseUrl;
     const reasoning = normalizeReasoning(params.reasoning);
-    return new ChatOpenAI(Object.assign(Object.assign(Object.assign({ apiKey: options.openAiApiKey, model, maxTokens: params.maxTokens, useResponsesApi: true, outputVersion: "v1" }, (reasoning ? { reasoning } : {})), (typeof options.timeoutMs === "number"
+    // @ts-ignore
+    return new ChatOpenAI(Object.assign(Object.assign(Object.assign({ apiKey: options.openAiApiKey, model, maxTokens: params.maxTokens, useResponsesApi: true, outputVersion: "v1", promptCacheKey: `adminforth-agent:${model}:system-v1:tools-v1`, promptCacheRetention: "in_memory" }, (reasoning ? { reasoning } : {})), (typeof options.timeoutMs === "number"
         ? { timeout: options.timeoutMs }
         : {})), (baseURL
         ? {
@@ -136,13 +138,15 @@ export function callAgent(params) {
         const { name, model, summaryModel, messages, adminUser, apiBasedTools, customComponentsDir, sessionId, turnId, userTimeZone, emitToolCallEvent, sequenceDebugSink, } = params;
         const tools = yield createAgentTools(customComponentsDir, apiBasedTools);
         const apiBasedToolsMiddleware = createApiBasedToolsMiddleware(apiBasedTools);
+        const openAiResponsesContinuationMiddleware = createOpenAiResponsesContinuationMiddleware();
         const sequenceDebugMiddleware = createSequenceDebugMiddleware(sequenceDebugSink);
         const middleware = [
             apiBasedToolsMiddleware,
+            openAiResponsesContinuationMiddleware,
             sequenceDebugMiddleware,
             summarizationMiddleware({
                 model: summaryModel,
-                trigger: { tokens: 1024 * 8 },
+                trigger: { tokens: 1024 * 128 },
                 keep: { messages: 10 },
             }),
         ];

package/dist/custom/ConversationArea.vue

@@ -17,9 +17,10 @@
 
   </div>
   <AutoScrollContainer
-    enabled 
+    :enabled="!showScrollToBottomButton" 
     class="flex flex-col overflow-y-auto border-t border-gray-200 dark:border-gray-700"
     ref="scrollContainer"
+    :threshold="10"
     behavior="smooth"
   > 
 
@@ -57,8 +58,8 @@
       v-if="props.messages.length === 0"
       class="flex-1 flex flex-col items-center justify-center text-gray-400 tracking-widest text-xl font-medium"
     >
-      <p>Start the conversation</p>
-      <p class="tracking-normal text-base text">Give any input to begin</p>
+      <p>{{ $t('Start the conversation') }}</p>
+      <p class="tracking-normal text-base text">{{ $t('Give any input to begin') }}</p>
     </div>
   </AutoScrollContainer>
 </template>
@@ -151,20 +152,16 @@ const groupToolCallParts = (message: IMessage) => {
     if(!part?.toolInfo) {
       continue;
     }
-    console.log('part', part);
     if (part.toolInfo.toolName === currentToolName) {
-      console.log('grouping part with tool name', currentToolName);
       groupedParts[groupedParts.length - 1].groupedTools.push(part);
       continue;
     }
     currentToolName = part.toolInfo.toolName;
-    console.log('starting new group with tool name', currentToolName);
     groupedParts.push({
       title: currentToolName,
       groupedTools: [part]
     });
   }  
-  console.log('groupedParts', groupedParts);
   return groupedParts;
 }
 

package/dist/custom/Message.vue

@@ -1,13 +1,16 @@
 <template>
   <div 
-    class="max-w-[80%] flex px-4 py-2 m-2 rounded-xl border border-gray-200 dark:border-gray-700"
+    class="max-w-[80%] flex px-4 m-2 rounded-xl border border-gray-200 dark:border-gray-700"
     @click="handleMarkdownLinkClick"
-    :class="props.role === 'user' ? 'bg-lightListTableHeading dark:bg-darkListTableHeading self-end' 
+    :class="[
+      hasVegaLite ? 'w-full' : '',
+      props.role === 'user' ? 'bg-lightListTableHeading dark:bg-darkListTableHeading self-end' 
       : isTypeReasoning || isTypeToolCall ? 'bg-transparent border-none self-start' 
-        : 'bg-blue-100 dark:bg-blue-700/10 self-start'"
+        : 'bg-blue-100 dark:bg-blue-700/10 self-start'
+    ]"
   >
     <IncremarkContent
-      class="text-wrap break-words max-w-full"
+      class="text-wrap break-words w-full max-w-full"
       v-if="content && props.type === 'text'"
       :content="content" 
       :is-finished="isFinished" 
@@ -88,6 +91,7 @@
   const content = computed(() => props.message)
   const isFinished = computed(() => props.state === 'done')
   const isThoughtsExpanded = ref(false)
+  const hasVegaLite = computed(() => props.type === 'text' && props.message.includes('```vega-lite'))
 
   const isTypeReasoning = computed(() => props.type === 'reasoning')
   const isTypeToolCall = computed(() => props.type === 'data-tool-call')

package/dist/custom/SessionsHistory.vue

@@ -6,14 +6,14 @@
     "
   >
     <h3 :class="h3Style">{{ $t('Chat history') }}</h3>
-    <Button @click="agentStore.createPreSession()" :disabled="agentStore.isResponseInProgress" class="w-[360px] mx-4 my-2 mb-4 rounded-3xl text-gray-800 dark:text-gray-200">
+    <Button @click="agentStore.createPreSession(); agentStore.setSessionHistoryOpen(false)" :disabled="agentStore.isResponseInProgress" class="w-[360px] mx-4 my-2 mb-4 rounded-3xl text-gray-800 dark:text-gray-200">
       <IconPlusOutline class="w-5 h-5" />
       {{ $t('New chat') }}
     </Button>
     <div class="w-full border-b border-gray-200 dark:border-gray-700"/>
     <div class="absolute w-full h-full flex flex-col items-center justify-center bg-gray-100/50 dark:bg-gray-700/50 z-10" v-if="agentStore.isResponseInProgress">
       <Spinner class="w-8 h-8" v-if="agentStore.isResponseInProgress" />
-      <p class="mt-2 text-gray-800 dark:text-gray-200">generation in progress...</p>
+      <p class="mt-2 text-gray-800 dark:text-gray-200">{{ $t('Generation in progress...') }}</p>
     </div>
     <div v-for="group in groupedSessions" :key="group.dayKey" class="w-full py-2">
       <div class="px-4 pb-2 text-xs font-semibold uppercase tracking-[0.2em] text-gray-500 dark:text-gray-400">
@@ -38,7 +38,7 @@
       v-if="!groupedSessions || groupedSessions.length === 0"
       class="w-full h-full flex items-center justify-center text-gray-800 dark:text-gray-200"
     >
-      There is no previous chat sessions
+      {{ $t('There are no previous chat sessions') }}
     </p>
   </div>
 </template>

package/dist/custom/ToolRenderer.vue

@@ -1,5 +1,8 @@
 <template>
-  <div v-if="props.data?.toolInfo" class="inline-flex m-2 max-w-[80%] flex-col gap-3 rounded-xl p-2 text-lightListTableHeadingText dark:text-darkListTableHeadingText">
+  <div 
+    class="inline-flex m-2 max-w-[80%] flex-col gap-3 rounded-xl p-2 cursor-pointer text-lightListTableHeadingText dark:text-darkListTableHeadingText hover:opacity-75"         
+    @click="isInputOutputExpanded = !isInputOutputExpanded"
+  >
     <div class="flex items-center gap-3">
       <div class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-white/70 dark:bg-blue-700/20">
         <Spinner v-if="isRunning" class="h-4 w-4" />
@@ -18,8 +21,7 @@
       <IconAngleDownOutline
         v-if="hasToolSections"
         :class="isInputOutputExpanded ? 'rotate-180' : 'rotate-0'"
-        class="cursor-pointer transition-transform duration-200 hover:scale-105 hover:opacity-75"
-        @click="isInputOutputExpanded = !isInputOutputExpanded"
+        class="cursor-pointer transition-transform duration-200 hover:scale-105"
       />
     </div>
     <transition name="expand">

package/dist/custom/ToolsGroup.vue

@@ -1,8 +1,9 @@
 <template>
   <template v-for="group in props.toolGroup" :key="group.title">
-    <div v-if="group.groupedTools.length > 1" class="mb-4 flex flex-col">
-      <div class="flex items-center gap-2 p-2 m-2 cursor-pointer hover:opacity-75 break-all font-mono text-sm leading-5" @click="toggleGroup(group.title)">
-        - {{ group.title }} {{ 'x' + group.groupedTools.length }} 
+    <div v-if="group.groupedTools.length > 1" class="flex flex-col">
+      <div class="flex items-center gap-2 p-2 m-2 cursor-pointer hover:opacity-75 break-all font-mono text-sm leading-5 text-lightListTableHeadingText dark:text-darkListTableHeadingText" @click="toggleGroup(group.title)">
+        <IconMinusOutline  class="w-6 h-6 p-1"/> 
+        {{ group.title }} {{ 'x' + group.groupedTools.length }} 
         <IconAngleDownOutline 
           class="transition-transform duration-200 hover:scale-105 hover:opacity-75"
           :class="expandedGroups.includes(group.title) ? 'rotate-180' : 'rotate-0'"
@@ -10,7 +11,7 @@
       </div>
       <transition name="expand">
         <div v-show="expandedGroups.includes(group.title)" class="flex flex-col"> 
-        <ToolRenderer v-for="part in group.groupedTools" :key="part.text + part.type" :data="part" />
+        <ToolRenderer v-for="part in group.groupedTools" :key="part.text + part.type" :data="part" class="ml-8"/>
         </div>
       </transition>
     </div>
@@ -24,7 +25,7 @@ import { Tool } from 'langchain';
 import ToolRenderer from './ToolRenderer.vue';
 import type { IPart } from './types';
 import { ref } from 'vue';
-import { IconAngleDownOutline } from '@iconify-prerendered/vue-flowbite';
+import { IconAngleDownOutline, IconMinusOutline } from '@iconify-prerendered/vue-flowbite';
 
 const props = defineProps<{
   toolGroup: {