@ykurilov/agent-chat-videos 0.0.0-stage → 0.55.0

package/CHANGELOG.md

@@ -0,0 +1,369 @@
+# @ykurilov/agent-chat-videos
+
+## 0.55.0
+
+### Patch Changes
+
+- Updated dependencies [cdc7dd7]
+  - @ykurilov/agent-chat-react@0.55.0
+
+## 0.54.0
+
+### Patch Changes
+
+- Updated dependencies [c8fb0dd]
+- Updated dependencies [73d3aaa]
+  - @ykurilov/agent-chat-react@0.54.0
+
+## 0.53.0
+
+### Patch Changes
+
+- Updated dependencies [b6a7786]
+  - @ykurilov/agent-chat-react@0.53.0
+
+## 0.52.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.52.0
+
+## 0.51.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.51.0
+
+## 0.50.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.50.0
+
+## 0.49.0
+
+### Patch Changes
+
+- Updated dependencies [084cef7]
+  - @ykurilov/agent-chat-react@0.49.0
+
+## 0.48.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.48.0
+
+## 0.47.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.47.0
+
+## 0.46.2
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.46.2
+
+## 0.46.1
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.46.1
+
+## 0.46.0
+
+### Patch Changes
+
+- Updated dependencies [56d7528]
+  - @ykurilov/agent-chat-react@0.46.0
+
+## 0.45.0
+
+### Patch Changes
+
+- Updated dependencies [eb74c58]
+- Updated dependencies [ac9aede]
+  - @ykurilov/agent-chat-react@0.45.0
+
+## 0.44.0
+
+### Patch Changes
+
+- Updated dependencies [6a2b5d9]
+  - @ykurilov/agent-chat-react@0.44.0
+
+## 0.43.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.43.0
+
+## 0.42.0
+
+### Patch Changes
+
+- Updated dependencies [a385276]
+  - @ykurilov/agent-chat-react@0.42.0
+
+## 0.41.0
+
+### Patch Changes
+
+- Updated dependencies [9472fcb]
+  - @ykurilov/agent-chat-react@0.41.0
+
+## 0.40.0
+
+### Patch Changes
+
+- Updated dependencies [0e7aab3]
+  - @ykurilov/agent-chat-react@0.40.0
+
+## 0.39.1
+
+### Patch Changes
+
+- Updated dependencies [5c0f3af]
+  - @ykurilov/agent-chat-react@0.39.1
+
+## 0.39.0
+
+### Patch Changes
+
+- Updated dependencies [3b90429]
+  - @ykurilov/agent-chat-react@0.39.0
+
+## 0.38.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.38.0
+
+## 0.37.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.37.0
+
+## 0.36.0
+
+### Patch Changes
+
+- Updated dependencies [3487fb4]
+- Updated dependencies [5f13c74]
+  - @ykurilov/agent-chat-react@0.36.0
+
+## 0.35.0
+
+### Patch Changes
+
+- Updated dependencies [6ceee78]
+  - @ykurilov/agent-chat-react@0.35.0
+
+## 0.34.0
+
+### Patch Changes
+
+- Updated dependencies [d039ce4]
+  - @ykurilov/agent-chat-react@0.34.0
+
+## 0.33.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.33.0
+
+## 0.32.0
+
+### Patch Changes
+
+- Updated dependencies [4087a22]
+  - @ykurilov/agent-chat-react@0.32.0
+
+## 0.31.2
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.31.2
+
+## 0.31.1
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.31.1
+
+## 0.31.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.31.0
+
+## 0.30.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.30.0
+
+## 0.29.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.29.0
+
+## 0.28.0
+
+### Patch Changes
+
+- Updated dependencies [d63ccaa]
+- Updated dependencies [189cba9]
+  - @ykurilov/agent-chat-react@0.28.0
+
+## 0.27.0
+
+### Patch Changes
+
+- Updated dependencies [5e4ed28]
+- Updated dependencies [e0bb519]
+  - @ykurilov/agent-chat-react@0.27.0
+
+## 0.26.2
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.26.2
+
+## 0.26.1
+
+### Patch Changes
+
+- Updated dependencies [5b52515]
+  - @ykurilov/agent-chat-react@0.26.1
+
+## 0.26.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.26.0
+
+## 0.25.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.25.0
+
+## 0.24.0
+
+### Patch Changes
+
+- Updated dependencies [9b895cd]
+  - @ykurilov/agent-chat-react@0.24.0
+
+## 0.23.0
+
+### Patch Changes
+
+- Updated dependencies [30fb729]
+  - @ykurilov/agent-chat-react@0.23.0
+
+## 0.22.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.22.0
+
+## 0.21.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.21.0
+
+## 0.20.0
+
+### Patch Changes
+
+- Updated dependencies [fd16b01]
+  - @ykurilov/agent-chat-react@0.20.0
+
+## 0.19.0
+
+### Patch Changes
+
+- Updated dependencies [aa0fd51]
+- Updated dependencies [6f26b93]
+  - @ykurilov/agent-chat-react@0.19.0
+
+## 0.18.6
+
+### Patch Changes
+
+- c688091: Встроенный поиск `searchVideos(videos, query)` экспортируется из корня пакета: приложение со списком роликов в базе зовёт его из `source.search`.
+- @ykurilov/agent-chat-react@0.18.6
+
+## 0.18.5
+
+### Patch Changes
+
+- Updated dependencies [56b9ab6]
+  - @ykurilov/agent-chat-react@0.18.5
+
+## 0.18.4
+
+### Patch Changes
+
+- @ykurilov/agent-chat-react@0.18.4
+
+## 0.18.3
+
+### Patch Changes
+
+- Updated dependencies [ce3c26f]
+  - @ykurilov/agent-chat-react@0.18.3
+
+## 0.18.2
+
+### Patch Changes
+
+- Updated dependencies [7e7e966]
+  - @ykurilov/agent-chat-react@0.18.2
+
+## 0.18.1
+
+### Patch Changes
+
+- Updated dependencies [179ad9d]
+  - @ykurilov/agent-chat-react@0.18.1
+
+## 0.18.0
+
+### Patch Changes
+
+- Updated dependencies [43d7ebe]
+  - @ykurilov/agent-chat-react@0.18.0
+
+## 0.17.0
+
+### Minor Changes
+
+- e5d0860: Видео от агента: новый пакет `@ykurilov/agent-chat-videos`. Агент находит видео в каталоге приложения (`find_videos`) и
+  присылает карточкой (`show_video`), можно с нужной минуты. По нажатию плеер YouTube (`youtube-nocookie.com`) или Kinescope
+  играет в ленте, есть «На весь экран». До нажатия к площадкам не уходит ни одного запроса.
+  
+  - сервер: `createVideoLibrary({ videos })` или `({ source: { search, get } })`, `videos.tools(model)` в `agent.tools`;
+  - страница: `videos={videosClient}` у `AgentChat`, `ChatWorkspace` и `AgentPanel`;
+  - договор скина версии 14: необязательная часть `AgentVideo` (`AgentVideoView`); скин без неё показывает видео ссылкой;
+  - надписи `videos.play`, `videos.from`, `videos.fullscreen` и `voice.videoOnScreen` («видео на экране» в голосовом режиме).
+  
+  Подробно: `docs/videos.md`.
+  
+  ### Как обновить приложение
+  
+  Обычному приложению делать ничего не нужно: видео включается отдельно, миграций нет.
+  
+  1. Полный словарь надписей, написанный вручную без `{ ...russianLabels }`, — добавьте `voice.videoOnScreen`.
+  2. Проверка: `pnpm typecheck`, затем в чате отправить сообщение и получить ответ.
+
+### Patch Changes
+
+- Updated dependencies [e5d0860]
+  - @ykurilov/agent-chat-react@0.17.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,40 @@
-# Temporary Holding Version
+# @ykurilov/agent-chat-videos
 
-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.
+Видео от агента: инструменты `find_videos` и `show_video` поверх каталога приложения (YouTube и Kinescope), карточка
+с плеером в ленте. Отдельное расширение: приложению без видео пакет не нужен.
+
+Серверу без экрана React не нужен: `react` и `@ykurilov/agent-chat-react` — необязательные зависимости (peer). Для
+`@ykurilov/agent-chat-videos/react` оба должны стоять в приложении.
+
+## Сервер
+
+```ts
+import { createVideoLibrary } from "@ykurilov/agent-chat-videos";
+
+const videos = createVideoLibrary({
+  videos: [{ id: "intro", title: "Вводный урок", url: "https://youtu.be/aircAruvnKk", durationSeconds: 1153 }],
+  // или source: { search(query, { ownerId, chatId }), get(id, { ownerId, chatId }) } — для большой базы
+});
+
+createChatHandler({
+  …,
+  agent: { tools: (model) => ({ ...appTools(model), ...videos.tools(model) }) },
+});
+```
+
+- Модель ищет через `find_videos` (до 8 результатов, с главами) и показывает через `show_video` по id. Чужой id — отказ.
+- Можно начать с нужной секунды (`startSeconds`), на карточке — «с 3:20».
+- Описания инструментов постоянные: кэш модели не зависит от каталога.
+
+## Экран
+
+```tsx
+import { videosClient } from "@ykurilov/agent-chat-videos/react";
+
+<AgentChat … videos={videosClient} />
+```
+
+Скину нужен `AgentVideo` (договор скина, версия 14); в Тандеме он есть. Без него видео показано ссылкой в тексте ответа,
+без `videos` — обычной строкой инструмента. До нажатия к площадкам не уходит ни одного запроса.
+
+Подробно — [docs/videos.md](../../docs/videos.md). Живая проверка: `pnpm test:live videos`.

