@rtc-agent/component 0.2.7-rc.3 → 0.2.7-rc.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,185 @@
+/**
+ * Function Registry
+ *
+ * 管理 Function 注册、解析、链式调用
+ * 使用 Proxy 实现 rtcAgent.user.register() 语法
+ */
+import type { FunctionDef, FunctionGroupDef, RegistryConfig, ScenarioDef } from '../types/skill.js';
+/**
+ * FunctionGroup 实例
+ * 支持链式注册和调用
+ */
+export declare class FunctionGroup {
+    private registry;
+    private groupName;
+    private functions;
+    constructor(registry: FunctionRegistry, groupDef: FunctionGroupDef);
+    /**
+     * 注册 Function 到当前 Group
+     *
+     * @param funcDef Function 定义，name 为必填（Group 内的函数名称，不含 Group 前缀）
+     */
+    register(funcDef: Omit<FunctionDef, 'name'> & {
+        name: string;
+    }): FunctionDef;
+    /**
+     * 获取 Group 内的所有 Function
+     */
+    listFunctions(): FunctionDef[];
+    /**
+     * 通过 Proxy 支持链式调用：rtcAgent.task.list(params)
+     *
+     * 白名单方法直接返回，其他属性名视为 Group 内的函数名，
+     * 返回一个调用 registry.execute('group.funcName', params) 的函数。
+     */
+    createProxy(): FunctionGroup & Record<string, (params?: Record<string, unknown>) => Promise<unknown>>;
+}
+/**
+ * FunctionRegistry - 全局注册表
+ */
+export declare class FunctionRegistry {
+    private config;
+    private functions;
+    private groups;
+    private groupProxies;
+    private groupDefs;
+    constructor(config: RegistryConfig);
+    /**
+     * 注册单个 Function
+     *
+     * M10: 注意，文档生成（_updateFunctionDoc）是异步的 fire-and-forget 操作。
+     * register() 返回后，文档可能尚未写入虚拟文件系统。
+     * 文档通常会在几百毫秒内就绪，但不保证在 register() 返回时已完成。
+     * 如果需要确保文档就绪，请手动调用虚拟文件系统的 read 并等待。
+     */
+    register(funcDef: FunctionDef): FunctionDef;
+    /**
+     * 内部方法：注册 Function（由 FunctionGroup 调用）
+     *
+     * @internal 仅供内部使用，外部应使用 register() 方法
+     *
+     * M10: 同 register()，文档生成是异步 fire-and-forget，可能延迟就绪。
+     */
+    registerInternal(funcDef: FunctionDef, groupName: string): void;
+    /**
+     * 创建 FunctionGroup
+     *
+     * 返回 Proxy 包装的 FunctionGroup，支持链式调用：
+     * rtcAgent.task.list(params) → rtcAgent.execute('task.list', params)
+     */
+    createGroup(groupDef: FunctionGroupDef): FunctionGroup & Record<string, (params?: Record<string, unknown>) => Promise<unknown>>;
+    /**
+     * 注销 Function
+     *
+     * 删除内存中的 Function 定义，同时删除虚拟文件系统中的文档，并更新索引
+     *
+     * MD9: unregister 是 async 而 register 是 sync 的设计原因：
+     * - register 只需更新内存 Map（同步操作），文档生成是后台 fire-and-forget
+     * - unregister 需要删除虚拟文件系统中的文档文件并更新索引，这些是 I/O 操作
+     * - 调用方通常需要在注销完成后确认文件系统已清理，因此 unregister 返回 Promise
+     */
+    unregister(name: string): Promise<void>;
+    /**
+     * 解析 Function 路径
+     */
+    resolve(path: string): FunctionDef | undefined;
+    /**
+     * 列出所有 Function
+     */
+    listFunctions(): FunctionDef[];
+    /**
+     * 列出所有 Group
+     */
+    listGroups(): FunctionGroupDef[];
+    /**
+     * 重新生成所有文档（用于数据库初始化后）
+     *
+     * 解决时序问题：register() 在数据库初始化前调用时，文档写入会失败。
+     * 数据库初始化完成后，调用此方法重新生成所有文档。
+     *
+     * 应使用 generateAllDocsContent() + WorkerBridge.batchWriteFiles()
+     */
+    regenerateAllDocs(): Promise<void>;
+    /**
+     * 生成所有文档内容（不写入 VirtualFS）
+     *
+     * 使用方式：主线程生成内容，通过 WorkerBridge.batchWriteFiles() 发送到 Worker 写入。
+     *
+     * @param scenarioCount scenario 数量（用于生成 AGENT.md）
+     * @returns 文件路径和内容数组
+     */
+    generateAllDocsContent(scenarioCount?: number): Array<{
+        path: string;
+        content: string;
+    }>;
+    /**
+     * 执行 Function
+     *
+     * 使用事件驱动架构，不直接调用 UI：
+     * - 发出 function:start/success/error/progress 事件
+     * - UI 层监听事件并处理
+     *
+     * CancelledError 处理：
+     * - onStart 抛出的 CancelledError 不触发 onError
+     *
+     * M11: onSuccess 使用 fire-and-forget，与 eventBus.emit('function:success') 无顺序保证。
+     *      onSuccess 可能在 function:success 事件之前或之后完成。
+     *     如需严格顺序，请使用事件监听替代 hook。
+     */
+    execute(path: string, params: Record<string, unknown>): Promise<unknown>;
+    /**
+     * 写入 Scenario
+     *
+     * m8: scenario.id 字段被忽略，文件名始终从 title 生成 slug。
+     * 原因：虚拟文件系统的文件路径基于 title slug，id 仅用于数据库索引。
+     * scenario.id 在 scenario-loader 的 manifest 中用于唯一标识，但不影响文件存储路径。
+     *
+     * 写入策略：使用 'create-new' 模式，文件已存在时不覆盖（保护用户编辑的内容）
+     */
+    writeScenario(scenario: ScenarioDef): Promise<void>;
+    /**
+     * 更新 Function 文档
+     */
+    private _updateFunctionDoc;
+    /**
+     * 更新 Functions 索引
+     *
+     * 写入策略：使用 'overwrite' 模式（索引文件总是最新状态）
+     */
+    private _updateFunctionsIndex;
+    /**
+     * 更新 Scenarios 索引
+     *
+     * 写入策略：使用 'overwrite' 模式（索引文件总是最新状态）
+     */
+    private _updateScenariosIndex;
+    /**
+     * 更新 AGENT.md
+     *
+     * 写入策略：使用 'create-new' 模式，文件已存在时不覆盖（保护用户编辑的内容）
+     */
+    private _updateAgentMd;
+    /**
+     * 字符串转 slug
+     *
+     * 支持 CJK 字符（中文、日文、韩文）
+     * 如果结果为空，则使用时间戳 + 随机数
+     *
+     * MD10: slug 截断到 100 字符，避免文件名过长
+     */
+    private _slugify;
+    /**
+     * M12: 通过 Proxy 支持链式调用：rtcAgent.user.register(params)
+     *
+     * 使用白名单方式暴露方法，不暴露 functions/groups 等私有属性
+     */
+    createProxy(): FunctionRegistry & Record<string, FunctionGroup>;
+}
+/**
+ * 创建全局 Registry
+ *
+ * 自动注册内置 system 工具组（delay/uuid/now/random/time），
+ * 使脚本可以通过 rtcAgent.system.* 访问被沙箱阻断的常用平台 API。
+ */
+export declare function defineRegistry(config: RegistryConfig): FunctionRegistry & Record<string, FunctionGroup>;
+//# sourceMappingURL=function-registry.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/i18n.d.ts

@@ -0,0 +1,25 @@
+export declare const sourceLocale: "zh-CN";
+export declare const targetLocales: readonly ["en-US"];
+export type SupportedLocale = typeof targetLocales[number] | typeof sourceLocale;
+export declare const getLocale: (() => string) & {
+    _LIT_LOCALIZE_GET_LOCALE_?: never;
+}, _setLocale: ((newLocale: string) => Promise<void>) & {
+    _LIT_LOCALIZE_SET_LOCALE_?: never;
+};
+export interface LocaleContextValue {
+    locale: SupportedLocale;
+    setLocale: (locale: SupportedLocale) => Promise<void>;
+    locales: readonly SupportedLocale[];
+}
+export declare const localeContext: {
+    __context__: LocaleContextValue;
+};
+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
+ */
+export declare function switchLocale(locale: SupportedLocale): Promise<void>;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/core/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAC7C,eAAO,MAAM,aAAa,oBAAqB,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,YAAY,CAAC;AAWjF,eAAO,MAAQ,SAAS;;GAAa,UAAU;;CAmB7C,CAAC;AAGH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,aAAa;;CAAsD,CAAC;AAKjF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAErE;AA0BD,wBAAsB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAO3D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE"}

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

@@ -0,0 +1,25 @@
+import { type ReactiveController, type ReactiveControllerHost } from 'lit';
+/**
+ * 封装 locale context 消费逻辑，减少组件样板代码
+ *
+ * @example
+ * ```typescript
+ * @localized()
+ * @customElement('rtc-settings')
+ * export class RtcSettings extends LitElement {
+ *   private _locale = new LocaleController(this);
+ *
+ *   render() {
+ *     return html`<p>当前: ${this._locale.locale}</p>`;
+ *   }
+ * }
+ * ```
+ */
+export declare class LocaleController implements ReactiveController {
+    private _consumer;
+    constructor(host: ReactiveControllerHost & HTMLElement);
+    get locale(): import("./i18n.js").SupportedLocale;
+    get locales(): readonly import("./i18n.js").SupportedLocale[];
+    hostUpdated(): void;
+}
+//# sourceMappingURL=locale-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locale-controller.d.ts","sourceRoot":"","sources":["../../src/core/locale-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAI3E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,OAAO,CAAC,SAAS,CAA8E;gBAEnF,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAQtD,IAAI,MAAM,wCAET;IAED,IAAI,OAAO,mDAEV;IAED,WAAW;CAGZ"}

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

