agentic-qe 3.15.9 → 3.15.10

package/dist/domains/test-generation/plugin.js

@@ -4,6 +4,7 @@
  */
 import { err } from '../../shared/types/index.js';
 import { BaseDomainPlugin } from '../domain-interface.js';
+import { MAX_PAYLOAD_FILE_BYTES, requirePayloadFiles } from '../../shared/io/payload-path-guard.js';
 import { TestGenerationCoordinator, } from './coordinator.js';
 // D9: live routing-feedback so free-tier outcomes lift routing confidence.
 import { RoutingFeedbackCollector } from '../../routing/routing-feedback.js';
@@ -73,12 +74,16 @@ export class TestGenerationPlugin extends BaseDomainPlugin {
                     if (!this.coordinator) {
                         return err(new Error('Coordinator not initialized'));
                     }
-                    const sourceFiles = payload.sourceFiles;
                     const testType = payload.testType;
                     const framework = payload.framework;
-                    if (!sourceFiles || sourceFiles.length === 0) {
+                    if (!Array.isArray(payload.sourceFiles) || payload.sourceFiles.length === 0) {
                         return err(new Error('Invalid generate-tests payload: missing sourceFiles'));
                     }
+                    // #1126: the generator reads each file whole, so only project files.
+                    const confined = await requirePayloadFiles('generate-tests', 'sourceFiles', payload.sourceFiles, { maxBytes: MAX_PAYLOAD_FILE_BYTES });
+                    if (!confined.success)
+                        return confined;
+                    const sourceFiles = confined.value;
                     const request = {
                         sourceFiles,
                         testType: testType ?? 'unit',

package/dist/domains/test-generation/services/test-data-generator.js

@@ -230,7 +230,9 @@ export class TestDataGeneratorService {
             const parts = methodPath.split('.');
             let result = f;
             for (const part of parts) {
-                if (result && typeof result === 'object' && part in result) {
+                // #1136: a member every object inherits (`constructor`, `toString`)
+                // is not a faker method.
+                if (result && typeof result === 'object' && part in result && !(part in Object.prototype)) {
                     const next = result[part];
                     if (typeof next === 'function') {
                         result = next();

package/dist/domains/visual-accessibility/services/axe-core-audit.js

@@ -85,7 +85,7 @@ export class AccessibilityAuditor {
         // Check for vibium
         try {
             await loadVibium();
-            this.toolsAvailable.vibium = isVibiumReady();
+            this.toolsAvailable.vibium = await isVibiumReady();
         }
         catch {
             this.toolsAvailable.vibium = false;

package/dist/hooks/cross-phase-hooks.js

@@ -332,7 +332,8 @@ export class CrossPhaseHookExecutor {
     }
     getValueFromPath(obj, path) {
         return path.split('.').reduce((curr, key) => {
-            if (curr && typeof curr === 'object' && key in curr) {
+            // #1136: own properties only.
+            if (curr && typeof curr === 'object' && Object.hasOwn(curr, key)) {
                 return curr[key];
             }
             return undefined;

package/dist/init/phases/10-workers.js

@@ -150,6 +150,29 @@ if (existsSync(pidFile) && isRegularOrAbsent(pidFile)) {
   try { process.kill(pid, 0); console.log('Daemon already running (PID: ' + pid + ')'); process.exit(0); } catch {}
 }
 
+// #1116: honour AQE_WORKERS_ENABLED, from the environment or else the project's
+// .claude/settings.local.json or settings.json env (where \`aqe init
+// --no-database\` writes it; the local file wins, as in Claude Code), the same
+// falsy values as the MCP server. A JSON boolean counts as its string.
+// Disabled means nothing is spawned.
+function workersEnabledSetting() {
+  if (process.env.AQE_WORKERS_ENABLED !== undefined) return process.env.AQE_WORKERS_ENABLED;
+  for (const file of ['settings.local.json', 'settings.json']) {
+    try {
+      const settings = JSON.parse(readFileSync(join(projectRoot, '.claude', file), 'utf-8'));
+      const value = settings && settings.env && settings.env.AQE_WORKERS_ENABLED;
+      if (typeof value === 'string') return value;
+      if (typeof value === 'boolean') return String(value);
+    } catch { /* missing or unreadable: try the next file */ }
+  }
+  return undefined;
+}
+const workersSetting = workersEnabledSetting();
+if (workersSetting !== undefined && ['false', '0', 'off', 'no'].includes(workersSetting.trim().toLowerCase())) {
+  console.log('AQE v3 Worker Daemon not started: background workers are disabled (AQE_WORKERS_ENABLED=' + workersSetting + ')');
+  process.exit(0);
+}
+
 const ts = new Date().toISOString();
 appendFileSync(logFile, '[' + ts + '] Starting AQE v3 Worker Daemon...\\n');
 
@@ -205,17 +228,38 @@ if (binCandidate && binCandidate.endsWith('bundle.js')) {
 appendFileSync(logFile, '[' + ts + '] Using: ' + mcpCmd + ' ' + mcpArgs.join(' ') + '\\n');
 
 // #1066: keep a user's AQE_WORKERS_ENABLED (for example false) instead of forcing it on.
-const env = { ...process.env, AQE_STORAGE_PATH: '.agentic-qe', AQE_LEARNING_ENABLED: 'true', AQE_WORKERS_ENABLED: process.env.AQE_WORKERS_ENABLED ?? 'true', AQE_HTTP_PORT: '0' };
+const env = { ...process.env, AQE_STORAGE_PATH: '.agentic-qe', AQE_LEARNING_ENABLED: 'true', AQE_WORKERS_ENABLED: workersSetting ?? 'true', AQE_HTTP_PORT: '0' };
 const child = spawn(mcpCmd, mcpArgs, { cwd: projectRoot, env, detached: true, stdio: ['ignore', 'pipe', 'pipe'] });
 child.stdout.on('data', d => appendFileSync(logFile, d));
 child.stderr.on('data', d => appendFileSync(logFile, d));
+let exited = null;
+child.on('exit', (code, signal) => { exited = { code, signal }; });
+// #1116: a command that cannot be started (no npx on PATH: spawn ENOENT) emits
+// 'error' instead of 'exit'; without a handler the script crashed and left
+// "undefined" in daemon.pid.
+child.on('error', (error) => {
+  try { fs.unlinkSync(pidFile); } catch {}
+  appendFileSync(logFile, '[' + ts + '] Daemon could not be started: ' + error.message + '\\n');
+  console.error('AQE v3 Worker Daemon not started: ' + error.message + '; see ' + logFile);
+  process.exit(1);
+});
 child.unref();
 
-writeFileSync(pidFile, String(child.pid));
-appendFileSync(logFile, '[' + ts + '] Daemon started with PID: ' + child.pid + '\\n');
-console.log('AQE v3 Worker Daemon started (PID: ' + child.pid + ')');
-console.log('Log file: ' + logFile);
-console.log('To stop: node ' + join(workersDir, 'stop-daemon.cjs'));
+if (child.pid !== undefined) writeFileSync(pidFile, String(child.pid));
+// #1116: say "started" only if the server is still running a moment later.
+setTimeout(() => {
+  if (exited) {
+    try { fs.unlinkSync(pidFile); } catch {}
+    appendFileSync(logFile, '[' + ts + '] Daemon exited right away (code ' + exited.code + ', signal ' + exited.signal + ')\\n');
+    console.error('AQE v3 Worker Daemon not started: the MCP server exited right away (code ' + exited.code + '); see ' + logFile);
+    process.exitCode = 1;
+    return;
+  }
+  appendFileSync(logFile, '[' + ts + '] Daemon started with PID: ' + child.pid + '\\n');
+  console.log('AQE v3 Worker Daemon started (PID: ' + child.pid + ')');
+  console.log('Log file: ' + logFile);
+  console.log('To stop: node ' + join(workersDir, 'stop-daemon.cjs'));
+}, 3000);
 `;
         writeFileIfChanged(daemonScriptPath, daemonScript);
         // Also write a cross-platform stop script

package/dist/integrations/browser/agent-browser/client.js

@@ -210,7 +210,7 @@ export class AgentBrowserClient {
             // Extra safety: also terminate via executor if we have one
             if (this.executor) {
                 try {
-                    this.executor.terminateDaemon();
+                    await this.executor.terminateDaemon();
                 }
                 catch (error) {
                     // Non-critical: best effort daemon termination
@@ -251,7 +251,7 @@ export class AgentBrowserClient {
     async navigate(url) {
         const startTime = Date.now();
         try {
-            const result = this.executor.open(url);
+            const result = await this.executor.open(url);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Navigation failed', 'NAVIGATION_FAILED', 'agent-browser'));
             }
@@ -260,7 +260,7 @@ export class AgentBrowserClient {
                 this.sessionManager.updateSessionUrl(this.currentSessionId, url);
             }
             // Get page info for result
-            const evalResult = this.executor.eval('JSON.stringify({ title: document.title, url: window.location.href })');
+            const evalResult = await this.executor.eval('JSON.stringify({ title: document.title, url: window.location.href })');
             const pageInfo = evalResult.success && evalResult.data
                 ? typeof evalResult.data === 'string'
                     ? safeJsonParse(evalResult.data)
@@ -282,7 +282,7 @@ export class AgentBrowserClient {
      */
     async reload() {
         try {
-            const result = this.executor.eval('window.location.reload()');
+            const result = await this.executor.eval('window.location.reload()');
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Reload failed', 'RELOAD_FAILED', 'agent-browser'));
             }
@@ -297,7 +297,7 @@ export class AgentBrowserClient {
      */
     async goBack() {
         try {
-            const result = this.executor.eval('window.history.back()');
+            const result = await this.executor.eval('window.history.back()');
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Go back failed', 'HISTORY_FAILED', 'agent-browser'));
             }
@@ -312,7 +312,7 @@ export class AgentBrowserClient {
      */
     async goForward() {
         try {
-            const result = this.executor.eval('window.history.forward()');
+            const result = await this.executor.eval('window.history.forward()');
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Go forward failed', 'HISTORY_FAILED', 'agent-browser'));
             }
@@ -331,7 +331,7 @@ export class AgentBrowserClient {
     async click(target) {
         try {
             const resolvedTarget = resolveTarget(target);
-            const result = this.executor.click(resolvedTarget);
+            const result = await this.executor.click(resolvedTarget);
             if (!result.success) {
                 return err(new BrowserElementNotFoundError('agent-browser', target, new Error(result.error)));
             }
@@ -347,7 +347,7 @@ export class AgentBrowserClient {
     async fill(target, text) {
         try {
             const resolvedTarget = resolveTarget(target);
-            const result = this.executor.fill(resolvedTarget, text);
+            const result = await this.executor.fill(resolvedTarget, text);
             if (!result.success) {
                 return err(new BrowserElementNotFoundError('agent-browser', target, new Error(result.error)));
             }
@@ -363,7 +363,7 @@ export class AgentBrowserClient {
     async getText(target) {
         try {
             const resolvedTarget = resolveTarget(target);
-            const result = this.executor.getText(resolvedTarget);
+            const result = await this.executor.getText(resolvedTarget);
             if (!result.success) {
                 return err(new BrowserElementNotFoundError('agent-browser', target, new Error(result.error)));
             }
@@ -400,7 +400,7 @@ export class AgentBrowserClient {
     async isVisible(target) {
         try {
             const resolvedTarget = resolveTarget(target);
-            const result = this.executor.isVisible(resolvedTarget);
+            const result = await this.executor.isVisible(resolvedTarget);
             if (!result.success) {
                 // Element not found means not visible
                 return ok(false);
@@ -419,12 +419,12 @@ export class AgentBrowserClient {
      */
     async screenshot(options) {
         try {
-            const result = this.executor.screenshot(options?.path, options?.fullPage);
+            const result = await this.executor.screenshot(options?.path, options?.fullPage);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Screenshot failed', 'SCREENSHOT_FAILED', 'agent-browser'));
             }
             // Get viewport dimensions
-            const dimensionsResult = this.executor.eval('JSON.stringify({ width: window.innerWidth, height: window.innerHeight })');
+            const dimensionsResult = await this.executor.eval('JSON.stringify({ width: window.innerWidth, height: window.innerHeight })');
             let dimensions = { width: 1280, height: 720 };
             if (dimensionsResult.success && dimensionsResult.data) {
                 const parsed = typeof dimensionsResult.data === 'string'
@@ -451,7 +451,7 @@ export class AgentBrowserClient {
      */
     async evaluate(script) {
         try {
-            const result = this.executor.eval(script);
+            const result = await this.executor.eval(script);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Evaluation failed', 'EVAL_FAILED', 'agent-browser'));
             }
@@ -487,7 +487,7 @@ export class AgentBrowserClient {
      */
     async getSnapshot(options) {
         try {
-            const result = this.executor.snapshot({
+            const result = await this.executor.snapshot({
                 interactive: options?.interactive,
                 depth: options?.depth,
             });
@@ -504,8 +504,8 @@ export class AgentBrowserClient {
                 parsed = this.snapshotParser.parse(String(result.data));
             }
             // Get current URL and title
-            const urlResult = this.executor.eval('window.location.href');
-            const titleResult = this.executor.eval('document.title');
+            const urlResult = await this.executor.eval('window.location.href');
+            const titleResult = await this.executor.eval('document.title');
             if (urlResult.success) {
                 parsed.url = String(urlResult.data);
             }
@@ -578,7 +578,7 @@ export class AgentBrowserClient {
                 body: response.body,
                 headers: response.headers,
             };
-            const result = this.executor.mockRoute(urlPattern, mockBody);
+            const result = await this.executor.mockRoute(urlPattern, mockBody);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Mock route failed', 'MOCK_ROUTE_FAILED', 'agent-browser'));
             }
@@ -593,7 +593,7 @@ export class AgentBrowserClient {
      */
     async abortRoute(urlPattern) {
         try {
-            const result = this.executor.abortRoute(urlPattern);
+            const result = await this.executor.abortRoute(urlPattern);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Abort route failed', 'ABORT_ROUTE_FAILED', 'agent-browser'));
             }
@@ -608,7 +608,7 @@ export class AgentBrowserClient {
      */
     async clearRoutes() {
         try {
-            const result = this.executor.clearRoutes();
+            const result = await this.executor.clearRoutes();
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Clear routes failed', 'CLEAR_ROUTES_FAILED', 'agent-browser'));
             }
@@ -626,7 +626,7 @@ export class AgentBrowserClient {
      */
     async setDevice(deviceName) {
         try {
-            const result = this.executor.setDevice(deviceName);
+            const result = await this.executor.setDevice(deviceName);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Set device failed', 'SET_DEVICE_FAILED', 'agent-browser'));
             }
@@ -641,7 +641,7 @@ export class AgentBrowserClient {
      */
     async setViewport(width, height) {
         try {
-            const result = this.executor.setViewport(width, height);
+            const result = await this.executor.setViewport(width, height);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Set viewport failed', 'SET_VIEWPORT_FAILED', 'agent-browser'));
             }
@@ -659,7 +659,7 @@ export class AgentBrowserClient {
      */
     async saveState(path) {
         try {
-            const result = this.executor.saveState(path);
+            const result = await this.executor.saveState(path);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Save state failed', 'SAVE_STATE_FAILED', 'agent-browser'));
             }
@@ -674,7 +674,7 @@ export class AgentBrowserClient {
      */
     async loadState(path) {
         try {
-            const result = this.executor.loadState(path);
+            const result = await this.executor.loadState(path);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Load state failed', 'LOAD_STATE_FAILED', 'agent-browser'));
             }
@@ -693,7 +693,7 @@ export class AgentBrowserClient {
     async waitForElement(target, timeout) {
         try {
             const resolvedTarget = resolveTarget(target);
-            const result = this.executor.waitForElement(resolvedTarget, timeout);
+            const result = await this.executor.waitForElement(resolvedTarget, timeout);
             if (!result.success) {
                 return err(new BrowserTimeoutError('agent-browser', `waitForElement(${resolvedTarget})`, new Error(result.error)));
             }
@@ -711,7 +711,7 @@ export class AgentBrowserClient {
             // The timeout parameter is ignored by the current CLI implementation
             // but we accept it for interface compatibility
             void timeout;
-            const result = this.executor.waitForText(text);
+            const result = await this.executor.waitForText(text);
             if (!result.success) {
                 return err(new BrowserTimeoutError('agent-browser', `waitForText("${text}")`, new Error(result.error)));
             }
@@ -728,7 +728,7 @@ export class AgentBrowserClient {
         try {
             // The timeout parameter is ignored by the current CLI implementation
             void timeout;
-            const result = this.executor.waitForUrl(pattern);
+            const result = await this.executor.waitForUrl(pattern);
             if (!result.success) {
                 return err(new BrowserTimeoutError('agent-browser', `waitForUrl("${pattern}")`, new Error(result.error)));
             }
@@ -745,7 +745,7 @@ export class AgentBrowserClient {
         try {
             // The timeout parameter is ignored by the current CLI implementation
             void timeout;
-            const result = this.executor.waitForNetworkIdle();
+            const result = await this.executor.waitForNetworkIdle();
             if (!result.success) {
                 return err(new BrowserTimeoutError('agent-browser', 'waitForNetworkIdle', new Error(result.error)));
             }
@@ -766,7 +766,7 @@ export class AgentBrowserClient {
      */
     async startTrace() {
         try {
-            const result = this.executor.startTrace();
+            const result = await this.executor.startTrace();
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Start trace failed', 'START_TRACE_FAILED', 'agent-browser'));
             }
@@ -784,7 +784,7 @@ export class AgentBrowserClient {
      */
     async stopTrace(outputPath) {
         try {
-            const result = this.executor.stopTrace(outputPath);
+            const result = await this.executor.stopTrace(outputPath);
             if (!result.success) {
                 return err(new BrowserError(result.error ?? 'Stop trace failed', 'STOP_TRACE_FAILED', 'agent-browser'));
             }
@@ -815,28 +815,13 @@ export function createAgentBrowserClient(config) {
  * Only use in test environments.
  */
 export async function cleanupAllBrowserProcesses() {
-    const { execSync } = await import('child_process');
-    try {
-        // Kill agent-browser daemons
-        execSync('pkill -9 -f "agent-browser.*daemon" 2>/dev/null || true', {
-            timeout: 5000,
-            stdio: 'ignore'
-        });
-    }
-    catch (error) {
-        // Non-critical: daemon cleanup errors
-        console.debug('[AgentBrowserClient] Daemon cleanup error:', error instanceof Error ? error.message : error);
-    }
-    try {
-        // Kill chromium headless shell processes
-        execSync('pkill -9 -f "chromium_headless_shell\\|headless_shell" 2>/dev/null || true', {
-            timeout: 5000,
-            stdio: 'ignore'
-        });
-    }
-    catch (error) {
-        // Non-critical: chromium cleanup errors
-        console.debug('[AgentBrowserClient] Chromium cleanup error:', error instanceof Error ? error.message : error);
-    }
+    const { runTestRunnerProcess } = await import('../../../shared/test-runner-process.js');
+    // pkill exits 1 when nothing matched; cleanup is best effort either way
+    const pkill = async (pattern) => {
+        await runTestRunnerProcess('pkill', ['-9', '-f', pattern], { cwd: process.cwd(), timeout: 5000 });
+    };
+    // Kill agent-browser daemons, then chromium headless shell processes
+    await pkill('agent-browser.*daemon');
+    await pkill('chromium_headless_shell\\|headless_shell');
 }
 //# sourceMappingURL=client.js.map

package/dist/integrations/browser/agent-browser/command-executor.d.ts

@@ -2,6 +2,12 @@
  * agent-browser CLI Command Executor
  * Wraps CLI calls with type safety and error handling
  */
+import { type TestRunnerProcessResult } from '../../../shared/test-runner-process.js';
+/**
+ * Run `npx agent-browser ...` without blocking the event loop (#1115). A
+ * timeout stops the whole npx process tree, as the synchronous call did not.
+ */
+export declare function runAgentBrowser(args: string[], timeout: number, maxBuffer?: number): Promise<TestRunnerProcessResult>;
 export interface CommandResult<T = unknown> {
     success: boolean;
     data?: T;
@@ -21,9 +27,9 @@ export declare class AgentBrowserCommandExecutor {
     private browserLaunched;
     constructor(config?: CommandExecutorConfig);
     /**
-     * Execute a command synchronously and parse JSON result
+     * Execute a command and parse JSON result
      */
-    execute<T = unknown>(command: string, args?: string[]): CommandResult<T>;
+    execute<T = unknown>(command: string, args?: string[]): Promise<CommandResult<T>>;
     /**
      * Execute a command asynchronously (for long-running ops)
      */
@@ -31,17 +37,17 @@ export declare class AgentBrowserCommandExecutor {
     /**
      * Open URL in browser (auto-launches if needed)
      */
-    open(url: string): CommandResult<void>;
+    open(url: string): Promise<CommandResult<void>>;
     /**
      * Close browser
      */
-    close(): CommandResult<void>;
+    close(): Promise<CommandResult<void>>;
     /**
      * Terminate the daemon process for this session
      * CRITICAL: Must be called to prevent memory leaks!
      * The daemon persists even after close() - this kills it entirely.
      */
-    terminateDaemon(): CommandResult<void>;
+    terminateDaemon(): Promise<CommandResult<void>>;
     /**
      * Get accessibility snapshot with refs
      */
@@ -49,89 +55,89 @@ export declare class AgentBrowserCommandExecutor {
         interactive?: boolean;
         compact?: boolean;
         depth?: number;
-    }): CommandResult<string>;
+    }): Promise<CommandResult<string>>;
     /**
      * Click element by ref or selector
      */
-    click(target: string): CommandResult<void>;
+    click(target: string): Promise<CommandResult<void>>;
     /**
      * Fill input by ref or selector
      */
-    fill(target: string, text: string): CommandResult<void>;
+    fill(target: string, text: string): Promise<CommandResult<void>>;
     /**
      * Type text (without clearing)
      */
-    type(target: string, text: string): CommandResult<void>;
+    type(target: string, text: string): Promise<CommandResult<void>>;
     /**
      * Get element text
      */
-    getText(target: string): CommandResult<string>;
+    getText(target: string): Promise<CommandResult<string>>;
     /**
      * Check if element is visible
      */
-    isVisible(target: string): CommandResult<boolean>;
+    isVisible(target: string): Promise<CommandResult<boolean>>;
     /**
      * Take screenshot
      */
-    screenshot(path?: string, fullPage?: boolean): CommandResult<string>;
+    screenshot(path?: string, fullPage?: boolean): Promise<CommandResult<string>>;
     /**
      * Wait for element
      */
-    waitForElement(target: string, timeout?: number): CommandResult<void>;
+    waitForElement(target: string, timeout?: number): Promise<CommandResult<void>>;
     /**
      * Wait for text to appear
      */
-    waitForText(text: string): CommandResult<void>;
+    waitForText(text: string): Promise<CommandResult<void>>;
     /**
      * Wait for URL pattern
      */
-    waitForUrl(pattern: string): CommandResult<void>;
+    waitForUrl(pattern: string): Promise<CommandResult<void>>;
     /**
      * Wait for network idle
      */
-    waitForNetworkIdle(): CommandResult<void>;
+    waitForNetworkIdle(): Promise<CommandResult<void>>;
     /**
      * Set device emulation
      */
-    setDevice(deviceName: string): CommandResult<void>;
+    setDevice(deviceName: string): Promise<CommandResult<void>>;
     /**
      * Set viewport size
      */
-    setViewport(width: number, height: number): CommandResult<void>;
+    setViewport(width: number, height: number): Promise<CommandResult<void>>;
     /**
      * Mock network route
      */
-    mockRoute(urlPattern: string, body: unknown): CommandResult<void>;
+    mockRoute(urlPattern: string, body: unknown): Promise<CommandResult<void>>;
     /**
      * Abort network route
      */
-    abortRoute(urlPattern: string): CommandResult<void>;
+    abortRoute(urlPattern: string): Promise<CommandResult<void>>;
     /**
      * Clear network routes
      */
-    clearRoutes(): CommandResult<void>;
+    clearRoutes(): Promise<CommandResult<void>>;
     /**
      * Save browser state (cookies, storage)
      */
-    saveState(path: string): CommandResult<void>;
+    saveState(path: string): Promise<CommandResult<void>>;
     /**
      * Load browser state
      */
-    loadState(path: string): CommandResult<void>;
+    loadState(path: string): Promise<CommandResult<void>>;
     /**
      * Start trace recording
      * Records browser activity for debugging and analysis
      */
-    startTrace(): CommandResult<void>;
+    startTrace(): Promise<CommandResult<void>>;
     /**
      * Stop trace recording and save to file
      * @param outputPath - Path to save the trace file
      */
-    stopTrace(outputPath: string): CommandResult<string>;
+    stopTrace(outputPath: string): Promise<CommandResult<string>>;
     /**
      * Evaluate JavaScript in page context
      */
-    eval<T = unknown>(script: string): CommandResult<T>;
+    eval<T = unknown>(script: string): Promise<CommandResult<T>>;
     /**
      * Get current session name
      */
@@ -145,5 +151,5 @@ export declare class AgentBrowserCommandExecutor {
 /**
  * Check if agent-browser CLI is available
  */
-export declare function isAgentBrowserAvailable(): boolean;
+export declare function isAgentBrowserAvailable(): Promise<boolean>;
 //# sourceMappingURL=command-executor.d.ts.map