@jackwener/opencli 1.7.15 → 1.7.16

package/dist/src/help.js

@@ -28,6 +28,20 @@ const COMMON_OPTIONS = [
         help: 'display help for command',
     },
 ];
+const BROWSER_COMMON_OPTIONS = [
+    {
+        flags: '--window <mode>',
+        name: 'window',
+        help: 'Browser window mode: foreground or background',
+        choices: ['foreground', 'background'],
+    },
+    {
+        flags: '--keep-tab <bool>',
+        name: 'keep-tab',
+        help: 'Keep the browser tab lease after the command finishes',
+        choices: ['true', 'false'],
+    },
+];
 function normalizeStructuredHelpFormat(value) {
     const normalized = value?.toLowerCase();
     if (normalized === 'yaml' || normalized === 'yml')
@@ -307,6 +321,7 @@ function compactCommand(cmd) {
         ...(cmd.aliases?.length ? { aliases: cmd.aliases } : {}),
         positionals: positionals(cmd).map(compactArg),
         command_options: commandOptions(cmd).map(compactArg),
+        ...(cmd.browser ? { browser_common_options: BROWSER_COMMON_OPTIONS.map(compactCommonOption) } : {}),
         example: formatCommandExample(cmd),
         ...(cmd.browserSession ? { browserSession: cmd.browserSession } : {}),
         ...(cmd.defaultFormat ? { defaultFormat: cmd.defaultFormat } : {}),
@@ -353,6 +368,7 @@ export function siteHelpData(site, commands) {
         command_count: unique.length,
         commands: unique.map(cmd => compactCommand(cmd)),
         common_options: COMMON_OPTIONS.map(compactCommonOption),
+        ...(unique.some(cmd => cmd.browser) ? { browser_common_options: BROWSER_COMMON_OPTIONS.map(compactCommonOption) } : {}),
         next: [
             `opencli ${site} <command> --help -f yaml`,
             `opencli ${site} <command> -f yaml`,
@@ -364,6 +380,7 @@ export function commandHelpData(cmd) {
         site: cmd.site,
         ...compactCommand(cmd),
         common_options: COMMON_OPTIONS.map(compactCommonOption),
+        ...(cmd.browser ? { browser_common_options: BROWSER_COMMON_OPTIONS.map(compactCommonOption) } : {}),
         output_formats: ['table', 'plain', 'yaml', 'json', 'md', 'csv'],
     };
 }
@@ -394,6 +411,15 @@ export function formatCommonOptionsHelpText() {
     });
     return ['Common options:', ...formatRows(rows)].join('\n');
 }
+export function formatBrowserCommonOptionsHelpText() {
+    const rows = BROWSER_COMMON_OPTIONS.map(option => {
+        const details = [option.help];
+        if ('choices' in option)
+            details.push(`choices: ${option.choices.join(', ')}`);
+        return [option.flags, details.join('  ')];
+    });
+    return ['Browser common 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));
@@ -406,6 +432,7 @@ export function formatSiteHelpText(site, commands) {
         ...formatRows(unique.map(cmd => [formatCommandListTerm(cmd), formatSiteCommandDescription(cmd)])),
         '',
         formatCommonOptionsHelpText(),
+        ...(unique.some(cmd => cmd.browser) ? ['', formatBrowserCommonOptionsHelpText()] : []),
         '',
         `Agent tip: use 'opencli ${site} --help -f yaml' to get all command args/options in one structured response.`,
         '',
@@ -434,6 +461,8 @@ export function formatCommandHelpText(cmd) {
         lines.push('Command options:', ...formatRows(optionRows), '');
     }
     lines.push(formatCommonOptionsHelpText(), '');
+    if (cmd.browser)
+        lines.push(formatBrowserCommonOptionsHelpText(), '');
     const meta = [];
     meta.push(`Access: ${cmd.access}`);
     meta.push(`Browser: ${cmd.browser ? 'yes' : 'no'}`);

package/dist/src/main.js

@@ -27,21 +27,11 @@ const __dirname = path.dirname(__filename);
 // Use findPackageRoot so the path works both in dev (src/main.ts) and prod (dist/src/main.js).
 const BUILTIN_CLIS = path.join(findPackageRoot(__filename), 'clis');
 const USER_CLIS = path.join(os.homedir(), '.opencli', 'clis');
-// ── Session lifecycle flags ──────────────────────────────────────────────
-// `--live` / `--focus` / `--reuse` are top-level-ish toggles that tweak the automation
-// window's lifecycle. We strip them from argv before Commander runs so they
-// can be placed anywhere and work on any subcommand (adapter or browser).
+// ── Browser reuse flag ───────────────────────────────────────────────────
+// `--reuse` is a runtime-level browser session override rather than an adapter
+// arg. Strip it before Commander runs and expose it through an explicit env
+// name. Window/keep-tab are registered on browser-backed commands directly.
 {
-    const liveIdx = process.argv.indexOf('--live');
-    if (liveIdx !== -1) {
-        process.env.OPENCLI_LIVE = '1';
-        process.argv.splice(liveIdx, 1);
-    }
-    const focusIdx = process.argv.indexOf('--focus');
-    if (focusIdx !== -1) {
-        process.env.OPENCLI_WINDOW_FOCUSED = '1';
-        process.argv.splice(focusIdx, 1);
-    }
     const reuseIdx = process.argv.findIndex(arg => arg === '--reuse' || arg.startsWith('--reuse='));
     if (reuseIdx !== -1) {
         const arg = process.argv[reuseIdx];

package/dist/src/runtime.d.ts

@@ -6,6 +6,7 @@ import type { IPage } from './types.js';
 export declare function getBrowserFactory(site?: string): new () => IBrowserFactory;
 export declare const DEFAULT_BROWSER_CONNECT_TIMEOUT: number;
 export declare const DEFAULT_BROWSER_COMMAND_TIMEOUT: number;
+export type BrowserWindowMode = 'foreground' | 'background';
 /**
  * Timeout with seconds unit. Used for high-level command timeouts.
  */
@@ -28,6 +29,7 @@ export interface IBrowserFactory {
         cdpEndpoint?: string;
         contextId?: string;
         idleTimeout?: number;
+        windowMode?: BrowserWindowMode;
     }): Promise<IPage>;
     close(): Promise<void>;
 }
@@ -36,4 +38,5 @@ export declare function browserSession<T>(BrowserFactory: new () => IBrowserFact
     cdpEndpoint?: string;
     contextId?: string;
     idleTimeout?: number;
+    windowMode?: BrowserWindowMode;
 }): Promise<T>;

package/dist/src/runtime.js

@@ -54,6 +54,7 @@ export async function browserSession(BrowserFactory, fn, opts = {}) {
             cdpEndpoint: opts.cdpEndpoint,
             contextId: opts.contextId,
             idleTimeout: opts.idleTimeout,
+            windowMode: opts.windowMode,
         });
         return await fn(page);
     }

package/dist/src/types.d.ts

@@ -68,7 +68,7 @@ export interface BrowserSessionInfo {
     owned?: boolean;
     ownership?: 'owned' | 'borrowed';
     lifecycle?: 'ephemeral' | 'persistent' | 'pinned';
-    surface?: 'dedicated-container' | 'borrowed-user-tab';
+    windowRole?: 'interactive' | 'automation' | 'borrowed-user';
     contextId?: string;
     tabCount?: number;
     idleMsRemaining?: number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "1.7.15",
+  "version": "1.7.16",
   "publishConfig": {
     "access": "public"
   },