activegraph 1.0.2__tar.gz → 1.0.2.post1__tar.gz

{activegraph-1.0.2 → activegraph-1.0.2.post1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: activegraph
-Version: 1.0.2
+Version: 1.0.2.post1
 Summary: An event-sourced reactive graph runtime for long-running, auditable, agentic systems.
 Author: Active Graph contributors
 License: MIT

{activegraph-1.0.2 → activegraph-1.0.2.post1}/activegraph/__init__.py

@@ -221,4 +221,4 @@ __all__ = [
     "tool",
 ]
 
-__version__ = "1.0.2"
+__version__ = "1.0.2.post1"

{activegraph-1.0.2 → activegraph-1.0.2.post1}/activegraph/behaviors/decorators.py

@@ -85,6 +85,12 @@ def register(behavior_obj: Union[Behavior, RelationBehavior]) -> None:
             f"decorators to construct one."
         )
     _REGISTRY.append(behavior_obj)
+    # v1.0.2.post1 #1 (b): if any Runtime is already alive, validate the
+    # new behavior against each one's configured provider so cross-
+    # provider model mismatches fire at the @llm_behavior / register()
+    # line rather than at first run_goal.
+    from activegraph.runtime._live import validate_behavior_against_live_runtimes
+    validate_behavior_against_live_runtimes(behavior_obj)
 
 
 def behavior(
@@ -248,6 +254,12 @@ def llm_behavior(
             max_tool_turns=max_tool_turns,
         )
         _REGISTRY.append(b)
+        # v1.0.2.post1 #1 (b): validate against any live Runtime's
+        # provider. Mirrors the eager check in register() so decorated
+        # behaviors with cross-provider model names fire at the
+        # @llm_behavior line instead of at first run_goal.
+        from activegraph.runtime._live import validate_behavior_against_live_runtimes
+        validate_behavior_against_live_runtimes(b)
         return b
 
     return wrap

activegraph-1.0.2.post1/activegraph/runtime/_live.py

@@ -0,0 +1,173 @@
+"""Live-Runtime tracking + single-behavior cross-provider validation.
+
+CONTRACT v1.0.2 #1 (b). The validation fires at *both* binding
+moments: ``Runtime(graph, llm_provider=...)`` construction (against
+the existing registry) and ``register()`` / ``@llm_behavior``
+decoration (against any live Runtime via the WeakSet below).
+
+The WeakSet is module-level so the registration decorators can
+look it up without importing ``Runtime`` at module load. Runtimes
+self-register inside ``__init__`` after wiring; the WeakSet
+auto-cleans GC'd Runtimes — no explicit ``Runtime.close()`` is
+required.
+
+The single-behavior validator here is intentionally narrow: it
+only does the cross-provider mismatch check (recognized name
+belonging to a different shipped provider). It does *not* stamp
+provider defaults onto ``model=None`` behaviors — that side
+effect lives in ``_resolve_and_validate_llm_models`` in
+``runtime.py``, which still runs at first ``_ensure_registry``.
+"""
+
+from __future__ import annotations
+
+import weakref
+from typing import TYPE_CHECKING, Any
+
+from activegraph.behaviors.base import LLMBehavior
+
+if TYPE_CHECKING:
+    from activegraph.runtime.runtime import Runtime
+
+
+# WeakSet so abandoned Runtimes don't leak validation calls. The
+# fork/replay paths construct fresh Runtimes that self-register; the
+# parent stays in the set until GC'd.
+_LIVE_RUNTIMES: "weakref.WeakSet[Runtime]" = weakref.WeakSet()
+
+
+def track_runtime(rt: "Runtime") -> None:
+    """Register a live Runtime for cross-provider validation. Called
+    by ``Runtime.__init__`` after the provider and graph are wired."""
+    _LIVE_RUNTIMES.add(rt)
+
+
+def live_runtimes() -> list["Runtime"]:
+    """Snapshot of currently-alive Runtimes (a list of strong refs that
+    the caller releases at end-of-call). Used by ``register()`` and the
+    decorators to validate a new behavior against each live provider."""
+    return list(_LIVE_RUNTIMES)
+
+
+def _clear_for_test() -> None:
+    """Empty the live-Runtime set. Test-only — used by the conftest
+    fixture that isolates the global registry between tests. Production
+    code shouldn't call this: the WeakSet cleans itself on GC."""
+    _LIVE_RUNTIMES.clear()
+
+
+def validate_behavior_against_live_runtimes(behavior: Any) -> None:
+    """Validate a freshly-registered behavior against every live
+    Runtime's provider. Raises :class:`InvalidRuntimeConfiguration` on
+    the first cross-provider mismatch.
+
+    No-op when ``behavior`` isn't an :class:`LLMBehavior`, when no
+    Runtime is live, or when the behavior has no explicit model (model
+    resolution against the provider's default happens at Runtime
+    construction or first-run, not here).
+    """
+    if not isinstance(behavior, LLMBehavior):
+        return
+    if behavior.model is None:
+        return
+    for rt in live_runtimes():
+        provider = getattr(rt, "llm_provider", None)
+        if provider is None:
+            continue
+        _validate_one(behavior, provider)
+
+
+def _validate_one(behavior: LLMBehavior, provider: Any) -> None:
+    """Cross-provider mismatch check for a single behavior against a
+    single provider. Pure: no side effects, no model-default stamping.
+
+    Permissive by default per v1.0.2 #1 (b): names no shipped provider
+    recognizes pass silently. Only recognized cross-provider mismatches
+    raise. The runtime-side ``_resolve_and_validate_llm_models``
+    delegates to this for its per-behavior pass so the check lives in
+    one place.
+    """
+    from activegraph.runtime.config_errors import InvalidRuntimeConfiguration
+
+    model = behavior.model
+    if model is None:
+        return
+    recognizes = getattr(provider, "recognizes_model", None)
+    if recognizes is None or recognizes(model):
+        return
+    claimed_by = _which_shipped_provider_claims(model, exclude=type(provider))
+    if claimed_by is None:
+        return
+
+    provider_class = type(provider).__name__
+    provider_default = getattr(provider, "default_model", None) or "claude-sonnet-4-5"
+    claimed_by_default = getattr(claimed_by, "default_model", "")
+    provider_default_hint = (
+        f"or remove the model= argument to use {provider_class}'s "
+        f"default ({provider_default!r})"
+        if provider_default
+        else f"or set a {provider_class}-compatible model name"
+    )
+    raise InvalidRuntimeConfiguration(
+        (
+            f"@llm_behavior(name={behavior.name!r}, model={model!r}) "
+            f"names a {claimed_by.__name__}-family model, but the "
+            f"runtime is configured with {provider_class}"
+        ),
+        what_failed=(
+            f"The behavior {behavior.name!r} pinned model={model!r}. "
+            f"That name belongs to {claimed_by.__name__}'s model "
+            f"family, but this Runtime was constructed with a "
+            f"{provider_class} instance. Sending the name to the "
+            f"wrong provider produces an HTTP 404 (or equivalent "
+            f"'unknown model' response) at first LLM call, with no "
+            f"hint that the mismatch is the cause."
+        ),
+        why=(
+            "v1.0.2 #1 validates explicit model names at both binding "
+            "moments (Runtime construction and register()/decoration) "
+            "against each shipped provider's recognizes_model() "
+            "method. The configured provider doesn't claim this name, "
+            "but another shipped provider does — that's a "
+            "configuration mismatch worth surfacing before the first "
+            "network call rather than after."
+        ),
+        how_to_fix=(
+            f"Either swap the provider — Runtime(graph, "
+            f"llm_provider={claimed_by.__name__}()) — "
+            f"{provider_default_hint}, or pass an explicit name "
+            f"from {provider_class}'s model families."
+        ),
+        context={
+            "behavior": behavior.name,
+            "model": model,
+            "configured_provider": provider_class,
+            "claimed_by_provider": claimed_by.__name__,
+            "claimed_by_default_model": claimed_by_default,
+        },
+    )
+
+
+def _which_shipped_provider_claims(name: str, *, exclude: type) -> Any:
+    """Return the first shipped provider class that recognizes `name`,
+    excluding `exclude`. Returns None when no other shipped provider
+    claims the name (permissive default per v1.0.2 #1 (b))."""
+    from activegraph.llm.anthropic import AnthropicProvider
+    from activegraph.llm.openai import OpenAIProvider
+
+    candidates = [AnthropicProvider, OpenAIProvider]
+    for cls in candidates:
+        if cls is exclude:
+            continue
+        recognizes = getattr(cls, "recognizes_model", None)
+        if recognizes is None:
+            continue
+        try:
+            inst = cls()
+        except Exception:
+            # Defensive: if a provider's no-arg constructor ever requires
+            # real credentials, skip it for the validation lookup.
+            continue
+        if inst.recognizes_model(name):
+            return cls
+    return None

{activegraph-1.0.2 → activegraph-1.0.2.post1}/activegraph/runtime/runtime.py

@@ -303,6 +303,23 @@ class Runtime:
         self._pack_behaviors: list = []
         self._pack_tools: list = []
 
+        # ---- v1.0.2.post1 #1 (b): eager cross-provider validation ----
+        # First run the bulk validation pass against whatever's already
+        # in the registry; only if it passes do we add this Runtime to
+        # the live-set. Failed constructions stay out of the WeakSet so
+        # they can't influence subsequent register() / @llm_behavior
+        # validation calls. The lazy path inside _ensure_registry()
+        # stays as a defensive double-check.
+        if self.llm_provider is not None:
+            source = (
+                self._explicit_behaviors
+                if self._explicit_behaviors is not None
+                else get_registry()
+            )
+            _resolve_and_validate_llm_models(source, self.llm_provider)
+        from activegraph.runtime._live import track_runtime
+        track_runtime(self)
+
     # ---------- public surface ----------
 
     @property
@@ -2190,11 +2207,12 @@ def _resolve_and_validate_llm_models(source, provider) -> None:
     raise InvalidRuntimeConfiguration for explicit names that belong to
     a different shipped provider. CONTRACT v1.0.2 #1.
 
-    The validation is permissive: a name no shipped provider recognizes
-    (custom or fine-tuned model) passes silently — only *recognized*
-    cross-provider mismatches fire the diagnostic.
+    The cross-provider mismatch check delegates to
+    :func:`activegraph.runtime._live._validate_one` so the same check
+    fires from both binding moments (Runtime construction here,
+    register()/decoration in ``_live.validate_behavior_against_live_runtimes``).
     """
-    from activegraph.runtime.config_errors import InvalidRuntimeConfiguration
+    from activegraph.runtime._live import _validate_one
 
     # Custom providers that pre-date v1.0.2 don't declare `default_model`.
     # Fall back to the v1.0.1 hardcoded default — keeps every pre-v1.0.2
@@ -2202,8 +2220,6 @@ def _resolve_and_validate_llm_models(source, provider) -> None:
     # byte-identically without code changes. The runtime only swaps in a
     # different default when the provider opts in by declaring one.
     provider_default = getattr(provider, "default_model", None) or "claude-sonnet-4-5"
-    provider_recognizes = getattr(provider, "recognizes_model", None)
-    provider_class = type(provider).__name__
 
     for b in source:
         if not isinstance(b, LLMBehavior):
@@ -2214,90 +2230,8 @@ def _resolve_and_validate_llm_models(source, provider) -> None:
             # declare one).
             b.model = provider_default
             continue
-
-        # b.model is an explicit string. Cross-provider validation per
-        # v1.0.2 #1 (b): if the configured provider doesn't recognize the
-        # name, ask each *other* shipped provider class whether it does.
-        # Exactly one other-provider claim ⇒ raise; otherwise pass through.
-        if provider_recognizes is None or provider_recognizes(b.model):
-            continue
-        claimed_by = _which_shipped_provider_claims(b.model, exclude=type(provider))
-        if claimed_by is None:
-            continue
-        # The model name belongs to a different shipped provider's family.
-        # This is the v1.0.1-user-test finding the v1.0.2 patch addresses:
-        # silently sending an Anthropic-family name to OpenAI 404s with no
-        # helpful diagnostic. Fire at registration time, not call time.
-        claimed_by_default = getattr(claimed_by, "default_model", "")
-        provider_default_hint = (
-            f"or remove the model= argument to use {provider_class}'s "
-            f"default ({provider_default!r})"
-            if provider_default
-            else f"or set a {provider_class}-compatible model name"
-        )
-        raise InvalidRuntimeConfiguration(
-            (
-                f"@llm_behavior(name={b.name!r}, model={b.model!r}) "
-                f"names a {claimed_by.__name__}-family model, but the "
-                f"runtime is configured with {provider_class}"
-            ),
-            what_failed=(
-                f"The behavior {b.name!r} pinned model={b.model!r}. That "
-                f"name belongs to {claimed_by.__name__}'s model family, "
-                f"but this Runtime was constructed with a "
-                f"{provider_class} instance. Sending the name to the "
-                f"wrong provider produces an HTTP 404 (or equivalent "
-                f"'unknown model' response) at first LLM call, with no "
-                f"hint that the mismatch is the cause."
-            ),
-            why=(
-                "v1.0.2 #1 validates explicit model names at registration "
-                "time against each shipped provider's recognizes_model() "
-                "method. The configured provider doesn't claim this "
-                "name, but another shipped provider does — that's a "
-                "configuration mismatch worth surfacing before the "
-                "first network call rather than after."
-            ),
-            how_to_fix=(
-                f"Either swap the provider — Runtime(graph, "
-                f"llm_provider={claimed_by.__name__}()) — "
-                f"{provider_default_hint}, or pass an explicit name "
-                f"from {provider_class}'s model families."
-            ),
-            context={
-                "behavior": b.name,
-                "model": b.model,
-                "configured_provider": provider_class,
-                "claimed_by_provider": claimed_by.__name__,
-                "claimed_by_default_model": claimed_by_default,
-            },
-        )
-
-
-def _which_shipped_provider_claims(name: str, *, exclude: type):
-    """Return the first shipped provider class that recognizes `name`,
-    excluding `exclude`. Returns None when no other shipped provider
-    claims the name (permissive default per v1.0.2 #1 (b))."""
-    from activegraph.llm.anthropic import AnthropicProvider
-    from activegraph.llm.openai import OpenAIProvider
-
-    candidates = [AnthropicProvider, OpenAIProvider]
-    for cls in candidates:
-        if cls is exclude:
-            continue
-        recognizes = getattr(cls, "recognizes_model", None)
-        if recognizes is None:
-            continue
-        # Instantiate cheaply: the providers' __init__ doesn't open the SDK.
-        try:
-            inst = cls()
-        except Exception:
-            # Defensive: if a provider's no-arg constructor ever requires
-            # real credentials, skip it for the validation lookup.
-            continue
-        if inst.recognizes_model(name):
-            return cls
-    return None
+        # v1.0.2 #1 (b): cross-provider mismatch check.
+        _validate_one(b, provider)
 
 
 def _budget_reason(name: Optional[str]) -> str:

{activegraph-1.0.2 → activegraph-1.0.2.post1}/activegraph.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: activegraph
-Version: 1.0.2
+Version: 1.0.2.post1
 Summary: An event-sourced reactive graph runtime for long-running, auditable, agentic systems.
 Author: Active Graph contributors
 License: MIT

{activegraph-1.0.2 → activegraph-1.0.2.post1}/activegraph.egg-info/SOURCES.txt

@@ -55,6 +55,7 @@ activegraph/packs/diligence/prompts/memo_synthesizer.md
 activegraph/packs/diligence/prompts/question_generator.md
 activegraph/packs/diligence/prompts/risk_identifier.md
 activegraph/runtime/__init__.py
+activegraph/runtime/_live.py
 activegraph/runtime/behavior_graph.py
 activegraph/runtime/budget.py
 activegraph/runtime/config_errors.py

{activegraph-1.0.2 → activegraph-1.0.2.post1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "activegraph"
-version = "1.0.2"
+version = "1.0.2.post1"
 description = "An event-sourced reactive graph runtime for long-running, auditable, agentic systems."
 readme = "README.md"
 requires-python = ">=3.11"