@sveda-ai/chat 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/LICENSE +557 -0
  2. package/README.md +18 -0
  3. package/dist/appearance.d.ts +54 -0
  4. package/dist/appearance.d.ts.map +1 -0
  5. package/dist/appearance.js +516 -0
  6. package/dist/appearance.js.map +1 -0
  7. package/dist/chatStore.d.ts +60 -0
  8. package/dist/chatStore.d.ts.map +1 -0
  9. package/dist/chatStore.js +518 -0
  10. package/dist/chatStore.js.map +1 -0
  11. package/dist/i18n/catalogs.d.ts +4 -0
  12. package/dist/i18n/catalogs.d.ts.map +1 -0
  13. package/dist/i18n/catalogs.js +3 -0
  14. package/dist/i18n/catalogs.js.map +1 -0
  15. package/dist/i18n/locales/en.d.ts +4 -0
  16. package/dist/i18n/locales/en.d.ts.map +1 -0
  17. package/dist/i18n/locales/en.js +59 -0
  18. package/dist/i18n/locales/en.js.map +1 -0
  19. package/dist/i18n/locales/ru.d.ts +4 -0
  20. package/dist/i18n/locales/ru.d.ts.map +1 -0
  21. package/dist/i18n/locales/ru.js +59 -0
  22. package/dist/i18n/locales/ru.js.map +1 -0
  23. package/dist/i18n/types.d.ts +2 -0
  24. package/dist/i18n/types.d.ts.map +1 -0
  25. package/dist/i18n/types.js +2 -0
  26. package/dist/i18n/types.js.map +1 -0
  27. package/dist/index.d.ts +27 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +19 -0
  30. package/dist/index.js.map +1 -0
  31. package/dist/lib/assistantMessage.d.ts +90 -0
  32. package/dist/lib/assistantMessage.d.ts.map +1 -0
  33. package/dist/lib/assistantMessage.js +311 -0
  34. package/dist/lib/assistantMessage.js.map +1 -0
  35. package/dist/lib/chatHistoryMerge.d.ts +20 -0
  36. package/dist/lib/chatHistoryMerge.d.ts.map +1 -0
  37. package/dist/lib/chatHistoryMerge.js +61 -0
  38. package/dist/lib/chatHistoryMerge.js.map +1 -0
  39. package/dist/lib/chatI18nKeys.d.ts +2 -0
  40. package/dist/lib/chatI18nKeys.d.ts.map +1 -0
  41. package/dist/lib/chatI18nKeys.js +63 -0
  42. package/dist/lib/chatI18nKeys.js.map +1 -0
  43. package/dist/lib/chatMessageVisibility.d.ts +6 -0
  44. package/dist/lib/chatMessageVisibility.d.ts.map +1 -0
  45. package/dist/lib/chatMessageVisibility.js +68 -0
  46. package/dist/lib/chatMessageVisibility.js.map +1 -0
  47. package/dist/lib/chatResize.d.ts +42 -0
  48. package/dist/lib/chatResize.d.ts.map +1 -0
  49. package/dist/lib/chatResize.js +71 -0
  50. package/dist/lib/chatResize.js.map +1 -0
  51. package/dist/lib/chatTabs.d.ts +9 -0
  52. package/dist/lib/chatTabs.d.ts.map +1 -0
  53. package/dist/lib/chatTabs.js +34 -0
  54. package/dist/lib/chatTabs.js.map +1 -0
  55. package/dist/lib/chatTitle.d.ts +3 -0
  56. package/dist/lib/chatTitle.d.ts.map +1 -0
  57. package/dist/lib/chatTitle.js +25 -0
  58. package/dist/lib/chatTitle.js.map +1 -0
  59. package/dist/lib/chatUiStorage.d.ts +6 -0
  60. package/dist/lib/chatUiStorage.d.ts.map +1 -0
  61. package/dist/lib/chatUiStorage.js +61 -0
  62. package/dist/lib/chatUiStorage.js.map +1 -0
  63. package/dist/lib/finalizeMessages.d.ts +21 -0
  64. package/dist/lib/finalizeMessages.d.ts.map +1 -0
  65. package/dist/lib/finalizeMessages.js +54 -0
  66. package/dist/lib/finalizeMessages.js.map +1 -0
  67. package/dist/lib/markdown.d.ts +8 -0
  68. package/dist/lib/markdown.d.ts.map +1 -0
  69. package/dist/lib/markdown.js +69 -0
  70. package/dist/lib/markdown.js.map +1 -0
  71. package/dist/lib/modelLabels.d.ts +3 -0
  72. package/dist/lib/modelLabels.d.ts.map +1 -0
  73. package/dist/lib/modelLabels.js +23 -0
  74. package/dist/lib/modelLabels.js.map +1 -0
  75. package/dist/lib/toolConfirmation.d.ts +11 -0
  76. package/dist/lib/toolConfirmation.d.ts.map +1 -0
  77. package/dist/lib/toolConfirmation.js +16 -0
  78. package/dist/lib/toolConfirmation.js.map +1 -0
  79. package/dist/lib/userMessage.d.ts +17 -0
  80. package/dist/lib/userMessage.d.ts.map +1 -0
  81. package/dist/lib/userMessage.js +33 -0
  82. package/dist/lib/userMessage.js.map +1 -0
  83. package/dist/streaming.d.ts +59 -0
  84. package/dist/streaming.d.ts.map +1 -0
  85. package/dist/streaming.js +375 -0
  86. package/dist/streaming.js.map +1 -0
  87. package/package.json +53 -0
  88. package/src/appearance.ts +654 -0
  89. package/src/chatStore.ts +696 -0
  90. package/src/i18n/catalogs.ts +3 -0
  91. package/src/i18n/locales/en.ts +64 -0
  92. package/src/i18n/locales/ru.ts +65 -0
  93. package/src/i18n/types.ts +1 -0
  94. package/src/index.ts +84 -0
  95. package/src/lib/assistantMessage.ts +439 -0
  96. package/src/lib/chatHistoryMerge.ts +93 -0
  97. package/src/lib/chatI18nKeys.ts +64 -0
  98. package/src/lib/chatMessageVisibility.ts +92 -0
  99. package/src/lib/chatResize.ts +123 -0
  100. package/src/lib/chatTabs.ts +54 -0
  101. package/src/lib/chatTitle.ts +30 -0
  102. package/src/lib/chatUiStorage.ts +69 -0
  103. package/src/lib/finalizeMessages.ts +81 -0
  104. package/src/lib/markdown.ts +90 -0
  105. package/src/lib/modelLabels.ts +24 -0
  106. package/src/lib/toolConfirmation.ts +31 -0
  107. package/src/lib/userMessage.ts +55 -0
  108. package/src/streaming.ts +514 -0
