fleet-python 0.2.81__tar.gz → 0.2.82__tar.gz

{fleet_python-0.2.81/fleet_python.egg-info → fleet_python-0.2.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fleet-python
-Version: 0.2.81
+Version: 0.2.82
 Summary: Python SDK for Fleet environments
 Author-email: Fleet AI <nic@fleet.so>
 License: Apache-2.0
@@ -49,6 +49,10 @@ Dynamic: license-file
 
 # Fleet SDK
 
+[![PyPI version](https://img.shields.io/pypi/v/fleet-python.svg)](https://pypi.org/project/fleet-python/)
+[![Python versions](https://img.shields.io/pypi/pyversions/fleet-python.svg)](https://pypi.org/project/fleet-python/)
+[![License](https://img.shields.io/pypi/l/fleet-python.svg)](https://pypi.org/project/fleet-python/)
+
 The Fleet Python SDK provides programmatic access to Fleet's environment infrastructure.
 
 ## Installation

{fleet_python-0.2.81 → fleet_python-0.2.82}/README.md

@@ -1,5 +1,9 @@
 # Fleet SDK
 
+[![PyPI version](https://img.shields.io/pypi/v/fleet-python.svg)](https://pypi.org/project/fleet-python/)
+[![Python versions](https://img.shields.io/pypi/pyversions/fleet-python.svg)](https://pypi.org/project/fleet-python/)
+[![License](https://img.shields.io/pypi/l/fleet-python.svg)](https://pypi.org/project/fleet-python/)
+
 The Fleet Python SDK provides programmatic access to Fleet's environment infrastructure.
 
 ## Installation

{fleet_python-0.2.81 → fleet_python-0.2.82}/fleet/__init__.py

@@ -14,7 +14,7 @@
 
 """Fleet Python SDK - Environment-based AI agent interactions."""
 
-from typing import Optional, List
+from typing import Any, Optional, List
 
 from .exceptions import (
     FleetError,
@@ -24,8 +24,8 @@ from .exceptions import (
     FleetInstanceLimitError,
     FleetConfigurationError,
 )
-from .client import Fleet, SyncEnv
-from ._async.client import AsyncFleet, AsyncEnv
+from .client import Fleet, SyncEnv, Session
+from ._async.client import AsyncFleet, AsyncEnv, AsyncSession
 from .models import InstanceResponse, Environment, Run
 from .instance.models import Resource, ResetResponse
 
@@ -73,7 +73,7 @@ from . import env
 from . import global_client as _global_client
 from ._async import global_client as _async_global_client
 
-__version__ = "0.2.80"
+__version__ = "0.2.82"
 
 __all__ = [
     # Core classes
@@ -122,6 +122,14 @@ __all__ = [
     "import_tasks_async",
     "get_task",
     "get_task_async",
+    # Session helpers
+    "session",
+    "session_async",
+    "Session",
+    "AsyncSession",
+    # Job helpers
+    "job",
+    "job_async",
     # Version
     "__version__",
 ]
@@ -162,3 +170,117 @@ def reset_client():
     """Reset both sync and async global clients."""
     _global_client.reset_client()
     _async_global_client.reset_client()
+
+
+def session(
+    session_id: Optional[str] = None,
+    job_id: Optional[str] = None,
+    config: Optional[Any] = None,
+    model: Optional[str] = None,
+    task_key: Optional[str] = None,
+    instance_id: Optional[str] = None,
+) -> Session:
+    """Start a new session for logging agent interactions (sync).
+
+    This returns a Session object. The session is created on the backend
+    when you call log() for the first time.
+
+    Args:
+        session_id: Optional existing session ID to resume
+        job_id: Optional job ID to associate with the session
+        config: Optional config object (e.g., GenerateContentConfig) to log
+        model: Optional model name to log
+        task_key: Optional Fleet task key
+        instance_id: Optional Fleet instance ID
+
+    Returns:
+        Session object with log(), complete(), and fail() methods
+
+    Example:
+        session = fleet.session(config=config, model="gpt-4", task_key="task_123")
+        session.log(history, response)
+        session.complete()
+    """
+    client = _global_client.get_client()
+    return client.start_session(
+        session_id=session_id,
+        job_id=job_id,
+        config=config,
+        model=model,
+        task_key=task_key,
+        instance_id=instance_id,
+    )
+
+
+def session_async(
+    session_id: Optional[str] = None,
+    job_id: Optional[str] = None,
+    config: Optional[Any] = None,
+    model: Optional[str] = None,
+    task_key: Optional[str] = None,
+    instance_id: Optional[str] = None,
+) -> AsyncSession:
+    """Start a new session for logging agent interactions (async).
+
+    This returns an AsyncSession object. The session is created on the backend
+    when you call log() for the first time.
+
+    Args:
+        session_id: Optional existing session ID to resume
+        job_id: Optional job ID to associate with the session
+        config: Optional config object (e.g., GenerateContentConfig) to log
+        model: Optional model name to log
+        task_key: Optional Fleet task key
+        instance_id: Optional Fleet instance ID
+
+    Returns:
+        AsyncSession object with log(), complete(), and fail() methods
+
+    Example:
+        session = fleet.session_async(config=config, model="gpt-4", task_key="task_123")
+        await session.log(history, response)
+        await session.complete()
+    """
+    client = _async_global_client.get_client()
+    return client.start_session(
+        session_id=session_id,
+        job_id=job_id,
+        config=config,
+        model=model,
+        task_key=task_key,
+        instance_id=instance_id,
+    )
+
+
+def job(name: str) -> str:
+    """Create a new trace job (sync).
+
+    Args:
+        name: Name of the job
+
+    Returns:
+        The job_id string
+
+    Example:
+        job_id = fleet.job("my-agent-run")
+        session = fleet.session(job_id=job_id, ...)
+    """
+    client = _global_client.get_client()
+    return client.trace_job(name=name)
+
+
+async def job_async(name: str) -> str:
+    """Create a new trace job (async).
+
+    Args:
+        name: Name of the job
+
+    Returns:
+        The job_id string
+
+    Example:
+        job_id = await fleet.job_async("my-agent-run")
+        session = await fleet.session_async(job_id=job_id, ...)
+    """
+    client = _async_global_client.get_client()
+    return await client.trace_job(name=name)

{fleet_python-0.2.81 → fleet_python-0.2.82}/fleet/_async/__init__.py

@@ -24,7 +24,7 @@ from ..exceptions import (
     FleetInstanceLimitError,
     FleetConfigurationError,
 )
-from .client import AsyncFleet, AsyncEnv
+from .client import AsyncFleet, AsyncEnv, AsyncSession
 from ..models import InstanceResponse, Environment, AccountResponse, Run
 from ..instance.models import Resource, ResetResponse
 
@@ -44,7 +44,7 @@ from ..types import VerifierFunction
 from .. import env
 from . import global_client as _async_global_client
 
-__version__ = "0.2.79"
+__version__ = "0.2.82"
 
 __all__ = [
     # Core classes

{fleet_python-0.2.81 → fleet_python-0.2.82}/fleet/_async/base.py

@@ -26,7 +26,7 @@ from .exceptions import (
 try:
     from .. import __version__
 except ImportError:
-    __version__ = "0.2.79"
+    __version__ = "0.2.82"
 
 logger = logging.getLogger(__name__)