@adminforth/agent 2.9.1 → 3.0.0

package/dist/domain/agentEvents.d.ts

@@ -1,4 +1,5 @@
 import type { ToolCallEvent } from "./toolCallEvents.js";
+import type { ApprovalDescription } from "../tools/approvalFormatter.js";
 export type AgentEvent = {
     type: "turn-started";
     messageId: string;
@@ -19,8 +20,8 @@ export type AgentEvent = {
     type: "interrupt";
     sessionId: string;
     interrupt: unknown;
-    /** One plain-language line per pending tool call, for the approval card. */
-    approvals: string[];
+    /** One description per pending tool call, for the approval card. */
+    approvals: ApprovalDescription[];
 } | {
     type: "steer-applied";
     count: number;

package/dist/tools/approvalFormatter.d.ts

@@ -1,12 +1,26 @@
-import type { IAdminForth } from "adminforth";
+import { type IAdminForth } from "adminforth";
 /** One tool call awaiting approval, normalized out of the provider interrupt payload. */
 export type ApprovalRequest = {
     toolName: string;
     args: Record<string, unknown>;
 };
+/** One value on the approval card; `from` is the stored value an update replaces. */
+export type ApprovalField = {
+    label: string;
+    from?: string;
+    to: string;
+};
+/** A tool call awaiting approval, described for the approval card. */
+export type ApprovalDescription = {
+    /** What the call does and to which record, e.g. `Update record with id:10 in Cars`. */
+    summary: string;
+    /** The values the call writes, in the resource's own wording. */
+    fields: ApprovalField[];
+};
 /**
- * Describe a tool call awaiting approval in a sentence an admin (not a developer) can
- * act on — resource and column labels instead of ids, values instead of raw JSON.
- * Falls back to a key/value dump for tool calls it does not recognize.
+ * Describe a tool call awaiting approval so an admin (not a developer) can act on it —
+ * resource and column labels instead of ids, values instead of raw JSON, and for an
+ * update the current value next to each new one. Tool calls it does not recognize are
+ * shown as their arguments.
  */
-export declare function formatApprovalRequest(adminforth: IAdminForth, request: ApprovalRequest): string;
+export declare function formatApprovalRequest(adminforth: IAdminForth, request: ApprovalRequest): Promise<ApprovalDescription>;

package/dist/tools/approvalFormatter.js

@@ -1,7 +1,17 @@
+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";
+import { getErrorMessage } from "../shared/errors.js";
 /** Argument keys that address the call itself rather than the data being changed. */
 const NON_FIELD_KEYS = new Set(["resourceId", "recordId", "primaryKey", "requiredColumnsToSkip", "meta", "extra"]);
 const MAX_VALUE_LENGTH = 80;
-const MAX_FIELDS = 12;
 function truncate(text, limit = MAX_VALUE_LENGTH) {
     return text.length > limit ? `${text.slice(0, limit - 1)}…` : text;
 }
@@ -45,23 +55,46 @@ function formatValue(value, column) {
     }
     return truncate(String(value));
 }
-/** `Brand: Tesla, Price: 45000` — the record payload in the resource's own wording. */
-function formatRecord(record, resource) {
+/**
+ * The record payload as labelled values in the resource's own wording. Every field is
+ * listed: the admin approves exactly what will be written. With `oldRecord` each value is
+ * paired with the one it replaces.
+ */
+function describeFields(record, resource, oldRecord) {
     var _a;
     if (record === null || typeof record !== "object" || Array.isArray(record)) {
-        return "";
+        return [];
     }
     const columnsByName = new Map(((_a = resource === null || resource === void 0 ? void 0 : resource.columns) !== null && _a !== void 0 ? _a : []).map((column) => [column.name, column]));
-    const entries = Object.entries(record)
-        .filter(([key]) => !NON_FIELD_KEYS.has(key));
-    const shown = entries.slice(0, MAX_FIELDS).map(([name, value]) => {
+    return Object.entries(record)
+        .filter(([key]) => !NON_FIELD_KEYS.has(key))
+        .map(([name, value]) => {
         const column = columnsByName.get(name);
-        return `${(column === null || column === void 0 ? void 0 : column.label) || humanize(name)}: ${formatValue(value, column)}`;
+        return {
+            label: (column === null || column === void 0 ? void 0 : column.label) || humanize(name),
+            from: oldRecord ? formatValue(oldRecord[name], column) : undefined,
+            to: formatValue(value, column),
+        };
+    });
+}
+/**
+ * The stored record an update would change, read the same way the update endpoint reads it.
+ * The preview must never block the approval prompt, so a failed read only drops the old values.
+ */
+function loadRecord(adminforth, resource, recordId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (!resource) {
+            return undefined;
+        }
+        try {
+            return (_a = yield adminforth.connectors[resource.dataSource].getRecordByPrimaryKey(resource, String(recordId))) !== null && _a !== void 0 ? _a : undefined;
+        }
+        catch (error) {
+            logger.warn(`Approval preview: failed to read record ${String(recordId)} of "${resource.resourceId}": ${getErrorMessage(error)}`);
+            return undefined;
+        }
     });
-    const hidden = entries.length - shown.length;
-    const lines = hidden > 0 ? [...shown, `and ${hidden} more`] : shown;
-    // One field per line: a wide record is unreadable as a single run-on sentence.
-    return lines.join(",\n");
 }
 function actionLabel(resource, actionId) {
     var _a, _b;
@@ -72,35 +105,50 @@ function actionLabel(resource, actionId) {
     return `"${(action === null || action === void 0 ? void 0 : action.name) || humanize(actionId)}"`;
 }
 /**
- * Describe a tool call awaiting approval in a sentence an admin (not a developer) can
- * act on — resource and column labels instead of ids, values instead of raw JSON.
- * Falls back to a key/value dump for tool calls it does not recognize.
+ * Describe a tool call awaiting approval so an admin (not a developer) can act on it —
+ * resource and column labels instead of ids, values instead of raw JSON, and for an
+ * update the current value next to each new one. Tool calls it does not recognize are
+ * shown as their arguments.
  */
 export function formatApprovalRequest(adminforth, request) {
-    const { args, toolName } = request;
-    const resource = findResource(adminforth, args.resourceId);
-    const label = resourceLabel(resource, args);
-    switch (toolName) {
-        case "create_record": {
-            const fields = formatRecord(args.record, resource);
-            return `Create a new record in ${label}${fields ? `:\n${fields}` : ""}`;
-        }
-        case "update_record": {
-            const fields = formatRecord(args.record, resource);
-            return `Update record with id:${formatValue(args.recordId)} in ${label}${fields ? `, set:\n${fields}` : ""}`;
-        }
-        case "delete_record":
-            return `Delete record with id:${formatValue(args.primaryKey)} from ${label} — this cannot be undone`;
-        case "start_custom_action":
-            return `Run ${actionLabel(resource, args.actionId)} on record ${formatValue(args.recordId)} in ${label}`;
-        case "start_custom_bulk_action":
-        case "start_bulk_action": {
-            const count = Array.isArray(args.recordIds) ? args.recordIds.length : 0;
-            return `Run ${actionLabel(resource, args.actionId)} on ${count} record(s) in ${label}`;
+    return __awaiter(this, void 0, void 0, function* () {
+        const { args, toolName } = request;
+        const resource = findResource(adminforth, args.resourceId);
+        const label = resourceLabel(resource, args);
+        switch (toolName) {
+            case "create_record":
+                return {
+                    summary: `Create a new record in ${label}`,
+                    fields: describeFields(args.record, resource),
+                };
+            case "update_record":
+                return {
+                    summary: `Update record with id:${formatValue(args.recordId)} in ${label}`,
+                    fields: describeFields(args.record, resource, yield loadRecord(adminforth, resource, args.recordId)),
+                };
+            case "delete_record":
+                return {
+                    summary: `Delete record with id:${formatValue(args.primaryKey)} from ${label} — this cannot be undone`,
+                    fields: [],
+                };
+            case "start_custom_action":
+                return {
+                    summary: `Run ${actionLabel(resource, args.actionId)} on record ${formatValue(args.recordId)} in ${label}`,
+                    fields: [],
+                };
+            case "start_custom_bulk_action":
+            case "start_bulk_action": {
+                const count = Array.isArray(args.recordIds) ? args.recordIds.length : 0;
+                return {
+                    summary: `Run ${actionLabel(resource, args.actionId)} on ${count} record(s) in ${label}`,
+                    fields: [],
+                };
+            }
+            default:
+                return {
+                    summary: humanize(toolName),
+                    fields: describeFields(args, resource),
+                };
         }
-        default: {
-            const fields = formatRecord(args, resource);
-            return `${humanize(toolName)}${fields ? `:\n${fields}` : ""}`;
-        }
-    }
+    });
 }

package/dist/transport/http/context.d.ts

@@ -1,6 +1,7 @@
 import type { ChatSurfaceAdapter, ChatSurfaceEventSink, ChatSurfaceIncomingMessage, IAdminForth, IAdminForthEndpointHandlerInput } from "adminforth";
 import type { HandleEditTurnInput, HandleSpeechTurnInput, HandleTurnInput, RunAndPersistAgentResponseInput, RunAndPersistAgentResponseResult } from "../../domain/turnTypes.js";
 import type { PluginOptions } from "../../types.js";
+import type { ApprovalDescription } from "../../tools/approvalFormatter.js";
 export type SessionTurn = {
     id: string;
     prompt: string;
@@ -22,7 +23,7 @@ export type AgentEndpointsContext = {
     }>;
     runAndPersistAgentResponse(input: RunAndPersistAgentResponseInput): Promise<RunAndPersistAgentResponseResult>;
     getSessionTurns(sessionId: string): Promise<SessionTurn[]>;
-    getPendingApprovals(sessionId: string): Promise<string[]>;
+    getPendingApprovals(sessionId: string): Promise<ApprovalDescription[]>;
     createNewTurn(sessionId: string, prompt: string, response?: string): Promise<string>;
     createSystemTurn(sessionId: string, systemMessage: string): Promise<string>;
     appendSteerToCurrentTurn(sessionId: string, steerText: string): Promise<void>;

package/dist/transport/http/sessionEndpoints.js

@@ -28,6 +28,10 @@ const sessionIdBodySchema = z.object({
 const createSessionBodySchema = z.object({
     triggerMessage: z.string().optional(),
 }).strict();
+const renameSessionBodySchema = z.object({
+    sessionId: z.string(),
+    title: z.string().trim().min(1).max(100),
+}).strict();
 export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
@@ -175,6 +179,36 @@ export function setupSessionEndpoints(ctx, server) {
             };
         })
     });
+    server.endpoint({
+        method: 'POST',
+        path: `/agent/rename-session`,
+        agent: {
+            hiddenFromAgents: true,
+        },
+        request_schema: renameSessionBodySchema,
+        handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
+            const data = body;
+            const session = yield ctx.adminforth.resource(ctx.options.sessionResource.resourceId).get([Filters.EQ(ctx.options.sessionResource.idField, data.sessionId)]);
+            if (!session) {
+                response.setStatus(404, 'Session not found');
+                return {
+                    error: 'Session not found'
+                };
+            }
+            if (session[ctx.options.sessionResource.askerIdField] !== adminUser.pk) {
+                response.setStatus(403, 'Unauthorized');
+                return {
+                    error: 'Unauthorized'
+                };
+            }
+            yield ctx.adminforth.resource(ctx.options.sessionResource.resourceId).update(data.sessionId, {
+                [ctx.options.sessionResource.titleField]: data.title,
+            });
+            return {
+                title: data.title,
+            };
+        })
+    });
     server.endpoint({
         method: 'POST',
         path: `/agent/add-system-message-to-turns`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adminforth/agent",
-  "version": "2.9.1",
+  "version": "3.0.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -36,7 +36,7 @@
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/node": "latest",
-    "adminforth": "^3.32.0",
+    "adminforth": "^4.1.0",
     "jest": "^30.3.0",
     "semantic-release": "^24.2.1",
     "semantic-release-slack-bot": "^4.0.2",
@@ -80,6 +80,6 @@
     }
   ],
   "peerDependencies": {
-    "adminforth": "^3.32.0"
+    "adminforth": "^4.1.0"
   }
 }

