@adminforth/agent 2.8.2 → 2.9.0

package/README.md

@@ -115,7 +115,7 @@ sequenceDiagram
         M-->>LLM: reasoning and text deltas
         LLM-->>UI: reasoning-delta and text-delta frames
         M-->>LLM: tool call
-        alt tool has agent.isDangerous
+        alt tool has agent.requiresHumanApproval
             LLM-->>UI: data-interrupt, generation pauses
             U->>UI: approve or reject
             UI->>EP: POST /agent/approval
@@ -152,7 +152,7 @@ flowchart LR
     C -- yes --> E["fetch_skill returns the SKILL.md<br/>for the matching skill"]
     E --> F["fetch_tool_schema loads one<br/>API tool schema by name"]
     F --> G["ApiBasedToolsMiddleware sees the<br/>status 200 tool message and adds that<br/>tool to the next model call"]
-    G --> H{"agent.isDangerous?"}
+    G --> H{"agent.requiresHumanApproval?"}
     H -- yes --> I["humanInTheLoopMiddleware interrupt,<br/>approve or reject in the UI"]
     H -- no --> J["Execute through the AdminForth API layer"]
     I -- approved --> J
@@ -419,7 +419,7 @@ directories are also discovered.
 
 ## Human-in-the-loop approvals
 
-Tools whose definition marks them dangerous (`agent.isDangerous === true`) trigger an
+Tools whose endpoint sets `agent.requiresHumanApproval` (or the older `agent.isDangerous`) trigger an
 approval interrupt: generation pauses and the UI shows an approve/reject prompt. The client
 resolves it via `POST /agent/approval`, and the run resumes (or, on reject, the model is
 told the action was declined).

package/dist/llm/agentRuntime.js

@@ -17,7 +17,7 @@ import { createLegacySystemMessagesMiddleware } from "./middleware/legacySystemM
 import { buildDynamicSystemPrompt } from "../domain/systemPrompt.js";
 function createHumanInTheLoopInterrupts(apiBasedTools) {
     return Object.fromEntries(Object.entries(apiBasedTools)
-        .filter(([, apiBasedTool]) => { var _a; return ((_a = apiBasedTool.agent) === null || _a === void 0 ? void 0 : _a.isDangerous) === true; })
+        .filter(([, { agent }]) => (agent === null || agent === void 0 ? void 0 : agent.requiresHumanApproval) || (agent === null || agent === void 0 ? void 0 : agent.isDangerous))
         .map(([toolName]) => [
         toolName,
         {

package/dist/tools/apiBasedTools.d.ts

@@ -1,6 +1,9 @@
 import { type AdminUser, type IAdminForth } from 'adminforth';
 type AgentToolMeta = {
+    requiresHumanApproval?: boolean;
+    /** @deprecated Older name of `requiresHumanApproval`, still set by endpoints built for earlier AdminForth versions. */
     isDangerous?: boolean;
+    hiddenFromAgents?: boolean;
 };
 export type ApiBasedToolCallParams = {
     adminUser?: AdminUser;

package/dist/tools/apiBasedTools.js

@@ -438,13 +438,14 @@ function attachDurationMs(output, durationMs) {
     return { result: output, durationMs };
 }
 export function prepareApiBasedTools(adminforth, hiddenResourceIds = []) {
+    var _a;
     const apiBasedTools = {};
     const openApiSchemas = adminforth.openApi.registeredSchemas;
     const openApiSchemasByToolName = new Map();
     const hiddenResourceIdSet = new Set(hiddenResourceIds);
     for (const schema of openApiSchemas) {
         const toolName = openApiSchemaPathToToolName(schema.path, adminforth);
-        if (hasRegisteredApiToolHandler(schema)) {
+        if (hasRegisteredApiToolHandler(schema) && !((_a = schema.agent) === null || _a === void 0 ? void 0 : _a.hiddenFromAgents)) {
             openApiSchemasByToolName.set(toolName, schema);
         }
     }

package/dist/transport/http/chatSurfaceEndpoints.js

@@ -33,6 +33,9 @@ export function setupChatSurfaceEndpoints(ctx, server) {
             method: "POST",
             noAuth: true,
             path: `/agent/surface/${adapter.name}/webhook`,
+            agent: {
+                hiddenFromAgents: true,
+            },
             handler: (endpointInput) => __awaiter(this, void 0, void 0, function* () {
                 var _a;
                 const surfaceContext = {

package/dist/transport/http/coreEndpoints.js

@@ -71,6 +71,9 @@ export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/get-placeholder-messages`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ headers, adminUser }) {
             if (!ctx.options.placeholderMessages) {
                 return {
@@ -89,6 +92,9 @@ export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/response`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: agentResponseBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, _raw_express_res, abortSignal }) {
             var _b;
@@ -115,6 +121,9 @@ export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/edit`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: agentEditBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, _raw_express_res, abortSignal }) {
             var _b;
@@ -142,6 +151,9 @@ export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/approval`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: agentApprovalBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, _raw_express_res, abortSignal }) {
             const data = body;
@@ -166,6 +178,9 @@ export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/steer`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: agentSteerBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser }) {
             const data = body;
@@ -183,6 +198,9 @@ export function setupCoreEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/speech-response`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         target: 'upload',
         request_schema: agentSpeechResponseShapeSchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response, _raw_express_req, _raw_express_res, abortSignal }) {

package/dist/transport/http/sessionEndpoints.js

@@ -32,6 +32,9 @@ export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/get-sessions`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: getSessionsBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
             var _b;
@@ -51,6 +54,9 @@ export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/get-session-info`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: sessionIdBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
             const data = body;
@@ -114,6 +120,9 @@ export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/create-session`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: createSessionBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
             const data = body;
@@ -137,6 +146,9 @@ export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/delete-session`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: sessionIdBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
             const data = body;
@@ -166,6 +178,9 @@ export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/add-system-message-to-turns`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: addSystemMessageBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
             const data = body;
@@ -191,6 +206,9 @@ export function setupSessionEndpoints(ctx, server) {
     server.endpoint({
         method: 'POST',
         path: `/agent/append-steer-to-turn`,
+        agent: {
+            hiddenFromAgents: true,
+        },
         request_schema: appendSteerBodySchema,
         handler: (_a) => __awaiter(this, [_a], void 0, function* ({ body, adminUser, response }) {
             const data = body;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adminforth/agent",
-  "version": "2.8.2",
+  "version": "2.9.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.8.2",
+    "adminforth": "^3.32.0",
     "jest": "^30.3.0",
     "semantic-release": "^24.2.1",
     "semantic-release-slack-bot": "^4.0.2",
@@ -80,6 +80,6 @@
     }
   ],
   "peerDependencies": {
-    "adminforth": "^3.8.2"
+    "adminforth": "^3.32.0"
   }
 }