An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
import {SessionIndexItem, SessionStore} from "./SessionStore";
import {escapeHtml} from "../../../util/escape";
import {setPosition} from "../../../util/setPosition";
import {hasClosestByClassName} from "../../../protyle/util/hasClosest";
import {upDownHint} from "../../../util/upDownHint";
import type {AgentSessionRunStatus} from "./AgentSessionRuns";
/// #if !BROWSER
import * as path from "path";
import {useShell} from "../../../util/pathName";
/// #endif
import {getHostCapabilities} from "../../../util/hostCapabilities";
import {isInMobileApp, isPhablet} from "../../../protyle/util/compatibility";
import {bindMenuMouseScroll} from "../../../menus/menuMouseScroll";
import {showMessage} from "../../../dialog/message";
export class AgentSessionPanel {
private popup: HTMLElement | null = null;
private isRendering = false;
private items: SessionIndexItem[] = [];
private total = 0;
private page = 0;
private isLoadingMore = false;
private searchTimer: number | null = null;
private searchKeyword = "";
private removeCloseListeners: (() => void) | undefined;
constructor(
private triggerBtn: HTMLElement,
private host: HTMLElement,
private getCurrentSessionId: () => string,
private getDefaultTitle: () => string,
private callbacks: {
onSwitch: (id: string) => Promise<void>;
onDelete: (id: string) => Promise<void>;
onRename: (id: string, title: string) => Promise<void>;
getStatus?: (id: string) => AgentSessionRunStatus | undefined;
getTitle?: (id: string) => string | undefined;
},
private mobile = false,
) {
}
isOpen() {
return !!this.popup;
}
toggle() {
if (this.isRendering) {
return;
}
if (this.popup) {
this.close();
return;
}
this.render();
}
close(immediate = false) {
this.removeCloseListeners?.();
this.removeCloseListeners = undefined;
this.closeAllSubmenus();
document.querySelectorAll<HTMLElement>(".agent-session-popup").forEach(el => {
const transform = getComputedStyle(el).transform;
el.getAnimations().forEach(animation => animation.cancel());
if (this.mobile && !immediate && el === this.popup) {
const animation = el.animate([
{transform},
{transform: "translateX(100%)"},
], {
duration: 150,
easing: "cubic-bezier(0, 0, .2, 1)",
fill: "forwards",
});
animation.finished.then(() => el.remove(), () => {});
} else {
el.remove();
}
});
this.popup = null;
this.searchKeyword = "";
this.items = [];
this.total = 0;
this.page = 0;
if (this.searchTimer !== null) {
clearTimeout(this.searchTimer);
this.searchTimer = null;
}
}
destroy() {
this.close(true);
}
private async render() {
this.isRendering = true;
this.close(true);
try {
const result = await SessionStore.list({page: 1, pageSize: 30});
this.items = result.sessions;
this.total = result.total;
this.page = 1;
this.popup = document.createElement("div");
this.popup.className = this.mobile ?
"agent-session-popup agent-session-popup--mobile fn__flex-column" :
"agent-session-popup b3-menu";
const L = window.siyuan.languages;
let html = this.mobile ? '<div class="toolbar toolbar--border">' +
'<svg class="toolbar__icon" data-type="back"><use xlink:href="#iconLeft"></use></svg>' +
'<span class="toolbar__text">' + L.manageSessions + "</span></div>" : "";
html += '<input spellcheck="false" class="b3-text-field agent-session-popup__search" placeholder="' + L.agentSessionSearch + '">';
html += '<div class="b3-list b3-list--background fn__flex-1"></div>';
this.popup.innerHTML = html;
const itemsContainer = this.popup.querySelector(".b3-list") as HTMLElement;
if (!this.mobile) {
bindMenuMouseScroll(this.popup, () => !isInMobileApp() &&
window.siyuan.config.appearance?.menuMouseScroll === true, itemsContainer);
}
this.renderItems(itemsContainer, result.sessions, false);
const searchInput = this.popup.querySelector(".agent-session-popup__search") as HTMLInputElement;
this.popup.querySelector('[data-type="back"]')?.addEventListener("click", () => this.close());
searchInput.addEventListener("input", (event: InputEvent) => {
event.stopPropagation();
if (event.isComposing) {
return;
}
this.filter(searchInput.value, itemsContainer);
});
searchInput.addEventListener("compositionend", () => {
this.filter(searchInput.value, itemsContainer);
});
searchInput.addEventListener("keydown", (event) => {
if (event.isComposing) {
return;
}
upDownHint(itemsContainer, event);
});
itemsContainer.addEventListener("scroll", () => {
this.closeAllSubmenus();
if (this.isLoadingMore) {
return;
}
if (this.items.length >= this.total) {
return;
}
if (itemsContainer.scrollHeight - itemsContainer.scrollTop - itemsContainer.clientHeight <= 30) {
this.loadMore(itemsContainer);
}
});
// 桌面端浮层使用视口坐标定位,挂到顶层可避免受浮动 Dock 的变换坐标系和裁剪影响。
if (this.mobile) {
this.host.appendChild(this.popup);
this.popup.animate([
{transform: "translateX(100%)"},
{transform: "translateX(0)"},
], {
duration: 150,
easing: "cubic-bezier(0, 0, .2, 1)",
});
} else {
document.body.appendChild(this.popup);
}
this.popup.style.zIndex = (++window.siyuan.zIndex).toString();
if (!this.mobile) {
const btnRect = this.triggerBtn.getBoundingClientRect();
setPosition(this.popup, btnRect.right - 280, btnRect.bottom, btnRect.height, btnRect.width);
}
this.popup.addEventListener("click", (e: MouseEvent) => {
e.stopPropagation();
});
const onResize = () => {
if (isPhablet() && this.popup) {
// 平板软键盘改变视口时重新定位,保留会话搜索与列表。
const btnRect = this.triggerBtn.getBoundingClientRect();
setPosition(this.popup, btnRect.right - 280, btnRect.bottom, btnRect.height, btnRect.width);
return;
}
this.close();
};
if (!this.mobile) {
window.addEventListener("resize", onResize);
}
const closeOut = () => {
this.close();
};
const closeTimer = setTimeout(() => {
document.addEventListener("click", closeOut);
}, 10);
this.removeCloseListeners = () => {
clearTimeout(closeTimer);
document.removeEventListener("click", closeOut);
window.removeEventListener("resize", onResize);
};
if (!this.mobile && !isPhablet()) {
searchInput.focus();
}
} finally {
this.isRendering = false;
}
}
private renderItems(container: HTMLElement, listItems: SessionIndexItem[], append: boolean) {
let html = "";
if (listItems.length === 0 && !append) {
html += '<div class="b3-list--empty"><span class="b3-list-item__text">' + (window.siyuan.languages.emptyContent) + "</span></div>";
} else {
const currentId = this.getCurrentSessionId();
const defaultTitle = this.getDefaultTitle();
let isDesktop = false;
/// #if !BROWSER
isDesktop = true;
/// #endif
const L = window.siyuan.languages;
for (let i = 0; i < listItems.length; i++) {
const s = listItems[i];
const isActive = s.id === currentId;
const status = this.callbacks.getStatus?.(s.id) || (s.agentRunning ? "running" : undefined);
const statusLabel = status === "running" ? (L.agentThinking || "Thinking") :
(L.agentNotifyDone || "Agent response completed");
const statusHTML = status ? '<span class="agent-session-status agent-session-status--' + status +
' ariaLabel" aria-label="' + escapeHtml(statusLabel) + '"></span>' : "";
const title = this.callbacks.getTitle?.(s.id) || s.title || defaultTitle;
html += '<div class="b3-list-item' + (this.mobile ? "" : " b3-list-item--hide-action") +
(isActive ? " b3-list-item--focus" : "") + '" data-id="' + s.id + '">' +
statusHTML +
(s.pinnedAt ? '<svg class="b3-list-item__graphic ariaLabel" aria-label="' + escapeHtml(L.pinDoc) + '"><use xlink:href="#iconPin"></use></svg>' : "") +
'<span class="b3-list-item__text ariaLabel" data-position="parentW" aria-label="' + escapeHtml(title) + '">' + escapeHtml(title) + "</span>" +
'<span class="b3-list-item__action b3-tooltips b3-tooltips__nw" data-id="' + s.id + '" aria-label="' + window.siyuan.languages.rename + '"><svg><use xlink:href="#iconEdit"></use></svg></span>' +
'<span class="b3-list-item__action b3-tooltips b3-tooltips__nw agent-session-more" data-id="' + s.id + '" aria-label="' + (L.more || "More") + '">' +
'<svg><use xlink:href="#iconMore"></use></svg>' +
'<div class="b3-menu__submenu">' +
'<div class="b3-menu__items">' +
'<button class="b3-menu__item" data-action="pin"><svg class="b3-menu__icon"><use xlink:href="#' + (s.pinnedAt ? "iconUnpin" : "iconPin") +
'"></use></svg><span class="b3-menu__label">' + escapeHtml(s.pinnedAt ? L.unpinDoc : L.pinDoc) + "</span></button>" +
(isDesktop && getHostCapabilities().localFileSystem ? '<button class="b3-menu__item" data-action="folder"><svg class="b3-menu__icon"><use xlink:href="#iconFolder"></use></svg><span class="b3-menu__label">' + escapeHtml(L.showInFolder) + "</span></button>" : "") +
'<button class="b3-menu__item b3-menu__item--warning" data-action="delete"><svg class="b3-menu__icon"><use xlink:href="#iconTrashcan"></use></svg><span class="b3-menu__label">' + escapeHtml(L.delete) + "</span></button>" +
"</div>" +
"</div>" +
"</span>" +
"</div>";
}
}
if (append) {
container.insertAdjacentHTML("beforeend", html);
} else {
container.innerHTML = html;
}
if (!container.querySelector(".b3-list-item--focus, .b3-list--empty")) {
container.firstElementChild.classList.add("b3-list-item--focus");
}
this.bindEvents(container);
this.highlightCurrent();
}
private bindEvents(container: HTMLElement) {
if (container.dataset.eventsBound) {
return;
}
container.dataset.eventsBound = "1";
container.addEventListener("mousedown", (e: MouseEvent) => {
if (hasClosestByClassName(e.target as HTMLElement, "agent-session-more")) {
// 阻止双击更多按钮时选中相邻会话标题。
e.preventDefault();
}
});
container.addEventListener("click", (e: MouseEvent) => {
const target = e.target as HTMLElement;
const actionBtn = hasClosestByClassName(target, "b3-list-item__action");
if (actionBtn) {
// "更多"按钮:置顶、文件夹(桌面端)和删除操作。
if (actionBtn.classList.contains("agent-session-more")) {
e.stopPropagation();
const id = (actionBtn as HTMLElement).getAttribute("data-id") || "";
if (id) {
this.showMoreMenu(actionBtn as HTMLElement, id);
}
return;
}
e.stopPropagation();
const id = (actionBtn as HTMLElement).getAttribute("data-id") || "";
if (id) {
this.startRename(id, actionBtn.parentElement);
}
return;
}
if (hasClosestByClassName(target, "b3-text-field")) {
return;
}
const item = hasClosestByClassName(target, "b3-list-item");
if (item) {
const id = (item as HTMLElement).getAttribute("data-id") || "";
if (id && id !== this.getCurrentSessionId()) {
this.close();
this.callbacks.onSwitch(id);
}
}
});
}
private async loadMore(container: HTMLElement) {
if (this.isLoadingMore) {
return;
}
this.isLoadingMore = true;
try {
const result = await SessionStore.list({page: this.page + 1, pageSize: 30, keyword: this.searchKeyword});
this.page = result.page;
this.items = this.items.concat(result.sessions);
this.total = result.total;
this.renderItems(container, result.sessions, true);
} finally {
this.isLoadingMore = false;
}
}
private filter(keyword: string, container: HTMLElement) {
this.searchKeyword = keyword.trim();
if (this.searchTimer !== null) {
clearTimeout(this.searchTimer);
}
this.searchTimer = window.setTimeout(async () => {
const result = await SessionStore.list({page: 1, pageSize: 30, keyword: this.searchKeyword});
this.items = result.sessions;
this.total = result.total;
this.page = 1;
this.searchTimer = null;
this.renderItems(container, result.sessions, false);
container.scrollTop = 0;
this.highlightCurrent();
}, 300);
}
private startRename(id: string, rowEl: HTMLElement) {
const titleEl = rowEl.querySelector(".b3-list-item__text") as HTMLElement;
const oldTitle = titleEl.textContent || "";
const input = document.createElement("input");
input.type = "text";
input.value = oldTitle;
input.className = "b3-text-field b3-text-field--small fn__flex-1";
titleEl.replaceWith(input);
input.focus();
input.select();
input.addEventListener("blur", () => {
this.finishRename(id, input.value, input, titleEl);
});
input.addEventListener("keydown", (e: KeyboardEvent) => {
if (e.isComposing) {
return;
}
if (e.key === "Enter") {
input.blur();
}
if (e.key === "Escape") {
input.value = oldTitle;
input.blur();
}
});
}
private async finishRename(id: string, newTitle: string, input: HTMLInputElement, titleEl: HTMLElement) {
const title = newTitle.trim() || this.getDefaultTitle();
input.replaceWith(titleEl);
titleEl.textContent = title;
await this.callbacks.onRename(id, title);
const listItem = this.items.find((s) => s.id === id);
if (listItem) {
listItem.title = title;
}
}
private highlightCurrent() {
const items = this.popup?.querySelectorAll(".b3-list-item");
if (!items) {
return;
}
this.popup.querySelector(".b3-menu__checked")?.remove();
const currentId = this.getCurrentSessionId();
for (let i = 0; i < items.length; i++) {
if (items[i].getAttribute("data-id") === currentId) {
items[i].insertAdjacentHTML("beforeend", '<svg class="b3-menu__checked"><use xlink:href="#iconSelect"></use></svg>');
break;
}
}
}
// 跨实例会话变更(ws agentSessionChanged)时由 AgentChat.onWsMessage 调用,刷新已打开的列表。
// popup 未打开时直接返回(下次 toggle/render 会拉取最新数据),避免无谓请求。
async refresh() {
const itemsContainer = this.popup?.querySelector(".b3-list") as HTMLElement;
if (!itemsContainer) {
return;
}
const result = await SessionStore.list({page: 1, pageSize: 30, keyword: this.searchKeyword});
this.items = result.sessions;
this.total = result.total;
this.page = 1;
this.renderItems(itemsContainer, result.sessions, false);
}
private showMoreMenu(anchor: HTMLElement, id: string) {
// 内嵌子菜单(b3-menu__submenu),点击 toggle 展开/关闭。
if (anchor.classList.contains("b3-menu__item--show")) {
anchor.classList.remove("b3-menu__item--show");
return;
}
this.closeAllSubmenus(anchor);
anchor.classList.add("b3-menu__item--show");
const submenu = anchor.querySelector(".b3-menu__submenu") as HTMLElement | null;
if (submenu) {
// 使用 position: fixed 定位子菜单,避免在可滚动列表内触发滚动条。
// 在按钮左侧展开;左侧空间不够则在右侧展开。
const anchorRect = anchor.getBoundingClientRect();
const submenuRect = submenu.getBoundingClientRect();
let left = anchorRect.left - submenuRect.width - 4;
let top = anchorRect.top;
if (left < 0) {
left = anchorRect.right + 4;
}
// 防止超出屏幕底部
if (top + submenuRect.height > window.innerHeight) {
top = window.innerHeight - submenuRect.height - 4;
}
// 防止超出屏幕顶部
if (top < 0) {
top = 4;
}
submenu.style.top = top + "px";
submenu.style.left = left + "px";
submenu.style.zIndex = (++window.siyuan.zIndex).toString();
// 子菜单项 hover 高亮(限定 b3-menu__items 内的项)。
const itemsContainer = submenu.querySelector(".b3-menu__items");
if (itemsContainer) {
itemsContainer.addEventListener("mouseover", (e: MouseEvent) => {
const item = hasClosestByClassName(e.target as HTMLElement, "b3-menu__item");
if (!item) { return; }
submenu.querySelectorAll(".b3-menu__item--current").forEach((el) => {
el.classList.remove("b3-menu__item--current");
});
item.classList.add("b3-menu__item--current");
});
}
// 关闭子菜单:点击子菜单项执行操作后关闭,或点击外部关闭。
const onClose = () => {
anchor.classList.remove("b3-menu__item--show");
submenu.querySelectorAll(".b3-menu__item--current").forEach((el) => {
el.classList.remove("b3-menu__item--current");
});
document.removeEventListener("mousedown", onOutside);
};
const onOutside = (e: MouseEvent) => {
if (anchor.contains(e.target as Node)) {
return;
}
onClose();
};
document.addEventListener("mousedown", onOutside, {once: true});
// 子菜单项 click 事件委托。
if (!submenu.dataset.eventsBound) {
submenu.dataset.eventsBound = "1";
submenu.addEventListener("click", (e: MouseEvent) => {
const btn = hasClosestByClassName(e.target as HTMLElement, "b3-menu__item");
if (!btn) { return; }
e.stopPropagation();
const action = btn.getAttribute("data-action");
if (action === "pin") {
if ((btn as HTMLButtonElement).disabled) {
return;
}
(btn as HTMLButtonElement).disabled = true;
const pinned = !this.items.find(item => item.id === id)?.pinnedAt;
void SessionStore.setPinned(id, pinned).then(() => this.refresh()).catch(error => {
showMessage(error.message);
}).finally(() => {
(btn as HTMLButtonElement).disabled = false;
});
}
if (action === "delete") {
this.callbacks.onDelete(id).then(() => {
this.refresh();
});
}
if (action === "folder") {
/// #if !BROWSER
useShell("openPath", path.join(window.siyuan.config.system.dataDir, "storage", "ai", "agent", "sessions", id));
/// #endif
}
onClose();
});
}
}
}
private closeAllSubmenus(except?: HTMLElement) {
this.popup?.querySelectorAll(".agent-session-more.b3-menu__item--show").forEach((el) => {
if (el !== except) {
el.classList.remove("b3-menu__item--show");
}
});
}
}