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

package/dist/core/event-bus.d.ts

@@ -1,85 +1,85 @@
 /**
  * Event Bus
  *
- * 简单的事件总线，用于解耦 FunctionRegistry 和 UI
+ * Simple event bus for decoupling FunctionRegistry and UI.
  *
- * 使用场景：
- * - FunctionRegistry 发出 function:start/success/error/progress 事件
- * - UI 层监听事件并显示 toast/confirm/progress
- * - 宿主应用（Flutter）监听事件并通过 postMessage 转发
+ * Usage scenarios:
+ * - FunctionRegistry emits function:start/success/error/progress events
+ * - UI layer listens to events and displays toast/confirm/progress
+ * - Host applications (Flutter) listen to events and forward via postMessage
  */
 /**
- * 事件处理器类型
+ * Event handler type
  */
 export type EventHandler<T = unknown> = (event: T) => void | Promise<void>;
 /**
- * MD8: 事件映射接口 - 为事件名提供类型安全
+ * MD8: Event map interface - provides type safety for event names
  *
- * 使用方法：
+ * Usage:
  * ```ts
  * interface MyEvents {
  *   'user:login': { userId: string };
  *   'user:logout': void;
  * }
  * const bus = createEventBus<MyEvents>();
- * bus.on('user:login', (event) => { ... }); // event 类型为 { userId: string }
+ * bus.on('user:login', (event) => { ... }); // event type is { userId: string }
  * ```
  */
 export interface DefaultEventMap {
     [event: string]: unknown;
 }
 /**
- * 事件总线
+ * Event bus
  *
- * @typeParam TEventMap - 事件名到数据类型的映射（MD8）
+ * @typeParam TEventMap - Mapping from event names to data types (MD8)
  */
 export declare class EventBus<TEventMap extends DefaultEventMap = DefaultEventMap> {
     private handlers;
     /**
-     * 订阅事件
+     * Subscribe to event
      *
-     * @returns 取消订阅的函数
+     * @returns Unsubscribe function
      */
     on<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
     /**
-     * 订阅一次性事件
+     * Subscribe to one-time event
      */
     once<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
     /**
-     * 取消订阅
+     * Unsubscribe
      */
     off<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): void;
     /**
-     * 发出事件（同步）
+     * Emit event (synchronous)
      *
-     * M8: 迭代前对 handlers 做快照（Array.from），避免 handler 内调用 off 导致并发修改
+     * M8: Snapshot handlers (Array.from) before iteration to avoid concurrent modification when handler calls off
      */
     emit<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): void;
     /**
-     * 发出事件（异步，等待所有 handler 完成）
+     * Emit event (async, wait for all handlers to complete)
      *
-     * M9: 注意：此方法永远 resolve，handler 中的错误会被 catch 并通过 log.error 输出。
-     * 如果需要错误传播（handler 错误导致 emitAsync reject），请使用 emitAsyncStrict。
+     * M9: Note: this method always resolves; errors in handlers are caught and output via log.error.
+     * If error propagation is needed (handler errors cause emitAsync to reject), use emitAsyncStrict.
      */
     emitAsync<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): Promise<void>;
     /**
-     * M9: 严格版异步事件发出 - handler 错误会导致 Promise reject
+     * M9: Strict async event emit - handler errors cause Promise rejection
      *
-     * 与 emitAsync 不同，此方法不会吞掉 handler 中的错误。
-     * 任一 handler 抛出错误，返回的 Promise 将 reject。
+     * Unlike emitAsync, this method does not swallow errors from handlers.
+     * If any handler throws, the returned Promise will reject.
      */
     emitAsyncStrict<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): Promise<void>;
     /**
-     * m6: 清除所有事件的所有处理器（改名为 clearAll 与 clearEvent 对称）
+     * m6: Clear all handlers for all events (renamed to clearAll for symmetry with clearEvent)
      */
     clearAll(): void;
     /**
-     * 清除指定事件的所有处理器
+     * Clear all handlers for a specific event
      */
     clearEvent(event: string): void;
 }
 /**
- * Function 执行相关事件
+ * Function execution related events
  */
 export interface FunctionStartEvent {
     path: string;
@@ -98,7 +98,7 @@ export interface FunctionProgressEvent {
     progress: number;
 }
 /**
- * MD8: FunctionRegistry 使用的事件映射
+ * MD8: Event map used by FunctionRegistry
  */
 export interface FunctionRegistryEventMap extends DefaultEventMap {
     'function:start': FunctionStartEvent;
@@ -120,14 +120,14 @@ export interface FunctionRegistryEventMap extends DefaultEventMap {
     };
 }
 /**
- * MD7: 事件总线工厂函数
+ * MD7: Event bus factory function
  *
- * 使用工厂函数创建新的事件总线实例，避免全局单例的问题。
- * 全局实例 `defaultEventBus` 只是默认导出，应用可以创建自己的实例。
+ * Uses factory function to create new event bus instances, avoiding global singleton issues.
+ * The global instance `defaultEventBus` is just the default export; applications can create their own instances.
  */
 export declare function createEventBus<TEventMap extends DefaultEventMap = DefaultEventMap>(): EventBus<TEventMap>;
 /**
- * 全局默认事件总线实例（MD7：仅作为默认导出，推荐使用 createEventBus() 创建独立实例）
+ * Global default event bus instance (MD7: only as default export; recommended to use createEventBus() to create independent instances)
  */
 export declare const eventBus: EventBus<FunctionRegistryEventMap>;
 //# sourceMappingURL=event-bus.d.ts.map

package/dist/core/function-registry.d.ts

@@ -1,13 +1,13 @@
 /**
  * Function Registry
  *
- * 管理 Function 注册、解析、链式调用
- * 使用 Proxy 实现 rtcAgent.user.register() 语法
+ * Manages function registration, resolution, and chain calls.
+ * Uses Proxy to implement rtcAgent.user.register() syntax.
  */
 import type { FunctionDef, FunctionGroupDef, RegistryConfig, ScenarioDef } from '../types/skill.js';
 /**
- * FunctionGroup 实例
- * 支持链式注册和调用
+ * FunctionGroup instance
+ * Supports chain registration and invocation
  */
 export declare class FunctionGroup {
     private registry;
@@ -15,27 +15,27 @@ export declare class FunctionGroup {
     private functions;
     constructor(registry: FunctionRegistry, groupDef: FunctionGroupDef);
     /**
-     * 注册 Function 到当前 Group
+     * Register a function to the current group
      *
-     * @param funcDef Function 定义，name 为必填（Group 内的函数名称，不含 Group 前缀）
+     * @param funcDef Function definition, name is required (function name within the group, without group prefix)
      */
     register(funcDef: Omit<FunctionDef, 'name'> & {
         name: string;
     }): FunctionDef;
     /**
-     * 获取 Group 内的所有 Function
+     * Get all functions within the group
      */
     listFunctions(): FunctionDef[];
     /**
-     * 通过 Proxy 支持链式调用：rtcAgent.task.list(params)
+     * Support chain calls via Proxy: rtcAgent.task.list(params)
      *
-     * 白名单方法直接返回，其他属性名视为 Group 内的函数名，
-     * 返回一个调用 registry.execute('group.funcName', params) 的函数。
+     * Whitelist methods are returned directly; other property names are treated as function names within the group,
+     * returning a function that calls registry.execute('group.funcName', params).
      */
     createProxy(): FunctionGroup & Record<string, (params?: Record<string, unknown>) => Promise<unknown>>;
 }
 /**
- * FunctionRegistry - 全局注册表
+ * FunctionRegistry - Global registry
  */
 export declare class FunctionRegistry {
     private config;
@@ -45,141 +45,152 @@ export declare class FunctionRegistry {
     private groupDefs;
     constructor(config: RegistryConfig);
     /**
-     * 注册单个 Function
+     * Register a single function
      *
-     * M10: 注意，文档生成（_updateFunctionDoc）是异步的 fire-and-forget 操作。
-     * register() 返回后，文档可能尚未写入虚拟文件系统。
-     * 文档通常会在几百毫秒内就绪，但不保证在 register() 返回时已完成。
-     * 如果需要确保文档就绪，请手动调用虚拟文件系统的 read 并等待。
+     * M10: Note that document generation (_updateFunctionDoc) is an async fire-and-forget operation.
+     * After register() returns, the document may not yet be written to the virtual file system.
+     * Documents will typically be ready within a few hundred milliseconds, but completion at register() return is not guaranteed.
+     * If you need to ensure the document is ready, manually call the virtual file system's read and wait.
      */
     register(funcDef: FunctionDef): FunctionDef;
     /**
-     * 内部方法：注册 Function（由 FunctionGroup 调用）
+     * Internal method: Register a function (called by FunctionGroup)
      *
-     * @internal 仅供内部使用，外部应使用 register() 方法
+     * @internal For internal use only; external callers should use the register() method
      *
-     * M10: 同 register()，文档生成是异步 fire-and-forget，可能延迟就绪。
+     * M10: Same as register(), document generation is async fire-and-forget and may be delayed in becoming ready.
      */
     registerInternal(funcDef: FunctionDef, groupName: string): void;
     /**
-     * 创建 FunctionGroup
+     * Normalize a FunctionDef by deriving parameters from zodSchema when parameters is not set.
      *
-     * 返回 Proxy 包装的 FunctionGroup，支持链式调用：
+     * Ensures all downstream consumers (debugger, default params, markdown generator)
+     * can rely on `fn.parameters` being populated.
+     */
+    private _normalizeFunctionDef;
+    /**
+     * Create a FunctionGroup
+     *
+     * Returns a Proxy-wrapped FunctionGroup supporting chain calls:
      * rtcAgent.task.list(params) → rtcAgent.execute('task.list', params)
      */
     createGroup(groupDef: FunctionGroupDef): FunctionGroup & Record<string, (params?: Record<string, unknown>) => Promise<unknown>>;
     /**
-     * 注销 Function
+     * Unregister a function
      *
-     * 删除内存中的 Function 定义，同时删除虚拟文件系统中的文档，并更新索引
+     * Removes the function definition from memory, deletes the document in the virtual file system, and updates the index.
      *
-     * MD9: unregister 是 async 而 register 是 sync 的设计原因：
-     * - register 只需更新内存 Map（同步操作），文档生成是后台 fire-and-forget
-     * - unregister 需要删除虚拟文件系统中的文档文件并更新索引，这些是 I/O 操作
-     * - 调用方通常需要在注销完成后确认文件系统已清理，因此 unregister 返回 Promise
+     * MD9: Design rationale for unregister being async while register is sync:
+     * - register only updates the in-memory Map (synchronous operation); document generation is background fire-and-forget
+     * - unregister needs to delete document files in the virtual file system and update the index, which are I/O operations
+     * - Callers typically need to confirm file system cleanup after unregister completes, so unregister returns a Promise
      */
     unregister(name: string): Promise<void>;
     /**
-     * 解析 Function 路径
+     * Resolve a function path
      */
     resolve(path: string): FunctionDef | undefined;
     /**
-     * 列出所有 Function
+     * List all functions
      */
     listFunctions(): FunctionDef[];
     /**
-     * 列出所有 Group
+     * List all groups
      */
     listGroups(): FunctionGroupDef[];
     /**
-     * 重新生成所有文档（用于数据库初始化后）
+     * Regenerate all documents (used after database initialization)
      *
-     * 解决时序问题：register() 在数据库初始化前调用时，文档写入会失败。
-     * 数据库初始化完成后，调用此方法重新生成所有文档。
+     * Solves timing issue: when register() is called before database initialization, document writes will fail.
+     * After database initialization completes, call this method to regenerate all documents.
      *
-     * 应使用 generateAllDocsContent() + WorkerBridge.batchWriteFiles()
+     * Should use generateAllDocsContent() + WorkerBridge.batchWriteFiles()
      */
     regenerateAllDocs(): Promise<void>;
     /**
-     * 生成所有文档内容（不写入 VirtualFS）
+     * Generate all document content (without writing to VirtualFS), and calculate orphan paths to delete
      *
-     * 使用方式：主线程生成内容，通过 WorkerBridge.batchWriteFiles() 发送到 Worker 写入。
+     * Usage: main thread generates content, sends it to Worker via WorkerBridge.batchWriteFiles() for writing.
+     * Also queries existing function documents in VFS to calculate orphan paths that are no longer registered, and passes them to Worker for deletion.
      *
-     * @param scenarioCount scenario 数量（用于生成 AGENT.md）
-     * @returns 文件路径和内容数组
+     * @param scenarioCount Number of scenarios (used for generating AGENT.md)
+     * @returns files: list of files to write, deletePaths: orphan paths to delete
      */
-    generateAllDocsContent(scenarioCount?: number): Array<{
-        path: string;
-        content: string;
+    generateAllDocsContent(scenarioCount?: number): Promise<{
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+        deletePaths: string[];
     }>;
     /**
-     * 执行 Function
+     * Execute a function
      *
-     * 使用事件驱动架构，不直接调用 UI：
-     * - 发出 function:start/success/error/progress 事件
-     * - UI 层监听事件并处理
+     * Uses event-driven architecture, does not directly invoke UI:
+     * - Emits function:start/success/error/progress events
+     * - UI layer listens to events and handles them
      *
-     * CancelledError 处理：
-     * - onStart 抛出的 CancelledError 不触发 onError
+     * CancelledError handling:
+     * - CancelledError thrown by onStart does not trigger onError
      *
-     * M11: onSuccess 使用 fire-and-forget，与 eventBus.emit('function:success') 无顺序保证。
-     *      onSuccess 可能在 function:success 事件之前或之后完成。
-     *     如需严格顺序，请使用事件监听替代 hook。
+     * M11: onSuccess uses fire-and-forget, no ordering guarantee with eventBus.emit('function:success').
+     *      onSuccess may complete before or after the function:success event.
+     *     For strict ordering, use event listeners instead of hooks.
      */
     execute(path: string, params: Record<string, unknown>): Promise<unknown>;
     /**
-     * 写入 Scenario
+     * Write a scenario
      *
-     * m8: scenario.id 字段被忽略，文件名始终从 title 生成 slug。
-     * 原因：虚拟文件系统的文件路径基于 title slug，id 仅用于数据库索引。
-     * scenario.id 在 scenario-loader 的 manifest 中用于唯一标识，但不影响文件存储路径。
+     * m8: scenario.id field is ignored; filename is always generated from title slug.
+     * Reason: virtual file system paths are based on title slug; id is only used for database indexing.
+     * scenario.id is used for unique identification in scenario-loader's manifest, but does not affect file storage path.
      *
-     * 写入策略：使用 'create-new' 模式，文件已存在时不覆盖（保护用户编辑的内容）
+     * Write strategy: uses 'create-new' mode; does not overwrite if file already exists (protects user-edited content)
      */
     writeScenario(scenario: ScenarioDef): Promise<void>;
     /**
-     * 更新 Function 文档
+     * Update function documentation
      */
     private _updateFunctionDoc;
     /**
-     * 更新 Functions 索引
+     * Update Functions index
      *
-     * 写入策略：使用 'overwrite' 模式（索引文件总是最新状态）
+     * Write strategy: uses 'overwrite' mode (index file is always up to date)
      */
     private _updateFunctionsIndex;
     /**
-     * 更新 Scenarios 索引
+     * Update Scenarios index
      *
-     * 写入策略：使用 'overwrite' 模式（索引文件总是最新状态）
+     * Write strategy: uses 'overwrite' mode (index file is always up to date)
      */
     private _updateScenariosIndex;
     /**
-     * 更新 AGENT.md
+     * Update AGENT.md
      *
-     * 写入策略：使用 'create-new' 模式，文件已存在时不覆盖（保护用户编辑的内容）
+     * Write strategy: uses 'create-new' mode; does not overwrite if file already exists (protects user-edited content)
      */
     private _updateAgentMd;
     /**
-     * 字符串转 slug
+     * Convert string to slug
      *
-     * 支持 CJK 字符（中文、日文、韩文）
-     * 如果结果为空，则使用时间戳 + 随机数
+     * Supports CJK characters (Chinese, Japanese, Korean)
+     * If the result is empty, uses timestamp + random number
      *
-     * MD10: slug 截断到 100 字符，避免文件名过长
+     * MD10: slug is truncated to 100 characters to avoid overly long filenames
      */
     private _slugify;
     /**
-     * M12: 通过 Proxy 支持链式调用：rtcAgent.user.register(params)
+     * M12: Support chain calls via Proxy: rtcAgent.user.register(params)
      *
-     * 使用白名单方式暴露方法，不暴露 functions/groups 等私有属性
+     * Uses whitelist to expose methods, without exposing private properties like functions/groups
      */
     createProxy(): FunctionRegistry & Record<string, FunctionGroup>;
 }
 /**
- * 创建全局 Registry
+ * Create global Registry
  *
- * 自动注册内置 system 工具组（delay/uuid/now/random/time），
- * 使脚本可以通过 rtcAgent.system.* 访问被沙箱阻断的常用平台 API。
+ * Automatically registers the built-in system tool group (delay/uuid/now/random/time),
+ * allowing scripts to access commonly used platform APIs sandboxed via rtcAgent.system.*.
  */
 export declare function defineRegistry(config: RegistryConfig): FunctionRegistry & Record<string, FunctionGroup>;
 //# sourceMappingURL=function-registry.d.ts.map

package/dist/core/function-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function-registry.d.ts","sourceRoot":"","sources":["../../src/core/function-registry.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAO3B;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAkC;gBAEvC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB;IAKlE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAe5E;;OAEG;IACH,aAAa,IAAI,WAAW,EAAE;IAI9B;;;;;OAKG;IACH,WAAW,IAAI,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CA8BtG;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,YAAY,CAA6G;IACjI,OAAO,CAAC,SAAS,CAAuC;gBAE5C,MAAM,EAAE,cAAc;IAIlC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW;IAc3C;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAO/D;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAc/H;;;;;;;;;OASG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI9C;;OAEG;IACH,aAAa,IAAI,WAAW,EAAE;IAI9B;;OAEG;IACH,UAAU,IAAI,gBAAgB,EAAE;IAIhC;;;;;;;OAOG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BxC;;;;;;;OAOG;IACH,sBAAsB,CAAC,aAAa,SAAI,GAAG,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC;IAgCjF;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAoF9E;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzD;;OAEG;YACW,kBAAkB;IA8BhC;;;;OAIG;YACW,qBAAqB;IAQnC;;;;OAIG;YACW,qBAAqB;IAcnC;;;;OAIG;YACW,cAAc;IAU5B;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAuBhB;;;;OAIG;IACH,WAAW,IAAI,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CA6ChE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAIvG"}
+{"version":3,"file":"function-registry.d.ts","sourceRoot":"","sources":["../../src/core/function-registry.ts"],"names":[],"mappings":"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"}

package/dist/core/i18n.d.ts

@@ -18,8 +18,8 @@ export declare function isValidLocale(value: string): value is SupportedLocale;
 export declare function initLocale(hostLang?: string): Promise<void>;
 export declare function persistLocale(locale: SupportedLocale): void;
 /**
- * 切换语言并同步所有相关状态
- * 组件中应调用此函数而非直接调用 _setLocale
+ * Switch language and synchronize all related state
+ * Components should call this function instead of calling _setLocale directly
  */
 export declare function switchLocale(locale: SupportedLocale): Promise<void>;
 //# sourceMappingURL=i18n.d.ts.map

package/dist/core/locale-controller.d.ts

@@ -1,6 +1,6 @@
 import { type ReactiveController, type ReactiveControllerHost } from 'lit';
 /**
- * 封装 locale context 消费逻辑，减少组件样板代码
+ * Wraps locale context consumption logic to reduce component boilerplate
  *
  * @example
  * ```typescript
@@ -10,7 +10,7 @@ import { type ReactiveController, type ReactiveControllerHost } from 'lit';
  *   private _locale = new LocaleController(this);
  *
  *   render() {
- *     return html`<p>当前: ${this._locale.locale}</p>`;
+ *     return html`<p>Current: ${this._locale.locale}</p>`;
  *   }
  * }
  * ```

package/dist/core/markdown-generator.d.ts

@@ -1,22 +1,32 @@
 /**
  * Markdown Generator
  *
- * 从 FunctionDef 生成 markdown 文档
- * 使用 OpenAPI Schema 格式描述参数和返回值
+ * Generates markdown documentation from FunctionDef.
+ * Uses OpenAPI Schema format to describe parameters and return values.
  */
-import type { FunctionDef, FunctionGroupDef, RegistryConfig } from '../types/skill.js';
+import type { FunctionDef, FunctionGroupDef, RegistryConfig, OpenAPISchema } from '../types/skill.js';
 /**
- * 生成单个 Function 的 markdown 文档
+ * Convert OpenAPI Schema to a readable type string
  *
- * 文件头添加生成标识注释，标识该文件由系统自动生成
+ * References openapi-markdown's dataTypes.js logic
+ */
+export declare function schemaToTypeString(schema: OpenAPISchema): string;
+/**
+ * Generate markdown documentation for a single Function
+ *
+ * Adds a generation identifier comment at the file header to mark it as auto-generated
  */
 export declare function generateFunctionMd(funcDef: FunctionDef, groupName?: string): string;
 /**
- * 生成 Functions 索引（按分组组织）
+ * Generate example value based on OpenAPI Schema
+ */
+export declare function getExampleValue(schema: OpenAPISchema): string;
+/**
+ * Generate Functions index (organized by group)
  */
 export declare function generateFunctionsIndex(functions: FunctionDef[], groups: FunctionGroupDef[]): string;
 /**
- * 生成 Scenarios 索引
+ * Generate Scenarios index
  */
 export declare function generateScenariosIndex(scenarios: Array<{
     path: string;
@@ -27,10 +37,10 @@ export declare function generateScenariosIndex(scenarios: Array<{
     };
 }>): string;
 /**
- * 生成 AGENT.md
+ * Generate AGENT.md
  *
- * Agent Prompt 定义 Agent 的身份、工作流和能力。
- * 前端生成此内容，Server 端有默认降级实现。
+ * Agent Prompt defines the Agent's identity, workflow, and capabilities.
+ * The frontend generates this content; the server has a default fallback implementation.
  */
 export declare function generateAgentMd(config: RegistryConfig, functions: FunctionDef[], groups: FunctionGroupDef[], scenarioCount: number): string;
 //# sourceMappingURL=markdown-generator.d.ts.map

package/dist/core/markdown-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../../src/core/markdown-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAA+B,MAAM,mBAAmB,CAAC;AAuHpH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwFnF;AAgDD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,gBAAgB,EAAE,GACzB,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,CAAC,GAAG,MAAM,CAgBV;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,MAAM,GACpB,MAAM,CAaR"}
+{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../../src/core/markdown-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAMpH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAqChE;AAuED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgInF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAyC7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,gBAAgB,EAAE,GACzB,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,CAAC,GAAG,MAAM,CAgBV;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,MAAM,GACpB,MAAM,CAaR"}

package/dist/core/ready.d.ts

@@ -1,14 +1,14 @@
 /**
  * Module Ready Signal
  *
- * 提供两种机制让宿主应用等待 <rtc-agent> 组件初始化完成：
- * 1. `whenReady()` Promise — ES module 风格
- * 2. `rtc-agent-ready` 自定义事件 — Web Component 风格（由 RtcAgent 组件派发）
+ * Provides two mechanisms for the host application to wait for <rtc-agent> component initialization:
+ * 1. `whenReady()` Promise — ES module style
+ * 2. `rtc-agent-ready` custom event — Web Component style (dispatched by RtcAgent component)
  *
- * 内部使用：组件在 firstUpdated 时调用 _markReady()。
+ * Internal use: component calls _markReady() on firstUpdated.
  */
 /**
- * 等待 <rtc-agent> 组件模块加载并初始化完成
+ * Wait for the <rtc-agent> component module to load and initialize
  *
  * @example
  * ```ts
@@ -20,14 +20,14 @@
  */
 export declare const whenReady: Promise<void>;
 /**
- * 标记模块已就绪（内部使用）
+ * Mark the module as ready (internal use)
  *
- * 由 RtcAgent 组件在 firstUpdated 时调用。
- * 重复调用是安全的（后续调用立即返回）。
+ * Called by RtcAgent component on firstUpdated.
+ * Safe to call multiple times (subsequent calls return immediately).
  */
 export declare function _markReady(): void;
 /**
- * 检查模块是否已就绪（内部使用，主要用于测试）
+ * Check whether the module is ready (internal use, mainly for testing)
  */
 export declare function _isReady(): boolean;
 //# sourceMappingURL=ready.d.ts.map

package/dist/core/scenario-loader.d.ts

@@ -1,21 +1,21 @@
 /**
  * Scenario Loader
  *
- * 从 URL 加载 Scenario markdown 文件
+ * Loads Scenario markdown files from a URL
  */
 /**
- * 解析 YAML frontmatter
+ * Parse YAML frontmatter
  *
- * 格式：
+ * Format:
  * ---
- * title: "标题"
+ * title: "Title"
  * tags: [tag1, tag2]
  * ---
  *
- * 内容...
+ * Content...
  *
- * 支持的字段：title, id, name, description, tags, author, createdAt
- * 限制：不支持多行值、复杂 YAML 结构
+ * Supported fields: title, id, name, description, tags, author, createdAt
+ * Limitations: does not support multi-line values or complex YAML structures
  */
 export declare function parseFrontmatter(content: string): {
     id?: string;
@@ -28,29 +28,33 @@ export declare function parseFrontmatter(content: string): {
     body: string;
 };
 /**
- * 从 URL 加载 Scenarios
+ * Load Scenarios from URL
  *
- * @param baseURL Scenario 文件的基础 URL（如 '/scenarios/'）
- * @param timeoutMs 每个请求的超时时间（毫秒，默认 10000）
- * @returns 加载的 Scenario 数量
+ * @param baseURL Base URL for Scenario files (e.g. '/scenarios/')
+ * @param timeoutMs Timeout per request in milliseconds (default 10000)
+ * @returns Number of Scenarios loaded
  */
 export declare function loadScenariosFromURL(baseURL: string, timeoutMs?: number): Promise<number>;
 /**
- * 从 URL 加载 Scenarios 内容（不写入 VirtualFS）
+ * Load Scenarios content from URL (without writing to VirtualFS), and compute orphan paths to delete
  *
- * 使用方式：主线程获取内容，通过 WorkerBridge.batchWriteFiles() 发送到 Worker 写入。
+ * Usage: main thread fetches content, then sends it via WorkerBridge.batchWriteFiles() to the Worker for writing.
+ * Also queries existing scenario files in VFS to compute orphan paths not in the manifest, passing them to the Worker for deletion.
  *
- * @param baseURL Scenario 文件的基础 URL
- * @param timeoutMs 每个请求的超时时间
- * @returns 文件路径和内容数组
+ * @param baseURL Base URL for Scenario files
+ * @param timeoutMs Timeout per request
+ * @returns files: files to write, deletePaths: orphan paths to delete
  */
-export declare function loadScenariosContent(baseURL: string, timeoutMs?: number): Promise<Array<{
-    path: string;
-    content: string;
-    metadata: {
-        name?: string;
-        description?: string;
-        tags?: string[];
-    };
-}>>;
+export declare function loadScenariosContent(baseURL: string, timeoutMs?: number): Promise<{
+    files: Array<{
+        path: string;
+        content: string;
+        metadata: {
+            name?: string;
+            description?: string;
+            tags?: string[];
+        };
+    }>;
+    deletePaths: string[];
+}>;
 //# sourceMappingURL=scenario-loader.d.ts.map

package/dist/core/scenario-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario-loader.d.ts","sourceRoot":"","sources":["../../src/core/scenario-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAuEA;AAiBD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFtG;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAC,CAAA;CAAC,CAAC,CAAC,CAgEnH"}
+{"version":3,"file":"scenario-loader.d.ts","sourceRoot":"","sources":["../../src/core/scenario-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAuEA;AAiBD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFtG;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC;IACT,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;IAC/G,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,CA+ED"}