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

package/CHANGELOG.md

@@ -0,0 +1,238 @@
+# @ykurilov/agent-chat-diagrams
+
+## 0.55.0
+
+No changes in this release.
+
+## 0.54.0
+
+No changes in this release.
+
+## 0.53.0
+
+No changes in this release.
+
+## 0.52.0
+
+No changes in this release.
+
+## 0.51.0
+
+No changes in this release.
+
+## 0.50.0
+
+No changes in this release.
+
+## 0.49.0
+
+No changes in this release.
+
+## 0.48.0
+
+No changes in this release.
+
+## 0.47.0
+
+No changes in this release.
+
+## 0.46.2
+
+No changes in this release.
+
+## 0.46.1
+
+No changes in this release.
+
+## 0.46.0
+
+No changes in this release.
+
+## 0.45.0
+
+No changes in this release.
+
+## 0.44.0
+
+No changes in this release.
+
+## 0.43.0
+
+No changes in this release.
+
+## 0.42.0
+
+No changes in this release.
+
+## 0.41.0
+
+No changes in this release.
+
+## 0.40.0
+
+No changes in this release.
+
+## 0.39.1
+
+No changes in this release.
+
+## 0.39.0
+
+No changes in this release.
+
+## 0.38.0
+
+No changes in this release.
+
+## 0.37.0
+
+No changes in this release.
+
+## 0.36.0
+
+No changes in this release.
+
+## 0.35.0
+
+No changes in this release.
+
+## 0.34.0
+
+No changes in this release.
+
+## 0.33.0
+
+No changes in this release.
+
+## 0.32.0
+
+No changes in this release.
+
+## 0.31.2
+
+No changes in this release.
+
+## 0.31.1
+
+No changes in this release.
+
+## 0.31.0
+
+No changes in this release.
+
+## 0.30.0
+
+No changes in this release.
+
+## 0.29.0
+
+No changes in this release.
+
+## 0.28.0
+
+No changes in this release.
+
+## 0.27.0
+
+No changes in this release.
+
+## 0.26.2
+
+No changes in this release.
+
+## 0.26.1
+
+No changes in this release.
+
+## 0.26.0
+
+No changes in this release.
+
+## 0.25.0
+
+No changes in this release.
+
+## 0.24.0
+
+No changes in this release.
+
+## 0.23.0
+
+No changes in this release.
+
+## 0.22.0
+
+No changes in this release.
+
+## 0.21.0
+
+No changes in this release.
+
+## 0.20.0
+
+No changes in this release.
+
+## 0.19.0
+
+No changes in this release.
+
+## 0.18.6
+
+No changes in this release.
+
+## 0.18.5
+
+No changes in this release.
+
+## 0.18.4
+
+No changes in this release.
+
+## 0.18.3
+
+No changes in this release.
+
+## 0.18.2
+
+No changes in this release.
+
+## 0.18.1
+
+No changes in this release.
+
+## 0.18.0
+
+No changes in this release.
+
+## 0.17.0
+
+No changes in this release.
+
+## 0.16.0
+
+### Minor Changes
+
+- cf52f10: **Ломает только исчерпывающие проверки:** у `UsageSource` появилось значение `images`, у видов ошибок сервера — `widget_not_pending` и `invalid_answer`, у `ChatService` — метод `answerWidget`. Своё хранилище должно поддержать условную запись `AwaitingMessagePatch.expectedParts` (при несовпадении частей — `MessageNotAwaitingError`; помощник `sameMessageParts` из core), иначе две копии сервера могут затереть ответы друг друга; общие тесты хранилищ это проверяют. Остальное необязательно, приложение без правок работает как раньше.
+  
+  Что нового: агент может спросить кнопками, звёздами или формой (виджеты), нарисовать схему блоком ` ```mermaid ` и создать картинки через Runware. Всё включается отдельно:
+  
+  - виджеты: `agent: { widgets: { basic: true, custom: [свойВиджет] } }`, свой виджет — `defineWidget` из core и компонент в `widgets={{ … }}` у `AgentChat`; ответ человека идёт на `POST /:chatId/widgets/:toolCallId`, ход ждёт со статусом `awaiting_approval`;
+  - схемы: новый пакет `@ykurilov/agent-chat-diagrams`, `agent: { diagrams: true }` на сервере и `diagrams={diagramsClient}` на странице;
+  - картинки: новый пакет `@ykurilov/agent-chat-images` (нужен пакет вложений и `RUNWARE_API_KEY`), `images.tools(model)` в `agent.tools`, `images={imagesClient}` на странице; свой срок ожидания (210 с) инструмент сообщает ядру сам (`declareToolTimeout`), расход бронируется до заказа (`assertWithinLimit({ pendingUsd })`);
+  - окно просмотра картинок и схем: Тандем готов, своему скину — необязательные части договора версии 13 (`Widget`, `SuggestedReplies`, `GeneratedImages`, `MediaViewer`, `diagramColors`, `renderDiagram`). `splitMermaidBlocks` экспортируется из react;
+  - вложения: `Attachments.storage` и `detectFileKind` экспортируются из пакета вложений;
+  - голосовой режим произносит вопрос и варианты ждущего виджета и говорит «схема на экране» вместо блока схемы;
+  - «Стоп» на экране закрывает висящие вызовы так же, как сервер, разрешённые без результата — «результат неизвестен» (`stoppedToolCallReasons.resultUnknown`);
+  - упавший свой виджет страницы заменяется запасным видом скина, лента цела.
+  
+  Подробно: `docs/widgets.md`, `docs/diagrams.md`, `docs/images.md`, `docs/media-viewer.md`.
+  
+  ### Как обновить приложение
+  
+  Обычному приложению на SQLite или PostgreSQL из набора делать ничего не нужно: миграций нет, всё новое включается отдельно.
+  
+  1. Исчерпывающий `switch` по `UsageSource` — добавьте ветку `"images"`; по видам ошибок сервера — `"widget_not_pending"` и `"invalid_answer"`.
+  2. Своя реализация `ChatService` — добавьте метод `answerWidget({ chatId, ownerId, toolCallId, answer, page }): Promise<{ resumed: boolean }>` (тип `WidgetAnswerRequest` из core, образец — служба из core).
+  3. Своё хранилище: `updateAwaitingMessage` получает необязательное поле `expectedParts`. Если оно есть и части сообщения в базе с ним не совпадают (`sameMessageParts` из core), бросайте `MessageNotAwaitingError`; проверку и запись делайте в одной транзакции. Прогоните общие тесты хранилищ из core.
+  4. Своя обёртка `assertWithinLimit` из limits — пробрасывайте новое необязательное поле `pendingUsd`.
+  5. Проверка: `pnpm typecheck`, затем в чате отправить сообщение и получить ответ.

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,28 @@
-# Temporary Holding Version
+# @ykurilov/agent-chat-diagrams
 
-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.
+Схемы в ответах агента: блок ` ```mermaid ` рисуется на экране и открывается в окне просмотра. Отдельное расширение:
+приложению без схем пакет не нужен, и в его сборке нет ни байта mermaid (он грузится отдельным куском при первой схеме).
+Серверу пакет не нужен.
+
+```bash
+pnpm add @ykurilov/agent-chat-diagrams
+```
+
+```ts
+// сервер: одна постоянная строка в инструкции агента
+createChatHandler({ …, agent: { instructions: appInstructions, diagrams: true } });
+```
+
+```tsx
+// страница
+import { diagramsClient } from "@ykurilov/agent-chat-diagrams";
+<AgentChat … diagrams={diagramsClient} />;
+```
+
+- Рисует `mermaid` 12 в строгом режиме; цвета берутся у скина (`diagramColors`), смена темы перерисовывает схему.
+- Готовый SVG чистится (`cleanSvg`): без скриптов, `foreignObject`, ссылок наружу и обработчиков событий.
+- Пределы: до 20 000 знаков и 200 узлов. Не нарисовалось — скин показывает исходный текст блоком кода.
+- Без `diagrams` блок остаётся обычным кодом.
+
+Скину нужны необязательные `renderDiagram` и `onOpenDiagram` у `AgentText` (договор версии 13); в Тандеме они есть.
+Подробно — [docs/diagrams.md](../../docs/diagrams.md).

