plato-sdk-v2 2.7.4__py3-none-any.whl → 2.7.5__py3-none-any.whl

plato/chronos/api/agents/get_agent_schema.py

@@ -7,7 +7,7 @@ from typing import Any
 import httpx
 
 from plato.chronos.errors import raise_for_status
-from plato.chronos.models import ChronosModelsAgentAgentSchemaResponse
+from plato.chronos.models import AgentSchemaResponse
 
 
 def _build_request_args(
@@ -39,7 +39,7 @@ def sync(
     name: str,
     version: str | None = None,
     x_api_key: str | None = None,
-) -> ChronosModelsAgentAgentSchemaResponse:
+) -> AgentSchemaResponse:
     """Get agent schema by name and optional version."""
 
     request_args = _build_request_args(
@@ -50,7 +50,7 @@ def sync(
 
     response = client.request(**request_args)
     raise_for_status(response)
-    return ChronosModelsAgentAgentSchemaResponse.model_validate(response.json())
+    return AgentSchemaResponse.model_validate(response.json())
 
 
 async def asyncio(
@@ -58,7 +58,7 @@ async def asyncio(
     name: str,
     version: str | None = None,
     x_api_key: str | None = None,
-) -> ChronosModelsAgentAgentSchemaResponse:
+) -> AgentSchemaResponse:
     """Get agent schema by name and optional version."""
 
     request_args = _build_request_args(
@@ -69,4 +69,4 @@ async def asyncio(
 
     response = await client.request(**request_args)
     raise_for_status(response)
-    return ChronosModelsAgentAgentSchemaResponse.model_validate(response.json())
+    return AgentSchemaResponse.model_validate(response.json())

plato/chronos/api/agents/get_agent_versions.py

@@ -7,7 +7,7 @@ from typing import Any
 import httpx
 
 from plato.chronos.errors import raise_for_status
-from plato.chronos.models import ChronosModelsAgentAgentVersionsResponse
+from plato.chronos.models import AgentVersionsResponse
 
 
 def _build_request_args(
@@ -32,7 +32,7 @@ def sync(
     client: httpx.Client,
     name: str,
     x_api_key: str | None = None,
-) -> ChronosModelsAgentAgentVersionsResponse:
+) -> AgentVersionsResponse:
     """Get all versions of an agent by name."""
 
     request_args = _build_request_args(
@@ -42,14 +42,14 @@ def sync(
 
     response = client.request(**request_args)
     raise_for_status(response)
-    return ChronosModelsAgentAgentVersionsResponse.model_validate(response.json())
+    return AgentVersionsResponse.model_validate(response.json())
 
 
 async def asyncio(
     client: httpx.AsyncClient,
     name: str,
     x_api_key: str | None = None,
-) -> ChronosModelsAgentAgentVersionsResponse:
+) -> AgentVersionsResponse:
     """Get all versions of an agent by name."""
 
     request_args = _build_request_args(
@@ -59,4 +59,4 @@ async def asyncio(
 
     response = await client.request(**request_args)
     raise_for_status(response)
-    return ChronosModelsAgentAgentVersionsResponse.model_validate(response.json())
+    return AgentVersionsResponse.model_validate(response.json())

plato/chronos/api/agents/list_agents.py

@@ -7,7 +7,7 @@ from typing import Any
 import httpx
 
 from plato.chronos.errors import raise_for_status
-from plato.chronos.models import ChronosModelsAgentAgentListResponse
+from plato.chronos.models import AgentListResponse
 
 
 def _build_request_args(
@@ -30,7 +30,7 @@ def _build_request_args(
 def sync(
     client: httpx.Client,
     x_api_key: str | None = None,
-) -> ChronosModelsAgentAgentListResponse:
+) -> AgentListResponse:
     """List all agents for the org."""
 
     request_args = _build_request_args(
@@ -39,13 +39,13 @@ def sync(
 
     response = client.request(**request_args)
     raise_for_status(response)
-    return ChronosModelsAgentAgentListResponse.model_validate(response.json())
+    return AgentListResponse.model_validate(response.json())
 
 
 async def asyncio(
     client: httpx.AsyncClient,
     x_api_key: str | None = None,
-) -> ChronosModelsAgentAgentListResponse:
+) -> AgentListResponse:
     """List all agents for the org."""
 
     request_args = _build_request_args(
@@ -54,4 +54,4 @@ async def asyncio(
 
     response = await client.request(**request_args)
     raise_for_status(response)
-    return ChronosModelsAgentAgentListResponse.model_validate(response.json())
+    return AgentListResponse.model_validate(response.json())

plato/chronos/api/registry/get_agent_schema_api_registry_agents__agent_name__schema_get.py

@@ -7,7 +7,7 @@ from typing import Any
 import httpx
 
 from plato.chronos.errors import raise_for_status
-from plato.chronos.models import AgentSchemaResponse
+from plato.chronos.models import ChronosApiRegistryAgentSchemaResponse
 
 
 def _build_request_args(
@@ -32,7 +32,7 @@ def sync(
     client: httpx.Client,
     agent_name: str,
     version: str | None = None,
-) -> AgentSchemaResponse:
+) -> ChronosApiRegistryAgentSchemaResponse:
     """Get schema for an agent version from the registry."""
 
     request_args = _build_request_args(
@@ -42,14 +42,14 @@ def sync(
 
     response = client.request(**request_args)
     raise_for_status(response)
-    return AgentSchemaResponse.model_validate(response.json())
+    return ChronosApiRegistryAgentSchemaResponse.model_validate(response.json())
 
 
 async def asyncio(
     client: httpx.AsyncClient,
     agent_name: str,
     version: str | None = None,
-) -> AgentSchemaResponse:
+) -> ChronosApiRegistryAgentSchemaResponse:
     """Get schema for an agent version from the registry."""
 
     request_args = _build_request_args(
@@ -59,4 +59,4 @@ async def asyncio(
 
     response = await client.request(**request_args)
     raise_for_status(response)
-    return AgentSchemaResponse.model_validate(response.json())
+    return ChronosApiRegistryAgentSchemaResponse.model_validate(response.json())

plato/chronos/api/registry/get_agent_versions_api_registry_agents__agent_name__versions_get.py

@@ -7,7 +7,7 @@ from typing import Any
 import httpx
 
 from plato.chronos.errors import raise_for_status
-from plato.chronos.models import AgentVersionsResponse
+from plato.chronos.models import ChronosApiRegistryAgentVersionsResponse
 
 
 def _build_request_args(
@@ -25,7 +25,7 @@ def _build_request_args(
 def sync(
     client: httpx.Client,
     agent_name: str,
-) -> AgentVersionsResponse:
+) -> ChronosApiRegistryAgentVersionsResponse:
     """Get versions for an agent from the registry."""
 
     request_args = _build_request_args(
@@ -34,13 +34,13 @@ def sync(
 
     response = client.request(**request_args)
     raise_for_status(response)
-    return AgentVersionsResponse.model_validate(response.json())
+    return ChronosApiRegistryAgentVersionsResponse.model_validate(response.json())
 
 
 async def asyncio(
     client: httpx.AsyncClient,
     agent_name: str,
-) -> AgentVersionsResponse:
+) -> ChronosApiRegistryAgentVersionsResponse:
     """Get versions for an agent from the registry."""
 
     request_args = _build_request_args(
@@ -49,4 +49,4 @@ async def asyncio(
 
     response = await client.request(**request_args)
     raise_for_status(response)
-    return AgentVersionsResponse.model_validate(response.json())
+    return ChronosApiRegistryAgentVersionsResponse.model_validate(response.json())

plato/chronos/api/registry/list_registry_agents_api_registry_agents_get.py

@@ -7,7 +7,7 @@ from typing import Any
 import httpx
 
 from plato.chronos.errors import raise_for_status
-from plato.chronos.models import AgentListResponse
+from plato.chronos.models import ChronosApiRegistryAgentListResponse
 
 
 def _build_request_args() -> dict[str, Any]:
@@ -22,23 +22,23 @@ def _build_request_args() -> dict[str, Any]:
 
 def sync(
     client: httpx.Client,
-) -> AgentListResponse:
+) -> ChronosApiRegistryAgentListResponse:
     """List all agents from the registry with their ECR image URIs."""
 
     request_args = _build_request_args()
 
     response = client.request(**request_args)
     raise_for_status(response)
-    return AgentListResponse.model_validate(response.json())
+    return ChronosApiRegistryAgentListResponse.model_validate(response.json())
 
 
 async def asyncio(
     client: httpx.AsyncClient,
-) -> AgentListResponse:
+) -> ChronosApiRegistryAgentListResponse:
     """List all agents from the registry with their ECR image URIs."""
 
     request_args = _build_request_args()
 
     response = await client.request(**request_args)
     raise_for_status(response)
-    return AgentListResponse.model_validate(response.json())
+    return ChronosApiRegistryAgentListResponse.model_validate(response.json())

plato/chronos/api/sessions/__init__.py

@@ -11,6 +11,7 @@ from . import (
     get_session_logs,
     get_session_logs_download,
     get_session_status,
+    list_session_creators,
     list_sessions,
     list_tags,
     update_session_tags,
@@ -20,6 +21,7 @@ __all__ = [
     "list_sessions",
     "create_session",
     "list_tags",
+    "list_session_creators",
     "get_session",
     "get_session_status",
     "update_session_tags",

plato/chronos/api/sessions/complete_session.py

@@ -39,7 +39,8 @@ def sync(
     """Mark a session as completed or failed.
 
     Called by the bootstrap script when the world runner finishes.
-    Uses API key auth (no org check) since it's called from the VM."""
+    Uses API key auth (no org check) since it's called from the VM.
+    Also closes the Plato session to release VM resources."""
 
     request_args = _build_request_args(
         public_id=public_id,
@@ -61,7 +62,8 @@ async def asyncio(
     """Mark a session as completed or failed.
 
     Called by the bootstrap script when the world runner finishes.
-    Uses API key auth (no org check) since it's called from the VM."""
+    Uses API key auth (no org check) since it's called from the VM.
+    Also closes the Plato session to release VM resources."""
 
     request_args = _build_request_args(
         public_id=public_id,

plato/chronos/api/sessions/list_session_creators.py

@@ -0,0 +1,57 @@
+"""List Session Creators"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from plato.chronos.errors import raise_for_status
+from plato.chronos.models import CreatorsListResponse
+
+
+def _build_request_args(
+    x_api_key: str | None = None,
+) -> dict[str, Any]:
+    """Build request arguments."""
+    url = "/api/sessions/creators"
+
+    headers: dict[str, str] = {}
+    if x_api_key is not None:
+        headers["X-API-Key"] = x_api_key
+
+    return {
+        "method": "GET",
+        "url": url,
+        "headers": headers,
+    }
+
+
+def sync(
+    client: httpx.Client,
+    x_api_key: str | None = None,
+) -> CreatorsListResponse:
+    """List distinct users who have created sessions in this org."""
+
+    request_args = _build_request_args(
+        x_api_key=x_api_key,
+    )
+
+    response = client.request(**request_args)
+    raise_for_status(response)
+    return CreatorsListResponse.model_validate(response.json())
+
+
+async def asyncio(
+    client: httpx.AsyncClient,
+    x_api_key: str | None = None,
+) -> CreatorsListResponse:
+    """List distinct users who have created sessions in this org."""
+
+    request_args = _build_request_args(
+        x_api_key=x_api_key,
+    )
+
+    response = await client.request(**request_args)
+    raise_for_status(response)
+    return CreatorsListResponse.model_validate(response.json())

plato/chronos/api/sessions/list_sessions.py

@@ -12,6 +12,10 @@ from plato.chronos.models import SessionListResponse
 
 def _build_request_args(
     tag: str | None = None,
+    created_by: str | None = None,
+    limit: int | None = 50,
+    offset: int | None = None,
+    status: str | None = None,
     x_api_key: str | None = None,
 ) -> dict[str, Any]:
     """Build request arguments."""
@@ -20,6 +24,14 @@ def _build_request_args(
     params: dict[str, Any] = {}
     if tag is not None:
         params["tag"] = tag
+    if created_by is not None:
+        params["created_by"] = created_by
+    if limit is not None:
+        params["limit"] = limit
+    if offset is not None:
+        params["offset"] = offset
+    if status is not None:
+        params["status"] = status
 
     headers: dict[str, str] = {}
     if x_api_key is not None:
@@ -36,9 +48,13 @@ def _build_request_args(
 def sync(
     client: httpx.Client,
     tag: str | None = None,
+    created_by: str | None = None,
+    limit: int | None = 50,
+    offset: int | None = None,
+    status: str | None = None,
     x_api_key: str | None = None,
 ) -> SessionListResponse:
-    """List all sessions for the org, optionally filtered by tag.
+    """List sessions for the org with pagination and filtering.
 
     Tag filtering uses ltree for hierarchical matching:
     - 'project' matches 'project', 'project.foo', 'project.foo.bar'
@@ -46,6 +62,10 @@ def sync(
 
     request_args = _build_request_args(
         tag=tag,
+        created_by=created_by,
+        limit=limit,
+        offset=offset,
+        status=status,
         x_api_key=x_api_key,
     )
 
@@ -57,9 +77,13 @@ def sync(
 async def asyncio(
     client: httpx.AsyncClient,
     tag: str | None = None,
+    created_by: str | None = None,
+    limit: int | None = 50,
+    offset: int | None = None,
+    status: str | None = None,
     x_api_key: str | None = None,
 ) -> SessionListResponse:
-    """List all sessions for the org, optionally filtered by tag.
+    """List sessions for the org with pagination and filtering.
 
     Tag filtering uses ltree for hierarchical matching:
     - 'project' matches 'project', 'project.foo', 'project.foo.bar'
@@ -67,6 +91,10 @@ async def asyncio(
 
     request_args = _build_request_args(
         tag=tag,
+        created_by=created_by,
+        limit=limit,
+        offset=offset,
+        status=status,
         x_api_key=x_api_key,
     )
 

plato/chronos/models/__init__.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  tmpxmdo22xa.json
-#   timestamp: 2026-01-23T22:08:21+00:00
+#   filename:  tmp9iosw1i3.json
+#   timestamp: 2026-01-29T20:31:32+00:00
 
 from __future__ import annotations
 
@@ -30,13 +30,6 @@ class AgentInfo(BaseModel):
     image_uri: Annotated[str, Field(title="Image Uri")]
 
 
-class AgentListResponse(BaseModel):
-    model_config = ConfigDict(
-        extra="allow",
-    )
-    agents: Annotated[list[AgentInfo], Field(title="Agents")]
-
-
 class AgentLookupResponse(BaseModel):
     model_config = ConfigDict(
         extra="allow",
@@ -68,8 +61,6 @@ class AgentSchemaResponse(BaseModel):
     name: Annotated[str, Field(title="Name")]
     version: Annotated[str, Field(title="Version")]
     config_schema: Annotated[dict[str, Any] | None, Field(title="Config Schema")] = None
-    secrets_schema: Annotated[dict[str, Any] | None, Field(title="Secrets Schema")] = None
-    template_variables: Annotated[dict[str, Any] | None, Field(title="Template Variables")] = None
 
 
 class AgentVersionInfo(BaseModel):
@@ -77,7 +68,7 @@ class AgentVersionInfo(BaseModel):
         extra="allow",
     )
     version: Annotated[str, Field(title="Version")]
-    created_at: Annotated[str | None, Field(title="Created At")] = None
+    created_at: Annotated[AwareDatetime, Field(title="Created At")]
 
 
 class AgentVersionsResponse(BaseModel):
@@ -167,6 +158,10 @@ class CreateSessionRequest(BaseModel):
     """
     Plato session ID if already created
     """
+    tags: Annotated[list[str] | None, Field(title="Tags")] = None
+    """
+    Tags for the session
+    """
 
 
 class CreateSessionResponse(BaseModel):
@@ -406,6 +401,15 @@ class ServiceStatuses(BaseModel):
     plato: Annotated[str, Field(title="Plato")]
 
 
+class SessionCreator(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    public_id: Annotated[str, Field(title="Public Id")]
+    name: Annotated[str | None, Field(title="Name")] = None
+    email: Annotated[str | None, Field(title="Email")] = None
+
+
 class SessionEnvsResponse(BaseModel):
     model_config = ConfigDict(
         extra="allow",
@@ -562,36 +566,38 @@ class WorldVersionsResponse(BaseModel):
     versions: Annotated[list[str], Field(title="Versions")]
 
 
-class ChronosModelsAgentAgentListResponse(BaseModel):
+class ChronosApiRegistryAgentListResponse(BaseModel):
     model_config = ConfigDict(
         extra="allow",
     )
-    agents: Annotated[list[AgentResponse], Field(title="Agents")]
+    agents: Annotated[list[AgentInfo], Field(title="Agents")]
 
 
-class ChronosModelsAgentAgentSchemaResponse(BaseModel):
+class ChronosApiRegistryAgentSchemaResponse(BaseModel):
     model_config = ConfigDict(
         extra="allow",
     )
     name: Annotated[str, Field(title="Name")]
     version: Annotated[str, Field(title="Version")]
     config_schema: Annotated[dict[str, Any] | None, Field(title="Config Schema")] = None
+    secrets_schema: Annotated[dict[str, Any] | None, Field(title="Secrets Schema")] = None
+    template_variables: Annotated[dict[str, Any] | None, Field(title="Template Variables")] = None
 
 
-class ChronosModelsAgentAgentVersionInfo(BaseModel):
+class ChronosApiRegistryAgentVersionInfo(BaseModel):
     model_config = ConfigDict(
         extra="allow",
     )
     version: Annotated[str, Field(title="Version")]
-    created_at: Annotated[AwareDatetime, Field(title="Created At")]
+    created_at: Annotated[str | None, Field(title="Created At")] = None
 
 
-class ChronosModelsAgentAgentVersionsResponse(BaseModel):
+class ChronosApiRegistryAgentVersionsResponse(BaseModel):
     model_config = ConfigDict(
         extra="allow",
     )
     name: Annotated[str, Field(title="Name")]
-    versions: Annotated[list[ChronosModelsAgentAgentVersionInfo], Field(title="Versions")]
+    versions: Annotated[list[ChronosApiRegistryAgentVersionInfo], Field(title="Versions")]
 
 
 class ChronosModelsSessionWorldInfo(BaseModel):
@@ -604,6 +610,20 @@ class ChronosModelsSessionWorldInfo(BaseModel):
     config_schema: Annotated[dict[str, Any] | None, Field(title="Config Schema")] = None
 
 
+class AgentListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    agents: Annotated[list[AgentResponse], Field(title="Agents")]
+
+
+class CreatorsListResponse(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    creators: Annotated[list[SessionCreator], Field(title="Creators")]
+
+
 class EnvSecretListResponse(BaseModel):
     model_config = ConfigDict(
         extra="allow",

{plato_sdk_v2-2.7.4.dist-info → plato_sdk_v2-2.7.5.dist-info}/METADATA

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