@arvo-tools/agentic 1.1.1 → 1.2.0

package/dist/Agent/agentLoop.d.ts

@@ -1,6 +1,7 @@
 import type z from 'zod';
 import type { AgentLLMIntegration, AgentLLMIntegrationParam } from '../Integrations/types.js';
 import type { IMCPClient } from '../interfaces.mcp.js';
+import type { IPermissionManager, PermissionManagerContext } from '../interfaces.permission.manager.js';
 import type { OtelInfoType } from '../types.js';
 import type { AgentEventStreamer } from './stream/types.js';
 import type { AgentMessage, AgentOutputBuilder, AgentToolDefinition, CreateArvoAgentParam } from './types.js';
@@ -42,6 +43,9 @@ export declare const agentLoop: (param: {
         completion: number;
     };
     onStream: AgentEventStreamer;
+    permissionPolicy: string[];
+    permissionManager: IPermissionManager | null;
+    permissionManagerContext: PermissionManagerContext;
 }, config: {
     otelInfo: OtelInfoType;
 }) => Promise<{

package/dist/Agent/agentLoop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EAGnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO;IACL,aAAa,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,aAAa,EAAE,kBAAkB,CAAC;IAClC,eAAe,EAAE,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACtE,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBALtB,MAAM;oBACF,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBADV,MAAM;oBACF,MAAM;;;EA+UpB,CAAC"}
+{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EAGnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO;IACL,aAAa,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,aAAa,EAAE,kBAAkB,CAAC;IAClC,eAAe,EAAE,WAAW,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACtE,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,0BAA0B,EAAE,MAAM,CAAC;IACnC,uBAAuB,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C,wBAAwB,EAAE,wBAAwB,CAAC;CACpD,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBARtB,MAAM;oBACF,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBADV,MAAM;oBACF,MAAM;;;EAucpB,CAAC"}

package/dist/Agent/agentLoop.js

@@ -86,6 +86,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.agentLoop = void 0;
 var openinference_semantic_conventions_1 = require("@arizeai/openinference-semantic-conventions");
 var arvo_core_1 = require("arvo-core");
+var uuid_1 = require("uuid");
 var utils_1 = require("./utils");
 /**
  * The Core Cognitive Loop of the Arvo Agent.
@@ -122,11 +123,11 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                             _a),
                     },
                     fn: function (span) { return __awaiter(void 0, void 0, void 0, function () {
-                        var otelInfo, nameToToolMap, lifecycle, executionUnits, tokenUsage, currentToolInteractionCount, messages, toolQuotaExhausted, response, i, arvoToolCalls, mcpToolResultPromises, internalToolResultPromises, _loop_1, _a, _b, item, _c, _d, item, e_1_1, _e, _f, item, e_2_1, outputResult;
-                        var e_3, _g, e_1, _h, e_2, _j;
-                        var _k, _l, _m, _o, _p, _q, _r, _s, _t;
-                        return __generator(this, function (_u) {
-                            switch (_u.label) {
+                        var otelInfo, nameToToolMap, lifecycle, executionUnits, tokenUsage, currentToolInteractionCount, messages, toolQuotaExhausted, response, i, arvoToolCalls, mcpToolResultPromises, internalToolResultPromises, prioritizedToolCalls, toolPermissionMap, toolsPendingPermission, _loop_1, prioritizedToolCalls_1, prioritizedToolCalls_1_1, item, _a, _b, item, e_1_1, _c, _d, item, e_2_1, toolPermissionRequest, outputResult;
+                        var e_3, _e, e_1, _f, e_2, _g;
+                        var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+                        return __generator(this, function (_v) {
+                            switch (_v.label) {
                                 case 0:
                                     otelInfo = {
                                         span: span,
@@ -136,14 +137,14 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                     lifecycle = param.initLifecycle;
                                     executionUnits = param.currentTotalExecutionUnits;
                                     tokenUsage = param.currentTotalUsageTokens;
-                                    _u.label = 1;
+                                    _v.label = 1;
                                 case 1:
-                                    _u.trys.push([1, , 22, 23]);
+                                    _v.trys.push([1, , 25, 26]);
                                     currentToolInteractionCount = param.toolInteraction.current;
                                     messages = __spreadArray([], __read(param.messages), false);
-                                    _u.label = 2;
+                                    _v.label = 2;
                                 case 2:
-                                    if (!(currentToolInteractionCount <= param.toolInteraction.max)) return [3 /*break*/, 21];
+                                    if (!(currentToolInteractionCount <= param.toolInteraction.max)) return [3 /*break*/, 24];
                                     toolQuotaExhausted = !(currentToolInteractionCount < param.toolInteraction.max);
                                     param.onStream({
                                         type: lifecycle === 'init'
@@ -180,7 +181,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                             onStream: param.onStream,
                                         }, { otelInfo: otelInfo })];
                                 case 3:
