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

package/dist/storage.d.ts

@@ -0,0 +1,11 @@
+export interface Task {
+    id: string;
+    title: string;
+    completed: boolean;
+    priority: 'low' | 'medium' | 'high';
+    dueDate: string | null;
+    createdAt: string;
+}
+export declare function loadTasks(): Promise<Task[]>;
+export declare function saveTasks(tasks: Task[]): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,IAAI;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAQjD;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5D"}

package/dist/styles/base.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Base Styles — CSS reset, font defaults, and motion preferences.
+ *
+ * Included once in the root <rtc-agent> component's styles array.
+ * All child components inherit these via Shadow DOM.
+ */
+export declare const baseStyles: import("lit").CSSResult;
+//# sourceMappingURL=base.d.ts.map

package/dist/styles/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/styles/base.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,yBA+BtB,CAAC"}

package/dist/styles/index.d.ts

@@ -0,0 +1,5 @@
+export { tokens } from './tokens.js';
+export { lightTheme } from './themes/light.js';
+export { darkTheme } from './themes/dark.js';
+export { baseStyles } from './base.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/styles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAC,UAAU,EAAC,MAAM,WAAW,CAAC"}

package/dist/styles/themes/dark.d.ts

@@ -0,0 +1,2 @@
+export declare const darkTheme: import("lit").CSSResult;
+//# sourceMappingURL=dark.d.ts.map

package/dist/styles/themes/dark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark.d.ts","sourceRoot":"","sources":["../../../src/styles/themes/dark.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,SAAS,yBA8CrB,CAAC"}

package/dist/styles/themes/light.d.ts

@@ -0,0 +1,2 @@
+export declare const lightTheme: import("lit").CSSResult;
+//# sourceMappingURL=light.d.ts.map

package/dist/styles/themes/light.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light.d.ts","sourceRoot":"","sources":["../../../src/styles/themes/light.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,UAAU,yBA8CtB,CAAC"}

package/dist/styles/tokens.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Design Tokens — CSS Custom Properties for the RTC Agent component library.
+ *
+ * IMPORTANT: This file defines ONLY structural tokens (spacing, typography,
+ * borders, shadows, transitions, z-index, window dimensions). Color tokens
+ * are defined exclusively in theme files (themes/light.ts, themes/dark.ts)
+ * to ensure a single source of truth for colors.
+ *
+ * Variable taxonomy:
+ * - --rtc-spacing-*      : spacing scale (xs:4 sm:8 md:16 lg:24 xl:32 2xl:48)
+ * - --rtc-font-*         : font family, size, weight, line-height
+ * - --rtc-border-*       : border width, radius
+ * - --rtc-shadow-*       : box shadows (sm, md, lg, xl)
+ * - --rtc-transition-*   : animation duration, timing
+ * - --rtc-z-*            : z-index layers (content:1, overlay:500, title-bar:1000)
+ * - --rtc-window-*       : floating window dimensions
+ * - --rtc-content-height-* : max-height for scrollable content areas (xs:60 sm:100 md:160 lg:240 xl:360)
+ *
+ * Colors: See themes/light.ts and themes/dark.ts for --rtc-color-* definitions.
+ */
+export declare const tokens: import("lit").CSSResult;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/styles/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/styles/tokens.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,yBAuHlB,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Activity Bar Configuration Types
+ *
+ * 用于 <rtc-agent> 组件的 Activity Bar 配置 API。
+ * 控制 Activity Bar 中各活动按钮的显隐。
+ */
+/**
+ * Activity 类型
+ */
+export type Activity = 'files' | 'chat' | 'settings';
+/**
+ * Activity Bar 配置
+ *
+ * 通过 <rtc-agent>.activityBarConfig 属性设置。
+ * 注意：chat 按钮始终显示，不可隐藏。
+ */
+export interface ActivityBarConfig {
+    /** 禁用的活动列表（chat 不可禁用） */
+    disabledActivities?: Array<'files' | 'settings'>;
+    /** 默认活动 */
+    defaultActivity?: Activity;
+}
+/**
+ * 解析后的 Activity Bar 配置（所有字段都有默认值）
+ */
+export interface ResolvedActivityBarConfig {
+    disabledActivities: Array<'files' | 'settings'>;
+    defaultActivity: Activity;
+}
+/**
+ * 默认 Activity Bar 配置
+ */
+export declare const DEFAULT_ACTIVITY_BAR_CONFIG: ResolvedActivityBarConfig;
+/**
+ * 解析 Activity Bar 配置（合并默认值）
+ */
+export declare function resolveActivityBarConfig(config?: ActivityBarConfig): ResolvedActivityBarConfig;
+//# sourceMappingURL=activity-bar-config.d.ts.map

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * Agent Declarative Configuration
+ *
+ * 用于 <rtc-agent> 组件的声明式配置 API。
+ * 宿主应用通过设置 `element.agentConfig = {...}` 完成所有配置，
+ * 无需了解内部的 FunctionRegistry / FunctionGroup / toolRegistry 等概念。
+ *
+ * @example
+ * ```ts
+ * const agent = document.querySelector<RtcAgent>('#agent')!;
+ * agent.agentConfig = {
+ *   name: 'MermaidEditor',
+ *   persona: 'You are a helpful Mermaid diagram assistant...',
+ *   groups: [{
+ *     name: 'editor',
+ *     description: 'Editor operations',
+ *     functions: [
+ *       { name: 'getCode', description: 'Get current code', handler: () => editorAPI.getCode() },
+ *     ],
+ *   }],
+ * };
+ * ```
+ */
+import type { FunctionDef } from './skill.js';
+/**
+ * Agent 声明式配置
+ *
+ * 通过 <rtc-agent>.agentConfig 属性设置。
+ * 组件内部会基于此配置构建 FunctionRegistry 并桥接到 toolRegistry。
+ */
+export interface AgentConfig {
+    /** Agent 名称（用于 system prompt 等场景）。缺省使用 appLabel */
+    name?: string;
+    /** Agent 描述 */
+    description?: string;
+    /** AI 人设（system prompt） */
+    persona?: string;
+    /**
+     * 平铺的函数列表（自动放入名为 'default' 的 group）
+     *
+     * 简单场景可直接使用 functions；复杂场景使用 groups 分组。
+     * 两者可同时使用：groups 在前，functions 在后注册。
+     */
+    functions?: FunctionDef[];
+    /** 分组的函数列表 */
+    groups?: AgentFunctionGroup[];
+    /** 异步操作错误回调（如文档生成失败） */
+    onError?: (error: Error, context: string) => void;
+}
+/**
+ * Agent 函数分组
+ */
+export interface AgentFunctionGroup {
+    /** 分组名称（如 'editor'、'file'） */
+    name: string;
+    /** 分组描述 */
+    description?: string;
+    /** 该分组下的函数列表 */
+    functions: FunctionDef[];
+}
+//# sourceMappingURL=agent-config.d.ts.map

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

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

