@sovovs/bycli 2.1.40 → 2.1.42

package/dist/src/help.js

@@ -48,6 +48,19 @@ const BROWSER_COMMON_OPTIONS = [
         choices: ['true', 'false'],
     },
 ];
+const ADAPTER_SESSION_OPTIONS = [
+    {
+        flags: '--adapter-session <name>',
+        name: 'adapter-session',
+        help: 'Named persistent Adapter tab session',
+    },
+    {
+        flags: '--adapter-queue-timeout <seconds>',
+        name: 'adapter-queue-timeout',
+        help: 'Seconds to wait for an Adapter command lease',
+        default: 300,
+    },
+];
 function normalizeStructuredHelpFormat(value) {
     const normalized = value?.toLowerCase();
     if (normalized === 'yaml' || normalized === 'yml')
@@ -369,6 +382,12 @@ function compactCommand(cmd) {
         positionals: positionals(cmd).map(compactArg),
         command_options: commandOptions(cmd).map(compactArg),
         ...(hasBrowserCapability(cmd) ? { browser_common_options: BROWSER_COMMON_OPTIONS.map(compactCommonOption) } : {}),
+        ...(cmd.adapterConcurrency?.isolatedTabs === true
+            ? {
+                adapterConcurrency: cmd.adapterConcurrency,
+                adapter_common_options: ADAPTER_SESSION_OPTIONS.map(compactCommonOption),
+            }
+            : {}),
         example: formatCommandExample(cmd),
         ...(cmd.siteSession ? { siteSession: cmd.siteSession } : {}),
         ...(cmd.defaultFormat ? { defaultFormat: cmd.defaultFormat } : {}),
@@ -417,6 +436,9 @@ export function siteHelpData(site, commands) {
         commands: unique.map(cmd => compactCommand(cmd)),
         common_options: COMMON_OPTIONS.map(compactCommonOption),
         ...(unique.some(hasBrowserCapability) ? { browser_common_options: BROWSER_COMMON_OPTIONS.map(compactCommonOption) } : {}),
+        ...(unique.some(cmd => cmd.adapterConcurrency?.isolatedTabs === true)
+            ? { adapter_common_options: ADAPTER_SESSION_OPTIONS.map(compactCommonOption) }
+            : {}),
         next: [
             `bycli ${site} <command> --help -f yaml`,
             `bycli ${site} <command> -f yaml`,
@@ -429,6 +451,12 @@ export function commandHelpData(cmd) {
         ...compactCommand(cmd),
         common_options: COMMON_OPTIONS.map(compactCommonOption),
         ...(hasBrowserCapability(cmd) ? { browser_common_options: BROWSER_COMMON_OPTIONS.map(compactCommonOption) } : {}),
+        ...(cmd.adapterConcurrency?.isolatedTabs === true
+            ? {
+                adapterConcurrency: cmd.adapterConcurrency,
+                adapter_common_options: ADAPTER_SESSION_OPTIONS.map(compactCommonOption),
+            }
+            : {}),
         output_formats: ['table', 'plain', 'yaml', 'json', 'md', 'csv'],
     };
 }
@@ -468,6 +496,15 @@ export function formatBrowserCommonOptionsHelpText() {
     });
     return ['Browser common options:', ...formatRows(rows)].join('\n');
 }
+export function formatAdapterSessionOptionsHelpText() {
+    const rows = ADAPTER_SESSION_OPTIONS.map(option => {
+        const details = [option.help];
+        if ('default' in option)
+            details.push(`default: ${option.default}`);
+        return [option.flags, details.join('  ')];
+    });
+    return ['Adapter session options:', ...formatRows(rows)].join('\n');
+}
 export function formatSiteHelpText(site, commands) {
     const unique = [...new Map(commands.map(cmd => [fullName(cmd), cmd])).values()]
         .sort((a, b) => a.name.localeCompare(b.name));
@@ -481,6 +518,7 @@ export function formatSiteHelpText(site, commands) {
         '',
         formatCommonOptionsHelpText(),
         ...(unique.some(hasBrowserCapability) ? ['', formatBrowserCommonOptionsHelpText()] : []),
+        ...(unique.some(cmd => cmd.adapterConcurrency?.isolatedTabs === true) ? ['', formatAdapterSessionOptionsHelpText()] : []),
         '',
         `Agent tip: use 'bycli ${site} --help -f yaml' to get all command args/options in one structured response.`,
         '',
@@ -511,6 +549,8 @@ export function formatCommandHelpText(cmd) {
     lines.push(formatCommonOptionsHelpText(), '');
     if (hasBrowserCapability(cmd))
         lines.push(formatBrowserCommonOptionsHelpText(), '');
+    if (cmd.adapterConcurrency?.isolatedTabs === true)
+        lines.push(formatAdapterSessionOptionsHelpText(), '');
     const meta = [];
     meta.push(`Access: ${cmd.access}`);
     meta.push(`Browser: ${browserRequirementLabel(cmd)}`);

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

@@ -38,4 +38,8 @@ export interface ManifestEntry {
     navigateBefore?: boolean | string;
     /** Site session lifecycle defaults — see CliCommand.siteSession */
     siteSession?: 'ephemeral' | 'persistent';
+    adapterConcurrency?: {
+        isolatedTabs: true;
+        maxParallel: number;
+    };
 }

package/dist/src/registry.d.ts

@@ -28,6 +28,10 @@ export type ConditionalBrowserCommandFunc = (page: IPage | null, kwargs: Command
 export type NonBrowserCommandFunc = (kwargs: CommandArgs, debug?: boolean) => Promise<unknown>;
 export type CommandAccess = 'read' | 'write';
 export type SiteSessionMode = 'ephemeral' | 'persistent';
+export interface AdapterConcurrency {
+    isolatedTabs: true;
+    maxParallel: number;
+}
 /**
  * 所有已注册 adapter command 的共享元数据和运行选项。
  *
@@ -82,6 +86,8 @@ interface BaseCliCommand {
     navigateBefore?: boolean | string;
     /** adapter 浏览器站点 session 生命周期：临时 session 或持久 session。 */
     siteSession?: SiteSessionMode;
+    /** Opt-in authorization for isolated persistent Adapter tabs. */
+    adapterConcurrency?: AdapterConcurrency;
     /** 用户没有传 `-f/--format` 时使用的默认输出格式。 */
     defaultFormat?: 'table' | 'plain' | 'json' | 'yaml' | 'yml' | 'md' | 'markdown' | 'csv';
 }

package/dist/src/registry.js

@@ -95,6 +95,7 @@ function rawCommandBase(opts) {
         validateArgs: opts.validateArgs,
         navigateBefore: opts.navigateBefore,
         siteSession: opts.siteSession,
+        adapterConcurrency: opts.adapterConcurrency,
         defaultFormat: opts.defaultFormat,
     };
 }
@@ -190,6 +191,27 @@ function assertSiteSession(cmd) {
         throw new Error(`Command ${key} siteSession must be one of: ephemeral, persistent`);
     }
 }
+function assertAdapterConcurrency(cmd) {
+    if (cmd.adapterConcurrency === undefined)
+        return;
+    const key = `${cmd.site}/${cmd.name}`;
+    if (!cmd.adapterConcurrency || typeof cmd.adapterConcurrency !== 'object') {
+        throw new Error(`Command ${key} adapterConcurrency must be an object`);
+    }
+    const metadata = cmd.adapterConcurrency;
+    if (metadata.isolatedTabs !== true) {
+        throw new Error(`Command ${key} adapterConcurrency.isolatedTabs must be true`);
+    }
+    if (!Number.isInteger(metadata.maxParallel)
+        || metadata.maxParallel < 1
+        || metadata.maxParallel > 3) {
+        throw new Error(`Command ${key} adapterConcurrency.maxParallel must be an integer between 1 and 3`);
+    }
+    if (cmd.browser === false
+        || (cmd.browser === undefined && (cmd.strategy === Strategy.PUBLIC || cmd.strategy === Strategy.LOCAL))) {
+        throw new Error(`Command ${key} adapterConcurrency requires browser capability`);
+    }
+}
 export function registerCommand(cmd) {
     registerCommandInput(cmd);
 }
@@ -197,6 +219,7 @@ function registerCommandInput(cmd) {
     withRegistryMutationGroup(() => {
         assertCommandAccess(cmd);
         assertSiteSession(cmd);
+        assertAdapterConcurrency(cmd);
         if (cmd.browser === 'conditional') {
             if (typeof cmd.requiresBrowser !== 'function') {
                 const key = `${cmd.site}/${cmd.name}`;

package/dist/src/serialization.d.ts

@@ -33,6 +33,7 @@ export declare function serializeCommand(cmd: CliCommand): {
     example: string;
     defaultFormat: "table" | "plain" | "json" | "yaml" | "yml" | "md" | "markdown" | "csv" | null;
     siteSession: import("./registry.js").SiteSessionMode | null;
+    adapterConcurrency: import("./registry.js").AdapterConcurrency | null;
 };
 /** Human-readable arg summary: `<required> [optional]` style. */
 export declare function formatArgSummary(args: Arg[]): string;

package/dist/src/serialization.js

@@ -35,6 +35,7 @@ export function serializeCommand(cmd) {
         example: formatCommandExample(cmd),
         defaultFormat: cmd.defaultFormat ?? null,
         siteSession: cmd.siteSession ?? null,
+        adapterConcurrency: cmd.adapterConcurrency ?? null,
     };
 }
 // ── Formatting ──────────────────────────────────────────────────────────────

package/dist/src/types.d.ts

@@ -222,6 +222,8 @@ export interface IPage {
     /** Focus the browser window containing the active page for interactive login. */
     focusWindow?(): Promise<void>;
     closeWindow?(): Promise<void>;
+    /** Pin subsequent commands to the daemon profile selected for this operation. */
+    setContextId?(contextId: string): void;
     /** Returns the current page URL, or null if unavailable. */
     getCurrentUrl?(): Promise<string | null>;
     /** Returns the active page identity (targetId), or undefined if not yet resolved. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovovs/bycli",
-  "version": "2.1.40",
+  "version": "2.1.42",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,8 @@
     "./download/media-download": "./dist/src/download/media-download.js",
     "./download/progress": "./dist/src/download/progress.js",
     "./download/wechat-article": "./dist/src/download/wechat-article.js",
-    "./pipeline": "./dist/src/pipeline/index.js"
+    "./pipeline": "./dist/src/pipeline/index.js",
+    "./adapter-coordination": "./dist/src/adapter-coordination.js"
   },
   "files": [
     "dist/src/",