-                                    response = _u.sent();
+                                    response = _v.sent();
                                     currentToolInteractionCount++;
                                     executionUnits += response.executionUnits;
                                     tokenUsage.completion += response.usage.tokens.completion;
@@ -190,10 +191,18 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                     for (i = 0; i < messages.length; i++) {
                                         messages[i].seenCount += 1;
                                     }
-                                    if (!(response.type === 'tool_call')) return [3 /*break*/, 19];
+                                    if (!(response.type === 'tool_call')) return [3 /*break*/, 22];
                                     arvoToolCalls = [];
                                     mcpToolResultPromises = [];
                                     internalToolResultPromises = [];
+                                    prioritizedToolCalls = (0, utils_1.prioritizeToolCalls)(response.toolRequests, nameToToolMap);
+                                    return [4 /*yield*/, ((_h = param.permissionManager) === null || _h === void 0 ? void 0 : _h.get(param.permissionManagerContext, prioritizedToolCalls
+                                            .filter(function (item) { return param.permissionPolicy.includes(item.name); })
+                                            .map(function (item) { return nameToToolMap[item.name]; })
+                                            .filter(Boolean), { otelInfo: otelInfo }))];
+                                case 4:
+                                    toolPermissionMap = (_j = (_v.sent())) !== null && _j !== void 0 ? _j : {};
+                                    toolsPendingPermission = [];
                                     _loop_1 = function (item) {
                                         param.onStream({
                                             type: 'agent.tool.request',
@@ -232,6 +241,48 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                             });
                                             return "continue";
                                         }
