@co0ontty/wand 4.83.1 → 4.84.0

package/dist/web-ui/index.d.ts

@@ -1 +1 @@
-export declare function renderApp(configPath: string): string;
+export declare function renderApp(configPath: string, page?: "console" | "settings", settingsAuth?: "browser" | "client"): string;

package/dist/web-ui/index.js

@@ -6,18 +6,18 @@ import { WAND_FAVICON_URL } from "./brand-identity.js";
 function vendorAssetUrl(relPath) {
     return `${relPath}?v=${EMBEDDED_WEB_ASSETS.vendor[relPath].hash}`;
 }
-export function renderApp(configPath) {
+export function renderApp(configPath, page = "console", settingsAuth = "browser") {
     const stylesHref = `/assets/app.css?v=${getStylesAsset().hash}`;
     const scriptSrc = `/assets/app.js?v=${getScriptAsset(configPath).hash}`;
     const xtermSrc = vendorAssetUrl("/vendor/xterm/xterm.bundle.js");
     const qrcodeSrc = vendorAssetUrl("/vendor/qrcode/qrcode.bundle.js");
     const xtermCssHref = vendorAssetUrl("/vendor/xterm/xterm.css");
     return `<!doctype html>
-<html lang="zh-CN">
+<html lang="zh-CN"${page === "settings" ? ` data-wand-page="settings" data-wand-settings-auth="${settingsAuth}"` : ""}>
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover, interactive-widget=resizes-content" />
-  <title>Wand Console</title>
+  <title>${page === "settings" ? "Wand 设置" : "Wand Console"}</title>
   <link rel="icon" type="image/svg+xml" href="${WAND_FAVICON_URL}" />
   <meta name="description" content="Local CLI Console for Vibe Coding - Manage terminal sessions from your browser" />
   <meta name="theme-color" content="#f1eadf" media="(prefers-color-scheme: light)" />

package/dist/web-ui/markdown.d.ts

@@ -0,0 +1,2 @@
+/** Shared parser with only Wand's presentation and local-link adaptations. */
+export declare function renderChatMarkdown(text: string): string;

package/dist/web-ui/markdown.js

@@ -0,0 +1,111 @@
+import { Marked, Renderer } from "marked";
+import { localFilePreviewHref, localHttpPreviewHref } from "./react/local-preview/controller.js";
+function escapeHtml(value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function serverFilePath(target) {
+    let value = target.trim();
+    if (/^file:/i.test(value)) {
+        try {
+            const url = new URL(value);
+            if (url.hostname && url.hostname !== "localhost")
+                return null;
+            value = decodeURIComponent(url.pathname);
+        }
+        catch {
+            return null;
+        }
+    }
+    else {
+        if (!value.startsWith("/") || value.startsWith("//"))
+            return null;
+        try {
+            value = decodeURIComponent(value);
+        }
+        catch { /* Keep literal percent signs. */ }
+    }
+    if (/^\/(?:api|android|macos)(?:\/|$)/.test(value))
+        return null;
+    return value.replace(/#L\d+(?:C\d+)?$/i, "").replace(/:\d+(?::\d+)?$/, "");
+}
+function previewAttributes(value, href) {
+    return [
+        ["href", href],
+        ["class", "local-preview-link"],
+        ["data-local-preview-url", value],
+        ["onclick", "if(window.__openLocalPreview){event.preventDefault();window.__openLocalPreview(this.getAttribute('data-local-preview-url'));}"],
+    ];
+}
+function linkAttributes(target) {
+    const path = serverFilePath(target);
+    if (path) {
+        const preview = /(?:\/$|\.(?:html?|)$)/i.test(path) ? localFilePreviewHref(path) : null;
+        if (preview)
+            return previewAttributes(path, preview);
+        return [
+            ["href", "/api/file-raw?download=1&path=" + encodeURIComponent(path)],
+            ["class", "server-file-link"],
+            ["data-server-file-path", path],
+            ["title", "打开或下载服务端文件"],
+            ["onclick", "if(window.__openFilePreview){event.preventDefault();window.__openFilePreview(this.getAttribute('data-server-file-path'));}"],
+        ];
+    }
+    const preview = localHttpPreviewHref(target);
+    if (preview)
+        return previewAttributes(target, preview);
+    if (/^https?:\/\//i.test(target)) {
+        return [["href", target], ["target", "_blank"], ["rel", "noopener noreferrer"]];
+    }
+    if (/^(?:mailto:|#)/i.test(target))
+        return [["href", target]];
+    return null;
+}
+// Marked parses Markdown; this renderer owns only Wand's output contracts.
+// Raw HTML is text, and links/images use explicit protocol allowlists. Never
+// enable raw HTML or accept renderer extensions from message content.
+const renderer = new Renderer();
+renderer.html = ({ text }) => escapeHtml(text);
+renderer.link = function ({ href, tokens }) {
+    const label = this.parser.parseInline(tokens);
+    const attributes = linkAttributes(href);
+    if (!attributes)
+        return "<span>" + label + "</span>";
+    return "<a" + attributes.map(([name, value]) => " " + name + '="' + escapeHtml(value) + '"').join("") + ">" + label + "</a>";
+};
+renderer.image = ({ href, text, title }) => {
+    if (!/^https?:\/\//i.test(href) && (!href.startsWith("/") || href.startsWith("//")))
+        return escapeHtml(text);
+    return '<img src="' + escapeHtml(href) + '" alt="' + escapeHtml(text) + '"' +
+        (title ? ' title="' + escapeHtml(title) + '"' : "") + ' loading="lazy" decoding="async">';
+};
+renderer.heading = function ({ depth, tokens }) {
+    const tag = "h" + Math.min(depth + 1, 6);
+    return "<" + tag + ">" + this.parser.parseInline(tokens) + "</" + tag + ">\n";
+};
+renderer.codespan = ({ text }) => '<code class="code-inline">' + escapeHtml(text) + "</code>";
+renderer.code = ({ text, lang }) => {
+    const language = (lang || "").trim().split(/\s+/)[0];
+    const content = text.endsWith("\n") ? text : text + "\n";
+    return '<div class="code-block"><div class="code-block-header">' +
+        '<span class="code-lang">' + escapeHtml(language) + "</span>" +
+        '<button type="button" data-antd-control class="code-copy">复制</button></div>' +
+        "<pre><code>" + escapeHtml(content) + "</code></pre></div>\n";
+};
+renderer.tablecell = function ({ header, align, tokens }) {
+    const tag = header ? "th" : "td";
+    const alignment = align ? ' style="text-align:' + align + '"' : "";
+    return "<" + tag + alignment + ">" + this.parser.parseInline(tokens) + "</" + tag + ">\n";
+};
+const renderTable = renderer.table;
+renderer.table = function (token) {
+    return '<div class="md-table-wrap">' + renderTable.call(this, token)
+        .replace("<table>", '<table class="md-table">') + "</div>\n";
+};
+const markdown = new Marked({ renderer, breaks: true, gfm: true, async: false });
+/** Shared parser with only Wand's presentation and local-link adaptations. */
+export function renderChatMarkdown(text) {
+    if (!text)
+        return "";
+    return '<div class="markdown-content">' + markdown.parse(text, { async: false }) + "</div>";
+}

package/dist/web-ui/page.d.ts

@@ -0,0 +1,4 @@
+/** The HTML entry declares its page before browser modules execute. */
+export declare function isStandaloneSettingsPage(): boolean;
+/** Presentation only; the server still validates the live client session and WebView proof. */
+export declare function isClientSettingsPage(): boolean;

package/dist/web-ui/page.js

@@ -0,0 +1,8 @@
+/** The HTML entry declares its page before browser modules execute. */
+export function isStandaloneSettingsPage() {
+    return typeof document !== "undefined" && document.documentElement?.dataset.wandPage === "settings";
+}
+/** Presentation only; the server still validates the live client session and WebView proof. */
+export function isClientSettingsPage() {
+    return isStandaloneSettingsPage() && document.documentElement.dataset.wandSettingsAuth === "client";
+}

package/dist/web-ui/react/local-preview/controller.d.ts

@@ -0,0 +1,30 @@
+export type LocalPreviewMode = "url" | "file";
+export interface LocalPreviewSnapshot {
+    open: boolean;
+    mode: LocalPreviewMode;
+    value: string;
+    previewUrl: string | null;
+    sourceLabel: string;
+    error: string | null;
+}
+type Listener = () => void;
+/** Convert an HTTP loopback URL to its Wand proxy URL, or return null. */
+export declare function localHttpPreviewHref(input: string): string | null;
+/** Convert a server-side HTML file or directory to its local-file preview URL. */
+export declare function localFilePreviewHref(input: string): string | null;
+declare function openFile(value: string): boolean;
+declare function openUrl(value: string): boolean;
+export declare const localPreviewController: {
+    subscribe(listener: Listener): () => void;
+    getSnapshot(): LocalPreviewSnapshot;
+    isOpen(): boolean;
+    closeIfOpen(): boolean;
+    show(value?: string): void;
+    close(): void;
+    setMode(mode: LocalPreviewMode): void;
+    setValue(value: string): void;
+    openUrl: typeof openUrl;
+    openFile: typeof openFile;
+    submit(): void;
+};
+export {};

package/dist/web-ui/react/local-preview/controller.js

@@ -0,0 +1,159 @@
+let snapshot = {
+    open: false,
+    mode: "url",
+    value: "",
+    previewUrl: null,
+    sourceLabel: "",
+    error: null,
+};
+const listeners = new Set();
+function publish(patch = {}) {
+    snapshot = { ...snapshot, ...patch };
+    for (const listener of listeners)
+        listener();
+}
+function isLoopbackHostname(hostname) {
+    return ["localhost", "127.0.0.1", "[::1]", "::1"].includes(hostname.toLowerCase());
+}
+/** Convert an HTTP loopback URL to its Wand proxy URL, or return null. */
+export function localHttpPreviewHref(input) {
+    try {
+        const url = new URL(input.trim());
+        if (url.protocol !== "http:" || !isLoopbackHostname(url.hostname))
+            return null;
+        const port = url.port || "80";
+        return `/api/local-preview/127.0.0.1/${port}${url.pathname === "/" ? "/" : url.pathname}${url.search}`;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeLocalUrl(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error("请输入本地端口或地址。");
+    if (/^\d{1,5}$/.test(trimmed)) {
+        const port = Number(trimmed);
+        if (port < 1 || port > 65535)
+            throw new Error("端口号必须是 1–65535。");
+        return `/api/local-preview/127.0.0.1/${port}/`;
+    }
+    const withScheme = /^https?:\/\//i.test(trimmed) ? trimmed : `http://${trimmed}`;
+    const previewUrl = localHttpPreviewHref(withScheme);
+    if (!previewUrl)
+        throw new Error("只允许预览本机（localhost）HTTP 服务。");
+    return previewUrl;
+}
+function base64UrlPath(input) {
+    const bytes = new TextEncoder().encode(input);
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+/** Convert a server-side HTML file or directory to its local-file preview URL. */
+export function localFilePreviewHref(input) {
+    const value = input.trim();
+    if (!value.startsWith("/"))
+        return null;
+    return `/api/local-file/${base64UrlPath(value)}/`;
+}
+function normalizeLocalFile(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error("请输入文件或目录路径。");
+    return localFilePreviewHref(trimmed) ?? (() => { throw new Error("请输入服务端文件路径。"); })();
+}
+function openFile(value) {
+    try {
+        publish({
+            open: true,
+            mode: "file",
+            value,
+            previewUrl: normalizeLocalFile(value),
+            sourceLabel: value.trim(),
+            error: null,
+        });
+        return true;
+    }
+    catch (error) {
+        publish({
+            open: true,
+            mode: "file",
+            value,
+            error: error instanceof Error ? error.message : "无法打开本地文件预览。",
+        });
+        return false;
+    }
+}
+function openUrl(value) {
+    try {
+        publish({
+            open: true,
+            mode: "url",
+            value,
+            previewUrl: normalizeLocalUrl(value),
+            sourceLabel: value.trim(),
+            error: null,
+        });
+        return true;
+    }
+    catch (error) {
+        publish({
+            open: true,
+            mode: "url",
+            value,
+            error: error instanceof Error ? error.message : "无法打开本地预览。",
+        });
+        return false;
+    }
+}
+export const localPreviewController = {
+    subscribe(listener) {
+        listeners.add(listener);
+        return () => listeners.delete(listener);
+    },
+    getSnapshot() {
+        return snapshot;
+    },
+    isOpen() {
+        return snapshot.open;
+    },
+    closeIfOpen() {
+        if (!snapshot.open)
+            return false;
+        this.close();
+        return true;
+    },
+    show(value = "") {
+        publish({ open: true, value, error: null });
+    },
+    close() {
+        publish({ open: false, error: null });
+    },
+    setMode(mode) {
+        if (mode === snapshot.mode)
+            return;
+        publish({ mode, error: null });
+    },
+    setValue(value) {
+        publish({ value, error: null });
+    },
+    openUrl,
+    openFile,
+    submit() {
+        try {
+            const previewUrl = snapshot.mode === "url"
+                ? normalizeLocalUrl(snapshot.value)
+                : normalizeLocalFile(snapshot.value);
+            publish({
+                previewUrl,
+                sourceLabel: snapshot.value.trim(),
+                error: null,
+            });
+        }
+        catch (error) {
+            publish({ error: error instanceof Error ? error.message : "无法打开本地预览。" });
+        }
+    },
+};

package/dist/web-ui/running-activity.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 「正在执行」的客户端推导：只允许对服务端下发的运行事实与锚点时刻做展示差分。
+ * 锚点（turnStartedAt / lastActivityAt）缺失时一律不显示时长，前端不本地起表伪造运行中。
+ */
+/** 服务端会话快照里本模块关心的字段（structured 与 PTY 共用同一形状）。 */
+export interface RunningActivityShape {
+    readonly status?: string;
+    readonly archived?: boolean;
+    readonly permissionBlocked?: boolean;
+    readonly pendingEscalation?: unknown;
+    readonly queuedMessages?: readonly unknown[] | null;
+    /**
+     * PTY 本轮是否真在跑（computeRunningSignal().ptyRunning）。
+     * 裸 shell 的 status 一直是 running，不带上这个判定会把空闲终端读成「正在执行」。
+     */
+    readonly ptyRunning?: boolean;
+    readonly structuredState?: {
+        readonly inFlight?: boolean;
+        readonly phase?: string;
+        readonly turnStartedAt?: string | null;
+        readonly lastActivityAt?: string | null;
+    } | null;
+    readonly turnStartedAt?: string | null;
+    readonly lastActivityAt?: string | null;
+}
+/** 团队 run / 步骤的对应字段（与 run detail、/live 同语义）。 */
+export interface RunningRunShape {
+    readonly status?: string;
+    readonly startedAt?: string | null;
+    readonly turnStartedAt?: string | null;
+    readonly lastActivityAt?: string | null;
+}
+export type RunningPhase = "received" | "executing" | "waiting" | "idle";
+/** 静默起显阈值：超过后从「正在执行」升级为「仍在运行 · 已 N 分钟无新消息」。 */
+export declare const SILENCE_NOTICE_MS = 60000;
+/** 本轮开始时刻：只取服务端锚点，缺失返回 null（调用方不得回落到本地挂载时刻）。 */
+export declare function turnStartedAtMs(source: RunningActivityShape | null | undefined): number | null;
+/** 最近一次服务端观测到活动的时刻。 */
+export declare function lastActivityAtMs(source: RunningActivityShape | RunningRunShape | null | undefined): number | null;
+export declare function isRunningNow(source: RunningActivityShape | RunningRunShape | null | undefined): boolean;
+/** 会话侧运行事实：structured 看本轮 inFlight，PTY 看 ptyRunning，两者都不看本地计时。 */
+export declare function sessionRunning(source: RunningActivityShape | null | undefined): boolean;
+/**
+ * 分阶段：等待审批/输入 > 已接收排队 > 正在执行 > 结束。
+ * 非运行中一律 idle，调用方必须据此立即收敛状态条，不留残留。
+ * `runMode` 给团队 run：那里的 status 就是运行事实本身。会话侧不行——裸 shell 的
+ * status 恒为 running，必须走 sessionRunning（structured inFlight / PTY ptyRunning）。
+ */
+export declare function computeRunningPhase(source: RunningActivityShape | null | undefined, runMode?: boolean): RunningPhase;
+/** 距最近一次活动已静默多久；锚点缺失或不在运行中时为 0。 */
+export declare function silenceDurationMs(source: RunningActivityShape | RunningRunShape | null | undefined, nowMs: number): number;
+/** 静默超阈值时的提示文案；不满足条件返回 null。 */
+export declare function silenceNotice(source: RunningActivityShape | RunningRunShape | null | undefined, nowMs: number, thresholdMs?: number): string | null;
+/** 与 formatElapsedShort 不同：面向「已 N 分钟」这类自然语言读数。 */
+export declare function formatMinutes(ms: number): string;
+export declare const PHASE_LABELS: Readonly<Record<RunningPhase, string>>;
+/**
+ * 状态条的完整文案。运行中恒有文字（阶段 + 已运行时长），静默超阈值时追加无新消息提示，
+ * 这样「还在跑」和「已经停了」在界面上一眼可分。
+ */
+export declare function runningStatusText(source: RunningActivityShape | null | undefined, nowMs: number, runMode?: boolean): string;
+/** 团队侧文案：run 级锚点，语义与会话侧一致。 */
+export declare function runStatusText(source: RunningRunShape | null | undefined, nowMs: number): string;

package/dist/web-ui/running-activity.js

@@ -0,0 +1,134 @@
+/**
+ * 「正在执行」的客户端推导：只允许对服务端下发的运行事实与锚点时刻做展示差分。
+ * 锚点（turnStartedAt / lastActivityAt）缺失时一律不显示时长，前端不本地起表伪造运行中。
+ */
+/** 静默起显阈值：超过后从「正在执行」升级为「仍在运行 · 已 N 分钟无新消息」。 */
+export const SILENCE_NOTICE_MS = 60_000;
+const RUNNING_STATUSES = new Set([
+    "running", "thinking", "waiting-input", "waiting_input",
+    // 团队 run 的等待相位仍是「这一轮没结束」，收敛只发生在 done/failed/stopped。
+    "awaiting_approval", "waiting_user",
+]);
+function parseTime(value) {
+    if (!value)
+        return null;
+    const parsed = new Date(value).getTime();
+    return Number.isFinite(parsed) ? parsed : null;
+}
+/** 本轮开始时刻：只取服务端锚点，缺失返回 null（调用方不得回落到本地挂载时刻）。 */
+export function turnStartedAtMs(source) {
+    if (!source)
+        return null;
+    return parseTime(source.structuredState?.turnStartedAt) ?? parseTime(source.turnStartedAt);
+}
+/** 最近一次服务端观测到活动的时刻。 */
+export function lastActivityAtMs(source) {
+    if (!source)
+        return null;
+    const structured = source.structuredState?.lastActivityAt;
+    return parseTime(structured)
+        ?? parseTime(source.lastActivityAt)
+        ?? parseTime(source.lastActivityAt);
+}
+export function isRunningNow(source) {
+    if (!source)
+        return false;
+    if (source.archived)
+        return false;
+    const activity = source;
+    if (activity.permissionBlocked || activity.pendingEscalation)
+        return true;
+    if (activity.structuredState?.inFlight)
+        return true;
+    const status = source.status;
+    return typeof status === "string" && RUNNING_STATUSES.has(status);
+}
+/** 会话侧运行事实：structured 看本轮 inFlight，PTY 看 ptyRunning，两者都不看本地计时。 */
+export function sessionRunning(source) {
+    if (!source || source.archived)
+        return false;
+    return Boolean(source.structuredState?.inFlight) || source.ptyRunning === true;
+}
+/**
+ * 分阶段：等待审批/输入 > 已接收排队 > 正在执行 > 结束。
+ * 非运行中一律 idle，调用方必须据此立即收敛状态条，不留残留。
+ * `runMode` 给团队 run：那里的 status 就是运行事实本身。会话侧不行——裸 shell 的
+ * status 恒为 running，必须走 sessionRunning（structured inFlight / PTY ptyRunning）。
+ */
+export function computeRunningPhase(source, runMode = false) {
+    if (!source)
+        return "idle";
+    // 排队未空 = 服务端还欠这一轮回复，属于「已接收」；不能被会话级 idle 吞掉。
+    if ((source.queuedMessages?.length ?? 0) > 0)
+        return "received";
+    if (!(runMode ? isRunningNow(source) : sessionRunning(source)))
+        return "idle";
+    if (source.permissionBlocked || source.pendingEscalation)
+        return "waiting";
+    return "executing";
+}
+/** 距最近一次活动已静默多久；锚点缺失或不在运行中时为 0。 */
+export function silenceDurationMs(source, nowMs) {
+    if (!isRunningNow(source) && !sessionRunning(source))
+        return 0;
+    const last = lastActivityAtMs(source);
+    if (last === null)
+        return 0;
+    return Math.max(0, nowMs - last);
+}
+/** 静默超阈值时的提示文案；不满足条件返回 null。 */
+export function silenceNotice(source, nowMs, thresholdMs = SILENCE_NOTICE_MS) {
+    const silence = silenceDurationMs(source, nowMs);
+    if (silence < thresholdMs)
+        return null;
+    return `仍在运行 · 已 ${formatMinutes(silence)}无新消息`;
+}
+/** 与 formatElapsedShort 不同：面向「已 N 分钟」这类自然语言读数。 */
+export function formatMinutes(ms) {
+    const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+    if (totalSeconds < 60)
+        return `${totalSeconds} 秒`;
+    const minutes = Math.floor(totalSeconds / 60);
+    if (minutes < 60)
+        return `${minutes} 分钟`;
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return remainingMinutes ? `${hours} 小时 ${remainingMinutes} 分钟` : `${hours} 小时`;
+}
+export const PHASE_LABELS = {
+    received: "已接收",
+    executing: "正在执行",
+    waiting: "等待你的输入",
+    idle: "",
+};
+/**
+ * 状态条的完整文案。运行中恒有文字（阶段 + 已运行时长），静默超阈值时追加无新消息提示，
+ * 这样「还在跑」和「已经停了」在界面上一眼可分。
+ */
+export function runningStatusText(source, nowMs, runMode = false) {
+    const phase = computeRunningPhase(source, runMode);
+    if (phase === "idle")
+        return "";
+    const parts = [PHASE_LABELS[phase]];
+    const started = turnStartedAtMs(source);
+    if (started !== null)
+        parts.push(`已运行 ${formatMinutes(Math.max(0, nowMs - started))}`);
+    const silence = silenceNotice(source, nowMs);
+    if (silence)
+        parts.push(silence);
+    return parts.join(" · ");
+}
+/** 团队侧文案：run 级锚点，语义与会话侧一致。 */
+export function runStatusText(source, nowMs) {
+    if (!isRunningNow(source))
+        return "";
+    const waiting = source?.status === "awaiting_approval" || source?.status === "waiting_user";
+    const parts = [waiting ? PHASE_LABELS.waiting : PHASE_LABELS.executing];
+    const started = parseTime(source?.turnStartedAt) ?? parseTime(source?.startedAt);
+    if (started !== null)
+        parts.push(`已运行 ${formatMinutes(Math.max(0, nowMs - started))}`);
+    const silence = silenceNotice(source, nowMs);
+    if (silence)
+        parts.push(silence);
+    return parts.join(" · ");
+}

package/dist/web-ui/styles.js

@@ -4,17 +4,8 @@ import { fileURLToPath } from "node:url";
 import { EMBEDDED_WEB_ASSETS } from "./embedded-assets.js";
 import { versionWebAsset } from "./asset-version.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// 顺序即层叠顺序：Tailwind/Appica 编译产物在前，手写 styles.css 在后。
-//
-// 两个原因决定这个顺序不能反过来：
-//
-// 1. Tailwind 的 @layer 规则永远输给无层规则，所以 styles.css 里的手写规则
-//    仍然稳压 Utilities 一层（两个文件里 `*` 重置的分工见
-//    src/web-ui/css/appica.css 顶部说明）。这一条与先后无关。
-// 2. Appica 在自己的无层 `:root` 里也声明了一批与 Wand 同名的 token
-//    （--success / --warning / --info / --border-strong / --radius-md /
-//    --shadow-sm …）。无层对无层只能靠先后裁决，styles.css 必须排在后面，
-//    否则 Appica 的中性灰会悄无声息地覆盖掉整套暖色调。
+// Tailwind utilities/preflight precede the retained business CSS. Ant Design/X
+// install their own component styles through the shared provider.
 const CSS_FILES = ["tailwind.css", "styles.css"];
 // 用 mtime+size 做缓存键，磁盘上 CSS 一变（npm run build / 手工 edit dist/）下次请求
 // 就会自动 re-read。否则进程启动时缓存的 CSS 会粘住整个生命周期，UI 改动看不到效果，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@co0ontty/wand",
-  "version": "4.83.1",
+  "version": "4.84.0",
   "description": "A web console for Claude Code, Codex, OpenCode, and other local CLI tools.",
   "type": "module",
   "bin": {
@@ -49,18 +49,22 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.81.0",
+    "@earendil-works/pi-agent-core": "1.0.2",
+    "@earendil-works/pi-ai": "1.0.2",
+    "@earendil-works/pi-coding-agent": "1.0.2",
     "@xterm/addon-serialize": "^0.14.0",
     "@xterm/addon-unicode11": "^0.9.0",
     "@xterm/headless": "^6.0.0",
     "compression": "^1.8.1",
     "express": "^4.21.2",
+    "marked": "^18.0.14",
     "multer": "^2.1.1",
     "neo-blessed": "^0.2.0",
     "node-pty": "^1.1.0",
     "ws": "^8.19.0"
   },
   "devDependencies": {
-    "@appica/ui-react": "^1.1.0",
+    "@ant-design/x": "2.9.0",
     "@tailwindcss/cli": "^4.3.3",
     "@types/compression": "^1.8.1",
     "@types/express": "^4.17.21",
@@ -71,6 +75,7 @@
     "@types/ws": "^8.18.1",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
+    "antd": "6.6.5",
     "esbuild": "^0.28.0",
     "qrcode": "^1.5.4",
     "react": "^19.2.7",