agentversion 0.2.0__tar.gz → 0.2.1__tar.gz

{agentversion-0.2.0 → agentversion-0.2.1}/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 > **Package version ≠ spec version.** This file tracks the **package** version. The on-the-wire `spec_version` is independent and frozen at `1.0.0`; a pre-1.0 package can implement a stable 1.0 spec, which is exactly the situation today.
 
+## [0.2.1] - 2026-06-24
+
+### Fixed
+- **`contract_from_components` now emits the `behavioral_policy` and
+  `environment` surfaces.** 0.2.0 added the models, surface keys, and diff
+  classifiers, but the shared flat-components → contract assembler silently
+  dropped both — so a producer (the DecimalAI SDK / the platform) could never
+  actually populate them from components. They are now assembled verbatim from
+  each component's `schema_json`. Additive-only: a manifest that doesn't declare
+  them is unchanged (same `overall_hash`).
+- **`tool_calling_mode` and `runtime_version` are now lifted to `model_runtime`
+  top level** (not buried in `model_config_hash`), so a `tool_calling_mode`
+  change is classified **breaking** by the diff as intended, and
+  `runtime_version` participates in `model_runtime` severity.
+
+The DecimalAI SDK exporter (`ManifestSnapshot.to_agentversion`) was edited
+byte-identically and is pinned to this assembly by its conformance test.
+`SPEC_VERSION` is unchanged (1.0.0) — these surfaces were already in the spec.
+
 ## [0.2.0] - 2026-06-24
 
 ### Added

