opencode-visual-cache 1.6.2 → 1.7.0-beta.0

package/dist/v2/index.js

@@ -0,0 +1,163 @@
+import { jsx as _jsx } from "@opentui/solid/jsx-runtime";
+/** @jsxImportSource @opentui/solid */
+import { createSignal, createEffect, onMount, onCleanup, untrack } from "solid-js";
+import { createPanelApi } from "./v2-panel-api";
+import { TokenCachePanel } from "../panel/TokenCachePanel";
+import { StatusView } from "./status";
+import { mapTheme } from "./theme";
+import { makeCommands, findOpencodeKeyV2 } from "./commands";
+import { getBalanceProvider } from "../balance-providers";
+import { LANG_META, detectLang } from "../i18n";
+const KV_PREFIX = "cache_panel";
+const BALANCE_POLL_MS = 5 * 60 * 1000; // 5 minutes（对齐 V1）
+const DEBUG_LANG = typeof process !== "undefined" ? process.env?.CACHE_TUI_LANG : undefined;
+const INIT_LANG = DEBUG_LANG !== undefined && LANG_META.some((m) => m.code === DEBUG_LANG)
+    ? DEBUG_LANG
+    : detectLang();
+/** V2 侧创建面板信号（实验：默认值；偏好持久化经 PanelApi.kv → storage.store）。
+ *  返回 PanelSignals + setBalanceState：余额轮询由 PluginRoot 驱动（V1 同构）。 */
+function createPanelSignals() {
+    const [currencySymbol, setCurrencySymbol] = createSignal("$");
+    const [exchangeRate, setExchangeRate] = createSignal(1);
+    const [langCode, setLangCode] = createSignal(INIT_LANG);
+    const [sectionDetail, setSectionDetail] = createSignal(true);
+    const [sectionModel, setSectionModel] = createSignal(true);
+    const [sectionDist, setSectionDist] = createSignal(true);
+    const [sectionSkills, setSectionSkills] = createSignal(true);
+    const [sectionBalance, setSectionBalance] = createSignal(true);
+    const [sectionBottom, setSectionBottom] = createSignal(true);
+    const [balanceRefresh, setBalanceRefresh] = createSignal(0);
+    const [balanceProviderId, setBalanceProviderId] = createSignal("");
+    const [autoBalance, setAutoBalance] = createSignal(true);
+    const [balanceUnsupported, setBalanceUnsupported] = createSignal(false);
+    const [balanceState, setBalanceState] = createSignal({ status: "idle", data: null, lastFetch: 0 });
+    const [balanceCurrency, setBalanceCurrency] = createSignal("");
+    const [borderVisible, setBorderVisible] = createSignal(true);
+    const [overrideSessionId, setOverrideSessionId] = createSignal(undefined);
+    const [sidebarVisible, setSidebarVisible] = createSignal(true);
+    return {
+        currencySymbol, setCurrencySymbol,
+        exchangeRate, setExchangeRate,
+        langCode: langCode, setLangCode: setLangCode,
+        sectionDetail, setSectionDetail,
+        sectionModel, setSectionModel,
+        sectionDist, setSectionDist,
+        sectionSkills, setSectionSkills,
+        sectionBalance, setSectionBalance,
+        sectionBottom, setSectionBottom,
+        balanceRefresh, setBalanceRefresh,
+        balanceProviderId, setBalanceProviderId,
+        autoBalance, setAutoBalance,
+        balanceUnsupported, setBalanceUnsupported,
+        balanceState,
+        setBalanceState,
+        balanceCurrency, setBalanceCurrency,
+        borderVisible, setBorderVisible,
+        overrideSessionId, setOverrideSessionId,
+        sidebarVisible, setSidebarVisible,
+    };
+}
+/** 面板根组件：在组件渲染上下文注册命令 layer（keymap.layer 必须由组件调用），
+ *  再渲染共享 TokenCachePanel；同时驱动余额轮询（对齐 V1 tui() 的 pollBalance）。 */
+function PluginRoot(props) {
+    // 请求序号：防止定时轮询与手动刷新并发时，慢的旧请求覆盖新结果（对齐 V1）
+    let balanceSeq = 0;
+    // 对齐官方内置插件示例（feature-plugins/system/plugins.tsx）：mode 用 global
+    props.context.keymap.layer(() => ({
+        mode: "global",
+        commands: makeCommands(props.context, props.api, props.signals),
+    }));
+    // 语言偏好恢复（对齐 V1 tui() restoreLang：优先用户 /cache-lang 设置，覆盖自动检测）
+    onMount(() => {
+        try {
+            const saved = props.api.kv.get(`${KV_PREFIX}.lang`);
+            if (saved && LANG_META.some((m) => m.code === saved)) {
+                props.signals.setLangCode(saved);
+            }
+        }
+        catch { }
+    });
+    // ── 余额轮询（对齐 V1 tui() pollBalance）：手动 key 优先，缺失时自动复用 OpenCode 已认证 key ──
+    const pollBalance = async () => {
+        const provider = getBalanceProvider(props.signals.balanceProviderId());
+        const key = props.api.kv.get(`${KV_PREFIX}.balance.${provider.id}.key`, "")
+            || findOpencodeKeyV2(props.context, provider);
+        const set = props.signals.setBalanceState;
+        if (props.signals.balanceUnsupported()) {
+            set({ status: "idle", data: null, lastFetch: 0, error: undefined, key: undefined });
+            return;
+        }
+        if (!key) {
+            set({ status: "idle", data: null, lastFetch: 0, error: undefined, key: undefined });
+            return;
+        }
+        const now = Date.now();
+        const prev = props.signals.balanceState();
+        // key 已更换（重新输入）→ 强制重新查询，绕过缓存
+        if (prev.status === "ok" && prev.key === key && now - prev.lastFetch < BALANCE_POLL_MS)
+            return;
+        const seq = ++balanceSeq;
+        set({ ...prev, status: "loading", error: undefined, key });
+        const controller = new AbortController();
+        let timedOut = false;
+        const timer = setTimeout(() => { timedOut = true; controller.abort(); }, 10_000);
+        try {
+            const data = await provider.fetchBalance(key, controller.signal);
+            clearTimeout(timer);
+            if (seq !== balanceSeq)
+                return; // 已被更新的请求取代，丢弃过期结果
+            set({ status: "ok", data, lastFetch: Date.now(), error: undefined, key });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (seq !== balanceSeq)
+                return;
+            const code = timedOut ? "TIMEOUT" : (err instanceof Error ? err.message : "");
+            set({ status: "error", data: null, lastFetch: 0, error: code, key });
+        }
+    };
+    // Re-fetch when the API key is (re)configured via /cache-balance-key。
+    // 注意：pollBalance 内部读写 balanceState 信号，若不做 untrack 包裹，
+    // effect 会追踪 balanceState 的变化并与 setBalanceState 形成无限循环。
+    createEffect(() => {
+        void props.signals.balanceRefresh();
+        untrack(() => { void pollBalance(); });
+    });
+    // 定时轮询（5 分钟）；随插件生命周期清理
+    const balanceTimer = setInterval(pollBalance, BALANCE_POLL_MS);
+    onCleanup(() => clearInterval(balanceTimer));
+    // auto-clear override：用户导航到不同主会话时清除子代理视图（对齐 V1 createSidebarSlot）
+    let lastSlotSid = props.sessionID;
+    createEffect(() => {
+        const sid = props.sessionID;
+        if (sid !== lastSlotSid) {
+            lastSlotSid = sid;
+            if (props.signals.overrideSessionId()) {
+                props.signals.setOverrideSessionId(undefined);
+                void props.api.kv.set(`${KV_PREFIX}.session`, "");
+            }
+        }
+    });
+    return (_jsx(TokenCachePanel, { theme: mapTheme(props.context.theme), api: props.api, sessionId: props.sessionID, signals: props.signals }));
+}
+const mod = {
+    id: "opencode-visual-cache",
+    setup(context) {
+        const api = createPanelApi(context);
+        const signals = createPanelSignals();
+        // 侧边栏完整面板（与 V1 同一组件；命令 layer 在组件内注册）。
+        // prepend：排在宿主官方信息（问候/Context/用量）之前，紧跟会话标题。
+        context.ui.slot({
+            prepend: "sidebar.content",
+            render: (props) => (_jsx(PluginRoot, { context: context, api: api, signals: signals, sessionID: String(props.sessionID ?? "") })),
+        });
+        // 底部状态栏（完整口径与 V1 一致；余额读共享 signals.balanceState）
+        context.ui.slot({
+            append: "prompt.footer.status",
+            render: (props) => (_jsx(StatusView, { context: context, signals: signals, sessionID: String(props.sessionID ?? "") })),
+        });
+        // 偏好持久化（实验：storage.store 用法验证）
+        context.storage.store("opencode-visual-cache.panel", { initial: { collapsed: false } });
+    },
+};
+export default mod;

