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

package/lib/types/components/sidePanel/PanelPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelPicker.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelPicker.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAClG;AAcD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,cAAc,EAAE,CAW7F;AAED,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,MAAM,GACP,EAAE;IACD,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C,GAAG,KAAK,CAAC,SAAS,CAgClB"}

package/lib/types/components/sidePanel/PanelPicker.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * /panel 无参的面板选择器：Pane + Select 行列出「已启用 ∩ 已注册」的
+ * 面板（内置与插件同席——图标、标题、badge 状态点都来自 PanelStore），
+ * 当前活动面板带 current 标记。Enter 打开并聚焦，Esc 取消。
+ */
+import React from 'react';
+import { Box, Text } from '../../ui.js';
+import { t } from '../../i18n.js';
+import { Pane } from '../design-system/Pane.js';
+import { Select } from '../Select.js';
+import { HintLine } from '../design-system/HintLine.js';
+import { panelStore } from './PanelStore.js';
+function badgeGlyph(level) {
+    if (level === 'warning')
+        return '!';
+    if (level === 'error')
+        return '×';
+    return '●';
+}
+function badgeColor(level) {
+    if (level === 'warning')
+        return 'warning';
+    if (level === 'error')
+        return 'error';
+    return 'accent';
+}
+export function usePanelPickerRows(controller) {
+    const entries = React.useSyncExternalStore(panelStore.subscribe, () => panelStore.list());
+    return controller.enabledPanelIds
+        .map(id => entries.find(entry => entry.definition.id === id))
+        .filter((entry) => entry !== undefined)
+        .map(entry => ({
+        id: entry.definition.id,
+        title: entry.definition.titleKey !== undefined ? t(entry.definition.titleKey) : entry.definition.title ?? entry.definition.id,
+        icon: entry.definition.icon,
+        badge: entry.badge,
+    }));
+}
+export function PanelPicker({ rows, focusIndex, activeId, onPick, }) {
+    return (_jsx(Pane, { color: "accent", children: _jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('picker-title-panel') }) }), _jsx(Select, { options: rows.map(row => ({
+                        value: row.id,
+                        label: (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: (row.icon ?? row.title.slice(0, 1)) + ' ' }), row.title, row.badge != null && (_jsx(Text, { color: badgeColor(row.badge.level), children: ' ' + badgeGlyph(row.badge.level) }))] })),
+                    })), focusIndex: focusIndex, selectedValue: activeId, onPick: onPick }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-confirm-exit') }) })] }) }));
+}

package/lib/types/components/sidePanel/PanelStore.d.ts

@@ -0,0 +1,55 @@
+/**
+ * PanelStore：Panel 定义 + 运行时状态（badge / 最近错误）一个 store
+ * （设计文档 §6.4 / §16.2——注册即有 badge 槽，释放即清，没有第二条
+ * 内置专用路径；插件 API 只是给它加准入外壳）。
+ *
+ * 通知不轮询：各业务 store（channel / BackgroundJobStore / …）的订阅
+ * 回调里由 Adapter 调 setBadge。有界：每 Panel 一条 badge，无历史列表，
+ * unread 饱和到 99。
+ */
+import type { PanelBadge, PanelDefinition, PanelEntry, PanelOwner } from './types.js';
+export declare const PANEL_UNREAD_CAP = 99;
+/** 连续崩溃禁用阈值（会话内，时间窗内累计；设计文档 §18.4）。 */
+export declare const PANEL_CRASH_DISABLE_THRESHOLD = 3;
+/** 崩溃计数的滑动时间窗。 */
+export declare const PANEL_CRASH_WINDOW_MS = 60000;
+/** PanelStore 对外事件（subscribe 的 listener 参数；useSyncExternalStore
+ *  的 () => void 订阅者可安全忽略）。opened/closed/focused/blurred 等
+ *  useSidePanel 侧的事件本阶段尚未接入（TODO §18.3）。 */
+export type PanelStoreEvent = {
+    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;
+};
+export declare class PanelStore {
+    private entries;
+    private listeners;
+    private snapshot;
+    private sequence;
+    /** source='plugin' 的连续崩溃时间戳（会话内；注册/重注册即清零）。 */
+    private crashTimes;
+    /** 重复 id → DUPLICATE_CONTRIBUTION_ID（与 tuiStatus 同一约定）。 */
+    register(definition: PanelDefinition, owner: PanelOwner): () => void;
+    list(): readonly PanelEntry[];
+    get(id: string): PanelEntry | undefined;
+    /** 只允许 owner 或宿主调用（调用侧自律，与 tuiStatus 相同）。 */
+    setBadge(id: string, badge: Omit<PanelBadge, 'latestAt'> | null): void;
+    clearBadge(id: string): void;
+    reportError(id: string, error: unknown): void;
+    subscribe: (listener: (event: PanelStoreEvent) => void) => (() => void);
+    private emit;
+}
+/** 进程级单例（内置经 registerBuiltinPanels，插件经 Phase 6 的准入外壳）。 */
+export declare const panelStore: PanelStore;
+//# sourceMappingURL=PanelStore.d.ts.map

package/lib/types/components/sidePanel/PanelStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelStore.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErF,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,uCAAuC;AACvC,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,kBAAkB;AAClB,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;4CAE4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAatD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAI;IACpB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAA8B;IAEhD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IA0BpE,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI;IAUtE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,GAAI,UAAU,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGrE;IAED,OAAO,CAAC,IAAI;CAIb;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,YAAmB,CAAA"}

package/lib/types/components/sidePanel/PanelStore.js

@@ -0,0 +1,109 @@
+export const PANEL_UNREAD_CAP = 99;
+/** 连续崩溃禁用阈值（会话内，时间窗内累计；设计文档 §18.4）。 */
+export const PANEL_CRASH_DISABLE_THRESHOLD = 3;
+/** 崩溃计数的滑动时间窗。 */
+export const PANEL_CRASH_WINDOW_MS = 60_000;
+function compareEntries(a, b) {
+    // 内置 Panel 排在插件 Panel 之前；同 source 内按 order，再按注册顺序。
+    const sourceA = a.definition.source === 'builtin' ? 0 : 1;
+    const sourceB = b.definition.source === 'builtin' ? 0 : 1;
+    if (sourceA !== sourceB)
+        return sourceA - sourceB;
+    const orderA = a.definition.order ?? 0;
+    const orderB = b.definition.order ?? 0;
+    if (orderA !== orderB)
+        return orderA - orderB;
+    return a.registrationId - b.registrationId;
+}
+export class PanelStore {
+    entries = new Map();
+    listeners = new Set();
+    snapshot = Object.freeze([]);
+    sequence = 0;
+    /** source='plugin' 的连续崩溃时间戳（会话内；注册/重注册即清零）。 */
+    crashTimes = new Map();
+    /** 重复 id → DUPLICATE_CONTRIBUTION_ID（与 tuiStatus 同一约定）。 */
+    register(definition, owner) {
+        if (this.entries.has(definition.id)) {
+            throw new Error(`DUPLICATE_CONTRIBUTION_ID: panel "${definition.id}" is already registered`);
+        }
+        this.sequence += 1;
+        const entry = {
+            definition,
+            owner,
+            registrationId: this.sequence,
+            badge: null,
+            lastError: null,
+        };
+        this.entries.set(definition.id, entry);
+        this.crashTimes.delete(definition.id);
+        this.emit({ type: 'registered', id: definition.id });
+        return () => {
+            // badge/lastError 更新会替换 entry 对象——按 registrationId 认亲，
+            // 而不是对象恒等（否则一次 badge 就会让撤下变成 no-op）。
+            if (this.entries.get(definition.id)?.registrationId === entry.registrationId) {
+                this.entries.delete(definition.id);
+                this.crashTimes.delete(definition.id);
+                this.emit({ type: 'unregistered', id: definition.id });
+            }
+        };
+    }
+    list() {
+        return this.snapshot;
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    /** 只允许 owner 或宿主调用（调用侧自律，与 tuiStatus 相同）。 */
+    setBadge(id, badge) {
+        const entry = this.entries.get(id);
+        if (entry === undefined)
+            return;
+        const next = badge === null
+            ? null
+            : { level: badge.level, unread: Math.min(PANEL_UNREAD_CAP, Math.max(0, badge.unread)), latestAt: Date.now() };
+        this.entries.set(id, { ...entry, badge: next });
+        this.emit({ type: 'badge', id });
+    }
+    clearBadge(id) {
+        const entry = this.entries.get(id);
+        if (entry === undefined || entry.badge === null)
+            return;
+        this.entries.set(id, { ...entry, badge: null });
+        this.emit({ type: 'badge', id });
+    }
+    reportError(id, error) {
+        const entry = this.entries.get(id);
+        if (entry === undefined)
+            return;
+        const message = error instanceof Error ? error.message : String(error);
+        this.entries.set(id, { ...entry, lastError: { message, at: Date.now() } });
+        this.emit({ type: 'error', id });
+        // 插件 Panel 的连续崩溃禁用（§18.4）：时间窗内第 N 次崩溃落禁用卡。
+        if (entry.definition.source !== 'plugin' || entry.disabled)
+            return;
+        const now = Date.now();
+        const window = (this.crashTimes.get(id) ?? []).filter(at => now - at <= PANEL_CRASH_WINDOW_MS);
+        window.push(now);
+        this.crashTimes.set(id, window);
+        if (window.length >= PANEL_CRASH_DISABLE_THRESHOLD) {
+            const current = this.entries.get(id);
+            if (current !== undefined && !current.disabled) {
+                this.entries.set(id, { ...current, disabled: true });
+                this.crashTimes.delete(id);
+                this.emit({ type: 'disabled', id });
+            }
+        }
+    }
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    emit(event) {
+        this.snapshot = Object.freeze([...this.entries.values()].sort(compareEntries));
+        for (const listener of [...this.listeners])
+            listener(event);
+    }
+}
+/** 进程级单例（内置经 registerBuiltinPanels，插件经 Phase 6 的准入外壳）。 */
+export const panelStore = new PanelStore();

package/lib/types/components/sidePanel/SidePanelColumn.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SidePanelColumn: the right surface's chrome — PanelBar on top, PanelHost
+ * in the middle, and a 1-row key hint at the bottom (design doc §6.1).
+ *
+ * The hint row swaps text with focus: unfocused it advertises Ctrl+B,
+ * focused it lists the panel keys. The two thin rules frame the host and
+ * brighten to 'accent' together with the divider when the column has the
+ * focus — the whole seam lights up as one surface.
+ *
+ * Tabs come from the PanelStore (enabled ∩ registered, badge included);
+ * builtin registrations arrive via registerBuiltinPanels on module import.
+ */
+import React from 'react';
+import type { ChannelUi } from '../../adapter/channel/ui-policy.js';
+import type { SidePanelController } from './useSidePanel.js';
+export interface SidePanelColumnProps {
+    readonly width: number;
+    readonly controller: SidePanelController;
+    readonly channel: ChannelUi;
+    readonly activity?: import('../../dsh-adapter/activity-store.js').ActivityView;
+    readonly attention?: {
+        readonly approvals: number;
+        readonly questions: number;
+    };
+    /** 宿主提供的「全屏」出口（Chat 把活动面板切到整屏形态）。 */
+    readonly onExpand?: (panelId: string) => void;
+    /** 会话轨迹投影（轨迹 Panel 的数据源）。 */
+    readonly trajectory?: import('../../dsh-adapter/trajectory/index.js').TrajBuild;
+}
+export declare function SidePanelColumn({ width, controller, channel, activity, attention, onExpand, trajectory }: SidePanelColumnProps): React.ReactNode;
+//# sourceMappingURL=SidePanelColumn.d.ts.map

package/lib/types/components/sidePanel/SidePanelColumn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelColumn.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelColumn.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAMnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;CAChF;AAoCD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAkEhJ"}

package/lib/types/components/sidePanel/SidePanelColumn.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SidePanelColumn: the right surface's chrome — PanelBar on top, PanelHost
+ * in the middle, and a 1-row key hint at the bottom (design doc §6.1).
+ *
+ * The hint row swaps text with focus: unfocused it advertises Ctrl+B,
+ * focused it lists the panel keys. The two thin rules frame the host and
+ * brighten to 'accent' together with the divider when the column has the
+ * focus — the whole seam lights up as one surface.
+ *
+ * Tabs come from the PanelStore (enabled ∩ registered, badge included);
+ * builtin registrations arrive via registerBuiltinPanels on module import.
+ */
+import React from 'react';
+import { Box, Text, useTerminalSize } from '../../ui.js';
+import { t } from '../../i18n.js';
+import { useSurfaceEdges } from '../SurfaceEdges.js';
+import { PanelBar } from './PanelBar.js';
+import { PanelHost } from './PanelHost.js';
+import { panelStore } from './PanelStore.js';
+import { registerBuiltinPanels } from './builtinPanels.js';
+registerBuiltinPanels();
+function fallbackTitle(id) {
+    const bare = id.includes(':') ? id.slice(id.indexOf(':') + 1) : id;
+    return bare.charAt(0).toUpperCase() + bare.slice(1);
+}
+function Rule({ focused }) {
+    // Structural chrome bleeds: the rule runs past the content column to the
+    // terminal's right edge (the panel surface's SurfaceEdges allow right
+    // bleed; zero without a page margin, so this is a no-op there).
+    const edges = useSurfaceEdges();
+    return (_jsx(Box, { height: 1, flexShrink: 0, marginRight: -edges.right, borderStyle: "single", borderTop: true, borderBottom: false, borderLeft: false, borderRight: false, borderColor: focused ? 'accent' : 'inactive' }));
+}
+/** 没有「已启用 ∩ 已注册」面板时的空态。 */
+function EmptyNone() {
+    return (_jsx(Box, { flexDirection: "column", flexGrow: 1, alignItems: "center", justifyContent: "center", paddingX: 1, children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: t('panel-empty-none') }) }));
+}
+export function SidePanelColumn({ width, controller, channel, activity, attention, onExpand, trajectory }) {
+    const focused = controller.focus === 'panel';
+    const { rows } = useTerminalSize();
+    const entries = React.useSyncExternalStore(panelStore.subscribe, () => panelStore.list());
+    const tabs = controller.enabledPanelIds.map(id => {
+        const entry = entries.find(candidate => candidate.definition.id === id);
+        if (entry === undefined)
+            return { id, title: fallbackTitle(id) };
+        const def = entry.definition;
+        return {
+            id,
+            title: def.titleKey !== undefined ? t(def.titleKey) : def.title ?? fallbackTitle(id),
+            icon: def.icon,
+            badge: entry.badge,
+        };
+    });
+    const anyRegistered = tabs.length > 0 && entries.length > 0 &&
+        controller.enabledPanelIds.some(id => entries.some(entry => entry.definition.id === id));
+    // ⤢ 只对「活动面板 + 声明了整屏形态 + 宿主接了出口」出现：能力位是
+    // 声明的唯一真源，没有整屏对应物的面板（info/companion）不画。
+    const activeEntry = entries.find(entry => entry.definition.id === controller.activePanelId);
+    const canExpand = activeEntry?.definition.capabilities?.fullscreen === true && onExpand !== undefined;
+    // 标签点击与 ←/→ 宿主键走同一条路（openPanel 会顺带把焦点给右栏）。
+    const onSelectPanel = React.useCallback((id) => { controller.openPanel(id, { focus: true }); }, 
+    // openPanel 在 useSidePanel 里是空依赖 useCallback（引用稳定）；
+    // controller 对象本身每次渲染都是新的，不能进依赖表。
+    [controller.openPanel]);
+    // Host 高度 = 列高 - PanelBar/上规/下规/hint 四行 chrome。
+    const hostHeight = Math.max(1, rows - 4);
+    return (_jsxs(Box, { flexDirection: "column", width: width, flexGrow: 1, children: [_jsx(PanelBar, { tabs: tabs, activeId: controller.activePanelId, width: width - 2, focused: focused, canExpand: canExpand, onExpand: canExpand ? () => onExpand?.(controller.activePanelId ?? '') : undefined, onSelect: onSelectPanel }), _jsx(Rule, { focused: focused }), _jsx(Box, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children: anyRegistered
+                    ? (_jsx(PanelHost, { controller: controller, channel: channel, width: width, height: hostHeight, activity: activity, attention: attention, trajectory: trajectory, openFullscreen: onExpand }))
+                    : _jsx(EmptyNone, {}) }), _jsx(Rule, { focused: focused }), _jsx(Box, { height: 1, flexShrink: 0, paddingX: 1, overflow: "hidden", children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: focused ? t('panel-hint-focused') : t('panel-hint-unfocused') }) })] }));
+}

package/lib/types/components/sidePanel/SidePanelLayout.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SidePanelLayout: owns the two-column row — chat surface left, divider,
+ * side-panel surface right (design doc §4.1). It decides nothing about
+ * state: useSidePanel hands it a resolved geometry and this component only
+ * arranges boxes and re-provides contexts.
+ *
+ * What each column subtree gets (the PageMargin trick, one level down):
+ * - TerminalSizeContext narrowed to the column width, so every existing
+ *   component that reads useTerminalSize() (MessageList, PromptInput,
+ *   tool cards, Markdown tables…) automatically lays out for the column;
+ * - SurfaceEdgesContext re-provided per column: chat bleeds left into the
+ *   page margin but stops at the divider, the panel bleeds right;
+ * - a numeric-width box with overflow="hidden" (never "%": ink resolves
+ *   percentages against the padding-inclusive parent).
+ *
+ * PageInsetContext is deliberately NOT overridden: the chat column's
+ * origin is still the content-area origin, so screen-coordinate overlays
+ * (tooltips) keep their math.
+ *
+ * STRUCTURAL STABILITY (2026-10-02 crash fix). The collapsed state used to
+ * render bare `children`, which made split↔collapsed a tree-SHAPE change:
+ * React unmounted the whole chat column and mounted a fresh one on every
+ * Ctrl+B / editor-open / resize-across-the-threshold. That cost more than
+ * a repaint — the deletion commit ran ScrollBox's useImperativeHandle
+ * cleanup, whose ref is Chat's `setHandle` state setter, so the detached
+ * ref scheduled a state update INSIDE a commit; combined with the
+ * fullscreen editor publishing its node from an insertion effect (a store
+ * notification that renders synchronously inside the same commit) the
+ * nested-update counter ratcheted past React's limit and the process died
+ * with Minified React error #185. Keeping the chat column at a stable tree
+ * position turns every geometry change into a prop update, so nothing is
+ * deleted, no ref detaches mid-commit, and chat-side state (scroll
+ * position, draft, transcript measure cache) survives the toggle.
+ *
+ * While collapsed the wrappers are invisible by construction: the contexts
+ * re-provide the PARENT's own values (referentially identical), the chat
+ * box gets no width / no overflow / no click handler, and the outer row
+ * does not clip — so the collapsed frame stays byte-identical to the
+ * no-layout render (locked by verify-side-panel-layout).
+ */
+import React from 'react';
+import type { SidePanelFocus } from './useSidePanel.js';
+import type { SidePanelSplit } from './dimensions.js';
+export interface SidePanelLayoutProps {
+    readonly geometry: SidePanelSplit | null;
+    readonly focus: SidePanelFocus;
+    /** Right-column content (PanelBar + PanelHost + hint). */
+    readonly side: React.ReactNode;
+    readonly onActivateChat?: () => void;
+    readonly onActivatePanel?: () => void;
+    readonly children: React.ReactNode;
+}
+export declare function SidePanelLayout({ geometry, focus, side, onActivateChat, onActivatePanel, children, }: SidePanelLayoutProps): React.ReactNode;
+//# sourceMappingURL=SidePanelLayout.d.ts.map

package/lib/types/components/sidePanel/SidePanelLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelLayout.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACnC;AA6BD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,cAAc,EACd,eAAe,EACf,QAAQ,GACT,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAqExC"}

package/lib/types/components/sidePanel/SidePanelLayout.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SidePanelLayout: owns the two-column row — chat surface left, divider,
+ * side-panel surface right (design doc §4.1). It decides nothing about
+ * state: useSidePanel hands it a resolved geometry and this component only
+ * arranges boxes and re-provides contexts.
+ *
+ * What each column subtree gets (the PageMargin trick, one level down):
+ * - TerminalSizeContext narrowed to the column width, so every existing
+ *   component that reads useTerminalSize() (MessageList, PromptInput,
+ *   tool cards, Markdown tables…) automatically lays out for the column;
+ * - SurfaceEdgesContext re-provided per column: chat bleeds left into the
+ *   page margin but stops at the divider, the panel bleeds right;
+ * - a numeric-width box with overflow="hidden" (never "%": ink resolves
+ *   percentages against the padding-inclusive parent).
+ *
+ * PageInsetContext is deliberately NOT overridden: the chat column's
+ * origin is still the content-area origin, so screen-coordinate overlays
+ * (tooltips) keep their math.
+ *
+ * STRUCTURAL STABILITY (2026-10-02 crash fix). The collapsed state used to
+ * render bare `children`, which made split↔collapsed a tree-SHAPE change:
+ * React unmounted the whole chat column and mounted a fresh one on every
+ * Ctrl+B / editor-open / resize-across-the-threshold. That cost more than
+ * a repaint — the deletion commit ran ScrollBox's useImperativeHandle
+ * cleanup, whose ref is Chat's `setHandle` state setter, so the detached
+ * ref scheduled a state update INSIDE a commit; combined with the
+ * fullscreen editor publishing its node from an insertion effect (a store
+ * notification that renders synchronously inside the same commit) the
+ * nested-update counter ratcheted past React's limit and the process died
+ * with Minified React error #185. Keeping the chat column at a stable tree
+ * position turns every geometry change into a prop update, so nothing is
+ * deleted, no ref detaches mid-commit, and chat-side state (scroll
+ * position, draft, transcript measure cache) survives the toggle.
+ *
+ * While collapsed the wrappers are invisible by construction: the contexts
+ * re-provide the PARENT's own values (referentially identical), the chat
+ * box gets no width / no overflow / no click handler, and the outer row
+ * does not clip — so the collapsed frame stays byte-identical to the
+ * no-layout render (locked by verify-side-panel-layout).
+ */
+import React from 'react';
+import { Box, Text } from '../../ui.js';
+import { TerminalSizeContext } from '../../ink/components/TerminalSizeContext.js';
+import { useTerminalSize } from '../../ink/hooks/use-terminal-size.js';
+import { SurfaceEdgesContext, useSurfaceEdges } from '../SurfaceEdges.js';
+/**
+ * The 1-column seam. Rendered as an explicit glyph block (not a border) so
+ * it can tee into the panel column's horizontal rules: rows that line up
+ * with a rule draw '├', everything else '│' — the seam and the rules read
+ * as one framed surface instead of two crossing lines.
+ */
+function DividerColumn({ focused, rows, junctionRows, }) {
+    const junctions = new Set(junctionRows);
+    const glyphs = [];
+    for (let y = 0; y < Math.max(1, rows); y += 1) {
+        glyphs.push(junctions.has(y) ? '├' : '│');
+    }
+    return (_jsx(Box, { width: 1, flexShrink: 0, overflow: "hidden", children: _jsx(Text, { color: focused ? 'accent' : 'inactive', children: glyphs.join('\n') }) }));
+}
+export function SidePanelLayout({ geometry, focus, side, onActivateChat, onActivatePanel, children, }) {
+    const outerEdges = useSurfaceEdges();
+    const parentSize = useTerminalSize();
+    const rows = parentSize.rows;
+    const screenRows = parentSize.screenRows ?? parentSize.rows;
+    const split = geometry !== null;
+    const panelColumns = geometry?.panel ?? 0;
+    const chatEdges = React.useMemo(() => ({ left: outerEdges.left, right: 0 }), [outerEdges.left]);
+    const panelEdges = React.useMemo(() => ({ left: 0, right: outerEdges.right }), [outerEdges.right]);
+    // Collapsed: hand the parent's own objects straight back so consumers see
+    // byte-identical context values (and keep their memoization).
+    const chatSize = React.useMemo(() => (geometry === null ? parentSize : { columns: geometry.chat, rows, screenRows }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- geometry identity changes with the split
+    [parentSize, geometry, rows, screenRows]);
+    const panelSize = React.useMemo(() => ({ columns: panelColumns, rows, screenRows }), [panelColumns, rows, screenRows]);
+    return (_jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, overflow: split ? 'hidden' : undefined, children: [_jsx(SurfaceEdgesContext.Provider, { value: split ? chatEdges : outerEdges, children: _jsx(TerminalSizeContext.Provider, { value: chatSize, children: _jsx(Box, { flexDirection: "column", flexGrow: split ? 0 : 1, width: geometry === null ? undefined : geometry.chat, flexShrink: 0, overflow: split ? 'hidden' : undefined, onClick: split ? onActivateChat : undefined, children: children }) }) }), split && (_jsxs(_Fragment, { children: [_jsx(DividerColumn, { focused: focus === 'panel', rows: rows, junctionRows: [1, Math.max(1, rows - 2)] }), _jsx(SurfaceEdgesContext.Provider, { value: panelEdges, children: _jsx(TerminalSizeContext.Provider, { value: panelSize, children: _jsx(Box, { flexDirection: "column", width: panelColumns, flexShrink: 0, overflow: "hidden", onClick: onActivatePanel, 
+                                /* The right column is fenced out of the fullscreen linear text
+                                   selection: a drag across chat rows must not capture panel
+                                   glyphs (design doc §4.6). Panels carry their own copy action. */
+                                noSelect: true, children: side }) }) })] }))] }));
+}

