@rtc-agent/component 0.2.7-rc.4 → 0.2.8-rc.1

package/dist/utils/skeleton-tracker.d.ts

@@ -1,143 +1,143 @@
 /**
- * Skeleton Tracker - 骨架屏生命周期统一管理
+ * Skeleton Tracker - Unified skeleton screen lifecycle management
  *
- * 替代原有分散的状态管理：
+ * Replaces the previously scattered state management:
  * - _placeholderItemIds: Set<string>
  * - _placeholderPositions: Array<{itemId: string; y: number}>
  * - _placeholderIndexMap: Map<string, number>
  * - _pendingRestorationIds: Set<string>
  *
- * 统一管理骨架屏的创建、追踪、恢复，提供清晰的 API。
+ * Unified management of skeleton screen creation, tracking, and restoration, providing a clear API.
  */
 /**
- * 骨架屏信息
+ * Skeleton screen info
  */
 export interface SkeletonInfo {
-    /** 元素 ID */
+    /** Element ID */
     itemId: string;
-    /** 在 _items 中的索引 */
+    /** Index in _items */
     index: number;
-    /** 绝对 Y 坐标（相对于滚动内容） */
+    /** Absolute Y coordinate (relative to scroll content) */
     y: number;
-    /** DOM 元素引用 */
+    /** DOM element reference */
     element: HTMLElement;
-    /** 是否在待恢复队列中 */
+    /** Whether it is in the pending restoration queue */
     isPendingRestoration: boolean;
 }
 /**
- * 骨架屏追踪器
+ * Skeleton screen tracker
  *
- * 职责：
- * 1. 追踪所有骨架屏的状态（位置、DOM 引用、恢复状态）
- * 2. 提供高效的查询 API（按范围、按 ID）
- * 3. 支持批量操作（重建位置、清空）
+ * Responsibilities:
+ * 1. Track state of all skeleton screens (position, DOM reference, restoration state)
+ * 2. Provide efficient query API (by range, by ID)
+ * 3. Support batch operations (rebuild positions, clear)
  *
- * 使用方式：
+ * Usage:
  * ```typescript
  * const tracker = new SkeletonTracker();
  *
- * // 添加骨架屏
+ * // Add skeleton
  * tracker.add(itemId, index, y, element);
  *
- * // 查询范围内的骨架屏
+ * // Query skeletons in range
  * const skeletons = tracker.getSkeletonsInRange(top, bottom);
  *
- * // 重建所有位置（布局变化后）
+ * // Rebuild all positions (after layout changes)
  * tracker.rebuildPositions(scrollContainer, elementMap);
  *
- * // 移除已恢复的骨架屏
+ * // Remove restored skeleton
  * tracker.remove(itemId);
  * ```
  */
 export declare class SkeletonTracker {
-    /** 骨架屏信息映射：itemId → SkeletonInfo */
+    /** Skeleton info map: itemId -> SkeletonInfo */
     private _skeletons;
     /**
-     * 添加骨架屏
+     * Add a skeleton
      *
-     * @param itemId 元素 ID
-     * @param index 在 _items 中的索引
-     * @param y 绝对 Y 坐标
-     * @param element DOM 元素引用
+     * @param itemId Element ID
+     * @param index Index in _items
+     * @param y Absolute Y coordinate
+     * @param element DOM element reference
      */
     add(itemId: string, index: number, y: number, element: HTMLElement): void;
     /**
-     * 移除骨架屏
+     * Remove a skeleton
      *
-     * @param itemId 元素 ID
+     * @param itemId Element ID
      */
     remove(itemId: string): void;
     /**
-     * 获取骨架屏信息
+     * Get skeleton info
      *
-     * @param itemId 元素 ID
-     * @returns 骨架屏信息，不存在返回 undefined
+     * @param itemId Element ID
+     * @returns Skeleton info, or undefined if not found
      */
     get(itemId: string): SkeletonInfo | undefined;
     /**
-     * 检查是否是骨架屏
+     * Check if an item is a skeleton
      *
-     * @param itemId 元素 ID
-     * @returns 是否是骨架屏
+     * @param itemId Element ID
+     * @returns Whether it is a skeleton
      */
     has(itemId: string): boolean;
     /**
-     * 获取指定 Y 范围内的骨架屏
+     * Get skeletons within a Y range
      *
-     * 检查骨架屏的任意部分是否在范围内（顶部、底部或完全包含）。
+     * Checks if any part of the skeleton (top, bottom, or fully contained) is within range.
      *
-     * @param yMin 范围上界
-     * @param yMax 范围下界
-     * @returns 范围内的骨架屏数组
+     * @param yMin Range upper bound
+     * @param yMax Range lower bound
+     * @returns Array of skeletons within range
      */
     getInRange(yMin: number, yMax: number): SkeletonInfo[];
     /**
-     * 标记骨架屏为待恢复状态
+     * Mark a skeleton as pending restoration
      *
-     * @param itemId 元素 ID
+     * @param itemId Element ID
      */
     markPending(itemId: string): void;
     /**
-     * 清除待恢复标记
+     * Clear pending restoration flag
      *
-     * @param itemId 元素 ID
+     * @param itemId Element ID
      */
     clearPending(itemId: string): void;
     /**
-     * 重建所有骨架屏的 Y 位置
+     * Rebuild Y positions for all skeletons
      *
-     * 当布局发生变化（容器 resize、元素插入等）后调用，
-     * 基于当前 DOM 状态重新计算所有骨架屏的绝对 Y 坐标。
+     * Called after layout changes (container resize, element insertion, etc.)
+     * to recalculate absolute Y coordinates for all skeletons based on current DOM state.
      *
-     * @param scrollContainer 滚动容器
-     * @param elementMap 索引 → DOM 元素映射
+     * @param scrollContainer Scroll container
+     * @param elementMap Index -> DOM element map
      */
     rebuildPositions(scrollContainer: HTMLElement, elementMap: Map<number, HTMLElement>): void;
     /**
-     * 更新骨架屏的索引
+     * Update skeleton indices
      *
-     * 当 _items 数组变化（prepend、splice 等）后调用，
-     * 更新所有骨架屏的索引以匹配新的 _items 数组。
+     * Called after the _items array changes (prepend, splice, etc.)
+     * to update all skeleton indices to match the new _items array.
      *
-     * @param indexMap 旧索引 → 新索引映射
+     * @param indexMap Old index -> new index map
      */
     updateIndices(indexMap: Map<number, number>): void;
     /**
-     * 清空所有骨架屏
+     * Clear all skeletons
      */
     clear(): void;
     /**
-     * 获取所有骨架屏
+     * Get all skeletons
      *
-     * @returns 所有骨架屏数组
+     * @returns Array of all skeletons
      */
     getAll(): SkeletonInfo[];
     /**
-     * 获取骨架屏数量
+     * Get skeleton count
      */
     get size(): number;
     /**
-     * 获取待恢复的骨架屏数量
+     * Get count of skeletons pending restoration
      */
     get pendingCount(): number;
 }