package/dist/types/events.d.ts

@@ -0,0 +1,56 @@
+/**
+ * RtcAgent Event Type Map
+ *
+ * 通过全局扩展 HTMLElementEventMap 让 addEventListener 对 <rtc-agent>
+ * 派发的自定义事件提供类型安全。
+ *
+ * 设计要点：
+ * - 扩展而非重载：保留 HTMLElement 原生事件 + 内部事件（rtc-window-minimize 等）
+ *   的类型推导，同时加入 rtc-agent-ready 等公开事件
+ * - 新增公开事件只需在 RtcAgentEventMap 里添加一项即可
+ *
+ * @example
+ * ```ts
+ * const agent = document.querySelector<RtcAgent>('#agent')!;
+ * agent.addEventListener('rtc-agent-ready', (e) => {
+ *   e.detail;  // void — 类型安全
+ * });
+ * agent.addEventListener('click', (e) => {
+ *   e.clientX;  // number — 原生事件仍然类型安全
+ * });
+ * agent.addEventListener('typo-event', ...);  // ✗ TS 报错
+ * ```
+ */
+/**
+ * 公开的自定义事件（供外部宿主应用监听）
+ *
+ * detail 类型说明：
+ * - `void`：事件无 payload
+ * - `T`：事件 payload 类型为 T
+ */
+export interface RtcAgentEventDetailMap {
+    /** 组件首次渲染完成，可以安全地设置 agentConfig / registry */
+    'rtc-agent-ready': void;
+    /** 主题变化（属性变更或 system 跟随系统偏好变化时触发） */
+    'rtc-theme-change': {
+        theme: 'light' | 'dark' | 'system';
+    };
+    /** 组件即将从 DOM 移除（在 disconnectedCallback 清理逻辑之前触发） */
+    'rtc-before-destroy': void;
+    /** 消息发送前拦截（可通过 preventDefault() 取消发送，或修改 detail.message.content） */
+    'rtc-before-message-send': {
+        message: {
+            content: string;
+            metadata?: Record<string, unknown>;
+        };
+    };
+}
+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-before-message-send': CustomEvent<RtcAgentEventDetailMap['rtc-before-message-send']>;
+    }
+}
+//# sourceMappingURL=events.d.ts.map

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

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