@aipanel/core 1.2.10 → 1.2.12

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

@@ -26,6 +26,8 @@ export interface ChatSession {
 }
 /** 会话运行状态 */
 export type SessionStatus = "idle" | "running" | "streaming" | "completed";
+/** 会话等待用户交互的类型（对齐 dsh host approval/request 与 user-questions/request） */
+export type SessionPendingKind = "approval" | "plan-review" | "question";
 /** Provider 事件（Provider 私有事件 → 归一化，客户端只消费这些事件） */
 export type ProviderEvent = {
     type: "connected";
@@ -46,6 +48,19 @@ export type ProviderEvent = {
     type: "thinking";
     sessionId: string;
     thinking: boolean;
+}
+/** 会话等待用户交互（审批/提问/计划评审）开始或结束 */
+ | {
+    type: "session.pending";
+    sessionId: string;
+    pending: boolean;
+    kind?: SessionPendingKind;
+}
+/** 父会话的进行中子代理数（>0 表示有子代理在跑；自身 idle 时 UI 仍显示进行中） */
+ | {
+    type: "session.subagents";
+    sessionId: string;
+    running: number;
 };
 /** Provider 环境检查结果 */
 export interface ProviderEnvironmentInfo {
@@ -137,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 { SessionStatus } from "./provider";
+import type { ProviderSidebarCollapseControl, SessionPendingKind, SessionStatus } from "./provider";
 /**
  * 展示模式类型
  */
@@ -127,13 +127,24 @@ export type ServiceStatus = "idle" | "starting" | "ready" | "partial" | "failed"
  * Session 状态类型（别名：以 ./provider 的 SessionStatus 为单一来源）
  */
 export type AIPanelSessionStatusType = SessionStatus;
+/**
+ * Session 交互状态（单一来源：./types.ts 定义，事件载荷类型见 ./provider.ts 的 SessionPendingKind）
+ */
+export type AIPanelSessionPendingKind = SessionPendingKind;
 /**
  * Session 思考状态
  */
 export interface AIPanelSessionThinkingState {
     thinking: boolean;
     statusType: AIPanelSessionStatusType;
+    /** 是否存在待用户交互（审批/提问/计划评审）；pending 优先级高于 thinking */
     hasPending: boolean;
+    /** 待交互类型（hasPending=true 时有值；单一来源 ./provider.ts） */
+    pendingKind?: AIPanelSessionPendingKind;
+    /** 是否刚运行完成（client 端由 running→idle 边沿且非当前选中推导；对齐官方 completed 提醒语义） */
+    completed?: boolean;
+    /** 进行中的子代理数（>0 时即使自身 idle 也视为"在跑"；源：session.subagents） */
+    subagentsRunning?: number;
 }
 /**
  * 挂件会话信息
@@ -248,6 +259,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

@@ -26,6 +26,8 @@ export interface ChatSession {
 }
 /** 会话运行状态 */
 export type SessionStatus = "idle" | "running" | "streaming" | "completed";
+/** 会话等待用户交互的类型（对齐 dsh host approval/request 与 user-questions/request） */
+export type SessionPendingKind = "approval" | "plan-review" | "question";
 /** Provider 事件（Provider 私有事件 → 归一化，客户端只消费这些事件） */
 export type ProviderEvent = {
     type: "connected";
@@ -46,6 +48,19 @@ export type ProviderEvent = {
     type: "thinking";
     sessionId: string;
     thinking: boolean;
+}
+/** 会话等待用户交互（审批/提问/计划评审）开始或结束 */
+ | {
+    type: "session.pending";
+    sessionId: string;
+    pending: boolean;
+    kind?: SessionPendingKind;
+}
+/** 父会话的进行中子代理数（>0 表示有子代理在跑；自身 idle 时 UI 仍显示进行中） */
+ | {
+    type: "session.subagents";
+    sessionId: string;
+    running: number;
 };
 /** Provider 环境检查结果 */
 export interface ProviderEnvironmentInfo {
@@ -137,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 { SessionStatus } from "./provider";
+import type { ProviderSidebarCollapseControl, SessionPendingKind, SessionStatus } from "./provider";
 /**
  * 展示模式类型
  */
@@ -127,13 +127,24 @@ export type ServiceStatus = "idle" | "starting" | "ready" | "partial" | "failed"
  * Session 状态类型（别名：以 ./provider 的 SessionStatus 为单一来源）
  */
 export type AIPanelSessionStatusType = SessionStatus;
+/**
+ * Session 交互状态（单一来源：./types.ts 定义，事件载荷类型见 ./provider.ts 的 SessionPendingKind）
+ */
+export type AIPanelSessionPendingKind = SessionPendingKind;
 /**
  * Session 思考状态
  */
 export interface AIPanelSessionThinkingState {
     thinking: boolean;
     statusType: AIPanelSessionStatusType;
+    /** 是否存在待用户交互（审批/提问/计划评审）；pending 优先级高于 thinking */
     hasPending: boolean;
+    /** 待交互类型（hasPending=true 时有值；单一来源 ./provider.ts） */
+    pendingKind?: AIPanelSessionPendingKind;
+    /** 是否刚运行完成（client 端由 running→idle 边沿且非当前选中推导；对齐官方 completed 提醒语义） */
+    completed?: boolean;
+    /** 进行中的子代理数（>0 时即使自身 idle 也视为"在跑"；源：session.subagents） */
+    subagentsRunning?: number;
 }
 /**
  * 挂件会话信息
@@ -248,6 +259,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.10",
+  "version": "1.2.12",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",