navcli 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

navcli/server/__init__.py

@@ -22,13 +22,15 @@ _NAVCLI_SESSIONS_DIR = os.path.join(_NAVCLI_HOME, "sessions")
 _server: Optional[uvicorn.Server] = None
 
 
-async def start_server(host: str = "127.0.0.1", port: int = 8765, headless: bool = True) -> uvicorn.Server:
+async def start_server(host: str = "127.0.0.1", port: int = 8765, headless: bool = True,
+                       browser_args: Optional[list] = None) -> uvicorn.Server:
     """Start the browser server.
 
     Args:
         host: Host to bind
         port: Port to listen
         headless: Run browser in headless mode (default: True)
+        browser_args: Additional browser launch arguments
 
     Returns:
         Uvicorn server instance
@@ -36,7 +38,7 @@ async def start_server(host: str = "127.0.0.1", port: int = 8765, headless: bool
     global _server
 
     # Start browser
-    await start_browser(headless=headless)
+    await start_browser(headless=headless, args=browser_args)
 
     # Create app
     app = create_app()
@@ -80,9 +82,20 @@ def main():
                         help="Run in headless mode (default)")
     parser.add_argument("--no-headless", dest="headless", action="store_false",
                         help="Run with GUI (non-headless)")
+    parser.add_argument("--memory-limit", type=int, default=None,
+                        help="Browser memory limit in MB (e.g., --memory-limit 512)")
 
     args = parser.parse_args()
 
+    # Build browser args for memory limit
+    browser_args = None
+    if args.memory_limit:
+        browser_args = [
+            f"--js-flags=--max-old-space-size={args.memory_limit}",
+            "--disable-dev-shm-usage",
+        ]
+        print(f"Memory limit: {args.memory_limit}MB")
+
     print(f"Starting NavCLI Browser Server on {args.host}:{args.port}...")
     print(f"Headless: {args.headless}")
     print("-" * 60)
@@ -117,7 +130,7 @@ def main():
     print("-" * 60)
 
     try:
-        asyncio.run(start_server(args.host, args.port, headless=args.headless))
+        asyncio.run(start_server(args.host, args.port, headless=args.headless, browser_args=browser_args))
     except KeyboardInterrupt:
         print("\nShutting down...")
         sys.exit(0)

navcli/server/app.py

@@ -1,6 +1,7 @@
 """FastAPI application for NavCLI Browser Server."""
 
-from fastapi import FastAPI
+import time
+from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
 
 from navcli.server.routes import navigation, interaction, query, explore, control, session
@@ -23,6 +24,29 @@ def create_app() -> FastAPI:
         allow_headers=["*"],
     )
 
+    # Request logging middleware
+    @app.middleware("http")
+    async def log_requests(request: Request, call_next):
+        start_time = time.time()
+
+        # Log request
+        method = request.method
+        path = request.url.path
+        query_str = request.url.query
+        if query_str:
+            print(f"[CMD] {method} {path}?{query_str}")
+        else:
+            print(f"[CMD] {method} {path}")
+
+        # Process request
+        response = await call_next(request)
+
+        # Log response time
+        process_time = time.time() - start_time
+        print(f"[DONE] {method} {path} - {response.status_code} ({process_time:.2f}s)")
+
+        return response
+
     # Include routes
     app.include_router(navigation.router, prefix="/cmd")
     app.include_router(interaction.router, prefix="/cmd")

navcli/server/browser.py

@@ -25,11 +25,12 @@ _NAVCLI_SESSIONS_DIR = os.path.join(_NAVCLI_HOME, "sessions")
 _storage_state_path: str = os.path.join(_NAVCLI_SESSIONS_DIR, "session.json")  # Default session file
 
 
-async def start_browser(headless: bool = True):
+async def start_browser(headless: bool = True, args: Optional[list] = None):
     """Start the browser.
 
     Args:
         headless: Whether to run in headless mode (default: True)
