@tdesign-react/chat 1.0.2-alpha.9 → 1.0.3-alpha.2

package/es/chat-engine/hooks/a2ui/useA2UISurface.js

@@ -0,0 +1,39 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import { useSyncExternalStore, useMemo } from 'react';
+
+function useA2UISurface(processor, surfaceId) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return snapshot.get(surfaceId);
+}
+function useA2UISurfaces(processor) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return useMemo(function () {
+    return Array.from(snapshot.values());
+  }, [snapshot]);
+}
+function useA2UIRoot(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return (surface === null || surface === void 0 ? void 0 : surface.root) || null;
+}
+function useA2UIData(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return surface === null || surface === void 0 ? void 0 : surface.data;
+}
+function useA2UISurfaceState(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return surface === null || surface === void 0 ? void 0 : surface.state;
+}
+function useA2UISurfaceIds(processor) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return useMemo(function () {
+    return Array.from(snapshot.keys());
+  }, [snapshot]);
+}
+
+export { useA2UIData, useA2UIRoot, useA2UISurface, useA2UISurfaceIds, useA2UISurfaceState, useA2UISurfaces };
+//# sourceMappingURL=useA2UISurface.js.map

package/es/chat-engine/hooks/a2ui/useA2UISurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useA2UISurface.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useA2UISurface.ts"],"sourcesContent":["/**\n * A2UI Surface 相关 Hooks\n */\n\nimport { useSyncExternalStore, useMemo } from 'react';\nimport type { A2uiMessageProcessor } from '../../core/a2ui';\nimport type { A2UISurface, ResolvedComponent } from '../../core/a2ui';\n\n/**\n * 订阅单个 Surface\n * \n * @example\n * ```tsx\n * const surface = useA2UISurface(processor, 'surface-1');\n * if (!surface) return <Loading />;\n * return <A2UIRenderer root={surface.root} />;\n * ```\n */\nexport function useA2UISurface(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): A2UISurface | undefined {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return snapshot.get(surfaceId);\n}\n\n/**\n * 订阅所有 Surface\n */\nexport function useA2UISurfaces(processor: A2uiMessageProcessor): A2UISurface[] {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return useMemo(() => Array.from(snapshot.values()), [snapshot]);\n}\n\n/**\n * 订阅 Surface 的组件树根节点\n */\nexport function useA2UIRoot(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): ResolvedComponent | null {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.root || null;\n}\n\n/**\n * 订阅 Surface 的数据模型\n */\nexport function useA2UIData<T = Record<string, unknown>>(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): T | undefined {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.data as T | undefined;\n}\n\n/**\n * 订阅 Surface 状态\n */\nexport function useA2UISurfaceState(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): 'active' | 'closed' | 'pending' | undefined {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.state;\n}\n\n/**\n * 获取 Surface IDs 列表\n */\nexport function useA2UISurfaceIds(processor: A2uiMessageProcessor): string[] {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return useMemo(() => Array.from(snapshot.keys()), [snapshot]);\n}\n"],"names":["useA2UISurface","processor","surfaceId","snapshot","useSyncExternalStore","subscribe","getSnapshot","getServerSnapshot","get","useA2UISurfaces","useMemo","Array","from","values","useA2UIRoot","surface","root","useA2UIData","data","useA2UISurfaceState","state","useA2UISurfaceIds","keys"],"mappings":";;;;;;;;AAkBgB,SAAAA,cAAAA,CACdC,WACAC,SACyB,EAAA;AACzB,EAAA,IAAMC,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAJ,QAAA,CAASK,IAAIN,SAAS,CAAA,CAAA;AAC/B,CAAA;AAKO,SAASO,gBAAgBR,SAAgD,EAAA;AAC9E,EAAA,IAAME,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAG,OAAA,CAAQ,YAAA;IAAA,OAAMC,KAAA,CAAMC,IAAK,CAAAT,QAAA,CAASU,QAAQ,CAAA,CAAA;GAAG,EAAA,CAACV,QAAQ,CAAC,CAAA,CAAA;AAChE,CAAA;AAKgB,SAAAW,WAAAA,CACdb,WACAC,SAC0B,EAAA;AACpB,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;EACnD,OAAO,CAAAa,YAAAA,IAAAA,IAAAA,8BAAAA,QAASC,IAAQ,KAAA,IAAA,CAAA;AAC1B,CAAA;AAKgB,SAAAC,WAAAA,CACdhB,WACAC,SACe,EAAA;AACT,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;AACnD,EAAA,OAAOa,OAAS,KAATA,IAAAA,IAAAA,OAAS,KAATA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAS,CAAAG,IAAA,CAAA;AAClB,CAAA;AAKgB,SAAAC,mBAAAA,CACdlB,WACAC,SAC6C,EAAA;AACvC,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;AACnD,EAAA,OAAOa,OAAS,KAATA,IAAAA,IAAAA,OAAS,KAATA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAS,CAAAK,KAAA,CAAA;AAClB,CAAA;AAKO,SAASC,kBAAkBpB,SAA2C,EAAA;AAC3E,EAAA,IAAME,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAG,OAAA,CAAQ,YAAA;IAAA,OAAMC,KAAA,CAAMC,IAAK,CAAAT,QAAA,CAASmB,MAAM,CAAA,CAAA;GAAG,EAAA,CAACnB,QAAQ,CAAC,CAAA,CAAA;AAC9D;;;;"}

package/es/chat-engine/hooks/a2ui/useDataBinding.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A2UI 数据绑定 Hooks
+ * 实现单向/双向数据绑定
+ */
+import type { Bindable } from '../../core/a2ui/types';
+/**
+ * 单向数据绑定 Hook
+ *
+ * 用于读取绑定值：
+ * - 如果是字面值，直接返回
+ * - 如果是路径绑定，从数据模型读取
+ *
+ * @example
+ * ```tsx
+ * function Text({ text }: { text: Bindable<string> }) {
+ *   const resolvedText = useDataBinding(text);
+ *   return <span>{resolvedText}</span>;
+ * }
+ * ```
+ */
+export declare function useDataBinding<T>(value: Bindable<T>): T;
+export declare function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined;
+/**
+ * 双向数据绑定 Hook
+ *
+ * 用于表单控件的双向绑定：
+ * - 读取：从数据模型获取当前值
+ * - 写入：更新数据模型
+ *
+ * @example
+ * ```tsx
+ * function TextField({ text }: { text: Bindable<string> }) {
+ *   const [inputValue, setInputValue] = useTwoWayBinding(text, '');
+ *   return <Input value={inputValue} onChange={setInputValue} />;
+ * }
+ * ```
+ */
+export declare function useTwoWayBinding<T>(value: Bindable<T> | undefined, defaultValue: T): [T, (newValue: T) => void];
+/**
+ * 获取路径绑定的完整路径
+ */
+export declare function useBindingPath(value: Bindable<unknown> | undefined): string | null;
+/**
+ * 批量解析绑定值
+ */
+export declare function useDataBindings<T extends Record<string, Bindable<unknown>>>(bindings: T): {
+    [K in keyof T]: T[K] extends Bindable<infer V> ? V : never;
+};
+/**
+ * 解析字符串中的绑定占位符
+ * 支持模板字符串格式: "Hello, {{/user/name}}!"
+ */
+export declare function useResolvedString(template: string | undefined): string;

