@ykurilov/agent-chat-web-tools 0.87.10 → 0.87.12

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,20 @@
1
1
  # @ykurilov/agent-chat-web-tools
2
2
 
3
+ ## 0.87.12
4
+
5
+ ### Patch Changes
6
+
7
+ - @ykurilov/agent-chat-core@0.87.12
8
+
9
+ ## 0.87.11
10
+
11
+ ### Patch Changes
12
+
13
+ - eb679ed: DeepSeek Search/Fetch как второй поставщик веб-поиска и Markdown-чтения. Готовая createDeepSeekWebTools принимает ключ, настройки прокси и spending.storage; имена web_search/read_page и подписи /labels сохраняются. Учёт только полученных непустых ответов, по умолчанию $0.00075 за вызов; повторы HTTP408/429/5xx ограничены общим сроком и отменяются по «Стоп». Firecrawl и скриншоты прежние.
14
+
15
+ Как обновить приложение: обновить пакеты SDK одной версией. Для DeepSeek использовать createDeepSeekWebTools({apiKey: process.env.DEEPSEEK_API_KEY!, spending: {storage}}) в прежнем agent.tools. Дополнительно baseUrl/headers для прокси; webToolsInstructions и withWebToolTitles не меняются. Ограничения и цены - README веб-инструментов, раздел DeepSeek. Непереключённым приложениям менять код не требуется. Нет миграций базы и протокола.
16
+ - @ykurilov/agent-chat-core@0.87.11
17
+
3
18
  ## 0.87.10
4
19
 
5
20
  ### Patch Changes
package/README.md CHANGED
@@ -28,6 +28,31 @@ createChatHandler({
28
28
  });
