@tdesign-react/chat 1.0.2-alpha.8 → 1.1.0-alpha.1

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

@@ -0,0 +1,74 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import { useCallback } from 'react';
+import { useA2UIContext } from './A2UIContext.js';
+import '@babel/runtime/helpers/defineProperty';
+
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function useA2UIAction() {
+  var _useA2UIContext = useA2UIContext(),
+    processor = _useA2UIContext.processor,
+    surfaceId = _useA2UIContext.surfaceId,
+    onAction = _useA2UIContext.onAction;
+  return useCallback(function (action, componentId) {
+    if (onAction) {
+      var context = {
+        surfaceId: surfaceId,
+        componentId: componentId,
+        updateData: function updateData(path, value) {
+          processor.updateDataValue(surfaceId, path, value);
+        },
+        getData: function getData(path) {
+          var surface = processor.getSurface(surfaceId);
+          if (!surface) return void 0;
+          if (!path) return surface.data;
+          var segments = path.split("/").filter(Boolean);
+          var result = surface.data;
+          var _iterator = _createForOfIteratorHelper(segments),
+            _step;
+          try {
+            for (_iterator.s(); !(_step = _iterator.n()).done;) {
+              var segment = _step.value;
+              if (result === null || result === void 0) return void 0;
+              result = result[segment];
+            }
+          } catch (err) {
+            _iterator.e(err);
+          } finally {
+            _iterator.f();
+          }
+          return result;
+        }
+      };
+      onAction(action, context);
+    } else {
+      processor.dispatchAction(action, surfaceId, componentId);
+    }
+  }, [processor, surfaceId, onAction]);
+}
+function useActionCallback(action, componentId) {
+  var dispatch = useA2UIAction();
+  return useCallback(function () {
+    if (action) {
+      dispatch(action, componentId);
+    }
+  }, [dispatch, action, componentId]);
+}
+function useActionWithPayload(actionName, componentId) {
+  var dispatch = useA2UIAction();
+  return useCallback(function (context) {
+    dispatch({
+      name: actionName,
+      context: context
+    }, componentId);
+  }, [dispatch, actionName, componentId]);
+}
+
+export { useA2UIAction, useActionCallback, useActionWithPayload };
+//# sourceMappingURL=useA2UIAction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useA2UIAction.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useA2UIAction.ts"],"sourcesContent":["/**\n * A2UI Action 相关 Hooks\n */\n\nimport { useCallback } from 'react';\nimport { useA2UIContext } from './A2UIContext';\nimport type { A2UIAction } from '../../core/a2ui';\n\n/**\n * 获取 Action 分发函数\n * \n * @example\n * ```tsx\n * function Button({ action }: { action: A2UIAction }) {\n *   const dispatch = useA2UIAction();\n *   return <TButton onClick={() => dispatch(action)}>Click</TButton>;\n * }\n * ```\n */\nexport function useA2UIAction(): (action: A2UIAction, componentId?: string) => void {\n  const { processor, surfaceId, onAction } = useA2UIContext();\n\n  return useCallback(\n    (action: A2UIAction, componentId?: string) => {\n      // 优先使用外部提供的 onAction\n      if (onAction) {\n        const context = {\n          surfaceId,\n          componentId,\n          updateData: (path: string, value: unknown) => {\n            processor.updateDataValue(surfaceId, path, value);\n          },\n          getData: (path?: string) => {\n            const surface = processor.getSurface(surfaceId);\n            if (!surface) return undefined;\n            if (!path) return surface.data;\n            // 简单路径解析\n            const segments = path.split('/').filter(Boolean);\n            let result: unknown = surface.data;\n            for (const segment of segments) {\n              if (result === null || result === undefined) return undefined;\n              result = (result as Record<string, unknown>)[segment];\n            }\n            return result;\n          },\n        };\n        onAction(action, context);\n      } else {\n        // 使用 processor 内部处理\n        processor.dispatchAction(action, surfaceId, componentId);\n      }\n    },\n    [processor, surfaceId, onAction]\n  );\n}\n\n/**\n * 创建绑定特定 Action 的回调\n * \n * @example\n * ```tsx\n * function ConfirmButton({ id }: { id: string }) {\n *   const handleConfirm = useActionCallback({ name: 'confirm', context: { value: true } }, id);\n *   return <TButton onClick={handleConfirm}>确认</TButton>;\n * }\n * ```\n */\nexport function useActionCallback(\n  action: A2UIAction | undefined,\n  componentId?: string\n): (() => void) | undefined {\n  const dispatch = useA2UIAction();\n\n  return useCallback(() => {\n    if (action) {\n      dispatch(action, componentId);\n    }\n  }, [dispatch, action, componentId]);\n}\n\n/**\n * 创建带参数的 Action 回调\n * \n * @example\n * ```tsx\n * function Input({ id }: { id: string }) {\n *   const handleChange = useActionWithPayload('input-change', id);\n *   return <TInput onChange={(val) => handleChange({ value: val })} />;\n * }\n * ```\n */\nexport function useActionWithPayload(\n  actionName: string,\n  componentId?: string\n): (context: Record<string, unknown>) => void {\n  const dispatch = useA2UIAction();\n\n  return useCallback(\n    (context: Record<string, unknown>) => {\n      dispatch({ name: actionName, context }, componentId);\n    },\n    [dispatch, actionName, componentId]\n  );\n}\n"],"names":["useA2UIAction","_useA2UIContext","useA2UIContext","processor","surfaceId","onAction","useCallback","action","componentId","context","updateData","path","value","updateDataValue","getData","surface","getSurface","data","segments","split","filter","Boolean","result","_iterator","_createForOfIteratorHelper","_step","s","n","done","segment","err","e","f","dispatchAction","useActionCallback","dispatch","useActionWithPayload","actionName","name"],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+/**
+ * A2UI Surface 相关 Hooks
+ */
+import type { A2uiMessageProcessor } from '../../core/a2ui';
+import type { A2UISurface, ResolvedComponent } from '../../core/a2ui';
+/**
+ * 订阅单个 Surface
+ *
+ * @example
+ * ```tsx
+ * const surface = useA2UISurface(processor, 'surface-1');
+ * if (!surface) return <Loading />;
+ * return <A2UIRenderer root={surface.root} />;
+ * ```
+ */
+export declare function useA2UISurface(processor: A2uiMessageProcessor, surfaceId: string): A2UISurface | undefined;
+/**
+ * 订阅所有 Surface
+ */
+export declare function useA2UISurfaces(processor: A2uiMessageProcessor): A2UISurface[];
+/**
+ * 订阅 Surface 的组件树根节点
+ */
+export declare function useA2UIRoot(processor: A2uiMessageProcessor, surfaceId: string): ResolvedComponent | null;
+/**
+ * 订阅 Surface 的数据模型
+ */
+export declare function useA2UIData<T = Record<string, unknown>>(processor: A2uiMessageProcessor, surfaceId: string): T | undefined;
+/**
+ * 订阅 Surface 状态
+ */
+export declare function useA2UISurfaceState(processor: A2uiMessageProcessor, surfaceId: string): 'active' | 'closed' | 'pending' | undefined;
+/**
+ * 获取 Surface IDs 列表
+ */
+export declare function useA2UISurfaceIds(processor: A2uiMessageProcessor): string[];

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.d.ts

@@ -0,0 +1,4 @@
+export * from './useAgentState';
+export * from './useAgentToolcall';
+export * from './useAgentActivity';
+export * from './useChat';

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

@@ -0,0 +1,54 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+export { AgentStateContext, useAgentState, useAgentStateContext, useAgentStateDataByKey } from './useAgentState.js';
+export { useAgentToolcall } from './useAgentToolcall.js';
+export { useAgentActivity } from './useAgentActivity.js';
+export { useChat } from './useChat.js';
+import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/helpers/slicedToArray';
+import 'react';
+import '../core/index.js';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/regenerator';
+import '../core/adapters/agui/index.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../core/adapters/agui/event-mapper.js';
+import '../core/adapters/agui/events.js';
+import 'zod';
+import '../core/adapters/agui/types.js';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '../core/adapters/agui/state-manager.js';
+import '@babel/runtime/helpers/typeof';
+import '../core/utils/index.js';
+import '../core/adapters/agui/activity-manager.js';
+import '../core/adapters/agui/utils.js';
+import '../core/event-bus/index.js';
+import '../core/event-bus/ChatEventBus.js';
+import '../core/event-bus/types.js';
+import '../core/store/message.js';
+import '@babel/runtime/helpers/get';
+import '../core/store/reactiveState.js';
+import '../core/processor/index.js';
+import '../core/server/index.js';
+import '../core/server/llm-service.js';
+import '../core/utils/logger.js';
+import '../core/server/batch-client.js';
+import '../core/utils/eventEmitter.js';
+import '../core/server/errors.js';
+import '../core/server/sse-client.js';
+import '../core/server/connection-manager.js';
+import '../core/server/sse-parser.js';
+import '../core/server/types.js';
+import '../components/toolcall/registry.js';
+import '../components/activity/registry.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { ActivityConfig } from '../components/activity/types';
+export interface UseAgentActivityReturn {
+    register: (config: ActivityConfig | ActivityConfig[]) => void;
+    unregister: (activityTypes: string | string[]) => void;
+    isRegistered: (activityType: string) => boolean;
+    getRegistered: () => string[];
+}
+/**
+ * Activity 注册管理 Hook，专门用于 Activity 组件的注册管理
+ *
+ * 支持两种使用模式：
+ * 1. 自动注册模式：传入配置，自动注册和清理
+ * 2. 手动注册模式：不传配置，返回注册方法由业务控制
+ */
+export declare function useAgentActivity<TContent = any>(config?: ActivityConfig<TContent> | ActivityConfig<TContent>[] | null | undefined): UseAgentActivityReturn;

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

