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

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

@@ -0,0 +1,122 @@
+/**
+ * Window Configuration Types
+ *
+ * Window configuration API for the <rtc-agent> component.
+ * Controls the window's default state, size, position, interaction constraints, etc.
+ */
+/**
+ * Bubble position configuration
+ *
+ * Uses a mathematical Cartesian coordinate system:
+ * - Origin is at one corner of the host application (determined by `corner`)
+ * - x-axis: positive to the right, negative to the left
+ * - y-axis: positive upward, negative downward (mathematical, not screen coordinates)
+ *
+ * Quadrant distribution:
+ * - top-left: Quadrant IV (x>0, y<0)
+ * - top-right: Quadrant III (x<0, y<0)
+ * - bottom-left: Quadrant I (x>0, y>0)
+ * - bottom-right: Quadrant II (x<0, y>0)
+ */
+export type BubbleCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export interface BubblePosition {
+    /** Which corner of the host application is the coordinate origin */
+    corner: BubbleCorner;
+    /** Offset relative to the origin (mathematical Cartesian coordinates) */
+    offset: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Window configuration
+ *
+ * Set via the <rtc-agent>.windowConfig property.
+ */
+export interface WindowConfig {
+    /** Default window mode */
+    defaultMode?: 'normal' | 'maximized' | 'minimized';
+    /** Initial position (only effective in normal mode) */
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Initial size (only effective in normal mode) */
+    initialSize?: {
+        width: number;
+        height: number;
+    };
+    /** Minimum width */
+    minWidth?: number;
+    /** Minimum height */
+    minHeight?: number;
+    /** Maximum width (defaults to viewport width) */
+    maxWidth?: number;
+    /** Maximum height (defaults to viewport height) */
+    maxHeight?: number;
+    /** Whether dragging is allowed (default: true) */
+    draggable?: boolean;
+    /** Whether resizing is allowed (default: true) */
+    resizable?: boolean;
+    /** Whether to show the minimize button (default: true) */
+    showMinimize?: boolean;
+    /** Whether to show the maximize button (default: true) */
+    showMaximize?: boolean;
+    /** Whether to show the close button (default: false; close = minimize) */
+    showClose?: boolean;
+    /**
+     * Embedded mode (disables all window interaction)
+     *
+     * Equivalent to:
+     * - draggable: false
+     * - resizable: false
+     * - showMinimize: false
+     * - showMaximize: false
+     * - showClose: false
+     * - defaultMode: 'maximized'
+     */
+    embedded?: boolean;
+    /**
+     * Minimized bubble position configuration
+     *
+     * Uses a mathematical Cartesian coordinate system with the origin at one corner of the host application.
+     * Default: { corner: 'bottom-right', offset: { x: -20, y: 20 } }
+     */
+    bubblePosition?: BubblePosition;
+}
+/**
+ * Resolved window configuration (all fields have defaults)
+ */
+export interface ResolvedWindowConfig {
+    defaultMode: 'normal' | 'maximized' | 'minimized';
+    initialPosition: {
+        x: number;
+        y: number;
+    };
+    initialSize: {
+        width: number;
+        height: number;
+    };
+    minWidth: number;
+    minHeight: number;
+    maxWidth: number;
+    maxHeight: number;
+    draggable: boolean;
+    resizable: boolean;
+    showMinimize: boolean;
+    showMaximize: boolean;
+    showClose: boolean;
+    embedded: boolean;
+    bubblePosition: BubblePosition;
+}
+/**
+ * Default window configuration
+ */
+export declare const DEFAULT_WINDOW_CONFIG: ResolvedWindowConfig;
+/**
+ * Resolve window configuration (merge with defaults)
+ *
+ * embedded: true overrides interaction-related settings.
+ */
+export declare function resolveWindowConfig(config?: WindowConfig): ResolvedWindowConfig;
+//# sourceMappingURL=window-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"window-config.d.ts","sourceRoot":"","sources":["../../src/types/window-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;AAErF,MAAM,WAAW,cAAc;IAC3B,oEAAoE;IACpE,MAAM,EAAE,YAAY,CAAC;IACrB,yEAAyE;IACzE,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAGzB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAEnD,uDAAuD;IACvD,eAAe,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE3C,mDAAmD;IACnD,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAInB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAClD,eAAe,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,oBAenC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,oBAAoB,CAyB/E"}

package/dist/utils/clipboard.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Clipboard utilities
+ *
+ * Provides cross-browser compatible clipboard copy functionality.
+ * Prefers navigator.clipboard API, falls back to execCommand.
+ */
+/**
+ * Copy text to clipboard
+ *
+ * @param text Text to copy
+ * @returns Whether the copy was successful
+ */
+export declare function copyToClipboard(text: string): Promise<boolean>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/utils/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/utils/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCpE"}

package/dist/utils/command-parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Command Parser
+ *
+ * Parses slash commands from user input.
+ * Format: /command_name [args...]
+ *
+ * Examples:
+ *   "/compact"              → { isCommand: true, name: "compact" }
+ *   "/compact summarize"    → { isCommand: true, name: "compact", args: "summarize" }
+ *   "/compact 请总结对话"    → { isCommand: true, name: "compact", args: "请总结对话" }
+ *   "hello world"           → { isCommand: false }
+ *   "/"                     → { isCommand: false }
+ *   "/ "                    → { isCommand: false }
+ */
+export interface ParsedCommand {
+    /** Whether the input is a command */
+    isCommand: boolean;
+    /** Command name (without the '/' prefix) */
+    name?: string;
+    /** Command arguments (remaining content after command name, trimmed) */
+    args?: string;
+}
+/**
+ * Parse user input to determine if it's a slash command
+ *
+ * Parsing rules:
+ * 1. Input must start with '/'
+ * 2. There must be at least one non-whitespace character after '/' as the command name
+ * 3. The command name consists of consecutive non-whitespace characters (up to the first space)
+ * 4. Content after the command name is treated as arguments (passed after trimming)
+ */
+export declare function parseCommand(input: string): ParsedCommand;
+//# sourceMappingURL=command-parser.d.ts.map

package/dist/utils/command-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parser.d.ts","sourceRoot":"","sources":["../../src/utils/command-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,aAAa;IAC1B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAwCzD"}

package/dist/utils/content-data.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ContentData Type Guards and Narrowing Helpers
+ *
+ * Provides type-safe access to ContentData.data field, which has different
+ * structures depending on the `type` field. This eliminates the need for
+ * unsafe `as any` casts throughout the codebase.
+ *
+ * Usage:
+ * ```typescript
+ * import { getToolCallData, getSummaryData } from '../utils/content-data.js';
+ *
+ * const toolCall = getToolCallData(message.content);
+ * if (toolCall) {
+ *   console.log(toolCall.id, toolCall.name);
+ * }
+ * ```
+ */
+import type { ContentData } from '@rtc-agent/protocol';
+/**
+ * ToolCall input data structure (toolcall_input content type).
+ * Represents a tool invocation request from the assistant.
+ */
+export interface ToolCallInputData {
+    /** Unique identifier for this tool call */
+    id: string;
+    /** Tool name (e.g., 'filesystem.read_file') */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Tool-specific parameters */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * ToolCall output data structure (toolcall_output content type).
+ * Represents the result of a tool invocation.
+ */
+export interface ToolCallOutputData {
+    /** Reference to the originating tool call */
+    id: string;
+    /** Tool execution result (type varies by tool) */
+    result?: unknown;
+    /** Error message if execution failed */
+    error?: string;
+}
+/**
+ * Summary content metadata (for summary content type).
+ */
+export interface SummaryMetadata {
+    /** Token count before compression */
+    tokens_before: number;
+    /** Token count after compression */
+    tokens_after: number;
+    /** Compression duration in milliseconds */
+    duration_ms?: number;
+}
+/**
+ * Summary content data structure (for summary content type).
+ */
+export interface SummaryContentData {
+    /** Summary items (legacy format: array) */
+    items?: unknown[];
+    /** Compression metadata */
+    metadata?: SummaryMetadata;
+}
+/**
+ * Error content data structure (for error content type).
+ */
+export interface ErrorContentData {
+    /** Error category */
+    category: 'api' | 'stream' | 'tool' | 'context' | 'system' | 'network' | 'timeout' | 'permission';
+    /** Short error title */
+    title: string;
+    /** Detailed description */
+    message: string;
+    /** Whether the operation can be retried */
+    retryable: boolean;
+}
+/**
+ * Extract ToolCall input data from ContentData.
+ *
+ * @param content - The ContentData object
+ * @returns ToolCallInputData if content.type is 'toolcall_input', undefined otherwise
+ */
+export declare function getToolCallInputData(content: ContentData | undefined | null): ToolCallInputData | undefined;
+/**
+ * Extract ToolCall output data from ContentData.
+ *
+ * @param content - The ContentData object
+ * @returns ToolCallOutputData if content.type is 'toolcall_output', undefined otherwise
+ */
+export declare function getToolCallOutputData(content: ContentData | undefined | null): ToolCallOutputData | undefined;
+/**
+ * Extract Summary content data from ContentData.
+ *
+ * @param content - The ContentData object
+ * @returns SummaryContentData if content.type is 'summary', undefined otherwise
+ */
+export declare function getSummaryData(content: ContentData | undefined | null): SummaryContentData | undefined;
+/**
+ * Extract Error content data from ContentData.
+ *
+ * @param content - The ContentData object
+ * @returns ErrorContentData if content.type is 'error', undefined otherwise
+ */
+export declare function getErrorData(content: ContentData | undefined | null): ErrorContentData | undefined;
+/**
+ * Extract string data from ContentData (for text/markdown/thinking types).
+ *
+ * @param content - The ContentData object
+ * @returns String data if content.type is 'text', 'markdown', or 'thinking', undefined otherwise
+ */
+export declare function getStringData(content: ContentData | undefined | null): string | undefined;
+//# sourceMappingURL=content-data.d.ts.map

package/dist/utils/content-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-data.d.ts","sourceRoot":"","sources":["../../src/utils/content-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qBAAqB;IACrB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IAClG,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAG3G;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,kBAAkB,GAAG,SAAS,CAG7G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,kBAAkB,GAAG,SAAS,CAGtG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,gBAAgB,GAAG,SAAS,CAGlG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAMzF"}

package/dist/utils/custom-scrollbar.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Custom Scrollbar - Ported from Telegram Web
+ *
+ * Provides a custom scrollbar that doesn't jump when content is prepended.
+ * Uses thumb + thumbContainer pattern.
+ */
+export declare class CustomScrollbar {
+    private _container;
+    private _thumbContainer;
+    private _thumb;
+    private _startMousePosition;
+    private _startScrollPosition;
+    private _onMouseMove;
+    private _onMouseDown;
+    private _onMouseUp;
+    private _onScroll;
+    constructor(container: HTMLElement);
+    /**
+     * Update thumb position and size based on scroll position.
+     *
+     * Guards against zero-dimension containers (before layout) where divisions
+     * would produce NaN/Infinity.
+     */
+    updateThumb(scrollPosition?: number): void;
+    /**
+     * Call this when content size changes.
+     */
+    onSizeChange(): void;
+    /**
+     * Clean up event listeners and visual state.
+     *
+     * Removes the `is-focused` class that may remain if destroy() is called
+     * during an active drag (before _handleMouseUp fires).
+     */
+    destroy(): void;
+    private _handleScroll;
+    private _handleMouseDown;
+    private _handleMouseMove;
+    private _handleMouseUp;
+}
+//# sourceMappingURL=custom-scrollbar.d.ts.map

package/dist/utils/custom-scrollbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-scrollbar.d.ts","sourceRoot":"","sources":["../../src/utils/custom-scrollbar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,qBAAa,eAAe;IACxB,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,oBAAoB,CAAa;IAEzC,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,SAAS,CAAa;gBAElB,SAAS,EAAE,WAAW;IA2BlC;;;;;OAKG;IACH,WAAW,CAAC,cAAc,GAAE,MAAkC;IA0B9D;;OAEG;IACH,YAAY;IAIZ;;;;;OAKG;IACH,OAAO;IAQP,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,cAAc;CAIzB"}

package/dist/utils/device.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Get or create a Device ID.
+ *
+ * Generates a UUID on first call and persists it to localStorage.
+ * Subsequent calls return the stored ID.
+ *
+ * Falls back to an ephemeral UUID if localStorage is unavailable
+ * (e.g. private browsing, quota exceeded) — the ID will differ across
+ * page loads but the component remains functional.
+ */
+export declare function getOrCreateDeviceId(): string;
+/**
+ * Get device name.
+ *
+ * Reads from localStorage, or generates a default based on UserAgent.
+ */
+export declare function getDeviceName(): string;
+/**
+ * Set device name.
+ */
+export declare function setDeviceName(name: string): void;
+//# sourceMappingURL=device.d.ts.map

package/dist/utils/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/utils/device.ts"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAe5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAUtC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOhD"}

package/dist/utils/floating-panel-controller.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Floating Panel Controller — shared positioning lifecycle for overlay panels.
+ *
+ * Encapsulates the floating-ui autoUpdate/computePosition pattern used by
+ * multiple overlay panels (mode, command, scenario) in <rtc-input-area>.
+ *
+ * Each instance manages one panel's positioning lifecycle:
+ * - startPositioning(): begin auto-updating position when panel opens
+ * - stopPositioning(): tear down autoUpdate when panel closes
+ *
+ * The host component retains ownership of visibility state (@state) and
+ * outside-click dismissal, while this controller handles the DOM math.
+ */
+import { type Placement } from '@floating-ui/dom';
+export interface FloatingPanelControllerOptions {
+    /** Host element for awaiting updateComplete before positioning. */
+    host: {
+        updateComplete: Promise<boolean>;
+    };
+    /** Returns the anchor button element (may be undefined before render). */
+    getButton: () => HTMLElement | undefined;
+    /** Returns the floating panel element (may be undefined before render). */
+    getPanel: () => HTMLElement | undefined;
+    /** Floating-ui placement relative to the anchor. */
+    placement: Placement;
+}
+export declare class FloatingPanelController {
+    private _cleanup;
+    private readonly _host;
+    private readonly _getButton;
+    private readonly _getPanel;
+    private readonly _placement;
+    private readonly _middleware;
+    constructor(options: FloatingPanelControllerOptions);
+    /**
+     * Start auto-updating the panel position relative to its anchor button.
+     *
+     * Waits for the host's updateComplete so the panel element exists in DOM,
+     * then sets up floating-ui's autoUpdate for continuous repositioning on
+     * scroll/resize.
+     */
+    startPositioning(): Promise<void>;
+    /** Stop auto-updating and release the floating-ui cleanup callback. */
+    stopPositioning(): void;
+    /**
+     * Compute and apply the panel's position.
+     *
+     * Called by autoUpdate on scroll/resize, and once on initial positioning.
+     */
+    private _updatePosition;
+}
+//# sourceMappingURL=floating-panel-controller.d.ts.map

package/dist/utils/floating-panel-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-panel-controller.d.ts","sourceRoot":"","sources":["../../src/utils/floating-panel-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAMH,KAAK,SAAS,EAEjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,8BAA8B;IAC3C,mEAAmE;IACnE,IAAI,EAAE;QAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAC,CAAC;IACzC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACxC,oDAAoD;IACpD,SAAS,EAAE,SAAS,CAAC;CACxB;AAED,qBAAa,uBAAuB;IAChC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAE/B,OAAO,EAAE,8BAA8B;IAcnD;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUvC,uEAAuE;IACvE,eAAe,IAAI,IAAI;IAKvB;;;;OAIG;YACW,eAAe;CAgBhC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Format Utilities
+ *
+ * Shared formatting and content helpers used across multiple components.
+ * Avoids duplicating timestamp/date logic and content extraction in
+ * rtc-message, rtc-toolcall-card, rtc-user-message, etc.
+ */
+import type { ContentData } from '../types/index.js';
+/**
+ * Format a timestamp (ms since epoch) into a compact MM-DD HH:mm string.
+ *
+ * Used in timeline dots and message metadata where full dates are unnecessary.
+ * Returns empty string for falsy input.
+ */
+export declare function formatTimestampCompact(timestamp: number | undefined | null): string;
+/**
+ * Extract plain text content from a ContentData object.
+ *
+ * Handles all content types uniformly:
+ * - text/markdown/thinking: return string data or JSON-stringify objects
+ * - summary: return placeholder text
+ * - other: best-effort string extraction
+ *
+ * Used for clipboard copy operations across message components.
+ */
+export declare function extractTextContent(content: ContentData | undefined | null): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAgB,MAAM,mBAAmB,CAAC;AAGlE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAQnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CA8ClF"}

package/dist/utils/highlight-languages.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Highlight.js on-demand loading configuration
+ *
+ * Only registers commonly used languages, significantly reducing bundle size (from 9.2MB to ~1MB).
+ * Covers common RTC Agent code scenarios: TypeScript/JavaScript/Python/Go/JSON/YAML/Bash, etc.
+ */
+import hljs from 'highlight.js/lib/core';
+export default hljs;
+//# sourceMappingURL=highlight-languages.d.ts.map

package/dist/utils/highlight-languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight-languages.d.ts","sourceRoot":"","sources":["../../src/utils/highlight-languages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,IAAI,MAAM,uBAAuB,CAAC;AAgDzC,eAAe,IAAI,CAAC"}

package/dist/utils/message-skeleton.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Skeleton screen generator for message placeholders
+ *
+ * Generates type-specific skeleton structures (user, assistant, toolcall, etc.)
+ * using pure DOM elements (no Lit component overhead).
+ *
+ * Inspired by Telegram's placeholder approach - provides visual continuity
+ * while messages are being virtualized.
+ */
+import type { Message } from '../types/index.js';
+/**
+ * Skeleton screen generator for message placeholders
+ */
+export declare class MessageSkeletonGenerator {
+    /**
+     * Generate a skeleton placeholder by type
+     */
+    static generate(type: 'user' | 'assistant' | 'toolcall' | 'toolcall-reply' | 'error', height: number): string;
+    /**
+     * Create a skeleton placeholder for a message (convenience method)
+     * Uses inline styles to bypass Lit's style scoping issues with dynamic DOM insertion.
+     */
+    static create(msg: Message, height: number): HTMLElement;
+    /**
+     * Determine skeleton type based on message type
+     */
+    private static _getSkeletonType;
+    /**
+     * Render skeleton content based on type
+     * All styles are inline to bypass Lit's style scoping issues.
+     */
+    private static _renderSkeletonContent;
+    /**
+     * Render skeleton lines with varying widths
+     * All styles are inline to bypass Lit's style scoping issues.
+     */
+    private static _renderSkeletonLines;
+}
+//# sourceMappingURL=message-skeleton.d.ts.map

package/dist/utils/message-skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-skeleton.d.ts","sourceRoot":"","sources":["../../src/utils/message-skeleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAC;AAE/C;;GAEG;AACH,qBAAa,wBAAwB;IACjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,gBAAgB,GAAG,OAAO,EACpE,MAAM,EAAE,MAAM,GACf,MAAM;IAIT;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW;IAqBxD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAU/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAuErC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAatC"}