@falai/agent 1.2.3 → 1.2.4

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,MAAM,CAAC;AAGd,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,MAAM,EACN,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG/C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,MAAM,CAAC;AAGd,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,MAAM,EACN,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG/C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/index.js

@@ -20,4 +20,6 @@ export { retry, withTimeoutAndRetry } from "./retry";
 export { ConditionEvaluator, createConditionEvaluator, extractAIContextStrings, hasProgrammaticConditions, } from "./condition";
 // JSON utilities
 export { parseJSONResponse, tryParseJSONResponse } from "./json";
+// Serialization utilities
+export { serializeToolResult } from "./serialize";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,MAAM,CAAC;AAEd,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,qBAAqB;AACrB,OAAO,EACL,MAAM,EACN,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAI/C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAErD,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,MAAM,CAAC;AAEd,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,qBAAqB;AACrB,OAAO,EACL,MAAM,EACN,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAI/C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAErD,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEjE,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/serialize.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Serialization utilities for tool results and other data
+ */
+/**
+ * Serialize a tool execution result into a string suitable for conversation history.
+ *
+ * Priority:
+ *   1. Failed result → error message
+ *   2. String data   → returned as-is
+ *   3. Object data   → JSON.stringify (with circular-reference safety)
+ *   4. Primitive data → String()
+ *   5. No data       → "Tool executed successfully"
+ */
+export declare function serializeToolResult(result: {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/utils/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/utils/serialize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA6BT"}

package/dist/utils/serialize.js

@@ -0,0 +1,41 @@
+/**
+ * Serialization utilities for tool results and other data
+ */
+/**
+ * Serialize a tool execution result into a string suitable for conversation history.
+ *
+ * Priority:
+ *   1. Failed result → error message
+ *   2. String data   → returned as-is
+ *   3. Object data   → JSON.stringify (with circular-reference safety)
+ *   4. Primitive data → String()
+ *   5. No data       → "Tool executed successfully"
+ */
+export function serializeToolResult(result) {
+    if (!result.success) {
+        return `Tool execution failed: ${result.error || "Unknown error"}`;
+    }
+    if (result.data === undefined || result.data === null) {
+        return "Tool executed successfully";
+    }
+    if (typeof result.data === "string") {
+        return result.data;
+    }
+    // Primitives (number, boolean) are safe to stringify directly
+    if (typeof result.data !== "object") {
+        return JSON.stringify(result.data);
+    }
+    // Objects / arrays — guard against circular references
+    try {
+        return JSON.stringify(result.data);
+    }
+    catch {
+        // Circular or otherwise un-serializable object: extract what we can
+        const keys = Object.keys(result.data);
+        if (keys.length > 0) {
+            return `Tool returned object with keys: ${keys.join(", ")}`;
+        }
+        return "Tool executed successfully (result could not be serialized)";
+    }
+}
+//# sourceMappingURL=serialize.js.map

package/dist/utils/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/utils/serialize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAInC;IACC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,0BAA0B,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,8DAA8D;IAC9D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAA+B,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,mCAAmC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,CAAC;QACD,OAAO,6DAA6D,CAAC;IACvE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falai/agent",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Standalone, strongly-typed AI Agent framework with route DSL and AI provider strategy",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/src/core/ResponseModal.ts

@@ -24,7 +24,7 @@ import { ResponseEngine } from "./ResponseEngine";
 import { ResponsePipeline } from "./ResponsePipeline";
 import { BatchExecutor, type HookFunction } from "./BatchExecutor";
 import { BatchPromptBuilder } from "./BatchPromptBuilder";
-import { cloneDeep, mergeCollected, enterStep, getLastMessageFromHistory, render, logger, historyToEvents, eventsToHistory } from "../utils";
+import { cloneDeep, mergeCollected, enterStep, getLastMessageFromHistory, render, logger, historyToEvents, eventsToHistory, serializeToolResult } from "../utils";
 import { createTemplateContext } from "../utils/template";
 import type { ToolManager } from "./ToolManager";
 import { END_ROUTE_ID } from "../constants";
@@ -1777,6 +1777,9 @@ export class ResponseModal<TContext = unknown, TData = unknown> {
             // Convert HistoryItem[] to Event[] for internal processing
             const historyEvents = historyToEvents(history);
 
+            // Map to store tool execution results for history
+            const toolResultsMap = new Map<string, string>();
+
             // Execute initial dynamic tool calls
             if (toolCalls && toolCalls.length > 0) {
                 logger.debug(`[ResponseModal] Executing ${toolCalls.length} dynamic tool calls:`, toolCalls.map(tc => tc.toolName));
@@ -1808,6 +1811,9 @@ export class ResponseModal<TContext = unknown, TData = unknown> {
                             throw new Error(`ToolManager not available for tool execution: ${toolCall.toolName}`);
                         }
 
+                        // Store the actual tool result data for history
+                        toolResultsMap.set(toolCall.toolName, serializeToolResult(toolResult));
+
                         // Check if tool execution was successful
                         if (!toolResult.success) {
                             logger.error(`[ResponseModal] Tool execution failed: ${toolCall.toolName} - ${toolResult.error}`);
@@ -1877,7 +1883,7 @@ export class ResponseModal<TContext = unknown, TData = unknown> {
                             role: "tool" as const,
                             tool_call_id: toolCall.toolName,
                             name: toolCall.toolName,
-                            content: "Tool executed successfully",
+                            content: toolResultsMap.get(toolCall.toolName) || "Tool executed successfully",
                         });
                     }
                 }
@@ -1976,6 +1982,9 @@ export class ResponseModal<TContext = unknown, TData = unknown> {
                                 }
                             }
 
+                            // Store the follow-up tool result for potential next loop iteration
+                            toolResultsMap.set(toolCall.toolName, serializeToolResult(toolResult));
+
                             logger.debug(`[ResponseModal] Executed follow-up tool: ${toolCall.toolName} (success: ${toolResult.success})`);
                         } catch (error) {
                             logger.error(`[ResponseModal] Follow-up tool execution error for ${toolCall.toolName}:`, error);
@@ -2474,6 +2483,7 @@ export class ResponseModal<TContext = unknown, TData = unknown> {
     // UTILITY METHODS - Helper methods for tool management and other utilities
     // ============================================================================
 
+
     /**
      * Find an available tool by name for the given route using ToolManager
      * Delegates to ToolManager for unified tool resolution

package/src/core/ResponsePipeline.ts

@@ -19,6 +19,7 @@ import {
   logger,
   render,
   historyToEvents,
+  serializeToolResult,
 } from "../utils";
 import { createTemplateContext } from "../utils/template";
 import { Route } from "../core/Route";
@@ -46,6 +47,8 @@ export interface ToolExecutionResult<TData = unknown> {
   toolCalls:
   | Array<{ toolName: string; arguments: Record<string, unknown> }>
   | undefined;
+  /** Map of tool name to serialized result data for inclusion in conversation history */
+  toolResults?: Map<string, string>;
 }
 
 export interface DataCollectionResult<TData = unknown> {
@@ -303,6 +306,7 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
       toolName: string;
       arguments: Record<string, unknown>;
     }> = [];
+    const toolResults = new Map<string, string>();
 
     for (const toolCall of toolCalls) {
       const tool = this.findAvailableTool(toolCall.toolName, selectedRoute);
@@ -329,6 +333,9 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
 
       executedToolCalls.push(toolCall);
 
+      // Store the actual tool result data for history
+      toolResults.set(toolCall.toolName, serializeToolResult(result));
+
       // Update context with tool results
       if (result.contextUpdate) {
         await this.updateContext(result.contextUpdate as Partial<TContext>);
@@ -356,6 +363,7 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
     return {
       session: updatedSession,
       toolCalls: executedToolCalls.length > 0 ? executedToolCalls : undefined,
+      toolResults,
     };
   }
 
@@ -392,6 +400,8 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
     let currentToolCalls = initialToolCalls;
     let hasToolCalls = currentToolCalls && currentToolCalls.length > 0;
     let currentSession = session;
+    // Track tool results across loop iterations for history
+    let currentToolResults = new Map<string, string>();
 
     while (hasToolCalls && toolLoopCount < MAX_TOOL_LOOPS) {
       toolLoopCount++;
@@ -418,7 +428,7 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
             role: "tool" as const,
             tool_call_id: toolCall.toolName,
             name: toolCall.toolName,
-            content: "Tool executed successfully",
+            content: currentToolResults.get(toolCall.toolName) || "Tool executed successfully",
           });
         }
       }
