@research-copilot/plugin 1.1.17 → 1.1.19

package/dist/skills/llm-wiki/workbench/web/test/graph-reader.test.ts

@@ -0,0 +1,62 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import type { GraphOpenPagePayload } from "@llm-wiki/graph-engine";
+import {
+	graphReaderActionLabels,
+	graphReaderActions,
+	graphReaderMetaItems,
+} from "../src/lib/graph-reader";
+
+describe("graph reader", () => {
+	it("uses graph metadata for reader meta and actions without legacy reading sections", () => {
+		const payload: GraphOpenPagePayload = {
+			path: "wiki/sources/source-a.md",
+			node: {
+				id: "source-a",
+				title: "Source A",
+				type: "source",
+				typeLabel: "来源",
+				sourcePath: "wiki/sources/source-a.md",
+				community: "sources",
+				date: "2026-06-13",
+				source: "Archive",
+				isolated: true,
+			},
+		};
+
+		assert.deepEqual(graphReaderMetaItems(payload), [
+			"来源",
+			"2026-06-13",
+			"Archive",
+			"wiki/sources/source-a.md",
+		]);
+		assert.deepEqual(graphReaderActions(), [
+			{ id: "quote_page", label: "在对话中引用" },
+			{ id: "find_related_pages", label: "它和谁有关" },
+		]);
+		assert.deepEqual(graphReaderActionLabels(payload), ["在对话中引用", "它和谁有关"]);
+		assert.equal(graphReaderActionLabels(payload).includes("学习队列"), false);
+		assert.equal(graphReaderActionLabels(payload).includes("摘要"), false);
+		assert.equal(graphReaderActionLabels(payload).includes("相邻节点"), false);
+	});
+
+	it("only exposes source path as a source link for source pages", () => {
+		const topicPayload: GraphOpenPagePayload = {
+			path: "wiki/topics/topic-a.md",
+			node: {
+				id: "topic-a",
+				title: "Topic A",
+				type: "topic",
+				typeLabel: "主题",
+				sourcePath: "wiki/topics/topic-a.md",
+				community: "topics",
+				date: null,
+				source: null,
+				isolated: false,
+			},
+		};
+
+		assert.deepEqual(graphReaderMetaItems(topicPayload), ["主题"]);
+	});
+});

package/dist/skills/llm-wiki/workbench/web/test/graph-selection-drawer.test.ts

@@ -0,0 +1,56 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import type { Selection } from "@llm-wiki/graph-engine";
+import { graphSelectionViewModel } from "../src/lib/graph-selection-drawer";
+
+describe("graph selection drawer", () => {
+	it("hides structural facts for a single node and keeps unrelated group actions out", () => {
+		const view = graphSelectionViewModel(selectionFixture({
+			nodeIds: ["a"],
+			facts: { pageCount: 1, internalLinkCount: 0, communityCount: 1, isolatedCount: 0 },
+			actions: [
+				{ id: "summarize_page", label: "总结这一页", tone: "digest" },
+				{ id: "find_related_pages", label: "它和谁有关", tone: "bridge" },
+			],
+		}));
+
+		assert.equal(view.hint, "Shift+点击 增删节点");
+		assert.equal(view.showFacts, false);
+		assert.equal(view.canExpandNeighbors, true);
+		assert.deepEqual(view.facts, []);
+		assert.deepEqual(view.actionLabels, ["总结这一页", "它和谁有关"]);
+		assert.equal(view.actionLabels.includes("探索潜在联系"), false);
+	});
+
+	it("shows structural facts and the shift hint for multi-node selections", () => {
+		const view = graphSelectionViewModel(selectionFixture({
+			nodeIds: ["a", "b"],
+			facts: { pageCount: 2, internalLinkCount: 1, communityCount: 1, isolatedCount: 0 },
+			actions: [
+				{ id: "summarize_group", label: "总结这一组", tone: "digest" },
+				{ id: "explore_group_relationships", label: "探索它们的关系", tone: "bridge" },
+			],
+		}));
+
+		assert.equal(view.hint, "Shift+点击 增删节点");
+		assert.equal(view.showFacts, true);
+		assert.equal(view.canExpandNeighbors, false);
+		assert.deepEqual(view.facts, [
+			{ label: "页", value: 2 },
+			{ label: "链接", value: 1 },
+			{ label: "社区", value: 1 },
+		]);
+		assert.deepEqual(view.actionLabels, ["总结这一组", "探索它们的关系"]);
+	});
+});
+
+function selectionFixture(input: Pick<Selection, "nodeIds" | "facts" | "actions">): Selection {
+	return {
+		id: "selection-test",
+		nodeIds: input.nodeIds,
+		communityIds: [],
+		facts: input.facts,
+		actions: input.actions,
+	};
+}

