@blade-hq/agent-react 2612.0.0-beta.76 → 2612.0.0-beta.78

package/README.md

@@ -510,7 +510,7 @@ Questionnaire 负责必答校验、原生单选/多选、自填和前后分页
 
 `ConnectorConnection` 通过 `type="device"` 或 `type="managed"` 选择连接方式，并接收对应连接组件的宿主回调。
 
-`DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。宿主可用 `initialPage="manage"` 在首次挂载时直达管理页；尚未关联应用时仍进入连接入口，不会自动创建应用或授权。初始权限采用飞书平台默认模板及官方 CLI 推荐清单，不以机器人/本人身份或 SW 已实现能力筛选。权限状态按企业侧开通、本人授权分别展示，未知不等于拒绝；工作能力目录另外说明当前能执行的操作。
+`DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。未传 `detail` 的授权界面可用 `initialPage="manage"` 在首次挂载时直达管理页；尚未关联应用时仍进入连接入口，不会自动创建应用或授权。初始权限采用飞书平台默认模板及官方 CLI 推荐清单，不以机器人/本人身份或 SW 已实现能力筛选。权限状态按企业侧开通、本人授权分别展示，未知不等于拒绝；工作能力目录另外说明当前能执行的操作。
 
 首次关联应用后继续确认官方推荐的本人授权，允许两次扫码。企业审核要求以飞书页面为准；添加能力仍按当前操作核验和补充，核验失败保留连接与错误。统一授权流程按 `authorize` / `poll` 逐步展示当前飞书官方二维码，完成后显式 `finish`；PA 通过 `bindDelivery` 接入机器人消息，接入失败保留授权，可单独重试。完整分类选择在完成时替换启用集合，局部补权保留其他已选项；取消申请保留已有授权。增加能力时保留此助手原有停用状态，按钮显示“授权并保存”，暂停推送也不会被自动恢复。日志、历史步骤和原生错误编号放在连接帮助的高级排查内。
 
@@ -522,3 +522,17 @@ PA 等只需要授权界面的宿主可从 `@blade-hq/agent-react/connectors`
 `@blade-hq/agent-react/connectors` 的 `DeviceConnection` 可传 `autoAuthorize`：仅在用户主动打开聊天授权卡片时开始准备官方二维码，设置页默认仍手动发起。`authorizationCapabilities` 用于只补当前操作需要的能力；已有有效二维码会继续使用，不重复生成。生成二维码不代表用户授权或企业审核已通过。
 
 首次连接默认只申请机器人能力；需要本人能力时按操作补充授权。已有连接的选择和授权不受影响。
+
+### 连接器管理详情
+
+`ConnectorConnection` 的 `detail` 传入名称、图标和 `rules` 内容，使用共享的紧凑头部、更多操作、权限/诊断二级页与确认框。只在 PA 等拥有对应能力的宿主传入 `bindDelivery`、`detail.preferences`、`detail.onOpenPush`；不提供的能力不会生成空标签。停用只改变本地启用意图，移除才会清除托管凭据并停止收推，两者分别确认。
+
+普通 schema / 网页登录连接使用 `ConfigConnection`，宿主提供表单或登录内容、连接状态及已鉴权的动作回调。`ConnectorDetail` 可组合其他连接方式；动作可通过 `description` 提供菜单中的影响说明；动作类型为 `ConnectorDetailAction`，宿主插槽类型为 `ConnectorDetailOptions`，签名见 [公开 API](public-api.md)。切换连接器或认证身份时按身份重建组件，授权轮询只由连接组件持有。
+
+源码集成时扫描新增的 `ConnectorDetail.tsx` / `ConfigConnection.tsx`、使用的 UI composites；Shadow DOM 宿主沿用 `OverlayRootProvider`。生产集成保留浏览器与 schema 表单的按需加载，不为使用详情而加载整套聊天 UI。
+
+### ConnectorRulesPanel
+
+从 `@blade-hq/agent-react/connectors` 导入 `ConnectorRulesPanel`，传入稳定的 `read` 和 `update` 回调（调用 `client.connectors.rules/updateRules`）。组件展示分组、分类、三档设置与恢复默认；保存成功才替换当前值，失败保留原设置。宿主通过 `className` 与继承主题接入已有样式；`onCountChange` 返回可设置规则组数。详情中的 `compact` 隐藏重复标题，并默认显示第一个业务分类；仍可选择全部及恢复所有分类的默认设置。
+
+连接器宿主可通过 `ConnectorDetailOptions.name` 提供连接器名。飞书待开通权限提醒按连接器名、连接身份与权限集合摘要记忆展开状态；缺失权限归零时清理该连接器的旧记录；直接组合 `ConnectorDetail` 时可用 `noticeStorageKey` 指定本地记忆键。localStorage 不可用时保留内存内交互。

package/dist/SessionPluginConfigForm-7LJ5SUNY.js

@@ -0,0 +1,9 @@
+import {
+  SessionPluginConfigForm
+} from "./chunk-SK43YNRX.js";
+import "./chunk-KHJEIHMJ.js";
+import "./chunk-PR4QN5HX.js";
+export {
+  SessionPluginConfigForm
+};
+//# sourceMappingURL=SessionPluginConfigForm-7LJ5SUNY.js.map