{agentversion-0.2.0 → agentversion-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentversion
-Version: 0.2.0
+Version: 0.2.1
 Summary: An open specification for versioning agent runtimes and keeping datasets valid.
 Project-URL: Homepage, https://github.com/decimal-labs/agentversion
 Project-URL: Documentation, https://github.com/decimal-labs/agentversion/tree/main/spec

{agentversion-0.2.0 → agentversion-0.2.1}/agentversion/contract.py

@@ -12,7 +12,8 @@ Each component is a plain dict::
     {
       "component_type":    "tool" | "skill" | "prompt" | "model" | "subagent"
                            | "output_schema" | "workflow" | "guardrail"
-                           | "context_config",
+                           | "context_config" | "behavioral_policy"
+                           | "environment",
       "component_name":    str,
       "component_version": str | None,
       "content_hash":      str | None,   # producer-supplied content fingerprint
@@ -146,6 +147,13 @@ def contract_from_components(components: list[dict[str, Any]]) -> dict[str, Any]
             gen["response_format"] = cfg["response_format"]
         if gen:
             model_runtime["generation_config"] = gen
+        # tool_calling_mode + runtime_version are TOP-LEVEL model_runtime fields
+        # (not under generation_config); the diff classifies a tool_calling_mode
+        # change as breaking. Must stay byte-identical with the SDK exporter.
+        if isinstance(cfg.get("tool_calling_mode"), str):
+            model_runtime["tool_calling_mode"] = cfg["tool_calling_mode"]
+        if isinstance(cfg.get("runtime_version"), str):
+            model_runtime["runtime_version"] = cfg["runtime_version"]
     else:
         model_runtime = {"provider": "unknown", "model": "unknown"}
 
@@ -252,4 +260,15 @@ def contract_from_components(components: list[dict[str, Any]]) -> dict[str, Any]
             ctx["retrieval_config_hash"] = ctx_comps[0]["content_hash"]
         contract["context_config"] = ctx
 
+    # behavioral_policy / environment are single structured surfaces (the surface
+    # IS the config), emitted verbatim from schema_json so hash_manifest hashes
+    # their contents. Must stay byte-identical with the SDK exporter.
+    bp_comps = by_type.get("behavioral_policy", [])
+    if bp_comps:
+        contract["behavioral_policy"] = dict(bp_comps[0].get("schema_json") or {})
+
+    env_comps = by_type.get("environment", [])
+    if env_comps:
+        contract["environment"] = dict(env_comps[0].get("schema_json") or {})
+
     return contract

{agentversion-0.2.0 → agentversion-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentversion"
-version = "0.2.0"
+version = "0.2.1"
 description = "An open specification for versioning agent runtimes and keeping datasets valid."
 readme = "README.md"
 license = "Apache-2.0"

{agentversion-0.2.0 → agentversion-0.2.1}/tests/test_contract.py

@@ -59,6 +59,67 @@ def test_model_provider_inferred_when_absent():
     assert c["model_runtime"]["provider"] == "anthropic"
 
 
+# ── OSS-1/3/7: new 0.2.0 surfaces (must mirror the SDK exporter) ────────────
+
+def test_model_runtime_lifts_tool_calling_mode_and_runtime_version():
+    """OSS-1: tool_calling_mode + runtime_version are TOP-LEVEL model_runtime
+    fields (not under generation_config), so the diff classifies them."""
+    c = contract_from_components([
+        _comp("model", "default", content_hash="sha256:m",
+              schema_json={"provider": "openai", "model": "gpt-4o",
+                           "tool_calling_mode": "native", "runtime_version": "1.2"}),
+    ])
+    mr = c["model_runtime"]
+    assert mr["tool_calling_mode"] == "native"
+    assert mr["runtime_version"] == "1.2"
+    assert "tool_calling_mode" not in mr.get("generation_config", {})
+
+
+def test_behavioral_policy_surface_assembled():
+    """OSS-3: behavioral_policy is emitted verbatim from its schema_json."""
+    sj = {"policy_id": "refund", "policy_hash": "sha256:p", "objection_threshold": 3,
+          "always_forbidden": ["admit_liability"]}
+    c = contract_from_components([
+        _comp("model", "default", schema_json={"model": "gpt-4o"}),
+        _comp("behavioral_policy", "behavioral_policy", content_hash="sha256:p", schema_json=sj),
+    ])
+    assert c["behavioral_policy"] == sj
+
+
+def test_environment_surface_assembled():
+    """OSS-7: environment is emitted verbatim from its schema_json."""
+    sj = {"deployment_id": "d", "region": "us", "runtime_versions": {"python": "3.12"}}
+    c = contract_from_components([
+        _comp("model", "default", schema_json={"model": "gpt-4o"}),
+        _comp("environment", "environment", content_hash="sha256:e", schema_json=sj),
+    ])
+    assert c["environment"] == sj
+
+
+def test_new_optional_surfaces_absent_when_undeclared():
+    """Additive-only: a model-only contract carries neither new surface, so
+    existing manifests keep their exact prior identity hash."""
+    c = contract_from_components([_comp("model", "default", schema_json={"model": "gpt-4o"})])
+    assert "behavioral_policy" not in c
+    assert "environment" not in c
+
+
+def test_behavioral_policy_participates_in_identity_hash():
+    """Adding behavioral_policy, and changing its policy_hash, each change the
+    canonical jcs-sha256 identity hash."""
+    base = [_comp("model", "default", content_hash="sha256:m",
+                  schema_json={"provider": "openai", "model": "gpt-4o"})]
+    with_p = base + [_comp("behavioral_policy", "behavioral_policy", content_hash="sha256:p",
+                           schema_json={"policy_id": "p", "policy_hash": "sha256:p"})]
+    with_p2 = base + [_comp("behavioral_policy", "behavioral_policy", content_hash="sha256:p2",
+                            schema_json={"policy_id": "p", "policy_hash": "sha256:p2"})]
+    h_base = hash_manifest({"contract": contract_from_components(base)})
+    h_p = hash_manifest({"contract": contract_from_components(with_p)})
+    h_p2 = hash_manifest({"contract": contract_from_components(with_p2)})
+    assert h_base != h_p   # the surface participates in identity
+    assert h_p != h_p2     # a rule change re-versions
+
+
 def test_tool_and_skill_registry_hashes_are_computed():
     c = contract_from_components([
         _comp("tool", "t1", version="1", content_hash="sha256:t1",