package/es/chat-engine/hooks/a2ui/useDataBinding.js

@@ -0,0 +1,111 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import { useSyncExternalStore, useMemo, useCallback } from 'react';
+import { useA2UIContext } from './A2UIContext.js';
+import '../../core/a2ui/utils/index.js';
+import { resolveBinding, isPathBinding } from '../../core/a2ui/utils/binding.js';
+import '@babel/runtime/helpers/defineProperty';
+import '../../core/a2ui/utils/validation.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '@babel/runtime/helpers/typeof';
+
+function useDataBinding(value) {
+  var _useA2UIContext = useA2UIContext(),
+    processor = _useA2UIContext.processor,
+    surfaceId = _useA2UIContext.surfaceId,
+    dataContextPath = _useA2UIContext.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    if (value === void 0) return void 0;
+    return resolveBinding(value, data, dataContextPath);
+  }, [value, data, dataContextPath]);
+}
+function useTwoWayBinding(value, defaultValue) {
+  var _useA2UIContext2 = useA2UIContext(),
+    processor = _useA2UIContext2.processor,
+    surfaceId = _useA2UIContext2.surfaceId,
+    dataContextPath = _useA2UIContext2.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  var currentValue = useMemo(function () {
+    if (value === void 0) return defaultValue;
+    var resolved = resolveBinding(value, data, dataContextPath);
+    return resolved !== void 0 ? resolved : defaultValue;
+  }, [value, data, dataContextPath, defaultValue]);
+  var fullPath = useMemo(function () {
+    if (!isPathBinding(value)) return null;
+    var path = value.path;
+    if (path.startsWith("/")) return path;
+    if (!dataContextPath || dataContextPath === "/") {
+      return "/".concat(path);
+    }
+    return "".concat(dataContextPath, "/").concat(path).replace(/\/+/g, "/");
+  }, [value, dataContextPath]);
+  var setValue = useCallback(function (newValue) {
+    if (fullPath) {
+      processor.setData(surfaceId, fullPath, "", newValue);
+    }
+  }, [processor, surfaceId, fullPath]);
+  return [currentValue, setValue];
+}
+function useBindingPath(value) {
+  var _useA2UIContext3 = useA2UIContext(),
+    dataContextPath = _useA2UIContext3.dataContextPath;
+  return useMemo(function () {
+    if (!isPathBinding(value)) return null;
+    var path = value.path;
+    if (path.startsWith("/")) return path;
+    if (!dataContextPath || dataContextPath === "/") {
+      return "/".concat(path);
+    }
+    return "".concat(dataContextPath, "/").concat(path).replace(/\/+/g, "/");
+  }, [value, dataContextPath]);
+}
+function useDataBindings(bindings) {
+  var _useA2UIContext4 = useA2UIContext(),
+    processor = _useA2UIContext4.processor,
+    surfaceId = _useA2UIContext4.surfaceId,
+    dataContextPath = _useA2UIContext4.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    var result = {};
+    for (var _i = 0, _Object$entries = Object.entries(bindings); _i < _Object$entries.length; _i++) {
+      var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+        key = _Object$entries$_i[0],
+        value = _Object$entries$_i[1];
+      result[key] = resolveBinding(value, data, dataContextPath);
+    }
+    return result;
+  }, [bindings, data, dataContextPath]);
+}
+function useResolvedString(template) {
+  var _useA2UIContext5 = useA2UIContext(),
+    processor = _useA2UIContext5.processor,
+    surfaceId = _useA2UIContext5.surfaceId,
+    dataContextPath = _useA2UIContext5.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    if (!template) return "";
+    return template.replace(/\{\{([^}]+)\}\}/g, function (_, path) {
+      var value = resolveBinding({
+        path: path.trim()
+      }, data, dataContextPath);
+      return value !== void 0 ? String(value) : "";
+    });
+  }, [template, data, dataContextPath]);
+}
+
+export { useBindingPath, useDataBinding, useDataBindings, useResolvedString, useTwoWayBinding };
+//# sourceMappingURL=useDataBinding.js.map

package/es/chat-engine/hooks/a2ui/useDataBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataBinding.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useDataBinding.ts"],"sourcesContent":["/**\n * A2UI 数据绑定 Hooks\n * 实现单向/双向数据绑定\n */\n\nimport { useSyncExternalStore, useCallback, useMemo } from 'react';\nimport { useA2UIContext } from './A2UIContext';\nimport type { Bindable, PathBinding } from '../../core/a2ui/types';\nimport type { SurfaceSnapshot } from '../../core/a2ui/processor/A2uiMessageProcessor';\nimport { isPathBinding, resolveBinding } from '../../core/a2ui/utils';\n\n/**\n * 单向数据绑定 Hook\n * \n * 用于读取绑定值：\n * - 如果是字面值，直接返回\n * - 如果是路径绑定，从数据模型读取\n * \n * @example\n * ```tsx\n * function Text({ text }: { text: Bindable<string> }) {\n *   const resolvedText = useDataBinding(text);\n *   return <span>{resolvedText}</span>;\n * }\n * ```\n */\nexport function useDataBinding<T>(value: Bindable<T>): T;\nexport function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined;\nexport function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  // 订阅 processor 变化\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  // 从快照中获取 surface 数据\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  // 解析绑定值\n  return useMemo(() => {\n    if (value === undefined) return undefined;\n    return resolveBinding(value, data, dataContextPath);\n  }, [value, data, dataContextPath]);\n}\n\n/**\n * 双向数据绑定 Hook\n * \n * 用于表单控件的双向绑定：\n * - 读取：从数据模型获取当前值\n * - 写入：更新数据模型\n * \n * @example\n * ```tsx\n * function TextField({ text }: { text: Bindable<string> }) {\n *   const [inputValue, setInputValue] = useTwoWayBinding(text, '');\n *   return <Input value={inputValue} onChange={setInputValue} />;\n * }\n * ```\n */\nexport function useTwoWayBinding<T>(\n  value: Bindable<T> | undefined,\n  defaultValue: T\n): [T, (newValue: T) => void] {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  // 订阅 processor 变化\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  // 从快照中获取 surface 数据\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  // 解析当前值\n  const currentValue = useMemo(() => {\n    if (value === undefined) return defaultValue;\n    const resolved = resolveBinding(value, data, dataContextPath);\n    return resolved !== undefined ? resolved : defaultValue;\n  }, [value, data, dataContextPath, defaultValue]);\n\n  // 获取完整路径\n  const fullPath = useMemo(() => {\n    if (!isPathBinding(value)) return null;\n    const path = (value as PathBinding).path;\n    // 使用 processor 内部的 pathResolver 来解析路径\n    if (path.startsWith('/')) return path;\n    // 相对路径处理\n    if (!dataContextPath || dataContextPath === '/') {\n      return `/${path}`;\n    }\n    return `${dataContextPath}/${path}`.replace(/\\/+/g, '/');\n  }, [value, dataContextPath]);\n\n  // 更新函数\n  const setValue = useCallback(\n    (newValue: T) => {\n      if (fullPath) {\n        processor.setData(surfaceId, fullPath, '', newValue);\n      }\n    },\n    [processor, surfaceId, fullPath]\n  );\n\n  return [currentValue, setValue];\n}\n\n/**\n * 获取路径绑定的完整路径\n */\nexport function useBindingPath(value: Bindable<unknown> | undefined): string | null {\n  const { dataContextPath } = useA2UIContext();\n\n  return useMemo(() => {\n    if (!isPathBinding(value)) return null;\n    const path = (value as PathBinding).path;\n    if (path.startsWith('/')) return path;\n    if (!dataContextPath || dataContextPath === '/') {\n      return `/${path}`;\n    }\n    return `${dataContextPath}/${path}`.replace(/\\/+/g, '/');\n  }, [value, dataContextPath]);\n}\n\n/**\n * 批量解析绑定值\n */\nexport function useDataBindings<T extends Record<string, Bindable<unknown>>>(\n  bindings: T\n): { [K in keyof T]: T[K] extends Bindable<infer V> ? V : never } {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  return useMemo(() => {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(bindings)) {\n      result[key] = resolveBinding(value, data, dataContextPath);\n    }\n    return result as { [K in keyof T]: T[K] extends Bindable<infer V> ? V : never };\n  }, [bindings, data, dataContextPath]);\n}\n\n/**\n * 解析字符串中的绑定占位符\n * 支持模板字符串格式: \"Hello, {{/user/name}}!\"\n */\nexport function useResolvedString(template: string | undefined): string {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  return useMemo(() => {\n    if (!template) return '';\n    \n    // 匹配 {{path}} 格式\n    return template.replace(/\\{\\{([^}]+)\\}\\}/g, (_, path) => {\n      const value = resolveBinding({ path: path.trim() }, data, dataContextPath);\n      return value !== undefined ? String(value) : '';\n    });\n  }, [template, data, dataContextPath]);\n}\n"],"names":["useDataBinding","value","_useA2UIContext","useA2UIContext","processor","surfaceId","dataContextPath","snapshot","useSyncExternalStore","subscribe","getSnapshot","getServerSnapshot","surface","get","data","useMemo","resolveBinding","useTwoWayBinding","defaultValue","_useA2UIContext2","currentValue","resolved","fullPath","isPathBinding","path","startsWith","concat","replace","setValue","useCallback","newValue","setData","useBindingPath","_useA2UIContext3","useDataBindings","bindings","_useA2UIContext4","result","_i","_Object$entries","Object","entries","length","_Object$entries$_i","_slicedToArray","key","useResolvedString","template","_useA2UIContext5","_","trim","String"],"mappings":"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"}

