vis-agent 0.2.38.dev7565__tar.gz → 0.2.38.dev7570__tar.gz

{vis_agent-0.2.38.dev7565 → vis_agent-0.2.38.dev7570}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vis-agent
-Version: 0.2.38.dev7565
+Version: 0.2.38.dev7570
 Summary: The Vis Python SDK — author extensions and control local or remote engines.
 Project-URL: Homepage, https://vis.blockether.com
 Project-URL: Documentation, https://vis.blockether.com

{vis_agent-0.2.38.dev7565 → vis_agent-0.2.38.dev7570}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vis-agent"
-version = "0.2.38.dev7565"
+version = "0.2.38.dev7570"
 description = "The Vis Python SDK — author extensions and control local or remote engines."
 readme = "README.md"
 requires-python = ">=3.11"

{vis_agent-0.2.38.dev7565 → vis_agent-0.2.38.dev7570}/src/blockether/vis/evals/__init__.py

@@ -1,8 +1,10 @@
 """Evaluation tools: read Vis runs and Harbor jobs, and compare their results.
 
-For the reader of one Vis run, see `blockether.vis.evals.trajectory`. For Harbor jobs
-and round seals, see `blockether.vis.evals.harbor`. For the statistics, see
-`blockether.vis.evals.stats`.
+Read one Vis run with `load_trajectory` or `parse_trajectory`. Read the trials of a
+Harbor job or round with `read_trials`, then count them with `case_results` or
+`summarize`. Seal a finished round with `seal_round`. Compare paired results with
+`paired_change` and `mcnemar_exact`. For installation and sessions, use the
+[Python SDK guide](https://vis.blockether.com/python-sdk.html).
 """
 
 from .harbor import (

{vis_agent-0.2.38.dev7565 → vis_agent-0.2.38.dev7570}/src/blockether/vis/evals/trajectory.py

@@ -486,8 +486,8 @@ class Trajectory:
     """One Vis run read from an ATIF trajectory.
 
     The typed fields hold what evaluations check. `document` keeps the whole input,
-    also the keys that this reader does not know. Child runs of Council subagents
-    are in `subagents`.
+    also the keys that this reader does not know. Child runs are in
+    `subagent_trajectories`.
     """
 
     schema_version: str
@@ -497,7 +497,7 @@ class Trajectory:
     steps: tuple[Step, ...]
     final_metrics: TrajectoryMetrics | None
     extra: Mapping[str, Any]
-    subagents: tuple[Trajectory, ...]
+    subagent_trajectories: tuple[Trajectory, ...]
     document: Mapping[str, Any]
 
     @property
@@ -603,7 +603,7 @@ class Trajectory:
             operation: Keep only calls of this function, for example `grep`.
             state: Keep only calls with this outcome, for example `failed`.
 
-        The calls of subagents are in `subagents`, not here.
+        The calls of child runs are in `subagent_trajectories`, not here.
         """
         return tuple(
             call
@@ -633,7 +633,9 @@ class Trajectory:
                 self.final_metrics.to_dict() if self.final_metrics is not None else None
             ),
             "steps": [step.to_dict() for step in self.steps],
-            "subagents": [child.to_dict() for child in self.subagents],
+            "subagent_trajectories": [
+                child.to_dict() for child in self.subagent_trajectories
+            ],
         }
 
 
@@ -739,7 +741,7 @@ def _trajectory(
         steps=tuple(_step(step, index, strict) for index, step in enumerate(steps)),
         final_metrics=TrajectoryMetrics._from_atif(document.get("final_metrics")),
         extra=_map(document.get("extra")),
-        subagents=tuple(
+        subagent_trajectories=tuple(
             _trajectory(child, strict, version)
             for child in (children if isinstance(children, tuple) else ())
             if isinstance(child, Mapping)

{vis_agent-0.2.38.dev7565 → vis_agent-0.2.38.dev7570}/tests/test_evals_trajectory.py

@@ -302,9 +302,9 @@ def test_a_step_without_metrics_or_blocks_has_empty_values():
     assert final.function_calls == () and final.is_final
 
 
-def test_subagents_are_separate_trajectories():
+def test_child_runs_are_separate_trajectories():
     run = parse_trajectory(_document())
-    (child,) = run.subagents
+    (child,) = run.subagent_trajectories
     assert (child.session_id, child.schema_version, child.status) == (
         "child-1",
         "ATIF-v1.8",