@aipanel/core 1.2.11 → 1.2.13

package/es/common/constants.d.ts

@@ -108,6 +108,12 @@ export declare const WIDGET_MSG: {
     readonly MINIMIZE_STATE: "MINIMIZE_STATE_CHANGE";
     readonly PROMPT_DOCK_VISIBILITY: "PROMPT_DOCK_VISIBILITY_CHANGE";
     readonly REVIEW_PANEL_TOGGLE: "REVIEW_PANEL_TOGGLE";
+    /** 宿主 → iframe：告知侧栏归属期望（mode: "host" | "provider"），Provider 据此决定是否展示自家侧栏 */
+    readonly SIDEBAR_MODE: "AIPANEL_SIDEBAR_MODE";
+    /** 宿主 → iframe：host 折叠开关驱动 Provider 收起/展开自家侧栏（{ collapsed }） */
+    readonly SIDEBAR_COLLAPSE: "AIPANEL_SIDEBAR_COLLAPSE";
+    /** iframe → 宿主（可选）：Provider 内部折叠变化回传（{ collapsed }），供宿主同步左上角开关状态 */
+    readonly SIDEBAR_STATE: "AIPANEL_SIDEBAR_STATE";
     /** 无 deepLink 能力的 Provider：通知 iframe 聚焦指定会话 */
     readonly FOCUS_SESSION: "AIPANEL_FOCUS_SESSION";
     /** 无 deepLink 能力的 Provider：iframe 确认目标会话已激活且渲染稳定（携带 sessionId） */

package/es/common/constants.mjs

@@ -57,6 +57,12 @@ const WIDGET_MSG = {
   MINIMIZE_STATE: "MINIMIZE_STATE_CHANGE",
   PROMPT_DOCK_VISIBILITY: "PROMPT_DOCK_VISIBILITY_CHANGE",
   REVIEW_PANEL_TOGGLE: "REVIEW_PANEL_TOGGLE",
+  /** 宿主 → iframe：告知侧栏归属期望（mode: "host" | "provider"），Provider 据此决定是否展示自家侧栏 */
+  SIDEBAR_MODE: "AIPANEL_SIDEBAR_MODE",
+  /** 宿主 → iframe：host 折叠开关驱动 Provider 收起/展开自家侧栏（{ collapsed }） */
+  SIDEBAR_COLLAPSE: "AIPANEL_SIDEBAR_COLLAPSE",
+  /** iframe → 宿主（可选）：Provider 内部折叠变化回传（{ collapsed }），供宿主同步左上角开关状态 */
+  SIDEBAR_STATE: "AIPANEL_SIDEBAR_STATE",
   /** 无 deepLink 能力的 Provider：通知 iframe 聚焦指定会话 */
   FOCUS_SESSION: "AIPANEL_FOCUS_SESSION",
   /** 无 deepLink 能力的 Provider：iframe 确认目标会话已激活且渲染稳定（携带 sessionId） */

package/es/common/provider.d.ts

@@ -152,6 +152,30 @@ export interface ProviderCapabilities {
      * 缺省/false：不支持，客户端隐藏该按钮，避免展示无功能的入口。
      */
     reviewPanel?: boolean;
+    /**
+     * Provider 是否接管会话侧栏（会话列表栏）。
+     * 缺省/false：宿主渲染原生会话列表（现状）；true：宿主隐藏原生列表，
+     * Provider 自家侧栏接管会话导航，折叠开关归属见 ProviderSidebarCapability.collapseControl。
+     */
+    sidebar?: ProviderSidebarCapability;
+}
+/** Provider 侧栏折叠开关归属（谁提供折叠控制） */
+export type ProviderSidebarCollapseControl = "host" | "provider";
+/** Provider 接管会话侧栏（会话列表栏）的能力描述 */
+export interface ProviderSidebarCapability {
+    /**
+     * Provider 自身 Web UI 自带会话侧栏并接管（宿主不再渲染原生会话列表）。
+     * true：宿主隐藏原生 SessionList，Provider 自家侧栏在 iframe 内渲染并负责会话导航；
+     * 缺省/false：宿主渲染原生会话列表（现状），Provider 侧应隐藏自家侧栏避免重复（如 dsh）。
+     */
+    takeover?: boolean;
+    /**
+     * 折叠开关归属（仅 takeover=true 时生效）：
+     * - "host"（缺省）：宿主保留左上角开关，切换时向 iframe 发送 SIDEBAR_COLLAPSE，
+     *   由 Provider 收起/展开自家侧栏；
+     * - "provider"：Provider 自带折叠开关，宿主隐藏左上角按钮且不下发折叠消息。
+     */
+    collapseControl?: ProviderSidebarCollapseControl;
 }
 /**
  * Web Provider 适配器接口

package/es/common/types.d.ts

@@ -2,7 +2,7 @@
  * 通用类型（Provider 无关）
  * Provider 专属类型已下沉至 @aipanel/provider-opencode。
  */
-import type { SessionPendingKind, SessionStatus } from "./provider";
+import type { ProviderSidebarCollapseControl, SessionPendingKind, SessionStatus } from "./provider";
 /**
  * 展示模式类型
  */
@@ -46,6 +46,8 @@ export interface WidgetOptions {
     splitMode?: SplitModeOptions;
     /** Vite 服务 Web 端口（扩展模式多实例场景用） */
     vitePort?: string;
+    /** Vite 服务绑定主机（由服务端/探测下发；缺省回退 DEFAULT_HOSTNAME）。避免与 vite 实际绑定的地址族不一致 */
+    viteHost?: string;
     /** 服务实例唯一标识（扩展模式多实例隔离用） */
     serviceInstanceId?: string;
     /** 当前窗口 ID（扩展模式多窗口隔离用） */
@@ -214,6 +216,8 @@ export interface AIPanelServiceInfo {
     proxyPort: number;
     /** Vite 开发服务端口（字符串；可能来自 widget 上报或探测 origin） */
     vitePort: string;
+    /** Vite 开发服务主机（源自探测 origin 的 hostname；扩展侧连接用，避免 127.0.0.1 与 ::1 地址族错位） */
+    viteHost: string;
     /** 项目根目录 */
     projectRoot: string;
     /** 服务实例唯一 id（多实例隔离） */
@@ -259,6 +263,14 @@ export interface AIPanelWidgetProps {
     hideBubble?: boolean;
     /** 是否支持代码审查面板（右上角 </> 按钮）；由 Provider capabilities.reviewPanel 决定 */
     reviewPanelEnabled?: boolean;
+    /** Provider 接管会话侧栏（隐藏原生会话列表，Provider 自家侧栏在 iframe 内渲染）；由 Provider capabilities.sidebar.takeover 决定 */
+    providerSidebar?: boolean;
+    /**
+     * 侧栏折叠开关归属（默认 "host"）：
+     * host：宿主保留左上角开关并驱动折叠；provider：宿主隐藏左上角按钮，由 Provider 自带开关控制。
+     * 仅 providerSidebar=true 时生效；由 Provider capabilities.sidebar.collapseControl 决定。
+     */
+    sidebarCollapseControl?: ProviderSidebarCollapseControl;
 }
 /**
  * 挂件组件事件

package/lib/common/constants.cjs

@@ -125,6 +125,12 @@ const WIDGET_MSG = {
   MINIMIZE_STATE: "MINIMIZE_STATE_CHANGE",
   PROMPT_DOCK_VISIBILITY: "PROMPT_DOCK_VISIBILITY_CHANGE",
   REVIEW_PANEL_TOGGLE: "REVIEW_PANEL_TOGGLE",
+  /** 宿主 → iframe：告知侧栏归属期望（mode: "host" | "provider"），Provider 据此决定是否展示自家侧栏 */
+  SIDEBAR_MODE: "AIPANEL_SIDEBAR_MODE",
+  /** 宿主 → iframe：host 折叠开关驱动 Provider 收起/展开自家侧栏（{ collapsed }） */
+  SIDEBAR_COLLAPSE: "AIPANEL_SIDEBAR_COLLAPSE",
+  /** iframe → 宿主（可选）：Provider 内部折叠变化回传（{ collapsed }），供宿主同步左上角开关状态 */
+  SIDEBAR_STATE: "AIPANEL_SIDEBAR_STATE",
   /** 无 deepLink 能力的 Provider：通知 iframe 聚焦指定会话 */
   FOCUS_SESSION: "AIPANEL_FOCUS_SESSION",
   /** 无 deepLink 能力的 Provider：iframe 确认目标会话已激活且渲染稳定（携带 sessionId） */

package/lib/common/constants.d.ts

@@ -108,6 +108,12 @@ export declare const WIDGET_MSG: {
     readonly MINIMIZE_STATE: "MINIMIZE_STATE_CHANGE";
     readonly PROMPT_DOCK_VISIBILITY: "PROMPT_DOCK_VISIBILITY_CHANGE";
     readonly REVIEW_PANEL_TOGGLE: "REVIEW_PANEL_TOGGLE";
+    /** 宿主 → iframe：告知侧栏归属期望（mode: "host" | "provider"），Provider 据此决定是否展示自家侧栏 */
+    readonly SIDEBAR_MODE: "AIPANEL_SIDEBAR_MODE";
+    /** 宿主 → iframe：host 折叠开关驱动 Provider 收起/展开自家侧栏（{ collapsed }） */
+    readonly SIDEBAR_COLLAPSE: "AIPANEL_SIDEBAR_COLLAPSE";
+    /** iframe → 宿主（可选）：Provider 内部折叠变化回传（{ collapsed }），供宿主同步左上角开关状态 */
+    readonly SIDEBAR_STATE: "AIPANEL_SIDEBAR_STATE";
     /** 无 deepLink 能力的 Provider：通知 iframe 聚焦指定会话 */
     readonly FOCUS_SESSION: "AIPANEL_FOCUS_SESSION";
     /** 无 deepLink 能力的 Provider：iframe 确认目标会话已激活且渲染稳定（携带 sessionId） */

package/lib/common/provider.d.ts

@@ -152,6 +152,30 @@ export interface ProviderCapabilities {
      * 缺省/false：不支持，客户端隐藏该按钮，避免展示无功能的入口。
      */
     reviewPanel?: boolean;
+    /**
+     * Provider 是否接管会话侧栏（会话列表栏）。
+     * 缺省/false：宿主渲染原生会话列表（现状）；true：宿主隐藏原生列表，
+     * Provider 自家侧栏接管会话导航，折叠开关归属见 ProviderSidebarCapability.collapseControl。
+     */
+    sidebar?: ProviderSidebarCapability;
+}
+/** Provider 侧栏折叠开关归属（谁提供折叠控制） */
+export type ProviderSidebarCollapseControl = "host" | "provider";
+/** Provider 接管会话侧栏（会话列表栏）的能力描述 */
+export interface ProviderSidebarCapability {
+    /**
+     * Provider 自身 Web UI 自带会话侧栏并接管（宿主不再渲染原生会话列表）。
+     * true：宿主隐藏原生 SessionList，Provider 自家侧栏在 iframe 内渲染并负责会话导航；
+     * 缺省/false：宿主渲染原生会话列表（现状），Provider 侧应隐藏自家侧栏避免重复（如 dsh）。
+     */
+    takeover?: boolean;
+    /**
+     * 折叠开关归属（仅 takeover=true 时生效）：
+     * - "host"（缺省）：宿主保留左上角开关，切换时向 iframe 发送 SIDEBAR_COLLAPSE，
+     *   由 Provider 收起/展开自家侧栏；
+     * - "provider"：Provider 自带折叠开关，宿主隐藏左上角按钮且不下发折叠消息。
+     */
+    collapseControl?: ProviderSidebarCollapseControl;
 }
 /**
  * Web Provider 适配器接口

package/lib/common/types.d.ts

@@ -2,7 +2,7 @@
  * 通用类型（Provider 无关）
  * Provider 专属类型已下沉至 @aipanel/provider-opencode。
  */
-import type { SessionPendingKind, SessionStatus } from "./provider";
+import type { ProviderSidebarCollapseControl, SessionPendingKind, SessionStatus } from "./provider";
 /**
  * 展示模式类型
  */
@@ -46,6 +46,8 @@ export interface WidgetOptions {
     splitMode?: SplitModeOptions;
     /** Vite 服务 Web 端口（扩展模式多实例场景用） */
     vitePort?: string;
+    /** Vite 服务绑定主机（由服务端/探测下发；缺省回退 DEFAULT_HOSTNAME）。避免与 vite 实际绑定的地址族不一致 */
+    viteHost?: string;
     /** 服务实例唯一标识（扩展模式多实例隔离用） */
     serviceInstanceId?: string;
     /** 当前窗口 ID（扩展模式多窗口隔离用） */
@@ -214,6 +216,8 @@ export interface AIPanelServiceInfo {
     proxyPort: number;
     /** Vite 开发服务端口（字符串；可能来自 widget 上报或探测 origin） */
     vitePort: string;
+    /** Vite 开发服务主机（源自探测 origin 的 hostname；扩展侧连接用，避免 127.0.0.1 与 ::1 地址族错位） */
+    viteHost: string;
     /** 项目根目录 */
     projectRoot: string;
     /** 服务实例唯一 id（多实例隔离） */
@@ -259,6 +263,14 @@ export interface AIPanelWidgetProps {
     hideBubble?: boolean;
     /** 是否支持代码审查面板（右上角 </> 按钮）；由 Provider capabilities.reviewPanel 决定 */
     reviewPanelEnabled?: boolean;
+    /** Provider 接管会话侧栏（隐藏原生会话列表，Provider 自家侧栏在 iframe 内渲染）；由 Provider capabilities.sidebar.takeover 决定 */
+    providerSidebar?: boolean;
+    /**
+     * 侧栏折叠开关归属（默认 "host"）：
+     * host：宿主保留左上角开关并驱动折叠；provider：宿主隐藏左上角按钮，由 Provider 自带开关控制。
+     * 仅 providerSidebar=true 时生效；由 Provider capabilities.sidebar.collapseControl 决定。
+     */
+    sidebarCollapseControl?: ProviderSidebarCollapseControl;
 }
 /**
  * 挂件组件事件

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.11",
+  "version": "1.2.13",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",