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

package/lib/types/rpc.d.ts

@@ -0,0 +1,89 @@
+/**
+ * RPC handlers for the browser topology tab:
+ *   - `roundtable/prefs.get`   → { defaultMode, maxRounds, maxTokens }
+ *   - `roundtable/prefs.set`   → persist user preferences
+ *   - `roundtable/edge.set`    → flip one edge's direction (UI right-click menu)
+ *   - `roundtable/edge.add`    → drag-to-connect a new channel
+ *   - `roundtable/edge.remove` → remove an edge
+ *
+ * Registered on the host through `ctx.inject(['connection'])` on the plugin's
+ * OWN RPC channel `/roundtable` (NOT the shared `/api` one). The `/api`
+ * channel is a single-interceptor shared channel owned by dsh-api-gateway, so
+ * registering a second `intercept('/api')` here throws
+ * "shared RPC channel /api already has an interceptor" and silently drops
+ * every roundtable RPC — which is exactly why drag-to-connect looked dead for
+ * both removed AND active nodes. Using `rpc.handle('/roundtable', ...)` gives
+ * this plugin its own prefix-routed channel, mirroring the ya-subagent plugin.
+ * @module dsh-plugin-roundtable/rpc
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { ROLE_PRESET_MAX, ROUNDTABLE_PANELS, SQUAD_MAX, SQUAD_MEMBER_MAX, sanitizeHiddenPanels, sanitizeRolePresets, sanitizeSquads, type PreferenceStore, type RoundTablePreferences } from './preferences.ts';
+/** RPC result envelope (mirrors the apiproxy wire shape). */
+export type RpcResult<T> = {
+    ok: true;
+    value: T;
+    error?: never;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    value?: never;
+};
+/**
+ * 偏好形状与净化规则住在 `preferences.ts`（那里的模块注释说明了原因：宿主
+ * 0.2.0-rc.2 把 `settings` 服务重构成 `SettingsForms`，插件不再能注册自己的
+ * 命名空间）。这里 re-export 只为不打断既有引用路径。
+ */
+export type { RoundTablePreferences };
+export { ROLE_PRESET_MAX, ROUNDTABLE_PANELS, SQUAD_MAX, SQUAD_MEMBER_MAX, sanitizeHiddenPanels, sanitizeRolePresets, sanitizeSquads, };
+/** 自持久化偏好存储 + 会议 state 根，共享给工具与 RPC 两条执行路径。 */
+export interface RoundTableRuntime {
+    /** 偏好读写（见 preferences.ts：宿主 settings 服务在 0.2.0-rc.2 已重构）。 */
+    prefs: PreferenceStore;
+    stateDir: string;
+}
+/**
+ * Browser-facing POST route for this plugin's RPC.
+ *
+ * It mirrors the snapshot route's transport (the plugin's own `webServer`
+ * registration) instead of relying on the host's generic connection channel,
+ * which is what the client actually reaches.
+ */
+export declare const RPC_ROUTE = "/plugins/dsh-plugin-roundtable/rpc";
+/** One endpoint dispatch: `(endpoint, payload) => envelope`, never throws. */
+export type RpcDispatch = (endpoint: string, payload: unknown) => Promise<RpcResult<unknown>>;
+/**
+ * Register the RoundTable RPC handler.
+ *
+ * Two transports share ONE dispatch body, so the browser can reach the plugin
+ * even when the host's generic `connection` channel is not mounted (or its
+ * `/roundtable` prefix got dropped by a live plugin reload):
+ *   1. the host `connection` RPC channel `/roundtable` (kept for compatibility);
+ *   2. the plugin's own `webServer` POST route `<RPC_ROUTE>` — the same
+ *      transport as the `/plugins/dsh-plugin-roundtable/state` snapshot route,
+ *      which is what the browser actually uses.
+ *
+ * @returns the dispatch function, so the caller can mount it on a web route.
+ */
+export declare function registerRpc(ctx: Context, runtime: RoundTableRuntime): RpcDispatch;
+/** One knowledge-base directory entry (阅览版: name/kind/format/size only). */
+export interface KbEntry {
+    name: string;
+    kind: 'file' | 'dir';
+    /** Lowercased extension without the dot (empty for directories). */
+    ext: string;
+    size: number;
+    mtimeMs: number;
+}
+/**
+ * List the first level of a knowledge-base directory (browse-only): skips
+ * dot-hidden entries, caps the result at 300 items so a huge folder cannot
+ * blow up the UI, and tolerates per-entry stat failures.
+ */
+export declare function listKbDirectory(dir: string): Promise<{
+    error: string;
+    files: KbEntry[];
+}>;