package/dist/v2/sidebar.d.ts

@@ -0,0 +1,6 @@
+/** @jsxImportSource @opentui/solid */
+import type { Context } from "./types";
+export declare function SidebarView(props: {
+    context: Context;
+    sessionID: string;
+}): import("solid-js").JSX.Element;

package/dist/v2/sidebar.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/solid/jsx-runtime";
+/** @jsxImportSource @opentui/solid */
+import { createMemo, For, Show } from "solid-js";
+import { collectSessionStats, hitRate } from "./data";
+import { fmt, fmtCost, progressBar, visualPadEnd } from "../core";
+const LABEL_GAP = 1;
+const BAR_BRACKETS = 2;
+const BAR_GAP = 1;
+const PCT_FIXED_WIDTH = 5;
+const MIN_PANEL_WIDTH = 20;
+const DEFAULT_PANEL_WIDTH = 26;
+export function SidebarView(props) {
+    const stats = createMemo(() => collectSessionStats(props.context, props.sessionID));
+    const rate = createMemo(() => hitRate(stats()));
+    const theme = props.context.theme;
+    const rateColor = () => {
+        const r = rate();
+        if (r >= 85)
+            return theme.text.feedback.success.default;
+        if (r >= 70)
+            return theme.text.feedback.warning.default;
+        return theme.text.feedback.error.default;
+    };
+    const barWidth = () => Math.max(MIN_PANEL_WIDTH, Math.min(DEFAULT_PANEL_WIDTH, props.context.app.version ? DEFAULT_PANEL_WIDTH : DEFAULT_PANEL_WIDTH)) -
+        LABEL_GAP - BAR_BRACKETS - BAR_GAP - PCT_FIXED_WIDTH - 1;
+    const rows = () => {
+        const s = stats();
+        return [
+            { label: "Hit", value: fmt(s.cacheRead) + " tok", color: rateColor() },
+            { label: "Miss", value: fmt(s.input + s.cacheWrite) + " tok", color: theme.text.default },
+            { label: "Write", value: fmt(s.cacheWrite) + " tok", color: theme.text.subdued },
+            { label: "Out", value: fmt(s.output) + " tok", color: theme.text.subdued },
+        ];
+    };
+    return (_jsx(Show, { when: stats().hasData, children: _jsxs("box", { children: [_jsxs("box", { flexDirection: "row", gap: LABEL_GAP, children: [_jsx("text", { fg: theme.text.default, children: "Cache" }), _jsxs("text", { fg: rateColor(), children: ["[", progressBar(rate(), barWidth()), "]"] }), _jsx("text", { fg: rateColor(), children: rate().toFixed(1) + "%" })] }), _jsx(For, { each: rows(), children: (row) => (_jsxs("box", { flexDirection: "row", gap: LABEL_GAP, children: [_jsx("text", { fg: theme.text.default, children: visualPadEnd(row.label, 5) }), _jsx("text", { fg: row.color, children: row.value })] })) }), _jsx(Show, { when: stats().cost > 0, children: _jsxs("box", { flexDirection: "row", gap: LABEL_GAP, children: [_jsx("text", { fg: theme.text.default, children: "Cost" }), _jsx("text", { fg: theme.text.default, children: fmtCost(stats().cost) })] }) })] }) }));
+}

