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

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
+ *
+ * Used for Activity Bar configuration API of the <rtc-agent> component.
+ * Controls the visibility of activity buttons in the Activity Bar.
+ */
+/**
+ * Activity type
+ */
+export type Activity = 'files' | 'chat' | 'settings' | 'functions';
+/**
+ * Activity Bar configuration
+ *
+ * Set via the <rtc-agent>.activityBarConfig property.
+ * Note: the chat button is always visible and cannot be hidden.
+ */
+export interface ActivityBarConfig {
+    /** Disabled activities list (chat cannot be disabled) */
+    disabledActivities?: Array<'files' | 'settings' | 'functions'>;
+    /** Default activity */
+    defaultActivity?: Activity;
+}
+/**
+ * Resolved Activity Bar configuration (all fields have defaults)
+ */
+export interface ResolvedActivityBarConfig {
+    disabledActivities: Array<'files' | 'settings' | 'functions'>;
+    defaultActivity: Activity;
+}
+/**
+ * Default Activity Bar configuration
+ */
+export declare const DEFAULT_ACTIVITY_BAR_CONFIG: ResolvedActivityBarConfig;
+/**
+ * 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

@@ -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,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

@@ -0,0 +1,61 @@
+/**
+ * Agent Declarative Configuration
+ *
+ * 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
+ * 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 declarative configuration
+ *
+ * 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 name (used for system prompt, etc.). Falls back to appLabel if omitted */
+    name?: string;
+    /** Agent description */
+    description?: string;
+    /** AI persona (system prompt) */
+    persona?: string;
+    /**
+     * Flat function list (automatically placed into a group named 'default')
+     *
+     * 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 function group
+ */
+export interface AgentFunctionGroup {
+    /** 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

@@ -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,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

@@ -0,0 +1,112 @@
+/**
+ * RtcAgent Event Type Map
+ *
+ * Extends HTMLElementEventMap globally to provide type-safe addEventListener
+ * for custom events dispatched by <rtc-agent>.
+ *
+ * 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 -- type-safe
+ * });
+ * agent.addEventListener('click', (e) => {
+ *   e.clientX;  // number -- native events remain type-safe
+ * });
+ * 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 type explanation:
+ * - `void`: event has no payload
+ * - `T`: event payload type is T
+ */
+export interface RtcAgentEventDetailMap {
+    /** Component first render complete; safe to set agentConfig / registry */
+    'rtc-agent-ready': void;
+    /** 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';
+    };
+    /** 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-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

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