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

package/dist/panel.js

@@ -0,0 +1,399 @@
+import {
+  AgentChat,
+  activeChatTitle,
+  rememberedIds,
+  useChatLabels,
+  useChatList,
+  useChatListView,
+  useWorkspaceListSync
+} from "./chunk-JZQ7ZOJI.js";
+
+// src/agent-panel/agent-panel-provider.tsx
+import { useCallback as useCallback2, useMemo, useRef, useState, useSyncExternalStore as useSyncExternalStore2 } from "react";
+
+// src/app-bridge/tab-id.ts
+var TAB_ID_KEY = "agent-chat:tab-id";
+var tabOpenKey = (tabId) => `agent-chat:tab-open:${tabId}`;
+var pageTabId = null;
+var listening = false;
+function readTabId() {
+  try {
+    const stored = sessionStorage.getItem(TAB_ID_KEY);
+    if (stored !== null && stored !== "" && (stored === pageTabId || !openElsewhere(stored))) return claim(stored);
+    const created = crypto.randomUUID();
+    sessionStorage.setItem(TAB_ID_KEY, created);
+    return claim(created);
+  } catch {
+    pageTabId ??= crypto.randomUUID();
+    return pageTabId;
+  }
+}
+function openElsewhere(tabId) {
+  try {
+    return localStorage.getItem(tabOpenKey(tabId)) !== null;
+  } catch {
+    return false;
+  }
+}
+function claim(tabId) {
+  if (pageTabId !== tabId) {
+    markOpen(false);
+    pageTabId = tabId;
+    markOpen(true);
+    if (!listening && typeof addEventListener === "function") {
+      listening = true;
+      addEventListener("pagehide", () => markOpen(false));
+      addEventListener("pageshow", () => markOpen(true));
+    }
+  }
+  return tabId;
+}
+function markOpen(open) {
+  if (pageTabId === null) return;
+  try {
+    if (open) localStorage.setItem(tabOpenKey(pageTabId), "1");
+    else localStorage.removeItem(tabOpenKey(pageTabId));
+  } catch {
+  }
+}
+
+// src/app-bridge/create-app-bridge.ts
+var APP_CHANGES_DELIVERED_KEY = "agent-chat:app-changes-delivered";
+var deliveredChanges = rememberedIds(APP_CHANGES_DELIVERED_KEY, 500);
+function createAppBridge(readOptions) {
+  const places = /* @__PURE__ */ new Map();
+  let ownersCreated = 0;
+  const subscriptions = /* @__PURE__ */ new Set();
+  const currentPlace = () => {
+    let current = null;
+    for (const [owner, place] of places) if (current === null || owner.order > current.owner.order) current = { owner, place };
+    return current?.place ?? null;
+  };
+  const bridge = {
+    tabId: readTabId(),
+    currentPlace,
+    dataChanged(change) {
+      if (!deliveredChanges.claim(change.id)) return;
+      const { onDataChanged } = readOptions();
+      if (onDataChanged) deliver(() => onDataChanged(change));
+      for (const subscription of [...subscriptions]) {
+        if (subscription.tags.includes(change.tag)) deliver(() => subscription.handler(change));
+      }
+    },
+    async browserCall(call, options) {
+      const { browserTools, toolUnavailableMessage } = readOptions();
+      const run = browserTools && Object.hasOwn(browserTools, call.toolName) ? browserTools[call.toolName] : void 0;
+      if (!run) return { error: toolUnavailableMessage };
+      try {
+        const output = await run(call.input, { signal: options?.signal ?? new AbortController().signal });
+        return { output };
+      } catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+      }
+    }
+  };
+  return {
+    bridge,
+    createPlaceOwner: () => ({ order: ++ownersCreated }),
+    setPlace(owner, place) {
+      if (place === null) places.delete(owner);
+      else places.set(owner, place);
+    },
+    removePlace: (owner) => void places.delete(owner),
+    subscribe(tags, handler) {
+      const subscription = { tags, handler };
+      subscriptions.add(subscription);
+      return () => void subscriptions.delete(subscription);
+    }
+  };
+}
+function deliver(notify) {
+  try {
+    notify();
+  } catch (error) {
+    if (typeof globalThis.reportError === "function") globalThis.reportError(error);
+    else console.error(error);
+  }
+}
+
+// src/agent-panel/panel-context.ts
+import { createContext, useContext } from "react";
+var AppBridgeContext = createContext(null);
+var PanelControlsContext = createContext(null);
+var PanelViewContext = createContext(null);
+function required(value, user) {
+  if (value === null) throw new Error(`${user} needs AgentPanelProvider above it (import it from "@ykurilov/agent-chat-react/panel")`);
+  return value;
+}
+function useAppBridgeControl(user = "useAppBridgeControl") {
+  return required(useContext(AppBridgeContext), user);
+}
+function usePanelControls(user) {
+  return required(useContext(PanelControlsContext), user);
+}
+function usePanelView(user) {
+  return required(useContext(PanelViewContext), user);
+}
+
+// src/agent-panel/panel-state.ts
+import { useCallback, useSyncExternalStore } from "react";
+var panelOpenKey = (api, userKey) => `agent-chat:panel:${api}:${userKey}`;
+var panelChatKey = (api, userKey) => `agent-chat:panel-chat:${api}:${userKey}`;
+var unsaved = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+var subscribe = (listener) => {
+  listeners.add(listener);
+  return () => void listeners.delete(listener);
+};
+function readPanelOpen(api, userKey) {
+  const key = panelOpenKey(api, userKey);
+  const kept = unsaved.get(key);
+  if (kept !== void 0) return kept;
+  try {
+    return parseOpen(localStorage.getItem(key));
+  } catch {
+    return false;
+  }
+}
+function rememberPanelOpen(api, userKey, open) {
+  const key = panelOpenKey(api, userKey);
+  try {
+    localStorage.setItem(key, JSON.stringify({ open }));
+    unsaved.delete(key);
+  } catch {
+    unsaved.set(key, open);
+  }
+  for (const listener of [...listeners]) listener();
+}
+function usePanelOpen(api, userKey) {
+  const open = useSyncExternalStore(subscribe, () => readPanelOpen(api, userKey), () => false);
+  const setOpen = useCallback((next) => rememberPanelOpen(api, userKey, next), [api, userKey]);
+  return [open, setOpen];
+}
+function parseOpen(stored) {
+  try {
+    const value = JSON.parse(stored ?? "null");
+    return typeof value === "object" && value !== null && value.open === true;
+  } catch {
+    return false;
+  }
+}
+
+// src/agent-panel/agent-panel-provider.tsx
+import { jsx } from "react/jsx-runtime";
+var DEFAULT_WIDTH = 420;
+var NARROW_SCREEN = "(max-width: 640px)";
+function AgentPanelProvider({ api, userKey, browserTools, mode = "overlay", width = DEFAULT_WIDTH, onDataChanged, fetch, children }) {
+  const labels = useChatLabels();
+  const bridgeOptions = useRef({ toolUnavailableMessage: labels.agentPanelToolUnavailable });
+  bridgeOptions.current = {
+    toolUnavailableMessage: labels.agentPanelToolUnavailable,
+    ...browserTools && { browserTools },
+    ...onDataChanged && { onDataChanged }
+  };
+  const [bridgeControl] = useState(() => createAppBridge(() => bridgeOptions.current));
+  const [open, setOpen] = usePanelOpen(api, userKey);
+  const list = useChatList({ api, rememberKey: panelChatKey(api, userKey), ...fetch && { fetch } });
+  const [listOpen, setListOpen] = useState(false);
+  const [busy, setBusy] = useState(false);
+  const [draft, setDraft] = useState(null);
+  const draftCount = useRef(0);
+  const launcherRef = useRef(null);
+  const { activeChatId } = list;
+  const [sessionUser, setSessionUser] = useState(userKey);
+  if (sessionUser !== userKey) {
+    setSessionUser(userKey);
+    setListOpen(false);
+    setDraft(null);
+    setBusy(false);
+  }
+  const currentUser = useRef(userKey);
+  currentUser.current = userKey;
+  const userBridge = useMemo(
+    () => bridgeForUser(bridgeControl.bridge, () => currentUser.current === userKey, () => bridgeOptions.current.toolUnavailableMessage),
+    [bridgeControl, userKey]
+  );
+  if (draft !== null) {
+    if (draft.chatId === null) {
+      if (activeChatId !== null) setDraft({ ...draft, chatId: activeChatId });
+    } else if (draft.chatId !== activeChatId) {
+      setDraft(null);
+    }
+  }
+  const boundDraft = draft !== null && draft.chatId !== null && draft.chatId === activeChatId ? draft : null;
+  const chatBusy = activeChatId !== null && busy;
+  useWorkspaceListSync(list, chatBusy);
+  const narrow = useSyncExternalStore2(subscribeToScreen, readNarrowScreen, () => false);
+  const pageInset = mode === "push" && open && !narrow ? width : 0;
+  const { select, create, deleteRequest, refresh } = list;
+  const showList = useCallback2(
+    (show) => {
+      setListOpen(show);
+      if (show) void refresh();
+    },
+    [refresh]
+  );
+  const toggle = useCallback2(() => setOpen(!open), [open, setOpen]);
+  const openChat = useCallback2(
+    (chatId) => {
+      setOpen(true);
+      setListOpen(false);
+      select(chatId);
+    },
+    [select, setOpen]
+  );
+  const openNewChat = useCallback2(
+    async (options) => {
+      setOpen(true);
+      setListOpen(false);
+      const created = await create();
+      if (currentUser.current !== userKey) return false;
+      if (!created) {
+        showList(true);
+        return false;
+      }
+      if (options?.draft !== void 0) {
+        draftCount.current += 1;
+        setDraft({ text: options.draft, nonce: draftCount.current, chatId: null });
+      }
+      return true;
+    },
+    [create, setOpen, showList, userKey]
+  );
+  const closeList = useCallback2(() => setListOpen(false), []);
+  const escape = useCallback2(() => {
+    if (deleteRequest !== null) return;
+    if (listOpen) setListOpen(false);
+    else setOpen(false);
+  }, [deleteRequest, listOpen, setOpen]);
+  const controls = useMemo(
+    () => ({ open, setOpen, toggle, openChat, openNewChat, pageInset, mode, width, busy: chatBusy }),
+    [chatBusy, mode, open, openChat, openNewChat, pageInset, setOpen, toggle, width]
+  );
+  const view = {
+    api,
+    controls,
+    list,
+    // Список не загрузился и открыть нечего: показать его с ошибкой и «Повторить» сразу.
+    listOpen: listOpen || activeChatId === null && list.status === "error",
+    setListOpen: showList,
+    closeList,
+    escape,
+    chatKey: boundDraft ? `draft:${boundDraft.nonce}:${activeChatId}` : `chat:${activeChatId}`,
+    initialDraft: boundDraft?.text,
+    setBusy,
+    launcherRef,
+    bridge: userBridge
+  };
+  return /* @__PURE__ */ jsx(AppBridgeContext.Provider, { value: bridgeControl, children: /* @__PURE__ */ jsx(PanelControlsContext.Provider, { value: controls, children: /* @__PURE__ */ jsx(PanelViewContext.Provider, { value: view, children }) }) });
+}
+function bridgeForUser(bridge, isCurrent, unavailableMessage) {
+  return {
+    get tabId() {
+      return bridge.tabId;
+    },
+    currentPlace: () => bridge.currentPlace(),
+    dataChanged(change) {
+      if (isCurrent()) bridge.dataChanged(change);
+    },
+    browserCall: (call, options) => isCurrent() ? bridge.browserCall(call, options) : Promise.resolve({ error: unavailableMessage() })
+  };
+}
+function subscribeToScreen(onChange) {
+  if (typeof matchMedia !== "function") return () => {
+  };
+  const query = matchMedia(NARROW_SCREEN);
+  query.addEventListener("change", onChange);
+  return () => query.removeEventListener("change", onChange);
+}
+function readNarrowScreen() {
+  return typeof matchMedia === "function" && matchMedia(NARROW_SCREEN).matches;
+}
+
+// src/agent-panel/agent-panel.tsx
+import { useEffect, useRef as useRef2 } from "react";
+import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
+function AgentPanel({ skin, ...chatProps }) {
+  const view = usePanelView("AgentPanel");
+  const labels = useChatLabels();
+  const { controls, list, launcherRef, setBusy } = view;
+  const listView = useChatListView(list, view.closeList);
+  const wasOpen = useRef2(controls.open);
+  useEffect(() => {
+    if (wasOpen.current && !controls.open) {
+      const focused = document.activeElement;
+      if (focused === null || focused === document.body || focused.closest("[hidden], [inert]") !== null) launcherRef.current?.focus();
+    }
+    wasOpen.current = controls.open;
+  }, [controls.open, launcherRef]);
+  useEffect(() => () => setBusy(false), [setBusy]);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx2(skin.AgentPanelLauncher, { open: controls.open, busy: controls.busy, onToggle: controls.toggle, buttonRef: launcherRef }),
+    /* @__PURE__ */ jsx2(
+      skin.AgentPanel,
+      {
+        open: controls.open,
+        mode: controls.mode,
+        width: controls.width,
+        title: activeChatTitle(list, labels),
+        listOpen: view.listOpen,
+        onListOpenChange: view.setListOpen,
+        onClose: () => controls.setOpen(false),
+        onEscape: view.escape,
+        list: /* @__PURE__ */ jsx2(skin.ChatList, { ...listView }),
+        children: list.activeChatId !== null && /* @__PURE__ */ jsx2(
+          AgentChat,
+          {
+            ...chatProps,
+            api: view.api,
+            chatId: list.activeChatId,
+            skin,
+            onBusyChange: setBusy,
+            appBridge: view.bridge,
+            ...view.initialDraft !== void 0 && { initialDraft: view.initialDraft }
+          },
+          view.chatKey
+        )
+      }
+    )
+  ] });
+}
+
+// src/agent-panel/agent-panel-hooks.ts
+import { useEffect as useEffect2, useRef as useRef3, useState as useState2 } from "react";
+function useAgentPanel() {
+  return usePanelControls("useAgentPanel");
+}
+function useAgentPlace(place) {
+  const control = useAppBridgeControl("useAgentPlace");
+  const [owner] = useState2(() => control.createPlaceOwner());
+  const latest = useRef3(place);
+  latest.current = place;
+  const placeKey = place === null ? null : placeIdentity(place);
+  useEffect2(() => {
+    control.setPlace(owner, latest.current);
+  }, [control, owner, placeKey]);
+  useEffect2(() => () => control.removePlace(owner), [control, owner]);
+}
+function placeIdentity(place) {
+  try {
+    return JSON.stringify(place);
+  } catch {
+    return JSON.stringify({ description: place.description });
+  }
+}
+function useAgentDataChanges(tag, handler) {
+  const control = useAppBridgeControl("useAgentDataChanges");
+  const latest = useRef3(handler);
+  latest.current = handler;
+  const tagsKey = JSON.stringify(typeof tag === "string" ? [tag] : tag);
+  useEffect2(() => control.subscribe(JSON.parse(tagsKey), (change) => latest.current(change)), [control, tagsKey]);
+}
+export {
+  AgentPanel,
+  AgentPanelProvider,
+  useAgentDataChanges,
+  useAgentPanel,
+  useAgentPlace
+};
+//# sourceMappingURL=panel.js.map

