@cloudbase/agent-ui-miniprogram 0.0.12 → 0.0.14

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @cloudbase/agent-ui-miniprogram
 
+## 1.0.1-alpha.8
+
+### Patch Changes
+
+- alpha release 0.1.2-alpha.1
+  - Update all public packages to version 0.1.2-alpha.1
+  - Trigger automated alpha release workflow
+  - Includes latest features and improvements
+
+## 1.0.1-alpha.7
+
+### Patch Changes
+
+- alpha release 0.1.2-alpha.1
+  - Update all public packages to version 0.1.2-alpha.1
+  - Trigger automated alpha release workflow
+  - Includes latest features and improvements
+
 ## 1.0.1-alpha.6
 
 ### Patch Changes

package/README.md

@@ -37,7 +37,7 @@ this.agui.sendMessage('你好')
 ## 安装
 
 ```bash
-npm install @cloudbase/agent-ui-miniprogram
+npm install @cloudbase/agent-ui-miniprogram@beta
 ```
 
 ---
@@ -259,7 +259,7 @@ Component({
 | `messages` | `Message[]` | 初始消息 |
 | `tools` | `ClientTool[]` | 带有 handler 的客户端工具 |
 | `contexts` | `Context[]` | Agent 运行时的上下文 |
-| `onRawEvent` | `(event) => void` | 每个原始 AG-UI 事件的回调 |
+| `onRawEvent` | `(event: BaseEvent) => void` | 每个原始 AG-UI 事件的回调 |
 
 ### 实例方法
 
@@ -330,18 +330,18 @@ interface AGUINamespace {
 
 ### 类型定义
 
-#### Message
+#### AG-UI 协议类型
 
-```typescript
-interface Message {
-  id: string
-  role: 'user' | 'assistant' | 'system' | 'tool' | 'developer'
-  content: string
-  name?: string
-  toolCallId?: string      // tool 角色消息使用
-  toolCalls?: ToolCall[]   // assistant 消息的工具调用
-}
-```
+以下类型来自 [AG-UI 协议](https://docs.ag-ui.com)，本 SDK 对标版本：**v0.0.42**
+
+详细定义请参考 AG-UI 官方文档：
+- [`Message`](https://docs.ag-ui.com/sdk/js/core/types#message) - 消息结构
+- [`Tool`](https://docs.ag-ui.com/sdk/js/core/types#tool) - 工具定义
+- [`ToolCall`](https://docs.ag-ui.com/sdk/js/core/types#toolcall) - 工具调用结构
+- [`Context`](https://docs.ag-ui.com/sdk/js/core/types#context) - Agent 上下文
+- [`RunAgentInput`](https://docs.ag-ui.com/sdk/js/core/types#runagentinput) - Agent 运行输入
+- [`BaseEvent`](https://docs.ag-ui.com/sdk/js/core/events) - 事件基础结构
+- [`EventType`](https://docs.ag-ui.com/sdk/js/core/events) - 事件类型枚举
 
 #### UIMessage
 
@@ -376,11 +376,10 @@ interface ToolPart {
 
 #### ClientTool
 
+扩展自 AG-UI 的 `Tool` 类型，增加了 `handler` 函数用于执行客户端工具。
+
 ```typescript
-interface ClientTool {
-  name: string
-  description: string
-  parameters?: Record<string, unknown>  // JSON Schema
+interface ClientTool extends Tool {
   handler: (params: ToolHandlerParams) => string | Promise<string>
 }
 
@@ -416,4 +415,52 @@ type AGUIClientErrorCode =
   | 'UNKNOWN'
 ```
 
+#### ToolCallState
+
+```typescript
+interface ToolCallState {
+  toolCallId: string
+  name: string
+  argsString: string                    // 原始参数字符串（流式传输中）
+  args: Record<string, unknown>         // 解析后的参数
+  status: ToolCallStatus
+  result?: unknown
+  error?: AGUIClientError
+}
+
+type ToolCallStatus = 'pending' | 'ready' | 'executing' | 'completed' | 'failed'
+```
+
+#### AGUIConfig
+
+```typescript
+interface AGUIConfig {
+  transport: Transport
+  threadId?: string
+}
+```
+
+#### CreateAGUIBehaviorOptions
+
+```typescript
+interface CreateAGUIBehaviorOptions {
+  transport?: Transport
+  threadId?: string
+  messages?: Message[]
+  tools?: ClientTool[]
+  contexts?: Context[]
+  onRawEvent?: (event: BaseEvent) => void
+}
+```
+
+#### Transport
+
+```typescript
+interface Transport {
+  run(input: RunAgentInput): AsyncIterable<BaseEvent>
+}
+```
+
+> `RunAgentInput` 和 `BaseEvent` 类型定义见 [AG-UI 协议类型](#ag-ui-协议类型)。
+
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/agent-ui-miniprogram",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "AG-UI SDK for WeChat Mini Program",
   "files": [
     "dist/",