@blade-hq/agent-react 2610.0.0-beta.57 → 2610.0.0-beta.59

package/README.md

@@ -387,7 +387,8 @@ blade-chat { --primary: 262 83% 58%; height: 640px; }
 ## 附录：连接器与插件选择
 
 - **连接器面板**：`ConnectorPanel`、`ConnectorPanelProps`、`PluginConnectorList`、`PluginConnectorListProps`、`ConfiguringPlugin`
-- **插件行与触发器**：`PluginConnectorItem`、`PluginConnectorSelection`、`selectionFromItem`、`triggerSummary`、`TriggerSummary`、`TRIGGER_ICON_LIMIT`、`mergeConnectorItems`、`catalogToConnectorItems`、`filterConnectorItems`、`pluginConnectorSummary`
+- **插件行与触发器**：`PluginConnectorItem`、`PluginConnectorSelection`、`selectionFromItem`、`triggerSummary`、`TriggerSummary`、`TRIGGER_ICON_LIMIT`、`mergeConnectorItems`、`catalogToConnectorItems`、`filterConnectorItems`
+- **触发器上的头像堆叠**：`PluginTriggerStack`、`PluginTriggerStackProps`（前三枚插件头像 + `+N`，宿主自己画触发器时用它，不要另写一份折叠）
 - **启用时序**：`useSessionPluginActivation`、`UseSessionPluginActivationResult`
 
 ## 附录：re-export 自 @blade-hq/agent-client
@@ -424,7 +425,7 @@ blade-chat { --primary: 262 83% 58%; height: 640px; }
 
 插件行的渲染交给 `<PluginConnectorList>`（`PluginConnectorListProps`），它只负责样式与排版：
 "该显示成什么"全部来自 `PluginConnectorItem`、`mergeConnectorItems`、`catalogToConnectorItems`、
-`filterConnectorItems` 与 `pluginConnectorSummary`，判定不各写一份。`sessionPluginLabel` 决定
+`filterConnectorItems`，判定不各写一份。`sessionPluginLabel` 决定
 一行读起来是什么名字。
 
 启用时序由 `useSessionPluginActivation` 收口（返回值类型 `UseSessionPluginActivationResult`）：

package/dist/components/ConnectorPanel.d.ts

@@ -27,7 +27,7 @@ export interface ConnectorPanelProps {
     renderComputerSection?: (query: string) => ReactNode;
     /** 宿主注入：外部账号分区（飞书 / GitHub 等固定连接入口）。 */
     renderExternalAccounts?: (query: string) => ReactNode;
-    /** 宿主注入：底部操作（添加连接器 / 管理连接器）。 */
+    /** 宿主注入：底部操作区；不注入就不渲染这一块。 */
     renderFooterActions?: () => ReactNode;
     className?: string;
 }

package/dist/components/PluginTriggerStack.d.ts

@@ -0,0 +1,22 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+import type { TriggerSummary } from "./connector-panel-types";
+export interface PluginTriggerStackProps {
+    client: BladeClient;
+    /** 会话内图标走会话接口；首页待选传 `null`（走账号级目录图标）。 */
+    sessionId: string | null;
+    /** 折叠结果，来自 `triggerSummary`——折叠规则只有那一处。 */
+    summary: TriggerSummary;
+    className?: string;
+}
+/**
+ * 触发器上的插件头像堆叠：前三枚圆形头像 + 其余折成 `+N`。
+ *
+ * 没有图标 token 的插件也用显示名首字占一枚圆——它和别的插件长得不一样，
+ * 「我选过它」就看得见；早先把这类项直接剔掉，选中后入口毫无变化。
+ *
+ * 圆环色取 `--background`（盖住被压住的那枚），与整站头像堆叠同一约定，见
+ * `apps/web/src/components/agent-board/ProjectMembers.tsx`：容器没有自己的底色时，
+ * 环就等于容器露出来的那层底。图标裁成圆形：插件 logo 多是方的，套在圆按钮里
+ * 「方套圆」才是那个视觉冲突的来源。
+ */
+export declare function PluginTriggerStack({ client, sessionId, summary, className }: PluginTriggerStackProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/SessionPluginIcon.d.ts

@@ -7,6 +7,13 @@ export interface SessionPluginIconProps {
      */
     sessionId: string | null;
     plugin: Pick<SessionPlugin, "name" | "icon">;
+    /** 边长，默认 20。 */
+    size?: number;
+    /**
+     * 外框形状：`rounded`（默认，面板列表里的小方角）或 `circle`（触发器上的头像堆叠）。
+     * 默认值不动，避免改到列表与第三方接入方的观感。
+     */
+    shape?: "rounded" | "circle";
     className?: string;
 }
 export interface SessionPluginLabelProps {
@@ -20,4 +27,4 @@ export interface SessionPluginLabelProps {
  */
 export declare function sessionPluginLabel(plugin: Pick<SessionPlugin, "name" | "display_name">): string;
 /** Package-local plugin icon, with a stable generic placeholder. */
-export declare function SessionPluginIcon({ client, sessionId, plugin, className }: SessionPluginIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function SessionPluginIcon({ client, sessionId, plugin, size, shape, className }: SessionPluginIconProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionQueuePanel.d.ts

@@ -2,7 +2,7 @@ import { type QueuedMessage, type SessionQueueSnapshot } from "@blade-hq/agent-c
 import { type JSX } from "react";
 export interface SessionQueuePanelProps {
     snapshot: SessionQueueSnapshot;
-    /** 当前是否有可接收补充的运行任务（决定「立即补充」是否可用） */
+    /** 当前是否有可接收补充的运行任务（决定「立刻发送」是否可用） */
     canDeliver: boolean;
     /** 正在等服务端确认的条目 id：禁用该条目的操作，避免重复提交 */
     pendingItemId?: string | null;
@@ -19,7 +19,11 @@ export interface SessionQueuePanelProps {
 /**
  * 会话消息队列面板：输入框上方的「待执行 · N」区域。
  *
+ * 一行一条：左边三条横向的拖动手柄、中间单行截断的正文、右边 hover 才出现的操作
+ * （立刻发送 / 编辑 / 删除）。顺序靠拖动整行调整，手柄上也能用 Alt+↑/↓ 调（键盘
+ * 可达性不能因为去掉上下箭头按钮就没了）。
+ *
  * 纯展示组件，不持有会话状态；能否编辑/删除/补充全部用 agent-client 的判定函数，
- * 不在本包重写一份。上移/下移、拖动排序最终都由调用方提交完整的 pending id 顺序。
+ * 不在本包重写一份。拖动与键盘调整最终都由调用方提交完整的 pending id 顺序。
  */
 export declare function SessionQueuePanel({ snapshot, canDeliver, pendingItemId, notice, onResume, onCancel, onEdit, onRequeue, onMove, onReorder, onDeliver, }: SessionQueuePanelProps): JSX.Element | null;

package/dist/components/connector-panel-types.d.ts

@@ -16,20 +16,22 @@ export interface PluginConnectorSelection {
 }
 /** 面板一行 → 待选条目。 */
 export declare function selectionFromItem(item: PluginConnectorItem): PluginConnectorSelection;
-/** 触发器上最多直接显示几个插件图标，其余折成数量。 */
+/** 触发器上最多直接显示几个插件头像，其余折成数量。 */
 export declare const TRIGGER_ICON_LIMIT = 3;
-/** 触发器要显示的内容：要么是若干图标加一个数量，要么是一个通用图标。 */
+/** 触发器上的头像堆叠内容：前三个 + 折起来的数量。 */
 export interface TriggerSummary {
-    icons: Array<Pick<PluginConnectorSelection, "name" | "icon" | "iconSource">>;
-    /** 超出 TRIGGER_ICON_LIMIT 的数量；0 表示不显示角标。 */
+    /** 前 TRIGGER_ICON_LIMIT 个选中项，**不管有没有图标 token**。 */
+    visible: Array<Pick<PluginConnectorSelection, "name" | "displayName" | "icon" | "iconSource">>;
+    /** 超出 TRIGGER_ICON_LIMIT 的数量；0 表示不显示 `+N`。 */
     overflow: number;
     /** 已选/已启用的总数，用于无障碍标签与提示。 */
     total: number;
 }
 /**
- * 把一份插件列表折成触发器上的显示内容。
+ * 把一份插件列表折成触发器上的头像堆叠。
  *
- * 图标 token 为空的项不占图标位——占位图标连成一排只会让人误以为自己选了三个
- * 不同的东西；它们仍计入数量。
+ * 前三项都占位，**不管有没有图标 token**：没有图标的用显示名首字起头的圆形占位，
+ * 「选了哪个」照样看得见。早先的实现把无图标的项从图标位里剔掉、还把它们算进
+ * `overflow`，于是选中一个没有图标的插件时触发器毫无变化——选择在入口上不可见。
  */
-export declare function triggerSummary(items: Array<Pick<PluginConnectorSelection, "name" | "icon" | "iconSource">>): TriggerSummary;
+export declare function triggerSummary(items: Array<Pick<PluginConnectorSelection, "name" | "displayName" | "icon" | "iconSource">>): TriggerSummary;

package/dist/components/plugin-connector.d.ts

@@ -36,6 +36,5 @@ export declare function mergeConnectorItems(sessionPlugins: SessionPlugin[], cat
  * `unchecked` 刻意没有文案：列表没有读过用户的 Home，说任何话都是噪音，
  * 入口是开关本身。
  */
-export declare function pluginConnectorSummary(state: string | undefined): string | null;
 /** 按名称和显示名做本地过滤；空查询返回全部。 */
 export declare function filterConnectorItems(items: PluginConnectorItem[], query: string): PluginConnectorItem[];

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { PluginConnectorList } from "./components/PluginConnectorList";
 export type { ConfiguringPlugin, PluginConnectorListProps } from "./components/PluginConnectorList";
 export { useSessionPluginActivation } from "./components/use-session-plugin-activation";
 export type { UseSessionPluginActivationResult } from "./components/use-session-plugin-activation";
-export { catalogToConnectorItems, filterConnectorItems, mergeConnectorItems, pluginConnectorSummary, } from "./components/plugin-connector";
+export { catalogToConnectorItems, filterConnectorItems, mergeConnectorItems, } from "./components/plugin-connector";
 export type { PluginConnectorItem } from "./components/plugin-connector";
 export { selectionFromItem, triggerSummary, TRIGGER_ICON_LIMIT } from "./components/connector-panel-types";
 export type { PluginConnectorSelection, TriggerSummary, } from "./components/connector-panel-types";
@@ -24,6 +24,8 @@ export { SessionPluginSelector } from "./components/SessionPluginSelector";
 export type { SessionPluginSelectorProps } from "./components/SessionPluginSelector";
 export { SessionPluginIcon, sessionPluginLabel } from "./components/SessionPluginIcon";
 export type { SessionPluginIconProps, SessionPluginLabelProps } from "./components/SessionPluginIcon";
+export { PluginTriggerStack } from "./components/PluginTriggerStack";
+export type { PluginTriggerStackProps } from "./components/PluginTriggerStack";
 export { SessionPluginConfigDialog } from "./components/SessionPluginConfigDialog";
 export type { SessionPluginConfigDialogProps } from "./components/SessionPluginConfigDialog";
 export { SessionPluginConfigForm } from "./components/SessionPluginConfigForm";