@tdesign-react/chat 1.1.0-alpha.17 → 1.1.0-alpha.18

package/es/chat-engine/core/adapters/agui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../../../pro-components/chat/chat-engine/core/adapters/agui/index.ts"],"sourcesContent":["/* eslint-disable class-methods-use-this */\nimport type { AIMessageContent, ChatMessagesData, ChatRequestParams, SSEChunkData, ToolCall, UserMessageContent } from '../../type';\nimport { AGUIEventMapper } from './event-mapper';\nimport type { BaseEvent, RunErrorEvent, RunFinishedEvent, RunStartedEvent } from './types/events';\nimport { AGUIEventType } from './types/events';\nimport type { AGUIHistoryMessage, AGUIUserHistoryMessage } from './types';\nimport { buildToolCallMap, processMessageGroup } from './utils';\n\n// 重新导出类型，以便其他文件可以使用\nexport type {\n  AGUIHistoryMessage,\n  AGUIUserHistoryMessage,\n  AGUIAssistantHistoryMessage,\n  AGUIToolHistoryMessage,\n  AGUIActivityMessage,\n} from './types';\n\n/**\n * AGUI协议适配器回调接口\n */\nexport interface AGUIAdapterCallbacks {\n  onRunStart?: (event: RunStartedEvent) => void;\n  onRunComplete?: (isAborted: boolean, params: ChatRequestParams, event?: RunFinishedEvent) => void;\n  onRunError?: (error: RunErrorEvent) => void;\n}\n\n/**\n * AGUI协议适配器\n * 1. 处理AGUI协议特定的事件（RUN_STARTED, RUN_FINISHED, RUN_ERROR）\n * 2. 管理工具调用的生命周期\n * 3. 将AGUI事件映射为ChatEngine可理解的消息内容\n * 4. 转换AG-UI历史消息为ChatMessagesData格式\n */\nexport class AGUIAdapter {\n  /**\n   * 转换AG-UI历史消息为ChatMessagesData格式（静态方法）\n   *\n   * ## 设计说明\n   *\n   * ### AG-UI 协议中的消息角色\n   * - `user`: 用户消息\n   * - `assistant`: AI 回复，可包含 content、reasoningContent、toolCalls\n   * - `tool`: 工具调用结果，通过 toolCallId 关联到 assistant 的 toolCalls\n   * - `activity`: 独立的活动/事件消息，表示代理运行过程中的中间状态\n   *\n   * ### Activity 消息的处理策略\n   * Activity 在 AG-UI 中是独立的 role，不是 assistant 的附属。\n   * 但在 UI 展示层，我们选择将其合并到 AI 响应中，原因：\n   * 1. 保持对话气泡的整洁性（一问一答模式）\n   * 2. Activity 通常是 AI 处理过程的可视化，属于同一个响应周期\n   * 3. 通过 activityType 区分不同类型的 Activity 渲染\n   *\n   * 转换策略：\n   * 1. 以用户消息为边界进行分组\n   * 2. 每个用户消息对应一个AI消息，包含该用户输入后的所有AI回复和工具调用结果\n   * 3. 按照后端数据的原始顺序构建content数组\n   * 4. 避免重复处理同一个工具调用\n   * 5. 支持只有assistant消息的情况（如welcome消息）\n   *\n   * @param historyMessages AG-UI格式的历史消息数组\n   * @returns 转换后的ChatMessagesData数组\n   */\n  static convertHistoryMessages(historyMessages: AGUIHistoryMessage[]): ChatMessagesData[] {\n    if (!historyMessages || historyMessages.length === 0) {\n      return [];\n    }\n    const convertedMessages: ChatMessagesData[] = [];\n    const toolCallMap = buildToolCallMap(historyMessages);\n\n    // 按用户消息分组处理\n    let currentUserMessage: AGUIUserHistoryMessage | null = null;\n    let currentGroupMessages: AGUIHistoryMessage[] = []; // 存储当前组的所有消息\n\n    /**\n     * 处理消息组，构建AI消息的content数组\n     * 复用 utils.ts 中的 processMessageGroup 公共函数\n     */\n    const processGroup = (messages: AGUIHistoryMessage[]): AIMessageContent[] => {\n      return processMessageGroup(messages, toolCallMap) as AIMessageContent[];\n    };\n\n    /**\n     * 创建AI消息\n     */\n    const createAIMessage = (messages: AGUIHistoryMessage[]): void => {\n      if (messages.length > 0) {\n        const allContent = processGroup(messages);\n        if (allContent.length > 0) {\n          const firstMessageInGroup = messages[0];\n          convertedMessages.push({\n            id: firstMessageInGroup.id,\n            role: 'assistant',\n            content: allContent,\n            status: 'complete',\n            datetime: new Date(messages.at(-1)?.timestamp || Date.now()).toISOString(),\n          });\n        }\n      }\n    };\n\n    /**\n     * 处理用户消息的 content 字段\n     * 兼容两种格式：\n     * 1. 标准 AG-UI 格式：content 是字符串\n     * 2. 已转换格式：content 已经是数组 [{ type, data }]\n     */\n    const processUserContent = (content: any): UserMessageContent[] => {\n      // 如果 content 已经是数组格式，直接返回\n      if (Array.isArray(content)) {\n        return content as UserMessageContent[];\n      }\n      // 如果是字符串，包装为标准格式\n      return [\n        {\n          type: 'text',\n          data: content,\n        },\n      ];\n    };\n\n    /**\n     * 处理当前消息组\n     */\n    const flushCurrentGroup = () => {\n      if (currentUserMessage) {\n        // 添加用户消息\n        convertedMessages.push({\n          id: currentUserMessage.id,\n          role: 'user',\n          content: processUserContent(currentUserMessage.content),\n          datetime: new Date(currentUserMessage.timestamp || Date.now()).toISOString(),\n        });\n      }\n      // 处理AI消息\n      createAIMessage(currentGroupMessages);\n\n      // 重置当前组\n      currentUserMessage = null;\n      currentGroupMessages = [];\n    };\n\n    // 按顺序处理消息\n    historyMessages.forEach((msg) => {\n      if (msg.role === 'user') {\n        // 遇到新的用户消息，先处理之前的组\n        flushCurrentGroup();\n\n        // 开始新的组\n        currentUserMessage = msg as AGUIUserHistoryMessage;\n      } else if (msg.role === 'assistant' || msg.role === 'tool' || msg.role === 'activity') {\n        // 收集助手消息、工具调用结果和活动消息到当前组\n        currentGroupMessages.push(msg);\n      }\n    });\n\n    // 处理最后一组\n    flushCurrentGroup();\n    return convertedMessages;\n  }\n\n  private aguiEventMapper: AGUIEventMapper;\n\n  constructor() {\n    this.aguiEventMapper = new AGUIEventMapper();\n  }\n\n  /**\n   * 处理AGUI事件\n   *\n   * 处理流程：\n   * 1. 解析SSE数据（AG-UI后端返回标准SSE格式，data字段是JSON字符串）\n   * 2. 处理AGUI特定事件（生命周期事件）\n   * 3. 使用事件映射器转换为消息内容\n   * 4. 同步工具调用状态\n   *\n   * @param chunk SSE数据块\n   * @param callbacks 回调函数\n   * @returns 处理结果\n   */\n  handleAGUIEvent(chunk: SSEChunkData, callbacks: AGUIAdapterCallbacks): AIMessageContent | AIMessageContent[] | null {\n    // AG-UI后端返回标准SSE格式，data字段是JSON字符串\n    let event: BaseEvent;\n    try {\n      event = typeof chunk.data === 'string' ? JSON.parse(chunk.data) : chunk.data;\n    } catch (error) {\n      console.warn('Failed to parse AG-UI event data:', error);\n      return null;\n    }\n\n    if (!event?.type) return null;\n\n    // 处理AGUI特定事件（生命周期事件）\n    const lifecycleHandled = this.handleAGUISpecificEvents(event, callbacks);\n\n    // 如果是生命周期事件，不需要转换为消息内容\n    if (lifecycleHandled) {\n      return null;\n    }\n\n    // 使用事件映射器处理内容事件\n    const result = this.aguiEventMapper.mapEvent(chunk);\n\n    return result;\n  }\n\n  /**\n   * 获取AGUI事件映射器\n   */\n  get toolcalls() {\n    return this.aguiEventMapper.getToolCalls();\n  }\n\n  getToolcallByName(name: string): ToolCall | undefined {\n    const result = this.aguiEventMapper.getToolCalls().find((call) => call.toolCallName === name);\n    return result;\n  }\n\n  /**\n   * 重置适配器状态\n   */\n  reset(): void {\n    this.aguiEventMapper.reset();\n  }\n\n  /**\n   * 处理AGUI特定事件\n   *\n   * 处理RUN_STARTED、RUN_FINISHED、RUN_ERROR等生命周期事件\n   * 这些事件用于通知外部系统状态变化，并执行相应的回调\n   *\n   * @param event 解析后的事件对象\n   * @param callbacks 回调函数\n   * @returns 是否处理了生命周期事件（仅RUN_STARTED和RUN_FINISHED返回true，RUN_ERROR需要继续处理生成消息内容）\n   */\n  private handleAGUISpecificEvents(event: BaseEvent, callbacks: AGUIAdapterCallbacks): boolean {\n    switch (event.type) {\n      case AGUIEventType.RUN_STARTED:\n        callbacks.onRunStart?.(event as RunStartedEvent);\n        return true;\n      case AGUIEventType.RUN_FINISHED:\n        callbacks.onRunComplete?.(false, {} as ChatRequestParams, event as RunFinishedEvent);\n        return true;\n      case AGUIEventType.RUN_ERROR:\n        // RUN_ERROR 需要触发回调，但不能返回 true\n        // 因为还需要通过 event-mapper 生成错误消息内容用于 UI 展示\n        callbacks.onRunError?.(event as RunErrorEvent);\n        return false; // 继续处理，让 event-mapper 生成错误消息\n      default:\n        return false; // 不是生命周期事件\n    }\n  }\n}\n\n/**\n * 状态订阅机制导出\n */\nexport * from './StateManager';\nexport * from './ActivityManager';\nexport * from './types';\n"],"names":["AGUIAdapter","_classCallCheck","aguiEventMapper","AGUIEventMapper","_createClass","key","value","handleAGUIEvent","chunk","callbacks","_event","event","data","JSON","parse","error","console","warn","type","lifecycleHandled","handleAGUISpecificEvents","result","mapEvent","get","getToolCalls","getToolcallByName","name","find","call","toolCallName","reset","_callbacks$onRunStart","_callbacks$onRunCompl","_callbacks$onRunError","AGUIEventType","RUN_STARTED","onRunStart","RUN_FINISHED","onRunComplete","RUN_ERROR","onRunError","convertHistoryMessages","historyMessages","length","convertedMessages","toolCallMap","buildToolCallMap","currentUserMessage","currentGroupMessages","processGroup","messages","processMessageGroup","createAIMessage","allContent","_messages$at","firstMessageInGroup","push","id","role","content","status","datetime","Date","at","timestamp","now","toISOString","processUserContent","Array","isArray","flushCurrentGroup","forEach","msg"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../../../pro-components/chat/chat-engine/core/adapters/agui/index.ts"],"sourcesContent":["/* eslint-disable class-methods-use-this */\nimport type { AIMessageContent, ChatMessagesData, ChatRequestParams, SSEChunkData, ToolCall, UserMessageContent } from '../../type';\nimport { AGUIEventMapper } from './event-mapper';\nimport type { BaseEvent, RunErrorEvent, RunFinishedEvent, RunStartedEvent } from './types/events';\nimport { AGUIEventType } from './types/events';\nimport type { AGUIHistoryMessage, AGUIUserHistoryMessage } from './types';\nimport { buildToolCallMap, processMessageGroup } from './utils';\n\n// 重新导出类型，以便其他文件可以使用\nexport type {\n  AGUIHistoryMessage,\n  AGUIUserHistoryMessage,\n  AGUIAssistantHistoryMessage,\n  AGUIToolHistoryMessage,\n  AGUIActivityMessage,\n} from './types';\n\n/**\n * AGUI协议适配器回调接口\n */\nexport interface AGUIAdapterCallbacks {\n  onRunStart?: (event: RunStartedEvent) => void;\n  onRunComplete?: (isAborted: boolean, params: ChatRequestParams, event?: RunFinishedEvent) => void;\n  onRunError?: (error: RunErrorEvent) => void;\n}\n\n/**\n * AGUI协议适配器\n * 1. 处理AGUI协议特定的事件（RUN_STARTED, RUN_FINISHED, RUN_ERROR）\n * 2. 管理工具调用的生命周期\n * 3. 将AGUI事件映射为ChatEngine可理解的消息内容\n * 4. 转换AG-UI历史消息为ChatMessagesData格式\n */\nexport class AGUIAdapter {\n  /**\n   * 转换AG-UI历史消息为ChatMessagesData格式（静态方法）\n   *\n   * ## 设计说明\n   *\n   * ### AG-UI 协议中的消息角色\n   * - `user`: 用户消息\n   * - `assistant`: AI 回复，可包含 content、reasoningContent、toolCalls\n   * - `tool`: 工具调用结果，通过 toolCallId 关联到 assistant 的 toolCalls\n   * - `activity`: 独立的活动/事件消息，表示代理运行过程中的中间状态\n   *\n   * ### Activity 消息的处理策略\n   * Activity 在 AG-UI 中是独立的 role，不是 assistant 的附属。\n   * 但在 UI 展示层，我们选择将其合并到 AI 响应中，原因：\n   * 1. 保持对话气泡的整洁性（一问一答模式）\n   * 2. Activity 通常是 AI 处理过程的可视化，属于同一个响应周期\n   * 3. 通过 activityType 区分不同类型的 Activity 渲染\n   *\n   * 转换策略：\n   * 1. 以用户消息为边界进行分组\n   * 2. 每个用户消息对应一个AI消息，包含该用户输入后的所有AI回复和工具调用结果\n   * 3. 按照后端数据的原始顺序构建content数组\n   * 4. 避免重复处理同一个工具调用\n   * 5. 支持只有assistant消息的情况（如welcome消息）\n   *\n   * @param historyMessages AG-UI格式的历史消息数组\n   * @returns 转换后的ChatMessagesData数组\n   */\n  static convertHistoryMessages(historyMessages: AGUIHistoryMessage[]): ChatMessagesData[] {\n    if (!historyMessages || historyMessages.length === 0) {\n      return [];\n    }\n    const convertedMessages: ChatMessagesData[] = [];\n    const toolCallMap = buildToolCallMap(historyMessages);\n\n    // 按用户消息分组处理\n    let currentUserMessage: AGUIUserHistoryMessage | null = null;\n    let currentGroupMessages: AGUIHistoryMessage[] = []; // 存储当前组的所有消息\n\n    /**\n     * 处理消息组，构建AI消息的content数组\n     * 复用 utils.ts 中的 processMessageGroup 公共函数\n     */\n    const processGroup = (messages: AGUIHistoryMessage[]): AIMessageContent[] => {\n      return processMessageGroup(messages, toolCallMap) as AIMessageContent[];\n    };\n\n    /**\n     * 创建AI消息\n     */\n    const createAIMessage = (messages: AGUIHistoryMessage[]): void => {\n      if (messages.length > 0) {\n        const allContent = processGroup(messages);\n        if (allContent.length > 0) {\n          const firstMessageInGroup = messages[0];\n          convertedMessages.push({\n            id: firstMessageInGroup.id,\n            role: 'assistant',\n            content: allContent,\n            status: 'complete',\n            datetime: new Date(messages.at(-1)?.timestamp || Date.now()).toISOString(),\n          });\n        }\n      }\n    };\n\n    /**\n     * 处理用户消息的 content 字段\n     * 兼容三种格式：\n     * 1. 标准 AG-UI 格式：content 是字符串\n     * 2. 后端返回格式：content 是数组 [{ type, text }]（text 字段存储文本）\n     * 3. 已转换格式：content 已经是数组 [{ type, data }]\n     */\n    const processUserContent = (content: any): UserMessageContent[] => {\n      // 如果 content 已经是数组格式，需要做字段适配\n      if (Array.isArray(content)) {\n        return content.map((item: any) => {\n          // 如果已经有 data 字段，说明已经是 ChatEngine 格式\n          if (item.data !== undefined) {\n            return item as UserMessageContent;\n          }\n          // 后端返回的格式用 text 字段存储文本，需要映射为 data 字段\n          if (item.type === 'text' && item.text !== undefined) {\n            return {\n              type: 'text' as const,\n              data: item.text,\n            };\n          }\n          // 其他类型的数组元素，尝试用 text 字段兜底\n          return {\n            type: item.type || 'text',\n            data: item.text || item.data || '',\n          } as UserMessageContent;\n        });\n      }\n      // 如果是字符串，包装为标准格式\n      return [\n        {\n          type: 'text',\n          data: content,\n        },\n      ];\n    };\n\n    /**\n     * 处理当前消息组\n     */\n    const flushCurrentGroup = () => {\n      if (currentUserMessage) {\n        // 添加用户消息\n        convertedMessages.push({\n          id: currentUserMessage.id,\n          role: 'user',\n          content: processUserContent(currentUserMessage.content),\n          datetime: new Date(currentUserMessage.timestamp || Date.now()).toISOString(),\n        });\n      }\n      // 处理AI消息\n      createAIMessage(currentGroupMessages);\n\n      // 重置当前组\n      currentUserMessage = null;\n      currentGroupMessages = [];\n    };\n\n    // 按顺序处理消息\n    historyMessages.forEach((msg) => {\n      if (msg.role === 'user') {\n        // 遇到新的用户消息，先处理之前的组\n        flushCurrentGroup();\n\n        // 开始新的组\n        currentUserMessage = msg as AGUIUserHistoryMessage;\n      } else if (msg.role === 'assistant' || msg.role === 'tool' || msg.role === 'activity') {\n        // 收集助手消息、工具调用结果和活动消息到当前组\n        currentGroupMessages.push(msg);\n      }\n    });\n\n    // 处理最后一组\n    flushCurrentGroup();\n    return convertedMessages;\n  }\n\n  private aguiEventMapper: AGUIEventMapper;\n\n  constructor() {\n    this.aguiEventMapper = new AGUIEventMapper();\n  }\n\n  /**\n   * 处理AGUI事件\n   *\n   * 处理流程：\n   * 1. 解析SSE数据（AG-UI后端返回标准SSE格式，data字段是JSON字符串）\n   * 2. 处理AGUI特定事件（生命周期事件）\n   * 3. 使用事件映射器转换为消息内容\n   * 4. 同步工具调用状态\n   *\n   * @param chunk SSE数据块\n   * @param callbacks 回调函数\n   * @returns 处理结果\n   */\n  handleAGUIEvent(chunk: SSEChunkData, callbacks: AGUIAdapterCallbacks): AIMessageContent | AIMessageContent[] | null {\n    // AG-UI后端返回标准SSE格式，data字段是JSON字符串\n    let event: BaseEvent;\n    try {\n      event = typeof chunk.data === 'string' ? JSON.parse(chunk.data) : chunk.data;\n    } catch (error) {\n      console.warn('Failed to parse AG-UI event data:', error);\n      return null;\n    }\n\n    if (!event?.type) return null;\n\n    // 处理AGUI特定事件（生命周期事件）\n    const lifecycleHandled = this.handleAGUISpecificEvents(event, callbacks);\n\n    // 如果是生命周期事件，不需要转换为消息内容\n    if (lifecycleHandled) {\n      return null;\n    }\n\n    // 使用事件映射器处理内容事件\n    const result = this.aguiEventMapper.mapEvent(chunk);\n\n    return result;\n  }\n\n  /**\n   * 获取AGUI事件映射器\n   */\n  get toolcalls() {\n    return this.aguiEventMapper.getToolCalls();\n  }\n\n  getToolcallByName(name: string): ToolCall | undefined {\n    const result = this.aguiEventMapper.getToolCalls().find((call) => call.toolCallName === name);\n    return result;\n  }\n\n  /**\n   * 重置适配器状态\n   */\n  reset(): void {\n    this.aguiEventMapper.reset();\n  }\n\n  /**\n   * 处理AGUI特定事件\n   *\n   * 处理RUN_STARTED、RUN_FINISHED、RUN_ERROR等生命周期事件\n   * 这些事件用于通知外部系统状态变化，并执行相应的回调\n   *\n   * @param event 解析后的事件对象\n   * @param callbacks 回调函数\n   * @returns 是否处理了生命周期事件（仅RUN_STARTED和RUN_FINISHED返回true，RUN_ERROR需要继续处理生成消息内容）\n   */\n  private handleAGUISpecificEvents(event: BaseEvent, callbacks: AGUIAdapterCallbacks): boolean {\n    switch (event.type) {\n      case AGUIEventType.RUN_STARTED:\n        callbacks.onRunStart?.(event as RunStartedEvent);\n        return true;\n      case AGUIEventType.RUN_FINISHED:\n        callbacks.onRunComplete?.(false, {} as ChatRequestParams, event as RunFinishedEvent);\n        return true;\n      case AGUIEventType.RUN_ERROR:\n        // RUN_ERROR 需要触发回调，但不能返回 true\n        // 因为还需要通过 event-mapper 生成错误消息内容用于 UI 展示\n        callbacks.onRunError?.(event as RunErrorEvent);\n        return false; // 继续处理，让 event-mapper 生成错误消息\n      default:\n        return false; // 不是生命周期事件\n    }\n  }\n}\n\n/**\n * 状态订阅机制导出\n */\nexport * from './StateManager';\nexport * from './ActivityManager';\nexport * from './types';\n"],"names":["AGUIAdapter","_classCallCheck","aguiEventMapper","AGUIEventMapper","_createClass","key","value","handleAGUIEvent","chunk","callbacks","_event","event","data","JSON","parse","error","console","warn","type","lifecycleHandled","handleAGUISpecificEvents","result","mapEvent","get","getToolCalls","getToolcallByName","name","find","call","toolCallName","reset","_callbacks$onRunStart","_callbacks$onRunCompl","_callbacks$onRunError","AGUIEventType","RUN_STARTED","onRunStart","RUN_FINISHED","onRunComplete","RUN_ERROR","onRunError","convertHistoryMessages","historyMessages","length","convertedMessages","toolCallMap","buildToolCallMap","currentUserMessage","currentGroupMessages","processGroup","messages","processMessageGroup","createAIMessage","allContent","_messages$at","firstMessageInGroup","push","id","role","content","status","datetime","Date","at","timestamp","now","toISOString","processUserContent","Array","isArray","map","item","text","flushCurrentGroup","forEach","msg"],"mappings":"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"}

