@blade-hq/agent-react 2612.0.0-beta.56 → 2612.0.0-beta.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -460,6 +460,10 @@ blade-chat::part(input-toolbar) { gap: 12px; }
460
460
 
461
461
  不需要本包——用后端托管的单文件产物 `<script src=".../sdk/blade-agent.js">` + `<blade-chat>` 自定义元素,行为与 `ChatView` 一致。Vue 项目用 `@blade-hq/agent-vue` 的 `<BladeChat>` 组件;区块定制用挂载式渲染器(`<blade-chat>` 元素的 `renderers` 属性),详见 agent-client README「`<blade-chat>` 的挂载式渲染器」。
462
462
 
463
+ ## 独立工具详情
464
+
465
+ 自行维护消息时间线的应用可按需使用公开入口 `@blade-hq/agent-react/tool-details`,无需依赖 `/internal` 或挂载完整聊天视图。入口导出 `getRenderer(name)`、`formatToolName`、`getToolDisplayLabel`、`parsePlanUpdate`、`ToolUiCardView`、`isToolUiCard`,以及 `ToolRendererProps`、`ToolUiCard` 类型。`getRenderer` 对内置工具返回共享组件,未注册的名称返回 `null`,宿主可组合自己的通用展示。工具组件接收公开的 `ToolCallInfo`,主题及 Tailwind 编译方式与聊天视图相同;涉及会话资源的工具卡片仍需 `BladeProvider` 与对应会话权限。
466
+
463
467
  ## 第一方内部入口
464
468
 
465
469
  - `@blade-hq/agent-react/internal`:内置 Web 与浏览器插件用的聊天内部块、判定逻辑和连接器组件。
@@ -504,9 +508,9 @@ Questionnaire 负责必答校验、原生单选/多选、自填和前后分页
504
508
 
505
509
  ## 飞书授权接入
506
510
 
507
- `DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。宿主可用 `initialPage="manage"` 在首次挂载时直达管理页;尚未关联应用时仍进入连接入口,不会自动创建应用或授权。组件按真实能力目录中的业务分类、审核证据和可执行状态展示工作能力;免审默认全选,需审核和待飞书确认分别列出且默认不选。未实现的操作不参与选择。
511
+ `DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。宿主可用 `initialPage="manage"` 在首次挂载时直达管理页;尚未关联应用时仍进入连接入口,不会自动创建应用或授权。初始权限采用飞书平台默认模板及官方 CLI 推荐清单,不以机器人/本人身份或 SW 已实现能力筛选。权限状态按企业侧开通、本人授权分别展示,未知不等于拒绝;工作能力目录另外说明当前能执行的操作。
508
512
 
509
- 首次关联应用后,再确认已查明的免审范围。添加能力会先重新核验当前权限,成功后才按最新免审证据默认选择;核验失败保留连接与错误。统一授权流程按 `authorize` / `poll` 逐步展示当前飞书官方二维码,完成后显式 `finish`;PA 通过 `bindDelivery` 接入机器人消息,接入失败保留授权,可单独重试。完整分类选择在完成时替换启用集合,局部补权保留其他已选项;取消申请保留已有授权。增加能力时保留此助手原有停用状态,按钮显示“授权并保存”,暂停推送也不会被自动恢复。日志、历史步骤和原生错误编号放在连接帮助的高级排查内。
513
+ 首次关联应用后继续确认官方推荐的本人授权,允许两次扫码。企业审核要求以飞书页面为准;添加能力仍按当前操作核验和补充,核验失败保留连接与错误。统一授权流程按 `authorize` / `poll` 逐步展示当前飞书官方二维码,完成后显式 `finish`;PA 通过 `bindDelivery` 接入机器人消息,接入失败保留授权,可单独重试。完整分类选择在完成时替换启用集合,局部补权保留其他已选项;取消申请保留已有授权。增加能力时保留此助手原有停用状态,按钮显示“授权并保存”,暂停推送也不会被自动恢复。日志、历史步骤和原生错误编号放在连接帮助的高级排查内。
510
514
 
511
515
  PA 等只需要授权界面的宿主可从 `@blade-hq/agent-react/connectors` 导入,避免加载整套聊天 UI。组件仅接收公开授权链接,二维码在本地生成。宿主须扫描组件源码(含 `FeishuCapabilitySelection.tsx`)的 Tailwind 样式,或使用 SDK 完整样式。认证身份变化时重建组件,避免沿用前一账号的视图。
512
516
 
@@ -7,5 +7,5 @@ interface ImageLightboxProps {
7
7
  }[];
8
8
  initialIndex?: number;
9
9
  }
10
- export declare function ImageLightbox({ open, onOpenChange, images, initialIndex }: ImageLightboxProps): import("react").ReactPortal | null;
10
+ export declare function ImageLightbox({ open, onOpenChange, images, initialIndex }: ImageLightboxProps): import("react/jsx-runtime").JSX.Element | null;
11
11
  export {};
@@ -5,10 +5,10 @@ import {
5
5
  catalogToConnectorItems,
6
6
  filterConnectorItems,
7
7
  useSessionPluginActivation
8
- } from "./chunk-FLNFZVZF.js";
8
+ } from "./chunk-MAFNMG2O.js";
9
9
  import {
10
10
  DeviceConnection
11
- } from "./chunk-BQ6CUOP7.js";
11
+ } from "./chunk-ARX4JV5T.js";
12
12
  import {
13
13
  BrowserConnectionDialog,
14
14
  Check,
@@ -19,7 +19,7 @@ import {
19
19
  Search,
20
20
  Trash2,
21
21
  Unplug
22
- } from "./chunk-PMNUGFTJ.js";
22
+ } from "./chunk-VSIUEXGV.js";
23
23
 
24
24
  // src/components/connector-panel-types.ts
25
25
  function selectionFromItem(item) {
@@ -599,4 +599,4 @@ export {
599
599
  ConnectorPanel,
600
600
  PluginTriggerStack
601
601
  };
602
- //# sourceMappingURL=chunk-IQMQB6Y6.js.map
602
+ //# sourceMappingURL=chunk-2E6DQCXM.js.map