package/lib/types/skills.d.ts

@@ -0,0 +1,61 @@
+/**
+ * DSH 原生 skill 能力的宿主侧读取（R2）。
+ *
+ * 插件**不**做 skill 导入：skill 的来源是官方目录
+ * （`<工作区>/.dsh/skills/`、`<工作区>/.agents/skills/`、`<DSH_HOME>/skills/`
+ * 以及 bundled 目录），由 `@deepseek-ai/dsh-skill-filesystem` 发现。本模块只
+ * 通过 `ctx.get('skills')` 可选读取清单与正文。
+ *
+ * 两个硬约束决定了这里的形状：
+ * 1. 插件可以在没有挂载 skill 服务的 profile 里加载 —— 因此一律走
+ *    `ctx.get('skills')` 的**可选**读取，服务缺失只降级为空清单，绝不
+ *    让插件加载失败。
+ * 2. skill 工具的可用性由宿主决定，"放行 `skill` 工具"不等于"服务可用"，
+ *    因此放行与否由调用方单独判断（见 members.ts）。
+ *
+ * @module dsh-plugin-roundtable/skills
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** `ctx.skills.list()` 返回条目的结构性最小视图（只取插件要用的字段）。 */
+export interface SkillSummaryLike {
+    readonly name: string;
+    readonly description: string;
+    readonly whenToUse?: string;
+    readonly source?: string;
+    readonly provider?: string;
+    readonly invocation?: {
+        readonly modelInvocable?: boolean;
+        readonly userInvocable?: boolean;
+    };
+}
+/** 完整 skill 定义（含正文）。 */
+export interface SkillDefinitionLike extends SkillSummaryLike {
+    readonly content: string;
+}
+/** 只声明插件真正用到的两个方法，避免把宿主的服务类绑死在类型里。 */
+export interface SkillRegistryLike {
+    list(options?: {
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<SkillSummaryLike[]>;
+    get(name: string, options?: {
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<SkillDefinitionLike | undefined>;
+}
+/** 读取 skill 服务；未挂载时返回 undefined（不抛错、不影响插件加载）。 */
+export declare function skillRegistryOf(ctx: Context): SkillRegistryLike | undefined;
+/**
+ * 列出某个工作区可见的、**可被模型调用**的 skill 清单。
+ *
+ * 服务缺失、发现失败或工作区不可读时都降级为空数组：设置卡片上的 skill
+ * 列表因此永远不会成为创建会议的阻塞点。
+ */
+export declare function listInvocableSkills(ctx: Context, cwd: string, signal?: AbortSignal): Promise<SkillSummaryLike[]>;
+/**
+ * 读取一个 skill 的正文（relay 模式下主持人转交用）。
+ * 未挂载服务或 skill 不存在时返回 undefined。
+ */
+export declare function readSkillBody(ctx: Context, name: string, cwd: string, signal?: AbortSignal): Promise<SkillDefinitionLike | undefined>;
+/** 把清单渲染成卡片/工具输出用的一行行文本。 */
+export declare function formatSkillLine(summary: SkillSummaryLike): string;

package/lib/types/snapshot.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Web snapshot collection: reads the disk truth under every workspace's
+ * state root and merges live node activity. The browser topology tab polls
+ * `/plugins/dsh-plugin-roundtable/state` for this.
+ * @module dsh-plugin-roundtable/snapshot
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** One meeting snapshot for the Web UI. */
+export interface MeetingSnapshot {
+    id: string;
+    name: string;
+    goal: string;
+    mode: string;
+    status: string;
+    round: number;
+    workspace: string;
+    /** 主持（创建）该会议的会话 id —— 用于"来源对话"前缀与互通过滤。 */
+    captainSessionId: string;
+    /** 知识库目录（阅览版）；空 = 未设置。 */
+    kbPath: string;
+    /** R2：本次会议选中的 skill 名称清单；空 = 未选。 */
+    skills: string[];
+    /** R2.2/D5：skill 传递方式（relay / direct）。 */
+    skillDelivery: string;
+    budget: {
+        maxRounds: number;
+        maxTokens: number;
+        usedRounds: number;
+        usedTokens: number;
+        usedTokensReal?: number;
+    };
+    nodes: {
+        id: string;
+        key: string;
+        role: string;
+        provider: string;
+        model: string;
+        status: string;
+        activity: string;
+    }[];
+    edges: {
+        id: string;
+        from: string;
+        to: string;
+        direction: string;
+    }[];
+    pendingDecisions: {
+        id: string;
+        question: string;
+        options: string[];
+    }[];
+    /** Pending user actions recorded by the Web UI, awaiting the captain. */
+    pendingActions: {
+        id: string;
+        kind: string;
+        nodeKey: string;
+        role: string;
+        provider: string;
+        model: string;
+        text: string;
+    }[];
+    /** 针锋相对评审（无则 null）。 */
+    review: {
+        status: string;
+        reviewPass: number;
+        maxReviewPass: number;
+        question: string;
+        plan: string;
+        viewpoints: {
+            id: string;
+            nodeKey: string;
+            content: string;
+            endorsed: boolean;
+        }[];
+    } | null;
+    digest: string;
+    messages: {
+        id: string;
+        from: string;
+        to: string;
+        ts: number;
+    }[];
+    recent: {
+        id: string;
+        from: string;
+        to: string;
+        text: string;
+        ts: number;
+        round: number;
+    }[];
+}
+/** Collect snapshots across state roots, optionally filtered by captain session. */
+export declare function collectMeetingSnapshots(ctx: Context, roots: readonly {
+    workspace: string;
+    stateRoot: string;
+}[], sessionFilter?: string): Promise<MeetingSnapshot[]>;

package/lib/types/state.d.ts

@@ -0,0 +1,142 @@
+/**
+ * RoundTable durable state: atomic file persistence under
+ * `<workspace>/<stateDir>/<meetingId>/` with per-meeting process-local locks.
+ *
+ * - `meeting.json`     — the Meeting record (nodes, edges, decisions, budget).
+ * - `transcript.jsonl` — append-only utterance log (torn-tail tolerant on read).
+ * - `review.json`      — 针锋相对评审记录（议题/方案/观点/支持标记）。
+ * - `user-actions.jsonl` — UI 行为记录（主持人下轮执行）。
+ * - `kb-digest.json`   — 知识库摘要缓存（C2：命中即免去重读）。
+ * @module dsh-plugin-roundtable/state
+ */
+import type { FeedbackEntry, KbDigestEntry, KbDigestFile, Meeting, MeetingUtterance, ReviewRecord, UserAction } from './types.ts';
+/** Stable directory id from a display name (keeps CJK, lowercases latin). */
+export declare function sanitizeKey(value: string): string;
+/** Serialize async operations sharing one key inside this process. */
+export declare function withMeetingLock<T>(key: string, operation: () => Promise<T>): Promise<T>;
+/** Absolute state root under a workspace. */
+export declare function stateRootOf(workspace: string, stateDir: string): string;
+/** Absolute directory of one meeting. */
+export declare function meetingDirOf(stateRoot: string, meetingId: string): string;
+/**
+ * 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.
+ */
+export declare function resetMeetingDirectory(stateRoot: string, meetingId: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function writeTextAtomic(file: string, text: string): Promise<void>;
+/** Read one meeting record; undefined when absent.
+ *
+ *  与 {@link readReview} 对齐：读出来的记录一律先过 {@link normalizeMeeting}
+ *  升级到当前 schema 版本。v0.2.36 之前这里是全插件唯一的「裸
+ *  `JSON.parse(...) as Meeting`」——形状一变老会议就静默读坏，而且没有任何
+ *  版本号可供分支。 */
+export declare function readMeeting(stateRoot: string, meetingId: string): Promise<Meeting | undefined>;
+/** Persist one meeting record (atomic). 写入前同样过一遍 normalize：这样
+ *  「读时升级 + 下次写入顺带落盘」形成一个闭环，老文件不会永远停在旧版本。 */
+export declare function writeMeeting(stateRoot: string, meeting: Meeting): Promise<void>;
+/** 当前 `meeting.json` 的形状版本。加字段/改语义时递增，并在
+ *  {@link MEETING_MIGRATIONS} 补一条从「前一版」升上来的函数。 */
+export declare const CURRENT_MEETING_SCHEMA_VERSION = 1;
+/**
+ * Idempotently upgrade one meeting record to
+ * {@link CURRENT_MEETING_SCHEMA_VERSION}（**内存内**，不写回；下次
+ * {@link writeMeeting} 落盘时顺带升级）。
+ *
+ * 缺失 `schemaVersion` 视为 1（v0.2.36 及之前的文件都是这个形状），然后
+ * 依次跑迁移表。三条防御：
+ *   - 迁移函数抛错 → 保留原记录并告警，**绝不让读会议失败**（读不出来比读得
+ *     不完美严重得多，那会让整场会议从界面上消失）；
+ *   - 版本高于当前（用户从新版本回退到老版本）→ 原样返回并告警，不做降级
+ *     猜测；
+ *   - 版本非法（非整数 / < 1）→ 归一到 1 再走迁移。
+ */
+export declare function normalizeMeeting(meeting: Meeting): Meeting;
+/** Append one utterance to the meeting transcript (JSONL). */
+export declare function appendUtterance(stateRoot: string, meetingId: string, utterance: MeetingUtterance): Promise<void>;
+/** Read the full transcript, skipping torn tails and malformed lines. */
+export declare function readTranscript(stateRoot: string, meetingId: string): Promise<MeetingUtterance[]>;
+/** List every meeting id under a state root (missing root = empty). */
+export declare function listMeetings(stateRoot: string): Promise<string[]>;
+/** 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`. */
+export declare function appendUserAction(stateRoot: string, meetingId: string, action: UserAction): Promise<void>;
+/** Result of parsing `user-actions.jsonl`: the usable actions plus the number
+ *  of lines that were NOT valid JSON. The count exists so a torn tail is
+ *  *reported* instead of silently vanishing (A2). */
+export interface UserActionsReport {
+    actions: UserAction[];
+    /** Unparseable lines (torn tail / half-written JSON) that were dropped. */
+    malformed: number;
+}
+/** Read every pending user action, counting rather than hiding bad lines. */
+export declare function readUserActionsReport(stateRoot: string, meetingId: string): Promise<UserActionsReport>;
+/** Read every pending user action, skipping torn tails and malformed lines. */
+export declare function readUserActions(stateRoot: string, meetingId: string): Promise<UserAction[]>;
+/**
+ * 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).
+ */
+export declare function clearUserActions(stateRoot: string, meetingId: string): Promise<{
+    cleared: number;
+    malformed: number;
+}>;
+/** 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). */
+export declare function readReview(stateRoot: string, meetingId: string): Promise<ReviewRecord | undefined>;
+/** 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. */
+export declare function normalizeReview(review: ReviewRecord): ReviewRecord;
+/** Persist the review record (atomic). */
+export declare function writeReview(stateRoot: string, meetingId: string, review: ReviewRecord): Promise<void>;
+/** 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. */
+export declare function setViewpointStatus(stateRoot: string, meetingId: string, viewpointId: string, status: 'pending' | 'endorsed' | 'rejected', rejectReason?: string): Promise<boolean>;
+/** 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. */
+export declare function readKbDigest(stateRoot: string, meetingId: string): Promise<KbDigestFile>;
+/** Persist the knowledge-base digest cache (atomic). */
+export declare function writeKbDigest(stateRoot: string, meetingId: string, entries: readonly KbDigestEntry[]): Promise<void>;
+/** Append one feedback entry to `<stateRoot>/feedback.jsonl`. */
+export declare function appendFeedback(stateRoot: string, entry: FeedbackEntry): Promise<void>;
+/** Read every feedback entry (newest last), skipping torn tails. */
+export declare function readFeedback(stateRoot: string): Promise<FeedbackEntry[]>;
+/** Remove every feedback entry for one meeting id (dedupe); returns count removed. */
+export declare function clearFeedbackForMeeting(stateRoot: string, meetingId: string): Promise<number>;
+/** Remove every feedback entry; returns how many were dropped. */
+export declare function clearFeedback(stateRoot: string): Promise<number>;

package/lib/types/token-usage.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 真实用量读取（第 3 批）。
+ *
+ * 背景：`meeting.budget.usedTokens` 只累加**发言文本**的粗估（≈0.6 token/字），
+ * 不含 system prompt、专家 persona、历史上下文与工具调用开销。真实会议数据
+ * 里，它 7/7 场与"逐条发言文本估算"完全相等，而主持人自己的发言就吃掉
+ * 38.9%（某一场达 73.4%）—— 用户设 200k，专家实际能用的远不到一半。v0.2.35
+ * 只补了 UI 标注（"不是真实账单"），根因未修。
+ *
+ * 宿主其实有精确的 provider 上报值：
+ * - `ctx.sessionProjections.snapshot(session, ['tokenUsage'])` 的
+ *   `tokenUsage` 由每个 assistant settlement 的 usage 采样累加而来
+ *   （`uncachedInputTokens` / `outputTokens` / `cacheReadTokens` /
+ *   `cacheWriteTokens`，四桶互不重叠）；
+ * - `Agent.session` 是拿到 `Session` 的现成入口（`tools.ts` 早已在用
+ *   `agent.session.header.cwd`）。
+ *
+ * **明确否定的一条**：`ctx.subagents.sendMessage` / `startContinuable` 的返回值
+ * 都不带 usage，`SubagentResult` / `SubagentRunEndInfo` 也没有 —— 想接真实用量
+ * 只能走"子会话的 session"这条路。
+ *
+ * 本模块只读、不写状态：把真实值作为 `roundtable_status` 的派生输出，而不是
+ * 新落一个半成品字段（否则又是"定义了却没人用"的账）。冷会话（进程重启后的
+ * 旧节点）取不到值 —— 宁可标注"不可测"，也不拿估算冒充实测。
+ *
+ * @module dsh-plugin-roundtable/token-usage
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Provider-reported cumulative usage of one session. */
+export interface SessionUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    /** Sum of the four disjoint buckets. */
+    total: number;
+}
+/** Provider-anchored context occupancy of one session. */
+export interface SessionPressure {
+    /** Prompt size of the most recent request (uncached input + cache read/write). */
+    pressureTokens: number;
+    /** What the NEXT request's prompt would cost. */
+    projectedTokens: number;
+    /** Newest known route capacity (0 = adapter advertised none). */
+    contextWindow: number;
+}
+/** How many expert sessions could be measured for one meeting. */
+export interface MeetingRealUsage {
+    /** Sum of measured session totals. */
+    measuredTotal: number;
+    /** Sessions that produced a provider-reported figure. */
+    measuredSessions: number;
+    /** Child sessions that exist but could not be measured (cold / not live). */
+    unmeasuredSessions: number;
+}
+/** Coerce one projection value into a {@link SessionUsage}; undefined when empty. */
+export declare function normalizeUsage(value: unknown): SessionUsage | undefined;
+/** Coerce one projection value into a {@link SessionPressure}; undefined when empty. */
+export declare function normalizePressure(value: unknown): SessionPressure | undefined;
+/** Provider-reported usage of one live session (undefined when unavailable). */
+export declare function liveSessionUsage(ctx: Context, sessionId: string): SessionUsage | undefined;
+/** Provider-anchored pressure of one live session (undefined when unavailable). */
+export declare function liveSessionPressure(ctx: Context, sessionId: string): SessionPressure | undefined;
+/**
+ * Sum real usage across one meeting's expert child sessions.
+ *
+ * Each distinct session is measured once; ids that no longer resolve to a live
+ * agent are counted as `unmeasuredSessions` so the caller can say "3 of 5
+ * measured" instead of silently reporting a too-small total.
+ */
+export declare function meetingRealUsage(ctx: Context, sessionIds: readonly string[]): MeetingRealUsage;

package/lib/types/tools.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The `roundtable_*` model-facing tools.
+ *
+ * The captain (the session that created the meeting) orchestrates: expert
+ * nodes are continuable subagents it spawns and wakes. Nodes share the same
+ * tools, speak through `roundtable_speak`, and — in egalitarian mode — message
+ * each other directly. The aggregation gateway is a deterministic merge the
+ * captain pulls with `roundtable_summarize`; human decisions pause the turn
+ * through the `userQuestions` seam.
+ * @module dsh-plugin-roundtable/tools
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Meeting, MeetingUtterance, ReviewRecord, SkillDelivery, UserAction } from './types.ts';
+/** Resolved plugin config consumed by the tools. */
+export interface ToolsConfig {
+    /** State directory name under the captain's workspace. */
+    stateDir: string;
+    /** Node subagent provider name. */
+    memberProvider: string;
+    /** Meeting size cap (nodes). */
+    maxNodes: number;
+    /** Default collaboration mode. */
+    defaultMode: 'orchestrated' | 'egalitarian' | 'redteam';
+    /** Node delegation depth cap. */
+    memberMaxDepth?: number;
+    /** Live expert answer limits from settings (read at every spawn). */
+    getExpertLimits?: () => {
+        maxTokens: number;
+        maxOpinions: number;
+    };
+    /** Live default skill-delivery mode from settings (R2.2/D5). */
+    getSkillDelivery?: () => SkillDelivery;
+    /** 设置卡片默认值（R1，设置页那一层；调用时实时读取）。 */
+    getPlannedDefaults?: () => PlannedDefaults;
+    /** 观点拆分 LLM 路由（V0.2.2）：collect_review 时把发言拆成独立观点。 */
+    reviewSplit?: {
+        provider: string;
+        model: string;
+        maxOpinions: number;
+    };
+}
+/** Resolved defaults for one meeting's settings card (R1). */
+interface PlannedDefaults {
+    mode: 'orchestrated' | 'egalitarian' | 'redteam';
+    maxRounds: number;
+    maxTokens: number;
+    skillDelivery: SkillDelivery;
+}
+/** Register every `roundtable_*` tool into the shared tools registry. */
+export declare function registerRoundTableTools(ctx: Context, config: ToolsConfig): void;
+/**
+ * 把一场会议整体渲染成 Markdown 交付物（B6）。
+ *
+ * 只读既有磁盘状态（`meeting.json` / `transcript.jsonl` / `review.json` /
+ * `user-actions.jsonl`），**不新增任何状态**；会议进行中也能导出，此时头部
+ * 会标注"进行中快照"，避免把半场会议误当成结论。
+ */
+export declare function renderMeetingMarkdown(meeting: Meeting, utterances: readonly MeetingUtterance[], userActions: readonly UserAction[], review: ReviewRecord | undefined): string;
+export {};