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

package/README-zh_CN.md

@@ -572,6 +572,10 @@ ui 插件的主要事件如下，你还可以自由地注册需要的事件：
   - `payload.blocks: InputBlock[]` 输入块
 - `setInputBlocks` 设置输入块到 MessageInput 输入框
   - `payload.blocks: InputBlock[]` 输入块
+- `sessionChange`: 会话数据变化
+  - `payload.key: string`: 会话数据 key
+  - `payload.value: any`: 会话数据 value
+  - `payload.oldValue: any`: 会话数据旧值
 
 > 注意，这里的 ChatMessageObject 是一个消息对象，不是 ChatMessage 类型，
 > 它包含了消息的一些属性和方法，这是为了避免在 UI 层修改消息对象，导致 ChatAgent 中的消息对象不一致。
@@ -702,6 +706,12 @@ Hooks：
   - `extension` 扩展数据
   - `responseMessage` 响应消息
   - `result.messages` 消息列表
+- `onTTTAction` tile 使用 `sendAction` 时触发
+  - `tile` 触发的 tile
+  - `action` TTTAction
+- `onCardsReceived` 当收到卡片时触发
+  - `extension` 扩展数据
+  - `result.cards` 卡片列表
 
 ### withBuildIn 插件
 
@@ -1229,9 +1239,11 @@ import {
 } from '@ray-js/t-agent-ui-ray';
 import { View, Text, Button } from '@ray-js/ray';
 
-function MyCard(props: { card: ChatCardObject }) {
+const MyCard: ChatCardComponent<{ title: string }, { clicked: boolean }> = props => {
   // 如果你需要拿到 agent、message、tile、emitEvent 等属性，可以使用 useTileProps
   const { message, agent, tile, emitEvent } = useTileProps();
+  const { card, setCardState } = props;
+  const { cardData, cardState, cardCode } = card as ChatCardObject<{ title: string }>;
 
   // 如果你需要发送一个 TTTAction，可以使用 useSendAction
   const sendAction = useSendAction();
@@ -1240,15 +1252,18 @@ function MyCard(props: { card: ChatCardObject }) {
     <View>
       <Text>My Card</Text>
       <Button
-        onClick={() =>
-          sendAction({ type: 'sendMessage', blocks: [{ type: 'text', text: 'hello' }] })
-        }
+        onClick={() => {
+          sendAction({ type: 'sendMessage', blocks: [{ type: 'text', text: 'hello' }] });
+          // 如果需要更新卡片状态，可以使用 setCardState
+          // 第二个参数表示是否持久化状态
+          setCardState({ clicked: true }, { persist: true });
+        }}
       >
         填充文本到输入框
       </Button>
     </View>
   );
-}
+};
 
 const renderOptions = {
   ...defaultRenderOptions,

package/README.md

@@ -567,6 +567,10 @@ The main events of the UI plugin are as follows, and you can freely register add
   - `payload.blocks: InputBlock[]`: Input blocks
 - `setInputBlocks`: Set input blocks in MessageInput
   - `payload.blocks: InputBlock[]`: Input blocks
+- `sessionChange`: Session data changes
+  - `payload.key: string`: Session key
+  - `payload.value: any`: Session value
+  - `payload.oldValue: any`: Old session value
 
 > Note: `ChatMessageObject` here is a message object, not a `ChatMessage` type.
 > It contains various attributes and methods to ensure changes are made in the ChatAgent, avoiding conflicts with the UI layer.
@@ -696,6 +700,12 @@ Hooks:
   - `extension`: Extension data
   - `responseMessage`: Response message
   - `result.messages`: Message list
+- `onTTTAction` When using `sendAction` in the tile, this hook triggers.
+  - `tile` Tile object
+  - `action` TTTAction
+- `onCardsReceived` When receiving cards, this hook triggers.
+  - `extension` Extension data
+  - `result.cards` Card list
 
 ### withBuildIn Plugin
 
@@ -1224,9 +1234,11 @@ import {
 } from '@ray-js/t-agent-ui-ray';
 import { View, Text, Button } from '@ray-js/ray';
 
-function MyCard(props: { card: ChatCardObject }) {
+const MyCard: ChatCardComponent<{ title: string }, { clicked: boolean }> = props => {
   // If you need to access attributes like agent, message, tile, emitEvent, use useTileProps
   const { message, agent, tile, emitEvent } = useTileProps();
+  const { card, setCardState } = props;
+  const { cardData, cardState, cardCode } = card as ChatCardObject<{ title: string }>;
 
   // If you need to send a TTTAction, use useSendAction
   const sendAction = useSendAction();
@@ -1235,15 +1247,18 @@ function MyCard(props: { card: ChatCardObject }) {
     <View>
       <Text>My Card</Text>
       <Button
-        onClick={() =>
-          sendAction({ type: 'sendMessage', blocks: [{ type: 'text', text: 'hello' }] })
-        }
+        onClick={() => {
+          sendAction({ type: 'sendMessage', blocks: [{ type: 'text', text: 'hello' }] });
+          // If you want to set the card state, use setCardState
+          // The second parameter is used to determine whether to persist the card state, default is false
+          setCardState({ clicked: true }, { persist: true });
+        }}
       >
         Fill text into input
       </Button>
     </View>
   );
-}
+};
 
 const renderOptions = {
   ...defaultRenderOptions,

package/dist/chat/index.d.ts

@@ -1,12 +1,13 @@
 import ChatAgent from './ChatAgent';
+import ChatSession from './ChatSession';
 import StreamResponse from './StreamResponse';
 import ChatTile from './ChatTile';
 import ChatBubbleTile from './ChatBubbleTile';
 import ChatMessage from './ChatMessage';
-import { generateId, safeParseJSON, sleep, generateInt, isAbortError, debounce, shuffleWithSeed } from './utils';
+import { generateId, safeParseJSON, isAbortError, shuffleWithSeed } from './utils';
 import Logger, { getLogger } from './Logger';
 import { Emitter, EmitterEvent } from './Emitter';
 export { createHooks, Hookable } from 'hookable';
-export { ChatAgent, StreamResponse, ChatTile, ChatBubbleTile, ChatMessage, generateId, generateInt, safeParseJSON, getLogger, Logger, Emitter, EmitterEvent, isAbortError, sleep, debounce, shuffleWithSeed, };
+export { ChatAgent, ChatSession, StreamResponse, ChatTile, ChatBubbleTile, ChatMessage, generateId, safeParseJSON, getLogger, Logger, Emitter, EmitterEvent, isAbortError, shuffleWithSeed, };
 export * from './createChatAgent';
 export * from './types';

package/dist/chat/index.js

@@ -1,12 +1,13 @@
 import ChatAgent from './ChatAgent';
+import ChatSession from './ChatSession';
 import StreamResponse from './StreamResponse';
 import ChatTile from './ChatTile';
 import ChatBubbleTile from './ChatBubbleTile';
 import ChatMessage from './ChatMessage';
-import { generateId, safeParseJSON, sleep, generateInt, isAbortError, debounce, shuffleWithSeed } from './utils';
+import { generateId, safeParseJSON, isAbortError, shuffleWithSeed } from './utils';
 import Logger, { getLogger } from './Logger';
 import { Emitter, EmitterEvent } from './Emitter';
 export { createHooks, Hookable } from 'hookable';
-export { ChatAgent, StreamResponse, ChatTile, ChatBubbleTile, ChatMessage, generateId, generateInt, safeParseJSON, getLogger, Logger, Emitter, EmitterEvent, isAbortError, sleep, debounce, shuffleWithSeed };
+export { ChatAgent, ChatSession, StreamResponse, ChatTile, ChatBubbleTile, ChatMessage, generateId, safeParseJSON, getLogger, Logger, Emitter, EmitterEvent, isAbortError, shuffleWithSeed };
 export * from './createChatAgent';
 export * from './types';

package/dist/chat/utils.d.ts

@@ -1,32 +1,6 @@
 export declare function generateId(length?: number): string;
-export declare function generateInt(min: number, max: number): number;
-export declare function deepCloneToPlainObject(obj: any): any;
+export declare function deepCloneToPlainObject(obj: any, visited?: WeakMap<object, any>): any;
 export declare function safeParseJSON<T = any>(str: any): T | undefined;
 export declare function deepMerge(target: any, source: any): any;
-export declare const sleep: (ms: number) => Promise<unknown>;
 export declare function isAbortError(reason: any): any;
-type AnyFunction = (...arguments_: readonly any[]) => unknown;
-/**
- * Creates a debounced function that delays execution until `wait` milliseconds have passed since its last invocation.
- *
- * Set the `immediate` option to `true` to execute the function immediately at the start of the `wait` interval, preventing issues such as double-clicks on a button.
- *
- * The returned function has the following methods:
- *
- * - `.isPending` indicates whether the debounce delay is currently active.
- * - `.clear()` cancels any scheduled executions.
- * - `.flush()` if an execution is scheduled then it will be immediately executed and the timer will be cleared.
- * - `.trigger()` executes the function immediately and clears the timer if it was previously set.
- */
-export declare function debounce<F extends AnyFunction>(function_: F, wait?: number, options?: {
-    immediate?: boolean;
-}): DebouncedFunction<F>;
-interface DebouncedFunction<F extends AnyFunction> {
-    (...arguments_: Parameters<F>): ReturnType<F> | undefined;
-    readonly isPending: boolean;
-    clear(): void;
-    flush(): void;
-    trigger(): void;
-}
 export declare function shuffleWithSeed<T>(array: T[], seed: string): T[];
-export {};

package/dist/chat/utils.js

@@ -1,6 +1,6 @@
-import "core-js/modules/esnext.iterator.constructor.js";
-import "core-js/modules/esnext.iterator.filter.js";
-import "core-js/modules/esnext.iterator.map.js";
+import "core-js/modules/es.regexp.constructor.js";
+import "core-js/modules/es.regexp.dot-all.js";
+import "core-js/modules/es.regexp.exec.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 /* eslint no-bitwise: 0 */
 
@@ -14,38 +14,77 @@ export function generateId() {
   }
   return result;
 }
-export function generateInt(min, max) {
-  return Math.floor(Math.random() * (max - min + 1) + min);
-}
 export function deepCloneToPlainObject(obj) {
-  // 判断是否是对象或数组
-  if (obj === null || typeof obj !== 'object') {
-    return undefined;
-  }
+  let visited = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : new WeakMap();
+  // 如果是 null，直接返回 null
+  if (obj === null) return null;
+
+  // 如果是基本类型（数字、字符串、布尔等），直接返回自身；函数在 JSON 中会被忽略
+  if (typeof obj !== 'object') return obj;
+  if (typeof obj === 'function') return undefined;
 
-  // 如果是 Date 或其他不可直接 JSON 化的类型
+  // 如果对象已被处理过，直接返回缓存结果，防止循环引用
+  if (visited.has(obj)) return visited.get(obj);
+
+  // 处理 Date：转成 ISO 字符串
   if (obj instanceof Date) {
     return obj.toISOString();
   }
-  if (obj instanceof Array) {
-    return obj.map(item => deepCloneToPlainObject(item)).filter(item => item !== undefined); // 移除 undefined 项
+
+  // 处理 RegExp：转换为字符串表示形式
+  if (obj instanceof RegExp) {
+    return obj.toString();
   }
-  if (obj instanceof Object) {
-    const plainObject = {};
-    for (const key in obj) {
-      if (Object.prototype.hasOwnProperty.call(obj, key)) {
-        const value = deepCloneToPlainObject(obj[key]);
-        if (value !== undefined) {
-          // 只添加可以转换的值
-          plainObject[key] = value;
-        }
+
+  // 处理数组：保留结构，将 undefined 转为 null（符合 JSON.stringify 行为）
+  if (Array.isArray(obj)) {
+    const clonedArr = new Array(obj.length);
+    visited.set(obj, clonedArr);
+    for (let i = 0; i < obj.length; i++) {
+      if (i in obj) {
+        const clonedValue = deepCloneToPlainObject(obj[i], visited);
+        clonedArr[i] = clonedValue === undefined ? null : clonedValue;
+      } else {
+        // 对于稀疏数组，补成 null
+        clonedArr[i] = null;
       }
     }
-    return plainObject;
+    return clonedArr;
   }
 
-  // 如果遇到其他类型，直接忽略返回 undefined
-  return undefined;
+  // 处理 Map：转换为数组的键值对；注意 JSON 不能直接表示 Map，所以这里转成数组
+  if (obj instanceof Map) {
+    const clonedMap = [];
+    visited.set(obj, clonedMap);
+    for (const [key, value] of obj.entries()) {
+      clonedMap.push([deepCloneToPlainObject(key, visited), deepCloneToPlainObject(value, visited)]);
+    }
+    return clonedMap;
+  }
+
+  // 处理 Set：转换为数组
+  if (obj instanceof Set) {
+    const clonedSet = [];
+    visited.set(obj, clonedSet);
+    for (const value of obj.values()) {
+      clonedSet.push(deepCloneToPlainObject(value, visited));
+    }
+    return clonedSet;
+  }
+
+  // 处理普通对象
+  const clonedObj = {};
+  visited.set(obj, clonedObj);
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      const clonedValue = deepCloneToPlainObject(obj[key], visited);
+      // JSON.stringify 会忽略 undefined 属性，这里保持一致
+      if (clonedValue !== undefined) {
+        clonedObj[key] = clonedValue;
+      }
+    }
+  }
+  return clonedObj;
 }
 export function safeParseJSON(str) {
   if (str && typeof str === 'string') {
@@ -83,101 +122,9 @@ export function deepMerge(target, source) {
   }
   return target;
 }
-export const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
 export function isAbortError(reason) {
   return reason && typeof Error !== 'undefined' && reason instanceof Error && reason.name === 'AbortError';
 }
-/**
- * Creates a debounced function that delays execution until `wait` milliseconds have passed since its last invocation.
- *
- * Set the `immediate` option to `true` to execute the function immediately at the start of the `wait` interval, preventing issues such as double-clicks on a button.
- *
- * The returned function has the following methods:
- *
- * - `.isPending` indicates whether the debounce delay is currently active.
- * - `.clear()` cancels any scheduled executions.
- * - `.flush()` if an execution is scheduled then it will be immediately executed and the timer will be cleared.
- * - `.trigger()` executes the function immediately and clears the timer if it was previously set.
- */
-export function debounce(function_) {
-  let wait = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 100;
-  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-  if (typeof function_ !== 'function') {
-    throw new TypeError("Expected the first parameter to be a function, got `".concat(typeof function_, "`."));
-  }
-  if (wait < 0) {
-    throw new RangeError('`wait` must not be negative.');
-  }
-  const {
-    immediate = false
-  } = options;
-  let storedContext;
-  let storedArguments;
-  let timeoutId;
-  let timestamp;
-  let result;
-  function run() {
-    const callContext = storedContext;
-    const callArguments = storedArguments;
-    storedContext = undefined;
-    storedArguments = undefined;
-    result = function_.apply(callContext, callArguments);
-    return result;
-  }
-  function later() {
-    const last = Date.now() - timestamp;
-    if (last < wait && last >= 0) {
-      timeoutId = setTimeout(later, wait - last);
-    } else {
-      timeoutId = undefined;
-      if (!immediate) {
-        result = run();
-      }
-    }
-  }
-  const debounced = function () {
-    if (storedContext && this !== storedContext && Object.getPrototypeOf(this) === Object.getPrototypeOf(storedContext)) {
-      throw new Error('Debounced method called with different contexts of the same prototype.');
-    }
-    storedContext = this;
-    for (var _len = arguments.length, arguments_ = new Array(_len), _key = 0; _key < _len; _key++) {
-      arguments_[_key] = arguments[_key];
-    }
-    storedArguments = arguments_;
-    timestamp = Date.now();
-    const callNow = immediate && !timeoutId;
-    if (!timeoutId) {
-      timeoutId = setTimeout(later, wait);
-    }
-    if (callNow) {
-      result = run();
-    }
-    return result;
-  };
-  Object.defineProperty(debounced, 'isPending', {
-    get() {
-      return timeoutId !== undefined;
-    }
-  });
-  debounced.clear = () => {
-    if (!timeoutId) {
-      return;
-    }
-    clearTimeout(timeoutId);
-    timeoutId = undefined;
-  };
-  debounced.flush = () => {
-    if (!timeoutId) {
-      return;
-    }
-    debounced.trigger();
-  };
-  debounced.trigger = () => {
-    result = run();
-    debounced.clear();
-  };
-  return debounced;
-}
 function seedRandom(seed) {
   let h = 0;
   // 将字符串种子转化为哈希值

package/dist/plugins/ui.js

@@ -28,6 +28,13 @@ export function withUI() {
       };
       emitEvent('messageChange', detail);
     }, 'after');
+    agent.session.onChange((key, value, oldValue) => {
+      emitEvent('sessionChange', {
+        key,
+        value,
+        oldValue
+      });
+    });
     return {
       ui: {
         emitter,

package/package.json

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