@jackwener/opencli 1.6.10 → 1.7.1

package/clis/xueqiu/hot.js

@@ -0,0 +1,36 @@
+import { cli } from '@jackwener/opencli/registry';
+import { fetchXueqiuJson } from './utils.js';
+function strip(html) {
+    return (html || '')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .trim();
+}
+cli({
+    site: 'xueqiu',
+    name: 'hot',
+    description: '获取雪球热门动态',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: '返回数量，默认 20，最大 50' },
+    ],
+    columns: ['rank', 'author', 'text', 'likes', 'url'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const d = await fetchXueqiuJson(page, 'https://xueqiu.com/statuses/hot/listV3.json?source=hot&page=1');
+        return (d.list || []).slice(0, kwargs.limit).map((item, i) => {
+            const user = item.user || {};
+            return {
+                rank: i + 1,
+                author: user.screen_name,
+                text: strip(item.description).substring(0, 200),
+                likes: item.fav_count,
+                url: 'https://xueqiu.com/' + user.id + '/' + item.id,
+            };
+        });
+    },
+});

package/clis/xueqiu/kline.js

@@ -0,0 +1,43 @@
+import { cli } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'kline',
+    description: '获取雪球股票K线（历史行情）数据',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'symbol',
+            required: true,
+            positional: true,
+            help: '股票代码，如 SH600519、SZ000858、AAPL',
+        },
+        { name: 'days', type: 'int', default: 14, help: '回溯天数（默认14天）' },
+    ],
+    columns: ['date', 'open', 'high', 'low', 'close', 'volume'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const symbol = String(kwargs.symbol).toUpperCase();
+        const days = kwargs.days;
+        const beginTs = Date.now();
+        const url = `https://stock.xueqiu.com/v5/stock/chart/kline.json?symbol=${encodeURIComponent(symbol)}&begin=${beginTs}&period=day&type=before&count=-${days}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.item?.length)
+            throw new EmptyResultError('xueqiu/kline', '请确认股票代码是否正确: ' + symbol);
+        const columns = d.data.column || [];
+        const colIdx = {};
+        columns.forEach((name, i) => { colIdx[name] = i; });
+        return d.data.item.map(row => ({
+            date: colIdx.timestamp != null ? new Date(row[colIdx.timestamp]).toISOString().split('T')[0] : null,
+            open: row[colIdx.open] ?? null,
+            high: row[colIdx.high] ?? null,
+            low: row[colIdx.low] ?? null,
+            close: row[colIdx.close] ?? null,
+            volume: row[colIdx.volume] ?? null,
+            percent: row[colIdx.percent] ?? null,
+            symbol,
+        }));
+    },
+});

package/clis/xueqiu/search.js

@@ -0,0 +1,36 @@
+import { cli } from '@jackwener/opencli/registry';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'search',
+    description: '搜索雪球股票（代码或名称）',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        { name: 'query', required: true, positional: true, help: '搜索关键词，如 茅台、AAPL、腾讯' },
+        { name: 'limit', type: 'int', default: 10, help: '返回数量，默认 10' },
+    ],
+    columns: ['symbol', 'name', 'exchange', 'price', 'changePercent', 'url'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const url = `https://xueqiu.com/stock/search.json?code=${encodeURIComponent(String(kwargs.query))}&size=${kwargs.limit}`;
+        const d = await fetchXueqiuJson(page, url);
+        return (d.stocks || []).slice(0, kwargs.limit).map((s) => {
+            let symbol = '';
+            if (s.exchange === 'SH' || s.exchange === 'SZ' || s.exchange === 'BJ') {
+                symbol = s.code.startsWith(s.exchange) ? s.code : s.exchange + s.code;
+            }
+            else {
+                symbol = s.code;
+            }
+            return {
+                symbol,
+                name: s.name,
+                exchange: s.exchange,
+                price: s.current,
+                changePercent: s.percentage != null ? s.percentage.toFixed(2) + '%' : null,
+                url: 'https://xueqiu.com/S/' + symbol,
+            };
+        });
+    },
+});

package/clis/xueqiu/stock.js