@@ -0,0 +1,36 @@
+/**
+ * Markdown Generator
+ *
+ * 从 FunctionDef 生成 markdown 文档
+ * 使用 OpenAPI Schema 格式描述参数和返回值
+ */
+import type { FunctionDef, FunctionGroupDef, RegistryConfig } from '../types/skill.js';
+/**
+ * 生成单个 Function 的 markdown 文档
+ *
+ * 文件头添加生成标识注释，标识该文件由系统自动生成
+ */
+export declare function generateFunctionMd(funcDef: FunctionDef, groupName?: string): string;
+/**
+ * 生成 Functions 索引（按分组组织）
+ */
+export declare function generateFunctionsIndex(functions: FunctionDef[], groups: FunctionGroupDef[]): string;
+/**
+ * 生成 Scenarios 索引
+ */
+export declare function generateScenariosIndex(scenarios: Array<{
+    path: string;
+    metadata: {
+        name?: string;
+        tags?: string[];
+        description?: string;
+    };
+}>): string;
+/**
+ * 生成 AGENT.md
+ *
+ * Agent Prompt 定义 Agent 的身份、工作流和能力。
+ * 前端生成此内容，Server 端有默认降级实现。
+ */
+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

@@ -0,0 +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"}

package/dist/core/ready.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Module Ready Signal
+ *
+ * 提供两种机制让宿主应用等待 <rtc-agent> 组件初始化完成：
+ * 1. `whenReady()` Promise — ES module 风格
+ * 2. `rtc-agent-ready` 自定义事件 — Web Component 风格（由 RtcAgent 组件派发）
+ *
+ * 内部使用：组件在 firstUpdated 时调用 _markReady()。
+ */
+/**
+ * 等待 <rtc-agent> 组件模块加载并初始化完成
+ *
+ * @example
+ * ```ts
+ * import { whenReady } from '@rtc-agent/component';
+ * await whenReady();
+ * const agent = document.querySelector<RtcAgent>('#agent')!;
+ * agent.agentConfig = { persona: '...' };
+ * ```
+ */
+export declare const whenReady: Promise<void>;
+/**
+ * 标记模块已就绪（内部使用）
+ *
+ * 由 RtcAgent 组件在 firstUpdated 时调用。
+ * 重复调用是安全的（后续调用立即返回）。
+ */
+export declare function _markReady(): void;
+/**
+ * 检查模块是否已就绪（内部使用，主要用于测试）
+ */
+export declare function _isReady(): boolean;
+//# sourceMappingURL=ready.d.ts.map

