@plumeai/plugin-sdk 0.0.0-stage → 0.1.2

package/dist/core/llm/utils/sse.d.ts

@@ -0,0 +1,69 @@
+/** Minimal SSE reader. Yields one parsed frame per `data:` payload. */
+export interface SseFrame {
+    event?: string;
+    data: string;
+}
+/**
+ * 同一条 SSE 流，加一个空闲闸。
+ *
+ * `readSse` 只接一个 AbortSignal，没有计时器：上游把连接挂住不再发帧时，那个 `await reader.read()`
+ * 就一直等下去，界面上是一个永远转着的圈，用户只能按停。计时另起一个控制器加在外面，和调用方那个
+ * 信号并起来交给它，每收到一块字节把计时拨回去。**默认行为一个字节都不变**——正常流里唯一多出来的事是
+ * 一次 `clearTimeout` + 一次 `setTimeout`。
+ *
+ * 住在这里而不是某一条链里：三条链的上游都会挂住，而这个函数本来写着「它被三条链共用」的注释，却
+ * 只有 Anthropic 那条接了——两条 OpenAI 链一直是裸的 `readSse`，挂住就无限等。共用的东西放在共用的
+ * 地方，是这件事不会再走岔的唯一办法。
+ *
+ * 取舍两点，都记在这里：
+ *
+ *   - 计时是**字节级**的，不是帧级的。只按帧算时，`: keepalive`、OpenRouter 的 `: OPENROUTER PROCESSING`
+ *     这类注释行保活不产出帧、不拨计时，一条一直在发保活的长思考会被当成死流闸掉。代价是一个只滴字节
+ *     不成帧的上游闸不掉——那种上游没见过，而保活是天天在跑的。
+ *   - `readSse` 收到 abort 之后走的是 `reader.cancel()`，那个生成器会**正常结束**而不是抛。所以闸掉
+ *     这件事得另外写在 `state.tripped` 上让调用方看——不看的话，一条挂死的流会被当成「模型没话说」，
+ *     或者更糟：一个截断了的回答被当成完整的。
+ */
+export declare function readSseWithIdleTimeout(response: Response, signal: AbortSignal | undefined, idleMs: number, state: {
+    tripped: boolean;
+}): AsyncGenerator<SseFrame>;
+/**
+ * 一条流安静多久算它已经死了。
+ *
+ * 十分钟，不是一个延迟指标而是一个死锁闸：生成期间各家都会周期性地发 `ping` 之类的保活帧，任何一帧
+ * 都把计时重新拨回去。所以走到这个阈值意味着**一帧都没有**，那不是「在想」。
+ */
+export declare const STREAM_IDLE_TIMEOUT_MS = 600000;
+/**
+ * 底层 HTTP 客户端的超时，宿主进程启动时装到全局 dispatcher 上（desktop `electron/main.ts`、cli `src/main.ts`）。
+ *
+ * Node 内置 fetch（undici）默认 `bodyTimeout` / `headersTimeout` 各 300 秒，比上面这个闸短一半：一条合法
+ * 沉默五分钟的流会先被 undici 以 `terminated`（`UND_ERR_BODY_TIMEOUT`）切断，再当成断线整轮重发——闸
+ * 形同虚设，钱付两遍。所以底层必须比闸长，留一分钟让闸先落、报出能看懂的那句话。
+ */
+export declare const TRANSPORT_TIMEOUT_MS: number;
+/**
+ * Parse tool-call arguments that may be truncated mid-stream.
+ *
+ * A model that hits the output limit leaves `{"path": "/a/b` on the wire. Returning `{}` there
+ * would hand the tool a silently empty argument set, so callers get `null` and fail the call
+ * instead of executing something wrong.
+ */
+/**
+ * 一段工具参数，变成能往字符串上接的样子。
+ *
+ * 协议写的是「参数按 JSON 字符串分片流式发来」，两条 OpenAI 链的解码器都照这个写：`raw += 片段`。
+ * 有的宿主不这么发——它一次给一个**完整的对象**（Google 的 `part.functionCall.args` 就是，中转站转译时
+ * 也会变成这样）。对象碰上 `+` 会被 JS 悄悄转成 `"[object Object]"`，于是模型明明说了参数，工具收到的
+ * 是这么一串东西：
+ *
+ *     "tool_calls": [{ "function": { "name": "calc", "arguments": "[object Object]" } }]
+ *
+ * 这一条特别难查，因为它不报错：请求发得出去，工具照跑，只是参数没了。真实端点上量到过一次，
+ * `deepseek-v4-flash:0731` 经中转站走 Chat Completions，第二轮的错是上游解析那串东西时报的
+ * 「Value looks like object, but can't find closing」——离真正的原因隔了一整个来回。
+ *
+ * 对象序列化成 JSON；字符串原样。其余（数字、布尔）按空处理：那不是参数分片，接上去只会污染缓冲区。
+ */
+export declare function argumentFragment(value: unknown): string;
+export declare function parseToolArguments(text: string): Record<string, unknown> | null;

