@adminforth/agent 1.49.3 → 1.50.1

package/dist/custom/composables/useAgentStore.ts

@@ -1,6 +1,7 @@
 import { defineStore } from 'pinia';
 import { IAgentSession, ISessionsListItem } from '../types';
 import { ref, nextTick, computed, watch, onMounted } from 'vue';
+import { useRouter } from 'vue-router';
 import { useAdminforth } from '@/adminforth';
 import { useCoreStore } from '@/stores/core';
 import { useAgentTransitions } from './useAgentTransitions';
@@ -28,6 +29,7 @@ export const useAgentStore = defineStore('agent', () => {
   const adminforth = useAdminforth();
   const isChatOpen = ref(false);
   const isSessionHistoryOpen = ref(false);
+  const router = useRouter();
   const textInput = ref<HTMLTextAreaElement | null>(null);
   const userMessageInput = ref();
   const trimmedUserMessage = computed(() => userMessageInput.value ? userMessageInput.value.trim() : '');
@@ -54,6 +56,7 @@ export const useAgentStore = defineStore('agent', () => {
   } = createAgentChatManager({
     lastMessage,
     activeModeName,
+    onOpenPage: openAgentPage,
   });
   const {
     userMessagePlaceholder,
@@ -324,6 +327,45 @@ export const useAgentStore = defineStore('agent', () => {
     addSystemMessage(RESERVED_SYSTEM_MESSAGE_CONTENT.AGENT_RESPONSE_ABORTED);
   }
 
+  function resolveInternalRoute(href: string): string | null {
+    if (href.startsWith('#')) {
+      return `${window.location.pathname}${window.location.search}${href}`;
+    }
+
+    if (href.startsWith('//')) {
+      return null;
+    }
+
+    const isAbsoluteWithScheme = /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(href);
+    const baseUrl = isAbsoluteWithScheme
+      ? undefined
+      : `${window.location.origin}/`;
+    const resolvedUrl = new URL(href, baseUrl ?? window.location.href);
+
+    if (resolvedUrl.origin !== window.location.origin) {
+      return null;
+    }
+
+    return `${resolvedUrl.pathname}${resolvedUrl.search}${resolvedUrl.hash}`;
+  }
+
+  function openAgentPage(targetPath: string) {
+    const internalRoute = resolveInternalRoute(targetPath);
+
+    if (internalRoute === null) {
+      console.warn('Ignoring external agent navigation target:', targetPath);
+      return;
+    }
+
+    if (isFullScreen.value && !coreStore.isMobile) {
+      setFullScreen(false);
+    } else if (coreStore.isMobile) {
+      setIsChatOpen(false);
+    }
+
+    void router.push(internalRoute);
+  }
+
   return {
     //_________-Sessions management-_____________
     activeSessionId,
@@ -374,6 +416,7 @@ export const useAgentStore = defineStore('agent', () => {
     addAgentMessage,
     addUserMessage,
     addDataToolCallMessage,
+    openAgentPage,
     setCurrentChatStatus,
     updateLastAgentMessage
   }

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

@@ -24,6 +24,8 @@ If several rows look similar, do not guess which one is "the same" record. Show
 
 For long texts show only several first words and add "..." at the end (only if user did not request this field specifically).
 
+Never show information about more than 10 records in one message. If a tool returns more than 10 relevant records, summarize the total count if known, show only the 10 most relevant records, and offer to narrow filters, sort differently, or continue with the next 10.
+
 Also when you communicate with user about record, add related link to this record. Build it as `{ADMIN_BASE_PATH}resource/{resourceId}/show/{primary key}`. Use _label from `get_resource_data` as anchor text for link (use markdown link). Links should always be relative paths and must start with `ADMIN_BASE_PATH`. Do not add an extra slash after `ADMIN_BASE_PATH`.
 
 Before sending the link, verify that the `resourceId`, `{primary key}`, `_label`, and shown fields come from the same exact returned row.

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

@@ -27,6 +27,8 @@ Also please add related link to record with will be changed. Build it as `{ADMIN
 
 Before sending the confirmation, verify that the `resourceId`, `{primary key}`, `_label`, and all shown fields come from the same exact fetched row.
 
+Never show information about more than 10 records in one message. If a mutation plan affects more than 10 records, show only the 10 most important examples plus the total count if known, and ask the user to confirm the clearly described full batch.
+
 And in the same message ask user for final confirmation.
 
 When creating new record, show user all data which you gona create and in same message ask for confirmation.
@@ -123,6 +125,8 @@ For decimal fields please use string values with dot as decimal separator.
 
 After creation of new record also show user a link to this record. If several records record were created, show links to all of them in list.
 
+If more than 10 records were created, show links or details for only 10 of them and summarize the remaining count.
+
 Omit any pictures or file paths, you are not capable of doing it. If they are not required all is good, if they are required, explain to user that you are not able to create record because of this reason.
 
 ### Working with dates 

package/dist/custom/tsconfig.json

@@ -1,6 +1,5 @@
 {
   "compilerOptions": {
-    "baseUrl": ".", // This should point to your project root
     "paths": {
       "@/*": [
         "../node_modules/adminforth/dist/spa/src/*"

package/dist/custom/types.ts

@@ -93,6 +93,12 @@ export type SpeechStreamEvent =
       type: 'data-tool-call';
       data: any;
     }
+  | {
+      type: 'open-page';
+      data: {
+        targetPath: string;
+      };
+    }
   | {
       type: 'finish';
     };

package/dist/endpoints/chatSurfaces.js

@@ -7,6 +7,25 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+function getHeaderValue(headers, name) {
+    var _a;
+    const value = (_a = headers[name]) !== null && _a !== void 0 ? _a : headers[name.toLowerCase()];
+    if (Array.isArray(value)) {
+        return value[0];
+    }
+    return typeof value === "string" ? value : undefined;
+}
+function getRequestOrigin(input) {
+    var _a, _b, _c, _d;
+    const forwardedProto = (_b = (_a = getHeaderValue(input.headers, "x-forwarded-proto")) === null || _a === void 0 ? void 0 : _a.split(",")[0]) === null || _b === void 0 ? void 0 : _b.trim();
+    const forwardedHost = (_d = (_c = getHeaderValue(input.headers, "x-forwarded-host")) === null || _c === void 0 ? void 0 : _c.split(",")[0]) === null || _d === void 0 ? void 0 : _d.trim();
+    const host = forwardedHost !== null && forwardedHost !== void 0 ? forwardedHost : getHeaderValue(input.headers, "host");
+    if (!host) {
+        return undefined;
+    }
+    const proto = forwardedProto !== null && forwardedProto !== void 0 ? forwardedProto : (host.startsWith("localhost") || host.startsWith("127.0.0.1") ? "http" : "https");
+    return `${proto}://${host}`;
+}
 export function setupChatSurfaceEndpoints(ctx, server) {
     var _a;
     for (const adapter of (_a = ctx.options.chatSurfaceAdapters) !== null && _a !== void 0 ? _a : []) {
@@ -26,6 +45,7 @@ export function setupChatSurfaceEndpoints(ctx, server) {
                 const incoming = yield adapter.parseIncomingMessage(surfaceContext);
                 if (!incoming)
                     return { ok: true };
+                incoming.metadata = Object.assign(Object.assign({}, incoming.metadata), { adminPublicOrigin: getRequestOrigin(endpointInput) });
                 const sink = yield adapter.createEventSink(surfaceContext, incoming);
                 try {
                     yield ctx.handleChatSurfaceMessage(adapter, incoming, sink);

package/dist/surfaces/web-sse/createSseEventEmitter.js

@@ -88,6 +88,14 @@ function createAgentEventStream(res, options = {}) {
                 },
             });
         },
+        openPage(targetPath) {
+            stream.send({
+                type: isAiUiMessageStream ? "data-open-page" : "open-page",
+                data: {
+                    targetPath,
+                },
+            });
+        },
         transcript(text, language) {
             stream.send({
                 type: isAiUiMessageStream ? "data-transcript" : "transcript",
@@ -186,6 +194,9 @@ export function createSseEventEmitter(res, options = {}) {
             case "rendering":
                 stream.rendering(event.phase, event.label);
                 break;
+            case "open-page":
+                stream.openPage(event.targetPath);
+                break;
             case "transcript":
                 stream.transcript(event.text, event.language);
                 break;

package/endpoints/chatSurfaces.ts

@@ -4,6 +4,31 @@ import type {
 } from "adminforth";
 import type { ChatSurfaceEndpointsContext } from "./context.js";
 
+function getHeaderValue(headers: Record<string, unknown>, name: string) {
+  const value = headers[name] ?? headers[name.toLowerCase()];
+
+  if (Array.isArray(value)) {
+    return value[0];
+  }
+
+  return typeof value === "string" ? value : undefined;
+}
+
+function getRequestOrigin(input: IAdminForthEndpointHandlerInput) {
+  const forwardedProto = getHeaderValue(input.headers, "x-forwarded-proto")?.split(",")[0]?.trim();
+  const forwardedHost = getHeaderValue(input.headers, "x-forwarded-host")?.split(",")[0]?.trim();
+  const host = forwardedHost ?? getHeaderValue(input.headers, "host");
+
+  if (!host) {
+    return undefined;
+  }
+
+  const proto = forwardedProto
+    ?? (host.startsWith("localhost") || host.startsWith("127.0.0.1") ? "http" : "https");
+
+  return `${proto}://${host}`;
+}
+
 export function setupChatSurfaceEndpoints(ctx: ChatSurfaceEndpointsContext, server: IHttpServer) {
   for (const adapter of ctx.options.chatSurfaceAdapters ?? []) {
     server.endpoint({
@@ -21,6 +46,10 @@ export function setupChatSurfaceEndpoints(ctx: ChatSurfaceEndpointsContext, serv
 
         const incoming = await adapter.parseIncomingMessage(surfaceContext);
         if (!incoming) return { ok: true };
+        incoming.metadata = {
+          ...incoming.metadata,
+          adminPublicOrigin: getRequestOrigin(endpointInput),
+        };
 
         const sink = await adapter.createEventSink(surfaceContext, incoming);
 

package/package.json

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

package/surfaces/web-sse/createSseEventEmitter.ts

@@ -123,6 +123,15 @@ function createAgentEventStream(
       });
     },
 
+    openPage(targetPath: string) {
+      stream.send({
+        type: isAiUiMessageStream ? "data-open-page" : "open-page",
+        data: {
+          targetPath,
+        },
+      });
+    },
+
     transcript(text: string, language?: string) {
       stream.send({
         type: isAiUiMessageStream ? "data-transcript" : "transcript",
@@ -250,6 +259,9 @@ export function createSseEventEmitter(
       case "rendering":
         stream.rendering(event.phase, event.label);
         break;
+      case "open-page":
+        stream.openPage(event.targetPath);
+        break;
       case "transcript":
         stream.transcript(event.text, event.language);
         break;