Open History to see the last commit
1<?php
2
3namespace TanStack\AI;
4
5/**
6 * Message formatting utilities for converting between TanStack AI and provider formats.
7 */
8class MessageFormatters
9{
10 /**
11 * Convert TanStack AI message format to Anthropic format.
12 * Separates system messages and formats tool messages.
13 *
14 * @param array $messages List of TanStack AI messages
15 * @return array Tuple of [system_message, formatted_messages]
16 */
17 public static function formatMessagesForAnthropic(array $messages): array
18 {
19 // Separate system messages
20 $systemMessages = array_filter($messages, fn($m) => ($m['role'] ?? 'user') === 'system');
21 $nonSystemMessages = array_filter($messages, fn($m) => ($m['role'] ?? 'user') !== 'system');
22
23 // Anthropic API expects system to be a string (not a list)
24 // Multiple system messages are joined with newlines
25 $systemMessage = null;
26 if (!empty($systemMessages)) {
27 $systemContent = implode("\n", array_map(
28 fn($m) => $m['content'] ?? '',
29 array_filter($systemMessages, fn($m) => !empty($m['content'] ?? ''))
30 ));
31 if (trim($systemContent) !== '') {
32 $systemMessage = $systemContent;
33 }
34 }
35
36 $formattedMessages = [];
37 foreach ($nonSystemMessages as $msg) {
38 $role = $msg['role'] ?? 'user';
39 $content = $msg['content'] ?? null;
40 $toolCalls = $msg['toolCalls'] ?? null;
41 $toolCallId = $msg['toolCallId'] ?? null;
42
43 if ($role === 'tool' && $toolCallId) {
44 // Tool result message
45 $formattedMessages[] = [
46 'role' => 'user',
47 'content' => [[
48 'type' => 'tool_result',
49 'tool_use_id' => $toolCallId,
50 'content' => $content ?? ''
51 ]]
52 ];
53 } elseif ($role === 'assistant' && $toolCalls) {
54 // Assistant message with tool calls
55 $contentList = [];
56 if ($content) {
57 $contentList[] = ['type' => 'text', 'text' => $content];
58 }
59
60 foreach ($toolCalls as $toolCall) {
61 $contentList[] = [
62 'type' => 'tool_use',
63 'id' => $toolCall['id'],
64 'name' => $toolCall['function']['name'],
65 'input' => json_decode($toolCall['function']['arguments'], true)
66 ];
67 }
68
69 $formattedMessages[] = [
70 'role' => 'assistant',
71 'content' => $contentList
72 ];
73 } else {
74 // Regular message
75 $formattedMessages[] = [
76 'role' => in_array($role, ['assistant', 'user']) ? $role : 'user',
77 'content' => $content ?? ''
78 ];
79 }
80 }
81
82 return [$systemMessage, array_values($formattedMessages)];
83 }
84
85 /**
86 * Convert TanStack AI message format to OpenAI format.
87 *
88 * @param array $messages List of TanStack AI messages
89 * @return array List of OpenAI-formatted messages
90 */
91 public static function formatMessagesForOpenAI(array $messages): array
92 {
93 $formattedMessages = [];
94
95 foreach ($messages as $msg) {
96 $role = $msg['role'] ?? 'user';
97 $content = $msg['content'] ?? null;
98 $toolCalls = $msg['toolCalls'] ?? null;
99 $toolCallId = $msg['toolCallId'] ?? null;
100 $name = $msg['name'] ?? null;
101
102 if ($role === 'tool' && $toolCallId) {
103 $formattedMessages[] = [
104 'role' => 'tool',
105 'content' => $content ?? '',
106 'tool_call_id' => $toolCallId
107 ];
108 } elseif ($role === 'assistant' && $toolCalls) {
109 $formattedMessages[] = [
110 'role' => 'assistant',
111 'content' => $content,
112 'tool_calls' => array_map(
113 fn($tc) => [
114 'id' => $tc['id'],
115 'type' => $tc['type'],
116 'function' => $tc['function']
117 ],
118 $toolCalls
119 )
120 ];
121 } else {
122 $formattedMsg = [
123 'role' => in_array($role, ['system', 'user', 'assistant']) ? $role : 'user',
124 'content' => $content ?? ''
125 ];
126 if ($name) {
127 $formattedMsg['name'] = $name;
128 }
129 $formattedMessages[] = $formattedMsg;
130 }
131 }
132
133 return $formattedMessages;
134 }
135}
136