package/dist/v2/status.d.ts

@@ -0,0 +1,14 @@
+/** @jsxImportSource @opentui/solid */
+import type { Context } from "./types";
+import type { PanelSignals } from "../panel/panel-api";
+/**
+ * 底部状态栏（prompt.footer.status）——对齐 V1 BottomStatusBar 统计段口径：
+ * 单条命中率（最后一条有 token 的 assistant 消息）+ 趋势 + Tokens 总量 + 余额。
+ * 余额读共享 signals.balanceState（PluginRoot 驱动轮询）；provider 不支持余额时隐藏余额段（对齐 V1）。
+ * 颜色经 mapTheme（V1 形状）——与侧边栏命中率颜色同源，保证两处一致。
+ */
+export declare function StatusView(props: {
+    context: Context;
+    signals: PanelSignals;
+    sessionID: string;
+}): import("solid-js").JSX.Element;

package/dist/v2/status.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx } from "@opentui/solid/jsx-runtime";
+/** @jsxImportSource @opentui/solid */
+import { createMemo, For, Show } from "solid-js";
+import { collectLastHitRate } from "./data";
+import { desaturateTo, fmtCompact, formatBalanceText, MAX_SAT, FALLBACK, visualWidth } from "../core";
+import { createT } from "../i18n";
+import { mapTheme } from "./theme";
+/**
+ * 底部状态栏（prompt.footer.status）——对齐 V1 BottomStatusBar 统计段口径：
+ * 单条命中率（最后一条有 token 的 assistant 消息）+ 趋势 + Tokens 总量 + 余额。
+ * 余额读共享 signals.balanceState（PluginRoot 驱动轮询）；provider 不支持余额时隐藏余额段（对齐 V1）。
+ * 颜色经 mapTheme（V1 形状）——与侧边栏命中率颜色同源，保证两处一致。
+ */
+export function StatusView(props) {
+    const t = createT(() => props.signals.langCode());
+    // 与侧边栏 TokenCachePanel 同一颜色来源（mapTheme → desaturateTo）
+    const pal = createMemo(() => {
+        const th = mapTheme(props.context.theme);
+        const sat = (k, fb) => desaturateTo(th[k], MAX_SAT, fb);
+        return {
+            text: sat("text", FALLBACK.text),
+            muted: sat("textMuted", FALLBACK.muted),
+            success: sat("success", FALLBACK.success),
+            warning: sat("warning", FALLBACK.warning),
+            error: sat("error", FALLBACK.error),
+        };
+    });
+    const stats = createMemo(() => collectLastHitRate(props.context, props.sessionID));
+    const hitColor = createMemo(() => {
+        const r = stats().hitRate;
+        if (r >= 85)
+            return pal().success;
+        if (r >= 70)
+            return pal().warning;
+        return pal().error;
+    });
+    // 命中率趋势：最后一条与上一条的差值；|Δ| < 0.05 视为无变化（null = 不显示）
+    const trend = createMemo(() => {
+        const s = stats();
+        if (s.prevHitRate < 0 || s.hitRate < 0)
+            return null;
+        const d = s.hitRate - s.prevHitRate;
+        return Math.abs(d) < 0.05 ? null : d;
+    });
+    // 余额文本（对齐 V1）：ok → 数值；loading → …；error → ⚠；idle → -
+    const balanceText = createMemo(() => {
+        const s = props.signals.balanceState();
+        if (s.status === "ok" && s.data)
+            return formatBalanceText(s.data, props.signals.balanceCurrency(), props.signals.exchangeRate());
+        if (s.status === "loading")
+            return "\u2026";
+        if (s.status === "error")
+            return "\u26a0";
+        return "-";
+    });
+    const segs = createMemo(() => {
+        const s = stats();
+        const hr = s.hitRate >= 0 ? (Math.floor(s.hitRate * 10) / 10).toFixed(1) + "%" : "--";
+        const out = [
+            { text: t("barHit") + " ", color: pal().muted },
+            { text: hr, color: hitColor() },
+        ];
+        const tr = trend();
+        if (tr !== null) {
+            out.push({ text: " " + (tr > 0 ? "\u2191" : "\u2193") + Math.abs(tr).toFixed(1) + "%", color: tr > 0 ? pal().success : pal().error });
+        }
+        out.push({ text: " \u00b7 " + t("barTok") + " ", color: pal().muted });
+        out.push({ text: s ? fmtCompact(s.input + s.read + s.write) : "--", color: pal().text });
+        if (!props.signals.balanceUnsupported()) {
+            out.push({ text: " \u00b7 " + t("barBal") + " ", color: pal().muted });
+            out.push({ text: balanceText(), color: pal().text });
+        }
+        out.push({ text: " \u00b7 ", color: pal().muted });
+        return out;
+    });
+    const segsW = createMemo(() => {
+        let w = 0;
+        for (const sg of segs())
+            w += visualWidth(sg.text);
+        return w;
+    });
+    return (_jsx(Show, { when: segsW() > 0, children: _jsx("text", { children: _jsx(For, { each: segs(), children: (sg) => _jsx("span", { style: { fg: sg.color }, children: sg.text }) }) }) }));
+}

