@adminforth/agent 1.1.1 → 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/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/Message.vue

@@ -2,12 +2,15 @@
   <div 
     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/incremark_code_renderers/IncremarkShikiCodeBlock.vue

@@ -18,7 +18,13 @@
 
     <div class="incremark-shiki-body">
       <div
-        v-if="renderedHtml"
+        v-if="shouldRenderVega && !renderedHtml"
+        ref="vegaContainer"
+        class="incremark-vega"
+      />
+
+      <div
+        v-else-if="renderedHtml"
         class="incremark-shiki-html"
         v-html="renderedHtml"
       />
@@ -31,6 +37,7 @@
 <script setup lang="ts">
 import type { Code } from 'mdast';
 import { computed, onBeforeUnmount, onMounted, ref, watch } from 'vue';
+import embed from 'vega-embed';
 
 import { highlightCodeSnippetHtml, type IncremarkCodeTheme } from './incremarkCodeHighlight';
 
@@ -53,15 +60,18 @@ const props = withDefaults(defineProps<{
 const renderedHtml = ref('');
 const copied = ref(false);
 const prefersDarkMode = ref(isDarkDocument());
+const vegaContainer = ref<HTMLDivElement | null>(null);
 
 let copyResetTimeout: number | null = null;
 let renderRequestId = 0;
 let scheduledFrameId: number | null = null;
 let themeObserver: MutationObserver | null = null;
+let vegaResult: { finalize: () => void } | null = null;
 
 const sourceCode = computed(() => props.node.value ?? '');
 const language = computed(() => props.node.lang?.trim().toLowerCase() || 'text');
-const languageLabel = computed(() => props.node.lang?.trim() || 'text');
+const languageLabel = computed(() => language.value === 'vega-lite' ? '' : props.node.lang?.trim() || 'text');
+const shouldRenderVega = computed(() => language.value === 'vega-lite' && props.blockStatus === 'completed');
 const codeTheme = computed<IncremarkCodeTheme>(() => {
   const requestedTheme = props.theme ?? (prefersDarkMode.value ? props.darkTheme : props.lightTheme);
 
@@ -77,7 +87,7 @@ const codeTheme = computed<IncremarkCodeTheme>(() => {
 });
 
 watch(
-  [sourceCode, language, codeTheme, () => props.disableHighlight],
+  [sourceCode, language, codeTheme, () => props.disableHighlight, () => props.blockStatus],
   () => {
     scheduleHighlight();
   },
@@ -86,6 +96,7 @@ watch(
 
 onMounted(() => {
   if (typeof MutationObserver === 'undefined' || typeof document === 'undefined') {
+    scheduleHighlight();
     return;
   }
 
@@ -97,10 +108,13 @@ onMounted(() => {
     attributes: true,
     attributeFilter: ['class'],
   });
+
+  scheduleHighlight();
 });
 
 onBeforeUnmount(() => {
   renderRequestId += 1;
+  clearVega();
 
   if (copyResetTimeout !== null) {
     window.clearTimeout(copyResetTimeout);
@@ -154,6 +168,45 @@ function scheduleHighlight() {
 async function renderHighlight() {
   const requestId = ++renderRequestId;
 
+  if (shouldRenderVega.value) {
+    renderedHtml.value = '';
+
+    if (!sourceCode.value || !vegaContainer.value) {
+      return;
+    }
+
+    try {
+      clearVega();
+      const spec = JSON.parse(sourceCode.value);
+
+      if (spec.width == null) {
+        spec.width = 'container';
+      }
+
+      if (spec.autosize == null) {
+        spec.autosize = { type: 'fit-x', contains: 'padding' };
+      }
+
+      const result = await embed(vegaContainer.value, spec, {
+        actions: false,
+        renderer: 'svg',
+      });
+
+      if (requestId !== renderRequestId) {
+        result.finalize();
+        return;
+      }
+
+      vegaResult = result;
+      return;
+    } catch (error) {
+      clearVega();
+      console.error('Failed to render Vega-Lite block', error);
+    }
+  } else {
+    clearVega();
+  }
+
   if (!sourceCode.value || props.disableHighlight) {
     renderedHtml.value = '';
     return;
@@ -177,6 +230,15 @@ async function renderHighlight() {
 function isDarkDocument(): boolean {
   return typeof document !== 'undefined' && document.documentElement.classList.contains('dark');
 }
+
+function clearVega() {
+  vegaResult?.finalize();
+  vegaResult = null;
+
+  if (vegaContainer.value) {
+    vegaContainer.value.innerHTML = '';
+  }
+}
 </script>
 
 <style scoped>
@@ -265,6 +327,11 @@ function isDarkDocument(): boolean {
   overflow-x: auto;
 }
 
+.incremark-vega {
+  padding: 18px;
+  width: 100%;
+}
+
 .incremark-shiki-fallback {
   margin: 0;
   padding: 18px;
@@ -298,4 +365,12 @@ function isDarkDocument(): boolean {
 :deep(.incremark-shiki-html .line) {
   min-height: 1.65em;
 }
+
+:deep(.incremark-vega .vega-embed) {
+  width: 100%;
+}
+
+:deep(.incremark-vega){
+  padding: 0;
+}
 </style>

package/dist/custom/package.json

@@ -21,6 +21,7 @@
     "ai": "^6.0.158",
     "dompurify": "^3.3.3",
     "katex": "^0.16.45",
-    "marked": "^18.0.0"
+    "marked": "^18.0.0",
+    "vega-embed": "^7.1.0"
   }
 }