Function convertToUnifiedHistory

core/util/messageConversion.ts:255–299

(
  messages: ChatCompletionMessageParam[],
)

 * Convert array of ChatCompletionMessageParam to ChatHistoryItem array
 */
export function convertToUnifiedHistory(
  messages: ChatCompletionMessageParam[],
): ChatHistoryItem[] {
  const historyItems: ChatHistoryItem[] = [];
  const pendingToolCalls: Map<string, ToolCall> = new Map();

  for (const message of messages) {
    const unifiedMessage = convertToUnifiedMessage(message);

    if (unifiedMessage.role === "assistant" && unifiedMessage.toolCalls) {
      // Store tool calls for matching with results
      const toolCallStates: ToolCallState[] = unifiedMessage.toolCalls.map(
        (tc: any) => {
          const toolCall: ToolCall = {
            id: tc.id || "",
            type: "function",
            function: {
              name: tc.function?.name || "",
              arguments: tc.function?.arguments || "",
            },
            ...(tc.extra_content && { extra_content: tc.extra_content }),
          };
          pendingToolCalls.set(toolCall.id, toolCall);

          return {
            toolCallId: toolCall.id,
            toolCall,
            status: "done" as ToolStatus, // Historical calls are complete
            parsedArgs: tryParseJson(toolCall.function.arguments),
          };
        },
      );

      historyItems.push(createHistoryItem(unifiedMessage, [], toolCallStates));
    } else if (unifiedMessage.role === "tool") {
      // Tool result - handle separately to reduce nesting
      handleToolResult(unifiedMessage, pendingToolCalls, historyItems);
      // Don't add tool messages as separate history items
    } else {
      historyItems.push(createHistoryItem(unifiedMessage));
    }
  }

  return historyItems;
}

/**
 * Convert ChatHistoryItem array to ChatCompletionMessageParam array