package/dist/SessionPluginConfigForm-7LJ5SUNY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chat/LiteMessageList.d.ts

@@ -52,6 +52,10 @@ type ContextDividerRow = {
 type LiteRow = {
     type: "background-wakeup";
     key: string;
+} | {
+    type: "pack-event";
+    key: string;
+    title: string;
 } | TextRow | MemoryRefsRow | FollowupRow | HistoricalFeedbackRow | QuestionRow | ToolDescriptionRow | ContextGroupRow | ContextDividerRow;
 export declare function buildLiteRows({ messages, followup, sessionMessages, agentLoops, resultFeedbackByEntry, showContexts, }: {
     messages: ChatMessage[];

package/dist/chat/TurnNavRail.d.ts

@@ -1,7 +1,4 @@
-export interface TurnNavItem {
-    id: string;
-    title: string;
-}
+import type { TurnNavItem } from "../hooks/use-turn-navigation";
 interface TurnNavRailProps {
     items: TurnNavItem[];
     activeTurnId: string | null;

package/dist/chat/index.d.ts

@@ -27,7 +27,8 @@ export { TextAttachmentPills } from "./TextAttachmentPills";
 export { getFilePreviewName, ToolFilePreviewAction, ToolPreviewAction, resolveAskQuestionState, ToolCallBlock } from "./ToolCallBlock";
 export { ToolUiCard } from "./ToolUiCard";
 export { TurnNavRail } from "./TurnNavRail";
-export type { TurnNavItem } from "./TurnNavRail";
+export { turnLocateChannel, useTurnLocateRequest, useTurnLocateStatus } from "./turn-locate-channel";
+export type { TurnLocateRequest, TurnLocateStatus } from "./turn-locate-channel";
 export { isUserMessage, isErrorMessage, USER_MESSAGE_MARKDOWN_CLASS, UserMessageBubble, ErrorMessageBlock } from "./UserMessageBubble";
 export type { UserChatMessage, ErrorChatMessage } from "./UserMessageBubble";
 export { WorkflowRunBlock } from "./WorkflowRunBlock";

package/dist/chat/turn-locate-channel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 跨组件「定位到某条发言」的请求通道。
+ *
+ * 消息列表（MessageList）与右侧脉络面板不在同一棵组件树里，而定位到窗口外
+ * 的历史发言需要 MessageList 内部的虚拟列表状态（isEntryLoaded / revealEntry /
+ * 滚动容器），脉络面板拿不到这些。这里用一个模块级 store 把「点击脉络里的
+ * 某条发言」变成一条带序号的信令，MessageList 监听后在它自己的
+ * useTurnNavigation.selectEntry 里执行完整定位（跨页加载 + 滚动 + 高亮）。
+ *
+ * 与 composer-channels 同一模式：module singleton + 订阅回调，
+ * 不依赖任何宿主 store，SDK 内可复用。
+ */
+export interface TurnLocateRequest {
+    entryId: string;
+    /** 单调递增，避免「同一条发言点两次」或「晚到的旧信号」被误判成新请求。 */
+    seq: number;
+}
+/** 执行侧回传的进度：面板据此显示「正在定位」/失败提示。 */
+export interface TurnLocateStatus {
+    seq: number;
+    entryId: string;
+    state: "pending" | "failed";
+}
+export declare const turnLocateChannel: {
+    getState: () => Record<string, TurnLocateRequest>;
+    getStatus: () => Record<string, TurnLocateStatus>;
+    request(sessionId: string, entryId: string): void;
+    /** 执行侧回传进度；只有最新一次请求的结果会被接受。 */
+    report(sessionId: string, seq: number, state: TurnLocateStatus["state"]): void;
+    /** 定位完成（成功）：清掉进度，面板不再显示「正在定位」。 */
+    clearStatus(sessionId: string, seq: number): void;
+    subscribe(listener: () => void): () => void;
+    /** 某条信令已被消费：同 seq 不再重复定位（避免重新挂载时又跳一次）。 */
+    consume(sessionId: string, seq: number): void;
+    /** 只清进度、不动未消费的请求（列表卸载时用）。 */
+    clearStatusForSession(sessionId: string): void;
+    clearSession(sessionId: string): void;
+    reset(): void;
+};
+/**
+ * 订阅某个会话的定位请求。
+ *
+ * 用「命令式订阅 + useState」而不是 useSyncExternalStore：每条信令都是一次
+ * **一次性事件**（点一下就执行一次），store 里不留状态，消费完立即清空。
+ * useSyncExternalStore 要的是「可重复读取的快照」，在这种事件通道上反而容易
+ * 因为快照被清空/重读而漏掉那一次更新。
+ */
+export declare function useTurnLocateRequest(sessionId: string | null | undefined): TurnLocateRequest | null;
+/**
+ * 订阅某个会话最近一次定位的进度。面板用它显示「正在定位」和失败提示——
+ * 定位实际由消息列表执行，面板自己的 useTurnNavigation 拿不到这份状态。
+ */
+export declare function useTurnLocateStatus(sessionId: string | null | undefined): TurnLocateStatus | null;