@y9931666/dsh-plugin-roundtable 1.0.0-rc.2

package/lib/state-BzBQig2q.js

@@ -0,0 +1,479 @@
+import { randomUUID } from "node:crypto";
+import { appendFile, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+
+//#region src/state.ts
+/** Stable directory id from a display name (keeps CJK, lowercases latin). */
+function sanitizeKey(value) {
+	const cleaned = value.trim().toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff]+/g, "-").replace(/^-+|-+$/g, "");
+	return cleaned === "" ? "meeting" : cleaned;
+}
+/** Process-local mutex chain keyed by an arbitrary lock key. */
+const locks = /* @__PURE__ */ new Map();
+/** Serialize async operations sharing one key inside this process. */
+async function withMeetingLock(key, operation) {
+	const current = (locks.get(key) ?? Promise.resolve()).then(operation, operation);
+	locks.set(key, current.then(() => void 0, () => void 0));
+	return current;
+}
+/** Absolute state root under a workspace. */
+function stateRootOf(workspace, stateDir) {
+	return join(workspace, stateDir);
+}
+/** Absolute directory of one meeting. */
+function meetingDirOf(stateRoot, meetingId) {
+	return join(stateRoot, meetingId);
+}
+/**
+* Drop every persisted record belonging to one meeting directory.
+*
+* `roundtable_create` reuses the id of a finished meeting (the id IS the
+* sanitized name), and while `meeting.json` gets rewritten, `transcript.jsonl`
+* is append-only and `review.json` / `user-actions.jsonl` / `export.md` /
+* `kb-digest.json` simply stay behind. Without this reset a brand-new meeting
+* inherits the previous one's utterances and review verbatim: the user is shown
+* a review window for a plan that belongs to an entirely different meeting and
+* is asked to endorse or reject flaws of a plan that is not the one on the
+* table (P3).
+*
+* Idempotent — a missing directory is not an error.
+*/
+async function resetMeetingDirectory(stateRoot, meetingId) {
+	await rm(meetingDirOf(stateRoot, meetingId), {
+		recursive: true,
+		force: true
+	});
+}
+/** Cached host atomic writer: `null` = not resolved yet, `undefined` = unavailable. */
+let hostAtomicWriter = null;
+/**
+* Resolve the host's atomic writer **without making it a load gate**.
+*
+* A static import would mean a composition that lacks
+* `@deepseek-ai/dsh-atomic-write` fails to load this whole module — the same
+* "optional capability became a hard gate" failure v0.2.36 fixed for cordis
+* `inject`. So it is resolved once, lazily, and absence falls back to the local
+* implementation below.
+*/
+async function resolveHostWriter() {
+	if (hostAtomicWriter !== null) return hostAtomicWriter;
+	try {
+		const write = (await import("@deepseek-ai/dsh-atomic-write")).writeFileAtomic;
+		hostAtomicWriter = typeof write === "function" ? (file, text) => write(file, text, { mode: 420 }) : void 0;
+	} catch {
+		hostAtomicWriter = void 0;
+	}
+	return hostAtomicWriter;
+}
+/**
+* Atomically publish a UTF-8 text file.
+*
+* Prefers the host's `@deepseek-ai/dsh-atomic-write`: same-directory
+* random-suffix temp + rename, plus the bounded retry for transient Windows
+* `EACCES`/`EBUSY`/`EPERM` rename failures that our hand-rolled version lacked —
+* it moved the temp aside as `.stale-*` and threw, so **that write was simply
+* lost**. The host version removes its temp and rethrows instead.
+*
+* When the host does not provide that package, the local fallback keeps every
+* state write working (same tmp + rename, minus the Windows retry) rather than
+* failing the whole plugin.
+*/
+async function writeTextAtomic(file, text) {
+	const hostWrite = await resolveHostWriter();
+	if (hostWrite !== void 0) {
+		await hostWrite(file, text);
+		return;
+	}
+	const tmp = join(dirname(file), `.${randomUUID()}.tmp`);
+	await writeFile(tmp, text, "utf8");
+	await rename(tmp, file);
+}
+/** Atomically publish a JSON file (same-directory tmp + rename). */
+async function writeJsonAtomic(file, value) {
+	await writeTextAtomic(file, JSON.stringify(value, null, 2));
+}
+/** Lock key serializing append (UI) against clear (captain) for one meeting's
+*  `user-actions.jsonl`. Without it a clear could rename over a line the UI
+*  was midway through appending, orphaning a user action (A2). */
+function userActionsLockKey(stateRoot, meetingId) {
+	return `user-actions:${stateRoot}:${meetingId}`;
+}
+/** Read one meeting record; undefined when absent.
+*
+*  与 {@link readReview} 对齐：读出来的记录一律先过 {@link normalizeMeeting}
+*  升级到当前 schema 版本。v0.2.36 之前这里是全插件唯一的「裸
+*  `JSON.parse(...) as Meeting`」——形状一变老会议就静默读坏，而且没有任何
+*  版本号可供分支。 */
+async function readMeeting(stateRoot, meetingId) {
+	try {
+		const raw = await readFile(join(stateRoot, meetingId, "meeting.json"), "utf8");
+		return normalizeMeeting(JSON.parse(raw));
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+/** Persist one meeting record (atomic). 写入前同样过一遍 normalize：这样
+*  「读时升级 + 下次写入顺带落盘」形成一个闭环，老文件不会永远停在旧版本。 */
+async function writeMeeting(stateRoot, meeting) {
+	const dir = meetingDirOf(stateRoot, meeting.id);
+	await mkdir(dir, { recursive: true });
+	const normalized = normalizeMeeting(meeting);
+	normalized.updatedAt = Date.now();
+	await writeJsonAtomic(join(dir, "meeting.json"), normalized);
+}
+/** 当前 `meeting.json` 的形状版本。加字段/改语义时递增，并在
+*  {@link MEETING_MIGRATIONS} 补一条从「前一版」升上来的函数。 */
+const CURRENT_MEETING_SCHEMA_VERSION = 1;
+/**
+* 相邻版本迁移表：键 = 源版本，值 = 把该版本升到「源版本 + 1」的函数。
+*
+* 当前 1 就是最新版，所以表为空——**这不是占位符**：把机制先建起来，是为了
+* 让下一次改形状时只需要「加一条函数 + 递增常量」，而不是像 review.json 那样
+* 等到不得不迁移时才回头补一套。
+*/
+const MEETING_MIGRATIONS = {};
+/** 每个会话只播报一次迁移告警，避免 1 秒轮询的快照把日志刷爆。 */
+const notifiedMeetingMigrations = /* @__PURE__ */ new Set();
+/** 把「字段缺失/类型不符」的最小集合补成合法缺省值（幂等）。
+*
+*  只处理**不改语义**的兼容补齐，绝不猜测用户的意图，也绝不让缺失字段变成
+*  `undefined` 混进后续计算（那正是「静默读坏」的样子）。 */
+function withMeetingDefaults(meeting) {
+	if (!Array.isArray(meeting.nodes)) meeting.nodes = [];
+	if (!Array.isArray(meeting.edges)) meeting.edges = [];
+	if (!Array.isArray(meeting.decisions)) meeting.decisions = [];
+	if (typeof meeting.round !== "number" || !Number.isFinite(meeting.round)) meeting.round = 0;
+	if (typeof meeting.charter !== "string") meeting.charter = "";
+	const budget = meeting.budget;
+	meeting.budget = {
+		maxRounds: typeof budget?.maxRounds === "number" ? budget.maxRounds : 10,
+		maxTokens: typeof budget?.maxTokens === "number" ? budget.maxTokens : 2e5,
+		usedRounds: typeof budget?.usedRounds === "number" ? budget.usedRounds : 0,
+		usedTokens: typeof budget?.usedTokens === "number" ? budget.usedTokens : 0,
+		...typeof budget?.usedTokensReal === "number" ? { usedTokensReal: budget.usedTokensReal } : {}
+	};
+	return meeting;
+}
+/**
+* Idempotently upgrade one meeting record to
+* {@link CURRENT_MEETING_SCHEMA_VERSION}（**内存内**，不写回；下次
+* {@link writeMeeting} 落盘时顺带升级）。
+*
+* 缺失 `schemaVersion` 视为 1（v0.2.36 及之前的文件都是这个形状），然后
+* 依次跑迁移表。三条防御：
+*   - 迁移函数抛错 → 保留原记录并告警，**绝不让读会议失败**（读不出来比读得
+*     不完美严重得多，那会让整场会议从界面上消失）；
+*   - 版本高于当前（用户从新版本回退到老版本）→ 原样返回并告警，不做降级
+*     猜测；
+*   - 版本非法（非整数 / < 1）→ 归一到 1 再走迁移。
+*/
+function normalizeMeeting(meeting) {
+	const declared = meeting.schemaVersion;
+	const from = typeof declared === "number" && Number.isInteger(declared) && declared >= 1 ? declared : 1;
+	if (declared !== from) meeting.schemaVersion = from;
+	if (from > CURRENT_MEETING_SCHEMA_VERSION) {
+		const key = `future:${meeting.id}:${from}`;
+		if (!notifiedMeetingMigrations.has(key)) {
+			notifiedMeetingMigrations.add(key);
+			console.warn(`[roundtable] meeting "${meeting.id}" was written by a newer plugin (schemaVersion ${from} > ${CURRENT_MEETING_SCHEMA_VERSION}); reading it as-is`);
+		}
+		return withMeetingDefaults(meeting);
+	}
+	let current = meeting;
+	let migrated = false;
+	for (let version = from; version < CURRENT_MEETING_SCHEMA_VERSION; version += 1) {
+		const step = MEETING_MIGRATIONS[version];
+		if (step === void 0) continue;
+		try {
+			current = step(current);
+			migrated = true;
+		} catch (error) {
+			const key = `failed:${meeting.id}:${version}`;
+			if (!notifiedMeetingMigrations.has(key)) {
+				notifiedMeetingMigrations.add(key);
+				console.warn(`[roundtable] meeting "${meeting.id}" schema migration ${version}→${version + 1} failed:`, error instanceof Error ? error.message : String(error));
+			}
+			break;
+		}
+	}
+	current = withMeetingDefaults(current);
+	if (migrated || from < CURRENT_MEETING_SCHEMA_VERSION || declared !== from) current.schemaVersion = CURRENT_MEETING_SCHEMA_VERSION;
+	return current;
+}
+/** Lock key serializing transcript appends for one meeting (A3).
+*
+*  `O_APPEND` already makes a single short line atomic, but this closes the
+*  remaining interleaving window (long lines, lifecycle-event races) so two
+*  utterances can never end up written into each other. */
+function transcriptLockKey(stateRoot, meetingId) {
+	return `transcript:${stateRoot}:${meetingId}`;
+}
+/** Append one utterance to the meeting transcript (JSONL). */
+async function appendUtterance(stateRoot, meetingId, utterance) {
+	await withMeetingLock(transcriptLockKey(stateRoot, meetingId), async () => {
+		const dir = meetingDirOf(stateRoot, meetingId);
+		await mkdir(dir, { recursive: true });
+		await appendFile(join(dir, "transcript.jsonl"), JSON.stringify(utterance) + "\n", "utf8");
+	});
+}
+/** Read the full transcript, skipping torn tails and malformed lines. */
+async function readTranscript(stateRoot, meetingId) {
+	try {
+		const raw = await readFile(join(stateRoot, meetingId, "transcript.jsonl"), "utf8");
+		const out = [];
+		for (const line of raw.split(/\r?\n/)) {
+			if (line.trim() === "") continue;
+			try {
+				out.push(JSON.parse(line));
+			} catch {}
+		}
+		return out;
+	} catch (error) {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	}
+}
+/** List every meeting id under a state root (missing root = empty). */
+async function listMeetings(stateRoot) {
+	try {
+		return (await readdir(stateRoot, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+	} catch (error) {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	}
+}
+/** Append one user action to the meeting's `user-actions.jsonl` (JSONL).
+*  Serialized against {@link clearUserActions} so an append can never race a
+*  clear (A2). A single short line stays atomic under `O_APPEND`. */
+async function appendUserAction(stateRoot, meetingId, action) {
+	await withMeetingLock(userActionsLockKey(stateRoot, meetingId), async () => {
+		const dir = meetingDirOf(stateRoot, meetingId);
+		await mkdir(dir, { recursive: true });
+		await appendFile(join(dir, "user-actions.jsonl"), JSON.stringify(action) + "\n", "utf8");
+	});
+}
+/** Read every pending user action, counting rather than hiding bad lines. */
+async function readUserActionsReport(stateRoot, meetingId) {
+	try {
+		const raw = await readFile(join(stateRoot, meetingId, "user-actions.jsonl"), "utf8");
+		const actions = [];
+		let malformed = 0;
+		for (const line of raw.split(/\r?\n/)) {
+			if (line.trim() === "") continue;
+			try {
+				actions.push(JSON.parse(line));
+			} catch {
+				malformed += 1;
+			}
+		}
+		return {
+			actions,
+			malformed
+		};
+	} catch (error) {
+		if (error.code === "ENOENT") return {
+			actions: [],
+			malformed: 0
+		};
+		throw error;
+	}
+}
+/** Read every pending user action, skipping torn tails and malformed lines. */
+async function readUserActions(stateRoot, meetingId) {
+	return (await readUserActionsReport(stateRoot, meetingId)).actions;
+}
+/**
+* Clear every pending user action, atomically and under the append lock.
+*
+* Returns both how many actions were cleared and how many unparseable lines
+* were dropped, so the captain can tell the user the truth about a loss
+* instead of reporting a clean sweep that never happened (A2).
+*/
+async function clearUserActions(stateRoot, meetingId) {
+	return withMeetingLock(userActionsLockKey(stateRoot, meetingId), async () => {
+		const dir = meetingDirOf(stateRoot, meetingId);
+		await mkdir(dir, { recursive: true });
+		const { actions, malformed } = await readUserActionsReport(stateRoot, meetingId);
+		await writeTextAtomic(join(dir, "user-actions.jsonl"), "");
+		return {
+			cleared: actions.length,
+			malformed
+		};
+	});
+}
+/** Read the 针锋相对 review record; undefined when absent. Migrates old
+*  schemaVersion-1 records (endorsed boolean, whole-utterance viewpoints) to
+*  the current shape in memory — idempotent, no write-back (next writeReview
+*  persists the upgraded shape). */
+async function readReview(stateRoot, meetingId) {
+	try {
+		const raw = await readFile(join(meetingDirOf(stateRoot, meetingId), "review.json"), "utf8");
+		return normalizeReview(JSON.parse(raw));
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+/** Idempotently upgrade a review record to schemaVersion 2 (in-memory only).
+*  v1: viewpoint = {id(utterance id), nodeKey, content, endorsed, ts} →
+*  v2: {id: `${utteranceId}#${seq}`, utteranceId, nodeKey, content,
+*       status, quote?, dimension, ts, seq}. v2 records created before the
+*  C3 复审轮次 fields existed are given reviewPass=1 / maxReviewPass=3. */
+function normalizeReview(review) {
+	if (((review.schemaVersion ?? 1) === 2 ? review : void 0) !== void 0) {
+		if (typeof review.reviewPass !== "number" || review.reviewPass < 1) review.reviewPass = 1;
+		if (typeof review.maxReviewPass !== "number" || review.maxReviewPass < 1) review.maxReviewPass = 3;
+		if (!Array.isArray(review.history)) review.history = [];
+		return review;
+	}
+	return {
+		meetingId: review.meetingId,
+		question: review.question,
+		plan: review.plan,
+		status: review.status,
+		reviewPass: 1,
+		maxReviewPass: 3,
+		history: [],
+		schemaVersion: 2,
+		viewpoints: review.viewpoints.map((viewpoint) => {
+			const legacy = viewpoint;
+			const utteranceId = typeof legacy.id === "string" ? legacy.id : "";
+			const content = typeof legacy.content === "string" ? legacy.content : "";
+			return {
+				id: `${utteranceId}#0`,
+				utteranceId,
+				nodeKey: typeof legacy.nodeKey === "string" ? legacy.nodeKey : "",
+				content,
+				status: legacy.endorsed === true ? "endorsed" : "pending",
+				dimension: "其他",
+				ts: typeof legacy.ts === "number" ? legacy.ts : Date.now(),
+				seq: 0
+			};
+		}),
+		startedAt: review.startedAt,
+		updatedAt: review.updatedAt
+	};
+}
+/** Persist the review record (atomic). */
+async function writeReview(stateRoot, meetingId, review) {
+	const dir = meetingDirOf(stateRoot, meetingId);
+	await mkdir(dir, { recursive: true });
+	review.updatedAt = Date.now();
+	await writeJsonAtomic(join(dir, "review.json"), review);
+}
+/** Set one viewpoint's three-state status (pending/endorsed/rejected);
+*  when rejecting, the caller must supply a non-empty reason (C2).
+*  Returns true when the value changed. */
+async function setViewpointStatus(stateRoot, meetingId, viewpointId, status, rejectReason) {
+	const review = await readReview(stateRoot, meetingId);
+	if (review === void 0) return false;
+	const viewpoint = review.viewpoints.find((candidate) => candidate.id === viewpointId);
+	if (viewpoint === void 0 || viewpoint.status === status) return false;
+	if (status === "rejected") {
+		const reason = rejectReason?.trim() ?? "";
+		if (reason === "") throw new Error("rejecting a viewpoint requires a non-empty reject_reason (驳回必填理由)");
+		viewpoint.rejectReason = reason.slice(0, 500);
+	}
+	viewpoint.status = status;
+	await writeReview(stateRoot, meetingId, review);
+	return true;
+}
+/** Structural guard: only well-formed entries survive a hand-edited cache file. */
+function isKbDigestEntry(value) {
+	if (value === null || typeof value !== "object") return false;
+	const entry = value;
+	return typeof entry.path === "string" && entry.path !== "" && typeof entry.size === "number" && typeof entry.mtimeMs === "number" && typeof entry.digest === "string" && typeof entry.ts === "number";
+}
+/** Read the knowledge-base digest cache.
+*
+*  A missing OR corrupt file reads as empty: a bad cache must never block a
+*  meeting — the worst case is that the captain re-reads a file, which is
+*  exactly the behaviour that existed before the cache. */
+async function readKbDigest(stateRoot, meetingId) {
+	const empty = {
+		meetingId,
+		entries: [],
+		updatedAt: 0
+	};
+	let raw;
+	try {
+		raw = await readFile(join(meetingDirOf(stateRoot, meetingId), "kb-digest.json"), "utf8");
+	} catch (error) {
+		if (error.code === "ENOENT") return empty;
+		throw error;
+	}
+	try {
+		const parsed = JSON.parse(raw);
+		return {
+			meetingId,
+			entries: Array.isArray(parsed.entries) ? parsed.entries.filter(isKbDigestEntry) : [],
+			updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0
+		};
+	} catch {
+		return empty;
+	}
+}
+/** Persist the knowledge-base digest cache (atomic). */
+async function writeKbDigest(stateRoot, meetingId, entries) {
+	const dir = meetingDirOf(stateRoot, meetingId);
+	await mkdir(dir, { recursive: true });
+	const file = {
+		meetingId,
+		entries: [...entries],
+		updatedAt: Date.now()
+	};
+	await writeJsonAtomic(join(dir, "kb-digest.json"), file);
+}
+/** Lock key serializing every `feedback.jsonl` writer of one workspace (P11).
+*
+*  The file is workspace-scoped, so a meeting-scoped lock is not enough: one
+*  meeting's "clear then append" used to rewrite the whole file while another
+*  meeting was appending, silently dropping that entry. */
+function feedbackLockKey(stateRoot) {
+	return `feedback:${stateRoot}`;
+}
+/** Append one feedback entry to `<stateRoot>/feedback.jsonl`. */
+async function appendFeedback(stateRoot, entry) {
+	return withMeetingLock(feedbackLockKey(stateRoot), async () => {
+		await mkdir(stateRoot, { recursive: true });
+		await appendFile(join(stateRoot, "feedback.jsonl"), JSON.stringify(entry) + "\n", "utf8");
+	});
+}
+/** Read every feedback entry (newest last), skipping torn tails. */
+async function readFeedback(stateRoot) {
+	try {
+		const raw = await readFile(join(stateRoot, "feedback.jsonl"), "utf8");
+		const out = [];
+		for (const line of raw.split(/\r?\n/)) {
+			if (line.trim() === "") continue;
+			try {
+				out.push(JSON.parse(line));
+			} catch {}
+		}
+		return out;
+	} catch (error) {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	}
+}
+/** Remove every feedback entry for one meeting id (dedupe); returns count removed. */
+async function clearFeedbackForMeeting(stateRoot, meetingId) {
+	return withMeetingLock(feedbackLockKey(stateRoot), async () => {
+		const before = await readFeedback(stateRoot);
+		const remaining = before.filter((entry) => entry.meetingId !== meetingId);
+		await writeTextAtomic(join(stateRoot, "feedback.jsonl"), remaining.map((entry) => JSON.stringify(entry)).join("\n") + (remaining.length > 0 ? "\n" : ""));
+		return before.length - remaining.length;
+	});
+}
+/** Remove every feedback entry; returns how many were dropped. */
+async function clearFeedback(stateRoot) {
+	return withMeetingLock(feedbackLockKey(stateRoot), async () => {
+		const before = await readFeedback(stateRoot);
+		await writeTextAtomic(join(stateRoot, "feedback.jsonl"), "");
+		return before.length;
+	});
+}
+
+//#endregion
+export { withMeetingLock as C, writeTextAtomic as D, writeReview as E, stateRootOf as S, writeMeeting as T, readUserActions as _, clearFeedback as a, sanitizeKey as b, listMeetings as c, normalizeReview as d, readFeedback as f, readTranscript as g, readReview as h, appendUtterance as i, meetingDirOf as l, readMeeting as m, appendFeedback as n, clearFeedbackForMeeting as o, readKbDigest as p, appendUserAction as r, clearUserActions as s, CURRENT_MEETING_SCHEMA_VERSION as t, normalizeMeeting as u, readUserActionsReport as v, writeKbDigest as w, setViewpointStatus as x, resetMeetingDirectory as y };

package/lib/state-pJShWoUr.js

@@ -0,0 +1,3 @@
+import { C as withMeetingLock, D as writeTextAtomic, E as writeReview, S as stateRootOf, T as writeMeeting, _ as readUserActions, a as clearFeedback, b as sanitizeKey, c as listMeetings, d as normalizeReview, f as readFeedback, g as readTranscript, h as readReview, i as appendUtterance, l as meetingDirOf, m as readMeeting, n as appendFeedback, o as clearFeedbackForMeeting, p as readKbDigest, r as appendUserAction, s as clearUserActions, t as CURRENT_MEETING_SCHEMA_VERSION, u as normalizeMeeting, v as readUserActionsReport, w as writeKbDigest, x as setViewpointStatus, y as resetMeetingDirectory } from "./state-BzBQig2q.js";
+
+export { CURRENT_MEETING_SCHEMA_VERSION, appendFeedback, appendUserAction, appendUtterance, clearFeedback, clearFeedbackForMeeting, clearUserActions, listMeetings, meetingDirOf, normalizeMeeting, normalizeReview, readFeedback, readKbDigest, readMeeting, readReview, readTranscript, readUserActions, readUserActionsReport, resetMeetingDirectory, sanitizeKey, setViewpointStatus, stateRootOf, withMeetingLock, writeKbDigest, writeMeeting, writeReview, writeTextAtomic };

package/lib/types/aggregator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The aggregation gateway (V1): a deterministic structured merge of the
+ * transcript — no extra model. It groups utterances by speaker, keeps the
+ * most recent lines per speaker, and emits a compact canonical view for the
+ * captain. A model-side summary can later be layered on top by the captain.
+ * @module dsh-plugin-roundtable/aggregator
+ */
+import type { MeetingUtterance } from './types.ts';
+/** Pull the "core output" / stance out of a formatted contribution, else compact the whole text.
+ *
+ *  导出给 `roundtable_status` 复用：同一条 400 字符的配额，取 `[核心产出]`
+ *  比取发言开头（`[当前状态]`）信息量大得多 —— 不是配额不够，是取错了地方。 */
+export declare function extractCore(text: string): string;
+/** Merge utterances into a compact, chronological exchange (who → whom: core point). */
+export declare function aggregateUtterances(utterances: readonly MeetingUtterance[], maxLength?: number): string;

package/lib/types/budget.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Meeting budget: round/token caps and the mute (闭麦) gate.
+ * @module dsh-plugin-roundtable/budget
+ */
+import type { Meeting } from './types.ts';
+/** Which budget axis is exceeded, if any. */
+export declare function budgetExceeded(meeting: Meeting): 'rounds' | 'tokens' | undefined;
+/** Error when the meeting has ended. */
+export declare class MeetingEndedError extends Error {
+    constructor(meetingId: string);
+}
+/** Error when the meeting is muted (闭麦) on a budget axis. */
+export declare class MeetingMutedError extends Error {
+    readonly axis: 'rounds' | 'tokens';
+    constructor(meetingId: string, axis: 'rounds' | 'tokens');
+}
+/**
+ * Gate a write against the meeting's status and budget WITHOUT mutating it.
+ *
+ * The previous `ensureActive` both flipped `status` to `'muted'` and then threw
+ * on the same call. Because the throw happened before the caller could persist
+ * anything, `muted` never reached disk, and the very tools meant to resolve the
+ * situation (`roundtable_set_budget`, `roundtable_close`, the two exporters)
+ * were rejected by that same gate — a meeting that had spent its budget stayed
+ * `active` forever while refusing every action.
+ *
+ * @param meeting - meeting to test.
+ * @param options.allowMuted - resolve/escalate paths (top up the budget, close,
+ *   export, clear the user-action queue) stay reachable while muted; everything
+ *   that produces new work still throws.
+ */
+export declare function assertUsable(meeting: Meeting, options?: {
+    allowMuted?: boolean;
+}): void;
+/**
+ * Persist the fact that the meeting is out of budget.
+ *
+ * @param meeting - meeting mutated in place.
+ * @returns true when the status just became `'muted'`, in which case the caller
+ *   owns writing the meeting back so the mute is actually observable.
+ */
+export declare function markMuted(meeting: Meeting): boolean;
+/** Estimate the token cost of a text (coarse: ~0.6 tokens per CJK char, ~0.3 per latin). */
+export declare function estimateTokens(text: string): number;
+/** Advance the meeting round and return the new round number. */
+export declare function beginRound(meeting: Meeting): number;

package/lib/types/charter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The《全局协作总纲》generated at meeting start and injected into every
+ * expert node's persona. Four fixed sections per the V1 spec.
+ *
+ * 体积纪律：这份文本进入**每一位专家**的 persona，并跟着他的每一次请求
+ * 付费。所以这里只写"所有专家共同的协议与红线"；"你这个节点具体怎么做"
+ * 写在 {@link ./prompt.ts} 的 `nodePersona()`，同一条约束绝不两处各写一遍。
+ * 体积极限由 `test/prompt-budget.test.mjs` 断言。
+ * @module dsh-plugin-roundtable/charter
+ */
+import type { Meeting } from './types.ts';
+/** Build the charter text for one meeting's current roster and edges. */
+export declare function buildCharter(meeting: Meeting): string;

package/lib/types/client/RoundTableSettings.d.ts

@@ -0,0 +1,14 @@
+/**
+ * RoundTable preference page (settings.section): default collaboration mode
+ * and budget defaults. Switching to egalitarian mode surfaces the safety
+ * limits (max rounds / max tokens) with a warning-style hint.
+ * @module dsh-plugin-roundtable/client/RoundTableSettings
+ */
+import type { RpcCaller } from './wire.ts';
+export interface RoundTableSettingsInjected {
+    rpc: RpcCaller;
+    t: (key: string) => string;
+}
+export interface RoundTableSettingsProps extends RoundTableSettingsInjected {
+}
+export declare function RoundTableSettings(props: RoundTableSettingsProps): JSX.Element;

package/lib/types/client/RoundTableView.d.ts

@@ -0,0 +1,27 @@
+/**
+ * RoundTable topology tab: the "圆桌会议" conversation view.
+ *
+ * Minimal two-column layout:
+ *   - main: meeting header (title/badges/budget) → topology canvas (captain
+ *     anchor, ring of expert nodes with brand avatars, directed edges) →
+ *     collapsible aggregation-gateway digest.
+ *   - sidebar: expert status list, role breakdown, knowledge-base skeleton,
+ *     recent-utterance activity log, and file outputs (none yet).
+ *
+ * The tab lists ALL meetings in the workspace (no session filter), so past
+ * meetings stay visible across session switches, plugin updates and restarts;
+ * a switcher dropdown is shown when more than one meeting exists.
+ *
+ * @module dsh-plugin-roundtable/client/RoundTableView
+ */
+import type { SessionId } from '@deepseek-ai/dsh-client-connection/client';
+import type { RpcCaller } from './wire.ts';
+export interface RoundTableViewInjected {
+    rpc: RpcCaller;
+    /** Locale-bound translator for the roundtable namespace. */
+    t: (key: string) => string;
+}
+export interface RoundTableViewProps extends RoundTableViewInjected {
+    sessionId: SessionId;
+}
+export declare function RoundTableView(props: RoundTableViewProps): JSX.Element;

package/lib/types/client/brand-logos.generated.d.ts

@@ -0,0 +1,5 @@
+/**
+ * AUTO-GENERATED by scripts/generate-logos.mjs — do not edit by hand.
+ * 图片源：src/client/assets/logos/（见该脚本头部的命名规范）。
+ */
+export declare const BRAND_LOGOS: Record<string, string>;

package/lib/types/client/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * dsh-plugin-roundtable — browser half.
+ *
+ * Two registrations:
+ *   1. `conversation.view` slot, id `roundtable` — the "圆桌会议" topology tab
+ *      (left captain anchor, ring of expert nodes, directed edges with arrows,
+ *      breathing-light activity, right-click edge menu, drag-to-connect).
+ *   2. `settings.section` slot, id `roundtable` — the preference page
+ *      (default collaboration mode + budget defaults).
+ *
+ * @module @y9931666/dsh-plugin-roundtable/client
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Required services: the two slots registries plus locale. `connection` is NOT
+ * listed — cordis `inject` is load-gating (a name here keeps the whole client
+ * plugin PENDING until that service exists), so listing the OPTIONAL fallback
+ * transport meant a composition without it silently registered neither the
+ * 圆桌会议 tab nor the settings page. It is read live via `ctx.get('connection')`
+ * instead, which is what the RPC fallback below actually needs.
+ */
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/types/client/locales.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Locale dictionaries for the RoundTable browser UI.
+ * @module dsh-plugin-roundtable/client/locales
+ */
+export declare const NS = "roundtable";
+export type RoundTableKey = 'tab' | 'empty' | 'emptyHint' | 'modeOrchestrated' | 'modeEgalitarian' | 'modeRedteam' | 'round' | 'roundsBudget' | 'tokensBudget' | 'pendingDecision' | 'pendingDecisionOptions' | 'gatewayDigest' | 'noDigest' | 'edgeSetForward' | 'edgeSetBidirectional' | 'edgeRemove' | 'activityRunning' | 'activityIdle' | 'activityReady' | 'activityRemoved' | 'activityUnspawned' | 'activityMissing' | 'activityLifecycleHint' | 'legendTitle' | 'legendOrchestrated' | 'legendEgalitarian' | 'legendRedteam' | 'legendSynthetic' | 'legendPorts' | 'legendHide' | 'settingsLegend' | 'settingsLegendHint' | 'settingsSquadTitle' | 'settingsSquadHint' | 'settingsSquadAdd' | 'settingsSquadEmpty' | 'settingsSquadName' | 'settingsSquadNamePlaceholder' | 'settingsSquadMembers' | 'settingsSquadMemberKey' | 'settingsSquadMemberKeyPlaceholder' | 'settingsSquadAddMember' | 'settingsSquadRemoveMember' | 'settingsSquadSave' | 'settingsSquadCancel' | 'settingsSquadInvalid' | 'settingsSquadLimit' | 'settingsSquadUpdated' | 'settingsSquadEdit' | 'settingsSquadDelete' | 'settingsSquadMemberCount' | 'manageSquadLabel' | 'manageSquadPlaceholder' | 'manageSquadEmpty' | 'manageSquadAdded' | 'manageSquadSkipped' | 'settingsNav' | 'settingsDefaultMode' | 'settingsDefaultModeHint' | 'settingsEgalitarianWarning' | 'settingsMaxRounds' | 'settingsMaxTokens' | 'settingsSave' | 'settingsSaved' | 'settingsLoadFailed' | 'settingsSaveFailed' | 'fetchFailed' | 'renderFailed' | 'renderFailedHint' | 'meetingSelect' | 'agents' | 'tasks' | 'kb' | 'activity' | 'files' | 'kbEmpty' | 'filesEmpty' | 'noActivity' | 'editAgents' | 'editKb' | 'kbTitle' | 'kbPathLabel' | 'kbPathPlaceholder' | 'kbPathRequired' | 'kbSave' | 'kbSaved' | 'kbSaveFailed' | 'kbFiles' | 'kbLoadHint' | 'kbContentChanged' | 'kbBrowseHint' | 'kbNotSet' | 'meetingDelete' | 'meetingDeleteConfirm' | 'settingsShowAll' | 'settingsShowAllHint' | 'settingsShowAllOn' | 'settingsShowAllOff' | 'settingsLimitsTitle' | 'settingsSkillTitle' | 'settingsSkillDelivery' | 'settingsSkillDeliveryRelay' | 'settingsSkillDeliveryDirect' | 'settingsSkillDeliveryRelayHint' | 'settingsSkillDeliveryDirectHint' | 'skillsTitle' | 'skillsEmpty' | 'skillsDeliveryRelay' | 'skillsDeliveryDirect' | 'settingsPanelsTitle' | 'settingsPanelsHint' | 'panelOn' | 'panelOff' | 'settingsExpertMaxTokens' | 'settingsExpertMaxTokensHint' | 'settingsExpertMaxOpinions' | 'settingsExpertMaxOpinionsHint' | 'feedbackTitle' | 'feedbackEnabled' | 'feedbackEnabledHint' | 'feedbackPrivacyNote' | 'feedbackListEmpty' | 'feedbackListTitle' | 'feedbackClear' | 'feedbackCleared' | 'feedbackLoadFailed' | 'feedbackEntryMeta' | 'feedbackAskTitle' | 'feedbackAskGood' | 'feedbackAskMeh' | 'feedbackAskBad' | 'feedbackAskNotePlaceholder' | 'feedbackAskSkip' | 'feedbackAskSubmitted' | 'feedbackAskFailed' | 'pendingBadge' | 'manageTitle' | 'managePendingNote' | 'manageExisting' | 'manageRemove' | 'manageRemoveConfirm' | 'manageRemovedSoon' | 'manageQueueFailed' | 'managePendingRemove' | 'managePendingAdd' | 'managePendingAddRole' | 'manageAddTitle' | 'manageName' | 'manageNamePlaceholder' | 'manageNameRequired' | 'manageNameTaken' | 'manageRole' | 'manageRolePlaceholder' | 'manageModel' | 'manageModelInherit' | 'manageAddBtn' | 'manageAddedSoon' | 'manageEffectiveHint' | 'manageClose' | 'manageNoExperts' | 'reviewTitle' | 'reviewQuestion' | 'reviewPlan' | 'reviewViewpoints' | 'reviewEmpty' | 'reviewSupport' | 'reviewSupported' | 'reviewSupportedToast' | 'reviewEndorsed' | 'reviewEndorseFailed' | 'reviewHint' | 'reviewClose' | 'reviewBadge' | 'reviewOpen' | 'reviewPanelTitle' | 'reviewPanelEmpty' | 'reviewStatusReady' | 'reviewStatusReviewing' | 'reviewStatusDone' | 'reviewEndorsedCount' | 'reviewPending' | 'reviewRejected' | 'reviewReject' | 'reviewRejectedDone' | 'reviewRejectedToast' | 'reviewPendingToast' | 'reviewRejectReasonPrompt' | 'reviewRejectReasonPlaceholder' | 'reviewRejectReasonRequired' | 'reviewRejectConfirm' | 'reviewRejectCancel' | 'reviewEvidenceRepro' | 'reviewEvidenceArgument' | 'reviewPassBadge' | 'reviewImpactTitle' | 'reviewImpactThresholdHint' | 'reviewImpactOk' | 'reviewExportHint' | 'settingsPresetsTitle' | 'settingsPresetsHint' | 'settingsPresetsEmpty' | 'settingsPresetName' | 'settingsPresetNamePlaceholder' | 'settingsPresetRole' | 'settingsPresetRolePlaceholder' | 'settingsPresetModel' | 'settingsPresetAdd' | 'settingsPresetEdit' | 'settingsPresetSave' | 'settingsPresetCancel' | 'settingsPresetDelete' | 'settingsPresetInvalid' | 'settingsPresetLimit' | 'settingsPresetUpdated' | 'managePresetLabel' | 'managePresetPlaceholder' | 'managePresetEmpty';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The roundtable topology tab + settings page copy. */
+        roundtable: RoundTableKey;
+    }
+}
+export declare const zh: Record<RoundTableKey, string>;
+export declare const en: Record<RoundTableKey, string>;