package/dist/chunk-UROHGMNR.js

@@ -0,0 +1,139 @@
+// src/time-label.ts
+var twoDigits = (value) => String(value).padStart(2, "0");
+function timeLabel(seconds) {
+  const whole = Math.max(0, Math.floor(seconds));
+  const hours = Math.floor(whole / 3600);
+  const minutes = Math.floor(whole % 3600 / 60);
+  const rest = whole % 60;
+  return hours > 0 ? `${hours}:${twoDigits(minutes)}:${twoDigits(rest)}` : `${minutes}:${twoDigits(rest)}`;
+}
+
+// src/video-address.ts
+var validCode = {
+  youtube: /^[A-Za-z0-9_-]{11}$/,
+  kinescope: /^[A-Za-z0-9_-]{4,64}$/
+};
+var kinescopeServicePages = /* @__PURE__ */ new Set([
+  "about",
+  "account",
+  "admin",
+  "api",
+  "app",
+  "assets",
+  "auth",
+  "blog",
+  "careers",
+  "cases",
+  "company",
+  "contacts",
+  "dashboard",
+  "developers",
+  "docs",
+  "education",
+  "embed",
+  "en",
+  "enterprise",
+  "faq",
+  "features",
+  "help",
+  "home",
+  "integrations",
+  "jobs",
+  "legal",
+  "live",
+  "login",
+  "logout",
+  "news",
+  "oauth",
+  "offer",
+  "partners",
+  "player",
+  "policy",
+  "pricing",
+  "privacy",
+  "product",
+  "register",
+  "ru",
+  "security",
+  "settings",
+  "signin",
+  "signup",
+  "solutions",
+  "static",
+  "status",
+  "support",
+  "team",
+  "terms",
+  "upload",
+  "video",
+  "videos",
+  "watch"
+]);
+var youtubeHosts = /* @__PURE__ */ new Set(["youtube.com", "www.youtube.com", "m.youtube.com", "youtube-nocookie.com", "www.youtube-nocookie.com"]);
+var youtubePathPrefixes = /* @__PURE__ */ new Set(["embed", "shorts", "live", "v"]);
+var kinescopeHosts = /* @__PURE__ */ new Set(["kinescope.io", "www.kinescope.io"]);
+function isVideoAddress(value) {
+  const address = value;
+  if (typeof address?.code !== "string" || address.provider !== "youtube" && address.provider !== "kinescope") return false;
+  if (address.provider === "kinescope" && kinescopeServicePages.has(address.code.toLowerCase())) return false;
+  return validCode[address.provider].test(address.code);
+}
+var ROOT_CHECK_ORIGIN = "https://x.invalid";
+function isPosterAddress(value) {
+  if (typeof value !== "string" || /[\\\s\u0000-\u001f\u007f]|%2f|%5c/i.test(value)) return false;
+  try {
+    if (value.startsWith("/")) return new URL(value, ROOT_CHECK_ORIGIN).origin === ROOT_CHECK_ORIGIN;
+    return new URL(value).protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function checked(provider, code) {
+  const address = { provider, code: code ?? "" };
+  return isVideoAddress(address) ? address : void 0;
+}
+function parseVideoUrl(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return void 0;
+  }
+  if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return void 0;
+  const host = parsed.hostname.toLowerCase();
+  const segments = parsed.pathname.split("/").filter(Boolean);
+  if (host === "youtu.be") return segments.length === 1 ? checked("youtube", segments[0]) : void 0;
+  if (youtubeHosts.has(host)) {
+    if (segments.length === 1 && segments[0] === "watch") return checked("youtube", parsed.searchParams.get("v"));
+    if (segments.length === 2 && youtubePathPrefixes.has(segments[0])) return checked("youtube", segments[1]);
+    return void 0;
+  }
+  if (kinescopeHosts.has(host)) {
+    if (segments.length === 1 && segments[0] !== "embed") return checked("kinescope", segments[0]);
+    if (segments.length === 2 && segments[0] === "embed") return checked("kinescope", segments[1]);
+  }
+  return void 0;
+}
+var startSecond = (startSeconds) => startSeconds !== void 0 && Number.isInteger(startSeconds) && startSeconds > 0 ? startSeconds : void 0;
+function embedUrl(address, startSeconds) {
+  const start = startSecond(startSeconds);
+  if (address.provider === "youtube") {
+    return `https://www.youtube-nocookie.com/embed/${address.code}?autoplay=1&playsinline=1&rel=0${start ? `&start=${start}` : ""}`;
+  }
+  return `https://kinescope.io/embed/${address.code}?autoplay=1&playsinline=1${start ? `&t=${start}` : ""}`;
+}
+function watchUrl(address, startSeconds) {
+  const start = startSecond(startSeconds);
+  if (address.provider === "youtube") return `https://www.youtube.com/watch?v=${address.code}${start ? `&t=${start}s` : ""}`;
+  return `https://kinescope.io/${address.code}${start ? `?t=${start}` : ""}`;
+}
+
+export {
+  timeLabel,
+  isVideoAddress,
+  isPosterAddress,
+  parseVideoUrl,
+  embedUrl,
+  watchUrl
+};
+//# sourceMappingURL=chunk-UROHGMNR.js.map

package/dist/chunk-UROHGMNR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/time-label.ts","../src/video-address.ts"],"sourcesContent":["const twoDigits = (value: number) => String(value).padStart(2, \"0\");\n\n/** Секунды словами часов: 200 → «3:20», 3725 → «1:02:05». */\nexport function timeLabel(seconds: number): string {\n  const whole = Math.max(0, Math.floor(seconds));\n  const hours = Math.floor(whole / 3600);\n  const minutes = Math.floor((whole % 3600) / 60);\n  const rest = whole % 60;\n  return hours > 0 ? `${hours}:${twoDigits(minutes)}:${twoDigits(rest)}` : `${minutes}:${twoDigits(rest)}`;\n}\n","// Адрес видео — площадка и код. Из них, а не из ссылки целиком, собираются адреса плеера и страницы:\n// подделанная запись не превратится в чужой iframe.\n\nexport type VideoProvider = \"youtube\" | \"kinescope\";\n\nexport interface VideoAddress {\n  provider: VideoProvider;\n  code: string;\n}\n\nconst validCode: Record<VideoProvider, RegExp> = {\n  youtube: /^[A-Za-z0-9_-]{11}$/,\n  kinescope: /^[A-Za-z0-9_-]{4,64}$/,\n};\n\n/** Служебные страницы kinescope.io — по форме похожи на код видео, но видео не являются. */\nconst kinescopeServicePages = new Set([\n  \"about\", \"account\", \"admin\", \"api\", \"app\", \"assets\", \"auth\", \"blog\", \"careers\", \"cases\", \"company\", \"contacts\", \"dashboard\",\n  \"developers\", \"docs\", \"education\", \"embed\", \"en\", \"enterprise\", \"faq\", \"features\", \"help\", \"home\", \"integrations\", \"jobs\",\n  \"legal\", \"live\", \"login\", \"logout\", \"news\", \"oauth\", \"offer\", \"partners\", \"player\", \"policy\", \"pricing\", \"privacy\", \"product\",\n  \"register\", \"ru\", \"security\", \"settings\", \"signin\", \"signup\", \"solutions\", \"static\", \"status\", \"support\", \"team\", \"terms\",\n  \"upload\", \"video\", \"videos\", \"watch\",\n]);\n\nconst youtubeHosts = new Set([\"youtube.com\", \"www.youtube.com\", \"m.youtube.com\", \"youtube-nocookie.com\", \"www.youtube-nocookie.com\"]);\nconst youtubePathPrefixes = new Set([\"embed\", \"shorts\", \"live\", \"v\"]);\nconst kinescopeHosts = new Set([\"kinescope.io\", \"www.kinescope.io\"]);\n\n/** Площадка известна, код — только из допустимых знаков. */\nexport function isVideoAddress(value: unknown): value is VideoAddress {\n  const address = value as Partial<VideoAddress> | null;\n  if (typeof address?.code !== \"string\" || (address.provider !== \"youtube\" && address.provider !== \"kinescope\")) return false;\n  if (address.provider === \"kinescope\" && kinescopeServicePages.has(address.code.toLowerCase())) return false;\n  return validCode[address.provider].test(address.code);\n}\n\nconst ROOT_CHECK_ORIGIN = \"https://x.invalid\";\n\n/**\n * Обложка — `https://…` или путь от корня своего сайта. Браузер читает `/\\evil`, `/<таб>/evil` как `//evil` — чужой хост,\n * поэтому путь разбирается как адрес и обязан остаться на своём хосте; `\\`, пробелы, управляющие знаки и закодированные\n * косые не допускаются вовсе.\n */\nexport function isPosterAddress(value: unknown): value is string {\n  if (typeof value !== \"string\" || /[\\\\\\s\\u0000-\\u001f\\u007f]|%2f|%5c/i.test(value)) return false;\n  try {\n    if (value.startsWith(\"/\")) return new URL(value, ROOT_CHECK_ORIGIN).origin === ROOT_CHECK_ORIGIN;\n    return new URL(value).protocol === \"https:\";\n  } catch {\n    return false;\n  }\n}\n\nfunction checked(provider: VideoProvider, code: string | null | undefined): VideoAddress | undefined {\n  const address = { provider, code: code ?? \"\" };\n  return isVideoAddress(address) ? address : undefined;\n}\n\n/** Ссылка YouTube (watch, youtu.be, embed, shorts, live) или Kinescope (`/<код>`, `/embed/<код>`) → площадка и код. */\nexport function parseVideoUrl(url: string): VideoAddress | undefined {\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return undefined;\n  }\n  if (parsed.protocol !== \"https:\" && parsed.protocol !== \"http:\") return undefined;\n  const host = parsed.hostname.toLowerCase();\n  const segments = parsed.pathname.split(\"/\").filter(Boolean);\n\n  if (host === \"youtu.be\") return segments.length === 1 ? checked(\"youtube\", segments[0]) : undefined;\n  if (youtubeHosts.has(host)) {\n    if (segments.length === 1 && segments[0] === \"watch\") return checked(\"youtube\", parsed.searchParams.get(\"v\"));\n    if (segments.length === 2 && youtubePathPrefixes.has(segments[0]!)) return checked(\"youtube\", segments[1]);\n    return undefined;\n  }\n  if (kinescopeHosts.has(host)) {\n    if (segments.length === 1 && segments[0] !== \"embed\") return checked(\"kinescope\", segments[0]);\n    if (segments.length === 2 && segments[0] === \"embed\") return checked(\"kinescope\", segments[1]);\n  }\n  return undefined;\n}\n\nconst startSecond = (startSeconds: number | undefined) =>\n  startSeconds !== undefined && Number.isInteger(startSeconds) && startSeconds > 0 ? startSeconds : undefined;\n\n/** Адрес встроенного плеера: YouTube — с youtube-nocookie.com; оба с автозапуском (грузится по нажатию) и стартом. */\nexport function embedUrl(address: VideoAddress, startSeconds?: number): string {\n  const start = startSecond(startSeconds);\n  if (address.provider === \"youtube\") {\n    return `https://www.youtube-nocookie.com/embed/${address.code}?autoplay=1&playsinline=1&rel=0${start ? `&start=${start}` : \"\"}`;\n  }\n  return `https://kinescope.io/embed/${address.code}?autoplay=1&playsinline=1${start ? `&t=${start}` : \"\"}`;\n}\n\n/** Адрес страницы видео на площадке — для ссылки, когда скин не умеет карточку. */\nexport function watchUrl(address: VideoAddress, startSeconds?: number): string {\n  const start = startSecond(startSeconds);\n  if (address.provider === \"youtube\") return `https://www.youtube.com/watch?v=${address.code}${start ? `&t=${start}s` : \"\"}`;\n  return `https://kinescope.io/${address.code}${start ? `?t=${start}` : \"\"}`;\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -0,0 +1,203 @@
+import {
+  embedUrl,
+  isPosterAddress,
+  isVideoAddress,
+  parseVideoUrl,
+  timeLabel,
+  watchUrl
+} from "./chunk-UROHGMNR.js";
+
+// src/create-video-library.ts
+import { tool } from "ai";
+import { z } from "zod";
+
+// src/video-catalog.ts
+var MAX_ID_LENGTH = 200;
+var MAX_FOUND = 8;
+var isText = (value) => typeof value === "string" && value.trim() !== "";
+function checkVideoEntry(entry) {
+  if (typeof entry?.id !== "string" || entry.id === "" || entry.id.length > MAX_ID_LENGTH) return "id \u0434\u043E\u043B\u0436\u0435\u043D \u0431\u044B\u0442\u044C \u0441\u0442\u0440\u043E\u043A\u043E\u0439 \u043E\u0442 1 \u0434\u043E 200 \u0437\u043D\u0430\u043A\u043E\u0432";
+  if (!isText(entry.title)) return "\u043F\u0443\u0441\u0442\u043E\u0435 \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435";
+  if (typeof entry.url !== "string" || !parseVideoUrl(entry.url)) return "\u0441\u0441\u044B\u043B\u043A\u0430 \u043D\u0435 \u043D\u0430 YouTube \u0438 \u043D\u0435 \u043D\u0430 Kinescope";
+  if (entry.description !== void 0 && typeof entry.description !== "string") return "\u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0435 \u043D\u0435 \u0441\u0442\u0440\u043E\u043A\u0430";
+  const duration = entry.durationSeconds;
+  if (duration !== void 0 && (!Number.isInteger(duration) || duration <= 0)) return "\u0434\u043B\u0438\u0442\u0435\u043B\u044C\u043D\u043E\u0441\u0442\u044C \u0434\u043E\u043B\u0436\u043D\u0430 \u0431\u044B\u0442\u044C \u0446\u0435\u043B\u044B\u043C \u0447\u0438\u0441\u043B\u043E\u043C \u0441\u0435\u043A\u0443\u043D\u0434 \u0431\u043E\u043B\u044C\u0448\u0435 \u043D\u0443\u043B\u044F";
+  if (entry.poster !== void 0 && !isPosterAddress(entry.poster)) {
+    return "\u043E\u0431\u043B\u043E\u0436\u043A\u0430 \u0434\u043E\u043B\u0436\u043D\u0430 \u0431\u044B\u0442\u044C \u0430\u0434\u0440\u0435\u0441\u043E\u043C https:// \u0438\u043B\u0438 \u043F\u0443\u0442\u0451\u043C \u043E\u0442 \u043A\u043E\u0440\u043D\u044F \u0441\u0430\u0439\u0442\u0430 \xAB/\u2026\xBB";
+  }
+  if (entry.chapters !== void 0) {
+    if (!Array.isArray(entry.chapters)) return "\u0433\u043B\u0430\u0432\u044B \u0434\u043E\u043B\u0436\u043D\u044B \u0431\u044B\u0442\u044C \u0441\u043F\u0438\u0441\u043A\u043E\u043C";
+    for (const chapter of entry.chapters) {
+      if (!isText(chapter?.title)) return "\u0433\u043B\u0430\u0432\u0430 \u0431\u0435\u0437 \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u044F";
+      const start = chapter.startSeconds;
+      if (!Number.isInteger(start) || start < 0) return "\u043D\u0430\u0447\u0430\u043B\u043E \u0433\u043B\u0430\u0432\u044B \u0434\u043E\u043B\u0436\u043D\u043E \u0431\u044B\u0442\u044C \u0446\u0435\u043B\u044B\u043C \u0447\u0438\u0441\u043B\u043E\u043C \u0441\u0435\u043A\u0443\u043D\u0434 \u043E\u0442 \u043D\u0443\u043B\u044F";
+      if (duration !== void 0 && start >= duration) return "\u0433\u043B\u0430\u0432\u0430 \u043D\u0430\u0447\u0438\u043D\u0430\u0435\u0442\u0441\u044F \u0437\u0430 \u043A\u043E\u043D\u0446\u043E\u043C \u0432\u0438\u0434\u0435\u043E";
+    }
+  }
+  return void 0;
+}
+function checkVideoCatalog(videos) {
+  const seen = /* @__PURE__ */ new Set();
+  videos.forEach((video, index) => {
+    const reason = checkVideoEntry(video);
+    const name = typeof video?.id === "string" && video.id !== "" ? `\xAB${video.id}\xBB` : `\u2116${index + 1}`;
+    if (reason) throw new Error(`\u041A\u0430\u0442\u0430\u043B\u043E\u0433 \u0432\u0438\u0434\u0435\u043E: \u0437\u0430\u043F\u0438\u0441\u044C ${name} \u2014 ${reason}.`);
+    if (seen.has(video.id)) throw new Error(`\u041A\u0430\u0442\u0430\u043B\u043E\u0433 \u0432\u0438\u0434\u0435\u043E: id ${name} \u043F\u043E\u0432\u0442\u043E\u0440\u044F\u0435\u0442\u0441\u044F.`);
+    seen.add(video.id);
+  });
+}
+var serviceWords = new Set(
+  "\u0432\u0438\u0434\u0435\u043E \u0440\u043E\u043B\u0438\u043A \u0440\u043E\u043B\u0438\u043A\u0430 \u0440\u043E\u043B\u0438\u043A\u0438 \u0440\u043E\u043B\u0438\u043A\u043E\u0432 \u0443\u0440\u043E\u043A \u0443\u0440\u043E\u043A\u0430 \u0443\u0440\u043E\u043A\u0438 \u0443\u0440\u043E\u043A\u0443 \u0443\u0440\u043E\u043A\u043E\u043C \u0443\u0440\u043E\u043A\u043E\u0432 \u043B\u0435\u043A\u0446\u0438\u044F \u043B\u0435\u043A\u0446\u0438\u0438 \u043B\u0435\u043A\u0446\u0438\u044E \u043B\u0435\u043A\u0446\u0438\u0439 \u043F\u0440\u043E \u043A\u0430\u043A \u0447\u0442\u043E \u044D\u0442\u043E \u0434\u043B\u044F \u0438\u043B\u0438 \u043D\u0430 \u043F\u043E \u0438\u0437 \u043E\u0442".split(" ")
+);
+var words = (text) => text.toLowerCase().replaceAll("\u0451", "\u0435").split(/[^\p{L}\p{N}]+/u).filter((word) => word.length >= 2);
+var stem = (word) => word.length > 5 ? word.slice(0, 5) : word.length >= 4 ? word.slice(0, -1) : word;
+var weights = { title: 3, chapters: 2, description: 1 };
+function score(video, queryStems) {
+  const fields = {
+    title: words(video.title),
+    chapters: (video.chapters ?? []).flatMap((chapter) => words(chapter.title)),
+    description: words(video.description ?? "")
+  };
+  let total = 0;
+  for (const queryStem of queryStems) {
+    for (const field of ["title", "chapters", "description"]) {
+      if (fields[field].some((word) => word.startsWith(queryStem))) total += weights[field];
+    }
+  }
+  return total;
+}
+function searchVideos(videos, query) {
+  const all = words(query);
+  const meaningful = all.filter((word) => !serviceWords.has(word));
+  const queryStems = [...new Set((meaningful.length > 0 ? meaningful : all).map(stem))];
+  if (queryStems.length === 0) return [];
+  return videos.map((video, index) => ({ video, index, score: score(video, queryStems) })).filter((found) => found.score > 0).sort((a, b) => b.score - a.score || a.index - b.index).slice(0, MAX_FOUND).map((found) => found.video);
+}
+
+// src/create-video-library.ts
+var MAX_DESCRIPTION = 300;
+var NOT_IN_CATALOG = "\u0422\u0430\u043A\u043E\u0433\u043E \u0432\u0438\u0434\u0435\u043E \u043D\u0435\u0442 \u0432 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0435. \u041D\u0430\u0439\u0434\u0438 \u0435\u0433\u043E \u0447\u0435\u0440\u0435\u0437 find_videos \u0438 \u043F\u0435\u0440\u0435\u0434\u0430\u0439 id \u043E\u0442\u0442\u0443\u0434\u0430.";
+var CATALOG_UNAVAILABLE = "\u041A\u0430\u0442\u0430\u043B\u043E\u0433 \u0432\u0438\u0434\u0435\u043E \u0441\u0435\u0439\u0447\u0430\u0441 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D. \u0421\u043A\u0430\u0436\u0438 \u043E\u0431 \u044D\u0442\u043E\u043C \u0447\u0435\u043B\u043E\u0432\u0435\u043A\u0443 \u0438 \u043D\u0435 \u043F\u0440\u043E\u0431\u0443\u0439 \u0441\u043D\u043E\u0432\u0430 \u0432 \u044D\u0442\u043E\u043C \u043E\u0442\u0432\u0435\u0442\u0435.";
+var CATALOG_UNAVAILABLE_MARK = /* @__PURE__ */ Symbol("\u043A\u0430\u0442\u0430\u043B\u043E\u0433 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D");
+var NOTHING_FOUND = "\u041D\u0438\u0447\u0435\u0433\u043E \u043D\u0435 \u043D\u0430\u0448\u043B\u043E\u0441\u044C. \u041F\u043E\u043F\u0440\u043E\u0431\u0443\u0439 \u0434\u0440\u0443\u0433\u0438\u0435 \u0441\u043B\u043E\u0432\u0430: \u0442\u0435\u043C\u0443 \u0438\u043B\u0438 \u043A\u043B\u044E\u0447\u0435\u0432\u043E\u0435 \u043F\u043E\u043D\u044F\u0442\u0438\u0435, \u0430 \u043D\u0435 \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435 \u0446\u0435\u043B\u0438\u043A\u043E\u043C.";
+var findVideosDescription = "\u0418\u0449\u0435\u0442 \u0432\u0438\u0434\u0435\u043E \u0432 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0435 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F: \u0443\u0440\u043E\u043A\u0438, \u043B\u0435\u043A\u0446\u0438\u0438, \u0437\u0430\u043F\u0438\u0441\u0438. \u041E\u0442\u0434\u0430\u0451\u0442 \u0434\u043E 8 \u043F\u043E\u0434\u0445\u043E\u0434\u044F\u0449\u0438\u0445 \u0441 id, \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435\u043C, \u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0435\u043C, \u0434\u043B\u0438\u0442\u0435\u043B\u044C\u043D\u043E\u0441\u0442\u044C\u044E \u0438 \u0433\u043B\u0430\u0432\u0430\u043C\u0438. \u0412\u044B\u0437\u044B\u0432\u0430\u0439, \u043A\u043E\u0433\u0434\u0430 \u0447\u0435\u043B\u043E\u0432\u0435\u043A \u043F\u0440\u043E\u0441\u0438\u0442 \u0432\u0438\u0434\u0435\u043E, \u0443\u0440\u043E\u043A \u0438\u043B\u0438 \u0437\u0430\u043F\u0438\u0441\u044C \u043F\u043E \u0442\u0435\u043C\u0435, \u0438 \u043F\u0435\u0440\u0435\u0434 show_video.";
+var showVideoDescription = "\u041F\u043E\u043A\u0430\u0437\u044B\u0432\u0430\u0435\u0442 \u0447\u0435\u043B\u043E\u0432\u0435\u043A\u0443 \u0432\u0438\u0434\u0435\u043E \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u043E\u0439 \u0441 \u043F\u043B\u0435\u0435\u0440\u043E\u043C. \u041F\u0435\u0440\u0435\u0434\u0430\u0439 id \u0438\u0437 \u0440\u0435\u0437\u0443\u043B\u044C\u0442\u0430\u0442\u0430 find_videos \u2014 \u0434\u0440\u0443\u0433\u0438\u0435 id \u043D\u0435 \u043F\u043E\u0434\u043E\u0439\u0434\u0443\u0442. startSeconds \u2014 \u0441 \u043A\u0430\u043A\u043E\u0439 \u0441\u0435\u043A\u0443\u043D\u0434\u044B \u043D\u0430\u0447\u0430\u0442\u044C, \u0435\u0441\u043B\u0438 \u043D\u0443\u0436\u043D\u0430 \u043A\u043E\u043D\u043A\u0440\u0435\u0442\u043D\u0430\u044F \u0433\u043B\u0430\u0432\u0430 (\u0432\u043E\u0437\u044C\u043C\u0438 \xAB\u0441\u0435\u043A\u0443\u043D\u0434\u0430\xBB \u0438\u0437 \u0433\u043B\u0430\u0432). \u0421\u0441\u044B\u043B\u043A\u0443 \u043D\u0430 \u0432\u0438\u0434\u0435\u043E \u0432 \u043E\u0442\u0432\u0435\u0442 \u043D\u0435 \u0432\u0441\u0442\u0430\u0432\u043B\u044F\u0439: \u043A\u0430\u0440\u0442\u043E\u0447\u043A\u0430 \u0443\u0436\u0435 \u043D\u0430 \u044D\u043A\u0440\u0430\u043D\u0435. \u041D\u0430\u0437\u043E\u0432\u0438 \u0432\u0438\u0434\u0435\u043E \u043E\u0434\u043D\u043E\u0439 \u0444\u0440\u0430\u0437\u043E\u0439.";
+var findVideosInput = z.object({
+  query: z.string().min(1).max(200).describe("\u0421\u043B\u043E\u0432\u0430 \u0434\u043B\u044F \u043F\u043E\u0438\u0441\u043A\u0430: \u0442\u0435\u043C\u0430 \u0438\u043B\u0438 \u043F\u043E\u043D\u044F\u0442\u0438\u0435, \u043E \u043A\u043E\u0442\u043E\u0440\u043E\u043C \u0432\u0438\u0434\u0435\u043E.")
+});
+var showVideoInput = z.object({
+  id: z.string().min(1).max(200).describe("id \u0432\u0438\u0434\u0435\u043E \u0438\u0437 \u0440\u0435\u0437\u0443\u043B\u044C\u0442\u0430\u0442\u0430 find_videos."),
+  startSeconds: z.number().int().min(0).optional().describe("\u0421 \u043A\u0430\u043A\u043E\u0439 \u0441\u0435\u043A\u0443\u043D\u0434\u044B \u043D\u0430\u0447\u0430\u0442\u044C. \u041D\u0435 \u0443\u043A\u0430\u0437\u044B\u0432\u0430\u0439, \u0447\u0442\u043E\u0431\u044B \u043D\u0430\u0447\u0430\u0442\u044C \u0441 \u043D\u0430\u0447\u0430\u043B\u0430.")
+});
+function forModel(video) {
+  const description = video.description?.trim();
+  return {
+    id: video.id,
+    \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435: video.title,
+    ...description && { \u043E\u043F\u0438\u0441\u0430\u043D\u0438\u0435: description.length > MAX_DESCRIPTION ? `${description.slice(0, MAX_DESCRIPTION - 1)}\u2026` : description },
+    ...video.durationSeconds !== void 0 && { \u0434\u043B\u0438\u0442\u0435\u043B\u044C\u043D\u043E\u0441\u0442\u044C: timeLabel(video.durationSeconds) },
+    ...video.chapters?.length && {
+      \u0433\u043B\u0430\u0432\u044B: video.chapters.map((chapter) => ({ \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435: chapter.title, \u043D\u0430\u0447\u0430\u043B\u043E: timeLabel(chapter.startSeconds), \u0441\u0435\u043A\u0443\u043D\u0434\u0430: chapter.startSeconds }))
+    }
+  };
+}
+function shown(video, startSeconds) {
+  const address = parseVideoUrl(video.url);
+  return {
+    \u0432\u0438\u0434\u0435\u043E: {
+      id: video.id,
+      \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435: video.title,
+      \u043F\u043B\u043E\u0449\u0430\u0434\u043A\u0430: address.provider,
+      \u043A\u043E\u0434: address.code,
+      ...video.durationSeconds !== void 0 && { \u0434\u043B\u0438\u0442\u0435\u043B\u044C\u043D\u043E\u0441\u0442\u044C: video.durationSeconds },
+      ...video.poster !== void 0 && { \u043E\u0431\u043B\u043E\u0436\u043A\u0430: video.poster },
+      ...startSeconds && { \u043D\u0430\u0447\u0430\u043B\u043E: startSeconds }
+    }
+  };
+}
+var shortId = (id) => typeof id === "string" ? id.slice(0, 200) : "(\u0431\u0435\u0437 id)";
+function createVideoLibrary(options) {
+  const logError = options.logError ?? ((message) => console.error(message));
+  const catalog = options.videos ? [...options.videos] : void 0;
+  if (catalog) checkVideoCatalog(catalog);
+  const byId = new Map(catalog?.map((video) => [video.id, video]));
+  const usable = (video) => {
+    if (video === void 0 || video === null) return false;
+    const reason = checkVideoEntry(video);
+    if (reason) logError(`\u0412\u0438\u0434\u0435\u043E \xAB${shortId(video?.id)}\xBB \u0438\u0437 \u043A\u0430\u0442\u0430\u043B\u043E\u0433\u0430 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u043F\u0440\u043E\u043F\u0443\u0449\u0435\u043D\u043E: ${reason}.`);
+    return !reason;
+  };
+  const unavailable = (what, reason) => {
+    logError(`\u041A\u0430\u0442\u0430\u043B\u043E\u0433 \u0432\u0438\u0434\u0435\u043E \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F: ${what} \u2014 ${reason instanceof Error ? reason.message : String(reason)}.`);
+    return CATALOG_UNAVAILABLE_MARK;
+  };
+  async function find(query, context) {
+    if (catalog) return searchVideos(catalog, query);
+    let found;
+    try {
+      found = await options.source.search(query, context);
+    } catch (error) {
+      return unavailable("search \u0443\u043F\u0430\u043B", error);
+    }
+    if (!Array.isArray(found)) return unavailable("search \u0432\u0435\u0440\u043D\u0443\u043B \u043D\u0435 \u0441\u043F\u0438\u0441\u043E\u043A", found === null ? "null" : typeof found);
+    return found.filter(usable).slice(0, MAX_FOUND);
+  }
+  async function get(id, context) {
+    if (catalog) return byId.get(id);
+    let video;
+    try {
+      video = await options.source.get(id, context);
+    } catch (error) {
+      return unavailable("get \u0443\u043F\u0430\u043B", error);
+    }
+    return usable(video) && video.id === id ? video : void 0;
+  }
+  const findVideos = (context) => tool({
+    description: findVideosDescription,
+    inputSchema: findVideosInput,
+    execute: async ({ query }) => {
+      const result = await find(query, context);
+      if (result === CATALOG_UNAVAILABLE_MARK) return { \u043E\u0442\u043A\u0430\u0437: CATALOG_UNAVAILABLE };
+      const found = result.map(forModel);
+      return found.length > 0 ? { \u043D\u0430\u0439\u0434\u0435\u043D\u043E: found } : { \u043D\u0430\u0439\u0434\u0435\u043D\u043E: [], \u0441\u043E\u0432\u0435\u0442: NOTHING_FOUND };
+    }
+  });
+  const showVideo = (context) => tool({
+    description: showVideoDescription,
+    inputSchema: showVideoInput,
+    execute: async ({ id, startSeconds }) => {
+      const video = await get(id, context);
+      if (video === CATALOG_UNAVAILABLE_MARK) return { \u043E\u0442\u043A\u0430\u0437: CATALOG_UNAVAILABLE };
+      if (!video) return { \u043E\u0442\u043A\u0430\u0437: NOT_IN_CATALOG };
+      if (startSeconds !== void 0 && video.durationSeconds !== void 0 && startSeconds >= video.durationSeconds) {
+        return { \u043E\u0442\u043A\u0430\u0437: `\u041D\u0430\u0447\u0430\u043B\u043E ${timeLabel(startSeconds)} \u0437\u0430 \u043A\u043E\u043D\u0446\u043E\u043C \u0432\u0438\u0434\u0435\u043E: \u043E\u043D\u043E \u0434\u043B\u0438\u0442\u0441\u044F ${timeLabel(video.durationSeconds)}.` };
+      }
+      return shown(video, startSeconds);
+    },
+    // Модели — коротко, что показано; карточке — весь результат.
+    toModelOutput: ({ output }) => {
+      if (output && "\u0432\u0438\u0434\u0435\u043E" in output) {
+        const { \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435, \u043D\u0430\u0447\u0430\u043B\u043E } = output.\u0432\u0438\u0434\u0435\u043E;
+        return { type: "json", value: { \u043F\u043E\u043A\u0430\u0437\u0430\u043D\u043E: \u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435, ...\u043D\u0430\u0447\u0430\u043B\u043E && { \u0441: timeLabel(\u043D\u0430\u0447\u0430\u043B\u043E) } } };
+      }
+      return { type: "json", value: { \u043E\u0442\u043A\u0430\u0437: output?.\u043E\u0442\u043A\u0430\u0437 ?? NOT_IN_CATALOG } };
+    }
+  });
+  return {
+    tools(model) {
+      if (!model.ownerId || !model.chatId) return {};
+      const context = { ownerId: model.ownerId, chatId: model.chatId };
+      return { find_videos: findVideos(context), show_video: showVideo(context) };
+    }
+  };
+}
+export {
+  createVideoLibrary,
+  embedUrl,
+  isVideoAddress,
+  parseVideoUrl,
+  searchVideos,
+  timeLabel,
+  watchUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/create-video-library.ts","../src/video-catalog.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport type { ToolSet } from \"ai\";\nimport { z } from \"zod\";\nimport { timeLabel } from \"./time-label\";\nimport { parseVideoUrl } from \"./video-address\";\nimport type { VideoProvider } from \"./video-address\";\nimport { MAX_FOUND, checkVideoCatalog, checkVideoEntry, searchVideos } from \"./video-catalog\";\nimport type { VideoEntry } from \"./video-catalog\";\n\n/** Кто спрашивает: по нему функции приложения могут учитывать права человека. */\nexport interface VideoContext {\n  ownerId: string;\n  chatId: string;\n}\n\n/** Каталог функциями — для большой базы или своего поиска. Записи проверяются на каждом вызове. */\nexport interface VideoSource {\n  search(query: string, context: VideoContext): VideoEntry[] | Promise<VideoEntry[]>;\n  get(id: string, context: VideoContext): VideoEntry | undefined | Promise<VideoEntry | undefined>;\n}\n\nexport type CreateVideoLibraryOptions = ({ videos: VideoEntry[]; source?: never } | { source: VideoSource; videos?: never }) & {\n  /** Куда писать о негодных записях из функций приложения. По умолчанию — `console.error`. */\n  logError?: (message: string) => void;\n};\n\n/** Выбранная модель хода: ядро передаёт в `agent.tools(model)` и того, чей ход, и чат. */\nexport interface VideoLibraryModel {\n  ownerId?: string;\n  chatId?: string;\n}\n\nexport interface VideoLibrary {\n  /** `{ find_videos, show_video }` для `agent.tools`; без `ownerId` и `chatId` — пустой набор. */\n  tools(model: VideoLibraryModel): ToolSet;\n}\n\n/** Результат `show_video`: хранится в сообщении и целиком нужен карточке — даже если видео потом убрали из каталога. */\nexport type ShownVideo =\n  | {\n      видео: { id: string; название: string; площадка: VideoProvider; код: string; длительность?: number; обложка?: string; начало?: number };\n    }\n  | { отказ: string };\n\nconst MAX_DESCRIPTION = 300;\nconst NOT_IN_CATALOG = \"Такого видео нет в каталоге. Найди его через find_videos и передай id оттуда.\";\nconst CATALOG_UNAVAILABLE = \"Каталог видео сейчас недоступен. Скажи об этом человеку и не пробуй снова в этом ответе.\";\nconst CATALOG_UNAVAILABLE_MARK: unique symbol = Symbol(\"каталог недоступен\");\nconst NOTHING_FOUND = \"Ничего не нашлось. Попробуй другие слова: тему или ключевое понятие, а не название целиком.\";\n\n// Описания и схемы постоянные при любом каталоге: начало запроса к модели не меняется, кэш модели цел (SC-003).\nconst findVideosDescription =\n  \"Ищет видео в каталоге приложения: уроки, лекции, записи. Отдаёт до 8 подходящих с id, названием, описанием, \" +\n  \"длительностью и главами. Вызывай, когда человек просит видео, урок или запись по теме, и перед show_video.\";\nconst showVideoDescription =\n  \"Показывает человеку видео из каталога карточкой с плеером. Передай id из результата find_videos — другие id не подойдут. \" +\n  \"startSeconds — с какой секунды начать, если нужна конкретная глава (возьми «секунда» из глав). \" +\n  \"Ссылку на видео в ответ не вставляй: карточка уже на экране. Назови видео одной фразой.\";\n\nconst findVideosInput = z.object({\n  query: z.string().min(1).max(200).describe(\"Слова для поиска: тема или понятие, о котором видео.\"),\n});\nconst showVideoInput = z.object({\n  id: z.string().min(1).max(200).describe(\"id видео из результата find_videos.\"),\n  startSeconds: z.number().int().min(0).optional().describe(\"С какой секунды начать. Не указывай, чтобы начать с начала.\"),\n});\n\nfunction forModel(video: VideoEntry) {\n  const description = video.description?.trim();\n  return {\n    id: video.id,\n    название: video.title,\n    ...(description && { описание: description.length > MAX_DESCRIPTION ? `${description.slice(0, MAX_DESCRIPTION - 1)}…` : description }),\n    ...(video.durationSeconds !== undefined && { длительность: timeLabel(video.durationSeconds) }),\n    ...(video.chapters?.length && {\n      главы: video.chapters.map((chapter) => ({ название: chapter.title, начало: timeLabel(chapter.startSeconds), секунда: chapter.startSeconds })),\n    }),\n  };\n}\n\nfunction shown(video: VideoEntry, startSeconds: number | undefined): ShownVideo {\n  const address = parseVideoUrl(video.url)!;\n  return {\n    видео: {\n      id: video.id,\n      название: video.title,\n      площадка: address.provider,\n      код: address.code,\n      ...(video.durationSeconds !== undefined && { длительность: video.durationSeconds }),\n      ...(video.poster !== undefined && { обложка: video.poster }),\n      ...(startSeconds && { начало: startSeconds }),\n    },\n  };\n}\n\nconst shortId = (id: unknown) => (typeof id === \"string\" ? id.slice(0, 200) : \"(без id)\");\n\n/** Инструменты видео поверх каталога приложения: модель ищет и показывает, сервер принимает только id из каталога. */\nexport function createVideoLibrary(options: CreateVideoLibraryOptions): VideoLibrary {\n  const logError = options.logError ?? ((message: string) => console.error(message));\n  const catalog = options.videos ? [...options.videos] : undefined;\n  if (catalog) checkVideoCatalog(catalog);\n  const byId = new Map(catalog?.map((video) => [video.id, video]));\n\n  /** Негодная запись из базы приложения пропускается; в журнал — только id и причина. */\n  const usable = (video: VideoEntry | null | undefined): video is VideoEntry => {\n    if (video === undefined || video === null) return false;\n    const reason = checkVideoEntry(video);\n    if (reason) logError(`Видео «${shortId(video?.id)}» из каталога приложения пропущено: ${reason}.`);\n    return !reason;\n  };\n\n  /** Сбой функции приложения — в журнал сервера; модели только нейтральное «недоступен», без текста исключения. */\n  const unavailable = (what: string, reason: unknown): typeof CATALOG_UNAVAILABLE_MARK => {\n    logError(`Каталог видео приложения: ${what} — ${reason instanceof Error ? reason.message : String(reason)}.`);\n    return CATALOG_UNAVAILABLE_MARK;\n  };\n\n  async function find(query: string, context: VideoContext): Promise<VideoEntry[] | typeof CATALOG_UNAVAILABLE_MARK> {\n    if (catalog) return searchVideos(catalog, query);\n    let found: unknown;\n    try {\n      found = await options.source!.search(query, context);\n    } catch (error) {\n      return unavailable(\"search упал\", error);\n    }\n    if (!Array.isArray(found)) return unavailable(\"search вернул не список\", found === null ? \"null\" : typeof found);\n    return (found as VideoEntry[]).filter(usable).slice(0, MAX_FOUND);\n  }\n\n  async function get(id: string, context: VideoContext): Promise<VideoEntry | undefined | typeof CATALOG_UNAVAILABLE_MARK> {\n    if (catalog) return byId.get(id);\n    let video: VideoEntry | null | undefined;\n    try {\n      video = await options.source!.get(id, context);\n    } catch (error) {\n      return unavailable(\"get упал\", error);\n    }\n    return usable(video) && video.id === id ? video : undefined;\n  }\n\n  const findVideos = (context: VideoContext) =>\n    tool({\n      description: findVideosDescription,\n      inputSchema: findVideosInput,\n      execute: async ({ query }) => {\n        const result = await find(query, context);\n        if (result === CATALOG_UNAVAILABLE_MARK) return { отказ: CATALOG_UNAVAILABLE };\n        const found = result.map(forModel);\n        return found.length > 0 ? { найдено: found } : { найдено: [], совет: NOTHING_FOUND };\n      },\n    });\n\n  const showVideo = (context: VideoContext) =>\n    tool({\n      description: showVideoDescription,\n      inputSchema: showVideoInput,\n      execute: async ({ id, startSeconds }): Promise<ShownVideo> => {\n        const video = await get(id, context);\n        if (video === CATALOG_UNAVAILABLE_MARK) return { отказ: CATALOG_UNAVAILABLE };\n        if (!video) return { отказ: NOT_IN_CATALOG };\n        if (startSeconds !== undefined && video.durationSeconds !== undefined && startSeconds >= video.durationSeconds) {\n          return { отказ: `Начало ${timeLabel(startSeconds)} за концом видео: оно длится ${timeLabel(video.durationSeconds)}.` };\n        }\n        return shown(video, startSeconds);\n      },\n      // Модели — коротко, что показано; карточке — весь результат.\n      toModelOutput: ({ output }) => {\n        if (output && \"видео\" in output) {\n          const { название, начало } = output.видео;\n          return { type: \"json\", value: { показано: название, ...(начало && { с: timeLabel(начало) }) } };\n        }\n        return { type: \"json\", value: { отказ: output?.отказ ?? NOT_IN_CATALOG } };\n      },\n    });\n\n  return {\n    tools(model): ToolSet {\n      if (!model.ownerId || !model.chatId) return {};\n      const context = { ownerId: model.ownerId, chatId: model.chatId };\n      return { find_videos: findVideos(context), show_video: showVideo(context) };\n    },\n  };\n}\n","import { isPosterAddress, parseVideoUrl } from \"./video-address\";\n\n/** Запись каталога приложения: что приложение знает о видео. */\nexport interface VideoEntry {\n  /** 1–200 знаков; модель передаёт его в `show_video`. */\n  id: string;\n  title: string;\n  /** Ссылка на YouTube или Kinescope. */\n  url: string;\n  description?: string;\n  /** Целое больше нуля. */\n  durationSeconds?: number;\n  /** `https://…` или путь от корня сайта `/…`. Нет — скин рисует заглушку, без запросов к площадке. */\n  poster?: string;\n  chapters?: Array<{ title: string; startSeconds: number }>;\n}\n\nconst MAX_ID_LENGTH = 200;\nexport const MAX_FOUND = 8;\n\nconst isText = (value: unknown): value is string => typeof value === \"string\" && value.trim() !== \"\";\n\n/** Что не так с записью; `undefined` — запись годная. Текст без содержимого записи, кроме id. */\nexport function checkVideoEntry(entry: VideoEntry): string | undefined {\n  if (typeof entry?.id !== \"string\" || entry.id === \"\" || entry.id.length > MAX_ID_LENGTH) return \"id должен быть строкой от 1 до 200 знаков\";\n  if (!isText(entry.title)) return \"пустое название\";\n  if (typeof entry.url !== \"string\" || !parseVideoUrl(entry.url)) return \"ссылка не на YouTube и не на Kinescope\";\n  if (entry.description !== undefined && typeof entry.description !== \"string\") return \"описание не строка\";\n  const duration = entry.durationSeconds;\n  if (duration !== undefined && (!Number.isInteger(duration) || duration <= 0)) return \"длительность должна быть целым числом секунд больше нуля\";\n  if (entry.poster !== undefined && !isPosterAddress(entry.poster)) {\n    return \"обложка должна быть адресом https:// или путём от корня сайта «/…»\";\n  }\n  if (entry.chapters !== undefined) {\n    if (!Array.isArray(entry.chapters)) return \"главы должны быть списком\";\n    for (const chapter of entry.chapters) {\n      if (!isText(chapter?.title)) return \"глава без названия\";\n      const start = chapter.startSeconds;\n      if (!Number.isInteger(start) || start < 0) return \"начало главы должно быть целым числом секунд от нуля\";\n      if (duration !== undefined && start >= duration) return \"глава начинается за концом видео\";\n    }\n  }\n  return undefined;\n}\n\n/** Каталог-массив проверяется целиком при создании: ошибка разработчика видна сразу, с id записи. */\nexport function checkVideoCatalog(videos: readonly VideoEntry[]): void {\n  const seen = new Set<string>();\n  videos.forEach((video, index) => {\n    const reason = checkVideoEntry(video);\n    const name = typeof video?.id === \"string\" && video.id !== \"\" ? `«${video.id}»` : `№${index + 1}`;\n    if (reason) throw new Error(`Каталог видео: запись ${name} — ${reason}.`);\n    if (seen.has(video.id)) throw new Error(`Каталог видео: id ${name} повторяется.`);\n    seen.add(video.id);\n  });\n}\n\n// Встроенный поиск по словам: без регистра, «ё» как «е», по началам слов — так «промптов» находит «промпты».\nconst serviceWords = new Set(\n  \"видео ролик ролика ролики роликов урок урока уроки уроку уроком уроков лекция лекции лекцию лекций про как что это для или на по из от\".split(\" \"),\n);\n\nconst words = (text: string) =>\n  text\n    .toLowerCase()\n    .replaceAll(\"ё\", \"е\")\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter((word) => word.length >= 2);\n\n/** Начало слова, по которому сравниваем: окончания падежей отбрасываются. */\nconst stem = (word: string) => (word.length > 5 ? word.slice(0, 5) : word.length >= 4 ? word.slice(0, -1) : word);\n\nconst weights = { title: 3, chapters: 2, description: 1 } as const;\n\nfunction score(video: VideoEntry, queryStems: string[]): number {\n  const fields = {\n    title: words(video.title),\n    chapters: (video.chapters ?? []).flatMap((chapter) => words(chapter.title)),\n    description: words(video.description ?? \"\"),\n  };\n  let total = 0;\n  for (const queryStem of queryStems) {\n    for (const field of [\"title\", \"chapters\", \"description\"] as const) {\n      if (fields[field].some((word) => word.startsWith(queryStem))) total += weights[field];\n    }\n  }\n  return total;\n}\n\n/** До восьми подходящих: название весит больше глав, главы — больше описания; при равенстве — порядок каталога. */\nexport function searchVideos(videos: readonly VideoEntry[], query: string): VideoEntry[] {\n  const all = words(query);\n  const meaningful = all.filter((word) => !serviceWords.has(word));\n  const queryStems = [...new Set((meaningful.length > 0 ? meaningful : all).map(stem))];\n  if (queryStems.length === 0) return [];\n  return videos\n    .map((video, index) => ({ video, index, score: score(video, queryStems) }))\n    .filter((found) => found.score > 0)\n    .sort((a, b) => b.score - a.score || a.index - b.index)\n    .slice(0, MAX_FOUND)\n    .map((found) => found.video);\n}\n"],"mappings":"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","names":[]}

package/dist/react/index.js

@@ -0,0 +1,43 @@
+import {
+  embedUrl,
+  isPosterAddress,
+  isVideoAddress,
+  timeLabel,
+  watchUrl
+} from "../chunk-UROHGMNR.js";
+
+// src/react/videos-client.ts
+var TOOL_NAME = "show_video";
+var wholeSeconds = (value, min) => typeof value === "number" && Number.isInteger(value) && value >= min ? value : void 0;
+var safePoster = (value) => isPosterAddress(value) ? value : void 0;
+var videosClient = {
+  toolName: TOOL_NAME,
+  describe(part) {
+    if (part.state === "input-streaming" || part.state === "input-available") return { state: "loading" };
+    if (part.state !== "output-available") return void 0;
+    const output = part.output;
+    const video = typeof output === "object" && output !== null ? output["\u0432\u0438\u0434\u0435\u043E"] : void 0;
+    if (typeof video !== "object" || video === null) return void 0;
+    const address = { provider: video["\u043F\u043B\u043E\u0449\u0430\u0434\u043A\u0430"], code: video["\u043A\u043E\u0434"] };
+    const title = video["\u043D\u0430\u0437\u0432\u0430\u043D\u0438\u0435"];
+    if (!isVideoAddress(address) || typeof title !== "string" || title.trim() === "") return void 0;
+    const start = wholeSeconds(video["\u043D\u0430\u0447\u0430\u043B\u043E"], 1);
+    const duration = wholeSeconds(video["\u0434\u043B\u0438\u0442\u0435\u043B\u044C\u043D\u043E\u0441\u0442\u044C"], 1);
+    const poster = safePoster(video["\u043E\u0431\u043B\u043E\u0436\u043A\u0430"]);
+    const view = {
+      id: part.toolCallId,
+      title,
+      provider: address.provider,
+      embedUrl: embedUrl(address, start),
+      pageUrl: watchUrl(address, start),
+      ...poster && { poster },
+      ...duration !== void 0 && { duration: timeLabel(duration) },
+      ...start !== void 0 && { start: timeLabel(start) }
+    };
+    return { state: "ready", video: view };
+  }
+};
+export {
+  videosClient
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/videos-client.ts"],"sourcesContent":["import type { AgentVideoView, VideosClient } from \"@ykurilov/agent-chat-react\";\nimport { timeLabel } from \"../time-label\";\nimport { embedUrl, isPosterAddress, isVideoAddress, watchUrl } from \"../video-address\";\n\nconst TOOL_NAME = \"show_video\";\n\nconst wholeSeconds = (value: unknown, min: number): number | undefined =>\n  typeof value === \"number\" && Number.isInteger(value) && value >= min ? value : undefined;\n\n/** Обложка — только https или путь от корня своего сайта. Иначе заглушка скина. */\nconst safePoster = (value: unknown): string | undefined => (isPosterAddress(value) ? value : undefined);\n\n/**\n * Видео агента на экране: вызов `show_video` → вид карточки. Пока идёт — `loading`; отказ, ошибка, «Стоп» и подделка\n * в базе — `undefined` (строка инструмента). Адреса плеера и страницы экран собирает сам из площадки и проверенного кода.\n */\nexport const videosClient: VideosClient = {\n  toolName: TOOL_NAME,\n  describe(part) {\n    if (part.state === \"input-streaming\" || part.state === \"input-available\") return { state: \"loading\" };\n    if (part.state !== \"output-available\") return undefined;\n\n    const output = part.output as Record<string, unknown> | null;\n    const video = typeof output === \"object\" && output !== null ? (output[\"видео\"] as Record<string, unknown> | undefined) : undefined;\n    if (typeof video !== \"object\" || video === null) return undefined;\n    const address = { provider: video[\"площадка\"], code: video[\"код\"] };\n    const title = video[\"название\"];\n    if (!isVideoAddress(address) || typeof title !== \"string\" || title.trim() === \"\") return undefined;\n\n    const start = wholeSeconds(video[\"начало\"], 1);\n    const duration = wholeSeconds(video[\"длительность\"], 1);\n    const poster = safePoster(video[\"обложка\"]);\n    const view: AgentVideoView = {\n      id: part.toolCallId,\n      title,\n      provider: address.provider,\n      embedUrl: embedUrl(address, start),\n      pageUrl: watchUrl(address, start),\n      ...(poster && { poster }),\n      ...(duration !== undefined && { duration: timeLabel(duration) }),\n      ...(start !== undefined && { start: timeLabel(start) }),\n    };\n    return { state: \"ready\", video: view };\n  },\n};\n"],"mappings":";;;;;;;;;AAIA,IAAM,YAAY;AAElB,IAAM,eAAe,CAAC,OAAgB,QACpC,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,SAAS,MAAM,QAAQ;AAGjF,IAAM,aAAa,CAAC,UAAwC,gBAAgB,KAAK,IAAI,QAAQ;AAMtF,IAAM,eAA6B;AAAA,EACxC,UAAU;AAAA,EACV,SAAS,MAAM;AACb,QAAI,KAAK,UAAU,qBAAqB,KAAK,UAAU,kBAAmB,QAAO,EAAE,OAAO,UAAU;AACpG,QAAI,KAAK,UAAU,mBAAoB,QAAO;AAE9C,UAAM,SAAS,KAAK;AACpB,UAAM,QAAQ,OAAO,WAAW,YAAY,WAAW,OAAQ,OAAO,gCAAO,IAA4C;AACzH,QAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,UAAM,UAAU,EAAE,UAAU,MAAM,kDAAU,GAAG,MAAM,MAAM,oBAAK,EAAE;AAClE,UAAM,QAAQ,MAAM,kDAAU;AAC9B,QAAI,CAAC,eAAe,OAAO,KAAK,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,GAAI,QAAO;AAEzF,UAAM,QAAQ,aAAa,MAAM,sCAAQ,GAAG,CAAC;AAC7C,UAAM,WAAW,aAAa,MAAM,0EAAc,GAAG,CAAC;AACtD,UAAM,SAAS,WAAW,MAAM,4CAAS,CAAC;AAC1C,UAAM,OAAuB;AAAA,MAC3B,IAAI,KAAK;AAAA,MACT;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,UAAU,SAAS,SAAS,KAAK;AAAA,MACjC,SAAS,SAAS,SAAS,KAAK;AAAA,MAChC,GAAI,UAAU,EAAE,OAAO;AAAA,MACvB,GAAI,aAAa,UAAa,EAAE,UAAU,UAAU,QAAQ,EAAE;AAAA,MAC9D,GAAI,UAAU,UAAa,EAAE,OAAO,UAAU,KAAK,EAAE;AAAA,IACvD;AACA,WAAO,EAAE,OAAO,SAAS,OAAO,KAAK;AAAA,EACvC;AACF;","names":[]}