package/dist/skills/llm-wiki/workbench/web/test/graph-selection.test.ts

@@ -0,0 +1,83 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import { resolveSelection, type GraphData } from "@llm-wiki/graph-engine";
+import { buildSelectionPromptPayload } from "../src/lib/graph-selection";
+
+describe("graph selection prompt payload", () => {
+	it("expands a community selection into page list, links, and communities", () => {
+		const data = fixtureGraph();
+		const selection = resolveSelection(data, { kind: "community", id: "alpha" });
+		const action = selection.actions?.find((item) => item.id === "summarize_cluster") ?? null;
+		const payload = buildSelectionPromptPayload(data, selection, action);
+
+		assert.match(payload.displayText, /@\[选区:Alpha Group · 2页\] 总结这一簇/);
+		assert.match(payload.expandedText, /动作：总结这一簇/);
+		assert.match(payload.expandedText, /页面清单：/);
+		assert.match(payload.expandedText, /1\. \[\[wiki\/topics\/alpha-a\.md\]\] - Alpha A - 社区 alpha/);
+		assert.match(payload.expandedText, /2\. \[\[wiki\/entities\/alpha-b\.md\]\] - Alpha B - 社区 alpha/);
+		assert.match(payload.expandedText, /链接关系：/);
+		assert.match(payload.expandedText, /- a -> b \(EXTRACTED\)/);
+		assert.match(payload.expandedText, /请基于上面的选区信息回答/);
+	});
+
+	it("uses stored synthesis session paths when sending graph nodes into chat", () => {
+		const data = fixtureGraph();
+		data.nodes = [
+			{
+				id: "session-a",
+				label: "Session A",
+				type: "synthesis",
+				community: "alpha",
+				source_path: "wiki/synthesis/sessions/session-a.md",
+			},
+		];
+		data.edges = [];
+		const learning = data.learning;
+		assert.ok(learning);
+		data.learning = {
+			...learning,
+			views: {
+				...learning.views,
+				global: { enabled: true, node_ids: ["session-a"], degraded: false },
+			},
+			communities: [{ id: "alpha", label: "Alpha Group", node_count: 1, color_index: 0 }],
+		};
+
+		const selection = resolveSelection(data, { kind: "node", id: "session-a" });
+		const payload = buildSelectionPromptPayload(data, selection, null);
+
+		assert.match(payload.expandedText, /1\. \[\[wiki\/synthesis\/sessions\/session-a\.md\]\] - Session A - 社区 alpha/);
+		assert.doesNotMatch(payload.expandedText, /wiki\/synthesis\/session-a\.md/);
+	});
+});
+
+function fixtureGraph(): GraphData {
+	return {
+		meta: {
+			build_date: "2026-06-12T00:00:00.000Z",
+			wiki_title: "Selection Fixture",
+			total_nodes: 2,
+			total_edges: 1
+		},
+		nodes: [
+			{ id: "a", label: "Alpha A", type: "topic", community: "alpha", source_path: "wiki/topics/alpha-a.md" },
+			{ id: "b", label: "Alpha B", type: "entity", community: "alpha", source_path: "wiki/entities/alpha-b.md" }
+		],
+		edges: [
+			{ id: "a-b", from: "a", to: "b", type: "EXTRACTED", weight: 1 }
+		],
+		learning: {
+			version: 1,
+			entry: { recommended_start_node_id: "a", recommended_start_reason: "community_hub", default_mode: "global" },
+			views: {
+				path: { enabled: false, start_node_id: null, node_ids: [], degraded: true },
+				community: { enabled: false, community_id: null, label: null, node_ids: [], is_weak: false, degraded: true },
+				global: { enabled: true, node_ids: ["a", "b"], degraded: false }
+			},
+			communities: [
+				{ id: "alpha", label: "Alpha Group", node_count: 2, color_index: 0 }
+			]
+		}
+	};
+}