package/dist/panel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-panel/agent-panel-provider.tsx","../src/app-bridge/tab-id.ts","../src/app-bridge/create-app-bridge.ts","../src/agent-panel/panel-context.ts","../src/agent-panel/panel-state.ts","../src/agent-panel/agent-panel.tsx","../src/agent-panel/agent-panel-hooks.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { AgentAppBridge, AppDataChange, BrowserToolFunction } from \"../app-bridge/app-bridge\";\nimport { createAppBridge } from \"../app-bridge/create-app-bridge\";\nimport type { AppBridgeOptions } from \"../app-bridge/create-app-bridge\";\nimport { useChatList } from \"../chat-list/use-chat-list\";\nimport { useWorkspaceListSync } from \"../chat-list/use-workspace-list-sync\";\nimport { useChatLabels } from \"../labels\";\nimport { AppBridgeContext, PanelControlsContext, PanelViewContext } from \"./panel-context\";\nimport type { AgentPanelControls, PanelView } from \"./panel-context\";\nimport { panelChatKey, usePanelOpen } from \"./panel-state\";\n\nexport interface AgentPanelProviderProps {\n  /** Адрес обработчика чата, например `/api/chat`. */\n  api: string;\n  /** Номер человека в приложении: открыта ли панель и какой чат открыт, помнится отдельно для каждого. Смена — состояние другого человека. */\n  userKey: string;\n  /** Функции браузерных инструментов по именам (описания задаёт сервер в `agent.browserTools`). */\n  browserTools?: Record<string, BrowserToolFunction>;\n  /** `overlay` — панель поверх страницы, `push` — приложение сдвигает страницу на `pageInset`. По умолчанию `overlay`. */\n  mode?: \"overlay\" | \"push\";\n  /** Ширина панели на широком экране, px. По умолчанию 420. */\n  width?: number;\n  /** Каждое сообщение об изменении данных, любой метки. */\n  onDataChanged?: (change: AppDataChange) => void;\n  /** Свой `fetch` для списка чатов. Сам чат, как и `AgentChat`, ходит через `globalThis.fetch`. */\n  fetch?: typeof globalThis.fetch;\n  children?: ReactNode;\n}\n\nconst DEFAULT_WIDTH = 420;\nconst NARROW_SCREEN = \"(max-width: 640px)\";\n\n/**\n * Состояние панели агента и связь чата с приложением. Ставится в корневой макет, над маршрутами:\n * панель, открытый чат и идущий ответ живут при переходах по страницам приложения.\n */\nexport function AgentPanelProvider({ api, userKey, browserTools, mode = \"overlay\", width = DEFAULT_WIDTH, onDataChanged, fetch, children }: AgentPanelProviderProps) {\n  const labels = useChatLabels();\n  const bridgeOptions = useRef<AppBridgeOptions>({ toolUnavailableMessage: labels.agentPanelToolUnavailable });\n  bridgeOptions.current = {\n    toolUnavailableMessage: labels.agentPanelToolUnavailable,\n    ...(browserTools && { browserTools }),\n    ...(onDataChanged && { onDataChanged }),\n  };\n  const [bridgeControl] = useState(() => createAppBridge(() => bridgeOptions.current));\n\n  const [open, setOpen] = usePanelOpen(api, userKey);\n  const list = useChatList({ api, rememberKey: panelChatKey(api, userKey), ...(fetch && { fetch }) });\n  const [listOpen, setListOpen] = useState(false);\n  const [busy, setBusy] = useState(false);\n  /** Готовый текст для поля ввода; `chatId: null` — привяжется к чату, который откроет `openNewChat`. */\n  const [draft, setDraft] = useState<{ text: string; nonce: number; chatId: string | null } | null>(null);\n  const draftCount = useRef(0);\n  const launcherRef = useRef<HTMLButtonElement | null>(null);\n  const { activeChatId } = list;\n\n  // Сменился человек: его панель, без списка и текста прежнего.\n  const [sessionUser, setSessionUser] = useState(userKey);\n  if (sessionUser !== userKey) {\n    setSessionUser(userKey);\n    setListOpen(false);\n    setDraft(null);\n    setBusy(false);\n  }\n  /** Человек на экране сейчас: действие, начатое для прежнего, после ожидания ничего не меняет. */\n  const currentUser = useRef(userKey);\n  currentUser.current = userKey;\n  // Мост чата этого человека: поток чата прежнего, который ещё не оборвался, не раздаёт изменения и не делает действий на странице.\n  const userBridge = useMemo(\n    () => bridgeForUser(bridgeControl.bridge, () => currentUser.current === userKey, () => bridgeOptions.current.toolUnavailableMessage),\n    [bridgeControl, userKey],\n  );\n  if (draft !== null) {\n    if (draft.chatId === null) {\n      if (activeChatId !== null) setDraft({ ...draft, chatId: activeChatId });\n    } else if (draft.chatId !== activeChatId) {\n      setDraft(null);\n    }\n  }\n  const boundDraft = draft !== null && draft.chatId !== null && draft.chatId === activeChatId ? draft : null;\n\n  const chatBusy = activeChatId !== null && busy;\n  useWorkspaceListSync(list, chatBusy);\n  const narrow = useSyncExternalStore(subscribeToScreen, readNarrowScreen, () => false);\n  const pageInset = mode === \"push\" && open && !narrow ? width : 0;\n\n  const { select, create, deleteRequest, refresh } = list;\n  // Список открывается поверх чата: свежий с сервера (чат могли удалить или переименовать в другой вкладке).\n  const showList = useCallback(\n    (show: boolean) => {\n      setListOpen(show);\n      if (show) void refresh();\n    },\n    [refresh],\n  );\n  const toggle = useCallback(() => setOpen(!open), [open, setOpen]);\n  const openChat = useCallback(\n    (chatId: string) => {\n      setOpen(true);\n      setListOpen(false);\n      select(chatId);\n    },\n    [select, setOpen],\n  );\n  const openNewChat = useCallback(\n    async (options?: { draft?: string }) => {\n      setOpen(true);\n      setListOpen(false);\n      const created = await create();\n      if (currentUser.current !== userKey) return false;\n      if (!created) {\n        showList(true);\n        return false;\n      }\n      if (options?.draft !== undefined) {\n        draftCount.current += 1;\n        setDraft({ text: options.draft, nonce: draftCount.current, chatId: null });\n      }\n      return true;\n    },\n    [create, setOpen, showList, userKey],\n  );\n  const closeList = useCallback(() => setListOpen(false), []);\n  // Esc: ждёт подтверждения удаления — ничего; открыт список — назад к чату; иначе закрыть панель.\n  const escape = useCallback(() => {\n    if (deleteRequest !== null) return;\n    if (listOpen) setListOpen(false);\n    else setOpen(false);\n  }, [deleteRequest, listOpen, setOpen]);\n\n  const controls = useMemo<AgentPanelControls>(\n    () => ({ open, setOpen, toggle, openChat, openNewChat, pageInset, mode, width, busy: chatBusy }),\n    [chatBusy, mode, open, openChat, openNewChat, pageInset, setOpen, toggle, width],\n  );\n  const view: PanelView = {\n    api,\n    controls,\n    list,\n    // Список не загрузился и открыть нечего: показать его с ошибкой и «Повторить» сразу.\n    listOpen: listOpen || (activeChatId === null && list.status === \"error\"),\n    setListOpen: showList,\n    closeList,\n    escape,\n    chatKey: boundDraft ? `draft:${boundDraft.nonce}:${activeChatId}` : `chat:${activeChatId}`,\n    initialDraft: boundDraft?.text,\n    setBusy,\n    launcherRef,\n    bridge: userBridge,\n  };\n\n  return (\n    <AppBridgeContext.Provider value={bridgeControl}>\n      <PanelControlsContext.Provider value={controls}>\n        <PanelViewContext.Provider value={view}>{children}</PanelViewContext.Provider>\n      </PanelControlsContext.Provider>\n    </AppBridgeContext.Provider>\n  );\n}\n\n/** Мост, который молчит, когда `isCurrent()` ложно: сообщения об изменениях не раздаются, браузерные вызовы не исполняются. */\nfunction bridgeForUser(bridge: AgentAppBridge, isCurrent: () => boolean, unavailableMessage: () => string): AgentAppBridge {\n  return {\n    get tabId() {\n      return bridge.tabId;\n    },\n    currentPlace: () => bridge.currentPlace(),\n    dataChanged(change) {\n      if (isCurrent()) bridge.dataChanged(change);\n    },\n    browserCall: (call, options) => (isCurrent() ? bridge.browserCall(call, options) : Promise.resolve({ error: unavailableMessage() })),\n  };\n}\n\nfunction subscribeToScreen(onChange: () => void): () => void {\n  if (typeof matchMedia !== \"function\") return () => {};\n  const query = matchMedia(NARROW_SCREEN);\n  query.addEventListener(\"change\", onChange);\n  return () => query.removeEventListener(\"change\", onChange);\n}\n\nfunction readNarrowScreen(): boolean {\n  return typeof matchMedia === \"function\" && matchMedia(NARROW_SCREEN).matches;\n}\n","/** Под этим ключом `sessionStorage` хранит номер вкладки: переживает перезагрузку, у новой вкладки свой. */\nexport const TAB_ID_KEY = \"agent-chat:tab-id\";\n\n/**\n * Под ключом `agent-chat:tab-open:{номер}` `localStorage` отмечает, что страница с этим номером открыта; уходя (`pagehide`),\n * страница снимает отметку. «Дублировать вкладку» копирует `sessionStorage` вместе с номером, но исходная вкладка ещё открыта —\n * дубликат видит отметку и берёт себе новый номер. Иначе обе вкладки исполнили бы один браузерный вызов.\n */\nexport const tabOpenKey = (tabId: string) => `agent-chat:tab-open:${tabId}`;\n\n/** Номер, который заняла эта страница; на время жизни страницы. */\nlet pageTabId: string | null = null;\nlet listening = false;\n\n/** Номер этой вкладки: прочитанный из `sessionStorage`, если другая открытая вкладка его не занимает, иначе новый случайный. */\nexport function readTabId(): string {\n  try {\n    const stored = sessionStorage.getItem(TAB_ID_KEY);\n    if (stored !== null && stored !== \"\" && (stored === pageTabId || !openElsewhere(stored))) return claim(stored);\n    const created = crypto.randomUUID();\n    sessionStorage.setItem(TAB_ID_KEY, created);\n    return claim(created);\n  } catch {\n    // Приватный режим: номер один на страницу, после перезагрузки — новый.\n    pageTabId ??= crypto.randomUUID();\n    return pageTabId;\n  }\n}\n\nfunction openElsewhere(tabId: string): boolean {\n  try {\n    return localStorage.getItem(tabOpenKey(tabId)) !== null;\n  } catch {\n    return false;\n  }\n}\n\nfunction claim(tabId: string): string {\n  if (pageTabId !== tabId) {\n    markOpen(false);\n    pageTabId = tabId;\n    markOpen(true);\n    if (!listening && typeof addEventListener === \"function\") {\n      listening = true;\n      addEventListener(\"pagehide\", () => markOpen(false));\n      addEventListener(\"pageshow\", () => markOpen(true));\n    }\n  }\n  return tabId;\n}\n\nfunction markOpen(open: boolean) {\n  if (pageTabId === null) return;\n  try {\n    if (open) localStorage.setItem(tabOpenKey(pageTabId), \"1\");\n    else localStorage.removeItem(tabOpenKey(pageTabId));\n  } catch {\n    // Хранилище недоступно: дубликат не отличить, номер останется общим.\n  }\n}\n","import type { AgentAppBridge, AppDataChange, BrowserToolFunction, ScreenPlace } from \"./app-bridge\";\nimport { rememberedIds } from \"./remembered-ids\";\nimport { readTabId } from \"./tab-id\";\n\n/** Что мост берёт у приложения; читается в момент вызова, поэтому новые свойства провайдера видны без нового моста. */\nexport interface AppBridgeOptions {\n  /** Функции браузерных инструментов по именам. */\n  browserTools?: Record<string, BrowserToolFunction>;\n  /** Получает каждое сообщение об изменении данных, любой метки. */\n  onDataChanged?: (change: AppDataChange) => void;\n  /** Ответ модели, если функции инструмента на этой странице нет. */\n  toolUnavailableMessage: string;\n}\n\n/** Владелец места: чем больше `order`, тем позже создан и тем главнее его место. */\nexport interface PlaceOwner {\n  readonly order: number;\n}\n\n/** Мост и то, чем его наполняют хуки панели: места компонентов и подписки на изменения данных. */\nexport interface AppBridgeControl {\n  bridge: AgentAppBridge;\n  /**\n   * Владелец места для одного компонента; создаётся при его первой отрисовке. Владелец, созданный позже, главнее:\n   * вложенный компонент рисуется после внешнего, поэтому страница всегда главнее макета, в котором стоит.\n   */\n  createPlaceOwner(): PlaceOwner;\n  /** Место компонента `owner`; смена места не меняет, чьё главнее. `null` — снять своё место. */\n  setPlace(owner: PlaceOwner, place: ScreenPlace | null): void;\n  /** Снимает только место `owner`; места других компонентов остаются. */\n  removePlace(owner: PlaceOwner): void;\n  /** Подписка на сообщения с одной из меток `tags`; возвращает отписку. */\n  subscribe(tags: readonly string[], handler: (change: AppDataChange) => void): () => void;\n}\n\n/**\n * Под этим ключом `sessionStorage` хранит `id` розданных сообщений (последние 500): повтор кусков ответа, в том числе\n * после перезагрузки страницы во время ответа, не раздаёт сообщение второй раз.\n */\nexport const APP_CHANGES_DELIVERED_KEY = \"agent-chat:app-changes-delivered\";\n\nconst deliveredChanges = rememberedIds(APP_CHANGES_DELIVERED_KEY, 500);\n\nexport function createAppBridge(readOptions: () => AppBridgeOptions): AppBridgeControl {\n  /** Заданные места; текущее — у владельца с наибольшим `order`. */\n  const places = new Map<PlaceOwner, ScreenPlace>();\n  let ownersCreated = 0;\n  const subscriptions = new Set<{ tags: readonly string[]; handler: (change: AppDataChange) => void }>();\n\n  const currentPlace = () => {\n    let current: { owner: PlaceOwner; place: ScreenPlace } | null = null;\n    for (const [owner, place] of places) if (current === null || owner.order > current.owner.order) current = { owner, place };\n    return current?.place ?? null;\n  };\n\n  const bridge: AgentAppBridge = {\n    tabId: readTabId(),\n    currentPlace,\n    dataChanged(change) {\n      if (!deliveredChanges.claim(change.id)) return;\n      const { onDataChanged } = readOptions();\n      if (onDataChanged) deliver(() => onDataChanged(change));\n      for (const subscription of [...subscriptions]) {\n        if (subscription.tags.includes(change.tag)) deliver(() => subscription.handler(change));\n      }\n    },\n    async browserCall(call, options) {\n      const { browserTools, toolUnavailableMessage } = readOptions();\n      const run = browserTools && Object.hasOwn(browserTools, call.toolName) ? browserTools[call.toolName] : undefined;\n      if (!run) return { error: toolUnavailableMessage };\n      try {\n        const output = await run(call.input, { signal: options?.signal ?? new AbortController().signal });\n        return { output };\n      } catch (error) {\n        return { error: error instanceof Error ? error.message : String(error) };\n      }\n    },\n  };\n\n  return {\n    bridge,\n    createPlaceOwner: () => ({ order: ++ownersCreated }),\n    setPlace(owner, place) {\n      if (place === null) places.delete(owner);\n      else places.set(owner, place);\n    },\n    removePlace: (owner) => void places.delete(owner),\n    subscribe(tags, handler) {\n      const subscription = { tags, handler };\n      subscriptions.add(subscription);\n      return () => void subscriptions.delete(subscription);\n    },\n  };\n}\n\n/** Ошибка одного подписчика не мешает остальным и не обрывает поток ответа; она уходит в журнал страницы. */\nfunction deliver(notify: () => void) {\n  try {\n    notify();\n  } catch (error) {\n    if (typeof globalThis.reportError === \"function\") globalThis.reportError(error);\n    else console.error(error);\n  }\n}\n","import { createContext, useContext } from \"react\";\nimport type { RefObject } from \"react\";\nimport type { AppBridgeControl } from \"../app-bridge/create-app-bridge\";\nimport type { ChatListState } from \"../chat-list/use-chat-list\";\n\n/** Управление панелью из кода приложения (`useAgentPanel`). */\nexport interface AgentPanelControls {\n  open: boolean;\n  setOpen(open: boolean): void;\n  toggle(): void;\n  /** Открыть панель на чате; чужой или удалённый — «Чат не найден», список — по кнопке «Чаты». */\n  openChat(chatId: string): void;\n  /** Новый (или пустой) чат и готовый текст в поле ввода. `false` — не создался (список открыт с ошибкой). */\n  openNewChat(options?: { draft?: string }): Promise<boolean>;\n  /** Отступ справа для страницы в режиме `push`; 0 — закрыто, режим `overlay` или экран ≤ 640 px. */\n  pageInset: number;\n  mode: \"overlay\" | \"push\";\n  width: number;\n  /** Идёт ответ в открытом чате — для значка на кнопке. */\n  busy: boolean;\n}\n\n/** То, что нужно `AgentPanel`, чтобы нарисовать кнопку, рамку, список и открытый чат. */\nexport interface PanelView {\n  api: string;\n  controls: AgentPanelControls;\n  list: ChatListState;\n  listOpen: boolean;\n  setListOpen(open: boolean): void;\n  /** Список выбран или создан: закрыть его. */\n  closeList(): void;\n  /** Esc внутри панели: открыт список — закрыть его, иначе закрыть панель; при подтверждении удаления — ничего. */\n  escape(): void;\n  /** Ключ открытого чата: меняется вместе с чатом и с новым готовым текстом. */\n  chatKey: string;\n  initialDraft: string | undefined;\n  setBusy(busy: boolean): void;\n  launcherRef: RefObject<HTMLButtonElement | null>;\n  bridge: AppBridgeControl[\"bridge\"];\n}\n\nexport const AppBridgeContext = createContext<AppBridgeControl | null>(null);\nexport const PanelControlsContext = createContext<AgentPanelControls | null>(null);\nexport const PanelViewContext = createContext<PanelView | null>(null);\n\nfunction required<T>(value: T | null, user: string): T {\n  if (value === null) throw new Error(`${user} needs AgentPanelProvider above it (import it from \"@ykurilov/agent-chat-react/panel\")`);\n  return value;\n}\n\n/** Мост и регистрация мест и подписок; для хуков панели. */\nexport function useAppBridgeControl(user = \"useAppBridgeControl\"): AppBridgeControl {\n  return required(useContext(AppBridgeContext), user);\n}\n\nexport function usePanelControls(user: string): AgentPanelControls {\n  return required(useContext(PanelControlsContext), user);\n}\n\nexport function usePanelView(user: string): PanelView {\n  return required(useContext(PanelViewContext), user);\n}\n","import { useCallback, useSyncExternalStore } from \"react\";\n\n/** Под этим ключом `localStorage` помнит, открыта ли панель: `{ \"open\": boolean }`. */\nexport const panelOpenKey = (api: string, userKey: string) => `agent-chat:panel:${api}:${userKey}`;\n\n/** Под этим ключом `useChatList` помнит чат, открытый в панели у этого человека. */\nexport const panelChatKey = (api: string, userKey: string) => `agent-chat:panel-chat:${api}:${userKey}`;\n\n/** Состояние, которое не записалось в хранилище (недоступно или переполнено): живёт в памяти страницы и главнее записанного раньше. */\nconst unsaved = new Map<string, boolean>();\nconst listeners = new Set<() => void>();\nconst subscribe = (listener: () => void) => {\n  listeners.add(listener);\n  return () => void listeners.delete(listener);\n};\n\n/** Была ли панель открыта у этого человека. Нет записи, битая запись или хранилище недоступно — закрыта. */\nexport function readPanelOpen(api: string, userKey: string): boolean {\n  const key = panelOpenKey(api, userKey);\n  const kept = unsaved.get(key);\n  if (kept !== undefined) return kept;\n  try {\n    return parseOpen(localStorage.getItem(key));\n  } catch {\n    return false;\n  }\n}\n\nexport function rememberPanelOpen(api: string, userKey: string, open: boolean): void {\n  const key = panelOpenKey(api, userKey);\n  try {\n    localStorage.setItem(key, JSON.stringify({ open }));\n    unsaved.delete(key);\n  } catch {\n    unsaved.set(key, open);\n  }\n  for (const listener of [...listeners]) listener();\n}\n\n/**\n * Открыта ли панель у этого человека; смена `api` или `userKey` — его запомненное состояние.\n * При отрисовке на сервере и в первом проходе гидратации — закрыта, потом — запомненное: разметка не расходится.\n */\nexport function usePanelOpen(api: string, userKey: string): [boolean, (open: boolean) => void] {\n  const open = useSyncExternalStore(subscribe, () => readPanelOpen(api, userKey), () => false);\n  const setOpen = useCallback((next: boolean) => rememberPanelOpen(api, userKey, next), [api, userKey]);\n  return [open, setOpen];\n}\n\nfunction parseOpen(stored: string | null): boolean {\n  try {\n    const value: unknown = JSON.parse(stored ?? \"null\");\n    return typeof value === \"object\" && value !== null && (value as { open?: unknown }).open === true;\n  } catch {\n    return false;\n  }\n}\n","import { useEffect, useRef } from \"react\";\nimport { AgentChat } from \"../agent-chat\";\nimport type { AgentChatProps } from \"../agent-chat\";\nimport type { ChatListSkin } from \"../chat-list/chat-list-skin\";\nimport { activeChatTitle, useChatListView } from \"../chat-list/use-chat-list-view\";\nimport { useChatLabels } from \"../labels\";\nimport type { ChatSkin } from \"../skin-contract\";\nimport type { AgentPanelSkin } from \"./agent-panel-skin\";\nimport { usePanelView } from \"./panel-context\";\n\nexport interface AgentPanelProps extends Omit<AgentChatProps, \"api\" | \"chatId\" | \"subject\" | \"skin\" | \"onBusyChange\" | \"appBridge\" | \"initialDraft\"> {\n  /** Скин чата, списка и панели (например, `tandemSkin`). */\n  skin: ChatSkin & ChatListSkin & AgentPanelSkin;\n}\n\n/**\n * Кнопка агента и панель с открытым чатом и списком чатов поверх него. Всё видимое рисует скин.\n * Открытый чат смонтирован и при закрытой панели: ответ идёт, подписчики на изменения данных слышат его.\n */\nexport function AgentPanel({ skin, ...chatProps }: AgentPanelProps) {\n  const view = usePanelView(\"AgentPanel\");\n  const labels = useChatLabels();\n  const { controls, list, launcherRef, setBusy } = view;\n  const listView = useChatListView(list, view.closeList);\n\n  // Закрылась: фокус был в панели (теперь скрытой) или потерян — вернуть его на кнопку агента. Фокус на странице не трогаем.\n  const wasOpen = useRef(controls.open);\n  useEffect(() => {\n    if (wasOpen.current && !controls.open) {\n      const focused = document.activeElement;\n      if (focused === null || focused === document.body || focused.closest(\"[hidden], [inert]\") !== null) launcherRef.current?.focus();\n    }\n    wasOpen.current = controls.open;\n  }, [controls.open, launcherRef]);\n\n  // Кнопку и панель убрали со страницы: о занятости открытого чата больше некому сообщить.\n  useEffect(() => () => setBusy(false), [setBusy]);\n\n  return (\n    <>\n      <skin.AgentPanelLauncher open={controls.open} busy={controls.busy} onToggle={controls.toggle} buttonRef={launcherRef} />\n      <skin.AgentPanel\n        open={controls.open}\n        mode={controls.mode}\n        width={controls.width}\n        title={activeChatTitle(list, labels)}\n        listOpen={view.listOpen}\n        onListOpenChange={view.setListOpen}\n        onClose={() => controls.setOpen(false)}\n        onEscape={view.escape}\n        list={<skin.ChatList {...listView} />}\n      >\n        {list.activeChatId !== null && (\n          <AgentChat\n            key={view.chatKey}\n            {...chatProps}\n            api={view.api}\n            chatId={list.activeChatId}\n            skin={skin}\n            onBusyChange={setBusy}\n            appBridge={view.bridge}\n            {...(view.initialDraft !== undefined && { initialDraft: view.initialDraft })}\n          />\n        )}\n      </skin.AgentPanel>\n    </>\n  );\n}\n","import { useEffect, useRef, useState } from \"react\";\nimport type { AppDataChange, ScreenPlace } from \"../app-bridge/app-bridge\";\nimport { useAppBridgeControl, usePanelControls } from \"./panel-context\";\nimport type { AgentPanelControls } from \"./panel-context\";\n\nexport type { AgentPanelControls } from \"./panel-context\";\n\n/** Управление панелью из кода приложения: открыть, закрыть, открыть чат, новый чат с готовым текстом, отступ для `push`. */\nexport function useAgentPanel(): AgentPanelControls {\n  return usePanelControls(\"useAgentPanel\");\n}\n\n/**\n * Где сейчас человек: место уходит с каждым запросом хода, пока компонент на экране. Главнее место компонента, который\n * появился на экране позже; вложенный всегда главнее внешнего (страница главнее макета, в котором стоит), и при первом\n * показе, и после переходов. Смена места не меняет, чьё главнее. `null` или размонтирование снимает только это место —\n * снова действует место другого компонента.\n */\nexport function useAgentPlace(place: ScreenPlace | null): void {\n  const control = useAppBridgeControl(\"useAgentPlace\");\n  const [owner] = useState(() => control.createPlaceOwner());\n  const latest = useRef(place);\n  latest.current = place;\n  const placeKey = place === null ? null : placeIdentity(place);\n  useEffect(() => {\n    control.setPlace(owner, latest.current);\n  }, [control, owner, placeKey]);\n  useEffect(() => () => control.removePlace(owner), [control, owner]);\n}\n\n/** Ключ места для зависимостей эффекта. `data` не превращается в JSON (цикл, BigInt) — ключ без неё: при отправке её отбросят. */\nfunction placeIdentity(place: ScreenPlace): string {\n  try {\n    return JSON.stringify(place);\n  } catch {\n    return JSON.stringify({ description: place.description });\n  }\n}\n\n/** Подписка на изменения данных по метке (или списку меток). Подписчик зовётся один раз на сообщение, всегда свежий. */\nexport function useAgentDataChanges(tag: string | readonly string[], handler: (change: AppDataChange) => void): void {\n  const control = useAppBridgeControl(\"useAgentDataChanges\");\n  const latest = useRef(handler);\n  latest.current = handler;\n  const tagsKey = JSON.stringify(typeof tag === \"string\" ? [tag] : tag);\n  useEffect(() => control.subscribe(JSON.parse(tagsKey) as string[], (change) => latest.current(change)), [control, tagsKey]);\n}\n"],"mappings":"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","names":["useCallback","useSyncExternalStore","useSyncExternalStore","useCallback","useRef","jsx","useRef","useEffect","useRef","useState","useState","useRef","useEffect"]}