package/dist/types/create-video-library.d.ts

@@ -0,0 +1,48 @@
+import type { ToolSet } from "ai";
+import type { VideoProvider } from "./video-address.js";
+import type { VideoEntry } from "./video-catalog.js";
+/** Кто спрашивает: по нему функции приложения могут учитывать права человека. */
+export interface VideoContext {
+    ownerId: string;
+    chatId: string;
+}
+/** Каталог функциями — для большой базы или своего поиска. Записи проверяются на каждом вызове. */
+export interface VideoSource {
+    search(query: string, context: VideoContext): VideoEntry[] | Promise<VideoEntry[]>;
+    get(id: string, context: VideoContext): VideoEntry | undefined | Promise<VideoEntry | undefined>;
+}
+export type CreateVideoLibraryOptions = ({
+    videos: VideoEntry[];
+    source?: never;
+} | {
+    source: VideoSource;
+    videos?: never;
+}) & {
+    /** Куда писать о негодных записях из функций приложения. По умолчанию — `console.error`. */
+    logError?: (message: string) => void;
+};
+/** Выбранная модель хода: ядро передаёт в `agent.tools(model)` и того, чей ход, и чат. */
+export interface VideoLibraryModel {
+    ownerId?: string;
+    chatId?: string;
+}
+export interface VideoLibrary {
+    /** `{ find_videos, show_video }` для `agent.tools`; без `ownerId` и `chatId` — пустой набор. */
+    tools(model: VideoLibraryModel): ToolSet;
+}
+/** Результат `show_video`: хранится в сообщении и целиком нужен карточке — даже если видео потом убрали из каталога. */
+export type ShownVideo = {
+    видео: {
+        id: string;
+        название: string;
+        площадка: VideoProvider;
+        код: string;
+        длительность?: number;
+        обложка?: string;
+        начало?: number;
+    };
+} | {
+    отказ: string;
+};
+/** Инструменты видео поверх каталога приложения: модель ищет и показывает, сервер принимает только id из каталога. */
+export declare function createVideoLibrary(options: CreateVideoLibraryOptions): VideoLibrary;

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export { createVideoLibrary } from "./create-video-library.js";
+export type { CreateVideoLibraryOptions, ShownVideo, VideoContext, VideoLibrary, VideoLibraryModel, VideoSource } from "./create-video-library.js";
+export { searchVideos } from "./video-catalog.js";
+export type { VideoEntry } from "./video-catalog.js";
+export { embedUrl, isVideoAddress, parseVideoUrl, watchUrl } from "./video-address.js";
+export type { VideoAddress, VideoProvider } from "./video-address.js";
+export { timeLabel } from "./time-label.js";