package/dist/v2/theme.d.ts

@@ -0,0 +1,8 @@
+import type { TuiThemeCurrent } from "@opencode-ai/plugin/tui";
+import type { Context } from "./types";
+/** V2 theme → V1 形状映射（组件按 primary/text/textMuted/… 字段消费）。
+ *  侧边栏与底部栏共用——保证命中率颜色等两处一致。
+ *  - V1 primary → V2 interactive（v1-migrate.ts 官方映射：interactive = hues.byToken.primary）
+ *  - step 取 300：更亮（对齐 V2 暗色强调惯例的亮端），500/400 在暗背景下偏深
+ */
+export declare function mapTheme(theme: Context["theme"]): TuiThemeCurrent;

package/dist/v2/theme.js

@@ -0,0 +1,16 @@
+/** V2 theme → V1 形状映射（组件按 primary/text/textMuted/… 字段消费）。
+ *  侧边栏与底部栏共用——保证命中率颜色等两处一致。
+ *  - V1 primary → V2 interactive（v1-migrate.ts 官方映射：interactive = hues.byToken.primary）
+ *  - step 取 300：更亮（对齐 V2 暗色强调惯例的亮端），500/400 在暗背景下偏深
+ */
+export function mapTheme(theme) {
+    return {
+        primary: theme.hue.interactive[300],
+        text: theme.text.default,
+        textMuted: theme.text.subdued,
+        success: theme.text.feedback.success.default,
+        warning: theme.text.feedback.warning.default,
+        error: theme.text.feedback.error.default,
+        border: theme.text.subdued,
+    };
+}