package/es/chat-engine/core/adapters/agui/types/events.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/agui/types/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/agui/utils.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -16,6 +16,7 @@ export { SurfaceStateManager, surfaceStateManager } from './json-render/SurfaceS
 export { applyA2UIDataUpdate, applyA2UIUpdates, convertA2UIMessagesToJsonRender } from './json-render/a2ui-to-jsonrender.js';
 export { OpenClawEventMapper } from './openclaw/event-mapper.js';
 export { OpenClawRPCHandler, RPCError } from './openclaw/rpc-handler.js';
+export { DeviceKeyManager } from './openclaw/device-key-manager.js';
 export { convertOpenClawHistory, convertOpenClawHistoryResponse } from './openclaw/history-converter.js';
 export { DEFAULT_OPENCLAW_CONFIG, mergeOpenClawConfig } from './openclaw/types/config.js';
 export { AgentDataType, AgentStreamType, ChatEventState, OpenClawConnectionState, OpenClawEventType, OpenClawMethod } from './openclaw/types/events.js';

package/es/chat-engine/core/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/es/chat-engine/core/adapters/json-render/SurfaceStateManager.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/json-render/a2ui-to-jsonrender.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/json-render/engine.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/json-render/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/json-render/types/a2ui.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/json-render/types/core.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/json-render/types/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.1.0-alpha.16
+ * tdesign v1.1.0-alpha.17
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/core/adapters/openclaw/device-key-manager.d.ts

