@blade-hq/agent-client 2612.0.0-beta.3 → 2612.0.0-beta.5

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
@@ -697,3 +697,19 @@ chat.renderers = {
697
697
  - **消息**:`ChatMessage`、`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`MemoryRefInfo`、`getTextContent`、`getImageParts`、`getFileParts`、`contentPreview`、`groupMessagesByLoop`、`chatErrorForDisplay`、`transformSlashCommand`、`SkillMentionAvailability`、`userFacingErrorText`
698
698
 
699
699
  会话列表和详情的 `SessionInfo.initiator` 表示首次发起来源:`ui` 为界面,`sdk` 为 SDK;旧会话缺少可靠记录时为 `unknown`,尚未发起会话时为 `null` 或未提供。它不等同于后台运行标记 `is_headless`,后续继续会话不会改变来源。
700
+
701
+ ## 主题协作与资产引用
702
+
703
+ `client.chatGroups` 保持既有资源名称和 `/api/chat-groups` 路径,界面称为“主题”。
704
+ 列表新增 `role`(`owner` / `editor` / `viewer`)和 `member_count`;`session_count` 仅表示当前用户自己的会话数。
705
+
706
+ - `listMembers` / `addMembers` / `updateMember` / `removeMember` 管理成员。只有所有者可以邀请、改角色或移除他人;普通成员可移除自己以退出。
707
+ - `listTasks` / `createTask` / `updateTask` / `deleteTask` 管理任务。`createTask` 的 `start_agent: true` 由服务端创建提交者的私人会话并开始处理。启动失败时任务仍保留,接口返回错误,不应盲目重建任务。
708
+ - `listAssets` / `readAsset` / `uploadAsset` / `createAssetFolder` / `deleteAsset` 访问平台资产;`submitSessionAsset` 将当前用户的沙盒会话文件复制到资产。所有请求仍由服务端鉴权。
709
+ - `session.send(text, { topicAssetRefs: [{ topic_id, path }] })` 为本条消息选择资产;省略时不继承上一条选择。服务端重新解析元数据,通过 Context 提供拉取指引,不自动读取正文。
710
+ - `ChatMessage.topic_asset_refs` 是实时与历史一致的展示引用,不能当作访问许可。主题成员不会因此获得其他成员的会话读取权;任务的 `session_id` 只返回给该会话所有者。
711
+
712
+ 资产引用目前是专用字段,不依赖通用 `context_refs` 注册机制。知识库的 `kbIds` 选择行为保持不变。
713
+
714
+
715
+ 主题类型:`ChatGroup`、`ChatGroupRole`、`ChatGroupMember`、`ChatGroupTask`、`CreateChatGroupTask`、`UpdateChatGroupTask`、`ChatGroupAsset`、`ChatGroupAssetList`、`TopicAssetRef`。`normalizeTopicAssetRefs` 仅规范化展示引用并去重,不代替服务端鉴权。