29
29
  ```
30
30
 
31
+ ## DeepSeek: поиск и чтение
32
+
33
+ С 0.87.11 второй поставщик включается одной фабрикой; модель агента может быть любой:
34
+
35
+ ```ts
36
+ import { createDeepSeekWebTools, webToolsInstructions } from "@ykurilov/agent-chat-web-tools";
37
+ const webTools = createDeepSeekWebTools({
38
+ apiKey: process.env.DEEPSEEK_API_KEY!,
39
+ baseUrl: process.env.DEEPSEEK_TOOLS_BASE_URL,
40
+ spending: { storage },
41
+ });
42
+ // agent.tools: model => ({ ...appTools, ...webTools(model) })
43
+ // К instructions агента добавляется webToolsInstructions, как с Firecrawl.
44
+ ```
45
+
46
+ `baseUrl` - origin DeepSeek или прокси с префиксом пути, с завершающим `/v1` или без него; по умолчанию `https://api.deepseek.com`. Дополнительные `headers` подходят для токена прокси. Ключ остаётся на сервере. Это отдельные Search/Fetch HTTP API, а не поиск внутри Chat Completions. Подписи `/labels` и имена `web_search`/`read_page` прежние. У DeepSeek нет скриншотов; Firecrawl и его настройка продолжают работать.
47
+
48
+ Поиск принимает 1–128 Unicode-символов (пустой запрос запрещён); `searchResultLimit` - 1–50, по умолчанию 5. Возвращаются ссылки, snippet, summary и дата при её наличии. `needContent: true` дополнительно передаёт содержимое найденных страниц, максимум 4000 знаков на результат (`searchContentCharacterLimit`, 0–100000). Лимит чтения `pageCharacterLimit` по умолчанию 30000. Запросы длиннее ограничения отклоняются до сети, без скрытого усечения смысла. Низкоуровневые `createDeepSeekServices` и типы доступны также через `/deepseek`; для автоматического учёта расходов используйте готовую фабрику выше.
49
+
50
+ Повторы: только HTTP 408, 429 и 5xx, по умолчанию два (`maxRetries`, 0–10). Backoff начинается с 500мс (`retryDelayMs`); учитывается `Retry-After` в секундах или HTTP-дате. Экспоненциальный backoff ограничен 30с, но срок поставщика не сокращается: если он длиннее общего бюджета, вызов завершится таймаутом без преждевременного повтора. Общий `timeoutMs` включает повторы и ожидания: по умолчанию 30с поиска / 60с чтения. Остальные 4xx, ошибки JSON и сетевые обрывы автоматически не повторяются. «Стоп» прерывает запрос или ожидание следующей попытки.
51
+
52
+ `spending.storage` пишет расходы в то же хранилище, которое читает пакет лимитов: `source=web_tools`, `providerId=deepseek`, инструмент в `modelId`, owner/chat из хода. Цена по умолчанию $0.00075 за непустой поиск или страницу с содержимым. `spending.pricePerCallUsd` позволяет задать цены `web_search` и `read_page`, включая 0 для собственного тарифа. Без `spending` учёта нет. Пустые ответы и неуспешные попытки не учитываются; после успешного повтора записывается один вызов. Признак оплаты проверяется в HTTP200 до фильтрации ссылок, проверки полей результата и усечения текста: непустой results либо строка content с текстом. Поэтому некорректные остальные поля не теряют расход уже полученного результата. При обрыве, до которого клиент не получил результат, подтверждённого расхода нет: это учёт полученных ответов, а не сверка счёта поставщика. Сбой записи расхода сообщается через `logError` и не повторяет платный запрос.
53
+
54
+ Контракт и актуальные тарифы: [официальное руководство DeepSeek](https://api-docs.deepseek.com/guides/search/), [Search](https://api-docs.deepseek.com/api/search/), [Fetch](https://api-docs.deepseek.com/api/fetch/). На 28.10.2026 указаны отдельные лимиты аккаунта 100 Search/с и 25 Fetch/с; у Fetch есть также лимит домена. Это не локальный rate limiter SDK. Тарифы/акции проверяйте у поставщика.
55
+
31
56
  В браузерной части подписи «Поиск в интернете», «Чтение страницы», «Скриншот страницы» подключаются отдельно и
32
57
  не тянут код сервисов:
33
58
 
@@ -86,11 +111,11 @@ agent: { tools: (model) => ({ ...appTools, ...personLink(model) }) };
86
111
 
87
112
  ## Что проверяется и чего нет
88
113
 
89
- **Чтение страницы и снимок (ходит Firecrawl, не мы).** Мы проверяем только адрес до вызова сервиса: схема `http`/`https`,
114
+ **Чтение страницы и снимок (ходит поставщик, не мы).** Мы проверяем только адрес до вызова сервиса: схема `http`/`https`,
90
115
  нет логина и пароля, не `localhost`, не имя без точки, не `.local`/`.internal`, не частный и не служебный IP. Сюда входят
91
116
  IPv4 внутри IPv6 (`::ffff:`, `::/96`, `64:ff9b::/96`, 6to4), `fc00::/7`, `fe80::/10`, `fec0::/10`, `100.64.0.0/10`,
92
117
  `192.0.0.0/24`, `198.18.0.0/15`, документационные и многоадресные диапазоны. **Имя мы по DNS не разрешаем** и переходы
93
- на стороне Firecrawl не контролируем: защита от обращения во внутреннюю сеть через имя или переход — на стороне сервиса.
118
+ на стороне Firecrawl/DeepSeek не контролируем: защита от обращения во внутреннюю сеть через имя или переход — на стороне сервиса.
94
119
 
95
120
  **Скачивание снимка (ходит наш сервер).** Проверок больше:
96
121
  - адрес проходит ту же проверку, а имя ещё разрешается по DNS; если хоть один адрес частный или имя не разрешилось — отказ;
@@ -0,0 +1,509 @@
1
+ import {
2
+ dnsHostResolver,
3
+ sharedPinnedFetch
4
+ } from "./chunk-D3ROOU7X.js";
5
+ import {
6
+ WebToolError,
7
+ assertPublicWebAddress,
8
+ assertResolvesPublic,
9
+ isHttpAddress,
10
+ serviceFailure
11
+ } from "./chunk-WWNNON6D.js";
12
+
13
+ // src/deepseek/deepseek-services.ts
14
+ import { z as z4 } from "zod";
15
+ import { cutAtCharBoundary as cutAtCharBoundary2 } from "@ykurilov/agent-chat-core";
16
+
17
+ // src/spending.ts
18
+ function createWebUsageRecorder(spending) {
19
+ const now = spending.now ?? (() => Date.now());
20
+ const providerId = spending.providerId ?? "firecrawl";
21
+ async function record(name, costUsd, ownerId, chatId) {
22
+ try {
23
+ await spending.storage.insertUsageRecord({
24
+ id: crypto.randomUUID(),
25
+ ownerId,
26
+ chatId,
27
+ messageId: null,
28
+ source: "web_tools",
29
+ modelId: name,
30
+ providerId,
31
+ inputTokens: 0,
32
+ cachedInputTokens: 0,
33
+ cacheWriteTokens: 0,
34
+ outputTokens: 0,
35
+ reasoningTokens: 0,
36
+ costUsd,
37
+ createdAt: new Date(now()).toISOString()
38
+ });
39
+ } catch (error) {
40
+ spending.logError?.(`\u0412\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B: \u043D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u043F\u0438\u0441\u0430\u0442\u044C \u0440\u0430\u0441\u0445\u043E\u0434 ${name}: ${error instanceof Error ? error.message : String(error)}`);
41
+ }
42
+ }
43
+ return record;
44
+ }
45
+
46
+ // src/create-web-tools.ts
47
+ import { modelMaySeeToolResultImages } from "@ykurilov/agent-chat-core";
48
+
49
+ // src/tools/page-screenshot.ts
50
+ import { toolImageFallbackText } from "@ykurilov/agent-chat-core";
51
+ import { tool } from "ai";
52
+ import { z } from "zod";
53
+
54
+ // src/image-cache.ts
55
+ function createImageCache({ maxEntries, maxBytes, ttlMs, now = Date.now }) {
56
+ const entries = /* @__PURE__ */ new Map();
57
+ let totalBytes = 0;
58
+ function remove(key) {
59
+ const entry = entries.get(key);
60
+ if (!entry) return;
61
+ totalBytes -= entry.image.bytes.byteLength;
62
+ entries.delete(key);
63
+ }
64
+ return {
65
+ get(key) {
66
+ const entry = entries.get(key);
67
+ if (!entry) return void 0;
68
+ if (entry.expiresAt <= now()) {
69
+ remove(key);
70
+ return void 0;
71
+ }
72
+ entries.delete(key);
73
+ entries.set(key, entry);
74
+ return entry.image;
75
+ },
76
+ set(key, image) {
77
+ remove(key);
78
+ if (image.bytes.byteLength > maxBytes) return;
79
+ entries.set(key, { image, expiresAt: now() + ttlMs });
80
+ totalBytes += image.bytes.byteLength;
81
+ for (const oldest of entries.keys()) {
82
+ if (entries.size <= maxEntries && totalBytes <= maxBytes) break;
83
+ remove(oldest);
84
+ }
85
+ }
86
+ };
87
+ }
88
+
89
+ // src/screenshot-download.ts
90
+ var screenshotDownloadTimeoutMs = 2e4;
91
+ var screenshotMaxBytes = 5 * 1024 * 1024;
92
+ var screenshotMaxRedirects = 3;
93
+ async function downloadScreenshot(address, fetchImplementation, { resolveHost, pinned = false }) {
94
+ const controller = new AbortController();
95
+ const timer = setTimeout(() => controller.abort(), screenshotDownloadTimeoutMs);
96
+ try {
97
+ let current = address;
98
+ for (let redirects = 0; ; redirects++) {
99
+ if (redirects === 0 && new URL(current).protocol === "data:") return await readImage(await fetchImplementation(current, { signal: controller.signal }));
100
+ const url = assertPublicWebAddress(current);
101
+ if (!pinned) await assertResolvesPublic(url, resolveHost);
102
+ const response = await fetchImplementation(current, { signal: controller.signal, redirect: "manual" });
103
+ if (response.status < 300 || response.status >= 400) return await readImage(response);
104
+ const location = response.headers.get("location");
105
+ await response.body?.cancel();
106
+ if (!location || redirects >= screenshotMaxRedirects) return void 0;
107
+ current = new URL(location, current).href;
108
+ }
109
+ } catch {
110
+ return void 0;
111
+ } finally {
112
+ clearTimeout(timer);
113
+ }
114
+ }
115
+ async function readImage(response) {
116
+ if (!response.ok) return void 0;
117
+ const mediaType = (response.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
118
+ if (!mediaType.startsWith("image/")) return void 0;
119
+ if (Number(response.headers.get("content-length") ?? 0) > screenshotMaxBytes) return void 0;
120
+ const bytes = await readLimited(response, screenshotMaxBytes);
121
+ return bytes && { bytes, mediaType };
122
+ }
123
+ async function readLimited(response, limit) {
124
+ const reader = response.body?.getReader();
125
+ if (!reader) return void 0;
126
+ const chunks = [];
127
+ let total = 0;
128
+ for (; ; ) {
129
+ const { done, value } = await reader.read();
130
+ if (done) break;
131
+ total += value.byteLength;
132
+ if (total > limit) {
133
+ await reader.cancel();
134
+ return void 0;
135
+ }
136
+ chunks.push(value);
137
+ }
138
+ const bytes = new Uint8Array(total);
139
+ let offset = 0;
140
+ for (const chunk of chunks) {
141
+ bytes.set(chunk, offset);
142
+ offset += chunk.byteLength;
143
+ }
144
+ return bytes;
145
+ }
146
+
147
+ // src/result-text.ts
148
+ import { cutAtCharBoundary } from "@ykurilov/agent-chat-core";
149
+ function formatSearchResults(query, hits) {
150
+ const safeHits = hits.filter((hit) => isHttpAddress(hit.url));
151
+ if (safeHits.length === 0) return `\u041D\u0438\u0447\u0435\u0433\u043E \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u043E \u043F\u043E \u0437\u0430\u043F\u0440\u043E\u0441\u0443 \xAB${query}\xBB.`;
152
+ return safeHits.map((hit, index) => {
153
+ const title = hit.title.replace(/\s+/g, " ").trim() || hit.url;
154
+ const link = `${index + 1}. [${title.replace(/[[\]]/g, "\\$&")}](${hit.url.replace(/\(/g, "%28").replace(/\)/g, "%29")})`;
155
+ const snippet = hit.snippet.trim();
156
+ return [snippet ? `${link}
157
+ ${snippet}` : link, hit.date ? ` \u0414\u0430\u0442\u0430: ${hit.date}` : "", hit.summary?.trim() ? ` ${hit.summary.trim()}` : "", hit.content?.trim() ? `
158
+ ${hit.content.trim()}` : ""].filter(Boolean).join("\n");
159
+ }).join("\n");
160
+ }
161
+ function formatPage(page, characterLimit) {
162
+ const header = `# ${page.title.trim() || page.url}
163
+ \u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A: ${page.url}
164
+
165
+ `;
166
+ const text = page.markdown.trim();
167
+ if (!text) return `${header}\u041D\u0430 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0435 \u043D\u0435\u0442 \u0442\u0435\u043A\u0441\u0442\u0430.`;
168
+ if (text.length <= characterLimit) return header + text;
169
+ const paragraphBreak = text.lastIndexOf("\n\n", characterLimit);
170
+ const shown = cutAtCharBoundary(text, paragraphBreak > 0 ? paragraphBreak : characterLimit).trimEnd();
171
+ return `${header}${shown}
172
+
173
+ [\u0422\u0435\u043A\u0441\u0442 \u043E\u0431\u0440\u0435\u0437\u0430\u043D: \u043F\u043E\u043A\u0430\u0437\u0430\u043D\u043E ${shown.length} \u0438\u0437 ${text.length} \u0437\u043D\u0430\u043A\u043E\u0432]`;
174
+ }
175
+
176
+ // src/service-call.ts
177
+ async function callService(signal, call) {
178
+ try {
179
+ return await call();
180
+ } catch (error) {
181
+ if (error instanceof WebToolError || signal?.aborted || error instanceof Error && error.name === "AbortError") throw error;
182
+ throw serviceFailure("unavailable");
183
+ }
184
+ }
185
+
186
+ // src/tools/page-screenshot.ts
187
+ function isScreenshotRecord(value) {
188
+ const record = value;
189
+ return typeof record?.pageUrl === "string" && typeof record.screenshotUrl === "string";
190
+ }
191
+ var screenshotCacheLimits = { maxEntries: 20, maxBytes: 20 * 1024 * 1024, ttlMs: 60 * 60 * 1e3 };
192
+ function unavailable(pageUrl, text) {
193
+ const note = `\u0421\u043D\u0438\u043C\u043E\u043A \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B ${pageUrl} \u0431\u043E\u043B\u044C\u0448\u0435 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D: \u0441\u0441\u044B\u043B\u043A\u0430 \u043D\u0430 \u043D\u0435\u0433\u043E \u0443\u0441\u0442\u0430\u0440\u0435\u043B\u0430 \u0438\u043B\u0438 \u043D\u0435 \u043E\u0442\u043A\u0440\u044B\u043B\u0430\u0441\u044C.`;
194
+ return { type: "text", value: text ? `${note} \u0422\u0435\u043A\u0441\u0442 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B:
195
+
196
+ ${text}` : note };
197
+ }
198
+ function pageScreenshotTool(screenshots, download, characterLimit) {
199
+ const cache = createImageCache(screenshotCacheLimits);
200
+ return tool({
201
+ // Чужой текст из интернета: чат с ним не запускает живые демонстрации. Модели пометка не уходит — кэш цел.
202
+ metadata: { externalContent: true },
203
+ description: "\u0414\u0435\u043B\u0430\u0435\u0442 \u0441\u043D\u0438\u043C\u043E\u043A \u044D\u043A\u0440\u0430\u043D\u0430 \u0432\u0435\u0431-\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B \u0438 \u043F\u043E\u043A\u0430\u0437\u044B\u0432\u0430\u0435\u0442 \u0435\u0433\u043E \u0442\u0435\u0431\u0435 \u043A\u0430\u043A \u043A\u0430\u0440\u0442\u0438\u043D\u043A\u0443. \u0418\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439, \u043A\u043E\u0433\u0434\u0430 \u0432\u0430\u0436\u0435\u043D \u0432\u043D\u0435\u0448\u043D\u0438\u0439 \u0432\u0438\u0434 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B: \u0432\u0451\u0440\u0441\u0442\u043A\u0430, \u0433\u0440\u0430\u0444\u0438\u043A, \u043E\u0444\u043E\u0440\u043C\u043B\u0435\u043D\u0438\u0435. \u0414\u043B\u044F \u0447\u0442\u0435\u043D\u0438\u044F \u0442\u0435\u043A\u0441\u0442\u0430 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439 read_page.",
204
+ inputSchema: z.object({
205
+ url: z.string().describe("\u041F\u043E\u043B\u043D\u044B\u0439 \u0430\u0434\u0440\u0435\u0441 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B, \u043D\u0430\u0447\u0438\u043D\u0430\u044E\u0449\u0438\u0439\u0441\u044F \u0441 http:// \u0438\u043B\u0438 https://.")
206
+ }),
207
+ execute: async ({ url }, { abortSignal }) => {
208
+ const address = assertPublicWebAddress(url.trim());
209
+ const shot = await callService(
210
+ abortSignal,
211
+ () => screenshots.takeScreenshot(address.href, { ...abortSignal && { signal: abortSignal } })
212
+ );
213
+ return { pageUrl: address.href, screenshotUrl: shot.imageUrl, ...shot.page && { text: formatPage(shot.page, characterLimit) } };
214
+ },
215
+ toModelOutput: async ({ output }) => {
216
+ if (!isScreenshotRecord(output)) return unavailable("(\u0430\u0434\u0440\u0435\u0441 \u043D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u0435\u043D)");
217
+ const image = cache.get(output.screenshotUrl) ?? await downloadScreenshot(output.screenshotUrl, download.fetch, download);
218
+ if (!image) return unavailable(output.pageUrl, output.text);
219
+ cache.set(output.screenshotUrl, image);
220
+ return {
221
+ type: "content",
222
+ value: [
223
+ { type: "text", text: `\u0421\u043D\u0438\u043C\u043E\u043A \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B ${output.pageUrl}` },
224
+ { type: "file", data: { type: "data", data: image.bytes }, mediaType: image.mediaType },
225
+ ...output.text ? [toolImageFallbackText(output.text)] : []
226
+ ]
227
+ };
228
+ }
229
+ });
230
+ }
231
+
232
+ // src/tools/read-page.ts
233
+ import { tool as tool2 } from "ai";
234
+ import { z as z2 } from "zod";
235
+ function readPageTool(reader, characterLimit) {
236
+ return tool2({
237
+ // Чужой текст из интернета: чат с ним не запускает живые демонстрации. Модели пометка не уходит — кэш цел.
238
+ metadata: { externalContent: true },
239
+ description: "\u0427\u0438\u0442\u0430\u0435\u0442 \u0432\u0435\u0431-\u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0443 \u0438 \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0435\u0451 \u043E\u0441\u043D\u043E\u0432\u043D\u043E\u0439 \u0442\u0435\u043A\u0441\u0442 \u0432 Markdown \u0432\u043C\u0435\u0441\u0442\u0435 \u0441 \u0430\u0434\u0440\u0435\u0441\u043E\u043C-\u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u043E\u043C. \u0410\u0434\u0440\u0435\u0441 \u0431\u0435\u0440\u0438 \u0438\u0437 \u0440\u0435\u0437\u0443\u043B\u044C\u0442\u0430\u0442\u043E\u0432 \u043F\u043E\u0438\u0441\u043A\u0430 \u0438\u043B\u0438 \u0438\u0437 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F \u0447\u0435\u043B\u043E\u0432\u0435\u043A\u0430.",
240
+ inputSchema: z2.object({
241
+ url: z2.string().describe("\u041F\u043E\u043B\u043D\u044B\u0439 \u0430\u0434\u0440\u0435\u0441 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B, \u043D\u0430\u0447\u0438\u043D\u0430\u044E\u0449\u0438\u0439\u0441\u044F \u0441 http:// \u0438\u043B\u0438 https://.")
242
+ }),
243
+ execute: async ({ url }, { abortSignal }) => {
244
+ const address = assertPublicWebAddress(url.trim());
245
+ const page = await callService(
246
+ abortSignal,
247
+ () => reader.readPage(address.href, { ...abortSignal && { signal: abortSignal } })
248
+ );
249
+ return formatPage(page, characterLimit);
250
+ }
251
+ });
252
+ }
253
+
254
+ // src/tools/web-search.ts
255
+ import { tool as tool3 } from "ai";
256
+ import { z as z3 } from "zod";
257
+ function webSearchTool(search, resultLimit) {
258
+ return tool3({
259
+ // Чужой текст из интернета: чат с ним не запускает живые демонстрации. Модели пометка не уходит — кэш цел.
260
+ metadata: { externalContent: true },
261
+ description: "\u0418\u0449\u0435\u0442 \u0432 \u0438\u043D\u0442\u0435\u0440\u043D\u0435\u0442\u0435 \u0441\u0432\u0435\u0436\u0438\u0435 \u0441\u0432\u0435\u0434\u0435\u043D\u0438\u044F \u0438 \u0432\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0441\u043F\u0438\u0441\u043E\u043A \u0441\u0442\u0440\u0430\u043D\u0438\u0446: \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A-\u0441\u0441\u044B\u043B\u043A\u0430 \u0438 \u043A\u043E\u0440\u043E\u0442\u043A\u0430\u044F \u0432\u044B\u0434\u0435\u0440\u0436\u043A\u0430. \u0418\u0441\u043F\u043E\u043B\u044C\u0437\u0443\u0439, \u043A\u043E\u0433\u0434\u0430 \u043D\u0443\u0436\u043D\u044B \u0444\u0430\u043A\u0442\u044B, \u043A\u043E\u0442\u043E\u0440\u044B\u0445 \u043D\u0435\u0442 \u0432 \u0440\u0430\u0437\u0433\u043E\u0432\u043E\u0440\u0435 \u0438\u043B\u0438 \u043A\u043E\u0442\u043E\u0440\u044B\u0435 \u043C\u043E\u0433\u043B\u0438 \u0443\u0441\u0442\u0430\u0440\u0435\u0442\u044C. \u0427\u0442\u043E\u0431\u044B \u0443\u0437\u043D\u0430\u0442\u044C \u043F\u043E\u0434\u0440\u043E\u0431\u043D\u043E\u0441\u0442\u0438, \u043F\u0440\u043E\u0447\u0438\u0442\u0430\u0439 \u043F\u043E\u0434\u0445\u043E\u0434\u044F\u0449\u0443\u044E \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u0443 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u043C read_page.",
262
+ inputSchema: z3.object({
263
+ query: z3.string().describe("\u041F\u043E\u0438\u0441\u043A\u043E\u0432\u044B\u0439 \u0437\u0430\u043F\u0440\u043E\u0441 \u0441\u0432\u043E\u0438\u043C\u0438 \u0441\u043B\u043E\u0432\u0430\u043C\u0438, \u043B\u0443\u0447\u0448\u0435 \u043D\u0430 \u044F\u0437\u044B\u043A\u0435 \u0432\u043E\u043F\u0440\u043E\u0441\u0430.")
264
+ }),
265
+ execute: async ({ query }, { abortSignal }) => {
266
+ const trimmed = query.trim();
267
+ if (!trimmed) throw new WebToolError("bad_query", "\u041F\u0443\u0441\u0442\u043E\u0439 \u043F\u043E\u0438\u0441\u043A\u043E\u0432\u044B\u0439 \u0437\u0430\u043F\u0440\u043E\u0441.");
268
+ const hits = await callService(
269
+ abortSignal,
270
+ () => search.search(trimmed, { limit: resultLimit, ...abortSignal && { signal: abortSignal } })
271
+ );
272
+ return formatSearchResults(trimmed, hits);
273
+ }
274
+ });
275
+ }
276
+
277
+ // src/create-web-tools.ts
278
+ var defaultSearchResultLimit = 5;
279
+ var defaultPageCharacterLimit = 3e4;
280
+ function createWebTools(options) {
281
+ const tools = {
282
+ web_search: webSearchTool(options.search, options.searchResultLimit ?? defaultSearchResultLimit),
283
+ read_page: readPageTool(options.reader, options.pageCharacterLimit ?? defaultPageCharacterLimit)
284
+ };
285
+ const pageCharacterLimit = options.pageCharacterLimit ?? defaultPageCharacterLimit;
286
+ const screenshotTool = options.screenshots && pageScreenshotTool(options.screenshots, screenshotDownload(options), pageCharacterLimit);
287
+ const withScreenshot = screenshotTool ? { ...tools, page_screenshot: screenshotTool } : tools;
288
+ const counted = options.spending && countingSpending(options.spending);
289
+ return (model) => {
290
+ const chosen = screenshotTool && modelMaySeeToolResultImages(model.profile, model.providerId) ? withScreenshot : tools;
291
+ return counted && model.ownerId && model.chatId ? counted(chosen, model.ownerId, model.chatId) : chosen;
292
+ };
293
+ }
294
+ var refusedBeforeWork = /* @__PURE__ */ new Set(["bad_address", "bad_query", "invalid_key", "insufficient_funds", "rate_limited"]);
295
+ function screenshotDownload(options) {
296
+ const resolveHost = options.resolveHost ?? dnsHostResolver;
297
+ if (options.fetch) return { fetch: options.fetch, resolveHost };
298
+ return { fetch: sharedPinnedFetch(resolveHost), resolveHost, pinned: true };
299
+ }
300
+ function countingSpending(spending) {
301
+ const prices = spending.pricePerCallUsd;
302
+ for (const [name, price] of Object.entries(prices)) {
303
+ if (price !== void 0 && !(Number.isFinite(price) && price >= 0)) throw new Error(`pricePerCallUsd.${name}: \u043D\u0443\u0436\u043D\u043E \u0447\u0438\u0441\u043B\u043E \u043D\u0435 \u043C\u0435\u043D\u044C\u0448\u0435 \u043D\u0443\u043B\u044F, \u0430 \u043D\u0435 ${price}`);
304
+ }
305
+ const record = createWebUsageRecorder(spending);
306
+ return (tools, ownerId, chatId) => Object.fromEntries(
307
+ Object.entries(tools).map(([name, item]) => {
308
+ const price = prices[name];
309
+ const execute = item.execute;
310
+ if (price === void 0 || !execute) return [name, item];
311
+ return [
312
+ name,
313
+ {
314
+ ...item,
315
+ execute: async (input, executeOptions) => {
316
+ const stoppedBefore = executeOptions.abortSignal?.aborted === true;
317
+ let result;
318
+ try {
319
+ result = await execute(input, executeOptions);
320
+ } catch (error) {
321
+ const refused = error instanceof WebToolError && refusedBeforeWork.has(error.kind);
322
+ if (!stoppedBefore && !refused) await record(name, price, ownerId, chatId);
323
+ throw error;
324
+ }
325
+ await record(name, price, ownerId, chatId);
326
+ return result;
327
+ }
328
+ }
329
+ ];
330
+ })
331
+ );
332
+ }
333
+
334
+ // src/deepseek/deepseek-services.ts
335
+ var resultSchema = z4.object({
336
+ title: z4.string(),
337
+ url: z4.string(),
338
+ snippet: z4.string(),
339
+ summary: z4.string(),
340
+ date: z4.string().nullish(),
341
+ content: z4.string().optional()
342
+ });
343
+ var searchSchema = z4.object({ results: z4.array(resultSchema) });
344
+ var pageSchema = z4.object({ title: z4.string(), content: z4.string() });
345
+ var short = (text, limit) => cutAtCharBoundary2(text, limit);
346
+ function createDeepSeekServices(options) {
347
+ return services(options);
348
+ }
349
+ function createDeepSeekWebTools(options) {
350
+ const limit = options.searchResultLimit ?? 5;
351
+ integer(limit, 1, 50, "searchResultLimit");
352
+ const prices = { ...options.spending?.pricePerCallUsd ?? { web_search: 75e-5, read_page: 75e-5 } };
353
+ for (const name of ["web_search", "read_page"]) if (!Number.isFinite(prices[name]) || prices[name] < 0) throw new Error("pricePerCallUsd: \u043D\u0443\u0436\u043D\u043E \u0447\u0438\u0441\u043B\u043E \u043D\u0435 \u043C\u0435\u043D\u044C\u0448\u0435 \u043D\u0443\u043B\u044F");
354
+ const record = options.spending && createWebUsageRecorder({ ...options.spending, pricePerCallUsd: prices, providerId: "deepseek" });
355
+ const plain = createWebTools({ ...services(options), searchResultLimit: limit, pageCharacterLimit: options.pageCharacterLimit });
356
+ if (!record) return plain;
357
+ return (model) => {
358
+ const { ownerId, chatId } = model;
359
+ return createWebTools({
360
+ ...services(options, async (name) => {
361
+ if (ownerId && chatId) await record(name, prices[name], ownerId, chatId);
362
+ }),
363
+ searchResultLimit: limit,
364
+ pageCharacterLimit: options.pageCharacterLimit
365
+ })(model);
366
+ };
367
+ }
368
+ function integer(value, min, max, name) {
369
+ if (!Number.isInteger(value) || value < min || value > max) throw new Error(`${name}: \u043D\u0443\u0436\u043D\u043E \u0446\u0435\u043B\u043E\u0435 \u0447\u0438\u0441\u043B\u043E \u043E\u0442 ${min} \u0434\u043E ${max}`);
370
+ }
371
+ function services(options, billable) {
372
+ const apiKey = options.apiKey?.trim();
373
+ if (!apiKey || /[^\x21-\x7e]/.test(apiKey)) throw new Error("apiKey: \u043D\u0443\u0436\u0435\u043D \u043A\u043E\u0440\u0440\u0435\u043A\u0442\u043D\u044B\u0439 \u043A\u043B\u044E\u0447 DeepSeek");
374
+ let base;
375
+ try {
376
+ base = new URL(options.baseUrl ?? "https://api.deepseek.com");
377
+ } catch {
378
+ throw new Error("baseUrl: \u043D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 HTTP(S) \u0430\u0434\u0440\u0435\u0441");
379
+ }
380
+ if (!["http:", "https:"].includes(base.protocol) || base.username || base.password || base.search || base.hash) throw new Error("baseUrl: \u043D\u0443\u0436\u0435\u043D HTTP(S) \u0430\u0434\u0440\u0435\u0441 \u0431\u0435\u0437 \u043B\u043E\u0433\u0438\u043D\u0430, \u043F\u0430\u0440\u043E\u043B\u044F, query \u0438 fragment");
381
+ const baseUrl = base.href.replace(/\/+$/, "").replace(/\/v1$/, "");
382
+ const retries = options.maxRetries ?? 2, delay = options.retryDelayMs ?? 500;
383
+ integer(retries, 0, 10, "maxRetries");
384
+ if (!Number.isFinite(delay) || delay < 0 || delay > 3e4) throw new Error("retryDelayMs: \u043D\u0443\u0436\u043D\u043E \u0447\u0438\u0441\u043B\u043E \u043E\u0442 0 \u0434\u043E 30000");
385
+ if (options.timeoutMs !== void 0 && (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0 || options.timeoutMs > 2147483647)) throw new Error("timeoutMs: \u043D\u0443\u0436\u0435\u043D \u043F\u043E\u043B\u043E\u0436\u0438\u0442\u0435\u043B\u044C\u043D\u044B\u0439 \u0441\u0440\u043E\u043A \u0434\u043E 2147483647\u043C\u0441");
386
+ const contentLimit = options.searchContentCharacterLimit ?? 4e3;
387
+ integer(contentLimit, 0, 1e5, "searchContentCharacterLimit");
388
+ const request = options.fetch ?? globalThis.fetch;
389
+ let headers;
390
+ try {
391
+ headers = new Headers(options.headers);
392
+ } catch {
393
+ throw new Error("headers: \u043D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 HTTP \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A");
394
+ }
395
+ headers.set("Content-Type", "application/json");
396
+ headers.set("Authorization", `Bearer ${apiKey}`);
397
+ async function post(path, body, schema, signal, timeout) {
398
+ signal?.throwIfAborted();
399
+ const controller = new AbortController();
400
+ let timedOut = false;
401
+ let rejectAbort;
402
+ const aborted = new Promise((_, reject) => {
403
+ rejectAbort = () => reject(controller.signal.reason ?? new DOMException("Aborted", "AbortError"));
404
+ controller.signal.addEventListener("abort", rejectAbort, { once: true });
405
+ });
406
+ aborted.catch(() => {
407
+ });
408
+ const forward = () => controller.abort(signal?.reason);
409
+ signal?.addEventListener("abort", forward, { once: true });
410
+ const timer = setTimeout(() => {
411
+ timedOut = true;
412
+ controller.abort();
413
+ }, options.timeoutMs ?? timeout);
414
+ try {
415
+ for (let attempt = 0; ; attempt++) {
416
+ controller.signal.throwIfAborted();
417
+ const response = await Promise.race([request(`${baseUrl}/v1/tools/${path}`, {
418
+ method: "POST",
419
+ headers,
420
+ body: JSON.stringify(body),
421
+ signal: controller.signal
422
+ }), aborted]);
423
+ const text = await Promise.race([response.text(), aborted]);
424
+ if ((response.status === 408 || response.status === 429 || response.status >= 500) && attempt < retries) {
425
+ const retry = response.headers.get("retry-after");
426
+ const seconds = retry !== null && retry.trim() !== "" ? Number(retry) : NaN;
427
+ const after = retry === null ? NaN : Number.isFinite(seconds) ? seconds * 1e3 : Date.parse(retry) - Date.now();
428
+ const backoff = Math.min(3e4, delay * 2 ** attempt);
429
+ await wait(Math.min(2147483647, Math.max(backoff, Number.isFinite(after) ? after : 0)), controller.signal);
430
+ continue;
431
+ }
432
+ if (response.status !== 200) {
433
+ if (response.status === 400) throw new WebToolError(path === "search" ? "bad_query" : "bad_address", "\u0421\u0435\u0440\u0432\u0438\u0441 \u043E\u0442\u043A\u043B\u043E\u043D\u0438\u043B \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B \u0432\u0435\u0431-\u0437\u0430\u043F\u0440\u043E\u0441\u0430.");
434
+ if (response.status === 401) throw serviceFailure("invalid_key");
435
+ if (response.status === 402) throw serviceFailure("insufficient_funds");
436
+ if (response.status === 403) throw new WebToolError("bad_address", "\u0421\u0435\u0440\u0432\u0438\u0441 \u043D\u0435 \u0440\u0430\u0437\u0440\u0435\u0448\u0438\u043B \u0447\u0442\u0435\u043D\u0438\u0435 \u044D\u0442\u043E\u0433\u043E \u0430\u0434\u0440\u0435\u0441\u0430.");
437
+ if (response.status === 429) throw serviceFailure("rate_limited");
438
+ if (response.status === 408 || response.status === 504) throw serviceFailure("timeout");
439
+ throw serviceFailure(response.status >= 500 || response.status === 404 ? "unavailable" : "bad_response");
440
+ }
441
+ let value;
442
+ try {
443
+ value = JSON.parse(text);
444
+ } catch {
445
+ throw serviceFailure("bad_response");
446
+ }
447
+ const payload = value;
448
+ if (path === "search" && Array.isArray(payload?.results) && payload.results.length) await billable?.("web_search");
449
+ if (path === "fetch" && typeof payload?.content === "string" && payload.content.trim()) await billable?.("read_page");
450
+ const parsed = schema.safeParse(value);
451
+ if (!parsed.success) throw serviceFailure("bad_response");
452
+ return parsed.data;
453
+ }
454
+ } catch (error) {
455
+ if (signal?.aborted) throw signal.reason ?? error;
456
+ if (error instanceof WebToolError) throw error;
457
+ throw serviceFailure(timedOut ? "timeout" : "unavailable");
458
+ } finally {
459
+ clearTimeout(timer);
460
+ signal?.removeEventListener("abort", forward);
461
+ controller.signal.removeEventListener("abort", rejectAbort);
462
+ }
463
+ }
464
+ return {
465
+ search: { async search(query, { limit, signal }) {
466
+ const trimmed = query.trim();
467
+ if (!trimmed || Array.from(trimmed).length > 128) throw new WebToolError("bad_query", "\u041F\u043E\u0438\u0441\u043A\u043E\u0432\u044B\u0439 \u0437\u0430\u043F\u0440\u043E\u0441 DeepSeek \u0434\u043E\u043B\u0436\u0435\u043D \u0441\u043E\u0434\u0435\u0440\u0436\u0430\u0442\u044C \u043E\u0442 1 \u0434\u043E 128 \u0441\u0438\u043C\u0432\u043E\u043B\u043E\u0432 Unicode.");
468
+ integer(limit, 1, 50, "limit");
469
+ const data = await post("search", { query: trimmed, count: limit, need_content: options.needContent ?? false }, searchSchema, signal, 3e4);
470
+ return data.results.slice(0, limit).filter((item) => isHttpAddress(item.url)).map((item) => ({
471
+ title: short(item.title, 500),
472
+ url: item.url,
473
+ snippet: short(item.snippet, 500),
474
+ summary: short(item.summary, 1600),
475
+ ...item.date && { date: short(item.date, 80) },
476
+ ...options.needContent && item.content && { content: short(item.content, contentLimit) }
477
+ }));
478
+ } },
479
+ reader: { async readPage(url, { signal }) {
480
+ if (Array.from(url).length > 8192) throw new WebToolError("bad_address", "\u0410\u0434\u0440\u0435\u0441 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B \u0434\u043B\u0438\u043D\u043D\u0435\u0435 8192 \u0441\u0438\u043C\u0432\u043E\u043B\u043E\u0432.");
481
+ const address = assertPublicWebAddress(url);
482
+ if (address.href.length > 8192) throw new WebToolError("bad_address", "\u0410\u0434\u0440\u0435\u0441 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B \u043F\u043E\u0441\u043B\u0435 \u043A\u043E\u0434\u0438\u0440\u043E\u0432\u0430\u043D\u0438\u044F \u0434\u043B\u0438\u043D\u043D\u0435\u0435 8192 \u0441\u0438\u043C\u0432\u043E\u043B\u043E\u0432.");
483
+ const data = await post("fetch", { url: address.href }, pageSchema, signal, 6e4);
484
+ return { url: address.href, title: data.title, markdown: data.content };
485
+ } }
486
+ };
487
+ }
488
+ function wait(ms, signal) {
489
+ signal.throwIfAborted();
490
+ return new Promise((resolve, reject) => {
491
+ const abort = () => {
492
+ clearTimeout(timer);
493
+ signal.removeEventListener("abort", abort);
494
+ reject(signal.reason);
495
+ };
496
+ const timer = setTimeout(() => {
497
+ signal.removeEventListener("abort", abort);
498
+ resolve();
499
+ }, ms);
500
+ signal.addEventListener("abort", abort, { once: true });
501
+ });
502
+ }
503
+
504
+ export {
505
+ createWebTools,
506
+ createDeepSeekServices,
507
+ createDeepSeekWebTools
508
+ };
509
+ //# sourceMappingURL=chunk-ST6DBEHP.js.map