package/lib/types/components/sidePanel/SidePanelRuntimeContext.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 侧栏 context 两件套：
+ * - SidePanelRuntimeContext：useSidePanel 创建的运行时（键盘分发）+
+ *   当前 channel（内置 Adapter 的数据源；插件 Panel 不经过这里，它们
+ *   在 Phase 6 拿策展快照）。
+ * - PanelContext：PanelHost 为每个 Panel 子树提供的身份（panelId），
+ *   usePanelInput 据此把业务键注册进分发器；不在 Panel 里（整屏
+ *   形态）时为 null，usePanelInput 退化为普通 useInput。
+ */
+import React from 'react';
+import type { ChannelUi } from '../../adapter/channel/ui-policy.js';
+import type { ActivityView } from '../../dsh-adapter/activity-store.js';
+import type { TrajBuild } from '../../dsh-adapter/trajectory/index.js';
+import type { SidePanelRuntime } from './types.js';
+export interface SidePanelRuntimeContextValue {
+    readonly runtime: SidePanelRuntime;
+    readonly channel: ChannelUi;
+    /** workingActivity 投影（Companion 等 Panel 用；activity 插件未装时
+     *  缺省，Panel 退回 channel.working / spinnerMode）。 */
+    readonly activity?: ActivityView;
+    /** Chat 的审批 / 问卷待处理快照（Companion 的 attention 输入）。 */
+    readonly attention?: {
+        readonly approvals: number;
+        readonly questions: number;
+    };
+    /** 会话轨迹投影（Chat 折叠的那一份，与全屏轨迹场景共用；未折叠完成为
+     *  undefined）。轨迹 Panel 直接渲染它，不自己再折一次。 */
+    readonly trajectory?: TrajBuild;
+    /** 「全屏」出口：把某个 Panel 的内容切到整屏形态（PanelBar 的 ⤢ 用它）。
+     *  未接（或该 Panel 没有整屏形态）时 undefined，按钮照画但点击无效——
+     *  宿主是否可展开由 PanelDefinition.capabilities.fullscreen 决定。 */
+    readonly openFullscreen?: (panelId: string) => void;
+}
+export declare const SidePanelRuntimeContext: React.Context<SidePanelRuntimeContextValue | null>;
+export declare function useSidePanelChannel(): ChannelUi;
+/** 会话轨迹投影；Chat 还没折叠出来（或不在 PanelHost 下）时 undefined。 */
+export declare function useSidePanelTrajectory(): TrajBuild | undefined;
+/** 「全屏」出口：宿主没接时返回 undefined（按钮点击静默无效）。 */
+export declare function useSidePanelFullscreen(): ((panelId: string) => void) | undefined;
+export declare const PanelContext: React.Context<{
+    readonly panelId: string;
+} | null>;
+//# sourceMappingURL=SidePanelRuntimeContext.d.ts.map

package/lib/types/components/sidePanel/SidePanelRuntimeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelRuntimeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B;sDACkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E;6CACyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B;;+DAE2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED,eAAO,MAAM,uBAAuB,oDAAiE,CAAA;AAErG,wBAAgB,mBAAmB,IAAI,SAAS,CAI/C;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,IAAI,SAAS,GAAG,SAAS,CAE9D;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAEhF;AAED,eAAO,MAAM,YAAY;sBAA2C,MAAM;SAAgB,CAAA"}

package/lib/types/components/sidePanel/SidePanelRuntimeContext.js

@@ -0,0 +1,26 @@
+/**
+ * 侧栏 context 两件套：
+ * - SidePanelRuntimeContext：useSidePanel 创建的运行时（键盘分发）+
+ *   当前 channel（内置 Adapter 的数据源；插件 Panel 不经过这里，它们
+ *   在 Phase 6 拿策展快照）。
+ * - PanelContext：PanelHost 为每个 Panel 子树提供的身份（panelId），
+ *   usePanelInput 据此把业务键注册进分发器；不在 Panel 里（整屏
+ *   形态）时为 null，usePanelInput 退化为普通 useInput。
+ */
+import React from 'react';
+export const SidePanelRuntimeContext = React.createContext(null);
+export function useSidePanelChannel() {
+    const ctx = React.useContext(SidePanelRuntimeContext);
+    if (ctx === null)
+        throw new Error('useSidePanelChannel must be used under PanelHost');
+    return ctx.channel;
+}
+/** 会话轨迹投影；Chat 还没折叠出来（或不在 PanelHost 下）时 undefined。 */
+export function useSidePanelTrajectory() {
+    return React.useContext(SidePanelRuntimeContext)?.trajectory;
+}
+/** 「全屏」出口：宿主没接时返回 undefined（按钮点击静默无效）。 */
+export function useSidePanelFullscreen() {
+    return React.useContext(SidePanelRuntimeContext)?.openFullscreen;
+}
+export const PanelContext = React.createContext(null);

package/lib/types/components/sidePanel/TrajectoryPanel.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { PanelProps } from './types.js';
+type TrajectoryView = 'timeline' | 'hotspot';
+export declare function TrajectoryPanel({ width, height, focused, visible }: PanelProps): React.ReactNode;
+/** Re-exported for the host/verify fixtures (same union the scene exports). */
+export type { TrajectoryView };
+//# sourceMappingURL=TrajectoryPanel.d.ts.map

package/lib/types/components/sidePanel/TrajectoryPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/TrajectoryPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA0BzB,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,YAAY,CAAA;AAwB7D,KAAK,cAAc,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5C,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAuYhG;AAED,+EAA+E;AAC/E,YAAY,EAAE,cAAc,EAAE,CAAA"}