@ray-js/t-agent 0.1.0-beta-1 → 0.1.0-beta-3

package/README-zh_CN.md

@@ -148,6 +148,7 @@ const createAgent = () => {
 - `agent.createMessage(data)` 创建一个与当前 Agent 绑定的消息
 - `agent.emitTileEvent(tileId: string, payload: any)` tile 发送事件
 - `agent.removeMessage(messageId: string)` 删除消息
+- `agent.removeMessageByChannel(channel: string)` 按照渠道删除所有消息
 - `agent.flushStreamToShow(message: ChatMessage, response: StreamResponse, composer: ComposeHandler)` 流式更新消息
 
 ### Hooks 机制
@@ -339,6 +340,13 @@ await message.show();
 - `message.bubble.setInfo` 方法，设置气泡信息
 - `message.bubble.initWithInputBlocks` 方法，用输入块初始化气泡
 
+**气泡消息支持长按操作**，可以进行复制、删除等操作，同时在消息加载和更新过程中会有动画显示。
+
+气泡消息支持以下长按操作：
+
+- 复制：复制消息文本内容
+- 删除：删除当前消息
+
 ### 生命周期
 
 ChatAgent 在不同的阶段会触发不同的 Hook，开发者可以通过注册 Hook 来实现自定义行为，下面的时序图展示了 ChatAgent 的生命周期。
@@ -1053,6 +1061,7 @@ props:
 
 - `className` 容器的类名
 - `createAgent` 创建 `ChatAgent` 的函数，在 `ChatContainer` 挂载后会调用这个函数创建 `ChatAgent` 实例
+- `agentRef` 用于获取 `ChatAgent` 实例的 ref
 - `renderOptions` 渲染选项，用于决定 `MessageList` 中各个元素的渲染方式，具体参照下面的 renderOptions 自定义渲染 部分
   - `renderTileAs` 该函数决定如何在消息中渲染 tile
   - `customBlockTypes` 自定义 block 类型，只有在这里注册的 block 类型才会被 `renderCustomBlockAs` 渲染
@@ -1320,25 +1329,30 @@ const renderOptions = {
 ```my-block
 Hello, world!
 ```
+````
 
 以下 fence 没有注册过，不会被渲染成自定义 block，仅当做普通的代码块渲染。
 
 ```javascript
 console.log('Hello, world!');
 ```
-````
+
+```
 
 渲染结果如下：
 
 ```
+
 这是我的自定义 block！
 This is My Block
 Hello, world!
 以下 fence 没有注册过，不会被渲染成自定义 block，仅当做普通的代码块渲染。
-----------------------------------
-| console.log('Hello, world!');  |
-----------------------------------
-```
+
+---
+
+## | console.log('Hello, world!'); |
+
+````
 
 ### getStaticResourceBizType
 
@@ -1351,7 +1365,7 @@ const renderOptions = {
   ...defaultRenderOptions,
   getStaticResourceBizType: (src: string, scene: string) => 'bizType',
 };
-```
+````
 
 针对不同的场景，你可以需要不同的 `bizType`，你可以根据 `src` 和 `scene` 来返回不同的 `bizType`。
 
@@ -1388,21 +1402,34 @@ const renderOptions = {
 | key                                                | 使用场景                  | 含义                 |
 | -------------------------------------------------- | ------------------------- | -------------------- |
 | t-agent.build-in.button.create_scene_manually      | ButtonTile 内置按钮       | 手动创建场景         |
-| t-agent.build-in.button.enter_home_manage          | ButtonTile 内置按钮       | 进入“家庭管理”       |
-| t-agent.build-in.button.enter_room_manage          | ButtonTile 内置按钮       | 进入“房间管理”       |
-| t-agent.build-in.button.enter_alarm_message        | ButtonTile 内置按钮       | 进入“告警消息列表”   |
-| t-agent.build-in.button.enter_home_message         | ButtonTile 内置按钮       | 进入“家庭消息列表”   |
-| t-agent.build-in.button.enter_bulletin             | ButtonTile 内置按钮       | 进入“通知消息列表”   |
-| t-agent.build-in.button.enter_notification_setting | ButtonTile 内置按钮       | 进入“消息推送设置”   |
-| t-agent.build-in.button.enter_personal_information | ButtonTile 内置按钮       | 进入“个人资料”       |
-| t-agent.build-in.button.enter_account_security     | ButtonTile 内置按钮       | 进入“账号与安全”     |
-| t-agent.build-in.button.enter_setting              | ButtonTile 内置按钮       | 进入“通用设置”       |
-| t-agent.build-in.button.enter_paring               | ButtonTile 内置按钮       | 进入“设备配网”       |
-| t-agent.build-in.button.enter_share_device         | ButtonTile 内置按钮       | 进入“设备分享”       |
-| t-agent.build-in.button.enter_faq_feedback         | ButtonTile 内置按钮       | 进入“常见问题与反馈” |
+| t-agent.build-in.button.enter_home_manage          | ButtonTile 内置按钮       | 进入"家庭管理"       |
+| t-agent.build-in.button.enter_room_manage          | ButtonTile 内置按钮       | 进入"房间管理"       |
+| t-agent.build-in.button.enter_alarm_message        | ButtonTile 内置按钮       | 进入"告警消息列表"   |
+| t-agent.build-in.button.enter_home_message         | ButtonTile 内置按钮       | 进入"家庭消息列表"   |
+| t-agent.build-in.button.enter_bulletin             | ButtonTile 内置按钮       | 进入"通知消息列表"   |
+| t-agent.build-in.button.enter_notification_setting | ButtonTile 内置按钮       | 进入"消息推送设置"   |
+| t-agent.build-in.button.enter_personal_information | ButtonTile 内置按钮       | 进入"个人资料"       |
+| t-agent.build-in.button.enter_account_security     | ButtonTile 内置按钮       | 进入"账号与安全"     |
+| t-agent.build-in.button.enter_setting              | ButtonTile 内置按钮       | 进入"通用设置"       |
+| t-agent.build-in.button.enter_paring               | ButtonTile 内置按钮       | 进入"设备配网"       |
+| t-agent.build-in.button.enter_share_device         | ButtonTile 内置按钮       | 进入"设备分享"       |
+| t-agent.build-in.button.enter_faq_feedback         | ButtonTile 内置按钮       | 进入"常见问题与反馈" |
 | t-agent.build-in.button.questionnaire_take         | ButtonTile 内置按钮       | 填写问卷             |
 | t-agent.build-in.button.set_home_location          | ButtonTile 内置按钮       | 设置家庭位置         |
 | t-agent.input.voice.require-permission             | MessageInput 切换语音输入 | 需要授权录音权限     |
 | t-agent.input.upload.failed                        | MessageInput 上传文件     | 文件上传失败         |
 | t-agent.message.feedback.success                   | BubbleTile 消息评价       | 反馈成功             |
 | t-agent.message.bubble.aborted                     | BubbleTile 消息           | 用户中断             |
+| t-agent.message.action.copy                        | BubbleTile 长按菜单       | 复制消息             |
+| t-agent.message.action.delete                      | BubbleTile 长按菜单       | 删除消息             |
+| t-agent.message.action.deleteByChannel             | BubbleTile 长按菜单       | 删除所有渠道消息     |
+| t-agent.message.like.success                       | BubbleTile 反馈           | 点赞成功             |
+| t-agent.message.unlike.success                     | BubbleTile 反馈           | 取消点赞成功         |
+
+# 更新日志
+
+## 最新版本
+
+- **支持按 channel 清空消息**：通过`agent.removeMessageByChannel`方法可以批量删除特定 channel 的所有消息
+- **气泡消息加载动画**：消息在加载和更新状态下会显示适当的动画效果，提升用户体验
+- **气泡消息长按操作**：支持长按消息进行复制和删除等操作，其中助手消息还支持按渠道删除

package/README.md

@@ -112,7 +112,7 @@ export default function ChatPage() {
 
 # t-agent
 
-The t-agent package, crafted in TypeScript, is a dialogue agent SDK for building feature-rich dialogue interactions, supporting plugins to enhance functionality. As a pure SDK, it doesn’t contain UI components, allowing flexibility to work with any framework.
+The t-agent package, crafted in TypeScript, is a dialogue agent SDK for building feature-rich dialogue interactions, supporting plugins to enhance functionality. As a pure SDK, it doesn't contain UI components, allowing flexibility to work with any framework.
 
 ## Basic Concepts
 
@@ -147,6 +147,7 @@ Core Methods:
 - `agent.createMessage(data)` Creates a message linked to the agent
 - `agent.emitTileEvent(tileId: string, payload: any)` Emits tile events
 - `agent.removeMessage(messageId: string)` Removes messages
+- `agent.removeMessageByChannel(channel: string)` Removes messages based on channel
 - `agent.flushStreamToShow(message: ChatMessage, response: StreamResponse, composer: ComposeHandler)` Handles stream updates
 
 ### Hooks Mechanism
@@ -335,6 +336,13 @@ For bubble messages, additional properties and methods include:
 - `message.bubble.setInfo` Configures bubble info
 - `message.bubble.initWithInputBlocks` Initializes bubble with input blocks
 
+**Bubble messages support long press operations**, allowing for copy and delete functions, and animations will be displayed during message loading and updating.
+
+Bubble messages support the following long press operations:
+
+- Copy: Copy the message text content
+- Delete: Delete the current message
+
 ### Lifecycle
 
 ChatAgent phases trigger hooks enabling developers to integrate custom behavior efficiently. Below is the lifecycle depiction:
@@ -732,7 +740,6 @@ mock.hooks.hook('getAIAssistantGroupHistory', context => {
 
 ### Mock AI Assistant Response
 
-````
 ```tsx
 import { mock } from '@ray-js/t-agent-plugin-assistant';
 
@@ -781,7 +788,7 @@ mock.hooks.hook('sendToAssistant', context => {
     };
   }
 });
-````
+```
 
 ### mock ASR Speech Recognition
 
@@ -1001,7 +1008,7 @@ import { useEffect } from 'react';
 async function getPictureList() {
   // Retrieve the user's private picture list from the cloud
   const list = await pictureListRequest();
-  // Set into the cache this way, so it won’t need to request next time
+  // Set into the cache this way, so it won't need to request next time
   for (const item of list) {
     setUrlByCloudKey(item.path, item.displayUrl);
   }
@@ -1048,6 +1055,7 @@ props:
 
 - `className` Class name of the container
 - `createAgent` Function to create `ChatAgent`, which will call this function to create `ChatAgent` instance after `ChatContainer` mount
+- `agentRef` Reference to the `ChatAgent` instance, used to get the `ChatAgent` instance outside the `ChatContainer`
 - `renderOptions` Rendering options, used to decide the rendering method of each element in `MessageList`, refer to the renderOptions custom rendering part below
   - `renderTileAs` This function decides how to render tiles in the messages
   - `customBlockTypes` Custom block types, only block types registered here will be rendered by `renderCustomBlockAs`
@@ -1315,25 +1323,30 @@ This is my custom block!
 ```my-block
 Hello, world!
 ```
+````
 
 The following fence is not registered, and will not be rendered as a custom block, but just as a regular code block.
 
 ```javascript
 console.log('Hello, world!');
 ```
-````
+
+```
 
 The rendered result is as follows:
 
 ```
+
 This is my custom block!
 This is My Block
 Hello, world!
 The following fence is not registered, and will not be rendered as a custom block, but just as a regular code block.
-----------------------------------
-| console.log('Hello, world!');  |
-----------------------------------
-```
+
+---
+
+## | console.log('Hello, world!'); |
+
+````
 
 ### getStaticResourceBizType
 
@@ -1346,7 +1359,7 @@ const renderOptions = {
   ...defaultRenderOptions,
   getStaticResourceBizType: (src: string, scene: string) => 'bizType',
 };
-```
+````
 
 For different scenarios, you may require different `bizType`. You can return different `bizType` based on `src` and `scene`.
 
@@ -1401,3 +1414,16 @@ Below are the built-in multilingual keys:
 | t-agent.input.upload.failed                        | MessageInput file upload           | File upload failed                 |
 | t-agent.message.feedback.success                   | BubbleTile message feedback        | Feedback successful                |
 | t-agent.message.bubble.aborted                     | BubbleTile message                 | User aborted                       |
+| t-agent.message.action.copy                        | BubbleTile long press menu         | Copy message                       |
+| t-agent.message.action.delete                      | BubbleTile long press menu         | Delete message                     |
+| t-agent.message.action.deleteByChannel             | BubbleTile long press menu         | Delete all channel messages        |
+| t-agent.message.like.success                       | BubbleTile feedback                | Like successful                    |
+| t-agent.message.unlike.success                     | BubbleTile feedback                | Unlike successful                  |
+
+# Change Log
+
+## Latest Version
+
+- **Delete messages by channel**: Use `agent.removeMessageByChannel` method to batch delete all messages of a specific channel
+- **Bubble message loading animation**: Messages will display appropriate animations during loading and updating states to enhance user experience
+- **Bubble message long press operations**: Support copying and deleting operations by long-pressing messages, and assistant messages also support deletion by channel

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/t-agent",
-  "version": "0.1.0-beta-1",
+  "version": "0.1.0-beta-3",
   "author": "Tuya.inc",
   "license": "MIT",
   "private": false,
@@ -26,5 +26,5 @@
     "build": "ray build --type=component --output dist",
     "clean": "rimraf ./dist"
   },
-  "gitHead": "4d28a9d910b523c6b133c32041290fd5967ce116"
+  "gitHead": "afafdb05637f3c9cb46ef3ef518319baa748199e"
 }