package/dist/types/react/index.d.ts

@@ -0,0 +1,2 @@
+export { videosClient } from "./videos-client.js";
+export type { VideosClient } from "@ykurilov/agent-chat-react";

package/dist/types/react/videos-client.d.ts

@@ -0,0 +1,6 @@
+import type { VideosClient } from "@ykurilov/agent-chat-react";
+/**
+ * Видео агента на экране: вызов `show_video` → вид карточки. Пока идёт — `loading`; отказ, ошибка, «Стоп» и подделка
+ * в базе — `undefined` (строка инструмента). Адреса плеера и страницы экран собирает сам из площадки и проверенного кода.
+ */
+export declare const videosClient: VideosClient;

package/dist/types/time-label.d.ts

@@ -0,0 +1,2 @@
+/** Секунды словами часов: 200 → «3:20», 3725 → «1:02:05». */
+export declare function timeLabel(seconds: number): string;

package/dist/types/video-address.d.ts

@@ -0,0 +1,19 @@
+export type VideoProvider = "youtube" | "kinescope";
+export interface VideoAddress {
+    provider: VideoProvider;
+    code: string;
+}
+/** Площадка известна, код — только из допустимых знаков. */
+export declare function isVideoAddress(value: unknown): value is VideoAddress;
+/**
+ * Обложка — `https://…` или путь от корня своего сайта. Браузер читает `/\evil`, `/<таб>/evil` как `//evil` — чужой хост,
+ * поэтому путь разбирается как адрес и обязан остаться на своём хосте; `\`, пробелы, управляющие знаки и закодированные
+ * косые не допускаются вовсе.
+ */
+export declare function isPosterAddress(value: unknown): value is string;
+/** Ссылка YouTube (watch, youtu.be, embed, shorts, live) или Kinescope (`/<код>`, `/embed/<код>`) → площадка и код. */
+export declare function parseVideoUrl(url: string): VideoAddress | undefined;
+/** Адрес встроенного плеера: YouTube — с youtube-nocookie.com; оба с автозапуском (грузится по нажатию) и стартом. */
+export declare function embedUrl(address: VideoAddress, startSeconds?: number): string;
+/** Адрес страницы видео на площадке — для ссылки, когда скин не умеет карточку. */
+export declare function watchUrl(address: VideoAddress, startSeconds?: number): string;