@@ -460,6 +470,7 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
 
         currentSession = toolResult.session;
         currentToolCalls = followUpToolCalls;
+        currentToolResults = toolResult.toolResults || new Map();
       } else {
         logger.debug(
           `[ResponseHandler] ${isStreaming ? "Streaming " : ""
@@ -612,6 +623,7 @@ export class ResponsePipeline<TContext = unknown, TData = unknown> {
     return { session: updatedSession, hasTransition: false };
   }
 
+
   /**
    * Find an available tool by name for the given route using ToolManager
    * Delegates to ToolManager for unified tool resolution

package/src/utils/index.ts

@@ -67,3 +67,6 @@ export {
 
 // JSON utilities
 export { parseJSONResponse, tryParseJSONResponse } from "./json";
+
+// Serialization utilities
+export { serializeToolResult } from "./serialize";

package/src/utils/serialize.ts

@@ -0,0 +1,48 @@
+/**
+ * Serialization utilities for tool results and other data
+ */
+
+/**
+ * Serialize a tool execution result into a string suitable for conversation history.
+ *
+ * Priority:
+ *   1. Failed result → error message
+ *   2. String data   → returned as-is
+ *   3. Object data   → JSON.stringify (with circular-reference safety)
+ *   4. Primitive data → String()
+ *   5. No data       → "Tool executed successfully"
+ */
+export function serializeToolResult(result: {
+  success: boolean;
+  data?: unknown;
+  error?: string;
+}): string {
+  if (!result.success) {
+    return `Tool execution failed: ${result.error || "Unknown error"}`;
+  }
+
+  if (result.data === undefined || result.data === null) {
+    return "Tool executed successfully";
+  }
+
+  if (typeof result.data === "string") {
+    return result.data;
+  }
+
+  // Primitives (number, boolean) are safe to stringify directly
+  if (typeof result.data !== "object") {
+    return JSON.stringify(result.data);
+  }
+
+  // Objects / arrays — guard against circular references
+  try {
+    return JSON.stringify(result.data);
+  } catch {
+    // Circular or otherwise un-serializable object: extract what we can
+    const keys = Object.keys(result.data as Record<string, unknown>);
+    if (keys.length > 0) {
+      return `Tool returned object with keys: ${keys.join(", ")}`;
+    }
+    return "Tool executed successfully (result could not be serialized)";
+  }
+}