@melara/sdk 0.0.0-stage → 0.1.0

package/esm/lib/tool-orchestrator.js

@@ -0,0 +1,182 @@
+// Modified by Melara for the Melara SDK fork.
+import { en } from "../locales/en.js";
+import { extractToolCallsFromResponse, responseHasToolCalls } from './stream-transformers.js';
+import { isFunctionCallItem } from './stream-type-guards.js';
+import { executeTool, findToolByName } from './tool-executor.js';
+import { hasExecuteFunction } from './tool-types.js';
+import { buildTurnContext } from './turn-context.js';
+import { executeNextTurnParamsFunctions, applyNextTurnParamsToRequest } from './next-turn-params.js';
+/**
+ * Execute tool calls and manage multi-turn conversations
+ * This orchestrates the loop of: request -> tool calls -> execute -> send results -> repeat
+ *
+ * @param sendRequest - Function to send a request and get a response
+ * @param initialInput - Starting input for the conversation
+ * @param initialRequest - Full initial request with all parameters
+ * @param tools - Enhanced tools with Zod schemas and execute functions
+ * @param apiTools - Converted tools in API format (JSON Schema)
+ * @param options - Execution options
+ * @returns Result containing final response and all execution data
+ */
+export async function executeToolLoop(sendRequest, initialInput, initialRequest, tools, apiTools, options = {}) {
+    const onPreliminaryResult = options.onPreliminaryResult;
+    const allResponses = [];
+    const toolExecutionResults = [];
+    let conversationInput = initialInput;
+    let currentRequest = { ...initialRequest };
+    let currentRound = 0;
+    let currentResponse;
+    // Initial request
+    currentResponse = await sendRequest(conversationInput, apiTools);
+    allResponses.push(currentResponse);
+    // Loop until no more tool calls (model decides when to stop)
+    while (responseHasToolCalls(currentResponse)) {
+        currentRound++;
+        // Extract tool calls from response
+        const toolCalls = extractToolCallsFromResponse(currentResponse);
+        if (toolCalls.length === 0) {
+            break;
+        }
+        // Check if any tools have execute functions
+        const hasExecutableTools = toolCalls.some((toolCall) => {
+            const tool = findToolByName(tools, toolCall.name);
+            return tool && hasExecuteFunction(tool);
+        });
+        // If no executable tools, return (manual execution mode)
+        if (!hasExecutableTools) {
+            break;
+        }
+        // Execute all tool calls in parallel (parallel tool calling)
+        const toolCallPromises = toolCalls.map(async (toolCall) => {
+            const tool = findToolByName(tools, toolCall.name);
+            if (!tool) {
+                // Tool not found in definitions
+                return {
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    result: null,
+                    error: new Error(en.toolNotFoundInToolDefinitions(toolCall.name)),
+                };
+            }
+            if (!hasExecuteFunction(tool)) {
+                // Tool has no execute function - return null to filter out
+                return null;
+            }
+            // Find the raw tool call from the response output
+            const rawToolCall = currentResponse.output.find((item) => isFunctionCallItem(item) && item.callId === toolCall.id);
+            if (!rawToolCall) {
+                throw new Error(en.couldNotFindRawToolCallFor(toolCall.id));
+            }
+            // Convert to FunctionCallItem format
+            const openResponsesToolCall = {
+                type: 'function_call',
+                callId: rawToolCall.callId,
+                name: rawToolCall.name,
+                arguments: rawToolCall.arguments,
+                id: rawToolCall.callId,
+                status: rawToolCall.status,
+            };
+            // Build turn context with full information
+            const turnContext = buildTurnContext({
+                numberOfTurns: currentRound,
+                toolCall: openResponsesToolCall,
+                turnRequest: currentRequest,
+            });
+            // Execute the tool
+            return executeTool(tool, toolCall, turnContext, onPreliminaryResult);
+        });
+        // Wait for all tool executions to complete in parallel
+        const settledResults = await Promise.allSettled(toolCallPromises);
+        // Process settled results, handling both fulfilled and rejected promises
+        const roundResults = [];
+        settledResults.forEach((settled, i) => {
+            const toolCall = toolCalls[i];
+            if (!toolCall)
+                return;
+            if (settled.status === "fulfilled") {
+                if (settled.value !== null) {
+                    roundResults.push(settled.value);
+                }
+            }
+            else {
+                // Promise rejected - create error result
+                roundResults.push({
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    result: null,
+                    error: settled.reason instanceof Error
+                        ? settled.reason
+                        : new Error(String(settled.reason)),
+                });
+            }
+        });
+        toolExecutionResults.push(...roundResults);
+        // Execute nextTurnParams functions for tools that were called
+        const computedParams = await executeNextTurnParamsFunctions(toolCalls, tools, currentRequest);
+        // Apply computed parameters to request
+        if (Object.keys(computedParams).length > 0) {
+            currentRequest = applyNextTurnParamsToRequest(currentRequest, computedParams);
+            conversationInput = currentRequest.input ?? conversationInput;
+        }
+        // Build array input with all output from previous response plus tool results
+        // The API expects continuation via previousResponseId, not by including outputs
+        // For now, we'll keep the conversation going via previousResponseId
+        // conversationInput is updated above if nextTurnParams modified it
+        // Note: The Melara Responses API uses previousResponseId for continuation
+        // Tool results are automatically associated with the previous response's tool calls
+        // Send updated conversation to API - this should use previousResponseId
+        currentResponse = await sendRequest(conversationInput, apiTools);
+        allResponses.push(currentResponse);
+    }
+    return {
+        finalResponse: currentResponse,
+        allResponses,
+        toolExecutionResults,
+        conversationInput,
+    };
+}
+/**
+ * Convert tool execution results to a map for easy lookup
+ */
+export function toolResultsToMap(results) {
+    const map = new Map();
+    for (const result of results) {
+        map.set(result.toolCallId, {
+            result: result.result,
+            preliminaryResults: result.preliminaryResults,
+        });
+    }
+    return map;
+}
+/**
+ * Build a summary of tool executions for debugging/logging
+ */
+export function summarizeToolExecutions(results) {
+    const lines = [];
+    for (const result of results) {
+        if (result.error) {
+            lines.push(en.error(result.toolName, result.toolCallId, result.error.message));
+        }
+        else {
+            const prelimCount = result.preliminaryResults?.length ?? 0;
+            const prelimInfo = prelimCount > 0 ? en.preliminaryResults(prelimCount) : '';
+            lines.push(en.success(result.toolName, result.toolCallId, prelimInfo));
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Check if any tool executions had errors
+ */
+export function hasToolExecutionErrors(results) {
+    return results.some((result) => result.error !== undefined);
+}
+/**
+ * Get all tool execution errors
+ */
+export function getToolExecutionErrors(results) {
+    return results
+        .filter((result) => result.error !== undefined)
+        .map((result) => result.error);
+}
+//# sourceMappingURL=tool-orchestrator.js.map

package/esm/lib/tool-orchestrator.js.map

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