@@ -0,0 +1,64 @@
1
+ import type { SvedaMessages } from '../types.js';
2
+
3
+ const en: SvedaMessages = {
4
+ chatTitle: 'AI Assistant',
5
+ welcomeMessage: "Hi! I'm your AI assistant. How can I help you today?",
6
+ newChat: 'New Chat',
7
+ newChatNumbered: 'New Chat {number}',
8
+ chatHistory: 'Chat History',
9
+ closeChatTab: 'Close chat tab',
10
+ chatTabRunning: 'Agent is working',
11
+ chatTabUnread: 'New response ready',
12
+ quickPromptsTitle: 'Ask me anything',
13
+ confirmDeleteChat: 'Are you sure you want to delete this chat?',
14
+ renameChat: 'Rename chat',
15
+ renameChatPlaceholder: 'Enter chat name',
16
+ analyzingRequest: 'Analyzing your request...',
17
+ preparingReply: 'Preparing a reply…',
18
+ errorSendingMessage: 'Failed to send message. Please try again.',
19
+ agentFinishedNotice: 'Agent finished',
20
+ maxStepsReachedNotice:
21
+ 'The agent reached the step limit for this request ({limit}). Press Continue to resume in this chat.',
22
+ maxStepsContinue: 'Continue',
23
+ maxStepsContinuePrompt:
24
+ 'Continue from where you stopped. Briefly summarize what you already found, then keep working on the task.',
25
+ viewModeFixed: 'Switch to fixed view',
26
+ viewModeFloating: 'Switch to floating view',
27
+ immersiveModeEnter: 'Immersive mode',
28
+ immersiveModeExit: 'Exit immersive mode',
29
+ toolbarMinimize: 'Minimize',
30
+ modelSelectPlaceholder: 'Model',
31
+ thinkingTooltip:
32
+ 'Chain-of-thought reasoning before the answer. Improves accuracy; responses may take longer.',
33
+ assistantLogoAlt: 'AI assistant',
34
+ contextWindowUsage: 'Context window usage',
35
+ contextWindowPercent: 'Used: {percent}%',
36
+ chatDocumentsExtracting: 'Extracting text from documents…',
37
+ chatDocumentsHeader: 'Attached document content:',
38
+ chatDocumentTruncatedNotice: '[Truncated: reached extracted-text limit for this message.]',
39
+ chatDocumentErrorReadFailed: 'Could not read the file.',
40
+ chatDocumentErrorEmpty: 'Could not extract text from the file.',
41
+ chatDocumentErrorQuotaExceeded: '[Skipped: overall extracted-text limit reached.]',
42
+ chatDocumentErrorUnknown: 'Could not extract text from this file.',
43
+ chatDocumentsExtractFailed: 'Could not process attachments. Please try again.',
44
+ chatAttachmentOnlyPlaceholder: 'Documents: {names}',
45
+ agentTasksTitle: 'Parallel agents',
46
+ agentTasksSpawnPhase: 'Batch agent run',
47
+ phaseSearchSubagents: 'Search scouts',
48
+ phaseToolCalling: 'Using tools…',
49
+ agentTaskStatusPending: 'Pending',
50
+ agentTaskStatusRunning: 'Running',
51
+ agentTaskStatusCompleted: 'Done',
52
+ agentTaskStatusFailed: 'Error',
53
+ commonDelete: 'Delete',
54
+ commonCancel: 'Cancel',
55
+ commonSave: 'Save',
56
+ commonError: 'Error',
57
+ 'tools.web_search': 'Search the web',
58
+ 'tools.web_fetch': 'Read page',
59
+ toolConfirmationPrompt: 'This action needs your confirmation before it runs.',
60
+ toolConfirm: 'Confirm',
61
+ toolDeny: 'Deny',
62
+ };
63
+
64
+ export default en;
@@ -0,0 +1,65 @@
1
+ import type { SvedaMessages } from '../types.js';
2
+
3
+ const ru: SvedaMessages = {
4
+ chatTitle: 'AI Ассистент',
5
+ welcomeMessage: 'Привет! Я ваш AI-ассистент. Чем могу помочь?',
6
+ newChat: 'Новый чат',
7
+ newChatNumbered: 'Новый чат {number}',
8
+ chatHistory: 'История чатов',
9
+ closeChatTab: 'Закрыть вкладку чата',
10
+ chatTabRunning: 'Агент работает',
11
+ chatTabUnread: 'Есть новый ответ',
12
+ quickPromptsTitle: 'Спросите меня о чём угодно',
13
+ confirmDeleteChat: 'Вы уверены, что хотите удалить этот чат?',
14
+ renameChat: 'Переименовать чат',
15
+ renameChatPlaceholder: 'Введите название чата',
16
+ analyzingRequest: 'Анализирую ваш запрос...',
17
+ preparingReply: 'Готовлю ответ…',
18
+ errorSendingMessage: 'Не удалось отправить сообщение. Попробуйте ещё раз.',
19
+ agentFinishedNotice: 'Агент закончил работу',
20
+ maxStepsReachedNotice:
21
+ 'Агент достиг лимита шагов за этот запрос ({limit}). Нажмите «Продолжить», чтобы продолжить в этом чате.',
22
+ maxStepsContinue: 'Продолжить',
23
+ maxStepsContinuePrompt:
24
+ 'Продолжи с того места, где остановился. Кратко резюмируй, что уже выяснил, и продолжай задачу.',
25
+ viewModeFixed: 'Переключить на фиксированный вид',
26
+ viewModeFloating: 'Переключить на плавающий вид',
27
+ immersiveModeEnter: 'Иммерсивный режим',
28
+ immersiveModeExit: 'Выйти из иммерсивного режима',
29
+ toolbarMinimize: 'Свернуть',
30
+ modelSelectPlaceholder: 'Модель',
31
+ thinkingTooltip:
32
+ 'Пошаговое рассуждение перед ответом. Повышает точность, но ответ может занять больше времени.',
33
+ assistantLogoAlt: 'AI ассистент',
34
+ contextWindowUsage: 'Использование контекстного окна',
35
+ contextWindowPercent: 'Использовано: {percent}%',
36
+ chatDocumentsExtracting: 'Извлекаем текст из документов…',
37
+ chatDocumentsHeader: 'Содержимое вложённых документов:',
38
+ chatDocumentTruncatedNotice: '[Текст усечён: достигнут лимит символов для сообщения.]',
39
+ chatDocumentErrorReadFailed: 'Не удалось прочитать файл.',
40
+ chatDocumentErrorEmpty: 'Текст из файла извлечь не удалось.',
41
+ chatDocumentErrorQuotaExceeded:
42
+ '[Файл пропущен: превышен общий лимит объёма извлекаемого текста.]',
43
+ chatDocumentErrorUnknown: 'Не удалось извлечь текст из файла.',
44
+ chatDocumentsExtractFailed: 'Не удалось распознать вложения. Попробуйте ещё раз.',
45
+ chatAttachmentOnlyPlaceholder: 'Документы: {names}',
46
+ agentTasksTitle: 'Параллельные агенты',
47
+ agentTasksSpawnPhase: 'Пакетный запуск агентов',
48
+ phaseSearchSubagents: 'Поисковые скауты',
49
+ phaseToolCalling: 'Вызываю инструменты…',
50
+ agentTaskStatusPending: 'Ожидание',
51
+ agentTaskStatusRunning: 'Выполняется',
52
+ agentTaskStatusCompleted: 'Готово',
53
+ agentTaskStatusFailed: 'Ошибка',
54
+ commonDelete: 'Удалить',
55
+ commonCancel: 'Отмена',
56
+ commonSave: 'Сохранить',
57
+ commonError: 'Ошибка',
58
+ 'tools.web_search': 'Поиск в интернете',
59
+ 'tools.web_fetch': 'Чтение страницы',
60
+ toolConfirmationPrompt: 'Это действие выполнится только после вашего подтверждения.',
61
+ toolConfirm: 'Подтвердить',
62
+ toolDeny: 'Отказать',
63
+ };
64
+
65
+ export default ru;
@@ -0,0 +1 @@
1
+ export type SvedaMessages = Record<string, string>;
package/src/index.ts ADDED
@@ -0,0 +1,84 @@
1
+ export * from './appearance.js';
2
+ export * from './chatStore.js';
3
+ export * from './streaming.js';
4
+ export * from './i18n/catalogs.js';
5
+ export type { SvedaMessages } from './i18n/types.js';
6
+
7
+ export {
8
+ mergeServerChatHistories,
9
+ resolveMergedCurrentChat,
10
+ upsertChatHistoryMessages,
11
+ } from './lib/chatHistoryMerge.js';
12
+ export type { SvedaMergeableChatHistory } from './lib/chatHistoryMerge.js';
13
+
14
+ export { renderMarkdown, injectResourceLinks } from './lib/markdown.js';
15
+ export type { SvedaMarkdownOptions } from './lib/markdown.js';
16
+
17
+ export { hasPendingToolConfirmation } from './lib/toolConfirmation.js';
18
+
19
+ export {
20
+ SVEDA_CHAT_MINIMIZED_STORAGE_KEY,
21
+ readPersistedMinimized,
22
+ readPersistedMinimizedPreference,
23
+ isPersistedSessionChatOpen,
24
+ writePersistedMinimized,
25
+ } from './lib/chatUiStorage.js';
26
+
27
+ export { isChatTitlePlaceholder, deriveProvisionalChatTitle } from './lib/chatTitle.js';
28
+
29
+ export {
30
+ messageHasVisibleAssistantContent,
31
+ messageHasAssistantAnswerText,
32
+ assistantHasActiveTools,
33
+ shouldShowChatPendingIndicator,
34
+ } from './lib/chatMessageVisibility.js';
35
+
36
+ export {
37
+ getUserMessageText,
38
+ getUserMessageAttachmentNames,
39
+ userMessageHasVisibleContent,
40
+ } from './lib/userMessage.js';
41
+ export type { SvedaUserMessageLike } from './lib/userMessage.js';
42
+
43
+ export { humanizeModelId, getSvedaModelDisplayName } from './lib/modelLabels.js';
44
+
45
+ export { finalizeMessagesForDisplay } from './lib/finalizeMessages.js';
46
+ export type { SvedaFinalizableMessage } from './lib/finalizeMessages.js';
47
+
48
+ export { isNewChatPlaceholder, buildChatTabTitleMap } from './lib/chatTabs.js';
49
+ export type { SvedaTabChat } from './lib/chatTabs.js';
50
+
51
+ export {
52
+ SVEDA_CHAT_LAYOUT_MIN_WIDTH,
53
+ SVEDA_CHAT_LAYOUT_MIN_HEIGHT,
54
+ SVEDA_CHAT_LAYOUT_MAX_WIDTH,
55
+ SVEDA_CHAT_LAYOUT_MAX_HEIGHT,
56
+ SVEDA_HISTORY_SIDEBAR_WIDTH,
57
+ resolveEmbedHostSize,
58
+ pointerScreenDelta,
59
+ applyFloatingResize,
60
+ applyFixedLeftResize,
61
+ } from './lib/chatResize.js';
62
+ export type { EmbedHostSize, ChatBoxSize } from './lib/chatResize.js';
63
+
64
+ export { chatComponentI18nKeys } from './lib/chatI18nKeys.js';
65
+
66
+ export {
67
+ isAssistantToolPart,
68
+ buildAssistantMessageSegments,
69
+ getToolNameFromPart,
70
+ parseToolResultOutput,
71
+ getActivityGroupKey,
72
+ getActivityGroupLabel,
73
+ collectResourceLinks,
74
+ enrichMessagesWithResourceLinks,
75
+ } from './lib/assistantMessage.js';
76
+ export type {
77
+ SvedaResourceLink,
78
+ SvedaAssistantMessagePart,
79
+ SvedaLegacyActivity,
80
+ SvedaChatMessageLike,
81
+ AssistantMessageSegment,
82
+ } from './lib/assistantMessage.js';
83
+
84
+ export const SVEDA_CHAT_VERSION = '0.3.1';
@@ -0,0 +1,439 @@
1
+ export interface SvedaResourceLink {
2
+ label: string;
3
+ url: string;
4
+ icon?: string;
5
+ kind?: 'created' | 'reference';
6
+ }
7
+
8
+ export type SvedaAssistantMessagePart = {
9
+ type?: string;
10
+ text?: string;
11
+ state?: string;
12
+ toolName?: string;
13
+ toolCallId?: string;
14
+ target?: string;
15
+ output?: unknown;
16
+ result?: unknown;
17
+ input?: unknown;
18
+ args?: unknown;
19
+ errorText?: string;
20
+ renderHint?: string;
21
+ renderData?: Record<string, unknown>;
22
+ confirmation?: string;
23
+ };
24
+
25
+ export type SvedaLegacyActivity = {
26
+ phase?: string;
27
+ steps?: Array<{
28
+ id: string;
29
+ label: string;
30
+ status: string;
31
+ detail?: string;
32
+ kind?: string;
33
+ activityGroupKey?: string;
34
+ activityGroupLabel?: string;
35
+ display?: { name?: string; link?: string };
36
+ }>;
37
+ };
38
+
39
+ export type SvedaChatMessageLike = {
40
+ id?: string;
41
+ role?: string;
42
+ content?: string;
43
+ parts?: SvedaAssistantMessagePart[];
44
+ reasoningStream?: string;
45
+ activity?: SvedaLegacyActivity;
46
+ toolInvocations?: SvedaAssistantMessagePart[];
47
+ resources?: SvedaResourceLink[];
48
+ streaming?: boolean;
49
+ isError?: boolean;
50
+ attachmentNames?: string[];
51
+ metadata?: {
52
+ attachmentNames?: string[];
53
+ };
54
+ };
55
+
56
+ export type AssistantMessageSegment =
57
+ | {
58
+ kind: 'activity';
59
+ id: string;
60
+ invocations: SvedaAssistantMessagePart[];
61
+ legacyActivity?: SvedaLegacyActivity;
62
+ }
63
+ | {
64
+ kind: 'comment';
65
+ id: string;
66
+ text: string;
67
+ streaming: boolean;
68
+ }
69
+ | {
70
+ kind: 'answer';
71
+ id: string;
72
+ text: string;
73
+ streaming: boolean;
74
+ }
75
+ | {
76
+ kind: 'reasoning';
77
+ id: string;
78
+ text: string;
79
+ streaming: boolean;
80
+ };
81
+
82
+ export function isAssistantToolPart(part: SvedaAssistantMessagePart | null | undefined): boolean {
83
+ if (!part || typeof part.type !== 'string') {
84
+ return false;
85
+ }
86
+ if (part.type === 'tool-call' || part.type === 'tool-result') {
87
+ return false;
88
+ }
89
+ return part.type === 'dynamic-tool' || part.type.startsWith('tool-');
90
+ }
91
+
92
+ function svedaToolPartToInvocation(
93
+ call: SvedaAssistantMessagePart | undefined,
94
+ result: SvedaAssistantMessagePart | undefined
95
+ ): SvedaAssistantMessagePart {
96
+ return {
97
+ type: 'dynamic-tool',
98
+ toolCallId: call?.toolCallId ?? result?.toolCallId ?? '',
99
+ toolName: call?.toolName ?? result?.toolName ?? '',
100
+ input: call?.input,
101
+ output: result?.output,
102
+ renderHint: result?.renderHint,
103
+ renderData: result?.renderData,
104
+ confirmation: call?.confirmation,
105
+ state: result ? 'result' : 'call',
106
+ };
107
+ }
108
+
109
+ export function buildAssistantMessageSegments(
110
+ message: SvedaChatMessageLike
111
+ ): AssistantMessageSegment[] {
112
+ const parts = Array.isArray(message.parts) ? message.parts : [];
113
+
114
+ if (parts.length === 0) {
115
+ const segments: AssistantMessageSegment[] = [];
116
+
117
+ const legacyInvocations = Array.isArray(message.toolInvocations) ? message.toolInvocations : [];
118
+ if (legacyInvocations.length > 0) {
119
+ segments.push({
120
+ kind: 'activity',
121
+ id: 'activity-legacy-tools',
122
+ invocations: legacyInvocations,
123
+ });
124
+ } else if (message.activity?.steps?.length) {
125
+ segments.push({
126
+ kind: 'activity',
127
+ id: 'activity-legacy',
128
+ invocations: [],
129
+ legacyActivity: message.activity,
130
+ });
131
+ }
132
+
133
+ if (message.reasoningStream?.trim()) {
134
+ segments.push({
135
+ kind: 'reasoning',
136
+ id: 'reasoning-legacy',
137
+ text: message.reasoningStream.trim(),
138
+ streaming: false,
139
+ });
140
+ }
141
+
142
+ if (message.content?.trim()) {
143
+ segments.push({
144
+ kind: 'answer',
145
+ id: 'answer-legacy',
146
+ text: message.content.trim(),
147
+ streaming: false,
148
+ });
149
+ }
150
+
151
+ return segments;
152
+ }
153
+
154
+ const resultsByCallId = new Map<string, SvedaAssistantMessagePart>();
155
+ for (const part of parts) {
156
+ if (part.type === 'tool-result' && part.toolCallId) {
157
+ resultsByCallId.set(part.toolCallId, part);
158
+ }
159
+ }
160
+ const consumedResultIds = new Set<string>();
161
+
162
+ const segments: AssistantMessageSegment[] = [];
163
+ let toolBuffer: SvedaAssistantMessagePart[] = [];
164
+ const textBuffer: Array<{ part: SvedaAssistantMessagePart; index: number }> = [];
165
+
166
+ const lastTextPartIndex = parts.reduce((lastIndex, part, index) => {
167
+ if (part.type === 'text' && part.text?.trim()) {
168
+ return index;
169
+ }
170
+ return lastIndex;
171
+ }, -1);
172
+
173
+ const flushTools = () => {
174
+ if (toolBuffer.length === 0) {
175
+ return;
176
+ }
177
+ segments.push({
178
+ kind: 'activity',
179
+ id: `activity-${segments.length}`,
180
+ invocations: [...toolBuffer],
181
+ });
182
+ toolBuffer = [];
183
+ };
184
+
185
+ const flushText = () => {
186
+ const buffered = textBuffer.filter(
187
+ entry => entry.part.type === 'text' && entry.part.text?.trim()
188
+ );
189
+ textBuffer.length = 0;
190
+ if (buffered.length === 0) {
191
+ return;
192
+ }
193
+
194
+ const text = buffered.map(entry => String(entry.part.text).trim()).join('\n\n');
195
+ const streaming = buffered.some(entry => entry.part.state === 'streaming');
196
+ const maxTextIndex = Math.max(...buffered.map(entry => entry.index));
197
+ const isAnswer = lastTextPartIndex >= 0 && maxTextIndex === lastTextPartIndex;
198
+
199
+ segments.push({
200
+ kind: isAnswer ? 'answer' : 'comment',
201
+ id: `text-${segments.length}`,
202
+ text,
203
+ streaming,
204
+ });
205
+ };
206
+
207
+ for (let index = 0; index < parts.length; index += 1) {
208
+ const part = parts[index];
209
+
210
+ if (part.type === 'tool-call') {
211
+ if (textBuffer.length > 0) {
212
+ flushText();
213
+ }
214
+ const result = part.toolCallId ? resultsByCallId.get(part.toolCallId) : undefined;
215
+ if (result && part.toolCallId) {
216
+ consumedResultIds.add(part.toolCallId);
217
+ }
218
+ toolBuffer.push(svedaToolPartToInvocation(part, result));
219
+ continue;
220
+ }
221
+
222
+ if (part.type === 'tool-result') {
223
+ if (part.toolCallId && consumedResultIds.has(part.toolCallId)) {
224
+ continue;
225
+ }
226
+ if (textBuffer.length > 0) {
227
+ flushText();
228
+ }
229
+ toolBuffer.push(svedaToolPartToInvocation(undefined, part));
230
+ continue;
231
+ }
232
+
233
+ if (isAssistantToolPart(part)) {
234
+ if (textBuffer.length > 0) {
235
+ flushText();
236
+ }
237
+ toolBuffer.push(part);
238
+ continue;
239
+ }
240
+
241
+ if (part.type === 'reasoning' && part.text?.trim()) {
242
+ flushTools();
243
+ if (textBuffer.length > 0) {
244
+ flushText();
245
+ }
246
+ segments.push({
247
+ kind: 'reasoning',
248
+ id: `reasoning-${segments.length}`,
249
+ text: part.text.trim(),
250
+ streaming: part.state === 'streaming',
251
+ });
252
+ continue;
253
+ }
254
+
255
+ if (part.type === 'text') {
256
+ if (toolBuffer.length > 0) {
257
+ flushTools();
258
+ }
259
+ textBuffer.push({ part, index });
260
+ continue;
261
+ }
262
+ }
263
+
264
+ flushText();
265
+ flushTools();
266
+
267
+ let hasAnswer = segments.some(segment => segment.kind === 'answer');
268
+ if (!hasAnswer) {
269
+ for (let i = segments.length - 1; i >= 0; i -= 1) {
270
+ if (segments[i].kind === 'comment') {
271
+ segments[i] = { ...segments[i], kind: 'answer' } as AssistantMessageSegment;
272
+ hasAnswer = true;
273
+ break;
274
+ }
275
+ }
276
+ }
277
+
278
+ if (!hasAnswer && message.content?.trim()) {
279
+ segments.push({
280
+ kind: 'answer',
281
+ id: 'answer-content-fallback',
282
+ text: message.content.trim(),
283
+ streaming: false,
284
+ });
285
+ }
286
+
287
+ return segments;
288
+ }
289
+
290
+ const READ_ONLY_TOOL_PREFIXES = ['get_', 'list_', 'search_', 'read_', 'web_'];
291
+
292
+ export function getToolNameFromPart(part: { toolName?: string; type?: string }): string {
293
+ if (part.toolName) {
294
+ return part.toolName;
295
+ }
296
+ if (
297
+ typeof part.type === 'string' &&
298
+ part.type.startsWith('tool-') &&
299
+ part.type !== 'tool-call' &&
300
+ part.type !== 'tool-result'
301
+ ) {
302
+ return part.type.slice('tool-'.length);
303
+ }
304
+ return '';
305
+ }
306
+
307
+ export function parseToolResultOutput(output: unknown): Record<string, unknown> | null {
308
+ if (output === undefined || output === null) {
309
+ return null;
310
+ }
311
+ if (typeof output === 'object') {
312
+ return output as Record<string, unknown>;
313
+ }
314
+ if (typeof output !== 'string' || output.trim() === '') {
315
+ return null;
316
+ }
317
+ try {
318
+ const parsed = JSON.parse(output) as unknown;
319
+ return typeof parsed === 'object' && parsed !== null
320
+ ? (parsed as Record<string, unknown>)
321
+ : null;
322
+ } catch {
323
+ return null;
324
+ }
325
+ }
326
+
327
+ export function getActivityGroupKey(toolName: string): string {
328
+ if (!toolName) {
329
+ return '';
330
+ }
331
+ if (READ_ONLY_TOOL_PREFIXES.some(prefix => toolName.startsWith(prefix))) {
332
+ return `reader:${toolName}`;
333
+ }
334
+ return '';
335
+ }
336
+
337
+ export function getActivityGroupLabel(_toolName: string, translatedToolName: string): string {
338
+ return translatedToolName;
339
+ }
340
+
341
+ function normalizeResourceLink(raw: unknown): SvedaResourceLink | null {
342
+ if (!raw || typeof raw !== 'object') {
343
+ return null;
344
+ }
345
+ const record = raw as Record<string, unknown>;
346
+ const label = record.label ?? record.name;
347
+ const url = record.url ?? record.link;
348
+ if (typeof label !== 'string' || label.trim() === '') {
349
+ return null;
350
+ }
351
+ if (typeof url !== 'string' || url.trim() === '') {
352
+ return null;
353
+ }
354
+ const icon = typeof record.icon === 'string' && record.icon.trim() !== '' ? record.icon.trim() : undefined;
355
+ return { label: label.trim(), url: url.trim(), ...(icon ? { icon } : {}) };
356
+ }
357
+
358
+ function pushResourceLink(resources: SvedaResourceLink[], resource: SvedaResourceLink): void {
359
+ if (!resource.label || !resource.url) {
360
+ return;
361
+ }
362
+ if (resources.some(existing => existing.url === resource.url)) {
363
+ return;
364
+ }
365
+ resources.push(resource);
366
+ }
367
+
368
+ export function collectResourceLinks(message: SvedaChatMessageLike): SvedaResourceLink[] {
369
+ const collected: SvedaResourceLink[] = [];
370
+ const parts = [
371
+ ...(Array.isArray(message.toolInvocations) ? message.toolInvocations : []),
372
+ ...(Array.isArray(message.parts) ? message.parts : []),
373
+ ];
374
+
375
+ for (const part of parts) {
376
+ if (!part || typeof part !== 'object') {
377
+ continue;
378
+ }
379
+
380
+ if (part.type === 'tool-result' && part.renderHint === 'resource_links') {
381
+ const links = part.renderData?.links;
382
+ if (Array.isArray(links)) {
383
+ for (const raw of links) {
384
+ const link = normalizeResourceLink(raw);
385
+ if (link) {
386
+ pushResourceLink(collected, { ...link, kind: link.kind ?? 'reference' });
387
+ }
388
+ }
389
+ }
390
+ continue;
391
+ }
392
+
393
+ if (part.type === 'tool-result' || isAssistantToolPart(part)) {
394
+ const resultData = parseToolResultOutput(part.output !== undefined ? part.output : part.result);
395
+ if (!resultData || resultData.success === false) {
396
+ continue;
397
+ }
398
+
399
+ const display = resultData.display as { name?: unknown; link?: unknown } | undefined;
400
+ if (display?.name && display?.link) {
401
+ pushResourceLink(collected, {
402
+ label: String(display.name),
403
+ url: String(display.link),
404
+ kind: 'created',
405
+ });
406
+ }
407
+
408
+ const links = resultData.links;
409
+ if (Array.isArray(links)) {
410
+ for (const raw of links) {
411
+ const link = normalizeResourceLink(raw);
412
+ if (link) {
413
+ pushResourceLink(collected, { ...link, kind: link.kind ?? 'reference' });
414
+ }
415
+ }
416
+ }
417
+ }
418
+ }
419
+
420
+ return collected;
421
+ }
422
+
423
+ export function enrichMessagesWithResourceLinks<
424
+ T extends { role?: string; resources?: SvedaResourceLink[] },
425
+ >(messages: T[]): T[] {
426
+ return messages.map(message => {
427
+ if (message.role !== 'assistant') {
428
+ return message;
429
+ }
430
+ const resources = collectResourceLinks(message);
431
+ if (resources.length === 0) {
432
+ return message;
433
+ }
434
+ return {
435
+ ...message,
436
+ resources,
437
+ };
438
+ });
439
+ }