@ykurilov/agent-chat-web-tools 0.0.0-stage → 0.55.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yury Kurilov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,100 @@
-# Temporary Holding Version
+# @ykurilov/agent-chat-web-tools
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Веб-инструменты для агента: поиск в интернете, чтение страницы (в Markdown) и скриншот страницы.
+Отдельное расширение: приложение, которому они не нужны, не получает ни кода, ни зависимостей.
+
+```ts
+import { createWebTools, webToolsInstructions } from "@ykurilov/agent-chat-web-tools";
+import { createFirecrawlServices } from "@ykurilov/agent-chat-web-tools/firecrawl";
+
+const firecrawl = createFirecrawlServices({
+  apiKey: process.env.FIRECRAWL_API_KEY!,
+  baseUrl: process.env.FIRECRAWL_BASE_URL, // прокси; по умолчанию https://api.firecrawl.dev
+  headers: process.env.PROXY_TOKEN ? { "X-Proxy-Token": process.env.PROXY_TOKEN } : undefined,
+});
+const webTools = createWebTools({
+  ...firecrawl,
+  // по желанию: траты Firecrawl в лимит расходов; поиск — 2 кредита за 10 результатов, страница и снимок — по 1.
+  // Пишется удачный вызов и вызов, оборванный «Стопом» или сбоем после отправки запроса.
+  spending: { storage, pricePerCallUsd: { web_search: 2 * creditUsd, read_page: creditUsd, page_screenshot: creditUsd } },
+});
+
+createChatHandler({
+  …,
+  agent: {
+    instructions: `${appInstructions}\n${webToolsInstructions}`,
+    tools: (model) => ({ ...appTools, ...webTools(model) }),
+  },
+});
+```
+
+В браузерной части подписи «Поиск в интернете», «Чтение страницы», «Скриншот страницы» подключаются отдельно и
+не тянут код сервисов:
+
+```tsx
+import { withWebToolTitles } from "@ykurilov/agent-chat-web-tools/labels";
+<ChatLabelsProvider labels={withWebToolTitles(russianLabels)}>…</ChatLabelsProvider>;
+```
+
+По-английски — `withWebToolTitles(englishLabels, englishWebToolTitles)`.
+
+- `web_search` — список найденных страниц (заголовок-ссылка и выдержка); `read_page` — текст страницы с адресом-источником.
+  В результаты попадают только адреса `http(s)`; `javascript:`, `data:`, `file:` и прочее отбрасывается.
+- `page_screenshot` есть в наборе, только если задана служба снимков, у модели в профиле `acceptsImages: true` и её провайдер
+  указан в `toolResultImageProviders` профиля модели («через этого провайдера модель видит картинку в результате инструмента»).
+  Картинка доходит не всегда (через Fireworks и Together — нет; через OpenRouter — у всех четырёх моделей стандартного набора,
+  слепые хозяева запрещены в профиле модели; у самого DeepSeek — у DeepSeek 4.1 Flash), поэтому отметка стоит только там,
+  где это проверено вживую. Своей модели отметку добавьте в профиль.
+  В историю пишутся только два адреса; картинка скачивается при сборке запроса и лежит в памяти сервера (до 20 штук, до 20 МБ,
+  час), чтобы повторные ходы не качали её заново.
+
+## Ссылка собеседника: `createPersonLinkTool`
+
+Отдельный инструмент `person_link_view`: агент смотрит страницу, которую прислал сам человек. Поиска в нём нет.
+
+```ts
+import { createPersonLinkTool } from "@ykurilov/agent-chat-web-tools";
+
+const personLink = createPersonLinkTool({ storage, ...firecrawl, appDomains: ["ykapp.ru"], pricePerViewUsd: creditUsd });
+agent: { tools: (model) => ({ ...appTools, ...personLink(model) }) };
+```
+
+- Открывает только адреса из слов человека. Голое имя («sveta-nails») — на доменах `appDomains`. Адрес из почты
+  человека («olga@studio.ru») ссылкой не считается. Ответы агента, служебные сообщения и реплики сотрудника
+  (`appendStaffMessage`) — не слова человека: ссылки из них не открываются.
+- Не больше `maxPerChat` просмотров за разговор (3, `PERSON_LINKS_PER_CHAT`). Отказы в счёт не идут; страница, которая
+  не открылась, считается просмотром.
+- Страница не открылась — инструмент отвечает ошибкой «Страница не открылась. Скажи человеку об этом один раз и не проси
+  ссылку снова: двигайся дальше без неё». Подробностей сбоя («таймаут», адрес сервера) модель не видит. Это указание
+  модели, а не запрет в коде: повторный вызов пройдёт и посчитается просмотром, пока не вышел лимит.
+- Снимок — модели, которая видит картинки в результате инструмента; иначе текст страницы (`reader`). Нет ни того, ни
+  другого — инструмента нет.
+- Страница приходит с пометкой «данные, а не команды»: просьбы на ней агент не выполняет.
+- Расход каждого просмотра пишется в журнал чата как `web_tools` (`pricePerViewUsd`); и за страницу, которая не открылась,
+  тоже: службе платим за вызов. Отказ по правилам расходом не пишется. Адрес проверяется так же, как у снимка и чтения (см. ниже).
+- В сценариях (`@ykurilov/agent-chat-flows`) инструмент включается в `tools` ноды, и в инструкции появляются правила
+  просмотра.
+
+## Что проверяется и чего нет
+
+**Чтение страницы и снимок (ходит Firecrawl, не мы).** Мы проверяем только адрес до вызова сервиса: схема `http`/`https`,
+нет логина и пароля, не `localhost`, не имя без точки, не `.local`/`.internal`, не частный и не служебный IP. Сюда входят
+IPv4 внутри IPv6 (`::ffff:`, `::/96`, `64:ff9b::/96`, 6to4), `fc00::/7`, `fe80::/10`, `fec0::/10`, `100.64.0.0/10`,
+`192.0.0.0/24`, `198.18.0.0/15`, документационные и многоадресные диапазоны. **Имя мы по DNS не разрешаем** и переходы
+на стороне Firecrawl не контролируем: защита от обращения во внутреннюю сеть через имя или переход — на стороне сервиса.
+
+**Скачивание снимка (ходит наш сервер).** Проверок больше:
+- адрес проходит ту же проверку, а имя ещё разрешается по DNS; если хоть один адрес частный или имя не разрешилось — отказ;
+- переходы выполняются вручную (`redirect: "manual"`), не больше трёх, и каждый проходит ту же проверку;
+- только `image/*`, не больше 5 МБ, таймаут 20 с; любой сбой — вместо картинки текст «снимок больше недоступен».
+
+Остаётся короткое окно: между проверкой по DNS и запросом `fetch` разрешает имя ещё раз, и злонамеренный DNS-сервер
+может ответить иначе (DNS rebinding). Полностью закрывается сетевым правилом на сервере: исходящие соединения во внутреннюю
+сеть запрещены. Для сервера, у которого во внутренней сети есть что-то ценное, добавьте такое правило.
+
+- Описания инструментов и схемы входа постоянны и не зависят от настроек и от службы: они идут в начало запроса к модели и
+  попадают в кэш провайдера. Результаты идут в конец.
+- Служба заменяется: `WebSearchService`, `PageReaderService`, `PageScreenshotService` — небольшие интерфейсы. Поиск на Exa —
+  своя реализация `WebSearchService`, инструменты не меняются. Ключ и адрес сервиса живут только на сервере.
+- Ошибки — `WebToolError` с понятным русским текстом без ключа и адреса; текст виден в строке вызова в ленте.
+- Пределы: `searchResultLimit` (5 результатов), `pageCharacterLimit` (30 000 знаков; длинный текст режется на границе абзаца с пометкой).

package/dist/chunk-66W2PQRQ.js

@@ -0,0 +1,133 @@
+// src/web-tool-error.ts
+var WebToolError = class extends Error {
+  kind;
+  constructor(kind, message) {
+    super(message);
+    this.name = "WebToolError";
+    this.kind = kind;
+  }
+};
+var serviceFailureMessages = {
+  invalid_key: "\u0421\u0435\u0440\u0432\u0438\u0441 \u0432\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u043E\u0442\u043A\u043B\u043E\u043D\u0438\u043B \u043A\u043B\u044E\u0447 \u0434\u043E\u0441\u0442\u0443\u043F\u0430.",
+  insufficient_funds: "\u041D\u0430 \u0441\u0447\u0451\u0442\u0435 \u0441\u0435\u0440\u0432\u0438\u0441\u0430 \u0432\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u0437\u0430\u043A\u043E\u043D\u0447\u0438\u043B\u0438\u0441\u044C \u0441\u0440\u0435\u0434\u0441\u0442\u0432\u0430.",
+  rate_limited: "\u041F\u0440\u0435\u0432\u044B\u0448\u0435\u043D \u043B\u0438\u043C\u0438\u0442 \u0437\u0430\u043F\u0440\u043E\u0441\u043E\u0432 \u0441\u0435\u0440\u0432\u0438\u0441\u0430 \u0432\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432, \u043F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u043F\u043E\u0437\u0436\u0435.",
+  unavailable: "\u0421\u0435\u0440\u0432\u0438\u0441 \u0432\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u0441\u0435\u0439\u0447\u0430\u0441 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D, \u043F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u043F\u043E\u0437\u0436\u0435.",
+  timeout: "\u0421\u0435\u0440\u0432\u0438\u0441 \u0432\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u043D\u0435 \u043E\u0442\u0432\u0435\u0442\u0438\u043B \u0432\u043E\u0432\u0440\u0435\u043C\u044F.",
+  bad_response: "\u0421\u0435\u0440\u0432\u0438\u0441 \u0432\u0435\u0431-\u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u0432\u0435\u0440\u043D\u0443\u043B \u043D\u0435\u043E\u0436\u0438\u0434\u0430\u043D\u043D\u044B\u0439 \u043E\u0442\u0432\u0435\u0442."
+};
+function serviceFailure(kind) {
+  return new WebToolError(kind, serviceFailureMessages[kind]);
+}
+
+// src/page-address.ts
+var notPublicMessage = "\u0410\u0434\u0440\u0435\u0441 \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u044B\u0439 \u0438\u043B\u0438 \u0447\u0430\u0441\u0442\u043D\u044B\u0439: \u0442\u0430\u043A\u0438\u0435 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B \u0447\u0438\u0442\u0430\u0442\u044C \u043D\u0435\u043B\u044C\u0437\u044F.";
+function isHttpAddress(address) {
+  try {
+    const { protocol } = new URL(address);
+    return protocol === "http:" || protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function assertPublicWebAddress(address) {
+  let url;
+  try {
+    url = new URL(address);
+  } catch {
+    throw new WebToolError("bad_address", "\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0430\u0434\u0440\u0435\u0441 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B: \u043D\u0443\u0436\u0435\u043D \u043F\u043E\u043B\u043D\u044B\u0439 \u0430\u0434\u0440\u0435\u0441 \u0441 http:// \u0438\u043B\u0438 https://.");
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new WebToolError("bad_address", "\u041D\u0435\u0432\u0435\u0440\u043D\u044B\u0439 \u0430\u0434\u0440\u0435\u0441 \u0441\u0442\u0440\u0430\u043D\u0438\u0446\u044B: \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044E\u0442\u0441\u044F \u0442\u043E\u043B\u044C\u043A\u043E http:// \u0438 https://.");
+  }
+  if (url.username || url.password) {
+    throw new WebToolError("bad_address", "\u0410\u0434\u0440\u0435\u0441 \u0441 \u043B\u043E\u0433\u0438\u043D\u043E\u043C \u0438 \u043F\u0430\u0440\u043E\u043B\u0435\u043C \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044F.");
+  }
+  if (isLocalHost(url.hostname)) throw new WebToolError("bad_address", notPublicMessage);
+  return url;
+}
+async function assertResolvesPublic(url, resolveHost) {
+  const hostname = url.hostname.toLowerCase().replace(/\.$/, "");
+  if (hostname.startsWith("[") || /^\d+\.\d+\.\d+\.\d+$/.test(hostname)) return;
+  let addresses;
+  try {
+    addresses = await resolveHost(hostname);
+  } catch {
+    throw new WebToolError("bad_address", "\u0410\u0434\u0440\u0435\u0441 \u043D\u0435 \u043E\u0442\u043A\u0440\u044B\u043B\u0441\u044F: \u0438\u043C\u044F \u043D\u0435 \u0440\u0430\u0437\u0440\u0435\u0448\u0438\u043B\u043E\u0441\u044C.");
+  }
+  if (addresses.length === 0) throw new WebToolError("bad_address", "\u0410\u0434\u0440\u0435\u0441 \u043D\u0435 \u043E\u0442\u043A\u0440\u044B\u043B\u0441\u044F: \u0438\u043C\u044F \u043D\u0435 \u0440\u0430\u0437\u0440\u0435\u0448\u0438\u043B\u043E\u0441\u044C.");
+  if (addresses.some(isPrivateAddress)) throw new WebToolError("bad_address", notPublicMessage);
+}
+function isPrivateAddress(address) {
+  const bare = address.trim().replace(/^\[|\]$/g, "");
+  const ipv4 = parseIpv4(bare);
+  if (ipv4) return isPrivateIpv4(ipv4);
+  const groups = parseIpv6(bare);
+  return groups ? isPrivateIpv6(groups) : true;
+}
+function isLocalHost(rawHostname) {
+  const hostname = rawHostname.toLowerCase().replace(/\.$/, "");
+  if (hostname.startsWith("[")) return isPrivateAddress(hostname.slice(1, -1));
+  if (/^\d+\.\d+\.\d+\.\d+$/.test(hostname)) return isPrivateAddress(hostname);
+  if (!hostname.includes(".")) return true;
+  return hostname.endsWith(".localhost") || hostname.endsWith(".local") || hostname.endsWith(".internal");
+}
+function parseIpv4(text) {
+  const match = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(text);
+  if (!match) return void 0;
+  const octets = match.slice(1).map(Number);
+  return octets.every((octet) => octet <= 255) ? octets : void 0;
+}
+function parseIpv6(text) {
+  const withoutZone = text.split("%")[0] ?? "";
+  if (!/^[0-9a-f:.]+$/i.test(withoutZone) || !withoutZone.includes(":")) return void 0;
+  let value = withoutZone;
+  const tail = value.slice(value.lastIndexOf(":") + 1);
+  if (tail.includes(".")) {
+    const ipv4 = parseIpv4(tail);
+    if (!ipv4) return void 0;
+    const [a = 0, b = 0, c = 0, d = 0] = ipv4;
+    value = `${value.slice(0, value.lastIndexOf(":") + 1)}${(a << 8 | b).toString(16)}:${(c << 8 | d).toString(16)}`;
+  }
+  const halves = value.split("::");
+  if (halves.length > 2) return void 0;
+  const toGroups = (part) => {
+    if (part === "") return [];
+    const texts = part.split(":");
+    if (!texts.every((group) => /^[0-9a-f]{1,4}$/i.test(group))) return void 0;
+    return texts.map((group) => parseInt(group, 16));
+  };
+  const head = toGroups(halves[0] ?? "");
+  const rest = halves.length === 2 ? toGroups(halves[1] ?? "") : [];
+  if (!head || !rest) return void 0;
+  if (halves.length === 1) return head.length === 8 ? head : void 0;
+  const missing = 8 - head.length - rest.length;
+  return missing >= 1 ? [...head, ...new Array(missing).fill(0), ...rest] : void 0;
+}
+function isPrivateIpv4([first = 0, second = 0, third = 0]) {
+  return first === 0 || first === 10 || first === 100 && second >= 64 && second <= 127 || first === 127 || first === 169 && second === 254 || first === 172 && second >= 16 && second <= 31 || first === 192 && second === 0 && (third === 0 || third === 2) || first === 192 && second === 168 || first === 198 && (second === 18 || second === 19) || first === 198 && second === 51 && third === 100 || first === 203 && second === 0 && third === 113 || first >= 224;
+}
+function isPrivateIpv6(groups) {
+  const [g0 = 0, g1 = 0, g2 = 0, g3 = 0, g4 = 0, g5 = 0, g6 = 0, g7 = 0] = groups;
+  const embedded = (high, low) => isPrivateIpv4([high >> 8, high & 255, low >> 8, low & 255]);
+  const zeroUpTo = (count) => groups.slice(0, count).every((group) => group === 0);
+  if (zeroUpTo(6)) return embedded(g6, g7);
+  if (zeroUpTo(5) && g5 === 65535) return embedded(g6, g7);
+  if (g0 === 100 && g1 === 65435) {
+    if (g2 === 1) return true;
+    if (g2 === 0 && g3 === 0 && g4 === 0 && g5 === 0) return embedded(g6, g7);
+  }
+  if (g0 === 8194) return embedded(g1, g2);
+  if (g0 === 8193 && g1 === 0) return true;
+  if (g0 === 8193 && g1 === 3512) return true;
+  return (g0 & 65024) === 64512 || (g0 & 65472) === 65152 || (g0 & 65472) === 65216 || (g0 & 65280) === 65280;
+}
+
+export {
+  WebToolError,
+  serviceFailure,
+  isHttpAddress,
+  assertPublicWebAddress,
+  assertResolvesPublic,
+  isPrivateAddress
+};
+//# sourceMappingURL=chunk-66W2PQRQ.js.map

package/dist/chunk-66W2PQRQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/web-tool-error.ts","../src/page-address.ts"],"sourcesContent":["export type WebToolErrorKind =\n  | \"bad_address\"\n  | \"bad_query\"\n  | \"invalid_key\"\n  | \"insufficient_funds\"\n  | \"rate_limited\"\n  | \"unavailable\"\n  | \"timeout\"\n  | \"bad_response\";\n\n/**\n * Ошибка веб-инструмента. Текст по-русски показывается и модели, и человеку в строке вызова,\n * поэтому в нём нет ключа, адреса сервиса и заголовков.\n */\nexport class WebToolError extends Error {\n  readonly kind: WebToolErrorKind;\n\n  constructor(kind: WebToolErrorKind, message: string) {\n    super(message);\n    this.name = \"WebToolError\";\n    this.kind = kind;\n  }\n}\n\nexport const serviceFailureMessages = {\n  invalid_key: \"Сервис веб-инструментов отклонил ключ доступа.\",\n  insufficient_funds: \"На счёте сервиса веб-инструментов закончились средства.\",\n  rate_limited: \"Превышен лимит запросов сервиса веб-инструментов, попробуйте позже.\",\n  unavailable: \"Сервис веб-инструментов сейчас недоступен, попробуйте позже.\",\n  timeout: \"Сервис веб-инструментов не ответил вовремя.\",\n  bad_response: \"Сервис веб-инструментов вернул неожиданный ответ.\",\n} as const;\n\nexport function serviceFailure(kind: keyof typeof serviceFailureMessages): WebToolError {\n  return new WebToolError(kind, serviceFailureMessages[kind]);\n}\n","import { WebToolError } from \"./web-tool-error\";\n\nconst notPublicMessage = \"Адрес локальный или частный: такие страницы читать нельзя.\";\n\n/** Определяет адреса имени. В приложении это DNS; в тестах подменяется. */\nexport type HostResolver = (hostname: string) => Promise<string[]>;\n\n/** Адрес http или https: единственные схемы, которые пускают в результаты и в скачивание. */\nexport function isHttpAddress(address: string): boolean {\n  try {\n    const { protocol } = new URL(address);\n    return protocol === \"http:\" || protocol === \"https:\";\n  } catch {\n    return false;\n  }\n}\n\n/** Пропускает только публичные адреса http и https: сервис чтения не должен ходить во внутреннюю сеть. */\nexport function assertPublicWebAddress(address: string): URL {\n  let url: URL;\n  try {\n    url = new URL(address);\n  } catch {\n    throw new WebToolError(\"bad_address\", \"Неверный адрес страницы: нужен полный адрес с http:// или https://.\");\n  }\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new WebToolError(\"bad_address\", \"Неверный адрес страницы: поддерживаются только http:// и https://.\");\n  }\n  if (url.username || url.password) {\n    throw new WebToolError(\"bad_address\", \"Адрес с логином и паролем не поддерживается.\");\n  }\n  if (isLocalHost(url.hostname)) throw new WebToolError(\"bad_address\", notPublicMessage);\n  return url;\n}\n\n/**\n * Проверка по DNS для тех, кто ходит по адресу сам: имя разрешается, и если хоть один адрес частный\n * (или имя не разрешилось), оно отклоняется. Адрес-число уже проверен `assertPublicWebAddress`.\n * Между проверкой и запросом остаётся короткое окно: fetch разрешает имя ещё раз.\n */\nexport async function assertResolvesPublic(url: URL, resolveHost: HostResolver): Promise<void> {\n  const hostname = url.hostname.toLowerCase().replace(/\\.$/, \"\");\n  if (hostname.startsWith(\"[\") || /^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(hostname)) return;\n  let addresses: string[];\n  try {\n    addresses = await resolveHost(hostname);\n  } catch {\n    throw new WebToolError(\"bad_address\", \"Адрес не открылся: имя не разрешилось.\");\n  }\n  if (addresses.length === 0) throw new WebToolError(\"bad_address\", \"Адрес не открылся: имя не разрешилось.\");\n  if (addresses.some(isPrivateAddress)) throw new WebToolError(\"bad_address\", notPublicMessage);\n}\n\n/** Адрес из ответа DNS (без скобок). Всё, что не удалось разобрать, считается частным. */\nexport function isPrivateAddress(address: string): boolean {\n  const bare = address.trim().replace(/^\\[|\\]$/g, \"\");\n  const ipv4 = parseIpv4(bare);\n  if (ipv4) return isPrivateIpv4(ipv4);\n  const groups = parseIpv6(bare);\n  return groups ? isPrivateIpv6(groups) : true;\n}\n\nfunction isLocalHost(rawHostname: string): boolean {\n  const hostname = rawHostname.toLowerCase().replace(/\\.$/, \"\");\n  if (hostname.startsWith(\"[\")) return isPrivateAddress(hostname.slice(1, -1));\n  if (/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(hostname)) return isPrivateAddress(hostname);\n  if (!hostname.includes(\".\")) return true;\n  return hostname.endsWith(\".localhost\") || hostname.endsWith(\".local\") || hostname.endsWith(\".internal\");\n}\n\nfunction parseIpv4(text: string): number[] | undefined {\n  const match = /^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/.exec(text);\n  if (!match) return undefined;\n  const octets = match.slice(1).map(Number);\n  return octets.every((octet) => octet <= 255) ? octets : undefined;\n}\n\n/** Восемь групп по 16 бит или `undefined`. Понимает `::` и IPv4 в конце. */\nfunction parseIpv6(text: string): number[] | undefined {\n  const withoutZone = text.split(\"%\")[0] ?? \"\";\n  if (!/^[0-9a-f:.]+$/i.test(withoutZone) || !withoutZone.includes(\":\")) return undefined;\n  let value = withoutZone;\n  const tail = value.slice(value.lastIndexOf(\":\") + 1);\n  if (tail.includes(\".\")) {\n    const ipv4 = parseIpv4(tail);\n    if (!ipv4) return undefined;\n    const [a = 0, b = 0, c = 0, d = 0] = ipv4;\n    value = `${value.slice(0, value.lastIndexOf(\":\") + 1)}${((a << 8) | b).toString(16)}:${((c << 8) | d).toString(16)}`;\n  }\n  const halves = value.split(\"::\");\n  if (halves.length > 2) return undefined;\n  const toGroups = (part: string): number[] | undefined => {\n    if (part === \"\") return [];\n    const texts = part.split(\":\");\n    if (!texts.every((group) => /^[0-9a-f]{1,4}$/i.test(group))) return undefined;\n    return texts.map((group) => parseInt(group, 16));\n  };\n  const head = toGroups(halves[0] ?? \"\");\n  const rest = halves.length === 2 ? toGroups(halves[1] ?? \"\") : [];\n  if (!head || !rest) return undefined;\n  if (halves.length === 1) return head.length === 8 ? head : undefined;\n  const missing = 8 - head.length - rest.length;\n  return missing >= 1 ? [...head, ...new Array<number>(missing).fill(0), ...rest] : undefined;\n}\n\nfunction isPrivateIpv4([first = 0, second = 0, third = 0]: number[]): boolean {\n  return (\n    first === 0 ||\n    first === 10 ||\n    (first === 100 && second >= 64 && second <= 127) ||\n    first === 127 ||\n    (first === 169 && second === 254) ||\n    (first === 172 && second >= 16 && second <= 31) ||\n    (first === 192 && second === 0 && (third === 0 || third === 2)) ||\n    (first === 192 && second === 168) ||\n    (first === 198 && (second === 18 || second === 19)) ||\n    (first === 198 && second === 51 && third === 100) ||\n    (first === 203 && second === 0 && third === 113) ||\n    first >= 224\n  );\n}\n\nfunction isPrivateIpv6(groups: number[]): boolean {\n  const [g0 = 0, g1 = 0, g2 = 0, g3 = 0, g4 = 0, g5 = 0, g6 = 0, g7 = 0] = groups;\n  const embedded = (high: number, low: number) => isPrivateIpv4([high >> 8, high & 0xff, low >> 8, low & 0xff]);\n  const zeroUpTo = (count: number) => groups.slice(0, count).every((group) => group === 0);\n\n  if (zeroUpTo(6)) return embedded(g6, g7); // ::/96, в том числе :: и ::1\n  if (zeroUpTo(5) && g5 === 0xffff) return embedded(g6, g7); // ::ffff:0:0/96\n  if (g0 === 0x64 && g1 === 0xff9b) {\n    if (g2 === 1) return true; // 64:ff9b:1::/48, локальное использование\n    if (g2 === 0 && g3 === 0 && g4 === 0 && g5 === 0) return embedded(g6, g7); // 64:ff9b::/96\n  }\n  if (g0 === 0x2002) return embedded(g1, g2); // 6to4 несёт IPv4 в адресе\n  if (g0 === 0x2001 && g1 === 0) return true; // Teredo\n  if (g0 === 0x2001 && g1 === 0xdb8) return true; // для документации\n  return (g0 & 0xfe00) === 0xfc00 || (g0 & 0xffc0) === 0xfe80 || (g0 & 0xffc0) === 0xfec0 || (g0 & 0xff00) === 0xff00;\n}\n"],"mappings":"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","names":[]}

package/dist/firecrawl.js

@@ -0,0 +1,135 @@
+import {
+  isHttpAddress,
+  serviceFailure
+} from "./chunk-66W2PQRQ.js";
+
+// src/firecrawl/firecrawl-services.ts
+import { cutAtCharBoundary } from "@ykurilov/agent-chat-core";
+import { z } from "zod";
+var defaultBaseUrl = "https://api.firecrawl.dev";
+var searchTimeoutMs = 3e4;
+var scrapeTimeoutMs = 6e4;
+var snippetLimit = 300;
+var searchResponse = z.object({
+  data: z.object({
+    web: z.array(z.object({ url: z.string().nullish(), title: z.string().nullish(), description: z.string().nullish() })).optional()
+  })
+});
+var scrapeResponse = z.object({
+  data: z.object({
+    markdown: z.string().nullish(),
+    screenshot: z.string().nullish(),
+    metadata: z.object({ title: z.string().nullish(), sourceURL: z.string().nullish(), url: z.string().nullish() }).nullish()
+  })
+});
+function createFirecrawlServices(options) {
+  const baseUrl = (options.baseUrl ?? defaultBaseUrl).replace(/\/+$/, "");
+  const fetchImplementation = options.fetch ?? globalThis.fetch;
+  async function post(path, body, schema, { signal, timeoutMs }) {
+    const controller = new AbortController();
+    const forwardAbort = () => controller.abort(signal?.reason);
+    if (signal?.aborted) forwardAbort();
+    signal?.addEventListener("abort", forwardAbort, { once: true });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, timeoutMs);
+    const aborted = new Promise((_resolve, reject) => {
+      controller.signal.addEventListener("abort", () => reject(controller.signal.reason ?? new DOMException("Aborted", "AbortError")));
+    });
+    aborted.catch(() => {
+    });
+    let status;
+    let text;
+    try {
+      const response = await Promise.race([
+        fetchImplementation(`${baseUrl}${path}`, {
+          method: "POST",
+          headers: { ...options.headers, "Content-Type": "application/json", Authorization: `Bearer ${options.apiKey}` },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        }),
+        aborted
+      ]);
+      status = response.status;
+      text = await Promise.race([response.text(), aborted]);
+    } catch (error) {
+      if (signal?.aborted) throw signal.reason ?? error;
+      throw serviceFailure(timedOut ? "timeout" : "unavailable");
+    } finally {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", forwardAbort);
+    }
+    const failure = failureKindOf(status);
+    if (failure) throw serviceFailure(failure);
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      throw serviceFailure("bad_response");
+    }
+    if (json?.success === false) throw serviceFailure("bad_response");
+    const parsed = schema.safeParse(json);
+    if (!parsed.success) throw serviceFailure("bad_response");
+    return parsed.data;
+  }
+  return {
+    search: {
+      async search(query, { limit, signal }) {
+        const response = await post("/v2/search", { query, limit }, searchResponse, {
+          signal,
+          timeoutMs: options.timeoutMs ?? searchTimeoutMs
+        });
+        const hits = [];
+        for (const item of response.data.web ?? []) {
+          if (!item.url || !isHttpAddress(item.url)) continue;
+          hits.push({ title: (item.title ?? "").trim(), url: item.url, snippet: cleanSnippet(item.description ?? "") });
+        }
+        return hits;
+      }
+    },
+    reader: {
+      async readPage(url, { signal }) {
+        const response = await post("/v2/scrape", { url, formats: ["markdown"], onlyMainContent: true }, scrapeResponse, {
+          signal,
+          timeoutMs: options.timeoutMs ?? scrapeTimeoutMs
+        });
+        if (typeof response.data.markdown !== "string") throw serviceFailure("bad_response");
+        const metadata = response.data.metadata;
+        const page = {
+          url: [metadata?.url, metadata?.sourceURL].find((candidate) => candidate && isHttpAddress(candidate)) || url,
+          title: (metadata?.title ?? "").trim(),
+          markdown: response.data.markdown
+        };
+        return page;
+      }
+    },
+    screenshots: {
+      async takeScreenshot(url, { signal }) {
+        const response = await post("/v2/scrape", { url, formats: ["screenshot"] }, scrapeResponse, {
+          signal,
+          timeoutMs: options.timeoutMs ?? scrapeTimeoutMs
+        });
+        if (!response.data.screenshot || !isHttpAddress(response.data.screenshot)) throw serviceFailure("bad_response");
+        return { imageUrl: response.data.screenshot };
+      }
+    }
+  };
+}
+function failureKindOf(status) {
+  if (status >= 200 && status < 300) return void 0;
+  if (status === 401 || status === 403) return "invalid_key";
+  if (status === 402) return "insufficient_funds";
+  if (status === 429) return "rate_limited";
+  if (status >= 500) return "unavailable";
+  return "bad_response";
+}
+function cleanSnippet(description) {
+  const plain = description.split("\n").filter((line) => !/^[\s|:-]+$/.test(line)).join(" ").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/[#*`|>[\]]/g, " ").replace(/\s+/g, " ").trim();
+  return plain.length > snippetLimit ? `${cutAtCharBoundary(plain, snippetLimit).trimEnd()}\u2026` : plain;
+}
+export {
+  createFirecrawlServices
+};
+//# sourceMappingURL=firecrawl.js.map

package/dist/firecrawl.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/firecrawl/firecrawl-services.ts"],"sourcesContent":["import { cutAtCharBoundary } from \"@ykurilov/agent-chat-core\";\nimport { z } from \"zod\";\nimport { isHttpAddress } from \"../page-address\";\nimport type { PageContent, PageReaderService, PageScreenshotService, SearchHit, WebSearchService } from \"../services\";\nimport { serviceFailure } from \"../web-tool-error\";\nimport type { WebToolErrorKind } from \"../web-tool-error\";\n\nexport interface FirecrawlOptions {\n  apiKey: string;\n  /** Адрес сервиса или прокси перед ним; по умолчанию https://api.firecrawl.dev. */\n  baseUrl?: string;\n  /** Дополнительные заголовки каждого запроса, например токен прокси. */\n  headers?: Record<string, string>;\n  fetch?: typeof globalThis.fetch;\n  /** Предел ожидания ответа, мс. По умолчанию 30 000 для поиска и 60 000 для чтения и снимка. */\n  timeoutMs?: number;\n}\n\nexport interface FirecrawlServices {\n  search: WebSearchService;\n  reader: PageReaderService;\n  screenshots: PageScreenshotService;\n}\n\nconst defaultBaseUrl = \"https://api.firecrawl.dev\";\nconst searchTimeoutMs = 30_000;\nconst scrapeTimeoutMs = 60_000;\nconst snippetLimit = 300;\n\nconst searchResponse = z.object({\n  data: z.object({\n    web: z\n      .array(z.object({ url: z.string().nullish(), title: z.string().nullish(), description: z.string().nullish() }))\n      .optional(),\n  }),\n});\n\nconst scrapeResponse = z.object({\n  data: z.object({\n    markdown: z.string().nullish(),\n    screenshot: z.string().nullish(),\n    metadata: z.object({ title: z.string().nullish(), sourceURL: z.string().nullish(), url: z.string().nullish() }).nullish(),\n  }),\n});\n\nexport function createFirecrawlServices(options: FirecrawlOptions): FirecrawlServices {\n  const baseUrl = (options.baseUrl ?? defaultBaseUrl).replace(/\\/+$/, \"\");\n  const fetchImplementation = options.fetch ?? globalThis.fetch;\n\n  async function post<Schema extends z.ZodType>(\n    path: string,\n    body: unknown,\n    schema: Schema,\n    { signal, timeoutMs }: { signal: AbortSignal | undefined; timeoutMs: number },\n  ): Promise<z.infer<Schema>> {\n    const controller = new AbortController();\n    const forwardAbort = () => controller.abort(signal?.reason);\n    if (signal?.aborted) forwardAbort();\n    signal?.addEventListener(\"abort\", forwardAbort, { once: true });\n    let timedOut = false;\n    const timer = setTimeout(() => {\n      timedOut = true;\n      controller.abort();\n    }, timeoutMs);\n    // Оборванный запрос не всегда сам отвечает на сигнал: ждём и сигнал, и ответ.\n    const aborted = new Promise<never>((_resolve, reject) => {\n      controller.signal.addEventListener(\"abort\", () => reject(controller.signal.reason ?? new DOMException(\"Aborted\", \"AbortError\")));\n    });\n    aborted.catch(() => {});\n\n    let status: number;\n    let text: string;\n    try {\n      const response = await Promise.race([\n        fetchImplementation(`${baseUrl}${path}`, {\n          method: \"POST\",\n          headers: { ...options.headers, \"Content-Type\": \"application/json\", Authorization: `Bearer ${options.apiKey}` },\n          body: JSON.stringify(body),\n          signal: controller.signal,\n        }),\n        aborted,\n      ]);\n      status = response.status;\n      text = await Promise.race([response.text(), aborted]);\n    } catch (error) {\n      if (signal?.aborted) throw signal.reason ?? error;\n      throw serviceFailure(timedOut ? \"timeout\" : \"unavailable\");\n    } finally {\n      clearTimeout(timer);\n      signal?.removeEventListener(\"abort\", forwardAbort);\n    }\n\n    const failure = failureKindOf(status);\n    if (failure) throw serviceFailure(failure);\n    let json: unknown;\n    try {\n      json = JSON.parse(text);\n    } catch {\n      throw serviceFailure(\"bad_response\");\n    }\n    if ((json as { success?: unknown } | null)?.success === false) throw serviceFailure(\"bad_response\");\n    const parsed = schema.safeParse(json);\n    if (!parsed.success) throw serviceFailure(\"bad_response\");\n    return parsed.data;\n  }\n\n  return {\n    search: {\n      async search(query, { limit, signal }) {\n        const response = await post(\"/v2/search\", { query, limit }, searchResponse, {\n          signal,\n          timeoutMs: options.timeoutMs ?? searchTimeoutMs,\n        });\n        const hits: SearchHit[] = [];\n        for (const item of response.data.web ?? []) {\n          if (!item.url || !isHttpAddress(item.url)) continue;\n          hits.push({ title: (item.title ?? \"\").trim(), url: item.url, snippet: cleanSnippet(item.description ?? \"\") });\n        }\n        return hits;\n      },\n    },\n    reader: {\n      async readPage(url, { signal }) {\n        const response = await post(\"/v2/scrape\", { url, formats: [\"markdown\"], onlyMainContent: true }, scrapeResponse, {\n          signal,\n          timeoutMs: options.timeoutMs ?? scrapeTimeoutMs,\n        });\n        if (typeof response.data.markdown !== \"string\") throw serviceFailure(\"bad_response\");\n        const metadata = response.data.metadata;\n        const page: PageContent = {\n          url: [metadata?.url, metadata?.sourceURL].find((candidate) => candidate && isHttpAddress(candidate)) || url,\n          title: (metadata?.title ?? \"\").trim(),\n          markdown: response.data.markdown,\n        };\n        return page;\n      },\n    },\n    screenshots: {\n      async takeScreenshot(url, { signal }) {\n        const response = await post(\"/v2/scrape\", { url, formats: [\"screenshot\"] }, scrapeResponse, {\n          signal,\n          timeoutMs: options.timeoutMs ?? scrapeTimeoutMs,\n        });\n        if (!response.data.screenshot || !isHttpAddress(response.data.screenshot)) throw serviceFailure(\"bad_response\");\n        return { imageUrl: response.data.screenshot };\n      },\n    },\n  };\n}\n\nfunction failureKindOf(status: number): Exclude<WebToolErrorKind, \"bad_address\" | \"bad_query\" | \"timeout\"> | undefined {\n  if (status >= 200 && status < 300) return undefined;\n  if (status === 401 || status === 403) return \"invalid_key\";\n  if (status === 402) return \"insufficient_funds\";\n  if (status === 429) return \"rate_limited\";\n  if (status >= 500) return \"unavailable\";\n  return \"bad_response\";\n}\n\n/** Выдержка поиска приходит с разметкой: оставляем чистый текст в одну строку не длиннее предела. */\nfunction cleanSnippet(description: string): string {\n  const plain = description\n    .split(\"\\n\")\n    .filter((line) => !/^[\\s|:-]+$/.test(line))\n    .join(\" \")\n    .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n    .replace(/[#*`|>[\\]]/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .trim();\n  return plain.length > snippetLimit ? `${cutAtCharBoundary(plain, snippetLimit).trimEnd()}…` : plain;\n}\n"],"mappings":"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","names":[]}