plato-sdk-v2 2.5.0__py3-none-any.whl → 2.6.0__py3-none-any.whl

plato/v2/sync/chronos.py

@@ -0,0 +1,419 @@
+"""Plato SDK v2 - Synchronous Chronos Client.
+
+Provides high-level APIs for managing Chronos sessions and jobs programmatically.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+import time
+from typing import Any
+
+import httpx
+from dotenv import load_dotenv
+
+from plato.chronos.api.jobs import launch_job
+from plato.chronos.api.sessions import (
+    close_session,
+    complete_session,
+    get_session,
+    get_session_envs,
+    get_session_logs,
+    get_session_status,
+    list_sessions,
+    list_tags,
+    update_session_tags,
+)
+from plato.chronos.models import (
+    CompleteSessionRequest,
+    LaunchJobRequest,
+    LaunchJobResponse,
+    RuntimeConfig,
+    SessionEnvsResponse,
+    SessionListResponse,
+    SessionLogsResponse,
+    SessionResponse,
+    SessionStatusResponse,
+    TagsListResponse,
+    UpdateTagsRequest,
+    WorldConfig,
+)
+
+load_dotenv()
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_CHRONOS_URL = "https://chronos.plato.so"
+DEFAULT_TIMEOUT = 120.0
+
+
+class ChronosSession:
+    """Wrapper for a Chronos session with convenient methods.
+
+    Provides methods to check status, get logs, update tags, and stop the session.
+    """
+
+    def __init__(
+        self,
+        http_client: httpx.Client,
+        api_key: str,
+        session_id: str,
+        plato_session_id: str | None = None,
+    ):
+        self._http = http_client
+        self._api_key = api_key
+        self._session_id = session_id
+        self._plato_session_id = plato_session_id
+
+    @property
+    def session_id(self) -> str:
+        """Get the Chronos session public ID."""
+        return self._session_id
+
+    @property
+    def plato_session_id(self) -> str | None:
+        """Get the underlying Plato session ID."""
+        return self._plato_session_id
+
+    def get_status(self) -> SessionStatusResponse:
+        """Get the current status of the session (lightweight).
+
+        Returns:
+            SessionStatusResponse with status and status_reason.
+        """
+        return get_session_status.sync(
+            client=self._http,
+            public_id=self._session_id,
+            x_api_key=self._api_key,
+        )
+
+    def get_details(self) -> SessionResponse:
+        """Get full session details including trajectory and world config.
+
+        Returns:
+            SessionResponse with full session details.
+        """
+        return get_session.sync(
+            client=self._http,
+            public_id=self._session_id,
+            x_api_key=self._api_key,
+        )
+
+    def get_envs(self) -> SessionEnvsResponse:
+        """Get environment information for this session.
+
+        Returns:
+            SessionEnvsResponse with list of environments.
+        """
+        return get_session_envs.sync(
+            client=self._http,
+            public_id=self._session_id,
+            x_api_key=self._api_key,
+        )
+
+    def get_logs(
+        self,
+        limit: int = 10000,
+    ) -> SessionLogsResponse:
+        """Get logs for this session.
+
+        Args:
+            limit: Maximum number of log entries to return.
+
+        Returns:
+            SessionLogsResponse with log entries.
+        """
+        return get_session_logs.sync(
+            client=self._http,
+            public_id=self._session_id,
+            limit=limit,
+            x_api_key=self._api_key,
+        )
+
+    def update_tags(self, tags: list[str]) -> SessionResponse:
+        """Update tags for this session.
+
+        Args:
+            tags: List of tags (use '.' for hierarchy, '_' instead of '-').
+
+        Returns:
+            Updated SessionResponse.
+        """
+        # Normalize tags
+        normalized = [tag.replace("-", "_").replace(":", ".").replace(" ", "_") for tag in tags]
+        request = UpdateTagsRequest(tags=normalized)
+        return update_session_tags.sync(
+            client=self._http,
+            public_id=self._session_id,
+            body=request,
+            x_api_key=self._api_key,
+        )
+
+    def stop(self, error_message: str = "Cancelled by user") -> SessionResponse:
+        """Stop/cancel this session.
+
+        Args:
+            error_message: Reason for stopping.
+
+        Returns:
+            Updated SessionResponse.
+        """
+        request = CompleteSessionRequest(
+            status="cancelled",
+            error_message=error_message,
+        )
+        return complete_session.sync(
+            client=self._http,
+            public_id=self._session_id,
+            body=request,
+            x_api_key=self._api_key,
+        )
+
+    def complete(
+        self,
+        status: str = "completed",
+        exit_code: int | None = None,
+        error_message: str | None = None,
+    ) -> SessionResponse:
+        """Mark session as completed or failed.
+
+        Args:
+            status: Final status ('completed', 'failed', or 'cancelled').
+            exit_code: Optional exit code from world runner.
+            error_message: Error message if failed.
+
+        Returns:
+            Updated SessionResponse.
+        """
+        request = CompleteSessionRequest(
+            status=status,
+            exit_code=exit_code,
+            error_message=error_message,
+        )
+        return complete_session.sync(
+            client=self._http,
+            public_id=self._session_id,
+            body=request,
+            x_api_key=self._api_key,
+        )
+
+    def close(self) -> None:
+        """Close the Plato session (release VM resources).
+
+        Note: This closes the underlying Plato session, not just the Chronos record.
+        """
+        close_session.sync(
+            client=self._http,
+            public_id=self._session_id,
+            x_api_key=self._api_key,
+        )
+
+    def wait_until_complete(
+        self,
+        timeout: float = 3600.0,
+        poll_interval: float = 5.0,
+    ) -> SessionResponse:
+        """Wait until the session reaches a terminal state.
+
+        Args:
+            timeout: Maximum time to wait in seconds.
+            poll_interval: Time between status checks.
+
+        Returns:
+            Final SessionResponse.
+
+        Raises:
+            TimeoutError: If session doesn't complete within timeout.
+        """
+        terminal_statuses = {"completed", "failed", "cancelled", "error"}
+        elapsed = 0.0
+
+        while elapsed < timeout:
+            status_response = self.get_status()
+            if status_response.status in terminal_statuses:
+                return self.get_details()
+
+            time.sleep(poll_interval)
+            elapsed += poll_interval
+
+        raise TimeoutError(f"Session {self._session_id} did not complete within {timeout} seconds")
+
+    def __repr__(self) -> str:
+        return f"ChronosSession(session_id={self._session_id!r})"
+
+
+class Chronos:
+    """Synchronous client for Chronos job management API.
+
+    Provides high-level methods for launching jobs, managing sessions,
+    and monitoring job status.
+
+    Usage:
+        from plato.v2.sync import Chronos
+
+        with Chronos() as chronos:
+            # Launch a job
+            session = chronos.launch(
+                world_package="plato-world-computer-use",
+                world_config={"task": "Navigate to google.com"},
+                tags=["test", "project.my_project"],
+            )
+
+            # Wait for completion
+            result = session.wait_until_complete()
+            print(f"Status: {result.status}")
+
+            # Or poll manually
+            while True:
+                status = session.get_status()
+                if status.status in ("completed", "failed"):
+                    break
+                time.sleep(5)
+    """
+
+    def __init__(
+        self,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        timeout: float = DEFAULT_TIMEOUT,
+    ):
+        """Initialize the Chronos client.
+
+        Args:
+            api_key: Plato API key. Falls back to PLATO_API_KEY env var.
+            base_url: Chronos API base URL. Falls back to CHRONOS_URL env var.
+            timeout: Request timeout in seconds.
+        """
+        resolved_api_key = api_key or os.environ.get("PLATO_API_KEY")
+        if not resolved_api_key:
+            raise ValueError("API key required. Set PLATO_API_KEY or pass api_key=")
+        self._api_key: str = resolved_api_key
+
+        url = base_url or os.environ.get("CHRONOS_URL", DEFAULT_CHRONOS_URL)
+        self.base_url = url.rstrip("/")
+        self.timeout = timeout
+
+        self._http = httpx.Client(
+            base_url=self.base_url,
+            timeout=httpx.Timeout(timeout),
+        )
+
+    def launch(
+        self,
+        world_package: str,
+        world_config: dict[str, Any] | None = None,
+        runtime_artifact_id: str | None = None,
+        tags: list[str] | None = None,
+    ) -> ChronosSession:
+        """Launch a new Chronos job.
+
+        Args:
+            world_package: World package name with optional version
+                (e.g., "plato-world-computer-use:0.1.0").
+            world_config: Configuration passed to the world runner.
+            runtime_artifact_id: Optional runtime artifact ID for cached environment.
+            tags: Optional tags for organizing sessions (use '.' for hierarchy).
+
+        Returns:
+            ChronosSession for monitoring and managing the job.
+
+        Example:
+            session = chronos.launch(
+                world_package="plato-world-computer-use",
+                world_config={
+                    "task": "Navigate to google.com",
+                    "agents": [{"name": "computer-use", "version": "latest"}],
+                },
+                tags=["project.my_project", "env.dev"],
+            )
+        """
+        # Normalize tags
+        normalized_tags = None
+        if tags:
+            normalized_tags = [tag.replace("-", "_").replace(":", ".").replace(" ", "_") for tag in tags]
+
+        request = LaunchJobRequest(
+            world=WorldConfig(
+                package=world_package,
+                config=world_config,
+            ),
+            runtime=RuntimeConfig(artifact_id=runtime_artifact_id) if runtime_artifact_id else None,
+            tags=normalized_tags,
+        )
+
+        response: LaunchJobResponse = launch_job.sync(
+            client=self._http,
+            body=request,
+            x_api_key=self._api_key,
+        )
+
+        logger.info(f"Launched Chronos job: {response.session_id}")
+
+        return ChronosSession(
+            http_client=self._http,
+            api_key=self.api_key,
+            session_id=response.session_id,
+            plato_session_id=response.plato_session_id,
+        )
+
+    def get_session(self, session_id: str) -> ChronosSession:
+        """Get a ChronosSession wrapper for an existing session.
+
+        Args:
+            session_id: The Chronos session public ID.
+
+        Returns:
+            ChronosSession for the specified session.
+        """
+        # Verify the session exists by fetching status
+        get_session_status.sync(
+            client=self._http,
+            public_id=session_id,
+            x_api_key=self._api_key,
+        )
+
+        return ChronosSession(
+            http_client=self._http,
+            api_key=self.api_key,
+            session_id=session_id,
+        )
+
+    def list_sessions(
+        self,
+        tag: str | None = None,
+    ) -> SessionListResponse:
+        """List Chronos sessions.
+
+        Args:
+            tag: Filter by tag (fuzzy substring match).
+
+        Returns:
+            SessionListResponse with list of sessions.
+        """
+        return list_sessions.sync(
+            client=self._http,
+            tag=tag,
+            x_api_key=self._api_key,
+        )
+
+    def list_tags(self) -> TagsListResponse:
+        """List all unique tags across sessions.
+
+        Returns:
+            TagsListResponse with list of tags.
+        """
+        return list_tags.sync(
+            client=self._http,
+            x_api_key=self._api_key,
+        )
+
+    def close(self) -> None:
+        """Close the underlying HTTP client."""
+        self._http.close()
+
+    def __enter__(self) -> Chronos:
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()

plato/worlds/base.py

@@ -155,11 +155,11 @@ class BaseWorld(ABC, Generic[ConfigT]):
 
     @classmethod
     def get_schema(cls) -> dict:
-        """Get full schema including world config, agents, and secrets."""
+        """Get full schema including world config, agents, secrets, and envs."""
         config_class = cls.get_config_class()
         schema = config_class.get_json_schema()
 
-        return {
+        result = {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "properties": schema.get("properties", {}),
@@ -169,6 +169,16 @@ class BaseWorld(ABC, Generic[ConfigT]):
             "envs": schema.get("envs", []),
         }
 
+        # Include env_list if present (for worlds with arbitrary environment lists)
+        if "env_list" in schema:
+            result["env_list"] = schema["env_list"]
+
+        # Include $defs if present (for nested type references)
+        if "$defs" in schema:
+            result["$defs"] = schema["$defs"]
+
+        return result
+
     @abstractmethod
     async def reset(self) -> Observation:
         """Setup the world and return initial observation.

{plato_sdk_v2-2.5.0.dist-info → plato_sdk_v2-2.6.0.dist-info}/METADATA

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

{plato_sdk_v2-2.5.0.dist-info → plato_sdk_v2-2.6.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 plato/__init__.py,sha256=a9E0KS1602GWHHStnf7wDEuvPCvh2GpPh0Sf8oKZx5Q,1795
 plato/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-plato/_generated/__init__.py,sha256=8BNQD2tT98Nrl8jP97bIzUxFTkb1681a1kbJExyZYuo,738
+plato/_generated/__init__.py,sha256=-vi0WFWBl1r0SP4-d---XUK4RxKbzlq5cyc2SWzsUFg,738
 plato/_generated/client.py,sha256=_oMKXyAShQVddCaIKnfB2zPkRsDlCwLp-N3RFoKq_v8,5489
 plato/_generated/errors.py,sha256=goTGrZ4rrujGZ-BoOonoyaGwdGDkGO6GyeubIkQVv9E,4197
 plato/_generated/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -54,7 +54,7 @@ plato/_generated/api/v1/evals/__init__.py,sha256=TNqMltP6UwzIoFB087RwkXprggoaLWt
 plato/_generated/api/v1/evals/create_test_case_review.py,sha256=QE9eFypoTSAqUC8C0Rmt8OXwS8Ak9cz63Ocm6v_In84,1854
 plato/_generated/api/v1/evals/evaluate_python.py,sha256=RRW6rd2-WRAsWD3mJ1Vt4TGiinJ445x_rVqahUJUZyE,1657
 plato/_generated/api/v1/evals/get_all_test_case_reviews.py,sha256=w1qGc3BnpcPS6pFSUvMSF_aN7EYl7HF5YwKzVDkibg4,1703
-plato/_generated/api/v1/evals/get_scores_by_user.py,sha256=C5z4BVTPOsJLOy-_5kdFYlxeV0uAzGxIdP6946N6RtE,2545
+plato/_generated/api/v1/evals/get_scores_by_user.py,sha256=_NZkKBQT_BBrIIYXsUGV47DNcNLHv6aqJNfzDqHZyf4,2725
 plato/_generated/api/v1/evals/get_scoring.py,sha256=766R2m7a-mb38bHbpO1RPQviKxPbb6oq0-s2_QX0Eic,985
 plato/_generated/api/v1/evals/get_test_case_review.py,sha256=-HHRPTfLVVUT7X4bYrg9FyvXR3Ve4N9dCSJYPG80w0w,1683
 plato/_generated/api/v1/evals/human_in_the_loop_scoring.py,sha256=wmCt80j96Ca75IlblHV8SjUvulkDS_DJ6O43mspBYWM,1939
@@ -190,7 +190,7 @@ plato/_generated/api/v1/testcases/get_organization_test_case_assignments.py,sha2
 plato/_generated/api/v1/testcases/get_testcase.py,sha256=EydIk-2zdS6XT9-btLWCE5i-N2lT7AlAe5amQQJNn-c,866
 plato/_generated/api/v1/testcases/get_testcase_metadata_for_scoring.py,sha256=pkrFamV66L_pDj6e7UDf0dDgqA1_Zf8Dz8Jki-ajLtI,1974
 plato/_generated/api/v1/testcases/get_testcase_sets.py,sha256=NSqnYWvj_G3ivnuuV797g85NGzHXi3z-UlvvRoFMwRM,1375
-plato/_generated/api/v1/testcases/get_testcases.py,sha256=04J0JflxL27zhWPl0RMpSQV8te6fHt-c-z-YX3UPjB8,5283
+plato/_generated/api/v1/testcases/get_testcases.py,sha256=AjsC2aw1VJOtGEe-Km36uVktdxR6IRahhbHCjeAUxcY,5756
 plato/_generated/api/v1/testcases/get_testcases_in_set.py,sha256=TJK2KHmGC5lNmBPoAXbZ6FktUael9v8Ecl4M8XAhceg,1501
 plato/_generated/api/v1/testcases/mark_organization_test_case_completed.py,sha256=bbtE5PWIA9X0EkyrSXE8YN0gp6x6sfno0rc02AK_-l0,1521
 plato/_generated/api/v1/testcases/update_testcase.py,sha256=-kTW31ioDzQvr2AmOv9gHL7jN6K9qhGyjnJfNHETwhA,1699
@@ -272,7 +272,7 @@ plato/_generated/api/v2/sessions/log_job_mutation.py,sha256=6x8rSFCbd3u3p3jms62X
 plato/_generated/api/v2/sessions/make.py,sha256=1FP7rCbjT62T8Of9otByl6L0p-VwwsruoaK--vYUUx0,2081
 plato/_generated/api/v2/sessions/reset.py,sha256=L8s2E_8wMq0hkNGNKrCx8gHTm-1KXltlzfHVI5sY14U,1941
 plato/_generated/api/v2/sessions/set_date.py,sha256=jbw3KVBI5TngHGBMavFawjNudRutAC0eb8jEbsSJdkw,2278
-plato/_generated/api/v2/sessions/setup_sandbox.py,sha256=gAb_jC69U_zroOSkJihYdFdhW6UCIL6EapBWAbzTprY,3160
+plato/_generated/api/v2/sessions/setup_sandbox.py,sha256=FtxC3NXFPpITupyBYlRtsMfP64vXYuKq23pwACT9v0U,3162
 plato/_generated/api/v2/sessions/snapshot.py,sha256=JDtrpRJGVjo4naTCJzWNNc4lCgZuCirfNcULH8Xk97Q,2650
 plato/_generated/api/v2/sessions/snapshot_store.py,sha256=4p08pCr2EWHQu2LqjIkRtlicTaFyfa7f39f8w0NRfeg,2978
 plato/_generated/api/v2/sessions/state.py,sha256=XecKyoItKQGwCOx_IO_VcnXh5rdpC6hCUSGJdxlEi7E,2328
@@ -282,7 +282,7 @@ plato/_generated/api/v2/user/__init__.py,sha256=yMh1Gn9VpKHQMQCmJdpeDPA9Ek9PBgP0
 plato/_generated/api/v2/user/get_current_user.py,sha256=tvamtbWTEkeeNUBLSPqZIcCGqKVadQM3DVcezsWP22U,1814
 plato/_generated/api/version/__init__.py,sha256=dQXTYrXjD1RZcvWwnlqXWAZ-eAV-V-6JSNuY7uaca7o,70
 plato/_generated/api/version/check.py,sha256=HTVNw0oi9gbvX4pOVoH4y4JywCxdl1pJTCk2PjJFwJ4,778
-plato/_generated/models/__init__.py,sha256=VGsTMYUCCqa7r_tl5m--dwjy7viYAN20nU2HhVAibcU,154130
+plato/_generated/models/__init__.py,sha256=6hl9VvbtRkF5MBLcnuWdI2N26mBKPKV0opn7rqtWJy4,155575
 plato/_sims_generator/__init__.py,sha256=Km4QOl9wxjQ5dgpdhk9QnBFJFFc9eq3rPbMWIQRjIn0,1602
 plato/_sims_generator/cli.py,sha256=mzolN-dxfMkVAdA-vC0esnai-cGg-i4ozOw8dACefV4,2709
 plato/_sims_generator/instruction.py,sha256=Na9M-jIdBPhp_fLuBPTicoFnWriRyi8YiZ-eQBj64HI,6644
@@ -310,33 +310,49 @@ plato/chronos/client.py,sha256=YcOGtHWERyOD9z8LKt8bRMVL0cEwL2hiAP4qQgdZlUI,5495
 plato/chronos/errors.py,sha256=xqQIQB43nAL5urF8qc_1KUJql7KCnspULOFHLNnf83M,4199
 plato/chronos/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plato/chronos/api/__init__.py,sha256=e1IO2-7hMVNtiwyZKQIwIW9LpgcPb5os48Wjxk6G3EY,43
+plato/chronos/api/admin/__init__.py,sha256=pvUWoZqnT2cQTNfZn4EH1OKTpYg3dc4iXUvUeSUmRqI,501
+plato/chronos/api/admin/clear_database_api_admin_clear_db_post.py,sha256=LhPrN7xw9K3Dcs2p7wiRG7WwOpc0k0uB5ndF79_nIRg,1329
+plato/chronos/api/admin/sync_agents_api_admin_sync_agents_post.py,sha256=K1PoATmHHw6u_6BLe8qnIQH7QHyRgbncNB6CdDoRWm4,1531
+plato/chronos/api/admin/sync_all_api_admin_sync_all_post.py,sha256=uUVj5XD6v2xWDj6xUvK2cO17qM4HkxTqjxW8QZFqE6Q,1546
+plato/chronos/api/admin/sync_runtimes_api_admin_sync_runtimes_post.py,sha256=SCWLEQ40q7jKL_7H9EAtTSYC24IeFHMQy1DSm1Wg9VQ,1539
+plato/chronos/api/admin/sync_worlds_api_admin_sync_worlds_post.py,sha256=p9RZUCpUS-ZGt9qIZ1ujVBM5N1A8UhY38T9v_wBIN2U,1531
 plato/chronos/api/agents/__init__.py,sha256=IaeIt8ge51rKVkR0wQzW6m0xJE74hFPxeothe2CuQhs,300
 plato/chronos/api/agents/create_agent.py,sha256=G8LR1KlWOCfmZ71Sl0seo7aRYmG7_nokZKoIRV6ysnw,1418
 plato/chronos/api/agents/delete_agent.py,sha256=fuL8Ip8veUXpOhSYxX_74S0zM_kZsTX61KosiFyhRWo,1241
 plato/chronos/api/agents/get_agent.py,sha256=o61fxCyYpTe6-3SC2RAebp3kW8rgEOWSN_NCph_iMUc,1358
 plato/chronos/api/agents/get_agent_schema.py,sha256=t66UCalfuHExr3MmUcZdE_inGvfFerE8MC7iR14edsY,1769
 plato/chronos/api/agents/get_agent_versions.py,sha256=mVLFvOrAwoyR9Jnu4F26EhNv08zGbXywiohr6hojxMY,1496
-plato/chronos/api/agents/list_agents.py,sha256=jtzD0wFmlHPDFqrChCLCG5m6LkLuxNlZk4EboRpcAYA,1253
+plato/chronos/api/agents/list_agents.py,sha256=OcycIUUc8yTGAhmpr2qhU2-2qIbvAtKko6l7cgmcKes,1343
 plato/chronos/api/agents/lookup_agent.py,sha256=DOGfrOK6Lh6ULMqRmf4zRQHlDXMhYenidx8wcZx4caY,1766
 plato/chronos/api/auth/__init__.py,sha256=6qao3xT8yw9-WTpUlv4tVtpWhL2EycQd3I2WKQ5p9Lk,284
 plato/chronos/api/auth/debug_auth_api_auth_debug_get.py,sha256=L1RWyQ1w7V8dyhOAU2VQlT9x0jkeng3eIvZDOv9Gl2w,881
 plato/chronos/api/auth/get_auth_status_api_auth_status_get.py,sha256=i9JzH9vPeswvbWtBAkMikepbNAyNK8jpTcALU6ScG5s,1379
 plato/chronos/api/auth/get_current_user_route_api_auth_me_get.py,sha256=w9zz7ivQpYKvV6FPIEuNHfI5BOl9bu3FYbJ5ADEuTPc,1210
+plato/chronos/api/checkpoints/__init__.py,sha256=i-soJMj3EFoUvjWog_AyJXwoGf9K51CjArd0uDeXJ98,138
+plato/chronos/api/checkpoints/list_checkpoints.py,sha256=ONcbX5vSOl_PX6_uNP5Rm2iWxCkat39OgJOxX-i16Lk,1172
+plato/chronos/api/checkpoints/preview_checkpoint.py,sha256=UDcWupD0dC5KCGdcCUX4mtEI4yL6fivOr8_yyrCfiFo,2210
 plato/chronos/api/default/__init__.py,sha256=TCF1Fl95ZyiR9-xHzf_R2A6TNb7k59N1VfSI5PAj4Pg,72
 plato/chronos/api/default/health.py,sha256=PvBLZXdYptL9d5_BEmzUsbUjQJTNGw5E4AFryPYiruw,781
+plato/chronos/api/events/__init__.py,sha256=jG6BaEeIDQFAlLjzCrAXaoG-2GV_Q9GDm1cu86mx9C4,142
+plato/chronos/api/events/get_session_event.py,sha256=hxgelY_gZ3ZIBJDBN7xF0aQYmpi5QnxvZ-NyFV8dZfU,1573
+plato/chronos/api/events/list_session_events.py,sha256=-u4qi7_eNmC8Mxg0paDIrZ4IzwasAjBX8Nj43haWGcA,1495
 plato/chronos/api/jobs/__init__.py,sha256=JP76_irfuFV31HOgazh7Y81GSkcunJP_eYWX8Pqq1U0,80
-plato/chronos/api/jobs/launch_job.py,sha256=K66_nEGdfH5L-LlXdaSJAftxhq_th69IjScZ4P_On6I,1457
+plato/chronos/api/jobs/launch_job.py,sha256=mdCxUpyUVI5NS9mctllRUbNOe7yVSunupnoh4RJYuNQ,1711
+plato/chronos/api/otel/__init__.py,sha256=w_DyYdNLj6xHi260C-HK9TJcZau0PJLOqey3qVwO9Wg,266
+plato/chronos/api/otel/get_session_traces_api_otel_sessions__session_id__traces_get.py,sha256=s7xGuLD-TEYsUx56icdoBNiACaCo4Pcm8QDSuc74vSA,1294
+plato/chronos/api/otel/receive_traces_api_otel_v1_traces_post.py,sha256=XvEe6XBB672qZ_d9IkD9dhxehK-H07yGxqKPaZG-EXA,1074
 plato/chronos/api/registry/__init__.py,sha256=gPN-3oENHUrwaiacYt1_jI7HQ6gGe9i-34-Smb-0KHg,819
 plato/chronos/api/registry/get_agent_schema_api_registry_agents__agent_name__schema_get.py,sha256=FOtVolBNmRuhgaCmL_d3cGvx81lVoz0WXQRP_-qArHM,1443
 plato/chronos/api/registry/get_agent_versions_api_registry_agents__agent_name__versions_get.py,sha256=TjYCZcIc6Bc0iS1E2MMPAK-yDUX_zijT8g7We7dNcQI,1176
 plato/chronos/api/registry/get_world_schema_api_registry_worlds__package_name__schema_get.py,sha256=RM-1MDYaG8B9iRl93KBG4tVjWJAHA08X6lSwjzk8fkw,1697
 plato/chronos/api/registry/get_world_versions_api_registry_worlds__package_name__versions_get.py,sha256=07MKXi5-d8Qk8cKRdVW2AZoeeksX7OpTgFR9bkJni0Y,1206
-plato/chronos/api/registry/list_registry_agents_api_registry_agents_get.py,sha256=gzRRPfHGzhczL1Xi274cg-oLwUzqdS2B7JkzhHNZKEw,1121
+plato/chronos/api/registry/list_registry_agents_api_registry_agents_get.py,sha256=3rACHpvv2P7gooHcNH4sU82pCSPIWH0f17lmQyGdEyU,1031
 plato/chronos/api/registry/list_registry_worlds_api_registry_worlds_get.py,sha256=g9KHZ2ZLJnhS5uCb55K7ez5plpfGL88o-pcdLMDgrRg,1010
-plato/chronos/api/runtimes/__init__.py,sha256=fO9UYFKrk66Xf9eV7FZO3Wv2VH6FN56Y_uNyPgSEpro,228
+plato/chronos/api/runtimes/__init__.py,sha256=_887oqgAfMazmoU-tTbOQ4k-k6E0PW004bdFxTM117M,270
 plato/chronos/api/runtimes/create_runtime.py,sha256=D37d2nMqyTxT8r_9faPWI-E18pAVjLlh0hCgBf0L6wQ,1524
 plato/chronos/api/runtimes/delete_runtime.py,sha256=x_z2naim1cLW1ko99jWRkGoyawiIfv66Jt6d8pgEGt4,1261
 plato/chronos/api/runtimes/get_runtime.py,sha256=8mL2tgFwAml30RHcURjr9Tz4H4Yo-r0cSGHuL741ZZM,1394
+plato/chronos/api/runtimes/get_runtime_logs.py,sha256=ruyMDqSFDUAB84EjudwEt--0qItU7njyYUL-UrSYKTo,1347
 plato/chronos/api/runtimes/list_runtimes.py,sha256=8o1NMWHEH8dINK9qZhMlxyBU0ygqSmyN7HigYkIwqa8,1271
 plato/chronos/api/runtimes/test_runtime.py,sha256=AfN_gVPQ991m1op3W6Lm64qG_CqarHgJK0bttJm09SU,1626
 plato/chronos/api/secrets/__init__.py,sha256=BfB4AiGt54zgcrmm-C57lbKY3DI8p1YnG2yuys3ie1A,222
@@ -345,11 +361,20 @@ plato/chronos/api/secrets/delete_secret.py,sha256=LWzJ78lT9C5NNhlaq8JJ4HcKzCVoj5
 plato/chronos/api/secrets/get_secret.py,sha256=c4WzODFGHINAmdz8EWejECdlY9ezkWraUGWrwVuTPRA,1356
 plato/chronos/api/secrets/list_secrets.py,sha256=_FT1VNok1STthEbjjGWmyGxjkRDvvDD_awU3xkjC1ak,1301
 plato/chronos/api/secrets/update_secret.py,sha256=049iqznfUWpZVHVsw5y1c06KddX5Ou4keYiADyuLqjg,1550
-plato/chronos/api/sessions/__init__.py,sha256=hF6a5a8sR5BUScqI6oDqDET8dhiiXKIAIzjUlGV9Yow,220
-plato/chronos/api/sessions/get_session.py,sha256=T_dn4vC5_WU0rTpiHIKEoxRdxAXr5Cjw_K8PFgauHng,1374
-plato/chronos/api/sessions/get_session_logs.py,sha256=o8lgdQfAvzOFYT8vtQUT1FGKH0Cr2uS3HeF8uIA0bP8,1656
+plato/chronos/api/sessions/__init__.py,sha256=hKnXWZFpuB6yTkgkBlN_BMp0cdDqsFWTPLeXIZxd1eY,679
+plato/chronos/api/sessions/close_session.py,sha256=lGmWkSfh-9ul1nVzYSn0Ymck3ntm0UG0m4Jm0d1lU1A,1552
+plato/chronos/api/sessions/complete_session.py,sha256=F_iYyBAj_iin-492vHAVA0CCSz-lwtpmU0hPVBNc9Gw,1912
+plato/chronos/api/sessions/create_session.py,sha256=p0PaUQLnWzhsekKUnQM5KiU8b68vldjR90Z8fn17gUo,1812
+plato/chronos/api/sessions/get_session.py,sha256=_7TR8g1oFyKPQc0n94BmFScXQDkmXvP5mWRW94jMvm8,1961
+plato/chronos/api/sessions/get_session_bash_logs_download.py,sha256=0WMxNC5XFVtMuCbIZxtEiUUQW9B4BihwSHkWUTD2YhU,1325
+plato/chronos/api/sessions/get_session_envs.py,sha256=N73sE-oYRbBVk4JsXkrbVtNda1B8gRCMSyxX5N_EAxA,1464
+plato/chronos/api/sessions/get_session_live_logs.py,sha256=3H5MHwYBr5mzQxBNEx54UOOOyc2tFLXC3iyOob_drIU,1433
+plato/chronos/api/sessions/get_session_logs.py,sha256=mH9EZ2dD22U4KPEMwCp6RRbJ8k-ZhmSOF9bx8XgWVMc,1662
 plato/chronos/api/sessions/get_session_logs_download.py,sha256=u1VKN9_ya5HviQvuj47Bjxb8TdTRrVjGZ-xhh34j5JE,1491
-plato/chronos/api/sessions/list_sessions.py,sha256=rR0quFEC9XoC39MbgGSEmeypzzYLOrnAmB3h_7TZXsU,1271
+plato/chronos/api/sessions/get_session_status.py,sha256=pka9CNYW1DwfB5xxo8ffbfJ3sDQBhxOnNL7-J0pCyVY,1476
+plato/chronos/api/sessions/list_sessions.py,sha256=xYZq1Iz0gi81vZbTyuLvxK0yoW0FAhRG9OG6g43AY60,1928
+plato/chronos/api/sessions/list_tags.py,sha256=zMIHZhCH5o0Mspz9Z9eX_dUEwBRsQs2rhlhQLGZUuCM,2002
+plato/chronos/api/sessions/update_session_tags.py,sha256=mJuhBoqK6bIvtGI2KAgEt_wq1s5Yv4WYu29m1JNjq_w,1596
 plato/chronos/api/status/__init__.py,sha256=LUmI3D_ynVMsnkWJI-6rm5ZuWjZypULrBKQDfh2uq-Y,184
 plato/chronos/api/status/get_status_api_status_get.py,sha256=3l7KaWkxZI7GUIJaxJjNsAA1WSP6z4TxL6uRooqNFDs,951
 plato/chronos/api/status/get_version_info_api_version_get.py,sha256=CzFsUMDH2BIxVg0plECsXRrwtSE73ORAutNsmD6u1Zc,937
@@ -367,7 +392,7 @@ plato/chronos/api/worlds/create_world.py,sha256=H6yl5QIazNXgryOR5rvscSIMf8Y9kjc6
 plato/chronos/api/worlds/delete_world.py,sha256=UETu3Zk0e2VkDdAyMilv1ev-0g_j-oujH1Dc8DBqQOc,1239
 plato/chronos/api/worlds/get_world.py,sha256=eHTM1U5JiNTaZwYLh7x4QVBoRQeI5kaJ9o6xSi4-nos,1356
 plato/chronos/api/worlds/list_worlds.py,sha256=hBAuGb69tlasyn-kV_LNr9x6Rr7SHhST5hXJn1uqMf8,1253
-plato/chronos/models/__init__.py,sha256=t9Kn9qwMBm2S9qs9weF0-CBCg4o1-u_W_3kDFQb-aDU,21328
+plato/chronos/models/__init__.py,sha256=9eWjOOgT7WULPFpO_b_qCP-k_vMdest-Y2-JsBF7KS4,22646
 plato/sims/README.md,sha256=FIbJhNVNAV-SO6dq_cXX3Rg0C7HdQCfEY9YxGlkCmsM,6902
 plato/sims/__init__.py,sha256=tnoCGKZwNx6h22tEWLujdpLv6K4PpFU2RnDOhL1o-Uc,1494
 plato/sims/agent_helpers.py,sha256=kITvQywoTCS8mGhro3jZWuPJHDlje-UZujhjoahqhd0,10291
@@ -387,7 +412,7 @@ plato/v1/sync_flow_executor.py,sha256=kgvNYOtA9FHeNfP7qb8ZPUIlTsfIss_Z98W8uX5vec
 plato/v1/sync_sdk.py,sha256=2sedg1QJiSxr1I3kCyfaLAnlAgHlbblc3QQP_47O30k,25697
 plato/v1/cli/__init__.py,sha256=om4b7PxgsoI7rEwuQelmQkqPdhMVn53_5qEN8kvksYw,105
 plato/v1/cli/agent.py,sha256=EbmEKWCMC5DJjmVDrYuwGenhIDgPjie8hdwrDOTSXaY,43766
-plato/v1/cli/chronos.py,sha256=uSgvj9uvBElBWP5me30OhH5eFVvFtH8TxvcIPEie3gA,25601
+plato/v1/cli/chronos.py,sha256=S6_PKDsZt55XDVFKPxJY5FQBfoYePLpZq3JTnNN75rY,27430
 plato/v1/cli/main.py,sha256=iKUz6Mu-4-dgr29qOUmDqBaumOCzNQKZsHAalVtaH0Q,6932
 plato/v1/cli/pm.py,sha256=TIvXBIWFDjr4s1girMMCuvHWQJkjpmsS-igAamddIWE,49746
 plato/v1/cli/sandbox.py,sha256=jhTney-Pr8bGmWIXOjVIMtZJ7v7uIoRnuh3wfG7weRg,98718
@@ -439,17 +464,19 @@ plato/v1/models/flow.py,sha256=bkleb7-OR6V5tzPtggf0ZJhHZQwnktCYr1C-ONpRzwE,6920
 plato/v1/models/sandbox.py,sha256=yRN036G91tFAXGxU1ni7zCU1o7U1N8nI0mjLlBRDoSk,3478
 plato/v1/models/task.py,sha256=QXwdFpDM_NLjRpQSK6duibXJXFAPZ8-PpyuLWZC5o4I,4897
 plato/v1/utils/proxytunnel.py,sha256=N1MshFY3Pu3d19cTU619-e-gP2_j-89CEcld7lCoiGk,5706
-plato/v2/__init__.py,sha256=YUzdRnXsL61ey-LOoR-HZGYgfGKBxnuMtFIu-D0VB8E,1662
+plato/v2/__init__.py,sha256=Adlul2CFMdyAPMP7ziGO3R_PO66sH7PsmGe4id0rTCs,2000
 plato/v2/models.py,sha256=41EJPdbAsW-gARVND0cg4jqpzQuYlrbAW9hF8WI8kX4,2369
 plato/v2/types.py,sha256=MrHiE8AobOegeTfoKKHZ5JTccaFfS3-EW0arV7q8S5c,3533
-plato/v2/async_/__init__.py,sha256=zcNwuX2XD-WkUCFLvXtdRqFmCgeuY3-D4zGTRVwsAFI,484
+plato/v2/async_/__init__.py,sha256=rq9olvr4PuI6sY535IsLT4kg9YX_sGYrrY6SA991xk8,654
 plato/v2/async_/artifact.py,sha256=JBWVQeVaZhkU2qn_knyzyA7wd5iQ8qxfLQ_l9GPhgYs,1217
+plato/v2/async_/chronos.py,sha256=WeqYF3HIKs7hV9LNZb2GlDS1yP6b422DZKtNuPxdL34,12394
 plato/v2/async_/client.py,sha256=GVgAgNN5gsDME8iV0zxqnwbsVS93J6cknOcq_VXwYN8,4209
 plato/v2/async_/environment.py,sha256=M5IeWYLwREOIyuS2zqgBSqHE_x66_OZXrevA9Rkc8Is,5825
 plato/v2/async_/flow_executor.py,sha256=Tl4nRu1ZPWJFNNxyTGy-PxvebZEUD18ZDaz8T2chtzU,14188
 plato/v2/async_/session.py,sha256=ssTEFgfpDQElQEmeKulLWKLoW-wA3m_nI3UvEWb9lB0,36749
-plato/v2/sync/__init__.py,sha256=_WigxuehCC8A2yRy4mSaMQmIZhS0Gch4hhZC1VHyYXs,310
+plato/v2/sync/__init__.py,sha256=6Hzc5k34WnHTUMPWrIefnL4P5YEoJMRLOmYDO7LxGg8,405
 plato/v2/sync/artifact.py,sha256=wTLC-tugG128wLvh-JqNPb0zsw5FXEJlZNahurSWink,1169
+plato/v2/sync/chronos.py,sha256=ChXpasjRzAZjoYTimpPqYydnwEk-IgdxR0SDXDOZbUM,12078
 plato/v2/sync/client.py,sha256=Q9fS1BF4KxTMMnceMwCMlb5dNFZ6LA4gsXWNLgsL2eE,3870
 plato/v2/sync/environment.py,sha256=WnDzbyEHpwCSEP8XnfNSjIYS7rt7lYR4HGJjzprZmTQ,5066
 plato/v2/sync/flow_executor.py,sha256=N41-WCWIJVcCR2UmPUEiK7roNacYoeONkRXpR7lUgT8,13941
@@ -460,11 +487,11 @@ plato/v2/utils/models.py,sha256=PwehSSnIRG-tM3tWL1PzZEH77ZHhIAZ9R0UPs6YknbM,1441
 plato/v2/utils/proxy_tunnel.py,sha256=8ZTd0jCGSfIHMvSv1fgEyacuISWnGPHLPbDglWroTzY,10463
 plato/worlds/README.md,sha256=XFOkEA3cNNcrWkk-Cxnsl-zn-y0kvUENKQRSqFKpdqw,5479
 plato/worlds/__init__.py,sha256=nwuEerEkP2TSfadPiOMcUE3p6u1vhaS7ZxfTh2zNcF8,2217
-plato/worlds/base.py,sha256=1O3iKilXlr56mUPVovHY_BjM3S8T57FrotF4895qv5Y,30675
+plato/worlds/base.py,sha256=8skzeNlufimvXdWBKVAjmgkZ3xGGt0ijRnu6darPxsk,31017
 plato/worlds/build_hook.py,sha256=KSoW0kqa5b7NyZ7MYOw2qsZ_2FkWuz0M3Ru7AKOP7Qw,3486
 plato/worlds/config.py,sha256=OJtBygnVACQl_kGF8iLofTIk8zMu8tTCNYav6lHdwNI,12874
 plato/worlds/runner.py,sha256=r9B2BxBae8_dM7y5cJf9xhThp_I1Qvf_tlPq2rs8qC8,4013
-plato_sdk_v2-2.5.0.dist-info/METADATA,sha256=B5O9klRDioab0Ay7I_0V0q-yNvWes23frcHXt-3rGbU,8652
-plato_sdk_v2-2.5.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-plato_sdk_v2-2.5.0.dist-info/entry_points.txt,sha256=upGMbJCx6YWUTKrPoYvYUYfFCqYr75nHDwhA-45m6p8,136
-plato_sdk_v2-2.5.0.dist-info/RECORD,,
+plato_sdk_v2-2.6.0.dist-info/METADATA,sha256=_c1ttshrdw9fnmaXOO3-tEVSHGWz24tWl6s33A9viGw,8652
+plato_sdk_v2-2.6.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+plato_sdk_v2-2.6.0.dist-info/entry_points.txt,sha256=upGMbJCx6YWUTKrPoYvYUYfFCqYr75nHDwhA-45m6p8,136
+plato_sdk_v2-2.6.0.dist-info/RECORD,,