+        args: Additional browser launch arguments
     """
     global _browser, _context, _page
 
@@ -43,6 +44,8 @@ async def start_browser(headless: bool = True):
     user_data_dir = os.environ.get("NAVCLI_USER_DATA_DIR")
 
     launch_kwargs = {"headless": headless}
+    if args:
+        launch_kwargs["args"] = args
     if executable_path:
         launch_kwargs["executable_path"] = executable_path
 

navcli/server/routes/control.py

@@ -8,10 +8,16 @@ from navcli.server.browser import close_browser, get_current_state, start_browse
 router = APIRouter()
 
 
+def log_progress(message: str):
+    """Print progress message."""
+    print(f"[PROGRESS] {message}")
+
+
 @router.post("/quit")
 async def quit() -> CommandResult:
     """Quit and close the browser server."""
     try:
+        log_progress("Quitting browser...")
         # Get final state before closing
         try:
             state = await get_current_state()
@@ -20,6 +26,7 @@ async def quit() -> CommandResult:
 
         # Close browser
         await close_browser()
+        log_progress("Browser closed")
 
         return CommandResult(
             success=True,
@@ -31,6 +38,7 @@ async def quit() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="quit",
@@ -41,4 +49,5 @@ async def quit() -> CommandResult:
 @router.post("/shutdown")
 async def shutdown() -> CommandResult:
     """Shutdown the server (same as quit)."""
+    log_progress("Shutting down server...")
     return await quit()

navcli/server/routes/explore.py

@@ -12,6 +12,11 @@ from navcli.utils import wait_for_condition
 router = APIRouter(prefix="/explore")
 
 
+def log_progress(message: str):
+    """Print progress message."""
+    print(f"[PROGRESS] {message}")
+
+
 class FindRequest(BaseModel):
     text: str
 
@@ -23,6 +28,8 @@ async def find(text: str = Query(...)) -> CommandResult:
         if not text:
             raise HTTPException(status_code=400, detail="text is required")
 
+        log_progress(f"Finding element with text: {text}")
+
         await start_browser()
         page = get_page()
 
@@ -34,6 +41,7 @@ async def find(text: str = Query(...)) -> CommandResult:
                 # Get element info
                 tag = await locator.evaluate_handle("el => el.tagName")
                 element_text = await locator.inner_text()
+                log_progress(f"Found: <{tag.lower()}> {element_text[:50]}...")
 
                 element = Element(
                     selector=f"text={text}",
@@ -56,6 +64,7 @@ async def find(text: str = Query(...)) -> CommandResult:
                     ),
                 )
             else:
+                log_progress(f"No element found with text: {text}")
                 return CommandResult(
                     success=False,
                     command="find",
@@ -63,9 +72,11 @@ async def find(text: str = Query(...)) -> CommandResult:
                 )
         except Exception:
             # Fallback: search all elements
+            log_progress(f"Fallback: searching elements for text: {text}")
             state = await get_current_state()
             for elem in state.dom.elements:
                 if text.lower() in elem.text.lower():
+                    log_progress(f"Found: {elem.selector}")
                     return CommandResult(
                         success=True,
                         command="find",
@@ -76,12 +87,14 @@ async def find(text: str = Query(...)) -> CommandResult:
                         ),
                     )
 
+            log_progress(f"No elements found with text: {text}")
             return CommandResult(
                 success=False,
                 command="find",
                 error=f"no element found with text: {text}",
             )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="find",
@@ -100,12 +113,15 @@ async def findall(text: str = Query(...)) -> CommandResult:
         if not text:
             raise HTTPException(status_code=400, detail="text is required")
 
+        log_progress(f"Finding all elements with text: {text}")
+
         await start_browser()
         state = await get_current_state()
 
         matching = [e for e in state.dom.elements if text.lower() in e.text.lower()]
 
         if matching:
+            log_progress(f"Found {len(matching)} elements")
             state.dom.elements = matching
             return CommandResult(
                 success=True,
@@ -117,12 +133,14 @@ async def findall(text: str = Query(...)) -> CommandResult:
                 ),
             )
         else:
+            log_progress(f"No elements found with text: {text}")
             return CommandResult(
                 success=False,
                 command="findall",
                 error=f"no elements found with text: {text}",
             )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="findall",
@@ -141,6 +159,8 @@ async def inspect(selector: str = Query(...)) -> CommandResult:
         if not selector:
             raise HTTPException(status_code=400, detail="selector is required")
 
+        log_progress(f"Inspecting element: {selector}")
+
         await start_browser()
         page = get_page()
 
@@ -148,6 +168,7 @@ async def inspect(selector: str = Query(...)) -> CommandResult:
         count = locator.count()
 
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="inspect",
@@ -189,6 +210,7 @@ async def inspect(selector: str = Query(...)) -> CommandResult:
 
         state = await get_current_state()
         state.dom.elements = [element]
+        log_progress(f"Inspected: <{tag.lower()}> {text[:30]}...")
 
         return CommandResult(
             success=True,
@@ -200,6 +222,7 @@ async def inspect(selector: str = Query(...)) -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="inspect",
@@ -221,9 +244,11 @@ async def wait(req: WaitRequest) -> CommandResult:
 
         if req.selector:
             # Wait for selector
+            log_progress(f"Waiting for selector: {req.selector}")
             try:
                 await page.wait_for_selector(req.selector, timeout=10000)
                 state = await get_current_state()
+                log_progress(f"Selector appeared: {req.selector}")
                 return CommandResult(
                     success=True,
                     command="wait",
@@ -234,6 +259,7 @@ async def wait(req: WaitRequest) -> CommandResult:
                     ),
                 )
             except asyncio.TimeoutError:
+                log_progress(f"Timeout waiting for: {req.selector}")
                 return CommandResult(
                     success=False,
                     command="wait",
@@ -241,6 +267,7 @@ async def wait(req: WaitRequest) -> CommandResult:
                 )
         elif req.seconds:
             # Wait for seconds
+            log_progress(f"Waiting {req.seconds}s...")
             await asyncio.sleep(req.seconds)
             state = await get_current_state()
             return CommandResult(
@@ -254,8 +281,10 @@ async def wait(req: WaitRequest) -> CommandResult:
             )
         else:
             # Default: wait for network idle
+            log_progress("Waiting for network idle...")
             await wait_for_network_idle(3.0)
             state = await get_current_state()
+            log_progress("Network idle")
             return CommandResult(
                 success=True,
                 command="wait",
@@ -266,6 +295,7 @@ async def wait(req: WaitRequest) -> CommandResult:
                 ),
             )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="wait",
@@ -277,10 +307,12 @@ async def wait(req: WaitRequest) -> CommandResult:
 async def wait_idle(timeout: float = 3.0) -> CommandResult:
     """Wait for network idle."""
     try:
+        log_progress(f"Waiting for network idle (timeout: {timeout}s)...")
         await start_browser()
         idle = await wait_for_network_idle(timeout)
 
         state = await get_current_state()
+        log_progress(f"Network idle: {idle}")
 
         return CommandResult(
             success=True,
@@ -292,6 +324,7 @@ async def wait_idle(timeout: float = 3.0) -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="wait_idle",
@@ -321,9 +354,11 @@ async def scroll(req: ScrollRequest) -> CommandResult:
 
         if req.selector:
             # Scroll element into view
+            log_progress(f"Scrolling to element: {req.selector}")
             locator = page.locator(req.selector)
             count = locator.count()
             if count == 0:
+                log_progress(f"Element not found: {req.selector}")
                 return CommandResult(
                     success=False,
                     command="scroll",
@@ -333,6 +368,7 @@ async def scroll(req: ScrollRequest) -> CommandResult:
             action = f"scrolled to {req.selector}"
         elif req.direction:
             # Directional scroll
+            log_progress(f"Scrolling {req.direction}...")
             if req.direction == "top":
                 await page.evaluate("window.scrollTo(0, 0)")
                 action = "scrolled to top"
@@ -353,6 +389,7 @@ async def scroll(req: ScrollRequest) -> CommandResult:
                 )
         elif req.x is not None and req.y is not None:
             # Coordinate scroll
+            log_progress(f"Scrolling to ({req.x}, {req.y})")
             await page.evaluate(f"window.scrollTo({req.x}, {req.y})")
             action = f"scrolled to ({req.x}, {req.y})"
         else:
@@ -364,6 +401,7 @@ async def scroll(req: ScrollRequest) -> CommandResult:
 
         await asyncio.sleep(0.3)  # Brief wait for scroll to complete
         state = await get_current_state()
+        log_progress(action)
 
         return CommandResult(
             success=True,
@@ -375,6 +413,7 @@ async def scroll(req: ScrollRequest) -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="scroll",

navcli/server/routes/interaction.py

@@ -9,6 +9,11 @@ from navcli.server.browser import get_page, get_current_state, start_browser, wa
 router = APIRouter()
 
 
+def log_progress(message: str):
+    """Print progress message."""
+    print(f"[PROGRESS] {message}")
+
+
 @router.post("/click")
 async def click(
     selector: str = Query(..., description="CSS selector"),
@@ -19,6 +24,8 @@ async def click(
         if not selector:
             raise HTTPException(status_code=400, detail="selector is required")
 
+        log_progress(f"Clicking '{selector}'...")
+
         await start_browser()
         page = get_page()
 
@@ -27,6 +34,7 @@ async def click(
         # Check if element exists
         count = locator.count()
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="click",
@@ -34,6 +42,7 @@ async def click(
             )
 
         if count > 1:
+            log_progress(f"Multiple elements found: {selector}")
             return CommandResult(
                 success=False,
                 command="click",
@@ -43,8 +52,10 @@ async def click(
         # Click
         if force:
             await locator.click(force=True)
+            log_progress(f"Force clicked '{selector}'")
         else:
             await locator.click()
+            log_progress(f"Clicked '{selector}'")
 
         # Wait for network idle
         await wait_for_network_idle(3.0)
@@ -61,6 +72,7 @@ async def click(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="click",
@@ -80,6 +92,8 @@ async def type_text(
         if not text:
             raise HTTPException(status_code=400, detail="text is required")
 
+        log_progress(f"Typing into '{selector}': {text[:30]}...")
+
         await start_browser()
         page = get_page()
 
@@ -88,6 +102,7 @@ async def type_text(
         # Check if element exists
         count = locator.count()
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="type",
@@ -97,6 +112,7 @@ async def type_text(
         # Clear and type
         await locator.clear()
         await locator.fill(text)
+        log_progress(f"Typed into '{selector}'")
 
         state = await get_current_state()
 
@@ -110,6 +126,7 @@ async def type_text(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="type",
@@ -126,6 +143,8 @@ async def clear_input(
         if not selector:
             raise HTTPException(status_code=400, detail="selector is required")
 
+        log_progress(f"Clearing '{selector}'...")
+
         await start_browser()
         page = get_page()
 
@@ -134,6 +153,7 @@ async def clear_input(
         # Check if element exists
         count = locator.count()
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="clear",
@@ -142,6 +162,7 @@ async def clear_input(
 
         # Clear
         await locator.clear()
+        log_progress(f"Cleared '{selector}'")
 
         state = await get_current_state()
 
@@ -155,6 +176,7 @@ async def clear_input(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="clear",
@@ -174,9 +196,12 @@ async def upload_file(
         if not file_path:
             raise HTTPException(status_code=400, detail="file_path is required")
 
+        log_progress(f"Uploading '{file_path}' to '{selector}'...")
+
         # Check if file exists
         import os
         if not os.path.exists(file_path):
+            log_progress(f"File not found: {file_path}")
             return CommandResult(
                 success=False,
                 command="upload",
@@ -191,6 +216,7 @@ async def upload_file(
         # Check if element exists
         count = locator.count()
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="upload",
@@ -199,6 +225,7 @@ async def upload_file(
 
         # Upload file
         await locator.set_input_files(file_path)
+        log_progress(f"Uploaded '{file_path}'")
 
         state = await get_current_state()
 
@@ -212,6 +239,7 @@ async def upload_file(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="upload",
@@ -228,18 +256,22 @@ async def dblclick(
         if not selector:
             raise HTTPException(status_code=400, detail="selector is required")
 
+        log_progress(f"Double-clicking '{selector}'...")
+
         await start_browser()
         page = get_page()
 
         locator = page.locator(selector)
         count = locator.count()
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="dblclick",
                 error=f"element not found: {selector}",
             )
         if count > 1:
+            log_progress(f"Multiple elements found: {selector}")
             return CommandResult(
                 success=False,
                 command="dblclick",
@@ -247,6 +279,7 @@ async def dblclick(
             )
 
         await locator.dblclick()
+        log_progress(f"Double-clicked '{selector}'")
 
         await wait_for_network_idle(3.0)
         state = await get_current_state()
@@ -261,6 +294,7 @@ async def dblclick(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="dblclick",
@@ -277,18 +311,22 @@ async def rightclick(
         if not selector:
             raise HTTPException(status_code=400, detail="selector is required")
 
+        log_progress(f"Right-clicking '{selector}'...")
+
         await start_browser()
         page = get_page()
 
         locator = page.locator(selector)
         count = locator.count()
         if count == 0:
+            log_progress(f"Element not found: {selector}")
             return CommandResult(
                 success=False,
                 command="rightclick",
                 error=f"element not found: {selector}",
             )
         if count > 1:
+            log_progress(f"Multiple elements found: {selector}")
             return CommandResult(
                 success=False,
                 command="rightclick",
@@ -296,6 +334,7 @@ async def rightclick(
             )
 
         await locator.click(button="right")
+        log_progress(f"Right-clicked '{selector}'")
 
         await wait_for_network_idle(3.0)
         state = await get_current_state()
@@ -310,6 +349,7 @@ async def rightclick(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="rightclick",

navcli/server/routes/navigation.py

@@ -1,5 +1,6 @@
 """Navigation routes: goto, back, forward, reload."""
 
+import time
 from typing import Optional
 from fastapi import APIRouter, HTTPException, Query
 
@@ -10,6 +11,11 @@ from navcli.utils import normalize_url
 router = APIRouter()
 
 
+def log_progress(message: str):
+    """Print progress message."""
+    print(f"[PROGRESS] {message}")
+
+
 @router.post("/goto")
 async def goto(
     url: str = Query(..., description="URL to navigate to"),
@@ -21,6 +27,7 @@ async def goto(
             raise HTTPException(status_code=400, detail="url is required")
 
         normalized_url = normalize_url(url)
+        log_progress(f"Navigating to {normalized_url}...")
 
         # Start browser if not started
         await start_browser()
@@ -28,12 +35,17 @@ async def goto(
 
         # Navigate
         await page.goto(normalized_url, wait_until=wait_until)
+        log_progress(f"Page loaded, waiting for network idle...")
 
         # Wait for network idle
+        start_wait = time.time()
         await wait_for_network_idle(3.0)
+        wait_time = time.time() - start_wait
+        log_progress(f"Network idle after {wait_time:.1f}s")
 
         # Get new state
         state = await get_current_state()
+        log_progress(f"Page title: {state.title}")
 
         return CommandResult(
             success=True,
@@ -45,6 +57,7 @@ async def goto(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="goto",
@@ -56,11 +69,13 @@ async def goto(
 async def back() -> CommandResult:
     """Go back in history."""
     try:
+        log_progress("Going back...")
         page = get_page()
         await page.go_back()
         await wait_for_network_idle(3.0)
 
         state = await get_current_state()
+        log_progress(f"Back to: {state.url}")
 
         return CommandResult(
             success=True,
@@ -72,6 +87,7 @@ async def back() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="back",
@@ -83,11 +99,13 @@ async def back() -> CommandResult:
 async def forward() -> CommandResult:
     """Go forward in history."""
     try:
+        log_progress("Going forward...")
         page = get_page()
         await page.go_forward()
         await wait_for_network_idle(3.0)
 
         state = await get_current_state()
+        log_progress(f"Forward to: {state.url}")
 
         return CommandResult(
             success=True,
@@ -99,6 +117,7 @@ async def forward() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="forward",
@@ -110,11 +129,13 @@ async def forward() -> CommandResult:
 async def reload() -> CommandResult:
     """Reload the current page."""
     try:
+        log_progress("Reloading page...")
         page = get_page()
         await page.reload()
         await wait_for_network_idle(3.0)
 
         state = await get_current_state()
+        log_progress(f"Reloaded: {state.url}")
 
         return CommandResult(
             success=True,
@@ -126,6 +147,7 @@ async def reload() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="reload",

navcli/server/routes/query.py

@@ -9,12 +9,19 @@ from navcli.utils import encode_screenshot
 router = APIRouter(prefix="/query")
 
 
+def log_progress(message: str):
+    """Print progress message."""
+    print(f"[PROGRESS] {message}")
+
+
 @router.get("/elements")
 async def get_elements() -> CommandResult:
     """Get interactive elements on the page."""
     try:
+        log_progress("Getting elements...")
         await start_browser()
         state = await get_current_state()
+        log_progress(f"Found {len(state.dom.elements)} elements")
 
         return CommandResult(
             success=True,
@@ -26,6 +33,7 @@ async def get_elements() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="elements",
@@ -37,8 +45,10 @@ async def get_elements() -> CommandResult:
 async def get_text() -> CommandResult:
     """Get page text content."""
     try:
+        log_progress("Getting text content...")
         page = get_page()
         text = await page.inner_text("body")
+        log_progress(f"Text length: {len(text)} chars")
 
         await start_browser()
         state = await get_current_state()
@@ -53,6 +63,7 @@ async def get_text() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="text",
@@ -73,6 +84,7 @@ async def get_paragraphs(min_length: int = 200) -> CommandResult:
         List of paragraphs with their text, length, and CSS selector
     """
     try:
