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

package/dist/types/activity-bar-config.d.ts

@@ -1,38 +1,38 @@
 /**
  * Activity Bar Configuration Types
  *
- * 用于 <rtc-agent> 组件的 Activity Bar 配置 API。
- * 控制 Activity Bar 中各活动按钮的显隐。
+ * Used for Activity Bar configuration API of the <rtc-agent> component.
+ * Controls the visibility of activity buttons in the Activity Bar.
  */
 /**
- * Activity 类型
+ * Activity type
  */
-export type Activity = 'files' | 'chat' | 'settings';
+export type Activity = 'files' | 'chat' | 'settings' | 'functions';
 /**
- * Activity Bar 配置
+ * Activity Bar configuration
  *
- * 通过 <rtc-agent>.activityBarConfig 属性设置。
- * 注意：chat 按钮始终显示，不可隐藏。
+ * Set via the <rtc-agent>.activityBarConfig property.
+ * Note: the chat button is always visible and cannot be hidden.
  */
 export interface ActivityBarConfig {
-    /** 禁用的活动列表（chat 不可禁用） */
-    disabledActivities?: Array<'files' | 'settings'>;
-    /** 默认活动 */
+    /** Disabled activities list (chat cannot be disabled) */
+    disabledActivities?: Array<'files' | 'settings' | 'functions'>;
+    /** Default activity */
     defaultActivity?: Activity;
 }
 /**
- * 解析后的 Activity Bar 配置（所有字段都有默认值）
+ * Resolved Activity Bar configuration (all fields have defaults)
  */
 export interface ResolvedActivityBarConfig {
-    disabledActivities: Array<'files' | 'settings'>;
+    disabledActivities: Array<'files' | 'settings' | 'functions'>;
     defaultActivity: Activity;
 }
 /**
- * 默认 Activity Bar 配置
+ * Default Activity Bar configuration
  */
 export declare const DEFAULT_ACTIVITY_BAR_CONFIG: ResolvedActivityBarConfig;
 /**
- * 解析 Activity Bar 配置（合并默认值）
+ * Resolve Activity Bar configuration (merge with defaults)
  */
 export declare function resolveActivityBarConfig(config?: ActivityBarConfig): ResolvedActivityBarConfig;
 //# sourceMappingURL=activity-bar-config.d.ts.map

