@agentrhq/webcmd 0.1.2 → 0.2.1

package/clis/twitter/delete.js

@@ -1,28 +1,36 @@
 import { cli, Strategy } from '@agentrhq/webcmd/registry';
 import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { parseTweetUrl, buildTwitterArticleScopeSource } from './shared.js';
+import { parseTweetUrl, buildTwitterArticleScopeSource, unwrapBrowserResult } from './shared.js';
 
 function buildDeleteScript(tweetId) {
     return `(async () => {
       try {
           const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
           ${buildTwitterArticleScopeSource(tweetId)}
-          const targetArticle = findTargetArticle();
+          let targetArticle = findTargetArticle();
+          for (let i = 0; i < 20 && !targetArticle; i++) {
+              await new Promise(r => setTimeout(r, 250));
+              targetArticle = findTargetArticle();
+          }
 
           if (!targetArticle) {
               return { ok: false, message: 'Could not find the tweet card matching the requested URL.' };
           }
 
-          const buttons = Array.from(targetArticle.querySelectorAll('button,[role="button"]'));
-          const moreMenu = buttons.find((el) => visible(el) && (el.getAttribute('aria-label') || '').trim() === 'More');
+          const belongsToTargetArticle = (el) => el.closest('article') === targetArticle;
+          const buttons = Array.from(targetArticle.querySelectorAll('button,[role="button"]')).filter(belongsToTargetArticle);
+          const moreMenu = Array.from(targetArticle.querySelectorAll('[data-testid="caret"]')).filter(belongsToTargetArticle).find(visible)
+              || buttons.find((el) => visible(el) && /^More/.test((el.getAttribute('aria-label') || '').trim()));
           if (!moreMenu) {
               return { ok: false, message: 'Could not find the "More" context menu on the matched tweet. Are you sure you are logged in and looking at a valid tweet?' };
           }
 
+          const beforeMenuItems = new Set(document.querySelectorAll('[role="menuitem"]'));
           moreMenu.click();
           await new Promise(r => setTimeout(r, 1000));
 
-          const items = Array.from(document.querySelectorAll('[role="menuitem"]'));
+          const items = Array.from(document.querySelectorAll('[role="menuitem"]'))
+              .filter((item) => visible(item) && !beforeMenuItems.has(item));
           const deleteBtn = items.find((item) => {
               const text = (item.textContent || '').trim();
               return text.includes('Delete') && !text.includes('List');
@@ -69,7 +77,7 @@ cli({
         const target = parseTweetUrl(kwargs.url);
         await page.goto(target.url);
         await page.wait({ selector: '[data-testid="primaryColumn"]' }); // Wait for tweet to load completely
-        const result = await page.evaluate(buildDeleteScript(target.id));
+        const result = unwrapBrowserResult(await page.evaluate(buildDeleteScript(target.id)));
         if (result.ok) {
             // Wait for the deletion request to be processed
             await page.wait(2);

package/clis/twitter/delete.test.js

@@ -1,7 +1,8 @@
 import { describe, expect, it, vi } from 'vitest';
+import { JSDOM } from 'jsdom';
 import { ArgumentError, CommandExecutionError } from '@agentrhq/webcmd/errors';
 import { getRegistry } from '@agentrhq/webcmd/registry';
-import './delete.js';
+import { __test__ } from './delete.js';
 describe('twitter delete command', () => {
     it('targets the matched tweet article instead of the first More button on the page', async () => {
         const cmd = getRegistry().get('twitter/delete');
@@ -27,6 +28,12 @@ describe('twitter delete command', () => {
         expect(script).toContain('__twGetStatusIdFromHref');
         expect(script).toContain("document.querySelectorAll('article')");
         expect(script).toContain("targetArticle.querySelectorAll('button,[role=\"button\"]')");
+        expect(script).toContain("closest('article') === targetArticle");
+        expect(script).toContain(".filter(belongsToTargetArticle)");
+        expect(script).toContain('[data-testid="caret"]');
+        expect(script).toContain('/^More/');
+        expect(script).toContain('i < 20');
+        expect(script).toContain('beforeMenuItems');
         // Substring match must NOT appear — exact-id match only.
         expect(script).not.toContain("'/status/' + tweetId");
         expect(result).toEqual([
@@ -58,6 +65,72 @@ describe('twitter delete command', () => {
         ]);
         expect(page.wait).toHaveBeenCalledTimes(1);
     });
+    it('unwraps browser runtime evaluate envelopes before checking delete success', async () => {
+        const cmd = getRegistry().get('twitter/delete');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            wait: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({
+                session: 'twitter',
+                data: { ok: true, message: 'Tweet successfully deleted.' },
+            }),
+        };
+        const result = await cmd.func(page, {
+            url: 'https://x.com/alice/status/2040254679301718161',
+        });
+        expect(result).toEqual([
+            {
+                status: 'success',
+                message: 'Tweet successfully deleted.',
+            },
+        ]);
+        expect(page.wait).toHaveBeenNthCalledWith(2, 2);
+    });
+    it('ignores stale non-target delete menu items that existed before opening the matched tweet menu', async () => {
+        const dom = new JSDOM(`
+            <body>
+              <div role="menuitem" data-stale-delete>Delete</div>
+              <article>
+                <a href="https://x.com/bob/status/999">wrong tweet</a>
+                <button data-testid="caret" aria-label="More"></button>
+              </article>
+              <article>
+                <a href="https://x.com/alice/status/2040254679301718161">target tweet</a>
+                <button data-testid="caret" aria-label="More" data-target-caret></button>
+              </article>
+            </body>
+        `, { runScripts: 'outside-only', url: 'https://x.com/alice/status/2040254679301718161' });
+        dom.window.setTimeout = (handler) => {
+            if (typeof handler === 'function') handler();
+            return 0;
+        };
+        Object.defineProperty(dom.window.HTMLElement.prototype, 'getClientRects', {
+            configurable: true,
+            value() {
+                return [{ bottom: 1, height: 1, left: 0, right: 1, top: 0, width: 1 }];
+            },
+        });
+        let staleDeleteClicked = false;
+        let targetCaretClicked = false;
+        dom.window.document.querySelector('[data-stale-delete]')?.addEventListener('click', () => {
+            staleDeleteClicked = true;
+        });
+        dom.window.document.querySelector('[data-target-caret]')?.addEventListener('click', () => {
+            targetCaretClicked = true;
+            const item = dom.window.document.createElement('div');
+            item.setAttribute('role', 'menuitem');
+            item.textContent = 'Pin to your profile';
+            dom.window.document.body.appendChild(item);
+        });
+        const result = await dom.window.eval(__test__.buildDeleteScript('2040254679301718161'));
+        expect(targetCaretClicked).toBe(true);
+        expect(staleDeleteClicked).toBe(false);
+        expect(result).toEqual({
+            ok: false,
+            message: 'The matched tweet menu did not contain Delete. This tweet may not belong to you.',
+        });
+    });
     it('rejects malformed or off-domain URLs with ArgumentError before navigation', async () => {
         const cmd = getRegistry().get('twitter/delete');
         expect(cmd?.func).toBeTypeOf('function');

package/clis/twitter/followers.js

@@ -17,7 +17,7 @@ import { normalizeTwitterScreenName, unwrapBrowserResult } from './shared.js';
  * Strategy: subtract the i18n-variable button / badge texts from the lines of
  * `cell.innerText`, treat the first remaining `@…` line as the handle, the
  * first non-handle line as display name, and the rest as bio. We avoid
- * locale-coupled string matching (`"Follow"` / `"关注"` / `"Folgen"`).
+ * locale-coupled string matching (`"Follow"` / `"Follow"` / `"Folgen"`).
  *
  * Note: Twitter does NOT render follower COUNTS in the list view, so the
  * `followers` column is omitted from the output schema. Use

package/clis/twitter/list-remove-core.js

@@ -158,7 +158,7 @@ export async function listRemoveUser(page, kwargs) {
                 caret.click();
                 await sleep(600);
                 const menuItems = Array.from(document.querySelectorAll('[role="menuitem"]'));
-                const addToListItem = menuItems.find(el => /add\\/remove|从列表|列表|add to list|add or remove/i.test(el.innerText));
+                const addToListItem = menuItems.find(el => /add\\/remove|localized text|localized text|add to list|add or remove/i.test(el.innerText));
                 if (!addToListItem) return { ok: false, message: 'Could not find "Add/remove from Lists" menu item' };
                 addToListItem.click();
                 await sleep(1200);
@@ -221,7 +221,7 @@ export async function listRemoveUser(page, kwargs) {
                 const rowRect = listCell.getBoundingClientRect();
                 const saveButton = Array.from(dialog.querySelectorAll('[role="button"], button')).find(b => {
                     const txt = (b.innerText || '').trim();
-                    return /^(Save|Done|保存|完成|儲存)$/i.test(txt);
+                    return /^(Save|Done|localized text|localized text|localized text)$/i.test(txt);
                 });
                 const saveRect = saveButton ? saveButton.getBoundingClientRect() : null;
                 return {

package/clis/twitter/list-tweets.test.js

@@ -45,7 +45,7 @@ describe('twitter list-tweets parser', () => {
         const tweet = extractTimelineTweet({
             rest_id: '500',
             legacy: {
-                full_text: '总的来说，还是有个好爹',
+                full_text: 'Overall,family background still matters',
                 is_quote_status: true,
                 quoted_status_id_str: '499',
             },
@@ -54,7 +54,7 @@ describe('twitter list-tweets parser', () => {
                 result: {
                     rest_id: '499',
                     legacy: {
-                        full_text: '罗某官二代背景考',
+                        full_text: 'official family background review',
                         created_at: 'Wed May 13 22:00:00 +0000 2026',
                         extended_entities: {
                             media: [{ type: 'photo', media_url_https: 'https://pbs.twimg.com/media/x.jpg' }],
@@ -68,7 +68,7 @@ describe('twitter list-tweets parser', () => {
             id: '499',
             author: 'alice',
             name: 'Alice',
-            text: '罗某官二代背景考',
+            text: 'official family background review',
             created_at: 'Wed May 13 22:00:00 +0000 2026',
             url: 'https://x.com/alice/status/499',
             has_media: true,

package/clis/twitter/lists.js

@@ -63,12 +63,12 @@ export function extractListEntry(entry, seen) {
     };
 }
 
-// X 的 ListsManagementPageTimeline 把 /<user>/lists 整个页面的所有 section
-// 都塞在同一个 TimelineAddEntries instruction 里，靠 entry.entryId 前缀区分：
-//   - `owned-subscribed-list-module-*`  → 用户的 owned + subscribed list（要保留）
-//   - `list-to-follow-module-*`         → "Discover new Lists" 算法推荐（要剔除）
-//   - `cursor-*`                         → 分页游标（无 list 数据）
-// 旧版 parser 忽略 entryId 一律下钻，导致推荐 list 被当成自建/订阅泄漏出来。
+// X localized text ListsManagementPageTimeline put /<user>/lists all page section
+// into one TimelineAddEntries instruction localized text,by entry.entryId prefix distinction:
+//   - `owned-subscribed-list-module-*`  → user owned + subscribed list(should keep)
+//   - `list-to-follow-module-*`         → "Discover new Lists" algorithmic recommendations(should remove)
+//   - `cursor-*`                         → pagination cursor(none list data)
+// legacy parser ignore entryId always drill down,caused recommendations list treated as user-created/subscriptions leaked.
 const OWNED_SUBSCRIBED_ENTRY_PREFIX = 'owned-subscribed-list-module-';
 
 export function isOwnedSubscribedEntry(entry) {

package/clis/twitter/lists.test.js

@@ -109,8 +109,8 @@ describe('twitter lists parser', () => {
     });
 
     it('skips "Discover new Lists" recommendations (list-to-follow-module-*)', () => {
-        // 真实 X.com /<user>/lists 响应：Discover 推荐 + Your Lists 同 instruction，
-        // 区别只在 entry.entryId 前缀。Parser 必须按前缀剔除推荐。
+        // real X.com /<user>/lists response:Discover recommendation + Your Lists same instruction,
+        // differs only by entry.entryId prefix.Parser must filter recommendations by prefix.
         const payload = {
             data: {
                 viewer: {

package/clis/twitter/reply-dm.js

@@ -9,7 +9,7 @@ cli({
     strategy: Strategy.UI,
     browser: true,
     args: [
-        { name: 'text', type: 'string', required: true, positional: true, help: 'Message text to send (e.g. "我的微信 wxkabi")' },
+        { name: 'text', type: 'string', required: true, positional: true, help: 'Message text to send (e.g. "my messaging handle wxkabi")' },
         { name: 'max', type: 'int', required: false, default: 20, help: 'Maximum number of conversations to reply to (default: 20)' },
         { name: 'skip-replied', type: 'boolean', required: false, default: true, help: 'Skip conversations where you already sent the same text (default: true)' },
         { name: 'timeout', type: 'int', required: false, default: 600, help: 'Max seconds for the overall command (default: 600 — batch op)' },

package/clis/twitter/shared.test.js

@@ -275,8 +275,7 @@ describe('twitter parseTweetUrl', () => {
 describe('twitter buildTwitterArticleScopeSource', () => {
     // JSDOM-based tests prove the returned source actually works on real DOM —
     // mocked `evaluate` tests in adapter specs only verify the script string
-    // contains expected tokens, but cannot catch silent matching bugs (cf.
-    // dianping #1312: mocked-evaluate single tests miss in-browser logic bugs).
+    // contains expected tokens, but cannot catch silent in-browser matching bugs.
     function loadHelpers(tweetId, dom) {
         const source = buildTwitterArticleScopeSource(tweetId);
         const probe = new Function(
@@ -742,7 +741,7 @@ describe('twitter extractQuotedTweet', () => {
                 result: {
                     rest_id: '2040254679301718161',
                     legacy: {
-                        full_text: '罗某官二代背景考',
+                        full_text: 'official family background review',
                         created_at: 'Wed May 13 22:00:00 +0000 2026',
                     },
                     core: {
@@ -757,7 +756,7 @@ describe('twitter extractQuotedTweet', () => {
             id: '2040254679301718161',
             author: 'alice',
             name: 'Alice',
-            text: '罗某官二代背景考',
+            text: 'official family background review',
             created_at: 'Wed May 13 22:00:00 +0000 2026',
             url: 'https://x.com/alice/status/2040254679301718161',
             has_media: false,
@@ -773,7 +772,7 @@ describe('twitter extractQuotedTweet', () => {
                 result: {
                     rest_id: '99',
                     legacy: {
-                        full_text: '日本电车实录',
+                        full_text: 'Japanese train record',
                         extended_entities: {
                             media: [
                                 { type: 'photo', media_url_https: 'https://pbs.twimg.com/media/a.jpg' },

package/clis/twitter/timeline.js

@@ -85,6 +85,8 @@ function extractTweet(result, seen) {
         likes: l.favorite_count || 0,
         retweets: l.retweet_count || 0,
         replies: l.reply_count || 0,
+        quotes: l.quote_count || 0,
+        bookmarks: l.bookmark_count || 0,
         views,
         created_at: l.created_at || '',
         url: `https://x.com/${screenName}/status/${tw.rest_id}`,
@@ -156,7 +158,7 @@ cli({
         { name: 'limit', type: 'int', default: 20, help: 'Maximum number of tweets to return (default 20).' },
         { name: 'top-by-engagement', type: 'int', default: 0, help: 'When set to N>0, re-rank the timeline by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X\'s native ordering.' },
     ],
-    columns: ['id', 'author', 'bio', 'text', 'likes', 'retweets', 'replies', 'views', 'created_at', 'url', 'has_media', 'media_urls', 'media_posters', 'card', 'quoted_tweet'],
+    columns: ['id', 'author', 'bio', 'text', 'likes', 'retweets', 'replies', 'quotes', 'bookmarks', 'views', 'created_at', 'url', 'has_media', 'media_urls', 'media_posters', 'card', 'quoted_tweet'],
     func: async (page, kwargs) => {
         const limit = kwargs.limit || 20;
         const timelineType = kwargs.type === 'following' ? 'following' : 'for-you';

package/clis/twitter/timeline.test.js

@@ -50,6 +50,8 @@ describe('twitter timeline helpers', () => {
                                                             favorite_count: 3,
                                                             retweet_count: 2,
                                                             reply_count: 1,
+                                                            quote_count: 4,
+                                                            bookmark_count: 5,
                                                             created_at: 'now',
                                                         },
                                                         core: {
@@ -96,6 +98,8 @@ describe('twitter timeline helpers', () => {
             likes: 3,
             retweets: 2,
             replies: 1,
+            quotes: 4,
+            bookmarks: 5,
             views: 9,
             created_at: 'now',
             url: 'https://x.com/alice/status/1',

package/clis/twitter/trending.js

@@ -4,7 +4,7 @@ import { AuthRequiredError, EmptyResultError } from '@agentrhq/webcmd/errors';
 //
 // X (Twitter) removed the post-count caption from each trend cell on the
 // /explore/tabs/trending page in 2024-2025. The DOM now only carries:
-//   divs[0] = rank + category (e.g. "1 · Trending in United States")
+//   divs[0] = rank + category (e.g. "1 \u00b7 Trending in United States")
 //   divs[1] = topic
 //   divs[2..] = caret menu button (no post-count text)
 // We previously surfaced a `tweets` column whose value was permanently

package/clis/twitter/utils.js

@@ -216,7 +216,7 @@ export async function waitForComposerMediaReady(page, expectedCount = 1) {
         ).length;
         const blobCount = document.querySelectorAll('img[src^="blob:"], video[src^="blob:"]').length;
         const removeButtonCount = Array.from(document.querySelectorAll('button,[role="button"]')).filter((el) =>
-          /remove media|remove image|remove|编辑/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
+          /remove media|remove image|remove|localized text/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
         ).length;
         const explicitPreviewCount = Math.max(
           previewCount,

package/clis/web/read.js

@@ -223,7 +223,7 @@ function buildRenderAwareExtractorJs(options) {
           const section = document.createElement('section');
           section.setAttribute('data-webcmd-iframe-source', desc.src);
           const heading = document.createElement('h2');
-          heading.textContent = '来自 iframe: ' + (desc.src || fallbackLabel);
+          heading.textContent = 'localized text iframe: ' + (desc.src || fallbackLabel);
           section.appendChild(heading);
           Array.from(frameBody.childNodes).forEach(node => section.appendChild(node));
           return section;

package/clis/web/read.test.js

@@ -236,7 +236,7 @@ describe('web/read render-aware helpers', () => {
 
         expect(result.diagnostics.includedFrameCount).toBe(1);
         expect(result.contentHtml).toContain('data-webcmd-iframe-source="https://example.com/frame.html"');
-        expect(result.contentHtml).toContain('来自 iframe: https://example.com/frame.html');
+        expect(result.contentHtml).toContain('localized text iframe: https://example.com/frame.html');
         expect(result.contentHtml).toContain('Station A 42');
         expect(result.diagnostics.emptyContainers).toEqual(expect.arrayContaining([
             expect.objectContaining({ scope: 'iframe', id: 'gridDatas', url: 'https://example.com/frame.html' }),
@@ -277,7 +277,7 @@ describe('web/read render-aware helpers', () => {
         `, { url: 'https://example.com/main.html', runScripts: 'outside-only' });
         const frame = dom.window.document.querySelector('iframe');
         frame.contentDocument.open();
-        frame.contentDocument.write('<body><table id="gridHd"><tr><th>水位</th></tr><tr><td>42</td></tr></table><ul id="gridDatas"></ul></body>');
+        frame.contentDocument.write('<body><table id="gridHd"><tr><th>water level</th></tr><tr><td>42</td></tr></table><ul id="gridDatas"></ul></body>');
         frame.contentDocument.close();
 
         const result = dom.window.eval(__test__.buildRenderAwareExtractorJs({ frames: 'same-origin' }));

package/clis/yahoo-finance/quote.js

@@ -7,7 +7,7 @@ cli({
     site: 'yahoo-finance',
     name: 'quote',
     access: 'read',
-    description: 'Yahoo Finance 股票行情',
+    description: 'Yahoo Finance stock quote',
     domain: 'finance.yahoo.com',
     strategy: Strategy.COOKIE,
     args: [

package/clis/youtube/history.js

@@ -55,7 +55,7 @@ cli({
               || text(link);
             const channel =
               text(renderer.querySelector('#channel-name a'))
-              || text(renderer.querySelector('[aria-label^="前往频道："]'))
+              || text(renderer.querySelector('[aria-label^="Go to channel:"]'))
               || text(renderer.querySelector('[aria-label^="Go to channel:"]'))
               || text(renderer.querySelector('ytd-channel-name'))
               || text(renderer.querySelector('#metadata #byline-container'))
@@ -68,8 +68,8 @@ cli({
               .filter(Boolean);
             const combinedMetadata = (metadata.length ? metadata : lockupMetadata)
               .filter(value => value && value !== title && value !== '•');
-            const inferredChannel = channel || combinedMetadata.find(value => !/观看|views|前|前に|ago|次观看|次查看|stream/i.test(value)) || '';
-            const inferredViews = combinedMetadata.find(value => /观看|views/i.test(value)) || '';
+            const inferredChannel = channel || combinedMetadata.find(value => !/views|views|ago|agoに|ago|views|views|stream/i.test(value)) || '';
+            const inferredViews = combinedMetadata.find(value => /views|views/i.test(value)) || '';
             const inferredPublished = combinedMetadata.find(value => value !== inferredChannel && value !== inferredViews) || '';
             const duration =
               text(renderer.querySelector('ytd-thumbnail-overlay-time-status-renderer'))
@@ -96,7 +96,7 @@ cli({
             push({
               title,
               channel: 'Shorts',
-              views: stats.find(value => /观看|views/i.test(value)) || '',
+              views: stats.find(value => /views|views/i.test(value)) || '',
               duration: 'SHORT',
               published: '',
               url: href.startsWith('http') ? href : 'https://www.youtube.com' + href,

package/clis/youtube/transcript-group.js

@@ -7,7 +7,7 @@
  * - Speaker turns: detect ">>" markers from YouTube auto-captions
  * - Chapters: optional chapter headings inserted at appropriate timestamps
  */
-// Include CJK sentence-ending punctuation: 。！？ (fullwidth: ．！？)
+// Include CJK sentence-ending punctuation: .!? (fullwidth: ．!?)
 const SENTENCE_END = /[.!?\u3002\uFF01\uFF1F\uFF0E]["'\u2019\u201D)]*\s*$/;
 const QUESTION_END = /[?\uFF1F]["'\u2019\u201D)]*\s*$/;
 const TRANSCRIPT_GROUP_GAP_SECONDS = 20;

package/clis/youtube/transcript-group.test.js

@@ -52,14 +52,14 @@ describe('groupTranscriptSegments', () => {
     });
     it('recognizes CJK sentence-ending punctuation', () => {
         const segments = [
-            { start: 0, text: '你好世界。' },
-            { start: 2, text: '这是测试' },
-            { start: 4, text: '内容。' },
+            { start: 0, text: 'Hello world.' },
+            { start: 2, text: 'This is a test' },
+            { start: 4, text: 'content.' },
         ];
         const result = groupTranscriptSegments(segments);
         expect(result).toHaveLength(2);
-        expect(result[0].text).toBe('你好世界。');
-        expect(result[1].text).toBe('这是测试 内容。');
+        expect(result[0].text).toBe('Hello world.');
+        expect(result[1].text).toBe('This is a test content.');
     });
     it('returns empty array for empty input', () => {
         expect(groupTranscriptSegments([])).toEqual([]);

package/clis/youtube/transcript.js

@@ -444,11 +444,11 @@ cli({
         }
         if (captionData?.error) {
             const msg = `${captionData.error}${captionData.available ? ' (available: ' + captionData.available.join(', ') + ')' : ''}`;
-            // "No captions available" 是合法 empty 数据条件（作者没开字幕 + YT 没自动生成），
-            // 与 bilibili subtitle 的 EmptyResultError 同模式。下游应按 code EMPTY_RESULT 跳过
-            // 重试和 softFail 计数。其它 error（HTTP / parse / 短暂空响应）仍按 fetch 失败抛。
+            // "No captions available" is a valid empty data condition(creator disabled captions + YT no auto captions),
+            // Localized "no captions" text follows the same empty-result pattern; downstream should treat code EMPTY_RESULT as skip.
+            // retry and softFail count.other error(HTTP / parse / temporary empty response)still treat as fetch failure.
             if (captionData.error === 'No captions available for this video') {
-                throw new EmptyResultError('youtube transcript', '该视频没有字幕（作者未开启 + 无自动字幕）。');
+                throw new EmptyResultError('youtube transcript', 'This video has no captions(creator disabled captions + no automatic captions).');
             }
             throw new CommandExecutionError(msg);
         }
@@ -640,7 +640,7 @@ cli({
         }
         // Step 4: Format output based on mode
         if (mode === 'raw') {
-            // Precise timestamps in seconds with decimals, matching bilibili/subtitle format
+            // Precise timestamps in seconds with decimals, matching the subtitle segment format.
             return segments.map((seg, i) => ({
                 index: i + 1,
                 start: Number(seg.start).toFixed(2) + 's',

package/clis/youtube/video.js

@@ -114,10 +114,10 @@ cli({
           }
         } catch {}
 
-        // 播放门禁信号：会员专享（channel membership）/ 付费点播等视频 metadata 照常
-        // 可见，但视频流拿不到——playabilityStatus.status != 'OK'。reason 文本是本地化
-        // 的（中文 cookie 下是中文），所以 membersOnly 用 watch HTML 里 locale 无关的
-        // BADGE_STYLE_TYPE_MEMBERS_ONLY 徽标枚举判定，下游不要去 parse reason。
+        // playability gate signal:members-only(channel membership)/ paid video metadata as usual
+        // visible,but the video stream is unavailable——playabilityStatus.status != 'OK'.reason text is localized
+        // localized text(Chinese cookie is Chinese under this locale),so membersOnly localized text watch HTML localized text locale locale-independent
+        // BADGE_STYLE_TYPE_MEMBERS_ONLY badge enum detection,downstream should not parse reason.
         const ps = player.playabilityStatus || {};
         const membersOnly = html.indexOf('BADGE_STYLE_TYPE_MEMBERS_ONLY') !== -1;
 

package/clis/youtube/video.test.js

@@ -21,8 +21,8 @@ const videoSource = readFileSync(resolve(__dirname, 'video.js'), 'utf8');
 
 describe('youtube video source contract', () => {
   it('extracts playability gate signals inside the watch bootstrap evaluate', () => {
-    // 会员专享视频 metadata 照常可见但流不可播——playabilityStatus 是判断依据；
-    // reason 文本本地化，membersOnly 必须用 locale 无关的徽标枚举判定。
+    // members-only video metadata localized text——playabilityStatus is the decision source;
+    // reason localized text,membersOnly must use locale locale-independent badge enum detection.
     expect(videoSource).toContain('player.playabilityStatus');
     expect(videoSource).toContain('BADGE_STYLE_TYPE_MEMBERS_ONLY');
   });
@@ -39,8 +39,8 @@ describe('youtube video row mapping', () => {
 
   it('surfaces playabilityStatus / playabilityReason / membersOnly as rows', async () => {
     page.evaluate.mockResolvedValueOnce({
-      title: 'Koji杨远骋：高手如何用AI？',
-      channel: '课代表立正',
+      title: 'KojiKoji Yang:How experts useAI?',
+      channel: 'Class Notes',
       videoId: 'jgeqHyFzfIM',
       playabilityStatus: 'UNPLAYABLE',
       playabilityReason: "This video is available to this channel's members",
@@ -53,8 +53,8 @@ describe('youtube video row mapping', () => {
     expect(byField.playabilityStatus).toBe('UNPLAYABLE');
     expect(byField.membersOnly).toBe('true');
     expect(byField.playabilityReason).toContain('members');
-    // metadata 行照常返回（会员视频标题等仍可见）
-    expect(byField.title).toBe('Koji杨远骋：高手如何用AI？');
+    // metadata metadata rows still return(member video metadata remains visible)
+    expect(byField.title).toBe('KojiKoji Yang:How experts useAI?');
   });
 
   it('reports OK playability for a normal video', async () => {

package/dist/src/browser/analyze.test.js

@@ -146,24 +146,24 @@ describe('scoreEndpointEvidence', () => {
 describe('findNearestAdapter', () => {
     it('matches by domain suffix', () => {
         const reg = new Map([
-            ['51job search', mkCmd('51job', 'search', '51job.com')],
-            ['51job detail', mkCmd('51job', 'detail', '51job.com')],
-            ['xueqiu search', mkCmd('xueqiu', 'search', 'xueqiu.com')],
+            ['github search', mkCmd('github', 'search', 'github.com')],
+            ['github auth', mkCmd('github', 'auth', 'github.com')],
+            ['linkedin search', mkCmd('linkedin', 'search', 'linkedin.com')],
         ]);
-        const v = findNearestAdapter('https://jobs.51job.com/', reg);
-        expect(v?.site).toBe('51job');
-        expect(v?.example_commands).toContain('51job search');
+        const v = findNearestAdapter('https://docs.github.com/', reg);
+        expect(v?.site).toBe('github');
+        expect(v?.example_commands).toContain('github search');
     });
     it('falls back to site-name containment when no domain is registered', () => {
         const reg = new Map([
-            ['51job search', mkCmd('51job', 'search')],
+            ['github search', mkCmd('github', 'search')],
         ]);
-        const v = findNearestAdapter('https://we.51job.com/', reg);
-        expect(v?.site).toBe('51job');
+        const v = findNearestAdapter('https://gist.github.com/', reg);
+        expect(v?.site).toBe('github');
     });
     it('returns null when no adapter matches', () => {
         const reg = new Map([
-            ['xueqiu search', mkCmd('xueqiu', 'search', 'xueqiu.com')],
+            ['github search', mkCmd('github', 'search', 'github.com')],
         ]);
         const v = findNearestAdapter('https://random-site.io/', reg);
         expect(v).toBeNull();
@@ -201,9 +201,9 @@ describe('analyzeSite', () => {
     });
     it('includes nearest_adapter when the registry has a match', () => {
         const reg = new Map([
-            ['51job search', mkCmd('51job', 'search', '51job.com')],
+            ['github search', mkCmd('github', 'search', 'github.com')],
         ]);
-        const report = analyzeSite(mkSignals({ finalUrl: 'https://we.51job.com/' }), reg);
-        expect(report.nearest_adapter?.site).toBe('51job');
+        const report = analyzeSite(mkSignals({ finalUrl: 'https://github.com/features/actions' }), reg);
+        expect(report.nearest_adapter?.site).toBe('github');
     });
 });

package/dist/src/browser/bridge-readiness.d.ts

@@ -9,6 +9,6 @@ export declare function waitForBridgeReady(fetchHealth: HealthFetcher, opts: {
     contextId?: string;
     intervalMs?: number;
 }): Promise<DaemonHealth>;
-export declare const PRE_DISPATCH_ERROR_CODES: Set<"extension_not_connected" | "profile_disconnected">;
+export declare const PRE_DISPATCH_ERROR_CODES: Set<"profile_disconnected" | "extension_not_connected">;
 export type PreDispatchErrorCode = typeof PRE_DISPATCH_ERROR_CODES extends Set<infer T> ? T : never;
 export declare function isPreDispatchError(errorCode: string | undefined): boolean;

package/dist/src/browser/bridge-readiness.test.js

@@ -9,7 +9,7 @@ function status(runtimeConnected) {
         runtimeName: 'fake',
         pending: 0,
         memoryMB: 0,
-        port: 19825,
+        port: 9777,
     };
 }
 function readyHealth() {

package/dist/src/browser/bridge.d.ts

@@ -17,6 +17,7 @@ export declare class BrowserBridge implements IBrowserFactory {
         session?: string;
         idleTimeout?: number;
         contextId?: string;
+        preferredContextId?: string;
         windowMode?: 'foreground' | 'background';
         surface?: 'browser' | 'adapter';
         siteSession?: 'ephemeral' | 'persistent';