package/dist/infra/rpc/src/endpoint.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 在 RpcChannel 上暴露一个对象、调用对端的对象。消息是 `{ method, args }`。
+ *
+ * 约定：
+ * - 被调方法的最后一个参数是 CallContext，由这里追加，调用方不用传。需要响应取消的方法把参数个数写死。
+ * - 方法返回异步迭代器（如 async generator）时，每个值作为中间值推给调用方，迭代器的 return 值是最终结果。
+ */
+import { type RpcChannel } from "./rpc.ts";
+/** 被调方法收到的最后一个参数。 */
+export interface CallContext {
+    /** 调用方取消、超时或通道关闭时中止。 */
+    signal: AbortSignal;
+}
+/**
+ * 一次远程调用。`await` 拿最终结果；方法返回异步迭代器时，还可以 `for await` 逐个拿中间值。
+ */
+export interface RemoteCall<Y, R> extends PromiseLike<R>, AsyncIterable<Y> {
+    then<A = R, B = never>(onfulfilled?: ((value: R) => A | PromiseLike<A>) | null, onrejected?: ((reason: unknown) => B | PromiseLike<B>) | null): Promise<A | B>;
+    catch<E = never>(onrejected?: ((reason: unknown) => E | PromiseLike<E>) | null): Promise<R | E>;
+    finally(onfinally?: (() => void) | null): Promise<R>;
+    /** 取消这次调用：对端收到中止信号，本地以 E_CANCELLED 失败。 */
+    cancel(): void;
+}
+type RemoteMethod<F> = F extends (...args: infer A) => infer R ? (...args: A extends [...infer Head, CallContext] ? Head : A) => R extends AsyncIterable<infer Y> ? RemoteCall<Y, AsyncReturn<R>> : RemoteCall<never, Awaited<R>> : never;
+type AsyncReturn<R> = R extends AsyncGenerator<unknown, infer Return, unknown> ? Return : undefined;
+/** 远端对象的代理：每个方法都变成 RemoteCall，末尾的 CallContext 参数由对端补上。 */
+export type Remote<T> = {
+    [K in keyof T]: RemoteMethod<T[K]>;
+};
+/** 把 target 暴露在通道上。target 是函数时每次调用现取，适合会被替换的对象。 */
+export declare function serve(channel: RpcChannel, target: object | (() => object)): void;
+/** 对端对象的代理。signal 中止时取消这个代理上所有进行中的调用。 */
+export declare function remote<T extends object>(channel: RpcChannel, options?: {
+    signal?: AbortSignal;
+}): Remote<T>;
+export {};

package/dist/infra/rpc/src/index.d.ts

@@ -0,0 +1,2 @@
+export { type CallContext, type Remote, type RemoteCall, remote, serve } from "./endpoint.ts";
+export { type ErrorCode, type IncomingCall, type Port, type RequestOptions, RpcChannel, RpcError, type RpcHandlers, toRpcError } from "./rpc.ts";

package/dist/infra/rpc/src/rpc.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 两个进程之间的双向 RPC。只依赖一个能收发结构化克隆消息的 Port，
+ * 所以 utilityProcess 的 parentPort、渲染进程的 MessagePort、测试里的内存管道都能用同一套。
+ * 不依赖任何第三方库：它会被打进渲染进程。
+ */
+export type ErrorCode = "E_NOT_FOUND" | "E_TIMEOUT" | "E_CANCELLED" | "E_CLOSED" | "E_HANDLER";
+export interface Port {
+    post(message: unknown): void;
+    /** 返回取消监听的函数。 */
+    listen(listener: (message: unknown) => void): () => void;
+}
+export declare class RpcError extends Error {
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string);
+}
+export declare function toRpcError(error: unknown, fallback?: ErrorCode): RpcError;
+export interface RequestOptions {
+    /** 不填表示不限时。 */
+    timeoutMs?: number;
+    /** 中止时向对端发取消，本地以 E_CANCELLED 失败。 */
+    signal?: AbortSignal;
+    /** 收到中间值时调用。 */
+    onChunk?(value: unknown): void;
+}
+/** 处理方看到的这次调用。 */
+export interface IncomingCall {
+    /** 发起方取消、超时或通道关闭时中止。 */
+    signal: AbortSignal;
+    /** 推送一个中间值给发起方。 */
+    emit(value: unknown): void;
+}
+export interface RpcHandlers {
+    request?(payload: unknown, call: IncomingCall): unknown;
+    note?(payload: unknown): void;
+}
+export declare class RpcChannel {
+    private readonly port;
+    private handlers;
+    private seq;
+    private readonly pending;
+    private readonly incoming;
+    private readonly unlisten;
+    private closedWith;
+    constructor(port: Port, handlers?: RpcHandlers);
+    setHandlers(handlers: RpcHandlers): void;
+    get closed(): boolean;
+    request(payload: unknown, options?: RequestOptions): Promise<unknown>;
+    notify(payload: unknown): void;
+    /** 关闭通道：挂起的请求全部以 E_CLOSED 失败，正在处理的请求被中止，之后的收发都被忽略。 */
+    close(reason?: string): void;
+    private settle;
+    private receive;
+    private answer;
+}

package/dist/theme.css

@@ -0,0 +1,336 @@
+/*
+ * 设计 token。每一处界面都从这里挑，不写临时的色值、字号、圆角。
+ *
+ * 颜色只有三个种子：背景 --plume-bg、前景 --plume-fg、强调色 --plume-accent，加一个对比度 --plume-contrast（0–1）。
+ * 其余色阶都由种子推出来：面从背景往前景走，字从背景往前景走得更远，都乘对比度。
+ * 换一个背景也不会得到看不清的字或看不见的线；皮肤通常只改种子，个别 token 不满意再单独覆盖。
+ *
+ * - 产品和 @plume/ui 用 Tailwind 工具类（bg-card、text-ink-muted、border-line……），由下面的 @theme 映射到 token；
+ *   Tailwind 自带的色板、字号清空了，只能用这里的；圆角用 Tailwind 的刻度加这里几档有语义的。可复用的类名组合在同一个包的 index.ts。
+ * - 每个 token 用在哪、什么时候加新的，见 spec/tech/tokens.md；写法规则见 spec/tech/styling.md。
+ * - 插件的界面入口单独构建，产品的 Tailwind 扫不到它们自己写的类名：插件用 @plume/ui 的组件、
+ *   @plume/styles 导出的类名组合，要自己写样式时用 var(--plume-*)，深浅色和皮肤都自动跟着变。
+ * - 皮肤插件经 ui.skin 覆盖这些变量；token 有增减时同步 @plume/contract/ui 的 SkinToken。
+ *
+ * 改了默认背景记得同步 apps/desktop/src/main/index.ts 里窗口的 backgroundColor。
+ */
+
+:root {
+	color-scheme: light dark;
+
+	/* ── 种子 ── */
+	--plume-bg: #f8f8f8;
+	--plume-fg: #262626;
+	--plume-accent: #339cff;
+	/* 0–1，每一档推导都乘 0.5 + 它，也就是 0.5×–1.5×。 */
+	--plume-contrast: 0.6;
+
+	/*
+	 * 推导的系数，按深浅色不同。不是 token，皮肤不改。
+	 *
+	 * 浅色下面和线分开算：面贴近页面（0.45×），线离页面远（1.7×）。共用一条曲线时线会比它要分隔的卡片还浅，
+	 * 每一层只能靠变灰来分开，叠三层整个界面就是灰的。深色下面变亮和字变亮是同一个方向，共用一条曲线（1×）。
+	 */
+	--plume-k: calc(0.5 + var(--plume-contrast));
+	--plume-k-surface: 0.45;
+	--plume-k-rule: 1.7;
+	/* 最浅那档字：浅色 52%、深色 56%，在最浅的面上也有 3:1。 */
+	--plume-k-faint: 52%;
+
+	/* ── 面 ── */
+	/* 窗口底色。 */
+	--plume-shell: var(--plume-bg);
+	/* 窗口最外层，数据皮肤可将它与正文区分开。 */
+	--plume-root: var(--plume-shell);
+	/* 强调色弱底；数据皮肤可直接指定，不再从强调色透明度推导。 */
+	--plume-accent-dim: color-mix(in srgb, var(--plume-accent) 10%, transparent);
+	--plume-sidebar: color-mix(in srgb, var(--plume-fg) calc(4.2% * var(--plume-k) * var(--plume-k-surface)), var(--plume-bg));
+	/* 卡片：工具卡片、用户消息。 */
+	--plume-card: color-mix(in srgb, var(--plume-fg) calc(6% * var(--plume-k) * var(--plume-k-surface)), var(--plume-bg));
+	/* 悬停、选中：前景色的一层薄纱，压在什么上面都看得出来。 */
+	--plume-card-hover: color-mix(in srgb, var(--plume-fg) 5%, transparent);
+	--plume-elevated: color-mix(in srgb, var(--plume-fg) 8.5%, transparent);
+	/* 输入框像纸：浅色下比页面更亮，往白走，而不是往前景走成灰的。 */
+	--plume-input: color-mix(in srgb, #fff 65%, var(--plume-bg));
+	/* 浮在最上面的：菜单、弹层。比它盖住的东西亮。 */
+	--plume-float: color-mix(in srgb, #fff 80%, var(--plume-bg));
+	/* 开关的圆点。深色下也是白的：灰圆点压在打开时的强调色上像脏了一块，开关最该清楚的时候反而最不清楚。 */
+	--plume-knob: #fff;
+	/*
+	 * 纯黑，只按透明度用（color-mix 到 transparent）：对话框的遮罩、白色旋钮的描边。深色下也是黑的：
+	 * 遮罩压暗的是窗口，从前景推出来的话深色下会变成一层灰雾。
+	 */
+	--plume-shade: #000;
+	/* 毛玻璃窗口的底：盖在系统材质上的半透明一层。浅色往页面色，深色往浮层色（比页面亮），材质透出来的颜色不会压过字。 */
+	--plume-window-tint: color-mix(in srgb, var(--plume-shell) 70%, transparent);
+
+	/* ── 线 ── */
+	--plume-line: color-mix(in srgb, var(--plume-fg) calc(7.5% * var(--plume-k) * var(--plume-k-rule)), var(--plume-bg));
+	--plume-line-soft: color-mix(in srgb, var(--plume-fg) calc(5% * var(--plume-k) * var(--plume-k-rule)), var(--plume-bg));
+	/* 画在浮层上的线：按前景的透明度算，落在什么面上都同样高出一档。 */
+	--plume-line-float: color-mix(in srgb, var(--plume-fg) 10%, transparent);
+
+	/* ── 字 ── */
+	--plume-ink: var(--plume-fg);
+	/* 次要文字在每一种面上 ≥4.5:1，最浅那档 ≥3:1。 */
+	--plume-ink-muted: color-mix(in srgb, var(--plume-fg) 70%, var(--plume-bg));
+	--plume-ink-faint: color-mix(in srgb, var(--plume-fg) var(--plume-k-faint), var(--plume-bg));
+
+	/* ── 状态 ── 浅底用透明度修饰（bg-danger/10），不另设 token。 */
+	--plume-ok: #3ecf8e;
+	/* 浅色单独一档更深的红：深色那档放到白底上，压在它自己 10% 的浅粉底上只有 3:1。 */
+	--plume-danger: #c92a30;
+	--plume-warning: #d97706;
+	/* 第二种色相：运行中的呼吸灯在 accent 和它之间走，不表示状态。 */
+	--plume-violet: #b18cf5;
+	/* 压在 accent 实色上的字（未读数这种小圆标），深浅色都是白的。 */
+	--plume-on-accent: #fff;
+	/* 图表：accent、violet、ok 之后再要几种排在一起分得开的色相（使用统计按模型拆的柱和列表）。不表示状态。 */
+	--plume-chart-2: #0d9488;
+	--plume-chart-3: #d97706;
+	--plume-chart-4: #9333ea;
+	--plume-chart-5: #e11d48;
+	--plume-chart-6: #65a30d;
+
+	/* ── 代码 ── 代码画在页面底色上；diff 是两层浅底，字仍是正文色。 */
+	--plume-code-bg: var(--plume-bg);
+	--plume-code-fg: var(--plume-ink);
+	--plume-code-line-height: 1.6;
+	--plume-code-tracking: 0em;
+	--plume-inline-code-bg: var(--plume-card-hover);
+	--plume-inline-code-fg: var(--plume-ink);
+	--plume-inline-code-ring: transparent;
+	--plume-diff-add: rgb(51 128 63 / 0.12);
+	--plume-diff-remove: rgb(200 64 47 / 0.1);
+	/*
+	 * 语法配色：回复里代码块的关键字、字符串这些，只经 var() 用在高亮样式里。按读代码时最常找的东西分档：
+	 * 被定义的名字（function）、类型（type）、字面量（string、number），注释最淡。变量名和没有规则认领的字是正文色。
+	 */
+	--plume-syntax-keyword: #2b62c6;
+	--plume-syntax-string: #0f7d78;
+	--plume-syntax-number: #9a6a00;
+	--plume-syntax-comment: #8a8a8a;
+	--plume-syntax-function: #8a45a5;
+	--plume-syntax-type: #33803f;
+	--plume-syntax-variable: var(--plume-ink);
+	--plume-syntax-operator: var(--plume-syntax-punctuation);
+	--plume-syntax-punctuation: #5f5f5f;
+	--plume-syntax-tag: #2b62c6;
+	--plume-syntax-attribute: #9a6a00;
+
+	/*
+	 * ── 圆角 ── 其余用 Tailwind 的刻度（lg 8、2xl 16、full……），落在两档中间的往小取。这里是有语义的几档。
+	 */
+	/* 面板：一整块内容区。 */
+	--plume-radius-panel: 12px;
+	/* 输入框、按钮共用一个，一排按钮挨着输入框不会像两套控件拼在一起。 */
+	--plume-radius-field: 8px;
+	/* 菜单里的行。 */
+	--plume-radius-item: 6px;
+	/* 浮起的菜单卡片。行是 item 6px，卡片 10px，中间留 menu-inset 4px。 */
+	--plume-radius-menu: 10px;
+
+	/* ── 尺寸 ── 输入框、下拉的高度。按钮是 32（h-8），一排里控件高度只有这两种。不给皮肤改。 */
+	--plume-control: 34px;
+	/* 菜单：卡片四边的内衬一样宽，悬停底色离左右边一样近；一行 32。 */
+	--plume-menu-inset: 4px;
+	--plume-menu-row: 32px;
+	/*
+	 * 主输入框：in 是卡片里所有上下内边距（字、附件条、工具栏底边），x 是左右内边距，
+	 * out 是卡片到窗格两边和窗口底边的外边距，control 是工具栏上每个按钮的边长。
+	 */
+	--plume-composer-in: 12px;
+	--plume-composer-x: 16px;
+	--plume-composer-out: 24px;
+	--plume-composer-control: 28px;
+	/*
+	 * 对话那一列的最大宽度：对话、审批卡、输入框共用。定值，窄窗格里铺满、宽了只居中，侧栏和面板开合时
+	 * 正文只平移、不重新断行。
+	 */
+	--plume-content: 864px;
+	/* 窗格外框：工作区围着窗格的内边距，和卡片里面离窗口边多远（内边距 + 窗格间距 + 1px 描边）。 */
+	--plume-frame-pad: 2px;
+	--plume-pane-chrome: 5px;
+
+	/* ── 字体 ── 不打包字体；等宽栈在 monospace 前加中文字体，否则 Windows 上代码里的中文落到宋体。 */
+	--plume-font-sans: ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+	--plume-font-mono:
+		ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", "Microsoft YaHei UI", "Microsoft YaHei", "PingFang SC",
+		"Noto Sans CJK SC", monospace;
+	/* 字号都从这两个算：界面一个，代码一个。 */
+	--plume-ui-size: 14px;
+	--plume-code-size: 12px;
+
+	/*
+	 * ── 动效 ── 时长按「什么在动」分档：quick 是状态变化（悬停、按下），base 是位置和尺寸，slow 是新出现的东西。
+	 * 曲线按方向：out 减速落定，用于出现；in 是它的镜像，用于离开；soft 用于原地变化。
+	 */
+	--plume-t-quick: 150ms;
+	--plume-t-base: 220ms;
+	--plume-t-reveal: 260ms;
+	--plume-t-slow: 340ms;
+	--plume-e-out: cubic-bezier(0.22, 1, 0.36, 1);
+	--plume-e-in: cubic-bezier(0.55, 0, 1, 0.45);
+	--plume-e-soft: cubic-bezier(0.4, 0, 0.2, 1);
+
+	/* ── 阴影 ── 按用途分档。rest：贴在页面上的卡片，比如主输入框。 */
+	--plume-shadow-rest: 0 20px 25px -5px rgb(0 0 0 / 0.05), 0 8px 10px -6px rgb(0 0 0 / 0.05);
+	/* 菜单、弹层卡片。 */
+	--plume-shadow-menu: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
+	/* 悬停提示。 */
+	--plume-shadow-tip: 0 4px 14px -4px rgb(0 0 0 / 0.3);
+	/* 对话框。 */
+	--plume-shadow-dialog: 0 18px 60px rgb(0 0 0 / 0.16), 0 2px 8px rgb(0 0 0 / 0.06);
+	/* 压在图片上的深色浮条：底下是什么不知道，所以重。 */
+	--plume-shadow-overlay: 0 8px 32px rgb(0 0 0 / 0.45);
+	/* 开关和分段控件的旋钮。 */
+	--plume-shadow-knob: 0 1px 2.5px rgb(0 0 0 / 0.16);
+	/* 半透明浮层：顶边一道内高光，像玻璃有厚度。 */
+	--plume-shadow-glass: inset 0 1px 0 rgb(255 255 255 / 0.4), 0 6px 20px -6px rgb(0 0 0 / 0.13), 0 1px 5px -2px rgb(0 0 0 / 0.09);
+	/* 提示条。浅色下和玻璃一样；深色下见下面。 */
+	--plume-shadow-toast: var(--plume-shadow-glass);
+}
+
+@media (prefers-color-scheme: dark) {
+	:root {
+		--plume-bg: #171717;
+		--plume-fg: #d4d4d4;
+
+		--plume-k-surface: 1;
+		--plume-k-rule: 1;
+		--plume-k-faint: 56%;
+
+		--plume-card-hover: color-mix(in srgb, var(--plume-fg) 6.2%, transparent);
+		--plume-elevated: color-mix(in srgb, var(--plume-fg) 10%, transparent);
+		/* 深色下输入框和浮层也往前景走（变亮），和其他面同一个方向。 */
+		--plume-input: color-mix(in srgb, var(--plume-fg) calc(3.5% * var(--plume-k)), var(--plume-bg));
+		--plume-float: color-mix(in srgb, var(--plume-fg) calc(10% * var(--plume-k)), var(--plume-bg));
+		--plume-window-tint: color-mix(in srgb, var(--plume-float) 60%, transparent);
+
+		--plume-danger: #f2555a;
+		--plume-warning: #fbbf24;
+		--plume-chart-2: #2dd4bf;
+		--plume-chart-3: #fbbf24;
+		--plume-chart-4: #c084fc;
+		--plume-chart-5: #fb7185;
+		--plume-chart-6: #a3e635;
+
+		--plume-diff-add: rgb(127 201 138 / 0.14);
+		--plume-diff-remove: rgb(240 113 113 / 0.13);
+
+		--plume-syntax-keyword: #79b8ff;
+		--plume-syntax-string: #6fd2c8;
+		--plume-syntax-number: #e3c07b;
+		--plume-syntax-comment: #6b6b6b;
+		--plume-syntax-function: #c39ac9;
+		--plume-syntax-type: #7fc98a;
+		--plume-syntax-punctuation: #a0a0a0;
+		--plume-syntax-tag: #79b8ff;
+		--plume-syntax-attribute: #e3c07b;
+
+		/* 深底上同样的投影看不见，旋钮像贴在轨道上；玻璃的内高光要压暗，否则是一道亮线。 */
+		--plume-shadow-knob: 0 1px 3px rgb(0 0 0 / 0.55);
+		--plume-shadow-glass: inset 0 1px 0 rgb(255 255 255 / 0.07), 0 8px 24px -6px rgb(0 0 0 / 0.5), 0 1px 6px -2px rgb(0 0 0 / 0.38);
+		/* 深底上一圈大范围的黑晕加顶边高光，提示条像悬在半空；只留一道贴边的影子，靠浮层底和描边分层。 */
+		--plume-shadow-toast: 0 1px 2px rgb(0 0 0 / 0.28);
+	}
+}
+
+@theme {
+	--color-*: initial;
+	--text-*: initial;
+}
+
+@theme inline {
+	--color-shell: var(--plume-shell);
+	--color-root: var(--plume-root);
+	--color-accent-dim: var(--plume-accent-dim);
+	--color-sidebar: var(--plume-sidebar);
+	--color-card: var(--plume-card);
+	--color-card-hover: var(--plume-card-hover);
+	--color-elevated: var(--plume-elevated);
+	--color-input: var(--plume-input);
+	--color-float: var(--plume-float);
+	--color-knob: var(--plume-knob);
+	--color-shade: var(--plume-shade);
+	--color-window-tint: var(--plume-window-tint);
+	--color-line: var(--plume-line);
+	--color-line-soft: var(--plume-line-soft);
+	--color-line-float: var(--plume-line-float);
+	--color-ink: var(--plume-ink);
+	--color-ink-muted: var(--plume-ink-muted);
+	--color-ink-faint: var(--plume-ink-faint);
+	--color-accent: var(--plume-accent);
+	--color-ok: var(--plume-ok);
+	--color-danger: var(--plume-danger);
+	--color-warning: var(--plume-warning);
+	--color-violet: var(--plume-violet);
+	--color-chart-2: var(--plume-chart-2);
+	--color-chart-3: var(--plume-chart-3);
+	--color-chart-4: var(--plume-chart-4);
+	--color-chart-5: var(--plume-chart-5);
+	--color-chart-6: var(--plume-chart-6);
+	--color-on-accent: var(--plume-on-accent);
+	--color-code-bg: var(--plume-code-bg);
+	--color-code-fg: var(--plume-code-fg);
+	--color-diff-add: var(--plume-diff-add);
+	--color-diff-remove: var(--plume-diff-remove);
+
+	--radius-panel: var(--plume-radius-panel);
+	--radius-field: var(--plume-radius-field);
+	--radius-item: var(--plume-radius-item);
+	--radius-menu: var(--plume-radius-menu);
+
+	--spacing-control: var(--plume-control);
+
+	--font-sans: var(--plume-font-sans);
+	--font-mono: var(--plume-font-mono);
+
+	/*
+	 * 字号七档加代码一档，都是界面字号的 calc，改一个数整套一起动。档与档至少差 1px，各自带行高和字距：
+	 * 字越大字距越紧。字重不放进档里，和字号配对写在用的地方（title 用 medium，heading、display 用 semibold）。
+	 */
+	--text-caption: calc(var(--plume-ui-size) - 2px);
+	--text-caption--line-height: 1.45;
+	--text-detail: calc(var(--plume-ui-size) - 1px);
+	--text-detail--line-height: 1.5;
+	/* 工作字号：行、控件、表格，大部分界面。 */
+	--text-label: var(--plume-ui-size);
+	--text-label--line-height: 1.5;
+	/* 正文：比控件松，句子是顺着读的。 */
+	--text-body: calc(var(--plume-ui-size) + 1px);
+	--text-body--line-height: 1.7;
+	--text-title: calc(var(--plume-ui-size) + 3px);
+	--text-title--line-height: 1.4;
+	--text-title--letter-spacing: -0.01em;
+	--text-heading: calc(var(--plume-ui-size) + 7px);
+	--text-heading--line-height: 1.3;
+	--text-heading--letter-spacing: -0.015em;
+	--text-display: calc(var(--plume-ui-size) + 16px);
+	--text-display--line-height: 1.2;
+	--text-display--letter-spacing: -0.022em;
+	/* 代码另起一档：另一种字体，按列读；行高 1.6 比正文紧，缩进和括号的形状不被拉散。 */
+	--text-code: var(--plume-code-size);
+	--text-code--line-height: var(--plume-code-line-height);
+	--text-code--letter-spacing: var(--plume-code-tracking);
+	/* 角标里的数字：图标按钮角上的计数 9px、小圆标里的未读数 10px。只给数字用，不放字。 */
+	--text-badge: calc(var(--plume-ui-size) - 5px);
+	--text-badge--line-height: 1;
+	--text-mark: calc(var(--plume-ui-size) - 4px);
+	--text-mark--line-height: 1;
+
+	--ease-out: var(--plume-e-out);
+	--ease-in: var(--plume-e-in);
+	--ease-soft: var(--plume-e-soft);
+	--default-transition-duration: var(--plume-t-quick);
+	--default-transition-timing-function: var(--plume-e-soft);
+
+	--shadow-rest: var(--plume-shadow-rest);
+	--shadow-menu: var(--plume-shadow-menu);
+	--shadow-tip: var(--plume-shadow-tip);
+	--shadow-dialog: var(--plume-shadow-dialog);
+	--shadow-overlay: var(--plume-shadow-overlay);
+	--shadow-knob: var(--plume-shadow-knob);
+	--shadow-glass: var(--plume-shadow-glass);
+	--shadow-toast: var(--plume-shadow-toast);
+}

package/dist/ui.d.ts

@@ -0,0 +1,2 @@
+/** @plume/ui 对插件开放的部分：packages/client/ui/plugin-api.json 里的名字。由 scripts/build-types.mjs 生成。 */
+export { Text, Button, IconButton, Input, Textarea, TextArea, Select, InlineSelect, Toggle, ComposerToggle, WorktreeToggle, Segmented, TabStrip, SearchField, NumberField, Slider, ColorField, TimeField, ShortcutRecorder, useFieldFade, ChoiceMark, Popover, ContextMenu, MenuItem, MenuSeparator, MenuLabel, Dialog, DialogAction, Confirm, useConfirmer, useConfirmGate, Tooltip, usePopover, MenuBody, MenuSearch, MENU_MAX_HEIGHT, Overlay, Card, CodeBlock, DiffView, ApprovalFrame, ApprovalExpiry, SettingsSectionTitle, SettingsCard, SettingsRow, SettingsNotice, PanelEmpty, RetainedViews, useNarrow, useLiveRefresh, PageTopRow, ActionSpinner, BreatheLoader, SkeletonList, SkeletonBar, useSlowLoad, HoverRow, HoverRowMark, HoverRowReveal, hoverSlot, Caret, MarkNumber, FlowRow, lookFor, iconColour, Scroller, OverlayScrollbar, ScrollText, Sideways, useI18n, relativeTime, TimeAgo, macKeyboard, composingKey, shortcutLetter, shortcutLabel, acceleratorLabel, motionReduced, CountUp, useRolled, RollingText, useNow, Collapse, Disclosure, AgentAvatar, AvatarPile, assignAvatars, AVATAR_SHAPES, AVATAR_COLORS, COLOR_ART, parseAvatar, formatAvatar, freshAvatar, withHanFallback, useAnnotator, AnnotateCanvas, AnnotateToolbar, useToolbarPlacement, HANDLES, HANDLE_CURSOR, handlePoint, hitHandle, insideRect, rectFromPoints, resizeRect, moveRect, clampRect } from "./client/ui/src/index.d.ts";

package/lib/build.mjs

@@ -0,0 +1,143 @@
+/**
+ * 构建一个插件：src/index.ts 打成逻辑入口 dist/index.mjs；有 src/ui.tsx 的再打出界面入口 dist/ui.mjs。
+ * `plume-plugin build` 和仓库的 scripts/build-plugins.mjs 都调它，插件只有这一种构建方式。
+ *
+ * - 逻辑入口：Node 平台的 ESM，依赖全部打进去（宿主的接口只有类型）。package.json 的 dependencies 例外：
+ *   打不进去的（node-pty 这类原生模块）写在那里，不打包，原样复制进 dist/node_modules，运行时按 Node 的解析找到。
+ *   一并复制实际安装的运行依赖闭包；按平台分的预编译（`os`/`cpu` 分包、prebuilds/<平台>-<架构>）带上 targets.mjs 里
+ *   那几个平台、架构装了的每一份：dist/ 会进 Plume 的多架构安装包，打包时再按目标裁（见 targets.mjs）。
+ * - 界面入口：浏览器 ESM；react、react/jsx-runtime、@plume/ui、@plume/styles 留作外部，运行时经宿主的 import map 用产品的实例。
+ *   只认这几个模块名本身：@plume/ui/icons 不在 import map 里，指到 SDK 自带的图标库打进插件（只打用到的那几个图标）。
+ *   引入的 .css 是一段文字，插件自己挂到页面上（宿主不加载插件的样式表）。
+ */
+
+import { existsSync } from "node:fs";
+import { cp, readFile, realpath, rm } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { basename, dirname, join, resolve, sep } from "node:path";
+import { build } from "esbuild";
+import { forTarget, TARGETS } from "./targets.mjs";
+
+const UI_SHARED = ["react", "react/jsx-runtime", "@plume/ui", "@plume/styles"];
+const ICONS = join(import.meta.dirname, "icons.mjs");
+
+/** esbuild 的 external 写包名会连子路径一起算外部，这里按整个模块名匹配。 */
+const shared = {
+	name: "plume-shared",
+	setup(build) {
+		const filter = new RegExp(`^(?:${UI_SHARED.map((name) => name.replace(/[/.]/g, "\\$&")).join("|")})$`);
+		build.onResolve({ filter }, (args) => ({ path: args.path, external: true }));
+		build.onResolve({ filter: /^@plume\/ui\/icons$/ }, () => ({ path: ICONS }));
+	},
+};
+const HOST = `${process.platform}-${process.arch}`;
+
+/** 复制实际安装的运行依赖，顶层同名冲突时放到依赖它的包下面。 */
+async function copyDependencies(dir, names) {
+	const target = join(dir, "dist/node_modules");
+	await rm(target, { recursive: true, force: true });
+	const placed = new Map();
+	const copied = new Set();
+
+	async function locate(from, name, required) {
+		const require = createRequire(join(from, "package.json"));
+		for (const modules of require.resolve.paths(name) ?? []) {
+			let file;
+			try {
+				// 不经 exports，且从实路径解析下一级，保留 pnpm 安装时的版本和 peer 上下文。
+				file = await realpath(join(modules, name, "package.json"));
+			} catch (error) {
+				if (error.code === "ENOENT") continue;
+				throw error;
+			}
+			const manifest = JSON.parse(await readFile(file, "utf8"));
+			// 必需的依赖要能在构建机上跑；可选的（按平台分的预编译包）只要合 TARGETS 里的一个就带上。
+			if (required ? !forTarget(manifest, HOST) : !TARGETS.some((target) => forTarget(manifest, target))) {
+				if (!required) return null;
+				throw new Error(`运行依赖 ${name} 不支持 ${HOST}（${from}）`);
+			}
+			return { source: dirname(file), manifest };
+		}
+		if (!required) return null;
+		throw new Error(`找不到运行依赖 ${name}（${from}）`);
+	}
+
+	async function copyPackage(pkg, destination) {
+		if (copied.has(destination)) return;
+		copied.add(destination);
+		const prebuilds = join(pkg.source, "prebuilds") + sep;
+		await cp(pkg.source, destination, {
+			recursive: true,
+			dereference: true,
+			filter: (path) => basename(path) !== "node_modules" && (!path.startsWith(prebuilds) || TARGETS.includes(path.slice(prebuilds.length).split(sep)[0])),
+		});
+		const dependencies = {
+			...Object.fromEntries(Object.keys(pkg.manifest.peerDependencies ?? {}).map((name) => [name, false])),
+			...Object.fromEntries(Object.keys(pkg.manifest.dependencies ?? {}).map((name) => [name, true])),
+			...Object.fromEntries(Object.keys(pkg.manifest.optionalDependencies ?? {}).map((name) => [name, false])),
+		};
+		for (const [name, required] of Object.entries(dependencies)) {
+			const dependency = await locate(pkg.source, name, required);
+			if (!dependency) continue;
+			const require = createRequire(join(destination, "package.json"));
+			const visible = require.resolve
+				.paths(name)
+				.map((modules) => join(modules, name))
+				.find((path) => placed.has(path));
+			// 只复用 Node 当前能找到且源实路径一致的包，不能只看包名或版本号。
+			let next = visible;
+			if (!visible || placed.get(visible) !== dependency.source) {
+				next = placed.has(join(target, name)) ? join(destination, "node_modules", name) : join(target, name);
+				placed.set(next, dependency.source);
+			}
+			await copyPackage(dependency, next);
+		}
+	}
+
+	// 先预留直接依赖的位置，免得先遍历的传递依赖抢占插件入口要用的版本。
+	const roots = [];
+	for (const name of names) {
+		const pkg = await locate(dir, name, true);
+		const destination = join(target, name);
+		placed.set(destination, pkg.source);
+		roots.push({ pkg, destination });
+	}
+	for (const { pkg, destination } of roots) await copyPackage(pkg, destination);
+}
+
+/**
+ * 构建 target 这个插件。成功返回打出来的文件说明（给命令行打印），失败抛错；esbuild 的报错它自己已经打过了。
+ * @param {string} target 插件目录（有 package.json 和 src/index.ts）
+ * @returns {Promise<string>}
+ */
+export async function buildPlugin(target) {
+	const dir = resolve(target);
+	const logic = join(dir, "src/index.ts");
+	const ui = join(dir, "src/ui.tsx");
+	if (!existsSync(logic)) throw new Error("找不到 src/index.ts");
+	const manifest = JSON.parse(await readFile(join(dir, "package.json"), "utf8"));
+	const native = Object.keys(manifest.dependencies ?? {});
+	const common = { bundle: true, format: "esm", sourcemap: "inline", logLevel: "warning", absWorkingDir: dir };
+
+	// 打进来的 CommonJS 依赖（MCP SDK 用的 cross-spawn 这类）会 `require("child_process")`；ESM 里没有 `require`，
+	// esbuild 的垫片找不到它就在加载时抛错，所以在文件头上给一个。
+	const banner = { js: 'import { createRequire as __plumeCreateRequire } from "node:module";\nconst require = __plumeCreateRequire(import.meta.url);' };
+	await build({ ...common, entryPoints: [logic], outfile: join(dir, "dist/index.mjs"), platform: "node", target: "node24", external: native, banner });
+	await copyDependencies(dir, native);
+	const outputs = [`dist/index.mjs${native.length > 0 ? `（带上 ${native.join("、")}）` : ""}`];
+	if (existsSync(ui)) {
+		await build({
+			...common,
+			entryPoints: [ui],
+			outfile: join(dir, "dist/ui.mjs"),
+			platform: "browser",
+			target: "chrome156",
+			jsx: "automatic",
+			plugins: [shared],
+			loader: { ".css": "text" },
+			define: { "process.env.NODE_ENV": '"production"' },
+		});
+		outputs.push("dist/ui.mjs");
+	}
+	return outputs.join("、");
+}