@@ -0,0 +1,65 @@
+/** 设备密钥对（hex 编码） */
+export interface DeviceKeyPair {
+    publicKey: string;
+    privateKey: string;
+    deviceId: string;
+}
+/** connect 请求中的 device 字段 */
+export interface DeviceIdentity {
+    /** 设备 ID（由公钥派生或随机生成） */
+    id: string;
+    /** 公钥（hex 编码） */
+    publicKey: string;
+    /** nonce 签名（hex 编码） */
+    signature: string;
+    /** 签名时间戳（Unix 秒级时间戳） */
+    signedAt: number;
+    /** 回传的 challenge nonce */
+    nonce: string;
+}
+/**
+ * 设备密钥管理器
+ *
+ * 使用方式：
+ * ```ts
+ * const manager = new DeviceKeyManager('webchat');
+ * await manager.initialize();
+ *
+ * // 收到 connect.challenge 时
+ * const device = await manager.signChallenge(nonce);
+ * // 将 device 放入 connect params
+ * ```
+ */
+export declare class DeviceKeyManager {
+    private keyPair;
+    private clientId;
+    private useEd25519;
+    private initialized;
+    constructor(clientId?: string);
+    /**
+     * 初始化密钥管理器
+     *
+     * - 尝试从 localStorage 恢复已有密钥对
+     * - 如果没有，则生成新的密钥对并持久化
+     * - 自动检测并选择 Ed25519 或 HMAC-SHA256
+     */
+    initialize(): Promise<void>;
+    /**
+     * 签名 challenge nonce，返回 device 字段
+     *
+     * 在收到 connect.challenge 事件后调用，
+     * 返回值直接放入 connect 请求的 params.device 中。
+     */
+    signChallenge(nonce: string): Promise<DeviceIdentity>;
+    /**
+     * 获取设备 ID
+     */
+    getDeviceId(): string | null;
+    /**
+     * 重置密钥（强制重新生成密钥对）
+     */
+    reset(): Promise<void>;
+    private loadFromStorage;
+    private saveToStorage;
+    private clearStorage;
+}