package/dist/utils/skeleton-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skeleton-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/skeleton-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,gBAAgB;IAChB,oBAAoB,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,eAAe;IACxB,oCAAoC;IACpC,OAAO,CAAC,UAAU,CAAwC;IAE1D;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAgBzE;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7C;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;;;;;OAQG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAiCtD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOjC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOlC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IAiB1F;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IASlD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAQzB;CACJ"}
+{"version":3,"file":"skeleton-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/skeleton-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,qDAAqD;IACrD,oBAAoB,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,eAAe;IACxB,gDAAgD;IAChD,OAAO,CAAC,UAAU,CAAwC;IAE1D;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAgBzE;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7C;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;;;;;OAQG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE;IAiCtD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOjC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOlC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IAiB1F;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IASlD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAQzB;CACJ"}

package/dist/utils/visibility-manager.d.ts

@@ -1,53 +1,53 @@
 /**
- * Visibility Manager - 可见性状态机
+ * Visibility Manager - Visibility state machine
  *
- * 管理虚拟滚动的可见性状态，确保在不可见时暂停操作，
- * 恢复到可见时同步重建状态。
+ * Manages virtual scroll visibility state, ensuring operations are paused when not visible,
+ * and state is synchronously rebuilt when visibility is restored.
  *
- * 解决的问题：
- * - Tab 切换（visibility: hidden）时虚拟滚动仍在执行操作
- * - 浏览器窗口失焦（document.hidden）时的状态不一致
- * - 从不可见恢复到可见时骨架屏无法恢复
+ * Problems addressed:
+ * - Virtual scroll continues operating during tab switches (visibility: hidden)
+ * - Inconsistent state when browser window loses focus (document.hidden)
+ * - Skeletons fail to restore when transitioning from hidden back to visible
  */
 /**
- * 可见性状态
+ * Visibility state
  */
 export declare enum VisibilityState {
-    /** 可见且活跃 */
+    /** Visible and active */
     VISIBLE = "visible",
-    /** 不可见（Tab 切换或窗口失焦） */
+    /** Not visible (tab switch or window out of focus) */
     HIDDEN = "hidden",
-    /** 正在转换（从 hidden 到 visible 的过渡期） */
+    /** Transitioning (transition period from hidden to visible) */
     TRANSITIONING = "transitioning"
 }
 /**
- * 可见性状态变化监听器
+ * Visibility state change listener
  */
 export type VisibilityChangeListener = (state: VisibilityState) => void;
 /**
- * 可见性管理器
+ * Visibility manager
  *
- * 职责：
- * 1. 维护可见性状态机（VISIBLE ↔ HIDDEN ↔ TRANSITIONING）
- * 2. 通知监听器状态变化
- * 3. 提供操作许可检查（shouldPerformOperations）
+ * Responsibilities:
+ * 1. Maintain the visibility state machine (VISIBLE <-> HIDDEN <-> TRANSITIONING)
+ * 2. Notify listeners of state changes
+ * 3. Provide operation permission check (shouldPerformOperations)
  *
- * 使用方式：
+ * Usage:
  * ```typescript
  * const manager = new VisibilityManager();
  *
- * // 监听状态变化
+ * // Listen for state changes
  * manager.onStateChange(state => {
  *     console.log('Visibility changed:', state);
  * });
  *
- * // 更新可见性（由外部调用）
- * manager.update(true);  // 变为可见
- * manager.update(false); // 变为不可见
+ * // Update visibility (called externally)
+ * manager.update(true);  // Become visible
+ * manager.update(false); // Become hidden
  *
- * // 检查是否应该执行操作
+ * // Check whether operations should be performed
  * if (manager.shouldPerformOperations()) {
- *     // 执行虚拟滚动操作
+ *     // Execute virtual scroll operations
  * }
  * ```
  */