+                                        // Block tool call with no permission and build permission request
+                                        if (toolPermissionMap[item.name] === false) {
+                                            toolsPendingPermission.push(resolvedToolDef);
+                                            messages.push({
+                                                role: 'user',
+                                                content: {
+                                                    type: 'tool_result',
+                                                    toolUseId: item.toolUseId,
+                                                    content: (0, arvo_core_1.cleanString)("\n                      [Critical] The tool \"".concat(item.name, "\" call was blocked this time as it required external permissions. \n                      The permission request has been lodged and responded to. Please try again.\n                      You can request any tool call, the system is here to facilitate with the permission \n                      acquiry. You as an AI Agent don't have to concern yourself with tool permission details.\n                    ")),
+                                                },
+                                                seenCount: 0,
+                                            });
+                                            (0, arvo_core_1.logToSpan)({
+                                                level: 'WARNING',
+                                                message: "Tool \"".concat(item.name, "\" blocked - permission required"),
+                                                tool: JSON.stringify({
+                                                    name: item.name,
+                                                    kind: resolvedToolDef.serverConfig.kind,
+                                                    originalName: resolvedToolDef.serverConfig.name,
+                                                    toolUseId: item.toolUseId,
+                                                }),
+                                                context: JSON.stringify({
+                                                    accessControl: param.permissionManagerContext.accesscontrol,
+                                                    agent: param.permissionManagerContext.name,
+                                                }),
+                                            }, span);
+                                            param.onStream({
+                                                type: 'agent.tool.permission.blocked',
+                                                data: {
+                                                    tools: [
+                                                        {
+                                                            name: item.name,
+                                                            kind: resolvedToolDef.serverConfig.kind,
+                                                            originalName: resolvedToolDef.serverConfig.name,
+                                                        },
+                                                    ],
+                                                    usage: tokenUsage,
+                                                    executionunits: executionUnits,
+                                                },
+                                            });
+                                            return "continue";
+                                        }
                                         if (resolvedToolDef.serverConfig.kind === 'mcp') {
                                             mcpToolResultPromises.push((function () { return __awaiter(void 0, void 0, void 0, function () {
                                                 var response;
@@ -315,72 +366,113 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                         }
                                     };
                                     try {
-                                        for (_a = (e_3 = void 0, __values((0, utils_1.prioritizeToolCalls)(response.toolRequests, nameToToolMap))), _b = _a.next(); !_b.done; _b = _a.next()) {
-                                            item = _b.value;
+                                        for (prioritizedToolCalls_1 = (e_3 = void 0, __values(prioritizedToolCalls)), prioritizedToolCalls_1_1 = prioritizedToolCalls_1.next(); !prioritizedToolCalls_1_1.done; prioritizedToolCalls_1_1 = prioritizedToolCalls_1.next()) {
+                                            item = prioritizedToolCalls_1_1.value;
                                             _loop_1(item);
                                         }
                                     }
                                     catch (e_3_1) { e_3 = { error: e_3_1 }; }
                                     finally {
                                         try {
-                                            if (_b && !_b.done && (_g = _a.return)) _g.call(_a);
+                                            if (prioritizedToolCalls_1_1 && !prioritizedToolCalls_1_1.done && (_e = prioritizedToolCalls_1.return)) _e.call(prioritizedToolCalls_1);
                                         }
                                         finally { if (e_3) throw e_3.error; }
                                     }
-                                    _u.label = 4;
-                                case 4:
-                                    _u.trys.push([4, 9, 10, 11]);
+                                    _v.label = 5;
+                                case 5:
+                                    _v.trys.push([5, 10, 11, 12]);
                                     e_1 = void 0;
                                     return [4 /*yield*/, Promise.all(mcpToolResultPromises)];
-                                case 5:
-                                    _c = (__values.apply(void 0, [_u.sent()])), _d = _c.next();
-                                    _u.label = 6;
                                 case 6:
-                                    if (!!_d.done) return [3 /*break*/, 8];
-                                    item = _d.value;
-                                    messages.push({ role: 'user', content: item, seenCount: 0 });
-                                    _u.label = 7;
+                                    _a = (__values.apply(void 0, [_v.sent()])), _b = _a.next();
+                                    _v.label = 7;
                                 case 7:
-                                    _d = _c.next();
-                                    return [3 /*break*/, 6];
-                                case 8: return [3 /*break*/, 11];
-                                case 9:
-                                    e_1_1 = _u.sent();
-                                    e_1 = { error: e_1_1 };
-                                    return [3 /*break*/, 11];
+                                    if (!!_b.done) return [3 /*break*/, 9];
+                                    item = _b.value;
+                                    messages.push({ role: 'user', content: item, seenCount: 0 });
+                                    _v.label = 8;
+                                case 8:
+                                    _b = _a.next();
+                                    return [3 /*break*/, 7];
+                                case 9: return [3 /*break*/, 12];
                                 case 10:
+                                    e_1_1 = _v.sent();
+                                    e_1 = { error: e_1_1 };
+                                    return [3 /*break*/, 12];
+                                case 11:
                                     try {
-                                        if (_d && !_d.done && (_h = _c.return)) _h.call(_c);
+                                        if (_b && !_b.done && (_f = _a.return)) _f.call(_a);
                                     }
                                     finally { if (e_1) throw e_1.error; }
                                     return [7 /*endfinally*/];
-                                case 11:
-                                    _u.trys.push([11, 16, 17, 18]);
+                                case 12:
+                                    _v.trys.push([12, 17, 18, 19]);
                                     e_2 = void 0;
                                     return [4 /*yield*/, Promise.all(internalToolResultPromises)];
-                                case 12:
-                                    _e = (__values.apply(void 0, [_u.sent()])), _f = _e.next();
-                                    _u.label = 13;
                                 case 13:
-                                    if (!!_f.done) return [3 /*break*/, 15];
-                                    item = _f.value;
-                                    messages.push({ role: 'user', content: item, seenCount: 0 });
-                                    _u.label = 14;
+                                    _c = (__values.apply(void 0, [_v.sent()])), _d = _c.next();
+                                    _v.label = 14;
                                 case 14:
-                                    _f = _e.next();
-                                    return [3 /*break*/, 13];
-                                case 15: return [3 /*break*/, 18];
-                                case 16:
-                                    e_2_1 = _u.sent();
-                                    e_2 = { error: e_2_1 };
-                                    return [3 /*break*/, 18];
+                                    if (!!_d.done) return [3 /*break*/, 16];
+                                    item = _d.value;
+                                    messages.push({ role: 'user', content: item, seenCount: 0 });
+                                    _v.label = 15;
+                                case 15:
+                                    _d = _c.next();
+                                    return [3 /*break*/, 14];
+                                case 16: return [3 /*break*/, 19];
                                 case 17:
+                                    e_2_1 = _v.sent();
+                                    e_2 = { error: e_2_1 };
+                                    return [3 /*break*/, 19];
+                                case 18:
                                     try {
-                                        if (_f && !_f.done && (_j = _e.return)) _j.call(_e);
+                                        if (_d && !_d.done && (_g = _c.return)) _g.call(_c);
                                     }
                                     finally { if (e_2) throw e_2.error; }
                                     return [7 /*endfinally*/];
-                                case 18:
+                                case 19:
+                                    if (!(param.permissionManager && toolsPendingPermission.length)) return [3 /*break*/, 21];
+                                    return [4 /*yield*/, ((_u = param.permissionManager) === null || _u === void 0 ? void 0 : _u.requestBuilder(param.permissionManagerContext, toolsPendingPermission, { otelInfo: otelInfo }))];
+                                case 20:
+                                    toolPermissionRequest = _v.sent();
+                                    arvoToolCalls.push({
+                                        type: 'tool_use',
+                                        name: param.permissionManager.contract.accepts.type,
+                                        toolUseId: (0, uuid_1.v4)(),
+                                        input: toolPermissionRequest,
+                                    });
+                                    (0, arvo_core_1.logToSpan)({
+                                        level: 'INFO',
+                                        message: "Permission request created for ".concat(toolsPendingPermission.length, " blocked tool(s)"),
+                                        permissionRequest: JSON.stringify({
+                                            contractType: param.permissionManager.contract.accepts.type,
+                                            toolCount: toolsPendingPermission.length,
+                                            tools: toolsPendingPermission.map(function (tool) { return ({
+                                                name: tool.name,
+                                                kind: tool.serverConfig.kind,
+                                                originalName: tool.serverConfig.name,
+                                            }); }),
+                                        }),
+                                        context: JSON.stringify({
+                                            accessControl: param.permissionManagerContext.accesscontrol,
+                                            agent: param.permissionManagerContext.name,
+                                        }),
+                                    }, span);
+                                    param.onStream({
+                                        type: 'agent.tool.permission.requested',
+                                        data: {
+                                            tools: toolsPendingPermission.map(function (tool) { return ({
+                                                name: tool.name,
+                                                kind: tool.serverConfig.kind,
+                                                originalName: tool.serverConfig.name,
+                                            }); }),
+                                            usage: tokenUsage,
+                                            executionunits: executionUnits,
+                                        },
+                                    });
+                                    _v.label = 21;
+                                case 21:
                                     if (arvoToolCalls.length) {
                                         param.onStream({
                                             type: 'agent.tool.request.delegation',
@@ -403,7 +495,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                     }
                                     lifecycle = 'tool_result';
                                     return [3 /*break*/, 2];
-                                case 19:
+                                case 22:
                                     param.onStream({
                                         type: 'agent.output.finalization',
                                         data: {
@@ -413,8 +505,8 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                         },
                                     });
                                     return [4 /*yield*/, param.outputBuilder(__assign(__assign({}, response), { outputFormat: param.outputFormat, span: span }))];
-                                case 20:
-                                    outputResult = _u.sent();
+                                case 23:
+                                    outputResult = _v.sent();
                                     if ('error' in outputResult && outputResult.error) {
                                         messages.push({
                                             role: 'assistant',
@@ -470,11 +562,11 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                             }];
                                     }
                                     return [3 /*break*/, 2];
-                                case 21: throw new Error("Tool calls exhausted the max quota: ".concat(currentToolInteractionCount));
-                                case 22:
+                                case 24: throw new Error("Tool calls exhausted the max quota: ".concat(currentToolInteractionCount));
+                                case 25:
                                     span.end();
                                     return [7 /*endfinally*/];
-                                case 23: return [2 /*return*/];
+                                case 26: return [2 /*return*/];
                             }
                         });
                     }); },

package/dist/Agent/agentLoop.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentLoop.js","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agentLoop.js","sourceRoot":"","sources":["../../src/Agent/agentLoop.ts"],"names":[],"mappings":"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"}

package/dist/Agent/index.d.ts

@@ -1,6 +1,7 @@
 import type { AgentInternalTool } from '../AgentTool/types.js';
 import type { AgentMessage, AgentServiceContract, AnyArvoOrchestratorContract, CreateArvoAgentParam } from './types.js';
 export type AgentState = {
+    initEventAccessControl: string | null;
     currentSubject: string;
     system: string | null;
     messages: AgentMessage[];
@@ -21,69 +22,66 @@ export type AgentState = {
 /**
  * Creates a fully-featured AI Agent implemented as an Arvo Resumable Event Handler.
  *
- * This factory transforms a standard Large Language Model (LLM) into a stateful, event-driven
- * participant in your system. Unlike standard chatbots, this Agent can interact with:
- * 1. **Local Tools**: Async/Sync JavaScript functions executed immediately.
- * 2. **MCP Servers**: External data sources via the Model Context Protocol.
- * 3. **Arvo Services**: Other Event Handlers in your Arvo distributed system (Async/Distributed tools).
+ * This factory transforms a Large Language Model into a stateful, event-driven participant
+ * in your Arvo system. The resulting agent operates on a start-stop-resume execution model,
+ * consuming zero resources between event processing cycles while maintaining conversation
+ * state in persistent memory.
  *
  * @remarks
- * **The Execution Model:**
- * The Agent operates on a **Start-Stop-Resume** cycle:
- * 1. **Init**: Receives an event -> Builds Context -> Calls LLM.
- * 2. **Action**:
- *    - If the LLM chooses a `tool` or `mcp`, it executes immediately and loops back.
- *    - If the LLM chooses a `service`, the Agent **emits an event** and **suspends execution**.
- *    - The LLM can choose a mix all three modalities at the same time.
- * 3. **Resume**: When the Service replies with an event, the Agent wakes up, restores state from `memory`,
- *    adds the result to its history, and calls the LLM again.
+ * The agent operates on a start-stop-resume execution model where it receives an event, invokes
+ * the LLM with available tools (internal Typescript functions, MCP external sources, or Arvo services),
+ * and either continues immediately for synchronous tools or suspends execution for service calls
+ * until responses arrive. When the LLM requests multiple tools simultaneously, priority-based orchestration
+ * ensures only the highest-priority batch executes (enabling "human-approval-first" patterns), while contract
+ * versioning enforces that you provide complete handler implementations for all defined versions
+ * (enabling safe evolution of prompts, models, and output schemas across v1, v2, etc.). The optional permission
+ * manager adds deterministic authorization outside the LLM's control—blocked tools trigger permission request events,
+ * the agent suspends until external approval, then retries with updated permissions, creating a security layer
+ * immune to prompt injection.
+ 
+* @param param - Configuration object defining the agent's contracts, tools, memory backend,
+ *                 LLM integration, and version-specific behavior handlers.
  *
- * **Strict Versioning Compliance:**
- * Arvo enforces that your Agent implementation matches your Contract versions.
- * If your `self` contract defines versions `'1.0.0'` and `'2.0.0'`, you must
- * provide specific `context` (A context builder function which runs at init of the agent
- * execution and is reponsible for building the context of the agent i.e. system promot
- * and messages list, both are optional) and `output` builder, which takes the LLM output
- * and converts it into yor contract compliant structure,for *all* versions
- * in the `handler` parameter.
- *
- *  This allows you to:
- * - Safely evolve prompt engineering strategies (e.g., v1 uses GPT-3.5, v2 uses GPT-4).
- * - Run different tests on Agent behavior within the same deployment.
- * - Retire old Agent behaviors gradually without breaking existing clients.
- *
- * @param param - Configuration object for the Agent.
- *
- * @returns An `ArvoResumable` instance specialised to run as an AI Agent.
+ * @returns An ArvoResumable instance that participates in the event fabric as a standard
+ *          event handler, compatible with any Arvo broker implementation.
  *
  * @example
  * ```typescript
  * export const supportAgent = ({ memory }) => createArvoAgent({
  *   contracts: {
- *     self: supportAgentContract, // The interface for this agent
+ *     self: supportAgentContract,
  *     services: {
- *       // The Agent can "call" this service by emitting an event
- *       // and going to sleep until the billing service replies.
- *       billing: { contract: billingServiceContract.version('1.0.0') }
+ *       billing: {
+ *         contract: billingServiceContract.version('1.0.0'),
+ *         priority: 0
+ *       },
+ *       humanApproval: {
+ *         contract: approvalContract.version('1.0.0'),
+ *         domains: ['human.interaction'],
+ *         priority: 100  // Executes before billing calls
+ *       }
  *     }
  *   },
  *   tools: {
- *     // The Agent can execute this immediately in-memory
  *     checkTime: createAgentTool({
  *       name: 'check_time',
- *       description: 'Checks current server time',
+ *       description: 'Returns current server time in ISO format',
  *       input: z.object({}),
  *       output: z.object({ time: z.string() }),
  *       fn: async () => ({ time: new Date().toISOString() })
  *     })
  *   },
  *   llm: openaiLLMIntegration(new OpenAI(), { model: 'gpt-4o' }),
- *   memory: memory, // Persists chat history during async calls
+ *   memory: memory,
+ *   permissionManager: new ToolPermissionManager(),
  *   handler: {
  *     '1.0.0': {
- *       // Dynamic System Prompt Building
+ *       permissionPolicy: async ({ services }) => [
+ *         services.billing.name  // Require permission for billing calls
+ *       ],
  *       context: AgentDefaults.CONTEXT_BUILDER(async ({ tools }) =>
- *         `You are a support agent. You have access to billing data via the ${tools.services.billing.name} tool.`
+ *         `You are a support agent with access to billing data via ${tools.services.billing.name}.
+ *          You must request approval via ${tools.services.humanApproval.name} before accessing billing.`
  *       ),
  *       output: AgentDefaults.OUTPUT_BUILDER
  *     }
@@ -91,5 +89,5 @@ export type AgentState = {
  * });
  * ```
  */
-export declare const createArvoAgent: <TSelfContract extends AnyArvoOrchestratorContract, TServiceContract extends Record<string, AgentServiceContract>, TTools extends Record<string, AgentInternalTool>>({ contracts, memory, handler, llm, mcp, maxToolInteractions, llmResponseType, tools, onStream, }: CreateArvoAgentParam<TSelfContract, TServiceContract, TTools>) => import("arvo-event-handler").ArvoResumable<AgentState, TSelfContract, { [K in keyof TServiceContract & string]: TServiceContract[K]["contract"]; }>;
+export declare const createArvoAgent: <TSelfContract extends AnyArvoOrchestratorContract, TServiceContract extends Record<string, AgentServiceContract>, TTools extends Record<string, AgentInternalTool>>({ contracts, memory, handler, llm, mcp, maxToolInteractions, llmResponseType, tools, onStream, permissionManager, }: CreateArvoAgentParam<TSelfContract, TServiceContract, TTools>) => import("arvo-event-handler").ArvoResumable<AgentState, TSelfContract, { [K in keyof TServiceContract & string]: TServiceContract[K]["contract"]; }>;
 //# sourceMappingURL=index.d.ts.map

package/dist/Agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Agent/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gBAAgB,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC1F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,2BAA2B,EACjD,gBAAgB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC7D,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAChD,kGAUC,oBAAoB,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,CAAC,8EAGtD,CAAC,yEAgQV,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Agent/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,UAAU,GAAG;IACvB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gBAAgB,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC1F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,2BAA2B,EACjD,gBAAgB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC7D,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAChD,qHAWC,oBAAoB,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,CAAC,8EAGtD,CAAC,yEA2TV,CAAC"}