@@ -0,0 +1,64 @@
+import { cli } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+function fmtAmount(v) {
+    if (v == null)
+        return null;
+    if (Math.abs(v) >= 1e12)
+        return (v / 1e12).toFixed(2) + '万亿';
+    if (Math.abs(v) >= 1e8)
+        return (v / 1e8).toFixed(2) + '亿';
+    if (Math.abs(v) >= 1e4)
+        return (v / 1e4).toFixed(2) + '万';
+    return String(v);
+}
+cli({
+    site: 'xueqiu',
+    name: 'stock',
+    description: '获取雪球股票实时行情',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'symbol',
+            required: true,
+            positional: true,
+            help: '股票代码，如 SH600519、SZ000858、AAPL、00700',
+        },
+    ],
+    columns: ['name', 'symbol', 'price', 'changePercent', 'marketCap'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const symbol = String(kwargs.symbol).toUpperCase();
+        const url = `https://stock.xueqiu.com/v5/stock/batch/quote.json?symbol=${encodeURIComponent(symbol)}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.items?.length)
+            throw new EmptyResultError('xueqiu/stock', '请确认股票代码是否正确: ' + symbol);
+        const item = d.data.items[0];
+        const q = item.quote || {};
+        const m = item.market || {};
+        return [{
+                name: q.name,
+                symbol: q.symbol,
+                exchange: q.exchange,
+                currency: q.currency,
+                price: q.current,
+                change: q.chg,
+                changePercent: q.percent != null ? q.percent.toFixed(2) + '%' : null,
+                open: q.open,
+                high: q.high,
+                low: q.low,
+                prevClose: q.last_close,
+                amplitude: q.amplitude != null ? q.amplitude.toFixed(2) + '%' : null,
+                volume: q.volume,
+                amount: fmtAmount(q.amount),
+                turnover_rate: q.turnover_rate != null ? q.turnover_rate.toFixed(2) + '%' : null,
+                marketCap: fmtAmount(q.market_capital),
+                floatMarketCap: fmtAmount(q.float_market_capital),
+                ytdPercent: q.current_year_percent != null ? q.current_year_percent.toFixed(2) + '%' : null,
+                market_status: m.status || null,
+                time: q.timestamp ? new Date(q.timestamp).toISOString() : null,
+                url: 'https://xueqiu.com/S/' + q.symbol,
+            }];
+    },
+});

package/clis/xueqiu/utils.js

@@ -0,0 +1,29 @@
+import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
+/**
+ * Fetch a xueqiu JSON API from inside the browser context (credentials included).
+ * Page must already be navigated to xueqiu.com before calling this function.
+ * Throws CliError on HTTP errors; otherwise returns the parsed JSON.
+ */
+export async function fetchXueqiuJson(page, url) {
+    const result = await page.evaluate(`(async () => {
+    const res = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+    if (!res.ok) return { __xqErr: res.status };
+    try {
+      return await res.json();
+    } catch {
+      return { __xqErr: 'parse' };
+    }
+  })()`);
+    const r = result;
+    if (r?.__xqErr !== undefined) {
+        const code = r.__xqErr;
+        if (code === 401 || code === 403) {
+            throw new AuthRequiredError('xueqiu.com', '未登录或登录已过期');
+        }
+        if (code === 'parse') {
+            throw new CommandExecutionError('响应不是有效 JSON', '可能触发了风控，请检查登录状态或稍后重试');
+        }
+        throw new CommandExecutionError(`HTTP ${code}`, '请检查网络连接或登录状态');
+    }
+    return result;
+}

package/clis/xueqiu/watchlist.js

@@ -0,0 +1,36 @@
+import { cli } from '@jackwener/opencli/registry';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'watchlist',
+    description: '获取雪球自选股/模拟组合股票列表',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'pid',
+            default: '-1',
+            help: '分组ID：-1=全部(默认) -4=模拟 -5=沪深 -6=美股 -7=港股 -10=实盘 0=持仓（通过 xueqiu groups 获取）',
+        },
+        { name: 'limit', type: 'int', default: 100, help: '默认 100' },
+    ],
+    columns: ['symbol', 'name', 'price', 'changePercent'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const pid = String(kwargs.pid || '-1');
+        const url = `https://stock.xueqiu.com/v5/stock/portfolio/stock/list.json?size=100&category=1&pid=${encodeURIComponent(pid)}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.stocks)
+            throw new AuthRequiredError('xueqiu.com');
+        return (d.data.stocks || []).slice(0, kwargs.limit).map((s) => ({
+            symbol: s.symbol,
+            name: s.name,
+            price: s.current,
+            change: s.chg,
+            changePercent: s.percent != null ? s.percent.toFixed(2) + '%' : null,
+            volume: s.volume,
+            url: 'https://xueqiu.com/S/' + s.symbol,
+        }));
+    },
+});

