Fix: CLI: state load / profile persistence not usable in v0.7.6 (#268)

* Fix: CLI: state load / profile persistence not usable in v0.7.6

This PR addresses issue #259

* Fix issues identified in code review

src/browser.ts

@@ -819,6 +819,7 @@ export class BrowserManager {
     const cdpEndpoint = options.cdpUrl ?? (options.cdpPort ? String(options.cdpPort) : undefined);
     const hasExtensions = !!options.extensions?.length;
     const hasProfile = !!options.profile;
+    const hasStorageState = !!options.storageState;
 
     if (hasExtensions && cdpEndpoint) {
       throw new Error('Extensions cannot be used with CDP connection');
@@ -828,6 +829,18 @@ export class BrowserManager {
       throw new Error('Profile cannot be used with CDP connection');
     }
 
+    if (hasStorageState && hasProfile) {
+      throw new Error(
+        'Storage state cannot be used with profile (profile is already persistent storage)'
+      );
+    }
+
+    if (hasStorageState && hasExtensions) {
+      throw new Error(
+        'Storage state cannot be used with extensions (extensions require persistent context)'
+      );
+    }
+
     if (this.isLaunched()) {
       const needsRelaunch =
         (!cdpEndpoint && this.cdpEndpoint !== null) ||
@@ -912,6 +925,7 @@ export class BrowserManager {
         userAgent: options.userAgent,
         ...(options.proxy && { proxy: options.proxy }),
         ignoreHTTPSErrors: options.ignoreHTTPSErrors ?? false,
+        ...(options.storageState && { storageState: options.storageState }),
       });
     }
 

src/daemon.ts

@@ -255,6 +255,8 @@ export async function startDaemon(options?: { streamPort?: number }): Promise<vo
               headless: process.env.AGENT_BROWSER_HEADED !== '1',
               executablePath: process.env.AGENT_BROWSER_EXECUTABLE_PATH,
               extensions: extensions,
+              profile: process.env.AGENT_BROWSER_PROFILE,
+              storageState: process.env.AGENT_BROWSER_STATE,
               args,
               userAgent: process.env.AGENT_BROWSER_USER_AGENT,
               proxy,

src/protocol.ts

@@ -46,6 +46,8 @@ const launchSchema = baseCommandSchema.extend({
   userAgent: z.string().optional(),
   provider: z.string().optional(),
   ignoreHTTPSErrors: z.boolean().optional(),
+  profile: z.string().optional(),
+  storageState: z.string().optional(),
 });
 
 const navigateSchema = baseCommandSchema.extend({

src/types.ts

@@ -18,6 +18,7 @@ export interface LaunchCommand extends BaseCommand {
   cdpUrl?: string;
   extensions?: string[];
   profile?: string; // Path to persistent browser profile directory
+  storageState?: string; // Path to storage state JSON file
   proxy?: {
     server: string;
     bypass?: string;