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

package/dist/locales/en-US.d.ts

@@ -0,0 +1,4 @@
+import { LocaleModule } from '@lit/localize';
+declare const locale: LocaleModule;
+export default locale;
+//# sourceMappingURL=en-US.d.ts.map

package/dist/locales/en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../src/locales/en-US.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,QAAA,MAAM,MAAM,EAAE,YAA4B,CAAC;AAC3C,eAAe,MAAM,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,17 @@
+import { registry } from './registry.js';
+import { toolRegistry, virtualFS } from '@rtc-agent/persistence';
+declare global {
+    interface Window {
+        registry: typeof registry;
+        toolRegistry: typeof toolRegistry;
+        virtualFS: typeof virtualFS;
+        renderTasks: () => Promise<void>;
+        toggleTask: (id: string, completed: boolean) => Promise<void>;
+        deleteTask: (id: string) => Promise<void>;
+        openCreateModal: () => void;
+        openEditModal: (id: string) => Promise<void>;
+        closeModal: () => void;
+    }
+}
+export declare function renderTasks(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAOjE,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,QAAQ,EAAE,OAAO,QAAQ,CAAC;QAC1B,YAAY,EAAE,OAAO,YAAY,CAAC;QAClC,SAAS,EAAE,OAAO,SAAS,CAAC;QAC5B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,eAAe,EAAE,MAAM,IAAI,CAAC;QAC5B,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,UAAU,EAAE,MAAM,IAAI,CAAC;KAC1B;CACJ;AAuCD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBjD"}

package/dist/master-lock.d.ts

@@ -0,0 +1,72 @@
+/**
+ * MasterLock: 基于 Web Locks API 的 Master Tab 选举
+ *
+ * 设计原则：
+ * - 每个 Tab 各自持有一个 MasterLock，自己判断是否为 Master
+ * - Worker 不参与选举，不知道也不关心谁是 Master
+ * - Tab 关闭 → 浏览器自动释放锁 → 其他 Tab 排队获得 → 自动升级
+ * - 锁名含 userId，多用户隔离
+ *
+ * 用法：
+ * ```ts
+ * const lock = new MasterLock('user-123');
+ * lock.onAcquire = () => { console.log('became master'); };
+ * lock.onRelease = () => { console.log('lost master'); };
+ * await lock.acquire();  // 开始尝试获取锁（可能排队）
+ * // ... later
+ * lock.release();        // 主动释放（Tab 关闭时浏览器自动释放）
+ * ```
+ *
+ * @see docs/shared-worker-proposal.md §4.3
+ */
+export interface MasterLockCallbacks {
+    /** 获得锁 → 成为 Master */
+    onAcquire?: () => void;
+    /** 失去锁 → 降级为非 Master */
+    onRelease?: () => void;
+}
+export declare class MasterLock {
+    private _lockName;
+    private _isMaster;
+    private _controlled;
+    private _abortController?;
+    /** 获得锁时的回调 */
+    onAcquire?: () => void;
+    /** 失去锁时的回调 */
+    onRelease?: () => void;
+    constructor(userId: string);
+    /**
+     * 当前 Tab 是否为 Master
+     */
+    get isMaster(): boolean;
+    /**
+     * 是否已经开始选举流程（调用了 acquire）
+     */
+    get isControlled(): boolean;
+    /**
+     * 开始尝试获取 Master 锁
+     *
+     * - 如果没有其他 Master，立即获得锁
+     * - 如果已有 Master，排队等待（浏览器调度，零轮询）
+     * - 获得锁后调用 onAcquire 回调
+     * - Tab 关闭 → 浏览器自动释放 → 排队的 Tab 获得锁
+     *
+     * 幂等：多次调用只有第一次生效。
+     */
+    acquire(): Promise<void>;
+    /**
+     * 主动释放 Master 锁
+     *
+     * - 如果当前是 Master → 释放锁 → 触发 onRelease
+     * - 如果正在排队 → 取消排队（abort）
+     * - 如果已经不是 Master → no-op
+     */
+    release(): void;
+    /**
+     * 检测 Web Locks API 是否可用
+     */
+    private _isWebLocksAvailable;
+    /** 用于解除 acquire callback 中的阻塞 */
+    private _releaseResolve?;
+}
+//# sourceMappingURL=master-lock.d.ts.map

package/dist/master-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-lock.d.ts","sourceRoot":"","sources":["../src/master-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,MAAM,WAAW,mBAAmB;IAChC,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAE3C,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEX,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD9B;;;;;;OAMG;IACH,OAAO,IAAI,IAAI;IAmBf;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B,iCAAiC;IACjC,OAAO,CAAC,eAAe,CAAC,CAAa;CACxC"}

package/dist/registry.d.ts

@@ -0,0 +1,2 @@
+export declare const registry: import("./index.js").FunctionRegistry & Record<string, import("./index.js").FunctionGroup>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,QAAQ,4FAInB,CAAC"}

package/dist/repositories/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Repositories
+ *
+ * Data management layer with per-entity state isolation and pub-sub notifications.
+ */
+export { MessageRepository, MESSAGE_PAGE_SIZE } from './message.repository.js';
+export type { MessageApi, SessionDataCallback } from './message.repository.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EAAC,UAAU,EAAE,mBAAmB,EAAC,MAAM,yBAAyB,CAAC"}

package/dist/repositories/message.repository.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Message Repository
+ *
+ * Manages per-session message data with a publish-subscribe pattern.
+ * Each session maintains its own `messages`, `hasMore`, and `isLoadingMore` state.
+ *
+ * Key responsibilities:
+ * - Per-session data isolation: each session's state is independent
+ * - Subscription mechanism: multiple subscribers can watch the same session
+ * - API encapsulation: wraps fetchMessages and fetchOlderMessages calls
+ * - Immutability: all updates produce new arrays/objects
+ *
+ * Concurrency note: concurrent `loadMore` calls for the same session are
+ * de-duplicated via the `isLoadingMore` flag — only one request is in-flight
+ * at a time per session.
+ */
+import type { Message, MessageState } from '../types/index.js';
+/**
+ * API contract for message fetching.
+ *
+ * Implementations can wrap REST calls, WebSocket queries, or persistence layer.
+ *
+ * Cursor format: "${timestamp}|${clientId}" for (created_at, client_id) composite pagination.
+ */
+export interface MessageApi {
+    /** Fetch the latest messages for a session (initial load). */
+    fetchMessages(sessionId: string): Promise<Message[]>;
+    /** Fetch older messages before a given cursor (backward pagination). */
+    fetchOlderMessages(sessionId: string, beforeCursor?: string): Promise<Message[]>;
+    /** Fetch newer messages after a given cursor (forward pagination). */
+    fetchNewerMessages(sessionId: string, afterCursor?: string): Promise<Message[]>;
+}
+/** Callback signature for session data subscriptions. */
+export type SessionDataCallback = (data: MessageState) => void;
+/** Page size for message pagination (backward and forward). */
+export declare const MESSAGE_PAGE_SIZE = 50;
+export declare class MessageRepository {
+    private readonly _api;
+    /** Per-session message state. */
+    private _sessions;
+    /** Per-session subscriber sets. */
+    private _subscribers;
+    /** Tracks sessions with an in-flight loadMore (backward) request. */
+    private _loadingSessions;
+    /** Tracks sessions with an in-flight loadNewer (forward) request. */
+    private _loadingNewerSessions;
+    /** Per-session oldest loaded cursor for backward pagination. Format: "${timestamp}|${clientId}" */
+    private _oldestCursors;
+    /** Per-session newest loaded cursor for forward pagination. Format: "${timestamp}|${clientId}" */
+    private _newestCursors;
+    constructor(_api: MessageApi);
+    /**
+     * Subscribe to data changes for a session.
+     *
+     * The callback is invoked immediately with the current state (if any),
+     * and again whenever the state changes. Returns an unsubscribe function.
+     */
+    subscribe(sessionId: string, callback: SessionDataCallback): () => void;
+    /**
+     * Get the current state for a session.
+     *
+     * Returns a default empty state if the session has not been initialized.
+     */
+    getSessionState(sessionId: string): MessageState;
+    /**
+     * Replace all messages for a session.
+     *
+     * Typically called when new data arrives from WebSocket or initial API load.
+     * Notifies all subscribers of the change.
+     */
+    updateMessages(sessionId: string, messages: Message[]): void;
+    /**
+     * Append a single message to a session's message list.
+     *
+     * Creates a new messages array to preserve immutability of prior state.
+     * Notifies all subscribers.
+     */
+    appendMessage(sessionId: string, message: Message): void;
+    /**
+     * Update a single message in place using an updater function.
+     *
+     * More efficient than updateMessages() for single-message changes (e.g., streaming).
+     * Only the specified message is replaced in the array, avoiding full array copies.
+     *
+     * @param sessionId - Session ID
+     * @param messageId - Message client ID to update
+     * @param updater - Function that receives the current message and returns the updated message
+     * @returns true if the message was found and updated, false otherwise
+     */
+    patchMessage(sessionId: string, messageId: string, updater: (msg: Message) => Message): boolean;
+    /**
+     * Load older messages for a session (backward pagination).
+     *
+     * Concurrent calls for the same session are de-duplicated: if a load is
+     * already in-flight, subsequent calls return the existing promise.
+     * On failure, `isLoadingMore` is reset to false.
+     *
+     * @returns the full message list after prepending older messages,
+     *          or the current list if load was skipped (no hasMore / already loading).
+     */
+    loadMore(sessionId: string): Promise<Message[]>;
+    /**
+     * Load newer messages for a session (forward pagination).
+     *
+     * Concurrent calls for the same session are de-duplicated: if a load is
+     * already in-flight, subsequent calls return the existing promise.
+     * On failure, `isLoadingNewer` is reset to false.
+     *
+     * @returns the full message list after appending newer messages,
+     *          or the current list if load was skipped (no hasMoreNewer / already loading).
+     */
+    loadNewer(sessionId: string): Promise<Message[]>;
+    /**
+     * Fetch messages for a session (initial load).
+     *
+     * Sets `hasMore` based on whether the API returned MESSAGE_PAGE_SIZE messages.
+     * Returns the fetched messages.
+     */
+    fetchMessages(sessionId: string): Promise<Message[]>;
+    /**
+     * Evict a session: clear its data and remove all subscribers.
+     *
+     * Called when a tab is closed or a session should no longer be tracked.
+     * After eviction, getSessionState returns the default empty state.
+     */
+    evictSession(sessionId: string): void;
+    /**
+     * Set the hasMore flag for a session.
+     *
+     * This is used by the controller layer to sync pagination state after
+     * operations like _reloadFromDB that calculate hasMore independently.
+     * Without this, updateMessages only replaces the messages array but
+     * keeps the existing hasMore value (which may be the DEFAULT_STATE's false).
+     */
+    setHasMore(sessionId: string, value: boolean): void;
+    /**
+     * Set the hasMoreNewer flag for a session.
+     *
+     * This is used to indicate whether there are newer messages available
+     * in the database for forward pagination.
+     */
+    setHasMoreNewer(sessionId: string, value: boolean): void;
+    /**
+     * Set the oldest loaded cursor for a session.
+     * Cursor format: "${timestamp}|${clientId}" for (created_at, client_id) composite pagination.
+     *
+     * This is used by the controller layer to track the backward pagination cursor.
+     * Called after initial load or loadMore completes.
+     */
+    setOldestOffset(sessionId: string, cursor: string): void;
+    /**
+     * Get the oldest loaded cursor for a session.
+     */
+    getOldestOffset(sessionId: string): string | undefined;
+    /**
+     * Set the newest loaded cursor for a session.
+     * Cursor format: "${timestamp}|${clientId}" for (created_at, client_id) composite pagination.
+     *
+     * This is used by the controller layer to track the forward pagination cursor.
+     * Called after initial load or loadNewer completes.
+     */
+    setNewestOffset(sessionId: string, cursor: string): void;
+    /**
+     * Get the newest loaded cursor for a session.
+     */
+    getNewestOffset(sessionId: string): string | undefined;
+    /**
+     * Get the state for a session, returning a default if not initialized.
+     * Always returns a new object to prevent external mutation.
+     */
+    private _getState;
+    /**
+     * Set the state for a session and notify all subscribers.
+     * Stores a shallow copy to maintain immutability.
+     */
+    private _setState;
+    /**
+     * Notify all subscribers for a session with the current state.
+     */
+    private _notifySubscribers;
+}
+//# sourceMappingURL=message.repository.d.ts.map

package/dist/repositories/message.repository.d.ts.map

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