@agentrhq/webcmd 0.1.2 → 0.2.0

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/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/daemon-client.d.ts

@@ -5,6 +5,7 @@
  */
 import { fetchDaemonStatus, getDaemonHealth, requestDaemonShutdown, type BrowserProfileStatus, type DaemonHealth, type DaemonStatus } from './daemon-transport.js';
 import type { BrowserRuntimeCommand, BrowserRuntimeResult } from './protocol.js';
+export declare function setDaemonCommandTimeoutSeconds(seconds: number | null): void;
 export type DaemonCommand = BrowserRuntimeCommand;
 export type DaemonResult = BrowserRuntimeResult;
 export declare class BrowserCommandError extends Error {

package/dist/src/browser/daemon-client.js

@@ -5,6 +5,7 @@
  */
 import { sleep } from '../utils.js';
 import { BrowserConnectError } from '../errors.js';
+import { COMMAND_RESULT_UNKNOWN_CODE, COMMAND_RESULT_UNKNOWN_HINT } from '../daemon-utils.js';
 import { classifyBrowserError } from './errors.js';
 import { resolveProfileContextId } from './profile.js';
 import { DEFAULT_BROWSER_CONNECT_TIMEOUT } from './config.js';
@@ -15,6 +16,51 @@ let _idCounter = 0;
 function generateId() {
     return `cmd_${process.pid}_${Date.now()}_${++_idCounter}`;
 }
+const DEFAULT_COMMAND_TIMEOUT_SECONDS = 120;
+const RUNTIME_OP_TIMEOUT_MARGIN_MS = 15_000;
+const HTTP_TIMEOUT_MARGIN_MS = 10_000;
+const TRANSPORT_MAX_ATTEMPTS = 4;
+let _userCommandTimeoutSeconds = null;
+export function setDaemonCommandTimeoutSeconds(seconds) {
+    _userCommandTimeoutSeconds = typeof seconds === 'number' && seconds > 0 ? Math.ceil(seconds) : null;
+}
+function effectiveCommandTimeoutSeconds(params) {
+    const base = _userCommandTimeoutSeconds ?? DEFAULT_COMMAND_TIMEOUT_SECONDS;
+    if (typeof params.timeoutMs === 'number' && params.timeoutMs > 0) {
+        return Math.max(base, Math.ceil((params.timeoutMs + RUNTIME_OP_TIMEOUT_MARGIN_MS) / 1000));
+    }
+    return base;
+}
+const UNKNOWN_OUTCOME_CODES = new Set([
+    COMMAND_RESULT_UNKNOWN_CODE,
+    'command_lost',
+    'result_evicted',
+]);
+const PRE_CONNECT_ERROR_CODES = new Set([
+    'ECONNREFUSED',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'ENOTFOUND',
+]);
+function isPreConnectFetchError(err) {
+    const queue = [err];
+    const seen = new Set();
+    while (queue.length) {
+        const current = queue.pop();
+        if (!current || typeof current !== 'object' || seen.has(current))
+            continue;
+        seen.add(current);
+        const { code, cause, errors } = current;
+        if (typeof code === 'string' && PRE_CONNECT_ERROR_CODES.has(code))
+            return true;
+        if (cause)
+            queue.push(cause);
+        if (Array.isArray(errors))
+            queue.push(...errors);
+    }
+    return false;
+}
 export class BrowserCommandError extends Error {
     code;
     hint;
@@ -30,58 +76,75 @@ export { fetchDaemonStatus, getDaemonHealth, requestDaemonShutdown, };
  * Internal: send a command to the daemon and return the raw `DaemonResult`.
  *
  * Retry policy is explicit:
- * - pre-dispatch bridge/profile errors: run the full daemon/runtime ensure
- *   path, then resend with a fresh transport id;
- * - local TypeError before dispatch: same full ensure path, because the daemon
- *   may be stopped/stale and needs spawn/replacement, not just polling;
- * - `command_result_unknown` and AbortError: never retry automatically.
+ * - pre-dispatch bridge/profile errors and pre-connect fetch failures run the
+ *   full daemon/runtime ensure path, then resend the same command id;
+ * - executor-transient errors that happened before page code ran get one new
+ *   logical attempt with a fresh id;
+ * - `command_result_unknown`, duplicate pending ids from old daemons,
+ *   post-connect drops, and AbortError are never retried automatically.
  */
 async function sendCommandRaw(action, params) {
-    const maxAttempts = 4;
-    let dispatchRecoveryUsed = false;
-    let duplicateIdRetryUsed = false;
-    let transientRetryUsed = false;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-        const id = generateId();
-        const rawWindowMode = process.env.WEBCMD_WINDOW;
-        const envWindowMode = rawWindowMode === 'foreground' || rawWindowMode === 'background'
-            ? rawWindowMode
-            : undefined;
-        const contextId = params.contextId ?? resolveProfileContextId();
-        const windowMode = params.windowMode ?? envWindowMode;
-        const command = { id, action, ...params, ...(contextId && { contextId }), ...(windowMode && { windowMode }) };
+    const timeoutSeconds = effectiveCommandTimeoutSeconds(params);
+    const deadlineAt = Date.now() + timeoutSeconds * 1000;
+    const rawWindowMode = process.env.WEBCMD_WINDOW;
+    const envWindowMode = rawWindowMode === 'foreground' || rawWindowMode === 'background'
+        ? rawWindowMode
+        : undefined;
+    const contextId = params.contextId ?? resolveProfileContextId();
+    const windowMode = params.windowMode ?? envWindowMode;
+    let id = generateId();
+    let ensureUsed = false;
+    let semanticRetryUsed = false;
+    const ensureBridge = async () => {
+        const remainingSeconds = Math.ceil((deadlineAt - Date.now()) / 1000);
+        await ensureBrowserBridgeReady({
+            timeoutSeconds: Math.max(1, Math.min(DEFAULT_BROWSER_CONNECT_TIMEOUT, remainingSeconds)),
+            contextId,
+            verbose: false,
+        });
+    };
+    for (let attempt = 1; attempt <= TRANSPORT_MAX_ATTEMPTS; attempt++) {
+        if (attempt > 1 && Date.now() >= deadlineAt) {
+            throw new BrowserCommandError('Browser command deadline exhausted across transport retries.', COMMAND_RESULT_UNKNOWN_CODE, COMMAND_RESULT_UNKNOWN_HINT);
+        }
+        const remainingMs = Math.max(1000, deadlineAt - Date.now());
+        const command = {
+            id,
+            action,
+            ...params,
+            timeout: timeoutSeconds,
+            deadlineAt,
+            ...(contextId && { contextId }),
+            ...(windowMode && { windowMode }),
+        };
         try {
             const res = await requestDaemon('/command', {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify(command),
-                timeout: 30000,
+                timeout: remainingMs + HTTP_TIMEOUT_MARGIN_MS,
             });
             const result = (await res.json());
             if (result.ok)
                 return result;
-            if (result.errorCode === 'command_result_unknown') {
+            if (result.errorCode && UNKNOWN_OUTCOME_CODES.has(result.errorCode)) {
                 throw new BrowserCommandError(result.error ?? 'Browser command result is unknown', result.errorCode, result.errorHint);
             }
-            if (!dispatchRecoveryUsed && isPreDispatchError(result.errorCode)) {
-                dispatchRecoveryUsed = true;
-                await ensureBrowserBridgeReady({
-                    timeoutSeconds: DEFAULT_BROWSER_CONNECT_TIMEOUT,
-                    contextId,
-                    verbose: false,
-                });
-                continue;
-            }
             const isDuplicateCommandId = res.status === 409
                 && !result.errorCode
                 && (result.error ?? '').includes('Duplicate command id');
-            if (isDuplicateCommandId && !duplicateIdRetryUsed) {
-                duplicateIdRetryUsed = true;
+            if (isDuplicateCommandId) {
+                throw new BrowserCommandError('Daemon already has this command id pending; the command may already be running.', COMMAND_RESULT_UNKNOWN_CODE, COMMAND_RESULT_UNKNOWN_HINT);
+            }
+            if (isPreDispatchError(result.errorCode) && !ensureUsed) {
+                ensureUsed = true;
+                await ensureBridge();
                 continue;
             }
-            const advice = classifyBrowserError(new Error(result.error ?? ''));
-            if (advice.retryable && !transientRetryUsed) {
-                transientRetryUsed = true;
+            const advice = classifyBrowserError(new BrowserCommandError(result.error ?? '', result.errorCode));
+            if (advice.kind === 'extension-transient' && !semanticRetryUsed) {
+                semanticRetryUsed = true;
+                id = generateId();
                 await sleep(advice.delayMs);
                 continue;
             }
@@ -91,24 +154,13 @@ async function sendCommandRaw(action, params) {
             if (err instanceof BrowserCommandError || err instanceof BrowserConnectError)
                 throw err;
             if (err instanceof Error && err.name === 'AbortError') {
-                throw new BrowserCommandError('Browser command timed out client-side; the page may still have applied it.', 'command_result_unknown', 'Inspect the page state before retrying. Idempotent reads are safe to retry; non-idempotent writes may have already happened.');
-            }
-            if (!dispatchRecoveryUsed && err instanceof TypeError) {
-                dispatchRecoveryUsed = true;
-                await ensureBrowserBridgeReady({
-                    timeoutSeconds: DEFAULT_BROWSER_CONNECT_TIMEOUT,
-                    contextId,
-                    verbose: false,
-                });
-                continue;
+                throw new BrowserCommandError('Browser command timed out client-side; the page may still have applied it.', COMMAND_RESULT_UNKNOWN_CODE, COMMAND_RESULT_UNKNOWN_HINT);
             }
-            if (err instanceof Error) {
-                const advice = classifyBrowserError(err);
-                if (advice.retryable && !transientRetryUsed) {
-                    transientRetryUsed = true;
-                    await sleep(advice.delayMs);
+            if (err instanceof TypeError) {
+                await ensureBridge();
+                if (isPreConnectFetchError(err))
                     continue;
-                }
+                throw new BrowserCommandError('Connection to the daemon was lost mid-command; it may have already been applied.', COMMAND_RESULT_UNKNOWN_CODE, COMMAND_RESULT_UNKNOWN_HINT);
             }
             throw err;
         }