PromptBuilder::parseMessage( mixed $input, WordPress\AiClient\Messages\Enums\MessageRoleEnum $defaultRole ): WordPress\AiClient\Messages\DTO\Message

1311    private function parseMessage($input, MessageRoleEnum $defaultRole): Message1312    {1313        // Handle Message input directly1314        if ($input instanceof Message) {1315            return $input;1316        }1317        // Handle single MessagePart1318        if ($input instanceof MessagePart) {1319            return new Message($defaultRole, [$input]);1320        }1321        // Handle string input1322        if (is_string($input)) {1323            if (trim($input) === '') {1324                throw new InvalidArgumentException('Cannot create a message from an empty string.');1325            }1326            return new Message($defaultRole, [new MessagePart($input)]);1327        }1328        // Handle array input1329        if (!is_array($input)) {1330            throw new InvalidArgumentException('Input must be a string, MessagePart, MessagePartArrayShape, ' . 'a list of string|MessagePart|MessagePartArrayShape, or a Message instance.');1331        }1332        // Handle MessageArrayShape input1333        if (Message::isArrayShape($input)) {1334            return Message::fromArray($input);1335        }1336        // Check if it's a MessagePartArrayShape1337        if (MessagePart::isArrayShape($input)) {1338            return new Message($defaultRole, [MessagePart::fromArray($input)]);1339        }1340        // It should be a list of string|MessagePart|MessagePartArrayShape1341        if (!array_is_list($input)) {1342            throw new InvalidArgumentException('Array input must be a list array.');1343        }1344        // Empty array check1345        if (empty($input)) {1346            throw new InvalidArgumentException('Cannot create a message from an empty array.');1347        }1348        $parts = [];1349        foreach ($input as $item) {1350            if (is_string($item)) {1351                $parts[] = new MessagePart($item);1352            } elseif ($item instanceof MessagePart) {1353                $parts[] = $item;1354            } elseif (is_array($item) && MessagePart::isArrayShape($item)) {1355                $parts[] = MessagePart::fromArray($item);1356            } else {1357                throw new InvalidArgumentException('Array items must be strings, MessagePart instances, or MessagePartArrayShape.');1358            }1359        }1360        return new Message($defaultRole, $parts);1361    }