evolve-sdk 0.0.52.dev711__tar.gz → 0.0.52.dev714__tar.gz

{evolve_sdk-0.0.52.dev711 → evolve_sdk-0.0.52.dev714}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: evolve-sdk
-Version: 0.0.52.dev711
+Version: 0.0.52.dev714
 Summary: Pythonic SDK for multi-agent orchestration in E2B sandboxes
 Author-email: "Swarmlink, Inc." <brandomagnani@evolvingmachines.ai>
 License: Apache-2.0

{evolve_sdk-0.0.52.dev711 → evolve_sdk-0.0.52.dev714}/evolve/__init__.py

@@ -59,6 +59,8 @@ from .hosted import (
     DatasetRef,
     DatasetSelector,
     DatasetVersion,
+    DatasetVersionGate,
+    DatasetVersionGateFailedTask,
     DatasetsClient,
     EvalSandboxProvider,
     EvolveAPIError,
@@ -361,7 +363,7 @@ async def list_checkpoints(
         await store.close()
 
 
-__version__ = '0.0.52.dev711'
+__version__ = '0.0.52.dev714'
 
 __all__ = [
     # Main classes
@@ -442,6 +444,8 @@ __all__ = [
     'Dataset',
     'ActiveDataset',
     'DatasetVersion',
+    'DatasetVersionGate',
+    'DatasetVersionGateFailedTask',
     'DatasetRef',
     'DatasetSelector',
     'DatasetImport',

{evolve_sdk-0.0.52.dev711 → evolve_sdk-0.0.52.dev714}/evolve/hosted.py

@@ -301,6 +301,40 @@ AttemptPhase = Literal[
 ]
 
 
+@dataclass
+class DatasetVersionGateFailedTask:
+    """One task the activation gate found ineligible.
+
+    ``outcome`` is the gate's verdict word (``FAIL``, or ``ERROR`` when the
+    run produced no usable score; ``None`` when the server omits it) and
+    ``reasons`` are the gate's own sentences for this task — empty when the
+    server names none.
+    """
+    task_name: str
+    outcome: Optional[str] = None
+    reasons: List[str] = field(default_factory=list)
+
+
+@dataclass
+class DatasetVersionGate:
+    """The activation gate's progress for one dataset version.
+
+    ``status`` is the gate's own lifecycle (``PENDING`` → ``RUNNING`` →
+    ``PASSED``/``FAILED`` as wire values). ``code`` and ``message`` are set on
+    failure — one machine word and one human sentence — and are ``None`` while
+    the gate is healthy. ``attempts`` counts gate runs so far.
+    ``failed_tasks`` names each ineligible task with the gate's own reasons
+    (the server sends the first 25); it is empty while the gate is healthy and
+    empty on servers that predate the field — absence is "nothing to report",
+    never a crash.
+    """
+    status: str
+    attempts: int
+    code: Optional[str] = None
+    message: Optional[str] = None
+    failed_tasks: List[DatasetVersionGateFailedTask] = field(default_factory=list)
+
+
 @dataclass
 class DatasetVersion:
     """One immutable version of a dataset — one shape on every surface."""
@@ -308,6 +342,10 @@ class DatasetVersion:
     state: str
     created_at: str
     task_count: int
+    #: Activation-gate progress. ``None`` when no gate was scheduled for this
+    #: version, and also ``None`` when the server predates the gate field — a
+    #: missing gate never means "passed", only "nothing to report".
+    gate: Optional[DatasetVersionGate] = None
 
 
 @dataclass
@@ -1160,12 +1198,66 @@ def _map_capability_document(raw: Dict[str, Any]) -> CapabilityDocument:
     )
 
 
+def _map_version_gate(data: Any) -> Optional[DatasetVersionGate]:
+    """Map a version's activation-gate field, tolerating every server generation.
+
+    An older server has no ``gate`` field at all; the current server sends the
+    nested form (``{status, attempts, failure: {code, message}}``); the flat
+    form carries ``code``/``message`` directly. Anything unreadable becomes
+    ``None`` — a missing gate is "nothing to report", never a crash and never
+    "passed".
+    """
+    if not isinstance(data, dict) or not isinstance(data.get('status'), str):
+        return None
+    failure = data.get('failure')
+    failure = failure if isinstance(failure, dict) else {}
+    code = data.get('code') if isinstance(data.get('code'), str) else failure.get('code')
+    message = (
+        data.get('message') if isinstance(data.get('message'), str) else failure.get('message')
+    )
+    attempts = data.get('attempts')
+    raw_failed = data.get('failed_tasks')
+    if not isinstance(raw_failed, list):
+        raw_failed = failure.get('failed_tasks')
+    return DatasetVersionGate(
+        status=data['status'],
+        attempts=attempts if isinstance(attempts, int) and not isinstance(attempts, bool) else 0,
+        code=code if isinstance(code, str) else None,
+        message=message if isinstance(message, str) else None,
+        failed_tasks=_map_gate_failed_tasks(raw_failed),
+    )
+
+
+def _map_gate_failed_tasks(data: Any) -> List[DatasetVersionGateFailedTask]:
+    """The per-task cause list behind a FAILED gate, with the gate's tolerance.
+
+    Absent or unreadable input is an empty list, an entry without a task name
+    is dropped, and non-string reasons are filtered — an older or misbehaving
+    server must never crash the client here.
+    """
+    if not isinstance(data, list):
+        return []
+    tasks: List[DatasetVersionGateFailedTask] = []
+    for item in data:
+        if not isinstance(item, dict) or not isinstance(item.get('task_name'), str):
+            continue
+        outcome = item.get('outcome')
+        reasons = item.get('reasons')
+        tasks.append(DatasetVersionGateFailedTask(
+            task_name=item['task_name'],
+            outcome=outcome if isinstance(outcome, str) else None,
+            reasons=[r for r in reasons if isinstance(r, str)] if isinstance(reasons, list) else [],
+        ))
+    return tasks
+
+
 def _map_dataset_version(data: Dict[str, Any]) -> DatasetVersion:
     return DatasetVersion(
         version=data['version'],
         state=data.get('state', ''),
         created_at=data.get('created_at', ''),
         task_count=int(data.get('task_count', 0)),
+        gate=_map_version_gate(data.get('gate')),
     )
 
 

{evolve_sdk-0.0.52.dev711 → evolve_sdk-0.0.52.dev714}/evolve_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: evolve-sdk
-Version: 0.0.52.dev711
+Version: 0.0.52.dev714
 Summary: Pythonic SDK for multi-agent orchestration in E2B sandboxes
 Author-email: "Swarmlink, Inc." <brandomagnani@evolvingmachines.ai>
 License: Apache-2.0

{evolve_sdk-0.0.52.dev711 → evolve_sdk-0.0.52.dev714}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "evolve-sdk"
-version = "0.0.52.dev711"
+version = "0.0.52.dev714"
 description = "Pythonic SDK for multi-agent orchestration in E2B sandboxes"
 readme = "README.md"
 requires-python = ">=3.10"