navcli 0.2.2__tar.gz → 0.2.3__tar.gz

{navcli-0.2.2 → navcli-0.2.3}/PKG-INFO

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

{navcli-0.2.2 → navcli-0.2.3}/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-0.2.2 → navcli-0.2.3}/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-0.2.2 → navcli-0.2.3}/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-0.2.2 → navcli-0.2.3}/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-0.2.2 → navcli-0.2.3}/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-0.2.2 → navcli-0.2.3}/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-0.2.2 → navcli-0.2.3}/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.2 → navcli-0.2.3}/navcli.egg-info/PKG-INFO

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

{navcli-0.2.2 → navcli-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "navcli"
-version = "0.2.2"
+version = "0.2.3"
 description = "可交互、可探索的浏览器命令行工具，专为 AI Agent 设计"
 readme = "docs/README.md"
 requires-python = ">=3.9"