+        log_progress(f"Extracting paragraphs (min {min_length} chars)...")
         page = get_page()
 
         # Extract paragraphs and large text blocks using JavaScript
@@ -151,6 +163,7 @@ async def get_paragraphs(min_length: int = 200) -> CommandResult:
         paragraphs = [
             Paragraph(**p) for p in paragraphs_data[:50]  # Limit to 50 paragraphs
         ]
+        log_progress(f"Found {len(paragraphs)} paragraphs")
 
         await start_browser()
         state = await get_current_state()
@@ -167,6 +180,7 @@ async def get_paragraphs(min_length: int = 200) -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="paragraphs",
@@ -178,8 +192,10 @@ async def get_paragraphs(min_length: int = 200) -> CommandResult:
 async def get_html() -> CommandResult:
     """Get page HTML content."""
     try:
+        log_progress("Getting HTML content...")
         page = get_page()
         html = await page.content()
+        log_progress(f"HTML length: {len(html)} chars")
 
         await start_browser()
         state = await get_current_state()
@@ -194,6 +210,7 @@ async def get_html() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="html",
@@ -205,9 +222,11 @@ async def get_html() -> CommandResult:
 async def get_screenshot() -> CommandResult:
     """Get page screenshot as base64."""
     try:
+        log_progress("Taking screenshot...")
         page = get_page()
         screenshot_bytes = await page.screenshot()
         screenshot_base64 = encode_screenshot(screenshot_bytes)
