@rtc-agent/component 0.2.6-rc.0 → 0.2.6-rc.2

package/README.md

@@ -80,6 +80,39 @@ const agent = createRtcAgent({ /* ... */ });
 
 ## 用法
 
+### 工厂函数（推荐）
+
+```ts
+import { createRtcAgent } from '@rtc-agent/component';
+
+const agent = createRtcAgent({
+  appLabel: 'My Assistant',
+  server: { url: 'https://api.example.com' },
+  workerUrl: '/rtc-agent/shared-worker.js',
+  auth: {
+    getToken: () => localStorage.getItem('token'),
+    refreshToken: async () => {
+      const res = await fetch('/api/refresh');
+      const data = await res.json();
+      return { accessToken: data.token };
+    },
+    userId: 'user-123',
+  },
+  on: {
+    ready: () => console.log('RTC Agent ready'),
+    themeChange: ({ theme }) => console.log('Theme:', theme),
+    toolCallStart: ({ path, params }) => console.log('Tool call:', path),
+  },
+});
+
+document.body.appendChild(agent);
+
+// 不再需要时销毁
+agent.destroy();
+```
+
+### HTML 元素
+
 ```html
 <script type="module">
   import '@rtc-agent/component';
@@ -115,13 +148,33 @@ RTC Agent 使用 SharedWorker + Comlink 架构实现多 Tab 共享：
 
 ### 公开事件
 
-所有公开事件遵循 `rtc-<domain>-<action>-<past-tense>` 命名模式：
+所有公开事件遵循 `rtc-agent-<event>` 命名模式：
+
+**生命周期事件：**
 
 - `rtc-agent-ready` — 组件就绪
+- `rtc-agent-beforeDestroy` — 组件即将销毁
+- `rtc-agent-themeChange` — 主题变化
+
+**消息拦截事件：**
+
+- `rtc-agent-beforeMessageSend` — 消息发送前（可取消或修改）
+
+**工具调用事件：**
+
+- `rtc-agent-toolCallStart` — 工具调用开始
+- `rtc-agent-toolCallSuccess` — 工具调用成功
+- `rtc-agent-toolCallError` — 工具调用失败
+- `rtc-agent-toolCallProgress` — 工具调用进度
+
+**会话和消息事件：**
+
 - `rtc-session-created` / `rtc-session-switched`
 - `rtc-message-sent`
+
+**认证事件：**
+
 - `rtc-auth-login-requested`
-- `rtc-window-minimize` / `rtc-window-maximize` / `rtc-window-restore`
 
 ### 控制器访问
 

package/bin/rtc-agent-setup.js

@@ -16,7 +16,7 @@
  *   }
  */
 
-import { existsSync, mkdirSync, copyFileSync, readFileSync, readdirSync, writeFileSync } from 'fs';
+import { existsSync, mkdirSync, copyFileSync, readFileSync, readdirSync, writeFileSync, unlinkSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -92,7 +92,23 @@ function copyWorkerFiles(targetDir) {
     console.log(`📁 Created directory: ${targetDir}`);
   }
 
-  // Find and copy shared-worker files
+  // Clean up old hashed worker files
+  const existingFiles = existsSync(targetDir) ? readdirSync(targetDir) : [];
+  const oldWorkerFiles = existingFiles.filter(
+    f => f.startsWith('shared-worker-') && f.endsWith('.js') && f !== 'shared-worker.js'
+  );
+
+  for (const oldFile of oldWorkerFiles) {
+    const oldPath = join(targetDir, oldFile);
+    try {
+      unlinkSync(oldPath);
+      console.log(`🗑️  Removed old: ${oldFile}`);
+    } catch (err) {
+      console.warn(`⚠️  Could not remove ${oldFile}: ${err.message}`);
+    }
+  }
+
+  // Find the main worker file in dist
   const distFiles = readdirSync(sourceDir);
   const workerFiles = distFiles.filter(f => f.startsWith('shared-worker') && f.endsWith('.js'));
 
@@ -102,28 +118,19 @@ function copyWorkerFiles(targetDir) {
     return 0;
   }
 
-  let copiedCount = 0;
-  let mainWorkerFile = null;
+  // Find the hashed worker file
+  const hashedWorkerFile = workerFiles.find(f => f !== 'shared-worker.js' && f.match(/shared-worker-[A-Za-z0-9]+\.js/));
 
-  for (const file of workerFiles) {
-    const sourcePath = join(sourceDir, file);
-    const targetPath = join(targetDir, file);
-    copyFileSync(sourcePath, targetPath);
-    console.log(`✅ Copied ${file} → ${targetDir}`);
-    copiedCount++;
-
-    // Track the main worker file (without .map or other extensions)
-    if (file.endsWith('.js') && !file.includes('.map')) {
-      mainWorkerFile = file;
-    }
+  if (!hashedWorkerFile) {
+    console.warn('⚠️  Warning: No hashed worker file found');
+    return 0;
   }
 
-  // Create a stable symlink or copy without hash for easy reference
-  if (mainWorkerFile && mainWorkerFile !== 'shared-worker.js') {
-    const stablePath = join(targetDir, 'shared-worker.js');
-    copyFileSync(join(targetDir, mainWorkerFile), stablePath);
-    console.log(`✅ Created stable link: shared-worker.js → ${mainWorkerFile}`);
-  }
+  // Copy as shared-worker.js (stable name, no hash)
+  const sourcePath = join(sourceDir, hashedWorkerFile);
+  const targetPath = join(targetDir, 'shared-worker.js');
+  copyFileSync(sourcePath, targetPath);
+  console.log(`✅ Copied ${hashedWorkerFile} → shared-worker.js`);
 
   // Create manifest.json with version info
   const packageJsonPath = join(__dirname, '..', 'package.json');
@@ -131,7 +138,7 @@ function copyWorkerFiles(targetDir) {
 
   const manifest = {
     version: packageJson.version,
-    workerFile: mainWorkerFile,
+    workerFile: 'shared-worker.js',
     stableWorkerUrl: '/rtc-agent/shared-worker.js',
     timestamp: new Date().toISOString(),
   };
@@ -142,7 +149,7 @@ function copyWorkerFiles(targetDir) {
   );
   console.log(`✅ Created manifest.json (version ${packageJson.version})`);
 
-  return copiedCount;
+  return 1;
 }
 
 /**