@deepseek-harness-tui/dsh-tui 0.11.2 → 0.13.0

package/{node_modules/@deepseek-harness-tui/dsh-auth/lib → lib/types/dsh-adapter/oauth}/service.js

@@ -1,16 +1,19 @@
 /**
- * The `ctx.dshAuth` service: the programmatic surface over this plugin's
+ * The `ctx.dshAuth` service: the programmatic surface over this module's
  * mounted OAuth routes. UIs (the dsh-tui /provider wizard, a web settings
  * page) enumerate providers with masked sign-in state and drive login/logout
  * without touching the credential file or the pi-ai flow objects; the `/auth`
  * command in `command.ts` is a thin textual veneer over the same api.
  *
- * @module dsh-auth/service
+ * @module @deepseek-harness-tui/dsh-tui/oauth/service
  */
 import { Service } from '@deepseek-ai/cordis';
 import { asStoredCredential } from './credentials.js';
 import { oauthOf } from './profiles.js';
 import { QuestionBridge } from './interaction.js';
+import { loginOAuth } from './pi-ai.js';
+import { DEEPSEEK_ACCOUNT_PROVIDER, deepSeekClientMetadata, loginDeepSeekAccount, } from './deepseek.js';
+import { WhaleCouponStore } from './bonus.js';
 /**
  * The constructed catalog provider one mounted route carries. 0.1.5 made
  * `ResolvedPiAiProviderProfile.piProvider` optional (a stored route that
@@ -27,6 +30,7 @@ function mountedProvider(profile) {
 /** Cordis service holder; `api` is set by the plugin's apply. */
 export class DshAuthService extends Service {
     api;
+    coupons = new WhaleCouponStore();
     constructor(ctx) {
         super(ctx, 'dshAuth');
     }
@@ -56,9 +60,13 @@ async function chooseProvider(ask, candidates, signal) {
  */
 export function createDshAuthApi(deps) {
     const inflight = new Map();
+    const mountedIds = () => [
+        ...deps.profiles.keys(),
+        ...(deps.resolveDeepSeekAccount?.() === undefined ? [] : [DEEPSEEK_ACCOUNT_PROVIDER]),
+    ];
     const statusOf = async () => {
         const described = new Map((await deps.store.describe()).map(row => [row.provider, row]));
-        return [...deps.profiles.entries()].map(([id, profile]) => {
+        const piAi = [...deps.profiles.entries()].map(([id, profile]) => {
             const oauth = oauthOf(mountedProvider(profile));
             const row = described.get(id);
             return {
@@ -71,32 +79,55 @@ export function createDshAuthApi(deps) {
                 expired: row?.expired ?? false,
             };
         });
+        const account = deps.resolveDeepSeekAccount?.();
+        if (account === undefined)
+            return piAi;
+        const state = await account.getState();
+        return [{
+                provider: DEEPSEEK_ACCOUNT_PROVIDER,
+                label: 'DeepSeek Account',
+                oauthLabel: 'DeepSeek',
+                loginLabel: 'Sign in with DeepSeek',
+                signedIn: state.status === 'credential-stored',
+                expiresAt: undefined,
+                expired: false,
+            }, ...piAi];
     };
     const loginOne = async (provider, ask, signal) => {
         const profile = deps.profiles.get(provider);
         if (profile === undefined) {
-            throw new Error(`dsh-auth: unknown provider "${provider}" (mounted: ${[...deps.profiles.keys()].join(', ')})`);
+            throw new Error(`dsh-auth: unknown provider "${provider}" (mounted: ${mountedIds().join(', ')})`);
         }
         const oauth = oauthOf(mountedProvider(profile));
         const runAbort = new AbortController();
+        const forwardAbort = () => runAbort.abort(signal?.reason);
         if (signal !== undefined) {
             if (signal.aborted)
-                runAbort.abort(signal.reason);
+                forwardAbort();
             else
-                signal.addEventListener('abort', () => runAbort.abort(signal.reason), { once: true });
+                signal.addEventListener('abort', forwardAbort, { once: true });
         }
         const bridge = new QuestionBridge(ask, runAbort);
         try {
-            const returned = await oauth.login(bridge);
+            runAbort.signal.throwIfAborted();
+            const returned = await loginOAuth(oauth, bridge, {
+                // pi-ai 0.87.1's `openai` flow needs this on login. Older flows
+                // ignore the optional context, so the ID is created only on demand.
+                getDeviceId: () => deps.store.getOrCreateDeviceId(),
+            });
             const normalized = asStoredCredential(returned);
             if (normalized === undefined) {
                 throw new Error(`dsh-auth: the ${oauth.name} flow returned an unusable credential; nothing was stored`);
             }
-            const stored = normalized;
-            await deps.store.modify(provider, async () => stored);
-            return { provider, oauthLabel: oauth.name, expiresAt: stored.expires };
+            await deps.store.modify(provider, async () => {
+                // Logout may have cancelled the flow while this write waited for the file lock.
+                runAbort.signal.throwIfAborted();
+                return normalized;
+            });
+            return { provider, oauthLabel: oauth.name, expiresAt: normalized.expires };
         }
         finally {
+            signal?.removeEventListener('abort', forwardAbort);
             await bridge.settle();
         }
     };
@@ -115,24 +146,58 @@ export function createDshAuthApi(deps) {
                     throw new Error('dsh-auth: every mounted provider is already signed in');
                 target = await chooseProvider(ask, candidates, signal);
             }
-            else if (!deps.profiles.has(target)) {
-                throw new Error(`dsh-auth: unknown provider "${target}" (mounted: ${[...deps.profiles.keys()].join(', ')})`);
+            else if (!mountedIds().includes(target)) {
+                throw new Error(`dsh-auth: unknown provider "${target}" (mounted: ${mountedIds().join(', ')})`);
             }
             if (ask === undefined) {
                 throw new Error(`dsh-auth: signing in to "${target}" needs an interactive surface (run inside dsh-tui or the web client); `
                     + 'this plugin refuses to assume a browser on this machine');
             }
-            const existing = inflight.get(target);
-            if (existing !== undefined) {
+            if (inflight.has(target)) {
                 throw new Error(`dsh-auth: a login for "${target}" is already running`);
             }
-            const run = loginOne(target, ask, signal).finally(() => { inflight.delete(target); });
-            inflight.set(target, run);
+            const account = target === DEEPSEEK_ACCOUNT_PROVIDER ? deps.resolveDeepSeekAccount?.() : undefined;
+            if (target === DEEPSEEK_ACCOUNT_PROVIDER && account === undefined) {
+                throw new Error(`dsh-auth: provider "${target}" is no longer mounted`);
+            }
+            const cancellation = new AbortController();
+            const runSignal = signal === undefined ? cancellation.signal : AbortSignal.any([signal, cancellation.signal]);
+            inflight.set(target, cancellation);
+            const run = (account === undefined
+                ? loginOne(target, ask, runSignal)
+                : (async () => {
+                    runSignal.throwIfAborted();
+                    const callbackOrigin = await deps.resolveCallbackOrigin?.();
+                    runSignal.throwIfAborted();
+                    if (callbackOrigin === undefined) {
+                        throw new Error('DeepSeek sign-in needs an active Host webServer for the browser callback');
+                    }
+                    await loginDeepSeekAccount(account, callbackOrigin, ask, runSignal);
+                    deps.coupons?.clear();
+                    const getUnnotifiedBonuses = account.getUnnotifiedBonuses?.bind(account);
+                    const ackBonusNotified = account.ackBonusNotified?.bind(account);
+                    if (getUnnotifiedBonuses !== undefined && ackBonusNotified !== undefined) {
+                        void deps.coupons?.refresh({ getUnnotifiedBonuses, ackBonusNotified });
+                    }
+                    return { provider: target, oauthLabel: 'DeepSeek', expiresAt: undefined };
+                })()).finally(() => { inflight.delete(target); });
             return run;
         },
         logout: async (provider) => {
+            // A DeepSeek login may still be awaiting its callback listener, before
+            // the Host has an attempt to cancel. Abort it before Host sign-out.
+            inflight.get(provider)?.abort(new Error('Login cancelled'));
+            if (provider === DEEPSEEK_ACCOUNT_PROVIDER) {
+                const account = deps.resolveDeepSeekAccount?.();
+                if (account !== undefined) {
+                    const existed = (await account.getState()).status === 'credential-stored';
+                    await account.signOut(deepSeekClientMetadata());
+                    deps.coupons?.clear();
+                    return existed;
+                }
+            }
             if (!deps.profiles.has(provider)) {
-                throw new Error(`dsh-auth: unknown provider "${provider}" (mounted: ${[...deps.profiles.keys()].join(', ')})`);
+                throw new Error(`dsh-auth: unknown provider "${provider}" (mounted: ${mountedIds().join(', ')})`);
             }
             const existed = (await deps.store.read(provider)) !== undefined;
             await deps.store.delete(provider);

package/lib/types/dsh-adapter/panel-runtime-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Host-side per-panel owner registry for ctx.tuiPanels (§18.2).
+ *
+ * The PanelStore owns registration/badges; THIS map owns what only the
+ * Cordis side knows: which activation registered a panel id, its plugin id,
+ * and the lazy bridges the rendered panel's host API needs (toast, scenes,
+ * plugin storage). Kept module-level next to the process-level PanelStore —
+ * a WeakMap on the service would die with the service object while the
+ * PanelStore (and rendered panels) outlive it.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { TuiPluginStorage } from './plugin-storage.js';
+export interface PanelOwnerRecord {
+    /** Canonical activation context (kept alive by the bound effect; the panel
+     * is unregistered before the activation tears down, so late host-API calls
+     * through a disposed ctx degrade, never crash the store). */
+    readonly caller: Context;
+    /** activationFiber identity — ownership check for every mutating call. */
+    readonly owner: object;
+    readonly pluginId: string;
+    /** open() rate limit: at most one open per plugin per 5s (§18.2). */
+    lastOpenAt: number;
+    storage?: TuiPluginStorage;
+}
+export declare function getPanelOwnerRecord(id: string): PanelOwnerRecord | undefined;
+export declare function setPanelOwnerRecord(id: string, record: PanelOwnerRecord): void;
+export declare function deletePanelOwnerRecord(id: string): void;
+export declare function countPanelsOwnedBy(owner: object): number;
+export declare function countPluginPanels(): number;
+/** Plugin Panel 的 toast：经注册激活自己的 tuiToast 服务（无服务时静默
+ * false，与 scenes 降级语义一致）。 */
+export declare function pluginPanelToast(id: string, text: string): boolean;
+/** 打开自己注册的全屏场景：转 tuiScenes（它自己做 owner 校验与降级）。 */
+export declare function pluginPanelOpenScene(id: string, sceneId: string): boolean;
+/** 自己的 tuiPluginStorage 句柄（懒开、每 Panel 一次；无服务时 undefined）。 */
+export declare function pluginPanelStorage(id: string): TuiPluginStorage | undefined;
+/** 侧栏展开且自己是 active 时聚焦（useSidePanel 侧裁决）。 */
+export declare function pluginPanelFocus(id: string): boolean;
+//# sourceMappingURL=panel-runtime-registry.d.ts.map

package/lib/types/dsh-adapter/panel-runtime-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-runtime-registry.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/panel-runtime-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG3D,MAAM,WAAW,gBAAgB;IAC/B;;iEAE6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAID,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE9E;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;6BAC6B;AAC7B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUzE;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAc3E;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/lib/types/dsh-adapter/panel-runtime-registry.js

@@ -0,0 +1,84 @@
+/**
+ * Host-side per-panel owner registry for ctx.tuiPanels (§18.2).
+ *
+ * The PanelStore owns registration/badges; THIS map owns what only the
+ * Cordis side knows: which activation registered a panel id, its plugin id,
+ * and the lazy bridges the rendered panel's host API needs (toast, scenes,
+ * plugin storage). Kept module-level next to the process-level PanelStore —
+ * a WeakMap on the service would die with the service object while the
+ * PanelStore (and rendered panels) outlive it.
+ */
+import { panelBridgeRequests } from '../components/sidePanel/panelBridge.js';
+const ownerRecords = new Map();
+export function getPanelOwnerRecord(id) {
+    return ownerRecords.get(id);
+}
+export function setPanelOwnerRecord(id, record) {
+    ownerRecords.set(id, record);
+}
+export function deletePanelOwnerRecord(id) {
+    ownerRecords.delete(id);
+}
+export function countPanelsOwnedBy(owner) {
+    let count = 0;
+    for (const record of ownerRecords.values())
+        if (record.owner === owner)
+            count += 1;
+    return count;
+}
+export function countPluginPanels() {
+    return ownerRecords.size;
+}
+/** Plugin Panel 的 toast：经注册激活自己的 tuiToast 服务（无服务时静默
+ * false，与 scenes 降级语义一致）。 */
+export function pluginPanelToast(id, text) {
+    const record = ownerRecords.get(id);
+    if (record === undefined)
+        return false;
+    const toast = record.caller.get('tuiToast');
+    if (toast === undefined || typeof toast.show !== 'function')
+        return false;
+    try {
+        return toast.show(text);
+    }
+    catch {
+        return false;
+    }
+}
+/** 打开自己注册的全屏场景：转 tuiScenes（它自己做 owner 校验与降级）。 */
+export function pluginPanelOpenScene(id, sceneId) {
+    const record = ownerRecords.get(id);
+    if (record === undefined)
+        return false;
+    const scenes = record.caller.get('tuiScenes');
+    if (scenes === undefined || typeof scenes.open !== 'function')
+        return false;
+    try {
+        return scenes.open(sceneId);
+    }
+    catch {
+        return false;
+    }
+}
+/** 自己的 tuiPluginStorage 句柄（懒开、每 Panel 一次；无服务时 undefined）。 */
+export function pluginPanelStorage(id) {
+    const record = ownerRecords.get(id);
+    if (record === undefined)
+        return undefined;
+    if (record.storage !== undefined)
+        return record.storage;
+    const service = record.caller.get('tuiPluginStorage');
+    if (service === undefined || typeof service.open !== 'function')
+        return undefined;
+    try {
+        record.storage = service.open(record.caller);
+        return record.storage;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 侧栏展开且自己是 active 时聚焦（useSidePanel 侧裁决）。 */
+export function pluginPanelFocus(id) {
+    return panelBridgeRequests.request('focus', id);
+}

package/lib/types/dsh-adapter/panels.d.ts

@@ -0,0 +1,251 @@
+/**
+ * ctx.tuiPanels — 插件侧栏 Panel 服务（设计文档 §8/§18，v2.1 修订，Phase 6）。
+ *
+ * 与 tuiStatus/tuiScenes 同一接缝家族：一份 Cordis-free 的进程级 store
+ * （components/sidePanel/PanelStore，注册/badge/错误隔离）+ 一层薄的
+ * Cordis 服务做准入（requirePluginCaller → activationFiber owner →
+ * bindCallerEffect 撤下 → 能力 shadow policy → 重复 id
+ * DUPLICATE_CONTRIBUTION_ID → Object.freeze descriptor）。
+ *
+ * 本阶段范围（§18.2 简化版）：
+ * - register：宿主自动加 '<pluginId>:' 前缀；mountPolicy 强制 'active'；
+ *   minColumns 默认 28；预算 = 每插件 ≤4 个 / 全局 ≤32 个。
+ * - list：只读摘要（id/title/source，不含组件）。
+ * - open/close：仅自己注册的 id；open 为 mutate 且限速（每插件每 5s 至多
+ *   1 次，超过丢弃并记 ledger）；UI 触达经 panelBridge（useSidePanel 订阅）。
+ * - badge：仅自己注册的 id → panelStore.setBadge。
+ * - subscribe：仅涉及自己 Panel 的事件（本阶段 registered/unregistered/
+ *   badge/error/disabled；opened/closed/focused/blurred/sidebar-toggled 事件
+ *   源在 useSidePanel 侧，留 TODO）。
+ * - compact：descriptor 校验 + 存档，渲染槽不挂载（TODO §18.1）。
+ */
+import type React from 'react';
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { TuiPluginStorage } from './plugin-storage.js';
+/** 插件 Panel API 版本（§18.2）：descriptor.apiVersion 必须精确匹配。 */
+export declare const TUI_PANEL_API_VERSION = 1;
+/** 每插件 Panel 预算（§18.4）。 */
+export declare const MAX_PANELS_PER_PLUGIN = 4;
+/** 全局插件 Panel 注册预算（§18.4）。 */
+export declare const MAX_PLUGIN_PANELS_TOTAL = 32;
+/** open() 限速窗口：每插件每窗口至多 1 次。 */
+export declare const PANEL_OPEN_RATE_LIMIT_MS = 5000;
+type TuiPanelForbiddenBoxProps = 'ref' | 'tabIndex' | 'autoFocus' | 'onContextMenu' | 'onFocus' | 'onFocusCapture' | 'onBlur' | 'onBlurCapture' | 'onKeyDown' | 'onKeyDownCapture';
+/** Box 保留 click/hover/drag/onWheel；焦点/键盘/上下文菜单被收走。 */
+export type TuiPanelBoxProps = Omit<React.ComponentProps<typeof import('../ui.js').Box>, TuiPanelForbiddenBoxProps>;
+export type TuiPanelTextProps = Omit<React.ComponentProps<typeof import('../ui.js').Text>, 'ref'>;
+/** Image 走既有图片预算/协议回退路径（与 status view 的 Image 同一通道）。 */
+export type TuiPanelImageProps = React.ComponentProps<typeof import('../ui.js').Image>;
+export type TuiPanelScrollBoxProps = Omit<React.ComponentProps<typeof import('../ui.js').ScrollBox>, 'ref'>;
+export type TuiPanelDividerProps = React.ComponentProps<typeof import('../components/design-system/Divider.js').Divider>;
+/**
+ * 面板内 UI kit：宿主 React + 收窄组件 + Panel 尺寸感知。钩子和元素
+ * 必须走宿主 React（与 plugin scene 同一 single-React 规则）。
+ */
+export interface TuiPanelUi {
+    readonly Box: React.ComponentType<TuiPanelBoxProps>;
+    readonly Text: React.ComponentType<TuiPanelTextProps>;
+    readonly Image: React.ComponentType<TuiPanelImageProps>;
+    readonly ScrollBox: React.ComponentType<TuiPanelScrollBoxProps>;
+    readonly Divider: React.ComponentType<TuiPanelDividerProps>;
+    /** 恒等于 Panel 的 { width, height }。 */
+    readonly useTerminalSize: () => {
+        readonly columns: number;
+        readonly rows: number;
+    };
+    /**
+     * 面板内唯一合法定时源：内部是 useAnimationFrame(ms) 的时间值（[1]）。
+     * 不暴露 hook 本体是因为其另一个返回值是必须挂到动画元素上的 ref——
+     * 插件乱挂会破坏共享时钟的可见性测度；时间值本身已覆盖面板动画的
+     * 全部需求（传 null 暂停）。
+     */
+    readonly useAnimationTime: (intervalMs: number | null) => number;
+    /** 只读主题。 */
+    readonly useTheme: typeof import('../ui.js').useTheme;
+}
+export type TuiPanelBadgeLevel = 'info' | 'warning' | 'error';
+export type TuiPanelMode = 'split' | 'zoom' | 'fullscreen';
+/** v2.1 键盘契约的插件视图：preventDefault() = 阻止宿主回退键。 */
+export interface TuiPanelKeyEvent {
+    readonly input: string;
+    readonly key: import('../components/sidePanel/types.js').SidePanelKeyFlags;
+    preventDefault(): void;
+}
+/** 策展只读会话快照：SidePanelRuntimeContext 的结构拷贝，不含转录
+ * 正文/凭证/文件内容（§18.2）。 */
+export interface TuiPanelSnapshot {
+    readonly sessionId: string;
+    readonly cwd: string;
+    readonly lang: string;
+    readonly working: boolean;
+    readonly spinnerMode: string;
+    readonly version: number;
+    readonly goal: Readonly<{
+        readonly objective: string;
+        readonly phase: 'active' | 'paused' | 'blocked' | 'complete';
+        readonly roundsStarted: number;
+        readonly maxGoalRounds: number;
+    }> | undefined;
+    readonly todos: readonly Readonly<{
+        readonly content: string;
+        readonly status: string;
+    }>[];
+    readonly backgroundJobs: readonly Readonly<{
+        readonly id: string;
+        readonly kind: string;
+        readonly label: string;
+        readonly status: string;
+        readonly progress?: string;
+        readonly detail?: string;
+        readonly startedAt: number;
+    }>[];
+    readonly subagents: readonly Readonly<{
+        readonly agentId: string;
+        readonly description: string;
+        readonly status: string;
+        readonly mode?: string;
+        readonly model?: string;
+        readonly startedAt: number;
+        readonly completedAt?: number;
+    }>[];
+    readonly attention: Readonly<{
+        readonly approvals: number;
+        readonly questions: number;
+    }>;
+    readonly activity: Readonly<Record<string, unknown>> | undefined;
+}
+/** 面板内 host API（§18.2；sendToChat 本阶段恒 false——授权未落地）。 */
+export interface TuiPanelHostApi {
+    /** 策展只读快照（每次调用结构拷贝）。 */
+    snapshot(): TuiPanelSnapshot;
+    readonly focused: boolean;
+    notify(level: TuiPanelBadgeLevel, unread?: number): void;
+    clearBadge(): void;
+    /** 本阶段返回 false 并 toast 一次：需要 panels.chat.attach 授权（后续版本）。 */
+    sendToChat(payload: {
+        readonly title: string;
+        readonly content: string;
+    }): boolean;
+    /** 仅打开自己注册的全屏场景（tuiScenes 做 owner 校验）。 */
+    openScene(id: string): boolean;
+    toast(text: string): boolean;
+    /** 自己的 tuiPluginStorage 句柄（服务未挂时 undefined）。 */
+    readonly storage: TuiPluginStorage | undefined;
+    /** 仅 focused 期间投递（v2.1 分发器）。 */
+    onKey(listener: (event: TuiPanelKeyEvent) => void): () => void;
+    /** 侧栏展开且自己 active 时聚焦（useSidePanel 侧裁决）。 */
+    focus(): boolean;
+}
+/** 插件 Panel 组件 props。 */
+export interface TuiPanelProps {
+    /** 宿主 React——所有钩子与元素必须经它（single-React 规则）。 */
+    readonly React: typeof React;
+    readonly ui: TuiPanelUi;
+    readonly host: TuiPanelHostApi;
+    readonly width: number;
+    readonly height: number;
+    readonly focused: boolean;
+    readonly visible: boolean;
+    readonly mode: TuiPanelMode;
+}
+/** compact 行 props（本阶段仅校验，不挂载渲染——槽位 TODO §18.1）。 */
+export interface TuiPanelCompactProps {
+    readonly React: typeof React;
+    readonly ui: Pick<TuiPanelUi, 'Box' | 'Text'>;
+    readonly width: number;
+    readonly badge: {
+        readonly level: TuiPanelBadgeLevel;
+        readonly unread: number;
+    } | null;
+}
+/** 注册 descriptor（§18.2）。 */
+export interface TuiPanelDescriptor {
+    readonly apiVersion: typeof TUI_PANEL_API_VERSION;
+    /** 单段小写 slug；宿主自动加 '<pluginId>:' 前缀。 */
+    readonly id: string;
+    readonly title: string;
+    /** 显示宽度必须为 1。 */
+    readonly icon?: string;
+    readonly minColumns?: number;
+    readonly order?: number;
+    readonly component?: React.ComponentType<TuiPanelProps>;
+    readonly compact?: {
+        readonly maxRows: 1 | 2 | 3;
+        readonly component: React.ComponentType<TuiPanelCompactProps>;
+    };
+}
+/** subscribe 的事件（本阶段：注册/撤下/badge/错误/禁用；opened/closed/
+ * focused/blurred/sidebar-toggled 的事件源在 useSidePanel 侧，留 TODO）。 */
+export type TuiPanelEvent = {
+    readonly type: 'registered';
+    readonly id: string;
+} | {
+    readonly type: 'unregistered';
+    readonly id: string;
+} | {
+    readonly type: 'badge';
+    readonly id: string;
+} | {
+    readonly type: 'error';
+    readonly id: string;
+} | {
+    readonly type: 'disabled';
+    readonly id: string;
+};
+/** list() 的只读摘要（不含组件）。 */
+export interface TuiPanelSummary {
+    readonly id: string;
+    readonly title: string;
+    readonly source: 'plugin';
+}
+/** Host-only facade（driver 探针用；不经插件面导出）。 */
+export interface TuiPanelHost {
+    register(descriptor: {
+        readonly id: string;
+        readonly title?: string;
+    }): () => void;
+    list(): readonly TuiPanelSummary[];
+    open(id: string): boolean;
+    close(id: string): boolean;
+    subscribe(listener: (event: TuiPanelEvent) => void): () => void;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        tuiPanels: TuiPanelRuntime;
+    }
+}
+export declare const name = "dsh-tui-panels";
+/**
+ * ctx.tuiPanels —— 插件侧栏 Panel 准入服务。拒绝一律 warn + 返回
+ * undefined/false（与 tuiStatus.registerView 同语义），绝不抛给插件。
+ */
+export declare class TuiPanelRuntime extends Service {
+    constructor(ctx: Context);
+    /**
+     * 注册一个侧栏 Panel。成功返回 cleanup-aware disposer；拒绝 warn 并
+     * 返回 undefined（feature-detect 可辨）。identity 语义与 tuiStatus
+     * 相同（只喂 effect ledger 的 pluginId）。
+     */
+    register(descriptor: TuiPanelDescriptor, identity?: Context): (() => void) | undefined;
+    /** 只读摘要（仅自己注册的 Panel；不含组件）。 */
+    list(): readonly TuiPanelSummary[];
+    /**
+     * 打开自己注册的 Panel（展开侧栏并聚焦）。mutate + 限速：每插件每
+     * 5s 至多 1 次，超限丢弃并记 ledger。返回 false = 未注册/不属于自己的
+     * id、超限、或没有活的 Chat 控制器消费请求。
+     */
+    open(id: string): boolean;
+    /** 关闭自己注册的 Panel：若它是当前 active Panel，则收起侧栏。 */
+    close(id: string): boolean;
+    /** 设置/清除自己 Panel 的 badge。 */
+    badge(id: string, badge: {
+        level: TuiPanelBadgeLevel;
+        unread: number;
+    } | null): boolean;
+    /** 订阅涉及自己 Panel 的事件（本阶段 registered/unregistered/badge/
+     * error/disabled；opened/closed/focused/blurred/sidebar-toggled TODO）。 */
+    subscribe(listener: (event: TuiPanelEvent) => void): () => void;
+}
+export declare function getHostPanelRuntime(runtime: TuiPanelRuntime | undefined): TuiPanelHost | undefined;
+export default TuiPanelRuntime;
+//# sourceMappingURL=panels.d.ts.map

package/lib/types/dsh-adapter/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/panels.ts"],"names":[],"mappings":"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"}