package/es/chat-engine/hooks/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.6
+ * tdesign v1.0.2
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -14,7 +14,14 @@ import 'react';
 import 'tdesign-web-components/lib/chat-engine';
 import '@babel/runtime/helpers/toConsumableArray';
 import '../components/toolcall/registry.js';
+import '../components/shared/index.js';
+import '../components/shared/createRegistry.js';
+import '../components/shared/ComponentErrorBoundary.js';
 import '@babel/runtime/helpers/classCallCheck';
 import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../components/shared/useRegistrationListener.js';
 import '../components/activity/registry.js';
 //# sourceMappingURL=index.js.map

package/es/chat-engine/hooks/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/hooks/useAgentActivity.d.ts

@@ -6,8 +6,7 @@ export interface UseAgentActivityReturn {
     getRegistered: () => string[];
 }
 /**
- * Activity 注册管理 Hook
- * 简化版的 useAgentToolcall，专门用于 Activity 组件的注册管理
+ * Activity 注册管理 Hook，专门用于 Activity 组件的注册管理
  *
  * 支持两种使用模式：
  * 1. 自动注册模式：传入配置，自动注册和清理

package/es/chat-engine/hooks/useAgentActivity.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.6
+ * tdesign v1.0.2
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -7,9 +7,17 @@
 import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
 import { useRef, useCallback, useEffect } from 'react';
 import { activityRegistry } from '../components/activity/registry.js';
+import '../components/shared/index.js';
+import '../components/shared/createRegistry.js';
+import '@babel/runtime/helpers/defineProperty';
+import '../components/shared/ComponentErrorBoundary.js';
 import '@babel/runtime/helpers/classCallCheck';
 import '@babel/runtime/helpers/createClass';
-import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../components/shared/useRegistrationListener.js';
+import '@babel/runtime/helpers/slicedToArray';
 
 function useAgentActivity(config) {
   var registeredTypesRef = useRef(/* @__PURE__ */new Set());