+        log_progress(f"Screenshot size: {len(screenshot_bytes)} bytes")
 
         await start_browser()
         state = await get_current_state()
@@ -222,6 +241,7 @@ async def get_screenshot() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="screenshot",
@@ -233,8 +253,10 @@ async def get_screenshot() -> CommandResult:
 async def get_state() -> CommandResult:
     """Get full page state."""
     try:
+        log_progress("Getting page state...")
         await start_browser()
         state = await get_current_state()
+        log_progress(f"Page: {state.title} ({state.url})")
 
         return CommandResult(
             success=True,
@@ -246,6 +268,7 @@ async def get_state() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="state",
@@ -257,8 +280,10 @@ async def get_state() -> CommandResult:
 async def get_url() -> CommandResult:
     """Get current URL."""
     try:
+        log_progress("Getting URL...")
         page = get_page()
         url = page.url
+        log_progress(f"URL: {url}")
 
         await start_browser()
         state = await get_current_state()
@@ -273,6 +298,7 @@ async def get_url() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="url",
@@ -284,8 +310,10 @@ async def get_url() -> CommandResult:
 async def get_title() -> CommandResult:
     """Get page title."""
     try:
+        log_progress("Getting title...")
         page = get_page()
         title = await page.title()
+        log_progress(f"Title: {title}")
 
         await start_browser()
         state = await get_current_state()
@@ -300,6 +328,7 @@ async def get_title() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="title",
@@ -314,6 +343,7 @@ async def evaluate(expr: str) -> CommandResult:
     Usage: /query/evaluate?expr=<js_expression>
     """
     try:
+        log_progress(f"Evaluating JS: {expr[:50]}...")
         await start_browser()
         page = get_page()
 
@@ -331,6 +361,7 @@ async def evaluate(expr: str) -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="evaluate",
@@ -342,6 +373,7 @@ async def evaluate(expr: str) -> CommandResult:
 async def get_links() -> CommandResult:
     """Get all links on the page."""
     try:
+        log_progress("Extracting links...")
         await start_browser()
         page = get_page()
 
@@ -352,6 +384,7 @@ async def get_links() -> CommandResult:
                 visible: a.offsetParent !== null
             }))
         """)