package/dist/types/activity-bar-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-bar-config.d.ts","sourceRoot":"","sources":["../../src/types/activity-bar-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;IACjD,WAAW;IACX,eAAe,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,kBAAkB,EAAE,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;IAChD,eAAe,EAAE,QAAQ,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAGzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,CAO9F"}
+{"version":3,"file":"activity-bar-config.d.ts","sourceRoot":"","sources":["../../src/types/activity-bar-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;IAC/D,uBAAuB;IACvB,eAAe,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,kBAAkB,EAAE,KAAK,CAAC,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;IAC9D,eAAe,EAAE,QAAQ,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAGzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,CAO9F"}

package/dist/types/agent-config.d.ts

@@ -1,9 +1,9 @@
 /**
  * Agent Declarative Configuration
  *
- * 用于 <rtc-agent> 组件的声明式配置 API。
- * 宿主应用通过设置 `element.agentConfig = {...}` 完成所有配置，
- * 无需了解内部的 FunctionRegistry / FunctionGroup / toolRegistry 等概念。
+ * Declarative configuration API for the <rtc-agent> component.
+ * The host application completes all configuration by setting `element.agentConfig = {...}`,
+ * without needing to understand internal concepts like FunctionRegistry / FunctionGroup / toolRegistry.
  *
  * @example
  * ```ts
@@ -23,39 +23,39 @@
  */
 import type { FunctionDef } from './skill.js';
 /**
- * Agent 声明式配置
+ * Agent declarative configuration
  *
- * 通过 <rtc-agent>.agentConfig 属性设置。
- * 组件内部会基于此配置构建 FunctionRegistry 并桥接到 toolRegistry。
+ * Set via the <rtc-agent>.agentConfig property.
+ * Internally, the component builds a FunctionRegistry from this config and bridges it to the toolRegistry.
  */
 export interface AgentConfig {
-    /** Agent 名称（用于 system prompt 等场景）。缺省使用 appLabel */
+    /** Agent name (used for system prompt, etc.). Falls back to appLabel if omitted */
     name?: string;
-    /** Agent 描述 */
+    /** Agent description */
     description?: string;
-    /** AI 人设（system prompt） */
+    /** AI persona (system prompt) */
     persona?: string;
     /**
-     * 平铺的函数列表（自动放入名为 'default' 的 group）
+     * Flat function list (automatically placed into a group named 'default')
      *
-     * 简单场景可直接使用 functions；复杂场景使用 groups 分组。
-     * 两者可同时使用：groups 在前，functions 在后注册。
+     * For simple scenarios, use `functions` directly; for complex scenarios, use `groups` to organize.
+     * Both can be used together: `groups` is registered first, then `functions`.
      */
     functions?: FunctionDef[];
-    /** 分组的函数列表 */
+    /** Grouped function list */
     groups?: AgentFunctionGroup[];
-    /** 异步操作错误回调（如文档生成失败） */
+    /** Async operation error callback (e.g. document generation failure) */
     onError?: (error: Error, context: string) => void;
 }
 /**
- * Agent 函数分组
+ * Agent function group
  */
 export interface AgentFunctionGroup {
-    /** 分组名称（如 'editor'、'file'） */
+    /** Group name (e.g. 'editor', 'file') */
     name: string;
-    /** 分组描述 */
+    /** Group description */
     description?: string;
-    /** 该分组下的函数列表 */
+    /** Function list under this group */
     functions: FunctionDef[];
 }
 //# sourceMappingURL=agent-config.d.ts.map

package/dist/types/agent-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../src/types/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,cAAc;IACd,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../src/types/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B"}

package/dist/types/events.d.ts

@@ -1,56 +1,112 @@
 /**
  * RtcAgent Event Type Map
  *
- * 通过全局扩展 HTMLElementEventMap 让 addEventListener 对 <rtc-agent>
- * 派发的自定义事件提供类型安全。
+ * Extends HTMLElementEventMap globally to provide type-safe addEventListener
+ * for custom events dispatched by <rtc-agent>.
  *
- * 设计要点：
- * - 扩展而非重载：保留 HTMLElement 原生事件 + 内部事件（rtc-window-minimize 等）
- *   的类型推导，同时加入 rtc-agent-ready 等公开事件
- * - 新增公开事件只需在 RtcAgentEventMap 里添加一项即可
+ * Design points:
+ * - Extend, don't override: preserve type inference for native HTMLElement events
+ *   and internal events (e.g. rtc-window-minimize), while adding public events
+ *   like rtc-agent-ready.
+ * - To add a new public event, simply add an entry to RtcAgentEventMap.
  *
  * @example
  * ```ts
  * const agent = document.querySelector<RtcAgent>('#agent')!;
  * agent.addEventListener('rtc-agent-ready', (e) => {
- *   e.detail;  // void — 类型安全
+ *   e.detail;  // void -- type-safe
  * });
  * agent.addEventListener('click', (e) => {
- *   e.clientX;  // number — 原生事件仍然类型安全
+ *   e.clientX;  // number -- native events remain type-safe
  * });
- * agent.addEventListener('typo-event', ...);  // ✗ TS 报错
+ * agent.addEventListener('typo-event', ...);  // ✗ TS error
  * ```
  */
+import type { ConnectionState } from '@rtc-agent/client';
+import type { Session, Message } from './index.js';
 /**
- * 公开的自定义事件（供外部宿主应用监听）
+ * Public custom events (for external host application listeners)
  *
- * detail 类型说明：
- * - `void`：事件无 payload
- * - `T`：事件 payload 类型为 T
+ * Detail type explanation:
+ * - `void`: event has no payload
+ * - `T`: event payload type is T
  */
 export interface RtcAgentEventDetailMap {
-    /** 组件首次渲染完成，可以安全地设置 agentConfig / registry */
+    /** Component first render complete; safe to set agentConfig / registry */
     'rtc-agent-ready': void;
-    /** 主题变化（属性变更或 system 跟随系统偏好变化时触发） */
+    /** Component is about to be removed from DOM (fires before disconnectedCallback cleanup) */
+    'rtc-before-destroy': void;
+    /** Theme changed (triggered by attribute change or 'system' following system preference) */
     'rtc-theme-change': {
         theme: 'light' | 'dark' | 'system';
     };
-    /** 组件即将从 DOM 移除（在 disconnectedCallback 清理逻辑之前触发） */
-    'rtc-before-destroy': void;
-    /** 消息发送前拦截（可通过 preventDefault() 取消发送，或修改 detail.message.content） */
+    /** Intercept before message send (cancel via preventDefault(), or modify detail.message.content) */
     'rtc-before-message-send': {
         message: {
             content: string;
             metadata?: Record<string, unknown>;
         };
     };
+    /** User clicks the retry button */
+    'rtc-connection-retry': void;
+    /** Connection state transitions (disconnected → connecting → connected, etc.) */
+    'rtc-connection-state-change': {
+        state: ConnectionState;
+    };
+    /** User requests login (login dialog submitted) */
+    'rtc-auth-login-requested': void;
+    /** Login successful (covers initial load, token refresh, manual login, external token set) */
+    'rtc-auth-login': {
+        userId: string;
+    };
+    /** Auth token refresh failed */
+    'rtc-auth-refresh-failed': void;
+    /** User logs out */
+    'rtc-auth-logout': void;
+    /** New session created */
+    'rtc-session-created': {
+        session: Session;
+    };
+    /** Session switched */
+    'rtc-session-switched': {
+        id: string;
+    };
+    /** Session renamed */
+    'rtc-session-renamed': {
+        id: string;
+        title: string;
+    };
+    /** Session deleted */
+    'rtc-session-deleted': {
+        id: string;
+    };
+    /** AI message received */
+    'rtc-message-received': {
+        message: Message;
+    };
+    /** User message sent */
+    'rtc-message-sent': {
+        message: Message;
+    };
 }
 declare global {
     interface HTMLElementEventMap {
         'rtc-agent-ready': CustomEvent<RtcAgentEventDetailMap['rtc-agent-ready']>;
-        'rtc-theme-change': CustomEvent<RtcAgentEventDetailMap['rtc-theme-change']>;
         'rtc-before-destroy': CustomEvent<RtcAgentEventDetailMap['rtc-before-destroy']>;
+        'rtc-theme-change': CustomEvent<RtcAgentEventDetailMap['rtc-theme-change']>;
         'rtc-before-message-send': CustomEvent<RtcAgentEventDetailMap['rtc-before-message-send']>;
+        'rtc-connection-retry': CustomEvent<RtcAgentEventDetailMap['rtc-connection-retry']>;
+        'rtc-connection-state-change': CustomEvent<RtcAgentEventDetailMap['rtc-connection-state-change']>;
+        'rtc-auth-login-requested': CustomEvent<RtcAgentEventDetailMap['rtc-auth-login-requested']>;
+        'rtc-auth-login': CustomEvent<RtcAgentEventDetailMap['rtc-auth-login']>;
+        'rtc-auth-refresh-failed': CustomEvent<RtcAgentEventDetailMap['rtc-auth-refresh-failed']>;
+        'rtc-auth-logout': CustomEvent<RtcAgentEventDetailMap['rtc-auth-logout']>;
+        'rtc-session-created': CustomEvent<RtcAgentEventDetailMap['rtc-session-created']>;
+        'rtc-session-switched': CustomEvent<RtcAgentEventDetailMap['rtc-session-switched']>;
+        'rtc-session-renamed': CustomEvent<RtcAgentEventDetailMap['rtc-session-renamed']>;
+        'rtc-session-deleted': CustomEvent<RtcAgentEventDetailMap['rtc-session-deleted']>;
+        'rtc-message-received': CustomEvent<RtcAgentEventDetailMap['rtc-message-received']>;
+        'rtc-message-sent': CustomEvent<RtcAgentEventDetailMap['rtc-message-sent']>;
     }
 }
 //# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,iBAAiB,EAAE,IAAI,CAAC;IACxB,qCAAqC;IACrC,kBAAkB,EAAE;QAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC3D,oDAAoD;IACpD,oBAAoB,EAAE,IAAI,CAAC;IAC3B,oEAAoE;IACpE,yBAAyB,EAAE;QAAE,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CACjG;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,mBAAmB;QAC3B,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC1E,kBAAkB,EAAE,WAAW,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC5E,oBAAoB,EAAE,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAChF,yBAAyB,EAAE,WAAW,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,CAAC,CAAC;KAC3F;CACF"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IAGrC,0EAA0E;IAC1E,iBAAiB,EAAE,IAAI,CAAC;IACxB,4FAA4F;IAC5F,oBAAoB,EAAE,IAAI,CAAC;IAC3B,4FAA4F;IAC5F,kBAAkB,EAAE;QAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAC;IAI3D,oGAAoG;IACpG,yBAAyB,EAAE;QAAE,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAIhG,mCAAmC;IACnC,sBAAsB,EAAE,IAAI,CAAC;IAC7B,iFAAiF;IACjF,6BAA6B,EAAE;QAAE,KAAK,EAAE,eAAe,CAAA;KAAE,CAAC;IAC1D,mDAAmD;IACnD,0BAA0B,EAAE,IAAI,CAAC;IACjC,8FAA8F;IAC9F,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,gCAAgC;IAChC,yBAAyB,EAAE,IAAI,CAAC;IAChC,oBAAoB;IACpB,iBAAiB,EAAE,IAAI,CAAC;IAIxB,0BAA0B;IAC1B,qBAAqB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C,uBAAuB;IACvB,sBAAsB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,sBAAsB;IACtB,qBAAqB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,sBAAsB;IACtB,qBAAqB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAItC,0BAA0B;IAC1B,sBAAsB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,wBAAwB;IACxB,kBAAkB,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,mBAAmB;QAE3B,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC1E,oBAAoB,EAAE,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAChF,kBAAkB,EAAE,WAAW,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAG5E,yBAAyB,EAAE,WAAW,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAG1F,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACpF,6BAA6B,EAAE,WAAW,CAAC,sBAAsB,CAAC,6BAA6B,CAAC,CAAC,CAAC;QAClG,0BAA0B,EAAE,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,CAAC,CAAC,CAAC;QAC5F,gBAAgB,EAAE,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACxE,yBAAyB,EAAE,WAAW,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC1F,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAG1E,qBAAqB,EAAE,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAClF,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACpF,qBAAqB,EAAE,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAClF,qBAAqB,EAAE,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAGlF,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACpF,kBAAkB,EAAE,WAAW,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAAC;KAC7E;CACF"}

package/dist/types/factory.d.ts

@@ -117,6 +117,14 @@ export interface AuthProvider {
     isLoggedIn(): boolean;
     /** Optional logout handler. If provided, component logout delegates to host */
     logout?(): Promise<void>;
+    /**
+     * Returns the current user's unique identifier.
+     *
+     * Used to construct per-user IndexedDB names (e.g. `{databaseName}-{userId}`).
+     * If not provided, falls back to `'provider-managed'` — all users will share
+     * the same database, which is usually NOT what you want in production.
+     */
+    getUserId?(): string;
 }
 /**
  * Event callbacks for the RTC Agent.
@@ -252,11 +260,11 @@ export interface EventCallbacks {
      * Tool call started (bridged from EventBus `function:start`).
      *
      * Fires when a tool function begins execution. The `path` field contains
-     * the function path (e.g. `"myGroup/myFunction"`), and `params` contains
+     * the function path (e.g. `"myGroup.myFunction"`), and `params` contains
      * the validated arguments passed to the handler.
      */
     toolCallStart?: (detail: {
-        /** Function path, e.g. "groupName/functionName" */
+        /** Function path, e.g. "groupName.functionName" */
         path: string;
         /** Validated arguments passed to the handler */
         params: Record<string, unknown>;
@@ -267,7 +275,7 @@ export interface EventCallbacks {
      * Fires after the tool handler returns a value successfully.
      */
     toolCallSuccess?: (detail: {
-        /** Function path, e.g. "groupName/functionName" */
+        /** Function path, e.g. "groupName.functionName" */
         path: string;
         /** Return value of the handler */
         result: unknown;
@@ -278,7 +286,7 @@ export interface EventCallbacks {
      * Fires when the tool handler throws an error.
      */
     toolCallError?: (detail: {
-        /** Function path, e.g. "groupName/functionName" */
+        /** Function path, e.g. "groupName.functionName" */
         path: string;
         /** Error thrown by the handler */
         error: Error;
@@ -289,7 +297,7 @@ export interface EventCallbacks {
      * Fires when the tool handler reports progress via the `onProgress` callback.
      */
     toolCallProgress?: (detail: {
-        /** Function path, e.g. "groupName/functionName" */
+        /** Function path, e.g. "groupName.functionName" */
         path: string;
         /** Progress value reported by the handler (typically 0–100) */
         progress: number;

package/dist/types/factory.d.ts.map

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

package/dist/types/functions-debug.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Function Debugger Types
+ *
+ * Type definitions for the Function Debugger feature.
+ * DebugHistoryItem and LogEntry are now re-exported from @rtc-agent/persistence.
+ */
+import type { FunctionDef } from './skill.js';
+import type { DebugHistoryItem, LogEntry, LogLevel } from '@rtc-agent/persistence';
+export type { DebugHistoryItem, LogEntry, LogLevel };
+/**
+ * Execution status of a function call
+ */
+export type ExecutionStatus = 'idle' | 'running' | 'success' | 'error';
+/**
+ * Pagination state for history
+ */
+export interface HistoryPaginationState {
+    /** Items in current page */
+    items: DebugHistoryItem[];
+    /** Current page number (1-based) */
+    page: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Total record count */
+    total: number;
+    /** Filter by function name (optional) */
+    filterFunctionName?: string;
+    /** Error message if loading failed */
+    error?: string;
+}
+/**
+ * Function debug state
+ */
+export interface FunctionDebugState {
+    /** Currently selected function definition */
+    selectedFunction: FunctionDef | null;
+    /** Current parameter JSON string */
+    currentParams: string;
+    /** Console log entries */
+    logs: LogEntry[];
+    /** Debug history (current page data, most recent first) */
+    history: DebugHistoryItem[];
+    /** History pagination state */
+    historyPagination: HistoryPaginationState;
+    /** Current execution status */
+    executionStatus: ExecutionStatus;
+}
+//# sourceMappingURL=functions-debug.d.ts.map

package/dist/types/functions-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-debug.d.ts","sourceRoot":"","sources":["../../src/types/functions-debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGnF,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,+BAA+B;IAC/B,eAAe,EAAE,eAAe,CAAC;CAClC"}