package/es/chat-engine/hooks/useAgentActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentActivity.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentActivity.ts"],"sourcesContent":["import { useCallback, useRef, useEffect } from 'react';\nimport type { ActivityConfig } from '../components/activity/types';\nimport { activityRegistry } from '../components/activity/registry';\n\nexport interface UseAgentActivityReturn {\n  register: (config: ActivityConfig | ActivityConfig[]) => void;\n  unregister: (activityTypes: string | string[]) => void;\n  isRegistered: (activityType: string) => boolean;\n  getRegistered: () => string[];\n}\n\n/**\n * Activity 注册管理 Hook\n * 简化版的 useAgentToolcall，专门用于 Activity 组件的注册管理\n * \n * 支持两种使用模式：\n * 1. 自动注册模式：传入配置，自动注册和清理\n * 2. 手动注册模式：不传配置，返回注册方法由业务控制\n */\nexport function useAgentActivity<TContent = any>(\n  config?: ActivityConfig<TContent> | ActivityConfig<TContent>[] | null | undefined,\n): UseAgentActivityReturn {\n  const registeredTypesRef = useRef<Set<string>>(new Set());\n  const autoRegisteredTypesRef = useRef<Set<string>>(new Set());\n\n  // 手动注册方法\n  const register = useCallback((newConfig: ActivityConfig | ActivityConfig[]) => {\n    if (!newConfig) {\n      console.warn('[useAgentActivity] 配置为空，跳过注册');\n      return;\n    }\n\n    const configs = Array.isArray(newConfig) ? newConfig : [newConfig];\n\n    configs.forEach((cfg) => {\n      if (activityRegistry.has(cfg.activityType)) {\n        console.warn(`[useAgentActivity] Activity 类型 \"${cfg.activityType}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      activityRegistry.register(cfg);\n      registeredTypesRef.current.add(cfg.activityType);\n    });\n  }, []);\n\n  // 手动取消注册方法\n  const unregister = useCallback((activityTypes: string | string[]) => {\n    const typeArray = Array.isArray(activityTypes) ? activityTypes : [activityTypes];\n\n    typeArray.forEach((activityType) => {\n      activityRegistry.unregister(activityType);\n      registeredTypesRef.current.delete(activityType);\n      autoRegisteredTypesRef.current.delete(activityType);\n    });\n  }, []);\n\n  // 检查是否已注册\n  const isRegistered = useCallback(\n    (activityType: string) => \n      registeredTypesRef.current.has(activityType) || \n      autoRegisteredTypesRef.current.has(activityType),\n    [],\n  );\n\n  // 获取所有已注册的 Activity 类型\n  const getRegistered = useCallback(\n    () => Array.from(new Set([...registeredTypesRef.current, ...autoRegisteredTypesRef.current])),\n    [],\n  );\n\n  // 自动注册逻辑（当传入配置时）\n  useEffect(() => {\n    if (!config) {\n      return;\n    }\n\n    const configs = Array.isArray(config) ? config : [config];\n    \n    configs.forEach((cfg) => {\n      if (activityRegistry.has(cfg.activityType)) {\n        console.warn(`[useAgentActivity] Activity 类型 \"${cfg.activityType}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      activityRegistry.register(cfg);\n      autoRegisteredTypesRef.current.add(cfg.activityType);\n    });\n\n    // 清理函数：取消注册自动注册的配置\n    return () => {\n      configs.forEach((cfg) => {\n        activityRegistry.unregister(cfg.activityType);\n        autoRegisteredTypesRef.current.delete(cfg.activityType);\n      });\n    };\n  }, [config]);\n\n  return {\n    register,\n    unregister,\n    isRegistered,\n    getRegistered,\n  };\n}"],"names":["useAgentActivity","config","registeredTypesRef","useRef","Set","autoRegisteredTypesRef","register","useCallback","newConfig","console","warn","configs","Array","isArray","forEach","cfg","activityRegistry","has","activityType","concat","current","add","unregister","activityTypes","typeArray","isRegistered","getRegistered","from","_toConsumableArray","useEffect"],"mappings":"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"}
+{"version":3,"file":"useAgentActivity.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentActivity.ts"],"sourcesContent":["/* eslint-disable react-hooks/exhaustive-deps */\nimport { useCallback, useRef, useEffect } from 'react';\nimport type { ActivityConfig } from '../components/activity/types';\nimport { activityRegistry } from '../components/activity/registry';\n\nexport interface UseAgentActivityReturn {\n  register: (config: ActivityConfig | ActivityConfig[]) => void;\n  unregister: (activityTypes: string | string[]) => void;\n  isRegistered: (activityType: string) => boolean;\n  getRegistered: () => string[];\n}\n\n/**\n * Activity 注册管理 Hook，专门用于 Activity 组件的注册管理\n *\n * 支持两种使用模式：\n * 1. 自动注册模式：传入配置，自动注册和清理\n * 2. 手动注册模式：不传配置，返回注册方法由业务控制\n */\nexport function useAgentActivity<TContent = any>(\n  config?: ActivityConfig<TContent> | ActivityConfig<TContent>[] | null | undefined,\n): UseAgentActivityReturn {\n  const registeredTypesRef = useRef<Set<string>>(new Set());\n  const autoRegisteredTypesRef = useRef<Set<string>>(new Set());\n\n  // 手动注册方法\n  const register = useCallback((newConfig: ActivityConfig | ActivityConfig[]) => {\n    if (!newConfig) {\n      console.warn('[useAgentActivity] 配置为空，跳过注册');\n      return;\n    }\n\n    const configs = Array.isArray(newConfig) ? newConfig : [newConfig];\n\n    configs.forEach((cfg) => {\n      if (activityRegistry.has(cfg.activityType)) {\n        console.warn(`[useAgentActivity] Activity 类型 \"${cfg.activityType}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      activityRegistry.register(cfg);\n      registeredTypesRef.current.add(cfg.activityType);\n    });\n  }, []);\n\n  // 手动取消注册方法\n  const unregister = useCallback((activityTypes: string | string[]) => {\n    const typeArray = Array.isArray(activityTypes) ? activityTypes : [activityTypes];\n\n    typeArray.forEach((activityType) => {\n      activityRegistry.unregister(activityType);\n      registeredTypesRef.current.delete(activityType);\n      autoRegisteredTypesRef.current.delete(activityType);\n    });\n  }, []);\n\n  // 检查是否已注册\n  const isRegistered = useCallback(\n    (activityType: string) =>\n      registeredTypesRef.current.has(activityType) || autoRegisteredTypesRef.current.has(activityType),\n    [],\n  );\n\n  // 获取所有已注册的 Activity 类型\n  const getRegistered = useCallback(\n    () => Array.from(new Set([...registeredTypesRef.current, ...autoRegisteredTypesRef.current])),\n    [],\n  );\n\n  // 自动注册逻辑（当传入配置时）\n  useEffect(() => {\n    if (!config) {\n      return;\n    }\n\n    const configs = Array.isArray(config) ? config : [config];\n\n    configs.forEach((cfg) => {\n      if (activityRegistry.has(cfg.activityType)) {\n        console.warn(`[useAgentActivity] Activity 类型 \"${cfg.activityType}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      activityRegistry.register(cfg);\n      autoRegisteredTypesRef.current.add(cfg.activityType);\n    });\n\n    // 清理函数：取消注册自动注册的配置\n    return () => {\n      configs.forEach((cfg) => {\n        activityRegistry.unregister(cfg.activityType);\n        autoRegisteredTypesRef.current.delete(cfg.activityType);\n      });\n    };\n  }, [config]);\n\n  return {\n    register,\n    unregister,\n    isRegistered,\n    getRegistered,\n  };\n}\n"],"names":["useAgentActivity","config","registeredTypesRef","useRef","Set","autoRegisteredTypesRef","register","useCallback","newConfig","console","warn","configs","Array","isArray","forEach","cfg","activityRegistry","has","activityType","concat","current","add","unregister","activityTypes","typeArray","isRegistered","getRegistered","from","_toConsumableArray","useEffect"],"mappings":"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"}

package/es/chat-engine/hooks/useAgentState.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.6
+ * tdesign v1.0.2
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/hooks/useAgentState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentState.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentState.ts"],"sourcesContent":["/* eslint-disable react-hooks/exhaustive-deps */\nimport { useState, useEffect, useRef, createContext, useContext, useMemo } from 'react';\nimport { stateManager } from 'tdesign-web-components/lib/chat-engine';\n// import { stateManager } from '../core';\n/**\n * 状态订阅相关类型定义\n */\n\nexport interface StateActionOptions {\n  /**\n   * 初始状态\n   */\n  initialState?: Record<string, any>;\n  /**\n   * 只订阅特定key的变化\n   */\n  subscribeKey?: string;\n}\n\nexport interface UseStateActionReturn {\n  /**\n   * 全量状态Map - 包含所有stateKey的状态\n   * 格式: { [stateKey]: stateData }\n   */\n  stateMap: Record<string, any>;\n  /**\n   * 当前最新的状态key\n   */\n  currentStateKey: string | null;\n  /**\n   * 设置状态Map，用于加载历史对话消息中的state数据\n   */\n  setStateMap: (stateMap: Record<string, any> | ((prev: Record<string, any>) => Record<string, any>)) => void;\n  /**\n   * 获取当前完整状态的方法\n   */\n  getCurrentState: () => Record<string, any>;\n  /**\n   * 获取特定 key 状态的方法\n   */\n  getStateByKey: (key: string) => any;\n}\n\nexport const useAgentState = <T = any>(options: StateActionOptions = {}): UseStateActionReturn => {\n  const { initialState, subscribeKey } = options;\n  const [stateMap, setStateMap] = useState<Record<string, any>>(initialState || {});\n  const [currentStateKey, setCurrentStateKey] = useState<string | null>(null);\n\n  // 使用 ref 来避免不必要的重新渲染\n  const stateMapRef = useRef(stateMap);\n  stateMapRef.current = stateMap;\n\n  useEffect(\n    () =>\n      stateManager.subscribeToLatest((newState: T, newStateKey: string) => {\n        // 如果指定了 subscribeKey，只有匹配时才更新状态\n        if (subscribeKey && newStateKey !== subscribeKey) {\n          // 仍然更新内部状态，但不触发重新渲染\n          stateMapRef.current = {\n            ...stateMapRef.current,\n            [newStateKey]: newState,\n          };\n          return;\n        }\n\n        setStateMap((prev) => ({\n          ...prev,\n          [newStateKey]: newState,\n        }));\n        setCurrentStateKey(newStateKey);\n      }),\n    [subscribeKey],\n  );\n\n  return {\n    stateMap: stateMapRef.current,\n    currentStateKey,\n    setStateMap,\n    getCurrentState: () => stateMapRef.current,\n    getStateByKey: (key: string) => stateMapRef.current[key],\n  };\n};\n\n// 创建 AgentState Context\nexport const AgentStateContext = createContext<UseStateActionReturn | null>(null);\n\n// 简化的状态选择器\nexport const useAgentStateDataByKey = (stateKey?: string) => {\n  const contextState = useContext(AgentStateContext);\n  const independentState = useAgentState({ subscribeKey: stateKey });\n\n  return useMemo(() => {\n    if (contextState) {\n      // 有 Provider，使用 Context 状态\n      const { stateMap } = contextState;\n      return stateKey ? stateMap[stateKey] : stateMap;\n    }\n\n    // 没有 Provider，使用独立状态\n    const { stateMap } = independentState;\n    return stateKey ? stateMap[stateKey] : stateMap;\n  }, [\n    stateKey,\n    // 关键：添加和 useAgentStateByKey 相同的深度依赖逻辑\n    contextState && (stateKey ? contextState.stateMap[stateKey] : JSON.stringify(contextState.stateMap)),\n    independentState && (stateKey ? independentState.stateMap[stateKey] : JSON.stringify(independentState.stateMap)),\n  ]);\n};\n\n// 导出 Context Hook\nexport const useAgentStateContext = (): UseStateActionReturn => {\n  const context = useContext(AgentStateContext);\n\n  if (!context) {\n    throw new Error('useAgentState must be used within AgentStateProvider');\n  }\n\n  return context;\n};\n"],"names":["useAgentState","options","arguments","length","undefined","initialState","subscribeKey","_useState","useState","_useState2","_slicedToArray","stateMap","setStateMap","_useState3","_useState4","currentStateKey","setCurrentStateKey","stateMapRef","useRef","current","useEffect","stateManager","subscribeToLatest","newState","newStateKey","_objectSpread","_defineProperty","prev","getCurrentState","getStateByKey","key","AgentStateContext","createContext","useAgentStateDataByKey","stateKey","contextState","useContext","independentState","useMemo","JSON","stringify","useAgentStateContext","context","Error"],"mappings":"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"}
+{"version":3,"file":"useAgentState.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentState.ts"],"sourcesContent":["/* eslint-disable react-hooks/exhaustive-deps */\nimport { useState, useEffect, useRef, createContext, useContext, useMemo } from 'react';\n// import { stateManager } from 'tdesign-web-components/lib/chat-engine';\nimport { stateManager } from 'tdesign-web-components/lib/chat-engine';\n\n/**\n * 状态订阅相关类型定义\n */\n\nexport interface StateActionOptions {\n  /**\n   * 初始状态\n   */\n  initialState?: Record<string, any>;\n  /**\n   * 只订阅特定key的变化\n   */\n  subscribeKey?: string;\n}\n\nexport interface UseStateActionReturn {\n  /**\n   * 全量状态Map - 包含所有stateKey的状态\n   * 格式: { [stateKey]: stateData }\n   */\n  stateMap: Record<string, any>;\n  /**\n   * 当前最新的状态key\n   */\n  currentStateKey: string | null;\n  /**\n   * 设置状态Map，用于加载历史对话消息中的state数据\n   */\n  setStateMap: (stateMap: Record<string, any> | ((prev: Record<string, any>) => Record<string, any>)) => void;\n  /**\n   * 获取当前完整状态的方法\n   */\n  getCurrentState: () => Record<string, any>;\n  /**\n   * 获取特定 key 状态的方法\n   */\n  getStateByKey: (key: string) => any;\n}\n\nexport const useAgentState = <T = any>(options: StateActionOptions = {}): UseStateActionReturn => {\n  const { initialState, subscribeKey } = options;\n  const [stateMap, setStateMap] = useState<Record<string, any>>(initialState || {});\n  const [currentStateKey, setCurrentStateKey] = useState<string | null>(null);\n\n  // 使用 ref 来避免不必要的重新渲染\n  const stateMapRef = useRef(stateMap);\n  stateMapRef.current = stateMap;\n\n  useEffect(\n    () =>\n      stateManager.subscribeToLatest((newState: T, newStateKey: string) => {\n        // 如果指定了 subscribeKey，只有匹配时才更新状态\n        if (subscribeKey && newStateKey !== subscribeKey) {\n          // 仍然更新内部状态，但不触发重新渲染\n          stateMapRef.current = {\n            ...stateMapRef.current,\n            [newStateKey]: newState,\n          };\n          return;\n        }\n\n        setStateMap((prev) => ({\n          ...prev,\n          [newStateKey]: newState,\n        }));\n        setCurrentStateKey(newStateKey);\n      }),\n    [subscribeKey],\n  );\n\n  return {\n    stateMap: stateMapRef.current,\n    currentStateKey,\n    setStateMap,\n    getCurrentState: () => stateMapRef.current,\n    getStateByKey: (key: string) => stateMapRef.current[key],\n  };\n};\n\n// 创建 AgentState Context\nexport const AgentStateContext = createContext<UseStateActionReturn | null>(null);\n\n// 简化的状态选择器\nexport const useAgentStateDataByKey = (stateKey?: string) => {\n  const contextState = useContext(AgentStateContext);\n  const independentState = useAgentState({ subscribeKey: stateKey });\n\n  return useMemo(() => {\n    if (contextState) {\n      // 有 Provider，使用 Context 状态\n      const { stateMap } = contextState;\n      return stateKey ? stateMap[stateKey] : stateMap;\n    }\n\n    // 没有 Provider，使用独立状态\n    const { stateMap } = independentState;\n    return stateKey ? stateMap[stateKey] : stateMap;\n  }, [\n    stateKey,\n    // 关键：添加和 useAgentStateByKey 相同的深度依赖逻辑\n    contextState && (stateKey ? contextState.stateMap[stateKey] : JSON.stringify(contextState.stateMap)),\n    independentState && (stateKey ? independentState.stateMap[stateKey] : JSON.stringify(independentState.stateMap)),\n  ]);\n};\n\n// 导出 Context Hook\nexport const useAgentStateContext = (): UseStateActionReturn => {\n  const context = useContext(AgentStateContext);\n\n  if (!context) {\n    throw new Error('useAgentState must be used within AgentStateProvider');\n  }\n\n  return context;\n};\n"],"names":["useAgentState","options","arguments","length","undefined","initialState","subscribeKey","_useState","useState","_useState2","_slicedToArray","stateMap","setStateMap","_useState3","_useState4","currentStateKey","setCurrentStateKey","stateMapRef","useRef","current","useEffect","stateManager","subscribeToLatest","newState","newStateKey","_objectSpread","_defineProperty","prev","getCurrentState","getStateByKey","key","AgentStateContext","createContext","useAgentStateDataByKey","stateKey","contextState","useContext","independentState","useMemo","JSON","stringify","useAgentStateContext","context","Error"],"mappings":"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"}

package/es/chat-engine/hooks/useAgentToolcall.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.6
+ * tdesign v1.0.2
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -7,9 +7,17 @@
 import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
 import { useRef, useCallback, useEffect } from 'react';
 import { agentToolcallRegistry } from '../components/toolcall/registry.js';
+import '../components/shared/index.js';
+import '../components/shared/createRegistry.js';
+import '@babel/runtime/helpers/defineProperty';
+import '../components/shared/ComponentErrorBoundary.js';
 import '@babel/runtime/helpers/classCallCheck';
 import '@babel/runtime/helpers/createClass';
-import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../components/shared/useRegistrationListener.js';
+import '@babel/runtime/helpers/slicedToArray';
 
 function useAgentToolcall(config) {
   var registeredNamesRef = useRef(/* @__PURE__ */new Set());

package/es/chat-engine/hooks/useAgentToolcall.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentToolcall.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentToolcall.ts"],"sourcesContent":["import { useCallback, useRef, useEffect } from 'react';\nimport type { AgentToolcallConfig, ToolcallComponentProps } from '../components/toolcall/types';\nimport { agentToolcallRegistry } from '../components/toolcall/registry';\n\nexport interface UseAgentToolcallReturn {\n  register: (config: AgentToolcallConfig | AgentToolcallConfig[]) => void;\n  unregister: (names: string | string[]) => void;\n  isRegistered: (name: string) => boolean;\n  getRegistered: () => string[];\n  config: any;\n}\n\n/**\n * 统一的、智能的 Agent Toolcall 适配器 Hook，\n * 注册管理：负责工具配置的注册、取消注册、状态跟踪；生命周期管理：自动清理、防止内存泄漏\n * 支持两种使用模式：\n * 1. 自动注册模式：传入配置，自动注册和清理\n * 2. 手动注册模式：不传配置或传入null，返回注册方法由业务控制\n */\nexport function useAgentToolcall<TArgs extends object = any, TResult = any, TResponse = any>(\n  config?:\n    | AgentToolcallConfig<TArgs, TResult, TResponse>\n    | AgentToolcallConfig<TArgs, TResult, TResponse>[]\n    | null\n    | undefined,\n): UseAgentToolcallReturn {\n  const registeredNamesRef = useRef<Set<string>>(new Set());\n  const autoRegisteredNamesRef = useRef<Set<string>>(new Set());\n  const configRef = useRef(config);\n\n  // 手动注册方法\n  const register = useCallback((newConfig: AgentToolcallConfig | AgentToolcallConfig[]) => {\n    if (!newConfig) {\n      console.warn('[useAgentToolcall] 配置为空，跳过注册');\n      return;\n    }\n\n    const configs = Array.isArray(newConfig) ? newConfig : [newConfig];\n\n    configs.forEach((cfg) => {\n      if (agentToolcallRegistry.get(cfg.name)) {\n        console.warn(`[useAgentToolcall] 配置名称 \"${cfg.name}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      agentToolcallRegistry.register(cfg);\n      registeredNamesRef.current.add(cfg.name);\n    });\n  }, []);\n\n  // 手动取消注册方法\n  const unregister = useCallback((names: string | string[]) => {\n    const nameArray = Array.isArray(names) ? names : [names];\n\n    nameArray.forEach((name) => {\n      agentToolcallRegistry.unregister(name);\n      registeredNamesRef.current.delete(name);\n      autoRegisteredNamesRef.current.delete(name);\n    });\n  }, []);\n\n  // 检查是否已注册\n  const isRegistered = useCallback(\n    (name: string) => registeredNamesRef.current.has(name) || autoRegisteredNamesRef.current.has(name),\n    [],\n  );\n\n  // 获取所有已注册的配置名称\n  const getRegistered = useCallback(\n    () => Array.from(new Set([...registeredNamesRef.current, ...autoRegisteredNamesRef.current])),\n    [],\n  );\n\n  // 自动注册逻辑（当传入配置时）\n  useEffect(() => {\n    if (!config) {\n      return;\n    }\n\n    const configs = Array.isArray(config) ? config : [config];\n    configs.forEach((cfg) => {\n      if (agentToolcallRegistry.get(cfg.name)) {\n        console.warn(`[useAgentToolcall] 配置名称 \"${cfg.name}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      agentToolcallRegistry.register(cfg);\n      autoRegisteredNamesRef.current.add(cfg.name);\n    });\n\n    // 清理函数：取消注册自动注册的配置\n    return () => {\n      configs.forEach((cfg) => {\n        agentToolcallRegistry.unregister(cfg.name);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n        autoRegisteredNamesRef.current.delete(cfg.name);\n      });\n    };\n  }, [config]);\n\n  // 更新配置引用\n  useEffect(() => {\n    configRef.current = config;\n  }, [config]);\n\n  return {\n    register,\n    unregister,\n    isRegistered,\n    getRegistered,\n    config: configRef.current,\n  };\n}\n\n// 创建带状态感知的工具配置（带状态变化事件），状态注入，自动为组件注入 agentState\nexport interface ToolConfigWithStateOptions<TArgs extends object = any, TResult = any> {\n  name: string;\n  description: string;\n  parameters: Array<{ name: string; type: string }>;\n  subscribeKey?: (props: ToolcallComponentProps<TArgs, TResult>) => string | undefined;\n  component: React.ComponentType<ToolcallComponentProps<TArgs, TResult> & { agentState?: Record<string, any> }>;\n}\n"],"names":["useAgentToolcall","config","registeredNamesRef","useRef","Set","autoRegisteredNamesRef","configRef","register","useCallback","newConfig","console","warn","configs","Array","isArray","forEach","cfg","agentToolcallRegistry","get","name","concat","current","add","unregister","names","nameArray","isRegistered","has","getRegistered","from","_toConsumableArray","useEffect"],"mappings":"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"}
+{"version":3,"file":"useAgentToolcall.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentToolcall.ts"],"sourcesContent":["import { useCallback, useRef, useEffect } from 'react';\nimport type { AgentToolcallConfig, ToolcallComponentProps } from '../components/toolcall/types';\nimport { agentToolcallRegistry } from '../components/toolcall/registry';\n\nexport interface UseAgentToolcallReturn {\n  register: (config: AgentToolcallConfig | AgentToolcallConfig[]) => void;\n  unregister: (names: string | string[]) => void;\n  isRegistered: (name: string) => boolean;\n  getRegistered: () => string[];\n  config: any;\n}\n\n/**\n * 统一的、智能的 Agent Toolcall 适配器 Hook，\n * 注册管理：负责工具配置的注册、取消注册、状态跟踪；生命周期管理：自动清理、防止内存泄漏\n * 支持两种使用模式：\n * 1. 自动注册模式：传入配置，自动注册和清理\n * 2. 手动注册模式：不传配置或传入null，返回注册方法由业务控制\n */\nexport function useAgentToolcall<TArgs extends object = any, TResult = any, TResponse = any>(\n  config?:\n    | AgentToolcallConfig<TArgs, TResult, TResponse>\n    | AgentToolcallConfig<TArgs, TResult, TResponse>[]\n    | null\n    | undefined,\n): UseAgentToolcallReturn {\n  const registeredNamesRef = useRef<Set<string>>(new Set());\n  const autoRegisteredNamesRef = useRef<Set<string>>(new Set());\n  const configRef = useRef(config);\n\n  // 手动注册方法\n  const register = useCallback((newConfig: AgentToolcallConfig | AgentToolcallConfig[]) => {\n    if (!newConfig) {\n      console.warn('[useAgentToolcall] 配置为空，跳过注册');\n      return;\n    }\n\n    const configs = Array.isArray(newConfig) ? newConfig : [newConfig];\n\n    configs.forEach((cfg) => {\n      if (agentToolcallRegistry.get(cfg.name)) {\n        console.warn(`[useAgentToolcall] 配置名称 \"${cfg.name}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      agentToolcallRegistry.register(cfg);\n      registeredNamesRef.current.add(cfg.name);\n    });\n  }, []);\n\n  // 手动取消注册方法\n  const unregister = useCallback((names: string | string[]) => {\n    const nameArray = Array.isArray(names) ? names : [names];\n\n    nameArray.forEach((name) => {\n      agentToolcallRegistry.unregister(name);\n      registeredNamesRef.current.delete(name);\n      autoRegisteredNamesRef.current.delete(name);\n    });\n  }, []);\n\n  // 检查是否已注册\n  const isRegistered = useCallback(\n    (name: string) => registeredNamesRef.current.has(name) || autoRegisteredNamesRef.current.has(name),\n    [],\n  );\n\n  // 获取所有已注册的配置名称\n  const getRegistered = useCallback(\n    () => Array.from(new Set([...registeredNamesRef.current, ...autoRegisteredNamesRef.current])),\n    [],\n  );\n\n  // 自动注册逻辑（当传入配置时）\n  useEffect(() => {\n    if (!config) {\n      return;\n    }\n\n    const configs = Array.isArray(config) ? config : [config];\n    configs.forEach((cfg) => {\n      if (agentToolcallRegistry.get(cfg.name)) {\n        console.warn(`[useAgentToolcall] 配置名称 \"${cfg.name}\" 已存在于注册表中，将被覆盖`);\n      }\n\n      agentToolcallRegistry.register(cfg);\n      autoRegisteredNamesRef.current.add(cfg.name);\n    });\n\n    // 清理函数：取消注册自动注册的配置\n    return () => {\n      configs.forEach((cfg) => {\n        agentToolcallRegistry.unregister(cfg.name);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n        autoRegisteredNamesRef.current.delete(cfg.name);\n      });\n    };\n  }, [config]);\n\n  // 更新配置引用\n  useEffect(() => {\n    configRef.current = config;\n  }, [config]);\n\n  return {\n    register,\n    unregister,\n    isRegistered,\n    getRegistered,\n    config: configRef.current,\n  };\n}\n\n// 创建带状态感知的工具配置（带状态变化事件），状态注入，自动为组件注入 agentState\nexport interface ToolConfigWithStateOptions<TArgs extends object = any, TResult = any> {\n  name: string;\n  description: string;\n  parameters: Array<{ name: string; type: string }>;\n  subscribeKey?: (props: ToolcallComponentProps<TArgs, TResult>) => string | undefined;\n  component: React.ComponentType<ToolcallComponentProps<TArgs, TResult> & { agentState?: Record<string, any> }>;\n}\n"],"names":["useAgentToolcall","config","registeredNamesRef","useRef","Set","autoRegisteredNamesRef","configRef","register","useCallback","newConfig","console","warn","configs","Array","isArray","forEach","cfg","agentToolcallRegistry","get","name","concat","current","add","unregister","names","nameArray","isRegistered","has","getRegistered","from","_toConsumableArray","useEffect"],"mappings":"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"}

package/es/chat-engine/hooks/useChat.d.ts

@@ -2,7 +2,7 @@ import ChatEngine from 'tdesign-web-components/lib/chat-engine';
 import type { ChatMessagesData, ChatServiceConfig, ChatStatus } from 'tdesign-web-components/lib/chat-engine';
 export type IUseChat = {
     defaultMessages?: ChatMessagesData[];
-    chatServiceConfig: ChatServiceConfig;
+    chatServiceConfig: ChatServiceConfig | (() => ChatServiceConfig);
 };
 export declare const useChat: ({ defaultMessages: initialMessages, chatServiceConfig }: IUseChat) => {
     chatEngine: ChatEngine;

package/es/chat-engine/hooks/useChat.js

@@ -1,12 +1,12 @@
 /**
- * tdesign v1.0.2-alpha.6
+ * tdesign v1.0.2
  * (c) 2026 tdesign
  * @license MIT
  */
 
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import { useState, useRef, useEffect } from 'react';
-import ChatEngine from 'tdesign-web-components/lib/chat-engine';
+import ChatEngine__default from 'tdesign-web-components/lib/chat-engine';
 
 var useChat = function useChat(_ref) {
   var initialMessages = _ref.defaultMessages,
@@ -19,7 +19,7 @@ var useChat = function useChat(_ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     status = _useState4[0],
     setStatus = _useState4[1];
-  var chatEngineRef = useRef(new ChatEngine());
+  var chatEngineRef = useRef(new ChatEngine__default());
   var msgSubscribeRef = useRef(null);
   var prevInitialMessagesRef = useRef([]);
   var chatEngine = chatEngineRef.current;

package/es/chat-engine/hooks/useChat.js.map

@@ -1 +1 @@
-{"version":3,"file":"useChat.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useChat.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n// import ChatEngine from '../core';\n// import type { ChatMessagesData, ChatServiceConfig, ChatStatus } from '../core';\nimport ChatEngine from 'tdesign-web-components/lib/chat-engine';\nimport type { ChatMessagesData, ChatServiceConfig, ChatStatus } from 'tdesign-web-components/lib/chat-engine';\n\n\nexport type IUseChat = {\n  defaultMessages?: ChatMessagesData[];\n  chatServiceConfig: ChatServiceConfig;\n};\n\nexport const useChat = ({ defaultMessages: initialMessages, chatServiceConfig }: IUseChat) => {\n  const [messages, setMessage] = useState<ChatMessagesData[]>([]);\n  const [status, setStatus] = useState<ChatStatus>('idle');\n  const chatEngineRef = useRef<ChatEngine>(new ChatEngine());\n  const msgSubscribeRef = useRef<null | (() => void)>(null);\n  const prevInitialMessagesRef = useRef<ChatMessagesData[]>([]);\n\n  const chatEngine = chatEngineRef.current;\n\n  const syncState = (state: ChatMessagesData[]) => {\n    setMessage(state);\n    setStatus(state.at(-1)?.status || 'idle');\n  };\n\n  const subscribeToChat = () => {\n    // 清理之前的订阅\n    msgSubscribeRef.current?.();\n\n    msgSubscribeRef.current = chatEngine.messageStore.subscribe((state) => {\n      syncState(state.messages);\n    });\n  };\n\n  const initChat = () => {\n    // @ts-ignore\n    chatEngine.init(chatServiceConfig, initialMessages);\n    // @ts-ignore\n    syncState(initialMessages);\n    subscribeToChat();\n  };\n\n  // 初始化聊天引擎\n  useEffect(() => {\n    initChat();\n    return () => msgSubscribeRef.current?.();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // 监听 defaultMessages 变化\n  useEffect(() => {\n    // 检查 initialMessages 是否真的发生了变化\n    const hasChanged = JSON.stringify(prevInitialMessagesRef.current) !== JSON.stringify(initialMessages);\n\n    if (hasChanged && initialMessages && initialMessages.length > 0) {\n      // 更新引用\n      prevInitialMessagesRef.current = initialMessages;\n\n      // 重新初始化聊天引擎或更新消息\n      chatEngine.setMessages(initialMessages, 'replace');\n\n      // 同步状态\n      syncState(initialMessages);\n    }\n  }, [initialMessages, chatEngine]);\n\n  return {\n    chatEngine,\n    messages,\n    status,\n  };\n};\n"],"names":["useChat","initialMessages","_ref","defaultMessages","chatServiceConfig","_useState","useState","_useState2","_slicedToArray","messages","setMessage","_useState3","_useState4","status","setStatus","chatEngineRef","useRef","ChatEngine","msgSubscribeRef","prevInitialMessagesRef","chatEngine","current","syncState","state","_state$at","at","subscribeToChat","_msgSubscribeRef$curr","call","messageStore","subscribe","initChat","init","useEffect","_msgSubscribeRef$curr2","hasChanged","JSON","stringify","length","setMessages"],"mappings":"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"}
+{"version":3,"file":"useChat.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useChat.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\nimport ChatEngine from 'tdesign-web-components/lib/chat-engine';\nimport type { ChatMessagesData, ChatServiceConfig, ChatStatus } from 'tdesign-web-components/lib/chat-engine';\n// import ChatEngine from 'tdesign-web-components/lib/chat-engine';\n// import type { ChatMessagesData, ChatServiceConfig, ChatStatus } from 'tdesign-web-components/lib/chat-engine';\n\nexport type IUseChat = {\n  defaultMessages?: ChatMessagesData[];\n  chatServiceConfig: ChatServiceConfig | (() => ChatServiceConfig);\n};\n\nexport const useChat = ({ defaultMessages: initialMessages, chatServiceConfig }: IUseChat) => {\n  const [messages, setMessage] = useState<ChatMessagesData[]>([]);\n  const [status, setStatus] = useState<ChatStatus>('idle');\n  const chatEngineRef = useRef<ChatEngine>(new ChatEngine());\n  const msgSubscribeRef = useRef<null | (() => void)>(null);\n  const prevInitialMessagesRef = useRef<ChatMessagesData[]>([]);\n\n  const chatEngine = chatEngineRef.current;\n\n  const syncState = (state: ChatMessagesData[]) => {\n    setMessage(state);\n    setStatus(state.at(-1)?.status || 'idle');\n  };\n\n  const subscribeToChat = () => {\n    // 清理之前的订阅\n    msgSubscribeRef.current?.();\n\n    msgSubscribeRef.current = chatEngine.messageStore.subscribe((state) => {\n      syncState(state.messages);\n    });\n  };\n\n  const initChat = () => {\n    // @ts-ignore\n    chatEngine.init(chatServiceConfig, initialMessages);\n    // @ts-ignore\n    syncState(initialMessages);\n    subscribeToChat();\n  };\n\n  // 初始化聊天引擎\n  useEffect(() => {\n    initChat();\n    return () => msgSubscribeRef.current?.();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // 监听 defaultMessages 变化\n  useEffect(() => {\n    // 检查 initialMessages 是否真的发生了变化\n    const hasChanged = JSON.stringify(prevInitialMessagesRef.current) !== JSON.stringify(initialMessages);\n\n    if (hasChanged && initialMessages && initialMessages.length > 0) {\n      // 更新引用\n      prevInitialMessagesRef.current = initialMessages;\n\n      // 重新初始化聊天引擎或更新消息\n      chatEngine.setMessages(initialMessages, 'replace');\n\n      // 同步状态\n      syncState(initialMessages);\n    }\n  }, [initialMessages, chatEngine]);\n\n  return {\n    chatEngine,\n    messages,\n    status,\n  };\n};\n"],"names":["useChat","initialMessages","_ref","defaultMessages","chatServiceConfig","_useState","useState","_useState2","_slicedToArray","messages","setMessage","_useState3","_useState4","status","setStatus","chatEngineRef","useRef","ChatEngine","msgSubscribeRef","prevInitialMessagesRef","chatEngine","current","syncState","state","_state$at","at","subscribeToChat","_msgSubscribeRef$curr","call","messageStore","subscribe","initChat","init","useEffect","_msgSubscribeRef$curr2","hasChanged","JSON","stringify","length","setMessages"],"mappings":"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"}

package/es/chat-engine/hooks/useJsonRenderActivity.d.ts

@@ -0,0 +1,56 @@
+/**
+ * json-render Activity 便捷 Hook
+ * 简化 json-render Activity 的注册和使用
+ */
+import type { UseAgentActivityReturn } from './useAgentActivity';
+import type { JsonRenderActivityConfigOptions, ComponentCatalog } from '../components/json-render';
+/**
+ * json-render Activity Hook 配置选项
+ */
+export interface UseJsonRenderActivityOptions extends JsonRenderActivityConfigOptions {
+    /** 是否启用 A2UI 适配模式 */
+    enableA2UIAdapter?: boolean;
+}
+/**
+ * 使用 json-render Activity 渲染器
+ *
+ * @example
+ * ```tsx
+ * // 直接模式
+ * useJsonRenderActivity({
+ *   activityType: 'json-render',
+ *   onAction: async (actionName, params) => {
+ *     console.log('Action:', actionName, params);
+ *   },
+ * });
+ *
+ * // A2UI 适配模式
+ * useJsonRenderActivity({
+ *   activityType: 'a2ui-json-render',
+ *   enableA2UIAdapter: true,
+ *   onAction: async (actionName, params) => {
+ *     console.log('Action:', actionName, params);
+ *   },
+ * });
+ * ```
+ */
+export declare function useJsonRenderActivity(options?: UseJsonRenderActivityOptions): UseAgentActivityReturn;
+/**
+ * 创建自定义 Catalog 的 json-render Activity Hook
+ *
+ * @example
+ * ```tsx
+ * const customCatalog = {
+ *   MyButton: MyCustomButton,
+ *   MyInput: MyCustomInput,
+ * };
+ *
+ * useJsonRenderActivityWithCatalog(customCatalog, {
+ *   onAction: async (actionName, params) => {
+ *     console.log('Action:', actionName, params);
+ *   },
+ * });
+ * ```
+ */
+export declare function useJsonRenderActivityWithCatalog(catalog: ComponentCatalog, options?: Omit<UseJsonRenderActivityOptions, 'catalog'>): UseAgentActivityReturn;
+export default useJsonRenderActivity;