@jackwener/opencli 1.5.2 → 1.5.4

package/dist/clis/36kr/hot.js

@@ -48,7 +48,7 @@ cli({
         const url = buildHotListUrl(listType);
         await page.installInterceptor('36kr.com/api');
         await page.goto(url);
-        await page.wait(6);
+        await page.waitForCapture(6);
         // Scrape rendered article links from DOM (deduplicated)
         const domItems = await page.evaluate(`
       (() => {

package/dist/clis/36kr/search.js

@@ -21,7 +21,7 @@ cli({
         const query = encodeURIComponent(String(args.query ?? ''));
         await page.installInterceptor('36kr.com/api');
         await page.goto(`https://www.36kr.com/search/articles/${query}`);
-        await page.wait(6);
+        await page.waitForCapture(6);
         const domItems = await page.evaluate(`
       (() => {
         const seen = new Set();

package/dist/clis/_shared/common.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared utilities for CLI adapters.
+ */
+/**
+ * Clamp a numeric value to [min, max].
+ * Matches the signature of lodash.clamp and Rust's clamp.
+ */
+export declare function clamp(value: number, min: number, max: number): number;

package/dist/clis/_shared/common.js

@@ -0,0 +1,10 @@
+/**
+ * Shared utilities for CLI adapters.
+ */
+/**
+ * Clamp a numeric value to [min, max].
+ * Matches the signature of lodash.clamp and Rust's clamp.
+ */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(value, max));
+}

package/dist/clis/bloomberg/news.js

@@ -16,7 +16,7 @@ cli({
         const url = validateBloombergLink(kwargs.link);
         // Navigate and wait for the page to hydrate before extracting story data.
         await page.goto(url);
-        await page.wait(5);
+        await page.wait({ selector: 'article', timeout: 5 });
         const loadStory = async () => page.evaluate(`(() => {
       const isRobot = /Are you a robot/i.test(document.title)
         || /unusual activity/i.test(document.body.innerText)

package/dist/clis/douban/utils.js

@@ -2,14 +2,11 @@
  * Douban adapter utilities.
  */
 import { ArgumentError, CliError, EmptyResultError } from '../../errors.js';
+import { clamp } from '../_shared/common.js';
 const DOUBAN_PHOTO_PAGE_SIZE = 30;
 const MAX_DOUBAN_PHOTOS = 500;
-function clampLimit(limit) {
-    return Math.max(1, Math.min(limit || 20, 50));
-}
-function clampPhotoLimit(limit) {
-    return Math.max(1, Math.min(limit || 120, MAX_DOUBAN_PHOTOS));
-}
+const clampLimit = (limit) => clamp(limit || 20, 1, 50);
+const clampPhotoLimit = (limit) => clamp(limit || 120, 1, MAX_DOUBAN_PHOTOS);
 async function ensureDoubanReady(page) {
     const state = await page.evaluate(`
     (() => {

package/dist/clis/medium/utils.js

@@ -12,7 +12,7 @@ export async function loadMediumPosts(page, url, limit) {
     if (!page)
         throw new CommandExecutionError('Browser session required for medium posts');
     await page.goto(url);
-    await page.wait(5);
+    await page.wait({ selector: 'article', timeout: 5 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 3000));

package/dist/clis/producthunt/browse.js

@@ -29,7 +29,7 @@ cli({
         const slug = String(args.category || '').trim().toLowerCase();
         await page.installInterceptor('producthunt.com');
         await page.goto(`https://www.producthunt.com/categories/${slug}`);
-        await page.wait(5);
+        await page.waitForCapture(5);
         const domItems = await page.evaluate(`
       (() => {
         const seen = new Set();

package/dist/clis/producthunt/hot.js

@@ -20,7 +20,7 @@ cli({
         const count = Math.min(Number(args.limit) || 20, 50);
         await page.installInterceptor('producthunt.com');
         await page.goto('https://www.producthunt.com');
-        await page.wait(5);
+        await page.waitForCapture(5);
         const domItems = await page.evaluate(`
       (() => {
         const seen = new Set();

package/dist/clis/sinablog/utils.js

@@ -1,6 +1,5 @@
-function clampLimit(limit) {
-    return Math.max(1, Math.min(limit || 20, 50));
-}
+import { clamp } from '../_shared/common.js';
+const clampLimit = (limit) => clamp(limit || 20, 1, 50);
 export function buildSinaBlogSearchUrl(keyword) {
     return `https://search.sina.com.cn/search?q=${encodeURIComponent(keyword)}&tp=mix`;
 }
@@ -9,7 +8,7 @@ export function buildSinaBlogUserUrl(uid) {
 }
 export async function loadSinaBlogArticle(page, url) {
     await page.goto(url);
-    await page.wait(3);
+    await page.wait({ selector: 'h1', timeout: 3 });
     return page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 1500));
@@ -46,7 +45,7 @@ export async function loadSinaBlogArticle(page, url) {
 export async function loadSinaBlogHot(page, limit) {
     const safeLimit = clampLimit(limit);
     await page.goto('https://blog.sina.com.cn/');
-    await page.wait(3);
+    await page.wait({ selector: 'h1', timeout: 3 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 1500));
@@ -114,7 +113,7 @@ export async function loadSinaBlogHot(page, limit) {
 export async function loadSinaBlogSearch(page, keyword, limit) {
     const safeLimit = clampLimit(limit);
     await page.goto(buildSinaBlogSearchUrl(keyword));
-    await page.wait(5);
+    await page.wait({ selector: '.result-item', timeout: 5 });
     const data = await page.evaluate(`
     (async () => {
       const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -149,7 +148,7 @@ export async function loadSinaBlogSearch(page, keyword, limit) {
 export async function loadSinaBlogUser(page, uid, limit) {
     const safeLimit = clampLimit(limit);
     await page.goto(buildSinaBlogUserUrl(uid));
-    await page.wait(3);
+    await page.wait({ selector: 'h1', timeout: 3 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 1000));

package/dist/clis/substack/utils.js

@@ -9,7 +9,7 @@ export async function loadSubstackFeed(page, url, limit) {
     if (!page)
         throw new CommandExecutionError('Browser session required for substack feed');
     await page.goto(url);
-    await page.wait(5);
+    await page.wait({ selector: 'article', timeout: 5 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 3000));
@@ -77,7 +77,7 @@ export async function loadSubstackArchive(page, baseUrl, limit) {
     if (!page)
         throw new CommandExecutionError('Browser session required for substack archive');
     await page.goto(`${baseUrl}/archive`);
-    await page.wait(5);
+    await page.wait({ selector: 'article', timeout: 5 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 3000));

package/dist/clis/twitter/block.js

@@ -16,7 +16,7 @@ cli({
             throw new CommandExecutionError('Browser session required for twitter block');
         const username = kwargs.username.replace(/^@/, '');
         await page.goto(`https://x.com/${username}`);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/twitter/bookmark.js

@@ -15,7 +15,7 @@ cli({
         if (!page)
             throw new CommandExecutionError('Browser session required for twitter bookmark');
         await page.goto(kwargs.url);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/twitter/delete.js

@@ -15,7 +15,7 @@ cli({
         if (!page)
             throw new CommandExecutionError('Browser session required for twitter delete');
         await page.goto(kwargs.url);
-        await page.wait(5); // Wait for tweet to load completely
+        await page.wait({ selector: '[data-testid="primaryColumn"]' }); // Wait for tweet to load completely
         const result = await page.evaluate(`(async () => {
         try {
             // Wait for caret button (which has 'More' aria-label) within the main tweet body

package/dist/clis/twitter/follow.js

@@ -16,7 +16,7 @@ cli({
             throw new CommandExecutionError('Browser session required for twitter follow');
         const username = kwargs.username.replace(/^@/, '');
         await page.goto(`https://x.com/${username}`);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/twitter/followers.js

@@ -17,7 +17,7 @@ cli({
         // If no user is specified, figure out the logged-in user's handle
         if (!targetUser) {
             await page.goto('https://x.com/home');
-            await page.wait(5);
+            await page.wait({ selector: '[data-testid="primaryColumn"]' });
             const href = await page.evaluate(`() => {
             const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
             return link ? link.getAttribute('href') : null;
@@ -51,7 +51,7 @@ cli({
         if (!clicked) {
             throw new SelectorError('Twitter followers link', 'Twitter may have changed the layout.');
         }
-        await page.wait(5);
+        await page.waitForCapture(5);
         // 4. Scroll to trigger pagination API calls
         await page.autoScroll({ times: Math.ceil(kwargs.limit / 20), delayMs: 2000 });
         // 5. Retrieve intercepted data

package/dist/clis/twitter/following.js

@@ -17,7 +17,7 @@ cli({
         // If no user is specified, figure out the logged-in user's handle
         if (!targetUser) {
             await page.goto('https://x.com/home');
-            await page.wait(5);
+            await page.wait({ selector: '[data-testid="primaryColumn"]' });
             const href = await page.evaluate(`() => {
             const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
             return link ? link.getAttribute('href') : null;
@@ -44,7 +44,7 @@ cli({
         if (!clicked) {
             throw new SelectorError('Twitter following link', 'Twitter may have changed the layout.');
         }
-        await page.wait(5);
+        await page.waitForCapture(5);
         // 4. Scroll to trigger pagination API calls
         await page.autoScroll({ times: Math.ceil(kwargs.limit / 20), delayMs: 2000 });
         // 5. Retrieve intercepted data

package/dist/clis/twitter/hide-reply.js

@@ -15,7 +15,7 @@ cli({
         if (!page)
             throw new CommandExecutionError('Browser session required for twitter hide-reply');
         await page.goto(kwargs.url);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/twitter/like.js

@@ -15,7 +15,7 @@ cli({
         if (!page)
             throw new CommandExecutionError('Browser session required for twitter like');
         await page.goto(kwargs.url);
-        await page.wait(5); // Wait for tweet to load completely
+        await page.wait({ selector: '[data-testid="primaryColumn"]' }); // Wait for tweet to load completely
         const result = await page.evaluate(`(async () => {
         try {
             // Poll for the tweet to render

package/dist/clis/twitter/notifications.js

@@ -22,7 +22,7 @@ cli({
         window.history.pushState({}, '', '/notifications');
         window.dispatchEvent(new PopStateEvent('popstate', { state: {} }));
     }`);
-        await page.wait(5);
+        await page.waitForCapture(5);
         // Verify SPA navigation succeeded
         const currentUrl = await page.evaluate('() => window.location.pathname');
         if (currentUrl !== '/notifications') {

package/dist/clis/twitter/profile.js

@@ -18,7 +18,7 @@ cli({
         // If no username, detect the logged-in user
         if (!username) {
             await page.goto('https://x.com/home');
-            await page.wait(5);
+            await page.wait({ selector: '[data-testid="primaryColumn"]' });
             const href = await page.evaluate(`() => {
         const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
         return link ? link.getAttribute('href') : null;

package/dist/clis/twitter/reply-dm.js

@@ -24,7 +24,7 @@ cli({
         let sentCount = 0;
         // Step 1: Navigate to messages to get conversation list
         await page.goto('https://x.com/messages');
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         // Step 2: Collect conversations with scroll-to-load
         const needed = maxSend + 10; // extra buffer for skips
         const convList = await page.evaluate(`(async () => {

package/dist/clis/twitter/reply.js

@@ -17,7 +17,7 @@ cli({
             throw new CommandExecutionError('Browser session required for twitter reply');
         // 1. Navigate to the tweet page
         await page.goto(kwargs.url);
-        await page.wait(5); // Wait for the react application to hydrate
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         // 2. Automate typing the reply and clicking reply
         const result = await page.evaluate(`(async () => {
         try {

package/dist/clis/twitter/search.js

@@ -17,7 +17,7 @@ async function navigateToSearch(page, query, filter) {
         window.dispatchEvent(new PopStateEvent('popstate', { state: {} }));
       })()
     `);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         lastPath = String(await page.evaluate('() => window.location.pathname') || '');
         if (lastPath.startsWith('/search')) {
             return;

package/dist/clis/twitter/unblock.js

@@ -16,7 +16,7 @@ cli({
             throw new CommandExecutionError('Browser session required for twitter unblock');
         const username = kwargs.username.replace(/^@/, '');
         await page.goto(`https://x.com/${username}`);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/twitter/unbookmark.js

@@ -15,7 +15,7 @@ cli({
         if (!page)
             throw new CommandExecutionError('Browser session required for twitter unbookmark');
         await page.goto(kwargs.url);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/twitter/unfollow.js

@@ -16,7 +16,7 @@ cli({
             throw new CommandExecutionError('Browser session required for twitter unfollow');
         const username = kwargs.username.replace(/^@/, '');
         await page.goto(`https://x.com/${username}`);
-        await page.wait(5);
+        await page.wait({ selector: '[data-testid="primaryColumn"]' });
         const result = await page.evaluate(`(async () => {
         try {
             let attempts = 0;

package/dist/clis/xiaohongshu/comments.test.js

@@ -24,6 +24,7 @@ function createPageMock(evaluateResult) {
         getInterceptedRequests: vi.fn().mockResolvedValue([]),
         getCookies: vi.fn().mockResolvedValue([]),
         screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
     };
 }
 describe('xiaohongshu comments', () => {

package/dist/clis/xiaohongshu/creator-note-detail.test.js

@@ -30,6 +30,7 @@ function createPageMock(evaluateResult) {
         getInterceptedRequests: vi.fn().mockResolvedValue([]),
         getCookies: vi.fn().mockResolvedValue([]),
         screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
     };
 }
 describe('xiaohongshu creator-note-detail', () => {

package/dist/clis/xiaohongshu/creator-notes.test.js

@@ -33,6 +33,7 @@ function createPageMock(evaluateResult, interceptedRequests = []) {
         getInterceptedRequests,
         getCookies: vi.fn().mockResolvedValue([]),
         screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
     };
 }
 describe('xiaohongshu creator-notes', () => {

package/dist/clis/xiaohongshu/publish.test.js

@@ -31,6 +31,7 @@ function createPageMock(evaluateResults) {
         getInterceptedRequests: vi.fn().mockResolvedValue([]),
         getCookies: vi.fn().mockResolvedValue([]),
         screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
     };
 }
 describe('xiaohongshu publish', () => {

package/dist/clis/xiaohongshu/search.test.js

@@ -28,6 +28,7 @@ function createPageMock(evaluateResults) {
         getInterceptedRequests: vi.fn().mockResolvedValue([]),
         getCookies: vi.fn().mockResolvedValue([]),
         screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
     };
 }
 describe('xiaohongshu search', () => {

package/dist/daemon.js

@@ -90,7 +90,20 @@ async function handleRequest(req, res) {
         res.end();
         return;
     }
-    // Require custom header on all HTTP requests.  Browsers cannot attach
+    const url = req.url ?? '/';
+    const pathname = url.split('?')[0];
+    // Health-check endpoint — no X-OpenCLI header required.
+    // Used by the extension to silently probe daemon reachability before
+    // attempting a WebSocket connection (avoids uncatchable ERR_CONNECTION_REFUSED).
+    // Security note: this endpoint is reachable by any client that passes the
+    // origin check above (chrome-extension:// or no Origin header, e.g. curl).
+    // Timing side-channels can reveal daemon presence to local processes, which
+    // is an accepted risk given the daemon is loopback-only and short-lived.
+    if (req.method === 'GET' && pathname === '/ping') {
+        jsonResponse(res, 200, { ok: true });
+        return;
+    }
+    // Require custom header on all other HTTP requests.  Browsers cannot attach
     // custom headers in "simple" requests, and our preflight returns no
     // Access-Control-Allow-Headers, so scripted fetch() from web pages is
     // blocked even if Origin check is somehow bypassed.
@@ -98,8 +111,6 @@ async function handleRequest(req, res) {
         jsonResponse(res, 403, { ok: false, error: 'Forbidden: missing X-OpenCLI header' });
         return;
     }
-    const url = req.url ?? '/';
-    const pathname = url.split('?')[0];
     if (req.method === 'GET' && pathname === '/status') {
         jsonResponse(res, 200, {
             ok: true,

package/dist/download/index.js

@@ -4,14 +4,13 @@
 import { spawn } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import * as https from 'node:https';
-import * as http from 'node:http';
 import * as os from 'node:os';
-import { Transform } from 'node:stream';
+import { Readable, Transform } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { URL } from 'node:url';
 import { isBinaryInstalled } from '../external.js';
 import { getErrorMessage } from '../errors.js';
+import { fetchWithNodeNetwork } from '../node-network.js';
 /** Check if yt-dlp is available in PATH. */
 export function checkYtdlp() {
     return isBinaryInstalled('yt-dlp');
@@ -61,8 +60,6 @@ export function requiresYtdlp(url) {
 export async function httpDownload(url, destPath, options = {}, redirectCount = 0) {
     const { cookies, headers = {}, timeout = 30000, onProgress, maxRedirects = 10 } = options;
     return new Promise((resolve) => {
-        const parsedUrl = new URL(url);
-        const protocol = parsedUrl.protocol === 'https:' ? https : http;
         const requestHeaders = {
             'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36',
             ...headers,
@@ -86,30 +83,43 @@ export async function httpDownload(url, destPath, options = {}, redirectCount =
                 // Ignore cleanup errors so the original failure is preserved.
             }
         };
-        const request = protocol.get(url, { headers: requestHeaders, timeout }, (response) => {
-            void (async () => {
+        void (async () => {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeout);
+            try {
+                const response = await fetchWithNodeNetwork(url, {
+                    headers: requestHeaders,
+                    signal: controller.signal,
+                    redirect: 'manual',
+                });
+                clearTimeout(timer);
                 // Handle redirects before creating any file handles.
-                if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
-                    response.resume();
-                    if (redirectCount >= maxRedirects) {
-                        finish({ success: false, size: 0, error: `Too many redirects (> ${maxRedirects})` });
+                if (response.status >= 300 && response.status < 400) {
+                    const location = response.headers.get('location');
+                    if (location) {
+                        if (redirectCount >= maxRedirects) {
+                            finish({ success: false, size: 0, error: `Too many redirects (> ${maxRedirects})` });
+                            return;
+                        }
+                        const redirectUrl = resolveRedirectUrl(url, location);
+                        const originalHost = new URL(url).hostname;
+                        const redirectHost = new URL(redirectUrl).hostname;
+                        const redirectOptions = originalHost === redirectHost
+                            ? options
+                            : { ...options, cookies: undefined, headers: stripCookieHeaders(options.headers) };
+                        finish(await httpDownload(redirectUrl, destPath, redirectOptions, redirectCount + 1));
                         return;
                     }
-                    const redirectUrl = resolveRedirectUrl(url, response.headers.location);
-                    const originalHost = new URL(url).hostname;
-                    const redirectHost = new URL(redirectUrl).hostname;
-                    const redirectOptions = originalHost === redirectHost
-                        ? options
-                        : { ...options, cookies: undefined, headers: stripCookieHeaders(options.headers) };
-                    finish(await httpDownload(redirectUrl, destPath, redirectOptions, redirectCount + 1));
+                }
+                if (response.status !== 200) {
+                    finish({ success: false, size: 0, error: `HTTP ${response.status}` });
                     return;
                 }
-                if (response.statusCode !== 200) {
-                    response.resume();
-                    finish({ success: false, size: 0, error: `HTTP ${response.statusCode}` });
+                if (!response.body) {
+                    finish({ success: false, size: 0, error: 'Empty response body' });
                     return;
                 }
-                const totalSize = parseInt(response.headers['content-length'] || '0', 10);
+                const totalSize = parseInt(response.headers.get('content-length') || '0', 10);
                 let received = 0;
                 const progressStream = new Transform({
                     transform(chunk, _encoding, callback) {
@@ -121,7 +131,7 @@ export async function httpDownload(url, destPath, options = {}, redirectCount =
                 });
                 try {
                     await fs.promises.mkdir(path.dirname(destPath), { recursive: true });
-                    await pipeline(response, progressStream, fs.createWriteStream(tempPath));
+                    await pipeline(Readable.fromWeb(response.body), progressStream, fs.createWriteStream(tempPath));
                     await fs.promises.rename(tempPath, destPath);
                     finish({ success: true, size: received });
                 }
@@ -129,17 +139,13 @@ export async function httpDownload(url, destPath, options = {}, redirectCount =
                     await cleanupTempFile();
                     finish({ success: false, size: 0, error: getErrorMessage(err) });
                 }
-            })();
-        });
-        request.on('error', (err) => {
-            void (async () => {
+            }
+            catch (err) {
+                clearTimeout(timer);
                 await cleanupTempFile();
-                finish({ success: false, size: 0, error: err.message });
-            })();
-        });
-        request.on('timeout', () => {
-            request.destroy(new Error('Timeout'));
-        });
+                finish({ success: false, size: 0, error: err instanceof Error ? err.message : String(err) });
+            }
+        })();
     });
 }
 export function resolveRedirectUrl(currentUrl, location) {

package/dist/download/index.test.js

@@ -2,11 +2,12 @@ import * as fs from 'node:fs';
 import * as http from 'node:http';
 import * as os from 'node:os';
 import * as path from 'node:path';
-import { afterEach, describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
 import { formatCookieHeader, httpDownload, resolveRedirectUrl } from './index.js';
 const servers = [];
 const tempDirs = [];
 afterEach(async () => {
+    vi.unstubAllEnvs();
     await Promise.all(servers.map((server) => new Promise((resolve, reject) => {
         server.close((err) => (err ? reject(err) : resolve()));
     })));
@@ -101,4 +102,17 @@ describe('download helpers', { retry: process.platform === 'win32' ? 2 : 0 }, ()
         expect(forwardedCookie).toBeUndefined();
         expect(fs.readFileSync(destPath, 'utf8')).toBe('ok');
     });
+    it('bypasses proxy settings for loopback downloads', async () => {
+        vi.stubEnv('HTTP_PROXY', 'http://127.0.0.1:9');
+        const baseUrl = await startServer((_req, res) => {
+            res.statusCode = 200;
+            res.end('ok');
+        });
+        const tempDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'opencli-dl-'));
+        tempDirs.push(tempDir);
+        const destPath = path.join(tempDir, 'loopback.txt');
+        const result = await httpDownload(`${baseUrl}/ok`, destPath);
+        expect(result).toEqual({ success: true, size: 2 });
+        expect(fs.readFileSync(destPath, 'utf8')).toBe('ok');
+    });
 });

package/dist/execution.js

@@ -17,6 +17,7 @@ import { shouldUseBrowserSession } from './capabilityRouting.js';
 import { getBrowserFactory, browserSession, runWithTimeout, DEFAULT_BROWSER_COMMAND_TIMEOUT } from './runtime.js';
 import { emitHook } from './hooks.js';
 import { checkDaemonStatus } from './browser/discover.js';
+import { log } from './logger.js';
 const _loadedModules = new Set();
 export function coerceAndValidateArgs(cmdArgs, kwargs) {
     const result = { ...kwargs };
@@ -167,7 +168,7 @@ export async function executeCommand(cmd, rawKwargs, debug = false) {
                     const skip = await isAlreadyOnDomain(page, preNavUrl);
                     if (skip) {
                         if (debug)
-                            console.error(`[pre-nav] Already on target domain, skipping navigation`);
+                            log.debug('[pre-nav] Already on target domain, skipping navigation');
                     }
                     else {
                         try {
@@ -177,7 +178,7 @@ export async function executeCommand(cmd, rawKwargs, debug = false) {
                         }
                         catch (err) {
                             if (debug)
-                                console.error(`[pre-nav] Failed to navigate to ${preNavUrl}: ${err instanceof Error ? err.message : err}`);
+                                log.debug(`[pre-nav] Failed to navigate to ${preNavUrl}: ${err instanceof Error ? err.message : err}`);
                         }
                     }
                 }

package/dist/external-clis.yaml

@@ -21,3 +21,19 @@
   tags: [docker, containers, devops]
   install:
     mac: "brew install --cask docker"
+
+- name: lark-cli
+  binary: lark-cli
+  description: "Lark/Feishu CLI — messages, documents, spreadsheets, calendar, tasks and 200+ commands for AI agents"
+  homepage: "https://github.com/larksuite/cli"
+  tags: [lark, feishu, collaboration, productivity, ai-agent]
+  install:
+    default: "npm install -g @larksuite/cli"
+
+- name: vercel
+  binary: vercel
+  description: "Vercel CLI — deploy projects, manage domains, env vars, logs and serverless functions"
+  homepage: "https://vercel.com/docs/cli"
+  tags: [vercel, deployment, serverless, frontend, devops]
+  install:
+    default: "npm install -g vercel"

package/dist/main.js

@@ -19,7 +19,9 @@ import { discoverClis, discoverPlugins } from './discovery.js';
 import { getCompletions } from './completion.js';
 import { runCli } from './cli.js';
 import { emitHook } from './hooks.js';
+import { installNodeNetwork } from './node-network.js';
 import { registerUpdateNoticeOnExit, checkForUpdateBackground } from './update-check.js';
+installNodeNetwork();
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const BUILTIN_CLIS = path.resolve(__dirname, 'clis');