package/{dist/clis → clis}/yahoo-finance/quote.js

@@ -2,6 +2,7 @@
  * Yahoo Finance stock quote — multi-strategy API fallback.
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 cli({
     site: 'yahoo-finance',
     name: 'quote',
@@ -66,7 +67,7 @@ cli({
       })()
     `);
         if (!data || data.error)
-            return [];
+            throw new CommandExecutionError(data?.error || `Failed to fetch quote for ${symbol}`);
         return [data];
     },
 });

package/dist/src/browser/base-page.js

@@ -117,7 +117,7 @@ export class BasePage {
         catch (err) {
             // Log snapshot failure for debugging, then fallback to basic accessibility tree
             if (process.env.DEBUG_SNAPSHOT) {
-                console.error('[snapshot] DOM snapshot failed, falling back to accessibility tree:', err?.message?.slice(0, 200));
+                process.stderr.write(`[snapshot] DOM snapshot failed, falling back to accessibility tree: ${err?.message?.slice(0, 200)}\n`);
             }
             return this._basicSnapshot(opts);
         }

package/dist/src/browser/bridge.js

@@ -45,7 +45,7 @@ export class BrowserBridge {
         if (this._state === 'closed')
             return;
         this._state = 'closing';
-        // We don't kill the daemon — it auto-exits on idle.
+        // We don't kill the daemon — it's persistent.
         // Just clean up our reference.
         this._page = null;
         this._state = 'closed';

package/dist/src/browser/cdp.js

@@ -195,16 +195,18 @@ class CDPPage extends BasePage {
         return base64;
     }
     async startNetworkCapture(pattern = '') {
+        // Always update the filter pattern
         this._networkCapturePattern = pattern;
-        this._networkEntries = [];
-        this._pendingRequests.clear();
-        this._pendingBodyFetches.clear();
+        // Reset state only on first start; avoid wiping entries if already capturing
         if (!this._networkCapturing) {
+            this._networkEntries = [];
+            this._pendingRequests.clear();
+            this._pendingBodyFetches.clear();
             await this.bridge.send('Network.enable');
             // Step 1: Record request method/url on requestWillBeSent
             this.bridge.on('Network.requestWillBeSent', (params) => {
                 const p = params;
-                if (!pattern || p.request.url.includes(pattern)) {
+                if (!this._networkCapturePattern || p.request.url.includes(this._networkCapturePattern)) {
                     const idx = this._networkEntries.push({
                         url: p.request.url,
                         method: p.request.method,

package/dist/src/browser/daemon-client.d.ts

@@ -32,6 +32,8 @@ export interface DaemonCommand {
     pattern?: string;
     cdpMethod?: string;
     cdpParams?: Record<string, unknown>;
+    /** When true, automation windows are created in the foreground */
+    windowFocused?: boolean;
 }
 export interface DaemonResult {
     id: string;
@@ -48,7 +50,6 @@ export interface DaemonStatus {
     extensionConnected: boolean;
     extensionVersion?: string;
     pending: number;
-    lastCliRequestTime: number;
     memoryMB: number;
     port: number;
 }

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

@@ -73,7 +73,9 @@ async function sendCommandRaw(action, params) {
     const maxRetries = 4;
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
         const id = generateId();
-        const command = { id, action, ...params };
+        const wf = process.env.OPENCLI_WINDOW_FOCUSED;
+        const windowFocused = (wf === '1' || wf === 'true') ? true : undefined;
+        const command = { id, action, ...params, ...(windowFocused && { windowFocused }) };
         try {
             const res = await requestDaemon('/command', {
                 method: 'POST',

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

@@ -15,7 +15,6 @@ describe('daemon-client', () => {
             extensionConnected: true,
             extensionVersion: '1.2.3',
             pending: 0,
-            lastCliRequestTime: Date.now(),
             memoryMB: 32,
             port: 19825,
         };
@@ -53,7 +52,6 @@ describe('daemon-client', () => {
             uptime: 10,
             extensionConnected: false,
             pending: 0,
-            lastCliRequestTime: Date.now(),
             memoryMB: 16,
             port: 19825,
         };
@@ -71,7 +69,6 @@ describe('daemon-client', () => {
             extensionConnected: true,
             extensionVersion: '1.2.3',
             pending: 0,
-            lastCliRequestTime: Date.now(),
             memoryMB: 32,
             port: 19825,
         };

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

@@ -8,9 +8,4 @@
  *
  * Inspired by puppeteer-extra-plugin-stealth.
  */
-/**
- * Return a self-contained JS string that, when evaluated in a page context,
- * applies all stealth patches. Safe to call multiple times — the guard flag
- * ensures patches are applied only once.
- */
 export declare function generateStealthJs(): string;

package/dist/src/browser/stealth.js

@@ -12,9 +12,15 @@
  * Return a self-contained JS string that, when evaluated in a page context,
  * applies all stealth patches. Safe to call multiple times — the guard flag
  * ensures patches are applied only once.
+ *
+ * The generated string is pure static (no dynamic parameters), so we cache
+ * it after the first call to avoid re-building ~350 lines on every goto().
  */
+let _cachedStealthJs;
 export function generateStealthJs() {
-    return `
+    if (_cachedStealthJs !== undefined)
+        return _cachedStealthJs;
+    return (_cachedStealthJs = `
     (() => {
       // Guard: prevent double-injection across separate CDP evaluations.
       // We cannot use a closure variable (each eval is a fresh scope), and
@@ -349,5 +355,5 @@ export function generateStealthJs() {
 
       return 'applied';
     })()
-  `;
+  `);
 }

package/dist/src/browser.test.js

@@ -121,7 +121,6 @@ describe('BrowserBridge state', () => {
                 uptime: 0,
                 extensionConnected: false,
                 pending: 0,
-                lastCliRequestTime: 0,
                 memoryMB: 0,
                 port: 0,
             },

package/dist/src/build-manifest.d.ts

@@ -2,11 +2,11 @@
 /**
  * Build-time CLI manifest compiler.
  *
- * Scans all TS CLI definitions and pre-compiles them into a single
+ * Scans all JS CLI definitions in clis/ and pre-compiles them into a single
  * manifest.json for instant cold-start registration.
  *
  * Usage: npx tsx src/build-manifest.ts
- * Output: cli-manifest.json at the package root
+ * Output: cli-manifest.json next to clis/
  */
 export interface ManifestEntry {
     site: string;
@@ -31,13 +31,13 @@ export interface ManifestEntry {
     timeout?: number;
     deprecated?: boolean | string;
     replacedBy?: string;
-    type: 'ts';
+    type: 'js';
     /** Relative path from clis/ dir, e.g. 'bilibili/search.js' */
     modulePath?: string;
-    /** Relative path to the original source file from clis/ dir (e.g. 'site/cmd.ts') */
+    /** Relative path to the source file from clis/ dir (e.g. 'site/cmd.js') */
     sourceFile?: string;
     /** Pre-navigation control — see CliCommand.navigateBefore */
     navigateBefore?: boolean | string;
 }
-export declare function loadTsManifestEntries(filePath: string, site: string, importer?: (moduleHref: string) => Promise<unknown>): Promise<ManifestEntry[]>;
+export declare function loadManifestEntries(filePath: string, site: string, importer?: (moduleHref: string) => Promise<unknown>): Promise<ManifestEntry[]>;
 export declare function buildManifest(): Promise<ManifestEntry[]>;

package/dist/src/build-manifest.js

@@ -2,11 +2,11 @@
 /**
  * Build-time CLI manifest compiler.
  *
- * Scans all TS CLI definitions and pre-compiles them into a single
+ * Scans all JS CLI definitions in clis/ and pre-compiles them into a single
  * manifest.json for instant cold-start registration.
  *
  * Usage: npx tsx src/build-manifest.ts
- * Output: cli-manifest.json at the package root
+ * Output: cli-manifest.json next to clis/
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -16,6 +16,7 @@ import { fullName, getRegistry } from './registry.js';
 import { findPackageRoot, getCliManifestPath } from './package-paths.js';
 const PACKAGE_ROOT = findPackageRoot(fileURLToPath(import.meta.url));
 const CLIS_DIR = path.join(PACKAGE_ROOT, 'clis');
+// Write manifest next to clis/ so both dev and installed runtime can find it.
 const OUTPUT = getCliManifestPath(CLIS_DIR);
 import { isRecord } from './utils.js';
 const CLI_MODULE_PATTERN = /\bcli\s*\(/;
@@ -31,7 +32,7 @@ function toManifestArgs(args) {
         choices: arg.choices,
     }));
 }
-function toTsModulePath(filePath, site) {
+function toModulePath(filePath, site) {
     const baseName = path.basename(filePath, path.extname(filePath));
     return `${site}/${baseName}.js`;
 }
@@ -56,19 +57,19 @@ function toManifestEntry(cmd, modulePath, sourceFile) {
         timeout: cmd.timeoutSeconds,
         deprecated: cmd.deprecated,
         replacedBy: cmd.replacedBy,
-        type: 'ts',
+        type: 'js',
         modulePath,
         sourceFile,
         navigateBefore: cmd.navigateBefore,
     };
 }
-export async function loadTsManifestEntries(filePath, site, importer = moduleHref => import(moduleHref)) {
+export async function loadManifestEntries(filePath, site, importer = moduleHref => import(moduleHref)) {
     try {
         const src = fs.readFileSync(filePath, 'utf-8');
         // Helper/test modules should not appear as CLI commands in the manifest.
         if (!CLI_MODULE_PATTERN.test(src))
             return [];
-        const modulePath = toTsModulePath(filePath, site);
+        const modulePath = toModulePath(filePath, site);
         const registry = getRegistry();
         const before = new Map(registry.entries());
         const mod = await importer(pathToFileURL(filePath).href);
@@ -84,6 +85,8 @@ export async function loadTsManifestEntries(filePath, site, importer = moduleHre
                 return !previous || previous !== cmd;
             })
                 .map(([, cmd]) => cmd);
+        // Resolve sourceFile relative to clis/.
+        const sourceRelative = path.relative(CLIS_DIR, filePath);
         const seen = new Set();
         return runtimeCommands
             .filter((cmd) => {
@@ -94,7 +97,7 @@ export async function loadTsManifestEntries(filePath, site, importer = moduleHre
             return true;
         })
             .sort((a, b) => a.name.localeCompare(b.name))
-            .map(cmd => toManifestEntry(cmd, modulePath, path.relative(CLIS_DIR, filePath)));
+            .map(cmd => toManifestEntry(cmd, modulePath, sourceRelative));
     }
     catch (err) {
         // If parsing fails, log a warning (matching scanYaml behaviour) and skip the entry.
@@ -104,16 +107,17 @@ export async function loadTsManifestEntries(filePath, site, importer = moduleHre
 }
 export async function buildManifest() {
     const manifest = new Map();
+    // Scan JS adapters directly from clis/.
+    // Adapters are now JS-first — no compilation step needed.
     if (fs.existsSync(CLIS_DIR)) {
         for (const site of fs.readdirSync(CLIS_DIR)) {
             const siteDir = path.join(CLIS_DIR, site);
             if (!fs.statSync(siteDir).isDirectory())
                 continue;
             for (const file of fs.readdirSync(siteDir)) {
-                if ((file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts') && file !== 'index.ts') ||
-                    (file.endsWith('.js') && !file.endsWith('.d.js') && !file.endsWith('.test.js') && file !== 'index.js')) {
+                if (file.endsWith('.js') && !file.endsWith('.d.js') && !file.endsWith('.test.js') && file !== 'index.js') {
                     const filePath = path.join(siteDir, file);
-                    const entries = await loadTsManifestEntries(filePath, site);
+                    const entries = await loadManifestEntries(filePath, site);
                     for (const entry of entries) {
                         const key = `${entry.site}/${entry.name}`;
                         manifest.set(key, entry);

package/dist/src/build-manifest.test.js

@@ -3,7 +3,7 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { cli, getRegistry, Strategy } from './registry.js';
-import { loadTsManifestEntries } from './build-manifest.js';
+import { loadManifestEntries } from './build-manifest.js';
 describe('manifest helper rules', () => {
     const tempDirs = [];
     afterEach(() => {
@@ -16,7 +16,7 @@ describe('manifest helper rules', () => {
         tempDirs.push(dir);
         const file = path.join(dir, 'utils.ts');
         fs.writeFileSync(file, `export function helper() { return 'noop'; }`);
-        return expect(loadTsManifestEntries(file, 'demo', async () => ({}))).resolves.toEqual([]);
+        return expect(loadManifestEntries(file, 'demo', async () => ({}))).resolves.toEqual([]);
     });
     it('builds TS manifest entries from exported runtime commands', async () => {
         const site = `manifest-hydrate-${Date.now()}`;
@@ -25,7 +25,7 @@ describe('manifest helper rules', () => {
         tempDirs.push(dir);
         const file = path.join(dir, `${site}.ts`);
         fs.writeFileSync(file, `export const command = cli({ site: '${site}', name: 'dynamic' });`);
-        const entries = await loadTsManifestEntries(file, site, async () => ({
+        const entries = await loadManifestEntries(file, site, async () => ({
             command: cli({
                 site,
                 name: 'dynamic',
@@ -69,7 +69,7 @@ describe('manifest helper rules', () => {
                         default: '30',
                     }),
                 ],
-                type: 'ts',
+                type: 'js',
                 modulePath: `${site}/${site}.js`,
                 navigateBefore: 'https://example.com/session',
                 deprecated: 'legacy command',
@@ -87,7 +87,7 @@ describe('manifest helper rules', () => {
         tempDirs.push(dir);
         const file = path.join(dir, `${site}.ts`);
         fs.writeFileSync(file, `cli({ site: '${site}', name: 'legacy' });`);
-        const entries = await loadTsManifestEntries(file, site, async () => {
+        const entries = await loadManifestEntries(file, site, async () => {
             cli({
                 site,
                 name: 'legacy',
@@ -105,7 +105,7 @@ describe('manifest helper rules', () => {
                 strategy: 'cookie',
                 browser: true,
                 args: [],
-                type: 'ts',
+                type: 'js',
                 modulePath: `${site}/${site}.js`,
                 deprecated: 'legacy is deprecated',
                 replacedBy: 'opencli demo new',
@@ -123,7 +123,7 @@ describe('manifest helper rules', () => {
         tempDirs.push(dir);
         const file = path.join(dir, `${site}.ts`);
         fs.writeFileSync(file, `export const screen = cli({ site: '${site}', name: 'screen' });`);
-        const entries = await loadTsManifestEntries(file, site, async () => ({
+        const entries = await loadManifestEntries(file, site, async () => ({
             screen: cli({
                 site,
                 name: 'screen',

package/dist/src/capabilityRouting.d.ts

@@ -1,4 +1,4 @@
-import { type CliCommand } from './registry.js';
+import type { CliCommand } from './registry.js';
 /** Pipeline steps that require a live browser session. */
 export declare const BROWSER_ONLY_STEPS: Set<string>;
 export declare function shouldUseBrowserSession(cmd: CliCommand): boolean;

package/dist/src/capabilityRouting.js

@@ -1,4 +1,3 @@
-import { Strategy } from './registry.js';
 /** Pipeline steps that require a live browser session. */
 export const BROWSER_ONLY_STEPS = new Set([
     'navigate',
@@ -25,7 +24,10 @@ export function shouldUseBrowserSession(cmd) {
         return true;
     if (!cmd.pipeline || cmd.pipeline.length === 0)
         return true;
-    if (cmd.strategy !== Strategy.PUBLIC)
+    // normalizeCommand sets navigateBefore to a URL string (needs pre-nav) or
+    // boolean true (needs authenticated context, no specific URL). Either way
+    // the pipeline requires a browser session even if no step is browser-only.
+    if (cmd.navigateBefore)
         return true;
     return pipelineNeedsBrowserSession(cmd.pipeline);
 }

package/dist/src/capabilityRouting.test.js

@@ -25,10 +25,13 @@ describe('shouldUseBrowserSession', () => {
             pipeline: [{ navigate: 'https://example.com' }, { evaluate: '() => []' }],
         }))).toBe(true);
     });
-    it('keeps browser session for non-public strategies', () => {
+    it('keeps browser session for non-public strategies (via normalized navigateBefore)', () => {
+        // After normalizeCommand, COOKIE strategy without domain sets navigateBefore: true
+        // (signals "needs authenticated browser context" without a specific pre-nav URL).
         expect(shouldUseBrowserSession(makeCmd({
             browser: true,
             strategy: Strategy.COOKIE,
+            navigateBefore: true,
             pipeline: [{ fetch: 'https://example.com/api' }],
         }))).toBe(true);
     });