package/es/chat-engine/core/adapters/openclaw/device-key-manager.js

@@ -0,0 +1,375 @@
+/**
+ * tdesign v1.1.0-alpha.17
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _asyncToGenerator from '@babel/runtime/helpers/asyncToGenerator';
+import _regeneratorRuntime from '@babel/runtime/regenerator';
+import { LoggerManager } from '../../utils/logger.js';
+
+var logger = LoggerManager.getLogger();
+function bytesToHex(bytes) {
+  return Array.from(bytes).map(function (b) {
+    return b.toString(16).padStart(2, "0");
+  }).join("");
+}
+function hexToBytes(hex) {
+  var bytes = new Uint8Array(hex.length / 2);
+  for (var i = 0; i < hex.length; i += 2) {
+    bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);
+  }
+  return bytes;
+}
+function deriveDeviceId(publicKeyHex) {
+  return "device_".concat(publicKeyHex.substring(0, 16));
+}
+function getStorageKey(clientId) {
+  return "openclaw_device_key_".concat(clientId);
+}
+function isEd25519Supported() {
+  return _isEd25519Supported.apply(this, arguments);
+}
+function _isEd25519Supported() {
+  _isEd25519Supported = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee4() {
+    var keyPair, _t3;
+    return _regeneratorRuntime.wrap(function (_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          _context4.prev = 0;
+          _context4.next = 1;
+          return crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
+        case 1:
+          keyPair = _context4.sent;
+          return _context4.abrupt("return", !!keyPair);
+        case 2:
+          _context4.prev = 2;
+          _t3 = _context4["catch"](0);
+          return _context4.abrupt("return", false);
+        case 3:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4, null, [[0, 2]]);
+  }));
+  return _isEd25519Supported.apply(this, arguments);
+}
+function generateEd25519KeyPair() {
+  return _generateEd25519KeyPair.apply(this, arguments);
+}
+function _generateEd25519KeyPair() {
+  _generateEd25519KeyPair = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee5() {
+    var keyPair, publicKeyRaw, privateKeyPkcs8, publicKeyHex, privateKeyHex;
+    return _regeneratorRuntime.wrap(function (_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          _context5.next = 1;
+          return crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
+        case 1:
+          keyPair = _context5.sent;
+          _context5.next = 2;
+          return crypto.subtle.exportKey("raw", keyPair.publicKey);
+        case 2:
+          publicKeyRaw = _context5.sent;
+          _context5.next = 3;
+          return crypto.subtle.exportKey("pkcs8", keyPair.privateKey);
+        case 3:
+          privateKeyPkcs8 = _context5.sent;
+          publicKeyHex = bytesToHex(new Uint8Array(publicKeyRaw));
+          privateKeyHex = bytesToHex(new Uint8Array(privateKeyPkcs8));
+          return _context5.abrupt("return", {
+            publicKey: publicKeyHex,
+            privateKey: privateKeyHex,
+            deviceId: deriveDeviceId(publicKeyHex)
+          });
+        case 4:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5);
+  }));
+  return _generateEd25519KeyPair.apply(this, arguments);
+}
+function signWithEd25519(_x, _x2) {
+  return _signWithEd.apply(this, arguments);
+}
+function _signWithEd() {
+  _signWithEd = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee6(privateKeyHex, nonce) {
+    var privateKeyBytes, privateKey, encoder, data, signature;
+    return _regeneratorRuntime.wrap(function (_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
+        case 0:
+          privateKeyBytes = hexToBytes(privateKeyHex);
+          _context6.next = 1;
+          return crypto.subtle.importKey("pkcs8", privateKeyBytes.buffer, "Ed25519", false, ["sign"]);
+        case 1:
+          privateKey = _context6.sent;
+          encoder = new TextEncoder();
+          data = encoder.encode(nonce);
+          _context6.next = 2;
+          return crypto.subtle.sign("Ed25519", privateKey, data);
+        case 2:
+          signature = _context6.sent;
+          return _context6.abrupt("return", bytesToHex(new Uint8Array(signature)));
+        case 3:
+        case "end":
+          return _context6.stop();
+      }
+    }, _callee6);
+  }));
+  return _signWithEd.apply(this, arguments);
+}
+function generateHmacKeyPair() {
+  return _generateHmacKeyPair.apply(this, arguments);
+}
+function _generateHmacKeyPair() {
+  _generateHmacKeyPair = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee7() {
+    var privateKeyBytes, privateKeyHex, encoder, hashBuffer, publicKeyHex;
+    return _regeneratorRuntime.wrap(function (_context7) {
+      while (1) switch (_context7.prev = _context7.next) {
+        case 0:
+          privateKeyBytes = crypto.getRandomValues(new Uint8Array(32));
+          privateKeyHex = bytesToHex(privateKeyBytes);
+          encoder = new TextEncoder();
+          _context7.next = 1;
+          return crypto.subtle.digest("SHA-256", encoder.encode(privateKeyHex));
+        case 1:
+          hashBuffer = _context7.sent;
+          publicKeyHex = bytesToHex(new Uint8Array(hashBuffer));
+          return _context7.abrupt("return", {
+            publicKey: publicKeyHex,
+            privateKey: privateKeyHex,
+            deviceId: deriveDeviceId(publicKeyHex)
+          });
+        case 2:
+        case "end":
+          return _context7.stop();
+      }
+    }, _callee7);
+  }));
+  return _generateHmacKeyPair.apply(this, arguments);
+}
+function signWithHmac(_x3, _x4) {
+  return _signWithHmac.apply(this, arguments);
+}
+function _signWithHmac() {
+  _signWithHmac = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee8(privateKeyHex, nonce) {
+    var encoder, keyData, key, signature;
+    return _regeneratorRuntime.wrap(function (_context8) {
+      while (1) switch (_context8.prev = _context8.next) {
+        case 0:
+          encoder = new TextEncoder();
+          keyData = encoder.encode(privateKeyHex);
+          _context8.next = 1;
+          return crypto.subtle.importKey("raw", keyData, {
+            name: "HMAC",
+            hash: "SHA-256"
+          }, false, ["sign"]);
+        case 1:
+          key = _context8.sent;
+          _context8.next = 2;
+          return crypto.subtle.sign("HMAC", key, encoder.encode(nonce));
+        case 2:
+          signature = _context8.sent;
+          return _context8.abrupt("return", bytesToHex(new Uint8Array(signature)));
+        case 3:
+        case "end":
+          return _context8.stop();
+      }
+    }, _callee8);
+  }));
+  return _signWithHmac.apply(this, arguments);
+}
+var DeviceKeyManager = /*#__PURE__*/function () {
+  function DeviceKeyManager() {
+    var clientId = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "webchat";
+    _classCallCheck(this, DeviceKeyManager);
+    _defineProperty(this, "keyPair", null);
+    _defineProperty(this, "useEd25519", false);
+    _defineProperty(this, "initialized", false);
+    this.clientId = clientId;
+  }
+  return _createClass(DeviceKeyManager, [{
+    key: "initialize",
+    value: function () {
+      var _initialize = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+        var stored, _t;
+        return _regeneratorRuntime.wrap(function (_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              if (!this.initialized) {
+                _context.next = 1;
+                break;
+              }
+              return _context.abrupt("return");
+            case 1:
+              _context.next = 2;
+              return isEd25519Supported();
+            case 2:
+              this.useEd25519 = _context.sent;
+              logger.debug("Device auth: Ed25519 ".concat(this.useEd25519 ? "supported" : "not supported, using HMAC-SHA256 fallback"));
+              stored = this.loadFromStorage();
+              if (!stored) {
+                _context.next = 3;
+                break;
+              }
+              this.keyPair = stored;
+              logger.debug("Device auth: restored key pair for device ".concat(stored.deviceId));
+              _context.next = 8;
+              break;
+            case 3:
+              if (!this.useEd25519) {
+                _context.next = 5;
+                break;
+              }
+              _context.next = 4;
+              return generateEd25519KeyPair();
+            case 4:
+              _t = _context.sent;
+              _context.next = 7;
+              break;
+            case 5:
+              _context.next = 6;
+              return generateHmacKeyPair();
+            case 6:
+              _t = _context.sent;
+            case 7:
+              this.keyPair = _t;
+              this.saveToStorage(this.keyPair);
+              logger.info("Device auth: generated new key pair, deviceId=".concat(this.keyPair.deviceId));
+            case 8:
+              this.initialized = true;
+            case 9:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function initialize() {
+        return _initialize.apply(this, arguments);
+      }
+      return initialize;
+    }()
+  }, {
+    key: "signChallenge",
+    value: function () {
+      var _signChallenge = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee2(nonce) {
+        var signedAt, signPayload, signature, _t2;
+        return _regeneratorRuntime.wrap(function (_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              if (this.keyPair) {
+                _context2.next = 1;
+                break;
+              }
+              _context2.next = 1;
+              return this.initialize();
+            case 1:
+              signedAt = Math.floor(Date.now() / 1e3);
+              signPayload = "".concat(nonce, ":").concat(signedAt);
+              if (!this.useEd25519) {
+                _context2.next = 3;
+                break;
+              }
+              _context2.next = 2;
+              return signWithEd25519(this.keyPair.privateKey, signPayload);
+            case 2:
+              _t2 = _context2.sent;
+              _context2.next = 5;
+              break;
+            case 3:
+              _context2.next = 4;
+              return signWithHmac(this.keyPair.privateKey, signPayload);
+            case 4:
+              _t2 = _context2.sent;
+            case 5:
+              signature = _t2;
+              return _context2.abrupt("return", {
+                id: this.keyPair.deviceId,
+                publicKey: this.keyPair.publicKey,
+                signature: signature,
+                signedAt: signedAt,
+                nonce: nonce
+              });
+            case 6:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function signChallenge(_x5) {
+        return _signChallenge.apply(this, arguments);
+      }
+      return signChallenge;
+    }()
+  }, {
+    key: "getDeviceId",
+    value: function getDeviceId() {
+      var _this$keyPair$deviceI, _this$keyPair;
+      return (_this$keyPair$deviceI = (_this$keyPair = this.keyPair) === null || _this$keyPair === void 0 ? void 0 : _this$keyPair.deviceId) !== null && _this$keyPair$deviceI !== void 0 ? _this$keyPair$deviceI : null;
+    }
+  }, {
+    key: "reset",
+    value: function () {
+      var _reset = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
+        return _regeneratorRuntime.wrap(function (_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              this.clearStorage();
+              this.keyPair = null;
+              this.initialized = false;
+              _context3.next = 1;
+              return this.initialize();
+            case 1:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this);
+      }));
+      function reset() {
+        return _reset.apply(this, arguments);
+      }
+      return reset;
+    }()
+  }, {
+    key: "loadFromStorage",
+    value: function loadFromStorage() {
+      if (typeof window === "undefined" || !window.localStorage) return null;
+      try {
+        var stored = window.localStorage.getItem(getStorageKey(this.clientId));
+        if (!stored) return null;
+        var parsed = JSON.parse(stored);
+        if (parsed.publicKey && parsed.privateKey && parsed.deviceId) {
+          return parsed;
+        }
+      } catch (e) {
+        logger.warn("Failed to load device key from storage:", e);
+      }
+      return null;
+    }
+  }, {
+    key: "saveToStorage",
+    value: function saveToStorage(keyPair) {
+      if (typeof window === "undefined" || !window.localStorage) return;
+      try {
+        window.localStorage.setItem(getStorageKey(this.clientId), JSON.stringify(keyPair));
+      } catch (e) {
+        logger.warn("Failed to save device key to storage:", e);
+      }
+    }
+  }, {
+    key: "clearStorage",
+    value: function clearStorage() {
+      if (typeof window === "undefined" || !window.localStorage) return;
+      try {
+        window.localStorage.removeItem(getStorageKey(this.clientId));
+      } catch (_unused) {}
+    }
+  }]);
+}();
+
+export { DeviceKeyManager };
+//# sourceMappingURL=device-key-manager.js.map