@agentionai/agents 0.10.1 → 0.10.2

package/dist/agents/anthropic/ClaudeAgent.js

@@ -84,6 +84,9 @@ class ClaudeAgent extends BaseAgent_1.BaseAgent {
         // Mark session boundary so transform plugins (e.g. toolResultMaskingPlugin)
         // don't mask tool results produced within this execute() loop.
         this.history.setSessionAnchor();
+        // Suspend auto-trimming so tool_use / tool_result pairs are never split
+        // mid-loop. endExecution() in the finally block enforces limits once.
+        this.history.beginExecution();
         try {
             const messages = transformers_1.anthropicTransformer.toProvider(this.history.getEntries());
             const systemMessage = this.history.getSystemMessage();
@@ -125,6 +128,9 @@ class ClaudeAgent extends BaseAgent_1.BaseAgent {
                 throw executionError;
             }
         }
+        finally {
+            this.history.endExecution();
+        }
     }
     async handleResponse(response) {
         const usage = this.parseUsage(response.usage);

package/dist/agents/google/GeminiAgent.js

@@ -184,6 +184,9 @@ class GeminiAgent extends BaseAgent_1.BaseAgent {
         // Mark session boundary so transform plugins (e.g. toolResultMaskingPlugin)
         // don't mask tool results produced within this execute() loop.
         this.history.setSessionAnchor();
+        // Suspend auto-trimming so tool_use / tool_result pairs are never split
+        // mid-loop. endExecution() in the finally block enforces limits once.
+        this.history.beginExecution();
         try {
             const contents = transformers_1.geminiTransformer.toProvider(this.history.getEntries());
             const systemMessage = this.history.getSystemMessage();
@@ -229,6 +232,9 @@ class GeminiAgent extends BaseAgent_1.BaseAgent {
                 throw executionError;
             }
         }
+        finally {
+            this.history.endExecution();
+        }
     }
     async handleResponse(response) {
         const result = response.response;

package/dist/agents/mistral/MistralAgent.js

@@ -94,6 +94,9 @@ class MistralAgent extends BaseAgent_1.BaseAgent {
         // Mark session boundary so transform plugins (e.g. toolResultMaskingPlugin)
         // don't mask tool results produced within this execute() loop.
         this.history.setSessionAnchor();
+        // Suspend auto-trimming so tool_use / tool_result pairs are never split
+        // mid-loop. endExecution() in the finally block enforces limits once.
+        this.history.beginExecution();
         try {
             const messages = transformers_1.mistralTransformer.toProvider(this.history.getEntries());
             const response = await this.client.chat.complete({
@@ -133,6 +136,9 @@ class MistralAgent extends BaseAgent_1.BaseAgent {
                 throw executionError;
             }
         }
+        finally {
+            this.history.endExecution();
+        }
     }
     async handleResponse(response) {
         if (!response.choices || response.choices.length === 0) {

package/dist/agents/openai/OpenAiAgent.js

@@ -105,6 +105,9 @@ class OpenAiAgent extends BaseAgent_1.BaseAgent {
         // Mark session boundary so transform plugins (e.g. toolResultMaskingPlugin)
         // don't mask tool results produced within this execute() loop.
         this.history.setSessionAnchor();
+        // Suspend auto-trimming so tool_use / tool_result pairs are never split
+        // mid-loop. endExecution() in the finally block enforces limits once.
+        this.history.beginExecution();
         try {
             const inputMessages = transformers_1.openAiTransformer.toProvider(this.history.getEntries());
             const response = await this.client.responses.create({
@@ -150,6 +153,9 @@ class OpenAiAgent extends BaseAgent_1.BaseAgent {
                 throw executionError;
             }
         }
+        finally {
+            this.history.endExecution();
+        }
     }
     async handleResponse(response) {
         if (!response.output || !response.output.length) {

package/dist/history/History.d.ts

@@ -123,6 +123,7 @@ export declare class History extends EventEmitter {
     transient: boolean;
     private _plugins;
     private _reducing;
+    private _executing;
     private _sessionAnchor;
     constructor(entries?: HistoryEntry[], options?: HistoryOptions);
     /**
@@ -247,6 +248,22 @@ export declare class History extends EventEmitter {
      * Create a copy of this history
      */
     clone(options?: HistoryOptions): History;
+    /**
+     * Signal the start of an agent execute() loop. While executing, automatic
+     * trimming on addEntry() is suspended so tool_use / tool_result pairs are
+     * never split mid-loop. Call endExecution() in a finally block to resume.
+     */
+    beginExecution(): void;
+    /**
+     * Signal the end of an agent execute() loop. Resumes automatic trimming and
+     * immediately enforces maxLength / maxTokens limits on the accumulated history.
+     */
+    endExecution(): void;
+    /**
+     * Explicitly enforce maxLength and maxTokens limits. Useful when using
+     * History standalone, outside of an agent execute() loop.
+     */
+    trim(): void;
     /**
      * Apply maxLength and maxTokens trimming to the current entry list.
      * Safe to call after bulk-loading entries (e.g. RedisHistory.load()).

package/dist/history/History.js

@@ -127,6 +127,7 @@ class History extends events_1.default {
         this.transient = false;
         this._plugins = [];
         this._reducing = false;
+        this._executing = false;
         this._sessionAnchor = null;
         this.options = options;
         this.transient = Boolean(options?.transient);
@@ -399,12 +400,37 @@ class History extends events_1.default {
     // ===========================================================================
     // Private helpers
     // ===========================================================================
+    /**
+     * Signal the start of an agent execute() loop. While executing, automatic
+     * trimming on addEntry() is suspended so tool_use / tool_result pairs are
+     * never split mid-loop. Call endExecution() in a finally block to resume.
+     */
+    beginExecution() {
+        this._executing = true;
+    }
+    /**
+     * Signal the end of an agent execute() loop. Resumes automatic trimming and
+     * immediately enforces maxLength / maxTokens limits on the accumulated history.
+     */
+    endExecution() {
+        this._executing = false;
+        this.applyTrimming();
+    }
+    /**
+     * Explicitly enforce maxLength and maxTokens limits. Useful when using
+     * History standalone, outside of an agent execute() loop.
+     */
+    trim() {
+        this.applyTrimming();
+    }
     /**
      * Apply maxLength and maxTokens trimming to the current entry list.
      * Safe to call after bulk-loading entries (e.g. RedisHistory.load()).
      * Subclasses may call this after directly manipulating _entries.
      */
     applyTrimming() {
+        if (this._executing)
+            return;
         if (this.options.maxLength && this._entries.length > this.options.maxLength) {
             this._entries = this._entries.slice(this._entries.length - this.options.maxLength);
             this.sanitizeToolPairs();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentionai/agents",
   "author": "Laurent Zuijdwijk",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Agent Library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",