@arvo-tools/agentic 0.4.1 → 1.0.1

package/dist/Agent/AgentDefaults.d.ts

@@ -1,6 +1,8 @@
 import type { ArvoSemanticVersion } from 'arvo-core';
 import z from 'zod';
-import type { AgentContextBuilder, AgentInternalTool, AgentOutputBuilder, AgentServiceContract, AnyArvoOrchestratorContract, PromiseLike } from './types.js';
+import type { AgentInternalTool } from '../AgentTool/types.js';
+import type { PromiseAble } from '../types.js';
+import type { AgentContextBuilder, AgentOutputBuilder, AgentServiceContract, AnyArvoOrchestratorContract } from './types.js';
 export declare const AgentDefaults: {
     readonly INIT_SCHEMA: z.ZodObject<{
         message: z.ZodString;
@@ -22,7 +24,7 @@ export declare const AgentDefaults: {
     }, {
         response: string;
     }>;
-    readonly CONTEXT_BUILDER: <T extends AnyArvoOrchestratorContract, V extends ArvoSemanticVersion, TServiceContract extends Record<string, AgentServiceContract>, TTools extends Record<string, AgentInternalTool>>(systemPromptBuilder?: (param: Parameters<AgentContextBuilder<T, V, TServiceContract, TTools>>[0]) => PromiseLike<string>) => AgentContextBuilder<T, V, TServiceContract, TTools>;
+    readonly CONTEXT_BUILDER: <T extends AnyArvoOrchestratorContract, V extends ArvoSemanticVersion, TServiceContract extends Record<string, AgentServiceContract>, TTools extends Record<string, AgentInternalTool>>(systemPromptBuilder?: (param: Parameters<AgentContextBuilder<T, V, TServiceContract, TTools>>[0]) => PromiseAble<string>) => AgentContextBuilder<T, V, TServiceContract, TTools>;
     readonly OUTPUT_BUILDER: AgentOutputBuilder;
 };
 //# sourceMappingURL=AgentDefaults.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AgentDefaults.d.ts","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;+BAqBpB,CAAC,SAAS,2BAA2B,EACrC,CAAC,SAAS,mBAAmB,EAC7B,gBAAgB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC7D,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,wBAE1B,CACpB,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KACtE,WAAW,CAAC,MAAM,CAAC,KACvB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC;6BAoDlD,kBAAkB;CAChB,CAAC"}
+{"version":3,"file":"AgentDefaults.d.ts","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,mBAAmB,EAEnB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;+BAqBpB,CAAC,SAAS,2BAA2B,EACrC,CAAC,SAAS,mBAAmB,EAC7B,gBAAgB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAC7D,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,wBAE1B,CACpB,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KACtE,WAAW,CAAC,MAAM,CAAC,KACvB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC;6BAuDlD,kBAAkB;CAChB,CAAC"}

package/dist/Agent/AgentDefaults.js

@@ -82,12 +82,14 @@ exports.AgentDefaults = {
                             {
                                 role: 'user',
                                 content: { type: 'text', content: param.input.data.message },
+                                seenCount: 0,
                             },
                         ];
                         try {
                             for (_a = __values((_h = param.input.data.pdfBase64) !== null && _h !== void 0 ? _h : []), _b = _a.next(); !_b.done; _b = _a.next()) {
                                 item = _b.value;
                                 messages.push({
+                                    seenCount: 0,
                                     role: 'user',
                                     content: {
                                         type: 'media',
@@ -113,6 +115,7 @@ exports.AgentDefaults = {
                             for (_c = __values((_j = param.input.data.imageBase64) !== null && _j !== void 0 ? _j : []), _d = _c.next(); !_d.done; _d = _c.next()) {
                                 item = _d.value;
                                 messages.push({
+                                    seenCount: 0,
                                     role: 'user',
                                     content: {
                                         type: 'media',

package/dist/Agent/AgentDefaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentDefaults.js","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6BAA0B;AAC1B,4CAAoB;AAWP,QAAA,aAAa,GAAG;IAC3B,WAAW,EAAE,aAAC,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,WAAW,EAAE,aAAC;aACX,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CACP,oFAAoF,CACrF;QACH,SAAS,EAAE,aAAC;aACT,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CAAC,2EAA2E,CAAC;KACzF,CAAC;IACF,eAAe,EAAE,aAAC,CAAC,MAAM,CAAC;QACxB,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAClE,CAAC;IACF,eAAe,EACb,UAME,mBAEwB;QAE1B,OAAA,UAAO,KAAK;;;;;;;wBACJ,QAAQ,GAAmB;4BAC/B;gCACE,IAAI,EAAE,MAAM;gCACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;6BAC7D;yBACF,CAAC;;4BAEF,KAAmB,KAAA,SAAA,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAA,4CAAE,CAAC;gCAA3C,IAAI;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,IAAI,EAAE,MAAM;oCACZ,OAAO,EAAE;wCACP,IAAI,EAAE,OAAO;wCACb,OAAO,EAAE,IAAI;wCACb,WAAW,EAAE;4CACX,MAAM,EAAE,QAAQ;4CAChB,IAAI,EAAE,MAAM;4CACZ,QAAQ,EAAE,UAAG,IAAA,SAAE,GAAE,SAAM;4CACvB,QAAQ,EAAE,KAAK;yCAChB;qCACF;iCACF,CAAC,CAAC;4BACL,CAAC;;;;;;;;;;4BAED,KAAmB,KAAA,SAAA,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,mCAAI,EAAE,CAAA,4CAAE,CAAC;gCAA7C,IAAI;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,IAAI,EAAE,MAAM;oCACZ,OAAO,EAAE;wCACP,IAAI,EAAE,OAAO;wCACb,OAAO,EAAE,IAAI;wCACb,WAAW,EAAE;4CACX,MAAM,EAAE,QAAQ;4CAChB,IAAI,EAAE,OAAO;4CACb,QAAQ,EAAE,UAAG,IAAA,SAAE,GAAE,SAAM;4CACvB,QAAQ,EAAE,KAAK;yCAChB;qCACF;iCACF,CAAC,CAAC;4BACL,CAAC;;;;;;;;;;wBAGU,qBAAM,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAG,KAAK,CAAC,CAAA,EAAA;4BAD7C,uBACE,SAAM,GAAE,MAAA,CAAC,SAAkC,CAAC,mCAAI,IAAI;4BACpD,WAAQ,WAAA;iCACR;;;aACH;IA5CD,CA4CC;IACH,cAAc,EAAE,CAAC,UAAC,KAAK;QACrB,OAAO;YACL,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK,CAAC,OAAO;aACxB;SACF,CAAC;IACJ,CAAC,CAAuB;CAChB,CAAC"}
+{"version":3,"file":"AgentDefaults.js","sourceRoot":"","sources":["../../src/Agent/AgentDefaults.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6BAA0B;AAC1B,4CAAoB;AAWP,QAAA,aAAa,GAAG;IAC3B,WAAW,EAAE,aAAC,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,WAAW,EAAE,aAAC;aACX,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CACP,oFAAoF,CACrF;QACH,SAAS,EAAE,aAAC;aACT,MAAM,EAAE;aACR,KAAK,EAAE;aACP,QAAQ,EAAE;aACV,QAAQ,CAAC,2EAA2E,CAAC;KACzF,CAAC;IACF,eAAe,EAAE,aAAC,CAAC,MAAM,CAAC;QACxB,QAAQ,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAClE,CAAC;IACF,eAAe,EACb,UAME,mBAEwB;QAE1B,OAAA,UAAO,KAAK;;;;;;;wBACJ,QAAQ,GAAmB;4BAC/B;gCACE,IAAI,EAAE,MAAM;gCACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;gCAC5D,SAAS,EAAE,CAAC;6BACb;yBACF,CAAC;;4BAEF,KAAmB,KAAA,SAAA,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAA,4CAAE,CAAC;gCAA3C,IAAI;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,SAAS,EAAE,CAAC;oCACZ,IAAI,EAAE,MAAM;oCACZ,OAAO,EAAE;wCACP,IAAI,EAAE,OAAO;wCACb,OAAO,EAAE,IAAI;wCACb,WAAW,EAAE;4CACX,MAAM,EAAE,QAAQ;4CAChB,IAAI,EAAE,MAAM;4CACZ,QAAQ,EAAE,UAAG,IAAA,SAAE,GAAE,SAAM;4CACvB,QAAQ,EAAE,KAAK;yCAChB;qCACF;iCACF,CAAC,CAAC;4BACL,CAAC;;;;;;;;;;4BAED,KAAmB,KAAA,SAAA,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,mCAAI,EAAE,CAAA,4CAAE,CAAC;gCAA7C,IAAI;gCACb,QAAQ,CAAC,IAAI,CAAC;oCACZ,SAAS,EAAE,CAAC;oCACZ,IAAI,EAAE,MAAM;oCACZ,OAAO,EAAE;wCACP,IAAI,EAAE,OAAO;wCACb,OAAO,EAAE,IAAI;wCACb,WAAW,EAAE;4CACX,MAAM,EAAE,QAAQ;4CAChB,IAAI,EAAE,OAAO;4CACb,QAAQ,EAAE,UAAG,IAAA,SAAE,GAAE,SAAM;4CACvB,QAAQ,EAAE,KAAK;yCAChB;qCACF;iCACF,CAAC,CAAC;4BACL,CAAC;;;;;;;;;;wBAGU,qBAAM,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAG,KAAK,CAAC,CAAA,EAAA;4BAD7C,uBACE,SAAM,GAAE,MAAA,CAAC,SAAkC,CAAC,mCAAI,IAAI;4BACpD,WAAQ,WAAA;iCACR;;;aACH;IA/CD,CA+CC;IACH,cAAc,EAAE,CAAC,UAAC,KAAK;QACrB,OAAO;YACL,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK,CAAC,OAAO;aACxB;SACF,CAAC;IACJ,CAAC,CAAuB;CAChB,CAAC"}

package/dist/Agent/agentLoop.d.ts

@@ -1,7 +1,26 @@
 import type z from 'zod';
+import type { AgentLLMIntegration, AgentLLMIntegrationParam } from '../Integrations/types.js';
 import type { IMCPClient } from '../interfaces.mcp.js';
 import type { OtelInfoType } from '../types.js';
-import type { AgentLLMIntegration, AgentLLMIntegrationParam, AgentMessage, AgentOutputBuilder, AgentToolDefinition, CreateArvoAgentParam } from './types.js';
+import type { AgentMessage, AgentOutputBuilder, AgentToolDefinition, CreateArvoAgentParam } from './types.js';
+/**
+ * The Core Cognitive Loop of the Arvo Agent.
+ *
+ * This function implements the **ReAct (Reason + Act)** pattern, orchestrating the interactive
+ * session between the Large Language Model (LLM) and the available Tool ecosystem.
+ *
+ * @remarks
+ * **Hybrid Execution Strategy:**
+ * The loop handles two types of tool executions differently:
+ * 1. **Synchronous Tools (Internal & MCP):** These are executed **immediately** within the loop.
+ *    The results are added to the history, and the LLM is called again in the same tick.
+ * 2. **Asynchronous Tools (Arvo Services):** These interrupt the loop. The function returns
+ *    the tool call definition, signaling the parent `ArvoResumable` to **emit an event and suspend**.
+ *
+ * **Self-Correction:**
+ * If the LLM's final output fails the Contract's Output Schema validation (via `outputBuilder`),
+ * the loop catches the error and feeds it back to the LLM for auto-correction.
+ */
 export declare const agentLoop: (param: {
     initLifecycle: AgentLLMIntegrationParam["lifecycle"];
     system: string | null;
@@ -49,6 +68,7 @@ export declare const agentLoop: (param: {
             input: Record<string, any>;
         };
         role: "user" | "assistant";
+        seenCount: number;
     }[];
     toolCalls: {
         type: "tool_use";
@@ -92,6 +112,7 @@ export declare const agentLoop: (param: {
             input: Record<string, any>;
         };
         role: "user" | "assistant";
+        seenCount: number;
     }[];
     output: {
         [x: string]: any;

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;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAEV,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EAGnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,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;CACpC,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiPhC,CAAC"}
+{"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,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;CACpC,EACD,QAAQ;IAAE,QAAQ,EAAE,YAAY,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyQhC,CAAC"}

package/dist/Agent/agentLoop.js

@@ -87,6 +87,24 @@ exports.agentLoop = void 0;
 var openinference_semantic_conventions_1 = require("@arizeai/openinference-semantic-conventions");
 var arvo_core_1 = require("arvo-core");
 var utils_1 = require("./utils");
+/**
+ * The Core Cognitive Loop of the Arvo Agent.
+ *
+ * This function implements the **ReAct (Reason + Act)** pattern, orchestrating the interactive
+ * session between the Large Language Model (LLM) and the available Tool ecosystem.
+ *
+ * @remarks
+ * **Hybrid Execution Strategy:**
+ * The loop handles two types of tool executions differently:
+ * 1. **Synchronous Tools (Internal & MCP):** These are executed **immediately** within the loop.
+ *    The results are added to the history, and the LLM is called again in the same tick.
+ * 2. **Asynchronous Tools (Arvo Services):** These interrupt the loop. The function returns
+ *    the tool call definition, signaling the parent `ArvoResumable` to **emit an event and suspend**.
+ *
+ * **Self-Correction:**
+ * If the LLM's final output fails the Contract's Output Schema validation (via `outputBuilder`),
+ * the loop catches the error and feeds it back to the LLM for auto-correction.
+ */
 var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void 0, function () {
     var _a;
     return __generator(this, function (_b) {
@@ -104,7 +122,7 @@ 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, currentToolInteractionCount, messages, toolQuotaExhausted, response, arvoToolCalls, mcpToolResultPromises, internalToolResultPromises, _loop_1, _a, _b, item, _c, _d, item, e_1_1, _e, _f, item, e_2_1, outputResult;
+                        var otelInfo, nameToToolMap, lifecycle, executionUnits, 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;
                         return __generator(this, function (_o) {
@@ -145,6 +163,11 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                     response = _o.sent();
                                     currentToolInteractionCount++;
                                     executionUnits += response.executionUnits;
+                                    // Update the message seen count by one for all the
+                                    // messages which the LLM has seen
+                                    for (i = 0; i < messages.length; i++) {
+                                        messages[i].seenCount += 1;
+                                    }
                                     if (!(response.type === 'tool_call')) return [3 /*break*/, 19];
                                     arvoToolCalls = [];
                                     mcpToolResultPromises = [];
@@ -156,7 +179,12 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                             name: item.name,
                                             input: item.input,
                                         };
-                                        messages.push({ role: 'assistant', content: toolCallContent });
+                                        messages.push({
+                                            role: 'assistant',
+                                            content: toolCallContent,
+                                            // This has been viewed by the LLM as it was generated by it
+                                            seenCount: 1,
+                                        });
                                         var resolvedToolDef = nameToToolMap[item.name];
                                         if (!resolvedToolDef) {
                                             messages.push({
@@ -166,6 +194,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                                     toolUseId: item.toolUseId,
                                                     content: "The tool ".concat(item.name, " does not exist. Please check if you are using the correct tool and don't call this tool again till you have confirmed the existance of the correct tool"),
                                                 },
+                                                seenCount: 0,
                                             });
                                             return "continue";
                                         }
@@ -230,7 +259,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                             }); })());
                                         }
                                         else if (resolvedToolDef.serverConfig.kind === 'arvo') {
-                                            var zodParseResult = ((_k = resolvedToolDef.serverConfig.contract) === null || _k === void 0 ? void 0 : _k.accepts.schema).safeParse(item.input);
+                                            var zodParseResult = ((_k = resolvedToolDef.serverConfig.contract) === null || _k === void 0 ? void 0 : _k.accepts.schema).safeParse(__assign(__assign({}, item.input), { parentSubject$$: null }));
                                             if (zodParseResult === null || zodParseResult === void 0 ? void 0 : zodParseResult.error) {
                                                 messages.push({
                                                     role: 'user',
@@ -243,10 +272,11 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                                             message: zodParseResult.error.message,
                                                         }),
                                                     },
+                                                    seenCount: 0,
                                                 });
                                             }
                                             else {
-                                                arvoToolCalls.push(__assign(__assign({}, toolCallContent), { name: (_m = (_l = resolvedToolDef.serverConfig.contract) === null || _l === void 0 ? void 0 : _l.accepts.type) !== null && _m !== void 0 ? _m : resolvedToolDef.serverConfig.name }));
+                                                arvoToolCalls.push(__assign(__assign({}, toolCallContent), { input: zodParseResult.data, name: (_m = (_l = resolvedToolDef.serverConfig.contract) === null || _l === void 0 ? void 0 : _l.accepts.type) !== null && _m !== void 0 ? _m : resolvedToolDef.serverConfig.name }));
                                             }
                                         }
                                     };
@@ -274,7 +304,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                 case 6:
                                     if (!!_d.done) return [3 /*break*/, 8];
                                     item = _d.value;
-                                    messages.push({ role: 'user', content: item });
+                                    messages.push({ role: 'user', content: item, seenCount: 0 });
                                     _o.label = 7;
                                 case 7:
                                     _d = _c.next();
@@ -300,7 +330,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                 case 13:
                                     if (!!_f.done) return [3 /*break*/, 15];
                                     item = _f.value;
-                                    messages.push({ role: 'user', content: item });
+                                    messages.push({ role: 'user', content: item, seenCount: 0 });
                                     _o.label = 14;
                                 case 14:
                                     _f = _e.next();
@@ -340,6 +370,8 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                                 type: 'text',
                                                 content: 'content' in response && response.content ? response.content : 'No response',
                                             },
+                                            // This has been viewed by the LLM as it was generated by it
+                                            seenCount: 1,
                                         });
                                         messages.push({
                                             role: 'user',
@@ -351,6 +383,7 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                                     message: outputResult.error.message,
                                                 }),
                                             },
+                                            seenCount: 0,
                                         });
                                         lifecycle = 'output_error_feedback';
                                         return [3 /*break*/, 2];
@@ -362,6 +395,8 @@ var agentLoop = function (param, config) { return __awaiter(void 0, void 0, void
                                                 type: 'text',
                                                 content: JSON.stringify(outputResult.data),
                                             },
+                                            // This has been viewed by the LLM as it was generated by it
+                                            seenCount: 1,
                                         });
                                         return [2 /*return*/, {
                                                 messages: messages,

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,5 +1,6 @@
-import type { AgentInternalTool, AgentMessage, AgentServiceContract, AnyArvoOrchestratorContract, CreateArvoAgentParam } from './types.js';
-type AgentState = {
+import type { AgentInternalTool } from '../AgentTool/types.js';
+import type { AgentMessage, AgentServiceContract, AnyArvoOrchestratorContract, CreateArvoAgentParam } from './types.js';
+export type AgentState = {
     currentSubject: string;
     system: string | null;
     messages: AgentMessage[];
@@ -13,6 +14,78 @@ type AgentState = {
     }>;
     totalExecutionUnits: number;
 };
+/**
+ * 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).
+ *
+ * @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.
+ *
+ * **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.
+ *
+ * @example
+ * ```typescript
+ * export const supportAgent = ({ memory }) => createArvoAgent({
+ *   contracts: {
+ *     self: supportAgentContract, // The interface for this agent
+ *     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') }
+ *     }
+ *   },
+ *   tools: {
+ *     // The Agent can execute this immediately in-memory
+ *     checkTime: createAgentTool({
+ *       name: 'check_time',
+ *       description: 'Checks current server time',
+ *       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
+ *   handler: {
+ *     '1.0.0': {
+ *       // Dynamic System Prompt Building
+ *       context: AgentDefaults.CONTEXT_BUILDER(async ({ tools }) =>
+ *         `You are a support agent. You have access to billing data via the ${tools.services.billing.name} tool.`
+ *       ),
+ *       output: AgentDefaults.OUTPUT_BUILDER
+ *     }
+ *   }
+ * });
+ * ```
+ */
 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, }: CreateArvoAgentParam<TSelfContract, TServiceContract, TTools>) => import("arvo-event-handler").ArvoResumable<AgentState, TSelfContract, { [K in keyof TServiceContract & string]: TServiceContract[K]["contract"]; }>;
-export {};
 //# 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":"AAQA,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAOpB,KAAK,UAAU,GAAG;IAChB,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;CAC7B,CAAC;AAEF,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,wFASC,oBAAoB,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,CAAC,8EAGtD,CAAC,yEAuNV,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Agent/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/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;CAC7B,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,wFASC,oBAAoB,CAAC,aAAa,EAAE,gBAAgB,EAAE,MAAM,CAAC,8EAGtD,CAAC,yEA6NV,CAAC"}

package/dist/Agent/index.js

@@ -99,6 +99,79 @@ var arvo_core_1 = require("arvo-core");
 var arvo_event_handler_1 = require("arvo-event-handler");
 var agentLoop_js_1 = require("./agentLoop.js");
 var utils_js_1 = require("./utils.js");
+/**
+ * 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).
+ *
+ * @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.
+ *
+ * **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.
+ *
+ * @example
+ * ```typescript
+ * export const supportAgent = ({ memory }) => createArvoAgent({
+ *   contracts: {
+ *     self: supportAgentContract, // The interface for this agent
+ *     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') }
+ *     }
+ *   },
+ *   tools: {
+ *     // The Agent can execute this immediately in-memory
+ *     checkTime: createAgentTool({
+ *       name: 'check_time',
+ *       description: 'Checks current server time',
+ *       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
+ *   handler: {
+ *     '1.0.0': {
+ *       // Dynamic System Prompt Building
+ *       context: AgentDefaults.CONTEXT_BUILDER(async ({ tools }) =>
+ *         `You are a support agent. You have access to billing data via the ${tools.services.billing.name} tool.`
+ *       ),
+ *       output: AgentDefaults.OUTPUT_BUILDER
+ *     }
+ *   }
+ * });
+ * ```
+ */
 var createArvoAgent = function (_a) {
     var contracts = _a.contracts, memory = _a.memory, handler = _a.handler, llm = _a.llm, mcp = _a.mcp, _b = _a.maxToolInteractions, maxToolInteractions = _b === void 0 ? 5 : _b, _c = _a.llmResponseType, llmResponseType = _c === void 0 ? 'text' : _c, tools = _a.tools;
     var serviceContracts = Object.fromEntries(Object.entries(contracts.services).map(function (_a) {
@@ -121,33 +194,35 @@ var createArvoAgent = function (_a) {
         handler: Object.fromEntries(Object.keys(contracts.self.versions).map(function (ver) { return [
             ver,
             (function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-                var otelInfo, contextBuilder, outputBuilder, selfVersionedContract, outputFormat, serviceTools, mcpTools, internalTools, toolInteraction, _c, parentSubject$$, inputData, llmContext, response_1, resumableContextToPersist_1, resumedContext, messages, _d, _e, _f, toolUseId, data, response_2, resumableContextToPersist_2;
+                var otelInfo, contextBuilder, outputBuilder, thisVersionLlmIntegration, versionLlmResponseType, selfVersionedContract, outputFormat, serviceTools, mcpTools, internalTools, toolInteraction, _c, parentSubject$$, inputData, llmContext, response_1, resumableContextToPersist_1, resumedContext, messages, _d, _e, _f, toolUseId, data, response_2, resumableContextToPersist_2;
                 var e_1, _g;
-                var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+                var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
                 var span = _b.span, input = _b.input, context = _b.context, service = _b.service;
-                return __generator(this, function (_u) {
-                    switch (_u.label) {
+                return __generator(this, function (_y) {
+                    switch (_y.label) {
                         case 0:
                             otelInfo = {
                                 span: span,
                                 headers: (0, arvo_core_1.getOtelHeaderFromSpan)(span),
                             };
-                            _u.label = 1;
+                            _y.label = 1;
                         case 1:
-                            _u.trys.push([1, , 8, 10]);
+                            _y.trys.push([1, , 8, 10]);
                             contextBuilder = (_h = handler[ver]) === null || _h === void 0 ? void 0 : _h.context;
                             outputBuilder = (_j = handler[ver]) === null || _j === void 0 ? void 0 : _j.output;
+                            thisVersionLlmIntegration = (_l = (_k = handler[ver]) === null || _k === void 0 ? void 0 : _k.llm) !== null && _l !== void 0 ? _l : llm;
+                            versionLlmResponseType = (_o = (_m = handler[ver]) === null || _m === void 0 ? void 0 : _m.llmResponseType) !== null && _o !== void 0 ? _o : llmResponseType;
                             selfVersionedContract = contracts.self.version(ver);
                             outputFormat = selfVersionedContract.emits[selfVersionedContract.metadata.completeEventType];
                             return [4 /*yield*/, (mcp === null || mcp === void 0 ? void 0 : mcp.connect({ otelInfo: otelInfo }))];
                         case 2:
-                            _u.sent();
+                            _y.sent();
                             serviceTools = (0, utils_js_1.generateServiceToolDefinitions)(contracts.services);
                             return [4 /*yield*/, (0, utils_js_1.generateMcpToolDefinitions)(mcp !== null && mcp !== void 0 ? mcp : null, { otelInfo: otelInfo })];
                         case 3:
-                            mcpTools = _u.sent();
+                            mcpTools = _y.sent();
                             internalTools = (0, utils_js_1.generateAgentInternalToolDefinitions)(tools !== null && tools !== void 0 ? tools : {});
-                            toolInteraction = (_k = context === null || context === void 0 ? void 0 : context.toolInteractions) !== null && _k !== void 0 ? _k : {
+                            toolInteraction = (_p = context === null || context === void 0 ? void 0 : context.toolInteractions) !== null && _p !== void 0 ? _p : {
                                 max: maxToolInteractions,
                                 current: 0,
                             };
@@ -160,35 +235,36 @@ var createArvoAgent = function (_a) {
                                     span: span,
                                 })];
                         case 4:
-                            llmContext = (_l = (_u.sent())) !== null && _l !== void 0 ? _l : null;
+                            llmContext = (_q = (_y.sent())) !== null && _q !== void 0 ? _q : null;
                             return [4 /*yield*/, (0, agentLoop_js_1.agentLoop)({
                                     initLifecycle: 'init',
-                                    system: (_m = llmContext === null || llmContext === void 0 ? void 0 : llmContext.system) !== null && _m !== void 0 ? _m : null,
-                                    messages: ((_o = llmContext === null || llmContext === void 0 ? void 0 : llmContext.messages) === null || _o === void 0 ? void 0 : _o.length)
+                                    system: (_r = llmContext === null || llmContext === void 0 ? void 0 : llmContext.system) !== null && _r !== void 0 ? _r : null,
+                                    messages: (((_s = llmContext === null || llmContext === void 0 ? void 0 : llmContext.messages) === null || _s === void 0 ? void 0 : _s.length)
                                         ? llmContext.messages
                                         : [
                                             {
                                                 role: 'user',
                                                 content: { type: 'text', content: JSON.stringify(inputData) },
+                                                seenCount: 0,
                                             },
-                                        ],
+                                        ]).map(function (item) { var _a; return (__assign(__assign({}, item), { seenCount: (_a = item.seenCount) !== null && _a !== void 0 ? _a : 0 })); }),
                                     tools: Object.values(__assign(__assign(__assign({}, mcpTools), serviceTools), internalTools)),
                                     outputFormat: outputFormat,
                                     outputBuilder: outputBuilder,
-                                    llmResponseType: llmResponseType,
-                                    llm: llm,
+                                    llmResponseType: versionLlmResponseType,
+                                    llm: thisVersionLlmIntegration,
                                     mcp: mcp !== null && mcp !== void 0 ? mcp : null,
                                     toolInteraction: toolInteraction,
                                     currentTotalExecutionUnits: 0,
                                 }, { otelInfo: otelInfo })];
                         case 5:
-                            response_1 = _u.sent();
+                            response_1 = _y.sent();
                             resumableContextToPersist_1 = {
                                 currentSubject: input.subject,
-                                system: (_p = llmContext === null || llmContext === void 0 ? void 0 : llmContext.system) !== null && _p !== void 0 ? _p : null,
+                                system: (_t = llmContext === null || llmContext === void 0 ? void 0 : llmContext.system) !== null && _t !== void 0 ? _t : null,
                                 messages: response_1.messages,
                                 toolInteractions: response_1.toolInteractions,
-                                awaitingToolCalls: Object.fromEntries(((_q = response_1.toolCalls) !== null && _q !== void 0 ? _q : []).map(function (item) { return [
+                                awaitingToolCalls: Object.fromEntries(((_u = response_1.toolCalls) !== null && _u !== void 0 ? _u : []).map(function (item) { return [
                                     item.toolUseId,
                                     { type: item.name, data: null },
                                 ]; })),
@@ -233,6 +309,7 @@ var createArvoAgent = function (_a) {
                                             toolUseId: toolUseId,
                                             content: JSON.stringify(data !== null && data !== void 0 ? data : {}),
                                         },
+                                        seenCount: 0,
                                     });
                                 }
                             }
@@ -245,20 +322,20 @@ var createArvoAgent = function (_a) {
                             }
                             return [4 /*yield*/, (0, agentLoop_js_1.agentLoop)({
                                     initLifecycle: 'tool_result',
-                                    system: (_r = resumedContext.system) !== null && _r !== void 0 ? _r : null,
+                                    system: (_v = resumedContext.system) !== null && _v !== void 0 ? _v : null,
                                     messages: messages,
                                     tools: Object.values(__assign(__assign(__assign({}, mcpTools), serviceTools), internalTools)),
                                     outputFormat: outputFormat,
                                     outputBuilder: outputBuilder,
-                                    llmResponseType: llmResponseType,
-                                    llm: llm,
+                                    llmResponseType: versionLlmResponseType,
+                                    llm: thisVersionLlmIntegration,
                                     mcp: mcp !== null && mcp !== void 0 ? mcp : null,
                                     toolInteraction: toolInteraction,
                                     currentTotalExecutionUnits: resumedContext.totalExecutionUnits,
                                 }, { otelInfo: otelInfo })];
                         case 7:
-                            response_2 = _u.sent();
-                            resumableContextToPersist_2 = __assign(__assign({}, resumedContext), { messages: response_2.messages, toolInteractions: response_2.toolInteractions, awaitingToolCalls: Object.fromEntries(((_s = response_2.toolCalls) !== null && _s !== void 0 ? _s : []).map(function (item) { return [
+                            response_2 = _y.sent();
+                            resumableContextToPersist_2 = __assign(__assign({}, resumedContext), { messages: response_2.messages, toolInteractions: response_2.toolInteractions, awaitingToolCalls: Object.fromEntries(((_w = response_2.toolCalls) !== null && _w !== void 0 ? _w : []).map(function (item) { return [
                                     item.toolUseId,
                                     { type: item.name, data: null },
                                 ]; })), totalExecutionUnits: response_2.executionUnits });
@@ -278,9 +355,9 @@ var createArvoAgent = function (_a) {
                                     context: resumableContextToPersist_2,
                                     output: __assign({ __executionunits: response_2.executionUnits }, response_2.output),
                                 }];
-                        case 8: return [4 /*yield*/, ((_t = mcp === null || mcp === void 0 ? void 0 : mcp.disconnect({ otelInfo: otelInfo })) === null || _t === void 0 ? void 0 : _t.catch(console.error))];
+                        case 8: return [4 /*yield*/, ((_x = mcp === null || mcp === void 0 ? void 0 : mcp.disconnect({ otelInfo: otelInfo })) === null || _x === void 0 ? void 0 : _x.catch(console.error))];
                         case 9:
-                            _u.sent();
+                            _y.sent();
                             return [7 /*endfinally*/];
                         case 10: return [2 /*return*/];
                     }