@@ -0,0 +1,73 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+import { useRef, useCallback, useEffect } from 'react';
+import { activityRegistry } from '../components/activity/registry.js';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/defineProperty';
+
+function useAgentActivity(config) {
+  var registeredTypesRef = useRef(/* @__PURE__ */new Set());
+  var autoRegisteredTypesRef = useRef(/* @__PURE__ */new Set());
+  var register = useCallback(function (newConfig) {
+    if (!newConfig) {
+      console.warn("[useAgentActivity] \u914D\u7F6E\u4E3A\u7A7A\uFF0C\u8DF3\u8FC7\u6CE8\u518C");
+      return;
+    }
+    var configs = Array.isArray(newConfig) ? newConfig : [newConfig];
+    configs.forEach(function (cfg) {
+      if (activityRegistry.has(cfg.activityType)) {
+        console.warn("[useAgentActivity] Activity \u7C7B\u578B \"".concat(cfg.activityType, "\" \u5DF2\u5B58\u5728\u4E8E\u6CE8\u518C\u8868\u4E2D\uFF0C\u5C06\u88AB\u8986\u76D6"));
+      }
+      activityRegistry.register(cfg);
+      registeredTypesRef.current.add(cfg.activityType);
+    });
+  }, []);
+  var unregister = useCallback(function (activityTypes) {
+    var typeArray = Array.isArray(activityTypes) ? activityTypes : [activityTypes];
+    typeArray.forEach(function (activityType) {
+      activityRegistry.unregister(activityType);
+      registeredTypesRef.current["delete"](activityType);
+      autoRegisteredTypesRef.current["delete"](activityType);
+    });
+  }, []);
+  var isRegistered = useCallback(function (activityType) {
+    return registeredTypesRef.current.has(activityType) || autoRegisteredTypesRef.current.has(activityType);
+  }, []);
+  var getRegistered = useCallback(function () {
+    return Array.from(/* @__PURE__ */new Set([].concat(_toConsumableArray(registeredTypesRef.current), _toConsumableArray(autoRegisteredTypesRef.current))));
+  }, []);
+  useEffect(function () {
+    if (!config) {
+      return;
+    }
+    var configs = Array.isArray(config) ? config : [config];
+    configs.forEach(function (cfg) {
+      if (activityRegistry.has(cfg.activityType)) {
+        console.warn("[useAgentActivity] Activity \u7C7B\u578B \"".concat(cfg.activityType, "\" \u5DF2\u5B58\u5728\u4E8E\u6CE8\u518C\u8868\u4E2D\uFF0C\u5C06\u88AB\u8986\u76D6"));
+      }
+      activityRegistry.register(cfg);
+      autoRegisteredTypesRef.current.add(cfg.activityType);
+    });
+    return function () {
+      configs.forEach(function (cfg) {
+        activityRegistry.unregister(cfg.activityType);
+        autoRegisteredTypesRef.current["delete"](cfg.activityType);
+      });
+    };
+  }, [config]);
+  return {
+    register: register,
+    unregister: unregister,
+    isRegistered: isRegistered,
+    getRegistered: getRegistered
+  };
+}
+
+export { useAgentActivity };
+//# sourceMappingURL=useAgentActivity.js.map

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

@@ -0,0 +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，专门用于 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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"}

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

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.0
+ * tdesign v1.0.2-alpha.15
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -7,7 +7,44 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import { useState, useRef, useEffect, createContext, useContext, useMemo } from 'react';
-import { stateManager } from 'tdesign-web-components/lib/chat-engine';
+import '../core/index.js';
+import { stateManager } from '../core/adapters/agui/state-manager.js';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/regenerator';
+import '../core/adapters/agui/index.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../core/adapters/agui/event-mapper.js';
+import '../core/adapters/agui/events.js';
+import 'zod';
+import '../core/adapters/agui/types.js';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '../core/adapters/agui/activity-manager.js';
+import '../core/utils/index.js';
+import '@babel/runtime/helpers/typeof';
+import '../core/adapters/agui/utils.js';
+import '../core/event-bus/index.js';
+import '../core/event-bus/ChatEventBus.js';
+import '../core/event-bus/types.js';
+import '../core/store/message.js';
+import '@babel/runtime/helpers/get';
+import '../core/store/reactiveState.js';
+import '../core/processor/index.js';
+import '../core/server/index.js';
+import '../core/server/llm-service.js';
+import '../core/utils/logger.js';
+import '../core/server/batch-client.js';
+import '../core/utils/eventEmitter.js';
+import '../core/server/errors.js';
+import '../core/server/sse-client.js';
+import '../core/server/connection-manager.js';
+import '../core/server/sse-parser.js';
+import '../core/server/types.js';
 
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }

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\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 '../core';\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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"}