plato-sdk-v2 2.8.1__tar.gz → 2.8.3__tar.gz

{plato_sdk_v2-2.8.1 → plato_sdk_v2-2.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plato-sdk-v2
-Version: 2.8.1
+Version: 2.8.3
 Summary: Python SDK for the Plato API
 Author-email: Plato <support@plato.so>
 License-Expression: MIT

plato_sdk_v2-2.8.3/VERSION

@@ -0,0 +1 @@
+2.8.3

{plato_sdk_v2-2.8.1/plato/v1 → plato_sdk_v2-2.8.3/plato}/cli/pm.py

@@ -22,18 +22,16 @@ 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,
     UpdateTagRequest,
 )
-from plato.v1.cli.utils import (
+from plato.cli.utils import (
     console,
     handle_async,
     read_plato_config,
@@ -42,9 +40,10 @@ from plato.v1.cli.utils import (
     require_sandbox_field,
     require_sandbox_state,
 )
-from plato.v1.cli.verify import pm_verify_app
+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
 
 # =============================================================================
@@ -66,7 +65,6 @@ submit_app = typer.Typer(help="Submit simulator artifacts for review")
 pm_app.add_typer(list_app, name="list")
 pm_app.add_typer(review_app, name="review")
 pm_app.add_typer(submit_app, name="submit")
-pm_app.add_typer(pm_verify_app, name="verify")
 
 
 # =============================================================================
@@ -320,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")
@@ -359,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
@@ -454,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(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("[yellow]No state data available[/yellow]")
+                        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]")
 
@@ -547,19 +547,9 @@ def review_base(
                         console.print(f"[bold red]📋 Most Recent Base Review: REJECTED[/bold red] ({timestamp})")
                     else:
                         console.print(f"[bold green]📋 Most Recent Base Review: PASSED[/bold green] ({timestamp})")
-                    # Handle both old 'comments' field and new 'sim_comments' structure
-                    sim_comments = recent_review.get("sim_comments")
-                    if sim_comments:
-                        console.print("[yellow]Reviewer Comments:[/yellow]")
-                        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(f"[yellow]Reviewer Comments:[/yellow] {comments}")
+                    comments = recent_review.get("comments")
+                    if comments:
+                        console.print(f"[yellow]Reviewer Comments:[/yellow] {comments}")
 
                 console.print()
 
@@ -574,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]")
@@ -645,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
@@ -705,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:
@@ -714,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()
@@ -745,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()
 
@@ -809,13 +797,13 @@ 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" / "data-review"
     else:
-        repo_root = package_dir.parent.parent.parent  # plato-client/
+        repo_root = package_dir.parent.parent  # plato-client/
         extension_source_path = repo_root / "extensions" / "data-review"
 
     # Fallback to env var
@@ -833,7 +821,7 @@ def review_data(
 
     # 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)

{plato_sdk_v2-2.8.1 → plato_sdk_v2-2.8.3}/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...")

plato_sdk_v2-2.8.3/plato/v1/cli/pm.py

@@ -0,0 +1,14 @@
+"""Project Management CLI commands for Plato simulator workflow.
+
+This module re-exports from plato.cli.pm for backwards compatibility.
+"""
+
+# Re-export from main CLI for backwards compatibility
+from plato.cli.pm import (
+    list_app,
+    pm_app,
+    review_app,
+    submit_app,
+)
+
+__all__ = ["pm_app", "list_app", "review_app", "submit_app"]