+        log_progress(f"Found {len(links)} links")
 
         state = await get_current_state()
 
@@ -365,6 +398,7 @@ async def get_links() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="links",
@@ -376,6 +410,7 @@ async def get_links() -> CommandResult:
 async def get_forms() -> CommandResult:
     """Get all forms on the page."""
     try:
+        log_progress("Extracting forms...")
         await start_browser()
         page = get_page()
 
@@ -391,6 +426,7 @@ async def get_forms() -> CommandResult:
                 }))
             }))
         """)
+        log_progress(f"Found {len(forms)} forms")
 
         state = await get_current_state()
 
@@ -404,6 +440,7 @@ async def get_forms() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="forms",
@@ -415,6 +452,7 @@ async def get_forms() -> CommandResult:
 async def get_tables() -> CommandResult:
     """Get all tables on the page with their data."""
     try:
+        log_progress("Extracting tables...")
         await start_browser()
         page = get_page()
 
@@ -444,6 +482,7 @@ async def get_tables() -> CommandResult:
         total_rows = sum(t['rowCount'] for t in tables)
         # Add tables to state
         state.tables = tables
+        log_progress(f"Found {len(tables)} tables, {total_rows} rows total")
 
         return CommandResult(
             success=True,
@@ -455,6 +494,7 @@ async def get_tables() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="tables",

navcli/server/routes/session.py

@@ -21,6 +21,11 @@ _NAVCLI_SESSIONS_DIR = os.path.join(_NAVCLI_HOME, "sessions")
 router = APIRouter()
 
 
+def log_progress(message: str):
+    """Print progress message."""
+    print(f"[PROGRESS] {message}")
+
+
 class CookieSetRequest(BaseModel):
     """Request body for setting a cookie."""
     name: str
@@ -40,7 +45,9 @@ async def query_cookies() -> CommandResult:
     Returns list of cookies with name, value, domain, path, etc.
     """
     try:
+        log_progress("Getting cookies...")
         cookies = await get_cookies()
+        log_progress(f"Found {len(cookies)} cookies")
 
         return CommandResult(
             success=True,
@@ -51,6 +58,7 @@ async def query_cookies() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="cookies",
@@ -65,6 +73,7 @@ async def set_cookie_route(request: CookieSetRequest) -> CommandResult:
     Usage: POST /cmd/cookies/set with JSON body
     """
     try:
+        log_progress(f"Setting cookie: {request.name}")
         await set_cookie(
             name=request.name,
             value=request.value,
@@ -85,6 +94,7 @@ async def set_cookie_route(request: CookieSetRequest) -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="set_cookie",
@@ -99,7 +109,9 @@ async def clear_cookies_route() -> CommandResult:
     Returns the number of cookies that were cleared.
     """
     try:
+        log_progress("Clearing cookies...")
         count = await clear_cookies()
+        log_progress(f"Cleared {count} cookies")
 
         return CommandResult(
             success=True,
@@ -110,6 +122,7 @@ async def clear_cookies_route() -> CommandResult:
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="clear_cookies",
@@ -139,10 +152,12 @@ async def save_session_route(
         else:
             save_path = os.path.join(_NAVCLI_SESSIONS_DIR, "session.json")
 
+        log_progress(f"Saving session to {save_path}...")
         storage_state = await save_session(save_path)
 
         cookie_count = len(storage_state.get("cookies", []))
         origin_count = len(storage_state.get("origins", []))
+        log_progress(f"Saved: {cookie_count} cookies, {origin_count} origins")
 
         return CommandResult(
             success=True,
@@ -153,6 +168,7 @@ async def save_session_route(
             ),
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="save_session",
@@ -182,7 +198,9 @@ async def load_session_route(
         load_path = os.path.join(_NAVCLI_SESSIONS_DIR, "session.json")
 
     try:
+        log_progress(f"Loading session from {load_path}...")
         await load_session(load_path)
+        log_progress("Session loaded")
 
         return CommandResult(
             success=True,
@@ -193,12 +211,14 @@ async def load_session_route(
             ),
         )
     except FileNotFoundError:
+        log_progress(f"Session file not found: {load_path}")
         return CommandResult(
             success=False,
             command="load_session",
             error=f"Session file not found: {load_path}",
         )
     except Exception as e:
+        log_progress(f"Error: {e}")
         return CommandResult(
             success=False,
             command="load_session",

{navcli-0.2.1.dist-info → navcli-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: navcli
-Version: 0.2.1
+Version: 0.2.3
 Summary: 可交互、可探索的浏览器命令行工具，专为 AI Agent 设计
 Author: NavCLI Team
 License: MIT

{navcli-0.2.1.dist-info → navcli-0.2.3.dist-info}/RECORD

@@ -14,17 +14,17 @@ navcli/core/models/dom.py,sha256=vZzEpzLEOlCnUJWBWx0-gmHj8WBxorsnPsZJgUW3UOE,116
 navcli/core/models/element.py,sha256=6L8PnY7h_-_MFweq6NU6gdG1g5_r_AHlW1bYTuUBNoM,747
 navcli/core/models/feedback.py,sha256=K67nc7fCiAAfeYKDppNEnHtM41fSdF-Ai7IMhvAv7PY,689
 navcli/core/models/state.py,sha256=6TBh6zMX8uhBcFICNLFgJhPKLRbET47fjZTjvt3n0Hw,1002
-navcli/server/__init__.py,sha256=KUgDIwwAhzq-5UcUV8A2pcXW6AhPFy6mGFvFThTjvjs,3694
-navcli/server/app.py,sha256=zNWYPGRGVWmoyiZX1g9i6LNqSagJirwzEi8eqsYUUqs,1320
-navcli/server/browser.py,sha256=LAOQO157dYO1YVQe88hAnFISK0nKkq8MP96N9BRjr3I,12115
+navcli/server/__init__.py,sha256=eyUU2kDdtwRwHqhBTJ3vpqp86WAMpBpsnhbniALSa3E,4299
+navcli/server/app.py,sha256=lMMXuJzB-7FOGfCXJosoMRV0mP51O2pF24KZDdC4p20,2015
+navcli/server/browser.py,sha256=OneOVyd3yQnVSGiY0EU6WZ2RrR0QJa8FbZlWAF6eTF8,12244
 navcli/server/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 navcli/server/routes/__init__.py,sha256=LCd1lCcBCqJmFchr9OTvKJvCTQNLETAljdPaou-fd3I,180
-navcli/server/routes/control.py,sha256=ysoszU2OjhVH4BW3oahJ5-28l3yheQ-vhdqI-I8EVEU,1071
-navcli/server/routes/explore.py,sha256=562B8DzcQhNCPwuZleOjn9edQ-rowMz7bBFWZYpCWpM,11879
-navcli/server/routes/interaction.py,sha256=Daq-6Rp7FlWjyMK-HHYGKwQLHDBYWzC0GLq1q346Zxw,8562
-navcli/server/routes/navigation.py,sha256=ZDcblrKnOTDn8aeBKwWgZYHQke6Hmrm_NNtTNSC3MQU,3440
-navcli/server/routes/query.py,sha256=grKvUDnv7cQudwPx_OgQUgkwgABoqLvRVLQrZP7WyI4,13560
-navcli/server/routes/session.py,sha256=vRTwxg19fRu1ajzn4yyIAqbQJsnRIPAYQEMae-pQQ6E,5480
+navcli/server/routes/control.py,sha256=Hn1giy5H-PdpiwY-AiKsFWDNfIYk0erDxbMeksBGqEY,1337
+navcli/server/routes/explore.py,sha256=3OwNp8vx2fwTdcAXeI2NqBXJ1R9fxQWqoLYPQawS-3Y,13734
+navcli/server/routes/interaction.py,sha256=8FYGA5yqsJ045oMtsVCJpCsj4ANlcOCTs0Xs8oM4pvA,10194
+navcli/server/routes/navigation.py,sha256=U23EtgUFy6FWacwWovrXgwb1PRhp5u1txn1Mt0o7o6I,4277
+navcli/server/routes/query.py,sha256=icjQoBFGvsbM4PHfejYT15or4YdxlSR0IBYlWHcD9K8,15291
+navcli/server/routes/session.py,sha256=GgJOem4p-YFqDiITWFC89t1pq9SQ0guY6AI9lMFBFZs,6307
 navcli/utils/__init__.py,sha256=g3CIjq_xybpmanja9A7oyQMtf9emS6qdHJIJ6BJx6t0,521
 navcli/utils/image.py,sha256=e30zNrOd3wi9UWesiQZJ5n62wIOfrGZnJFCMFKnFOD0,681
 navcli/utils/js.py,sha256=-OenTrj4Nh4s-zjUvjJnN3XSncX8b03tNrgY_nhPRxo,334
@@ -32,8 +32,8 @@ navcli/utils/selector.py,sha256=E_8E5bjjL1gDn524l3bH3XzK3egn9IyoYEb7zXsTwTQ,2146
 navcli/utils/text.py,sha256=wCFCKCn6Ibi8GjAeGXBHT5CfS8BCs7X9qVxDq4eR1tE,389
 navcli/utils/time.py,sha256=bAjJ59rp02MkIfoCT1TzmFd_oGaGlOI-5RPiKSqT-kI,1181
 navcli/utils/url.py,sha256=UG71w8ArYJlqjl2XslwAN-Kk9GJOPK3k5fg6CxXE5js,301
-navcli-0.2.1.dist-info/METADATA,sha256=3tXiF6iGntI7hBujj6yZ4axVQ2q0-FqBs_7PZBOx630,2837
-navcli-0.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-navcli-0.2.1.dist-info/entry_points.txt,sha256=J26RwbEYUO5UbuhH0aXF_tvQFCOCatAR80blaSn5oWk,72
-navcli-0.2.1.dist-info/top_level.txt,sha256=dwTN5Lw7STNP3zhL2-RDElX3EslzM2sbYYLfuszQSO4,7
-navcli-0.2.1.dist-info/RECORD,,
+navcli-0.2.3.dist-info/METADATA,sha256=2P48jfzjZt4soPHSXEpsp4EZTyiyaxwvnLsA-wlTVPo,2837
+navcli-0.2.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+navcli-0.2.3.dist-info/entry_points.txt,sha256=J26RwbEYUO5UbuhH0aXF_tvQFCOCatAR80blaSn5oWk,72
+navcli-0.2.3.dist-info/top_level.txt,sha256=dwTN5Lw7STNP3zhL2-RDElX3EslzM2sbYYLfuszQSO4,7
+navcli-0.2.3.dist-info/RECORD,,