package/dist/index.js

@@ -0,0 +1,279 @@
+// src/clean-svg.ts
+var SVG_NS = "http://www.w3.org/2000/svg";
+var ALLOWED_ELEMENTS = /* @__PURE__ */ new Set([
+  "svg",
+  "g",
+  "defs",
+  "style",
+  "title",
+  "desc",
+  "symbol",
+  "use",
+  "marker",
+  "clippath",
+  "mask",
+  "pattern",
+  "lineargradient",
+  "radialgradient",
+  "stop",
+  "path",
+  "rect",
+  "circle",
+  "ellipse",
+  "line",
+  "polyline",
+  "polygon",
+  "text",
+  "tspan",
+  "textpath",
+  "filter",
+  "feblend",
+  "fecolormatrix",
+  "fecomponenttransfer",
+  "fecomposite",
+  "fedropshadow",
+  "feflood",
+  "fefunca",
+  "fefuncb",
+  "fefuncg",
+  "fefuncr",
+  "fegaussianblur",
+  "femerge",
+  "femergenode",
+  "femorphology",
+  "feoffset"
+]);
+var OUTSIDE_URL = /url\(\s*(?!['"]?\s*#)/;
+var LOADING_FUNCTION = /(?:^|[^a-z0-9_-])(?:-[a-z]+-)?(?:image-set|image|cross-fade|element|src)\s*\(/;
+var BLOCKED_PROPERTIES = /* @__PURE__ */ new Set(["behavior", "-moz-binding"]);
+var escapesFrame = (property, value) => property === "position" && !/^(?:static|relative)$/i.test(value);
+var PROPERTY_NAME = /^(?:--|-)?[a-z][a-z0-9-]*$/;
+function decodeCss(value) {
+  return value.replace(/\\([0-9a-f]{1,6})\s?/gi, (_whole, hex) => String.fromCodePoint(Math.min(Number.parseInt(hex, 16), 1114111) || 65533)).replace(/\\([\s\S])/g, "$1").replace(/\/\*[\s\S]*?(?:\*\/|$)/g, "");
+}
+function loadsOutside(value) {
+  const plain = decodeCss(value).toLowerCase();
+  return OUTSIDE_URL.test(plain) || LOADING_FUNCTION.test(plain) || /expression\(|javascript:|@import/.test(plain);
+}
+function splitTopLevel(text, separator) {
+  const parts = [];
+  let quote = null;
+  let depth = 0;
+  let start = 0;
+  for (let index = 0; index < text.length; index++) {
+    const char = text[index];
+    if (quote) {
+      if (char === quote || char === "\n") quote = null;
+    } else if (char === '"' || char === "'") quote = char;
+    else if (char === "(" || char === "[") depth++;
+    else if (char === ")" || char === "]") depth = Math.max(0, depth - 1);
+    else if (char === separator && depth === 0) {
+      parts.push(text.slice(start, index));
+      start = index + 1;
+    }
+  }
+  parts.push(text.slice(start));
+  return parts;
+}
+function cssBlocks(css) {
+  const blocks = [];
+  let quote = null;
+  let depth = 0;
+  let start = 0;
+  let bodyStart = 0;
+  let prelude = "";
+  for (let index = 0; index < css.length; index++) {
+    const char = css[index];
+    if (quote) {
+      if (char === quote || char === "\n") quote = null;
+    } else if (char === '"' || char === "'") quote = char;
+    else if (char === "{") {
+      if (depth++ === 0) {
+        prelude = css.slice(start, index).trim();
+        bodyStart = index + 1;
+      }
+    } else if (char === "}") {
+      if (depth === 0) start = index + 1;
+      else if (--depth === 0) {
+        blocks.push({ prelude, body: css.slice(bodyStart, index) });
+        start = index + 1;
+      }
+    } else if (char === ";" && depth === 0) {
+      blocks.push({ prelude: css.slice(start, index).trim(), body: null });
+      start = index + 1;
+    }
+  }
+  return blocks;
+}
+function quotesClosed(text) {
+  let quote = null;
+  for (const char of text) {
+    if (quote) {
+      if (char === "\n") return false;
+      if (char === quote) quote = null;
+    } else if (char === '"' || char === "'") quote = char;
+  }
+  return quote === null;
+}
+var AMBIGUOUS_CSS = /[\\{};<@]|\/\*|\*\//;
+function scopedSelectors(prelude, rootId) {
+  const scope = `#${rootId}`;
+  const kept = splitTopLevel(prelude, ",").map((selector) => selector.trim()).filter(
+    (selector) => selector.startsWith(scope) && /^(?:$|[\s.:[>])/.test(selector.slice(scope.length)) && !/[~+]/.test(selector) && quotesClosed(selector) && !AMBIGUOUS_CSS.test(selector)
+  );
+  return kept.length > 0 ? kept.join(",") : null;
+}
+function cleanDeclarations(body) {
+  return splitTopLevel(body, ";").flatMap((declaration) => {
+    const colon = declaration.indexOf(":");
+    if (colon < 0) return [];
+    const property = declaration.slice(0, colon).trim().toLowerCase();
+    const value = declaration.slice(colon + 1).trim();
+    const safe = PROPERTY_NAME.test(property) && !BLOCKED_PROPERTIES.has(property) && !escapesFrame(property, value) && value.length > 0 && !AMBIGUOUS_CSS.test(value) && quotesClosed(value) && !loadsOutside(value);
+    return safe ? [`${declaration.slice(0, colon).trim()}:${value}`] : [];
+  }).join(";");
+}
+function cleanCss(css, rootId) {
+  if (!rootId || !/^[\w-]+$/.test(rootId)) return "";
+  const kept = [];
+  for (const { prelude, body } of cssBlocks(css)) {
+    if (body === null || prelude.includes("@")) continue;
+    const selectors = scopedSelectors(prelude, rootId);
+    const declarations = selectors && cleanDeclarations(body);
+    if (selectors && declarations) kept.push(`${selectors}{${declarations}}`);
+  }
+  return kept.join("");
+}
+function isUnsafeAttribute(name, value) {
+  const lower = name.toLowerCase();
+  if (lower.startsWith("on")) return true;
+  if (lower === "href" || lower.endsWith(":href")) return !value.trim().startsWith("#");
+  if (lower === "src" || lower === "xml:base" || lower === "formaction" || lower === "action") return true;
+  return /javascript:/i.test(value) || loadsOutside(value);
+}
+function usesOutside(element) {
+  return [...element.attributes].some(({ name, value }) => (name === "href" || name.endsWith(":href")) && !value.trim().startsWith("#"));
+}
+function cleanAttributes(element) {
+  for (const { name, value } of [...element.attributes]) {
+    if (name.toLowerCase() === "style") element.setAttribute(name, cleanDeclarations(value));
+    else if (isUnsafeAttribute(name, value)) element.removeAttribute(name);
+  }
+}
+function unwrap(element) {
+  element.replaceWith(...element.childNodes);
+}
+function cleanSvg(markup) {
+  const doc = new DOMParser().parseFromString(markup, "text/html");
+  const root = doc.querySelector("svg");
+  if (!root || root.namespaceURI !== SVG_NS) return "";
+  for (const element of [root, ...root.querySelectorAll("*")]) {
+    if (!root.contains(element)) continue;
+    const name = element.localName.toLowerCase();
+    if (element.namespaceURI === SVG_NS && name === "a") {
+      unwrap(element);
+      continue;
+    }
+    if (element.namespaceURI !== SVG_NS || !ALLOWED_ELEMENTS.has(name) || name === "use" && usesOutside(element)) {
+      element.remove();
+      continue;
+    }
+    cleanAttributes(element);
+    if (name === "style") element.textContent = cleanCss(element.textContent ?? "", root.getAttribute("id"));
+  }
+  return root.outerHTML;
+}
+
+// src/diagrams-client.ts
+var MAX_SOURCE_LENGTH = 2e4;
+var MAX_DIAGRAM_NODES = 200;
+var CACHE_SIZE = 100;
+var LINK = /<?(?:-{2,}|={2,}|-\.+-|~{3,}|->>)[>ox]?/g;
+function countDiagramNodes(source) {
+  const statements = source.split(/[\n;]/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("%%")).slice(1);
+  return statements.reduce((total, statement) => total + Math.max(1, statement.match(LINK)?.length ?? 0), 0);
+}
+function mermaidConfig(colors) {
+  return {
+    startOnLoad: false,
+    securityLevel: "strict",
+    // Подписи — текстом SVG, а не HTML: без foreignObject, и рисунок остаётся векторным.
+    htmlLabels: false,
+    flowchart: { htmlLabels: false },
+    // Ошибка разбора не рисуется на странице: скин сам покажет исходник.
+    suppressErrorRendering: true,
+    maxTextSize: MAX_SOURCE_LENGTH,
+    theme: "base",
+    themeVariables: {
+      darkMode: colors.dark,
+      background: colors.background,
+      fontFamily: "inherit",
+      textColor: colors.text,
+      primaryColor: colors.node,
+      primaryTextColor: colors.text,
+      primaryBorderColor: colors.line,
+      secondaryColor: colors.background,
+      secondaryTextColor: colors.text,
+      secondaryBorderColor: colors.accent,
+      tertiaryColor: colors.background,
+      tertiaryTextColor: colors.text,
+      tertiaryBorderColor: colors.line,
+      mainBkg: colors.node,
+      nodeBorder: colors.line,
+      lineColor: colors.line,
+      clusterBkg: colors.background,
+      clusterBorder: colors.accent,
+      edgeLabelBackground: colors.background,
+      actorBkg: colors.node,
+      actorBorder: colors.line,
+      actorTextColor: colors.text,
+      signalColor: colors.line,
+      signalTextColor: colors.text,
+      noteBkgColor: colors.background,
+      noteTextColor: colors.text,
+      noteBorderColor: colors.accent
+    }
+  };
+}
+function createDiagramsClient() {
+  let mermaid = null;
+  let queue = Promise.resolve();
+  let renderCount = 0;
+  const cache = /* @__PURE__ */ new Map();
+  const load = () => mermaid ??= import("mermaid").then((module) => module.default);
+  async function draw(source, colors) {
+    if (source.length > MAX_SOURCE_LENGTH) return { error: `\u0421\u0445\u0435\u043C\u0430 \u0434\u043B\u0438\u043D\u043D\u0435\u0435 ${MAX_SOURCE_LENGTH} \u0437\u043D\u0430\u043A\u043E\u0432` };
+    if (countDiagramNodes(source) > MAX_DIAGRAM_NODES) return { error: `\u0412 \u0441\u0445\u0435\u043C\u0435 \u0431\u043E\u043B\u044C\u0448\u0435 ${MAX_DIAGRAM_NODES} \u0443\u0437\u043B\u043E\u0432` };
+    try {
+      const api = await load();
+      api.initialize(mermaidConfig(colors));
+      const { svg } = await api.render(`agent-chat-diagram-${++renderCount}`, source);
+      const clean = cleanSvg(svg);
+      return clean ? { svg: clean } : { error: "\u0420\u0438\u0441\u043E\u0432\u0430\u043B\u044C\u0449\u0438\u043A \u043D\u0435 \u0432\u0435\u0440\u043D\u0443\u043B \u0440\u0438\u0441\u0443\u043D\u043E\u043A" };
+    } catch (error) {
+      return { error: error instanceof Error ? error.message : String(error) };
+    }
+  }
+  return {
+    render(source, colors) {
+      const key = `${JSON.stringify(colors)}
+${source}`;
+      const cached = cache.get(key);
+      if (cached) return cached;
+      const result = queue.then(() => draw(source, colors));
+      queue = result;
+      if (cache.size >= CACHE_SIZE) cache.delete(cache.keys().next().value);
+      cache.set(key, result);
+      return result;
+    }
+  };
+}
+
+// src/index.ts
+var diagramsClient = /* @__PURE__ */ createDiagramsClient();
+export {
+  cleanSvg,
+  createDiagramsClient,
+  diagramsClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/clean-svg.ts","../src/diagrams-client.ts","../src/index.ts"],"sourcesContent":["/*\n * Рисунок схемы скин кладёт в страницу разметкой, как есть: так схема остаётся векторной. Поэтому всё, что может\n * исполниться или куда-то сходить, вычищается здесь (FR-027). Разрешён короткий список элементов SVG, которыми рисует\n * mermaid; остальное удаляется вместе с содержимым. Ссылка `<a>` снимается, а её текст остаётся.\n */\n\nconst SVG_NS = \"http://www.w3.org/2000/svg\";\n\n/** Элементы, которыми рисует mermaid, в нижнем регистре. `a` сюда не входит: она снимается отдельно. */\nconst ALLOWED_ELEMENTS = new Set([\n  \"svg\", \"g\", \"defs\", \"style\", \"title\", \"desc\", \"symbol\", \"use\", \"marker\", \"clippath\", \"mask\", \"pattern\",\n  \"lineargradient\", \"radialgradient\", \"stop\", \"path\", \"rect\", \"circle\", \"ellipse\", \"line\", \"polyline\", \"polygon\",\n  \"text\", \"tspan\", \"textpath\", \"filter\", \"feblend\", \"fecolormatrix\", \"fecomponenttransfer\", \"fecomposite\",\n  \"fedropshadow\", \"feflood\", \"fefunca\", \"fefuncb\", \"fefuncg\", \"fefuncr\", \"fegaussianblur\", \"femerge\", \"femergenode\",\n  \"femorphology\", \"feoffset\",\n]);\n\n/*\n * CSS чистится белым списком. Остаются только правила вида «#<id корня> …{свойство:значение}» без вложенных блоков;\n * любые @-правила (@import, @font-face, @media, @keyframes) уходят целиком. Объявление или селектор с обратной косой\n * чертой (экранирование: «\\\\75rl(» браузер читает как «url(»), кавычкой без пары, скобкой или комментарием\n * отбрасывается: в рисунке mermaid таких нет, а собранная заново таблица читается браузером ровно так, как здесь.\n */\n\n/** `url(` не на свою метку `#…` — после нормализации, в нижнем регистре. */\nconst OUTSIDE_URL = /url\\(\\s*(?!['\"]?\\s*#)/;\n/** Функции CSS, которые сами грузят адрес: `image-set(\"…\")`, `-webkit-image-set`, `image()`, `cross-fade()`, `src()`. */\nconst LOADING_FUNCTION = /(?:^|[^a-z0-9_-])(?:-[a-z]+-)?(?:image-set|image|cross-fade|element|src)\\s*\\(/;\n/** Свойства, которые исполнили бы код. */\nconst BLOCKED_PROPERTIES = new Set([\"behavior\", \"-moz-binding\"]);\n/** `position: absolute | fixed | sticky` вынес бы рисунок из его рамки поверх страницы. */\nconst escapesFrame = (property: string, value: string) => property === \"position\" && !/^(?:static|relative)$/i.test(value);\nconst PROPERTY_NAME = /^(?:--|-)?[a-z][a-z0-9-]*$/;\n\n/** Значение, как его прочтёт браузер: экранирование раскрыто, комментарии убраны. Только для проверок. */\nfunction decodeCss(value: string): string {\n  return value\n    .replace(/\\\\([0-9a-f]{1,6})\\s?/gi, (_whole, hex: string) => String.fromCodePoint(Math.min(Number.parseInt(hex, 16), 0x10ffff) || 0xfffd))\n    .replace(/\\\\([\\s\\S])/g, \"$1\")\n    .replace(/\\/\\*[\\s\\S]*?(?:\\*\\/|$)/g, \"\");\n}\n\n/** Может ли значение что-то загрузить или исполнить. */\nfunction loadsOutside(value: string): boolean {\n  const plain = decodeCss(value).toLowerCase();\n  return OUTSIDE_URL.test(plain) || LOADING_FUNCTION.test(plain) || /expression\\(|javascript:|@import/.test(plain);\n}\n\n/** Части строки, разделённые `separator` вне кавычек и скобок. */\nfunction splitTopLevel(text: string, separator: string): string[] {\n  const parts: string[] = [];\n  let quote: string | null = null;\n  let depth = 0;\n  let start = 0;\n  for (let index = 0; index < text.length; index++) {\n    const char = text[index];\n    if (quote) {\n      if (char === quote || char === \"\\n\") quote = null;\n    } else if (char === '\"' || char === \"'\") quote = char;\n    else if (char === \"(\" || char === \"[\") depth++;\n    else if (char === \")\" || char === \"]\") depth = Math.max(0, depth - 1);\n    else if (char === separator && depth === 0) {\n      parts.push(text.slice(start, index));\n      start = index + 1;\n    }\n  }\n  parts.push(text.slice(start));\n  return parts;\n}\n\n/** Блоки верхнего уровня таблицы: `prelude{body}`; у правила без блока (`@import …;`) `body` — null. */\nfunction cssBlocks(css: string): Array<{ prelude: string; body: string | null }> {\n  const blocks: Array<{ prelude: string; body: string | null }> = [];\n  let quote: string | null = null;\n  let depth = 0;\n  let start = 0;\n  let bodyStart = 0;\n  let prelude = \"\";\n  for (let index = 0; index < css.length; index++) {\n    const char = css[index];\n    if (quote) {\n      if (char === quote || char === \"\\n\") quote = null;\n    } else if (char === '\"' || char === \"'\") quote = char;\n    else if (char === \"{\") {\n      if (depth++ === 0) {\n        prelude = css.slice(start, index).trim();\n        bodyStart = index + 1;\n      }\n    } else if (char === \"}\") {\n      if (depth === 0) start = index + 1;\n      else if (--depth === 0) {\n        blocks.push({ prelude, body: css.slice(bodyStart, index) });\n        start = index + 1;\n      }\n    } else if (char === \";\" && depth === 0) {\n      blocks.push({ prelude: css.slice(start, index).trim(), body: null });\n      start = index + 1;\n    }\n  }\n  return blocks;\n}\n\n/** Каждая кавычка закрыта на той же строке. */\nfunction quotesClosed(text: string): boolean {\n  let quote: string | null = null;\n  for (const char of text) {\n    if (quote) {\n      if (char === \"\\n\") return false;\n      if (char === quote) quote = null;\n    } else if (char === '\"' || char === \"'\") quote = char;\n  }\n  return quote === null;\n}\n\n/** Знаки, после которых собранная заново таблица прочиталась бы браузером иначе, чем здесь. */\nconst AMBIGUOUS_CSS = /[\\\\{};<@]|\\/\\*|\\*\\//;\n\n/**\n * Селекторы правила, ограниченные корнем рисунка: каждый начинается с `#<id>`, без соседей (`+`, `~`), которые\n * дотянулись бы до страницы рядом. Не ограниченные отбрасываются; не осталось ни одного — null.\n */\nfunction scopedSelectors(prelude: string, rootId: string): string | null {\n  const scope = `#${rootId}`;\n  const kept = splitTopLevel(prelude, \",\")\n    .map((selector) => selector.trim())\n    .filter(\n      (selector) =>\n        selector.startsWith(scope) &&\n        /^(?:$|[\\s.:[>])/.test(selector.slice(scope.length)) &&\n        !/[~+]/.test(selector) &&\n        quotesClosed(selector) &&\n        !AMBIGUOUS_CSS.test(selector),\n    );\n  return kept.length > 0 ? kept.join(\",\") : null;\n}\n\n/** Объявления `свойство:значение` без загрузок, вложенных блоков и опасных свойств. */\nfunction cleanDeclarations(body: string): string {\n  return splitTopLevel(body, \";\")\n    .flatMap((declaration) => {\n      const colon = declaration.indexOf(\":\");\n      if (colon < 0) return [];\n      const property = declaration.slice(0, colon).trim().toLowerCase();\n      const value = declaration.slice(colon + 1).trim();\n      const safe =\n        PROPERTY_NAME.test(property) &&\n        !BLOCKED_PROPERTIES.has(property) &&\n        !escapesFrame(property, value) &&\n        value.length > 0 &&\n        !AMBIGUOUS_CSS.test(value) &&\n        quotesClosed(value) &&\n        !loadsOutside(value);\n      return safe ? [`${declaration.slice(0, colon).trim()}:${value}`] : [];\n    })\n    .join(\";\");\n}\n\n/** Таблица стилей рисунка: только простые правила внутри корня `#<rootId>`; нет id — пусто. */\nfunction cleanCss(css: string, rootId: string | null): string {\n  if (!rootId || !/^[\\w-]+$/.test(rootId)) return \"\";\n  const kept: string[] = [];\n  for (const { prelude, body } of cssBlocks(css)) {\n    if (body === null || prelude.includes(\"@\")) continue;\n    const selectors = scopedSelectors(prelude, rootId);\n    const declarations = selectors && cleanDeclarations(body);\n    if (selectors && declarations) kept.push(`${selectors}{${declarations}}`);\n  }\n  return kept.join(\"\");\n}\n\nfunction isUnsafeAttribute(name: string, value: string): boolean {\n  const lower = name.toLowerCase();\n  if (lower.startsWith(\"on\")) return true;\n  if (lower === \"href\" || lower.endsWith(\":href\")) return !value.trim().startsWith(\"#\");\n  if (lower === \"src\" || lower === \"xml:base\" || lower === \"formaction\" || lower === \"action\") return true;\n  return /javascript:/i.test(value) || loadsOutside(value);\n}\n\n/** `<use>` с чужим адресом удаляется целиком: без адреса он ничего не рисует. */\nfunction usesOutside(element: Element): boolean {\n  return [...element.attributes].some(({ name, value }) => (name === \"href\" || name.endsWith(\":href\")) && !value.trim().startsWith(\"#\"));\n}\n\nfunction cleanAttributes(element: Element): void {\n  for (const { name, value } of [...element.attributes]) {\n    if (name.toLowerCase() === \"style\") element.setAttribute(name, cleanDeclarations(value));\n    else if (isUnsafeAttribute(name, value)) element.removeAttribute(name);\n  }\n}\n\n/** Снять ссылку: её содержимое встаёт на её место. */\nfunction unwrap(element: Element): void {\n  element.replaceWith(...element.childNodes);\n}\n\n/**\n * Чистая разметка корневого `<svg>` из ответа рисовальщика. Всё вне корневого `<svg>` отбрасывается; нет `<svg>` —\n * пустая строка. Разбор — без исполнения: у документа `DOMParser` нет окна, скрипты и картинки в нём не грузятся.\n */\nexport function cleanSvg(markup: string): string {\n  const doc = new DOMParser().parseFromString(markup, \"text/html\");\n  const root = doc.querySelector(\"svg\");\n  if (!root || root.namespaceURI !== SVG_NS) return \"\";\n  for (const element of [root, ...root.querySelectorAll(\"*\")]) {\n    if (!root.contains(element)) continue;\n    const name = element.localName.toLowerCase();\n    if (element.namespaceURI === SVG_NS && name === \"a\") {\n      unwrap(element);\n      continue;\n    }\n    if (element.namespaceURI !== SVG_NS || !ALLOWED_ELEMENTS.has(name) || (name === \"use\" && usesOutside(element))) {\n      element.remove();\n      continue;\n    }\n    cleanAttributes(element);\n    if (name === \"style\") element.textContent = cleanCss(element.textContent ?? \"\", root.getAttribute(\"id\"));\n  }\n  return root.outerHTML;\n}\n","import { cleanSvg } from \"./clean-svg\";\nimport type { DiagramColors, DiagramsClient } from \"./diagram-types\";\n\n/** Длиннее — не рисуем: тяжёлая схема подвесила бы страницу. */\nexport const MAX_SOURCE_LENGTH = 20_000;\n/** Больше узлов и связей — не рисуем. */\nexport const MAX_DIAGRAM_NODES = 200;\n/** Столько готовых рисунков помнится; самый старый забывается первым. */\nconst CACHE_SIZE = 100;\n\ntype Mermaid = typeof import(\"mermaid\").default;\ntype RenderResult = { svg: string } | { error: string };\n\n// Связь в схеме: «-->», «---», «==>», «-.->», «~~~», «->>» и подобные.\nconst LINK = /<?(?:-{2,}|={2,}|-\\.+-|~{3,}|->>)[>ox]?/g;\n\n/**\n * Оценка числа узлов и связей: каждая строка-утверждение — узел, каждая связь сверх первой в строке — ещё узел\n * («A-->B-->C» — три). Заголовок («graph TD») и комментарии («%%») не считаются.\n */\nexport function countDiagramNodes(source: string): number {\n  const statements = source\n    .split(/[\\n;]/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"%%\"))\n    .slice(1);\n  return statements.reduce((total, statement) => total + Math.max(1, statement.match(LINK)?.length ?? 0), 0);\n}\n\nfunction mermaidConfig(colors: DiagramColors) {\n  return {\n    startOnLoad: false,\n    securityLevel: \"strict\" as const,\n    // Подписи — текстом SVG, а не HTML: без foreignObject, и рисунок остаётся векторным.\n    htmlLabels: false,\n    flowchart: { htmlLabels: false },\n    // Ошибка разбора не рисуется на странице: скин сам покажет исходник.\n    suppressErrorRendering: true,\n    maxTextSize: MAX_SOURCE_LENGTH,\n    theme: \"base\" as const,\n    themeVariables: {\n      darkMode: colors.dark,\n      background: colors.background,\n      fontFamily: \"inherit\",\n      textColor: colors.text,\n      primaryColor: colors.node,\n      primaryTextColor: colors.text,\n      primaryBorderColor: colors.line,\n      secondaryColor: colors.background,\n      secondaryTextColor: colors.text,\n      secondaryBorderColor: colors.accent,\n      tertiaryColor: colors.background,\n      tertiaryTextColor: colors.text,\n      tertiaryBorderColor: colors.line,\n      mainBkg: colors.node,\n      nodeBorder: colors.line,\n      lineColor: colors.line,\n      clusterBkg: colors.background,\n      clusterBorder: colors.accent,\n      edgeLabelBackground: colors.background,\n      actorBkg: colors.node,\n      actorBorder: colors.line,\n      actorTextColor: colors.text,\n      signalColor: colors.line,\n      signalTextColor: colors.text,\n      noteBkgColor: colors.background,\n      noteTextColor: colors.text,\n      noteBorderColor: colors.accent,\n    },\n  };\n}\n\n/**\n * Рисовальщик схем: mermaid грузится при первом рисунке (FR-024), рисует в строгом режиме, рисунок чистится (FR-027).\n * Рисунки идут по одному: настройки mermaid общие, и схема в другой теме не должна взять чужие цвета.\n */\nexport function createDiagramsClient(): DiagramsClient {\n  let mermaid: Promise<Mermaid> | null = null;\n  let queue: Promise<unknown> = Promise.resolve();\n  let renderCount = 0;\n  const cache = new Map<string, Promise<RenderResult>>();\n\n  const load = () => (mermaid ??= import(\"mermaid\").then((module) => module.default));\n\n  async function draw(source: string, colors: DiagramColors): Promise<RenderResult> {\n    if (source.length > MAX_SOURCE_LENGTH) return { error: `Схема длиннее ${MAX_SOURCE_LENGTH} знаков` };\n    if (countDiagramNodes(source) > MAX_DIAGRAM_NODES) return { error: `В схеме больше ${MAX_DIAGRAM_NODES} узлов` };\n    try {\n      const api = await load();\n      api.initialize(mermaidConfig(colors));\n      const { svg } = await api.render(`agent-chat-diagram-${++renderCount}`, source);\n      const clean = cleanSvg(svg);\n      return clean ? { svg: clean } : { error: \"Рисовальщик не вернул рисунок\" };\n    } catch (error) {\n      return { error: error instanceof Error ? error.message : String(error) };\n    }\n  }\n\n  return {\n    render(source, colors) {\n      const key = `${JSON.stringify(colors)}\\n${source}`;\n      const cached = cache.get(key);\n      if (cached) return cached;\n      const result = queue.then(() => draw(source, colors));\n      queue = result;\n      if (cache.size >= CACHE_SIZE) cache.delete(cache.keys().next().value!);\n      cache.set(key, result);\n      return result;\n    },\n  };\n}\n","// Пакет схем (specs/024-agent-widgets, contracts/diagrams.md): рисовальщик блоков ```mermaid для экрана чата.\nimport { createDiagramsClient } from \"./diagrams-client\";\n\nexport type { DiagramColors, DiagramsClient } from \"./diagram-types\";\nexport { createDiagramsClient } from \"./diagrams-client\";\nexport { cleanSvg } from \"./clean-svg\";\n\n/** Готовый рисовальщик для `<AgentChat diagrams={diagramsClient} />`: mermaid грузится при первой схеме. */\nexport const diagramsClient = /* @__PURE__ */ createDiagramsClient();\n"],"mappings":"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","names":[]}

package/dist/types/clean-svg.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Чистая разметка корневого `<svg>` из ответа рисовальщика. Всё вне корневого `<svg>` отбрасывается; нет `<svg>` —
+ * пустая строка. Разбор — без исполнения: у документа `DOMParser` нет окна, скрипты и картинки в нём не грузятся.
+ */
+export declare function cleanSvg(markup: string): string;

package/dist/types/diagram-types.d.ts

@@ -0,0 +1,17 @@
+/** Цвета схемы: их отдаёт скин (`ChatSkin.diagramColors`), по ним рисовальщик красит схему. */
+export interface DiagramColors {
+    background: string;
+    text: string;
+    line: string;
+    node: string;
+    accent: string;
+    dark: boolean;
+}
+/** Рисовальщик схем для свойства `diagrams` экрана чата. */
+export interface DiagramsClient {
+    render(source: string, colors: DiagramColors): Promise<{
+        svg: string;
+    } | {
+        error: string;
+    }>;
+}

package/dist/types/diagrams-client.d.ts

@@ -0,0 +1,15 @@
+import type { DiagramsClient } from "./diagram-types.js";
+/** Длиннее — не рисуем: тяжёлая схема подвесила бы страницу. */
+export declare const MAX_SOURCE_LENGTH = 20000;
+/** Больше узлов и связей — не рисуем. */
+export declare const MAX_DIAGRAM_NODES = 200;
+/**
+ * Оценка числа узлов и связей: каждая строка-утверждение — узел, каждая связь сверх первой в строке — ещё узел
+ * («A-->B-->C» — три). Заголовок («graph TD») и комментарии («%%») не считаются.
+ */
+export declare function countDiagramNodes(source: string): number;
+/**
+ * Рисовальщик схем: mermaid грузится при первом рисунке (FR-024), рисует в строгом режиме, рисунок чистится (FR-027).
+ * Рисунки идут по одному: настройки mermaid общие, и схема в другой теме не должна взять чужие цвета.
+ */
+export declare function createDiagramsClient(): DiagramsClient;

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export type { DiagramColors, DiagramsClient } from "./diagram-types.js";
+export { createDiagramsClient } from "./diagrams-client.js";
+export { cleanSvg } from "./clean-svg.js";
+/** Готовый рисовальщик для `<AgentChat diagrams={diagramsClient} />`: mermaid грузится при первой схеме. */
+export declare const diagramsClient: import("./diagram-types.js").DiagramsClient;

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@ykurilov/agent-chat-diagrams",
-  "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"
+    }
+  },
+  "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/diagrams"
+  },
+  "dependencies": {
+    "mermaid": "^12.1.0"
+  },
+  "devDependencies": {
+    "jsdom": "^30.1.1"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }