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

package/dist/controllers/settings.controller.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Settings Controller
+ *
+ * Encapsulates global settings state with localStorage persistence.
+ * Handles DOM side effects (theme, fontSize) and multi-tab synchronization.
+ * Follows the same pattern as ModeController.
+ *
+ * Corresponds to: `SettingsContext` (defined in `contexts/settings.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-settings-layout>`, 各功能组件
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { SettingsActions, SettingsContextValue } from '../contexts/settings.js';
+export declare class SettingsController implements ReactiveController {
+    host: ReactiveControllerHost & HTMLElement;
+    private _state;
+    readonly actions: SettingsActions;
+    private _storageListener?;
+    private _themeMediaQuery?;
+    private _themeMediaListener?;
+    get value(): SettingsContextValue;
+    constructor(host: ReactiveControllerHost & HTMLElement);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Remove all global event listeners (safe to call even if nothing was added). */
+    private _removeGlobalListeners;
+    /** Restore settings from localStorage with validation */
+    private _restore;
+    private _update;
+    private _reset;
+    /** Persist settings to localStorage */
+    private _persist;
+    /** Apply DOM side effects only for changed properties */
+    private _applyDiff;
+    /** Apply theme to rtc-agent element's theme attribute */
+    private _applyTheme;
+    /** Apply font size as CSS variable on document root */
+    private _applyFontSize;
+    /** Handle multi-tab synchronization via storage event */
+    private _handleStorageChange;
+    /** Validate theme value */
+    private _validateTheme;
+    /** Validate and clamp font size */
+    private _validateFontSize;
+}
+//# sourceMappingURL=settings.controller.d.ts.map

package/dist/controllers/settings.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/settings.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAER,eAAe,EACf,oBAAoB,EACvB,MAAM,yBAAyB,CAAC;AAOjC,qBAAa,kBAAmB,YAAW,kBAAkB;IACzD,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAE3C,OAAO,CAAC,MAAM,CAA8C;IAE5D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAa;IAEzC,IAAI,KAAK,IAAI,oBAAoB,CAEhC;gBAEW,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAetD,aAAa;IA6Bb,gBAAgB;IAMhB,kFAAkF;IAClF,OAAO,CAAC,sBAAsB;IAW9B,yDAAyD;IACzD,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,MAAM;IAQd,uCAAuC;IACvC,OAAO,CAAC,QAAQ;IAShB,yDAAyD;IACzD,OAAO,CAAC,UAAU;IAWlB,yDAAyD;IACzD,OAAO,CAAC,WAAW;IAgBnB,uDAAuD;IACvD,OAAO,CAAC,cAAc;IAStB,yDAAyD;IACzD,OAAO,CAAC,oBAAoB;IAO5B,2BAA2B;IAC3B,OAAO,CAAC,cAAc;IAOtB,mCAAmC;IACnC,OAAO,CAAC,iBAAiB;CAI5B"}

package/dist/controllers/skill.controller.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Skill Controller
+ *
+ * 轻量级 ReactiveController，管理 Skill 系统与组件的集成
+ *
+ * 职责：
+ * - 持有 FunctionRegistry 实例引用
+ * - 订阅 eventBus 事件，驱动 UI 更新（toast、confirm）
+ * - 暴露 actions 给宿主应用
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { FunctionRegistry } from '../core/function-registry.js';
+import type { SkillContextValue } from '../contexts/skill.js';
+/**
+ * SkillController actions
+ */
+export interface SkillActions {
+    /** 获取 FunctionRegistry 实例 */
+    getRegistry(): FunctionRegistry | null;
+    /** 设置 FunctionRegistry 实例（宿主应用调用） */
+    setRegistry(registry: FunctionRegistry): void;
+}
+/**
+ * SkillController 配置
+ */
+export interface SkillControllerConfig {
+    /** Toast 回调（由组件注入） */
+    onToast?: (message: string, type: 'info' | 'success' | 'error') => void;
+    /** 确认请求回调（由组件注入） */
+    onConfirmRequest?: (requestId: string, path: string, message: string) => void;
+}
+/**
+ * SkillController
+ *
+ * 管理 Skill 系统与组件的集成
+ */
+export declare class SkillController implements ReactiveController {
+    private _host;
+    private _registry;
+    private _config;
+    /** 事件取消订阅函数 */
+    private _unsubscribes;
+    constructor(host: ReactiveControllerHost, config?: SkillControllerConfig);
+    /**
+     * 当前状态（供 Context 使用）
+     */
+    get value(): SkillContextValue;
+    /**
+     * Actions（供宿主应用调用）
+     */
+    get actions(): SkillActions;
+    /**
+     * 创建 rtcAgentAPI Proxy 并注入 ToolRegistry
+     *
+     * 此方法将 FunctionRegistry 与 ToolRegistry 桥接：
+     * - callFunction/readFile/writeFile/listDir 映射到 registry.execute 和 virtualFS
+     * - Proxy 的 get trap 转发到 registry 的 group proxy，支持链式调用（rtcAgent.task.create()）
+     */
+    private _bridgeToolRegistry;
+    /**
+     * 设置配置（用于延迟注入回调）
+     */
+    setConfig(config: SkillControllerConfig): void;
+    /**
+     * ReactiveController: host connected
+     */
+    hostConnected(): void;
+    /**
+     * ReactiveController: host disconnected
+     */
+    hostDisconnected(): void;
+    /**
+     * 订阅 eventBus 事件
+     */
+    private _subscribeEvents;
+    /**
+     * 响应确认请求（由组件调用）
+     */
+    respondToConfirm(requestId: string, confirmed: boolean): void;
+}
+//# sourceMappingURL=skill.controller.d.ts.map

package/dist/controllers/skill.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/skill.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,WAAW,IAAI,gBAAgB,GAAG,IAAI,CAAC;IACvC,qCAAqC;IACrC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;IACxE,oBAAoB;IACpB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/E;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,OAAO,CAA6B;IAE5C,eAAe;IACf,OAAO,CAAC,aAAa,CAAyB;gBAElC,IAAI,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,qBAAqB;IAMxE;;OAEG;IACH,IAAI,KAAK,IAAI,iBAAiB,CAI7B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,YAAY,CAY1B;IAED;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAI9C;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAQxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;CAG9D"}

package/dist/controllers/status-bar.controller.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Status Bar Controller
+ *
+ * 从 EditorAreaController 派生状态栏信息。
+ * 只读：不修改编辑器状态，只计算显示数据。
+ *
+ * 设计要点：
+ * - 依赖 EditorAreaController 获取当前活动 tab
+ * - 从文件路径推断文件类型
+ * - 从 isDirty 推断保存状态
+ * - 光标位置直接透传
+ *
+ * Debug HTML 可直接使用此 Controller 驱动状态栏组件。
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { StatusBarInfo } from '../types/index.js';
+import type { EditorAreaController } from './editor-area.controller.js';
+export declare class StatusBarController implements ReactiveController {
+    private _host;
+    private _editorController;
+    constructor(host: ReactiveControllerHost, editorController: EditorAreaController);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * 计算当前状态栏信息
+     *
+     * 从 EditorAreaController 的 activeTab 派生。
+     * 无活动 tab 时返回空状态（saveStatus='none'）。
+     */
+    get info(): StatusBarInfo;
+}
+//# sourceMappingURL=status-bar.controller.d.ts.map

package/dist/controllers/status-bar.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-bar.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/status-bar.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AA2BtE,qBAAa,mBAAoB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,iBAAiB,CAAuB;gBAEpC,IAAI,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB;IAMhF,aAAa;IAEb,gBAAgB;IAEhB;;;;;OAKG;IACH,IAAI,IAAI,IAAI,aAAa,CAkBxB;CACJ"}

package/dist/controllers/toast.controller.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Toast Controller
+ *
+ * Manages toast notifications: show, auto-dismiss, manual remove.
+ * Extracted from <rtc-agent> root component to keep it under 300 lines.
+ *
+ * No context — toast state is consumed only by <rtc-toast> via root render.
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ToastItem, ToastType, ToastAction } from '../components/overlay/rtc-toast.js';
+export type { ToastItem, ToastType, ToastAction } from '../components/overlay/rtc-toast.js';
+export interface ToastActions {
+    show: (message: string, type?: ToastType, action?: ToastAction) => void;
+    remove: (id: number) => void;
+}
+export declare class ToastController implements ReactiveController {
+    private _host;
+    private _toasts;
+    /** Active auto-dismiss timers, keyed by toast ID */
+    private _timers;
+    readonly actions: ToastActions;
+    get toasts(): readonly ToastItem[];
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _show;
+    private _remove;
+}
+//# sourceMappingURL=toast.controller.d.ts.map

package/dist/controllers/toast.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/toast.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAE1F,YAAY,EAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAE1F,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACxE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,qBAAa,eAAgB,YAAW,kBAAkB;IACtD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAAmB;IAClC,oDAAoD;IACpD,OAAO,CAAC,OAAO,CAAoD;IAEnE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B,IAAI,MAAM,IAAI,SAAS,SAAS,EAAE,CAEjC;gBAEW,IAAI,EAAE,sBAAsB;IASxC,aAAa;IAEb,gBAAgB;IAQhB,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,OAAO;CAUlB"}

package/dist/controllers/tool-call.controller.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ToolCall Controller
+ *
+ * Encapsulates tool call state machine: pending -> approved | denied.
+ * Supports approving individual calls or all calls for a given tool name.
+ * Dispatches `rtc-tool-call-*` events for external consumers.
+ *
+ * Also exposes `addPendingCall()` for the demo page and future protocol layer
+ * to inject new tool calls into the pending queue.
+ *
+ * Corresponds to: `toolCallContext` (defined in `contexts/tool-call.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-tool-confirm>`, `<rtc-overlay-manager>`
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ToolCall, ToolCallActions } from '../types/index.js';
+import type { ToolCallContextValue } from '../contexts/tool-call.js';
+export declare class ToolCallController implements ReactiveController {
+    host: ReactiveControllerHost & EventTarget;
+    private _state;
+    readonly actions: ToolCallActions;
+    get value(): ToolCallContextValue;
+    constructor(host: ReactiveControllerHost & EventTarget);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * 添加待处理的 tool call。
+     *
+     * **注意**：此方法不在 `ToolCallActions` 接口中，不通过 Context 暴露。
+     * 仅供协议层（未来）和 demo 页面（task19）直接调用 Controller 使用。
+     * 用户触发的 tool call 操作（approve/deny）仍通过 Context actions。
+     */
+    addPendingCall(call: ToolCall): void;
+    private _approve;
+    private _approveAll;
+    private _deny;
+}
+//# sourceMappingURL=tool-call.controller.d.ts.map

package/dist/controllers/tool-call.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/tool-call.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,QAAQ,EAAiB,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC;AAGnE,qBAAa,kBAAmB,YAAW,kBAAkB;IACzD,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAE3C,OAAO,CAAC,MAAM,CAA+C;IAE7D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,IAAI,KAAK,IAAI,oBAAoB,CAEhC;gBAEW,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAUtD,aAAa;IACb,gBAAgB;IAEhB;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ;IAO7B,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,KAAK;CAYhB"}

package/dist/controllers/window-interaction.controller.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Window Interaction Controller
+ *
+ * Manages drag-to-move, resize, and keyboard controls for the floating window.
+ * Does NOT own position/size state — delegates to WindowStateController via callbacks.
+ *
+ * Features:
+ * - Drag via title bar (mouse/touch)
+ * - Resize from 8 directions (4 corners + 4 edges)
+ * - Keyboard controls with explicit mode activation
+ * - Viewport boundary constraints
+ * - Reduced motion support
+ *
+ * @example
+ * ```typescript
+ * const controller = new WindowInteractionController(this);
+ *
+ * // After Shadow DOM ready
+ * controller.bindElements(this, titleBarElement);
+ *
+ * // Wire callbacks to WindowStateController
+ * controller.onPositionChange = (x, y) => windowState.actions.setPosition(x, y);
+ * controller.onSizeChange = (w, h) => windowState.actions.setSize(w, h);
+ *
+ * controller.actions.enable();
+ * ```
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+export interface InteractionState {
+    isDragging: boolean;
+    isResizing: boolean;
+    interactionMode: 'none' | 'move' | 'resize';
+}
+export interface InteractionActions {
+    enable(): void;
+    disable(): void;
+    enterMoveMode(): void;
+    enterResizeMode(): void;
+    exitInteractionMode(): void;
+}
+export interface WindowInteractionValue {
+    state: InteractionState;
+    actions: InteractionActions;
+}
+export declare class WindowInteractionController implements ReactiveController {
+    value: WindowInteractionValue;
+    onPositionChange?: (x: number, y: number) => void;
+    onSizeChange?: (width: number, height: number) => void;
+    private _host;
+    private _windowElement?;
+    private _titleBarElement?;
+    private _state;
+    private _isEnabled;
+    /** 窗口配置 */
+    private _draggable;
+    private _resizable;
+    /** Ghost 预览元素（拖动/缩放期间的轻量级视觉反馈） */
+    private _ghostElement?;
+    /** Ghost 起始状态（用于计算 delta） */
+    private _ghostStartRect?;
+    /** 累计拖动偏移（drag 期间） */
+    private _ghostDragOffset;
+    /** 缓存的 margin 值（拖动/缩放期间复用，避免重复调用 getComputedStyle） */
+    private _cachedMargin;
+    /** Bound keydown handler — stored so it can be removed on cleanup. */
+    private _boundOnKeydown;
+    constructor(host: ReactiveControllerHost, config?: {
+        draggable?: boolean;
+        resizable?: boolean;
+    });
+    /** 更新配置 */
+    setConfig(config: {
+        draggable?: boolean;
+        resizable?: boolean;
+    }): void;
+    /** 是否允许拖拽 */
+    get draggable(): boolean;
+    /** 是否允许调整大小 */
+    get resizable(): boolean;
+    /**
+     * Bind DOM elements after Shadow DOM is ready.
+     * Must be called before enable().
+     */
+    bindElements(windowElement: HTMLElement, titleBarElement: HTMLElement): void;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Cleanup interact.js instances and ghost element.
+     */
+    destroy(): void;
+    private _enable;
+    private _disable;
+    private _initInteractions;
+    private _initDrag;
+    private _initResize;
+    private _initKeyboard;
+    /**
+     * Keyboard handler for title bar interactions.
+     *
+     * - Enter/Space: activate move mode
+     * - Arrow keys (in move mode): nudge window position
+     * - Escape: exit interaction mode
+     */
+    private _handleKeydown;
+    private _enterMoveMode;
+    private _enterResizeMode;
+    private _exitInteractionMode;
+    private _onDragStart;
+    private _onDragMove;
+    private _onDragEnd;
+    private _onResizeStart;
+    private _onResizeMove;
+    private _onResizeEnd;
+    private _getMargin;
+    private _getMinSize;
+    /**
+     * 创建 Ghost 预览元素
+     *
+     * 在 document.body 中创建一个轻量级的虚线边框元素，
+     * 用于在拖动/缩放期间提供视觉反馈，避免触发 Lit 重渲染。
+     */
+    private _createGhostElement;
+    /**
+     * 销毁 Ghost 预览元素
+     */
+    private _destroyGhostElement;
+}
+//# sourceMappingURL=window-interaction.controller.d.ts.map

package/dist/controllers/window-interaction.controller.d.ts.map

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

package/dist/controllers/window-state.controller.d.ts

@@ -0,0 +1,79 @@
+/**
+ * WindowState Controller
+ *
+ * Encapsulates floating-window state logic: mode, position, size, and restore.
+ * Extracted from <rtc-agent> root component to keep it under 300 lines.
+ *
+ * Corresponds to: `windowStateContext` (defined in `contexts/window-state.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-title-bar>`, `<rtc-content-wrapper>`
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { WindowStateActions } from '../types/index.js';
+import type { WindowStateContextValue } from '../contexts/window-state.js';
+import type { ResolvedWindowConfig } from '../types/window-config.js';
+export declare class WindowStateController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private _state;
+    /** Whether state was restored from localStorage (used to skip initial position setup). */
+    private _restored;
+    /** Window configuration */
+    private _config;
+    /** Callback when viewport is too small for the window (triggers auto-minimize). */
+    onViewportTooSmall?: () => void;
+    readonly actions: WindowStateActions;
+    get value(): WindowStateContextValue;
+    /** Whether window state was restored from localStorage. */
+    get restored(): boolean;
+    constructor(host: ReactiveControllerHost, config?: ResolvedWindowConfig);
+    /** 更新配置 */
+    setConfig(config: ResolvedWindowConfig): void;
+    /** 获取配置 */
+    get config(): ResolvedWindowConfig;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Viewport resize handler — bound once in constructor. */
+    private _boundOnViewportResize;
+    /**
+     * Handle viewport resize (e.g. DevTools open/close/resize).
+     *
+     * - embedded: no action (fills parent container via CSS)
+     * - minimized: recalculate bubble position from bubblePosition config + new viewport size
+     * - normal: clamp position to keep window visible; auto-minimize if viewport too small
+     * - maximized: no action needed (CSS inset:0 handles it)
+     */
+    private _handleViewportResize;
+    private _restoreState;
+    /**
+     * 将窗口位置和尺寸限制在当前视口范围内
+     *
+     * 刷新后浏览器 devtools、缩放比例可能已变化，
+     * 直接恢复上次的位置可能导致窗口溢出视口（如被右侧 devtools 遮挡）。
+     */
+    private _clampToViewport;
+    private _persistState;
+    private _setMode;
+    /**
+     * Calculate initial window state based on bubblePosition.corner
+     *
+     * The corner determines which corner of the window aligns with the bubble position:
+     * - bottom-right: window's bottom-right aligns with bubble (expand to upper-left)
+     * - top-left: window's top-left aligns with bubble (expand to lower-right)
+     * - etc.
+     */
+    private _calculateInitialWindowState;
+    private _updateState;
+    /**
+     * Apply position/size state to a host element as inline styles.
+     *
+     * Inline styles override CSS rules (including :host([data-mode=...])),
+     * so we clear them when leaving 'normal' mode to let CSS take over.
+     *
+     * When the host has `data-embedded` attribute, skip all inline geometry —
+     * the component fills its parent container via CSS (position: relative).
+     *
+     * @param el - The host element to apply geometry to (typically the root component).
+     */
+    applyGeometry(el: HTMLElement): void;
+}
+//# sourceMappingURL=window-state.controller.d.ts.map

package/dist/controllers/window-state.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-state.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/window-state.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAER,kBAAkB,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AAGzE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAQpE,qBAAa,qBAAsB,YAAW,kBAAkB;IAC5D,IAAI,EAAE,sBAAsB,CAAC;IAE7B,OAAO,CAAC,MAAM,CAA0C;IACxD,0FAA0F;IAC1F,OAAO,CAAC,SAAS,CAAS;IAC1B,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAEhC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAErC,IAAI,KAAK,IAAI,uBAAuB,CAEnC;IAED,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,OAAO,CAEtB;gBAEW,IAAI,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,oBAAoB;IA+BvE,WAAW;IACX,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAS7C,WAAW;IACX,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED,aAAa;IAIb,gBAAgB;IAIhB,2DAA2D;IAC3D,OAAO,CAAC,sBAAsB,CAAsC;IAEpE;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IA0D7B,OAAO,CAAC,aAAa;IAgCrB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,QAAQ;IAkBhB;;;;;;;OAOG;IACH,OAAO,CAAC,4BAA4B;IAuCpC,OAAO,CAAC,YAAY;IAMpB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;CA+HvC"}

package/dist/core/builtin-system-group.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 内置 system 工具组
+ *
+ * 默认注册到每个 FunctionRegistry，提供脚本常用的系统级工具函数。
+ * 这些函数包装了被沙箱阻断的灰色 API（setTimeout、crypto.randomUUID 等），
+ * 通过 rtcAgent.system.* 暴露给脚本，使 LLM 无需直接访问平台 API。
+ *
+ * 注册方式：遵循标准 FunctionDef 规范，自动生成虚拟文档（/functions/system/*.md）
+ * LLM 通过 /AGENT.md → /functions/INDEX.md 发现这些函数。
+ *
+ * 注意：此文件演示了 Zod schema 注册方式（推荐），同时也兼容 OpenAPI Schema 方式。
+ */
+import type { FunctionDef } from '../types/skill.js';
+import type { FunctionRegistry } from './function-registry.js';
+/**
+ * system 组定义
+ */
+export declare const SYSTEM_GROUP_DEF: {
+    name: string;
+    description: string;
+};
+/**
+ * 注册内置 system 工具组到 registry
+ *
+ * 使用标准 createGroup + group.register 流程，自动生成虚拟文档。
+ * 应在 defineRegistry() 中自动调用，使所有 registry 默认拥有 system 组。
+ */
+export declare function registerBuiltinSystemGroup(registry: FunctionRegistry): void;
+/**
+ * system.delay(ms) — Promise-based sleep
+ *
+ * 包装 setTimeout，受脚本超时控制（Promise.race 会在脚本超时时 reject）。
+ *
+ * 使用 Zod schema 定义参数（推荐方式）
+ */
+export declare const DELAY_DEF: FunctionDef;
+/**
+ * system.uuid() — Generate UUID v4
+ *
+ * 使用 crypto.randomUUID()（现代浏览器均支持）。
+ *
+ * 使用 Zod schema 定义参数（推荐方式）
+ */
+export declare const UUID_DEF: FunctionDef;
+/**
+ * system.now() — Current timestamp
+ */
+export declare const NOW_DEF: FunctionDef;
+/**
+ * system.random(options?) — Random number generation
+ *
+ * 使用 Zod schema 定义参数（推荐方式）
+ * 使用 withMeta 添加示例值
+ */
+export declare const RANDOM_DEF: FunctionDef;
+/**
+ * system.time(format?) — Formatted current time
+ *
+ * 使用 Zod schema 定义参数（推荐方式）
+ */
+export declare const TIME_DEF: FunctionDef;
+/**
+ * 所有内置 system 函数定义
+ */
+export declare const SYSTEM_FUNCTIONS: FunctionDef[];
+//# sourceMappingURL=builtin-system-group.d.ts.map