package/dist/types/video-catalog.d.ts

@@ -0,0 +1,24 @@
+/** Запись каталога приложения: что приложение знает о видео. */
+export interface VideoEntry {
+    /** 1–200 знаков; модель передаёт его в `show_video`. */
+    id: string;
+    title: string;
+    /** Ссылка на YouTube или Kinescope. */
+    url: string;
+    description?: string;
+    /** Целое больше нуля. */
+    durationSeconds?: number;
+    /** `https://…` или путь от корня сайта `/…`. Нет — скин рисует заглушку, без запросов к площадке. */
+    poster?: string;
+    chapters?: Array<{
+        title: string;
+        startSeconds: number;
+    }>;
+}
+export declare const MAX_FOUND = 8;
+/** Что не так с записью; `undefined` — запись годная. Текст без содержимого записи, кроме id. */
+export declare function checkVideoEntry(entry: VideoEntry): string | undefined;
+/** Каталог-массив проверяется целиком при создании: ошибка разработчика видна сразу, с id записи. */
+export declare function checkVideoCatalog(videos: readonly VideoEntry[]): void;
+/** До восьми подходящих: название весит больше глав, главы — больше описания; при равенстве — порядок каталога. */
+export declare function searchVideos(videos: readonly VideoEntry[], query: string): VideoEntry[];

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@ykurilov/agent-chat-videos",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.55.0",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "@ykurilov/agent-chat-source": "./src/index.ts",
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "@ykurilov/agent-chat-source": "./src/react/index.ts",
+      "types": "./dist/types/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ykurilov/agent-chat-sdk.git",
+    "directory": "packages/videos"
+  },
+  "dependencies": {
+    "ai": "7.0.122",
+    "zod": "^4.6.5"
+  },
+  "peerDependencies": {
+    "react": "^19.3.0",
+    "@ykurilov/agent-chat-react": "^0.55.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "jsdom": "^30.1.1",
+    "react": "^19.3.0",
+    "@ykurilov/agent-chat-react": "0.55.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "@ykurilov/agent-chat-react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }