dsh-codinput 0.1.0

package/src/client/components/Toolbar.tsx

@@ -0,0 +1,239 @@
+/**
+ * 工具行：结构与样式逐条对齐官方 InputBar 工具行——
+ * 左侧 .dci-tools：指令（plus）、添加附件（paperclip）、权限（shield 触发器）；
+ * 右侧 .dci-trailing：模型与思考强度（触发器）、发送（.primary 圆钮）。
+ * 按钮沿用官方 keepFocus 语义（mousedown 不夺走编辑器焦点）。
+ */
+
+import { useEffect, useRef, useState } from 'react';
+import type { DraftAttachmentId, InputActions, InputState, InputTriggerController, UseProjection } from '../host-types';
+import { openCommandMenu } from '../triggers';
+import { stash } from '../services';
+import { addFilesToDraft } from '../attachments';
+import { t, useT } from '../i18n';
+import { IconPaperclipOfficial, IconPlusOfficial, IconSendOfficial } from '../icons';
+import { ModelMenu } from './ModelMenu';
+import { PermissionMenu } from './PermissionMenu';
+import { useSnapshot } from './useSnapshot';
+
+export interface ToolbarProps {
+  sessionId: string | undefined;
+  state: InputState | undefined;
+  actions: InputActions | undefined;
+  triggers: InputTriggerController | undefined;
+  /** caret 偏移（指令按钮以当前 caret 构造 synthetic hit）。 */
+  caretRef: { current: number | null };
+  useProjection: UseProjection | undefined;
+  /** owner disabled（权限触发器随之锁住，对齐官方 locked）。 */
+  disabled?: boolean;
+  onNotify?(level: 'info' | 'error', text: string): void;
+  /** 主发送手势（与编辑器发送键同一策略）。 */
+  onSend(): void;
+  sendDisabled?: boolean;
+}
+
+/** 官方 keepFocus：mousedown 阻止默认，避免编辑器失焦。 */
+function keepFocus(event: React.MouseEvent): void {
+  event.preventDefault();
+}
+
+export function Toolbar(props: ToolbarProps): JSX.Element {
+  const { sessionId, state, actions, triggers, caretRef, useProjection, disabled, onNotify } = props;
+  useT();
+  const fileRef = useRef<HTMLInputElement | null>(null);
+
+  const attachments: readonly DraftAttachmentId[] = state?.attachmentIds ?? [];
+
+  const onCommandClick = (): void => {
+    if (!triggers) return;
+    openCommandMenu(triggers, undefined, caretRef.current ?? 0);
+  };
+
+  const onAttach = (files: FileList | null): void => {
+    addFilesToDraft(sessionId, actions, files, onNotify);
+  };
+
+  return (
+    <div className="dci-row">
+      <div className="dci-tools">
+        <button
+          type="button"
+          className="dci-add"
+          aria-label={t("tool.command")}
+          aria-haspopup="listbox"
+          title={t("tool.command")}
+          disabled={!triggers}
+          onMouseDown={keepFocus}
+          onClick={onCommandClick}
+        >
+          <IconPlusOfficial size={14} />
+        </button>
+        <button
+          type="button"
+          className="dci-add"
+          aria-label={t("tool.attach")}
+          title={t("tool.attach")}
+          onMouseDown={keepFocus}
+          onClick={() => fileRef.current?.click()}
+        >
+          <IconPaperclipOfficial size={14} />
+        </button>
+        <input
+          ref={fileRef}
+          type="file"
+          multiple
+          hidden
+          onChange={(e) => {
+            onAttach(e.target.files);
+            e.target.value = '';
+          }}
+        />
+        <PermissionMenu
+          sessionId={sessionId}
+          actions={actions}
+          currentDraft={state?.draft ?? ''}
+          useProjection={useProjection}
+          disabled={disabled}
+          onNotify={onNotify}
+        />
+      </div>
+      <div className="dci-trailing">
+        <ModelMenu
+          sessionId={sessionId}
+          onNotify={onNotify}
+        />
+        <ContextGauge useProjection={useProjection} />
+        <button
+          type="button"
+          className="dci-send"
+          aria-label={t("tool.send")}
+          title={t("tool.send")}
+          disabled={props.sendDisabled}
+          onMouseDown={keepFocus}
+          onClick={() => props.onSend()}
+        >
+          <IconSendOfficial size={16} />
+        </button>
+      </div>
+    </div>
+  );
+}
+
+const GAUGE_CIRCUMFERENCE = 2 * Math.PI * 5.5;
+
+interface PressureSnapshot {
+  contextWindow?: number;
+  pressureTokens?: number;
+  projectedTokens?: number;
+}
+
+interface BreakdownSnapshot {
+  messageTokens?: number;
+  systemTokens?: number;
+  toolsTokens?: number;
+}
+
+function shortTokens(n: number): string {
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(n % 1_000_000 === 0 ? 0 : 1)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(n % 1_000 === 0 ? 0 : 1)}K`;
+  return `${n}`;
+}
+
+/** 上下文占用小圈（官方 JObwrW 复刻）：双环仪表 + 点击展开分段面板。 */
+function ContextGauge(props: { useProjection: UseProjection | undefined }): JSX.Element | null {
+  const { useProjection } = props;
+  const [open, setOpen] = useState(false);
+  const rootRef = useRef<HTMLSpanElement | null>(null);
+  const pressure = useProjection
+    ? (useProjection('contextPressure') as PressureSnapshot | undefined)
+    : undefined;
+  const breakdown = useProjection
+    ? (useProjection('contextBreakdown') as BreakdownSnapshot | undefined)
+    : undefined;
+  // 点外面关闭。
+  useEffect(() => {
+    if (!open) return;
+    const onDown = (event: PointerEvent): void => {
+      if (rootRef.current && event.target instanceof Node && rootRef.current.contains(event.target)) return;
+      setOpen(false);
+    };
+    window.addEventListener('pointerdown', onDown, true);
+    return () => window.removeEventListener('pointerdown', onDown, true);
+  }, [open]);
+
+  if (!pressure || !pressure.contextWindow) return null;
+  const windowTokens = pressure.contextWindow;
+  const pct = Math.min(100, Math.max(0, ((pressure.pressureTokens ?? 0) / windowTokens) * 100));
+  const dash = (pct / 100) * GAUGE_CIRCUMFERENCE;
+  const segments: readonly [string, number][] = [
+    ['dci-gauge-colorSystem', breakdown?.systemTokens ?? 0],
+    ['dci-gauge-colorTools', breakdown?.toolsTokens ?? 0],
+    ['dci-gauge-colorMessages', breakdown?.messageTokens ?? 0],
+  ];
+  return (
+    <span className="dci-gauge-root" ref={rootRef}>
+      <button
+        type="button"
+        className="dci-gauge-trigger"
+        aria-label={t("tool.context", { percent: Math.round(pct) })}
+        aria-haspopup="dialog"
+        aria-expanded={open}
+        title={t("tool.context", { percent: Math.round(pct) })}
+        onClick={() => setOpen(!open)}
+      >
+        <svg viewBox="0 0 14 14" width="14" height="14" aria-hidden="true">
+          <circle className="dci-gauge-track" cx="7" cy="7" r="5.5" />
+          <circle
+            className="dci-gauge-fill"
+            cx="7" cy="7" r="5.5"
+            strokeDasharray={`${dash} ${GAUGE_CIRCUMFERENCE}`}
+            transform="rotate(-90 7 7)"
+          />
+        </svg>
+      </button>
+      {open ? (
+        <div className="dci-gauge-panel" role="dialog" aria-label={t("tool.contextTitle")}>
+          <div className="dci-gauge-header">
+            <span className="dci-gauge-headline">{t("tool.contextTitle")}</span>
+            <span className="dci-gauge-percent">{Math.round(pct)}%</span>
+            <span className="dci-gauge-figures">
+              ~{shortTokens(pressure.pressureTokens ?? 0)} / {shortTokens(windowTokens)}
+            </span>
+          </div>
+          <div className="dci-gauge-bar">
+            {segments.map(([cls, tokens]) => (
+              <div
+                key={cls}
+                className={`dci-gauge-segment ${cls}`}
+                style={{ width: `${(tokens / windowTokens) * 100}%` }}
+              />
+            ))}
+          </div>
+          <dl className="dci-gauge-rows">
+            <div className="dci-gauge-row">
+              <dt>
+                <span className={`dci-gauge-swatch dci-gauge-colorSystem`} aria-hidden="true" />
+                {t("stats.prompt")}
+              </dt>
+              <dd>~{shortTokens(breakdown?.systemTokens ?? 0)}</dd>
+            </div>
+            <div className="dci-gauge-row">
+              <dt>
+                <span className={`dci-gauge-swatch dci-gauge-colorTools`} aria-hidden="true" />
+                {t("stats.tools")}
+              </dt>
+              <dd>~{shortTokens(breakdown?.toolsTokens ?? 0)}</dd>
+            </div>
+            <div className="dci-gauge-row">
+              <dt>
+                <span className={`dci-gauge-swatch dci-gauge-colorMessages`} aria-hidden="true" />
+                {t("stats.messages")}
+              </dt>
+              <dd>~{shortTokens(breakdown?.messageTokens ?? 0)}</dd>
+            </div>
+          </dl>
+        </div>
+      ) : null}
+    </span>
+  );
+}

package/src/client/components/popup-filter.ts

@@ -0,0 +1,13 @@
+/** popupSelect 本地过滤：与官方 filterOptions 同语义（label/detail 大小写不敏感子串）。 */
+
+import type { SelectOption } from '../host-types';
+
+export function filterOptions(options: readonly SelectOption[], search: string): readonly SelectOption[] {
+  const q = search.trim().toLowerCase();
+  if (q === '') return options;
+  return options.filter((option) => {
+    const label = typeof option.label === 'string' ? option.label.toLowerCase() : '';
+    const detail = typeof option.detail === 'string' ? option.detail.toLowerCase() : '';
+    return label.includes(q) || detail.includes(q);
+  });
+}

package/src/client/components/useSnapshot.ts

@@ -0,0 +1,18 @@
+/** React 桥：HostObservable（getSnapshot + subscribe）→ useSyncExternalStore。 */
+
+import { useCallback, useSyncExternalStore } from 'react';
+import type { HostObservable } from '../host-types';
+
+export function useSnapshot<T>(source: HostObservable<T> | undefined): T | undefined {
+  const subscribe = useCallback(
+    (fn: () => void) => (source ? source.subscribe(fn) : () => {}),
+    [source],
+  );
+  const getSnapshot = useCallback(() => source?.getSnapshot(), [source]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+
+export function useSnapshotOf<T>(source: HostObservable<T> | undefined, selector: (value: T) => unknown): unknown {
+  const value = useSnapshot(source);
+  return value === undefined ? undefined : selector(value);
+}

package/src/client/diag.ts

@@ -0,0 +1,58 @@
+/** 诊断口约定：window.__dshCodinput*（见 docs/idea.md 附录）。 */
+
+import type { InputState, InputTriggerController, ComposerKeyboard } from './host-types';
+
+interface DiagWindow {
+  __dshCodinputDebug: unknown[];
+  __dshCodinputErrs: unknown[];
+  __dshCodinputSessionId: string | null;
+  __dshCodinputTriggers: Record<string, InputTriggerController | undefined>;
+  __dshCodinputKeyboard: Record<string, ComposerKeyboard | undefined>;
+  __dshCodinputShell: Record<string, unknown>;
+}
+
+declare global {
+  interface Window {
+    __dshCodinputDebug?: unknown[];
+    __dshCodinputErrs?: unknown[];
+    __dshCodinputSessionId?: string | null;
+    __dshCodinputTriggers?: Record<string, InputTriggerController | undefined>;
+    __dshCodinputKeyboard?: Record<string, ComposerKeyboard | undefined>;
+    __dshCodinputShell?: Record<string, unknown>;
+  }
+}
+
+export function diagWindow(): DiagWindow {
+  const w = window as Window & Partial<DiagWindow>;
+  w.__dshCodinputDebug ??= [];
+  w.__dshCodinputErrs ??= [];
+  w.__dshCodinputTriggers ??= {};
+  w.__dshCodinputKeyboard ??= {};
+  w.__dshCodinputShell ??= {};
+  return w as DiagWindow;
+}
+
+export function diagDebug(...parts: unknown[]): void {
+  const w = diagWindow();
+  w.__dshCodinputDebug.push(parts.length === 1 ? parts[0] : parts);
+  if (w.__dshCodinputDebug.length > 400) w.__dshCodinputDebug.splice(0, w.__dshCodinputDebug.length - 400);
+}
+
+export function diagError(scope: string, error: unknown): void {
+  const w = diagWindow();
+  w.__dshCodinputErrs.push({ scope, error: error instanceof Error ? error.stack ?? error.message : String(error) });
+  if (w.__dshCodinputErrs.length > 200) w.__dshCodinputErrs.splice(0, w.__dshCodinputErrs.length - 200);
+}
+
+export function diagSession(id: string | null): void {
+  diagWindow().__dshCodinputSessionId = id;
+}
+
+/** Safe: 对外暴露的只读探测面。 */
+export function runGuarded(scope: string, fn: () => void): void {
+  try {
+    fn();
+  } catch (error) {
+    diagError(scope, error);
+  }
+}

package/src/client/host-types.ts

@@ -0,0 +1,328 @@
+/**
+ * 宿主服务面的本地结构类型。
+ *
+ * 插件对宿主零运行时依赖（模块表只认平台种子词与包工厂），这里的类型按
+ * @deepseek-ai 0.1.5-rc.1 公开契约（.d.ts）抄录我们实际消费的最小切面；
+ * 运行时全部为鸭子类型，形状漂移只影响功能降级，不会崩插件。
+ */
+
+// ---------- cordis ----------
+
+export interface HostObservable<T> {
+  getSnapshot(): T;
+  subscribe(fn: () => void): () => void;
+}
+
+export interface ClientContext {
+  /** 属性读取要求 fiber inject 声明；只通过 ctx.inject(...) 的 scope 消费。 */
+  inject(services: readonly string[], fn: (scope: any) => void): void;
+  effect(fn: () => (() => void) | void, label?: string): void;
+  plugin(impl: unknown, config?: unknown): void;
+  get(name: string): unknown;
+  /** 客户端模块 inject 声明后可读（['slots', 'conversation']）。 */
+  slots: SlotsService;
+}
+
+// ---------- slots ----------
+
+export interface SlotRegisterOptions {
+  name: string;
+  key?: string;
+  id?: string;
+  order?: number;
+  label?: string | (() => string);
+  /** single/keyed/list：遮蔽秩，升序、最低者渲染。 */
+  priority?: number;
+  children?: Record<string, unknown>;
+  inject?: (...args: unknown[]) => Record<string, unknown>;
+  store?: unknown;
+  locale?: string;
+  registrant?: string;
+}
+
+export interface SlotsService {
+  register(options: SlotRegisterOptions, component: unknown): () => void;
+  /** 锚定槽位：当该槽被声明时运行工厂；工厂 yield 掉的可清理返回值统一登记生命周期。 */
+  inject(slotName: string, factory: () => Generator<unknown> | (() => unknown)): void;
+}
+
+// ---------- input machine ----------
+
+export type DraftAttachmentId = string;
+export type InputPhase = 'plain' | 'adjudicating' | 'claimed' | 'submitting';
+
+export interface InputState {
+  readonly draft: string;
+  readonly attachmentIds: readonly DraftAttachmentId[];
+  readonly draftRev: number;
+  readonly phase: InputPhase;
+  readonly claim?: { readonly token: string; readonly hint?: string; readonly attachments?: boolean };
+  readonly queue: readonly unknown[];
+}
+
+export interface InputActions {
+  setDraft(text: string): void;
+  addAttachments(ids: readonly DraftAttachmentId[]): boolean;
+  removeAttachment(id: DraftAttachmentId): void;
+  pruneAttachments(ids: readonly DraftAttachmentId[]): void;
+  submit(): void;
+}
+
+export interface EditSelection {
+  readonly start: number;
+  readonly end: number;
+}
+
+export interface ComposerKeyboard {
+  readonly snapshot: InputState;
+  submit(mode: string): void;
+  steerQueue(): void;
+  paste(text: string): void;
+  caretSpan(): EditSelection;
+  arbitrate(key: string, composing: boolean): 'consumed' | 'pick-highlighted' | 'pass';
+  space(): boolean;
+  dismissPopup(): void;
+}
+
+// ---------- slash trigger pipeline ----------
+
+export interface TokenSpan {
+  readonly start: number;
+  readonly end: number;
+  readonly draftRev: number;
+}
+
+export interface TriggerHit {
+  readonly trigger: '/' | '@';
+  readonly query: string;
+  readonly quoted: boolean;
+  readonly position: 'leading' | 'inline';
+  readonly span: TokenSpan;
+}
+
+export interface InputTriggerCandidate {
+  readonly name: string;
+  /** 官方本地化名（内置命令带，如「压缩/目标」）；官方主名渲染 label ?? name，label 与 name 不同时另出别名。 */
+  readonly label?: string;
+  readonly description?: string;
+  /** 官方 MenuView 语义：字符串 = 引用类 kind（file/folder/session）；组件 = 命令 glyph（渲染 <icon size={16}/>）。 */
+  readonly icon?: string | React.ComponentType<{ size?: number }>;
+  readonly hint?: string;
+  readonly section?: string;
+  readonly value?: string;
+  readonly drill?: boolean;
+}
+
+export interface InputTriggerCrumb {
+  readonly label: string;
+  readonly value: string;
+  readonly current?: boolean;
+}
+
+export interface MenuState {
+  readonly open: boolean;
+  readonly hit: TriggerHit | null;
+  readonly generation: number;
+  readonly groups: readonly {
+    readonly source: string;
+    readonly showGroupTitle?: boolean;
+    readonly status: 'pending' | 'ready';
+    readonly items: readonly InputTriggerCandidate[];
+  }[];
+  readonly highlight: { readonly source: string; readonly index: number } | null;
+}
+
+/** ctx.conversation.input（InputHub）逐 id 服务面。 */
+export interface InputTriggerController {
+  readonly menu: HostObservable<MenuState>;
+  readonly launcher: HostObservable<string | null>;
+  readonly headers: HostObservable<ReadonlyMap<string, readonly InputTriggerCrumb[]>>;
+  readonly lexicon: HostObservable<ReadonlyMap<string, readonly string[]>>;
+  track(draft: string, caret: number, guard: { readonly tier: 'plain' | 'claimed' | 'frozen' }, draftRev: number): void;
+  arbitrate(key: string, composing: boolean): 'consumed' | 'pick-highlighted' | 'pass';
+  onSpace(): boolean;
+  toggleSource(source: string, hit: TriggerHit): void;
+  pick(source: string, index: number, action?: 'pick' | 'drill'): void;
+  pickCrumb(source: string, index: number): void;
+  hover(source: string, index: number): void;
+  dismiss(): void;
+}
+
+// ---------- conversation / sessions ----------
+
+export interface SessionInput {
+  setDraft(text: string): void;
+  addAttachments(ids: readonly DraftAttachmentId[]): boolean;
+  removeAttachment(id: DraftAttachmentId): void;
+  pruneAttachments(ids: readonly DraftAttachmentId[]): void;
+  submit(): void;
+  notify(level: 'info' | 'error', text: string): void;
+  readonly state: HostObservable<InputState>;
+}
+
+export interface ComposerAttachment {
+  kind: 'image' | 'file';
+  id: DraftAttachmentId;
+  file: File;
+  previewUrl?: string;
+}
+
+/** ctx.conversation（IConversation）公开面里我们消费的切面。 */
+export interface ConversationFace {
+  readonly input: { for(actx: unknown): SessionInput; shell(id: string): SessionInput & Record<string, unknown>; keyboard(id: string): ComposerKeyboard; inputTriggers(id: string): InputTriggerController | undefined };
+  createDrafts(sessionId: string, files: readonly File[]): readonly ComposerAttachment[];
+  releaseDraftAttachment(id: DraftAttachmentId): void;
+  releaseDraftAttachments(attachments: readonly ComposerAttachment[]): void;
+  resolveDraftAttachments(ids: readonly DraftAttachmentId[]): readonly ComposerAttachment[];
+  retryFileUpload(sessionId: string, id: DraftAttachmentId): void;
+  readonly fileUploads: HostObservable<Record<string, unknown>>;
+}
+
+export interface SessionBinding {
+  readonly session: {
+    command(line: string): Promise<{ ok: boolean; value?: { matched?: boolean } }>;
+  };
+}
+
+/** ctx.sessions（ISessions）公开面里我们消费的切面。 */
+export interface SessionsFace {
+  binding(id: string): SessionBinding | undefined;
+  scope(id: string): unknown;
+}
+
+// ---------- 右侧栏控制器（ctx.sidebarRight / ISidebarRight） ----------
+
+/** 一个已打开标签的记录（dockkit TabRecord 我们消费的切面）。 */
+export interface TabRecordLike {
+  readonly id: string;
+  readonly kind: string;
+}
+
+/**
+ * 右侧栏公开控制器。侧栏收起后要「唤回侧栏里的 Codinput」（展开 + 激活
+ * 该标签）只能经它——`openTabIn` 一次完成展开与聚焦（store 的
+ * openContent 内建 planSetExpanded(state, true)）；`toggleExpanded` 作为
+ * 退路（openTabIn 缺失时）。全部按鸭子类型调用。
+ */
+export interface SidebarRightFace {
+  isExpanded?(): boolean;
+  toggleExpanded?(): void;
+  openTab?(kind: string): void;
+  openTabIn?(sessionId: string, kind: string): void;
+  tabsIn?(sessionId: string): readonly TabRecordLike[];
+  focus?(tabId: string): void;
+}
+
+// ---------- commandUi popupSelect ----------
+
+export interface SelectOption {
+  readonly value?: unknown;
+  readonly label: string;
+  readonly detail?: string;
+  readonly [k: string]: unknown;
+}
+
+export interface PopupState {
+  readonly open: boolean;
+  readonly command: string | null;
+  readonly status: 'pending' | 'ready' | 'failed';
+  readonly options: readonly SelectOption[];
+  readonly search: string;
+  readonly active: number;
+  readonly submitting: boolean;
+  readonly confirming: SelectOption | null;
+  readonly acknowledged: boolean;
+  readonly error: string | null;
+}
+
+export interface PopupSelectController {
+  readonly state: HostObservable<PopupState>;
+  retry(): void;
+  setSearch(search: string): void;
+  move(dir: 1 | -1): void;
+  highlight(index: number): void;
+  select(index: number): Promise<void>;
+  acknowledge(acknowledged: boolean): void;
+  cancelConfirmation(): void;
+  confirm(): Promise<void>;
+  dismiss(opts?: { readonly focusComposer?: boolean }): void;
+}
+
+export interface CommandUiFace {
+  popupFor(actx: unknown): PopupSelectController;
+  bindComposerFocus(id: string, focus: () => void): () => void;
+}
+
+// ---------- model directory（web 外壳层服务，形状经防御归一化） ----------
+
+export interface ModelReasoningEffort { readonly id: string; readonly name: string; readonly description?: string }
+export interface ModelCatalogModel {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+  readonly reasoning?: { readonly efforts: readonly ModelReasoningEffort[]; readonly defaultEffort?: string };
+}
+export interface ModelProviderGroup { readonly id: string; readonly name: string; readonly models: readonly ModelCatalogModel[] }
+export interface ModelCatalog {
+  readonly default?: { readonly provider: string; readonly model: string; readonly reasoningEffort?: string };
+  readonly groups: readonly ModelProviderGroup[];
+}
+export interface ModelSelection { readonly provider: string; readonly model: string; readonly reasoningEffort?: string }
+
+/**
+ * 共享模型目录：与官方 /model 弹层同一状态源。服务形状不在本地包内
+ * （属 web 外壳层），读取按 ObservableSnapshot 兼容、写入按鸭子序探测。
+ */
+export interface ModelDirectoriesFace {
+  getSnapshot?(): unknown;
+  subscribe?(fn: () => void): () => void;
+  [key: string]: unknown;
+}
+
+// ---------- standard kit / settings / sidebar ----------
+
+export type SelectorHook<T> = <S>(sel: (s: T) => S) => S;
+
+/** 草稿镜像宿主内建投影：{ lastUsed, next }，next 为下一次请求将用的选择。 */
+export interface ModelSelectionProjection {
+  readonly lastUsed: ModelSelection | null;
+  readonly next: ModelSelection | null;
+}
+
+export interface UseProjection {
+  (key: string): unknown;
+}
+
+/** session-maybe 槽位标准 props（我们消费的切面）。 */
+export interface SessionMaybeStandard {
+  useSession: <S>(sel: (s: any) => S) => S | undefined;
+  sessionId: string | undefined;
+  useInput: <S>(sel: (s: InputState) => S) => S | undefined;
+  inputActions: InputActions | undefined;
+  useConversation?: <S>(sel: (s: any) => S) => S | undefined;
+  useProjection: UseProjection;
+}
+
+/** session 槽位标准 props（侧栏 body）。 */
+export interface SessionStandard {
+  useSession: <S>(sel: (s: any) => S) => S;
+  sessionId: string;
+  useInput: <S>(sel: (s: InputState) => S) => S;
+  inputActions: InputActions;
+  useProjection: UseProjection;
+}
+
+export interface SettingsSectionProps {
+  close: () => void;
+}
+
+/**
+ * sidebar.right.pane.tab 注入的 tabInfo hook（官方 useTabInfo）消费切面。
+ * `tab.visible` 是官方的标签可见判定：浮动恒可见；停靠需侧栏展开且为
+ * 激活标签（title 槽位才含未激活标签）。收起的侧栏是 CSS 隐藏、body
+ * 仍挂载，因此「主输入是否让位」必须读 visible 而非 body 挂载。
+ */
+export interface SidebarTabInfo {
+  readonly sidebar: { readonly expanded: boolean; readonly fullscreen: boolean };
+  readonly tab: { readonly visible: boolean };
+}