@@ -55,48 +55,48 @@ export declare class VisibilityManager {
     private _state;
     private _listeners;
     /**
-     * 获取当前状态
+     * Get current state
      */
     get state(): VisibilityState;
     /**
-     * 更新可见性状态
+     * Update visibility state
      *
-     * 状态转换规则：
-     * - VISIBLE → HIDDEN: 直接转换
-     * - HIDDEN → VISIBLE: 经过 TRANSITIONING 过渡状态
-     * - TRANSITIONING → VISIBLE: 自动转换（在一帧后）
+     * State transition rules:
+     * - VISIBLE -> HIDDEN: direct transition
+     * - HIDDEN -> VISIBLE: via TRANSITIONING intermediate state
+     * - TRANSITIONING -> VISIBLE: auto-transition (after one frame)
      *
-     * @param isVisible 是否可见
+     * @param isVisible Whether it is visible
      */
     update(isVisible: boolean): void;
     /**
-     * 转换到指定状态并通知监听器
+     * Transition to the specified state and notify listeners
      */
     private _transitionTo;
     /**
-     * 注册状态变化监听器
+     * Register a state change listener
      *
-     * @param listener 监听器函数
-     * @returns 取消注册的函数
+     * @param listener Listener function
+     * @returns Unregister function
      */
     onStateChange(listener: VisibilityChangeListener): () => void;
     /**
-     * 检查当前是否应该执行虚拟滚动操作
+     * Check whether virtual scroll operations should be performed
      *
-     * 只有在 VISIBLE 状态下才允许执行操作（skeletonize、restore 等）。
-     * HIDDEN 和 TRANSITIONING 状态下应该暂停所有操作。
+     * Only VISIBLE state allows operations (skeletonize, restore, etc.).
+     * HIDDEN and TRANSITIONING states should pause all operations.
      *
-     * @returns 是否应该执行操作
+     * @returns Whether operations should be performed
      */
     shouldPerformOperations(): boolean;
     /**
-     * 检查当前是否可见
+     * Check whether currently visible
      *
-     * @returns 是否可见（VISIBLE 或 TRANSITIONING）
+     * @returns Whether visible (VISIBLE or TRANSITIONING)
      */
     isVisible(): boolean;
     /**
-     * 清空所有监听器（用于 dispose）
+     * Clear all listeners (for dispose)
      */
     dispose(): void;
 }

package/dist/utils/visibility-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visibility-manager.d.ts","sourceRoot":"","sources":["../../src/utils/visibility-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,oBAAY,eAAe;IACvB,YAAY;IACZ,OAAO,YAAY;IACnB,uBAAuB;IACvB,MAAM,WAAW;IACjB,oCAAoC;IACpC,aAAa,kBAAkB;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,UAAU,CAA4C;IAE9D;;OAEG;IACH,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAyBhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAQ7D;;;;;;;OAOG;IACH,uBAAuB,IAAI,OAAO;IAIlC;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAKpB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIlB"}
+{"version":3,"file":"visibility-manager.d.ts","sourceRoot":"","sources":["../../src/utils/visibility-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,oBAAY,eAAe;IACvB,yBAAyB;IACzB,OAAO,YAAY;IACnB,sDAAsD;IACtD,MAAM,WAAW;IACjB,+DAA+D;IAC/D,aAAa,kBAAkB;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,UAAU,CAA4C;IAE9D;;OAEG;IACH,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAyBhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAQ7D;;;;;;;OAOG;IACH,uBAAuB,IAAI,OAAO;IAIlC;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAKpB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIlB"}

package/dist/validation/index.d.ts

@@ -1,53 +1,53 @@
 /**
- * 运行时参数校验模块
+ * Runtime parameter validation module
  *
- * 提供统一的参数校验入口，支持 Zod schema 和 OpenAPI Schema
- * 校验失败返回友好错误，引导 Agent 读取 /functions/INDEX.md
+ * Provides a unified parameter validation entry point, supporting Zod schema and OpenAPI Schema
+ * Validation failures return friendly errors, guiding Agent to read /functions/INDEX.md
  */
 import { z, type ZodType } from 'zod';
 import type { ParameterDef } from '../types/skill.js';
-/** 校验错误信息 */
+/** Validation error info */
 export interface ValidationError {
     field: string;
     message: string;
     code?: string;
 }
-/** 校验结果 */
+/** Validation result */
 export interface ValidationResult<T = unknown> {
     success: boolean;
     data?: T;
     errors?: ValidationError[];
 }
 /**
- * 用 Zod schema 校验参数
+ * Validate parameters with Zod schema
  *
  * @param schema Zod schema
- * @param params 待校验的参数
+ * @param params Parameters to validate
  */
 export declare function validateParams<T extends ZodType>(schema: T, params: Record<string, unknown>): ValidationResult<z.infer<T>>;
 /**
- * 格式化校验错误为 Agent 友好的消息
+ * Format validation error into Agent-friendly message
  */
 export declare function formatValidationError(groupName: string, functionName: string, errors: ValidationError[]): string;
 /**
- * 构建校验器
+ * Build validator
  *
- * 优先使用 zodSchema，否则从 parameters 生成
+ * Prefers zodSchema, otherwise generates from parameters
  *
- * @param zodSchema 可选的 Zod schema
- * @param parameters OpenAPI 格式的参数定义
- * @returns Zod schema 用于校验
+ * @param zodSchema Optional Zod schema
+ * @param parameters Parameter definitions in OpenAPI format
+ * @returns Zod schema for validation
  */
 export declare function buildValidator(zodSchema: ZodType | undefined, parameters: ParameterDef[] | undefined): ZodType | null;
 /**
- * 带校验的 handler 包装器
+ * Handler wrapper with validation
  *
- * 用于 FunctionDef.handler 的包装，自动进行参数校验
+ * Used for wrapping FunctionDef.handler, automatically validates parameters
  */
 export declare function withValidation<TParams extends ZodType, TResult>(groupName: string, functionName: string, schema: TParams, handler: (params: z.infer<TParams>) => Promise<TResult> | TResult): (params: Record<string, unknown>) => Promise<TResult | {
     error: string;
 }>;
 export { z } from 'zod';
-export { zodToParams, withMeta } from './zod-to-openapi.js';
+export { zodToParams, zodToOpenAPISchema, withMeta } from './zod-to-openapi.js';
 export { openApiToZod } from './openapi-to-zod.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAC9C,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAc9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,eAAe,EAAE,GACxB,MAAM,CAMR;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,UAAU,EAAE,YAAY,EAAE,GAAG,SAAS,GACrC,OAAO,GAAG,IAAI,CAWhB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,OAAO,EAAE,OAAO,EAC7D,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAChE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB3E;AAID,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAC9C,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAc9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,eAAe,EAAE,GACxB,MAAM,CAMR;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,UAAU,EAAE,YAAY,EAAE,GAAG,SAAS,GACrC,OAAO,GAAG,IAAI,CAWhB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,OAAO,EAAE,OAAO,EAC7D,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAChE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB3E;AAID,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/validation/openapi-to-zod.d.ts

@@ -1,15 +1,15 @@
 /**
- * OpenAPI Schema → Zod Schema 转换
+ * OpenAPI Schema to Zod Schema conversion
  *
- * 将 OpenAPI Schema 转换为 Zod schema，用于向后兼容现有 OpenAPI Schema 注册方式
+ * Converts OpenAPI Schema to Zod schema for backward compatibility with existing OpenAPI Schema registration
  */
 import { type ZodType } from 'zod';
 import type { ParameterDef } from '../types/skill.js';
 /**
- * 从 OpenAPI parameters 生成 ZodObject schema
+ * Generate ZodObject schema from OpenAPI parameters
  *
- * @param parameters OpenAPI 格式的参数定义数组
- * @returns ZodObject schema，可用于运行时校验
+ * @param parameters Array of parameter definitions in OpenAPI format
+ * @returns ZodObject schema, can be used for runtime validation
  */
 export declare function openApiToZod(parameters: ParameterDef[]): ZodType;
 //# sourceMappingURL=openapi-to-zod.d.ts.map

package/dist/validation/zod-to-openapi.d.ts

@@ -1,12 +1,12 @@
 /**
- * Zod Schema → OpenAPI Schema 转换
+ * Zod Schema to OpenAPI Schema conversion
  *
- * 将 Zod schema 转换为 OpenAPI Schema 格式，用于生成 Agent 文档
+ * Converts Zod schema to OpenAPI Schema format, used for generating Agent documentation
  *
- * 迁移自 peep/src/lib/rtc-agent-validation.ts
+ * Migrated from peep/src/lib/rtc-agent-validation.ts
  *
- * 支持的 Zod 功能：
- * - .describe() → description（参数描述）
+ * Supported Zod features:
+ * - .describe() → description (parameter description)
  * - .optional() → required: false
  * - .default() → default + required: false
  * - .min()/.max() → minimum/maximum
@@ -15,15 +15,15 @@
  * - .enum() → enum
  * - z.array() → array + items
  *
- * 扩展功能（通过 meta 方法）：
- * - .meta({ example: ... }) → example（示例值）
+ * Extended features (via meta method):
+ * - .meta({ example: ... }) → example (example value)
  */
 import type { ZodType } from 'zod';
-import type { ParameterDef } from '../types/skill.js';
+import type { OpenAPISchema, ParameterDef } from '../types/skill.js';
 /**
- * Zod metadata 扩展接口
+ * Zod metadata extension interface
  *
- * 用于存储示例值等 OpenAPI 特有信息
+ * Used to store example values and other OpenAPI-specific information
  */
 interface ZodMeta {
     example?: unknown;
@@ -31,16 +31,26 @@ interface ZodMeta {
     format?: string;
 }
 /**
- * 从 Zod schema 生成 OpenAPI parameters
+ * Generate OpenAPI parameters from Zod schema
  *
  * @param shape ZodObject schema
- * @param descriptions 可选的参数描述覆盖
+ * @param descriptions Optional parameter description overrides
  */
 export declare function zodToParams<T extends ZodType>(shape: T, descriptions?: Record<string, string>): ParameterDef[];
 /**
- * 为 Zod schema 添加 metadata（示例值等）
+ * Convert Zod schema to OpenAPI Schema
  *
- * 用法：
+ * Supports all Zod types including nested objects and arrays.
+ * Compatible with Zod v3 and v4.
+ *
+ * @param schema Zod schema
+ * @returns OpenAPI Schema
+ */
+export declare function zodToOpenAPISchema(schema: ZodType): OpenAPISchema;
+/**
+ * Add metadata to Zod schema (example values, etc.)
+ *
+ * Usage:
  * ```ts
  * import { z } from 'zod';
  * import { withMeta } from '@rtc-agent/component';

package/dist/validation/zod-to-openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod-to-openapi.d.ts","sourceRoot":"","sources":["../../src/validation/zod-to-openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE;;;;GAIG;AACH,UAAU,OAAO;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAC3C,KAAK,EAAE,CAAC,EACR,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,YAAY,EAAE,CAkDhB;AA2KD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAMvE"}
+{"version":3,"file":"zod-to-openapi.d.ts","sourceRoot":"","sources":["../../src/validation/zod-to-openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE;;;;GAIG;AACH,UAAU,OAAO;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAC3C,KAAK,EAAE,CAAC,EACR,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,YAAY,EAAE,CAkDhB;AA8ED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAEjE;AAsND;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAMvE"}

package/dist/worker-bridge.d.ts

@@ -51,6 +51,17 @@ export declare class WorkerBridge {
     private static readonly INIT_RETRY_DELAY_MS;
     /** Timeout for worker liveness verification (ping/pong). */
     private static readonly VERIFICATION_TIMEOUT_MS;
+    /**
+     * Generate a worker name for SharedWorker construction.
+     *
+     * In dev mode, appends a timestamp suffix to avoid connecting to stale workers
+     * from previous sessions (e.g., after force-killing a tab during debugging).
+     * SharedWorkers persist across tab closures, so a stale worker in a bad state
+     * can cause verification timeouts on subsequent page loads.
+     *
+     * In production mode, uses a fixed name for predictable multi-tab sharing.
+     */
+    private static _getWorkerName;
     constructor(_auth: AuthController, config?: WorkerBridgeConfig);
     /**
      * Asynchronously create a SharedWorker instance.

package/dist/worker-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-bridge.d.ts","sourceRoot":"","sources":["../src/worker-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,MAAM,EAAC,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAC,iBAAiB,EAA4C,MAAM,wBAAwB,CAAC;AACzG,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAC,qBAAqB,EAAkB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AAmErE,MAAM,WAAW,kBAAkB;IAC/B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IAkBjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAjB1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAkB;IACpC,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAqB;IAEpC,qDAAqD;IACrD,OAAO,CAAC,oBAAoB,CAAoD;IAEhF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IACnD,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;gBAGlC,KAAK,EAAE,cAAc,EACtC,MAAM,GAAE,kBAAuB;IAuDnC;;;;;;;;;;;;OAYG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC;;OAEG;YACW,eAAe;IAgG7B;;;;;;OAMG;YACW,kBAAkB;IAkChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAExC;IAED;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpD;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIpD;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IASpF;;;;;;;;;OASG;IACH,qBAAqB,IAAI,IAAI;CAyChC"}
+{"version":3,"file":"worker-bridge.d.ts","sourceRoot":"","sources":["../src/worker-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,MAAM,EAAC,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAC,iBAAiB,EAA4C,MAAM,wBAAwB,CAAC;AACzG,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAC,qBAAqB,EAAkB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AAmErE,MAAM,WAAW,kBAAkB;IAC/B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IAqCjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IApC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAkB;IACpC,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAqB;IAEpC,qDAAqD;IACrD,OAAO,CAAC,oBAAoB,CAAoD;IAEhF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IACnD,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAEvD;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;gBAUR,KAAK,EAAE,cAAc,EACtC,MAAM,GAAE,kBAAuB;IAuDnC;;;;;;;;;;;;OAYG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC;;OAEG;YACW,eAAe;IAuG7B;;;;;;OAMG;YACW,kBAAkB;IA0ChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAExC;IAED;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpD;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIpD;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IASpF;;;;;;;;;OASG;IACH,qBAAqB,IAAI,IAAI;CAyChC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtc-agent/component",
-  "version": "0.2.7-rc.4",
+  "version": "0.2.8-rc.1",
   "description": "RTC Agent Web Components（基于 Lit）",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,10 +32,10 @@
     "lit": "^3.1.0",
     "marked": "^18.0.11",
     "zod": "^3.23.8",
-    "@rtc-agent/client": "0.2.7-rc.4",
-    "@rtc-agent/persistence": "0.2.7-rc.4",
-    "@rtc-agent/protocol": "0.2.7-rc.4",
-    "@rtc-agent/worker": "0.2.7-rc.4"
+    "@rtc-agent/client": "0.2.8-rc.1",
+    "@rtc-agent/persistence": "0.2.8-rc.1",
+    "@rtc-agent/worker": "0.2.8-rc.1",
+    "@rtc-agent/protocol": "0.2.8-rc.1"
   },
   "devDependencies": {
     "@lit/localize-tools": "^0.8.2",