@falai/agent 2.2.4 → 2.4.1

package/dist/core/StepLifecycle.js

@@ -0,0 +1,93 @@
+/**
+ * StepLifecycle executes step `prepare` and `finalize` handlers.
+ *
+ * A handler may be a function, a registered tool id, or an inline tool.
+ * Used by the response prepare phase (prepare) and by SessionFinalizer
+ * (finalize).
+ */
+import { logger } from "../utils";
+export class StepLifecycle {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Execute prepare function for the session's current step if available.
+     * Auto-steps are skipped — their prepare is handled by AutoChainExecutor.
+     */
+    async runPrepare(session, context) {
+        if (session.currentFlow && session.currentStep) {
+            const currentFlow = this.deps.getFlows().find((r) => r.id === session.currentFlow?.id);
+            if (currentFlow) {
+                const currentStep = currentFlow.getStep(session.currentStep.id);
+                // Skip auto-steps — their prepare is handled by AutoChainExecutor
+                if (currentStep?.auto) {
+                    logger.debug(`[StepLifecycle] Skipping pre-routing prepare for auto-step: ${currentStep.id}`);
+                    return;
+                }
+                if (currentStep?.prepare) {
+                    logger.debug(`[StepLifecycle] Executing prepare for step: ${currentStep.id}`);
+                    await this.executePrepareFinalize(currentStep.prepare, context, session.data, currentFlow, currentStep);
+                }
+            }
+        }
+    }
+    /**
+     * Execute finalize function for the session's current step if available.
+     */
+    async runFinalize(session, context) {
+        if (session.currentFlow && session.currentStep) {
+            const currentFlow = this.deps.getFlows().find((r) => r.id === session.currentFlow?.id);
+            if (currentFlow) {
+                const currentStep = currentFlow.getStep(session.currentStep.id);
+                if (currentStep?.finalize) {
+                    logger.debug(`[StepLifecycle] Executing finalize for step: ${currentStep.id}`);
+                    await this.executePrepareFinalize(currentStep.finalize, context, session.data, currentFlow, currentStep);
+                }
+            }
+        }
+    }
+    /**
+     * Execute a prepare or finalize function/tool.
+     */
+    async executePrepareFinalize(prepareOrFinalize, context, data, flow, step) {
+        if (!prepareOrFinalize)
+            return;
+        if (typeof prepareOrFinalize === "function") {
+            // It's a function - call it directly
+            await prepareOrFinalize(context, data);
+        }
+        else {
+            // It's a tool reference - find and execute the tool
+            let tool;
+            if (typeof prepareOrFinalize === "string") {
+                // Tool ID - use ToolManager for unified resolution
+                tool = this.deps.toolManager.find(prepareOrFinalize, undefined, step, flow);
+            }
+            else {
+                // Tool object - use directly
+                tool = prepareOrFinalize;
+            }
+            if (tool) {
+                // Use ToolManager for unified tool execution
+                const result = await this.deps.toolManager.executeTool({
+                    tool,
+                    context,
+                    updateContext: this.deps.updateContext,
+                    updateData: this.deps.updateData,
+                    history: [], // Empty history for prepare/finalize
+                    data,
+                });
+                if (!result.success) {
+                    logger.error(`[StepLifecycle] Tool execution failed in prepare/finalize: ${result.error}`);
+                    throw new Error(`Tool execution failed: ${result.error}`);
+                }
+            }
+            else {
+                logger.warn(`[StepLifecycle] Tool not found for prepare/finalize: ${typeof prepareOrFinalize === "string"
+                    ? prepareOrFinalize
+                    : "inline tool"}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=StepLifecycle.js.map

package/dist/core/StepLifecycle.js.map

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

package/dist/core/ToolLoopExecutor.d.ts

@@ -0,0 +1,104 @@
+/**
+ * ToolLoopExecutor owns dynamic tool execution during response generation:
+ *
+ * - `runLoop()` — the run-tools-then-ask-LLM-again follow-up loop used by the
+ *   non-streaming path (and as the streaming fallback): executes the initial
+ *   tool calls sequentially, asks the provider whether more tools are needed,
+ *   reconstructs tool-result history items, and forces a final text response
+ *   when tools ran but no message was produced.
+ * - `runStreamingBatch()` — the streaming path's initial batch execution via
+ *   ToolManager.executeWithConcurrency (StreamingToolExecutor concurrency
+ *   rules), yielding tool-progress chunks; falls back to `runLoop()` when
+ *   concurrent execution fails.
+ *
+ * ToolManager remains the registry/resolver and single-tool executor.
+ */
+import type { AgentOptions, AgentResponseStreamChunk, AgentStructuredResponse, HistoryItem, SessionState } from "../types";
+import type { Flow } from "./Flow";
+import type { Step } from "./Step";
+import type { ToolManager } from "./ToolManager";
+export declare class ToolLoopExecutor<TContext = unknown, TData = unknown> {
+    private readonly deps;
+    constructor(deps: {
+        toolManager: ToolManager<TContext, TData>;
+        getAgentOptions: () => AgentOptions<TContext, TData>;
+        updateContext: (updates: Partial<TContext>) => Promise<void>;
+        updateCollectedData: (updates: Partial<TData>) => Promise<void>;
+        updateSessionData: (session: SessionState<TData>, dataUpdate: Partial<TData>) => Promise<SessionState<TData>>;
+        /** Maximum number of tool loops (defaults to 5). */
+        maxToolLoops?: number;
+    });
+    /**
+     * Unified tool execution logic with loop handling.
+     * Consolidates the complex tool execution logic from both streaming and
+     * non-streaming responses.
+     */
+    runLoop(params: {
+        toolCalls?: Array<{
+            toolName: string;
+            arguments: Record<string, unknown>;
+        }>;
+        context: TContext;
+        session: SessionState<TData>;
+        history: HistoryItem[];
+        selectedFlow?: Flow<TContext, TData>;
+        responsePrompt: string;
+        availableTools: Array<{
+            id: string;
+            name: string;
+            description?: string;
+            parameters?: unknown;
+        }>;
+        responseSchema?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): Promise<{
+        session: SessionState<TData>;
+        finalToolCalls?: Array<{
+            toolName: string;
+            arguments: Record<string, unknown>;
+        }>;
+        finalMessage?: string;
+        structured?: AgentStructuredResponse;
+    }>;
+    /**
+     * Execute the streaming path's initial batch of tool calls concurrently
+     * via ToolManager.executeWithConcurrency, yielding tool-progress chunks.
+     * Falls back to `runLoop()` when concurrent execution fails.
+     *
+     * Returns the updated session and the final tool calls.
+     */
+    runStreamingBatch(params: {
+        toolCalls: Array<{
+            toolName: string;
+            arguments: Record<string, unknown>;
+        }>;
+        context: TContext;
+        session: SessionState<TData>;
+        history: HistoryItem[];
+        selectedFlow: Flow<TContext, TData>;
+        step: Step<TContext, TData>;
+        /** Accumulated text of the LLM's final chunk, echoed on progress chunks. */
+        accumulated: string;
+        responsePrompt: string;
+        availableTools: Array<{
+            id: string;
+            name: string;
+            description?: string;
+            parameters?: unknown;
+        }>;
+        responseSchema?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): AsyncGenerator<AgentResponseStreamChunk<TData>, {
+        session: SessionState<TData>;
+        toolCalls: Array<{
+            toolName: string;
+            arguments: Record<string, unknown>;
+        }> | undefined;
+    }>;
+    /**
+     * Find an available tool by name for the given flow.
+     * Delegates to ToolManager for unified tool resolution.
+     */
+    private findAvailableTool;
+}
+//# sourceMappingURL=ToolLoopExecutor.d.ts.map

package/dist/core/ToolLoopExecutor.d.ts.map

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

package/dist/core/ToolLoopExecutor.js

@@ -0,0 +1,387 @@
+/**
+ * ToolLoopExecutor owns dynamic tool execution during response generation:
+ *
+ * - `runLoop()` — the run-tools-then-ask-LLM-again follow-up loop used by the
+ *   non-streaming path (and as the streaming fallback): executes the initial
+ *   tool calls sequentially, asks the provider whether more tools are needed,
+ *   reconstructs tool-result history items, and forces a final text response
+ *   when tools ran but no message was produced.
+ * - `runStreamingBatch()` — the streaming path's initial batch execution via
+ *   ToolManager.executeWithConcurrency (StreamingToolExecutor concurrency
+ *   rules), yielding tool-progress chunks; falls back to `runLoop()` when
+ *   concurrent execution fails.
+ *
+ * ToolManager remains the registry/resolver and single-tool executor.
+ */
+import { ResponseGenerationError } from "./ResponseGenerationError";
+import { historyToEvents, logger, serializeToolResult } from "../utils";
+export class ToolLoopExecutor {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Unified tool execution logic with loop handling.
+     * Consolidates the complex tool execution logic from both streaming and
+     * non-streaming responses.
+     */
+    async runLoop(params) {
+        try {
+            const { context, history, selectedFlow, responsePrompt, availableTools, responseSchema, signal } = params;
+            let { toolCalls, session } = params;
+            // Convert HistoryItem[] to Event[] for internal processing
+            const historyEvents = historyToEvents(history);
+            // Map to store tool execution results for history
+            const toolResultsMap = new Map();
+            // Map to store tool call arguments for history reconstruction
+            const toolArgsMap = new Map();
+            // Execute initial dynamic tool calls
+            if (toolCalls && toolCalls.length > 0) {
+                logger.debug(`[ToolLoopExecutor] Executing ${toolCalls.length} dynamic tool calls:`, toolCalls.map(tc => tc.toolName));
+                for (const toolCall of toolCalls) {
+                    const tool = this.findAvailableTool(toolCall.toolName, selectedFlow);
+                    if (!tool) {
+                        logger.warn(`[ToolExecutionError] Tool not found: "${toolCall.toolName}" is not registered in any scope. Skipping this tool call. Register the tool or check the tool name.`);
+                        continue;
+                    }
+                    try {
+                        // Use ToolManager for unified tool execution
+                        const toolResult = await this.deps.toolManager.executeTool({
+                            tool,
+                            context,
+                            updateContext: this.deps.updateContext,
+                            updateData: this.deps.updateCollectedData,
+                            history: historyEvents, // Use Event[] for tool execution
+                            data: session.data,
+                            toolArguments: toolCall.arguments,
+                        });
+                        // Store the actual tool result data for history
+                        toolResultsMap.set(toolCall.toolName, serializeToolResult(toolResult));
+                        toolArgsMap.set(toolCall.toolName, toolCall.arguments);
+                        // Check if tool execution was successful
+                        if (!toolResult.success) {
+                            logger.error(`[ToolLoopExecutor] Tool execution failed: ${toolCall.toolName} - ${toolResult.error}`);
+                            // Continue with other tools rather than failing completely
+                            continue;
+                        }
+                        // Update context with tool results
+                        if (toolResult.contextUpdate) {
+                            try {
+                                await this.deps.updateContext(toolResult.contextUpdate);
+                            }
+                            catch (error) {
+                                logger.error(`[ToolLoopExecutor] Failed to update context from tool ${toolCall.toolName}:`, error);
+                                // Continue execution but log the error
+                            }
+                        }
+                        // Update collected data with tool results
+                        if (toolResult.dataUpdate) {
+                            try {
+                                session = await this.deps.updateSessionData(session, toolResult.dataUpdate);
+                                logger.debug(`[ToolLoopExecutor] Tool updated collected data:`, toolResult.dataUpdate);
+                            }
+                            catch (error) {
+                                logger.error(`[ToolLoopExecutor] Failed to update data from tool ${toolCall.toolName}:`, error);
+                                // Continue execution but log the error
+                            }
+                        }
+                        logger.debug(`[ToolLoopExecutor] Executed dynamic tool: ${toolCall.toolName} (success: ${toolResult.success})`);
+                    }
+                    catch (error) {
+                        logger.error(`[ToolLoopExecutor] Tool execution error for ${toolCall.toolName}:`, error);
+                        // Continue with other tools rather than failing the entire response
+                        continue;
+                    }
+                }
+            }
+            // TOOL LOOP: Allow AI to make follow-up tool calls after initial tool execution
+            const MAX_TOOL_LOOPS = this.deps.maxToolLoops || 5;
+            let toolLoopCount = 0;
+            let hasToolCalls = toolCalls && toolCalls.length > 0;
+            let finalMessage;
+            let followUpStructured;
+            while (hasToolCalls && toolLoopCount < MAX_TOOL_LOOPS) {
+                toolLoopCount++;
+                logger.debug(`[ToolLoopExecutor] Starting tool loop ${toolLoopCount}/${MAX_TOOL_LOOPS} with ${toolCalls?.length || 0} tool calls`);
+                // Create tool result history items
+                const toolResultHistoryItems = [];
+                for (const toolCall of toolCalls || []) {
+                    const tool = this.findAvailableTool(toolCall.toolName, selectedFlow);
+                    if (tool) {
+                        // Create HistoryItem format for tool results
+                        // Add assistant message with tool_calls
+                        toolResultHistoryItems.push({
+                            role: "assistant",
+                            content: null,
+                            tool_calls: [{
+                                    id: toolCall.toolName,
+                                    name: toolCall.toolName,
+                                    arguments: toolCall.arguments,
+                                }],
+                        });
+                        // Add tool result
+                        toolResultHistoryItems.push({
+                            role: "tool",
+                            tool_call_id: toolCall.toolName,
+                            name: toolCall.toolName,
+                            content: toolResultsMap.get(toolCall.toolName) || "Tool executed successfully",
+                        });
+                    }
+                }
+                // Create updated history with tool results
+                const updatedHistory = [...history, ...toolResultHistoryItems];
+                // Make follow-up AI call to see if more tools are needed
+                // After first iteration, don't provide tools to force a text response
+                const agentOptions = this.deps.getAgentOptions();
+                const shouldProvideTools = toolLoopCount === 1;
+                logger.debug(`[ToolLoopExecutor] Making follow-up AI call (loop ${toolLoopCount}):`, {
+                    providingTools: shouldProvideTools,
+                    toolsCount: shouldProvideTools ? availableTools.length : 0,
+                    addingTextInstruction: toolLoopCount > 1,
+                });
+                const followUpResult = await agentOptions.provider.generateMessage({
+                    prompt: responsePrompt + (toolLoopCount > 1 ? "\n\nProvide a text response to the user based on the tool results." : ""),
+                    history: updatedHistory, // Use HistoryItem[] for AI provider
+                    context,
+                    tools: shouldProvideTools ? availableTools : [], // Only provide tools on first iteration
+                    parameters: responseSchema ? {
+                        jsonSchema: responseSchema,
+                        schemaName: "tool_followup",
+                    } : undefined,
+                    signal,
+                });
+                // Check if follow-up call has more tool calls
+                const followUpToolCalls = followUpResult.structured?.toolCalls;
+                hasToolCalls = followUpToolCalls && followUpToolCalls.length > 0;
+                logger.debug(`[ToolLoopExecutor] Follow-up AI response (loop ${toolLoopCount}):`, {
+                    hasMessage: !!followUpResult.message,
+                    messageLength: followUpResult.message?.length || 0,
+                    hasToolCalls,
+                    toolCallsCount: followUpToolCalls?.length || 0,
+                    toolNames: followUpToolCalls?.map(tc => tc.toolName) || [],
+                });
+                if (hasToolCalls) {
+                    logger.debug(`[ToolLoopExecutor] Follow-up call produced ${followUpToolCalls.length} additional tool calls`);
+                    // Execute the follow-up tool calls
+                    for (const toolCall of followUpToolCalls) {
+                        const tool = this.findAvailableTool(toolCall.toolName, selectedFlow);
+                        if (!tool) {
+                            logger.warn(`[ToolExecutionError] Tool not found in follow-up: "${toolCall.toolName}" is not registered in any scope. Skipping this tool call. Register the tool or check the tool name.`);
+                            continue;
+                        }
+                        try {
+                            // Use ToolManager for unified tool execution
+                            const toolResult = await this.deps.toolManager.executeTool({
+                                tool,
+                                context,
+                                updateContext: this.deps.updateContext,
+                                updateData: this.deps.updateCollectedData,
+                                history: historyToEvents(updatedHistory), // Convert to Event[] for tool execution
+                                data: session.data,
+                                toolArguments: toolCall.arguments,
+                            });
+                            // Check if tool execution was successful
+                            if (!toolResult.success) {
+                                logger.error(`[ToolLoopExecutor] Follow-up tool execution failed: ${toolCall.toolName} - ${toolResult.error}`);
+                                continue;
+                            }
+                            // Update context with follow-up tool results
+                            if (toolResult.contextUpdate) {
+                                try {
+                                    await this.deps.updateContext(toolResult.contextUpdate);
+                                }
+                                catch (error) {
+                                    logger.error(`[ToolLoopExecutor] Failed to update context from follow-up tool ${toolCall.toolName}:`, error);
+                                }
+                            }
+                            if (toolResult.dataUpdate) {
+                                try {
+                                    session = await this.deps.updateSessionData(session, toolResult.dataUpdate);
+                                    logger.debug(`[ToolLoopExecutor] Follow-up tool updated collected data:`, toolResult.dataUpdate);
+                                }
+                                catch (error) {
+                                    logger.error(`[ToolLoopExecutor] Failed to update data from follow-up tool ${toolCall.toolName}:`, error);
+                                }
+                            }
+                            // Store the follow-up tool result for potential next loop iteration
+                            toolResultsMap.set(toolCall.toolName, serializeToolResult(toolResult));
+                            toolArgsMap.set(toolCall.toolName, toolCall.arguments);
+                            logger.debug(`[ToolLoopExecutor] Executed follow-up tool: ${toolCall.toolName} (success: ${toolResult.success})`);
+                        }
+                        catch (error) {
+                            logger.error(`[ToolLoopExecutor] Follow-up tool execution error for ${toolCall.toolName}:`, error);
+                            continue;
+                        }
+                    }
+                    // Update toolCalls for next iteration or final response
+                    toolCalls = followUpToolCalls;
+                }
+                else {
+                    logger.debug(`[ToolLoopExecutor] Tool loop completed after ${toolLoopCount} iterations`);
+                    // Update final message and toolCalls from follow-up result if no more tools
+                    finalMessage = followUpResult.structured?.message || followUpResult.message;
+                    followUpStructured = followUpResult.structured;
+                    toolCalls = followUpToolCalls || [];
+                    break;
+                }
+            }
+            if (toolLoopCount >= MAX_TOOL_LOOPS) {
+                logger.warn(`[ResponseGenerationError] Tool loop limit reached: ${toolLoopCount} iterations hit the cap (${MAX_TOOL_LOOPS}). Stopping tool execution. Increase MAX_TOOL_LOOPS or reduce recursive tool calls.`);
+            }
+            // If tools were executed but no final text message was produced,
+            // make one more LLM call to generate a proper text response from tool results.
+            // This prevents the original tool-invocation message (e.g. "Let me check...")
+            // from being returned as the final user-facing response.
+            if (!finalMessage && toolLoopCount > 0) {
+                logger.debug(`[ToolLoopExecutor] No final message after tool loop, making additional LLM call for text response`);
+                // Build tool result history from toolResultsMap which contains ALL
+                // tool executions (initial + follow-up). We can't use `toolCalls` here
+                // because it was reassigned to the (empty) follow-up tool calls when
+                // the while loop broke out.
+                const finalToolResultHistoryItems = [];
+                for (const [toolName, toolResult] of toolResultsMap) {
+                    finalToolResultHistoryItems.push({
+                        role: "assistant",
+                        content: null,
+                        tool_calls: [{
+                                id: toolName,
+                                name: toolName,
+                                arguments: toolArgsMap.get(toolName) || {},
+                            }],
+                    });
+                    finalToolResultHistoryItems.push({
+                        role: "tool",
+                        tool_call_id: toolName,
+                        name: toolName,
+                        content: toolResult,
+                    });
+                }
+                const finalHistory = [...history, ...finalToolResultHistoryItems];
+                const agentOptions = this.deps.getAgentOptions();
+                try {
+                    const textResult = await agentOptions.provider.generateMessage({
+                        prompt: responsePrompt + "\n\nProvide a text response to the user based on the tool results. Do not call any tools.",
+                        history: finalHistory,
+                        context,
+                        tools: [], // No tools - force text response
+                        parameters: responseSchema ? {
+                            jsonSchema: responseSchema,
+                            schemaName: "tool_final_text",
+                        } : undefined,
+                        signal,
+                    });
+                    finalMessage = textResult.structured?.message || textResult.message;
+                    if (textResult.structured) {
+                        followUpStructured = textResult.structured;
+                    }
+                    logger.debug(`[ToolLoopExecutor] Generated final text response after tool loop:`, {
+                        hasMessage: !!finalMessage,
+                        messageLength: finalMessage?.length || 0,
+                    });
+                }
+                catch (error) {
+                    logger.error(`[ToolLoopExecutor] Failed to generate final text response after tool loop:`, error);
+                    // finalMessage remains undefined; caller will use original message as fallback
+                }
+            }
+            logger.debug(`[ToolLoopExecutor] Tool loop completed:`, {
+                totalIterations: toolLoopCount,
+                hasFinalMessage: !!finalMessage,
+                finalMessageLength: finalMessage?.length || 0,
+                finalToolCallsCount: toolCalls?.length || 0,
+            });
+            return {
+                session,
+                finalToolCalls: toolCalls,
+                finalMessage,
+                structured: followUpStructured,
+            };
+        }
+        catch (error) {
+            throw ResponseGenerationError.fromError(error, 'tool_execution', params, {
+                toolCallsCount: params.toolCalls?.length || 0,
+                availableToolsCount: params.availableTools.length
+            });
+        }
+    }
+    /**
+     * Execute the streaming path's initial batch of tool calls concurrently
+     * via ToolManager.executeWithConcurrency, yielding tool-progress chunks.
+     * Falls back to `runLoop()` when concurrent execution fails.
+     *
+     * Returns the updated session and the final tool calls.
+     */
+    async *runStreamingBatch(params) {
+        const { context, history, selectedFlow, step, accumulated, responsePrompt, availableTools, responseSchema, signal } = params;
+        let { session } = params;
+        let toolCalls = params.toolCalls;
+        // Use concurrent execution for the initial batch of tool calls
+        const toolCallRequests = params.toolCalls.map((tc, i) => ({
+            id: `${tc.toolName}-${i}-${Date.now()}`,
+            toolName: tc.toolName,
+            arguments: tc.arguments,
+        }));
+        const historyEvents = historyToEvents(history);
+        try {
+            for await (const update of this.deps.toolManager.executeWithConcurrency({
+                toolCalls: toolCallRequests,
+                context,
+                data: session.data,
+                history: historyEvents,
+                signal,
+                flow: selectedFlow,
+                step,
+            })) {
+                // Apply context updates
+                if (update.contextUpdate) {
+                    try {
+                        await this.deps.updateContext(update.contextUpdate);
+                    }
+                    catch (error) {
+                        logger.error(`[ToolLoopExecutor] Failed to update context from concurrent tool:`, error);
+                    }
+                }
+                // Apply data updates
+                if (update.dataUpdate) {
+                    try {
+                        session = await this.deps.updateSessionData(session, update.dataUpdate);
+                    }
+                    catch (error) {
+                        logger.error(`[ToolLoopExecutor] Failed to update data from concurrent tool:`, error);
+                    }
+                }
+                // Yield progress updates immediately
+                if (update.progress) {
+                    yield {
+                        delta: '',
+                        accumulated,
+                        done: false,
+                        session,
+                        toolCalls: undefined,
+                        isFlowComplete: false,
+                        metadata: { toolProgress: update.progress, toolCallId: update.toolCallId },
+                    };
+                }
+            }
+            logger.debug(`[ToolLoopExecutor] Concurrent tool execution completed for ${toolCallRequests.length} tools`);
+        }
+        catch (error) {
+            logger.error(`[ToolLoopExecutor] Concurrent tool execution failed, falling back to sequential:`, error);
+            // Fall back to the unified tool loop on failure
+            const toolResult = await this.runLoop({
+                toolCalls, context, session, history, selectedFlow,
+                responsePrompt, availableTools, responseSchema, signal,
+            });
+            session = toolResult.session;
+            toolCalls = toolResult.finalToolCalls;
+        }
+        return { session, toolCalls };
+    }
+    /**
+     * Find an available tool by name for the given flow.
+     * Delegates to ToolManager for unified tool resolution.
+     */
+    findAvailableTool(toolName, flow) {
+        return this.deps.toolManager.find(toolName, undefined, undefined, flow);
+    }
+}
+//# sourceMappingURL=ToolLoopExecutor.js.map

package/dist/core/ToolLoopExecutor.js.map

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

package/dist/core/ToolManager.d.ts

@@ -3,7 +3,7 @@
  */
 import type { Tool, ToolExecutionResult, DataEnrichmentConfig, ValidationConfig, ValidationResult, ApiCallConfig, ComputationConfig, ToolCallRequest, ToolExecutionUpdate, Event } from "../types";
 import { ToolScope } from "../types";
-import { Agent } from "./Agent";
+import type { Agent } from "./Agent";
 import { Flow } from "./Flow";
 import { Step } from "./Step";
 /**