@adminforth/agent 1.1.0 → 1.2.0

package/dist/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/dist/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/index.js

@@ -71,6 +71,14 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
             return { ok: true };
         });
     }
+    updateSessionDate(sessionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.adminforth.resource(this.options.sessionResource.resourceId).update(sessionId, {
+                [this.options.sessionResource.createdAtField]: new Date().toISOString(),
+            });
+            return { ok: true };
+        });
+    }
     getSessionTurns(sessionId) {
         return __awaiter(this, void 0, void 0, function* () {
             const turns = yield this.adminforth.resource(this.options.turnResource.resourceId).list([Filters.EQ(this.options.turnResource.sessionIdField, sessionId)], undefined, undefined, [Sorts.ASC(this.options.turnResource.createdAtField)]);
@@ -134,6 +142,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
                 const userTimeZone = (_e = body.timeZone) !== null && _e !== void 0 ? _e : 'UTC';
                 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);
                 let fullResponse = "";
                 let isStreamClosed = false;
                 const sequenceDebugCollector = createSequenceDebugCollector();

package/index.ts

@@ -87,6 +87,13 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
     return {ok: true};
   }
 
+  private async updateSessionDate(sessionId: string) {
+    await this.adminforth.resource(this.options.sessionResource.resourceId).update(sessionId, {
+      [this.options.sessionResource.createdAtField]: new Date().toISOString(),
+    });
+    return {ok: true};
+  }
+
   private async getSessionTurns(sessionId: string) {
     const turns = await this.adminforth.resource(this.options.turnResource.resourceId).list(
       [Filters.EQ(this.options.turnResource.sessionIdField, sessionId)],
@@ -150,6 +157,7 @@ export default class AdminForthAgentPlugin extends AdminForthPlugin {
         const userTimeZone = (body.timeZone as string | undefined) ?? 'UTC';
         const sessionId = body.sessionId || adminUser?.pk || adminUser?.username || 'default';
         const turnId = await this.createNewTurn(sessionId, prompt);
+        await this.updateSessionDate(sessionId);
         let fullResponse = "";
         let isStreamClosed = false;
         const sequenceDebugCollector = createSequenceDebugCollector();

package/package.json

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