package/dist/skills/llm-wiki/workbench/web/test/tool-history-summary.test.tsx

@@ -0,0 +1,124 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+
+import {
+	TOOL_HISTORY_DETAIL_LIMIT,
+	TOOL_HISTORY_FOLDED_TARGET_LIMIT,
+	ToolHistorySummary,
+} from "../src/components/ToolHistorySummary";
+import {
+	createToolStatusState,
+	reduceToolStatusEvent,
+	type ToolStatusState,
+} from "../src/lib/tool-status-model";
+import type { ToolStatusContractEvent, ToolStatusEndEvent } from "../src/lib/api";
+
+describe("ToolHistorySummary", () => {
+	it("renders a compact folded summary grouped by tool kind", () => {
+		const state = completedState([
+			["read-1", "read", "读取", "wiki/a.md"],
+			["write-1", "write", "写入", "wiki/b.md"],
+			["bash-1", "bash", "运行命令", "npm test"],
+			["search-1", "knowledge_search", "搜索", "tool status"],
+			["skill-1", "skill_runner", "调用 Skill", "llm-wiki"],
+		]);
+
+		const html = renderToStaticMarkup(React.createElement(ToolHistorySummary, { state }));
+
+		assert.match(html, /tool-history-summary/);
+		assert.match(html, /工具摘要/);
+		assert.match(html, /文件 2/);
+		assert.match(html, /命令 1/);
+		assert.match(html, /搜索 1/);
+		assert.match(html, /Skill 1/);
+		assert.equal(html.includes("tool-history-row"), false);
+		assert.ok((html.match(/tool-history-chip/g) ?? []).length <= TOOL_HISTORY_FOLDED_TARGET_LIMIT + 4);
+	});
+
+	it("renders expanded detail with a hard row limit and remaining count", () => {
+		const items = Array.from({ length: 55 }, (_, index) => [
+			`read-${index}`,
+			"read",
+			"读取",
+			`wiki/source-${index}.md`,
+		] as const);
+		const state = completedState(items);
+
+		const html = renderToStaticMarkup(React.createElement(ToolHistorySummary, { state, defaultExpanded: true }));
+
+		assert.equal((html.match(/class="tool-history-row tool-history-row-/g) ?? []).length, TOOL_HISTORY_DETAIL_LIMIT);
+		assert.match(html, /还有 5 项/);
+		assert.match(html, /wiki\/source-0\.md/);
+		assert.match(html, /wiki\/source-49\.md/);
+		assert.equal(html.includes("wiki/source-54.md"), false);
+	});
+
+	it("does not render when there are no completed tool items", () => {
+		const html = renderToStaticMarkup(
+			React.createElement(ToolHistorySummary, { state: createToolStatusState("history-run", "history-message") }),
+		);
+
+		assert.equal(html, "");
+	});
+});
+
+function completedState(items: ReadonlyArray<readonly [string, string, string, string]>): ToolStatusState {
+	return items.reduce((state, [toolCallId, toolName, action, target], index) => {
+		let next = reduceToolStatusEvent(
+			state,
+			event("tool_status_start", {
+				seq: index * 2 + 1,
+				toolCallId,
+				toolName,
+				action,
+				target,
+				status: "running",
+				args: argsFor(toolName, target),
+				runningToolCount: 1,
+				otherRunningCount: 0,
+			}),
+			{ nowMs: 1_000 + index },
+		);
+		next = reduceToolStatusEvent(
+			next,
+			event("tool_status_end", {
+				seq: index * 2 + 2,
+				toolCallId,
+				toolName,
+				action,
+				target,
+				status: "done",
+				result: null,
+				summary: `完成 ${target}`,
+				error: null,
+				durationMs: 20,
+				runningToolCount: 0,
+				otherRunningCount: 0,
+			}),
+			{ nowMs: 1_020 + index },
+		);
+		return next;
+	}, createToolStatusState("history-run", "history-message", { maxCompletedItems: 200, maxSummaryItems: 200 }));
+}
+
+function argsFor(toolName: string, target: string): Record<string, unknown> {
+	if (toolName.includes("bash")) return { command: target };
+	if (toolName.includes("search")) return { query: target };
+	if (toolName.includes("skill")) return { skillName: target };
+	return { path: target };
+}
+
+function event<T extends ToolStatusContractEvent["type"]>(
+	type: T,
+	payload: Omit<Extract<ToolStatusContractEvent, { type: T }>, "schemaVersion" | "type" | "runId" | "messageId">,
+): Extract<ToolStatusContractEvent, { type: T }> {
+	return {
+		schemaVersion: 1,
+		type,
+		runId: "history-run",
+		messageId: "history-message",
+		...payload,
+	} as Extract<ToolStatusContractEvent, { type: T }>;
+}

package/dist/skills/llm-wiki/workbench/web/test/tool-status-format.test.ts

@@ -0,0 +1,107 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import { formatToolStatusItem, truncateToolStatusText } from "../src/lib/tool-status-format";
+
+describe("tool status format", () => {
+	it("formats read and write file tools with compact private paths", () => {
+		const read = formatToolStatusItem({
+			toolName: "read",
+			action: "读取",
+			target: "/Users/alice/projects/secret/wiki/sources/very-long-private-file-name.md",
+			args: { path: "/Users/alice/projects/secret/wiki/sources/very-long-private-file-name.md" },
+			homeDir: "/Users/alice",
+		});
+		const write = formatToolStatusItem({
+			toolName: "write_file",
+			action: "写入",
+			target: "/Users/alice/projects/secret/wiki/synthesis/report.md",
+			args: { filePath: "/Users/alice/projects/secret/wiki/synthesis/report.md" },
+			homeDir: "/Users/alice",
+		});
+
+		assert.deepEqual(
+			[read.action, read.group, write.action, write.group],
+			["读取", "file", "写入", "file"],
+		);
+		assert.equal(read.target.includes("/Users/alice"), false);
+		assert.equal(write.target.includes("/Users/alice"), false);
+		assert.match(read.target, /very-long-private-file-name\.md$/);
+		assert.match(write.target, /report\.md$/);
+		assert.ok(read.target.length <= 72);
+	});
+
+	it("formats bash commands as short command snippets", () => {
+		const formatted = formatToolStatusItem({
+			toolName: "bash",
+			action: "运行命令",
+			target:
+				"npm run test --workspace=@llm-wiki-agent/web -- --verbose --filter a-very-long-test-name-that-keeps-going",
+			args: {
+				command:
+					"npm run test --workspace=@llm-wiki-agent/web -- --verbose --filter a-very-long-test-name-that-keeps-going",
+			},
+		});
+
+		assert.equal(formatted.action, "运行命令");
+		assert.equal(formatted.group, "command");
+		assert.match(formatted.target, /^npm run test/);
+		assert.match(formatted.target, /\.\.\./);
+		assert.ok(formatted.target.length <= 72);
+	});
+
+	it("formats search and skill tools with stable groups", () => {
+		const search = formatToolStatusItem({
+			toolName: "knowledge_search",
+			action: "搜索",
+			target: "tool status events",
+			args: { query: "tool status events" },
+		});
+		const skill = formatToolStatusItem({
+			toolName: "skill_runner",
+			action: "调用 Skill",
+			target: "llm-wiki",
+			args: { skillName: "llm-wiki" },
+		});
+
+		assert.deepEqual(
+			[search.action, search.target, search.group, skill.action, skill.target, skill.group],
+			["搜索", "tool status events", "search", "调用 Skill", "llm-wiki", "skill"],
+		);
+	});
+
+	it("handles empty args and unknown tools without blank labels", () => {
+		const emptyRead = formatToolStatusItem({
+			toolName: "read",
+			action: "",
+			target: "",
+			args: {},
+		});
+		const unknown = formatToolStatusItem({
+			toolName: "custom_vectorize",
+			action: "",
+			target: "",
+			args: {},
+		});
+
+		assert.deepEqual(
+			[emptyRead.action, emptyRead.target, emptyRead.group],
+			["读取", "未知路径", "file"],
+		);
+		assert.deepEqual(
+			[unknown.action, unknown.target, unknown.group],
+			["运行 custom_vectorize", "未知目标", "other"],
+		);
+	});
+
+	it("truncates text in the middle and preserves useful endings", () => {
+		const truncated = truncateToolStatusText(
+			"wiki/sources/2026/06/15/omp-tool-status-events-full-implementation-notes.md",
+			36,
+		);
+
+		assert.equal(truncated.length <= 36, true);
+		assert.match(truncated, /\.\.\./);
+		assert.match(truncated, /notes\.md$/);
+	});
+});