package/dist/v2/types.d.ts

@@ -0,0 +1,219 @@
+/**
+ * V2 (opencode2) TUI plugin API — 最小本地类型（实验版）。
+ * 运行时由 opencode2 提供，此处仅用于本地类型检查；
+ * 结构对应 v2 分支 packages/plugin/src/tui/context.ts。
+ */
+export interface App {
+    readonly version: string;
+    readonly channel: string;
+}
+export interface Theme {
+    readonly hue: {
+        /** V1 primary 的 V2 等价（v1-migrate.ts：interactive = hues.byToken.primary）。
+         *  取 300：更亮（暗背景下 400/500 偏深）。 */
+        readonly interactive: {
+            readonly 300: string;
+        };
+        /** 主题强调色别名。 */
+        readonly accent: {
+            readonly 500: string;
+        };
+    };
+    readonly text: {
+        readonly default: string;
+        readonly subdued: string;
+        readonly feedback: {
+            readonly success: {
+                readonly default: string;
+            };
+            readonly error: {
+                readonly default: string;
+            };
+            readonly warning: {
+                readonly default: string;
+            };
+        };
+    };
+}
+/** token 用量：结构与 V1 的 message.tokens 同构，字段以运行时实际数据为准。 */
+export interface TokenUsage {
+    input?: number;
+    output?: number;
+    reasoning?: number;
+    cache?: {
+        read?: number;
+        write?: number;
+    };
+}
+export interface MessageInfo {
+    readonly id: string;
+    readonly type: string;
+    readonly agent?: string;
+    readonly model?: string;
+    readonly time: {
+        readonly created: number;
+        readonly completed?: number;
+    };
+    readonly cost?: unknown;
+    readonly tokens?: TokenUsage;
+    readonly content?: unknown[];
+}
+export interface SessionInfo {
+    readonly id: string;
+    readonly title?: string;
+    readonly time?: {
+        readonly created: number;
+        readonly updated: number;
+    };
+    readonly model?: string;
+    readonly agent?: string;
+    readonly parentID?: string;
+}
+export interface Data {
+    readonly session: {
+        get(sessionID: string): SessionInfo | undefined;
+        list(): SessionInfo[];
+        cost(sessionID: string): number;
+        status(sessionID: string): string;
+        readonly message: {
+            list(sessionID: string): MessageInfo[];
+            sync(sessionID: string): Promise<void>;
+        };
+    };
+    readonly location: {
+        readonly provider: {
+            list(location?: unknown): unknown[];
+        };
+        readonly model: {
+            list(location?: unknown): unknown[];
+        };
+        readonly mcp: {
+            readonly server: {
+                list(location?: unknown): unknown[];
+            };
+        };
+    };
+    readonly on: (type: string, handler: (event: unknown) => void) => () => void;
+    readonly listen: (handler: (event: unknown) => void) => () => void;
+}
+export interface Storage {
+    store<Value extends object>(key: string, options: {
+        readonly initial: Value;
+    }): readonly [Value, (mutation: (draft: Value) => void) => Promise<void>];
+    memory<Value extends object>(key: string, options: {
+        readonly initial: Value;
+    }): readonly [Value, (mutation: (draft: Value) => void) => void];
+}
+export type SlotClaim = {
+    readonly render: (input: Record<string, any>) => unknown;
+} & ({
+    readonly append: string;
+    readonly prepend?: never;
+    readonly before?: never;
+    readonly after?: never;
+    readonly replace?: never;
+} | {
+    readonly prepend: string;
+    readonly append?: never;
+    readonly before?: never;
+    readonly after?: never;
+    readonly replace?: never;
+} | {
+    readonly before: string;
+    readonly append?: never;
+    readonly prepend?: never;
+    readonly after?: never;
+    readonly replace?: never;
+} | {
+    readonly after: string;
+    readonly append?: never;
+    readonly prepend?: never;
+    readonly before?: never;
+    readonly replace?: never;
+} | {
+    readonly replace: string;
+    readonly append?: never;
+    readonly prepend?: never;
+    readonly before?: never;
+    readonly after?: never;
+});
+export interface KeymapCommand {
+    readonly id?: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly group?: string;
+    readonly palette?: true;
+    readonly slash?: {
+        readonly name: string;
+        readonly aliases?: string[];
+        readonly arguments?: true;
+    };
+    /** 旧字段（opencode-dcp 兼容写法：palette 可见性 + slash 补全依赖它们） */
+    readonly namespace?: string;
+    readonly name?: string;
+    readonly desc?: string;
+    readonly category?: string;
+    readonly slashName?: string;
+    readonly slashAliases?: string[];
+    readonly run: (input?: string) => void | false | Promise<void>;
+}
+export interface Context {
+    readonly app: App;
+    readonly options: Record<string, any>;
+    readonly location: {
+        readonly directory?: string;
+    } | undefined;
+    readonly renderer: {
+        readonly terminalWidth: number;
+    };
+    readonly theme: Theme;
+    readonly data: Data;
+    readonly storage: Storage;
+    readonly ui: {
+        slot(claim: SlotClaim): () => void;
+        readonly toast: {
+            show(options: {
+                readonly message: string;
+                readonly title?: string;
+                readonly variant?: string;
+            }): void;
+        };
+        readonly dialog: {
+            prompt(options: {
+                readonly title: string;
+                readonly message?: string;
+                readonly placeholder?: string;
+            }): Promise<string | undefined>;
+            select<Value>(options: {
+                readonly title: string;
+                readonly placeholder?: string;
+                readonly options: readonly {
+                    readonly title: string;
+                    readonly value: Value;
+                    readonly description?: string;
+                    readonly category?: string;
+                    readonly disabled?: boolean;
+                }[];
+                readonly current?: Value;
+            }): Promise<Value | undefined>;
+        };
+        /** 当前路由：命令需要当前会话 ID（V2 Route = { type: "session", sessionID }）。 */
+        readonly router: {
+            current(): {
+                readonly type?: string;
+                readonly sessionID?: string;
+                readonly params?: Record<string, unknown>;
+            };
+        };
+    };
+    readonly keymap: {
+        layer(input: () => {
+            readonly commands?: readonly KeymapCommand[];
+        }): void;
+        shortcuts(id: string): readonly string[];
+    };
+}
+export type PluginModule = {
+    readonly id: string;
+    readonly setup: (context: Context) => void | (() => void | Promise<void>) | Promise<void | (() => void | Promise<void>)>;
+};

package/dist/v2/types.js

@@ -0,0 +1,6 @@
+/**
+ * V2 (opencode2) TUI plugin API — 最小本地类型（实验版）。
+ * 运行时由 opencode2 提供，此处仅用于本地类型检查；
+ * 结构对应 v2 分支 packages/plugin/src/tui/context.ts。
+ */
+export {};

package/dist/v2/v2-panel-api.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from "./types";
+import type { PanelApi } from "../panel/panel-api";
+/**
+ * V2 (opencode2) context → PanelApi 适配实现。
+ * 核心能力（session/messages/tokens/storage/event/renderer/part）完整映射；
+ * 无 V2 对应的能力（config）以空值兜底。
+ */
+export declare function createPanelApi(context: Context): PanelApi;