package/dist/core/ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready.d.ts","sourceRoot":"","sources":["../../src/core/ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,IAAI,CAElC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Scenario Loader
+ *
+ * 从 URL 加载 Scenario markdown 文件
+ */
+/**
+ * 解析 YAML frontmatter
+ *
+ * 格式：
+ * ---
+ * title: "标题"
+ * tags: [tag1, tag2]
+ * ---
+ *
+ * 内容...
+ *
+ * 支持的字段：title, id, name, description, tags, author, createdAt
+ * 限制：不支持多行值、复杂 YAML 结构
+ */
+export declare function parseFrontmatter(content: string): {
+    id?: string;
+    title?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    author?: string;
+    createdAt?: string;
+    body: string;
+};
+/**
+ * 从 URL 加载 Scenarios
+ *
+ * @param baseURL Scenario 文件的基础 URL（如 '/scenarios/'）
+ * @param timeoutMs 每个请求的超时时间（毫秒，默认 10000）
+ * @returns 加载的 Scenario 数量
+ */
+export declare function loadScenariosFromURL(baseURL: string, timeoutMs?: number): Promise<number>;
+/**
+ * 从 URL 加载 Scenarios 内容（不写入 VirtualFS）
+ *
+ * 使用方式：主线程获取内容，通过 WorkerBridge.batchWriteFiles() 发送到 Worker 写入。
+ *
+ * @param baseURL Scenario 文件的基础 URL
+ * @param timeoutMs 每个请求的超时时间
+ * @returns 文件路径和内容数组
+ */
+export declare function loadScenariosContent(baseURL: string, timeoutMs?: number): Promise<Array<{
+    path: string;
+    content: string;
+    metadata: {
+        name?: string;
+        description?: string;
+        tags?: string[];
+    };
+}>>;
+//# sourceMappingURL=scenario-loader.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/theme.d.ts

@@ -0,0 +1,29 @@
+export type Theme = 'light' | 'dark' | 'system';
+/**
+ * Get the current effective theme (resolves 'system' to 'light' or 'dark')
+ */
+export declare function getEffectiveTheme(theme?: Theme): 'light' | 'dark';
+/**
+ * Get the stored theme preference from localStorage
+ */
+export declare function getStoredTheme(): Theme;
+/**
+ * Persist theme preference to localStorage
+ */
+export declare function persistTheme(theme: Theme): void;
+/**
+ * Switch theme for all <rtc-agent> elements and persist the preference
+ *
+ * @example
+ * ```ts
+ * import { switchTheme } from '@rtc-agent/component';
+ * await switchTheme('dark');
+ * ```
+ */
+export declare function switchTheme(theme: Theme): void;
+/**
+ * Initialize theme from stored preference
+ * Should be called once on app startup
+ */
+export declare function initTheme(): void;
+//# sourceMappingURL=theme.d.ts.map

package/dist/core/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAKhD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,KAAwB,GAAG,OAAO,GAAG,MAAM,CAKnF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAUtC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAM/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAiB9C;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAIhC"}

package/dist/debug-api-core.d.ts

@@ -0,0 +1,9 @@
+import type { RtcAgentDebugAPI } from './debug-api-types.js';
+/**
+ * Build core debug API methods.
+ *
+ * Returns a partial implementation covering state, data, auth, events,
+ * VirtualFS, logs, UI control, and component reference.
+ */
+export declare function buildCoreAPI(): Pick<RtcAgentDebugAPI, 'getState' | 'clearData' | 'seedData' | 'loginAs' | 'logout' | 'triggerEvent' | 'listFiles' | 'readFile' | 'writeFile' | 'deleteFile' | 'logs' | 'clearLogs' | 'click' | 'scrollIntoView' | 'typeText' | 'element' | 'waitForReady' | 'waitForConnected' | 'sendMessage' | 'getMessages' | 'addDemoMessage' | 'clearMessages'>;
+//# sourceMappingURL=debug-api-core.d.ts.map