package/dist/custom/SteerDebugPanel.vue

@@ -1,45 +0,0 @@
-<!--
-  TEMPORARY debug helper: enqueues a test steer message into the buffer WITHOUT sending
-  or steering it, so the SteerQueue enter/leave animation can be exercised without a live
-  generating turn. Remove before shipping.
--->
-<template>
-  <div
-    class="fixed bottom-[400px] left-4 z-[9999] flex items-center gap-2 rounded-lg border border-dashed border-amber-400 bg-amber-50/95 px-2.5 py-2 shadow-lg backdrop-blur dark:border-amber-500 dark:bg-amber-950/95"
-  >
-    <span class="text-[10px] font-bold uppercase tracking-wider text-amber-600 dark:text-amber-400">
-      Steer&nbsp;debug
-    </span>
-    <input
-      v-model="debugText"
-      type="text"
-      placeholder="Test steer text…"
-      class="w-44 rounded-md border border-amber-300 bg-white px-2 py-1 text-xs text-gray-800 focus:outline-none focus:ring-1 focus:ring-amber-400 dark:border-amber-600 dark:bg-gray-800 dark:text-gray-100"
-      @keydown.enter.prevent="addTestSteer"
-    />
-    <button
-      type="button"
-      class="rounded-md bg-amber-500 px-2.5 py-1 text-xs font-semibold text-white transition-colors hover:bg-amber-600 active:bg-amber-700"
-      @click="addTestSteer"
-    >
-      Add steer
-    </button>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { ref } from 'vue';
-import { useAgentStore } from './composables/useAgentStore';
-
-const agentStore = useAgentStore();
-const debugText = ref('');
-let counter = 0;
-
-function addTestSteer() {
-  counter += 1;
-  const text = debugText.value.trim() || `Test steer #${counter}`;
-  // enqueue() only pushes onto the client-side buffer — no /agent/steer, no send.
-  agentStore.enqueueSteerMessage(text);
-  debugText.value = '';
-}
-</script>

package/dist/custom/conversation_area/ToolsGroup.vue

@@ -1,59 +0,0 @@
-<template >
-  <template v-if="toolGroup.length > 0">
-    <li class="mb-6 ms-2 z-50">
-      <span class="text-listTableHeadingText dark:text-darkListTableHeadingText bg-lightNavbar dark:bg-darkNavbar absolute flex items-center justify-center w-5 h-5 bg-brand-softer rounded-full -start-[0.68rem] ring-4 ring-lightNavbar dark:ring-darkNavbar ring-default">
-        <div class="w-5 h-5 rounded-full flex items-center justify-center">
-          <IconWrenchSolid class="w-4 h-4" />
-        </div>
-      </span>
-      <h3 
-        class="flex items-center mb-1 text-sm my-2 ml-3 gap-1 text-listTableHeadingText dark:text-darkListTableHeadingText"      
-      >
-        <span class="font-semibold select-none ">{{ $t('Call tools') }}</span>
-      </h3>
-      <div class="flex flex-wrap">
-        <template v-for="group in props.toolGroup" :key="group.title">
-          <ToolRenderer
-            v-if="isExpanded" 
-            v-for="part in group.groupedTools" 
-            :key="part.toolInfo.toolCallId" 
-            :data="part"
-          />
-        </template> 
-      </div>
-    </li>
-  </template>
-</template>
-
-<script setup lang="ts">
-import ToolRenderer from './ToolRenderer.vue';
-import type { IToolGroup } from '../types';
-import { IconWrenchSolid } from '@iconify-prerendered/vue-heroicons';
-
-const props = defineProps<{
-  toolGroup: IToolGroup[]
-  isExpanded: boolean
-}>();
-
-</script>
-
-<style scoped>
-
-.expand-enter-active,
-.expand-leave-active {
-  transition: all 0.3s ease;
-}
-
-.expand-enter-from,
-.expand-leave-to {
-  opacity: 0;
-  max-height: 0;
-}
-
-.expand-enter-to,
-.expand-leave-from {
-  opacity: 1;
-  max-height: 288px;
-}
-
-</style>