package/dist/core/builtin-system-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-system-group.d.ts","sourceRoot":"","sources":["../../src/core/builtin-system-group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAQ3E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,WAyBvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,WAqBtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,WAWrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,WAwBxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,WAuBtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAMzC,CAAC"}

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

@@ -0,0 +1,133 @@
+/**
+ * Event Bus
+ *
+ * 简单的事件总线，用于解耦 FunctionRegistry 和 UI
+ *
+ * 使用场景：
+ * - FunctionRegistry 发出 function:start/success/error/progress 事件
+ * - UI 层监听事件并显示 toast/confirm/progress
+ * - 宿主应用（Flutter）监听事件并通过 postMessage 转发
+ */
+/**
+ * 事件处理器类型
+ */
+export type EventHandler<T = unknown> = (event: T) => void | Promise<void>;
+/**
+ * MD8: 事件映射接口 - 为事件名提供类型安全
+ *
+ * 使用方法：
+ * ```ts
+ * interface MyEvents {
+ *   'user:login': { userId: string };
+ *   'user:logout': void;
+ * }
+ * const bus = createEventBus<MyEvents>();
+ * bus.on('user:login', (event) => { ... }); // event 类型为 { userId: string }
+ * ```
+ */
+export interface DefaultEventMap {
+    [event: string]: unknown;
+}
+/**
+ * 事件总线
+ *
+ * @typeParam TEventMap - 事件名到数据类型的映射（MD8）
+ */
+export declare class EventBus<TEventMap extends DefaultEventMap = DefaultEventMap> {
+    private handlers;
+    /**
+     * 订阅事件
+     *
+     * @returns 取消订阅的函数
+     */
+    on<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
+    /**
+     * 订阅一次性事件
+     */
+    once<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): () => void;
+    /**
+     * 取消订阅
+     */
+    off<K extends keyof TEventMap & string>(event: K, handler: EventHandler<TEventMap[K]>): void;
+    /**
+     * 发出事件（同步）
+     *
+     * M8: 迭代前对 handlers 做快照（Array.from），避免 handler 内调用 off 导致并发修改
+     */
+    emit<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): void;
+    /**
+     * 发出事件（异步，等待所有 handler 完成）
+     *
+     * M9: 注意：此方法永远 resolve，handler 中的错误会被 catch 并通过 log.error 输出。
+     * 如果需要错误传播（handler 错误导致 emitAsync reject），请使用 emitAsyncStrict。
+     */
+    emitAsync<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): Promise<void>;
+    /**
+     * M9: 严格版异步事件发出 - handler 错误会导致 Promise reject
+     *
+     * 与 emitAsync 不同，此方法不会吞掉 handler 中的错误。
+     * 任一 handler 抛出错误，返回的 Promise 将 reject。
+     */
+    emitAsyncStrict<K extends keyof TEventMap & string>(event: K, data: TEventMap[K]): Promise<void>;
+    /**
+     * m6: 清除所有事件的所有处理器（改名为 clearAll 与 clearEvent 对称）
+     */
+    clearAll(): void;
+    /**
+     * 清除指定事件的所有处理器
+     */
+    clearEvent(event: string): void;
+}
+/**
+ * Function 执行相关事件
+ */
+export interface FunctionStartEvent {
+    path: string;
+    params: Record<string, unknown>;
+}
+export interface FunctionSuccessEvent {
+    path: string;
+    result: unknown;
+}
+export interface FunctionErrorEvent {
+    path: string;
+    error: Error;
+}
+export interface FunctionProgressEvent {
+    path: string;
+    progress: number;
+}
+/**
+ * MD8: FunctionRegistry 使用的事件映射
+ */
+export interface FunctionRegistryEventMap extends DefaultEventMap {
+    'function:start': FunctionStartEvent;
+    'function:success': FunctionSuccessEvent;
+    'function:error': FunctionErrorEvent;
+    'function:progress': FunctionProgressEvent;
+    'ui:toast': {
+        message: string;
+        type: string;
+    };
+    'ui:confirm-request': {
+        requestId: string;
+        path: string;
+        message: string;
+    };
+    'ui:confirm-response': {
+        requestId: string;
+        confirmed: boolean;
+    };
+}
+/**
+ * MD7: 事件总线工厂函数
+ *
+ * 使用工厂函数创建新的事件总线实例，避免全局单例的问题。
+ * 全局实例 `defaultEventBus` 只是默认导出，应用可以创建自己的实例。
+ */
+export declare function createEventBus<TEventMap extends DefaultEventMap = DefaultEventMap>(): EventBus<TEventMap>;
+/**
+ * 全局默认事件总线实例（MD7：仅作为默认导出，推荐使用 createEventBus() 创建独立实例）
+ */
+export declare const eventBus: EventBus<FunctionRegistryEventMap>;
+//# sourceMappingURL=event-bus.d.ts.map