package/dist/debug-api-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-api-core.d.ts","sourceRoot":"","sources":["../src/debug-api-core.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAU3D;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAChC,gBAAgB,EACd,UAAU,GAAG,WAAW,GAAG,UAAU,GACrC,SAAS,GAAG,QAAQ,GACpB,cAAc,GACd,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GACrD,MAAM,GAAG,WAAW,GACpB,OAAO,GAAG,gBAAgB,GAAG,UAAU,GACvC,SAAS,GAAG,cAAc,GAAG,kBAAkB,GAC/C,aAAa,GAAG,aAAa,GAAG,gBAAgB,GAAG,eAAe,CACvE,CAoaA"}

package/dist/debug-api-ext.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Debug API — extended implementation.
+ *
+ * Builds the extended debug API methods: session management, tool call
+ * simulation, toast notifications, settings, activity control, performance
+ * metrics, and network simulation.
+ */
+import type { RtcAgentDebugAPI } from './debug-api-types.js';
+/**
+ * Build extended debug API methods.
+ *
+ * Returns a partial implementation covering session management, tool calls,
+ * toast, settings, activity, metrics, and network simulation.
+ */
+export declare function buildExtAPI(): Pick<RtcAgentDebugAPI, 'createSession' | 'switchSession' | 'deleteSession' | 'renameSession' | 'getSessions' | 'getCurrentSessionId' | 'getToolCalls' | 'addPendingToolCall' | 'approveToolCall' | 'denyToolCall' | 'approveAllToolCalls' | 'showToast' | 'getToasts' | 'getSettings' | 'updateSettings' | 'setActivity' | 'getActivity' | 'getMetrics' | 'simulateOffline' | 'restoreNetwork' | 'isOffline'>;
+//# sourceMappingURL=debug-api-ext.d.ts.map

package/dist/debug-api-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-api-ext.d.ts","sourceRoot":"","sources":["../src/debug-api-ext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AA0C3D;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAC/B,gBAAgB,EACd,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,GACrE,aAAa,GAAG,qBAAqB,GACrC,cAAc,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,cAAc,GAAG,qBAAqB,GAClG,WAAW,GAAG,WAAW,GACzB,aAAa,GAAG,gBAAgB,GAChC,aAAa,GAAG,aAAa,GAC7B,YAAY,GACZ,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,CACvD,CA6bA"}

package/dist/debug-api-helpers.d.ts

@@ -0,0 +1,28 @@
+import type { RtcAgent } from './components/rtc-agent/rtc-agent.js';
+export declare const log: import("@rtc-agent/client").Logger;
+/**
+ * Ensure the database singleton is initialized before VirtualFS operations.
+ *
+ * VirtualFS methods call `getDatabase()` without a name, which fails if no
+ * database has been opened yet. This helper lazily opens a debug-specific
+ * database so that VirtualFS operations work even when persistence is not
+ * connected (e.g., standalone debug pages without a server).
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureDatabase(): void;
+/** Maximum number of log entries retained in the ring buffer. */
+export declare const LOG_BUFFER_MAX = 500;
+/** Ring buffer that captures recent log entries for replay in tests. */
+export declare const logBuffer: string[];
+export declare function installLogCapture(): void;
+/**
+ * Query a CSS selector that may cross shadow DOM boundaries.
+ *
+ * Supports `>>>` as a shadow-piercing combinator.
+ * Example: `'rtc-agent >>> rtc-chat-layout >>> rtc-input-area'`
+ */
+export declare function deepQuerySelector(root: Node, selector: string): Element | null;
+/** Get the <rtc-agent> element from the page. */
+export declare function getAgentElement(): RtcAgent | null;
+//# sourceMappingURL=debug-api-helpers.d.ts.map

package/dist/debug-api-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-api-helpers.d.ts","sourceRoot":"","sources":["../src/debug-api-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qCAAqC,CAAC;AAElE,eAAO,MAAM,GAAG,oCAA2B,CAAC;AAK5C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAOrC;AAID,iEAAiE;AACjE,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,wEAAwE;AACxE,eAAO,MAAM,SAAS,EAAE,MAAM,EAAO,CAAC;AAyBtC,wBAAgB,iBAAiB,IAAI,IAAI,CAexC;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA6B9E;AAID,iDAAiD;AACjD,wBAAgB,eAAe,IAAI,QAAQ,GAAG,IAAI,CAEjD"}