plato-sdk-v2 2.8.1__py3-none-any.whl → 2.8.3__py3-none-any.whl

plato/cli/pm.py

@@ -22,12 +22,10 @@ from plato._generated.api.v1.simulator import (
     update_simulator_status,
     update_tag,
 )
-from plato._generated.api.v2.sessions import state as sessions_state
 from plato._generated.models import (
     AddReviewRequest,
     AppApiV1SimulatorRoutesUpdateSimulatorRequest,
     Authentication,
-    Flow,
     Outcome,
     ReviewType,
     UpdateStatusRequest,
@@ -42,8 +40,10 @@ from plato.cli.utils import (
     require_sandbox_field,
     require_sandbox_state,
 )
+from plato.v1.flow_executor import FlowExecutor
+from plato.v1.models.flow import Flow
+from plato.v1.sdk import Plato
 from plato.v2.async_.client import AsyncPlato
-from plato.v2.async_.flow_executor import FlowExecutor
 from plato.v2.types import Env
 
 # =============================================================================
@@ -318,25 +318,30 @@ def review_base(
     )
 
     async def _review_base():
+        import warnings
+
         base_url = _get_base_url()
-        plato = AsyncPlato(api_key=api_key, base_url=base_url)
-        session = None
+        # v1 SDK expects base_url to include /api suffix
+        v1_base_url = f"{base_url}/api"
+        # Suppress the deprecation warning from v1 Plato
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore", DeprecationWarning)
+            plato = Plato(api_key=api_key, base_url=v1_base_url)
+        env = None
         playwright = None
         browser = None
-        login_result = None
 
         try:
-            http_client = plato._http
-
             # simulator_name is guaranteed set by parse_simulator_artifact (or we exit)
             assert simulator_name is not None, "simulator_name must be set"
 
-            # Get simulator by name
-            sim = await get_simulator_by_name.asyncio(
-                client=http_client,
-                name=simulator_name,
-                x_api_key=api_key,
-            )
+            # Get simulator by name using httpx for API calls
+            async with httpx.AsyncClient(base_url=base_url, timeout=60.0) as http_client:
+                sim = await get_simulator_by_name.asyncio(
+                    client=http_client,
+                    name=simulator_name,
+                    x_api_key=api_key,
+                )
             simulator_id = sim.id
             current_config = sim.config or {}
             current_status = current_config.get("status", "not_started")
@@ -357,26 +362,27 @@ def review_base(
 
             console.print(f"[cyan]Using artifact:[/cyan] {artifact_id}")
 
-            # Try to create session with environment from artifact
+            # Try to create environment from artifact using v1 API
             try:
                 console.print(f"[cyan]Creating {simulator_name} environment with artifact {artifact_id}...[/cyan]")
-                session = await plato.sessions.create(
-                    envs=[Env.artifact(artifact_id)],
-                    timeout=300,
+                env = await plato.make_environment(
+                    env_id=simulator_name,
+                    artifact_id=artifact_id,
                 )
-                console.print(f"[green]✅ Session created: {session.session_id}[/green]")
+                console.print(f"[green]✅ Environment created: {env.id}[/green]")
+
+                # Wait for environment to be ready
+                console.print("[cyan]Waiting for environment to be ready...[/cyan]")
+                await env.wait_for_ready(timeout=300)
+                console.print("[green]✅ Environment ready![/green]")
 
                 # Reset
                 console.print("[cyan]Resetting environment...[/cyan]")
-                await session.reset()
+                await env.reset()
                 console.print("[green]✅ Environment reset complete![/green]")
 
-                # Get public URL
-                public_urls = await session.get_public_url()
-                first_alias = session.envs[0].alias if session.envs else None
-                public_url = public_urls.get(first_alias) if first_alias else None
-                if not public_url and public_urls:
-                    public_url = list(public_urls.values())[0]
+                # Get public URL (v1 returns string directly)
+                public_url = await env.get_public_url()
                 console.print(f"[cyan]Public URL:[/cyan] {public_url}")
 
                 # Launch Playwright browser and login
@@ -452,70 +458,66 @@ def review_base(
                     except Exception as e:
                         console.print(f"[yellow]⚠️  Flow execution error: {e}[/yellow]")
                 else:
-                    # Use default login via session.login()
+                    # Use default login via env.login() (v1 API takes Page, not Browser)
                     if fake_time:
                         console.print("[yellow]⚠️  --clock with default login may not work correctly.[/yellow]")
                         console.print("[yellow]   Use --local with a flow file for reliable clock testing.[/yellow]")
                     try:
-                        login_result = await session.login(browser, dataset="base")
-                        page = list(login_result.pages.values())[0] if login_result.pages else None
-                        console.print("[green]✅ Logged into environment[/green]")
-                    except Exception as e:
-                        console.print(f"[yellow]⚠️  Login error: {e}[/yellow]")
+                        # Create page and navigate to public URL first
                         page = await browser.new_page()
-                        # Install fake clock on fallback page
                         if fake_time:
                             await page.clock.install(time=fake_time)
                             console.print(f"[green]✅ Fake clock installed: {fake_time.isoformat()}[/green]")
                         if public_url:
                             await page.goto(public_url)
+                        # v1 login takes a Page and uses from_api=True to fetch flows from server
+                        await env.login(page, dataset="base", from_api=True)
+                        console.print("[green]✅ Logged into environment[/green]")
+                    except Exception as e:
+                        console.print(f"[yellow]⚠️  Login error: {e}[/yellow]")
+                        # Page already created above, just navigate if not already done
+                        if public_url and page:
+                            try:
+                                await page.goto(public_url)
+                            except Exception:
+                                pass
 
                 # ALWAYS check state after login to verify no mutations
                 console.print("\n[cyan]Checking environment state after login...[/cyan]")
                 has_mutations = False
                 has_errors = False
                 try:
-                    state_response = await sessions_state.asyncio(
-                        client=http_client,
-                        session_id=session.session_id,
-                        merge_mutations=True,
-                        x_api_key=api_key,
-                    )
-                    if state_response and state_response.results:
-                        for jid, result in state_response.results.items():
-                            state_data = result.state if hasattr(result, "state") else result
-                            console.print(f"\n[bold cyan]Job {jid}:[/bold cyan]")
-
-                            if isinstance(state_data, dict):
-                                # Check for error in state response
-                                if "error" in state_data:
-                                    has_errors = True
-                                    console.print("\n[bold red]❌ State API Error:[/bold red]")
-                                    console.print(f"[red]{state_data['error']}[/red]")
-                                    continue
-
-                                mutations = state_data.pop("mutations", [])
-                                console.print("\n[bold]State:[/bold]")
-                                console.print(json.dumps(state_data, indent=2, default=str))
-                                if mutations:
-                                    has_mutations = True
-                                    console.print(f"\n[bold red]Mutations ({len(mutations)}):[/bold red]")
-                                    console.print(json.dumps(mutations, indent=2, default=str))
-                                else:
-                                    console.print("\n[green]No mutations recorded[/green]")
-                            else:
-                                console.print(f"[yellow]Unexpected state format: {type(state_data)}[/yellow]")
-
-                        if has_errors:
-                            console.print("\n[bold red]❌ State check failed due to errors![/bold red]")
-                            console.print("[yellow]The worker may not be properly connected.[/yellow]")
-                        elif has_mutations:
-                            console.print("\n[bold red]⚠️  WARNING: Login flow created mutations![/bold red]")
-                            console.print("[yellow]The login flow should NOT modify database state.[/yellow]")
+                    # v1 API: env.get_state() returns state dict directly
+                    state_data = await env.get_state(merge_mutations=True)
+                    console.print(f"\n[bold cyan]Environment {env.id}:[/bold cyan]")
+
+                    if isinstance(state_data, dict):
+                        # Check for error in state response (only if error has a truthy value)
+                        if state_data.get("error"):
+                            has_errors = True
+                            console.print("\n[bold red]❌ State API Error:[/bold red]")
+                            console.print(f"[red]{state_data['error']}[/red]")
                         else:
-                            console.print("\n[bold green]✅ Login flow verified - no mutations created[/bold green]")
+                            mutations = state_data.pop("mutations", [])
+                            console.print("\n[bold]State:[/bold]")
+                            console.print(json.dumps(state_data, indent=2, default=str))
+                            if mutations:
+                                has_mutations = True
+                                console.print(f"\n[bold red]Mutations ({len(mutations)}):[/bold red]")
+                                console.print(json.dumps(mutations, indent=2, default=str))
+                            else:
+                                console.print("\n[green]No mutations recorded[/green]")
                     else:
-                        console.print("[yellow]No state data available[/yellow]")
+                        console.print(f"[yellow]Unexpected state format: {type(state_data)}[/yellow]")
+
+                    if has_errors:
+                        console.print("\n[bold red]❌ State check failed due to errors![/bold red]")
+                        console.print("[yellow]The worker may not be properly connected.[/yellow]")
+                    elif has_mutations:
+                        console.print("\n[bold red]⚠️  WARNING: Login flow created mutations![/bold red]")
+                        console.print("[yellow]The login flow should NOT modify database state.[/yellow]")
+                    else:
+                        console.print("\n[bold green]✅ Login flow verified - no mutations created[/bold green]")
                 except Exception as e:
                     console.print(f"[red]❌ Error getting state: {e}[/red]")
 
@@ -562,37 +564,26 @@ def review_base(
                         elif command in ["state", "s"]:
                             console.print("\n[cyan]Getting environment state with mutations...[/cyan]")
                             try:
-                                # Call API directly with merge_mutations=True to include mutations
-                                state_response = await sessions_state.asyncio(
-                                    client=http_client,
-                                    session_id=session.session_id,
-                                    merge_mutations=True,
-                                    x_api_key=api_key,
-                                )
-                                if state_response and state_response.results:
-                                    for jid, result in state_response.results.items():
-                                        state_data = result.state if hasattr(result, "state") else result
-                                        console.print(f"\n[bold cyan]Job {jid}:[/bold cyan]")
-
-                                        if isinstance(state_data, dict):
-                                            # Check for error in state response
-                                            if "error" in state_data:
-                                                console.print("\n[bold red]❌ State API Error:[/bold red]")
-                                                console.print(f"[red]{state_data['error']}[/red]")
-                                                continue
-
-                                            mutations = state_data.pop("mutations", [])
-                                            console.print("\n[bold]State:[/bold]")
-                                            console.print(json.dumps(state_data, indent=2, default=str))
-                                            if mutations:
-                                                console.print(f"\n[bold]Mutations ({len(mutations)}):[/bold]")
-                                                console.print(json.dumps(mutations, indent=2, default=str))
-                                            else:
-                                                console.print("\n[yellow]No mutations recorded[/yellow]")
+                                # v1 API: env.get_state() returns state dict directly
+                                state_data = await env.get_state(merge_mutations=True)
+                                console.print(f"\n[bold cyan]Environment {env.id}:[/bold cyan]")
+
+                                if isinstance(state_data, dict):
+                                    # Check for error in state response (only if error has a truthy value)
+                                    if state_data.get("error"):
+                                        console.print("\n[bold red]❌ State API Error:[/bold red]")
+                                        console.print(f"[red]{state_data['error']}[/red]")
+                                    else:
+                                        mutations = state_data.pop("mutations", [])
+                                        console.print("\n[bold]State:[/bold]")
+                                        console.print(json.dumps(state_data, indent=2, default=str))
+                                        if mutations:
+                                            console.print(f"\n[bold]Mutations ({len(mutations)}):[/bold]")
+                                            console.print(json.dumps(mutations, indent=2, default=str))
                                         else:
-                                            console.print(json.dumps(state_data, indent=2, default=str))
+                                            console.print("\n[yellow]No mutations recorded[/yellow]")
                                 else:
-                                    console.print("[yellow]No state data available[/yellow]")
+                                    console.print(json.dumps(state_data, indent=2, default=str))
                                 console.print()
                             except Exception as e:
                                 console.print(f"[red]❌ Error getting state: {e}[/red]")
@@ -633,56 +624,60 @@ def review_base(
                 validate_status_transition(current_status, "env_review_requested", "review base reject")
                 new_status = "env_in_progress"
 
-            # Update status
-            await update_simulator_status.asyncio(
-                client=http_client,
-                simulator_id=simulator_id,
-                body=UpdateStatusRequest(status=new_status),
-                x_api_key=api_key,
-            )
-
-            # Add review if rejecting
-            if outcome == "reject":
-                comments = ""
-                while not comments:
-                    comments = typer.prompt("Comments (required for reject)").strip()
-                    if not comments:
-                        console.print("[yellow]Comments are required when rejecting. Please provide feedback.[/yellow]")
-
-                await add_simulator_review.asyncio(
-                    client=http_client,
+            # Create httpx client for API calls
+            async with httpx.AsyncClient(base_url=base_url, timeout=60.0) as api_client:
+                # Update status
+                await update_simulator_status.asyncio(
+                    client=api_client,
                     simulator_id=simulator_id,
-                    body=AddReviewRequest(
-                        review_type=ReviewType.env,
-                        outcome=Outcome.reject,
-                        artifact_id=artifact_id,
-                        comments=comments,
-                    ),
+                    body=UpdateStatusRequest(status=new_status),
                     x_api_key=api_key,
                 )
 
-            console.print(f"[green]✅ Review submitted: {outcome}[/green]")
-            console.print(f"[cyan]Status:[/cyan] {current_status} → {new_status}")
-
-            # If passed, automatically tag artifact as prod-latest
-            if outcome == "pass" and artifact_id:
-                console.print("\n[cyan]Tagging artifact as prod-latest...[/cyan]")
-                try:
-                    # simulator_name and artifact_id are guaranteed to be set at this point
-                    assert simulator_name is not None
-                    await update_tag.asyncio(
-                        client=http_client,
-                        body=UpdateTagRequest(
-                            simulator_name=simulator_name,
+                # Add review if rejecting
+                if outcome == "reject":
+                    comments = ""
+                    while not comments:
+                        comments = typer.prompt("Comments (required for reject)").strip()
+                        if not comments:
+                            console.print(
+                                "[yellow]Comments are required when rejecting. Please provide feedback.[/yellow]"
+                            )
+
+                    await add_simulator_review.asyncio(
+                        client=api_client,
+                        simulator_id=simulator_id,
+                        body=AddReviewRequest(
+                            review_type=ReviewType.env,
+                            outcome=Outcome.reject,
                             artifact_id=artifact_id,
-                            tag_name="prod-latest",
-                            dataset="base",
+                            comments=comments,
                         ),
                         x_api_key=api_key,
                     )
-                    console.print(f"[green]✅ Tagged {artifact_id[:8]}... as prod-latest[/green]")
-                except Exception as e:
-                    console.print(f"[yellow]⚠️  Could not tag as prod-latest: {e}[/yellow]")
+
+                console.print(f"[green]✅ Review submitted: {outcome}[/green]")
+                console.print(f"[cyan]Status:[/cyan] {current_status} → {new_status}")
+
+                # If passed, automatically tag artifact as prod-latest
+                if outcome == "pass" and artifact_id:
+                    console.print("\n[cyan]Tagging artifact as prod-latest...[/cyan]")
+                    try:
+                        # simulator_name and artifact_id are guaranteed to be set at this point
+                        assert simulator_name is not None
+                        await update_tag.asyncio(
+                            client=api_client,
+                            body=UpdateTagRequest(
+                                simulator_name=simulator_name,
+                                artifact_id=artifact_id,
+                                tag_name="prod-latest",
+                                dataset="base",
+                            ),
+                            x_api_key=api_key,
+                        )
+                        console.print(f"[green]✅ Tagged {artifact_id[:8]}... as prod-latest[/green]")
+                    except Exception as e:
+                        console.print(f"[yellow]⚠️  Could not tag as prod-latest: {e}[/yellow]")
 
         except typer.Exit:
             raise
@@ -693,8 +688,6 @@ def review_base(
         finally:
             # Cleanup
             try:
-                if login_result and login_result.context:
-                    await login_result.context.close()
                 if browser:
                     await browser.close()
                 if playwright:
@@ -702,13 +695,13 @@ def review_base(
             except Exception as e:
                 console.print(f"[yellow]⚠️  Browser cleanup error: {e}[/yellow]")
 
-            if session:
+            if env:
                 try:
-                    console.print("[cyan]Shutting down session...[/cyan]")
-                    await session.close()
-                    console.print("[green]✅ Session shut down[/green]")
+                    console.print("[cyan]Shutting down environment...[/cyan]")
+                    await env.close()
+                    console.print("[green]✅ Environment shut down[/green]")
                 except Exception as e:
-                    console.print(f"[yellow]⚠️  Session cleanup error: {e}[/yellow]")
+                    console.print(f"[yellow]⚠️  Environment cleanup error: {e}[/yellow]")
 
             try:
                 await plato.close()
@@ -733,18 +726,25 @@ def review_data(
         help="Artifact UUID to review. If not provided, uses server's data_artifact_id.",
     ),
 ):
-    """Launch browser with EnvGen Recorder extension for data review.
+    """
+    Launch browser with Data Review extension for data review.
 
-    Opens Chrome with the EnvGen Recorder extension installed for reviewing
-    data artifacts. The extension sidebar can be used to record and submit reviews.
-    Press Control-C to exit when done.
+    Opens Chrome with the Data Review extension installed for reviewing
+    data artifacts. Close the browser when done.
 
-    Requires simulator status: data_review_requested
+    SPECIFYING SIMULATOR AND ARTIFACT:
 
-    Options:
-        -s, --simulator: Simulator name. Supports colon notation for artifact:
-            '-s sim' (uses server's data_artifact_id) or '-s sim:<uuid>'
-        -a, --artifact: Explicit artifact UUID to review. Overrides server's value.
+        -s <simulator>                      Use server's data_artifact_id
+        -s <simulator> -a <artifact-uuid>   Explicit artifact
+        -s <simulator>:<artifact-uuid>      Colon notation (same as above)
+
+    EXAMPLES:
+
+        plato pm review data -s fathom
+        plato pm review data -s fathom -a e9c25ca5-1234-5678-9abc-def012345678
+        plato pm review data -s fathom:e9c25ca5-1234-5678-9abc-def012345678
+
+    Requires simulator status: data_review_requested
     """
     api_key = require_api_key()
 
@@ -753,8 +753,6 @@ def review_data(
         simulator, artifact, require_artifact=False, command_name="review data"
     )
 
-    # Determine target URL based on simulator
-    target_url = f"https://{simulator_name}.web.plato.so"
     console.print(f"[cyan]Simulator:[/cyan] {simulator_name}")
 
     # Fetch simulator config and get artifact ID if not provided
@@ -799,45 +797,75 @@ def review_data(
         console.print(f"[cyan]Artifact:[/cyan] {artifact_id}")
 
     # Find Chrome extension source
-    package_dir = Path(__file__).resolve().parent.parent  # v1/
+    package_dir = Path(__file__).resolve().parent.parent  # plato/
     is_installed = "site-packages" in str(package_dir)
 
     if is_installed:
-        extension_source_path = package_dir / "extensions" / "envgen-recorder-old"
+        extension_source_path = package_dir / "extensions" / "data-review"
     else:
-        repo_root = package_dir.parent.parent.parent  # plato-client/
-        extension_source_path = repo_root / "extensions" / "envgen-recorder-old"
+        repo_root = package_dir.parent.parent  # plato-client/
+        extension_source_path = repo_root / "extensions" / "data-review"
 
     # Fallback to env var
     if not extension_source_path.exists():
         plato_client_dir_env = os.getenv("PLATO_CLIENT_DIR")
         if plato_client_dir_env:
-            env_path = Path(plato_client_dir_env) / "extensions" / "envgen-recorder-old"
+            env_path = Path(plato_client_dir_env) / "extensions" / "data-review"
             if env_path.exists():
                 extension_source_path = env_path
 
     if not extension_source_path.exists():
-        console.print("[red]❌ EnvGen Recorder extension not found[/red]")
+        console.print("[red]❌ Data Review extension not found[/red]")
         console.print(f"\n[yellow]Expected location:[/yellow] {extension_source_path}")
         raise typer.Exit(1)
 
     # Copy extension to temp directory
     temp_ext_dir = Path(tempfile.mkdtemp(prefix="plato-extension-"))
-    extension_path = temp_ext_dir / "envgen-recorder"
+    extension_path = temp_ext_dir / "data-review"
 
     console.print("[cyan]Copying extension to temp directory...[/cyan]")
     shutil.copytree(extension_source_path, extension_path, dirs_exist_ok=False)
     console.print(f"[green]✅ Extension copied to: {extension_path}[/green]")
 
     async def _review_data():
+        base_url = _get_base_url()
+        plato = AsyncPlato(api_key=api_key, base_url=base_url)
+        session = None
         playwright = None
         browser = None
 
         try:
+            # Check if we have an artifact ID to create a session
+            if not artifact_id:
+                console.print("[red]❌ No artifact ID available. Cannot create session.[/red]")
+                console.print("[yellow]Specify artifact with: plato pm review data -s simulator:artifact_id[/yellow]")
+                raise typer.Exit(1)
+
+            # Create session with artifact
+            console.print(f"[cyan]Creating {simulator_name} environment with artifact {artifact_id}...[/cyan]")
+            session = await plato.sessions.create(
+                envs=[Env.artifact(artifact_id)],
+                timeout=300,
+            )
+            console.print(f"[green]✅ Session created: {session.session_id}[/green]")
+
+            # Reset environment
+            console.print("[cyan]Resetting environment...[/cyan]")
+            await session.reset()
+            console.print("[green]✅ Environment reset complete![/green]")
+
+            # Get public URL
+            public_urls = await session.get_public_url()
+            first_alias = session.envs[0].alias if session.envs else None
+            public_url = public_urls.get(first_alias) if first_alias else None
+            if not public_url and public_urls:
+                public_url = list(public_urls.values())[0]
+            console.print(f"[cyan]Public URL:[/cyan] {public_url}")
+
             user_data_dir = Path.home() / ".plato" / "chrome-data"
             user_data_dir.mkdir(parents=True, exist_ok=True)
 
-            console.print("[cyan]Launching Chrome with EnvGen Recorder extension...[/cyan]")
+            console.print("[cyan]Launching Chrome with Data Review extension...[/cyan]")
 
             from playwright.async_api import async_playwright
 
@@ -878,13 +906,14 @@ def review_data(
             else:
                 console.print("[yellow]⚠️  Could not find extension ID. Please set API key manually.[/yellow]")
 
-            # Step 1: Navigate to target URL first
-            console.print(f"[cyan]Navigating to {target_url}...[/cyan]")
+            # Navigate to public URL (user logs in manually with displayed credentials)
+            console.print("[cyan]Opening environment...[/cyan]")
             main_page = await browser.new_page()
-            await main_page.goto(target_url, wait_until="domcontentloaded")
-            console.print(f"[green]✅ Loaded: {target_url}[/green]")
+            if public_url:
+                await main_page.goto(public_url)
+                console.print(f"[green]✅ Loaded: {public_url}[/green]")
 
-            # Step 2: Use options page to set API key
+            # Use options page to set API key
             if extension_id:
                 options_page = await browser.new_page()
                 try:
@@ -908,17 +937,16 @@ def review_data(
                     await options_page.close()
 
             # Bring main page to front
-            await main_page.bring_to_front()
+            if main_page:
+                await main_page.bring_to_front()
 
             console.print()
             console.print("[bold]Instructions:[/bold]")
-            console.print("  1. Click the EnvGen Recorder extension icon to open the sidebar")
-            if simulator:
-                console.print(f"  2. Click 'Configure Session' and enter '{simulator}' as the simulator name")
-            else:
-                console.print("  2. Click 'Configure Session' and enter a simulator name")
-            console.print("  3. Use the extension to record and submit reviews")
-            console.print("  4. When done, press Control-C to exit")
+            console.print("  1. Click the Data Review extension icon to open the sidebar")
+            console.print(f"  2. Enter '{simulator_name}' as the simulator name and click Start Review")
+            console.print("  3. Take screenshots and add comments for any issues")
+            console.print("  4. Select Pass or Reject and submit the review")
+            console.print("  5. When done, press Control-C to exit")
 
             # Show recent review if available
             if recent_review:
@@ -931,10 +959,20 @@ def review_data(
                 else:
                     console.print(f"[bold green]📋 Most Recent Data Review: PASSED[/bold green] ({timestamp})")
 
-                comments = recent_review.get("comments")
-                if comments:
+                # Handle both old 'comments' field and new 'sim_comments' structure
+                sim_comments = recent_review.get("sim_comments")
+                if sim_comments:
                     console.print("\n[yellow]Reviewer Comments:[/yellow]")
-                    console.print(f"  {comments}")
+                    for i, item in enumerate(sim_comments, 1):
+                        comment_text = item.get("comment", "")
+                        if comment_text:
+                            console.print(f"  {i}. {comment_text}")
+                else:
+                    # Fallback to old comments field
+                    comments = recent_review.get("comments")
+                    if comments:
+                        console.print("\n[yellow]Reviewer Comments:[/yellow]")
+                        console.print(f"  {comments}")
                 console.print("=" * 60)
 
             console.print()
@@ -955,6 +993,8 @@ def review_data(
 
         finally:
             try:
+                if session:
+                    await session.close()
                 if browser:
                     await browser.close()
                 if playwright:
@@ -962,7 +1002,7 @@ def review_data(
                 if temp_ext_dir.exists():
                     shutil.rmtree(temp_ext_dir, ignore_errors=True)
             except Exception as e:
-                console.print(f"[yellow]⚠️  Browser cleanup error: {e}[/yellow]")
+                console.print(f"[yellow]⚠️  Cleanup error: {e}[/yellow]")
 
     handle_async(_review_data())
 

plato/cli/sandbox.py

@@ -407,8 +407,9 @@ def sandbox_snapshot(
 
     Captures VM state and database for later restoration.
 
-    Example:
-        plato sandbox snapshot
+    Examples:
+        plato sandbox snapshot                    # Uses mode from state.json
+        plato sandbox snapshot --mode config      # Override to pass local plato-config.yml and flows to artifact
     """
     with sandbox_context(working_dir, json_output, verbose) as (client, out):
         out.console.print("Creating snapshot...")