package/dist/types/agent-chat-extensions.d.ts

@@ -0,0 +1,76 @@
+import type { DynamicToolUIPart, ToolUIPart } from "ai";
+import type { ComponentType } from "react";
+import type { AppEventViews } from "./app-events.js";
+import type { AgentVideoView, CustomWidgetProps, DiagramColors, GeneratedImagesView } from "./skin-contract.js";
+import type { StepPhrases, WorkView } from "./work-view/step-phrases.js";
+/** Рисовальщик схем (пакет `@ykurilov/agent-chat-diagrams`, `diagramsClient`): тот же договор, что в пакете схем. */
+export interface DiagramsClient {
+    render(source: string, colors: DiagramColors): Promise<{
+        svg: string;
+    } | {
+        error: string;
+    }>;
+}
+/**
+ * Картинки агента на экране (пакет `@ykurilov/agent-chat-images`, `imagesClient`): сообщает слою поведения имя инструмента
+ * и превращает его вызов в вид для скина. Нет `describe`-результата — вызов остаётся обычной строкой инструмента.
+ */
+export interface ImagesClient {
+    /** Имя инструмента, чьи вызовы рисуются как картинки: `generate_images`. */
+    toolName: string;
+    describe(call: {
+        part: ToolUIPart | DynamicToolUIPart;
+        api: string;
+        chatId: string;
+        /** Открыть картинку в окне просмотра; `key` — id вложения. */
+        openImage: (key: string, trigger: HTMLElement) => void;
+    }): GeneratedImagesView | undefined;
+}
+/**
+ * Видео агента на экране (пакет `@ykurilov/agent-chat-videos`, `videosClient`): превращает вызов `show_video` в вид
+ * карточки. `loading` — вызов идёт, ничего не показывать; `undefined` — отказ или ошибка, обычная строка инструмента.
+ */
+export interface VideosClient {
+    /** Имя инструмента, чьи вызовы рисуются как видео: `show_video`. */
+    toolName: string;
+    describe(part: ToolUIPart | DynamicToolUIPart): {
+        state: "loading";
+    } | {
+        state: "ready";
+        video: AgentVideoView;
+    } | undefined;
+}
+/** Свои виджеты страницы: имя инструмента → компонент. Типы входа и ответа у каждого свои, поэтому `any`. */
+export type CustomWidgets = Record<string, ComponentType<CustomWidgetProps<any, any>>>;
+/**
+ * Необязательные расширения чата, которые страница подключает свойствами `AgentChat`, `ChatWorkspace` и `AgentPanel`
+ * и которые слой поведения несёт вниз до частей ответа. Без них отрисовка и запросы, как в 0.15.
+ */
+export interface AgentChatExtensions {
+    /** Свои виджеты: `{ pick_slot: PickSlotWidget }`. Базовые виджеты свойства не требуют. */
+    widgets?: CustomWidgets;
+    /** Схемы из блоков ```mermaid: `diagramsClient`. */
+    diagrams?: DiagramsClient;
+    /**
+     * Живые демонстрации из блоков ```html-demo (specs/043-live-demos): `true` — блок запускается в изолированной рамке.
+     * На сервере — `agent.liveDemos: true`.
+     */
+    liveDemos?: boolean;
+    /** Картинки агента: `imagesClient`. */
+    images?: ImagesClient;
+    /** Видео агента: `videosClient`. */
+    videos?: VideosClient;
+    /** Вид событий приложения в ответе: тип события → компонент (`{ lesson_passed: LessonPassedBadge }`). */
+    appEvents?: AppEventViews;
+    /**
+     * Вид работы агента: `detailed` (по умолчанию) — мысли и строки инструментов, как раньше; `simple` — для новичков:
+     * живая строка с текущим шагом, после хода «Сделано N шагов» со списком понятных фраз. Меняется на лету. Это
+     * отображение, а не права: что прячется от человека, решают права чата (`toolDetails`, `reasoning`).
+     */
+    workView?: WorkView;
+    /**
+     * Понятные фразы шагов для простого вида: имя инструмента → фразы «идёт» и «готово» (готовые или функция от вызова).
+     * Нет фразы — `title` инструмента, иначе общая из `labels.workView`. Таблицу держите постоянной.
+     */
+    stepPhrases?: StepPhrases;
+}