@sharleysoft/openclaw-yandex-maps-places-review 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Yandex Maps Places Review contributors
+
+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

@@ -0,0 +1,237 @@
+# OpenClaw Yandex Maps Places Review
+
+Tool-плагин для OpenClaw, который собирает последние публичные отзывы заведения на Яндекс Картах через Playwright.
+
+Плагин не использует API Яндекса. Он открывает публичную страницу заведения в браузере, переходит на страницу отзывов, пытается отсортировать отзывы по новизне и возвращает найденные отзывы в JSON.
+
+## Возможности
+
+- Tool `yandex_maps_place_reviews`.
+- Принимает ссылку на заведение в Яндекс Картах.
+- Возвращает последние `N` отзывов, по умолчанию `100`.
+- Если отзывов меньше запрошенного количества или Яндекс перестал догружать список, возвращает доступные отзывы и warning.
+- Для каждого отзыва возвращает `url`, если ссылку удалось извлечь, `date` и `text`.
+- Поддерживает уровни логирования через config плагина.
+- Есть обычные тесты, live-тест и headed live-тест с видимым браузером.
+
+## Требования
+
+- Node.js `22.19+`; рекомендуется Node.js `24`.
+- npm.
+- OpenClaw `2026.6.11+` для установки плагина.
+- Playwright Chromium.
+
+Проверьте версию Node:
+
+```powershell
+node --version
+```
+
+Если нужен portable Node на Windows, скачайте архив Node.js 24 с https://nodejs.org/dist/latest-v24.x/, распакуйте его в удобную директорию и добавьте эту директорию в `PATH` текущей сессии:
+
+```powershell
+$env:PATH="D:\Tools\node-v24.x.x-win-x64;$env:PATH"
+node --version
+npm --version
+```
+
+После этого все команды ниже можно выполнять как обычные `npm` / `npx`.
+
+## Установка в OpenClaw
+
+На Ubuntu установите плагин, Chromium и необходимые системные библиотеки:
+
+```bash
+openclaw plugins install npm:@sharleysoft/openclaw-yandex-maps-places-review
+npx --yes @sharleysoft/openclaw-yandex-maps-places-review@latest setup --with-deps
+openclaw plugins enable yandex-maps-places-review
+openclaw plugins inspect yandex-maps-places-review --runtime --json
+```
+
+Setup-команду нужно запускать от того же Unix-пользователя, под которым работает OpenClaw Gateway: Playwright хранит Chromium в пользовательском cache. Флаг `--with-deps` устанавливает системные Linux-пакеты и может запросить `sudo`.
+
+На Windows и macOS системные Linux-пакеты не нужны:
+
+```powershell
+openclaw plugins install npm:@sharleysoft/openclaw-yandex-maps-places-review
+npx --yes @sharleysoft/openclaw-yandex-maps-places-review@latest setup
+openclaw plugins enable yandex-maps-places-review
+openclaw plugins inspect yandex-maps-places-review --runtime --json
+```
+
+Если Gateway не перезапустился автоматически, выполните:
+
+```bash
+openclaw gateway restart
+```
+
+Обновление плагина:
+
+```bash
+openclaw plugins update yandex-maps-places-review
+npx --yes @sharleysoft/openclaw-yandex-maps-places-review@latest setup --with-deps
+openclaw plugins inspect yandex-maps-places-review --runtime --json
+```
+
+После обновления setup-команда повторно проверяет и устанавливает Chromium, требуемый новой версией Playwright. На Windows и macOS используйте её без `--with-deps`.
+
+## Локальная разработка
+
+### Установка зависимостей
+
+```powershell
+npm install
+npx cross-env PLAYWRIGHT_BROWSERS_PATH=0 playwright install chromium
+```
+
+### Сборка и проверки
+
+```powershell
+npm run build
+npm run test:unit
+npm run test:live
+npm test
+npm run plugin:build
+npm run plugin:validate
+```
+
+Полная локальная проверка:
+
+```powershell
+npm run verify
+```
+
+## Использование tool
+
+Имя tool:
+
+```text
+yandex_maps_place_reviews
+```
+
+Параметры:
+
+- `url` - ссылка на заведение в Яндекс Картах.
+- `count` - необязательное количество последних отзывов, по умолчанию `100`, минимум `1`, максимум `500`.
+
+Поддерживаются как канонические ссылки вида `https://yandex.ru/maps/org/...`, так и share/POI-ссылки вида `https://yandex.com/maps/213/moscow/?mode=poi&poi%5Buri%5D=ymapsbm1%3A%2F%2Forg%3Foid%3D...&tab=reviews`.
+
+Config плагина:
+
+- `logLevel` - необязательный уровень логирования: `silent`, `error`, `warn`, `info`, `debug`.
+
+Формат результата:
+
+```json
+{
+  "sourceUrl": "https://yandex.ru/maps/org/example/123/reviews/",
+  "requestedCount": 100,
+  "fetchedAt": "2026-07-07T00:00:00.000Z",
+  "reviews": [
+    {
+      "url": "https://yandex.ru/maps/org/example/123/reviews/abc",
+      "date": "2026-07-06T12:00:00.000Z",
+      "text": "Текст отзыва"
+    }
+  ],
+  "stats": {
+    "attempts": 1,
+    "captchaReloads": 0,
+    "scrolls": 1,
+    "duplicatesSkipped": 0,
+    "logLevel": "info"
+  },
+  "warnings": []
+}
+```
+
+## Посмотреть output вручную
+
+Headless-режим:
+
+```powershell
+$env:LOG_LEVEL='silent'
+npm run run:tool -- "https://yandex.ru/maps/org/tri_vokzala_depo/168713437054/" 100
+```
+
+Видимый браузер:
+
+```powershell
+$env:HEADED='1'
+$env:LOG_LEVEL='silent'
+npm run run:tool -- "https://yandex.ru/maps/org/tri_vokzala_depo/168713437054/" 100
+```
+
+## Live-тесты
+
+Headless live-тест:
+
+```powershell
+$env:YANDEX_MAPS_PLACE_URL="https://yandex.ru/maps/org/tri_vokzala_depo/168713437054/"
+$env:YANDEX_MAPS_REVIEW_COUNT="100"
+npm run test:live
+```
+
+Live-тест с видимым браузером:
+
+```powershell
+$env:YANDEX_MAPS_PLACE_URL="https://yandex.ru/maps/org/tri_vokzala_depo/168713437054/"
+$env:YANDEX_MAPS_REVIEW_COUNT="100"
+npm run test:headed
+```
+
+После успешной проверки команда сохраняет полный JSON-результат в `artifacts/yandex-maps-reviews.headed.json`. Путь можно переопределить:
+
+```powershell
+$env:YANDEX_MAPS_OUTPUT_FILE="artifacts/my-place-reviews.json"
+npm run test:headed
+```
+
+`npm test` запускает стабильные unit/component-тесты без обращения к Яндекс Картам. Live-проверка запускается отдельно через `npm run test:live` и запрашивает минимум 60 отзывов. `YANDEX_MAPS_PLACE_URL` и `YANDEX_MAPS_REVIEW_COUNT` позволяют переопределить страницу и количество; count для live-теста должен быть от 60 до 500. Недоступность сети, CAPTCHA или изменение DOM приводят к падению live-теста.
+
+Live-тест является обязательным release gate: workflow не публикует npm-пакет и не создаёт GitHub Release, пока тест не завершится успешно.
+
+## Выпуск новой версии
+
+Release workflow запускается тегом, который должен точно совпадать с версией package и manifest:
+
+```bash
+npm version patch --no-git-tag-version
+# Обновите version в openclaw.plugin.json тем же значением.
+npm run verify
+git add package.json package-lock.json openclaw.plugin.json
+git commit -m "release: v0.1.1"
+git tag v0.1.1
+git push origin master --tags
+```
+
+Workflow на `ubuntu-latest` устанавливает Chromium, выполняет unit/component- и обязательный live-тест, валидирует manifest, устанавливает собранный `.tgz` через `npm-pack:`, публикует этот же проверенный архив в npm и только после этого создаёт GitHub Release.
+
+Для самого первого выпуска, пока npm-пакет ещё не существует, Trusted Publisher настроить нельзя. Создайте временный granular npm token с разрешением publish и bypass 2FA, сохраните его как secret `NPM_TOKEN` в GitHub environment `npm` и создайте тег `v0.1.0`. После успешного workflow:
+
+1. Настройте для npm-пакета Trusted Publisher: GitHub repository `PavelRubis/OpenClawYandexMapsPlacesReview`, workflow `release.yml`, environment `npm`, permission `npm publish`.
+2. Удалите secret `NPM_TOKEN`.
+3. В настройках npm запретите обычную token-based публикацию.
+
+Следующие версии публикуются через GitHub OIDC без постоянного npm-токена. Если live-тест упал из-за временной внешней ошибки, допускается rerun workflow. Если потребовалось изменение кода, существующий тег не переписывается — выпускается новая patch-версия.
+
+## Структура проекта
+
+- `src/Tools` - тонкие OpenClaw tool adapters.
+- `src/Application` - DTO, нормализация входа, dependency interfaces и tool call handlers.
+- `src/Infrastructure` - Playwright collector, logging и clock implementations.
+- `src/Composition` - сборка handlers и infrastructure.
+- `src/Schemas` - TypeBox-схемы config и parameters.
+- `src/Tests` - application, infrastructure, plugin и live collector tests.
+- `scripts/run-tool.ts` - ручной запуск handler-а через composition root и печать JSON output.
+
+## Ограничения
+
+- Плагин не решает CAPTCHA автоматически.
+- Если Яндекс показывает challenge/CAPTCHA, collector замедляется, перезагружает страницу и пытается продолжить после последнего найденного отзыва.
+- Если список перестал догружаться, collector возвращает уже найденные отзывы с warning.
+- DOM Яндекс Карт может меняться; обязательный live-тест обнаруживает такие изменения при каждом запуске `npm test`.
+
+## Лицензия
+
+MIT. См. [LICENSE](./LICENSE).

package/dist/Application/Dependencies/clock.d.ts

@@ -0,0 +1,3 @@
+export interface Clock {
+    now(): Date;
+}

package/dist/Application/Dependencies/clock.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clock.js.map

package/dist/Application/Dependencies/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../../src/Application/Dependencies/clock.ts"],"names":[],"mappings":""}

package/dist/Application/Dependencies/logger.d.ts

@@ -0,0 +1,8 @@
+import type { LogLevel } from "../Dtos/yandex-maps-place-reviews.dto.js";
+export interface AppLogger {
+    level: LogLevel;
+    error(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    debug(message: string, meta?: unknown): void;
+}

package/dist/Application/Dependencies/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/Application/Dependencies/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/Application/Dependencies/logger.ts"],"names":[],"mappings":""}

package/dist/Application/Dependencies/yandex-maps-review-collector.d.ts

@@ -0,0 +1,6 @@
+import type { CollectYandexMapsPlaceReviewsInputDto, GetYandexMapsPlaceReviewsOutputDto } from "../Dtos/yandex-maps-place-reviews.dto.js";
+export interface YandexMapsReviewCollector {
+    collect(input: CollectYandexMapsPlaceReviewsInputDto, options?: {
+        signal?: AbortSignal;
+    }): Promise<GetYandexMapsPlaceReviewsOutputDto>;
+}

package/dist/Application/Dependencies/yandex-maps-review-collector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=yandex-maps-review-collector.js.map

package/dist/Application/Dependencies/yandex-maps-review-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yandex-maps-review-collector.js","sourceRoot":"","sources":["../../../src/Application/Dependencies/yandex-maps-review-collector.ts"],"names":[],"mappings":""}

package/dist/Application/Dtos/yandex-maps-place-reviews.dto.d.ts

@@ -0,0 +1,33 @@
+export declare const DEFAULT_REVIEW_COUNT = 100;
+export declare const MIN_REVIEW_COUNT = 1;
+export declare const MAX_REVIEW_COUNT = 500;
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export type YandexMapsReviewDto = {
+    url?: string;
+    date: string;
+    text: string;
+};
+export type GetYandexMapsPlaceReviewsInputDto = {
+    url: string;
+    count?: number;
+    headed?: boolean;
+};
+export type CollectYandexMapsPlaceReviewsInputDto = {
+    url: string;
+    count: number;
+    headed?: boolean;
+};
+export type GetYandexMapsPlaceReviewsOutputDto = {
+    sourceUrl: string;
+    requestedCount: number;
+    fetchedAt: string;
+    reviews: YandexMapsReviewDto[];
+    stats: {
+        attempts: number;
+        captchaReloads: number;
+        scrolls: number;
+        duplicatesSkipped: number;
+        logLevel: LogLevel;
+    };
+    warnings?: string[];
+};

package/dist/Application/Dtos/yandex-maps-place-reviews.dto.js

@@ -0,0 +1,4 @@
+export const DEFAULT_REVIEW_COUNT = 100;
+export const MIN_REVIEW_COUNT = 1;
+export const MAX_REVIEW_COUNT = 500;
+//# sourceMappingURL=yandex-maps-place-reviews.dto.js.map

package/dist/Application/Dtos/yandex-maps-place-reviews.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yandex-maps-place-reviews.dto.js","sourceRoot":"","sources":["../../../src/Application/Dtos/yandex-maps-place-reviews.dto.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC"}

package/dist/Application/Normalization/normalize-yandex-maps-place-reviews-input.d.ts

@@ -0,0 +1,2 @@
+import { type CollectYandexMapsPlaceReviewsInputDto, type GetYandexMapsPlaceReviewsInputDto } from "../Dtos/yandex-maps-place-reviews.dto.js";
+export declare function normalizeYandexMapsPlaceReviewsInput(input: GetYandexMapsPlaceReviewsInputDto): CollectYandexMapsPlaceReviewsInputDto;

package/dist/Application/Normalization/normalize-yandex-maps-place-reviews-input.js

@@ -0,0 +1,81 @@
+import { DEFAULT_REVIEW_COUNT, MAX_REVIEW_COUNT, MIN_REVIEW_COUNT, } from "../Dtos/yandex-maps-place-reviews.dto.js";
+const ALLOWED_HOSTS = new Set(["yandex.ru", "yandex.com", "yandex.by", "yandex.kz", "yandex.uz"]);
+export function normalizeYandexMapsPlaceReviewsInput(input) {
+    return {
+        url: normalizeYandexMapsReviewsUrl(input.url),
+        count: normalizeReviewCount(input.count),
+        ...(input.headed === undefined ? {} : { headed: input.headed }),
+    };
+}
+function normalizeReviewCount(count) {
+    if (count === undefined) {
+        return DEFAULT_REVIEW_COUNT;
+    }
+    if (!Number.isInteger(count)) {
+        throw new Error("count must be an integer.");
+    }
+    if (count < MIN_REVIEW_COUNT || count > MAX_REVIEW_COUNT) {
+        throw new Error(`count must be between ${MIN_REVIEW_COUNT} and ${MAX_REVIEW_COUNT}.`);
+    }
+    return count;
+}
+function normalizeYandexMapsReviewsUrl(input) {
+    if (!input.trim()) {
+        throw new Error("url must not be empty.");
+    }
+    let parsed;
+    try {
+        parsed = new URL(input);
+    }
+    catch {
+        throw new Error("url must be an absolute Yandex Maps URL.");
+    }
+    const host = parsed.hostname.replace(/^www\./, "");
+    if (!ALLOWED_HOSTS.has(host) || !parsed.pathname.startsWith("/maps/")) {
+        throw new Error("url must point to a Yandex Maps place page.");
+    }
+    parsed.hash = "";
+    if (isPoiShareUrl(parsed)) {
+        parsed.searchParams.set("tab", "reviews");
+        parsed.searchParams.delete("source");
+        for (const key of [...parsed.searchParams.keys()]) {
+            if (key.toLowerCase().startsWith("utm_")) {
+                parsed.searchParams.delete(key);
+            }
+        }
+        return parsed.toString();
+    }
+    const parts = parsed.pathname.split("/").filter(Boolean);
+    if (!parts.includes("org")) {
+        throw new Error("url must point to a Yandex Maps place page.");
+    }
+    parsed.search = "";
+    const reviewsIndex = parts.indexOf("reviews");
+    if (reviewsIndex !== -1) {
+        parts.length = reviewsIndex + 1;
+    }
+    else {
+        parts.push("reviews");
+    }
+    parsed.pathname = `/${parts.join("/")}/`;
+    return parsed.toString();
+}
+function isPoiShareUrl(url) {
+    if (url.searchParams.get("mode") !== "poi") {
+        return false;
+    }
+    const poiUri = url.searchParams.get("poi[uri]");
+    if (poiUri === null) {
+        return false;
+    }
+    try {
+        const parsedPoi = new URL(poiUri);
+        return (parsedPoi.protocol === "ymapsbm1:" &&
+            parsedPoi.hostname === "org" &&
+            /^\d+$/.test(parsedPoi.searchParams.get("oid") ?? ""));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=normalize-yandex-maps-place-reviews-input.js.map

package/dist/Application/Normalization/normalize-yandex-maps-place-reviews-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-yandex-maps-place-reviews-input.js","sourceRoot":"","sources":["../../../src/Application/Normalization/normalize-yandex-maps-place-reviews-input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAGjB,MAAM,0CAA0C,CAAC;AAElD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAElG,MAAM,UAAU,oCAAoC,CAClD,KAAwC;IAExC,OAAO;QACL,GAAG,EAAE,6BAA6B,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7C,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC;QACxC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,KAAK,GAAG,gBAAgB,IAAI,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,yBAAyB,gBAAgB,QAAQ,gBAAgB,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAa;IAClD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,MAAW,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IAEjB,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,MAAM,GAAG,YAAY,GAAG,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACzC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,aAAa,CAAC,GAAQ;IAC7B,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CACL,SAAS,CAAC,QAAQ,KAAK,WAAW;YAClC,SAAS,CAAC,QAAQ,KAAK,KAAK;YAC5B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CACtD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/Application/ToolCallHandlers/get-yandex-maps-place-reviews-tool-call-handler.d.ts

@@ -0,0 +1,13 @@
+import type { Clock } from "../Dependencies/clock.js";
+import type { AppLogger } from "../Dependencies/logger.js";
+import type { YandexMapsReviewCollector } from "../Dependencies/yandex-maps-review-collector.js";
+import type { GetYandexMapsPlaceReviewsInputDto, GetYandexMapsPlaceReviewsOutputDto } from "../Dtos/yandex-maps-place-reviews.dto.js";
+export declare class GetYandexMapsPlaceReviewsToolCallHandler {
+    private readonly collector;
+    private readonly clock;
+    private readonly logger;
+    constructor(collector: YandexMapsReviewCollector, clock: Clock, logger: AppLogger);
+    handle(input: GetYandexMapsPlaceReviewsInputDto, options?: {
+        signal?: AbortSignal;
+    }): Promise<GetYandexMapsPlaceReviewsOutputDto>;
+}

package/dist/Application/ToolCallHandlers/get-yandex-maps-place-reviews-tool-call-handler.js

@@ -0,0 +1,24 @@
+import { normalizeYandexMapsPlaceReviewsInput } from "../Normalization/normalize-yandex-maps-place-reviews-input.js";
+export class GetYandexMapsPlaceReviewsToolCallHandler {
+    collector;
+    clock;
+    logger;
+    constructor(collector, clock, logger) {
+        this.collector = collector;
+        this.clock = clock;
+        this.logger = logger;
+    }
+    async handle(input, options) {
+        options?.signal?.throwIfAborted();
+        const normalizedInput = normalizeYandexMapsPlaceReviewsInput(input);
+        this.logger.info("Handling Yandex Maps reviews tool call.", {
+            count: normalizedInput.count,
+            headed: Boolean(normalizedInput.headed),
+            requestedAt: this.clock.now().toISOString(),
+        });
+        return this.collector.collect(normalizedInput, {
+            signal: options?.signal,
+        });
+    }
+}
+//# sourceMappingURL=get-yandex-maps-place-reviews-tool-call-handler.js.map

package/dist/Application/ToolCallHandlers/get-yandex-maps-place-reviews-tool-call-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-yandex-maps-place-reviews-tool-call-handler.js","sourceRoot":"","sources":["../../../src/Application/ToolCallHandlers/get-yandex-maps-place-reviews-tool-call-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oCAAoC,EAAE,MAAM,+DAA+D,CAAC;AAErH,MAAM,OAAO,wCAAwC;IAEhC;IACA;IACA;IAHnB,YACmB,SAAoC,EACpC,KAAY,EACZ,MAAiB;QAFjB,cAAS,GAAT,SAAS,CAA2B;QACpC,UAAK,GAAL,KAAK,CAAO;QACZ,WAAM,GAAN,MAAM,CAAW;IACjC,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,KAAwC,EACxC,OAEC;QAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAElC,MAAM,eAAe,GAAG,oCAAoC,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;YAC1D,KAAK,EAAE,eAAe,CAAC,KAAK;YAC5B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;YACvC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SAC5C,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3B,eAAe,EACf;YACE,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/Cli/setup-playwright-command.d.ts

@@ -0,0 +1,7 @@
+export type SetupCommand = {
+    showHelp: boolean;
+    playwrightArgs: string[];
+    withDepsIgnored: boolean;
+};
+export declare function createSetupCommand(args: string[], platform?: NodeJS.Platform): SetupCommand;
+export declare function runSetup(args?: string[], platform?: NodeJS.Platform): number;

package/dist/Cli/setup-playwright-command.js

@@ -0,0 +1,66 @@
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+export function createSetupCommand(args, platform = process.platform) {
+    if (args.includes("--help") || args.includes("-h")) {
+        return { showHelp: true, playwrightArgs: [], withDepsIgnored: false };
+    }
+    const [command, ...options] = args;
+    if (command !== "setup") {
+        throw new Error('Expected the command "setup".');
+    }
+    const supportedOptions = new Set(["--with-deps"]);
+    const unsupportedOption = options.find((option) => !supportedOptions.has(option));
+    if (unsupportedOption !== undefined) {
+        throw new Error(`Unknown setup option: ${unsupportedOption}`);
+    }
+    const withDeps = options.includes("--with-deps");
+    const installSystemDependencies = withDeps && platform === "linux";
+    return {
+        showHelp: false,
+        playwrightArgs: ["install", ...(installSystemDependencies ? ["--with-deps"] : []), "chromium"],
+        withDepsIgnored: withDeps && !installSystemDependencies,
+    };
+}
+export function runSetup(args = process.argv.slice(2), platform = process.platform) {
+    let command;
+    try {
+        command = createSetupCommand(args, platform);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        printUsage();
+        return 2;
+    }
+    if (command.showHelp) {
+        printUsage();
+        return 0;
+    }
+    if (command.withDepsIgnored) {
+        console.info("--with-deps installs OS packages only on Linux; continuing with the Chromium installation.");
+    }
+    const require = createRequire(import.meta.url);
+    const playwrightPackageJson = require.resolve("playwright/package.json");
+    const playwrightCli = join(dirname(playwrightPackageJson), "cli.js");
+    const result = spawnSync(process.execPath, [playwrightCli, ...command.playwrightArgs], {
+        stdio: "inherit",
+    });
+    if (result.error !== undefined) {
+        console.error(`Could not start Playwright: ${result.error.message}`);
+        return 1;
+    }
+    if (result.signal !== null) {
+        console.error(`Playwright was terminated by ${result.signal}.`);
+        return 1;
+    }
+    return result.status ?? 1;
+}
+function printUsage() {
+    console.info(`Usage:
+  openclaw-yandex-maps-places-review setup [--with-deps]
+
+Options:
+  --with-deps  Install required OS packages on Linux before installing Chromium.
+  --help       Show this help.`);
+}
+//# sourceMappingURL=setup-playwright-command.js.map

package/dist/Cli/setup-playwright-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-playwright-command.js","sourceRoot":"","sources":["../../src/Cli/setup-playwright-command.ts"],"names":[],"mappings":"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"}

package/dist/Cli/setup-playwright.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/Cli/setup-playwright.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runSetup } from "./setup-playwright-command.js";
+process.exitCode = runSetup();
+//# sourceMappingURL=setup-playwright.js.map

package/dist/Cli/setup-playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-playwright.js","sourceRoot":"","sources":["../../src/Cli/setup-playwright.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD,OAAO,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC"}

package/dist/Composition/create-tool-call-handlers.d.ts

@@ -0,0 +1,8 @@
+import type { LogLevel } from "../Application/Dtos/yandex-maps-place-reviews.dto.js";
+import { GetYandexMapsPlaceReviewsToolCallHandler } from "../Application/ToolCallHandlers/get-yandex-maps-place-reviews-tool-call-handler.js";
+export type PluginConfig = {
+    logLevel?: LogLevel;
+};
+export declare function createToolCallHandlers(config?: PluginConfig): {
+    getYandexMapsPlaceReviews: GetYandexMapsPlaceReviewsToolCallHandler;
+};

package/dist/Composition/create-tool-call-handlers.js

@@ -0,0 +1,22 @@
+import { GetYandexMapsPlaceReviewsToolCallHandler } from "../Application/ToolCallHandlers/get-yandex-maps-place-reviews-tool-call-handler.js";
+import { SystemClock } from "../Infrastructure/Clock/system-clock.js";
+import { PinoAppLogger } from "../Infrastructure/Logging/pino-app-logger.js";
+import { PlaywrightYandexMapsReviewCollector } from "../Infrastructure/YandexMaps/playwright-yandex-maps-review-collector.js";
+import { PlaywrightYandexMapsReviewNavigator } from "../Infrastructure/YandexMaps/playwright-yandex-maps-review-navigator.js";
+import { PlaywrightYandexMapsReviewParser } from "../Infrastructure/YandexMaps/playwright-yandex-maps-review-parser.js";
+export function createToolCallHandlers(config = {}) {
+    const logger = new PinoAppLogger(config.logLevel ?? "info");
+    const clock = new SystemClock();
+    const navigator = new PlaywrightYandexMapsReviewNavigator(logger);
+    const parser = new PlaywrightYandexMapsReviewParser();
+    const collector = new PlaywrightYandexMapsReviewCollector({
+        logger,
+        clock,
+        navigator,
+        parser,
+    });
+    return {
+        getYandexMapsPlaceReviews: new GetYandexMapsPlaceReviewsToolCallHandler(collector, clock, logger),
+    };
+}
+//# sourceMappingURL=create-tool-call-handlers.js.map

package/dist/Composition/create-tool-call-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tool-call-handlers.js","sourceRoot":"","sources":["../../src/Composition/create-tool-call-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wCAAwC,EAAE,MAAM,oFAAoF,CAAC;AAC9I,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,mCAAmC,EAAE,MAAM,yEAAyE,CAAC;AAC9H,OAAO,EAAE,mCAAmC,EAAE,MAAM,yEAAyE,CAAC;AAC9H,OAAO,EAAE,gCAAgC,EAAE,MAAM,sEAAsE,CAAC;AAMxH,MAAM,UAAU,sBAAsB,CAAC,SAAuB,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,mCAAmC,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,gCAAgC,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,mCAAmC,CAAC;QACxD,MAAM;QACN,KAAK;QACL,SAAS;QACT,MAAM;KACP,CAAC,CAAC;IAEH,OAAO;QACL,yBAAyB,EAAE,IAAI,wCAAwC,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC;KAClG,CAAC;AACJ,CAAC"}

package/dist/Infrastructure/Clock/system-clock.d.ts

@@ -0,0 +1,4 @@
+import type { Clock } from "../../Application/Dependencies/clock.js";
+export declare class SystemClock implements Clock {
+    now(): Date;
+}

package/dist/Infrastructure/Clock/system-clock.js

@@ -0,0 +1,6 @@
+export class SystemClock {
+    now() {
+        return new Date();
+    }
+}
+//# sourceMappingURL=system-clock.js.map

package/dist/Infrastructure/Clock/system-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-clock.js","sourceRoot":"","sources":["../../../src/Infrastructure/Clock/system-clock.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB,GAAG;QACD,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}